wlwy-package 4.0.0-beta.2 → 4.0.0-beta.21

package/dist/types/components/form/default/type.d.ts

@@ -0,0 +1,624 @@
+import { InputNumberProps, type ColProps, type DatePickerProps, type FormInstance, type FormItemProps, type FormProps, type RowProps, type SelectProps, type SpaceProps, type TimeRangePickerProps, type UploadProps } from 'ant-design-vue';
+import type { OptionType } from '../../../type';
+import type { WCropperProp } from '../../common';
+import type { WUploadProps } from '../../antd';
+import type { WDropdownListItem } from '../../common/type';
+import type { Dayjs } from 'dayjs';
+import type { CreateFormRulesPrompt, DefaultValueType } from '../../../utils/type';
+import { Reactive, Ref, type Component } from 'vue';
+export type { DefaultValueType, MaybePromise } from '../../../utils/type';
+/**
+ * w-form 向下 provide 的表单上下文（经 useFormContext）
+ */
+export type FormContext = {
+    /** 表单 model */
+    model: Ref<any>;
+    /** 表单禁用 */
+    disabled: Ref<boolean>;
+    /** 每行列数 */
+    column: Ref<number | undefined>;
+    /** label 布局 */
+    labelCol: Ref<FormProps['labelCol']>;
+    /** 控件布局 */
+    wrapperCol: Ref<FormProps['wrapperCol']>;
+    /** 表单布局 */
+    layout: Ref<FormProps['layout']>;
+    /** 是否卡片布局 */
+    card: Ref<boolean>;
+    /** item label 与 model 映射 map */
+    labelMap: Reactive<Record<string, {
+        label?: string;
+        prompt?: CreateFormRulesPrompt;
+    }>>;
+    /** 按 model 收集 label */
+    collectLabel: (model: string, config: {
+        label?: string;
+        prompt?: CreateFormRulesPrompt;
+    }) => void;
+};
+/**
+ * w-form 组件实例
+ */
+export interface WFormInstance extends FormInstance {
+    getFormInstance: () => FormInstance | undefined;
+}
+/**
+ * w-form 组件属性
+ */
+export interface WFormProps extends Pick<FormProps, 'model' | 'layout' | 'labelAlign' | 'scrollToFirstError' | 'labelCol' | 'wrapperCol' | 'name' | 'disabled' | 'rules'>, Pick<RowProps, 'gutter' | 'align'> {
+    /**
+     * 每行列数
+     */
+    column?: number;
+    /**
+     * 是否卡片类型布局
+     * @default false
+     */
+    card?: boolean;
+}
+/**
+ * label 旁 tooltip 提示
+ */
+export type FormItemLabelTooltipProps = {
+    /**
+     * label 旁 tooltip 提示文案（支持 i18n key）
+     */
+    labelTooltip?: string;
+    /**
+     * label 旁 tooltip 图标，默认 QuestionCircleOutlined
+     */
+    labelTooltipIcon?: string;
+};
+/**
+ * w-form-item 组件属性
+ */
+export interface WFormItemProps extends WFormColProps, Pick<FormItemProps, 'name' | 'labelCol' | 'wrapperCol' | 'colon'>, FormItemLabelTooltipProps {
+    /**
+     *  item Lable名称
+     */
+    label?: string;
+    /**
+     * 是否用 Input.Group compact 包裹默认插槽内容
+     * @default false
+     */
+    compact?: boolean;
+    /**
+     * 是否用 Space 包裹默认插槽内容（compact 为 true 时不生效）
+     * - `true`：使用 Space，默认属性
+     * - `SpaceProps`：使用 Space，并透传对应 props
+     * @default false
+     */
+    space?: boolean | SpaceProps;
+    /**
+     * 是否跳过 FormCol / FormItem 包装，只渲染默认插槽（裸控件）
+     * - `true` / `false`：强制开启或关闭
+     * - 未传：若处于 w-form-multi-item 内则自动为 true
+     */
+    bare?: boolean;
+}
+/**
+ * w-form-col 组件属性
+ */
+export interface WFormColProps extends Pick<ColProps, 'offset'> {
+    /**
+     * 占位格数
+     */
+    span?: number | 'full';
+}
+export type Response<T = any> = {
+    code: string;
+    success: boolean;
+    result: T;
+    message: string;
+};
+/**
+ * w-form-xxx 组件基础属性
+ */
+export type FormItemXxProps = {
+    /**
+     * 搜索form数据
+     */
+    form?: any;
+    /**
+     * 条件字段名
+     */
+    model: string;
+    /**
+     * 条件Lable名称
+     */
+    label?: string;
+    /**
+     * 同Ant Design Vue框架FormItem组件的name属性一致（默认为model的值）
+     */
+    name?: string;
+    /**
+     * 同Ant Design Vue框架Input、Setect组件的allowClear属性一致（默认为true）
+     */
+    allowClear?: boolean;
+    /**
+     * 是否禁用输入
+     */
+    disabled?: boolean;
+    /**
+     * 输入框提示
+     */
+    placeholder?: string;
+} & FormItemLabelTooltipProps;
+export type TextTransformType = 'capitalize' | 'lowercase' | 'uppercase';
+/**
+ * w-form-input 组件属性
+ */
+export interface WFormInputProps extends Partial<FormItemXxProps> {
+    /**
+     * 输入字母大小写转换类型
+     */
+    textTransform?: TextTransformType;
+    /**
+     * 默认值（仅在为空时写入；重置时强制回写）
+     * 支持静态值、Promise、同步/异步函数，解析结果为 string
+     */
+    defaultValue?: DefaultValueType<string>;
+}
+/**
+ * w-form-number 组件属性
+ */
+export interface WFormNumberProps extends FormItemXxProps {
+    /**
+     * 默认值（仅在为空时写入；重置时强制回写）
+     * 支持静态值、Promise、同步/异步函数，解析结果为 number
+     */
+    defaultValue?: DefaultValueType<number>;
+}
+/**
+ * w-form-i18n 组件属性
+ */
+export interface WFormI18nProps extends FormItemXxProps {
+}
+/**
+ * w-form-tags 组件属性
+ */
+export interface WFormTagsProps extends Omit<FormItemXxProps, 'allowClear'>, Pick<SelectProps, 'tokenSeparators'> {
+    /**
+     * Label字段名
+     */
+    labelModel?: string;
+    /**
+     * Label下拉选项列表
+     */
+    labelOptions?: WDropdownListItem[];
+    /**
+     * 最大标签数量
+     */
+    maxTagLength?: number;
+    /**
+     * 超出最大标签数量提示
+     */
+    maxTagLengthMessage?: string | ((length: number) => string);
+    /**
+     * 默认值（仅在为空时写入；重置时强制回写）
+     * 支持静态值、Promise、同步/异步函数，解析结果为数组
+     */
+    defaultValue?: DefaultValueType<(string | number)[]>;
+    /**
+     * Label 下拉默认值；有值用它，否则用 labelOptions[0].value
+     */
+    defaultLabelValue?: string | number;
+}
+/**
+ * w-textarea 组件属性
+ */
+export interface WFormTextareaProps extends FormItemXxProps {
+    /**
+     * 默认值（仅在为空时写入；重置时强制回写）
+     * 支持静态值、Promise、同步/异步函数，解析结果为 string
+     */
+    defaultValue?: DefaultValueType<string>;
+}
+/**
+ * w-select 组件属性
+ */
+export interface WFormSelectProps extends FormItemXxProps, Pick<SelectProps, 'loading' | 'autoClearSearchValue' | 'mode' | 'filterOption'> {
+    /**
+     * 下拉框选项列表
+     */
+    options?: OptionType[];
+    /**
+     * 加载下拉框选项列表接口url
+     */
+    url?: string;
+    /**
+     * 加载下拉框选项列表自定义方法，优先级高于url
+     * @param value 搜索关键字
+     */
+    request?: (value?: string) => Promise<Response>;
+    /**
+     * 加载下拉框选项列表接口类型（默认POST）
+     */
+    method?: string;
+    /**
+     * 加载下拉框选项列表接口请求参数
+     */
+    params?: any;
+    /**
+     * 接口请求keyword
+     */
+    searchKeyword?: string;
+    /**
+     * 远程搜索防抖毫秒数（默认 300）
+     */
+    searchDebounceMs?: number;
+    /**
+     * 触发远程搜索的最小关键字长度（默认 0，空串表示重置全量）
+     */
+    minSearchLength?: number;
+    /**
+     * 默认选中值（仅在 form[model] 为空时写入；重置时强制回写）
+     * 支持静态值、Promise、同步/异步函数
+     */
+    defaultValue?: DefaultValueType<string | number | (string | number)[]>;
+}
+/**
+ * w-select-date-range 组件属性
+ * model 可选：仅用 keys 写 From/To 时可不传 model
+ */
+export interface WFormDateRangeProps extends Omit<FormItemXxProps, 'model'>, Pick<DatePickerProps, 'picker' | 'showTime'>, Pick<TimeRangePickerProps, 'presets'> {
+    /**
+     * 区间数组字段名（与 keys 二选一或并存；有 model 时优先读写 form[model]）
+     */
+    model?: string;
+    /**
+     * Label 下拉选项列表
+     */
+    labelOptions?: WDropdownListItem[];
+    /**
+     * Label字段名
+     */
+    labelModel?: string;
+    /**
+     * 时长范围，单位天
+     */
+    offsetDays?: number;
+    /**
+     * 时长范围的最大值
+     */
+    limit?: number;
+    /**
+     * 时间格式
+     */
+    format?: FormatType;
+    /**
+     * 绑定时间范围字段名，如果是字符类型。例：'time' => ['timeFrom', 'timeTo']
+     */
+    keys?: string | [StartField: string, EndField: string];
+    /**
+     * 搜索区重置时是否删除绑定字段
+     * @default true
+     */
+    delModel?: boolean;
+    /**
+     * 是否允许选择未来时间
+     * @default true
+     */
+    futureTimeAllowed?: boolean;
+    /**
+     * 默认时间范围（仅在 form[model] 为空时写入）
+     * 支持静态值、Promise、同步/异步函数
+     */
+    defaultValue?: DefaultValueType<[Dayjs, Dayjs] | [string, string] | [number, number]>;
+    /**
+     * Label 下拉默认值；有值用它，否则用 labelOptions[0].value
+     */
+    defaultLabelValue?: string | number;
+}
+/**
+ * w-select-time-picker 组件属性
+ */
+export interface WFormTimePickerProps extends FormItemXxProps {
+    /**
+     * 时间格式
+     */
+    format?: string;
+}
+/**
+ * w-select-date-picker 组件属性
+ */
+export interface WFormDatePickerProps extends FormItemXxProps, Pick<DatePickerProps, 'picker'> {
+    /**
+     * 时间格式
+     */
+    format?: string;
+    /**
+     * 搜索区重置时是否删除绑定字段
+     * @default true
+     */
+    delModel?: boolean;
+    /**
+     * 是否展示时间选择；
+     * - `'start'`：默认 00:00:00（毫秒 000）
+     * - `'end'`：默认 23:59:59（毫秒 999）
+     * - 其余同 a-date-picker 的 showTime
+     */
+    showTime?: DatePickerProps['showTime'] | 'start' | 'end';
+}
+/**
+ * w-checkbox 组件属性
+ */
+export interface WFormCheckboxProps extends FormItemXxProps {
+    /**
+     * 复选框选项列表
+     */
+    options?: OptionType[];
+    /**
+     * 复选框选项列表接口url，优先级高于 dict 字段
+     */
+    url?: string;
+    /**
+     * 复选框选项列表自定义方法，优先级高于url
+     * @param value 搜索关键字
+     */
+    request?: (value?: string) => Promise<Response>;
+    /**
+     * 复选框选项列表接口类型（默认POST）
+     */
+    method?: string;
+    /**
+     * 复选框选项列表接口请求参数
+     */
+    params?: any;
+    /**
+     * 快捷请求数据字典同/platform/basicDict/list接口dataType字段
+     */
+    dict?: string;
+    /**
+     * 单个选项label字段，
+     */
+    checkboxLabel?: string;
+    /**
+     * 默认选中值（仅在 form[model] 为空时写入；重置时强制回写）
+     * 单选 Checkbox 用 boolean；CheckboxGroup 用数组
+     * 支持静态值、Promise、同步/异步函数
+     */
+    defaultValue?: DefaultValueType<boolean | (string | number)[]>;
+}
+/**
+ * w-radio 组件属性
+ */
+export interface WFormRadioProps extends FormItemXxProps {
+    /**
+     * 单选框选项列表
+     */
+    options?: OptionType[];
+    /**
+     * 单选框选项列表接口url，优先级高于 dict 字段
+     */
+    url?: string;
+    /**
+     * 单选框选项列表自定义方法，优先级高于url
+     * @param value 搜索关键字
+     */
+    request?: (value?: string) => Promise<Response>;
+    /**
+     * 单选框选项列表接口类型（默认POST）
+     */
+    method?: string;
+    /**
+     * 单选框选项列表接口请求参数
+     */
+    params?: any;
+    /**
+     * 快捷请求数据字典同/platform/basicDict/list接口dataType字段
+     */
+    dict?: string;
+    /**
+     * 默认选中值（仅在 form[model] 为空时写入；重置时强制回写）
+     * 支持静态值、Promise、同步/异步函数
+     */
+    defaultValue?: DefaultValueType<string | number>;
+}
+type InputNumberConfig = {
+    /**
+     * 提示文本
+     */
+    placeholder?: string;
+} & Omit<InputNumberProps, 'min' | 'max'>;
+/**
+ * w-select-two-input 组件属性
+ * model 可选：仅用 keys 写起止字段时可不传 model
+ */
+export interface WFormNumberRangeProps extends Omit<FormItemXxProps, 'model'> {
+    /**
+     * 区间数组字段名（与 keys 二选一或并存）
+     */
+    model?: string;
+    /**
+     * Label 下拉选项列表
+     */
+    labelOptions?: WDropdownListItem[];
+    /**
+     * Label字段名
+     */
+    labelModel?: string;
+    /**
+     * Label 下拉默认值（未传时取 labelOptions[0].value）
+     */
+    defaultLabelValue?: string | number;
+    /**
+     * 最小值
+     */
+    min?: number;
+    /**
+     * 最大值
+     */
+    max?: number;
+    /**
+     * 绑定数值范围字段名，如果是字符类型。例：'amount' => ['amountFrom', 'amountTo']
+     */
+    keys?: string | [StartField: string, EndField: string];
+    /**
+     * 输入框配置
+     */
+    config?: [Start: InputNumberConfig, End: InputNumberConfig];
+    /**
+     * 默认值：`[start, end]`；挂载写入，WSearch 重置后回写
+     */
+    defaultValue?: DefaultValueType<[number | undefined, number | undefined]>;
+}
+/**
+ * w-form-custom 组件属性
+ */
+export interface WFormCustomProps extends FormItemXxProps {
+    /**
+     * Input插槽名
+     */
+    inputSlot?: string;
+    /**
+     * Lable插槽名
+     */
+    labelSlot?: string;
+}
+/**
+ * w-form-upload 组件属性
+ */
+export interface WFormUploadProps extends FormItemXxProps, Pick<UploadProps, 'multiple' | 'beforeUpload'> {
+}
+/**
+ * w-form-upload-image 组件属性
+ */
+export interface WFormUploadImageProps extends WUploadProps, WFormUploadProps {
+    /**
+     * 宽度
+     */
+    width?: number;
+    /**
+     * 高度
+     */
+    height?: number;
+    /**
+     * 是否开启裁剪
+     */
+    cropProps?: WCropperProp;
+}
+/**
+ * w-form-multi-item 配置式选项（无 WFormMultiItemOption 子组件时使用）
+ */
+export interface WFormMultiItemOptionConfig {
+    /**
+     * 选项标识，同时作为下拉 key；非区间内层控件会绑定到 form[model]
+     */
+    model: string;
+    /**
+     * 下拉展示文案（支持 i18n key）
+     */
+    label?: string;
+    /**
+     * 配置式渲染的组件（string 名或组件对象）
+     */
+    component?: string | Component;
+    /**
+     * 传给 component 的额外 props
+     */
+    componentProps?: Record<string, unknown>;
+    /**
+     * 具名插槽名；未传时默认用 model
+     */
+    slot?: string;
+    /**
+     * 是否禁用该下拉项
+     */
+    disabled?: boolean;
+}
+/**
+ * w-form-multi-item 组件属性
+ *
+ * Label 区为 WDropdown，切换选项时会清空非当前 option 对应字段（或调用 registerClear）。
+ * 内层 WFormXxx 在 Option 内自动 bare（跳过 FormItem），非区间控件的 model / label 会被 Option 覆盖。
+ */
+export interface WFormMultiItemProps extends Partial<FormItemXxProps> {
+    /**
+     * 当前选中的 option.model，对应 v-model:activeKey
+     */
+    activeKey?: string;
+    /**
+     * 配置式选项列表；存在 WFormMultiItemOption 子组件注册时优先用注册项
+     */
+    options?: WFormMultiItemOptionConfig[];
+    /**
+     * 下拉默认选中项；有值用它，否则取 options / 注册项第一项的 model
+     */
+    defaultLabelValue?: string | number;
+}
+/**
+ * w-form-multi-item-option 组件属性（对齐 FormItemXxProps：model + label）
+ *
+ * 向内层 provide Option.model / Option.label：
+ * - 非区间控件绑定 form[model]，label 用于 placeholder / 校验文案
+ * - 区间类仅用 model 作为 registerClear 的 key
+ */
+export interface WFormMultiItemOptionProps {
+    /**
+     * 选项标识 / 下拉 key；非区间子控件字段名；区间子控件 clear 注册 key
+     */
+    model: string;
+    /**
+     * 下拉展示文案（支持 i18n key）；同时覆盖内层控件 label
+     */
+    label?: string;
+    /**
+     * 是否禁用该下拉项
+     */
+    disabled?: boolean;
+}
+/**
+ * w-form-match 组件属性
+ */
+export interface WInputMatchProps extends FormItemXxProps, Pick<SelectProps, 'tokenSeparators'> {
+    /**
+     * Label字段名
+     */
+    labelModel?: string;
+    /**
+     * 匹配模式字段名
+     */
+    afterModel?: string;
+    /**
+     * 父级字段名
+     */
+    parentModel?: string;
+    /**
+     * Label下拉选项列表
+     */
+    labelOptions?: WDropdownListItem[];
+    /**
+     * 匹配模式下拉选项列表
+     */
+    afterOptions?: OptionType[];
+    /**
+     * 数字输入类型集合
+     */
+    numberfs?: string[];
+    /**
+     * 字符输入类型集合
+     */
+    inputfs?: string[];
+    /**
+     * 最大标签数量
+     */
+    maxTagLength?: number;
+    /**
+     * 超出最大标签数量提示
+     */
+    maxTagLengthMessage?: string | ((length: number) => string);
+    /**
+     * 主输入默认值（仅在为空时写入；重置时强制回写）
+     * 支持静态值、Promise、同步/异步函数
+     */
+    defaultValue?: DefaultValueType<string | number | (string | number)[]>;
+    /**
+     * Label 下拉默认值；有值用它，否则用 labelOptions[0].value
+     */
+    defaultLabelValue?: string | number;
+    /**
+     * after 下拉默认值；有值用它，否则用 afterOptions[0].value
+     */
+    defaultAfterValue?: string | number;
+}

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

@@ -0,0 +1,2 @@
+export * from './business';
+export * from './default';

package/dist/types/components/form/type.d.ts

@@ -0,0 +1,2 @@
+export * from './business/type';
+export * from './default/type';

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

@@ -0,0 +1,4 @@
+export type { WIconProp } from './type';
+export { default as WIcon } from './src/index.vue';
+export { default as Icon } from './src/icon.vue';
+export { default as WSwitchIcon } from './src/switch.vue';

package/dist/types/components/icon/src/icon.vue.d.ts

@@ -0,0 +1,12 @@
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    type: {
+        type: StringConstructor;
+        required: true;
+    };
+}>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    type: {
+        type: StringConstructor;
+        required: true;
+    };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/types/components/icon/src/index.vue.d.ts

@@ -0,0 +1,9 @@
+import type { WIconProp } from '../type';
+declare const _default: import("vue").DefineComponent<WIconProp, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    click: (event: Event) => any;
+}, string, import("vue").PublicProps, Readonly<WIconProp> & Readonly<{
+    onClick?: ((event: Event) => any) | undefined;
+}>, {
+    iconClass: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/components/icon/src/switch.vue.d.ts

@@ -0,0 +1,18 @@
+import { type SwitchProps } from 'ant-design-vue';
+interface SwitchIcon extends SwitchProps {
+    title?: string;
+}
+type __VLS_Props = SwitchIcon;
+type __VLS_PublicProps = __VLS_Props & {
+    'checked'?: boolean | string | number;
+};
+declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    change: (checked: string | number | boolean, event: Event) => any;
+    click: (checked: string | number | boolean, event: Event) => any;
+    "update:checked": (value: string | number | boolean | undefined) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    onChange?: ((checked: string | number | boolean, event: Event) => any) | undefined;
+    onClick?: ((checked: string | number | boolean, event: Event) => any) | undefined;
+    "onUpdate:checked"?: ((value: string | number | boolean | undefined) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;