@aotui/runtime 1.0.0

package/dist/worker-runtime/app-kernel/index.js

@@ -0,0 +1,23 @@
+/**
+ * AOTUI Runtime - App Kernel Module
+ *
+ * [方案 B] Worker 内的 App 执行引擎。
+ *
+ * 负责：
+ * - App 生命周期管理
+ * - ViewTree 状态管理
+ * - 系统事件处理
+ * - Operation 路由
+ *
+ * @module @aotui/runtime/worker-runtime/app-kernel
+ */
+export { AppKernel } from './AppKernel.js';
+export { ViewTree, createViewTree } from './view-tree.js';
+/**
+ * [RFC-B2] ViewRegistry - Lightweight View Management
+ *
+ * Replacement for ViewTree in component-mode apps.
+ * Provides simple register/unregister/get API without tree management.
+ */
+export { ViewRegistry, createViewRegistry } from './view-registry.js';
+//# sourceMappingURL=index.js.map

package/dist/worker-runtime/app-kernel/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/worker-runtime/app-kernel/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAA0C,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE1D;;;;;GAKG;AACH,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/worker-runtime/app-kernel/view-registry.d.ts

@@ -0,0 +1,85 @@
+/**
+ * AOTUI Runtime - ViewRegistry
+ *
+ * Lightweight View management for component mode.
+ * Replaces ViewTree with a simpler flat structure.
+ *
+ * Design Goals:
+ * - Minimal API surface (register, unregister, get, has)
+ * - No tree management (parent-child relationships handled by components)
+ * - No lifecycle management (components manage their own mount/dismount)
+ * - Performance: O(1) lookups, minimal memory overhead
+ *
+ * @module @aotui/runtime/worker-runtime/app-kernel
+ */
+import type { IView, ViewID } from '../../spi/index.js';
+/**
+ * ViewRegistry - Simplified View management
+ *
+ * Compared to ViewTree (~800 lines):
+ * - No parent-child tracking
+ * - No mount/dismount lifecycle
+ * - No tree rendering
+ * - ~50 lines of code
+ *
+ * Views are registered by SDK components via AppKernel.registerView()
+ * and unregistered when components unmount.
+ */
+export declare class ViewRegistry {
+    private views;
+    /**
+     * Register a View
+     *
+     * @throws {AOTUIError} VIEW_DUPLICATE if viewId already registered
+     */
+    register(view: IView): void;
+    /**
+     * Unregister a View
+     *
+     * Idempotent: no error if view doesn't exist
+     */
+    unregister(viewId: ViewID): void;
+    /**
+     * Get a View by ID
+     *
+     * @returns View instance or undefined if not found
+     */
+    get(viewId: ViewID): IView | undefined;
+    /**
+     * Check if a View is registered
+     */
+    has(viewId: ViewID): boolean;
+    /**
+     * Get all registered Views
+     *
+     * @returns Array of all Views (order not guaranteed)
+     */
+    getAll(): IView[];
+    /**
+     * Get all View IDs
+     */
+    getAllIds(): ViewID[];
+    /**
+     * Get Views by type
+     *
+     * Used for Tool聚合 in View Type mechanism.
+     *
+     * @param type - View type to filter by
+     * @returns Array of Views with matching type
+     */
+    getByType(type: string): IView[];
+    /**
+     * Get number of registered Views
+     */
+    size(): number;
+    /**
+     * Clear all Views
+     *
+     * Used during app teardown
+     */
+    clear(): void;
+}
+/**
+ * Factory function to create ViewRegistry instances
+ */
+export declare function createViewRegistry(): ViewRegistry;

package/dist/worker-runtime/app-kernel/view-registry.js

@@ -0,0 +1,119 @@
+/**
+ * AOTUI Runtime - ViewRegistry
+ *
+ * Lightweight View management for component mode.
+ * Replaces ViewTree with a simpler flat structure.
+ *
+ * Design Goals:
+ * - Minimal API surface (register, unregister, get, has)
+ * - No tree management (parent-child relationships handled by components)
+ * - No lifecycle management (components manage their own mount/dismount)
+ * - Performance: O(1) lookups, minimal memory overhead
+ *
+ * @module @aotui/runtime/worker-runtime/app-kernel
+ */
+import { AOTUIError } from '../../spi/core/errors.js';
+/**
+ * ViewRegistry - Simplified View management
+ *
+ * Compared to ViewTree (~800 lines):
+ * - No parent-child tracking
+ * - No mount/dismount lifecycle
+ * - No tree rendering
+ * - ~50 lines of code
+ *
+ * Views are registered by SDK components via AppKernel.registerView()
+ * and unregistered when components unmount.
+ */
+export class ViewRegistry {
+    views = new Map();
+    /**
+     * Register a View
+     *
+     * @throws {AOTUIError} VIEW_DUPLICATE if viewId already registered
+     */
+    register(view) {
+        if (this.views.has(view.id)) {
+            throw new AOTUIError('VIEW_DUPLICATE', { viewId: view.id });
+        }
+        this.views.set(view.id, view);
+        if (process.env.NODE_ENV !== 'production') {
+            console.log(`[ViewRegistry] Registered ${view.id} (${view.name})`);
+        }
+    }
+    /**
+     * Unregister a View
+     *
+     * Idempotent: no error if view doesn't exist
+     */
+    unregister(viewId) {
+        const existed = this.views.delete(viewId);
+        if (existed && process.env.NODE_ENV !== 'production') {
+            console.log(`[ViewRegistry] Unregistered ${viewId}`);
+        }
+    }
+    /**
+     * Get a View by ID
+     *
+     * @returns View instance or undefined if not found
+     */
+    get(viewId) {
+        return this.views.get(viewId);
+    }
+    /**
+     * Check if a View is registered
+     */
+    has(viewId) {
+        return this.views.has(viewId);
+    }
+    /**
+     * Get all registered Views
+     *
+     * @returns Array of all Views (order not guaranteed)
+     */
+    getAll() {
+        return Array.from(this.views.values());
+    }
+    /**
+     * Get all View IDs
+     */
+    getAllIds() {
+        return Array.from(this.views.keys());
+    }
+    /**
+     * Get Views by type
+     *
+     * Used for Tool聚合 in View Type mechanism.
+     *
+     * @param type - View type to filter by
+     * @returns Array of Views with matching type
+     */
+    getByType(type) {
+        return Array.from(this.views.values())
+            .filter(v => (v.type || v.name) === type);
+    }
+    /**
+     * Get number of registered Views
+     */
+    size() {
+        return this.views.size;
+    }
+    /**
+     * Clear all Views
+     *
+     * Used during app teardown
+     */
+    clear() {
+        if (process.env.NODE_ENV !== 'production') {
+            console.log(`[ViewRegistry] Clearing ${this.views.size} views`);
+        }
+        this.views.clear();
+    }
+}
+/**
+ * Factory function to create ViewRegistry instances
+ */
+export function createViewRegistry() {
+    return new ViewRegistry();
+}
+//# sourceMappingURL=view-registry.js.map

package/dist/worker-runtime/app-kernel/view-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-registry.js","sourceRoot":"","sources":["../../../src/worker-runtime/app-kernel/view-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,YAAY;IACb,KAAK,GAAG,IAAI,GAAG,EAAiB,CAAC;IAEzC;;;;OAIG;IACH,QAAQ,CAAC,IAAW;QAChB,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,UAAU,CAAC,gBAAgB,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAE9B,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,6BAA6B,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACvE,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAC,MAAc;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAE1C,IAAI,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;YACnD,OAAO,CAAC,GAAG,CAAC,+BAA+B,MAAM,EAAE,CAAC,CAAC;QACzD,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,MAAc;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,MAAc;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,MAAM;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,SAAS;QACL,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED;;;;;;;OAOG;IACH,SAAS,CAAC,IAAY;QAClB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;aACjC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,IAAI;QACA,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACH,KAAK;QACD,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAC9B,OAAO,IAAI,YAAY,EAAE,CAAC;AAC9B,CAAC"}

package/dist/worker-runtime/app-kernel/view-tree.d.ts

@@ -0,0 +1,222 @@
+/**
+ * AOTUI Runtime - ViewTree Implementation
+ *
+ * [方案 B] 从 @aotui/sdk 迁移到 @aotui/runtime/worker-runtime。
+ *
+ * 这是 IViewTree 的实现，管理 App 内部的 View 层级结构。
+ * 作为 Worker Kernel 的一部分，负责：
+ * - 添加/移除 Views
+ * - 挂载/卸载 Views
+ * - 渲染树结构
+ * - 操作路由
+ *
+ * @module @aotui/runtime/worker-runtime/app-kernel
+ */
+import type { IViewTree, ViewNode, ViewContextFactory, MountableViewEntry } from '../../spi/index.js';
+import type { IView, ViewID, LinkEntry } from '../../spi/index.js';
+export type { ViewContextFactory, MountableViewEntry };
+/**
+ * ViewTree Implementation
+ *
+ * Runtime's own implementation of the IViewTree interface.
+ * This is used by AppKernel to manage the App's view hierarchy.
+ */
+export declare class ViewTree implements IViewTree {
+    private nodes;
+    private _rootId;
+    private contextFactory;
+    /**
+     * @param contextFactory - Factory function to create ViewContext for each View
+     */
+    constructor(contextFactory: ViewContextFactory);
+    get rootId(): ViewID | null;
+    getNode(viewId: ViewID): ViewNode | undefined;
+    getView(viewId: ViewID): IView | undefined;
+    /**
+     * Add View to tree
+     *
+     * Includes depth checking and cycle detection.
+     */
+    addView(view: IView, parentId: ViewID | null): void;
+    /**
+     * Calculate node depth (distance from root to this node)
+     */
+    private getDepth;
+    /**
+     * Remove View (and its subtree)
+     */
+    removeView(viewId: ViewID): void;
+    /**
+     * Mount View
+     */
+    mountView(viewId: ViewID): Promise<void>;
+    /**
+     * Dismount View
+     */
+    dismountView(viewId: ViewID): Promise<void>;
+    /**
+     * Get all mounted Views
+     */
+    getMountedViews(): IView[];
+    /**
+     * Get View's full path (from root to this node)
+     */
+    getPath(viewId: ViewID): ViewID[];
+    /**
+     * Get child Views
+     */
+    getChildren(viewId: ViewID): IView[];
+    /**
+     * Render View Tree state
+     *
+     * [RFC-007] Output format:
+     * ## Application View Tree
+     * - [Navigation](view:view_0, mounted)
+     *     - [Conversations](view:view_1, mounted)
+     *         ↳ [Contact Detail](link:CD_0)
+     *
+     * Only mounted views are shown. Unmounted ViewLinks use link: protocol.
+     */
+    renderTree(): string;
+    /**
+     * [RFC-007] Enhanced node renderer - only mounted views
+     */
+    private renderNodeV2;
+    /**
+     * @deprecated Use renderNodeV2 for RFC-007 compliance
+     */
+    private renderNode;
+    /**
+     * Render all mounted View contents
+     *
+     * SDK View components output HTML with view attribute (e.g., <div view="Chat">),
+     * Transformer will convert to <view> tag.
+     */
+    renderMountedViews(): string;
+    private mountableEntries;
+    /**
+     * Register a mountable view (unmounted state)
+     *
+     * Called by ViewLink. The view is NOT created yet - only the factory and props
+     * are cached. When Agent calls mount_view, we use these to create the actual View.
+     *
+     * @param viewId - Pre-generated view ID (from FunctionalApp)
+     * @param parentId - Parent view ID (where the ViewLink is rendered)
+     * @param factory - View factory function
+     * @param props - Props to pass when mounted
+     * @param label - Display label (optional)
+     */
+    registerMountableView(viewId: ViewID, parentId: ViewID, factory: (viewId: string, props?: Record<string, unknown>) => IView, props?: Record<string, unknown>, label?: string): void;
+    /**
+     * Unregister a mountable view
+     *
+     * Called when ViewLink is removed from React tree.
+     *
+     * IMPORTANT: If the view has already been mounted (via mount_view),
+     * we should NOT remove it from the tree. Only clean up the mountable entry.
+     */
+    unregisterMountableView(viewId: ViewID): void;
+    /**
+     * Get mountable entry (factory + props) for a view ID
+     */
+    getMountableEntry(viewId: ViewID): MountableViewEntry | undefined;
+    /**
+     * Mount a previously registered mountable view
+     *
+     * Called by Runtime when Agent invokes mount_view.
+     * Creates the actual View instance using cached factory and props.
+     */
+    mountMountableView(viewId: ViewID): Promise<void>;
+    /**
+     * Check if a view ID is a registered mountable view (not yet instantiated)
+     */
+    isMountableView(viewId: ViewID): boolean;
+    /**
+     * Get all mountable (unmounted) children of a view
+     */
+    getMountableChildren(parentId: ViewID): ViewID[];
+    /**
+     * LinkEntry storage by parent view
+     * Map<parentViewId, Map<linkId, LinkEntry>>
+     */
+    private linksByParent;
+    /**
+     * LinkID counter by parent view and prefix
+     * Map<parentViewId, Map<prefix, counter>>
+     */
+    private linkIdCounters;
+    /**
+     * Binding: ViewType:UniqueId -> ViewID
+     * Used for cross-snapshot matching
+     */
+    private uniqueIdBindings;
+    /**
+     * Allocate a unique LinkID for a given prefix within a parent view
+     */
+    allocateLinkId(parentId: ViewID, prefix: string): string;
+    /**
+     * Register a ViewLink
+     *
+     * @param parentId - Parent View ID
+     * @param entry - Link entry data
+     */
+    registerLink(parentId: ViewID, entry: LinkEntry): void;
+    /**
+     * Unregister a ViewLink
+     */
+    unregisterLink(parentId: ViewID, linkId: string): void;
+    /**
+     * Get bound ViewID for a ViewType + UniqueID combination
+     */
+    getBoundViewId(viewType: string, uniqueId: string): ViewID | undefined;
+    /**
+     * Mount a view via ViewLink
+     *
+     * Called when Agent executes mount(parent_view, link_id)
+     *
+     * @param parentId - Parent View ID
+     * @param linkId - Link ID
+     * @returns Mounted ViewID
+     */
+    mountByLink(parentId: ViewID, linkId: string): Promise<ViewID>;
+    /**
+     * Get all links in a parent view (for rendering)
+     */
+    getLinksInParent(parentId: ViewID): LinkEntry[];
+    /**
+     * Reset link counters for a parent view
+     * Called at the start of each render cycle
+     */
+    resetLinkCounters(parentId: ViewID): void;
+    /**
+     * Clear all links for a parent view
+     * Called when parent view is unmounted
+     */
+    clearLinksForParent(parentId: ViewID): void;
+    /**
+     * Register a component-mode View (from SDK's View component)
+     *
+     * Component-mode Views:
+     * - Are registered directly without parent (flat structure)
+     * - Manage their own mounted state via React lifecycle
+     * - Don't participate in traditional ViewTree hierarchy
+     *
+     * This method unifies View storage, making ViewTree the single source of truth
+     * for both traditional-mode and component-mode Views.
+     *
+     * @param view - IView instance created by createInlineView()
+     */
+    registerComponentView(view: IView): void;
+    /**
+     * Unregister a component-mode View
+     *
+     * Called when SDK View component unmounts (via useLayoutEffect cleanup)
+     *
+     * @param viewId - View ID to unregister
+     */
+    unregisterComponentView(viewId: ViewID): void;
+}
+/**
+ * Factory function to create ViewTree instances.
+ */
+export declare function createViewTree(contextFactory: ViewContextFactory): IViewTree;