fast-element-plus 1.0.21 → 2.0.1

package/dist/index.mjs

@@ -0,0 +1,70 @@
+import { faAvatarEmits, faAvatarProps } from "./components/avatar/src/avatar.mjs";
+import { FaAvatar } from "./components/avatar/index.mjs";
+import { useLoading } from "./hooks/use-loading/index.mjs";
+import { useOverlay } from "./hooks/use-overlay/index.mjs";
+import { useScreenFull } from "./hooks/use-screenFull/index.mjs";
+import { faButtonEmits, faButtonProps } from "./components/button/src/button.mjs";
+import { FaButton } from "./components/button/index.mjs";
+import { FaMimeType } from "./constants/mime.mjs";
+import { RegExps } from "./constants/regex.mjs";
+import { CarNumberArea, CarNumberDigit, CarNumberLetter } from "./components/carNumber/src/common.mjs";
+import { FaCarNumber } from "./components/carNumber/index.mjs";
+import { faIconProps } from "./components/icon/src/icon.mjs";
+import { FaIcon } from "./components/icon/index.mjs";
+import { FaContextMenu } from "./components/contextMenu/index.mjs";
+import { faDialogEmits, faDialogProps } from "./components/dialog/src/dialog.mjs";
+import { FaDialog } from "./components/dialog/index.mjs";
+import { faDrawerEmits, faDrawerProps } from "./components/drawer/src/drawer.mjs";
+import { FaDrawer } from "./components/drawer/index.mjs";
+import { FaLayoutGrid, FaLayoutGridItem } from "./components/layoutGrid/index.mjs";
+import { formUtil } from "./components/form/utils/form.mjs";
+import { faFormEmits, faFormProps } from "./components/form/src/form.mjs";
+import { faFormItemTipProps } from "./components/formItemTip/src/formItemTip.mjs";
+import { FaFormItemTip } from "./components/formItemTip/index.mjs";
+import { faFormItemProps } from "./components/form/src/formItem.mjs";
+import { FaForm, FaFormItem } from "./components/form/index.mjs";
+import { FaIconSelector } from "./components/iconSelector/index.mjs";
+import { faImageEmits, faImageProps } from "./components/image/src/image.mjs";
+import { FaImage } from "./components/image/index.mjs";
+import { tableUtil } from "./components/table/utils/table.mjs";
+import { getTableDefaultSlots } from "./components/table/src/table.type.mjs";
+import { tableColumnProps } from "./components/table/src/tableColumn.mjs";
+import { faTableEmits, faTableProps, tableProps } from "./components/table/src/table.mjs";
+import { PagedSearchTypeEnum } from "./components/table/src/page.type.mjs";
+import { FaTable, FaTableColumn } from "./components/table/index.mjs";
+import { faInputDialogPageEmits, faInputDialogPageProps } from "./components/inputDialogPage/src/inputDialogPage.mjs";
+import { FaInputDialogPage } from "./components/inputDialogPage/index.mjs";
+import { faSelectProps } from "./components/select/src/select.mjs";
+import { FaSelect, FaSelectOption } from "./components/select/index.mjs";
+import { faSelectPageEmits, faSelectPageProps } from "./components/selectPage/src/selectPage.mjs";
+import { FaSelectPage } from "./components/selectPage/index.mjs";
+import { SelectV2Props, faSelectV2Props } from "./components/selectV2/src/selectV2.mjs";
+import { FaSelectV2 } from "./components/selectV2/index.mjs";
+import { faTreeEmits, faTreeProps } from "./components/tree/src/tree.mjs";
+import { FaTree } from "./components/tree/index.mjs";
+import { faTreeSelectEmits, faTreeSelectProps } from "./components/treeSelect/src/treeSelect.mjs";
+import { FaTreeSelect } from "./components/treeSelect/index.mjs";
+import { faUploadEmits, faUploadProps } from "./components/upload/src/upload.mjs";
+import { FaUpload } from "./components/upload/index.mjs";
+import { faUploadImageEmits, faUploadImageProps } from "./components/uploadImage/src/uploadImage.mjs";
+import { FaUploadImage } from "./components/uploadImage/index.mjs";
+import { faUploadImagesEmits, faUploadImagesProps } from "./components/uploadImages/src/uploadImages.mjs";
+import { FaUploadImages } from "./components/uploadImages/index.mjs";
+import vCopy from "./directives/click-copy/index.mjs";
+import vDebounce from "./directives/click-debounce/index.mjs";
+import vDraggable from "./directives/click-draggable/index.mjs";
+import vIconCopy from "./directives/click-icon-copy/index.mjs";
+import vLongpress from "./directives/click-longpress/index.mjs";
+import vThrottle from "./directives/click-throttle/index.mjs";
+import { INSTALLED_KEY, makeInstaller } from "./make-installer.mjs";
+import { Decimal } from "decimal.js";
+//#region src/index.ts
+const installer = makeInstaller();
+/** 将全部组件、指令、Element Plus 及两套图标安装到 Vue 应用。 */
+const install = installer.install;
+/** 当前 Fast.Element.Plus 包版本。 */
+const version = installer.version;
+//#endregion
+export { CarNumberArea, CarNumberDigit, CarNumberLetter, Decimal, FaAvatar, FaButton, FaCarNumber, FaContextMenu, FaDialog, FaDrawer, FaForm, FaFormItem, FaFormItemTip, FaIcon, FaIconSelector, FaImage, FaInputDialogPage, FaLayoutGrid, FaLayoutGridItem, FaMimeType, FaSelect, FaSelectOption, FaSelectPage, FaSelectV2, FaTable, FaTableColumn, FaTree, FaTreeSelect, FaUpload, FaUploadImage, FaUploadImages, INSTALLED_KEY, PagedSearchTypeEnum, RegExps, SelectV2Props, installer as default, faAvatarEmits, faAvatarProps, faButtonEmits, faButtonProps, faDialogEmits, faDialogProps, faDrawerEmits, faDrawerProps, faFormEmits, faFormItemProps, faFormItemTipProps, faFormProps, faIconProps, faImageEmits, faImageProps, faInputDialogPageEmits, faInputDialogPageProps, faSelectPageEmits, faSelectPageProps, faSelectProps, faSelectV2Props, faTableEmits, faTableProps, faTreeEmits, faTreeProps, faTreeSelectEmits, faTreeSelectProps, faUploadEmits, faUploadImageEmits, faUploadImageProps, faUploadImagesEmits, faUploadImagesProps, faUploadProps, formUtil, getTableDefaultSlots, install, tableColumnProps, tableProps, tableUtil, useLoading, useOverlay, useScreenFull, vCopy, vDebounce, vDraggable, vIconCopy, vLongpress, vThrottle, version };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { makeInstaller } from \"./make-installer\";\n\n/** 用于标记已经安装 Fast.Element.Plus 的 Vue 应用。 */\nexport { INSTALLED_KEY } from \"./make-installer\";\n\nexport * from \"./components\";\nexport * from \"./constants\";\nexport * from \"./directives\";\nexport * from \"./hooks\";\n\n/** Decimal.js 的任意精度十进制实现。 */\nexport { Decimal } from \"decimal.js\";\n\nconst installer = makeInstaller();\n\n/** 将全部组件、指令、Element Plus 及两套图标安装到 Vue 应用。 */\nexport const install = installer.install;\n/** 当前 Fast.Element.Plus 包版本。 */\nexport const version = installer.version;\n/** 支持 `app.use(FastElementPlus)` 的默认插件。 */\nexport default installer;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAaA,MAAM,YAAY,cAAc;;AAGhC,MAAa,UAAU,UAAU;;AAEjC,MAAa,UAAU,UAAU"}

package/dist/make-installer.d.ts

@@ -0,0 +1,8 @@
+import type { App } from "vue";
+/** Vue 应用上的安装状态键，避免同一应用重复注册组件和指令。 */
+export declare const INSTALLED_KEY: unique symbol;
+/** 创建包含版本信息和幂等安装逻辑的 Fast.Element.Plus 插件。 */
+export declare const makeInstaller: () => {
+    version: string;
+    install: (app: App) => void;
+};

package/dist/make-installer.mjs

@@ -0,0 +1,28 @@
+import component_default from "./component.mjs";
+import directive_default from "./directive.mjs";
+import { installElementPlus } from "./element-plus.mjs";
+import { version } from "./version.mjs";
+import * as FastElementPlusIconsVue from "@fast-element-plus/icons-vue";
+//#region src/make-installer.ts
+/** Vue 应用上的安装状态键，避免同一应用重复注册组件和指令。 */
+const INSTALLED_KEY = Symbol("FAST_ELEMENT_PLUS_INSTALLED_KEY");
+/** 创建包含版本信息和幂等安装逻辑的 Fast.Element.Plus 插件。 */
+const makeInstaller = () => {
+	const install = (app) => {
+		if (app[INSTALLED_KEY]) return;
+		app[INSTALLED_KEY] = true;
+		installElementPlus(app);
+		/** 注册 Fast.Element.Plus 全部图标，供 FaIcon 按名称解析。 */
+		for (const [key, component] of Object.entries(FastElementPlusIconsVue)) app.component(`fa-icon-${key}`, component);
+		component_default.forEach((c) => app.use(c));
+		directive_default.forEach((d) => app.use(d));
+	};
+	return {
+		version,
+		install
+	};
+};
+//#endregion
+export { INSTALLED_KEY, makeInstaller };
+
+//# sourceMappingURL=make-installer.mjs.map

package/dist/make-installer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-installer.mjs","names":[],"sources":["../src/make-installer.ts"],"sourcesContent":["import * as FastElementPlusIconsVue from \"@fast-element-plus/icons-vue\";\nimport FastElementPlusComponents from \"./component\";\nimport FastElementPlusDirectives from \"./directive\";\nimport { installElementPlus } from \"./element-plus\";\nimport { version } from \"./version\";\nimport type { App } from \"vue\";\n\n/** Vue 应用上的安装状态键，避免同一应用重复注册组件和指令。 */\nexport const INSTALLED_KEY = Symbol(\"FAST_ELEMENT_PLUS_INSTALLED_KEY\");\n\ninterface InstallableApp extends App {\n\t[INSTALLED_KEY]?: boolean;\n}\n\n/** 创建包含版本信息和幂等安装逻辑的 Fast.Element.Plus 插件。 */\nexport const makeInstaller = (): {\n\tversion: string;\n\tinstall: (app: App) => void;\n} => {\n\tconst install = (app: App): void => {\n\t\tif ((app as InstallableApp)[INSTALLED_KEY]) return;\n\n\t\t(app as InstallableApp)[INSTALLED_KEY] = true;\n\n\t\tinstallElementPlus(app);\n\n\t\t/** 注册 Fast.Element.Plus 全部图标，供 FaIcon 按名称解析。 */\n\t\tfor (const [key, component] of Object.entries(FastElementPlusIconsVue)) app.component(`fa-icon-${key}`, component);\n\n\t\tFastElementPlusComponents.forEach((c) => app.use(c));\n\n\t\tFastElementPlusDirectives.forEach((d) => app.use(d));\n\t};\n\n\treturn {\n\t\tversion,\n\t\tinstall,\n\t};\n};\n"],"mappings":";;;;;;;AAQA,MAAa,gBAAgB,OAAO,iCAAiC;;AAOrE,MAAa,sBAGR;CACJ,MAAM,WAAW,QAAmB;EACnC,IAAK,IAAuB,gBAAgB;EAE5C,IAAwB,iBAAiB;EAEzC,mBAAmB,GAAG;;EAGtB,KAAK,MAAM,CAAC,KAAK,cAAc,OAAO,QAAQ,uBAAuB,GAAG,IAAI,UAAU,WAAW,OAAO,SAAS;EAEjH,kBAA0B,SAAS,MAAM,IAAI,IAAI,CAAC,CAAC;EAEnD,kBAA0B,SAAS,MAAM,IAAI,IAAI,CAAC,CAAC;CACpD;CAEA,OAAO;EACN;EACA;CACD;AACD"}

package/dist/utils/async/index.d.ts

@@ -0,0 +1,35 @@
+/** 统一同步返回值与 PromiseLike 返回值的内部回调签名。 */
+type AsyncCallback<Arguments extends unknown[], Result> = (...arguments_: Arguments) => Result | PromiseLike<Result>;
+/** Promise 感知的防抖函数。 */
+export interface DebouncedFunction<Arguments extends unknown[], Result> {
+    /**
+     * 调度一次调用；同一等待窗口内的调用共享最后一组参数对应的结果。
+     * @param arguments_ - 传给原始回调的参数；后续调用会覆盖尚未执行批次保存的参数。
+     * @returns 当前批次的独立 Promise，最终与共享回调结果保持相同状态。
+     */
+    (...arguments_: Arguments): Promise<Result>;
+    /**
+     * 取消尚未执行的批次，并拒绝该批次的所有 Promise。
+     * @param reason - 可选拒绝原因；省略时使用内部取消错误。
+     */
+    cancel: (reason?: unknown) => void;
+    /**
+     * 立即执行待处理批次，不创建第二次回调执行。
+     * @returns 待处理批次的共享执行 Promise；没有批次时返回 `undefined`。
+     */
+    flush: () => Promise<Result> | undefined;
+    /** @returns 当前存在尚未开始的批次时返回 `true`；正在执行但没有等待批次时返回 `false`。 */
+    pending: () => boolean;
+}
+/**
+ * 创建 Promise 感知的防抖函数。
+ *
+ * @remarks 同一窗口内的所有调用都会等待最后一组参数对应的执行结果；回调错误会原样
+ * 拒绝该批次的全部调用，不会留下永久 pending 的 Promise。
+ * @param callback - 同步或异步回调。
+ * @param delayMs - 0 至 2,147,483,647 的有限等待时间，默认 300 毫秒。
+ * @returns 具有取消、立即执行和状态方法的防抖函数。
+ * @throws `RangeError` 当延迟不在平台计时器支持范围内。
+ */
+export declare function debounce<Arguments extends unknown[], Result>(callback: AsyncCallback<Arguments, Result>, delayMs?: number): DebouncedFunction<Arguments, Awaited<Result>>;
+export {};

package/dist/utils/async/index.mjs

@@ -0,0 +1,94 @@
+//#region src/utils/async/index.ts
+const maximumTimerDelay = 2147483647;
+/**
+* 校验宿主计时器可以稳定表示的延迟。
+*
+* @param milliseconds - 待校验的毫秒数。
+* @param name - 用于错误消息的参数名称。
+* @returns 原始延迟值，便于调用方在校验后直接使用。
+* @throws `RangeError` 当值非有限、为负数或超过 32 位计时器上限。
+*/
+const assertDelay = (milliseconds, name = "milliseconds") => {
+	if (!Number.isFinite(milliseconds) || milliseconds < 0 || milliseconds > maximumTimerDelay) throw new RangeError(`\`${name}\` 必须是 0 到 ${maximumTimerDelay} 之间的有限数。`);
+	return milliseconds;
+};
+/**
+* 创建 Promise 感知的防抖函数。
+*
+* @remarks 同一窗口内的所有调用都会等待最后一组参数对应的执行结果；回调错误会原样
+* 拒绝该批次的全部调用，不会留下永久 pending 的 Promise。
+* @param callback - 同步或异步回调。
+* @param delayMs - 0 至 2,147,483,647 的有限等待时间，默认 300 毫秒。
+* @returns 具有取消、立即执行和状态方法的防抖函数。
+* @throws `RangeError` 当延迟不在平台计时器支持范围内。
+*/
+function debounce(callback, delayMs = 300) {
+	const delay = assertDelay(delayMs, "delayMs");
+	let timer;
+	let latestArguments;
+	let waiters = [];
+	/**
+	* 执行并结算当前防抖批次。
+	*
+	* @returns 最后一组参数对应的回调结果。
+	* @throws 没有待处理批次时抛出 `Error`；回调错误会原样传播给批次中的全部调用方。
+	*/
+	const execute = async () => {
+		const arguments_ = latestArguments;
+		if (arguments_ === void 0) throw new Error("当前没有待处理的防抖调用。");
+		latestArguments = void 0;
+		timer = void 0;
+		const currentWaiters = waiters;
+		waiters = [];
+		try {
+			const result = await callback(...arguments_);
+			currentWaiters.forEach((waiter) => {
+				waiter.resolve(result);
+			});
+			return result;
+		} catch (error) {
+			currentWaiters.forEach((waiter) => {
+				waiter.reject(error);
+			});
+			throw error;
+		}
+	};
+	/**
+	* 更新批次参数并返回当前调用方专属的等待 Promise。
+	*
+	* @param arguments_ - 本次调用参数；同批次中只有最后一组参数会执行。
+	* @returns 与当前批次共享结果、但可独立结算的 Promise。
+	*/
+	const debounced = (...arguments_) => {
+		latestArguments = arguments_;
+		if (timer !== void 0) clearTimeout(timer);
+		timer = setTimeout(() => {
+			execute().catch(() => void 0);
+		}, delay);
+		return new Promise((resolve, reject) => waiters.push({
+			reject,
+			resolve
+		}));
+	};
+	debounced.cancel = (reason) => {
+		if (timer !== void 0) clearTimeout(timer);
+		timer = void 0;
+		latestArguments = void 0;
+		const error = reason ?? /* @__PURE__ */ new Error("防抖调用已取消。");
+		waiters.forEach((waiter) => {
+			waiter.reject(error);
+		});
+		waiters = [];
+	};
+	debounced.flush = () => {
+		if (timer === void 0) return void 0;
+		clearTimeout(timer);
+		return execute();
+	};
+	debounced.pending = () => timer !== void 0;
+	return debounced;
+}
+//#endregion
+export { debounce };
+
+//# sourceMappingURL=index.mjs.map

package/dist/utils/async/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/utils/async/index.ts"],"sourcesContent":["/** 统一同步返回值与 PromiseLike 返回值的内部回调签名。 */\ntype AsyncCallback<Arguments extends unknown[], Result> = (...arguments_: Arguments) => Result | PromiseLike<Result>;\n\n/** 记录同一防抖批次中每个调用方独立的 Promise 结算函数。 */\ninterface PromiseWaiter<Result> {\n\t/**\n\t * 使用批次失败原因拒绝当前调用方。\n\t * @param reason - `cancel` 提供的原因或共享回调抛出的原始错误。\n\t */\n\treject: (reason?: unknown) => void;\n\t/**\n\t * 使用共享回调结果完成当前调用方，并采用传入 PromiseLike 的最终状态。\n\t * @param value - 当前防抖批次唯一一次回调执行产生的共享结果。\n\t */\n\tresolve: (value: Result | PromiseLike<Result>) => void;\n}\n\n// 浏览器和 Node.js 的计时器普遍以有符号 32 位整数保存延迟；更大的值可能被\n// 静默截断为约 1 ms，因此公共 API 在进入平台计时器前统一拒绝它。\nconst maximumTimerDelay = 2_147_483_647;\n\n/** Promise 感知的防抖函数。 */\nexport interface DebouncedFunction<Arguments extends unknown[], Result> {\n\t/**\n\t * 调度一次调用；同一等待窗口内的调用共享最后一组参数对应的结果。\n\t * @param arguments_ - 传给原始回调的参数；后续调用会覆盖尚未执行批次保存的参数。\n\t * @returns 当前批次的独立 Promise，最终与共享回调结果保持相同状态。\n\t */\n\t(...arguments_: Arguments): Promise<Result>;\n\t/**\n\t * 取消尚未执行的批次，并拒绝该批次的所有 Promise。\n\t * @param reason - 可选拒绝原因；省略时使用内部取消错误。\n\t */\n\tcancel: (reason?: unknown) => void;\n\t/**\n\t * 立即执行待处理批次，不创建第二次回调执行。\n\t * @returns 待处理批次的共享执行 Promise；没有批次时返回 `undefined`。\n\t */\n\tflush: () => Promise<Result> | undefined;\n\t/** @returns 当前存在尚未开始的批次时返回 `true`；正在执行但没有等待批次时返回 `false`。 */\n\tpending: () => boolean;\n}\n\n/**\n * 校验宿主计时器可以稳定表示的延迟。\n *\n * @param milliseconds - 待校验的毫秒数。\n * @param name - 用于错误消息的参数名称。\n * @returns 原始延迟值，便于调用方在校验后直接使用。\n * @throws `RangeError` 当值非有限、为负数或超过 32 位计时器上限。\n */\nconst assertDelay = (milliseconds: number, name = \"milliseconds\"): number => {\n\tif (!Number.isFinite(milliseconds) || milliseconds < 0 || milliseconds > maximumTimerDelay) {\n\t\tthrow new RangeError(`\\`${name}\\` 必须是 0 到 ${maximumTimerDelay} 之间的有限数。`);\n\t}\n\treturn milliseconds;\n};\n\n/**\n * 创建 Promise 感知的防抖函数。\n *\n * @remarks 同一窗口内的所有调用都会等待最后一组参数对应的执行结果；回调错误会原样\n * 拒绝该批次的全部调用，不会留下永久 pending 的 Promise。\n * @param callback - 同步或异步回调。\n * @param delayMs - 0 至 2,147,483,647 的有限等待时间，默认 300 毫秒。\n * @returns 具有取消、立即执行和状态方法的防抖函数。\n * @throws `RangeError` 当延迟不在平台计时器支持范围内。\n */\nexport function debounce<Arguments extends unknown[], Result>(\n\tcallback: AsyncCallback<Arguments, Result>,\n\tdelayMs = 300\n): DebouncedFunction<Arguments, Awaited<Result>> {\n\tconst delay = assertDelay(delayMs, \"delayMs\");\n\tlet timer: ReturnType<typeof setTimeout> | undefined;\n\tlet latestArguments: Arguments | undefined;\n\tlet waiters: PromiseWaiter<Awaited<Result>>[] = [];\n\n\t/**\n\t * 执行并结算当前防抖批次。\n\t *\n\t * @returns 最后一组参数对应的回调结果。\n\t * @throws 没有待处理批次时抛出 `Error`；回调错误会原样传播给批次中的全部调用方。\n\t */\n\tconst execute = async (): Promise<Awaited<Result>> => {\n\t\tconst arguments_ = latestArguments;\n\t\tif (arguments_ === undefined) {\n\t\t\tthrow new Error(\"当前没有待处理的防抖调用。\");\n\t\t}\n\t\tlatestArguments = undefined;\n\t\ttimer = undefined;\n\t\tconst currentWaiters = waiters;\n\t\twaiters = [];\n\t\ttry {\n\t\t\tconst result = await callback(...arguments_);\n\t\t\tcurrentWaiters.forEach((waiter) => {\n\t\t\t\twaiter.resolve(result);\n\t\t\t});\n\t\t\treturn result;\n\t\t} catch (error) {\n\t\t\tcurrentWaiters.forEach((waiter) => {\n\t\t\t\twaiter.reject(error);\n\t\t\t});\n\t\t\tthrow error;\n\t\t}\n\t};\n\n\t/**\n\t * 更新批次参数并返回当前调用方专属的等待 Promise。\n\t *\n\t * @param arguments_ - 本次调用参数；同批次中只有最后一组参数会执行。\n\t * @returns 与当前批次共享结果、但可独立结算的 Promise。\n\t */\n\tconst debounced = (...arguments_: Arguments): Promise<Awaited<Result>> => {\n\t\tlatestArguments = arguments_;\n\t\tif (timer !== undefined) clearTimeout(timer);\n\t\ttimer = setTimeout(() => {\n\t\t\tvoid execute().catch(() => undefined);\n\t\t}, delay);\n\t\treturn new Promise<Awaited<Result>>((resolve, reject) => waiters.push({ reject, resolve }));\n\t};\n\n\tdebounced.cancel = (reason?: unknown): void => {\n\t\tif (timer !== undefined) clearTimeout(timer);\n\t\ttimer = undefined;\n\t\tlatestArguments = undefined;\n\t\tconst error = reason ?? new Error(\"防抖调用已取消。\");\n\t\twaiters.forEach((waiter) => {\n\t\t\twaiter.reject(error);\n\t\t});\n\t\twaiters = [];\n\t};\n\tdebounced.flush = (): Promise<Awaited<Result>> | undefined => {\n\t\tif (timer === undefined) return undefined;\n\t\tclearTimeout(timer);\n\t\treturn execute();\n\t};\n\tdebounced.pending = (): boolean => timer !== undefined;\n\treturn debounced;\n}\n"],"mappings":";AAmBA,MAAM,oBAAoB;;;;;;;;;AAgC1B,MAAM,eAAe,cAAsB,OAAO,mBAA2B;CAC5E,IAAI,CAAC,OAAO,SAAS,YAAY,KAAK,eAAe,KAAK,eAAe,mBACxE,MAAM,IAAI,WAAW,KAAK,KAAK,aAAa,kBAAkB,SAAS;CAExE,OAAO;AACR;;;;;;;;;;;AAYA,SAAgB,SACf,UACA,UAAU,KACsC;CAChD,MAAM,QAAQ,YAAY,SAAS,SAAS;CAC5C,IAAI;CACJ,IAAI;CACJ,IAAI,UAA4C,CAAC;;;;;;;CAQjD,MAAM,UAAU,YAAsC;EACrD,MAAM,aAAa;EACnB,IAAI,eAAe,KAAA,GAClB,MAAM,IAAI,MAAM,eAAe;EAEhC,kBAAkB,KAAA;EAClB,QAAQ,KAAA;EACR,MAAM,iBAAiB;EACvB,UAAU,CAAC;EACX,IAAI;GACH,MAAM,SAAS,MAAM,SAAS,GAAG,UAAU;GAC3C,eAAe,SAAS,WAAW;IAClC,OAAO,QAAQ,MAAM;GACtB,CAAC;GACD,OAAO;EACR,SAAS,OAAO;GACf,eAAe,SAAS,WAAW;IAClC,OAAO,OAAO,KAAK;GACpB,CAAC;GACD,MAAM;EACP;CACD;;;;;;;CAQA,MAAM,aAAa,GAAG,eAAoD;EACzE,kBAAkB;EAClB,IAAI,UAAU,KAAA,GAAW,aAAa,KAAK;EAC3C,QAAQ,iBAAiB;GACxB,QAAa,CAAC,CAAC,YAAY,KAAA,CAAS;EACrC,GAAG,KAAK;EACR,OAAO,IAAI,SAA0B,SAAS,WAAW,QAAQ,KAAK;GAAE;GAAQ;EAAQ,CAAC,CAAC;CAC3F;CAEA,UAAU,UAAU,WAA2B;EAC9C,IAAI,UAAU,KAAA,GAAW,aAAa,KAAK;EAC3C,QAAQ,KAAA;EACR,kBAAkB,KAAA;EAClB,MAAM,QAAQ,0BAAU,IAAI,MAAM,UAAU;EAC5C,QAAQ,SAAS,WAAW;GAC3B,OAAO,OAAO,KAAK;EACpB,CAAC;EACD,UAAU,CAAC;CACZ;CACA,UAAU,cAAoD;EAC7D,IAAI,UAAU,KAAA,GAAW,OAAO,KAAA;EAChC,aAAa,KAAK;EAClB,OAAO,QAAQ;CAChB;CACA,UAAU,gBAAyB,UAAU,KAAA;CAC7C,OAAO;AACR"}

package/dist/utils/date/index.d.ts

@@ -0,0 +1,74 @@
+/** 可转换为日期的输入；数字始终按 Unix 毫秒时间戳处理。 */
+export type DateInput = Date | number | string;
+/**
+ * 转换并克隆有效日期。
+ *
+ * @remarks 数字不进行秒/毫秒猜测；字符串遵循运行时 `Date` 解析规则，跨平台代码应传带显式时区的完整 ISO 8601。
+ * @param value - Date、Unix 毫秒时间戳或运行时可解析字符串。
+ * @returns 与输入不共享可变状态的新 Date。
+ * @throws 输入无效时抛出 `TypeError`。
+ */
+export declare function toDate(value: DateInput): Date;
+/**
+ * 返回输入日期所在本地时区日期的 `00:00:00.000`，不修改输入。
+ *
+ * @param value - 有效日期输入。
+ * @returns 新建的本地日开始时间。
+ * @throws 输入无效时抛出 `TypeError`。
+ */
+export declare function startOfDay(value: DateInput): Date;
+/** 日期选择器单日期快捷项。 */
+export interface DateShortcut {
+    /** 面向中文日期选择器的显示文本；调用方可直接用于菜单标签。 */
+    text: string;
+    /**
+     * 计算快捷项对应日期。
+     * @returns 每次调用时基于当前本地时间创建的新 `Date`，调用方可安全修改。
+     */
+    value: () => Date;
+}
+/** 日期选择器范围快捷项。 */
+export interface DateRangeShortcut {
+    /** 面向中文日期范围选择器的显示文本；调用方可直接用于菜单标签。 */
+    text: string;
+    /**
+     * 计算快捷项对应的本地日期范围。
+     * @returns 每次调用时创建的新元组；起点为 `00:00:00.000`，终点为 `23:59:59.999`。
+     */
+    value: () => [start: Date, end: Date];
+}
+/**
+ * 把日期转换为固定中文相对时间文本。
+ *
+ * @remarks 10 位以内数字按 Unix 秒处理，其余数字按毫秒处理；月份与年份按本地日历月差计算。
+ * @param value - Date、时间戳、可解析字符串或空值。
+ * @returns 例如“3分钟前”“半年后”；非法或空输入返回空字符串。
+ */
+export declare function formatChineseRelativeTime(value: Date | number | string | null | undefined): string;
+/**
+ * 创建从今天到前后一个月日期的完整本地日范围。
+ *
+ * @param towardFuture - `true` 返回今天至一个月后，默认返回一个月前至今天。
+ * @returns 每次调用新建的本地日首尾边界。
+ */
+export declare function createOneMonthRangeFromToday(towardFuture?: boolean): [start: Date, end: Date];
+/**
+ * 创建面向过去或未来的常用完整日期范围快捷项。
+ *
+ * @param towardFuture - `true` 创建未来范围，默认创建历史范围。
+ * @returns 每次求值都会重新读取当前时间的范围快捷项。
+ */
+export declare function createDateRangeShortcuts(towardFuture?: boolean): DateRangeShortcut[];
+/**
+ * 创建面向过去或未来的常用单日期快捷项。
+ *
+ * @param towardFuture - `true` 创建未来日期，默认创建历史日期。
+ * @returns 每次求值都会重新读取当前时间的单日期快捷项。
+ */
+export declare function createDateShortcuts(towardFuture?: boolean): DateShortcut[];
+/**
+ * 返回今天的本地零点。
+ *
+ * @returns 新建的 `00:00:00.000` Date。
+ */
+export declare function getStartOfToday(): Date;

package/dist/utils/date/index.mjs

@@ -0,0 +1,190 @@
+//#region src/utils/date/index.ts
+/**
+* 转换并克隆有效日期。
+*
+* @remarks 数字不进行秒/毫秒猜测；字符串遵循运行时 `Date` 解析规则，跨平台代码应传带显式时区的完整 ISO 8601。
+* @param value - Date、Unix 毫秒时间戳或运行时可解析字符串。
+* @returns 与输入不共享可变状态的新 Date。
+* @throws 输入无效时抛出 `TypeError`。
+*/
+function toDate(value) {
+	const date = value instanceof Date ? new Date(value.getTime()) : new Date(value);
+	if (!Number.isFinite(date.getTime())) throw new TypeError("该值不是有效日期。");
+	return date;
+}
+/**
+* 返回输入日期所在本地时区日期的 `00:00:00.000`，不修改输入。
+*
+* @param value - 有效日期输入。
+* @returns 新建的本地日开始时间。
+* @throws 输入无效时抛出 `TypeError`。
+*/
+function startOfDay(value) {
+	const date = toDate(value);
+	date.setHours(0, 0, 0, 0);
+	return toDate(date);
+}
+/**
+* 移动本地日历字段。
+*
+* @remarks 直接使用 Date Setter，以保留历史快捷项在月底和闰年的溢出语义。
+* @param date - 会被原地修改的日期。
+* @param amount - 对目标字段增加的整数。
+* @param unit - 要移动的日历字段。
+*/
+const shiftCalendarFieldInPlace = (date, amount, unit) => {
+	switch (unit) {
+		case "day":
+			date.setDate(date.getDate() + amount);
+			break;
+		case "month":
+			date.setMonth(date.getMonth() + amount);
+			break;
+		case "year": date.setFullYear(date.getFullYear() + amount);
+	}
+};
+/**
+* 创建动态单日期快捷项。
+*
+* @param text - 日期选择器显示文本。
+* @param amount - 相对当前时间的移动量。
+* @param unit - 移动使用的日历单位。
+* @returns 每次执行 `value` 都重新读取当前时间的快捷项。
+*/
+const createDateShortcut = (text, amount, unit) => ({
+	text,
+	value: () => {
+		const date = /* @__PURE__ */ new Date();
+		shiftCalendarFieldInPlace(date, amount, unit);
+		date.setHours(0, 0, 0, 0);
+		return date;
+	}
+});
+/**
+* 创建动态日期范围快捷项。
+*
+* @param text - 日期选择器显示文本。
+* @param amount - 范围边界相对当前时间的移动量。
+* @param unit - 移动使用的日历单位。
+* @param towardFuture - `true` 移动结束边界，`false` 移动开始边界。
+* @returns 每次求值都覆盖完整本地日边界的范围快捷项。
+*/
+const createRangeShortcut = (text, amount, unit, towardFuture) => ({
+	text,
+	value: () => {
+		const start = /* @__PURE__ */ new Date();
+		const end = /* @__PURE__ */ new Date();
+		shiftCalendarFieldInPlace(towardFuture ? end : start, towardFuture ? amount : -amount, unit);
+		start.setHours(0, 0, 0, 0);
+		end.setHours(23, 59, 59, 999);
+		return [start, end];
+	}
+});
+/**
+* 把日期转换为固定中文相对时间文本。
+*
+* @remarks 10 位以内数字按 Unix 秒处理，其余数字按毫秒处理；月份与年份按本地日历月差计算。
+* @param value - Date、时间戳、可解析字符串或空值。
+* @returns 例如“3分钟前”“半年后”；非法或空输入返回空字符串。
+*/
+function formatChineseRelativeTime(value) {
+	if (value === null || value === void 0) return "";
+	let timestamp;
+	if (typeof value === "string") timestamp = new Date(value).getTime();
+	else if (typeof value === "number") timestamp = value.toString().length <= 10 ? value * 1e3 : value;
+	else timestamp = value.getTime();
+	if (!Number.isFinite(timestamp)) return "";
+	const minute = 6e4;
+	const hour = minute * 60;
+	const day = hour * 24;
+	const currentTimestamp = Date.now();
+	const difference = currentTimestamp - timestamp;
+	const minuteDifference = Math.abs(difference) / minute;
+	const hourDifference = Math.abs(difference) / hour;
+	const dayDifference = Math.abs(difference) / day;
+	const currentDate = new Date(currentTimestamp);
+	const targetDate = new Date(timestamp);
+	const monthDifference = (currentDate.getFullYear() - targetDate.getFullYear()) * 12 + currentDate.getMonth() - targetDate.getMonth();
+	const suffix = difference < 0 ? "后" : "前";
+	if (Math.abs(monthDifference) >= 12) return `${Math.floor(Math.abs(monthDifference) / 12)}年${suffix}`;
+	if (Math.abs(monthDifference) >= 6) return `半年${suffix}`;
+	if (Math.abs(monthDifference) >= 1) return `${Math.abs(monthDifference)}月${suffix}`;
+	if (dayDifference >= 15) return `半月${suffix}`;
+	if (dayDifference >= 7) return `${Math.floor(dayDifference / 7)}周${suffix}`;
+	if (dayDifference >= 1) return `${Math.floor(dayDifference)}天${suffix}`;
+	if (hourDifference >= 1) return `${Math.floor(hourDifference)}小时${suffix}`;
+	if (minuteDifference >= 1) return `${Math.floor(minuteDifference)}分钟${suffix}`;
+	return "刚刚";
+}
+/**
+* 创建从今天到前后一个月日期的完整本地日范围。
+*
+* @param towardFuture - `true` 返回今天至一个月后，默认返回一个月前至今天。
+* @returns 每次调用新建的本地日首尾边界。
+*/
+function createOneMonthRangeFromToday(towardFuture = false) {
+	const start = /* @__PURE__ */ new Date();
+	const end = /* @__PURE__ */ new Date();
+	shiftCalendarFieldInPlace(towardFuture ? end : start, towardFuture ? 1 : -1, "month");
+	start.setHours(0, 0, 0, 0);
+	end.setHours(23, 59, 59, 999);
+	return [start, end];
+}
+/**
+* 创建面向过去或未来的常用完整日期范围快捷项。
+*
+* @param towardFuture - `true` 创建未来范围，默认创建历史范围。
+* @returns 每次求值都会重新读取当前时间的范围快捷项。
+*/
+function createDateRangeShortcuts(towardFuture = false) {
+	return towardFuture ? [
+		createRangeShortcut("后1天", 1, "day", true),
+		createRangeShortcut("后3天", 3, "day", true),
+		createRangeShortcut("后1周", 7, "day", true),
+		createRangeShortcut("后1月", 1, "month", true),
+		createRangeShortcut("后3月", 3, "month", true),
+		createRangeShortcut("后6月", 6, "month", true),
+		createRangeShortcut("后1年", 1, "year", true)
+	] : [
+		createRangeShortcut("近1天", 1, "day", false),
+		createRangeShortcut("近3天", 3, "day", false),
+		createRangeShortcut("近1周", 7, "day", false),
+		createRangeShortcut("近1月", 1, "month", false),
+		createRangeShortcut("近3月", 3, "month", false),
+		createRangeShortcut("近6月", 6, "month", false),
+		createRangeShortcut("近1年", 1, "year", false)
+	];
+}
+/**
+* 创建面向过去或未来的常用单日期快捷项。
+*
+* @param towardFuture - `true` 创建未来日期，默认创建历史日期。
+* @returns 每次求值都会重新读取当前时间的单日期快捷项。
+*/
+function createDateShortcuts(towardFuture = false) {
+	return towardFuture ? [
+		createDateShortcut("今天", 0, "day"),
+		createDateShortcut("明天", 1, "day"),
+		createDateShortcut("一周后", 7, "day"),
+		createDateShortcut("一月后", 1, "month"),
+		createDateShortcut("一年后", 1, "year")
+	] : [
+		createDateShortcut("今天", 0, "day"),
+		createDateShortcut("昨天", -1, "day"),
+		createDateShortcut("一周前", -7, "day"),
+		createDateShortcut("一月前", -1, "month"),
+		createDateShortcut("一年前", -1, "year")
+	];
+}
+/**
+* 返回今天的本地零点。
+*
+* @returns 新建的 `00:00:00.000` Date。
+*/
+function getStartOfToday() {
+	return startOfDay(/* @__PURE__ */ new Date());
+}
+//#endregion
+export { createDateRangeShortcuts, createDateShortcuts, createOneMonthRangeFromToday, formatChineseRelativeTime, getStartOfToday, startOfDay, toDate };
+
+//# sourceMappingURL=index.mjs.map

package/dist/utils/date/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/utils/date/index.ts"],"sourcesContent":["/** 可转换为日期的输入；数字始终按 Unix 毫秒时间戳处理。 */\nexport type DateInput = Date | number | string;\n\n/**\n * 转换并克隆有效日期。\n *\n * @remarks 数字不进行秒/毫秒猜测；字符串遵循运行时 `Date` 解析规则，跨平台代码应传带显式时区的完整 ISO 8601。\n * @param value - Date、Unix 毫秒时间戳或运行时可解析字符串。\n * @returns 与输入不共享可变状态的新 Date。\n * @throws 输入无效时抛出 `TypeError`。\n */\nexport function toDate(value: DateInput): Date {\n\tconst date = value instanceof Date ? new Date(value.getTime()) : new Date(value);\n\tif (!Number.isFinite(date.getTime())) {\n\t\tthrow new TypeError(\"该值不是有效日期。\");\n\t}\n\treturn date;\n}\n\n/**\n * 返回输入日期所在本地时区日期的 `00:00:00.000`，不修改输入。\n *\n * @param value - 有效日期输入。\n * @returns 新建的本地日开始时间。\n * @throws 输入无效时抛出 `TypeError`。\n */\nexport function startOfDay(value: DateInput): Date {\n\tconst date = toDate(value);\n\tdate.setHours(0, 0, 0, 0);\n\treturn toDate(date);\n}\n\n/** 日期选择器单日期快捷项。 */\nexport interface DateShortcut {\n\t/** 面向中文日期选择器的显示文本；调用方可直接用于菜单标签。 */\n\ttext: string;\n\t/**\n\t * 计算快捷项对应日期。\n\t * @returns 每次调用时基于当前本地时间创建的新 `Date`，调用方可安全修改。\n\t */\n\tvalue: () => Date;\n}\n\n/** 日期选择器范围快捷项。 */\nexport interface DateRangeShortcut {\n\t/** 面向中文日期范围选择器的显示文本；调用方可直接用于菜单标签。 */\n\ttext: string;\n\t/**\n\t * 计算快捷项对应的本地日期范围。\n\t * @returns 每次调用时创建的新元组；起点为 `00:00:00.000`，终点为 `23:59:59.999`。\n\t */\n\tvalue: () => [start: Date, end: Date];\n}\n\n/** 历史快捷项允许移动的本地日历单位。 */\ntype CalendarUnit = \"day\" | \"month\" | \"year\";\n\n/**\n * 移动本地日历字段。\n *\n * @remarks 直接使用 Date Setter，以保留历史快捷项在月底和闰年的溢出语义。\n * @param date - 会被原地修改的日期。\n * @param amount - 对目标字段增加的整数。\n * @param unit - 要移动的日历字段。\n */\nconst shiftCalendarFieldInPlace = (date: Date, amount: number, unit: CalendarUnit): void => {\n\tswitch (unit) {\n\t\tcase \"day\":\n\t\t\tdate.setDate(date.getDate() + amount);\n\t\t\tbreak;\n\t\tcase \"month\":\n\t\t\tdate.setMonth(date.getMonth() + amount);\n\t\t\tbreak;\n\t\tcase \"year\":\n\t\t\tdate.setFullYear(date.getFullYear() + amount);\n\t\t\tbreak;\n\t}\n};\n\n/**\n * 创建动态单日期快捷项。\n *\n * @param text - 日期选择器显示文本。\n * @param amount - 相对当前时间的移动量。\n * @param unit - 移动使用的日历单位。\n * @returns 每次执行 `value` 都重新读取当前时间的快捷项。\n */\nconst createDateShortcut = (text: string, amount: number, unit: CalendarUnit): DateShortcut => ({\n\ttext,\n\tvalue: (): Date => {\n\t\tconst date = new Date();\n\t\tshiftCalendarFieldInPlace(date, amount, unit);\n\t\tdate.setHours(0, 0, 0, 0);\n\t\treturn date;\n\t},\n});\n\n/**\n * 创建动态日期范围快捷项。\n *\n * @param text - 日期选择器显示文本。\n * @param amount - 范围边界相对当前时间的移动量。\n * @param unit - 移动使用的日历单位。\n * @param towardFuture - `true` 移动结束边界，`false` 移动开始边界。\n * @returns 每次求值都覆盖完整本地日边界的范围快捷项。\n */\nconst createRangeShortcut = (text: string, amount: number, unit: CalendarUnit, towardFuture: boolean): DateRangeShortcut => ({\n\ttext,\n\tvalue: (): [Date, Date] => {\n\t\tconst start = new Date();\n\t\tconst end = new Date();\n\t\tshiftCalendarFieldInPlace(towardFuture ? end : start, towardFuture ? amount : -amount, unit);\n\t\tstart.setHours(0, 0, 0, 0);\n\t\tend.setHours(23, 59, 59, 999);\n\t\treturn [start, end];\n\t},\n});\n\n/**\n * 把日期转换为固定中文相对时间文本。\n *\n * @remarks 10 位以内数字按 Unix 秒处理，其余数字按毫秒处理；月份与年份按本地日历月差计算。\n * @param value - Date、时间戳、可解析字符串或空值。\n * @returns 例如“3分钟前”“半年后”；非法或空输入返回空字符串。\n */\nexport function formatChineseRelativeTime(value: Date | number | string | null | undefined): string {\n\tif (value === null || value === undefined) return \"\";\n\tlet timestamp: number;\n\tif (typeof value === \"string\") timestamp = new Date(value).getTime();\n\telse if (typeof value === \"number\") timestamp = value.toString().length <= 10 ? value * 1000 : value;\n\telse timestamp = value.getTime();\n\tif (!Number.isFinite(timestamp)) return \"\";\n\n\tconst minute = 60_000;\n\tconst hour = minute * 60;\n\tconst day = hour * 24;\n\tconst currentTimestamp = Date.now();\n\tconst difference = currentTimestamp - timestamp;\n\tconst minuteDifference = Math.abs(difference) / minute;\n\tconst hourDifference = Math.abs(difference) / hour;\n\tconst dayDifference = Math.abs(difference) / day;\n\tconst currentDate = new Date(currentTimestamp);\n\tconst targetDate = new Date(timestamp);\n\tconst monthDifference = (currentDate.getFullYear() - targetDate.getFullYear()) * 12 + currentDate.getMonth() - targetDate.getMonth();\n\tconst suffix = difference < 0 ? \"后\" : \"前\";\n\tif (Math.abs(monthDifference) >= 12) return `${Math.floor(Math.abs(monthDifference) / 12)}年${suffix}`;\n\tif (Math.abs(monthDifference) >= 6) return `半年${suffix}`;\n\tif (Math.abs(monthDifference) >= 1) return `${Math.abs(monthDifference)}月${suffix}`;\n\tif (dayDifference >= 15) return `半月${suffix}`;\n\tif (dayDifference >= 7) return `${Math.floor(dayDifference / 7)}周${suffix}`;\n\tif (dayDifference >= 1) return `${Math.floor(dayDifference)}天${suffix}`;\n\tif (hourDifference >= 1) return `${Math.floor(hourDifference)}小时${suffix}`;\n\tif (minuteDifference >= 1) return `${Math.floor(minuteDifference)}分钟${suffix}`;\n\treturn \"刚刚\";\n}\n\n/**\n * 创建从今天到前后一个月日期的完整本地日范围。\n *\n * @param towardFuture - `true` 返回今天至一个月后，默认返回一个月前至今天。\n * @returns 每次调用新建的本地日首尾边界。\n */\nexport function createOneMonthRangeFromToday(towardFuture = false): [start: Date, end: Date] {\n\tconst start = new Date();\n\tconst end = new Date();\n\tshiftCalendarFieldInPlace(towardFuture ? end : start, towardFuture ? 1 : -1, \"month\");\n\tstart.setHours(0, 0, 0, 0);\n\tend.setHours(23, 59, 59, 999);\n\treturn [start, end];\n}\n\n/**\n * 创建面向过去或未来的常用完整日期范围快捷项。\n *\n * @param towardFuture - `true` 创建未来范围，默认创建历史范围。\n * @returns 每次求值都会重新读取当前时间的范围快捷项。\n */\nexport function createDateRangeShortcuts(towardFuture = false): DateRangeShortcut[] {\n\treturn towardFuture\n\t\t? [\n\t\t\t\tcreateRangeShortcut(\"后1天\", 1, \"day\", true),\n\t\t\t\tcreateRangeShortcut(\"后3天\", 3, \"day\", true),\n\t\t\t\tcreateRangeShortcut(\"后1周\", 7, \"day\", true),\n\t\t\t\tcreateRangeShortcut(\"后1月\", 1, \"month\", true),\n\t\t\t\tcreateRangeShortcut(\"后3月\", 3, \"month\", true),\n\t\t\t\tcreateRangeShortcut(\"后6月\", 6, \"month\", true),\n\t\t\t\tcreateRangeShortcut(\"后1年\", 1, \"year\", true),\n\t\t\t]\n\t\t: [\n\t\t\t\tcreateRangeShortcut(\"近1天\", 1, \"day\", false),\n\t\t\t\tcreateRangeShortcut(\"近3天\", 3, \"day\", false),\n\t\t\t\tcreateRangeShortcut(\"近1周\", 7, \"day\", false),\n\t\t\t\tcreateRangeShortcut(\"近1月\", 1, \"month\", false),\n\t\t\t\tcreateRangeShortcut(\"近3月\", 3, \"month\", false),\n\t\t\t\tcreateRangeShortcut(\"近6月\", 6, \"month\", false),\n\t\t\t\tcreateRangeShortcut(\"近1年\", 1, \"year\", false),\n\t\t\t];\n}\n\n/**\n * 创建面向过去或未来的常用单日期快捷项。\n *\n * @param towardFuture - `true` 创建未来日期，默认创建历史日期。\n * @returns 每次求值都会重新读取当前时间的单日期快捷项。\n */\nexport function createDateShortcuts(towardFuture = false): DateShortcut[] {\n\treturn towardFuture\n\t\t? [\n\t\t\t\tcreateDateShortcut(\"今天\", 0, \"day\"),\n\t\t\t\tcreateDateShortcut(\"明天\", 1, \"day\"),\n\t\t\t\tcreateDateShortcut(\"一周后\", 7, \"day\"),\n\t\t\t\tcreateDateShortcut(\"一月后\", 1, \"month\"),\n\t\t\t\tcreateDateShortcut(\"一年后\", 1, \"year\"),\n\t\t\t]\n\t\t: [\n\t\t\t\tcreateDateShortcut(\"今天\", 0, \"day\"),\n\t\t\t\tcreateDateShortcut(\"昨天\", -1, \"day\"),\n\t\t\t\tcreateDateShortcut(\"一周前\", -7, \"day\"),\n\t\t\t\tcreateDateShortcut(\"一月前\", -1, \"month\"),\n\t\t\t\tcreateDateShortcut(\"一年前\", -1, \"year\"),\n\t\t\t];\n}\n\n/**\n * 返回今天的本地零点。\n *\n * @returns 新建的 `00:00:00.000` Date。\n */\nexport function getStartOfToday(): Date {\n\treturn startOfDay(new Date());\n}\n"],"mappings":"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"}

package/dist/utils/dom/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 为数值或纯数字字符串添加 CSS 单位。
+ *
+ * @param value - 数字、数字字符串或已有单位的 CSS 值；空值返回空字符串。
+ * @param unit - 非零数字使用的单位，默认 `px`。
+ * @returns 零统一返回 `"0"`；非数字字符串保持原样。
+ * @throws `RangeError` 当数字非有限或单位为空。
+ */
+export declare function addCssUnit(value?: string | number | null, unit?: string): string;

package/dist/utils/dom/index.mjs

@@ -0,0 +1,35 @@
+//#region src/utils/dom/index.ts
+/**
+* 判断文本是否可按十进制数值追加 CSS 单位。
+*
+* @param value - 已去除外围空白的文本。
+* @returns 有限十进制数值返回 `true`；二、八、十六进制前缀返回 `false`。
+*/
+const isNumericString = (value) => {
+	if (value.length === 0 || !Number.isFinite(Number(value))) return false;
+	const unsigned = value.startsWith("+") || value.startsWith("-") ? value.slice(1) : value;
+	return !/^0[box]/iu.test(unsigned);
+};
+/**
+* 为数值或纯数字字符串添加 CSS 单位。
+*
+* @param value - 数字、数字字符串或已有单位的 CSS 值；空值返回空字符串。
+* @param unit - 非零数字使用的单位，默认 `px`。
+* @returns 零统一返回 `"0"`；非数字字符串保持原样。
+* @throws `RangeError` 当数字非有限或单位为空。
+*/
+function addCssUnit(value, unit = "px") {
+	if (value === null || value === void 0 || value === "") return "";
+	if (unit.length === 0) throw new RangeError("`unit` 不能为空。");
+	if (typeof value === "number") {
+		if (!Number.isFinite(value)) throw new RangeError("`value` 必须是有限数。");
+		return value === 0 ? "0" : `${value}${unit}`;
+	}
+	const trimmed = value.trim();
+	if (!isNumericString(trimmed)) return value;
+	return Number(trimmed) === 0 ? "0" : `${trimmed}${unit}`;
+}
+//#endregion
+export { addCssUnit };
+
+//# sourceMappingURL=index.mjs.map

package/dist/utils/dom/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/utils/dom/index.ts"],"sourcesContent":["/**\n * 判断文本是否可按十进制数值追加 CSS 单位。\n *\n * @param value - 已去除外围空白的文本。\n * @returns 有限十进制数值返回 `true`；二、八、十六进制前缀返回 `false`。\n */\nconst isNumericString = (value: string): boolean => {\n\tif (value.length === 0 || !Number.isFinite(Number(value))) return false;\n\tconst unsigned = value.startsWith(\"+\") || value.startsWith(\"-\") ? value.slice(1) : value;\n\treturn !/^0[box]/iu.test(unsigned);\n};\n\n/**\n * 为数值或纯数字字符串添加 CSS 单位。\n *\n * @param value - 数字、数字字符串或已有单位的 CSS 值；空值返回空字符串。\n * @param unit - 非零数字使用的单位，默认 `px`。\n * @returns 零统一返回 `\"0\"`；非数字字符串保持原样。\n * @throws `RangeError` 当数字非有限或单位为空。\n */\nexport function addCssUnit(value?: string | number | null, unit = \"px\"): string {\n\tif (value === null || value === undefined || value === \"\") return \"\";\n\tif (unit.length === 0) throw new RangeError(\"`unit` 不能为空。\");\n\tif (typeof value === \"number\") {\n\t\tif (!Number.isFinite(value)) throw new RangeError(\"`value` 必须是有限数。\");\n\t\treturn value === 0 ? \"0\" : `${value}${unit}`;\n\t}\n\tconst trimmed = value.trim();\n\tif (!isNumericString(trimmed)) return value;\n\treturn Number(trimmed) === 0 ? \"0\" : `${trimmed}${unit}`;\n}\n"],"mappings":";;;;;;;AAMA,MAAM,mBAAmB,UAA2B;CACnD,IAAI,MAAM,WAAW,KAAK,CAAC,OAAO,SAAS,OAAO,KAAK,CAAC,GAAG,OAAO;CAClE,MAAM,WAAW,MAAM,WAAW,GAAG,KAAK,MAAM,WAAW,GAAG,IAAI,MAAM,MAAM,CAAC,IAAI;CACnF,OAAO,CAAC,YAAY,KAAK,QAAQ;AAClC;;;;;;;;;AAUA,SAAgB,WAAW,OAAgC,OAAO,MAAc;CAC/E,IAAI,UAAU,QAAQ,UAAU,KAAA,KAAa,UAAU,IAAI,OAAO;CAClE,IAAI,KAAK,WAAW,GAAG,MAAM,IAAI,WAAW,cAAc;CAC1D,IAAI,OAAO,UAAU,UAAU;EAC9B,IAAI,CAAC,OAAO,SAAS,KAAK,GAAG,MAAM,IAAI,WAAW,iBAAiB;EACnE,OAAO,UAAU,IAAI,MAAM,GAAG,QAAQ;CACvC;CACA,MAAM,UAAU,MAAM,KAAK;CAC3B,IAAI,CAAC,gBAAgB,OAAO,GAAG,OAAO;CACtC,OAAO,OAAO,OAAO,MAAM,IAAI,MAAM,GAAG,UAAU;AACnD"}

package/dist/utils/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Fast.Element.Plus 内部工具聚合入口。
+ *
+ * @packageDocumentation
+ */
+export * from "./async";
+export * from "./date";
+export * from "./dom";
+export * from "./string";
+export * from "./vue";