Skip to content

v0.36.0

Choose a tag to compare

@jasonjung-creator jasonjung-creator released this 21 Sep 00:30
· 15 commits to main since this release

이번 판의 축은 「그림이 화면을 그대로 담는가」와 「번호가 무엇을 가리키는가」다. 열린 패널이 그림에서 통째로 빠지던 것을 고쳤고, 번호가 가리키는 영역에 상자를 그린다. 그리고 순서가 뜻인 목록을 글자 ① 이 아니라 진짜 번호 목록으로 쓴다.

열린 패널이 그림에 든다 (#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 에 있다.