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

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

@@ -0,0 +1,35 @@
+import type { OptionType } from '../../type';
+/** 业务自定义字典缓存 key 前缀，与内置字典隔离 */
+export declare const DICT_PRIVATE_PREFIX: "private_";
+/** 公共组件内置业务字典基础名称（请通过 {@link useBusinessDict} / useXxxDict 使用） */
+export type DictBasicNameType = 'warehouseZone' | 'country' | 'customer' | 'currency';
+/**
+ * 字典缓存 key。
+ * - 内置名及其后缀（如 `country` / `country_xxx`）：由内置 Hook 使用原始 key
+ * - 业务自定义：经 {@link useDict} 自动加上 {@link DICT_PRIVATE_PREFIX}
+ */
+export type DictNameType = DictBasicNameType | (string & {});
+/** 字典拉取配置 */
+export type DictOptionType<T = unknown> = {
+    /** 远程请求，返回 `{ key, value, label, ... }` 选项列表 */
+    request: () => Promise<OptionType<T>[]>;
+};
+/** 将业务逻辑名转为实际缓存 key（已带前缀则不再套一层） */
+export declare function toPrivateDictName(name: string): string;
+/**
+ * 通用字典 Hook，供**业务项目自定义字典**使用：按名称读写缓存、按 code 查 label/item、清除缓存。
+ *
+ * 实际缓存 key 为 `private_${name}`（已带 `private_` 前缀则不再套一层），与内置字典隔离。
+ * 公共组件内置字典请使用 {@link useBusinessDict}（或 `useCountryDict` 等具体 Hook）。
+ *
+ * @param name 字典逻辑名称，可传任意 string
+ * @param option 拉取配置，需提供 `request`
+ * @returns `{ dict, getDict, getLabelByCode, getItemByCode, clearDict }`
+ */
+export default function useDict<T = unknown>(name: string, option: DictOptionType<T>): {
+    dict: OptionType<T>[];
+    getDict: (reload?: boolean) => Promise<OptionType<T>[]>;
+    getLabelByValue: (value: OptionType<T>["value"]) => string | OptionType<T>["label"];
+    getItemByValue: (value: OptionType<T>["value"]) => OptionType<T> | undefined;
+    clearDict: (option?: boolean | import("../../type").ClearDictOption | undefined) => void;
+};

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

@@ -0,0 +1,14 @@
+import type { ClearDictOption, OptionType } from '../../type';
+import type { DictNameType, DictOptionType } from './useDict';
+/**
+ * 按原始缓存 key 读写字典（仅包内置 useXxxDict 使用，不自动加 `private_` 前缀）。
+ * 不经由 business/index 对外导出。
+ */
+export declare function useDictRaw<T = unknown>(name: DictNameType, option: DictOptionType<T>): {
+    /** 与 store 共用同一数组引用，`getDict` / `clearDict` 后自动更新，解构后无需 `.value` */
+    dict: OptionType<T>[];
+    getDict: (reload?: boolean) => Promise<OptionType<T>[]>;
+    getLabelByValue: (value: OptionType<T>['value']) => OptionType<T>['label'] | string;
+    getItemByValue: (value: OptionType<T>['value']) => OptionType<T> | undefined;
+    clearDict: (option?: ClearDictOption | boolean) => void;
+};

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

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

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

@@ -0,0 +1,7 @@
+export { default as useRenderCell, toFormatCellOptions, resolveLegacyEnumMap, type RenderCellProps, type RenderCellFormatByType, type RenderCellFormatType, type RenderCellLegacyProps } from './src/useRenderCell';
+export { default as useKey } from './src/useKey';
+export { default as useFormItemProps } from './src/useFormItemProps';
+export { default as useFormFieldRegister } from './src/useFormFieldRegister';
+export { default as useFormDefaultValue, useMultiItemContext, type UseFormDefaultValueOptions } from './src/useFormDefaultValue';
+export { default as useFormContext } from './src/useFormContext';
+export { default as useTabsNav } from './src/useTabsNav';

package/dist/types/hooks/private/src/useFormContext.d.ts

@@ -0,0 +1,12 @@
+import type { FormContext } from '../../../components/form/type';
+import { type Ref } from 'vue';
+export default function useFormContext<T = any>(): {
+    provideFormContext: (ctx: FormContext) => void;
+    injectFormContext: () => FormContext | undefined;
+    provideData: (data: Ref<T>) => void;
+    injectData: (defaultValue?: Ref<T>) => Ref<T> | undefined;
+    provideDetailsLoading: (loading: Ref<boolean>) => void;
+    injectDetailsLoading: (defaultValue?: boolean) => Ref<boolean>;
+    provideCardLoading: (loading: Ref<boolean>) => void;
+    injectCardLoading: (defaultValue?: boolean) => Ref<boolean>;
+};

package/dist/types/hooks/private/src/useFormDefaultValue.d.ts

@@ -0,0 +1,42 @@
+import type { DefaultValueType } from '../../../utils/type';
+/**
+ * MultiItem 上下文能力（供表单控件统一使用）：
+ * - `isInactive()`：处于 `w-form-multi-item` 内且当前不是本 Option
+ * - `registerClear()`：注册「切换离开本 Option」时的字段清理（多字段控件用）
+ *
+ * 不在 MultiItem 内时 `isInactive()` 恒为 false，`registerClear()` 为空实现。
+ */
+export declare function useMultiItemContext(): {
+    isInactive: () => boolean;
+    registerClear: (clear: () => void) => void;
+};
+export type UseFormDefaultValueOptions<T> = {
+    /** defaultValue 取值（getter，保证读到最新 props） */
+    getDefaultValue: () => DefaultValueType<T> | undefined;
+    /** 目标字段是否为空（非 force 场景判定；异步解析完成后会再判一次） */
+    isEmpty: () => boolean;
+    /** 写入解析结果 */
+    write: (resolved: T) => void;
+    /**
+     * 其余回写：label / after 默认值、未传 defaultValue 时 force 写空值等。
+     * 与 defaultValue 回写一样受 MultiItem 守卫保护。
+     */
+    extra?: (force: boolean) => void;
+    /** 是否在挂载时写入默认值，默认 true */
+    applyOnMount?: boolean;
+};
+/**
+ * 表单默认值 + 搜索重置统一处理：
+ * - 挂载时写入默认值（非 force：仅当字段为空）
+ * - 在 `w-list-search` / `w-detail-search` 内注册重置回调（force：强制回写）
+ * - 处于 `w-form-multi-item` 内且非当前选中项时跳过回写（含异步 defaultValue 解析完成后，
+ *   避免 Search 清空又被 default-value 钩子写回）
+ *
+ * @see WSearchRegisterResetKey
+ * @see FormMultiItemContextKey
+ */
+export declare function useFormDefaultValue<T>(options: UseFormDefaultValueOptions<T>): {
+    applyDefaultValue: (force?: boolean) => void;
+    isInactive: () => boolean;
+};
+export default useFormDefaultValue;

package/dist/types/hooks/private/src/useFormFieldRegister.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 向最近的搜索区（`w-search` / `w-list-search` / `w-detail-search`）上报本控件占用的 form 字段名。
+ *
+ * - 传入 getter（而非快照），字段名随 props 变化时无需重新注册
+ * - 不在搜索区内时为空实现，对详情 / 编辑等场景无副作用
+ * - 挂载时注册、卸载时取消；`w-form-multi-item` 下未激活的 Option 不挂载故不上报，
+ *   其字段由 MultiItem 自身上报全部 `option.model` 兜底
+ *
+ * @param getKeys 返回本控件占用的 form 字段名（如 `[model, startKey, endKey, labelModel]`）
+ * @see WSearchRegisterFieldKey
+ */
+export declare function useFormFieldRegister(getKeys: () => string[]): void;
+export default useFormFieldRegister;

package/dist/types/hooks/private/src/useFormItemProps.d.ts

@@ -0,0 +1,45 @@
+import { type ComputedRef } from 'vue';
+import { type FormItemProps } from 'ant-design-vue';
+import type { FormItemXxProps } from '../../../components';
+import type { CreateFormRulesPrompt } from '../../../utils/type';
+import type { WFormItemProps } from '../../../components/form/type';
+type PropsType = Partial<Pick<FormItemXxProps, 'form' | 'label' | 'disabled' | 'placeholder' | 'name' | 'model'>>;
+export type UseFormItemPropsOptions = {
+    /** 缺省校验文案 / placeholder：enter → 请输入，select → 请选择 */
+    prompt?: CreateFormRulesPrompt;
+};
+type FormItemSlotsKeyType = keyof Pick<FormItemProps, 'label' | 'help' | 'extra'>;
+type AttrMapType = {
+    formItem: Partial<FormItemProps & WFormItemProps>;
+    default: any;
+};
+type SlotMapType = {
+    formItem: Partial<Pick<FormItemProps, FormItemSlotsKeyType>>;
+    default: any;
+};
+/**
+ * 表单项公共 props 解析：拆分 formItem / 控件 attrs、解析 form / label / disabled / placeholder。
+ *
+ * 处于 `w-form-multi-item-option` 内时：
+ * - `model` 优先为 Option.model（覆盖 props.model），供非区间控件绑定字段
+ * - `label` 优先为 Option.label（覆盖 props.label），供 placeholder / collectLabel
+ * 区间类组件请继续使用自身 props.model / keys，勿依赖 model 覆盖做拆字段。
+ */
+declare function useFormItemProps(props: PropsType, options?: UseFormItemPropsOptions): {
+    attrMap: ComputedRef<AttrMapType>;
+    slotMap: ComputedRef<SlotMapType>;
+    form: ComputedRef<any>;
+    /**
+     * 表单字段名。
+     * 在 MultiItemOption 内：Option.model；否则：props.model
+     */
+    model: ComputedRef<string>;
+    /**
+     * 展示 / 校验文案用 label（已 i18n）。
+     * 在 MultiItemOption 内：Option.label；否则：props.label
+     */
+    label: ComputedRef<string>;
+    disabled: ComputedRef<boolean>;
+    placeholder: ComputedRef<string>;
+};
+export default useFormItemProps;

package/dist/types/hooks/private/src/useKey.d.ts

@@ -0,0 +1 @@
+export default function useKey(defaultValue?: string): string;

package/dist/types/hooks/private/src/useRenderCell.d.ts

@@ -0,0 +1,71 @@
+import { type DictBasicNameType } from '../../business';
+import type { OptionType } from '../../../type';
+import { type FormatCellBooleanOptions, type FormatCellEnumMap, type FormatCellEnumOptionsExtension, type FormatCellI18nOptions, type FormatCellNumberOptions, type FormatCellOptions, type FormatCellPercentOptions, type FormatCellTemporalOptions } from '../../../utils/formatCellValue';
+type TemporalExtra = Pick<FormatCellTemporalOptions, 'format' | 'timeZone' | 'utc'>;
+type FieldPath = string | number | string[] | number[];
+/** 与 {@link FormatCellOptions} 对齐的按 `type` 区分的格式化 props */
+export type RenderCellFormatByType = {
+    type?: 'raw';
+} | ({
+    type: 'date';
+} & TemporalExtra) | ({
+    type: 'time';
+} & TemporalExtra) | ({
+    type: 'datetime';
+} & TemporalExtra) | ({
+    type: 'number';
+} & Pick<FormatCellNumberOptions, 'precision' | 'useGrouping'>) | ({
+    type: 'percent';
+} & Pick<FormatCellPercentOptions, 'valueScale'>) | ({
+    type: 'boolean';
+} & Pick<FormatCellBooleanOptions, 'trueText' | 'falseText'>) | ({
+    type: 'enum';
+} & FormatCellEnumOptionsExtension & {
+    name?: string;
+    map?: FormatCellEnumMap;
+}) | ({
+    type: 'i18n';
+} & Pick<FormatCellI18nOptions, 'values'>)
+/** 金额：等价于 `number` + 默认 `precision: 2` + 千分位；有 `precision` 时以传入为准 */
+ | ({
+    type: 'amount';
+} & Pick<FormatCellNumberOptions, 'precision'>);
+/** @deprecated 旧版平铺 props，由 {@link toFormatCellOptions} 自动映射 */
+export type RenderCellLegacyProps = {
+    enum?: OptionType[] | Record<string, string> | string;
+    options?: OptionType[];
+    enumFieldNames?: {
+        label?: string;
+        value?: string;
+    };
+    fieldNames?: {
+        label?: string;
+        value?: string;
+    };
+    dictName?: DictBasicNameType;
+    /** 需配合 `type: 'number'` 使用 */
+    precision?: number;
+};
+export type RenderCellFormatType = NonNullable<RenderCellFormatByType['type']>;
+export type RenderCellProps = {
+    field?: FieldPath;
+    /** 空值占位符，默认由 {@link formatCellValue} 处理为 `-` */
+    emptyPlaceholder?: string;
+} & RenderCellFormatByType & Partial<RenderCellLegacyProps>;
+export declare function resolveLegacyEnumMap(props: RenderCellProps, context: {
+    translate: (key: string) => string;
+    dictOptions?: OptionType[];
+    labelKey: string;
+    valueKey: string;
+}): FormatCellEnumMap | undefined;
+export declare function toFormatCellOptions(props: RenderCellProps, context?: {
+    enumMap?: FormatCellEnumMap;
+    translate?: (key: string) => string;
+    dictOptions?: OptionType[];
+    labelKey?: string;
+    valueKey?: string;
+}): FormatCellOptions;
+export default function useRenderCell(props: RenderCellProps): {
+    getRenderValue: (row?: Record<string, unknown>) => string | undefined;
+};
+export {};

package/dist/types/hooks/private/src/useTabsNav.d.ts

@@ -0,0 +1,13 @@
+import { type NavTabType } from '../../../store';
+export default function useTabsNav(): {
+    initTabs: () => void;
+    addTabs: (route?: NavTabType) => void;
+    openLoading: () => void;
+    closeLoading: () => void;
+    closeAll: (callback?: Fn) => void;
+    closeLeft: (view?: NavTabType, callback?: Fn) => void;
+    closeRight: (view?: NavTabType, callback?: Fn) => void;
+    closeOther: (view?: NavTabType, callback?: Fn) => void;
+    closeCurrent: (view?: NavTabType, callback?: Fn) => void;
+    refreshPage: (view?: NavTabType, callback?: Fn) => Promise<void>;
+};

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

@@ -0,0 +1,16 @@
+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, 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';
+export { default as useLocale } from './src/useLocale';
+export { default as useNProgress } from './src/useNProgress';
+export { default as useNavigate, type NavigatePushOptions } from './src/useNavigate';
+export { default as useWindowSize } from './src/useWindowSize';
+export { default as usePageBack, type PageBackHandler } from './src/usePageBack';
+export { default as useListPager } from './src/useListPager';
+/** @deprecated 请使用 useListPager */
+export { default as useListResult } from './src/useListPager';
+export { ListPagerKey } from './key';
+export type { ListPageParams, ListPagerOptions, ListPagerContext, SetListPageParams, GetListPageParams, ResolveFromSearch, ResolveFromSearchOptions, } from './type';

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

@@ -0,0 +1,4 @@
+import type { InjectionKey } from 'vue';
+import type { ListPagerContext } from './type';
+/** useListPager provide / w-list-search、w-table inject */
+export declare const ListPagerKey: InjectionKey<ListPagerContext>;

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

@@ -0,0 +1,19 @@
+type AffixOptions = {
+    /**
+     * 偏移量
+     * @default 0
+     */
+    offset?: number;
+    /**
+     * 滚动方向
+     * @default top
+     */
+    direction?: 'top' | 'bottom';
+    /**
+     * 滚动容器
+     * @default document.body
+     */
+    container?: () => HTMLElement;
+};
+export default function useAffix(target: () => HTMLElement, options?: AffixOptions): {};
+export {};

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

@@ -0,0 +1,6 @@
+type ErrorHandler = (event: Event) => void;
+export default function useCatchPreloadError(handler?: ErrorHandler): {
+    catchPreloadError: () => void;
+    removeCatchPreloadError: () => void;
+};
+export {};

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

@@ -0,0 +1,11 @@
+declare function getCookie(key: string): string;
+declare function setCookie(key: string, value: string, options?: any): import("xe-utils").XECookie;
+declare function removeCookie(key: string): number;
+declare function getCookieAll(): import("xe-utils").XECookie;
+export default function (): {
+    getCookie: typeof getCookie;
+    setCookie: typeof setCookie;
+    removeCookie: typeof removeCookie;
+    getCookieAll: typeof getCookieAll;
+};
+export {};

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

@@ -0,0 +1,86 @@
+import dayjs, { type ConfigType, type Dayjs, type ManipulateType, type OpUnitType, type QUnitType } from '../../../setup/dayjs';
+export type DateInput = ConfigType;
+export type DateRange = [Dayjs, Dayjs];
+type UseDateBaseOptions = {
+    /** 默认格式 */
+    format?: string;
+    /** 相对范围是否包含当前日，默认 true */
+    includeCurrent?: boolean;
+};
+export type UseDateOptions = (UseDateBaseOptions & {
+    /** 默认时区上下文（UTC）；作用于 toDayjs / format / 日历边界等；与 timeZone 互斥 */
+    utc?: true;
+    timeZone?: never;
+}) | (UseDateBaseOptions & {
+    /** 默认时区上下文（IANA）；作用于 toDayjs / format / 日历边界等；与 utc 互斥 */
+    timeZone?: string;
+    utc?: never;
+});
+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";
+/**
+ * 日期工具 hook
+ * - 近 N 天：默认不含今天（如近 7 天 = today-7 ~ today）；传 includeCurrent: true 则含今天共 N 天
+ * - 近 N 月 / 近 N 年：往前推 N 个单位，含当前日时再 +1 day（对齐表单预设语义）
+ * - options.utc / options.timeZone：默认时区上下文，作用于 toDayjs、format、parse、日历范围等
+ */
+export default function useDate(options?: UseDateOptions): {
+    dayjs: typeof dayjs;
+    DEFAULT_DATETIME_FORMAT: string;
+    DEFAULT_DATE_FORMAT: string;
+    toDayjs: (value?: DateInput) => Dayjs;
+    format: (value?: DateInput, pattern?: string) => string;
+    formatUtc: (value?: DateInput, pattern?: string) => string;
+    formatTz: (value?: DateInput, timeZone?: string | undefined, pattern?: string) => string;
+    parse: (value: DateInput, pattern?: string) => Dayjs;
+    startOf: (value?: DateInput, unit?: OpUnitType) => Dayjs;
+    endOf: (value?: DateInput, unit?: OpUnitType) => Dayjs;
+    toTimestamp: (value?: DateInput) => number;
+    fromTimestamp: (ms: number) => Dayjs;
+    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;
+        last1Month: () => DateRange;
+        last3Months: () => DateRange;
+        last6Months: () => DateRange;
+        last1Year: () => DateRange;
+        last2Years: () => DateRange;
+        last3Years: () => DateRange;
+        last5Years: () => DateRange;
+        last10Years: () => DateRange;
+    };
+    today: () => DateRange;
+    yesterday: () => DateRange;
+    thisWeek: () => DateRange;
+    lastWeek: () => DateRange;
+    thisMonth: () => DateRange;
+    lastMonth: () => DateRange;
+    thisYear: () => DateRange;
+    lastYear: () => DateRange;
+    add: (value: DateInput, n: number, unit: ManipulateType) => Dayjs;
+    subtract: (value: DateInput, n: number, unit: ManipulateType) => Dayjs;
+    diff: (a: DateInput, b: DateInput, unit?: QUnitType | OpUnitType, float?: boolean) => number;
+    isBefore: (a: DateInput, b: DateInput, unit?: OpUnitType) => boolean;
+    isAfter: (a: DateInput, b: DateInput, unit?: OpUnitType) => boolean;
+    isSame: (a: DateInput, b: DateInput, unit?: OpUnitType) => boolean;
+    isBetween: (value: DateInput, start: DateInput, end: DateInput, unit?: OpUnitType | null, inclusivity?: '()' | '[]' | '[)' | '(]') => boolean;
+    toTimestampRange: (range: DateRange) => [number, number];
+    toFormatRange: (range: DateRange, pattern?: string) => [string, string];
+    toFormatRangeUtc: (range: DateRange, pattern?: string) => [string, string];
+};
+export {};

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

@@ -0,0 +1,28 @@
+type CommonType = {
+    [key: string]: {
+        [key: string]: string;
+    };
+};
+type EnumType<T extends CommonType, K> = {
+    COMMON: T;
+    OPTION: K;
+};
+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, {
+        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];
+        label: string | T[T_1][K_1];
+    }[];
+    getEnumLable: <T_2 extends keyof T, K_2 extends keyof T[T_2]>(name: T_2, key: K_2) => string | K_2 | T[T_2][K_2];
+    getOption: (name: keyof K) => K[keyof K];
+};
+export {};

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

@@ -0,0 +1,4 @@
+export default function useExport(): {
+    exportXls: (url: string, parames?: any, fileName?: string) => Promise<void>;
+    downloadFile: (url: string, fileName?: string) => void;
+};

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

@@ -0,0 +1 @@
+export default function useForm(): void;

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

@@ -0,0 +1,26 @@
+type I18nGlobalTranslation = {
+    (key: string): string;
+    (key: string, locale: string): string;
+    (key: string, locale: string, list: unknown[]): string;
+    (key: string, locale: string, named: Record<string, unknown>): string;
+    (key: string, list: unknown[]): string;
+    (key: string, named: Record<string, unknown>): string;
+};
+type PlaceholderType = 'com_msg_062' | 'com_msg_063';
+type PlaceholderFnType = (key: PlaceholderType, title: string) => string;
+/**
+ *  国际化翻译hooks
+ * @param namespace 默认值 'lang'
+ * @return {*}  {{
+ *   t: I18nGlobalTranslation
+ *   p: PlaceholderFnType
+ * }}
+ */
+export declare const useI18n: (namespace?: string) => {
+    t: I18nGlobalTranslation;
+    p: PlaceholderFnType;
+    pleaseEnter: (title: string) => string;
+    pleaseSelect: (title: string) => string;
+};
+export declare const t: (key: string) => string;
+export {};

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

@@ -0,0 +1,37 @@
+import type { ListResult } from '../../../type';
+import type { GetListPageParams, ListPagerOptions, ResolveFromSearch, SetListPageParams } from '../type';
+/**
+ * 列表分页上下文：结果容器 + 乐观分页 + 搜索回第 1 页，并向子树 provide。
+ *
+ * ## 两套分页状态
+ * - `pageParams`：翻页 / 搜索立刻更新，`getPageParams()` 发请求用；pager UI 可先变
+ * - `listResult.current/size`：仅 `setListResult` 时与 `records` 一起更新（序号跟数据）
+ *
+ * ## 认主（避免嵌套 history 表误用父级 inject）
+ * - `w-list-search`：`form === ctx.query`
+ * - `w-table`：`listResult === ctx.listResult`
+ *
+ * @example
+ * ```ts
+ * const query = reactive({ status: undefined })
+ * const { listResult, setListResult, getPageParams } = useListPager({ query })
+ *
+ * async function fetchList() {
+ *   const { current, size } = getPageParams()
+ *   setListResult(await api({ ...query, current, size }))
+ * }
+ * ```
+ */
+export default function useListPager<T = unknown>(_options?: ListPagerOptions): {
+    listResult: Readonly<{
+        records: import("@vue/reactivity").UnwrapRefSimple<T>[];
+        total: number;
+        current: number;
+        size: number;
+        pages: number;
+    }>;
+    setListResult: (result?: ListResult<T>) => void;
+    getPageParams: GetListPageParams;
+    setPageParams: SetListPageParams;
+    resolveFromSearch: ResolveFromSearch;
+};

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

@@ -0,0 +1,6 @@
+export default function (): {
+    getLanguage: () => string;
+    setLanguage: (value: string) => void;
+    removeLanguage: () => void;
+    isChinese: boolean;
+};

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

@@ -0,0 +1,5 @@
+import 'nprogress/nprogress.css';
+export default function useNProgress(): {
+    start: () => void;
+    done: () => void;
+};

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

@@ -0,0 +1,11 @@
+export type NavigatePushOptions = {
+    /** 是否写入 sessionStorage（同标签刷新可恢复）；默认 false，仅内存 */
+    session?: boolean;
+};
+export default function useNavigate<T = unknown>(): {
+    push: (target: string, data?: T, options?: NavigatePushOptions) => Promise<void | import("vue-router").NavigationFailure | undefined> | undefined;
+    state: import("vue").ComputedRef<T | undefined>;
+    takeState: <D = T>() => D | undefined;
+    route: import("vue-router").RouteLocationNormalizedLoadedGeneric;
+    router: import("vue-router").Router;
+};

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

@@ -0,0 +1,19 @@
+export type PageBackHandler = (reload?: boolean) => void;
+/**
+ * 列表父页传入 handler 即 provide；子页 / w-page 不传参，一步拿到 pageBack。
+ *
+ * @example
+ * ```ts
+ * // 父页
+ * usePageBack(toList)
+ * // 或
+ * const { pageBack } = usePageBack(toList)
+ *
+ * // 子页 / w-page
+ * const { pageBack } = usePageBack()
+ * pageBack(true)
+ * ```
+ */
+export default function usePageBack(handler?: PageBackHandler): {
+    pageBack: PageBackHandler;
+};

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

@@ -0,0 +1,8 @@
+import type { UseWindowSizeType } from '../../../type';
+export default function (scale?: UseWindowSizeType['NumType'], compared?: UseWindowSizeType['NumType'], comparedType?: UseWindowSizeType['ComparedType']): {
+    removeListener: () => void;
+    fullWidth: import("vue").Ref<number, number>;
+    fullHeight: import("vue").Ref<number, number>;
+    width: import("vue").Ref<number, number>;
+    height: import("vue").Ref<number, number>;
+};

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

@@ -0,0 +1,70 @@
+/**
+ * 列表分页参数（请求侧 / 乐观态）
+ */
+export type ListPageParams = {
+    current: number;
+    size: number;
+};
+/**
+ * useListPager 入参
+ *
+ * @example
+ * ```ts
+ * const query = reactive({ ... })
+ * const { listResult, setListResult, getPageParams } = useListPager({ query })
+ * // <w-list-search v-model:form="query" />
+ * // <w-table :list-result="listResult" />
+ * ```
+ */
+export interface ListPagerOptions {
+    /** 初始页码，默认 1 */
+    current?: number;
+    /** 初始每页条数，默认 10 */
+    size?: number;
+    /**
+     * 与 w-list-search 的 v-model:form 同一 reactive，用于认主。
+     * search 仅当 `form === query` 时才会调用 resolveFromSearch。
+     */
+    query?: object;
+    /**
+     * 搜索条件序列化（用于快照对比是否变化）。
+     * 默认：去掉 current/size/pages，跳过 undefined，Date 等走 valueOf。
+     */
+    serializeQuery?: (query: unknown) => string;
+}
+/** 写入乐观分页（不更新 listResult.current/size） */
+export type SetListPageParams = (params: Partial<ListPageParams>) => void;
+/** 读取当前请求用分页（翻页/搜索后、接口返回前即可用） */
+export type GetListPageParams = () => ListPageParams;
+export type ResolveFromSearchOptions = {
+    /** true：无论条件是否相对上次成功请求变化，都把 current 置为 1 */
+    force?: boolean;
+};
+/**
+ * 搜索前裁决页码：条件变化或 force 时 current=1，size 不变。
+ * 只改 pageParams，等 setListResult 后再写 listResult.current。
+ */
+export type ResolveFromSearch = (form?: unknown, options?: ResolveFromSearchOptions) => void;
+/**
+ * provide/inject 上下文（w-list-search / w-table 认主后消费）
+ *
+ * - listResult：与业务 `:list-result` 同一引用；current/size 表示「已展示数据」的页
+ * - pageParams：乐观分页，翻页/搜索立刻更新，供 getPageParams 与 pager UI
+ */
+export type ListPagerContext = {
+    /** 认主用：与 w-list-search v-model:form 同一对象 */
+    query?: object;
+    /**
+     * 与 hook 返回值 / `:list-result` 同一引用。
+     * table 用 `props.listResult === ctx.listResult` 判断是否接管。
+     * current/size 仅在 setListResult 时与 records 一并更新。
+     */
+    listResult: object;
+    /**
+     * 请求用乐观分页（翻页、resolveFromSearch 立刻改）。
+     * table 绑定后 pager UI 跟随此对象；序号仍跟 listResult。
+     */
+    pageParams: ListPageParams;
+    setPageParams: SetListPageParams;
+    resolveFromSearch: ResolveFromSearch;
+};