@proteus-vue/component-ir 0.1.0

package/dist/map.d.ts

@@ -0,0 +1,11 @@
+import type { BackendId } from '@proteus-vue/render-backend';
+/** 语义类型 → 各端 Backend 控件（布局原语 + UI 原语 + 能力入口——G-31 §3 组件清单）
+ *  ★G-31 B5：vue-dom 列与 render-backend SEMANTIC_WEB_MAP 实际产出一致（div.proteus-* 语义类）——
+ *    参考表即门禁标准，component-conformance 机器校验「快照 control == 参考表」 */
+export declare const SEMANTIC_BACKEND_MAP: Record<string, Partial<Record<BackendId | 'web', string>>>;
+/**
+ * 语义 → 指定后端控件（未映射 → null，由后端自定义）
+ * ★关键：Backend 映射的是 semantic 字段（layout.grid），不是 tag 字符串（p-grid）——
+ *   同一 semantic 在不同后端得到不同原生控件，这就是「语义收敛 + 后端实现」
+ */
+export declare function mapSemanticToBackend(semantic: string, backendId: string): string | null;

package/dist/primitives.d.ts

@@ -0,0 +1,35 @@
+export type PrimitiveKind = 'layout' | 'ui' | 'shell' | 'gesture' | 'capability' | 'engineering';
+/** 状态：implemented = 已在 SEMANTIC_BACKEND_MAP 登记 ≥3 端（G-31.4/G-32.3 门禁适用）；planned = 已冻结待实现（L2 生态） */
+export type PrimitiveStatus = 'implemented' | 'planned';
+export interface PrimitiveDef {
+    /** 清单编号（L1..L12 / U1..U18 / S1..S10 / G1..G10 / C1..C50 / E1..E28） */
+    id: string;
+    kind: PrimitiveKind;
+    /** 语义标识（<domain>.<kind>——C-IR semantic / 能力属性） */
+    semantic: string;
+    /** 组件原语标签（p-*；非组件原语缺省） */
+    tag?: string;
+    /** API/Hook/指令形态（useXxx() / router.push / v-gesture:tap；组件原语缺省） */
+    api?: string;
+    /** 关键约束属性（G-32.5：属性是约束描述，非 CSS/平台名） */
+    props?: string[];
+    /** 小程序能力对等（完整性标尺） */
+    mpEquiv: string;
+    /** L1/L2 层级 */
+    tier: 'L1' | 'L2';
+    status: PrimitiveStatus;
+}
+/** ★G-32 B1：128 原语冻结清单（唯一事实源） */
+export declare const PRIMITIVE_CATALOG: PrimitiveDef[];
+/** 组件原语（p-* 标签 → C-IR 语义的来源） */
+export declare function componentPrimitives(kinds?: PrimitiveKind[]): PrimitiveDef[];
+/** 已实现状态原语（语义必须在 SEMANTIC_BACKEND_MAP ≥3 端——G-31.4/G-32.3 门禁适用） */
+export declare function implementedPrimitives(): PrimitiveDef[];
+/** 按 id 查原语 */
+export declare function primitiveById(id: string): PrimitiveDef | undefined;
+/** 按语义查原语 */
+export declare function primitiveBySemantic(semantic: string): PrimitiveDef | undefined;
+/** 按 p-* 标签查原语 */
+export declare function primitiveByTag(tag: string): PrimitiveDef | undefined;
+/** 清单自检：128 项 / id 唯一 / semantic 唯一 / 编号连续 */
+export declare function checkPrimitiveCatalog(): string[];

package/dist/schema.d.ts

@@ -0,0 +1,62 @@
+export interface ComponentIR {
+    /** 组件标签名（如 p-grid）——仅用于源码定位，不参与后端映射 */
+    tag: string;
+    /** 语义类型（后端映射依据），格式：<domain>.<kind> */
+    semantic: string;
+    /** 已校验的约束属性（不是平台样式指令） */
+    props: Record<string, unknown>;
+    children: ComponentIR[];
+    /** 引用的原生能力（G-28） */
+    capabilities?: Array<{
+        name: string;
+        [key: string]: unknown;
+    }>;
+    /** 属性降级声明（G-31.2 / CMP006）：每个能力属性须声明 supported/fallback/unsupported */
+    degradation?: Record<string, 'supported' | 'fallback' | 'unsupported'>;
+}
+/** 语义枚举（与 plan component-ir.schema.json 一致）——<domain>.<kind> */
+export declare const SEMANTIC_ENUM: readonly ["layout.box", "layout.inline", "layout.stack", "layout.grid", "layout.fluid", "layout.adaptive", "layout.fit", "layout.spacer", "layout.divider", "layout.scroll", "layout.virtual-list", "layout.masonry", "layout.split", "layout.safe", "layout.sidebar", "ui.text", "ui.heading", "ui.rich-text", "ui.icon", "ui.image", "ui.avatar", "ui.media", "ui.canvas", "ui.svg", "ui.input", "ui.textarea", "ui.select", "ui.checkbox", "ui.radio", "ui.switch", "ui.slider", "ui.picker", "ui.form", "ui.button", "ui.list", "ui.nav", "shell.page", "shell.nav", "shell.tabbar", "shell.segment", "shell.drawer", "shell.modal", "shell.popover", "shell.toast", "shell.action-sheet", "gesture.draggable", "gesture.scrollable", "engineering.router-link", "engineering.transition", "engineering.animate", "capability.scan-qr", "capability.pick-photo", "capability.location"];
+/** C-IR JSON Schema（等价于 plan component-ir.schema.json——TS 内嵌供校验/工具消费） */
+export declare const COMPONENT_IR_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://proteus.dev/schemas/component-ir.json";
+    readonly title: "Proteus Component IR (C-IR)";
+    readonly type: "object";
+    readonly required: readonly ["tag", "semantic", "props", "children"];
+    readonly properties: {
+        readonly tag: {
+            readonly type: "string";
+            readonly pattern: "^p-[a-z0-9-]+$";
+        };
+        readonly semantic: {
+            readonly type: "string";
+            readonly enum: readonly ["layout.box", "layout.inline", "layout.stack", "layout.grid", "layout.fluid", "layout.adaptive", "layout.fit", "layout.spacer", "layout.divider", "layout.scroll", "layout.virtual-list", "layout.masonry", "layout.split", "layout.safe", "layout.sidebar", "ui.text", "ui.heading", "ui.rich-text", "ui.icon", "ui.image", "ui.avatar", "ui.media", "ui.canvas", "ui.svg", "ui.input", "ui.textarea", "ui.select", "ui.checkbox", "ui.radio", "ui.switch", "ui.slider", "ui.picker", "ui.form", "ui.button", "ui.list", "ui.nav", "shell.page", "shell.nav", "shell.tabbar", "shell.segment", "shell.drawer", "shell.modal", "shell.popover", "shell.toast", "shell.action-sheet", "gesture.draggable", "gesture.scrollable", "engineering.router-link", "engineering.transition", "engineering.animate", "capability.scan-qr", "capability.pick-photo", "capability.location"];
+        };
+        readonly props: {
+            readonly type: "object";
+            readonly additionalProperties: true;
+        };
+        readonly children: {
+            readonly type: "array";
+            readonly items: {
+                readonly $ref: "#";
+            };
+            readonly default: readonly [];
+        };
+        readonly capabilities: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly required: readonly ["name"];
+            };
+        };
+        readonly degradation: {
+            readonly type: "object";
+            readonly additionalProperties: {
+                readonly enum: readonly ["supported", "fallback", "unsupported"];
+            };
+        };
+    };
+};
+/** C-IR 组件标签 → 语义类型（组件清单映射——G-32 ①-③ 组件原语 + G-31 L1 布局/UI 原语 + ★B4 现有组件对齐） */
+export declare const TAG_SEMANTIC_MAP: Record<string, string>;

package/dist/to-ir.d.ts

@@ -0,0 +1,13 @@
+import type { ComponentIR } from './schema';
+/**
+ * 单标签 → C-IR（未映射标签 → null——兼容层标签不产生 Layer 0 C-IR）
+ * - p-* 语义组件：TAG_SEMANTIC_MAP 提供 semantic
+ * - 未知 p-* 标签：semantic 缺省 'layout.box'（原子容器兜底）？——不，返回 null（未知语义不臆造）
+ */
+export declare function toComponentIR(tag: string, props?: Record<string, unknown>, children?: ComponentIR[]): ComponentIR | null;
+/** 递归转换（子节点非 p- 标签丢弃——兼容层标签在 Layer 0 树中不产生 C-IR 节点） */
+export declare function toComponentTree(tag: string, props?: Record<string, unknown>, children?: Array<{
+    tag: string;
+    props: Record<string, unknown>;
+    children?: unknown[];
+}>): ComponentIR | null;

package/dist/validate.d.ts

@@ -0,0 +1,21 @@
+export interface CIRDiagnostic {
+    code: string;
+    message: string;
+    path?: string;
+}
+/** 默认设计稿宽度（grid 冲突校验基准） */
+export declare const DEFAULT_DESIGN_WIDTH = 375;
+/**
+ * 校验单个 C-IR 节点（含 children 递归）：
+ * - CIR_INVALID_TAG：tag 非 p- 前缀（G-31.1 语义命名铁律）
+ * - CIR_INVALID_SEMANTIC：semantic 非枚举
+ * - CMP006：capabilities 属性缺 degradation 声明（G-31.2）
+ */
+export declare function validateComponentIR(ir: unknown): CIRDiagnostic[];
+/**
+ * ★grid 属性约束冲突（plan 单测 grid-conflict.spec.ts）：min-col-width × max-cols > 设计宽
+ * → max-cols 永不达（永远单列）——编译期 warning（验证先于运行，支柱 ③）
+ */
+export declare function validateGridConstraints(props: Record<string, unknown>, designWidth?: number): CIRDiagnostic[];
+/** 校验整棵组件树（根 + grid 约束，children 递归） */
+export declare function validateComponentTree(ir: unknown, designWidth?: number): CIRDiagnostic[];

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@proteus-vue/component-ir",
+  "version": "0.1.0",
+  "description": "G-31 组件与 API 语义化（component-semantics-plan B1）：Component IR（C-IR）schema + 属性约束校验 + semantic 映射——组件=语义、属性=约束、Backend 消费 semantic 而非 tag（零依赖纯逻辑）",
+  "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"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json --emitDeclarationOnly && esbuild src/index.ts --bundle --format=esm --platform=neutral --outfile=dist/index.js"
+  },
+  "devDependencies": {
+    "@proteus-vue/render-backend": "0.1.0"
+  }
+}