@seed-ship/mcp-ui-solid 1.0.2 → 1.0.3

package/dist/components/GenerativeUIErrorBoundary.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Generative UI Error Boundary with Telemetry
+ * Phase 0: Error isolation + structured logging
+ *
+ * Features:
+ * - Component-level error isolation
+ * - Structured logging with context
+ * - Performance timing
+ * - Retry mechanism
+ * - User-friendly fallback UI
+ */
+import { Component } from 'solid-js';
+import type { RendererError } from '../types';
+/**
+ * Props for GenerativeUIErrorBoundary
+ */
+export interface GenerativeUIErrorBoundaryProps {
+    /**
+     * Component identifier for telemetry
+     */
+    componentId: string;
+    /**
+     * Component type for context
+     */
+    componentType: string;
+    /**
+     * Error callback
+     */
+    onError?: (error: RendererError) => void;
+    /**
+     * Allow retry on error
+     */
+    allowRetry?: boolean;
+    /**
+     * Child components to wrap
+     */
+    children: any;
+    /**
+     * Custom fallback UI (optional)
+     */
+    fallback?: (error: Error, retry?: () => void) => any;
+}
+/**
+ * Generative UI Error Boundary Component
+ */
+export declare const GenerativeUIErrorBoundary: Component<GenerativeUIErrorBoundaryProps>;
+/**
+ * Performance monitoring wrapper
+ * Logs render times for performance analysis
+ */
+export declare function withPerformanceMonitoring<P extends {
+    componentId: string;
+    componentType: string;
+}>(WrappedComponent: Component<P>): (props: P) => import("solid-js").JSX.Element;
+/**
+ * Hook to track component lifecycle events
+ */
+export declare function useComponentTelemetry(componentId: string, componentType: string): () => void;
+//# sourceMappingURL=GenerativeUIErrorBoundary.d.ts.map

package/dist/components/GenerativeUIErrorBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GenerativeUIErrorBoundary.d.ts","sourceRoot":"","sources":["../../src/components/GenerativeUIErrorBoundary.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAqC,MAAM,UAAU,CAAA;AAEvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAI7C;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,WAAW,EAAE,MAAM,CAAA;IAEnB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAA;IAExC;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IAEpB;;OAEG;IACH,QAAQ,EAAE,GAAG,CAAA;IAEb;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM,IAAI,KAAK,GAAG,CAAA;CACrD;AAwDD;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,CAAC,8BAA8B,CAkF/E,CAAA;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,EAChG,gBAAgB,EAAE,SAAS,CAAC,CAAC,CAAC,IAEtB,OAAO,CAAC,oCAkCjB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,cAkB/E"}

package/dist/components/StreamingUIRenderer.d.ts

@@ -0,0 +1,32 @@
+/**
+ * StreamingUIRenderer Component - Phase 2
+ *
+ * Renders streaming dashboard components with skeleton states and progress indicators.
+ * Uses the useStreamingUI hook for SSE connection and state management.
+ *
+ * Features:
+ * - Skeleton loading states while components stream
+ * - Progress bar and status messages
+ * - Smooth component animations on arrival
+ * - Error handling with retry capability
+ * - Responsive 12-column grid layout
+ *
+ * Usage:
+ * ```tsx
+ * <StreamingUIRenderer
+ *   query="Show me revenue trends"
+ *   spaceIds={['uuid1', 'uuid2']}
+ *   onComplete={(metadata) => console.log('Done!', metadata)}
+ * />
+ * ```
+ */
+import { type UseStreamingUIOptions } from '../hooks/useStreamingUI';
+import type { RendererError } from '../types';
+export interface StreamingUIRendererProps extends UseStreamingUIOptions {
+    class?: string;
+    showProgress?: boolean;
+    showMetadata?: boolean;
+    onRenderError?: (error: RendererError) => void;
+}
+export declare function StreamingUIRenderer(props: StreamingUIRendererProps): import("solid-js").JSX.Element;
+//# sourceMappingURL=StreamingUIRenderer.d.ts.map

package/dist/components/StreamingUIRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamingUIRenderer.d.ts","sourceRoot":"","sources":["../../src/components/StreamingUIRenderer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EAAkB,KAAK,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AACpF,OAAO,KAAK,EAAe,aAAa,EAAE,MAAM,UAAU,CAAA;AAI1D,MAAM,WAAW,wBAAyB,SAAQ,qBAAqB;IACrE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAA;CAC/C;AAkED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,kCA2KlE"}

package/dist/components/UIResourceRenderer.d.ts

@@ -0,0 +1,43 @@
+/**
+ * UI Resource Renderer Component
+ * Phase 0: Foundation with iframe sandbox and composite grid support
+ *
+ * Security features:
+ * - Sandboxed iframes for untrusted content
+ * - CSP enforcement via middleware
+ * - XSS prevention with DOMPurify
+ * - Domain whitelist validation
+ *
+ * Performance:
+ * - Lazy loading with Intersection Observer
+ * - Render timeout enforcement
+ * - Error boundaries for isolation
+ */
+import { Component } from 'solid-js';
+import type { UIComponent, UILayout, RendererError } from '../types';
+/**
+ * Props for UIResourceRenderer
+ */
+export interface UIResourceRendererProps {
+    /**
+     * Single component or full layout to render
+     */
+    content: UIComponent | UILayout;
+    /**
+     * Lazy loading (default: true)
+     */
+    lazyLoad?: boolean;
+    /**
+     * Error callback
+     */
+    onError?: (error: RendererError) => void;
+    /**
+     * Custom CSS class
+     */
+    class?: string;
+}
+/**
+ * Main UIResourceRenderer component
+ */
+export declare const UIResourceRenderer: Component<UIResourceRendererProps>;
+//# sourceMappingURL=UIResourceRenderer.d.ts.map

package/dist/components/UIResourceRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UIResourceRenderer.d.ts","sourceRoot":"","sources":["../../src/components/UIResourceRenderer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,SAAS,EAAoC,MAAM,UAAU,CAAA;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAiB,MAAM,UAAU,CAAA;AAInF;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,OAAO,EAAE,WAAW,GAAG,QAAQ,CAAA;IAE/B;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAA;IAExC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AA8QD;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,CAAC,uBAAuB,CA6CjE,CAAA"}

package/dist/components/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * MCP UI Solid - Components
+ *
+ * SolidJS components for rendering MCP-generated UI resources
+ */
+export { UIResourceRenderer } from './UIResourceRenderer';
+export type { UIResourceRendererProps } from './UIResourceRenderer';
+export { StreamingUIRenderer } from './StreamingUIRenderer';
+export type { StreamingUIRendererProps } from './StreamingUIRenderer';
+export { GenerativeUIErrorBoundary } from './GenerativeUIErrorBoundary';
+export type { GenerativeUIErrorBoundaryProps } from './GenerativeUIErrorBoundary';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACzD,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAEnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAC3D,YAAY,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAA;AAErE,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AACvE,YAAY,EAAE,8BAA8B,EAAE,MAAM,6BAA6B,CAAA"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MCP UI Solid - Hooks
+ *
+ * SolidJS hooks for managing UI resource state and streaming
+ */
+export { useStreamingUI } from './useStreamingUI';
+export type { UseStreamingUIOptions, StreamingUIState, StreamProgress, StreamError, CompleteMetadata, } from './useStreamingUI';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,YAAY,EACV,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,gBAAgB,GACjB,MAAM,kBAAkB,CAAA"}

package/dist/hooks/useStreamingUI.d.ts

@@ -0,0 +1,79 @@
+/**
+ * useStreamingUI Hook - Phase 2
+ *
+ * Client-side hook for consuming the streaming generative UI endpoint.
+ * Handles SSE connection, component buffering, reordering, and error handling.
+ *
+ * Features:
+ * - SSE connection with automatic reconnection
+ * - Component buffering and reordering by sequenceId
+ * - Progress tracking and loading states
+ * - Error handling with recovery attempts
+ * - Cleanup on unmount
+ *
+ * Usage:
+ * ```tsx
+ * const { components, isLoading, error, progress } = useStreamingUI({
+ *   query: 'Show me revenue trends',
+ *   spaceIds: ['uuid1', 'uuid2'],
+ *   onComplete: (metadata) => console.log('Done!', metadata),
+ * })
+ * ```
+ */
+import type { UIComponent } from '../types';
+export interface UseStreamingUIOptions {
+    query: string;
+    spaceIds?: string[];
+    sessionId?: string;
+    options?: {
+        useCache?: boolean;
+        useLLM?: boolean;
+        maxComponents?: number;
+        preferredComponents?: Array<'chart' | 'table' | 'metric' | 'text'>;
+    };
+    onComplete?: (metadata: CompleteMetadata) => void;
+    onError?: (error: StreamError) => void;
+    onComponentReceived?: (component: UIComponent) => void;
+}
+export interface StreamingUIState {
+    components: UIComponent[];
+    isLoading: boolean;
+    isStreaming: boolean;
+    error: StreamError | null;
+    progress: StreamProgress;
+    metadata: CompleteMetadata | null;
+}
+export interface StreamProgress {
+    receivedCount: number;
+    totalCount: number | null;
+    message: string;
+    timestamp: string;
+}
+export interface CompleteMetadata {
+    layoutId: string;
+    componentsCount: number;
+    executionTimeMs: number;
+    firstTokenMs: number;
+    provider: 'groq' | 'mock';
+    model: string;
+    tokensUsed?: number;
+    costUSD?: number;
+    cached: boolean;
+}
+export interface StreamError {
+    error: string;
+    message: string;
+    componentId?: string;
+    recoverable: boolean;
+}
+export declare function useStreamingUI(options: UseStreamingUIOptions): {
+    components: import("solid-js").Accessor<UIComponent[]>;
+    isLoading: import("solid-js").Accessor<boolean>;
+    isStreaming: import("solid-js").Accessor<boolean>;
+    error: import("solid-js").Accessor<StreamError | null>;
+    progress: import("solid-js").Accessor<StreamProgress>;
+    metadata: import("solid-js").Accessor<CompleteMetadata | null>;
+    startStreaming: () => void;
+    stopStreaming: () => void;
+};
+//# sourceMappingURL=useStreamingUI.d.ts.map

package/dist/hooks/useStreamingUI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStreamingUI.d.ts","sourceRoot":"","sources":["../../src/hooks/useStreamingUI.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAS3C,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,MAAM,CAAC,EAAE,OAAO,CAAA;QAChB,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB,mBAAmB,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAA;KACnE,CAAA;IACD,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAA;IACjD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAA;IACtC,mBAAmB,CAAC,EAAE,CAAC,SAAS,EAAE,WAAW,KAAK,IAAI,CAAA;CACvD;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,WAAW,EAAE,CAAA;IACzB,SAAS,EAAE,OAAO,CAAA;IAClB,WAAW,EAAE,OAAO,CAAA;IACpB,KAAK,EAAE,WAAW,GAAG,IAAI,CAAA;IACzB,QAAQ,EAAE,cAAc,CAAA;IACxB,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAA;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,eAAe,EAAE,MAAM,CAAA;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,OAAO,CAAA;CACrB;AAuCD,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB;;;;;;;;;EAsU5D"}

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @seed-ship/mcp-ui-solid
+ *
+ * SolidJS components and hooks for rendering MCP-generated UI resources
+ *
+ * @example
+ * ```tsx
+ * import { UIResourceRenderer, StreamingUIRenderer } from '@seed-ship/mcp-ui-solid'
+ * import { useStreamingUI } from '@seed-ship/mcp-ui-solid/hooks'
+ * import type { UIComponent, UILayout } from '@seed-ship/mcp-ui-solid/types'
+ *
+ * // Static rendering
+ * function Dashboard() {
+ *   const layout = { components: [...] }
+ *   return <UIResourceRenderer content={layout} />
+ * }
+ *
+ * // Streaming rendering
+ * function StreamingDashboard() {
+ *   return (
+ *     <StreamingUIRenderer
+ *       query="Show me revenue trends"
+ *       spaceIds={['space-1']}
+ *       onComplete={(metadata) => console.log('Done!', metadata)}
+ *     />
+ *   )
+ * }
+ * ```
+ */
+export { UIResourceRenderer, StreamingUIRenderer, GenerativeUIErrorBoundary } from './components';
+export type { UIResourceRendererProps, StreamingUIRendererProps, GenerativeUIErrorBoundaryProps, } from './components';
+export { useStreamingUI } from './hooks';
+export type { UseStreamingUIOptions, StreamingUIState, StreamProgress, StreamError, CompleteMetadata, } from './hooks';
+export type { UIComponent, UILayout, GridPosition, ComponentType, RendererError, ChartComponentParams, TableComponentParams, MetricComponentParams, TextComponentParams, } from './types';
+export { validateComponent, validateLayout, DEFAULT_RESOURCE_LIMITS, ComponentRegistry, } from './services';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAA;AAEjG,YAAY,EACV,uBAAuB,EACvB,wBAAwB,EACxB,8BAA8B,GAC/B,MAAM,cAAc,CAAA;AAGrB,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAExC,YAAY,EACV,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,gBAAgB,GACjB,MAAM,SAAS,CAAA;AAGhB,YAAY,EACV,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,SAAS,CAAA;AAGhB,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,YAAY,CAAA"}

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

@@ -0,0 +1,50 @@
+/**
+ * Component Registry Service
+ * Phase 0: Static registry with Quickchart and Table definitions
+ * Phase 1: Dynamic registry populated from /api/mcp/tools/list
+ *
+ * Provides component schemas for LLM prompt engineering
+ */
+import type { ComponentRegistryEntry, ComponentType } from '../types';
+/**
+ * Quickchart Component Registry Entry
+ * Based on Quickchart API documentation
+ */
+export declare const QuickchartRegistry: ComponentRegistryEntry;
+/**
+ * Table Component Registry Entry
+ */
+export declare const TableRegistry: ComponentRegistryEntry;
+/**
+ * Metric Card Component Registry Entry
+ */
+export declare const MetricRegistry: ComponentRegistryEntry;
+/**
+ * Text Component Registry Entry
+ */
+export declare const TextRegistry: ComponentRegistryEntry;
+/**
+ * Component Registry - All components indexed by type
+ */
+export declare const ComponentRegistry: Map<ComponentType, ComponentRegistryEntry>;
+/**
+ * Get component registry entry by type
+ */
+export declare function getComponentEntry(type: ComponentType): ComponentRegistryEntry | undefined;
+/**
+ * Get all component types
+ */
+export declare function getAllComponentTypes(): ComponentType[];
+/**
+ * Get registry as JSON for LLM context
+ */
+export declare function getRegistryForLLM(): string;
+/**
+ * Validate component against registry schema
+ * (Future: Use Zod for runtime validation)
+ */
+export declare function validateAgainstRegistry(componentType: ComponentType, params: any): {
+    valid: boolean;
+    errors?: string[];
+};
+//# sourceMappingURL=component-registry.d.ts.map

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

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

package/dist/services/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MCP UI Solid - Services
+ *
+ * Business logic for component validation and registry management
+ */
+export { validateComponent, validateLayout, DEFAULT_RESOURCE_LIMITS } from './validation';
+export { ComponentRegistry } from './component-registry';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AAEzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/services/validation.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Component Validation Service
+ * Phase 0: Resource Limits & Schema Validation
+ *
+ * Validates LLM-generated components against:
+ * - JSON schema
+ * - Resource limits (data points, payload size, grid bounds)
+ * - Security constraints (domain whitelist, XSS prevention)
+ */
+import type { UIComponent, UILayout, ValidationResult, ResourceLimits, ChartComponentParams, TableComponentParams } from '../types';
+/**
+ * Default resource limits (configurable via env)
+ */
+export declare const DEFAULT_RESOURCE_LIMITS: ResourceLimits;
+/**
+ * Validate grid position bounds (1-12 columns)
+ */
+export declare function validateGridPosition(position: UIComponent['position']): ValidationResult;
+/**
+ * Validate chart component against resource limits
+ */
+export declare function validateChartComponent(params: ChartComponentParams, limits?: ResourceLimits): ValidationResult;
+/**
+ * Validate table component against resource limits
+ */
+export declare function validateTableComponent(params: TableComponentParams, limits?: ResourceLimits): ValidationResult;
+/**
+ * Validate payload size
+ */
+export declare function validatePayloadSize(component: UIComponent, limits?: ResourceLimits): ValidationResult;
+/**
+ * Sanitize string to prevent XSS
+ * Basic implementation - DOMPurify used at render time
+ */
+export declare function sanitizeString(input: string): string;
+/**
+ * Validate iframe domain against whitelist
+ */
+export declare function validateIframeDomain(url: string): ValidationResult;
+/**
+ * Validate entire component
+ */
+export declare function validateComponent(component: UIComponent, limits?: ResourceLimits): ValidationResult;
+/**
+ * Validate entire layout
+ */
+export declare function validateLayout(layout: UILayout, limits?: ResourceLimits): ValidationResult;
+//# sourceMappingURL=validation.d.ts.map

package/dist/services/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/services/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,QAAQ,EACR,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,UAAU,CAAA;AAEjB;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,cAKrC,CAAA;AAcD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,WAAW,CAAC,UAAU,CAAC,GAAG,gBAAgB,CA+CxF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,oBAAoB,EAC5B,MAAM,GAAE,cAAwC,GAC/C,gBAAgB,CA8ClB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,oBAAoB,EAC5B,MAAM,GAAE,cAAwC,GAC/C,gBAAgB,CAmDlB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,WAAW,EACtB,MAAM,GAAE,cAAwC,GAC/C,gBAAgB,CAiBlB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAmClE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,WAAW,EACtB,MAAM,GAAE,cAAwC,GAC/C,gBAAgB,CAmElB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,QAAQ,EAChB,MAAM,GAAE,cAAwC,GAC/C,gBAAgB,CA8ClB"}

package/dist/types/index.d.ts

@@ -0,0 +1,250 @@
+/**
+ * Generative MCP UI - Type Definitions
+ * Phase 0-3 Implementation
+ *
+ * Defines the contract for LLM-generated UI components
+ */
+/**
+ * Component types supported by the renderer
+ */
+export type ComponentType = 'chart' | 'table' | 'metric' | 'text' | 'grid';
+/**
+ * Chart types (powered by Quickchart)
+ */
+export type ChartType = 'bar' | 'line' | 'pie' | 'doughnut' | 'radar' | 'scatter';
+/**
+ * Grid layout specification (12-column system)
+ */
+export interface GridPosition {
+    /**
+     * Column start (1-12)
+     */
+    colStart: number;
+    /**
+     * Column span (1-12)
+     */
+    colSpan: number;
+    /**
+     * Row start (1-based, auto-increment if not specified)
+     */
+    rowStart?: number;
+    /**
+     * Row span (default: 1)
+     */
+    rowSpan?: number;
+}
+/**
+ * Component resource limits (SECURITY)
+ */
+export interface ResourceLimits {
+    /**
+     * Max data points per chart (default: 1000)
+     */
+    maxDataPoints: number;
+    /**
+     * Max table rows (default: 100, pagination required)
+     */
+    maxTableRows: number;
+    /**
+     * Max payload size in bytes (default: 50KB)
+     */
+    maxPayloadSize: number;
+    /**
+     * Iframe render timeout in ms (default: 5000ms)
+     */
+    renderTimeout: number;
+}
+/**
+ * Chart component parameters
+ */
+export interface ChartComponentParams {
+    type: ChartType;
+    title?: string;
+    data: {
+        labels: string[];
+        datasets: Array<{
+            label: string;
+            data: number[];
+            backgroundColor?: string | string[];
+            borderColor?: string | string[];
+            borderWidth?: number;
+        }>;
+    };
+    options?: {
+        responsive?: boolean;
+        maintainAspectRatio?: boolean;
+        tension?: number;
+        scales?: any;
+        plugins?: any;
+    };
+}
+/**
+ * Table component parameters
+ */
+export interface TableComponentParams {
+    title?: string;
+    columns: Array<{
+        key: string;
+        label: string;
+        sortable?: boolean;
+        width?: string;
+    }>;
+    rows: Array<Record<string, any>>;
+    pagination?: {
+        currentPage: number;
+        pageSize: number;
+        totalRows: number;
+    };
+}
+/**
+ * Metric card component parameters
+ */
+export interface MetricComponentParams {
+    title: string;
+    value: string | number;
+    unit?: string;
+    trend?: {
+        value: number;
+        direction: 'up' | 'down' | 'neutral';
+    };
+    subtitle?: string;
+    icon?: string;
+}
+/**
+ * Text component parameters
+ */
+export interface TextComponentParams {
+    content: string;
+    markdown?: boolean;
+    className?: string;
+}
+/**
+ * UI Component definition (generated by LLM)
+ */
+export interface UIComponent {
+    /**
+     * Unique component ID
+     */
+    id: string;
+    /**
+     * Component type
+     */
+    type: ComponentType;
+    /**
+     * Grid position
+     */
+    position: GridPosition;
+    /**
+     * Component parameters (type-specific)
+     */
+    params: ChartComponentParams | TableComponentParams | MetricComponentParams | TextComponentParams;
+    /**
+     * Metadata for observability
+     */
+    metadata?: {
+        generatedAt: string;
+        llmModel?: string;
+        confidence?: number;
+        toolsUsed?: string[];
+    };
+}
+/**
+ * UI Layout (collection of components)
+ */
+export interface UILayout {
+    /**
+     * Layout ID
+     */
+    id: string;
+    /**
+     * Components in the layout
+     */
+    components: UIComponent[];
+    /**
+     * Grid configuration
+     */
+    grid: {
+        columns: number;
+        gap: string;
+        minRowHeight?: string;
+    };
+    /**
+     * Layout metadata
+     */
+    metadata?: {
+        query: string;
+        generatedAt: string;
+        llmModel?: string;
+        totalComponents: number;
+    };
+}
+/**
+ * Component registry entry
+ */
+export interface ComponentRegistryEntry {
+    /**
+     * Component type identifier
+     */
+    type: ComponentType;
+    /**
+     * Component name
+     */
+    name: string;
+    /**
+     * Component description (for LLM context)
+     */
+    description: string;
+    /**
+     * JSON schema for validation
+     */
+    schema: any;
+    /**
+     * Example usage (for LLM few-shot prompting)
+     */
+    examples: Array<{
+        query: string;
+        component: UIComponent;
+    }>;
+    /**
+     * Resource limits
+     */
+    limits: ResourceLimits;
+}
+/**
+ * Component validation result
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors?: Array<{
+        path: string;
+        message: string;
+        code: string;
+    }>;
+}
+/**
+ * Renderer error types
+ */
+export type RendererErrorType = 'validation' | 'render' | 'timeout' | 'resource_limit' | 'network' | 'security';
+/**
+ * Renderer error
+ */
+export interface RendererError {
+    type: RendererErrorType;
+    message: string;
+    componentId?: string;
+    details?: any;
+}
+/**
+ * Streaming event types (Phase 2)
+ */
+export type StreamEventType = 'status' | 'component-start' | 'component' | 'component-complete' | 'error' | 'complete';
+/**
+ * Streaming event (Phase 2)
+ */
+export interface StreamEvent {
+    event: StreamEventType;
+    data: any;
+    sequenceId?: number;
+    timestamp: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Simple internal logger utility
+ *
+ * Provides basic logging functionality for the package.
+ * Consumers can disable logging by setting NODE_ENV=production
+ * or by implementing their own logging solution.
+ */
+export interface Logger {
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+    debug(message: string, context?: Record<string, unknown>): void;
+}
+/**
+ * Creates a feature-scoped logger
+ *
+ * @param feature - Feature name for log prefixing
+ * @returns Logger instance
+ *
+ * @example
+ * ```typescript
+ * const logger = createLogger('my-component')
+ * logger.info('Component mounted', { componentId: '123' })
+ * ```
+ */
+export declare function createLogger(feature: string): Logger;
+/**
+ * No-op logger for testing or when logging is disabled
+ */
+export declare const noopLogger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC/D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CAChE;AAWD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAyBpD;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,MAKxB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seed-ship/mcp-ui-solid",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "SolidJS components for rendering MCP-generated UI resources",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -73,7 +73,7 @@
     "url": "https://github.com/theseedship/mcp-ui/issues"
   },
   "scripts": {
-    "build": "vite build",
+    "build": "vite build && pnpm build:types",
     "build:types": "tsc --emitDeclarationOnly --outDir dist --skipLibCheck",
     "dev": "vite build --watch",
     "test": "vitest run",