# Changelog 본 형식 = [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) 형식을 따름. 버전 규칙 = [Semantic Versioning](https://semver.org/spec/v2.0.0.html). **EN —** Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html). > **eslint-plugin-dsmonitor** 측 version history → [eslint-plugin-dsmonitor/CHANGELOG.md](./eslint-plugin-dsmonitor/CHANGELOG.md) > **EN —** **eslint-plugin-dsmonitor** version history → [eslint-plugin-dsmonitor/CHANGELOG.md](./eslint-plugin-dsmonitor/CHANGELOG.md) ## [0.9.1] — 2026-07-10 ### 추가 / Added - **한 —** `docs/roadmap.md` 신설 — 이월된 추가개발 후보 3건 (scss-imports 매트릭스 연계 / Bootstrap `@extend`·`@include` 검출 / 대시보드 인라인 번들) 의 배경·현재 상태·구현 방향·선행 조각 기록 (한국어 단일 — 살아있는 계획 문서라 한/영 동기화 비용 회피). 옛 흐름은 이월 결정이 흩어진 코드 주석에만 남아 리포지토리 문서로는 찾을 수 없었음. 2026-07 조사 배치 이력 표 (0.8.8~0.9.0) 포함. - **EN —** `docs/roadmap.md` added — records the three deferred development candidates (scss-imports matrix-linked detection / Bootstrap `@extend`·`@include` detection / dashboard inline bundle) with background, current state, direction, and prerequisites (Korean only — a living planning document, avoiding the KR/EN sync cost). Previously the deferral decisions lived only in scattered code comments. Includes a one-line history of the 2026-07 audit batches (0.8.8–0.9.0). - **한 —** README 에 알려진 한계 안내 추가 (한/영 1:1) — 지원 기술 스택 아래 "SCSS `@extend`/`@include` 경유 Bootstrap 사용은 현재 미측정", §5 dashboard 행에 "열 때 인터넷 연결 필요 (CDN — 폐쇄망 미지원)". 둘 다 roadmap 링크 병기. Further Reading 목록에도 roadmap 추가. - **EN —** Known-limitation notes added to the README (KR/EN 1:1) — under Supported Tech Stacks: "Bootstrap usage via SCSS `@extend`/`@include` is currently not measured", and on the §5 dashboard row: "requires an internet connection when opened (CDN — air-gapped networks unsupported)". Both link to the roadmap, which is also listed under Further Reading. ### 참고 / Notes - docs-only release — 코드 동작 변경 없음. 코드 주석 3곳 (preset scss-imports / forbidden-meta / codebase matrix) 의 이월 표기를 roadmap 참조로 연결 (옛 "0.9.0+ 논의" 낡은 표기 정정 포함). - Docs-only release — no behavior change. Three code comments (preset scss-imports / forbidden-meta / codebase matrix) now point to the roadmap (fixing the stale "0.9.0+ discussion" phrasing). - `npm test` (66) + `npm run typecheck` + `npm run build` 통과 / pass. ## [0.9.0] — 2026-07-10 > **측정 결과 변화 안내** — 본 release 의 파서 개선으로 일부 지표 수치가 옛 baseline 과 달라질 수 있습니다 (아래 각 항목에 방향 명시). 시계열 비교 시 0.9.0 전후 구분을 권장합니다. > > **EN — Measurement change notice**: parser improvements in this release can shift some metric values relative to older baselines (direction noted per item below). For time-series comparisons, treat pre/post-0.9.0 separately. ### 변경 / Changed - **한 —** DS ↔ 코드 토큰 매칭에 이름 정규화가 도입됩니다 — Tailwind v3 dot-path (`colors.primary.500`) 와 v4 CSS 변수형 (`--color-primary-500`) 을 같은 논리 토큰으로 매칭 (colors / spacing / fontSize / fontFamily / fontWeight / lineHeight / letterSpacing / borderRadius / boxShadow / screens 카테고리 한정 — 그 외 이름은 옛 완전 일치 그대로). 표시 이름은 첫 등장 원 이름 보존. **영향: 토큰 매칭률이 오르는 방향** (옛 흐름은 같은 논리 토큰이 이름 체계 차이로 미매칭). - **EN —** Name normalization is introduced for DS ↔ code token matching — Tailwind v3 dot-paths (`colors.primary.500`) and v4 CSS-variable names (`--color-primary-500`) now match as the same logical token (limited to the colors / spacing / fontSize / fontFamily / fontWeight / lineHeight / letterSpacing / borderRadius / boxShadow / screens categories — other names keep the old exact-match behavior). Display names keep the first-seen original. **Effect: token match rates can only go up** (previously the same logical token failed to match across naming schemes). - **한 —** `className={...}` 표현식의 문자열 수집이 정밀화됩니다. 옛 흐름은 표현식 안 **모든** 문자열 리터럴을 수집 — `t("common.title")` 같은 i18n 키, `s === "active"` 비교 문자열이 클래스로 오집계. 0.9.0 부터 노드 타입별 명시 규칙: 클래스 유틸 호출 (clsx / classnames / cn / cx / twMerge / twJoin / cva) 인자만 재귀, 삼항은 결과 가지만, `+` 연결·논리 연산·배열·clsx 조건 객체의 key·CSS modules computed key 는 수집, 그 외 skip. **영향: 고아 클래스 / 금지 클래스 카운트가 줄어드는 방향** (오집계 제거). - **EN —** String collection inside `className={...}` expressions is now precise. Previously **every** string literal in the expression was collected — i18n keys like `t("common.title")` and comparison strings like `s === "active"` were miscounted as classes. From 0.9.0, explicit per-node rules apply: only class-utility call arguments (clsx / classnames / cn / cx / twMerge / twJoin / cva) recurse; ternaries contribute only their result branches; `+` concatenation, logical operators, arrays, clsx condition-object keys, and CSS-modules computed keys are collected; everything else is skipped. **Effect: orphan-class / forbidden-class counts can only go down** (miscounts removed). - **한 —** CSS 변수 선언 스캔 보강 — 주석 (블록 + SCSS 라인) 안 선언 오집계 방지, 마지막 선언의 세미콜론 생략 허용, 세미콜론 누락 값이 `}` 를 넘어 다음 rule 로 번지지 않음 (여러 줄 값 `calc(...)` 은 그대로 지원). **영향: 주석 처리된 변수가 빠져 토큰 수가 줄거나, 세미콜론 생략 변수가 잡혀 늘 수 있음.** - **EN —** CSS custom-property scanning hardened — declarations inside comments (block + SCSS line) are no longer collected, a trailing declaration may omit its semicolon, and a missing semicolon no longer lets a value bleed past `}` into the next rule (multi-line `calc(...)` values still supported). **Effect: token counts may drop (commented-out vars excluded) or rise (semicolon-less vars now caught).** - **한 —** tailwind config 해석 보강 — `presets` 배열의 theme 병합 (사용자 config 우선), 함수형 카테고리에 최소 theme helper stub 전달 (`theme(path, 기본값)` → 기본값), fontSize 류 tuple 의 2번째 객체를 sub-token 으로 flatten (`fontSize.xl.lineHeight`). **영향: 옛 흐름에서 누락되던 토큰이 추가되는 방향.** - **EN —** tailwind config interpretation improved — `presets` array themes are merged (user config wins), functional categories receive a minimal theme-helper stub (`theme(path, default)` → default), and the second tuple element of fontSize-style values is flattened into sub-tokens (`fontSize.xl.lineHeight`). **Effect: tokens previously missed are now added.** ### 추가 / Added - **한 —** doctor 확장 — (1) `stylingPolicy.preferred` 가 `allowed` 목록에 있는지 의미 검증 (옛 흐름: 잘못된 설정이 doctor 를 통과하고 측정 단계에서야 드러남), (2) `globalStyleSources` / `designSystem.officialPaths` 의 glob 패턴을 실매치 건수로 검사 (옛 root 부분 존재 가늠 대체 — 디렉토리는 있는데 매치 0건인 케이스를 잡음), (3) Figma URL 오류 hint 에 FigJam(/board/)·Slides 링크가 측정 대상이 아님을 명시 (허용 형식 자체는 분석기 수용 범위와 일치 유지). - **EN —** doctor extensions — (1) semantic validation that `stylingPolicy.preferred` exists in `allowed` (previously an invalid setting passed doctor and only surfaced during measurement), (2) `globalStyleSources` / `designSystem.officialPaths` glob patterns are now checked by actual match count (replacing the old root-segment existence guess — catches "directory exists but zero matches"), (3) the Figma URL error hint now states that FigJam (/board/) and Slides links are not measurable (the accepted format itself stays aligned with the analyzer). - **한 —** init 확장 — tailwind config 자동 감지 후보에 `.mts` / `.cts` 추가 (파서는 이미 지원), `@lhci/cli` 자동 설치 실패 시 npm / yarn / pnpm 별 직접 설치 명령 안내. - **EN —** init extensions — `.mts` / `.cts` added to the tailwind-config auto-detection candidates (the parser already supported them), and on `@lhci/cli` auto-install failure the guidance now lists the direct commands for npm / yarn / pnpm. ### 참고 / Notes - baseline JSON shape 변경 없음 — 위 변화는 전부 값 (카운트 / 매칭) 차원. - No baseline-JSON-shape changes — all effects above are value-level (counts / matches). - 테스트 66개 (0.8.10 대비 +28 — 정규화 / className 수집 / CSS 변수 스캔 / tailwind config / doctor 신규 suite) + typecheck + build 통과. - 66 tests (+28 vs 0.8.10 — new suites for normalization / className collection / CSS-var scanning / tailwind config / doctor) + typecheck + build pass. ## [0.8.10] — 2026-07-10 ### 추가 / Added - **한 —** 테스트 인프라가 도입됩니다 — vitest + `npm test` 스크립트 + `tests/` (38개 테스트). 커버 대상: thresholds 판정 유틸 (evaluate/judge 경계값), overview placeholder 치환 (이름 자유 키 · hyphen 키 · unknown `{{key?}}` · 목록 블록 정렬), 토큰 매트릭스 매칭 (buildTokenMatrix), 코드 토큰 파서 3종 (scss / cssVariables / tailwind — fixture 파일 기반), dashboard transformer (judge · forbiddenByPreset 정렬 · tsTopJsDirs), dashboard jsx 5종 문법 검사 (esbuild parse — 0.8.8 때 수동 검증하던 것을 상시화). 이후 릴리즈의 회귀 안전망. - **EN —** Test infrastructure is introduced — vitest + an `npm test` script + `tests/` (38 tests). Coverage: the threshold judgment util (evaluate/judge boundaries), overview placeholder substitution (free-name keys · hyphen keys · unknown `{{key?}}` · list-block ordering), token-matrix matching (buildTokenMatrix), the three code-token parsers (scss / cssVariables / tailwind, fixture-file based), the dashboard transformers (judge · forbiddenByPreset ordering · tsTopJsDirs), and jsx syntax checks for all five dashboard components (esbuild parse — automating what 0.8.8 verified manually). A regression safety net for future releases. ### 변경 / Changed - **한 —** FORBIDDEN 라벨 + preset 매트릭스 정의가 단일 원천 (`src/dashboard/forbidden-meta.ts`) 으로 통합됩니다. 옛 흐름: 같은 정의가 transformer (TS) 와 code-tab.jsx (babel-inline) 두 곳에 복제 — 한쪽만 갱신하면 summary 탭과 code 탭 표시가 어긋나는 부류 (0.8.3~0.8.6 반복 정정) 가 재발할 수 있었음. 이제 shell 이 `window.__FORBIDDEN_META` 로 inject 하고 jsx 는 그것만 소비 — 정의 중복 자체가 사라짐. 표시 결과 변화 없음 (전후 산출물 diff 0 확인). - **EN —** The FORBIDDEN labels + preset matrix now live in a single source (`src/dashboard/forbidden-meta.ts`). Previously the same definitions were duplicated in the TS transformer and the babel-inline code-tab.jsx — updating only one side could desynchronize the summary and code tabs (the class of bug fixed repeatedly in 0.8.3–0.8.6). The shell now injects `window.__FORBIDDEN_META` and the jsx only consumes it — the duplication itself is gone. No display change (before/after output diff is empty). - **한 —** 산재하던 복제 구현이 공유 유틸 (`src/utils/`) 로 추출됩니다 — `round()` (4곳), glob 확장 `isGlob`/`expandFiles` (파서 2곳 + doctor), CSS 변수 선언 스캔 + `countLines` (2곳), 날짜 stamp (로컬/UTC 두 의미 보존 — 통일은 동작 변경이라 보류), "최신 파일 찾기" readdir 패턴 (3곳). 호출처 교체만 — 로직 변화 없음. - **EN —** Scattered duplicate implementations are extracted into shared utils (`src/utils/`) — `round()` (4 copies), glob expansion `isGlob`/`expandFiles` (2 parsers + doctor), CSS custom-property scanning + `countLines` (2 copies), date stamps (both local and UTC meanings preserved — unifying them would change behavior, deferred), and the "find latest file" readdir pattern (3 copies). Call-site swaps only — no logic change. - **한 —** baseline 류 JSON 읽기에 파싱 방어가 일관 적용됩니다 (`src/utils/readJson.ts` — cli 3곳 / migration CSV / dashboard render). 옛 흐름은 손상 JSON 시 raw SyntaxError 스택 노출 — 이제 파일 경로 + 손상 안내 + 재측정 권고 메시지. `[dsmonitor]` prefix 의 의도된 에러는 CLI 종료 시 message 만 출력 (예기치 못한 에러는 옛 그대로 전체 출력). - **EN —** JSON reads of baseline-style files gain consistent parse protection (`src/utils/readJson.ts` — 3 CLI sites / migration CSV / dashboard render). Previously a corrupted JSON surfaced a raw SyntaxError stack — now a message with the file path, a corruption note, and a re-measure suggestion. Intentional `[dsmonitor]`-prefixed errors print message-only on CLI exit (unexpected errors keep the full output). - **한 —** 죽은 코드 정리 — 미참조 export 제거 (`serializeForbidden`/`toRegExp` (직렬화 타입은 보존), `listFrameworks`, `listRegisteredParserTypes`), `printSummary(r: any)` → `CodebaseReport`, doctor 의 `(page as any)` cast 제거 (union 타입 직접 접근). - **EN —** Dead-code cleanup — unreferenced exports removed (`serializeForbidden`/`toRegExp` (the serialization types remain), `listFrameworks`, `listRegisteredParserTypes`), `printSummary(r: any)` → `CodebaseReport`, and the `(page as any)` cast in doctor replaced with direct union-typed access. ### 정정 / Fixed - **한 —** dashboard 접근성 보강 — (1) 탭 ↔ 콘텐츠 연결 (`aria-controls`/`role="tabpanel"`/`aria-labelledby`) + 좌우 화살표 키로 탭 이동 (roving tabindex), (2) 모든 접기/펼치기 버튼에 `aria-expanded` (code/figma/lighthouse 탭 4종), (3) 소형 회색 텍스트 대비 보정 — `--ink-3` 4.24:1 → 5.35:1, `--ink-4` 2.34:1 → 4.82:1 (WCAG AA 4.5:1 기준, 색조 유지·명도만 하강), (4) `prefers-reduced-motion` 존중. - **EN —** Dashboard accessibility — (1) tab ↔ panel wiring (`aria-controls`/`role="tabpanel"`/`aria-labelledby`) plus arrow-key tab navigation (roving tabindex), (2) `aria-expanded` on every disclosure toggle (4 components across the code/figma/lighthouse tabs), (3) small gray text contrast fixes — `--ink-3` 4.24:1 → 5.35:1 and `--ink-4` 2.34:1 → 4.82:1 (WCAG AA 4.5:1; hue kept, lightness lowered), (4) `prefers-reduced-motion` respected. ### 참고 / Notes - 측정 로직 / baseline JSON shape 변경 없음. 동작 불변 확인: 같은 fixture baseline 으로 리팩토링 전 (0.8.9) / 후 산출물 비교 — dashboard 데이터 JSON · markdown 리포트 · overview 문서 전부 동일. - No measurement-logic or baseline-JSON-shape changes. Behavior invariance verified: outputs from the same fixture baseline before (0.8.9) and after the refactor are identical — dashboard data JSON, markdown report, and overview document. - `npm test` (38) + `npm run typecheck` + `npm run build` 통과 / pass. ## [0.8.9] — 2026-07-10 ### 정정 / Fixed - **한 —** markdown 리포트의 핵심 지표 라벨 "SCSS 변수 준수율" 이 "변수 준수율" 로 정정됩니다 (dashboard 는 0.8.2 에서 정정 완료 — 두 산출물 표기 일치). CLI 콘솔 요약의 "SCSS variable usages / SCSS compliance" 도 "Variable usages / Variable compliance" 로 동기화. code-tab.jsx 주석의 옛 명칭 2곳 정리 (표시 영향 없음). - **EN —** The markdown report's key-metric label "SCSS 변수 준수율" is corrected to "변수 준수율" (the dashboard was already fixed in 0.8.2 — the two outputs now match). The CLI console summary lines "SCSS variable usages / SCSS compliance" are synced to "Variable usages / Variable compliance". Two stale comments in code-tab.jsx are also cleaned up (no display impact). - **한 —** `npx dsmonitor --help` 가 구현됩니다 (`-h` / `help` 동일) — 명령 목록 출력 후 정상 종료. 옛 흐름은 init 완료 안내가 `--help` 를 권하는데 실제로는 "Unknown command" 로 종료 코드 2 가 나던 어긋남. Unknown command 안내의 명령 목록에도 누락되어 있던 `init` / `doctor` 가 추가되고, 두 곳이 같은 목록 상수를 공유합니다. - **EN —** `npx dsmonitor --help` is now implemented (`-h` / `help` behave the same) — prints the command list and exits 0. Previously the init completion notes recommended `--help` while the CLI answered "Unknown command" with exit code 2. The Unknown-command listing also gains the previously missing `init` / `doctor` entries, and both paths now share a single list constant. - **한 —** `dsmonitor init` 이 생성하는 config 의 figma 블록에서 `apiToken` 필드가 제거됩니다. `FigmaConfig` 스키마에 없고 분석기는 `FIGMA_API_TOKEN` 환경변수를 직접 읽으므로 사용되지 않던 필드 — README·정적 템플릿과도 어긋나던 init 산출물만의 이질 항목. - **EN —** The `apiToken` field is removed from the figma block that `dsmonitor init` generates. It never existed on the `FigmaConfig` schema and the analyzer reads the `FIGMA_API_TOKEN` environment variable directly — a dead field unique to the init output, out of step with the README and the static template. - **한 —** README 영어 정본에 "Supported Tech Stacks" 섹션이 추가됩니다 (0.8.7 에 기록된 한/영 비대칭 해소 — 옛 흐름은 한국어 쪽 결합 블록에만 존재). 한/영 양쪽 목차에 항목이 추가되고, §5 출력물 표의 "4 탭" 표기가 §6 과 같은 "5 탭 (Summary / Code / Lighthouse / Figma / Plugin)" 셈법으로 통일됩니다. - **EN —** The English reference gains its own "Supported Tech Stacks" section (resolving the KR/EN asymmetry noted in 0.8.7 — previously the content lived only inside the Korean-side combined block). Both tables of contents gain an entry, and the §5 output table's "4-tab" phrasing is unified with §6 as "5 tabs (Summary / Code / Lighthouse / Figma / Plugin)". - **한 —** CHANGELOG 0.1.0 entry 의 날짜 placeholder ("2026-XX-XX") 가 npm 발행 이력으로 확인한 실제 날짜 "2026-05-04" 로 채워집니다. config 템플릿의 옛 참조 ("cli.js 안 countMatches" — 현재 소스에 없는 파일명·심볼) 와 tsup 헤더 주석의 "v0.1.0" 고정 표기도 정리. - **EN —** The 0.1.0 CHANGELOG date placeholder ("2026-XX-XX") is filled with the actual publish date "2026-05-04" (confirmed from the npm publish history). A stale reference in the config template ("countMatches in cli.js" — a file/symbol that no longer exists) and the fixed "v0.1.0" note in the tsup header comment are also cleaned up. ### 변경 / Changed - **한 —** **(breaking — overview 템플릿 한정)** overview 리포터의 고정 placeholder 키 6개가 제거됩니다 — `migrationInputCount` / `migrationSelectCount` / `migrationButtonCount` / `migrationTableCount` / `bootstrapClassCount` / `tailwindClassCount`. 검수 대상 이름은 사용자 config (`migrationTargets`) 가 정하므로 특정 이름을 코드에 고정할 근거가 없던 잔재 (다른 프로젝트에선 항상 0). 대체 placeholder: - `{{migrationByTarget.<이름>}}` — config 에 등록한 이름이 곧 placeholder 이름 (예: 옛 `{{migrationInputCount}}` → `{{migrationByTarget.Input}}`). - `{{forbiddenById.}}` — 금지 id 별 카운트 (예: 옛 `{{bootstrapClassCount}}` → `{{forbiddenById.bootstrap-utilities}}`). - `{{migrationByTargetList}}` / `{{forbiddenByIdList}}` — 등록된 항목 전체를 카운트 내림차순 "- 이름 N건" 줄 목록으로 나열. 형식을 dsmonitor 가 정하므로 값 placeholder 와 같은 데이터에 혼용하지 않기를 권장. 옛 키를 쓰는 템플릿은 조용히 오표기되지 않고 `{{키?}}` 표시 + 콘솔 warning 으로 드러납니다. placeholder 키 문자에 hyphen 이 허용되도록 치환 regex 도 확장 (`forbiddenById.bootstrap-utilities` 참조 가능). - **EN —** **(breaking — overview templates only)** Six fixed overview placeholder keys are removed — `migrationInputCount` / `migrationSelectCount` / `migrationButtonCount` / `migrationTableCount` / `bootstrapClassCount` / `tailwindClassCount`. The inspected component names are defined by the user config (`migrationTargets`), so hard-coding specific names had no basis (always 0 on other projects). Replacements: - `{{migrationByTarget.}}` — the name you registered in config is the placeholder name (e.g. old `{{migrationInputCount}}` → `{{migrationByTarget.Input}}`). - `{{forbiddenById.}}` — per-forbidden-id counts (e.g. old `{{bootstrapClassCount}}` → `{{forbiddenById.bootstrap-utilities}}`). - `{{migrationByTargetList}}` / `{{forbiddenByIdList}}` — list every registered item as "- name N건" lines, count-descending. Since dsmonitor controls this format, avoid mixing it with value placeholders for the same data. Templates still using the old keys fail loudly rather than silently — rendered as `{{key?}}` plus a console warning. The replacement regex now also accepts hyphens in keys (so `forbiddenById.bootstrap-utilities` works). ### 참고 / Notes - 측정 로직 / baseline JSON shape / dashboard 동작 모두 변경 없음 — 리포터 표기·overview placeholder·문서·CLI 안내만 정정. - No changes to measurement logic, baseline JSON shape, or dashboard behavior — reporter wording, overview placeholders, docs, and CLI guidance only. - 검증: `npm run typecheck` + `npm run build` 통과, `--help` exit 0 / 명령 목록 확인, fixture baseline 으로 overview (신규 placeholder 치환 + 옛 키 `{{키?}}` 경고) 와 markdown (라벨 "변수 준수율") 생성 확인, `apiToken` 문자열 소스 전체 부재 확인. - Verified: `npm run typecheck` + `npm run build` pass; `--help` exits 0 with the command list; a fixture baseline confirms overview rendering (new placeholders substituted, old keys surfaced as `{{key?}}` with a warning) and the markdown label "변수 준수율"; the `apiToken` string is absent from all sources. ## [0.8.8] — 2026-07-10 ### 정정 / Fixed - **한 —** dashboard "변수 준수율" 카드가 측정값과 무관하게 항상 "기준 95% 도달" (초록) 로 표시되던 오표기가 정정됩니다. 옛 흐름은 code 탭 ScssSection 의 status 가 리터럴 고정 — 준수율이 기준 미만이어도 "도달" 로 노출. 0.8.8 부터 `cfg.thresholds.scssVariableCompliance` 판정으로 상태 pill · 숫자 색상 · 목표 표기 · 막대 마크 위치가 모두 동적 결정됩니다. - **EN —** The dashboard "변수 준수율" (variable compliance) card no longer shows a hard-coded "기준 95% 도달" (met, green) status regardless of the measured value. Through 0.8.7 the code-tab ScssSection status was a literal, so even a below-threshold compliance rendered as "met". From 0.8.8 the status pill, number color, goal text, and bar mark position are all derived from `cfg.thresholds.scssVariableCompliance`. - **한 —** dashboard 전반의 상태 배지 · 목표 수치 리터럴이 `cfg.thresholds` 기반 동적 판정으로 정정됩니다. 옛 흐름은 Summary 탭 코드 3카드 항상 "기준 미달", Lighthouse 카드 배지 · code 탭 각 섹션 status · "목표 ≥ 80%" 류 목표 표기가 전부 시안 시점 리터럴 — thresholds 설정과 무관했고, markdown 리포터 (동적 판정) 와 같은 baseline 에서 판정이 어긋날 수 있었습니다. 0.8.8 부터 판정 로직이 공유 유틸 (`src/utils/evaluate.ts`) 로 단일화되어 markdown 리포트와 dashboard 가 같은 기준으로 판정을 내립니다. Summary Lighthouse 카드는 Lighthouse 표준 임계 (≥90 / ≥75) 를 상세 탭 (lhBadgeFromScore) 과 동일 적용 — 탭 간 배지 일치. - **EN —** Hard-coded status badges and goal numbers across the dashboard are replaced with dynamic judgments from `cfg.thresholds`. Previously the three Summary code cards always showed "기준 미달" (below), Lighthouse card badges and every code-tab section status plus goal texts like "목표 ≥ 80%" were literals from the original design handoff — ignoring the configured thresholds and potentially contradicting the markdown report (which judges dynamically) on the same baseline. From 0.8.8 the judgment logic is unified in a shared util (`src/utils/evaluate.ts`) so the markdown report and the dashboard judge identically. Summary Lighthouse cards apply the standard Lighthouse thresholds (≥90 / ≥75), matching the detail tab's lhBadgeFromScore — consistent badges across tabs. - **한 —** Lighthouse 탭 상세 섹션 순서가 매트릭스 열 순서 (Performance → Accessibility → Best Practices → SEO) 와 통일됩니다. 옛 흐름은 Accessibility 가 첫 번째라 같은 탭 안에서 지표 순서가 어긋났습니다. - **EN —** The Lighthouse tab detail sections now follow the matrix column order (Performance → Accessibility → Best Practices → SEO). Previously Accessibility came first, so the metric order disagreed within the same tab. - **한 —** 옛 시안 잔재 문구 (특정 프로젝트 상황 리터럴) 가 제거되거나 데이터 기반 표기로 교체됩니다 — (1) Summary Lighthouse layer 설명의 고정 페이지 수 문구 → 측정된 URL 수 · run 수, (2) TypeScript 카드의 특정 디렉토리명 나열 → `tsMigration.byDir` 기반 JS 잔여 상위 디렉토리, (3) "Variables 는 plan 제약으로 미포함" → Figma 스캔 신호 기반 조건부 안내 (403 warning 시 안내 · 조회 성공 시 변수 수 표시), (4) figma 탭 stamp fallback 의 시안 날짜 → "—", (5) "전체적으로 안정" · "컴포넌트 교체가 label · aria 개선으로 이어질 것으로 예상" 류 소견 문구 → 판정 기반 중립 문구 (기준값 · 측정값 · 상세 위치만, met/below 틀 고정 + 값 삽입), (6) Lighthouse 탭 hint 리터럴 → 데이터로 검증되는 사실만 표시 (전 URL 동일 점수 케이스 계산). - **EN —** Design-handoff relic strings (literals describing one specific project) are removed or replaced with data-driven text — (1) the fixed page-count phrase in the Summary Lighthouse layer description → measured URL count · run count, (2) the specific directory names in the TypeScript card → top remaining-JS directories derived from `tsMigration.byDir`, (3) "Variables excluded due to plan restriction" → a conditional note driven by actual Figma scan signals (shown on a 403 warning; variable count shown on success), (4) the design-era fallback date in the figma tab stamp → "—", (5) editorial sentences like "overall stable" and "component replacement is expected to improve labels/aria" → neutral judgment-based text (threshold, measured value, and where to look only; fixed met/below templates with inserted values), (6) Lighthouse tab hint literals → only facts verifiable from data (the all-URLs-same-score case, actually computed). ### 변경 / Changed - **한 —** Figma Variables 조회 성공 시 `designSystemCounts[].variables` 가 실제 변수 수로 채워집니다 (옛 흐름: 항상 null). null = 미조회 (Enterprise plan 403 — warnings 에 "Variables:" prefix 경고 병행 기록) / number = 조회됨 (0 포함). figma 탭 "측정 범위" 표기도 이 신호 따라 "Styles만" / "Styles + Variables" 로 동적 결정됩니다. - **EN —** On a successful Figma Variables fetch, `designSystemCounts[].variables` is now populated with the actual variable count (previously always null). null = not fetched (Enterprise-plan 403, with a "Variables:"-prefixed warning recorded) / number = fetched (0 included). The figma tab "측정 범위" (measurement scope) label also follows this signal — "Styles만" vs "Styles + Variables". - **한 —** dashboard inject 데이터에 판정 필드가 추가됩니다 — `__CODE_DATA.judge` / `__SUMMARY_DATA.code.judge` (status · good · warn · direction), `__SUMMARY_DATA.code.tsTopJsDirs`, figma 데이터의 `variablesRestricted` / `variablesCount`. dashboard HTML 전용 derived 필드라 baseline JSON shape 는 그대로입니다 (위 `variables` 값 채움 외 변화 없음). - **EN —** Judgment fields are added to the dashboard-injected data — `__CODE_DATA.judge` / `__SUMMARY_DATA.code.judge` (status · good · warn · direction), `__SUMMARY_DATA.code.tsTopJsDirs`, and `variablesRestricted` / `variablesCount` on the figma data. These are dashboard-HTML-only derived fields; the baseline JSON shape is unchanged (aside from the `variables` value now being filled as above). - **한 —** config thresholds 에 대응 지표가 없는 figma 비율 카드 (토큰 매칭률 · Instance 비중) 는 근거 없는 "기준 미달" 리터럴 배지를 제거하고 방향 표기 ("목표 ↑") 만 유지합니다. 고유 목표 0 이 정의에서 나오는 건수 지표 (DS 외부 Instance · 마이그레이션 후보) 는 건수 기반 판정 (0건 = 도달) 으로 전환 — Summary 와 상세 탭이 같은 규칙을 공유합니다. - **EN —** Figma ratio cards with no corresponding config threshold (token match rate · instance share) drop the unfounded literal "기준 미달" badge and keep only the direction indicator ("목표 ↑"). Count metrics whose zero goal follows from their definition (instances outside the DS · migration candidates) switch to count-based judgment (0 = met) — Summary and detail tabs share the same rule. ### 참고 / Notes - `scss-imports` (tailwind preset) 가 dashboard 매트릭스에 미등재인 것은 의도임을 명시하는 주석이 3곳 (preset 정의부 · code-tab.jsx · baseline-to-summary-data.ts 매트릭스 정의부) 에 추가됩니다 — 감지 규칙이 비어 있어 항상 0 이고, 단순 import 경로 검출은 pure-@apply 허용 방침과 충돌 (오검출 위험). 매트릭스 연계 구현은 0.9.0+ 논의 이월. - Comments are added in three places (the preset definition, code-tab.jsx, and the baseline-to-summary-data.ts matrix) stating that `scss-imports` (tailwind preset) being absent from the dashboard matrix is intentional — its detection rules are empty (always 0), and naive import-path detection would conflict with the pure-@apply allowance (false positives). A matrix-linked implementation is deferred to the 0.9.0+ discussion. - 검증: `npm run typecheck` + `npm run build` 통과, dashboard jsx 5종 esbuild parse 통과, fixture baseline 으로 느슨한 / 엄격한 thresholds 2회 생성해 judge status 가 good ↔ bad 로 바뀌는 것 + 시안 잔재 문구 부재 확인. - Verified: `npm run typecheck` + `npm run build` pass, all five dashboard jsx files parse with esbuild, and two dashboard builds from a fixture baseline (loose vs strict thresholds) confirm judge statuses flip good ↔ bad and no relic strings remain. ## [0.8.7] — 2026-06-23 ### 변경 / Changed - **한 —** README 가 비개발자(기획·퍼블리싱) 진입을 우선하도록 재구성됩니다. 섹션 순서가 "시작하기"(측정 항목 → 설치 → 빠른 시작 → CLI → 출력물 위치 → 보고서 활용) 와 "심화 레퍼런스"(설정 가이드 → 환경별 예 → Figma 동작 원리 → ESLint → 사이드카 plugin → 환경변수 → FAQ) 두 띠로 나뉩니다. 옛 흐름에서 맨 뒤에 있던 출력물 위치·보고서 활용이 실행 단계 직후로 올라오고, 옛 §2 의 사이드카 plugin 개념 설명이 작성 가이드와 함께 §11 로 통합됩니다. 헤더 번호와 본문 상호참조가 함께 재번호됩니다. 코드·동작 변경 없음 (문서 전용). - **EN —** The README is restructured to put non-developer (planning / publishing) onboarding first. Sections are split into two bands — "Getting started" (Measurement Areas → Installation → Quick Start → CLI → Output Locations → Reading the Reports) and "Reference" (Configuration Guide → Per-stack Sketches → How Figma Matching Works → ESLint → Sidecar Plugins → Environment Variables → FAQ). Output Locations and Reading the Reports, previously at the very end, move up to right after the run step, and the sidecar-plugin concept (formerly §2) is merged into the authoring guide at §11. Header numbers and in-text cross-references are renumbered accordingly. No code or behavior change (docs only). ### 추가 / Added - **한 —** 비개발자 진입 보강 블록이 한국어·영어 정본에 1:1 로 추가됩니다 — 상단 목차 + 역할별 읽기 경로, 설치 사전 조건(Node.js 18+ · npm · 프로젝트 루트 터미널), "비개발자 5분 시작" 박스와 대시보드 여는 법(`open …/dashboard-*.html` · Windows `start` · 탐색기 더블클릭), 설정 가이드 머리말의 "(필수)" 의미 주석, FAQ 의 용어 풀이 표, `overview-for-stakeholders.md` 안내. - **EN —** Non-developer onboarding blocks are added 1:1 to both the Korean and English references — a top table of contents + role-based reading paths, installation prerequisites (Node.js 18+ · npm · terminal at the project root), a "Non-developer 5-minute start" box with how to open the dashboard (`open …/dashboard-*.html` · Windows `start` · double-click in the file explorer), a "(required)"-label clarification in the configuration-guide intro, a glossary table in the FAQ, and a pointer to `overview-for-stakeholders.md`. ### 참고 / Notes - 문서 전용 release. 측정 데이터 / baseline JSON shape / sub-key 명칭 / CLI 동작 모두 변경 없음. 정렬 라인 diff 로 레퍼런스 본문 무손실 확인. - Docs-only release. Measurement data, baseline JSON shape, sub-key names, and CLI behavior are all unchanged. Reference content verified intact via a sorted-line diff. - 영어 정본의 "지원 기술 스택" 섹션 누락(옛 비대칭)은 이번 범위 밖 — 다음 release 후보. - The missing "Supported Tech Stacks" section in the English reference (a pre-existing asymmetry) is out of scope here — a follow-up candidate. - `npm run typecheck` + `npm run build` 통과 / Verified. ## [0.8.6] — 2026-05-29 ### 정정 / Fixed - **한 —** dashboard summary 탭 "금지 CSS 클래스 (활용 횟수)" 카드 안 emph-row 정렬이 카운트 내림차순으로 정정됩니다. 옛 0.8.5 까지 매트릭스 정의 순서 그대로 노출 (예: tailwind-project = `Bootstrap utility` → `@apply-mixed` → `raw CSS`) 흐름이라 code 탭 ForbiddenSection / StylingMethodSection 의 카운트 내림차순 정렬 흐름과 어긋남. 0.8.6 부터 transformer (`baseline-to-summary-data.ts`) 안 `forbiddenByPreset` 배열 생성 시점에 카운트 내림차순 sort 적용 — code 탭 정렬 흐름 일관. - **EN —** The dashboard summary tab "금지 CSS 클래스 (활용 횟수)" card now sorts emph-rows by count descending. Through 0.8.5 the rows followed the matrix definition order (e.g. for tailwind-project: `Bootstrap utility` → `@apply-mixed` → `raw CSS`), out of step with the code-tab ForbiddenSection / StylingMethodSection which already sort by count. Starting with 0.8.6 the transformer (`baseline-to-summary-data.ts`) sorts `forbiddenByPreset` by count descending — consistent with the code tab. ### 참고 / Notes - 옛 0.8.5 출시 직후 hotfix patch. 측정 데이터 / baseline JSON shape / sub-key 명칭 / 매핑 정의 모두 변경 없음 — summary 탭 emph-row 정렬 흐름만 정정. - Hotfix patch following 0.8.5. Measurement data, baseline JSON shape, sub-key names, and mapping definitions are all unchanged — summary tab emph-row sort order only. - `npm run typecheck` + `npm run build` 통과 / Verified. ## [0.8.5] — 2026-05-29 ### 정정 / Fixed - **한 —** dashboard summary 탭 "금지 CSS 클래스" 카드가 preset 매트릭스 흐름 + 한글 라벨로 정정됩니다. 옛 0.8.4 까지 summary 카드 안 emph-row 2개 (`bootstrap-utilities` / `tailwind-classes`) 가 hard-code 로 노출 — preset 무관 흐름이라 tailwind-project 환경에서 `tailwind-classes` 가 의미 X 자리에 노출되고, emph-row 라벨도 영문 코드 키 직접 표시 (한글 라벨 적용 X). 옛 0.8.3 매트릭스 필터링 + 0.8.4 라벨 정정이 code 탭 한정 흐름이었음. 0.8.5 부터 summary 카드도 `FORBIDDEN_BY_PRESET` 매트릭스 + `FORBIDDEN_LABELS` 매핑 활용 — tailwind-project 환경 = `Bootstrap utility` / `@apply-mixed` / `raw CSS` 3 emph-row, scss-project = 4 emph-row, bootstrap / css-modules-project 도 각자 매트릭스 따라 결정. 카드 제목도 옛 `금지 CSS 클래스 개수` 에서 `금지 CSS 클래스 (활용 횟수)` 로 정정 — code 탭 일관 (occurrence 단위 명시). - **EN —** The dashboard summary tab "forbidden CSS class" card now uses preset-matrix flow + Korean labels. Through 0.8.4 the card emitted two hard-coded emph-rows (`bootstrap-utilities` / `tailwind-classes`) regardless of preset, so tailwind-project setups saw irrelevant rows and the labels showed raw English keys (no Korean mapping). The 0.8.3 matrix filtering + 0.8.4 label rename only covered the code tab. Starting with 0.8.5 the summary card also consumes `FORBIDDEN_BY_PRESET` + `FORBIDDEN_LABELS` — tailwind-project shows `Bootstrap utility` / `@apply-mixed` / `raw CSS` (3 rows), scss-project 4 rows, bootstrap / css-modules-project follow their own matrix. The card title is also updated from `금지 CSS 클래스 개수` to `금지 CSS 클래스 (활용 횟수)` to match the code-tab convention (explicit occurrence unit). ### 변경 / Changed - **한 —** `SummaryTabData` 안 옛 derived field (`forbiddenBootstrap` / `forbiddenTailwind`) 가 폐기되고 신규 `forbiddenByPreset` 배열 필드 1개로 통일됩니다. transformer (`baseline-to-summary-data.ts`) 가 preset 매트릭스 + 라벨 매핑 결과를 미리 build, JSX 는 단순 map 흐름. dashboard HTML inject 자체로 활용되는 derived field 라 외부 분석 도구에 영향 X (baseline JSON shape 자체는 그대로). - **EN —** The legacy derived fields (`forbiddenBootstrap` / `forbiddenTailwind`) on `SummaryTabData` are dropped in favour of a single `forbiddenByPreset` array. The transformer (`baseline-to-summary-data.ts`) precomputes the matrix + label mapping result so JSX is a simple `.map`. These fields only feed dashboard HTML; downstream analysis tooling that reads baseline JSON is unaffected. - **한 —** preset 매트릭스 + 라벨 매핑 정의가 transformer (TS) 와 code-tab.jsx (babel-inline) 두 곳에 중복 정의됩니다 — babel-inline jsx 가 ESM import 흐름이 아니라 자연스러운 중복. 다음 release 에서 통합 흐름 결정 가능 (예: `shell.ts` 안 `window.__FORBIDDEN_META` inject 활용). - **EN —** The preset matrix and label mapping are duplicated in two places — the TS transformer and `code-tab.jsx` (babel-inline). The duplication is acceptable for now because the inline JSX cannot use ESM imports; a follow-up release may consolidate them (e.g. injecting `window.__FORBIDDEN_META` from `shell.ts`). ### 참고 / Notes - 옛 0.8.4 출시 직후 hotfix patch. 측정 데이터 / baseline JSON shape / sub-key 명칭 모두 변경 없음 — summary 탭 렌더링 정정 + transformer 안 derived field 정리. - Hotfix patch following 0.8.4. Measurement data, baseline JSON shape, and sub-key names are all unchanged — summary tab render fix plus derived-field tidy-up in the transformer. - `npm run typecheck` + `npm run build` 통과 / Verified. ## [0.8.4] — 2026-05-29 ### 정정 / Fixed - **한 —** dashboard 두 카드의 metric 단위가 카드 제목에 명시됩니다 — 금지 CSS 클래스 카드는 활용 횟수 (occurrence) 단위 (`forbiddenClassCount.byId` = `forbiddenOccurrences`), 스타일링 방식 분포 카드는 영향 코드 파일 수 단위 (`stylingMethodDistribution.counts.forbidden` = `forbiddenFileCounts`) — 같은 sub-key id 가 두 카드에서 다른 metric 으로 노출되던 흐름이 옛 0.8.0 도입 시점부터 의도된 설계였으나 단위 명시가 없어 사용자 혼동을 유발했습니다. 새 카드 제목 — `금지 CSS 클래스 (활용 횟수)` / `스타일링 방식 분포 (영향 코드 파일 수)`. - **EN —** Metric units are now spelled out in the card titles. The forbidden CSS class card surfaces occurrence counts (`forbiddenClassCount.byId` = `forbiddenOccurrences`), while the styling-method-distribution card surfaces file counts (`stylingMethodDistribution.counts.forbidden` = `forbiddenFileCounts`). The two cards have always shown different metrics for the same sub-key id (by design since 0.8.0), but the lack of explicit unit labels confused users. New titles — `금지 CSS 클래스 (활용 횟수)` / `스타일링 방식 분포 (영향 코드 파일 수)`. - **한 —** 금지 CSS 클래스 카드 dist-row 의 두 줄 흐름 (한글 라벨 + 영문 mono) 이 한 줄 흐름으로 회귀합니다. 한글 라벨 (`Bootstrap utility`) 과 영문 mono (`(bootstrap-utilities)`) 가 거의 동일 흐름이라 시각 중복 — 한글 라벨 단독 표시로 정리. 스타일링 방식 분포 카드는 옛 두 줄 흐름 그대로 유지 (다른 카테고리 — allowed / forbidden / orphanClass / noClass — 가 섞여 영문 mono 식별자 역할 필요). - **EN —** The two-line dist-row layout in the forbidden CSS class card reverts to a single line. The Korean label (`Bootstrap utility`) and the mono key (`(bootstrap-utilities)`) read nearly identically, so the second line was visual redundancy. The styling-method-distribution card keeps the two-line layout (different categories — allowed / forbidden / orphanClass / noClass — mix in there, so the mono key still serves as an identifier). - **한 —** 금지 CSS 클래스 카드의 그룹별 분포가 preset 매트릭스 따라 필터링됩니다. 옛 흐름은 baseline JSON 안 `byId` 모든 sub-key 를 그대로 노출 — `analyzeStyling()` 안 forbidden / matrix sub-key 초기화 흐름이 preset 별 자동 필터링을 보장한다고 옛 0.8.3 분석에서 단정했으나, 실제로는 baseline JSON 안 다른 preset 의 sub-key 가 0 카운트로 그대로 남아 dashboard 에 잘못 노출되던 케이스가 있었습니다. 0.8.4 는 dashboard 표시 흐름에서 `FORBIDDEN_BY_PRESET` 매트릭스로 한 번 더 필터링 — baseline JSON raw key 는 옛 그대로 보존 (호환성 유지). - **EN —** Forbidden CSS class card group distribution now filters by preset matrix. Previously every sub-key under baseline JSON `byId` was rendered as-is. The 0.8.3 analysis claimed `analyzeStyling()` already pruned per-preset, but residual sub-keys from other presets could still leak in at zero counts and surface in the dashboard. 0.8.4 applies `FORBIDDEN_BY_PRESET` matrix filtering at the render layer too — raw keys in baseline JSON are unchanged (compatibility preserved). - **한 —** 스타일링 방식 분포 카드 row 위치가 카테고리 그룹으로 분리됩니다 — 측정 대상 (권장 방식 / 전역 허용 / 금지 sub-key) 가 위쪽, 측정 대상 X (className 없음 / 고아 클래스) 가 아래쪽. 그룹 안 카운트 내림차순. 옛 흐름 (전체 카운트 내림차순) 은 noClass / orphanClass 가 측정 대상 row 들과 섞여 측정 대상 / 측정 대상 X 경계가 흐려졌습니다. - **EN —** Styling-method-distribution card rows are now grouped by category — measured rows (preferred method / allowedGlobal / forbidden sub-keys) at the top, excluded rows (noClass / orphanClass) at the bottom. Sort by count is preserved within each group. The previous single-list sort caused noClass / orphanClass to land between measured rows, obscuring the boundary. - **한 —** 스타일링 방식 분포 카드의 cross-ref-pill 표기가 `분모: 527 (전체 코드 파일)` 에서 `전체 코드 파일: 527` 로 정정됩니다. 옛 표기 안 `분모` 가 `preferredCompliance` 계산식 안 `분모` 표기와 헷갈리던 흐름 해소. `preferredCompliance` fnote 안 `분모` 표기 자체는 옛 그대로 (계산식 분모 의미 정확). - **EN —** The cross-ref-pill in the styling-method-distribution card now reads `전체 코드 파일: 527` instead of `분모: 527 (전체 코드 파일)`. The previous wording conflicted with the `분모` (denominator) appearing in the `preferredCompliance` formula breakdown. The fnote's `분모` wording inside the formula is preserved (still accurate there). - **한 —** dashboard footer 의 버전 표기가 dsmonitor 패키지 버전과 자동 일관됩니다. 옛 `v0.1 · 2026-04-24` hard-code 가 `v · ` 형식으로 동적 결정 — shell.ts 안 `readDsMonitorMeta()` 가 패키지 자체의 `package.json` 을 read 해 `window.__DSMONITOR_META` 로 inject. release 시점 자동 갱신. - **EN —** The dashboard footer version label now auto-syncs with the dsmonitor package version. The hard-coded `v0.1 · 2026-04-24` becomes `v · ` — `shell.ts`'s `readDsMonitorMeta()` reads the package's own `package.json` and injects `window.__DSMONITOR_META`. Updates automatically on every release. ### 변경 / Changed - **한 —** matrix forbidden sub-key 명칭 변경 — `scss-modules` → `scss-imports`. 옛 명칭이 CSS Modules 흐름 (`.module.css`) 과 헷갈리던 점 정정. 본 sub-key 는 tailwind-project preset 안 SCSS 파일 import 자체를 금지하는 의도 (옛 preset 정의 안 영문 라벨 `SCSS / Sass imports` 와 일관). **옛 baseline 호환 X** — 옛 baseline 안 `scss-modules` 카운트는 새 baseline 안 `scss-imports` 자리로 직접 비교 X. 옛 preset 정의 흐름이 `classPatterns: []` 빈 정의라 실제 카운트는 0 — 영향 LOW. - **EN —** The matrix forbidden sub-key is renamed — `scss-modules` → `scss-imports`. The previous name collided with CSS Modules (`.module.css`); the sub-key in tailwind-project preset is about banning SCSS file imports outright (matches the preset's existing English label `SCSS / Sass imports`). **Breaking for 0.8.3 baselines** — `scss-modules` counts cannot be directly compared to `scss-imports` in 0.8.4. Impact is low since the preset's empty `classPatterns: []` produced zero counts in practice. - **한 —** README 안 도입성 표현이 일반 설명 (`DSMonitor`) 으로 정정됩니다 — README 두 정본 (한국어 / 영어) 의 제목 (`# DSMonitor`) + 도입문 4곳. 코드 기반 (CLI / 패키지명 / `dsmonitor.config.ts` / 파일 경로 / import 등) 안 lowercase `dsmonitor` 는 옛 그대로 보존 (실제 코드 흐름과 일관). - **EN —** README introductory copy switches to `DSMonitor` (general phrasing) — title (`# DSMonitor`) and four intro sentences across both references (Korean / English). Code-grounded references (CLI, package name, `dsmonitor.config.ts`, file paths, imports) keep the lowercase `dsmonitor` (matching actual code usage). ### 옛 사용자 영향 / Migration notes - **한 —** `scss-modules` → `scss-imports` 명칭 변경으로 옛 baseline 호환 X. 옛 baseline 안 `scss-modules` 카운트는 새 baseline 안 `scss-imports` 자리로 직접 비교 X. 옛 preset 정의 흐름이 `classPatterns: []` 빈 정의라 실제 카운트는 0 — 새 baseline 측정 권장 (선택). - **EN —** The `scss-modules` → `scss-imports` rename breaks 0.8.3 baseline compatibility. Counts under `scss-modules` cannot be directly compared with `scss-imports` in 0.8.4. The preset's empty `classPatterns: []` made the actual counts zero in practice — re-measure is optional. ### 참고 / Notes - 옛 0.8.3 출시 직후 hotfix patch. 측정 데이터 변경 X — UI 정정 + sub-key 명칭 정정만. - Hotfix patch following 0.8.3. Measurement logic unchanged — UI fixes plus a sub-key rename. - `npm run typecheck` + `npm run build` 통과 / Verified. ## [0.8.3] — 2026-05-29 ### 정정 / Fixed - **한 —** dashboard 스타일링 방식 분포 카드의 forbidden row 가 preset 따라 필터링됩니다. 옛 0.8.2 까지 9 row 전수 hard-code 표시 흐름이라 tailwind-project 환경에서 의미 없는 row (`금지 (tailwind-classes)` / `금지 (Tailwind via wrapper)`) 가 항상 0 카운트로 노출되어 사용자 혼동을 유발했습니다. 0.8.3 부터 preset 별 의미 있는 forbidden sub-key 매트릭스 (`FORBIDDEN_BY_PRESET`) 따라 row 결정 — tailwind-project 안 `bootstrap-utilities` / `apply-mixed` / `raw-css`, scss-project 안 `bootstrap-utilities` / `tailwind-classes` / `apply-mixed` / `tailwind-via-wrapper`, bootstrap-project 안 `tailwind-classes` / `inline-styles`, css-modules-project 안 `bootstrap-utilities` / `tailwind-classes` / `global-css`. 매트릭스에 정의된 sub-key 는 카운트 0 이라도 row 노출 (preset 정의 흐름 존중 + 미래 확장 자동). 알 수 없는 preset 시점에 forbidden row 0 (fallback). baseline JSON 안 `byId` raw key 자체는 그대로 보존되어 옛 분석 도구 호환성에 영향이 없습니다. - **EN —** Dashboard styling-method-distribution card filters forbidden rows by preset. Through 0.8.2 the row array was hard-coded to nine rows regardless of preset, so tailwind-project setups always saw irrelevant rows (`금지 (tailwind-classes)` / `금지 (Tailwind via wrapper)`) sitting at zero, which caused confusion. Starting with 0.8.3 the rows come from a preset-keyed matrix (`FORBIDDEN_BY_PRESET`) — tailwind-project shows `bootstrap-utilities` / `apply-mixed` / `raw-css`, scss-project shows `bootstrap-utilities` / `tailwind-classes` / `apply-mixed` / `tailwind-via-wrapper`, bootstrap-project shows `tailwind-classes` / `inline-styles`, css-modules-project shows `bootstrap-utilities` / `tailwind-classes` / `global-css`. Sub-keys defined in the matrix render even at zero (respecting preset intent + future-proofing). Unknown presets fall back to no forbidden rows. Raw `byId` keys in baseline JSON are unchanged — downstream tooling is unaffected. ### 변경 / Changed - **한 —** dashboard `FORBIDDEN_LABELS` 매핑이 ForbiddenSection (금지 CSS 클래스 카드) + StylingMethodSection (스타일링 방식 분포 카드) 두 곳에서 공통 활용되도록 통합됩니다. 옛 5 entry (`bootstrap-utilities` / `tailwind-classes` / `apply-mixed` / `tailwind-via-wrapper` / `raw-css`) 가 8 entry 로 확장 — `inline-styles` (bootstrap-project) / `global-css` (css-modules-project) / `scss-modules` (tailwind-project) 가 추가됐고, StylingMethodSection 안 옛 hard-code 라벨 (`금지 (bootstrap-utilities)` / `금지 (tailwind-classes)`) 이 본 매핑 흐름을 활용해 한글 표현 (`금지 (Bootstrap utility)` / `금지 (Tailwind utility)`) 으로 정정됩니다. 코드 중복 제거. - **EN —** The `FORBIDDEN_LABELS` mapping is now shared between the ForbiddenSection (forbidden CSS class card) and the StylingMethodSection (styling-method-distribution card). The mapping grows from 5 entries to 8 — adding `inline-styles` (bootstrap-project), `global-css` (css-modules-project), and `scss-modules` (tailwind-project). Hard-coded English-id labels in StylingMethodSection (`금지 (bootstrap-utilities)` / `금지 (tailwind-classes)`) are replaced with the mapped Korean phrasing (`금지 (Bootstrap utility)` / `금지 (Tailwind utility)`). - **한 —** ForbiddenSection (금지 CSS 클래스 카드) 그룹별 분포 dist-row 의 label 컬럼 width 가 StylingMethodSection 과 동일한 220px 로 통일됩니다 (옛 110px → 220px). 두 카드 안 한글 라벨 첫 줄 + 영문 mono 두 번째 줄 정렬 흐름이 균일. - **EN —** The ForbiddenSection (forbidden CSS class card) group-distribution dist-row label column is widened to 220px to match StylingMethodSection (was 110px). Both cards now align the Korean label + mono machine key pair consistently. ### 참고 / Notes - 옛 0.8.2 출시 직후 hotfix patch. 측정 데이터 / baseline JSON shape / sub-key 명칭 모두 변경 없음 — UI 렌더링 정정만. - Hotfix patch following 0.8.2. Measurement data, baseline JSON shape, and sub-key names are all unchanged — render-layer only. - `npm run typecheck` + `npm run build` 통과 / Verified. ## [0.8.2] — 2026-05-28 ### 정정 / Fixed - **한 —** dashboard 스타일링 방식 분포 카드의 dist-row 와 금지 CSS 클래스 그룹별 분포 카드의 dist-row 가 두 줄 흐름으로 정정됩니다. 옛 0.8.1 까지 한글 라벨 + 영문 mono 가 한 줄에 spread 되던 흐름이 좁은 label 컬럼 (110px / 220px) 에서 줄바꿈 깨짐 — 한글 끝 부분 줄 끝 + 영문 mono `(...)` 부분이 다음 줄 시작으로 어색하게 끊기던 시각 부조화 정정. 0.8.2 부터 한글 라벨이 첫 줄, 영문 mono 가 두 번째 줄 (작게) 로 명시 두 줄. row 높이가 약간 ↑ (대략 10px → 26px) 합니다. CSS `align-items: center` 그대로 유지 — dbar / count 가 두 줄 라벨의 가운데와 자연스럽게 정렬. MigrationSection dist-row (컴포넌트별 분포) 와 TotalsSection 표 (파일 집계) 는 옛 흐름 그대로 유지 — MigrationSection 은 영문 mono 병기 흐름 자체가 없고, TotalsSection 은 한글 + 영문 mono 가 한 줄에 들어가 줄바꿈 risk 가 낮습니다. - **EN —** Dist-rows in the styling-method-distribution card and the forbidden-CSS-class group distribution card now use a two-line layout. Through 0.8.1 the Korean label and the mono machine key sat on one spread line, which wrapped awkwardly inside the narrow label column (110px / 220px) — the mono `(...)` portion broke onto the next line out of alignment with the rest of the row. 0.8.2 puts the Korean label on the first line and the mono key on a smaller second line. Row height grows slightly (≈ 10px → 26px). `align-items: center` is preserved so the dbar / count are vertically centred against the two-line label. MigrationSection dist-rows (component breakdown) and the TotalsSection table (file totals) keep their existing layout — MigrationSection has no mono pairing, and TotalsSection fits its label + mono on one line without wrapping. - **한 —** dashboard 스타일링 방식 분포 카드의 옛 안내 텍스트 (`orphanClass` / `noClass` / `allowedGlobal` 설명 fnote) 가 제거됩니다. 옛 안내 텍스트는 옛 0.8.0 라벨 한글화 (`고아 클래스 (정의 못 찾음)` / `className 없음 (스타일 안 씀)` / `전역 허용`) 와 옛 0.8.1 신규 sub-key 한글 설명 dist-row 추가로 정보가 이미 라벨 자체에 흡수된 상태였습니다. 안내 텍스트 안 "SCSS 정의를 찾을 수 없는" 표현이 preset 이 tailwind 인 환경에서 부정확한 점, "앤 전역 CSS 클래스" 의 typo 도 함께 정리됩니다. - **EN —** The legacy informational fnote in the styling-method-distribution card (describing `orphanClass` / `noClass` / `allowedGlobal`) is removed. With the 0.8.0 Korean label rename (`고아 클래스 (정의 못 찾음)` / `className 없음 (스타일 안 씀)` / `전역 허용`) and the 0.8.1 description rows for the new sub-keys, the fnote was redundant — its "SCSS 정의를 찾을 수 없는" wording was also inaccurate in tailwind preset setups, and a Korean typo ("앤 전역 CSS 클래스") got cleaned up along the way. - **한 —** dashboard 안 SCSS 단어 활용 4곳이 preset 무관 표현으로 정정됩니다 — (1) 고아 클래스 샘플 Disclosure summary "SCSS 정의 못 찾은 className" → "정의 못 찾은 className", (2) ScssSection 카드 제목 "SCSS 변수 준수율" → "변수 준수율", (3) Summary Layer 01 / Code 설명 "SCSS · TS · DS 사용 규칙" → "스타일 · TS · DS 사용 규칙", (4) StylingMethodSection fnote "분자: SCSS + allowedGlobal" → "분자: 권장 방식 + allowedGlobal" (preset 무관 단순화). preset 이 tailwind / scss / bootstrap / css-modules 중 어느 흐름이든 표현이 자연스럽습니다. `id="scss"` / `field="scssVariableCompliance"` machine key + `ScssSection` 코드 식별자 는 옛 그대로 보존 (사용자 노출 X / Tier 2 옛 규약 유지). - **EN —** Four user-facing "SCSS" references in the dashboard are reworded to preset-agnostic phrasing — (1) the orphan-class samples Disclosure summary drops "SCSS 정의 못 찾은" in favour of "정의 못 찾은", (2) the variable-compliance card title drops "SCSS" ("변수 준수율"), (3) the Summary Layer 01 / Code description leads with "스타일" instead of "SCSS", (4) the styling-method-distribution fnote uses "권장 방식" instead of the literal "SCSS". The phrasing now reads naturally whether the preset is tailwind / scss / bootstrap / css-modules. Machine keys (`id="scss"` / `field="scssVariableCompliance"`) and the `ScssSection` code identifier are preserved (Tier 2 — not user-facing). ### 참고 / Notes - 옛 0.8.1 출시 직후 hotfix patch. 측정 데이터 / baseline JSON shape / sub-key 명칭 모두 변경 없음 — UI 렌더링 정정만. - Hotfix patch following 0.8.1. Measurement data, baseline JSON shape, and sub-key names are all unchanged — render-layer only. - `npm run typecheck` + `npm run build` 통과 / Verified. ## [0.8.1] — 2026-05-28 ### 정정 / Fixed - **한 —** Tailwind utility detect 정규식이 보강되어 `mr-auto` / `space-y-6` / `text-xs` / `font-bold` / `rounded-md` / `shadow` / `hidden` / `hover:bg-blue-500` / `sm:flex` / `dark:bg-zinc-900` / `-mt-4` / `w-[200px]` / `text-[#fff]` 같은 흔한 utility 가 모두 매치됩니다. 옛 0.8.0 이하 정규식은 좁은 union (`(?:m|p)-\d+`) 형태라 위 케이스가 detect 누락되어 tailwind-project 환경에서 정상 활용이 orphanClass 로 잘못 카운트되거나, scss-project 환경에서 금지 카운트가 누락되는 false negative 가 있었습니다. 0.8.1 부터 `presets/_tailwind-detect.js` 공통 helper 가 Tailwind v3 / v4 utility prefix 전수 + literal + variant prefix (응답형 / 상태 / dark / aria) + 음수 + arbitrary value 를 한 흐름으로 매치합니다. 4 preset (tailwind / scss / bootstrap / css-modules) 모두 본 helper 활용. - **EN —** The Tailwind utility detect regex is widened so common utilities such as `mr-auto`, `space-y-6`, `text-xs`, `font-bold`, `rounded-md`, `shadow`, `hidden`, `hover:bg-blue-500`, `sm:flex`, `dark:bg-zinc-900`, `-mt-4`, `w-[200px]`, `text-[#fff]` all match. Through 0.8.0 the regex was a narrow union (`(?:m|p)-\d+`) and missed these cases, causing legitimate Tailwind usage in tailwind-project setups to be mis-bucketed as orphanClass and forbidden counts in scss-project setups to underreport. Starting with 0.8.1 the shared `presets/_tailwind-detect.js` helper matches the full Tailwind v3 / v4 utility prefix set + literals + variant prefixes (responsive / state / dark / aria) + negatives + arbitrary values. All four presets (tailwind / scss / bootstrap / css-modules) consume the helper. - **한 —** dashboard `preferredCompliance` 계산식 안 분자 / 분모 row 의 한글 설명이 `preferredId` 따라 동적 결정됩니다. 옛 0.8.0 까지는 `k === "scss"` hard-code 로 `"권장 (scss) 파일"` 표기가 박혀 있어 tailwind-project 환경에서 본 row 라벨이 빈 칸 노출되던 흐름 정정. 분모 row 의 옛 표현 (`"주 마이그레이션 대상"` / `"소수 (Phase B 대상)"`) 은 자명한 표현 (`"Bootstrap 잔재"` / `"Tailwind utility 잔재"`) 으로 정정되고, 0.8.0 도입 matrix 신규 sub-key (`apply-mixed` / `tailwind-via-wrapper` / `raw-css`) 의 한글 설명도 본 row 에 함께 표시됩니다. - **EN —** The Korean descriptions on numerator / denominator rows in the `preferredCompliance` breakdown are now derived from `preferredId`. Through 0.8.0 the code hard-coded `k === "scss"` so the row label appeared blank in tailwind-project setups. Denominator-row prose is also clarified (`"주 마이그레이션 대상"` → `"Bootstrap 잔재"`, `"소수 (Phase B 대상)"` → `"Tailwind utility 잔재"`), and the 0.8.0 matrix sub-keys (`apply-mixed` / `tailwind-via-wrapper` / `raw-css`) gained their own descriptions on this row. - **한 —** dashboard 안 dist-row + 파일 집계 표 안 영문 key 노출이 정정됩니다 — 한글 라벨을 주로 두고 영문 mono key 를 작게 병기. 영향 위치 3곳 — 금지 CSS 클래스 그룹별 분포 (옛 preset id 만 노출), 파일 집계 표 (옛 2 컬럼 `필드` / `설명` 분리 → 1 컬럼 합병), 스타일링 방식 분포 dist-row. baseline JSON 안 raw key 는 그대로 보존되어 옛 분석 도구 호환성 영향이 없습니다. - **EN —** Dist-row labels and the totals card table now lead with the Korean label and append the machine key in a smaller mono tag. Three affected spots — forbidden CSS class group distribution (previously displayed the raw preset id), the totals table (collapses the previous two-column `필드` / `설명` layout into a single column), and the styling-method-distribution dist-row. Raw keys in baseline JSON are unchanged — downstream analysis tooling is unaffected. - **한 —** dashboard `preferredCompliance` 계산식 disclosure summary 와 formula title 에 한글 주제어가 병기됩니다 (`"권장 방식 준수율 (preferredCompliance) 계산식"`). 옛 mono 영문 단독 표기 흐름 정정. - **EN —** The disclosure summary and formula title for the `preferredCompliance` breakdown now show the Korean topic alongside the mono key (`"권장 방식 준수율 (preferredCompliance) 계산식"`). Previously only the mono key was shown. ### 변경 / Changed - **한 —** matrix forbidden sub-key 명칭 변경 — `scss-style-raw-css` → `raw-css`. 옛 명칭이 길고 "scss-style" 단어가 박혀있어 tailwind-project 환경과 혼동되던 흐름 정정. **옛 0.8.0 baseline 호환 X** — 0.8.0 baseline 안 `scss-style-raw-css` 카운트는 0.8.1 baseline 안 `raw-css` 자리로 직접 비교 X. 0.8.0 출시 직후 hotfix 라 영향 LOW. 새 baseline 측정 흐름으로 정정 완료. - **EN —** The matrix forbidden sub-key is renamed — `scss-style-raw-css` → `raw-css`. The previous name was long and the `scss-style` token caused confusion in tailwind-project setups. **Breaking for 0.8.0 baselines** — counts under `scss-style-raw-css` in a 0.8.0 baseline cannot be directly compared to `raw-css` in 0.8.1. Impact is low (0.8.1 ships immediately after 0.8.0). Re-measure to get a clean baseline. ### 옛 사용자 영향 / Migration notes - **한 —** Tailwind detect 보강으로 tailwind-project 환경에서 옛 orphanClass 로 잡혔던 정상 utility 가 `allowed.tailwind` 로 이동합니다. 본 결과 = orphanClass 감소 / allowed.tailwind 증가 / preferredCompliance % 변동 예상. scss-project 환경에서는 옛 누락 utility 가 새로 `forbidden.tailwind-classes` 로 잡혀 금지 카운트가 증가할 수 있습니다. portal-iris-web 외 다른 사용자 환경에서도 같은 흐름 — 0.7.x 이하 baseline 과 0.8.1 baseline 수치 직접 비교 X. 0.8.1 baseline 을 새 기준선으로 활용 권장. - **EN —** Wider Tailwind detect moves legitimate utilities previously bucketed as orphanClass into `allowed.tailwind` in tailwind-project setups — expect orphanClass to drop, `allowed.tailwind` to rise, and `preferredCompliance` to shift. In scss-project setups, utilities previously missed are newly counted as `forbidden.tailwind-classes`, so the forbidden count may rise. Do not compare 0.7.x baselines (or 0.8.0 baselines) directly with 0.8.1; treat 0.8.1 as a fresh reference. - **한 —** 0.8.0 baseline 사용자는 `scss-style-raw-css` → `raw-css` 명칭 변경 영향 — 옛 baseline 안 카운트와 0.8.1 baseline 안 카운트 직접 비교 X. 새 baseline 측정 권장. - **EN —** Users with a 0.8.0 baseline are affected by the `scss-style-raw-css` → `raw-css` rename — counts in 0.8.0 cannot be directly compared with 0.8.1. Re-measure to refresh the baseline. ### 참고 / Notes - 옛 0.8.0 출시 직후 hotfix patch. baseline JSON shape 안 옛 sub-key (`bootstrap-utilities` / `tailwind-classes` / `apply-mixed` / `tailwind-via-wrapper`) 는 그대로 보존, `scss-style-raw-css` → `raw-css` 단일 명칭 정정만. - Hotfix patch following 0.8.0 (released the same day). The baseline JSON shape keeps existing sub-keys; only `scss-style-raw-css` is renamed to `raw-css`. - `npm run typecheck` + `npm run build` 통과 / Verified. ## [0.8.0] — 2026-05-28 ### 추가 / Added - **한 —** baseline JSON 안 `code.classDefinitions` section 이 신규 추가됩니다 (3 배열 — `pureApply` / `applyMixed` / `pureCss`). `globalStyleSources` glob 에 매치되는 모든 SCSS / CSS 파일을 파싱해 각 클래스 정의 내용을 `@apply` directive 와 일반 CSS property 의 조합으로 분류한 결과입니다. 같은 className 이 여러 rule (예: light / dark theme) 에 등장하면 첫 정의를 우선 보존하고 분류는 OR 통합합니다 — 한 rule 라도 `@apply` 와 일반 CSS property 가 섞이면 전체를 `applyMixed` 로 격상. 본 결과 자체는 dashboard 에 별도 카드로 노출되지 않고, 아래 `forbiddenClassCount` 및 `stylingMethodDistribution` 의 matrix 산정 입력으로 활용됩니다. - **EN —** A new `code.classDefinitions` section (`pureApply` / `applyMixed` / `pureCss` arrays) is added to baseline JSON. All SCSS / CSS files matched by `globalStyleSources` are parsed and every class definition is categorised by whether it contains `@apply` directives, regular CSS properties, or both. When the same className appears in multiple rules (e.g. light / dark theme), the first definition wins for ordering and the categorisation is OR-merged — a single rule mixing `@apply` with regular CSS escalates the whole entry to `applyMixed`. The section is not surfaced as a dedicated dashboard card; it feeds the matrix used by `forbiddenClassCount` and `stylingMethodDistribution`. - **한 —** `forbiddenClassCount.byId` 와 `stylingMethodDistribution.counts.forbidden` 에 matrix 산정으로 검출되는 신규 sub-key 가 추가됩니다 — `apply-mixed` (두 preset 공통), `tailwind-via-wrapper` (scss-project 한정), `scss-style-raw-css` (tailwind-project 한정). 옛 sub-key (`bootstrap-utilities`, `tailwind-classes`) 는 그대로 보존되어 옛 분석 도구 호환성에 영향이 없습니다. dashboard 의 스타일링 방식 분포 카드 안 신규 row 는 tooltip 으로 위반 사유가 preset 기준으로 표시됩니다. - **EN —** `forbiddenClassCount.byId` and `stylingMethodDistribution.counts.forbidden` gain new sub-keys driven by the matrix — `apply-mixed` (both presets), `tailwind-via-wrapper` (scss-project only), `scss-style-raw-css` (tailwind-project only). Existing sub-keys (`bootstrap-utilities`, `tailwind-classes`) are preserved so downstream analysis tooling remains compatible. The new rows in the styling-method-distribution card surface a preset-specific reason via tooltip. ### 변경 / Changed - **한 —** `stylingMethodDistribution` 산정 흐름이 matrix 기반으로 갱신됩니다. preset 의 `preferred` 가 `scss` 또는 `tailwind` 일 때 한정해, 옛 `allowedGlobal` 로 분류되던 파일 가운데 사용 중인 global class 의 정의가 (1) `applyMixed` 면 모든 preset 에서 금지 (`apply-mixed`), (2) `pureApply` 면 scss-project 에서 금지 (`tailwind-via-wrapper`) / tailwind-project 에서 정상, (3) `pureCss` 면 scss-project 에서 정상 / tailwind-project 에서 금지 (`scss-style-raw-css`) 로 재분류됩니다. 한 파일이 여러 case 에 걸치는 경우 worst-first 우선순위로 결정됩니다. `preferred` 가 그 외 (`bootstrap` / `css-modules`) 인 경우 옛 흐름이 그대로 보존됩니다. - **EN —** `stylingMethodDistribution` now uses a matrix-based classification. Only when the preset's `preferred` is `scss` or `tailwind`, files previously bucketed as `allowedGlobal` are re-checked against the definition type of the global classes they use: (1) `applyMixed` is forbidden in both presets (`apply-mixed`), (2) `pureApply` is forbidden in scss-project (`tailwind-via-wrapper`) but allowed in tailwind-project, (3) `pureCss` is allowed in scss-project but forbidden in tailwind-project (`scss-style-raw-css`). Files matching multiple cases resolve worst-first. Other `preferred` values (`bootstrap` / `css-modules`) keep the legacy flow as-is. - **한 —** dashboard Code 탭 카드 순서가 테마별 그룹화 흐름으로 재정렬됩니다 — scope 개요 (파일 집계 / DS 커버리지) → 마이그레이션 (마이그레이션 후보 파일 / TypeScript 마이그레이션) → CSS 컴플라이언스 (금지 CSS 클래스 / 스타일링 방식 분포) → 변수 + 색상 (SCSS 변수 준수율 / 하드코딩 색상). 카드 자체 본문 / 데이터는 변경 X. - **EN —** Code-tab card order is regrouped by theme — scope overview → migration → CSS compliance → variables + colors. Card bodies and data are unchanged. - **한 —** dashboard 안 일부 한글 라벨이 정정됩니다 — 스타일링 방식 분포 카드 안 권장 방식 row 라벨은 `preferredId` 따라 동적 결정 (옛 "권장 (scss)" hard-code 정정), 고아 클래스 라벨은 preset 무관 표현으로 "고아 클래스 (정의 못 찾음)" (옛 "SCSS 정의 못 찾음" 정정). 옛 분석 도구가 활용하는 baseline JSON 안 machine key (`allowedGlobal`, `noClass`, `forbidden.*` 등) 는 그대로 보존됩니다. - **EN —** A few Korean dashboard labels are corrected — the "preferred" row label in the styling distribution card is now derived from `preferredId` (replacing the hard-coded `"권장 (scss)"`), and the orphan-class label is preset-agnostic (`"고아 클래스 (정의 못 찾음)"`, dropping the misleading "SCSS"). The machine keys in baseline JSON (`allowedGlobal`, `noClass`, `forbidden.*`, etc.) are unchanged. - **한 —** `dsmonitor init` 으로 생성되는 `dsmonitor.config.ts` 템플릿이 정리됩니다 — 변수명을 `stylingPolicy` 로 통일하고 (config key 와 동일), preset 선택을 import 한 줄 교체로 마무리하도록 shorthand 화 (`stylingPolicy: scssPreset` → `stylingPolicy,`). 옛 0.7.3 의 ESM 호환 흐름은 그대로 유지됩니다. - **EN —** The `dsmonitor.config.ts` template emitted by `dsmonitor init` is tidied — the imported preset is now bound to the variable `stylingPolicy` (matching the config key), and the policy line is shortened to `stylingPolicy,` so switching presets is a one-line import swap. The 0.7.3 ESM compatibility behavior is preserved. - **한 —** `presets/scss-project.js` 주석과 README 안 preset 설명이 정정됩니다 — preset 명칭은 "scss" 지만 `.css` 만 활용하는 React + CSS files 환경 / 혼합 환경 모두 적용된다는 점이 명시됩니다. README 안 옛 `stylingPolicy: require("dsmonitor/presets/...")` 흔적은 ESM `import` 형식으로 일괄 교체됩니다 (한국어 / 영어 정본 1:1). - **EN —** `presets/scss-project.js` and the matching README entry are revised to make clear that the preset covers class-based CSS / SCSS broadly — both `.css`-only React projects and SCSS projects fit. Remaining `stylingPolicy: require("dsmonitor/presets/...")` snippets in the README are replaced with the ESM `import` form (Korean / English mirrored). ### 정정 / Fixed - **한 —** dashboard 안 분모 0 케이스 (예: Figma DS 파일 안 styles=0 / variables=0 / tsFiles + jsFiles=0 / forbidden 전체 0건 등) 에서 `NaN%` 로 표시되던 카드들이 `0.0%` 로 정정됩니다. 영향 카드 — DS 토큰 매칭률 (Styles) (root.jsx), DS 토큰 매칭률 (Styles + Variables) (figma-tab.jsx, primary + DS 별 row), 금지 CSS 클래스 그룹 분포 (code-tab.jsx), 스타일링 방식 분포 카운트 (code-tab.jsx), 하드코딩 색상 상위 파일 점유 (code-tab.jsx), TypeScript 마이그레이션 카드 (code-tab.jsx). 측정 데이터 자체에는 영향이 없고 렌더링 layer 에만 영향이 있습니다. - **EN —** Dashboard cards that previously rendered `NaN%` when a denominator was zero (e.g. Figma DS file with `styles=0` / `variables=0`, `tsFiles + jsFiles = 0`, total forbidden count = 0) now render `0.0%`. Affected cards — DS token match rate (Styles, in root.jsx), DS token match rate (Styles + Variables, primary + per-DS rows in figma-tab.jsx), forbidden CSS class group distribution (code-tab.jsx), styling-method-distribution counts (code-tab.jsx), top-file share of hardcoded colors (code-tab.jsx), TypeScript migration card (code-tab.jsx). No measurement data changes — render-layer only. ### 옛 사용자 영향 / Migration notes - **한 —** matrix 산정 도입으로 `scss-project` / `tailwind-project` 환경에서 옛 baseline 의 `forbiddenClassCount` / `stylingMethodDistribution` 수치와 0.8.0 수치가 어긋날 수 있습니다 — 의도된 변경 (측정 로직 정확도 ↑). 0.7.x 이하 baseline 과 0.8.0 baseline 수치를 직접 비교하지 말고, 0.8.0 baseline 을 새 기준선으로 활용하시기 바랍니다. tailwind-project 환경에서는 raw CSS 클래스가 새로 금지로 잡혀 금지 카운트가 증가할 수 있고, scss-project 환경에서는 pure-@apply wrapper 가 새로 금지로 잡혀 금지 카운트가 증가할 수 있습니다. `preferred` 가 `bootstrap` / `css-modules` 인 환경은 옛 흐름 그대로 — 수치 변경 없습니다. - **EN —** With the new matrix in place, `forbiddenClassCount` / `stylingMethodDistribution` values may diverge from prior baselines in `scss-project` / `tailwind-project` setups — this is intended (more accurate measurement). Do not compare 0.7.x and 0.8.0 baseline numbers directly; treat the 0.8.0 baseline as the new reference. In tailwind-project setups, raw CSS classes may newly count as forbidden; in scss-project setups, pure-`@apply` wrappers may newly count as forbidden. `preferred = bootstrap` / `css-modules` setups are unaffected. ### 참고 / Notes - 0.x.x 유연성을 활용한 minor release — matrix 산정 도입은 측정 의미를 갱신하는 변경입니다. baseline JSON shape 자체는 옛 key 보존 + 신규 key 추가 흐름 (옛 분석 도구 호환). - A minor release that updates the meaning of existing metrics. baseline JSON shape preserves prior keys and only adds new ones (compatible with existing analysis tooling). - `npm run typecheck` + `npm run build` 통과 / Verified. ## [0.7.3] — 2026-05-28 ### 정정 / Fixed - **한 —** `dsmonitor init` 으로 생성되는 `dsmonitor.config.ts` 템플릿 안 `stylingPolicy: require("dsmonitor/presets/scss-project")` 호출이 ESM static import 로 교체되었습니다. dsmonitor cli 는 user config 를 `tsx/esm/api` 로 load 하기 때문에 `"type": "module"` 프로젝트는 항상 ESM context 로 평가되며, 옛 표기는 `ReferenceError: require is not defined` 로 실패했습니다. 0.7.3 부터 템플릿 상단에 `import scssPreset from "dsmonitor/presets/scss-project.js"` 한 줄이 emit 되고, 4종 preset 선택 안내 주석도 ESM import 형식으로 정정됩니다. 옛 user config (이미 `init` 으로 생성된 파일) 안 `require()` 호출은 본 import 한 줄로 교체하면 옛 동작 그대로 복구됩니다. - **EN —** The `stylingPolicy: require("dsmonitor/presets/scss-project")` line in the `dsmonitor.config.ts` template emitted by `dsmonitor init` is now an ESM static import. The dsmonitor cli loads user configs through `tsx/esm/api`, so `"type": "module"` projects always evaluate the file as ESM, and the previous form threw `ReferenceError: require is not defined`. Starting with 0.7.3 the template emits `import scssPreset from "dsmonitor/presets/scss-project.js"` at the top and the four-preset selection comments are written in ESM import form. Existing user configs already produced by `init` can be fixed by replacing the `require()` call with the equivalent import line. - **한 —** `codeTokens.parsers` 안 `scss` / `cssVariables` 파서의 `files` 항목이 glob 패턴을 정식 지원합니다 (예: `["src/styles/**/*.css"]`). 0.7.2 까지는 entry 를 literal path 로 해석해 `globalStyleSources` 와 같은 경로를 등록한 환경에서도 `dsmonitor doctor` 가 `not found` 로 보고하고 audit 실행 시점에 `file_not_found` warning 이 발생했습니다. 0.7.3 는 `*`, `?`, `{`, `[` 가 포함된 entry 를 `fast-glob` 으로 확장해 매치된 파일만 파서에 전달합니다. literal path 흐름은 옛 동작 그대로 보존되고, glob match 0건은 옛 file_not_found 와 동일한 자리 (`dsmonitor doctor` 결과 + parser warning) 에 보고됩니다. - **EN —** `codeTokens.parsers` `scss` / `cssVariables` parsers now accept glob patterns in their `files` array (e.g. `["src/styles/**/*.css"]`). Through 0.7.2 each entry was treated as a literal file path, so setups that registered the same path as `globalStyleSources` would still be reported as `not found` by `dsmonitor doctor` and trigger `file_not_found` warnings during audit. 0.7.3 expands entries containing `*`, `?`, `{`, `[` via `fast-glob` and forwards only the matched files to the parser. Literal paths keep their existing behavior, and a glob with zero matches is reported in the same surfaces (`dsmonitor doctor` + parser warning). ### 참고 / Notes - 본 release 는 두 버그 수정에 한정된 patch 입니다. 외부 API / config schema 변경 X. - Patch release scoped to the two bug fixes — no public API or config schema changes. - `npm run typecheck` + `npm run build` 통과 / Verified. ## [0.7.2] — 2026-05-26 ### 추가 / Added - **한 —** `migrationCandidates.excludeOfficialPaths` 옵션이 신규 추가되었습니다 (default `true`). `designSystem.officialPaths` 에 매치되는 파일을 마이그레이션 후보 검출에서 자동으로 제외해, DS 본체 안에서 자연스럽게 쓰이는 native HTML (예: `Button.tsx` 가 내부에서 `