@gct-paas/word 0.1.52-beta.0 → 0.1.52-beta.10

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

@@ -0,0 +1,28 @@
+/** Ribbon 主按钮图标 */
+export declare const TABLE_CATEGORY_SVG: {
+    readonly dataTable: string;
+    readonly businessTable: string;
+};
+/** 数据表下拉项图标（按 tableType） */
+export declare const TABLE_DATA_SVG: {
+    readonly 'table-header': string;
+    readonly 'dynamic-table': string;
+    readonly 'fixed-table': string;
+    readonly 'two-d-table': string;
+};
+/** 业务表下拉项图标（按 tableType） */
+export declare const TABLE_BUSINESS_SVG: {
+    readonly 'warehouse-in-out': string;
+    readonly 'warehouse-inventory': string;
+    readonly 'warehouse-allocate': string;
+    readonly 'material-consume': string;
+    readonly 'material-balance': string;
+    readonly 'check-table': string;
+};
+/**
+ * Ribbon 下拉项 value → SVG URL
+ */
+export declare const TABLE_SVG_BY_RIBBON_ACTION: Record<string, string>;
+export type TableCategorySvgKey = keyof typeof TABLE_CATEGORY_SVG;
+export type TableDataSvgKey = keyof typeof TABLE_DATA_SVG;
+export type TableBusinessSvgKey = keyof typeof TABLE_BUSINESS_SVG;

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/input/src/input.vue.d.ts

@@ -15,7 +15,7 @@ declare const __VLS_component: import('vue').DefineComponent<GctInputProps, {
     focus: () => void;
     blur: () => void;
     select: () => void;
-    inputRef: import('vue').Ref<HTMLTextAreaElement | HTMLInputElement | null, HTMLTextAreaElement | HTMLInputElement | null>;
+    inputRef: import('vue').Ref<HTMLInputElement | HTMLTextAreaElement | null, HTMLInputElement | HTMLTextAreaElement | null>;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
     input: (value: string | number, event: Event) => any;
     search: (value: string | number) => any;
@@ -47,12 +47,10 @@ declare const __VLS_component: import('vue').DefineComponent<GctInputProps, {
     readonly: boolean;
     disabled: boolean;
     size: import('./types').InputSize;
-    autocomplete: string;
-    spellcheck: boolean;
+    suffix: string;
     placeholder: string;
     modelValue: string | number;
     prefix: string;
-    suffix: string;
     addonBefore: string;
     addonAfter: string;
     allowClear: boolean;
@@ -60,9 +58,11 @@ declare const __VLS_component: import('vue').DefineComponent<GctInputProps, {
     showPasswordToggle: boolean;
     maxLength: number;
     autofocus: boolean;
+    autocomplete: string;
     rows: number;
     bordered: boolean;
     showSearchButton: boolean;
+    spellcheck: boolean;
     customStyle: Record<string, string | number>;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     inputRef: HTMLInputElement;

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

@@ -42,16 +42,16 @@ declare const __VLS_component: import('vue').DefineComponent<GctInputProps, {
     name: string;
     readonly: boolean;
     disabled: boolean;
-    autocomplete: string;
-    spellcheck: boolean;
     placeholder: string;
     modelValue: string | number;
     allowClear: boolean;
     showCount: boolean;
     maxLength: number;
     autofocus: boolean;
+    autocomplete: string;
     rows: number;
     bordered: boolean;
+    spellcheck: boolean;
     customStyle: Record<string, string | number>;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     textareaRef: HTMLTextAreaElement;

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;
-    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/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";
     multiple: boolean;
     loading: 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/capabilities/panel/schema/types.d.ts

@@ -8,6 +8,7 @@ export type PanelTitle = string | PanelBreadcrumbItem[];
 export type PanelTitleContext = {
     active: ActivePanelData | null;
     attachFieldTarget: AttachFieldTarget | null;
+    widget?: unknown;
 };
 export interface PanelSchema {
     /** schema 唯一 key */

package/dist/core/cursor/render/cursor-renderer.vue.d.ts

@@ -9,10 +9,10 @@ type __VLS_Props = {
     visible?: boolean;
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
-    caretWidth: number;
+    visible: boolean;
     caretColor: string;
+    caretWidth: number;
     blinkInterval: number;
     alwaysVisibleAfterEventMs: number;
-    visible: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 export default _default;

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

@@ -1,6 +1,16 @@
 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;
+    newValue: unknown;
+    source: EmitSource;
+}
+/** 本批次字段变更：path → 变更明细 */
+export type FieldChangeMap = Record<string, FieldChangeDetail>;
 export type Data = Record<string, any>;
 export type PartialData = Partial<Data>;
 type JsonPath = string;
@@ -54,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）
      */
@@ -103,6 +123,11 @@ export declare class DataManager {
     getHref<T = string>(path: JsonPath): T | null | undefined;
     /** 子表数组路径下未软删行数 */
     countActiveSubtableRows(arrayPath: JsonPath): number;
+    /**
+     * 统计 defaults 中按 `$.subFieldKey[i].*` 展开的检验项行数。
+     * 检验表纵向轴配置只进 defaults，rawData 可能尚未物化多行。
+     */
+    countDefaultsIndexedRows(subFieldKey: string): number;
     /** 版面可见行下标 → rawData 数组实际下标 */
     resolveSubtableVisibleIndex(arrayPath: JsonPath, visibleIndex: number): number;
     private assignField;
@@ -110,9 +135,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 命名启发）
@@ -136,6 +162,8 @@ export declare class DataManager {
      */
     private get2DByCoords;
     private set2DByCoords;
+    /** 二维/检验表写字段后，额外 emit 带下标的字段路径，供 label enricher 等按字段匹配 */
+    private emit2DFieldPath;
     private cleanupCrossByAxisUid;
     /**
      * 复制轴行插入时：若 uid 与已有行重复，换新 uid 并复制关联交叉区行。
@@ -145,7 +173,7 @@ export declare class DataManager {
     /**
      * 将一个部分值对象合进整体
      */
-    patch(data: PartialData): void;
+    patch(data: PartialData, source: EmitSource): void;
     /**
      * 根据 jsonpath 删除数据
      * @param path jsonpath 路径
@@ -158,13 +186,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;
     /**
@@ -355,4 +384,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 {};

package/dist/core/data/post-change-pipeline.d.ts

@@ -2,7 +2,8 @@ import { FIELD_TYPE } from '../../domain/field/field-type';
 import { FieldManifest } from '../../capabilities/field-manifest';
 import { FieldMeta } from '../../capabilities/model-field-runtime';
 import { Doc } from '../view/Doc';
-import { DataManager, EmitSource } from './DataManager';
+import { DataManager, FieldChangeMap } from './DataManager';
+import { EmitSource } from './emit-source';
 /**
  * Pipeline 运行时上下文
  *
@@ -19,86 +20,35 @@ export type PostChangePipelineContext = {
      * 根据模型 key + 字段 key 获取字段 meta
      */
     loadFieldByKey: (modelKey: string, key: string) => Promise<FieldMeta | undefined>;
-    /** 数据变更并完成 enrich 后的扩展钩子 */
-    afterFlush?: (changedPaths: string[], source: EmitSource) => void | Promise<void>;
+    /** 用户编辑并完成 enrich 后的业务副作用 */
+    afterFlush?: (changedMap: FieldChangeMap, source: EmitSource) => void | Promise<void>;
 };
 /**
  * 数据变更后的处理流水线
  *
- * 主要职责：
- * 1. 等待依赖字段刷新完成
- * 2. 根据 changedPaths 找到对应 enrichers
- * 3. 执行 enrich 逻辑
- * 4. 将 enrich 结果再次写回 DataManager
- *
- * 典型场景：
- * - 自动填充字段
- * - 字段联动
- * - 数据增强
- * - 根据某字段自动计算其它字段
+ * 两个入口：
+ * - hydrate：装载/换数后激活，只跑 deps + enrichers
+ * - onChange：用户/依赖编辑，deps + enrichers +（仅 user）afterFlush
  */
 export declare class PostChangePipeline {
-    /**
-     * 数据管理器
-     */
     private dataManager;
-    /**
-     * 文档实例
-     */
     private doc;
-    /**
-     * 当前注册的 enrichers
-     *
-     * 每个 enricher：
-     * - match(path) 判断是否处理该字段
-     * - enrich(path, value) 生成补充数据
-     */
     private enrichers;
-    /**
-     * 防止同一路径重复并发执行
-     *
-     * key:
-     *   path
-     *
-     * value:
-     *   当前执行中的 Promise
-     */
     private inFlight;
-    /**
-     * pipeline 上下文
-     */
     private pipelineCtx?;
-    constructor(
-    /**
-     * 数据管理器
-     */
-    dataManager: DataManager, 
-    /**
-     * 文档实例
-     */
-    doc: Doc);
-    /**
-     * 设置 pipeline 上下文
-     *
-     * 设置后会重新构建 enrichers
-     */
+    constructor(dataManager: DataManager, doc: Doc);
     setContext(ctx: PostChangePipelineContext): void;
-    /**
-     * 重建 enricher 注册列表
-     *
-     * 从当前文档中的 widget instances
-     * 动态生成 enrichers
-     */
     rebuildRegistrations(): void;
+    /** 装载/换数后：deps + enrichers，不触发业务副作用 */
+    hydrate(paths: string[]): Promise<void>;
+    /** 字段变更：deps + enrichers；仅 user 批次触发 afterFlush */
+    onChange(changedMap: FieldChangeMap, options?: {
+        runBusinessSideEffects?: boolean;
+    }): Promise<void>;
     /**
-     * 变更后执行流水线
-     *
-     * @param changedPaths 本次变化的字段路径
-     * @param source       变更来源
-     */
-    flush(changedPaths: string[], source: EmitSource): Promise<void>;
-    /**
-     * 执行某个 path 对应的 enrichers
+     * @deprecated 请使用 hydrate / onChange
      */
+    flush(changedMap: FieldChangeMap, source: EmitSource): Promise<void>;
+    private runCore;
     private runEnrichersForPath;
 }

package/dist/core/model/document/wtcRegionRef.d.ts

@@ -18,7 +18,7 @@
  *
  * 出入库明细等复用 repeating 存储，layout 层通过 widgetMeta.props.layoutType 区分。
  */
-export type SubTableRegionType = 'repeating' | 'bounded' | '2d-table' | 'check-table' | 'material-consume-table';
+export type SubTableRegionType = 'repeating' | 'bounded' | '2d-table' | 'check-table' | 'material-consume-table' | 'warehouse-allocate-table';
 /** 表头 region 类型 */
 export type TableHeaderRegionType = 'table-header' | 'sub-table-header';
 /** 所有子表表格 region 类型 */
@@ -29,7 +29,7 @@ export declare const SUB_TABLE_REGION_TYPES: readonly ["repeating", "bounded", "
  * 子表 layout 类型
  * Ribbon 面板、子表主题色均使用此类型；主题配置见 @/domain/table 各 Profile.theme
  */
-export type SubTableLayoutType = 'dynamic-table' | 'fixed-table' | '2d-table' | 'check-table' | 'material-consume-table' | 'warehouse-in-out-table';
+export type SubTableLayoutType = 'dynamic-table' | 'fixed-table' | '2d-table' | 'check-table' | 'material-consume-table' | 'warehouse-in-out-table' | 'warehouse-inventory-table' | 'warehouse-allocate-table';
 /** 表头 layout 类型 */
 export type TableHeaderLayoutType = 'table-header';
 /** 所有子表表格 layout 类型 */