seed-token-analysis

SEED 토큰 분석

현재 체크아웃의 packages/rootage/color.yaml을 기준으로 색상 토큰의 정의, 연결 관계, 생성 결과와 대비를 확인한다. 스크립트는 파일과 Git 상태를 바꾸지 않는다.

토큰 지도

색상 토큰 하나를 지정한다.

bun skills/seed-token-analysis/scripts/token-map.ts '$color.fg.neutral'

결과 JSON은 다음 순서로 읽는다.

1. token에서 입력을 정규화한 canonical과 state를 확인한다. state는 matched, ambiguous, not-found 중 하나다. ambiguous면 candidates의 정확한 토큰으로 다시 실행하고, not-found면 비슷한 이름을 임의로 선택하지 않는다.
2. definition에서 Rootage 원천 경로, 설명과 mode별 원시 값을 확인한다.
3. resolvedValues에서 각 mode의 원시 값, alias 연결과 최종 색상 값을 확인한다. 한 mode의 값이 없거나 alias를 끝까지 해석하지 못했다면 다른 mode 값으로 대신하지 않는다.
4. dependentTokens에서 대상 토큰을 직접 참조하는 토큰을 확인한다. 이 목록은 전이 의존 관계나 여러 변경의 결합 영향을 계산하지 않는다.
5. componentUsages에서 컴포넌트의 변형, 상태, 슬롯, 속성과 근거 경로가 구조화되어 있는지 확인한다.
6. generatedSurfaces에서 플랫폼과 패키지별 status, 실제 paths, 예상 expectedPaths를 비교한다. missing은 생성 결과를 찾지 못했다는 뜻이며 Rootage 원천을 직접 수정하라는 뜻이 아니다.
7. warnings를 확인하고 readOnly가 true인지 확인한다.

token.publicNames가 있으면 CSS 변수와 공개 이름을 확인할 수 있다. 생성 파일은 실제 배포 표면을 확인하는 근거로만 사용하고 직접 수정하지 않는다.

대비 검사

전경 토큰 하나와 하나 이상의 배경 토큰을 지정한다. --background와 --theme은 반복할 수 있고, 반투명 배경 아래의 실제 색상이 필요하면 --backdrop을 추가한다. --theme을 생략하면 light와 dark를 모두 검사한다. 중복 테마는 제거하고 결과는 light, dark 순서로 반환한다.

bun skills/seed-token-analysis/scripts/token-contrast.ts \
  --foreground '$color.fg.warning-contrast' \
  --background '$color.bg.warning-solid' \
  --background '$color.bg.warning-solid-pressed' \
  --theme light \
  --theme dark

bun skills/seed-token-analysis/scripts/token-contrast.ts \
  --foreground '$color.fg.neutral' \
  --background '$color.bg.overlay' \
  --theme light \
  --backdrop '$color.bg.layer-default'

source와 request에서 분석한 Rootage 원천과 입력이 맞는지 먼저 확인한다. 결과의 checks는 배경과 테마 조합별로 다음 상태를 반환한다.

• resolved: alias와 색상 합성을 마치고 WCAG 2.x 대비율과 기준별 통과 여부를 계산했다.
• unresolved: 해당 mode 값이나 alias를 해석하지 못했다. 다른 테마의 값을 대신 사용하지 않는다.
• needs-backdrop: 반투명 배경 아래의 색상을 확정할 수 없다. 실제 불투명 backdrop 토큰을 지정해 다시 검사한다.