@jt-home/mfe-components 1.0.59 → 1.0.60-beta.1

package/dist/types/components/JtAttachmentPreview/types.d.ts

@@ -1,4 +1,4 @@
-export type JtAttachmentPreviewMode = 'auto' | 'image' | 'pdf' | 'video' | 'audio' | 'iframe';
+export type JtAttachmentPreviewMode = 'auto' | 'image' | 'pdf';
 export interface JtAttachmentPreviewDownloadContext<Params = unknown> {
     url: string;
     name: string;
@@ -40,8 +40,6 @@ export interface JtAttachmentPreviewOptions {
     download?: JtAttachmentPreviewDownloadHandler;
     /** 弹窗层级。 */
     zIndex?: number;
-    /** iframe sandbox 属性，不传则不限制 iframe。 */
-    sandbox?: string;
     /** 按 Esc 时是否关闭弹窗。 */
     closeOnPressEscape?: boolean;
     /** 加载成功回调。 */
@@ -52,6 +50,7 @@ export interface JtAttachmentPreviewOptions {
     onClose?: () => void;
 }
 export type JtAttachmentPreviewFileOptions = JtAttachmentPreviewOptions;
+export type JtAttachmentPreviewResolveFileHandler<Params = unknown> = (params: Params) => JtAttachmentPreviewFileOptions | Promise<JtAttachmentPreviewFileOptions>;
 export interface JtAttachmentPreviewRequestConfig<Params = unknown, Response = unknown, DownloadResponse = unknown> {
     /** 根据业务参数请求文件信息。可以直接调用 axios、fetch 或项目内 request。 */
     request: (params: Params) => Promise<Response>;
@@ -69,5 +68,8 @@ export interface JtAttachmentPreviewHandler {
 export interface JtAttachmentPreviewService {
     (options: string | JtAttachmentPreviewOptions): JtAttachmentPreviewHandler;
     openByParams: <Params = unknown>(params: Params) => JtAttachmentPreviewHandler;
-    setup: <Params = unknown, Response = unknown, DownloadResponse = unknown>(config: JtAttachmentPreviewRequestConfig<Params, Response, DownloadResponse>) => void;
+    setup: {
+        <Params = unknown>(resolveFile: JtAttachmentPreviewResolveFileHandler<Params>): void;
+        <Params = unknown, Response = unknown, DownloadResponse = unknown>(config: JtAttachmentPreviewRequestConfig<Params, Response, DownloadResponse>): void;
+    };
 }

package/dist/types/components/globalInfo/components/GlobalInfoGroup.vue.d.ts

@@ -5,6 +5,7 @@ type __VLS_Props = {
     state: GlobalInfoState;
     actions: GlobalInfoActions;
     index?: number;
+    loadOnVisible?: boolean;
     renderConfig?: GlobalInfoRenderConfig;
 };
 declare var __VLS_1: {
@@ -57,18 +58,22 @@ declare var __VLS_1: {
     handleCancel: () => void;
     handleSave: () => Promise<unknown>;
 }, __VLS_19: string, __VLS_20: {
+    field: import("../index.ts").GlobalInfoField;
     section: import("../index.ts").GlobalInfoSection;
     sectionView: import("../index.ts").GlobalInfoSection;
     node: GlobalInfoNode | null | undefined;
     editing: boolean;
-    isEmpty: boolean;
-    empty: boolean;
-    fields: import("../index.ts").GlobalInfoField[];
-    renderConfig: GlobalInfoRenderConfig | undefined;
+    modelValue: unknown;
+    value: unknown;
     state: GlobalInfoState;
     actions: GlobalInfoActions;
+    updateModelValue: (value: unknown) => void;
+    fields?: import("../index.ts").GlobalInfoField[];
+    renderConfig?: GlobalInfoRenderConfig;
     viewModel?: import("../index.ts").GlobalInfoViewModel;
     title?: string;
+    isEmpty?: boolean;
+    empty?: boolean;
     isSelfSection?: boolean;
     loading?: boolean;
     error?: unknown;

package/dist/types/components/globalInfo/components/GlobalInfoLeftNav.vue.d.ts

@@ -0,0 +1,29 @@
+import type { GlobalInfoNode, GlobalInfoSection } from '../model/types';
+type GlobalInfoLeftNavItem = GlobalInfoNode | GlobalInfoSection;
+type GlobalInfoLeftNavItemMeta = {
+    key?: string;
+    label?: string;
+    time?: string;
+    tag?: string;
+    icon?: string;
+    disabled?: boolean;
+    targetId?: string;
+};
+type __VLS_Props = {
+    items: GlobalInfoLeftNavItem[];
+    activeKey?: string;
+    mode: 'anchor' | 'timeline';
+    itemMeta?: (item: GlobalInfoLeftNavItem, index: number) => GlobalInfoLeftNavItemMeta;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    select: (item: GlobalInfoLeftNavItem, key: string) => any;
+    "update:activeKey": (key: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSelect?: ((item: GlobalInfoLeftNavItem, key: string) => any) | undefined;
+    "onUpdate:activeKey"?: ((key: string) => any) | undefined;
+}>, {
+    mode: "anchor" | "timeline";
+    activeKey: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/components/globalInfo/components/GlobalInfoSectionBlock.vue.d.ts

@@ -4,6 +4,7 @@ type __VLS_Props = {
     state: GlobalInfoState;
     actions: GlobalInfoActions;
     hideHeader?: boolean;
+    loadOnVisible?: boolean;
     renderConfig?: GlobalInfoRenderConfig;
     onEdit?: (section: GlobalInfoSection, node: GlobalInfoNode) => void | Promise<void>;
     onCancel?: (section: GlobalInfoSection, node: GlobalInfoNode) => void | Promise<void>;
@@ -55,7 +56,7 @@ declare var __VLS_1: {
     handleCancel?: () => Promise<void>;
     handleAddTableRow?: () => void;
     handleSave?: () => Promise<void>;
-}, __VLS_37: {
+}, __VLS_44: {
     section: GlobalInfoSection | null;
     sectionView?: GlobalInfoSection | null;
     node?: GlobalInfoNode | null;
@@ -78,7 +79,7 @@ declare var __VLS_1: {
     handleCancel?: () => Promise<void>;
     handleAddTableRow?: () => void;
     handleSave?: () => Promise<void>;
-}, __VLS_39: {
+}, __VLS_47: {
     section: GlobalInfoSection | null;
     sectionView?: GlobalInfoSection | null;
     node?: GlobalInfoNode | null;
@@ -101,19 +102,23 @@ declare var __VLS_1: {
     handleCancel?: () => Promise<void>;
     handleAddTableRow?: () => void;
     handleSave?: () => Promise<void>;
-}, __VLS_57: string, __VLS_58: {
+}, __VLS_65: string, __VLS_66: {
+    field: import("../index.ts").GlobalInfoField;
     section: GlobalInfoSection;
     sectionView: GlobalInfoSection;
     node: GlobalInfoNode | null | undefined;
     editing: boolean;
-    isEmpty: boolean;
-    empty: boolean;
-    fields: import("../index.ts").GlobalInfoField[];
-    renderConfig: GlobalInfoRenderConfig | undefined;
+    modelValue: unknown;
+    value: unknown;
     state: GlobalInfoState;
     actions: GlobalInfoActions;
+    updateModelValue: (value: unknown) => void;
+    fields?: import("../index.ts").GlobalInfoField[];
+    renderConfig?: GlobalInfoRenderConfig;
     viewModel?: import("../index.ts").GlobalInfoViewModel;
     title?: string;
+    isEmpty?: boolean;
+    empty?: boolean;
     isSelfSection?: boolean;
     loading?: boolean;
     error?: unknown;
@@ -124,7 +129,7 @@ declare var __VLS_1: {
     handleCancel?: () => Promise<void>;
     handleAddTableRow?: () => void;
     handleSave?: () => Promise<void>;
-}, __VLS_61: {
+}, __VLS_69: {
     section: GlobalInfoSection | null;
     sectionView?: GlobalInfoSection | null;
     node?: GlobalInfoNode | null;
@@ -149,17 +154,17 @@ declare var __VLS_1: {
     handleSave?: () => Promise<void>;
 };
 type __VLS_Slots = {} & {
-    [K in NonNullable<typeof __VLS_57>]?: (props: typeof __VLS_58) => any;
+    [K in NonNullable<typeof __VLS_65>]?: (props: typeof __VLS_66) => any;
 } & {
     header?: (props: typeof __VLS_1) => any;
 } & {
     actions?: (props: typeof __VLS_3) => any;
 } & {
-    loading?: (props: typeof __VLS_37) => any;
+    loading?: (props: typeof __VLS_44) => any;
 } & {
-    empty?: (props: typeof __VLS_39) => any;
+    empty?: (props: typeof __VLS_47) => any;
 } & {
-    empty?: (props: typeof __VLS_61) => any;
+    empty?: (props: typeof __VLS_69) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

package/dist/types/components/globalInfo/components/GlobalInfoSectionOutlet.vue.d.ts

@@ -18,9 +18,22 @@ declare var __VLS_2: string, __VLS_3: {
     renderConfig: GlobalInfoRenderConfig | undefined;
     state: GlobalInfoState;
     actions: GlobalInfoActions;
+}, __VLS_14: string, __VLS_15: {
+    field: import("../index.ts").GlobalInfoField;
+    section: GlobalInfoSection;
+    sectionView: GlobalInfoSection;
+    node: GlobalInfoNode | null | undefined;
+    editing: boolean;
+    modelValue: unknown;
+    value: unknown;
+    state: GlobalInfoState;
+    actions: GlobalInfoActions;
+    updateModelValue: (value: unknown) => void;
 };
 type __VLS_Slots = {} & {
     [K in NonNullable<typeof __VLS_2>]?: (props: typeof __VLS_3) => any;
+} & {
+    [K in NonNullable<typeof __VLS_14>]?: (props: typeof __VLS_15) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

package/dist/types/components/globalInfo/components/GlobalInfoSections.vue.d.ts

@@ -3,6 +3,7 @@ type __VLS_Props = {
     nodes: GlobalInfoNode[];
     state: GlobalInfoState;
     actions: GlobalInfoActions;
+    loadOnVisible?: boolean;
     renderConfig?: GlobalInfoRenderConfig;
 };
 declare var __VLS_2: string, __VLS_3: {
@@ -22,18 +23,22 @@ declare var __VLS_2: string, __VLS_3: {
     index: number;
     isEmpty: boolean;
 }, __VLS_15: string, __VLS_16: {
+    field: import("../index.ts").GlobalInfoField;
     section: import("../index.ts").GlobalInfoSection;
     sectionView: import("../index.ts").GlobalInfoSection;
     node: GlobalInfoNode | null | undefined;
     editing: boolean;
-    isEmpty: boolean;
-    empty: boolean;
-    fields: import("../index.ts").GlobalInfoField[];
-    renderConfig: GlobalInfoRenderConfig | undefined;
+    modelValue: unknown;
+    value: unknown;
     state: GlobalInfoState;
     actions: GlobalInfoActions;
+    updateModelValue: (value: unknown) => void;
+    fields?: import("../index.ts").GlobalInfoField[];
+    renderConfig?: GlobalInfoRenderConfig;
     viewModel?: import("../index.ts").GlobalInfoViewModel;
     title?: string;
+    isEmpty?: boolean;
+    empty?: boolean;
     isSelfSection?: boolean;
     loading?: boolean;
     error?: unknown;

package/dist/types/components/globalInfo/index.d.ts

@@ -1,15 +1,19 @@
 export { default as GlobalInfoProvider } from './components/GlobalInfoProvider.vue';
 export { default as GlobalInfoSections } from './components/GlobalInfoSections.vue';
 export { default as GlobalInfoGroup } from './components/GlobalInfoGroup.vue';
+export { default as GlobalInfoLeftNav } from './components/GlobalInfoLeftNav.vue';
 export { default as GlobalInfoSectionBlock } from './components/GlobalInfoSectionBlock.vue';
 export { default as GlobalInfoSectionOutlet } from './components/GlobalInfoSectionOutlet.vue';
 export { default as GlobalInfoAutoRenderer } from './renderers/GlobalInfoAutoRenderer.vue';
 export { default as GlobalInfoFormRenderer } from './renderers/GlobalInfoFormRenderer.vue';
+export { default as GlobalInfoMultiFormRenderer } from './renderers/GlobalInfoMultiFormRenderer.vue';
 export { default as GlobalInfoTableRenderer } from './renderers/GlobalInfoTableRenderer.vue';
 export { default as GlobalInfoFieldControl } from './renderers/GlobalInfoFieldControl.vue';
 export { default as GlobalInfoFieldValue } from './renderers/GlobalInfoFieldValue.vue';
 export { default as GlobalInfoDeleteConfirm } from './renderers/GlobalInfoDeleteConfirm.vue';
 export { useGlobalInfoController } from './controller/useGlobalInfoController';
-export { buildGlobalInfoUpdatePayload, createEmptyGlobalInfoViewModel, isGlobalInfoNode, mergeGlobalInfoChildren, normalizeGlobalInfoDetail, normalizeGlobalInfoTree, resolveGlobalInfoRenderType, } from './model/adapter';
+export { buildGlobalInfoUpdatePayload, createEmptyGlobalInfoViewModel, isGlobalInfoNode, mergeGlobalInfoChildren, normalizeGlobalInfoDetail, normalizeGlobalInfoOptions, normalizeGlobalInfoTree, resolveGlobalInfoRenderType, } from './model/adapter';
+export { getGlobalInfoFieldErrorKey, isGlobalInfoFieldRequired, resolveGlobalInfoFieldRequiredMessage, validateGlobalInfoRequiredFields, } from './model/fieldValidation';
+export type { GlobalInfoRequiredFieldValidationResult, } from './model/fieldValidation';
 export { DEFAULT_GLOBAL_INFO_REQUIRED_INFO_SET_EMPTY_MESSAGE, validateGlobalInfoRequiredInfoSet, } from './model/requiredInfoSetValidation';
-export type { GlobalInfoActions, GlobalInfoApiOperation, GlobalInfoDetailParams, GlobalInfoExternalOperationParamsFormatter, GlobalInfoExternalOperationParamsFormatterContext, GlobalInfoField, GlobalInfoFieldBusinessChangeContext, GlobalInfoFieldBusinessChangeHandler, GlobalInfoFieldHiddenContext, GlobalInfoFieldHiddenRule, GlobalInfoFieldOption, GlobalInfoInfoSet, GlobalInfoNode, GlobalInfoOperationContext, GlobalInfoOpenTreeParams, GlobalInfoProviderSlotProps, GlobalInfoRawRecord, GlobalInfoRequestSource, GlobalInfoRequestType, GlobalInfoRequiredInfoSetEmptyMessage, GlobalInfoRequiredInfoSetEmptyMessageContext, GlobalInfoRenderConfig, GlobalInfoRenderType, GlobalInfoScheme, GlobalInfoSection, GlobalInfoSectionLoadTarget, GlobalInfoSectionSlotScope, GlobalInfoSectionStatus, GlobalInfoSectionTarget, GlobalInfoService, GlobalInfoSetMark, GlobalInfoState, GlobalInfoTableRowDeleteVisibleContext, GlobalInfoTableRowDeleteVisibleRule, GlobalInfoTemplateTreeParams, GlobalInfoUpdateParams, GlobalInfoViewModel, } from './model/types';
+export type { GlobalInfoActions, GlobalInfoApiOperation, GlobalInfoBeforeSaveContext, GlobalInfoBeforeSaveHandler, GlobalInfoBeforeSaveResult, GlobalInfoDetailParams, GlobalInfoExternalOperationParamsFormatter, GlobalInfoExternalOperationParamsFormatterContext, GlobalInfoField, GlobalInfoFieldBusinessChangeContext, GlobalInfoFieldBusinessChangeHandler, GlobalInfoFieldHiddenContext, GlobalInfoFieldHiddenRule, GlobalInfoFieldOption, GlobalInfoFieldRequiredContext, GlobalInfoFieldRequiredRule, GlobalInfoInfoSet, GlobalInfoNode, GlobalInfoOperationContext, GlobalInfoOpenTreeParams, GlobalInfoProviderSlotProps, GlobalInfoRawRecord, GlobalInfoRequestSource, GlobalInfoRequestType, GlobalInfoRequiredInfoSetEmptyMessage, GlobalInfoRequiredInfoSetEmptyMessageContext, GlobalInfoRenderConfig, GlobalInfoRenderType, GlobalInfoScheme, GlobalInfoSection, GlobalInfoSectionLoadTarget, GlobalInfoSectionSlotScope, GlobalInfoSectionStatus, GlobalInfoSectionTarget, GlobalInfoService, GlobalInfoSetMark, GlobalInfoState, GlobalInfoTableRowDeleteVisibleContext, GlobalInfoTableRowDeleteVisibleRule, GlobalInfoTemplateTreeParams, GlobalInfoUpdateParams, GlobalInfoViewModel, } from './model/types';

package/dist/types/components/globalInfo/model/fieldUtils.d.ts

@@ -42,7 +42,7 @@ export declare function normalizeGlobalInfoSelectValues(field: GlobalInfoField,
 export declare function toGlobalInfoSelectModelValue(field: GlobalInfoField, value: GlobalInfoFieldValue): GlobalInfoFieldValue;
 export declare function fromGlobalInfoSelectModelValue(field: GlobalInfoField, value: GlobalInfoFieldValue): GlobalInfoFieldValue;
 export declare function toGlobalInfoBooleanValue(value: GlobalInfoFieldValue): boolean;
-export declare function isGlobalInfoOptionValueMatched(option: Pick<GlobalInfoFieldOption, 'value' | 'raw'> & Partial<Pick<GlobalInfoFieldOption, 'code' | 'id'>>, value: GlobalInfoFieldValue): boolean;
+export declare function isGlobalInfoOptionValueMatched(option: Pick<GlobalInfoFieldOption, 'value' | 'raw'> & Partial<Pick<GlobalInfoFieldOption, 'code'>>, value: GlobalInfoFieldValue): boolean;
 export declare function resolveGlobalInfoVisibleFields(fields: GlobalInfoField[], section?: GlobalInfoSection | null, config?: GlobalInfoRenderConfig, runtime?: GlobalInfoFieldVisibilityRuntime): GlobalInfoField[];
 export declare function isGlobalInfoSequenceField(field: GlobalInfoField): boolean;
 export declare function isGlobalInfoSeqNoField(field: GlobalInfoField): boolean;

package/dist/types/components/globalInfo/model/fieldValidation.d.ts

@@ -0,0 +1,19 @@
+import type { GlobalInfoField, GlobalInfoRawRecord, GlobalInfoRenderConfig, GlobalInfoSection } from './types';
+export interface GlobalInfoRequiredFieldValidationResult {
+    /** 字段实例级错误表；表格字段使用 rowIndex:fieldCode 作为 key。 */
+    fieldErrors: Record<string, string>;
+    /** 第一个错误文案，供保存前直接阻断。 */
+    firstMessage: string | null;
+}
+export declare function getGlobalInfoFieldErrorKey(field: GlobalInfoField, rowIndex?: number): string;
+export declare function isGlobalInfoFieldRequired(field: GlobalInfoField, section: GlobalInfoSection, config: GlobalInfoRenderConfig | undefined, values: GlobalInfoRawRecord, runtime?: {
+    row?: GlobalInfoRawRecord;
+    rowIndex?: number;
+    rows?: GlobalInfoRawRecord[];
+}): boolean;
+export declare function resolveGlobalInfoFieldRequiredMessage(field: GlobalInfoField, section: GlobalInfoSection, config: GlobalInfoRenderConfig | undefined, values: GlobalInfoRawRecord, runtime?: {
+    row?: GlobalInfoRawRecord;
+    rowIndex?: number;
+    rows?: GlobalInfoRawRecord[];
+}): string | null;
+export declare function validateGlobalInfoRequiredFields(section: GlobalInfoSection, config?: GlobalInfoRenderConfig): GlobalInfoRequiredFieldValidationResult;

package/dist/types/components/globalInfo/model/slotIdentity.d.ts

@@ -1,6 +1,6 @@
 import type { GlobalInfoNode, GlobalInfoSection } from './types';
 type SlotRegistry = Record<string, unknown>;
 export declare function getNodeSlotIdentity(node: Pick<GlobalInfoNode, 'code'>): string;
-export declare function getSectionSlotIdentity(node: Pick<GlobalInfoNode, 'code'>, section?: Pick<GlobalInfoSection, 'code'> | null): string;
+export declare function getSectionSlotIdentity(node: Partial<Pick<GlobalInfoNode, 'code' | 'infSetId' | 'setId'>>, section?: Pick<GlobalInfoSection, 'code'> | null): string;
 export declare function findGlobalInfoSlotName(slotMap: SlotRegistry, prefix: string, identity: string): string;
 export {};

package/dist/types/components/globalInfo/model/types.d.ts

@@ -5,7 +5,7 @@ export type GlobalInfoPrimitive = string | number | boolean | null;
 /** 字段值保持开放，文件、日期对象、自定义插槽值都可以透传。 */
 export type GlobalInfoFieldValue = unknown;
 /** 信息集最终渲染类型：表单、表格、文本、HTML、代码、多行、空态或文件。 */
-export type GlobalInfoRenderType = 'form' | 'table' | 'text' | 'html' | 'code' | 'multi-row' | 'empty' | 'file';
+export type GlobalInfoRenderType = 'form' | 'table' | 'multi-form' | 'text' | 'html' | 'code' | 'multi-row' | 'empty' | 'file';
 /** 字段动态隐藏方法上下文，values 是当前表单或当前表格行的完整值。 */
 export interface GlobalInfoFieldHiddenContext {
     /** 当前字段定义。 */
@@ -86,12 +86,55 @@ export type GlobalInfoRequiredInfoSetEmptyMessageContext = {
     infSetValues: GlobalInfoRawRecord[];
 };
 export type GlobalInfoRequiredInfoSetEmptyMessage = string | ((context: GlobalInfoRequiredInfoSetEmptyMessageContext) => string);
+/** 字段级必填规则上下文，values 始终是当前表单或当前表格行的值。 */
+export interface GlobalInfoFieldRequiredContext {
+    /** 当前字段定义。 */
+    field: GlobalInfoField;
+    /** 当前字段所属 section。 */
+    section: GlobalInfoSection;
+    /** 当前表单或表格行的所有字段值。 */
+    values: GlobalInfoRawRecord;
+    /** 当前字段值。 */
+    value: unknown;
+    /** 表格场景下的当前行数据，表单场景不传。 */
+    row?: GlobalInfoRawRecord;
+    /** 表格场景下的当前行下标，表单场景不传。 */
+    rowIndex?: number;
+    /** 表格场景下的完整 rows，表单场景不传。 */
+    rows?: GlobalInfoRawRecord[];
+}
+/** 返回 true 表示必填，返回字符串表示必填并使用该字符串作为错误文案。 */
+export type GlobalInfoFieldRequiredRule = (context: GlobalInfoFieldRequiredContext) => boolean | string;
+/** 保存前业务钩子上下文；payload 已经是即将提交给后端的数据。 */
+export interface GlobalInfoBeforeSaveContext {
+    /** 当前保存的信息集。 */
+    section: GlobalInfoSection;
+    /** 当前归属节点。 */
+    node?: GlobalInfoNode | null;
+    /** 当前表单模型。 */
+    model: GlobalInfoRawRecord;
+    /** 当前表格行或表单单行数据。 */
+    rows: GlobalInfoRawRecord[];
+    /** 即将提交给后端的保存 payload。 */
+    payload: GlobalInfoUpdateParams;
+    /** 当前全局状态快照。 */
+    state: GlobalInfoState;
+    /** controller 动作集合。 */
+    actions: GlobalInfoActions;
+}
+export type GlobalInfoBeforeSaveResult = void | boolean | string | Error;
+/** 保存前业务钩子；返回字符串、Error 或 false 时阻断保存。 */
+export type GlobalInfoBeforeSaveHandler = (context: GlobalInfoBeforeSaveContext) => GlobalInfoBeforeSaveResult | Promise<GlobalInfoBeforeSaveResult>;
 /** globalInfo 默认渲染器配置，字段隐藏只保留 hiddenRule 一种方式，避免多套规则互相覆盖。 */
 export interface GlobalInfoRenderConfig {
     /** 字段隐藏方法；字段值变化后 computed 会重新执行，返回 true 时隐藏当前字段。 */
     hiddenRule?: GlobalInfoFieldHiddenRule;
+    /** 字段级动态必填规则；隐藏字段不会参与必填校验。 */
+    requiredRule?: GlobalInfoFieldRequiredRule;
     /** 字段业务变更回调，用于把字段变更现场交给外部业务处理。 */
     onFieldBusinessChange?: GlobalInfoFieldBusinessChangeHandler;
+    /** 保存前业务钩子；只负责阻断或放行，普通保存仍由 saveSection 继续执行。 */
+    onBeforeSave?: GlobalInfoBeforeSaveHandler;
     /** 表格行删除按钮展示方法；返回 false 时只隐藏当前行删除入口。 */
     rowDeleteVisibleRule?: GlobalInfoTableRowDeleteVisibleRule;
     /** 信息集级必填为空时的提示文案；默认提示“信息集不能为空，最后一条数据不可删除”。 */
@@ -375,6 +418,8 @@ export interface GlobalInfoField {
     placeholder?: string;
     /** 静态或动态加载后的选项。 */
     options?: GlobalInfoFieldOption[];
+    /** 信息集枚举来源类型：NOTRANS 不处理，REST 调接口，ENUMS 使用详情响应内联枚举。 */
+    valueListType?: string;
     /** 字段动态接口描述，常用于级联下拉。 */
     interface?: GlobalInfoApiOperation;
     /** 当前字段变更后需要清空的字段 code 列表。 */
@@ -490,6 +535,8 @@ export interface GlobalInfoSectionStatus {
     loaded: boolean;
     /** 是否处于编辑态。 */
     editing: boolean;
+    /** 字段实例级错误，key 为字段 code 或 rowIndex:fieldCode。 */
+    fieldErrors?: Record<string, string>;
 }
 /** 模板树适配后的返回结构。 */
 export interface GlobalInfoTemplateResponse {

package/dist/types/components/globalInfo/model/valueListOptions.d.ts

@@ -0,0 +1,4 @@
+import type { GlobalInfoField, GlobalInfoFieldOption, GlobalInfoRawRecord } from './types';
+type NormalizeGlobalInfoOptions = (input: unknown) => GlobalInfoFieldOption[];
+export declare function applyFieldValueListOptions(fields: GlobalInfoField[], _rawRows: unknown, sectionRecord: GlobalInfoRawRecord, normalizeOptions: NormalizeGlobalInfoOptions): GlobalInfoField[];
+export {};

package/dist/types/components/globalInfo/renderers/GlobalInfoAutoRenderer.vue.d.ts

@@ -7,6 +7,55 @@ type __VLS_Props = {
     actions: GlobalInfoActions;
     renderConfig?: GlobalInfoRenderConfig;
 };
-declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare var __VLS_10: string, __VLS_11: {
+    field: import("../index.ts").GlobalInfoField;
+    section: GlobalInfoSection;
+    sectionView: GlobalInfoSection;
+    node: GlobalInfoNode | null | undefined;
+    row: import("../index.ts").GlobalInfoRawRecord;
+    rowIndex: number;
+    editing: boolean;
+    modelValue: unknown;
+    value: unknown;
+    state: GlobalInfoState;
+    actions: GlobalInfoActions;
+    updateModelValue: (value: unknown) => void;
+}, __VLS_22: string, __VLS_23: {
+    field: import("../index.ts").GlobalInfoField;
+    section: GlobalInfoSection;
+    sectionView: GlobalInfoSection;
+    node: GlobalInfoNode | null | undefined;
+    editing: boolean;
+    modelValue: unknown;
+    value: unknown;
+    state: GlobalInfoState;
+    actions: GlobalInfoActions;
+    updateModelValue: (value: unknown) => void;
+}, __VLS_34: string, __VLS_35: {
+    field: import("../index.ts").GlobalInfoField;
+    section: GlobalInfoSection;
+    sectionView: GlobalInfoSection;
+    node: GlobalInfoNode | null | undefined;
+    editing: boolean;
+    modelValue: unknown;
+    value: unknown;
+    state: GlobalInfoState;
+    actions: GlobalInfoActions;
+    updateModelValue: (value: unknown) => void;
+};
+type __VLS_Slots = {} & {
+    [K in NonNullable<typeof __VLS_10>]?: (props: typeof __VLS_11) => any;
+} & {
+    [K in NonNullable<typeof __VLS_22>]?: (props: typeof __VLS_23) => any;
+} & {
+    [K in NonNullable<typeof __VLS_34>]?: (props: typeof __VLS_35) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/types/components/globalInfo/renderers/GlobalInfoFormRenderer.vue.d.ts

@@ -7,6 +7,8 @@ type __VLS_Props = {
     actions: GlobalInfoActions;
     model?: GlobalInfoRawRecord;
     onUpdateModel?: (model: GlobalInfoRawRecord) => void;
+    rowIndex?: number;
+    rows?: GlobalInfoRawRecord[];
     renderConfig?: GlobalInfoRenderConfig;
 };
 declare var __VLS_16: string, __VLS_17: {

package/dist/types/components/globalInfo/renderers/GlobalInfoMultiFormRenderer.vue.d.ts

@@ -0,0 +1,49 @@
+import type { GlobalInfoActions, GlobalInfoNode, GlobalInfoRawRecord, GlobalInfoRenderConfig, GlobalInfoSection, GlobalInfoState } from '../model/types';
+type __VLS_Props = {
+    section: GlobalInfoSection;
+    node?: GlobalInfoNode | null;
+    editing: boolean;
+    state: GlobalInfoState;
+    actions: GlobalInfoActions;
+    renderConfig?: GlobalInfoRenderConfig;
+    resolveRowSection?: (section: GlobalInfoSection, row: GlobalInfoRawRecord, rowIndex: number) => GlobalInfoSection;
+    onUpdateRows?: (rows: GlobalInfoRawRecord[], context: {
+        section: GlobalInfoSection;
+        rowIndex: number;
+        model: GlobalInfoRawRecord;
+    }) => void;
+};
+declare var __VLS_1: {
+    section: GlobalInfoSection;
+    sourceSection: GlobalInfoSection;
+    row: GlobalInfoRawRecord;
+    rowIndex: number;
+    editing: boolean;
+    state: GlobalInfoState;
+    actions: GlobalInfoActions;
+}, __VLS_11: string, __VLS_12: {
+    field: import("../index.ts").GlobalInfoField;
+    section: GlobalInfoSection;
+    sectionView: GlobalInfoSection;
+    node: GlobalInfoNode | null | undefined;
+    editing: boolean;
+    modelValue: unknown;
+    value: unknown;
+    state: GlobalInfoState;
+    actions: GlobalInfoActions;
+    updateModelValue: (value: unknown) => void;
+};
+type __VLS_Slots = {} & {
+    [K in NonNullable<typeof __VLS_11>]?: (props: typeof __VLS_12) => any;
+} & {
+    itemHeader?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/types/components/globalInfo/renderers/optionPreload.d.ts

@@ -1,9 +1,19 @@
 import type { GlobalInfoField, GlobalInfoFieldOptionsLoadOptions, GlobalInfoRawRecord } from '../model/types.js';
+export type InitPreloadFetchOptions = {
+    sectionKey: string;
+    fields: GlobalInfoField[];
+    model: GlobalInfoRawRecord;
+    rowKey?: string;
+    getCachedPreloadKey: (key: string) => string | undefined;
+    setCachedPreloadKey: (key: string, value: string) => void;
+    loadFieldOptions: (field: GlobalInfoField, options: GlobalInfoFieldOptionsLoadOptions, value: unknown) => Promise<void> | void;
+};
 export declare function isDynamicSelectField(field: GlobalInfoField): boolean;
-export declare function buildFieldOptionsPreloadKey(sectionKey: string, field: Pick<GlobalInfoField, 'key' | 'id' | 'code' | 'cascadeDependFields' | 'interface'>, model?: GlobalInfoRawRecord, rowKey?: string): string;
+export declare function buildFieldOptionsPreloadKey(sectionKey: string, field: Pick<GlobalInfoField, 'code' | 'cascadeDependFields' | 'interface'>, model?: GlobalInfoRawRecord, rowKey?: string): string;
 export declare function shouldReuseLoadedFieldOptions(field: Pick<GlobalInfoField, 'options' | 'cascadeDependFields' | 'interface'>, cachedPreloadKey: string | undefined, currentPreloadKey: string): boolean;
 export declare function hasFieldOptionsSearchText(options?: GlobalInfoFieldOptionsLoadOptions): boolean;
-export declare function isFieldOptionsDependentOnChangedField(targetField: Pick<GlobalInfoField, 'cascadeDependFields' | 'interface'>, changedField: Pick<GlobalInfoField, 'key' | 'id' | 'code'>): boolean;
+export declare function isFieldOptionsDependentOnChangedField(targetField: Pick<GlobalInfoField, 'cascadeDependFields' | 'interface'>, changedField: Pick<GlobalInfoField, 'code'>): boolean;
 export declare function shouldPreloadDynamicSelectField(field: GlobalInfoField, value: unknown, editing: boolean): boolean;
 export declare function resolveDynamicSelectPreloadValue(field: GlobalInfoField, model: GlobalInfoRawRecord): unknown;
 export declare function getDynamicSelectPreloadOptions(field: GlobalInfoField, value: unknown): GlobalInfoFieldOptionsLoadOptions;
+export declare function initPreloadFetch(options: InitPreloadFetchOptions): Promise<void>;

package/dist/types/components/index.d.ts

@@ -4,7 +4,7 @@ export { JtButton } from './JtButton/index';
 export { JtAttachmentPreview, JtAttachmentPreviewByParams, setupJtAttachmentPreview, } from './JtAttachmentPreview/index';
 export { JtCascader, JtDatePicker, JtFormItems, JtInput, JtSelect } from './form/index';
 export { JtPageHeader } from './JtPageHeader/index';
-export { GlobalInfoAutoRenderer, GlobalInfoDeleteConfirm, GlobalInfoFieldControl, GlobalInfoFieldValue, GlobalInfoFormRenderer, GlobalInfoGroup, GlobalInfoProvider, GlobalInfoSectionBlock, GlobalInfoSectionOutlet, GlobalInfoSections, GlobalInfoTableRenderer, useGlobalInfoController, buildGlobalInfoUpdatePayload, createEmptyGlobalInfoViewModel, isGlobalInfoNode, mergeGlobalInfoChildren, normalizeGlobalInfoDetail, normalizeGlobalInfoTree, resolveGlobalInfoRenderType, DEFAULT_GLOBAL_INFO_REQUIRED_INFO_SET_EMPTY_MESSAGE, validateGlobalInfoRequiredInfoSet, } from './globalInfo/index';
+export { GlobalInfoAutoRenderer, GlobalInfoDeleteConfirm, GlobalInfoFieldControl, GlobalInfoFieldValue, GlobalInfoFormRenderer, GlobalInfoGroup, GlobalInfoLeftNav, GlobalInfoMultiFormRenderer, GlobalInfoProvider, GlobalInfoSectionBlock, GlobalInfoSectionOutlet, GlobalInfoSections, GlobalInfoTableRenderer, useGlobalInfoController, buildGlobalInfoUpdatePayload, createEmptyGlobalInfoViewModel, isGlobalInfoNode, mergeGlobalInfoChildren, normalizeGlobalInfoDetail, normalizeGlobalInfoOptions, normalizeGlobalInfoTree, resolveGlobalInfoRenderType, DEFAULT_GLOBAL_INFO_REQUIRED_INFO_SET_EMPTY_MESSAGE, validateGlobalInfoRequiredInfoSet, } from './globalInfo/index';
 export type { JTCascaderFormItemConfig, JTCompatibleFormItemType, JTElementFormItemType, JTFormItemCascaderOption, JTFormItemConfig, JTFormItemEventHandler, JTFormItemType, JTFormItemsForm, JTFormItemsProps, JtOptionItem, } from './form/index';
 export type { JtPageHeaderOperate, JtPageHeaderProps } from './JtPageHeader/index';
 export type { JtAttachmentPreviewHandler, JtAttachmentPreviewFileOptions, JtAttachmentPreviewRequestConfig, JtAttachmentPreviewService, JtAttachmentPreviewMode, JtAttachmentPreviewOptions, JtAttachmentPreviewResolvedType, } from './JtAttachmentPreview/index';

package/dist/types/main.d.ts

@@ -1,8 +1,9 @@
 import './assets/styles/base.css';
+import './components/JtAttachmentPreview/style.scss';
 import type { App } from 'vue';
 import type { LocaleOptions } from './locale';
 export declare function install(app: App, options?: LocaleOptions): void;
 export { getLocale as getJtLocale, installLocale, normalizeLocale, resetLocale as resetJtLocale, setLocale as setJtLocale, } from './locale';
 export type { LocaleCode, LocaleOptions, LocaleSource, } from './locale';
-export { GlobalInfoAutoRenderer, GlobalInfoDeleteConfirm, GlobalInfoFieldControl, GlobalInfoFieldValue, GlobalInfoFormRenderer, GlobalInfoGroup, GlobalInfoProvider, GlobalInfoSectionBlock, GlobalInfoSectionOutlet, GlobalInfoSections, GlobalInfoTableRenderer, JtAttachmentPreview, JtAttachmentPreviewByParams, JtCascader, JtButton, JtCrudTable, JtDatePicker, JtFilterBar, JtFormItems, JtInput, JtPageHeader, JtPagination, JtSelect, JtTable, buildGlobalInfoUpdatePayload, createEmptyGlobalInfoViewModel, isGlobalInfoNode, mergeGlobalInfoChildren, normalizeGlobalInfoDetail, normalizeGlobalInfoTree, resolveGlobalInfoRenderType, setupJtAttachmentPreview, useGlobalInfoController, DEFAULT_GLOBAL_INFO_REQUIRED_INFO_SET_EMPTY_MESSAGE, validateGlobalInfoRequiredInfoSet, } from './components/index';
+export { GlobalInfoAutoRenderer, GlobalInfoDeleteConfirm, GlobalInfoFieldControl, GlobalInfoFieldValue, GlobalInfoFormRenderer, GlobalInfoGroup, GlobalInfoLeftNav, GlobalInfoMultiFormRenderer, GlobalInfoProvider, GlobalInfoSectionBlock, GlobalInfoSectionOutlet, GlobalInfoSections, GlobalInfoTableRenderer, JtAttachmentPreview, JtAttachmentPreviewByParams, JtCascader, JtButton, JtCrudTable, JtDatePicker, JtFilterBar, JtFormItems, JtInput, JtPageHeader, JtPagination, JtSelect, JtTable, buildGlobalInfoUpdatePayload, createEmptyGlobalInfoViewModel, isGlobalInfoNode, mergeGlobalInfoChildren, normalizeGlobalInfoDetail, normalizeGlobalInfoOptions, normalizeGlobalInfoTree, resolveGlobalInfoRenderType, setupJtAttachmentPreview, useGlobalInfoController, DEFAULT_GLOBAL_INFO_REQUIRED_INFO_SET_EMPTY_MESSAGE, validateGlobalInfoRequiredInfoSet, } from './components/index';
 export type { GlobalInfoActions, GlobalInfoApiOperation, GlobalInfoDetailParams, GlobalInfoField, GlobalInfoFieldHiddenContext, GlobalInfoFieldHiddenRule, GlobalInfoFieldOption, GlobalInfoInfoSet, GlobalInfoNode, GlobalInfoOperationContext, GlobalInfoOpenTreeParams, GlobalInfoProviderSlotProps, GlobalInfoRawRecord, GlobalInfoRenderConfig, GlobalInfoRenderType, GlobalInfoRequiredInfoSetEmptyMessage, GlobalInfoRequiredInfoSetEmptyMessageContext, GlobalInfoScheme, GlobalInfoSection, GlobalInfoSectionLoadTarget, GlobalInfoSectionSlotScope, GlobalInfoSectionStatus, GlobalInfoSectionTarget, GlobalInfoService, GlobalInfoSetMark, GlobalInfoState, GlobalInfoTemplateTreeParams, GlobalInfoUpdateParams, GlobalInfoViewModel, JTCascaderFormItemConfig, JtCrudColumn, JtCrudOption, JtDicItem, JTCompatibleFormItemType, JTElementFormItemType, JTFormItemConfig, JTFormItemEventHandler, JTFormItemType, JTFormItemsForm, JTFormItemsProps, JTFormItemCascaderOption, JtAttachmentPreviewHandler, JtAttachmentPreviewFileOptions, JtAttachmentPreviewRequestConfig, JtAttachmentPreviewService, JtAttachmentPreviewMode, JtAttachmentPreviewOptions, JtAttachmentPreviewResolvedType, JtOptionItem, JtPageHeaderOperate, JtPageHeaderProps, JtPaginationData, JtSearchType, } from './components/index';