@dazhicheng/ui 1.6.0 → 1.6.2

package/dist/components/tt-table/src/props.d.ts

@@ -71,10 +71,16 @@ export declare const tableProps: {
         type: PropType<TtTableProps["beforeFetch"]>;
         default: null;
     };
-    /** data */
+    /**
+     * data
+     *
+     * `default` 显式标注返回类型：不标注时 `[]` 会被推断为 `never[]`，
+     * Vue 的 `ExtractPropTypes` 让 default 的返回类型参与推导，把 `PropType` 声明的类型收窄成
+     * `never[]`，业务传具体行类型的数组会直接报 TS2322。
+     */
     data: {
         type: PropType<TtTableProps["data"]>;
-        default: () => never[];
+        default: () => TtTableProps["data"];
     };
     /** 是否滚动加载数据 */
     isScrollFetch: {
@@ -414,9 +420,9 @@ export declare const tableFormProps: {
             headerTooltipConfig?: VxeTablePropTypes.HeaderTooltipConfig<any> | undefined;
             tooltipConfig?: VxeTablePropTypes.TooltipConfig<any> | undefined;
             footerTooltipConfig?: VxeTablePropTypes.FooterTooltipConfig<any> | undefined;
-            exportConfig?: VxeTablePropTypes.ExportConfig | undefined;
-            importConfig?: VxeTablePropTypes.ImportConfig | undefined;
-            printConfig?: VxeTablePropTypes.PrintConfig | undefined;
+            exportConfig?: VxeTablePropTypes.ExportConfig<any> | undefined;
+            importConfig?: VxeTablePropTypes.ImportConfig<any> | undefined;
+            printConfig?: VxeTablePropTypes.PrintConfig<any> | undefined;
             expandConfig?: VxeTablePropTypes.ExpandConfig<any> | undefined;
             treeConfig?: VxeTablePropTypes.TreeConfig<any> | undefined;
             mouseConfig?: VxeTablePropTypes.MouseConfig | undefined;
@@ -543,7 +549,7 @@ export declare const tableOtherProps: {
     /** 列配置 */
     columns: {
         type: PropType<TtTableProps["columns"]>;
-        default: () => never[];
+        default: () => TtTableProps["columns"];
     };
     /**
      * 表格的高度；支持铺满父容器或者固定高度，如果设置 auto 为铺满父容器（如果设置为 auto，则必须确保存在父节点且不允许存在相邻元素）

package/dist/components/tt-table/src/props.js

@@ -3,6 +3,7 @@ import "axios";
 import "element-plus";
 import "dayjs";
 import "vue";
+import "numeral";
 import "xe-utils";
 import "dayjs/plugin/utc";
 import "dayjs/plugin/timezone";
@@ -102,7 +103,13 @@ const r = {
     type: Function,
     default: null
   },
-  /** data */
+  /**
+   * data
+   *
+   * `default` 显式标注返回类型：不标注时 `[]` 会被推断为 `never[]`，
+   * Vue 的 `ExtractPropTypes` 让 default 的返回类型参与推导，把 `PropType` 声明的类型收窄成
+   * `never[]`，业务传具体行类型的数组会直接报 TS2322。
+   */
   data: {
     type: Array,
     default: () => []
@@ -135,7 +142,7 @@ const r = {
   },
   /** 是否显示表格上方 alert */
   showTableAlert: { type: Boolean, default: () => e("showTableAlert") }
-}, T = {
+}, j = {
   /**
    * 是否自适应高度
    *
@@ -224,7 +231,7 @@ const r = {
     type: Object,
     default: () => e("radioConfig")
   }
-}, j = {
+}, I = {
   /**
    * table参数
    *
@@ -277,7 +284,7 @@ const r = {
   tableFormApi: {
     type: Object
   }
-}, I = {
+}, A = {
   /** 列配置 */
   columns: {
     type: Array,
@@ -337,7 +344,7 @@ const r = {
   ...d
 };
 export {
-  j as tableFormProps,
-  I as tableOtherProps,
-  T as tableProps
+  I as tableFormProps,
+  A as tableOtherProps,
+  j as tableProps
 };

package/dist/components/tt-table/src/table-mutation-events.js

@@ -2,8 +2,9 @@ import "axios";
 import "element-plus";
 import { isString as s, isArray as c } from "../../../packages/utils/src/is.js";
 import "vue";
-import u from "xe-utils";
 import "dayjs";
+import "numeral";
+import u from "xe-utils";
 import "dayjs/plugin/utc";
 import "dayjs/plugin/timezone";
 import "../../../node_modules/.pnpm/decimal.js@10.6.0/node_modules/decimal.js/decimal.js";
@@ -39,7 +40,7 @@ const p = /* @__PURE__ */ new Set([
   "filter-change",
   "clear-filter",
   "clear-all-filter"
-]), m = /* @__PURE__ */ new Set(["insert", "insert_edit", "insert_actived", "remove"]), w = /* @__PURE__ */ new Set(["undo", "redo"]), _ = d.map((t) => [t, u.camelCase(t)]);
+]), m = /* @__PURE__ */ new Set(["insert", "insert_edit", "insert_actived", "remove"]), w = /* @__PURE__ */ new Set(["undo", "redo"]), $ = d.map((t) => [t, u.camelCase(t)]);
 function b(t) {
   var r, o;
   const e = t[0];
@@ -53,18 +54,18 @@ function g(t, e) {
   const a = e();
   return (c(a) ? !a.length : !a) ? !1 : !((l = (n = (i = r == null ? void 0 : r.$grid) == null ? void 0 : i.getCheckboxRecords) == null ? void 0 : n.call(i)) != null && l.length);
 }
-function $(t, e, r) {
+function B(t, e, r) {
   return p.has(t) ? !0 : t === "edit-activated" ? b(e) : t === "toolbar-button-click" ? g(e, r) : !1;
 }
-function B(t) {
+function U(t) {
   return f.has(t);
 }
-function U(t) {
+function X(t) {
   return w.has(t) ? "visible" : "full";
 }
 export {
-  _ as forwardedEventEntries,
-  U as getMutationCommitSource,
-  B as isDisplayOnlyEvent,
-  $ as isRowDataMutationEvent
+  $ as forwardedEventEntries,
+  X as getMutationCommitSource,
+  U as isDisplayOnlyEvent,
+  B as isRowDataMutationEvent
 };

package/dist/components/tt-table/src/types/table.d.ts

@@ -413,6 +413,22 @@ export type VxeTableMethods<DT> = {
 };
 export type TtSelectRowKeysType = Array<string | number> | string | number | undefined | any;
 export type TtSelectRowsType = VxeTablePropTypes.Row | Array<VxeTablePropTypes.Row> | any;
+/**
+ * 选中行变化事件（`selection-change`）的载荷。
+ *
+ * 由 `useRowSelection` 发出，同时作为 `onSelectionChange` prop 的参数类型：
+ * 声明成具名 prop 后，业务的回调匹配的是这个具体签名，而不是 emits 数组生成的
+ * `on${Capitalize<string>}` 索引签名 —— 后者的值类型是 `defineModel` 与数组 emits
+ * 交叉出的函数，在参数逆变位置上和任何具名参数的回调都不兼容。
+ */
+export type TtTableSelectionPayload = {
+    /** 选中行的 key 集合 */
+    keys: TtSelectRowKeysType;
+    /** 选中的行数据 */
+    rows: TtSelectRowsType;
+    /** 触发本次变化的行，全选与清空时为空 */
+    data?: Recordable;
+};
 /**
  * `useTableRender` 返回组件的插槽类型。
  *

package/dist/components/tt-table/src/utils/action-tab-index.js

@@ -2,8 +2,9 @@ import "axios";
 import "element-plus";
 import { isUndefined as d, isServer as f } from "../../../../packages/utils/src/is.js";
 import "vue";
-import "xe-utils";
 import "dayjs";
+import "numeral";
+import "xe-utils";
 import "dayjs/plugin/utc";
 import "dayjs/plugin/timezone";
 import "../../../../node_modules/.pnpm/decimal.js@10.6.0/node_modules/decimal.js/decimal.js";
@@ -16,25 +17,25 @@ let a;
 function p() {
   const u = Array.from(document.querySelectorAll('[class*="table-action"]')), r = /* @__PURE__ */ new Map();
   u.forEach((n) => {
-    const o = n.closest(".vxe-table");
-    if (!o) return;
-    const s = n.getBoundingClientRect(), t = Math.round(s.top), e = r.get(o) || /* @__PURE__ */ new Map(), i = e.get(t) || [];
-    i.push(n), e.set(t, i), r.set(o, e);
+    const e = n.closest(".vxe-table");
+    if (!e) return;
+    const s = n.getBoundingClientRect(), t = Math.round(s.top), o = r.get(e) || /* @__PURE__ */ new Map(), i = o.get(t) || [];
+    i.push(n), o.set(t, i), r.set(e, o);
   }), r.forEach((n) => {
-    n.forEach((o) => {
-      const s = o.sort((t, e) => {
-        const i = t.closest(".vxe-table"), c = e.closest(".vxe-table"), l = i != null && i.classList.contains("is--fixed-right") ? 1 : 0, m = c != null && c.classList.contains("is--fixed-right") ? 1 : 0;
-        return l !== m ? m - l : e.getBoundingClientRect().left - t.getBoundingClientRect().left;
+    n.forEach((e) => {
+      const s = e.sort((t, o) => {
+        const i = t.closest(".vxe-table"), c = o.closest(".vxe-table"), l = i != null && i.classList.contains("is--fixed-right") ? 1 : 0, m = c != null && c.classList.contains("is--fixed-right") ? 1 : 0;
+        return l !== m ? m - l : o.getBoundingClientRect().left - t.getBoundingClientRect().left;
       })[0];
-      o.forEach((t) => {
-        t.querySelectorAll("[data-table-action-button]").forEach((e) => {
-          e.tabIndex = t === s ? 0 : -1;
+      e.forEach((t) => {
+        t.querySelectorAll("[data-table-action-button]").forEach((o) => {
+          o.tabIndex = t === s ? 0 : -1;
         });
       });
     });
   });
 }
-function B() {
+function I() {
   if (d(a)) {
     if (f || !window.requestAnimationFrame) {
       p();
@@ -46,5 +47,5 @@ function B() {
   }
 }
 export {
-  B as scheduleNormalizeActionTabIndex
+  I as scheduleNormalizeActionTabIndex
 };

package/dist/components/tt-table/src/utils/context.js

@@ -2,8 +2,9 @@ import { inject as s, provide as c } from "vue";
 import "axios";
 import "element-plus";
 import { isString as m, isArray as p } from "../../../../packages/utils/src/is.js";
-import "xe-utils";
 import "dayjs";
+import "numeral";
+import "xe-utils";
 import "dayjs/plugin/utc";
 import "dayjs/plugin/timezone";
 import "../../../../node_modules/.pnpm/decimal.js@10.6.0/node_modules/decimal.js/decimal.js";
@@ -22,9 +23,9 @@ function f(t, r) {
     );
   }, (o) => (c(n, o), o)];
 }
-const [T, D] = f("FormActionTestIds");
+const [D, E] = f("FormActionTestIds");
 export {
   f as createContext,
-  T as injectFormActionTestIds,
-  D as provideFormActionTestIds
+  D as injectFormActionTestIds,
+  E as provideFormActionTestIds
 };

package/dist/components/tt-table/src/utils/table-api.js

@@ -5,6 +5,8 @@ import "axios";
 import "element-plus";
 import { isFunction as w } from "../../../../packages/utils/src/is.js";
 import { reactive as m, shallowRef as y, computed as n, toValue as d } from "vue";
+import "dayjs";
+import "numeral";
 import { bindMethods as p } from "../../../../packages/utils/src/tool.js";
 import { mergeWithArrayOverride as h } from "../../../../packages/utils/src/merge.js";
 import "../../../../node_modules/.pnpm/decimal.js@10.6.0/node_modules/decimal.js/decimal.js";
@@ -39,7 +41,7 @@ function C() {
     columnsKey: (l = o.table) == null ? void 0 : l.columnsKey
   };
 }
-class k {
+class F {
   /**
    * 构造函数，初始化 store、状态等
    * @param options 表格配置项
@@ -425,6 +427,6 @@ class k {
   }
 }
 export {
-  k as TableApi,
+  F as TableApi,
   C as getDefaultState
 };

package/dist/components/tt-table/src/utils/table-form-api.js

@@ -1,10 +1,12 @@
-var m = Object.defineProperty;
-var b = (s, t, e) => t in s ? m(s, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : s[t] = e;
-var r = (s, t, e) => b(s, typeof t != "symbol" ? t + "" : t, e);
+var h = Object.defineProperty;
+var b = (r, t, e) => t in r ? h(r, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : r[t] = e;
+var s = (r, t, e) => b(r, typeof t != "symbol" ? t + "" : t, e);
 import "axios";
 import "element-plus";
 import { isFunction as c } from "../../../../packages/utils/src/is.js";
 import { reactive as i, computed as u, toValue as f } from "vue";
+import "dayjs";
+import "numeral";
 import { bindMethods as d } from "../../../../packages/utils/src/tool.js";
 import { mergeWithArrayOverride as a } from "../../../../packages/utils/src/merge.js";
 import "../../../../node_modules/.pnpm/decimal.js@10.6.0/node_modules/decimal.js/decimal.js";
@@ -16,37 +18,37 @@ import "../../../../node_modules/.pnpm/crypto-js@4.2.0/node_modules/crypto-js/pa
 import "lodash-es";
 import { Store as A, useStore as S } from "@tanstack/vue-store";
 import { getDefaultState as y, TableApi as j } from "./table-api.js";
-function g(s) {
-  if (!s) return;
+function g(r) {
+  if (!r) return;
   const t = {};
-  return Object.keys(s).forEach((e) => {
-    e !== "data" && Object.assign(t, { [e]: s[e] });
+  return Object.keys(r).forEach((e) => {
+    e !== "data" && Object.assign(t, { [e]: r[e] });
   }), t;
 }
-class V {
+class q {
   /**
    * 构造函数，初始化 store、tableApi、状态等
    * @param options 表单+表格配置项
    */
   constructor(t = {}) {
     /** form 表单实例（FormApi） */
-    r(this, "formApi", i({}));
+    s(this, "formApi", i({}));
     /** 表格 API 实例（TableApi） */
-    r(this, "tableApi", i({}));
+    s(this, "tableApi", i({}));
     /** vxe-grid 表格实例 */
-    r(this, "grid", i({}));
+    s(this, "grid", i({}));
     /** 当前表单+表格的 props 状态 */
-    r(this, "state", null);
+    s(this, "state", null);
     /** 表单操作方法集合（TableFormActionType） */
-    r(this, "tableForm", i({}));
+    s(this, "tableForm", i({}));
     /** 响应式 store，存储表单+表格的状态 */
-    r(this, "store");
-    r(this, "isMounted", !1);
-    r(this, "stateHandler");
+    s(this, "store");
+    s(this, "isMounted", !1);
+    s(this, "stateHandler");
     /**
      * 当前选中的行 key 数组（响应式）
      */
-    r(this, "selectedKeys", u(() => f(this.tableApi.selectedKeys) ?? []));
+    s(this, "selectedKeys", u(() => f(this.tableApi.selectedKeys) ?? []));
     const e = { ...t }, o = g(t.table);
     o && (e.table = o);
     const p = y();
@@ -65,8 +67,8 @@ class V {
     const n = new j({
       ...this.state.table,
       useSearchForm: this.state.useSearchForm || !1
-    }), l = n;
-    l.useStore = (h) => S(n.store, h), Object.setPrototypeOf(this.tableApi, l), d(this);
+    }), m = n;
+    m.useStore = (l) => S(n.store, l), Object.setPrototypeOf(this.tableApi, m), d(this);
   }
   /**
    * 组件挂载时调用，注入表单和表格实例
@@ -139,5 +141,5 @@ class V {
   }
 }
 export {
-  V as TableFormApi
+  q as TableFormApi
 };

package/dist/components/tt-text/index.js

@@ -3,6 +3,7 @@ import "element-plus";
 import "dayjs";
 import "vue";
 import { withInstall as t } from "../../packages/utils/src/install.js";
+import "numeral";
 import "xe-utils";
 import "dayjs/plugin/utc";
 import "dayjs/plugin/timezone";
@@ -13,8 +14,8 @@ import "../../node_modules/.pnpm/crypto-js@4.2.0/node_modules/crypto-js/mode-ecb
 import "../../node_modules/.pnpm/crypto-js@4.2.0/node_modules/crypto-js/pad-pkcs7.js";
 import "lodash-es";
 import o from "./index.vue.js";
-const h = t(o);
+const w = t(o);
 export {
-  h as TtText,
-  h as default
+  w as TtText,
+  w as default
 };

package/dist/components/tt-upload/index.js

@@ -3,6 +3,7 @@ import "element-plus";
 import "dayjs";
 import "vue";
 import { withInstall as o } from "../../packages/utils/src/install.js";
+import "numeral";
 import "xe-utils";
 import "dayjs/plugin/utc";
 import "dayjs/plugin/timezone";
@@ -13,10 +14,10 @@ import "../../node_modules/.pnpm/crypto-js@4.2.0/node_modules/crypto-js/mode-ecb
 import "../../node_modules/.pnpm/crypto-js@4.2.0/node_modules/crypto-js/pad-pkcs7.js";
 import "lodash-es";
 import t from "./src/TtUpload.vue.js";
-import { ttUploadProps as I } from "./src/typing.js";
-const h = o(t);
+import { ttUploadProps as P } from "./src/typing.js";
+const u = o(t);
 export {
-  h as TtUpload,
-  h as default,
-  I as ttUploadProps
+  u as TtUpload,
+  u as default,
+  P as ttUploadProps
 };

package/dist/components/tt-upload/src/TtUpload.vue.js

@@ -9,8 +9,9 @@ import { useDesign as ge } from "../../../packages/hooks/src/useDesign.js";
 import "axios";
 import { ElMessage as p, ElImageViewer as _e, ElUpload as he } from "element-plus";
 import { isString as ye, isNumber as Ue } from "../../../packages/utils/src/is.js";
-import "xe-utils";
 import "dayjs";
+import "numeral";
+import "xe-utils";
 import "dayjs/plugin/utc";
 import "dayjs/plugin/timezone";
 import "../../../node_modules/.pnpm/decimal.js@10.6.0/node_modules/decimal.js/decimal.js";
@@ -25,7 +26,7 @@ import { TtText as V } from "../../tt-text/index.js";
 import { ttUploadProps as $e } from "./typing.js";
 import { GlobalConfig as F } from "../../../hooks/useSetup.js";
 import { useModalRender as Se } from "../../tt-modal/src/hooks/useModalRender.js";
-const Qe = /* @__PURE__ */ de({
+const Ze = /* @__PURE__ */ de({
   name: "TtUpload",
   __name: "TtUpload",
   props: /* @__PURE__ */ z($e, {
@@ -314,5 +315,5 @@ const Qe = /* @__PURE__ */ de({
   }
 });
 export {
-  Qe as default
+  Ze as default
 };

package/dist/directives/disabled-tip/index.js

@@ -1,9 +1,10 @@
 import "axios";
 import { ElTooltip as b } from "element-plus";
 import { isArray as l, isObject as m } from "../../packages/utils/src/is.js";
-import { shallowRef as v, toValue as s, h as p, createVNode as g, render as h } from "vue";
-import "xe-utils";
+import { shallowRef as v, toValue as p, h as s, createVNode as g, render as h } from "vue";
 import "dayjs";
+import "numeral";
+import "xe-utils";
 import "dayjs/plugin/utc";
 import "dayjs/plugin/timezone";
 import "../../node_modules/.pnpm/decimal.js@10.6.0/node_modules/decimal.js/decimal.js";
@@ -16,10 +17,10 @@ let n;
 const d = v();
 function V(e) {
   if (l(e) && e.length > 0)
-    return e.filter((t) => s(t.condition) ?? !0).map((t) => t.message);
+    return e.filter((t) => p(t.condition) ?? !0).map((t) => t.message);
   if (m(e)) {
     const t = e;
-    return !!s(t.condition) ? t.message : null;
+    return !!p(t.condition) ? t.message : null;
   }
   return typeof e == "string" ? e : null;
 }
@@ -27,7 +28,7 @@ function x(e) {
   return l(e) && e.length > 0 ? e[0].placement || "bottom" : m(e) && e.placement || "bottom";
 }
 function y(e, t, o = "bottom") {
-  if (d.value = Array.isArray(t) ? t.map((r) => p("div", {}, r)) : t, n)
+  if (d.value = Array.isArray(t) ? t.map((r) => s("div", {}, r)) : t, n)
     n.props.trigger = "hover", n.props.virtualRef = e, n.props.placement = o, n.exposed.updatePopper(), n.exposed.onOpen();
   else {
     const r = g(
@@ -44,7 +45,7 @@ function y(e, t, o = "bottom") {
         popperClass: "!z-[9999]"
       },
       {
-        content: () => p(
+        content: () => s(
           "div",
           {
             style: {
@@ -75,7 +76,7 @@ async function a(e, t) {
   const o = t.value, r = V(o), i = x(o);
   e.boundingValue = e.boundingValue || { listened: !1, messages: r, placement: i }, e.boundingValue.messages = r, e.boundingValue.placement = i, !((u = e.boundingValue) != null && u.listened) && (r != null && r.length) && (e.addEventListener("mouseenter", c), e.addEventListener("mouseleave", f), e.boundingValue.listened = !0);
 }
-const N = {
+const q = {
   created: a,
   beforeMount: a,
   updated: a,
@@ -85,5 +86,5 @@ const N = {
   }
 };
 export {
-  N as default
+  q as default
 };

package/dist/hooks/useFormSchemasLink.js

@@ -3,8 +3,9 @@ import "axios";
 import { ElSelectV2 as Z } from "element-plus";
 import { isFunction as q } from "../packages/utils/src/is.js";
 import "vue";
-import "xe-utils";
 import "dayjs";
+import "numeral";
+import "xe-utils";
 import "dayjs/plugin/utc";
 import "dayjs/plugin/timezone";
 import "../node_modules/.pnpm/decimal.js@10.6.0/node_modules/decimal.js/decimal.js";
@@ -286,7 +287,7 @@ function no(r = {}, u = z) {
     dataSource: I
   };
 }
-function Po() {
+function So() {
   const r = {
     options: {},
     codes: [...z]
@@ -337,5 +338,5 @@ function Po() {
   return u;
 }
 export {
-  Po as useFormSchemasLink
+  So as useFormSchemasLink
 };

package/dist/hooks/useFormat.d.ts

@@ -1,73 +1,37 @@
-import { default as dayjs } from 'dayjs';
-type ILabelFormatType = "period" | "month";
-type FormatReturnType = {
-    /**
-     * 生成表单验证规则
-     * @param message - 验证失败时的提示信息
-     * @param trigger - 触发验证的时机，默认为'change'
-     * @returns 验证规则数组
-     */
-    formatFormRole: (message: string, trigger?: string) => {
-        required: boolean;
-        message: string;
-        trigger: string;
-    }[];
-    /**
-     * 格式化日期时间
-     * @param date - 要格式化的日期，可以是字符串、数字、Date对象或dayjs对象
-     * @param format - 格式化模板，默认为'YYYY-MM-DD HH:mm:ss'
-     * @returns 格式化后的日期时间字符串，无效日期返回'--'
-     */
-    formatToDateTime: (date: string | number | Date | dayjs.Dayjs | null | undefined, format?: string) => string;
-    /**
-     * 格式化日期
-     * @param date - 要格式化的日期，可以是字符串、数字、Date对象或dayjs对象
-     * @param format - 格式化模板，默认为'YYYY-MM-DD'
-     * @param isTimeStamp - 是否为时间戳格式，默认为false
-     * @returns 格式化后的日期字符串，无效日期返回'--'
-     */
-    formatToDate: (date: string | number | Date | dayjs.Dayjs | null | undefined, format?: string, isTimeStamp?: boolean) => string;
-    /**
-     * 格式化金额数据
-     * @param val - 要格式化的金额，可以是数字或字符串
-     * @param format - 格式化模板，默认为'0,0.00'
-     * @returns 格式化后的金额字符串
-     */
-    formatAmount: (val: number | string, format?: string) => string;
-    /**
-     * 格式化金额为千分位并保留两位小数
-     * @param val - 要格式化的数值
-     * @param format - 格式化模板，默认为'0,0.00'
-     * @returns 格式化后的金额字符串
-     */
-    formatAmountOfPlace: (val: number, format?: string) => string;
-    /**
-     * 将千分位格式的金额字符串转换为数值
-     * @param val - 要转换的金额字符串或数值
-     * @returns 转换后的数值
-     */
-    formatPlaceOfAmount: (val: string | number) => number;
-    /**
-     * 格式化金额但不四舍五入
-     * @param str - 要格式化的金额字符串或数字
-     * @param index - 要保留的小数位数
-     * @returns 格式化后的金额字符串
-     */
-    formatDecimal: (str: string | number, index: number) => string;
-    /**
-     * 格式化文件大小
-     * @param bytes - 文件大小(字节)
-     * @param decimalPoint - 保留的小数位数，默认为2
-     * @returns 格式化后的文件大小字符串(带单位)
-     */
-    formatFileSize: (bytes: number, decimalPoint?: number) => string;
-    /**
-     * 格式化期间(年月)
-     * @param val - 要格式化的期间值，可以是数字或字符串
-     * @param formatType - 格式化类型，'period'表示期间，'month'表示月份
-     * @returns 格式化后的期间字符串
-     */
-    formatPeriod: (val: number | string, formatType?: ILabelFormatType) => string;
+import { formatAmount, formatAmountOfPlace, formatDecimal, formatFileSize, formatPeriod, formatPlaceOfAmount, formatToDate, formatToDateTime } from '../../../utils/src';
+/**
+ * 生成表单验证规则
+ *
+ * 留在 ui 包：它产出的是 element-plus 表单的校验规则，不属于数据格式化。
+ * @param message 验证失败时的提示信息
+ * @param trigger 触发验证的时机，默认 `change`
+ * @returns 校验规则数组
+ */
+declare function formatFormRole(message: string, trigger?: string): {
+    required: boolean;
+    message: string;
+    trigger: string;
+}[];
+/**
+ * 格式化方法集合。
+ *
+ * 除 `formatFormRole` 外的实现都在 `@dazhicheng/utils` 的 `format` 模块，这里只做转发，
+ * 保证 hook 与直接 `import { formatAmount } from "@dazhicheng/utils"` 拿到的是同一份实现。
+ * 返回类型交给推断，避免 hook 侧与 utils 侧维护两套签名。
+ * @returns 格式化方法集合
+ * @example
+ * const { formatAmount, formatToDate } = useFormat();
+ * formatAmount(1234.5); // "1,234.50"
+ */
+export declare function useFormat(): {
+    formatFormRole: typeof formatFormRole;
+    formatToDateTime: typeof formatToDateTime;
+    formatToDate: typeof formatToDate;
+    formatAmount: typeof formatAmount;
+    formatAmountOfPlace: typeof formatAmountOfPlace;
+    formatPlaceOfAmount: typeof formatPlaceOfAmount;
+    formatDecimal: typeof formatDecimal;
+    formatFileSize: typeof formatFileSize;
+    formatPeriod: typeof formatPeriod;
 };
-export declare function useFormat(): FormatReturnType;
 export {};