@design-ai/cli 4.56.0 → 4.57.0

package/examples/component-spin.md

@@ -162,8 +162,8 @@ When motion disabled: spinner is static. Provide a text label or different non-a
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/spin/`](../refs/ant-design/components/spin/) — `Spin`. Standard spinner with `tip`, `delay`, `wrapperClassName`.
-- MUI: [`CircularProgress`](../refs/mui/packages/mui-material/src/CircularProgress/) (Material's equivalent). Same role.
+- Ant Design: [`refs/ant-design/components/spin/`](../docs/reference/ant-design.md#spin) — `Spin`. Standard spinner with `tip`, `delay`, `wrapperClassName`.
+- MUI: [`CircularProgress`](../docs/reference/mui.md#circular-progress) (Material's equivalent). Same role.
 - shadcn-ui: no built-in. Use Lucide's `Loader2` icon with CSS spin.
 
 ## Cross-reference

package/examples/component-spinner.md

@@ -193,7 +193,7 @@ For longer waits, Korean: "잠시만 기다려 주세요...".
 
 ## References
 
-- MUI: [`CircularProgress`](../refs/mui/packages/mui-material/src/CircularProgress) (indeterminate variant)
+- MUI: [`CircularProgress`](../docs/reference/mui.md#circular-progress) (indeterminate variant)
 - Patterns: standard SVG spinner
 
 ## Cross-reference

package/examples/component-splitter.md

@@ -200,9 +200,9 @@ function CodeEditor() {
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/splitter/`](../refs/ant-design/components/splitter/) — `Splitter` + `Splitter.Panel`. Modern Ant addition.
+- Ant Design: [`refs/ant-design/components/splitter/`](../docs/reference/ant-design.md#splitter) — `Splitter` + `Splitter.Panel`. Modern Ant addition.
 - MUI: no built-in. Use `react-resizable-panels` or `allotment`.
-- shadcn-ui: [`resizable.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/resizable.tsx) — wraps `react-resizable-panels`. Cleanest impl.
+- shadcn-ui: [`resizable.tsx`](../docs/reference/shadcn-ui.md#resizable) — wraps `react-resizable-panels`. Cleanest impl.
 
 ## Cross-reference
 

package/examples/component-stack.md

@@ -119,7 +119,7 @@ Layout primitive — no interactive states.
 
 ## References
 
-- MUI: [`Stack`](../refs/mui/packages/mui-material/src/Stack/)
+- MUI: [`Stack`](../docs/reference/mui.md#stack)
 
 ## Cross-reference
 

package/examples/component-statistic.md

@@ -265,7 +265,7 @@ For libraries: `react-sparklines`, `recharts` mini variant, or hand-roll an SVG.
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/statistic/`](../refs/ant-design/components/statistic/) — `Statistic` + `Statistic.Countdown` (auto-counting). Solid baseline.
+- Ant Design: [`refs/ant-design/components/statistic/`](../docs/reference/ant-design.md#statistic) — `Statistic` + `Statistic.Countdown` (auto-counting). Solid baseline.
 - MUI: no dedicated component — compose `<Card><CardContent><Typography variant="overline">label</Typography>...`.
 - shadcn-ui: no built-in. Compose from `Card` + Tailwind.
 

package/examples/component-step-button.md

@@ -144,10 +144,10 @@ Inherits button-like props from MUI `ButtonBase`. In MUI, `disabled` is controll
 
 ## References
 
-- MUI direct source: [`refs/mui/packages/mui-material/src/StepButton/StepButton.d.ts`](../refs/mui/packages/mui-material/src/StepButton/StepButton.d.ts)
-- MUI implementation: [`refs/mui/packages/mui-material/src/StepButton/StepButton.js`](../refs/mui/packages/mui-material/src/StepButton/StepButton.js)
-- MUI stepper docs/examples: [`refs/mui/docs/data/material/components/steppers/`](../refs/mui/docs/data/material/components/steppers/)
-- Ant Design parent pattern: [`refs/ant-design/components/steps/`](../refs/ant-design/components/steps/)
+- MUI direct source: [`refs/mui/packages/mui-material/src/StepButton/StepButton.d.ts`](../docs/reference/mui.md#step-button)
+- MUI implementation: [`refs/mui/packages/mui-material/src/StepButton/StepButton.js`](../docs/reference/mui.md#step-button)
+- MUI stepper docs/examples: [`refs/mui/docs/data/material/components/steppers/`](../docs/reference/mui.md)
+- Ant Design parent pattern: [`refs/ant-design/components/steps/`](../docs/reference/ant-design.md#steps)
 - Accessibility baseline: [`knowledge/a11y/keyboard-and-focus.md`](../knowledge/a11y/keyboard-and-focus.md)
 
 ## Cross-reference

package/examples/component-step-connector.md

@@ -144,10 +144,10 @@ function CheckoutConnector(props: StepConnectorProps) {
 
 ## References
 
-- MUI direct source: [`refs/mui/packages/mui-material/src/StepConnector/StepConnector.d.ts`](../refs/mui/packages/mui-material/src/StepConnector/StepConnector.d.ts)
-- MUI implementation: [`refs/mui/packages/mui-material/src/StepConnector/StepConnector.js`](../refs/mui/packages/mui-material/src/StepConnector/StepConnector.js)
-- MUI stepper docs/examples: [`refs/mui/docs/data/material/components/steppers/`](../refs/mui/docs/data/material/components/steppers/)
-- Ant Design parent pattern: [`refs/ant-design/components/steps/`](../refs/ant-design/components/steps/)
+- MUI direct source: [`refs/mui/packages/mui-material/src/StepConnector/StepConnector.d.ts`](../docs/reference/mui.md#step-connector)
+- MUI implementation: [`refs/mui/packages/mui-material/src/StepConnector/StepConnector.js`](../docs/reference/mui.md#step-connector)
+- MUI stepper docs/examples: [`refs/mui/docs/data/material/components/steppers/`](../docs/reference/mui.md)
+- Ant Design parent pattern: [`refs/ant-design/components/steps/`](../docs/reference/ant-design.md#steps)
 - Accessibility baseline: [`knowledge/a11y/keyboard-and-focus.md`](../knowledge/a11y/keyboard-and-focus.md)
 
 ## Cross-reference

package/examples/component-step-content.md

@@ -111,7 +111,7 @@ function VerticalOnboarding() {
 
 ## References
 
-- MUI: [`StepContent`](../refs/mui/packages/mui-material/src/StepContent/)
+- MUI: [`StepContent`](../docs/reference/mui.md#step-content)
 
 ## Cross-reference
 

package/examples/component-step-icon.md

@@ -106,7 +106,7 @@ function CartStepper({ activeStep }) {
 
 ## References
 
-- MUI: [`StepIcon`](../refs/mui/packages/mui-material/src/StepIcon/)
+- MUI: [`StepIcon`](../docs/reference/mui.md#step-icon)
 
 ## Cross-reference
 

package/examples/component-step-label.md

@@ -91,7 +91,7 @@ Inherited from parent `Step`:
 
 ## References
 
-- MUI: [`StepLabel`](../refs/mui/packages/mui-material/src/StepLabel/)
+- MUI: [`StepLabel`](../docs/reference/mui.md#step-label)
 
 ## Cross-reference
 

package/examples/component-step.md

@@ -76,8 +76,8 @@ This is handled by the parent `Steps` component, not Step itself.
 
 ## References
 
-- MUI: [`Step`](../refs/mui/packages/mui-material/src/Step)
-- Ant: [`Steps`](../refs/ant-design/components/steps) (parent)
+- MUI: [`Step`](../docs/reference/mui.md#step)
+- Ant: [`Steps`](../docs/reference/ant-design.md#steps) (parent)
 
 ## Cross-reference
 

package/examples/component-steps.md

@@ -247,8 +247,8 @@ For `n > 5` steps on mobile, **always switch to compact or text-only**.
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/steps/`](../refs/ant-design/components/steps/) — `Steps`, `Steps.Item`. Status, direction, size, progress dot variant. Most exhaustive.
-- MUI: [`refs/mui/packages/mui-material/src/Stepper/`](../refs/mui/packages/mui-material/src/Stepper/) — `Stepper`, `Step`, `StepLabel`, `StepContent`. Vertical with collapsible content per step is unique.
+- Ant Design: [`refs/ant-design/components/steps/`](../docs/reference/ant-design.md#steps) — `Steps`, `Steps.Item`. Status, direction, size, progress dot variant. Most exhaustive.
+- MUI: [`refs/mui/packages/mui-material/src/Stepper/`](../docs/reference/mui.md#stepper) — `Stepper`, `Step`, `StepLabel`, `StepContent`. Vertical with collapsible content per step is unique.
 - shadcn-ui: no built-in — compose from primitives. The `progress` and custom layout get you 80% there.
 
 API choices made:

package/examples/component-swipeable-drawer.md

@@ -139,7 +139,7 @@ function MobileApp() {
 
 ## References
 
-- MUI: [`SwipeableDrawer`](../refs/mui/packages/mui-material/src/SwipeableDrawer)
+- MUI: [`SwipeableDrawer`](../docs/reference/mui.md#swipeable-drawer)
 - iOS native drawer pattern; Material 3 standard drawer
 
 ## Cross-reference

package/examples/component-switch.md

@@ -89,9 +89,9 @@ Touch target ≥ 44pt regardless via padding.
 
 ## References
 
-- Ant: [`Switch`](../refs/ant-design/components/switch)
-- MUI: [`Switch`](../refs/mui/packages/mui-material/src/Switch)
-- shadcn-ui: [`switch`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/switch.tsx)
+- Ant: [`Switch`](../docs/reference/ant-design.md#switch)
+- MUI: [`Switch`](../docs/reference/mui.md#switch)
+- shadcn-ui: [`switch`](../docs/reference/shadcn-ui.md#switch)
 
 ## Cross-reference
 

package/examples/component-tab-scroll-button.md

@@ -166,11 +166,11 @@ function ScrollableTabsHeader({ tabs, value, onValueChange }: Props) {
 
 ## References
 
-- MUI direct source: [`refs/mui/packages/mui-material/src/TabScrollButton/TabScrollButton.d.ts`](../refs/mui/packages/mui-material/src/TabScrollButton/TabScrollButton.d.ts)
-- MUI implementation: [`refs/mui/packages/mui-material/src/TabScrollButton/TabScrollButton.js`](../refs/mui/packages/mui-material/src/TabScrollButton/TabScrollButton.js)
-- MUI tabs source: [`refs/mui/packages/mui-material/src/Tabs/`](../refs/mui/packages/mui-material/src/Tabs/)
-- Ant Design parent pattern: [`refs/ant-design/components/tabs/`](../refs/ant-design/components/tabs/)
-- shadcn-ui parent pattern: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/tabs.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/tabs.tsx)
+- MUI direct source: [`refs/mui/packages/mui-material/src/TabScrollButton/TabScrollButton.d.ts`](../docs/reference/mui.md#tab-scroll-button)
+- MUI implementation: [`refs/mui/packages/mui-material/src/TabScrollButton/TabScrollButton.js`](../docs/reference/mui.md#tab-scroll-button)
+- MUI tabs source: [`refs/mui/packages/mui-material/src/Tabs/`](../docs/reference/mui.md#tabs)
+- Ant Design parent pattern: [`refs/ant-design/components/tabs/`](../docs/reference/ant-design.md#tabs)
+- shadcn-ui parent pattern: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/tabs.tsx`](../docs/reference/shadcn-ui.md#tabs)
 - Accessibility baseline: [`knowledge/a11y/keyboard-and-focus.md`](../knowledge/a11y/keyboard-and-focus.md)
 
 ## Cross-reference

package/examples/component-tab.md

@@ -111,7 +111,7 @@ function AccountTabs() {
 
 ## References
 
-- MUI: [`Tab`](../refs/mui/packages/mui-material/src/Tab/) + [`Tabs`](../refs/mui/packages/mui-material/src/Tabs/)
+- MUI: [`Tab`](../docs/reference/mui.md#tab) + [`Tabs`](../docs/reference/mui.md#tabs)
 
 ## Cross-reference
 

package/examples/component-table-body.md

@@ -72,7 +72,7 @@ Renders `<tbody>` — semantic role for table body comes for free. No additional
 
 ## References
 
-- MUI: [`TableBody`](../refs/mui/packages/mui-material/src/TableBody/)
+- MUI: [`TableBody`](../docs/reference/mui.md#table-body)
 
 ## Cross-reference
 

package/examples/component-table-cell.md

@@ -108,7 +108,7 @@
 
 ## References
 
-- MUI: [`TableCell`](../refs/mui/packages/mui-material/src/TableCell/)
+- MUI: [`TableCell`](../docs/reference/mui.md#table-cell)
 
 ## Cross-reference
 

package/examples/component-table-container.md

@@ -67,7 +67,7 @@
 
 ## References
 
-- MUI: [`TableContainer`](../refs/mui/packages/mui-material/src/TableContainer/)
+- MUI: [`TableContainer`](../docs/reference/mui.md#table-container)
 
 ## Cross-reference
 

package/examples/component-table-footer.md

@@ -64,7 +64,7 @@
 
 ## References
 
-- MUI: [`TableFooter`](../refs/mui/packages/mui-material/src/TableFooter/)
+- MUI: [`TableFooter`](../docs/reference/mui.md#table-footer)
 
 ## Cross-reference
 

package/examples/component-table-head.md

@@ -69,7 +69,7 @@
 
 ## References
 
-- MUI: [`TableHead`](../refs/mui/packages/mui-material/src/TableHead/)
+- MUI: [`TableHead`](../docs/reference/mui.md#table-head)
 
 ## Cross-reference
 

package/examples/component-table-pagination.md

@@ -128,7 +128,7 @@ function EmployeesTable() {
 
 ## References
 
-- MUI: [`TablePagination`](../refs/mui/packages/mui-material/src/TablePagination/)
+- MUI: [`TablePagination`](../docs/reference/mui.md#table-pagination)
 
 ## Cross-reference
 

package/examples/component-table-row.md

@@ -103,7 +103,7 @@
 
 ## References
 
-- MUI: [`TableRow`](../refs/mui/packages/mui-material/src/TableRow/)
+- MUI: [`TableRow`](../docs/reference/mui.md#table-row)
 
 ## Cross-reference
 

package/examples/component-table-sort-label.md

@@ -101,7 +101,7 @@ function SortableHeader({ orderBy, order, onSort }) {
 
 ## References
 
-- MUI: [`TableSortLabel`](../refs/mui/packages/mui-material/src/TableSortLabel/)
+- MUI: [`TableSortLabel`](../docs/reference/mui.md#table-sort-label)
 
 ## Cross-reference
 

package/examples/component-table.md

@@ -186,9 +186,9 @@ Pick #1 for product UIs, #2 for power-user data tools.
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/table/`](../refs/ant-design/components/table/) — most exhaustive: tree data, expandable rows, virtual scroll, drag-drop column reorder, fixed headers/columns. Heavy but production-grade.
+- Ant Design: [`refs/ant-design/components/table/`](../docs/reference/ant-design.md#table) — most exhaustive: tree data, expandable rows, virtual scroll, drag-drop column reorder, fixed headers/columns. Heavy but production-grade.
 - MUI: `<Table>` (basic) and `<DataGrid>` (heavy, paid for some features). DataGrid has best DX for filtering/sorting but is a large dep.
-- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/table.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/table.tsx) — primitives only (`<Table>`, `<TableHeader>`, etc.). Pair with TanStack Table for behavior. **Recommended modern pattern.**
+- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/table.tsx`](../docs/reference/shadcn-ui.md#table) — primitives only (`<Table>`, `<TableHeader>`, etc.). Pair with TanStack Table for behavior. **Recommended modern pattern.**
 
 API choices made:
 - **TanStack Table as the engine** — headless, framework-agnostic, free, mature. Don't reinvent.

package/examples/component-tabs.md

@@ -168,9 +168,9 @@ Critical contract — get this exactly right:
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/tabs/`](../refs/ant-design/components/tabs/) — `Tabs`, `Tabs.TabPane`, supports `card`/`line`/`editable-card` variants. Most variants out of the box.
-- MUI: [`refs/mui/packages/mui-material/src/Tabs/`](../refs/mui/packages/mui-material/src/Tabs/) — `Tabs` + `Tab` + `TabPanel` (separately). MUI has good `scrollable` props.
-- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/tabs.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/tabs.tsx) — Radix Tabs primitive. Cleanest a11y. **Default for new projects.**
+- Ant Design: [`refs/ant-design/components/tabs/`](../docs/reference/ant-design.md#tabs) — `Tabs`, `Tabs.TabPane`, supports `card`/`line`/`editable-card` variants. Most variants out of the box.
+- MUI: [`refs/mui/packages/mui-material/src/Tabs/`](../docs/reference/mui.md#tabs) — `Tabs` + `Tab` + `TabPanel` (separately). MUI has good `scrollable` props.
+- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/tabs.tsx`](../docs/reference/shadcn-ui.md#tabs) — Radix Tabs primitive. Cleanest a11y. **Default for new projects.**
 
 API choices made:
 - **Composition with `Tabs.Trigger` / `Tabs.Content`** matching value strings — Radix pattern, lowest surface area.

package/examples/component-tag-badge.md

@@ -291,9 +291,9 @@ Use `offset` to fine-tune (badges often need -4px / -4px to overlap nicely).
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/tag/`](../refs/ant-design/components/tag/) (Tag) + [`refs/ant-design/components/badge/`](../refs/ant-design/components/badge/) (Badge). Both well-developed; Tag has `Tag.CheckableTag` for filter-style.
+- Ant Design: [`refs/ant-design/components/tag/`](../docs/reference/ant-design.md#tag) (Tag) + [`refs/ant-design/components/badge/`](../docs/reference/ant-design.md#badge) (Badge). Both well-developed; Tag has `Tag.CheckableTag` for filter-style.
 - MUI: `Chip` (closest to Tag) + `Badge`. MUI Chip has `clickable`, `deletable`, `avatar` slot — most flexible.
-- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/badge.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/badge.tsx) — minimal Tag-equivalent. shadcn doesn't have a separate Tag/Badge distinction; user composes.
+- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/badge.tsx`](../docs/reference/shadcn-ui.md#badge) — minimal Tag-equivalent. shadcn doesn't have a separate Tag/Badge distinction; user composes.
 
 API choices made:
 - **Tag and Badge as separate components**: matches Ant + MUI; clearer than a single "Pill" with a `mode` flag.

package/examples/component-tag.md

@@ -94,7 +94,7 @@
 
 ## References
 
-- Ant: [`Tag`](../refs/ant-design/components/tag)
+- Ant: [`Tag`](../docs/reference/ant-design.md#tag)
 
 ## Cross-reference
 

package/examples/component-textarea-autosize.md

@@ -105,7 +105,7 @@ function ChatInput() {
 
 ## References
 
-- MUI: [`TextareaAutosize`](../refs/mui/packages/mui-material/src/TextareaAutosize)
+- MUI: [`TextareaAutosize`](../docs/reference/mui.md#textarea-autosize)
 - CSS `field-sizing` property (Working Draft)
 
 ## Cross-reference

package/examples/component-textarea.md

@@ -163,7 +163,7 @@ Critical for Hangul input — composition events span multiple keystrokes.
 ## References
 
 - HTML5 `<textarea>`
-- shadcn-ui: [`textarea`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/textarea.tsx)
+- shadcn-ui: [`textarea`](../docs/reference/shadcn-ui.md#textarea)
 - MUI: TextareaAutosize
 
 ## Cross-reference

package/examples/component-time-picker.md

@@ -195,7 +195,7 @@ function AppointmentBooking() {
 
 ## References
 
-- Ant: [`TimePicker`](../refs/ant-design/components/time-picker)
+- Ant: [`TimePicker`](../docs/reference/ant-design.md#time-picker)
 - MUI: `TimePicker` (in @mui/x-date-pickers)
 - HTML5: `<input type="time">` (limited but accessible default)
 

package/examples/component-timeline.md

@@ -160,7 +160,7 @@ Status terms:
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/timeline/`](../refs/ant-design/components/timeline/) — `Timeline` with modes, custom icons, color overrides.
+- Ant Design: [`refs/ant-design/components/timeline/`](../docs/reference/ant-design.md#timeline) — `Timeline` with modes, custom icons, color overrides.
 - MUI: `@mui/lab` `Timeline` (separate package) — alternate mode well-supported.
 - shadcn-ui: no built-in. Compose from primitives.
 

package/examples/component-toast.md

@@ -206,10 +206,10 @@ upload().then(
 ## References
 
 - Ant Design:
-  - [`refs/ant-design/components/message/`](../refs/ant-design/components/message/) — single-line transient messages (closest to "toast").
-  - [`refs/ant-design/components/notification/`](../refs/ant-design/components/notification/) — multi-line, with title and description (closest to this spec's full toast). Ant separates these by line count — most other systems combine.
-- MUI: [`refs/mui/packages/mui-material/src/Snackbar/Snackbar.tsx`](../refs/mui/packages/mui-material/src/Snackbar/) — composition-style React component. The least ergonomic of the three for the imperative pattern; pair with `useSnackbar` hook from notistack or build a custom queue.
-- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/sonner.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/sonner.tsx) — wraps `sonner` library. Sonner is the modern de-facto standard; its API (this spec mirrors it) is the cleanest of the three.
+  - [`refs/ant-design/components/message/`](../docs/reference/ant-design.md#message) — single-line transient messages (closest to "toast").
+  - [`refs/ant-design/components/notification/`](../docs/reference/ant-design.md#notification) — multi-line, with title and description (closest to this spec's full toast). Ant separates these by line count — most other systems combine.
+- MUI: [`refs/mui/packages/mui-material/src/Snackbar/Snackbar.tsx`](../docs/reference/mui.md#snackbar) — composition-style React component. The least ergonomic of the three for the imperative pattern; pair with `useSnackbar` hook from notistack or build a custom queue.
+- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/sonner.tsx`](../docs/reference/shadcn-ui.md#sonner) — wraps `sonner` library. Sonner is the modern de-facto standard; its API (this spec mirrors it) is the cleanest of the three.
 
 API choices made:
 - **Imperative API as primary** (`toast.success(...)`) — matches user mental model. Composition (`<Toast>` JSX) is rejected — toasts come from any code path, not from render.

package/examples/component-toggle-button.md

@@ -120,7 +120,7 @@ function TextStyleToolbar({ formats, onChange }) {
 
 ## References
 
-- MUI: [`ToggleButton`](../refs/mui/packages/mui-material/src/ToggleButton/) + [`ToggleButtonGroup`](../refs/mui/packages/mui-material/src/ToggleButtonGroup/)
+- MUI: [`ToggleButton`](../docs/reference/mui.md#toggle-button) + [`ToggleButtonGroup`](../docs/reference/mui.md#toggle-button-group)
 
 ## Cross-reference
 

package/examples/component-toggle.md

@@ -210,7 +210,7 @@ Pretendard for label / Korean text in `aria-label`.
 
 ## References
 
-- shadcn-ui: [`toggle`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/toggle.tsx), [`toggle-group`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/toggle-group.tsx) (Radix)
+- shadcn-ui: [`toggle`](../docs/reference/shadcn-ui.md#toggle), [`toggle-group`](../docs/reference/shadcn-ui.md#toggle-group) (Radix)
 - WAI-ARIA: [Toggle button](https://www.w3.org/WAI/ARIA/apg/patterns/button/) + [Radio group](https://www.w3.org/WAI/ARIA/apg/patterns/radio/)
 
 ## Cross-reference

package/examples/component-toolbar.md

@@ -94,7 +94,7 @@ Stateless. Children carry their own states.
 
 ## References
 
-- MUI: [`Toolbar`](../refs/mui/packages/mui-material/src/Toolbar)
+- MUI: [`Toolbar`](../docs/reference/mui.md#toolbar)
 - WAI-ARIA: [Toolbar pattern](https://www.w3.org/WAI/ARIA/apg/patterns/toolbar/)
 
 ## Cross-reference

package/examples/component-tooltip.md

@@ -168,9 +168,9 @@ The native `title` attribute does NOT meet a11y requirements:
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/tooltip/`](../refs/ant-design/components/tooltip/) — `Tooltip` with rich placement options (12 directions). `mouseEnterDelay` / `mouseLeaveDelay` props.
-- MUI: [`refs/mui/packages/mui-material/src/Tooltip/`](../refs/mui/packages/mui-material/src/Tooltip/) — `Tooltip` with `placement`, `enterDelay`, `leaveDelay`, `arrow`. Solid implementation.
-- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/tooltip.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/tooltip.tsx) — Radix Tooltip primitive. **Default — best a11y of the three.**
+- Ant Design: [`refs/ant-design/components/tooltip/`](../docs/reference/ant-design.md#tooltip) — `Tooltip` with rich placement options (12 directions). `mouseEnterDelay` / `mouseLeaveDelay` props.
+- MUI: [`refs/mui/packages/mui-material/src/Tooltip/`](../docs/reference/mui.md#tooltip) — `Tooltip` with `placement`, `enterDelay`, `leaveDelay`, `arrow`. Solid implementation.
+- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/tooltip.tsx`](../docs/reference/shadcn-ui.md#tooltip) — Radix Tooltip primitive. **Default — best a11y of the three.**
 
 ## Cross-reference
 

package/examples/component-tour.md

@@ -165,7 +165,7 @@ If selector doesn't match (e.g., conditional UI not rendered), skip the step or
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/tour/`](../refs/ant-design/components/tour/) — `Tour` with steps, target refs, custom rendering. Modern Ant addition.
+- Ant Design: [`refs/ant-design/components/tour/`](../docs/reference/ant-design.md#tour) — `Tour` with steps, target refs, custom rendering. Modern Ant addition.
 - MUI: no built-in. Use libraries like `react-joyride` or `intro.js`.
 - shadcn-ui: no built-in. Compose with Popover + custom backdrop.
 

package/examples/component-transfer.md

@@ -146,7 +146,7 @@ Or a simpler "tap to toggle" pattern:
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/transfer/`](../refs/ant-design/components/transfer/) — `Transfer`. Most exhaustive; supports tree-like (`Transfer.TableTransfer`).
+- Ant Design: [`refs/ant-design/components/transfer/`](../docs/reference/ant-design.md#transfer) — `Transfer`. Most exhaustive; supports tree-like (`Transfer.TableTransfer`).
 - MUI / shadcn-ui: no built-in.
 
 ## Cross-reference

package/examples/component-tree-select.md

@@ -191,7 +191,7 @@ function DepartmentSelect() {
 
 ## References
 
-- Ant: [`TreeSelect`](../refs/ant-design/components/tree-select)
+- Ant: [`TreeSelect`](../docs/reference/ant-design.md#tree-select)
 - WAI-ARIA: [Tree pattern](https://www.w3.org/WAI/ARIA/apg/patterns/treeview/)
 
 ## Cross-reference

package/examples/component-tree.md

@@ -281,7 +281,7 @@ Announce on movement:
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/tree/`](../refs/ant-design/components/tree/) — `Tree` with `Tree.DirectoryTree` for file-style. Most exhaustive (drag-drop, async, search, virtual). Heavy.
+- Ant Design: [`refs/ant-design/components/tree/`](../docs/reference/ant-design.md#tree) — `Tree` with `Tree.DirectoryTree` for file-style. Most exhaustive (drag-drop, async, search, virtual). Heavy.
 - MUI: `@mui/x-tree-view` (separate package) — `RichTreeView` (declarative), `SimpleTreeView` (composition). Excellent a11y.
 - shadcn-ui: no built-in. Compose from primitives + headless library (react-arborist or @aria-tree).
 

package/examples/component-typography.md

@@ -202,8 +202,8 @@ For **Ant Design / MUI projects**: Typography is canonical; use it.
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/typography/`](../refs/ant-design/components/typography/) — `Typography`, `Typography.Title`, `Typography.Text`, `Typography.Paragraph`. Most exhaustive: copyable, ellipsis with tooltip, editable.
-- MUI: [`refs/mui/packages/mui-material/src/Typography/`](../refs/mui/packages/mui-material/src/Typography/) — `Typography` with variants matching Material 3 (display, headline, title, body, label).
+- Ant Design: [`refs/ant-design/components/typography/`](../docs/reference/ant-design.md#typography) — `Typography`, `Typography.Title`, `Typography.Text`, `Typography.Paragraph`. Most exhaustive: copyable, ellipsis with tooltip, editable.
+- MUI: [`refs/mui/packages/mui-material/src/Typography/`](../docs/reference/mui.md#typography) — `Typography` with variants matching Material 3 (display, headline, title, body, label).
 - shadcn-ui: no Typography component. Apply utility classes directly.
 
 ## Cross-reference

package/examples/component-upload.md

@@ -278,7 +278,7 @@ Profile photo replacement. Click opens picker; uploaded file replaces avatar.
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/upload/`](../refs/ant-design/components/upload/) — `Upload` with `Upload.Dragger` (drop zone), file list, multiple modes. Most exhaustive.
+- Ant Design: [`refs/ant-design/components/upload/`](../docs/reference/ant-design.md#upload) — `Upload` with `Upload.Dragger` (drop zone), file list, multiple modes. Most exhaustive.
 - MUI: no dedicated component. Compose `<input type="file">` with custom button.
 - shadcn-ui: no built-in. Compose with file input + drop-zone library (e.g., `react-dropzone`).
 

package/examples/component-watermark.md

@@ -208,7 +208,7 @@ Watermark with the **viewer's name + date** discourages internal screenshot-leak
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/watermark/`](../refs/ant-design/components/watermark/) — `Watermark`. Modern Ant addition with comprehensive options.
+- Ant Design: [`refs/ant-design/components/watermark/`](../docs/reference/ant-design.md#watermark) — `Watermark`. Modern Ant addition with comprehensive options.
 - MUI / shadcn-ui: no built-in. Compose with CSS or canvas.
 
 ## Cross-reference

package/examples/component-zoom.md

@@ -83,7 +83,7 @@ When NOT to use:
 
 ## References
 
-- MUI: [`Zoom`](../refs/mui/packages/mui-material/src/Zoom)
+- MUI: [`Zoom`](../docs/reference/mui.md#zoom)
 - Material Design: motion easing
 
 ## Cross-reference

package/knowledge/COVERAGE.md

@@ -1,7 +1,7 @@
 <!-- generated by tools/audit/check-coverage.py — do not hand-edit -->
 ---
 title: Design-AI coverage report
-generated_at: 2026-05-29
+generated_at: 2026-07-03
 ---
 
 # Coverage report
@@ -15,7 +15,7 @@ generated_at: 2026-05-29
 | Knowledge files | 92 | 77 hand-written + 15 generated |
 | Skills (PLAYBOOK + SKILL) | 20 | 20 with verification phase |
 | Worked examples | 221 | |
-| Extractors | 11 | |
+| Extractors | 12 | |
 | Canonical components | 200 | indexed across Ant / MUI / shadcn |
 | Components with worked spec | 181 | **90.5% spec coverage** (16 via parent/alias specs) |
 
@@ -49,7 +49,7 @@ generated_at: 2026-05-29
 
 | File | Lines | Type | Title |
 | --- | --- | --- | --- |
-| [knowledge/COVERAGE.md](../knowledge/COVERAGE.md) | 740 | generated | Coverage report |
+| [knowledge/COVERAGE.md](../knowledge/COVERAGE.md) | 741 | generated | Coverage report |
 | [knowledge/PRINCIPLES.md](../knowledge/PRINCIPLES.md) | 108 | hand-written | Design-AI principles |
 
 #### a11y
@@ -729,6 +729,7 @@ Specs that don't match the canonical index and are not used as coverage aliases:
 - `tools/extractors/component_spec_scaffold.py`
 - `tools/extractors/component_spec_scaffold_v2.py`
 - `tools/extractors/mui_palette.py`
+- `tools/extractors/reference_pages.py`
 - `tools/extractors/shadcn_registry.py`
 - `tools/extractors/ui_ux_pro_max.py`
 - `tools/extractors/ui_ux_pro_max_extras.py`