wlwy-package 4.0.0-beta.11 → 4.0.0-beta.13

package/dist/types/components/form/default/src/checkbox.vue.d.ts

@@ -1,9 +1,13 @@
 import type { WFormCheckboxProps } from '../type';
-import type { OptionType } from '../../../../type';
 declare const _default: __VLS_WithSlots<import("vue").DefineComponent<WFormCheckboxProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<WFormCheckboxProps> & Readonly<{}>, {
     params: any;
     method: string;
-    options: OptionType[];
+    options: {
+        key: import("../../../../type").KeyType;
+        value: import("../../../../type").KeyType;
+        label: string;
+        disabled?: boolean | undefined;
+    }[];
     allowClear: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {
     label?: ((props: any) => any) | undefined;

package/dist/types/components/form/default/src/form.vue.d.ts

@@ -6,8 +6,8 @@ declare const _default: __VLS_WithSlots<import("vue").DefineComponent<WFormProps
     $data: {};
     $props: {
         size?: "small" | "middle" | "large" | undefined;
-        disabled?: boolean | undefined;
         onSubmit?: ((e: Event) => void) | undefined;
+        disabled?: boolean | undefined;
         colon?: boolean | undefined;
         labelCol?: (Partial<import("vue").ExtractPropTypes<{
             span: (NumberConstructor | StringConstructor)[];
@@ -134,8 +134,8 @@ declare const _default: __VLS_WithSlots<import("vue").DefineComponent<WFormProps
     $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (args_0: R, args_1: R, args_2: import("@vue/reactivity").OnCleanup) => any : (args_0: any, args_1: any, args_2: import("@vue/reactivity").OnCleanup) => any, options?: import("vue").WatchOptions<boolean> | undefined): import("vue").WatchStopHandle;
     name?: string | undefined;
     size?: "small" | "middle" | "large" | undefined;
-    disabled?: boolean | undefined;
     onSubmit?: ((e: Event) => void) | undefined;
+    disabled?: boolean | undefined;
     prefixCls?: string | undefined;
     layout?: string | undefined;
     colon?: boolean | undefined;

package/dist/types/components/form/default/src/inputMatch.vue.d.ts

@@ -11,7 +11,12 @@ declare const _default: import("vue").DefineComponent<WInputMatchProps, {}, {},
     labelModel: string;
     labelOptions: WDropdownListItem[];
     afterModel: string;
-    afterOptions: import("../../../../type.ts").OptionType[];
+    afterOptions: {
+        key: import("../../../../type.ts").KeyType;
+        value: import("../../../../type.ts").KeyType;
+        label: string;
+        disabled?: boolean | undefined;
+    }[];
     numberfs: string[];
     inputfs: string[];
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/dist/types/components/form/default/src/radio.vue.d.ts

@@ -1,9 +1,13 @@
 import type { WFormRadioProps } from '../type';
-import type { OptionType } from '../../../../type';
 declare const _default: __VLS_WithSlots<import("vue").DefineComponent<WFormRadioProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<WFormRadioProps> & Readonly<{}>, {
     params: any;
     method: string;
-    options: OptionType[];
+    options: {
+        key: import("../../../../type").KeyType;
+        value: import("../../../../type").KeyType;
+        label: string;
+        disabled?: boolean | undefined;
+    }[];
     allowClear: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, {
     label?: ((props: any) => any) | undefined;

package/dist/types/components/form/default/src/select.vue.d.ts

@@ -1,5 +1,4 @@
 import type { WFormSelectProps } from '../type';
-import type { OptionType } from '../../../../type';
 declare var __VLS_11: number, __VLS_12: any, __VLS_15: "label" | "extra" | "help", __VLS_16: any;
 type __VLS_Slots = {} & {
     [K in NonNullable<typeof __VLS_11>]?: (props: typeof __VLS_12) => any;
@@ -9,7 +8,12 @@ type __VLS_Slots = {} & {
 declare const _default: __VLS_WithSlots<import("vue").DefineComponent<WFormSelectProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<WFormSelectProps> & Readonly<{}>, {
     params: any;
     method: string;
-    options: OptionType[];
+    options: {
+        key: import("../../../../type").KeyType;
+        value: import("../../../../type").KeyType;
+        label: string;
+        disabled?: boolean | undefined;
+    }[];
     allowClear: boolean;
     autoClearSearchValue: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, __VLS_Slots>;

package/dist/types/hooks/business/src/useCountryDict.d.ts

@@ -1,17 +1,24 @@
 import type { ExtendedSuffix } from '../../../type';
 type IdType = ExtendedSuffix<'country'>;
+/**
+ * 内置国家字典。也可通过 {@link useBusinessDict}('country') 使用。
+ * @param id 缓存 key，默认 `'country'`；同名字典多份缓存时传 `'country_xxx'`
+ */
 export default function useCountryDict(id?: IdType): {
     dict: {
-        [x: string]: any;
         key: import("../../../type").KeyType;
         value: import("../../../type").KeyType;
         label: string;
         disabled?: boolean | undefined;
     }[];
-    getDict: () => Promise<import("../../../type").OptionType[]>;
+    getDict: (reload?: boolean) => Promise<{
+        key: import("../../../type").KeyType;
+        value: import("../../../type").KeyType;
+        label: string;
+        disabled?: boolean | undefined;
+    }[]>;
     getLabelByCode: (code: string) => string;
     getItemByCode: (code: string) => {
-        [x: string]: any;
         key: import("../../../type").KeyType;
         value: import("../../../type").KeyType;
         label: string;

package/dist/types/hooks/business/src/useCurrencyDict.d.ts

@@ -1,17 +1,24 @@
 import type { ExtendedSuffix } from '../../../type';
 type IdType = ExtendedSuffix<'currency'>;
+/**
+ * 内置币种字典。也可通过 {@link useBusinessDict}('currency') 使用。
+ * @param id 缓存 key，默认 `'currency'`；同名字典多份缓存时传 `'currency_xxx'`
+ */
 export default function useCurrencyDict(id?: IdType): {
     dict: {
-        [x: string]: any;
         key: import("../../../type").KeyType;
         value: import("../../../type").KeyType;
         label: string;
         disabled?: boolean | undefined;
     }[];
-    getDict: () => Promise<import("../../../type").OptionType[]>;
+    getDict: (reload?: boolean) => Promise<{
+        key: import("../../../type").KeyType;
+        value: import("../../../type").KeyType;
+        label: string;
+        disabled?: boolean | undefined;
+    }[]>;
     getLabelByCode: (code: string) => string;
     getItemByCode: (code: string) => {
-        [x: string]: any;
         key: import("../../../type").KeyType;
         value: import("../../../type").KeyType;
         label: string;

package/dist/types/hooks/business/src/useCustomerDict.d.ts

@@ -1,17 +1,24 @@
 import type { ExtendedSuffix } from '../../../type';
 type IdType = ExtendedSuffix<'customer'>;
+/**
+ * 内置客户字典。也可通过 {@link useBusinessDict}('customer') 使用。
+ * @param id 缓存 key，默认 `'customer'`；同名字典多份缓存时传 `'customer_xxx'`
+ */
 export default function useCustomerDict(id?: IdType): {
     dict: {
-        [x: string]: any;
         key: import("../../../type").KeyType;
         value: import("../../../type").KeyType;
         label: string;
         disabled?: boolean | undefined;
     }[];
-    getDict: () => Promise<import("../../../type").OptionType[]>;
+    getDict: (reload?: boolean) => Promise<{
+        key: import("../../../type").KeyType;
+        value: import("../../../type").KeyType;
+        label: string;
+        disabled?: boolean | undefined;
+    }[]>;
     getLabelByCode: (code: string) => string;
     getItemByCode: (code: string) => {
-        [x: string]: any;
         key: import("../../../type").KeyType;
         value: import("../../../type").KeyType;
         label: string;

package/dist/types/hooks/business/src/useWarehouseZoneDict.d.ts

@@ -1,17 +1,24 @@
 import type { ExtendedSuffix } from '../../../type';
 type IdType = ExtendedSuffix<'warehouseZone'>;
+/**
+ * 内置库区字典。也可通过 {@link useBusinessDict}('warehouseZone') 使用。
+ * @param id 缓存 key，默认 `'warehouseZone'`；同名字典多份缓存时传 `'warehouseZone_xxx'`
+ */
 export default function useWarehouseZoneDict(id?: IdType): {
     dict: {
-        [x: string]: any;
         key: import("../../../type").KeyType;
         value: import("../../../type").KeyType;
         label: string;
         disabled?: boolean | undefined;
     }[];
-    getDict: () => Promise<import("../../../type").OptionType[]>;
+    getDict: (reload?: boolean) => Promise<{
+        key: import("../../../type").KeyType;
+        value: import("../../../type").KeyType;
+        label: string;
+        disabled?: boolean | undefined;
+    }[]>;
     getLabelByCode: (code: string) => string;
     getItemByCode: (code: string) => {
-        [x: string]: any;
         key: import("../../../type").KeyType;
         value: import("../../../type").KeyType;
         label: string;

package/dist/types/hooks/business/useBusinessDict.d.ts

@@ -1,2 +1,13 @@
 import type { DictBasicNameType } from '.';
+/**
+ * 公共组件**内置业务字典**入口。
+ *
+ * 仅支持 {@link DictBasicNameType}（`warehouseZone` / `country` / `customer` / `currency`），
+ * 内部转发至对应的 `useXxxDict`。
+ *
+ * 业务项目自定义字典请使用 {@link useDict}。
+ *
+ * @param name 内置字典基础名称
+ * @returns 对应内置字典 Hook 的返回值；未找到时返回 `{}`
+ */
 export default function useBusinessDict(name: DictBasicNameType): any;

package/dist/types/hooks/business/useDict.d.ts

@@ -1,25 +1,30 @@
-import type { ClearDictOption, ExtendedSuffix, OptionType } from '../../type';
+import type { ClearDictOption, OptionType } from '../../type';
+/** 公共组件内置业务字典基础名称（请通过 {@link useBusinessDict} / useXxxDict 使用） */
 export type DictBasicNameType = 'warehouseZone' | 'country' | 'customer' | 'currency';
-export type DictNameType = `private_${string}` | ExtendedSuffix<DictBasicNameType>;
-export type DictOptionType = {
-    request: () => Promise<OptionType[]>;
+/**
+ * 字典缓存 key。
+ * - 业务自定义字典：可传任意 `string`（建议避免与内置名冲突，或使用 `private_` 前缀）
+ * - 内置名及其后缀：会与公共内置字典共用同一缓存
+ */
+export type DictNameType = DictBasicNameType | (string & {});
+/** 字典拉取配置 */
+export type DictOptionType<T = unknown> = {
+    /** 远程请求，返回 `{ key, value, label, ... }` 选项列表 */
+    request: () => Promise<OptionType<T>[]>;
 };
-export default function useDict(name: DictNameType, option: DictOptionType): {
-    dict: {
-        [x: string]: any;
-        key: import("../../type").KeyType;
-        value: import("../../type").KeyType;
-        label: string;
-        disabled?: boolean | undefined;
-    }[];
-    getDict: () => Promise<OptionType[]>;
+/**
+ * 通用字典 Hook，供**业务项目自定义字典**使用：按名称读写缓存、按 code 查 label/item、清除缓存。
+ *
+ * 公共组件内置字典请使用 {@link useBusinessDict}（或 `useCountryDict` 等具体 Hook）。
+ *
+ * @param name 字典名称（缓存 key），可传任意 string
+ * @param option 拉取配置，需提供 `request`
+ * @returns `{ dict, getDict, getLabelByCode, getItemByCode, clearDict }`
+ */
+export default function useDict<T = unknown>(name: DictNameType, option: DictOptionType<T>): {
+    dict: OptionType<T>[];
+    getDict: (reload?: boolean) => Promise<OptionType<T>[]>;
     getLabelByCode: (code: string) => string;
-    getItemByCode: (code: string) => {
-        [x: string]: any;
-        key: import("../../type").KeyType;
-        value: import("../../type").KeyType;
-        label: string;
-        disabled?: boolean | undefined;
-    } | undefined;
+    getItemByCode: (code: string) => OptionType<T> | undefined;
     clearDict: (option?: ClearDictOption | boolean) => void;
 };

package/dist/types/hooks/web/index.d.ts

@@ -1,6 +1,6 @@
 export { default as useCatchPreloadError } from './src/useCatchPreloadError';
 export { default as useCookie } from './src/useCookie';
-export { default as useDate, type DateInput, type DateRange, type UseDateOptions, type RecentRangeOptions } from './src/useDate';
+export { default as useDate, type DateInput, type DateRange, type UseDateOptions, type RecentRangeOptions, type RangeOffsets, type RecentRangeN, } from './src/useDate';
 export { default as useEnum } from './src/useEnum';
 export { default as useExport } from './src/useExport';
 export * from './src/useI18n';

package/dist/types/hooks/web/src/useDate.d.ts

@@ -12,7 +12,12 @@ export type RecentRangeOptions = {
     includeCurrent?: boolean;
     /** 基准日，默认今天 */
     base?: DateInput;
+    /** 方向：forward=正向（往未来）、backward=反向（往过去），默认 backward */
+    direction?: 'forward' | 'backward';
 };
+/** 相对 base 的偏移元组 [起点偏移, 终点偏移]；配合 direction：backward 时正=往过去，forward 时正=往未来 */
+export type RangeOffsets = readonly [start: number, end: number];
+export type RecentRangeN = number | RangeOffsets;
 export declare const DEFAULT_DATETIME_FORMAT = "YYYY-MM-DD HH:mm:ss";
 export declare const DEFAULT_DATE_FORMAT = "YYYY-MM-DD";
 /**
@@ -31,10 +36,10 @@ export default function useDate(options?: UseDateOptions): {
     endOf: (value?: DateInput, unit?: OpUnitType) => Dayjs;
     toTimestamp: (value?: DateInput) => number;
     fromTimestamp: (ms: number) => Dayjs;
-    recentRange: (n: number, unit?: ManipulateType, opts?: RecentRangeOptions) => DateRange;
-    recentDays: (n: number, opts?: RecentRangeOptions) => DateRange;
-    recentMonths: (n: number, opts?: RecentRangeOptions) => DateRange;
-    recentYears: (n: number, opts?: RecentRangeOptions) => DateRange;
+    recentRange: (n: RecentRangeN, unit?: ManipulateType, opts?: RecentRangeOptions) => DateRange;
+    recentDays: (n: RecentRangeN, opts?: RecentRangeOptions) => DateRange;
+    recentMonths: (n: RecentRangeN, opts?: RecentRangeOptions) => DateRange;
+    recentYears: (n: RecentRangeN, opts?: RecentRangeOptions) => DateRange;
     presets: {
         last3Days: () => DateRange;
         last7Days: () => DateRange;

package/dist/types/hooks/web/src/useEnum.d.ts

@@ -1,4 +1,3 @@
-import type { OptionType } from '../../../type';
 type CommonType = {
     [key: string]: {
         [key: string]: string;
@@ -12,7 +11,12 @@ export declare const COMMON: {};
 export declare const OPTION: {};
 export default function useEnum<T extends CommonType, K>(options: EnumType<T, K>): {
     enums: T;
-    enumMap: Map<keyof T, OptionType[]>;
+    enumMap: Map<keyof T, {
+        key: import("../../../type").KeyType;
+        value: import("../../../type").KeyType;
+        label: string;
+        disabled?: boolean | undefined;
+    }[]>;
     getEnum: <T_1 extends keyof T, K_1 extends keyof T[T_1]>(name: T_1, keyTypeTransform?: "number" | "boolean" | "boolean2number" | "original") => {
         key: keyof T[T_1];
         value: keyof T[T_1];