@od-oneapp/ai-platform 0.1.0

package/dist/generative-ui-catalog.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"generative-ui-catalog.mjs","names":[],"sources":["../src/generative-ui/catalog.ts"],"sourcesContent":["/**\n * @fileoverview Enterprise Generative UI Catalog.\n * @module @od-oneapp/ai-platform/generative-ui\n *\n * Creates and manages component catalogs for AI-driven UI generation.\n * Wraps component definitions with governance (entitlement filtering,\n * audit logging, validation) for enterprise deployments.\n *\n * @example\n * ```ts\n * import { createEnterpriseCatalog, BASE_CATALOG_COMPONENTS } from '@od-oneapp/ai-platform/generative-ui';\n *\n * const catalog = createEnterpriseCatalog({\n *   components: BASE_CATALOG_COMPONENTS,\n *   enableEntitlementFiltering: true,\n *   enableAuditLogging: true,\n * });\n *\n * // Get components available for a pro user\n * const proComponents = catalog.getComponentsForTier('pro');\n *\n * // Generate system prompt section\n * const promptSection = catalog.generatePromptSection('pro');\n * ```\n */\n\nimport type {\n  CatalogComponent,\n  EnterpriseCatalog,\n  EnterpriseCatalogConfig,\n  UIElement,\n  UITree,\n  UITreeValidationError,\n  UITreeValidationResult,\n} from './types';\nimport type { UserTier } from \"../governance/entitlements\";\n\n\n// ---------------------------------------------------------------------------\n// Tier Ordering\n// ---------------------------------------------------------------------------\n\nconst TIER_ORDER: Record<UserTier, number> = {\n  free: 0,\n  pro: 1,\n  enterprise: 2,\n};\n\n/**\n * Check if a user tier has access to a component's minimum tier requirement.\n */\nfunction tierHasAccess(userTier: UserTier, minTier?: UserTier): boolean {\n  if (!minTier) return true;\n  return TIER_ORDER[userTier] >= TIER_ORDER[minTier];\n}\n\n// ---------------------------------------------------------------------------\n// Base Catalog Components\n// ---------------------------------------------------------------------------\n\n/**\n * Base catalog of generative UI components.\n * Maps to `@od-oneapp/uni-ui` components for rendering.\n *\n * Categories:\n * - **layout**: Structural containers (Card, Grid, Stack, Section)\n * - **data**: Data display (DataTable, List, Badge, Tag)\n * - **chart**: Visualizations (BarChart, LineChart, PieChart, AreaChart)\n * - **metric**: KPI displays (MetricCard, ProgressBar, StatGroup)\n * - **action**: Interactive elements (Button, Link, CallToAction)\n * - **feedback**: Status indicators (Alert, StatusBadge, Skeleton)\n */\nexport const BASE_CATALOG_COMPONENTS: readonly CatalogComponent[] = [\n  // === Layout ===\n  {\n    name: 'Card',\n    description:\n      'Container with border, padding, and optional header/footer. Use as a grouping wrapper.',\n    category: 'layout',\n    acceptsChildren: true,\n    props: [\n      { name: 'title', type: 'string', description: 'Optional card header text', required: false },\n      {\n        name: 'subtitle',\n        type: 'string',\n        description: 'Optional subtitle below the title',\n        required: false,\n      },\n      {\n        name: 'variant',\n        type: 'string',\n        description: 'Visual variant',\n        enum: ['default', 'outlined', 'elevated'],\n        default: 'default',\n      },\n    ],\n  },\n  {\n    name: 'Grid',\n    description: 'Responsive grid layout. Distributes children in a CSS grid.',\n    category: 'layout',\n    acceptsChildren: true,\n    props: [\n      {\n        name: 'columns',\n        type: 'number',\n        description: 'Number of columns (1-6)',\n        required: false,\n        default: 2,\n      },\n      {\n        name: 'gap',\n        type: 'string',\n        description: 'Gap size',\n        enum: ['sm', 'md', 'lg'],\n        default: 'md',\n      },\n    ],\n  },\n  {\n    name: 'Stack',\n    description: 'Vertical or horizontal flex container for stacking children.',\n    category: 'layout',\n    acceptsChildren: true,\n    props: [\n      {\n        name: 'direction',\n        type: 'string',\n        description: 'Stack direction',\n        enum: ['vertical', 'horizontal'],\n        default: 'vertical',\n      },\n      {\n        name: 'gap',\n        type: 'string',\n        description: 'Gap size',\n        enum: ['sm', 'md', 'lg'],\n        default: 'md',\n      },\n      {\n        name: 'align',\n        type: 'string',\n        description: 'Alignment',\n        enum: ['start', 'center', 'end', 'stretch'],\n        default: 'stretch',\n      },\n    ],\n  },\n  {\n    name: 'Section',\n    description:\n      'Semantic section with heading and optional description. Use to organize content areas.',\n    category: 'layout',\n    acceptsChildren: true,\n    props: [\n      { name: 'heading', type: 'string', description: 'Section heading', required: true },\n      {\n        name: 'description',\n        type: 'string',\n        description: 'Optional section description',\n        required: false,\n      },\n    ],\n  },\n\n  // === Data ===\n  {\n    name: 'DataTable',\n    description: 'Tabular data display with headers and rows. Use for structured datasets.',\n    category: 'data',\n    minTier: 'pro',\n    props: [\n      { name: 'headers', type: 'array', description: 'Column header labels', required: true },\n      {\n        name: 'rows',\n        type: 'array',\n        description: 'Array of row arrays (each row is an array of cell values)',\n        required: true,\n      },\n      { name: 'caption', type: 'string', description: 'Optional table caption', required: false },\n      { name: 'striped', type: 'boolean', description: 'Alternate row shading', default: true },\n    ],\n  },\n  {\n    name: 'List',\n    description: 'Ordered or unordered list display.',\n    category: 'data',\n    props: [\n      {\n        name: 'items',\n        type: 'array',\n        description: 'Array of string items to display',\n        required: true,\n      },\n      { name: 'ordered', type: 'boolean', description: 'Use numbered list', default: false },\n    ],\n  },\n  {\n    name: 'Badge',\n    description: 'Small status label or tag. Use inline with text or in table cells.',\n    category: 'data',\n    props: [\n      { name: 'label', type: 'string', description: 'Badge text', required: true },\n      {\n        name: 'variant',\n        type: 'string',\n        description: 'Visual style',\n        enum: ['default', 'success', 'warning', 'error', 'info'],\n        default: 'default',\n      },\n    ],\n  },\n  {\n    name: 'KeyValue',\n    description: 'Key-value pair display. Use for simple attribute lists.',\n    category: 'data',\n    props: [\n      { name: 'label', type: 'string', description: 'Key/label text', required: true },\n      { name: 'value', type: 'string', description: 'Value text', required: true },\n    ],\n  },\n\n  // === Charts (pro+) ===\n  {\n    name: 'BarChart',\n    description: 'Vertical or horizontal bar chart for comparing quantities across categories.',\n    category: 'chart',\n    minTier: 'pro',\n    props: [\n      {\n        name: 'data',\n        type: 'array',\n        description: 'Array of { label, value } objects',\n        required: true,\n      },\n      { name: 'title', type: 'string', description: 'Chart title', required: false },\n      {\n        name: 'orientation',\n        type: 'string',\n        description: 'Bar direction',\n        enum: ['vertical', 'horizontal'],\n        default: 'vertical',\n      },\n      {\n        name: 'color',\n        type: 'string',\n        description: 'Bar color',\n        enum: ['primary', 'secondary', 'success', 'warning', 'error'],\n        default: 'primary',\n      },\n    ],\n  },\n  {\n    name: 'LineChart',\n    description: 'Line chart for showing trends over time or continuous data.',\n    category: 'chart',\n    minTier: 'pro',\n    props: [\n      {\n        name: 'data',\n        type: 'array',\n        description: 'Array of { x, y } or { label, value } objects',\n        required: true,\n      },\n      { name: 'title', type: 'string', description: 'Chart title', required: false },\n      { name: 'xLabel', type: 'string', description: 'X-axis label', required: false },\n      { name: 'yLabel', type: 'string', description: 'Y-axis label', required: false },\n    ],\n  },\n  {\n    name: 'PieChart',\n    description: 'Pie/donut chart for showing proportions of a whole.',\n    category: 'chart',\n    minTier: 'pro',\n    props: [\n      {\n        name: 'data',\n        type: 'array',\n        description: 'Array of { label, value } objects',\n        required: true,\n      },\n      { name: 'title', type: 'string', description: 'Chart title', required: false },\n      { name: 'donut', type: 'boolean', description: 'Show as donut chart', default: false },\n    ],\n  },\n  {\n    name: 'AreaChart',\n    description: 'Filled area chart for showing volume or cumulative trends.',\n    category: 'chart',\n    minTier: 'enterprise',\n    props: [\n      { name: 'data', type: 'array', description: 'Array of { x, y } objects', required: true },\n      { name: 'title', type: 'string', description: 'Chart title', required: false },\n      { name: 'stacked', type: 'boolean', description: 'Stack multiple series', default: false },\n    ],\n  },\n\n  // === Metrics ===\n  {\n    name: 'MetricCard',\n    description:\n      'KPI card showing a single metric with value, label, trend, and optional sparkline.',\n    category: 'metric',\n    props: [\n      {\n        name: 'label',\n        type: 'string',\n        description: 'Metric label (e.g., \"Monthly Revenue\")',\n        required: true,\n      },\n      {\n        name: 'value',\n        type: 'string',\n        description: 'Formatted value (e.g., \"$1.2M\", \"94%\")',\n        required: true,\n      },\n      {\n        name: 'trend',\n        type: 'string',\n        description: 'Trend direction',\n        enum: ['up', 'down', 'stable'],\n        required: false,\n      },\n      {\n        name: 'trendValue',\n        type: 'string',\n        description: 'Trend percentage (e.g., \"+12%\")',\n        required: false,\n      },\n      {\n        name: 'sentiment',\n        type: 'string',\n        description: 'Color sentiment',\n        enum: ['positive', 'negative', 'neutral', 'warning'],\n        default: 'neutral',\n      },\n    ],\n  },\n  {\n    name: 'ProgressBar',\n    description: 'Progress indicator showing completion percentage.',\n    category: 'metric',\n    props: [\n      { name: 'label', type: 'string', description: 'Progress label', required: true },\n      { name: 'value', type: 'number', description: 'Current value (0-100)', required: true },\n      { name: 'max', type: 'number', description: 'Maximum value', default: 100 },\n      {\n        name: 'variant',\n        type: 'string',\n        description: 'Color variant',\n        enum: ['default', 'success', 'warning', 'error'],\n        default: 'default',\n      },\n    ],\n  },\n  {\n    name: 'StatGroup',\n    description: 'Horizontal group of stats. Use for showing related numbers together.',\n    category: 'metric',\n    props: [\n      {\n        name: 'stats',\n        type: 'array',\n        description: 'Array of { label, value } objects',\n        required: true,\n      },\n    ],\n  },\n\n  // === Actions ===\n  {\n    name: 'CallToAction',\n    description:\n      'Prominent action button with optional description. Use sparingly for primary actions.',\n    category: 'action',\n    minTier: 'pro',\n    props: [\n      { name: 'label', type: 'string', description: 'Button label', required: true },\n      {\n        name: 'description',\n        type: 'string',\n        description: 'Supporting text below the button',\n        required: false,\n      },\n      {\n        name: 'action',\n        type: 'string',\n        description: 'Action identifier (handled by app)',\n        required: true,\n      },\n      {\n        name: 'variant',\n        type: 'string',\n        description: 'Button style',\n        enum: ['primary', 'secondary', 'outline'],\n        default: 'primary',\n      },\n    ],\n  },\n\n  // === Feedback ===\n  {\n    name: 'Alert',\n    description: 'Alert/banner message for drawing attention to important information.',\n    category: 'feedback',\n    props: [\n      { name: 'title', type: 'string', description: 'Alert title', required: true },\n      { name: 'description', type: 'string', description: 'Alert body text', required: false },\n      {\n        name: 'severity',\n        type: 'string',\n        description: 'Alert severity',\n        enum: ['info', 'success', 'warning', 'error'],\n        default: 'info',\n      },\n    ],\n  },\n  {\n    name: 'StatusBadge',\n    description: 'Status indicator with dot and label.',\n    category: 'feedback',\n    props: [\n      { name: 'label', type: 'string', description: 'Status text', required: true },\n      {\n        name: 'status',\n        type: 'string',\n        description: 'Status type',\n        enum: ['online', 'offline', 'busy', 'away', 'error'],\n        required: true,\n      },\n    ],\n  },\n] as const;\n\n// ---------------------------------------------------------------------------\n// Catalog Factory\n// ---------------------------------------------------------------------------\n\n/**\n * Validates a single UI element against the catalog.\n */\nfunction validateElement(\n  element: UIElement,\n  components: Map<string, CatalogComponent>,\n  tier: UserTier,\n  path: string,\n): UITreeValidationError[] {\n  const errors: UITreeValidationError[] = [];\n\n  const component = components.get(element.type);\n\n  if (!component) {\n    errors.push({\n      path,\n      message: `Unknown component type: '${element.type}'`,\n      severity: 'error',\n    });\n    return errors;\n  }\n\n  // Check tier access\n  if (!tierHasAccess(tier, component.minTier)) {\n    errors.push({\n      path,\n      message: `Component '${element.type}' requires ${component.minTier} tier (user has ${tier})`,\n      severity: 'error',\n    });\n  }\n\n  // Check required props\n  for (const propSchema of component.props) {\n    if (propSchema.required && !(propSchema.name in element.props)) {\n      errors.push({\n        path: `${path}.props.${propSchema.name}`,\n        message: `Required prop '${propSchema.name}' missing on '${element.type}'`,\n        severity: 'error',\n      });\n    }\n  }\n\n  // Check for unknown props (warning only)\n  const knownPropNames = new Set(component.props.map(p => p.name));\n  for (const propName of Object.keys(element.props)) {\n    if (!knownPropNames.has(propName)) {\n      errors.push({\n        path: `${path}.props.${propName}`,\n        message: `Unknown prop '${propName}' on '${element.type}'`,\n        severity: 'warning',\n      });\n    }\n  }\n\n  // Check children\n  if (element.children && !component.acceptsChildren) {\n    errors.push({\n      path: `${path}.children`,\n      message: `Component '${element.type}' does not accept children`,\n      severity: 'warning',\n    });\n  }\n\n  // Recursively validate children\n  if (element.children) {\n    for (let i = 0; i < element.children.length; i++) {\n      const child = element.children[i];\n      if (child) {\n        errors.push(...validateElement(child, components, tier, `${path}.children[${i}]`));\n      }\n    }\n  }\n\n  return errors;\n}\n\n/**\n * Generates a system prompt section describing available components.\n */\nfunction buildPromptSection(components: readonly CatalogComponent[]): string {\n  const lines: string[] = [\n    '## Available UI Components',\n    '',\n    'You can compose interfaces using these components. Return a JSON UITree.',\n    '',\n  ];\n\n  // Group by category\n  const byCategory = new Map<string, CatalogComponent[]>();\n  for (const comp of components) {\n    const list = byCategory.get(comp.category) ?? [];\n    list.push(comp);\n    byCategory.set(comp.category, list);\n  }\n\n  for (const [category, comps] of byCategory) {\n    lines.push(`### ${category.charAt(0).toUpperCase() + category.slice(1)}`);\n    lines.push('');\n\n    for (const comp of comps) {\n      const propsDesc = comp.props\n        .map(p => {\n          let desc = `  - \\`${p.name}\\` (${p.type}${p.required ? ', required' : ''}): ${p.description}`;\n          if (p.enum) desc += ` [${p.enum.join(' | ')}]`;\n          if (p.default !== undefined) desc += ` (default: ${JSON.stringify(p.default)})`;\n          return desc;\n        })\n        .join('\\n');\n\n      lines.push(`**${comp.name}**: ${comp.description}`);\n      if (comp.acceptsChildren) lines.push('  - Accepts children: yes');\n      if (propsDesc) lines.push(propsDesc);\n      lines.push('');\n    }\n  }\n\n  lines.push('### UITree JSON Schema');\n  lines.push('');\n  lines.push('```json');\n  lines.push(\n    JSON.stringify(\n      {\n        version: '1.0',\n        root: {\n          type: 'ComponentName',\n          props: { '...': '...' },\n          children: ['...recursive UIElement[]'],\n        },\n      },\n      null,\n      2,\n    ),\n  );\n  lines.push('```');\n\n  return lines.join('\\n');\n}\n\n/**\n * Creates an enterprise generative UI catalog with governance extensions.\n *\n * @param config - Catalog configuration.\n * @returns EnterpriseCatalog instance.\n *\n * @example\n * ```ts\n * const catalog = createEnterpriseCatalog({\n *   components: BASE_CATALOG_COMPONENTS,\n *   enableEntitlementFiltering: true,\n * });\n *\n * // Generate prompt for pro-tier user\n * const prompt = catalog.generatePromptSection('pro');\n *\n * // Validate AI-generated tree\n * const result = catalog.validateTree(tree, 'pro');\n * ```\n */\nexport function createEnterpriseCatalog(config: EnterpriseCatalogConfig): EnterpriseCatalog {\n  const allComponents = config.validateComponent\n    ? config.components.filter(config.validateComponent)\n    : [...config.components];\n\n  const componentMap = new Map<string, CatalogComponent>(allComponents.map(c => [c.name, c]));\n\n  return {\n    components: allComponents,\n\n    getComponentsForTier(tier: UserTier): readonly CatalogComponent[] {\n      if (!config.enableEntitlementFiltering) {\n        return allComponents;\n      }\n\n      return allComponents.filter(c => tierHasAccess(tier, c.minTier));\n    },\n\n    getComponent(name: string): CatalogComponent | undefined {\n      return componentMap.get(name);\n    },\n\n    generatePromptSection(tier: UserTier): string {\n      let components = this.getComponentsForTier(tier);\n\n      // Limit components in prompt to control token cost\n      if (config.maxComponentsInPrompt && components.length > config.maxComponentsInPrompt) {\n        components = components.slice(0, config.maxComponentsInPrompt);\n      }\n\n      return buildPromptSection(components);\n    },\n\n    validateTree(tree: UITree, tier: UserTier): UITreeValidationResult {\n      if (tree.version !== '1.0') {\n        return {\n          valid: false,\n          errors: [\n            {\n              path: 'version',\n              message: `Unsupported UITree version: '${tree.version}'. Expected '1.0'.`,\n              severity: 'error',\n            },\n          ],\n        };\n      }\n\n      const errors = validateElement(tree.root, componentMap, tier, 'root');\n      const hasErrors = errors.some(e => e.severity === 'error');\n\n      return {\n        valid: !hasErrors,\n        errors,\n      };\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/generative-ui-registry.d.mts

@@ -0,0 +1,195 @@
+import { z } from "zod";
+
+//#region src/generative-ui/registry.d.ts
+declare const BASE_COMPONENT_SCHEMAS: {
+  readonly Card: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    subtitle: z.ZodOptional<z.ZodString>;
+    variant: z.ZodDefault<z.ZodEnum<{
+      default: "default";
+      outlined: "outlined";
+      elevated: "elevated";
+    }>>;
+  }, z.core.$strip>;
+  readonly Grid: z.ZodObject<{
+    columns: z.ZodDefault<z.ZodNumber>;
+    gap: z.ZodDefault<z.ZodEnum<{
+      sm: "sm";
+      md: "md";
+      lg: "lg";
+    }>>;
+  }, z.core.$strip>;
+  readonly Stack: z.ZodObject<{
+    direction: z.ZodDefault<z.ZodEnum<{
+      vertical: "vertical";
+      horizontal: "horizontal";
+    }>>;
+    gap: z.ZodDefault<z.ZodEnum<{
+      sm: "sm";
+      md: "md";
+      lg: "lg";
+    }>>;
+    align: z.ZodDefault<z.ZodEnum<{
+      start: "start";
+      center: "center";
+      end: "end";
+      stretch: "stretch";
+    }>>;
+  }, z.core.$strip>;
+  readonly Section: z.ZodObject<{
+    heading: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>;
+  readonly DataTable: z.ZodObject<{
+    headers: z.ZodArray<z.ZodString>;
+    rows: z.ZodArray<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+    caption: z.ZodOptional<z.ZodString>;
+    striped: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strip>;
+  readonly List: z.ZodObject<{
+    items: z.ZodArray<z.ZodString>;
+    ordered: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strip>;
+  readonly Badge: z.ZodObject<{
+    label: z.ZodString;
+    variant: z.ZodDefault<z.ZodEnum<{
+      success: "success";
+      default: "default";
+      error: "error";
+      warning: "warning";
+      info: "info";
+    }>>;
+  }, z.core.$strip>;
+  readonly KeyValue: z.ZodObject<{
+    label: z.ZodString;
+    value: z.ZodString;
+  }, z.core.$strip>;
+  readonly BarChart: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+      label: z.ZodString;
+      value: z.ZodNumber;
+    }, z.core.$strip>>;
+    title: z.ZodOptional<z.ZodString>;
+    orientation: z.ZodDefault<z.ZodEnum<{
+      vertical: "vertical";
+      horizontal: "horizontal";
+    }>>;
+    color: z.ZodDefault<z.ZodEnum<{
+      success: "success";
+      error: "error";
+      warning: "warning";
+      primary: "primary";
+      secondary: "secondary";
+    }>>;
+  }, z.core.$strip>;
+  readonly LineChart: z.ZodObject<{
+    data: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+      x: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+      y: z.ZodNumber;
+      label: z.ZodOptional<z.ZodString>;
+      value: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+      label: z.ZodString;
+      value: z.ZodNumber;
+      x: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+      y: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>]>>;
+    title: z.ZodOptional<z.ZodString>;
+    xLabel: z.ZodOptional<z.ZodString>;
+    yLabel: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>;
+  readonly PieChart: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+      label: z.ZodString;
+      value: z.ZodNumber;
+    }, z.core.$strip>>;
+    title: z.ZodOptional<z.ZodString>;
+    donut: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strip>;
+  readonly AreaChart: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+      x: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+      y: z.ZodNumber;
+    }, z.core.$strip>>;
+    title: z.ZodOptional<z.ZodString>;
+    stacked: z.ZodDefault<z.ZodBoolean>;
+  }, z.core.$strip>;
+  readonly MetricCard: z.ZodObject<{
+    label: z.ZodString;
+    value: z.ZodString;
+    trend: z.ZodOptional<z.ZodEnum<{
+      up: "up";
+      down: "down";
+      stable: "stable";
+    }>>;
+    trendValue: z.ZodOptional<z.ZodString>;
+    sentiment: z.ZodDefault<z.ZodEnum<{
+      warning: "warning";
+      positive: "positive";
+      negative: "negative";
+      neutral: "neutral";
+    }>>;
+  }, z.core.$strip>;
+  readonly ProgressBar: z.ZodObject<{
+    label: z.ZodString;
+    value: z.ZodNumber;
+    max: z.ZodDefault<z.ZodNumber>;
+    variant: z.ZodDefault<z.ZodEnum<{
+      success: "success";
+      default: "default";
+      error: "error";
+      warning: "warning";
+    }>>;
+  }, z.core.$strip>;
+  readonly StatGroup: z.ZodObject<{
+    stats: z.ZodArray<z.ZodObject<{
+      label: z.ZodString;
+      value: z.ZodString;
+    }, z.core.$strip>>;
+  }, z.core.$strip>;
+  readonly CallToAction: z.ZodObject<{
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    action: z.ZodString;
+    variant: z.ZodDefault<z.ZodEnum<{
+      primary: "primary";
+      secondary: "secondary";
+      outline: "outline";
+    }>>;
+  }, z.core.$strip>;
+  readonly Alert: z.ZodObject<{
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    severity: z.ZodDefault<z.ZodEnum<{
+      success: "success";
+      error: "error";
+      warning: "warning";
+      info: "info";
+    }>>;
+  }, z.core.$strip>;
+  readonly StatusBadge: z.ZodObject<{
+    label: z.ZodString;
+    status: z.ZodEnum<{
+      error: "error";
+      online: "online";
+      offline: "offline";
+      busy: "busy";
+      away: "away";
+    }>;
+  }, z.core.$strip>;
+};
+type RegisteredComponentName = keyof typeof BASE_COMPONENT_SCHEMAS;
+interface ComponentRegistry {
+  parseProps(componentName: string, rawProps: unknown): Record<string, unknown>;
+  safeParseProps(componentName: string, rawProps: unknown): {
+    success: boolean;
+    data?: Record<string, unknown>;
+    error?: z.ZodError;
+  };
+  hasComponent(name: string): boolean;
+  getComponentNames(): readonly string[];
+}
+declare function createComponentRegistry(schemas: Record<string, z.ZodType>): ComponentRegistry;
+//#endregion
+export { BASE_COMPONENT_SCHEMAS, ComponentRegistry, RegisteredComponentName, createComponentRegistry };
+//# sourceMappingURL=generative-ui-registry.d.mts.map

package/dist/generative-ui-registry.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generative-ui-registry.d.mts","names":[],"sources":["../src/generative-ui/registry.ts"],"mappings":";;;cAuBa,sBAAA;EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAmID,uBAAA,gBAAuC,sBAAA;AAAA,UAYlC,iBAAA;EAUf,UAAA,CAAW,aAAA,UAAuB,QAAA,YAAoB,MAAA;EAStD,cAAA,CACE,aAAA,UACA,QAAA;IAEA,OAAA;IACA,IAAA,GAAO,MAAA;IACP,KAAA,GAAQ,CAAA,CAAE,QAAA;EAAA;EASZ,YAAA,CAAa,IAAA;EAOb,iBAAA;AAAA;AAAA,iBAqBc,uBAAA,CAAwB,OAAA,EAAS,MAAA,SAAe,CAAA,CAAE,OAAA,IAAW,iBAAA"}

package/dist/generative-ui-registry.mjs

@@ -0,0 +1,250 @@
+import { z } from "zod";
+
+//#region src/generative-ui/registry.ts
+/**
+* @fileoverview Generative UI Component Registry.
+* @module @od-oneapp/ai-platform/generative-ui
+*
+* Maps catalog component names to type-safe prop schemas (Zod).
+* Used for runtime validation of AI-generated UI trees before rendering.
+*
+* @example
+* ```ts
+* import { createComponentRegistry, BASE_COMPONENT_SCHEMAS } from '@od-oneapp/ai-platform/generative-ui';
+*
+* const registry = createComponentRegistry(BASE_COMPONENT_SCHEMAS);
+* const parsed = registry.parseProps('MetricCard', rawProps);
+* ```
+*/
+/** Zod schema for each base catalog component's props. */
+const BASE_COMPONENT_SCHEMAS = {
+	Card: z.object({
+		title: z.string().optional(),
+		subtitle: z.string().optional(),
+		variant: z.enum([
+			"default",
+			"outlined",
+			"elevated"
+		]).default("default")
+	}),
+	Grid: z.object({
+		columns: z.number().int().min(1).max(6).default(2),
+		gap: z.enum([
+			"sm",
+			"md",
+			"lg"
+		]).default("md")
+	}),
+	Stack: z.object({
+		direction: z.enum(["vertical", "horizontal"]).default("vertical"),
+		gap: z.enum([
+			"sm",
+			"md",
+			"lg"
+		]).default("md"),
+		align: z.enum([
+			"start",
+			"center",
+			"end",
+			"stretch"
+		]).default("stretch")
+	}),
+	Section: z.object({
+		heading: z.string(),
+		description: z.string().optional()
+	}),
+	DataTable: z.object({
+		headers: z.array(z.string()),
+		rows: z.array(z.array(z.union([
+			z.string(),
+			z.number(),
+			z.boolean()
+		]))),
+		caption: z.string().optional(),
+		striped: z.boolean().default(true)
+	}),
+	List: z.object({
+		items: z.array(z.string()),
+		ordered: z.boolean().default(false)
+	}),
+	Badge: z.object({
+		label: z.string(),
+		variant: z.enum([
+			"default",
+			"success",
+			"warning",
+			"error",
+			"info"
+		]).default("default")
+	}),
+	KeyValue: z.object({
+		label: z.string(),
+		value: z.string()
+	}),
+	BarChart: z.object({
+		data: z.array(z.object({
+			label: z.string(),
+			value: z.number()
+		})),
+		title: z.string().optional(),
+		orientation: z.enum(["vertical", "horizontal"]).default("vertical"),
+		color: z.enum([
+			"primary",
+			"secondary",
+			"success",
+			"warning",
+			"error"
+		]).default("primary")
+	}),
+	LineChart: z.object({
+		data: z.array(z.union([z.object({
+			x: z.union([z.string(), z.number()]),
+			y: z.number(),
+			label: z.string().optional(),
+			value: z.number().optional()
+		}), z.object({
+			label: z.string(),
+			value: z.number(),
+			x: z.union([z.string(), z.number()]).optional(),
+			y: z.number().optional()
+		})])),
+		title: z.string().optional(),
+		xLabel: z.string().optional(),
+		yLabel: z.string().optional()
+	}),
+	PieChart: z.object({
+		data: z.array(z.object({
+			label: z.string(),
+			value: z.number()
+		})),
+		title: z.string().optional(),
+		donut: z.boolean().default(false)
+	}),
+	AreaChart: z.object({
+		data: z.array(z.object({
+			x: z.union([z.string(), z.number()]),
+			y: z.number()
+		})),
+		title: z.string().optional(),
+		stacked: z.boolean().default(false)
+	}),
+	MetricCard: z.object({
+		label: z.string(),
+		value: z.string(),
+		trend: z.enum([
+			"up",
+			"down",
+			"stable"
+		]).optional(),
+		trendValue: z.string().optional(),
+		sentiment: z.enum([
+			"positive",
+			"negative",
+			"neutral",
+			"warning"
+		]).default("neutral")
+	}),
+	ProgressBar: z.object({
+		label: z.string(),
+		value: z.number().min(0).max(100),
+		max: z.number().min(1).default(100),
+		variant: z.enum([
+			"default",
+			"success",
+			"warning",
+			"error"
+		]).default("default")
+	}),
+	StatGroup: z.object({ stats: z.array(z.object({
+		label: z.string(),
+		value: z.string()
+	})) }),
+	CallToAction: z.object({
+		label: z.string(),
+		description: z.string().optional(),
+		action: z.string(),
+		variant: z.enum([
+			"primary",
+			"secondary",
+			"outline"
+		]).default("primary")
+	}),
+	Alert: z.object({
+		title: z.string(),
+		description: z.string().optional(),
+		severity: z.enum([
+			"info",
+			"success",
+			"warning",
+			"error"
+		]).default("info")
+	}),
+	StatusBadge: z.object({
+		label: z.string(),
+		status: z.enum([
+			"online",
+			"offline",
+			"busy",
+			"away",
+			"error"
+		])
+	})
+};
+/**
+* Creates a component registry from Zod schemas.
+*
+* @param schemas - Map of component name → Zod schema.
+* @returns ComponentRegistry instance.
+*
+* @example
+* ```ts
+* const registry = createComponentRegistry(BASE_COMPONENT_SCHEMAS);
+*
+* // Validate props from AI output
+* const props = registry.parseProps('MetricCard', {
+*   label: 'Revenue',
+*   value: '$1.2M',
+*   trend: 'up',
+* });
+* ```
+*/
+function createComponentRegistry(schemas) {
+	const schemaMap = new Map(Object.entries(schemas));
+	return {
+		parseProps(componentName, rawProps) {
+			const schema = schemaMap.get(componentName);
+			if (!schema) throw new Error(`Unknown component: '${componentName}'. Registered: ${[...schemaMap.keys()].join(", ")}`);
+			return schema.parse(rawProps);
+		},
+		safeParseProps(componentName, rawProps) {
+			const schema = schemaMap.get(componentName);
+			if (!schema) return {
+				success: false,
+				error: new z.ZodError([{
+					code: "custom",
+					path: ["type"],
+					message: `Unknown component: '${componentName}'`
+				}])
+			};
+			const result = schema.safeParse(rawProps);
+			if (result.success) return {
+				success: true,
+				data: result.data
+			};
+			return {
+				success: false,
+				error: result.error
+			};
+		},
+		hasComponent(name) {
+			return schemaMap.has(name);
+		},
+		getComponentNames() {
+			return [...schemaMap.keys()];
+		}
+	};
+}
+
+//#endregion
+export { BASE_COMPONENT_SCHEMAS, createComponentRegistry };
+//# sourceMappingURL=generative-ui-registry.mjs.map

package/dist/generative-ui-registry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"generative-ui-registry.mjs","names":[],"sources":["../src/generative-ui/registry.ts"],"sourcesContent":["/**\n * @fileoverview Generative UI Component Registry.\n * @module @od-oneapp/ai-platform/generative-ui\n *\n * Maps catalog component names to type-safe prop schemas (Zod).\n * Used for runtime validation of AI-generated UI trees before rendering.\n *\n * @example\n * ```ts\n * import { createComponentRegistry, BASE_COMPONENT_SCHEMAS } from '@od-oneapp/ai-platform/generative-ui';\n *\n * const registry = createComponentRegistry(BASE_COMPONENT_SCHEMAS);\n * const parsed = registry.parseProps('MetricCard', rawProps);\n * ```\n */\n\nimport { z } from 'zod';\n\n// ---------------------------------------------------------------------------\n// Schema Definitions\n// ---------------------------------------------------------------------------\n\n/** Zod schema for each base catalog component's props. */\nexport const BASE_COMPONENT_SCHEMAS = {\n  // Layout\n  Card: z.object({\n    title: z.string().optional(),\n    subtitle: z.string().optional(),\n    variant: z.enum(['default', 'outlined', 'elevated']).default('default'),\n  }),\n\n  Grid: z.object({\n    columns: z.number().int().min(1).max(6).default(2),\n    gap: z.enum(['sm', 'md', 'lg']).default('md'),\n  }),\n\n  Stack: z.object({\n    direction: z.enum(['vertical', 'horizontal']).default('vertical'),\n    gap: z.enum(['sm', 'md', 'lg']).default('md'),\n    align: z.enum(['start', 'center', 'end', 'stretch']).default('stretch'),\n  }),\n\n  Section: z.object({\n    heading: z.string(),\n    description: z.string().optional(),\n  }),\n\n  // Data\n  DataTable: z.object({\n    headers: z.array(z.string()),\n    rows: z.array(z.array(z.union([z.string(), z.number(), z.boolean()]))),\n    caption: z.string().optional(),\n    striped: z.boolean().default(true),\n  }),\n\n  List: z.object({\n    items: z.array(z.string()),\n    ordered: z.boolean().default(false),\n  }),\n\n  Badge: z.object({\n    label: z.string(),\n    variant: z.enum(['default', 'success', 'warning', 'error', 'info']).default('default'),\n  }),\n\n  KeyValue: z.object({\n    label: z.string(),\n    value: z.string(),\n  }),\n\n  // Charts\n  BarChart: z.object({\n    data: z.array(z.object({ label: z.string(), value: z.number() })),\n    title: z.string().optional(),\n    orientation: z.enum(['vertical', 'horizontal']).default('vertical'),\n    color: z.enum(['primary', 'secondary', 'success', 'warning', 'error']).default('primary'),\n  }),\n\n  LineChart: z.object({\n    data: z.array(\n      z.union([\n        z.object({\n          x: z.union([z.string(), z.number()]),\n          y: z.number(),\n          label: z.string().optional(),\n          value: z.number().optional(),\n        }),\n        z.object({\n          label: z.string(),\n          value: z.number(),\n          x: z.union([z.string(), z.number()]).optional(),\n          y: z.number().optional(),\n        }),\n      ]),\n    ),\n    title: z.string().optional(),\n    xLabel: z.string().optional(),\n    yLabel: z.string().optional(),\n  }),\n\n  PieChart: z.object({\n    data: z.array(z.object({ label: z.string(), value: z.number() })),\n    title: z.string().optional(),\n    donut: z.boolean().default(false),\n  }),\n\n  AreaChart: z.object({\n    data: z.array(z.object({ x: z.union([z.string(), z.number()]), y: z.number() })),\n    title: z.string().optional(),\n    stacked: z.boolean().default(false),\n  }),\n\n  // Metrics\n  MetricCard: z.object({\n    label: z.string(),\n    value: z.string(),\n    trend: z.enum(['up', 'down', 'stable']).optional(),\n    trendValue: z.string().optional(),\n    sentiment: z.enum(['positive', 'negative', 'neutral', 'warning']).default('neutral'),\n  }),\n\n  ProgressBar: z.object({\n    label: z.string(),\n    value: z.number().min(0).max(100),\n    max: z.number().min(1).default(100),\n    variant: z.enum(['default', 'success', 'warning', 'error']).default('default'),\n  }),\n\n  StatGroup: z.object({\n    stats: z.array(z.object({ label: z.string(), value: z.string() })),\n  }),\n\n  // Actions\n  CallToAction: z.object({\n    label: z.string(),\n    description: z.string().optional(),\n    action: z.string(),\n    variant: z.enum(['primary', 'secondary', 'outline']).default('primary'),\n  }),\n\n  // Feedback\n  Alert: z.object({\n    title: z.string(),\n    description: z.string().optional(),\n    severity: z.enum(['info', 'success', 'warning', 'error']).default('info'),\n  }),\n\n  StatusBadge: z.object({\n    label: z.string(),\n    status: z.enum(['online', 'offline', 'busy', 'away', 'error']),\n  }),\n} as const satisfies Record<string, z.ZodType>;\n\n/** Component name union type derived from the schema registry. */\nexport type RegisteredComponentName = keyof typeof BASE_COMPONENT_SCHEMAS;\n\n// ---------------------------------------------------------------------------\n// Registry\n// ---------------------------------------------------------------------------\n\n/**\n * Runtime component registry for prop validation.\n *\n * Wraps Zod schemas and provides parse/safeParse/lookup methods for\n * validating AI-generated component props before rendering.\n */\nexport interface ComponentRegistry {\n  /**\n   * Parse and validate props for a component. Returns validated props or throws.\n   *\n   * @param componentName - PascalCase component name from the catalog.\n   * @param rawProps - Raw props object from AI output.\n   * @returns Validated props with defaults applied.\n   * @throws {Error} If the component is unknown.\n   * @throws {z.ZodError} If props fail validation.\n   */\n  parseProps(componentName: string, rawProps: unknown): Record<string, unknown>;\n\n  /**\n   * Safe parse that returns a result object instead of throwing.\n   *\n   * @param componentName - PascalCase component name from the catalog.\n   * @param rawProps - Raw props object from AI output.\n   * @returns Result with `success`, `data` (on success), or `error` (on failure).\n   */\n  safeParseProps(\n    componentName: string,\n    rawProps: unknown,\n  ): {\n    success: boolean;\n    data?: Record<string, unknown>;\n    error?: z.ZodError;\n  };\n\n  /**\n   * Check if a component is registered.\n   *\n   * @param name - Component name to look up.\n   * @returns `true` if the component has a registered schema.\n   */\n  hasComponent(name: string): boolean;\n\n  /**\n   * Get all registered component names.\n   *\n   * @returns Readonly array of component names.\n   */\n  getComponentNames(): readonly string[];\n}\n\n/**\n * Creates a component registry from Zod schemas.\n *\n * @param schemas - Map of component name → Zod schema.\n * @returns ComponentRegistry instance.\n *\n * @example\n * ```ts\n * const registry = createComponentRegistry(BASE_COMPONENT_SCHEMAS);\n *\n * // Validate props from AI output\n * const props = registry.parseProps('MetricCard', {\n *   label: 'Revenue',\n *   value: '$1.2M',\n *   trend: 'up',\n * });\n * ```\n */\nexport function createComponentRegistry(schemas: Record<string, z.ZodType>): ComponentRegistry {\n  const schemaMap = new Map(Object.entries(schemas));\n\n  return {\n    parseProps(componentName: string, rawProps: unknown): Record<string, unknown> {\n      const schema = schemaMap.get(componentName);\n      if (!schema) {\n        throw new Error(\n          `Unknown component: '${componentName}'. Registered: ${[...schemaMap.keys()].join(', ')}`,\n        );\n      }\n      return schema.parse(rawProps) as Record<string, unknown>;\n    },\n\n    safeParseProps(componentName: string, rawProps: unknown) {\n      const schema = schemaMap.get(componentName);\n      if (!schema) {\n        return {\n          success: false,\n          error: new z.ZodError([\n            {\n              code: 'custom',\n              path: ['type'],\n              message: `Unknown component: '${componentName}'`,\n            },\n          ]),\n        };\n      }\n\n      const result = schema.safeParse(rawProps);\n      if (result.success) {\n        return { success: true, data: result.data as Record<string, unknown> };\n      }\n      return { success: false, error: result.error };\n    },\n\n    hasComponent(name: string): boolean {\n      return schemaMap.has(name);\n    },\n\n    getComponentNames(): readonly string[] {\n      return [...schemaMap.keys()];\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/generative-ui-stream.d.mts

@@ -0,0 +1,23 @@
+import { l as UserTier } from "./index-URlW7aD1.mjs";
+import { EnterpriseCatalog, GenerativeUIStreamConfig, UITree } from "./generative-ui-types.mjs";
+import "server-only";
+
+//#region src/generative-ui/stream.d.ts
+interface GenerativeUIStreamOutput {
+  readonly systemPrompt: string;
+  logAudit(finalTree: UITree, usage: {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+  }, promptHash: string): Promise<void>;
+}
+declare function createGenerativeUIStreamConfig(config: GenerativeUIStreamConfig): GenerativeUIStreamOutput;
+declare function validatePartialTree(partialTree: Partial<UITree>, catalog: EnterpriseCatalog, _tier: UserTier): {
+  tree: Partial<UITree>;
+  warnings: string[];
+};
+declare const GENERATIVE_UI_BUDGET_MULTIPLIER = 2.5;
+declare function estimateGenerativeUICost(componentCount: number, modelId?: string): number;
+//#endregion
+export { GENERATIVE_UI_BUDGET_MULTIPLIER, GenerativeUIStreamOutput, createGenerativeUIStreamConfig, estimateGenerativeUICost, validatePartialTree };
+//# sourceMappingURL=generative-ui-stream.d.mts.map

package/dist/generative-ui-stream.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generative-ui-stream.d.mts","names":[],"sources":["../src/generative-ui/stream.ts"],"mappings":";;;;;UA2IiB,wBAAA;EAAA,SAEN,YAAA;EAUT,QAAA,CACE,SAAA,EAAW,MAAA,EACX,KAAA;IAAS,YAAA;IAAsB,gBAAA;IAA0B,WAAA;EAAA,GACzD,UAAA,WACC,OAAA;AAAA;AAAA,iBAkCW,8BAAA,CACd,MAAA,EAAQ,wBAAA,GACP,wBAAA;AAAA,iBA+Ea,mBAAA,CACd,WAAA,EAAa,OAAA,CAAQ,MAAA,GACrB,OAAA,EAAS,iBAAA,EACT,KAAA,EAAO,QAAA;EACJ,IAAA,EAAM,OAAA,CAAQ,MAAA;EAAS,QAAA;AAAA;AAAA,cAwBf,+BAAA;AAAA,iBASG,wBAAA,CACd,cAAA,UACA,OAAA"}