tembro 1.0.0

package/dist/families/overlay-family.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../components/ui/dropdown-menu/index.cjs"),t=require("../components/ui/dialog/index.cjs"),n=require("../components/ui/popover/index.cjs"),r=require("../components/ui/tooltip/index.cjs"),i=require("../components/ui/hover-card.cjs"),a=require("../components/ui/right-click-menu/index.cjs"),o=require("../components/overlay/alert-dialog.cjs"),s=require("../components/overlay/dialog-actions.cjs"),c=require("../components/overlay/modal-shell.cjs"),l=require("../components/overlay/confirm-dialog.cjs"),u=require("../components/overlay/drawer.cjs"),d=require("../components/overlay/sheet-shell.cjs");var f={Dialog:t.Dialog,Popover:n.Popover,DropdownMenu:e.DropdownMenu,Tooltip:r.Tooltip,HoverCard:i.HoverCard,RightClickMenu:a.RightClickMenu,AlertDialog:o.AlertDialog,ConfirmDialog:l.ConfirmDialog,ModalShell:c.ModalShell,SheetShell:d.SheetShell,Drawer:u.Drawer,DialogActions:s.DialogActions};exports.OverlayFamily=f;

package/dist/families/overlay-family.d.ts

@@ -0,0 +1,22 @@
+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";
+declare const OverlayFamily: {
+    readonly Dialog: typeof Dialog;
+    readonly Popover: typeof Popover;
+    readonly DropdownMenu: typeof DropdownMenu;
+    readonly Tooltip: typeof Tooltip;
+    readonly HoverCard: typeof HoverCard;
+    readonly RightClickMenu: typeof RightClickMenu;
+    readonly AlertDialog: typeof AlertDialog;
+    readonly ConfirmDialog: typeof ConfirmDialog;
+    readonly ModalShell: typeof ModalShell;
+    readonly SheetShell: typeof SheetShell;
+    readonly Drawer: typeof Drawer;
+    readonly DialogActions: typeof DialogActions;
+};
+export { OverlayFamily };

package/dist/families/overlay-family.js

@@ -0,0 +1,29 @@
+import { DropdownMenu as e } from "../components/ui/dropdown-menu/index.js";
+import { Dialog as t } from "../components/ui/dialog/index.js";
+import { Popover as n } from "../components/ui/popover/index.js";
+import { Tooltip as r } from "../components/ui/tooltip/index.js";
+import { HoverCard as i } from "../components/ui/hover-card.js";
+import { RightClickMenu as a } from "../components/ui/right-click-menu/index.js";
+import { AlertDialog as o } from "../components/overlay/alert-dialog.js";
+import { DialogActions as s } from "../components/overlay/dialog-actions.js";
+import { ModalShell as c } from "../components/overlay/modal-shell.js";
+import { ConfirmDialog as l } from "../components/overlay/confirm-dialog.js";
+import { Drawer as u } from "../components/overlay/drawer.js";
+import { SheetShell as d } from "../components/overlay/sheet-shell.js";
+//#region src/families/overlay-family.ts
+var f = {
+	Dialog: t,
+	Popover: n,
+	DropdownMenu: e,
+	Tooltip: r,
+	HoverCard: i,
+	RightClickMenu: a,
+	AlertDialog: o,
+	ConfirmDialog: l,
+	ModalShell: c,
+	SheetShell: d,
+	Drawer: u,
+	DialogActions: s
+};
+//#endregion
+export { f as OverlayFamily };

package/dist/families/public-surface-rationalization.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=[{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`]}],t=[{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:[]}]}];exports.additionalDocsGroups=t,exports.additionalPublicFamilies=e;

package/dist/families/public-surface-rationalization.d.ts

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

package/dist/families/public-surface-rationalization.js

@@ -0,0 +1,296 @@
+//#region src/families/public-surface-rationalization.ts
+var e = [
+	{
+		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"
+		]
+	}
+], t = [
+	{
+		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: []
+		}]
+	}
+];
+//#endregion
+export { t as additionalDocsGroups, e as additionalPublicFamilies };

package/dist/families/queries.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./catalog.cjs"),t=require("./migration-map.cjs");var n={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`]}},r=e.componentFamilyCatalog.map(e=>n[e.family]??e),i=new Map(r.map(e=>[e.family,e])),a=new Map;for(let e of t.componentFamilyMigrationMap){let t=a.get(e.component)??[];t.push(e),a.set(e.component,t)}function o(e){return i.get(e)}function s(){return r}function c(e){return t.componentFamilyMigrationMap.filter(t=>t.family===e)}function l(e){return a.get(e)?.[0]}function u(e){return a.get(e)??[]}function d(e){return t.componentFamilyMigrationMap.filter(t=>t.status===e)}function f(){return d(`transitional`)}function p(){return d(`advanced`)}function m(){return t.componentFamilyMigrationMap.filter(e=>e.status===`canonical`||e.status===`canonical composed member`)}exports.getComponentFamilyEntries=u,exports.getComponentFamilyEntry=l,exports.getFamilyCatalogEntry=o,exports.getFamilyMembers=c,exports.listAdvancedComponents=p,exports.listCanonicalComponents=m,exports.listComponentsByStatus=d,exports.listFamilyCatalogEntries=s,exports.listTransitionalComponents=f;

package/dist/families/queries.d.ts

@@ -0,0 +1,12 @@
+import { type ComponentFamilyCatalogEntry, type ComponentFamilyName } from "@/families/catalog";
+import { type FamilyMigrationEntry, type FamilyMigrationStatus } from "@/families/migration-map";
+declare function getFamilyCatalogEntry(family: ComponentFamilyName): ComponentFamilyCatalogEntry | undefined;
+declare function listFamilyCatalogEntries(): ComponentFamilyCatalogEntry[];
+declare function getFamilyMembers(family: ComponentFamilyName): FamilyMigrationEntry[];
+declare function getComponentFamilyEntry(component: string): FamilyMigrationEntry | undefined;
+declare function getComponentFamilyEntries(component: string): FamilyMigrationEntry[];
+declare function listComponentsByStatus(status: FamilyMigrationStatus): FamilyMigrationEntry[];
+declare function listTransitionalComponents(): FamilyMigrationEntry[];
+declare function listAdvancedComponents(): FamilyMigrationEntry[];
+declare function listCanonicalComponents(): FamilyMigrationEntry[];
+export { getComponentFamilyEntry, getComponentFamilyEntries, getFamilyCatalogEntry, getFamilyMembers, listAdvancedComponents, listCanonicalComponents, listComponentsByStatus, listFamilyCatalogEntries, listTransitionalComponents, };