@zerodep-dev/vue-tsx-pro-ui 0.0.0-stage → 0.2.0

package/dist/config/lang/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","names":[],"sources":["../../../src/config/lang/format.ts"],"sourcesContent":["/**\n * 按当前语言格式化数字、金额与日期：`const format = useFormat()`，之后 `format.currency(19.9)`。\n * 格式化器按“语言 + 选项”缓存，重复调用不再新建。\n *\n * 数字的格式是 NumericFormat：Intl.NumberFormat 的选项，加上缩放与单位文字，\n * `format.number(155353.2, { scale: 10_000, maximumFractionDigits: 2, suffix: '万元' })` → `15.54 万元`。\n * 组件的数字格式属性（AnimatedNumber、Stat、图表、表格列）都是它。\n */\nimport {\n  CalendarDateTime,\n  DateFormatter,\n  getLocalTimeZone,\n  type DateValue,\n} from '@internationalized/date';\nimport type Decimal from 'decimal.js';\nimport {\n  parseIsoDate,\n  parseIsoDateTime,\n  parseIsoTime,\n  relativeUnit,\n  toInstant,\n} from '../../utils/data/date';\nimport { cachedIntl } from '../../utils/data/intl-cache';\nimport { numericText, shiftDecimal } from '../../utils/data/numeric';\nimport { useLang } from '../context';\nimport type { Lang } from './lang';\n\n/** 字符串与 Decimal 按十进制原样格式化，不经过浮点数，金额不丢精度 */\ntype NumberInput = number | bigint | string | Decimal;\n\n/** 数字的显示格式：Intl.NumberFormat 的选项，加上缩放与单位文字 */\nexport interface NumericFormat extends Intl.NumberFormatOptions {\n  /**\n   * 先除以它再显示：`10_000` 表示以“万”为单位（155353.2 → 15.53532，再按小数位取舍）。\n   * 10 的整数次幂按十进制移动小数点，Decimal 与大整数不丢精度；其他值按浮点数相除\n   */\n  scale?: number;\n  /** 跟在数字后面的单位文字，如“万元”“元/件”；与数字之间是不换行的空格 */\n  suffix?: string;\n}\n\n/** 按当前语言格式化数字、金额、百分比与日期；在渲染函数里调用方法即可随语言切换 */\nexport function useFormat() {\n  const lang = useLang();\n  return {\n    /**\n     * 数字：`format.number(1234.5)` → `1,234.5`；`{ style: 'currency' }` 不写币种时用语言的币种，\n     * 缩放与单位见 NumericFormat\n     */\n    number: (value: NumberInput, options: NumericFormat = {}) =>\n      formatNumeric(lang, value, options),\n    /** 金额，默认使用语言的币种：`format.currency(new Decimal('19.9'))` → `¥19.90` */\n    currency: (value: NumberInput, currency = lang.currency) =>\n      formatNumeric(lang, value, { style: 'currency', currency }),\n    /** 文件大小，按 1000 进位取合适的单位：`format.fileSize(1_234_567)` → `1.2 MB` */\n    fileSize: (bytes: number) => {\n      const exponent = Math.min(\n        Math.max(Math.floor(Math.log10(Math.max(bytes, 1)) / 3), 0),\n        FILE_SIZE_UNITS.length - 1,\n      );\n      return numberFormatter(lang, {\n        style: 'unit',\n        unit: FILE_SIZE_UNITS[exponent],\n        maximumFractionDigits: exponent === 0 ? 0 : 1,\n      }).format(bytes / 1000 ** exponent);\n    },\n    /**\n     * 日期时间，带上语言的时区、日历与小时制；DateValue 按语言时区换算。\n     * 也接受日期组件的 ISO 值：'2026-10-20'、'2026-10-20T14:30'、'14:30'（只有时间时配 timeStyle），\n     * 以及后端给的时刻（带 Z 或时差：'2026-10-20T06:30:00.19Z'，按语言的时区显示）；格式不对时原样返回\n     */\n    date: (\n      value: Date | DateValue | string,\n      options: Intl.DateTimeFormatOptions = { dateStyle: 'medium' },\n    ) => {\n      const parsed = typeof value === 'string' ? parseIsoValue(value) : value;\n      if (parsed == null) return value as string;\n      const date =\n        parsed instanceof Date ? parsed : parsed.toDate(lang.timeZone ?? getLocalTimeZone());\n      return dateFormatter(lang, options).format(date);\n    },\n    /**\n     * 相对现在的时间，自动取合适的单位：`format.relative(date)` → “3 分钟前”“明天”“2 年后”。\n     * 值同 date；不带时区的 ISO 值按语言的时区算。now 默认此刻（组件里随时钟更新的传进来）\n     */\n    relative: (\n      value: Date | DateValue | string,\n      { now = Date.now(), ...options }: RelativeFormatOptions = {},\n    ) => {\n      const instant = toInstant(value, lang.timeZone ?? getLocalTimeZone());\n      if (Number.isNaN(instant)) return typeof value === 'string' ? value : '';\n      const { value: amount, unit } = relativeUnit(instant - now);\n      const key = `relative|${lang.code}|${JSON.stringify(options)}`;\n      const formatter = cachedIntl(\n        key,\n        () => new Intl.RelativeTimeFormat(lang.code, { numeric: 'auto', ...options }),\n      );\n      return formatter.format(amount, unit);\n    },\n  };\n}\n\n/** format.relative 的选项 */\nexport interface RelativeFormatOptions extends Intl.RelativeTimeFormatOptions {\n  /** 以哪个时刻为“现在”（毫秒时间戳），默认此刻 */\n  now?: number;\n}\n\n// ───────── 内部实现 ─────────\n\n/** Intl 支持的文件大小单位（SI，1000 进位） */\nconst FILE_SIZE_UNITS = ['byte', 'kilobyte', 'megabyte', 'gigabyte', 'terabyte'] as const;\n\nfunction numberFormatter(lang: Lang, options: Intl.NumberFormatOptions) {\n  const key = `number|${lang.code}|${JSON.stringify(options)}`;\n  return cachedIntl(key, () => new Intl.NumberFormat(lang.code, options));\n}\n\nfunction formatNumeric(\n  lang: Lang,\n  value: NumberInput,\n  { scale, suffix, ...options }: NumericFormat,\n) {\n  if (options.style === 'currency' && !options.currency) options.currency = lang.currency;\n  const text = numberFormatter(lang, options).format(scaled(value, scale));\n  return suffix ? `${text} ${suffix}` : text;\n}\n\n/** 除以 scale：10 的整数次幂按十进制移位（精确），其他值按浮点数相除 */\nfunction scaled(value: NumberInput, scale: number | undefined) {\n  if (scale == null || scale === 1) return toIntl(value);\n  const places = Math.log10(scale);\n  if (!Number.isInteger(places)) return Number(toIntl(value)) / scale;\n  const text = typeof value === 'string' ? value.trim() : numericText(value);\n  return shiftDecimal(text, places) as Intl.StringNumericLiteral;\n}\n\nfunction dateFormatter(lang: Lang, options: Intl.DateTimeFormatOptions) {\n  const resolved: Intl.DateTimeFormatOptions = {\n    timeZone: lang.timeZone,\n    calendar: lang.calendar,\n    hourCycle: lang.hourCycle,\n    ...options,\n  };\n  const key = `date|${lang.code}|${JSON.stringify(resolved)}`;\n  return cachedIntl(key, () => new DateFormatter(lang.code, resolved));\n}\n\n/** Intl 接受数字字符串（StringNumericLiteral）；Decimal 先转成字符串 */\nfunction toIntl(value: NumberInput): number | bigint | Intl.StringNumericLiteral {\n  if (typeof value === 'object') return value.toString() as Intl.StringNumericLiteral;\n  return typeof value === 'string' ? (value as Intl.StringNumericLiteral) : value;\n}\n\n/** 带 Z 或时差的 ISO 时刻（后端给的 timestamptz） */\nconst ABSOLUTE = /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?(?:Z|[+-]\\d{2}:?\\d{2})$/;\n\n/** 日期组件的 ISO 值 → DateValue：日期、日期时间，或只有时间（放在任意一天上）；带时差的时刻 → Date */\nfunction parseIsoValue(value: string): DateValue | Date | null {\n  if (ABSOLUTE.test(value)) {\n    const instant = new Date(value);\n    return Number.isNaN(instant.getTime()) ? null : instant;\n  }\n  const time = parseIsoTime(value);\n  if (time) return new CalendarDateTime(2000, 1, 1, time.hour, time.minute, time.second);\n  return parseIsoDateTime(value) ?? parseIsoDate(value);\n}\n"],"mappings":"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"}