erp-pro-ui 0.1.4 → 0.1.6

package/dist/docs.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"docs.cjs","names":[],"sources":["../src/docs.ts"],"sourcesContent":["import {\n  getUiCatalogDocsRoute,\n  type UiCatalogSlug,\n  type UiCatalogStatus,\n  uiCatalogItems,\n} from \"./catalog\";\n\nexport type LibraryDocsCodeLanguage = \"bash\" | \"css\" | \"json\" | \"tsx\";\n\nexport interface LibraryDocsCodeExample {\n  readonly title: string;\n  readonly language: LibraryDocsCodeLanguage;\n  readonly code: string;\n  readonly description?: string;\n}\n\nexport interface LibraryDocsInstallStep {\n  readonly title: string;\n  readonly description: string;\n  readonly examples?: readonly LibraryDocsCodeExample[];\n}\n\nexport interface LibraryDocsPeerDependency {\n  readonly name: string;\n  readonly reason: string;\n}\n\nexport interface LibraryComponentDoc {\n  readonly name: string;\n  readonly slug: UiCatalogSlug;\n  readonly status?: UiCatalogStatus;\n  readonly category: string;\n  readonly summary: string;\n  readonly storybookTitle: string;\n  readonly packageExportPath: string;\n  readonly exportName?: string;\n  readonly aliases: readonly string[];\n  readonly rootImport: string;\n  readonly subpathImport: string;\n  readonly docsRoute: string;\n  readonly docsUrl: string;\n  readonly related: readonly UiCatalogSlug[];\n}\n\nexport interface LibraryDocsBundle {\n  readonly packageName: \"erp-pro-ui\";\n  readonly docsBaseUrl: string;\n  readonly summary: string;\n  readonly features: readonly string[];\n  readonly installSteps: readonly LibraryDocsInstallStep[];\n  readonly peerDependencies: readonly LibraryDocsPeerDependency[];\n  readonly quickStartExamples: readonly LibraryDocsCodeExample[];\n  readonly components: readonly LibraryComponentDoc[];\n}\n\ninterface ComponentDocSeed {\n  readonly exportName?: string;\n  readonly summary: string;\n  readonly aliases?: readonly string[];\n  readonly related?: readonly UiCatalogSlug[];\n  readonly rootImport?: string;\n  readonly subpathImport?: string;\n}\n\nconst DOCS_BASE_URL = \"https://daniel-heydari-dev.github.io/erp-pro-ui\";\n\nconst componentDocSeeds = {\n  combobox: {\n    exportName: \"Combobox\",\n    summary:\n      \"Searchable single-select control for long option lists and command-style pickers.\",\n    aliases: [\"autocomplete\", \"search select\"],\n    related: [\"select\", \"multiselect-combobox\", \"input\"],\n  },\n  button: {\n    exportName: \"Button\",\n    summary:\n      \"Primary action trigger with size variants, button attributes, and support for custom children.\",\n    aliases: [\"cta\", \"action\"],\n    related: [\"dialog\", \"form\", \"input\"],\n  },\n  input: {\n    exportName: \"Input\",\n    summary:\n      \"Text field for forms with label, validation state, helper text, and icon support.\",\n    aliases: [\"text field\", \"field\"],\n    related: [\"label\", \"textarea\", \"form\"],\n  },\n  checkbox: {\n    exportName: \"Checkbox\",\n    summary:\n      \"Binary selection control for filters, permissions, and multi-select form fields.\",\n    aliases: [\"boolean\"],\n    related: [\"radio\", \"switch\", \"form\"],\n  },\n  radio: {\n    exportName: \"Radio\",\n    summary:\n      \"Single-choice selection control for mutually exclusive form options.\",\n    aliases: [\"radio group\"],\n    related: [\"checkbox\", \"select\", \"form\"],\n  },\n  switch: {\n    exportName: \"Switch\",\n    summary:\n      \"Immediate on/off toggle suited to settings panels and preference screens.\",\n    aliases: [\"toggle\"],\n    related: [\"checkbox\", \"sun-to-moon-button\", \"form\"],\n  },\n  select: {\n    exportName: \"Select\",\n    summary: \"Compact dropdown input for short, fixed option sets.\",\n    aliases: [\"dropdown\"],\n    related: [\"combobox\", \"multiselect-combobox\", \"form\"],\n  },\n  textarea: {\n    exportName: \"Textarea\",\n    summary:\n      \"Multi-line text input for descriptions, notes, and longer form responses.\",\n    aliases: [\"multiline input\"],\n    related: [\"input\", \"label\", \"form\"],\n  },\n  label: {\n    exportName: \"Label\",\n    summary:\n      \"Accessible form label primitive for pairing readable text with inputs and controls.\",\n    aliases: [\"field label\"],\n    related: [\"input\", \"textarea\", \"form\"],\n  },\n  dialog: {\n    exportName: \"Dialog\",\n    summary:\n      \"Modal overlay for confirmations, destructive flows, and custom embedded forms.\",\n    aliases: [\"modal\"],\n    related: [\"drawer\", \"button\", \"toast\"],\n  },\n  drawer: {\n    exportName: \"Drawer\",\n    summary:\n      \"Slide-in panel for secondary workflows, detail panes, and mobile task flows.\",\n    aliases: [\"sheet\", \"side panel\"],\n    related: [\"dialog\", \"card\", \"tooltip\"],\n  },\n  alert: {\n    exportName: \"Alert\",\n    summary:\n      \"Inline status banner with semantic variants for success, warning, info, and destructive states.\",\n    aliases: [\"message banner\"],\n    related: [\"toast\", \"loading\", \"skeleton\"],\n  },\n  toast: {\n    exportName: \"ToastProvider\",\n    summary:\n      \"Transient notification system exposed through ToastProvider and useToast for async feedback.\",\n    aliases: [\"notification\"],\n    related: [\"alert\", \"dialog\", \"loading\"],\n    rootImport: \"import { ToastProvider, useToast } from 'erp-pro-ui';\",\n    subpathImport:\n      \"import { ToastProvider, useToast } from 'erp-pro-ui/toast';\",\n  },\n  tooltip: {\n    exportName: \"Tooltip\",\n    summary:\n      \"Hover and focus overlay for concise contextual help without leaving the current view.\",\n    aliases: [\"hint\"],\n    related: [\"hover-card\", \"dialog\", \"drawer\"],\n  },\n  accordion: {\n    exportName: \"Accordion\",\n    summary:\n      \"Expandable content container for FAQs, settings groups, and disclosure-heavy interfaces.\",\n    aliases: [\"collapse\"],\n    related: [\"card\", \"stepper\", \"tooltip\"],\n  },\n  card: {\n    exportName: \"Card\",\n    summary:\n      \"Surface container for grouping content, actions, and stats in dashboards and forms.\",\n    aliases: [\"panel\"],\n    related: [\"accordion\", \"spotlight-card\", \"data-table\"],\n  },\n  stepper: {\n    exportName: \"Stepper\",\n    summary:\n      \"Visual progress indicator for guided workflows, checkouts, and multi-step forms.\",\n    aliases: [\"wizard steps\"],\n    related: [\"form\", \"chip\", \"loading\"],\n  },\n  chip: {\n    exportName: \"Chip\",\n    summary:\n      \"Compact status and taxonomy token with visual variants for tags, states, and filters.\",\n    aliases: [\"tag\", \"badge\"],\n    related: [\"alert\", \"color-palette\", \"stepper\"],\n  },\n  \"progress-bar\": {\n    exportName: \"ProgressBar\",\n    summary:\n      \"Linear progress indicator for completion ratios, quotas, and compact operational status rows.\",\n    aliases: [\"progress\", \"meter\", \"completion bar\"],\n    related: [\"chip\", \"loading\", \"stepper\"],\n  },\n  calendar: {\n    exportName: \"Calendar\",\n    summary:\n      \"Calendar view for scheduling surfaces, date picking UIs, and embedded planners.\",\n    aliases: [\"date calendar\"],\n    related: [\"datepicker\", \"input\", \"form\"],\n  },\n  datepicker: {\n    exportName: \"DatePicker\",\n    summary:\n      \"Calendar-backed date input for forms that need controlled value selection and display.\",\n    aliases: [\"date picker\"],\n    related: [\"calendar\", \"input\", \"form\"],\n  },\n  \"multiselect-combobox\": {\n    exportName: \"MultiSelectCombobox\",\n    summary:\n      \"Searchable multi-value selector for filters, assignee pickers, and label assignment flows.\",\n    aliases: [\"multi select\", \"token select\"],\n    related: [\"combobox\", \"select\", \"chip\"],\n  },\n  \"hover-card\": {\n    exportName: \"HoverCard\",\n    summary:\n      \"Rich hover preview surface for profile cards, metadata popovers, and secondary details.\",\n    aliases: [\"preview card\"],\n    related: [\"tooltip\", \"card\", \"dialog\"],\n  },\n  \"spotlight-card\": {\n    exportName: \"SpotlightCard\",\n    summary:\n      \"Interactive card with a cursor-reactive spotlight effect for premium landing sections.\",\n    aliases: [\"interactive card\"],\n    related: [\"card\", \"hover-border-gradient\", \"background-gradient\"],\n  },\n  \"splash-cursor\": {\n    exportName: \"SplashCursor\",\n    summary:\n      \"Pointer effect that adds an animated splash trail for immersive visual experiences.\",\n    aliases: [\"cursor effect\"],\n    related: [\"chroma-grid\", \"animated-content\", \"spotlight-card\"],\n  },\n  \"chroma-grid\": {\n    exportName: \"ChromaGrid\",\n    summary:\n      \"Animated chromatic grid background for showcase sections, heroes, and immersive canvases.\",\n    aliases: [\"grid effect\"],\n    related: [\"background-gradient\", \"splash-cursor\", \"gradual-blur\"],\n  },\n  \"color-palette\": {\n    exportName: \"ColorPalette\",\n    summary:\n      \"Palette viewer for design tokens, brand colors, and handoff documentation.\",\n    aliases: [\"swatches\"],\n    related: [\"chip\", \"typography\", \"icons\"],\n  },\n  \"gradual-blur\": {\n    exportName: \"GradualBlur\",\n    summary:\n      \"Progressive blur reveal wrapper for staged entrances and atmospheric transitions.\",\n    aliases: [\"blur reveal\"],\n    related: [\"animated-content\", \"background-gradient\", \"chroma-grid\"],\n  },\n  \"animated-content\": {\n    exportName: \"AnimatedContent\",\n    summary:\n      \"Scroll and reveal motion wrapper for staging content entrances without custom animation plumbing.\",\n    aliases: [\"reveal animation\"],\n    related: [\"gradual-blur\", \"spotlight-card\", \"splash-cursor\"],\n  },\n  \"background-gradient\": {\n    exportName: \"BackgroundGradientAnimation\",\n    summary:\n      \"Animated multi-stop gradient backdrop for hero sections and premium product storytelling.\",\n    aliases: [\"gradient background\"],\n    related: [\"chroma-grid\", \"gradual-blur\", \"spotlight-card\"],\n  },\n  \"hover-border-gradient\": {\n    exportName: \"HoverBorderGradient\",\n    summary:\n      \"Gradient-border wrapper that emphasizes cards and feature callouts on hover.\",\n    aliases: [\"gradient border\"],\n    related: [\"button-hover-border-gradient\", \"card\", \"spotlight-card\"],\n  },\n  \"button-hover-border-gradient\": {\n    exportName: \"ButtonHoverBorderGradient\",\n    summary:\n      \"CTA button variant with animated gradient edge treatment for high-emphasis surfaces.\",\n    aliases: [\"gradient button\"],\n    related: [\"button\", \"hover-border-gradient\", \"background-gradient\"],\n  },\n  \"password-strength-meter\": {\n    exportName: \"PasswordStrengthMeter\",\n    summary:\n      \"Password quality indicator for sign-up and reset forms that need immediate feedback.\",\n    aliases: [\"password meter\"],\n    related: [\"input\", \"form\", \"alert\"],\n  },\n  \"sun-to-moon-button\": {\n    exportName: \"SunToMoonButton\",\n    summary:\n      \"Animated theme toggle control for switching between light and dark presentation modes.\",\n    aliases: [\"theme toggle\"],\n    related: [\"switch\", \"typography\", \"background-gradient\"],\n  },\n  carousel: {\n    exportName: \"Carousel\",\n    summary:\n      \"Content slider for galleries, testimonials, walkthroughs, and promotional sequences.\",\n    aliases: [\"slider\"],\n    related: [\"card\", \"animated-content\", \"spotlight-card\"],\n  },\n  otpinput: {\n    exportName: \"OTPInput\",\n    summary:\n      \"One-time passcode input optimized for verification flows, MFA, and access codes.\",\n    aliases: [\"otp\", \"verification code\"],\n    related: [\"input\", \"password-strength-meter\", \"form\"],\n  },\n  form: {\n    exportName: \"Form\",\n    summary:\n      \"Form composition surface for validation-driven layouts and grouped input sections.\",\n    aliases: [\"form wrapper\"],\n    related: [\"input\", \"button\", \"stepper\"],\n  },\n  \"data-table\": {\n    exportName: \"DataTable\",\n    summary:\n      \"Feature-rich data grid with sorting, filtering, column toggles, and filter profiles.\",\n    aliases: [\"table\", \"grid\"],\n    related: [\"loading\", \"skeleton\", \"chip\"],\n  },\n  loading: {\n    exportName: \"Loading\",\n    summary:\n      \"Unified loading surface exposing spinner, dots, pulse, bars, ring, bounce, wave, and skeleton variants.\",\n    aliases: [\"loader\", \"progress indicator\"],\n    related: [\"skeleton\", \"alert\", \"data-table\"],\n  },\n  skeleton: {\n    exportName: \"SkeletonComponent\",\n    summary:\n      \"Theme-aware placeholder system with semantic tones, speed control, light/dark mode support, and ready-made metric, card, list, and table presets.\",\n    aliases: [\"placeholder\"],\n    related: [\"loading\", \"data-table\", \"card\"],\n    rootImport: \"import { SkeletonComponent } from 'erp-pro-ui';\",\n    subpathImport:\n      \"import { Skeleton as SkeletonComponent, SkeletonMetricCard } from 'erp-pro-ui/skeleton';\",\n  },\n  \"area-chart\": {\n    exportName: \"AreaChart\",\n    summary:\n      \"Gradient-filled area chart for trend storytelling and cumulative time-series views.\",\n    aliases: [\"trend chart\"],\n    related: [\"bar-chart\", \"neon-line-chart\", \"stacked-bar-chart\"],\n  },\n  \"bar-chart\": {\n    exportName: \"BarChart\",\n    summary:\n      \"Bar chart for comparisons across categories, teams, or time buckets.\",\n    aliases: [\"column chart\"],\n    related: [\"area-chart\", \"stacked-bar-chart\", \"thin-breakdown-bar\"],\n  },\n  \"positive-negative-bar-chart\": {\n    exportName: \"PositiveNegativeBarChart\",\n    summary:\n      \"Signed bar chart for profit-loss swings, variance reporting, and delta views that pivot around zero.\",\n    aliases: [\"variance chart\", \"profit loss chart\"],\n    related: [\"bar-chart\", \"stacked-bar-chart\", \"area-chart\"],\n  },\n  \"pie-chart\": {\n    exportName: \"PieChart\",\n    summary:\n      \"Pie and donut chart visualizations for part-to-whole comparisons with small category sets.\",\n    aliases: [\"donut chart\"],\n    related: [\"bar-chart\", \"thin-breakdown-bar\", \"color-palette\"],\n  },\n  \"neon-line-chart\": {\n    exportName: \"NeonLineChart\",\n    summary:\n      \"High-emphasis glowing line chart for dashboards that need a more stylized analytical treatment.\",\n    aliases: [\"line chart\"],\n    related: [\"area-chart\", \"bar-chart\", \"stacked-bar-chart\"],\n  },\n  \"stacked-bar-chart\": {\n    exportName: \"StackedBarChart\",\n    summary:\n      \"Stacked categorical chart for comparing totals and composition inside each bar.\",\n    aliases: [\"stacked chart\"],\n    related: [\"bar-chart\", \"thin-breakdown-bar\", \"area-chart\"],\n  },\n  \"thin-breakdown-bar\": {\n    exportName: \"ThinBreakdownBar\",\n    summary:\n      \"Compact horizontal breakdown bar for inline composition summaries and KPI cards.\",\n    aliases: [\"breakdown bar\"],\n    related: [\"stacked-bar-chart\", \"pie-chart\", \"chip\"],\n  },\n  icons: {\n    summary:\n      \"Collection of custom SVG icons for dashboards, navigation, commerce, and status-heavy product UIs.\",\n    aliases: [\"icon pack\", \"svg icons\"],\n    related: [\"typography\", \"color-palette\", \"button\"],\n    rootImport:\n      \"import { IconDashboard, IconSettings, IconUser } from 'erp-pro-ui';\",\n    subpathImport:\n      \"import { IconDashboard, IconSettings, IconUser } from 'erp-pro-ui/icons';\",\n  },\n  typography: {\n    exportName: \"Typography\",\n    summary:\n      \"Semantic text component with heading, body, caption, alignment, weight, and gradient options.\",\n    aliases: [\"text\"],\n    related: [\"color-palette\", \"icons\", \"button\"],\n  },\n} as const satisfies Record<UiCatalogSlug, ComponentDocSeed>;\n\nfunction getComponentCategory(storybookTitle: string): string {\n  return storybookTitle.split(\"/\")[0] ?? \"Components\";\n}\n\nfunction getDefaultRootImport(exportName: string): string {\n  return `import { ${exportName} } from 'erp-pro-ui';`;\n}\n\nfunction getDefaultSubpathImport(\n  exportName: string,\n  packageExportPath: string,\n): string {\n  return `import { ${exportName} } from 'erp-pro-ui/${packageExportPath}';`;\n}\n\nexport const libraryPeerDependencies = [\n  {\n    name: \"framer-motion\",\n    reason: \"Required by motion-heavy overlays and effects.\",\n  },\n  {\n    name: \"three\",\n    reason: \"Required for Three.js-based visual components.\",\n  },\n  {\n    name: \"@react-three/fiber\",\n    reason: \"React renderer used by 3D visual surfaces.\",\n  },\n  {\n    name: \"@react-three/drei\",\n    reason: \"Helper primitives used by 3D components.\",\n  },\n  {\n    name: \"@tanstack/react-table\",\n    reason: \"Required for DataTable filtering and column tooling.\",\n  },\n  {\n    name: \"recharts\",\n    reason: \"Required for chart components.\",\n  },\n  {\n    name: \"lucide-react\",\n    reason: \"Used by selected UI controls and docs examples.\",\n  },\n] as const satisfies readonly LibraryDocsPeerDependency[];\n\nexport const libraryInstallSteps = [\n  {\n    title: \"Install the package\",\n    description:\n      \"Add erp-pro-ui to your React application with your preferred package manager.\",\n    examples: [\n      {\n        title: \"pnpm\",\n        language: \"bash\",\n        code: \"pnpm add erp-pro-ui\",\n      },\n    ],\n  },\n  {\n    title: \"Install peer dependencies\",\n    description:\n      \"Install only the optional peer packages used by motion, tables, and 3D visuals you actually render.\",\n    examples: [\n      {\n        title: \"Peers\",\n        language: \"bash\",\n        code: \"pnpm add framer-motion three @tanstack/react-table\",\n      },\n    ],\n  },\n  {\n    title: \"Import the shared styles\",\n    description:\n      \"Import Tailwind first, then the library stylesheet once at the app entry to load tokens, fonts, foundations, and semantic utilities with no extra Tailwind config.\",\n    examples: [\n      {\n        title: \"Root stylesheet\",\n        language: \"css\",\n        code: '@import \"tailwindcss\";\\n@import \"erp-pro-ui/styles.css\";',\n      },\n    ],\n  },\n  {\n    title: \"Use colors and fonts directly\",\n    description:\n      \"Import tokens.css for raw CSS variables without Tailwind utilities, or colors.css when you want the Tailwind v4 utility bridge generated from the shared semantic tokens. Prefer semantic utilities and --ds-* tokens in new code; the legacy --color-* aliases remain for migration.\",\n    examples: [\n      {\n        title: \"Raw token import\",\n        language: \"css\",\n        code: '@import \"erp-pro-ui/tokens.css\";',\n      },\n      {\n        title: \"Tailwind bridge import\",\n        language: \"css\",\n        code: '@import \"tailwindcss\";\\n@import \"erp-pro-ui/colors.css\";\\n@import \"erp-pro-ui/fonts.css\";',\n      },\n      {\n        title: \"Theme token usage\",\n        language: \"tsx\",\n        code: 'import { Button } from \"erp-pro-ui\";\\n\\n<section className=\"bg-surface text-fg border border-border rounded-2xl p-6\">\\n  <Button label=\"Save\" primary />\\n</section>',\n      },\n      {\n        title: \"Chart token usage\",\n        language: \"tsx\",\n        code: 'import { AreaChart, getChartColorVar } from \"erp-pro-ui\";\\n\\n<AreaChart\\n  data={data}\\n  categories={[\\n    { key: \"revenue\", color: getChartColorVar(1) },\\n    { key: \"cost\", color: \"chart-6\" },\\n    { key: \"forecast\", color: \"var(--color-chart-10)\" },\\n  ]}\\n/>',\n        description:\n          \"Chart components accept raw CSS colors, theme chart variables, or the built-in chart token helper. The shared token surface includes chart slots 1 through 15.\",\n      },\n    ],\n  },\n  {\n    title: \"Wrap your app with ThemeProvider\",\n    description:\n      \"Use ThemeProvider at the root so shared brand and mode attributes are applied as data-brand and data-mode for the token system. The older data-theme attribute is still written for compatibility, but brand and mode are the primary contract.\",\n    examples: [\n      {\n        title: \"Root provider\",\n        language: \"tsx\",\n        code: \"import { ThemeProvider } from 'erp-pro-ui';\\n\\ncreateRoot(rootElement).render(\\n  <ThemeProvider>\\n    <App />\\n  </ThemeProvider>,\\n);\",\n      },\n      {\n        title: \"Manual attributes\",\n        language: \"tsx\",\n        code: '<html data-brand=\"teal\" data-mode=\"dark\"></html>',\n      },\n    ],\n  },\n  {\n    title: \"Choose an import strategy\",\n    description:\n      \"Use root imports for convenience or subpath imports for a more explicit public contract per component.\",\n    examples: [\n      {\n        title: \"Root imports\",\n        language: \"tsx\",\n        code: \"import { Button, Dialog, Input } from 'erp-pro-ui';\",\n      },\n      {\n        title: \"Subpath imports\",\n        language: \"tsx\",\n        code: \"import { Button } from 'erp-pro-ui/button';\\nimport { Dialog } from 'erp-pro-ui/dialog';\",\n      },\n    ],\n  },\n] as const satisfies readonly LibraryDocsInstallStep[];\n\nexport const libraryQuickStartExamples = [\n  {\n    title: \"Basic screen scaffold\",\n    language: \"tsx\",\n    code: 'import { Button, Input, ThemeProvider, Typography } from \\'erp-pro-ui\\';\\n\\nexport function App() {\\n  return (\\n    <ThemeProvider>\\n      <section className=\"space-y-4 p-6\">\\n        <Typography variant=\"h2\" gradient=\"ocean\">\\n          Welcome to ERP Pro\\n        </Typography>\\n        <Input label=\"Email\" placeholder=\"you@company.com\" />\\n        <Button label=\"Get Started\" primary />\\n      </section>\\n    </ThemeProvider>\\n  );\\n}',\n  },\n  {\n    title: \"Dialog confirmation pattern\",\n    language: \"tsx\",\n    code: 'import { Dialog } from \\'erp-pro-ui\\';\\n\\n<Dialog\\n  open={isOpen}\\n  onOpenChange={setIsOpen}\\n  title=\"Confirm delete\"\\n  description=\"This action cannot be undone.\"\\n  variant=\"destructive\"\\n  preset=\"confirm\"\\n  animation=\"scale\"\\n  onConfirm={handleDelete}\\n/>;',\n  },\n] as const satisfies readonly LibraryDocsCodeExample[];\n\nexport const componentDocs: readonly LibraryComponentDoc[] = uiCatalogItems.map(\n  (item): LibraryComponentDoc => {\n    const seed: ComponentDocSeed = componentDocSeeds[item.slug];\n    const docsRoute = getUiCatalogDocsRoute(item.slug);\n    const rootImport =\n      seed.rootImport ??\n      (seed.exportName\n        ? getDefaultRootImport(seed.exportName)\n        : `import * as ${item.name.replace(/\\s+/g, \"\")} from 'erp-pro-ui';`);\n    const subpathImport =\n      seed.subpathImport ??\n      (seed.exportName\n        ? getDefaultSubpathImport(seed.exportName, item.packageExportPath)\n        : `import * as ${item.name.replace(/\\s+/g, \"\")} from 'erp-pro-ui/${item.packageExportPath}';`);\n\n    return {\n      name: item.name,\n      slug: item.slug,\n      status: \"status\" in item ? item.status : undefined,\n      category: getComponentCategory(item.storybookTitle),\n      summary: seed.summary,\n      storybookTitle: item.storybookTitle,\n      packageExportPath: item.packageExportPath,\n      exportName: seed.exportName,\n      aliases: seed.aliases ?? [],\n      rootImport,\n      subpathImport,\n      docsRoute,\n      docsUrl: `${DOCS_BASE_URL}${docsRoute}`,\n      related: seed.related ?? [],\n    };\n  },\n);\n\nexport const libraryDocs = {\n  packageName: \"erp-pro-ui\",\n  docsBaseUrl: DOCS_BASE_URL,\n  summary:\n    \"Reusable React UI library for ERP and SaaS applications with tree-shakeable subpath exports, shared styles, and first-party docs metadata.\",\n  features: [\n    \"50+ reusable UI components for forms, data display, overlays, charts, and visual effects.\",\n    \"Root and subpath imports so consumers can choose convenience or explicit package contracts.\",\n    \"Shared Tailwind v4 stylesheet with packaged fonts, tokens, and theme foundations.\",\n    \"Dedicated chart color slots and helpers so consuming apps can pick theme-backed series colors directly.\",\n    \"Portable docs metadata that can be consumed by other apps, CLIs, and MCP servers.\",\n  ],\n  installSteps: libraryInstallSteps,\n  peerDependencies: libraryPeerDependencies,\n  quickStartExamples: libraryQuickStartExamples,\n  components: componentDocs,\n} as const satisfies LibraryDocsBundle;\n\nexport function getComponentDocBySlug(\n  slug: UiCatalogSlug,\n): LibraryComponentDoc | undefined {\n  return componentDocs.find((component) => component.slug === slug);\n}\n\nexport function getComponentDocByName(\n  name: string,\n): LibraryComponentDoc | undefined {\n  const normalizedName = name.trim().toLowerCase();\n\n  return componentDocs.find((component) => {\n    if (component.name.toLowerCase() === normalizedName) {\n      return true;\n    }\n\n    if (component.slug === normalizedName) {\n      return true;\n    }\n\n    return component.aliases.some(\n      (alias) => alias.toLowerCase() === normalizedName,\n    );\n  });\n}\n\nexport function searchComponentDocs(query: string): LibraryComponentDoc[] {\n  const normalizedQuery = query.trim().toLowerCase();\n\n  if (!normalizedQuery) {\n    return [...componentDocs];\n  }\n\n  return componentDocs.filter((component) => {\n    const haystack = [\n      component.name,\n      component.slug,\n      component.category,\n      component.summary,\n      component.storybookTitle,\n      ...component.aliases,\n    ]\n      .join(\" \")\n      .toLowerCase();\n\n    return haystack.includes(normalizedQuery);\n  });\n}\n"],"mappings":"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CE,MAAM;EACN,QAAQ;EACT;CACD;EACE,MAAM;EACN,QAAQ;EACT;CACD;EACE,MAAM;EACN,QAAQ;EACT;CACD;EACE,MAAM;EACN,QAAQ;EACT;CACD;EACE,MAAM;EACN,QAAQ;EACT;CACF;AAED,IAAa,sBAAsB;CACjC;EACE,OAAO;EACP,aACE;EACF,UAAU,CACR;GACE,OAAO;GACP,UAAU;GACV,MAAM;GACP,CACF;EACF;CACD;EACE,OAAO;EACP,aACE;EACF,UAAU,CACR;GACE,OAAO;GACP,UAAU;GACV,MAAM;GACP,CACF;EACF;CACD;EACE,OAAO;EACP,aACE;EACF,UAAU,CACR;GACE,OAAO;GACP,UAAU;GACV,MAAM;GACP,CACF;EACF;CACD;EACE,OAAO;EACP,aACE;EACF,UAAU;GACR;IACE,OAAO;IACP,UAAU;IACV,MAAM;IACP;GACD;IACE,OAAO;IACP,UAAU;IACV,MAAM;IACP;GACD;IACE,OAAO;IACP,UAAU;IACV,MAAM;IACP;GACD;IACE,OAAO;IACP,UAAU;IACV,MAAM;IACN,aACE;IACH;GACF;EACF;CACD;EACE,OAAO;EACP,aACE;EACF,UAAU,CACR;GACE,OAAO;GACP,UAAU;GACV,MAAM;GACP,EACD;GACE,OAAO;GACP,UAAU;GACV,MAAM;GACP,CACF;EACF;CACD;EACE,OAAO;EACP,aACE;EACF,UAAU,CACR;GACE,OAAO;GACP,UAAU;GACV,MAAM;GACP,EACD;GACE,OAAO;GACP,UAAU;GACV,MAAM;GACP,CACF;EACF;CACF;AAED,IAAa,4BAA4B,CACvC;CACE,OAAO;CACP,UAAU;CACV,MAAM;CACP,EACD;CACE,OAAO;CACP,UAAU;CACV,MAAM;CACP,CACF;AAED,IAAa,gBAAgD,gBAAA,eAAe,KACzE,SAA8B;CAC7B,MAAM,OAAyB,kBAAkB,KAAK;CACtD,MAAM,YAAY,gBAAA,sBAAsB,KAAK,KAAK;CAClD,MAAM,aACJ,KAAK,eACJ,KAAK,aACF,qBAAqB,KAAK,WAAW,GACrC,eAAe,KAAK,KAAK,QAAQ,QAAQ,GAAG,CAAC;CACnD,MAAM,gBACJ,KAAK,kBACJ,KAAK,aACF,wBAAwB,KAAK,YAAY,KAAK,kBAAkB,GAChE,eAAe,KAAK,KAAK,QAAQ,QAAQ,GAAG,CAAC,oBAAoB,KAAK,kBAAkB;AAE9F,QAAO;EACL,MAAM,KAAK;EACX,MAAM,KAAK;EACX,QAAQ,YAAY,OAAO,KAAK,SAAS,KAAA;EACzC,UAAU,qBAAqB,KAAK,eAAe;EACnD,SAAS,KAAK;EACd,gBAAgB,KAAK;EACrB,mBAAmB,KAAK;EACxB,YAAY,KAAK;EACjB,SAAS,KAAK,WAAW,EAAE;EAC3B;EACA;EACA;EACA,SAAS,GAAG,gBAAgB;EAC5B,SAAS,KAAK,WAAW,EAAE;EAC5B;EAEJ;AAED,IAAa,cAAc;CACzB,aAAa;CACb,aAAa;CACb,SACE;CACF,UAAU;EACR;EACA;EACA;EACA;EACA;EACD;CACD,cAAc;CACd,kBAAkB;CAClB,oBAAoB;CACpB,YAAY;CACb;AAED,SAAgB,sBACd,MACiC;AACjC,QAAO,cAAc,MAAM,cAAc,UAAU,SAAS,KAAK;;AAGnE,SAAgB,sBACd,MACiC;CACjC,MAAM,iBAAiB,KAAK,MAAM,CAAC,aAAa;AAEhD,QAAO,cAAc,MAAM,cAAc;AACvC,MAAI,UAAU,KAAK,aAAa,KAAK,eACnC,QAAO;AAGT,MAAI,UAAU,SAAS,eACrB,QAAO;AAGT,SAAO,UAAU,QAAQ,MACtB,UAAU,MAAM,aAAa,KAAK,eACpC;GACD;;AAGJ,SAAgB,oBAAoB,OAAsC;CACxE,MAAM,kBAAkB,MAAM,MAAM,CAAC,aAAa;AAElD,KAAI,CAAC,gBACH,QAAO,CAAC,GAAG,cAAc;AAG3B,QAAO,cAAc,QAAQ,cAAc;AAYzC,SAXiB;GACf,UAAU;GACV,UAAU;GACV,UAAU;GACV,UAAU;GACV,UAAU;GACV,GAAG,UAAU;GACd,CACE,KAAK,IAAI,CACT,aAAa,CAEA,SAAS,gBAAgB;GACzC"}
+{"version":3,"file":"docs.cjs","names":[],"sources":["../src/docs.ts"],"sourcesContent":["import {\n  getUiCatalogDocsRoute,\n  type UiCatalogSlug,\n  type UiCatalogStatus,\n  uiCatalogItems,\n} from \"./catalog\";\n\nexport type LibraryDocsCodeLanguage = \"bash\" | \"css\" | \"json\" | \"tsx\";\n\nexport interface LibraryDocsCodeExample {\n  readonly title: string;\n  readonly language: LibraryDocsCodeLanguage;\n  readonly code: string;\n  readonly description?: string;\n}\n\nexport interface LibraryDocsInstallStep {\n  readonly title: string;\n  readonly description: string;\n  readonly examples?: readonly LibraryDocsCodeExample[];\n}\n\nexport interface LibraryDocsPeerDependency {\n  readonly name: string;\n  readonly reason: string;\n}\n\nexport interface LibraryComponentDoc {\n  readonly name: string;\n  readonly slug: UiCatalogSlug;\n  readonly status?: UiCatalogStatus;\n  readonly category: string;\n  readonly summary: string;\n  readonly storybookTitle: string;\n  readonly packageExportPath: string;\n  readonly exportName?: string;\n  readonly aliases: readonly string[];\n  readonly rootImport: string;\n  readonly subpathImport: string;\n  readonly docsRoute: string;\n  readonly docsUrl: string;\n  readonly related: readonly UiCatalogSlug[];\n}\n\nexport interface LibraryDocsBundle {\n  readonly packageName: \"erp-pro-ui\";\n  readonly docsBaseUrl: string;\n  readonly summary: string;\n  readonly features: readonly string[];\n  readonly installSteps: readonly LibraryDocsInstallStep[];\n  readonly peerDependencies: readonly LibraryDocsPeerDependency[];\n  readonly quickStartExamples: readonly LibraryDocsCodeExample[];\n  readonly components: readonly LibraryComponentDoc[];\n}\n\ninterface ComponentDocSeed {\n  readonly exportName?: string;\n  readonly summary: string;\n  readonly aliases?: readonly string[];\n  readonly related?: readonly UiCatalogSlug[];\n  readonly rootImport?: string;\n  readonly subpathImport?: string;\n}\n\nconst DOCS_BASE_URL = \"https://daniel-heydari-dev.github.io/erp-pro-ui\";\n\nconst componentDocSeeds = {\n  combobox: {\n    exportName: \"Combobox\",\n    summary:\n      \"Searchable single-select control for long option lists and command-style pickers.\",\n    aliases: [\"autocomplete\", \"search select\"],\n    related: [\"select\", \"multiselect-combobox\", \"input\"],\n    rootImport: \"import { Combobox, type ComboboxOption } from 'erp-pro-ui';\",\n    subpathImport:\n      \"import { Combobox, type ComboboxOption } from 'erp-pro-ui/combobox';\",\n  },\n  button: {\n    exportName: \"Button\",\n    summary:\n      \"Primary action trigger with size variants, button attributes, and support for custom children.\",\n    aliases: [\"cta\", \"action\"],\n    related: [\"dialog\", \"form\", \"input\"],\n  },\n  input: {\n    exportName: \"Input\",\n    summary:\n      \"Text field for forms with label, validation state, helper text, and icon support.\",\n    aliases: [\"text field\", \"field\"],\n    related: [\"label\", \"textarea\", \"form\"],\n  },\n  checkbox: {\n    exportName: \"Checkbox\",\n    summary:\n      \"Binary selection control for filters, permissions, and multi-select form fields.\",\n    aliases: [\"boolean\"],\n    related: [\"radio\", \"switch\", \"form\"],\n  },\n  radio: {\n    exportName: \"Radio\",\n    summary:\n      \"Single-choice selection control for mutually exclusive form options.\",\n    aliases: [\"radio group\"],\n    related: [\"checkbox\", \"select\", \"form\"],\n  },\n  switch: {\n    exportName: \"Switch\",\n    summary:\n      \"Immediate on/off toggle suited to settings panels and preference screens.\",\n    aliases: [\"toggle\"],\n    related: [\"checkbox\", \"sun-to-moon-button\", \"form\"],\n  },\n  select: {\n    exportName: \"Select\",\n    summary: \"Compact dropdown input for short, fixed option sets.\",\n    aliases: [\"dropdown\"],\n    related: [\"combobox\", \"multiselect-combobox\", \"form\"],\n  },\n  textarea: {\n    exportName: \"Textarea\",\n    summary:\n      \"Multi-line text input for descriptions, notes, and longer form responses.\",\n    aliases: [\"multiline input\"],\n    related: [\"input\", \"label\", \"form\"],\n  },\n  label: {\n    exportName: \"Label\",\n    summary:\n      \"Accessible form label primitive for pairing readable text with inputs and controls.\",\n    aliases: [\"field label\"],\n    related: [\"input\", \"textarea\", \"form\"],\n  },\n  dialog: {\n    exportName: \"Dialog\",\n    summary:\n      \"Portal-backed modal overlay for confirmations, destructive flows, and custom embedded forms that must sit above the full application shell.\",\n    aliases: [\"modal\"],\n    related: [\"drawer\", \"button\", \"toast\"],\n    rootImport:\n      \"import { Dialog, type DialogAnimation, type DialogVariant } from 'erp-pro-ui';\",\n    subpathImport:\n      \"import { Dialog, type DialogAnimation, type DialogVariant } from 'erp-pro-ui/dialog';\",\n  },\n  drawer: {\n    exportName: \"Drawer\",\n    summary:\n      \"Slide-in panel for secondary workflows, detail panes, and mobile task flows.\",\n    aliases: [\"sheet\", \"side panel\"],\n    related: [\"dialog\", \"card\", \"tooltip\"],\n    rootImport: \"import { Drawer, type DrawerPosition } from 'erp-pro-ui';\",\n    subpathImport:\n      \"import { Drawer, type DrawerPosition } from 'erp-pro-ui/drawer';\",\n  },\n  alert: {\n    exportName: \"Alert\",\n    summary:\n      \"Inline status banner with semantic variants for success, warning, info, and destructive states.\",\n    aliases: [\"message banner\"],\n    related: [\"toast\", \"loading\", \"skeleton\"],\n    rootImport: \"import { Alert, type AlertVariant } from 'erp-pro-ui';\",\n    subpathImport:\n      \"import { Alert, type AlertVariant } from 'erp-pro-ui/alert';\",\n  },\n  toast: {\n    exportName: \"ToastProvider\",\n    summary:\n      \"Transient notification system exposed through ToastProvider and useToast for async feedback.\",\n    aliases: [\"notification\"],\n    related: [\"alert\", \"dialog\", \"loading\"],\n    rootImport:\n      \"import { ToastProvider, useToast, type ToastPosition } from 'erp-pro-ui';\",\n    subpathImport:\n      \"import { ToastProvider, useToast, type ToastPosition } from 'erp-pro-ui/toast';\",\n  },\n  tooltip: {\n    exportName: \"Tooltip\",\n    summary:\n      \"Hover and focus overlay for concise contextual help without leaving the current view.\",\n    aliases: [\"hint\"],\n    related: [\"hover-card\", \"dialog\", \"drawer\"],\n    rootImport:\n      \"import { Tooltip, type TooltipPosition, type TooltipTrigger } from 'erp-pro-ui';\",\n    subpathImport:\n      \"import { Tooltip, type TooltipPosition, type TooltipTrigger } from 'erp-pro-ui/tooltip';\",\n  },\n  accordion: {\n    exportName: \"Accordion\",\n    summary:\n      \"Expandable content container for FAQs, settings groups, and disclosure-heavy interfaces.\",\n    aliases: [\"collapse\"],\n    related: [\"card\", \"stepper\", \"tooltip\"],\n  },\n  card: {\n    exportName: \"Card\",\n    summary:\n      \"Surface container for grouping content, actions, and stats in dashboards and forms.\",\n    aliases: [\"panel\"],\n    related: [\"accordion\", \"spotlight-card\", \"data-table\"],\n  },\n  stepper: {\n    exportName: \"Stepper\",\n    summary:\n      \"Centered workflow progress indicator with stacked or inline labels, plus related connected-step and wizard exports for denser or pane-based flows.\",\n    aliases: [\"wizard steps\", \"workflow progress\", \"inline stepper\"],\n    related: [\"form\", \"chip\", \"loading\"],\n    rootImport:\n      \"import { Stepper, StepperSteps, StepperWizard, StepperWizardStep, type Step, type StepperLabelPosition, type StepperStepsItem, type StepperStepsState } from 'erp-pro-ui';\",\n    subpathImport:\n      \"import { Stepper, StepperSteps, StepperWizard, StepperWizardStep, type Step, type StepperLabelPosition, type StepperStepsItem, type StepperStepsState } from 'erp-pro-ui/stepper';\",\n  },\n  chip: {\n    exportName: \"Chip\",\n    summary:\n      \"Compact status and taxonomy token with visual variants for tags, states, and filters.\",\n    aliases: [\"tag\", \"badge\"],\n    related: [\"alert\", \"color-palette\", \"stepper\"],\n  },\n  \"progress-bar\": {\n    exportName: \"ProgressBar\",\n    summary:\n      \"Linear progress indicator for completion ratios, quotas, and compact operational status rows.\",\n    aliases: [\"progress\", \"meter\", \"completion bar\"],\n    related: [\"chip\", \"loading\", \"stepper\"],\n  },\n  calendar: {\n    exportName: \"Calendar\",\n    summary:\n      \"Calendar view for scheduling surfaces, date picking UIs, and embedded planners.\",\n    aliases: [\"date calendar\"],\n    related: [\"datepicker\", \"input\", \"form\"],\n  },\n  datepicker: {\n    exportName: \"DatePicker\",\n    summary:\n      \"Calendar-backed date input for forms that need controlled value selection and display.\",\n    aliases: [\"date picker\"],\n    related: [\"calendar\", \"input\", \"form\"],\n  },\n  \"multiselect-combobox\": {\n    exportName: \"MultiSelectCombobox\",\n    summary:\n      \"Searchable multi-value selector for filters, assignee pickers, and label assignment flows.\",\n    aliases: [\"multi select\", \"token select\"],\n    related: [\"combobox\", \"select\", \"chip\"],\n  },\n  \"hover-card\": {\n    exportName: \"HoverCard\",\n    summary:\n      \"Rich hover preview surface for profile cards, metadata popovers, and secondary details.\",\n    aliases: [\"preview card\"],\n    related: [\"tooltip\", \"card\", \"dialog\"],\n  },\n  \"spotlight-card\": {\n    exportName: \"SpotlightCard\",\n    summary:\n      \"Interactive card with a cursor-reactive spotlight effect for premium landing sections.\",\n    aliases: [\"interactive card\"],\n    related: [\"card\", \"hover-border-gradient\", \"background-gradient\"],\n  },\n  \"splash-cursor\": {\n    exportName: \"SplashCursor\",\n    summary:\n      \"Pointer effect that adds an animated splash trail for immersive visual experiences.\",\n    aliases: [\"cursor effect\"],\n    related: [\"chroma-grid\", \"animated-content\", \"spotlight-card\"],\n  },\n  \"chroma-grid\": {\n    exportName: \"ChromaGrid\",\n    summary:\n      \"Animated chromatic grid background for showcase sections, heroes, and immersive canvases.\",\n    aliases: [\"grid effect\"],\n    related: [\"background-gradient\", \"splash-cursor\", \"gradual-blur\"],\n  },\n  \"color-palette\": {\n    exportName: \"ColorPalette\",\n    summary:\n      \"Palette viewer for design tokens, brand colors, and handoff documentation.\",\n    aliases: [\"swatches\"],\n    related: [\"chip\", \"typography\", \"icons\"],\n  },\n  \"gradual-blur\": {\n    exportName: \"GradualBlur\",\n    summary:\n      \"Progressive blur reveal wrapper for staged entrances and atmospheric transitions.\",\n    aliases: [\"blur reveal\"],\n    related: [\"animated-content\", \"background-gradient\", \"chroma-grid\"],\n  },\n  \"animated-content\": {\n    exportName: \"AnimatedContent\",\n    summary:\n      \"Scroll and reveal motion wrapper for staging content entrances without custom animation plumbing.\",\n    aliases: [\"reveal animation\"],\n    related: [\"gradual-blur\", \"spotlight-card\", \"splash-cursor\"],\n  },\n  \"background-gradient\": {\n    exportName: \"BackgroundGradientAnimation\",\n    summary:\n      \"Animated multi-stop gradient backdrop for hero sections and premium product storytelling.\",\n    aliases: [\"gradient background\"],\n    related: [\"chroma-grid\", \"gradual-blur\", \"spotlight-card\"],\n  },\n  \"hover-border-gradient\": {\n    exportName: \"HoverBorderGradient\",\n    summary:\n      \"Gradient-border wrapper that emphasizes cards and feature callouts on hover.\",\n    aliases: [\"gradient border\"],\n    related: [\"button-hover-border-gradient\", \"card\", \"spotlight-card\"],\n  },\n  \"button-hover-border-gradient\": {\n    exportName: \"ButtonHoverBorderGradient\",\n    summary:\n      \"CTA button variant with animated gradient edge treatment for high-emphasis surfaces.\",\n    aliases: [\"gradient button\"],\n    related: [\"button\", \"hover-border-gradient\", \"background-gradient\"],\n  },\n  \"password-strength-meter\": {\n    exportName: \"PasswordStrengthMeter\",\n    summary:\n      \"Password quality indicator for sign-up and reset forms that need immediate feedback.\",\n    aliases: [\"password meter\"],\n    related: [\"input\", \"form\", \"alert\"],\n  },\n  \"sun-to-moon-button\": {\n    exportName: \"SunToMoonButton\",\n    summary:\n      \"Animated theme toggle control for switching between light and dark presentation modes.\",\n    aliases: [\"theme toggle\"],\n    related: [\"switch\", \"typography\", \"background-gradient\"],\n  },\n  carousel: {\n    exportName: \"Carousel\",\n    summary:\n      \"Content slider for galleries, testimonials, walkthroughs, and promotional sequences.\",\n    aliases: [\"slider\"],\n    related: [\"card\", \"animated-content\", \"spotlight-card\"],\n  },\n  otpinput: {\n    exportName: \"OTPInput\",\n    summary:\n      \"One-time passcode input optimized for verification flows, MFA, and access codes.\",\n    aliases: [\"otp\", \"verification code\"],\n    related: [\"input\", \"password-strength-meter\", \"form\"],\n  },\n  form: {\n    exportName: \"Form\",\n    summary:\n      \"Form composition surface for validation-driven layouts and grouped input sections.\",\n    aliases: [\"form wrapper\"],\n    related: [\"input\", \"button\", \"stepper\"],\n    rootImport:\n      \"import { Form, FormActions, FormField, FormSection, InputGroup } from 'erp-pro-ui';\",\n    subpathImport:\n      \"import { Form, FormActions, FormField, FormSection, InputGroup } from 'erp-pro-ui/form';\",\n  },\n  \"data-table\": {\n    exportName: \"DataTable\",\n    summary:\n      \"Feature-rich data grid with filtering, column toggles, pagination, RTL-aware interactions, plus composable table primitives and style slots for external customization.\",\n    aliases: [\"table\", \"grid\"],\n    related: [\"loading\", \"skeleton\", \"chip\"],\n    rootImport:\n      \"import { DataTable, Table, TableHeader, TableHead, TableBody, TableRow, TableCell, TableFooter, TableCaption, TableContainer } from 'erp-pro-ui';\",\n    subpathImport:\n      \"import { DataTable, Table, TableHeader, TableHead, TableBody, TableRow, TableCell, TableFooter, TableCaption, TableContainer } from 'erp-pro-ui/data-table';\",\n  },\n  loading: {\n    exportName: \"Loading\",\n    summary:\n      \"Unified loading surface exposing spinner, dots, pulse, bars, ring, bounce, wave, and skeleton variants.\",\n    aliases: [\"loader\", \"progress indicator\"],\n    related: [\"skeleton\", \"alert\", \"data-table\"],\n    rootImport:\n      \"import { Loading, Spinner, Dots, Pulse, Bars, Ring, Bounce, Wave, type LoadingSize, type LoadingVariant } from 'erp-pro-ui';\",\n    subpathImport:\n      \"import { Loading, Spinner, Dots, Pulse, Bars, Ring, Bounce, Wave, type LoadingSize, type LoadingVariant } from 'erp-pro-ui/loading';\",\n  },\n  skeleton: {\n    exportName: \"SkeletonComponent\",\n    summary:\n      \"Theme-aware placeholder system with semantic tones, speed control, light/dark mode support, and ready-made metric, card, list, and table presets.\",\n    aliases: [\"placeholder\"],\n    related: [\"loading\", \"data-table\", \"card\"],\n    rootImport: \"import { SkeletonComponent } from 'erp-pro-ui';\",\n    subpathImport:\n      \"import { Skeleton as SkeletonComponent, SkeletonMetricCard } from 'erp-pro-ui/skeleton';\",\n  },\n  \"area-chart\": {\n    exportName: \"AreaChart\",\n    summary:\n      \"Gradient-filled area chart for trend storytelling and cumulative time-series views.\",\n    aliases: [\"trend chart\"],\n    related: [\"bar-chart\", \"neon-line-chart\", \"stacked-bar-chart\"],\n    rootImport: \"import { AreaChart, type AreaChartData } from 'erp-pro-ui';\",\n    subpathImport:\n      \"import { AreaChart, type AreaChartData } from 'erp-pro-ui/area-chart';\",\n  },\n  \"bar-chart\": {\n    exportName: \"BarChart\",\n    summary:\n      \"Bar chart for comparisons across categories, teams, or time buckets.\",\n    aliases: [\"column chart\"],\n    related: [\"area-chart\", \"stacked-bar-chart\", \"thin-breakdown-bar\"],\n    rootImport: \"import { BarChart, type BarChartData } from 'erp-pro-ui';\",\n    subpathImport:\n      \"import { BarChart, type BarChartData } from 'erp-pro-ui/bar-chart';\",\n  },\n  \"positive-negative-bar-chart\": {\n    exportName: \"PositiveNegativeBarChart\",\n    summary:\n      \"Signed bar chart for profit-loss swings, variance reporting, and delta views that pivot around zero.\",\n    aliases: [\"variance chart\", \"profit loss chart\"],\n    related: [\"bar-chart\", \"stacked-bar-chart\", \"area-chart\"],\n    rootImport:\n      \"import { PositiveNegativeBarChart, type PositiveNegativeBarChartData } from 'erp-pro-ui';\",\n    subpathImport:\n      \"import { PositiveNegativeBarChart, type PositiveNegativeBarChartData } from 'erp-pro-ui/positive-negative-bar-chart';\",\n  },\n  \"pie-chart\": {\n    exportName: \"PieChart\",\n    summary:\n      \"Pie and donut chart visualizations for part-to-whole comparisons with small category sets.\",\n    aliases: [\"donut chart\"],\n    related: [\"bar-chart\", \"thin-breakdown-bar\", \"color-palette\"],\n    rootImport: \"import { PieChart, type PieChartData } from 'erp-pro-ui';\",\n    subpathImport:\n      \"import { PieChart, type PieChartData } from 'erp-pro-ui/pie-chart';\",\n  },\n  \"neon-line-chart\": {\n    exportName: \"NeonLineChart\",\n    summary:\n      \"High-emphasis glowing line chart for dashboards that need a more stylized analytical treatment.\",\n    aliases: [\"line chart\"],\n    related: [\"area-chart\", \"bar-chart\", \"stacked-bar-chart\"],\n  },\n  \"stacked-bar-chart\": {\n    exportName: \"StackedBarChart\",\n    summary:\n      \"Stacked categorical chart for comparing totals and composition inside each bar.\",\n    aliases: [\"stacked chart\"],\n    related: [\"bar-chart\", \"thin-breakdown-bar\", \"area-chart\"],\n    rootImport:\n      \"import { StackedBarChart, type StackedBarData } from 'erp-pro-ui';\",\n    subpathImport:\n      \"import { StackedBarChart, type StackedBarData } from 'erp-pro-ui/stacked-bar-chart';\",\n  },\n  \"thin-breakdown-bar\": {\n    exportName: \"ThinBreakdownBar\",\n    summary:\n      \"Compact horizontal breakdown bar for inline composition summaries and KPI cards.\",\n    aliases: [\"breakdown bar\"],\n    related: [\"stacked-bar-chart\", \"pie-chart\", \"chip\"],\n    rootImport:\n      \"import { ThinBreakdownBar, type BreakdownSegment } from 'erp-pro-ui';\",\n    subpathImport:\n      \"import { ThinBreakdownBar, type BreakdownSegment } from 'erp-pro-ui/thin-breakdown-bar';\",\n  },\n  icons: {\n    summary:\n      \"Collection of custom SVG icons for dashboards, navigation, commerce, and status-heavy product UIs.\",\n    aliases: [\"icon pack\", \"svg icons\"],\n    related: [\"typography\", \"color-palette\", \"button\"],\n    rootImport:\n      \"import { IconDashboard, IconSettings, IconUser } from 'erp-pro-ui';\",\n    subpathImport:\n      \"import { IconDashboard, IconSettings, IconUser } from 'erp-pro-ui/icons';\",\n  },\n  typography: {\n    exportName: \"Typography\",\n    summary:\n      \"Semantic text component with heading, body, caption, alignment, weight, and gradient options.\",\n    aliases: [\"text\"],\n    related: [\"color-palette\", \"icons\", \"button\"],\n  },\n  \"truncated-text\": {\n    exportName: \"TruncatedText\",\n    summary:\n      \"Reusable text primitive for single-line and multi-line ellipsis with width constraints and optional hover title support.\",\n    aliases: [\"line clamp\", \"ellipsis\", \"truncate\"],\n    related: [\"typography\", \"chip\", \"input\"],\n    rootImport:\n      \"import { TruncatedText, type TruncatedTextProps } from 'erp-pro-ui';\",\n    subpathImport:\n      \"import { TruncatedText, type TruncatedTextProps } from 'erp-pro-ui/truncated-text';\",\n  },\n} as const satisfies Record<UiCatalogSlug, ComponentDocSeed>;\n\nfunction getComponentCategory(storybookTitle: string): string {\n  return storybookTitle.split(\"/\")[0] ?? \"Components\";\n}\n\nfunction getDefaultRootImport(exportName: string): string {\n  return `import { ${exportName} } from 'erp-pro-ui';`;\n}\n\nfunction getDefaultSubpathImport(\n  exportName: string,\n  packageExportPath: string,\n): string {\n  return `import { ${exportName} } from 'erp-pro-ui/${packageExportPath}';`;\n}\n\nexport const libraryPeerDependencies = [\n  {\n    name: \"framer-motion\",\n    reason: \"Required by motion-heavy overlays and effects.\",\n  },\n  {\n    name: \"three\",\n    reason: \"Required for Three.js-based visual components.\",\n  },\n  {\n    name: \"@react-three/fiber\",\n    reason: \"React renderer used by 3D visual surfaces.\",\n  },\n  {\n    name: \"@react-three/drei\",\n    reason: \"Helper primitives used by 3D components.\",\n  },\n  {\n    name: \"@tanstack/react-table\",\n    reason: \"Required for DataTable filtering and column tooling.\",\n  },\n  {\n    name: \"recharts\",\n    reason: \"Required for chart components.\",\n  },\n  {\n    name: \"lucide-react\",\n    reason: \"Used by selected UI controls and docs examples.\",\n  },\n] as const satisfies readonly LibraryDocsPeerDependency[];\n\nexport const libraryInstallSteps = [\n  {\n    title: \"Install the package\",\n    description:\n      \"Add erp-pro-ui to your React application with your preferred package manager.\",\n    examples: [\n      {\n        title: \"pnpm\",\n        language: \"bash\",\n        code: \"pnpm add erp-pro-ui\",\n      },\n    ],\n  },\n  {\n    title: \"Install peer dependencies\",\n    description:\n      \"Install only the optional peer packages used by motion, tables, and 3D visuals you actually render.\",\n    examples: [\n      {\n        title: \"Peers\",\n        language: \"bash\",\n        code: \"pnpm add framer-motion three @tanstack/react-table\",\n      },\n    ],\n  },\n  {\n    title: \"Import the shared styles\",\n    description:\n      \"Import Tailwind first, then the library stylesheet once at the app entry to load tokens, fonts, foundations, and semantic utilities with no extra Tailwind config.\",\n    examples: [\n      {\n        title: \"Root stylesheet\",\n        language: \"css\",\n        code: '@import \"tailwindcss\";\\n@import \"erp-pro-ui/styles.css\";',\n      },\n    ],\n  },\n  {\n    title: \"Use colors and fonts directly\",\n    description:\n      \"Import tokens.css for raw CSS variables without Tailwind utilities, or colors.css when you want the Tailwind v4 utility bridge generated from shared semantic tokens. Use DS-prefixed semantic utilities and --ds-* tokens for all new code.\",\n    examples: [\n      {\n        title: \"Raw token import\",\n        language: \"css\",\n        code: '@import \"erp-pro-ui/tokens.css\";',\n      },\n      {\n        title: \"Tailwind bridge import\",\n        language: \"css\",\n        code: '@import \"tailwindcss\";\\n@import \"erp-pro-ui/colors.css\";\\n@import \"erp-pro-ui/fonts.css\";',\n      },\n      {\n        title: \"Theme token usage\",\n        language: \"tsx\",\n        code: 'import { Button } from \"erp-pro-ui\";\\n\\n<section className=\"bg-ds-surface-1 text-ds-1 border border-ds-border-2 rounded-2xl p-6\">\\n  <Button label=\"Save\" primary />\\n</section>',\n      },\n      {\n        title: \"Chart token usage\",\n        language: \"tsx\",\n        code: 'import { AreaChart, getChartColorVar } from \"erp-pro-ui\";\\n\\n<AreaChart\\n  data={data}\\n  categories={[\\n    { key: \"revenue\", color: getChartColorVar(1) },\\n    { key: \"cost\", color: \"chart-6\" },\\n    { key: \"forecast\", color: \"var(--ds-chart-10)\" },\\n  ]}\\n/>',\n        description:\n          \"Chart components accept raw CSS colors, theme chart variables, or the built-in chart token helper. The shared token surface includes chart slots 1 through 15.\",\n      },\n    ],\n  },\n  {\n    title: \"Wrap your app with ThemeProvider\",\n    description:\n      \"Use ThemeProvider at the root so brand, mode, and variant attributes are applied as data-brand, data-mode, and data-variant for the token system. The older data-dark-variant and data-theme attributes are still written for compatibility during migration.\",\n    examples: [\n      {\n        title: \"Root provider\",\n        language: \"tsx\",\n        code: \"import { ThemeProvider } from 'erp-pro-ui';\\n\\ncreateRoot(rootElement).render(\\n  <ThemeProvider>\\n    <App />\\n  </ThemeProvider>,\\n);\",\n      },\n      {\n        title: \"Manual attributes\",\n        language: \"tsx\",\n        code: '<html data-brand=\"teal\" data-mode=\"light\" data-variant=\"alt\"></html>',\n      },\n    ],\n  },\n  {\n    title: \"Choose an import strategy\",\n    description:\n      \"Use root imports for convenience or subpath imports for a more explicit public contract per component.\",\n    examples: [\n      {\n        title: \"Root imports\",\n        language: \"tsx\",\n        code: \"import { Button, Dialog, Input } from 'erp-pro-ui';\",\n      },\n      {\n        title: \"Subpath imports\",\n        language: \"tsx\",\n        code: \"import { Button } from 'erp-pro-ui/button';\\nimport { Dialog } from 'erp-pro-ui/dialog';\",\n      },\n    ],\n  },\n] as const satisfies readonly LibraryDocsInstallStep[];\n\nexport const libraryQuickStartExamples = [\n  {\n    title: \"Basic screen scaffold\",\n    language: \"tsx\",\n    code: 'import { Button, Input, ThemeProvider, Typography } from \\'erp-pro-ui\\';\\n\\nexport function App() {\\n  return (\\n    <ThemeProvider>\\n      <section className=\"space-y-4 p-6\">\\n        <Typography variant=\"h2\" gradient=\"ocean\">\\n          Welcome to ERP Pro\\n        </Typography>\\n        <Input label=\"Email\" placeholder=\"you@company.com\" />\\n        <Button label=\"Get Started\" primary />\\n      </section>\\n    </ThemeProvider>\\n  );\\n}',\n  },\n  {\n    title: \"Dialog confirmation pattern\",\n    language: \"tsx\",\n    code: 'import { Dialog } from \\'erp-pro-ui\\';\\n\\n<Dialog\\n  open={isOpen}\\n  onOpenChange={setIsOpen}\\n  title=\"Confirm delete\"\\n  description=\"This action cannot be undone.\"\\n  variant=\"destructive\"\\n  preset=\"confirm\"\\n  animation=\"scale\"\\n  onConfirm={handleDelete}\\n/>;',\n  },\n] as const satisfies readonly LibraryDocsCodeExample[];\n\nexport const componentDocs: readonly LibraryComponentDoc[] = uiCatalogItems.map(\n  (item): LibraryComponentDoc => {\n    const seed: ComponentDocSeed = componentDocSeeds[item.slug];\n    const docsRoute = getUiCatalogDocsRoute(item.slug);\n    const rootImport =\n      seed.rootImport ??\n      (seed.exportName\n        ? getDefaultRootImport(seed.exportName)\n        : `import * as ${item.name.replace(/\\s+/g, \"\")} from 'erp-pro-ui';`);\n    const subpathImport =\n      seed.subpathImport ??\n      (seed.exportName\n        ? getDefaultSubpathImport(seed.exportName, item.packageExportPath)\n        : `import * as ${item.name.replace(/\\s+/g, \"\")} from 'erp-pro-ui/${item.packageExportPath}';`);\n\n    return {\n      name: item.name,\n      slug: item.slug,\n      status: \"status\" in item ? item.status : undefined,\n      category: getComponentCategory(item.storybookTitle),\n      summary: seed.summary,\n      storybookTitle: item.storybookTitle,\n      packageExportPath: item.packageExportPath,\n      exportName: seed.exportName,\n      aliases: seed.aliases ?? [],\n      rootImport,\n      subpathImport,\n      docsRoute,\n      docsUrl: `${DOCS_BASE_URL}${docsRoute}`,\n      related: seed.related ?? [],\n    };\n  },\n);\n\nexport const libraryDocs = {\n  packageName: \"erp-pro-ui\",\n  docsBaseUrl: DOCS_BASE_URL,\n  summary:\n    \"Reusable React UI library for ERP and SaaS applications with tree-shakeable subpath exports, shared styles, and first-party docs metadata.\",\n  features: [\n    \"50+ reusable UI components for forms, data display, overlays, charts, and visual effects.\",\n    \"Root and subpath imports so consumers can choose convenience or explicit package contracts.\",\n    \"Shared Tailwind v4 stylesheet with packaged fonts, tokens, and theme foundations.\",\n    \"Dedicated chart color slots and helpers so consuming apps can pick theme-backed series colors directly.\",\n    \"Portable docs metadata that can be consumed by other apps, CLIs, and MCP servers.\",\n  ],\n  installSteps: libraryInstallSteps,\n  peerDependencies: libraryPeerDependencies,\n  quickStartExamples: libraryQuickStartExamples,\n  components: componentDocs,\n} as const satisfies LibraryDocsBundle;\n\nexport function getComponentDocBySlug(\n  slug: UiCatalogSlug,\n): LibraryComponentDoc | undefined {\n  return componentDocs.find((component) => component.slug === slug);\n}\n\nexport function getComponentDocByName(\n  name: string,\n): LibraryComponentDoc | undefined {\n  const normalizedName = name.trim().toLowerCase();\n\n  return componentDocs.find((component) => {\n    if (component.name.toLowerCase() === normalizedName) {\n      return true;\n    }\n\n    if (component.slug === normalizedName) {\n      return true;\n    }\n\n    return component.aliases.some(\n      (alias) => alias.toLowerCase() === normalizedName,\n    );\n  });\n}\n\nexport function searchComponentDocs(query: string): LibraryComponentDoc[] {\n  const normalizedQuery = query.trim().toLowerCase();\n\n  if (!normalizedQuery) {\n    return [...componentDocs];\n  }\n\n  return componentDocs.filter((component) => {\n    const haystack = [\n      component.name,\n      component.slug,\n      component.category,\n      component.summary,\n      component.storybookTitle,\n      ...component.aliases,\n    ]\n      .join(\" \")\n      .toLowerCase();\n\n    return haystack.includes(normalizedQuery);\n  });\n}\n"],"mappings":"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AAS,CAAC,OAAO;EACjB,SAAS;GAAC;GAAiB;GAAS;GAAS;EAC9C;CACD,kBAAkB;EAChB,YAAY;EACZ,SACE;EACF,SAAS;GAAC;GAAc;GAAY;GAAW;EAC/C,SAAS;GAAC;GAAc;GAAQ;GAAQ;EACxC,YACE;EACF,eACE;EACH;CACF;AAED,SAAS,qBAAqB,gBAAgC;AAC5D,QAAO,eAAe,MAAM,IAAI,CAAC,MAAM;;AAGzC,SAAS,qBAAqB,YAA4B;AACxD,QAAO,YAAY,WAAW;;AAGhC,SAAS,wBACP,YACA,mBACQ;AACR,QAAO,YAAY,WAAW,sBAAsB,kBAAkB;;AAGxE,IAAa,0BAA0B;CACrC;EACE,MAAM;EACN,QAAQ;EACT;CACD;EACE,MAAM;EACN,QAAQ;EACT;CACD;EACE,MAAM;EACN,QAAQ;EACT;CACD;EACE,MAAM;EACN,QAAQ;EACT;CACD;EACE,MAAM;EACN,QAAQ;EACT;CACD;EACE,MAAM;EACN,QAAQ;EACT;CACD;EACE,MAAM;EACN,QAAQ;EACT;CACF;AAED,IAAa,sBAAsB;CACjC;EACE,OAAO;EACP,aACE;EACF,UAAU,CACR;GACE,OAAO;GACP,UAAU;GACV,MAAM;GACP,CACF;EACF;CACD;EACE,OAAO;EACP,aACE;EACF,UAAU,CACR;GACE,OAAO;GACP,UAAU;GACV,MAAM;GACP,CACF;EACF;CACD;EACE,OAAO;EACP,aACE;EACF,UAAU,CACR;GACE,OAAO;GACP,UAAU;GACV,MAAM;GACP,CACF;EACF;CACD;EACE,OAAO;EACP,aACE;EACF,UAAU;GACR;IACE,OAAO;IACP,UAAU;IACV,MAAM;IACP;GACD;IACE,OAAO;IACP,UAAU;IACV,MAAM;IACP;GACD;IACE,OAAO;IACP,UAAU;IACV,MAAM;IACP;GACD;IACE,OAAO;IACP,UAAU;IACV,MAAM;IACN,aACE;IACH;GACF;EACF;CACD;EACE,OAAO;EACP,aACE;EACF,UAAU,CACR;GACE,OAAO;GACP,UAAU;GACV,MAAM;GACP,EACD;GACE,OAAO;GACP,UAAU;GACV,MAAM;GACP,CACF;EACF;CACD;EACE,OAAO;EACP,aACE;EACF,UAAU,CACR;GACE,OAAO;GACP,UAAU;GACV,MAAM;GACP,EACD;GACE,OAAO;GACP,UAAU;GACV,MAAM;GACP,CACF;EACF;CACF;AAED,IAAa,4BAA4B,CACvC;CACE,OAAO;CACP,UAAU;CACV,MAAM;CACP,EACD;CACE,OAAO;CACP,UAAU;CACV,MAAM;CACP,CACF;AAED,IAAa,gBAAgD,gBAAA,eAAe,KACzE,SAA8B;CAC7B,MAAM,OAAyB,kBAAkB,KAAK;CACtD,MAAM,YAAY,gBAAA,sBAAsB,KAAK,KAAK;CAClD,MAAM,aACJ,KAAK,eACJ,KAAK,aACF,qBAAqB,KAAK,WAAW,GACrC,eAAe,KAAK,KAAK,QAAQ,QAAQ,GAAG,CAAC;CACnD,MAAM,gBACJ,KAAK,kBACJ,KAAK,aACF,wBAAwB,KAAK,YAAY,KAAK,kBAAkB,GAChE,eAAe,KAAK,KAAK,QAAQ,QAAQ,GAAG,CAAC,oBAAoB,KAAK,kBAAkB;AAE9F,QAAO;EACL,MAAM,KAAK;EACX,MAAM,KAAK;EACX,QAAQ,YAAY,OAAO,KAAK,SAAS,KAAA;EACzC,UAAU,qBAAqB,KAAK,eAAe;EACnD,SAAS,KAAK;EACd,gBAAgB,KAAK;EACrB,mBAAmB,KAAK;EACxB,YAAY,KAAK;EACjB,SAAS,KAAK,WAAW,EAAE;EAC3B;EACA;EACA;EACA,SAAS,GAAG,gBAAgB;EAC5B,SAAS,KAAK,WAAW,EAAE;EAC5B;EAEJ;AAED,IAAa,cAAc;CACzB,aAAa;CACb,aAAa;CACb,SACE;CACF,UAAU;EACR;EACA;EACA;EACA;EACA;EACD;CACD,cAAc;CACd,kBAAkB;CAClB,oBAAoB;CACpB,YAAY;CACb;AAED,SAAgB,sBACd,MACiC;AACjC,QAAO,cAAc,MAAM,cAAc,UAAU,SAAS,KAAK;;AAGnE,SAAgB,sBACd,MACiC;CACjC,MAAM,iBAAiB,KAAK,MAAM,CAAC,aAAa;AAEhD,QAAO,cAAc,MAAM,cAAc;AACvC,MAAI,UAAU,KAAK,aAAa,KAAK,eACnC,QAAO;AAGT,MAAI,UAAU,SAAS,eACrB,QAAO;AAGT,SAAO,UAAU,QAAQ,MACtB,UAAU,MAAM,aAAa,KAAK,eACpC;GACD;;AAGJ,SAAgB,oBAAoB,OAAsC;CACxE,MAAM,kBAAkB,MAAM,MAAM,CAAC,aAAa;AAElD,KAAI,CAAC,gBACH,QAAO,CAAC,GAAG,cAAc;AAG3B,QAAO,cAAc,QAAQ,cAAc;AAYzC,SAXiB;GACf,UAAU;GACV,UAAU;GACV,UAAU;GACV,UAAU;GACV,UAAU;GACV,GAAG,UAAU;GACd,CACE,KAAK,IAAI,CACT,aAAa,CAEA,SAAS,gBAAgB;GACzC"}

package/dist/docs.d.ts

@@ -89,7 +89,7 @@ export declare const libraryInstallSteps: readonly [{
     }];
 }, {
     readonly title: "Use colors and fonts directly";
-    readonly description: "Import tokens.css for raw CSS variables without Tailwind utilities, or colors.css when you want the Tailwind v4 utility bridge generated from the shared semantic tokens. Prefer semantic utilities and --ds-* tokens in new code; the legacy --color-* aliases remain for migration.";
+    readonly description: "Import tokens.css for raw CSS variables without Tailwind utilities, or colors.css when you want the Tailwind v4 utility bridge generated from shared semantic tokens. Use DS-prefixed semantic utilities and --ds-* tokens for all new code.";
     readonly examples: readonly [{
         readonly title: "Raw token import";
         readonly language: "css";
@@ -101,16 +101,16 @@ export declare const libraryInstallSteps: readonly [{
     }, {
         readonly title: "Theme token usage";
         readonly language: "tsx";
-        readonly code: "import { Button } from \"erp-pro-ui\";\n\n<section className=\"bg-surface text-fg border border-border rounded-2xl p-6\">\n  <Button label=\"Save\" primary />\n</section>";
+        readonly code: "import { Button } from \"erp-pro-ui\";\n\n<section className=\"bg-ds-surface-1 text-ds-1 border border-ds-border-2 rounded-2xl p-6\">\n  <Button label=\"Save\" primary />\n</section>";
     }, {
         readonly title: "Chart token usage";
         readonly language: "tsx";
-        readonly code: "import { AreaChart, getChartColorVar } from \"erp-pro-ui\";\n\n<AreaChart\n  data={data}\n  categories={[\n    { key: \"revenue\", color: getChartColorVar(1) },\n    { key: \"cost\", color: \"chart-6\" },\n    { key: \"forecast\", color: \"var(--color-chart-10)\" },\n  ]}\n/>";
+        readonly code: "import { AreaChart, getChartColorVar } from \"erp-pro-ui\";\n\n<AreaChart\n  data={data}\n  categories={[\n    { key: \"revenue\", color: getChartColorVar(1) },\n    { key: \"cost\", color: \"chart-6\" },\n    { key: \"forecast\", color: \"var(--ds-chart-10)\" },\n  ]}\n/>";
         readonly description: "Chart components accept raw CSS colors, theme chart variables, or the built-in chart token helper. The shared token surface includes chart slots 1 through 15.";
     }];
 }, {
     readonly title: "Wrap your app with ThemeProvider";
-    readonly description: "Use ThemeProvider at the root so shared brand and mode attributes are applied as data-brand and data-mode for the token system. The older data-theme attribute is still written for compatibility, but brand and mode are the primary contract.";
+    readonly description: "Use ThemeProvider at the root so brand, mode, and variant attributes are applied as data-brand, data-mode, and data-variant for the token system. The older data-dark-variant and data-theme attributes are still written for compatibility during migration.";
     readonly examples: readonly [{
         readonly title: "Root provider";
         readonly language: "tsx";
@@ -118,7 +118,7 @@ export declare const libraryInstallSteps: readonly [{
     }, {
         readonly title: "Manual attributes";
         readonly language: "tsx";
-        readonly code: "<html data-brand=\"teal\" data-mode=\"dark\"></html>";
+        readonly code: "<html data-brand=\"teal\" data-mode=\"light\" data-variant=\"alt\"></html>";
     }];
 }, {
     readonly title: "Choose an import strategy";
@@ -174,7 +174,7 @@ export declare const libraryDocs: {
         }];
     }, {
         readonly title: "Use colors and fonts directly";
-        readonly description: "Import tokens.css for raw CSS variables without Tailwind utilities, or colors.css when you want the Tailwind v4 utility bridge generated from the shared semantic tokens. Prefer semantic utilities and --ds-* tokens in new code; the legacy --color-* aliases remain for migration.";
+        readonly description: "Import tokens.css for raw CSS variables without Tailwind utilities, or colors.css when you want the Tailwind v4 utility bridge generated from shared semantic tokens. Use DS-prefixed semantic utilities and --ds-* tokens for all new code.";
         readonly examples: readonly [{
             readonly title: "Raw token import";
             readonly language: "css";
@@ -186,16 +186,16 @@ export declare const libraryDocs: {
         }, {
             readonly title: "Theme token usage";
             readonly language: "tsx";
-            readonly code: "import { Button } from \"erp-pro-ui\";\n\n<section className=\"bg-surface text-fg border border-border rounded-2xl p-6\">\n  <Button label=\"Save\" primary />\n</section>";
+            readonly code: "import { Button } from \"erp-pro-ui\";\n\n<section className=\"bg-ds-surface-1 text-ds-1 border border-ds-border-2 rounded-2xl p-6\">\n  <Button label=\"Save\" primary />\n</section>";
         }, {
             readonly title: "Chart token usage";
             readonly language: "tsx";
-            readonly code: "import { AreaChart, getChartColorVar } from \"erp-pro-ui\";\n\n<AreaChart\n  data={data}\n  categories={[\n    { key: \"revenue\", color: getChartColorVar(1) },\n    { key: \"cost\", color: \"chart-6\" },\n    { key: \"forecast\", color: \"var(--color-chart-10)\" },\n  ]}\n/>";
+            readonly code: "import { AreaChart, getChartColorVar } from \"erp-pro-ui\";\n\n<AreaChart\n  data={data}\n  categories={[\n    { key: \"revenue\", color: getChartColorVar(1) },\n    { key: \"cost\", color: \"chart-6\" },\n    { key: \"forecast\", color: \"var(--ds-chart-10)\" },\n  ]}\n/>";
             readonly description: "Chart components accept raw CSS colors, theme chart variables, or the built-in chart token helper. The shared token surface includes chart slots 1 through 15.";
         }];
     }, {
         readonly title: "Wrap your app with ThemeProvider";
-        readonly description: "Use ThemeProvider at the root so shared brand and mode attributes are applied as data-brand and data-mode for the token system. The older data-theme attribute is still written for compatibility, but brand and mode are the primary contract.";
+        readonly description: "Use ThemeProvider at the root so brand, mode, and variant attributes are applied as data-brand, data-mode, and data-variant for the token system. The older data-dark-variant and data-theme attributes are still written for compatibility during migration.";
         readonly examples: readonly [{
             readonly title: "Root provider";
             readonly language: "tsx";
@@ -203,7 +203,7 @@ export declare const libraryDocs: {
         }, {
             readonly title: "Manual attributes";
             readonly language: "tsx";
-            readonly code: "<html data-brand=\"teal\" data-mode=\"dark\"></html>";
+            readonly code: "<html data-brand=\"teal\" data-mode=\"light\" data-variant=\"alt\"></html>";
         }];
     }, {
         readonly title: "Choose an import strategy";

package/dist/docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../src/docs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../src/docs.ts"],"names":[],"mappings":"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"}

package/dist/docs.mjs

@@ -10,7 +10,9 @@ var componentDocSeeds = {
 			"select",
 			"multiselect-combobox",
 			"input"
-		]
+		],
+		rootImport: "import { Combobox, type ComboboxOption } from 'erp-pro-ui';",
+		subpathImport: "import { Combobox, type ComboboxOption } from 'erp-pro-ui/combobox';"
 	},
 	button: {
 		exportName: "Button",
@@ -94,13 +96,15 @@ var componentDocSeeds = {
 	},
 	dialog: {
 		exportName: "Dialog",
-		summary: "Modal overlay for confirmations, destructive flows, and custom embedded forms.",
+		summary: "Portal-backed modal overlay for confirmations, destructive flows, and custom embedded forms that must sit above the full application shell.",
 		aliases: ["modal"],
 		related: [
 			"drawer",
 			"button",
 			"toast"
-		]
+		],
+		rootImport: "import { Dialog, type DialogAnimation, type DialogVariant } from 'erp-pro-ui';",
+		subpathImport: "import { Dialog, type DialogAnimation, type DialogVariant } from 'erp-pro-ui/dialog';"
 	},
 	drawer: {
 		exportName: "Drawer",
@@ -110,7 +114,9 @@ var componentDocSeeds = {
 			"dialog",
 			"card",
 			"tooltip"
-		]
+		],
+		rootImport: "import { Drawer, type DrawerPosition } from 'erp-pro-ui';",
+		subpathImport: "import { Drawer, type DrawerPosition } from 'erp-pro-ui/drawer';"
 	},
 	alert: {
 		exportName: "Alert",
@@ -120,7 +126,9 @@ var componentDocSeeds = {
 			"toast",
 			"loading",
 			"skeleton"
-		]
+		],
+		rootImport: "import { Alert, type AlertVariant } from 'erp-pro-ui';",
+		subpathImport: "import { Alert, type AlertVariant } from 'erp-pro-ui/alert';"
 	},
 	toast: {
 		exportName: "ToastProvider",
@@ -131,8 +139,8 @@ var componentDocSeeds = {
 			"dialog",
 			"loading"
 		],
-		rootImport: "import { ToastProvider, useToast } from 'erp-pro-ui';",
-		subpathImport: "import { ToastProvider, useToast } from 'erp-pro-ui/toast';"
+		rootImport: "import { ToastProvider, useToast, type ToastPosition } from 'erp-pro-ui';",
+		subpathImport: "import { ToastProvider, useToast, type ToastPosition } from 'erp-pro-ui/toast';"
 	},
 	tooltip: {
 		exportName: "Tooltip",
@@ -142,7 +150,9 @@ var componentDocSeeds = {
 			"hover-card",
 			"dialog",
 			"drawer"
-		]
+		],
+		rootImport: "import { Tooltip, type TooltipPosition, type TooltipTrigger } from 'erp-pro-ui';",
+		subpathImport: "import { Tooltip, type TooltipPosition, type TooltipTrigger } from 'erp-pro-ui/tooltip';"
 	},
 	accordion: {
 		exportName: "Accordion",
@@ -166,13 +176,19 @@ var componentDocSeeds = {
 	},
 	stepper: {
 		exportName: "Stepper",
-		summary: "Visual progress indicator for guided workflows, checkouts, and multi-step forms.",
-		aliases: ["wizard steps"],
+		summary: "Centered workflow progress indicator with stacked or inline labels, plus related connected-step and wizard exports for denser or pane-based flows.",
+		aliases: [
+			"wizard steps",
+			"workflow progress",
+			"inline stepper"
+		],
 		related: [
 			"form",
 			"chip",
 			"loading"
-		]
+		],
+		rootImport: "import { Stepper, StepperSteps, StepperWizard, StepperWizardStep, type Step, type StepperLabelPosition, type StepperStepsItem, type StepperStepsState } from 'erp-pro-ui';",
+		subpathImport: "import { Stepper, StepperSteps, StepperWizard, StepperWizardStep, type Step, type StepperLabelPosition, type StepperStepsItem, type StepperStepsState } from 'erp-pro-ui/stepper';"
 	},
 	chip: {
 		exportName: "Chip",
@@ -376,17 +392,21 @@ var componentDocSeeds = {
 			"input",
 			"button",
 			"stepper"
-		]
+		],
+		rootImport: "import { Form, FormActions, FormField, FormSection, InputGroup } from 'erp-pro-ui';",
+		subpathImport: "import { Form, FormActions, FormField, FormSection, InputGroup } from 'erp-pro-ui/form';"
 	},
 	"data-table": {
 		exportName: "DataTable",
-		summary: "Feature-rich data grid with sorting, filtering, column toggles, and filter profiles.",
+		summary: "Feature-rich data grid with filtering, column toggles, pagination, RTL-aware interactions, plus composable table primitives and style slots for external customization.",
 		aliases: ["table", "grid"],
 		related: [
 			"loading",
 			"skeleton",
 			"chip"
-		]
+		],
+		rootImport: "import { DataTable, Table, TableHeader, TableHead, TableBody, TableRow, TableCell, TableFooter, TableCaption, TableContainer } from 'erp-pro-ui';",
+		subpathImport: "import { DataTable, Table, TableHeader, TableHead, TableBody, TableRow, TableCell, TableFooter, TableCaption, TableContainer } from 'erp-pro-ui/data-table';"
 	},
 	loading: {
 		exportName: "Loading",
@@ -396,7 +416,9 @@ var componentDocSeeds = {
 			"skeleton",
 			"alert",
 			"data-table"
-		]
+		],
+		rootImport: "import { Loading, Spinner, Dots, Pulse, Bars, Ring, Bounce, Wave, type LoadingSize, type LoadingVariant } from 'erp-pro-ui';",
+		subpathImport: "import { Loading, Spinner, Dots, Pulse, Bars, Ring, Bounce, Wave, type LoadingSize, type LoadingVariant } from 'erp-pro-ui/loading';"
 	},
 	skeleton: {
 		exportName: "SkeletonComponent",
@@ -418,7 +440,9 @@ var componentDocSeeds = {
 			"bar-chart",
 			"neon-line-chart",
 			"stacked-bar-chart"
-		]
+		],
+		rootImport: "import { AreaChart, type AreaChartData } from 'erp-pro-ui';",
+		subpathImport: "import { AreaChart, type AreaChartData } from 'erp-pro-ui/area-chart';"
 	},
 	"bar-chart": {
 		exportName: "BarChart",
@@ -428,7 +452,9 @@ var componentDocSeeds = {
 			"area-chart",
 			"stacked-bar-chart",
 			"thin-breakdown-bar"
-		]
+		],
+		rootImport: "import { BarChart, type BarChartData } from 'erp-pro-ui';",
+		subpathImport: "import { BarChart, type BarChartData } from 'erp-pro-ui/bar-chart';"
 	},
 	"positive-negative-bar-chart": {
 		exportName: "PositiveNegativeBarChart",
@@ -438,7 +464,9 @@ var componentDocSeeds = {
 			"bar-chart",
 			"stacked-bar-chart",
 			"area-chart"
-		]
+		],
+		rootImport: "import { PositiveNegativeBarChart, type PositiveNegativeBarChartData } from 'erp-pro-ui';",
+		subpathImport: "import { PositiveNegativeBarChart, type PositiveNegativeBarChartData } from 'erp-pro-ui/positive-negative-bar-chart';"
 	},
 	"pie-chart": {
 		exportName: "PieChart",
@@ -448,7 +476,9 @@ var componentDocSeeds = {
 			"bar-chart",
 			"thin-breakdown-bar",
 			"color-palette"
-		]
+		],
+		rootImport: "import { PieChart, type PieChartData } from 'erp-pro-ui';",
+		subpathImport: "import { PieChart, type PieChartData } from 'erp-pro-ui/pie-chart';"
 	},
 	"neon-line-chart": {
 		exportName: "NeonLineChart",
@@ -468,7 +498,9 @@ var componentDocSeeds = {
 			"bar-chart",
 			"thin-breakdown-bar",
 			"area-chart"
-		]
+		],
+		rootImport: "import { StackedBarChart, type StackedBarData } from 'erp-pro-ui';",
+		subpathImport: "import { StackedBarChart, type StackedBarData } from 'erp-pro-ui/stacked-bar-chart';"
 	},
 	"thin-breakdown-bar": {
 		exportName: "ThinBreakdownBar",
@@ -478,7 +510,9 @@ var componentDocSeeds = {
 			"stacked-bar-chart",
 			"pie-chart",
 			"chip"
-		]
+		],
+		rootImport: "import { ThinBreakdownBar, type BreakdownSegment } from 'erp-pro-ui';",
+		subpathImport: "import { ThinBreakdownBar, type BreakdownSegment } from 'erp-pro-ui/thin-breakdown-bar';"
 	},
 	icons: {
 		summary: "Collection of custom SVG icons for dashboards, navigation, commerce, and status-heavy product UIs.",
@@ -500,6 +534,22 @@ var componentDocSeeds = {
 			"icons",
 			"button"
 		]
+	},
+	"truncated-text": {
+		exportName: "TruncatedText",
+		summary: "Reusable text primitive for single-line and multi-line ellipsis with width constraints and optional hover title support.",
+		aliases: [
+			"line clamp",
+			"ellipsis",
+			"truncate"
+		],
+		related: [
+			"typography",
+			"chip",
+			"input"
+		],
+		rootImport: "import { TruncatedText, type TruncatedTextProps } from 'erp-pro-ui';",
+		subpathImport: "import { TruncatedText, type TruncatedTextProps } from 'erp-pro-ui/truncated-text';"
 	}
 };
 function getComponentCategory(storybookTitle) {
@@ -571,7 +621,7 @@ var libraryInstallSteps = [
 	},
 	{
 		title: "Use colors and fonts directly",
-		description: "Import tokens.css for raw CSS variables without Tailwind utilities, or colors.css when you want the Tailwind v4 utility bridge generated from the shared semantic tokens. Prefer semantic utilities and --ds-* tokens in new code; the legacy --color-* aliases remain for migration.",
+		description: "Import tokens.css for raw CSS variables without Tailwind utilities, or colors.css when you want the Tailwind v4 utility bridge generated from shared semantic tokens. Use DS-prefixed semantic utilities and --ds-* tokens for all new code.",
 		examples: [
 			{
 				title: "Raw token import",
@@ -586,19 +636,19 @@ var libraryInstallSteps = [
 			{
 				title: "Theme token usage",
 				language: "tsx",
-				code: "import { Button } from \"erp-pro-ui\";\n\n<section className=\"bg-surface text-fg border border-border rounded-2xl p-6\">\n  <Button label=\"Save\" primary />\n</section>"
+				code: "import { Button } from \"erp-pro-ui\";\n\n<section className=\"bg-ds-surface-1 text-ds-1 border border-ds-border-2 rounded-2xl p-6\">\n  <Button label=\"Save\" primary />\n</section>"
 			},
 			{
 				title: "Chart token usage",
 				language: "tsx",
-				code: "import { AreaChart, getChartColorVar } from \"erp-pro-ui\";\n\n<AreaChart\n  data={data}\n  categories={[\n    { key: \"revenue\", color: getChartColorVar(1) },\n    { key: \"cost\", color: \"chart-6\" },\n    { key: \"forecast\", color: \"var(--color-chart-10)\" },\n  ]}\n/>",
+				code: "import { AreaChart, getChartColorVar } from \"erp-pro-ui\";\n\n<AreaChart\n  data={data}\n  categories={[\n    { key: \"revenue\", color: getChartColorVar(1) },\n    { key: \"cost\", color: \"chart-6\" },\n    { key: \"forecast\", color: \"var(--ds-chart-10)\" },\n  ]}\n/>",
 				description: "Chart components accept raw CSS colors, theme chart variables, or the built-in chart token helper. The shared token surface includes chart slots 1 through 15."
 			}
 		]
 	},
 	{
 		title: "Wrap your app with ThemeProvider",
-		description: "Use ThemeProvider at the root so shared brand and mode attributes are applied as data-brand and data-mode for the token system. The older data-theme attribute is still written for compatibility, but brand and mode are the primary contract.",
+		description: "Use ThemeProvider at the root so brand, mode, and variant attributes are applied as data-brand, data-mode, and data-variant for the token system. The older data-dark-variant and data-theme attributes are still written for compatibility during migration.",
 		examples: [{
 			title: "Root provider",
 			language: "tsx",
@@ -606,7 +656,7 @@ var libraryInstallSteps = [
 		}, {
 			title: "Manual attributes",
 			language: "tsx",
-			code: "<html data-brand=\"teal\" data-mode=\"dark\"></html>"
+			code: "<html data-brand=\"teal\" data-mode=\"light\" data-variant=\"alt\"></html>"
 		}]
 	},
 	{