nfx-ui 0.6.3 → 0.7.1

package/dist/components.d.ts

@@ -1,413 +1 @@
-import { ButtonHTMLAttributes } from 'react';
-import { ForwardRefExoticComponent } from 'react';
-import { InputHTMLAttributes } from 'react';
-import { JSX } from 'react/jsx-runtime';
-import * as LucideIcons from '@/icons/lucide';
-import { LucideProps } from 'lucide-react';
-import { MemoExoticComponent } from 'react';
-import { NamedExoticComponent } from 'react';
-import { QueryErrorResetBoundaryProps } from '@tanstack/react-query';
-import { ReactNode } from 'react';
-import { RefAttributes } from 'react';
-import { SuspenseProps as SuspenseProps_2 } from 'react';
-import { TextareaHTMLAttributes } from 'react';
-import { VirtualizerOptions } from '@tanstack/react-virtual';
-
-export declare const Button: ForwardRefExoticComponent<ButtonProps & RefAttributes<HTMLButtonElement>>;
-
-export declare 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;
-}
-
-export declare const Dropdown: NamedExoticComponent<DropdownProps>;
-
-export declare interface DropdownOption {
-    /** 选项值。Option value. */
-    value: string;
-    /** 选项展示文案。Option label. */
-    label: string;
-}
-
-export declare 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;
-}
-
-export declare const Icon: MemoExoticComponent<({ name, ...props }: IconProps) => JSX.Element | null>;
-
-export declare type IconName = keyof Omit<typeof LucideIcons, "LucideIcon">;
-
-export declare interface IconProps extends LucideProps {
-    /** 图标名（lucide 注册名）。Icon name (lucide registered name). */
-    name: IconName;
-}
-
-export declare const Input: ForwardRefExoticComponent<InputProps & RefAttributes<HTMLInputElement>>;
-
-export declare 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;
-}
-
-export declare const KeyValueEditor: MemoExoticComponent<({ label, pairs, onChange, valueType, keyPlaceholder, valuePlaceholder, valueArrayPlaceholder, removeAriaLabel, addLabel, error, }: KeyValueEditorProps) => JSX.Element>;
-
-export declare 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;
-}
-
-export declare interface KeyValuePair {
-    /** 键。Key. */
-    key: string;
-    /** 值（字符串或字符串数组）。Value (string or string[]). */
-    value: string | string[];
-}
-
-/**
- * 布局模式枚举与常量。Layout mode enum and constants.
- */
-declare enum LayoutModeEnum {
-    SHOW = "show",
-    HIDE = "hide"
-}
-
-export declare const LayoutSwitcher: MemoExoticComponent<({ status, getLayoutDisplayName, handleChangeLayoutMode }: LayoutSwitcherProps) => JSX.Element>;
-
-/** 布局切换器 props。LayoutSwitcher props. */
-export declare interface LayoutSwitcherProps {
-    /** 样式状态。Visual status. */
-    status?: "primary" | "default";
-    /** 显示模式标签（未传 getLayoutDisplayName 且无内置翻译时使用）。Show mode label. */
-    showLabel?: string;
-    /** 隐藏模式标签（未传 getLayoutDisplayName 且无内置翻译时使用）。Hide mode label. */
-    hideLabel?: string;
-    /** 根据布局模式返回展示名；未传则使用 showLabel / hideLabel。Display name for layout mode; default uses showLabel/hideLabel. */
-    getLayoutDisplayName?: (mode: LayoutModeEnum) => string;
-    /** 处理布局模式改变。Handle layout mode change. */
-    handleChangeLayoutMode?: (mode: LayoutModeEnum) => void;
-}
-
-export declare const SearchInput: MemoExoticComponent<({ value, onChange, placeholder, clearButtonAriaLabel }: SearchInputProps) => JSX.Element>;
-
-export declare 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;
-}
-
-export declare const ShowFilter: MemoExoticComponent<({ value, onChange, filterEnabled, filterDisabled, enableFilterAriaLabel, disableFilterAriaLabel, all, show, hide, }: ShowFilterProps) => JSX.Element>;
-
-export declare 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;
-}
-
-export declare interface ShowFilterValue {
-    /** 筛选是否启用。Whether filter is enabled. */
-    enabled: boolean;
-    /** 显示/隐藏：null=全部，true=显示，false=隐藏。Show/hide: null=all, true=show, false=hide. */
-    value: boolean | null;
-}
-
-export declare const SlideDownSwitcher: typeof SlideDownSwitcherInner & {
-    displayName?: string;
-};
-
-declare const SlideDownSwitcherInner: <T extends string>({ value, options, getDisplayName, onChange, status }: SlideDownSwitcherProps<T>) => JSX.Element;
-
-export declare 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";
-}
-
-export declare const Slider: NamedExoticComponent<SliderProps & RefAttributes<HTMLDivElement>>;
-
-export declare 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;
-}
-
-export declare const Suspense: MemoExoticComponent<({ fallback, test, loadingType, loadingShape, loadingClassName, loadingText, loadingSize, loadingContainerClassName, loadingTextClassName, children, errorFallback, errorTitle, errorDescription, retryText, errorDetailsText, clearLocalDataText, onClearLocalData, errorContainerClassName, errorDetailsClassName, showErrorDetails, ...restProps }: SuspenseProps) => JSX.Element>;
-
-export declare interface SuspenseProps extends Omit<SuspenseProps_2, "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;
-}
-
-export declare const Textarea: ForwardRefExoticComponent<TextareaProps & RefAttributes<HTMLTextAreaElement>>;
-
-export declare 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 enum ThemeEnum {
-    DEFAULT = "default",
-    LIGHT = "light",
-    CORPORATE = "corporate",
-    FOREST = "forest",
-    DARK = "dark",
-    COSMIC = "cosmic",
-    COFFEE = "coffee",
-    WINE = "wine",
-    /** 麦田：default 基础上白红色改为金黄色 */
-    WHEAT = "wheat"
-}
-
-export declare const ThemeSwitcher: MemoExoticComponent<({ status, getThemeDisplayName, handleChangeTheme }: ThemeSwitcherProps) => JSX.Element>;
-
-/** 主题切换器 props。ThemeSwitcher props. */
-export declare interface ThemeSwitcherProps {
-    /** 样式状态。Visual status. */
-    status?: "primary" | "default";
-    /** 根据 theme 返回显示名称；未传则使用 theme 原值。Display name for theme; default is theme value. */
-    getThemeDisplayName?: (theme: ThemeEnum) => string;
-    /** 处理主题改变。Handle theme change. */
-    handleChangeTheme?: (theme: ThemeEnum) => void;
-}
-
-export declare const VirtualList: typeof VirtualListComponent;
-
-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>): JSX.Element;
-
-export declare 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;
-}
-
-export declare const VirtualWindowList: typeof VirtualWindowListComponent;
-
-declare function VirtualWindowListComponent<T>({ data, hasNextPage, isFetchingNextPage, fetchNextPage, renderItem, estimateSize, overscan, height, getItemKey, emptyState, loadingIndicator, endOfListIndicator, emptyText, loadingMoreText, endOfListText, flexClass, outerClass, innerClass, ...virtualizerOptions }: VirtualWindowListProps<T>): JSX.Element;
-
-export declare interface VirtualWindowListProps<T> extends Partial<Omit<VirtualizerOptions<Window, Element>, "count" | "getScrollElement" | "observeElementRect" | "observeElementOffset" | "scrollToFn" | "estimateSize" | "getItemKey">> {
-    /** 数据列表。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 时）。Empty text. */
-    emptyText?: string;
-    /** 加载更多文案。Loading more text. */
-    loadingMoreText?: string;
-    /** 列表底文案。End of list text. */
-    endOfListText?: string;
-    /** 列表项容器 className。Flex container class. */
-    flexClass?: string;
-    /** 外层容器 className。Outer class. */
-    outerClass?: string;
-    /** 内层容器 className。Inner class. */
-    innerClass?: string;
-}
-
 export { }

package/dist/constants.d.ts

@@ -1,130 +1 @@
-import { QueryKey } from '@tanstack/react-query';
-
-/** 单条 key 片段。Item key segment. */
-export declare const CACHE_ITEM = "item";
-
-/** 列表 key 片段。List key segment. */
-export declare const CACHE_LIST = "list";
-
-/**
- * 创建「单条」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"]
- * ```
- */
-export declare function createItemKey(domain: string, subDomain: string): ItemKeyChainable;
-
-/**
- * 创建自定义 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"]
- * ```
- */
-export declare function createKey(...segments: unknown[]): 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"]
- * ```
- */
-export declare function createListKey(domain: string, subDomain: string): ListKeyChainable;
-
-/**
- * 根据同一 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"]
- * ```
- */
-export declare function createQueryKeys(domain: string, subDomain: string): QueryKeysBundle;
-
-export declare 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];
-};
-
-export declare function defineEnum<const M extends EnumMetaMap>(metaMap: M): DefinedEnum<M>;
-
-export declare type EnumInferMeta<E> = E extends DefinedEnum<infer M> ? M : never;
-
-export declare type EnumMetaMap = Record<string, Record<PropertyKey, unknown>>;
-
-export 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 declare type EnumValue<E extends {
-    Values: readonly PropertyKey[];
-}> = E["Values"][number];
-
-/**
- * 链式单条 key 类型：可调用 (...ids) => QueryKey，且带 withPrefix、getPrefix。
- * Chainable item key type: callable (...ids) => QueryKey, with withPrefix() and getPrefix.
- */
-export declare type ItemKeyChainable = ((...ids: string[]) => QueryKey) & {
-    withPrefix(...prefix: unknown[]): ItemKeyChainable;
-    /** 不含 id 的前缀，用于 invalidation 等。Prefix without ids, e.g. for invalidation. */
-    getPrefix: QueryKey;
-};
-
-/**
- * 链式列表 key 类型：本身即 QueryKey（数组），且带 withPrefix、getPrefix。
- * Chainable list key type: is a QueryKey (array) and has withPrefix(), getPrefix.
- */
-export declare type ListKeyChainable = QueryKey & {
-    withPrefix(...prefix: unknown[]): ListKeyChainable;
-    /** 列表 key 的前缀（即完整 list key，用于 invalidation 等）。Prefix (full list key) for invalidation. */
-    getPrefix: QueryKey;
-};
-
-/** 含 list / item 且可链式 withPrefix 的 bundle 类型 */
-export declare type QueryKeysBundle = {
-    list: ListKeyChainable;
-    item: ItemKeyChainable;
-    withPrefix(...prefix: unknown[]): QueryKeysBundle;
-};
-
 export { }

package/dist/events.d.ts

@@ -1,61 +1 @@
-/**
- * 定义品牌类型：用于 defineXxx 的返回值，仅对应的 createXxx/构造函数可接受；Tag 区分不同定义（如 "events" | "router"）。
- * Define brand type: for defineXxx return value, only the matching createXxx accepts; Tag discriminates (e.g. "events" | "router").
- * @example Defined<{ HOME: "/" }, "router"> 仅能传入 createRouter；Defined<{ FOO: "x" }, "events"> 仅能传入 EventEmitter
- */
-declare type Defined<T, Tag extends string> = T & {
-    readonly __defineBrand?: Tag;
-};
-
-/** 由 defineEvents 返回的「已规范事件名对象」类型；constructor 只接受此类型。 */
-export declare type DefinedEvents<T extends Record<string, string>> = Defined<T, "events">;
-
-/**
- * 规范创建「一级 key-value」事件名对象：仅允许 key → 字符串 value，禁止嵌套（类型约束）。
- * 返回 DefinedEvents<T>，供 EventEmitter 构造使用。
- * Define events object: one-level key-value (string values), no nested objects (type-only). Returns DefinedEvents<T> for EventEmitter.
- *
- * @param events - 事件名 key-value 对象。Event name key-value object (e.g. { FOO: "DOMAIN:FOO" }).
- * @returns DefinedEvents<E>，仅此类型可传入 EventEmitter 构造。DefinedEvents<E>; only this type is accepted by EventEmitter constructor.
- * @example
- * ```ts
- * const routerEvents = defineEvents({ NAVIGATE: "ROUTER:NAVIGATE", NAVIGATE_BACK: "ROUTER:NAVIGATE_BACK" });
- * class RouterEmitter extends EventEmitter<EventNamesOf<typeof routerEvents>> { constructor() { super(routerEvents); } }
- * ```
- */
-export declare function defineEvents<E extends Record<string, string>>(events: E): DefinedEvents<E>;
-
-/** 回调类型：内部存储与 on/off 默认(unknown)时均用此，任意函数即可，无需 as 断言。 */
-export declare type EventCallback = (...args: any[]) => void;
-
-/**
- * 泛型 EventEmitter：构造函数仅接受 defineEvents 返回的 DefinedEvents 类型，提供 on / off / emit。
- * PayloadMap[K] 可为 void（无参）、单类型 T（单参）、或元组 [A, B, ...]（多参），统一规范为参数列表。
- * PayloadMap[K] can be void (no args), single type T (one arg), or tuple [A, B, ...] (multi arg).
- *
- * @param events - 须为 defineEvents(...) 的返回值（DefinedEvents）。Must be the return value of defineEvents(...) (DefinedEvents).
- */
-export declare class EventEmitter<E extends string, PayloadMap extends Record<E, unknown> = Record<E, unknown>> {
-    private listeners;
-    constructor(events: DefinedEvents<Record<string, E>>);
-    /** 注册事件监听；回调为任意函数，由 emit 时传入的参数决定实际类型。 */
-    on<K extends E>(event: K, callback: EventCallback): void;
-    /** 移除事件监听（需与 on 时同一引用）。 */
-    off<K extends E>(event: K, callback: EventCallback): void;
-    /**
-     * 触发事件；参数与 PayloadMap[K] 一致：void 无参，T 单参，[A,B] 多参。
-     * Emit an event; args match PayloadMap[K]: void → no args, T → one arg, [A,B] → spread.
-     */
-    emit<K extends E>(event: K, ...args: ToArgs<PayloadMap[K]>): void;
-}
-
-/** 从 events 对象推导出事件名联合类型。Event name union from an events key-value object. */
-export declare type EventNamesOf<T> = T extends Defined<infer O, "events"> ? O[keyof O] : T extends Record<string, string> ? T[keyof T] : never;
-
-/**
- * 将 PayloadMap[K] 规范为参数元组。
- * void→[]；unknown（默认）→ [] | [unknown]；单类型 T→[T]；元组→不变。
- */
-declare type ToArgs<P> = P extends void ? [] : unknown extends P ? [] | [P] : P extends unknown[] ? P : [P];
-
 export { }