@design-ai/cli 4.56.0 → 4.57.0

package/docs/reference/shadcn-ui.md

@@ -0,0 +1,298 @@
+<!-- generated: tools/extractors/reference_pages.py — do not edit by hand -->
+
+# shadcn/ui source reference
+
+Modern Radix-based copy-paste component model.
+
+Generated index of `refs/shadcn-ui/` sources cited by the knowledge corpus. The local mirror is gitignored; every entry below links to the same path in the upstream repository.
+
+- Upstream: [shadcn-ui/ui](https://github.com/shadcn-ui/ui)
+- License: see the upstream repository's license file
+- Local mirror: `refs/shadcn-ui/` (refresh with `./tools/extractors/run-all.sh`)
+
+Entries: 57
+
+## _registry
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/_registry.ts`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/_registry.ts)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/_registry.ts`
+
+## accordion
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/accordion.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/accordion.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/accordion.tsx`
+
+## alert-dialog
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/alert-dialog.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/alert-dialog.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/alert-dialog.tsx`
+
+## alert
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/alert.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/alert.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/alert.tsx`
+
+## aspect-ratio
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/aspect-ratio.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/aspect-ratio.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/aspect-ratio.tsx`
+
+## avatar
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/avatar.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/avatar.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/avatar.tsx`
+
+## badge
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/badge.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/badge.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/badge.tsx`
+
+## breadcrumb
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/breadcrumb.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/breadcrumb.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/breadcrumb.tsx`
+
+## button-group
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/button-group.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/button-group.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/button-group.tsx`
+
+## button
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/button.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/button.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/button.tsx`
+
+## calendar
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/calendar.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/calendar.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/calendar.tsx`
+
+## card
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/card.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/card.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/card.tsx`
+
+## carousel
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/carousel.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/carousel.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/carousel.tsx`
+
+## chart
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/chart.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/chart.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/chart.tsx`
+
+## checkbox
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/checkbox.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/checkbox.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/checkbox.tsx`
+
+## collapsible
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/collapsible.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/collapsible.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/collapsible.tsx`
+
+## combobox
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/combobox.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/combobox.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/combobox.tsx`
+
+## command
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/command.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/command.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/command.tsx`
+
+## context-menu
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/context-menu.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/context-menu.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/context-menu.tsx`
+
+## dialog
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/dialog.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/dialog.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/dialog.tsx`
+
+## direction
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/direction.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/direction.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/direction.tsx`
+
+## drawer
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/drawer.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/drawer.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/drawer.tsx`
+
+## dropdown-menu
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/dropdown-menu.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/dropdown-menu.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/dropdown-menu.tsx`
+
+## empty
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/empty.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/empty.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/empty.tsx`
+
+## field
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/field.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/field.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/field.tsx`
+
+## form
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/form.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/form.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/form.tsx`
+
+## hover-card
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/hover-card.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/hover-card.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/hover-card.tsx`
+
+## input-group
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/input-group.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/input-group.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/input-group.tsx`
+
+## input-otp
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/input-otp.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/input-otp.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/input-otp.tsx`
+
+## input
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/input.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/input.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/input.tsx`
+
+## item
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/item.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/item.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/item.tsx`
+
+## kbd
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/kbd.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/kbd.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/kbd.tsx`
+
+## label
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/label.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/label.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/label.tsx`
+
+## menubar
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/menubar.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/menubar.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/menubar.tsx`
+
+## native-select
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/native-select.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/native-select.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/native-select.tsx`
+
+## navigation-menu
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/navigation-menu.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/navigation-menu.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/navigation-menu.tsx`
+
+## pagination
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/pagination.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/pagination.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/pagination.tsx`
+
+## popover
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/popover.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/popover.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/popover.tsx`
+
+## progress
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/progress.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/progress.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/progress.tsx`
+
+## radio-group
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/radio-group.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/radio-group.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/radio-group.tsx`
+
+## resizable
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/resizable.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/resizable.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/resizable.tsx`
+
+## scroll-area
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/scroll-area.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/scroll-area.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/scroll-area.tsx`
+
+## select
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/select.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/select.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/select.tsx`
+
+## separator
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/separator.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/separator.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/separator.tsx`
+
+## sheet
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/sheet.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/sheet.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/sheet.tsx`
+
+## sidebar
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/sidebar.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/sidebar.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/sidebar.tsx`
+
+## skeleton
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/skeleton.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/skeleton.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/skeleton.tsx`
+
+## slider
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/slider.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/slider.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/slider.tsx`
+
+## sonner
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/sonner.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/sonner.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/sonner.tsx`
+
+## spinner
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/spinner.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/spinner.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/spinner.tsx`
+
+## switch
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/switch.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/switch.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/switch.tsx`
+
+## table
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/table.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/table.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/table.tsx`
+
+## tabs
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/tabs.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/tabs.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/tabs.tsx`
+
+## textarea
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/textarea.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/textarea.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/textarea.tsx`
+
+## toggle-group
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/toggle-group.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/toggle-group.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/toggle-group.tsx`
+
+## toggle
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/toggle.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/toggle.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/toggle.tsx`
+
+## tooltip
+
+- Upstream: [`apps/v4/registry/new-york-v4/ui/tooltip.tsx`](https://github.com/shadcn-ui/ui/blob/HEAD/apps/v4/registry/new-york-v4/ui/tooltip.tsx)
+- Local mirror: `refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/tooltip.tsx`

package/examples/component-accordion-actions.md

@@ -140,11 +140,11 @@ If the row has a divider, use `--color-border-default`; do not introduce a new h
 
 ## References
 
-- MUI direct source: [`refs/mui/packages/mui-material/src/AccordionActions/AccordionActions.d.ts`](../refs/mui/packages/mui-material/src/AccordionActions/AccordionActions.d.ts)
-- MUI implementation: [`refs/mui/packages/mui-material/src/AccordionActions/AccordionActions.js`](../refs/mui/packages/mui-material/src/AccordionActions/AccordionActions.js)
-- Parent MUI composition: [`refs/mui/packages/mui-material/src/Accordion/`](../refs/mui/packages/mui-material/src/Accordion/)
-- Ant Design parent pattern: [`refs/ant-design/components/collapse/`](../refs/ant-design/components/collapse/)
-- shadcn-ui parent pattern: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/accordion.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/accordion.tsx)
+- MUI direct source: [`refs/mui/packages/mui-material/src/AccordionActions/AccordionActions.d.ts`](../docs/reference/mui.md#accordion-actions)
+- MUI implementation: [`refs/mui/packages/mui-material/src/AccordionActions/AccordionActions.js`](../docs/reference/mui.md#accordion-actions)
+- Parent MUI composition: [`refs/mui/packages/mui-material/src/Accordion/`](../docs/reference/mui.md#accordion)
+- Ant Design parent pattern: [`refs/ant-design/components/collapse/`](../docs/reference/ant-design.md#collapse)
+- shadcn-ui parent pattern: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/accordion.tsx`](../docs/reference/shadcn-ui.md#accordion)
 - Accessibility baseline: [`knowledge/a11y/keyboard-and-focus.md`](../knowledge/a11y/keyboard-and-focus.md)
 
 ## Cross-reference

package/examples/component-accordion-details.md

@@ -134,11 +134,11 @@ Accordion.Item
 
 ## References
 
-- MUI direct source: [`refs/mui/packages/mui-material/src/AccordionDetails/AccordionDetails.d.ts`](../refs/mui/packages/mui-material/src/AccordionDetails/AccordionDetails.d.ts)
-- MUI implementation: [`refs/mui/packages/mui-material/src/AccordionDetails/AccordionDetails.js`](../refs/mui/packages/mui-material/src/AccordionDetails/AccordionDetails.js)
-- Parent MUI composition: [`refs/mui/packages/mui-material/src/Accordion/`](../refs/mui/packages/mui-material/src/Accordion/)
-- Ant Design parent pattern: [`refs/ant-design/components/collapse/`](../refs/ant-design/components/collapse/)
-- shadcn-ui parent pattern: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/accordion.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/accordion.tsx)
+- MUI direct source: [`refs/mui/packages/mui-material/src/AccordionDetails/AccordionDetails.d.ts`](../docs/reference/mui.md#accordion-details)
+- MUI implementation: [`refs/mui/packages/mui-material/src/AccordionDetails/AccordionDetails.js`](../docs/reference/mui.md#accordion-details)
+- Parent MUI composition: [`refs/mui/packages/mui-material/src/Accordion/`](../docs/reference/mui.md#accordion)
+- Ant Design parent pattern: [`refs/ant-design/components/collapse/`](../docs/reference/ant-design.md#collapse)
+- shadcn-ui parent pattern: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/accordion.tsx`](../docs/reference/shadcn-ui.md#accordion)
 - Accessibility baseline: [`knowledge/a11y/keyboard-and-focus.md`](../knowledge/a11y/keyboard-and-focus.md)
 
 ## Cross-reference

package/examples/component-accordion-summary.md

@@ -165,11 +165,11 @@ Inherits button-like props from MUI `ButtonBase` in MUI implementations.
 
 ## References
 
-- MUI direct source: [`refs/mui/packages/mui-material/src/AccordionSummary/AccordionSummary.d.ts`](../refs/mui/packages/mui-material/src/AccordionSummary/AccordionSummary.d.ts)
-- MUI implementation: [`refs/mui/packages/mui-material/src/AccordionSummary/AccordionSummary.js`](../refs/mui/packages/mui-material/src/AccordionSummary/AccordionSummary.js)
-- Parent MUI composition: [`refs/mui/packages/mui-material/src/Accordion/`](../refs/mui/packages/mui-material/src/Accordion/)
-- Ant Design parent pattern: [`refs/ant-design/components/collapse/`](../refs/ant-design/components/collapse/)
-- shadcn-ui parent pattern: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/accordion.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/accordion.tsx)
+- MUI direct source: [`refs/mui/packages/mui-material/src/AccordionSummary/AccordionSummary.d.ts`](../docs/reference/mui.md#accordion-summary)
+- MUI implementation: [`refs/mui/packages/mui-material/src/AccordionSummary/AccordionSummary.js`](../docs/reference/mui.md#accordion-summary)
+- Parent MUI composition: [`refs/mui/packages/mui-material/src/Accordion/`](../docs/reference/mui.md#accordion)
+- Ant Design parent pattern: [`refs/ant-design/components/collapse/`](../docs/reference/ant-design.md#collapse)
+- shadcn-ui parent pattern: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/accordion.tsx`](../docs/reference/shadcn-ui.md#accordion)
 - Accessibility baseline: [`knowledge/a11y/keyboard-and-focus.md`](../knowledge/a11y/keyboard-and-focus.md)
 - Motion baseline: [`knowledge/motion/principles.md`](../knowledge/motion/principles.md)
 

package/examples/component-accordion.md

@@ -218,9 +218,9 @@ Disable height transition. Toggle is instant (no 200ms).
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/collapse/`](../refs/ant-design/components/collapse/) — `Collapse` + `Collapse.Panel`. `accordion` prop forces single. Has nice `expandIcon` customization.
-- MUI: [`refs/mui/packages/mui-material/src/Accordion/`](../refs/mui/packages/mui-material/src/Accordion/) — `Accordion`, `AccordionSummary`, `AccordionDetails`, `AccordionActions`. Solid composition.
-- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/accordion.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/accordion.tsx) — Radix Accordion primitive. Cleanest a11y. **Default for new projects.**
+- Ant Design: [`refs/ant-design/components/collapse/`](../docs/reference/ant-design.md#collapse) — `Collapse` + `Collapse.Panel`. `accordion` prop forces single. Has nice `expandIcon` customization.
+- MUI: [`refs/mui/packages/mui-material/src/Accordion/`](../docs/reference/mui.md#accordion) — `Accordion`, `AccordionSummary`, `AccordionDetails`, `AccordionActions`. Solid composition.
+- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/accordion.tsx`](../docs/reference/shadcn-ui.md#accordion) — Radix Accordion primitive. Cleanest a11y. **Default for new projects.**
 
 ## Cross-reference
 

package/examples/component-affix.md

@@ -180,7 +180,7 @@ For sticky **alerts / banners**: respect `prefers-reduced-motion` and don't anim
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/affix/`](../refs/ant-design/components/affix/) — `Affix`. Wraps native sticky with React-friendly callbacks.
+- Ant Design: [`refs/ant-design/components/affix/`](../docs/reference/ant-design.md#affix) — `Affix`. Wraps native sticky with React-friendly callbacks.
 - MUI / shadcn-ui: no dedicated component. Use CSS `position: sticky`.
 
 ## Cross-reference

package/examples/component-alert-dialog.md

@@ -200,7 +200,7 @@ function DeleteProjectButton({ project }: Props) {
 
 ## References
 
-- shadcn-ui: [`alert-dialog`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/alert-dialog.tsx) (Radix)
+- shadcn-ui: [`alert-dialog`](../docs/reference/shadcn-ui.md#alert-dialog) (Radix)
 - WAI-ARIA: [`alertdialog`](https://www.w3.org/WAI/ARIA/apg/patterns/alertdialog/)
 
 ## Cross-reference

package/examples/component-alert-title.md

@@ -69,7 +69,7 @@ Extends `Typography` — typography props work.
 
 ## References
 
-- MUI: [`AlertTitle`](../refs/mui/packages/mui-material/src/AlertTitle/)
+- MUI: [`AlertTitle`](../docs/reference/mui.md#alert-title)
 
 ## Cross-reference
 

package/examples/component-alert.md

@@ -176,9 +176,9 @@ Alerts don't have hover/active themselves — only their nested actions do.
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/alert/`](../refs/ant-design/components/alert/) — `Alert`, `Alert.ErrorBoundary`. Supports `closable`, `banner` variant, `showIcon`, `action`. Has a "banner" mode for full-width top banners.
-- MUI: [`refs/mui/packages/mui-material/src/Alert/`](../refs/mui/packages/mui-material/src/Alert/) — `Alert` + `AlertTitle`. Variants: `standard` (subtle), `filled` (solid), `outlined`. Closest to this spec.
-- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/alert.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/alert.tsx) — primitive (`Alert`, `AlertTitle`, `AlertDescription`). Composition; intent via className variant.
+- Ant Design: [`refs/ant-design/components/alert/`](../docs/reference/ant-design.md#alert) — `Alert`, `Alert.ErrorBoundary`. Supports `closable`, `banner` variant, `showIcon`, `action`. Has a "banner" mode for full-width top banners.
+- MUI: [`refs/mui/packages/mui-material/src/Alert/`](../docs/reference/mui.md#alert) — `Alert` + `AlertTitle`. Variants: `standard` (subtle), `filled` (solid), `outlined`. Closest to this spec.
+- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/alert.tsx`](../docs/reference/shadcn-ui.md#alert) — primitive (`Alert`, `AlertTitle`, `AlertDescription`). Composition; intent via className variant.
 
 API choices made:
 - **`actions` array prop** rather than children-only: 80% of alerts with actions need exactly 1–2 buttons; the prop is faster than composing.

package/examples/component-anchor.md

@@ -188,7 +188,7 @@ function DocsPage({ headings }: Props) {
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/anchor/`](../refs/ant-design/components/anchor/) — `Anchor`, `Anchor.Link`. Solid implementation.
+- Ant Design: [`refs/ant-design/components/anchor/`](../docs/reference/ant-design.md#anchor) — `Anchor`, `Anchor.Link`. Solid implementation.
 - MUI / shadcn-ui: no built-in. Compose with `IntersectionObserver` + custom CSS.
 
 ## Cross-reference

package/examples/component-app-bar.md

@@ -239,7 +239,7 @@ For chat/conversation headers: title shows the contact's name + online status:
 ## References
 
 - Ant Design: no dedicated AppBar — use `Layout.Header` + custom composition.
-- MUI: [`refs/mui/packages/mui-material/src/AppBar/`](../refs/mui/packages/mui-material/src/AppBar/) — `AppBar` with `position`, `color`, `elevation`. Material-aligned.
+- MUI: [`refs/mui/packages/mui-material/src/AppBar/`](../docs/reference/mui.md#app-bar) — `AppBar` with `position`, `color`, `elevation`. Material-aligned.
 - shadcn-ui: no built-in. Compose with custom header structure.
 
 ## Cross-reference

package/examples/component-aspect-ratio.md

@@ -146,7 +146,7 @@ function ProductCard({ product }: Props) {
 
 ## References
 
-- shadcn-ui: [`aspect-ratio`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/aspect-ratio.tsx) (Radix)
+- shadcn-ui: [`aspect-ratio`](../docs/reference/shadcn-ui.md#aspect-ratio) (Radix)
 - CSS: `aspect-ratio` property (Baseline 2021)
 
 ## Cross-reference

package/examples/component-auto-complete.md

@@ -188,8 +188,8 @@ When user selects an option: existing tag. When user types and commits: new tag.
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/auto-complete/`](../refs/ant-design/components/auto-complete/) — `AutoComplete`. Built on top of Select with free-text mode.
-- MUI: [`refs/mui/packages/mui-material/src/Autocomplete/`](../refs/mui/packages/mui-material/src/Autocomplete/) — `Autocomplete` with `freeSolo` prop. Most comprehensive.
+- Ant Design: [`refs/ant-design/components/auto-complete/`](../docs/reference/ant-design.md#auto-complete) — `AutoComplete`. Built on top of Select with free-text mode.
+- MUI: [`refs/mui/packages/mui-material/src/Autocomplete/`](../docs/reference/mui.md#autocomplete) — `Autocomplete` with `freeSolo` prop. Most comprehensive.
 - shadcn-ui: compose `command` (cmdk) + Popover for autocomplete-like behavior.
 
 ## Cross-reference

package/examples/component-avatar-group.md

@@ -157,11 +157,11 @@ If these avatar tokens do not exist, map them to the existing size, spacing, bor
 
 ## References
 
-- MUI direct source: [`refs/mui/packages/mui-material/src/AvatarGroup/AvatarGroup.d.ts`](../refs/mui/packages/mui-material/src/AvatarGroup/AvatarGroup.d.ts)
-- MUI implementation: [`refs/mui/packages/mui-material/src/AvatarGroup/AvatarGroup.js`](../refs/mui/packages/mui-material/src/AvatarGroup/AvatarGroup.js)
-- Ant Design parent pattern: [`refs/ant-design/components/avatar/`](../refs/ant-design/components/avatar/)
-- shadcn-ui avatar source: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/avatar.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/avatar.tsx)
-- shadcn-ui group examples: [`refs/shadcn-ui/apps/v4/examples/base/avatar-group.tsx`](../refs/shadcn-ui/apps/v4/examples/base/avatar-group.tsx)
+- MUI direct source: [`refs/mui/packages/mui-material/src/AvatarGroup/AvatarGroup.d.ts`](../docs/reference/mui.md#avatar-group)
+- MUI implementation: [`refs/mui/packages/mui-material/src/AvatarGroup/AvatarGroup.js`](../docs/reference/mui.md#avatar-group)
+- Ant Design parent pattern: [`refs/ant-design/components/avatar/`](../docs/reference/ant-design.md#avatar)
+- shadcn-ui avatar source: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/avatar.tsx`](../docs/reference/shadcn-ui.md#avatar)
+- shadcn-ui group examples: [`refs/shadcn-ui/apps/v4/examples/base/avatar-group.tsx`](../docs/reference/shadcn-ui.md)
 - Accessibility baseline: [`knowledge/a11y/keyboard-and-focus.md`](../knowledge/a11y/keyboard-and-focus.md)
 
 ## Cross-reference

package/examples/component-avatar.md

@@ -181,9 +181,9 @@ Pick colors with text readable in white.
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/avatar/`](../refs/ant-design/components/avatar/) — `Avatar`, `Avatar.Group`. `shape="circle" | "square"`. Multi-size + scaling for groups.
-- MUI: [`refs/mui/packages/mui-material/src/Avatar/`](../refs/mui/packages/mui-material/src/Avatar/) — `Avatar` + `AvatarGroup`. Falls back to first letter of `children` text.
-- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/avatar.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/avatar.tsx) — Radix Avatar primitive. Composition: `Avatar`, `AvatarImage`, `AvatarFallback`.
+- Ant Design: [`refs/ant-design/components/avatar/`](../docs/reference/ant-design.md#avatar) — `Avatar`, `Avatar.Group`. `shape="circle" | "square"`. Multi-size + scaling for groups.
+- MUI: [`refs/mui/packages/mui-material/src/Avatar/`](../docs/reference/mui.md#avatar) — `Avatar` + `AvatarGroup`. Falls back to first letter of `children` text.
+- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/avatar.tsx`](../docs/reference/shadcn-ui.md#avatar) — Radix Avatar primitive. Composition: `Avatar`, `AvatarImage`, `AvatarFallback`.
 
 ## Cross-reference
 

package/examples/component-back-top.md

@@ -114,7 +114,7 @@ window.scrollTo({ top: 0, behavior: reduced ? "auto" : "smooth" });
 
 ## References
 
-- Ant: [`BackTop`](../refs/ant-design/components/back-top)
+- Ant: [`BackTop`](../docs/reference/ant-design.md#back-top)
 - Native: `window.scrollTo({ behavior: "smooth" })`
 
 ## Cross-reference

package/examples/component-backdrop.md

@@ -138,7 +138,7 @@ function App() {
 
 ## References
 
-- MUI: [`Backdrop`](../refs/mui/packages/mui-material/src/Backdrop)
+- MUI: [`Backdrop`](../docs/reference/mui.md#backdrop)
 - Used internally by: Modal, Drawer, Sheet, AlertDialog
 
 ## Cross-reference

package/examples/component-badge.md

@@ -170,9 +170,9 @@ function ProductCard({ name, isNew, isOnSale }: Props) {
 
 ## References
 
-- Ant: [`Badge`](../refs/ant-design/components/badge)
-- MUI: [`Badge`](../refs/mui/packages/mui-material/src/Badge)
-- shadcn-ui: [`badge`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/badge.tsx)
+- Ant: [`Badge`](../docs/reference/ant-design.md#badge)
+- MUI: [`Badge`](../docs/reference/mui.md#badge)
+- shadcn-ui: [`badge`](../docs/reference/shadcn-ui.md#badge)
 
 ## Cross-reference
 

package/examples/component-border-beam.md

@@ -200,8 +200,8 @@ export function FeaturedModule({ title, description, action }: FeaturedModulePro
 
 ## References
 
-- Ant Design: [`BorderBeam.tsx`](../refs/ant-design/components/border-beam/BorderBeam.tsx), [`BorderBeamEffect.tsx`](../refs/ant-design/components/border-beam/BorderBeamEffect.tsx), [`border-beam/index.en-US.md`](../refs/ant-design/components/border-beam/index.en-US.md), [`border-beam/style/index.ts`](../refs/ant-design/components/border-beam/style/index.ts)
-- MUI: [`Paper.d.ts`](../refs/mui/packages/mui-material/src/Paper/Paper.d.ts), [`Card.d.ts`](../refs/mui/packages/mui-material/src/Card/Card.d.ts)
-- shadcn-ui: [`card.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/card.tsx)
+- Ant Design: [`BorderBeam.tsx`](../docs/reference/ant-design.md#border-beam), [`BorderBeamEffect.tsx`](../docs/reference/ant-design.md#border-beam), [`border-beam/index.en-US.md`](../docs/reference/ant-design.md#border-beam), [`border-beam/style/index.ts`](../docs/reference/ant-design.md#border-beam)
+- MUI: [`Paper.d.ts`](../docs/reference/mui.md#paper), [`Card.d.ts`](../docs/reference/mui.md#card)
+- shadcn-ui: [`card.tsx`](../docs/reference/shadcn-ui.md#card)
 - Knowledge: [`a11y/keyboard-and-focus.md`](../knowledge/a11y/keyboard-and-focus.md), [`motion/principles.md`](../knowledge/motion/principles.md), [`components/INDEX.md`](../knowledge/components/INDEX.md)
 - Cross-reference: [`component-card.md`](component-card.md), [`component-paper.md`](component-paper.md), [`component-button-base.md`](component-button-base.md)

package/examples/component-bottom-navigation.md

@@ -213,7 +213,7 @@ function MobileAppShell() {
 
 ## References
 
-- MUI: [`BottomNavigation`](../refs/mui/packages/mui-material/src/BottomNavigation)
+- MUI: [`BottomNavigation`](../docs/reference/mui.md#bottom-navigation)
 - iOS: UITabBar; Apple HIG → "Tab Bars"
 - Material 3: NavigationBar component
 - Patterns: Toss, KakaoBank, Instagram, Twitter

package/examples/component-box.md

@@ -101,7 +101,7 @@ Use Box when none of the above fit. If you find yourself using Box with `display
 
 ## References
 
-- MUI: [`Box`](../refs/mui/packages/mui-material/src/Box) — system-prop pioneer
+- MUI: [`Box`](../docs/reference/mui.md#box) — system-prop pioneer
 - Chakra UI Box (very similar API)
 - shadcn-ui: doesn't ship Box; uses Tailwind classes directly
 

package/examples/component-breadcrumb.md

@@ -212,9 +212,9 @@ The current item is **never** a link. It's where the user is.
 
 ## References
 
-- Ant Design: [`refs/ant-design/components/breadcrumb/`](../refs/ant-design/components/breadcrumb/) — `Breadcrumb` + `Breadcrumb.Item` + `Breadcrumb.Separator`. `itemRender` for custom rendering.
-- MUI: [`refs/mui/packages/mui-material/src/Breadcrumbs/`](../refs/mui/packages/mui-material/src/Breadcrumbs/) — `Breadcrumbs` (note plural) with `separator`, `maxItems`, `itemsBeforeCollapse`, `itemsAfterCollapse`. Built-in collapse logic.
-- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/breadcrumb.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/breadcrumb.tsx) — primitive: `Breadcrumb`, `BreadcrumbList`, `BreadcrumbItem`, `BreadcrumbLink`, `BreadcrumbPage`, `BreadcrumbSeparator`, `BreadcrumbEllipsis`. Most flexible.
+- Ant Design: [`refs/ant-design/components/breadcrumb/`](../docs/reference/ant-design.md#breadcrumb) — `Breadcrumb` + `Breadcrumb.Item` + `Breadcrumb.Separator`. `itemRender` for custom rendering.
+- MUI: [`refs/mui/packages/mui-material/src/Breadcrumbs/`](../docs/reference/mui.md#breadcrumbs) — `Breadcrumbs` (note plural) with `separator`, `maxItems`, `itemsBeforeCollapse`, `itemsAfterCollapse`. Built-in collapse logic.
+- shadcn-ui: [`refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/breadcrumb.tsx`](../docs/reference/shadcn-ui.md#breadcrumb) — primitive: `Breadcrumb`, `BreadcrumbList`, `BreadcrumbItem`, `BreadcrumbLink`, `BreadcrumbPage`, `BreadcrumbSeparator`, `BreadcrumbEllipsis`. Most flexible.
 
 ## Cross-reference
 

package/examples/component-button-base.md

@@ -183,8 +183,8 @@ export function ToolbarButton({
 
 ## References
 
-- MUI: [`ButtonBase.d.ts`](../refs/mui/packages/mui-material/src/ButtonBase/ButtonBase.d.ts), [`ButtonBase.js`](../refs/mui/packages/mui-material/src/ButtonBase/ButtonBase.js), [`useButtonBase.ts`](../refs/mui/packages/mui-material/src/ButtonBase/useButtonBase.ts)
-- Ant Design: [`Button.tsx`](../refs/ant-design/components/button/Button.tsx), [`button/index.en-US.md`](../refs/ant-design/components/button/index.en-US.md)
-- shadcn-ui: [`button.tsx`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/button.tsx)
+- MUI: [`ButtonBase.d.ts`](../docs/reference/mui.md#button-base), [`ButtonBase.js`](../docs/reference/mui.md#button-base), [`useButtonBase.ts`](../docs/reference/mui.md#button-base)
+- Ant Design: [`Button.tsx`](../docs/reference/ant-design.md#button), [`button/index.en-US.md`](../docs/reference/ant-design.md#button)
+- shadcn-ui: [`button.tsx`](../docs/reference/shadcn-ui.md#button)
 - Knowledge: [`a11y/keyboard-and-focus.md`](../knowledge/a11y/keyboard-and-focus.md), [`layout/spacing-and-grid.md`](../knowledge/layout/spacing-and-grid.md)
 - Cross-reference: [`component-button.md`](component-button.md), [`component-icon-button.md`](component-icon-button.md), [`component-toggle.md`](component-toggle.md)

package/examples/component-button-group.md

@@ -107,8 +107,8 @@ function EditorToolbar() {
 
 ## References
 
-- MUI: [`ButtonGroup`](../refs/mui/packages/mui-material/src/ButtonGroup)
-- shadcn-ui: [`button-group`](../refs/shadcn-ui/apps/v4/registry/new-york-v4/ui/button-group.tsx)
+- MUI: [`ButtonGroup`](../docs/reference/mui.md#button-group)
+- shadcn-ui: [`button-group`](../docs/reference/shadcn-ui.md#button-group)
 
 ## Cross-reference