tembro 1.0.0

package/packages/cli/vendor/src/families/migration-map.ts

@@ -0,0 +1,161 @@
+import type { ComponentFamilyName } from "@/families/catalog"
+
+export type FamilyMigrationStatus =
+  | "canonical"
+  | "family-member"
+  | "family-member helper"
+  | "canonical composed member"
+  | "transitional"
+  | "advanced"
+
+export type FamilyMigrationEntry = {
+  component: string
+  family: ComponentFamilyName
+  member?: string
+  status: FamilyMigrationStatus
+  notes?: string
+}
+
+export const componentFamilyMigrationMap: FamilyMigrationEntry[] = [
+  { component: "Input", family: "InputFamily", member: "Root", status: "canonical" },
+  { component: "Textarea", family: "InputFamily", member: "Textarea", status: "canonical composed member" },
+  { component: "FormInput", family: "InputFamily", member: "FormInput", status: "family-member helper" },
+  { component: "ClearableInput", family: "InputFamily", member: "Clearable", status: "transitional" },
+  { component: "SearchInput", family: "InputFamily", member: "Search", status: "transitional" },
+  { component: "PasswordInput", family: "InputFamily", member: "Password", status: "family-member" },
+  { component: "NumberInput", family: "InputFamily", member: "Number", status: "family-member" },
+  { component: "Slider", family: "InputFamily", member: "Slider", status: "advanced" },
+  { component: "RangeSlider", family: "InputFamily", member: "RangeSlider", status: "advanced" },
+  { component: "Rating", family: "InputFamily", member: "Rating", status: "advanced" },
+  { component: "DateInput", family: "InputFamily", member: "Date", status: "family-member" },
+  { component: "DateRangeInput", family: "InputFamily", member: "DateRange", status: "family-member" },
+  { component: "MoneyInput", family: "InputFamily", member: "Money", status: "family-member" },
+  { component: "QuantityInput", family: "InputFamily", member: "Quantity", status: "transitional" },
+  { component: "MaskedInput", family: "InputFamily", member: "Masked", status: "transitional" },
+  { component: "PhoneInput", family: "InputFamily", member: "Phone", status: "family-member" },
+  { component: "OtpInput", family: "InputFamily", member: "Otp", status: "advanced" },
+  { component: "ColorInput", family: "InputFamily", member: "Color", status: "advanced" },
+  { component: "TagInput", family: "InputFamily", member: "Tag", status: "advanced" },
+  { component: "QuantityStepper", family: "InputFamily", member: "QuantityStepper", status: "advanced" },
+
+  { component: "Select", family: "SelectFamily", member: "Root", status: "canonical" },
+  { component: "SimpleSelect", family: "SelectFamily", member: "Simple", status: "transitional" },
+  { component: "AsyncSelect", family: "SelectFamily", member: "Async", status: "family-member" },
+  { component: "AsyncMultiSelect", family: "SelectFamily", member: "AsyncMulti", status: "advanced" },
+  { component: "Combobox", family: "SelectFamily", member: "Combobox", status: "family-member" },
+  { component: "FormSelect", family: "SelectFamily", member: "Form.Select", status: "family-member" },
+  { component: "FormAsyncSelect", family: "SelectFamily", member: "Form.Async", status: "transitional" },
+
+  { component: "Card", family: "CardFamily", member: "Root", status: "canonical" },
+  { component: "InfoCard", family: "CardFamily", member: "Info", status: "canonical composed member" },
+  { component: "SmartCard", family: "CardFamily", member: "Info", status: "transitional", notes: "Prefer InfoCard or CardFamily.Info in docs and new usage." },
+  { component: "StatCard", family: "CardFamily", member: "Stat", status: "transitional", notes: "Prefer StatisticCard or InfoCard for new usage." },
+  { component: "StatisticCard", family: "CardFamily", member: "Statistic", status: "family-member" },
+  { component: "EntityCard", family: "CardFamily", member: "Entity", status: "family-member" },
+  { component: "FileCard", family: "CardFamily", member: "File", status: "family-member" },
+
+  { component: "Badge", family: "BadgeFamily", member: "Root", status: "canonical" },
+
+  { component: "Dialog", family: "OverlayFamily", member: "Dialog", status: "canonical" },
+  { component: "Popover", family: "OverlayFamily", member: "Popover", status: "canonical" },
+  { component: "DropdownMenu", family: "OverlayFamily", member: "DropdownMenu", status: "canonical" },
+  { component: "Tooltip", family: "OverlayFamily", member: "Tooltip", status: "family-member" },
+  { component: "HoverCard", family: "OverlayFamily", member: "HoverCard", status: "family-member" },
+  { component: "RightClickMenu", family: "OverlayFamily", member: "RightClickMenu", status: "transitional" },
+  { component: "AlertDialog", family: "OverlayFamily", member: "AlertDialog", status: "transitional" },
+  { component: "ConfirmDialog", family: "OverlayFamily", member: "ConfirmDialog", status: "family-member" },
+  { component: "ModalShell", family: "OverlayFamily", member: "ModalShell", status: "transitional" },
+  { component: "SheetShell", family: "OverlayFamily", member: "SheetShell", status: "family-member" },
+  { component: "Drawer", family: "OverlayFamily", member: "Drawer", status: "transitional" },
+  { component: "DialogActions", family: "OverlayFamily", member: "DialogActions", status: "transitional" },
+
+  { component: "FormFieldShell", family: "FormFamily", member: "Field", status: "canonical" },
+  { component: "FormInput", family: "FormFamily", member: "Input", status: "family-member" },
+  { component: "FormTextarea", family: "FormFamily", member: "Textarea", status: "family-member" },
+  { component: "FormSelect", family: "FormFamily", member: "Select", status: "family-member" },
+  { component: "FormAsyncSelect", family: "FormFamily", member: "AsyncSelect", status: "family-member" },
+  { component: "FormSwitch", family: "FormFamily", member: "Switch", status: "family-member" },
+  { component: "FormSearchInput", family: "FormFamily", member: "Search", status: "transitional" },
+  { component: "FormPasswordInput", family: "FormFamily", member: "Password", status: "transitional" },
+  { component: "FormNumberInput", family: "FormFamily", member: "Number", status: "transitional" },
+  { component: "FormPhoneInput", family: "FormFamily", member: "Phone", status: "transitional" },
+  { component: "FormDateInput", family: "FormFamily", member: "Date", status: "transitional" },
+  { component: "FormDateRangeInput", family: "FormFamily", member: "DateRange", status: "transitional" },
+  { component: "FormDatePicker", family: "FormFamily", member: "DatePicker", status: "family-member" },
+  { component: "FormDateRangePicker", family: "FormFamily", member: "DateRangePicker", status: "family-member" },
+  { component: "FormBuilder", family: "FormFamily", member: "Builder", status: "advanced" },
+
+  { component: "DataTable", family: "DataTableFamily", member: "Root", status: "canonical" },
+  { component: "DataTableToolbar", family: "DataTableFamily", member: "Toolbar", status: "family-member" },
+  { component: "DataTablePagination", family: "DataTableFamily", member: "Pagination", status: "family-member" },
+  { component: "DataTableColumnVisibilityMenu", family: "DataTableFamily", member: "ColumnVisibilityMenu", status: "advanced" },
+  { component: "DataTableSortableHeader", family: "DataTableFamily", member: "SortableHeader", status: "advanced" },
+  { component: "DataTableRowActions", family: "DataTableFamily", member: "RowActions", status: "family-member" },
+  { component: "DataTableBulkActions", family: "DataTableFamily", member: "BulkActions", status: "family-member" },
+  { component: "DataTableViewPresets", family: "DataTableFamily", member: "ViewPresets", status: "family-member" },
+  { component: "createDataTableSelectColumn", family: "DataTableFamily", member: "createSelectColumn", status: "advanced" },
+  { component: "createDataTableActionsColumn", family: "DataTableFamily", member: "createActionsColumn", status: "advanced" },
+  { component: "TableExportMenu", family: "DataTableFamily", member: "ExportMenu", status: "advanced" },
+  { component: "TableImportButton", family: "DataTableFamily", member: "ImportButton", status: "advanced" },
+  { component: "InlineEditable", family: "InputFamily", member: "InlineEditable", status: "advanced" },
+  { component: "TrendCard", family: "CardFamily", member: "Trend", status: "family-member" },
+  { component: "ComparisonCard", family: "CardFamily", member: "Comparison", status: "family-member" },
+  { component: "DeltaBadge", family: "BadgeFamily", member: "Delta", status: "family-member" },
+  { component: "RepeaterField", family: "FormFamily", member: "Repeater", status: "family-member" },
+  { component: "Button", family: "ActionFamily", member: "Root", status: "canonical" },
+  { component: "ActionMenu", family: "ActionFamily", member: "Menu", status: "family-member" },
+  { component: "CopyButton", family: "ActionFamily", member: "CopyButton", status: "family-member" },
+  { component: "ButtonGroup", family: "ActionFamily", member: "Group", status: "transitional" },
+  { component: "CopyField", family: "ActionFamily", member: "CopyField", status: "transitional" },
+  { component: "QuickActionGrid", family: "ActionFamily", member: "QuickActionGrid", status: "transitional" },
+
+  { component: "Alert", family: "FeedbackFamily", member: "Alert", status: "canonical" },
+  { component: "EmptyState", family: "FeedbackFamily", member: "EmptyState", status: "canonical" },
+  { component: "LoadingState", family: "FeedbackFamily", member: "LoadingState", status: "canonical" },
+  { component: "Progress", family: "ProgressFamily", member: "Progress", status: "canonical" },
+  { component: "ProgressCircle", family: "ProgressFamily", member: "ProgressCircle", status: "family-member" },
+  { component: "ToastProvider", family: "FeedbackFamily", member: "ToastProvider", status: "canonical" },
+  { component: "InlineState", family: "FeedbackFamily", member: "InlineState", status: "family-member" },
+  { component: "LoadingOverlay", family: "FeedbackFamily", member: "LoadingOverlay", status: "family-member" },
+  { component: "Spinner", family: "FeedbackFamily", member: "Spinner", status: "family-member" },
+  { component: "Skeleton", family: "FeedbackFamily", member: "Skeleton", status: "family-member" },
+  { component: "useToast", family: "FeedbackFamily", member: "useToast", status: "advanced" },
+
+  { component: "BarChart", family: "ChartFamily", member: "BarChart", status: "canonical" },
+  { component: "LineChart", family: "ChartFamily", member: "LineChart", status: "canonical" },
+  { component: "DonutChart", family: "ChartFamily", member: "DonutChart", status: "canonical" },
+  { component: "MetricGrid", family: "ChartFamily", member: "MetricGrid", status: "family-member" },
+  { component: "ChartFrame", family: "ChartFamily", member: "ChartFrame", status: "family-member" },
+  { component: "ChartLegend", family: "ChartFamily", member: "ChartLegend", status: "family-member" },
+  { component: "Sparkline", family: "ChartFamily", member: "Sparkline", status: "family-member" },
+  { component: "MetricTrend", family: "ChartFamily", member: "MetricTrend", status: "family-member" },
+  { component: "Statistic", family: "ChartFamily", member: "Statistic", status: "family-member" },
+  { component: "StatisticGrid", family: "ChartFamily", member: "StatisticGrid", status: "family-member" },
+  { component: "StatisticCard", family: "ChartFamily", member: "StatisticCard", status: "family-member" },
+
+  { component: "Sidebar", family: "NavigationFamily", member: "Sidebar", status: "canonical" },
+  { component: "PageContainer", family: "NavigationFamily", member: "PageContainer", status: "canonical" },
+  { component: "Tabs", family: "NavigationFamily", member: "Tabs", status: "canonical" },
+  { component: "Pagination", family: "NavigationFamily", member: "Pagination", status: "canonical" },
+  { component: "Breadcrumbs", family: "NavigationFamily", member: "Breadcrumbs", status: "canonical" },
+  { component: "Wizard", family: "NavigationFamily", member: "Wizard", status: "canonical" },
+  { component: "Section", family: "NavigationFamily", member: "Section", status: "transitional" },
+  { component: "AnchorNav", family: "NavigationFamily", member: "AnchorNav", status: "transitional" },
+  { component: "Stepper", family: "NavigationFamily", member: "Stepper", status: "transitional" },
+  { component: "StepperTabs", family: "NavigationFamily", member: "StepperTabs", status: "transitional" },
+  { component: "SegmentedControl", family: "NavigationFamily", member: "SegmentedControl", status: "transitional" },
+
+  { component: "FileUpload", family: "UploadFamily", member: "FileUpload", status: "canonical" },
+  { component: "ImageUpload", family: "UploadFamily", member: "ImageUpload", status: "canonical composed member" },
+
+  { component: "Checkbox", family: "PrimitiveFamily", member: "Checkbox", status: "canonical" },
+  { component: "RadioGroup", family: "PrimitiveFamily", member: "RadioGroup", status: "canonical" },
+  { component: "Switch", family: "PrimitiveFamily", member: "Switch", status: "canonical" },
+  { component: "Table", family: "PrimitiveFamily", member: "Table", status: "canonical" },
+  { component: "Accordion", family: "PrimitiveFamily", member: "Accordion", status: "canonical" },
+  { component: "Collapse", family: "PrimitiveFamily", member: "Collapse", status: "transitional" },
+  { component: "Calendar", family: "PrimitiveFamily", member: "Calendar", status: "transitional" },
+  { component: "Divider", family: "PrimitiveFamily", member: "Divider", status: "transitional" },
+  { component: "Kbd", family: "PrimitiveFamily", member: "Kbd", status: "transitional" },
+  { component: "ScrollBox", family: "PrimitiveFamily", member: "ScrollBox", status: "transitional" },
+] as const

package/packages/cli/vendor/src/families/overlay-family.ts

@@ -0,0 +1,31 @@
+import {
+  AlertDialog,
+  ConfirmDialog,
+  DialogActions,
+  Drawer,
+  ModalShell,
+  SheetShell,
+} from "@/components/overlay"
+import { DropdownMenu } from "@/components/ui/dropdown-menu"
+import { HoverCard } from "@/components/ui/hover-card"
+import { Popover } from "@/components/ui/popover"
+import { RightClickMenu } from "@/components/ui/right-click-menu"
+import { Tooltip } from "@/components/ui/tooltip"
+import { Dialog } from "@/components/ui/dialog"
+
+const OverlayFamily = {
+  Dialog,
+  Popover,
+  DropdownMenu,
+  Tooltip,
+  HoverCard,
+  RightClickMenu,
+  AlertDialog,
+  ConfirmDialog,
+  ModalShell,
+  SheetShell,
+  Drawer,
+  DialogActions,
+} as const
+
+export { OverlayFamily }

package/packages/cli/vendor/src/families/public-surface-rationalization.ts

@@ -0,0 +1,206 @@
+export const additionalPublicFamilies = [
+  {
+    family: "ActionFamily",
+    label: "Actions",
+    description: "Primary action surface led by Button, then expanded with menus, copy flows, and grouped actions.",
+    canonical: ["Button"],
+    members: ["ActionMenu", "CopyButton"],
+    transitional: ["ButtonGroup", "CopyField", "QuickActionGrid"],
+  },
+  {
+    family: "FeedbackFamily",
+    label: "Feedback",
+    description: "Status, loading, and notification surfaces grouped under one product feedback mental model.",
+    canonical: ["Alert", "EmptyState", "LoadingState", "ToastProvider"],
+    members: ["InlineState", "LoadingOverlay", "Spinner", "Skeleton"],
+    advanced: ["useToast"],
+  },
+  {
+    family: "ProgressFamily",
+    label: "Progress",
+    description: "Completion and progress surfaces with linear and circular indicators.",
+    canonical: ["Progress"],
+    members: ["ProgressCircle"],
+  },
+  {
+    family: "ChartFamily",
+    label: "Charts",
+    description: "Dashboard chart and metric surfaces with one clear chart-led public route.",
+    canonical: ["BarChart", "LineChart", "DonutChart"],
+    members: ["MetricGrid", "ChartFrame", "ChartLegend", "Sparkline", "MetricTrend", "Statistic", "StatisticGrid", "StatisticCard"],
+  },
+  {
+    family: "NavigationFamily",
+    label: "Navigation",
+    description: "Navigation, page framing, and guided-flow surfaces grouped around one layout-first route.",
+    canonical: ["Sidebar", "PageContainer", "Tabs", "Pagination", "Breadcrumbs", "Wizard"],
+    members: [],
+    transitional: ["Section", "AnchorNav", "Stepper", "StepperTabs", "SegmentedControl"],
+  },
+  {
+    family: "UploadFamily",
+    label: "Upload",
+    description: "File and image upload surfaces with source-ready product behavior.",
+    canonical: ["FileUpload", "ImageUpload"],
+    members: [],
+  },
+  {
+    family: "PrimitiveFamily",
+    label: "Primitives",
+    description: "Form and content primitives that support higher-level product surfaces without crowding the catalog.",
+    canonical: ["Checkbox", "RadioGroup", "Switch", "Table", "Accordion"],
+    members: [],
+    transitional: ["Collapse", "Calendar", "Divider", "Kbd", "ScrollBox"],
+  },
+] as const
+
+export const additionalDocsGroups = [
+  {
+    group: "Button",
+    family: "ActionFamily",
+    slug: "button",
+    label: "Button",
+    primaryComponent: "Button",
+    description: "Button-first action route with menu, copy, and grouped-action helpers introduced only after the main trigger is clear.",
+    sections: [
+      {
+        id: "core-actions",
+        label: "Core actions",
+        description: "Start from the primary action trigger, then expand into menu and copy patterns only when the flow needs them.",
+        components: ["Button", "ActionMenu", "CopyButton"],
+      },
+      {
+        id: "secondary-patterns",
+        label: "Secondary patterns",
+        description: "Grouped and embedded action helpers should stay secondary to the core action surface.",
+        components: ["ButtonGroup", "CopyField", "QuickActionGrid"],
+      },
+    ],
+  },
+  {
+    group: "Alert",
+    family: "FeedbackFamily",
+    slug: "alert",
+    label: "Alert",
+    primaryComponent: "Alert",
+    description: "Feedback route for product status, empty, loading, progress, and notifications.",
+    sections: [
+      {
+        id: "core-feedback",
+        label: "Core feedback",
+        description: "These are the product feedback surfaces teams should reach for first.",
+        components: ["Alert", "EmptyState", "LoadingState", "ToastProvider"],
+      },
+      {
+        id: "secondary-feedback",
+        label: "Secondary feedback",
+        description: "Loading helpers and inline state affordances should stay behind the core feedback model.",
+        components: ["InlineState", "LoadingOverlay", "Spinner", "Skeleton", "useToast"],
+      },
+    ],
+  },
+  {
+    group: "BarChart",
+    family: "ChartFamily",
+    slug: "bar-chart",
+    label: "Bar Chart",
+    primaryComponent: "BarChart",
+    description: "Chart-first route for dashboard visuals and metric companions.",
+    sections: [
+      {
+        id: "core-charts",
+        label: "Core charts",
+        description: "Lead with the chart surfaces that carry direct dashboard value.",
+        components: ["BarChart", "LineChart", "DonutChart", "MetricGrid"],
+      },
+      {
+        id: "chart-helpers",
+        label: "Chart helpers",
+        description: "Frames, legends, and metric add-ons stay as secondary pieces around the chart route.",
+        components: ["ChartFrame", "ChartLegend", "Sparkline", "MetricTrend", "Statistic", "StatisticGrid", "StatisticCard"],
+      },
+    ],
+  },
+  {
+    group: "Sidebar",
+    family: "NavigationFamily",
+    slug: "sidebar",
+    label: "Sidebar",
+    primaryComponent: "Sidebar",
+    description: "Navigation and layout route with page framing, tabs, pagination, and guided flows grouped together.",
+    sections: [
+      {
+        id: "core-navigation",
+        label: "Core navigation",
+        description: "Start from the main navigational and framing surfaces.",
+        components: ["Sidebar", "PageContainer", "Tabs", "Pagination", "Breadcrumbs", "Wizard"],
+      },
+      {
+        id: "secondary-navigation",
+        label: "Secondary navigation",
+        description: "Structural helpers and guided-flow variants should stay behind the main navigation route.",
+        components: ["Section", "AnchorNav", "Stepper", "StepperTabs", "SegmentedControl"],
+      },
+    ],
+  },
+  {
+    group: "FileUpload",
+    family: "UploadFamily",
+    slug: "file-upload",
+    label: "File Upload",
+    primaryComponent: "FileUpload",
+    description: "Upload route that starts from the generic file workflow and then expands into image-specific behavior.",
+    sections: [
+      {
+        id: "upload-core",
+        label: "Upload core",
+        description: "Generic file and image upload flows with direct product behavior.",
+        components: ["FileUpload", "ImageUpload"],
+      },
+    ],
+  },
+  {
+    group: "Checkbox",
+    family: "PrimitiveFamily",
+    slug: "checkbox",
+    label: "Checkbox",
+    primaryComponent: "Checkbox",
+    description: "Primitive route for selection, tables, and supporting building blocks that should not dominate the main catalog.",
+    sections: [
+      {
+        id: "core-primitives",
+        label: "Core primitives",
+        description: "Lead with the selection and content primitives used most often in real product screens.",
+        components: ["Checkbox", "RadioGroup", "Switch", "Table", "Accordion"],
+      },
+      {
+        id: "supporting-primitives",
+        label: "Supporting primitives",
+        description: "Supporting content and layout primitives should stay secondary to the core controls.",
+        components: ["Collapse", "Calendar", "Divider", "Kbd", "ScrollBox"],
+      },
+    ],
+  },
+  {
+    group: "Progress",
+    family: "ProgressFamily",
+    slug: "progress",
+    label: "Progress",
+    primaryComponent: "Progress",
+    description: "Progress surfaces grouped with linear and circular indicators, value formatting, and status tone.",
+    sections: [
+      {
+        id: "core-progress",
+        label: "Core progress",
+        description: "Start with linear progress states before composing status and circular variants.",
+        components: ["Progress", "ProgressCircle"],
+      },
+      {
+        id: "supporting-progress",
+        label: "Supporting signals",
+        description: "Small, reusable status helpers for quick loading feedback and skeleton-driven async states.",
+        components: [],
+      },
+    ],
+  },
+] as const

package/packages/cli/vendor/src/families/queries.ts

@@ -0,0 +1,131 @@
+import { componentFamilyCatalog, type ComponentFamilyCatalogEntry, type ComponentFamilyName } from "@/families/catalog"
+import {
+  componentFamilyMigrationMap,
+  type FamilyMigrationEntry,
+  type FamilyMigrationStatus,
+} from "@/families/migration-map"
+
+const publicFamilyOverrides: Partial<Record<ComponentFamilyName, ComponentFamilyCatalogEntry>> = {
+  InputFamily: {
+    family: "InputFamily",
+    label: "Input",
+    description: "Small core input surface for the input types used most often in dashboard screens.",
+    canonical: ["Input", "Textarea"],
+    members: ["NumberInput", "DateInput", "DateRangeInput", "MoneyInput", "PhoneInput", "FormInput"],
+    transitional: ["ClearableInput", "SearchInput", "MaskedInput", "QuantityInput"],
+    advanced: ["Slider", "RangeSlider", "Rating", "OtpInput", "ColorInput", "InlineEditable", "TagInput", "QuantityStepper"],
+  },
+  SelectFamily: {
+    family: "SelectFamily",
+    label: "Select",
+    description: "Choice-picking surface with async, multi-select, and combobox only when the interaction needs them.",
+    canonical: ["Select"],
+    members: ["AsyncSelect", "Combobox", "FormSelect"],
+    transitional: ["SimpleSelect", "FormAsyncSelect"],
+    advanced: ["AsyncMultiSelect"],
+  },
+  CardFamily: {
+    family: "CardFamily",
+    label: "Card",
+    description: "Primitive card plus only the card presets that provide reusable product value.",
+    canonical: ["Card", "InfoCard"],
+    members: ["EntityCard", "FileCard", "TrendCard", "ComparisonCard"],
+    transitional: ["SmartCard", "StatCard"],
+  },
+  OverlayFamily: {
+    family: "OverlayFamily",
+    label: "Overlay",
+    description: "Floating interaction surfaces grouped by behavior, not by card-like visual appearance.",
+    canonical: ["Dialog", "Popover", "DropdownMenu"],
+    members: ["Tooltip", "ConfirmDialog", "SheetShell", "HoverCard"],
+    transitional: ["RightClickMenu", "AlertDialog", "ModalShell", "Drawer", "DialogActions"],
+  },
+  FormFamily: {
+    family: "FormFamily",
+    label: "Form",
+    description: "Field shell and a compact set of broad wrappers instead of many small aliases.",
+    canonical: ["FormFieldShell"],
+    members: ["FormInput", "FormTextarea", "FormSelect", "FormSwitch", "FormDatePicker", "FormDateRangePicker", "RepeaterField"],
+    transitional: ["FormSearchInput", "FormPasswordInput", "FormNumberInput", "FormPhoneInput", "FormDateInput", "FormDateRangeInput"],
+    advanced: ["FormBuilder"],
+  },
+  DataTableFamily: {
+    family: "DataTableFamily",
+    label: "Data Table",
+    description: "Table shell with toolbar and pagination as the only first-level companions.",
+    canonical: ["DataTable"],
+    members: ["DataTableToolbar", "DataTablePagination", "DataTableRowActions", "DataTableBulkActions", "DataTableViewPresets"],
+    advanced: [
+      "DataTableColumnVisibilityMenu",
+      "DataTableSortableHeader",
+      "createDataTableSelectColumn",
+      "createDataTableActionsColumn",
+      "TableExportMenu",
+      "TableImportButton",
+    ],
+  },
+}
+
+const publicFamilyCatalog = componentFamilyCatalog.map((entry) => publicFamilyOverrides[entry.family] ?? entry)
+
+const familyCatalogMap = new Map<ComponentFamilyName, ComponentFamilyCatalogEntry>(
+  publicFamilyCatalog.map((entry) => [entry.family, entry])
+)
+
+const componentMigrationMap = new Map<string, FamilyMigrationEntry[]>()
+
+for (const entry of componentFamilyMigrationMap) {
+  const existingEntries = componentMigrationMap.get(entry.component) ?? []
+  existingEntries.push(entry)
+  componentMigrationMap.set(entry.component, existingEntries)
+}
+
+function getFamilyCatalogEntry(family: ComponentFamilyName) {
+  return familyCatalogMap.get(family)
+}
+
+function listFamilyCatalogEntries() {
+  return publicFamilyCatalog
+}
+
+function getFamilyMembers(family: ComponentFamilyName) {
+  return componentFamilyMigrationMap.filter((entry) => entry.family === family)
+}
+
+function getComponentFamilyEntry(component: string) {
+  return componentMigrationMap.get(component)?.[0]
+}
+
+function getComponentFamilyEntries(component: string) {
+  return componentMigrationMap.get(component) ?? []
+}
+
+function listComponentsByStatus(status: FamilyMigrationStatus) {
+  return componentFamilyMigrationMap.filter((entry) => entry.status === status)
+}
+
+function listTransitionalComponents() {
+  return listComponentsByStatus("transitional")
+}
+
+function listAdvancedComponents() {
+  return listComponentsByStatus("advanced")
+}
+
+function listCanonicalComponents() {
+  return componentFamilyMigrationMap.filter(
+    (entry) => entry.status === "canonical" || entry.status === "canonical composed member"
+  )
+}
+
+export {
+  getComponentFamilyEntry,
+  getComponentFamilyEntries,
+  getFamilyCatalogEntry,
+  getFamilyMembers,
+  listAdvancedComponents,
+  listCanonicalComponents,
+  listComponentsByStatus,
+  listFamilyCatalogEntries,
+  listTransitionalComponents,
+}

package/packages/cli/vendor/src/families/select-family.ts

@@ -0,0 +1,33 @@
+import { FormAsyncSelect, FormSelect } from "@/components/form"
+import { AsyncMultiSelect, AsyncSelect, Combobox, SimpleSelect } from "@/components/inputs"
+import {
+  Select,
+  SelectContent,
+  SelectGroup,
+  SelectItem,
+  SelectLabel,
+  SelectSeparator,
+  SelectTrigger,
+  SelectValue,
+} from "@/components/ui/select"
+
+const SelectFamily = {
+  Root: Select,
+  Trigger: SelectTrigger,
+  Value: SelectValue,
+  Content: SelectContent,
+  Group: SelectGroup,
+  Label: SelectLabel,
+  Item: SelectItem,
+  Separator: SelectSeparator,
+  Simple: SimpleSelect,
+  Async: AsyncSelect,
+  AsyncMulti: AsyncMultiSelect,
+  Combobox,
+  Form: {
+    Select: FormSelect,
+    Async: FormAsyncSelect,
+  },
+} as const
+
+export { SelectFamily }

package/packages/cli/vendor/src/families/views.ts

@@ -0,0 +1,85 @@
+import type { ComponentFamilyCatalogEntry, ComponentFamilyName } from "@/families/catalog"
+import type { FamilyMigrationEntry } from "@/families/migration-map"
+import {
+  getFamilyCatalogEntry,
+  getFamilyMembers,
+  listAdvancedComponents,
+  listCanonicalComponents,
+  listFamilyCatalogEntries,
+  listTransitionalComponents,
+} from "@/families/queries"
+
+export type ComponentFamilyView = ComponentFamilyCatalogEntry & {
+  canonicalEntries: FamilyMigrationEntry[]
+  memberEntries: FamilyMigrationEntry[]
+  transitionalEntries: FamilyMigrationEntry[]
+  advancedEntries: FamilyMigrationEntry[]
+}
+
+function toSortedEntries(entries: FamilyMigrationEntry[]) {
+  return [...entries].sort((left, right) => left.component.localeCompare(right.component))
+}
+
+function pickCatalogEntries(entries: FamilyMigrationEntry[], components: readonly string[]) {
+  const allowed = new Set(components)
+  return toSortedEntries(entries.filter((entry) => allowed.has(entry.component)))
+}
+
+function getFamilyView(family: ComponentFamilyName): ComponentFamilyView | undefined {
+  const catalogEntry = getFamilyCatalogEntry(family)
+
+  if (!catalogEntry) return undefined
+
+  const familyMembers = getFamilyMembers(family)
+  const canonicalEntries = pickCatalogEntries(
+    familyMembers.filter((entry) => entry.status === "canonical" || entry.status === "canonical composed member"),
+    catalogEntry.canonical
+  )
+  const transitionalEntries = pickCatalogEntries(
+    familyMembers.filter((entry) => entry.status === "transitional"),
+    catalogEntry.transitional ?? []
+  )
+  const advancedEntries = pickCatalogEntries(
+    familyMembers.filter((entry) => entry.status === "advanced"),
+    catalogEntry.advanced ?? []
+  )
+  const memberEntries = pickCatalogEntries(
+    familyMembers.filter((entry) => entry.status === "family-member" || entry.status === "family-member helper"),
+    catalogEntry.members
+  )
+
+  return {
+    ...catalogEntry,
+    canonicalEntries,
+    memberEntries,
+    transitionalEntries,
+    advancedEntries,
+  }
+}
+
+function listFamilyViews() {
+  return listFamilyCatalogEntries().map((entry) => getFamilyView(entry.family)).filter(Boolean) as ComponentFamilyView[]
+}
+
+function getFamilyNavigation() {
+  return listFamilyCatalogEntries().map((entry) => ({
+    family: entry.family,
+    label: entry.label,
+    description: entry.description,
+    canonicalCount: entry.canonical.length,
+    memberCount: entry.members.length,
+    transitionalCount: entry.transitional?.length ?? 0,
+    advancedCount: entry.advanced?.length ?? 0,
+  }))
+}
+
+function getMetadataSummary() {
+  return {
+    families: listFamilyCatalogEntries().length,
+    canonical: listCanonicalComponents().length,
+    transitional: listTransitionalComponents().length,
+    advanced: listAdvancedComponents().length,
+  }
+}
+
+export { getFamilyNavigation, getFamilyView, getMetadataSummary, listFamilyViews }

package/packages/cli/vendor/src/hooks/index.ts

@@ -0,0 +1,6 @@
+export * from "./use-session-storage-state"
+export * from "./use-before-unload-when-dirty"
+export * from "./use-is-mobile"
+export * from "./use-disclosure"
+export * from "./use-debounce"
+export * from "./use-data-table-view-state"