nfx-ui 0.20.0 → 0.22.0

package/dist/utils/domain/images.js

@@ -0,0 +1,28 @@
+import { appEnv as e } from "../../config/env.js";
+//#region src/utils/domain/images.ts
+var t = "/default-avatar.png", n = (t) => t ? t.startsWith("http://") || t.startsWith("https://") ? t : `${e.apiUrl.replace(/\/$/, "")}/asset/images/${t}/file` : "";
+function r(e) {
+	return e ? n(e) : t;
+}
+var i = (e) => n(e) || "/default-avatar.png";
+async function a(e, t = 800) {
+	return new Promise((n, r) => {
+		let i = document.createElement("canvas"), a = i.getContext("2d"), o = new Image();
+		o.onload = () => {
+			let { width: e, height: s } = o;
+			e > s ? e > t && (s = s * t / e, e = t) : s > t && (e = e * t / s, s = t), i.width = e, i.height = s, a?.drawImage(o, 0, 0, e, s), i.toBlob((e) => {
+				e ? n(e) : r(/* @__PURE__ */ Error("Failed to compress image"));
+			}, "image/png", .9);
+		}, o.onerror = () => {
+			r(/* @__PURE__ */ Error("Failed to load image"));
+		}, o.src = URL.createObjectURL(e);
+	});
+}
+async function o(e) {
+	let t = await a(e, 800);
+	return new File([t], `avatar_${Date.now()}.png`, { type: "image/png" });
+}
+//#endregion
+export { t as DEFAULT_AVATAR_SRC, r as buildAvatarImageSrc, n as buildImageUrl, o as compressImage, i as resolveAvatarSrc };
+
+//# sourceMappingURL=images.js.map

package/dist/utils/domain/images.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.js","names":[],"sources":["../../../src/utils/domain/images.ts"],"sourcesContent":["import { appEnv } from \"@/config/env\";\n\nexport const DEFAULT_AVATAR_SRC = \"/default-avatar.png\";\n\nexport const buildImageUrl = (imageId: Nilable<string>): string => {\n  if (!imageId) return \"\";\n  if (imageId.startsWith(\"http://\") || imageId.startsWith(\"https://\")) {\n    return imageId;\n  }\n  const apiBase = appEnv.apiUrl.replace(/\\/$/, \"\");\n  return `${apiBase}/asset/images/${imageId}/file`;\n};\n\nexport function buildAvatarImageSrc(avatarImageId: Nilable<string>): string {\n  return avatarImageId ? buildImageUrl(avatarImageId) : DEFAULT_AVATAR_SRC;\n}\n\nexport const resolveAvatarSrc = (imageId: Nilable<string>): string => buildImageUrl(imageId) || DEFAULT_AVATAR_SRC;\n\nasync function compressImageBlob(file: File, maxSize: number = 800): Promise<Blob> {\n  return new Promise((resolve, reject) => {\n    const canvas = document.createElement(\"canvas\");\n    const ctx = canvas.getContext(\"2d\");\n    const img = new Image();\n\n    img.onload = () => {\n      let { width, height } = img;\n\n      if (width > height) {\n        if (width > maxSize) {\n          height = (height * maxSize) / width;\n          width = maxSize;\n        }\n      } else if (height > maxSize) {\n        width = (width * maxSize) / height;\n        height = maxSize;\n      }\n\n      canvas.width = width;\n      canvas.height = height;\n      ctx?.drawImage(img, 0, 0, width, height);\n\n      canvas.toBlob(\n        (blob) => {\n          if (blob) resolve(blob);\n          else reject(new Error(\"Failed to compress image\"));\n        },\n        \"image/png\",\n        0.9,\n      );\n    };\n\n    img.onerror = () => {\n      reject(new Error(\"Failed to load image\"));\n    };\n\n    img.src = URL.createObjectURL(file);\n  });\n}\n\nexport async function compressImage(file: File): Promise<File> {\n  const compressedBlob = await compressImageBlob(file, 800);\n  return new File([compressedBlob], `avatar_${Date.now()}.png`, {\n    type: \"image/png\",\n  });\n}\n"],"mappings":";;AAEA,IAAa,IAAqB,uBAErB,KAAiB,MACvB,IACD,EAAQ,WAAW,SAAS,KAAK,EAAQ,WAAW,UAAU,IACzD,IAGF,GADS,EAAO,OAAO,QAAQ,OAAO,EACnC,EAAQ,gBAAgB,EAAQ,SALrB;AAQvB,SAAgB,EAAoB,GAAwC;CAC1E,OAAO,IAAgB,EAAc,CAAa,IAAI;AACxD;AAEA,IAAa,KAAoB,MAAqC,EAAc,CAAO,KAAA;AAE3F,eAAe,EAAkB,GAAY,IAAkB,KAAoB;CACjF,OAAO,IAAI,SAAS,GAAS,MAAW;EACtC,IAAM,IAAS,SAAS,cAAc,QAAQ,GACxC,IAAM,EAAO,WAAW,IAAI,GAC5B,IAAM,IAAI,MAAM;EAiCtB,AA/BA,EAAI,eAAe;GACjB,IAAI,EAAE,UAAO,cAAW;GAgBxB,AAdI,IAAQ,IACN,IAAQ,MACV,IAAU,IAAS,IAAW,GAC9B,IAAQ,KAED,IAAS,MAClB,IAAS,IAAQ,IAAW,GAC5B,IAAS,IAGX,EAAO,QAAQ,GACf,EAAO,SAAS,GAChB,GAAK,UAAU,GAAK,GAAG,GAAG,GAAO,CAAM,GAEvC,EAAO,QACJ,MAAS;IACR,AAAI,IAAM,EAAQ,CAAI,IACjB,EAAO,gBAAI,MAAM,0BAA0B,CAAC;GACnD,GACA,aACA,EACF;EACF,GAEA,EAAI,gBAAgB;GAClB,EAAO,gBAAI,MAAM,sBAAsB,CAAC;EAC1C,GAEA,EAAI,MAAM,IAAI,gBAAgB,CAAI;CACpC,CAAC;AACH;AAEA,eAAsB,EAAc,GAA2B;CAC7D,IAAM,IAAiB,MAAM,EAAkB,GAAM,GAAG;CACxD,OAAO,IAAI,KAAK,CAAC,CAAc,GAAG,UAAU,KAAK,IAAI,EAAE,OAAO,EAC5D,MAAM,YACR,CAAC;AACH"}

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

@@ -0,0 +1,5 @@
+export * from './account';
+export * from './verificationCode';
+export * from './images';
+export * from './buildProfilePatch';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/domain/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/domain/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC"}

package/dist/utils/domain/index.js

@@ -0,0 +1,5 @@
+import { pickProfile as e, resolveAccountDisplayName as t, resolveAccountInitial as n } from "./account.js";
+import { VERIFICATION_CODE_ALPHABET as r, isVerificationCodeComplete as i, normalizeVerificationCode as a } from "./verificationCode.js";
+import { buildProfilePatch as o } from "./buildProfilePatch.js";
+import { DEFAULT_AVATAR_SRC as s, buildAvatarImageSrc as c, buildImageUrl as l, compressImage as u, resolveAvatarSrc as d } from "./images.js";
+export { s as DEFAULT_AVATAR_SRC, r as VERIFICATION_CODE_ALPHABET, c as buildAvatarImageSrc, l as buildImageUrl, o as buildProfilePatch, u as compressImage, i as isVerificationCodeComplete, a as normalizeVerificationCode, e as pickProfile, t as resolveAccountDisplayName, n as resolveAccountInitial, d as resolveAvatarSrc };

package/dist/utils/domain/verificationCode.d.ts

@@ -0,0 +1,4 @@
+export declare const VERIFICATION_CODE_ALPHABET = "23456789ABCDEFGHJKLMNPQRSTUVWXYZ";
+export declare function normalizeVerificationCode(raw: string, slotCount?: number): string;
+export declare function isVerificationCodeComplete(code: string, slotCount?: number): boolean;
+//# sourceMappingURL=verificationCode.d.ts.map

package/dist/utils/domain/verificationCode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verificationCode.d.ts","sourceRoot":"","sources":["../../../src/utils/domain/verificationCode.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,0BAA0B,qCAAqC,CAAC;AAI7E,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAAqB,GAAG,MAAM,CAU7F;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAqB,GAAG,OAAO,CAGhG"}

package/dist/utils/domain/verificationCode.js

@@ -0,0 +1,14 @@
+//#region src/utils/domain/verificationCode.ts
+var e = "23456789ABCDEFGHJKLMNPQRSTUVWXYZ", t = /* @__PURE__ */ new Set(e);
+function n(e, n = 6) {
+	let r = e.toUpperCase(), i = "";
+	for (let e of r) if (t.has(e) && (i += e, i.length >= n)) break;
+	return i;
+}
+function r(e, t = 6) {
+	return n(e, t).length === t;
+}
+//#endregion
+export { e as VERIFICATION_CODE_ALPHABET, r as isVerificationCodeComplete, n as normalizeVerificationCode };
+
+//# sourceMappingURL=verificationCode.js.map

package/dist/utils/domain/verificationCode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verificationCode.js","names":[],"sources":["../../../src/utils/domain/verificationCode.ts"],"sourcesContent":["const DEFAULT_SLOT_COUNT = 6;\n\nexport const VERIFICATION_CODE_ALPHABET = \"23456789ABCDEFGHJKLMNPQRSTUVWXYZ\";\n\nconst VERIFICATION_CODE_CHAR_SET = new Set(VERIFICATION_CODE_ALPHABET);\n\nexport function normalizeVerificationCode(raw: string, slotCount = DEFAULT_SLOT_COUNT): string {\n  const upper = raw.toUpperCase();\n  let out = \"\";\n  for (const ch of upper) {\n    if (VERIFICATION_CODE_CHAR_SET.has(ch)) {\n      out += ch;\n      if (out.length >= slotCount) break;\n    }\n  }\n  return out;\n}\n\nexport function isVerificationCodeComplete(code: string, slotCount = DEFAULT_SLOT_COUNT): boolean {\n  const normalized = normalizeVerificationCode(code, slotCount);\n  return normalized.length === slotCount;\n}\n"],"mappings":";AAAA,IAEa,IAA6B,oCAEpC,oBAA6B,IAAI,IAAI,CAA0B;AAErE,SAAgB,EAA0B,GAAa,IAAY,GAA4B;CAC7F,IAAM,IAAQ,EAAI,YAAY,GAC1B,IAAM;CACV,KAAK,IAAM,KAAM,GACf,IAAI,EAA2B,IAAI,CAAE,MACnC,KAAO,GACH,EAAI,UAAU,IAAW;CAGjC,OAAO;AACT;AAEA,SAAgB,EAA2B,GAAc,IAAY,GAA6B;CAEhG,OADmB,EAA0B,GAAM,CAC5C,CAAA,CAAW,WAAW;AAC/B"}

package/dist/utils/email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../src/utils/email.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,KAAG,OAG5C,CAAC"}

package/dist/utils/email.js

@@ -0,0 +1,6 @@
+//#region src/utils/email.ts
+var e = (e) => /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(e);
+//#endregion
+export { e as isValidEmail };
+
+//# sourceMappingURL=email.js.map

package/dist/utils/email.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.js","names":[],"sources":["../../src/utils/email.ts"],"sourcesContent":["/**\n * 校验邮箱格式是否有效（简单正则：含 @ 与点）\n * Check if email format is valid (simple regex: contains @ and dot).\n * @param email - 待校验的邮箱字符串\n * @returns 是否有效\n */\nexport const isValidEmail = (email: string): boolean => {\n  const emailRegex = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/;\n  return emailRegex.test(email);\n};\n"],"mappings":";AAMA,IAAa,KAAgB,MAEpB,6BAAW,KAAK,CAAK"}

package/dist/utils/factory/hooks.d.ts

@@ -0,0 +1,41 @@
+import { QueryKey, UseInfiniteQueryOptions, UseInfiniteQueryResult, UseQueryOptions, UseQueryResult, UseSuspenseInfiniteQueryOptions, UseSuspenseInfiniteQueryResult, UseSuspenseQueryOptions, UseSuspenseQueryResult } from '@tanstack/react-query';
+import { AxiosError } from 'axios';
+import { ListDTOWithNextCursor, ListDTOWithTotalNumber, OffsetLimitNumber, OffsetLimitString } from '../../types/api';
+type InfiniteListFilter = Partial<OffsetLimitNumber>;
+type FetchNumberListParams<F extends InfiniteListFilter = InfiniteListFilter> = F & OffsetLimitNumber;
+type FetchStringListParams<F extends object = Record<string, unknown>> = F & OffsetLimitString;
+type MutationCtx = {
+    prev?: unknown;
+};
+type InfiniteQueryOptions<T> = Omit<UseInfiniteQueryOptions<ListDTOWithTotalNumber<T>, AxiosError, T[]>, "queryKey" | "queryFn" | "getNextPageParam" | "initialPageParam"> & {
+    postProcess?: (data: T[]) => void;
+};
+type StringInfiniteQueryOptions<T> = Omit<UseInfiniteQueryOptions<ListDTOWithNextCursor<T>, AxiosError, T[]>, "queryKey" | "queryFn" | "getNextPageParam" | "initialPageParam"> & {
+    postProcess?: (data: T[]) => void;
+};
+type SuspenseInfiniteQueryOptions<T> = Omit<UseSuspenseInfiniteQueryOptions<ListDTOWithTotalNumber<T>, AxiosError, T[]>, "queryKey" | "queryFn" | "getNextPageParam" | "initialPageParam"> & {
+    postProcess?: (data: T[]) => void;
+};
+type InfiniteQueryOptionsUnion<T> = InfiniteQueryOptions<T> | SuspenseInfiniteQueryOptions<T>;
+type SuspenseUnifiedQueryOptions<T> = Omit<UseSuspenseQueryOptions<T, AxiosError, T>, "queryKey" | "queryFn"> & {
+    postProcess?: (data: T) => void;
+};
+type NormalUnifiedQueryOptions<T> = Omit<UseQueryOptions<T, AxiosError, T>, "queryKey" | "queryFn"> & {
+    postProcess?: (data: T) => void;
+};
+type UnifiedQueryParams<T> = {
+    options?: SuspenseUnifiedQueryOptions<T>;
+    postProcess?: (data: T) => void;
+} & Record<string, unknown>;
+type QueryOptions<T> = NormalUnifiedQueryOptions<T>;
+type SuspenseQueryOptions<T> = SuspenseUnifiedQueryOptions<T>;
+export type { FetchNumberListParams, FetchStringListParams, InfiniteListFilter, InfiniteQueryOptions, InfiniteQueryOptionsUnion, MutationCtx, NormalUnifiedQueryOptions, StringInfiniteQueryOptions, SuspenseInfiniteQueryOptions, SuspenseUnifiedQueryOptions, UnifiedQueryParams, };
+declare function makeCursorFetchFunction<T, F extends InfiniteListFilter = InfiniteListFilter>(fetchFunc: (params: F) => Promise<ListDTOWithTotalNumber<T>>, postProcess?: (data: T[]) => void): (pageParam?: number, filter?: F) => Promise<ListDTOWithTotalNumber<T>>;
+declare function makeStringCursorFetchFunction<T, F extends Partial<Pick<OffsetLimitString, "limit">> & object = Partial<Pick<OffsetLimitString, "limit">>>(fetchFunc: (params: FetchStringListParams<F>) => Promise<ListDTOWithNextCursor<T>>, postProcess?: (data: T[]) => void): (pageParam?: string, filter?: F) => Promise<ListDTOWithNextCursor<T>>;
+export { makeCursorFetchFunction, makeStringCursorFetchFunction };
+declare function useUnifiedQuery<T, F extends object = Record<string, unknown>>(fetchRemote: (params: F) => Promise<T>, queryKey: QueryKey, filter?: F, options?: QueryOptions<T>): UseQueryResult<T, AxiosError>;
+declare function useUnifiedSuspenseQuery<T, F extends object = Record<string, unknown>>(fetchRemote: (params: F) => Promise<T>, queryKey: QueryKey, filter?: F, options?: SuspenseQueryOptions<T>): UseSuspenseQueryResult<T, AxiosError>;
+declare function useUnifiedInfiniteQuery<T, F extends InfiniteListFilter = InfiniteListFilter>(fetchRemote: (params: F) => Promise<ListDTOWithTotalNumber<T>>, queryKey: QueryKey, filter?: F, options?: InfiniteQueryOptions<T>): UseInfiniteQueryResult<T[], AxiosError>;
+declare function useUnifiedSuspenseInfiniteQuery<T, F extends InfiniteListFilter = InfiniteListFilter>(fetchRemote: (params: F) => Promise<ListDTOWithTotalNumber<T>>, queryKey: QueryKey, filter?: F, options?: SuspenseInfiniteQueryOptions<T>): UseSuspenseInfiniteQueryResult<T[], AxiosError>;
+export { useUnifiedInfiniteQuery, useUnifiedQuery, useUnifiedSuspenseInfiniteQuery, useUnifiedSuspenseQuery };
+//# sourceMappingURL=hooks.d.ts.map

package/dist/utils/factory/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/utils/factory/hooks.ts"],"names":[],"mappings":"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"}

package/dist/utils/factory/hooks.js

@@ -0,0 +1,85 @@
+import { useMemo as e } from "react";
+import { useInfiniteQuery as t, useQuery as n, useSuspenseInfiniteQuery as r, useSuspenseQuery as i } from "@tanstack/react-query";
+//#region src/utils/factory/hooks.ts
+var a = 20;
+function o(e) {
+	return e?.limit ?? a;
+}
+function s(e) {
+	return e?.offset ?? 0;
+}
+function c(e, t) {
+	return async (n = 0, r) => {
+		let i = o(r), a = s(r), { items: c, total: l } = await e({
+			...r,
+			offset: a + n * i,
+			limit: i
+		});
+		return c?.length && t?.(c), {
+			items: c,
+			total: l
+		};
+	};
+}
+function l(e, t) {
+	return async (n = "", r) => {
+		let i = r?.limit ?? a, { items: o, nextCursor: s } = await e({
+			...r,
+			offset: n,
+			limit: i
+		});
+		return o?.length && t?.(o), {
+			items: o,
+			nextCursor: s
+		};
+	};
+}
+function u(e, t, n, r) {
+	let i = o(n), a = s(n);
+	return {
+		queryKey: [...e, n],
+		queryFn: ({ pageParam: e }) => t(e, n),
+		initialPageParam: 0,
+		getNextPageParam: (e, t) => a + t.length * i < e.total ? t.length : void 0,
+		select: (e) => e.pages.flatMap((e) => e.items),
+		retry: (e, t) => {
+			let n = t?.status && t.status >= 500 || t?.code === "NETWORK_ERROR", i = typeof r?.retry == "number" ? r.retry : 3;
+			return n && e < i;
+		},
+		...r
+	};
+}
+function d(e, t, n, r) {
+	let { postProcess: i, ...a } = r ?? {};
+	return {
+		queryKey: n === void 0 ? t : [...t, n],
+		queryFn: async () => {
+			let t = await e(n || {});
+			return i?.(t), t;
+		},
+		select: (e) => e,
+		retry: (e, t) => {
+			let n = t?.status ?? t?.response?.status, r = typeof n == "number" && n >= 500 || t?.code === "NETWORK_ERROR", i = typeof a?.retry == "number" ? a.retry : 3;
+			return r && e < i;
+		},
+		...a
+	};
+}
+function f(e, t, r, i) {
+	return n(d(e, t, r, i));
+}
+function p(e, t, n, r) {
+	return i(d(e, t, n, r));
+}
+function m(n, r, i, a) {
+	let o = i ?? {}, { postProcess: s, ...l } = a ?? {}, d = e(() => c(n, s), [n, s]);
+	return t(u(r, d, o, l));
+}
+function h(t, n, i, a) {
+	let o = i ?? {}, { postProcess: s, ...l } = a ?? {}, d = e(() => c(t, s), [t, s]);
+	return r(u(n, d, o, l));
+}
+//#endregion
+export { c as makeCursorFetchFunction, l as makeStringCursorFetchFunction, m as useUnifiedInfiniteQuery, f as useUnifiedQuery, h as useUnifiedSuspenseInfiniteQuery, p as useUnifiedSuspenseQuery };
+
+//# sourceMappingURL=hooks.js.map

package/dist/utils/factory/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","names":[],"sources":["../../../src/utils/factory/hooks.ts"],"sourcesContent":["/**\n * Hooks 模块：分页 fetch 与统一 React Query hooks（稳定身份，可在业务 hook body 内直接调用）。\n */\nimport type {\n  InfiniteData,\n  QueryKey,\n  UseInfiniteQueryOptions,\n  UseInfiniteQueryResult,\n  UseQueryOptions,\n  UseQueryResult,\n  UseSuspenseInfiniteQueryOptions,\n  UseSuspenseInfiniteQueryResult,\n  UseSuspenseQueryOptions,\n  UseSuspenseQueryResult,\n} from \"@tanstack/react-query\";\nimport type { AxiosError } from \"axios\";\nimport type { ListDTOWithNextCursor, ListDTOWithTotalNumber, OffsetLimitNumber, OffsetLimitString } from \"@/types/api\";\n\nimport { useMemo } from \"react\";\nimport { useInfiniteQuery, useQuery, useSuspenseInfiniteQuery, useSuspenseQuery } from \"@tanstack/react-query\";\n\ntype InfiniteListFilter = Partial<OffsetLimitNumber>;\n\ntype FetchNumberListParams<F extends InfiniteListFilter = InfiniteListFilter> = F & OffsetLimitNumber;\n\ntype FetchStringListParams<F extends object = Record<string, unknown>> = F & OffsetLimitString;\n\ntype MutationCtx = {\n  prev?: unknown;\n};\n\ntype InfiniteQueryOptions<T> = Omit<UseInfiniteQueryOptions<ListDTOWithTotalNumber<T>, AxiosError, T[]>, \"queryKey\" | \"queryFn\" | \"getNextPageParam\" | \"initialPageParam\"> & {\n  postProcess?: (data: T[]) => void;\n};\n\ntype StringInfiniteQueryOptions<T> = Omit<UseInfiniteQueryOptions<ListDTOWithNextCursor<T>, AxiosError, T[]>, \"queryKey\" | \"queryFn\" | \"getNextPageParam\" | \"initialPageParam\"> & {\n  postProcess?: (data: T[]) => void;\n};\n\ntype SuspenseInfiniteQueryOptions<T> = Omit<\n  UseSuspenseInfiniteQueryOptions<ListDTOWithTotalNumber<T>, AxiosError, T[]>,\n  \"queryKey\" | \"queryFn\" | \"getNextPageParam\" | \"initialPageParam\"\n> & {\n  postProcess?: (data: T[]) => void;\n};\n\ntype InfiniteQueryOptionsUnion<T> = InfiniteQueryOptions<T> | SuspenseInfiniteQueryOptions<T>;\n\ntype SuspenseUnifiedQueryOptions<T> = Omit<UseSuspenseQueryOptions<T, AxiosError, T>, \"queryKey\" | \"queryFn\"> & {\n  postProcess?: (data: T) => void;\n};\n\ntype NormalUnifiedQueryOptions<T> = Omit<UseQueryOptions<T, AxiosError, T>, \"queryKey\" | \"queryFn\"> & {\n  postProcess?: (data: T) => void;\n};\n\ntype UnifiedQueryParams<T> = {\n  options?: SuspenseUnifiedQueryOptions<T>;\n  postProcess?: (data: T) => void;\n} & Record<string, unknown>;\n\ntype QueryOptions<T> = NormalUnifiedQueryOptions<T>;\ntype SuspenseQueryOptions<T> = SuspenseUnifiedQueryOptions<T>;\n\nconst DEFAULT_PAGE_SIZE = 20;\n\nexport type {\n  FetchNumberListParams,\n  FetchStringListParams,\n  InfiniteListFilter,\n  InfiniteQueryOptions,\n  InfiniteQueryOptionsUnion,\n  MutationCtx,\n  NormalUnifiedQueryOptions,\n  StringInfiniteQueryOptions,\n  SuspenseInfiniteQueryOptions,\n  SuspenseUnifiedQueryOptions,\n  UnifiedQueryParams,\n};\n\nfunction resolvePageSize(filter?: InfiniteListFilter): number {\n  return filter?.limit ?? DEFAULT_PAGE_SIZE;\n}\n\nfunction resolveBaseOffset(filter?: InfiniteListFilter): number {\n  return filter?.offset ?? 0;\n}\n\nfunction makeCursorFetchFunction<T, F extends InfiniteListFilter = InfiniteListFilter>(\n  fetchFunc: (params: F) => Promise<ListDTOWithTotalNumber<T>>,\n  postProcess?: (data: T[]) => void,\n) {\n  return async (pageParam: number = 0, filter?: F): Promise<ListDTOWithTotalNumber<T>> => {\n    const pageSize = resolvePageSize(filter);\n    const baseOffset = resolveBaseOffset(filter);\n    const payload = {\n      ...filter,\n      offset: baseOffset + pageParam * pageSize,\n      limit: pageSize,\n    } as F;\n    const { items, total } = await fetchFunc(payload);\n    if (items?.length) postProcess?.(items);\n    return { items, total };\n  };\n}\n\nfunction makeStringCursorFetchFunction<T, F extends Partial<Pick<OffsetLimitString, \"limit\">> & object = Partial<Pick<OffsetLimitString, \"limit\">>>(\n  fetchFunc: (params: FetchStringListParams<F>) => Promise<ListDTOWithNextCursor<T>>,\n  postProcess?: (data: T[]) => void,\n) {\n  return async (pageParam: string = \"\", filter?: F): Promise<ListDTOWithNextCursor<T>> => {\n    const pageSize = filter?.limit ?? DEFAULT_PAGE_SIZE;\n    const payload = {\n      ...filter,\n      offset: pageParam,\n      limit: pageSize,\n    } as FetchStringListParams<F>;\n    const { items, nextCursor } = await fetchFunc(payload);\n    if (items?.length) postProcess?.(items);\n    return { items, nextCursor };\n  };\n}\n\nexport { makeCursorFetchFunction, makeStringCursorFetchFunction };\n\nfunction buildInfiniteCommonOptions<T, F extends InfiniteListFilter = InfiniteListFilter>(\n  queryKey: QueryKey,\n  fetchFunction: (pageParam: number, filter?: F) => Promise<ListDTOWithTotalNumber<T>>,\n  filter: F,\n  options: Omit<InfiniteQueryOptionsUnion<T>, \"postProcess\"> | undefined,\n) {\n  const pageSize = resolvePageSize(filter);\n  const baseOffset = resolveBaseOffset(filter);\n  return {\n    // eslint-disable-next-line @tanstack/query/exhaustive-deps\n    queryKey: [...queryKey, filter],\n    queryFn: ({ pageParam }: { pageParam: number }) => fetchFunction(pageParam, filter),\n    initialPageParam: 0,\n    getNextPageParam: (lastPage: ListDTOWithTotalNumber<T>, allPages: ListDTOWithTotalNumber<T>[]) =>\n      baseOffset + allPages.length * pageSize < lastPage.total ? allPages.length : undefined,\n    select: (d: InfiniteData<ListDTOWithTotalNumber<T>>) => d.pages.flatMap((p) => p.items),\n    retry: (failureCount: number, error: AxiosError) => {\n      const transient = (error?.status && error.status >= 500) || error?.code === \"NETWORK_ERROR\";\n      const retryMax = typeof options?.retry === \"number\" ? options.retry : 3;\n      return transient && failureCount < retryMax;\n    },\n    ...(options as Partial<ReturnType<typeof useInfiniteQuery>>),\n  };\n}\n\nfunction buildQueryCommonOptions<T, F extends object = Record<string, unknown>>(\n  fetchRemote: (params: F) => Promise<T>,\n  queryKey: QueryKey,\n  filter: F | undefined,\n  options: QueryOptions<T> | SuspenseQueryOptions<T> | undefined,\n) {\n  const { postProcess, ...queryOptions } = options ?? {};\n  return {\n    queryKey: filter !== undefined ? [...queryKey, filter] : queryKey,\n    queryFn: async () => {\n      const data = await fetchRemote(filter || ({} as F));\n      postProcess?.(data);\n      return data;\n    },\n    select: (data: T) => data,\n    retry: (failureCount: number, error: AxiosError) => {\n      const status = error?.status ?? error?.response?.status;\n      const transient = (typeof status === \"number\" && status >= 500) || error?.code === \"NETWORK_ERROR\";\n      const retryMax = typeof queryOptions?.retry === \"number\" ? queryOptions.retry : 3;\n      return transient && failureCount < retryMax;\n    },\n    ...(queryOptions as object),\n  };\n}\n\nfunction useUnifiedQuery<T, F extends object = Record<string, unknown>>(\n  fetchRemote: (params: F) => Promise<T>,\n  queryKey: QueryKey,\n  filter?: F,\n  options?: QueryOptions<T>,\n): UseQueryResult<T, AxiosError> {\n  return useQuery(buildQueryCommonOptions(fetchRemote, queryKey, filter, options));\n}\n\nfunction useUnifiedSuspenseQuery<T, F extends object = Record<string, unknown>>(\n  fetchRemote: (params: F) => Promise<T>,\n  queryKey: QueryKey,\n  filter?: F,\n  options?: SuspenseQueryOptions<T>,\n): UseSuspenseQueryResult<T, AxiosError> {\n  return useSuspenseQuery(buildQueryCommonOptions(fetchRemote, queryKey, filter, options));\n}\n\nfunction useUnifiedInfiniteQuery<T, F extends InfiniteListFilter = InfiniteListFilter>(\n  fetchRemote: (params: F) => Promise<ListDTOWithTotalNumber<T>>,\n  queryKey: QueryKey,\n  filter?: F,\n  options?: InfiniteQueryOptions<T>,\n): UseInfiniteQueryResult<T[], AxiosError> {\n  const resolvedFilter = (filter ?? {}) as F;\n  const { postProcess, ...queryOptions } = options ?? {};\n  const fetchFunction = useMemo(() => makeCursorFetchFunction(fetchRemote, postProcess), [fetchRemote, postProcess]);\n  return useInfiniteQuery(buildInfiniteCommonOptions(queryKey, fetchFunction, resolvedFilter, queryOptions));\n}\n\nfunction useUnifiedSuspenseInfiniteQuery<T, F extends InfiniteListFilter = InfiniteListFilter>(\n  fetchRemote: (params: F) => Promise<ListDTOWithTotalNumber<T>>,\n  queryKey: QueryKey,\n  filter?: F,\n  options?: SuspenseInfiniteQueryOptions<T>,\n): UseSuspenseInfiniteQueryResult<T[], AxiosError> {\n  const resolvedFilter = (filter ?? {}) as F;\n  const { postProcess, ...queryOptions } = options ?? {};\n  const fetchFunction = useMemo(() => makeCursorFetchFunction(fetchRemote, postProcess), [fetchRemote, postProcess]);\n  return useSuspenseInfiniteQuery(buildInfiniteCommonOptions(queryKey, fetchFunction, resolvedFilter, queryOptions));\n}\n\nexport { useUnifiedInfiniteQuery, useUnifiedQuery, useUnifiedSuspenseInfiniteQuery, useUnifiedSuspenseQuery };\n"],"mappings":";;;AAgEA,IAAM,IAAoB;AAgB1B,SAAS,EAAgB,GAAqC;CAC5D,OAAO,GAAQ,SAAS;AAC1B;AAEA,SAAS,EAAkB,GAAqC;CAC9D,OAAO,GAAQ,UAAU;AAC3B;AAEA,SAAS,EACP,GACA,GACA;CACA,OAAO,OAAO,IAAoB,GAAG,MAAmD;EACtF,IAAM,IAAW,EAAgB,CAAM,GACjC,IAAa,EAAkB,CAAM,GAMrC,EAAE,UAAO,aAAU,MAAM,EAAU;GAJvC,GAAG;GACH,QAAQ,IAAa,IAAY;GACjC,OAAO;EAEgC,CAAO;EAEhD,OADI,GAAO,UAAQ,IAAc,CAAK,GAC/B;GAAE;GAAO;EAAM;CACxB;AACF;AAEA,SAAS,EACP,GACA,GACA;CACA,OAAO,OAAO,IAAoB,IAAI,MAAkD;EACtF,IAAM,IAAW,GAAQ,SAAS,GAM5B,EAAE,UAAO,kBAAe,MAAM,EAAU;GAJ5C,GAAG;GACH,QAAQ;GACR,OAAO;EAEqC,CAAO;EAErD,OADI,GAAO,UAAQ,IAAc,CAAK,GAC/B;GAAE;GAAO;EAAW;CAC7B;AACF;AAIA,SAAS,EACP,GACA,GACA,GACA,GACA;CACA,IAAM,IAAW,EAAgB,CAAM,GACjC,IAAa,EAAkB,CAAM;CAC3C,OAAO;EAEL,UAAU,CAAC,GAAG,GAAU,CAAM;EAC9B,UAAU,EAAE,mBAAuC,EAAc,GAAW,CAAM;EAClF,kBAAkB;EAClB,mBAAmB,GAAqC,MACtD,IAAa,EAAS,SAAS,IAAW,EAAS,QAAQ,EAAS,SAAS,KAAA;EAC/E,SAAS,MAA+C,EAAE,MAAM,SAAS,MAAM,EAAE,KAAK;EACtF,QAAQ,GAAsB,MAAsB;GAClD,IAAM,IAAa,GAAO,UAAU,EAAM,UAAU,OAAQ,GAAO,SAAS,iBACtE,IAAW,OAAO,GAAS,SAAU,WAAW,EAAQ,QAAQ;GACtE,OAAO,KAAa,IAAe;EACrC;EACA,GAAI;CACN;AACF;AAEA,SAAS,EACP,GACA,GACA,GACA,GACA;CACA,IAAM,EAAE,gBAAa,GAAG,MAAiB,KAAW,CAAC;CACrD,OAAO;EACL,UAAU,MAAW,KAAA,IAAoC,IAAxB,CAAC,GAAG,GAAU,CAAM;EACrD,SAAS,YAAY;GACnB,IAAM,IAAO,MAAM,EAAY,KAAW,CAAC,CAAO;GAElD,OADA,IAAc,CAAI,GACX;EACT;EACA,SAAS,MAAY;EACrB,QAAQ,GAAsB,MAAsB;GAClD,IAAM,IAAS,GAAO,UAAU,GAAO,UAAU,QAC3C,IAAa,OAAO,KAAW,YAAY,KAAU,OAAQ,GAAO,SAAS,iBAC7E,IAAW,OAAO,GAAc,SAAU,WAAW,EAAa,QAAQ;GAChF,OAAO,KAAa,IAAe;EACrC;EACA,GAAI;CACN;AACF;AAEA,SAAS,EACP,GACA,GACA,GACA,GAC+B;CAC/B,OAAO,EAAS,EAAwB,GAAa,GAAU,GAAQ,CAAO,CAAC;AACjF;AAEA,SAAS,EACP,GACA,GACA,GACA,GACuC;CACvC,OAAO,EAAiB,EAAwB,GAAa,GAAU,GAAQ,CAAO,CAAC;AACzF;AAEA,SAAS,EACP,GACA,GACA,GACA,GACyC;CACzC,IAAM,IAAkB,KAAU,CAAC,GAC7B,EAAE,gBAAa,GAAG,MAAiB,KAAW,CAAC,GAC/C,IAAgB,QAAc,EAAwB,GAAa,CAAW,GAAG,CAAC,GAAa,CAAW,CAAC;CACjH,OAAO,EAAiB,EAA2B,GAAU,GAAe,GAAgB,CAAY,CAAC;AAC3G;AAEA,SAAS,EACP,GACA,GACA,GACA,GACiD;CACjD,IAAM,IAAkB,KAAU,CAAC,GAC7B,EAAE,gBAAa,GAAG,MAAiB,KAAW,CAAC,GAC/C,IAAgB,QAAc,EAAwB,GAAa,CAAW,GAAG,CAAC,GAAa,CAAW,CAAC;CACjH,OAAO,EAAyB,EAA2B,GAAU,GAAe,GAAgB,CAAY,CAAC;AACnH"}

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

@@ -0,0 +1,3 @@
+export * from './hooks';
+export * from './navigations';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/factory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/factory/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC"}

package/dist/utils/factory/index.js

@@ -0,0 +1,3 @@
+import { makeCursorFetchFunction as e, makeStringCursorFetchFunction as t, useUnifiedInfiniteQuery as n, useUnifiedQuery as r, useUnifiedSuspenseInfiniteQuery as i, useUnifiedSuspenseQuery as a } from "./hooks.js";
+import { buildPath as o, createRouter as s, defineRouter as c, isActiveRoute as l, matchRoute as u } from "./navigations.js";
+export { o as buildPath, s as createRouter, c as defineRouter, l as isActiveRoute, e as makeCursorFetchFunction, t as makeStringCursorFetchFunction, u as matchRoute, n as useUnifiedInfiniteQuery, r as useUnifiedQuery, i as useUnifiedSuspenseInfiniteQuery, a as useUnifiedSuspenseQuery };

package/dist/utils/factory/navigations.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 通用路由类型与 defineRouter / createRouter（与 EventEmitter 的 defineEvents 约定一致）。
+ * Generic route types and defineRouter / createRouter; only values from defineRouter are accepted by createRouter.
+ */
+export type DefinedRouter<R extends Record<string, string>> = Defined<R, "router">;
+export type RouteKey<R extends Record<string, string>> = KeyOf<R>;
+export type RoutePath<R extends Record<string, string>> = R[RouteKey<R>];
+export type PathParams<Path extends string> = string extends Path ? Record<string, string | number> : Path extends `${string}:${infer Param}/${infer Rest}` ? {
+    [K in Param | keyof PathParams<`/${Rest}`>]: string | number;
+} : Path extends `${string}:${infer Param}` ? {
+    [K in Param]: string | number;
+} : Record<never, never>;
+type HasPathParams<Path extends string> = keyof PathParams<Path> extends never ? false : true;
+export type QueryParams = Record<string, string | number | boolean | null | undefined>;
+export declare function buildPath<Path extends string>(route: Path, ...args: HasPathParams<Path> extends true ? [params: PathParams<Path>, query?: QueryParams] : [params?: undefined, query?: QueryParams]): string;
+export declare function defineRouter<const R extends Record<string, string>>(routes: R): DefinedRouter<R>;
+export declare function isActiveRoute(currentPath: string, targetPath: string): boolean;
+export declare function matchRoute(pathname: string, route: string): boolean;
+export declare function createRouter<R extends Record<string, string>>(routes: DefinedRouter<R>): {
+    ROUTES: Readonly<R>;
+    matchRoute: (pathname: string, route: string) => boolean;
+    isActiveRoute: (currentPath: string, targetPath: string) => boolean;
+    buildPath: typeof buildPath;
+};
+export {};
+//# sourceMappingURL=navigations.d.ts.map

package/dist/utils/factory/navigations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigations.d.ts","sourceRoot":"","sources":["../../../src/utils/factory/navigations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,OAAO,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;AAEnF,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;AAElE,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AAEzE,MAAM,MAAM,UAAU,CAAC,IAAI,SAAS,MAAM,IAAI,MAAM,SAAS,IAAI,GAC7D,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAC/B,IAAI,SAAS,GAAG,MAAM,IAAI,MAAM,KAAK,IAAI,MAAM,IAAI,EAAE,GACnD;KAAG,CAAC,IAAI,KAAK,GAAG,MAAM,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC,GAAG,MAAM,GAAG,MAAM;CAAE,GAChE,IAAI,SAAS,GAAG,MAAM,IAAI,MAAM,KAAK,EAAE,GACrC;KAAG,CAAC,IAAI,KAAK,GAAG,MAAM,GAAG,MAAM;CAAE,GACjC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAE7B,KAAK,aAAa,CAAC,IAAI,SAAS,MAAM,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,SAAS,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC;AAE9F,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAYvF,wBAAgB,SAAS,CAAC,IAAI,SAAS,MAAM,EAC3C,KAAK,EAAE,IAAI,EACX,GAAG,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,EAAE,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,WAAW,CAAC,GACtI,MAAM,CAaR;AAED,wBAAgB,YAAY,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAEhG;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAE9E;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAMnE;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;;2BAGlD,MAAM,SAAS,MAAM,KAAG,OAAO;iCAEzB,MAAM,cAAc,MAAM,KAAG,OAAO;;EAQ9E"}

package/dist/utils/factory/navigations.js

@@ -0,0 +1,38 @@
+//#region src/utils/factory/navigations.ts
+function e(e) {
+	let t = [];
+	for (let n of Object.keys(e)) {
+		let r = e[n];
+		r != null && t.push(`${encodeURIComponent(n)}=${encodeURIComponent(String(r))}`);
+	}
+	return t.join("&");
+}
+function t(t, ...n) {
+	let r = n[0], i = n[1], a = String(t);
+	if (r) for (let e of Object.keys(r)) a = a.replace(`:${e}`, encodeURIComponent(String(r[e])));
+	let o = i ? e(i) : "";
+	return o ? `${a}?${o}` : a;
+}
+function n(e) {
+	return e;
+}
+function r(e, t) {
+	return e === t;
+}
+function i(e, t) {
+	if (e === t) return !0;
+	let n = t.split("/").filter(Boolean), r = e.split("/").filter(Boolean);
+	return n.length === r.length && n.every((e, t) => e.startsWith(":") || e === r[t]);
+}
+function a(e) {
+	return {
+		ROUTES: e,
+		matchRoute: (e, t) => i(e, t),
+		isActiveRoute: (e, t) => r(e, t),
+		buildPath: t
+	};
+}
+//#endregion
+export { t as buildPath, a as createRouter, n as defineRouter, r as isActiveRoute, i as matchRoute };
+
+//# sourceMappingURL=navigations.js.map

package/dist/utils/factory/navigations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigations.js","names":[],"sources":["../../../src/utils/factory/navigations.ts"],"sourcesContent":["/**\n * 通用路由类型与 defineRouter / createRouter（与 EventEmitter 的 defineEvents 约定一致）。\n * Generic route types and defineRouter / createRouter; only values from defineRouter are accepted by createRouter.\n */\n\nexport type DefinedRouter<R extends Record<string, string>> = Defined<R, \"router\">;\n\nexport type RouteKey<R extends Record<string, string>> = KeyOf<R>;\n\nexport type RoutePath<R extends Record<string, string>> = R[RouteKey<R>];\n\nexport type PathParams<Path extends string> = string extends Path\n  ? Record<string, string | number>\n  : Path extends `${string}:${infer Param}/${infer Rest}`\n    ? { [K in Param | keyof PathParams<`/${Rest}`>]: string | number }\n    : Path extends `${string}:${infer Param}`\n      ? { [K in Param]: string | number }\n      : Record<never, never>;\n\ntype HasPathParams<Path extends string> = keyof PathParams<Path> extends never ? false : true;\n\nexport type QueryParams = Record<string, string | number | boolean | null | undefined>;\n\nfunction toQueryString(query: QueryParams): string {\n  const parts: string[] = [];\n  for (const key of Object.keys(query)) {\n    const value = query[key];\n    if (value === null || value === undefined) continue;\n    parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);\n  }\n  return parts.join(\"&\");\n}\n\nexport function buildPath<Path extends string>(\n  route: Path,\n  ...args: HasPathParams<Path> extends true ? [params: PathParams<Path>, query?: QueryParams] : [params?: undefined, query?: QueryParams]\n): string {\n  const params = args[0] as Maybe<Record<string, string | number>>;\n  const query = args[1] as Maybe<QueryParams>;\n\n  let path = String(route);\n  if (params) {\n    for (const key of Object.keys(params)) {\n      path = path.replace(`:${key}`, encodeURIComponent(String(params[key])));\n    }\n  }\n\n  const qs = query ? toQueryString(query) : \"\";\n  return qs ? `${path}?${qs}` : path;\n}\n\nexport function defineRouter<const R extends Record<string, string>>(routes: R): DefinedRouter<R> {\n  return routes as DefinedRouter<R>;\n}\n\nexport function isActiveRoute(currentPath: string, targetPath: string): boolean {\n  return currentPath === targetPath;\n}\n\nexport function matchRoute(pathname: string, route: string): boolean {\n  if (pathname === route) return true;\n  const routeParts = route.split(\"/\").filter(Boolean);\n  const pathParts = pathname.split(\"/\").filter(Boolean);\n  if (routeParts.length !== pathParts.length) return false;\n  return routeParts.every((p, i) => p.startsWith(\":\") || p === pathParts[i]);\n}\n\nexport function createRouter<R extends Record<string, string>>(routes: DefinedRouter<R>) {\n  const ROUTES = routes as Readonly<R>;\n\n  const matchRouteBound = (pathname: string, route: string): boolean => matchRoute(pathname, route);\n\n  const isActiveRouteBound = (currentPath: string, targetPath: string): boolean => isActiveRoute(currentPath, targetPath);\n\n  return {\n    ROUTES,\n    matchRoute: matchRouteBound,\n    isActiveRoute: isActiveRouteBound,\n    buildPath,\n  };\n}\n"],"mappings":";AAuBA,SAAS,EAAc,GAA4B;CACjD,IAAM,IAAkB,CAAC;CACzB,KAAK,IAAM,KAAO,OAAO,KAAK,CAAK,GAAG;EACpC,IAAM,IAAQ,EAAM;EAChB,KAAU,QACd,EAAM,KAAK,GAAG,mBAAmB,CAAG,EAAE,GAAG,mBAAmB,OAAO,CAAK,CAAC,GAAG;CAC9E;CACA,OAAO,EAAM,KAAK,GAAG;AACvB;AAEA,SAAgB,EACd,GACA,GAAG,GACK;CACR,IAAM,IAAS,EAAK,IACd,IAAQ,EAAK,IAEf,IAAO,OAAO,CAAK;CACvB,IAAI,GACF,KAAK,IAAM,KAAO,OAAO,KAAK,CAAM,GAClC,IAAO,EAAK,QAAQ,IAAI,KAAO,mBAAmB,OAAO,EAAO,EAAI,CAAC,CAAC;CAI1E,IAAM,IAAK,IAAQ,EAAc,CAAK,IAAI;CAC1C,OAAO,IAAK,GAAG,EAAK,GAAG,MAAO;AAChC;AAEA,SAAgB,EAAqD,GAA6B;CAChG,OAAO;AACT;AAEA,SAAgB,EAAc,GAAqB,GAA6B;CAC9E,OAAO,MAAgB;AACzB;AAEA,SAAgB,EAAW,GAAkB,GAAwB;CACnE,IAAI,MAAa,GAAO,OAAO;CAC/B,IAAM,IAAa,EAAM,MAAM,GAAG,CAAC,CAAC,OAAO,OAAO,GAC5C,IAAY,EAAS,MAAM,GAAG,CAAC,CAAC,OAAO,OAAO;CAEpD,OADI,EAAW,WAAW,EAAU,UAC7B,EAAW,OAAO,GAAG,MAAM,EAAE,WAAW,GAAG,KAAK,MAAM,EAAU,EAAE;AAC3E;AAEA,SAAgB,EAA+C,GAA0B;CAOvF,OAAO;EACL;EACA,aANuB,GAAkB,MAA2B,EAAW,GAAU,CAAK;EAO9F,gBAL0B,GAAqB,MAAgC,EAAc,GAAa,CAAU;EAMpH;CACF;AACF"}

package/dist/utils/form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../src/utils/form.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOvD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOzD"}

package/dist/utils/form.js

@@ -0,0 +1,11 @@
+//#region src/utils/form.ts
+function e(e) {
+	return typeof e == "string" ? e : e == null ? "" : typeof e == "number" || typeof e == "boolean" ? String(e) : Array.isArray(e) ? e.map((e) => String(e)).join(", ") : typeof e == "object" ? JSON.stringify(e) : String(e);
+}
+function t(e) {
+	return e == null ? "" : typeof e == "number" ? Number.isFinite(e) ? String(e) : "" : typeof e == "string" ? e : typeof e == "boolean" ? e ? "1" : "0" : Array.isArray(e) && e.length > 0 ? String(e[0]) : "";
+}
+//#endregion
+export { t as toNumberInputValue, e as toTextInputValue };
+
+//# sourceMappingURL=form.js.map

package/dist/utils/form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.js","names":[],"sources":["../../src/utils/form.ts"],"sourcesContent":["/**\n * 将任意值转为文本输入框可用的字符串（用于表单回显）\n * Convert any value to a string suitable for text input (e.g. form display).\n * @param value - 任意值\n * @returns 字符串；null/undefined → \"\"；数组 → 逗号拼接；对象 → JSON 字符串\n */\nexport function toTextInputValue(value: unknown): string {\n  if (typeof value === \"string\") return value;\n  if (value === null || value === undefined) return \"\";\n  if (typeof value === \"number\" || typeof value === \"boolean\") return String(value);\n  if (Array.isArray(value)) return value.map((item) => String(item)).join(\", \");\n  if (typeof value === \"object\") return JSON.stringify(value);\n  return String(value);\n}\n\n/**\n * 将任意值转为数字输入框可用的字符串（用于表单回显）\n * Convert any value to a string suitable for number input (e.g. form display).\n * @param value - 任意值\n * @returns 字符串；null/undefined → \"\"；非有限数字 → \"\"；数组取首项\n */\nexport function toNumberInputValue(value: unknown): string {\n  if (value === null || value === undefined) return \"\";\n  if (typeof value === \"number\") return Number.isFinite(value) ? String(value) : \"\";\n  if (typeof value === \"string\") return value;\n  if (typeof value === \"boolean\") return value ? \"1\" : \"0\";\n  if (Array.isArray(value) && value.length > 0) return String(value[0]);\n  return \"\";\n}\n"],"mappings":";AAMA,SAAgB,EAAiB,GAAwB;CAMvD,OALI,OAAO,KAAU,WAAiB,IAClC,KAAU,OAAoC,KAC9C,OAAO,KAAU,YAAY,OAAO,KAAU,YAAkB,OAAO,CAAK,IAC5E,MAAM,QAAQ,CAAK,IAAU,EAAM,KAAK,MAAS,OAAO,CAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IACxE,OAAO,KAAU,WAAiB,KAAK,UAAU,CAAK,IACnD,OAAO,CAAK;AACrB;AAQA,SAAgB,EAAmB,GAAwB;CAMzD,OALI,KAAU,OAAoC,KAC9C,OAAO,KAAU,WAAiB,OAAO,SAAS,CAAK,IAAI,OAAO,CAAK,IAAI,KAC3E,OAAO,KAAU,WAAiB,IAClC,OAAO,KAAU,YAAkB,IAAQ,MAAM,MACjD,MAAM,QAAQ,CAAK,KAAK,EAAM,SAAS,IAAU,OAAO,EAAM,EAAE,IAC7D;AACT"}

package/dist/utils/idle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idle.d.ts","sourceRoot":"","sources":["../../src/utils/idle.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG;IAAE,MAAM,EAAE,MAAM,IAAI,CAAA;CAAE,CAAC;AAEpD,MAAM,MAAM,8BAA8B,GAAG;IAC3C,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC;AAcF;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,OAAO,CAAC,EAAE,8BAA8B,GAAG,cAAc,CA+DlH"}

package/dist/utils/idle.js

@@ -0,0 +1,30 @@
+//#region src/utils/idle.ts
+function e(e, t) {
+	let n = t?.timeout ?? 2e3, r = t?.minRemainingMs ?? 1, i = t?.allowTimeoutRun ?? !0, a = t?.maxRetries ?? Infinity, o = t?.fallbackDelayMs ?? null, s = globalThis, c = s.requestIdleCallback, l = s.cancelIdleCallback, u = s.setTimeout ?? setTimeout, d = s.clearTimeout ?? clearTimeout;
+	if (typeof c == "function") {
+		let t = !1, s = 0, f = 0, p = null, m = () => {
+			t = !0, typeof l == "function" && l(s), p !== null && (d(p), p = null);
+		}, h = (l) => {
+			if (!t) {
+				if (l.timeRemaining() >= r || i && l.didTimeout) {
+					e();
+					return;
+				}
+				if (f >= a) {
+					o !== null && (p = u(() => {
+						t || e();
+					}, Math.max(0, o)));
+					return;
+				}
+				f += 1, s = c(h, { timeout: n });
+			}
+		};
+		return s = c(h, { timeout: n }), { cancel: m };
+	}
+	let f = u(e, Math.max(0, o ?? 0));
+	return { cancel: () => d(f) };
+}
+//#endregion
+export { e as scheduleBrowserIdleTask };
+
+//# sourceMappingURL=idle.js.map

package/dist/utils/idle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idle.js","names":[],"sources":["../../src/utils/idle.ts"],"sourcesContent":["export type IdleTaskHandle = { cancel: () => void };\n\nexport type ScheduleBrowserIdleTaskOptions = {\n  /** `requestIdleCallback` 超时兜底（ms）。默认 2000。 */\n  timeout?: number;\n  /**\n   * 仅当 `deadline.timeRemaining()` ≥ 此阈值时才执行（ms）。\n   * 默认 1：只要确实有一点空闲 slice 就跑。\n   */\n  minRemainingMs?: number;\n  /**\n   * 是否允许 `deadline.didTimeout` 时执行任务（兜底避免永远不执行）。\n   * 默认 true。\n   */\n  allowTimeoutRun?: boolean;\n  /**\n   * 空闲不足时最多重试次数。默认 Infinity（持续等空闲）。\n   * 设为 0 表示本次 idle 不够就直接放弃（不执行）。\n   */\n  maxRetries?: number;\n  /**\n   * 达到 `maxRetries` 后用 `setTimeout` 兜底执行的延迟（ms）。\n   * 默认 null（不兜底，直接放弃）。\n   */\n  fallbackDelayMs?: number | null;\n};\n\ntype IdleDeadlineLike = {\n  readonly didTimeout: boolean;\n  timeRemaining: () => number;\n};\n\ntype RequestIdleCallback = (\n  callback: (deadline: IdleDeadlineLike) => void,\n  options?: { timeout?: number },\n) => number;\n\ntype CancelIdleCallback = (handle: number) => void;\n\n/**\n * 在浏览器帧间空闲时段执行任务（`requestIdleCallback`），避免动画与布局/主线程同步抢同一时刻。\n * 无 API 时退化为 `setTimeout(0)`。\n */\nexport function scheduleBrowserIdleTask(task: () => void, options?: ScheduleBrowserIdleTaskOptions): IdleTaskHandle {\n  const timeout = options?.timeout ?? 2000;\n  const minRemainingMs = options?.minRemainingMs ?? 1;\n  const allowTimeoutRun = options?.allowTimeoutRun ?? true;\n  const maxRetries = options?.maxRetries ?? Number.POSITIVE_INFINITY;\n  const fallbackDelayMs = options?.fallbackDelayMs ?? null;\n\n  const g = globalThis as unknown as {\n    requestIdleCallback?: RequestIdleCallback;\n    cancelIdleCallback?: CancelIdleCallback;\n    setTimeout?: typeof setTimeout;\n    clearTimeout?: typeof clearTimeout;\n  };\n\n  const ric = g.requestIdleCallback;\n  const cic = g.cancelIdleCallback;\n  const st = g.setTimeout ?? setTimeout;\n  const ct = g.clearTimeout ?? clearTimeout;\n\n  if (typeof ric === \"function\") {\n    let cancelled = false;\n    let id = 0;\n    let retries = 0;\n    let fallbackTimeoutId: ReturnType<typeof st> | null = null;\n\n    const cancelAll = () => {\n      cancelled = true;\n      if (typeof cic === \"function\") {\n        cic(id);\n      }\n      if (fallbackTimeoutId !== null) {\n        ct(fallbackTimeoutId);\n        fallbackTimeoutId = null;\n      }\n    };\n\n    const runOrReschedule = (deadline: IdleDeadlineLike) => {\n      if (cancelled) return;\n      const canRun = deadline.timeRemaining() >= minRemainingMs || (allowTimeoutRun && deadline.didTimeout);\n      if (canRun) {\n        task();\n        return;\n      }\n\n      if (retries >= maxRetries) {\n        if (fallbackDelayMs !== null) {\n          fallbackTimeoutId = st(() => {\n            if (!cancelled) task();\n          }, Math.max(0, fallbackDelayMs));\n        }\n        return;\n      }\n\n      retries += 1;\n      id = ric(runOrReschedule, { timeout });\n    };\n\n    id = ric(runOrReschedule, { timeout });\n    return { cancel: cancelAll };\n  }\n\n  const id = st(task, Math.max(0, fallbackDelayMs ?? 0));\n  return { cancel: () => ct(id) };\n}\n\n"],"mappings":";AA2CA,SAAgB,EAAwB,GAAkB,GAA0D;CAClH,IAAM,IAAU,GAAS,WAAW,KAC9B,IAAiB,GAAS,kBAAkB,GAC5C,IAAkB,GAAS,mBAAmB,IAC9C,IAAa,GAAS,cAAc,UACpC,IAAkB,GAAS,mBAAmB,MAE9C,IAAI,YAOJ,IAAM,EAAE,qBACR,IAAM,EAAE,oBACR,IAAK,EAAE,cAAc,YACrB,IAAK,EAAE,gBAAgB;CAE7B,IAAI,OAAO,KAAQ,YAAY;EAC7B,IAAI,IAAY,IACZ,IAAK,GACL,IAAU,GACV,IAAkD,MAEhD,UAAkB;GAKtB,AAJA,IAAY,IACR,OAAO,KAAQ,cACjB,EAAI,CAAE,GAEJ,MAAsB,SACxB,EAAG,CAAiB,GACpB,IAAoB;EAExB,GAEM,KAAmB,MAA+B;GAClD,QAEJ;QADe,EAAS,cAAc,KAAK,KAAmB,KAAmB,EAAS,YAC9E;KACV,EAAK;KACL;IACF;IAEA,IAAI,KAAW,GAAY;KACzB,AAAI,MAAoB,SACtB,IAAoB,QAAS;MAC3B,AAAK,KAAW,EAAK;KACvB,GAAG,KAAK,IAAI,GAAG,CAAe,CAAC;KAEjC;IACF;IAGA,AADA,KAAW,GACX,IAAK,EAAI,GAAiB,EAAE,WAAQ,CAAC;GAZrC;EAaF;EAGA,OADA,IAAK,EAAI,GAAiB,EAAE,WAAQ,CAAC,GAC9B,EAAE,QAAQ,EAAU;CAC7B;CAEA,IAAM,IAAK,EAAG,GAAM,KAAK,IAAI,GAAG,KAAmB,CAAC,CAAC;CACrD,OAAO,EAAE,cAAc,EAAG,CAAE,EAAE;AAChC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Utils 统一导出 / Utils barrel exports
+ * 地址、数组、API 错误、浏览器、颜色、邮箱、表单、图片、对象、电话、轮询、价格、safe、
+ * Promise、Result、重试、单例、Suspense、时间、类型工具、类型等
+ */
+export * from './address';
+export * from './lstorage';
+export * from './apiError';
+export * from './array';
+export * from './colors';
+export * from './email';
+export * from './form';
+export * from './object';
+export * from './polling';
+export * from './price';
+export * from './promise';
+export * from './result';
+export * from './retry';
+export * from './safe';
+export * from './singleton';
+export * from './suspense';
+export * from './time';
+export * from './random';
+export * from './types';
+export * from './idle';
+export * from './factory';
+export * from './jwt';
+export * from './sessionErrors';
+export * from './domain';
+export * from './primitive';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,OAAO,CAAC;AACtB,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,30 @@
+import { safeArray as e, safeEnum as t, safeMaybe as n, safeNilable as r, safeNullable as i, safeNum as a, safeOr as o, safeStringable as s, safeZeroable as c } from "./safe.js";
+import { getApiError as l, getApiErrorMessage as u } from "./apiError.js";
+import { decodeJwtPayload as d, getJwtExpiresAtMs as f, getJwtIssuedAtMs as p } from "./jwt.js";
+import { singleton as m } from "./singleton.js";
+import { IMMEDIATE_FORCE_LOGOUT_ERR_CODES as h, shouldForceLogoutAfterAuthRetry as g, shouldForceLogoutOnApiError as _, shouldImmediateForceLogoutOnApiError as v } from "./sessionErrors.js";
+import { makeCursorFetchFunction as y, makeStringCursorFetchFunction as b, useUnifiedInfiniteQuery as x, useUnifiedQuery as S, useUnifiedSuspenseInfiniteQuery as C, useUnifiedSuspenseQuery as w } from "./factory/hooks.js";
+import { buildPath as T, createRouter as E, defineRouter as D, isActiveRoute as O, matchRoute as k } from "./factory/navigations.js";
+import { pickProfile as A, resolveAccountDisplayName as j, resolveAccountInitial as M } from "./domain/account.js";
+import { VERIFICATION_CODE_ALPHABET as N, isVerificationCodeComplete as P, normalizeVerificationCode as F } from "./domain/verificationCode.js";
+import { formatDate as I, formatDateTime as L, formatDisplayDate as R, formatMonthDayTime as z, formatRelativeTime as B, formatTickDate as V, toDateInputValue as H } from "./time.js";
+import { normalizeAddress as U } from "./address.js";
+import { mergeById as W, pruneArray as G } from "./array.js";
+import { hexToRGBA as K, interpolateColor as q, interpolateColorHex as J, pickColor as Y, rgbToRgba as X, toRgbaWithAlpha as Z } from "./colors.js";
+import { assignIfChanged as Q, assignNullableString as $, isEmptyPatch as ee, normalizeOptionalString as te, originalOptionalString as ne } from "./primitive/patch.js";
+import { buildProfilePatch as re } from "./domain/buildProfilePatch.js";
+import { DEFAULT_AVATAR_SRC as ie, buildAvatarImageSrc as ae, buildImageUrl as oe, compressImage as se, resolveAvatarSrc as ce } from "./domain/images.js";
+import { isValidEmail as le } from "./email.js";
+import { toNumberInputValue as ue, toTextInputValue as de } from "./form.js";
+import { scheduleBrowserIdleTask as fe } from "./idle.js";
+import { getItem as pe, removeItem as me, setItem as he } from "./lstorage.js";
+import { omit as ge } from "./object.js";
+import { err as _e, ok as ve } from "./result.js";
+import { withRetryResult as ye } from "./retry.js";
+import { pollUntil as be } from "./polling.js";
+import { formatNumberAbbreviated as xe, toDatabasePrice as Se, toDisplayPrice as Ce, toDisplayPriceNumber as we } from "./price.js";
+import { onceAsync as Te, onceAsyncByKey as Ee } from "./promise.js";
+import { suspenseIfNull as De } from "./suspense.js";
+import { chance as Oe, pickRandom as ke, randomBetween as Ae, randomBool as je, randomGaussian as Me, randomInt as Ne, randomSign as Pe } from "./random.js";
+import { createMap as Fe } from "./types.js";
+export { ie as DEFAULT_AVATAR_SRC, h as IMMEDIATE_FORCE_LOGOUT_ERR_CODES, N as VERIFICATION_CODE_ALPHABET, Q as assignIfChanged, $ as assignNullableString, ae as buildAvatarImageSrc, oe as buildImageUrl, T as buildPath, re as buildProfilePatch, Oe as chance, se as compressImage, Fe as createMap, E as createRouter, d as decodeJwtPayload, D as defineRouter, _e as err, I as formatDate, L as formatDateTime, R as formatDisplayDate, z as formatMonthDayTime, xe as formatNumberAbbreviated, B as formatRelativeTime, V as formatTickDate, l as getApiError, u as getApiErrorMessage, pe as getItem, f as getJwtExpiresAtMs, p as getJwtIssuedAtMs, K as hexToRGBA, q as interpolateColor, J as interpolateColorHex, O as isActiveRoute, ee as isEmptyPatch, le as isValidEmail, P as isVerificationCodeComplete, y as makeCursorFetchFunction, b as makeStringCursorFetchFunction, k as matchRoute, W as mergeById, U as normalizeAddress, te as normalizeOptionalString, F as normalizeVerificationCode, ve as ok, ge as omit, Te as onceAsync, Ee as onceAsyncByKey, ne as originalOptionalString, Y as pickColor, A as pickProfile, ke as pickRandom, be as pollUntil, G as pruneArray, Ae as randomBetween, je as randomBool, Me as randomGaussian, Ne as randomInt, Pe as randomSign, me as removeItem, j as resolveAccountDisplayName, M as resolveAccountInitial, ce as resolveAvatarSrc, X as rgbToRgba, e as safeArray, t as safeEnum, n as safeMaybe, r as safeNilable, i as safeNullable, a as safeNum, o as safeOr, s as safeStringable, c as safeZeroable, fe as scheduleBrowserIdleTask, he as setItem, g as shouldForceLogoutAfterAuthRetry, _ as shouldForceLogoutOnApiError, v as shouldImmediateForceLogoutOnApiError, m as singleton, De as suspenseIfNull, Se as toDatabasePrice, H as toDateInputValue, Ce as toDisplayPrice, we as toDisplayPriceNumber, ue as toNumberInputValue, Z as toRgbaWithAlpha, de as toTextInputValue, x as useUnifiedInfiniteQuery, S as useUnifiedQuery, C as useUnifiedSuspenseInfiniteQuery, w as useUnifiedSuspenseQuery, ye as withRetryResult };

package/dist/utils/jwt.d.ts

@@ -0,0 +1,5 @@
+/** 仅解析 JWT payload（不做签名校验；过期时间调度用，鉴权仍由后端负责） */
+export declare function decodeJwtPayload(token: string): Nullable<Record<string, unknown>>;
+export declare function getJwtExpiresAtMs(token: string): Nullable<number>;
+export declare function getJwtIssuedAtMs(token: string): Nullable<number>;
+//# sourceMappingURL=jwt.d.ts.map

package/dist/utils/jwt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt.d.ts","sourceRoot":"","sources":["../../src/utils/jwt.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAWjF;AAOD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAGjE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAGhE"}

package/dist/utils/jwt.js

@@ -0,0 +1,27 @@
+//#region src/utils/jwt.ts
+function e(e) {
+	let t = e.split(".");
+	if (t.length < 2) return null;
+	try {
+		let e = t[1].replace(/-/g, "+").replace(/_/g, "/"), n = e.padEnd(e.length + (4 - e.length % 4) % 4, "=");
+		return JSON.parse(atob(n));
+	} catch {
+		return null;
+	}
+}
+function t(e, t) {
+	let n = e[t];
+	return typeof n == "number" ? n * 1e3 : null;
+}
+function n(n) {
+	let r = e(n);
+	return r ? t(r, "exp") : null;
+}
+function r(n) {
+	let r = e(n);
+	return r ? t(r, "iat") : null;
+}
+//#endregion
+export { e as decodeJwtPayload, n as getJwtExpiresAtMs, r as getJwtIssuedAtMs };
+
+//# sourceMappingURL=jwt.js.map

package/dist/utils/jwt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt.js","names":[],"sources":["../../src/utils/jwt.ts"],"sourcesContent":["/** 仅解析 JWT payload（不做签名校验；过期时间调度用，鉴权仍由后端负责） */\nexport function decodeJwtPayload(token: string): Nullable<Record<string, unknown>> {\n  const parts = token.split(\".\");\n  if (parts.length < 2) return null;\n\n  try {\n    const base64 = parts[1].replace(/-/g, \"+\").replace(/_/g, \"/\");\n    const padded = base64.padEnd(base64.length + ((4 - (base64.length % 4)) % 4), \"=\");\n    return JSON.parse(atob(padded)) as Record<string, unknown>;\n  } catch {\n    return null;\n  }\n}\n\nfunction readJwtClaimSeconds(payload: Record<string, unknown>, key: string): Nullable<number> {\n  const value = payload[key];\n  return typeof value === \"number\" ? value * 1000 : null;\n}\n\nexport function getJwtExpiresAtMs(token: string): Nullable<number> {\n  const payload = decodeJwtPayload(token);\n  return payload ? readJwtClaimSeconds(payload, \"exp\") : null;\n}\n\nexport function getJwtIssuedAtMs(token: string): Nullable<number> {\n  const payload = decodeJwtPayload(token);\n  return payload ? readJwtClaimSeconds(payload, \"iat\") : null;\n}\n"],"mappings":";AACA,SAAgB,EAAiB,GAAkD;CACjF,IAAM,IAAQ,EAAM,MAAM,GAAG;CAC7B,IAAI,EAAM,SAAS,GAAG,OAAO;CAE7B,IAAI;EACF,IAAM,IAAS,EAAM,EAAE,CAAC,QAAQ,MAAM,GAAG,CAAC,CAAC,QAAQ,MAAM,GAAG,GACtD,IAAS,EAAO,OAAO,EAAO,UAAW,IAAK,EAAO,SAAS,KAAM,GAAI,GAAG;EACjF,OAAO,KAAK,MAAM,KAAK,CAAM,CAAC;CAChC,QAAQ;EACN,OAAO;CACT;AACF;AAEA,SAAS,EAAoB,GAAkC,GAA+B;CAC5F,IAAM,IAAQ,EAAQ;CACtB,OAAO,OAAO,KAAU,WAAW,IAAQ,MAAO;AACpD;AAEA,SAAgB,EAAkB,GAAiC;CACjE,IAAM,IAAU,EAAiB,CAAK;CACtC,OAAO,IAAU,EAAoB,GAAS,KAAK,IAAI;AACzD;AAEA,SAAgB,EAAiB,GAAiC;CAChE,IAAM,IAAU,EAAiB,CAAK;CACtC,OAAO,IAAU,EAAoB,GAAS,KAAK,IAAI;AACzD"}

package/dist/utils/lstorage.d.ts

@@ -0,0 +1,5 @@
+import { Nilable } from '../types/utils';
+export declare function removeItem(key: string): void;
+export declare function getItem(key: string): Nilable<string>;
+export declare function setItem(key: string, value: string): void;
+//# sourceMappingURL=lstorage.d.ts.map

package/dist/utils/lstorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lstorage.d.ts","sourceRoot":"","sources":["../../src/utils/lstorage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAS,OAAO,EAAE,MAAM,eAAe,CAAC;AAUpD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAI5C;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEpD;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIxD"}

package/dist/utils/lstorage.js

@@ -0,0 +1,25 @@
+//#region src/utils/lstorage.ts
+function e(e) {
+	try {
+		return e();
+	} catch {
+		return;
+	}
+}
+function t(t) {
+	e(() => {
+		localStorage.removeItem(t);
+	});
+}
+function n(t) {
+	return e(() => localStorage.getItem(t));
+}
+function r(t, n) {
+	e(() => {
+		localStorage.setItem(t, n);
+	});
+}
+//#endregion
+export { n as getItem, t as removeItem, r as setItem };
+
+//# sourceMappingURL=lstorage.js.map

package/dist/utils/lstorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lstorage.js","names":[],"sources":["../../src/utils/lstorage.ts"],"sourcesContent":["/**\n * localStorage 安全封装，避免隐私模式等场景抛错。\n * Safe localStorage wrapper; avoids throwing in private mode etc.\n */\n\nimport type { Maybe, Nilable } from \"@/types/utils\";\n\nfunction safe<T>(fn: () => T): Maybe<T> {\n  try {\n    return fn();\n  } catch {\n    return undefined;\n  }\n}\n\nexport function removeItem(key: string): void {\n  safe(() => {\n    localStorage.removeItem(key);\n  });\n}\n\nexport function getItem(key: string): Nilable<string> {\n  return safe(() => localStorage.getItem(key));\n}\n\nexport function setItem(key: string, value: string): void {\n  safe(() => {\n    localStorage.setItem(key, value);\n  });\n}\n"],"mappings":";AAOA,SAAS,EAAQ,GAAuB;CACtC,IAAI;EACF,OAAO,EAAG;CACZ,QAAQ;EACN;CACF;AACF;AAEA,SAAgB,EAAW,GAAmB;CAC5C,QAAW;EACT,aAAa,WAAW,CAAG;CAC7B,CAAC;AACH;AAEA,SAAgB,EAAQ,GAA8B;CACpD,OAAO,QAAW,aAAa,QAAQ,CAAG,CAAC;AAC7C;AAEA,SAAgB,EAAQ,GAAa,GAAqB;CACxD,QAAW;EACT,aAAa,QAAQ,GAAK,CAAK;CACjC,CAAC;AACH"}

package/dist/utils/object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../src/utils/object.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAc/H"}