@byteluck-fe/model-driven-core 7.1.0-beta.2 → 7.1.0-beta.4

package/README.md

@@ -8,6 +8,8 @@
 
 `@byteluck-fe/model-driven-core/contracts` 只导出版本、诊断和页面模型类型，不引用 Vue、DOM 或接口。Designer、Runtime 与 FDE 应从这里共享 `HeadlessControlNode`、`CompilePageModelInput/Result`、`ValidateSavedPageModelChangeInput` 和 build-info 契约；版本不一致时由编译或页面差分入口返回始终阻断的兼容性诊断。
 
+`MODEL_DRIVEN_CAPABILITIES` 用稳定 feature 与精确版本声明整条 model-driven 发布列车提供的能力，例如 Runtime 历史缺失默认、增量页面校验、authoring facts 与属性 Patch 计划。宿主用 `admitModelDrivenCapabilities` 显式校验所需能力；版本不做 semver 推断。该 build info 是 release-train 声明，不代表只安装/导入 core 就包含 controls 或 driven 的实现，core-only 消费者仍须安装对应同列车子包并从其公开子入口调用。
+
 `HeadlessRuntimeOptions.locale` 接受任意非空字符串；调用方可提供当前语言的扁平 `localeMessages` 或同步 `resolveLocaleMessage`，公共层不会读取全局 i18n 或访问接口。
 
 ```

package/dist/contracts/index.js

@@ -1 +1 @@
-"use strict";var n=Object.defineProperty;var E=Object.getOwnPropertySymbols;var O=Object.prototype.hasOwnProperty,s=Object.prototype.propertyIsEnumerable;var _=(t,e,o)=>e in t?n(t,e,{enumerable:!0,configurable:!0,writable:!0,value:o}):t[e]=o,r=(t,e)=>{for(var o in e||(e={}))O.call(e,o)&&_(t,o,e[o]);if(E)for(var o of E(e))s.call(e,o)&&_(t,o,e[o]);return t};Object.defineProperty(exports,"__esModule",{value:!0});const MODEL_DRIVEN_PACKAGE_VERSION="7.1.0-beta.2",CURRENT_PAGE_SCHEMA_VERSION="3.16",HEADLESS_COMPILER_CONTRACT_VERSION="model-driven.headless.v2",CONTROL_CATALOG_SCHEMA_VERSION="model-driven.control-catalog.v1",MODEL_DRIVEN_BUILD_INFO=Object.freeze({packageVersion:MODEL_DRIVEN_PACKAGE_VERSION,pageSchemaVersion:CURRENT_PAGE_SCHEMA_VERSION,compilerContractVersion:HEADLESS_COMPILER_CONTRACT_VERSION,catalogSchemaVersion:CONTROL_CATALOG_SCHEMA_VERSION});function getModelDrivenBuildInfo(){return r({},MODEL_DRIVEN_BUILD_INFO)}function createModelDrivenDiagnostic(t){return r({},t)}exports.CONTROL_CATALOG_SCHEMA_VERSION=CONTROL_CATALOG_SCHEMA_VERSION,exports.CURRENT_PAGE_SCHEMA_VERSION=CURRENT_PAGE_SCHEMA_VERSION,exports.HEADLESS_COMPILER_CONTRACT_VERSION=HEADLESS_COMPILER_CONTRACT_VERSION,exports.MODEL_DRIVEN_BUILD_INFO=MODEL_DRIVEN_BUILD_INFO,exports.MODEL_DRIVEN_PACKAGE_VERSION=MODEL_DRIVEN_PACKAGE_VERSION,exports.createModelDrivenDiagnostic=createModelDrivenDiagnostic,exports.getModelDrivenBuildInfo=getModelDrivenBuildInfo;
+"use strict";var f=Object.defineProperty,_=Object.defineProperties;var u=Object.getOwnPropertyDescriptors;var s=Object.getOwnPropertySymbols;var O=Object.prototype.hasOwnProperty,p=Object.prototype.propertyIsEnumerable;var c=(t,n,r)=>n in t?f(t,n,{enumerable:!0,configurable:!0,writable:!0,value:r}):t[n]=r,i=(t,n)=>{for(var r in n||(n={}))O.call(n,r)&&c(t,r,n[r]);if(s)for(var r of s(n))p.call(n,r)&&c(t,r,n[r]);return t},l=(t,n)=>_(t,u(n));Object.defineProperty(exports,"__esModule",{value:!0});const MODEL_DRIVEN_PACKAGE_VERSION="7.1.0-beta.4",CURRENT_PAGE_SCHEMA_VERSION="3.16",HEADLESS_COMPILER_CONTRACT_VERSION="model-driven.headless.v2",CONTROL_CATALOG_SCHEMA_VERSION="model-driven.control-catalog.v1",MODEL_DRIVEN_FEATURES=Object.freeze({runtimeAbsentDefaults:"model-driven.runtime-absent-defaults",incrementalPageValidation:"model-driven.incremental-page-validation",controlAuthoringFacts:"model-driven.control-authoring-facts",controlPropertyPatchPlan:"model-driven.control-property-patch-plan"}),MODEL_DRIVEN_CAPABILITIES=Object.freeze([Object.freeze({feature:MODEL_DRIVEN_FEATURES.runtimeAbsentDefaults,version:"1"}),Object.freeze({feature:MODEL_DRIVEN_FEATURES.incrementalPageValidation,version:"1"}),Object.freeze({feature:MODEL_DRIVEN_FEATURES.controlAuthoringFacts,version:"1"}),Object.freeze({feature:MODEL_DRIVEN_FEATURES.controlPropertyPatchPlan,version:"1"})]);function nonEmptyCapabilityPart(t){return typeof t=="string"&&t.trim().length>0}function admitModelDrivenCapabilities(t){const n=new Map;for(const e of t.available||[]){if(!e||!nonEmptyCapabilityPart(e.feature)||!nonEmptyCapabilityPart(e.version))continue;const o=n.get(e.feature)||new Set;o.add(e.version),n.set(e.feature,o)}const r=new Map;for(const e of t.required||[]){if(!e)continue;const o=JSON.stringify([e.feature,e.version]);r.set(o,e)}const a=[...r.values()].sort((e,o)=>`${String(e.feature)}\0${String(e.version)}`.localeCompare(`${String(o.feature)}\0${String(o.version)}`)).flatMap(e=>{const o=nonEmptyCapabilityPart(e.feature)?[...n.get(e.feature)||[]].sort():[],E=nonEmptyCapabilityPart(e.version)?e.version:String(e.version||"");return nonEmptyCapabilityPart(e.feature)&&nonEmptyCapabilityPart(e.version)&&o.includes(e.version)?[]:[{feature:nonEmptyCapabilityPart(e.feature)?e.feature:String(e.feature||""),requiredVersion:E,availableVersions:o,reason:o.length===0?"missing":"version-mismatch"}]});return{ok:a.length===0,issues:a}}const MODEL_DRIVEN_BUILD_INFO=Object.freeze({packageVersion:MODEL_DRIVEN_PACKAGE_VERSION,pageSchemaVersion:CURRENT_PAGE_SCHEMA_VERSION,compilerContractVersion:HEADLESS_COMPILER_CONTRACT_VERSION,catalogSchemaVersion:CONTROL_CATALOG_SCHEMA_VERSION,capabilities:MODEL_DRIVEN_CAPABILITIES});function getModelDrivenBuildInfo(){return l(i({},MODEL_DRIVEN_BUILD_INFO),{capabilities:MODEL_DRIVEN_BUILD_INFO.capabilities.map(t=>i({},t))})}function createModelDrivenDiagnostic(t){return i({},t)}exports.CONTROL_CATALOG_SCHEMA_VERSION=CONTROL_CATALOG_SCHEMA_VERSION,exports.CURRENT_PAGE_SCHEMA_VERSION=CURRENT_PAGE_SCHEMA_VERSION,exports.HEADLESS_COMPILER_CONTRACT_VERSION=HEADLESS_COMPILER_CONTRACT_VERSION,exports.MODEL_DRIVEN_BUILD_INFO=MODEL_DRIVEN_BUILD_INFO,exports.MODEL_DRIVEN_CAPABILITIES=MODEL_DRIVEN_CAPABILITIES,exports.MODEL_DRIVEN_FEATURES=MODEL_DRIVEN_FEATURES,exports.MODEL_DRIVEN_PACKAGE_VERSION=MODEL_DRIVEN_PACKAGE_VERSION,exports.admitModelDrivenCapabilities=admitModelDrivenCapabilities,exports.createModelDrivenDiagnostic=createModelDrivenDiagnostic,exports.getModelDrivenBuildInfo=getModelDrivenBuildInfo;

package/dist/contracts/index.mjs

@@ -1 +1 @@
-var s=Object.defineProperty;var c=Object.getOwnPropertySymbols;var R=Object.prototype.hasOwnProperty,l=Object.prototype.propertyIsEnumerable;var r=(n,e,o)=>e in n?s(n,e,{enumerable:!0,configurable:!0,writable:!0,value:o}):n[e]=o,t=(n,e)=>{for(var o in e||(e={}))R.call(e,o)&&r(n,o,e[o]);if(c)for(var o of c(e))l.call(e,o)&&r(n,o,e[o]);return n};const E="7.1.0-beta.2",_="3.16",a="model-driven.headless.v2",i="model-driven.control-catalog.v1",O=Object.freeze({packageVersion:E,pageSchemaVersion:_,compilerContractVersion:a,catalogSchemaVersion:i});function C(){return t({},O)}function I(n){return t({},n)}export{i as CONTROL_CATALOG_SCHEMA_VERSION,_ as CURRENT_PAGE_SCHEMA_VERSION,a as HEADLESS_COMPILER_CONTRACT_VERSION,O as MODEL_DRIVEN_BUILD_INFO,E as MODEL_DRIVEN_PACKAGE_VERSION,I as createModelDrivenDiagnostic,C as getModelDrivenBuildInfo};
+var S=Object.defineProperty,_=Object.defineProperties;var d=Object.getOwnPropertyDescriptors;var f=Object.getOwnPropertySymbols;var V=Object.prototype.hasOwnProperty,A=Object.prototype.propertyIsEnumerable;var u=(t,n,o)=>n in t?S(t,n,{enumerable:!0,configurable:!0,writable:!0,value:o}):t[n]=o,s=(t,n)=>{for(var o in n||(n={}))V.call(n,o)&&u(t,o,n[o]);if(f)for(var o of f(n))A.call(n,o)&&u(t,o,n[o]);return t},v=(t,n)=>_(t,d(n));const g="7.1.0-beta.4",m="3.16",p="model-driven.headless.v2",E="model-driven.control-catalog.v1",i=Object.freeze({runtimeAbsentDefaults:"model-driven.runtime-absent-defaults",incrementalPageValidation:"model-driven.incremental-page-validation",controlAuthoringFacts:"model-driven.control-authoring-facts",controlPropertyPatchPlan:"model-driven.control-property-patch-plan"}),O=Object.freeze([Object.freeze({feature:i.runtimeAbsentDefaults,version:"1"}),Object.freeze({feature:i.incrementalPageValidation,version:"1"}),Object.freeze({feature:i.controlAuthoringFacts,version:"1"}),Object.freeze({feature:i.controlPropertyPatchPlan,version:"1"})]);function a(t){return typeof t=="string"&&t.trim().length>0}function D(t){const n=new Map;for(const e of t.available||[]){if(!e||!a(e.feature)||!a(e.version))continue;const r=n.get(e.feature)||new Set;r.add(e.version),n.set(e.feature,r)}const o=new Map;for(const e of t.required||[]){if(!e)continue;const r=JSON.stringify([e.feature,e.version]);o.set(r,e)}const l=[...o.values()].sort((e,r)=>`${String(e.feature)}\0${String(e.version)}`.localeCompare(`${String(r.feature)}\0${String(r.version)}`)).flatMap(e=>{const r=a(e.feature)?[...n.get(e.feature)||[]].sort():[],b=a(e.version)?e.version:String(e.version||"");return a(e.feature)&&a(e.version)&&r.includes(e.version)?[]:[{feature:a(e.feature)?e.feature:String(e.feature||""),requiredVersion:b,availableVersions:r,reason:r.length===0?"missing":"version-mismatch"}]});return{ok:l.length===0,issues:l}}const c=Object.freeze({packageVersion:g,pageSchemaVersion:m,compilerContractVersion:p,catalogSchemaVersion:E,capabilities:O});function I(){return v(s({},c),{capabilities:c.capabilities.map(t=>s({},t))})}function C(t){return s({},t)}export{E as CONTROL_CATALOG_SCHEMA_VERSION,m as CURRENT_PAGE_SCHEMA_VERSION,p as HEADLESS_COMPILER_CONTRACT_VERSION,c as MODEL_DRIVEN_BUILD_INFO,O as MODEL_DRIVEN_CAPABILITIES,i as MODEL_DRIVEN_FEATURES,g as MODEL_DRIVEN_PACKAGE_VERSION,D as admitModelDrivenCapabilities,C as createModelDrivenDiagnostic,I as getModelDrivenBuildInfo};

package/dist/esm/contracts/authoring.js

@@ -0,0 +1 @@
+export { };

package/dist/esm/contracts/build-info.js

@@ -24,13 +24,42 @@ function _object_spread(target) {
     }
     return target;
 }
+function ownKeys(object, enumerableOnly) {
+    var keys = Object.keys(object);
+    if (Object.getOwnPropertySymbols) {
+        var symbols = Object.getOwnPropertySymbols(object);
+        if (enumerableOnly) {
+            symbols = symbols.filter(function(sym) {
+                return Object.getOwnPropertyDescriptor(object, sym).enumerable;
+            });
+        }
+        keys.push.apply(keys, symbols);
+    }
+    return keys;
+}
+function _object_spread_props(target, source) {
+    source = source != null ? source : {};
+    if (Object.getOwnPropertyDescriptors) Object.defineProperties(target, Object.getOwnPropertyDescriptors(source));
+    else {
+        ownKeys(Object(source)).forEach(function(key) {
+            Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key));
+        });
+    }
+    return target;
+}
 import { CONTROL_CATALOG_SCHEMA_VERSION, CURRENT_PAGE_SCHEMA_VERSION, HEADLESS_COMPILER_CONTRACT_VERSION, MODEL_DRIVEN_PACKAGE_VERSION } from './versions';
+import { MODEL_DRIVEN_CAPABILITIES } from './capabilities';
 export var MODEL_DRIVEN_BUILD_INFO = Object.freeze({
     packageVersion: MODEL_DRIVEN_PACKAGE_VERSION,
     pageSchemaVersion: CURRENT_PAGE_SCHEMA_VERSION,
     compilerContractVersion: HEADLESS_COMPILER_CONTRACT_VERSION,
-    catalogSchemaVersion: CONTROL_CATALOG_SCHEMA_VERSION
+    catalogSchemaVersion: CONTROL_CATALOG_SCHEMA_VERSION,
+    capabilities: MODEL_DRIVEN_CAPABILITIES
 });
 /** 返回新对象，避免调用方意外改写共享的版本事实。 */ export function getModelDrivenBuildInfo() {
-    return _object_spread({}, MODEL_DRIVEN_BUILD_INFO);
+    return _object_spread_props(_object_spread({}, MODEL_DRIVEN_BUILD_INFO), {
+        capabilities: MODEL_DRIVEN_BUILD_INFO.capabilities.map(function(capability) {
+            return _object_spread({}, capability);
+        })
+    });
 }

package/dist/esm/contracts/capabilities.js

@@ -0,0 +1,137 @@
+/**
+ * 公共能力使用独立于 npm 包版本的稳定 feature 名称与精确版本。
+ *
+ * capability 版本是调用契约，不按 semver 猜测兼容范围；宿主必须声明自己要求的
+ * feature/version，公共层仅在精确命中时准入，从而避免“包版本一致但能力缺失”。
+ */ function _array_like_to_array(arr, len) {
+    if (len == null || len > arr.length) len = arr.length;
+    for(var i = 0, arr2 = new Array(len); i < len; i++)arr2[i] = arr[i];
+    return arr2;
+}
+function _array_without_holes(arr) {
+    if (Array.isArray(arr)) return _array_like_to_array(arr);
+}
+function _iterable_to_array(iter) {
+    if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) {
+        return Array.from(iter);
+    }
+}
+function _non_iterable_spread() {
+    throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method.");
+}
+function _to_consumable_array(arr) {
+    return _array_without_holes(arr) || _iterable_to_array(arr) || _unsupported_iterable_to_array(arr) || _non_iterable_spread();
+}
+function _unsupported_iterable_to_array(o, minLen) {
+    if (!o) return;
+    if (typeof o === "string") return _array_like_to_array(o, minLen);
+    var n = Object.prototype.toString.call(o).slice(8, -1);
+    if (n === "Object" && o.constructor) n = o.constructor.name;
+    if (n === "Map" || n === "Set") return Array.from(n);
+    if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
+}
+export var MODEL_DRIVEN_FEATURES = Object.freeze({
+    runtimeAbsentDefaults: 'model-driven.runtime-absent-defaults',
+    incrementalPageValidation: 'model-driven.incremental-page-validation',
+    controlAuthoringFacts: 'model-driven.control-authoring-facts',
+    controlPropertyPatchPlan: 'model-driven.control-property-patch-plan'
+});
+/** 当前发布列车明确提供的能力；新增或变更语义时必须显式调整对应版本。 */ export var MODEL_DRIVEN_CAPABILITIES = Object.freeze([
+    Object.freeze({
+        feature: MODEL_DRIVEN_FEATURES.runtimeAbsentDefaults,
+        version: '1'
+    }),
+    Object.freeze({
+        feature: MODEL_DRIVEN_FEATURES.incrementalPageValidation,
+        version: '1'
+    }),
+    Object.freeze({
+        feature: MODEL_DRIVEN_FEATURES.controlAuthoringFacts,
+        version: '1'
+    }),
+    Object.freeze({
+        feature: MODEL_DRIVEN_FEATURES.controlPropertyPatchPlan,
+        version: '1'
+    })
+]);
+function nonEmptyCapabilityPart(value) {
+    return typeof value === 'string' && value.trim().length > 0;
+}
+/**
+ * 对宿主声明的 required capabilities 做纯集合准入；结果稳定排序且不抛出输入内容。
+ * 相同声明会去重，无效或不匹配声明按 fail-closed 处理；函数不读取任何外部状态。
+ */ export function admitModelDrivenCapabilities(input) {
+    var availableVersionsByFeature = new Map();
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = (input.available || [])[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var capability = _step.value;
+            if (!capability || !nonEmptyCapabilityPart(capability.feature) || !nonEmptyCapabilityPart(capability.version)) {
+                continue;
+            }
+            var versions = availableVersionsByFeature.get(capability.feature) || new Set();
+            versions.add(capability.version);
+            availableVersionsByFeature.set(capability.feature, versions);
+        }
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
+            }
+        }
+    }
+    var requirements = new Map();
+    var _iteratorNormalCompletion1 = true, _didIteratorError1 = false, _iteratorError1 = undefined;
+    try {
+        for(var _iterator1 = (input.required || [])[Symbol.iterator](), _step1; !(_iteratorNormalCompletion1 = (_step1 = _iterator1.next()).done); _iteratorNormalCompletion1 = true){
+            var capability1 = _step1.value;
+            if (!capability1) continue;
+            var key = JSON.stringify([
+                capability1.feature,
+                capability1.version
+            ]);
+            requirements.set(key, capability1);
+        }
+    } catch (err) {
+        _didIteratorError1 = true;
+        _iteratorError1 = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion1 && _iterator1.return != null) {
+                _iterator1.return();
+            }
+        } finally{
+            if (_didIteratorError1) {
+                throw _iteratorError1;
+            }
+        }
+    }
+    var issues = _to_consumable_array(requirements.values()).sort(function(left, right) {
+        return "".concat(String(left.feature), "\0").concat(String(left.version)).localeCompare("".concat(String(right.feature), "\0").concat(String(right.version)));
+    }).flatMap(function(required) {
+        var availableVersions = nonEmptyCapabilityPart(required.feature) ? _to_consumable_array(availableVersionsByFeature.get(required.feature) || []).sort() : [];
+        var requiredVersion = nonEmptyCapabilityPart(required.version) ? required.version : String(required.version || '');
+        if (nonEmptyCapabilityPart(required.feature) && nonEmptyCapabilityPart(required.version) && availableVersions.includes(required.version)) {
+            return [];
+        }
+        return [
+            {
+                feature: nonEmptyCapabilityPart(required.feature) ? required.feature : String(required.feature || ''),
+                requiredVersion: requiredVersion,
+                availableVersions: availableVersions,
+                reason: availableVersions.length === 0 ? 'missing' : 'version-mismatch'
+            }
+        ];
+    });
+    return {
+        ok: issues.length === 0,
+        issues: issues
+    };
+}

package/dist/esm/contracts/index.js

@@ -1,4 +1,6 @@
 export * from './versions';
+export * from './capabilities';
 export * from './build-info';
 export * from './diagnostics';
 export * from './page-model';
+export * from './authoring';

package/dist/esm/contracts/versions.js

@@ -3,7 +3,7 @@
  *
  * 注意：npm 包版本、页面持久化 schema 版本和纯编译契约版本是三套独立版本，
  * 不能再通过其中任意一个推断另外两个。
- */ export var MODEL_DRIVEN_PACKAGE_VERSION = '7.1.0-beta.2';
+ */ export var MODEL_DRIVEN_PACKAGE_VERSION = '7.1.0-beta.4';
 /** 当前设计器写入的页面持久化 schema 版本。 */ export var CURRENT_PAGE_SCHEMA_VERSION = '3.16';
 /** Node 纯编译入口的契约版本。 */ export var HEADLESS_COMPILER_CONTRACT_VERSION = 'model-driven.headless.v2';
 /** 静态控件目录的文档结构版本。 */ export var CONTROL_CATALOG_SCHEMA_VERSION = 'model-driven.control-catalog.v1';

package/dist/types/contracts/authoring.d.ts

@@ -0,0 +1,47 @@
+import { ModelDrivenCapability, ModelDrivenCapabilityAdmissionResult } from './capabilities';
+import { ModelDrivenDiagnostic } from './diagnostics';
+import { JsonObject, JsonValue } from './page-model';
+/**
+ * 宿主对单个保存属性的显式准入；公共层没有默认 allowlist。
+ *
+ * 宿主只能对 catalog 已发布的保存属性授权；紧凑约束缺失时继续失败关闭。
+ */
+export interface ControlPropertyAdmission {
+    savedPropertyKey: string;
+    allowNull?: boolean;
+    /** object/array 只有顶层类型事实时，宿主必须显式承担深层结构校验。 */
+    allowIncompleteConstraint?: boolean;
+}
+export interface ControlPropertyPatchPolicy {
+    properties: readonly ControlPropertyAdmission[];
+}
+export interface ControlPropertyPatchInput {
+    /** 必须精确声明 control-property-patch-plan feature/version。 */
+    capability: ModelDrivenCapability;
+    controlType: string;
+    controlId?: string;
+    /**
+     * 本批只规划 set：key 必须是 catalog 保存键，null 是显式值，undefined 一律拒绝。
+     * remove 需要独立的 absent-runtime admission，不能借用 undefined 表达。
+     */
+    set: JsonObject;
+    policy: ControlPropertyPatchPolicy;
+}
+export interface PlannedControlPropertyPatchEntry {
+    propertyKey: string;
+    savedPropertyKey: string;
+    value: JsonValue;
+}
+export interface ControlPropertyPatchPlan {
+    controlType: string;
+    savedPropsPatch: JsonObject;
+    entries: PlannedControlPropertyPatchEntry[];
+}
+export interface ControlAuthoringValidationResult {
+    ok: boolean;
+    diagnostics: ModelDrivenDiagnostic[];
+    capabilityAdmission: ModelDrivenCapabilityAdmissionResult;
+}
+export interface ControlPropertyPatchPlanResult extends ControlAuthoringValidationResult {
+    plan?: ControlPropertyPatchPlan;
+}

package/dist/types/contracts/build-info.d.ts

@@ -1,4 +1,5 @@
 import { CONTROL_CATALOG_SCHEMA_VERSION, CURRENT_PAGE_SCHEMA_VERSION, HEADLESS_COMPILER_CONTRACT_VERSION, MODEL_DRIVEN_PACKAGE_VERSION } from './versions';
+import { ModelDrivenCapability } from './capabilities';
 /**
  * 可跨 Designer、Runtime 与 FDE 比对的公共构建信息。
  * catalogRevision 由 controls/catalog 在生成阶段补充，core 不反向依赖 controls。
@@ -9,6 +10,15 @@ export interface ModelDrivenBuildInfo {
     compilerContractVersion: typeof HEADLESS_COMPILER_CONTRACT_VERSION;
     catalogSchemaVersion: typeof CONTROL_CATALOG_SCHEMA_VERSION;
     catalogRevision?: string;
+    /**
+     * 发布列车实际提供的精确 feature/version 能力。
+     * 字段可选仅为兼容旧宿主构造的 build-info；当前查询 API 始终返回它。
+     */
+    capabilities?: ReadonlyArray<ModelDrivenCapability>;
+}
+/** 当前版本实际返回的完整 build-info，保留旧 ModelDrivenBuildInfo 的源码兼容。 */
+export interface ModelDrivenBuildInfoWithCapabilities extends ModelDrivenBuildInfo {
+    capabilities: ReadonlyArray<ModelDrivenCapability>;
 }
 /**
  * 调用方声明的版本期望允许任意字符串，才能在类型安全的调用中表达并检测旧版本。
@@ -19,7 +29,9 @@ export interface ModelDrivenBuildInfoExpectation {
     compilerContractVersion?: string;
     catalogSchemaVersion?: string;
     catalogRevision?: string;
+    /** 宿主按 feature/version 显式声明所需能力；任一缺失或版本不同均 fail-closed。 */
+    requiredCapabilities?: readonly ModelDrivenCapability[];
 }
-export declare const MODEL_DRIVEN_BUILD_INFO: Readonly<ModelDrivenBuildInfo>;
+export declare const MODEL_DRIVEN_BUILD_INFO: Readonly<ModelDrivenBuildInfoWithCapabilities>;
 /** 返回新对象，避免调用方意外改写共享的版本事实。 */
-export declare function getModelDrivenBuildInfo(): ModelDrivenBuildInfo;
+export declare function getModelDrivenBuildInfo(): ModelDrivenBuildInfoWithCapabilities;

package/dist/types/contracts/capabilities.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 公共能力使用独立于 npm 包版本的稳定 feature 名称与精确版本。
+ *
+ * capability 版本是调用契约，不按 semver 猜测兼容范围；宿主必须声明自己要求的
+ * feature/version，公共层仅在精确命中时准入，从而避免“包版本一致但能力缺失”。
+ */
+export interface ModelDrivenCapability {
+    feature: string;
+    version: string;
+}
+export type ModelDrivenCapabilityAdmissionIssueReason = 'missing' | 'version-mismatch';
+export interface ModelDrivenCapabilityAdmissionIssue {
+    feature: string;
+    requiredVersion: string;
+    availableVersions: string[];
+    reason: ModelDrivenCapabilityAdmissionIssueReason;
+}
+export interface ModelDrivenCapabilityAdmissionResult {
+    ok: boolean;
+    issues: ModelDrivenCapabilityAdmissionIssue[];
+}
+export declare const MODEL_DRIVEN_FEATURES: Readonly<{
+    readonly runtimeAbsentDefaults: "model-driven.runtime-absent-defaults";
+    readonly incrementalPageValidation: "model-driven.incremental-page-validation";
+    readonly controlAuthoringFacts: "model-driven.control-authoring-facts";
+    readonly controlPropertyPatchPlan: "model-driven.control-property-patch-plan";
+}>;
+/** 当前发布列车明确提供的能力；新增或变更语义时必须显式调整对应版本。 */
+export declare const MODEL_DRIVEN_CAPABILITIES: ReadonlyArray<ModelDrivenCapability>;
+/**
+ * 对宿主声明的 required capabilities 做纯集合准入；结果稳定排序且不抛出输入内容。
+ * 相同声明会去重，无效或不匹配声明按 fail-closed 处理；函数不读取任何外部状态。
+ */
+export declare function admitModelDrivenCapabilities(input: {
+    available?: readonly ModelDrivenCapability[];
+    required?: readonly ModelDrivenCapability[];
+}): ModelDrivenCapabilityAdmissionResult;

package/dist/types/contracts/index.d.ts

@@ -1,4 +1,6 @@
 export * from './versions';
+export * from './capabilities';
 export * from './build-info';
 export * from './diagnostics';
 export * from './page-model';
+export * from './authoring';

package/dist/types/contracts/versions.d.ts

@@ -4,7 +4,7 @@
  * 注意：npm 包版本、页面持久化 schema 版本和纯编译契约版本是三套独立版本，
  * 不能再通过其中任意一个推断另外两个。
  */
-export declare const MODEL_DRIVEN_PACKAGE_VERSION: "7.1.0-beta.2";
+export declare const MODEL_DRIVEN_PACKAGE_VERSION: "7.1.0-beta.4";
 /** 当前设计器写入的页面持久化 schema 版本。 */
 export declare const CURRENT_PAGE_SCHEMA_VERSION: "3.16";
 /** Node 纯编译入口的契约版本。 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@byteluck-fe/model-driven-core",
-  "version": "7.1.0-beta.2",
+  "version": "7.1.0-beta.4",
   "description": "model engine core",
   "author": "郝晨光 <2293885211@qq.com>",
   "homepage": "",
@@ -48,9 +48,9 @@
     "postpublish": "node ../../scripts/postpublish.js"
   },
   "dependencies": {
-    "@byteluck-fe/model-driven-shared": "7.1.0-beta.2",
+    "@byteluck-fe/model-driven-shared": "7.1.0-beta.4",
     "async-validator": "3.5.1",
     "tslib": "^2.1.0"
   },
-  "gitHead": "68b8a947f7a0bc1b0e4ec68a71aafac5e0e7cd37"
+  "gitHead": "82847b31dd60becd6a77ed5d831c12f57b3dc7aa"
 }