@seed-ship/mcp-ui-solid 1.0.10 → 1.0.13

package/dist/mcp-ui-solid/src/hooks/useStreamingUI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStreamingUI.js","sources":["../../../../src/hooks/useStreamingUI.ts"],"sourcesContent":["/**\n * useStreamingUI Hook - Phase 2\n *\n * Client-side hook for consuming the streaming generative UI endpoint.\n * Handles SSE connection, component buffering, reordering, and error handling.\n *\n * Features:\n * - SSE connection with automatic reconnection\n * - Component buffering and reordering by sequenceId\n * - Progress tracking and loading states\n * - Error handling with recovery attempts\n * - Cleanup on unmount\n *\n * Usage:\n * ```tsx\n * const { components, isLoading, error, progress } = useStreamingUI({\n *   query: 'Show me revenue trends',\n *   spaceIds: ['uuid1', 'uuid2'],\n *   onComplete: (metadata) => console.log('Done!', metadata),\n * })\n * ```\n */\n\nimport { createSignal, onCleanup } from 'solid-js'\nimport type { UIComponent } from '../types'\nimport { createLogger } from '../utils/logger'\n\nconst logger = createLogger('useStreamingUI')\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface UseStreamingUIOptions {\n  query: string\n  spaceIds?: string[]\n  sessionId?: string\n  options?: {\n    useCache?: boolean\n    useLLM?: boolean\n    maxComponents?: number\n    preferredComponents?: Array<'chart' | 'table' | 'metric' | 'text'>\n  }\n  onComplete?: (metadata: CompleteMetadata) => void\n  onError?: (error: StreamError) => void\n  onComponentReceived?: (component: UIComponent) => void\n}\n\nexport interface StreamingUIState {\n  components: UIComponent[]\n  isLoading: boolean\n  isStreaming: boolean\n  error: StreamError | null\n  progress: StreamProgress\n  metadata: CompleteMetadata | null\n}\n\nexport interface StreamProgress {\n  receivedCount: number\n  totalCount: number | null\n  message: string\n  timestamp: string\n}\n\nexport interface CompleteMetadata {\n  layoutId: string\n  componentsCount: number\n  executionTimeMs: number\n  firstTokenMs: number\n  provider: 'groq' | 'mock'\n  model: string\n  tokensUsed?: number\n  costUSD?: number\n  cached: boolean\n}\n\nexport interface StreamError {\n  error: string\n  message: string\n  componentId?: string\n  recoverable: boolean\n}\n\ninterface ComponentBuffer {\n  [sequenceId: number]: {\n    component: UIComponent\n    position: { colStart: number; colSpan: number; rowStart?: number; rowSpan?: number }\n  }\n}\n\n// ============================================================================\n// SSE Event Types (must match server)\n// ============================================================================\n\ntype SSEEventType = 'status' | 'component-start' | 'component' | 'complete' | 'error'\n\ninterface StatusEvent {\n  message: string\n  timestamp: string\n  totalComponents?: number\n}\n\ninterface ComponentStartEvent {\n  componentId: string\n  type: 'chart' | 'table' | 'metric' | 'text'\n  sequenceId: number\n  position: { colStart: number; colSpan: number }\n}\n\ninterface ComponentEvent {\n  componentId: string\n  sequenceId: number\n  component: UIComponent\n  position: { colStart: number; colSpan: number; rowStart?: number; rowSpan?: number }\n}\n\n// ============================================================================\n// Hook Implementation\n// ============================================================================\n\nexport function useStreamingUI(options: UseStreamingUIOptions) {\n  // State\n  const [components, setComponents] = createSignal<UIComponent[]>([])\n  const [isLoading, setIsLoading] = createSignal(false)\n  const [isStreaming, setIsStreaming] = createSignal(false)\n  const [error, setError] = createSignal<StreamError | null>(null)\n  const [progress, setProgress] = createSignal<StreamProgress>({\n    receivedCount: 0,\n    totalCount: null,\n    message: 'Initializing...',\n    timestamp: new Date().toISOString(),\n  })\n  const [metadata, setMetadata] = createSignal<CompleteMetadata | null>(null)\n\n  // Component buffer for reordering\n  let componentBuffer: ComponentBuffer = {}\n  let nextSequenceId = 0\n  let eventSource: EventSource | null = null\n  let reconnectAttempts = 0\n  const maxReconnectAttempts = 3\n\n  /**\n   * Flush components from buffer in sequence order\n   */\n  const flushBuffer = () => {\n    const flushed: UIComponent[] = []\n\n    while (componentBuffer[nextSequenceId]) {\n      const { component } = componentBuffer[nextSequenceId]\n      flushed.push(component)\n      delete componentBuffer[nextSequenceId]\n      nextSequenceId++\n    }\n\n    if (flushed.length > 0) {\n      setComponents((prev) => [...prev, ...flushed])\n\n      setProgress((prev) => ({\n        ...prev,\n        receivedCount: prev.receivedCount + flushed.length,\n      }))\n\n      logger.debug('Flushed components from buffer', {\n        count: flushed.length,\n        nextSequenceId,\n      })\n    }\n  }\n\n  /**\n   * Handle SSE status event\n   */\n  const handleStatusEvent = (data: StatusEvent) => {\n    logger.debug('Status event received', data as unknown as Record<string, unknown>)\n\n    setProgress({\n      receivedCount: progress().receivedCount,\n      totalCount: data.totalComponents ?? progress().totalCount,\n      message: data.message,\n      timestamp: data.timestamp,\n    })\n  }\n\n  /**\n   * Handle SSE component-start event\n   */\n  const handleComponentStartEvent = (data: ComponentStartEvent) => {\n    logger.debug('Component-start event received', data as unknown as Record<string, unknown>)\n\n    setProgress((prev) => ({\n      ...prev,\n      message: `Loading ${data.type} component...`,\n      timestamp: new Date().toISOString(),\n    }))\n  }\n\n  /**\n   * Handle SSE component event\n   */\n  const handleComponentEvent = (data: ComponentEvent) => {\n    logger.debug('Component event received', {\n      componentId: data.componentId,\n      sequenceId: data.sequenceId,\n    })\n\n    // Add to buffer\n    componentBuffer[data.sequenceId] = {\n      component: data.component,\n      position: data.position,\n    }\n\n    // Flush buffer in sequence\n    flushBuffer()\n\n    // Notify callback\n    if (options.onComponentReceived) {\n      options.onComponentReceived(data.component)\n    }\n  }\n\n  /**\n   * Handle SSE complete event\n   */\n  const handleCompleteEvent = (data: CompleteMetadata) => {\n    logger.info('Stream completed', data as unknown as Record<string, unknown>)\n\n    setIsStreaming(false)\n    setIsLoading(false)\n    setMetadata(data)\n\n    // Flush any remaining buffered components\n    flushBuffer()\n\n    setProgress((prev) => ({\n      ...prev,\n      message: 'Dashboard loaded',\n      timestamp: new Date().toISOString(),\n    }))\n\n    // Notify callback\n    if (options.onComplete) {\n      options.onComplete(data)\n    }\n  }\n\n  /**\n   * Handle SSE error event\n   */\n  const handleErrorEvent = (data: StreamError) => {\n    logger.error('Stream error received', data as unknown as Record<string, unknown>)\n\n    setError(data)\n    setIsStreaming(false)\n    setIsLoading(false)\n\n    setProgress((prev) => ({\n      ...prev,\n      message: `Error: ${data.message}`,\n      timestamp: new Date().toISOString(),\n    }))\n\n    // Notify callback\n    if (options.onError) {\n      options.onError(data)\n    }\n\n    // Try to reconnect if recoverable\n    if (data.recoverable && reconnectAttempts < maxReconnectAttempts) {\n      reconnectAttempts++\n      logger.warn('Attempting to reconnect', { attempt: reconnectAttempts })\n      setTimeout(() => startStreaming(), 1000 * reconnectAttempts)\n    }\n  }\n\n  /**\n   * Parse SSE event\n   */\n  const parseSSEEvent = (event: MessageEvent, eventType: SSEEventType) => {\n    try {\n      const data = JSON.parse(event.data)\n\n      switch (eventType) {\n        case 'status':\n          handleStatusEvent(data as StatusEvent)\n          break\n        case 'component-start':\n          handleComponentStartEvent(data as ComponentStartEvent)\n          break\n        case 'component':\n          handleComponentEvent(data as ComponentEvent)\n          break\n        case 'complete':\n          handleCompleteEvent(data as CompleteMetadata)\n          break\n        case 'error':\n          handleErrorEvent(data as StreamError)\n          break\n        default:\n          logger.warn('Unknown SSE event type', { eventType })\n      }\n    } catch (error) {\n      logger.error('Failed to parse SSE event', {\n        error: error instanceof Error ? error.message : String(error),\n        eventType,\n      })\n    }\n  }\n\n  /**\n   * Start SSE streaming\n   */\n  const startStreaming = () => {\n    // Reset state\n    setComponents([])\n    setError(null)\n    setIsLoading(true)\n    setIsStreaming(true)\n    componentBuffer = {}\n    nextSequenceId = 0\n\n    setProgress({\n      receivedCount: 0,\n      totalCount: null,\n      message: 'Connecting to server...',\n      timestamp: new Date().toISOString(),\n    })\n\n    logger.info('Starting SSE stream', {\n      query: options.query,\n      spaceIds: options.spaceIds,\n    })\n\n    // Build request body\n    const requestBody = {\n      query: options.query,\n      spaceIds: options.spaceIds,\n      sessionId: options.sessionId,\n      options: options.options,\n    }\n\n    // Create EventSource (SSE connection)\n    // Note: EventSource doesn't support POST, so we need to use fetch + ReadableStream\n    fetch('/api/mcp/generative-ui-stream', {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(requestBody),\n    })\n      .then(async (response) => {\n        if (!response.ok) {\n          const errorData = await response.json()\n          throw new Error(errorData.message || 'Stream request failed')\n        }\n\n        if (!response.body) {\n          throw new Error('Response body is null')\n        }\n\n        const reader = response.body.getReader()\n        const decoder = new TextDecoder()\n\n        let buffer = ''\n\n        // Read stream\n        const readChunk = async (): Promise<void> => {\n          const { done, value } = await reader.read()\n\n          if (done) {\n            logger.info('Stream ended')\n            return\n          }\n\n          buffer += decoder.decode(value, { stream: true })\n\n          // Process SSE messages\n          const lines = buffer.split('\\n')\n          buffer = lines.pop() || '' // Keep incomplete line in buffer\n\n          let currentEvent: SSEEventType | null = null\n\n          for (const line of lines) {\n            if (line.startsWith('event: ')) {\n              currentEvent = line.slice(7) as SSEEventType\n            } else if (line.startsWith('data: ') && currentEvent) {\n              const data = line.slice(6)\n              parseSSEEvent({ data } as MessageEvent, currentEvent)\n              currentEvent = null\n            }\n          }\n\n          // Continue reading\n          return readChunk()\n        }\n\n        await readChunk()\n      })\n      .catch((err) => {\n        logger.error('Stream fetch failed', {\n          error: err instanceof Error ? err.message : String(err),\n        })\n\n        handleErrorEvent({\n          error: 'Stream connection failed',\n          message: err instanceof Error ? err.message : 'Unknown error',\n          recoverable: true,\n        })\n      })\n  }\n\n  /**\n   * Stop streaming\n   */\n  const stopStreaming = () => {\n    if (eventSource) {\n      eventSource.close()\n      eventSource = null\n    }\n\n    setIsStreaming(false)\n    setIsLoading(false)\n\n    logger.info('Streaming stopped')\n  }\n\n  /**\n   * Cleanup on unmount\n   */\n  onCleanup(() => {\n    stopStreaming()\n  })\n\n  // Auto-start streaming\n  startStreaming()\n\n  // Return state accessors and controls\n  return {\n    components,\n    isLoading,\n    isStreaming,\n    error,\n    progress,\n    metadata,\n    startStreaming,\n    stopStreaming,\n  }\n}\n"],"names":["error"],"mappings":"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"}

package/dist/mcp-ui-solid/src/services/component-registry.cjs.map

@@ -0,0 +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":"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"}

package/dist/mcp-ui-solid/src/services/component-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-registry.js","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":[],"mappings":"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"}

package/dist/{services → mcp-ui-solid/src/services}/validation.cjs

@@ -10,6 +10,18 @@ const DEFAULT_RESOURCE_LIMITS = {
 };
 function validateGridPosition(position) {
   const errors = [];
+  if (!position) {
+    return {
+      valid: false,
+      errors: [
+        {
+          path: "position",
+          message: "Position is required",
+          code: "MISSING_POSITION"
+        }
+      ]
+    };
+  }
   if (position.colStart < 1 || position.colStart > 12) {
     errors.push({
       path: "position.colStart",

package/dist/mcp-ui-solid/src/services/validation.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.cjs","sources":["../../../../src/services/validation.ts"],"sourcesContent":["/**\n * Component Validation Service\n * Phase 0: Resource Limits & Schema Validation\n *\n * Validates LLM-generated components against:\n * - JSON schema\n * - Resource limits (data points, payload size, grid bounds)\n * - Security constraints (domain whitelist, XSS prevention)\n */\n\nimport type {\n  UIComponent,\n  UILayout,\n  ValidationResult,\n  ResourceLimits,\n  ChartComponentParams,\n  TableComponentParams,\n} from '../types'\n\n/**\n * Default resource limits (configurable via env)\n */\nexport const DEFAULT_RESOURCE_LIMITS: ResourceLimits = {\n  maxDataPoints: 1000,\n  maxTableRows: 100,\n  maxPayloadSize: 50 * 1024, // 50KB\n  renderTimeout: 5000, // 5 seconds\n}\n\n/**\n * Allowed iframe domains (whitelist)\n * Must match CSP frame-src directive\n */\nconst ALLOWED_IFRAME_DOMAINS = [\n  'quickchart.io',\n  'www.quickchart.io',\n  'deposium.com',\n  'deposium.vip',\n  'localhost',\n]\n\n/**\n * Validate grid position bounds (1-12 columns)\n */\nexport function validateGridPosition(position: UIComponent['position']): ValidationResult {\n  const errors: ValidationResult['errors'] = []\n\n  // ✅ PHASE 3 FIX: Defensive check for undefined position\n  if (!position) {\n    return {\n      valid: false,\n      errors: [\n        {\n          path: 'position',\n          message: 'Position is required',\n          code: 'MISSING_POSITION',\n        },\n      ],\n    }\n  }\n\n  if (position.colStart < 1 || position.colStart > 12) {\n    errors.push({\n      path: 'position.colStart',\n      message: 'Column start must be between 1 and 12',\n      code: 'INVALID_GRID_COL_START',\n    })\n  }\n\n  if (position.colSpan < 1 || position.colSpan > 12) {\n    errors.push({\n      path: 'position.colSpan',\n      message: 'Column span must be between 1 and 12',\n      code: 'INVALID_GRID_COL_SPAN',\n    })\n  }\n\n  if (position.colStart + position.colSpan - 1 > 12) {\n    errors.push({\n      path: 'position',\n      message: 'Column start + span exceeds grid width (12)',\n      code: 'GRID_OVERFLOW',\n    })\n  }\n\n  if (position.rowStart !== undefined && position.rowStart < 1) {\n    errors.push({\n      path: 'position.rowStart',\n      message: 'Row start must be >= 1',\n      code: 'INVALID_GRID_ROW_START',\n    })\n  }\n\n  if (position.rowSpan !== undefined && position.rowSpan < 1) {\n    errors.push({\n      path: 'position.rowSpan',\n      message: 'Row span must be >= 1',\n      code: 'INVALID_GRID_ROW_SPAN',\n    })\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors: errors.length > 0 ? errors : undefined,\n  }\n}\n\n/**\n * Validate chart component against resource limits\n */\nexport function validateChartComponent(\n  params: ChartComponentParams,\n  limits: ResourceLimits = DEFAULT_RESOURCE_LIMITS\n): ValidationResult {\n  const errors: ValidationResult['errors'] = []\n\n  // Validate data points count\n  const totalDataPoints = params.data.datasets.reduce(\n    (sum, dataset) => sum + dataset.data.length,\n    0\n  )\n\n  if (totalDataPoints > limits.maxDataPoints) {\n    errors.push({\n      path: 'params.data',\n      message: `Chart exceeds max data points: ${totalDataPoints} > ${limits.maxDataPoints}`,\n      code: 'RESOURCE_LIMIT_EXCEEDED',\n    })\n  }\n\n  // Validate labels match dataset length\n  const expectedLength = params.data.labels.length\n  for (const [index, dataset] of params.data.datasets.entries()) {\n    if (dataset.data.length !== expectedLength) {\n      errors.push({\n        path: `params.data.datasets[${index}]`,\n        message: `Dataset length mismatch: expected ${expectedLength}, got ${dataset.data.length}`,\n        code: 'DATA_LENGTH_MISMATCH',\n      })\n    }\n  }\n\n  // Validate numeric data\n  for (const [index, dataset] of params.data.datasets.entries()) {\n    for (const [dataIndex, value] of dataset.data.entries()) {\n      if (typeof value !== 'number' || !Number.isFinite(value)) {\n        errors.push({\n          path: `params.data.datasets[${index}].data[${dataIndex}]`,\n          message: `Invalid data value: ${value} (must be finite number)`,\n          code: 'INVALID_DATA_TYPE',\n        })\n      }\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors: errors.length > 0 ? errors : undefined,\n  }\n}\n\n/**\n * Validate table component against resource limits\n */\nexport function validateTableComponent(\n  params: TableComponentParams,\n  limits: ResourceLimits = DEFAULT_RESOURCE_LIMITS\n): ValidationResult {\n  const errors: ValidationResult['errors'] = []\n\n  // Validate row count\n  if (params.rows.length > limits.maxTableRows) {\n    errors.push({\n      path: 'params.rows',\n      message: `Table exceeds max rows: ${params.rows.length} > ${limits.maxTableRows}`,\n      code: 'RESOURCE_LIMIT_EXCEEDED',\n    })\n  }\n\n  // Validate columns\n  if (params.columns.length === 0) {\n    errors.push({\n      path: 'params.columns',\n      message: 'Table must have at least one column',\n      code: 'EMPTY_COLUMNS',\n    })\n  }\n\n  // Validate column keys are unique\n  const columnKeys = new Set<string>()\n  for (const [index, column] of params.columns.entries()) {\n    if (columnKeys.has(column.key)) {\n      errors.push({\n        path: `params.columns[${index}]`,\n        message: `Duplicate column key: ${column.key}`,\n        code: 'DUPLICATE_COLUMN_KEY',\n      })\n    }\n    columnKeys.add(column.key)\n  }\n\n  // Validate rows have valid data for defined columns\n  for (const [rowIndex, row] of params.rows.entries()) {\n    for (const column of params.columns) {\n      if (!(column.key in row)) {\n        errors.push({\n          path: `params.rows[${rowIndex}]`,\n          message: `Missing column key: ${column.key}`,\n          code: 'MISSING_COLUMN_DATA',\n        })\n      }\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors: errors.length > 0 ? errors : undefined,\n  }\n}\n\n/**\n * Validate payload size\n */\nexport function validatePayloadSize(\n  component: UIComponent,\n  limits: ResourceLimits = DEFAULT_RESOURCE_LIMITS\n): ValidationResult {\n  const payloadSize = JSON.stringify(component).length\n\n  if (payloadSize > limits.maxPayloadSize) {\n    return {\n      valid: false,\n      errors: [\n        {\n          path: 'component',\n          message: `Payload size exceeds limit: ${payloadSize} > ${limits.maxPayloadSize} bytes`,\n          code: 'PAYLOAD_TOO_LARGE',\n        },\n      ],\n    }\n  }\n\n  return { valid: true }\n}\n\n/**\n * Sanitize string to prevent XSS\n * Basic implementation - DOMPurify used at render time\n */\nexport function sanitizeString(input: string): string {\n  return input\n    .replace(/<script\\b[^<]*(?:(?!<\\/script>)<[^<]*)*<\\/script>/gi, '')\n    .replace(/on\\w+=\"[^\"]*\"/gi, '')\n    .replace(/javascript:/gi, '')\n}\n\n/**\n * Validate iframe domain against whitelist\n */\nexport function validateIframeDomain(url: string): ValidationResult {\n  try {\n    const parsedUrl = new URL(url)\n    const domain = parsedUrl.hostname\n\n    const isAllowed = ALLOWED_IFRAME_DOMAINS.some(\n      (allowed) => domain === allowed || domain.endsWith(`.${allowed}`) || allowed === 'localhost'\n    )\n\n    if (!isAllowed) {\n      return {\n        valid: false,\n        errors: [\n          {\n            path: 'url',\n            message: `Domain not whitelisted: ${domain}`,\n            code: 'DOMAIN_NOT_WHITELISTED',\n          },\n        ],\n      }\n    }\n\n    return { valid: true }\n  } catch (error) {\n    return {\n      valid: false,\n      errors: [\n        {\n          path: 'url',\n          message: 'Invalid URL format',\n          code: 'INVALID_URL',\n        },\n      ],\n    }\n  }\n}\n\n/**\n * Validate entire component\n */\nexport function validateComponent(\n  component: UIComponent,\n  limits: ResourceLimits = DEFAULT_RESOURCE_LIMITS\n): ValidationResult {\n  const errors: ValidationResult['errors'] = []\n\n  // Validate grid position\n  const gridResult = validateGridPosition(component.position)\n  if (!gridResult.valid) {\n    errors.push(...(gridResult.errors || []))\n  }\n\n  // Validate payload size\n  const sizeResult = validatePayloadSize(component, limits)\n  if (!sizeResult.valid) {\n    errors.push(...(sizeResult.errors || []))\n  }\n\n  // Type-specific validation\n  switch (component.type) {\n    case 'chart':\n      const chartResult = validateChartComponent(component.params as ChartComponentParams, limits)\n      if (!chartResult.valid) {\n        errors.push(...(chartResult.errors || []))\n      }\n      break\n\n    case 'table':\n      const tableResult = validateTableComponent(component.params as TableComponentParams, limits)\n      if (!tableResult.valid) {\n        errors.push(...(tableResult.errors || []))\n      }\n      break\n\n    case 'metric':\n      // Basic validation for metrics\n      const metricParams = component.params as any\n      if (!metricParams.title || !metricParams.value) {\n        errors.push({\n          path: 'params',\n          message: 'Metric must have title and value',\n          code: 'INVALID_METRIC',\n        })\n      }\n      break\n\n    case 'text':\n      // Basic validation for text\n      const textParams = component.params as any\n      if (!textParams.content) {\n        errors.push({\n          path: 'params',\n          message: 'Text component must have content',\n          code: 'INVALID_TEXT',\n        })\n      }\n      break\n\n    default:\n      errors.push({\n        path: 'type',\n        message: `Unknown component type: ${component.type}`,\n        code: 'UNKNOWN_COMPONENT_TYPE',\n      })\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors: errors.length > 0 ? errors : undefined,\n  }\n}\n\n/**\n * Validate entire layout\n */\nexport function validateLayout(\n  layout: UILayout,\n  limits: ResourceLimits = DEFAULT_RESOURCE_LIMITS\n): ValidationResult {\n  const errors: ValidationResult['errors'] = []\n\n  // Validate component count\n  if (layout.components.length === 0) {\n    errors.push({\n      path: 'components',\n      message: 'Layout must have at least one component',\n      code: 'EMPTY_LAYOUT',\n    })\n  }\n\n  if (layout.components.length > 12) {\n    errors.push({\n      path: 'components',\n      message: `Layout exceeds max components: ${layout.components.length} > 12`,\n      code: 'TOO_MANY_COMPONENTS',\n    })\n  }\n\n  // Validate each component\n  for (const [index, component] of layout.components.entries()) {\n    const result = validateComponent(component, limits)\n    if (!result.valid) {\n      errors.push(\n        ...(result.errors?.map((error) => ({\n          ...error,\n          path: `components[${index}].${error.path}`,\n        })) || [])\n      )\n    }\n  }\n\n  // Validate grid configuration\n  if (layout.grid.columns !== 12) {\n    errors.push({\n      path: 'grid.columns',\n      message: 'Grid must have 12 columns (Bootstrap-like)',\n      code: 'INVALID_GRID_COLUMNS',\n    })\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors: errors.length > 0 ? errors : undefined,\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/{services → mcp-ui-solid/src/services}/validation.js

@@ -8,6 +8,18 @@ const DEFAULT_RESOURCE_LIMITS = {
 };
 function validateGridPosition(position) {
   const errors = [];
+  if (!position) {
+    return {
+      valid: false,
+      errors: [
+        {
+          path: "position",
+          message: "Position is required",
+          code: "MISSING_POSITION"
+        }
+      ]
+    };
+  }
   if (position.colStart < 1 || position.colStart > 12) {
     errors.push({
       path: "position.colStart",

package/dist/mcp-ui-solid/src/services/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sources":["../../../../src/services/validation.ts"],"sourcesContent":["/**\n * Component Validation Service\n * Phase 0: Resource Limits & Schema Validation\n *\n * Validates LLM-generated components against:\n * - JSON schema\n * - Resource limits (data points, payload size, grid bounds)\n * - Security constraints (domain whitelist, XSS prevention)\n */\n\nimport type {\n  UIComponent,\n  UILayout,\n  ValidationResult,\n  ResourceLimits,\n  ChartComponentParams,\n  TableComponentParams,\n} from '../types'\n\n/**\n * Default resource limits (configurable via env)\n */\nexport const DEFAULT_RESOURCE_LIMITS: ResourceLimits = {\n  maxDataPoints: 1000,\n  maxTableRows: 100,\n  maxPayloadSize: 50 * 1024, // 50KB\n  renderTimeout: 5000, // 5 seconds\n}\n\n/**\n * Allowed iframe domains (whitelist)\n * Must match CSP frame-src directive\n */\nconst ALLOWED_IFRAME_DOMAINS = [\n  'quickchart.io',\n  'www.quickchart.io',\n  'deposium.com',\n  'deposium.vip',\n  'localhost',\n]\n\n/**\n * Validate grid position bounds (1-12 columns)\n */\nexport function validateGridPosition(position: UIComponent['position']): ValidationResult {\n  const errors: ValidationResult['errors'] = []\n\n  // ✅ PHASE 3 FIX: Defensive check for undefined position\n  if (!position) {\n    return {\n      valid: false,\n      errors: [\n        {\n          path: 'position',\n          message: 'Position is required',\n          code: 'MISSING_POSITION',\n        },\n      ],\n    }\n  }\n\n  if (position.colStart < 1 || position.colStart > 12) {\n    errors.push({\n      path: 'position.colStart',\n      message: 'Column start must be between 1 and 12',\n      code: 'INVALID_GRID_COL_START',\n    })\n  }\n\n  if (position.colSpan < 1 || position.colSpan > 12) {\n    errors.push({\n      path: 'position.colSpan',\n      message: 'Column span must be between 1 and 12',\n      code: 'INVALID_GRID_COL_SPAN',\n    })\n  }\n\n  if (position.colStart + position.colSpan - 1 > 12) {\n    errors.push({\n      path: 'position',\n      message: 'Column start + span exceeds grid width (12)',\n      code: 'GRID_OVERFLOW',\n    })\n  }\n\n  if (position.rowStart !== undefined && position.rowStart < 1) {\n    errors.push({\n      path: 'position.rowStart',\n      message: 'Row start must be >= 1',\n      code: 'INVALID_GRID_ROW_START',\n    })\n  }\n\n  if (position.rowSpan !== undefined && position.rowSpan < 1) {\n    errors.push({\n      path: 'position.rowSpan',\n      message: 'Row span must be >= 1',\n      code: 'INVALID_GRID_ROW_SPAN',\n    })\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors: errors.length > 0 ? errors : undefined,\n  }\n}\n\n/**\n * Validate chart component against resource limits\n */\nexport function validateChartComponent(\n  params: ChartComponentParams,\n  limits: ResourceLimits = DEFAULT_RESOURCE_LIMITS\n): ValidationResult {\n  const errors: ValidationResult['errors'] = []\n\n  // Validate data points count\n  const totalDataPoints = params.data.datasets.reduce(\n    (sum, dataset) => sum + dataset.data.length,\n    0\n  )\n\n  if (totalDataPoints > limits.maxDataPoints) {\n    errors.push({\n      path: 'params.data',\n      message: `Chart exceeds max data points: ${totalDataPoints} > ${limits.maxDataPoints}`,\n      code: 'RESOURCE_LIMIT_EXCEEDED',\n    })\n  }\n\n  // Validate labels match dataset length\n  const expectedLength = params.data.labels.length\n  for (const [index, dataset] of params.data.datasets.entries()) {\n    if (dataset.data.length !== expectedLength) {\n      errors.push({\n        path: `params.data.datasets[${index}]`,\n        message: `Dataset length mismatch: expected ${expectedLength}, got ${dataset.data.length}`,\n        code: 'DATA_LENGTH_MISMATCH',\n      })\n    }\n  }\n\n  // Validate numeric data\n  for (const [index, dataset] of params.data.datasets.entries()) {\n    for (const [dataIndex, value] of dataset.data.entries()) {\n      if (typeof value !== 'number' || !Number.isFinite(value)) {\n        errors.push({\n          path: `params.data.datasets[${index}].data[${dataIndex}]`,\n          message: `Invalid data value: ${value} (must be finite number)`,\n          code: 'INVALID_DATA_TYPE',\n        })\n      }\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors: errors.length > 0 ? errors : undefined,\n  }\n}\n\n/**\n * Validate table component against resource limits\n */\nexport function validateTableComponent(\n  params: TableComponentParams,\n  limits: ResourceLimits = DEFAULT_RESOURCE_LIMITS\n): ValidationResult {\n  const errors: ValidationResult['errors'] = []\n\n  // Validate row count\n  if (params.rows.length > limits.maxTableRows) {\n    errors.push({\n      path: 'params.rows',\n      message: `Table exceeds max rows: ${params.rows.length} > ${limits.maxTableRows}`,\n      code: 'RESOURCE_LIMIT_EXCEEDED',\n    })\n  }\n\n  // Validate columns\n  if (params.columns.length === 0) {\n    errors.push({\n      path: 'params.columns',\n      message: 'Table must have at least one column',\n      code: 'EMPTY_COLUMNS',\n    })\n  }\n\n  // Validate column keys are unique\n  const columnKeys = new Set<string>()\n  for (const [index, column] of params.columns.entries()) {\n    if (columnKeys.has(column.key)) {\n      errors.push({\n        path: `params.columns[${index}]`,\n        message: `Duplicate column key: ${column.key}`,\n        code: 'DUPLICATE_COLUMN_KEY',\n      })\n    }\n    columnKeys.add(column.key)\n  }\n\n  // Validate rows have valid data for defined columns\n  for (const [rowIndex, row] of params.rows.entries()) {\n    for (const column of params.columns) {\n      if (!(column.key in row)) {\n        errors.push({\n          path: `params.rows[${rowIndex}]`,\n          message: `Missing column key: ${column.key}`,\n          code: 'MISSING_COLUMN_DATA',\n        })\n      }\n    }\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors: errors.length > 0 ? errors : undefined,\n  }\n}\n\n/**\n * Validate payload size\n */\nexport function validatePayloadSize(\n  component: UIComponent,\n  limits: ResourceLimits = DEFAULT_RESOURCE_LIMITS\n): ValidationResult {\n  const payloadSize = JSON.stringify(component).length\n\n  if (payloadSize > limits.maxPayloadSize) {\n    return {\n      valid: false,\n      errors: [\n        {\n          path: 'component',\n          message: `Payload size exceeds limit: ${payloadSize} > ${limits.maxPayloadSize} bytes`,\n          code: 'PAYLOAD_TOO_LARGE',\n        },\n      ],\n    }\n  }\n\n  return { valid: true }\n}\n\n/**\n * Sanitize string to prevent XSS\n * Basic implementation - DOMPurify used at render time\n */\nexport function sanitizeString(input: string): string {\n  return input\n    .replace(/<script\\b[^<]*(?:(?!<\\/script>)<[^<]*)*<\\/script>/gi, '')\n    .replace(/on\\w+=\"[^\"]*\"/gi, '')\n    .replace(/javascript:/gi, '')\n}\n\n/**\n * Validate iframe domain against whitelist\n */\nexport function validateIframeDomain(url: string): ValidationResult {\n  try {\n    const parsedUrl = new URL(url)\n    const domain = parsedUrl.hostname\n\n    const isAllowed = ALLOWED_IFRAME_DOMAINS.some(\n      (allowed) => domain === allowed || domain.endsWith(`.${allowed}`) || allowed === 'localhost'\n    )\n\n    if (!isAllowed) {\n      return {\n        valid: false,\n        errors: [\n          {\n            path: 'url',\n            message: `Domain not whitelisted: ${domain}`,\n            code: 'DOMAIN_NOT_WHITELISTED',\n          },\n        ],\n      }\n    }\n\n    return { valid: true }\n  } catch (error) {\n    return {\n      valid: false,\n      errors: [\n        {\n          path: 'url',\n          message: 'Invalid URL format',\n          code: 'INVALID_URL',\n        },\n      ],\n    }\n  }\n}\n\n/**\n * Validate entire component\n */\nexport function validateComponent(\n  component: UIComponent,\n  limits: ResourceLimits = DEFAULT_RESOURCE_LIMITS\n): ValidationResult {\n  const errors: ValidationResult['errors'] = []\n\n  // Validate grid position\n  const gridResult = validateGridPosition(component.position)\n  if (!gridResult.valid) {\n    errors.push(...(gridResult.errors || []))\n  }\n\n  // Validate payload size\n  const sizeResult = validatePayloadSize(component, limits)\n  if (!sizeResult.valid) {\n    errors.push(...(sizeResult.errors || []))\n  }\n\n  // Type-specific validation\n  switch (component.type) {\n    case 'chart':\n      const chartResult = validateChartComponent(component.params as ChartComponentParams, limits)\n      if (!chartResult.valid) {\n        errors.push(...(chartResult.errors || []))\n      }\n      break\n\n    case 'table':\n      const tableResult = validateTableComponent(component.params as TableComponentParams, limits)\n      if (!tableResult.valid) {\n        errors.push(...(tableResult.errors || []))\n      }\n      break\n\n    case 'metric':\n      // Basic validation for metrics\n      const metricParams = component.params as any\n      if (!metricParams.title || !metricParams.value) {\n        errors.push({\n          path: 'params',\n          message: 'Metric must have title and value',\n          code: 'INVALID_METRIC',\n        })\n      }\n      break\n\n    case 'text':\n      // Basic validation for text\n      const textParams = component.params as any\n      if (!textParams.content) {\n        errors.push({\n          path: 'params',\n          message: 'Text component must have content',\n          code: 'INVALID_TEXT',\n        })\n      }\n      break\n\n    default:\n      errors.push({\n        path: 'type',\n        message: `Unknown component type: ${component.type}`,\n        code: 'UNKNOWN_COMPONENT_TYPE',\n      })\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors: errors.length > 0 ? errors : undefined,\n  }\n}\n\n/**\n * Validate entire layout\n */\nexport function validateLayout(\n  layout: UILayout,\n  limits: ResourceLimits = DEFAULT_RESOURCE_LIMITS\n): ValidationResult {\n  const errors: ValidationResult['errors'] = []\n\n  // Validate component count\n  if (layout.components.length === 0) {\n    errors.push({\n      path: 'components',\n      message: 'Layout must have at least one component',\n      code: 'EMPTY_LAYOUT',\n    })\n  }\n\n  if (layout.components.length > 12) {\n    errors.push({\n      path: 'components',\n      message: `Layout exceeds max components: ${layout.components.length} > 12`,\n      code: 'TOO_MANY_COMPONENTS',\n    })\n  }\n\n  // Validate each component\n  for (const [index, component] of layout.components.entries()) {\n    const result = validateComponent(component, limits)\n    if (!result.valid) {\n      errors.push(\n        ...(result.errors?.map((error) => ({\n          ...error,\n          path: `components[${index}].${error.path}`,\n        })) || [])\n      )\n    }\n  }\n\n  // Validate grid configuration\n  if (layout.grid.columns !== 12) {\n    errors.push({\n      path: 'grid.columns',\n      message: 'Grid must have 12 columns (Bootstrap-like)',\n      code: 'INVALID_GRID_COLUMNS',\n    })\n  }\n\n  return {\n    valid: errors.length === 0,\n    errors: errors.length > 0 ? errors : undefined,\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/mcp-ui-solid/src/utils/logger.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.cjs","sources":["../../../../src/utils/logger.ts"],"sourcesContent":["/**\n * Simple internal logger utility\n *\n * Provides basic logging functionality for the package.\n * Consumers can disable logging by setting NODE_ENV=production\n * or by implementing their own logging solution.\n */\n\nconst isDev = typeof process !== 'undefined' && process.env.NODE_ENV !== 'production'\n\nexport interface Logger {\n  info(message: string, context?: Record<string, unknown>): void\n  warn(message: string, context?: Record<string, unknown>): void\n  error(message: string, context?: Record<string, unknown>): void\n  debug(message: string, context?: Record<string, unknown>): void\n}\n\nfunction formatLogMessage(\n  feature: string,\n  message: string,\n  context?: Record<string, unknown>\n): string {\n  const contextStr = context ? ` ${JSON.stringify(context)}` : ''\n  return `[@seed-ship/mcp-ui-solid:${feature}] ${message}${contextStr}`\n}\n\n/**\n * Creates a feature-scoped logger\n *\n * @param feature - Feature name for log prefixing\n * @returns Logger instance\n *\n * @example\n * ```typescript\n * const logger = createLogger('my-component')\n * logger.info('Component mounted', { componentId: '123' })\n * ```\n */\nexport function createLogger(feature: string): Logger {\n  return {\n    info(message: string, context?: Record<string, unknown>) {\n      if (isDev) {\n        console.info(formatLogMessage(feature, message, context))\n      }\n    },\n\n    warn(message: string, context?: Record<string, unknown>) {\n      if (isDev) {\n        console.warn(formatLogMessage(feature, message, context))\n      }\n    },\n\n    error(message: string, context?: Record<string, unknown>) {\n      // Always log errors, even in production\n      console.error(formatLogMessage(feature, message, context))\n    },\n\n    debug(message: string, context?: Record<string, unknown>) {\n      if (isDev) {\n        console.debug(formatLogMessage(feature, message, context))\n      }\n    },\n  }\n}\n\n/**\n * No-op logger for testing or when logging is disabled\n */\nexport const noopLogger: Logger = {\n  info: () => {},\n  warn: () => {},\n  error: () => {},\n  debug: () => {},\n}\n"],"names":[],"mappings":";;AAQA,MAAM,QAAQ,OAAO,YAAY,eAAe,QAAQ,IAAI,aAAa;AASzE,SAAS,iBACP,SACA,SACA,SACQ;AACR,QAAM,aAAa,UAAU,IAAI,KAAK,UAAU,OAAO,CAAC,KAAK;AAC7D,SAAO,4BAA4B,OAAO,KAAK,OAAO,GAAG,UAAU;AACrE;AAcO,SAAS,aAAa,SAAyB;AACpD,SAAO;AAAA,IACL,KAAK,SAAiB,SAAmC;AACvD,UAAI,OAAO;AACT,gBAAQ,KAAK,iBAAiB,SAAS,SAAS,OAAO,CAAC;AAAA,MAC1D;AAAA,IACF;AAAA,IAEA,KAAK,SAAiB,SAAmC;AACvD,UAAI,OAAO;AACT,gBAAQ,KAAK,iBAAiB,SAAS,SAAS,OAAO,CAAC;AAAA,MAC1D;AAAA,IACF;AAAA,IAEA,MAAM,SAAiB,SAAmC;AAExD,cAAQ,MAAM,iBAAiB,SAAS,SAAS,OAAO,CAAC;AAAA,IAC3D;AAAA,IAEA,MAAM,SAAiB,SAAmC;AACxD,UAAI,OAAO;AACT,gBAAQ,MAAM,iBAAiB,SAAS,SAAS,OAAO,CAAC;AAAA,MAC3D;AAAA,IACF;AAAA,EAAA;AAEJ;;"}

package/dist/mcp-ui-solid/src/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sources":["../../../../src/utils/logger.ts"],"sourcesContent":["/**\n * Simple internal logger utility\n *\n * Provides basic logging functionality for the package.\n * Consumers can disable logging by setting NODE_ENV=production\n * or by implementing their own logging solution.\n */\n\nconst isDev = typeof process !== 'undefined' && process.env.NODE_ENV !== 'production'\n\nexport interface Logger {\n  info(message: string, context?: Record<string, unknown>): void\n  warn(message: string, context?: Record<string, unknown>): void\n  error(message: string, context?: Record<string, unknown>): void\n  debug(message: string, context?: Record<string, unknown>): void\n}\n\nfunction formatLogMessage(\n  feature: string,\n  message: string,\n  context?: Record<string, unknown>\n): string {\n  const contextStr = context ? ` ${JSON.stringify(context)}` : ''\n  return `[@seed-ship/mcp-ui-solid:${feature}] ${message}${contextStr}`\n}\n\n/**\n * Creates a feature-scoped logger\n *\n * @param feature - Feature name for log prefixing\n * @returns Logger instance\n *\n * @example\n * ```typescript\n * const logger = createLogger('my-component')\n * logger.info('Component mounted', { componentId: '123' })\n * ```\n */\nexport function createLogger(feature: string): Logger {\n  return {\n    info(message: string, context?: Record<string, unknown>) {\n      if (isDev) {\n        console.info(formatLogMessage(feature, message, context))\n      }\n    },\n\n    warn(message: string, context?: Record<string, unknown>) {\n      if (isDev) {\n        console.warn(formatLogMessage(feature, message, context))\n      }\n    },\n\n    error(message: string, context?: Record<string, unknown>) {\n      // Always log errors, even in production\n      console.error(formatLogMessage(feature, message, context))\n    },\n\n    debug(message: string, context?: Record<string, unknown>) {\n      if (isDev) {\n        console.debug(formatLogMessage(feature, message, context))\n      }\n    },\n  }\n}\n\n/**\n * No-op logger for testing or when logging is disabled\n */\nexport const noopLogger: Logger = {\n  info: () => {},\n  warn: () => {},\n  error: () => {},\n  debug: () => {},\n}\n"],"names":[],"mappings":"AAQA,MAAM,QAAQ,OAAO,YAAY,eAAe,QAAQ,IAAI,aAAa;AASzE,SAAS,iBACP,SACA,SACA,SACQ;AACR,QAAM,aAAa,UAAU,IAAI,KAAK,UAAU,OAAO,CAAC,KAAK;AAC7D,SAAO,4BAA4B,OAAO,KAAK,OAAO,GAAG,UAAU;AACrE;AAcO,SAAS,aAAa,SAAyB;AACpD,SAAO;AAAA,IACL,KAAK,SAAiB,SAAmC;AACvD,UAAI,OAAO;AACT,gBAAQ,KAAK,iBAAiB,SAAS,SAAS,OAAO,CAAC;AAAA,MAC1D;AAAA,IACF;AAAA,IAEA,KAAK,SAAiB,SAAmC;AACvD,UAAI,OAAO;AACT,gBAAQ,KAAK,iBAAiB,SAAS,SAAS,OAAO,CAAC;AAAA,MAC1D;AAAA,IACF;AAAA,IAEA,MAAM,SAAiB,SAAmC;AAExD,cAAQ,MAAM,iBAAiB,SAAS,SAAS,OAAO,CAAC;AAAA,IAC3D;AAAA,IAEA,MAAM,SAAiB,SAAmC;AACxD,UAAI,OAAO;AACT,gBAAQ,MAAM,iBAAiB,SAAS,SAAS,OAAO,CAAC;AAAA,MAC3D;AAAA,IACF;AAAA,EAAA;AAEJ;"}