@lvetechs/micro-app 1.0.0 → 1.0.2

package/dist/components/ErrorBoundary.d.ts

@@ -0,0 +1,52 @@
+import { Component, ReactNode, ReactElement } from 'react';
+
+/**
+ * 错误边界 Props
+ */
+export interface ErrorBoundaryProps {
+    /** 子应用名称 */
+    appName?: string;
+    /** 子组件 */
+    children: ReactElement;
+    /** 错误回调 */
+    onError?: (error: Error, appName?: string) => void;
+    /** 自定义错误 UI */
+    fallback?: ReactNode;
+    /** 重新加载回调 */
+    onRetry?: (appName?: string) => void;
+}
+/**
+ * 错误边界状态
+ */
+interface ErrorBoundaryState {
+    hasError: boolean;
+    error: Error | null;
+}
+/**
+ * 错误边界组件
+ *
+ * 使用示例：
+ * ```tsx
+ * import { ErrorBoundary } from '@lvetechs/micro-app'
+ *
+ * function App() {
+ *   return (
+ *     <ErrorBoundary
+ *       appName="子应用名称"
+ *       onError={(error) => console.error(error)}
+ *       fallback={<div>自定义错误 UI</div>}
+ *     >
+ *       <ChildComponent />
+ *     </ErrorBoundary>
+ *   )
+ * }
+ * ```
+ */
+export declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    constructor(props: ErrorBoundaryProps);
+    static getDerivedStateFromError(error: Error): ErrorBoundaryState;
+    componentDidCatch(error: Error, errorInfo: React.ErrorInfo): void;
+    handleRetry: () => void;
+    render(): string | number | true | import("react/jsx-runtime").JSX.Element | Iterable<ReactNode>;
+}
+export default ErrorBoundary;

package/dist/components/MicroApp.d.ts

@@ -0,0 +1,26 @@
+import { ReactNode } from 'react';
+import { SubAppConfig, MicroAppStatus } from '../types';
+
+/**
+ * MicroApp 组件 Props
+ */
+export interface MicroAppProps {
+    /** 子应用配置数组 */
+    apps: SubAppConfig[];
+    /** 当前激活的应用名称（只渲染一个应用） */
+    activeApp?: string;
+    /** 错误回调 */
+    onError?: (error: Error, appName?: string) => void;
+    /** 状态变化回调 */
+    onStatusChange?: (name: string, status: MicroAppStatus) => void;
+    /** 加载完成回调 */
+    onLoad?: (appName: string) => void;
+    /** 自定义加载中 UI */
+    loading?: ReactNode;
+    /** 自定义错误 UI (对所有子应用生效) */
+    errorFallback?: ReactNode;
+    /** 子组件（渲染在主应用中） */
+    children?: ReactNode;
+}
+export declare function MicroApp(props: MicroAppProps): import("react/jsx-runtime").JSX.Element;
+export default MicroApp;

package/dist/components/MicroAppErrorBoundary.d.ts

@@ -0,0 +1,21 @@
+import { ReactNode, ErrorInfo } from 'react';
+
+/** 对外暴露的 Props */
+export interface MicroAppErrorBoundaryProps {
+    /** 子应用名称，用于日志和状态上报 */
+    appName: string;
+    /** 子应用组件 */
+    children: ReactNode;
+    /** 错误回调（可选） */
+    onError?: (error: Error, errorInfo: ErrorInfo) => void;
+}
+/**
+ * 函数组件包裹 Class ErrorBoundary
+ *
+ * 核心机制：
+ * - 用 useState 维护一个 resetKey
+ * - 将 resetKey 作为 ErrorBoundaryInner 的 key
+ * - 点击"重试"时 resetKey + 1 → key 变化 → React 18 完整卸载旧组件树、挂载新组件树
+ * - 这是 React 18 中重置 Error Boundary 最干净的方式
+ */
+export default function MicroAppErrorBoundary({ appName, children, onError, }: MicroAppErrorBoundaryProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/MicroAppLoader.d.ts

@@ -0,0 +1,7 @@
+import { SubAppConfig } from '../types';
+
+interface MicroAppLoaderProps {
+    apps: SubAppConfig[];
+}
+export default function MicroAppLoader({ apps }: MicroAppLoaderProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/MicroAppMonitor.d.ts

@@ -0,0 +1,38 @@
+/**
+ * ============================================
+ * 微应用监控组件 (MicroAppMonitor.tsx)
+ * ============================================
+ *
+ * 这个组件负责监控子应用的"健康状态"，类似于医院的监护仪：
+ * 1. 启动应用（相当于"开机"）
+ * 2. 监控运行状态（相当于"心跳监测"）
+ * 3. 处理错误（相当于"报警"）
+ * 4. 支持重启（相当于"重新启动"）
+ * ```
+ */
+/**
+ * 组件的属性类型定义
+ *
+ * TypeScript 接口（interface）用于定义对象的"形状"
+ * 这样在使用组件时，编辑器会提供智能提示和类型检查
+ */
+interface MicroAppMonitorProps {
+    /** 应用名称，用于标识和日志 */
+    appName: string;
+    /** 应用路径，用于路由匹配 */
+    appPath: string;
+    /** 子组件，即要监控的子应用 */
+    children: React.ReactNode;
+    /** 状态变化时的回调函数（可选） */
+    onStatusChange?: (status: MicroAppStatus) => void;
+}
+/**
+ * 微应用监控组件
+ *
+ * @param appName - 应用名称
+ * @param appPath - 应用路径
+ * @param children - 子应用组件
+ * @param onStatusChange - 状态变化回调
+ */
+export default function MicroAppMonitor({ appName, appPath, children, onStatusChange, }: MicroAppMonitorProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/MicroAppStatusPanel.d.ts

@@ -0,0 +1,6 @@
+interface MicroAppStatusPanelProps {
+    appName: string;
+    showDetails?: boolean;
+}
+export default function MicroAppStatusPanel({ appName, showDetails, }: MicroAppStatusPanelProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/RemoteAppLoader.d.ts

@@ -0,0 +1,24 @@
+import { default as React } from 'react';
+
+export declare function useThrowError(): (error: Error | string) => void;
+export interface RemoteAppLoaderProps {
+    /** 远程应用 URL */
+    url: string;
+    /** 容器 ID（用于挂载） */
+    containerId: string;
+    /** 加载模式：iframe 或 dynamic（动态加载资源） */
+    mode?: 'iframe' | 'dynamic';
+    /** iframe 样式 */
+    iframeStyle?: React.CSSProperties;
+    /** 加载失败回调 */
+    onError?: (error: Error) => void;
+    /** 加载成功回调 */
+    onLoad?: () => void;
+}
+/**
+ * 远程应用加载器组件
+ *
+ * @param mode - 'iframe': 使用 iframe 加载（适合完整页面）
+ *              - 'dynamic': 动态加载 JS/CSS 资源（适合 UMD 模块）
+ */
+export default function RemoteAppLoader({ url, containerId, mode, iframeStyle, onError, onLoad, }: RemoteAppLoaderProps): import("react/jsx-runtime").JSX.Element;

package/dist/core/MicroAppManager.d.ts

@@ -0,0 +1,8 @@
+import { MicroAppService, MicroAppOptions } from '../types';
+
+/**
+ * 创建微前端服务（函数式实例化）
+ * @param options 配置选项
+ * @returns 微前端服务实例
+ */
+export declare function createMicroApp(options: MicroAppOptions): MicroAppService;

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * ============================================
+ * @lvetechs/micro-app 入口文件
+ * ============================================
+ *
+ * 轻量级微前端框架
+ * 支持函数式实例化和组件式实例化两种模式
+ */
+export type { MicroAppStatus, LoadMode, SubAppConfig, MicroAppInfo, MicroAppInstance, MicroAppOptions, MicroAppService, } from './types';
+export { createMicroApp } from './core/MicroAppManager';
+export { MicroApp } from './components/MicroApp';
+export type { MicroAppProps } from './components/MicroApp';
+export { ErrorBoundary } from './components/ErrorBoundary';
+export type { ErrorBoundaryProps } from './components/ErrorBoundary';
+export declare const version = "1.0.0";