@gct-paas/word 0.1.52-beta.2 → 0.1.52-beta.5

package/dist/assets/svgs/table/index.d.ts

@@ -14,7 +14,7 @@ export declare const TABLE_DATA_SVG: {
 export declare const TABLE_BUSINESS_SVG: {
     readonly 'warehouse-in-out': string;
     readonly 'warehouse-inventory': string;
-    readonly 'warehouse-transfer': string;
+    readonly 'warehouse-allocate': string;
     readonly 'material-consume': string;
     readonly 'material-balance': string;
     readonly 'check-table': string;

package/dist/base/checkbox/src/checkbox-group.vue.d.ts

@@ -19,8 +19,8 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}
     onChange?: ((...args: any[]) => any) | undefined;
     "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
 }>, {
-    size: string;
     disabled: boolean;
+    size: string;
     modelValue: Array<string | number | boolean>;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;

package/dist/base/date-time-picker/src/DateTimePicker.vue.d.ts

@@ -11,8 +11,8 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {
     "onUpdate:modelValue"?: ((v: string | undefined) => any) | undefined;
 }>, {
     disabled: boolean;
-    format: string;
     placeholder: string;
+    format: string;
     calendarProps: any;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     dropdownRef: import('vue').CreateComponentPublicInstanceWithMixins<Record<string, any> & {}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, import('vue').PublicProps, {}, false, {}, {}, {}, {}, string, {}, any, import('vue').ComponentProvideOptions, {

package/dist/base/divider/src/divider.vue.d.ts

@@ -7,8 +7,8 @@ declare function __VLS_template(): {
 };
 type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
 declare const __VLS_component: import('vue').DefineComponent<IDividerProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<IDividerProps> & Readonly<{}>, {
-    vertical: boolean;
     color: string;
+    vertical: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;

package/dist/base/form-item/src/form-item.vue.d.ts

@@ -16,8 +16,8 @@ declare function __VLS_template(): {
 };
 type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
 declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
-    size: string;
     required: boolean;
+    size: string;
     inline: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;

package/dist/base/icon/src/icon.vue.d.ts

@@ -5,8 +5,8 @@ type __VLS_Props = {
     icon: string;
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
-    size: number | string;
-    version: "v1" | "v2";
     color: string;
+    version: "v1" | "v2";
+    size: number | string;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLSpanElement>;
 export default _default;

package/dist/base/input/src/input.vue.d.ts

@@ -25,8 +25,8 @@ declare const __VLS_component: import('vue').DefineComponent<GctInputProps, {
     keydown: (event: KeyboardEvent) => any;
     keypress: (event: KeyboardEvent) => any;
     keyup: (event: KeyboardEvent) => any;
-    "update:modelValue": (value: string | number) => any;
     clear: () => any;
+    "update:modelValue": (value: string | number) => any;
     pressEnter: (event: KeyboardEvent) => any;
 }, string, import('vue').PublicProps, Readonly<GctInputProps> & Readonly<{
     onInput?: ((value: string | number, event: Event) => any) | undefined;
@@ -37,20 +37,20 @@ declare const __VLS_component: import('vue').DefineComponent<GctInputProps, {
     onKeydown?: ((event: KeyboardEvent) => any) | undefined;
     onKeypress?: ((event: KeyboardEvent) => any) | undefined;
     onKeyup?: ((event: KeyboardEvent) => any) | undefined;
-    "onUpdate:modelValue"?: ((value: string | number) => any) | undefined;
     onClear?: (() => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string | number) => any) | undefined;
     onPressEnter?: ((event: KeyboardEvent) => any) | undefined;
 }>, {
     name: string;
     type: import('./types').InputType;
     id: string;
-    size: import('./types').InputSize;
+    readonly: boolean;
     disabled: boolean;
-    modelValue: string | number;
+    size: import('./types').InputSize;
+    suffix: string;
     placeholder: string;
+    modelValue: string | number;
     prefix: string;
-    readonly: boolean;
-    suffix: string;
     addonBefore: string;
     addonAfter: string;
     allowClear: boolean;

package/dist/base/input/src/text-area.vue.d.ts

@@ -23,8 +23,8 @@ declare const __VLS_component: import('vue').DefineComponent<GctInputProps, {
     keydown: (event: KeyboardEvent) => any;
     keypress: (event: KeyboardEvent) => any;
     keyup: (event: KeyboardEvent) => any;
-    "update:modelValue": (value: string | number) => any;
     clear: () => any;
+    "update:modelValue": (value: string | number) => any;
     pressEnter: (event: KeyboardEvent) => any;
 }, string, import('vue').PublicProps, Readonly<GctInputProps> & Readonly<{
     onInput?: ((value: string | number, event: Event) => any) | undefined;
@@ -35,15 +35,15 @@ declare const __VLS_component: import('vue').DefineComponent<GctInputProps, {
     onKeydown?: ((event: KeyboardEvent) => any) | undefined;
     onKeypress?: ((event: KeyboardEvent) => any) | undefined;
     onKeyup?: ((event: KeyboardEvent) => any) | undefined;
-    "onUpdate:modelValue"?: ((value: string | number) => any) | undefined;
     onClear?: (() => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string | number) => any) | undefined;
     onPressEnter?: ((event: KeyboardEvent) => any) | undefined;
 }>, {
     name: string;
+    readonly: boolean;
     disabled: boolean;
-    modelValue: string | number;
     placeholder: string;
-    readonly: boolean;
+    modelValue: string | number;
     allowClear: boolean;
     showCount: boolean;
     maxLength: number;

package/dist/base/radio/src/radio-group.vue.d.ts

@@ -20,8 +20,8 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}
     onChange?: ((...args: any[]) => any) | undefined;
     "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
 }>, {
-    size: string;
     disabled: boolean;
+    size: string;
     optionType: string;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;

package/dist/base/rdo-tree-select/src/rdo-tree-select.vue.d.ts

@@ -22,13 +22,13 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {
     "onUpdate:fullPathValue"?: ((value?: string | null | undefined) => any) | undefined;
 }>, {
     disabled: boolean;
+    modelCategory: string;
+    pageSize: number;
     placeholder: string;
     popperWidth: number;
     allowClear: boolean;
     disabledParent: boolean;
     parentToDefault: boolean;
-    pageSize: number;
-    modelCategory: string;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     dropdownRef: import('vue').CreateComponentPublicInstanceWithMixins<Record<string, any> & {}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, import('vue').PublicProps, {}, false, {}, {}, {}, {}, string, {}, any, import('vue').ComponentProvideOptions, {
         P: {};

package/dist/base/select/src/basic-select.vue.d.ts

@@ -67,8 +67,8 @@ declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {
     "onUpdate:modelValue"?: ((val: string | number | (string | number)[]) => any) | undefined;
 }>, {
     disabled: boolean;
-    placeholder: string;
     options: DropdownOption[];
+    placeholder: string;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     dropdownRef: import('vue').CreateComponentPublicInstanceWithMixins<Record<string, any> & {}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, import('vue').PublicProps, {}, false, {}, {}, {}, {}, string, {}, any, import('vue').ComponentProvideOptions, {
         P: {};

package/dist/base/select/src/searchable-select.vue.d.ts

@@ -15,10 +15,10 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {
     onChange?: ((val?: string | number | undefined, item?: DropdownOption | undefined) => any) | undefined;
     "onUpdate:modelValue"?: ((val?: string | number | undefined) => any) | undefined;
 }>, {
+    readonly: boolean;
     disabled: boolean;
-    placeholder: string;
     options: DropdownOption[];
-    readonly: boolean;
+    placeholder: string;
     allowClear: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     rootRef: HTMLDivElement;

package/dist/base/switch/src/switch.vue.d.ts

@@ -10,8 +10,8 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {
     onChange?: ((...args: any[]) => any) | undefined;
     "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
 }>, {
-    size: string;
     disabled: boolean;
+    size: string;
     modelValue: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLButtonElement>;
 export default _default;

package/dist/base/table/src/table.vue.d.ts

@@ -31,9 +31,9 @@ declare const __VLS_component: import('vue').DefineComponent<TableProps, {}, {},
     onSelect?: ((keys: string[]) => any) | undefined;
     "onRow-click"?: ((row: TableRow) => any) | undefined;
 }>, {
-    size: "small" | "middle" | "large";
     loading: boolean;
     multiple: boolean;
+    size: "small" | "middle" | "large";
     columns: TableColumn[];
     stripe: boolean;
     selectable: boolean;

package/dist/capabilities/model-field-runtime/types/field.d.ts

@@ -26,6 +26,8 @@ export interface FieldMeta {
     bindInfo?: string;
     /** 主子关联  绑定子模型字段 */
     bindFieldKey?: string;
+    /** 对象字段所属对象 key */
+    belongingObject?: string;
     createTime: string;
     createUserName: string;
     modifyTime: string;

package/dist/core/data/DataManager.d.ts

@@ -1,6 +1,8 @@
 import { Doc } from '../view/Doc';
 import { PostChangePipelineContext } from './post-change-pipeline';
-export type EmitSource = 'user' | 'dependency' | 'enrichment' | 'parent';
+import { EmitSource } from './emit-source';
+export type { EmitSource } from './emit-source';
+export { EMIT_SOURCE_DESC } from './emit-source';
 /** 单字段变更明细（path 作为 FieldChangeMap 的 key） */
 export interface FieldChangeDetail {
     oldValue: unknown;
@@ -62,10 +64,20 @@ export declare class DataManager {
      * 调度 layout，自动合并同一微任务队列中的多个操作
      */
     attachPostChangePipeline(ctx: PostChangePipelineContext): void;
-    /** 文档初始化 / 刷新数据后，对已有 value 跑一轮后置 enrich */
+    /** 文档初始化 / 刷新数据后，对已有 value 跑一轮后置 enrich（不触发业务副作用） */
     runInitialPostChangeFlush(paths: JsonPath[]): Promise<void>;
     /** 等待已入队的 emit 批处理（含 postChange / enrich 写回）全部完成 */
     whenEmitSettled(): Promise<void>;
+    /**
+     * 提交前准备：排空流水线 → 物化未写入 rawData 的默认值 → 补全 _lb_ / _href_
+     * 避免秒存或懒读 defaults 导致提交缺标签。
+     */
+    prepareForSubmit(): Promise<void>;
+    /**
+     * 将 defaults Map 中尚未进入 rawData 的项物化写入（source: hydrate）。
+     * @returns 本次物化的路径列表
+     */
+    materializePendingDefaults(): JsonPath[];
     /**
      * 对已注册的组件依赖全量重算（refresh 后 depGraph 已重建，需等 readonly/赋值稳定后再 enrich/layout）
      */
@@ -118,9 +130,10 @@ export declare class DataManager {
      * 根据 jsonpath 设置数据
      * @param path jsonpath 路径
      * @param value 要设置的值
+     * @param source 写入来源
      * @returns 是否设置成功
      */
-    set(path: JsonPath, value: any, source?: EmitSource): boolean;
+    set(path: JsonPath, value: any, source: EmitSource): boolean;
     /**
      * 从带数字下标的 path 推断二维坐标（供 setMultiple / patch / 业务回填等无 modelRef 的场景）
      * - 单轴：$.f_ewb[0].f_name → y=0；$.f_ewblink[1].x → x=1（需能从 rawData 的交叉 key 识别轴，或命中 link 命名启发）
@@ -153,7 +166,7 @@ export declare class DataManager {
     /**
      * 将一个部分值对象合进整体
      */
-    patch(data: PartialData): void;
+    patch(data: PartialData, source: EmitSource): void;
     /**
      * 根据 jsonpath 删除数据
      * @param path jsonpath 路径
@@ -166,13 +179,14 @@ export declare class DataManager {
      * @param callback 更新回调函数
      * @returns 是否更新成功
      */
-    update<T = any>(path: JsonPath, callback: (value: T) => T): boolean;
+    update<T = any>(path: JsonPath, callback: (value: T) => T, source: EmitSource): boolean;
     /**
      * 根据 jsonpath 批量设置数据
      * @param updates 路径与值的映射对象
+     * @param source 写入来源
      * @returns 是否全部设置成功
      */
-    setMultiple(updates: Record<JsonPath, any>, source?: EmitSource): boolean;
+    setMultiple(updates: Record<JsonPath, any>, source: EmitSource): boolean;
     /** 依赖赋值写回 rawData，不触发 emit（用于注册期常量公式立即执行） */
     private applyDependencyWrites;
     /**
@@ -363,4 +377,3 @@ export declare class DataManager {
      */
     clear(): void;
 }
-export {};

package/dist/core/data/derived-fields.d.ts

@@ -0,0 +1,20 @@
+/** 与 rawData 并存的 label 后缀（展示用） */
+export declare const LABEL_SUFFIX = "_lb_";
+/** 与 rawData 并存的外链 href 后缀（超链接字段） */
+export declare const HREF_SUFFIX = "_href_";
+/** 版面超链接文字颜色 */
+export declare const HYPERLINK_TEXT_COLOR = "#0563c1";
+export declare function getLabelPath(path: string): string;
+export declare function getHrefPath(path: string): string;
+/** 派生数据路径（label / href），不参与 changedMap / 业务副作用 */
+export declare function isDerivedDataPath(path: string): boolean;
+/** 子表行内仅前端使用、不参与提交的字段 */
+export declare const ROW_RUNTIME_META_KEYS: Set<string>;
+/** 该字段 key 是否不参与提交 */
+export declare function isSubmitExcludedKey(key: string): boolean;
+/** 提交时是否保留该行字段（含空 label 剔除规则） */
+export declare function shouldIncludeSubmitField(key: string, value: unknown): boolean;
+/** 从对象中挑出可提交的字段 */
+export declare function pickSubmitFields(record: Record<string, unknown>): Record<string, unknown>;
+/** 剔除顶层不参与提交的 key */
+export declare function omitSubmitExcludedTopLevel<T extends Record<string, unknown>>(data: T): Partial<T>;

package/dist/core/data/emit-source.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 字段写入来源
+ *
+ * 用来区分「用户真的改了」还是「系统在补水/算公式」
+ * 从而决定要不要触发业务副作用，比如清空下游、remoteSync 等
+ *
+ * @property user - 用户手动操作触发（下拉、输入、扫码）
+ * @property hydrate - 打开表单、刷新、初始化填空（非用户操作，不能把「加载」当成「改字段」，两者是不同的）
+ * @property dependency - 数据变更触发后把别的字段值给算出来了（组件依赖）
+ * @property enrichment - Pipeline 进行数据补充，自动补的派生数据（超链接 _href_、标签 _lb_）
+ * @property parent - 子字段变了，通知父级监听，主要是内部使用
+ */
+export type EmitSource = 'user' | 'hydrate' | 'dependency' | 'enrichment' | 'parent';
+/** 各来源中文说明 */
+export declare const EMIT_SOURCE_DESC: Record<EmitSource, string>;

package/dist/core/data/enricher-types.d.ts

@@ -1,6 +1,13 @@
+import { EmitSource } from './emit-source';
+/** enricher 执行时的批次上下文 */
+export type EnrichContext = {
+    batchSource?: EmitSource;
+    oldValue?: unknown;
+    newValue?: unknown;
+};
 export type DataEnricherRegistration = {
     id: string;
     valuePathTemplate: string;
     match: (path: string) => boolean;
-    enrich: (path: string, value: unknown) => Promise<Record<string, unknown> | void>;
+    enrich: (path: string, value: unknown, ctx?: EnrichContext) => Promise<Record<string, unknown> | void>;
 };

package/dist/core/data/enrichers/build-field-enrichers.d.ts

@@ -2,6 +2,29 @@ import { Doc } from '../../view/Doc';
 import { Wr } from '../../model/document';
 import { PostChangePipelineContext } from '../post-change-pipeline';
 import { DataEnricherRegistration } from '../enricher-types';
+import { FieldComputedConfig } from '../../../domain/field/field-props-schema-type';
+/**
+ * 解析 enricher 用的 widget props
+ * 枚举等字段的运行时选项在 computedOptions，需先跑 manifest.propRules
+ */
+export declare function resolveEnricherWidgetProps(instance: {
+    widgetMeta?: {
+        props?: Record<string, unknown>;
+    };
+}, manifest?: {
+    computed?: FieldComputedConfig;
+}): Record<string, unknown>;
+/** 根据文档 widget 列表构建全部 enricher 注册项 */
 export declare function buildFieldEnricherRegistrations(instances: any[], ctx: PostChangePipelineContext, doc: Doc): DataEnricherRegistration[];
-/** 收集 init 后需 enrich 的运行时路径（按 rawData 实际行数展开） */
+/**
+ * 将设计/初始化路径模板展开为运行时具体路径（含 [n] / [n_y][n_x]）
+ */
+export declare function expandInitPathTemplates(templatePath: string, rawData: Record<string, any>): string[];
+/**
+ * 收集 init / 换数后需要跑 hydrate 的运行时路径（仅 rawData 中已有值的字段）
+ */
 export declare function collectInitialEnrichPaths(instances: Wr[], rawData: Record<string, any>): string[];
+/** 收集子表指定行的 widget 字段路径（扫码 / 批量写行后补跑 label enrich） */
+export declare function collectSubtableRowEnrichPaths(instances: Wr[], subFieldKey: string, rowIndexes: number[]): string[];
+/** 子表指定行补跑 label / 派生字段 hydrate（enrichment 或整表 user 写入后不触发 enricher） */
+export declare function hydrateSubtableRowLabels(doc: Doc, subFieldKey: string, rowIndexes: number[]): Promise<void>;

package/dist/core/data/enrichers/enrich-design-defaults.d.ts

@@ -0,0 +1,19 @@
+import { Doc } from '../../view/Doc';
+import { FieldDataBindingMeta } from '../../../domain/field/field-binding';
+import { FIELD_TYPE } from '../../../domain/field/field-type';
+import { FieldManifest } from '../../../capabilities/field-manifest';
+import { FieldMeta } from '../../../capabilities/model-field-runtime';
+/** 单字段 defaults Map 补全 _lb_ */
+export declare function enrichDesignDefaults(defaults: Record<string, any> | undefined, options: {
+    doc: Doc;
+    fieldBinding?: FieldDataBindingMeta | null;
+    widgetProps: Record<string, unknown>;
+    manifest?: FieldManifest;
+    loadFieldByKey: (modelKey: string, key: string) => Promise<FieldMeta | undefined>;
+}): Promise<Record<string, any> | undefined>;
+/** 填报 init：为 loadDefaultValuesByFields 产出的 defaults Map 批量补 _lb_ */
+export declare function enrichWidgetDefaultsMap(defaultDataMap: Record<string, any>, instances: any[], options: {
+    doc: Doc;
+    getFieldManifest: (type: FIELD_TYPE) => FieldManifest | undefined;
+    loadFieldByKey: (modelKey: string, key: string) => Promise<FieldMeta | undefined>;
+}): Promise<Record<string, any>>;

package/dist/core/data/enrichers/label-enricher.d.ts

@@ -0,0 +1,62 @@
+import { Doc } from '../../view/Doc';
+import { WidgetMeta } from '../../widget/widget-meta';
+import { FieldDataBindingMeta } from '../../../domain/field/field-binding';
+import { FIELD_TYPE } from '../../../domain/field/field-type';
+import { FieldManifest } from '../../../capabilities/field-manifest';
+import { FieldMeta } from '../../../capabilities/model-field-runtime';
+import { DataEnricherRegistration } from '../enricher-types';
+import { DataManager } from '../DataManager';
+import { apiFetchers } from '../../../runtime/interface/fetchers';
+/** 单条 label 解析策略 */
+type LabelResolveStrategy = {
+    type: 'dict';
+    dictFieldKey?: string;
+} | {
+    type: 'options';
+    from: 'optionsJson' | 'computedOptions';
+    labelKey?: string;
+    multiple?: boolean;
+} | {
+    type: 'api';
+    fetcher: keyof typeof apiFetchers;
+    fallback?: string;
+} | {
+    type: 'static-map';
+    map: Record<string, string>;
+};
+/** resolveFieldLabel 运行时入参 */
+interface LabelResolveContext {
+    path: string;
+    value: unknown;
+    dataManager: DataManager;
+    fieldBinding: FieldDataBindingMeta;
+    widgetProps: Record<string, unknown>;
+    manifest?: FieldManifest;
+    loadFieldByKey: (modelKey: string, key: string) => Promise<FieldMeta | undefined>;
+}
+type LabelEnricherOptions = Omit<DataEnricherRegistration, 'enrich'> & {
+    doc: Doc;
+    widgetMeta: WidgetMeta;
+    fieldBinding: FieldDataBindingMeta;
+    manifest?: FieldManifest;
+    loadFieldByKey: (modelKey: string, key: string) => Promise<FieldMeta | undefined>;
+};
+/** 该字段是否应注册 label-enricher */
+export declare function fieldNeedsLabelEnrichment(fieldType: FIELD_TYPE, manifest?: FieldManifest): boolean;
+/**
+ * 静态映射 enricher：value 字段 → 固定 label 字段
+ * 用于无 widget 的业务字段，如盘点 stocktake_status → stocktake_status__lb_
+ */
+export declare function createStaticMapLabelEnricher(doc: Doc, options: {
+    id: string;
+    valueFieldKey: string;
+    labelFieldKey: string;
+    map: Record<string, string>;
+}): DataEnricherRegistration;
+/** 从 manifest 推导 label 解析策略链 */
+export declare function resolveFieldLabelStrategies(fieldType: FIELD_TYPE, manifest?: FieldManifest): LabelResolveStrategy[] | undefined;
+/** 按策略链解析 label */
+export declare function resolveFieldLabel(strategies: LabelResolveStrategy[], ctx: LabelResolveContext): Promise<string | null | undefined>;
+/** 为单个 widget 字段创建 label enricher 注册项 */
+export declare function createLabelEnricher(reg: LabelEnricherOptions): DataEnricherRegistration;
+export {};

package/dist/core/data/enrichers/static-label-enrichers.d.ts

@@ -0,0 +1,9 @@
+import { Doc } from '../../view/Doc';
+import { DataEnricherRegistration } from '../enricher-types';
+/** 拿到 doc 后生成 enricher 注册项 */
+type StaticLabelEnricherFactory = (doc: Doc) => DataEnricherRegistration;
+/** 注册业务侧静态/定制 label enricher */
+export declare function registerStaticLabelEnricher(factory: StaticLabelEnricherFactory): void;
+/** 文档初始化时构建所有已注册的静态 label enricher */
+export declare function buildStaticLabelEnrichers(doc: Doc): DataEnricherRegistration[];
+export {};

package/dist/core/data/pipeline-logger.d.ts

@@ -0,0 +1,72 @@
+import { EmitSource } from './emit-source';
+export type PipelineLogNS = 'data.emit' | 'pipeline.hydrate' | 'pipeline.onChange' | 'pipeline.deps' | 'enricher.label' | 'enricher.hyperlink' | 'pipeline.afterFlush' | 'table.runtime' | 'init.lifecycle' | 'submit.prepare';
+export type PipelineLogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface PipelineLogEvent {
+    ns: PipelineLogNS;
+    level: PipelineLogLevel;
+    msg: string;
+    batchId?: string;
+    path?: string;
+    source?: EmitSource;
+    durationMs?: number;
+    meta?: Record<string, unknown>;
+}
+export interface PipelineLogger {
+    debug(msg: string, meta?: Record<string, unknown>): void;
+    info(msg: string, meta?: Record<string, unknown>): void;
+    warn(msg: string, meta?: Record<string, unknown>): void;
+    error(msg: string, meta?: Record<string, unknown>): void;
+    child(meta: Record<string, unknown>): PipelineLogger;
+    time(label: string): () => number;
+}
+interface PipelineLoggingConfig {
+    enabled: boolean;
+    level: PipelineLogLevel;
+    namespaces?: PipelineLogNS[];
+}
+/** 创建 pipeline 批次 id，用于串联同一次 flush 日志 */
+export declare function createPipelineBatchId(prefix?: string): string;
+/** 配置 pipeline 日志 */
+export declare function configurePipelineLogging(options: Partial<PipelineLoggingConfig>): void;
+/** 日志展示 来源枚举 → 中文 */
+export declare function formatEmitSourceLabel(source: EmitSource): string;
+export declare function truncatePipelineValue(value: unknown, maxLen?: number): unknown;
+/** 单值展示（日志一行里用） */
+export declare function formatPipelineValue(value: unknown): string;
+export interface PipelineFieldChangeInput {
+    oldValue: unknown;
+    newValue: unknown;
+    source: EmitSource;
+}
+export interface FieldChangeLogMeta {
+    pathCount: number;
+    paths: string[];
+    changes: Array<{
+        path: string;
+        source: EmitSource;
+        old: unknown;
+        new: unknown;
+        text: string;
+    }>;
+    /** 拼进 log.msg 的简短摘要 */
+    brief: string;
+    omittedCount: number;
+}
+/**
+ * 把一批字段变更整理成 Console 可读的结构
+ * - brief：单条直接展示 path + 旧→新；多条展示前几条 +「等 N 项」
+ * - changes：展开可看每条明细
+ */
+export declare function formatFieldChangesForLog(changedMap: Record<string, PipelineFieldChangeInput>, options?: {
+    maxItems?: number;
+    hydrateMode?: boolean;
+}): FieldChangeLogMeta;
+/** info 级日志附带字段明细（paths + changes + brief） */
+export declare function fieldChangeLogMeta(changedMap: Record<string, PipelineFieldChangeInput>, options?: {
+    maxItems?: number;
+    hydrateMode?: boolean;
+}): Record<string, unknown>;
+export declare function createPipelineLogger(ns: PipelineLogNS, baseMeta?: Record<string, unknown>): PipelineLogger;
+/** 开发构建默认开启 debug 级别 pipeline 日志 */
+export declare function configurePipelineLoggingForDev(): void;
+export {};