nfx-ui 0.16.2 → 0.20.0

package/dist/src/designs/components/ShowFilter/index.d.ts

@@ -1,40 +0,0 @@
-/**
- * 显示/隐藏筛选器：开关 + 全部/显示/隐藏选项；文案由调用方传入。Show/hide filter; labels passed as props.
- *
- * @example
- * ```tsx
- * * 受控，不传文案则用默认英文；可传 i18n
- * <ShowFilter value={filter} onChange={setFilter} />
- * <ShowFilter value={filter} onChange={setFilter} all={t("showFilter.all")} show={t("showFilter.show")} hide={t("showFilter.hide")} />
- * ```
- */
-import type { ReactNode } from "react";
-export interface ShowFilterValue {
-    /** 筛选是否启用。Whether filter is enabled. */
-    enabled: boolean;
-    /** 显示/隐藏：null=全部，true=显示，false=隐藏。Show/hide: null=all, true=show, false=hide. */
-    value: boolean | null;
-}
-export interface ShowFilterProps {
-    /** 当前值。Current value. */
-    value: ShowFilterValue;
-    /** 值变化回调。Change callback. */
-    onChange: (value: ShowFilterValue) => void;
-    /** 筛选开启时的按钮文案。Label when filter enabled. */
-    filterEnabled?: ReactNode;
-    /** 筛选关闭时的按钮文案。Label when filter disabled. */
-    filterDisabled?: ReactNode;
-    /** 开启筛选按钮的 aria-label。Aria-label for enable filter button. */
-    enableFilterAriaLabel?: string;
-    /** 关闭筛选按钮的 aria-label。Aria-label for disable filter button. */
-    disableFilterAriaLabel?: string;
-    /** 「全部」选项文案。Label for "all" option. */
-    all?: ReactNode;
-    /** 「显示」选项文案。Label for "show" option. */
-    show?: ReactNode;
-    /** 「隐藏」选项文案。Label for "hide" option. */
-    hide?: ReactNode;
-}
-declare const ShowFilter: import("react").MemoExoticComponent<({ value, onChange, filterEnabled, filterDisabled, enableFilterAriaLabel, disableFilterAriaLabel, all, show, hide, }: ShowFilterProps) => import("react").JSX.Element>;
-export default ShowFilter;
-//# sourceMappingURL=index.d.ts.map

package/dist/src/designs/components/ShowFilter/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/designs/components/ShowFilter/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAQvC,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,iFAAiF;IACjF,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,KAAK,EAAE,eAAe,CAAC;IACvB,6BAA6B;IAC7B,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IAC3C,4CAA4C;IAC5C,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,6CAA6C;IAC7C,cAAc,CAAC,EAAE,SAAS,CAAC;IAC3B,8DAA8D;IAC9D,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,+DAA+D;IAC/D,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,uCAAuC;IACvC,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,wCAAwC;IACxC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,wCAAwC;IACxC,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED,QAAA,MAAM,UAAU,4JAWX,eAAe,iCAyCnB,CAAC;AAIF,eAAe,UAAU,CAAC"}

package/dist/src/designs/components/SlideDownSwitcher/index.d.ts

@@ -1,17 +0,0 @@
-export interface SlideDownSwitcherProps<T extends string> {
-    /** 当前选中的值（enum 或 string） */
-    value: T;
-    /** 可选项列表（如 Object.values(SomeEnum)） */
-    options: readonly T[];
-    /** 选项展示文案 */
-    getDisplayName: (value: T) => string;
-    /** 选中后回调 */
-    onChange: (value: T) => void;
-    status?: "primary" | "default";
-}
-declare const SlideDownSwitcherInner: <T extends string>({ value, options, getDisplayName, onChange, status }: SlideDownSwitcherProps<T>) => import("react").JSX.Element;
-declare const SlideDownSwitcher: typeof SlideDownSwitcherInner & {
-    displayName?: string;
-};
-export default SlideDownSwitcher;
-//# sourceMappingURL=index.d.ts.map

package/dist/src/designs/components/SlideDownSwitcher/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/designs/components/SlideDownSwitcher/index.tsx"],"names":[],"mappings":"AAmBA,MAAM,WAAW,sBAAsB,CAAC,CAAC,SAAS,MAAM;IACtD,4BAA4B;IAC5B,KAAK,EAAE,CAAC,CAAC;IACT,uCAAuC;IACvC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;IACtB,aAAa;IACb,cAAc,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC;IACrC,YAAY;IACZ,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC7B,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CAChC;AAED,QAAA,MAAM,sBAAsB,GAAI,CAAC,SAAS,MAAM,EAAE,sDAAkE,sBAAsB,CAAC,CAAC,CAAC,gCAgE5I,CAAC;AAEF,QAAA,MAAM,iBAAiB,EAAmC,OAAO,sBAAsB,GAAG;IACxF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAGF,eAAe,iBAAiB,CAAC"}

package/dist/src/designs/components/Slider/index.d.ts

@@ -1,39 +0,0 @@
-/**
- * 滑块：受控 value/onChange，支持 min/max/step、label、error、overflow 动效。Slider; controlled value/onChange, min/max/step, label, error.
- *
- * @example
- * ```tsx
- * * 基础
- * <Slider value={volume} onChange={setVolume} min={0} max={100} />
- * * 带标签与辅助文案
- * <Slider label="音量" value={volume} onChange={setVolume} showValue helperText="0-100" />
- * ```
- */
-import type { ReactNode } from "react";
-export interface SliderProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange"> {
-    /** 当前值。Current value. */
-    value: number;
-    /** 值变化回调。Change callback. */
-    onChange: (value: number) => void;
-    /** 最小值。Minimum. */
-    min?: number;
-    /** 最大值。Maximum. */
-    max?: number;
-    /** 步长。Step. */
-    step?: number;
-    /** 是否显示数值。Show value. */
-    showValue?: boolean;
-    /** 是否占满宽度。Full width. */
-    fullWidth?: boolean;
-    /** 标签文案。Label text. */
-    label?: ReactNode;
-    /** 错误信息。Error message. */
-    error?: ReactNode;
-    /** 辅助说明。Helper text. */
-    helperText?: ReactNode;
-    /** 是否必填。Required. */
-    required?: boolean;
-}
-declare const Slider: import("react").NamedExoticComponent<SliderProps & import("react").RefAttributes<HTMLDivElement>>;
-export default Slider;
-//# sourceMappingURL=index.d.ts.map

package/dist/src/designs/components/Slider/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/designs/components/Slider/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAWvC,MAAM,WAAW,WAAY,SAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC;IACzF,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,mBAAmB;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,eAAe;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yBAAyB;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uBAAuB;IACvB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,wBAAwB;IACxB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,QAAA,MAAM,MAAM,mGAiKX,CAAC;AAaF,eAAe,MAAM,CAAC"}

package/dist/src/designs/components/Textarea/index.d.ts

@@ -1,33 +0,0 @@
-/**
- * 多行文本框：支持 label、error、helperText、左右图标与 size/variant。Textarea with label, error, helperText, left/right icon.
- *
- * @example
- * ```tsx
- * * 基础用法
- * <Textarea label="备注" value={note} onChange={(e) => setNote(e.target.value)} rows={4} />
- * * 错误态
- * <Textarea error={errors.note} helperText="选填" />
- * ```
- */
-import type { ReactNode, TextareaHTMLAttributes } from "react";
-export interface TextareaProps extends Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, "size"> {
-    /** 标签文案。Label text. */
-    label?: ReactNode;
-    /** 错误信息。Error message. */
-    error?: ReactNode;
-    /** 辅助说明。Helper text. */
-    helperText?: ReactNode;
-    /** 左侧图标。Left icon. */
-    leftIcon?: ReactNode;
-    /** 右侧图标。Right icon. */
-    rightIcon?: ReactNode;
-    /** 尺寸。Size. */
-    size?: "small" | "medium" | "large";
-    /** 视觉变体。Variant. */
-    variant?: "default" | "filled";
-    /** 是否占满宽度。Full width. */
-    fullWidth?: boolean;
-}
-declare const Textarea: import("react").ForwardRefExoticComponent<TextareaProps & import("react").RefAttributes<HTMLTextAreaElement>>;
-export default Textarea;
-//# sourceMappingURL=index.d.ts.map

package/dist/src/designs/components/Textarea/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/designs/components/Textarea/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,OAAO,CAAC;AAM/D,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,sBAAsB,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC9F,uBAAuB;IACvB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,wBAAwB;IACxB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,uBAAuB;IACvB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,eAAe;IACf,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpC,oBAAoB;IACpB,OAAO,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC/B,yBAAyB;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,QAAA,MAAM,QAAQ,+GA0Bb,CAAC;AAIF,eAAe,QAAQ,CAAC"}

package/dist/src/hooks/makeCursorFetchFunction.d.ts

@@ -1,85 +0,0 @@
-import type { ListDTOWithNextCursor, ListDTOWithTotalNumber } from "@/types/api";
-import type { FetchNumberListParams, FetchStringListParams } from "./type";
-/**
- * 创建基于游标（Cursor）的分页获取函数
- *
- * 将标准的分页 API（基于 offset/limit）转换为游标分页函数，用于无限查询。
- * 自动计算下一页游标，并支持数据后处理。
- *
- * @template T - 数据项类型
- * @template F - 过滤器对象类型，必须是对象类型，默认为 Record<string, unknown>
- *
- * @param {Function} fetchFunc - 远程数据获取函数，接收 FetchListParams 参数，返回包含 items 和 total 的结果
- * @param {number} [pageSize=20] - 每页数据条数，默认 20
- * @param {Function} [postProcess] - 可选的数据后处理函数，在每次数据获取后调用
- *
- * @returns {Function} 返回一个游标分页函数，接收 pageParam（页码）和 filter（过滤器）参数
- *
- * @example
- * ```tsx
- * * 定义标准的分页 API
- * const fetchProductsAPI = async (params: { offset: number; limit: number; category?: string }) => {
- *   const response = await fetch('/api/products?' + new URLSearchParams(params));
- *   const { items, total } = await response.json();
- *   return { items, total };
- * };
- *
- * * 创建游标分页函数
- * const fetchProducts = makeCursorFetchFunction(
- *   fetchProductsAPI,
- *   20,
- *   (data) => {
- *     * 数据后处理：为每个商品添加缓存
- *     data.forEach(product => cache.set(product.id, product));
- *   }
- * );
- *
- * * 使用游标函数
- * const firstPage = await fetchProducts(0, { category: "electronics" });
- * * 返回: ListDTOWithTotalNumber<Product> = { items, total }
- * * getNextPageParam 由 makeUnifiedInfiniteQuery 根据 total 与 pageSize 计算
- * ```
- *
- * @remarks
- * **为什么需要游标转换？**
- * - React Query 的无限查询使用 pageParam（游标）来跟踪分页位置
- * - 后端 API 通常使用 offset/limit 分页，两者需要转换才能配合使用
- * - 游标模式更适合无限滚动，避免在组件中手动计算 offset
- *
- * **游标计算逻辑：**
- * - **offset 计算**：`offset = pageParam × pageSize`
- *   - 示例：pageParam=0 → offset=0（第一页）
- *   - 示例：pageParam=2, pageSize=20 → offset=40（第三页，跳过前 40 条）
- * - **nextCursor 判断**：`(pageParam + 1) × pageSize < total ? pageParam + 1 : undefined`
- *   - 如果下一页的起始位置小于总数，返回下一页页码
- *   - 否则返回 undefined，告知 React Query 没有更多数据
- *
- * **为什么 pageParam 从 0 开始？**
- * - 符合数组索引习惯，第 0 页、第 1 页...
- * - 计算 offset 时公式更简洁：`offset = pageParam × pageSize`
- * - 避免使用 1-based 索引时需要额外的 -1 运算
- *
- * **postProcess 的作用：**
- * - 在数据返回后、缓存前执行，适合进行副作用操作
- * - 常见用途：更新单项缓存、触发分析事件、数据预处理
- * - 不影响返回值，保持数据流的纯净性
- */
-declare function makeCursorFetchFunction<T, F extends object = Record<string, unknown>>(fetchFunc: (params: FetchNumberListParams<F>) => Promise<ListDTOWithTotalNumber<T>>, pageSize?: number, postProcess?: (data: T[]) => void): (pageParam?: number, filter?: F) => Promise<ListDTOWithTotalNumber<T>>;
-/**
- * 创建基于字符串游标的分页获取函数（用于 nextCursor 为 string 的 API）。
- * Creates cursor-based fetch function for string cursor (API returns nextCursor: string).
- *
- * @param fetchFunc - 远程获取函数，参数含 offset: string, limit，返回 { items, nextCursor }。Fetch (params: FetchStringListParams<F>) => Promise<ListDTOWithNextCursor<T>>.
- * @param pageSize - 每页条数，默认 20。Page size.
- * @param postProcess - 可选，数据返回后调用。Optional post-process (data: T[]) => void.
- * @returns 返回 (pageParam: string, filter?: F) => Promise<ListDTOWithNextCursor<T>>。Returns async cursor fetcher.
- * @example
- * ```ts
- * const fetch = makeStringCursorFetchFunction(fetchByToken, 20);
- * const page = await fetch("", { q: "x" });
- * if (page.nextCursor) await fetch(page.nextCursor, { q: "x" });
- * ```
- */
-declare function makeStringCursorFetchFunction<T, F extends object = Record<string, unknown>>(fetchFunc: (params: FetchStringListParams<F>) => Promise<ListDTOWithNextCursor<T>>, pageSize?: number, postProcess?: (data: T[]) => void): (pageParam?: string, filter?: F) => Promise<ListDTOWithNextCursor<T>>;
-export { makeCursorFetchFunction, makeStringCursorFetchFunction };
-//# sourceMappingURL=makeCursorFetchFunction.d.ts.map

package/dist/src/hooks/makeCursorFetchFunction.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"makeCursorFetchFunction.d.ts","sourceRoot":"","sources":["../../../src/hooks/makeCursorFetchFunction.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,KAAK,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,QAAQ,CAAC;AAE3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,iBAAS,uBAAuB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5E,SAAS,EAAE,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,EACnF,QAAQ,GAAE,MAAW,EACrB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,IAAI,IAEnB,YAAW,MAAU,EAAE,SAAS,CAAC,KAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAUrF;AAED;;;;;;;;;;;;;;GAcG;AACH,iBAAS,6BAA6B,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClF,SAAS,EAAE,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,EAClF,QAAQ,GAAE,MAAW,EACrB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,IAAI,IAEnB,YAAW,MAAW,EAAE,SAAS,CAAC,KAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAUrF;AAED,OAAO,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,CAAC"}

package/dist/src/hooks/makeUnifiedInfiniteQuery.d.ts

@@ -1,125 +0,0 @@
-import type { QueryKey, UseInfiniteQueryResult, UseSuspenseInfiniteQueryResult } from "@tanstack/react-query";
-import type { AxiosError } from "axios";
-import type { ListDTOWithTotalNumber } from "@/types/api";
-import type { FetchNumberListParams, InfiniteQueryOptions, SuspenseInfiniteQueryOptions } from "./type";
-/**
- * 创建统一的无限查询 Hook（Suspense 模式）
- *
- * 这是一个高阶函数工厂，用于创建支持无限滚动的数据查询 Hook。
- * 它自动处理分页、缓存、错误重试等常见场景，并支持 Suspense 模式。
- *
- * @template T - 数据项类型
- * @template F - 过滤器对象类型，必须是对象类型，默认为 Record<string, unknown>
- *
- * @param {Function} fetchRemote - 远程数据获取函数，接收分页参数和过滤器，返回 Promise
- * @param {string} mode - 查询模式，设置为 "suspense" 启用 React Suspense 支持
- * @param {number} [pageSize=20] - 每页数据条数，默认 20
- * @param {Function} [postProcess] - 可选的数据后处理函数，在数据返回后调用
- *
- * @returns {Function} 返回一个 Hook 函数，接收 queryKey、filter 和 options 参数
- *
- * @example
- * ```tsx
- * * 定义 API 获取函数
- * const fetchProducts = async (params: FetchListParams<ProductFilter>) => {
- *   const { items, total } = await api.getProducts(params);
- *   return { items, total };
- * };
- *
- * * 创建 Hook（Suspense 模式）
- * const useProductList = makeUnifiedInfiniteQuery(
- *   fetchProducts,
- *   "suspense",
- *   20,
- *   (data) => console.warn('数据已加载:', data.length)
- * );
- *
- * * 在组件中使用
- * function ProductList() {
- *   const { data, fetchNextPage, hasNextPage } = useProductList(
- *     ["products"],
- *     { category: "electronics" },
- *     { staleTime: 60000 }
- *   );
- *
- *   return (
- *     <div>
- *       {data.map(product => <ProductCard key={product.id} {...product} />)}
- *       {hasNextPage && <button onClick={() => fetchNextPage()}>加载更多</button>}
- *     </div>
- *   );
- * }
- * ```
- *
- * @remarks
- * **为什么需要这个函数？**
- * - React Query 的无限查询 API 较为底层，需要手动配置 queryFn、initialPageParam、getNextPageParam 等
- * - 大多数列表查询都有相似的分页逻辑（offset/limit），重复编写这些配置容易出错
- * - 通过工厂函数统一封装，确保分页逻辑的一致性，减少样板代码
- *
- * **为什么区分 Suspense 和普通模式？**
- * - Suspense 模式：数据未就绪时会挂起组件渲染，适合配合 React Suspense 边界使用
- * - 普通模式：提供 isLoading 状态，需要手动处理加载状态，更灵活
- * - 两种模式的 Hook 返回类型不同，TypeScript 需要通过函数重载区分
- *
- * **内部实现原理：**
- * 1. **游标转换**：使用 makeCursorFetchFunction 将 offset/limit 转换为页码游标
- * 2. **查询键构造**：自动将 filter 合并到 queryKey 中，确保不同过滤条件有独立缓存
- * 3. **数据扁平化**：通过 select 将分页数据 pages 扁平化为单一数组，简化组件使用
- * 4. **智能重试**：仅对 5xx 服务器错误和网络错误重试，避免对 4xx 客户端错误无意义重试
- * 5. **选项合并**：使用 spread 运算符允许外部覆盖默认配置（如 staleTime、retry）
- */
-declare function makeUnifiedInfiniteQuery<T, F extends object = Record<string, unknown>>(fetchRemote: (params: FetchNumberListParams<F>) => Promise<ListDTOWithTotalNumber<T>>, mode: "suspense", pageSize?: number, postProcess?: (data: T[]) => void): (queryKey: QueryKey, filter?: F, options?: SuspenseInfiniteQueryOptions<T>) => UseSuspenseInfiniteQueryResult<T[], AxiosError>;
-/**
- * 创建统一的无限查询 Hook（普通模式）
- *
- * 这是一个高阶函数工厂，用于创建支持无限滚动的数据查询 Hook。
- * 它自动处理分页、缓存、错误重试等常见场景，普通模式不使用 Suspense。
- *
- * @template T - 数据项类型
- * @template F - 过滤器对象类型，必须是对象类型，默认为 Record<string, unknown>
- *
- * @param {Function} fetchRemote - 远程数据获取函数，接收分页参数和过滤器，返回 Promise
- * @param {string} [mode="normal"] - 查询模式，设置为 "normal" 或省略使用普通模式
- * @param {number} [pageSize=20] - 每页数据条数，默认 20
- * @param {Function} [postProcess] - 可选的数据后处理函数，在数据返回后调用
- *
- * @returns {Function} 返回一个 Hook 函数，接收 queryKey、filter 和 options 参数
- *
- * @example
- * ```tsx
- * * 定义 API 获取函数
- * const fetchProducts = async (params: FetchListParams<ProductFilter>) => {
- *   const { items, total } = await api.getProducts(params);
- *   return { items, total };
- * };
- *
- * * 创建 Hook（普通模式）
- * const useProductList = makeUnifiedInfiniteQuery(
- *   fetchProducts,
- *   "normal",  * 或省略此参数
- *   20
- * );
- *
- * * 在组件中使用
- * function ProductList() {
- *   const { data, fetchNextPage, hasNextPage, isLoading } = useProductList(
- *     ["products"],
- *     { category: "electronics" },
- *     { staleTime: 60000 }
- *   );
- *
- *   if (isLoading) return <Loading />;
- *
- *   return (
- *     <div>
- *       {data?.map(product => <ProductCard key={product.id} {...product} />)}
- *       {hasNextPage && <button onClick={() => fetchNextPage()}>加载更多</button>}
- *     </div>
- *   );
- * }
- * ```
- */
-declare function makeUnifiedInfiniteQuery<T, F extends object = Record<string, unknown>>(fetchRemote: (params: FetchNumberListParams<F>) => Promise<ListDTOWithTotalNumber<T>>, mode?: "normal", pageSize?: number, postProcess?: (data: T[]) => void): (queryKey: QueryKey, filter?: F, options?: InfiniteQueryOptions<T>) => UseInfiniteQueryResult<T[], AxiosError>;
-export { makeUnifiedInfiniteQuery };
-//# sourceMappingURL=makeUnifiedInfiniteQuery.d.ts.map

package/dist/src/hooks/makeUnifiedInfiniteQuery.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"makeUnifiedInfiniteQuery.d.ts","sourceRoot":"","sources":["../../../src/hooks/makeUnifiedInfiniteQuery.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,QAAQ,EAAE,sBAAsB,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AAC5H,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAwC,4BAA4B,EAAE,MAAM,QAAQ,CAAC;AAU9I;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkEG;AACH,iBAAS,wBAAwB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7E,WAAW,EAAE,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,EACrF,IAAI,EAAE,UAAU,EAChB,QAAQ,CAAC,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,IAAI,GAChC,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,4BAA4B,CAAC,CAAC,CAAC,KAAK,8BAA8B,CAAC,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;AAElI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,iBAAS,wBAAwB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7E,WAAW,EAAE,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,EACrF,IAAI,CAAC,EAAE,QAAQ,EACf,QAAQ,CAAC,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,IAAI,GAChC,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,KAAK,sBAAsB,CAAC,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;AAkBlH,OAAO,EAAE,wBAAwB,EAAE,CAAC"}

package/dist/src/hooks/makeUnifiedQuery.d.ts

@@ -1,20 +0,0 @@
-import type { QueryKey, UseQueryOptions, UseQueryResult, UseSuspenseQueryOptions, UseSuspenseQueryResult } from "@tanstack/react-query";
-import type { AxiosError } from "axios";
-/**
- * 创建统一的单条查询 Hook 工厂（支持 normal / suspense 模式）。
- * Creates a unified single-item query Hook factory (normal or suspense mode).
- *
- * @param fetchRemote - 拉取函数，接收 filter 返回 Promise<T>。Fetch function (params: F) => Promise<T>.
- * @param mode - "suspense" 或 "normal"（默认）。Query mode.
- * @param postProcess - 可选，数据返回后调用。Optional post-process (data: T) => void.
- * @returns 返回一个 Hook：(queryKey, filter?, options?) => UseQueryResult 或 UseSuspenseQueryResult。Returns a Hook.
- * @example
- * ```ts
- * const useProfile = makeUnifiedQuery(fetchProfile, "normal");
- * const { data } = useProfile(profileKey, { id }, { enabled: !!id });
- * ```
- */
-declare function makeUnifiedQuery<T, F extends object = Record<string, unknown>>(fetchRemote: (params: F) => Promise<T>, mode: "suspense", postProcess?: (data: T) => void): (queryKey: QueryKey, filter?: F, options?: Omit<UseSuspenseQueryOptions<T, AxiosError, T>, "queryKey" | "queryFn">) => UseSuspenseQueryResult<T, AxiosError>;
-declare function makeUnifiedQuery<T, F extends object = Record<string, unknown>>(fetchRemote: (params: F) => Promise<T>, mode?: "normal", postProcess?: (data: T) => void): (queryKey: QueryKey, filter?: F, options?: Omit<UseQueryOptions<T, AxiosError, T>, "queryKey" | "queryFn">) => UseQueryResult<T, AxiosError>;
-export { makeUnifiedQuery };
-//# sourceMappingURL=makeUnifiedQuery.d.ts.map

package/dist/src/hooks/makeUnifiedQuery.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"makeUnifiedQuery.d.ts","sourceRoot":"","sources":["../../../src/hooks/makeUnifiedQuery.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,cAAc,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACxI,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAWxC;;;;;;;;;;;;;GAaG;AAEH,iBAAS,gBAAgB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrE,WAAW,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EACtC,IAAI,EAAE,UAAU,EAChB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,GAC9B,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,uBAAuB,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC,KAAK,sBAAsB,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;AAEhK,iBAAS,gBAAgB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrE,WAAW,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EACtC,IAAI,CAAC,EAAE,QAAQ,EACf,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,GAC9B,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC,KAAK,cAAc,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;AA+ChJ,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/src/hooks/type.d.ts

@@ -1,41 +0,0 @@
-/**
- * Hooks 模块类型：分页 payload、列表参数、React Query options 等。
- * Types for hooks: page payloads, list params, React Query options.
- */
-import type { UseInfiniteQueryOptions, UseQueryOptions, UseSuspenseInfiniteQueryOptions, UseSuspenseQueryOptions } from "@tanstack/react-query";
-import type { AxiosError } from "axios";
-import type { ListDTOWithNextCursor, ListDTOWithTotalNumber, OffsetLimitNumber, OffsetLimitString } from "@/types/api";
-/** 普通模式（useQuery），可配合 enabled 等。Normal mode (useQuery); supports enabled etc. */
-declare const NORMAL: "normal";
-/** Suspense 模式（useSuspenseQuery），由 React 挂起。Suspense mode (useSuspenseQuery); suspended by React. */
-declare const SUSPENSE: "suspense";
-/** 仅允许 "normal" | "suspense"，请使用 NORMAL / SUSPENSE 避免拼写错误。Only "normal" | "suspense"; use NORMAL / SUSPENSE to avoid typos. */
-type QueryMode = typeof NORMAL | typeof SUSPENSE;
-/** F & OffsetLimitNumber，数字分页列表请求参数。Params for number-offset list fetch. */
-type FetchNumberListParams<F extends object = Record<string, unknown>> = F & OffsetLimitNumber;
-/** F & OffsetLimitString，字符串游标列表请求参数。Params for string-cursor list fetch. */
-type FetchStringListParams<F extends object = Record<string, unknown>> = F & OffsetLimitString;
-/** 变更上下文（如 prev）。Mutation context (e.g. prev). */
-type MutationCtx = {
-    prev?: unknown;
-};
-/** 无限查询 options（不含 queryKey/queryFn/getNextPageParam/initialPageParam）。Infinite query options (excludes queryKey, queryFn, getNextPageParam, initialPageParam). */
-type InfiniteQueryOptions<T> = Omit<UseInfiniteQueryOptions<ListDTOWithTotalNumber<T>, AxiosError, T[]>, "queryKey" | "queryFn" | "getNextPageParam" | "initialPageParam">;
-/** 字符串游标无限查询 options。String-cursor infinite query options. */
-type StringInfiniteQueryOptions<T> = Omit<UseInfiniteQueryOptions<ListDTOWithNextCursor<T>, AxiosError, T[]>, "queryKey" | "queryFn" | "getNextPageParam" | "initialPageParam">;
-/** Suspense 无限查询 options。Suspense infinite query options. */
-type SuspenseInfiniteQueryOptions<T> = Omit<UseSuspenseInfiniteQueryOptions<ListDTOWithTotalNumber<T>, AxiosError, T[]>, "queryKey" | "queryFn" | "getNextPageParam" | "initialPageParam">;
-/** InfiniteQueryOptions | SuspenseInfiniteQueryOptions。Union of normal and suspense infinite query options. */
-type InfiniteQueryOptionsUnion<T> = InfiniteQueryOptions<T> | SuspenseInfiniteQueryOptions<T>;
-/** 单条查询 Suspense options。Single-item suspense query options. */
-type SuspenseUnifiedQueryOptions<T> = Omit<UseSuspenseQueryOptions<T, AxiosError, T>, "queryKey" | "queryFn">;
-/** 普通单条查询 options（含 enabled）。Normal single-item query options (includes enabled). */
-type NormalUnifiedQueryOptions<T> = Omit<UseQueryOptions<T, AxiosError, T>, "queryKey" | "queryFn">;
-/** 单条查询参数（options、postProcess + 业务参数）。Single-item query params (options, postProcess, and business params). */
-type UnifiedQueryParams<T> = {
-    options?: SuspenseUnifiedQueryOptions<T>;
-    postProcess?: (data: T) => void;
-} & Record<string, unknown>;
-export { NORMAL, SUSPENSE };
-export type { FetchNumberListParams, FetchStringListParams, InfiniteQueryOptions, InfiniteQueryOptionsUnion, MutationCtx, NormalUnifiedQueryOptions, QueryMode, StringInfiniteQueryOptions, SuspenseInfiniteQueryOptions, SuspenseUnifiedQueryOptions, UnifiedQueryParams, };
-//# sourceMappingURL=type.d.ts.map

package/dist/src/hooks/type.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../../src/hooks/type.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,uBAAuB,EAAE,eAAe,EAAE,+BAA+B,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChJ,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,KAAK,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAIvH,iFAAiF;AACjF,QAAA,MAAM,MAAM,EAAG,QAAiB,CAAC;AAEjC,qGAAqG;AACrG,QAAA,MAAM,QAAQ,EAAG,UAAmB,CAAC;AAErC,+HAA+H;AAC/H,KAAK,SAAS,GAAG,OAAO,MAAM,GAAG,OAAO,QAAQ,CAAC;AAKjD,4EAA4E;AAC5E,KAAK,qBAAqB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC;AAE/F,6EAA6E;AAC7E,KAAK,qBAAqB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,iBAAiB,CAAC;AAE/F,kDAAkD;AAClD,KAAK,WAAW,GAAG;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAIF,mKAAmK;AACnK,KAAK,oBAAoB,CAAC,CAAC,IAAI,IAAI,CACjC,uBAAuB,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,EACnE,UAAU,GAAG,SAAS,GAAG,kBAAkB,GAAG,kBAAkB,CACjE,CAAC;AAEF,8DAA8D;AAC9D,KAAK,0BAA0B,CAAC,CAAC,IAAI,IAAI,CACvC,uBAAuB,CAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,EAClE,UAAU,GAAG,SAAS,GAAG,kBAAkB,GAAG,kBAAkB,CACjE,CAAC;AAEF,6DAA6D;AAC7D,KAAK,4BAA4B,CAAC,CAAC,IAAI,IAAI,CACzC,+BAA+B,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,EAC3E,UAAU,GAAG,SAAS,GAAG,kBAAkB,GAAG,kBAAkB,CACjE,CAAC;AAEF,+GAA+G;AAC/G,KAAK,yBAAyB,CAAC,CAAC,IAAI,oBAAoB,CAAC,CAAC,CAAC,GAAG,4BAA4B,CAAC,CAAC,CAAC,CAAC;AAE9F,gEAAgE;AAChE,KAAK,2BAA2B,CAAC,CAAC,IAAI,IAAI,CAAC,uBAAuB,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC,CAAC;AAE9G,qFAAqF;AACrF,KAAK,yBAAyB,CAAC,CAAC,IAAI,IAAI,CAAC,eAAe,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC,CAAC;AAEpG,+GAA+G;AAC/G,KAAK,kBAAkB,CAAC,CAAC,IAAI;IAC3B,OAAO,CAAC,EAAE,2BAA2B,CAAC,CAAC,CAAC,CAAC;IACzC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;CACjC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAC5B,YAAY,EACV,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,EACzB,WAAW,EACX,yBAAyB,EACzB,SAAS,EACT,0BAA0B,EAC1B,4BAA4B,EAC5B,2BAA2B,EAC3B,kBAAkB,GACnB,CAAC"}

package/dist/src/languages/providers/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * 语言提供者：首次渲染时同步初始化 i18n（保证内层 ModalProvider 等子组件 useTranslation 时已就绪），再用 useEffect 应用本地语言。
- * Language provider: inits i18n synchronously on first render so inner children (e.g. ModalProvider) have i18n ready; then useEffect applies getLocalLanguage.
- */
-import type { LanguageProviderProps } from "../types";
-declare const LanguageProvider: import("react").MemoExoticComponent<({ children, bundles, fallbackLng, onLoadExtraBundles }: LanguageProviderProps) => import("react").JSX.Element>;
-export default LanguageProvider;
-//# sourceMappingURL=index.d.ts.map

package/dist/src/languages/providers/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/languages/providers/index.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAOtD,QAAA,MAAM,gBAAgB,+FAAiE,qBAAqB,iCAc1G,CAAC;AAGH,eAAe,gBAAgB,CAAC"}

package/dist/src/preference/constants.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/preference/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,yCAAyC;AACzC,oBAAY,uBAAuB;IACjC,IAAI,SAAS;IACb,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,aAAa,iBAAiB;IAC9B,WAAW,eAAe;CAC3B;AAED,eAAO,MAAM,4BAA4B,+BAA+B,CAAC;AAEzE,mDAAmD;AACnD,eAAO,MAAM,2BAA2B,EAAE,KAAK,CAAC,uBAAuB,CAA0C,CAAC"}

package/dist/src/preference/core.d.ts

@@ -1,12 +0,0 @@
-import type { Nilable, Nullable } from "@/types";
-import { type Preference } from "./types";
-/**
- * 解析后端 preference 字符串：`nfx` 由本包规范化（缺省或非对象则按 `{}` → 默认值）；
- * `parseExtra(rest)` 的 `rest` 为根对象去掉 `nfx` 后的键值（宿主扩展，线 snake / 内存 camel 在函数内自行处理）。
- */
-export declare function parsePreferenceJson<TExtra extends Record<string, unknown> = Record<string, unknown>>(json: Nilable<string>, parseExtra?: (raw: Record<string, unknown>) => TExtra): Nullable<Preference<TExtra>>;
-/**
- * 序列化：`serializeExtra` 把内存中的扩展部分写成根上要合并的顶层键；省略则对扩展做浅拷贝（键名原样写入 JSON）。
- */
-export declare function preferenceToJson<TExtra extends Record<string, unknown> = Record<string, unknown>>(preference: Preference<TExtra>, serializeExtra?: (extra: TExtra) => Record<string, unknown>): string;
-//# sourceMappingURL=core.d.ts.map

package/dist/src/preference/core.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/preference/core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGjD,OAAO,EAAoD,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAE5F;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClG,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,EACrB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,GACpD,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAe9B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/F,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,EAC9B,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1D,MAAM,CAOR"}

package/dist/src/preference/index.d.ts

@@ -1,27 +0,0 @@
-/**
- * 用户偏好：`profile.preference` JSON 约定。
- *
- * **模型**
- * - 根上必有逻辑上的 `nfx`（若缺失或非法则按 `{}` 解析后再套 NFX 默认值）。
- * - 与 `nfx` 平级的其它键：**只**由宿主在 `parsePreferenceJson(json, parseExtra)` 的第二参数里处理；
- *   `parseExtra` 收到的是「已去掉 `nfx` 后的对象」。
- * - 内存类型：`Preference<TExtra> = { nfx: NfxPreferenceSlice } & TExtra`。
- *
- * **API**
- * - `parsePreferenceJson(json, parseExtra?)` — 解析；缺省/非法 `nfx` 会规范化后再合并扩展。
- * - `preferenceToJson(preference, serializeExtra?)` — 序列化；扩展键由 `serializeExtra` 或浅拷贝写出。
- *
- * @example 仅 nfx
- * `parsePreferenceJson('{}')` → `{ nfx: 默认值 }`（不再因缺 `nfx` 而得到 `null`）
- *
- * @example 扩展
- * ```ts
- * const p = parsePreferenceJson('{"nfx":{},"my_app":{"k":1}}', (raw) => ({
- *   myApp: { k: Number((raw.my_app as { k?: unknown })?.k) || 0 },
- * }));
- * ```
- */
-export { DashboardBackgroundEnum, DEFAULT_DASHBOARD_BACKGROUND, DASHBOARD_BACKGROUND_VALUES } from "./constants";
-export { parsePreferenceJson, preferenceToJson } from "./core";
-export { NFX_PREFERENCE_ROOT_KEY, type NfxPreferenceSlice, type Preference } from "./types";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/preference/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/preference/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAEjH,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAE/D,OAAO,EAAE,uBAAuB,EAAE,KAAK,kBAAkB,EAAE,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC"}

package/dist/src/preference/nfx_slice.d.ts

@@ -1,24 +0,0 @@
-import { LayoutModeEnum } from "@/designs/layouts/types";
-import { LanguageEnum } from "@/languages/types";
-import { BaseEnum, ThemeEnum } from "@/themes/types";
-import { DashboardBackgroundEnum } from "./constants";
-import type { NfxPreferenceSlice } from "./types";
-/** 后端 `nfx` 对象允许的 JSON 形状（字段均可选）。 */
-export type NfxBackendShape = {
-    theme?: ThemeEnum;
-    base?: BaseEnum;
-    language?: LanguageEnum;
-    layoutMode?: LayoutModeEnum;
-    dashboardBackground?: DashboardBackgroundEnum;
-};
-/** 判断值是否为「普通对象」（非 null、非数组）。 */
-export declare function isPlainRecord(v: unknown): v is Record<string, unknown>;
-/**
- * 将后端 `nfx` 对象的原始字段规范化为前端 `NfxPreferenceSlice`（非法或缺失字段用 NFX 默认值）。
- */
-export declare function parseNfxFields(raw: NfxBackendShape): NfxPreferenceSlice;
-/**
- * 将前端 `NfxPreferenceSlice` 转为写入 JSON 的 `nfx` 对象（与 `theme`/`base`/`language` 的省略规则一致）。
- */
-export declare function nfxSliceToBackend(nfx: NfxPreferenceSlice): NfxBackendShape;
-//# sourceMappingURL=nfx_slice.d.ts.map

package/dist/src/preference/nfx_slice.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"nfx_slice.d.ts","sourceRoot":"","sources":["../../../src/preference/nfx_slice.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAmB,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAe,QAAQ,EAAgB,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhF,OAAO,EAA+B,uBAAuB,EAAgC,MAAM,aAAa,CAAC;AACjH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,qCAAqC;AACrC,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,mBAAmB,CAAC,EAAE,uBAAuB,CAAC;CAC/C,CAAC;AAEF,gCAAgC;AAChC,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEtE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,eAAe,GAAG,kBAAkB,CAiBvE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,kBAAkB,GAAG,eAAe,CAQ1E"}

package/dist/src/preference/types.d.ts

@@ -1,28 +0,0 @@
-import type { LayoutModeEnum } from "@/designs/layouts/types";
-import type { LanguageEnum } from "@/languages/types";
-import type { BaseEnum, ThemeEnum } from "@/themes/types";
-import type { DashboardBackgroundEnum } from "./constants";
-/**
- * 根对象上 NFX 内置块使用的键名（字面量 `"nfx"`）。
- * Literal key name for the NFX slice on the preference JSON root.
- */
-export declare const NFX_PREFERENCE_ROOT_KEY: "nfx";
-/**
- * NFX 负责的内置字段（存于 JSON 的 `nfx` 对象内）。
- * Built-in fields owned by NFX (nested under the `nfx` object in JSON).
- */
-export type NfxPreferenceSlice = {
-    theme: ThemeEnum;
-    base: BaseEnum;
-    language: LanguageEnum;
-    layoutMode: LayoutModeEnum;
-    dashboardBackground: DashboardBackgroundEnum;
-};
-/**
- * 完整偏好：必有 `nfx`；`TExtra` 为与 `nfx` 平级的其它顶层键。
- * 默认 `TExtra` 为 `Record<string, unknown>`（**勿用** `Record<string, never>`：会与 `nfx` 索引冲突导致无法赋值）。
- */
-export type Preference<TExtra extends Record<string, unknown> = Record<string, unknown>> = {
-    nfx: NfxPreferenceSlice;
-} & TExtra;
-//# sourceMappingURL=types.d.ts.map

package/dist/src/preference/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/preference/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAG,KAAc,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,YAAY,CAAC;IACvB,UAAU,EAAE,cAAc,CAAC;IAC3B,mBAAmB,EAAE,uBAAuB,CAAC;CAC9C,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,UAAU,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IACzF,GAAG,EAAE,kBAAkB,CAAC;CACzB,GAAG,MAAM,CAAC"}

package/dist/src/themes/hooks/useBaseVariables.d.ts

@@ -1,8 +0,0 @@
-import type { BaseTheme } from "../types";
-/**
- * 将当前基础主题（圆角、间距、字号等非颜色 token）注入到 document 的 CSS Variables。
- * Injects base theme tokens (radius, spacing, typography, etc.) as CSS custom properties on :root.
- */
-declare const useBaseVariables: (base: BaseTheme) => void;
-export default useBaseVariables;
-//# sourceMappingURL=useBaseVariables.d.ts.map

package/dist/src/themes/hooks/useBaseVariables.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useBaseVariables.d.ts","sourceRoot":"","sources":["../../../../src/themes/hooks/useBaseVariables.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAK1C;;;GAGG;AACH,QAAA,MAAM,gBAAgB,GAAI,MAAM,SAAS,SAkExC,CAAC;AAEF,eAAe,gBAAgB,CAAC"}

package/dist/src/themes/hooks/useThemeVariables.d.ts

@@ -1,11 +0,0 @@
-import type { Theme, ThemeEnum } from "../types";
-/**
- * 将当前主题变量注入到 document 的 CSS Variables，并持久化主题名到 localStorage。
- * Injects current theme variables into document CSS custom properties and persists theme name to localStorage.
- *
- * @param currentTheme - 完整主题对象（颜色 + 基础）。Full theme (colors + base).
- * @param themeName - 当前主题枚举名，用于持久化。Current theme enum key for persistence.
- */
-declare const useThemeVariables: (currentTheme: Theme, themeName: ThemeEnum) => void;
-export default useThemeVariables;
-//# sourceMappingURL=useThemeVariables.d.ts.map

package/dist/src/themes/hooks/useThemeVariables.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useThemeVariables.d.ts","sourceRoot":"","sources":["../../../../src/themes/hooks/useThemeVariables.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAIjD;;;;;;GAMG;AACH,QAAA,MAAM,iBAAiB,GAAI,cAAc,KAAK,EAAE,WAAW,SAAS,SA4HnE,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/dist/src/themes/hooks/useVariables.d.ts

@@ -1,8 +0,0 @@
-import type { Theme, ThemeEnum } from "../types";
-/**
- * 注入完整主题：颜色变量（useThemeVariables）+ 基础 token（useBaseVariables），并持久化颜色主题名。
- * Full theme injection: color variables + base tokens; persists color theme name.
- */
-declare const useVariables: (currentTheme: Theme, themeName: ThemeEnum) => void;
-export default useVariables;
-//# sourceMappingURL=useVariables.d.ts.map

package/dist/src/themes/hooks/useVariables.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useVariables.d.ts","sourceRoot":"","sources":["../../../../src/themes/hooks/useVariables.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAIjD;;;GAGG;AACH,QAAA,MAAM,YAAY,GAAI,cAAc,KAAK,EAAE,WAAW,SAAS,SAG9D,CAAC;AAEF,eAAe,YAAY,CAAC"}