Skip to content

Releases

v0.37.2

Choose a tag to compare

@charmisuk charmisuk released this 28 Sep 10:04

그림 속 번호·영역 상자가 아래로 갈수록 대상과 벌어지던 것을 고쳤다. 선택지는 하나도 늘지 않았다 — 그림이 화면과 같아졌을 뿐이다.

뿌리·본문에 건 규칙이 그림에 산다 (#123)

실사용(2026-09-28, 액자 모드 · Tailwind): 권한 화면을 뽑았더니 「역할 추가」 줄의 영역 상자가 줄보다 7px 아래에 그려져 카드 밖으로 삐져나왔다. 제목 글자 하나를 지날 때마다 4px 씩 벌어졌다.

그림 틀(SVG) 안에는 문서의 맨 바깥 — html 도 body 도 — 이 없다. 그래서 앱이 거기에 건 규칙이 걸릴 곳이 없었다. Tailwind 는 html 에 줄 높이 1.5 를 걸고, 줄 높이를 따로 안 준 글자는 그것을 물려받는다. 그림에서는 기본값(약 1.2)으로 짧게 그려졌고, 번호·상자는 화면 좌표 그대로 찍혀 아래로 갈수록 벌어졌다.

재 보니 액자 모드만의 일이 아니었다.

앱이 규칙을 건 자리 전 후
html 의 줄 높이 (제목 넷 아래) 세 모드 모두 약 17px 어긋남 맞음
뿌리 글자 크기 62.5% + rem 세 모드 모두 40~70px 어긋남 맞음
body 의 줄 높이·글자 크기 wrap 약 63px 어긋남 — 본문 글꼴도 빠져 명조로 그려졌다 맞음

고침 — 속성만 가진 빈 껍데기(html·body)를 그림에 같이 두른다. 앱의 규칙이 화면에서처럼 제 손으로 걸린다. 값을 베껴 쓰지 않는다.

  • 껍데기는 물려주기만 한다. 여백·크기·넘침·배경 같은 상자 모양은 끈다 — 본문에 준 여백·배경이 그림 둘레로 새지 않는다
  • 뷰어가 붙이는 표시(ss-*)는 옮기지 않는다 — 옮기면 「프로토타입」 모드에서 뽑은 그림의 번호가 숨는다
  • 뿌리 글자 크기는 픽셀로 박고, 그림 틀의 뿌리에도 준다 — rem 이 그것을 본다

검사는 세 모드 × 뿌리·본문 두 화면에서 그림 속 대상이 영역 상자 선 바로 안쪽에 서는지 픽셀로 잰다. 고친 장치를 하나씩 끄면 저마다 빨개지는지도 확인했다(돌연변이 7개).

한계 — 이름에 @·: 가 든 속성(Alpine.js 의 @click·:class)이 화면에 있으면 그림이 아예 안 나온다. 이번 판 전부터 있던 것이고 이슈로 따로 두었다. 이번 판은 껍데기가 그것을 더 번지게 하지 않게만 막았다.

v0.37.1

Choose a tag to compare

@jasonjung-creator jasonjung-creator released this 22 Sep 03:29

라이브러리는 v0.37.0 과 같다. 한 글자도 안 바뀌었다 — 바뀐 것은 판을 내보내는 «게이트» 다. 쓰는 쪽에서 달라지는 것은 없다.

릴리스 버튼이 CI 보다 느슨했다 (#122)

release.yml 은 제 판 검사(lint·e2e·smoke)를 들고 있었고, CI 에 뒤늦게 붙은 --grid 와 돌연변이 3샤드(#112)를 따라오지 않았다. 터미널이 없을 때 쓰는 버튼 경로로 내면 CI 라면 막았을 결함이 나갈 수 있는 상태로 판을 여럿 지났다. #91(grid 가 다섯 판 동안 빨간 채)·2026-09-17(죽은 돌연변이가 v0.32 로 나감)과 같은 형태다 — 검사가 «한 곳» 에 안 살면 반드시 어긋난다.

  • release 는 검사를 안 들고, 이 커밋의 ci 가 초록인지만 본다. 아직 돌고 있으면 최대 12분 기다리고, 빨간 채면 실행 주소와 함께 멈춘다. 같은 결과를 두 번 돌리지 않는다
  • 태그 푸시에서는 tag-gate 만 돈다. main 푸시와 태그 푸시가 같은 커밋을 같은 분에 두 번 돌던 것이 30일 26건이었다(v0.14~v0.37 전부). 그래서 태그 게이트를 제 잡으로 뗐다
  • 같은 가지의 앞 실행은 끊는다. 이력이 한 줄이라 새 커밋의 판정이 옛 커밋을 덮는다. 태그는 ref 가 달라 릴리스 때 서로 안 끊는다

워크플로는 로컬에서 못 돌린다. 그래서 초록 확인 로직만 떼어 실제 커밋 셋으로 돌렸다 — 초록(exit 0) · 빨강(exit 1) · 실행 없음(기다렸다 exit 1). 그 과정에서 둘을 고쳤다: 빈 배열에서도 한 줄이 나와 「실행 없음」이 「진행 중」으로 잡히던 것, 그리고 맥 bash 3.2 가 변수 바로 뒤의 겹화살괄호를 깨뜨려 실패 메시지가 안 읽히던 것. 실패 메시지는 읽혀야 값이 있다.

v0.37.0

Choose a tag to compare

@jasonjung-creator jasonjung-creator released this 21 Sep 09:11

앱에서 만들어 둔 상태가 그림에 그대로 담긴다. 켜 둔 체크, 고른 항목, 열린 패널, 안쪽 스크롤 자리, 캔버스에 그린 것, 지금 걸려 있는 :hover·:focus 까지. 선택지는 하나도 늘지 않았다 — 「보이는 대로」 는 앱을 몰라도 되는 한 문장이라 그 자체가 기본값이다.

상태가 사라지던 두 자리 (#121)

실사용(2026-09-21): 목록에서 줄을 눌러 패널을 열고 항목을 고른 뒤 뽑으면, 그림은 초기 화면이었다. 상위기획은 「줄을 누르면 이렇게 열린다」 · 「30건을 고르면 이렇게 된다」 가 요점인 화면이 많아, 그 장면이 안 담기면 그림이 할 말을 잃는다.

제기자는 「되돌려 찍기를 끄는 선택지」를 제안했지만 되돌리는 기능은 애초에 없었다. 재 보니 원인이 둘이었다.

  • 모드를 바꿀 때 앱이 다시 시작됐다. 모드마다 «다른 상자» 를 두고 프레임을 옮겼는데, 액자(iframe)는 DOM 에서 옮기는 순간 브라우저가 다시 로드한다. 옛 코드는 「보던 경로」 만 되돌려 줬다 — 경로만 돌아오고 화면의 상태는 사라졌다. wrap 도 옮기면 앱 안의 iframe 이 다시 로드되고 안쪽 스크롤이 풀렸다
  • 그림은 «마크업» 만 본다. 체크·고른 항목·적은 값은 메모리(프로퍼티)에만 있다. 스크롤 자리·캔버스 그림·지금 걸린 상태도 마크업에 없다
보이는 것 전 후
켜 둔 체크 (「30건 고른 화면」의 바닥) 빈 칸 켜져 있다
고른 드롭다운 항목 첫 항목 고른 항목
안쪽 스크롤 자리 맨 위 그 자리
캔버스에 그린 것 백지 그대로
마우스 올린 단추 (:hover) 민낯 올린 모습
프로토타입에서 만든 상태 → 화면정의서 통째로 초기화 그대로 넘어온다

고침

  • 껍데기를 하나로. 프레임은 늘 같은 상자에 살고, 모드는 머리말·설명 패널을 접고 펼 뿐이다. 옮기지 않으니 다시 로드될 일이 없다
  • 마크업에 없던 다섯 가지를 마크업으로. 체크·값·고른 항목은 속성으로 · 안쪽 스크롤은 자식을 그만큼 옮겨 그리고 · 캔버스는 굽기 직전 사본에서만 같은 그림의 div 로 바꿔 끼운다(그림 틀은 캔버스를 아예 안 그린다 — 배경을 깔아도 0px 였다) · 걸린 상태는 표식을 달고 앱의 규칙을 「표식으로도 걸리게」 한 벌 더 적는다(:hover → [data-ss-hover]). 값을 베껴 쓰지 않으므로 앱마다 깨질 데가 없다
  • 그림 때문에 화면이 바뀌지 않는다. 붙인 표식·속성은 뽑고 나면 전부 뗀다. wrap 은 옮겼다 온 뒤 안쪽 스크롤 자리와 커서(포커스) 도 되돌린다 — 적던 칸에서 안 튕긴다

한계 — 마우스를 올린 상태는 사람 손으로는 못 뽑는다. 「내보내기」 를 누르는 순간 마우스가 앱에서 떠나기 때문이다. window.ScreenSpec.exportImage() 를 자동화(Playwright)로 부르면 그 장면 그대로 담긴다. 다른 출처 iframe·동영상 프레임은 DOM 복제로는 담기지 않는다 — 그건 진짜 스크린샷 도구의 몫이다.

검사를 줄이지 않고 검사 시간을 줄였다 (#120)

「이렇게 타이트하게 검사하는 게 방법론상 맞나」 라는 물음에 재서 답했다. 시간의 대부분은 검사 자체가 아니라 무관한 검사가 따라 도는 것 · 신호 대신 시계를 보는 대기 · 브라우저 설치에 갔다.

전 후
CI 벽시계 4분 42초 3분 31초
돌연변이 한 건 13.3초 2.9초
절을 골라 돌릴 때의 고정 비용 10.6초 0.8초
  • 절 «밖» 에서 돌던 검사 넷을 절로 묶었다 — 돌연변이 한 건마다 10.5초를 내고 있었다
  • 그림 굽기를 «하던 일»(ssJob)로 세서, 굽기 뒤 고정 2.2초를 신호로 바꿨다. busy() 의 뜻이 넓어졌다: 「미뤄 둔 일」 → 「하고 있는 일」(굽는 중 포함)
  • goto 뒤 고정 1초 22자리를 «떴는가» 로 바꿨다 — 느린 기계에서는 고정 대기보다 튼튼하다
  • CI 에서 브라우저 내려받기를 캐시하고 smoke 를 별도 잡으로 뗐다

검사는 하나도 빼지 않았다(절 63 · 검사 807 · 돌연변이 149). 그리고 돌연변이 수를 문서와 대조하는 lint 를 넣었다 — 검사와 그것을 지키는 돌연변이를 «같이» 지우면 지금까지는 아무 신호가 없었다.

재 보고 계획 하나(내보내기 절 나누기)는 접었다 — 앞의 개선으로 돌연변이 샤드가 임계 경로에서 내려와 값어치가 사라졌다. 「속도를 위해 검사를 빼는 일은 이슈로 연다」 도 규칙에 넣었다.

v0.36.0

Choose a tag to compare

@jasonjung-creator jasonjung-creator released this 21 Sep 00:30

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

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

v0.35.0

Choose a tag to compare

@jasonjung-creator jasonjung-creator released this 18 Sep 04:25

이번 판은 하나다. 액자 모드에서 선 글자가 있는 순서도가 코드로만 남던 것(#115)을 고쳤다.

액자 모드에서도 선 글자 순서도가 그려진다 (#115)

mode: "frame" 에서 -->|예| 처럼 선에 글자가 있는 순서도가 그림이 되지 않고 코드 블록만 남았다. 선 글자가 없는 순서도는 그려졌다.

  • 원인 — mermaid 는 글자 크기를 재려고 임시 칸을 body 끝에 붙인다. 액자 모드는 바깥 문서의 앱 DOM 을 전부 숨기는 규칙(#103)이 있어 그 칸까지 숨었고, 숨은 칸에서 잰 선 글자 폭은 0 이라 「Could not find a suitable point」 로 실패했다. 제기자의 추정 그대로
  • 고침 — mermaid.render 에 우리 칸을 넘긴다. 숨김 규칙에서 빠지는 표식(data-ss-ignore)을 달아 화면 밖에 두고, 그림 하나마다 하나씩 붙였다가 끝나면 뗀다. 칸 하나를 같이 쓰면 안 된다 — mermaid 가 그리기 시작에 받은 칸을 비우므로 동시에 도는 다른 그림의 칸이 지워진다
  • 실측 — mermaid 11.17.2 로 액자 모드 3건 모두 그려지고, 선 글자 있는 그림의 svg 는 wrap·frame 이 바이트 단위로 같다. 고치기 전과의 차이는 칸을 받으면 mermaid 가 붙이는 xmlns:xlink 선언뿐 — 재는 칸을 바꿔도 결과가 달라지지 않는다
  • QA 하네스에 ?mode=frame — 같은 18 화면을 액자 모드로 본다. 지금까지는 wrap 만 눌러볼 수 있었다

제기자가 함께 본 btoa(Latin1) 오류는 11.17.2 에서 재현되지 않았다. 같은 숨김의 다른 증상으로 본다 — 이 판 뒤에도 보이면 브라우저가 물고 있는 옛 mermaid 사본(mermaid@11 은 범위 태그라 캐시가 옛 판일 수 있다)을 비우고 다시 본다.

검사: e2e 새 절이 «받은 칸(없으면 body)에 임시 칸을 붙여 getBBox 로 잰다» 는 가짜 mermaid 로 잰다 — 숨은 칸이면 폭 0 이라 고치기 전 판에서 FAIL 이 난다. 돌연변이 mm-no-stage·mm-stage-hidden 둘 다 잡힌다.

v0.34.0

Choose a tag to compare

@jasonjung-creator jasonjung-creator released this 17 Sep 06:28

이번 판의 두 축은 「다시 쓰지 않는다」와 「사람이 기억하지 않는다」다. 그림 옆 설명을 사람이 다시 옮겨 적던 일을 없앴고, 배포 전에 사람이 기억해서 돌리던 검사를 CI 로 옮겼다.

설명을 글로 — 그림과 같은 번호로 (#108)

그림은 문서에 바로 붙는데, 그 옆 칸의 설명은 사람이 정의서를 보고 다시 옮겨 적었다. 두 벌이 되고 옮기며 문장이 달라진다 — 「그걸 또 가공하면 screenspec 을 검토할 이유가 없다」(PM 실측). 정의서를 검토하는 이유가 그 글이 그대로 문서가 되기 때문이라면, 옮기는 단계에 사람이 끼면 안 된다.

  • 내보내기 대화상자에 「설명 복사」. 그림과 같은 설정(화면 위 번호 · 주요 항목만 · 개발 정의 포함 · 머리말)으로, 글자는 그대로 두고 형식만 바꾼다
  • 클립보드에 두 벌 — text/html(컨플루언스 새 편집기·노션이 목록·표로 받는다) + text/plain(마크다운). 어디에 붙여도 선다
  • 번호는 그림 마커 그대로. 「주요 항목만」이어도 다시 매기지 않는다 — 상위기획의 4번과 상세기획의 4번이 같은 것을 가리켜야 번호로 대조할 수 있다(#106 과 같은 원칙). 개요·섹션은 제목만
  • 줄·하위 줄 → 목록·안쪽 목록 · 이유 → ↳ · 표 → 표 · 순서도 → 코드 블록 · 출처 → 각주 + 링크 · 개발 레이어 → 켰을 때만 「DEV」
  • 깊이는 두 단 — 요약(제목 + 이유) / 전체. 「제목만」이 없는 이유: 상위기획 독자는 「왜 그렇게 정했나」를 보는 사람이라 이유가 빠지면 문서가 안 된다

처음엔 「항목만 걸러도 충분하다, 깊이 선택은 과하다」고 판단했다. #106 의 정정 댓글(마커 12개 중 9개가 주요)이 그 근거를 무너뜨렸다 — 12 → 9 는 줄어든 게 아니다. 판단을 뒤집었다.

호스트에서 직접: window.ScreenSpec.exportText({ markers, major, head, layer, depth }) → { html, text }.

구성 스타일시트도 그림에 (#113)

CSS 를 걷는 자리가 document.styleSheets 만 훑었다. 구성 스타일시트(adoptedStyleSheets)로만 스타일을 주는 앱은 그 규칙이 그림에서 통째로 빠졌다 — div 도 button 도 가리지 않고. #109 를 조사하다 찾았다(그 원인은 아니었다). 이제 둘을 합쳐 걷는다.

게이트를 사람 손에서 뗀다 (#112)

배포 전 게이트 셋(전체 e2e · 전체 돌연변이 · --grid)이 사람이 기억해서 손으로 돌리는 자리에 있었다. 그래서 두 번 놓쳤다 — #91(grid 가 다섯 판 동안 빨간 채), 그리고 v0.33 직전(#107 이 죽인 돌연변이 둘이 v0.32 로 나갔다). 사람이 기억하는 규칙은 결국 안 지켜진다.

실측: CI 6분 4초 중 e2e 가 4분 59초(82%)였고, 그 e2e 안은 waitForTimeout 519회 · 224초 — 약 75%가 「그냥 기다리는」 시간이었다. 돌연변이는 e2e 를 N번 돌리므로 그 낭비가 곱해졌다.

  • 고정 대기 465회 → settle(ms). 「라이브러리가 미룬 일이 0 이고 DOM 이 80ms 조용하면 그때, 아니면 원래 ms」 — 느려질 수는 없고 빨라질 수만 있다. 제품의 시간(자동저장 1.2초·파일감시 3초)을 기다리는 54회는 그대로 둔다 — 그건 기다려야 할 시간이지 가라앉기가 아니다
  • 라이브러리가 미룬 일을 센다 — 마커 자리잡기·화면 감지·누락 판정·배치를 ssDefer/ssFrame/ssClear 로 걸고 window.ScreenSpec.busy() 로 내준다
  • 돌연변이가 CI 로 갔다 — --shard=k/3 으로 세 대에 나눠 e2e 잡과 나란히. 벽시계는 max(e2e, 한 샤드)
  • --grid 를 늘 켠다 — 26초짜리를 선택 실행으로 둘 이유가 없었다
  • 배포 스크립트의 「셋을 돌렸나?」 프롬프트가 「마지막 CI 가 초록인가?」로 바뀌었다

그리고 settle 의 통계가 남은 낭비를 정확히 가리켰다. 「끝난 이유」를 세어 보니 대기 96회가 상한까지 갔고, 흔든 표적은 SPAN.ss-wpx(68회)와 손잡이 style(28회)이었다 — 배치가 매 프레임 같은 값을 다시 쓰고 있었다. 크기 표시는 innerHTML 로 매번 다시 파싱했다. style·innerHTML 은 값이 같아도 「변경」으로 기록돼 DOM 이 영영 조용해지지 않는다(마커 추적이 안 멎던 v0.30 사고와 같은 계열).

  • 바뀔 때만 쓴다 — 지시선·배치·손잡이·크기 표시 전부. 시험이 빨라지는 것보다 제품이 매 프레임 헛일을 안 하게 된 것이 크다
  • 실측: 배율·무대·프리셋·fold 네 섹션에서 dom 대기가 0회가 됐다

로컬 전체 e2e(--grid 포함): 5분 29초 → 3분 12초. 같은 기계에서 잰 값이다.

아직 남은 것도 통계가 말해 준다. 전체로 보면 dom 대기 143회가 그대로인데, ss-wpx 가 사라지자 그 뒤에 가려져 있던 **마커의 style 쓰기(95회)**가 드러났다. 마커도 매 프레임 자리를 다시 쓴다 — v0.30 에서 「움직였나」 비교는 고쳤지만 쓰기 자체는 남았다. 같은 병의 마지막 조각이라 다음 판으로 미뤘다.

lint 25번이 곧바로 값을 했다. 이 변경이 돌연변이 넷의 겨냥점을 죽였는데, 15분짜리 전체 판이 아니라 커밋 앞 0초 검사가 잡아 줬다. 넣은 지 한 판 만에 그 검사가 존재 이유를 증명했다.

v0.33.0

Choose a tag to compare

@jasonjung-creator jasonjung-creator released this 17 Sep 05:10

이번 판은 「그림이 거짓말을 하고 있었다」가 이끌었다. 뽑은 그림 속 앱이 실제 화면과 달랐고, 번호에는 고른 색이 안 묻었다.

조립 상자가 앱의 스타일을 덮고 있었다 (#109)

그림을 구울 때 쓰는 조립 상자에 ss-ui 를 붙여 둔 탓에, 우리 UI 규칙이 앱 사본까지 닿았다.

  • .ss-ui :where(button) 은 레이어 없는 규칙이라, 앱(Tailwind v4 등)이 @layer 안에서 정한 배경·테두리·글자색을 선택자 세기와 무관하게 이긴다. 그래서 그림에서만 앱 버튼이 민낯이 되고, 같은 클래스의 div 는 멀쩡했다
  • 같은 뿌리의 둘째 증상을 신고 전에 찾았다 — .ss-ui * 의 글꼴 강제가 버튼만이 아니라 앱 사본 전체의 글꼴을 바꾸고 있었다. 모든 그림이 앱 글꼴 대신 우리 글꼴로 나오고 있었다는 뜻이다

고침은 구조다. 상자에서 ss-ui 를 떼고, 우리 조각(머리말·표·출처)에만 붙인다. 앱 사본은 이제 우리 규칙의 범위 밖에 산다.

실측(같은 화면·같은 설정): 앱 버튼 배경 rgba(0,0,0,0) → rgb(204,0,0) · 테두리 0px → 2px · 글꼴 우리 것 → 앱 것.

원인에 이르기까지 양쪽이 한 번씩 헛짚었다. 제기자의 최소 재현은 글자 위를 색으로 쟀고(버튼은 글자가 가운데라 흰 글자를 쟀다), 우리는 마커 여백 때문에 좌표를 잘못 읽었다. 네 가설(폼 컨트롤 미출력·레이어 순서·우리 버튼 초기화·@property)을 측정으로 반증한 뒤에야 진짜 자리가 나왔다. 재현되지 않는 동안 제안된 고침(버튼을 div 로 치환)을 넣지 않은 것이 이번 판에서 제일 잘한 선택이다.

그림 속 번호에 색이 안 묻었다 (#110)

「번호 색」을 골라도 그림 속 번호는 늘 흰 원 · 검은 숫자였다. 색은 조립 상자까지 잘 전달되고 있었는데 읽는 쪽이 없었다 — 화면에서 --ss-accent 는 「지금 고른 마커」에만 쓰이고, 그림에는 「고른 것」이라는 상태가 없다.

규칙 한 줄을 더했다. 색을 안 고르면 문서 색을 그대로 물려받으므로, 「고르면 그 색 · 안 고르면 문서 색」이 같은 한 줄로 둘 다 성립한다.

폭 프리셋을 선언으로 · 「페이지만 보기」 (#111)

  • devices 에 키를 더하면 툴바에 버튼이 생긴다. label 이 버튼 글자가 되고, 버튼은 폭이 좁은 것부터 선다(선언 순서를 그대로 쓰면 나중에 더한 태블릿이 PC 뒤에 섰다)
  • 기본은 둘 그대로다. 태블릿 폭은 제품마다 다르다(768 · 744 · 834) — 우리가 하나를 박으면 그것이 「기준」인 척한다. 기준은 그 제품의 CSS 브레이크포인트지 라이브러리가 정할 것이 아니다. 제품이 자기 이름·값으로 선언하면 리뷰와 코드가 같은 말을 한다
  • 「페이지만 보기」 — 지금 보고 있는 그 주소에 ?screenspec=0 을 붙여 새 탭으로 연다. 이 스위치는 소스를 읽어야 아는 것이었고, 액자 안 주소는 손으로 옮겨 적어야 했다. 액자 모드는 액자 «안» 의 현재 주소를 쓰고, 원래 쿼리·해시는 그대로 두고 screenspec 만 갈아끼운다

죽은 돌연변이를 lint 가 잡는다

배포 게이트에서 돌연변이 둘이 **「심을 자리 없음」**으로 나왔다. #107 에서 isBrief → noMark 로 두 줄을 고치면서 #82 돌연변이 둘의 겨냥점이 조용히 죽었고, 그 판에서는 새 돌연변이 넷만 돌려 넘어갔다.

죽은 돌연변이는 「잡음 0」이 아니라 「검사를 안 한 것」이다. 그런데 그 사실은 전체 판(15분)을 돌리기 전에는 안 보인다.

  • 죽은 둘을 되살렸다
  • lint 가 이제 모든 돌연변이의 심을 자리를 전수로 본다. 브라우저가 필요 없어 0초에 돌고, 커밋마다 돈다 — 「초록불을 본 적 없는 검사는 검사가 아니다」의 다음 걸음이다

v0.32.0

Choose a tag to compare

@jasonjung-creator jasonjung-creator released this 16 Sep 07:23

같은 정의서를 두 독자가 읽는다. 상위기획은 개발·디자인이 일감을 추산하고 기획이 「왜 그렇게 정했나」를 남기는 문서라 갈림길이었던 항목만 필요하고, 상세기획은 개발이 그대로 구현하고 QA 가 그대로 시험하는 문서라 전부 필요하다.
그런데 내보내기는 「화면 위 번호」 켬/끔 하나라 전부 아니면 전무였다. PM 실측(입주사 어드민 방문자 현황): 마커 32개 중 상위기획이 설명하는 것은 9개. 그림과 본문이 1:1 이 아니어서 독자가 「나머지 23개는 어디 설명이 있나」를 묻게 됐다 (#106).

항목에 「주요」 를 찍는다 (#106)

  • 항목에 major: true — 화면정의서 모드에서 제목 줄 오른쪽(×의 왼쪽)에 「주요」 단추. 꺼진 것은 올렸을 때만 나오고, 켜진 것은 늘 보인다 — 그때는 단추가 아니라 «표시» 로 읽혀야 한다
  • 내보내기에 「주요 항목만 (상위기획용)」 — 「화면 위 번호」 의 하위. 켜면 그림의 번호와 「기능 설명 표」 를 둘 다 그 항목만 남긴다. 그림은 걸렀는데 표에 전부 남으면 이슈가 호소한 «1:1 아님» 이 그대로다
  • 번호는 문서 전체 기준을 지킨다. 주요 항목이 1·3·4 면 그림에도 1 · 3 · 4 로 건너뛰어 박힌다. 다시 매기면 상위기획의 4번과 상세기획의 4번이 다른 것을 가리켜 번호로 대조할 수 없다
  • layer 와 직교하는 축이다. layer 는 「누가 쓰나」(기획↔개발), major 는 「어느 깊이인가」. 같은 기획 줄이라도 하나는 상위기획에 오르고 하나는 안 오르므로 layer 값을 늘려서는 안 풀린다
  • 이름을 brief 로 하지 않은 이유: 「화면 개요」(#82)가 안에서 이미 그 이름이다. 다른 것에 같은 이름을 쓰면 반드시 섞인다

찍힌 항목이 하나도 없으면 선택지가 아예 안 나온다 — 켜면 백지가 나오는 선택지는 만들지 않는다(「개발 정의 포함」 과 같은 규칙). 다만 개발 정의와 달리 「주요」 는 문서가 부팅 뒤에도 만들므로, 만들 때 한 번 재고 마는 것이 아니라 열 때마다 다시 본다.

하위 호환 — major 를 안 쓴 문서는 저장해도 키가 안 생기고 화면도 한 픽셀 안 바뀐다.

번호 없는 섹션 (#107)

화면마다 「메뉴 권한」처럼 화면 위를 가리키지 않는 항목을 두는 팀이 있다. 방법이 anno:"overview" 하나뿐이라 두 가지가 걸렸다 — 번호 칸에 늘 「개요」가 찍히고(화면 하나에 「개요」 둘), inOrder 가 맨 위로 끌어올린다. 번호 항목으로 두면 마커 없는 번호가 되어 화면 위 첫 번호가 3부터 시작하고, 매번 「못 찾은 정의」 경고까지 난다.

  • anno:"section" — 마커도 번호도 없는 것은 개요와 같고, 나머지는 반대다: 제 자리에, 제 이름으로 선다. 개요의 두 성질(라벨 고정·맨 위)은 #82 의 «결정»이라 옵션으로 열지 않고 다른 이름을 뒀다
  • 번호가 곧 열쇠였다. 행 id·드래그·찾기가 전부 String(s.n) 이라, 섹션에는 파일에 안 남는 실행 시 열쇠를 준다. 다시 매길 때 섹션은 번호를 받지 않는다
  • 내보내기 표에도 번호 없이 «섹션» 으로 선다. 슬래시 / → 「섹션」 은 부른 항목 다음에 놓는다

곁들여 — 코드로 만든 설정의 빈 번호. 편집기는 옮기거나 지울 때 다시 매기지만 window.SCREENSPEC 에 직접 넣는 설정에는 손이 닿지 않아, 번호가 비어도 아무 신호가 없었다(이슈 제기자 실측 2화면). 고치지 않고 말만 한다 — 로드 때 우리가 매기면 그쪽 문서와 화면의 번호가 어긋난다(번호는 문서 기준, #106 과 같은 이유). 화면마다 콘솔 한 줄: 빈 번호·겹친 번호·있는 번호.

시험이 잡은 것

  • wrap 모드에서 살아 있는 시트의 번호를 지우고 있었다. wrap 은 시트를 상자로 «옮겼다 되돌리는» 길이라, 거기서 마커를 떼어내면 뽑고 난 뒤 화면에서 번호가 사라진다 — 떼어낸 노드는 마커 자리잡기가 되살릴 수 없다. 지우는 대신 숨긴다(숨긴 것은 자리잡기가 제 손으로 되돌린다). 「뽑고 나면 화면의 번호는 전부 돌아온다」 검사와 돌연변이가 이를 지킨다
  • 숨긴 마커는 그림 둘레 여백 계산에서도 뺀다 — 안 그러면 display:none 의 좌표(0,0)가 «튀어나온 만큼» 으로 잡혀 왼쪽에 흰 띠가 생긴다

v0.31.0

Choose a tag to compare

@charmisuk charmisuk released this 06 Sep 08:42

툴바가 폭에 맞춰 스스로 접힌다

640px 하나로 꺾던 동안 641~883px 이 통째로 깨져 있었다 — 아이패드 세로 · 폴드 펼침 · 노트북 반쪽 창.
그 선을 넘는 순간 숨어 있던 것들이 한꺼번에 507px 돌아왔고, 그 사이를 받아 줄 단계가 없었다.

이제 몇 px 인가가 아니라 들어가는가로 판단한다. 툴바가 스스로 재서 안 들어가면 덜 중요한 것부터 접는다:
배율 표시 → 브랜드 라벨 → 도구(⋯) → 폭 시뮬 → 여백. 넓어지면 역순으로 펴진다.
모드 토글 글자는 어느 단계에서도 안 접는다.

폭이 같아도 내용 폭은 그때그때 다르다(저장 상태 문구 · readonly · 배율 표시 · 앞으로 붙을 것).
그래서 꺾이는 지점을 몇 개 더 두는 것으로는 영영 못 맞춘다.

저장은 한 물건이다

상태 글줄과 단추가 나란히 있었는데, 여섯 갈래 중 둘에서 같은 말을 두 번 하고 있었다.
하필 그 둘이 가장 흔했다 — 처음 열면 「자동저장 꺼짐 + 자동저장 켜기」, 평소엔 「저장됨 + 못 누르는 저장 단추」.

누를 일이 있으면 단추, 없으면 글줄. 한 번에 하나만 보인다.

상태 보이는 것
파일 미연결 단추 「자동저장 켜기」
고침 있음 단추 「저장」
밖에서 바뀜 단추 「저장 멈춤」 (경고색)
브라우저가 못 씀 단추 「내려받기」 + 물음표
저장 중 글줄 「저장 중…」
다 저장됨 글줄 「저장됨 · 방금」

「크롬·엣지에서 됩니다」는 상태가 아니라 설명이라 물음표 뒤로 내렸다. 툴바에서 가장 넓던 자리다.
판정 로직은 그대로다 — 바뀐 것은 그리는 방법뿐이다.

툴바 맨 왼쪽에 브랜드 마크

◇ 가이드 를 누르면 3분 가이드가 열린다. 전달본을 받은 사람에게는 ◇ ScreenSpec 으로 소개가 열린다.
화면정의서에 처음 들어가면 「처음이신가요?」가 잠깐 붙었다 사라진다 — 강조는 한 번, 존재는 늘.

라이브러리는 아무것도 보내지 않는다. 사람이 눌러야 브라우저가 우리 페이지로 간다.
바깥 링크 자체가 금지인 곳에서는 brand: false 로 만들지 않는다(숨김이 아니라 미생성).

그 밖에

  • 3분 가이드 신설 — 고치기 · 번호 붙이기 · 저장 · 넘기기 네 가지. charmisuk.github.io/screenspec/guide/
  • README 를 361줄에서 167줄로. 히어로 다음이 「AI 적용」이다 — 기획자의 실제 경로가 그것이다.
    적용 모드와 전달·공개는 docs/modes.md · docs/share.md 로 옮겼다
  • 없는 버튼을 안내하던 것을 고쳤다 — 「화면에서 번호 찍기」라는 버튼은 없다. 빈 줄에서 / → 「번호」다
  • 새 설정 brand

v0.30.1

Choose a tag to compare

@jasonjung-creator jasonjung-creator released this 03 Sep 09:17

한 판 앞의 나를 되짚는 판이다. #102 와 #104 는 사실 같은 호소 였다 — 「프로토타입이 창을 넘는다」.
그런데 #102 는 「자동」이라는 버튼으로, #104 는 「맞춤」이라는 또 다른 버튼으로 풀었다.
두 판에 걸쳐 같은 문제에 버튼을 두 개 붙였고, PM 의 첫마디는 그래서 「뭔가 기능이 더 붙어서 좀 지저분해」였다.

자동·맞춤을 걷어냈다 (#105)

[모바일 | PC | 자동]  1920×1080  [맞춤]   →   [모바일 | PC]  1920×1080 · 73%
  • 「맞춤」이 규칙이 됐다. 넘치면 줄인다 — 프로토타입도, 화면정의서도. 줄여서 잃는 정보가 없으니 판단이 아니고, 판단이 아니면 버튼일 이유가 없다. 화면정의서는 이미 이 규칙으로 돌고 있었다: 두 모드가 하나로 합쳐진 것이다
  • 「자동」을 뺐다. 프레임 가장자리를 끌면 아무 크기나 되고, 자동은 그중 「창 크기」 한 점의 단축키였다. 게다가 내 창 크기는 사용자 화면이 아니라 기준이 될 수 없다 — 문서가 PC 기준 이라 적어 뒀는데 보는 사람 모니터마다 다른 화면이 뜨면 「16열이 다 보인다」 같은 서술이 검증할 대상을 잃는다
  • 배율은 숫자로만 말한다 — 1920×1080 · 73%. 안 줄었으면 아무 말도 안 한다(넉넉한 모니터에서는 그대로 1920×1080)
  • baseViewport: "auto" 도 같이 걷었다. 쓰던 문서는 mobile 로 떨어지며 경고를 남긴다 — 조용히 달라지지 않는다

실측(1440×900 창 · PC 기준 문서): 전에는 가로 528px · 세로 278px 이 창 밖에 있었고 밀어야 보였다. 지금은 0 · 0 이다.

바뀌지 않는 것 — 시트 크기는 그대로라 앱의 미디어쿼리는 안 달라진다. 손잡이로 끈 크기는 창을 줄여도 지켜지고, 프리셋은 「누르면 돌아갈 자리」로 남는다. 모바일 시트는 대부분의 창에서 여전히 100% 다.