remote-reload-utils 0.0.14 → 0.0.16

package/dist/components/RemoteModuleProvider.d.ts

@@ -1,95 +0,0 @@
-import React from 'react';
-import type { ErrorBoundaryProps } from './ErrorBoundary';
-export interface RemoteModuleCardProps {
-    /** 包名称 */
-    pkg: string;
-    /** 版本号，支持 semver 范围 */
-    version: string;
-    /** 远程模块名称（导出名） */
-    moduleName: string;
-    /** 作用域名称 */
-    scopeName: string;
-    /** 加载中的占位内容 */
-    loadingFallback?: React.ReactNode;
-    /** 错误状态的占位内容 */
-    errorFallback?: React.ReactNode | ((error: Error, resetError: () => void) => React.ReactNode);
-    /** 传递给远程组件的 props */
-    componentProps?: Record<string, any>;
-    /** 容器类名 */
-    className?: string;
-    /** 容器样式 */
-    style?: React.CSSProperties;
-    /** 加载成功回调 */
-    onLoad?: (component: React.ComponentType<any>) => void;
-    /** 加载失败回调 */
-    onError?: (error: Error) => void;
-    /** 是否禁用错误边界 */
-    disableErrorBoundary?: boolean;
-    /** 错误边界配置 */
-    errorBoundaryOptions?: Omit<ErrorBoundaryProps, 'children' | 'fallback'>;
-}
-interface ModuleState {
-    loading: boolean;
-    error: Error | null;
-    component: React.ComponentType<any> | null;
-}
-/**
- * Hook 选项：加载远程模块
- */
-export interface UseRemoteModuleOptions {
-    pkg: string;
-    version: string;
-    moduleName: string;
-    scopeName: string;
-    onError?: (error: Error) => void;
-    onLoad?: (component: React.ComponentType<any>) => void;
-    retryKey?: number;
-}
-/**
- * Hook：加载远程模块
- */
-export declare function useRemoteModule({ pkg, version, moduleName, scopeName, onError, onLoad, retryKey, }: UseRemoteModuleOptions): ModuleState;
-/**
- * 远程模块渲染器：纯内容渲染（不含 Suspense/ErrorBoundary）
- */
-export declare function RemoteModuleRenderer({ pkg, version, moduleName, scopeName, loadingFallback, errorFallback, componentProps, className, style, onError, onLoad, }: RemoteModuleCardProps): import("react/jsx-runtime").JSX.Element | null;
-/**
- * 远程模块提供者：带 Suspense 和 ErrorBoundary 的完整组件
- *
- * @features
- * - 自动加载远程模块
- * - 内置加载状态和错误处理
- * - 支持 Suspense 惰性加载
- * - 可配置的错误边界
- * - 支持重试机制
- *
- * @example
- * ```tsx
- * <RemoteModuleProvider
- *   pkg="@myorg/remote-app"
- *   version="^1.0.0"
- *   moduleName="Dashboard"
- *   scopeName="myorg"
- *   loadingFallback={<Spinner />}
- *   errorFallback={(error, reset) => <Button onClick={reset}>Retry</Button>}
- *   componentProps={{ userId: 123 }}
- * />
- * ```
- *
- * @example
- * ```tsx
- * // 使用 lazy + Suspense 模式
- * const LazyRemote = lazyRemote({
- *   pkg: "@myorg/remote-app",
- *   version: "^1.0.0",
- *   moduleName: "Dashboard",
- *   scopeName: "myorg"
- * });
- *
- * <Suspense fallback={<Spinner />}>
- *   <LazyRemote userId={123} />
- * </Suspense>
- * ```
- */
-export declare function RemoteModuleProvider(props: RemoteModuleCardProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/components/SuspenseLoader.d.ts

@@ -1,131 +0,0 @@
-import React, { type ComponentType, type ReactNode } from 'react';
-export interface LazyRemoteOptions {
-    /** 包名称 */
-    pkg: string;
-    /** 版本号 */
-    version?: string;
-    /** 模块名称 */
-    moduleName: string;
-    /** 作用域名称 */
-    scopeName: string;
-    /** 加载失败时的最大重试次数 */
-    maxRetries?: number;
-    /** 重试延迟（毫秒） */
-    retryDelay?: number;
-}
-export interface SuspenseRemoteProps {
-    /** 加载中的占位内容 */
-    fallback?: ReactNode;
-    children: ReactNode;
-}
-export interface SuspenseRemoteWithPropsProps extends LazyRemoteOptions {
-    /** 加载中的占位内容 */
-    fallback?: ReactNode;
-    /** 错误状态的占位内容 */
-    errorFallback?: ReactNode | ((error: Error) => ReactNode);
-    /** 传递给远程组件的 props */
-    componentProps?: Record<string, any>;
-}
-/**
- * 创建一个惰性加载的远程组件
- * 返回一个可用于 React.lazy() 的 Promise
- *
- * @example
- * ```tsx
- * const LazyDashboard = lazyRemote({
- *   pkg: "@myorg/remote-app",
- *   version: "^1.0.0",
- *   moduleName: "Dashboard",
- *   scopeName: "myorg"
- * });
- *
- * function App() {
- *   return (
- *     <Suspense fallback={<Spinner />}>
- *       <LazyDashboard userId={123} />
- *     </Suspense>
- *   );
- * }
- * ```
- */
-export declare function lazyRemote(options: LazyRemoteOptions): React.LazyExoticComponent<React.ComponentType<any>>;
-/**
- * 带 Suspense 和错误处理的远程组件包装器
- * 注意：错误处理需要与 ErrorBoundary 配合使用
- *
- * @example
- * ```tsx
- * // 与 ErrorBoundary 配合使用
- * <ErrorBoundary fallback={(error) => <div>Error: {error.message}</div>}>
- *   <SuspenseRemote fallback={<Spinner />}>
- *     <RemoteModuleProvider pkg="@myorg/remote-app" version="^1.0.0" moduleName="Dashboard" scopeName="myorg" />
- *   </SuspenseRemote>
- * </ErrorBoundary>
- * ```
- */
-export declare function SuspenseRemote({ fallback, children, }: {
-    fallback?: ReactNode;
-    children: ReactNode;
-}): import("react/jsx-runtime").JSX.Element;
-/**
- * 一体化的远程组件加载器（包含 Suspense 和 ErrorBoundary）
- *
- * @example
- * ```tsx
- * <SuspenseRemoteLoader
- *   pkg="@myorg/remote-app"
- *   version="^1.0.0"
- *   moduleName="Dashboard"
- *   scopeName="myorg"
- *   fallback={<Spinner />}
- *   errorFallback={(error) => <div>Error: {error.message}</div>}
- *   componentProps={{ userId: 123 }}
- * />
- * ```
- */
-export declare function SuspenseRemoteLoader({ pkg, version, moduleName, scopeName, fallback, errorFallback, componentProps, }: SuspenseRemoteWithPropsProps): import("react/jsx-runtime").JSX.Element;
-/**
- * HOC：为组件添加远程加载能力
- *
- * @example
- * ```tsx
- * const EnhancedComponent = withRemote(
- *   (props) => <div>{props.message}</div>,
- *   {
- *     pkg: "@myorg/remote-app",
- *     version: "^1.0.0",
- *     moduleName: "RemoteComponent",
- *     scopeName: "myorg"
- *   }
- * );
- *
- * <EnhancedComponent message="Hello" />
- * ```
- */
-export declare function withRemote<P extends object>(WrappedComponent: ComponentType<P>, options: LazyRemoteOptions): (props: P) => import("react/jsx-runtime").JSX.Element;
-/**
- * Hook：在函数组件中加载远程模块
- *
- * @example
- * ```tsx
- * function MyComponent() {
- *   const { component: RemoteComp, loading, error } = useRemoteModule({
- *     pkg: "@myorg/remote-app",
- *     version: "^1.0.0",
- *     moduleName: "Dashboard",
- *     scopeName: "myorg"
- *   });
- *
- *   if (loading) return <Spinner />;
- *   if (error) return <div>Error: {error.message}</div>;
- *   if (!RemoteComp) return null;
- *
- *   return <RemoteComp userId={123} />;
- * }
- * ```
- */
-export declare function useRemoteModuleHook(options: LazyRemoteOptions): {
-    component: ComponentType<any> | null;
-    loading: boolean;
-    error: Error | null;
-};

package/dist/components/index.d.ts

@@ -1,6 +0,0 @@
-export { ErrorBoundary } from './ErrorBoundary';
-export type { ErrorBoundaryProps } from './ErrorBoundary';
-export { RemoteModuleProvider, RemoteModuleRenderer, useRemoteModule, } from './RemoteModuleProvider';
-export type { RemoteModuleCardProps, UseRemoteModuleOptions, } from './RemoteModuleProvider';
-export { lazyRemote, SuspenseRemote, SuspenseRemoteLoader, withRemote, useRemoteModuleHook, } from './SuspenseLoader';
-export type { LazyRemoteOptions, SuspenseRemoteProps, SuspenseRemoteWithPropsProps, } from './SuspenseLoader';