@proteus-vue/component-ir 0.3.0-beta.21 → 0.3.0-beta.28

package/dist/capability-domains.d.ts

@@ -0,0 +1,13 @@
+export type CapabilityDomain = '网络与通信' | '设备与系统' | '存储与文件' | '位置与地图' | '媒体与扫码' | '账号与支付' | '通知与分享' | '应用与生命周期' | '可观测与调试' | '其他';
+/** 能力分域：key = semantic 去掉 `capability.` 前缀（如 `capability.camera` → `camera`） */
+export declare const CAPABILITY_CATEGORY: Record<string, CapabilityDomain>;
+/** 分组展示顺序（官网侧栏 / 优先级表共用） */
+export declare const CAPABILITY_CATEGORY_ORDER: readonly CapabilityDomain[];
+/** 取能力域（输入可为完整 semantic `capability.x` 或裸 slug `x`） */
+export declare function capabilityDomainOf(semanticOrSlug: string): CapabilityDomain;
+/**
+ * 审计：capacity 清单里未登记分域的条目（返回缺口列表；空数组 = 全登记）。
+ * ★设计为**纯函数**（接收 slug 列表，不 import catalog）——避免循环依赖；
+ *   生成器/门禁侧传 `PRIMITIVE_CATALOG.filter(kind==='capability')` 的 slug。
+ */
+export declare function auditCapabilityDomains(slugs: readonly string[]): string[];

package/dist/color.d.ts

@@ -0,0 +1,18 @@
+/** 颜色是否**确实不透明**（保守：拿不准 ⇒ false） */
+/**
+ * 解析颜色为 RGB（仅用于"是否中性色"判定；**不做色彩管理**——只比较三个通道是否相等）。
+ * 拿不准（具名色/hsl/var 等）⇒ null（调用方按"不是中性色"保守处理）。
+ */
+export declare function rgbOfColor(color: string | undefined | null): [number, number, number] | null;
+/**
+ * 颜色是否为**中性色**（R=G=B ⇒ 8 位灰度格式能够无损表达）。
+ *
+ * 【为什么需要它（格式的硬约束，不是保守选择）】紧凑单通道存储（iOS `gray8Uint`）
+ *   **只有亮度、没有色相**——红字写进去会变成灰字。
+ *   ⇒ "可用紧凑格式"的前提必须包含"颜色本来就是灰阶的"。
+ *   ★本仓实测教训：−39% 的实验用的是**白字**（恰好是中性色）⇒ 该约束在实验里成立、
+ *     却从未被写进判据；若不补，彩色文本会被**静默去色**（画面错，无任何报错）。
+ */
+export declare function isNeutralColor(color: string | undefined | null): boolean;
+/** 颜色是否**确实不透明**（保守：拿不准 ⇒ false） */
+export declare function isOpaqueColor(color: string | undefined | null): boolean;

package/dist/index.d.ts

@@ -8,6 +8,8 @@ export { checkComponentSnapshot, extractSemanticTree, checkSemanticCoverage } fr
 export type { ComponentConformanceResult, ControlMismatch, SemanticTree, CoverageGap } from './conformance';
 export { PRIMITIVE_CATALOG, componentPrimitives, implementedPrimitives, primitiveById, primitiveBySemantic, primitiveByTag, checkPrimitiveCatalog } from './primitives';
 export type { PrimitiveDef, PrimitiveKind, PrimitiveStatus } from './primitives';
+export { CAPABILITY_CATEGORY, CAPABILITY_CATEGORY_ORDER, capabilityDomainOf, auditCapabilityDomains } from './capability-domains';
+export type { CapabilityDomain } from './capability-domains';
 export { MP_MAPPING_MATRIX, auditMiniprogramCoverage, auditMatrixReferences, auditCatalogConsistency, formatCoverageReport } from './audit';
 export type { MatrixRefIssue } from './audit';
 export type { CoverageReport, MpCoverageStatus, MpMatrixItem, ConsistencyIssue } from './audit';
@@ -16,6 +18,9 @@ export type { MpSpecStatus, MpSpecClass, MpOfficialSpec, SpecCoverageReport } fr
 export { DEGRADATION_TABLE, MP_UNSUPPORTED_PROPS, degradeProp, degradationOf, auditDegradation, formatDegradationReport, checkPropDegradation, collectPropDiagnostics, RULE_REGISTERED_PROPS, HOST_FALLBACK_TAGS, PROP_NO_DEGRADATION, } from './degradation';
 export type { DegradationEnd, DegradationTier, DegradationEntry, DegradationMap, DegradationIssue, DegradationReport, PropDiagnostic, } from './degradation';
 export type { PKind, ResolvedLength, Edges, LayoutProps, PaintProps, TextProps, PaintHint, PProps, PFlags, PNode, PTree, DynamicBinding, UpdateKind, PDiagnostic, } from './pnode';
+export { isOpaqueColor, isNeutralColor, rgbOfColor } from './color';
+export { derivePaintHint } from './paint-hint';
+export type { PaintHintInput } from './paint-hint';
 export { resolveLength, parseStyleString, normalizeStyleDecls, normalizeStyleString, expandEdges, parseTransform, camel, splitTopLevel } from './pnode-style';
 export type { LengthContext, NormalizeOptions, NormalizeResult } from './pnode-style';
 export { analyzePTree, flattenRate, groupBindingsByNode } from './pnode-analyze';

package/dist/index.js

@@ -154,8 +154,17 @@ var TAG_SEMANTIC_MAP = {
   "p-segment": "shell.segment",
   "p-drawer": "shell.drawer",
   "p-modal": "shell.modal",
+  // ★★★GP4-c（2026-10-03）：登录失效拦截弹窗——与 p-modal **同语义**（模态弹窗）、
+  //   **不同可取消性**（本组件不可取消：无关闭按钮/点遮罩不关；唯一出口是登录态恢复）。
+  //   ★不登记 ⇒ 编译期按"未注册自定义组件"输出 ⇒ MP 端不渲染（M3 门禁会当场红）
+  "p-auth-gate": "shell.modal",
   "p-popover": "shell.popover",
   "p-toast": "shell.toast",
+  // ★★★GP4-a/b（2026-10-03）：两个**浮层宿主**同属其能力的语义（multi-tag 别名——同 ui.loading 的先例）。
+  //   · p-toast-host：Toast 队列的渲染端（构建期按需注入）
+  //   · p-loading-host：Loading 多实例的渲染端（同上）
+  //   ★不登记 ⇒ 编译期按"未注册自定义组件"输出 ⇒ **MP 端不渲染**（M3 门禁当场抓出）
+  "p-toast-host": "shell.toast",
   "p-action-sheet": "shell.action-sheet",
   "p-split": "layout.split",
   // ★已落地绑定（G-32 S10 分栏语义——layout.split 承载）
@@ -196,6 +205,13 @@ var TAG_SEMANTIC_MAP = {
   "p-formfactor": "layout.formfactor",
   // ★★Fluid System v2：柔性形态容器
   "p-loading": "ui.loading",
+  // ★★★GP4-b（2026-10-03）：Loading **多实例宿主**与**区域遮罩**同属 ui.loading 语义（multi-tag 别名，
+  //   与上一行 `router-link`/`p-view` 的"同一语义多标签"同款）。
+  //   · p-loading-host：命令式多实例的渲染端（由构建期按需注入——用户一般不手写）
+  //   · p-loading-region：区域遮罩（就地包裹，用户手写）
+  //   ★不登记 ⇒ 编译期按"未注册自定义组件"输出 ⇒ MP 端不渲染（M3 门禁当场抓出——它是对的）
+  "p-loading-host": "ui.loading",
+  "p-loading-region": "ui.loading",
   "p-scale": "ui.scale",
   "p-skeleton": "ui.skeleton",
   "p-mask": "shell.mask",
@@ -235,6 +251,28 @@ var TAG_SEMANTIC_ALIASES = {
     canonical: "p-router-link",
     aliases: ["router-link"],
     reason: "router-link \u662F Vue Router \u98CE\u683C\u6807\u7B7E\u517C\u5BB9\u522B\u540D\uFF08framework \u4FDD\u7559\u5B57\uFF0C\u975E catalog \u6761\u76EE\uFF09\u3002"
+  },
+  // ★★★GP4-a/b（2026-10-03）：两个浮层能力的**宿主标签**与其声明式组件共享语义——
+  //   与上两条"实现替换/血统并存"的别名不同，这里是**职责分工**（声明式 vs 命令式渲染端）：
+  //   · `p-toast`     = 声明式单条提示（用户摆位置）｜`p-toast-host`   = Toast 队列的**渲染端**
+  //     （命令式 `showToast` 的宿主；构建期按需注入，**用户一般不手写**）
+  //   · `p-loading`   = 声明式遮罩（单实例）    ｜`p-loading-host` = Loading **多实例**宿主（同上）
+  //   · `p-loading-region` = 区域遮罩（就地包裹；用户手写，与 p-loading 是不同用法而非替代）
+  //   ★语义相同（都是"提示/加载态"）故共享 primitive；**保留两标签**因为用法与生命周期都不同。
+  "shell.modal": {
+    canonical: "p-modal",
+    aliases: ["p-auth-gate"],
+    reason: 'p-modal \u662F\u53EF\u53D6\u6D88\u5F39\u5C42\uFF08\u6709\u5173\u95ED\u6309\u94AE/\u70B9\u906E\u7F69\u53EF\u5173\uFF09\uFF1Bp-auth-gate \u662F**\u4E0D\u53EF\u53D6\u6D88**\u7684\u767B\u5F55\u5931\u6548\u62E6\u622A\u5F39\u7A97\uFF08\u552F\u4E00\u51FA\u53E3\u662F\u767B\u5F55\u6001\u6062\u590D\uFF09\u3002\u540C\u8BED\u4E49\uFF08\u6A21\u6001\u5F39\u7A97\uFF09\u4E0D\u540C\u53EF\u53D6\u6D88\u6027 \u21D2 \u4FDD\u7559\u4E24\u6807\u7B7E\u800C\u975E\u5408\u5E76\uFF08\u628A"\u4E0D\u53EF\u53D6\u6D88"\u505A\u6210 p-modal \u7684\u5F00\u5173\uFF0C\u4F1A\u8BA9"\u53EF\u5173"\u7684\u9ED8\u8BA4\u914D\u7F6E\u6709\u673A\u4F1A\u88AB\u8BEF\u7528\u5230\u62E6\u622A\u573A\u666F\uFF09\u3002'
+  },
+  "shell.toast": {
+    canonical: "p-toast",
+    aliases: ["p-toast-host"],
+    reason: "p-toast \u662F\u58F0\u660E\u5F0F\u5355\u6761\u63D0\u793A\uFF08\u7236\u7EA7\u7ED9 visible/text\uFF09\uFF1Bp-toast-host \u662F\u540C\u8BED\u4E49\u7684**\u547D\u4EE4\u5F0F\u6E32\u67D3\u7AEF**\uFF08\u8BA2\u9605 runtime \u961F\u5217\uFF0C\u7531\u6784\u5EFA\u671F\u6309\u9700\u6CE8\u5165\u6BCF\u9875\uFF09\u2014\u2014\u4E24\u8005\u7528\u9014\u4E0D\u540C\uFF0C\u6545\u5E76\u5B58\u800C\u975E\u66FF\u4EE3\u3002"
+  },
+  "ui.loading": {
+    canonical: "p-loading",
+    aliases: ["p-loading-host", "p-loading-region"],
+    reason: "p-loading \u662F\u58F0\u660E\u5F0F\u906E\u7F69\uFF08\u5355\u5B9E\u4F8B\uFF09\uFF1Bp-loading-host \u662F\u540C\u8BED\u4E49\u7684**\u547D\u4EE4\u5F0F\u591A\u5B9E\u4F8B\u6E32\u67D3\u7AEF**\uFF08\u6784\u5EFA\u671F\u6CE8\u5165\uFF09\uFF1Bp-loading-region \u662F**\u533A\u57DF\u906E\u7F69**\uFF08\u5C31\u5730\u5305\u88F9\u3001\u8D34\u5408\u76D2\u5B50\u5C3A\u5BF8\uFF09\u3002\u4E09\u8005\u662F\u540C\u4E00\u8BED\u4E49\u7684\u4E09\u79CD\u7528\u6CD5\uFF08\u5168\u5C4F\u58F0\u660E\u5F0F/\u5168\u5C4F\u547D\u4EE4\u5F0F/\u533A\u57DF\u5185\uFF09\uFF0C\u6545\u5171\u4EAB primitive \u800C\u4FDD\u7559\u5404\u81EA\u6807\u7B7E\u3002"
   }
 };
 
@@ -467,8 +505,183 @@ var SEMANTIC_BACKEND_MAP = {
     flutter: "scanQR",
     headless: "scan-qr"
   },
+  // ★★NC1 首个声明式能力（2026-09-30，C83）：屏幕常亮。
+  //   ★落地状态如实标注（两类）：**已接线** = vue-dom（`navigator.wakeLock`，生成桥真跑）
+  //     + skyline（`wx.setKeepScreenOn`，生成桥真跑）；**声明** = native-ios/android/harmony
+  //     （平台真实 API，按本表既有口径登记——与 capability.qr-code 的 AVCaptureSession 同性质，
+  //     属设计声明层；native 宿主接线是后续批次）。
+  "capability.keep-screen-on": {
+    "vue-dom": "navigator.wakeLock",
+    "native-ios": "UIApplication.isIdleTimerDisabled",
+    "native-android": "Window.FLAG_KEEP_SCREEN_ON",
+    "native-harmony": "window.setWindowKeepScreenOn",
+    skyline: "wx.setKeepScreenOn",
+    flutter: "keepScreenOn",
+    headless: "keep-screen-on"
+  },
+  // ★★NC1 第二个声明式能力（2026-09-30，C84）：文档预览。
+  //   ★落地状态如实分两类：**已接线** = vue-dom（`window.open`）/ skyline（`wx.openDocument`，生成桥真跑）；
+  //     **声明** = native 两端（平台真实 API：iOS QLPreviewController / Android ACTION_VIEW，
+  //     与既有 capability.qr-code 的 AVCaptureSession 同性质，属设计声明层）。
+  //   ★**native-harmony 有意省略**：鸿蒙文档预览 API 名未经取证，**不编造**（≥3 端映射判据不受影响）。
+  "capability.document-preview": {
+    "vue-dom": "window.open",
+    "native-ios": "QLPreviewController",
+    "native-android": "Intent.ACTION_VIEW",
+    skyline: "wx.openDocument",
+    flutter: "open_file",
+    headless: "open-document"
+  },
+  // ★★2026-09-30 反馈组件补齐（U19 shell.toast / S8 ui.loading）：
+  //   组件本体（`p-toast` / `p-loading`）**早已存在且已注册**（`packages/components/index.ts`）
+  //   并有 MP 产物级测试（`tests/component-b5.test.ts`：wx:if/定时器/A@keyframes 断言）——
+  //   缺的只是**本表的后端映射登记**（G-31.4 门禁要求 ≥3 端才可标 implemented，
+  //   而 catalog 的 status 因此一直停在 planned ⇒ 与"组件已能用"的事实不符）。
+  //   ⇒ 本批补齐映射后，catalog status 据实转 implemented（**修的是记账，不是能力**）。
+  //   ★对照：`wx.showToast` / `wx.showLoading`（命令式全局提示）是**另一条路**——
+  //     前者由本组件承接（声明式、可跨端、样式可控），后者仍属 MP 官方 API 表（见 SPEC_PLANNED，
+  //     归"全局命令式提示"待补）。两者不冲突：组件是推荐路径，命令式是兼容路径。
+  "shell.toast": {
+    "vue-dom": "div.proteus-toast",
+    "native-ios": "UIView.toast",
+    "native-android": "Toast",
+    "native-harmony": "promptAction.showToast",
+    skyline: "view.toast",
+    // Skyline 无原生 toast 组件 → 用 view 自绘（组件本体即此策略）
+    flutter: "ScaffoldMessenger.showSnackBar",
+    headless: "toast"
+  },
+  "ui.loading": {
+    "vue-dom": "div.proteus-loading",
+    "native-ios": "UIActivityIndicatorView",
+    "native-android": "ProgressBar",
+    "native-harmony": "LoadingProgress",
+    skyline: "view.loading",
+    // 同上：自绘 spinner（组件内 @keyframes 动画）
+    flutter: "CircularProgressIndicator",
+    headless: "loading"
+  },
   // ★2026-09-18 语义去重：原键 capability.pick-photo 为重复名（组件实现调用 useCamera()，
   //   真实能力即 C1 capability.camera）——键已迁移，映射原样保留。
+  // ★★2026-09-30：生命周期三能力的后端映射（C23/C24/C25 随 App 腿落地转为 implemented）。
+  //   各行含义：**平台真实触发源**（不是渲染类型——这三个是"事件源"类能力）。
+  //   · native-ios/android：系统生命周期回调（iOS `willResignActive`/Android `onPause`——本轮真机实证）
+  //   · vue-dom / skyline：既有实现（`visibilitychange` / `wx.onAppShow`）
+  //   · headless：确定性注入（测试夹具）
+  "capability.app-lifecycle": {
+    "vue-dom": "document.visibilitychange",
+    "native-ios": "UIApplication.willResignActive",
+    "native-android": "Activity.onPause",
+    skyline: "wx.onAppShow",
+    flutter: "AppLifecycleState",
+    headless: "app-lifecycle-bus"
+  },
+  "capability.page-lifecycle": {
+    "vue-dom": "visibilitychange+history",
+    "native-ios": "UINavigationController.didShowViewController",
+    "native-android": "Fragment.onResume",
+    skyline: "Page.onShow",
+    flutter: "RouteAware.didPush",
+    headless: "page-lifecycle-bus"
+  },
+  "capability.background": {
+    "vue-dom": "document.hidden",
+    "native-ios": "UIApplication.didEnterBackground",
+    "native-android": "Activity.onStop",
+    skyline: "wx.onBackgroundAudioInterruptionBegin",
+    flutter: "AppLifecycleState.paused",
+    headless: "background-bus"
+  },
+  // ★2026-09-30 应用与生命周期域收口（能力已落地）
+  "capability.mini-program": {
+    "vue-dom": "window.open (cross-app n/a)",
+    "native-ios": "UIApplication.open",
+    "native-android": "Intent.ACTION_VIEW",
+    "skyline": "wx.navigateToMiniProgram",
+    "flutter": "url_launcher",
+    "headless": "mini-program-nav"
+  },
+  // ★2026-09-30 应用与生命周期域收口（能力已落地）
+  "capability.embedded": {
+    "vue-dom": "window.parent (preset)",
+    "native-ios": "UIApplicationDelegate.host",
+    "native-android": "Activity.getIntent",
+    "skyline": "wx.getEnterOptionsSync",
+    "flutter": "PlatformDispatcher.host",
+    "headless": "host-context"
+  },
+  // ★2026-09-30 应用与生命周期域收口（能力已落地）
+  "capability.extension": {
+    "vue-dom": "dynamic import()",
+    "native-ios": "NSBundle.load",
+    "native-android": "DexClassLoader",
+    "skyline": "plugin shell (host)",
+    "flutter": "dynamic library load",
+    "headless": "extension-loader"
+  },
+  // ★2026-09-30 应用与生命周期域收口（能力已落地）
+  "capability.update": {
+    "vue-dom": "ServiceWorkerRegistration",
+    "native-ios": "Bundle version check",
+    "native-android": "Play Core In-App Updates",
+    "skyline": "wx.getUpdateManager",
+    "flutter": "upgrader",
+    "headless": "update-manager"
+  },
+  // ★2026-09-30 应用与生命周期域收口（能力已落地）
+  "capability.worker": {
+    "vue-dom": "new Worker()",
+    "native-ios": "DispatchQueue.global",
+    "native-android": "ThreadPoolExecutor",
+    "skyline": "wx.createWorker",
+    "flutter": "Isolate.spawn",
+    "headless": "worker-thread"
+  },
+  // ★2026-09-30 应用与生命周期域收口（能力已落地）
+  "capability.preload": {
+    "vue-dom": "link rel=preload",
+    "native-ios": "NSBundle preload",
+    "native-android": "Resources preload",
+    "skyline": "wx.preloadAssets",
+    "flutter": "precacheImage",
+    "headless": "preload"
+  },
+  // ★2026-09-30 应用与生命周期域收口（能力已落地）
+  "capability.idle": {
+    "vue-dom": "requestIdleCallback",
+    "native-ios": "CADisplayLink idle",
+    "native-android": "Choreographer idle",
+    "skyline": "wx.requestIdleCallback",
+    "flutter": "SchedulerBinding.idle",
+    "headless": "idle-callback"
+  },
+  // ★2026-09-30 应用与生命周期域收口（能力已落地）
+  "capability.window": {
+    "vue-dom": "window.resizeTo (limited)",
+    "native-ios": "UIWindowScene.requestGeometryUpdate",
+    "native-android": "WindowManager.LayoutParams",
+    "skyline": "wx.setWindowSize",
+    "flutter": "WindowManager",
+    "headless": "window-manager"
+  },
+  // ★2026-09-30 应用与生命周期域收口（能力已落地）
+  "capability.navigation-guard": {
+    "vue-dom": "beforeunload",
+    "native-ios": "UINavigationController.delegate",
+    "native-android": "OnBackPressedDispatcher",
+    "skyline": "wx.enableAlertBeforeUnload",
+    "flutter": "PopScope",
+    "headless": "nav-guard"
+  },
+  // ★2026-09-30 应用与生命周期域收口（能力已落地）
+  "capability.webassembly": {
+    "vue-dom": "WebAssembly.instantiate",
+    "native-ios": "JavaScriptCore WebAssembly",
+    "native-android": "QuickJS WebAssembly",
+    "skyline": "WXWebAssembly.instantiate",
+    "flutter": "wasm bindings",
+    "headless": "wasm"
+  },
   "capability.camera": {
     "vue-dom": "input.proteus-pick-photo",
     "native-ios": "UIImagePicker",
@@ -1035,7 +1248,9 @@ var UI = [
   { id: "U17", kind: "ui", semantic: "ui.picker", tag: "p-picker", props: ["mode", "start", "end", "indicatorStyle", "indicatorClass", "maskClass", "maskStyle", "immediateChange"], mpEquiv: "<picker>", tier: "L1", status: "implemented" },
   { id: "U18", kind: "ui", semantic: "ui.form", tag: "p-form", props: ["model", "rules", "layout"], mpEquiv: "\u7EC4\u5408", tier: "L1", status: "implemented" },
   // ★#405 语义登记批：反馈/状态类组件
-  { id: "U19", kind: "ui", semantic: "ui.loading", tag: "p-loading", props: ["size", "text"], mpEquiv: "wx.showLoading \u90E8\u5206", tier: "L2", status: "planned" },
+  // ★2026-09-30 反馈组件补齐：组件本体（p-loading）与 MP 产物测试早已存在，
+  //   缺的只是 SEMANTIC_BACKEND_MAP 的后端映射登记 ⇒ 补齐后据实转 implemented（**修记账非修能力**）
+  { id: "U19", kind: "ui", semantic: "ui.loading", tag: "p-loading", props: ["size", "text"], mpEquiv: "wx.showLoading \u90E8\u5206", tier: "L1", status: "implemented" },
   { id: "U20", kind: "ui", semantic: "ui.scale", tag: "p-scale", props: ["level", "density", "baseSize"], mpEquiv: "\u65E0\uFF08\u65E0\u969C\u788D\u6863\u4F4D\uFF09", tier: "L2", status: "planned" },
   { id: "U21", kind: "ui", semantic: "ui.skeleton", tag: "p-skeleton", props: ["rows", "avatar", "animated"], mpEquiv: "\u65E0", tier: "L2", status: "planned" },
   // ★能力颗粒度对齐 C2：进度条 / 表单标签
@@ -1063,7 +1278,8 @@ var SHELL = [
   { id: "S5", kind: "shell", semantic: "shell.drawer", tag: "p-drawer", props: ["side", "width", "overlay"], mpEquiv: "\u7EC4\u5408", tier: "L1", status: "implemented" },
   { id: "S6", kind: "shell", semantic: "shell.modal", tag: "p-modal", props: ["open", "dismissible", "sheet", "dialog", "alert"], mpEquiv: "<modal>+wx.showModal", tier: "L1", status: "implemented" },
   { id: "S7", kind: "shell", semantic: "shell.popover", tag: "p-popover", props: ["trigger", "placement"], mpEquiv: "\u7EC4\u5408", tier: "L1", status: "implemented" },
-  { id: "S8", kind: "shell", semantic: "shell.toast", tag: "p-toast", props: ["message", "duration", "type"], mpEquiv: "wx.showToast", tier: "L1", status: "planned" },
+  // ★2026-09-30 同上（p-toast 已有 MP 产物测试 + 7 端映射 ⇒ 据实转 implemented）
+  { id: "S8", kind: "shell", semantic: "shell.toast", tag: "p-toast", props: ["message", "duration", "type"], mpEquiv: "wx.showToast", tier: "L1", status: "implemented" },
   { id: "S9", kind: "shell", semantic: "shell.action-sheet", tag: "p-action-sheet", props: ["actions", "cancel"], mpEquiv: "wx.showActionSheet", tier: "L1", status: "implemented" },
   { id: "S10", kind: "shell", semantic: "layout.split", tag: "p-split", props: ["breakpoint", "ratio", "collapse"], mpEquiv: "\u65E0\uFF08\u5206\u680F\u5E03\u5C40\uFF09", tier: "L1", status: "implemented" },
   // ★已落地绑定：分栏语义由 layout.split 承载（G-32 文档为 shell.split——机器事实以实现为准）
@@ -1124,9 +1340,13 @@ var CAPABILITY = [
   cap("C20", "calendar", "useCalendar()", "wx.addPhoneCalendar", "CalendarAPI"),
   cap("C21", "phone-call", "usePhoneCall()", "wx.makePhoneCall", "Result<void>"),
   cap("C22", "sms", "useSMS()", "wx.??\uFF08\u53D7\u9650\uFF09", "Result<void>"),
-  cap("C23", "app-lifecycle", "useAppLifecycle()", "App.onLaunch/onShow", "LifecycleHooks"),
-  cap("C24", "page-lifecycle", "usePageLifecycle()", "Page.onLoad/onShow", "LifecycleHooks"),
-  cap("C25", "background", "useBackground()", "wx.onBackground", "BackgroundAPI"),
+  // ★★2026-09-30：C23/C24/C25 App 宿主腿落地（此前仅 wx/web 两桥 ⇒ App 端形同虚设）——
+  //   App 桥 `packages/api/src/capability-app.ts`（总线 + 三能力 + 虚拟栈页面事件翻译器）；
+  //   真机判据 `check:host-runtime` ①~⑤（冷启动补 launch / 真实栈驱动页面生命周期 /
+  //   壳真实事件逐条驱动总线 / 启动参数经 job 泵 / 阶段快照）。
+  { id: "C23", kind: "capability", semantic: "capability.app-lifecycle", api: "useAppLifecycle()", props: ["LifecycleHooks"], mpEquiv: "App.onLaunch/onShow", tier: "L1", status: "implemented" },
+  { id: "C24", kind: "capability", semantic: "capability.page-lifecycle", api: "usePageLifecycle()", props: ["LifecycleHooks"], mpEquiv: "Page.onLoad/onShow", tier: "L1", status: "implemented" },
+  { id: "C25", kind: "capability", semantic: "capability.background", api: "useBackground()", props: ["BackgroundAPI"], mpEquiv: "wx.onBackground", tier: "L1", status: "implemented" },
   // 7.3 通信/数据（10）
   cap("C26", "fetch", "useFetch()", "wx.request", "Promise<T>"),
   cap("C27", "websocket", "useWebSocket()", "wx.connectSocket", "WSConnection"),
@@ -1152,15 +1372,15 @@ var CAPABILITY = [
   cap("C45", "shortcut", "useShortcut()", "wx.addToDesktop", "Result<void>"),
   cap("C46", "in-app-purchase", "useInAppPurchase()", "wx.requestPayment \u6269\u5C55", "Result<Receipt>"),
   // 7.5 平台特有（4——C47-C50，此前 7.4 末 C46，总 50）
-  { id: "C47", kind: "capability", semantic: "capability.mini-program", api: "useMiniProgram()", props: ["MPContext"], mpEquiv: "wx.navigateToMiniProgram", tier: "L1", status: "planned" },
-  { id: "C48", kind: "capability", semantic: "capability.embedded", api: "useEmbedded()", props: ["HostContext"], mpEquiv: "\u65E0\uFF08\u88AB\u5BBF\u4E3B\u5D4C\u5165\uFF09", tier: "L1", status: "planned" },
+  { id: "C47", kind: "capability", semantic: "capability.mini-program", api: "useMiniProgram()", props: ["MPContext"], mpEquiv: "wx.navigateToMiniProgram", tier: "L1", status: "implemented" },
+  { id: "C48", kind: "capability", semantic: "capability.embedded", api: "useEmbedded()", props: ["HostContext"], mpEquiv: "\u65E0\uFF08\u88AB\u5BBF\u4E3B\u5D4C\u5165\uFF09", tier: "L1", status: "implemented" },
   { id: "C49", kind: "capability", semantic: "capability.live", api: "useLive()", props: ["LiveRoom"], mpEquiv: "wx...\uFF08\u76F4\u64AD\u7EC4\u4EF6\uFF09", tier: "L1", status: "planned" },
-  { id: "C50", kind: "capability", semantic: "capability.extension", api: "useExtension()", props: ["ExtensionAPI"], mpEquiv: "\u65E0\uFF08\u63D2\u4EF6/\u6269\u5C55\u70B9 G-21\uFF09", tier: "L1", status: "planned" },
+  { id: "C50", kind: "capability", semantic: "capability.extension", api: "useExtension()", props: ["ExtensionAPI"], mpEquiv: "\u65E0\uFF08\u63D2\u4EF6/\u6269\u5C55\u70B9 G-21\uFF09", tier: "L1", status: "implemented" },
   // ★颗粒度对齐 C（2026-09-11）：C51 小程序热更新（wx.getUpdateManager）
-  { id: "C51", kind: "capability", semantic: "capability.update", api: "useUpdate()", props: ["UpdateManagerAPI"], mpEquiv: "wx.getUpdateManager", tier: "L1", status: "planned" },
+  { id: "C51", kind: "capability", semantic: "capability.update", api: "useUpdate()", props: ["UpdateManagerAPI"], mpEquiv: "wx.getUpdateManager", tier: "L1", status: "implemented" },
   // ★颗粒度对齐 C3（2026-09-11）：相册 / Worker（对齐小程序媒体与多线程 API——纯 Hook，无 C-IR 节点 → planned）
   { id: "C52", kind: "capability", semantic: "capability.album", api: "useAlbum()", props: ["AlbumAPI"], mpEquiv: "wx.chooseMedia/saveImageToPhotosAlbum/previewMedia", tier: "L1", status: "planned" },
-  { id: "C53", kind: "capability", semantic: "capability.worker", api: "useWorker()", props: ["WorkerHandle"], mpEquiv: "wx.createWorker", tier: "L1", status: "planned" },
+  { id: "C53", kind: "capability", semantic: "capability.worker", api: "useWorker()", props: ["WorkerHandle"], mpEquiv: "wx.createWorker", tier: "L1", status: "implemented" },
   // ★颗粒度对齐 C3 批 2：收货地址 / WiFi / 微信运动（对齐小程序系统 API——纯 Hook → planned）
   { id: "C54", kind: "capability", semantic: "capability.address", api: "useAddress()", props: ["ShippingAddress"], mpEquiv: "wx.chooseAddress", tier: "L1", status: "planned" },
   { id: "C55", kind: "capability", semantic: "capability.wifi", api: "useWifi()", props: ["WifiAPI"], mpEquiv: "wx.getConnectedWifi/getWifiList/connectWifi", tier: "L1", status: "planned" },
@@ -1180,7 +1400,7 @@ var CAPABILITY = [
   { id: "C65", kind: "capability", semantic: "capability.privacy", api: "usePrivacy()", props: ["PrivacyAPI"], mpEquiv: "wx.getPrivacySetting/openPrivacyContract/requirePrivacyAuthorize", tier: "L1", status: "planned" },
   // ★权威标尺缺口补齐批 D（2026-09-12）：性能 / 预加载 / 图像编辑（通用能力，无资质门槛）
   { id: "C66", kind: "capability", semantic: "capability.performance", api: "usePerformance()", props: ["PerformanceAPI"], mpEquiv: "wx.getPerformance/reportPerformance", tier: "L1", status: "planned" },
-  { id: "C67", kind: "capability", semantic: "capability.preload", api: "usePreload()", props: ["PreloadAPI"], mpEquiv: "wx.preloadAssets/preloadSkylineView/preloadWebview/preDownloadSubpackage", tier: "L1", status: "planned" },
+  { id: "C67", kind: "capability", semantic: "capability.preload", api: "usePreload()", props: ["PreloadAPI"], mpEquiv: "wx.preloadAssets/preloadSkylineView/preloadWebview/preDownloadSubpackage", tier: "L1", status: "implemented" },
   { id: "C68", kind: "capability", semantic: "capability.image-edit", api: "useImageEdit()", props: ["ImageEditAPI"], mpEquiv: "wx.cropImage/editImage", tier: "L1", status: "planned" },
   // ★权威标尺缺口补齐批 E（2026-09-12）：网络底层 / 媒体高级
   { id: "C69", kind: "capability", semantic: "capability.socket", api: "useSocket()", props: ["UDPSocketHandle / TCPSocketHandle"], mpEquiv: "wx.createUDPSocket/createTCPSocket", tier: "L1", status: "planned" },
@@ -1188,16 +1408,37 @@ var CAPABILITY = [
   // ★权威标尺缺口补齐批 F（2026-09-12）：录屏/缓存/空闲/窗口/导航拦截
   { id: "C71", kind: "capability", semantic: "capability.screen-capture", api: "useScreenCapture()", props: ["ScreenCaptureAPI"], mpEquiv: "wx.getScreenRecordingState/onScreenRecordingStateChanged/onUserCaptureScreen/checkIsPictureInPictureActive", tier: "L1", status: "planned" },
   { id: "C72", kind: "capability", semantic: "capability.cache-manager", api: "useCacheManager()", props: ["CacheManagerHandle"], mpEquiv: "wx.createCacheManager", tier: "L1", status: "planned" },
-  { id: "C73", kind: "capability", semantic: "capability.idle", api: "useIdle()", props: ["IdleAPI"], mpEquiv: "wx.requestIdleCallback/cancelIdleCallback", tier: "L1", status: "planned" },
-  { id: "C74", kind: "capability", semantic: "capability.window", api: "useWindow()", props: ["WindowAPI"], mpEquiv: "wx.setWindowSize", tier: "L1", status: "planned" },
-  { id: "C75", kind: "capability", semantic: "capability.navigation-guard", api: "useNavigationGuard()", props: ["NavigationGuardAPI"], mpEquiv: "wx.enableAlertBeforeUnload/disableAlertBeforeUnload", tier: "L1", status: "planned" },
+  { id: "C73", kind: "capability", semantic: "capability.idle", api: "useIdle()", props: ["IdleAPI"], mpEquiv: "wx.requestIdleCallback/cancelIdleCallback", tier: "L1", status: "implemented" },
+  { id: "C74", kind: "capability", semantic: "capability.window", api: "useWindow()", props: ["WindowAPI"], mpEquiv: "wx.setWindowSize", tier: "L1", status: "implemented" },
+  { id: "C75", kind: "capability", semantic: "capability.navigation-guard", api: "useNavigationGuard()", props: ["NavigationGuardAPI"], mpEquiv: "wx.enableAlertBeforeUnload/disableAlertBeforeUnload", tier: "L1", status: "implemented" },
   // ★权威标尺缺口补齐批 G（2026-09-12）：AR/XR / iBeacon / 局域网 / 翻译 / 海报 / 设备探测
   { id: "C76", kind: "capability", semantic: "capability.ar", api: "useAR()", props: ["ARAPI"], mpEquiv: "wx.createVKSession/isVKSupport", tier: "L1", status: "planned" },
   { id: "C77", kind: "capability", semantic: "capability.beacon", api: "useBeacon()", props: ["BeaconAPI"], mpEquiv: "wx.onBeaconServiceChange/onBeaconUpdate", tier: "L1", status: "planned" },
   { id: "C78", kind: "capability", semantic: "capability.local-service", api: "useLocalService()", props: ["LocalServiceAPI"], mpEquiv: "wx.onLocalServiceFound/Lost/ResolveFail/DiscoveryStop", tier: "L1", status: "planned" },
   { id: "C79", kind: "capability", semantic: "capability.translation", api: "useTranslation()", props: ["TranslationAPI"], mpEquiv: "wx.onUserTriggerTranslation/onUserOffTranslation", tier: "L1", status: "planned" },
   { id: "C80", kind: "capability", semantic: "capability.poster", api: "usePoster()", props: ["PosterAPI"], mpEquiv: "wx.onGeneratePoster", tier: "L1", status: "planned" },
-  { id: "C81", kind: "capability", semantic: "capability.device-capability", api: "useDeviceCapability()", props: ["DeviceCapabilityAPI"], mpEquiv: "wx.checkDeviceSupportHevc", tier: "L1", status: "planned" }
+  { id: "C81", kind: "capability", semantic: "capability.device-capability", api: "useDeviceCapability()", props: ["DeviceCapabilityAPI"], mpEquiv: "wx.checkDeviceSupportHevc", tier: "L1", status: "planned" },
+  // ★C82（2026-09-29）：WebAssembly 跨平台实现——**超官方清单**能力（官方 301 API 里无 wasm）。
+  //   三端形态有实质差异（双源取证：微信官方文档 /framework/performance/wasm.html +
+  //   miniprogram-api-typings/lib.wx.wasm.d.ts）：
+  //   MP `WXWebAssembly.instantiate(path)` 只收**代码包路径**（.wasm/.wasm.br）· 无 compile/validate ·
+  //   v2.13.0+ 全局 / v2.15.0+ Worker；Web 与 App-iOS(JSC) 走标准 `WebAssembly`（收字节 · 有 compile/validate）；
+  //   App-Android 由**宿主 wasm3** 执行（QuickJS 内建无 WASM——双端真机验证 add(2,40)=42）。
+  //   ⇒ 归一入口 `instantiate({bytes}|{path})` + 能力位 `supportsStreaming`/`supportsPathLoad`。
+  { id: "C82", kind: "capability", semantic: "capability.webassembly", api: "useWebAssembly()", props: ["WebAssemblyAPI"], mpEquiv: "WXWebAssembly.instantiate\uFF08\u5B98\u65B9\u6587\u6863 performance/wasm\uFF09", tier: "L1", status: "implemented" },
+  // ★★NC1 首个声明式能力（2026-09-30）：来源 = 权威标尺修复后浮现的真实缺口之一
+  //   （快照抽取器修复前 `wx.setKeepScreenOn` 结构性不可见，见 mp-spec-coverage 的 SPEC_PLANNED）。
+  //   落地方式 = **声明式**（`packages/api/src/bridge-decls/keep-screen-on.ts` → 生成 → 合并进 bridge）：
+  //   MP `wx.setKeepScreenOn` / Web **Screen Wake Lock**（`navigator.wakeLock.request('screen')`）——
+  //   双端都有真实对等（非降级对等）。status 标 implemented：桥与 Hook 已落地且测试覆盖
+  //   （含双端真跑 + 幂等 + 缺 API 降级）。
+  { id: "C83", kind: "capability", semantic: "capability.keep-screen-on", api: "useKeepScreenOn()", props: ["KeepScreenOnState"], mpEquiv: "wx.setKeepScreenOn\uFF08Web \u5BF9\u7B49\uFF1AScreen Wake Lock API\uFF09", tier: "L1", status: "implemented" },
+  // ★★NC1 第二个声明式能力（2026-09-30）：**用户裁定**「openDocument 属原生能力落地范畴，
+  //   目标就是 99% 的业务代码不需要写原生代码」⇒ 落地而非搁置。
+  //   形态 = 声明式（bridge-decls/open-document.ts → 生成 → 合并）；MP `wx.openDocument` /
+  //   Web `window.open`（浏览器查看器）；★Web 诚实边界：office 格式通常转下载而非预览。
+  //   status = implemented：桥与 Hook 已落地 + 测试覆盖（含"弹窗被拦截 ⇒ Err"的防静默判据）。
+  { id: "C84", kind: "capability", semantic: "capability.document-preview", api: "useOpenDocument()", props: ["DocumentPath"], mpEquiv: "wx.openDocument\uFF08Web \u5BF9\u7B49\uFF1Awindow.open \u2192 \u6D4F\u89C8\u5668\u67E5\u770B\u5668\uFF09", tier: "L1", status: "implemented" }
 ];
 var ENGINEERING = [
   { id: "E1", kind: "engineering", semantic: "engineering.state", api: "useState()", mpEquiv: "data", tier: "L1", status: "planned" },
@@ -1309,6 +1550,105 @@ function checkSemanticCoverage(minBackends = 3) {
   return gaps;
 }
 
+// src/capability-domains.ts
+var CAPABILITY_CATEGORY = {
+  fetch: "\u7F51\u7EDC\u4E0E\u901A\u4FE1",
+  websocket: "\u7F51\u7EDC\u4E0E\u901A\u4FE1",
+  "socket-task": "\u7F51\u7EDC\u4E0E\u901A\u4FE1",
+  socket: "\u7F51\u7EDC\u4E0E\u901A\u4FE1",
+  "local-service": "\u7F51\u7EDC\u4E0E\u901A\u4FE1",
+  upload: "\u7F51\u7EDC\u4E0E\u901A\u4FE1",
+  download: "\u7F51\u7EDC\u4E0E\u901A\u4FE1",
+  "data-channel": "\u7F51\u7EDC\u4E0E\u901A\u4FE1",
+  bluetooth: "\u7F51\u7EDC\u4E0E\u901A\u4FE1",
+  nfc: "\u7F51\u7EDC\u4E0E\u901A\u4FE1",
+  device: "\u8BBE\u5907\u4E0E\u7CFB\u7EDF",
+  screen: "\u8BBE\u5907\u4E0E\u7CFB\u7EDF",
+  battery: "\u8BBE\u5907\u4E0E\u7CFB\u7EDF",
+  orientation: "\u8BBE\u5907\u4E0E\u7CFB\u7EDF",
+  brightness: "\u8BBE\u5907\u4E0E\u7CFB\u7EDF",
+  sensor: "\u8BBE\u5907\u4E0E\u7CFB\u7EDF",
+  vibrate: "\u8BBE\u5907\u4E0E\u7CFB\u7EDF",
+  network: "\u8BBE\u5907\u4E0E\u7CFB\u7EDF",
+  keyboard: "\u8BBE\u5907\u4E0E\u7CFB\u7EDF",
+  clipboard: "\u8BBE\u5907\u4E0E\u7CFB\u7EDF",
+  "element-query": "\u8BBE\u5907\u4E0E\u7CFB\u7EDF",
+  intersection: "\u8BBE\u5907\u4E0E\u7CFB\u7EDF",
+  "media-query": "\u8BBE\u5907\u4E0E\u7CFB\u7EDF",
+  "screen-capture": "\u8BBE\u5907\u4E0E\u7CFB\u7EDF",
+  "cache-manager": "\u8BBE\u5907\u4E0E\u7CFB\u7EDF",
+  ar: "\u8BBE\u5907\u4E0E\u7CFB\u7EDF",
+  beacon: "\u8BBE\u5907\u4E0E\u7CFB\u7EDF",
+  "device-capability": "\u8BBE\u5907\u4E0E\u7CFB\u7EDF",
+  storage: "\u5B58\u50A8\u4E0E\u6587\u4EF6",
+  cookie: "\u5B58\u50A8\u4E0E\u6587\u4EF6",
+  "file-system": "\u5B58\u50A8\u4E0E\u6587\u4EF6",
+  archive: "\u5B58\u50A8\u4E0E\u6587\u4EF6",
+  location: "\u4F4D\u7F6E\u4E0E\u5730\u56FE",
+  map: "\u4F4D\u7F6E\u4E0E\u5730\u56FE",
+  camera: "\u5A92\u4F53\u4E0E\u626B\u7801",
+  microphone: "\u5A92\u4F53\u4E0E\u626B\u7801",
+  live: "\u5A92\u4F53\u4E0E\u626B\u7801",
+  "qr-code": "\u5A92\u4F53\u4E0E\u626B\u7801",
+  canvas: "\u5A92\u4F53\u4E0E\u626B\u7801",
+  video: "\u5A92\u4F53\u4E0E\u626B\u7801",
+  audio: "\u5A92\u4F53\u4E0E\u626B\u7801",
+  "live-pusher": "\u5A92\u4F53\u4E0E\u626B\u7801",
+  "image-edit": "\u5A92\u4F53\u4E0E\u626B\u7801",
+  "media-processing": "\u5A92\u4F53\u4E0E\u626B\u7801",
+  login: "\u8D26\u53F7\u4E0E\u652F\u4ED8",
+  auth: "\u8D26\u53F7\u4E0E\u652F\u4ED8",
+  biometric: "\u8D26\u53F7\u4E0E\u652F\u4ED8",
+  "face-id": "\u8D26\u53F7\u4E0E\u652F\u4ED8",
+  permission: "\u8D26\u53F7\u4E0E\u652F\u4ED8",
+  payment: "\u8D26\u53F7\u4E0E\u652F\u4ED8",
+  "in-app-purchase": "\u8D26\u53F7\u4E0E\u652F\u4ED8",
+  privacy: "\u8D26\u53F7\u4E0E\u652F\u4ED8",
+  notification: "\u901A\u77E5\u4E0E\u5206\u4EAB",
+  share: "\u901A\u77E5\u4E0E\u5206\u4EAB",
+  shortcut: "\u901A\u77E5\u4E0E\u5206\u4EAB",
+  sms: "\u901A\u77E5\u4E0E\u5206\u4EAB",
+  contact: "\u901A\u77E5\u4E0E\u5206\u4EAB",
+  "phone-call": "\u901A\u77E5\u4E0E\u5206\u4EAB",
+  calendar: "\u901A\u77E5\u4E0E\u5206\u4EAB",
+  ad: "\u901A\u77E5\u4E0E\u5206\u4EAB",
+  poster: "\u901A\u77E5\u4E0E\u5206\u4EAB",
+  translation: "\u901A\u77E5\u4E0E\u5206\u4EAB",
+  "app-lifecycle": "\u5E94\u7528\u4E0E\u751F\u547D\u5468\u671F",
+  "page-lifecycle": "\u5E94\u7528\u4E0E\u751F\u547D\u5468\u671F",
+  background: "\u5E94\u7528\u4E0E\u751F\u547D\u5468\u671F",
+  "mini-program": "\u5E94\u7528\u4E0E\u751F\u547D\u5468\u671F",
+  embedded: "\u5E94\u7528\u4E0E\u751F\u547D\u5468\u671F",
+  extension: "\u5E94\u7528\u4E0E\u751F\u547D\u5468\u671F",
+  preload: "\u5E94\u7528\u4E0E\u751F\u547D\u5468\u671F",
+  idle: "\u5E94\u7528\u4E0E\u751F\u547D\u5468\u671F",
+  window: "\u5E94\u7528\u4E0E\u751F\u547D\u5468\u671F",
+  "navigation-guard": "\u5E94\u7528\u4E0E\u751F\u547D\u5468\u671F",
+  analytics: "\u53EF\u89C2\u6D4B\u4E0E\u8C03\u8BD5",
+  log: "\u53EF\u89C2\u6D4B\u4E0E\u8C03\u8BD5",
+  performance: "\u53EF\u89C2\u6D4B\u4E0E\u8C03\u8BD5",
+  // ★2026-09-30 补齐（原 75 条 vs 82 能力 ⇒ 7 个落「其他」；归类依据见文件头注释）
+  update: "\u5E94\u7528\u4E0E\u751F\u547D\u5468\u671F",
+  worker: "\u5E94\u7528\u4E0E\u751F\u547D\u5468\u671F",
+  webassembly: "\u5E94\u7528\u4E0E\u751F\u547D\u5468\u671F",
+  album: "\u5A92\u4F53\u4E0E\u626B\u7801",
+  address: "\u8D26\u53F7\u4E0E\u652F\u4ED8",
+  wifi: "\u7F51\u7EDC\u4E0E\u901A\u4FE1",
+  "we-run": "\u8BBE\u5907\u4E0E\u7CFB\u7EDF",
+  // ★2026-09-30 NC1 首个声明式能力（C83——与设备/屏幕同域）
+  "keep-screen-on": "\u8BBE\u5907\u4E0E\u7CFB\u7EDF",
+  // ★2026-09-30 NC1：C84 文档预览（文件域——预览的是文件）
+  "document-preview": "\u5B58\u50A8\u4E0E\u6587\u4EF6"
+};
+var CAPABILITY_CATEGORY_ORDER = ["\u7F51\u7EDC\u4E0E\u901A\u4FE1", "\u8BBE\u5907\u4E0E\u7CFB\u7EDF", "\u5B58\u50A8\u4E0E\u6587\u4EF6", "\u4F4D\u7F6E\u4E0E\u5730\u56FE", "\u5A92\u4F53\u4E0E\u626B\u7801", "\u8D26\u53F7\u4E0E\u652F\u4ED8", "\u901A\u77E5\u4E0E\u5206\u4EAB", "\u5E94\u7528\u4E0E\u751F\u547D\u5468\u671F", "\u53EF\u89C2\u6D4B\u4E0E\u8C03\u8BD5", "\u5176\u4ED6"];
+function capabilityDomainOf(semanticOrSlug) {
+  const slug = semanticOrSlug.replace(/^capability\./, "");
+  return CAPABILITY_CATEGORY[slug] ?? "\u5176\u4ED6";
+}
+function auditCapabilityDomains(slugs) {
+  return slugs.filter((s) => !(s in CAPABILITY_CATEGORY));
+}
+
 // src/audit.ts
 var MP_COMPONENTS = [
   { mp: "<view>", proteus: "layout.box / layout.stack", status: "ok", group: "component" },
@@ -1409,6 +1749,10 @@ var MP_API_GROUPS = [
   { mp: "wx.onUserTriggerTranslation/onUserOffTranslation\uFF08\u7FFB\u8BD1\uFF09", proteus: "useTranslation", status: "ok", group: "api" },
   { mp: "wx.onGeneratePoster\uFF08\u5206\u4EAB\u6D77\u62A5\uFF09", proteus: "usePoster", status: "ok", group: "api" },
   { mp: "wx.checkDeviceSupportHevc\uFF08\u8BBE\u5907\u80FD\u529B\u63A2\u6D4B\uFF09", proteus: "useDeviceCapability", status: "ok", group: "api" },
+  // ★C82：**超官方清单**能力（官方 301 API 列表里无 wasm）——`WXWebAssembly` 属官方「小程序运行时」
+  //   文档（performance/wasm）确认的运行时能力 ⇒ 矩阵按 mpEquiv 如实登记；
+  //   不进 spec 覆盖度分母（否则分母不变而 covered 虚增，覆盖率失真——见 mp-spec-coverage 注释）
+  { mp: "WXWebAssembly.instantiate\uFF08WebAssembly \u8DE8\u5E73\u53F0\uFF0C\u5B98\u65B9\u6587\u6863 performance/wasm\uFF09", proteus: "useWebAssembly", status: "ok", group: "api" },
   { mp: "wx.getFileSystemManager/*\uFF08\u6587\u4EF6 30+\uFF09", proteus: "useFileSystem", status: "ok", group: "api" },
   { mp: "wx.compressFile/unzip", proteus: "useArchive", status: "ok", group: "api" },
   { mp: "wx.set/get/remove/clearStorage(+Sync)", proteus: "useStorage", status: "ok", group: "api" },
@@ -1773,7 +2117,126 @@ var SPEC_COVERED = {
   onUserOffTranslation: "useTranslation",
   offUserOffTranslation: "useTranslation",
   onGeneratePoster: "usePoster",
-  offGeneratePoster: "usePoster"
+  offGeneratePoster: "usePoster",
+  // ★★2026-09-30 补齐（快照抽取器修泛型缺陷后新可见的 102 个官方 API——
+  //   旧快照结构性漏抽它们 ⇒ 此前从未被归类。逐条证据见 tools 归类记录）
+  authorize: "usePermission",
+  canvasToTempFilePath: "useCanvas",
+  chooseAddress: "useAddress",
+  chooseMedia: "useAlbum",
+  connectWifi: "useWifi",
+  getBatteryInfo: "useBattery",
+  getClipboardData: "useClipboard",
+  getConnectedWifi: "useWifi",
+  getHCEState: "useNFC",
+  getLocation: "useLocation",
+  getNetworkType: "useNetwork",
+  getScreenBrightness: "useBrightness",
+  getSetting: "usePermission",
+  getStorageSync: "useStorage",
+  getWeRunData: "useWeRun",
+  getWifiList: "useWifi",
+  login: "useLogin",
+  makePhoneCall: "usePhoneCall",
+  navigateToMiniProgram: "useMiniProgram",
+  previewMedia: "useAlbum",
+  request: "useFetch",
+  requestPayment: "usePayment",
+  saveImageToPhotosAlbum: "useAlbum",
+  saveVideoToPhotosAlbum: "useAlbum",
+  scanCode: "useQRCode",
+  setClipboardData: "useClipboard",
+  setScreenBrightness: "useBrightness",
+  setStorageSync: "useStorage",
+  startSoterAuthentication: "useBiometric",
+  startWifi: "useWifi",
+  vibrateShort: "useVibrate",
+  requestSubscribeMessage: "useNotification",
+  setWifiList: "useWifi",
+  stopWifi: "useWifi",
+  // ★2026-09-30 NC1：setKeepScreenOn 已由声明式能力 C83 承接（落地后据实由 planned 转 covered）
+  setKeepScreenOn: "useKeepScreenOn",
+  // ★2026-09-30 记账修正：命令式全局提示**早已实现**（`packages/api/src/platform.ts` 的 createUIAPI：
+  //   MP 走 wx.showToast/showLoading；Web 走 DOM 自绘 + SSR console 降级），且有测试
+  //   （tests/platform-api.test.ts「stub wx 时 showToast/showLoading/hideLoading/showModal/
+  //   showActionSheet 转发」）。同一份实现里的 showModal/showActionSheet **早已标 covered**
+  //   ⇒ 这 4 条此前记 planned 属**记账不一致**（非能力缺口）。
+  //   ★形态说明：命令式（走 PlatformAPI.ui）与声明式（p-toast / p-loading 组件）是**两条并存路径**，
+  //     与 showModal（shell.modal 组件）↔ wx.showModal 的关系同构。
+  showToast: "PlatformAPI.ui.showToast\uFF08+ shell.toast / p-toast \u7EC4\u4EF6\uFF09",
+  hideToast: "PlatformAPI.ui\uFF08DOM/wx \u63D0\u793A\u968F showToast \u751F\u547D\u5468\u671F\uFF1B\u7EC4\u4EF6\u8DEF\u5F84\u89C1 p-toast\uFF09",
+  showLoading: "PlatformAPI.ui.showLoading\uFF08+ ui.loading / p-loading \u7EC4\u4EF6\uFF09",
+  // ★2026-09-30 NC1：C84 文档预览落地（声明式桥；MP wx.openDocument / Web window.open）
+  openDocument: "useOpenDocument",
+  hideLoading: "PlatformAPI.ui.hideLoading",
+  batchGetStorage: "useStorage",
+  batchSetStorage: "useStorage",
+  clearStorage: "useStorage",
+  getStorage: "useStorage",
+  setStorage: "useStorage",
+  removeStorage: "useStorage",
+  getStorageInfo: "useStorage",
+  startAccelerometer: "useSensorStream",
+  stopAccelerometer: "useSensorStream",
+  startCompass: "useSensorStream",
+  stopCompass: "useSensorStream",
+  startGyroscope: "useSensorStream",
+  stopGyroscope: "useSensorStream",
+  startLocationUpdate: "useLocation",
+  stopLocationUpdate: "useLocation",
+  startLocationUpdateBackground: "useLocation",
+  openBluetoothAdapter: "useBluetooth",
+  closeBluetoothAdapter: "useBluetooth",
+  getBluetoothAdapterState: "useBluetooth",
+  getBluetoothDevices: "useBluetooth",
+  getConnectedBluetoothDevices: "useBluetooth",
+  createBLEConnection: "useBluetooth",
+  closeBLEConnection: "useBluetooth",
+  getBLEDeviceCharacteristics: "useBluetooth",
+  getBLEDeviceServices: "useBluetooth",
+  getBLEDeviceRSSI: "useBluetooth",
+  getBLEMTU: "useBluetooth",
+  setBLEMTU: "useBluetooth",
+  isBluetoothDevicePaired: "useBluetooth",
+  makeBluetoothPair: "useBluetooth",
+  notifyBLECharacteristicValueChange: "useBluetooth",
+  readBLECharacteristicValue: "useBluetooth",
+  writeBLECharacteristicValue: "useBluetooth",
+  startBluetoothDevicesDiscovery: "useBluetooth",
+  stopBluetoothDevicesDiscovery: "useBluetooth",
+  openSystemBluetoothSetting: "useBluetooth",
+  closeSocket: "useWebSocket",
+  sendSocketMessage: "useWebSocket",
+  getBeacons: "useBeacon",
+  startBeaconDiscovery: "useBeacon",
+  stopBeaconDiscovery: "useBeacon",
+  startLocalServiceDiscovery: "useLocalService",
+  stopLocalServiceDiscovery: "useLocalService",
+  startHCE: "useNFC",
+  stopHCE: "useNFC",
+  sendHCEMessage: "useNFC",
+  checkIsSupportSoterAuthentication: "useBiometric",
+  checkIsSoterEnrolledInDevice: "useBiometric",
+  chooseImage: "useAlbum",
+  chooseVideo: "useAlbum",
+  previewImage: "useAlbum",
+  compressImage: "useMediaProcessing",
+  compressVideo: "useMediaProcessing",
+  getAvailableAudioSources: "useAudio",
+  setInnerAudioOption: "useAudio",
+  vibrateLong: "useVibrate",
+  hideKeyboard: "useKeyboard",
+  openSetting: "usePermission",
+  openAppAuthorizeSetting: "usePermission",
+  addPhoneRepeatCalendar: "useCalendarAPI",
+  navigateTo: "useRouter/useRoute\uFF08packages/router\uFF09",
+  navigateBack: "useRouter/useRoute\uFF08packages/router\uFF09",
+  redirectTo: "useRouter/useRoute\uFF08packages/router\uFF09",
+  reLaunch: "useRouter/useRoute\uFF08packages/router\uFF09",
+  switchTab: "useRouter/useRoute\uFF08packages/router\uFF09",
+  showModal: "shell.modal\uFF08p-modal \u7EC4\u4EF6\uFF09",
+  showActionSheet: "shell.action-sheet\uFF08p-action-sheet \u7EC4\u4EF6\uFF09",
+  getSelectedTextRange: "ui.selection\uFF08p-selection \u7EC4\u4EF6\uFF09"
 };
 var SPEC_PRIVATE = /* @__PURE__ */ new Set([
   // 支付 / 交通卡 / 离线支付
@@ -1881,7 +2344,50 @@ var SPEC_PRIVATE = /* @__PURE__ */ new Set([
   // 小程序归属 / 开屏广告 / XR 系统（微信私有）
   "checkIsAddedToMyMiniProgram",
   "getShowSplashAdStatus",
-  "getXrFrameSystem"
+  "getXrFrameSystem",
+  // ★★2026-09-30 补齐（新可见 36 条——微信生态独占：卡券/红包/订单支付/发票/车牌/POI/
+  //   群工具与群分享/VoIP/收藏/后台周期拉取/分享菜单控制/小程序返回链/提示更新微信）
+  "addCard",
+  "openCard",
+  "showRedPackage",
+  "requestOrderPayment",
+  "chooseInvoice",
+  "chooseInvoiceTitle",
+  "chooseLicensePlate",
+  "chooseLocation",
+  "choosePoi",
+  "getChatToolInfo",
+  "openChatTool",
+  "notifyGroupMembers",
+  "selectGroupMembers",
+  "shareAppMessageToGroup",
+  "shareEmojiToGroup",
+  "shareFileMessage",
+  "shareFileToGroup",
+  "shareImageToGroup",
+  "shareVideoMessage",
+  "shareVideoToGroup",
+  "shareToWeRun",
+  "subscribeVoIPVideoMembers",
+  "updateVoIPChatMuteConfig",
+  "exitVoIPChat",
+  "addFileToFavorites",
+  "addVideoToFavorites",
+  "hideShareMenu",
+  "showShareMenu",
+  "updateShareMenu",
+  "showShareImageMenu",
+  "navigateBackMiniProgram",
+  "updateWeChatApp",
+  "openLocation",
+  "getBackgroundFetchData",
+  "getBackgroundFetchToken",
+  "setBackgroundFetchToken",
+  // ★2026-09-30 归类修正：这两条依赖**微信生态上下文**（聊天会话选文件 / 微信授权头像昵称），
+  //   与 Web/App 无共同语义 ⇒ 属「微信独占」而非「通用缺口」（重分类前误记 planned——那会虚增
+  //   缺口数并误导 NC2 排期去做"跨端对等"，而它本质上没有对等物）
+  "chooseMessageFile",
+  "getUserProfile"
 ]);
 var SPEC_NA = /* @__PURE__ */ new Set([
   // 废弃路由事件（wx.router 前身）
@@ -1903,7 +2409,41 @@ var SPEC_NA = /* @__PURE__ */ new Set([
   // 系统信息旧版（新工程用 getWindowInfo/getDeviceInfo/getAppBaseInfo）
   "getSystemInfoAsync",
   // 调度原语（Vue nextTick / 渲染器调度等价，非平台能力）
-  "nextTick"
+  "nextTick",
+  // ★★2026-09-30 补齐（新可见 33 条——已废弃/构建期/被语义原语消灭/宿主层；逐组见注释）
+  "checkSession",
+  "getShareInfo",
+  "getUserInfo",
+  "getSystemInfo",
+  "setEnableDebug",
+  "playVoice",
+  "pauseVoice",
+  "stopVoice",
+  "startRecord",
+  "stopRecord",
+  "playBackgroundAudio",
+  "pauseBackgroundAudio",
+  "stopBackgroundAudio",
+  "seekBackgroundAudio",
+  "getBackgroundAudioPlayerState",
+  "getExtConfig",
+  "loadFontFace",
+  "setNavigationBarTitle",
+  "setNavigationBarColor",
+  "showNavigationBarLoading",
+  "hideNavigationBarLoading",
+  "setTopBarText",
+  "hideHomeButton",
+  "showTabBar",
+  "hideTabBar",
+  "setTabBarBadge",
+  "removeTabBarBadge",
+  "setTabBarItem",
+  "setTabBarStyle",
+  "showTabBarRedDot",
+  "hideTabBarRedDot",
+  "setBackgroundColor",
+  "setBackgroundTextStyle"
 ]);
 var SPEC_PLANNED = {
   // 网络底层（已由 C69 useSocket 覆盖——见 SPEC_COVERED）
@@ -1916,6 +2456,24 @@ var SPEC_PLANNED = {
   // 缓存管理 / 窗口 / 卸载拦截（已由 C72/C74/C75 覆盖——见 SPEC_COVERED）
   // 调度（已由 C73 useIdle 覆盖——见 SPEC_COVERED）
   // 设备能力探测（已由 C81 useDeviceCapability 覆盖——见 SPEC_COVERED）
+  // ★C82 WebAssembly：**不在官方 301 API 清单内**（`WXWebAssembly` 属「小程序运行时」文档章节，
+  //   非「API」章节）⇒ **不进 SPEC_COVERED**：那会让 covered 分子虚增而分母不变 ⇒ 覆盖率虚高。
+  //   也不进 SPEC_PRIVATE（它是**公开能力**，不是微信私有 API）
+  //   ⇒ 归类为「超清单能力」，由 primitives C82 直接承载（矩阵见 audit.ts）
+  // ★★2026-09-30 补齐（新可见 21 条——真实缺口，NC2「内置能力扩充」候选输入）
+  addPhoneContact: "\u901A\u8BAF\u5F55\u5199\u5165\uFF08\u65E0\u5BF9\u7B49 Hook\uFF09",
+  canvasGetImageData: "\u753B\u5E03\u50CF\u7D20\u8BFB\u53D6\uFF08CanvasContext \u65E0\u6B64\u65B9\u6CD5\u2014\u2014\u89C1 capability.ts CanvasContext\uFF09",
+  canvasPutImageData: "\u753B\u5E03\u50CF\u7D20\u5199\u5165\uFF08\u540C\u4E0A\uFF09",
+  checkIsOpenAccessibility: "\u65E0\u969C\u788D\u5F00\u5173\u63A2\u6D4B\uFF08\u65E0\u5BF9\u7B49\uFF09",
+  createBLEPeripheralServer: "\u84DD\u7259\u5916\u8BBE\u6A21\u5F0F\uFF08\u65E0\u5BF9\u7B49\uFF09",
+  getImageInfo: "\u56FE\u7247\u5143\u4FE1\u606F\uFF08\u5BBD\u9AD8/\u65B9\u5411\u2014\u2014useFileSystem \u53EA\u7ED9 size/digest\uFF09",
+  getVideoInfo: "\u89C6\u9891\u5143\u4FE1\u606F\uFF08\u540C\u4E0A\u65CF\uFF09",
+  getRandomValues: "\u5BC6\u7801\u5B66\u968F\u673A\u6570\uFF08Web \u7AEF\u6709 crypto.getRandomValues\u2014\u2014\u5BBF\u4E3B\u672A\u63A5\u7EBF\uFF09",
+  pageScrollTo: "\u9875\u9762\u7EA7\u6EDA\u52A8\uFF08p-scroll \u53EA\u7BA1\u7EC4\u4EF6\u5185\u6EDA\u52A8\uFF09",
+  startPullDownRefresh: "\u9875\u9762\u7EA7\u4E0B\u62C9\u5237\u65B0\uFF08p-scroll refresher \u53EA\u7BA1 scroll-view\uFF09",
+  stopPullDownRefresh: "\u9875\u9762\u7EA7\u4E0B\u62C9\u5237\u65B0\uFF08\u540C\u4E0A\uFF09",
+  startDeviceMotionListening: "\u8BBE\u5907\u8FD0\u52A8\u76D1\u542C\uFF08\u878D\u5408\u4F20\u611F\u5668\u2014\u2014\u5F53\u524D\u4EC5\u4E09\u8F74\u5355\u9879\uFF09",
+  stopDeviceMotionListening: "\u8BBE\u5907\u8FD0\u52A8\u76D1\u542C\uFF08\u540C\u4E0A\uFF09"
 };
 var EVENT_BASE = {
   // 映射既有 Hook（covered）
@@ -2129,10 +2687,26 @@ var SPEC_RATCHET = {
   //   原标 covered 且引用 `gesture.draggable`（拖拽）——引用错位 + MP 无对等（bindtap 不带 count）
   //   ⇒ 据实转 planned。**真实可运行的等价物一件没少**，只是不再把「仅 Web 成立」记成「两端已落地」。
   //   该条即上次注释要求「因诚实性修正需下调时，必须写明被修正的具体条目」所指的条目。
-  coveredMin: 252,
-  // 2026-09-18 上行基线（250 修正基线 + tap/longpress 落地）；2026-09-19 因 double-tap 修正后实测亦为 252
+  coveredMin: 362,
+  // ★2026-09-30 上调 252 → 356（修标尺）→ 357（C83）→ 361（4 条命令式提示：记账修正）→ **362**（C84 文档预览落地）
   gapMax: 0
   // 全部官方项必须归类
+  // ★★2026-09-30：抽标尺修复后的水位重锁（**性质：修的是尺子，不是能力**——必须写清楚）
+  //   起因：快照抽取器（scripts/gen-mp-spec.mjs）的 API 正则不认**泛型方法签名** `name<T>(...)`
+  //   ⇒ 197 个真实官方 API（含 `wx.request` / `wx.login` / `wx.authorize` / `wx.getStorageSync` /
+  //   `wx.chooseMedia` / `wx.setKeepScreenOn` 等**最核心的一批**）**从未进入权威标尺**：
+  //   分母被截短 40%（298 vs 实际 495）。
+  //   后果有两面：① 这些 API 的缺口**结构性不可见**（gap=0 是假的——根本没在表里）；
+  //   ② 报表里的「官方 N 项」本身是错的。
+  //   ✅ 修复后：官方 579 项（组件 84 · API 495）；covered 356 / planned 25 / private 145 / na 53 / gap 0。
+  //   ★为什么 covered **大幅上涨**（252→356）却不是"能力增长"：新增可见的 197 项里，
+  //     **104 项**（102 新归类 + 2 由既有规则命中）经逐条取证确认**已有承接**——证据见下方各表
+  //     分组注释（严格口径 = 剥注释后匹配 `wx.<name>(` 或同族动态派发，非"看起来像"）；
+  //     private +39 · na +33 · planned +21 —— 合计 197。它们是**此前没被记账的既有覆盖**。
+  //     这是"修尺子"带来的**账面**变化：真实可运行的等价物一件没多也没少。
+  //   ★planned 在后续批次中逐条转出（C83 落地 + 命令式提示 4 条记账修正）——当前值见棘轮注释
+  //     —— 它们是 NC2「内置能力扩充」的候选输入（**保守归类**：拿不准一律 planned，不虚标 covered）。
+  //   ★附加修复：抽取范围原为「`interface Wx {` 起 → 文件尾」（未设边界，靠缩进巧合）⇒ 改为括号配对。
 };
 
 // src/degradation.ts
@@ -2334,6 +2908,77 @@ function collectPropDiagnostics(tag, props, end, table = DEGRADATION_TABLE) {
   return out;
 }
 
+// src/color.ts
+function rgbOfColor(color) {
+  if (color === void 0 || color === null) return null;
+  const c = color.trim().toLowerCase();
+  const h3 = /^#([0-9a-f])([0-9a-f])([0-9a-f])[0-9a-f]?$/.exec(c);
+  if (h3 !== null) {
+    return [parseInt(h3[1] + h3[1], 16), parseInt(h3[2] + h3[2], 16), parseInt(h3[3] + h3[3], 16)];
+  }
+  const h6 = /^#([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})?$/.exec(c);
+  if (h6 !== null) {
+    return [parseInt(h6[1], 16), parseInt(h6[2], 16), parseInt(h6[3], 16)];
+  }
+  const m = /^rgba?\(([^)]*)\)$/.exec(c);
+  if (m !== null) {
+    const parts = m[1].split(",").map((t) => Number(t.trim()));
+    if (parts.length >= 3 && parts.slice(0, 3).every((n) => Number.isFinite(n))) {
+      return [parts[0], parts[1], parts[2]];
+    }
+  }
+  return null;
+}
+function isNeutralColor(color) {
+  const rgb = rgbOfColor(color);
+  if (rgb === null) return false;
+  return rgb[0] === rgb[1] && rgb[1] === rgb[2];
+}
+function isOpaqueColor(color) {
+  if (color === void 0 || color === null) return false;
+  const c = color.trim().toLowerCase();
+  if (c === "") return false;
+  if (c === "transparent") return false;
+  if (/^#[0-9a-f]{3}$/.test(c) || /^#[0-9a-f]{6}$/.test(c)) return true;
+  if (/^#[0-9a-f]{4}$/.test(c)) return c[4] === "f";
+  if (/^#[0-9a-f]{8}$/.test(c)) return c.slice(7) === "ff";
+  const m = /^rgba?\(([^)]*)\)$/.exec(c);
+  if (m !== null) {
+    const parts = m[1].split(",").map((t) => t.trim());
+    if (parts.length === 3) return true;
+    if (parts.length === 4) {
+      const a = Number(parts[3]);
+      return Number.isFinite(a) && a >= 1;
+    }
+  }
+  return false;
+}
+
+// src/paint-hint.ts
+function derivePaintHint(input) {
+  const {
+    hasText,
+    textColor,
+    backgroundColor,
+    hasBackgroundImage = false,
+    hasBorderRadius = false,
+    hasBorderWidth = false,
+    opacity,
+    needsCompositing = false,
+    hasTransform = false
+  } = input;
+  const opacityIsOne = opacity === void 0 || opacity === 1;
+  return {
+    isMonochrome: !!(hasText && isOpaqueColor(textColor) && isNeutralColor(textColor) && // ★灰度格式的硬约束（见上方说明）
+    !backgroundColor && !hasBackgroundImage && !hasBorderRadius && opacityIsOne && !needsCompositing),
+    isPureBackground: !!(isOpaqueColor(backgroundColor) && !hasBackgroundImage && !hasBorderWidth && !hasBorderRadius && !needsCompositing && !hasTransform && !hasText && // ★本字段 = "只有一块底色要画"
+    opacityIsOne),
+    // 由树级分析填充（本函数只管单节点）
+    staticSubtree: false,
+    needsCompositingLayer: needsCompositing
+  };
+}
+
 // src/pnode-style.ts
 function resolveLength(raw, ctx = { axis: "horizontal" }) {
   const v = raw.trim().toLowerCase();
@@ -2734,15 +3379,17 @@ function normalizeStyleDecls(decls, opts = {}) {
     }
   }
   const hasText = Object.keys(text).length > 0;
-  const paintHint = {
-    // 单色文本 → 紧凑 backing store 格式（实测 −39% 内存）
-    isMonochrome: !!(hasText && text.color && !paint.backgroundImage && !needsCompositing),
-    // 纯色背景 → 走 backgroundColor 通道、**不分配 backing store**（实测：仅色块 4.9MB vs 带文本 186.7MB）
-    isPureBackground: !!paint.backgroundColor && !paint.backgroundImage && !paint.borderWidth && !paint.borderRadius && !needsCompositing && !hasTransform && (paint.opacity === void 0 || paint.opacity === 1),
-    // 由树级分析填充（本函数只管单节点）
-    staticSubtree: false,
-    needsCompositingLayer: needsCompositing
-  };
+  const paintHint = derivePaintHint({
+    hasText,
+    textColor: text.color,
+    backgroundColor: paint.backgroundColor,
+    hasBackgroundImage: paint.backgroundImage !== void 0,
+    hasBorderRadius: paint.borderRadius !== void 0,
+    hasBorderWidth: paint.borderWidth !== void 0,
+    opacity: paint.opacity,
+    needsCompositing,
+    hasTransform
+  });
   return {
     props: {
       layout,
@@ -2838,6 +3485,95 @@ function groupBindingsByNode(bindings) {
   return out;
 }
 
+// ../slot-runtime/src/anim-curve.ts
+var AnimCurve = {
+  LINEAR: 0,
+  EASE_OUT_CUBIC: 1,
+  EASE_IN_CUBIC: 2,
+  EASE_IN_OUT_CUBIC: 3,
+  SPRING_APPROX: 4
+};
+var TABLE_N = 65;
+function springApprox(u) {
+  return 1 - Math.exp(-6 * u) * Math.cos(10 * u);
+}
+function buildTable(curve) {
+  const t = new Float64Array(TABLE_N);
+  for (let i = 0; i < TABLE_N; i++) {
+    const u = i / (TABLE_N - 1);
+    t[i] = curve === AnimCurve.EASE_OUT_CUBIC ? 1 - (1 - u) ** 3 : curve === AnimCurve.EASE_IN_CUBIC ? u ** 3 : curve === AnimCurve.EASE_IN_OUT_CUBIC ? u < 0.5 ? 4 * u ** 3 : 1 - (-2 * u + 2) ** 3 / 2 : curve === AnimCurve.SPRING_APPROX ? springApprox(u) : u;
+  }
+  t[0] = 0;
+  t[TABLE_N - 1] = 1;
+  return t;
+}
+var TABLES = [
+  buildTable(AnimCurve.LINEAR),
+  buildTable(AnimCurve.EASE_OUT_CUBIC),
+  buildTable(AnimCurve.EASE_IN_CUBIC),
+  buildTable(AnimCurve.EASE_IN_OUT_CUBIC),
+  buildTable(AnimCurve.SPRING_APPROX)
+];
+
+// ../slot-runtime/src/expr.ts
+var PURE_CALLS = {
+  // —— Math（纯计算）——
+  "Math.abs": Math.abs,
+  "Math.ceil": Math.ceil,
+  "Math.floor": Math.floor,
+  "Math.round": Math.round,
+  "Math.trunc": Math.trunc,
+  "Math.sign": Math.sign,
+  "Math.sqrt": Math.sqrt,
+  "Math.cbrt": Math.cbrt,
+  "Math.pow": Math.pow,
+  "Math.exp": Math.exp,
+  "Math.log": Math.log,
+  "Math.log2": Math.log2,
+  "Math.log10": Math.log10,
+  "Math.min": Math.min,
+  "Math.max": Math.max,
+  // —— 类型转换（call 形态，非 new）——
+  "String": String,
+  "Number": Number,
+  "Boolean": Boolean,
+  // —— 解析 / 判定（全局）——
+  "parseInt": parseInt,
+  "parseFloat": parseFloat,
+  "isNaN": isNaN,
+  "isFinite": isFinite,
+  "Number.isFinite": Number.isFinite,
+  "Number.isInteger": Number.isInteger,
+  "Number.isNaN": Number.isNaN,
+  // —— 数组判定 ——
+  "Array.isArray": Array.isArray
+};
+var GLOBAL_CONST_MEMBERS = {
+  "Math.PI": Math.PI,
+  "Math.E": Math.E,
+  "Math.LN2": Math.LN2,
+  "Math.LN10": Math.LN10,
+  "Math.LOG2E": Math.LOG2E,
+  "Math.LOG10E": Math.LOG10E,
+  "Math.SQRT2": Math.SQRT2,
+  "Math.SQRT1_2": Math.SQRT1_2,
+  "Number.MAX_SAFE_INTEGER": Number.MAX_SAFE_INTEGER,
+  "Number.MIN_SAFE_INTEGER": Number.MIN_SAFE_INTEGER,
+  "Number.EPSILON": Number.EPSILON,
+  "Number.MAX_VALUE": Number.MAX_VALUE,
+  "Number.MIN_VALUE": Number.MIN_VALUE
+};
+
+// ../slot-runtime/src/directives.ts
+var HOST_DIRECTIVE_SPECS = {
+  animate: {
+    argKind: "anim-preset",
+    argHint: "\u52A8\u753B\u9884\u8BBE\uFF08fade / slide-up / slide-down / slide-left / slide-right / zoom / fade-slide-up\uFF09",
+    desc: "\u503C\u53D8\u5316\uFF08\u6216\u9996\u6B21\u6C42\u503C\u4E3A\u771F\uFF09\u65F6\u5728\u8BE5\u8282\u70B9**\u64AD\u4E00\u6B21**\u9884\u8BBE\u52A8\u753B\uFF08\u8D70\u5185\u6838\u52A8\u753B\u901A\u9053\uFF0C\u4E0E <Transition> \u540C\u4E00\u5957\uFF09\u3002\u8BED\u4E49\u5BF9\u9F50\uFF1A\u6307\u4EE4\u7684 mounted\uFF08\u9996\u8BC4 truthy \u5373\u64AD\uFF09\u4E0E updated\uFF08\u503C\u53D8\u5316\u5373\u64AD\uFF09\u3002"
+  }
+};
+var HOST_DIRECTIVE_NAMES = Object.keys(HOST_DIRECTIVE_SPECS);
+
 // src/pnode-build.ts
 function kindFromSemantic(semantic, tag) {
   const s = semantic ?? "";
@@ -3016,6 +3752,8 @@ function walkPTree(roots, visit) {
   walk(roots, 0);
 }
 export {
+  CAPABILITY_CATEGORY,
+  CAPABILITY_CATEGORY_ORDER,
   COMPONENT_IR_SCHEMA,
   DEFAULT_DESIGN_WIDTH,
   DEGRADATION_TABLE,
@@ -3038,6 +3776,7 @@ export {
   TAG_SEMANTIC_ALIASES,
   TAG_SEMANTIC_MAP,
   analyzePTree,
+  auditCapabilityDomains,
   auditCatalogConsistency,
   auditDegradation,
   auditMatrixReferences,
@@ -3047,6 +3786,7 @@ export {
   buildPTree,
   buildPTreeFromComponentIR,
   camel,
+  capabilityDomainOf,
   checkComponentSnapshot,
   checkPrimitiveCatalog,
   checkPropDegradation,
@@ -3058,6 +3798,7 @@ export {
   decisionOf,
   degradationOf,
   degradeProp,
+  derivePaintHint,
   expandEdges,
   extractSemanticTree,
   flattenRate,
@@ -3069,6 +3810,8 @@ export {
   implementedPrimitives,
   inferOpCode,
   inferUpdateKind,
+  isNeutralColor,
+  isOpaqueColor,
   kindFromSemantic,
   mapSemanticToBackend,
   normalizeStyleDecls,
@@ -3080,6 +3823,7 @@ export {
   primitiveByTag,
   rawFromComponentIR,
   resolveLength,
+  rgbOfColor,
   splitTopLevel,
   toComponentIR,
   toComponentTree,

package/dist/paint-hint.d.ts

@@ -0,0 +1,40 @@
+import type { PaintHint } from './pnode';
+/** 推导输入（**已解析的原始值**——两条调用方都容易提供，不需要先归一化成 PaintProps） */
+export interface PaintHintInput {
+    /** 该节点是否有文本要画（有字形就有存储需求） */
+    hasText: boolean;
+    /** 文本颜色（CSS 颜色串；未设置 = undefined） */
+    textColor?: string | null;
+    /** 背景色（CSS 颜色串） */
+    backgroundColor?: string | null;
+    /** 是否有背景图/渐变（复合绘制 —— 任何"只有一块底色"的策略都不成立） */
+    hasBackgroundImage?: boolean;
+    /** 是否有圆角（圆角要保留 alpha 边缘） */
+    hasBorderRadius?: boolean;
+    /** 是否有边框（边框是第二处绘制） */
+    hasBorderWidth?: boolean;
+    /** 层透明度（< 1 需要 alpha 合成） */
+    opacity?: number;
+    /** 是否落入 L3 合成层（z-index/fixed/filter/shadow/3D） */
+    needsCompositing?: boolean;
+    /** 是否有 transform（2D/3D 变换 ⇒ 需要独立合成） */
+    hasTransform?: boolean;
+}
+/**
+ * 推导 paint-hint。
+ *
+ * 【字段语义与各自的**完整**条件】
+ * · `isMonochrome`：可对文本层用**紧凑单通道存储**（iOS `contentsFormat = .gray8Uint`，实测 −39%）。
+ *   要求：有文本 + 文本色**确定不透明** + **颜色是中性色**（灰度格式无彩色通道！）
+ *        + 无底色/背景图（否则是两种颜色）+ 无圆角/透明度（紧凑格式无 alpha 边缘）
+ *        + 非合成层。
+ *   ★"中性色"这一条是**格式的硬约束**而非保守选择：8 位灰度**表达不了色相**，
+ *     红字写进 gray8Uint 会变灰。−39% 的实验用的是白字，故这一条在实验里**恰好成立**、
+ *     但从未被写进判据——若不补，彩色文本会被静默去色。
+ * · `isPureBackground`：**该层只有一块底色要画**（走 backgroundColor 通道，不分配存储）。
+ *   要求：底色确定不透明 + 无背景图 + 无边框/圆角 + 非合成 + 无 transform + 不透明
+ *        + **没有文本**（有字形就必须有存储——这条此前缺失）。
+ * · `staticSubtree`：由树级分析填充（本函数不管）。
+ * · `needsCompositingLayer`：直传。
+ */
+export declare function derivePaintHint(input: PaintHintInput): PaintHint;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proteus-vue/component-ir",
-  "version": "0.3.0-beta.21",
+  "version": "0.3.0-beta.28",
   "description": "G-31 组件与 API 语义化（component-semantics-plan B1）：Component IR（C-IR）schema + 属性约束校验 + semantic 映射——组件=语义、属性=约束、Backend 消费 semantic 而非 tag（零依赖纯逻辑）",
   "type": "module",
   "license": "Apache-2.0",
@@ -19,8 +19,8 @@
     "README.md"
   ],
   "dependencies": {
-    "@proteus-vue/contracts": "0.3.0-beta.11",
-    "@proteus-vue/slot-runtime": "0.3.0-beta.11"
+    "@proteus-vue/contracts": "0.3.0-beta.28",
+    "@proteus-vue/slot-runtime": "0.3.0-beta.28"
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json --emitDeclarationOnly && esbuild src/index.ts --bundle --format=esm --platform=neutral --outfile=dist/index.js"