@byteluck-fe/model-driven-controls 7.1.0-beta.2 → 7.1.0-beta.3

package/dist/types/catalog/query.d.ts

@@ -1,4 +1,5 @@
-import { ControlCatalogInfo, ControlDefinition, ControlLocaleMessageFact, ControlSavedPropertyFact, ControlSettingFact } from './types';
+import { ControlCatalogInfo, ControlDefinition, ControlLocaleMessageFact, ResolvedControlSavedPropertyValue, ControlSavedPropertyFact, ControlSettingFact } from './types';
+import { JsonObject } from '@byteluck-fe/model-driven-core/contracts';
 /** 返回独立副本，避免调用方污染进程内共享 catalog。 */
 export declare function getControlDefinition(type: string): ControlDefinition | undefined;
 /** 控件列表按 type 稳定排序，生成器与运行时查询顺序保持一致。 */
@@ -15,6 +16,23 @@ export declare function getControlSettingFacts(type: string): ControlSettingFact
  * propertyNameMap 与 defaultProps，才能作为控件切换时的能力证据。
  */
 export declare function getControlSavedPropertyFact(type: string, savedPropertyKey: string): ControlSavedPropertyFact | undefined;
+/**
+ * 解析一个保存属性的有效值，仅在 catalog 已登记历史缺失语义时补值。
+ *
+ * `null` 是显式 JSON 值，不能与缺失/undefined 混为一谈。调用方可传 camelCase
+ * 构造态或 snake_case 保存态 props，返回值始终指出公共构造属性名。
+ */
+export declare function resolveControlSavedPropertyValue(input: {
+    controlType: string;
+    savedPropertyKey: string;
+    props: JsonObject;
+}): ResolvedControlSavedPropertyValue | undefined;
+/**
+ * 为 Designer 等构造态消费者补齐 Runtime 已核实的历史缺失语义。
+ *
+ * 未命中时保留原对象引用；命中时只浅拷贝 props 并写入公共属性名，不修改保存态原对象。
+ */
+export declare function applyControlRuntimeAbsentDefaults(controlType: string, props: JsonObject): JsonObject;
 /** headless 按稳定 key 窄查消息事实，避免复制整份 catalog。 */
 export declare function getControlLocaleMessageFact(key: string): ControlLocaleMessageFact | undefined;
 export declare function getControlCatalogInfo(): ControlCatalogInfo;

package/dist/types/catalog/types.d.ts

@@ -16,11 +16,24 @@ export interface ControlSettingFact {
  * 才会产生此事实。它只证明目标控件支持该保存属性，不自动授权跨控件继承或任意写入。
  */
 export interface ControlSavedPropertyFact {
+    /** 新建控件时由真实 Designer 工厂物化的默认值。 */
     controlType: string;
     defaultValue: JsonValue;
+    /**
+     * 历史保存态缺少该属性时，当前 Runtime 实际采用的值。
+     *
+     * 该字段只描述已经核实的兼容语义；未登记时调用方不得猜测或套用创建默认值。
+     */
+    absentRuntimeValue?: JsonValue;
     propertyKey: string;
     savedPropertyKey: string;
 }
+export interface ResolvedControlSavedPropertyValue {
+    propertyKey: string;
+    savedPropertyKey: string;
+    value: JsonValue;
+    source: 'explicit' | 'absent_runtime_value';
+}
 /** 由 i18n_messages 发布生成的紧凑文案事实，不包含运行时 i18n 实例。 */
 export interface ControlLocaleMessageFact {
     key: string;
@@ -92,6 +105,8 @@ export interface ControlDefinition {
     /** 显式构造存在无法确定性表达的副作用，headless 对这些输入 fail-closed。 */
     unsupportedExplicitProps: string[];
     propertyNameMap: Record<string, string>;
+    /** 仅登记已核实的“保存属性缺失时 Runtime 如何解释”事实。 */
+    absentRuntimeDefaults?: Record<string, JsonValue>;
     settings: JsonObject[];
     settingFacts: ControlSettingFact[];
     eventKeys: string[];

package/dist/types/listControls/SubTable/property.d.ts

@@ -246,6 +246,13 @@ interface SubTablePropertyInterface<Mode extends MODE | 'Schema', Control extend
 }
 declare class SubTableControlProperty<Mode extends MODE | 'Schema', Control extends object = ControlType<Mode>> extends ListControlProperty<Mode, Control> implements SubTablePropertyInterface<Mode, Control> {
     static readonly Rules: typeof SubTableControlPropertyRules;
+    /**
+     * 历史页面未保存 label_position 时，Runtime 一直按左右布局解释。
+     * 新建控件仍使用构造器中的 top；catalog 将两类语义分开发布，供 Designer 对齐历史运行态。
+     */
+    static readonly catalogAbsentRuntimeDefaults: {
+        readonly labelPosition: "left";
+    };
     static readonly RuntimeRules: typeof SubtableControlRuntimeRules;
     /**
      * 标题

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@byteluck-fe/model-driven-controls",
-  "version": "7.1.0-beta.2",
+  "version": "7.1.0-beta.3",
   "description": "> TODO: description",
   "author": "郝晨光 <2293885211@qq.com>",
   "homepage": "",
@@ -49,10 +49,10 @@
     "postpublish": "node ../../scripts/postpublish.js"
   },
   "dependencies": {
-    "@byteluck-fe/model-driven-core": "7.1.0-beta.2",
-    "@byteluck-fe/model-driven-settings": "7.1.0-beta.2",
-    "@byteluck-fe/model-driven-shared": "7.1.0-beta.2",
+    "@byteluck-fe/model-driven-core": "7.1.0-beta.3",
+    "@byteluck-fe/model-driven-settings": "7.1.0-beta.3",
+    "@byteluck-fe/model-driven-shared": "7.1.0-beta.3",
     "async-validator": "3.5.1"
   },
-  "gitHead": "68b8a947f7a0bc1b0e4ec68a71aafac5e0e7cd37"
+  "gitHead": "7adfb426676013d0daa1ece71a415ef840b8f92e"
 }