@gct-paas/word 0.1.52-beta.3 → 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/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,8 +37,8 @@ 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;
@@ -46,8 +46,8 @@ declare const __VLS_component: import('vue').DefineComponent<GctInputProps, {
     id: string;
     readonly: boolean;
     disabled: boolean;
-    suffix: string;
     size: import('./types').InputSize;
+    suffix: string;
     placeholder: string;
     modelValue: string | number;
     prefix: string;

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,8 +35,8 @@ 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;

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

@@ -1,13 +1,8 @@
 import { Doc } from '../view/Doc';
 import { PostChangePipelineContext } from './post-change-pipeline';
-/**
- * 事件触发来源
- * @property user         - 用户手动操作触发
- * @property dependency   - 依赖数据变更触发
- * @property enrichment   - 数据补充/富化逻辑触发
- * @property parent       - 父组件/上层逻辑触发
- */
-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;
@@ -69,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）
      */
@@ -125,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 命名启发）
@@ -160,7 +166,7 @@ export declare class DataManager {
     /**
      * 将一个部分值对象合进整体
      */
-    patch(data: PartialData): void;
+    patch(data: PartialData, source: EmitSource): void;
     /**
      * 根据 jsonpath 删除数据
      * @param path jsonpath 路径
@@ -173,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;
     /**
@@ -370,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 {};

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, FieldChangeMap } 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 后的扩展钩子 */
+    /** 用户编辑并完成 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 changedMap 本批次字段变更 path → { oldValue, newValue, source }
-     * @param source       批次级变更来源（兼容保留，单字段以 map 内 source 为准）
+     * @deprecated 请使用 hydrate / onChange
      */
     flush(changedMap: FieldChangeMap, source: EmitSource): Promise<void>;
-    /**
-     * 执行某个 path 对应的 enrichers
-     */
+    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' | 'warehouse-inventory-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 类型 */

package/dist/core/model/logic/subtable/repeating/RepeatingRegion.d.ts

@@ -19,7 +19,11 @@ export type WarehouseInventoryTableProps = RepeatingWidgetPropsBase & {
     /** 条码解析规则 */
     barcode_parsing_rules_id_?: string;
 };
-export type RepeatingWidgetPropsMeta = DynamicTableProps | WarehouseInOutTableProps | WarehouseInventoryTableProps;
+export type WarehouseAllocateTableProps = RepeatingWidgetPropsBase & {
+    layoutType: 'warehouse-allocate-table';
+    barcode_parsing_rules_id_?: string;
+};
+export type RepeatingWidgetPropsMeta = DynamicTableProps | WarehouseInOutTableProps | WarehouseInventoryTableProps | WarehouseAllocateTableProps;
 export type RepeatingWidgetMeta = {
     props: RepeatingWidgetPropsMeta;
 };

package/dist/domain/active/active-types.d.ts

@@ -14,6 +14,8 @@ export type PanelType =
  | 'panel:warehouse-in-out-table'
 /** 库存盘点表 */
  | 'panel:warehouse-inventory-table'
+/** 库存调拨表 */
+ | 'panel:warehouse-allocate-table'
 /** 二维表 */
  | 'panel:2d-table'
 /** 物料消耗表 */

package/dist/domain/field/field-props-schema-type.d.ts

@@ -61,13 +61,19 @@ export interface MapRule {
 export interface HyperlinkRule {
     type: 'hyperlink';
 }
-export type ValueChangeRule = HyperlinkRule;
+/** 值变化后补全展示标签 */
+export interface LabelRule {
+    type: 'label';
+}
+export type ValueChangeRule = HyperlinkRule | LabelRule;
+/** 将 manifest 中的 onValueChangeRule 规范为数组 */
+export declare function normalizeValueChangeRules(rule?: ValueChangeRule | ValueChangeRule[]): ValueChangeRule[];
 export type ComputedRule = PriorityRule | ResolveRule | MapRule | JoinRule | ApiRule;
 export interface FieldComputedConfig {
     /** 写回 props 的派生规则 */
     propRules?: Record<string, ComputedRule>;
     /** 写入 dataManager 的派生规则 */
     defaultValueRule?: ComputedRule;
-    /** 填报值变化后的数据 enrich（如超链接 href） */
-    onValueChangeRule?: ValueChangeRule;
+    /** 填报值变化后的 enrich（超链接 _href_、展示标签 _lb_） */
+    onValueChangeRule?: ValueChangeRule | ValueChangeRule[];
 }

package/dist/domain/table/business/warehouse/warehouse-allocate/actions/change-parse-rule.d.ts

@@ -0,0 +1,7 @@
+import { Doc, SubRenderer } from '../../../../../../core';
+/** 变更库存调拨表条码解析规则（填报态） */
+export declare function changeWarehouseAllocateParseRule(options: {
+    doc: Doc;
+    subRenderer: SubRenderer;
+    subModelKey?: string;
+}): Promise<void>;

package/dist/domain/table/business/warehouse/warehouse-allocate/actions/index.d.ts

@@ -0,0 +1,2 @@
+export * from './scan';
+export * from './change-parse-rule';

package/dist/domain/table/business/warehouse/warehouse-allocate/actions/scan.d.ts

@@ -0,0 +1,7 @@
+import { Doc, SubRenderer } from '../../../../../../core';
+/** 打开扫码弹窗并处理调拨行合并 */
+export declare function openWarehouseAllocateScan(options: {
+    doc: Doc;
+    subRenderer: SubRenderer;
+    subFieldKey: string;
+}): Promise<void>;

package/dist/domain/table/business/warehouse/warehouse-allocate/index.d.ts

@@ -0,0 +1,2 @@
+export { profile as warehouseAllocateProfile } from './profile';
+export * from './actions';

package/dist/domain/table/business/warehouse/warehouse-allocate/profile/field-keys.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 调拨表字段 key 统一定义
+ */
+/** 单字段 key */
+export declare const F: {
+    readonly product: "product_id_";
+    readonly productName: "product_id_name_";
+    readonly productCode: "product_id_code_";
+    readonly productSpec: "product_id_spec_";
+    readonly matno: "material_no_";
+    readonly validity: "validity_";
+    readonly stock: "stock_num_";
+    readonly warehouse: "warehouse_id_";
+    readonly location: "location_id_";
+    readonly originWarehouseId: "origin_warehouse_id_";
+    readonly originLocationId: "origin_location_id_";
+    readonly originLocationIdLb: "origin_location_id__lb_";
+    readonly allocateReason: "allocate_reason_";
+    readonly allocateNum: "allocate_num_";
+    readonly matcode: "product_code_";
+    readonly rowSource: "row_source_";
+    readonly allocateLocationIds: "_allocate_location_ids_";
+};
+export type AllocateFieldKey = (typeof F)[keyof typeof F];
+/** runtimeRules：始终只读的信息字段 */
+export declare const READONLY_INFO_FIELDS: readonly ["product_id_name_", "product_id_code_", "product_id_spec_", "stock_num_", "validity_"];

package/dist/domain/table/business/warehouse/warehouse-allocate/profile/fields.d.ts

@@ -0,0 +1,2 @@
+import { BusinessFieldProfile } from '../../../../types';
+export declare const fields: BusinessFieldProfile[];

package/dist/domain/table/business/warehouse/{warehouse-transfer → warehouse-allocate}/profile/index.d.ts

@@ -1,3 +1,3 @@
 import { BusinessSubTableProfile } from '../../../../types';
 export declare const profile: BusinessSubTableProfile;
-export { profile as warehouseTransferProfile };
+export { profile as warehouseAllocateProfile };

package/dist/domain/table/business/warehouse/warehouse-allocate/runtime/register-handlers.d.ts

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

package/dist/domain/table/business/warehouse/warehouse-allocate/runtime/row-change-handlers.d.ts

@@ -0,0 +1,9 @@
+import { Doc } from '../../../../../../core';
+/**
+ * 物料切换 / 清空
+ */
+export declare function handleProductIdChange(doc: Doc, subFieldKey: string, rowIndex: number): void;
+/**
+ * 库位切换 / 清空
+ */
+export declare function handleLocationChange(doc: Doc, subFieldKey: string, rowIndex: number): void;