agentic-qe 3.3.4 → 3.4.0

package/v3/dist/adapters/a2ui/renderer/component-builder.js

@@ -0,0 +1,488 @@
+/**
+ * A2UI Component Builder
+ *
+ * Fluent API for building A2UI component trees with flat adjacency list structure.
+ * Supports incremental updates, version tracking, and parent-child relationships.
+ *
+ * @module adapters/a2ui/renderer/component-builder
+ */
+import { v4 as uuidv4 } from 'uuid';
+import { literal, children, } from './message-types.js';
+/**
+ * Default configuration
+ */
+const DEFAULT_CONFIG = {
+    idGenerator: () => uuidv4(),
+    autoGenerateIds: false,
+    defaultAccessibility: {},
+};
+// ============================================================================
+// Component Builder Class
+// ============================================================================
+/**
+ * Fluent builder for A2UI surfaces and component trees
+ */
+export class ComponentBuilder {
+    config;
+    surfaceId = '';
+    version = 1;
+    components = new Map();
+    rootComponentId = null;
+    title = null;
+    catalogId = null;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    // ============================================================================
+    // Surface Lifecycle
+    // ============================================================================
+    /**
+     * Begin a new surface
+     */
+    beginSurface(surfaceId) {
+        this.surfaceId = surfaceId;
+        this.components.clear();
+        this.rootComponentId = null;
+        this.title = null;
+        this.version = 1;
+        return this;
+    }
+    /**
+     * Set surface title
+     */
+    setTitle(title) {
+        this.title = title;
+        return this;
+    }
+    /**
+     * Set catalog ID
+     */
+    setCatalog(catalogId) {
+        this.catalogId = catalogId;
+        return this;
+    }
+    /**
+     * Set surface version
+     */
+    setVersion(version) {
+        this.version = version;
+        return this;
+    }
+    /**
+     * Increment version
+     */
+    incrementVersion() {
+        this.version++;
+        return this;
+    }
+    /**
+     * Set root component
+     */
+    setRoot(componentId) {
+        this.rootComponentId = componentId;
+        return this;
+    }
+    // ============================================================================
+    // Component Management
+    // ============================================================================
+    /**
+     * Add a component to the surface
+     */
+    addComponent(id, properties) {
+        const { type, ...props } = properties;
+        const node = {
+            id,
+            type,
+            properties: props,
+        };
+        // Set as root if first component
+        if (this.components.size === 0 && !this.rootComponentId) {
+            this.rootComponentId = id;
+        }
+        this.components.set(id, node);
+        return this;
+    }
+    /**
+     * Add a child component under a parent
+     */
+    addChild(parentId, childId, properties) {
+        // Add the child component first
+        this.addComponent(childId, properties);
+        // Update parent's children list
+        const parent = this.components.get(parentId);
+        if (parent) {
+            if (!parent.children) {
+                parent.children = [];
+            }
+            if (!parent.children.includes(childId)) {
+                parent.children.push(childId);
+            }
+        }
+        return this;
+    }
+    /**
+     * Add multiple children at once
+     */
+    addChildren(parentId, childrenComponents) {
+        for (const child of childrenComponents) {
+            const { id, ...props } = child;
+            this.addChild(parentId, id, props);
+        }
+        return this;
+    }
+    /**
+     * Update an existing component's properties
+     */
+    updateComponent(id, properties) {
+        const component = this.components.get(id);
+        if (component) {
+            component.properties = {
+                ...component.properties,
+                ...properties,
+            };
+        }
+        return this;
+    }
+    /**
+     * Remove a component
+     */
+    removeComponent(id) {
+        this.components.delete(id);
+        // Remove from parent's children lists
+        for (const component of this.components.values()) {
+            if (component.children) {
+                const index = component.children.indexOf(id);
+                if (index !== -1) {
+                    component.children.splice(index, 1);
+                }
+            }
+        }
+        return this;
+    }
+    /**
+     * Get a component by ID
+     */
+    getComponent(id) {
+        return this.components.get(id);
+    }
+    /**
+     * Check if component exists
+     */
+    hasComponent(id) {
+        return this.components.has(id);
+    }
+    /**
+     * Get all component IDs
+     */
+    getComponentIds() {
+        return Array.from(this.components.keys());
+    }
+    /**
+     * Get component count
+     */
+    getComponentCount() {
+        return this.components.size;
+    }
+    // ============================================================================
+    // Hierarchy Management
+    // ============================================================================
+    /**
+     * Set explicit children for a component
+     */
+    setChildren(parentId, childIds) {
+        const parent = this.components.get(parentId);
+        if (parent) {
+            parent.children = [...childIds];
+        }
+        return this;
+    }
+    /**
+     * Append children to existing list
+     */
+    appendChildren(parentId, childIds) {
+        const parent = this.components.get(parentId);
+        if (parent) {
+            if (!parent.children) {
+                parent.children = [];
+            }
+            for (const childId of childIds) {
+                if (!parent.children.includes(childId)) {
+                    parent.children.push(childId);
+                }
+            }
+        }
+        return this;
+    }
+    /**
+     * Remove a child from a parent
+     */
+    removeChild(parentId, childId) {
+        const parent = this.components.get(parentId);
+        if (parent && parent.children) {
+            const index = parent.children.indexOf(childId);
+            if (index !== -1) {
+                parent.children.splice(index, 1);
+            }
+        }
+        return this;
+    }
+    /**
+     * Move a component to a new parent
+     */
+    moveComponent(componentId, newParentId) {
+        // Remove from all current parents
+        for (const component of this.components.values()) {
+            if (component.children) {
+                const index = component.children.indexOf(componentId);
+                if (index !== -1) {
+                    component.children.splice(index, 1);
+                }
+            }
+        }
+        // Add to new parent
+        const newParent = this.components.get(newParentId);
+        if (newParent) {
+            if (!newParent.children) {
+                newParent.children = [];
+            }
+            newParent.children.push(componentId);
+        }
+        return this;
+    }
+    /**
+     * Get children of a component
+     */
+    getChildren(parentId) {
+        const parent = this.components.get(parentId);
+        return parent?.children ? [...parent.children] : [];
+    }
+    /**
+     * Find parent of a component
+     */
+    getParent(componentId) {
+        for (const [id, component] of this.components.entries()) {
+            if (component.children?.includes(componentId)) {
+                return id;
+            }
+        }
+        return null;
+    }
+    // ============================================================================
+    // Build Methods
+    // ============================================================================
+    /**
+     * Build the surfaceUpdate message
+     */
+    build() {
+        if (!this.surfaceId) {
+            throw new Error('Surface ID is required. Call beginSurface() first.');
+        }
+        return {
+            type: 'surfaceUpdate',
+            surfaceId: this.surfaceId,
+            version: this.version,
+            components: Array.from(this.components.values()),
+        };
+    }
+    /**
+     * Build beginRendering message
+     */
+    buildBeginRendering() {
+        if (!this.surfaceId) {
+            throw new Error('Surface ID is required. Call beginSurface() first.');
+        }
+        const message = {
+            type: 'beginRendering',
+            surfaceId: this.surfaceId,
+        };
+        if (this.title) {
+            message.title = this.title;
+        }
+        if (this.rootComponentId) {
+            message.rootComponentId = this.rootComponentId;
+        }
+        if (this.catalogId) {
+            message.catalogId = this.catalogId;
+        }
+        return message;
+    }
+    /**
+     * Build deleteSurface message
+     */
+    buildDeleteSurface() {
+        if (!this.surfaceId) {
+            throw new Error('Surface ID is required. Call beginSurface() first.');
+        }
+        return {
+            type: 'deleteSurface',
+            surfaceId: this.surfaceId,
+        };
+    }
+    /**
+     * Build all messages for a complete surface lifecycle
+     */
+    buildAll() {
+        return {
+            beginRendering: this.buildBeginRendering(),
+            surfaceUpdate: this.build(),
+        };
+    }
+    // ============================================================================
+    // Incremental Updates
+    // ============================================================================
+    /**
+     * Build an incremental update with only specific components
+     */
+    buildIncrementalUpdate(componentIds) {
+        if (!this.surfaceId) {
+            throw new Error('Surface ID is required. Call beginSurface() first.');
+        }
+        const components = [];
+        for (const id of componentIds) {
+            const component = this.components.get(id);
+            if (component) {
+                components.push(component);
+            }
+        }
+        return {
+            type: 'surfaceUpdate',
+            surfaceId: this.surfaceId,
+            version: this.version,
+            components,
+        };
+    }
+    /**
+     * Clone the builder with current state
+     */
+    clone() {
+        const cloned = new ComponentBuilder(this.config);
+        cloned.surfaceId = this.surfaceId;
+        cloned.version = this.version;
+        cloned.rootComponentId = this.rootComponentId;
+        cloned.title = this.title;
+        cloned.catalogId = this.catalogId;
+        for (const [id, component] of this.components) {
+            cloned.components.set(id, {
+                ...component,
+                properties: { ...component.properties },
+                children: component.children ? [...component.children] : undefined,
+            });
+        }
+        return cloned;
+    }
+    /**
+     * Reset the builder to initial state
+     */
+    reset() {
+        this.surfaceId = '';
+        this.version = 1;
+        this.components.clear();
+        this.rootComponentId = null;
+        this.title = null;
+        this.catalogId = null;
+        return this;
+    }
+}
+// ============================================================================
+// Component Helper Functions
+// ============================================================================
+/**
+ * Create a Row layout component
+ */
+export function row(id, childIds, properties) {
+    return {
+        id,
+        type: 'Row',
+        children: children(...childIds),
+        ...properties,
+    };
+}
+/**
+ * Create a Column layout component
+ */
+export function column(id, childIds, properties) {
+    return {
+        id,
+        type: 'Column',
+        children: children(...childIds),
+        ...properties,
+    };
+}
+/**
+ * Create a Card container component
+ */
+export function card(id, title, childIds, properties) {
+    return {
+        id,
+        type: 'Card',
+        title: typeof title === 'string' ? literal(title) : title,
+        children: children(...childIds),
+        ...properties,
+    };
+}
+/**
+ * Create a Text display component
+ */
+export function text(id, textContent, properties) {
+    return {
+        id,
+        type: 'Text',
+        text: typeof textContent === 'string' ? literal(textContent) : textContent,
+        ...properties,
+    };
+}
+/**
+ * Create a Button interactive component
+ */
+export function button(id, label, actionName, properties) {
+    return {
+        id,
+        type: 'Button',
+        label: typeof label === 'string' ? literal(label) : label,
+        action: { name: actionName },
+        ...properties,
+    };
+}
+/**
+ * Create a List layout component
+ */
+export function list(id, childrenSpec, properties) {
+    return {
+        id,
+        type: 'List',
+        children: Array.isArray(childrenSpec) ? children(...childrenSpec) : childrenSpec,
+        ...properties,
+    };
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+/**
+ * Create a new ComponentBuilder instance
+ */
+export function createComponentBuilder(config) {
+    return new ComponentBuilder(config);
+}
+// ============================================================================
+// Convenience Builder
+// ============================================================================
+/**
+ * Quick surface builder for simple use cases
+ */
+export function buildSurface(surfaceId, components) {
+    const builder = createComponentBuilder();
+    builder.beginSurface(surfaceId);
+    // First pass: add all components
+    for (const comp of components) {
+        const { id, type, parentId, ...props } = comp;
+        builder.addComponent(id, { type, ...props });
+    }
+    // Second pass: set up parent-child relationships
+    for (const comp of components) {
+        if (comp.parentId) {
+            builder.appendChildren(comp.parentId, [comp.id]);
+        }
+    }
+    return builder.build();
+}
+//# sourceMappingURL=component-builder.js.map

package/v3/dist/adapters/a2ui/renderer/component-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-builder.js","sourceRoot":"","sources":["../../../../src/adapters/a2ui/renderer/component-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AAcpC,OAAO,EACL,OAAO,EAEP,QAAQ,GAET,MAAM,oBAAoB,CAAC;AAkB5B;;GAEG;AACH,MAAM,cAAc,GAAqC;IACvD,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE;IAC3B,eAAe,EAAE,KAAK;IACtB,oBAAoB,EAAE,EAAE;CACzB,CAAC;AAaF,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E;;GAEG;AACH,MAAM,OAAO,gBAAgB;IACnB,MAAM,CAAmC;IACzC,SAAS,GAAW,EAAE,CAAC;IACvB,OAAO,GAAW,CAAC,CAAC;IACpB,UAAU,GAA+B,IAAI,GAAG,EAAE,CAAC;IACnD,eAAe,GAAkB,IAAI,CAAC;IACtC,KAAK,GAAkB,IAAI,CAAC;IAC5B,SAAS,GAAkB,IAAI,CAAC;IAExC,YAAY,SAAiC,EAAE;QAC7C,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;IACjD,CAAC;IAED,+EAA+E;IAC/E,oBAAoB;IACpB,+EAA+E;IAE/E;;OAEG;IACH,YAAY,CAAC,SAAiB;QAC5B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAa;QACpB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,SAAiB;QAC1B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,OAAe;QACxB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,WAAmB;QACzB,IAAI,CAAC,eAAe,GAAG,WAAW,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,+EAA+E;IAC/E,uBAAuB;IACvB,+EAA+E;IAE/E;;OAEG;IACH,YAAY,CACV,EAAU,EACV,UAGC;QAED,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,GAAG,UAAU,CAAC;QAEtC,MAAM,IAAI,GAAkB;YAC1B,EAAE;YACF,IAAI;YACJ,UAAU,EAAE,KAAK;SAClB,CAAC;QAEF,iCAAiC;QACjC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YACxD,IAAI,CAAC,eAAe,GAAG,EAAE,CAAC;QAC5B,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,QAAQ,CACN,QAAgB,EAChB,OAAe,EACf,UAGC;QAED,gCAAgC;QAChC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAEvC,gCAAgC;QAChC,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACrB,MAAM,CAAC,QAAQ,GAAG,EAAE,CAAC;YACvB,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACvC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,WAAW,CACT,QAAgB,EAChB,kBAIE;QAEF,KAAK,MAAM,KAAK,IAAI,kBAAkB,EAAE,CAAC;YACvC,MAAM,EAAE,EAAE,EAAE,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC;YAC/B,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,EAAE,KAAiD,CAAC,CAAC;QACjF,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,eAAe,CACb,EAAU,EACV,UAAmC;QAEnC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1C,IAAI,SAAS,EAAE,CAAC;YACd,SAAS,CAAC,UAAU,GAAG;gBACrB,GAAG,SAAS,CAAC,UAAU;gBACvB,GAAG,UAAU;aACd,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,EAAU;QACxB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAE3B,sCAAsC;QACtC,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;YACjD,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;gBACvB,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBAC7C,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;oBACjB,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBACtC,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,EAAU;QACrB,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,EAAU;QACrB,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;IAC9B,CAAC;IAED,+EAA+E;IAC/E,uBAAuB;IACvB,+EAA+E;IAE/E;;OAEG;IACH,WAAW,CAAC,QAAgB,EAAE,QAAkB;QAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,QAAQ,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,QAAgB,EAAE,QAAkB;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACrB,MAAM,CAAC,QAAQ,GAAG,EAAE,CAAC;YACvB,CAAC;YACD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;oBACvC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,QAAgB,EAAE,OAAe;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,MAAM,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC/C,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;gBACjB,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,WAAmB,EAAE,WAAmB;QACpD,kCAAkC;QAClC,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;YACjD,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;gBACvB,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;gBACtD,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;oBACjB,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBACtC,CAAC;YACH,CAAC;QACH,CAAC;QAED,oBAAoB;QACpB,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACnD,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;gBACxB,SAAS,CAAC,QAAQ,GAAG,EAAE,CAAC;YAC1B,CAAC;YACD,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACvC,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,QAAgB;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7C,OAAO,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,WAAmB;QAC3B,KAAK,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;YACxD,IAAI,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC9C,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,+EAA+E;IAC/E,gBAAgB;IAChB,+EAA+E;IAE/E;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QAED,OAAO;YACL,IAAI,EAAE,eAAe;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;SACjD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,mBAAmB;QACjB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QAED,MAAM,OAAO,GAA0B;YACrC,IAAI,EAAE,gBAAgB;YACtB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;QAEF,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QAC7B,CAAC;QAED,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC;QACjD,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QACrC,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QAED,OAAO;YACL,IAAI,EAAE,eAAe;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,QAAQ;QAIN,OAAO;YACL,cAAc,EAAE,IAAI,CAAC,mBAAmB,EAAE;YAC1C,aAAa,EAAE,IAAI,CAAC,KAAK,EAAE;SAC5B,CAAC;IACJ,CAAC;IAED,+EAA+E;IAC/E,sBAAsB;IACtB,+EAA+E;IAE/E;;OAEG;IACH,sBAAsB,CAAC,YAAsB;QAC3C,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACxE,CAAC;QAED,MAAM,UAAU,GAAoB,EAAE,CAAC;QACvC,KAAK,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;YAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC1C,IAAI,SAAS,EAAE,CAAC;gBACd,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;QAED,OAAO;YACL,IAAI,EAAE,eAAe;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU;SACX,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK;QACH,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjD,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAClC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC9B,MAAM,CAAC,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC;QAC9C,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QAC1B,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAElC,KAAK,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAC9C,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE;gBACxB,GAAG,SAAS;gBACZ,UAAU,EAAE,EAAE,GAAG,SAAS,CAAC,UAAU,EAAE;gBACvC,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS;aACnE,CAAC,CAAC;QACL,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;QACpB,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QACjB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC5B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,+EAA+E;AAC/E,6BAA6B;AAC7B,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,GAAG,CACjB,EAAU,EACV,QAAkB,EAClB,UAAoC;IAEpC,OAAO;QACL,EAAE;QACF,IAAI,EAAE,KAAK;QACX,QAAQ,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC;QAC/B,GAAG,UAAU;KACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CACpB,EAAU,EACV,QAAkB,EAClB,UAAoC;IAEpC,OAAO;QACL,EAAE;QACF,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC;QAC/B,GAAG,UAAU;KACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,IAAI,CAClB,EAAU,EACV,KAA0B,EAC1B,QAAkB,EAClB,UAAoC;IAEpC,OAAO;QACL,EAAE;QACF,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK;QACzD,QAAQ,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC;QAC/B,GAAG,UAAU;KACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,IAAI,CAClB,EAAU,EACV,WAAgC,EAChC,UAAoC;IAEpC,OAAO;QACL,EAAE;QACF,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,OAAO,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW;QAC1E,GAAG,UAAU;KACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CACpB,EAAU,EACV,KAA0B,EAC1B,UAAkB,EAClB,UAAoC;IAEpC,OAAO;QACL,EAAE;QACF,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK;QACzD,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;QAC5B,GAAG,UAAU;KACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,IAAI,CAClB,EAAU,EACV,YAAyC,EACzC,UAAoC;IAEpC,OAAO;QACL,EAAE;QACF,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY;QAChF,GAAG,UAAU;KACd,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAA+B;IAE/B,OAAO,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC;AAED,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,SAAiB,EACjB,UAKE;IAEF,MAAM,OAAO,GAAG,sBAAsB,EAAE,CAAC;IACzC,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IAEhC,iCAAiC;IACjC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC;QAC9C,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,iDAAiD;IACjD,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC;AACzB,CAAC"}

package/v3/dist/adapters/a2ui/renderer/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * A2UI Renderer Module
+ *
+ * Barrel export for A2UI surface rendering components including:
+ * - Message type definitions
+ * - Component builder
+ * - Surface generator
+ * - QE surface templates
+ *
+ * @module adapters/a2ui/renderer
+ */
+export { type LiteralValue, type PathValue, type CombinedValue, type BoundValue, isLiteralValue, isPathValue, isCombinedValue, isBoundValue, type ExplicitList, type TemplateChildren, type ComponentChildren, isExplicitList, isTemplateChildren, type AriaLive, type A2UIAccessibility, type ComponentPropertyValue, type ComponentProperties, type ComponentDefinition, type ComponentNode, type A2UIComponent, type ComponentAction, type SurfaceUpdateMessage, type DataModelUpdateMessage, type BeginRenderingMessage, type DeleteSurfaceMessage, type A2UIServerMessage, type UserActionMessage, type ClientErrorMessage, type A2UIClientMessage, type A2UIMessage, isSurfaceUpdateMessage, isDataModelUpdateMessage, isBeginRenderingMessage, isDeleteSurfaceMessage, isUserActionMessage, isClientErrorMessage, isServerMessage, isClientMessage, literal, path, boundWithDefault, children, templateChildren, a11y, } from './message-types.js';
+export { ComponentBuilder, createComponentBuilder, type ComponentBuilderConfig, row, column, card, text, button, list, buildSurface, } from './component-builder.js';
+export { SurfaceGenerator, createSurfaceGenerator, type SurfaceState, type SurfaceGeneratorConfig, type SurfaceChangeEvent, } from './surface-generator.js';
+export { createCoverageSurface, createCoverageDataUpdate, createCoverageSummarySurface, type CoverageData, type FileCoverage, type CoverageGap, type ModuleCoverage, createTestResultsSurface, createTestResultsDataUpdate, createTestSummarySurface, type TestResults, type TestResult, type TestSuite, type TestStatus, createSecuritySurface, createSecurityDataUpdate, createSecuritySummarySurface, type SecurityFindings, type SecurityFinding, type Severity, type OwaspCategory, type SeverityCount, type DependencyVulnerability, createAccessibilitySurface, createAccessibilityDataUpdate, createAccessibilitySummarySurface, type A11yAudit, type A11yFinding, type WcagLevel, type ImpactLevel, type WcagPrinciple, type ImpactCount, type LevelCount, type PrincipleBreakdown, type PageAudit, } from './templates/index.js';
+//# sourceMappingURL=index.d.ts.map

package/v3/dist/adapters/a2ui/renderer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/adapters/a2ui/renderer/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,UAAU,EAGf,cAAc,EACd,WAAW,EACX,eAAe,EACf,YAAY,EAGZ,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,cAAc,EACd,kBAAkB,EAGlB,KAAK,QAAQ,EACb,KAAK,iBAAiB,EAGtB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,aAAa,EAGlB,KAAK,eAAe,EAGpB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EAGtB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EAGtB,KAAK,WAAW,EAGhB,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,eAAe,EAGf,OAAO,EACP,IAAI,EACJ,gBAAgB,EAChB,QAAQ,EACR,gBAAgB,EAChB,IAAI,GACL,MAAM,oBAAoB,CAAC;AAM5B,OAAO,EAEL,gBAAgB,EAChB,sBAAsB,EAGtB,KAAK,sBAAsB,EAG3B,GAAG,EACH,MAAM,EACN,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,IAAI,EAGJ,YAAY,GACb,MAAM,wBAAwB,CAAC;AAMhC,OAAO,EAEL,gBAAgB,EAChB,sBAAsB,EAGtB,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,GACxB,MAAM,wBAAwB,CAAC;AAMhC,OAAO,EAEL,qBAAqB,EACrB,wBAAwB,EACxB,4BAA4B,EAC5B,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,cAAc,EAGnB,wBAAwB,EACxB,2BAA2B,EAC3B,wBAAwB,EACxB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,UAAU,EAGf,qBAAqB,EACrB,wBAAwB,EACxB,4BAA4B,EAC5B,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAG5B,0BAA0B,EAC1B,6BAA6B,EAC7B,iCAAiC,EACjC,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,SAAS,GACf,MAAM,sBAAsB,CAAC"}

package/v3/dist/adapters/a2ui/renderer/index.js

@@ -0,0 +1,50 @@
+/**
+ * A2UI Renderer Module
+ *
+ * Barrel export for A2UI surface rendering components including:
+ * - Message type definitions
+ * - Component builder
+ * - Surface generator
+ * - QE surface templates
+ *
+ * @module adapters/a2ui/renderer
+ */
+// ============================================================================
+// Message Types
+// ============================================================================
+export { 
+// Type Guards for BoundValue
+isLiteralValue, isPathValue, isCombinedValue, isBoundValue, isExplicitList, isTemplateChildren, 
+// Message Type Guards
+isSurfaceUpdateMessage, isDataModelUpdateMessage, isBeginRenderingMessage, isDeleteSurfaceMessage, isUserActionMessage, isClientErrorMessage, isServerMessage, isClientMessage, 
+// Factory Functions
+literal, path, boundWithDefault, children, templateChildren, a11y, } from './message-types.js';
+// ============================================================================
+// Component Builder
+// ============================================================================
+export { 
+// Builder Class
+ComponentBuilder, createComponentBuilder, 
+// Component Helper Functions
+row, column, card, text, button, list, 
+// Convenience Builder
+buildSurface, } from './component-builder.js';
+// ============================================================================
+// Surface Generator
+// ============================================================================
+export { 
+// Generator Class
+SurfaceGenerator, createSurfaceGenerator, } from './surface-generator.js';
+// ============================================================================
+// QE Surface Templates
+// ============================================================================
+export { 
+// Coverage Templates
+createCoverageSurface, createCoverageDataUpdate, createCoverageSummarySurface, 
+// Test Results Templates
+createTestResultsSurface, createTestResultsDataUpdate, createTestSummarySurface, 
+// Security Templates
+createSecuritySurface, createSecurityDataUpdate, createSecuritySummarySurface, 
+// Accessibility Templates
+createAccessibilitySurface, createAccessibilityDataUpdate, createAccessibilitySummarySurface, } from './templates/index.js';
+//# sourceMappingURL=index.js.map

package/v3/dist/adapters/a2ui/renderer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/adapters/a2ui/renderer/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E,OAAO;AAOL,6BAA6B;AAC7B,cAAc,EACd,WAAW,EACX,eAAe,EACf,YAAY,EAMZ,cAAc,EACd,kBAAkB;AA+BlB,sBAAsB;AACtB,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,eAAe;AAEf,oBAAoB;AACpB,OAAO,EACP,IAAI,EACJ,gBAAgB,EAChB,QAAQ,EACR,gBAAgB,EAChB,IAAI,GACL,MAAM,oBAAoB,CAAC;AAE5B,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,OAAO;AACL,gBAAgB;AAChB,gBAAgB,EAChB,sBAAsB;AAKtB,6BAA6B;AAC7B,GAAG,EACH,MAAM,EACN,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,IAAI;AAEJ,sBAAsB;AACtB,YAAY,GACb,MAAM,wBAAwB,CAAC;AAEhC,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,OAAO;AACL,kBAAkB;AAClB,gBAAgB,EAChB,sBAAsB,GAMvB,MAAM,wBAAwB,CAAC;AAEhC,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E,OAAO;AACL,qBAAqB;AACrB,qBAAqB,EACrB,wBAAwB,EACxB,4BAA4B;AAM5B,yBAAyB;AACzB,wBAAwB,EACxB,2BAA2B,EAC3B,wBAAwB;AAMxB,qBAAqB;AACrB,qBAAqB,EACrB,wBAAwB,EACxB,4BAA4B;AAQ5B,0BAA0B;AAC1B,0BAA0B,EAC1B,6BAA6B,EAC7B,iCAAiC,GAUlC,MAAM,sBAAsB,CAAC"}