nfx-ui 0.7.4 → 0.9.0

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

@@ -0,0 +1,36 @@
+import { UseInfiniteQueryOptions, UseQueryOptions, UseSuspenseInfiniteQueryOptions, UseSuspenseQueryOptions } from '@tanstack/react-query';
+import { AxiosError } from 'axios';
+import { 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, };

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

@@ -0,0 +1 @@
+export * from './lucide';

package/dist/src/icons/lucide.d.ts

@@ -0,0 +1,2 @@
+export type { LucideIcon } from 'lucide-react';
+export { AlertCircle, ArrowLeft, ArrowRight, Ban, Bell, Box, Briefcase, Calendar, Camera, Check, CheckCircle, ChevronDown, ChevronLeft, ChevronRight, ChevronUp, Clock, Coffee, CreditCard, DollarSign, Edit, ExternalLink, Eye, EyeOff, FileText, Filter, FolderOpen, FolderPlus, FolderTree, Folders, Globe, GraduationCap, GripVertical, Hash, History, Home, Image, Info, Languages, LayoutGrid, LayoutList, Leaf, Layers, List, Loader, Loader2, Lock, LockKeyhole, LogOut, Mail, Menu, MessageCircle, Package, Pencil, Phone, Plus, Search, Settings, Shield, Tag, Trash2, TrendingUp, Upload, User, UserCheck, UserPlus, UserRound, UserRoundSearch, UserX, Wand2, X, XCircle, } from 'lucide-react';

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

@@ -0,0 +1,8 @@
+/**
+ * 语言模块 Hooks：返回 { getXxxDisplayName }，便于扩展；getXxxDisplayName 可传给 SlideDownSwitcher getDisplayName。
+ * Language hooks: return { getXxxDisplayName } for extensibility; pass to SlideDownSwitcher getDisplayName.
+ */
+export { getLanguageDisplayName, useLanguageLabel } from './useLanguageLabel';
+export { getLayoutDisplayName, useLayoutLabel } from './useLayoutLabel';
+export { getPreferenceDisplayName, usePreferenceLabel } from './usePreferenceLabel';
+export { getThemeDisplayName, useThemeLabel } from './useThemeLabel';

package/dist/src/languages/hooks/useLanguageLabel.d.ts

@@ -0,0 +1,6 @@
+import { LanguageEnum } from '../types';
+declare function getLanguageDisplayNameImpl(lang: LanguageEnum): string;
+export declare function useLanguageLabel(): {
+    getLanguageDisplayName: (lang: LanguageEnum) => string;
+};
+export { getLanguageDisplayNameImpl as getLanguageDisplayName };

package/dist/src/languages/hooks/useLayoutLabel.d.ts

@@ -0,0 +1,6 @@
+import { LayoutModeEnum } from '../../../designs/layouts/types';
+declare function getLayoutDisplayNameImpl(mode: LayoutModeEnum): string;
+export declare function useLayoutLabel(): {
+    getLayoutDisplayName: (mode: LayoutModeEnum) => string;
+};
+export { getLayoutDisplayNameImpl as getLayoutDisplayName };

package/dist/src/languages/hooks/usePreferenceLabel.d.ts

@@ -0,0 +1,6 @@
+import { BaseEnum } from '../../../themes/types';
+declare function getPreferenceDisplayNameImpl(base: BaseEnum): string;
+export declare function usePreferenceLabel(): {
+    getPreferenceDisplayName: (base: BaseEnum) => string;
+};
+export { getPreferenceDisplayNameImpl as getPreferenceDisplayName };

package/dist/src/languages/hooks/useThemeLabel.d.ts

@@ -0,0 +1,6 @@
+import { ThemeEnum } from '../../../themes/types';
+declare function getThemeDisplayNameImpl(theme: ThemeEnum): string;
+export declare function useThemeLabel(): {
+    getThemeDisplayName: (theme: ThemeEnum) => string;
+};
+export { getThemeDisplayNameImpl as getThemeDisplayName };

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

@@ -0,0 +1,11 @@
+/**
+ * 语言模块统一导出。Languages module barrel exports.
+ */
+export * from './hooks';
+export * from './languages';
+export { default as i18n } from './languages/i18n';
+export { default as LanguageProvider } from './providers';
+export * from './providers';
+export * from './resources';
+export * from './types';
+export * from './utils';

package/dist/src/languages/languages/i18n.d.ts

@@ -0,0 +1,8 @@
+import { InitI18nOptions } from '../types';
+import { default as i18n } from 'i18next';
+/**
+ * 初始化 i18n。会先合并 NFX-UI 自带的四类 JSON（theme/language/layout/preference），再与用户传入的 bundles 合并（用户可覆盖）。
+ * Init i18n. Merges built-in NFX bundles (theme, language, layout, preference) with user bundles (user overrides).
+ */
+export declare function initI18n(options: InitI18nOptions): void;
+export default i18n;

package/dist/src/languages/languages/i18nResources.d.ts

@@ -0,0 +1,13 @@
+import { CreateI18nResourcesResult, LanguageEnum, NameSpacesMap, Resources } from '../types';
+/**
+ * 由调用方传入 resources 和 nameSpacesMap，生成 i18n 所需的 RESOURCES、NAME_SPACES_MAP、NAME_SPACES。
+ * Caller provides resources and nameSpacesMap; returns RESOURCES, NAME_SPACES_MAP, NAME_SPACES for i18n.
+ *
+ * @param resources - 各语言下的命名空间文案。Bundles per language.
+ * @param nameSpacesMap - 命名空间 key → 命名空间字符串。Namespace key to string.
+ */
+declare function createI18nResources(resources: Resources, nameSpacesMap: NameSpacesMap): CreateI18nResourcesResult;
+/** 切换当前语言。Switch current language. */
+declare function changeLanguage(lng: LanguageEnum): void;
+export { createI18nResources, changeLanguage };
+export type { CreateI18nResourcesResult, Resources, NameSpacesMap, NamespaceBundle } from '../types';

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

@@ -0,0 +1,2 @@
+export * from './i18n';
+export * from './i18nResources';

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

@@ -0,0 +1,3 @@
+import { LanguageProviderProps } from '../types';
+declare const LanguageProvider: import('react').MemoExoticComponent<({ children, bundles, fallbackLng, onLoadExtraBundles }: LanguageProviderProps) => import("react/jsx-runtime").JSX.Element>;
+export default LanguageProvider;

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

@@ -0,0 +1,8 @@
+import { CreateI18nResourcesResult, NameSpacesMap } from '../types';
+export declare const NFX_NAMESPACES: readonly ["theme", "language", "layout", "preference"];
+export declare const NFX_NAMESPACES_MAP: NameSpacesMap;
+/**
+ * 返回 NFX-UI 默认文案包，可与使用方自建 resources 合并后传入 createI18nResources。
+ * Returns default NFX bundles; merge with your resources and pass to createI18nResources.
+ */
+export declare function getDefaultNfxBundles(): CreateI18nResourcesResult;

package/dist/src/languages/types/components.d.ts

@@ -0,0 +1,23 @@
+import { ReactNode } from 'react';
+import { CreateI18nResourcesResult, onLoadExtraBundles } from './i18n';
+import { LanguageEnum } from './language';
+/** 语言 Provider 的 props。LanguageProvider props. */
+export interface LanguageProviderProps {
+    /** 子节点。Children. */
+    children: ReactNode;
+    /** 用户自建 JSON 后调用 createI18nResources 得到的结果。Result of createI18nResources(resources, nameSpacesMap). */
+    bundles: CreateI18nResourcesResult;
+    /** 回退语言。Fallback language. */
+    fallbackLng?: LanguageEnum;
+    /** 语言切换后拉取额外文案（如错误码）；返回 { namespace, bundle }，由 Provider 内部 addResourceBundle。Caller only fetches; Provider injects. */
+    onLoadExtraBundles?: onLoadExtraBundles;
+}
+/** 语言切换器 props。LanguageSwitcher props. */
+export interface LanguageSwitcherProps {
+    /** 样式状态。Visual status. */
+    status?: "primary" | "default";
+    /** 根据 lang 返回显示名称；未传则使用 lang 原值。Display name for language; default is lang value. */
+    getLanguageDisplayName?: (lang: LanguageEnum) => string;
+    /** 处理语言改变。Handle language change. */
+    handleChangeLanguage?: (language: LanguageEnum) => void;
+}

package/dist/src/languages/types/i18n.d.ts

@@ -0,0 +1,28 @@
+import { LanguageEnum } from './language';
+/** 单语言下的命名空间 → 文案对象。One language: namespace -> key-value bundle. */
+export type NamespaceBundle = Record<string, unknown>;
+/** 所有语言的资源：语言码 → 命名空间 → 文案。Resources: lng -> ns -> bundle. */
+export type Resources = Record<string, Record<string, NamespaceBundle>>;
+/** 命名空间映射：命名空间 key → 命名空间字符串（用于 ns 列表）。Name space key -> string. */
+export type NameSpacesMap = Record<string, string>;
+/** createI18nResources 返回值，含 RESOURCES / NAME_SPACES_MAP / NAME_SPACES。Return type of createI18nResources. */
+export interface CreateI18nResourcesResult {
+    RESOURCES: Resources;
+    NAME_SPACES_MAP: NameSpacesMap;
+    NAME_SPACES: string[];
+}
+/** 单条额外 bundle：命名空间 + 文案对象，由 initI18n 注入到 i18n。 */
+export interface ExtraBundleItem {
+    namespace: string;
+    bundle: Record<string, unknown>;
+}
+export type onLoadExtraBundles = (lng: LanguageEnum) => Promise<ExtraBundleItem | ExtraBundleItem[] | null | undefined>;
+/** initI18n 的选项。Options for initI18n. */
+export interface InitI18nOptions {
+    /** 由 createI18nResources(resources, nameSpacesMap) 得到；用户自建 JSON 后组装传入。From createI18nResources; user builds from their JSON. */
+    bundles: CreateI18nResourcesResult;
+    /** 回退语言。Fallback language. */
+    fallbackLng?: LanguageEnum;
+    /** 语言切换后由调用方拉取额外文案（如错误码）；返回 { namespace, bundle } 或数组，由 initI18n 负责 addResourceBundle。 */
+    onLoadExtraBundles?: onLoadExtraBundles;
+}

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

@@ -0,0 +1,6 @@
+/**
+ * 语言模块类型统一导出。All language module types re-exported.
+ */
+export * from './language';
+export * from './i18n';
+export * from './components';

package/dist/src/languages/types/language.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 语言枚举与常量，不引用任何 JSON，供需要轻量引用的模块使用。
+ * Language enum and constants; no JSON deps for lightweight usage.
+ */
+declare enum LanguageEnum {
+    EN = "en",
+    ZH = "zh",
+    FR = "fr"
+}
+declare const DEFAULT_LANGUAGE = LanguageEnum.ZH;
+declare const LANGUAGE_VALUES: LanguageEnum[];
+declare const LANGUAGE_STORAGE_KEY = "language-storage";
+export { LanguageEnum, DEFAULT_LANGUAGE, LANGUAGE_VALUES, LANGUAGE_STORAGE_KEY };

package/dist/src/languages/utils/getLocalLanguage.d.ts

@@ -0,0 +1,2 @@
+import { LanguageEnum } from '../types';
+export declare function getLocalLanguage(): LanguageEnum;

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

@@ -0,0 +1,5 @@
+/**
+ * 语言模块工具函数。Language module utils.
+ */
+export { getLocalLanguage } from './getLocalLanguage';
+export { getLanguageStorage, removeLanguageStorage, setLanguageStorage, } from './languageStorage';

package/dist/src/languages/utils/languageStorage.d.ts

@@ -0,0 +1,5 @@
+import { Nilable } from '../../../types/utils';
+import { LanguageEnum } from '../types';
+export declare function getLanguageStorage(): Nilable<LanguageEnum>;
+export declare function setLanguageStorage(value: LanguageEnum): void;
+export declare function removeLanguageStorage(): void;

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

@@ -0,0 +1 @@
+export * from './navigation';

package/dist/src/navigations/navigation.d.ts

@@ -0,0 +1,50 @@
+import { Defined, KeyOf } from '../../types';
+/**
+ * 通用路由类型与 defineRouter / createRouter（与 EventEmitter 的 defineEvents 约定一致）
+ * Generic route types and defineRouter / createRouter; only values from defineRouter are accepted by createRouter.
+ *
+ * @example
+ * ```ts
+ * import { defineRouter, createRouter } from "@/types/navigation";
+ * const routeMap = defineRouter({ HOME: "/", LOGIN: "/login", USER: "/user/:id" });
+ * const router = createRouter(routeMap);
+ * router.ROUTES.HOME; // "/"
+ * router.matchRoute(pathname, router.ROUTES.USER);
+ * ```
+ */
+/** 由 defineRouter 返回的「已规范路由表」类型；createRouter 只接受此类型。 */
+export type DefinedRouter<R extends Record<string, string>> = Defined<R, "router">;
+/** 由路由表 R 推导的 key 类型 */
+export type RouteKey<R extends Record<string, string>> = KeyOf<R>;
+/** 由路由表 R 推导的 path 联合类型 */
+export type RoutePath<R extends Record<string, string>> = R[RouteKey<R>];
+/**
+ * 规范创建路由表：仅允许 defineRouter 返回的值传入 createRouter（类型约束）。
+ * Define route map: only the return value of defineRouter may be passed to createRouter.
+ *
+ * @param routes - 路由 key-value 对象（值可为含 :param 的 path）
+ * @returns DefinedRouter<R>，仅此类型可传入 createRouter
+ */
+export declare function defineRouter<R extends Record<string, string>>(routes: R): DefinedRouter<R>;
+/**
+ * 精确匹配：当前路径是否等于目标 path
+ * Exact match: current path equals target path.
+ */
+export declare function isActiveRoute(currentPath: string, targetPath: string): boolean;
+/**
+ * 模式匹配：pathname 是否匹配带 :param 的 route 模式
+ * Pattern match: pathname matches route pattern (supports :param segments).
+ */
+export declare function matchRoute(pathname: string, route: string): boolean;
+/**
+ * 创建路由对象：仅接受 defineRouter(...) 的返回值，得到只读 ROUTES + matchRoute / isActiveRoute / getRouteByKey
+ * Create router: accepts only the return value of defineRouter(...); returns ROUTES and typed helpers.
+ *
+ * @param routes - 须为 defineRouter(...) 的返回值（DefinedRouter）
+ */
+export declare function createRouter<R extends Record<string, string>>(routes: DefinedRouter<R>): {
+    ROUTES: Readonly<R>;
+    matchRoute: (pathname: string, route: R[keyof R]) => boolean;
+    isActiveRoute: (currentPath: string, targetPath: R[keyof R]) => boolean;
+    getRouteByKey: (key: keyof R) => R[keyof R];
+};

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

@@ -0,0 +1,12 @@
+import { Array } from '../../types';
+/** 仪表盘背景枚举。Dashboard background enum. */
+export declare enum DashboardBackgroundEnum {
+    NONE = "none",
+    WAVES = "waves",
+    SQUARES = "squares",
+    LETTER_GLITCH = "letterGlitch",
+    PIXEL_BLAST = "pixelBlast"
+}
+export declare const DEFAULT_DASHBOARD_BACKGROUND = DashboardBackgroundEnum.NONE;
+/** 仪表盘背景可选值列表。Dashboard background values list. */
+export declare const DASHBOARD_BACKGROUND_VALUES: Array<DashboardBackgroundEnum>;

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

@@ -0,0 +1,35 @@
+import { LayoutModeEnum } from '../../designs/layouts/types';
+import { LanguageEnum } from '../../languages/types';
+import { BaseEnum, ThemeEnum } from '../../themes/types';
+import { DashboardBackgroundEnum } from './constants';
+export { DashboardBackgroundEnum, DEFAULT_DASHBOARD_BACKGROUND, DASHBOARD_BACKGROUND_VALUES } from './constants';
+/** 前端统一的偏好结构；后端存为 JSON：theme, base, language, layoutMode, other.dashboardBackground */
+export type Preference = {
+    theme: ThemeEnum;
+    base: BaseEnum;
+    language: LanguageEnum;
+    layoutMode: LayoutModeEnum;
+    other?: {
+        dashboardBackground: DashboardBackgroundEnum;
+    };
+};
+/**
+ * 从后端 preference JSON 解析为前端 Preference，解析失败或空返回 null
+ * Parse backend preference JSON to Preference; returns null on empty or parse error.
+ * @param json - 后端存的 JSON 字符串
+ * @returns Preference 或 null
+ */
+export declare function parsePreferenceJson(json: string | null | undefined): Preference | null;
+/**
+ * 将前端 Preference 序列化为后端存的完整 JSON 字符串（每次更新都传完整 JSON）
+ * Serialize Preference to backend JSON string (full payload on each update).
+ * @param preference - 前端偏好对象
+ * @returns JSON 字符串
+ */
+export declare function preferenceToJson(preference: Preference): string;
+/**
+ * 默认偏好（解析不到或同步时兜底）：默认中文、default 主题、default base
+ * Default preference (fallback when parse fails or for initial sync).
+ * @returns 默认 Preference
+ */
+export declare function getDefaultPreference(): Preference;

package/dist/src/services/imageService.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 压缩头像图片（用于上传）
+ * @param file - 用户选择的图片文件
+ * @returns File - 压缩后的文件
+ */
+export declare const compressImage: (file: File) => Promise<File>;

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

@@ -0,0 +1 @@
+export * from './imageService';

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

@@ -0,0 +1 @@
+export * from './makeStore';

package/dist/src/stores/makeStore.d.ts

@@ -0,0 +1,92 @@
+/**
+ * 通用 Store 工厂（学习 hooks 的 make 函数模式）。
+ * Generic store factory (make pattern like hooks makeUnifiedQuery).
+ */
+/** SetState：与 zustand 的 set 一致。Same as zustand set. */
+export type SetState<S> = (partial: Partial<S> | ((state: S) => Partial<S>)) => void;
+/** GetState：与 zustand 的 get 一致。Same as zustand get. */
+export type GetState<S> = () => S;
+/**
+ * 创建带 subscribeWithSelector 的 Store（不持久化）。
+ * Create store with subscribeWithSelector (no persist).
+ *
+ * @param initialState - 初始状态。Initial state.
+ * @param actions - (set, get) => actions 对象。(set, get) => actions object.
+ * @returns { store, useStore } 供外部使用。Returns { store, useStore }.
+ *
+ * @example
+ * ```ts
+ * const { store, useStore } = makeStore(
+ *   { count: 0 },
+ *   (set) => ({ increment: () => set((s) => ({ count: s.count + 1 })) })
+ * );
+ * const count = useStore((s) => s.count);
+ * ```
+ */
+export declare function makeStore<S extends object, A extends object>(initialState: S, actions: (set: SetState<S & A>, get: GetState<S & A>) => A): {
+    store: Omit<import('zustand').StoreApi<S & A>, "subscribe"> & {
+        subscribe: {
+            (listener: (selectedState: S & A, previousSelectedState: S & A) => void): () => void;
+            <U>(selector: (state: S & A) => U, listener: (selectedState: U, previousSelectedState: U) => void, options?: {
+                equalityFn?: ((a: U, b: U) => boolean) | undefined;
+                fireImmediately?: boolean;
+            } | undefined): () => void;
+        };
+    };
+    useStore: <T>(selector: (state: S & A) => T) => T;
+};
+/** makePersistStore 的配置。Config for makePersistStore. */
+export interface MakePersistStoreOptions<S extends object, A extends object> {
+    /** 持久化 key（localStorage）。Persist key (localStorage). */
+    name: string;
+    /** 初始状态。Initial state. */
+    initialState: S;
+    /** (set, get) => actions。(set, get) => actions. */
+    actions: (set: SetState<S & A>, get: GetState<S & A>) => A;
+    /** 只持久化部分 state；缺省则全量。Partialize state to persist; default full. */
+    partialize?: (state: S & A) => Partial<S & A>;
+    /** 版本号（用于 migrate）。Version for migrate. */
+    version?: number;
+    /** 迁移旧持久化数据。Migrate persisted state. */
+    migrate?: (persistedState: unknown, version: number) => Partial<S & A>;
+}
+/**
+ * 创建带 persist + subscribeWithSelector 的 Store。
+ * Create store with persist and subscribeWithSelector.
+ *
+ * @param options - name, initialState, actions, partialize?, version?, migrate?
+ * @returns { store, useStore }
+ *
+ * @example
+ * ```ts
+ * const { store, useStore } = makePersistStore({
+ *   name: "auth-storage",
+ *   initialState: { token: null },
+ *   actions: (set) => ({ setToken: (t) => set({ token: t }) }),
+ * });
+ * ```
+ */
+export declare function makePersistStore<S extends object, A extends object>(options: MakePersistStoreOptions<S, A>): {
+    store: Omit<Omit<import('zustand').StoreApi<S & A>, "subscribe"> & {
+        subscribe: {
+            (listener: (selectedState: S & A, previousSelectedState: S & A) => void): () => void;
+            <U>(selector: (state: S & A) => U, listener: (selectedState: U, previousSelectedState: U) => void, options?: {
+                equalityFn?: ((a: U, b: U) => boolean) | undefined;
+                fireImmediately?: boolean;
+            } | undefined): () => void;
+        };
+    }, "setState" | "persist"> & {
+        setState(partial: (S & A) | Partial<S & A> | ((state: S & A) => (S & A) | Partial<S & A>), replace?: false | undefined): unknown;
+        setState(state: (S & A) | ((state: S & A) => S & A), replace: true): unknown;
+        persist: {
+            setOptions: (options: Partial<import('zustand/middleware').PersistOptions<S & A, Partial<S & A>, unknown>>) => void;
+            clearStorage: () => void;
+            rehydrate: () => Promise<void> | void;
+            hasHydrated: () => boolean;
+            onHydrate: (fn: (state: S & A) => void) => () => void;
+            onFinishHydration: (fn: (state: S & A) => void) => () => void;
+            getOptions: () => Partial<import('zustand/middleware').PersistOptions<S & A, Partial<S & A>, unknown>>;
+        };
+    };
+    useStore: <T>(selector: (state: S & A) => T) => T;
+};

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

@@ -0,0 +1,2 @@
+export * from './useTheme';
+export * from './useThemeVariables';

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

@@ -0,0 +1,5 @@
+import { ThemeContextType } from '../types';
+declare const ThemeContext: import('react').Context<ThemeContextType | undefined>;
+declare function useTheme(): ThemeContextType;
+export { ThemeContext, useTheme };
+export type { ThemeContextType } from '../types';

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

@@ -0,0 +1,10 @@
+import { 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;

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

@@ -0,0 +1,8 @@
+/**
+ * 主题模块统一导出。Themes module barrel exports.
+ */
+export * from './types';
+export * from './utils';
+export { default as ThemeProvider } from './providers';
+export * from './hooks';
+export * from './themes';

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

@@ -0,0 +1,3 @@
+import { ThemeProviderProps } from '../types';
+declare const ThemeProvider: import('react').MemoExoticComponent<({ children, defaultTheme, defaultBase }: ThemeProviderProps) => import("react/jsx-runtime").JSX.Element>;
+export default ThemeProvider;

package/dist/src/themes/themes/bases/android.d.ts

@@ -0,0 +1,4 @@
+import { BaseTheme, BaseVariables } from '../../types';
+/** Android 风格圆角（如 6） */
+export declare const androidBaseVariables: BaseVariables;
+export declare const androidBaseTheme: BaseTheme;

package/dist/src/themes/themes/bases/default.d.ts

@@ -0,0 +1,5 @@
+import { BaseTheme, BaseVariables } from '../../types';
+/** 默认基础变量（跨平台通用） */
+export declare const defaultBaseVariables: BaseVariables;
+/** 默认基础主题 */
+export declare const defaultBaseTheme: BaseTheme;

package/dist/src/themes/themes/bases/index.d.ts

@@ -0,0 +1,7 @@
+import { BaseTheme, BaseEnum } from '../../types';
+export declare const bases: Record<BaseEnum, BaseTheme>;
+export { defaultBaseTheme, defaultBaseVariables } from './default';
+export { iosBaseTheme, iosBaseVariables } from './ios';
+export { androidBaseTheme, androidBaseVariables } from './android';
+export { windowsBaseTheme, windowsBaseVariables } from './windows';
+export { linuxBaseTheme, linuxBaseVariables } from './linux';

package/dist/src/themes/themes/bases/ios.d.ts

@@ -0,0 +1,4 @@
+import { BaseTheme, BaseVariables } from '../../types';
+/** iOS 风格圆角（较大，如 24） */
+export declare const iosBaseVariables: BaseVariables;
+export declare const iosBaseTheme: BaseTheme;

package/dist/src/themes/themes/bases/linux.d.ts

@@ -0,0 +1,4 @@
+import { BaseTheme, BaseVariables } from '../../types';
+/** Linux 风格圆角（较小，如 4） */
+export declare const linuxBaseVariables: BaseVariables;
+export declare const linuxBaseTheme: BaseTheme;

package/dist/src/themes/themes/bases/windows.d.ts

@@ -0,0 +1,4 @@
+import { BaseTheme, BaseVariables } from '../../types';
+/** Windows 风格圆角（如 6） */
+export declare const windowsBaseVariables: BaseVariables;
+export declare const windowsBaseTheme: BaseTheme;

package/dist/src/themes/themes/colors/coffee.d.ts

@@ -0,0 +1,7 @@
+import { ColorTheme } from '../../types';
+/**
+ * Coffee — Warm Earth
+ * 深色暖棕，焦糖拿铁主色 #C49A6C。
+ * 深咖啡背景 + 奶油色文字，温暖舒适。
+ */
+export declare const coffeeColorTheme: ColorTheme;

package/dist/src/themes/themes/colors/corporate.d.ts

@@ -0,0 +1,7 @@
+import { ColorTheme } from '../../types';
+/**
+ * Corporate — Blue Professional
+ * 企业蓝 #2563EB，搭配轻量蓝灰 Slate 中性色。
+ * 冷静、值得信赖、专业感。
+ */
+export declare const corporateColorTheme: ColorTheme;

package/dist/src/themes/themes/colors/cosmic.d.ts

@@ -0,0 +1,7 @@
+import { ColorTheme } from '../../types';
+/**
+ * Cosmic — Electric Purple
+ * 深空紫调，梦幻科幻。
+ * 主色电紫 #8B5CF6，深靛蓝背景，薰衣草文字层次。
+ */
+export declare const cosmicColorTheme: ColorTheme;

package/dist/src/themes/themes/colors/dark.d.ts

@@ -0,0 +1,7 @@
+import { ColorTheme } from '../../types';
+/**
+ * Dark — Amber Gold on Zinc
+ * 深色模式，琥珀金主色 + 锌灰背景。
+ * 暖色调暗色，层级分明，阅读舒适。
+ */
+export declare const darkColorTheme: ColorTheme;

package/dist/src/themes/themes/colors/default.d.ts

@@ -0,0 +1,7 @@
+import { ColorTheme } from '../../types';
+/**
+ * Default — Crimson Red
+ * 品牌主色：鲜红 #DC2626，搭配 Tailwind gray 中性色。
+ * 适合 IoT 仪表盘的告警/操作视觉调性。
+ */
+export declare const defaultColorTheme: ColorTheme;

package/dist/src/themes/themes/colors/forest.d.ts

@@ -0,0 +1,7 @@
+import { ColorTheme } from '../../types';
+/**
+ * Forest — Deep Green
+ * 自然绿 #15803D，翡翠色层级。
+ * 有机、宁静、自然，带金黄 warning 做暖色点缀。
+ */
+export declare const forestColorTheme: ColorTheme;

package/dist/src/themes/themes/colors/index.d.ts

@@ -0,0 +1,12 @@
+import { Theme, ThemeEnum } from '../../types';
+declare const defaultTheme: Theme;
+declare const lightTheme: Theme;
+declare const darkTheme: Theme;
+declare const cosmicTheme: Theme;
+declare const corporateTheme: Theme;
+declare const forestTheme: Theme;
+declare const coffeeTheme: Theme;
+declare const wineTheme: Theme;
+declare const wheatTheme: Theme;
+export declare const themes: Record<ThemeEnum, Theme>;
+export { defaultTheme, lightTheme, darkTheme, cosmicTheme, corporateTheme, forestTheme, coffeeTheme, wineTheme, wheatTheme };

package/dist/src/themes/themes/colors/light.d.ts

@@ -0,0 +1,7 @@
+import { ColorTheme } from '../../types';
+/**
+ * Light — Slate Professional
+ * 中性蓝灰色系，无强色彩偏向。
+ * 深色 Slate 做主色，适合专业办公/阅读场景。
+ */
+export declare const lightColorTheme: ColorTheme;

package/dist/src/themes/themes/colors/wheat.d.ts

@@ -0,0 +1,8 @@
+import { ColorTheme } from '../../types';
+/**
+ * Wheat — Golden Harvest
+ * 浅色暖金，主色琥珀 #B45309。
+ * 暖奶油色背景 + 深棕文字，丰收质感。
+ * danger 使用独立红色，不与 primary 金色混淆。
+ */
+export declare const wheatColorTheme: ColorTheme;

package/dist/src/themes/themes/colors/wine.d.ts

@@ -0,0 +1,7 @@
+import { ColorTheme } from '../../types';
+/**
+ * Wine — Burgundy Rose
+ * 深色酒红，主色 #9F1239 (Rose-800)。
+ * 深酒红背景 + 淡玫瑰文字，高贵典雅。
+ */
+export declare const wineColorTheme: ColorTheme;