tembro 1.0.0

package/dist/families/catalog.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=[{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`]},{family:`SelectFamily`,label:`Select`,description:`Base select surface with async, keyboard-search, and form-wrapper members layered only when the workflow needs them.`,canonical:[`Select`],members:[`AsyncSelect`,`Combobox`,`FormSelect`],transitional:[`SimpleSelect`,`FormAsyncSelect`],advanced:[`AsyncMultiSelect`]},{family:`CardFamily`,label:`Card`,description:`Primitive card plus dashboard and entity-oriented composed card presets.`,canonical:[`Card`,`InfoCard`],members:[`StatisticCard`,`EntityCard`,`FileCard`,`TrendCard`,`ComparisonCard`],transitional:[`SmartCard`,`StatCard`]},{family:`BadgeFamily`,label:`Badge`,description:`Status, metadata, and inline labels expressed through one Badge API with tone, dot, size, and variant props.`,canonical:[`Badge`],members:[`DeltaBadge`]},{family:`OverlayFamily`,label:`Overlay`,description:`Dialog, popover, menu, tooltip, drawer, and hover-preview interaction surfaces grouped by behavior.`,canonical:[`Dialog`,`Popover`,`DropdownMenu`],members:[`Tooltip`,`HoverCard`,`ConfirmDialog`,`SheetShell`],transitional:[`RightClickMenu`,`AlertDialog`,`ModalShell`,`Drawer`,`DialogActions`]},{family:`FormFamily`,label:`Form`,description:`Field shell, wrappers, and builder presets.`,canonical:[`FormFieldShell`],members:[`FormInput`,`FormTextarea`,`FormSelect`,`FormAsyncSelect`,`FormSwitch`,`FormDatePicker`,`FormDateRangePicker`,`RepeaterField`],transitional:[`FormSearchInput`,`FormPasswordInput`,`FormNumberInput`,`FormPhoneInput`,`FormDateInput`,`FormDateRangeInput`],advanced:[`FormBuilder`]},{family:`DataTableFamily`,label:`Data Table`,description:`Canonical grid surface with a small set of reusable companions. Lower-level helpers stay secondary to the main table route.`,canonical:[`DataTable`],members:[`DataTableToolbar`,`DataTablePagination`,`DataTableRowActions`,`DataTableBulkActions`,`DataTableViewPresets`],advanced:[`DataTableColumnVisibilityMenu`,`DataTableSortableHeader`,`createDataTableSelectColumn`,`createDataTableActionsColumn`,`TableExportMenu`,`TableImportButton`]},...require("./public-surface-rationalization.cjs").additionalPublicFamilies];exports.componentFamilyCatalog=e;

package/dist/families/catalog.d.ts

@@ -0,0 +1,11 @@
+export type ComponentFamilyName = "InputFamily" | "SelectFamily" | "CardFamily" | "BadgeFamily" | "OverlayFamily" | "FormFamily" | "DataTableFamily" | "ActionFamily" | "FeedbackFamily" | "ProgressFamily" | "ChartFamily" | "NavigationFamily" | "UploadFamily" | "PrimitiveFamily";
+export type ComponentFamilyCatalogEntry = {
+    family: ComponentFamilyName;
+    label: string;
+    description: string;
+    canonical: readonly string[];
+    members: readonly string[];
+    transitional?: readonly string[];
+    advanced?: readonly string[];
+};
+export declare const componentFamilyCatalog: ComponentFamilyCatalogEntry[];

package/dist/families/catalog.js

@@ -0,0 +1,140 @@
+import { additionalPublicFamilies as e } from "./public-surface-rationalization.js";
+//#region src/families/catalog.ts
+var t = [
+	{
+		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"
+		]
+	},
+	{
+		family: "SelectFamily",
+		label: "Select",
+		description: "Base select surface with async, keyboard-search, and form-wrapper members layered only when the workflow needs them.",
+		canonical: ["Select"],
+		members: [
+			"AsyncSelect",
+			"Combobox",
+			"FormSelect"
+		],
+		transitional: ["SimpleSelect", "FormAsyncSelect"],
+		advanced: ["AsyncMultiSelect"]
+	},
+	{
+		family: "CardFamily",
+		label: "Card",
+		description: "Primitive card plus dashboard and entity-oriented composed card presets.",
+		canonical: ["Card", "InfoCard"],
+		members: [
+			"StatisticCard",
+			"EntityCard",
+			"FileCard",
+			"TrendCard",
+			"ComparisonCard"
+		],
+		transitional: ["SmartCard", "StatCard"]
+	},
+	{
+		family: "BadgeFamily",
+		label: "Badge",
+		description: "Status, metadata, and inline labels expressed through one Badge API with tone, dot, size, and variant props.",
+		canonical: ["Badge"],
+		members: ["DeltaBadge"]
+	},
+	{
+		family: "OverlayFamily",
+		label: "Overlay",
+		description: "Dialog, popover, menu, tooltip, drawer, and hover-preview interaction surfaces grouped by behavior.",
+		canonical: [
+			"Dialog",
+			"Popover",
+			"DropdownMenu"
+		],
+		members: [
+			"Tooltip",
+			"HoverCard",
+			"ConfirmDialog",
+			"SheetShell"
+		],
+		transitional: [
+			"RightClickMenu",
+			"AlertDialog",
+			"ModalShell",
+			"Drawer",
+			"DialogActions"
+		]
+	},
+	{
+		family: "FormFamily",
+		label: "Form",
+		description: "Field shell, wrappers, and builder presets.",
+		canonical: ["FormFieldShell"],
+		members: [
+			"FormInput",
+			"FormTextarea",
+			"FormSelect",
+			"FormAsyncSelect",
+			"FormSwitch",
+			"FormDatePicker",
+			"FormDateRangePicker",
+			"RepeaterField"
+		],
+		transitional: [
+			"FormSearchInput",
+			"FormPasswordInput",
+			"FormNumberInput",
+			"FormPhoneInput",
+			"FormDateInput",
+			"FormDateRangeInput"
+		],
+		advanced: ["FormBuilder"]
+	},
+	{
+		family: "DataTableFamily",
+		label: "Data Table",
+		description: "Canonical grid surface with a small set of reusable companions. Lower-level helpers stay secondary to the main table route.",
+		canonical: ["DataTable"],
+		members: [
+			"DataTableToolbar",
+			"DataTablePagination",
+			"DataTableRowActions",
+			"DataTableBulkActions",
+			"DataTableViewPresets"
+		],
+		advanced: [
+			"DataTableColumnVisibilityMenu",
+			"DataTableSortableHeader",
+			"createDataTableSelectColumn",
+			"createDataTableActionsColumn",
+			"TableExportMenu",
+			"TableImportButton"
+		]
+	},
+	...e
+];
+//#endregion
+export { t as componentFamilyCatalog };

package/dist/families/data-table-family.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../components/data-table/data-table-row-actions.cjs"),t=require("../components/data-table/data-table-actions-column.cjs"),n=require("../components/data-table/data-table-bulk-actions.cjs"),r=require("../components/data-table/data-table-column-visibility-menu.cjs"),i=require("../components/data-table/data-table-pagination.cjs"),a=require("../components/data-table/data-table-toolbar.cjs"),o=require("../components/data-table/data-table.cjs"),s=require("../components/data-table/data-table-select-column.cjs"),c=require("../components/data-table/data-table-sortable-header.cjs"),l=require("../components/data-table/data-table-view-presets.cjs"),u=require("../components/data-table/table-export-menu.cjs"),d=require("../components/data-table/table-import-button.cjs");var f={Root:o.DataTable,Toolbar:a.DataTableToolbar,Pagination:i.DataTablePagination,ColumnVisibilityMenu:r.DataTableColumnVisibilityMenu,SortableHeader:c.DataTableSortableHeader,RowActions:e.DataTableRowActions,BulkActions:n.DataTableBulkActions,ViewPresets:l.DataTableViewPresets,ExportMenu:u.TableExportMenu,ImportButton:d.TableImportButton,createSelectColumn:s.createDataTableSelectColumn,createActionsColumn:t.createDataTableActionsColumn};exports.DataTableFamily=f;

package/dist/families/data-table-family.d.ts

@@ -0,0 +1,18 @@
+import { createDataTableActionsColumn, createDataTableSelectColumn, DataTable, DataTableBulkActions, DataTableColumnVisibilityMenu, DataTablePagination, DataTableRowActions, DataTableSortableHeader, DataTableToolbar, DataTableViewPresets } from "@/components/data-table";
+import { TableExportMenu } from "@/components/data-table/table-export-menu";
+import { TableImportButton } from "@/components/data-table/table-import-button";
+declare const DataTableFamily: {
+    readonly Root: typeof DataTable;
+    readonly Toolbar: typeof DataTableToolbar;
+    readonly Pagination: typeof DataTablePagination;
+    readonly ColumnVisibilityMenu: typeof DataTableColumnVisibilityMenu;
+    readonly SortableHeader: typeof DataTableSortableHeader;
+    readonly RowActions: typeof DataTableRowActions;
+    readonly BulkActions: typeof DataTableBulkActions;
+    readonly ViewPresets: typeof DataTableViewPresets;
+    readonly ExportMenu: typeof TableExportMenu;
+    readonly ImportButton: typeof TableImportButton;
+    readonly createSelectColumn: typeof createDataTableSelectColumn;
+    readonly createActionsColumn: typeof createDataTableActionsColumn;
+};
+export { DataTableFamily };

package/dist/families/data-table-family.js

@@ -0,0 +1,29 @@
+import { DataTableRowActions as e } from "../components/data-table/data-table-row-actions.js";
+import { createDataTableActionsColumn as t } from "../components/data-table/data-table-actions-column.js";
+import { DataTableBulkActions as n } from "../components/data-table/data-table-bulk-actions.js";
+import { DataTableColumnVisibilityMenu as r } from "../components/data-table/data-table-column-visibility-menu.js";
+import { DataTablePagination as i } from "../components/data-table/data-table-pagination.js";
+import { DataTableToolbar as a } from "../components/data-table/data-table-toolbar.js";
+import { DataTable as o } from "../components/data-table/data-table.js";
+import { createDataTableSelectColumn as s } from "../components/data-table/data-table-select-column.js";
+import { DataTableSortableHeader as c } from "../components/data-table/data-table-sortable-header.js";
+import { DataTableViewPresets as l } from "../components/data-table/data-table-view-presets.js";
+import { TableExportMenu as u } from "../components/data-table/table-export-menu.js";
+import { TableImportButton as d } from "../components/data-table/table-import-button.js";
+//#region src/families/data-table-family.ts
+var f = {
+	Root: o,
+	Toolbar: a,
+	Pagination: i,
+	ColumnVisibilityMenu: r,
+	SortableHeader: c,
+	RowActions: e,
+	BulkActions: n,
+	ViewPresets: l,
+	ExportMenu: u,
+	ImportButton: d,
+	createSelectColumn: s,
+	createActionsColumn: t
+};
+//#endregion
+export { f as DataTableFamily };

package/dist/families/docs-adoption.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./docs-groups.cjs"),t=require("./member-queries.cjs");var n={primitives:0,presets:100,"form-wrappers":200,wrappers:200,extensions:200,advanced:300,transitional:400};function r(e){let n=t.getComponentMemberMetadata(e);return n?n.maturity===`canonical`?{label:`Start here`,tone:`stable`}:n.maturity===`advanced`?{label:`Advanced`,tone:`advanced`}:n.maturity===`transitional`?{label:`Migration`,tone:`migration`}:{label:`Expand`,tone:`preview`}:{label:`Unknown`,tone:`preview`}}var i=new Map;for(let t of e.componentDocsGroups)t.sections.forEach((e,a)=>{e.components.forEach((o,s)=>{let c=(n[e.id]??500)+a*10+s;i.set(o,{component:o,group:t.group,badge:r(o),recommendedOrder:c,sectionOrder:a,itemOrder:s})})});function a(e){return i.get(e)}function o(e){return[...i.values()].filter(t=>t.group===e).sort((e,t)=>e.recommendedOrder-t.recommendedOrder)}exports.getComponentDocsAdoption=a,exports.listDocsAdoption=o;

package/dist/families/docs-adoption.d.ts

@@ -0,0 +1,16 @@
+import { type ComponentDocsGroupName } from "@/families/docs-groups";
+export type ComponentDocsBadgeTone = "stable" | "preview" | "advanced" | "migration";
+export type ComponentDocsAdoption = {
+    component: string;
+    group: ComponentDocsGroupName;
+    badge: {
+        label: string;
+        tone: ComponentDocsBadgeTone;
+    };
+    recommendedOrder: number;
+    sectionOrder: number;
+    itemOrder: number;
+};
+declare function getComponentDocsAdoption(component: string): ComponentDocsAdoption | undefined;
+declare function listDocsAdoption(group: ComponentDocsGroupName): ComponentDocsAdoption[];
+export { getComponentDocsAdoption, listDocsAdoption };

package/dist/families/docs-adoption.js

@@ -0,0 +1,53 @@
+import { componentDocsGroups as e } from "./docs-groups.js";
+import { getComponentMemberMetadata as t } from "./member-queries.js";
+//#region src/families/docs-adoption.ts
+var n = {
+	primitives: 0,
+	presets: 100,
+	"form-wrappers": 200,
+	wrappers: 200,
+	extensions: 200,
+	advanced: 300,
+	transitional: 400
+};
+function r(e) {
+	let n = t(e);
+	return n ? n.maturity === "canonical" ? {
+		label: "Start here",
+		tone: "stable"
+	} : n.maturity === "advanced" ? {
+		label: "Advanced",
+		tone: "advanced"
+	} : n.maturity === "transitional" ? {
+		label: "Migration",
+		tone: "migration"
+	} : {
+		label: "Expand",
+		tone: "preview"
+	} : {
+		label: "Unknown",
+		tone: "preview"
+	};
+}
+var i = /* @__PURE__ */ new Map();
+for (let t of e) t.sections.forEach((e, a) => {
+	e.components.forEach((o, s) => {
+		let c = (n[e.id] ?? 500) + a * 10 + s;
+		i.set(o, {
+			component: o,
+			group: t.group,
+			badge: r(o),
+			recommendedOrder: c,
+			sectionOrder: a,
+			itemOrder: s
+		});
+	});
+});
+function a(e) {
+	return i.get(e);
+}
+function o(e) {
+	return [...i.values()].filter((t) => t.group === e).sort((e, t) => e.recommendedOrder - t.recommendedOrder);
+}
+//#endregion
+export { a as getComponentDocsAdoption, o as listDocsAdoption };

package/dist/families/docs-groups.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=[{group:`Input`,family:`InputFamily`,slug:`input`,label:`Input`,primaryComponent:`Input`,description:`Primary text-entry surface with a smaller public set of dashboard-ready input presets.`,sections:[{id:`primitives`,label:`Primitives`,description:`Start from the base field and long-form text area before adding specialized behavior.`,components:[`Input`,`Textarea`]},{id:`core-presets`,label:`Core presets`,description:`Keep only the input variants that are common in real admin and dashboard screens.`,components:[`NumberInput`,`PhoneInput`,`MoneyInput`,`DateInput`,`DateRangeInput`]},{id:`form-wrapper`,label:`Form wrapper`,description:`Input and its text-first presets can still connect to forms through the universal wrapper family.`,components:[]},{id:`compatibility-aliases`,label:`Compatibility aliases`,description:`Older focused input wrappers that still work, but should not lead new adoption.`,components:[`ClearableInput`,`SearchInput`,`MaskedInput`,`QuantityInput`,`FormInput`,`FormSearchInput`,`FormPasswordInput`,`FormNumberInput`,`FormPhoneInput`,`FormDateInput`,`FormDateRangeInput`]},{id:`advanced`,label:`Advanced presets`,description:`Specialized controls that belong to the input family, but should not lead the main catalog.`,components:[`Slider`,`RangeSlider`,`Rating`,`OtpInput`,`ColorInput`,`InlineEditable`,`TagInput`,`QuantityStepper`]}]},{group:`Select`,family:`SelectFamily`,slug:`select`,label:`Select`,primaryComponent:`Select`,description:`Primary choice-picking surface with async, combobox, and form members introduced only when the interaction actually changes.`,sections:[{id:`primitives`,label:`Primitives`,description:`Start with the base select surface before reaching for remote, multi-value, or command-style members.`,components:[`Select`]},{id:`complex-presets`,label:`Complex presets`,description:`Promote only members that add real behavior beyond the base select.`,components:[`AsyncSelect`,`Combobox`]},{id:`advanced`,label:`Advanced`,description:`Remote multi-value selection is powerful, but it should stay behind the simpler select path.`,components:[`AsyncMultiSelect`]},{id:`form-wrapper`,label:`Form wrapper`,description:`Use one form select wrapper instead of teaching separate wrapper names for each select flavor.`,components:[`FormSelect`]},{id:`compatibility-aliases`,label:`Compatibility aliases`,description:`Older select wrappers can stay available, but they should not lead the first-level route.`,components:[`SimpleSelect`,`FormAsyncSelect`]}]},{group:`Card`,family:`CardFamily`,slug:`card`,label:`Card`,primaryComponent:`Card`,description:`General-purpose container plus only the card presets that provide reusable product value.`,sections:[{id:`primitives`,label:`Primitives`,description:`The base card surface and reusable information card variant.`,components:[`Card`,`InfoCard`]},{id:`product-cards`,label:`Product cards`,description:`Card presets that are harder to recreate as a one-off variant.`,components:[`EntityCard`,`FileCard`,`TrendCard`,`ComparisonCard`,`SmartCard`,`StatCard`]}]},{group:`Badge`,family:`BadgeFamily`,slug:`badge`,label:`Badge`,primaryComponent:`Badge`,description:`Inline metadata and status labels through one Badge component with tone, dot, size, and variant props.`,sections:[{id:`primitives`,label:`Primitives`,description:`The canonical badge component. Use props for status, metadata, and subtle labels.`,components:[`Badge`,`DeltaBadge`]}]},{group:`Overlay`,family:`OverlayFamily`,slug:`overlay`,label:`Overlay`,primaryComponent:`Dialog`,description:`Floating interaction surfaces grouped by behavior, not by card-like visual appearance.`,sections:[{id:`primitives`,label:`Primitives`,description:`Start with the primitive that matches the interaction model.`,components:[`Dialog`,`Popover`,`DropdownMenu`,`Tooltip`]},{id:`focused-flows`,label:`Focused flows`,description:`Keep only overlay presets with real flow-level behavior in the public catalog.`,components:[`ConfirmDialog`,`SheetShell`,`HoverCard`,`RightClickMenu`,`AlertDialog`,`ModalShell`,`Drawer`,`DialogActions`]}]},{group:`FormField`,family:`FormFamily`,slug:`form-field`,label:`Form Field`,primaryComponent:`FormFieldShell`,description:`Field-shell composition and a compact set of form wrappers for consistent validation, copy, and layout.`,sections:[{id:`primitives`,label:`Primitives`,description:`The base field shell for labels, descriptions, and errors.`,components:[`FormFieldShell`]},{id:`wrappers`,label:`Wrappers`,description:`Prewired wrappers for common field families and calendar-driven flows.`,components:[`FormTextarea`,`FormSwitch`,`FormDatePicker`,`FormDateRangePicker`,`RepeaterField`]},{id:`advanced`,label:`Advanced`,description:`Higher-level builders and shells for teams that need abstraction over raw fields.`,components:[`FormBuilder`]}]},{group:`DataTable`,family:`DataTableFamily`,slug:`data-table`,label:`Data Table`,primaryComponent:`DataTable`,description:`Tabular data surface centered on one canonical DataTable route, with helper pieces kept secondary.`,sections:[{id:`primitives`,label:`Primitives`,description:`The canonical table surface teams should adopt first.`,components:[`DataTable`]},{id:`core-companions`,label:`Core companions`,description:`Only the companions that most product teams install next to the main grid.`,components:[`DataTableToolbar`,`DataTablePagination`,`DataTableRowActions`,`DataTableBulkActions`,`DataTableViewPresets`]},{id:`advanced`,label:`Advanced`,description:`Factories, visibility helpers, and import-export tooling belong after the main grid contract is already clear.`,components:[`DataTableColumnVisibilityMenu`,`DataTableSortableHeader`,`createDataTableSelectColumn`,`createDataTableActionsColumn`,`TableExportMenu`,`TableImportButton`]}]},...require("./public-surface-rationalization.cjs").additionalDocsGroups];exports.componentDocsGroups=e;

package/dist/families/docs-groups.d.ts

@@ -0,0 +1,18 @@
+import type { ComponentFamilyName } from "@/families/catalog";
+export type ComponentDocsGroupName = "Input" | "Select" | "Card" | "Badge" | "Overlay" | "FormField" | "DataTable" | "Button" | "Alert" | "BarChart" | "Sidebar" | "FileUpload" | "Checkbox" | "Progress";
+export type ComponentDocsSection = {
+    id: string;
+    label: string;
+    description: string;
+    components: readonly string[];
+};
+export type ComponentDocsGroupEntry = {
+    group: ComponentDocsGroupName;
+    family: ComponentFamilyName;
+    slug: string;
+    label: string;
+    primaryComponent: string;
+    description: string;
+    sections: readonly ComponentDocsSection[];
+};
+export declare const componentDocsGroups: ComponentDocsGroupEntry[];

package/dist/families/docs-groups.js

@@ -0,0 +1,262 @@
+import { additionalDocsGroups as e } from "./public-surface-rationalization.js";
+//#region src/families/docs-groups.ts
+var t = [
+	{
+		group: "Input",
+		family: "InputFamily",
+		slug: "input",
+		label: "Input",
+		primaryComponent: "Input",
+		description: "Primary text-entry surface with a smaller public set of dashboard-ready input presets.",
+		sections: [
+			{
+				id: "primitives",
+				label: "Primitives",
+				description: "Start from the base field and long-form text area before adding specialized behavior.",
+				components: ["Input", "Textarea"]
+			},
+			{
+				id: "core-presets",
+				label: "Core presets",
+				description: "Keep only the input variants that are common in real admin and dashboard screens.",
+				components: [
+					"NumberInput",
+					"PhoneInput",
+					"MoneyInput",
+					"DateInput",
+					"DateRangeInput"
+				]
+			},
+			{
+				id: "form-wrapper",
+				label: "Form wrapper",
+				description: "Input and its text-first presets can still connect to forms through the universal wrapper family.",
+				components: []
+			},
+			{
+				id: "compatibility-aliases",
+				label: "Compatibility aliases",
+				description: "Older focused input wrappers that still work, but should not lead new adoption.",
+				components: [
+					"ClearableInput",
+					"SearchInput",
+					"MaskedInput",
+					"QuantityInput",
+					"FormInput",
+					"FormSearchInput",
+					"FormPasswordInput",
+					"FormNumberInput",
+					"FormPhoneInput",
+					"FormDateInput",
+					"FormDateRangeInput"
+				]
+			},
+			{
+				id: "advanced",
+				label: "Advanced presets",
+				description: "Specialized controls that belong to the input family, but should not lead the main catalog.",
+				components: [
+					"Slider",
+					"RangeSlider",
+					"Rating",
+					"OtpInput",
+					"ColorInput",
+					"InlineEditable",
+					"TagInput",
+					"QuantityStepper"
+				]
+			}
+		]
+	},
+	{
+		group: "Select",
+		family: "SelectFamily",
+		slug: "select",
+		label: "Select",
+		primaryComponent: "Select",
+		description: "Primary choice-picking surface with async, combobox, and form members introduced only when the interaction actually changes.",
+		sections: [
+			{
+				id: "primitives",
+				label: "Primitives",
+				description: "Start with the base select surface before reaching for remote, multi-value, or command-style members.",
+				components: ["Select"]
+			},
+			{
+				id: "complex-presets",
+				label: "Complex presets",
+				description: "Promote only members that add real behavior beyond the base select.",
+				components: ["AsyncSelect", "Combobox"]
+			},
+			{
+				id: "advanced",
+				label: "Advanced",
+				description: "Remote multi-value selection is powerful, but it should stay behind the simpler select path.",
+				components: ["AsyncMultiSelect"]
+			},
+			{
+				id: "form-wrapper",
+				label: "Form wrapper",
+				description: "Use one form select wrapper instead of teaching separate wrapper names for each select flavor.",
+				components: ["FormSelect"]
+			},
+			{
+				id: "compatibility-aliases",
+				label: "Compatibility aliases",
+				description: "Older select wrappers can stay available, but they should not lead the first-level route.",
+				components: ["SimpleSelect", "FormAsyncSelect"]
+			}
+		]
+	},
+	{
+		group: "Card",
+		family: "CardFamily",
+		slug: "card",
+		label: "Card",
+		primaryComponent: "Card",
+		description: "General-purpose container plus only the card presets that provide reusable product value.",
+		sections: [{
+			id: "primitives",
+			label: "Primitives",
+			description: "The base card surface and reusable information card variant.",
+			components: ["Card", "InfoCard"]
+		}, {
+			id: "product-cards",
+			label: "Product cards",
+			description: "Card presets that are harder to recreate as a one-off variant.",
+			components: [
+				"EntityCard",
+				"FileCard",
+				"TrendCard",
+				"ComparisonCard",
+				"SmartCard",
+				"StatCard"
+			]
+		}]
+	},
+	{
+		group: "Badge",
+		family: "BadgeFamily",
+		slug: "badge",
+		label: "Badge",
+		primaryComponent: "Badge",
+		description: "Inline metadata and status labels through one Badge component with tone, dot, size, and variant props.",
+		sections: [{
+			id: "primitives",
+			label: "Primitives",
+			description: "The canonical badge component. Use props for status, metadata, and subtle labels.",
+			components: ["Badge", "DeltaBadge"]
+		}]
+	},
+	{
+		group: "Overlay",
+		family: "OverlayFamily",
+		slug: "overlay",
+		label: "Overlay",
+		primaryComponent: "Dialog",
+		description: "Floating interaction surfaces grouped by behavior, not by card-like visual appearance.",
+		sections: [{
+			id: "primitives",
+			label: "Primitives",
+			description: "Start with the primitive that matches the interaction model.",
+			components: [
+				"Dialog",
+				"Popover",
+				"DropdownMenu",
+				"Tooltip"
+			]
+		}, {
+			id: "focused-flows",
+			label: "Focused flows",
+			description: "Keep only overlay presets with real flow-level behavior in the public catalog.",
+			components: [
+				"ConfirmDialog",
+				"SheetShell",
+				"HoverCard",
+				"RightClickMenu",
+				"AlertDialog",
+				"ModalShell",
+				"Drawer",
+				"DialogActions"
+			]
+		}]
+	},
+	{
+		group: "FormField",
+		family: "FormFamily",
+		slug: "form-field",
+		label: "Form Field",
+		primaryComponent: "FormFieldShell",
+		description: "Field-shell composition and a compact set of form wrappers for consistent validation, copy, and layout.",
+		sections: [
+			{
+				id: "primitives",
+				label: "Primitives",
+				description: "The base field shell for labels, descriptions, and errors.",
+				components: ["FormFieldShell"]
+			},
+			{
+				id: "wrappers",
+				label: "Wrappers",
+				description: "Prewired wrappers for common field families and calendar-driven flows.",
+				components: [
+					"FormTextarea",
+					"FormSwitch",
+					"FormDatePicker",
+					"FormDateRangePicker",
+					"RepeaterField"
+				]
+			},
+			{
+				id: "advanced",
+				label: "Advanced",
+				description: "Higher-level builders and shells for teams that need abstraction over raw fields.",
+				components: ["FormBuilder"]
+			}
+		]
+	},
+	{
+		group: "DataTable",
+		family: "DataTableFamily",
+		slug: "data-table",
+		label: "Data Table",
+		primaryComponent: "DataTable",
+		description: "Tabular data surface centered on one canonical DataTable route, with helper pieces kept secondary.",
+		sections: [
+			{
+				id: "primitives",
+				label: "Primitives",
+				description: "The canonical table surface teams should adopt first.",
+				components: ["DataTable"]
+			},
+			{
+				id: "core-companions",
+				label: "Core companions",
+				description: "Only the companions that most product teams install next to the main grid.",
+				components: [
+					"DataTableToolbar",
+					"DataTablePagination",
+					"DataTableRowActions",
+					"DataTableBulkActions",
+					"DataTableViewPresets"
+				]
+			},
+			{
+				id: "advanced",
+				label: "Advanced",
+				description: "Factories, visibility helpers, and import-export tooling belong after the main grid contract is already clear.",
+				components: [
+					"DataTableColumnVisibilityMenu",
+					"DataTableSortableHeader",
+					"createDataTableSelectColumn",
+					"createDataTableActionsColumn",
+					"TableExportMenu",
+					"TableImportButton"
+				]
+			}
+		]
+	},
+	...e
+];
+//#endregion
+export { t as componentDocsGroups };

package/dist/families/docs-queries.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./docs-groups.cjs"),t=require("./member-queries.cjs"),n=require("./member-snippet-queries.cjs"),r=require("./docs-adoption.cjs"),i=require("./docs-routing.cjs");var a=new Map(e.componentDocsGroups.map(e=>[e.group,e])),o=new Map;for(let t of e.componentDocsGroups)for(let e of t.sections)for(let n of e.components)o.set(n,t);function s(e){return a.get(e)}function c(e){let t=i.resolveDocsRouteByComponent(e);return t?a.get(t.group):o.get(e)}function l(t){return e.componentDocsGroups.find(e=>e.family===t)}function u(){return[...e.componentDocsGroups]}function d(){return e.componentDocsGroups.map(e=>({group:e.group,family:e.family,slug:e.slug,label:e.label,primaryComponent:e.primaryComponent,sectionCount:e.sections.length,componentCount:e.sections.reduce((e,t)=>e+t.components.length,0)}))}function f(e){let i=s(e);if(i)return{...i,sections:i.sections.map(e=>({...e,items:e.components.map(e=>({component:e,adoption:r.getComponentDocsAdoption(e),metadata:t.getComponentMemberMetadata(e),snippets:n.getComponentSnippets(e),snippetVariants:n.getComponentSnippetsByVariant(e)}))}))}}exports.getDocsGroup=s,exports.getDocsGroupByComponent=c,exports.getDocsGroupByFamily=l,exports.getDocsGroupDetail=f,exports.getDocsNavigation=d,exports.listDocsGroups=u;

package/dist/families/docs-queries.d.ts

@@ -0,0 +1,37 @@
+import type { ComponentFamilyName } from "@/families/catalog";
+import { type ComponentDocsGroupEntry, type ComponentDocsGroupName } from "@/families/docs-groups";
+declare function getDocsGroup(group: ComponentDocsGroupName): ComponentDocsGroupEntry | undefined;
+declare function getDocsGroupByComponent(component: string): ComponentDocsGroupEntry | undefined;
+declare function getDocsGroupByFamily(family: ComponentFamilyName): ComponentDocsGroupEntry | undefined;
+declare function listDocsGroups(): ComponentDocsGroupEntry[];
+declare function getDocsNavigation(): {
+    group: ComponentDocsGroupName;
+    family: ComponentFamilyName;
+    slug: string;
+    label: string;
+    primaryComponent: string;
+    sectionCount: number;
+    componentCount: number;
+}[];
+declare function getDocsGroupDetail(group: ComponentDocsGroupName): {
+    sections: {
+        items: {
+            component: string;
+            adoption: import("@/families/docs-adoption").ComponentDocsAdoption | undefined;
+            metadata: import("./member-metadata").ComponentMemberMetadata | undefined;
+            snippets: import("./member-snippets").ComponentSnippetExample[];
+            snippetVariants: Map<import("./member-snippets").ComponentSnippetVariant, import("./member-snippets").ComponentSnippetExample[]>;
+        }[];
+        id: string;
+        label: string;
+        description: string;
+        components: readonly string[];
+    }[];
+    group: ComponentDocsGroupName;
+    family: ComponentFamilyName;
+    slug: string;
+    label: string;
+    primaryComponent: string;
+    description: string;
+} | undefined;
+export { getDocsGroup, getDocsGroupDetail, getDocsGroupByComponent, getDocsGroupByFamily, getDocsNavigation, listDocsGroups, };

package/dist/families/docs-queries.js

@@ -0,0 +1,50 @@
+import { componentDocsGroups as e } from "./docs-groups.js";
+import { getComponentMemberMetadata as t } from "./member-queries.js";
+import { getComponentSnippets as n, getComponentSnippetsByVariant as r } from "./member-snippet-queries.js";
+import { getComponentDocsAdoption as i } from "./docs-adoption.js";
+import { resolveDocsRouteByComponent as a } from "./docs-routing.js";
+//#region src/families/docs-queries.ts
+var o = new Map(e.map((e) => [e.group, e])), s = /* @__PURE__ */ new Map();
+for (let t of e) for (let e of t.sections) for (let n of e.components) s.set(n, t);
+function c(e) {
+	return o.get(e);
+}
+function l(e) {
+	let t = a(e);
+	return t ? o.get(t.group) : s.get(e);
+}
+function u(t) {
+	return e.find((e) => e.family === t);
+}
+function d() {
+	return [...e];
+}
+function f() {
+	return e.map((e) => ({
+		group: e.group,
+		family: e.family,
+		slug: e.slug,
+		label: e.label,
+		primaryComponent: e.primaryComponent,
+		sectionCount: e.sections.length,
+		componentCount: e.sections.reduce((e, t) => e + t.components.length, 0)
+	}));
+}
+function p(e) {
+	let a = c(e);
+	if (a) return {
+		...a,
+		sections: a.sections.map((e) => ({
+			...e,
+			items: e.components.map((e) => ({
+				component: e,
+				adoption: i(e),
+				metadata: t(e),
+				snippets: n(e),
+				snippetVariants: r(e)
+			}))
+		}))
+	};
+}
+//#endregion
+export { c as getDocsGroup, l as getDocsGroupByComponent, u as getDocsGroupByFamily, p as getDocsGroupDetail, f as getDocsNavigation, d as listDocsGroups };