@backbay/glia 0.2.0-alpha.1

package/dist/workspace/registry/registry.js

@@ -0,0 +1,232 @@
+/**
+ * Component Registry Implementation
+ *
+ * Provides query and composition APIs for agents to discover
+ * and use UI components.
+ */
+import { allManifests, manifestById, manifestsByCategory } from "./manifests";
+/**
+ * Default registry implementation using static manifests
+ */
+class DefaultRegistry {
+    manifests;
+    byId;
+    byCategory;
+    constructor(manifests = allManifests) {
+        this.manifests = manifests;
+        this.byId = new Map(manifests.map((m) => [m.id, m]));
+        this.byCategory = manifests.reduce((acc, m) => {
+            if (!acc[m.category])
+                acc[m.category] = [];
+            acc[m.category].push(m);
+            return acc;
+        }, {});
+    }
+    /**
+     * Get a component by ID
+     */
+    get(id) {
+        return this.byId.get(id);
+    }
+    /**
+     * List components with optional filtering
+     */
+    list(query) {
+        if (!query)
+            return this.manifests;
+        let results = [...this.manifests];
+        // Filter by category
+        if (query.category) {
+            results = results.filter((m) => m.category === query.category);
+        }
+        // Filter by purpose
+        if (query.purpose) {
+            const purposes = Array.isArray(query.purpose)
+                ? query.purpose
+                : [query.purpose];
+            results = results.filter((m) => purposes.some((p) => m.purpose.includes(p)));
+        }
+        // Filter by style
+        if (query.style) {
+            const styles = Array.isArray(query.style) ? query.style : [query.style];
+            results = results.filter((m) => styles.some((s) => m.styles.includes(s)));
+        }
+        // Filter by tags
+        if (query.tags && query.tags.length > 0) {
+            results = results.filter((m) => query.tags.some((t) => m.tags.includes(t)));
+        }
+        // Filter by slots
+        if (query.hasSlots !== undefined) {
+            results = results.filter((m) => (m.slots && m.slots.length > 0) === query.hasSlots);
+        }
+        // Filter by children support
+        if (query.supportsChildren !== undefined) {
+            results = results.filter((m) => (m.validChildren && m.validChildren.length > 0) ===
+                query.supportsChildren);
+        }
+        // Free-text search
+        if (query.search) {
+            const searchLower = query.search.toLowerCase();
+            results = results.filter((m) => m.name.toLowerCase().includes(searchLower) ||
+                m.description.toLowerCase().includes(searchLower) ||
+                m.tags.some((t) => t.includes(searchLower)) ||
+                m.bestFor.some((b) => b.toLowerCase().includes(searchLower)));
+        }
+        // Limit results
+        if (query.limit && query.limit > 0) {
+            results = results.slice(0, query.limit);
+        }
+        return results;
+    }
+    /**
+     * Search with relevance scoring
+     */
+    search(query) {
+        const queryLower = query.toLowerCase();
+        const queryTokens = queryLower.split(/\s+/).filter((t) => t.length > 2);
+        const results = this.manifests.map((component) => {
+            let score = 0;
+            const matchedOn = [];
+            // Name match (highest weight)
+            if (component.name.toLowerCase().includes(queryLower)) {
+                score += 0.4;
+                matchedOn.push("name");
+            }
+            // ID match
+            if (component.id.toLowerCase().includes(queryLower)) {
+                score += 0.2;
+                matchedOn.push("id");
+            }
+            // Description match
+            const descLower = component.description.toLowerCase();
+            if (descLower.includes(queryLower)) {
+                score += 0.15;
+                matchedOn.push("description");
+            }
+            // Tag matches
+            const matchedTags = component.tags.filter((t) => queryTokens.some((qt) => t.includes(qt)));
+            if (matchedTags.length > 0) {
+                score += 0.1 * Math.min(matchedTags.length, 3);
+                matchedOn.push(`tags:${matchedTags.join(",")}`);
+            }
+            // bestFor matches
+            const matchedBestFor = component.bestFor.filter((b) => queryTokens.some((qt) => b.toLowerCase().includes(qt)));
+            if (matchedBestFor.length > 0) {
+                score += 0.1 * Math.min(matchedBestFor.length, 2);
+                matchedOn.push("bestFor");
+            }
+            // Purpose matches
+            const matchedPurposes = component.purpose.filter((p) => queryTokens.some((qt) => p.includes(qt)));
+            if (matchedPurposes.length > 0) {
+                score += 0.05 * matchedPurposes.length;
+                matchedOn.push(`purpose:${matchedPurposes.join(",")}`);
+            }
+            return { component, score, matchedOn };
+        });
+        // Sort by score descending, filter out zero scores
+        return results
+            .filter((r) => r.score > 0)
+            .sort((a, b) => b.score - a.score);
+    }
+    /**
+     * Check if a component can be placed inside another
+     */
+    canCompose(parentId, childId) {
+        const parent = this.get(parentId);
+        const child = this.get(childId);
+        if (!parent || !child)
+            return false;
+        // Check if parent accepts this child
+        if (parent.validChildren) {
+            if (parent.validChildren.includes("*") ||
+                parent.validChildren.includes(childId)) {
+                return true;
+            }
+        }
+        // Check if child accepts this parent
+        if (child.validParents) {
+            if (child.validParents.includes("*") ||
+                child.validParents.includes(parentId)) {
+                return true;
+            }
+        }
+        // Check incompatibilities
+        if (parent.incompatibleWith?.includes(childId))
+            return false;
+        if (child.incompatibleWith?.includes(parentId))
+            return false;
+        // Default: allow if parent has slots
+        return parent.slots !== undefined && parent.slots.length > 0;
+    }
+    /**
+     * Get components that can be children of the given parent
+     */
+    getValidChildren(parentId) {
+        const parent = this.get(parentId);
+        if (!parent)
+            return [];
+        return this.manifests.filter((child) => this.canCompose(parentId, child.id));
+    }
+    /**
+     * Get components that can be parents of the given child
+     */
+    getValidParents(childId) {
+        const child = this.get(childId);
+        if (!child)
+            return [];
+        return this.manifests.filter((parent) => this.canCompose(parent.id, childId));
+    }
+    /**
+     * Get all categories
+     */
+    categories() {
+        return Object.keys(this.byCategory);
+    }
+    /**
+     * Get all purposes used across components
+     */
+    purposes() {
+        const purposes = new Set();
+        this.manifests.forEach((m) => m.purpose.forEach((p) => purposes.add(p)));
+        return Array.from(purposes);
+    }
+    /**
+     * Get all tags used across components
+     */
+    tags() {
+        const tags = new Set();
+        this.manifests.forEach((m) => m.tags.forEach((t) => tags.add(t)));
+        return Array.from(tags).sort();
+    }
+    /**
+     * Get total component count
+     */
+    count() {
+        return this.manifests.length;
+    }
+}
+/**
+ * Singleton registry instance
+ */
+let registryInstance = null;
+/**
+ * Get the component registry
+ */
+export function getRegistry() {
+    if (!registryInstance) {
+        registryInstance = new DefaultRegistry();
+    }
+    return registryInstance;
+}
+/**
+ * Create a registry with custom manifests
+ */
+export function createRegistry(manifests) {
+    return new DefaultRegistry(manifests);
+}
+/**
+ * Export registry for direct use
+ */
+export const registry = getRegistry();
+// Re-export for convenience
+export { manifestById, manifestsByCategory, allManifests };

package/dist/workspace/registry/types.d.ts

@@ -0,0 +1,133 @@
+/**
+ * AG-UI Component Registry Types
+ *
+ * Defines the schema for component manifests that enable agents
+ * to discover, understand, and compose UI components.
+ */
+import type { ComponentType } from "react";
+/**
+ * Component categories for organization and filtering
+ */
+export type ComponentCategory = "atoms" | "molecules" | "organisms" | "layouts" | "three" | "ambient";
+/**
+ * Semantic purpose tags that help agents select appropriate components
+ */
+export type ComponentPurpose = "call-to-action" | "navigation" | "confirmation" | "destructive-action" | "data-display" | "status-indicator" | "progress-feedback" | "notification" | "text-input" | "selection" | "toggle" | "container" | "grid-layout" | "overlay" | "modal" | "background" | "decoration" | "visualization" | "animation";
+/**
+ * Interaction patterns the component supports
+ */
+export type InteractionPattern = "click" | "hover" | "focus" | "drag" | "keyboard" | "touch" | "scroll" | "resize";
+/**
+ * Accessibility features the component implements
+ */
+export type A11yFeature = "aria-labels" | "keyboard-nav" | "focus-visible" | "screen-reader" | "reduced-motion" | "high-contrast";
+/**
+ * Visual style characteristics
+ */
+export type VisualStyle = "minimal" | "glassmorphism" | "neon" | "cyberpunk" | "retro" | "3d" | "animated" | "gradient";
+export type PropType = "string" | "number" | "boolean" | "array" | "object" | "function" | "ReactNode" | "enum";
+export interface PropSchema {
+    type: PropType;
+    description: string;
+    required?: boolean;
+    default?: unknown;
+    enum?: string[];
+    items?: PropSchema;
+    properties?: Record<string, PropSchema>;
+}
+/**
+ * Complete manifest for a component in the registry.
+ * This is the "contract" agents use to understand and compose components.
+ */
+export interface ComponentManifest {
+    id: string;
+    name: string;
+    version: string;
+    category: ComponentCategory;
+    purpose: ComponentPurpose[];
+    description: string;
+    bestFor: string[];
+    avoid: string[];
+    props: Record<string, PropSchema>;
+    slots?: SlotDefinition[];
+    validParents?: string[];
+    validChildren?: string[];
+    incompatibleWith?: string[];
+    styles: VisualStyle[];
+    supportsTheme: boolean;
+    cssVariables?: string[];
+    interactions: InteractionPattern[];
+    a11y: A11yFeature[];
+    examples: ComponentExample[];
+    source: string;
+    storybook?: string;
+    tags: string[];
+}
+/**
+ * Slot definition for component composition
+ */
+export interface SlotDefinition {
+    name: string;
+    description: string;
+    accepts: string[];
+    required?: boolean;
+    multiple?: boolean;
+}
+/**
+ * Example usage for few-shot prompting
+ */
+export interface ComponentExample {
+    name: string;
+    description: string;
+    props: Record<string, unknown>;
+    context?: string;
+    code?: string;
+}
+/**
+ * Query options for searching the registry
+ */
+export interface RegistryQuery {
+    category?: ComponentCategory;
+    purpose?: ComponentPurpose | ComponentPurpose[];
+    style?: VisualStyle | VisualStyle[];
+    search?: string;
+    tags?: string[];
+    hasSlots?: boolean;
+    supportsChildren?: boolean;
+    limit?: number;
+}
+/**
+ * Registry search result with relevance scoring
+ */
+export interface RegistrySearchResult {
+    component: ComponentManifest;
+    score: number;
+    matchedOn: string[];
+}
+/**
+ * The component registry interface
+ */
+export interface ComponentRegistry {
+    get(id: string): ComponentManifest | undefined;
+    list(query?: RegistryQuery): ComponentManifest[];
+    search(query: string): RegistrySearchResult[];
+    canCompose(parentId: string, childId: string): boolean;
+    getValidChildren(parentId: string): ComponentManifest[];
+    getValidParents(childId: string): ComponentManifest[];
+    categories(): ComponentCategory[];
+    purposes(): ComponentPurpose[];
+    tags(): string[];
+    count(): number;
+}
+/**
+ * Maps component IDs to actual React components for rendering
+ */
+export type ComponentMap = Map<string, ComponentType<Record<string, unknown>>>;
+/**
+ * Registry with runtime components attached
+ */
+export interface RuntimeRegistry extends ComponentRegistry {
+    getComponent(id: string): ComponentType<Record<string, unknown>> | undefined;
+    render(id: string, props: Record<string, unknown>): React.ReactElement | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/workspace/registry/types.d.ts.map

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

package/dist/workspace/registry/types.js

@@ -0,0 +1,7 @@
+/**
+ * AG-UI Component Registry Types
+ *
+ * Defines the schema for component manifests that enable agents
+ * to discover, understand, and compose UI components.
+ */
+export {};

package/dist/workspace/types.d.ts

@@ -0,0 +1,263 @@
+/**
+ * WorkspaceSpec Types
+ *
+ * Defines the declarative schema agents use to compose UI workspaces.
+ * This is the "grammar" that enables agent-driven generative UI.
+ */
+/**
+ * Layout direction for splits and stacks
+ */
+export type LayoutDirection = "horizontal" | "vertical";
+/**
+ * Alignment options
+ */
+export type Alignment = "start" | "center" | "end" | "stretch";
+/**
+ * Justify options for main axis
+ */
+export type Justify = "start" | "center" | "end" | "between" | "around";
+/**
+ * Size specification - can be fixed, percentage, or flex
+ */
+export type SizeSpec = number | `${number}%` | `${number}fr` | "auto" | "fill";
+/**
+ * Base layout node interface
+ */
+export interface LayoutNodeBase {
+    id?: string;
+    minSize?: SizeSpec;
+    maxSize?: SizeSpec;
+}
+/**
+ * Split layout - divides space into resizable sections
+ */
+export interface SplitLayout extends LayoutNodeBase {
+    type: "split";
+    direction: LayoutDirection;
+    sizes?: SizeSpec[];
+    children: LayoutNode[];
+}
+/**
+ * Stack layout - flexbox-style arrangement
+ */
+export interface StackLayout extends LayoutNodeBase {
+    type: "stack";
+    direction: LayoutDirection;
+    gap?: number;
+    align?: Alignment;
+    justify?: Justify;
+    wrap?: boolean;
+    children: LayoutNode[];
+}
+/**
+ * Tabs layout - tabbed content switching
+ */
+export interface TabsLayout extends LayoutNodeBase {
+    type: "tabs";
+    orientation?: "horizontal" | "vertical";
+    defaultTab?: string;
+    children: TabDefinition[];
+}
+/**
+ * Tab definition within tabs layout
+ */
+export interface TabDefinition {
+    id: string;
+    label: string;
+    icon?: string;
+    disabled?: boolean;
+    content: LayoutNode;
+}
+/**
+ * Grid layout - CSS grid-based arrangement
+ */
+export interface GridLayout extends LayoutNodeBase {
+    type: "grid";
+    columns?: number | string;
+    rows?: number | string;
+    gap?: number | [number, number];
+    children: GridItem[];
+}
+/**
+ * Grid item with position
+ */
+export interface GridItem {
+    id?: string;
+    column?: number | string;
+    row?: number | string;
+    colSpan?: number;
+    rowSpan?: number;
+    content: LayoutNode;
+}
+/**
+ * Panel - leaf node containing a component
+ */
+export interface PanelNode extends LayoutNodeBase {
+    type: "panel";
+    component: string;
+    props?: Record<string, unknown>;
+    children?: PanelNode[];
+}
+/**
+ * Slot - placeholder for dynamic content
+ */
+export interface SlotNode extends LayoutNodeBase {
+    type: "slot";
+    name: string;
+    fallback?: LayoutNode;
+}
+/**
+ * Union of all layout node types
+ */
+export type LayoutNode = SplitLayout | StackLayout | TabsLayout | GridLayout | PanelNode | SlotNode;
+/**
+ * Color specification
+ */
+export type ColorSpec = string;
+/**
+ * Theme overrides for workspace
+ */
+export interface ThemeOverrides {
+    background?: ColorSpec;
+    foreground?: ColorSpec;
+    accent?: ColorSpec;
+    muted?: ColorSpec;
+    fontFamily?: string;
+    fontSize?: number;
+    spacing?: number;
+    borderRadius?: number;
+    borderColor?: ColorSpec;
+    glowColor?: ColorSpec;
+    glowIntensity?: number;
+    variables?: Record<string, string>;
+}
+/**
+ * Event types that can be bound
+ */
+export type EventType = "click" | "submit" | "change" | "focus" | "blur" | "keydown" | "hover" | "custom";
+/**
+ * Action types for event handlers
+ */
+export type ActionType = "navigate" | "emit" | "update" | "invoke" | "dismiss" | "custom";
+/**
+ * Event binding - connects UI events to agent actions
+ */
+export interface EventBinding {
+    /** Source element ID or selector */
+    source: string;
+    /** Event type to listen for */
+    event: EventType;
+    /** Action to perform */
+    action: ActionType;
+    /** Action payload/configuration */
+    payload?: Record<string, unknown>;
+    /** Prevent default behavior */
+    preventDefault?: boolean;
+    /** Stop event propagation */
+    stopPropagation?: boolean;
+}
+/**
+ * State binding - connects component props to workspace state
+ */
+export interface StateBinding {
+    /** State key path (dot notation) */
+    path: string;
+    /** Default value */
+    default?: unknown;
+    /** Transform function name */
+    transform?: string;
+}
+/**
+ * Workspace state definition
+ */
+export interface WorkspaceState {
+    /** Initial state values */
+    initial: Record<string, unknown>;
+    /** Computed/derived values */
+    computed?: Record<string, string>;
+    /** Persistence config */
+    persist?: {
+        key: string;
+        storage?: "local" | "session" | "none";
+    };
+}
+/**
+ * Complete workspace specification.
+ * This is what agents generate to compose UI.
+ */
+export interface WorkspaceSpec {
+    /** Unique workspace identifier */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Workspace description for agent context */
+    description?: string;
+    /** Semantic version */
+    version?: string;
+    /** Root layout node */
+    layout: LayoutNode;
+    /** Theme customizations */
+    theme?: ThemeOverrides;
+    /** Event bindings */
+    bindings?: EventBinding[];
+    /** Workspace state */
+    state?: WorkspaceState;
+    /** Metadata for agent context */
+    meta?: {
+        /** Purpose/intent of this workspace */
+        purpose?: string;
+        /** Target surface (desktop, mobile, etc) */
+        surface?: string;
+        /** Tags for categorization */
+        tags?: string[];
+        /** Generation context */
+        context?: Record<string, unknown>;
+    };
+}
+/**
+ * Patch operation for updating workspaces
+ */
+export interface WorkspacePatch {
+    op: "add" | "remove" | "replace" | "move" | "copy";
+    path: string;
+    value?: unknown;
+    from?: string;
+}
+/**
+ * Validation result
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: ValidationError[];
+    warnings: ValidationWarning[];
+}
+export interface ValidationError {
+    path: string;
+    message: string;
+    code: string;
+}
+export interface ValidationWarning {
+    path: string;
+    message: string;
+    suggestion?: string;
+}
+/**
+ * Context provided to workspace renderer
+ */
+export interface RenderContext {
+    /** Component registry */
+    registry: unknown;
+    /** Current theme */
+    theme: ThemeOverrides;
+    /** Workspace state */
+    state: Record<string, unknown>;
+    /** State update function */
+    setState: (path: string, value: unknown) => void;
+    /** Event emission function */
+    emit: (event: string, payload?: unknown) => void;
+    /** Slot content map */
+    slots?: Record<string, React.ReactNode>;
+    /** Surface type (desktop, mobile, etc) */
+    surface?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/workspace/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,UAAU,CAAC;AAExD;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,GAAG,QAAQ,CAAC;AAExE;;GAEG;AACH,MAAM,MAAM,QAAQ,GAChB,MAAM,GACN,GAAG,MAAM,GAAG,GACZ,GAAG,MAAM,IAAI,GACb,MAAM,GACN,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,OAAO,CAAC,EAAE,QAAQ,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,cAAc;IACjD,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,eAAe,CAAC;IAC3B,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,cAAc;IACjD,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,eAAe,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,cAAc;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,UAAU,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,cAAc;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,QAAQ,EAAE,QAAQ,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,UAAU,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,SAAU,SAAQ,cAAc;IAC/C,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,QAAS,SAAQ,cAAc;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,WAAW,GACX,WAAW,GACX,UAAU,GACV,UAAU,GACV,SAAS,GACT,QAAQ,CAAC;AAMb;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B;;GAEG;AACH,MAAM,WAAW,cAAc;IAE7B,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC;IAGlB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,SAAS,CAAC;IAGxB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IAGvB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAMD;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,MAAM,GACN,SAAS,GACT,OAAO,GACP,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,UAAU,GACV,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,KAAK,EAAE,SAAS,CAAC;IACjB,wBAAwB;IACxB,MAAM,EAAE,UAAU,CAAC;IACnB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,+BAA+B;IAC/B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,6BAA6B;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAMD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,yBAAyB;IACzB,OAAO,CAAC,EAAE;QACR,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;KACxC,CAAC;CACH;AAMD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAC;IAEX,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IAEb,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,uBAAuB;IACvB,MAAM,EAAE,UAAU,CAAC;IAEnB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,cAAc,CAAC;IAEvB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAE1B,sBAAsB;IACtB,KAAK,CAAC,EAAE,cAAc,CAAC;IAEvB,iCAAiC;IACjC,IAAI,CAAC,EAAE;QACL,uCAAuC;QACvC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,4CAA4C;QAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,8BAA8B;QAC9B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,yBAAyB;QACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC;CACH;AAMD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,QAAQ,EAAE,OAAO,CAAC;IAElB,oBAAoB;IACpB,KAAK,EAAE,cAAc,CAAC;IAEtB,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/B,4BAA4B;IAC5B,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAEjD,8BAA8B;IAC9B,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAEjD,uBAAuB;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAExC,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/workspace/types.js

@@ -0,0 +1,7 @@
+/**
+ * WorkspaceSpec Types
+ *
+ * Defines the declarative schema agents use to compose UI workspaces.
+ * This is the "grammar" that enables agent-driven generative UI.
+ */
+export {};

package/dist/workspace/validation.d.ts

@@ -0,0 +1,19 @@
+/**
+ * WorkspaceSpec Validation
+ *
+ * Validates workspace specifications and provides helpful error messages.
+ */
+import type { WorkspaceSpec, ValidationResult } from "./types";
+/**
+ * Validate a WorkspaceSpec
+ */
+export declare function validateWorkspace(spec: WorkspaceSpec): ValidationResult;
+/**
+ * Quick validation check (returns boolean only)
+ */
+export declare function isValidWorkspace(spec: WorkspaceSpec): boolean;
+/**
+ * Extract all component IDs used in a workspace
+ */
+export declare function extractComponentIds(spec: WorkspaceSpec): string[];
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/workspace/validation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,aAAa,EAGb,gBAAgB,EAGjB,MAAM,SAAS,CAAC;AAGjB;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,gBAAgB,CA0EvE;AAiRD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,EAAE,CAoBjE"}