@wapri/element-pro 3.0.0

package/dist/ConfigProvider/index.d.ts

@@ -0,0 +1,50 @@
+export declare const ConfigProvider: import('../utils/install').SFCWithInstall<{
+    new (...args: any[]): import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('vue').ExtractPropTypes<{
+        size: {
+            type: import('vue').PropType<import('./context').ElementProSize>;
+        };
+        prefix: {
+            type: import('vue').PropType<string>;
+        };
+        iconfont: {
+            type: import('vue').PropType<string>;
+        };
+    }>> & Readonly<{}>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, import('vue').PublicProps, {}, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly<import('vue').ExtractPropTypes<{
+        size: {
+            type: import('vue').PropType<import('./context').ElementProSize>;
+        };
+        prefix: {
+            type: import('vue').PropType<string>;
+        };
+        iconfont: {
+            type: import('vue').PropType<string>;
+        };
+    }>> & Readonly<{}>, {}, {}, {}, {}, {}>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & import('vue').ComponentOptionsBase<Readonly<import('vue').ExtractPropTypes<{
+    size: {
+        type: import('vue').PropType<import('./context').ElementProSize>;
+    };
+    prefix: {
+        type: import('vue').PropType<string>;
+    };
+    iconfont: {
+        type: import('vue').PropType<string>;
+    };
+}>> & Readonly<{}>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, {}, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & (new () => {
+    $slots: {
+        default?(_: {}): any;
+    };
+})> & Record<string, unknown>;
+export type { ConfigProviderProps } from './index.vue';
+export type { ElementProSize } from './context';
+export default ConfigProvider;

package/dist/ConfigProvider/index.vue.d.ts

@@ -0,0 +1,28 @@
+import { ElementProSize } from './context';
+
+export interface ConfigProviderProps {
+    size?: ElementProSize;
+    prefix?: string;
+    /** 图标集脚本地址，供子树里的 `SvgIcon` 使用；库内不内置任何图标源。 */
+    iconfont?: string;
+}
+declare function __VLS_template(): {
+    default?(_: {}): any;
+};
+declare const __VLS_component: import('vue').DefineComponent<import('vue').ExtractPropTypes<__VLS_TypePropsToRuntimeProps<ConfigProviderProps>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<__VLS_TypePropsToRuntimeProps<ConfigProviderProps>>> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/CropperUpload/CropperDialog.vue.d.ts

@@ -0,0 +1,23 @@
+import { CropperDialogProps } from './types';
+
+declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<__VLS_TypePropsToRuntimeProps<CropperDialogProps>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    cancel: () => void;
+    error: (error: Error) => void;
+    confirm: (file: File) => void;
+    reselect: (file: File) => void;
+}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<__VLS_TypePropsToRuntimeProps<CropperDialogProps>>> & Readonly<{
+    onCancel?: (() => any) | undefined;
+    onError?: ((error: Error) => any) | undefined;
+    onConfirm?: ((file: File) => any) | undefined;
+    onReselect?: ((file: File) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};

package/dist/CropperUpload/index.d.ts

@@ -0,0 +1,241 @@
+export declare const CropperUpload: import('../utils/install').SFCWithInstall<{
+    new (...args: any[]): import('vue').CreateComponentPublicInstanceWithMixins<Readonly<import('vue').ExtractPropTypes<{
+        title: {
+            type: import('vue').PropType<string>;
+            default: string;
+        };
+        circle: {
+            type: import('vue').PropType<boolean>;
+            default: boolean;
+        };
+        beforeUpload: {
+            type: import('vue').PropType<(rawFile: import('element-plus').UploadRawFile) => import('element-plus/es/utils/typescript').Awaitable<void | undefined | null | boolean | File | Blob>>;
+        };
+        ratios: {
+            type: import('vue').PropType<number[]>;
+            default: () => number[];
+        };
+        aspectRatio: {
+            type: import('vue').PropType<string | number>;
+            default: number;
+        };
+        cropperOptions: {
+            type: import('vue').PropType<import('./types').CropperOptions>;
+            default: () => {};
+        };
+        preview: {
+            type: import('vue').PropType<boolean>;
+            default: boolean;
+        };
+        outputWidth: {
+            type: import('vue').PropType<number>;
+        };
+        confirmText: {
+            type: import('vue').PropType<string>;
+            default: string;
+        };
+        cancelText: {
+            type: import('vue').PropType<string>;
+            default: string;
+        };
+        reselectText: {
+            type: import('vue').PropType<string>;
+            default: string;
+        };
+        canvasHeight: {
+            type: import('vue').PropType<string | number>;
+            default: string;
+        };
+        cropper: {
+            type: import('vue').PropType<boolean>;
+            default: boolean;
+        };
+    }>> & Readonly<{
+        onCancel?: ((rawFile: File) => any) | undefined;
+        onError?: ((error: Error) => any) | undefined;
+        onReselect?: ((rawFile: File) => any) | undefined;
+        onCrop?: ((file: File, rawFile: File) => any) | undefined;
+    }>, {
+        uploadRef: import('vue').Ref<import('element-plus').UploadInstance | undefined, import('element-plus').UploadInstance | undefined>;
+    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+        cancel: (rawFile: File) => void;
+        error: (error: Error) => void;
+        reselect: (rawFile: File) => void;
+        crop: (file: File, rawFile: File) => void;
+    }, import('vue').PublicProps, {
+        title: string;
+        circle: boolean;
+        ratios: number[];
+        aspectRatio: number | string;
+        cropperOptions: import('./types').CropperOptions;
+        preview: boolean;
+        confirmText: string;
+        cancelText: string;
+        reselectText: string;
+        canvasHeight: number | string;
+        cropper: boolean;
+    }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly<import('vue').ExtractPropTypes<{
+        title: {
+            type: import('vue').PropType<string>;
+            default: string;
+        };
+        circle: {
+            type: import('vue').PropType<boolean>;
+            default: boolean;
+        };
+        beforeUpload: {
+            type: import('vue').PropType<(rawFile: import('element-plus').UploadRawFile) => import('element-plus/es/utils/typescript').Awaitable<void | undefined | null | boolean | File | Blob>>;
+        };
+        ratios: {
+            type: import('vue').PropType<number[]>;
+            default: () => number[];
+        };
+        aspectRatio: {
+            type: import('vue').PropType<string | number>;
+            default: number;
+        };
+        cropperOptions: {
+            type: import('vue').PropType<import('./types').CropperOptions>;
+            default: () => {};
+        };
+        preview: {
+            type: import('vue').PropType<boolean>;
+            default: boolean;
+        };
+        outputWidth: {
+            type: import('vue').PropType<number>;
+        };
+        confirmText: {
+            type: import('vue').PropType<string>;
+            default: string;
+        };
+        cancelText: {
+            type: import('vue').PropType<string>;
+            default: string;
+        };
+        reselectText: {
+            type: import('vue').PropType<string>;
+            default: string;
+        };
+        canvasHeight: {
+            type: import('vue').PropType<string | number>;
+            default: string;
+        };
+        cropper: {
+            type: import('vue').PropType<boolean>;
+            default: boolean;
+        };
+    }>> & Readonly<{
+        onCancel?: ((rawFile: File) => any) | undefined;
+        onError?: ((error: Error) => any) | undefined;
+        onReselect?: ((rawFile: File) => any) | undefined;
+        onCrop?: ((file: File, rawFile: File) => any) | undefined;
+    }>, {
+        uploadRef: import('vue').Ref<import('element-plus').UploadInstance | undefined, import('element-plus').UploadInstance | undefined>;
+    }, {}, {}, {}, {
+        title: string;
+        circle: boolean;
+        ratios: number[];
+        aspectRatio: number | string;
+        cropperOptions: import('./types').CropperOptions;
+        preview: boolean;
+        confirmText: string;
+        cancelText: string;
+        reselectText: string;
+        canvasHeight: number | string;
+        cropper: boolean;
+    }>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & import('vue').ComponentOptionsBase<Readonly<import('vue').ExtractPropTypes<{
+    title: {
+        type: import('vue').PropType<string>;
+        default: string;
+    };
+    circle: {
+        type: import('vue').PropType<boolean>;
+        default: boolean;
+    };
+    beforeUpload: {
+        type: import('vue').PropType<(rawFile: import('element-plus').UploadRawFile) => import('element-plus/es/utils/typescript').Awaitable<void | undefined | null | boolean | File | Blob>>;
+    };
+    ratios: {
+        type: import('vue').PropType<number[]>;
+        default: () => number[];
+    };
+    aspectRatio: {
+        type: import('vue').PropType<string | number>;
+        default: number;
+    };
+    cropperOptions: {
+        type: import('vue').PropType<import('./types').CropperOptions>;
+        default: () => {};
+    };
+    preview: {
+        type: import('vue').PropType<boolean>;
+        default: boolean;
+    };
+    outputWidth: {
+        type: import('vue').PropType<number>;
+    };
+    confirmText: {
+        type: import('vue').PropType<string>;
+        default: string;
+    };
+    cancelText: {
+        type: import('vue').PropType<string>;
+        default: string;
+    };
+    reselectText: {
+        type: import('vue').PropType<string>;
+        default: string;
+    };
+    canvasHeight: {
+        type: import('vue').PropType<string | number>;
+        default: string;
+    };
+    cropper: {
+        type: import('vue').PropType<boolean>;
+        default: boolean;
+    };
+}>> & Readonly<{
+    onCancel?: ((rawFile: File) => any) | undefined;
+    onError?: ((error: Error) => any) | undefined;
+    onReselect?: ((rawFile: File) => any) | undefined;
+    onCrop?: ((file: File, rawFile: File) => any) | undefined;
+}>, {
+    uploadRef: import('vue').Ref<import('element-plus').UploadInstance | undefined, import('element-plus').UploadInstance | undefined>;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    cancel: (rawFile: File) => void;
+    error: (error: Error) => void;
+    reselect: (rawFile: File) => void;
+    crop: (file: File, rawFile: File) => void;
+}, string, {
+    title: string;
+    circle: boolean;
+    ratios: number[];
+    aspectRatio: number | string;
+    cropperOptions: import('./types').CropperOptions;
+    preview: boolean;
+    confirmText: string;
+    cancelText: string;
+    reselectText: string;
+    canvasHeight: number | string;
+    cropper: boolean;
+}, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & (new () => {
+    $slots: {
+        default?(_: {}): any;
+        trigger?(_: {}): any;
+        tip?(_: {}): any;
+    };
+})> & Record<string, unknown>;
+export * from './types';
+export default CropperUpload;

package/dist/CropperUpload/index.vue.d.ts

@@ -0,0 +1,81 @@
+import { UploadInstance } from 'element-plus';
+import { CropperUploadProps } from './types';
+
+declare function __VLS_template(): {
+    default?(_: {}): any;
+    trigger?(_: {}): any;
+    tip?(_: {}): any;
+};
+declare const __VLS_component: import('vue').DefineComponent<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<CropperUploadProps>, {
+    cropper: boolean;
+    aspectRatio: number;
+    ratios: () => number[];
+    cropperOptions: () => {};
+    preview: boolean;
+    circle: boolean;
+    canvasHeight: string;
+    title: string;
+    confirmText: string;
+    cancelText: string;
+    reselectText: string;
+}>>, {
+    uploadRef: import('vue').Ref<UploadInstance | undefined, UploadInstance | undefined>;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    cancel: (rawFile: File) => void;
+    error: (error: Error) => void;
+    reselect: (rawFile: File) => void;
+    crop: (file: File, rawFile: File) => void;
+}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<CropperUploadProps>, {
+    cropper: boolean;
+    aspectRatio: number;
+    ratios: () => number[];
+    cropperOptions: () => {};
+    preview: boolean;
+    circle: boolean;
+    canvasHeight: string;
+    title: string;
+    confirmText: string;
+    cancelText: string;
+    reselectText: string;
+}>>> & Readonly<{
+    onCancel?: ((rawFile: File) => any) | undefined;
+    onError?: ((error: Error) => any) | undefined;
+    onReselect?: ((rawFile: File) => any) | undefined;
+    onCrop?: ((file: File, rawFile: File) => any) | undefined;
+}>, {
+    title: string;
+    circle: boolean;
+    ratios: number[];
+    aspectRatio: number | string;
+    cropperOptions: import('./types').CropperOptions;
+    preview: boolean;
+    confirmText: string;
+    cancelText: string;
+    reselectText: string;
+    canvasHeight: number | string;
+    cropper: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/CropperUpload/types.d.ts

@@ -0,0 +1,137 @@
+import { UploadHooks } from 'element-plus';
+
+/**
+ * 透传给 vue-cropper 的配置。
+ * vue-cropper 未导出组件 props 的类型定义，这里只声明 CropperUpload 关心的字段，
+ * 未声明的配置不会被转发，避免与组件内部驱动的 `fixed`、`fixedNumber` 冲突。
+ */
+export interface CropperOptions {
+    /** 是否可拖动图片 */
+    canMove?: boolean;
+    /** 是否可拖动裁剪框 */
+    canMoveBox?: boolean;
+    /** 固定裁剪框大小，禁止拖动改变裁剪框 */
+    fixedBox?: boolean;
+    /** 裁剪框是否限制在图片范围内，关闭后裁剪结果可能带入画布背景 */
+    centerBox?: boolean;
+    /** 是否显示裁剪框尺寸提示 */
+    info?: boolean;
+    /** 是否支持滚轮 / 双指缩放 */
+    canScale?: boolean;
+    /** 图片布局方式，`contain` 居中留白、`cover` 填满容器 */
+    mode?: string;
+    /** 是否按 dpr 输出高清结果 */
+    high?: boolean;
+    /** 导出放大倍数 */
+    enlarge?: number;
+    /** 图片最大尺寸，超过该边长会先等比压缩再裁剪 */
+    maxImgSize?: number;
+    /** 导出图片质量，0-1，仅 jpeg / webp 生效 */
+    outputSize?: number;
+    /** 导出时填充的背景色，如 `#fff`；不传时透明区域保持透明 */
+    fillColor?: string;
+}
+/** Cropper 实例上用到的方法与只读状态，避免直接依赖 vue-cropper 宽松的组件类型。 */
+export interface CropperInstance {
+    /** 图片显示尺寸（已按 maxImgSize 压缩） */
+    readonly trueWidth: number;
+    readonly trueHeight: number;
+    /** 当前缩放比例，由裁剪器内部维护 */
+    readonly scale: number;
+    /** 导出裁剪结果为 Blob，回调参数为 null 表示导出失败 */
+    getCropBlob: (callback: (blob: Blob | null) => void) => void;
+    /** 缩放图片，正数放大、负数缩小；步长按 `20 / 图片短边` 换算 */
+    changeScale: (factor: number) => void;
+    /** 逆时针旋转 90° */
+    rotateLeft: () => void;
+    /** 顺时针旋转 90° */
+    rotateRight: () => void;
+    /** 按当前 fixed / fixedNumber 重新生成并居中裁剪框 */
+    goAutoCrop: () => void;
+}
+/** vue-cropper `real-time` 事件回传的预览数据，用于右侧实时预览 */
+export interface CropperPreview {
+    /** 裁剪框宽度（px） */
+    w: number;
+    /** 裁剪框高度（px） */
+    h: number;
+    /** 原始图片地址 */
+    url: string;
+    /** 图片的尺寸与 transform，直接绑定到预览区的 img 上 */
+    img: {
+        width: string;
+        height: string;
+        transform: string;
+    };
+}
+export interface CropperUploadProps {
+    /**
+     * 自定义上传前钩子，与 `ElUpload` 同名 prop。
+     * 裁剪之后执行，拿到的是裁剪结果（取消裁剪时不会执行）。
+     * 返回 `false` 终止本次上传，返回 Blob / File 可再次替换上传文件。
+     */
+    beforeUpload?: UploadHooks['beforeUpload'];
+    /** 是否启用裁剪，置为 `false` 时退化为原生 `ElUpload` */
+    cropper?: boolean;
+    /** 初始裁剪比例，也支持 `4/3` 字符串写法；需出现在 `ratios` 中，否则以 `ratios` 第一项为准 */
+    aspectRatio?: number | string;
+    /** 弹窗内可切换的比例列表，`0` 表示自由比例；只传一项时不展示比例切换 */
+    ratios?: number[];
+    /** 透传给 vue-cropper 的配置，如 `canMove`、`fixedBox`、`mode` */
+    cropperOptions?: CropperOptions;
+    /** 是否展示右侧实时预览与输出尺寸提示 */
+    preview?: boolean;
+    /**
+     * 固定输出宽度（px）。设置后确认时按该宽度等比缩放导出，高度由裁剪比例换算，
+     * 不再受 dpr / `enlarge` 影响；不设置时按裁剪框尺寸 × dpr 输出。
+     */
+    outputWidth?: number;
+    /** 圆形裁剪，用于头像等场景，置为 `true` 时裁剪框为正圆 */
+    circle?: boolean;
+    /** 裁剪画布区域高度 */
+    canvasHeight?: number | string;
+    /** 弹窗标题 */
+    title?: string;
+    /** 确认按钮文案 */
+    confirmText?: string;
+    /** 取消按钮文案 */
+    cancelText?: string;
+    /** 「重新选择」按钮文案，设置后可在弹窗内换图而不关闭 */
+    reselectText?: string;
+}
+export interface CropperUploadEmits {
+    /** 裁剪完成，参数为裁剪结果与原始文件 */
+    crop: [file: File, rawFile: File];
+    /** 用户取消裁剪（含点击关闭、按下 ESC） */
+    cancel: [rawFile: File];
+    /** 读取图片或生成裁剪结果失败 */
+    error: [error: Error];
+    /** 弹窗内重新选择了图片，组件已换成新图继续裁剪 */
+    reselect: [rawFile: File];
+}
+/** 裁剪弹窗的内部契约，仅在 CropperUpload 内部流转。 */
+export interface CropperDialogProps {
+    visible: boolean;
+    /** 待裁剪的原始文件 */
+    file?: File;
+    ratios: number[];
+    aspectRatio: number | string;
+    cropperOptions?: CropperOptions;
+    /** 「重新选择」时的文件过滤，跟随 ElUpload 的 accept */
+    accept?: string;
+    preview: boolean;
+    outputWidth?: number;
+    circle: boolean;
+    title: string;
+    confirmText: string;
+    cancelText: string;
+    reselectText: string;
+    canvasHeight: number | string;
+}
+export interface CropperDialogEmits {
+    confirm: [file: File];
+    cancel: [];
+    error: [error: Error];
+    /** 弹窗内「重新选择」了图片，父级用它替换当前待裁剪文件 */
+    reselect: [file: File];
+}

package/dist/CropperUpload/utils.d.ts

@@ -0,0 +1,42 @@
+import { UploadRawFile } from 'element-plus';
+
+/** vue-cropper `outputType` 支持的格式 */
+export type CropperOutputFormat = 'jpeg' | 'png' | 'webp';
+/** 是否是需要裁剪的图片 */
+export declare const isImageFile: (file: File) => boolean;
+/** 裁剪输出类型：优先与原图一致，canvas 不支持的类型回退 png */
+export declare const getOutputType: (raw: File) => string;
+/** vue-cropper 的 outputType 只接收格式名，不带 `image/` 前缀 */
+export declare const getOutputFormat: (raw: File) => CropperOutputFormat;
+/**
+ * canvas → File；画布过大等导致 toBlob 返回空时抛出错误。
+ * `outputType` 可强制指定输出类型，圆形裁剪需要输出 png 保留透明四角。
+ */
+export declare const canvasToFile: (canvas: HTMLCanvasElement, raw: File, outputType?: string) => Promise<File>;
+/** 裁剪结果是 Blob 时直接转成 File，文件名与扩展名跟随实际编码格式 */
+export declare const blobToFile: (blob: Blob, raw: File) => File;
+/** Blob → canvas，用于圆形裁剪时二次加工裁剪结果 */
+export declare const blobToCanvas: (blob: Blob) => Promise<HTMLCanvasElement>;
+/** 按目标尺寸重绘画布，用于把裁剪结果锁定成固定输出宽度 */
+export declare const resizeCanvas: (canvas: HTMLCanvasElement, width: number, height: number) => HTMLCanvasElement;
+/** 裁剪结果是新文件，补回原 uid 以复用 ElUpload 的进度、取消等回调 */
+export declare const inheritUid: (file: File, raw: UploadRawFile) => UploadRawFile;
+/**
+ * 圆形裁剪结果：把矩形画布的四角裁掉，只保留椭圆区域内的像素。
+ *
+ * vue-cropper 的 `getCropBlob` 只按裁剪框的矩形区域导出图片，
+ * 圆形裁剪仅影响弹窗内的裁剪框样式（`border-radius`），
+ * 若不在这里裁掉四角，头像上传后四角仍是图片内容，展示出来是正方形的。
+ *
+ * 裁剪框为正方形时等价于圆形，非正方形时与预览的椭圆保持一致。
+ */
+export declare const clipEllipseCanvas: (canvas: HTMLCanvasElement) => HTMLCanvasElement;
+/**
+ * 比例拆成 vue-cropper 需要的 `[宽, 高]`：
+ * 1 → [1, 1]，4/3 → [4, 3]，无法整除时按小数保留第一个值。
+ */
+export declare const splitRatio: (ratio: number) => [number, number];
+/** 比例文案：1 → 1:1，4/3 → 4:3，0 → 自由 */
+export declare const formatRatio: (ratio: number) => string;
+/** 比例归一化：支持 4/3、'4/3' 两种写法，无法解析时按 0（自由比例）处理 */
+export declare const parseRatio: (value: number | string) => number;

package/dist/DateQuickSelect/index.d.ts

@@ -0,0 +1,65 @@
+export declare const DateQuickSelect: import('../utils/install').SFCWithInstall<import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    placeholder: {
+        type: import('vue').PropType<string>;
+    };
+    modelValue: {
+        type: import('vue').PropType<string | [string, string]>;
+    };
+    valueType: {
+        type: import('vue').PropType<import('./types').DateQuickSelectValueType>;
+        required: true;
+    };
+    quickSelect: {
+        type: import('vue').PropType<false | import('./types').DateQuickSelectConfig>;
+        default: boolean;
+    };
+    quickSelection: {
+        type: import('vue').PropType<import('./types').DateQuickSelectSelection>;
+    };
+    datePickerProps: {
+        type: import('vue').PropType<Record<string, unknown>>;
+        default: () => {};
+    };
+    clearable: {
+        type: import('vue').PropType<boolean>;
+        default: boolean;
+    };
+}>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:modelValue": (value: string | [string, string] | undefined) => void;
+    quickSelect: (selection: import('./types').DateQuickSelectSelection) => void;
+}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    placeholder: {
+        type: import('vue').PropType<string>;
+    };
+    modelValue: {
+        type: import('vue').PropType<string | [string, string]>;
+    };
+    valueType: {
+        type: import('vue').PropType<import('./types').DateQuickSelectValueType>;
+        required: true;
+    };
+    quickSelect: {
+        type: import('vue').PropType<false | import('./types').DateQuickSelectConfig>;
+        default: boolean;
+    };
+    quickSelection: {
+        type: import('vue').PropType<import('./types').DateQuickSelectSelection>;
+    };
+    datePickerProps: {
+        type: import('vue').PropType<Record<string, unknown>>;
+        default: () => {};
+    };
+    clearable: {
+        type: import('vue').PropType<boolean>;
+        default: boolean;
+    };
+}>> & Readonly<{
+    "onUpdate:modelValue"?: ((value: string | [string, string] | undefined) => any) | undefined;
+    onQuickSelect?: ((selection: import('./types').DateQuickSelectSelection) => any) | undefined;
+}>, {
+    quickSelect: import('./types').DateQuickSelectConfig | false;
+    datePickerProps: Record<string, unknown>;
+    clearable: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>> & Record<string, unknown>;
+export * from './types';
+export default DateQuickSelect;