nfx-ui 0.26.0 → 0.27.0

package/dist/utils/safe.js.map

@@ -1 +1 @@
-{"version":3,"file":"safe.js","names":[],"sources":["../../src/utils/safe.ts"],"sourcesContent":["/**\n * Safe 工具：将 Nilable / Emptyable / Array 等规范为 Nullable、Maybe、Zeroable、Stringable、Array，避免到处写 ?? undefined / ?? null / ?? 0 / ?? \"\" / ?? []。\n * Safe utils: normalize Nilable/Emptyable/array to Nullable, Maybe, Zeroable, Stringable, Array.\n */\n\nimport type { Nullable, Maybe, Nilable, Emptyable, Zeroable, Stringable, Array } from \"@/types\";\n\n/**\n * 将 Nilable 规范为 Nullable：undefined 转为 null，null 与 T 原样返回。返回类型 Nullable&lt;T&gt;。\n * Normalize Nilable to Nullable: convert undefined to null; null and T unchanged. Returns Nullable&lt;T&gt;.\n * @param value - 可能为 null 或 undefined 的值 (value that may be null or undefined)\n * @returns 若为 undefined 则 null，否则原值 (null if undefined, otherwise value)\n * @example safeNullable(apiResponse.data) // undefined → null，便于区分「未设置」与「空」\n */\nexport function safeNullable<T>(value: Nilable<T>): Nullable<T> {\n  return (value === undefined ? null : value) as Nullable<T>;\n}\n\n/**\n * 将 Nilable 规范为 Maybe：null 转为 undefined，undefined 与 T 原样返回。返回类型 Maybe&lt;T&gt;。等同 value ?? undefined。\n * Normalize Nilable to Maybe: convert null to undefined; undefined and T unchanged. Returns Maybe&lt;T&gt;. Same as value ?? undefined.\n * @param value - 可能为 null 或 undefined 的值 (value that may be null or undefined)\n * @returns 若为 null 或 undefined 则 undefined，否则原值 (undefined if null/undefined, otherwise value)\n * @example safeMaybe(product.price) // 代替 product.price ?? undefined\n */\nexport function safeMaybe<T>(value: Nilable<T>): Maybe<T> {\n  return value ?? undefined;\n}\n\n/**\n * 将 Emptyable 字符串规范为 Nilable：空字符串转为 undefined，null/undefined/非空串原样。返回类型 Nilable&lt;T&gt;。常用于表单、接口字段。\n * Normalize Emptyable string to Nilable: \"\" to undefined; null, undefined, non-empty string unchanged. Returns Nilable&lt;T&gt;. For form/API fields.\n * @param value - 可能为 null、undefined 或空字符串 (value that may be null, undefined or \"\")\n * @returns 若为 \"\" 则 undefined，否则原值 (undefined if \"\", otherwise value)\n * @example safeNilable(product.remark) // \"\" 也视为「无值」\n */\nexport function safeNilable<T extends string>(value: Emptyable<T>): Nilable<T> {\n  return (value === \"\" ? undefined : value) as Nilable<T>;\n}\n\n/**\n * 将 Nilable 数组规范为数组：null/undefined 转为 [] 或 defaultValue。返回类型 Array&lt;T&gt;（即 T[]）。\n * Normalize Nilable array to array: null/undefined to [] or defaultValue. Returns Array&lt;T&gt; (i.e. T[]).\n * @param value - 可能为 null 或 undefined 的数组 (array that may be null or undefined)\n * @param defaultValue - 可选，当 value 为 null/undefined 时使用；缺省为 [] (optional default when value is null/undefined; default is [])\n * @returns value ?? defaultValue ?? [] (never null/undefined)\n * @example safeArray(product.tags) // product.tags ?? []\n * @example safeArray(product.tags, ['default'])\n *\n * 参数使用 `Array&lt;T&gt;`（即 `T[]`，见 `@/types`）与全库类型别名一致；入参也接受 `readonly T[]`，便于兼容只读数组来源。\n */\nexport function safeArray<T>(value: Nilable<Array<T> | readonly T[]>, defaultValue?: Array<T>): Array<T> {\n  const resolved = value ?? defaultValue;\n  if (resolved === undefined) {\n    return [] as Array<T>;\n  }\n  return resolved as Array<T>;\n}\n\n/**\n * 将 Nilable 数值规范为 Zeroable：null/undefined 转为 0。返回类型 Zeroable&lt;number&gt;（即 number，0 为兜底）。\n * Normalize Nilable number to Zeroable: null/undefined to 0. Returns Zeroable&lt;number&gt; (number with 0 as fallback).\n * @param value - 可能为 null 或 undefined 的数值 (number that may be null or undefined)\n * @returns value ?? 0 (never null/undefined)\n * @example safeZeroable(product.stock) // 代替 product.stock ?? 0\n */\nexport function safeZeroable(value: Nilable<number>): Zeroable<number> {\n  return (value ?? 0) as Zeroable<number>;\n}\n\n/**\n * 将 Emptyable 字符串规范为 Stringable：null/undefined/\"\" 转为 \"\"。返回类型 Stringable&lt;string&gt;（即 string，\"\" 为兜底）。\n * Normalize Emptyable string to Stringable: null/undefined/\"\" to \"\". Returns Stringable&lt;string&gt; (string with \"\" as fallback).\n * @param value - 可能为 null、undefined 或空字符串 (value that may be null, undefined or \"\")\n * @returns 若为 null、undefined 或 \"\" 则 \"\"，否则原值 (\"\" if null/undefined/\"\", otherwise value)\n * @example safeStringable(product.name) // 代替 product.name ?? \"\"\n */\nexport function safeStringable<T extends string>(value: Emptyable<T>): Stringable<T> {\n  if (value === null || value === undefined || value === \"\") return \"\" as Stringable<T>;\n  return value as Stringable<T>;\n}\n\n/**\n * 若值为 null/undefined 则返回默认值，否则返回原值。等同 value ?? defaultValue。\n * Return defaultValue when value is null/undefined, otherwise value. Same as value ?? defaultValue.\n * @param value - 可能为 null 或 undefined 的值 (value that may be null or undefined)\n * @param defaultValue - 默认值 (default value)\n * @returns value ?? defaultValue\n * @example safeOr(product.stock, 0)\n * @example safeOr(product.name, '')\n *\n * 使用两个类型参数时，若第一个实参无法收窄（例如索引访问、宽泛的 Record），`T` 可能被推断为 `unknown`，结果变成 `unknown`。\n * 因此提供**单类型**重载：当 `defaultValue` 与「有值时」的类型一致时，应写 `safeOr(x, fallback)` 且两者同型，返回即为 `T`。\n */\nexport function safeOr<T>(value: Nilable<T>, defaultValue: T): T;\nexport function safeOr<T, D>(value: Nilable<T>, defaultValue: D): T | D;\nexport function safeOr<T, D>(value: Nilable<T>, defaultValue: D): T | D {\n  return value ?? defaultValue;\n}\n\n/**\n * 将字符串规范为允许的枚举成员；非法或缺省时回落 defaultValue。\n */\nexport function safeEnum<T extends string>(value: Nilable<string>, allowed: readonly T[], defaultValue: T): T {\n  return typeof value === \"string\" && allowed.includes(value as T) ? (value as T) : defaultValue;\n}\n\n/**\n * 安全取数字：null/undefined/NaN 转为 undefined，合法数字原样。返回类型 Maybe&lt;number&gt;。\n * Safe number: null/undefined/NaN to undefined; valid number unchanged. Returns Maybe&lt;number&gt;.\n * @param value - 可能为 null、undefined 或非数字 (value that may be null, undefined or NaN)\n * @returns 若为 null、undefined 或 NaN 则 undefined，否则数字 (undefined if null/undefined/NaN, otherwise number)\n * @example safeNum(product.price) // 用于严格「有值才用」的场景\n */\nexport function safeNum(value: Nilable<number>): Maybe<number> {\n  if (value === null || value === undefined) return undefined;\n  const n = Number(value);\n  return Number.isNaN(n) ? undefined : n;\n}\n"],"mappings":";AAcA,SAAgB,EAAgB,GAAgC;CAC9D,OAAQ,MAAU,KAAA,IAAY,OAAO;AACvC;AASA,SAAgB,EAAa,GAA6B;CACxD,OAAO,KAAS,KAAA;AAClB;AASA,SAAgB,EAA8B,GAAiC;CAC7E,OAAQ,MAAU,KAAK,KAAA,IAAY;AACrC;AAaA,SAAgB,EAAa,GAAyC,GAAmC;CACvG,IAAM,IAAW,KAAS;CAI1B,OAHI,MAAa,KAAA,IACR,CAAC,IAEH;AACT;AASA,SAAgB,EAAa,GAA0C;CACrE,OAAQ,KAAS;AACnB;AASA,SAAgB,EAAiC,GAAoC;CAEnF,OADI,KAAU,QAA+B,MAAU,KAAW,KAC3D;AACT;AAgBA,SAAgB,EAAa,GAAmB,GAAwB;CACtE,OAAO,KAAS;AAClB;AAKA,SAAgB,EAA2B,GAAwB,GAAuB,GAAoB;CAC5G,OAAO,OAAO,KAAU,YAAY,EAAQ,SAAS,CAAU,IAAK,IAAc;AACpF;AASA,SAAgB,EAAQ,GAAuC;CAC7D,IAAI,KAAU,MAA6B;CAC3C,IAAM,IAAI,OAAO,CAAK;CACtB,OAAO,OAAO,MAAM,CAAC,IAAI,KAAA,IAAY;AACvC"}
+{"version":3,"file":"safe.js","names":[],"sources":["../../src/utils/safe.ts"],"sourcesContent":["/**\n * Safe 工具：将 Nilable / Emptyable / Array 等规范为 Nullable、Maybe、Zeroable、Stringable、Array，避免到处写 ?? undefined / ?? null / ?? 0 / ?? \"\" / ?? []。\n * Safe utils: normalize Nilable/Emptyable/array to Nullable, Maybe, Zeroable, Stringable, Array.\n */\n\nimport type { Nullable, Maybe, Nilable, Emptyable, Zeroable, Stringable, Array } from \"nfx-ui/types\";\n\n/**\n * 将 Nilable 规范为 Nullable：undefined 转为 null，null 与 T 原样返回。返回类型 Nullable&lt;T&gt;。\n * Normalize Nilable to Nullable: convert undefined to null; null and T unchanged. Returns Nullable&lt;T&gt;.\n * @param value - 可能为 null 或 undefined 的值 (value that may be null or undefined)\n * @returns 若为 undefined 则 null，否则原值 (null if undefined, otherwise value)\n * @example safeNullable(apiResponse.data) // undefined → null，便于区分「未设置」与「空」\n */\nexport function safeNullable<T>(value: Nilable<T>): Nullable<T> {\n  return (value === undefined ? null : value) as Nullable<T>;\n}\n\n/**\n * 将 Nilable 规范为 Maybe：null 转为 undefined，undefined 与 T 原样返回。返回类型 Maybe&lt;T&gt;。等同 value ?? undefined。\n * Normalize Nilable to Maybe: convert null to undefined; undefined and T unchanged. Returns Maybe&lt;T&gt;. Same as value ?? undefined.\n * @param value - 可能为 null 或 undefined 的值 (value that may be null or undefined)\n * @returns 若为 null 或 undefined 则 undefined，否则原值 (undefined if null/undefined, otherwise value)\n * @example safeMaybe(product.price) // 代替 product.price ?? undefined\n */\nexport function safeMaybe<T>(value: Nilable<T>): Maybe<T> {\n  return value ?? undefined;\n}\n\n/**\n * 将 Emptyable 字符串规范为 Nilable：空字符串转为 undefined，null/undefined/非空串原样。返回类型 Nilable&lt;T&gt;。常用于表单、接口字段。\n * Normalize Emptyable string to Nilable: \"\" to undefined; null, undefined, non-empty string unchanged. Returns Nilable&lt;T&gt;. For form/API fields.\n * @param value - 可能为 null、undefined 或空字符串 (value that may be null, undefined or \"\")\n * @returns 若为 \"\" 则 undefined，否则原值 (undefined if \"\", otherwise value)\n * @example safeNilable(product.remark) // \"\" 也视为「无值」\n */\nexport function safeNilable<T extends string>(value: Emptyable<T>): Nilable<T> {\n  return (value === \"\" ? undefined : value) as Nilable<T>;\n}\n\n/**\n * 将 Nilable 数组规范为数组：null/undefined 转为 [] 或 defaultValue。返回类型 Array&lt;T&gt;（即 T[]）。\n * Normalize Nilable array to array: null/undefined to [] or defaultValue. Returns Array&lt;T&gt; (i.e. T[]).\n * @param value - 可能为 null 或 undefined 的数组 (array that may be null or undefined)\n * @param defaultValue - 可选，当 value 为 null/undefined 时使用；缺省为 [] (optional default when value is null/undefined; default is [])\n * @returns value ?? defaultValue ?? [] (never null/undefined)\n * @example safeArray(product.tags) // product.tags ?? []\n * @example safeArray(product.tags, ['default'])\n *\n * 参数使用 `Array&lt;T&gt;`（即 `T[]`，见 `@/types`）与全库类型别名一致；入参也接受 `readonly T[]`，便于兼容只读数组来源。\n */\nexport function safeArray<T>(value: Nilable<Array<T> | readonly T[]>, defaultValue?: Array<T>): Array<T> {\n  const resolved = value ?? defaultValue;\n  if (resolved === undefined) {\n    return [] as Array<T>;\n  }\n  return resolved as Array<T>;\n}\n\n/**\n * 将 Nilable 数值规范为 Zeroable：null/undefined 转为 0。返回类型 Zeroable&lt;number&gt;（即 number，0 为兜底）。\n * Normalize Nilable number to Zeroable: null/undefined to 0. Returns Zeroable&lt;number&gt; (number with 0 as fallback).\n * @param value - 可能为 null 或 undefined 的数值 (number that may be null or undefined)\n * @returns value ?? 0 (never null/undefined)\n * @example safeZeroable(product.stock) // 代替 product.stock ?? 0\n */\nexport function safeZeroable(value: Nilable<number>): Zeroable<number> {\n  return (value ?? 0) as Zeroable<number>;\n}\n\n/**\n * 将 Emptyable 字符串规范为 Stringable：null/undefined/\"\" 转为 \"\"。返回类型 Stringable&lt;string&gt;（即 string，\"\" 为兜底）。\n * Normalize Emptyable string to Stringable: null/undefined/\"\" to \"\". Returns Stringable&lt;string&gt; (string with \"\" as fallback).\n * @param value - 可能为 null、undefined 或空字符串 (value that may be null, undefined or \"\")\n * @returns 若为 null、undefined 或 \"\" 则 \"\"，否则原值 (\"\" if null/undefined/\"\", otherwise value)\n * @example safeStringable(product.name) // 代替 product.name ?? \"\"\n */\nexport function safeStringable<T extends string>(value: Emptyable<T>): Stringable<T> {\n  if (value === null || value === undefined || value === \"\") return \"\" as Stringable<T>;\n  return value as Stringable<T>;\n}\n\n/**\n * 若值为 null/undefined 则返回默认值，否则返回原值。等同 value ?? defaultValue。\n * Return defaultValue when value is null/undefined, otherwise value. Same as value ?? defaultValue.\n * @param value - 可能为 null 或 undefined 的值 (value that may be null or undefined)\n * @param defaultValue - 默认值 (default value)\n * @returns value ?? defaultValue\n * @example safeOr(product.stock, 0)\n * @example safeOr(product.name, '')\n *\n * 使用两个类型参数时，若第一个实参无法收窄（例如索引访问、宽泛的 Record），`T` 可能被推断为 `unknown`，结果变成 `unknown`。\n * 因此提供**单类型**重载：当 `defaultValue` 与「有值时」的类型一致时，应写 `safeOr(x, fallback)` 且两者同型，返回即为 `T`。\n */\nexport function safeOr<T>(value: Nilable<T>, defaultValue: T): T;\nexport function safeOr<T, D>(value: Nilable<T>, defaultValue: D): T | D;\nexport function safeOr<T, D>(value: Nilable<T>, defaultValue: D): T | D {\n  return value ?? defaultValue;\n}\n\n/**\n * 将字符串规范为允许的枚举成员；非法或缺省时回落 defaultValue。\n */\nexport function safeEnum<T extends string>(value: Nilable<string>, allowed: readonly T[], defaultValue: T): T {\n  return typeof value === \"string\" && allowed.includes(value as T) ? (value as T) : defaultValue;\n}\n\n/**\n * 安全取数字：null/undefined/NaN 转为 undefined，合法数字原样。返回类型 Maybe&lt;number&gt;。\n * Safe number: null/undefined/NaN to undefined; valid number unchanged. Returns Maybe&lt;number&gt;.\n * @param value - 可能为 null、undefined 或非数字 (value that may be null, undefined or NaN)\n * @returns 若为 null、undefined 或 NaN 则 undefined，否则数字 (undefined if null/undefined/NaN, otherwise number)\n * @example safeNum(product.price) // 用于严格「有值才用」的场景\n */\nexport function safeNum(value: Nilable<number>): Maybe<number> {\n  if (value === null || value === undefined) return undefined;\n  const n = Number(value);\n  return Number.isNaN(n) ? undefined : n;\n}\n"],"mappings":";AAcA,SAAgB,EAAgB,GAAgC;CAC9D,OAAQ,MAAU,KAAA,IAAY,OAAO;AACvC;AASA,SAAgB,EAAa,GAA6B;CACxD,OAAO,KAAS,KAAA;AAClB;AASA,SAAgB,EAA8B,GAAiC;CAC7E,OAAQ,MAAU,KAAK,KAAA,IAAY;AACrC;AAaA,SAAgB,EAAa,GAAyC,GAAmC;CACvG,IAAM,IAAW,KAAS;CAI1B,OAHI,MAAa,KAAA,IACR,CAAC,IAEH;AACT;AASA,SAAgB,EAAa,GAA0C;CACrE,OAAQ,KAAS;AACnB;AASA,SAAgB,EAAiC,GAAoC;CAEnF,OADI,KAAU,QAA+B,MAAU,KAAW,KAC3D;AACT;AAgBA,SAAgB,EAAa,GAAmB,GAAwB;CACtE,OAAO,KAAS;AAClB;AAKA,SAAgB,EAA2B,GAAwB,GAAuB,GAAoB;CAC5G,OAAO,OAAO,KAAU,YAAY,EAAQ,SAAS,CAAU,IAAK,IAAc;AACpF;AASA,SAAgB,EAAQ,GAAuC;CAC7D,IAAI,KAAU,MAA6B;CAC3C,IAAM,IAAI,OAAO,CAAK;CACtB,OAAO,OAAO,MAAM,CAAC,IAAI,KAAA,IAAY;AACvC"}

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

@@ -1 +1 @@
-{"version":3,"file":"suspense.d.ts","sourceRoot":"","sources":["../../src/utils/suspense.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,SAAM,GAAG,CAAC,CAKnE"}
+{"version":3,"file":"suspense.d.ts","sourceRoot":"","sources":["../../src/utils/suspense.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,SAAM,GAAG,CAAC,CAKnE"}

package/dist/utils/suspense.js.map

@@ -1 +1 @@
-{"version":3,"file":"suspense.js","names":[],"sources":["../../src/utils/suspense.ts"],"sourcesContent":["import type { Nilable } from \"@/types\";\n\n/**\n * 若值为 null/undefined 则抛出 Promise 使 React Suspense 挂起，否则返回该值。\n * If value is null/undefined, throw a promise to suspend (React Suspense); otherwise return value.\n * @param value - 待检查的值。Value to check.\n * @param delay - 重试前的延迟（毫秒）。Delay in ms before retry.\n * @returns 非空时的 value。Value when non-null.\n * @example const data = suspenseIfNull(resource); // 在 Suspense 边界内，data 非空时才渲染\n */\nexport function suspenseIfNull<T>(value: Nilable<T>, delay = 100): T {\n  if (value == null) {\n    throw new Promise<void>((resolve) => setTimeout(resolve, delay));\n  }\n  return value;\n}\n"],"mappings":";AAUA,SAAgB,EAAkB,GAAmB,IAAQ,KAAQ;CACnE,IAAI,KAAS,MACX,MAAM,IAAI,SAAe,MAAY,WAAW,GAAS,CAAK,CAAC;CAEjE,OAAO;AACT"}
+{"version":3,"file":"suspense.js","names":[],"sources":["../../src/utils/suspense.ts"],"sourcesContent":["import type { Nilable } from \"nfx-ui/types\";\n\n/**\n * 若值为 null/undefined 则抛出 Promise 使 React Suspense 挂起，否则返回该值。\n * If value is null/undefined, throw a promise to suspend (React Suspense); otherwise return value.\n * @param value - 待检查的值。Value to check.\n * @param delay - 重试前的延迟（毫秒）。Delay in ms before retry.\n * @returns 非空时的 value。Value when non-null.\n * @example const data = suspenseIfNull(resource); // 在 Suspense 边界内，data 非空时才渲染\n */\nexport function suspenseIfNull<T>(value: Nilable<T>, delay = 100): T {\n  if (value == null) {\n    throw new Promise<void>((resolve) => setTimeout(resolve, delay));\n  }\n  return value;\n}\n"],"mappings":";AAUA,SAAgB,EAAkB,GAAmB,IAAQ,KAAQ;CACnE,IAAI,KAAS,MACX,MAAM,IAAI,SAAe,MAAY,WAAW,GAAS,CAAK,CAAC;CAEjE,OAAO;AACT"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nfx-ui",
-  "version": "0.26.0",
+  "version": "0.27.0",
   "type": "module",
   "sideEffects": [
     "**/*.css",

package/src/apis/authRefresh.ts

@@ -1,8 +1,8 @@
 import { AxiosError } from "axios";
-import { AuthStore, clearAuth, isRejectedRefreshToken, markRejectedRefreshToken, setTokens } from "@/stores/auth";
-import { ensureDeviceIdStorage } from "@/stores/system";
-import { getApiError } from "@/utils/apiError";
-import { getJwtExpiresAtMs, getJwtIssuedAtMs } from "@/utils/jwt";
+import { AuthStore, clearAuth, isRejectedRefreshToken, markRejectedRefreshToken, setTokens } from "nfx-ui/stores/auth";
+import { ensureDeviceIdStorage } from "nfx-ui/stores/system";
+import { getApiError } from "nfx-ui/utils/apiError";
+import { getJwtExpiresAtMs, getJwtIssuedAtMs } from "nfx-ui/utils/jwt";
 
 import { getIdentityRepositories } from "./activeIdentityRepositories";
 

package/src/apis/clients.ts

@@ -3,14 +3,14 @@
  * publicClient: login / refresh. protectedClient: Bearer + 401 → refreshAuthTokens.
  */
 import type { InternalAxiosRequestConfig } from "axios";
-import type { ApiErrorBody } from "@/types";
+import type { ApiErrorBody } from "nfx-ui/types";
 
 import axios, { AxiosError } from "axios";
 import applyCaseMiddleware from "axios-case-converter";
-import { authEventEmitter, authEvents } from "@/events/auth";
-import { AuthStore, clearAuth, hasSelectedProfile } from "@/stores/auth";
-import { shouldForceLogoutAfterAuthRetry, shouldImmediateForceLogoutOnApiError } from "@/utils/sessionErrors";
-import { safeOr } from "@/utils/safe";
+import { authEventEmitter, authEvents } from "nfx-ui/events/auth";
+import { AuthStore, clearAuth, hasSelectedProfile } from "nfx-ui/stores/auth";
+import { shouldForceLogoutAfterAuthRetry, shouldImmediateForceLogoutOnApiError } from "nfx-ui/utils/sessionErrors";
+import { safeOr } from "nfx-ui/utils/safe";
 
 import { refreshAuthTokens } from "./authRefresh";
 import { API_ENDPOINTS } from "./ip";

package/src/apis/ip.ts

@@ -1,4 +1,4 @@
-import type { DataResponse } from "@/types";
+import type { DataResponse } from "nfx-ui/types";
 
 import { path } from "./ip.path";
 

package/src/apis/repositories/AssetRepository.ts

@@ -1,4 +1,4 @@
-import type { Asset, DataResponse } from "@/types";
+import type { Asset, DataResponse } from "nfx-ui/types";
 
 import { protectedClient, publicClientWithoutTransform } from "../clients";
 import { API_ENDPOINTS, dataFromResponse, URL_PATHS } from "../ip";

package/src/apis/repositories/AuthRepository.ts

@@ -1,6 +1,6 @@
-import type { DataResponse, FullAccountInfoByKind, ListDTOWithTotalNumber, Login, Profile, ProfileItemsByKind, Signup, Tokens } from "@/types";
+import type { DataResponse, FullAccountInfoByKind, ListDTOWithTotalNumber, Login, Profile, ProfileItemsByKind, Signup, Tokens } from "nfx-ui/types";
 
-import { ProfileKindEnum } from "@/enums";
+import { ProfileKindEnum } from "nfx-ui/enums";
 
 import { protectedClient, publicClient, publicClientWithoutTransform } from "../clients";
 import { dataFromResponse, URL_PATHS } from "../ip";

package/src/config/env.ts

@@ -1,4 +1,4 @@
-import { safeOr, safeStringable } from "@/utils/safe";
+import { safeOr, safeStringable } from "nfx-ui/utils/safe";
 
 function resolveApiUrl(): string {
   const raw = safeStringable(import.meta.env.VITE_API_URL).trim();

package/src/constants/key.ts

@@ -1,6 +1,6 @@
 import type { QueryKey } from "@tanstack/react-query";
 
-import { ProfileKindEnum } from "@/enums";
+import { ProfileKindEnum } from "nfx-ui/enums";
 
 const DOMAIN_AUTH = "auth";
 

package/src/constants/querykeys.ts

@@ -4,7 +4,7 @@
  *
  * @example
  * ```ts
- * import { createListKey, createItemKey } from "@/constants";
+ * import { createListKey, createItemKey } from "nfx-ui/constants";
  *
  * const CATALOG_CATEGORY_LIST = createListKey("catalog", "category");
  * const CATALOG_CATEGORY = createItemKey("catalog", "category");

package/src/enums/auth.ts

@@ -4,9 +4,9 @@
  * 角色不在 JWT；能力门控按纯成员判定（hasRole / hasAnyRole）。
  */
 
-import type { Nilable } from "@/types";
+import type { Nilable } from "nfx-ui/types";
 
-import { safeArray, safeEnum } from "@/utils/safe";
+import { safeArray, safeEnum } from "nfx-ui/utils/safe";
 
 export function hasRole<T>(role: T, roles: Nilable<readonly T[]>): boolean {
   return safeArray(roles).includes(role);

package/src/enums/dashboard.ts

@@ -1,6 +1,6 @@
-import type { Array, Nilable } from "@/types";
+import type { Array, Nilable } from "nfx-ui/types";
 
-import { safeEnum } from "@/utils/safe";
+import { safeEnum } from "nfx-ui/utils/safe";
 
 /** 仪表盘背景。Dashboard background. */
 export enum DashboardBackgroundEnum {

package/src/enums/language.ts

@@ -1,9 +1,9 @@
 /**
  * 语言枚举与常量，不引用任何 JSON，供需要轻量引用的模块使用。
  */
-import type { Nilable } from "@/types";
+import type { Nilable } from "nfx-ui/types";
 
-import { safeEnum } from "@/utils/safe";
+import { safeEnum } from "nfx-ui/utils/safe";
 
 export enum LanguageEnum {
   EN = "en",

package/src/enums/layout.ts

@@ -1,6 +1,6 @@
-import type { Nilable } from "@/types";
+import type { Nilable } from "nfx-ui/types";
 
-import { safeEnum } from "@/utils/safe";
+import { safeEnum } from "nfx-ui/utils/safe";
 
 export enum LayoutModeEnum {
   SHOW = "show",

package/src/enums/theme.ts

@@ -1,6 +1,6 @@
-import { safeEnum } from "@/utils/safe";
+import { safeEnum } from "nfx-ui/utils/safe";
 
-import type { Nilable } from "@/types";
+import type { Nilable } from "nfx-ui/types";
 
 /** 基础主题枚举（平台/圆角等，如 iOS 24 / Android|Windows 6 / Linux 4） */
 export enum BaseEnum {

package/src/events/EventEmitter.ts

@@ -22,7 +22,7 @@
  * ```
  */
 
-import type { Defined, ValueOf } from "@/types";
+import type { Defined, ValueOf } from "nfx-ui/types";
 
 /** 回调类型：内部存储与 on/off 默认(unknown)时均用此，任意函数即可，无需 as 断言。 */
 type EventCallback = (...args: any[]) => void;

package/src/events/auth.ts

@@ -1,8 +1,8 @@
-import type { ProfileKindEnum } from "@/enums";
-import type { EventNamesOf } from "@/events/EventEmitter";
+import type { ProfileKindEnum } from "nfx-ui/enums";
+import type { EventNamesOf } from "nfx-ui/events/EventEmitter";
 
-import { defineEvents, EventEmitter } from "@/events/EventEmitter";
-import { singleton } from "@/utils/singleton";
+import { defineEvents, EventEmitter } from "nfx-ui/events/EventEmitter";
+import { singleton } from "nfx-ui/utils/singleton";
 
 export const authEvents = defineEvents({
   UPDATE_ACCOUNT_SUCCESS: "AUTH:UPDATE_ACCOUNT_SUCCESS",

package/src/events/query.ts

@@ -1,7 +1,7 @@
-import type { EventNamesOf } from "@/events/EventEmitter";
+import type { EventNamesOf } from "nfx-ui/events/EventEmitter";
 
-import { defineEvents, EventEmitter } from "@/events/EventEmitter";
-import { singleton } from "@/utils/singleton";
+import { defineEvents, EventEmitter } from "nfx-ui/events/EventEmitter";
+import { singleton } from "nfx-ui/utils/singleton";
 
 export const queryEvents = defineEvents({
   RESET_ACTIVE_QUERIES: "QUERY:RESET_ACTIVE_QUERIES",

package/src/events/system.ts

@@ -1,7 +1,7 @@
-import type { EventNamesOf } from "@/events/EventEmitter";
+import type { EventNamesOf } from "nfx-ui/events/EventEmitter";
 
-import { defineEvents, EventEmitter } from "@/events/EventEmitter";
-import { singleton } from "@/utils/singleton";
+import { defineEvents, EventEmitter } from "nfx-ui/events/EventEmitter";
+import { singleton } from "nfx-ui/utils/singleton";
 
 /**
  * Host-agnostic UI feedback. Package emits; WEB ModalProvider listens.

package/src/hooks/asset.ts

@@ -2,15 +2,15 @@
  * Asset upload hooks — 组件勿直接调 apis/asset
  */
 import type { AxiosError } from "axios";
-import type { Asset } from "@/types";
+import type { Asset } from "nfx-ui/types";
 
 import { useMutation } from "@tanstack/react-query";
-import { useAssetRepository } from "@/apis/repositories";
-import { authEventEmitter, authEvents } from "@/events/auth";
-import { systemEventEmitter } from "@/events/system";
-import { AuthStore } from "@/stores/auth";
-import { getApiErrorMessage } from "@/utils/apiError";
-import { useUnifiedQuery } from "@/utils/factory";
+import { useAssetRepository } from "nfx-ui/apis/repositories";
+import { authEventEmitter, authEvents } from "nfx-ui/events/auth";
+import { systemEventEmitter } from "nfx-ui/events/system";
+import { AuthStore } from "nfx-ui/stores/auth";
+import { getApiErrorMessage } from "nfx-ui/utils/apiError";
+import { useUnifiedQuery } from "nfx-ui/utils/factory";
 
 export type UseDeleteImageOptions = {
   ifShowError?: boolean;

package/src/hooks/auth.ts

@@ -2,15 +2,15 @@
  * Auth hooks — 组件勿直接调 apis/auth
  */
 import type { AxiosError } from "axios";
-import type { CurrentProfileResult, Login, Profile, Signup } from "@/types";
+import type { CurrentProfileResult, Login, Profile, Signup } from "nfx-ui/types";
 
 import { useEffect } from "react";
 import { useMutation } from "@tanstack/react-query";
-import { useAuthRepository } from "@/apis/repositories";
-import { AUTH_EMAILS, AUTH_ME, AUTH_PHONES, AUTH_PROFILES } from "@/constants";
-import { AuthSignupPlatformEnum, LanguageEnum, ProfileKindEnum } from "@/enums";
-import { authEventEmitter, authEvents } from "@/events/auth";
-import { systemEventEmitter } from "@/events/system";
+import { useAuthRepository } from "nfx-ui/apis/repositories";
+import { AUTH_EMAILS, AUTH_ME, AUTH_PHONES, AUTH_PROFILES } from "nfx-ui/constants";
+import { AuthSignupPlatformEnum, LanguageEnum, ProfileKindEnum } from "nfx-ui/enums";
+import { authEventEmitter, authEvents } from "nfx-ui/events/auth";
+import { systemEventEmitter } from "nfx-ui/events/system";
 import {
   AuthStore,
   clearAuth,
@@ -22,12 +22,12 @@ import {
   setIsAuthValid,
   setTokens,
   useAuthStore,
-} from "@/stores/auth";
-import { ensureDeviceIdStorage } from "@/stores/system";
-import { getApiErrorMessage } from "@/utils/apiError";
-import { pickProfile } from "@/utils/domain/account";
-import { useUnifiedQuery } from "@/utils/factory";
-import { safeOr, safeStringable } from "@/utils/safe";
+} from "nfx-ui/stores/auth";
+import { ensureDeviceIdStorage } from "nfx-ui/stores/system";
+import { getApiErrorMessage } from "nfx-ui/utils/apiError";
+import { pickProfile } from "nfx-ui/utils/domain/account";
+import { useUnifiedQuery } from "nfx-ui/utils/factory";
+import { safeOr, safeStringable } from "nfx-ui/utils/safe";
 import { useTranslation } from "react-i18next";
 
 export function useAuthQueryScope() {

package/src/hooks/index.ts

@@ -14,4 +14,4 @@ export {
   usePreferenceLabel,
   getThemeDisplayName,
   useThemeLabel,
-} from "@/languages/hooks";
+} from "nfx-ui/languages/hooks";

package/src/hooks/preference.ts

@@ -1,19 +1,19 @@
 /**
  * Shared preference hooks — appearance resolve + host-configured server sync.
  */
-import type { PreferencePatch, ResolvedPreference } from "@/stores/preference";
-import type { RadixAppearance } from "@/themes/radix";
+import type { PreferencePatch, ResolvedPreference } from "nfx-ui/stores/preference";
+import type { RadixAppearance } from "nfx-ui/themes/radix";
 
 import { useEffect, useRef, useState } from "react";
 
-import { AppearanceEnum } from "@/enums/theme";
+import { AppearanceEnum } from "nfx-ui/enums/theme";
 import {
   PreferenceStore,
   replacePreference,
   setPreference,
   usePreferenceStore,
-} from "@/stores/preference";
-import { readSystemRadixAppearance, resolveRadixAppearance } from "@/themes/radix";
+} from "nfx-ui/stores/preference";
+import { readSystemRadixAppearance, resolveRadixAppearance } from "nfx-ui/themes/radix";
 
 /** 将 theme.appearance（含 system）解析为当前生效的 Radix light|dark，并在跟随系统时响应 OS 切换。 */
 export function useResolvedAppearance(): RadixAppearance {

package/src/languages/hooks/useLanguageLabel.ts

@@ -1,7 +1,7 @@
 import i18n from "i18next";
 import { useTranslation } from "react-i18next";
 
-import { BaseEnum } from "@/enums/theme";
+import { BaseEnum } from "nfx-ui/enums/theme";
 import { LanguageEnum } from "../types";
 
 function getLanguageI18nKey(lang: LanguageEnum): string {

package/src/languages/hooks/useLayoutLabel.ts

@@ -2,7 +2,7 @@
  * 返回 { getLayoutDisplayName }，便于扩展；getLayoutDisplayName 可传给 SlideDownSwitcher 的 getDisplayName。
  * Returns { getLayoutDisplayName } for extensibility; pass to SlideDownSwitcher getDisplayName.
  */
-import type { LayoutModeEnum } from "@/enums/layout";
+import type { LayoutModeEnum } from "nfx-ui/enums/layout";
 
 import { useCallback, useMemo } from "react";
 

package/src/languages/hooks/usePreferenceLabel.ts

@@ -2,7 +2,7 @@
  * 返回 { getPreferenceDisplayName }（Base 展示名），便于扩展；可传给 SlideDownSwitcher 的 getDisplayName。
  * Returns { getPreferenceDisplayName } for extensibility; pass to SlideDownSwitcher getDisplayName.
  */
-import type { BaseEnum } from "@/enums/theme";
+import type { BaseEnum } from "nfx-ui/enums/theme";
 
 import { useCallback, useMemo } from "react";
 

package/src/languages/hooks/useThemeLabel.ts

@@ -1,7 +1,7 @@
 /**
  * Accent / appearance labels for ThemeSettings.
  */
-import type { AccentColorEnum } from "@/enums/theme";
+import type { AccentColorEnum } from "nfx-ui/enums/theme";
 
 import { useCallback, useMemo } from "react";
 

package/src/languages/languages/i18n.ts

@@ -8,9 +8,9 @@ import i18n from "i18next";
 import LanguageDetector from "i18next-browser-languagedetector";
 import { initReactI18next } from "react-i18next";
 
-import { LanguageEnum, LANGUAGE_VALUES } from "@/enums/language";
-import { PreferenceStore, setPreference } from "@/stores/preference";
-import { safeEnum, safeStringable } from "@/utils/safe";
+import { LanguageEnum, LANGUAGE_VALUES } from "nfx-ui/enums/language";
+import { PreferenceStore, setPreference } from "nfx-ui/stores/preference";
+import { safeEnum, safeStringable } from "nfx-ui/utils/safe";
 
 import { getDefaultNfxBundles } from "../resources";
 

package/src/languages/languages/i18nResources.ts

@@ -5,7 +5,7 @@
 import type { CreateI18nResourcesResult, LanguageEnum, NameSpacesMap, Resources } from "../types";
 
 import i18n from "./i18n";
-import { setPreference } from "@/stores/preference";
+import { setPreference } from "nfx-ui/stores/preference";
 
 /**
  * 由调用方传入 resources 和 nameSpacesMap，生成 i18n 所需的 RESOURCES、NAME_SPACES_MAP、NAME_SPACES。

package/src/languages/types/components.ts

@@ -1,4 +1,4 @@
 /**
  * 语言相关组件的 Props 类型。
  */
-export type { LanguageProviderProps } from "@/providers/LanguageProvider";
+export type { LanguageProviderProps } from "nfx-ui/providers/LanguageProvider";

package/src/languages/types/language.ts

@@ -1,4 +1,4 @@
 /**
  * 语言枚举与常量 — 从 enums 再导出，避免 languages 模块重复定义。
  */
-export { LanguageEnum, DEFAULT_LANGUAGE, LANGUAGE_VALUES, Language } from "@/enums/language";
+export { LanguageEnum, DEFAULT_LANGUAGE, LANGUAGE_VALUES, Language } from "nfx-ui/enums/language";

package/src/languages/utils/getLocalLanguage.ts

@@ -1,8 +1,8 @@
 /**
  * 获取本地语言：PreferenceStore 为唯一真相。
  */
-import { PreferenceStore } from "@/stores/preference";
-import { DEFAULT_LANGUAGE, type LanguageEnum } from "@/enums/language";
+import { PreferenceStore } from "nfx-ui/stores/preference";
+import { DEFAULT_LANGUAGE, type LanguageEnum } from "nfx-ui/enums/language";
 
 export function getLocalLanguage(): LanguageEnum {
   return PreferenceStore.getState().language ?? DEFAULT_LANGUAGE;

package/src/languages/utils/languageStorage.ts

@@ -1,10 +1,10 @@
 /**
  * Language helpers backed by PreferenceStore (CityPulso: no separate language-storage key).
  */
-import type { Nilable } from "@/types/utils";
+import type { Nilable } from "nfx-ui/types/utils";
 
-import { LANGUAGE_VALUES, LanguageEnum } from "@/enums/language";
-import { PreferenceStore, setPreference } from "@/stores/preference";
+import { LANGUAGE_VALUES, LanguageEnum } from "nfx-ui/enums/language";
+import { PreferenceStore, setPreference } from "nfx-ui/stores/preference";
 
 export function getLanguageStorage(): Nilable<LanguageEnum> {
   const raw = PreferenceStore.getState().language;

package/src/navigations/GuestRoute.tsx

@@ -2,7 +2,7 @@
  * Guest-only outlet — redirects away when session + profile are already selected.
  * Host supplies product home path via `redirectTo`.
  */
-import { hasSelectedProfile, useAuthStore } from "@/stores/auth";
+import { hasSelectedProfile, useAuthStore } from "nfx-ui/stores/auth";
 import { Navigate, Outlet } from "react-router";
 
 export interface GuestRouteProps {

package/src/navigations/ProtectedRoute.tsx

@@ -2,7 +2,7 @@
  * Auth-gated outlet — redirects to login when session/profile missing.
  * Host supplies product login path via `redirectTo`.
  */
-import { hasSelectedProfile, useAuthStore } from "@/stores/auth";
+import { hasSelectedProfile, useAuthStore } from "nfx-ui/stores/auth";
 import { Navigate, Outlet, useLocation } from "react-router";
 
 export interface ProtectedRouteProps {

package/src/providers/DataProvider/index.tsx

@@ -1,13 +1,13 @@
-import type { IdentityRepositories } from "@/apis";
+import type { IdentityRepositories } from "nfx-ui/apis";
 import type { ReactNode } from "react";
 
 import { useEffect, useMemo } from "react";
-import { ApiAssetRepository, ApiAuthRepository, IdentityRepositoriesContext, setIdentityRepositories, useAuthRepository } from "@/apis";
-import { scheduleAccessTokenRefresh } from "@/apis/authRefresh";
-import { useAuthQueryScope, useCurrentProfile } from "@/hooks/auth";
-import { configurePreferenceSync, useApplyPreferenceOnLoad } from "@/hooks/preference";
-import { AuthStore, hasSelectedProfile, subscribeAuthStorageSync } from "@/stores/auth";
-import { parseServerPreference, toServerPreference } from "@/stores/preference";
+import { ApiAssetRepository, ApiAuthRepository, IdentityRepositoriesContext, setIdentityRepositories, useAuthRepository } from "nfx-ui/apis";
+import { scheduleAccessTokenRefresh } from "nfx-ui/apis/authRefresh";
+import { useAuthQueryScope, useCurrentProfile } from "nfx-ui/hooks/auth";
+import { configurePreferenceSync, useApplyPreferenceOnLoad } from "nfx-ui/hooks/preference";
+import { AuthStore, hasSelectedProfile, subscribeAuthStorageSync } from "nfx-ui/stores/auth";
+import { parseServerPreference, toServerPreference } from "nfx-ui/stores/preference";
 
 const defaultIdentityRepositories: IdentityRepositories = {
   auth: new ApiAuthRepository(),

package/src/providers/LanguageProvider/index.tsx

@@ -2,16 +2,16 @@
  * Shared LanguageProvider — host passes product builtin bundles.
  * Identity error/message namespaces load here (PulsoLink LanguageProvider pattern).
  */
-import type { CreateI18nResourcesResult, ExtraBundleItem, onLoadExtraBundles } from "@/languages/types";
+import type { CreateI18nResourcesResult, ExtraBundleItem, onLoadExtraBundles } from "nfx-ui/languages/types";
 import type { ReactNode } from "react";
 
 import { useEffect, useRef } from "react";
 
-import { getIdentityRepositories } from "@/apis";
-import { DEFAULT_LANGUAGE, LANGUAGE_VALUES, LanguageEnum } from "@/enums/language";
-import i18n, { initI18n, toSupportedLanguage } from "@/languages/languages/i18n";
-import { PreferenceStore } from "@/stores/preference";
-import { ERRORS_NS_IDENTITY, MESSAGES_NS_IDENTITY } from "@/utils/apiError";
+import { getIdentityRepositories } from "nfx-ui/apis";
+import { DEFAULT_LANGUAGE, LANGUAGE_VALUES, LanguageEnum } from "nfx-ui/enums/language";
+import i18n, { initI18n, toSupportedLanguage } from "nfx-ui/languages/languages/i18n";
+import { PreferenceStore } from "nfx-ui/stores/preference";
+import { ERRORS_NS_IDENTITY, MESSAGES_NS_IDENTITY } from "nfx-ui/utils/apiError";
 
 export interface LanguageProviderProps {
   children: ReactNode;

package/src/providers/ThemeProvider/index.tsx

@@ -2,16 +2,16 @@
  * Shared Radix Theme provider — reads unified preference store.
  * Host may pass document side-effects (e.g. favicon) via `onAppearanceChange`.
  */
-import type { RadixAppearance } from "@/themes/radix";
+import type { RadixAppearance } from "nfx-ui/themes/radix";
 import type { ReactNode } from "react";
 
 import { useEffect } from "react";
 import { Theme } from "@radix-ui/themes";
 
-import { useResolvedAppearance } from "@/hooks/preference";
-import { usePreferenceStore } from "@/stores/preference";
+import { useResolvedAppearance } from "nfx-ui/hooks/preference";
+import { usePreferenceStore } from "nfx-ui/stores/preference";
 
-import "@/themes/index.css";
+import "nfx-ui/themes/index.css";
 
 export interface ThemeProviderProps {
   children: ReactNode;

package/src/schemas/profileEditSchema.ts

@@ -1,10 +1,10 @@
 import type { TFunction } from "i18next";
-import type { Profile } from "@/types";
+import type { Profile } from "nfx-ui/types";
 
 import { zodResolver } from "@hookform/resolvers/zod";
-import { Language, LanguageEnum } from "@/enums";
-import { toDateInputValue } from "@/utils/time";
-import { safeStringable } from "@/utils/safe";
+import { Language, LanguageEnum } from "nfx-ui/enums";
+import { toDateInputValue } from "nfx-ui/utils/time";
+import { safeStringable } from "nfx-ui/utils/safe";
 import { useForm } from "react-hook-form";
 import { useTranslation } from "react-i18next";
 import { z } from "zod";

package/src/schemas/signupSchema.ts

@@ -1,7 +1,7 @@
 import type { TFunction } from "i18next";
 
 import { zodResolver } from "@hookform/resolvers/zod";
-import { normalizeVerificationCode, VERIFICATION_CODE_ALPHABET } from "@/utils/domain/verificationCode";
+import { normalizeVerificationCode, VERIFICATION_CODE_ALPHABET } from "nfx-ui/utils/domain/verificationCode";
 import { useForm } from "react-hook-form";
 import { useTranslation } from "react-i18next";
 import { z } from "zod";

package/src/stores/auth.ts

@@ -1,7 +1,7 @@
-import type { Tokens } from "@/types";
+import type { Tokens } from "nfx-ui/types";
 
-import { DEFAULT_PROFILE_KIND, ProfileKind, ProfileKindEnum } from "@/enums";
-import { makeStore } from "@/stores/makeStore";
+import { DEFAULT_PROFILE_KIND, ProfileKind, ProfileKindEnum } from "nfx-ui/enums";
+import { makeStore } from "nfx-ui/stores/makeStore";
 
 /**
  * Auth session: memory is source of truth.

package/src/stores/index.ts

@@ -3,4 +3,4 @@ export * from "./preference";
 export * from "./layout";
 export * from "./auth";
 export * from "./system";
-export { DashboardBackgroundEnum, DEFAULT_DASHBOARD_BACKGROUND, DASHBOARD_BACKGROUND_VALUES } from "@/enums/dashboard";
+export { DashboardBackgroundEnum, DEFAULT_DASHBOARD_BACKGROUND, DASHBOARD_BACKGROUND_VALUES } from "nfx-ui/enums/dashboard";

package/src/stores/layout.ts

@@ -1,4 +1,4 @@
-import { makePersistStore } from "@/stores/makeStore";
+import { makePersistStore } from "nfx-ui/stores/makeStore";
 
 interface LayoutState {
   headerHeight: number;