@gct-paas/word 0.1.47-beta.2 → 0.1.47-beta.4

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/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/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/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;

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;

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;
+}

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

@@ -3,9 +3,11 @@ import { WrText } from '../../../model/document';
 import { LayoutContext } from '../../LayoutContext';
 import { TextRun } from '../../../view/runs/TextRun';
 import { HandlerContext } from '../../types';
+import { MultipleItem } from '../../../../suites/shared/panel/config/editor/attach-fields-editor/types';
 type WidgetOption = {
     value: any;
     label: string;
+    attachFields?: MultipleItem[];
 };
 export declare class OptionHandler extends FieldBaseHandler {
     static layout(ctx: HandlerContext): void;

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

@@ -4,3 +4,4 @@ export { SignatureHandler } from './SignatureHandler';
 export { InputHandler } from './InputHandler';
 export { AttachmentHandler } from './AttachmentHandler';
 export { FieldBaseHandler } from './FieldBaseHandler';
+export { AttachFieldHandler } from './AttachFieldHandler';

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

@@ -23,10 +23,14 @@ export type PanelType =
 /** 表头 */
  | 'panel:table-header'
 /** 组件 */
- | 'panel:widget';
+ | 'panel:widget'
+/** 布尔/枚举等父字段下的引用字段 */
+ | 'panel:attach-field';
 type ActiveContext = {
     mainModelKey: string;
     subFieldKey: string | undefined;
+    /** 引用字段 panel 时父字段的 modelId */
+    parentModelId?: string;
     isDataGroup2DClicked?: boolean;
     regionId: string;
     /** 章节引用 id */

package/dist/domain/field/attach-field.d.ts

@@ -0,0 +1,15 @@
+/** 引用字段列表在父字段 props 中的定位（布尔 / 枚举选项） */
+export type AttachFieldListContext = {
+    kind: 'boolean';
+    itemsKey: 'trueAttachFields' | 'falseAttachFields';
+} | {
+    kind: 'enum-option';
+    optionId: string;
+};
+/** 侧边栏 `panel:attach-field` 与 props 回写用的完整定位 */
+export type AttachFieldTarget = AttachFieldListContext & {
+    parentModelId: string;
+    itemId: string;
+    attachFieldLabel: string;
+    subFieldKey?: string;
+};