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

package/dist/base/index.d.ts

@@ -24,6 +24,7 @@ export * from './table';
 export * from './tooltip';
 export * from './tree';
 export * from './tree-select';
+export * from './rdo-tree-select';
 export * from './date-time-picker';
 export * from './color-picker';
 export * from './avatar';

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<HTMLInputElement | HTMLTextAreaElement | null, HTMLInputElement | HTMLTextAreaElement | null>;
+    inputRef: import('vue').Ref<HTMLTextAreaElement | HTMLInputElement | null, HTMLTextAreaElement | HTMLInputElement | null>;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
     input: (value: string | number, event: Event) => any;
     search: (value: string | number) => any;
@@ -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;
@@ -47,6 +47,8 @@ declare const __VLS_component: import('vue').DefineComponent<GctInputProps, {
     readonly: boolean;
     disabled: boolean;
     size: import('./types').InputSize;
+    autocomplete: string;
+    spellcheck: boolean;
     placeholder: string;
     modelValue: string | number;
     prefix: string;
@@ -58,11 +60,9 @@ 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

@@ -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,23 +35,23 @@ 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;
+    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/index.d.ts

@@ -0,0 +1,3 @@
+export { default as GctRdoTreeSelect } from './src/rdo-tree-select.vue';
+export type { RdoDisplayInfo } from './src/display';
+export type { RdoTreeNode, RdoListParams } from './src/types';

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

@@ -0,0 +1,12 @@
+import { RdoTreeNode } from './types';
+export interface RdoDisplayInfo {
+    text: string;
+    showDefaultTag?: boolean;
+}
+/** 子版本选中：展示 父:子，不展示默认标签 */
+export declare function buildChildDisplay(parentLabel: string, versionLabel: string): RdoDisplayInfo;
+/** 父节点选中且未开启 parentToDefault：仅展示父名称 + 默认标签 */
+export declare function buildParentOnlyDisplay(parentLabel: string): RdoDisplayInfo;
+/** 根据 parentId:childId 解析展示文案 */
+export declare function resolveDisplayByValue(value: string, findChild: (value: string) => RdoTreeNode | undefined, findParent: (parentId: string) => RdoTreeNode | undefined): RdoDisplayInfo | null;
+export declare function resolveNodeDisplay(value: string, node: RdoTreeNode, findChild: (value: string) => RdoTreeNode | undefined, findParent: (parentId: string) => RdoTreeNode | undefined, parentToDefault?: boolean): RdoDisplayInfo;

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

@@ -0,0 +1,8 @@
+declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    "load-more": () => any;
+}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{
+    "onLoad-more"?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {
+    targetRef: HTMLDivElement;
+}, HTMLDivElement>;
+export default _default;

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

@@ -0,0 +1,17 @@
+import { RdoTreeNode } from './types';
+type __VLS_Props = {
+    node: RdoTreeNode;
+    level: number;
+    expandedKeys: Array<string | number>;
+    selectedKey?: string;
+    disabledParent?: boolean;
+    parentToDefault?: boolean;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    select: (node: RdoTreeNode) => any;
+    toggle: (key: string | number) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSelect?: ((node: RdoTreeNode) => any) | undefined;
+    onToggle?: ((key: string | number) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

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

@@ -0,0 +1,42 @@
+import { RdoDisplayInfo } from './display';
+import { RdoTreeNode } from './types';
+type __VLS_Props = {
+    modelValue?: string | null;
+    modelKey: string;
+    modelCategory?: string;
+    placeholder?: string;
+    disabledParent?: boolean;
+    parentToDefault?: boolean;
+    disabled?: boolean;
+    allowClear?: boolean;
+    popperWidth?: number;
+    pageSize?: number;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    change: (value?: string | null | undefined, node?: RdoTreeNode | undefined, display?: RdoDisplayInfo | undefined) => any;
+    "update:modelValue": (value?: string | null | undefined) => any;
+    "update:fullPathValue": (value?: string | null | undefined) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onChange?: ((value?: string | null | undefined, node?: RdoTreeNode | undefined, display?: RdoDisplayInfo | undefined) => any) | undefined;
+    "onUpdate:modelValue"?: ((value?: string | null | undefined) => any) | undefined;
+    "onUpdate:fullPathValue"?: ((value?: string | null | undefined) => any) | undefined;
+}>, {
+    disabled: boolean;
+    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: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Record<string, any> & {}, {}, {}, {}, {}, {}> | null;
+}, HTMLDivElement>;
+export default _default;

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

@@ -0,0 +1,22 @@
+export interface RdoTreeNode {
+    key: string | number;
+    /** 树下拉项展示文案 */
+    title: string;
+    /** 选中后输入框展示文案（一般为 父:子） */
+    displayLabel?: string;
+    /** 父节点在列表中是否展示默认标签 */
+    showDefaultTag?: boolean;
+    children?: RdoTreeNode[];
+    /** 实际选中值（子节点为 parentId:childId） */
+    rawValue?: string;
+    _info?: Record<string, any>;
+    /** 是否为默认版本 */
+    isDefault?: boolean;
+    /** 仅用于“加载更多”占位节点 */
+    isLoadMore?: boolean;
+    disabled?: boolean;
+}
+export interface RdoListParams {
+    pageNo?: number;
+    pageSize?: number;
+}

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

@@ -0,0 +1,58 @@
+import { RdoDisplayInfo } from './display';
+import { RdoListParams, RdoTreeNode } from './types';
+export declare function useRdoTreeOptions(options: {
+    modelKey: string;
+    modelCategory?: string;
+}): {
+    treeData: import('vue').Ref<{
+        key: string | number;
+        title: string;
+        displayLabel?: string | undefined;
+        showDefaultTag?: boolean | undefined;
+        children?: /*elided*/ any[] | undefined;
+        rawValue?: string | undefined;
+        _info?: Record<string, any> | undefined;
+        isDefault?: boolean | undefined;
+        isLoadMore?: boolean | undefined;
+        disabled?: boolean | undefined;
+    }[], RdoTreeNode[] | {
+        key: string | number;
+        title: string;
+        displayLabel?: string | undefined;
+        showDefaultTag?: boolean | undefined;
+        children?: /*elided*/ any[] | undefined;
+        rawValue?: string | undefined;
+        _info?: Record<string, any> | undefined;
+        isDefault?: boolean | undefined;
+        isLoadMore?: boolean | undefined;
+        disabled?: boolean | undefined;
+    }[]>;
+    loadOptions: (arg?: RdoListParams) => Promise<void>;
+    ensureSelectedNode: (id?: string) => Promise<void>;
+    getNodeDisplay: (value?: string, parentToDefault?: boolean) => RdoDisplayInfo;
+    initByValue: (value?: string, pageSize?: number, parentToDefault?: boolean) => Promise<RdoDisplayInfo | undefined>;
+    findChildNode: (value: string) => {
+        key: string | number;
+        title: string;
+        displayLabel?: string | undefined;
+        showDefaultTag?: boolean | undefined;
+        children?: /*elided*/ any[] | undefined;
+        rawValue?: string | undefined;
+        _info?: Record<string, any> | undefined;
+        isDefault?: boolean | undefined;
+        isLoadMore?: boolean | undefined;
+        disabled?: boolean | undefined;
+    } | undefined;
+    findParentNode: (parentId: string) => {
+        key: string | number;
+        title: string;
+        displayLabel?: string | undefined;
+        showDefaultTag?: boolean | undefined;
+        children?: /*elided*/ any[] | undefined;
+        rawValue?: string | undefined;
+        _info?: Record<string, any> | undefined;
+        isDefault?: boolean | undefined;
+        isLoadMore?: boolean | undefined;
+        disabled?: boolean | undefined;
+    } | undefined;
+};

package/dist/base/select/index.d.ts

@@ -1 +1,2 @@
 export { default as GctSelect } from './src/basic-select.vue';
+export { default as GctSearchableSelect } from './src/searchable-select.vue';

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

@@ -0,0 +1,28 @@
+import { DropdownOption } from '../../dropdown';
+type __VLS_Props = {
+    options: DropdownOption[];
+    modelValue?: string | number;
+    placeholder?: string;
+    disabled?: boolean;
+    readonly?: boolean;
+    allowClear?: boolean;
+    popperWidth?: number;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    change: (val?: string | number | undefined, item?: DropdownOption | undefined) => any;
+    "update:modelValue": (val?: string | number | undefined) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onChange?: ((val?: string | number | undefined, item?: DropdownOption | undefined) => any) | undefined;
+    "onUpdate:modelValue"?: ((val?: string | number | undefined) => any) | undefined;
+}>, {
+    readonly: boolean;
+    disabled: boolean;
+    options: DropdownOption[];
+    placeholder: string;
+    allowClear: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    rootRef: HTMLDivElement;
+    inputRef: HTMLInputElement;
+    dropdownRef: HTMLDivElement;
+}, HTMLDivElement>;
+export default _default;

package/dist/capabilities/panel/schema/types.d.ts

@@ -1,11 +1,21 @@
+import { ActivePanelData } from '../../../domain/active/active-types';
+import { AttachFieldTarget } from '../../../domain/field/attach-field';
+export type PanelBreadcrumbItem = {
+    key: string;
+    value: string;
+};
+export type PanelTitle = string | PanelBreadcrumbItem[];
+export type PanelTitleContext = {
+    active: ActivePanelData | null;
+    attachFieldTarget: AttachFieldTarget | null;
+};
 export interface PanelSchema {
     /** schema 唯一 key */
     key: PanelSchemaKey;
     /** 面板标题 */
-    title: string | Array<{
-        key: string;
-        value: string;
-    }>;
+    title: PanelTitle;
+    /** 按当前上下文解析标题（如引用字段面包屑） */
+    resolveTitle?: (ctx: PanelTitleContext) => PanelTitle;
     /** 实际渲染组件 */
     render: any;
 }

package/dist/core/command/base/CommandBase.d.ts

@@ -3,6 +3,7 @@ import { Doc } from '../../view/Doc';
 import { Wr, Wp, Wtbl, Wtr, Wtc } from '../../model/document';
 import { RawElement } from '../../model/types/raw';
 import { CursorManager } from '../../cursor/CursorManager';
+import { LayoutNode } from '../../view/base/LayoutNode';
 export declare const SelectionMode: {
     readonly PP: "PP";
     readonly PTr: "PTr";
@@ -209,5 +210,7 @@ export declare abstract class CommandBase<T extends CommandType = CommandType> i
         modelIndex: number;
         modelParent: Wp;
     } | undefined;
+    /** 设计态删除字段组件后，清理 DataManager 中该字段的 defaults / rawData / 依赖 */
+    protected cleanupDesignFieldBinding(run?: LayoutNode): void;
 }
 export {};

package/dist/core/command/commands/{Delete2DTable.d.ts → DeleteSubTable.d.ts}

@@ -2,11 +2,9 @@ import { Doc } from '../../view/Doc';
 import { CommandPayloadMap } from '../types';
 import { CommandBase, PostCommandContext } from '../base/CommandBase';
 /**
- * 删除二维表命令
- *
- * 删除指定的 2d-table 区域
+ * 删除子表
  */
-export declare class Delete2DTable extends CommandBase<'delete2DTable'> {
-    constructor(doc: Doc, payload?: CommandPayloadMap['delete2DTable']);
+export declare class DeleteSubTable extends CommandBase<'deleteSubTable'> {
+    constructor(doc: Doc, payload?: CommandPayloadMap['deleteSubTable']);
     protected execute(): Promise<PostCommandContext>;
 }

package/dist/core/command/commands/SetMaterialConsumeTable.d.ts

@@ -0,0 +1,7 @@
+import { CommandBase, PostCommandContext } from '../base/CommandBase';
+import { Doc } from '../../view/Doc';
+import { CommandPayloadMap } from '../types';
+export declare class SetMaterialConsumeTable extends CommandBase<'setMaterialConsumeTable'> {
+    constructor(doc: Doc, payload?: CommandPayloadMap['setMaterialConsumeTable']);
+    protected execute(): Promise<PostCommandContext>;
+}

package/dist/core/command/types.d.ts

@@ -3,6 +3,7 @@ import { Doc } from '../view/Doc';
 import { WidgetMeta } from '../widget/widget-meta';
 import { WordHighlight } from '../model/types';
 import { PointerHitResult } from '../cursor/hit/types';
+import { SubTableRegionType } from '../model/document/wtcRegionRef';
 export interface CursorMeta {
     nodeId: string;
     offset: number;
@@ -52,16 +53,14 @@ export declare const CommandType: {
     readonly deleteTableHeader: "deleteTableHeader";
     readonly setRepeating: "setRepeating";
     readonly set2DTable: "set2DTable";
+    readonly setMaterialConsumeTable: "setMaterialConsumeTable";
     readonly setBounded: "setBounded";
     readonly setBoundedItem: "setBoundedItem";
     readonly setCheckTable: "setCheckTable";
     readonly setDataGroup2D: "setDataGroup2D";
     readonly setSubTableHeader: "setSubTableHeader";
-    readonly deleteRepeating: "deleteRepeating";
-    readonly delete2DTable: "delete2DTable";
-    readonly deleteBounded: "deleteBounded";
+    readonly deleteSubTable: "deleteSubTable";
     readonly deleteBoundedItem: "deleteBoundedItem";
-    readonly deleteCheckTable: "deleteCheckTable";
     readonly deleteDataGroup2D: "deleteDataGroup2D";
     readonly insertRow: "insertRow";
     readonly insertCol: "insertCol";
@@ -162,6 +161,10 @@ export type CommandPayloadMap = {
         name: string;
         valuePath: string;
     };
+    setMaterialConsumeTable: CommandPayload & {
+        name: string;
+        valuePath: string;
+    };
     setBounded: CommandPayload & {
         name: string;
         valuePath: string;
@@ -178,26 +181,15 @@ export type CommandPayloadMap = {
     setSubTableHeader: CommandPayload & {
         name: string;
     };
-    deleteRepeating: CommandPayload & {
-        tableId: string;
-        regionId: string;
-    };
-    delete2DTable: CommandPayload & {
-        tableId: string;
-        regionId: string;
-    };
-    deleteBounded: CommandPayload & {
+    deleteSubTable: CommandPayload & {
         tableId: string;
         regionId: string;
+        regionType: SubTableRegionType;
     };
     deleteBoundedItem: CommandPayload & {
         tableId: string;
         regionId: string;
     };
-    deleteCheckTable: CommandPayload & {
-        tableId: string;
-        regionId: string;
-    };
     deleteDataGroup2D: CommandPayload & {
         tableId: string;
         regionId: string;

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<{}>, {
-    visible: boolean;
-    caretColor: string;
     caretWidth: number;
+    caretColor: string;
     blinkInterval: number;
     alwaysVisibleAfterEventMs: number;
+    visible: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 export default _default;

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

@@ -65,6 +65,7 @@ export declare class DataManager {
     private scheduleLayout;
     getLabelPath(path: JsonPath): JsonPath;
     getHrefPath(path: JsonPath): JsonPath;
+    getFieldRuntimeSpecificConfigKeys(): string[];
     getFieldRuntimeSpecificConfig(path: JsonPath): FieldRuntimeSpecificConfig | undefined;
     setFieldRuntimeSpecificConfig(path: JsonPath, partial: FieldRuntimeSpecificConfig): void;
     /** 子表插行后：index 及之后的行配置下标 +1 */
@@ -290,6 +291,18 @@ export declare class DataManager {
      * 获取父路径
      */
     private getParentPath;
+    /**
+     * 设计态删除字段后，清理该字段在 DataManager 中的绑定数据
+     * @param designValuePath 设计时 valuePath（可含 [n] / [n_y][n_x] 通配符）
+     * @param runtimeValuePath 版面解析后的具体路径（可选）
+     */
+    removeFieldBindingData(designValuePath: JsonPath, runtimeValuePath?: JsonPath): void;
+    /** 收集与字段绑定相关的路径（含 value / label / href 及通配符变体） */
+    private collectFieldBindingPaths;
+    /** 收集可从 rawData 删除的具体路径（跳过含通配符的设计路径） */
+    private collectConcreteRawDataPaths;
+    /** 移除字段注册的组件依赖 */
+    private removeFieldDependencies;
     /**
      * 设置默认值
      * @param path jsonpath 路径 (支持 [n] 数组索引和 [n] 通配符)

package/dist/core/interaction/types.d.ts

@@ -1,4 +1,5 @@
 import { ActivePanelData } from '../../domain/active/active-types';
+import { AttachFieldTarget } from '../../domain/field/attach-field';
 export type ITableSelection = {
     tableId: string;
     axis: 'row' | 'col' | 'all';
@@ -20,6 +21,8 @@ export type InteractionState = {
     focusTick: number | undefined;
     /** 当前点击的组件 右侧面板 */
     panelData: ActivePanelData | null;
+    /** 引用字段配置定位（与 panel:attach-field 配合） */
+    attachFieldTarget: AttachFieldTarget | null;
     /** 字段校验批注信息集合 */
     validationCommentMap: Record<string, Array<{
         field: string;
@@ -36,5 +39,7 @@ export type InteractionState = {
     focusAnnotationId: string | null;
     /** 记录变更的详情信息列表 */
     annotationList: any[] | null;
+    /** 扫码字段模式记忆（true=扫码，false=搜索） */
+    scanModeMap: Record<string, boolean>;
 };
 export type InteractionType = keyof InteractionState;

package/dist/core/interaction/useInteraction.d.ts

@@ -18,11 +18,27 @@ export declare function useInteraction(docRef: Ref<Doc | null>): {
         readonly context: {
             readonly mainModelKey?: string | undefined;
             readonly subFieldKey?: string | undefined;
+            readonly parentModelId?: string | undefined;
             readonly isDataGroup2DClicked?: boolean | undefined;
             readonly regionId?: string | undefined;
             readonly secRefId?: string | undefined;
         };
     } | null | undefined;
+    readonly attachFieldTarget?: {
+        readonly kind: "boolean";
+        readonly itemsKey: "trueAttachFields" | "falseAttachFields";
+        readonly parentModelId: string;
+        readonly itemId: string;
+        readonly attachFieldLabel: string;
+        readonly subFieldKey?: string | undefined;
+    } | {
+        readonly kind: "enum-option";
+        readonly optionId: string;
+        readonly parentModelId: string;
+        readonly itemId: string;
+        readonly attachFieldLabel: string;
+        readonly subFieldKey?: string | undefined;
+    } | null | undefined;
     readonly validationCommentMap?: {
         readonly [x: string]: readonly {
             readonly field: string;
@@ -35,4 +51,7 @@ export declare function useInteraction(docRef: Ref<Doc | null>): {
     readonly annotationIds?: readonly string[] | null | undefined;
     readonly focusAnnotationId?: string | null | undefined;
     readonly annotationList?: readonly any[] | null | undefined;
+    readonly scanModeMap?: {
+        readonly [x: string]: boolean;
+    } | undefined;
 };

package/dist/core/layout/LayoutMapper.d.ts

@@ -16,10 +16,14 @@ export declare class LayoutMapper {
     /** 组件信息中心 */
     widgetMetaMap: Map<string, any>;
     modelMap: Map<string, ModelMode>;
+    /** 布局期生成的 model 节点（如布尔/枚举引用字段），不在 doc.model 树中 */
+    runtimeModelMap: Map<string, ModelMode>;
     modelSplitMap: Map<string, string[]>;
     /** 扁平处理 layout 数据 */
     buildLayoutIndex(): void;
     buildModelMap(): void;
+    /** 注册布局期生成的 model 节点，供 getModelNodeById 查找 */
+    registerRuntimeModelNode(node: ModelMode): void;
     getBaseMetaNodeById<T extends BaseMetaNode>(id?: string): T | undefined;
     getBaseMetaNodeByIds<T extends BaseMetaNode>(ids: string[]): T[] | undefined;
     getLayoutNodeById(id: string): Page | import('../view/base').BandContainer | import('..').Paragraph | import('..').Table | import('../view/TableCell').TableCell | import('../view/TableRow').TableRow | import('..').OverlayLayout | import('../view/base').OverlayContainer | import('..').TextRun | import('..').ImageRun | undefined;

package/dist/core/layout/attach-field/AttachFieldContext.d.ts

@@ -0,0 +1,59 @@
+import { Doc } from '../..';
+import { BaseMetaNode } from '../types';
+import { WidgetMeta } from '../../widget/widget-meta';
+import { MultipleItem } from '../../../suites/shared/panel/config/editor/attach-fields-editor/types';
+import { AttachFieldTarget } from '../../../domain/field/attach-field';
+import { AttachFieldParentMeta, WidgetOptionLike } from './types';
+export type AttachFieldCursorPin = {
+    nodeId: string;
+    side: 'before' | 'after';
+};
+/**
+ * 引用字段（attach field）运行时上下文。
+ */
+export declare class AttachFieldContext {
+    /** `widgetMeta.extra.biz` 上标识「此为引用字段」的键 */
+    static readonly BIZ_FLAG: "isAttachField";
+    /**
+     * 为布局生成的 widgetMeta.extra 打上引用字段标记。
+     */
+    static markAttachFieldMeta(extra?: WidgetMeta['extra']): WidgetMeta['extra'];
+    /** 当前 widget 是否为引用字段（非画布拖入的独立字段组件） */
+    static isAttachFieldWidget(widgetMeta: WidgetMeta | undefined | null): boolean;
+    /** 读取布局阶段写入的「父选项」绑定信息，非引用字段返回 null */
+    static getParentMeta(widgetMeta: WidgetMeta | undefined | null): AttachFieldParentMeta | null;
+    /** 由父字段 props 与选项值解析列表定位，供面板与画布点击共用 */
+    private static resolveListContext;
+    /** 根据引用字段 widgetMeta.id 解析画布上的 modelRef.id */
+    static resolveAttachFieldModelId(doc: Doc, itemId: string): string | null;
+    /** 画布点击引用字段时，生成与 panel 列表点击一致的 `attachFieldTarget` */
+    static resolveAttachFieldTarget(doc: Doc, widgetMeta: WidgetMeta): AttachFieldTarget | null;
+    private static isFieldMarkerRun;
+    /** 引用字段 model 分组内的正文字符 run（排除 [ ] 与间距占位） */
+    private static getAttachFieldContentNodes;
+    /** 取节点内最后一个字符索引（单字节点为 0） */
+    private static getNodeLastCharOffset;
+    /**
+     * 点击引用字段【/】时，落到内侧首尾字符：
+     * 【 → 首字 before；】 → 末字 after
+     */
+    static resolveAttachFieldMarkerContentPin(doc: Doc, modelId: string, marker: 'left' | 'right'): (AttachFieldCursorPin & {
+        offset: number;
+    }) | null;
+    static getModelSplitNodes(doc: Doc, modelId: string): BaseMetaNode[];
+    /**
+     * 从父组件 props 解析某一选项下的引用字段列表。
+     * - 布尔：`trueAttachFields` / `falseAttachFields`
+     * - 枚举：选项对象上的 `attachFields`（通常来自 computedOptions）
+     */
+    static getOptionAttachFields(widgetProps: Record<string, any> | undefined, option: WidgetOptionLike): MultipleItem[];
+    /**
+     * 父字段当前值是否包含本引用字段绑定的选项值。
+     * 用于条件校验、overlay 禁用等：未选中对应选项时不应要求填写引用字段。
+     */
+    private static isParentOptionActive;
+    /** 引用字段当前是否处于可填报 / 可校验状态。无父绑定信息时视为普通字段，恒为 true。 */
+    static isActive(doc: Doc, widgetMeta: WidgetMeta | undefined | null): boolean;
+    /** 枚举 / 布尔选项值相等比较（布尔走 toBoolean，其余按字符串） */
+    private static isSameOptionValue;
+}

package/dist/core/layout/attach-field/index.d.ts

@@ -0,0 +1,2 @@
+export { AttachFieldContext } from './AttachFieldContext';
+export type { AttachFieldParentMeta, WidgetOptionLike } from './types';

package/dist/core/layout/attach-field/types.d.ts

@@ -0,0 +1,20 @@
+import { MultipleItem } from '../../../suites/shared/panel/config/editor/attach-fields-editor/types';
+/** 布局时写入引用字段 widgetMeta 的父选项绑定（见 AttachFieldHandler） */
+export type AttachFieldParentMeta = {
+    /** 父字段 layout modelRef.id，设计态 hover 委托用 */
+    parentModelRefId: string;
+    /** 父字段运行时 valuePath，用于读取当前选中值 */
+    parentRuntimeValuePath: string;
+    /** 本引用字段绑定的选项值（true/false 或枚举项 value） */
+    parentOptionValue: unknown;
+    /** 父字段是否为多选枚举（fw:enum-multiple） */
+    isMultiple: boolean;
+    /** 父字段子表 subFieldKey，设计态面板 extra 用 */
+    parentSubFieldKey?: string;
+};
+/** 布局解析 computedOptions 时的选项结构（含 attachFields） */
+export type WidgetOptionLike = {
+    value: unknown;
+    label: string;
+    attachFields?: MultipleItem[];
+};

package/dist/core/layout/handlers/fields/AttachFieldHandler.d.ts

@@ -0,0 +1,10 @@
+import { FieldBaseHandler } from './FieldBaseHandler';
+import { TextRun } from '../../../view/runs/TextRun';
+import { HandlerContext } from '../../types';
+import { WidgetOptionLike } from '../../attach-field/types';
+/** 布尔 / 枚举选项后的引用字段布局 */
+export declare class AttachFieldHandler extends FieldBaseHandler {
+    static layoutOptionAttachFields(ctx: HandlerContext, option: WidgetOptionLike, layoutStyle: ReturnType<typeof TextRun.textStyle2LayoutStyle>): void;
+    private static buildWidgetMeta;
+    private static layoutItem;
+}