@u-map/common

前端通用工具、hooks 与常量库，框架无关。仅 ESM。

pnpm add @u-map/common

hooks

import { useStorage } from '@u-map/common';

const { setStorage, getStorage, removeStorage, clearAll } = useStorage(
  '',                       // key 前缀
  'sessionStorage',         // 驱动，默认 sessionStorage（也可 localStorage）
  0                         // 过期秒数，0 永不过期
);

存取自动 JSON 包装为 { [key], expires }，读取时按 expires 判过期；removeStorage() 不传 key 时清空指定前缀。

常量

import { KeyCode, HttpStatusCode } from '@u-map/common';

KeyCode.ENTER;              // 键盘码命名空间（login.vue 等依赖，勿改名）
HttpStatusCode.Ok;          // HTTP 状态码枚举

工具（命名空间导入）

import { dateutil, formatUint, math, object, xlsx } from '@u-map/common';
// 文件相关为具名导出
import { fileToBase64, downloadAs, formatBytes, isImage } from '@u-map/common';

• dateutil：DATE_PARTTEN 常用日期格式常量（YEAR/MONTH/DAY/DAYTIME/H24/SERIAL）
• formatUint：money / distance / area / squareMeterToMu（平方米转亩）/ formatNullableNumber(value, precision?, fallback?)（null/undefined/NaN → -，canvas 与表格兜底）
• math：degreeToDecimalism（度分秒转十进制度）
• object：getKeyNameObject / getKeyNameTrans / isEmptyObject 等键名转换
• 文件处理：fileToBase64、readAsText、readAsArrayBuffer、readAsDataURL、downloadAs、downloadObjAs、formatBytes、getSuffixByFileName、isImage、isMp4、enablePreviewInBrowser

依赖

零运行时依赖，可直接安装。