azamat-ui-kit-cli 0.2.2

package/vendor/src/components/wizard/wizard.tsx

@@ -0,0 +1,60 @@
+import * as React from "react"
+
+import { Button } from "@/components/ui/button"
+import { Stepper, type StepperStep } from "@/components/wizard/stepper"
+import { cn } from "@/lib/utils"
+
+export type WizardProps = React.ComponentProps<"div"> & {
+  steps: StepperStep[]
+  currentStep: string
+  onStepChange?: (stepId: string) => void
+  onNext?: () => void
+  onPrevious?: () => void
+  onFinish?: () => void
+  nextLabel?: React.ReactNode
+  previousLabel?: React.ReactNode
+  finishLabel?: React.ReactNode
+  children?: React.ReactNode
+  footer?: React.ReactNode
+}
+
+function Wizard({
+  className,
+  steps,
+  currentStep,
+  onStepChange,
+  onNext,
+  onPrevious,
+  onFinish,
+  nextLabel = "Next",
+  previousLabel = "Previous",
+  finishLabel = "Finish",
+  children,
+  footer,
+  ...props
+}: WizardProps) {
+  const currentIndex = Math.max(steps.findIndex((step) => step.id === currentStep), 0)
+  const isFirst = currentIndex === 0
+  const isLast = currentIndex === steps.length - 1
+
+  return (
+    <div data-slot="wizard" className={cn("grid gap-6", className)} {...props}>
+      <Stepper steps={steps} currentStep={currentStep} onStepChange={onStepChange} />
+      <div data-slot="wizard-content" className="min-w-0">
+        {children}
+      </div>
+      {footer ?? (
+        <div data-slot="wizard-footer" className="flex items-center justify-between gap-2 border-t pt-4">
+          <Button type="button" variant="outline" disabled={isFirst} onClick={onPrevious}>
+            {previousLabel}
+          </Button>
+          <Button type="button" onClick={isLast ? onFinish : onNext}>
+            {isLast ? finishLabel : nextLabel}
+          </Button>
+        </div>
+      )}
+    </div>
+  )
+}
+
+export { Wizard }

package/vendor/src/families/card-family.ts

@@ -0,0 +1,28 @@
+import { EntityCard, FileCard, InfoCard, StatisticCard } from "@/components/display"
+import { StatCard } from "@/components/layout"
+import {
+  Card,
+  CardAction,
+  CardContent,
+  CardDescription,
+  CardFooter,
+  CardHeader,
+  CardTitle,
+} from "@/components/ui/card"
+
+const CardFamily = {
+  Root: Card,
+  Header: CardHeader,
+  Title: CardTitle,
+  Description: CardDescription,
+  Action: CardAction,
+  Content: CardContent,
+  Footer: CardFooter,
+  Info: InfoCard,
+  Stat: StatCard,
+  Statistic: StatisticCard,
+  Entity: EntityCard,
+  File: FileCard,
+} as const
+
+export { CardFamily }

package/vendor/src/families/catalog.ts

@@ -0,0 +1,96 @@
+export type ComponentFamilyName =
+  | "InputFamily"
+  | "SelectFamily"
+  | "CardFamily"
+  | "FormFamily"
+  | "DataTableFamily"
+
+export type ComponentFamilyCatalogEntry = {
+  family: ComponentFamilyName
+  label: string
+  description: string
+  canonical: string[]
+  members: string[]
+  transitional?: string[]
+  advanced?: string[]
+}
+
+export const componentFamilyCatalog: ComponentFamilyCatalogEntry[] = [
+  {
+    family: "InputFamily",
+    label: "Input",
+    description: "Text entry, formatted entry, search, password, numeric, date, and supporting input presets.",
+    canonical: ["Input"],
+    members: [
+      "ClearableInput",
+      "SearchInput",
+      "PasswordInput",
+      "NumberInput",
+      "DateInput",
+      "DateRangeInput",
+      "MoneyInput",
+      "QuantityInput",
+      "MaskedInput",
+      "PhoneInput",
+      "OtpInput",
+      "ColorInput",
+    ],
+    advanced: ["TagInput", "QuantityStepper"],
+  },
+  {
+    family: "SelectFamily",
+    label: "Select",
+    description: "Primitive select plus async, multi, combobox, and form integration presets.",
+    canonical: ["Select"],
+    members: ["SimpleSelect", "AsyncSelect", "AsyncMultiSelect", "Combobox", "FormSelect", "FormAsyncSelect"],
+  },
+  {
+    family: "CardFamily",
+    label: "Card",
+    description: "Primitive card plus dashboard and entity-oriented composed card presets.",
+    canonical: ["Card", "InfoCard"],
+    members: ["StatCard", "StatisticCard", "EntityCard", "FileCard"],
+    transitional: ["SmartCard"],
+  },
+  {
+    family: "FormFamily",
+    label: "Form",
+    description: "Field shell, wrappers, sections, actions, shell composition, and builder presets.",
+    canonical: ["FormFieldShell"],
+    members: [
+      "FormInput",
+      "FormTextarea",
+      "FormSelect",
+      "FormAsyncSelect",
+      "FormSwitch",
+      "FormSearchInput",
+      "FormPasswordInput",
+      "FormNumberInput",
+      "FormPhoneInput",
+      "FormDateInput",
+      "FormDateRangeInput",
+      "FormDatePicker",
+      "FormDateRangePicker",
+    ],
+    transitional: ["SmartFormShell"],
+    advanced: ["FormBuilder"],
+  },
+  {
+    family: "DataTableFamily",
+    label: "Data Table",
+    description: "Table shell, toolbar, pagination, actions, presets, and import-export helpers.",
+    canonical: ["DataTable"],
+    members: [
+      "DataTableToolbar",
+      "DataTablePagination",
+      "DataTableColumnVisibilityMenu",
+      "DataTableSortableHeader",
+      "DataTableRowActions",
+      "DataTableBulkActions",
+      "DataTableViewPresets",
+      "createDataTableSelectColumn",
+      "createDataTableActionsColumn",
+    ],
+    advanced: ["TableExportMenu", "TableImportButton"],
+  },
+] as const

package/vendor/src/families/data-table-family.ts

@@ -0,0 +1,31 @@
+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"
+
+const DataTableFamily = {
+  Root: DataTable,
+  Toolbar: DataTableToolbar,
+  Pagination: DataTablePagination,
+  ColumnVisibilityMenu: DataTableColumnVisibilityMenu,
+  SortableHeader: DataTableSortableHeader,
+  RowActions: DataTableRowActions,
+  BulkActions: DataTableBulkActions,
+  ViewPresets: DataTableViewPresets,
+  ExportMenu: TableExportMenu,
+  ImportButton: TableImportButton,
+  createSelectColumn: createDataTableSelectColumn,
+  createActionsColumn: createDataTableActionsColumn,
+} as const
+
+export { DataTableFamily }

package/vendor/src/families/docs-adoption.ts

@@ -0,0 +1,103 @@
+import {
+  componentDocsGroups,
+  type ComponentDocsGroupName,
+} from "@/families/docs-groups"
+import { getComponentMemberMetadata } from "@/families/member-queries"
+
+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
+}
+
+const sectionBaseOrder = {
+  primitives: 0,
+  presets: 100,
+  "form-wrappers": 200,
+  wrappers: 200,
+  extensions: 200,
+  advanced: 300,
+  transitional: 400,
+} as const
+
+function getBadgeForComponent(component: string) {
+  const metadata = getComponentMemberMetadata(component)
+
+  if (!metadata) {
+    return {
+      label: "Unknown",
+      tone: "preview" as const,
+    }
+  }
+
+  if (metadata.maturity === "canonical") {
+    return {
+      label: "Start here",
+      tone: "stable" as const,
+    }
+  }
+
+  if (metadata.maturity === "advanced") {
+    return {
+      label: "Advanced",
+      tone: "advanced" as const,
+    }
+  }
+
+  if (metadata.maturity === "transitional") {
+    return {
+      label: "Migration",
+      tone: "migration" as const,
+    }
+  }
+
+  return {
+    label: "Expand",
+    tone: "preview" as const,
+  }
+}
+
+const docsAdoptionMap = new Map<string, ComponentDocsAdoption>()
+
+for (const group of componentDocsGroups) {
+  group.sections.forEach((section, sectionIndex) => {
+    section.components.forEach((component, itemIndex) => {
+      const baseOrder =
+        sectionBaseOrder[section.id as keyof typeof sectionBaseOrder] ?? 500
+      const recommendedOrder = baseOrder + sectionIndex * 10 + itemIndex
+
+      docsAdoptionMap.set(component, {
+        component,
+        group: group.group,
+        badge: getBadgeForComponent(component),
+        recommendedOrder,
+        sectionOrder: sectionIndex,
+        itemOrder: itemIndex,
+      })
+    })
+  })
+}
+
+function getComponentDocsAdoption(component: string) {
+  return docsAdoptionMap.get(component)
+}
+
+function listDocsAdoption(group: ComponentDocsGroupName) {
+  return [...docsAdoptionMap.values()]
+    .filter((entry) => entry.group === group)
+    .sort((left, right) => left.recommendedOrder - right.recommendedOrder)
+}
+
+export { getComponentDocsAdoption, listDocsAdoption }

package/vendor/src/families/docs-groups.ts

@@ -0,0 +1,209 @@
+import type { ComponentFamilyName } from "@/families/catalog"
+
+export type ComponentDocsGroupName =
+  | "Input"
+  | "Select"
+  | "Card"
+  | "FormField"
+  | "DataTable"
+
+export type ComponentDocsSection = {
+  id: string
+  label: string
+  description: string
+  components: string[]
+}
+
+export type ComponentDocsGroupEntry = {
+  group: ComponentDocsGroupName
+  family: ComponentFamilyName
+  slug: string
+  label: string
+  primaryComponent: string
+  description: string
+  sections: ComponentDocsSection[]
+}
+
+export const componentDocsGroups: ComponentDocsGroupEntry[] = [
+  {
+    group: "Input",
+    family: "InputFamily",
+    slug: "input",
+    label: "Input",
+    primaryComponent: "Input",
+    description: "Single-field text entry with searchable, masked, numeric, date, and formatted presets.",
+    sections: [
+      {
+        id: "primitives",
+        label: "Primitives",
+        description: "Start from the base field and add formatting only when the product surface needs it.",
+        components: ["Input"],
+      },
+      {
+        id: "presets",
+        label: "Presets",
+        description: "Common input variants that keep a shared text-field mental model.",
+        components: [
+          "ClearableInput",
+          "SearchInput",
+          "PasswordInput",
+          "NumberInput",
+          "MaskedInput",
+          "PhoneInput",
+          "MoneyInput",
+          "QuantityInput",
+          "OtpInput",
+          "ColorInput",
+          "DateInput",
+          "DateRangeInput",
+        ],
+      },
+      {
+        id: "form-wrappers",
+        label: "Form wrappers",
+        description: "Start from the universal RHF wrapper and add unique range behavior only when the field actually needs it.",
+        components: ["FormInput", "FormDateRangeInput"],
+      },
+      {
+        id: "transitional",
+        label: "Compatibility aliases",
+        description: "Older wrapper names that still work, but new docs and new product work should prefer FormInput with a matching kind.",
+        components: ["FormSearchInput", "FormPasswordInput", "FormNumberInput", "FormPhoneInput", "FormDateInput"],
+      },
+      {
+        id: "advanced",
+        label: "Advanced",
+        description: "Higher-composition entry patterns that should not replace the default input mental model.",
+        components: ["TagInput", "QuantityStepper"],
+      },
+    ],
+  },
+  {
+    group: "Select",
+    family: "SelectFamily",
+    slug: "select",
+    label: "Select",
+    primaryComponent: "Select",
+    description: "Choice picking with synchronous, async, multi-select, and combobox presets.",
+    sections: [
+      {
+        id: "primitives",
+        label: "Primitives",
+        description: "The base select surface for single-choice flows.",
+        components: ["Select"],
+      },
+      {
+        id: "presets",
+        label: "Presets",
+        description: "Composed select patterns for remote data, searchable lists, and richer triggers.",
+        components: ["SimpleSelect", "AsyncSelect", "AsyncMultiSelect", "Combobox"],
+      },
+      {
+        id: "form-wrappers",
+        label: "Form wrappers",
+        description: "Use the universal RHF select wrapper first, then switch modes only when remote loading is required.",
+        components: ["FormSelect"],
+      },
+      {
+        id: "transitional",
+        label: "Compatibility aliases",
+        description: "Older wrapper names that still work, but new docs should point teams to FormSelect as the primary entry.",
+        components: ["FormAsyncSelect"],
+      },
+    ],
+  },
+  {
+    group: "Card",
+    family: "CardFamily",
+    slug: "card",
+    label: "Card",
+    primaryComponent: "Card",
+    description: "General-purpose container plus reusable display presets for stats, files, and entities.",
+    sections: [
+      {
+        id: "primitives",
+        label: "Primitives",
+        description: "The base card surface and the most reusable composed card variant.",
+        components: ["Card", "InfoCard"],
+      },
+      {
+        id: "presets",
+        label: "Presets",
+        description: "Purpose-built card shapes for dashboards and data-heavy product screens.",
+        components: ["StatCard", "StatisticCard", "EntityCard", "FileCard"],
+      },
+      {
+        id: "transitional",
+        label: "Transitional",
+        description: "Older names that still work but should not lead new docs or examples.",
+        components: ["SmartCard"],
+      },
+    ],
+  },
+  {
+    group: "FormField",
+    family: "FormFamily",
+    slug: "form-field",
+    label: "Form Field",
+    primaryComponent: "FormFieldShell",
+    description: "Field-shell composition and RHF 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"],
+      },
+      {
+        id: "advanced",
+        label: "Advanced",
+        description: "Higher-level builders and shells for teams that need abstraction over raw fields.",
+        components: ["FormBuilder", "SmartFormShell"],
+      },
+    ],
+  },
+  {
+    group: "DataTable",
+    family: "DataTableFamily",
+    slug: "data-table",
+    label: "Data Table",
+    primaryComponent: "DataTable",
+    description: "Tabular data surface with toolbar, pagination, bulk actions, and column helpers.",
+    sections: [
+      {
+        id: "primitives",
+        label: "Primitives",
+        description: "The canonical table surface teams should adopt first.",
+        components: ["DataTable"],
+      },
+      {
+        id: "extensions",
+        label: "Extensions",
+        description: "Composable table helpers for view controls, actions, and pagination.",
+        components: [
+          "DataTableToolbar",
+          "DataTablePagination",
+          "DataTableColumnVisibilityMenu",
+          "DataTableSortableHeader",
+          "DataTableRowActions",
+          "DataTableBulkActions",
+          "DataTableViewPresets",
+          "createDataTableSelectColumn",
+          "createDataTableActionsColumn",
+        ],
+      },
+      {
+        id: "advanced",
+        label: "Advanced",
+        description: "Import-export helpers that should be introduced only when the core grid is already clear.",
+        components: ["TableExportMenu", "TableImportButton"],
+      },
+    ],
+  },
+] as const

package/vendor/src/families/docs-queries.ts

@@ -0,0 +1,84 @@
+import type { ComponentFamilyName } from "@/families/catalog"
+import {
+  componentDocsGroups,
+  type ComponentDocsGroupEntry,
+  type ComponentDocsGroupName,
+} from "@/families/docs-groups"
+import { getComponentMemberMetadata } from "@/families/member-queries"
+import {
+  getComponentSnippets,
+  getComponentSnippetsByVariant,
+} from "@/families/member-snippet-queries"
+import { getComponentDocsAdoption } from "@/families/docs-adoption"
+import { resolveDocsRouteByComponent } from "@/families/docs-routing"
+
+const docsGroupByName = new Map<ComponentDocsGroupName, ComponentDocsGroupEntry>(
+  componentDocsGroups.map((entry) => [entry.group, entry])
+)
+
+const docsGroupByComponent = new Map<string, ComponentDocsGroupEntry>()
+
+for (const entry of componentDocsGroups) {
+  for (const section of entry.sections) {
+    for (const component of section.components) {
+      docsGroupByComponent.set(component, entry)
+    }
+  }
+}
+
+function getDocsGroup(group: ComponentDocsGroupName) {
+  return docsGroupByName.get(group)
+}
+
+function getDocsGroupByComponent(component: string) {
+  const route = resolveDocsRouteByComponent(component)
+  return route ? docsGroupByName.get(route.group) : docsGroupByComponent.get(component)
+}
+
+function getDocsGroupByFamily(family: ComponentFamilyName) {
+  return componentDocsGroups.find((entry) => entry.family === family)
+}
+
+function listDocsGroups() {
+  return [...componentDocsGroups]
+}
+
+function getDocsNavigation() {
+  return componentDocsGroups.map((entry) => ({
+    group: entry.group,
+    family: entry.family,
+    slug: entry.slug,
+    label: entry.label,
+    primaryComponent: entry.primaryComponent,
+    sectionCount: entry.sections.length,
+    componentCount: entry.sections.reduce((total, section) => total + section.components.length, 0),
+  }))
+}
+
+function getDocsGroupDetail(group: ComponentDocsGroupName) {
+  const entry = getDocsGroup(group)
+  if (!entry) return undefined
+
+  return {
+    ...entry,
+    sections: entry.sections.map((section) => ({
+      ...section,
+      items: section.components.map((component) => ({
+        component,
+        adoption: getComponentDocsAdoption(component),
+        metadata: getComponentMemberMetadata(component),
+        snippets: getComponentSnippets(component),
+        snippetVariants: getComponentSnippetsByVariant(component),
+      })),
+    })),
+  }
+}
+
+export {
+  getDocsGroup,
+  getDocsGroupDetail,
+  getDocsGroupByComponent,
+  getDocsGroupByFamily,
+  getDocsNavigation,
+  listDocsGroups,
+}

package/vendor/src/families/docs-routing.ts

@@ -0,0 +1,89 @@
+import {
+  componentDocsGroups,
+  type ComponentDocsGroupEntry,
+  type ComponentDocsGroupName,
+} from "@/families/docs-groups"
+
+export type ComponentDocsRouteMatch = {
+  component?: string
+  group: ComponentDocsGroupName
+  slug: string
+  primaryComponent: string
+}
+
+function normalizeDocsToken(value: string) {
+  return value.trim().toLowerCase().replace(/[^a-z0-9]+/g, "")
+}
+
+function toKebabCase(value: string) {
+  return value
+    .replace(/([a-z0-9])([A-Z])/g, "$1-$2")
+    .replace(/[\s_]+/g, "-")
+    .toLowerCase()
+}
+
+function getDocsRouteAliases(entry: ComponentDocsGroupEntry) {
+  const components = entry.sections.flatMap((section) => section.components)
+  const aliases = new Set<string>([
+    entry.group,
+    entry.label,
+    entry.slug,
+    entry.primaryComponent,
+    toKebabCase(entry.primaryComponent),
+  ])
+
+  for (const component of components) {
+    aliases.add(component)
+    aliases.add(toKebabCase(component))
+  }
+
+  return [...aliases]
+}
+
+const docsRouteAliasMap = new Map<string, ComponentDocsRouteMatch>()
+const docsRouteComponentMap = new Map<string, ComponentDocsRouteMatch>()
+
+for (const entry of componentDocsGroups) {
+  const components = entry.sections.flatMap((section) => section.components)
+
+  for (const component of components) {
+    docsRouteComponentMap.set(component, {
+      component,
+      group: entry.group,
+      slug: entry.slug,
+      primaryComponent: entry.primaryComponent,
+    })
+  }
+
+  for (const alias of getDocsRouteAliases(entry)) {
+    docsRouteAliasMap.set(normalizeDocsToken(alias), {
+      group: entry.group,
+      slug: entry.slug,
+      primaryComponent: entry.primaryComponent,
+    })
+  }
+}
+
+function resolveDocsRouteByComponent(component: string) {
+  return docsRouteComponentMap.get(component)
+}
+
+function resolveDocsRoute(value: string) {
+  return docsRouteAliasMap.get(normalizeDocsToken(value))
+}
+
+function listDocsRouteAliases() {
+  return componentDocsGroups.map((entry) => ({
+    group: entry.group,
+    slug: entry.slug,
+    aliases: getDocsRouteAliases(entry),
+  }))
+}
+
+export {
+  listDocsRouteAliases,
+  normalizeDocsToken,
+  resolveDocsRoute,
+  resolveDocsRouteByComponent,
+  toKebabCase,
+}