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

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-transfer': 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/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/data/DataManager.d.ts

@@ -1,6 +1,14 @@
 import { Doc } from '../view/Doc';
 import { PostChangePipelineContext } from './post-change-pipeline';
 export type EmitSource = 'user' | 'dependency' | 'enrichment' | 'parent';
+/** 单字段变更明细（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;

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

@@ -2,7 +2,7 @@ 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, EmitSource, FieldChangeMap } from './DataManager';
 /**
  * Pipeline 运行时上下文
  *
@@ -20,7 +20,7 @@ export type PostChangePipelineContext = {
      */
     loadFieldByKey: (modelKey: string, key: string) => Promise<FieldMeta | undefined>;
     /** 数据变更并完成 enrich 后的扩展钩子 */
-    afterFlush?: (changedPaths: string[], source: EmitSource) => void | Promise<void>;
+    afterFlush?: (changedMap: FieldChangeMap, source: EmitSource) => void | Promise<void>;
 };
 /**
  * 数据变更后的处理流水线
@@ -93,10 +93,10 @@ export declare class PostChangePipeline {
     /**
      * 变更后执行流水线
      *
-     * @param changedPaths 本次变化的字段路径
-     * @param source       变更来源
+     * @param changedMap 本批次字段变更 path → { oldValue, newValue, source }
+     * @param source       批次级变更来源（兼容保留，单字段以 map 内 source 为准）
      */
-    flush(changedPaths: string[], source: EmitSource): Promise<void>;
+    flush(changedMap: FieldChangeMap, source: EmitSource): Promise<void>;
     /**
      * 执行某个 path 对应的 enrichers
      */

package/dist/domain/table/_shared/linkage-engine.d.ts

@@ -1,10 +1,11 @@
 import { Doc } from '../../../core';
+import { FieldChangeDetail } from '../../../core/data/DataManager';
 import { BusinessSubTableRuntimeContext } from './table-runtime-shared';
 import { RuleContext, SelectBehaviorDef } from '../types';
 /** 解析级联上游字段值：行数据 → 隐式主表字段 → 主表同名字段 */
 export declare function resolveLinkFieldValue(doc: Doc, runtimeCtx: BusinessSubTableRuntimeContext, ctx: RuleContext, linkFieldKey: string, select?: SelectBehaviorDef): unknown;
-/** 字段值变更后：重建级联查询参数并清空下游字段 */
-export declare function applyBusinessTableLinkageOnFieldChange(doc: Doc, changedPath: string): void;
+/** 字段值变更后：重建级联查询参数；仅上游值实质变化时清空下游 */
+export declare function applyBusinessTableLinkageOnFieldChange(doc: Doc, changedPath: string, fieldChange?: FieldChangeDetail): void;
 /** 子表插行后：应用级联查询参数 */
 export declare function applyBusinessTableLinkageOnRowInit(doc: Doc, subFieldKey: string, rowIndex: number): void;
 /** 文档初始化后：应用级联查询参数 */
@@ -21,4 +22,4 @@ export declare function resolveBusinessSelectLinkage(doc: Doc, options: {
     runtimeValuePath?: string;
 }): BusinessSelectLinkageResult | null;
 /** 上游字段变更时，同步清空下游字段 */
-export declare function buildLinkageDownstreamClears(doc: Doc, changedPaths: string[]): Record<string, undefined>;
+export declare function buildLinkageDownstreamClears(doc: Doc, pendingUpdates: Record<string, unknown>): Record<string, undefined>;

package/dist/domain/table/_shared/rule-engine.d.ts

@@ -1,7 +1,8 @@
 import { Doc } from '../../../core';
+import { FieldChangeDetail } from '../../../core/data/DataManager';
 export { collectBusinessSubTableContexts, parseSubtableFieldPath, type BusinessSubTableRuntimeContext, } from './table-runtime-shared';
 /** 字段值变更后：应用 onFieldChange 规则 */
-export declare function applyBusinessTableRulesOnFieldChange(doc: Doc, changedPath: string): void;
+export declare function applyBusinessTableRulesOnFieldChange(doc: Doc, changedPath: string, fieldChange?: FieldChangeDetail): void;
 /** 子表插行后：应用 onRowInit + always */
 export declare function applyBusinessTableRulesOnRowInit(doc: Doc, subFieldKey: string, rowIndex: number): void;
 /** 文档初始化后：应用 always + onRowInit 规则 */

package/dist/domain/table/_shared/runtime-engine.d.ts

@@ -1,4 +1,5 @@
 import { Doc } from '../../../core';
+import { FieldChangeDetail, FieldChangeMap } from '../../../core/data/DataManager';
 export { buildLinkageDownstreamClears, resolveBusinessSelectLinkage, type BusinessSelectLinkageResult, } from './linkage-engine';
 export { collectBusinessSubTableContexts, parseSubtableFieldPath, type BusinessSubTableRuntimeContext, } from './table-runtime-shared';
 /** 文档初始化 */
@@ -6,4 +7,6 @@ export declare function applyBusinessTableRuntimeOnInit(doc: Doc): void;
 /** 子表插行 */
 export declare function applyBusinessTableRuntimeOnRowInit(doc: Doc, subFieldKey: string, rowIndex: number): void;
 /** 字段变更 */
-export declare function applyBusinessTableRuntimeOnFieldChange(doc: Doc, changedPath: string): void;
+export declare function applyBusinessTableRuntimeOnFieldChange(doc: Doc, changedPath: string, fieldChange?: FieldChangeDetail): void;
+/** 批量字段变更 */
+export declare function applyBusinessTableRuntimeOnFieldChanges(doc: Doc, changedMap: FieldChangeMap): void;

package/dist/domain/table/_shared/table-runtime-shared.d.ts

@@ -1,4 +1,5 @@
 import { Doc } from '../../../core';
+import { FieldChangeDetail } from '../../../core/data/DataManager';
 import { BusinessFieldProfile, BusinessSubTableProfile, RuleContext } from '../types';
 export interface BusinessSubTableRuntimeContext {
     profile: BusinessSubTableProfile;
@@ -37,4 +38,8 @@ export declare function forEachBusinessTableRow(doc: Doc, runtimeCtx: BusinessSu
     rowIndex?: number;
     changedFieldKey?: string;
 } | undefined, iteratee: (ctx: RuleContext) => void): void;
+/** 判断字段值是否实质未变（用于避免同值 set 误触发级联清空） */
+export declare function isSameFieldValue(a: unknown, b: unknown): boolean;
+/** 上游字段变更是否应触发下游清空 */
+export declare function shouldClearDownstreamForFieldChange(change?: FieldChangeDetail): boolean;
 export {};