@design-ai/cli 4.56.0 → 4.57.0

package/examples/component-input-number.md

@@ -131,7 +131,7 @@
 
 ## References
 
-- Ant Design: [`InputNumber`](../refs/ant-design/components/input-number/)
+- Ant Design: [`InputNumber`](../docs/reference/ant-design.md#input-number)
 
 ## Cross-reference
 

package/examples/component-input-otp.md

@@ -259,9 +259,9 @@ function VerifyPhoneScreen({ phone }: Props) {
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/input/`](../refs/ant-design/components/input/) — `Input.OTP`. Length, formatting, paste handling.
+- Ant Design: [`refs/ant-design/components/input/`](../docs/reference/ant-design.md#input) — `Input.OTP`. Length, formatting, paste handling.
 - MUI: no built-in. Compose individual `<TextField>` cells.
-- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/input-otp.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/input-otp.tsx) — wraps `input-otp` library. **Default for new projects.**
+- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/input-otp.tsx`](../docs/reference/shadcn-ui.md#input-otp) — wraps `input-otp` library. **Default for new projects.**
 
 ## Cross-reference
 

package/examples/component-input.md

@@ -196,9 +196,9 @@ Field (the row)
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/input/`](../refs/ant-design/components/input/) — `Input`, `Input.Search`, `Input.Password`, `Input.TextArea`, `Input.Group`, `Input.OTP`. Most exhaustive split-by-purpose API.
-- MUI: [`refs/mui/packages/mui-material/src/Input/Input.tsx`](../refs/mui/packages/mui-material/src/Input/) and [`TextField/TextField.tsx`](../refs/mui/packages/mui-material/src/TextField/) — separates `Input` (raw) from `TextField` (Input + label + helper). MUI's split is cleaner conceptually.
-- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/input.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/input.tsx) — minimal styling layer over native `<input>`. Pairs with separate `label.tsx`. Composition over configuration.
+- Ant Design: [`refs/ant-design/components/input/`](../docs/reference/ant-design.md#input) — `Input`, `Input.Search`, `Input.Password`, `Input.TextArea`, `Input.Group`, `Input.OTP`. Most exhaustive split-by-purpose API.
+- MUI: [`refs/mui/packages/mui-material/src/Input/Input.tsx`](../docs/reference/mui.md#input) and [`TextField/TextField.tsx`](../docs/reference/mui.md#text-field) — separates `Input` (raw) from `TextField` (Input + label + helper). MUI's split is cleaner conceptually.
+- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/input.tsx`](../docs/reference/shadcn-ui.md#input) — minimal styling layer over native `<input>`. Pairs with separate `label.tsx`. Composition over configuration.
 
 API choices made:
 - **`label`/`helpText`/`errorText` as props** rather than separate components: 80% of inputs need all three; props keep usage compact. Composition (`<Field><Label/>...`) for the 20% that need finer control.

package/examples/component-item.md

@@ -232,7 +232,7 @@ function SettingsList() {
 
 ## References
 
-- shadcn-ui: [`item`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/item.tsx)
+- shadcn-ui: [`item`](../docs/reference/shadcn-ui.md#item)
 - iOS UITableViewCell; Material 3 List item
 
 ## Cross-reference

package/examples/component-label.md

@@ -108,7 +108,7 @@ Label is presentational; states inherit from the linked input.
 ## References
 
 - HTML5 `<label>` element
-- shadcn-ui: [`label`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/label.tsx) (Radix)
+- shadcn-ui: [`label`](../docs/reference/shadcn-ui.md#label) (Radix)
 - MUI: `FormLabel`
 
 ## Cross-reference

package/examples/component-layout.md

@@ -205,7 +205,7 @@ function AppLayout({ children }: Props) {
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/layout/`](../refs/ant-design/components/layout/) — `Layout`, `Layout.Header`, `Layout.Sider`, `Layout.Content`, `Layout.Footer`. Most exhaustive.
+- Ant Design: [`refs/ant-design/components/layout/`](../docs/reference/ant-design.md#layout) — `Layout`, `Layout.Header`, `Layout.Sider`, `Layout.Content`, `Layout.Footer`. Most exhaustive.
 - MUI: no dedicated Layout — compose with `<Box>` + `<Drawer>` + `<AppBar>`.
 - shadcn-ui: no built-in. Use `resizable` + custom layout.
 

package/examples/component-link.md

@@ -211,7 +211,7 @@ The `as` prop swaps the underlying element from `<a>` to a router-aware Link. Th
 ## References
 
 - HTML5 `<a>` element
-- MUI: [`Link`](../refs/mui/packages/mui-material/src/Link)
+- MUI: [`Link`](../docs/reference/mui.md#link)
 - Ant Design: link styling within `Typography`
 - WCAG 2.1: SC 1.4.1 (Use of Color), SC 2.4.4 (Link Purpose)
 

package/examples/component-list-item-avatar.md

@@ -63,7 +63,7 @@
 
 ## References
 
-- MUI: [`ListItemAvatar`](../refs/mui/packages/mui-material/src/ListItemAvatar/)
+- MUI: [`ListItemAvatar`](../docs/reference/mui.md#list-item-avatar)
 
 ## Cross-reference
 

package/examples/component-list-item-button.md

@@ -128,7 +128,7 @@ function SettingsNav({ section }: { section: string }) {
 
 ## References
 
-- MUI: [`ListItemButton`](../refs/mui/packages/mui-material/src/ListItemButton/)
+- MUI: [`ListItemButton`](../docs/reference/mui.md#list-item-button)
 
 ## Cross-reference
 

package/examples/component-list-item-icon.md

@@ -73,7 +73,7 @@ Inherits from parent button: hover, focus, selected, disabled all cascade. Selec
 
 ## References
 
-- MUI: [`ListItemIcon`](../refs/mui/packages/mui-material/src/ListItemIcon/)
+- MUI: [`ListItemIcon`](../docs/reference/mui.md#list-item-icon)
 
 ## Cross-reference
 

package/examples/component-list-item-text.md

@@ -88,7 +88,7 @@
 
 ## References
 
-- MUI: [`ListItemText`](../refs/mui/packages/mui-material/src/ListItemText/)
+- MUI: [`ListItemText`](../docs/reference/mui.md#list-item-text)
 
 ## Cross-reference
 

package/examples/component-list-item.md

@@ -106,7 +106,7 @@ Slots: leading icon/avatar (optional), text block (`ListItemText`), trailing sec
 
 ## References
 
-- MUI: [`ListItem.d.ts`](../refs/mui/packages/mui-material/src/ListItem/ListItem.d.ts)
+- MUI: [`ListItem.d.ts`](../docs/reference/mui.md#list-item)
 
 ## Cross-reference
 

package/examples/component-list-subheader.md

@@ -62,7 +62,7 @@
 
 ## References
 
-- MUI: [`ListSubheader`](../refs/mui/packages/mui-material/src/ListSubheader/)
+- MUI: [`ListSubheader`](../docs/reference/mui.md#list-subheader)
 
 ## Cross-reference
 

package/examples/component-list.md

@@ -186,8 +186,8 @@ function NotificationList() {
 
 ## References
 
-- Ant: [`List`](../refs/ant-design/components/list)
-- MUI: [`List`](../refs/mui/packages/mui-material/src/List) + [`ListItem`](../refs/mui/packages/mui-material/src/ListItem)
+- Ant: [`List`](../docs/reference/ant-design.md#list)
+- MUI: [`List`](../docs/reference/mui.md#list) + [`ListItem`](../docs/reference/mui.md#list-item)
 - HTML5 `<ul>` / `<ol>` / `<li>`
 
 ## Cross-reference

package/examples/component-masonry.md

@@ -180,7 +180,7 @@ function PhotoGallery({ photos }: Props) {
 
 ## References
 
-- MUI: [`Masonry`](../refs/mui/packages/mui-material/src/Masonry)
+- MUI: [`Masonry`](../docs/reference/mui.md)
 - CSS Multicolumn Layout (MDN)
 - Pinterest engineering blog on Masonry layout
 

package/examples/component-mentions.md

@@ -177,7 +177,7 @@ When chip inserted: announce via live region: "김민지 mentioned" or similar.
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/mentions/`](../refs/ant-design/components/mentions/) — `Mentions`. Multi-trigger support, async data.
+- Ant Design: [`refs/ant-design/components/mentions/`](../docs/reference/ant-design.md#mentions) — `Mentions`. Multi-trigger support, async data.
 - MUI: no built-in. Use `react-mentions` or build on Slate.
 - shadcn-ui: no built-in. Compose with `command` (cmdk) + textarea + custom popover positioning.
 

package/examples/component-menu-item.md

@@ -92,7 +92,7 @@
 
 ## References
 
-- MUI: [`MenuItem.d.ts`](../refs/mui/packages/mui-material/src/MenuItem/MenuItem.d.ts)
+- MUI: [`MenuItem.d.ts`](../docs/reference/mui.md#menu-item)
 
 ## Cross-reference
 

package/examples/component-menu-list.md

@@ -89,7 +89,7 @@ Layout/keyboard primitive — no own visual states. Children own theirs.
 
 ## References
 
-- MUI: [`MenuList`](../refs/mui/packages/mui-material/src/MenuList/)
+- MUI: [`MenuList`](../docs/reference/mui.md#menu-list)
 
 ## Cross-reference
 

package/examples/component-menu.md

@@ -128,7 +128,7 @@ Like `vertical` but SubMenus expand inline (push items below). Vs vertical's pop
 
 ## References
 
-- Ant: [`Menu`](../refs/ant-design/components/menu)
+- Ant: [`Menu`](../docs/reference/ant-design.md#menu)
 - WAI-ARIA: Menu pattern (different from menubar)
 
 ## Cross-reference

package/examples/component-menubar.md

@@ -247,7 +247,7 @@ function EditorHeader() {
 
 ## References
 
-- shadcn-ui: [`menubar`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/menubar.tsx) (Radix)
+- shadcn-ui: [`menubar`](../docs/reference/shadcn-ui.md#menubar) (Radix)
 - Patterns: macOS native menubar, VS Code, Figma desktop apps
 - WAI-ARIA: [Menubar pattern](https://www.w3.org/WAI/ARIA/apg/patterns/menubar/)
 

package/examples/component-message.md

@@ -152,7 +152,7 @@ async function handleCopy() {
 
 ## References
 
-- Ant: [`Message`](../refs/ant-design/components/message)
+- Ant: [`Message`](../docs/reference/ant-design.md#message)
 - Patterns: same family as iOS HUD, Material Snackbar (variant)
 
 ## Cross-reference

package/examples/component-mobile-stepper.md

@@ -145,7 +145,7 @@ function OnboardingFlow() {
 
 ## References
 
-- MUI: [`MobileStepper`](../refs/mui/packages/mui-material/src/MobileStepper/)
+- MUI: [`MobileStepper`](../docs/reference/mui.md#mobile-stepper)
 
 ## Cross-reference
 

package/examples/component-modal.md

@@ -200,12 +200,12 @@ const [open, setOpen] = useState(false);
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/modal/`](../refs/ant-design/components/modal/) — exhaustive: `Modal`, `Modal.confirm`, `Modal.info`, `Modal.success`, `Modal.error`, `Modal.warning`. Imperative API via `Modal.confirm({...})` is convenient but harder to test. The static methods are an Ant idiom worth knowing about.
-- MUI: [`refs/mui/packages/mui-material/src/Dialog/Dialog.tsx`](../refs/mui/packages/mui-material/src/Dialog/) — composition-first: `<Dialog>`, `<DialogTitle>`, `<DialogContent>`, `<DialogActions>`. Cleanest base API.
+- Ant Design: [`refs/ant-design/components/modal/`](../docs/reference/ant-design.md#modal) — exhaustive: `Modal`, `Modal.confirm`, `Modal.info`, `Modal.success`, `Modal.error`, `Modal.warning`. Imperative API via `Modal.confirm({...})` is convenient but harder to test. The static methods are an Ant idiom worth knowing about.
+- MUI: [`refs/mui/packages/mui-material/src/Dialog/Dialog.tsx`](../docs/reference/mui.md#dialog) — composition-first: `<Dialog>`, `<DialogTitle>`, `<DialogContent>`, `<DialogActions>`. Cleanest base API.
 - shadcn-ui:
-  - [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/dialog.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/dialog.tsx) — Radix Dialog primitive, all a11y handled upstream.
-  - [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/alert-dialog.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/alert-dialog.tsx) — separate primitive for confirms; difference is `role="alertdialog"` and modal cannot be dismissed via Escape/backdrop unless code-driven.
-  - [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/sheet.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/sheet.tsx) — edge-anchored variant.
+  - [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/dialog.tsx`](../docs/reference/shadcn-ui.md#dialog) — Radix Dialog primitive, all a11y handled upstream.
+  - [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/alert-dialog.tsx`](../docs/reference/shadcn-ui.md#alert-dialog) — separate primitive for confirms; difference is `role="alertdialog"` and modal cannot be dismissed via Escape/backdrop unless code-driven.
+  - [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/sheet.tsx`](../docs/reference/shadcn-ui.md#sheet) — edge-anchored variant.
 
 API choices made:
 - **Three variants in one spec** (`dialog`/`alert-dialog`/`sheet`) — same focus-management contract, same a11y pattern, same composition. Fewer concepts to learn than three separate components with overlapping concerns.

package/examples/component-navigation-menu.md

@@ -283,7 +283,7 @@ function MarketingHeader() {
 
 ## References
 
-- shadcn-ui: [`navigation-menu`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/navigation-menu.tsx) (Radix)
+- shadcn-ui: [`navigation-menu`](../docs/reference/shadcn-ui.md#navigation-menu) (Radix)
 - Patterns: Stripe, Linear, Vercel marketing nav
 
 ## Cross-reference

package/examples/component-notification.md

@@ -155,7 +155,7 @@ function NewMessageNotification({ message }: Props) {
 
 ## References
 
-- Ant: [`Notification`](../refs/ant-design/components/notification)
+- Ant: [`Notification`](../docs/reference/ant-design.md#notification)
 - Native browser Notification API (different — uses OS-level notifications)
 - iOS / Android notification card patterns
 

package/examples/component-outlined-input.md

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

package/examples/component-pagination.md

@@ -210,9 +210,9 @@ Implementation: read from `useSearchParams` in React Router / Next.js. Update qu
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/pagination/`](../refs/ant-design/components/pagination/) — most exhaustive: `simple`, `total`, `showSizeChanger`, `showJumper`, `itemRender`, `disabled`, `responsive`. Common in admin tables.
-- MUI: [`refs/mui/packages/mui-material/src/Pagination/`](../refs/mui/packages/mui-material/src/Pagination/) — `Pagination` + `PaginationItem`. Cleaner API, fewer features.
-- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/pagination.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/pagination.tsx) — primitive only (`Pagination`, `PaginationContent`, `PaginationItem`, `PaginationLink`, `PaginationPrevious`, `PaginationNext`, `PaginationEllipsis`). Compose for behavior. **No built-in pagination logic** — pair with TanStack Table or your own state.
+- Ant Design: [`refs/ant-design/components/pagination/`](../docs/reference/ant-design.md#pagination) — most exhaustive: `simple`, `total`, `showSizeChanger`, `showJumper`, `itemRender`, `disabled`, `responsive`. Common in admin tables.
+- MUI: [`refs/mui/packages/mui-material/src/Pagination/`](../docs/reference/mui.md#pagination) — `Pagination` + `PaginationItem`. Cleaner API, fewer features.
+- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/pagination.tsx`](../docs/reference/shadcn-ui.md#pagination) — primitive only (`Pagination`, `PaginationContent`, `PaginationItem`, `PaginationLink`, `PaginationPrevious`, `PaginationNext`, `PaginationEllipsis`). Compose for behavior. **No built-in pagination logic** — pair with TanStack Table or your own state.
 
 API choices made:
 - **`siblingCount` and `boundaryCount` exposed**: lets the consumer tune the numbered display algorithm without overriding rendering.

package/examples/component-paper.md

@@ -189,7 +189,7 @@ function EditorToolbar() {
 
 ## References
 
-- MUI: [`Paper`](../refs/mui/packages/mui-material/src/Paper)
+- MUI: [`Paper`](../docs/reference/mui.md#paper)
 - Material Design: [Elevation](https://m3.material.io/styles/elevation/overview)
 
 ## Cross-reference

package/examples/component-popconfirm.md

@@ -135,7 +135,7 @@ function ItemRow({ item }: Props) {
 
 ## References
 
-- Ant: [`Popconfirm`](../refs/ant-design/components/popconfirm)
+- Ant: [`Popconfirm`](../docs/reference/ant-design.md#popconfirm)
 
 ## Cross-reference
 

package/examples/component-popover.md

@@ -226,9 +226,9 @@ Don't put interactive content in a tooltip. Tooltips disappear on mouse-out.
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/popover/`](../refs/ant-design/components/popover/) — `Popover` with rich placement, `trigger="hover" | "click" | "focus"`. Hover trigger is generally avoided in modern UIs.
-- MUI: [`refs/mui/packages/mui-material/src/Popper/`](../refs/mui/packages/mui-material/src/Popper/) — low-level positioning primitive. `Popover` adds backdrop + focus management.
-- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/popover.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/popover.tsx) — Radix Popover primitive. **Default for new projects.**
+- Ant Design: [`refs/ant-design/components/popover/`](../docs/reference/ant-design.md#popover) — `Popover` with rich placement, `trigger="hover" | "click" | "focus"`. Hover trigger is generally avoided in modern UIs.
+- MUI: [`refs/mui/packages/mui-material/src/Popper/`](../docs/reference/mui.md#popper) — low-level positioning primitive. `Popover` adds backdrop + focus management.
+- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/popover.tsx`](../docs/reference/shadcn-ui.md#popover) — Radix Popover primitive. **Default for new projects.**
 
 ## Cross-reference
 

package/examples/component-popper.md

@@ -118,7 +118,7 @@ function DateHoverPreview({ date }: Props) {
 
 ## References
 
-- MUI: [`Popper`](../refs/mui/packages/mui-material/src/Popper)
+- MUI: [`Popper`](../docs/reference/mui.md#popper)
 - Popper.js (deprecated; use @floating-ui)
 - @floating-ui/react — modern replacement
 

package/examples/component-progress.md

@@ -184,9 +184,9 @@ Circular: full rotation, 1000ms loop, linear easing. The arc itself can also pul
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/progress/`](../refs/ant-design/components/progress/) — `Progress` with `type="line" | "circle" | "dashboard"` (3/4 ring), `steps` (segmented), `success` (overlay).
+- Ant Design: [`refs/ant-design/components/progress/`](../docs/reference/ant-design.md#progress) — `Progress` with `type="line" | "circle" | "dashboard"` (3/4 ring), `steps` (segmented), `success` (overlay).
 - MUI: separate `LinearProgress` and `CircularProgress` components. `variant="determinate" | "indeterminate" | "buffer" | "query"`. Buffer mode for media playback.
-- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/progress.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/progress.tsx) — Radix primitive. Linear only. Circular requires a different primitive.
+- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/progress.tsx`](../docs/reference/shadcn-ui.md#progress) — Radix primitive. Linear only. Circular requires a different primitive.
 
 ## Cross-reference
 

package/examples/component-qr-code.md

@@ -186,7 +186,7 @@ function PaymentQRScreen({ session }) {
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/qr-code/`](../refs/ant-design/components/qr-code/) — `QRCode` with all options.
+- Ant Design: [`refs/ant-design/components/qr-code/`](../docs/reference/ant-design.md#qr-code) — `QRCode` with all options.
 - MUI: no built-in. Use libraries like `qrcode.react` or `react-qr-code`.
 - shadcn-ui: no built-in. Use libraries.
 

package/examples/component-radio.md

@@ -155,9 +155,9 @@ function PaymentMethodPicker({ value, onChange }: Props) {
 
 ## References
 
-- Ant: [`Radio`](../refs/ant-design/components/radio)
-- MUI: [`Radio`](../refs/mui/packages/mui-material/src/Radio)
-- shadcn-ui: [`radio-group`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/radio-group.tsx)
+- Ant: [`Radio`](../docs/reference/ant-design.md#radio)
+- MUI: [`Radio`](../docs/reference/mui.md#radio)
+- shadcn-ui: [`radio-group`](../docs/reference/shadcn-ui.md#radio-group)
 - WAI-ARIA: [Radio Group pattern](https://www.w3.org/WAI/ARIA/apg/patterns/radio/)
 
 ## Cross-reference

package/examples/component-rate.md

@@ -192,8 +192,8 @@ For display mode (readOnly):
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/rate/`](../refs/ant-design/components/rate/) — `Rate` with `count`, `allowHalf`, `tooltips`, custom `character`. Most flexible.
-- MUI: [`refs/mui/packages/mui-material/src/Rating/`](../refs/mui/packages/mui-material/src/Rating/) — `Rating` with `precision`, `IconContainerComponent`, `getLabelText` for a11y. Solid impl.
+- Ant Design: [`refs/ant-design/components/rate/`](../docs/reference/ant-design.md#rate) — `Rate` with `count`, `allowHalf`, `tooltips`, custom `character`. Most flexible.
+- MUI: [`refs/mui/packages/mui-material/src/Rating/`](../docs/reference/mui.md#rating) — `Rating` with `precision`, `IconContainerComponent`, `getLabelText` for a11y. Solid impl.
 - shadcn-ui: no built-in. Compose from icons + state.
 
 ## Cross-reference

package/examples/component-resizable.md

@@ -153,7 +153,7 @@ function IDEShell() {
 
 ## References
 
-- shadcn-ui: [`resizable`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/resizable.tsx) — wraps `react-resizable-panels`
+- shadcn-ui: [`resizable`](../docs/reference/shadcn-ui.md#resizable) — wraps `react-resizable-panels`
 - VS Code, Linear, Cursor — IDE layout pattern
 
 ## Cross-reference

package/examples/component-result.md

@@ -252,7 +252,7 @@ Horizontal compact. Icon left, text right. For inside small cards/sidebars where
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/result/`](../refs/ant-design/components/result/) (Result) + [`refs/ant-design/components/empty/`](../refs/ant-design/components/empty/) (Empty). Both well-developed.
+- Ant Design: [`refs/ant-design/components/result/`](../docs/reference/ant-design.md#result) (Result) + [`refs/ant-design/components/empty/`](../docs/reference/ant-design.md#empty) (Empty). Both well-developed.
 - MUI: no dedicated components. Compose with Card + Typography.
 - shadcn-ui: no built-in. Compose from primitives.
 

package/examples/component-scroll-area.md

@@ -189,7 +189,7 @@ function Sidebar() {
 
 ## References
 
-- shadcn-ui: [`scroll-area`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/scroll-area.tsx) (Radix)
+- shadcn-ui: [`scroll-area`](../docs/reference/shadcn-ui.md#scroll-area) (Radix)
 - CSS `scrollbar-color`, `scrollbar-width` properties (browser-specific styling alternative)
 
 ## Cross-reference

package/examples/component-segmented.md

@@ -167,9 +167,9 @@ For Korean apps: short labels (1–4 syllables) work best.
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/segmented/`](../refs/ant-design/components/segmented/) — `Segmented` with options, sizes, block mode, custom rendering. Modern Ant addition.
-- MUI: [`refs/mui/packages/mui-material/src/ToggleButtonGroup/`](../refs/mui/packages/mui-material/src/ToggleButtonGroup/) — supports both single and multiple. Set `exclusive={true}` for segmented behavior.
-- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/) — `toggle-group.tsx`. Radix Toggle Group primitive.
+- Ant Design: [`refs/ant-design/components/segmented/`](../docs/reference/ant-design.md#segmented) — `Segmented` with options, sizes, block mode, custom rendering. Modern Ant addition.
+- MUI: [`refs/mui/packages/mui-material/src/ToggleButtonGroup/`](../docs/reference/mui.md#toggle-button-group) — supports both single and multiple. Set `exclusive={true}` for segmented behavior.
+- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/`](../docs/reference/shadcn-ui.md) — `toggle-group.tsx`. Radix Toggle Group primitive.
 
 ## Cross-reference
 

package/examples/component-select.md

@@ -239,11 +239,11 @@ This is one of the more complex a11y components. Use a battle-tested primitive (
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/select/`](../refs/ant-design/components/select/) — `Select`, supports `mode="multiple"`, `mode="tags"` (creatable). Has `Cascader` for hierarchical select.
+- Ant Design: [`refs/ant-design/components/select/`](../docs/reference/ant-design.md#select) — `Select`, supports `mode="multiple"`, `mode="tags"` (creatable). Has `Cascader` for hierarchical select.
 - MUI: `<Select>` (basic, like native) and `<Autocomplete>` (combobox). Autocomplete is the canonical reference for the searchable variant.
 - shadcn-ui:
-  - [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/select.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/select.tsx) — Radix Select. No search.
-  - [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/command.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/command.tsx) — cmdk-based searchable. Combine with Popover for combobox pattern.
+  - [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/select.tsx`](../docs/reference/shadcn-ui.md#select) — Radix Select. No search.
+  - [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/command.tsx`](../docs/reference/shadcn-ui.md#command) — cmdk-based searchable. Combine with Popover for combobox pattern.
 
 API choices made:
 - **`Select` and `MultiSelect` as separate top-level exports** for type safety on `value` (single value vs array). Internally same primitive with `multiple={true|false}`.

package/examples/component-separator.md

@@ -168,7 +168,7 @@ For Korean print contexts (receipt-style dotted dividers): `border-style: dotted
 ## References
 
 - HTML5 `<hr>` element
-- shadcn-ui: [`separator`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/separator.tsx) (Radix)
+- shadcn-ui: [`separator`](../docs/reference/shadcn-ui.md#separator) (Radix)
 - Ant Design `Divider` is the equivalent name there
 
 ## Cross-reference

package/examples/component-sheet.md

@@ -265,7 +265,7 @@ function FilterSheet({ filters, onChange, onApply }: Props) {
 
 ## References
 
-- shadcn-ui: [`sheet`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/sheet.tsx) (Radix Dialog primitive)
+- shadcn-ui: [`sheet`](../docs/reference/shadcn-ui.md#sheet) (Radix Dialog primitive)
 - Material 3: bottom sheet pattern
 - iOS: UISheetPresentationController detents
 

package/examples/component-sidebar.md

@@ -246,7 +246,7 @@ function AppShell({ children }: Props) {
 
 ## References
 
-- shadcn-ui: [`sidebar`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/sidebar.tsx) — flagship primitive
+- shadcn-ui: [`sidebar`](../docs/reference/shadcn-ui.md#sidebar) — flagship primitive
 - Patterns: VS Code, Linear, Notion sidebars
 
 ## Cross-reference

package/examples/component-skeleton.md

@@ -168,9 +168,9 @@ The skeleton still renders (showing layout); just no animation.
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/skeleton/`](../refs/ant-design/components/skeleton/) — most exhaustive: `Skeleton.Avatar`, `Skeleton.Button`, `Skeleton.Image`, `Skeleton.Input`, `Skeleton.Node`. Pre-composed shapes for common components.
-- MUI: [`refs/mui/packages/mui-material/src/Skeleton/`](../refs/mui/packages/mui-material/src/Skeleton/) — primitive only. Composition is up to the consumer.
-- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/skeleton.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/skeleton.tsx) — minimal Tailwind-based primitive.
+- Ant Design: [`refs/ant-design/components/skeleton/`](../docs/reference/ant-design.md#skeleton) — most exhaustive: `Skeleton.Avatar`, `Skeleton.Button`, `Skeleton.Image`, `Skeleton.Input`, `Skeleton.Node`. Pre-composed shapes for common components.
+- MUI: [`refs/mui/packages/mui-material/src/Skeleton/`](../docs/reference/mui.md#skeleton) — primitive only. Composition is up to the consumer.
+- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/skeleton.tsx`](../docs/reference/shadcn-ui.md#skeleton) — minimal Tailwind-based primitive.
 
 ## Cross-reference
 

package/examples/component-slide.md

@@ -78,7 +78,7 @@ Direction variants flip the translate axis.
 
 ## References
 
-- MUI: [`Slide`](../refs/mui/packages/mui-material/src/Slide)
+- MUI: [`Slide`](../docs/reference/mui.md#slide)
 - Material Design motion
 
 ## Cross-reference

package/examples/component-slider.md

@@ -198,9 +198,9 @@ For range slider with overlapping thumbs: each thumb maintains independent focus
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/slider/`](../refs/ant-design/components/slider/) — `Slider` with `range`, `marks`, `step`, `included` (whether range fill shows). Solid impl.
-- MUI: [`refs/mui/packages/mui-material/src/Slider/`](../refs/mui/packages/mui-material/src/Slider/) — `Slider` with rich `marks`, `valueLabelDisplay`, `track="normal" | "false" | "inverted"`. Most comprehensive.
-- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/slider.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/slider.tsx) — Radix Slider primitive. Simplest API.
+- Ant Design: [`refs/ant-design/components/slider/`](../docs/reference/ant-design.md#slider) — `Slider` with `range`, `marks`, `step`, `included` (whether range fill shows). Solid impl.
+- MUI: [`refs/mui/packages/mui-material/src/Slider/`](../docs/reference/mui.md#slider) — `Slider` with rich `marks`, `valueLabelDisplay`, `track="normal" | "false" | "inverted"`. Most comprehensive.
+- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/slider.tsx`](../docs/reference/shadcn-ui.md#slider) — Radix Slider primitive. Simplest API.
 
 ## Cross-reference
 

package/examples/component-snackbar-content.md

@@ -83,7 +83,7 @@
 
 ## References
 
-- MUI: [`SnackbarContent`](../refs/mui/packages/mui-material/src/SnackbarContent/)
+- MUI: [`SnackbarContent`](../docs/reference/mui.md#snackbar-content)
 
 ## Cross-reference
 

package/examples/component-snackbar.md

@@ -111,7 +111,7 @@ async function deleteItem(id: string) {
 
 ## References
 
-- MUI: [`Snackbar`](../refs/mui/packages/mui-material/src/Snackbar)
+- MUI: [`Snackbar`](../docs/reference/mui.md#snackbar)
 - Material 3: Snackbar pattern
 
 ## Cross-reference

package/examples/component-sonner.md

@@ -156,7 +156,7 @@ async function handleSave() {
 
 ## References
 
-- shadcn-ui: [`sonner`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/sonner.tsx)
+- shadcn-ui: [`sonner`](../docs/reference/shadcn-ui.md#sonner)
 - Sonner library by emilkowalski
 
 ## Cross-reference

package/examples/component-space.md

@@ -115,7 +115,7 @@ Modern CSS makes Space largely unnecessary — `display: flex; gap: var(--space-
 
 ## References
 
-- Ant: [`Space`](../refs/ant-design/components/space)
+- Ant: [`Space`](../docs/reference/ant-design.md#space)
 - CSS Flex / Grid `gap` property
 
 ## Cross-reference

package/examples/component-speed-dial-action.md

@@ -70,7 +70,7 @@ Inherits from parent SpeedDial's tokens.
 
 ## References
 
-- MUI: [`SpeedDialAction`](../refs/mui/packages/mui-material/src/SpeedDialAction)
+- MUI: [`SpeedDialAction`](../docs/reference/mui.md#speed-dial-action)
 
 ## Cross-reference
 

package/examples/component-speed-dial.md

@@ -167,7 +167,7 @@ function MobileApp() {
 
 ## References
 
-- MUI: [`SpeedDial`](../refs/mui/packages/mui-material/src/SpeedDial)
+- MUI: [`SpeedDial`](../docs/reference/mui.md#speed-dial)
 - Material Design: SpeedDial pattern
 - Patterns: Twitter / Instagram compose FAB