@dazhicheng/ui 1.5.48 → 1.5.50

package/dist/components/tt-api-component/index.d.ts

@@ -0,0 +1,44 @@
+export declare const TtApiComponent: import('../../../../utils/src').SFCWithInstall<(<T extends import('vue').Component>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: {
+    attrs: any;
+    slots: Partial<Record<string, (_: any) => any>>;
+    emit: (((evt: "change", val: unknown, options: import('./types').OptionsItem[]) => void) & ((evt: "optionsChange", args_0: import('./types').OptionsItem[]) => void)) & ((evt: "update:modelValue", value: any) => void);
+}, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: {
+        readonly onChange?: ((val: unknown, options: import('./types').OptionsItem[]) => any) | undefined;
+        readonly "onUpdate:modelValue"?: ((value: any) => any) | undefined;
+        readonly onOptionsChange?: ((args_0: import('./types').OptionsItem[]) => any) | undefined;
+        modelValue?: any;
+        component: T;
+        numberToString?: boolean | undefined;
+        api?: ((arg?: any) => Promise<import('./types').OptionsItem[] | Record<string, any>>) | undefined;
+        params?: Record<string, any> | undefined;
+        resultField?: string | undefined;
+        labelField?: string | undefined;
+        childrenField?: string | undefined;
+        valueField?: string | undefined;
+        disabledField?: string | undefined;
+        optionsPropName?: string | undefined;
+        immediate?: boolean | undefined;
+        alwaysLoad?: boolean | undefined;
+        beforeFetch?: import('./types').AnyPromiseFunction<any, any> | undefined;
+        afterFetch?: import('./types').AnyPromiseFunction<any, any> | undefined;
+        options?: import('./types').OptionsItem[] | undefined;
+        loadingSlot?: string | undefined;
+        visibleEvent?: string | undefined;
+        modelPropName?: string | undefined;
+        autoSelect?: "first" | "last" | "one" | ((item: import('./types').OptionsItem[]) => import('./types').OptionsItem) | false | undefined;
+    } & import('vue').PublicProps;
+    expose(exposed: import('vue').ShallowUnwrapRef<{
+        getOptions: () => import('./types').OptionsItem[];
+        getValue: () => any;
+        getComponentRef: () => any;
+        updateParam(newParams: Record<string, any>): void;
+    }>): void;
+    attrs: any;
+    slots: Partial<Record<string, (_: any) => any>>;
+    emit: (((evt: "change", val: unknown, options: import('./types').OptionsItem[]) => void) & ((evt: "optionsChange", args_0: import('./types').OptionsItem[]) => void)) & ((evt: "update:modelValue", value: any) => void);
+}>) => import('vue').VNode & {
+    __ctx?: Awaited<typeof __VLS_setup>;
+})> & Record<string, any>;
+export default TtApiComponent;
+export * from './types';

package/dist/components/tt-api-component/index.vue.d.ts

@@ -0,0 +1,32 @@
+import { Component } from 'vue';
+import { Props, OptionsItem } from './types';
+declare const _default: <T extends Component>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+    props: __VLS_PrettifyLocal<Pick<Partial<{}> & Omit<{
+        readonly onChange?: ((val: unknown, options: OptionsItem[]) => any) | undefined;
+        readonly "onUpdate:modelValue"?: ((value: any) => any) | undefined;
+        readonly onOptionsChange?: ((args_0: OptionsItem[]) => any) | undefined;
+    } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps, never>, "onChange" | "onUpdate:modelValue" | "onOptionsChange"> & ({
+        modelValue?: any;
+    } & Props<T>) & Partial<{}>> & import('vue').PublicProps;
+    expose(exposed: import('vue').ShallowUnwrapRef<{
+        /** 获取options数据 */
+        getOptions: () => OptionsItem[];
+        /** 获取当前值 */
+        getValue: () => any;
+        /**
+         * 获取被包装组件的实例
+         */
+        getComponentRef: () => any;
+        /** 更新Api参数 */
+        updateParam(newParams: Record<string, any>): void;
+    }>): void;
+    attrs: any;
+    slots: Partial<Record<string, (_: any) => any>>;
+    emit: (((evt: "change", val: unknown, options: OptionsItem[]) => void) & ((evt: "optionsChange", args_0: OptionsItem[]) => void)) & ((evt: "update:modelValue", value: any) => void);
+}>) => import('vue').VNode & {
+    __ctx?: Awaited<typeof __VLS_setup>;
+};
+export default _default;
+type __VLS_PrettifyLocal<T> = {
+    [K in keyof T]: T[K];
+} & {};

package/dist/components/tt-api-component/types.d.ts

@@ -0,0 +1,66 @@
+import { Component, ComponentPublicInstance } from 'vue';
+/**
+ * @description 根据组件定义类型推导 `<component :is>` 上 `ref` 得到的实例类型（如 `DefineComponent` 可用构造签名推断，否则回退为 `ComponentPublicInstance`）
+ */
+export type ComponentInstanceOf<T extends Component> = T extends abstract new (...args: any) => infer I ? I : ComponentPublicInstance;
+/**
+ * 任意类型的异步函数
+ */
+export type AnyPromiseFunction<T extends any[] = any[], R = void> = (...arg: T) => PromiseLike<R>;
+export type OptionsItem = {
+    [name: string]: any;
+    children?: OptionsItem[];
+    disabled?: boolean;
+    label?: string;
+    value?: string;
+};
+export interface Props<T extends Component> {
+    /** 组件 */
+    component: T;
+    /** 是否将value从数字转为string */
+    numberToString?: boolean;
+    /** 获取options数据的函数 */
+    api?: (arg?: any) => Promise<OptionsItem[] | Record<string, any>>;
+    /** 传递给api的参数 */
+    params?: Record<string, any>;
+    /** 从api返回的结果中提取options数组的字段名 */
+    resultField?: string;
+    /** label字段名 */
+    labelField?: string;
+    /** children字段名，需要层级数据的组件可用 */
+    childrenField?: string;
+    /** value字段名 */
+    valueField?: string;
+    /** disabled字段名 */
+    disabledField?: string;
+    /** 组件接收options数据的属性名 */
+    optionsPropName?: string;
+    /** 是否立即调用api */
+    immediate?: boolean;
+    /** 每次`visibleEvent`事件发生时都重新请求数据 */
+    alwaysLoad?: boolean;
+    /** 在api请求之前的回调函数 */
+    beforeFetch?: AnyPromiseFunction<any, any>;
+    /** 在api请求之后的回调函数 */
+    afterFetch?: AnyPromiseFunction<any, any>;
+    /** 直接传入选项数据，也作为api返回空数据时的后备数据 */
+    options?: OptionsItem[];
+    /**
+     * 用于展示加载中的插槽名（如 Element Plus Select 的 `loading`）。
+     * 设置后会向子组件传入 `loading` 与内部请求状态同步（EP 的 Select 仅在 `props.loading` 为 true 时才会渲染该插槽）。
+     */
+    loadingSlot?: string;
+    /** 触发api请求的事件名 */
+    visibleEvent?: string;
+    /** 组件的v-model属性名，默认为modelValue。部分组件可能为value */
+    modelPropName?: string;
+    /**
+     * 自动选择
+     * - `first`：自动选择第一个选项
+     * - `last`：自动选择最后一个选项
+     * - `one`: 当请求的结果只有一个选项时，自动选择该选项
+     * - 函数：自定义选择逻辑，函数的参数为请求的结果数组，返回值为选择的选项
+     * - false：不自动选择(默认)
+     */
+    autoSelect?: "first" | "last" | "one" | ((item: OptionsItem[]) => OptionsItem) | false;
+}

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

@@ -5,6 +5,7 @@ import { ZodTypeAny } from 'zod';
 import { TtTextProps } from '../../tt-text';
 import { TtSelectProp } from '../../tt-select';
 import { TtUploadProps } from '../../tt-upload';
+import { Props as TtApiComponentProps } from '../../tt-api-component';
 import { FormApi } from './formApi';
 export type FormLayout = "horizontal" | "inline" | "vertical";
 export interface BaseFormComponentMap {
@@ -26,6 +27,7 @@ export interface BaseFormComponentMap {
     ElCascader: CascaderProps;
     TtUpload: TtUploadProps;
     ElColorPicker: ColorPickerProps;
+    TtApiComponent: TtApiComponentProps<Component>;
 }
 /**
  * 表单组件类型字符串联合类型

package/dist/components/tt-upload/index.d.ts

@@ -26,11 +26,11 @@ export declare const TtUpload: import('../../../../utils/src').SFCWithInstall<im
         readonly default: () => never[];
     };
     readonly uploadOssApi: {
-        readonly type: import('vue').PropType<(file: File) => Promise<import('.').OssSignatureResult>>;
+        readonly type: import('vue').PropType<(file: File) => Promise<any>>;
         readonly default: undefined;
     };
     readonly uploadOssViewApi: {
-        readonly type: import('vue').PropType<(key: string) => Promise<string>>;
+        readonly type: import('vue').PropType<(key: string) => Promise<any>>;
         readonly default: undefined;
     };
     readonly uploadTip: {
@@ -212,11 +212,11 @@ export declare const TtUpload: import('../../../../utils/src').SFCWithInstall<im
         readonly default: () => never[];
     };
     readonly uploadOssApi: {
-        readonly type: import('vue').PropType<(file: File) => Promise<import('.').OssSignatureResult>>;
+        readonly type: import('vue').PropType<(file: File) => Promise<any>>;
         readonly default: undefined;
     };
     readonly uploadOssViewApi: {
-        readonly type: import('vue').PropType<(key: string) => Promise<string>>;
+        readonly type: import('vue').PropType<(key: string) => Promise<any>>;
         readonly default: undefined;
     };
     readonly uploadTip: {
@@ -397,8 +397,8 @@ export declare const TtUpload: import('../../../../utils/src').SFCWithInstall<im
     readonly action: string;
     readonly accept: string;
     readonly modal: boolean;
-    readonly uploadOssApi: (file: File) => Promise<import('.').OssSignatureResult>;
-    readonly uploadOssViewApi: (key: string) => Promise<string>;
+    readonly uploadOssApi: (file: File) => Promise<any>;
+    readonly uploadOssViewApi: (key: string) => Promise<any>;
     readonly uploadTip: string;
     readonly maxSize: number;
     readonly showFileList: boolean;

package/dist/components/tt-upload/src/TtUpload.d.ts

@@ -1,5 +1,5 @@
 import { SlotsType, VNode } from 'vue';
-import { OssSignatureResult, TtUploadFileItem } from './typing';
+import { TtUploadFileItem } from './typing';
 declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
     readonly action: {
         readonly type: import('vue').PropType<string>;
@@ -26,11 +26,11 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         readonly default: () => never[];
     };
     readonly uploadOssApi: {
-        readonly type: import('vue').PropType<(file: File) => Promise<OssSignatureResult>>;
+        readonly type: import('vue').PropType<(file: File) => Promise<any>>;
         readonly default: undefined;
     };
     readonly uploadOssViewApi: {
-        readonly type: import('vue').PropType<(key: string) => Promise<string>>;
+        readonly type: import('vue').PropType<(key: string) => Promise<any>>;
         readonly default: undefined;
     };
     readonly uploadTip: {
@@ -212,11 +212,11 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         readonly default: () => never[];
     };
     readonly uploadOssApi: {
-        readonly type: import('vue').PropType<(file: File) => Promise<OssSignatureResult>>;
+        readonly type: import('vue').PropType<(file: File) => Promise<any>>;
         readonly default: undefined;
     };
     readonly uploadOssViewApi: {
-        readonly type: import('vue').PropType<(key: string) => Promise<string>>;
+        readonly type: import('vue').PropType<(key: string) => Promise<any>>;
         readonly default: undefined;
     };
     readonly uploadTip: {
@@ -397,8 +397,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     readonly action: string;
     readonly accept: string;
     readonly modal: boolean;
-    readonly uploadOssApi: (file: File) => Promise<OssSignatureResult>;
-    readonly uploadOssViewApi: (key: string) => Promise<string>;
+    readonly uploadOssApi: (file: File) => Promise<any>;
+    readonly uploadOssViewApi: (key: string) => Promise<any>;
     readonly uploadTip: string;
     readonly maxSize: number;
     readonly showFileList: boolean;

package/dist/components/tt-upload/src/typing.d.ts

@@ -74,12 +74,12 @@ export declare const ttUploadProps: {
     };
     /** 获取 OSS 签名信息的接口（服务端签名直传），不传则使用全局 setup 的 uploadOssApi */
     readonly uploadOssApi: {
-        readonly type: PropType<(file: File) => Promise<OssSignatureResult>>;
+        readonly type: PropType<(file: File) => Promise<any>>;
         readonly default: undefined;
     };
     /** 根据 ossKey 获取文件预览/下载 URL 的接口，不传则使用全局 setup 的 uploadOssViewApi */
     readonly uploadOssViewApi: {
-        readonly type: PropType<(key: string) => Promise<string>>;
+        readonly type: PropType<(key: string) => Promise<any>>;
         readonly default: undefined;
     };
     /** 上传提示文字 */

package/dist/index.d.ts

@@ -18,6 +18,7 @@ export * from './components/tt-loading';
 export * from './components/tt-table';
 export * from './components/tt-upload';
 export * from './components/tt-nav-anchor';
+export * from './components/tt-api-component';
 export { useFormat } from './hooks/useFormat';
 export { useLoading } from './hooks/useLoading';
 /**