@proteus-vue/component-ir 0.1.0 → 0.1.1-beta.0

package/dist/map.d.ts

@@ -1,4 +1,4 @@
-import type { BackendId } from '@proteus-vue/render-backend';
+import type { BackendId } from '@proteus-vue/contracts';
 /** 语义类型 → 各端 Backend 控件（布局原语 + UI 原语 + 能力入口——G-31 §3 组件清单）
  *  ★G-31 B5：vue-dom 列与 render-backend SEMANTIC_WEB_MAP 实际产出一致（div.proteus-* 语义类）——
  *    参考表即门禁标准，component-conformance 机器校验「快照 control == 参考表」 */

package/dist/mp-spec-coverage.d.ts

@@ -0,0 +1,69 @@
+export type MpSpecStatus = 'covered' | 'planned' | 'private' | 'na' | 'gap';
+export interface MpSpecClass {
+    status: MpSpecStatus;
+    /** covered/planned 时的 Proteus 承接（Hook/语义/组件） */
+    proteus?: string;
+}
+/** spec 快照（与 docs/generated/miniprogram-official-spec.json 同构） */
+export interface MpOfficialSpec {
+    components: string[];
+    apis: string[];
+}
+export declare const SPEC_COVERED: Record<string, string>;
+export declare const SPEC_PRIVATE: ReadonlySet<string>;
+export declare const SPEC_NA: ReadonlySet<string>;
+export declare const SPEC_PLANNED: Record<string, string>;
+/** 单条分类（规则序：显式 covered → private → na → planned → 事件基名 → gap） */
+export declare function classifySpecApi(name: string): MpSpecClass;
+/** 组件分类：由 MP_MAPPING_MATRIX 的显式登记驱动（tag 命中即 covered/private/...） */
+export declare function classifySpecComponent(tag: string, matrix: ReadonlyArray<{
+    mp: string;
+    status: string;
+    planned?: boolean;
+}>): MpSpecClass;
+/** 组件级显式分类（名不对齐/语义消灭/Skyline 专属——矩阵未逐条登记时的权威声明） */
+export declare const SPEC_COMPONENT_OVERRIDE: Record<string, MpSpecClass>;
+export interface SpecCoverageReport {
+    total: number;
+    covered: number;
+    planned: number;
+    private: number;
+    na: number;
+    gap: number;
+    /** 已归类项（total − gap）——分类完整性分母（防「漏登记」）。 */
+    accounted: number;
+    /** 分类完整率 = accounted/total（恒 100 表示「全部官方项都进了某个箱子」——不是「全实现」！） */
+    classifiedPercent: number;
+    /** ★可落地项 = covered + planned（排除 private/na——非目标或废弃） */
+    actionable: number;
+    /** ★真·落地率 = covered / actionable（诚实指标——「可用比例」，非「已归类比例」） */
+    landedPercent: number;
+    gaps: Array<{
+        kind: 'component' | 'api';
+        name: string;
+    }>;
+    /** 规划待落地清单（planned——可见待办） */
+    plannedItems: Array<{
+        kind: 'component' | 'api';
+        name: string;
+        proteus?: string;
+    }>;
+}
+/**
+ * ★spec 覆盖度审计：官方清单逐项分类 → 报告（gap 列出全部缺口名）。
+ * @param spec 官方清单快照
+ * @param matrix 组件显式登记（MP_MAPPING_MATRIX）
+ */
+export declare function auditSpecCoverage(spec: MpOfficialSpec, matrix: ReadonlyArray<{
+    mp: string;
+    status: string;
+    planned?: boolean;
+}>): SpecCoverageReport;
+/**
+ * ★棘轮预算：covered 的硬下限 + gap 硬上限——只能向好的方向变。
+ *   covered 下降 或 gap 上升 → CI 红（防「悄悄丢覆盖」）；改善后应手动调高 covered 锁定成果。
+ */
+export declare const SPEC_RATCHET: {
+    coveredMin: number;
+    gapMax: number;
+};

package/dist/primitives.d.ts

@@ -31,5 +31,5 @@ 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 唯一 / 编号连续 */
+/** 清单自检：长度/id 唯一/semantic 唯一/tag 唯一（长度按 SSOT 常量动态——新增项同步本行注释） */
 export declare function checkPrimitiveCatalog(): string[];

package/dist/schema.d.ts

@@ -15,7 +15,7 @@ export interface ComponentIR {
     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"];
+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", "layout.aspect", "layout.zone", "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", "ui.loading", "ui.scale", "ui.skeleton", "ui.progress", "ui.label", "ui.selection", "ui.camera", "shell.page", "shell.nav", "shell.tabbar", "shell.segment", "shell.drawer", "shell.modal", "shell.popover", "shell.toast", "shell.action-sheet", "shell.mask", "shell.popup", "shell.toolbar", "shell.page-container", "shell.keyboard-accessory", "shell.webview", "shell.ad", "ui.map", "gesture.draggable", "gesture.scrollable", "engineering.router-link", "engineering.transition", "engineering.animate", "engineering.error-boundary", "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";
@@ -30,7 +30,7 @@ export declare const COMPONENT_IR_SCHEMA: {
         };
         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 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", "layout.aspect", "layout.zone", "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", "ui.loading", "ui.scale", "ui.skeleton", "ui.progress", "ui.label", "ui.selection", "ui.camera", "shell.page", "shell.nav", "shell.tabbar", "shell.segment", "shell.drawer", "shell.modal", "shell.popover", "shell.toast", "shell.action-sheet", "shell.mask", "shell.popup", "shell.toolbar", "shell.page-container", "shell.keyboard-accessory", "shell.webview", "shell.ad", "ui.map", "gesture.draggable", "gesture.scrollable", "engineering.router-link", "engineering.transition", "engineering.animate", "engineering.error-boundary", "capability.scan-qr", "capability.pick-photo", "capability.location"];
         };
         readonly props: {
             readonly type: "object";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proteus-vue/component-ir",
-  "version": "0.1.0",
+  "version": "0.1.1-beta.0",
   "description": "G-31 组件与 API 语义化（component-semantics-plan B1）：Component IR（C-IR）schema + 属性约束校验 + semantic 映射——组件=语义、属性=约束、Backend 消费 semantic 而非 tag（零依赖纯逻辑）",
   "type": "module",
   "license": "Apache-2.0",
@@ -18,10 +18,10 @@
     "dist",
     "README.md"
   ],
+  "dependencies": {
+    "@proteus-vue/contracts": "0.1.0"
+  },
   "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"
   }
-}
+}