@aotui/runtime 1.0.0

package/dist/engine/view/transformer/visitors/view.visitor.js

@@ -0,0 +1,43 @@
+/**
+ * View Visitor
+ *
+ * Handles <view> definition elements (view="..." or data-is-view).
+ * Responsible for maintaining currentViewId context.
+ */
+export const viewVisitor = {
+    name: 'view',
+    priority: 20,
+    matches(el, ctx) {
+        const viewAttr = el.getAttribute('view');
+        // View definition if:
+        // 1. has 'view' attribute AND NO 'href' (href implies it's a link)
+        // 2. OR has explicit 'data-is-view' marker
+        // 3. AND has 'name' attribute or 'view' attribute value is used as name
+        const isViewDefinition = (!!viewAttr && !el.hasAttribute('href')) || el.hasAttribute('data-is-view');
+        const viewName = viewAttr || el.getAttribute('name');
+        return isViewDefinition && !!viewName;
+    },
+    transform(el, ctx, children) {
+        const viewAttr = el.getAttribute('view');
+        const viewName = viewAttr || el.getAttribute('name');
+        const viewId = el.id || null;
+        // [Contract Enforced] SDK must provide ID
+        if (!viewId) {
+            console.error(`[Transformer] View "${viewName}" is missing required 'id' attribute. ` +
+                `This View will be skipped. Please ensure SDK View outputs id.`);
+            // Traverse children but don't wrap in <view>
+            const childMarkup = children(el, ctx);
+            return childMarkup.join('\n');
+        }
+        // Manage Context
+        const prevViewId = ctx.currentViewId;
+        ctx.currentViewId = viewId;
+        // Recursively process children
+        const childMarkup = children(el, ctx);
+        const childrenContent = childMarkup.join('\n');
+        // Restore Context
+        ctx.currentViewId = prevViewId;
+        return `\n<view id="${viewId}" name="${viewName}">\n${childrenContent}\n</view>\n`;
+    }
+};
+//# sourceMappingURL=view.visitor.js.map

package/dist/engine/view/transformer/visitors/view.visitor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.visitor.js","sourceRoot":"","sources":["../../../../../src/engine/view/transformer/visitors/view.visitor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,CAAC,MAAM,WAAW,GAAoB;IACxC,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,EAAE;IAEZ,OAAO,CAAC,EAAW,EAAE,GAA+B;QAChD,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACzC,sBAAsB;QACtB,mEAAmE;QACnE,2CAA2C;QAC3C,wEAAwE;QACxE,MAAM,gBAAgB,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;QACrG,MAAM,QAAQ,GAAG,QAAQ,IAAI,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAErD,OAAO,gBAAgB,IAAI,CAAC,CAAC,QAAQ,CAAC;IAC1C,CAAC;IAED,SAAS,CACL,EAAW,EACX,GAAqB,EACrB,QAA2B;QAE3B,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,QAAQ,IAAI,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,EAAE,CAAC,EAAE,IAAI,IAAI,CAAC;QAE7B,0CAA0C;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,OAAO,CAAC,KAAK,CACT,uBAAuB,QAAQ,wCAAwC;gBACvE,+DAA+D,CAClE,CAAC;YACF,6CAA6C;YAC7C,MAAM,WAAW,GAAG,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;YACtC,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;QAED,iBAAiB;QACjB,MAAM,UAAU,GAAG,GAAG,CAAC,aAAa,CAAC;QACrC,GAAG,CAAC,aAAa,GAAG,MAAM,CAAC;QAE3B,+BAA+B;QAC/B,MAAM,WAAW,GAAG,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QACtC,MAAM,eAAe,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE/C,kBAAkB;QAClB,GAAG,CAAC,aAAa,GAAG,UAAU,CAAC;QAE/B,OAAO,eAAe,MAAM,WAAW,QAAQ,OAAO,eAAe,aAAa,CAAC;IACvF,CAAC;CACJ,CAAC"}

package/dist/engine/view/types.d.ts

@@ -0,0 +1,70 @@
+/**
+ * AOTUI View 类型定义
+ *
+ * View 是 App 的 UI 组件，每个 View 有自己的:
+ * - 唯一 ID (由 Runtime 分配)
+ * - 数据状态
+ * - 操作集合 (operations)
+ * - 渲染逻辑
+ *
+ * View 形成树状结构，例如:
+ * - [Navigation](view:view_0, mounted)
+ *     - [Conversations](view:view_1, mounted)
+ *         - [Johnny Chat](view:view_3, mounted)
+ *     - [Contacts](view:view_2)
+ */
+import { ViewID, AppID, DesktopID, IView, IViewContext } from '../../spi/index.js';
+export type { IView, IViewContext };
+export type { ViewID } from '../../spi/index.js';
+/**
+ * View 运行上下文
+ *
+ * 提供 View 运行所需的能力
+ *
+ * [H1 FIX] This is a local alias for IViewContext from SPI.
+ * New code should use IViewContext directly.
+ *
+ * [Plan A] 添加 container 字段支持 one app = one dom
+ * [Plan B] 添加 document 字段确保 DOM 隔离
+ */
+export interface ViewContext {
+    /** 所属 App ID (Branded Type) */
+    readonly appId: AppID;
+    /** 所属 Desktop ID (用于加载相关数据，如历史消息) (Branded Type) */
+    readonly desktopId: DesktopID;
+    /** 此 View 的 ID */
+    readonly viewId: ViewID;
+    /**
+     * [Plan A] View 的 DOM 容器
+     *
+     * 由 App 在其 DOM 树中创建，View 渲染内容到此容器。
+     */
+    readonly container: HTMLElement;
+    /**
+     * [Plan B] App 的 Document 对象
+     */
+    readonly document: Document;
+    /**
+     * 通知 UI 更新
+     * View 状态变化后调用此方法触发重新渲染
+     */
+    notifyUpdate(): void;
+    /**
+     * 请求 mount 子 View
+     *
+     * @example
+     * // Agent 执行: mount view --id view_3
+     * await context.mountChildView('view_3');
+     */
+    mountChildView(viewId: ViewID): Promise<void>;
+    /**
+     * 请求 dismount 子 View
+     */
+    dismountChildView(viewId: ViewID): Promise<void>;
+}
+/**
+ * [B1 FIX] IViewTree is now defined in SPI layer.
+ * Re-exported here for backward compatibility within Engine.
+ */
+export type { IViewTree, ViewNode, // Consolidated export
+ViewNode as ViewNodeFromSPI, ViewContextFactory } from '../../spi/index.js';

package/dist/engine/view/types.js

@@ -0,0 +1,17 @@
+/**
+ * AOTUI View 类型定义
+ *
+ * View 是 App 的 UI 组件，每个 View 有自己的:
+ * - 唯一 ID (由 Runtime 分配)
+ * - 数据状态
+ * - 操作集合 (operations)
+ * - 渲染逻辑
+ *
+ * View 形成树状结构，例如:
+ * - [Navigation](view:view_0, mounted)
+ *     - [Conversations](view:view_1, mounted)
+ *         - [Johnny Chat](view:view_3, mounted)
+ *     - [Contacts](view:view_2)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/engine/view/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/engine/view/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}

package/dist/facades/facades.d.ts

@@ -0,0 +1,40 @@
+/**
+ * SDK Layer - Runtime Facade
+ *
+ * 提供简化的 Runtime 创建和使用接口。
+ * 这是大多数开发者的入口点。
+ *
+ * [DIP] Uses createKernel factory for proper dependency injection.
+ */
+import type { IKernel } from '../spi/index.js';
+import { RUNTIME_DEFAULTS, type RuntimeConfig, type RuntimeConfigInput, defineRuntimeConfig } from '../spi/config/index.js';
+export { RUNTIME_DEFAULTS, type RuntimeConfig, type RuntimeConfigInput, defineRuntimeConfig };
+export interface LegacyRuntimeConfig {
+    /** Snapshot TTL（毫秒），默认 10 分钟 */
+    snapshotTTL?: number;
+}
+/**
+ * 创建 AOTUI Runtime 实例
+ *
+ * 这是最简单的入口点，封装了所有内部依赖的创建。
+ *
+ * [DIP] Uses createKernel factory internally to maintain proper dependency injection.
+ *
+ * @example
+ * ```typescript
+ * import { createRuntime, defineRuntimeConfig } from '@aotui/runtime';
+ *
+ * // 零配置
+ * const runtime = createRuntime();
+ *
+ * // 自定义配置 (RFC-005)
+ * const config = defineRuntimeConfig({
+ *   worker: { timeoutMs: 60000 }
+ * });
+ * const runtime = createRuntime(config);
+ *
+ * const desktopId = await runtime.createDesktop();
+ * await runtime.installDynamicApp(desktopId, new MyChatApp());
+ * ```
+ */
+export declare function createRuntime(input?: LegacyRuntimeConfig | RuntimeConfigInput): IKernel;

package/dist/facades/facades.js

@@ -0,0 +1,66 @@
+/**
+ * SDK Layer - Runtime Facade
+ *
+ * 提供简化的 Runtime 创建和使用接口。
+ * 这是大多数开发者的入口点。
+ *
+ * [DIP] Uses createKernel factory for proper dependency injection.
+ */
+import { SnapshotRegistry } from '../engine/system/index.js';
+import { createSystemOperationRegistry } from '../engine/system/index.js';
+import { DesktopManager } from '../engine/core/index.js';
+import { createKernel } from '../factory/createKernel.js';
+import { RUNTIME_DEFAULTS, defineRuntimeConfig } from '../spi/config/index.js';
+export { RUNTIME_DEFAULTS, defineRuntimeConfig };
+// ============================================================================
+// 快捷工厂函数
+// ============================================================================
+/**
+ * 创建 AOTUI Runtime 实例
+ *
+ * 这是最简单的入口点，封装了所有内部依赖的创建。
+ *
+ * [DIP] Uses createKernel factory internally to maintain proper dependency injection.
+ *
+ * @example
+ * ```typescript
+ * import { createRuntime, defineRuntimeConfig } from '@aotui/runtime';
+ *
+ * // 零配置
+ * const runtime = createRuntime();
+ *
+ * // 自定义配置 (RFC-005)
+ * const config = defineRuntimeConfig({
+ *   worker: { timeoutMs: 60000 }
+ * });
+ * const runtime = createRuntime(config);
+ *
+ * const desktopId = await runtime.createDesktop();
+ * await runtime.installDynamicApp(desktopId, new MyChatApp());
+ * ```
+ */
+export function createRuntime(input = {}) {
+    // [RFC-005] Normalize Configuration
+    let config;
+    // Check if input has new config structure properties (or is empty/custom object)
+    // Simple heuristic: if it has 'worker', 'bridge', 'lock', etc. OR it is the result of defineRuntimeConfig (which is frozen)
+    // But since Legacy only has snapshotTTL, checking that is easier.
+    const legacy = input;
+    if (legacy.snapshotTTL !== undefined) {
+        // Legacy Config
+        config = defineRuntimeConfig({
+            snapshot: { ttlMs: legacy.snapshotTTL }
+        });
+    }
+    else {
+        // New Config Input (or empty)
+        config = defineRuntimeConfig(input);
+    }
+    const desktopManager = new DesktopManager(config);
+    const snapshotRegistry = new SnapshotRegistry({
+        ttl: config.snapshot.ttlMs
+    });
+    const systemOps = createSystemOperationRegistry();
+    return createKernel(desktopManager, snapshotRegistry, systemOps);
+}
+//# sourceMappingURL=facades.js.map

package/dist/facades/facades.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"facades.js","sourceRoot":"","sources":["../../src/facades/facades.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,OAAO,EACH,gBAAgB,EAGhB,mBAAmB,EACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,gBAAgB,EAA+C,mBAAmB,EAAE,CAAC;AAW9F,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,aAAa,CAAC,QAAkD,EAAE;IAC9E,oCAAoC;IACpC,IAAI,MAAqB,CAAC;IAE1B,iFAAiF;IACjF,4HAA4H;IAC5H,kEAAkE;IAElE,MAAM,MAAM,GAAG,KAA4B,CAAC;IAC5C,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACnC,gBAAgB;QAChB,MAAM,GAAG,mBAAmB,CAAC;YACzB,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,WAAW,EAAE;SAC1C,CAAC,CAAC;IACP,CAAC;SAAM,CAAC;QACJ,8BAA8B;QAC9B,MAAM,GAAG,mBAAmB,CAAC,KAA2B,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,cAAc,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,CAAC;QAC1C,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK;KAC7B,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,6BAA6B,EAAE,CAAC;IAElD,OAAO,YAAY,CACf,cAAc,EACd,gBAAgB,EAChB,SAAS,CACZ,CAAC;AACN,CAAC"}

package/dist/facades/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Facades Layer - Runtime Factory Functions
+ *
+ * [P1 FIX] Renamed from "sdk" to "facades" for clarity.
+ *
+ * Purpose: Provide simplified factory functions for Product Layer (Server)
+ * to create and configure AOTUI Runtime instances.
+ *
+ * Note: This is NOT the Developer SDK. For building TUI apps, use @aotui/sdk:
+ *   import { ViewBasedApp, View, Operation } from '@aotui/sdk';
+ */
+export { createRuntime, LegacyRuntimeConfig, RuntimeConfig } from './facades.js';
+export { defineRuntimeConfig, RuntimeConfigInput } from '../spi/config/index.js';

package/dist/facades/index.js

@@ -0,0 +1,15 @@
+/**
+ * Facades Layer - Runtime Factory Functions
+ *
+ * [P1 FIX] Renamed from "sdk" to "facades" for clarity.
+ *
+ * Purpose: Provide simplified factory functions for Product Layer (Server)
+ * to create and configure AOTUI Runtime instances.
+ *
+ * Note: This is NOT the Developer SDK. For building TUI apps, use @aotui/sdk:
+ *   import { ViewBasedApp, View, Operation } from '@aotui/sdk';
+ */
+// Facade 函数
+export { createRuntime } from './facades.js';
+export { defineRuntimeConfig } from '../spi/config/index.js';
+//# sourceMappingURL=index.js.map

package/dist/facades/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/facades/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,YAAY;AACZ,OAAO,EAAE,aAAa,EAAsC,MAAM,cAAc,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAsB,MAAM,wBAAwB,CAAC"}

package/dist/factory/createKernel.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Kernel Factory - createKernel
+ *
+ * Factory function that creates a properly configured Kernel instance.
+ * This is the recommended way to instantiate the Kernel.
+ *
+ * [DIP] The Kernel depends on interfaces (ITransformer, IDispatcher).
+ * This factory wires up the concrete implementations, keeping Kernel pure.
+ *
+ * @module @aotui/runtime/factory
+ */
+import type { IKernel, IDesktopManager, IRegistry, ISystemOperationRegistry } from '../spi/index.js';
+/**
+ * Creates a new Kernel instance with default implementations.
+ *
+ * This factory wires up:
+ * - Transformer (for DOM → TUI Markup conversion)
+ * - Dispatcher (for Operation routing)
+ *
+ * @param desktopManager - The Desktop manager implementation
+ * @param snapshotRegistry - The Snapshot registry implementation
+ * @param systemOps - The System Operation registry
+ * @returns A configured IKernel instance
+ *
+ * @example
+ * ```typescript
+ * import { createKernel } from '@aotui/runtime';
+ * import { DesktopManager, SnapshotRegistry, SystemOperationRegistry } from '@aotui/runtime';
+ *
+ * const kernel = createKernel(
+ *     new DesktopManager(),
+ *     new SnapshotRegistry(),
+ *     new SystemOperationRegistry()
+ * );
+ * ```
+ */
+export declare function createKernel(desktopManager: IDesktopManager, snapshotRegistry: IRegistry, systemOps: ISystemOperationRegistry): IKernel;

package/dist/factory/createKernel.js

@@ -0,0 +1,42 @@
+/**
+ * Kernel Factory - createKernel
+ *
+ * Factory function that creates a properly configured Kernel instance.
+ * This is the recommended way to instantiate the Kernel.
+ *
+ * [DIP] The Kernel depends on interfaces (ITransformer, IDispatcher).
+ * This factory wires up the concrete implementations, keeping Kernel pure.
+ *
+ * @module @aotui/runtime/factory
+ */
+import { Kernel } from '../kernel/index.js';
+import { Transformer } from '../engine/view/index.js';
+import { Dispatcher } from '../engine/system/index.js';
+/**
+ * Creates a new Kernel instance with default implementations.
+ *
+ * This factory wires up:
+ * - Transformer (for DOM → TUI Markup conversion)
+ * - Dispatcher (for Operation routing)
+ *
+ * @param desktopManager - The Desktop manager implementation
+ * @param snapshotRegistry - The Snapshot registry implementation
+ * @param systemOps - The System Operation registry
+ * @returns A configured IKernel instance
+ *
+ * @example
+ * ```typescript
+ * import { createKernel } from '@aotui/runtime';
+ * import { DesktopManager, SnapshotRegistry, SystemOperationRegistry } from '@aotui/runtime';
+ *
+ * const kernel = createKernel(
+ *     new DesktopManager(),
+ *     new SnapshotRegistry(),
+ *     new SystemOperationRegistry()
+ * );
+ * ```
+ */
+export function createKernel(desktopManager, snapshotRegistry, systemOps) {
+    return new Kernel(desktopManager, snapshotRegistry, new Transformer(), new Dispatcher(), systemOps);
+}
+//# sourceMappingURL=createKernel.js.map

package/dist/factory/createKernel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createKernel.js","sourceRoot":"","sources":["../../src/factory/createKernel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAQvD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,YAAY,CACxB,cAA+B,EAC/B,gBAA2B,EAC3B,SAAmC;IAEnC,OAAO,IAAI,MAAM,CACb,cAAc,EACd,gBAAgB,EAChB,IAAI,WAAW,EAAE,EACjB,IAAI,UAAU,EAAE,EAChB,SAAS,CACZ,CAAC;AACN,CAAC"}

package/dist/factory/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Factory Module - Public API
+ *
+ * Factory functions for creating Runtime components.
+ * These are the recommended entry points for instantiation.
+ *
+ * @module @aotui/runtime/factory
+ */
+export { createKernel } from './createKernel.js';

package/dist/factory/index.js

@@ -0,0 +1,10 @@
+/**
+ * Factory Module - Public API
+ *
+ * Factory functions for creating Runtime components.
+ * These are the recommended entry points for instantiation.
+ *
+ * @module @aotui/runtime/factory
+ */
+export { createKernel } from './createKernel.js';
+//# sourceMappingURL=index.js.map

package/dist/factory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/factory/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @aotui/runtime - AOTUI Runtime Package
+ *
+ * This is the main entry point for the AOTUI runtime.
+ *
+ * ## Recommended Imports
+ *
+ * ### For App Developers (SDK Layer)
+ * ```typescript
+ * import { createRuntime } from '@aotui/runtime';
+ * ```
+ *
+ * ### For Types (SPI Layer)
+ * ```typescript
+ * import type { IView, IViewContext, IKernel, OperationResult } from '@aotui/runtime';
+ * ```
+ *
+ * ### For Integration (Adapters Layer)
+ * ```typescript
+ * import { Bridge, SYSTEM_TOOLS, generateToolsFromIndexMap } from '@aotui/runtime';
+ * ```
+ *
+ * ## ⚠️ Internal APIs
+ * Engine layer exports (Desktop, ViewTree, Registry, etc.) are for framework
+ * contributors only. They may change without notice.
+ *
+ * @module @aotui/runtime
+ */
+export * from './facades/index.js';
+export * from './spi/index.js';
+export * from './kernel/index.js';
+export * from './adapters/bridge/index.js';
+export { AppRegistry } from './engine/app/index.js';
+export type { LoadedApp, AppRegistryOptions, TUIConfig, AppConfigEntry } from './engine/app/index.js';
+export { createSystemOperationRegistry } from './engine/system/operations/index.js';

package/dist/index.js

@@ -0,0 +1,69 @@
+/**
+ * @aotui/runtime - AOTUI Runtime Package
+ *
+ * This is the main entry point for the AOTUI runtime.
+ *
+ * ## Recommended Imports
+ *
+ * ### For App Developers (SDK Layer)
+ * ```typescript
+ * import { createRuntime } from '@aotui/runtime';
+ * ```
+ *
+ * ### For Types (SPI Layer)
+ * ```typescript
+ * import type { IView, IViewContext, IKernel, OperationResult } from '@aotui/runtime';
+ * ```
+ *
+ * ### For Integration (Adapters Layer)
+ * ```typescript
+ * import { Bridge, SYSTEM_TOOLS, generateToolsFromIndexMap } from '@aotui/runtime';
+ * ```
+ *
+ * ## ⚠️ Internal APIs
+ * Engine layer exports (Desktop, ViewTree, Registry, etc.) are for framework
+ * contributors only. They may change without notice.
+ *
+ * @module @aotui/runtime
+ */
+// ============================================================================
+// 🟢 Public: Facades Layer (Product Layer Integration)
+// ============================================================================
+// [P1 FIX] Renamed from "sdk" to "facades" to avoid confusion with @aotui/sdk package
+// This provides factory functions for Product Layer (Server) to create Runtime instances
+export * from './facades/index.js';
+// ============================================================================
+// 🟢 Public: SPI Layer (Types & Interfaces - Stable Contract)
+// ============================================================================
+export * from './spi/index.js';
+// ============================================================================
+// 🟢 Public: Kernel (Orchestrator - Stable API)
+// ============================================================================
+export * from './kernel/index.js';
+// ============================================================================
+// 🟢 Public: Adapters Layer (Integration Points)
+// ============================================================================
+export * from './adapters/bridge/index.js';
+// ============================================================================
+// 🟢 Public: App Registry (Third-Party App Management)
+// Used by Product Layer to load and manage third-party TUI apps
+// ============================================================================
+export { AppRegistry } from './engine/app/index.js';
+// ============================================================================
+// 🟢 Public: System Operations (For Agent Driver)
+// ============================================================================
+export { createSystemOperationRegistry } from './engine/system/operations/index.js';
+// ============================================================================
+// 🔴 REMOVED: Engine Layer Exports
+//
+// [方案 B] Engine internals are no longer exported to external consumers.
+// ViewTree implementation is internal to Worker Runtime (AppKernel).
+//
+// For Runtime internal use (tests), import directly via relative paths:
+//   import { ViewTree } from './engine/view/tree.js';
+//
+// If you need functionality that was previously exported, consider:
+// 1. Is there an SPI interface you should use instead?
+// 2. Should this functionality be exposed through the SDK layer?
+// ============================================================================
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,+EAA+E;AAC/E,uDAAuD;AACvD,+EAA+E;AAC/E,sFAAsF;AACtF,yFAAyF;AACzF,cAAc,oBAAoB,CAAC;AAEnC,+EAA+E;AAC/E,8DAA8D;AAC9D,+EAA+E;AAC/E,cAAc,gBAAgB,CAAC;AAE/B,+EAA+E;AAC/E,gDAAgD;AAChD,+EAA+E;AAC/E,cAAc,mBAAmB,CAAC;AAElC,+EAA+E;AAC/E,iDAAiD;AACjD,+EAA+E;AAC/E,cAAc,4BAA4B,CAAC;AAG3C,+EAA+E;AAC/E,uDAAuD;AACvD,gEAAgE;AAChE,+EAA+E;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,+EAA+E;AAC/E,kDAAkD;AAClD,+EAA+E;AAC/E,OAAO,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AAEpF,+EAA+E;AAC/E,mCAAmC;AACnC,EAAE;AACF,wEAAwE;AACxE,qEAAqE;AACrE,EAAE;AACF,wEAAwE;AACxE,sDAAsD;AACtD,EAAE;AACF,oEAAoE;AACpE,uDAAuD;AACvD,iEAAiE;AACjE,+EAA+E"}

package/dist/internal/browser.d.ts

@@ -0,0 +1,20 @@
+/**
+ * AOTUI Runtime - Browser Entry Point
+ *
+ * This module exports only the browser-compatible parts of the runtime,
+ * specifically the Transformer which works with native browser DOM.
+ *
+ * Usage in browser:
+ * ```html
+ * <script type="module">
+ * import { Transformer } from './aotui-runtime.browser.js';
+ *
+ * const transformer = new Transformer();
+ * const container = document.createElement('div');
+ * container.innerHTML = htmlContent;
+ * const { markup, indexMap } = transformer.transform({ body: container });
+ * </script>
+ * ```
+ */
+export { Transformer } from '../engine/view/index.js';
+export type { IndexMap, DataPayload } from '../spi/index.js';

package/dist/internal/browser.js

@@ -0,0 +1,20 @@
+/**
+ * AOTUI Runtime - Browser Entry Point
+ *
+ * This module exports only the browser-compatible parts of the runtime,
+ * specifically the Transformer which works with native browser DOM.
+ *
+ * Usage in browser:
+ * ```html
+ * <script type="module">
+ * import { Transformer } from './aotui-runtime.browser.js';
+ *
+ * const transformer = new Transformer();
+ * const container = document.createElement('div');
+ * container.innerHTML = htmlContent;
+ * const { markup, indexMap } = transformer.transform({ body: container });
+ * </script>
+ * ```
+ */
+export { Transformer } from '../engine/view/index.js';
+//# sourceMappingURL=browser.js.map

package/dist/internal/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/internal/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC"}