@seed-ship/mcp-ui-solid 1.2.1 → 1.2.2

package/dist/services/component-registry.cjs

@@ -281,13 +281,223 @@ const TextRegistry = {
     // 1s
   }
 };
+const GridRegistry = {
+  type: "grid",
+  name: "GridLayout",
+  description: "Nested CSS Grid layout for organizing multiple components. Supports named areas, responsive columns (1-12), and custom gap spacing. Best for complex dashboard layouts and template builder.",
+  schema: {
+    type: "object",
+    properties: {
+      columns: {
+        type: "number",
+        description: "Number of columns (default: 12)"
+      },
+      gap: {
+        type: "string",
+        description: 'Gap between items (e.g., "1rem")'
+      },
+      minRowHeight: {
+        type: "string",
+        description: "Minimum row height (optional)"
+      },
+      areas: {
+        type: "array",
+        items: {
+          type: "array",
+          items: { type: "string" }
+        },
+        description: "CSS Grid template areas for named regions"
+      },
+      children: {
+        type: "array",
+        items: { type: "object" },
+        description: "Child UIComponents to render within the grid"
+      }
+    },
+    required: ["children"]
+  },
+  examples: [],
+  limits: validation.DEFAULT_RESOURCE_LIMITS
+};
+const ActionRegistry = {
+  type: "action",
+  name: "ActionButton",
+  description: "Interactive button or link that triggers tool calls or navigation. Best for user interactions, form submissions, and workflow triggers.",
+  schema: {
+    type: "object",
+    properties: {
+      label: {
+        type: "string",
+        description: "Button text"
+      },
+      type: {
+        type: "string",
+        enum: ["button", "link"],
+        description: "Render as button or link"
+      },
+      action: {
+        type: "string",
+        enum: ["tool-call", "link", "submit"],
+        description: "Action type to perform"
+      },
+      toolName: {
+        type: "string",
+        description: "Tool name to call (for tool-call action)"
+      },
+      params: {
+        type: "object",
+        description: "Parameters to pass to the tool"
+      },
+      url: {
+        type: "string",
+        description: "URL for link action"
+      },
+      variant: {
+        type: "string",
+        enum: ["primary", "secondary", "outline", "ghost", "danger"],
+        description: "Visual style variant"
+      },
+      size: {
+        type: "string",
+        enum: ["sm", "md", "lg"],
+        description: "Button size"
+      },
+      disabled: {
+        type: "boolean",
+        description: "Whether the action is disabled"
+      }
+    },
+    required: ["label", "type", "action"]
+  },
+  examples: [],
+  limits: validation.DEFAULT_RESOURCE_LIMITS
+};
+const FooterRegistry = {
+  type: "footer",
+  name: "FooterSection",
+  description: "Footer section displaying execution metadata. Best for showing timing, model info, and source counts. Auto-injected by layouts when metadata is provided.",
+  schema: {
+    type: "object",
+    properties: {
+      poweredBy: {
+        type: "string",
+        description: "Powered by text (optional)"
+      },
+      executionTime: {
+        type: "number",
+        description: "Execution time in milliseconds"
+      },
+      model: {
+        type: "string",
+        description: "LLM model used"
+      },
+      sourceCount: {
+        type: "number",
+        description: "Number of sources used"
+      },
+      customText: {
+        type: "string",
+        description: "Custom footer text"
+      },
+      links: {
+        type: "array",
+        items: {
+          type: "object",
+          properties: {
+            label: { type: "string" },
+            url: { type: "string" }
+          }
+        },
+        description: "Footer links"
+      }
+    }
+  },
+  examples: [],
+  limits: {
+    maxDataPoints: 1,
+    maxTableRows: 1,
+    maxPayloadSize: 5 * 1024,
+    renderTimeout: 1e3
+  }
+};
+const CarouselRegistry = {
+  type: "carousel",
+  name: "Carousel",
+  description: "Horizontal carousel for displaying multiple items with snap scrolling and navigation buttons. Best for showcasing related content, image galleries, or card collections.",
+  schema: {
+    type: "object",
+    properties: {
+      items: {
+        type: "array",
+        items: { type: "object" },
+        description: "Array of UIComponents to display in carousel"
+      },
+      height: {
+        type: "string",
+        description: "Carousel height (optional)"
+      }
+    },
+    required: ["items"]
+  },
+  examples: [],
+  limits: validation.DEFAULT_RESOURCE_LIMITS
+};
+const ArtifactRegistry = {
+  type: "artifact",
+  name: "Artifact",
+  description: "Display downloadable artifacts like generated files or exports. Shows filename, size, and download button. Best for CSV exports, PDF reports, and generated documents.",
+  schema: {
+    type: "object",
+    properties: {
+      url: {
+        type: "string",
+        description: "Download URL for the artifact"
+      },
+      filename: {
+        type: "string",
+        description: "Display filename"
+      },
+      mimeType: {
+        type: "string",
+        description: 'MIME type (e.g., "text/csv", "application/pdf")'
+      },
+      size: {
+        type: "number",
+        description: "File size in bytes"
+      },
+      description: {
+        type: "string",
+        description: "Description of the artifact"
+      }
+    },
+    required: ["url", "filename", "mimeType"]
+  },
+  examples: [],
+  limits: {
+    maxDataPoints: 1,
+    maxTableRows: 1,
+    maxPayloadSize: 5 * 1024,
+    renderTimeout: 1e3
+  }
+};
 const ComponentRegistry = /* @__PURE__ */ new Map([
   ["chart", QuickchartRegistry],
   ["table", TableRegistry],
   ["metric", MetricRegistry],
-  ["text", TextRegistry]
+  ["text", TextRegistry],
+  // Sprint 4 additions
+  ["grid", GridRegistry],
+  ["action", ActionRegistry],
+  ["footer", FooterRegistry],
+  ["carousel", CarouselRegistry],
+  ["artifact", ArtifactRegistry]
 ]);
+exports.ActionRegistry = ActionRegistry;
+exports.ArtifactRegistry = ArtifactRegistry;
+exports.CarouselRegistry = CarouselRegistry;
 exports.ComponentRegistry = ComponentRegistry;
+exports.FooterRegistry = FooterRegistry;
+exports.GridRegistry = GridRegistry;
 exports.MetricRegistry = MetricRegistry;
 exports.QuickchartRegistry = QuickchartRegistry;
 exports.TableRegistry = TableRegistry;

package/dist/services/component-registry.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"component-registry.cjs","sources":["../../src/services/component-registry.ts"],"sourcesContent":["/**\n * Component Registry Service\n * Phase 0: Static registry with Quickchart and Table definitions\n * Phase 1: Dynamic registry populated from /api/mcp/tools/list\n *\n * Provides component schemas for LLM prompt engineering\n */\n\nimport type { ComponentRegistryEntry, ComponentType } from '../types'\nimport { DEFAULT_RESOURCE_LIMITS } from './validation'\n\n/**\n * Quickchart Component Registry Entry\n * Based on Quickchart API documentation\n */\nexport const QuickchartRegistry: ComponentRegistryEntry = {\n  type: 'chart',\n  name: 'Quickchart',\n  description:\n    'Render charts using Quickchart.io API. Supports bar, line, pie, doughnut, radar, and scatter charts. Best for visualizing numerical data with 2-10 data series and up to 1000 data points.',\n  schema: {\n    type: 'object',\n    properties: {\n      type: {\n        type: 'string',\n        enum: ['bar', 'line', 'pie', 'doughnut', 'radar', 'scatter'],\n        description: 'Chart type',\n      },\n      title: {\n        type: 'string',\n        description: 'Chart title (optional)',\n      },\n      data: {\n        type: 'object',\n        properties: {\n          labels: {\n            type: 'array',\n            items: { type: 'string' },\n            description: 'X-axis labels',\n          },\n          datasets: {\n            type: 'array',\n            items: {\n              type: 'object',\n              properties: {\n                label: { type: 'string' },\n                data: {\n                  type: 'array',\n                  items: { type: 'number' },\n                },\n                backgroundColor: {\n                  oneOf: [{ type: 'string' }, { type: 'array', items: { type: 'string' } }],\n                },\n                borderColor: {\n                  oneOf: [{ type: 'string' }, { type: 'array', items: { type: 'string' } }],\n                },\n                borderWidth: { type: 'number' },\n              },\n              required: ['label', 'data'],\n            },\n          },\n        },\n        required: ['labels', 'datasets'],\n      },\n      options: {\n        type: 'object',\n        description: 'Chart.js options for customization',\n      },\n    },\n    required: ['type', 'data'],\n  },\n  examples: [\n    {\n      query: 'Show me document types distribution',\n      component: {\n        id: 'example-bar-1',\n        type: 'chart',\n        position: { colStart: 1, colSpan: 6 },\n        params: {\n          type: 'bar',\n          title: 'Document Types',\n          data: {\n            labels: ['PDF', 'DOCX', 'TXT', 'XLSX'],\n            datasets: [\n              {\n                label: 'Count',\n                data: [245, 189, 123, 98],\n                backgroundColor: ['rgba(59, 130, 246, 0.8)'],\n              },\n            ],\n          },\n        },\n      },\n    },\n    {\n      query: 'Display upload trends over the last week',\n      component: {\n        id: 'example-line-1',\n        type: 'chart',\n        position: { colStart: 1, colSpan: 6 },\n        params: {\n          type: 'line',\n          title: 'Upload Trends',\n          data: {\n            labels: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun'],\n            datasets: [\n              {\n                label: 'Uploads',\n                data: [42, 38, 51, 47, 63, 29, 15],\n                borderColor: 'rgb(59, 130, 246)',\n              },\n            ],\n          },\n          options: {\n            tension: 0.4,\n          },\n        },\n      },\n    },\n  ],\n  limits: DEFAULT_RESOURCE_LIMITS,\n}\n\n/**\n * Table Component Registry Entry\n */\nexport const TableRegistry: ComponentRegistryEntry = {\n  type: 'table',\n  name: 'DataTable',\n  description:\n    'Render tabular data with sortable columns and pagination. Best for displaying structured records with up to 100 rows. Supports column width customization and cell formatting.',\n  schema: {\n    type: 'object',\n    properties: {\n      title: {\n        type: 'string',\n        description: 'Table title (optional)',\n      },\n      columns: {\n        type: 'array',\n        items: {\n          type: 'object',\n          properties: {\n            key: { type: 'string', description: 'Data key for this column' },\n            label: { type: 'string', description: 'Column header label' },\n            sortable: { type: 'boolean', description: 'Whether column is sortable' },\n            width: { type: 'string', description: 'CSS width (e.g., \"30%\")' },\n          },\n          required: ['key', 'label'],\n        },\n        minItems: 1,\n      },\n      rows: {\n        type: 'array',\n        items: {\n          type: 'object',\n          description: 'Row data matching column keys',\n        },\n        maxItems: 100,\n      },\n      pagination: {\n        type: 'object',\n        properties: {\n          currentPage: { type: 'number' },\n          pageSize: { type: 'number' },\n          totalRows: { type: 'number' },\n        },\n      },\n    },\n    required: ['columns', 'rows'],\n  },\n  examples: [\n    {\n      query: 'Show me the most recent documents',\n      component: {\n        id: 'example-table-1',\n        type: 'table',\n        position: { colStart: 1, colSpan: 8 },\n        params: {\n          title: 'Recent Documents',\n          columns: [\n            { key: 'name', label: 'Name', sortable: true, width: '40%' },\n            { key: 'type', label: 'Type', sortable: true, width: '15%' },\n            { key: 'size', label: 'Size', width: '15%' },\n            { key: 'modified', label: 'Modified', sortable: true, width: '30%' },\n          ],\n          rows: [\n            { name: 'Report.pdf', type: 'PDF', size: '2.4 MB', modified: '2 hours ago' },\n            { name: 'Slides.pptx', type: 'PPTX', size: '8.7 MB', modified: '1 day ago' },\n          ],\n        },\n      },\n    },\n  ],\n  limits: DEFAULT_RESOURCE_LIMITS,\n}\n\n/**\n * Metric Card Component Registry Entry\n */\nexport const MetricRegistry: ComponentRegistryEntry = {\n  type: 'metric',\n  name: 'MetricCard',\n  description:\n    'Display a single metric with optional trend indicator. Best for KPIs, statistics, and summary numbers. Supports trend direction (up/down/neutral) and subtitles.',\n  schema: {\n    type: 'object',\n    properties: {\n      title: {\n        type: 'string',\n        description: 'Metric title',\n      },\n      value: {\n        oneOf: [{ type: 'string' }, { type: 'number' }],\n        description: 'Metric value',\n      },\n      unit: {\n        type: 'string',\n        description: 'Unit of measurement (optional)',\n      },\n      trend: {\n        type: 'object',\n        properties: {\n          value: { type: 'number', description: 'Percentage change' },\n          direction: { type: 'string', enum: ['up', 'down', 'neutral'] },\n        },\n      },\n      subtitle: {\n        type: 'string',\n        description: 'Additional context (optional)',\n      },\n    },\n    required: ['title', 'value'],\n  },\n  examples: [\n    {\n      query: 'Show total document count',\n      component: {\n        id: 'example-metric-1',\n        type: 'metric',\n        position: { colStart: 1, colSpan: 3 },\n        params: {\n          title: 'Total Documents',\n          value: '1,247',\n          trend: {\n            value: 12.5,\n            direction: 'up',\n          },\n          subtitle: '+142 this month',\n        },\n      },\n    },\n  ],\n  limits: {\n    maxDataPoints: 1,\n    maxTableRows: 1,\n    maxPayloadSize: 5 * 1024, // 5KB\n    renderTimeout: 1000, // 1s\n  },\n}\n\n/**\n * Text Component Registry Entry\n */\nexport const TextRegistry: ComponentRegistryEntry = {\n  type: 'text',\n  name: 'TextBlock',\n  description:\n    'Render text content with optional markdown support. Best for explanations, summaries, and context. Supports basic HTML formatting.',\n  schema: {\n    type: 'object',\n    properties: {\n      content: {\n        type: 'string',\n        description: 'Text content (HTML allowed, will be sanitized)',\n      },\n      markdown: {\n        type: 'boolean',\n        description: 'Whether content is markdown (not yet implemented)',\n      },\n      className: {\n        type: 'string',\n        description: 'Custom CSS classes',\n      },\n    },\n    required: ['content'],\n  },\n  examples: [\n    {\n      query: 'Explain the document distribution',\n      component: {\n        id: 'example-text-1',\n        type: 'text',\n        position: { colStart: 1, colSpan: 12 },\n        params: {\n          content:\n            '<p>Your document library contains <strong>1,247 files</strong> across 5 different formats. PDFs represent the largest category at 35% of total storage.</p>',\n        },\n      },\n    },\n  ],\n  limits: {\n    maxDataPoints: 1,\n    maxTableRows: 1,\n    maxPayloadSize: 10 * 1024, // 10KB\n    renderTimeout: 1000, // 1s\n  },\n}\n\n/**\n * Component Registry - All components indexed by type\n */\nexport const ComponentRegistry: Map<ComponentType, ComponentRegistryEntry> = new Map([\n  ['chart', QuickchartRegistry],\n  ['table', TableRegistry],\n  ['metric', MetricRegistry],\n  ['text', TextRegistry],\n])\n\n/**\n * Get component registry entry by type\n */\nexport function getComponentEntry(type: ComponentType): ComponentRegistryEntry | undefined {\n  return ComponentRegistry.get(type)\n}\n\n/**\n * Get all component types\n */\nexport function getAllComponentTypes(): ComponentType[] {\n  return Array.from(ComponentRegistry.keys())\n}\n\n/**\n * Get registry as JSON for LLM context\n */\nexport function getRegistryForLLM(): string {\n  const entries = Array.from(ComponentRegistry.values()).map((entry) => ({\n    type: entry.type,\n    name: entry.name,\n    description: entry.description,\n    schema: entry.schema,\n    examples: entry.examples.map((ex) => ({\n      query: ex.query,\n      component: ex.component,\n    })),\n    limits: entry.limits,\n  }))\n\n  return JSON.stringify(entries, null, 2)\n}\n\n/**\n * Validate component against registry schema\n * (Future: Use Zod for runtime validation)\n */\nexport function validateAgainstRegistry(\n  componentType: ComponentType,\n  params: any\n): { valid: boolean; errors?: string[] } {\n  const entry = getComponentEntry(componentType)\n  if (!entry) {\n    return { valid: false, errors: [`Unknown component type: ${componentType}`] }\n  }\n\n  // Basic validation (Phase 1 will add Zod schema validation)\n  const required = entry.schema.required || []\n  const missing = required.filter((key: string) => !(key in params))\n\n  if (missing.length > 0) {\n    return {\n      valid: false,\n      errors: missing.map((key: string) => `Missing required field: ${key}`),\n    }\n  }\n\n  return { valid: true }\n}\n"],"names":["DEFAULT_RESOURCE_LIMITS"],"mappings":";;;AAeO,MAAM,qBAA6C;AAAA,EACxD,MAAM;AAAA,EACN,MAAM;AAAA,EACN,aACE;AAAA,EACF,QAAQ;AAAA,IACN,MAAM;AAAA,IACN,YAAY;AAAA,MACV,MAAM;AAAA,QACJ,MAAM;AAAA,QACN,MAAM,CAAC,OAAO,QAAQ,OAAO,YAAY,SAAS,SAAS;AAAA,QAC3D,aAAa;AAAA,MAAA;AAAA,MAEf,OAAO;AAAA,QACL,MAAM;AAAA,QACN,aAAa;AAAA,MAAA;AAAA,MAEf,MAAM;AAAA,QACJ,MAAM;AAAA,QACN,YAAY;AAAA,UACV,QAAQ;AAAA,YACN,MAAM;AAAA,YACN,OAAO,EAAE,MAAM,SAAA;AAAA,YACf,aAAa;AAAA,UAAA;AAAA,UAEf,UAAU;AAAA,YACR,MAAM;AAAA,YACN,OAAO;AAAA,cACL,MAAM;AAAA,cACN,YAAY;AAAA,gBACV,OAAO,EAAE,MAAM,SAAA;AAAA,gBACf,MAAM;AAAA,kBACJ,MAAM;AAAA,kBACN,OAAO,EAAE,MAAM,SAAA;AAAA,gBAAS;AAAA,gBAE1B,iBAAiB;AAAA,kBACf,OAAO,CAAC,EAAE,MAAM,YAAY,EAAE,MAAM,SAAS,OAAO,EAAE,MAAM,SAAA,GAAY;AAAA,gBAAA;AAAA,gBAE1E,aAAa;AAAA,kBACX,OAAO,CAAC,EAAE,MAAM,YAAY,EAAE,MAAM,SAAS,OAAO,EAAE,MAAM,SAAA,GAAY;AAAA,gBAAA;AAAA,gBAE1E,aAAa,EAAE,MAAM,SAAA;AAAA,cAAS;AAAA,cAEhC,UAAU,CAAC,SAAS,MAAM;AAAA,YAAA;AAAA,UAC5B;AAAA,QACF;AAAA,QAEF,UAAU,CAAC,UAAU,UAAU;AAAA,MAAA;AAAA,MAEjC,SAAS;AAAA,QACP,MAAM;AAAA,QACN,aAAa;AAAA,MAAA;AAAA,IACf;AAAA,IAEF,UAAU,CAAC,QAAQ,MAAM;AAAA,EAAA;AAAA,EAE3B,UAAU;AAAA,IACR;AAAA,MACE,OAAO;AAAA,MACP,WAAW;AAAA,QACT,IAAI;AAAA,QACJ,MAAM;AAAA,QACN,UAAU,EAAE,UAAU,GAAG,SAAS,EAAA;AAAA,QAClC,QAAQ;AAAA,UACN,MAAM;AAAA,UACN,OAAO;AAAA,UACP,MAAM;AAAA,YACJ,QAAQ,CAAC,OAAO,QAAQ,OAAO,MAAM;AAAA,YACrC,UAAU;AAAA,cACR;AAAA,gBACE,OAAO;AAAA,gBACP,MAAM,CAAC,KAAK,KAAK,KAAK,EAAE;AAAA,gBACxB,iBAAiB,CAAC,yBAAyB;AAAA,cAAA;AAAA,YAC7C;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,IAEF;AAAA,MACE,OAAO;AAAA,MACP,WAAW;AAAA,QACT,IAAI;AAAA,QACJ,MAAM;AAAA,QACN,UAAU,EAAE,UAAU,GAAG,SAAS,EAAA;AAAA,QAClC,QAAQ;AAAA,UACN,MAAM;AAAA,UACN,OAAO;AAAA,UACP,MAAM;AAAA,YACJ,QAAQ,CAAC,OAAO,OAAO,OAAO,OAAO,OAAO,OAAO,KAAK;AAAA,YACxD,UAAU;AAAA,cACR;AAAA,gBACE,OAAO;AAAA,gBACP,MAAM,CAAC,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,EAAE;AAAA,gBACjC,aAAa;AAAA,cAAA;AAAA,YACf;AAAA,UACF;AAAA,UAEF,SAAS;AAAA,YACP,SAAS;AAAA,UAAA;AAAA,QACX;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EAEF,QAAQA,WAAAA;AACV;AAKO,MAAM,gBAAwC;AAAA,EACnD,MAAM;AAAA,EACN,MAAM;AAAA,EACN,aACE;AAAA,EACF,QAAQ;AAAA,IACN,MAAM;AAAA,IACN,YAAY;AAAA,MACV,OAAO;AAAA,QACL,MAAM;AAAA,QACN,aAAa;AAAA,MAAA;AAAA,MAEf,SAAS;AAAA,QACP,MAAM;AAAA,QACN,OAAO;AAAA,UACL,MAAM;AAAA,UACN,YAAY;AAAA,YACV,KAAK,EAAE,MAAM,UAAU,aAAa,2BAAA;AAAA,YACpC,OAAO,EAAE,MAAM,UAAU,aAAa,sBAAA;AAAA,YACtC,UAAU,EAAE,MAAM,WAAW,aAAa,6BAAA;AAAA,YAC1C,OAAO,EAAE,MAAM,UAAU,aAAa,0BAAA;AAAA,UAA0B;AAAA,UAElE,UAAU,CAAC,OAAO,OAAO;AAAA,QAAA;AAAA,QAE3B,UAAU;AAAA,MAAA;AAAA,MAEZ,MAAM;AAAA,QACJ,MAAM;AAAA,QACN,OAAO;AAAA,UACL,MAAM;AAAA,UACN,aAAa;AAAA,QAAA;AAAA,QAEf,UAAU;AAAA,MAAA;AAAA,MAEZ,YAAY;AAAA,QACV,MAAM;AAAA,QACN,YAAY;AAAA,UACV,aAAa,EAAE,MAAM,SAAA;AAAA,UACrB,UAAU,EAAE,MAAM,SAAA;AAAA,UAClB,WAAW,EAAE,MAAM,SAAA;AAAA,QAAS;AAAA,MAC9B;AAAA,IACF;AAAA,IAEF,UAAU,CAAC,WAAW,MAAM;AAAA,EAAA;AAAA,EAE9B,UAAU;AAAA,IACR;AAAA,MACE,OAAO;AAAA,MACP,WAAW;AAAA,QACT,IAAI;AAAA,QACJ,MAAM;AAAA,QACN,UAAU,EAAE,UAAU,GAAG,SAAS,EAAA;AAAA,QAClC,QAAQ;AAAA,UACN,OAAO;AAAA,UACP,SAAS;AAAA,YACP,EAAE,KAAK,QAAQ,OAAO,QAAQ,UAAU,MAAM,OAAO,MAAA;AAAA,YACrD,EAAE,KAAK,QAAQ,OAAO,QAAQ,UAAU,MAAM,OAAO,MAAA;AAAA,YACrD,EAAE,KAAK,QAAQ,OAAO,QAAQ,OAAO,MAAA;AAAA,YACrC,EAAE,KAAK,YAAY,OAAO,YAAY,UAAU,MAAM,OAAO,MAAA;AAAA,UAAM;AAAA,UAErE,MAAM;AAAA,YACJ,EAAE,MAAM,cAAc,MAAM,OAAO,MAAM,UAAU,UAAU,cAAA;AAAA,YAC7D,EAAE,MAAM,eAAe,MAAM,QAAQ,MAAM,UAAU,UAAU,YAAA;AAAA,UAAY;AAAA,QAC7E;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EAEF,QAAQA,WAAAA;AACV;AAKO,MAAM,iBAAyC;AAAA,EACpD,MAAM;AAAA,EACN,MAAM;AAAA,EACN,aACE;AAAA,EACF,QAAQ;AAAA,IACN,MAAM;AAAA,IACN,YAAY;AAAA,MACV,OAAO;AAAA,QACL,MAAM;AAAA,QACN,aAAa;AAAA,MAAA;AAAA,MAEf,OAAO;AAAA,QACL,OAAO,CAAC,EAAE,MAAM,YAAY,EAAE,MAAM,UAAU;AAAA,QAC9C,aAAa;AAAA,MAAA;AAAA,MAEf,MAAM;AAAA,QACJ,MAAM;AAAA,QACN,aAAa;AAAA,MAAA;AAAA,MAEf,OAAO;AAAA,QACL,MAAM;AAAA,QACN,YAAY;AAAA,UACV,OAAO,EAAE,MAAM,UAAU,aAAa,oBAAA;AAAA,UACtC,WAAW,EAAE,MAAM,UAAU,MAAM,CAAC,MAAM,QAAQ,SAAS,EAAA;AAAA,QAAE;AAAA,MAC/D;AAAA,MAEF,UAAU;AAAA,QACR,MAAM;AAAA,QACN,aAAa;AAAA,MAAA;AAAA,IACf;AAAA,IAEF,UAAU,CAAC,SAAS,OAAO;AAAA,EAAA;AAAA,EAE7B,UAAU;AAAA,IACR;AAAA,MACE,OAAO;AAAA,MACP,WAAW;AAAA,QACT,IAAI;AAAA,QACJ,MAAM;AAAA,QACN,UAAU,EAAE,UAAU,GAAG,SAAS,EAAA;AAAA,QAClC,QAAQ;AAAA,UACN,OAAO;AAAA,UACP,OAAO;AAAA,UACP,OAAO;AAAA,YACL,OAAO;AAAA,YACP,WAAW;AAAA,UAAA;AAAA,UAEb,UAAU;AAAA,QAAA;AAAA,MACZ;AAAA,IACF;AAAA,EACF;AAAA,EAEF,QAAQ;AAAA,IACN,eAAe;AAAA,IACf,cAAc;AAAA,IACd,gBAAgB,IAAI;AAAA;AAAA,IACpB,eAAe;AAAA;AAAA,EAAA;AAEnB;AAKO,MAAM,eAAuC;AAAA,EAClD,MAAM;AAAA,EACN,MAAM;AAAA,EACN,aACE;AAAA,EACF,QAAQ;AAAA,IACN,MAAM;AAAA,IACN,YAAY;AAAA,MACV,SAAS;AAAA,QACP,MAAM;AAAA,QACN,aAAa;AAAA,MAAA;AAAA,MAEf,UAAU;AAAA,QACR,MAAM;AAAA,QACN,aAAa;AAAA,MAAA;AAAA,MAEf,WAAW;AAAA,QACT,MAAM;AAAA,QACN,aAAa;AAAA,MAAA;AAAA,IACf;AAAA,IAEF,UAAU,CAAC,SAAS;AAAA,EAAA;AAAA,EAEtB,UAAU;AAAA,IACR;AAAA,MACE,OAAO;AAAA,MACP,WAAW;AAAA,QACT,IAAI;AAAA,QACJ,MAAM;AAAA,QACN,UAAU,EAAE,UAAU,GAAG,SAAS,GAAA;AAAA,QAClC,QAAQ;AAAA,UACN,SACE;AAAA,QAAA;AAAA,MACJ;AAAA,IACF;AAAA,EACF;AAAA,EAEF,QAAQ;AAAA,IACN,eAAe;AAAA,IACf,cAAc;AAAA,IACd,gBAAgB,KAAK;AAAA;AAAA,IACrB,eAAe;AAAA;AAAA,EAAA;AAEnB;AAKO,MAAM,wCAAoE,IAAI;AAAA,EACnF,CAAC,SAAS,kBAAkB;AAAA,EAC5B,CAAC,SAAS,aAAa;AAAA,EACvB,CAAC,UAAU,cAAc;AAAA,EACzB,CAAC,QAAQ,YAAY;AACvB,CAAC;;;;;;"}
+{"version":3,"file":"component-registry.cjs","sources":["../../src/services/component-registry.ts"],"sourcesContent":["/**\n * Component Registry Service\n * Phase 0: Static registry with Quickchart and Table definitions\n * Phase 1: Dynamic registry populated from /api/mcp/tools/list\n *\n * Provides component schemas for LLM prompt engineering\n */\n\nimport type { ComponentRegistryEntry, ComponentType } from '../types'\nimport { DEFAULT_RESOURCE_LIMITS } from './validation'\n\n/**\n * Quickchart Component Registry Entry\n * Based on Quickchart API documentation\n */\nexport const QuickchartRegistry: ComponentRegistryEntry = {\n  type: 'chart',\n  name: 'Quickchart',\n  description:\n    'Render charts using Quickchart.io API. Supports bar, line, pie, doughnut, radar, and scatter charts. Best for visualizing numerical data with 2-10 data series and up to 1000 data points.',\n  schema: {\n    type: 'object',\n    properties: {\n      type: {\n        type: 'string',\n        enum: ['bar', 'line', 'pie', 'doughnut', 'radar', 'scatter'],\n        description: 'Chart type',\n      },\n      title: {\n        type: 'string',\n        description: 'Chart title (optional)',\n      },\n      data: {\n        type: 'object',\n        properties: {\n          labels: {\n            type: 'array',\n            items: { type: 'string' },\n            description: 'X-axis labels',\n          },\n          datasets: {\n            type: 'array',\n            items: {\n              type: 'object',\n              properties: {\n                label: { type: 'string' },\n                data: {\n                  type: 'array',\n                  items: { type: 'number' },\n                },\n                backgroundColor: {\n                  oneOf: [{ type: 'string' }, { type: 'array', items: { type: 'string' } }],\n                },\n                borderColor: {\n                  oneOf: [{ type: 'string' }, { type: 'array', items: { type: 'string' } }],\n                },\n                borderWidth: { type: 'number' },\n              },\n              required: ['label', 'data'],\n            },\n          },\n        },\n        required: ['labels', 'datasets'],\n      },\n      options: {\n        type: 'object',\n        description: 'Chart.js options for customization',\n      },\n    },\n    required: ['type', 'data'],\n  },\n  examples: [\n    {\n      query: 'Show me document types distribution',\n      component: {\n        id: 'example-bar-1',\n        type: 'chart',\n        position: { colStart: 1, colSpan: 6 },\n        params: {\n          type: 'bar',\n          title: 'Document Types',\n          data: {\n            labels: ['PDF', 'DOCX', 'TXT', 'XLSX'],\n            datasets: [\n              {\n                label: 'Count',\n                data: [245, 189, 123, 98],\n                backgroundColor: ['rgba(59, 130, 246, 0.8)'],\n              },\n            ],\n          },\n        },\n      },\n    },\n    {\n      query: 'Display upload trends over the last week',\n      component: {\n        id: 'example-line-1',\n        type: 'chart',\n        position: { colStart: 1, colSpan: 6 },\n        params: {\n          type: 'line',\n          title: 'Upload Trends',\n          data: {\n            labels: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun'],\n            datasets: [\n              {\n                label: 'Uploads',\n                data: [42, 38, 51, 47, 63, 29, 15],\n                borderColor: 'rgb(59, 130, 246)',\n              },\n            ],\n          },\n          options: {\n            tension: 0.4,\n          },\n        },\n      },\n    },\n  ],\n  limits: DEFAULT_RESOURCE_LIMITS,\n}\n\n/**\n * Table Component Registry Entry\n */\nexport const TableRegistry: ComponentRegistryEntry = {\n  type: 'table',\n  name: 'DataTable',\n  description:\n    'Render tabular data with sortable columns and pagination. Best for displaying structured records with up to 100 rows. Supports column width customization and cell formatting.',\n  schema: {\n    type: 'object',\n    properties: {\n      title: {\n        type: 'string',\n        description: 'Table title (optional)',\n      },\n      columns: {\n        type: 'array',\n        items: {\n          type: 'object',\n          properties: {\n            key: { type: 'string', description: 'Data key for this column' },\n            label: { type: 'string', description: 'Column header label' },\n            sortable: { type: 'boolean', description: 'Whether column is sortable' },\n            width: { type: 'string', description: 'CSS width (e.g., \"30%\")' },\n          },\n          required: ['key', 'label'],\n        },\n        minItems: 1,\n      },\n      rows: {\n        type: 'array',\n        items: {\n          type: 'object',\n          description: 'Row data matching column keys',\n        },\n        maxItems: 100,\n      },\n      pagination: {\n        type: 'object',\n        properties: {\n          currentPage: { type: 'number' },\n          pageSize: { type: 'number' },\n          totalRows: { type: 'number' },\n        },\n      },\n    },\n    required: ['columns', 'rows'],\n  },\n  examples: [\n    {\n      query: 'Show me the most recent documents',\n      component: {\n        id: 'example-table-1',\n        type: 'table',\n        position: { colStart: 1, colSpan: 8 },\n        params: {\n          title: 'Recent Documents',\n          columns: [\n            { key: 'name', label: 'Name', sortable: true, width: '40%' },\n            { key: 'type', label: 'Type', sortable: true, width: '15%' },\n            { key: 'size', label: 'Size', width: '15%' },\n            { key: 'modified', label: 'Modified', sortable: true, width: '30%' },\n          ],\n          rows: [\n            { name: 'Report.pdf', type: 'PDF', size: '2.4 MB', modified: '2 hours ago' },\n            { name: 'Slides.pptx', type: 'PPTX', size: '8.7 MB', modified: '1 day ago' },\n          ],\n        },\n      },\n    },\n  ],\n  limits: DEFAULT_RESOURCE_LIMITS,\n}\n\n/**\n * Metric Card Component Registry Entry\n */\nexport const MetricRegistry: ComponentRegistryEntry = {\n  type: 'metric',\n  name: 'MetricCard',\n  description:\n    'Display a single metric with optional trend indicator. Best for KPIs, statistics, and summary numbers. Supports trend direction (up/down/neutral) and subtitles.',\n  schema: {\n    type: 'object',\n    properties: {\n      title: {\n        type: 'string',\n        description: 'Metric title',\n      },\n      value: {\n        oneOf: [{ type: 'string' }, { type: 'number' }],\n        description: 'Metric value',\n      },\n      unit: {\n        type: 'string',\n        description: 'Unit of measurement (optional)',\n      },\n      trend: {\n        type: 'object',\n        properties: {\n          value: { type: 'number', description: 'Percentage change' },\n          direction: { type: 'string', enum: ['up', 'down', 'neutral'] },\n        },\n      },\n      subtitle: {\n        type: 'string',\n        description: 'Additional context (optional)',\n      },\n    },\n    required: ['title', 'value'],\n  },\n  examples: [\n    {\n      query: 'Show total document count',\n      component: {\n        id: 'example-metric-1',\n        type: 'metric',\n        position: { colStart: 1, colSpan: 3 },\n        params: {\n          title: 'Total Documents',\n          value: '1,247',\n          trend: {\n            value: 12.5,\n            direction: 'up',\n          },\n          subtitle: '+142 this month',\n        },\n      },\n    },\n  ],\n  limits: {\n    maxDataPoints: 1,\n    maxTableRows: 1,\n    maxPayloadSize: 5 * 1024, // 5KB\n    renderTimeout: 1000, // 1s\n  },\n}\n\n/**\n * Text Component Registry Entry\n */\nexport const TextRegistry: ComponentRegistryEntry = {\n  type: 'text',\n  name: 'TextBlock',\n  description:\n    'Render text content with optional markdown support. Best for explanations, summaries, and context. Supports basic HTML formatting.',\n  schema: {\n    type: 'object',\n    properties: {\n      content: {\n        type: 'string',\n        description: 'Text content (HTML allowed, will be sanitized)',\n      },\n      markdown: {\n        type: 'boolean',\n        description: 'Whether content is markdown (not yet implemented)',\n      },\n      className: {\n        type: 'string',\n        description: 'Custom CSS classes',\n      },\n    },\n    required: ['content'],\n  },\n  examples: [\n    {\n      query: 'Explain the document distribution',\n      component: {\n        id: 'example-text-1',\n        type: 'text',\n        position: { colStart: 1, colSpan: 12 },\n        params: {\n          content:\n            '<p>Your document library contains <strong>1,247 files</strong> across 5 different formats. PDFs represent the largest category at 35% of total storage.</p>',\n        },\n      },\n    },\n  ],\n  limits: {\n    maxDataPoints: 1,\n    maxTableRows: 1,\n    maxPayloadSize: 10 * 1024, // 10KB\n    renderTimeout: 1000, // 1s\n  },\n}\n\n// ============================================================================\n// Sprint 4: Additional Component Registry Entries\n// ============================================================================\n\n/**\n * Grid Component Registry Entry\n * Nested CSS Grid layout for organizing multiple components\n */\nexport const GridRegistry: ComponentRegistryEntry = {\n  type: 'grid',\n  name: 'GridLayout',\n  description:\n    'Nested CSS Grid layout for organizing multiple components. Supports named areas, responsive columns (1-12), and custom gap spacing. Best for complex dashboard layouts and template builder.',\n  schema: {\n    type: 'object',\n    properties: {\n      columns: {\n        type: 'number',\n        description: 'Number of columns (default: 12)',\n      },\n      gap: {\n        type: 'string',\n        description: 'Gap between items (e.g., \"1rem\")',\n      },\n      minRowHeight: {\n        type: 'string',\n        description: 'Minimum row height (optional)',\n      },\n      areas: {\n        type: 'array',\n        items: {\n          type: 'array',\n          items: { type: 'string' },\n        },\n        description: 'CSS Grid template areas for named regions',\n      },\n      children: {\n        type: 'array',\n        items: { type: 'object' },\n        description: 'Child UIComponents to render within the grid',\n      },\n    },\n    required: ['children'],\n  },\n  examples: [],\n  limits: DEFAULT_RESOURCE_LIMITS,\n}\n\n/**\n * Action Component Registry Entry\n * Interactive button or link that triggers tool calls\n */\nexport const ActionRegistry: ComponentRegistryEntry = {\n  type: 'action',\n  name: 'ActionButton',\n  description:\n    'Interactive button or link that triggers tool calls or navigation. Best for user interactions, form submissions, and workflow triggers.',\n  schema: {\n    type: 'object',\n    properties: {\n      label: {\n        type: 'string',\n        description: 'Button text',\n      },\n      type: {\n        type: 'string',\n        enum: ['button', 'link'],\n        description: 'Render as button or link',\n      },\n      action: {\n        type: 'string',\n        enum: ['tool-call', 'link', 'submit'],\n        description: 'Action type to perform',\n      },\n      toolName: {\n        type: 'string',\n        description: 'Tool name to call (for tool-call action)',\n      },\n      params: {\n        type: 'object',\n        description: 'Parameters to pass to the tool',\n      },\n      url: {\n        type: 'string',\n        description: 'URL for link action',\n      },\n      variant: {\n        type: 'string',\n        enum: ['primary', 'secondary', 'outline', 'ghost', 'danger'],\n        description: 'Visual style variant',\n      },\n      size: {\n        type: 'string',\n        enum: ['sm', 'md', 'lg'],\n        description: 'Button size',\n      },\n      disabled: {\n        type: 'boolean',\n        description: 'Whether the action is disabled',\n      },\n    },\n    required: ['label', 'type', 'action'],\n  },\n  examples: [],\n  limits: DEFAULT_RESOURCE_LIMITS,\n}\n\n/**\n * Footer Component Registry Entry\n * Display execution metadata like timing and source count\n */\nexport const FooterRegistry: ComponentRegistryEntry = {\n  type: 'footer',\n  name: 'FooterSection',\n  description:\n    'Footer section displaying execution metadata. Best for showing timing, model info, and source counts. Auto-injected by layouts when metadata is provided.',\n  schema: {\n    type: 'object',\n    properties: {\n      poweredBy: {\n        type: 'string',\n        description: 'Powered by text (optional)',\n      },\n      executionTime: {\n        type: 'number',\n        description: 'Execution time in milliseconds',\n      },\n      model: {\n        type: 'string',\n        description: 'LLM model used',\n      },\n      sourceCount: {\n        type: 'number',\n        description: 'Number of sources used',\n      },\n      customText: {\n        type: 'string',\n        description: 'Custom footer text',\n      },\n      links: {\n        type: 'array',\n        items: {\n          type: 'object',\n          properties: {\n            label: { type: 'string' },\n            url: { type: 'string' },\n          },\n        },\n        description: 'Footer links',\n      },\n    },\n  },\n  examples: [],\n  limits: {\n    maxDataPoints: 1,\n    maxTableRows: 1,\n    maxPayloadSize: 5 * 1024,\n    renderTimeout: 1000,\n  },\n}\n\n/**\n * Carousel Component Registry Entry\n * Display multiple items with horizontal scrolling\n */\nexport const CarouselRegistry: ComponentRegistryEntry = {\n  type: 'carousel',\n  name: 'Carousel',\n  description:\n    'Horizontal carousel for displaying multiple items with snap scrolling and navigation buttons. Best for showcasing related content, image galleries, or card collections.',\n  schema: {\n    type: 'object',\n    properties: {\n      items: {\n        type: 'array',\n        items: { type: 'object' },\n        description: 'Array of UIComponents to display in carousel',\n      },\n      height: {\n        type: 'string',\n        description: 'Carousel height (optional)',\n      },\n    },\n    required: ['items'],\n  },\n  examples: [],\n  limits: DEFAULT_RESOURCE_LIMITS,\n}\n\n/**\n * Artifact Component Registry Entry\n * Display downloadable artifacts like generated files\n */\nexport const ArtifactRegistry: ComponentRegistryEntry = {\n  type: 'artifact',\n  name: 'Artifact',\n  description:\n    'Display downloadable artifacts like generated files or exports. Shows filename, size, and download button. Best for CSV exports, PDF reports, and generated documents.',\n  schema: {\n    type: 'object',\n    properties: {\n      url: {\n        type: 'string',\n        description: 'Download URL for the artifact',\n      },\n      filename: {\n        type: 'string',\n        description: 'Display filename',\n      },\n      mimeType: {\n        type: 'string',\n        description: 'MIME type (e.g., \"text/csv\", \"application/pdf\")',\n      },\n      size: {\n        type: 'number',\n        description: 'File size in bytes',\n      },\n      description: {\n        type: 'string',\n        description: 'Description of the artifact',\n      },\n    },\n    required: ['url', 'filename', 'mimeType'],\n  },\n  examples: [],\n  limits: {\n    maxDataPoints: 1,\n    maxTableRows: 1,\n    maxPayloadSize: 5 * 1024,\n    renderTimeout: 1000,\n  },\n}\n\n/**\n * Component Registry - All components indexed by type\n */\nexport const ComponentRegistry: Map<ComponentType, ComponentRegistryEntry> = new Map([\n  ['chart', QuickchartRegistry],\n  ['table', TableRegistry],\n  ['metric', MetricRegistry],\n  ['text', TextRegistry],\n  // Sprint 4 additions\n  ['grid', GridRegistry],\n  ['action', ActionRegistry],\n  ['footer', FooterRegistry],\n  ['carousel', CarouselRegistry],\n  ['artifact', ArtifactRegistry],\n])\n\n/**\n * Get component registry entry by type\n */\nexport function getComponentEntry(type: ComponentType): ComponentRegistryEntry | undefined {\n  return ComponentRegistry.get(type)\n}\n\n/**\n * Get all component types\n */\nexport function getAllComponentTypes(): ComponentType[] {\n  return Array.from(ComponentRegistry.keys())\n}\n\n/**\n * Get registry as JSON for LLM context\n */\nexport function getRegistryForLLM(): string {\n  const entries = Array.from(ComponentRegistry.values()).map((entry) => ({\n    type: entry.type,\n    name: entry.name,\n    description: entry.description,\n    schema: entry.schema,\n    examples: entry.examples.map((ex) => ({\n      query: ex.query,\n      component: ex.component,\n    })),\n    limits: entry.limits,\n  }))\n\n  return JSON.stringify(entries, null, 2)\n}\n\n/**\n * Validate component against registry schema\n * (Future: Use Zod for runtime validation)\n */\nexport function validateAgainstRegistry(\n  componentType: ComponentType,\n  params: any\n): { valid: boolean; errors?: string[] } {\n  const entry = getComponentEntry(componentType)\n  if (!entry) {\n    return { valid: false, errors: [`Unknown component type: ${componentType}`] }\n  }\n\n  // Basic validation (Phase 1 will add Zod schema validation)\n  const required = entry.schema.required || []\n  const missing = required.filter((key: string) => !(key in params))\n\n  if (missing.length > 0) {\n    return {\n      valid: false,\n      errors: missing.map((key: string) => `Missing required field: ${key}`),\n    }\n  }\n\n  return { valid: true }\n}\n"],"names":["DEFAULT_RESOURCE_LIMITS"],"mappings":"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"}

package/dist/services/component-registry.d.ts

@@ -23,6 +23,31 @@ export declare const MetricRegistry: ComponentRegistryEntry;
  * Text Component Registry Entry
  */
 export declare const TextRegistry: ComponentRegistryEntry;
+/**
+ * Grid Component Registry Entry
+ * Nested CSS Grid layout for organizing multiple components
+ */
+export declare const GridRegistry: ComponentRegistryEntry;
+/**
+ * Action Component Registry Entry
+ * Interactive button or link that triggers tool calls
+ */
+export declare const ActionRegistry: ComponentRegistryEntry;
+/**
+ * Footer Component Registry Entry
+ * Display execution metadata like timing and source count
+ */
+export declare const FooterRegistry: ComponentRegistryEntry;
+/**
+ * Carousel Component Registry Entry
+ * Display multiple items with horizontal scrolling
+ */
+export declare const CarouselRegistry: ComponentRegistryEntry;
+/**
+ * Artifact Component Registry Entry
+ * Display downloadable artifacts like generated files
+ */
+export declare const ArtifactRegistry: ComponentRegistryEntry;
 /**
  * Component Registry - All components indexed by type
  */

package/dist/services/component-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component-registry.d.ts","sourceRoot":"","sources":["../../src/services/component-registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAGrE;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,sBA0GhC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,sBAqE3B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,sBA2D5B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,sBA2C1B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,GAAG,CAAC,aAAa,EAAE,sBAAsB,CAKvE,CAAA;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,sBAAsB,GAAG,SAAS,CAEzF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,aAAa,EAAE,CAEtD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAc1C;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,GAAG,GACV;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAkBvC"}
+{"version":3,"file":"component-registry.d.ts","sourceRoot":"","sources":["../../src/services/component-registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAGrE;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,sBA0GhC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,sBAqE3B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,sBA2D5B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,sBA2C1B,CAAA;AAMD;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,sBAsC1B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,sBAqD5B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,sBAgD5B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,sBAsB9B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,sBAsC9B,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,GAAG,CAAC,aAAa,EAAE,sBAAsB,CAWvE,CAAA;AAEF;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,sBAAsB,GAAG,SAAS,CAEzF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,aAAa,EAAE,CAEtD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAc1C;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,GAAG,GACV;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAkBvC"}

package/dist/services/component-registry.js

@@ -279,14 +279,224 @@ const TextRegistry = {
     // 1s
   }
 };
+const GridRegistry = {
+  type: "grid",
+  name: "GridLayout",
+  description: "Nested CSS Grid layout for organizing multiple components. Supports named areas, responsive columns (1-12), and custom gap spacing. Best for complex dashboard layouts and template builder.",
+  schema: {
+    type: "object",
+    properties: {
+      columns: {
+        type: "number",
+        description: "Number of columns (default: 12)"
+      },
+      gap: {
+        type: "string",
+        description: 'Gap between items (e.g., "1rem")'
+      },
+      minRowHeight: {
+        type: "string",
+        description: "Minimum row height (optional)"
+      },
+      areas: {
+        type: "array",
+        items: {
+          type: "array",
+          items: { type: "string" }
+        },
+        description: "CSS Grid template areas for named regions"
+      },
+      children: {
+        type: "array",
+        items: { type: "object" },
+        description: "Child UIComponents to render within the grid"
+      }
+    },
+    required: ["children"]
+  },
+  examples: [],
+  limits: DEFAULT_RESOURCE_LIMITS
+};
+const ActionRegistry = {
+  type: "action",
+  name: "ActionButton",
+  description: "Interactive button or link that triggers tool calls or navigation. Best for user interactions, form submissions, and workflow triggers.",
+  schema: {
+    type: "object",
+    properties: {
+      label: {
+        type: "string",
+        description: "Button text"
+      },
+      type: {
+        type: "string",
+        enum: ["button", "link"],
+        description: "Render as button or link"
+      },
+      action: {
+        type: "string",
+        enum: ["tool-call", "link", "submit"],
+        description: "Action type to perform"
+      },
+      toolName: {
+        type: "string",
+        description: "Tool name to call (for tool-call action)"
+      },
+      params: {
+        type: "object",
+        description: "Parameters to pass to the tool"
+      },
+      url: {
+        type: "string",
+        description: "URL for link action"
+      },
+      variant: {
+        type: "string",
+        enum: ["primary", "secondary", "outline", "ghost", "danger"],
+        description: "Visual style variant"
+      },
+      size: {
+        type: "string",
+        enum: ["sm", "md", "lg"],
+        description: "Button size"
+      },
+      disabled: {
+        type: "boolean",
+        description: "Whether the action is disabled"
+      }
+    },
+    required: ["label", "type", "action"]
+  },
+  examples: [],
+  limits: DEFAULT_RESOURCE_LIMITS
+};
+const FooterRegistry = {
+  type: "footer",
+  name: "FooterSection",
+  description: "Footer section displaying execution metadata. Best for showing timing, model info, and source counts. Auto-injected by layouts when metadata is provided.",
+  schema: {
+    type: "object",
+    properties: {
+      poweredBy: {
+        type: "string",
+        description: "Powered by text (optional)"
+      },
+      executionTime: {
+        type: "number",
+        description: "Execution time in milliseconds"
+      },
+      model: {
+        type: "string",
+        description: "LLM model used"
+      },
+      sourceCount: {
+        type: "number",
+        description: "Number of sources used"
+      },
+      customText: {
+        type: "string",
+        description: "Custom footer text"
+      },
+      links: {
+        type: "array",
+        items: {
+          type: "object",
+          properties: {
+            label: { type: "string" },
+            url: { type: "string" }
+          }
+        },
+        description: "Footer links"
+      }
+    }
+  },
+  examples: [],
+  limits: {
+    maxDataPoints: 1,
+    maxTableRows: 1,
+    maxPayloadSize: 5 * 1024,
+    renderTimeout: 1e3
+  }
+};
+const CarouselRegistry = {
+  type: "carousel",
+  name: "Carousel",
+  description: "Horizontal carousel for displaying multiple items with snap scrolling and navigation buttons. Best for showcasing related content, image galleries, or card collections.",
+  schema: {
+    type: "object",
+    properties: {
+      items: {
+        type: "array",
+        items: { type: "object" },
+        description: "Array of UIComponents to display in carousel"
+      },
+      height: {
+        type: "string",
+        description: "Carousel height (optional)"
+      }
+    },
+    required: ["items"]
+  },
+  examples: [],
+  limits: DEFAULT_RESOURCE_LIMITS
+};
+const ArtifactRegistry = {
+  type: "artifact",
+  name: "Artifact",
+  description: "Display downloadable artifacts like generated files or exports. Shows filename, size, and download button. Best for CSV exports, PDF reports, and generated documents.",
+  schema: {
+    type: "object",
+    properties: {
+      url: {
+        type: "string",
+        description: "Download URL for the artifact"
+      },
+      filename: {
+        type: "string",
+        description: "Display filename"
+      },
+      mimeType: {
+        type: "string",
+        description: 'MIME type (e.g., "text/csv", "application/pdf")'
+      },
+      size: {
+        type: "number",
+        description: "File size in bytes"
+      },
+      description: {
+        type: "string",
+        description: "Description of the artifact"
+      }
+    },
+    required: ["url", "filename", "mimeType"]
+  },
+  examples: [],
+  limits: {
+    maxDataPoints: 1,
+    maxTableRows: 1,
+    maxPayloadSize: 5 * 1024,
+    renderTimeout: 1e3
+  }
+};
 const ComponentRegistry = /* @__PURE__ */ new Map([
   ["chart", QuickchartRegistry],
   ["table", TableRegistry],
   ["metric", MetricRegistry],
-  ["text", TextRegistry]
+  ["text", TextRegistry],
+  // Sprint 4 additions
+  ["grid", GridRegistry],
+  ["action", ActionRegistry],
+  ["footer", FooterRegistry],
+  ["carousel", CarouselRegistry],
+  ["artifact", ArtifactRegistry]
 ]);
 export {
+  ActionRegistry,
+  ArtifactRegistry,
+  CarouselRegistry,
   ComponentRegistry,
+  FooterRegistry,
+  GridRegistry,
   MetricRegistry,
   QuickchartRegistry,
   TableRegistry,