@proteus-vue/render-backend 0.1.0

package/dist/host-matrix.d.ts

@@ -0,0 +1,74 @@
+import { createVueDomBackend } from './vue-dom';
+import type { ProteusRenderBackend } from './spi';
+export type HostId = 'web' | 'ios' | 'android' | 'harmony' | 'flutter' | 'miniprogram';
+export type EngineId = 'vue-dom' | 'headless' | 'native-ios' | 'native-android' | 'native-harmony' | 'flutter';
+/** Tier：1 = 承诺验证（一等公民组合）/ 3 = 混入可行不承诺（Tier 3 自绘/嵌入）/ 0 = 不合法跨生态组合 */
+export type ComboTier = 0 | 1 | 3;
+export declare const HOSTS: readonly HostId[];
+export declare const ENGINES: readonly EngineId[];
+/**
+ * ★G-41 B6：宿主 × 引擎 Tier 矩阵（G-30 接入侧声明）。
+ * Tier 1 原则：宿主的原生引擎 + headless（SSR/测试/Agent 通用验证引擎）+ 混入自然的自绘（iOS/Android + Flutter）；
+ * 跨生态原生引擎（如 web + native-ios）= 0 不合法；可行但不承诺的组合 = 3（Tier 3 自绘/嵌入混入）。
+ */
+export declare const HOST_ENGINE_MATRIX: Record<HostId, Record<EngineId, ComboTier>>;
+export interface MatrixCombo {
+    readonly host: HostId;
+    readonly engine: EngineId;
+    readonly tier: ComboTier;
+}
+export declare function matrixCombos(filter?: {
+    tier?: ComboTier;
+}): MatrixCombo[];
+export declare function createEngine(engine: EngineId, documentLike?: Parameters<typeof createVueDomBackend>[0]): ProteusRenderBackend;
+export interface ComboCheck {
+    readonly id: string;
+    readonly ok: boolean;
+    readonly message?: string;
+}
+export interface ComboConformanceResult {
+    readonly host: HostId;
+    readonly engine: EngineId;
+    readonly ok: boolean;
+    readonly total: number;
+    readonly failed: number;
+    readonly checks: readonly ComboCheck[];
+}
+export interface ComboConformanceOptions {
+    /** vue-dom 引擎的 document 注入（缺省全局 document——happy-dom/浏览器可用） */
+    documentLike?: Parameters<typeof createVueDomBackend>[0];
+}
+/** ★G-41 B6：单组合 conformance（宿主×引擎×框架三方正交性的机器验证——failed === 0 准入） */
+export interface ComboConformanceOptions {
+    /** vue-dom 引擎的 document 注入（缺省全局 document——happy-dom/浏览器可用） */
+    documentLike?: Parameters<typeof createVueDomBackend>[0];
+}
+export declare function runComboConformance(opts: {
+    host: HostId;
+    engine: EngineId;
+} & ComboConformanceOptions): Promise<ComboConformanceResult>;
+export interface MatrixRow {
+    readonly host: HostId;
+    readonly engine: EngineId;
+    readonly tier: ComboTier;
+    /** tier 1 组合：验证结果；tier 0/3：未验证（null） */
+    readonly result: ComboConformanceResult | null;
+}
+export interface MatrixReport {
+    readonly totalCombos: number;
+    readonly tier1Combos: number;
+    readonly verified: number;
+    readonly failed: number;
+    readonly rows: readonly MatrixRow[];
+}
+export interface MatrixOptions extends ComboConformanceOptions {
+    /** 只跑指定宿主/引擎（调试用） */
+    only?: {
+        host?: HostId;
+        engine?: EngineId;
+    };
+}
+/** ★G-41 B6：跑宿主×引擎矩阵——全部 Tier 1 组合验证（failed === 0 准入；Tier 0/3 诚实标注未验证） */
+export declare function runHostEngineMatrix(opts?: MatrixOptions): Promise<MatrixReport>;
+/** ★G-41 B6：矩阵报告（面板/CLI 文本形态） */
+export declare function formatMatrixReport(report: MatrixReport): string;

package/dist/hot-switch.d.ts

@@ -0,0 +1,24 @@
+import type { IRNode, NodeHandle, ProteusRenderBackend } from './spi';
+import type { HotSwitchStrategy, ProteusNodeOpsDispatcher } from './dispatcher';
+export interface HotSwitchOptions {
+    strategy?: HotSwitchStrategy;
+    /** 切换前钩子（旧树清理/状态保存） */
+    onBeforeSwitch?: (from: ProteusRenderBackend, to: ProteusRenderBackend) => void;
+    /** 切换后钩子（挂载引用替换/新树就绪通知） */
+    onAfterSwitch?: (from: ProteusRenderBackend, to: ProteusRenderBackend, root: NodeHandle | null) => void;
+}
+export interface BackendSwitcher {
+    readonly dispatch: ProteusNodeOpsDispatcher;
+    /** 当前活跃 IR（业务状态载体——rehydrate 的「保状态」来源；null = 未挂载） */
+    readonly currentIR: IRNode | null;
+    /** 当前渲染根（rehydrate 后为新后端重建的树；rebuild/hybrid 后为 null——由调用方处置） */
+    readonly root: NodeHandle | null;
+    /** 首次挂载：在 dispatch.currentBackend 上建树 */
+    mount(ir: IRNode): NodeHandle;
+    /** 生产级热切换：策略下处理已渲染节点；返回新 root（rehydrate）或 null（rebuild/hybrid） */
+    switchBackend(next: ProteusRenderBackend, opts?: HotSwitchOptions): NodeHandle | null;
+    /** 清理活跃引用 */
+    destroy(): void;
+}
+/** ★G-41 B5：生产级热切换管理器 */
+export declare function createBackendSwitcher(dispatch: ProteusNodeOpsDispatcher): BackendSwitcher;

package/dist/hybrid.d.ts

@@ -0,0 +1,60 @@
+import type { BackendId, IRNode, NodeHandle, ProteusRenderBackend } from './spi';
+/** 区域路由（match 命中 → 该后端渲染此节点子树） */
+export interface HybridRegion {
+    /** 区域名（DevTools trace 展示） */
+    name?: string;
+    /** 节点匹配（semantic/type 判定——页面级/区域级切后端） */
+    match(node: IRNode): boolean;
+    backend: ProteusRenderBackend;
+}
+export interface HybridRendererOptions {
+    /** 缺省后端（region 未命中 → 兜底） */
+    defaultBackend: ProteusRenderBackend;
+    /** 区域路由表（按序首中即用） */
+    regions?: HybridRegion[];
+    /** 是否记录路由 trace（DevTools 可视化；缺省 true） */
+    devtools?: boolean;
+}
+/** DevTools 路由决策记录（每 createElement 一条） */
+export interface HybridRouteTrace {
+    /** IR 语义（可空——兼容层标签） */
+    semantic?: string;
+    type: string;
+    /** 命中后端 id */
+    backendId: BackendId;
+    /** 命中区域（缺省路由 → 'default'） */
+    region: string;
+}
+/** 混合渲染器（统一 ProteusRenderBackend 面 + 混合专属能力） */
+export interface HybridRenderer extends ProteusRenderBackend {
+    /** 节点 → 归属后端（路由决策——子节点可跨后端） */
+    routeFor(node: IRNode): ProteusRenderBackend;
+    /** 节点句柄 → 归属后端（委托用） */
+    backendOf(handle: NodeHandle): ProteusRenderBackend | undefined;
+    /** DevTools 路由 trace（累积；clearTraces 清空） */
+    traces(): HybridRouteTrace[];
+    clearTraces(): void;
+}
+/**
+ * ★createHybridRenderer：混合渲染器工厂
+ * 用法：const hybrid = createHybridRenderer({ defaultBackend: vueDom, regions: [{ name: 'video', match: (n) => n.semantic === 'ui.media', backend: native }] })
+ * 设计：createElement 路由 → 归属后端；其余 nodeOps 委托归属后端（父子跨后端合法——混合渲染核心）；
+ *      纹理共享：registerExternalTexture 广播到所有 textureSharing 后端（同一 id 全局可引用）
+ */
+export declare function createHybridRenderer(options: HybridRendererOptions): HybridRenderer;
+/** 纹理引用（跨后端 patchProp 用——注册 id → 纹理） */
+export interface HybridTextureRef {
+    textureId: string;
+}
+/** 便捷：构造纹理引用 prop 值（后端 patchProp 可识别） */
+export declare function textureRef(textureId: string): HybridTextureRef;
+/** ★B6 conformance：混合渲染器自检（对齐 runBackendConformance 形状） */
+export interface HybridConformanceResult {
+    ok: boolean;
+    checks: Array<{
+        name: string;
+        pass: boolean;
+        detail?: string;
+    }>;
+}
+export declare function runHybridConformance(renderer: HybridRenderer): HybridConformanceResult;

package/dist/index.d.ts

@@ -0,0 +1,48 @@
+export type { BackendId, BackendCapabilities, IRNode, NodeHandle, LayoutConstraints, Size, NormalizedInputEvent, ExternalTexture, ProteusRenderBackend, } from './spi';
+export { runBackendConformance } from './conformance';
+export type { ConformanceCheck, ConformanceResult } from './conformance';
+export { createHeadlessBackend, toPlainTree } from './headless';
+export type { HeadlessNode } from './headless';
+export { createVueDomBackend } from './vue-dom';
+export { createNativeBackend, createMockNativeAdapter } from './native';
+export type { NativeViewDescriptor, NativeViewAdapter, MockNativeAdapter, NativePlatform } from './native';
+export { createFlutterBackend, mapWidgetType, toWidgetTree } from './flutter';
+export type { FlutterWidgetDescriptor } from './flutter';
+export { renderComponentSnapshot, createControlReader } from './conformance-component';
+export type { RenderNodeSnapshot, ControlReader } from './conformance-component';
+export { createHybridRenderer, textureRef, runHybridConformance } from './hybrid';
+export type { HybridRegion, HybridRendererOptions, HybridRouteTrace, HybridRenderer, HybridTextureRef, HybridConformanceResult } from './hybrid';
+export { createNodeOpsDispatcher, renderIRTree, semanticSequence, DispatcherError } from './dispatcher';
+export type { ProteusNodeOpsDispatcher, DispatcherNodeOps, NodeOpsCall, HotSwitchStrategy } from './dispatcher';
+export { runHostConformance, formatHostConformance, createHostRuntimeStub, createCarrierStub } from './host-conformance';
+export type { HostConformanceResult, HostConformanceSummary, HostConformanceOptions, HostRuntimeLike, CarrierLike } from './host-conformance';
+export { createVueRendererOptions, createProteusRenderer, createProteusRendererForBackend } from './vue-bridge';
+export type { ProteusRenderer } from './vue-bridge';
+export { createWebHostRuntime } from './web-host';
+export type { WebHostRuntime, WebWorkerHandle, WebHostOptions } from './web-host';
+export { createBackendSwitcher } from './hot-switch';
+export type { BackendSwitcher, HotSwitchOptions } from './hot-switch';
+export { CONTAINER_PROFILES, PAGE_STATE_TRANSITIONS, canTransitionPageState, FIVE_ATOMIC_STEPS, assertAtomicDestroy, createDestroyReport, DEFAULT_STACK_POLICY, profileOfContainer, } from './container-spi';
+export type { ContainerCapabilities, PageState, PageHandle, ResourcePool, DestroyReport, DestroyStep, QuotaManager, QuotaHandle, QuotaUsage, PressureLevel, StackPolicy, SuperAppPolicy, BizManifest, BusinessSandbox, ContainerContext, ContainerEvent, ProteusHostContainer, } from './container-spi';
+export { createStackContainer, createResourcePool, createQuotaManager } from './stack-container';
+export type { StackContainer, StackContainerOptions } from './stack-container';
+export { runContainerConformance, formatContainerConformance, scanRepoForFork, checkBizManifest, checkCapabilityAuthorization, FORK_SIGNATURES, SENSITIVE_CAPABILITIES } from './container-conformance';
+export type { ContainerConformanceResult, ContainerConformanceSummary, ForkHit } from './container-conformance';
+export { createSuperAppContainer } from './superapp-container';
+export type { SuperAppContainer, SuperAppOptions, SuperSandbox, SandboxExecutionResult } from './superapp-container';
+export { createSinglePageContainer, createEmbeddedContainer, createWindowContainer, createMiniProgramContainer } from './basic-containers';
+export type { SinglePageContainer, EmbeddedContainer, WindowContainer, WindowContainerOptions, MiniProgramContainer, MiniProgramContainerOptions, MiniProgramTabConfig, MiniProgramSandbox, } from './basic-containers';
+export { OwnershipGraph, Owned, Borrow, Weak, Managed, ManagedRegistry, createQuotaTracker, OWNERSHIP_ERRORS, OwnershipError, getProteusOwnershipGraph } from './ownership';
+export type { OwnedState, GraphNode, GraphEdge, LeakInfo, OwnershipErrorCode } from './ownership';
+export { analyzeOwnershipSource } from './borrow-checker';
+export type { BorrowDiagnostic, BorrowAnalysisResult, BorrowRule, BorrowSeverity, PssMode, BorrowCheckerOptions } from './borrow-checker';
+export { createPageOwnership } from './page-ownership';
+export type { PageOwnership, PageOwnershipOptions, PageAllocOptions, PageOwnershipDestroyReport } from './page-ownership';
+export { createOwnershipHistory, createOwnershipCounters, diagnoseOwnershipIssues, buildOwnershipTimeline, formatOwnershipDiagnosis } from './ownership-observability';
+export type { OwnershipHistory, OwnershipHistoryOptions, OwnershipRecord, OwnershipRecordKind, OwnershipCounters, TypeCounter, OwnershipDiagnosis, OwnershipDiagnosisOptions, LongBorrow, CrossPageRef, OwnershipTimeline, TimelineEvent, } from './ownership-observability';
+export type { OwnershipMutation } from './ownership';
+export { resolvePssMode, analyzePss, insertScopeDrops, runPss } from './pss';
+export type { PssRule, PssDiagnostic, PssAnalysisResult, PssAnalysisOptions, ScopeDropInsertion, ScopeDropResult, PssPipelineOptions, PssPipelineResult } from './pss';
+export type { OwnedStateListener } from './ownership';
+export { HOSTS, ENGINES, HOST_ENGINE_MATRIX, matrixCombos, createEngine, runComboConformance, runHostEngineMatrix, formatMatrixReport } from './host-matrix';
+export type { HostId, EngineId, ComboTier, MatrixCombo, ComboCheck, ComboConformanceResult, ComboConformanceOptions, MatrixRow, MatrixReport, MatrixOptions, } from './host-matrix';