diff --git a/incoming/ROUND.md b/incoming/ROUND.md
index 0be58e2b4..03c0c3b02 100644
--- a/incoming/ROUND.md
+++ b/incoming/ROUND.md
@@ -151,60 +151,60 @@ await browser.close();
 
 ## 후보
 
-10월 21일 포크 `dev`(`7d3b969`)를 둘러보고 적었어요. 바퀴 45 부터 이 표에서 골라요. 바퀴 9~44 의 `## 바퀴` 줄에 적힌 후보 번호는 지난 표의 번호예요. 파일 뒤의 줄 번호는 그날 기준이에요. 고칠 곳은 `web/src/` 아래면 그 앞을 줄였어요.
+10월 23일 포크 `dev`(`1b9a04a`)를 둘러보고 적었어요. 바퀴 66 부터 이 표에서 골라요. 창작자 지시 5 대로 1~24위는 Pattern Lab 과 Lab 에서 보드로 가는 길이에요. 처음 온 사람이 레이어를 더하고 노브를 돌려 To hardware 로 보내기까지를 390px 터치와 1440px 마우스, 키보드로 따라가며 쟀고, 미리보기와 내보낸 JS, C++ 헤더가 어긋나는 곳은 작은 스크립트로 돌려 봤어요. 25위 아래와 10, 13, 18~20, 22~24위는 10월 21일 표에서 남은 줄이에요. 그 줄의 파일 줄 번호는 오늘 것으로 고쳤고, 쪽 속도나 대비처럼 다시 재지 않은 값은 그날 잰 값이에요. 그 값을 내는 코드는 그대로예요. 바퀴 9~60 의 `## 바퀴` 줄에 적힌 후보 번호는 지난 표의 번호예요. 고칠 곳은 `web/src/` 아래면 그 앞을 줄였어요.
 
 | 순위 | 갈래 | 무엇 | 까닭 | 고칠 곳 |
 |---|---|---|---|---|
-| 1 | UI | WebGL 을 못 쓰는 브라우저에서도 첫 화면과 Build, Pattern, Inside 탭이 오류 화면 대신 글과 단추를 보여 준다 | 크로미움을 `--disable-3d-apis` 로 띄워 빌드한 사이트를 열면 `/`(1440px), `/build`, `/pattern`, `/inside`, `/inside/jon-usa`(390px, 1440px 둘 다) 열 번 가운데 아홉 번이 「This page couldn't load」 화면이 돼요. 오류는 R3F `Canvas`(`components/sections/InsideGlobe/Globe.tsx:1302`, `components/3d/HeroScene.tsx:627`)가 렌더러를 만들다 던진 「Error creating WebGL context」이고, 이걸 그리는 `components/3d/ViewerPanel.tsx:51` 위에 오류 경계가 없어 쪽 전체로 올라가요. 390px `/` 만 살아남는데, 3D 칸이 `display: none`(`app/globals.css:244`)이라 캔버스를 만들지 않아서예요. 같은 조건에서 가이드 다섯 쪽과 Pattern Lab 은 열려요. 가이드는 `components/guide/world/GuideWorld.tsx:45` 의 `hasWebGL()` 로 먼저 묻고 `:66` 의 `StageGuard` 로 감싸요. 이 둘을 `ViewerPanel` 에 똑같이 붙이고, 묻는 함수는 `lib/` 로 옮겨 같이 써요. `HeroScene.tsx:131` 의 `ModelGuard` 는 모델만 감싸서 캔버스 오류는 못 잡아요. | `components/3d/ViewerPanel.tsx`, `components/guide/world/GuideWorld.tsx`, 새 `lib/webgl.ts`, 새 `components/3d/ViewerPanel.test.tsx` |
-| 2 | UI | 첫 화면 영상 밑 사진이 2.1 MB 원본 대신 화면 폭에 맞춘 20 KB 남짓으로 와서 느린 망에서도 1초 안팎에 뜬다 | `components/sections/Hero.tsx:127`~`:139` 의 포스터는 `<img src="/product_v2.jpg">` 그대로라 4032×2268, 2,150,860바이트 원본을 받아 폰에선 340×192px, 1440 에선 567×320px 에 그려요. 첫 화면 칸이 숨은 `/build`, `/pattern`, `/inside` 에서도 DOM 에 있어서 같은 2.15 MB 를 받아요. 이 사진이 첫 화면의 LCP 예요. 9 Mbps 에서 움직임 줄이기를 켜고 재 보니 LCP 가 폰 8.7초, 데스크톱 5.6초였고, 같은 서버의 `/_next/image` 1080폭 WebP(17,388바이트)를 넣으니 0.8초와 1.1초였어요. 640폭은 7,234바이트, 1200폭은 20,740바이트예요. `CasePicker.tsx:131` 처럼 `next/image` 의 `fill` 과 `sizes` 를 쓰고, 첫 화면 그림이니 `priority` 를 줘요. `:126` 의 eslint 예외 줄은 빠져요. `Hero.test.tsx:56`, `:103` 이 `src="/product_v2.jpg"` 를 찾으니 같이 고쳐요. | `components/sections/Hero.tsx`, `components/sections/Hero.test.tsx` |
-| 3 | UI | Build, Pattern 탭과 폰 첫 화면이 보이지 않는 지구본의 사진 65장을 받지 않는다 | `components/3d/ViewerPanel.tsx:31` 은 hero 에도 지구본을 고르고, 첫 장면을 정하는 store 의 `homeTab` 은 `'hero'`(`store/useAppStore.ts:65`)로 시작해서 `components/sections/RightPanel.tsx:115` 의 effect 뒤에야 바뀌어요. 그래서 `/build`, `/pattern` 에서도 0.8초쯤 `GlobeViewer` 가 붙고(`ViewerPanel.tsx:51`), 그 미리 받기(`components/sections/InsideGlobe/GlobeViewer.tsx:77`~`:83`, `loading="eager"`)가 핀 28개마다 첫 사진을 3장까지(`builds.ts:72`) 모두 65장을 불러요. 390px·DPR3 에서 8,384,194바이트, 1440 에서 1,480,190바이트예요. 폰 첫 화면은 3D 보기가 `display: none`(`app/globals.css:244`)이라 지구본을 그리지도 않는데(5초 동안 requestAnimationFrame 0번) 같은 65장을 받아요. 9 Mbps 에서 이 요청을 막아 보니 폰 `/build` 의 load 가 11.1초에서 3.7초로, 움직임 줄이기를 켠 폰 `/` 의 LCP 가 8.7초에서 3.8초로 줄었어요. `HomeView.tsx:15` 의 `initialTab` 을 `ViewerPanel` 에 넘겨 첫 장면을 정하고, 미리 받기는 지구본이 보일 때(901px 이상이거나 Inside 탭)만 그려요. 폭 판단은 `lib/hooks/useMediaQuery.ts:9` 를 써요(`PatternPanel.tsx:97` 꼴). `HeroScene.tsx:85` 의 `useGLTF.preload`(`model.glb` 282,620바이트)는 다음 조각이에요. WebGL 줄과 같은 파일이라 하나가 먼저 머지된 뒤에 해요. | `components/3d/ViewerPanel.tsx`, `components/HomeView.tsx`, `components/sections/InsideGlobe/GlobeViewer.tsx`, 새 `components/3d/ViewerPanel.test.tsx` |
-| 4 | 근간 | 커뮤니티 API 가 본문이 `null` 인 요청에 500 대신 400 과 까닭을 돌려준다 | 쓰기 라우트 22곳이 `await request.json()` 의 결과를 `Record<string, unknown>` 으로 바로 읽어요. `null` 은 맞는 JSON 이라 `catch`(예: `app/api/community/patterns/route.ts:130`)를 지나고 다음 `raw.title`(`:135`)에서 TypeError 가 나요. 로그인과 Origin 머리를 달고 보내 보니 13곳이 500 이었어요: `atlas` POST·DELETE(`atlas/route.ts:94`), `decks` POST(`decks/route.ts:53`), `decks/[id]` PATCH(`:110`), `comments/[id]` PATCH(`:74`), `patterns` POST, `patterns/[id]` PATCH(`:137`), 그 아래 `comments`(`:56`)·`header`(`:115`)·`performance`(`:138`) POST, `posts` POST(`:53`), `presence` POST(`:79`), `reports` POST(`:44`). `[]`, `"x"`, `1`, `{}` 는 400 이나 200 이었어요. 500 응답엔 JSON 도 CORS 머리도 없어서 다른 출처의 Pattern Lab 은 까닭을 못 읽어요. 관리자 라우트를 포함한 아홉 파일도 같은 꼴이에요(코드로 확인). `territories/[code]/pin/route.ts:82` 만 읽기가 `try` 안이라 괜찮아요. `lib/lab/serialize.ts:270` 의 `isRecord` 꼴로 「객체를 읽거나 400 을 돌려주는」 함수를 하나 두고 21곳이 불러요. | 새 `lib/community/jsonBody.ts` 와 `lib/community/jsonBody.test.ts`, `app/api/community/**/route.ts` 21곳 |
-| 5 | UI | 끝이 잘린 코드를 붙이면 Lab 과 Live Editor 가 코드가 끝나기 전에 끊겼다고 말한다 | `lib/pattern/harness.ts:432` 의 `compilePatternCode` 는 붙인 코드 뒤에 `return { setup, update, draw }`(`:437`)를 덧대 한 함수로 만들어요. 코드가 `display.setPixel(x, y, ` 에서 끊기면 그 `return` 이 호출 안으로 들어가 「Unexpected token 'return'」이 떠요. 닫는 괄호만 빠지면 `new Function` 이 두른 `})` 때문에 「Unexpected token ')'」이 떠요. 둘 다 사용자가 쓰지 않은 글자예요. 문법 오류엔 줄 번호도 없어요(`:413`). Lab Code 패널에 Paste 로 붙이니 오류 상자(`app/pattern-lab/panels/CodePanel.tsx:149`)에 「Unexpected token 'return'」 한 줄만 떴어요. Live Editor 도 편집기 아래(`components/sections/PatternPanel.tsx:272`)에 같은 글이 떴어요. 문법 오류가 나면 문자열과 주석을 건너뛰며 열린 괄호를 세요. 끝까지 닫히지 않으면 "The code stops before it ends: 2 { and 1 ( never close. Was the paste cut off? Last line: …" 처럼 알려요. | `lib/pattern/harness.ts`, 새 `lib/pattern/harness.test.ts`, `web/public/pattern-sandbox.html`(`npm run build:sandbox` 로 다시 만들고 `check:sandbox-sync` 가 봐요) |
-| 6 | UI | 폰에서 Lab 의 Recent 와 Panels 메뉴가 화면 안에 열리고, 창 닫기 단추를 누르기 쉽다 | `.menuPop` 은 `right: 0`(`app/pattern-lab/LabPanels.module.css:80`)이라 단추 오른쪽 끝에 붙어 왼쪽으로 펼쳐져요. 800px 아래에선 단추 줄이 왼쪽으로 붙는데(`:47`~`:58`) 메뉴는 그대로예요. 390×844 에서 터치로 눌러 재니 Recent 메뉴가 x −105~85px, Panels 메뉴가 x −27~163px 이었고, 「Park this and start fresh」는 「art fresh」로 잘려 보였어요. 같은 미디어 쿼리에 `.menuPop { left: 0; right: auto }` 를 넣으니 Recent 는 14~204px, Panels 는 93~283px 로 화면 안에 들었어요. 801px 과 1000px 에선 지금처럼 오른쪽에 붙었어요. 메뉴 칸 높이도 33px 라 같은 쿼리에서 44px 로 올려요. Lab 창들이 같이 쓰는 `.modalHeader button`(`app/pattern-lab/PatternLab.module.css:489`)은 `min-width`, `min-height` 가 30px 라, 같은 폰에서 Code guide 의 닫기 단추가 30×30px 였어요. 커뮤니티 창은 바퀴 27 에서 이 단추를 44×44px 로 키우고 음수 여백으로 머리줄 높이를 지켰어요(`components/community/Community.module.css:2558`~`:2572`). 그 꼴을 따라요. | `app/pattern-lab/LabPanels.module.css`, `app/pattern-lab/PatternLab.module.css` |
-| 7 | 근간 | 기기 주소 칸을 비우거나 `http://` 를 붙여 넣어도 「Send over Wi-Fi」 링크가 그 보드로 간다 | `lib/community/deviceHost.ts:65` 의 `patternsUrl` 은 저장된 값을 `trim()` 만 하고 `http://${host}/patterns?src=` 를 만들어요. 칸을 비우면 `:32` 가 빈 문자열을 그대로 돌려줘서 `http:///patterns?src=…` 가 되고, 브라우저는 호스트를 `patterns` 로 읽어요. `http://192.168.0.44` 를 붙여 넣으면 호스트가 `http` 예요(jsdom 에서 훅을 그리고 `new URL(...).host` 로 쟀어요). 같은 일을 하는 네 곳은 `deviceHost.trim() \|\| "patternflow.local"` 을 저마다 적어 빈 칸을 막아요(`components/community/ZipDownload.tsx:90`, `components/community/ShippedPackCard.tsx:106`, `app/update/UpdateClient.tsx:63`, `app/features/TryInstall.tsx:35`). `patternsUrl` 을 쓰는 여섯 곳(`DeckPanel.tsx:178`, `SendModuleModal.tsx:131`, `:240`, `DeckDock.tsx:474`, `app/community/d/[id]/DeckDetailClient.tsx:382`, `:549`)만 이 보호가 없어요. `:69` 의 `updateUrl` 은 부르는 곳이 없고, 가리키는 `/api/community/builds/[id]/firmware` 라우트도 없어요. 주소를 다듬는 함수 하나(앞의 `http://` 와 뒤의 `/` 를 떼고, 비면 `patternflow.local`)를 이 파일에 두고 `patternsUrl` 과 네 곳이 같이 써요. 시험은 `ZipDownload.test.tsx:32` 처럼 `localStorage` 에 값을 넣고 봐요. | `lib/community/deviceHost.ts`, `components/community/ZipDownload.tsx`, `components/community/ShippedPackCard.tsx`, `app/update/UpdateClient.tsx`, `app/features/TryInstall.tsx`, 새 `lib/community/deviceHost.test.ts` |
-| 8 | UI | Lab 과 Live Editor 의 복사 단추가 복사에 실패하면 그렇다고 말한다 | 브라우저가 클립보드 쓰기를 거절하게 바꾸고 눌러 봤어요. Lab Code 패널의 「Copy prompt」(`app/pattern-lab/panels/CodePanel.tsx:64`~`:69`)는 try 가 없어, 단추 글이 그대로 남고 처리되지 않은 오류만 났어요. Live Editor 의 「Copy creation prompt」(`components/sections/PatternPanel.tsx:134`~`:140`)는 결과를 기다리지 않고 「Creation prompt copied to clipboard!」 alert 를 띄워서, 복사가 안 됐는데 됐다고 말해요. To hardware 의 복사(`app/pattern-lab/HardwareModal.tsx:110`~`:117`)는 오류를 잡기만 하고 아무것도 보이지 않아요. 이 창은 이 빌드에 없어 코드로 봤어요. 같은 조건에서 Pixel 의 「Copy as code」는 「Copy failed」를 띄웠어요(`panels/PixelPanel.tsx:118`~`:121`). 그 꼴을 따라 실패하면 단추 글을 잠깐 「Copy failed」로 바꾸고, Live Editor 는 성공했을 때만 알려요. | `app/pattern-lab/panels/CodePanel.tsx`, `app/pattern-lab/HardwareModal.tsx`, `components/sections/PatternPanel.tsx` |
-| 9 | 근간 | 커뮤니티에서 Lab 으로 연 패턴을 손대지 않고 다시 올려도 크기 검사에 막히지 않는다 | 서버는 라이선스 머리말과 꼬리말을 떼고 100,000자(`lib/community/validate.ts:9`)를 재요(`app/api/community/patterns/route.ts:143`~`:149`, `app/api/community/patterns/[id]/route.ts:292`). 상한 바로 밑에서 받아 준 패턴이 내려받기나 포크로 돌아오면 몇백 자가 넘어 거절되던 일을 고친 것이라고 주석에 적혀 있어요. 그런데 공유 창은 감싼 채로 `code.length` 를 재요(`components/community/PublishModal.tsx:152`). 「Open in Pattern Lab」과 「Edit in Pattern Lab」(`app/community/p/[id]/PatternDetailClient.tsx:223`)은 저장된 코드를 머리말째 넘기고, Lab 은 그것을 레이어 코드로 그대로 둬요(`app/pattern-lab/openIncomingPattern.ts:47`. 510자가 510자로 남았어요). 머리말과 꼬리말은 원작이면 447자, 포크면 576자예요. 본문 99,700자인 포크는 저장하면 100,276자라서, 서버는 받는데 창이 먼저 「100 KB of code」라며 막아요. 작성자가 자기 글을 고치러 다시 열 때(`editOf`)도 같은 검사를 지나요. 창도 `stripShareWrapping`(`lib/pattern/share.ts:177`)을 거친 길이로 재요. | `components/community/PublishModal.tsx`, `components/community/PublishModal.test.tsx` |
-| 10 | 근간 | 커뮤니티 API 가 원작 패턴의 라이선스를 거둔 MIT 나 CC0 로 바꾸는 요청을 거절한다 | `app/api/community/patterns/[id]/route.ts:185`~`:187` 주석은 거둔 라이선스는 지금 값을 지킬 때만 되고 바꾸는 것은 막는다고 해요. 그런데 코드는 거둔 둘이 든 `KNOWN_LICENSES`(`lib/pattern/share.ts:38`)에서 찾고, 포크일 때만 막아요(`:190`). localhost:3100 에서 CC-BY-SA-4.0 원작을 올린 뒤 `PATCH {"license":"CC0-1.0"}` 와 `{"license":"MIT"}` 가 둘 다 200 이었고, 패턴 쪽의 소스가 `SPDX-License-Identifier: MIT` 로 바뀌었어요. 편집 창은 지금 값과 `LICENSE_OPTIONS` 만 보여 줘요(`components/community/EditDetailsModal.tsx:73`~`:76`). 그러니 이 길은 API 를 바로 부를 때만 열려요. `share.ts:29`~`:31` 의 「새 작업엔 더 내놓지 않는다」를 서버도 지키게, 값이 바뀔 때는 `LICENSE_OPTIONS` 에서만 찾아요. 로드맵 `biz-market`(`app/roadmap/roadmap-data.ts:1099`)이 토대로 삼는 라이선스 기록도 함께 지켜져요. 시험은 `app/api/community/decks/[id]/route.test.ts` 처럼 임시 DB 와 진짜 세션으로 라우트를 불러요. | `app/api/community/patterns/[id]/route.ts`, 새 `app/api/community/patterns/[id]/route.test.ts` |
-| 11 | UI | 커뮤니티 창이 Esc 로 닫히고, 열리면 초점이 창 안으로 들어가며, 닫히면 연 단추로 돌아온다 | 커뮤니티의 `role="dialog"` 13곳(파일 12개) 가운데 Esc 를 듣는 건 `components/community/ShareDeckPackModal.tsx:46` 하나예요. 1440px 에서 키보드로 열고 Esc 를 눌러 보니 로그인(`AuthModal.tsx:135`), 신고(`ReportModal.tsx:70`), 「Edit details」(`EditDetailsModal.tsx:111`), 「Add firmware header」(`AddHeaderModal.tsx:127`), 「Publish a performance」(`AddPerformanceModal.tsx:80`) 다섯 창이 모두 열린 채였어요. 넷은 열린 뒤에도 초점이 뒤쪽의 여는 단추에 있었고, Tab 을 25번 누르면 초점이 창 밖으로 나갔어요. Pattern Lab 의 창 셋은 `lib/hooks/useDialog.ts` 로 이걸 이미 해요(`app/pattern-lab/panels/CodeGuideModal.tsx:19` 꼴, 시험 `lib/hooks/useDialog.test.tsx`). 첫 조각은 이 다섯 창이에요. `AuthModal` 은 `embedded` 일 때(`:132`) ref 를 달지 않아요. `PublishModal` 과 `SendModuleModal` 은 To hardware 창이 대신 Esc 를 받으니(`app/pattern-lab/HardwareModal.tsx:139`~`:146`) 다음 조각으로 미뤄요. | `components/community/AuthModal.tsx`, `ReportModal.tsx`, `EditDetailsModal.tsx`, `AddHeaderModal.tsx`, `AddPerformanceModal.tsx`, 새 `components/community/dialogKeys.test.tsx` |
-| 12 | UI | 폰에서 지도의 거르개 단추 줄이 지도 위에 따로 서서 점 이름을 가리지 않고, 지도 아래 빈 칸과 폰에서 안 되는 휠 안내가 없어진다 | 390px 에서 거르개 7개가 두 줄(324×51px)로 지도 위에 떠 있는데, 켜지지 않은 단추는 `.toolBtn` 의 `background: transparent`(`components/community/Atlas.module.css:41`)를 `composes`(`:113`)로 물려받아 밑의 점 이름이 비쳐요. 크로미움에서 세어 보니 지도 글자 83개 가운데 21개가 단추 밑에 깔렸고 1440px 에선 0개예요. 900px 아래 `.mapWrap` 은 `height: 60vh` 가 `flex: 1`(`:73`)에 밀려 `min-height: 380px`(`:810`)로 380px 인데, SVG 의 `height: 100%`(`:81`)가 풀리지 않아 1000:640 비율대로 228px 만 그려서 아래 152px 가 비어요. 줄 위 안내 「wheel to zoom · drag to pan · double-click to reset」(`components/community/AtlasClient.tsx:116`, 한국어 `:166`)은 폰에서 하나도 안 돼요. 배율을 바꾸는 곳은 휠(`:253`)뿐이고, 끌기는 `clampView`(`:1285`)가 배율 1 에서 0 으로 묶어요. 900px 아래에서 `.mapTop`(`Atlas.module.css:88`)을 `position: static` 으로 두고 `.mapWrap` 높이를 풀어 주입해 보니, 단추 밑 글자 0개, 칸 높이 291px, 가로 넘침이 없었어요. 안내는 `Community.module.css:5752`~`:5756` 이 `(hover: none)` 에서 `.zoomHint` 를 숨기는 꼴을 따라요. | `components/community/Atlas.module.css`, `components/community/communityCss.test.ts` |
-| 13 | UI | 약관, 연락, 기능, 로드맵, 404, 커뮤니티 쪽이 머리의 Patternflow 링크 때문에 첫 화면의 3D 코드 600 KB 를 미리 받지 않는다 | 이 쪽들의 `<Link href="/">`(`app/terms/page.tsx:30`, `components/contact/ContactPage.tsx:10`, `app/features/page.tsx:107`, `app/roadmap/RoadmapMap.tsx:392`, `app/not-found.tsx:7`, `app/community/layout.tsx:83`)가 화면에 들면 Next 가 `/` 를 미리 받으면서 그 쪽의 클라이언트 덩이까지 받아요. 390px 로 열고 5초 기다리며 `/?_rsc=` 요청만 막아 비교하니 스크립트 전송량이 `/terms`, `/contact`, 404 는 766,098 에서 148,456, `/features` 는 773,316 에서 155,674, `/roadmap` 은 806,407 에서 188,765, `/community` 는 985,557 에서 407,495 바이트로 줄었어요. 더 받던 몫은 three.js 덩이(gzip 237,537 / 원본 892,770)와 후처리 덩이(gzip 212,365) 같은 첫 화면 3D 코드예요. `components/community/PatternCard.tsx:421` 처럼 `prefetch={false}` 를 줘요. 누르면 그때 받아요. | `app/terms/page.tsx`, `components/contact/ContactPage.tsx`, `app/features/page.tsx`, `app/roadmap/RoadmapMap.tsx`, `app/not-found.tsx`, `app/community/layout.tsx` |
-| 14 | UI | 모든 쪽이 쓰지 않는 DM Sans 를 받지 않고, Newsreader 와 Silkscreen 은 그 글꼴이 쓰이는 쪽에서만 받는다 | `app/layout.tsx:21` 의 DM Sans 는 `:174` 에서 변수만 붙고 `--font-dm-sans` 를 읽는 곳이 `web/` 어디에도 없는데, next/font 가 모든 쪽 머리에 미리 받기 링크를 넣어요. 390px `/` 에서 미리 받는 글꼴 7개 가운데 화면 글자가 쓰지 않는 것은 DM Sans 37,503, Newsreader 58,675, Newsreader 기울임 65,023, Silkscreen 4,049 와 3,729 바이트로 모두 168,979 바이트예요(이 쪽 글꼴 전체는 10개 448,958 바이트). Newsreader 는 `--pf-serif`(`app/globals.css:167`)로 저널과 가이드 `.note`(`components/guide/Guide.module.css:1243`), `/terms` 만 쓰고, Silkscreen 은 가이드(`Guide.module.css:33`)만 써요. DM Sans 를 빼고 둘에 `preload: false` 를 줘요. 쓰는 쪽은 글자가 나올 때 받아요. `app/metadata.test.ts:18` 의 `next/font/google` 흉내에서도 `DM_Sans` 를 빼요. | `app/layout.tsx`, `app/metadata.test.ts` |
-| 15 | 근간 | Lab 에서 노브 1, 4 를 0..1 밖의 범위로 잡아도 패턴이 받는 노브 칸 수가 맞다 | `lib/pattern/controls.ts:76` 의 `wrapKnobDelta` 는 값이 0..1 이라고 보고 ±0.5 를 넘으면 1 을 더하거나 빼요. `lib/lab/engine.ts:168`~`:173` 은 노브 1, 4 에 늘 이 감기를 걸어요. 그래서 `@knobs Hue=0..360` 패턴에선 한 칸(7.5) 움직임이 6.5 로 읽혀 `input.knobDeltas[0]` 이 1 이 아니라 0.867 이에요. 100 에서 100.7 로 가면 +0.093 이 아니라 −0.040 으로 거꾸로 읽혀요. Director 처럼 0 에서 360 을 120프레임에 훑으면 패턴이 받은 칸 합이 48 이 아니라 32 예요. 가이드 시뮬레이터는 `@knobs` 가 있으면 감기를 꺼요(`lib/guide/deviceSim.ts:846`). 커뮤니티 미리보기(`components/community/SandboxPreview.tsx:53`)와 가이드 데스크(`components/guide/desk/community/live.ts:114`)는 Lab 처럼 감기를 걸어요. `knobTargetToDelta`(`lib/pattern/harness.ts:627`)가 이미 받는 `unitsPerTurn` 에 `TURNS_PER_FULL_RANGE` 를 곱해 범위 폭을 얻고 그 절반에서 감으면, 0..1 은 그대로고 세 곳이 한 번에 맞아요. | `lib/pattern/controls.ts`, `lib/pattern/harness.ts`, `lib/pattern/controls.test.ts`, `web/public/pattern-sandbox.html`(`npm run build:sandbox`) |
-| 16 | 근간 | Pattern Lab 에서 0% 레이어 위의 마스크가 미리보기와 내보낸 JS, C++ 헤더에서 같은 레이어를 가린다 | 미리보기는 불투명도 0% 레이어도 그 위 마스크의 닻으로 남겨요(`lib/lab/engine.ts:273`~`:277`). 내보낸 JS 와 C++ 헤더는 묶기 전에 0% 레이어를 걸러내서(`lib/lab/flatten.ts:117`, `lib/lab/hExport.ts:161`) 마스크가 그 아래 레이어에 붙어요. 두 파일의 묶는 코드(`flatten.ts:233`, `hExport.ts:183`)는 0% 레이어를 닻으로 두게 짜여 있지만, 이미 걸러진 뒤라 그 레이어를 보지 못해요. 2×1 판에 위에서부터 마스크(왼쪽만 켬), 0% 레이어, 빨강 100% 를 쌓아 돌려 봤어요. 미리보기는 `[255,0,0 \| 255,0,0]`, 내보낸 JS 는 `[255,0,0 \| 0,0,0]` 이었고, C++ 표는 `MASK_LAYER {1}` 이 빨강 묶음에 붙었어요. 미리보기 안에서도 갈려요. 처음부터 0% 인 코드 레이어는 한 번도 돌지 않아 버퍼가 없으니(`engine.ts:187`, `:258`) 마스크가 아래로 붙어요(`[255,0,0 \| 0,0,0]`). 한 프레임 100% 로 돌린 뒤 0% 로 내리면 닻이 돼요(`[255,0,0 \| 255,0,0]`). 「0% 레이어 위의 마스크는 아무것도 가리지 않는다」를 세 곳에 같게 적어요. `lib/lab/compositor.test.ts:117` 의 무작위 판은 불투명도를 1, 0.5, 0.25, 0.8 에서만 골라 0 이 나오지 않아요. | `lib/lab/engine.ts`, `lib/lab/flatten.ts`, `lib/lab/hExport.ts`, `lib/lab/compositor.test.ts` |
-| 17 | 근간 | Lab 에서 레이어를 하나 더 얹어도 코드 레이어가 내보낸 JS 에서 미리보기와 같은 픽셀을 찍는다 | 코드 레이어 하나면 코드를 그대로 내보내고(`lib/lab/flatten.ts:100` 의 `needsFlatten`), 둘 이상이면 각 레이어를 `flatten.ts:162` 의 `__mkDisplay` 위에서 돌려요. 이 판은 좌표를 `x \| 0` 으로 자르고(`:166`, `:174`) 색을 `Uint8ClampedArray` 에 그대로 넣어요(`:170`). 미리보기와 Live Editor 의 판은 `Math.floor` 로 자르고 `clampByte` 로 반올림해요(`lib/pattern/harness.ts:482`, `:502`, `:49`). 그래서 −1 과 0 사이 좌표의 점은 내보낸 쪽에서만 0번 줄에 찍히고, 반 값은 내보낸 쪽이 짝수로 반올림해요. 빈 픽셀 레이어 위에 코드 레이어를 얹어 128×64 를 비교했어요. (20,32) 둘레 반지름 40 원은 (42,0), (43,0) 두 픽셀이 내보낸 쪽에만 찍혔어요. `setPixel(x, y, x*2+0.5, …)` 기울기는 8,192픽셀이 다 1씩 달랐어요((0,0) 이 미리보기 1, 내보낸 쪽 0). `__mkDisplay` 를 harness 의 두 규칙대로 고치고, `lib/lab/compositor.test.ts` 의 「preview matches the flattened export」에 코드 레이어 판을 더해요. 지금 그 시험은 픽셀 레이어만 쌓아요(`:81`, `:112`). | `lib/lab/flatten.ts`, `lib/lab/compositor.test.ts` |
-| 18 | UI | Lab 의 창 안에서 글을 끌어 고르다 창 밖에서 놓아도 창이 닫히지 않는다 | 크로미움은 누른 곳과 뗀 곳이 다르면 click 을 두 곳의 공통 조상에 보내요. To hardware 의 `closeOnBackdrop`(`app/pattern-lab/HardwareModal.tsx:136`)은 `event.target === event.currentTarget` 만 봐요. 헤더 칸에서 끌어 바깥 판에서 떼면 공통 조상이 바깥 판이라 이 검사를 지나 창이 닫히고, 붙인 헤더는 이 창의 `useState`(`:50`, `:51`)에만 있어 같이 사라져요. 이 빌드엔 To hardware 가 없어서 같은 구조를 낱장 HTML 로 만들어 크로미움에서 끌어 봤어요. 오늘 규칙으론 1번 닫혔고, 누름도 바깥 판에서 시작했을 때만 닫는 규칙으론 0번이었어요. 바깥 판을 한 번 누르면 두 규칙 다 닫아요. 실제 Lab 에서도 Code guide 의 코드 글(`panels/CodeGuideModal.tsx:16`)과 Import image 제목(`panels/ImportImageModal.tsx:219`)을 끌어 바깥에서 떼니 창이 닫혔어요. 바깥 판의 `onPointerDown` 에서 누름이 판 자신에서 시작했는지 적어 두고, click 은 그때만 닫아요. | `app/pattern-lab/HardwareModal.tsx`, `app/pattern-lab/panels/CodeGuideModal.tsx`, `app/pattern-lab/panels/ImportImageModal.tsx`, `app/pattern-lab/HardwareModal.test.tsx` |
-| 19 | UI | Pattern 탭의 고급 안내와 To hardware 칸의 두 문단, Build 탭의 다른 길 안내가 제 글자 크기로 보인다 | `app/globals.css:837` 의 `.panel-body p`(20px, 900px 아래 17px `:858`)는 명시도 (0,1,1)이라 CSS 모듈 클래스 하나를 이겨요. 1440 에서 `.advancedNote`(`components/sections/PatternPanel.module.css:283`)와 `.hardwareNote` 둘(`:344`)은 14px 대신 20px, `.otherPaths`(`components/sections/BuildPanel.module.css:173`)는 15px 대신 20px 예요. 옆 카드 글은 15px 이고 칸 제목 `hardwareTitle` 은 18px 이라 안내가 제목보다 커요. `margin: 0` 도 져서 아래 여백 28px 가 붙고, To hardware 칸은 572px 로 363px 보다 209px 길어요. `InsidePanel.module.css:105` 의 `.body .mapNote`, `InsideGlobe/BuildCard.module.css:10` 의 `.card .empty` 꼴을 따라요. `BuildPanel.tsx:237` 은 `styles.buildPanel` 이 있고, `PatternPanel.tsx:148` 의 `panel-body` 엔 모듈 클래스를 하나 더해요. | `components/sections/PatternPanel.module.css`, `components/sections/PatternPanel.tsx`, `components/sections/BuildPanel.module.css` |
-| 20 | UI | Make 가이드의 덱 순서 경고가 지금 펌웨어 판을 말한다 | 「Your deck」 단계는 「Up to firmware v3.10.4, Send over Wi-Fi drops this order; the next firmware keeps it」라고 해요(`components/guide/copy/community.ts:71`, 한국어 `:137`, 주석 `:23`~`:25`). 그 다음 펌웨어 3.10.5 가 10월 2일에 나와 덱 순서를 지키고(`CHANGELOG.md:113`), 지금은 3.11.0 이에요(`firmware/patternflow/net_config.h:114`). 「3.10.5 부터」처럼 판 번호로 적어요. | `components/guide/copy/community.ts` |
-| 21 | UI | 가로로 든 폰에서 Build, Pattern, Inside 탭의 글이 화면의 절반 넘게 보인다 | 900px 아래에선 3D 보기(`--mb-viewer-h: 44vh`, `app/globals.css:185`, `:263`)와 탭 막대 52px(`:2784`, `:2795`)가 위에 붙어요. 844×390 에서 재 보니 둘이 224px 를 쥐어서 글은 166px(43%)만 보이고, 740×360 에선 150px 예요. Pattern 탭의 편집기는 하한 120px(`components/sections/PatternPanel.module.css:414`)라 166px 가운데 120px 를 덮어서, 그 주석(`:404`~`:411`)이 막으려던 일이 가로 화면에서 다시 생겨요. `@media (max-width: 900px) and (max-height: 500px)` 에서 `--mb-viewer-h` 를 30vh 로 주니 글이 221px(57%) 보였고, 편집기는 131px 로 따라왔어요. 세로 390×844 는 그대로예요. 변수가 vh 그대로라 `components/sections/InsideGlobe/BuildCard.tsx:38`~`:41` 의 계산도 맞아요. | `app/globals.css` |
-| 22 | UI | 폰에서 로드맵 마디를 누르면 뜨는 창이 닫기 단추까지 화면 안에 든다 | 창 폭은 360px 로 박혀 있고(`app/roadmap/RoadmapMap.tsx:97`, `:704`), 오른쪽에 자리가 없으면 마디 왼쪽으로 넘기기만 해서(`:373`~`:374`) 0 아래로 내려가도 잡지 않아요. 390px 에서 맨 왼쪽 마디를 누르니 창이 x −384~−24 에 떠서 닫기 단추(−78~−45)까지 하나도 안 보였고, 가운데 마디는 −153 에서 시작해 날짜와 제목이 132px 잘렸어요. 폭을 `min(360, 캔버스 − 28)` 로, `left` 를 `margin`~`캔버스 − 폭 − margin` 사이로 잡아요. `top` 은 이미 `:375` 에서 그렇게 잡아요. 계산을 함수로 빼서 390 폭을 시험해요. `roadmap-data.ts` 는 건드리지 않아요. | `app/roadmap/RoadmapMap.tsx`, `app/roadmap/RoadmapMap.test.tsx` |
-| 23 | UI | 폰에서 덱 쪽과 프로필 쪽이 긴 덱 카드 때문에 옆으로 밀리지 않는다 | 폰 규칙의 `.deckGrid { grid-template-columns: 1fr }`(`components/community/Community.module.css:5759`~`:5761`)는 `minmax(auto, 1fr)` 이라 카드가 제목 줄의 최소 폭보다 좁아지지 않아요. 제목 줄엔 제목과 「2 slots」, 비공개면 「private」 칩, 작성자가 한 줄로 서고(`components/community/DeckCard.tsx:47`~`:57`) 제목만 `nowrap` 말줄임이에요(`Community.module.css:2980`). 로그인해서 20자 제목의 비공개 덱이 있는 `/community/decks` 를 390px 로 여니 카드가 386px 라 `scrollWidth` 가 402px 였고, 360px 에서도 카드는 386px 그대로였어요. 바로 아래 `.profileGrid`(`:5763`)처럼 `minmax(0, 1fr)` 로 주입하니 카드 358px, 제목은 말줄임, `scrollWidth` 390px 이었어요. 같은 격자를 `app/community/u/[username]/page.tsx:134` 도 써요. | `components/community/Community.module.css`, `components/community/communityCss.test.ts` |
-| 24 | UI | 기기 주소칸 앞 글자를 눌러도 칸에 초점이 가고, 보내기 창에서도 칸 테두리가 보이며, 폰에서 칸이 누르기 쉬운 높이가 된다 | 「Device address:」 글자와 칸이 `<label>` 없이 나란히 있어요(`components/community/DeckPanel.tsx:192`, `SendModuleModal.tsx:250`, `ShippedPackCard.tsx:115`). `/community/decks` 의 묶음 카드에서 글자를 눌러 보니 초점이 `BODY` 로 갔어요. 세 칸의 꾸밈은 저마다 인라인 `style` 인데 보내기 창만 `border`, `background`, `color` 가 빠졌어요(`SendModuleModal.tsx:258`~`:262`). 지은 CSS 로 그 칸을 그려 보니 테두리가 0px 라 「patternflow.local」 이 그냥 글자로 보였어요. 칸은 390px 에서도 116×21px 이라 같은 파일의 닫기 단추 44px 규칙(`Community.module.css:2558`)에 못 미쳐요. 세 칸을 `<label>` 로 감싸고 꾸밈을 클래스 하나로 모아요. | `components/community/DeckPanel.tsx`, `SendModuleModal.tsx`, `ShippedPackCard.tsx`, `Community.module.css`, `components/community/fieldNames.test.tsx` |
-| 25 | UI | 폰에서 Pixel 패널이 그림을 1× 대신 2× 로 맞춰 연다 | 390×844 에서 Pixel 패널의 그림 칸은 372×151px 예요. Preview 가 높이의 42% 를 갖고(`app/pattern-lab/panels/registry.tsx:116`), 도구 줄 둘이 103px 와 75px, 아래 상태 줄이 51px 를 써요. 상태 줄이 51px 인 건 「alt-click picks · right-drag erases · middle-drag pans」(`panels/PixelPanel.tsx:220`)가 두 줄로 접혀서인데, 이 손짓은 터치 화면엔 없어요. 그래서 맞춤이 1× 를 골라(`panels/pixel/usePixelViewport.ts:18` 주석도 그렇게 적어요) LED 한 칸이 CSS 1px 이에요. 이 글만 `@media (hover: none)` 에서 숨기니 상태 줄이 25px, 그림 칸이 372×177px 가 되고 Fit 이 2× 를 골랐어요. 2× 는 그림 칸 높이가 168px(64×2+40) 이상이면 되니 9px 남아요. 본은 `components/community/Community.module.css:1121` 의 `@media (hover: none)` 이에요. | `app/pattern-lab/panels/PixelPanel.tsx`, `app/pattern-lab/LabPanels.module.css`, `app/pattern-lab/panels/pixel/usePixelViewport.ts`(주석) |
-| 26 | UI | Pattern Lab Pixel 의 − + 단추가 보이는 가운데를 붙잡고 확대한다 | 휠 확대는 커서 아래 자리를 지켜요(`app/pattern-lab/panels/pixel/usePixelViewport.ts:120`, `:157`~`:170`). − + 가 부르는 `zoomBy`(`:68`)는 배율만 바꾸고 굴림 위치를 그대로 둬서, 그림이 뷰포트 왼쪽 위를 기준으로 커져요. 1440×900 에서 10× 로 키우고 가운데로 굴렸어요(가운데 칸 64, 32). + 를 한 번 누르니 가운데가 58.2, 29.1 로 6칸 밀렸고, − 두 번엔 71.2, 32 로 갔어요. 같은 자리에서 휠 한 칸은 64.1 그대로였어요. Fit 은 그림이 다 들어가 가운데에 오니 괜찮아요. Director 의 ± 가 보이는 가운데를 지키는 꼴(`panels/director/useTimelineZoom.ts:62`~`:73`)을 따라요. `zoomBy` 가 뷰포트 가운데를 `wheelAnchor` 에 넣고, 같은 레이아웃 효과가 굴림을 되돌려요. | `app/pattern-lab/panels/pixel/usePixelViewport.ts`, `app/pattern-lab/panels/PixelPanel.test.tsx` |
-| 27 | UI | Lab 의 Share 창이 Esc 로 닫힌다 | Lab 머리줄의 Share 가 여는 `components/community/PublishModal.tsx`(`app/pattern-lab/PatternLabClient.tsx:545`)는 바깥 판 클릭으로만 닫히고(`:248`) 키 리스너가 없어요. 이 빌드엔 `NEXT_PUBLIC_COMMUNITY_URL` 이 없어 Share 가 보이지 않아서(`lib/community/apiBase.ts:36`) jsdom 으로 쟀어요. 창을 그리고 window 와 초점 칸에 Escape 를 보내니 `onClose` 는 0번 불렸어요. 초점은 여는 순간 제목 칸으로 가요(`:317`). Lab 의 다른 창이 쓰는 `lib/hooks/useDialog.ts:18` 꼴을 따라요. To hardware 창의 주석(`app/pattern-lab/HardwareModal.tsx:140`~`:149`)은 Publish 가 키를 듣지 않는다고 보고 첫 Esc 를 대신 받아요. Publish 가 듣게 되어도 두 리스너가 다 `setPublishCode(null)` 만 하니 To hardware 는 남아요. 그 주석과 `HardwareModal.test.tsx:135` 를 함께 고쳐요. | `components/community/PublishModal.tsx`, `components/community/PublishModal.test.tsx`, `app/pattern-lab/HardwareModal.tsx` |
-| 28 | UI | 첫 화면과 Pattern, Inside 탭의 이름 붙은 묶음 다섯이 화면 읽기 프로그램에 제 이름을 알린다 | role 없는 `div` 의 `aria-label` 은 ARIA 1.2 에서 쓸 수 없는 이름이라 읽기 프로그램이 지나쳐요. 크로미움 접근성 트리에서 `components/sections/InsidePanel.tsx:52` 와 `:56` 은 role 이 generic 이고, axe 는 `/` 에서 1곳(`Hero.tsx:150`), `/pattern` 에서 2곳(`PatternPanel.tsx:183`, `:292`), `/inside` 에서 2곳을 「div with no valid role」로 잡아요. `:52` 는 바로 아래 h1(`:54`)이 이름이고 `BuildPanel.tsx:231`, `PatternPanel.tsx:143` 엔 없으니 지워요. 나머지 넷은 같은 파일 `PatternPanel.tsx:213` 의 `role="group"` 꼴을 따라요. | `components/sections/InsidePanel.tsx`, `components/sections/PatternPanel.tsx`, `components/sections/Hero.tsx`, `components/sections/InsidePanel.test.tsx`, `components/sections/PatternPanel.test.tsx` |
-| 29 | UI | 브레드보드 가이드의 그림 밑 설명과 사진 글이 크림 바탕에서 읽힌다 | 그림 밑 안내(「↑ Ground (GND) pins … land on the Ground rail」 같은 배선 설명)가 `--pf-ink-faint` #A69F90 이라 크림 바탕에서 2.13~2.30:1 이에요. 글은 4.5:1 이 필요해요. axe 가 `/build/breadboard` 에서 이 색 때문에 17곳을 잡았고, `app/build/breadboard/page.tsx` 의 인라인 스타일 14곳(`:145`, `:266`, `:272`, `:279`, `:286`, `:388`, `:401`, `:433`, `:446`, `:478`, `:491`, `:533`, `:580`, `:625`)을 `--pf-ink-muted`(5.05:1, cream-2 에서 4.69:1)로 바꿔 보니 1440 과 390 에서 0곳이 됐어요. 토큰 자체를 바꾸면 로드맵, compliance, 저널까지 닿아서 쪽마다 나눠요. 다음 조각은 `/features` 예요(`app/features/Features.module.css` 6규칙으로 46곳 가운데 34곳). | `app/build/breadboard/page.tsx` |
-| 30 | UI | 태블릿 폭(820~1279px)에서 브레드보드 가이드의 단계 사진이 화면 높이 안에 든다 | 1280px 아래에선 `.photo`(`app/build/breadboard/breadboard.module.css:3`)가 `width: 100%` 라 단계 사진 넷이 본문 폭 그대로 772×1371px 로 그려져요. 1024×768 과 900 폭에서 사진 한 장이 화면보다 600px 남짓 길고, 쪽 높이는 13,077px 예요(1280px 에선 7,358px). 넓은 화면 쪽이 이미 쓰는 `max-width: 360px`(`:44`~`:47`)를 1280px 아래에도 주고 가운데로 모으니 사진이 360×638px 가 되고, 1024 폭의 쪽 높이는 10,166px 로 줄었어요. 390px 에선 342×606px 그대로예요. 파일 머리 주석(`:1`~`:2`)도 같이 고쳐요. | `app/build/breadboard/breadboard.module.css` |
-| 31 | UI | 느린 기계에서도 Inside 지구본이 처음 열릴 때와 빌드를 고를 때 1초 안팎에 자리를 잡는다 | 카메라 거리(`components/sections/InsideGlobe/Globe.tsx:1165`)와 고른 곳으로 돌기(`:1121`, `:1122`, `:1126`, `:1127`)는 프레임마다 남은 거리의 0.08 을 가서 프레임 수로만 끝나요. 1440×900 에서 카메라는 5(`:1054`)에서 6.54(`:1163`)로 물러나는데, WebGL 행렬로 재 보니 1% 안에 들기까지 55프레임이 걸렸어요. 60fps 면 0.92초지만 이 컨테이너(3fps)에선 18.8초였고, 빌드를 고를 때도 50프레임 21초였어요. 같은 파일의 `easeShare`(`:414`)가 이미 시간으로 줄이니 다섯 줄을 `easeShare(5, delta)` 로 바꿔요. 60fps 에서 0.0800 이라 지금 느낌은 같아요. `easeShare` 를 작은 파일로 빼서 1/60초 60번과 1/10초 10번이 같은 곳에 닿는지 봐요. | `components/sections/InsideGlobe/Globe.tsx`, 새 `components/sections/InsideGlobe/ease.ts`, 새 `components/sections/InsideGlobe/ease.test.ts` |
-| 32 | UI | 없는 주소로 들어가면 브라우저 탭과 링크 미리보기에 첫 화면 제목 대신 찾을 수 없다는 제목이 뜬다 | 빌드한 사이트에서 없는 주소를 부르면 404 와 `noindex` 는 맞게 오지만, `<title>` 과 설명, `og:title`, `twitter:title` 이 다 첫 화면 것(`app/layout.tsx:41`~`:43`)이에요. 탭, 방문 기록, 메신저 미리보기가 첫 화면처럼 보여요. canonical 은 없어서 그대로 둬요. `app/not-found.tsx` 는 metadata 를 내보내지 않는데, Next 16 문서(`node_modules/next/dist/docs/01-app/03-api-reference/03-file-conventions/not-found.md:187`)는 뿌리 `not-found` 의 `metadata` 를 받아요. `app/metadata.test.ts` 의 쪽별 시험에 한 줄 더해요. | `app/not-found.tsx`, `app/metadata.test.ts` |
-| 33 | UI | 덱 패널과 보내기 창이 빌드를 기다리는 동안 아래 독처럼 「usually under N s」 로 덱 크기에 맞는 시간을 말한다 | 세 곳이 같은 훅의 `expectedS`(`lib/community/useModuleBuild.ts:214`, 셈은 `:47`~`:50` 으로 6초에 패턴마다 1.5초)를 받는데 그 수를 보여 주는 건 독뿐이에요(`components/community/DeckDock.tsx:539`). `DeckPanel.tsx:146` 과 `SendModuleModal.tsx:209` 는 「usually a second or two」 라고 쓰다가 `expectedS` 가 지나야 「longer than usual」 로 바뀌어요. 패턴 하나면 8초, 20개 덱(`lib/community/deck.ts:47`)이면 36초 동안 「1~2초」라고 말하는 셈이에요. 독의 글을 따라요. | `components/community/DeckPanel.tsx`, `components/community/SendModuleModal.tsx`, `components/community/BuildWait.test.tsx` |
-| 34 | 근간 | 타입 검사에서 `PatternPanel.tsx` 한 파일이 쓰던 9초 넘는 시간이 0.3초 아래로 준다 | `components/sections/PatternPanel.tsx:21` 은 `<esp-web-install-button>` 을 `React.ElementType<EspWebInstallButtonProps>` 로 바꿔 써요. 이 타입은 JSX 의 내장 요소마다 props 가 맞는지 따져 모은 합집합(`@types/react` `index.d.ts:109`)이라서, 검사기가 `:21` 과 그 요소를 그리는 `:327` 에서 오래 머물러요. `tsc --noEmit --generateTrace` 로 재니 이 파일이 9.3초(검사 70.2초 가운데)로 가장 느렸고, 그 안에서 `:21` 이 3.3초, `:327` 이 5.7초였어요. `web/` 을 스크래치에 복사해 같은 3,715개 파일로 두 번씩 돌려 보니, 지금은 9.2초와 15.5초(그 회 검사 시간의 16% 와 23%)였어요. `React.FC<EspWebInstallButtonProps>` 로 바꾸면 0.22초와 0.29초였고 오류는 0개였어요. 같은 버튼을 `components/guide/Extras.tsx:38` 이 이미 `React.FC` 로 써요. 기계가 바빠서 회마다 전체 시간이 흔들렸으니 이 파일 몫만 적어요. | `components/sections/PatternPanel.tsx` |
-| 35 | 근간 | 범위가 0.001 보다 좁은 노브도 커뮤니티 카드에서 Lab 과 같은 값으로 돈다 | 노브 값을 0..1 로 펴는 계산이 다섯 곳에 따로 있고, 바닥값이 둘로 갈렸어요. Lab 엔진(`lib/lab/engine.ts:177`), 캡처 워커(`lib/lab/capture/capture.worker.ts:167`), C++ 내보내기(`lib/lab/hExport.ts:205`)는 `Math.max(0.0001, span)` 이고, 커뮤니티 샌드박스(`sandbox/sandbox.ts:90`)와 카드(`lib/community/knobs.ts:46`)는 `Math.max(0.001, span)` 이에요. #130 이 `0.0001..0.0004` 같은 범위가 올린 뒤에도 남게 고쳤는데, 그 범위 가운데인 0.00025 를 Lab 은 `knobNormalized` 0.5 로, 샌드박스는 0.15 로 패턴에 줘요. 카드의 첫 값도 어긋나요. `knobs.ts:23` 의 `midpoint` 가 소수 셋째 자리에서 잘라서 `0.0001..0.0004` 는 범위 밖인 0(샌드박스 값 −0.1)으로, `0.001..0.002` 는 맨 끝인 0.002 로 시작해요(tsx 로 `knobSetupFromCode` 를 불러 쟀어요). 이 값은 카드와 패턴 쪽, 서버 썸네일(`lib/community/thumbs.ts:93`)이 같이 써요. 바닥값 하나와 반올림 없는 가운데값을 `lib/pattern/controls.ts` 에 두고 다섯 곳이 불러요. 샌드박스를 고치면 `npm run build:sandbox` 로 `public/pattern-sandbox.html` 을 다시 만들어요(`check:sandbox-sync`). PR 이 크면 커뮤니티 쪽 둘부터 해요. | `lib/pattern/controls.ts`, `lib/pattern/controls.test.ts`, `lib/community/knobs.ts`, `lib/lab/engine.ts`, `lib/lab/capture/capture.worker.ts`, `lib/lab/hExport.ts`, `sandbox/sandbox.ts`, `web/public/pattern-sandbox.html` |
-| 36 | 준비 | Lab 에서 만든 헤더를 CC BY 4.0 으로 올려도 내려받은 `.h` 에 라이선스 줄이 하나만 있다 | 로드맵 `biz-market`(`app/roadmap/roadmap-data.ts:1099`)은 「the provenance and licence records the community already keeps」를 상업 라이선스의 토대로 삼아요. 그런데 Lab 의 C++ 뼈대는 첫 줄에 `// SPDX-License-Identifier: CC-BY-SA-4.0` 를 박아 넣어요(`lib/lab/hExport.ts:210`). To hardware 창은 이 헤더를 그대로 공유 창에 넘기고(`app/pattern-lab/HardwareModal.tsx:345`), 원작은 CC BY 4.0 을 고를 수 있어요(`lib/pattern/share.ts:25`). 내려받을 때 쓰는 `buildSharedHeaderFile`(`share.ts:194`, `lib/community/download.ts:69`)은 `#pragma once` 밑에 제 줄을 넣기만 하고 위에 있던 줄을 떼지 않아요. `buildHExport` 로 만든 헤더를 CC BY 4.0 으로 감싸 보니 1번째 줄은 `CC-BY-SA-4.0`, 18번째 줄은 `CC-BY-4.0` 이었어요. 감쌀 때 원래 있던 SPDX 줄을 떼어요. 시험은 `scripts/license-smoke.ts:120` 꼴로 하나 더해요. | `lib/pattern/share.ts`, `web/scripts/license-smoke.ts` |
-| 37 | 근간 | Pattern Lab CSS 에서 아무 컴포넌트도 쓰지 않는 클래스 15개와 그 규칙 210줄이 빠진다 | `app/pattern-lab/**/*.module.css` 10개에 정의된 클래스를, 그 파일을 불러오는 `.tsx` 의 `styles.x`, `styles["x"]` 와 `composes` 에 맞춰 봤어요. 동적 접근은 없었고 15개가 어디서도 쓰이지 않아요. `app/pattern-lab/PatternLab.module.css` 가 11개(`header`, `headerMeta`, `actionRow`, `previewHeader`, `editorHeader`, `guideButton`, `pasteButton`, `clearButton`, `viewToggle`, `keyButton`, `genThinking`)이고, 셀렉터가 다 죽은 규칙만 178줄이에요. 주로 `:91`~`:133`, `:252`~`:411`, `@media (max-width: 980px)` 안 `:557`~`:595` 에 있고, 그 사이 산 규칙(`.darkButton` `:274`, `.emptyState` `:331`, `.stats`)은 남겨요. `.headerMeta, .stats, .actionRow`(`:100`)처럼 산 클래스와 묶인 셀렉터에선 죽은 이름만 빼요. `panels/CapturePanel.module.css` 는 `stageBox`, `stageCanvas`, `stageCanvasTransparent` 가 27줄(`:110`~`:141`)이고, `panels/DirectorPanel.module.css` 는 `hint` 가 5줄(`:233`~`:237`)이에요. 나머지 7개 파일은 0개예요. | `app/pattern-lab/PatternLab.module.css`, `app/pattern-lab/panels/CapturePanel.module.css`, `app/pattern-lab/panels/DirectorPanel.module.css` |
-| 38 | 근간 | 모든 쪽이 받는 `globals.css` 에서 아무도 쓰지 않는 옛 Inside 패널 규칙 375줄이 빠진다 | `app/globals.css` 의 클래스 190개 가운데 60개는 `web/src`, `web/content`, `web/public`, `web/scripts` 어디에도 이름이 없어서, 규칙 138개 694줄이 아무것도 안 그려요. 가장 큰 덩어리는 `:1107`~`:1482`(「"Inside" panel list」부터 Sponsor 앞까지, `inside-*` 와 `reddit-comment-*`)이고 살아 있는 규칙이 하나도 없어요. 8,359바이트(gzip 1,849)인데 모든 쪽이 받는 `.next/static/chunks/*.css`(gzip 13,561)에 그대로 들어가요. `inside-carousel` 같은 이름은 템플릿으로 만드는 곳도 없어요. 나머지(`pf-marquee`, `version-tag`, `key-points`, `business-*` 와 저널 규칙 7개)는 다음 조각이에요. | `app/globals.css` |
-| 39 | 근간 | `web/ARCHITECTURE.md` 의 첫 화면 구성도와 Pixel 줄, 캠페인 주소가 지금 파일을 말한다 | 틀린 말이 여섯 곳이에요. `:43` 은 패턴 목록이 `common.ts` 에 있다지만 `components/3d/patterns/index.ts:6` 에 있어요. `:46` 은 `BuildPanel.tsx` 에 플래셔 입구가 있다지만 그 파일엔 `esp-web-install-button` 이 없고 `PatternPanel.tsx:21` 에 있어요(같은 문서 `:21` 도 그렇게 말해요). `:47` 은 Pattern 패널의 단추가 다 /pattern-lab 로 간다지만 `PatternPanel.tsx:299`, `:314`, `:363` 은 커뮤니티, 펌웨어 README, Play 가이드로 가요. 지구본은 `components/3d/ViewerPanel.tsx:10`, `:51` 이 그리는데 그림(`:39`~`:48`)엔 InsidePanel 밑에 있어요. `:73` 의 `pixelToCode.ts` 는 `panels/pixel/` 가 아니라 `lib/lab/pixelToCode.ts` 예요. `:31` 은 캠페인 링크를 `/r/*` 로 적지만 8개 가운데 4개(`/hn`, `/ig`, `/pcbway`, `/x`)는 맨 위 주소예요(`lib/campaignRoutes.ts:60`, `:70`, `:80`, `:90`). | `web/ARCHITECTURE.md` |
+| 1 | UI | 폰에서 Lab 아래 탭 줄을 눌러도 다른 패널이 닫히지 않고, 「⌄ 4」 메뉴가 화면 위에 열린다 | 390×844 터치로 처음 열면 아래 묶음의 탭 줄이 333px 창에 736px 예요. Code, Layers, Pixel, Text 만 보이고, Knobs 는 23px 「Kn」 조각이고, 나머지 넷은 「⌄ 4」 뒤에 있어요. 탭마다 27×27px × 가 보이는데, dockview 가 `(hover: none)` 에서 앞에 없는 탭의 × 를 다 드러내서예요(`node_modules/dockview/dist/styles/dockview.css:3048`~`:3052`). 「Kn」 을 누르면 pointerdown 에 Knobs 가 앞서며 탭 줄이 311px 굴러가고, 손가락을 떼며 오는 click 은 그 자리로 온 × 에 떨어져 Graphic Export 가 닫혀요. 돌아가려고 왼쪽 「t」 조각을 누르면 Text 가 닫혀요. Text 에서 Knobs 로 갔다 오는 데 패널 둘이 사라지고, 마우스로는 하나도 안 닫혀요. 「⌄ 4」(39×34px)를 누르면 메뉴는 DOM 의 236,438 에 136×145px 로 생기지만, 그 자리를 `elementFromPoint` 로 찍으면 뒤 탭의 × 가 나와요. dockview 의 팝업 틀은 `z-index: var(--dv-overlay-z-index)` 이고(`node_modules/dockview-core/dist/esm/dockview/components/popupService.js:41`), 내장 테마는 그 값을 999 로 두는데(`dockview.css:49` 들) Lab 테마(`app/pattern-lab/lab-dock.css:6`~`:47`)엔 없어서 `auto` 가 돼요. 테마에 `--dv-overlay-z-index: 999` 를 두고, `(hover: none)` 에서 `.dockview-theme-patternflow .dv-tab .dv-default-tab .dv-default-tab-action` 을 숨겨 페이지에 넣어 봤어요(두 클래스 셀렉터는 dockview 에 져요). 메뉴가 눌려 Knobs 가 앞섰고, 탭이 45~87px 로 줄어 Knobs 까지 들어왔고, 같은 누름에 닫힌 패널은 0개였어요. 폰에서 패널은 Panels ▾ 로 닫아요. | `app/pattern-lab/lab-dock.css`, `app/pattern-lab/labCss.test.ts` |
+| 2 | UI | Lab 에서 「+ Code」 로 넣은 새 레이어가 노브를 읽어서, 넣자마자 노브를 돌리면 그림이 바뀐다 | 1440×900 에서 처음 열고 「+ Code」 를 한 번 누르면 8,192픽셀 가운데 8,079개(98.6%)가 바뀌어 밑의 패턴이 가려져요. 그 뒤 노브 넷을 하나씩 끌면 바뀌는 픽셀은 0개예요. `requestAnimationFrame` 을 감싸 시계를 세우고 합성 캔버스를 비교했어요. 새 레이어 눈을 끄면 밑의 Glitch 가 돌아와요(5,100픽셀). 시작 코드 `STARTER_CODE`(`lib/lab/store/shared.ts:17`~`:27`)는 노브를 읽지 않고 모든 칸에 `setValue` 를 해요. `addCodeLayer`(`lib/lab/store/layers.ts:21`~`:25`)는 그것을 맨 위에 불투명도 1 로 넣고, 기본 램프(`lib/lab/types.ts:39`~`:46`)는 두 끝이 다 alpha 1 이에요. 시작 코드가 `params.knobNormalized` 를 읽게 해요. K2 가 빠르기, K3 가 줄 간격 같은 식이에요. 맨 아래가 아닌 새 코드 레이어는 램프 낮은 끝을 alpha 0 으로 시작해요. Color Ramp 의 「Fade low」(`app/pattern-lab/panels/RampPanel.tsx:405`)가 하는 일이에요. 시험은 `STARTER_CODE` 가 `knobNormalized` [0,0,0,0] 과 [1,1,1,1] 에서 다른 프레임을 그리는지, 레이어 하나 위에 넣은 새 레이어의 낮은 끝이 alpha 0 인지 봐요. | `lib/lab/store/shared.ts`, `lib/lab/store/layers.ts`, 새 `lib/lab/store/starter.test.ts` |
+| 3 | UI | Panels ▾ 에서 뒤에 숨은 패널을 누르면 닫지 않고 앞으로 꺼낸다 | Panels 메뉴는 열린 패널에 ● 를 달아요. 폰에선 Preview 밖의 패널 여덟이 한 묶음의 탭이라, ● 가 붙은 Knobs 도 다른 탭 뒤에 숨어 있어요. 그걸 누르면 `togglePanel`(`app/pattern-lab/PatternLabClient.tsx:314`~`:324`)이 있는 패널을 지우기만 해서 Knobs 가 사라지고, 한 번 더 눌러야 맨 끝 탭으로 다시 붙어요. 390×844 에서 Knobs 에 닿기까지 네 번 눌렀어요. 패널이 있는데 앞에 없으면 `setActive()` 하고, 이미 앞에 있을 때만 닫아요. 이 판단을 `app/pattern-lab/panels/registry.tsx` 로 옮기면 시험이 닿아요. | `app/pattern-lab/PatternLabClient.tsx`, `app/pattern-lab/panels/registry.tsx`, `app/pattern-lab/panels/registry.test.ts` |
+| 4 | UI | To hardware 가 번역하지 않은 레이어를 「Header ready」 로 넘기지 않는다 | 코드 레이어가 둘이면 To hardware 는 레이어마다 따로 번역해 붙이게 해요. 「+ Code」 를 누르고 열면 「2 layers to translate」, 「0 done」 인데 「Next →」 가 눌리고, 다음 단계는 「Header ready (16.9 KB). Try it on the board first」 라고 해요. 두 칸은 빈 함수 그대로라 보드에선 검은 화면이에요(`lib/lab/hExport.ts:16`~`:17` 의 「builds (black screen)」). 「Next →」(`app/pattern-lab/HardwareModal.tsx:288`~`:303`)는 `headerLooksReal`(`:106`)만 보는데, 뼈대가 늘 `#pragma once` 로 시작해서 늘 참이에요. 「Header ready」 글(`:307`~`:312`)은 `translated`(`:102`~`:104`)를 보지 않아요. 덜 번역됐으면 그 단계에서 검게 나올 레이어를 L0, L1 처럼 이름으로 알리고, 하나도 번역하지 않았으면 「Next →」 를 막아요. 시험은 코드 레이어 둘로 Next 를 누르고 경고 글을 찾아요. | `app/pattern-lab/HardwareModal.tsx`, `app/pattern-lab/HardwareModal.test.tsx` |
+| 5 | UI | To hardware 에 AI 답을 통째로 붙여도 헤더만 남고, 빈 칸에서 「Copy .h」 가 복사했다고 하지 않는다 | 레이어가 하나일 때 「Here is the converted header:」 와 ```` ```cpp ```` 울타리, 「Let me know…」 까지 든 대화 답을 그대로 붙이면 「Looks like a header ✓」 가 뜨고 「Next →」 가 열려요. 그 글이 말과 울타리째 「Copy .h」 와 「Download .h」, 보드로 보내기에 가요. 붙인 글은 `single.trim()`(`app/pattern-lab/HardwareModal.tsx:94`)으로만 다듬고, 검사(`:106`)는 `/^\s*#pragma\s+once\b/m` 라 어느 줄에 있어도 지나요. 레이어를 쌓은 쪽은 `cleanPastedUnit`(`lib/lab/hExport.ts:720`)이 울타리를 떼요. 아무것도 붙이지 않았을 때도 「Copy .h」(`HardwareModal.tsx:285`~`:287`)는 눌려서, 0바이트를 복사하고 「Copied ✓」 를 띄워요. 「Download .h」 와 「Next →」 는 그때 막혀 있어요. 레이어 하나 쪽도 울타리와 앞뒤 말을 떼고 `#pragma once` 를 맨 앞에서 찾아요. 「Copy .h」 도 `disabled={!headerLooksReal}` 로 둬요. | `app/pattern-lab/HardwareModal.tsx`, `lib/lab/hExport.ts`, `app/pattern-lab/HardwareModal.test.tsx` |
+| 6 | 근간 | To hardware 가 숨긴 레이어 대신 보이는 레이어를 번역하게 한다 | 코드 레이어 「Shown」(보임)과 「Hidden」(숨김, 고른 레이어)을 두고 「Copy the conversion prompt」 를 누르면, 18,616바이트 프롬프트에 Hidden 의 코드만 들고 Shown 은 없어요. 고른 레이어가 보이되 0% 여도 같아요. `stacked`(`app/pattern-lab/HardwareModal.tsx:65`)는 숨김과 0% 를 빼고 세서 「레이어 하나」 길로 들어오는데, 번역할 `focus`(`:72`~`:74`)는 고른 코드 레이어를, 없으면 숨긴 것까지 든 첫 코드 레이어(`:62`)를 써요. 커뮤니티에 올리는 쪽은 보이는 레이어를 골라서(`app/pattern-lab/PatternLabClient.tsx:108`~`:110`), 보드엔 커뮤니티와 다른 패턴이 가요. 같은 조건으로 고르고, 이름(`HardwareModal.tsx:141`)도 같이 맞춰요. 시험은 숨긴 레이어를 고른 채 프롬프트를 복사해 보이는 레이어의 코드가 들었는지 봐요. | `app/pattern-lab/HardwareModal.tsx`, `app/pattern-lab/HardwareModal.test.tsx` |
+| 7 | 근간 | Lab 이 만든 C++ 헤더가 노브 값과 이름 때문에 컴파일에 막히지 않는다 | `fmtFloat`(`lib/lab/hExport.ts:46`~`:49`)는 정수인지 먼저 보고 나서 소수 다섯째 자리로 반올림해요. 그래서 반올림해서야 정수가 되는 값은 `.0` 없이 나와요. 범위 Hue=0..360 에서 Director 키프레임(버스 값 1000 가운데 175)으로 옮긴 노브가 `62.99999999999999` 가 되면 뼈대에 `static float knobVal[4] = {63f, …}` 를 쓰고, g++ 는 `unable to find numeric literal operator 'operator""f'` 로 멈춰요. 0..100 범위에선 버스 값 70 이 이렇게 돼요. 반올림해 0 이 되는 값은 `0f` 예요. 이름은 `"` 만 `'` 로 바꾸고 `\` 는 두어서(`:236`~`:237`), 레이어를 쌓은 패턴 이름 `AC\` 는 `NAME = "AC\";` 가 되어 「missing terminating " character」 로 멈춰요. 노브 이름 `Speed\` 도 `KNOB_LABELS` 를 같은 식으로 깨요. 레이어 하나 쪽 `enforcePatternName`(`:711`)은 `\` 를 떼요. 반올림한 뒤에 정수면 `.0f` 를 붙이고, 이름과 노브 이름에서 `"` 와 `\` 를 떼요. 컴파일 시험은 `lib/lab/textExport.test.ts:558`~`:690` 의 g++ 틀을 빌려요. | `lib/lab/hExport.ts`, 새 `lib/lab/hExport.test.ts` |
+| 8 | 근간 | 레이어 하나를 반투명이나 곱하기로 두어도 올린 패턴이 미리보기와 같은 밝기다 | 흰 코드 레이어 하나를 불투명도 0.5 로 두면 미리보기는 128 인데 올리는 패턴은 255 예요. 곱하기(multiply)면 미리보기 0 에 올린 쪽 255, 0.3 의 스크린이면 77 과 255 예요. 레이어를 쌓았을 때 내보내는 코드는 미리보기와 같은 값을 내요. `needsFlatten`(`lib/lab/flatten.ts:176`~`:182`)이 보이는 코드 레이어가 하나면 불투명도와 섞기를 보지 않고 false 를 돌려줘서, `buildExportCode`(`app/pattern-lab/PatternLabClient.tsx:108`~`:131`)가 그 코드를 그대로 내보내요. C++ 쪽 레이어 하나 프롬프트(`buildCppPrompt`)에도 불투명도와 섞기가 없어요. 하나 남은 레이어가 불투명도 1 밑이거나 곱하기면 `needsFlatten` 이 true 를 돌려주게 해요. To hardware 의 `stacked`(`app/pattern-lab/HardwareModal.tsx:65`)도 이 함수를 써서 보드 쪽도 같이 맞아요. | `lib/lab/flatten.ts`, `lib/lab/compositor.test.ts` |
+| 9 | 근간 | `const draw = …` 로 쓴 코드 레이어를 다른 레이어와 쌓아 올려도 그 패턴이 돈다 | 미리보기는 `const draw = (display) => …` 를 오류 없이 돌려요. `lib/pattern/harness.ts:597`~`:605` 가 코드를 함수 안에 그대로 두고 `typeof` 로 꺼내서예요. 쌓아 내보내는 코드는 레이어마다 `var setup, update, draw;` 를 먼저 쓰고 그 밑에 레이어 코드를 붙여서(`lib/lab/flatten.ts:300`~`:305`), 같은 함수 안에서 「Identifier 'draw' has already been declared」 로 불러오기부터 실패해요. `const update`, `const setup`, `let`, `class` 도 같아요. 이런 레이어가 하나라도 있으면 쌓아 올린 패턴은 커뮤니티에서 돌지 않아요. `var` 그림자는 바깥 함수에 두고, 레이어 코드는 안쪽 함수에서 `typeof` 로 `{ setup, update, draw }` 를 돌려주게 감싸요. 시험은 화살표 함수 레이어를 픽셀 레이어 밑에 두고 `loadCode` 가 되는지, 픽셀이 미리보기와 같은지 봐요. | `lib/lab/flatten.ts`, `lib/lab/compositor.test.ts` |
+| 10 | 근간 | Lab 에서 레이어를 하나 더 얹어도 코드 레이어가 내보낸 JS 에서 미리보기와 같은 픽셀을 찍는다 | 코드 레이어 하나면 코드를 그대로 내보내고(`lib/lab/flatten.ts:176` 의 `needsFlatten`), 둘 이상이면 각 레이어를 `flatten.ts:237` 의 `__mkDisplay` 위에서 돌려요. 이 판은 좌표를 `x \| 0` 으로 자르고(`:241`, `:249`) 색을 `Uint8ClampedArray` 에 그대로 넣어요(`:245`). 미리보기와 Live Editor 의 판은 `Math.floor` 로 자르고 `clampByte` 로 반올림해요(`lib/pattern/harness.ts:645`, `:665`, `:55`). 그래서 −1 과 0 사이 좌표의 점은 내보낸 쪽에서만 0번 줄에 찍히고, 반 값은 내보낸 쪽이 짝수로 반올림해요. 빈 픽셀 레이어 위에 코드 레이어를 얹어 128×64 를 비교했어요. (20,32) 둘레 반지름 40 원은 (42,0), (43,0) 두 픽셀이 내보낸 쪽에만 찍혔어요. `setPixel(x, y, x*2+0.5, …)` 기울기는 8,192픽셀이 다 1씩 달랐어요((0,0) 이 미리보기 1, 내보낸 쪽 0). `__mkDisplay` 를 harness 의 두 규칙대로 고치고, `lib/lab/compositor.test.ts` 의 「preview matches the flattened export」에 코드 레이어 판을 더해요. 그 시험이 쌓는 코드 레이어 `blue()`(`:200`~`:216`, #159)는 정수 좌표에 0 과 255 만 그려서 이 어긋남에 닿지 않아요. | `lib/lab/flatten.ts`, `lib/lab/compositor.test.ts` |
+| 11 | 근간 | 코드의 `// @matrix` 줄을 고쳐 치는 동안 픽셀과 텍스트 레이어가 잘려 나가지 않는다 | 128×64 판에 다 칠한 픽셀 레이어(8,192칸)와 텍스트 레이어를 두고, 코드의 `// @matrix 128x64` 를 96 으로 한 자씩 고쳐 쳤어요. 편집기가 칠 때마다 `updateLayerCode` 를 불러서 `12x64` 에서 폭 12 로 잘려 768칸이 됐어요. `1x64` 는 읽지 못해 128×64 로 돌아갔고, `9x64` 에서 다시 잘려 576칸이 됐어요. `96x64` 에 닿았을 때 8,192칸 가운데 576칸만 남았어요(93% 잃음). 텍스트의 `spec.x` 는 바로 96 으로 바꿨을 때의 48 이 아니라 47 이에요. 다른 `@matrix` 가 든 코드를 붙여 넣어도 말없이 잘려요. `lib/lab/store/layers.ts:171`~`:182` 가 줄이 바뀔 때마다 크기를 바꾸고, 읽지 못한 줄은 `?? DEFAULT_MATRIX` 로 받아요. 크기를 바꾸기 전에 픽셀 되돌리기 기록도 남기지 않아요. 읽히는 줄만 받고, 바꾸기 전에 래스터 레이어를 `pixelHistory` 에 남겨요. 칠 때마다가 아니라 편집기를 떠날 때 바꿀지도 이 PR 에서 정해요. | `lib/lab/store/layers.ts`, 새 `lib/lab/store/layers.test.ts` |
+| 12 | UI | To hardware 에 붙인 헤더가 창을 닫거나 쪽을 다시 불러와도 남는다 | 헤더를 붙인 뒤 Esc 나 바깥 판으로 창을 닫고 다시 열면 칸이 `""` 로 비어 있어서, AI 에게 다시 물어야 해요. 폰에선 코드 레이어 둘 가운데 L0 를 붙여 「1 done」 이 된 뒤 쪽을 다시 불러오니 두 칸이 다 비고 「0 done」 이었어요. 프로젝트는 남았어요. 창을 연 채 안드로이드 뒤로 가기를 누르면 `/` 로 가고, 앞으로 돌아오면 창이 닫혀 있어요. 붙인 글과 단계는 이 창의 `useState`(`app/pattern-lab/HardwareModal.tsx:51`~`:54`)에만 있고, 창은 닫히면 사라져요(`:146`~`:157`). 붙인 글은 레이어 코드에 묶어 sessionStorage 에 두고 창을 열 때 되살려요. 코드가 바뀌면 지워요. 시험은 `HardwareModal.test.tsx` 의 `Lab` 틀로 붙이고 Esc 하고 다시 그려서 봐요. | `app/pattern-lab/HardwareModal.tsx`, `app/pattern-lab/HardwareModal.test.tsx` |
+| 13 | UI | Lab 의 창 안에서 글을 끌어 고르다 창 밖에서 놓아도 창이 닫히지 않는다 | 크로미움은 누른 곳과 뗀 곳이 다르면 click 을 두 곳의 공통 조상에 보내요. To hardware 의 `closeOnBackdrop`(`app/pattern-lab/HardwareModal.tsx:146`)은 `event.target === event.currentTarget` 만 봐요. 헤더 칸에서 끌어 바깥 판에서 떼면 공통 조상이 바깥 판이라 이 검사를 지나 창이 닫히고, 붙인 헤더는 이 창의 `useState`(`:51`, `:52`)에만 있어 같이 사라져요. 이 빌드엔 To hardware 가 없어서 같은 구조를 낱장 HTML 로 만들어 크로미움에서 끌어 봤어요. 오늘 규칙으론 1번 닫혔고, 누름도 바깥 판에서 시작했을 때만 닫는 규칙으론 0번이었어요. 바깥 판을 한 번 누르면 두 규칙 다 닫아요. 실제 Lab 에서도 Code guide 의 코드 글(`panels/CodeGuideModal.tsx:16`)과 Import image 제목(`panels/ImportImageModal.tsx:219`)을 끌어 바깥에서 떼니 창이 닫혔어요. 바깥 판의 `onPointerDown` 에서 누름이 판 자신에서 시작했는지 적어 두고, click 은 그때만 닫아요. | `app/pattern-lab/HardwareModal.tsx`, `app/pattern-lab/panels/CodeGuideModal.tsx`, `app/pattern-lab/panels/ImportImageModal.tsx`, `app/pattern-lab/HardwareModal.test.tsx` |
+| 14 | UI | 텍스트 효과의 빠르기를 Text 패널에서 바로 돌린다 | 흐르기, 반짝임, 색 램프 효과는 「Speed knob」(`app/pattern-lab/panels/TextPanel.tsx:391`)으로 고른 노브 하나가 빠르기를 정해요. 그런데 Text 패널엔 그 노브를 돌리는 칸이 없고, 노브가 0 이면 「turn it up in Knobs」 라고만 해요(`:402`~`:409`). 폰에선 Knobs 가 같은 탭 묶음이라 빠르기를 바꿀 때마다 탭을 두 번 옮기고, 그동안 안내 글은 안 보여요. 오늘은 그 두 번에 패널 둘이 닫혀요(1위 줄). 「Speed knob」 고르개 옆에 `setKnob(spec.effectKnob)` 에 묶인 범위 칸을 둬요. Knobs 패널의 노브와 같은 값이라 둘이 같이 움직여요. | `app/pattern-lab/panels/TextPanel.tsx`, `app/pattern-lab/panels/TextPanel.test.tsx` |
+| 15 | UI | Code 패널의 붙여넣기 상자와 안내가 영어로, 고른 레이어의 종류대로 말한다 | 클립보드 읽기를 거절하게 두고 Code 패널의 Paste 를 누르면 `window.prompt` 가 「붙여넣을 패턴 코드를 아래 상자에 입력하거나 붙여넣어 주세요:」 로 떠요(`app/pattern-lab/panels/CodePanel.tsx:102`). 쪽은 `lang="en"` 이고, Make 가이드(`components/guide/copy/lab.ts:61`)가 사람들을 이 상자로 보내요. 텍스트 레이어를 고르면 Code 패널은 「The selected layer is pixel art」(`CodePanel.tsx:47`), Pixel 패널은 「The selected layer is a code pattern」(`app/pattern-lab/panels/PixelPanel.tsx:130`)이라고 해요. 두 안내는 텍스트 레이어가 생기기(#184) 전에 쓴 글이에요. 상자 글을 영어로 쓰고, 두 안내는 `layer.type` 으로 지어요. 시험은 `readText` 를 거절시키고 `window.prompt` 를 엿보는 것과, 텍스트 레이어를 고른 두 패널의 글을 봐요. | `app/pattern-lab/panels/CodePanel.tsx`, `app/pattern-lab/panels/PixelPanel.tsx`, `app/pattern-lab/panels/CodePanel.test.tsx`, `app/pattern-lab/panels/PixelPanel.test.tsx` |
+| 16 | UI | Knobs 패널에서 화살표 키 한 번이 기기의 노브 한 칸만큼 움직인다 | 노브 칸은 `step="0.001"` 인 range 예요(`app/pattern-lab/panels/KnobsPanel.tsx:286`). 1440×900 에서 화살표 오른쪽을 10번 누르니 Freq 가 10 에서 10.01 로 가서 13픽셀이 바뀌었고, Quantize 는 2 에서 2.01 로 가서 0픽셀이었어요. Freq 의 10..120 을 끝까지 가려면 110,000번이에요. PageUp 은 범위의 10% 예요. 기기는 한 바퀴가 24칸이고 범위 끝에서 끝이 두 바퀴예요. 화살표에 `knobDetentStep(ranges[i])`(`lib/pattern/controls.ts:33`)만큼 움직이는 `onKeyDown` 을 달면 끝에서 끝이 48번이에요. 마우스로 끌 때를 위해 `step` 은 그대로 둬요. 시험은 ArrowRight 가 store 의 노브를 한 칸 올리는지 봐요. | `app/pattern-lab/panels/KnobsPanel.tsx`, 새 `app/pattern-lab/panels/KnobsPanel.test.tsx` |
+| 17 | UI | 폰에서 Layers 와 Knobs 의 단추가 손가락 크기다 | 390×844 터치에서 Layers 막대의 「+ Code」 가 60×28px, 「+ Pixel」 56×28, 「+ Text」 54×28, 「Dup」 41×28, 「Del」 37×28px 예요. 레이어 줄의 눈은 20×17px, 마스크 칸은 13×13px 이고, Knobs 의 「Push」 는 40×22px 예요. 막대 단추는 `app/pattern-lab/LabPanels.module.css:173`~`:187` 의 28px, 눈은 `:352`~`:362` 의 폭 20px, 노브 단추는 `app/pattern-lab/panels/KnobsPanel.module.css:173`~`:181` 의 22px 에서 와요. Text 패널은 이미 `@media (hover: none)` 에서 칸을 44px 로 키워요(`app/pattern-lab/panels/TextPanel.module.css:136`~`:147`). 같은 꼴을 두 파일에 넣어요. 노브 끌기 자체는 손가락으로 돼요(40px 끌기에 범위의 18%). | `app/pattern-lab/LabPanels.module.css`, `app/pattern-lab/panels/KnobsPanel.module.css`, `app/pattern-lab/labCss.test.ts` |
+| 18 | UI | 폰에서 Pixel 패널이 그림을 1× 대신 2× 로 맞춰 연다 | 390×844 에서 Pixel 패널의 그림 칸은 372×151px 예요. Preview 가 높이의 42% 를 갖고(`app/pattern-lab/panels/registry.tsx:116`), 도구 줄 둘이 103px 와 75px, 아래 상태 줄이 51px 를 써요. 상태 줄이 51px 인 건 「alt-click picks · right-drag erases · middle-drag pans」(`panels/PixelPanel.tsx:220`)가 두 줄로 접혀서인데, 이 손짓은 터치 화면엔 없어요. 그래서 맞춤이 1× 를 골라(`panels/pixel/usePixelViewport.ts:18` 주석도 그렇게 적어요) LED 한 칸이 CSS 1px 이에요. 이 글만 `@media (hover: none)` 에서 숨기니 상태 줄이 25px, 그림 칸이 372×177px 가 되고 Fit 이 2× 를 골랐어요. 2× 는 그림 칸 높이가 168px(64×2+40) 이상이면 되니 9px 남아요. 본은 같은 Lab 의 `app/pattern-lab/panels/TextPanel.module.css:136` 에 있는 `@media (hover: none)` 이에요. | `app/pattern-lab/panels/PixelPanel.tsx`, `app/pattern-lab/LabPanels.module.css`, `app/pattern-lab/panels/pixel/usePixelViewport.ts`(주석) |
+| 19 | UI | Pattern Lab Pixel 의 − + 단추가 보이는 가운데를 붙잡고 확대한다 | 휠 확대는 커서 아래 자리를 지켜요(`app/pattern-lab/panels/pixel/usePixelViewport.ts:120`, `:157`~`:170`). − + 가 부르는 `zoomBy`(`:68`)는 배율만 바꾸고 굴림 위치를 그대로 둬서, 그림이 뷰포트 왼쪽 위를 기준으로 커져요. 1440×900 에서 10× 로 키우고 가운데로 굴렸어요(가운데 칸 64, 32). + 를 한 번 누르니 가운데가 58.2, 29.1 로 6칸 밀렸고, − 두 번엔 71.2, 32 로 갔어요. 같은 자리에서 휠 한 칸은 64.1 그대로였어요. Fit 은 그림이 다 들어가 가운데에 오니 괜찮아요. Director 의 ± 가 보이는 가운데를 지키는 꼴(`panels/director/useTimelineZoom.ts:62`~`:73`)을 따라요. `zoomBy` 가 뷰포트 가운데를 `wheelAnchor` 에 넣고, 같은 레이아웃 효과가 굴림을 되돌려요. | `app/pattern-lab/panels/pixel/usePixelViewport.ts`, `app/pattern-lab/panels/PixelPanel.test.tsx` |
+| 20 | UI | Lab 의 Share 창이 Esc 로 닫힌다 | Lab 머리줄의 Share 가 여는 `components/community/PublishModal.tsx`(`app/pattern-lab/PatternLabClient.tsx:547`)는 바깥 판 클릭으로만 닫히고(`:254`) 키 리스너가 없어요. 이 빌드엔 `NEXT_PUBLIC_COMMUNITY_URL` 이 없어 Share 가 보이지 않아서(`lib/community/apiBase.ts:36`) jsdom 으로 쟀어요. 창을 그리고 window 와 초점 칸에 Escape 를 보내니 `onClose` 는 0번 불렸어요. 초점은 여는 순간 제목 칸으로 가요(`:323`). Lab 의 다른 창이 쓰는 `lib/hooks/useDialog.ts:18` 꼴을 따라요. To hardware 창의 주석(`app/pattern-lab/HardwareModal.tsx:150`~`:159`)은 Publish 가 키를 듣지 않는다고 보고 첫 Esc 를 대신 받아요. Publish 가 듣게 되어도 두 리스너가 다 `setPublishCode(null)` 만 하니 To hardware 는 남아요. 그 주석과 `HardwareModal.test.tsx:216` 를 함께 고쳐요. | `components/community/PublishModal.tsx`, `components/community/PublishModal.test.tsx`, `app/pattern-lab/HardwareModal.tsx` |
+| 21 | UI | 커뮤니티의 「Add firmware header」 창이 Lab 의 지금 단추 이름을 말한다 | 이 창은 헤더를 만드는 길로 「Generate the port with Copy C++ prompt in Pattern Lab」(`components/community/AddHeaderModal.tsx:154`)과 「Generate one with Copy C++ prompt in」(`:176`)을 말해요. Lab 엔 그 단추가 없어요. 지금은 머리줄 「To hardware」 창의 「Copy the conversion prompt」(`app/pattern-lab/HardwareModal.tsx:263`)예요. `web/ARCHITECTURE.md:120` 은 이미 그렇게 적어요. 아래 「창작자가 열어야 하는 것」 의 프리셋 문서 줄과 같은 옛 이름인데, 이 파일은 `web/` 안이라 바퀴가 고쳐요. | `components/community/AddHeaderModal.tsx` |
+| 22 | 근간 | 범위가 0.001 보다 좁은 노브도 커뮤니티 카드에서 Lab 과 같은 값으로 돈다 | 노브 값을 0..1 로 펴는 계산이 여덟 곳에 따로 있고, 바닥값이 둘로 갈렸어요. Lab 엔진(`lib/lab/engine.ts:236`), 캡처 워커(`lib/lab/capture/capture.worker.ts:167`), C++ 내보내기(`lib/lab/hExport.ts:206`), 텍스트 효과 빠르기(`app/pattern-lab/panels/TextPanel.tsx:80`, #187)는 `Math.max(0.0001, span)` 이고, 커뮤니티 샌드박스(`sandbox/sandbox.ts:90`)와 카드(`lib/community/knobs.ts:46`, `components/community/PatternCard.tsx:378`, `:394`)는 `Math.max(0.001, span)` 이에요. #130 이 `0.0001..0.0004` 같은 범위가 올린 뒤에도 남게 고쳤는데, 그 범위 가운데인 0.00025 를 Lab 은 `knobNormalized` 0.5 로, 샌드박스는 0.15 로 패턴에 줘요. 카드의 첫 값도 어긋나요. `knobs.ts:23` 의 `midpoint` 가 소수 셋째 자리에서 잘라서 `0.0001..0.0004` 는 범위 밖인 0(샌드박스 값 −0.1)으로, `0.001..0.002` 는 맨 끝인 0.002 로 시작해요(tsx 로 `knobSetupFromCode` 를 불러 쟀어요). 이 값은 카드와 패턴 쪽, 서버 썸네일(`lib/community/thumbs.ts:93`)이 같이 써요. 바닥값 하나와 반올림 없는 가운데값을 `lib/pattern/controls.ts` 에 두고 여덟 곳이 불러요. 샌드박스를 고치면 `npm run build:sandbox` 로 `public/pattern-sandbox.html` 을 다시 만들어요(`check:sandbox-sync`). PR 이 크면 커뮤니티 쪽부터 해요. | `lib/pattern/controls.ts`, `lib/pattern/controls.test.ts`, `lib/community/knobs.ts`, `lib/lab/engine.ts`, `lib/lab/capture/capture.worker.ts`, `lib/lab/hExport.ts`, `app/pattern-lab/panels/TextPanel.tsx`, `components/community/PatternCard.tsx`, `sandbox/sandbox.ts`, `web/public/pattern-sandbox.html` |
+| 23 | 준비 | Lab 에서 만든 헤더를 CC BY 4.0 으로 올려도 내려받은 `.h` 에 라이선스 줄이 하나만 있다 | 로드맵 `biz-market`(`app/roadmap/roadmap-data.ts:1099`)은 「the provenance and licence records the community already keeps」를 상업 라이선스의 토대로 삼아요. 그런데 Lab 의 C++ 뼈대는 첫 줄에 `// SPDX-License-Identifier: CC-BY-SA-4.0` 를 박아 넣어요(`lib/lab/hExport.ts:211`). To hardware 창은 이 헤더를 그대로 공유 창에 넘기고(`app/pattern-lab/HardwareModal.tsx:368`), 원작은 CC BY 4.0 을 고를 수 있어요(`lib/pattern/share.ts:25`). 내려받을 때 쓰는 `buildSharedHeaderFile`(`share.ts:196`, `lib/community/download.ts:69`)은 `#pragma once` 밑에 제 줄을 넣기만 하고 위에 있던 줄을 떼지 않아요. `buildHExport` 로 만든 헤더를 CC BY 4.0 으로 감싸 보니 1번째 줄은 `CC-BY-SA-4.0`, 18번째 줄은 `CC-BY-4.0` 이었어요. 감쌀 때 원래 있던 SPDX 줄을 떼어요. 시험은 `scripts/license-smoke.ts:120` 꼴로 하나 더해요. | `lib/pattern/share.ts`, `web/scripts/license-smoke.ts` |
+| 24 | 근간 | Pattern Lab CSS 에서 아무 컴포넌트도 쓰지 않는 클래스 13개와 그 규칙 169줄이 빠진다 | `app/pattern-lab/**/*.module.css` 10개에 정의된 클래스를, 그 파일을 불러오는 `.tsx` 의 `styles.x`, `styles["x"]` 와 `composes` 에 맞춰 봤어요. 동적 접근은 없었고 13개가 어디서도 쓰이지 않아요. `app/pattern-lab/PatternLab.module.css` 가 9개(`header`, `headerMeta`, `actionRow`, `previewHeader`, `editorHeader`, `guideButton`, `pasteButton`, `clearButton`, `viewToggle`)이고, 셀렉터가 다 죽은 규칙만 137줄이에요. 주로 `:91`~`:132`, `:251`~`:359`, `@media (max-width: 980px)` 안 `:506`~`:544` 에 있고, 그 사이 산 규칙(`.stats`, `.darkButton` `:274`)은 남겨요. #183 이 `keyButton`, `genThinking`, `.emptyState` 를 이미 걷었어요. `.headerMeta, .stats, .actionRow`(`:100`)처럼 산 클래스와 묶인 셀렉터(`:109`, `:274` 도)에선 죽은 이름만 빼요. `panels/CapturePanel.module.css` 는 `stageBox`, `stageCanvas`, `stageCanvasTransparent` 가 27줄(`:110`~`:141`)이고, `panels/DirectorPanel.module.css` 는 `hint` 가 5줄(`:233`~`:237`)이에요. 나머지 7개 파일은 0개예요. | `app/pattern-lab/PatternLab.module.css`, `app/pattern-lab/panels/CapturePanel.module.css`, `app/pattern-lab/panels/DirectorPanel.module.css` |
+| 25 | UI | Pattern 탭의 고급 안내와 To hardware 칸의 두 문단, Build 탭의 다른 길 안내가 제 글자 크기로 보인다 | `app/globals.css:847` 의 `.panel-body p`(20px, 900px 아래 17px `:868`)는 명시도 (0,1,1)이라 CSS 모듈 클래스 하나를 이겨요. 1440 에서 `.advancedNote`(`components/sections/PatternPanel.module.css:283`)와 `.hardwareNote` 둘(`:344`)은 14px 대신 20px, `.otherPaths`(`components/sections/BuildPanel.module.css:173`)는 15px 대신 20px 예요. 옆 카드 글은 15px 이고 칸 제목 `hardwareTitle` 은 18px 이라 안내가 제목보다 커요. `margin: 0` 도 져서 아래 여백 28px 가 붙고, To hardware 칸은 572px 로 363px 보다 209px 길어요. `InsidePanel.module.css:105` 의 `.body .mapNote`, `InsideGlobe/BuildCard.module.css:10` 의 `.card .empty` 꼴을 따라요. `BuildPanel.tsx:237` 은 `styles.buildPanel` 이 있고, `PatternPanel.tsx:159` 의 `panel-body` 엔 모듈 클래스를 하나 더해요. | `components/sections/PatternPanel.module.css`, `components/sections/PatternPanel.tsx`, `components/sections/BuildPanel.module.css` |
+| 26 | UI | Make 가이드의 덱 순서 경고가 지금 펌웨어 판을 말한다 | 「Your deck」 단계는 「Up to firmware v3.10.4, Send over Wi-Fi drops this order; the next firmware keeps it」라고 해요(`components/guide/copy/community.ts:71`, 한국어 `:137`, 주석 `:23`~`:25`). 그 다음 펌웨어 3.10.5 가 10월 2일에 나와 덱 순서를 지키고(`CHANGELOG.md:113`), 지금은 3.11.0 이에요(`firmware/patternflow/net_config.h:114`). 「3.10.5 부터」처럼 판 번호로 적어요. | `components/guide/copy/community.ts` |
+| 27 | UI | 가로로 든 폰에서 Build, Pattern, Inside 탭의 글이 화면의 절반 넘게 보인다 | 900px 아래에선 3D 보기(`--mb-viewer-h: 44vh`, `app/globals.css:185`, `:273`)와 탭 막대 52px(`:2794`, `:2805`)가 위에 붙어요. 844×390 에서 재 보니 둘이 224px 를 쥐어서 글은 166px(43%)만 보이고, 740×360 에선 150px 예요. Pattern 탭의 편집기는 하한 120px(`components/sections/PatternPanel.module.css:414`)라 166px 가운데 120px 를 덮어서, 그 주석(`:404`~`:411`)이 막으려던 일이 가로 화면에서 다시 생겨요. `@media (max-width: 900px) and (max-height: 500px)` 에서 `--mb-viewer-h` 를 30vh 로 주니 글이 221px(57%) 보였고, 편집기는 131px 로 따라왔어요. 세로 390×844 는 그대로예요. 변수가 vh 그대로라 `components/sections/InsideGlobe/BuildCard.tsx:38`~`:41` 의 계산도 맞아요. | `app/globals.css` |
+| 28 | UI | 폰에서 로드맵 마디를 누르면 뜨는 창이 닫기 단추까지 화면 안에 든다 | 창 폭은 360px 로 박혀 있고(`app/roadmap/RoadmapMap.tsx:97`, `:704`), 오른쪽에 자리가 없으면 마디 왼쪽으로 넘기기만 해서(`:373`~`:374`) 0 아래로 내려가도 잡지 않아요. 390px 에서 맨 왼쪽 마디를 누르니 창이 x −384~−24 에 떠서 닫기 단추(−78~−45)까지 하나도 안 보였고, 가운데 마디는 −153 에서 시작해 날짜와 제목이 132px 잘렸어요. 폭을 `min(360, 캔버스 − 28)` 로, `left` 를 `margin`~`캔버스 − 폭 − margin` 사이로 잡아요. `top` 은 이미 `:375` 에서 그렇게 잡아요. 계산을 함수로 빼서 390 폭을 시험해요. `roadmap-data.ts` 는 건드리지 않아요. | `app/roadmap/RoadmapMap.tsx`, `app/roadmap/RoadmapMap.test.tsx` |
+| 29 | UI | 폰에서 덱 쪽과 프로필 쪽이 긴 덱 카드 때문에 옆으로 밀리지 않는다 | 폰 규칙의 `.deckGrid { grid-template-columns: 1fr }`(`components/community/Community.module.css:5765`~`:5767`)는 `minmax(auto, 1fr)` 이라 카드가 제목 줄의 최소 폭보다 좁아지지 않아요. 제목 줄엔 제목과 「2 slots」, 비공개면 「private」 칩, 작성자가 한 줄로 서고(`components/community/DeckCard.tsx:47`~`:57`) 제목만 `nowrap` 말줄임이에요(`Community.module.css:2986`). 로그인해서 20자 제목의 비공개 덱이 있는 `/community/decks` 를 390px 로 여니 카드가 386px 라 `scrollWidth` 가 402px 였고, 360px 에서도 카드는 386px 그대로였어요. 바로 아래 `.profileGrid`(`:5769`)처럼 `minmax(0, 1fr)` 로 주입하니 카드 358px, 제목은 말줄임, `scrollWidth` 390px 이었어요. 같은 격자를 `app/community/u/[username]/page.tsx:134` 도 써요. | `components/community/Community.module.css`, `components/community/communityCss.test.ts` |
+| 30 | UI | 기기 주소칸 앞 글자를 눌러도 칸에 초점이 가고, 보내기 창에서도 칸 테두리가 보이며, 폰에서 칸이 누르기 쉬운 높이가 된다 | 「Device address:」 글자와 칸이 `<label>` 없이 나란히 있어요(`components/community/DeckPanel.tsx:192`, `SendModuleModal.tsx:250`, `ShippedPackCard.tsx:115`). `/community/decks` 의 묶음 카드에서 글자를 눌러 보니 초점이 `BODY` 로 갔어요. 세 칸의 꾸밈은 저마다 인라인 `style` 인데 보내기 창만 `border`, `background`, `color` 가 빠졌어요(`SendModuleModal.tsx:258`~`:262`). 지은 CSS 로 그 칸을 그려 보니 테두리가 0px 라 「patternflow.local」 이 그냥 글자로 보였어요. 칸은 390px 에서도 116×21px 이라 같은 파일의 닫기 단추 44px 규칙(`Community.module.css:2564`)에 못 미쳐요. 세 칸을 `<label>` 로 감싸고 꾸밈을 클래스 하나로 모아요. | `components/community/DeckPanel.tsx`, `SendModuleModal.tsx`, `ShippedPackCard.tsx`, `Community.module.css`, `components/community/fieldNames.test.tsx` |
+| 31 | UI | 첫 화면과 Pattern, Inside 탭의 이름 붙은 묶음 다섯이 화면 읽기 프로그램에 제 이름을 알린다 | role 없는 `div` 의 `aria-label` 은 ARIA 1.2 에서 쓸 수 없는 이름이라 읽기 프로그램이 지나쳐요. 크로미움 접근성 트리에서 `components/sections/InsidePanel.tsx:52` 와 `:56` 은 role 이 generic 이고, axe 는 `/` 에서 1곳(`Hero.tsx:151`), `/pattern` 에서 2곳(`PatternPanel.tsx:194`, `:303`), `/inside` 에서 2곳을 「div with no valid role」로 잡아요. `:52` 는 바로 아래 h1(`:54`)이 이름이고 `BuildPanel.tsx:231`, `PatternPanel.tsx:154` 엔 없으니 지워요. 나머지 넷은 같은 파일 `PatternPanel.tsx:224` 의 `role="group"` 꼴을 따라요. | `components/sections/InsidePanel.tsx`, `components/sections/PatternPanel.tsx`, `components/sections/Hero.tsx`, `components/sections/InsidePanel.test.tsx`, `components/sections/PatternPanel.test.tsx` |
+| 32 | UI | 브레드보드 가이드의 그림 밑 설명과 사진 글이 크림 바탕에서 읽힌다 | 그림 밑 안내(「↑ Ground (GND) pins … land on the Ground rail」 같은 배선 설명)가 `--pf-ink-faint` #A69F90 이라 크림 바탕에서 2.13~2.30:1 이에요. 글은 4.5:1 이 필요해요. axe 가 `/build/breadboard` 에서 이 색 때문에 17곳을 잡았고, `app/build/breadboard/page.tsx` 의 인라인 스타일 14곳(`:145`, `:266`, `:272`, `:279`, `:286`, `:388`, `:401`, `:433`, `:446`, `:478`, `:491`, `:533`, `:580`, `:625`)을 `--pf-ink-muted`(5.05:1, cream-2 에서 4.69:1)로 바꿔 보니 1440 과 390 에서 0곳이 됐어요. 토큰 자체를 바꾸면 로드맵, compliance, 저널까지 닿아서 쪽마다 나눠요. 다음 조각은 `/features` 예요(`app/features/Features.module.css` 6규칙으로 46곳 가운데 34곳). | `app/build/breadboard/page.tsx` |
+| 33 | UI | 태블릿 폭(820~1279px)에서 브레드보드 가이드의 단계 사진이 화면 높이 안에 든다 | 1280px 아래에선 `.photo`(`app/build/breadboard/breadboard.module.css:3`)가 `width: 100%` 라 단계 사진 넷이 본문 폭 그대로 772×1371px 로 그려져요. 1024×768 과 900 폭에서 사진 한 장이 화면보다 600px 남짓 길고, 쪽 높이는 13,077px 예요(1280px 에선 7,358px). 넓은 화면 쪽이 이미 쓰는 `max-width: 360px`(`:44`~`:47`)를 1280px 아래에도 주고 가운데로 모으니 사진이 360×638px 가 되고, 1024 폭의 쪽 높이는 10,166px 로 줄었어요. 390px 에선 342×606px 그대로예요. 파일 머리 주석(`:1`~`:2`)도 같이 고쳐요. | `app/build/breadboard/breadboard.module.css` |
+| 34 | UI | 느린 기계에서도 Inside 지구본이 처음 열릴 때와 빌드를 고를 때 1초 안팎에 자리를 잡는다 | 카메라 거리(`components/sections/InsideGlobe/Globe.tsx:1165`)와 고른 곳으로 돌기(`:1121`, `:1122`, `:1126`, `:1127`)는 프레임마다 남은 거리의 0.08 을 가서 프레임 수로만 끝나요. 1440×900 에서 카메라는 5(`:1054`)에서 6.54(`:1163`)로 물러나는데, WebGL 행렬로 재 보니 1% 안에 들기까지 55프레임이 걸렸어요. 60fps 면 0.92초지만 이 컨테이너(3fps)에선 18.8초였고, 빌드를 고를 때도 50프레임 21초였어요. 같은 파일의 `easeShare`(`:414`)가 이미 시간으로 줄이니 다섯 줄을 `easeShare(5, delta)` 로 바꿔요. 60fps 에서 0.0800 이라 지금 느낌은 같아요. `easeShare` 를 작은 파일로 빼서 1/60초 60번과 1/10초 10번이 같은 곳에 닿는지 봐요. | `components/sections/InsideGlobe/Globe.tsx`, 새 `components/sections/InsideGlobe/ease.ts`, 새 `components/sections/InsideGlobe/ease.test.ts` |
+| 35 | UI | 없는 주소로 들어가면 브라우저 탭과 링크 미리보기에 첫 화면 제목 대신 찾을 수 없다는 제목이 뜬다 | 빌드한 사이트에서 없는 주소를 부르면 404 와 `noindex` 는 맞게 오지만, `<title>` 과 설명, `og:title`, `twitter:title` 이 다 첫 화면 것(`app/layout.tsx:42`~`:44`)이에요. 탭, 방문 기록, 메신저 미리보기가 첫 화면처럼 보여요. canonical 은 없어서 그대로 둬요. `app/not-found.tsx` 는 metadata 를 내보내지 않는데, Next 16 문서(`node_modules/next/dist/docs/01-app/03-api-reference/03-file-conventions/not-found.md:187`)는 뿌리 `not-found` 의 `metadata` 를 받아요. `app/metadata.test.ts` 의 쪽별 시험에 한 줄 더해요. | `app/not-found.tsx`, `app/metadata.test.ts` |
+| 36 | UI | 덱 패널과 보내기 창이 빌드를 기다리는 동안 아래 독처럼 「usually under N s」 로 덱 크기에 맞는 시간을 말한다 | 세 곳이 같은 훅의 `expectedS`(`lib/community/useModuleBuild.ts:214`, 셈은 `:50`~`:53` 으로 6초에 패턴마다 1.5초)를 받는데 그 수를 보여 주는 건 독뿐이에요(`components/community/DeckDock.tsx:539`). `DeckPanel.tsx:146` 과 `SendModuleModal.tsx:209` 는 「usually a second or two」 라고 쓰다가 `expectedS` 가 지나야 「longer than usual」 로 바뀌어요. 패턴 하나면 8초, 20개 덱(`lib/community/deck.ts:47`)이면 36초 동안 「1~2초」라고 말하는 셈이에요. 독의 글을 따라요. | `components/community/DeckPanel.tsx`, `components/community/SendModuleModal.tsx`, `components/community/BuildWait.test.tsx` |
+| 37 | 근간 | 타입 검사에서 `PatternPanel.tsx` 한 파일이 쓰던 9초 넘는 시간이 0.3초 아래로 준다 | `components/sections/PatternPanel.tsx:22` 는 `<esp-web-install-button>` 을 `React.ElementType<EspWebInstallButtonProps>` 로 바꿔 써요. 이 타입은 JSX 의 내장 요소마다 props 가 맞는지 따져 모은 합집합(`@types/react` `index.d.ts:109`)이라서, 검사기가 `:21` 과 그 요소를 그리는 `:338` 에서 오래 머물러요. `tsc --noEmit --generateTrace` 로 재니 이 파일이 9.3초(검사 70.2초 가운데)로 가장 느렸고, 그 안에서 `:22` 가 3.3초, `:338` 이 5.7초였어요. `web/` 을 스크래치에 복사해 같은 3,715개 파일로 두 번씩 돌려 보니, 지금은 9.2초와 15.5초(그 회 검사 시간의 16% 와 23%)였어요. `React.FC<EspWebInstallButtonProps>` 로 바꾸면 0.22초와 0.29초였고 오류는 0개였어요. 같은 버튼을 `components/guide/Extras.tsx:38` 이 이미 `React.FC` 로 써요. 기계가 바빠서 회마다 전체 시간이 흔들렸으니 이 파일 몫만 적어요. | `components/sections/PatternPanel.tsx` |
+| 38 | 근간 | 모든 쪽이 받는 `globals.css` 에서 아무도 쓰지 않는 옛 Inside 패널 규칙 375줄이 빠진다 | `app/globals.css` 의 클래스 190개 가운데 60개는 `web/src`, `web/content`, `web/public`, `web/scripts` 어디에도 이름이 없어서, 규칙 138개 694줄이 아무것도 안 그려요. 가장 큰 덩어리는 `:1117`~`:1492`(「"Inside" panel list」부터 Sponsor 앞까지, `inside-*` 와 `reddit-comment-*`)이고 살아 있는 규칙이 하나도 없어요. 8,359바이트(gzip 1,849)인데 모든 쪽이 받는 `.next/static/chunks/*.css`(gzip 13,561)에 그대로 들어가요. `inside-carousel` 같은 이름은 템플릿으로 만드는 곳도 없어요. 나머지(`pf-marquee`, `version-tag`, `key-points`, `business-*` 와 저널 규칙 7개)는 다음 조각이에요. | `app/globals.css` |
+| 39 | 근간 | `web/ARCHITECTURE.md` 의 첫 화면 구성도와 Pixel 줄, 캠페인 주소가 지금 파일을 말한다 | 틀린 말이 여섯 곳이에요. `:43` 은 패턴 목록이 `common.ts` 에 있다지만 `components/3d/patterns/index.ts:6` 에 있어요. `:46` 은 `BuildPanel.tsx` 에 플래셔 입구가 있다지만 그 파일엔 `esp-web-install-button` 이 없고 `PatternPanel.tsx:22` 에 있어요(같은 문서 `:21` 도 그렇게 말해요). `:47` 은 Pattern 패널의 단추가 다 /pattern-lab 로 간다지만 `PatternPanel.tsx:310`, `:325`, `:374` 는 커뮤니티, 펌웨어 README, Play 가이드로 가요. 지구본은 `components/3d/ViewerPanel.tsx:11`, `:93` 이 그리는데 그림(`:39`~`:48`)엔 InsidePanel 밑에 있어요. `:73` 의 `pixelToCode.ts` 는 `panels/pixel/` 가 아니라 `lib/lab/pixelToCode.ts` 예요. `:31` 은 캠페인 링크를 `/r/*` 로 적지만 8개 가운데 4개(`/hn`, `/ig`, `/pcbway`, `/x`)는 맨 위 주소예요(`lib/campaignRoutes.ts:60`, `:70`, `:80`, `:90`). | `web/ARCHITECTURE.md` |
 | 40 | 준비 | 가이드 시뮬레이터 주석이 펌웨어를 줄 번호 대신 함수 이름으로 가리킨다 | `lib/guide/` 의 `patternflow.ino:NNN` 참조 30곳 가운데 27곳이 지금 줄과 어긋나요. `.ino` 가 위쪽에서 50줄쯤 늘어서예요. `drawScreenHeader` 는 646 이라 적혔지만 697 에 있고(`panelScreens.ts:718`), `drawKnobMap` 은 973 이 아니라 1022 예요(`:899`). 펌웨어를 고칠 때마다 이 주석이 또 어긋나니, `deviceSim.ts:234` 의 「patternflow.ino contentNoticeTimer」, `:330` 의 「patternflow.ino drawNetworkInfo」 꼴의 이름으로 바꿔요. 바퀴 39 가 더한 `lib/guide/firmwareConstants.test.ts` 가 펌웨어 파일을 읽으니, 주석이 부르는 이름이 `.ino` 에 있는지도 거기서 볼 수 있어요. | `lib/guide/panelScreens.ts`, `lib/guide/deviceSim.ts`, `lib/guide/tomThumbFont.ts`, `lib/guide/panelScreens.test.ts` |
 
 ## 창작자가 열어야 하는 것
 
-바퀴가 들어가지 못하는 곳(「안 하는 것」 목록)에서 본 개선거리예요. 바퀴는 이 표에서 고르지 않아요. 창작자가 말이나 바퀴 PR 댓글로 열면 그 글이 바퀴 일이 되고(고르는 차례 1번), 그 바퀴는 PR 본문 맨 위에 무엇을 건드렸는지 한 줄 적어요. 10월 21일 `dev`(`7d3b969`) 기준이에요.
+바퀴가 들어가지 못하는 곳(「안 하는 것」 목록)에서 본 개선거리예요. 바퀴는 이 표에서 고르지 않아요. 창작자가 말이나 바퀴 PR 댓글로 열면 그 글이 바퀴 일이 되고(고르는 차례 1번), 그 바퀴는 PR 본문 맨 위에 무엇을 건드렸는지 한 줄 적어요. 10월 23일 `dev`(`1b9a04a`)에서 다시 봤어요.
 
 | 무엇 | 까닭 | 위험 | 기기 시험 |
 |---|---|---|---|
-| web 잠금 파일만 `npm audit fix --package-lock-only` 로 올려 운영 의존성의 high 4건을 지운다 | `npm audit --omit=dev` 가 18건(critical 2, high 4, moderate 12)을 내요. high 는 `@google/genai` 아래 protobufjs 7.5.5(GHSA-66ff-xgx4-vchm 들 11건), `gray-matter` 아래 js-yaml 3.14.2(GHSA-52cp-r559-cp3m 들), tailwind 아래 source-map-js 1.2.1(GHSA-68fv-2mgg-jv7q), 10월 18일 뒤에 새로 든 vite 6.4.3(GHSA-9jrq-w75r-8gcw 들, vitest 몫)이에요. 스크래치 복사본에서 돌리니 `package.json` 은 그대로, 잠금 파일은 240줄 더하고 663줄 빠지며, high 가 0, 전체가 13(critical 2, moderate 9, low 2)이 됐어요. | vite 가 6.4.3 에서 7.3.7 로 메이저가 올라가요(vitest 3.2.7 이 받는 `^7.0.0-0` 안이에요). 스크래치에서 vite 7.3.7 로 vitest 를 돌리니 시험 파일 75개, 시험 785개가 다 지났어요. monaco-editor 도 0.57.0 으로 오르지만 타입만 주는 peer 라 브라우저가 받는 편집기는 그대로예요(다음 줄). 남는 critical 2건(tinypool)은 vitest 3 → 5 몫이고, vitest 5 는 Node 22.12 이상을 바라요. | 아니요 |
-| Monaco 를 jsdelivr 에서 받지 않고 사이트가 직접 싣는다 | 편집기 셋(`web/src/components/sections/PatternPanel.tsx:8`, `app/pattern-lab/panels/CodePanel.tsx:7`, `app/community/p/[id]/PatternDetailClient.tsx:6`)이 `@monaco-editor/loader` 1.7.0 의 기본값(`node_modules/@monaco-editor/loader/lib/es/config/index.js:3`)대로 `cdn.jsdelivr.net/npm/monaco-editor@0.55.1` 을 그때그때 받아요. 그래서 잠금 파일의 monaco-editor 를 올려도 브라우저가 받는 판은 그대로예요. 0.55.1 의 min 빌드는 DOMPurify 3.2.7 을 안고 있고(`min/vs/editor.api-CalNCsUg.js`), `npm audit` 은 3.4.15 아래 판에 권고 19건을 걸어요. jsdelivr 가 막힌 바퀴 컨테이너에선 `/pattern` 편집기가 「Loading...」에서 멈춰요. | `monaco-editor` 를 직접 의존성으로 올려야 해요. #111 이 넣은 `PatternPanel.tsx:73` 의 `opened` 처럼 탭을 열 때 붙여서 첫 덩이에 4.2 MB 가 들지 않게 하고, worker 경로를 잡아요. | 아니요 |
-| esp-web-tools 스크립트 주소를 정확한 판으로 고정한다 | `web/src/components/sections/PatternPanel.tsx:171` 과 `components/guide/Extras.tsx:109` 가 `unpkg.com/esp-web-tools@10/...` 로 큰 판만 적어서, 10.x 새 판이 검토 없이 「Flash Patternflow」 단추에 실려요. 오늘 `@10` 은 10.4.0(7월 15일)을 줘요. | 지금 받는 10.4.0 으로 고정하면 같은 파일이라 바뀌는 게 없어요. 나중에 판을 올릴 때는 첫 설치 길이라 보드에 구워 봐야 해요. | 아니요(올릴 때는 예) |
+| web 잠금 파일만 `npm audit fix --package-lock-only` 로 올려 운영 의존성의 high 4건을 지운다 | `npm audit --omit=dev` 가 14건(critical 2, high 4, moderate 8)을 내요. #183 이 Gemini 를 걷어 `@google/genai` 아래 protobufjs 는 빠졌어요. high 는 `gray-matter` 아래 js-yaml 3.14.2(GHSA-52cp-r559-cp3m 들), tailwind 와 postcss 아래 source-map-js 1.2.1(GHSA-68fv-2mgg-jv7q), vitest 몫의 vite 6.4.3(GHSA-587h-7wmj-h5pm), monaco-editor 0.55.1 안에 든 DOMPurify 3.2.7(GHSA-mrv2-3pqr-j5jr)이에요. 10월 23일 스크래치 복사본에서 돌리니 `package.json` 은 그대로, 잠금 파일은 219줄 더하고 634줄 빠지며, high 가 0, 전체가 9(critical 3, moderate 5, low 1)가 됐어요. critical 이 하나 는 건 monaco-editor 0.57.0 안의 DOMPurify 가 3.4.15 로 오르며 GHSA-cg2g-xh64-v4q7 범위에 들어서예요. | vite 가 6.4.3 에서 7.3.7 로 메이저가 올라가요(vitest 3.2.7 이 받는 `^7.0.0-0` 안이에요). 10월 21일 스크래치에서 vite 7.3.7 로 vitest 를 돌렸을 땐 그날의 시험 파일 75개, 시험 785개가 다 지났어요. 오늘 시험 파일은 92개이고 다시 돌리지 않았어요. monaco-editor 는 타입만 주는 peer 라 브라우저가 받는 편집기는 그대로예요(다음 줄). 남는 critical 가운데 tinypool 과 vitest 는 vitest 3 → 5 몫이고, vitest 5 는 Node 22.12 이상을 바라요. | 아니요 |
+| Monaco 를 jsdelivr 에서 받지 않고 사이트가 직접 싣는다 | 편집기 셋(`web/src/components/sections/PatternPanel.tsx:8`, `app/pattern-lab/panels/CodePanel.tsx:7`, `app/community/p/[id]/PatternDetailClient.tsx:6`)이 `@monaco-editor/loader` 1.7.0 의 기본값(`node_modules/@monaco-editor/loader/lib/es/config/index.js:3`)대로 `cdn.jsdelivr.net/npm/monaco-editor@0.55.1` 을 그때그때 받아요. 그래서 잠금 파일의 monaco-editor 를 올려도 브라우저가 받는 판은 그대로예요. 0.55.1 의 min 빌드는 DOMPurify 3.2.7 을 안고 있고(`min/vs/editor.api-CalNCsUg.js`), `npm audit` 은 3.4.16 까지의 판에 권고 21건(high 1, moderate 14, low 6)을 걸어요. jsdelivr 가 막힌 바퀴 컨테이너에선 `/pattern` 편집기가 「Loading...」에서 멈춰요. | `monaco-editor` 를 직접 의존성으로 올려야 해요. #111 이 넣은 `PatternPanel.tsx:74` 의 `opened` 처럼 탭을 열 때 붙여서 첫 덩이에 4.2 MB 가 들지 않게 하고, worker 경로를 잡아요. | 아니요 |
+| esp-web-tools 스크립트 주소를 정확한 판으로 고정한다 | `web/src/components/sections/PatternPanel.tsx:182` 와 `components/guide/Extras.tsx:109` 가 `unpkg.com/esp-web-tools@10/...` 로 큰 판만 적어서, 10.x 새 판이 검토 없이 「Flash Patternflow」 단추에 실려요. 오늘 `@10` 은 10.4.0(7월 15일)을 줘요. | 지금 받는 10.4.0 으로 고정하면 같은 파일이라 바뀌는 게 없어요. 나중에 판을 올릴 때는 첫 설치 길이라 보드에 구워 봐야 해요. | 아니요(올릴 때는 예) |
 | CI 의 Node 를 20 에서 22 로 올린다 | `.github/workflows/web-ci.yml:36` 과 `drift.yml:45` 가 `node-version: 20` 인데, Node 20 은 2026년 4월 30일에 지원이 끝났어요. 바퀴 컨테이너는 22.22.0 이고, `web/README.md:30` 은 「Node 20+ (matches CI)」, `@types/node` 는 `^20` 이에요. 밀린 메이저 가운데 vitest 5(`^22.12.0`), jsdom 30(`^22.22.2`), better-sqlite3 13(`>=22`)이 Node 22 를 바라서, 이 줄이 메이저 줄보다 먼저예요. | better-sqlite3 같은 네이티브 꾸러미를 다시 받아요. `docs/SERVICES.md:157` 대로면 Pi 는 Node 21.7.2 인데, 지금 쓰는 better-sqlite3 12.11.1 의 `engines` 는 20.x 와 22.x~26.x 만 적어서 21 은 거기에도 없어요. Pi 도 22 로 같이 올려요. | 아니요 |
 | 워크플로의 액션을 Node 24 판으로 올린다 | 10월 21일 Web CI 로그(잡 119438146340) 끝에 「Node.js 20 is deprecated. The following actions target Node.js 20 but are being forced to run on Node.js 24: actions/checkout@v4, actions/setup-node@v4」 경고가 떠요. 워크플로 9개의 `uses:` 16줄이 모두 node20 판이에요(checkout@v4 8곳, setup-python@v5 4곳, setup-node@v4 2곳, cache@v4 와 github-script@v7 한 곳씩). 각 `action.yml` 의 `runs.using` 을 보니 node24 인 가장 낮은 메이저는 checkout@v5, setup-node@v5, setup-python@v6, cache@v5, github-script@v8 이에요. | 낮아요. GitHub 가 이미 이 액션들을 Node 24 로 돌리고 있어요. `web/package.json` 에 `packageManager` 가 없어서 setup-node v5 의 저절로 캐시도 끼어들지 않아요. | 아니요 |
 | Drift 워크플로가 `npm ci` 대신 tsx 와 typescript 만 깐다 | 10월 21일 drift 실행(run 39664886425)에서 `npm ci`(`drift.yml:51`)가 98초, 검사 16개(`:60`)가 23초, 잡 전체가 2분 34초였어요. 검사 16개와 `doc-map.ts`, `human-lock.ts` 를 esbuild 로 따라가니 파일 97개가 끌어오는 npm 꾸러미는 `typescript` 하나뿐이에요. `tsx@4.23.15` 와 `typescript@5.9.3` 만 깔면 7초에 35 MB 예요(다 깔면 1.2 GB). 그 상태의 스크래치 클론에서 `tsx scripts/drift.ts` 가 14개 통과, 둘은 책상에서처럼 건너뛰었어요(태그 없음, gh 로그인 없음). | 나중에 검사가 다른 꾸러미를 부르면 그 PR 이 바로 빨개져요. 조용히 지나가지는 않아요. 두 꾸러미의 판은 잠금 파일에서 읽어 맞춰요. | 아니요 |
@@ -214,12 +214,12 @@ await browser.close();
 | 계약 벡터 README 가 적어 둔 펌웨어와 명세의 어긋남 여섯 곳을 이슈로 열고 하나씩 고친다 | `docs/audio-ws-vectors/README.md:11` 에 셋, `docs/mqtt-vectors/README.md:11` 에 둘, `docs/midi-vectors/README.md:13` 에 하나예요. `docs/contract-vectors.md:79` 는 이런 줄을 이슈로 보내라고 하는데 원래 레포 이슈에선 하나도 찾아지지 않아요. 가상 패널은 명세를 따르니 벡터는 CI 에서 초록이어도 실제 패널에선 이 여섯이 빨개요. | 넷은 기능 파일(`features/audio/core_audio_ws.h` 둘, `features/mqtt/core_mqtt.h`, `features/midi/core_midi.h`), 둘은 코어(`patternflow.ino:1316` 의 `applyLaneMotion`, `src/core_bus.h:66` 의 `ABSOLUTE_RELEASE_GRACE_MS`)라 `build.sh all` 이 들어요. 곳마다 펌웨어를 고칠지 명세를 고칠지 정해요. | 예 |
 | 코어와 CI 주석이 조합 다섯을 말한다 | `patternflow.ino:53`, `:76` 은 「Build all three editions」, `firmware-checks.yml:53`~`:54` 와 `check_boundaries.py:227` 은 넷이라고 하는데 `firmware/bundles/build.sh:66` 의 `COMPOSITIONS` 는 다섯이에요. `firmware-checks.yml:53`~`:54` 는 그 컴파일이 「stays local」이라고도 하는데, `firmware-build.yml:47` 이 다섯을 CI 에서 다 구워요. 머리 주석은 에이전트가 읽고 따르는 글이에요. `firmware-checks.yml:62` 의 `web/src/lib/presets/**` 는 pull_request 쪽에만 있고 push 쪽(`:69`~`:79`)엔 없어요. | 코어 파일이라 주석만 바꿔도 `build.sh all` 을 돌려요. 동작은 그대로예요. | 아니요 |
 | 코어의 `/api/status` 와 엔코더에 호스트 시험을 붙인다 | `firmware/patternflow/src/core_status_http.h:226` 의 `handleStatus` 는 `:575` 까지 350줄인데 `firmware/toolchain/tests/` 의 시험 13개와 `check_*.py` 어디서도 부르지 않아요. REST 벡터 53개는 가상 패널에서만 돌고, `console_demo.py:506` 은 그 응답을 손으로 옮겨 적어요. `core_encoders.h`(230줄)의 길게 누름과 디바운스도 시험하는 곳이 없고, `check_midi.py:21` 은 이 파일을 빈 파일로 바꿔 끼워요. | 일이 커요. 시험만 더해서 펌웨어 동작은 그대로예요. | 아니요 |
-| 메이저가 밀린 꾸러미의 차례를 정하고 `.github/dependabot.yml` 을 둔다 | vitest 3.2.7 → 5.0.5(시험 파일 75개, critical 2건이 여기서 지워져요), typescript 5.9.3 → 7.0.2(컴파일러 API 를 쓰는 스크립트 5개), dockview 7.0.4 → 8.6.1(가져오는 파일 5개), three 0.184.0 → 0.186.1(web/src 34개와 @react-three 13개), better-sqlite3 12.11.1 → 13.0.3, eslint 9.39.5 → 10.13.0 이에요. 10월 18일 뒤에 jsdom 26.1.0 → 30.1.3, feed 5.2.1 → 6.0.0 도 메이저가 났어요. next 는 `16.4.1` 로 못박혀 있고 16.4.2 가 나왔어요(가져오는 파일 117개). vitest 5, jsdom 30, better-sqlite3 13 은 Node 22 를 바라요. dependabot 설정이 없어서 첫 줄의 high 4건을 알려 준 것도 없었어요. | typescript 7 이 가장 커요. Node 22 줄을 먼저 해요. | 아니요 |
-| 린트 규칙 하나와 타입 규칙 둘을 켤지 정한다 | `jsx-a11y/interactive-supports-focus` 를 켜고 `eslint src` 를 돌리면 3곳이 나와요. `app/pattern-lab/panels/KnobsPanel.tsx:201`(`role="spinbutton"`)과 `LayersPanel.tsx:117`(`:153` 의 `role="button"`)은 `tabIndex` 가 없어 키보드로 닿지 않고, `components/sections/CasePicker.tsx:74` 는 `tablist` 에 `onKeyDown` 을 단 자리라 탭마다 이미 `tabIndex` 가 있어요(`:88`). 빌드한 Lab 을 1440×900 에서 Tab 으로 지나가니 레이어 줄은 한 번도 초점을 받지 않았고(axe 는 그 줄 안의 Hide 단추 때문에 nested-interactive, serious 로 잡아요), Knobs 의 범위 칸 8개도 다 건너뛰었어요. 범위 칸은 더블클릭으로만 열려서(`KnobsPanel.tsx:206`) 폰 흉내에선 두 번 탭해도 열리지 않았고, 숫자 끌기엔 `touch-action` 이 없어 손가락으로 80px 끌면 최댓값이 1 에서 3 까지만 갔어요(마우스는 9). AGENTS.md 가 ESLint 규칙을 그대로 두라고 해서 바퀴는 못 켜요. `noUncheckedIndexedAccess` 는 web 에서 오류 1,723개(파일 194개, components/guide 638, lib/lab 250)이고 tools/virtual-panel 에 88개가 더 있어서 바퀴 하나로는 커요. `noImplicitReturns` 는 두 곳이 막아요. `components/guide/Extras.tsx:524` 는 switch 끝에 `return null` 이 없고, `tools/virtual-panel/transports/mqtt.ts:256` 은 바퀴가 못 들어가는 곳이에요. #141 이 tsconfig 깃발 넷을 켠 길이 있으니 mqtt.ts 한 곳만 열리면 나머지는 바퀴가 해요. | 남은 곳을 먼저 고쳐야 켜는 날 lint 와 typecheck 가 빨개지지 않아요. 레이어와 노브 범위를 키보드와 손가락으로 다루게 고치는 일은 창작자가 열면 바퀴가 해요. | 아니요 |
+| 메이저가 밀린 꾸러미의 차례를 정하고 `.github/dependabot.yml` 을 둔다 | vitest 3.2.7 → 5.0.5(시험 파일 92개, critical 2건이 여기서 지워져요), typescript 5.9.3 → 7.0.2(컴파일러 API 를 쓰는 스크립트 5개), dockview 7.0.4 → 8.6.1(가져오는 파일 5개), three 0.184.0 → 0.186.1(web/src 34개와 @react-three 13개), better-sqlite3 12.11.1 → 13.0.3, eslint 9.39.5 → 10.13.0 이에요. 10월 18일 뒤에 jsdom 26.1.0 → 30.1.3, feed 5.2.1 → 6.0.0 도 메이저가 났어요. next 는 `16.4.1` 로 못박혀 있고 16.4.3 까지 나왔어요(가져오는 파일 118개). vitest 5, jsdom 30, better-sqlite3 13 은 Node 22 를 바라요. dependabot 설정이 없어서 첫 줄의 high 4건을 알려 준 것도 없었어요. | typescript 7 이 가장 커요. Node 22 줄을 먼저 해요. | 아니요 |
+| 린트 규칙 하나와 타입 규칙 둘을 켤지 정한다 | `jsx-a11y/interactive-supports-focus` 를 켜고 `eslint src` 를 돌리면 3곳이 나와요. `app/pattern-lab/panels/KnobsPanel.tsx:201`(`role="spinbutton"`)과 `LayersPanel.tsx:132`(`:168` 의 `role="button"`)은 `tabIndex` 가 없어 키보드로 닿지 않고, `components/sections/CasePicker.tsx:74` 는 `tablist` 에 `onKeyDown` 을 단 자리라 탭마다 이미 `tabIndex` 가 있어요(`:88`). 빌드한 Lab 을 1440×900 에서 Tab 으로 지나가니 레이어 줄은 한 번도 초점을 받지 않았고(axe 는 그 줄 안의 Hide 단추 때문에 nested-interactive, serious 로 잡아요), Knobs 의 범위 칸 8개도 다 건너뛰었어요. 범위 칸은 더블클릭으로만 열려서(`KnobsPanel.tsx:206`) 폰 흉내에선 두 번 탭해도 열리지 않았고, 숫자 끌기엔 `touch-action` 이 없어 손가락으로 80px 끌면 최댓값이 1 에서 3 까지만 갔어요(마우스는 9). AGENTS.md 가 ESLint 규칙을 그대로 두라고 해서 바퀴는 못 켜요. `noUncheckedIndexedAccess` 는 web 에서 오류 1,834개(파일 209개, components/guide 638, lib/lab 327)이고 tools/virtual-panel 에 88개가 더 있어서 바퀴 하나로는 커요. `noImplicitReturns` 는 두 곳이 막아요. `components/guide/Extras.tsx:524` 는 switch 끝에 `return null` 이 없고, `tools/virtual-panel/transports/mqtt.ts:256` 은 바퀴가 못 들어가는 곳이에요. #141 이 tsconfig 깃발 넷을 켠 길이 있으니 mqtt.ts 한 곳만 열리면 나머지는 바퀴가 해요. | 남은 곳을 먼저 고쳐야 켜는 날 lint 와 typecheck 가 빨개지지 않아요. 레이어와 노브 범위를 키보드와 손가락으로 다루게 고치는 일은 창작자가 열면 바퀴가 해요. | 아니요 |
 | `.claude/settings.json` 을 git 에 둘지 정하고, Pi 워커의 arduino-cli 흔적을 걷는다 | `.gitignore:74`~`:75` 는 「Claude Code local config」라며 `.claude/` 를 통째로 빼는데 `.claude/settings.json` 이 추적돼요. 정하면 `docs/REPOSITORY.md:37` 줄이 따라가요. 문서 쪽(지난 표 17)은 #123 이 고쳐서 `docs/SERVICES.md:36`, `:38` 이 워커가 `arduino-cli` 를 부르지 않는다고, `:97`~`:99` 가 `BUILD_FQBN` 을 8월 12일 뒤로 읽는 코드가 없다고 적어요. 남은 건 Pi 의 `patternflow-worker.service` PATH 에 든 arduino-cli 경로와 `/etc/patternflow/worker.env` 의 `BUILD_FQBN` 을 실제로 지우는 일이에요. | 낮아요. 워커를 한 번 다시 띄워요. | 아니요 |
-| Play 가이드의 플래셔 캡처와 alt 를 지금 판으로 다시 찍는다 | `web/src/components/guide/FlasherShots.tsx:6`, `:103`~`:104` 는 「Patternflow v3.10.4」 설치 창을 보여 주는데, 매니페스트는 v3.11.0 을 깔아요(`web/public/flash/manifest.json:3`). | 낮아요. 찍으려면 보드를 꽂아야 해요. | 예 |
-| 저널 날짜가 서버 시간대와 상관없이 글을 쓴 서울 날짜로 찍힌다 | `web/src/lib/journal.ts:131` 의 `formatJournalDate` 는 `Intl.DateTimeFormat` 에 `timeZone` 을 주지 않아서 그 프로세스의 시간대로 날짜를 찍어요. 저널 머리말은 `2026-05-14T01:30:00+09:00` 처럼 서울 시각이고, 74개 파일 가운데 8개(글 넷의 한국어판과 영어판)가 서울 0시에서 9시 사이라 UTC 에선 하루 앞당겨져요. UTC 로 도는 빌드에서 `/journal/headache` 가 「2026년 5월 13일」, `/journal/headache/en` 이 「May 13, 2026」, `/journal/i-hope-it-works-out` 이 「7월 17일」로 나왔어요. 이 파일은 10곳이 불러오지만 시험이 없어요. `web/src/app/roadmap/roadmap-data.ts:40` 의 `todaySeoul` 이 `timeZone: 'Asia/Seoul'` 로 같은 일을 해요. | 낮아요. `timeZone` 하나와 시험 하나예요. 저널 화면의 날짜가 바뀌어서 창작자 몫으로 뒀어요. | 아니요 |
-| Pi 에서 도는 사이트가 쪽마다 없는 Vercel 분석 스크립트 둘을 부르지 않는다 | 뿌리 레이아웃이 `<Analytics />`, `<SpeedInsights />`(`web/src/app/layout.tsx:178`, `:179`)를 늘 그려서 모든 쪽이 `/_vercel/insights/script.js` 와 `/_vercel/speed-insights/script.js` 를 불러요. 이 경로는 Vercel 만 내주고, `patternflow.work` 를 내는 Pi 의 `npm start`(`docs/SERVICES.md:12`, `:13`)와 같은 `next start` 에선 둘 다 404(`text/plain`)예요. 빌드한 사이트를 24쪽, 두 폭으로 48번 열었더니 모두 404 두 번과 「Refused to execute script … MIME type ('text/plain')」 오류를 남겼어요(콘솔 오류 200개). Pi 에선 이 둘이 아무것도 세지 못해요. | 분석을 어디서 셀지 정하는 일이에요. Vercel 에도 사이트를 올린다면 `VERCEL=1` 일 때만 그리면 거기 셈은 남아요. 저장소엔 아직 `process.env.VERCEL` 을 읽는 곳이 없어요. | 아니요 |
-| 흐린 글자와 LED 주황 글자의 색을 바탕과 4.5:1 이 되게 정한다 | 사이트의 `--pf-ink-faint` #A69F90 은 크림에서 2.30:1, `--pf-led` #E8552E 를 글자로 쓰면 크림 #F4EFE6 에서 3.17:1 이에요(`web/src/app/globals.css:131` 들). 커뮤니티의 `--pfc-ink-faint` #6B6558(`:153`)은 어두운 바탕 넷에서 3.18~3.44:1 이고, axe-core 4.10.3 이 `/community`, `/community/atlas`, 패턴 쪽, `/community/decks` 를 390px 와 1440px 로 볼 때 잡은 serious 51곳의 글자색이 모두 이것이었어요. `/terms` 의 링크 9곳과 `/features` 의 「every」 칩은 LED 주황이에요. 표의 브레드보드 줄은 이미 있는 `--pf-ink-muted` 로 그 쪽만 고치는 조각이에요. 토큰을 바꾸면 저널(`globals.css:1838`, `:1960`, `:2031`, `:2059`, `:2114`, `:2459`)과 `web/src/app/compliance/Compliance.module.css:165`, `:200`, editions 의 `.vLabel`, `.by`, `.tabLink` 까지 같이 바뀌어요. 커뮤니티는 `#847E70` 이면 네 바탕 모두 4.56:1 이상이고 `--pfc-ink-muted`(6.30:1)와도 구별돼요. | 팔레트를 정하는 일이에요. 글자에만 쓰는 어두운 LED 색을 따로 둘지도 같이 정해요. | 아니요 |
-| editions 쪽 링크의 hover 밑줄을 걷고, 설치 링크가 붙여 넣은 `http://` 주소도 받는다 | `/editions` 에서 hover 를 걸면 `brand`, 「Features」 탭, 「Install to my panel」 셋이 밑줄을 그어요. `web/src/app/editions/Editions.module.css` 의 `.brand`(`:38`), `.install`(`:174`), `.secondary`(`:185`), `.tabLink`(`:339`)가 클래스 하나라 `globals.css:165` 의 `a:hover` 에 져서예요. 표의 /features 쪽은 그 클래스를 빌려 쓰고 editions 쪽은 창작자 영역이라 표에 넣지 않았어요. `EditionCard.tsx:109` 는 기기 주소를 `trim() \|\| "patternflow.local"` 로만 다듬어서, 표의 기기 주소 줄이 `lib/community/deviceHost.ts` 에 다듬는 함수를 두면 이 카드도 그걸 부를 수 있어요. | 낮아요. 링크 모양과 설치 주소만 바뀌어요. | 아니요 |
-| 프리셋 문서 셋이 지금 단추 이름 「Copy the conversion prompt」를 말한다 | `web/src/lib/presets/README.md:12`, `firmware/patternflow/README.md:39`, `firmware/patternflow/presets/README.md:9` 가 헤더를 만드는 길로 「Copy C++ prompt」를 말하는데, 그 단추는 지금 To hardware 창의 「Copy the conversion prompt」예요(`web/src/app/pattern-lab/HardwareModal.tsx:240`). `web/ARCHITECTURE.md:120` 은 이미 그렇게 적어요. 세 파일이 다 presets 와 `firmware/` 라 바퀴가 못 들어가요. | 낮아요. 글만 바뀌어요. | 아니요 |
+| Play 가이드의 플래셔 캡처와 alt 를 지금 판으로 다시 찍는다 | `web/src/components/guide/FlasherShots.tsx:6`, `:103`~`:104`, `:168`~`:169` 는 「Patternflow v3.10.4」 설치 창을 보여 주는데, 매니페스트는 v3.11.0 을 깔아요(`web/public/flash/manifest.json:3`). | 낮아요. 찍으려면 보드를 꽂아야 해요. | 예 |
+| 저널 날짜가 서버 시간대와 상관없이 글을 쓴 서울 날짜로 찍힌다 | `web/src/lib/journal.ts:131` 의 `formatJournalDate` 는 `Intl.DateTimeFormat` 에 `timeZone` 을 주지 않아서 그 프로세스의 시간대로 날짜를 찍어요. 저널 머리말은 `2026-05-14T01:30:00+09:00` 처럼 서울 시각이고, 74개 파일 가운데 8개(글 넷의 한국어판과 영어판)가 서울 0시에서 9시 사이라 UTC 에선 하루 앞당겨져요. UTC 로 도는 빌드에서 `/journal/headache` 가 「2026년 5월 13일」, `/journal/headache/en` 이 「May 13, 2026」, `/journal/i-hope-it-works-out` 이 「7월 17일」로 나왔어요. 이 파일은 10곳이 불러오지만 시험이 없어요. `web/src/app/roadmap/roadmap-data.ts:39` 의 `todaySeoul` 이 `timeZone: 'Asia/Seoul'` 로 같은 일을 해요. | 낮아요. `timeZone` 하나와 시험 하나예요. 저널 화면의 날짜가 바뀌어서 창작자 몫으로 뒀어요. | 아니요 |
+| Pi 에서 도는 사이트가 쪽마다 없는 Vercel 분석 스크립트 둘을 부르지 않는다 | 뿌리 레이아웃이 `<Analytics />`, `<SpeedInsights />`(`web/src/app/layout.tsx:179`, `:180`)를 늘 그려서 모든 쪽이 `/_vercel/insights/script.js` 와 `/_vercel/speed-insights/script.js` 를 불러요. 이 경로는 Vercel 만 내주고, `patternflow.work` 를 내는 Pi 의 `npm start`(`docs/SERVICES.md:12`, `:13`)와 같은 `next start` 에선 둘 다 404(`text/plain`)예요. 빌드한 사이트를 24쪽, 두 폭으로 48번 열었더니 모두 404 두 번과 「Refused to execute script … MIME type ('text/plain')」 오류를 남겼어요(콘솔 오류 200개). Pi 에선 이 둘이 아무것도 세지 못해요. | 분석을 어디서 셀지 정하는 일이에요. Vercel 에도 사이트를 올린다면 `VERCEL=1` 일 때만 그리면 거기 셈은 남아요. 저장소엔 아직 `process.env.VERCEL` 을 읽는 곳이 없어요. | 아니요 |
+| 흐린 글자와 LED 주황 글자의 색을 바탕과 4.5:1 이 되게 정한다 | 사이트의 `--pf-ink-faint` #A69F90 은 크림에서 2.30:1, `--pf-led` #E8552E 를 글자로 쓰면 크림 #F4EFE6 에서 3.17:1 이에요(`web/src/app/globals.css:127`, `:131`). 커뮤니티의 `--pfc-ink-faint` #6B6558(`:153`)은 어두운 바탕 넷에서 3.18~3.44:1 이고, axe-core 4.10.3 이 `/community`, `/community/atlas`, 패턴 쪽, `/community/decks` 를 390px 와 1440px 로 볼 때 잡은 serious 51곳의 글자색이 모두 이것이었어요. `/terms` 의 링크 9곳과 `/features` 의 「every」 칩은 LED 주황이에요. 표의 브레드보드 줄은 이미 있는 `--pf-ink-muted` 로 그 쪽만 고치는 조각이에요. 토큰을 바꾸면 저널(`globals.css:1848`, `:1970`, `:2041`, `:2069`, `:2124`, `:2469`)과 `web/src/app/compliance/Compliance.module.css:165`, `:200`, editions 의 `.vLabel`, `.by`, `.tabLink` 까지 같이 바뀌어요. 커뮤니티는 `#847E70` 이면 네 바탕 모두 4.56:1 이상이고 `--pfc-ink-muted`(6.30:1)와도 구별돼요. | 팔레트를 정하는 일이에요. 글자에만 쓰는 어두운 LED 색을 따로 둘지도 같이 정해요. | 아니요 |
+| editions 쪽 링크의 hover 밑줄을 걷고, 설치 링크가 붙여 넣은 `http://` 주소도 받는다 | `/editions` 에서 hover 를 걸면 `brand`, 「Features」 탭, 「Install to my panel」 셋이 밑줄을 그어요. `web/src/app/editions/Editions.module.css` 의 `.brand`(`:38`), `.install`(`:174`), `.secondary`(`:185`), `.tabLink`(`:339`)가 클래스 하나라 `globals.css:200` 의 `a:hover` 에 져서예요. 표의 /features 쪽은 그 클래스를 빌려 쓰고 editions 쪽은 창작자 영역이라 표에 넣지 않았어요. `EditionCard.tsx:109` 는 기기 주소를 `trim() \|\| "patternflow.local"` 로만 다듬어요. #150 이 `lib/community/deviceHost.ts:36` 에 `deviceHostName()` 을 두었으니 이 카드도 그걸 부르면 돼요. | 낮아요. 링크 모양과 설치 주소만 바뀌어요. | 아니요 |
+| 프리셋 문서 셋이 지금 단추 이름 「Copy the conversion prompt」를 말한다 | `web/src/lib/presets/README.md:12`, `firmware/patternflow/README.md:39`, `firmware/patternflow/presets/README.md:9` 가 헤더를 만드는 길로 「Copy C++ prompt」를 말하는데, 그 단추는 지금 To hardware 창의 「Copy the conversion prompt」예요(`web/src/app/pattern-lab/HardwareModal.tsx:263`). `web/ARCHITECTURE.md:120` 은 이미 그렇게 적어요. `firmware/CUSTOM_PATTERNS.md:54`, `:154`, `:184`, `:223` 도 같은 옛 이름이에요. `web/` 안의 `components/community/AddHeaderModal.tsx` 는 후보 표에 넣었어요. 세 파일이 다 presets 와 `firmware/` 라 바퀴가 못 들어가요. | 낮아요. 글만 바뀌어요. | 아니요 |