@proteus-vue/render-backend 0.3.0-beta.11 → 0.3.0-beta.23

package/dist/app-navigation.d.ts

@@ -0,0 +1,57 @@
+import type { AppScreenSpec, AppStack, AppStackPolicy } from '@proteus-vue/router/app-stack';
+import { createAppNavigationAdapter } from '@proteus-vue/router/app-route';
+import type { RouteRecord } from '@proteus-vue/router/types';
+import { type ScreenExecutor, type ScreenContentProvider } from './screen-executor';
+import { type HostInvokeChannel } from './screen-executor-host';
+export interface AppNavigationOptions {
+    /** 宿主通道（同步字符串往返；Android/iOS 壳已注入 `proteusHost.invoke`） */
+    invoke: HostInvokeChannel;
+    /**
+     * 屏注册表：与 `createAppStack` 同源。
+     * ★二选一：直接给 `screens`，或给 `routes`（本函数用 `screensFromRoutes` 推导——推荐，
+     *   消灭"手抄屏注册表"这段胶水）。
+     */
+    screens?: Record<string, AppScreenSpec>;
+    /** 路由表（`gen-routes` 产物；给了它就不必给 screens） */
+    routes?: RouteRecord[];
+    /** 内存治理策略（传给 `createAppStack`） */
+    policy?: AppStackPolicy;
+    /** ★批次 43：**屏内容提供者**（页面真实内容；缺省 ⇒ 空壳）——真实应用入口据此装页面 */
+    contentOf?: ScreenContentProvider;
+    /** 建屏完成通知（默认接 `stack.markRebuilt`——契约要求执行器建完调它） */
+    onScreenMounted?: (screenId: string, rebuild: boolean) => void;
+    /** 诊断事件（端口调用序——判据/测试读它） */
+    onEvent?: (e: {
+        type: string;
+        screenId?: string;
+        detail?: unknown;
+    }) => void;
+    /**
+     * 自动泵（默认 true）：栈操作产生的命令在**同一微任务**里交给执行器。
+     * ★关掉它 = 回到手工 `drainCommands`（仅用于需要自己控拍的场景）。
+     */
+    autoPump?: boolean;
+}
+export interface AppNavigation {
+    /** 虚拟路由栈（诊断/深栈读数用；正常导航走 adapter） */
+    stack: AppStack;
+    /** 命令流执行器（诊断/stats 用） */
+    executor: ScreenExecutor;
+    /** RouterAdapter（直接喂给 `createRouter(routes, { adapter })`） */
+    adapter: ReturnType<typeof createAppNavigationAdapter>;
+    /** 等当前命令流全部 settle（真机场景收工点；`router.push` 内部已 await） */
+    flush(): Promise<void>;
+    /** 宿主记账（`screen.stats`；判据读它——证明"动作真发生"） */
+    hostStats(): unknown;
+}
+/**
+ * 装配 App 端导航：栈 + 执行器 + 宿主端口 + Router 适配器。
+ *
+ * 用法（宿主 JS 入口，QuickJS/JSC 里）：
+ * ```ts
+ * const nav = createAppNavigation({ invoke: (m, a) => proteusHost.invoke(m, a), routes })
+ * const router = createRouter(routes, { adapter: nav.adapter })
+ * router.push({ name: 'detail', params: { id: 1 } })   // ← 零胶水
+ * ```
+ */
+export declare function createAppNavigation(opts: AppNavigationOptions): AppNavigation;