Repository navigation
v0.36.0
이번 판의 축은 「그림이 화면을 그대로 담는가」와 「번호가 무엇을 가리키는가」다. 열린 패널이 그림에서 통째로 빠지던 것을 고쳤고, 번호가 가리키는 영역에 상자를 그린다. 그리고 순서가 뜻인 목록을 글자 ① 이 아니라 진짜 번호 목록으로 쓴다.
열린 패널이 그림에 든다 (#116)
목록 줄을 눌러 오른쪽 패널(position:fixed)을 연 상태로 뽑으면 그림에서 패널이 통째로 빠졌다. 패널 안 항목을 가리키는 번호만 빈 자리에 떴다. 상위기획 스토리보드는 「줄을 누르면 이렇게 열린다」가 요점인 화면이 많아 그 상태가 곧 대표 그림인데, 그 그림이 안 나왔다.
원인은 둘이었다.
- 등장 애니메이션 — 그림용 복사본은 새 요소라 CSS 애니메이션이 처음부터 다시 돈다. 그림은 한 번에 찍히므로 그 첫 프레임(투명·밀려난 자리)이 나왔다. 화면에서는 이미 끝난 애니메이션이라 뷰어에는 멀쩡히 보였다. wrap 도 같다 — 시트를 옮기는 순간 다시 돈다
- fixed 의 기준 — 복사본에서는 기준이 조립 상자 밖의 창이, 그림에서는 머리말까지 든 그림 틀 전체가 된다. 애니메이션이 없는 패널도 머리말을 덮고 번호와 머리말 높이만큼 어긋났다. 팝오버로 연 패널은 복사본에서 「닫힌」 것이 되어 빠졌다
옮기거나 뜨기 전에 화면의 지금 값을 읽어 복사본에 박고 애니메이션을 끈다. 끝난 애니메이션(채움 없음)도 끈다 — 복사본에서는 다시 도니까. frame·overlay 의 fixed 는 화면에 보이던 자리(마커와 같은 좌표)에 absolute 로 못 박는다. wrap 은 액자가 fixed 를 가두므로 자리는 그대로 맞다.
설명대로 만든 픽스처로는 재현되지 않았다. 오히려 다른 결함(머리말을 덮음)만 보였다. 제기자의 실물을 읽고서야 등장 애니메이션이 나왔다 — 추측만으로 갔으면 엉뚱한 것을 고치고 닫았을 것이다. 규칙으로 남겼다(AGENTS.md 「재현이 안 되면 — 제기자의 실물을 본다」).
번호가 가리키는 영역을 상자로 (#117)
그림에 번호만 찍히고 그 번호가 어디까지인지는 없었다 — 「숫자만 가지고는 어디가 박스인지 잘 모르겟어」(PM 2026-09-18). 뷰어는 가리키면 대상을 강조하지만 그림에는 가리킬 손이 없다.
- 내보내기 대화상자 「화면 위 번호」 의 하위에 「영역 상자」 · 기본 켬. 번호 + 상자가 화면설계서의 관례이고, 깨끗한 그림이 필요하면 그때 끈다. 번호를 끄면 같이 흐려지고, 다시 켜면 상자 선택은 끄기 전 그대로다
- 번호 색 2px 테두리를 대상 안쪽에 그린다. 모서리는 대상의 둥글기를 따른다. 번호 밑에 깔린다 — 뷰어의 강조와 같은 선이다
- 「주요 항목만」과 함께면 주요 항목의 대상에만. 번호는 다시 매기지 않는다 (#106 원칙 그대로)
- 호스트에서 직접:
window.ScreenSpec.exportImage({ areas: true })—markers가 false 면 무시한다
번호 목록 — 순서가 뜻일 때 (#118)
줄은 불릿 한 종류뿐이라 「하는 일 두 가지」 · 「세 단계」 를 ① · 1) 글자로 흉내 냈다. 그러면 컨플루언스·노션에 붙였을 때 진짜 번호 목록이 아니다 — 목록으로 다룰 수가 없다.
{ t: "역할을 만든다", kind: "ol", c: [ { t: "이름은 20자" } ] } // 1.
{ t: "사람에게 준다", kind: "ol" } // 2.- 같은 층에서 이어지는
ol이 한 목록이다. 다른 종류가 끼면 번호는 다시 1. 하위 줄은 그 번호 항목 안에 든다. 기획 보기에서 가려진 개발 줄은 세지도 끊지도 않는다 — 보이는 대로 센다 - 편집기는 노션을 따른다: 슬래시 「번호 목록」 · 빈 줄에서
1.+ 스페이스 · Enter 는 다음 번호를 잇고, 빈 번호 줄에서 Enter 는 목록에서 나온다(없으면 번호 목록에 갇힌다). 「번호」 가 아니라 「번호 목록」 인 이유는 이 도구에서 번호가 화면 마커이기 때문이다 - 네 곳이 같은 규칙으로 낸다: 뷰어 · 그림 속 기능 설명 표 · 설명 복사(
text/html은<ol>,text/plain은1.) · 컨플루언스 발행기
이슈의 제안은
ol: true였다.kind로 둔 이유 — 불릿·화살표·표·순서도가 이미kind로 갈린다. 축을 하나 더 만들면 「줄의 종류」 를 두 군데서 읽게 된다.
wrap 에서 뽑고 나도 화면이 그대로 (#119)
wrap 은 복제하지 않고 살아 있는 시트를 옮겨 갔다 온다(앱의 상태를 잃지 않으려고). 그런데 되돌리는 쪽이 둘을 놓쳤다. 뽑는 동안 늘린 시트 높이를 원래 값이 아니라 빈 값으로 돌려 기기 프레임이 풀렸고(실측 736px → 1645px), 「화면 위 번호」 를 끄고 뽑으면 살아 있는 번호·지시선 층을 지워 화면에서 번호가 사라졌다(새로고침 전까지). 내용이 전부 absolute 인 화면은 높이가 0 이 되어 두 번째 내보내기부터 백지였다.
높이·넘침은 바꾸기 전 값을 적어 두었다가 그대로 돌리고, 번호 층은 지우지 않고 숨겼다 되돌린다.
#117 을 만들며 같은 화면에서 연달아 뽑는 검사가 드러냈다. 그리고 기존 검사 하나는 이 결함 상태(높이가 빈 값)를 「원상 복귀」 로 적어 두고 있었다 — 고치는 순간 그 검사가 빨개졌다. 「원래대로」 는 짐작한 기본값이 아니라 적어 둔 전 값과 견준다. 두 교훈 다 AGENTS.md 에 있다.