@epxing/utils 0.0.0-stage → 5.3.0-beta.1

package/dist/src/moment-compat.js

@@ -0,0 +1,558 @@
+import dayjs from "dayjs";
+import "dayjs/locale/zh-cn.js";
+import relativeTime from "dayjs/plugin/relativeTime.js";
+import duration from "dayjs/plugin/duration.js";
+import customParseFormat from "dayjs/plugin/customParseFormat.js";
+import advancedFormat from "dayjs/plugin/advancedFormat.js";
+import localizedFormat from "dayjs/plugin/localizedFormat.js";
+import calendarPlugin from "dayjs/plugin/calendar.js";
+import objectSupport from "dayjs/plugin/objectSupport.js";
+import arraySupport from "dayjs/plugin/arraySupport.js";
+import utcPlugin from "dayjs/plugin/utc.js";
+import minMax from "dayjs/plugin/minMax.js";
+import isSameOrBefore from "dayjs/plugin/isSameOrBefore.js";
+import isSameOrAfter from "dayjs/plugin/isSameOrAfter.js";
+import isBetween from "dayjs/plugin/isBetween.js";
+import isLeapYear from "dayjs/plugin/isLeapYear.js";
+import weekOfYear from "dayjs/plugin/weekOfYear.js";
+import isoWeek from "dayjs/plugin/isoWeek.js";
+import quarterOfYear from "dayjs/plugin/quarterOfYear.js";
+import dayOfYear from "dayjs/plugin/dayOfYear.js";
+import weekday from "dayjs/plugin/weekday.js";
+import toArray from "dayjs/plugin/toArray.js";
+import toObject from "dayjs/plugin/toObject.js";
+for (const p of [
+  relativeTime,
+  duration,
+  customParseFormat,
+  advancedFormat,
+  localizedFormat,
+  calendarPlugin,
+  arraySupport,
+  utcPlugin,
+  minMax,
+  isSameOrBefore,
+  isSameOrAfter,
+  isBetween,
+  isLeapYear,
+  weekOfYear,
+  isoWeek,
+  quarterOfYear,
+  dayOfYear,
+  weekday,
+  toArray,
+  toObject,
+  objectSupport
+]) {
+  dayjs.extend(p);
+}
+dayjs.locale("zh-cn");
+dayjs.Ls["zh-cn"].relativeTime.future = "%s后";
+dayjs.Ls["zh-cn"].meridiem = (hour, minute) => {
+  const hm = hour * 100 + minute;
+  if (hm < 600) return "凌晨";
+  if (hm < 900) return "早上";
+  if (hm < 1130) return "上午";
+  if (hm < 1230) return "中午";
+  if (hm < 1800) return "下午";
+  return "晚上";
+};
+dayjs.Ls["zh-cn"].calendar = {
+  sameDay: "[今天]LT",
+  nextDay: "[明天]LT",
+  nextWeek(now) {
+    return this.format(now.week() !== this.week() ? "[下]dddLT" : "[本]dddLT");
+  },
+  lastDay: "[昨天]LT",
+  lastWeek(now) {
+    return this.format(this.week() !== now.week() ? "[上]dddLT" : "[本]dddLT");
+  },
+  sameElse: "L"
+};
+const READ_METHODS = [
+  "format",
+  "valueOf",
+  "unix",
+  "toDate",
+  "toISOString",
+  "toJSON",
+  "toString",
+  "toArray",
+  "toObject",
+  "diff",
+  "isValid",
+  "isBefore",
+  "isAfter",
+  "isSame",
+  "isSameOrBefore",
+  "isSameOrAfter",
+  "isBetween",
+  "isLeapYear",
+  "daysInMonth",
+  "clone",
+  "get",
+  "from",
+  "to",
+  "fromNow",
+  "toNow",
+  "utcOffset",
+  "weekday",
+  "isoWeekday",
+  // `calendar` 是本仓自己的页面 JS 编写指南（.claude/skills/epx-frame-web/tools/Moment日期.md）
+  // 教过的写法，漏了它等于指南里的示例一跑就抛错。
+  "calendar"
+];
+const WRITE_METHODS = [
+  "add",
+  "subtract",
+  "startOf",
+  "endOf",
+  "set",
+  "local",
+  "utc",
+  "locale",
+  "year",
+  "month",
+  "date",
+  "day",
+  "hour",
+  "minute",
+  "second",
+  "millisecond",
+  "quarter",
+  "week",
+  "isoWeek",
+  "dayOfYear"
+];
+const DUAL_METHODS = /* @__PURE__ */ new Set([
+  "locale",
+  "year",
+  "month",
+  "date",
+  "day",
+  "hour",
+  "minute",
+  "second",
+  "millisecond",
+  "quarter",
+  "week",
+  "isoWeek",
+  "dayOfYear"
+]);
+const PASSTHROUGH = /* @__PURE__ */ new Set([
+  "then",
+  "nodeType",
+  "tagName",
+  "length",
+  "name",
+  "constructor",
+  "hasOwnProperty",
+  "isPrototypeOf",
+  "propertyIsEnumerable",
+  "__v_isRef",
+  "__v_isReactive",
+  "__v_isReadonly",
+  "__v_raw",
+  "__v_skip",
+  "_isAMomentObject",
+  "_d",
+  "$$typeof"
+]);
+class MomentLike {
+  constructor(d) {
+    this._d = d;
+    this.__v_skip = true;
+    this._isAMomentObject = true;
+  }
+}
+function wrapMaybe(v) {
+  return dayjs.isDayjs(v) ? createMoment(v) : v;
+}
+function unwrapMaybe(v) {
+  return v && v._d ? v._d : v;
+}
+for (const name of READ_METHODS) {
+  MomentLike.prototype[name] = function(...args) {
+    return wrapMaybe(this._d[name](...args.map(unwrapMaybe)));
+  };
+}
+const INVALID = "Invalid date";
+const INVALID_FALLBACKS = {
+  toISOString: null,
+  isoWeekday: NaN,
+  calendar: INVALID,
+  from: INVALID,
+  to: INVALID,
+  fromNow: INVALID,
+  toNow: INVALID
+};
+const CHECKS_ARG = /* @__PURE__ */ new Set(["from", "to"]);
+for (const [name, fallback] of Object.entries(INVALID_FALLBACKS)) {
+  const raw = MomentLike.prototype[name];
+  MomentLike.prototype[name] = function(...args) {
+    if (!this._d.isValid()) return fallback;
+    if (CHECKS_ARG.has(name) && args[0] !== void 0) {
+      const other = unwrapMaybe(args[0]);
+      if (!dayjs(other).isValid()) return fallback;
+    }
+    return raw.apply(this, args);
+  };
+}
+const UNSUPPORTED_FORMAT_TOKENS = [
+  "DDDo",
+  "DDDD",
+  "DDD",
+  "Mo",
+  "Qo",
+  "do",
+  "Wo",
+  "gggg",
+  "gg",
+  "GG",
+  "NN",
+  "N",
+  "zz",
+  "z",
+  "E",
+  "e"
+];
+const FORMAT_SCAN_RE = new RegExp(
+  ["\\[[^\\]]*\\]", "LTS", "GGGG", ...UNSUPPORTED_FORMAT_TOKENS, "S+", "y{1,4}"].join("|"),
+  "g"
+);
+function preprocessFormat(fmt, ms, year) {
+  if (typeof fmt !== "string") return fmt;
+  return fmt.replace(FORMAT_SCAN_RE, (seg) => {
+    if (seg[0] === "[" || seg === "LTS" || seg === "GGGG") return seg;
+    if (seg[0] === "S") {
+      if (seg.length === 3) return seg;
+      if (seg.length === 1) return String(Math.floor(ms / 100));
+      if (seg.length === 2) return String(Math.floor(ms / 10)).padStart(2, "0");
+      return String(ms).padStart(3, "0").padEnd(seg.length, "0");
+    }
+    if (seg[0] === "y") {
+      const sign = year < 0 ? "-" : "";
+      return sign + String(Math.abs(year)).padStart(seg.length, "0");
+    }
+    throw new Error(
+      `[epx-moment] format 串里的 \`${seg}\` 不在兼容层覆盖范围内。
+  本平台已从 moment 迁移到 dayjs，$moment 是一层兼容 shim。
+  dayjs 对这个 token 会静默给出错值（或抛一个读不懂的内部错），所以这里主动拦下——
+  想输出字面量 "${seg}" 请写成 [${seg}]（方括号是 moment/dayjs 通用的转义）。
+  确实需要这个 token 请补进 packages/utils/src/moment-compat.js；
+  临时可用 $moment(x).toDate() 拿到原生 Date 自行处理。`
+    );
+  });
+}
+MomentLike.prototype.format = function(fmt) {
+  if (!this._d.isValid()) return INVALID;
+  return this._d.format(preprocessFormat(fmt, this._d.millisecond(), this._d.year()));
+};
+MomentLike.prototype.toString = function() {
+  if (!this._d.isValid()) return INVALID;
+  return this._d.locale("en").format("ddd MMM DD YYYY HH:mm:ss [GMT]ZZ");
+};
+for (const name of WRITE_METHODS) {
+  MomentLike.prototype[name] = function(...args) {
+    if (DUAL_METHODS.has(name) && args.length === 0) return this._d[name]();
+    this._d = this._d[name](...args.map(unwrapMaybe));
+    return this;
+  };
+}
+const UNIT_ALIASES = {
+  D: "date",
+  dates: "date",
+  date: "date",
+  d: "day",
+  days: "day",
+  day: "day",
+  e: "weekday",
+  weekdays: "weekday",
+  weekday: "weekday",
+  E: "isoWeekday",
+  isoweekdays: "isoWeekday",
+  isoweekday: "isoWeekday",
+  DDD: "dayOfYear",
+  dayofyears: "dayOfYear",
+  dayofyear: "dayOfYear",
+  h: "hour",
+  hours: "hour",
+  hour: "hour",
+  ms: "millisecond",
+  milliseconds: "millisecond",
+  millisecond: "millisecond",
+  m: "minute",
+  minutes: "minute",
+  minute: "minute",
+  M: "month",
+  months: "month",
+  month: "month",
+  Q: "quarter",
+  quarters: "quarter",
+  quarter: "quarter",
+  s: "second",
+  seconds: "second",
+  second: "second",
+  w: "week",
+  weeks: "week",
+  week: "week",
+  W: "isoWeek",
+  isoweeks: "isoWeek",
+  isoweek: "isoWeek",
+  y: "year",
+  years: "year",
+  year: "year"
+};
+const UNIT_PRIORITY = {
+  year: 1,
+  dayOfYear: 4,
+  week: 5,
+  isoWeek: 5,
+  quarter: 7,
+  month: 8,
+  date: 9,
+  day: 11,
+  weekday: 11,
+  isoWeekday: 11,
+  hour: 13,
+  minute: 14,
+  second: 15,
+  millisecond: 16
+};
+const UNIT_SETTER = {
+  year: (d, v) => d.year(v),
+  month: (d, v) => d.month(v),
+  date: (d, v) => d.date(v),
+  day: (d, v) => d.day(v),
+  weekday: (d, v) => d.weekday(v),
+  isoWeekday: (d, v) => d.isoWeekday(v),
+  hour: (d, v) => d.hour(v),
+  minute: (d, v) => d.minute(v),
+  second: (d, v) => d.second(v),
+  millisecond: (d, v) => d.millisecond(v),
+  quarter: (d, v) => d.quarter(v),
+  week: (d, v) => d.week(v),
+  isoWeek: (d, v) => d.isoWeek(v),
+  dayOfYear: (d, v) => d.dayOfYear(v)
+};
+MomentLike.prototype.set = function(unit, value) {
+  if (unit === null || typeof unit !== "object") {
+    this._d = this._d.set(unit, value);
+    return this;
+  }
+  const pending = [];
+  for (const key of Object.keys(unit)) {
+    const u = UNIT_ALIASES[key] || UNIT_ALIASES[String(key).toLowerCase()];
+    if (u) pending.push([u, unit[key]]);
+  }
+  pending.sort((a, b) => UNIT_PRIORITY[a[0]] - UNIT_PRIORITY[b[0]]);
+  for (const [u, v] of pending) this._d = UNIT_SETTER[u](this._d, v);
+  return this;
+};
+const ALLOWED = /* @__PURE__ */ new Set([...READ_METHODS, ...WRITE_METHODS]);
+function createMoment(input, ...rest) {
+  let d;
+  if (arguments.length === 0) d = dayjs();
+  else if (input && input._d) d = input._d;
+  else if (dayjs.isDayjs(input)) d = input;
+  else d = dayjs(input, ...rest);
+  const inst = new MomentLike(d);
+  return new Proxy(inst, {
+    get(target, prop, receiver) {
+      if (typeof prop === "symbol") return Reflect.get(target, prop, receiver);
+      if (ALLOWED.has(prop) || PASSTHROUGH.has(prop) || Object.prototype.hasOwnProperty.call(target, prop)) {
+        return Reflect.get(target, prop, receiver);
+      }
+      throw new Error(
+        `[epx-moment] \`$moment(...).${prop}\` 不在兼容层覆盖范围内。
+  本平台已从 moment 迁移到 dayjs，$moment 是一层兼容 shim。
+  需要这个 API 请补进 packages/utils/src/moment-compat.js；
+  临时可用 $moment(x).toDate() 拿到原生 Date 自行处理。`
+      );
+    }
+  });
+}
+const DURATION_THRESHOLDS = { ss: 44, s: 45, m: 45, h: 22, d: 26, M: 11 };
+const daysToMonths = (days) => days * 4800 / 146097;
+const monthsToDays = (months) => months * 146097 / 4800;
+function durationBuckets(d) {
+  const b = d.$d || {};
+  const ms = d.$ms || 0;
+  const exact = !b.days && !b.hours && !b.minutes && !b.seconds && !b.milliseconds && !b.weeks && (b.years || b.months);
+  return exact ? { ms: 0, months: (b.years || 0) * 12 + (b.months || 0) } : { ms, months: 0 };
+}
+function durationAs(d, unit) {
+  const { ms, months } = durationBuckets(d);
+  if (unit === "month" || unit === "quarter" || unit === "year") {
+    const m = months + daysToMonths(ms / 864e5);
+    return unit === "month" ? m : unit === "quarter" ? m / 3 : m / 12;
+  }
+  const days = Math.round(monthsToDays(months));
+  switch (unit) {
+    case "week":
+      return days / 7 + ms / 6048e5;
+    case "day":
+      return days + ms / 864e5;
+    case "hour":
+      return days * 24 + ms / 36e5;
+    case "minute":
+      return days * 1440 + ms / 6e4;
+    case "second":
+      return days * 86400 + ms / 1e3;
+    case "millisecond":
+      return Math.floor(days * 864e5) + ms;
+    // ⚠️ 不要把这个 default 写成"当毫秒处理"——那就是本次要消灭的那种静默错值
+    // （`as('bogus')` 会安静地返回一个毫秒数）。moment 在这里也是抛 `Unknown unit`。
+    default:
+      throw new Error(
+        `[epx-moment] \`$moment.duration(...).as('${unit}')\` 的单位无法识别。
+  可用单位：ms/s/m/h/d/w/M/Q/y（或它们的完整名，大小写敏感：M=月、m=分钟）。`
+      );
+  }
+}
+const DURATION_UNITS = {
+  ms: "millisecond",
+  millisecond: "millisecond",
+  milliseconds: "millisecond",
+  s: "second",
+  second: "second",
+  seconds: "second",
+  m: "minute",
+  minute: "minute",
+  minutes: "minute",
+  h: "hour",
+  hour: "hour",
+  hours: "hour",
+  d: "day",
+  day: "day",
+  days: "day",
+  w: "week",
+  week: "week",
+  weeks: "week",
+  M: "month",
+  month: "month",
+  months: "month",
+  Q: "quarter",
+  quarter: "quarter",
+  quarters: "quarter",
+  y: "year",
+  year: "year",
+  years: "year"
+};
+const normalizeDurationUnit = (u) => typeof u === "string" && (DURATION_UNITS[u] || DURATION_UNITS[u.toLowerCase()]) || u;
+const AS_METHODS = {
+  asMilliseconds: "millisecond",
+  asSeconds: "second",
+  asMinutes: "minute",
+  asHours: "hour",
+  asDays: "day",
+  asWeeks: "week",
+  asMonths: "month",
+  asQuarters: "quarter",
+  asYears: "year"
+};
+function classifyDuration(d) {
+  const abs = Math.abs(d.$ms || 0);
+  const t = DURATION_THRESHOLDS;
+  const seconds = Math.round(abs / 1e3);
+  const minutes = Math.round(abs / 6e4);
+  const hours = Math.round(abs / 36e5);
+  const days = Math.round(abs / 864e5);
+  const monthsExact = Math.abs(durationAs(d, "month"));
+  const months = Math.round(monthsExact);
+  const years = Math.round(monthsExact / 12);
+  return seconds <= t.ss && ["s", seconds] || seconds < t.s && ["ss", seconds] || minutes <= 1 && ["m", 1] || minutes < t.m && ["mm", minutes] || hours <= 1 && ["h", 1] || hours < t.h && ["hh", hours] || days <= 1 && ["d", 1] || days < t.d && ["dd", days] || months <= 1 && ["M", 1] || months < t.M && ["MM", months] || years <= 1 && ["y", 1] || ["yy", years];
+}
+function humanizeDuration(d, withSuffix) {
+  const [key, count] = classifyDuration(d);
+  const rt = dayjs.Ls[d.$l].relativeTime;
+  const text = rt[key].replace("%d", count);
+  if (!withSuffix) return text;
+  return ((d.$ms || 0) > 0 ? rt.future : rt.past).replace("%s", text);
+}
+function patchDuration(d) {
+  if (d.__patched) return d;
+  d.__patched = true;
+  d.humanize = (withSuffix) => humanizeDuration(d, withSuffix);
+  d.as = (unit) => durationAs(d, normalizeDurationUnit(unit));
+  for (const [name, unit] of Object.entries(AS_METHODS)) d[name] = () => durationAs(d, unit);
+  for (const name of ["add", "subtract", "clone", "locale"]) {
+    const raw = d[name].bind(d);
+    d[name] = (...args) => patchDuration(raw(...args));
+  }
+  return d;
+}
+const QUARTER_KEYS = ["Q", "quarter", "quarters"];
+function normalizeDurationArgs(args) {
+  const [input, unit] = args;
+  if (normalizeDurationUnit(unit) === "quarter") return [(input ?? 0) * 3, "M"];
+  if (input && typeof input === "object" && !(input instanceof Date) && !Array.isArray(input)) {
+    const q = QUARTER_KEYS.reduce((sum, k) => sum + (input[k] || 0), 0);
+    if (q) {
+      const rest = { ...input };
+      for (const k of QUARTER_KEYS) delete rest[k];
+      return [{ ...rest, months: (rest.months || 0) + q * 3 }, ...args.slice(1)];
+    }
+  }
+  return [input ?? 0, ...args.slice(1)];
+}
+createMoment.duration = (...args) => patchDuration(dayjs.duration(...normalizeDurationArgs(args)));
+createMoment.locale = (...args) => dayjs.locale(...args);
+createMoment.isMoment = (v) => !!(v && v._isAMomentObject === true);
+createMoment.unix = (sec) => createMoment(dayjs.unix(sec));
+createMoment.utc = (...args) => createMoment(dayjs.utc(...args));
+createMoment.max = (...args) => createMoment(dayjs.max(args.flat().map(unwrapMaybe)));
+createMoment.min = (...args) => createMoment(dayjs.min(args.flat().map(unwrapMaybe)));
+const STATIC_ALLOWED = /* @__PURE__ */ new Set(["duration", "locale", "isMoment", "unix", "max", "min", "utc"]);
+const STATIC_PASSTHROUGH = /* @__PURE__ */ new Set([
+  "name",
+  "length",
+  "prototype",
+  "call",
+  "apply",
+  "bind",
+  "toString",
+  "valueOf",
+  "constructor",
+  "hasOwnProperty",
+  "isPrototypeOf",
+  "propertyIsEnumerable",
+  "then",
+  "toJSON",
+  "default",
+  "__esModule",
+  "nodeType",
+  "tagName",
+  "$$typeof",
+  "__v_isRef",
+  "__v_isReactive",
+  "__v_isReadonly",
+  "__v_raw",
+  "__v_skip",
+  "_isAMomentObject"
+]);
+const momentCompat = new Proxy(createMoment, {
+  get(target, prop, receiver) {
+    if (typeof prop === "symbol") return Reflect.get(target, prop, receiver);
+    if (STATIC_ALLOWED.has(prop) || STATIC_PASSTHROUGH.has(prop)) {
+      return Reflect.get(target, prop, receiver);
+    }
+    throw new Error(
+      `[epx-moment] \`$moment.${prop}\` 不在兼容层覆盖范围内。
+  本平台已从 moment 迁移到 dayjs，$moment 是一层兼容 shim。
+  静态面只覆盖 ${[...STATIC_ALLOWED].join(" / ")}。
+  需要这个 API 请补进 packages/utils/src/moment-compat.js；
+  临时可用 $moment(x).toDate() 拿到原生 Date 自行处理。`
+    );
+  }
+});
+export {
+  DUAL_METHODS,
+  PASSTHROUGH,
+  READ_METHODS,
+  UNSUPPORTED_FORMAT_TOKENS,
+  WRITE_METHODS,
+  momentCompat as createMoment,
+  momentCompat as default,
+  preprocessFormat
+};