# Changelog

## 0.10.1

### Patch Changes

- f0e715b: Tighten the consumer ESLint icon gate so local SVG asset imports are flagged and teams are directed back to the published TVU icon exports.
- f0e715b: Add a design kickoff packet CLI that generates and checks the required pre-design quality contract before product mockup work starts.
- 6a6b6cc: Require a feedback UI inventory in design kickoff packets so feedback states are grouped by semantic class before checking component, sizing, spacing, icon, copy, and action consistency.

## 0.10.0

### Minor Changes

- 2026-06-12: **BREAKING: `PromptMessage` renamed to `Message`.** The Figma component set "prompt message" (node `1408:17153`) was renamed to "Message" and republished; the code is synced to keep the Figma↔code contract. The public component, its canonical wrapper, `app.component()` registration, docs page (`message`), and exports are all now `Message`. Consumers must update imports (`import { Message } from '...'`) and tag usage (`<Message />`). Pre-1.0 breaking → minor per this changelog's convention.
- 2026-06-12: **`Message` warning-state sample copy de-"prompt".** The warning fallback strings previously read "This is a prompt message and …"; they now read "This is a warning message and …" so the placeholder copy names the status, not the old component name.
- 2026-06-12: Cross-reference — `Message` is the lightest non-blocking transient feedback (top status line that fades); for richer/blocking patterns see `Notification` (toast / dialog / alert / pop confirm).
- 2026-06-12: **BREAKING: `Notification` `type` values renamed** to match the republished Figma set (`1408:17154`): `secondary warning` → `danger`, and `none` → `default`. Consumers passing those literals must update (`type="danger"`, `type="default"`; `default` is the prop default).
- 2026-06-12: **`Notification` Confirm/OK color is now type-driven.** Red for `error` and `danger` (danger = destructive confirmation); brand green for `default` / `info` / `warning` / `success`. Previously red was keyed off form (`pop confirm` + `dialog/none`); a `pop confirm` / `dialog` now goes red only via `type="danger"`.
- 2026-06-12: **`Notification` gains `dialog` × `success` and `pop confirm` × `danger` variants** (set is now 36 members, was 32).
- 2026-06-12: `Notification` `slide` form restructured to the shared `[icon | title + description]` layout so the description indents under the title (matches dialog / alert); all variants now hug height (content-adaptive); the content↔button gap is unified to `Basic Size/#32` (was 40 / 24).

## 0.9.0

### Minor Changes

- 2ab5356: **Fix: design tokens are now actually shipped in `dist/style.css`.** Previously `src/index.ts` never imported `src/tokens/variables.css`, so the published `style.css` contained only component `var(--token)` _references_ — none of the `:root` token _definitions_, theme blocks, or `@font-face` rules. Consumers following GETTING_STARTED §3 (`import '@nancyzeng0210/tvu-design-system/style.css'`) got unstyled components because no token resolved. This gap existed in every release through v0.8.0 and went unnoticed because reference adoption only exercised the ESLint plugin, never a real component render in a consumer app.

  `src/index.ts` now imports the token tier, so `dist/style.css` includes the full `:root` token set, `[data-theme=light]` theme, and the TopBar clock `@font-face` (Digital Numbers, inlined). A single `import '.../style.css'` now resolves all tokens, themes, and the clock font in consumer products — as the docs already promised.

- 2ab5356: **TopBar timezone clock now renders in the Figma "Digital Numbers" seven-segment font.** Adds a new `--font-family-clock` token and self-hosts the original **Digital Numbers** typeface (by Stephan Ahlf, SIL OFL 1.1 — github.com/s-a/digital-numbers-font), the same font the Figma source uses. The docs TopBar clock previously fell back to the system sans-serif because no `font-family` was set; it now matches Figma 1:1 (same font, color, size). Font files + license live in `src/tokens/fonts/`.
- 2ab5356: **TopBar: `showMenu` default changed `true` → `false`** to match the Figma component set (`Top bar` `4771:7173`), whose `Show Menu` boolean property defaults to `false`. The `showSearchBox` default (`false`) was already aligned.

  Behavioral change (0.x convention: breaking → minor): a `<TopBar>` with no explicit `show-menu` now hides the menu region by default. Consumers relying on the previous default to render their `#menu` slot must pass `show-menu` explicitly:

  ```vue
  <!-- before: menu showed by default -->
  <TopBar tag="After Login"><template #menu>…</template></TopBar>

  <!-- after: opt in explicitly -->
  <TopBar tag="After Login" show-menu><template #menu>…</template></TopBar>
  ```

  Rationale (owner-confirmed 2026-06-11): hiding the top menu by default reflects current product convention and the Figma source of truth. Also documents the two boolean props (`show-menu` / `show-search-box`) and the `search` slot in the TopBar API table, which were previously missing.

## 0.8.0

### Minor Changes

- ae9b0ba: Add `no-native-element` ESLint rule + CLI R15 audit check (G1 — code-side
  Library-First enforcement). Both flag hand-rolled native `<button>` / `<input>` /
  `<select>` / `<textarea>` in product code when the TVU DS ships an equivalent
  (Button / InputBox\* / SelectBox\*), directing consumers to the canonical
  component. `<input type="hidden|file">` and PascalCase DS components are not
  flagged. The rule is included in the plugin's `recommended` config (strict);
  escape via `<!-- LIBRARY GAP: ... -->` + an eslint-disable comment, or
  `// AUDIT-IGNORE-R15` for the CLI. Mirrors §R15 in code-conventions.md.
- ed510c6: Add `no-hardcoded-spacing` ESLint rule + CLI R2S audit check (G2 — spacing half
  of §R2 token discipline). Both flag hardcoded spacing/radius px that has a TVU
  token equivalent (e.g. `padding: 16px` → `var(--sp-m)`, `border-radius: 8px` →
  `var(--r-m)`), driving consumers to `var(--sp-*)` / `var(--r-*)`. False-positive
  discipline: a px is flagged ONLY when it sits in a spacing/radius property AND
  that exact value maps to a token — arbitrary px (1px borders, widths, font
  sizes, 10px/20px layout, 24px radius, 2px padding) is never flagged. The
  px↔token mapping is shared by the rule and the CLI (`eslint-plugin/spacing-token-map.js`)
  so they can't drift. Included in the plugin's `recommended` config; escape via an
  eslint-disable comment or `// AUDIT-IGNORE-R2S`. Also tightened the CLI's
  AUDIT-IGNORE matcher to a token boundary (so `R2` no longer matches `R2S`, nor
  `R1` match `R15`/`R16`).
- a9423de: **BREAKING — `Notification` flat `status` axis replaced by two-axis `form` × `type` + `closable` boolean.**

  > bump = `minor` per the repo's 0.x semver convention (breaking changes ship as
  > 0.x.0 minors — same as the v0.7.0 status-rename; `major`→1.0.0 is reserved for
  > the V1 stability promise gated by V1_RELEASE_CHECKLIST). Corrected from
  > `major` 2026-06-11.

  The Notification Figma library (set `1408:17154`) was republished (2026-06-10) as a 32-member two-axis model. The component API now mirrors it 1:1:

  - `form`: `'dialog' | 'alert' | 'pop confirm' | 'slide'` (interaction shape) — default `'dialog'`
  - `type`: `'warning' | 'secondary warning' | 'error' | 'info' | 'success' | 'none'` (severity / category icon) — default `'none'`
  - `closable`: `boolean` (close ✕ — Figma boolean component property) — default `true`

  Buttons are now **form-intrinsic** (no longer derived from status): `dialog` / `pop confirm` render Cancel + Confirm; the new `alert` form renders a single green **OK**; `slide` is a passive toast with no buttons. New `okText` prop for the alert label. Category icons follow a severity ladder: `warning` = orange (warning 2) < `secondary warning` = red triangle (Error 4) < `error` = red ✕ (Error 2).

  **Migration — replace `status` with `form` + `type`:**

  | old `status`                 | new props                                |
  | ---------------------------- | ---------------------------------------- |
  | `status="warning"`           | `form="dialog" type="warning"`           |
  | `status="secondary warning"` | `form="dialog" type="secondary warning"` |
  | `status="error"`             | `form="dialog" type="error"`             |
  | `status="info"`              | `form="slide" type="info"`               |
  | `status="pop confirm"`       | `form="dialog" type="none"`              |
  | `status="quick confirm"`     | `form="pop confirm" type="none"`         |
  | `status="side pop"`          | `form="slide" type="none"`               |

  `closable`, `cancelText`, `confirmText`, `theme`, `title`, `description` are unchanged. Events (`close` / `cancel` / `confirm`) are unchanged — `alert`'s OK button emits `confirm`. The previously code-only `success` value is now a first-class Figma-backed `type` (e.g. `form="slide" type="success"` / `form="alert" type="success"`).

### Patch Changes

- a806282: 新增 `pnpm export:claude-design-bundle`（`scripts/export-claude-design-bundle.mjs`）：导出自包含的 Claude Design bundle（claude.ai 端上传用的设计规范派生快照，默认输出到 repo 外 `~/Documents/AICoding/claude-design-bundle/`）。含组件目录 / affordance 语义层 / mockup conventions / design process / domain 规则 / 644-icon catalog（由 affordance-categories 浓缩生成）/ tokens / GETTING_STARTED + 生成的 README 阅读路由与 MANIFEST 来源对照。不影响组件 API 与运行时行为（scripts/ 随包发布，故记 patch）。
- f0faa32: Ship consumer-facing enforcement wiring (G3). The package now includes an
  `eslint.config.fragment.mjs` (spreads the recommended TVU rule layer, incl.
  `no-native-element`) and a `lint-staged.fragment.json` under
  `templates/consumer-product/`, plus a scenario-aware enforcement section in
  `docs/CONSUMER_AUDIT_SETUP.md`. Wiring is matched to the consumption scenario
  (§R7): greenfield = strict full-repo blocking; existing-product increment =
  changed-files-only via lint-staged + pre-commit (no legacy mass-flagging);
  visual-mirror = off. Closes the "config exists but never runs" silent-pass gap.
- adc183b: Add `audit:mockup-conformance` manual master switch (G4 手动总闸 — event-driven:
  runs at mockup delivery wrap-up and via consumer `audit:mockup`; the DS repo
  deliberately does not run it at commit time since no Figma artifact is committed
  here). A single
  `scripts/audit-mockup-conformance.mjs` entry point runs all five mockup audits
  (integrity / colors / typography-icon / library-binding / library-origin)
  against one Figma file and aggregates a single pass/fail. This wires in
  `audit-mockup-library-origin.mjs`, which previously had no npm script and never
  ran. Supports `--node` / `--lib` pass-through and `--non-blocking` for the
  场景 2 (existing-product increment) report-only mode. Consumer `audit:mockup`
  now points at this gate.
- c91e1bc: Fidelity fixes surfaced while dogfooding components in the docs:

  - **PopupBox**: footer Cancel/Save now use the canonical Button API (`canonical-style`/`canonical-color`) instead of removed legacy `variant`/`size` props that silently fell back to defaults — so Cancel (ghost/gray) is again visually distinct from Save (filling/green).
  - **Button**: owns the DS font (`--font-family-base`) instead of `inherit`, so it renders the correct typeface even when mounted outside the app font context (e.g. inside PopupBox's `<Teleport to="body">`).
  - **SelectBox (Filled/Line)**: the selected value / placeholder is now left-aligned. The trigger is a native `<button>` whose UA `text-align: center` was inheriting into the value; Figma left-aligns it.

- 206759f: Select & Input fidelity fixes:

  - **Select dropdown** now teleports to `<body>` with fixed positioning, so the
    option list is no longer clipped when a Select is rendered inside a
    scroll/overflow container such as PopupBox's modal body. Click-outside
    detection accounts for the teleported list, and the dropdown repositions on
    scroll/resize while open.
  - **Select dropdown font**: the teleported list now declares the DS font family
    on its root instead of relying on inherited context (it left the app's font
    scope once teleported to `<body>`), matching Button/PopupBox.
  - **Input disabled placeholder/text colors** now match Figma per state: the
    empty disabled placeholder binds `--text-disabled` (was incorrectly `--text-tips`),
    and the line `xl` textarea's disabled value binds `--text-disabled` while the
    filled textarea keeps `--text-tips`.

## 0.7.0

### Minor Changes

- b618de9: **BREAKING — `status` prop rename (Input/Select)**: To match the Figma library rename for clearer AI semantics, the `status` axis content-state values on Input box and Select box (line + filled) canonical components were renamed: `default` → `Placeholder` (placeholder/empty state), `normal` → `Value` (filled state). `multi select` is unchanged.

  Migration:

  - `<InputBoxLine status="default">` → `status="Placeholder"`
  - `status="normal"` → `status="Value"`
  - The prop **default** also changed from `'default'` to `'Placeholder'`, so consumers relying on the default need no change.

  `Button` (`default|hover|disable|loading`) and `Progress` (`default|success|error|warning`) have an unrelated same-named `status` axis and are **not** affected. No visual change (render output identical; drift-gate A=0).

## 0.6.1

### Patch Changes

- v0.6.1 — META-001 fix + npm files[] expansion (consumer-facing patches)

  Two unrelated patch-level fixes bundled because both unblock consumer reference adoption (v1.0 trigger condition 3b).

  ## Fixes

  ### ESLint plugin `no-inline-svg` — Vue SFC `<template>` `<svg>` detection (META-001)

  Prior to this fix, the ESLint plugin rule only detected `<svg`-in-string-literals and JSX `<svg>` tags. Vue SFC `<template>` `<svg>` markup (the common consumer case) was missed entirely — while the CLI `audit-product-code.mjs` R1 caught it.

  Result for consumer adopting both CLI + ESLint plugin: rule named `no-inline-svg` reports two different sets of violations, contradicting `CONSUMER_AUDIT_SETUP.md §What ships` "Same rules" promise.

  **Fix**: use `vue-eslint-parser`'s `defineTemplateBodyVisitor` to add VElement + VText visitors alongside the existing script visitor. Plugin now catches every `<svg>` element in Vue SFC templates (more granular than CLI which reports once per file).

  Empirical re-verification on MicroApps Console vue-app (2026-05-19):

  - Before: 9 errors (all emoji/arrow; 0 real `<svg>`)
  - After: 42 errors (33 `<svg>` + 8 arrow + 1 emoji)

  ### `package.json` `files[]` — include `scripts/` `templates/` and consumer-facing docs

  v0.6.0 npm tarball was missing `scripts/` (audit CLI), `templates/` (eslint config example), and consumer-facing docs (CONSUMER_AUDIT_SETUP.md / MIGRATION_TO_V1.md / API_STABILITY.md). Master HEAD already corrected this pre-v0.6.0 release; v0.6.1 ships it.

  ## Refs

  - Backlog: `docs/internal/backlog.md` META-001
  - Retrospect: `docs/internal/retrospection/2026-05-19-consumer-verification-microapps.md`
  - Consumer verification plan: `docs/internal/_plans/new-session-prompt-consumer-product-verification.md`

## 0.6.0

### Minor Changes

- v0.6.0 — tooling + audit infrastructure + Button legacy props removal (BREAKING) + ESLint plugin

  11 items total: 8 additive (Tier 1-B mockup audits, Tier 2-G STATUS lint, INFRA-F32/F33/F34, hook 升级) + 1 hotfix + **2 BREAKING** (Button legacy props deletion, new ESLint plugin subpath export).

  ## BREAKING

  ### Button — legacy props `variant` / `size` / `disabled` / `loading` removed

  These props were `@deprecated since 0.5.0` and are now **deleted**. Migrate to canonical:

  | Old                             | New                                                            |
  | ------------------------------- | -------------------------------------------------------------- |
  | `<Button variant="fill-green">` | `<Button canonical-style="filling" canonical-color="green">`   |
  | `<Button variant="ghost-red">`  | `<Button canonical-style="ghost" canonical-color="red">`       |
  | `<Button variant="text-gray">`  | `<Button canonical-style="rimless" canonical-color="gray 1">`  |
  | `<Button size="l">`             | `<Button canonical-size="L">` (size enum upper-cased)          |
  | `<Button :disabled="true">`     | `<Button canonical-status="disable">`                          |
  | `<Button :loading="true">`      | `<Button canonical-status="loading" canonical-icon="loading">` |

  Variant→canonical mapping for fill/ghost styles all 4 colors (green/gray/red/orange):

  - `fill-*` → `canonical-style="filling"` + `canonical-color="*"`
  - `ghost-*` → `canonical-style="ghost"` + `canonical-color="*"`
  - `text-*` → `canonical-style="rimless"` + `canonical-color="*"`

  For consumers using `<ButtonBridge>` from `@nancyzeng0210/tvu-design-system` (the canonical wrapper), no change needed — its API is already canonical.

  ## NEW — ESLint plugin (subpath export)

  `@nancyzeng0210/tvu-design-system/eslint-plugin` — ships inside the main package as a subpath export. 4 rules covering R1/R2 + library import discipline (AGENTS.md 硬规则 #6):

  ```js
  // eslint.config.js (consumer)
  import tvuPlugin from "@nancyzeng0210/tvu-design-system/eslint-plugin";
  export default [tvuPlugin.configs.recommended];
  ```

  Rules: `no-hardcoded-color` / `no-inline-svg` / `icon-from-dist` / `no-base-component-import`.

  Functionally overlaps with the existing CLI `audit-product-code.mjs` (R1/R2/R16) for non-ESLint workflows.

  ## Additive (Tier 1-B / Tier 2-G / INFRA-F32-F34 + hook + hotfix)

  **Tier 1-B mockup audit (能力 4 first L3+ gates)**:

  - `scripts/audit-mockup-integrity.mjs` — M-INTEGRITY (I1 sibling layout / I2 SECTION overlap / I3 children-bbox wrap)
  - `scripts/audit-mockup-colors.mjs` — M-COLOR (C1 icon path fill / C2 hover state / C3 BG vs text grey)
  - `scripts/audit-mockup-library-binding.mjs` — M0 / M1 / M30 library binding (this session; MicroApps 716 findings baseline)

  **Tier 1-C foundation CLI (R1/R2/R16)**:

  - `scripts/audit-product-code.mjs` — invokable via `pnpm audit:consumer-code`

  **Tier 2-G STATUS consistency lint**:

  - `scripts/audit-status-consistency.mjs` — version triple-match + stale marker detect + active 项数 sanity. 13th strict gate.

  **INFRA-F32 figma-data/mockup/ sync mechanism**: parametrized api.mjs + `sync-mockup-data.mjs` + `.gitignore figma-data/mockup/`.

  **INFRA-F33 code-side figma name normalize**: `extractStyles()` collapses whitespace in figma style keys; token-aliases.ts reverted to single-space canonical.

  **INFRA-F34 scripts stdlib stability + CI Node matrix**: `audit:scripts-stdlib` + `.github/workflows/publish.yml` Node 20+22 audit-matrix job.

  **Hook allow-list 升级**: `.husky/pre-commit` — `figma-data/normalized/figma-styles.json` moved BLOCK → allow.

  **Hotfix**: `tvu-design-mockup/SKILL.md` broken doc link (`../../` → `../../../`).

  ## Release gates

  11 strict → **13 strict** (audit:scripts-stdlib + audit:status-consistency) + Node 20/22 CI matrix pre-flight.

  ## Migration checklist for consumers

  1. Search codebase for `<Button variant=` / `<Button size=` / `<Button :disabled=` / `<Button :loading=` → replace per the table above.
  2. (Optional) Add ESLint plugin to your config: `import tvuPlugin from '@nancyzeng0210/tvu-design-system/eslint-plugin'`.
  3. Run `pnpm audit:consumer-code` (CLI) for non-ESLint quick check.

## 0.5.0

### Minor Changes

- b868c63: Button canonical API 完整化（canonicalTheme axis）+ Tier 2-E/F tooling CLI + CANONICAL-007 + EXTRACT-006

  - Phase 6.8: Button/ButtonBridge gain `canonicalTheme?: 'dark' | 'light'` prop (8-axis complete). Legacy props @deprecated since this version, removed next.
  - scripts/figma-url-to-canonical.mjs: Figma URL → canonical component lookup CLI.
  - scripts/lint-skills.mjs: skill doc link validator, 11th strict gate.
  - CANONICAL-007: Pagination native `<button>` → DS `<Button>` (canonicalStyle/Color/Size/Radius props + `:deep(.btn)` compact override; active=filling+green, inactive=filling+gray1, arrows=rimless).
  - EXTRACT-006: Figma extract pipeline adds `extractStyles()` step — pulls `GET /v1/files/{key}/styles` + batched `getNodes` (≤100 ids), normalizes Text/Effect/Fill/Grid into `figma-data/normalized/figma-styles.json`. Whitespace-normalized prev-key lookup preserves existing `canonicalToken`/`usage`/`description`; `scaleTokens` and `_alignment_decisions` preserved as-is. First live run: 14 text (7 new PingFang SC) / 4 effect / 0 fill / 0 grid.
  - INFRA-F32: `figma-sync/sync-mockup-data.mjs` + `pnpm sync:mockup <fileKey>` — accepts product file key, pulls raw `getFile` via parametrized api.mjs (`getFile/getNodes/getFileStyles/getVariables/getImages` now take optional `fileKey` arg, default = env library key), writes `figma-data/mockup/<fileKey>.json` (gitignored). Unblocks Tier 1-B audit:mockup-conformance (deferred to v0.6.0). Live verified with MicroApps `DtZcMkhNy6qh6jbQQnhreQ` (~65 MB raw dump, idempotent re-run via `_meta.extractedAt` strip).

## 0.4.0

### Minor Changes

- API 形态统一 minor — Phase 6.6a/6.6b dual-form + Phase 6.7 Badge SoT 一致性 reconciliation + Tier 2-D backlog ID generator.

  **All non-breaking** (pickup originally tagged 破坏性=是 but post-implementation 实证 全 non-breaking — dual-form adds named slots without removing prop API; Phase 6.7 is 0 code change; Tier 2-D is a new dev tool).

  ### Highlights

  - **FormItem.label dual-form** (commit 529bb366): adds `#label` named slot to FormItem. Default slot stays as content/control area (Element Plus convention).
  - **Tooltip.content dual-form** (commit 0db2bfd0): adds `#content` named slot to Tooltip. Default slot stays as trigger element. FormItemPage Custom Label Slot demo upgraded to use public Icon export path (`@/src/index`).
  - **Badge SoT 一致性 ack** (commit 5546ae0b): canonical Badge has had `color | tag | type=Circle|Rectangle` API since checkpoint 9e3ca1ae; pickup spec drift discovered and reconciled in translation SoT. No code change.
  - **`scripts/new-backlog.mjs`** (commit 50ff23d0): Node ESM CLI to suggest next available backlog ID across SoT files. Usage: `pnpm new-backlog <PREFIX>`. Valid prefixes: CANONICAL / BRIDGE / BRIDGE-MOCKUP / BRIDGE-DESIGN / EXTRACT / META / INFRA.

  ### Infra

  - audit:translation-completeness h2 section-boundary fix (commit cca1a043): `auditActiveVsResolved` now truncates section.end at next `^## ` h2 header so trailing `### v1.0.0` section doesn't swallow track-A timeline tables.

  ### Docs

  - FormItem and Tooltip pages each gain a "Custom <Label|Content> Slot" demo block.
  - divergences.md + divergences-decisions.json clarified for all three v0.4.0 entries (formitem-label-dual-form / tooltip-content-dual-form / badge-api-split) — codeSide rewritten to reflect named-slot reality; resolved status flipped at wrap-up.

## 0.3.0

### Minor Changes

- v0.3.0 — Tier 1-A translation schema 化 + BRIDGE-005 generator schema 升级 + Phase 6.4 runtime additions

  **Tier 1-A (4 sprints) — translation/\* JSON + Schema + audit:translation-completeness (10th strict gate)**:

  - `axis-implementation-map.md` → `axis-implementation-map.json` + JSON Schema (16 instances)
  - `prop-aliases.md` split → `prop-aliases.json` (102 entries 13 scope) + 瘦身 md narrative
  - `divergences.md` split → `divergences-decisions.json` (26 decisions 8 category) + 保留 narrative
  - 新 `audit:translation-completeness` 6 维 audit (forward coverage / backward consistency / JSON schema / divergences resolved / token bidirectional / active vs resolved cross-check) — 10th strict gate in `prepublishOnly`
  - AJV 2020 dialect schema 验证

  **SoT drift cleanup + audit dim 6**:

  - Phase 6.3 实际 2026-04-28 已 resolved (commit `897d709c`)，STATUS / tracker 历史 stale active 列入是 SoT drift，已修正
  - audit:translation-completeness 维度 6 (active vs resolved cross-check) 机械防 SoT drift 复发
  - BreadcrumbItem.showSeparator vs Figma showIcon alias drift fix (prop-aliases entry 修正)
  - INFRA-F30 4th source: `audit-tokenized-diff` timestamp idempotent write

  **BRIDGE-005 — Figma boolean property schema 升级**:

  - `figma-sync/generate-docs-figma-members.mjs` 加 `parseBooleanPropsFromTsx()` + `lookupBooleanPropertyAlias()`
  - `DocsFigmaMembers<T>` 新增 `booleanProperties?: readonly BooleanProperty[]` 字段
  - 9 components 重生成 (含 5 个 booleanProperties: BreadcrumbItem / Pagination / PromptMessage / Switch / Table / TopBar)
  - Plan owner fix: axis-named props 排除 (figma-mcp-cache TSX lossy 把 enum axis 推断成 boolean)

  **Phase 6.4 — Runtime addition props (non-breaking)**:

  - `Input.showCount?: boolean = false` + `maxlength?: number` (Figma feature=text count → 右下角 counter)
  - `Select.multiple?: boolean = false` (Figma status=multi select → sugar shortcut)
  - `Select.editable?: boolean = false` (Figma UX=editable → derived state + CSS hook)
  - 既有 `status='multi select'` / `ux='editable'` API 保持工作 (OR 合并)
  - 3 新 runtime-addition entries in prop-aliases.json
  - 108 tests passed (+3 new tests)

## 0.2.0

### Minor Changes

- v0.2.0 — Chart canonical + audit gate upgrades + visual baseline

  ### Highlights

  - 新增 `Chart` canonical 组件 — 6 variants (Line / Bar / Stacked Bar / Area / Pie / Doughnut) · Chart.js 4.5 + vue-chartjs 5.3 + 12 色 categorical palette
  - `audit:published-vs-code` 升 9th strict gate — figma-only count 降到 0（BRIDGE-MOCKUP-004 tracker 收尾）
  - Playwright 视觉基线落地 — 29 page × dark/light = 58 baseline
  - Pre-commit hook v1 上线 — husky + vue-tsc/vitest/figma-data 三红灯 gate

  ### Added

  - **`Chart` canonical component**（`src/canonical/Chart.vue`）— 6 variants matching Figma `chart/*` component set
    - `type`: `line` / `bar` / `stacked-bar` / `area` / `pie` / `doughnut`
    - 12-color categorical palette（`--chart-color-1` ~ `--chart-color-12`）— brand / blue / orange / red + 紫 / 黄 / 青绿 / 洋红 / 靛蓝 / 珊瑚 / chartreuse / lavender
    - Theme-aware：dark / light variants via `<html data-theme>` switch
    - peerDeps：`chart.js ^4.4.0` + `vue-chartjs ^5.3.0`
  - **`PromptMessage.autoDismissMs?: number` prop** — auto-dismiss timer via `watchEffect` + `onBeforeUnmount` cleanup（CANONICAL-002）
  - **Docs site auto-sync version chip + dropdown** — displays current package version + last sync date from package.json / git / CHANGELOG

  ### Changed

  - **`audit:published-vs-code` upgraded to strict gate** — 9th in `prepublishOnly` chain；`continue-on-error` removed from `publish.yml`；figma-only count 0
  - **`Pagination` figma alignment refactor** — 7 mismatch fixed（nav row gap / Simple nav width / Classic btn bg+border+font-weight / Small btn size 24→32px）+ `.pg-main` → `.pg-content` + `.pg-nav-row` hierarchy（CANONICAL-006）

  ### Fixed

  - **`Progress` dark track token** — `--progress-track-bg-dark` → `var(--line-deep)` (#353535) for figma fidelity（CANONICAL-004）

  ### Infra（internal — 不影响 dist/ consumer）

  - **INFRA-F20** Playwright visual baseline — `tests/visual/docs-pages.spec.ts` (29 page × 2 theme = 58 baseline)
  - **INFRA-F21 v1** husky pre-commit hook — 3 red-block gates (vue-tsc / vitest / figma-data write block)
  - **INFRA-F26** extract-figma timestamp idempotence — `extract.mjs` + `normalize-component-tokens.mjs` `stripPaths` + `--force`
  - **INFRA-F29** `normalize.mjs` `normalizedAt` churn — inline patch reusing F26 helper (MD5 verified idempotent)
  - **BRIDGE-MOCKUP-004** tracker close — `figma-to-code-mapping.json` status update + `publish.yml` `continue-on-error` removed + `RELEASING.md` gate table updated
  - Vitest fixture sync — 10 drift fixes after CANONICAL-002/006/008 + data-module migration

  ### Verified

  - ✅ All 9 strict audit gates pass（`audit:design-system` / `figma-conformance` / `docs-site` / `component-tokens` / `tokenized-diff` / `icon-fill-currentcolor` / `component-no-inline-svg` / `no-hardcoded-design-tokens` / `published-vs-code`）
  - ✅ Vitest：105 passed / 1 skipped
  - ✅ Playwright visual：58/58 baseline match
  - ⏳ Pending（post-publish）：GitHub Packages 页实物显示 `@nancyzeng0210/tvu-design-system@0.2.0`（按 STATUS.md release wrap-up 协议强制 verify）

## 0.1.3

### Patch Changes

- a61ee85: CANONICAL-010: PopupBox canonical 实现（modal dialog + 命令式 API）

  - 新增 base modal 组件 `src/components/PopupBox/PopupBox.vue`（Teleport + 自写 backdrop / focus trap / ESC / scroll lock, 0 dep）
  - 新增命令式 API `PopupBox.alert` / `.confirm` / `.open`（类 Element Plus ElMessageBox）
  - 新增 canonical wrapper `src/canonical/PopupBox.vue`（figma Theme=Dark/Light 1:1 对齐）
  - 加 docs page `playground/docs/pages/PopupBoxPage.vue`（button-driven imperative demo）
  - `audit:published-vs-code` figma-only count 从 2 减到 1（PopupBox 移出）
  - BRIDGE-MOCKUP-004 tracker 子项 1/2 完成（仍待 CANONICAL-011 Chart 完成才升 strict）

## 0.1.2

### Patch Changes

- fix(publish): rename package scope @tvu → @nancyzeng0210 (GitHub Packages owner alignment)

  Package name renamed from `@tvu/design-system` → `@nancyzeng0210/tvu-design-system` to match GitHub Packages owner constraint (NancyZeng0210). v0.1.0 / v0.1.1 was never actually published due to this scope mismatch (CI looked green but `pnpm publish` step silently failed; Packages 页全空才暴露真相). v0.1.2 is the first successful publish under the renamed scope. No consumer impact (no install ever succeeded before v0.1.2).

## 0.1.1

### Patch Changes

- 72fc6be: CANONICAL-009: audit:design-system 升 strict

  - 修 audit 脚本 scoped CSS vars false-positive（每 .vue 内部定义的 --xxx 现纳入 defined set）
  - 加 carrier components 白名单（Icon + Logo carrier 模式 by design，按 SOT 来源派发 SVG）
  - Tab.vue hex 替换为 grey scale token (--color-grey-10 / --color-grey-12)
  - exit code 纳入 hardcoded color + raw SVG injection（不只 undefined token）

> **Format**: Keep a Changelog (实用裁剪) — `Highlights` / `Added` / `Changed` / `Fixed` / `Verified` 五段
> **Maintenance**: 0.1.0+ 由 [`changesets`](https://github.com/changesets/changesets) 自动聚合
> 新 PR 加 `.changeset/*.md` 描述变更；发版时跑 `pnpm changeset:version` 聚合并 bump version

## [0.1.0] - 2026-05-09

### Highlights

- 19 canonical Vue 3 组件 / 29 named export — 1:1 对齐 TVU Figma library
- 18 toggle-aware docs pages — Element Plus 风格文档站，全页跟随 docsTheme inject
- 642 个图标 / 28 categories — 同时输出 Vue 组件 / 每分类 ESM / 单 SVG CDN 三模式
- 完整 token system — CSS variables，theme-aware（`<html data-theme="light">` 切换）
- T4-spike 验证："AI 拿 Figma URL → 1:1 还原代码" 闭环可达

### Added

- **Canonical 组件 29 named export**：`Icon` / `Button` / `Radio` / `Switch` / `InputBoxLine` / `InputBoxFilled` / `Badge` / `Breadcrumb` / `BreadcrumbItem` / `CheckBox` / `FormItem` / `InputNumber` / `Notification` / `PromptMessage` / `Pagination` / `Progress` / `Rating` / `SelectBoxLine` / `SelectBoxFilled` / `Slider` / `Steps` / `StepItem` / `Table` / `Tab` / `TabItem` / `TabList` / `TopBar` / `DropDownListSelect` / `Tooltip`
- **Icon system**：642 icons across 28 categories，三种消费方式：
  - Vue 组件：`<Icon name="time/clock" />`
  - 每分类 ESM：`import { SettingIcons } from '@tvu/design-system/icons/esm'`
  - CDN SVG：`dist/icons/svg/<category>/<file>.svg`
- **翻译层 SoT 4 文件**（`src/design-system/translation/`）：
  - `prop-aliases.md` — 命名 alias 登记（如 `closable ↔ showCloseIcon`）
  - `divergences.md` — 显式不映射 / 双形态映射 / Button 双 API 决策 / Code 端双源段
  - `icon-aliases.ts` — 图标 alias 表（如 `status/warning ↔ icon/Message/Error 4`）
  - `token-aliases.ts` — figma Style → canonical token 映射
- **Bridge 机制**：硬规则 #6（canonical SoT）+ `pnpm sync:figma-library` audit pipeline（conformance / docs-site / published-vs-code 三层）
- **跨 AI 工具协作契约**：`AGENTS.md` / `docs/meta-rules.md` / `docs/internal/mockup-conventions.md` / `docs/internal/figma-component-catalog.md`
- **Theme system**：dark / light toggle 通过 `<html data-theme="light">` 切换；默认 dark

### Changed

- **INFRA-F19** — docs site theme-aware 完整化（18 page 单 grid 跟随全局 toggle，禁止 dark/light 并排展示）
- **INFRA-F22** — generator theme axis case-insensitive（修 FormItem figma 真源大写 axis 派生失败）
- **INFRA-F23** — FormItemPage 整页重写（toggle-aware 范式）
- **Phase X.4.2** — 19 components canonical 完全对齐 figma + Badge 三轮 figma roundtrip

### Fixed

- **CANONICAL-001** — Tooltip `placement=top-*` 系列 arrow CSS 偏移
- **CANONICAL-003** — `BaseNotification` iconMap 真源不一致 + `Icon.vue` inline `currentColor` override（外部 CSS 现可 control icon color）

### Verified

- **T4-spike** — Badge "AI 拿 Figma URL → 1:1 还原" PASS（commit `b9e5ac3c`）
- **INFRA-F25** — SVG / Icon / token design-conformance audit suite 起步（含 `audit:icon-fill-currentcolor` / `audit:no-hardcoded-design-tokens` / `audit:component-no-inline-svg`）

[0.1.0]: https://github.com/NancyZeng0210/TVU-Design-System/releases/tag/v0.1.0