@qiaopeng/tanstack-query-plus 0.1.0

package/dist/PersistQueryClientProvider.d.ts

@@ -0,0 +1,22 @@
+import type { QueryClient } from "@tanstack/react-query";
+import type { ReactNode } from "react";
+export interface PersistQueryClientProviderProps {
+    children: ReactNode;
+    client: QueryClient;
+    cacheKey?: string;
+    enablePersistence?: boolean;
+    enableOfflineSupport?: boolean;
+    onPersistError?: (error: Error) => void;
+    onPersistRestore?: () => void;
+}
+export declare function PersistQueryClientProvider({ children, client, cacheKey, enablePersistence, enableOfflineSupport, onPersistError: _onPersistError, onPersistRestore }: PersistQueryClientProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function usePersistenceStatus(): {
+    isOnline: boolean;
+    isOffline: boolean;
+};
+export declare function usePersistenceManager(): {
+    clearCache: (cacheKey?: string) => void;
+    getOnlineStatus: () => boolean;
+};
+export default PersistQueryClientProvider;
+//# sourceMappingURL=PersistQueryClientProvider.d.ts.map

package/dist/PersistQueryClientProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PersistQueryClientProvider.d.ts","sourceRoot":"","sources":["../src/PersistQueryClientProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAOvC,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACxC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;CAC/B;AAED,wBAAgB,0BAA0B,CAAC,EACzC,QAAQ,EACR,MAAM,EACN,QAAiC,EACjC,iBAAwB,EACxB,oBAA2B,EAC3B,cAAc,EAAE,eAAe,EAC/B,gBAAgB,EACjB,EAAE,+BAA+B,2CA0BjC;AAED,wBAAgB,oBAAoB;;;EASnC;AAED,wBAAgB,qBAAqB;;;EAWpC;AAED,eAAe,0BAA0B,CAAC"}

package/dist/PersistQueryClientProvider.js

@@ -0,0 +1,47 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { QueryClientProvider } from "@tanstack/react-query";
+import { PersistQueryClientProvider as TanStackPersistProvider } from "@tanstack/react-query-persist-client";
+import { useEffect, useState } from "react";
+import { isOnline, setupOnlineManager, subscribeToOnlineStatus } from "./features/offline.js";
+import { clearCache, createPersister } from "./features/persistence.js";
+export function PersistQueryClientProvider({ children, client, cacheKey = "tanstack-query-cache", enablePersistence = true, enableOfflineSupport = true, onPersistError: _onPersistError, onPersistRestore }) {
+    useEffect(() => {
+        if (enableOfflineSupport) {
+            setupOnlineManager();
+        }
+    }, [enableOfflineSupport]);
+    if (enablePersistence) {
+        const persister = createPersister(cacheKey);
+        if (!persister) {
+            return _jsx(QueryClientProvider, { client: client, children: children });
+        }
+        return (_jsx(TanStackPersistProvider, { client: client, persistOptions: {
+                persister,
+                maxAge: 1000 * 60 * 60 * 24
+            }, onSuccess: onPersistRestore, children: children }));
+    }
+    return _jsx(QueryClientProvider, { client: client, children: children });
+}
+export function usePersistenceStatus() {
+    const [online, setOnline] = useState(isOnline());
+    useEffect(() => {
+        return subscribeToOnlineStatus(setOnline);
+    }, []);
+    return {
+        isOnline: online,
+        isOffline: !online
+    };
+}
+export function usePersistenceManager() {
+    const clearPersistenceCache = (cacheKey = "tanstack-query-cache") => {
+        clearCache(cacheKey);
+    };
+    const getOnlineStatus = () => {
+        return isOnline();
+    };
+    return {
+        clearCache: clearPersistenceCache,
+        getOnlineStatus
+    };
+}
+export default PersistQueryClientProvider;

package/dist/components/LoadingFallback.d.ts

@@ -0,0 +1,16 @@
+export declare function DefaultLoadingFallback(): import("react/jsx-runtime").JSX.Element;
+export declare function TextSkeletonFallback({ lines }: {
+    lines?: number;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function CardSkeletonFallback(): import("react/jsx-runtime").JSX.Element;
+export declare function ListSkeletonFallback({ items }: {
+    items?: number;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function PageSkeletonFallback(): import("react/jsx-runtime").JSX.Element;
+export declare function SmallLoadingIndicator({ size }: {
+    size?: "sm" | "md" | "lg";
+}): import("react/jsx-runtime").JSX.Element;
+export declare function FullScreenLoading({ message }: {
+    message?: string;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=LoadingFallback.d.ts.map

package/dist/components/LoadingFallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoadingFallback.d.ts","sourceRoot":"","sources":["../../src/components/LoadingFallback.tsx"],"names":[],"mappings":"AAAA,wBAAgB,sBAAsB,4CASrC;AACD,wBAAgB,oBAAoB,CAAC,EAAE,KAAS,EAAE,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,2CAWrE;AACD,wBAAgB,oBAAoB,4CAWnC;AACD,wBAAgB,oBAAoB,CAAC,EAAE,KAAS,EAAE,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,2CAcrE;AACD,wBAAgB,oBAAoB,4CAyBnC;AACD,wBAAgB,qBAAqB,CAAC,EAAE,IAAW,EAAE,EAAE;IAAE,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;CAAE,2CAOnF;AACD,wBAAgB,iBAAiB,CAAC,EAAE,OAAkB,EAAE,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,2CAS7E"}

package/dist/components/LoadingFallback.js

@@ -0,0 +1,27 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export function DefaultLoadingFallback() {
+    return (_jsx("div", { className: "flex items-center justify-center p-6", children: _jsxs("div", { className: "text-center", children: [_jsx("div", { className: "w-12 h-12 mx-auto mb-3 border-4 border-primary/20 border-t-primary rounded-full animate-spin" }), _jsx("p", { className: "text-sm text-muted-foreground", children: "\u52A0\u8F7D\u4E2D..." })] }) }));
+}
+export function TextSkeletonFallback({ lines = 3 }) {
+    return (_jsx("div", { className: "space-y-3 p-4", children: Array.from({ length: lines }).map((_, i) => (_jsxs("div", { className: "animate-pulse", children: [_jsx("div", { className: "h-4 bg-input rounded w-3/4 mb-2" }), _jsx("div", { className: "h-4 bg-input rounded w-1/2" })] }, i))) }));
+}
+export function CardSkeletonFallback() {
+    return (_jsxs("div", { className: "border border-border rounded-lg p-4 animate-pulse bg-card", children: [_jsx("div", { className: "h-6 bg-input rounded w-1/2 mb-4" }), _jsxs("div", { className: "space-y-2", children: [_jsx("div", { className: "h-4 bg-input rounded" }), _jsx("div", { className: "h-4 bg-input rounded w-5/6" }), _jsx("div", { className: "h-4 bg-input rounded w-4/6" })] })] }));
+}
+export function ListSkeletonFallback({ items = 3 }) {
+    return (_jsx("div", { className: "space-y-4 p-4", children: Array.from({ length: items }).map((_, i) => (_jsxs("div", { className: "flex items-center space-x-4 animate-pulse", children: [_jsx("div", { className: "w-12 h-12 bg-input rounded-full shrink-0" }), _jsxs("div", { className: "flex-1 space-y-2", children: [_jsx("div", { className: "h-4 bg-input rounded w-3/4" }), _jsx("div", { className: "h-3 bg-input rounded w-1/2" })] })] }, i))) }));
+}
+export function PageSkeletonFallback() {
+    return (_jsxs("div", { className: "w-full p-6 space-y-6", children: [_jsxs("div", { className: "animate-pulse", children: [_jsx("div", { className: "h-8 bg-input rounded w-1/3 mb-2" }), _jsx("div", { className: "h-4 bg-input rounded w-1/2" })] }), _jsxs("div", { className: "grid grid-cols-1 md:grid-cols-3 gap-6", children: [_jsxs("div", { className: "md:col-span-2 space-y-4", children: [_jsx(CardSkeletonFallback, {}), _jsx(CardSkeletonFallback, {})] }), _jsx("div", { className: "space-y-4", children: _jsxs("div", { className: "border border-border rounded-lg p-4 animate-pulse bg-card", children: [_jsx("div", { className: "h-4 bg-input rounded w-2/3 mb-3" }), _jsxs("div", { className: "space-y-2", children: [_jsx("div", { className: "h-3 bg-input rounded" }), _jsx("div", { className: "h-3 bg-input rounded w-5/6" }), _jsx("div", { className: "h-3 bg-input rounded w-4/6" })] })] }) })] })] }));
+}
+export function SmallLoadingIndicator({ size = "md" }) {
+    const sizeClasses = {
+        sm: "w-4 h-4 border-2",
+        md: "w-6 h-6 border-2",
+        lg: "w-8 h-8 border-3"
+    };
+    return _jsx("div", { className: `${sizeClasses[size]} border-primary/20 border-t-primary rounded-full animate-spin` });
+}
+export function FullScreenLoading({ message = "加载中..." }) {
+    return (_jsx("div", { className: "fixed inset-0 bg-background/90 flex items-center justify-center z-50", children: _jsxs("div", { className: "text-center", children: [_jsx("div", { className: "w-16 h-16 mx-auto mb-4 border-4 border-primary/20 border-t-primary rounded-full animate-spin" }), _jsx("p", { className: "text-lg text-foreground", children: message })] }) }));
+}

package/dist/components/QueryErrorBoundary.d.ts

@@ -0,0 +1,12 @@
+import type { ReactNode } from "react";
+export interface QueryErrorBoundaryProps {
+    children: ReactNode;
+    fallback?: (error: Error, resetErrorBoundary: () => void) => ReactNode;
+    onError?: (error: Error, errorInfo: {
+        componentStack: string;
+    }) => void;
+    resetKeys?: Array<string | number>;
+}
+export declare function QueryErrorBoundary({ children, fallback, onError, resetKeys, ...props }: QueryErrorBoundaryProps): import("react/jsx-runtime").JSX.Element;
+export declare function QueryErrorFallback(error: Error, resetErrorBoundary: () => void): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=QueryErrorBoundary.d.ts.map

package/dist/components/QueryErrorBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueryErrorBoundary.d.ts","sourceRoot":"","sources":["../../src/components/QueryErrorBoundary.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,IAAI,KAAK,SAAS,CAAC;IACvE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACxE,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;CACpC;AAED,wBAAgB,kBAAkB,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,uBAAuB,2CAU/G;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,IAAI,2CAwB9E"}

package/dist/components/QueryErrorBoundary.js

@@ -0,0 +1,9 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { QueryErrorResetBoundary } from "@tanstack/react-query";
+import { ErrorBoundary } from "./internal/ErrorBoundary.js";
+export function QueryErrorBoundary({ children, fallback, onError, resetKeys, ...props }) {
+    return (_jsx(QueryErrorResetBoundary, { children: ({ reset }) => (_jsx(ErrorBoundary, { fallback: fallback || QueryErrorFallback, onError: onError, onReset: reset, resetKeys: resetKeys, ...props, children: children })) }));
+}
+export function QueryErrorFallback(error, resetErrorBoundary) {
+    return (_jsx("div", { className: "flex items-center justify-center p-6", children: _jsxs("div", { className: "text-center max-w-md", children: [_jsx("div", { className: "mb-4", children: _jsx("div", { className: "w-12 h-12 mx-auto mb-3 bg-orange-100 rounded-full flex items-center justify-center", children: _jsx("svg", { className: "w-6 h-6 text-orange-600", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M12 8v4m0 4h.01M21 12a9 9 0 11-18 0 9 9 0 0118 0z" }) }) }) }), _jsx("h3", { className: "text-lg font-semibold text-foreground mb-2", children: "\u67E5\u8BE2\u5931\u8D25" }), _jsx("p", { className: "text-sm text-muted-foreground mb-4", children: error.message || "数据加载失败，请稍后重试" }), _jsxs("div", { className: "space-x-2", children: [_jsx("button", { onClick: resetErrorBoundary, className: "px-4 py-2 bg-primary text-primary-foreground rounded-md", children: "\u91CD\u65B0\u52A0\u8F7D" }), _jsx("button", { onClick: () => window.location.reload(), className: "px-4 py-2 bg-muted text-foreground rounded-md", children: "\u5237\u65B0\u9875\u9762" })] })] }) }));
+}

package/dist/components/SuspenseWrapper.d.ts

@@ -0,0 +1,14 @@
+import type { ReactNode } from "react";
+interface SuspenseWrapperProps {
+    children: ReactNode;
+    fallback?: ReactNode;
+    errorFallback?: (error: Error, resetErrorBoundary: () => void) => ReactNode;
+    onError?: (error: Error, errorInfo: {
+        componentStack: string;
+    }) => void;
+    resetKeys?: Array<string | number>;
+}
+export declare function SuspenseWrapper({ children, fallback, errorFallback, onError, resetKeys }: SuspenseWrapperProps): import("react/jsx-runtime").JSX.Element;
+export declare function QuerySuspenseWrapper({ children, fallback, errorFallback, onError, resetKeys }: SuspenseWrapperProps): import("react/jsx-runtime").JSX.Element;
+export type { SuspenseWrapperProps };
+//# sourceMappingURL=SuspenseWrapper.d.ts.map

package/dist/components/SuspenseWrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SuspenseWrapper.d.ts","sourceRoot":"","sources":["../../src/components/SuspenseWrapper.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,UAAU,oBAAoB;IAC5B,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,IAAI,KAAK,SAAS,CAAC;IAC5E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACxE,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;CACpC;AAED,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,QAAgC,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,oBAAoB,2CAMtI;AAED,wBAAgB,oBAAoB,CAAC,EAAE,QAAQ,EAAE,QAAsC,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,oBAAoB,2CAMjJ;AAED,YAAY,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/components/SuspenseWrapper.js

@@ -0,0 +1,9 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Suspense } from "react";
+import { QueryErrorBoundary } from "./QueryErrorBoundary.js";
+export function SuspenseWrapper({ children, fallback = _jsx("div", { children: "Loading..." }), errorFallback, onError, resetKeys }) {
+    return (_jsx(QueryErrorBoundary, { fallback: errorFallback, onError: onError, resetKeys: resetKeys, children: _jsx(Suspense, { fallback: fallback, children: children }) }));
+}
+export function QuerySuspenseWrapper({ children, fallback = _jsx("div", { children: "Loading query..." }), errorFallback, onError, resetKeys }) {
+    return (_jsx(SuspenseWrapper, { fallback: fallback, errorFallback: errorFallback, onError: onError, resetKeys: resetKeys, children: children }));
+}

package/dist/components/index.d.ts

@@ -0,0 +1,4 @@
+export { CardSkeletonFallback, DefaultLoadingFallback, FullScreenLoading, ListSkeletonFallback, PageSkeletonFallback, SmallLoadingIndicator, TextSkeletonFallback } from "./LoadingFallback.js";
+export { QueryErrorBoundary, type QueryErrorBoundaryProps } from "./QueryErrorBoundary.js";
+export { SuspenseWrapper } from "./SuspenseWrapper.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/components/index.js

@@ -0,0 +1,3 @@
+export { CardSkeletonFallback, DefaultLoadingFallback, FullScreenLoading, ListSkeletonFallback, PageSkeletonFallback, SmallLoadingIndicator, TextSkeletonFallback } from "./LoadingFallback.js";
+export { QueryErrorBoundary } from "./QueryErrorBoundary.js";
+export { SuspenseWrapper } from "./SuspenseWrapper.js";

package/dist/components/internal/ErrorBoundary.d.ts

@@ -0,0 +1,26 @@
+import type { ReactNode } from "react";
+import { Component } from "react";
+export interface ErrorBoundaryProps {
+    children: ReactNode;
+    fallback?: (error: Error, resetErrorBoundary: () => void) => ReactNode;
+    onError?: (error: Error, errorInfo: {
+        componentStack: string;
+    }) => void;
+    onReset?: () => void;
+    resetKeys?: Array<string | number>;
+}
+interface ErrorBoundaryState {
+    hasError: boolean;
+    error?: Error;
+}
+export declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    constructor(props: ErrorBoundaryProps);
+    static getDerivedStateFromError(error: Error): ErrorBoundaryState;
+    componentDidCatch(error: Error, errorInfo: {
+        componentStack: string;
+    }): void;
+    resetErrorBoundary: () => void;
+    render(): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element | null | undefined;
+}
+export {};
+//# sourceMappingURL=ErrorBoundary.d.ts.map

package/dist/components/internal/ErrorBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorBoundary.d.ts","sourceRoot":"","sources":["../../../src/components/internal/ErrorBoundary.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,IAAI,KAAK,SAAS,CAAC;IACvE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACxE,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;CACpC;AAED,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,qBAAa,aAAc,SAAQ,SAAS,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;gBACtE,KAAK,EAAE,kBAAkB;IAIrC,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,kBAAkB;IAGjE,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE;IAGrE,kBAAkB,aAGhB;IACF,MAAM;CAmBP"}

package/dist/components/internal/ErrorBoundary.js

@@ -0,0 +1,28 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Component } from "react";
+export class ErrorBoundary extends Component {
+    constructor(props) {
+        super(props);
+        this.resetErrorBoundary = () => {
+            this.props.onReset?.();
+            this.setState({ hasError: false, error: undefined });
+        };
+        this.state = { hasError: false };
+    }
+    static getDerivedStateFromError(error) {
+        return { hasError: true, error };
+    }
+    componentDidCatch(error, errorInfo) {
+        this.props.onError?.(error, errorInfo);
+    }
+    render() {
+        const { hasError, error } = this.state;
+        const { children, fallback } = this.props;
+        if (hasError && error) {
+            if (fallback)
+                return fallback(error, this.resetErrorBoundary);
+            return (_jsx("div", { className: "flex items-center justify-center p-6", children: _jsxs("div", { className: "text-center max-w-md", children: [_jsx("h3", { className: "text-lg font-semibold text-foreground mb-2", children: "\u53D1\u751F\u9519\u8BEF" }), _jsx("p", { className: "text-sm text-muted-foreground mb-4", children: error.message || "请稍后重试" }), _jsx("button", { onClick: this.resetErrorBoundary, className: "px-4 py-2 bg-primary text-primary-foreground rounded-md", children: "\u91CD\u8BD5" })] }) }));
+        }
+        return children;
+    }
+}

package/dist/core/config.d.ts

@@ -0,0 +1,36 @@
+import type { DefaultOptions } from "@tanstack/react-query";
+export declare const TIME_CONSTANTS: {
+    readonly THIRTY_SECONDS: number;
+    readonly ONE_MINUTE: number;
+    readonly FIVE_MINUTES: number;
+    readonly TEN_MINUTES: number;
+    readonly FIFTEEN_MINUTES: number;
+    readonly THIRTY_MINUTES: number;
+    readonly ONE_HOUR: number;
+    readonly ONE_DAY: number;
+};
+export declare const DEFAULT_STALE_TIME: number;
+export declare const DEFAULT_GC_TIME: number;
+export declare function defaultQueryRetryStrategy(failureCount: number, error: unknown): boolean;
+export declare function defaultMutationRetryStrategy(failureCount: number, error: unknown): boolean;
+export declare function exponentialBackoff(attemptIndex: number): number;
+export declare const DEFAULT_QUERY_CONFIG: DefaultOptions["queries"];
+export declare const DEFAULT_MUTATION_CONFIG: DefaultOptions["mutations"];
+export declare const GLOBAL_QUERY_CONFIG: DefaultOptions;
+export declare const SMART_RETRY_MUTATION_CONFIG: DefaultOptions["mutations"];
+export declare const DEVELOPMENT_CONFIG: DefaultOptions;
+export declare const PRODUCTION_CONFIG: DefaultOptions;
+export declare const LONG_CACHE_CONFIG: DefaultOptions;
+export declare const REALTIME_CONFIG: DefaultOptions;
+export declare function getConfigByEnvironment(env: "development" | "production" | "test"): DefaultOptions;
+export declare function createCustomConfig(overrides: Partial<DefaultOptions>): DefaultOptions;
+export declare function validateGcTime(staleTime: number, gcTime: number): {
+    isValid: boolean;
+    warning?: string;
+};
+export declare function validateConfig(config: DefaultOptions): {
+    isValid: boolean;
+    warnings: string[];
+};
+export declare function ensureBestPractices(config: DefaultOptions): DefaultOptions;
+//# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,eAAO,MAAM,cAAc;;;;;;;;;CASjB,CAAC;AAEX,eAAO,MAAM,kBAAkB,QAAgC,CAAC;AAChE,eAAO,MAAM,eAAe,QAA6B,CAAC;AAO1D,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAKvF;AAED,wBAAgB,4BAA4B,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAK1F;AAED,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,eAAO,MAAM,oBAAoB,EAAE,cAAc,CAAC,SAAS,CAQ1D,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,cAAc,CAAC,WAAW,CAI/D,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,cAGjC,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,cAAc,CAAC,WAAW,CAInE,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,cAYhC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,cAY/B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,cAa/B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAW7B,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,aAAa,GAAG,YAAY,GAAG,MAAM,GAAG,cAAc,CAwBjG;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAWrF;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAQxG;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CA2B/F;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAkC1E"}

package/dist/core/config.js

@@ -0,0 +1,213 @@
+import { isProd } from "./env.js";
+export const TIME_CONSTANTS = {
+    THIRTY_SECONDS: 30 * 1000,
+    ONE_MINUTE: 60 * 1000,
+    FIVE_MINUTES: 5 * 60 * 1000,
+    TEN_MINUTES: 10 * 60 * 1000,
+    FIFTEEN_MINUTES: 15 * 60 * 1000,
+    THIRTY_MINUTES: 30 * 60 * 1000,
+    ONE_HOUR: 60 * 60 * 1000,
+    ONE_DAY: 24 * 60 * 60 * 1000
+};
+export const DEFAULT_STALE_TIME = TIME_CONSTANTS.THIRTY_SECONDS;
+export const DEFAULT_GC_TIME = TIME_CONSTANTS.TEN_MINUTES;
+export function defaultQueryRetryStrategy(failureCount, error) {
+    const httpError = error;
+    if (httpError?.status && httpError.status >= 400 && httpError.status < 500)
+        return false;
+    if (httpError?.status && httpError.status >= 500)
+        return failureCount < 3;
+    return failureCount < 3;
+}
+export function defaultMutationRetryStrategy(failureCount, error) {
+    const httpError = error;
+    if (httpError?.status && httpError.status >= 400 && httpError.status < 500)
+        return false;
+    if (httpError?.status && httpError.status >= 500)
+        return failureCount < 2;
+    return failureCount < 2;
+}
+export function exponentialBackoff(attemptIndex) {
+    return Math.min(1000 * 2 ** attemptIndex, 30000);
+}
+export const DEFAULT_QUERY_CONFIG = {
+    staleTime: DEFAULT_STALE_TIME,
+    gcTime: DEFAULT_GC_TIME,
+    retry: defaultQueryRetryStrategy,
+    retryDelay: exponentialBackoff,
+    refetchOnWindowFocus: true,
+    refetchOnReconnect: true,
+    refetchOnMount: true
+};
+export const DEFAULT_MUTATION_CONFIG = {
+    retry: 0,
+    retryDelay: exponentialBackoff,
+    gcTime: DEFAULT_GC_TIME
+};
+export const GLOBAL_QUERY_CONFIG = {
+    queries: DEFAULT_QUERY_CONFIG,
+    mutations: DEFAULT_MUTATION_CONFIG
+};
+export const SMART_RETRY_MUTATION_CONFIG = {
+    retry: defaultMutationRetryStrategy,
+    retryDelay: exponentialBackoff,
+    gcTime: DEFAULT_GC_TIME
+};
+export const DEVELOPMENT_CONFIG = {
+    queries: {
+        ...DEFAULT_QUERY_CONFIG,
+        staleTime: 0,
+        gcTime: TIME_CONSTANTS.TEN_MINUTES,
+        retry: 1,
+        refetchOnWindowFocus: true
+    },
+    mutations: {
+        ...DEFAULT_MUTATION_CONFIG,
+        retry: 0
+    }
+};
+export const PRODUCTION_CONFIG = {
+    queries: {
+        ...DEFAULT_QUERY_CONFIG,
+        staleTime: TIME_CONSTANTS.TEN_MINUTES,
+        gcTime: TIME_CONSTANTS.THIRTY_MINUTES,
+        retry: 3,
+        refetchOnWindowFocus: true
+    },
+    mutations: {
+        ...DEFAULT_MUTATION_CONFIG,
+        retry: 0
+    }
+};
+export const LONG_CACHE_CONFIG = {
+    queries: {
+        ...DEFAULT_QUERY_CONFIG,
+        staleTime: TIME_CONSTANTS.FIFTEEN_MINUTES,
+        gcTime: TIME_CONSTANTS.ONE_HOUR,
+        retry: 2,
+        refetchOnWindowFocus: true,
+        refetchOnReconnect: true
+    },
+    mutations: {
+        ...DEFAULT_MUTATION_CONFIG,
+        retry: 0
+    }
+};
+export const REALTIME_CONFIG = {
+    queries: {
+        ...DEFAULT_QUERY_CONFIG,
+        staleTime: 0,
+        gcTime: TIME_CONSTANTS.ONE_MINUTE * 2,
+        retry: 5,
+        refetchOnWindowFocus: true,
+        refetchOnReconnect: true,
+        refetchInterval: TIME_CONSTANTS.THIRTY_SECONDS
+    },
+    mutations: DEFAULT_MUTATION_CONFIG
+};
+export function getConfigByEnvironment(env) {
+    switch (env) {
+        case "development":
+            return DEVELOPMENT_CONFIG;
+        case "production":
+            return PRODUCTION_CONFIG;
+        case "test":
+            return {
+                queries: {
+                    ...DEFAULT_QUERY_CONFIG,
+                    retry: 0,
+                    staleTime: 0,
+                    refetchOnWindowFocus: false,
+                    refetchOnReconnect: false,
+                    refetchOnMount: true
+                },
+                mutations: {
+                    ...DEFAULT_MUTATION_CONFIG,
+                    retry: 0
+                }
+            };
+        default:
+            return GLOBAL_QUERY_CONFIG;
+    }
+}
+export function createCustomConfig(overrides) {
+    return {
+        queries: {
+            ...DEFAULT_QUERY_CONFIG,
+            ...overrides.queries
+        },
+        mutations: {
+            ...DEFAULT_MUTATION_CONFIG,
+            ...overrides.mutations
+        }
+    };
+}
+export function validateGcTime(staleTime, gcTime) {
+    if (gcTime <= staleTime) {
+        return {
+            isValid: false,
+            warning: `gcTime (${gcTime}ms) 必须大于 staleTime (${staleTime}ms)。当前 gcTime 过小，可能导致缓存数据过早被清理。`
+        };
+    }
+    return { isValid: true };
+}
+export function validateConfig(config) {
+    const warnings = [];
+    let isValid = true;
+    if (config.queries) {
+        const staleTime = typeof config.queries.staleTime === "number" ? config.queries.staleTime : DEFAULT_STALE_TIME;
+        const gcTime = typeof config.queries.gcTime === "number" ? config.queries.gcTime : DEFAULT_GC_TIME;
+        const gcTimeValidation = validateGcTime(staleTime, gcTime);
+        if (!gcTimeValidation.isValid && gcTimeValidation.warning) {
+            warnings.push(gcTimeValidation.warning);
+            isValid = false;
+        }
+        else if (gcTimeValidation.warning) {
+            warnings.push(gcTimeValidation.warning);
+        }
+        if ("cacheTime" in config.queries) {
+            warnings.push("检测到已废弃的 'cacheTime' 属性。在 React Query v5 中，请使用 'gcTime' 代替。");
+            isValid = false;
+        }
+        if (config.queries.refetchOnWindowFocus === false) {
+            warnings.push("建议启用 'refetchOnWindowFocus' 以提供更好的用户体验。当用户切换回应用时，数据会自动刷新。");
+        }
+        if (typeof config.queries.retryDelay === "number") {
+            warnings.push("建议使用指数退避策略作为重试延迟，而不是固定延迟。例如：(attemptIndex) => Math.min(1000 * 2 ** attemptIndex, 30000)");
+        }
+    }
+    return { isValid, warnings };
+}
+export function ensureBestPractices(config) {
+    const result = { ...config };
+    if (result.queries) {
+        const queries = { ...result.queries };
+        if ("cacheTime" in queries) {
+            const cacheTime = queries.cacheTime;
+            if (typeof cacheTime === "number" && typeof queries.gcTime !== "number") {
+                queries.gcTime = cacheTime;
+            }
+            delete queries.cacheTime;
+            if (!isProd) {
+                console.warn("[TanStack Query Config] 已移除废弃的 'cacheTime' 属性，改用 'gcTime'.");
+            }
+        }
+        const staleTime = typeof queries.staleTime === "number" ? queries.staleTime : DEFAULT_STALE_TIME;
+        const gcTime = typeof queries.gcTime === "number" ? queries.gcTime : DEFAULT_GC_TIME;
+        const validation = validateGcTime(staleTime, gcTime);
+        if (!validation.isValid) {
+            queries.gcTime = staleTime + TIME_CONSTANTS.ONE_MINUTE;
+            if (!isProd) {
+                console.warn(`[TanStack Query Config] 自动调整 gcTime 从 ${gcTime}ms 到 ${queries.gcTime}ms，以确保大于 staleTime (${staleTime}ms)。`);
+            }
+        }
+        if (typeof queries.retryDelay === "number" || !queries.retryDelay) {
+            queries.retryDelay = exponentialBackoff;
+        }
+        if (queries.refetchOnWindowFocus === undefined) {
+            queries.refetchOnWindowFocus = true;
+        }
+        result.queries = queries;
+    }
+    return result;
+}

package/dist/core/devtools.d.ts

@@ -0,0 +1,14 @@
+export { ReactQueryDevtools } from "@tanstack/react-query-devtools";
+export interface DevToolsConfig {
+    initialIsOpen?: boolean;
+    position?: "top-left" | "top-right" | "bottom-left" | "bottom-right";
+    enabled?: boolean;
+    buttonPosition?: "top-left" | "top-right" | "bottom-left" | "bottom-right";
+    panelProps?: React.ComponentProps<"div">;
+    closeButtonProps?: React.ComponentProps<"button">;
+    toggleButtonProps?: React.ComponentProps<"button">;
+}
+export declare const defaultDevToolsConfig: DevToolsConfig;
+export declare function createDevToolsConfig(overrides?: Partial<DevToolsConfig>): DevToolsConfig;
+export declare function isDevToolsEnabled(): boolean;
+//# sourceMappingURL=devtools.d.ts.map

package/dist/core/devtools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools.d.ts","sourceRoot":"","sources":["../../src/core/devtools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEpE,MAAM,WAAW,cAAc;IAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,aAAa,GAAG,cAAc,CAAC;IACrE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,aAAa,GAAG,cAAc,CAAC;IAC3E,UAAU,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IACzC,gBAAgB,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IAClD,iBAAiB,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;CACpD;AAED,eAAO,MAAM,qBAAqB,EAAE,cAInC,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAKxF;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C"}

package/dist/core/devtools.js

@@ -0,0 +1,16 @@
+import { isProd } from "./env.js";
+export { ReactQueryDevtools } from "@tanstack/react-query-devtools";
+export const defaultDevToolsConfig = {
+    initialIsOpen: false,
+    position: "bottom-right",
+    enabled: !isProd
+};
+export function createDevToolsConfig(overrides) {
+    return {
+        ...defaultDevToolsConfig,
+        ...overrides
+    };
+}
+export function isDevToolsEnabled() {
+    return !isProd;
+}

package/dist/core/env.d.ts

@@ -0,0 +1,3 @@
+export declare const isProd: boolean;
+export declare const isDev: boolean;
+//# sourceMappingURL=env.d.ts.map

package/dist/core/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/core/env.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM,SAAwC,CAAC;AAC5D,eAAO,MAAM,KAAK,SAAU,CAAC"}

package/dist/core/env.js

@@ -0,0 +1,2 @@
+export const isProd = process.env.NODE_ENV === "production";
+export const isDev = !isProd;

package/dist/core/focusManager.d.ts

@@ -0,0 +1,33 @@
+import type { QueryKey } from "@tanstack/react-query";
+import { focusManager } from "@tanstack/react-query";
+export { focusManager };
+export interface FocusManagerConfig {
+    enabled?: boolean;
+    customEventListener?: (handleFocus: () => void) => () => void;
+    refetchOnWindowFocus?: boolean;
+}
+export declare function setupFocusManager(config?: FocusManagerConfig): void;
+export declare function pauseFocusManager(): void;
+export declare function resumeFocusManager(): void;
+export declare class SmartFocusManager {
+    private pauseCount;
+    private originalFocusState;
+    private refetchHistory;
+    private serializeKey;
+    pause(): void;
+    resume(): void;
+    reset(): void;
+    destroy(): void;
+    shouldRefetch(queryKey: QueryKey, minInterval?: number): boolean;
+    clearHistory(): void;
+    clearHistoryByKey(queryKey: QueryKey): void;
+    getLastRefetchTime(queryKey: QueryKey): number | undefined;
+    getStats(): {
+        isPaused: boolean;
+        pauseCount: number;
+        isFocused: boolean;
+    };
+}
+export declare function getSmartFocusManager(): SmartFocusManager;
+export declare function resetSmartFocusManager(): void;
+//# sourceMappingURL=focusManager.d.ts.map

package/dist/core/focusManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focusManager.d.ts","sourceRoot":"","sources":["../../src/core/focusManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mBAAmB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAC;IAC9D,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,wBAAgB,iBAAiB,CAAC,MAAM,GAAE,kBAAuB,QA0BhE;AAED,wBAAgB,iBAAiB,SAEhC;AAED,wBAAgB,kBAAkB,SAGjC;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,kBAAkB,CAAsB;IAChD,OAAO,CAAC,cAAc,CAAkC;IACxD,OAAO,CAAC,YAAY;IAiBpB,KAAK,IAAI,IAAI;IAOb,MAAM,IAAI,IAAI;IAQd,KAAK,IAAI,IAAI;IAOb,OAAO,IAAI,IAAI;IAIf,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,GAAE,MAAa,GAAG,OAAO;IAUtE,YAAY,IAAI,IAAI;IAGpB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAI3C,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS;IAI1D,QAAQ,IAAI;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE;CAG1E;AAGD,wBAAgB,oBAAoB,IAAI,iBAAiB,CAKxD;AACD,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}