@design-ai/cli 4.56.0 → 4.57.0

package/examples/component-button.md

@@ -196,9 +196,9 @@ If any of these don't exist in your token system, **stop and add them before imp
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/button/Button.tsx`](../refs/ant-design/components/button/Button.tsx) — most exhaustive prop coverage; uses `type` (legacy) and `variant` (modern) in parallel, with `color` as a separate axis.
-- MUI: [`refs/mui/packages/mui-material/src/Button/Button.d.ts`](../refs/mui/packages/mui-material/src/Button/Button.d.ts) — `variant` (`text`/`outlined`/`contained`), `color` (semantic), `loadingPosition`. The most thoroughly documented.
-- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/button.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/button.tsx) — Tailwind `cva` pattern, `asChild` via Radix Slot, simplest API surface. Inspired the `iconStart`/`iconEnd` and `asChild` choices in this spec.
+- Ant Design: [`refs/ant-design/components/button/Button.tsx`](../docs/reference/ant-design.md#button) — most exhaustive prop coverage; uses `type` (legacy) and `variant` (modern) in parallel, with `color` as a separate axis.
+- MUI: [`refs/mui/packages/mui-material/src/Button/Button.d.ts`](../docs/reference/mui.md#button) — `variant` (`text`/`outlined`/`contained`), `color` (semantic), `loadingPosition`. The most thoroughly documented.
+- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/button.tsx`](../docs/reference/shadcn-ui.md#button) — Tailwind `cva` pattern, `asChild` via Radix Slot, simplest API surface. Inspired the `iconStart`/`iconEnd` and `asChild` choices in this spec.
 
 API choices made:
 - **`variant` names**: `solid`/`outline`/`ghost`/`link` over MUI's `text`/`outlined`/`contained` (clearer for non-Material teams) and over Ant's `default`/`dashed`/`text`/`link` (`default` is uninformative).

package/examples/component-calendar.md

@@ -262,9 +262,9 @@ function MonthlyScheduleScreen() {
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/calendar/`](../refs/ant-design/components/calendar/) — `Calendar` with `mode="month" | "year"`, `dateCellRender`, `monthCellRender`. Most exhaustive.
+- Ant Design: [`refs/ant-design/components/calendar/`](../docs/reference/ant-design.md#calendar) — `Calendar` with `mode="month" | "year"`, `dateCellRender`, `monthCellRender`. Most exhaustive.
 - MUI: `@mui/x-date-pickers` `DateCalendar` — focused on date selection within a calendar grid; not full-month event-display.
-- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/calendar.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/calendar.tsx) — wraps `react-day-picker`. Use as date selector or full calendar via `mode="default"` + `numberOfMonths`.
+- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/calendar.tsx`](../docs/reference/shadcn-ui.md#calendar) — wraps `react-day-picker`. Use as date selector or full calendar via `mode="default"` + `numberOfMonths`.
 
 For event-heavy calendar apps (Google Calendar style), consider:
 - `react-big-calendar` — month/week/day views with events

package/examples/component-card-actions.md

@@ -91,7 +91,7 @@ Left-aligned by default. The convention differs from `DialogActions` (right-alig
 
 ## References
 
-- MUI: [`CardActions.d.ts`](../refs/mui/packages/mui-material/src/CardActions/CardActions.d.ts)
+- MUI: [`CardActions.d.ts`](../docs/reference/mui.md#card-actions)
 
 ## Cross-reference
 

package/examples/component-card-content.md

@@ -79,7 +79,7 @@
 
 ## References
 
-- MUI: [`CardContent.d.ts`](../refs/mui/packages/mui-material/src/CardContent/CardContent.d.ts)
+- MUI: [`CardContent.d.ts`](../docs/reference/mui.md#card-content)
 
 ## Cross-reference
 

package/examples/component-card-header.md

@@ -112,7 +112,7 @@ function PostCard({ post, onMore, onLike }) {
 
 ## References
 
-- MUI: [`CardHeader`](../refs/mui/packages/mui-material/src/CardHeader/)
+- MUI: [`CardHeader`](../docs/reference/mui.md#card-header)
 
 ## Cross-reference
 

package/examples/component-card-media.md

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

package/examples/component-card.md

@@ -216,9 +216,9 @@ For image-led cards: `padding="none"`, manually pad the text sections. The cover
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/card/`](../refs/ant-design/components/card/) — `Card`, `Card.Meta`, `Card.Grid`. Strong support for tabbed cards (`tabList` prop) and grid cards. Most exhaustive.
-- MUI: [`refs/mui/packages/mui-material/src/Card/`](../refs/mui/packages/mui-material/src/Card/) — composition: `Card`, `CardHeader`, `CardMedia`, `CardContent`, `CardActions`, `CardActionArea` (the wrapper that makes a card clickable). MUI's `CardActionArea` is the clearest implementation of the interactive-card pattern.
-- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/card.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/card.tsx) — composition with `Card`, `CardHeader`, `CardTitle`, `CardDescription`, `CardContent`, `CardFooter`, `CardAction`. Cleanest minimal version.
+- Ant Design: [`refs/ant-design/components/card/`](../docs/reference/ant-design.md#card) — `Card`, `Card.Meta`, `Card.Grid`. Strong support for tabbed cards (`tabList` prop) and grid cards. Most exhaustive.
+- MUI: [`refs/mui/packages/mui-material/src/Card/`](../docs/reference/mui.md#card) — composition: `Card`, `CardHeader`, `CardMedia`, `CardContent`, `CardActions`, `CardActionArea` (the wrapper that makes a card clickable). MUI's `CardActionArea` is the clearest implementation of the interactive-card pattern.
+- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/card.tsx`](../docs/reference/shadcn-ui.md#card) — composition with `Card`, `CardHeader`, `CardTitle`, `CardDescription`, `CardContent`, `CardFooter`, `CardAction`. Cleanest minimal version.
 
 API choices made:
 - **Composition over prop overload**: matches all three references' direction. Single `<Card title=... description=... actions=...>` API was rejected — slot-based scales.

package/examples/component-carousel.md

@@ -250,9 +250,9 @@ Swipe is a touch convention. For accessibility, ensure arrows are visible OR a c
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/carousel/`](../refs/ant-design/components/carousel/) — `Carousel`. Wraps `react-slick`. Has `autoplay`, `dots`, `effect`. Solid baseline.
+- Ant Design: [`refs/ant-design/components/carousel/`](../docs/reference/ant-design.md#carousel) — `Carousel`. Wraps `react-slick`. Has `autoplay`, `dots`, `effect`. Solid baseline.
 - MUI: no dedicated component. Use `react-slick` or `swiper`.
-- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/carousel.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/carousel.tsx) — wraps **Embla** carousel. Modern, framework-agnostic, excellent accessibility. **Default for new projects.**
+- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/carousel.tsx`](../docs/reference/shadcn-ui.md#carousel) — wraps **Embla** carousel. Modern, framework-agnostic, excellent accessibility. **Default for new projects.**
 
 API choices made:
 - **`autoplay: false` default**: matches a11y best practice. Most carousels don't need it.

package/examples/component-cascader.md

@@ -125,7 +125,7 @@ For Korean address: combine with Daum Postcode (more user-friendly for actual ad
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/cascader/`](../refs/ant-design/components/cascader/) — `Cascader` with full feature set. Most exhaustive.
+- Ant Design: [`refs/ant-design/components/cascader/`](../docs/reference/ant-design.md#cascader) — `Cascader` with full feature set. Most exhaustive.
 - MUI / shadcn-ui: no built-in. Compose from Select-like primitives.
 
 ## Cross-reference

package/examples/component-chart.md

@@ -224,7 +224,7 @@ function RevenueChart({ data }: Props) {
 
 ## References
 
-- shadcn-ui: [`chart`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/chart.tsx) (Recharts wrapper)
+- shadcn-ui: [`chart`](../docs/reference/shadcn-ui.md#chart) (Recharts wrapper)
 - Recharts: <https://recharts.org/>
 - Edward Tufte's *The Visual Display of Quantitative Information* — chart design fundamentals
 

package/examples/component-checkbox.md

@@ -137,9 +137,9 @@ const indeterminate = someChecked;
 
 ## References
 
-- Ant: [`Checkbox`](../refs/ant-design/components/checkbox)
-- MUI: [`Checkbox`](../refs/mui/packages/mui-material/src/Checkbox)
-- shadcn-ui: [`checkbox`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/checkbox.tsx)
+- Ant: [`Checkbox`](../docs/reference/ant-design.md#checkbox)
+- MUI: [`Checkbox`](../docs/reference/mui.md#checkbox)
+- shadcn-ui: [`checkbox`](../docs/reference/shadcn-ui.md#checkbox)
 
 ## Cross-reference
 

package/examples/component-click-away-listener.md

@@ -77,7 +77,7 @@ shadcn-based projects don't include this as a separate primitive — Popover / S
 
 ## References
 
-- MUI: [`ClickAwayListener`](../refs/mui/packages/mui-material/src/ClickAwayListener)
+- MUI: [`ClickAwayListener`](../docs/reference/mui.md#click-away-listener)
 - Hook alternatives in many libs (use-click-away, react-use, etc.)
 
 ## Cross-reference

package/examples/component-code.md

@@ -198,7 +198,7 @@ For language announcement:
 
 ## References
 
-- Ant Design: [`Typography.Text code`](../refs/ant-design/components/typography/) — inline. Block code: just use HTML `<pre>` with optional CSS.
+- Ant Design: [`Typography.Text code`](../docs/reference/ant-design.md#typography) — inline. Block code: just use HTML `<pre>` with optional CSS.
 - MUI: no dedicated Code component. Use `<code>` or `<Typography component="pre">`.
 - shadcn-ui: no built-in. Compose with `react-syntax-highlighter` + Tailwind.
 

package/examples/component-collapsible.md

@@ -209,7 +209,7 @@ function ProductDetails({ product }: Props) {
 
 ## References
 
-- shadcn-ui: [`collapsible`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/collapsible.tsx) (Radix)
+- shadcn-ui: [`collapsible`](../docs/reference/shadcn-ui.md#collapsible) (Radix)
 - WAI-ARIA: [Disclosure pattern](https://www.w3.org/WAI/ARIA/apg/patterns/disclosure/)
 
 ## Cross-reference

package/examples/component-color-picker.md

@@ -100,7 +100,7 @@ Don't roll your own — color math is hard and there are subtle edge cases.
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/color-picker/`](../refs/ant-design/components/color-picker/) — comprehensive. Has presets, alpha, multiple format inputs.
+- Ant Design: [`refs/ant-design/components/color-picker/`](../docs/reference/ant-design.md#color-picker) — comprehensive. Has presets, alpha, multiple format inputs.
 - MUI: no built-in. Use `react-colorful` or similar.
 - shadcn-ui: no built-in. Compose with `Popover` + `react-colorful`.
 

package/examples/component-combobox.md

@@ -255,7 +255,7 @@ function CountryPicker({ value, onChange }: Props) {
 
 ## References
 
-- shadcn-ui: [`combobox`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/combobox.tsx)
+- shadcn-ui: [`combobox`](../docs/reference/shadcn-ui.md#combobox)
 - WAI-ARIA: [Combobox pattern](https://www.w3.org/WAI/ARIA/apg/patterns/combobox/)
 - cmdk library
 

package/examples/component-command.md

@@ -286,7 +286,7 @@ function GlobalCommandPalette() {
 
 ## References
 
-- shadcn-ui: [`command`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/command.tsx) (cmdk-based)
+- shadcn-ui: [`command`](../docs/reference/shadcn-ui.md#command) (cmdk-based)
 - cmdk library by pacocoursey
 - Patterns: VS Code Command Palette, Linear, GitHub global search, Slack `Cmd+K`
 - WAI-ARIA: combobox + listbox pattern

package/examples/component-config-provider.md

@@ -183,8 +183,8 @@ export function ProductRoot() {
 
 ## References
 
-- Ant Design: [`config-provider/index.en-US.md`](../refs/ant-design/components/config-provider/index.en-US.md), [`config-provider/index.tsx`](../refs/ant-design/components/config-provider/index.tsx), [`config-provider/context.ts`](../refs/ant-design/components/config-provider/context.ts), [`app/index.en-US.md`](../refs/ant-design/components/app/index.en-US.md)
-- MUI: [`ThemeProvider.tsx`](../refs/mui/packages/mui-material/src/styles/ThemeProvider.tsx), [`CssBaseline.js`](../refs/mui/packages/mui-material/src/CssBaseline/CssBaseline.js)
-- shadcn-ui: [`theme-provider.tsx`](../refs/shadcn-ui/apps/v4/components/theme-provider.tsx), [`globals.css`](../refs/shadcn-ui/apps/v4/app/globals.css)
+- Ant Design: [`config-provider/index.en-US.md`](../docs/reference/ant-design.md#config-provider), [`config-provider/index.tsx`](../docs/reference/ant-design.md#config-provider), [`config-provider/context.ts`](../docs/reference/ant-design.md#config-provider), [`app/index.en-US.md`](../docs/reference/ant-design.md#app)
+- MUI: [`ThemeProvider.tsx`](../docs/reference/mui.md#styles), [`CssBaseline.js`](../docs/reference/mui.md#css-baseline)
+- shadcn-ui: [`theme-provider.tsx`](../docs/reference/shadcn-ui.md), [`globals.css`](../docs/reference/shadcn-ui.md)
 - Knowledge: [`design-tokens/ant-design.md`](../knowledge/design-tokens/ant-design.md), [`a11y/contrast.md`](../knowledge/a11y/contrast.md), [`i18n/korean-product-conventions.md`](../knowledge/i18n/korean-product-conventions.md)
 - Cross-reference: [`component-css-baseline.md`](component-css-baseline.md), [`component-empty-state.md`](component-empty-state.md), [`component-form.md`](component-form.md)

package/examples/component-context-menu.md

@@ -168,7 +168,7 @@ Same as DropdownMenu — Korean text legible, Pretendard / NanumSquare body. 합
 
 ## References
 
-- shadcn-ui: [`context-menu`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/context-menu.tsx) (Radix)
+- shadcn-ui: [`context-menu`](../docs/reference/shadcn-ui.md#context-menu) (Radix)
 - WAI-ARIA: same Menu pattern as DropdownMenu
 - Native: HTML5 `oncontextmenu` event
 

package/examples/component-css-baseline.md

@@ -142,7 +142,7 @@ body {
 
 ## References
 
-- MUI: [`CssBaseline.d.ts`](../refs/mui/packages/mui-material/src/CssBaseline/CssBaseline.d.ts), [`CssBaseline.js`](../refs/mui/packages/mui-material/src/CssBaseline/CssBaseline.js), [`ThemeProvider.tsx`](../refs/mui/packages/mui-material/src/styles/ThemeProvider.tsx)
-- Ant Design: [`config-provider/index.en-US.md`](../refs/ant-design/components/config-provider/index.en-US.md), [`theme/index.tsx`](../refs/ant-design/components/theme/index.tsx)
-- shadcn-ui: [`theme-provider.tsx`](../refs/shadcn-ui/apps/v4/components/theme-provider.tsx), [`globals.css`](../refs/shadcn-ui/apps/v4/app/globals.css)
+- MUI: [`CssBaseline.d.ts`](../docs/reference/mui.md#css-baseline), [`CssBaseline.js`](../docs/reference/mui.md#css-baseline), [`ThemeProvider.tsx`](../docs/reference/mui.md#styles)
+- Ant Design: [`config-provider/index.en-US.md`](../docs/reference/ant-design.md#config-provider), [`theme/index.tsx`](../docs/reference/ant-design.md#theme)
+- shadcn-ui: [`theme-provider.tsx`](../docs/reference/shadcn-ui.md), [`globals.css`](../docs/reference/shadcn-ui.md)
 - Knowledge: [`a11y/contrast.md`](../knowledge/a11y/contrast.md), [`i18n/korean-typography.md`](../knowledge/i18n/korean-typography.md), [`design-tokens/tailwind-v4.md`](../knowledge/design-tokens/tailwind-v4.md)

package/examples/component-date-picker.md

@@ -232,9 +232,9 @@ Announce on date selection: "May 7, 2026 selected" (or KR "2026년 5월 7일 선
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/date-picker/`](../refs/ant-design/components/date-picker/) — most variants (`DatePicker`, `RangePicker`, `MonthPicker`, `YearPicker`, `WeekPicker`, `QuarterPicker`). Heavy but covers everything.
+- Ant Design: [`refs/ant-design/components/date-picker/`](../docs/reference/ant-design.md#date-picker) — most variants (`DatePicker`, `RangePicker`, `MonthPicker`, `YearPicker`, `WeekPicker`, `QuarterPicker`). Heavy but covers everything.
 - MUI: `@mui/x-date-pickers` (separate package) — `DatePicker`, `DateTimePicker`, `DateRangePicker`. Excellent locale support; pairs with date-fns / dayjs / luxon adapters.
-- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/calendar.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/calendar.tsx) — wraps `react-day-picker`. Compose with `Popover` for the picker pattern.
+- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/calendar.tsx`](../docs/reference/shadcn-ui.md#calendar) — wraps `react-day-picker`. Compose with `Popover` for the picker pattern.
 
 API choices made:
 - **`mode` axis** (single / range / dateTime / quickRange) over Ant's separate components — fewer top-level imports.

package/examples/component-descriptions.md

@@ -231,7 +231,7 @@ function ProfileScreen() {
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/descriptions/`](../refs/ant-design/components/descriptions/) — most exhaustive (column, span, layout, bordered, sections).
+- Ant Design: [`refs/ant-design/components/descriptions/`](../docs/reference/ant-design.md#descriptions) — most exhaustive (column, span, layout, bordered, sections).
 - MUI / shadcn-ui: no built-in. Compose with `<dl>` + Tailwind.
 
 ## Cross-reference

package/examples/component-dialog-actions.md

@@ -100,7 +100,7 @@ For destructive primary actions (e.g., 삭제), use `color="error"` on the prima
 
 ## References
 
-- MUI: [`DialogActions.d.ts`](../refs/mui/packages/mui-material/src/DialogActions/DialogActions.d.ts)
+- MUI: [`DialogActions.d.ts`](../docs/reference/mui.md#dialog-actions)
 
 ## Cross-reference
 

package/examples/component-dialog-content-text.md

@@ -67,7 +67,7 @@ Extends `Typography` — all typography props work.
 
 ## References
 
-- MUI: [`DialogContentText`](../refs/mui/packages/mui-material/src/DialogContentText/)
+- MUI: [`DialogContentText`](../docs/reference/mui.md#dialog-content-text)
 
 ## Cross-reference
 

package/examples/component-dialog-content.md

@@ -95,7 +95,7 @@ For a long-content dialog: `Dialog` with `scroll="paper"` (default) and `divider
 
 ## References
 
-- MUI: [`DialogContent.d.ts`](../refs/mui/packages/mui-material/src/DialogContent/DialogContent.d.ts)
+- MUI: [`DialogContent.d.ts`](../docs/reference/mui.md#dialog-content)
 
 ## Cross-reference
 

package/examples/component-dialog-title.md

@@ -93,7 +93,7 @@ The close button is typically rendered separately (often inside the title row vi
 
 ## References
 
-- MUI: [`DialogTitle.d.ts`](../refs/mui/packages/mui-material/src/DialogTitle/DialogTitle.d.ts)
+- MUI: [`DialogTitle.d.ts`](../docs/reference/mui.md#dialog-title)
 
 ## Cross-reference
 

package/examples/component-dialog.md

@@ -161,8 +161,8 @@ function DeleteConfirmDialog({ open, onClose, onConfirm, isPending }) {
 
 ## References
 
-- Ant Design: [`Modal`](../refs/ant-design/components/modal/) — class API, mask
-- MUI: [`Dialog`](../refs/mui/packages/mui-material/src/Dialog/) — flagship reference
+- Ant Design: [`Modal`](../docs/reference/ant-design.md#modal) — class API, mask
+- MUI: [`Dialog`](../docs/reference/mui.md#dialog) — flagship reference
 
 ## Cross-reference
 

package/examples/component-divider.md

@@ -172,9 +172,9 @@ Most dividers in product UIs should be `aria-hidden`. The structure is conveyed
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/divider/`](../refs/ant-design/components/divider/) — `Divider` with `type="horizontal" | "vertical"`, `dashed`, optional inline text. Mature.
-- MUI: [`refs/mui/packages/mui-material/src/Divider/`](../refs/mui/packages/mui-material/src/Divider/) — `Divider` with `orientation`, `variant="fullWidth" | "inset" | "middle"`, `textAlign`. Most variants.
-- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/separator.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/separator.tsx) — Radix Separator. Minimal primitive. `decorative` prop drives `aria-hidden` vs `role="separator"`.
+- Ant Design: [`refs/ant-design/components/divider/`](../docs/reference/ant-design.md#divider) — `Divider` with `type="horizontal" | "vertical"`, `dashed`, optional inline text. Mature.
+- MUI: [`refs/mui/packages/mui-material/src/Divider/`](../docs/reference/mui.md#divider) — `Divider` with `orientation`, `variant="fullWidth" | "inset" | "middle"`, `textAlign`. Most variants.
+- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/separator.tsx`](../docs/reference/shadcn-ui.md#separator) — Radix Separator. Minimal primitive. `decorative` prop drives `aria-hidden` vs `role="separator"`.
 
 ## Cross-reference
 

package/examples/component-drawer.md

@@ -246,9 +246,9 @@ const [menuOpen, setMenuOpen] = useState(false);
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/drawer/`](../refs/ant-design/components/drawer/) — `Drawer`. Supports `placement`, `size`, `mask`, `closable`. Mature.
-- MUI: [`refs/mui/packages/mui-material/src/Drawer/`](../refs/mui/packages/mui-material/src/Drawer/) — `Drawer` with `variant="permanent" | "persistent" | "temporary"`. Best persistent-mode handling.
-- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/sheet.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/sheet.tsx) — Radix Dialog primitive used as a side panel. Modal-only by default; persistent requires composition.
+- Ant Design: [`refs/ant-design/components/drawer/`](../docs/reference/ant-design.md#drawer) — `Drawer`. Supports `placement`, `size`, `mask`, `closable`. Mature.
+- MUI: [`refs/mui/packages/mui-material/src/Drawer/`](../docs/reference/mui.md#drawer) — `Drawer` with `variant="permanent" | "persistent" | "temporary"`. Best persistent-mode handling.
+- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/sheet.tsx`](../docs/reference/shadcn-ui.md#sheet) — Radix Dialog primitive used as a side panel. Modal-only by default; persistent requires composition.
 
 ## Cross-reference
 

package/examples/component-dropdown.md

@@ -207,9 +207,9 @@ function UserMenu({ user, onSignOut }: Props) {
 
 ## References
 
-- Ant: [`Dropdown`](../refs/ant-design/components/dropdown)
-- MUI: [`Menu`](../refs/mui/packages/mui-material/src/Menu)
-- shadcn-ui: [`dropdown-menu`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/dropdown-menu.tsx) (Radix-based)
+- Ant: [`Dropdown`](../docs/reference/ant-design.md#dropdown)
+- MUI: [`Menu`](../docs/reference/mui.md#menu)
+- shadcn-ui: [`dropdown-menu`](../docs/reference/shadcn-ui.md#dropdown-menu) (Radix-based)
 - WAI-ARIA: [Menu pattern](https://www.w3.org/WAI/ARIA/apg/patterns/menu/)
 
 ## Cross-reference

package/examples/component-empty.md

@@ -162,8 +162,8 @@ Match the surrounding component's voice level.
 
 ## References
 
-- Ant: [`Empty`](../refs/ant-design/components/empty)
-- shadcn-ui: [`empty`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/empty.tsx)
+- Ant: [`Empty`](../docs/reference/ant-design.md#empty)
+- shadcn-ui: [`empty`](../docs/reference/shadcn-ui.md#empty)
 
 ## Cross-reference
 

package/examples/component-fade.md

@@ -77,7 +77,7 @@
 
 ## References
 
-- MUI: [`Fade`](../refs/mui/packages/mui-material/src/Fade/)
+- MUI: [`Fade`](../docs/reference/mui.md#fade)
 
 ## Cross-reference
 

package/examples/component-field.md

@@ -253,7 +253,7 @@ function SignupForm() {
 
 ## References
 
-- shadcn-ui: [`field`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/field.tsx)
+- shadcn-ui: [`field`](../docs/reference/shadcn-ui.md#field)
 - WAI-ARIA Authoring Practices: form labeling
 - Native HTML: `<fieldset>`, `<legend>`, `<label>`
 

package/examples/component-filled-input.md

@@ -105,7 +105,7 @@ Same a11y contract as `OutlinedInput`:
 
 ## References
 
-- MUI: [`FilledInput`](../refs/mui/packages/mui-material/src/FilledInput/)
+- MUI: [`FilledInput`](../docs/reference/mui.md#filled-input)
 
 ## Cross-reference
 

package/examples/component-flex.md

@@ -105,7 +105,7 @@ Stateless.
 
 ## References
 
-- Ant: [`Flex`](../refs/ant-design/components/flex)
+- Ant: [`Flex`](../docs/reference/ant-design.md#flex)
 - MUI: `Stack` (sibling primitive)
 - Chakra UI: `HStack`, `VStack`, `Flex`
 

package/examples/component-float-button.md

@@ -203,8 +203,8 @@ Subtle bg (`--color-primary-subtle-bg`), primary icon. Less emphasis but still e
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/float-button/`](../refs/ant-design/components/float-button/) — `FloatButton`, `FloatButton.Group` (speed dial), `FloatButton.BackTop`. Most flexible.
-- MUI: [`refs/mui/packages/mui-material/src/Fab/`](../refs/mui/packages/mui-material/src/Fab/) — `Fab` with `variant="circular" | "extended"`, color, size. Material-aligned.
+- Ant Design: [`refs/ant-design/components/float-button/`](../docs/reference/ant-design.md#float-button) — `FloatButton`, `FloatButton.Group` (speed dial), `FloatButton.BackTop`. Most flexible.
+- MUI: [`refs/mui/packages/mui-material/src/Fab/`](../docs/reference/mui.md#fab) — `Fab` with `variant="circular" | "extended"`, color, size. Material-aligned.
 - shadcn-ui: no built-in. Compose with `Button` + Tailwind `fixed bottom-4 right-4 rounded-full`.
 
 ## Cross-reference

package/examples/component-form-control-label.md

@@ -122,7 +122,7 @@ function ConsentCheckboxes() {
 
 ## References
 
-- MUI: [`FormControlLabel`](../refs/mui/packages/mui-material/src/FormControlLabel/)
+- MUI: [`FormControlLabel`](../docs/reference/mui.md#form-control-label)
 
 ## Cross-reference
 

package/examples/component-form-control.md

@@ -102,7 +102,7 @@ The visual gap between input and helper text is part of the FormControl's owned
 
 ## References
 
-- MUI: [`FormControl.d.ts`](../refs/mui/packages/mui-material/src/FormControl/FormControl.d.ts)
+- MUI: [`FormControl.d.ts`](../docs/reference/mui.md#form-control)
 
 ## Cross-reference
 

package/examples/component-form-controls.md

@@ -236,7 +236,7 @@ The visible control is small (16–24px). The **clickable area** must be ≥ 44
 
 - Ant Design: `Switch`, `Checkbox`, `Checkbox.Group`, `Radio`, `Radio.Group`, `Radio.Button`. Has `Radio.Button` for segmented-control-style radios.
 - MUI: `Switch`, `Checkbox`, `Radio` + `RadioGroup` + `FormControl` for the wrapper. `FormControlLabel` for label-with-control.
-- shadcn-ui: [`switch.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/switch.tsx), [`checkbox.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/checkbox.tsx), [`radio-group.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/radio-group.tsx). Radix primitives. **Default for new projects.**
+- shadcn-ui: [`switch.tsx`](../docs/reference/shadcn-ui.md#switch), [`checkbox.tsx`](../docs/reference/shadcn-ui.md#checkbox), [`radio-group.tsx`](../docs/reference/shadcn-ui.md#radio-group). Radix primitives. **Default for new projects.**
 
 API choices made:
 - **`onCheckedChange(checked)` for Switch + Checkbox**, **`onValueChange(value)` for RadioGroup**: matches the actual user intent — Switch/Checkbox is "what's the boolean?", RadioGroup is "what's the value?".

package/examples/component-form-group.md

@@ -77,7 +77,7 @@ Layout primitive — no interactive state of its own.
 
 ## References
 
-- MUI: [`FormGroup`](../refs/mui/packages/mui-material/src/FormGroup/)
+- MUI: [`FormGroup`](../docs/reference/mui.md#form-group)
 
 ## Cross-reference
 

package/examples/component-form-helper-text.md

@@ -86,7 +86,7 @@
 
 ## References
 
-- MUI: [`FormHelperText`](../refs/mui/packages/mui-material/src/FormHelperText/)
+- MUI: [`FormHelperText`](../docs/reference/mui.md#form-helper-text)
 
 ## Cross-reference
 

package/examples/component-form-label.md

@@ -89,7 +89,7 @@
 
 ## References
 
-- MUI: [`FormLabel`](../refs/mui/packages/mui-material/src/FormLabel/)
+- MUI: [`FormLabel`](../docs/reference/mui.md#form-label)
 
 ## Cross-reference
 

package/examples/component-form.md

@@ -272,9 +272,9 @@ Required affordances:
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/form/`](../refs/ant-design/components/form/) — exhaustive `Form`, `Form.Item`, `Form.List`, `Form.Provider`. Most complete API. Built-in validation rules. Ant's `Form.useForm` is the imperative escape hatch.
+- Ant Design: [`refs/ant-design/components/form/`](../docs/reference/ant-design.md#form) — exhaustive `Form`, `Form.Item`, `Form.List`, `Form.Provider`. Most complete API. Built-in validation rules. Ant's `Form.useForm` is the imperative escape hatch.
 - MUI: composition with `<form>` + `react-hook-form` + `<TextField>`. No dedicated Form component — MUI explicitly defers form orchestration to RHF.
-- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/) — `form.tsx` wraps RHF `FormProvider` + `Controller` + auto-wires `aria-*`. Cleanest minimal version. Mandates Zod + RHF.
+- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/`](../docs/reference/shadcn-ui.md) — `form.tsx` wraps RHF `FormProvider` + `Controller` + auto-wires `aria-*`. Cleanest minimal version. Mandates Zod + RHF.
 
 API choices made:
 - **Composition (`Form.Field`/`Form.Label`/`Form.Control`)** over Ant's `Form.Item` prop-blob — slot-based scales to custom field types better.

package/examples/component-grid.md

@@ -128,8 +128,8 @@ Stateless.
 
 ## References
 
-- Ant: [`Grid`](../refs/ant-design/components/grid) (Row + Col, 24-col)
-- MUI: [`Grid`](../refs/mui/packages/mui-material/src/Grid) (12-col)
+- Ant: [`Grid`](../docs/reference/ant-design.md#grid) (Row + Col, 24-col)
+- MUI: [`Grid`](../docs/reference/mui.md#grid) (12-col)
 - CSS Grid Level 1 / 2
 
 ## Cross-reference

package/examples/component-grow.md

@@ -68,7 +68,7 @@
 
 ## References
 
-- MUI: [`Grow`](../refs/mui/packages/mui-material/src/Grow/)
+- MUI: [`Grow`](../docs/reference/mui.md#grow)
 
 ## Cross-reference
 

package/examples/component-hover-card.md

@@ -200,7 +200,7 @@ function MentionLink({ user }: { user: User }) {
 
 ## References
 
-- shadcn-ui: [`hover-card`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/hover-card.tsx) (Radix)
+- shadcn-ui: [`hover-card`](../docs/reference/shadcn-ui.md#hover-card) (Radix)
 - Patterns: Twitter / X profile previews on @mention hover
 - Patterns: GitHub PR review preview on commit hash hover
 

package/examples/component-icon-button.md

@@ -132,7 +132,7 @@ function ToolbarActions() {
 
 ## References
 
-- MUI: [`IconButton`](../refs/mui/packages/mui-material/src/IconButton)
+- MUI: [`IconButton`](../docs/reference/mui.md#icon-button)
 - Material 3: Icon button variants
 
 ## Cross-reference

package/examples/component-icon.md

@@ -92,7 +92,7 @@ See [`knowledge/icons/curated-sets.md`](../knowledge/icons/curated-sets.md).
 
 ## References
 
-- MUI: [`SvgIcon`](../refs/mui/packages/mui-material/src/SvgIcon)
+- MUI: [`SvgIcon`](../docs/reference/mui.md#svg-icon)
 - Phosphor Icons: 1200+ icons, 5 weights
 - Lucide: stroke-only minimalist set
 

package/examples/component-image-list.md

@@ -98,7 +98,7 @@ Stateless. Tiles can be interactive (click → open / navigate); each tile follo
 
 ## References
 
-- MUI: [`ImageList`](../refs/mui/packages/mui-material/src/ImageList)
+- MUI: [`ImageList`](../docs/reference/mui.md#image-list)
 
 ## Cross-reference
 

package/examples/component-image.md

@@ -265,7 +265,7 @@ Always set an aspect ratio — this prevents the browser-jumping layout shift wh
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/image/`](../refs/ant-design/components/image/) — `Image` + `Image.PreviewGroup` for lightbox. Has `placeholder`, `fallback`, `preview` config. Solid impl.
+- Ant Design: [`refs/ant-design/components/image/`](../docs/reference/ant-design.md#image) — `Image` + `Image.PreviewGroup` for lightbox. Has `placeholder`, `fallback`, `preview` config. Solid impl.
 - MUI: no dedicated component. Compose with native `<img>`.
 - shadcn-ui: no built-in. Compose `<img>` + Tailwind. For lightbox: `react-photo-view` or `yet-another-react-lightbox`.
 

package/examples/component-input-adornment.md

@@ -92,7 +92,7 @@ function PriceInput({ value, onChange }) {
 
 ## References
 
-- MUI: [`InputAdornment`](../refs/mui/packages/mui-material/src/InputAdornment/)
+- MUI: [`InputAdornment`](../docs/reference/mui.md#input-adornment)
 
 ## Cross-reference
 

package/examples/component-input-base.md

@@ -122,7 +122,7 @@ function SearchField({ value, onChange, onClear }) {
 
 ## References
 
-- MUI: [`InputBase`](../refs/mui/packages/mui-material/src/InputBase/)
+- MUI: [`InputBase`](../docs/reference/mui.md#input-base)
 
 ## Cross-reference