@proteus-vue/render-backend 0.3.0-beta.10 → 0.3.0-beta.21

package/dist/index.js

@@ -80,6 +80,7 @@ var SEMANTIC_HEADLESS_MAP = {
   "layout.split": "split",
   "layout.safe": "safe",
   "layout.sidebar": "sidebar",
+  "layout.formfactor": "formfactor",
   "ui.text": "text",
   "ui.button": "button",
   "ui.image": "image",
@@ -175,6 +176,18 @@ function createHeadlessBackend() {
       nodes.set(n.id, n);
       return n;
     },
+    // ★2026-09-26 文本保留：'#text' → 文本节点（内存树）
+    createText(text) {
+      const n = {
+        id: nextId++,
+        type: "#text",
+        props: {},
+        children: [],
+        parent: null,
+        text
+      };
+      return n;
+    },
     insert(child, parent, anchor) {
       const c = ensureNode(child);
       const p = ensureNode(parent);
@@ -247,6 +260,8 @@ var SEMANTIC_WEB_MAP = {
   "layout.split": { tag: "div", className: "proteus-split" },
   "layout.safe": { tag: "div", className: "proteus-safe" },
   "layout.sidebar": { tag: "div", className: "proteus-sidebar" },
+  // ★★Fluid System v2：柔性形态容器
+  "layout.formfactor": { tag: "div", className: "proteus-formfactor" },
   "ui.text": { tag: "span" },
   "ui.button": { tag: "button" },
   "ui.image": { tag: "img" },
@@ -313,7 +328,9 @@ function createVueDomBackend(doc) {
   const documentLike = doc ?? defaultDocument();
   function ensureEl(handle) {
     const el = handle;
-    if (!el || typeof el.tagName !== "string") throw new Error("VueDomBackend: \u975E\u6CD5\u53E5\u67C4");
+    if (!el || typeof el.tagName !== "string" && el.nodeType !== 3) {
+      throw new Error("VueDomBackend: \u975E\u6CD5\u53E5\u67C4");
+    }
     return el;
   }
   return {
@@ -331,6 +348,10 @@ function createVueDomBackend(doc) {
       }
       return documentLike.createElement(node.type);
     },
+    // ★2026-09-26 文本保留：IR '#text' 节点 → 真实文本节点（此前 createText 无实现——IR 无文本节点）
+    createText(text) {
+      return documentLike.createTextNode(text);
+    },
     insert(child, parent, anchor) {
       const c = ensureEl(child);
       const p = ensureEl(parent);
@@ -432,6 +453,7 @@ var SEMANTIC_NATIVE_MAPS = {
     "layout.split": "UISplitViewController",
     "layout.safe": "safeAreaLayoutGuide",
     "layout.sidebar": "UISplitViewController.side",
+    "layout.formfactor": "UIViewController.formFactor",
     "ui.text": "UILabel",
     "ui.button": "UIButton",
     "ui.image": "UIImageView",
@@ -501,6 +523,7 @@ var SEMANTIC_NATIVE_MAPS = {
     "layout.split": "SlidingPaneLayout",
     "layout.safe": "WindowInsets",
     "layout.sidebar": "NavigationRail",
+    "layout.formfactor": "FormFactorLayout",
     "ui.text": "TextView",
     "ui.button": "Button",
     "ui.image": "ImageView",
@@ -570,6 +593,7 @@ var SEMANTIC_NATIVE_MAPS = {
     "layout.split": "SideBarContainer",
     "layout.safe": "getAvoidArea",
     "layout.sidebar": "SideBarContainer",
+    "layout.formfactor": "GridRow.formFactor",
     "ui.text": "Text",
     "ui.button": "Button",
     "ui.image": "Image",
@@ -660,6 +684,21 @@ function createNativeBackend(adapter, platform = "ios") {
       nodes.set(descriptor.id, descriptor);
       return descriptor;
     },
+    // ★2026-09-26 文本保留：'#text' → 文本描述符（type 'text'，text 字段承载内容——
+    //   readback/控件树即见真实文案；真机渲染通道接线时映射 Text/Label 内容）
+    createText(text) {
+      const descriptor = {
+        id: nextId++,
+        type: "text",
+        props: {},
+        children: [],
+        parent: null,
+        text,
+        handle: null
+      };
+      descriptor.handle = descriptor;
+      return descriptor;
+    },
     insert(child, parent, anchor) {
       const c = ensureNode(child);
       const p = ensureNode(parent);
@@ -735,6 +774,7 @@ var SEMANTIC_FLUTTER_MAP = {
   "layout.split": "Row",
   "layout.safe": "SafeArea",
   "layout.sidebar": "NavigationRail",
+  "layout.formfactor": "LayoutBuilder.formFactor",
   "ui.text": "Text",
   "ui.button": "FilledButton",
   "ui.image": "Image",
@@ -846,6 +886,18 @@ function createFlutterBackend() {
       nodes.set(descriptor.id, descriptor);
       return descriptor;
     },
+    // ★2026-09-26 文本保留：'#text' → Text widget 描述符
+    createText(text) {
+      const descriptor = {
+        id: nextId++,
+        widget: "Text",
+        props: {},
+        children: [],
+        parent: null,
+        text
+      };
+      return descriptor;
+    },
     insert(child, parent, anchor) {
       const c = ensureNode(child);
       const p = ensureNode(parent);
@@ -990,6 +1042,10 @@ function createHybridRenderer(options) {
       }
       return handle;
     },
+    // ★2026-09-26 文本保留：'#text' → 委托默认后端（文本无 semantic 不可路由——区域语义由父元素决定）
+    createText(text) {
+      return defaultBackend.createText(text);
+    },
     insert(child, parent, anchor) {
       const b = backendOf(child);
       if (!b) return;
@@ -1168,6 +1224,8 @@ var TAG_SEMANTIC_MAP = {
   //    ——同一语义由两个标签提供；本条与 p-view 是并列的别名情形，非「先例」关系）
   "p-aspect": "layout.aspect",
   "p-zone": "layout.zone",
+  "p-formfactor": "layout.formfactor",
+  // ★★Fluid System v2：柔性形态容器
   "p-loading": "ui.loading",
   "p-scale": "ui.scale",
   "p-skeleton": "ui.skeleton",
@@ -1219,6 +1277,8 @@ var LAYOUT = [
   // ★#405 语义登记批：Fluid 体系剩余组件（语义层待多端映射 → planned L2——G-31.4 不足 3 端降级）
   { id: "L13", kind: "layout", semantic: "layout.aspect", tag: "p-aspect", props: ["ratio", "maxWidth"], mpEquiv: "\u65E0\uFF08\u7EB5\u6A2A\u6BD4\u5BB9\u5668\uFF09", tier: "L2", status: "planned" },
   { id: "L14", kind: "layout", semantic: "layout.zone", tag: "p-zone", props: ["designWidth"], mpEquiv: "\u65E0\uFF08\u5BB9\u5668\u65AD\u70B9\u5206\u533A\uFF09", tier: "L2", status: "planned" },
+  // ★★Fluid System v2（2026-09-26）：柔性形态容器——按设备形态自动编排布局拓扑/能力/密度/缩放
+  { id: "L26", kind: "layout", semantic: "layout.formfactor", tag: "p-formfactor", props: ["declared", "width", "height"], mpEquiv: "\u65E0\uFF08\u5F62\u6001\u7F16\u6392\u5BB9\u5668\uFF1Aglance/stack/duo/rail-split/rail-grid/dashboard/hero-focus-row\uFF09", tier: "L2", status: "implemented" },
   // ★批次 7（2026-09-18）未登记组件补登记：安全区（刘海/折叠屏/降级）+ 侧边导航容器
   { id: "L15", kind: "layout", semantic: "layout.safe", tag: "p-safe", props: ["area", "fold", "fallback"], mpEquiv: "\u65E0\uFF08\u5B89\u5168\u533A\u8BED\u4E49\u5BB9\u5668\uFF09", tier: "L1", status: "implemented" },
   { id: "L16", kind: "layout", semantic: "layout.sidebar", tag: "p-sidebar", props: ["minSidebarWidth", "navWidth", "designWidth", "toggleLabel"], mpEquiv: "\u65E0\uFF08\u5BB9\u5668\u65AD\u70B9\u4FA7\u680F\uFF09", tier: "L1", status: "implemented" }
@@ -1782,6 +1842,7 @@ function createNodeOpsDispatcher(initialBackend) {
   };
 }
 function renderIRTree(backend, ir, insertInto) {
+  if (ir.type === "#text") return backend.createText(ir.text ?? "");
   const root = backend.createElement(ir);
   for (const child of ir.children) {
     const c = renderIRTree(backend, child);
@@ -3521,7 +3582,7 @@ function createSinglePageContainer(opts = {}) {
   const emit = (event, payload) => {
     for (const fn of events[event] ?? []) fn(payload);
   };
-  function createSlot(config) {
+  function createSlot2(config) {
     const ownership = opts.ownership ? createPageOwnership(config.pageId ?? `page-${++seq}`, { graph: opts.ownership.graph, quotaBytes: opts.ownership.quotaBytes }) : null;
     const page = makeSlotPage(seq, config, ownership);
     if (!config.pageId) seq++;
@@ -3530,7 +3591,7 @@ function createSinglePageContainer(opts = {}) {
     return page;
   }
   function createPage(config) {
-    return createSlot(config);
+    return createSlot2(config);
   }
   async function destroyPage(handle) {
     const page = pages.get(handle.pageId);
@@ -3568,7 +3629,7 @@ function createSinglePageContainer(opts = {}) {
     destroyPage,
     async push(config) {
       for (const p of [...pages.values()]) await destroyPage(p);
-      const page = createSlot(config);
+      const page = createSlot2(config);
       await mountPage(page);
       current = page;
       return page;

package/dist/spi.d.ts

@@ -10,6 +10,8 @@ export interface IRNode {
     props: Record<string, unknown>;
     children: IRNode[];
     ref?: unknown;
+    /** ★2026-09-26 文本保留：type='#text' 节点的字面内容（additive——既有消费者零影响） */
+    text?: string;
 }
 /** 布局约束（后端可自带布局器，否则走框架 IR 求解） */
 export interface LayoutConstraints {
@@ -57,6 +59,8 @@ export interface ProteusRenderBackend {
     readonly version: string;
     readonly capabilities: BackendCapabilities;
     createElement(node: IRNode): NodeHandle;
+    /** ★2026-09-26 文本保留：'#text' 节点 → 文本句柄（此前 IR 无文本节点，SPI 未列——现必选） */
+    createText(text: string): NodeHandle;
     insert(child: NodeHandle, parent: NodeHandle, anchor?: NodeHandle): void;
     remove(child: NodeHandle): void;
     patchProp(el: NodeHandle, key: string, prev: unknown, next: unknown): void;

package/dist/vue-dom.d.ts

@@ -1,6 +1,7 @@
 import type { ProteusRenderBackend } from './spi';
 interface DocumentLike {
     createElement(tag: string): HTMLElement;
+    createTextNode(text: string): Text;
 }
 export declare function createVueDomBackend(doc?: DocumentLike): ProteusRenderBackend;
 export {};

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@proteus-vue/render-backend",
-  "version": "0.3.0-beta.10",
+  "version": "0.3.0-beta.21",
   "description": "G-27 ProteusRenderBackend SPI：可插拔渲染后端接口 + conformance test + 官方后端原型（Headless/VueDom） + G-41 nodeOps Dispatcher——Render anywhere, on any engine（M1.4）",
   "type": "module",
   "license": "Apache-2.0",
   "dependencies": {
-    "@proteus-vue/component-ir": "0.3.0-beta.10",
-    "@proteus-vue/contracts": "0.3.0-beta.10"
+    "@proteus-vue/component-ir": "0.3.0-beta.21",
+    "@proteus-vue/contracts": "0.3.0-beta.11"
   },
   "peerDependencies": {
     "@vue/runtime-core": "^3.4.0"