@dazhicheng/ui 1.5.120 → 1.5.122

package/dist/components/tt-form/src/form-render/FormArrayRegister.d.ts

@@ -1,12 +1,14 @@
 import { PropType } from 'vue';
+import { FieldEntry } from '../types/forms';
 import { FormSchema } from '../types';
+import { Recordable } from '../../../../../../utils/src';
 declare const FormArrayRegister: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
     fieldName: {
         type: PropType<string>;
         required: true;
     };
     arraySchema: {
-        type: PropType<FormSchema[]>;
+        type: PropType<FormSchema[] | ((entry: FieldEntry<Recordable>, currentIndex: number) => FormSchema[])>;
         default: () => FormSchema[];
     };
     formItemClass: {
@@ -29,7 +31,7 @@ declare const FormArrayRegister: import('vue').DefineComponent<import('vue').Ext
         required: true;
     };
     arraySchema: {
-        type: PropType<FormSchema[]>;
+        type: PropType<FormSchema[] | ((entry: FieldEntry<Recordable>, currentIndex: number) => FormSchema[])>;
         default: () => FormSchema[];
     };
     formItemClass: {
@@ -46,7 +48,7 @@ declare const FormArrayRegister: import('vue').DefineComponent<import('vue').Ext
     };
 }>> & Readonly<{}>, {
     rules: import('../types').FormSchemaRuleType | undefined;
-    arraySchema: FormSchema<keyof import('../types').BaseFormComponentMap>[];
+    arraySchema: FormSchema<keyof import('../types').BaseFormComponentMap>[] | ((entry: FieldEntry<Recordable>, currentIndex: number) => FormSchema[]);
     formItemClass: NonNullable<string | (() => string) | undefined>;
     virtual: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;

package/dist/components/tt-form/src/formApi.d.ts

@@ -206,6 +206,24 @@ export declare class FormApi {
          * @param indexB 第二个索引位置
          */
         swap: (name: string, indexA: number, indexB: number) => void | undefined;
+        /**
+         * @description 获取嵌套数组路径下的操作器
+         * @param parentPath 父数组路径（如 actions.data）
+         * @param index 父数组索引
+         * @param childField 子数组字段名（如 skills）
+         */
+        at: <TValue = unknown>(parentPath: string, index: number, childField: string) => {
+            path: string;
+            get: () => Readonly<FieldArrayContext<TValue>> | undefined;
+            push: (value: TValue) => void | undefined;
+            remove: (idx: number) => void | undefined;
+            replace: (values: TValue[]) => void | undefined;
+            update: (idx: number, value: TValue) => void | undefined;
+            insert: (idx: number, value: TValue) => void | undefined;
+            prepend: (value: TValue) => void | undefined;
+            move: (oldIdx: number, newIdx: number) => void | undefined;
+            swap: (indexA: number, indexB: number) => void | undefined;
+        };
     };
     private _getArrayFieldActions;
 }

package/dist/components/tt-form/src/group-form/groupFormApi.d.ts

@@ -280,6 +280,25 @@ export declare class GroupFormApi extends FormApi {
         prepend: <TValue = unknown>(name: string, value: TValue) => void;
         move: (name: string, oldIdx: number, newIdx: number) => void;
         swap: (name: string, indexA: number, indexB: number) => void;
+        /**
+         * @description 获取嵌套数组路径下的操作器
+         * @param parentPath 父数组路径
+         * @param index 父数组索引
+         * @param childField 子数组字段名
+         * @returns 嵌套数组操作器
+         */
+        at: <TValue = unknown>(parentPath: string, index: number, childField: string) => {
+            path: string;
+            get: () => Readonly<import('../types').FieldArrayContext<TValue>> | undefined;
+            push: (value: TValue) => void;
+            remove: (idx: number) => void;
+            replace: (values: TValue[]) => void;
+            update: (idx: number, value: TValue) => void;
+            insert: (idx: number, value: TValue) => void;
+            prepend: (value: TValue) => void;
+            move: (oldIdx: number, newIdx: number) => void;
+            swap: (indexA: number, indexB: number) => void;
+        };
     };
     unmount(): void;
 }

package/dist/components/tt-form/src/types.d.ts

@@ -6,8 +6,9 @@ import { TtTextProps } from '../../tt-text';
 import { TtSelectProp } from '../../tt-select';
 import { TtUploadProps } from '../../tt-upload';
 import { Props as TtApiComponentProps } from '../../tt-api-component';
+import { Recordable } from '../../../../../utils/src';
 import { FieldEntry, FieldArrayContext } from './types/forms';
-import { PanelContainerProps } from '../../tt-panel-select';
+import { TtPanelSelectProps } from '../../tt-panel-select';
 import { FormApi } from './formApi';
 export type FormLayout = "horizontal" | "inline" | "vertical";
 export interface BaseFormComponentMap {
@@ -30,7 +31,7 @@ export interface BaseFormComponentMap {
     TtUpload: TtUploadProps;
     ElColorPicker: ColorPickerProps;
     TtApiComponent: TtApiComponentProps<Component>;
-    TtPanelSelect: PanelContainerProps;
+    TtPanelSelect: TtPanelSelectProps;
 }
 /**
  * 表单组件类型字符串联合类型
@@ -245,7 +246,7 @@ export interface FormSchema<T extends BaseFormComponentType = BaseFormComponentT
      * @example arraySchema: []
      * @example arraySchema: (entry, index) => []
      */
-    arraySchema?: FormSchema[] | ((entry: FieldEntry, currentIndex: number) => FormSchema[]);
+    arraySchema?: FormSchema[] | ((entry: FieldEntry<Recordable>, currentIndex: number) => FormSchema[]);
 }
 /** 插槽 scope 参数，传递给渲染函数或具名插槽 */
 export interface FormSlotScope {

package/dist/components/tt-form/src/utils/array-path.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 拼接数组子路径
+ * @param parentPath 父数组路径
+ * @param index 父数组索引
+ * @param childField 子数组字段名
+ * @returns 嵌套数组完整路径
+ */
+export declare function childArrayPath(parentPath: string, index: number, childField: string): string;

package/dist/hooks/useBudinessData.d.ts

@@ -1 +1,22 @@
+/**
+ * 数据权限接口支持的联动数据类型。
+ *
+ * - platformId：平台
+ * - shopId：店铺，默认会跟随平台值联动过滤
+ * - purchasePlaceId：采购地
+ * - businessType：业务线
+ * - lockUserId：锁单人
+ */
+export type DataType = "platformId" | "shopId" | "purchasePlaceId" | "businessType" | "lockUserId";
+/**
+ * ElSelectV2 消费的统一选项结构。
+ */
+export type SelectOption = Recordable & {
+    /** 展示文案 */
+    label: string;
+    /** 选项值 */
+    value: string | number;
+    /** 店铺所属平台 id，用于平台和店铺联动过滤 */
+    platformId?: string | number;
+};
 export declare function useBudinessData(): void;

package/dist/hooks/useElementScreenshot.d.ts

@@ -0,0 +1,27 @@
+import { MaybeRefOrGetter } from 'vue';
+type ScreenshotTarget = HTMLElement | null | undefined;
+export interface ElementScreenshotOptions {
+    /** 输出格式，默认 png */
+    format?: "png" | "jpeg";
+    /** 图片质量，默认 1 */
+    quality?: number;
+    /** 渲染像素比，默认取设备像素比并限制到 3 */
+    pixelRatio?: number;
+    /** 背景色，默认白色 */
+    backgroundColor?: string;
+    /** 是否为资源追加防缓存参数，默认 true */
+    cacheBust?: boolean;
+    /** 是否跳过字体加载等待，默认 false */
+    skipFontsReady?: boolean;
+}
+/**
+ * DOM 截图 Hook：支持导出 Blob 或 DataURL
+ */
+export declare function useElementScreenshot(): {
+    captureToBlob: (target: MaybeRefOrGetter<ScreenshotTarget>, options?: ElementScreenshotOptions) => Promise<Blob>;
+    captureToDataUrl: (target: MaybeRefOrGetter<ScreenshotTarget>, options?: ElementScreenshotOptions) => Promise<string>;
+    isCapturing: import('vue').Ref<boolean, boolean>;
+    lastError: import('vue').Ref<Error | null, Error | null>;
+    resetError: () => void;
+};
+export {};

package/dist/hooks/useFormSchemasLink.d.ts

@@ -1,16 +1,7 @@
 import { TtFormSchema } from '../components/tt-form';
 import { Recordable } from '../../../utils/src';
 import { MaybeRef, Ref } from 'vue';
-/**
- * 数据权限接口支持的联动数据类型。
- *
- * - platformId：平台
- * - shopId：店铺，默认会跟随平台值联动过滤
- * - purchasePlaceId：采购地
- * - businessType：业务线
- * - lockUserId：锁单人
- */
-export type DataType = "platformId" | "shopId" | "purchasePlaceId" | "businessType" | "lockUserId";
+import { DataType, SelectOption } from './useBudinessData';
 /**
  * 表单使用场景。
  *
@@ -54,11 +45,17 @@ export interface UseFormSchemasLinkFieldConfig {
     dependencies?: TtFormSchema["dependencies"];
     /** 字段值变化后的追加回调。默认联动逻辑会先执行，再执行该回调。 */
     onChange?: (values: unknown, context: FieldOnChangeContext) => void;
+    /** 是否展示全部选项 */
     showAll?: boolean;
+    /**
+     * @description 自定义过滤数据源
+     * @param values 表单对象
+     * @param options 下拉数据源（完整的）
+     */
+    customOptions?: (values: Recordable, options: SelectOption[]) => SelectOption[];
 }
 /**
- * useFormSchemasLink 的批量配置。
- *
+ * useFormSchemasLink 的批量配置
  * 可以通过 fromOptions(options) 一次性传入，也可以使用 builder 链式方法逐项配置。
  */
 export interface UseFormSchemasLinkOptions {
@@ -71,17 +68,6 @@ export interface UseFormSchemasLinkOptions {
     /** Schema 级覆盖。传函数时可基于默认 schema 做增量修改。 */
     schemas?: Partial<Record<DataType, FieldSchemaConfig>>;
 }
-/**
- * ElSelectV2 消费的统一选项结构。
- */
-export type SelectOption = Recordable & {
-    /** 展示文案 */
-    label: string;
-    /** 选项值 */
-    value: string | number;
-    /** 店铺所属平台 id，用于平台和店铺联动过滤 */
-    platformId?: string | number;
-};
 /**
  * 构建后的表单 schema 集合。
  *

package/dist/index.d.ts

@@ -25,6 +25,7 @@ export * from './components/tt-panel-select';
 export { useFormSchemasLink } from './hooks/useFormSchemasLink';
 export { useFormat } from './hooks/useFormat';
 export { useLoading } from './hooks/useLoading';
+export { useElementScreenshot } from './hooks/useElementScreenshot';
 export { setXHR };
 /**
  * 表单组件适配器