nfx-ui 0.7.4 → 0.8.0

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

@@ -0,0 +1,2 @@
+/** API 通用：path 树与 base URL（只保留 ip 通用文件） / API path tree & base URL (ip only) */
+export * from './ip';

package/dist/src/apis/ip.d.ts

@@ -0,0 +1,4 @@
+export type PathNode<T> = string & {
+    [K in keyof T]: T[K] extends (...args: infer A) => infer R ? R extends object ? (...args: A) => PathNode<R> : (...args: A) => string : T[K] extends object ? PathNode<T[K]> : string;
+};
+export declare const path: <T extends Record<string, unknown>>(base: string, children: T) => PathNode<T>;

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

@@ -0,0 +1,5 @@
+/** 列表 key 片段。List key segment. */
+declare const CACHE_LIST = "list";
+/** 单条 key 片段。Item key segment. */
+declare const CACHE_ITEM = "item";
+export { CACHE_LIST, CACHE_ITEM };

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

@@ -0,0 +1,18 @@
+type EnumMetaMap = Record<string, Record<PropertyKey, unknown>>;
+type DefinedEnum<M extends EnumMetaMap> = {
+    Values: readonly (keyof M)[];
+    pickMap<P extends keyof M[keyof M]>(prop: P): {
+        [K in keyof M]: M[K][P];
+    };
+    get<K extends keyof M>(key: K): M[K];
+};
+type EnumInferMeta<E> = E extends DefinedEnum<infer M> ? M : never;
+type EnumValue<E extends {
+    Values: readonly PropertyKey[];
+}> = E["Values"][number];
+declare function defineEnum<const M extends EnumMetaMap>(metaMap: M): DefinedEnum<M>;
+declare function enumPickMap<M extends EnumMetaMap, P extends keyof M[keyof M]>(e: DefinedEnum<M>, prop: P): {
+    [K in keyof M]: M[K][P];
+};
+export { defineEnum, enumPickMap };
+export type { EnumMetaMap, DefinedEnum, EnumInferMeta, EnumValue };

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

@@ -0,0 +1,9 @@
+/**
+ * 公用常量：query key 工厂、domain 片段、cache 片段、catalog 限制等
+ * Shared constants: query key factories, domain segments, cache segments, catalog limits.
+ */
+export * from './caches';
+export * from './enums';
+export * from './query.itemkeys';
+export * from './query.listkeys';
+export * from './querykeys';

package/dist/src/constants/query.itemkeys.d.ts

@@ -0,0 +1,31 @@
+import { QueryKey } from '@tanstack/react-query';
+/**
+ * 链式单条 key 类型：可调用 (...ids) => QueryKey，且带 withPrefix、getPrefix。
+ * Chainable item key type: callable (...ids) => QueryKey, with withPrefix() and getPrefix.
+ */
+type ItemKeyChainable = ((...ids: string[]) => QueryKey) & {
+    withPrefix(...prefix: unknown[]): ItemKeyChainable;
+    /** 不含 id 的前缀，用于 invalidation 等。Prefix without ids, e.g. for invalidation. */
+    getPrefix: QueryKey;
+};
+/**
+ * 创建「单条」query key 工厂（可链式 .withPrefix）：支持传入一个或多个 id，返回 [domain, CACHE_ITEM, subDomain, ...ids]
+ * Creates an item query key factory (chainable .withPrefix): accepts one or more ids, returns [domain, CACHE_ITEM, subDomain, ...ids].
+ *
+ * @param domain - 域名。Domain name (e.g. "catalog", "auth").
+ * @param subDomain - 子域。Sub-domain (e.g. "category", "product").
+ * @returns 可调用的 key 工厂，带 withPrefix 可链式加前缀。Callable key factory with withPrefix for chaining.
+ * @example
+ * ```ts
+ * const getKey = createItemKey("catalog", "category");
+ * getKey("abc");
+ * * => ["catalog", "item", "category", "abc"]
+ * getKey.getPrefix
+ * * => ["catalog", "item", "category"]
+ * createItemKey("catalog", "category").withPrefix("api").withPrefix("v1").getPrefix;
+ * * => ["v1", "api", "catalog", "item", "category"]
+ * ```
+ */
+declare function createItemKey(domain: string, subDomain: string): ItemKeyChainable;
+export { createItemKey };
+export type { ItemKeyChainable };

package/dist/src/constants/query.listkeys.d.ts

@@ -0,0 +1,30 @@
+import { QueryKey } from '@tanstack/react-query';
+/**
+ * 链式列表 key 类型：本身即 QueryKey（数组），且带 withPrefix、getPrefix。
+ * Chainable list key type: is a QueryKey (array) and has withPrefix(), getPrefix.
+ */
+type ListKeyChainable = QueryKey & {
+    withPrefix(...prefix: unknown[]): ListKeyChainable;
+    /** 列表 key 的前缀（即完整 list key，用于 invalidation 等）。Prefix (full list key) for invalidation. */
+    getPrefix: QueryKey;
+};
+/**
+ * 创建「列表」query key（可链式 .withPrefix）：[domain, CACHE_LIST, subDomain]
+ * Creates a list query key (chainable .withPrefix): [domain, CACHE_LIST, subDomain].
+ *
+ * @param domain - 域名。Domain name (e.g. "catalog", "auth").
+ * @param subDomain - 子域。Sub-domain (e.g. "category", "product").
+ * @returns 列表 query key（数组），带 withPrefix 可链式加前缀。List query key (array) with withPrefix for chaining.
+ * @example
+ * ```ts
+ * const key = createListKey("catalog", "category");
+ * * key => ["catalog", "list", "category"]
+ * key.getPrefix
+ * * => ["catalog", "list", "category"]
+ * createListKey("catalog", "category").withPrefix("api").withPrefix("v1").getPrefix;
+ * * => ["v1", "api", "catalog", "list", "category"]
+ * ```
+ */
+declare function createListKey(domain: string, subDomain: string): ListKeyChainable;
+export { createListKey };
+export type { ListKeyChainable };

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

@@ -0,0 +1,42 @@
+import { QueryKey } from '@tanstack/react-query';
+import { ItemKeyChainable } from './query.itemkeys';
+import { ListKeyChainable } from './query.listkeys';
+/** 含 list / item 且可链式 withPrefix 的 bundle 类型 */
+type QueryKeysBundle = {
+    list: ListKeyChainable;
+    item: ItemKeyChainable;
+    withPrefix(...prefix: unknown[]): QueryKeysBundle;
+};
+/**
+ * 创建自定义 query key（任意片段，用于 stats 等）
+ * Creates a custom query key from arbitrary segments (e.g. for stats).
+ *
+ * @param segments - 任意片段（字符串或其它）。Arbitrary segments (strings or other).
+ * @returns 由片段组成的 query key。Query key composed of the segments.
+ * @example
+ * ```ts
+ * const key = createKey("catalog", "stats", "category", "count");
+ * * key => ["catalog", "stats", "category", "count"]
+ * ```
+ */
+declare function createKey(...segments: unknown[]): QueryKey;
+/**
+ * 根据同一 domain + subDomain 生成 list key 与 item key 工厂
+ * Returns both list key and item key factory for the given domain and subDomain.
+ *
+ * @param domain - 域名。Domain name (e.g. "catalog", "auth").
+ * @param subDomain - 子域。Sub-domain (e.g. "category", "product").
+ * @returns 含 list、item 及 withPrefix 的 bundle，可链式加前缀。Bundle with list, item, and chainable withPrefix.
+ * @example
+ * ```ts
+ * const { list, item } = createQueryKeys("catalog", "category");
+ * * list => ["catalog", "list", "category"]
+ * * item("id-1") => ["catalog", "item", "category", "id-1"]
+ * const withApi = createQueryKeys("catalog", "category").withPrefix("api");
+ * * withApi.list => ["api", "catalog", "list", "category"]
+ * * withApi.item("id-1") => ["api", "catalog", "item", "category", "id-1"]
+ * ```
+ */
+declare function createQueryKeys(domain: string, subDomain: string): QueryKeysBundle;
+export { createKey, createQueryKeys };
+export type { QueryKeysBundle };

package/dist/src/designs/animations/BounceLoading/index.d.ts

@@ -0,0 +1,7 @@
+interface BounceLoadingProps {
+    size?: "small" | "medium" | "large";
+    shape?: "square" | "circle";
+    className?: string;
+}
+declare const BounceLoading: import('react').MemoExoticComponent<({ size, shape, className }: BounceLoadingProps) => import("react/jsx-runtime").JSX.Element>;
+export default BounceLoading;

package/dist/src/designs/animations/ECGLoading/index.d.ts

@@ -0,0 +1,6 @@
+interface ECGLoadingProps {
+    size?: "small" | "medium" | "large";
+    className?: string;
+}
+declare const ECGLoading: import('react').MemoExoticComponent<({ size, className }: ECGLoadingProps) => import("react/jsx-runtime").JSX.Element>;
+export default ECGLoading;

package/dist/src/designs/animations/LetterGlitch/index.d.ts

@@ -0,0 +1,12 @@
+interface LetterGlitchProps {
+    glitchColors?: string[];
+    glitchSpeed?: number;
+    centerVignette?: boolean;
+    outerVignette?: boolean;
+    smooth?: boolean;
+    characters?: string;
+    className?: string;
+    style?: React.CSSProperties;
+}
+declare const LetterGlitchBackground: React.FC<Omit<LetterGlitchProps, "glitchColors">>;
+export default LetterGlitchBackground;

package/dist/src/designs/animations/PixelBlast/index.d.ts

@@ -0,0 +1,28 @@
+import { default as React } from 'react';
+type PixelBlastVariant = "square" | "circle" | "triangle" | "diamond";
+type PixelBlastProps = {
+    variant?: PixelBlastVariant;
+    pixelSize?: number;
+    color?: string;
+    className?: string;
+    style?: React.CSSProperties;
+    antialias?: boolean;
+    patternScale?: number;
+    patternDensity?: number;
+    liquid?: boolean;
+    liquidStrength?: number;
+    liquidRadius?: number;
+    pixelSizeJitter?: number;
+    enableRipples?: boolean;
+    rippleIntensityScale?: number;
+    rippleThickness?: number;
+    rippleSpeed?: number;
+    liquidWobbleSpeed?: number;
+    autoPauseOffscreen?: boolean;
+    speed?: number;
+    transparent?: boolean;
+    edgeFade?: number;
+    noiseAmount?: number;
+};
+declare const PixelBlastBackground: React.FC<Omit<PixelBlastProps, "color">>;
+export default PixelBlastBackground;

package/dist/src/designs/animations/Squares/index.d.ts

@@ -0,0 +1,13 @@
+import { default as React } from 'react';
+type CanvasStrokeStyle = string | CanvasGradient | CanvasPattern;
+interface SquaresProps {
+    direction?: "diagonal" | "up" | "right" | "down" | "left";
+    speed?: number;
+    borderColor?: CanvasStrokeStyle;
+    squareSize?: number;
+    hoverFillColor?: CanvasStrokeStyle;
+    className?: string;
+    style?: React.CSSProperties;
+}
+declare const SquareBackground: React.FC<Omit<SquaresProps, "borderColor" | "hoverFillColor">>;
+export default SquareBackground;

package/dist/src/designs/animations/TruckLoading/index.d.ts

@@ -0,0 +1,6 @@
+interface TruckLoadingProps {
+    size?: "small" | "medium" | "large";
+    className?: string;
+}
+declare const TruckLoading: import('react').MemoExoticComponent<({ size, className }: TruckLoadingProps) => import("react/jsx-runtime").JSX.Element>;
+export default TruckLoading;

package/dist/src/designs/animations/Waves/index.d.ts

@@ -0,0 +1,18 @@
+import { default as React, CSSProperties } from 'react';
+interface WavesProps {
+    lineColor?: string;
+    backgroundColor?: string;
+    waveSpeedX?: number;
+    waveSpeedY?: number;
+    waveAmpX?: number;
+    waveAmpY?: number;
+    xGap?: number;
+    yGap?: number;
+    friction?: number;
+    tension?: number;
+    maxCursorMove?: number;
+    style?: CSSProperties;
+    className?: string;
+}
+declare const WaveBackground: React.FC<Omit<WavesProps, "lineColor" | "backgroundColor">>;
+export default WaveBackground;

package/dist/src/designs/animations/index.d.ts

@@ -0,0 +1,6 @@
+export { default as ECGLoading } from './ECGLoading';
+export { default as TruckLoading } from './TruckLoading';
+export { default as BounceLoading } from './BounceLoading';
+export { default as WaveBackground } from './Waves';
+export { default as SquareBackground } from './Squares';
+export { default as LetterGlitchBackground } from './LetterGlitch';

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

@@ -0,0 +1,20 @@
+import { ButtonHTMLAttributes, ReactNode } from 'react';
+export interface ButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "size"> {
+    variant?: "primary" | "secondary" | "outline" | "ghost" | "danger";
+    size?: "small" | "medium" | "large";
+    fullWidth?: boolean;
+    leftIcon?: ReactNode;
+    rightIcon?: ReactNode;
+    /** 上方图标。Top icon. */
+    topIcon?: ReactNode;
+    /** 下方图标。Bottom icon. */
+    bottomIcon?: ReactNode;
+    /** 仅图标无文案。Icon only, no text. */
+    iconOnly?: boolean;
+    /** 图标尺寸覆盖。Override icon size. */
+    iconSize?: number;
+    loading?: boolean;
+    children?: ReactNode;
+}
+declare const Button: import('react').ForwardRefExoticComponent<ButtonProps & import('react').RefAttributes<HTMLButtonElement>>;
+export default Button;

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

@@ -0,0 +1,24 @@
+export interface DropdownOption {
+    /** 选项值。Option value. */
+    value: string;
+    /** 选项展示文案。Option label. */
+    label: string;
+}
+export interface DropdownProps {
+    /** 选项列表。Options list. */
+    options: DropdownOption[];
+    /** 当前选中值。Current value. */
+    value: string;
+    /** 选中回调。Change callback. */
+    onChange: (value: string) => void;
+    /** 占位符。Placeholder. */
+    placeholder?: string;
+    /** 是否禁用。Disabled. */
+    disabled?: boolean;
+    /** 是否错误态。Error state. */
+    error?: boolean;
+    /** 容器 className。Container className. */
+    className?: string;
+}
+declare const Dropdown: import('react').NamedExoticComponent<DropdownProps>;
+export default Dropdown;

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

@@ -0,0 +1,9 @@
+import { LucideProps } from 'lucide-react';
+import * as LucideIcons from "@/icons/lucide";
+export type IconName = keyof Omit<typeof LucideIcons, "LucideIcon">;
+export interface IconProps extends LucideProps {
+    /** 图标名（lucide 注册名）。Icon name (lucide registered name). */
+    name: IconName;
+}
+declare const Icon: import('react').MemoExoticComponent<({ name, ...props }: IconProps) => import("react/jsx-runtime").JSX.Element | null>;
+export default Icon;

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

@@ -0,0 +1,23 @@
+import { InputHTMLAttributes, ReactNode } from 'react';
+export interface InputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "size"> {
+    /** 标签文案。Label text. */
+    label?: string;
+    /** 错误信息。Error message. */
+    error?: string;
+    /** 辅助说明。Helper text. */
+    helperText?: string;
+    /** 左侧图标。Left icon. */
+    leftIcon?: ReactNode;
+    /** 右侧图标。Right icon. */
+    rightIcon?: ReactNode;
+    /** 为 true 时 rightIcon 可点击（如密码切换、清除按钮）。When true, right icon is clickable (e.g. password toggle, clear). */
+    rightIconInteractive?: boolean;
+    /** 尺寸。Size. */
+    size?: "small" | "medium" | "large";
+    /** 视觉变体。Variant. */
+    variant?: "default" | "filled";
+    /** 是否占满宽度。Full width. */
+    fullWidth?: boolean;
+}
+declare const Input: import('react').ForwardRefExoticComponent<InputProps & import('react').RefAttributes<HTMLInputElement>>;
+export default Input;

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

@@ -0,0 +1,30 @@
+export interface KeyValuePair {
+    /** 键。Key. */
+    key: string;
+    /** 值（字符串或字符串数组）。Value (string or string[]). */
+    value: string | string[];
+}
+export interface KeyValueEditorProps {
+    /** 表单项标签。Field label. */
+    label: string;
+    /** 键值对列表。Key-value pairs. */
+    pairs: KeyValuePair[];
+    /** 列表变化回调。Change callback. */
+    onChange: (pairs: KeyValuePair[]) => void;
+    /** 值类型：string 或 array。Value type: string or array. */
+    valueType?: "string" | "array";
+    /** 键占位符。Key placeholder. */
+    keyPlaceholder?: string;
+    /** 值占位符（string 模式）。Value placeholder (string mode). */
+    valuePlaceholder?: string;
+    /** 值占位符（array 模式）。Value placeholder (array mode). */
+    valueArrayPlaceholder?: string;
+    /** 删除按钮 aria-label。Remove button aria-label. */
+    removeAriaLabel?: string;
+    /** 新增按钮文案。Add button label. */
+    addLabel?: string;
+    /** 错误信息。Error message. */
+    error?: string;
+}
+declare const KeyValueEditor: import('react').MemoExoticComponent<({ label, pairs, onChange, valueType, keyPlaceholder, valuePlaceholder, valueArrayPlaceholder, removeAriaLabel, addLabel, error, }: KeyValueEditorProps) => import("react/jsx-runtime").JSX.Element>;
+export default KeyValueEditor;

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

@@ -0,0 +1,3 @@
+import { LayoutSwitcherProps } from '../../../../designs/layouts/types';
+declare const LayoutSwitcher: import('react').MemoExoticComponent<({ status, getLayoutDisplayName, handleChangeLayoutMode }: LayoutSwitcherProps) => import("react/jsx-runtime").JSX.Element>;
+export default LayoutSwitcher;

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

@@ -0,0 +1,12 @@
+export interface SearchInputProps {
+    /** 当前输入值。Current value. */
+    value: string;
+    /** 值变化回调。Change callback. */
+    onChange: (value: string) => void;
+    /** 占位符，由调用方传入。Placeholder; pass from caller. */
+    placeholder?: string;
+    /** 清除按钮 aria-label；由调用方传入（可来自 i18n）。Clear button aria-label; pass from caller. */
+    clearButtonAriaLabel?: string;
+}
+declare const SearchInput: import('react').MemoExoticComponent<({ value, onChange, placeholder, clearButtonAriaLabel }: SearchInputProps) => import("react/jsx-runtime").JSX.Element>;
+export default SearchInput;

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

@@ -0,0 +1,28 @@
+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?: string;
+    /** 筛选关闭时的按钮文案。Label when filter disabled. */
+    filterDisabled?: string;
+    /** 开启筛选按钮的 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?: string;
+    /** 「显示」选项文案。Label for "show" option. */
+    show?: string;
+    /** 「隐藏」选项文案。Label for "hide" option. */
+    hide?: string;
+}
+declare const ShowFilter: import('react').MemoExoticComponent<({ value, onChange, filterEnabled, filterDisabled, enableFilterAriaLabel, disableFilterAriaLabel, all, show, hide, }: ShowFilterProps) => import("react/jsx-runtime").JSX.Element>;
+export default ShowFilter;

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

@@ -0,0 +1,16 @@
+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-runtime").JSX.Element;
+declare const SlideDownSwitcher: typeof SlideDownSwitcherInner & {
+    displayName?: string;
+};
+export default SlideDownSwitcher;

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

@@ -0,0 +1,26 @@
+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?: string;
+    /** 错误信息。Error message. */
+    error?: string;
+    /** 辅助说明。Helper text. */
+    helperText?: string;
+    /** 是否必填。Required. */
+    required?: boolean;
+}
+declare const Slider: import('react').NamedExoticComponent<SliderProps & import('react').RefAttributes<HTMLDivElement>>;
+export default Slider;

package/dist/src/designs/components/Suspense/SuspenseErrorBoundary.d.ts

@@ -0,0 +1,21 @@
+import { ReactNode, Component } from 'react';
+interface SuspenseErrorBoundaryProps {
+    children: ReactNode;
+    fallbackRender: (args: {
+        error: Error | null;
+        retry: () => void;
+    }) => ReactNode;
+    onReset?: () => void;
+}
+interface SuspenseErrorBoundaryState {
+    hasError: boolean;
+    error: Error | null;
+}
+declare class SuspenseErrorBoundary extends Component<SuspenseErrorBoundaryProps, SuspenseErrorBoundaryState> {
+    state: SuspenseErrorBoundaryState;
+    static getDerivedStateFromError(error: Error): SuspenseErrorBoundaryState;
+    componentDidCatch(error: Error): void;
+    private handleReset;
+    render(): ReactNode;
+}
+export default SuspenseErrorBoundary;

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

@@ -0,0 +1,47 @@
+import { QueryErrorResetBoundaryProps } from '@tanstack/react-query';
+import { ReactNode, SuspenseProps as ReactSuspenseProps } from 'react';
+export interface SuspenseProps extends Omit<ReactSuspenseProps, "fallback">, Omit<QueryErrorResetBoundaryProps, "children"> {
+    /** 自定义 fallback。Custom fallback. */
+    fallback?: ReactNode;
+    /** 测试用：始终挂起。Test: always suspend. */
+    test?: boolean;
+    /** 加载动画类型。Loading type. */
+    loadingType?: "ecg" | "truck" | "bounce";
+    /** 加载图形形状。Loading shape. */
+    loadingShape?: "square" | "circle";
+    /** 加载中文案，由调用方传入。Loading text; pass from caller (e.g. i18n). */
+    loadingText?: string;
+    /** 加载图尺寸。Loading size. */
+    loadingSize?: "small" | "medium" | "large";
+    /** 加载容器 className。Loading container className. */
+    loadingContainerClassName?: string;
+    /** 加载文案 className。Loading text className. */
+    loadingTextClassName?: string;
+    /** 加载图 className。Loading className. */
+    loadingClassName?: string;
+    /** 自定义错误 UI。Custom error fallback. */
+    errorFallback?: (args: {
+        error: Error | null;
+        retry: () => void;
+    }) => ReactNode;
+    /** 错误标题，由调用方传入。Error title; pass from caller. */
+    errorTitle?: string;
+    /** 错误描述，由调用方传入。Error description; pass from caller. */
+    errorDescription?: string;
+    /** 重试按钮文案，由调用方传入。Retry text; pass from caller. */
+    retryText?: string;
+    /** 错误详情折叠文案。Error details text. */
+    errorDetailsText?: string;
+    /** 清除本地数据按钮文案。Clear local data text. */
+    clearLocalDataText?: string;
+    /** 点击「清除本地数据」后执行（如跳转登录页），由调用方传入。Called after clear local data (e.g. navigate to login); pass from caller. */
+    onClearLocalData?: () => void;
+    /** 错误容器 className。Error container className. */
+    errorContainerClassName?: string;
+    /** 错误详情 className。Error details className. */
+    errorDetailsClassName?: string;
+    /** 是否展示错误详情。Show error details. */
+    showErrorDetails?: boolean;
+}
+declare const Suspense: import('react').MemoExoticComponent<({ fallback, test, loadingType, loadingShape, loadingClassName, loadingText, loadingSize, loadingContainerClassName, loadingTextClassName, children, errorFallback, errorTitle, errorDescription, retryText, errorDetailsText, clearLocalDataText, onClearLocalData, errorContainerClassName, errorDetailsClassName, showErrorDetails, ...restProps }: SuspenseProps) => import("react/jsx-runtime").JSX.Element>;
+export default Suspense;

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

@@ -0,0 +1,21 @@
+import { ReactNode, TextareaHTMLAttributes } from 'react';
+export interface TextareaProps extends Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, "size"> {
+    /** 标签文案。Label text. */
+    label?: string;
+    /** 错误信息。Error message. */
+    error?: string;
+    /** 辅助说明。Helper text. */
+    helperText?: string;
+    /** 左侧图标。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;

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

@@ -0,0 +1,3 @@
+import { ThemeSwitcherProps } from '../../../../themes/types';
+declare const ThemeSwitcher: import('react').MemoExoticComponent<({ status, getThemeDisplayName, handleChangeTheme }: ThemeSwitcherProps) => import("react/jsx-runtime").JSX.Element>;
+export default ThemeSwitcher;

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

@@ -0,0 +1,41 @@
+import { VirtualizerOptions } from '@tanstack/react-virtual';
+import { ReactNode } from 'react';
+export interface VirtualListProps<T> extends Partial<Omit<VirtualizerOptions<HTMLDivElement, Element>, "count" | "getScrollElement" | "observeElementRect" | "observeElementOffset" | "scrollToFn" | "getItemKey" | "estimateSize">> {
+    /** 数据列表。Data array. */
+    data: T[];
+    /** 是否有下一页。Has next page. */
+    hasNextPage?: boolean;
+    /** 是否正在拉取下一页。Is fetching next page. */
+    isFetchingNextPage?: boolean;
+    /** 拉取下一页。Fetch next page. */
+    fetchNextPage?: () => void;
+    /** 单项渲染。Render item. */
+    renderItem: (item: T, index: number) => ReactNode;
+    /** 单项高度估计。Estimate item size. */
+    estimateSize?: number | ((index: number) => number);
+    /** 列表高度。List height. */
+    height?: string | number;
+    /** 单项 key。Get item key. */
+    getItemKey: (item: T, index: number) => string | number;
+    /** 空状态自定义节点。Empty state node. */
+    emptyState?: ReactNode;
+    /** 加载更多指示器。Loading indicator node. */
+    loadingIndicator?: ReactNode;
+    /** 列表底指示器。End of list indicator node. */
+    endOfListIndicator?: ReactNode;
+    /** 当未提供 emptyState 时使用的文案，由调用方传入。Text when no data; used when emptyState not provided. */
+    emptyText?: string;
+    /** 当未提供 loadingIndicator 时使用的文案。Text when loading more. */
+    loadingMoreText?: string;
+    /** 当未提供 endOfListIndicator 时使用的文案。Text at end of list. */
+    endOfListText?: string;
+    /** 列表项容器 className。Flex container class. */
+    flexClass?: string;
+    /** 外层容器 className。Outer class. */
+    outerClass?: string;
+    /** 内层容器 className。Inner class. */
+    innerClass?: string;
+}
+declare function VirtualListComponent<T>({ data, hasNextPage, isFetchingNextPage, fetchNextPage, renderItem, estimateSize, overscan, height, getItemKey, emptyState, loadingIndicator, endOfListIndicator, emptyText, loadingMoreText, endOfListText, flexClass, outerClass, innerClass, ...virtualizerOptions }: VirtualListProps<T>): import("react/jsx-runtime").JSX.Element;
+declare const VirtualList: typeof VirtualListComponent;
+export default VirtualList;