@proteus-vue/compiler-backend 0.1.0

package/dist/node.d.ts

@@ -0,0 +1,3 @@
+import type { ProteusCompilerBackend } from './spi';
+/** NodeBackend：官方 Node 编译器后端（参考实现——conformance 基线） */
+export declare function createNodeCompilerBackend(): ProteusCompilerBackend;

package/dist/node.js

@@ -0,0 +1,152 @@
+// src/node.ts
+import { parse as sfcParse } from "@vue/compiler-sfc";
+import { parse as domParse, NodeTypes } from "@vue/compiler-dom";
+import { toComponentIR, TAG_SEMANTIC_MAP } from "@proteus-vue/component-ir";
+var NODE_CAPABILITIES = {
+  incremental: true,
+  // 官方 Node 后端支持增量（G-34 HMR 已有编译侧增量）
+  sourceMap: false,
+  // B4
+  treeShaking: false,
+  // B4
+  wasmRuntime: false,
+  plugins: true,
+  // 与 @proteus-vue/compiler 规则注册表同源
+  maxFileSize: 5 * 1024 * 1024
+};
+function camelize(s) {
+  return s.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+}
+function flattenChildNodes(children) {
+  const out = [];
+  for (const c of children) {
+    if (c.type === NodeTypes.IF) {
+      const branches = c.branches ?? [];
+      for (const b of branches) out.push(...flattenChildNodes(b.children));
+    } else if (c.type === NodeTypes.FOR) {
+      out.push(...flattenChildNodes(c.children));
+    } else {
+      out.push(c);
+    }
+  }
+  return out;
+}
+function exprContent(exp) {
+  if (exp && typeof exp === "object" && "content" in exp && typeof exp.content === "string") {
+    return exp.content;
+  }
+  return null;
+}
+function elementToRenderNode(el, acc) {
+  const props = {};
+  for (const attr of el.props) {
+    if (attr.type === NodeTypes.ATTRIBUTE) {
+      const a = attr;
+      if (a.name === "class" || a.name === "style" || a.name === "id" || a.name === "key" || a.name === "ref") continue;
+      props[a.name] = a.value?.content ?? true;
+      continue;
+    }
+    const d = attr;
+    const arg = d.arg && "content" in d.arg ? d.arg.content : void 0;
+    const exp = exprContent(d.exp);
+    if (d.name === "bind") {
+      const key = camelize(arg ?? "");
+      props[key] = exp !== null ? { expr: exp } : true;
+    } else if (d.name === "on") {
+      acc.handlers.push({ name: arg ?? "tap", target: exp ?? "" });
+    } else if (d.name === "model") {
+      acc.models.push({ name: arg ?? "modelValue", expr: exp ?? "" });
+    } else {
+      props[`v-${d.name}`] = exp !== null ? exp : true;
+    }
+  }
+  return {
+    type: el.tag,
+    // ★G-31 语义链接：p-* 标签 → TAG_SEMANTIC_MAP 语义（渲染树 semantic 与 C-IR 树同源）；非 p- → undefined（Layer 1 兼容层）
+    semantic: el.tag.startsWith("p-") ? TAG_SEMANTIC_MAP[el.tag] : void 0,
+    props,
+    children: flattenChildNodes(el.children).filter((c) => c.type === NodeTypes.ELEMENT).map((c) => elementToRenderNode(c, acc)),
+    loc: { line: el.loc.start.line, column: el.loc.start.column }
+  };
+}
+function pickConstraintProps(props) {
+  const out = {};
+  for (const k of Object.keys(props)) {
+    if (k.startsWith("v-")) continue;
+    out[k] = props[k];
+  }
+  return out;
+}
+function renderToComponentIR(node) {
+  if (!node.type.startsWith("p-")) return null;
+  const children = node.children.map(renderToComponentIR).filter(Boolean);
+  return toComponentIR(node.type, pickConstraintProps(node.props), children);
+}
+function buildIR(template) {
+  const root = domParse(template, { onError: () => void 0 });
+  const rootEl = flattenChildNodes(root.children).find((c) => c.type === NodeTypes.ELEMENT);
+  if (!rootEl) {
+    return {
+      render: { type: "template", props: {}, children: [], loc: { line: 1, column: 1 } },
+      semantic: { tree: null, semanticCount: 0, compatCount: 0 },
+      bindings: { capabilities: [], models: [], handlers: [] }
+    };
+  }
+  const acc = { capabilities: [], models: [], handlers: [] };
+  const render = elementToRenderNode(rootEl, acc);
+  const tree = renderToComponentIR(render);
+  const semanticCount = tree ? countCIR(tree) : 0;
+  const compatCount = countCompat(render);
+  if (tree) {
+    collectCapabilities(tree, acc);
+  }
+  return { render, semantic: { tree, semanticCount, compatCount }, bindings: acc };
+}
+function countCIR(node) {
+  return 1 + node.children.reduce((acc, c) => acc + countCIR(c), 0);
+}
+function countCompat(node) {
+  let n = 0;
+  if (node.type !== "#text" && node.type !== "#interpolation" && node.type !== "#comment" && !node.semantic) n++;
+  for (const c of node.children) n += countCompat(c);
+  return n;
+}
+function collectCapabilities(node, acc) {
+  if (node.semantic.startsWith("capability.")) {
+    acc.capabilities.push({ name: node.semantic.slice("capability.".length), semantic: node.semantic });
+  }
+  for (const c of node.children) collectCapabilities(c, acc);
+}
+function renderToTemplateNode(node) {
+  return {
+    type: node.type === "#text" ? "text" : node.type === "#interpolation" ? "interpolation" : node.type === "#comment" ? "comment" : "element",
+    tag: node.type,
+    props: { ...node.props },
+    children: node.children.map(renderToTemplateNode),
+    line: node.loc.line
+  };
+}
+function createNodeCompilerBackend() {
+  return {
+    id: "node",
+    version: "0.1.0",
+    minCompatVersion: 1,
+    capabilities: NODE_CAPABILITIES,
+    compile(sfc) {
+      const { descriptor } = sfcParse(sfc.source, { filename: sfc.filename ?? "anonymous.vue" });
+      const template = descriptor.template?.content ?? "";
+      const { render, semantic, bindings } = buildIR(template);
+      return { version: 1, render: { root: render }, semantic, bindings };
+    },
+    parse(template) {
+      const ir = buildIR(template);
+      return { root: renderToTemplateNode(ir.render) };
+    },
+    generate(ir) {
+      return { code: JSON.stringify(ir, null, 2), warnings: [] };
+    }
+  };
+}
+export {
+  createNodeCompilerBackend
+};

package/dist/spi.d.ts

@@ -0,0 +1,112 @@
+import type { ComponentIR } from '@proteus-vue/component-ir';
+export interface SFCSource {
+    filename?: string;
+    source: string;
+}
+export interface SourceLoc {
+    line: number;
+    column: number;
+}
+export type TemplateNodeType = 'element' | 'text' | 'interpolation' | 'comment';
+export interface TemplateNode {
+    type: TemplateNodeType;
+    /** element 时的标签名（p-grid/view/...） */
+    tag: string;
+    /** element 时的规范化属性（静态属性 camelCase→字符串；动态绑定 → { expr }） */
+    props: Record<string, unknown>;
+    children: TemplateNode[];
+    line: number;
+}
+export interface TemplateAST {
+    root: TemplateNode;
+}
+/** 渲染 IR 节点（G-27 nodeOps 消费：有 semantic 走语义映射；无 semantic 属 Layer 1 兼容层按 type 原样） */
+export interface RenderNode {
+    type: string;
+    semantic?: string;
+    props: Record<string, unknown>;
+    children: RenderNode[];
+    loc: SourceLoc;
+}
+export interface RenderIR {
+    root: RenderNode;
+}
+/** 语义 IR（G-31 C-IR 树——真实模板编译 → toComponentIR；非 p- 标签不产生 Layer 0 C-IR） */
+export interface SemanticIR {
+    tree: ComponentIR | null;
+    /** C-IR 树节点数（= 渲染树中带 semantic 的元素数——conformance 交叉核对） */
+    semanticCount: number;
+    /** 兼容层元素数（渲染树中无 semantic 的元素——view/text/scroll-view 等） */
+    compatCount: number;
+}
+/** 布局约束（G-22——B1 占位，v1 可选） */
+export interface LayoutConstraintIR {
+}
+export interface BindingIR {
+    /** 能力入口（p-scan-qr 等 capability.* 语义组件——G-28 消费） */
+    capabilities: Array<{
+        name: string;
+        semantic: string;
+    }>;
+    /** v-model 绑定（name → 表达式） */
+    models: Array<{
+        name: string;
+        expr: string;
+    }>;
+    /** 事件处理器（@click → target 方法名） */
+    handlers: Array<{
+        name: string;
+        target: string;
+    }>;
+}
+export interface CompilerIR {
+    /** IR 契约版本（版本协商：backend.minCompatVersion ≤ 1） */
+    version: 1;
+    render: RenderIR;
+    semantic: SemanticIR;
+    bindings: BindingIR;
+    layout?: LayoutConstraintIR;
+}
+export interface CompilerCapabilities {
+    /** HMR 增量编译 */
+    incremental: boolean;
+    sourceMap: boolean;
+    treeShaking: boolean;
+    /** 能否在浏览器跑（WASM） */
+    wasmRuntime: boolean;
+    /** 是否支持 G-21 Plugin */
+    plugins: boolean;
+    maxFileSize: number;
+}
+export interface FileChange {
+    file: string;
+    type: 'create' | 'update' | 'delete';
+}
+export interface UpdatePayload {
+    file: string;
+    action: 'update' | 'reload';
+    code?: string;
+}
+export interface SourceMap {
+    version: 3;
+    sources: string[];
+    mappings: string;
+}
+export interface ProteusCompilerBackend {
+    readonly id: string;
+    readonly version: string;
+    /** 产出 IR 的最低兼容版本（当前契约 = 1；不匹配 → CMP004 版本不兼容） */
+    readonly minCompatVersion: number;
+    readonly capabilities: CompilerCapabilities;
+    /** SFC 源码 → CompilerIR（B1 核心：真实模板编译 → 语义 IR） */
+    compile(sfc: SFCSource): CompilerIR;
+    /** 模板字符串 → 结构化元素树（中间产物，后端无关） */
+    parse(template: string): TemplateAST;
+    /** IR → 代码生成（B1 最小实现：序列化；产物代码生成后续批次） */
+    generate(ir: CompilerIR): {
+        code: string;
+        warnings: string[];
+    };
+    hotUpdate?(changes: FileChange[]): UpdatePayload;
+    generateSourceMap?(): SourceMap;
+}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@proteus-vue/compiler-backend",
+  "version": "0.1.0",
+  "description": "G-29 编译器可插拔后端：CompilerIR 契约 + conformance（CMP002/CMP004 + G-31.1 语义链接）+ NodeBackend 参考实现（真实模板编译 → C-IR 语义树）——编译、逻辑、UI、能力四维可插拔（原则 #10 终极形态）",
+  "type": "module",
+  "license": "Apache-2.0",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json",
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.js",
+      "default": "./dist/node.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json --emitDeclarationOnly && esbuild src/index.ts --bundle --format=esm --platform=node --outfile=dist/index.js --external:@vue/compiler-sfc --external:@vue/compiler-dom --external:@proteus-vue/component-ir && esbuild src/node.ts --bundle --format=esm --platform=neutral --outfile=dist/node.js --external:@vue/compiler-sfc --external:@vue/compiler-dom --external:@proteus-vue/component-ir"
+  },
+  "dependencies": {
+    "@proteus-vue/component-ir": "0.1.0"
+  },
+  "peerDependencies": {
+    "@vue/compiler-dom": "^3.4",
+    "@vue/compiler-sfc": "^3.4"
+  },
+  "devDependencies": {
+    "@vue/compiler-dom": "^3.5.42",
+    "@vue/compiler-sfc": "^3.5.42",
+    "@proteus-vue/types": "workspace:*"
+  }
+}