wlwy-package 3.2.2 → 4.0.0-beta.1

package/dist/types/packages/components/table/constants.d.ts

@@ -1,6 +1,6 @@
-/** toolbar 专属 prop（旧平铺方式已弃用，请改用 toolbar.xxx） */
-export declare const TOOLBAR_ONLY_KEYS: readonly ["toolid", "import", "export", "print", "refresh", "custom", "resizable", "zoom"];
-/** pager 专属 prop（旧平铺方式已弃用，请改用 pager.xxx） */
+/** toolbar 专属 prop（仅通过 toolbar.xxx 配置） */
+export declare const TOOLBAR_ONLY_KEYS: readonly ["toolid", "import", "export", "print", "refresh", "custom", "resizable", "zoom", "collapseButtons", "showSelectionSummary"];
+/** pager 专属 prop（仅通过 pager.xxx 配置） */
 export declare const PAGER_ONLY_KEYS: readonly ["currentPage", "pageSize", "pageSizes", "layouts", "total", "pagerCount", "background", "autoHidden", "transfer", "pageSizePlacement", "iconPrevPage", "iconJumpPrev", "iconJumpNext", "iconNextPage", "iconJumpMore", "iconHomePage", "iconEndPage"];
 /** 多子组件共享，平铺在 WTable 顶层 */
 export declare const SHARED_PROP_KEYS: readonly ["loading", "size", "perfect", "border", "align"];
@@ -10,6 +10,4 @@ export declare const TABLE_SHARED_KEYS: readonly ["loading", "border", "align"];
 export declare const WTABLE_OWN_KEYS: readonly ["data", "showPager", "showCheckbox", "showSeq", "showToolbar", "toolbar", "pager"];
 /** vxe-table 企业版参数，开源版传入会触发控制台警告 */
 export declare const VXE_TABLE_PRO_ONLY_KEYS: readonly ["areaConfig", "clipConfig", "fnrConfig"];
-/** 旧 slot 名 → 新 slot 名 */
-export declare const SLOT_ALIASES: readonly [readonly ["buttons", "toolbar-buttons"], readonly ["tools", "toolbar-tools"], readonly ["left", "pager-left"], readonly ["right", "pager-right"]];
 export declare const RESERVED_SLOT_NAMES: Set<string>;

package/dist/types/packages/components/table/index.d.ts

@@ -1,4 +1,4 @@
-export type { WTableInstance, WTableProps, WTableDeprecatedProps, WTableSlots, WToolbarProps, WToolbarOnlyProps, WPagerProps, WPagerOnlyProps, WPagerInstance, ResetPagerParams, PagerState, WColumnProp, WListSearchProps, WListSearchInstance } from './type';
+export type { WTableInstance, WTableProps, WTableSlots, WToolbarProps, WToolbarOnlyProps, WPagerProps, WPagerOnlyProps, WPagerInstance, ResetPagerParams, PagerState, WColumnProp, WListSearchProps, WListSearchInstance } from './type';
 export { default as WTable } from './src/table.vue';
 export { default as WPager } from './src/pager.vue';
 export { default as WColumn } from './src/column.vue';

package/dist/types/packages/components/table/resolveToolbarButtons.d.ts

@@ -0,0 +1,16 @@
+import { type VNode, type VNodeChild } from 'vue';
+export type ToolbarButtonsRender = {
+    mode: 'passthrough';
+} | {
+    mode: 'collapse';
+    visible: VNode[];
+    more: VNode[];
+    others: VNode[];
+};
+export declare function flattenVNodes(nodes: VNodeChild): VNode[];
+export declare function isWButtonNode(node: VNode): boolean;
+export declare function resolveToolbarButtons(nodes: VNode[], collapseEnabled: boolean): ToolbarButtonsRender;
+export declare function getWButtonLabel(node: VNode, t: (key: string) => string): string;
+/** 与 WButton 一致：优先 props.icon，否则按 authCode 取权限图标 */
+export declare function getWButtonIcon(node: VNode): string | undefined;
+export declare function triggerVNodeClick(node: VNode): boolean;

package/dist/types/packages/components/table/src/search.vue.d.ts

@@ -1,16 +1,22 @@
 import type { WListSearchProps } from '../type';
+type __VLS_Props = WListSearchProps;
 declare function handleSearch(): void;
-declare function handleReset(): void;
+declare function handleReset(): Promise<void>;
 declare function toggleExpanded(): void;
-declare const _default: __VLS_WithSlots<import("vue").DefineComponent<WListSearchProps, {
+type __VLS_PublicProps = __VLS_Props & {
+    'form'?: any;
+};
+declare const _default: __VLS_WithSlots<import("vue").DefineComponent<__VLS_PublicProps, {
     getFormInstance: () => import("ant-design-vue").FormInstance | undefined;
     reset: () => void;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     reset: () => any;
     search: () => any;
-}, string, import("vue").PublicProps, Readonly<WListSearchProps> & Readonly<{
+    "update:form": (value: any) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     onReset?: (() => any) | undefined;
     onSearch?: (() => any) | undefined;
+    "onUpdate:form"?: ((value: any) => any) | undefined;
 }>, {
     loading: boolean;
     bordered: boolean;

package/dist/types/packages/components/table/src/table.vue.d.ts

@@ -5,34 +5,22 @@ import type { WPagerInstance, WTableProps } from '../type';
 type __VLS_Props = WTableProps;
 declare var __VLS_7: {
     [x: string]: any;
-}, __VLS_9: {
+}, __VLS_12: {
     [x: string]: any;
-}, __VLS_15: {
-    [x: string]: any;
-}, __VLS_17: {
-    [x: string]: any;
-}, __VLS_39: string, __VLS_40: any, __VLS_51: any, __VLS_53: any, __VLS_55: any, __VLS_57: any;
+}, __VLS_34: string, __VLS_35: any, __VLS_46: any, __VLS_48: any;
 type __VLS_Slots = {} & {
-    [K in NonNullable<typeof __VLS_39>]?: (props: typeof __VLS_40) => any;
+    [K in NonNullable<typeof __VLS_34>]?: (props: typeof __VLS_35) => any;
 } & {
     'toolbar-tools'?: (props: typeof __VLS_7) => any;
 } & {
-    tools?: (props: typeof __VLS_9) => any;
-} & {
-    'toolbar-buttons'?: (props: typeof __VLS_15) => any;
-} & {
-    buttons?: (props: typeof __VLS_17) => any;
-} & {
-    'pager-left'?: (props: typeof __VLS_51) => any;
-} & {
-    left?: (props: typeof __VLS_53) => any;
+    'toolbar-buttons'?: (props: typeof __VLS_12) => any;
 } & {
-    'pager-right'?: (props: typeof __VLS_55) => any;
+    'pager-left'?: (props: typeof __VLS_46) => any;
 } & {
-    right?: (props: typeof __VLS_57) => any;
+    'pager-right'?: (props: typeof __VLS_48) => any;
 };
 declare const _default: __VLS_WithSlots<import("vue").DefineComponent<__VLS_Props, {
-    getTableInstance: () => VxeTableInstance | undefined;
+    getTableInstance: () => VxeTableInstance<any> | undefined;
     getToolbarInstance: () => VxeToolbarInstance | undefined;
     getPagerInstance: () => WPagerInstance | undefined;
     getPagerState: () => import("../type").PagerState;
@@ -140,7 +128,7 @@ declare const _default: __VLS_WithSlots<import("vue").DefineComponent<__VLS_Prop
     }>;
     $root: import("vue").ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, import("vue").ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}, {}, {}, string, import("vue").ComponentProvideOptions>, {}, {}, "", {}, any> | null;
     $parent: import("vue").ComponentPublicInstance<{}, {}, {}, {}, {}, {}, {}, {}, false, import("vue").ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}, {}, {}, string, import("vue").ComponentProvideOptions>, {}, {}, "", {}, any> | null;
-    /** @type {[typeof WPager, typeof WPager, ]} */ $host: Element | null;
+    $host: Element | null;
     $emit: (event: string, ...args: any[]) => void;
     $el: any;
     $options: import("vue").ComponentOptionsBase<any, any, any, any, any, any, any, any, any, {}, {}, string, {}, {}, {}, string, import("vue").ComponentProvideOptions> & {

package/dist/types/packages/components/{common/src/editTitle.vue.d.ts → table/src/toolbarButtons.vue.d.ts}

@@ -1,15 +1,15 @@
 type __VLS_Props = {
-    title: string;
-    index?: string | number;
-    required?: boolean;
+    collapseButtons?: boolean;
 };
-declare var __VLS_6: {}, __VLS_8: {};
+declare var __VLS_6: {}, __VLS_44: {};
 type __VLS_Slots = {} & {
-    title?: (props: typeof __VLS_6) => any;
+    prefix?: (props: typeof __VLS_6) => any;
 } & {
-    right?: (props: typeof __VLS_8) => any;
+    default?: (props: typeof __VLS_44) => any;
 };
-declare const _default: __VLS_WithSlots<import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, __VLS_Slots>;
+declare const _default: __VLS_WithSlots<import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    collapseButtons: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, __VLS_Slots>;
 export default _default;
 type __VLS_WithSlots<T, S> = T & {
     new (): {

package/dist/types/packages/components/table/type.d.ts

@@ -7,8 +7,17 @@ import type { Slot } from 'vue';
  */
 export interface WToolbarProps extends Omit<VxeToolbarProps, 'id'> {
     toolid?: string;
-    /** @deprecated 请改用 WTable 顶层的 `showToolbar` */
-    hideToolbar?: boolean;
+    /**
+     * `#toolbar-buttons` 中 `w-button` 超过 4 个时折叠进「更多」
+     * @default true
+     */
+    collapseButtons?: boolean;
+    /**
+     * 是否在工具栏展示「已选择 x 项 / 共 y 项」
+     * 仅在 `showCheckbox` 为 true 时生效
+     * @default true
+     */
+    showSelectionSummary?: boolean;
 }
 /** 多子组件共享，平铺在 WTable 顶层 */
 export type WTableSharedPropKeys = 'loading' | 'size' | 'perfect' | 'border' | 'align';
@@ -26,20 +35,13 @@ export interface WTableProps<Row = any> extends WTableOnlyProps<Row>, Partial<Pi
     /** 是否显示序号列 @default true */
     showSeq?: boolean;
     /**
-     * 是否显示工具栏，优先级高于 `toolbar.hideToolbar`。
-     * 若存在 `#toolbar-buttons` / `#toolbar-tools`（或旧 `#buttons` / `#tools`），则以 slot 为准强制显示。
+     * 是否显示工具栏。
+     * 若存在 `#toolbar-buttons` / `#toolbar-tools`，则以 slot 为准强制显示。
      */
     showToolbar?: boolean;
     toolbar?: Partial<WToolbarOnlyProps>;
     pager?: Partial<WPagerOnlyProps>;
 }
-/**
- * w-table 弃用平铺属性（仍可通过 attrs 传入，请迁移至 toolbar / pager 嵌套对象）
- */
-export interface WTableDeprecatedProps extends Partial<WToolbarOnlyProps>, Partial<Omit<WPagerOnlyProps, keyof WToolbarOnlyProps>> {
-    /** @deprecated 请改用 `data` */
-    dataSource?: unknown[];
-}
 /**
  * w-table 插槽
  */
@@ -70,13 +72,97 @@ export type PagerState = {
     pageSize: number;
 };
 /**
- * w-table组件示例
+ * w-table 组件实例
+ *
+ * 说明：vxe-table 的 `VxeTableInstance<D>` 未把 `D` 透传到 `TableMethods`，
+ * 因此需在此显式覆盖常用返回行数据的方法，使 `Row` 生效。
  */
-export interface WTableInstance extends VxeTableInstance {
+export interface WTableInstance<Row = any> extends VxeTableInstance<Row> {
+    /**
+     * 获取数据，和 data 的行为一致；也可指定索引获取单行
+     */
+    getData: {
+        (): Row[];
+        (rowIndex: number): Row;
+    };
+    /**
+     * 获取当前表格数据
+     * - fullData：完整全量表体数据
+     * - visibleData：处理条件后的全量表体数据
+     * - tableData：当前渲染中的表体数据
+     * - footerData：当前渲染中的表尾数据
+     */
+    getTableData: () => {
+        fullData: Row[];
+        visibleData: Row[];
+        tableData: Row[];
+        footerData: Row[][];
+    };
+    /**
+     * 获取表格全量数据；开启 tree-config 时返回带层级的树结构
+     */
+    getFullData: () => Row[];
+    /**
+     * 根据行唯一主键获取行
+     * @param rowid 行主键
+     */
+    getRowById: (rowid: string | number | null) => Row | null;
+    /**
+     * 用于 type=checkbox，获取已选中的行数据
+     * @param isFull 为 true 时包含被筛选掉的已选数据
+     */
+    getCheckboxRecords: (isFull?: boolean) => Row[];
+    /**
+     * 用于 checkbox-config.reserve，获取已保留选中的行数据（不含当前页已选）
+     * @param isFull 为 true 时包含被筛选掉的保留选中数据
+     */
+    getCheckboxReserveRecords: (isFull?: boolean) => Row[];
+    /**
+     * 用于 type=checkbox，获取半选状态的行数据
+     * @param isFull 为 true 时获取完整半选数据
+     */
+    getCheckboxIndeterminateRecords: (isFull?: boolean) => Row[];
+    /**
+     * 用于 type=radio，获取当前已选中的行数据
+     * @param isFull 为 true 时获取完整选中数据
+     */
+    getRadioRecord: (isFull?: boolean) => Row | null;
+    /**
+     * 用于 radio-config.reserve，获取已保留选中的行数据
+     * @param isFull 为 true 时获取完整保留选中数据
+     */
+    getRadioReserveRecord: (isFull?: boolean) => Row[];
+    /**
+     * 用于 row-config.isCurrent，获取当前高亮行数据
+     */
+    getCurrentRecord: () => Row | null;
+    /**
+     * 获取待删除（pending）状态的行数据
+     */
+    getPendingRecords: () => Row[];
+    /**
+     * 用于 expand-config，获取已展开的行数据
+     */
+    getRowExpandRecords: () => Row[];
+    /**
+     * 用于 tree-config，获取已展开的树节点
+     * 注意：即使父节点被收起，只要该节点仍处于展开状态也能获取到
+     */
+    getTreeExpandRecords: () => Row[];
+    /**
+     * 只对 tree-config 有效，获取指定行的子级
+     * @param rowOrRowid 行对象或行主键
+     */
+    getTreeRowChildren: (rowOrRowid: any) => Row[];
+    /**
+     * 只对 tree-config 有效，获取指定行的父级
+     * @param rowOrRowid 行对象或行主键
+     */
+    getTreeParentRow: (rowOrRowid: any) => Row | null;
     /**
-     * 获取表格实例
+     * 获取内部 VxeTable 实例
      */
-    getTableInstance: () => VxeTableInstance | undefined;
+    getTableInstance: () => VxeTableInstance<Row> | undefined;
     /**
      * 获取表格工具栏实例
      */

package/dist/types/packages/components/table/useWTableConfig.d.ts

@@ -2,7 +2,6 @@ import { type ComputedRef, type Slots } from 'vue';
 import type { WPagerOnlyProps, WTableProps, WToolbarOnlyProps } from './type';
 export type WTableResolvedConfig = {
     toolbar: Partial<WToolbarOnlyProps> & {
-        hideToolbar?: boolean;
         toolid?: string;
     };
     pager: Partial<WPagerOnlyProps>;

package/dist/types/packages/components/table/warnDeprecated.d.ts

@@ -1,6 +1,4 @@
-export declare function warnDeprecated(oldKey: string, newPath: string): void;
-export declare function warnDeprecatedSlot(oldName: string, newName: string): void;
-export declare function warnPropConflict(key: string, namespace: 'toolbar' | 'pager'): void;
-export declare function warnShowToolbarConflict(): void;
 /** toolbar slot 与显式关闭工具栏冲突时，以 slot 为准 */
-export declare function warnToolbarSlotConflict(source: 'showToolbar' | 'toolbar.hideToolbar'): void;
+export declare function warnToolbarSlotConflict(): void;
+/** 默认单元格渲染依赖 field 取值，缺失时仅开发环境报错，不阻塞运行 */
+export declare function warnMissingFieldForDefaultCell(title?: string): void;

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

@@ -14,7 +14,7 @@ export type RenderCellFormatByType = {
     type: 'datetime';
 } & TemporalExtra) | ({
     type: 'number';
-} & Pick<FormatCellNumberOptions, 'precision'>) | ({
+} & Pick<FormatCellNumberOptions, 'precision' | 'useGrouping'>) | ({
     type: 'percent';
 } & Pick<FormatCellPercentOptions, 'valueScale'>) | ({
     type: 'boolean';
@@ -26,10 +26,10 @@ export type RenderCellFormatByType = {
 }) | ({
     type: 'i18n';
 } & Pick<FormatCellI18nOptions, 'values'>)
-/** @deprecated 请改用 `type: 'number'` 且 `precision: 2` */
- | {
+/** 金额：等价于 `number` + 默认 `precision: 2` + 千分位；有 `precision` 时以传入为准 */
+ | ({
     type: 'amount';
-};
+} & Pick<FormatCellNumberOptions, 'precision'>);
 /** @deprecated 旧版平铺 props，由 {@link toFormatCellOptions} 自动映射 */
 export type RenderCellLegacyProps = {
     /** @deprecated 请改用 `format` */
@@ -51,6 +51,8 @@ export type RenderCellLegacyProps = {
 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;

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

@@ -1,17 +1,14 @@
 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 useEnum } from './src/useEnum';
 export { default as useExport } from './src/useExport';
 export * from './src/useI18n';
 export { default as useFormItemProps } from './src/useFormItemProps';
 export { default as useFormStorage } from './src/useFormStorage';
-export { default as useListConfig } from './src/useListConfig';
 export { default as useLocale } from './src/useLocale';
 export { default as useNProgress } from './src/useNProgress';
-export { default as usePageForm } from './src/usePageForm';
-export { default as usePrefixTitle } from './src/usePrefixTitle';
 export { default as useTabsNav } from './src/useTabsNav';
-export { default as useUpload } from './src/useUpload';
 export { default as useWatchForm, type UseWatchFormType } from './src/useWatchForm';
 export { default as useWindowSize } from './src/useWindowSize';
 export { default as useEmitBack } from './src/useEmitBack';

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

@@ -0,0 +1,65 @@
+import dayjs, { type ConfigType, type Dayjs, type ManipulateType, type OpUnitType, type QUnitType } from 'dayjs';
+export type DateInput = ConfigType;
+export type DateRange = [Dayjs, Dayjs];
+export type UseDateOptions = {
+    /** 默认格式 */
+    format?: string;
+    /** 相对范围是否包含当前日，默认 true */
+    includeCurrent?: boolean;
+};
+export type RecentRangeOptions = {
+    includeCurrent?: boolean;
+    base?: DateInput;
+};
+export declare const DEFAULT_DATETIME_FORMAT = "YYYY-MM-DD HH:mm:ss";
+export declare const DEFAULT_DATE_FORMAT = "YYYY-MM-DD";
+/**
+ * 日期工具 hook
+ * - 近 N 天：默认包含今天，共 N 天（如近 7 天 = today-(7-1) ~ today）
+ * - 近 N 月 / 近 N 年：往前推 N 个单位，含当前日时再 +1 day（对齐表单预设语义）
+ */
+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;
+    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: number, unit?: ManipulateType, opts?: RecentRangeOptions) => DateRange;
+    recentDays: (n: number, opts?: RecentRangeOptions) => DateRange;
+    recentMonths: (n: number, opts?: RecentRangeOptions) => DateRange;
+    recentYears: (n: number, 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];
+};

package/dist/types/packages/keys/index.d.ts

@@ -4,3 +4,6 @@ import type { WIconProp } from '../components/icon/type';
 export declare const WHeaderForm: InjectionKey<ModelRef<Partial<FormProps>>>;
 /** w-column type="action" 内 w-icon 的默认 size */
 export declare const WIconSizeKey: InjectionKey<NonNullable<WIconProp['size']>>;
+/** WListSearch 重置时回调注册（如 DateRange 回写 defaultValue；可异步） */
+export type WListSearchRegisterReset = (fn: () => void | Promise<void>) => () => void;
+export declare const WListSearchRegisterResetKey: InjectionKey<WListSearchRegisterReset>;

package/dist/types/packages/utils/formatCellValue.d.ts

@@ -20,6 +20,8 @@ export interface FormatCellNumberOptions {
     type: 'number';
     /** 小数位数：0 为整数，1 为一位小数，以此类推 */
     precision?: number;
+    /** 是否使用千分位分组；未传则跟随 `Intl.NumberFormat` 默认（通常为 true） */
+    useGrouping?: boolean;
 }
 export interface FormatCellPercentOptions {
     type: 'percent';
@@ -78,5 +80,7 @@ export declare function formatCellValueCore(value: unknown, options: FormatCellO
 /**
  * 表格/描述列表等场景的单元格格式化：按 `options.type` 输出字符串；
  * 无法识别为日期/数字等时 **原样字符串化**，不使用 `Invalid Date`。
+ *
+ * @param emptyPlaceholder 空值占位符，默认 `-`；日期/时间类型额外将 `0` / `'0'` 视为空
  */
-export declare function formatCellValue(value: unknown, options: FormatCellOptions): string;
+export declare function formatCellValue(value: unknown, options: FormatCellOptions, emptyPlaceholder?: string): string;

package/dist/types/packages/utils/index.d.ts

@@ -1,5 +1,6 @@
 import type { PickMultipleResult, TargetsType } from './type';
-export type { PickMultipleFn } from './type';
+export type { PickMultipleFn, MaybePromise, DefaultValueType } from './type';
+export { resolveDefaultValue, isEmptyFormValue } from './resolveDefaultValue';
 export { createRefInstanceProxy, type CreateRefInstanceProxyOptions } from './createRefInstanceProxy';
 export { getTitle } from './getPrefixTitle';
 export { formatCellValue, formatCellValueCore, normalizeEnumMap, preserveRawCellValue, type FormatCellOptions, type FormatCellEnumMap, type FormatCellEnumEntry, type FormatCellEnumOptionsExtension, type FormatCellTemporalOptions, type FormatCellDateOnlyOptions, type FormatCellTimeOnlyOptions, type FormatCellDateTimeOptions, type FormatCellRawOptions, type FormatCellNumberOptions, type FormatCellPercentOptions, type FormatCellBooleanOptions, type FormatCellEnumOptions, type FormatCellI18nOptions } from './formatCellValue';

package/dist/types/packages/utils/resolveDefaultValue.d.ts

@@ -0,0 +1,7 @@
+import type { DefaultValueType } from './type';
+/**
+ * 解析 defaultValue：支持静态值、Promise、同步/异步函数
+ */
+export declare function resolveDefaultValue<T>(value: DefaultValueType<T> | undefined): Promise<T | undefined>;
+/** 表单字段是否视为空（用于判断是否写入 defaultValue） */
+export declare function isEmptyFormValue(val: unknown): boolean;

package/dist/types/packages/utils/type.d.ts

@@ -4,3 +4,10 @@ export type PickMultipleResult<T extends object, K extends string> = {
     [key in ResultKeysType<K>]: Partial<T>;
 };
 export type PickMultipleFn = <T extends object, K extends string>(obj: T, targets: TargetsType<T, K>) => PickMultipleResult<T, K>;
+/** T 或 Promise<T> */
+export type MaybePromise<T> = T | Promise<T>;
+/**
+ * 表单字段默认值：静态值 | Promise | 同步/异步工厂函数
+ * 解析后的结果类型为 T
+ */
+export type DefaultValueType<T> = MaybePromise<T> | (() => MaybePromise<T>);