agentic-qe 3.3.4 → 3.4.0

package/v3/dist/adapters/a2ui/renderer/component-builder.d.ts

@@ -0,0 +1,227 @@
+/**
+ * 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 type { ComponentNode, SurfaceUpdateMessage, DataModelUpdateMessage, BeginRenderingMessage, DeleteSurfaceMessage, UserActionMessage, BoundValue, ComponentChildren, A2UIAccessibility, TemplateChildren } from './message-types.js';
+/**
+ * Component builder configuration
+ */
+export interface ComponentBuilderConfig {
+    /** Custom ID generator */
+    idGenerator?: () => string;
+    /** Whether to auto-generate component IDs */
+    autoGenerateIds?: boolean;
+    /** Default accessibility attributes */
+    defaultAccessibility?: Partial<A2UIAccessibility>;
+}
+/**
+ * Properties builder for individual components
+ */
+export interface ComponentPropertiesBuilder {
+    [key: string]: unknown;
+}
+/**
+ * Fluent builder for A2UI surfaces and component trees
+ */
+export declare class ComponentBuilder {
+    private config;
+    private surfaceId;
+    private version;
+    private components;
+    private rootComponentId;
+    private title;
+    private catalogId;
+    constructor(config?: ComponentBuilderConfig);
+    /**
+     * Begin a new surface
+     */
+    beginSurface(surfaceId: string): this;
+    /**
+     * Set surface title
+     */
+    setTitle(title: string): this;
+    /**
+     * Set catalog ID
+     */
+    setCatalog(catalogId: string): this;
+    /**
+     * Set surface version
+     */
+    setVersion(version: number): this;
+    /**
+     * Increment version
+     */
+    incrementVersion(): this;
+    /**
+     * Set root component
+     */
+    setRoot(componentId: string): this;
+    /**
+     * Add a component to the surface
+     */
+    addComponent(id: string, properties: {
+        type: string;
+        [key: string]: unknown;
+    }): this;
+    /**
+     * Add a child component under a parent
+     */
+    addChild(parentId: string, childId: string, properties: {
+        type: string;
+        [key: string]: unknown;
+    }): this;
+    /**
+     * Add multiple children at once
+     */
+    addChildren(parentId: string, childrenComponents: Array<{
+        id: string;
+        type: string;
+        [key: string]: unknown;
+    }>): this;
+    /**
+     * Update an existing component's properties
+     */
+    updateComponent(id: string, properties: Record<string, unknown>): this;
+    /**
+     * Remove a component
+     */
+    removeComponent(id: string): this;
+    /**
+     * Get a component by ID
+     */
+    getComponent(id: string): ComponentNode | undefined;
+    /**
+     * Check if component exists
+     */
+    hasComponent(id: string): boolean;
+    /**
+     * Get all component IDs
+     */
+    getComponentIds(): string[];
+    /**
+     * Get component count
+     */
+    getComponentCount(): number;
+    /**
+     * Set explicit children for a component
+     */
+    setChildren(parentId: string, childIds: string[]): this;
+    /**
+     * Append children to existing list
+     */
+    appendChildren(parentId: string, childIds: string[]): this;
+    /**
+     * Remove a child from a parent
+     */
+    removeChild(parentId: string, childId: string): this;
+    /**
+     * Move a component to a new parent
+     */
+    moveComponent(componentId: string, newParentId: string): this;
+    /**
+     * Get children of a component
+     */
+    getChildren(parentId: string): string[];
+    /**
+     * Find parent of a component
+     */
+    getParent(componentId: string): string | null;
+    /**
+     * Build the surfaceUpdate message
+     */
+    build(): SurfaceUpdateMessage;
+    /**
+     * Build beginRendering message
+     */
+    buildBeginRendering(): BeginRenderingMessage;
+    /**
+     * Build deleteSurface message
+     */
+    buildDeleteSurface(): DeleteSurfaceMessage;
+    /**
+     * Build all messages for a complete surface lifecycle
+     */
+    buildAll(): {
+        beginRendering: BeginRenderingMessage;
+        surfaceUpdate: SurfaceUpdateMessage;
+    };
+    /**
+     * Build an incremental update with only specific components
+     */
+    buildIncrementalUpdate(componentIds: string[]): SurfaceUpdateMessage;
+    /**
+     * Clone the builder with current state
+     */
+    clone(): ComponentBuilder;
+    /**
+     * Reset the builder to initial state
+     */
+    reset(): this;
+}
+/**
+ * Create a Row layout component
+ */
+export declare function row(id: string, childIds: string[], properties?: Record<string, unknown>): {
+    id: string;
+    type: string;
+    [key: string]: unknown;
+};
+/**
+ * Create a Column layout component
+ */
+export declare function column(id: string, childIds: string[], properties?: Record<string, unknown>): {
+    id: string;
+    type: string;
+    [key: string]: unknown;
+};
+/**
+ * Create a Card container component
+ */
+export declare function card(id: string, title: string | BoundValue, childIds: string[], properties?: Record<string, unknown>): {
+    id: string;
+    type: string;
+    [key: string]: unknown;
+};
+/**
+ * Create a Text display component
+ */
+export declare function text(id: string, textContent: string | BoundValue, properties?: Record<string, unknown>): {
+    id: string;
+    type: string;
+    [key: string]: unknown;
+};
+/**
+ * Create a Button interactive component
+ */
+export declare function button(id: string, label: string | BoundValue, actionName: string, properties?: Record<string, unknown>): {
+    id: string;
+    type: string;
+    [key: string]: unknown;
+};
+/**
+ * Create a List layout component
+ */
+export declare function list(id: string, childrenSpec: string[] | TemplateChildren, properties?: Record<string, unknown>): {
+    id: string;
+    type: string;
+    [key: string]: unknown;
+};
+/**
+ * Create a new ComponentBuilder instance
+ */
+export declare function createComponentBuilder(config?: ComponentBuilderConfig): ComponentBuilder;
+/**
+ * Quick surface builder for simple use cases
+ */
+export declare function buildSurface(surfaceId: string, components: Array<{
+    id: string;
+    type: string;
+    parentId?: string;
+    [key: string]: unknown;
+}>): SurfaceUpdateMessage;
+export type { ComponentNode, SurfaceUpdateMessage, DataModelUpdateMessage, BeginRenderingMessage, DeleteSurfaceMessage, UserActionMessage, BoundValue, ComponentChildren, A2UIAccessibility, };
+//# sourceMappingURL=component-builder.d.ts.map

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

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