@bm-fe/react-native-multi-bundle 1.0.0-beta.0

package/scripts/release-codepush.js

@@ -0,0 +1,420 @@
+#!/usr/bin/env node
+
+/**
+ * CodePush 发布脚本
+ * 将打包产物上传到 CodePush 服务器
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+const OUTPUT_DIR = path.join(__dirname, '../build/bundles');
+const PROJECT_ROOT = path.join(__dirname, '..');
+
+/**
+ * ANSI 颜色工具函数
+ */
+const colors = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  dim: '\x1b[2m',
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  magenta: '\x1b[35m',
+  cyan: '\x1b[36m',
+  gray: '\x1b[90m',
+};
+
+function green(text) {
+  return `${colors.green}${text}${colors.reset}`;
+}
+
+function yellow(text) {
+  return `${colors.yellow}${text}${colors.reset}`;
+}
+
+function blue(text) {
+  return `${colors.blue}${text}${colors.reset}`;
+}
+
+function red(text) {
+  return `${colors.red}${text}${colors.reset}`;
+}
+
+function cyan(text) {
+  return `${colors.cyan}${text}${colors.reset}`;
+}
+
+function gray(text) {
+  return `${colors.gray}${text}${colors.reset}`;
+}
+
+function bold(text) {
+  return `${colors.bright}${text}${colors.reset}`;
+}
+
+/**
+ * 格式化文件大小
+ */
+function formatSize(bytes) {
+  if (bytes < 1024) {
+    return `${bytes} B`;
+  } else if (bytes < 1024 * 1024) {
+    return `${(bytes / 1024).toFixed(2)} KB`;
+  } else {
+    return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;
+  }
+}
+
+/**
+ * 格式化文件路径（相对项目根目录）
+ */
+function formatPath(filePath) {
+  return path.relative(PROJECT_ROOT, filePath).replace(/\\/g, '/');
+}
+
+/**
+ * 解析命令行参数，支持从环境变量读取
+ */
+function parseArgs() {
+  const args = process.argv.slice(2);
+  const params = {
+    app: null,
+    deployment: null,
+    platform: null,
+    version: null,
+    description: '',
+    mandatory: false,
+    rollout: 100,
+    isDisabled: false,
+  };
+
+  // 先解析命令行参数
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg.startsWith('--')) {
+      const key = arg.slice(2);
+      const value = args[i + 1];
+      
+      if (key === 'mandatory') {
+        params.mandatory = value === 'true' || value === '1';
+        i++;
+      } else if (key === 'isDisabled') {
+        params.isDisabled = value === 'true' || value === '1';
+        i++;
+      } else if (key === 'rollout') {
+        params.rollout = parseInt(value, 10);
+        i++;
+      } else if (key in params) {
+        params[key] = value;
+        i++;
+      }
+    }
+  }
+
+  // 如果命令行参数缺失，从环境变量读取
+  // 环境变量命名：CODE_PUSH_<PARAM_NAME>
+  // 命令行参数优先级高于环境变量
+  if (!params.app && process.env.CODE_PUSH_APP) {
+    params.app = process.env.CODE_PUSH_APP;
+  }
+  if (!params.deployment && process.env.CODE_PUSH_DEPLOYMENT) {
+    params.deployment = process.env.CODE_PUSH_DEPLOYMENT;
+  }
+  if (!params.platform && process.env.CODE_PUSH_PLATFORM) {
+    params.platform = process.env.CODE_PUSH_PLATFORM;
+  }
+  if (!params.version && process.env.CODE_PUSH_VERSION) {
+    params.version = process.env.CODE_PUSH_VERSION;
+  }
+  // description 如果命令行没有提供且环境变量存在，则使用环境变量
+  if (params.description === '' && process.env.CODE_PUSH_DESCRIPTION) {
+    params.description = process.env.CODE_PUSH_DESCRIPTION;
+  }
+  // mandatory 如果命令行没有提供且环境变量存在，则使用环境变量
+  if (!args.includes('--mandatory') && process.env.CODE_PUSH_MANDATORY) {
+    params.mandatory = process.env.CODE_PUSH_MANDATORY === 'true' || process.env.CODE_PUSH_MANDATORY === '1';
+  }
+  // rollout 如果命令行没有提供且环境变量存在，则使用环境变量
+  if (!args.includes('--rollout') && process.env.CODE_PUSH_ROLLOUT) {
+    const rollout = parseInt(process.env.CODE_PUSH_ROLLOUT, 10);
+    if (!isNaN(rollout) && rollout >= 1 && rollout <= 100) {
+      params.rollout = rollout;
+    }
+  }
+  // isDisabled 如果命令行没有提供且环境变量存在，则使用环境变量
+  if (!args.includes('--isDisabled') && process.env.CODE_PUSH_IS_DISABLED) {
+    params.isDisabled = process.env.CODE_PUSH_IS_DISABLED === 'true' || process.env.CODE_PUSH_IS_DISABLED === '1';
+  }
+
+  return params;
+}
+
+/**
+ * 验证必需参数和环境变量
+ */
+function validateParams(params) {
+  const errors = [];
+
+  if (!params.app) {
+    errors.push('--app 参数是必需的');
+  }
+  if (!params.deployment) {
+    errors.push('--deployment 参数是必需的');
+  }
+  if (!params.platform) {
+    errors.push('--platform 参数是必需的');
+  }
+  if (!['ios', 'android'].includes(params.platform)) {
+    errors.push('--platform 必须是 ios 或 android');
+  }
+  if (!params.version) {
+    errors.push('--version 参数是必需的');
+  }
+
+  if (!process.env.CODE_PUSH_SERVER_URL) {
+    errors.push('环境变量 CODE_PUSH_SERVER_URL 是必需的');
+  }
+  if (!process.env.ACCESS_KEY) {
+    errors.push('环境变量 ACCESS_KEY 是必需的');
+  }
+
+  if (params.rollout < 1 || params.rollout > 100) {
+    errors.push('--rollout 必须在 1-100 之间');
+  }
+
+  if (errors.length > 0) {
+    console.error(`\n${red('✗')} ${red(bold('参数验证失败'))}`);
+    errors.forEach(error => {
+      console.error(`  ${red(error)}`);
+    });
+    console.error('');
+    process.exit(1);
+  }
+}
+
+/**
+ * 检查打包产物目录是否存在
+ */
+function validateBuildOutput(platform) {
+  const platformDir = path.join(OUTPUT_DIR, platform);
+  
+  if (!fs.existsSync(platformDir)) {
+    console.error(`\n${red('✗')} ${red(bold('打包产物目录不存在'))}`);
+    console.error(`  ${gray('路径:')} ${formatPath(platformDir)}`);
+    console.error(`  ${yellow('提示:')} 请先运行 ${cyan('npm run bundle:' + platform)} 进行打包\n`);
+    process.exit(1);
+  }
+
+  const manifestPath = path.join(platformDir, 'bundle-manifest.json');
+  if (!fs.existsSync(manifestPath)) {
+    console.error(`\n${red('✗')} ${red(bold('bundle-manifest.json 不存在'))}`);
+    console.error(`  ${gray('路径:')} ${formatPath(manifestPath)}\n`);
+    process.exit(1);
+  }
+
+  return platformDir;
+}
+
+/**
+ * 创建 zip 包
+ */
+function createZipPackage(platformDir, platform, version) {
+  const timestamp = Date.now();
+  const zipFileName = `${platform}-${version}-${timestamp}.zip`;
+  const zipPath = path.join(OUTPUT_DIR, zipFileName);
+
+  console.log(`${bold('📦')} ${bold('创建 zip 包')}...`);
+  console.log(`  ${gray('源目录:')} ${formatPath(platformDir)}`);
+  console.log(`  ${gray('输出文件:')} ${formatPath(zipPath)}`);
+
+  try {
+    // 使用系统 zip 命令创建压缩包
+    // 进入平台目录内部，压缩所有内容（不包含平台目录本身）
+    // 使用 -j 选项可以忽略目录结构，但我们需要保留 modules/ 目录结构
+    // 所以使用 cd 进入目录，然后压缩当前目录的所有内容
+    execSync(
+      `cd "${platformDir}" && zip -r "${zipPath}" .`,
+      { stdio: 'inherit' }
+    );
+
+    if (!fs.existsSync(zipPath)) {
+      throw new Error('Zip 文件创建失败');
+    }
+
+    const stats = fs.statSync(zipPath);
+    console.log(`  ${green('✓')} ${bold('创建成功')} ${gray(`(${formatSize(stats.size)})`)}\n`);
+
+    return zipPath;
+  } catch (error) {
+    console.error(`\n${red('✗')} ${red(bold('创建 zip 包失败'))}`);
+    console.error(`  ${red(error.message)}\n`);
+    process.exit(1);
+  }
+}
+
+/**
+ * 生成 packageInfo JSON
+ */
+function generatePackageInfo(params, platformDir) {
+  const manifestPath = path.join(platformDir, 'bundle-manifest.json');
+  let manifest = {};
+  
+  try {
+    manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
+  } catch (error) {
+    console.warn(`${yellow('⚠')} ${yellow('无法读取 manifest，使用默认值')}`);
+  }
+
+  const packageInfo = {
+    appVersion: params.version,
+    description: params.description || '',
+    mandatory: params.mandatory,
+    rollout: params.rollout,
+    isDisabled: params.isDisabled,
+  };
+
+  return JSON.stringify(packageInfo);
+}
+
+/**
+ * 上传到 CodePush 服务器
+ */
+async function uploadToCodePush(zipPath, packageInfo, params) {
+  const serverUrl = process.env.CODE_PUSH_SERVER_URL;
+  const accessKey = process.env.ACCESS_KEY;
+  const apiUrl = `${serverUrl}/api/apps/${params.app}/deployments/${params.deployment}/release`;
+
+  console.log(`${bold('🚀')} ${bold('上传到 CodePush 服务器')}...`);
+  console.log(`  ${gray('服务器:')} ${cyan(serverUrl)}`);
+  console.log(`  ${gray('应用:')} ${cyan(params.app)}`);
+  console.log(`  ${gray('部署环境:')} ${cyan(params.deployment)}`);
+  console.log(`  ${gray('平台:')} ${cyan(params.platform)}`);
+  console.log(`  ${gray('版本:')} ${cyan(params.version)}\n`);
+
+  try {
+    // 读取 zip 文件
+    const zipBuffer = fs.readFileSync(zipPath);
+    const zipFileName = path.basename(zipPath);
+    
+    // 创建 FormData（使用 Node.js 18+ 内置的 FormData）
+    const formData = new FormData();
+    
+    // 添加 zip 文件（使用 Blob）
+    const zipBlob = new Blob([zipBuffer], { type: 'application/zip' });
+    formData.append('package', zipBlob, zipFileName);
+    
+    // 添加 packageInfo
+    formData.append('packageInfo', packageInfo);
+
+    // 使用 fetch 上传
+    const response = await fetch(apiUrl, {
+      method: 'POST',
+      headers: {
+        'Authorization': `Bearer ${accessKey}`,
+        // 不要手动设置 Content-Type，让 fetch 自动设置 multipart/form-data boundary
+      },
+      body: formData,
+    });
+
+    // 解析响应
+    const responseText = await response.text();
+    let releaseInfo = {};
+
+    if (response.ok) {
+      // 成功
+      try {
+        releaseInfo = JSON.parse(responseText);
+      } catch (e) {
+        // 如果响应不是 JSON，直接显示原始响应
+        releaseInfo = { response: responseText };
+      }
+
+      console.log(`${green('✓')} ${green(bold('上传成功'))}\n`);
+      console.log(bold('Release 信息:'));
+      console.log(gray('─'.repeat(60)));
+      
+      if (releaseInfo.label) {
+        console.log(`  ${bold('Label:')} ${cyan(releaseInfo.label)}`);
+      }
+      if (releaseInfo.packageHash) {
+        console.log(`  ${bold('Package Hash:')} ${cyan(releaseInfo.packageHash)}`);
+      }
+      if (releaseInfo.appVersion) {
+        console.log(`  ${bold('App Version:')} ${cyan(releaseInfo.appVersion)}`);
+      }
+      if (releaseInfo.description) {
+        console.log(`  ${bold('Description:')} ${cyan(releaseInfo.description)}`);
+      }
+      if (releaseInfo.mandatory !== undefined) {
+        console.log(`  ${bold('Mandatory:')} ${cyan(releaseInfo.mandatory ? 'Yes' : 'No')}`);
+      }
+      if (releaseInfo.rollout !== undefined) {
+        console.log(`  ${bold('Rollout:')} ${cyan(`${releaseInfo.rollout}%`)}`);
+      }
+      
+      console.log(gray('─'.repeat(60)) + '\n');
+
+      return releaseInfo;
+    } else {
+      // 错误
+      throw new Error(`HTTP ${response.status}: ${responseText}`);
+    }
+  } catch (error) {
+    console.error(`\n${red('✗')} ${red(bold('上传失败'))}`);
+    
+    if (error.response) {
+      console.error(`  ${red(`HTTP ${error.response.status}`)}`);
+    }
+    
+    if (error.message) {
+      console.error(`  ${red(error.message)}`);
+    }
+    
+    console.error('');
+    process.exit(1);
+  }
+}
+
+/**
+ * 主函数
+ */
+async function main() {
+  console.log('\n' + bold('📤 CodePush Release'));
+  console.log(gray('─'.repeat(60)) + '\n');
+
+  // 解析参数
+  const params = parseArgs();
+  
+  // 验证参数
+  validateParams(params);
+  
+  // 验证打包产物
+  const platformDir = validateBuildOutput(params.platform);
+  
+  // 创建 zip 包
+  const zipPath = createZipPackage(platformDir, params.platform, params.version);
+  
+  // 生成 packageInfo
+  const packageInfo = generatePackageInfo(params, platformDir);
+  
+  // 上传到 CodePush
+  await uploadToCodePush(zipPath, packageInfo, params);
+  
+  console.log(green(bold('✅ 发布完成！')) + '\n');
+}
+
+if (require.main === module) {
+  main().catch((error) => {
+    console.error(`\n${red('✗')} ${red(bold('执行失败'))}`);
+    console.error(`  ${red(error.message)}`);
+    console.error('');
+    process.exit(1);
+  });
+}
+
+module.exports = { main };
+

package/scripts/sync-bundles-to-assets.js

@@ -0,0 +1,252 @@
+#!/usr/bin/env node
+
+/**
+ * 同步 Bundle 到 Assets 目录脚本
+ * 将构建好的 bundle 文件同步到 Android/iOS 的 assets 目录
+ * 
+ * Android: android/app/src/main/assets/bundles/
+ * iOS: ios/DemoProject/RNModules/Bundles/
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const PROJECT_ROOT = path.join(__dirname, '..');
+const BUILD_DIR = path.join(PROJECT_ROOT, 'build/bundles');
+const ANDROID_ASSETS_DIR = path.join(PROJECT_ROOT, 'android/app/src/main/assets');
+const IOS_ASSETS_DIR = path.join(PROJECT_ROOT, 'ios/DemoProject/RNModules/Bundles');
+
+/**
+ * ANSI 颜色工具函数
+ */
+const colors = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  cyan: '\x1b[36m',
+  gray: '\x1b[90m',
+};
+
+function green(text) {
+  return `${colors.green}${text}${colors.reset}`;
+}
+
+function yellow(text) {
+  return `${colors.yellow}${text}${colors.reset}`;
+}
+
+function blue(text) {
+  return `${colors.blue}${text}${colors.reset}`;
+}
+
+function red(text) {
+  return `${colors.red}${text}${colors.reset}`;
+}
+
+function cyan(text) {
+  return `${colors.cyan}${text}${colors.reset}`;
+}
+
+function gray(text) {
+  return `${colors.gray}${text}${colors.reset}`;
+}
+
+function bold(text) {
+  return `${colors.bright}${text}${colors.reset}`;
+}
+
+/**
+ * 格式化文件路径（相对项目根目录）
+ */
+function formatPath(filePath) {
+  return path.relative(PROJECT_ROOT, filePath).replace(/\\/g, '/');
+}
+
+/**
+ * 格式化文件大小
+ */
+function formatSize(bytes) {
+  if (bytes < 1024) {
+    return `${bytes} B`;
+  } else if (bytes < 1024 * 1024) {
+    return `${(bytes / 1024).toFixed(2)} KB`;
+  } else {
+    return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;
+  }
+}
+
+/**
+ * 复制文件
+ */
+function copyFile(src, dest) {
+  // 确保目标目录存在
+  const destDir = path.dirname(dest);
+  if (!fs.existsSync(destDir)) {
+    fs.mkdirSync(destDir, { recursive: true });
+  }
+  
+  // 复制文件
+  fs.copyFileSync(src, dest);
+  
+  const stats = fs.statSync(dest);
+  return stats.size;
+}
+
+/**
+ * 同步单个平台的 bundle
+ */
+function syncPlatformBundles(platform, sourceDir, targetDir) {
+  console.log(`\n${bold('Syncing')} ${cyan(platform)} ${gray('bundles...')}\n`);
+  
+  if (!fs.existsSync(sourceDir)) {
+    console.error(`  ${red('✗')} Source directory not found: ${formatPath(sourceDir)}`);
+    console.error(`  ${gray('Please run')} ${cyan(`npm run bundle:${platform}`)} ${gray('first')}\n`);
+    return { success: false, syncedFiles: [], failedFiles: [] };
+  }
+  
+  // 读取 manifest
+  const manifestPath = path.join(sourceDir, 'bundle-manifest.json');
+  if (!fs.existsSync(manifestPath)) {
+    console.error(`  ${red('✗')} Manifest not found: ${formatPath(manifestPath)}`);
+    return { success: false, syncedFiles: [], failedFiles: [] };
+  }
+  
+  const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
+  const syncedFiles = [];
+  const failedFiles = [];
+  let totalSize = 0;
+  
+  // 确保目标目录存在
+  if (!fs.existsSync(targetDir)) {
+    fs.mkdirSync(targetDir, { recursive: true });
+  }
+  
+  // 1. 复制 manifest
+  try {
+    const destManifest = path.join(targetDir, 'bundle-manifest.json');
+    const size = copyFile(manifestPath, destManifest);
+    syncedFiles.push('bundle-manifest.json');
+    totalSize += size;
+    console.log(`  ${green('✓')} ${bold('bundle-manifest.json')} ${gray(`(${formatSize(size)})`)}`);
+  } catch (error) {
+    failedFiles.push('bundle-manifest.json');
+    console.error(`  ${red('✗')} Failed to copy manifest: ${error.message}`);
+  }
+  
+  // 2. 复制主 bundle
+  try {
+    const mainSource = path.join(sourceDir, manifest.main.file);
+    const mainDest = path.join(targetDir, manifest.main.file);
+    const size = copyFile(mainSource, mainDest);
+    syncedFiles.push(manifest.main.file);
+    totalSize += size;
+    console.log(`  ${green('✓')} ${bold(manifest.main.file)} ${gray(`(${formatSize(size)})`)}`);
+  } catch (error) {
+    failedFiles.push(manifest.main.file);
+    console.error(`  ${red('✗')} Failed to copy main bundle: ${error.message}`);
+  }
+  
+  // 3. 复制模块 bundle
+  for (const module of manifest.modules) {
+    try {
+      const moduleSource = path.join(sourceDir, module.file);
+      const moduleDest = path.join(targetDir, module.file);
+      
+      // 确保模块目录存在
+      const moduleDir = path.dirname(moduleDest);
+      if (!fs.existsSync(moduleDir)) {
+        fs.mkdirSync(moduleDir, { recursive: true });
+      }
+      
+      const size = copyFile(moduleSource, moduleDest);
+      syncedFiles.push(module.file);
+      totalSize += size;
+      console.log(`  ${green('✓')} ${bold(module.file)} ${gray(`(${formatSize(size)})`)}`);
+    } catch (error) {
+      failedFiles.push(module.file);
+      console.error(`  ${red('✗')} Failed to copy ${module.file}: ${error.message}`);
+    }
+  }
+  
+  // 显示摘要
+  console.log(`\n  ${bold('Summary:')}`);
+  console.log(`    ${gray('Synced:')} ${green(syncedFiles.length)} files ${gray(`(${formatSize(totalSize)})`)}`);
+  if (failedFiles.length > 0) {
+    console.log(`    ${gray('Failed:')} ${red(failedFiles.length)} files`);
+  }
+  console.log(`    ${gray('Target:')} ${cyan(formatPath(targetDir))}\n`);
+  
+  return {
+    success: failedFiles.length === 0,
+    syncedFiles,
+    failedFiles,
+    totalSize,
+  };
+}
+
+/**
+ * 主函数
+ */
+function main() {
+  const args = process.argv.slice(2);
+  const platform = args[0]; // 'android', 'ios', 或 'all'
+  
+  console.log('\n' + bold('📦 Syncing Bundles to Assets'));
+  console.log(gray('─'.repeat(60)) + '\n');
+  
+  if (!platform || !['android', 'ios', 'all'].includes(platform)) {
+    console.error(`  ${red('✗')} ${red(bold('Invalid platform'))}`);
+    console.error(`  ${gray('Use:')} ${cyan('android')}, ${cyan('ios')}, ${cyan('or')} ${cyan('all')}\n`);
+    process.exit(1);
+  }
+  
+  const results = [];
+  
+  if (platform === 'android' || platform === 'all') {
+    const androidSource = path.join(BUILD_DIR, 'android');
+    const result = syncPlatformBundles('Android', androidSource, ANDROID_ASSETS_DIR);
+    results.push({ platform: 'android', ...result });
+  }
+  
+  if (platform === 'ios' || platform === 'all') {
+    const iosSource = path.join(BUILD_DIR, 'ios');
+    const result = syncPlatformBundles('iOS', iosSource, IOS_ASSETS_DIR);
+    results.push({ platform: 'ios', ...result });
+  }
+  
+  // 显示最终摘要
+  console.log(bold('Final Summary'));
+  console.log(gray('─'.repeat(60)));
+  
+  let totalSynced = 0;
+  let totalFailed = 0;
+  let totalSize = 0;
+  
+  for (const result of results) {
+    const status = result.success ? green('✓') : red('✗');
+    console.log(`  ${status} ${bold(result.platform)}: ${green(result.syncedFiles.length)} synced, ${result.failedFiles.length > 0 ? red(result.failedFiles.length) : gray('0')} failed`);
+    totalSynced += result.syncedFiles.length;
+    totalFailed += result.failedFiles.length;
+    totalSize += result.totalSize || 0;
+  }
+  
+  console.log(gray('─'.repeat(60)));
+  console.log(`  ${bold('Total:')} ${green(totalSynced)} files synced ${gray(`(${formatSize(totalSize)})`)}, ${totalFailed > 0 ? red(totalFailed) : gray('0')} failed\n`);
+  
+  if (totalFailed > 0) {
+    console.error(red(bold('⚠️  Some files failed to sync\n')));
+    process.exit(1);
+  } else {
+    console.log(green(bold('✅ Sync completed successfully!\n')));
+  }
+}
+
+if (require.main === module) {
+  main();
+}
+
+module.exports = { syncPlatformBundles };
+

package/src/index.ts

@@ -0,0 +1,40 @@
+/**
+ * React Native 多 Bundle 系统 - npm 包入口
+ * 导出所有公共 API
+ */
+
+// 核心初始化
+export { initMultiBundle, type InitResult } from './multi-bundle/init';
+
+// 配置相关
+export {
+  type MultiBundleConfig,
+  type DevServerConfig,
+  type ManifestProvider,
+  type ModuleLoader,
+  mergeConfig,
+  getGlobalConfig,
+  setGlobalConfig,
+} from './multi-bundle/config';
+
+// 模块加载器
+export { createModuleLoader, type CreateModuleLoaderOptions } from './multi-bundle/createModuleLoader';
+export { createModuleRouteLoader } from './multi-bundle/createModuleRouteLoader';
+
+// 模块预加载
+export { preloadModule } from './multi-bundle/preloadModule';
+
+// ModuleRegistry
+export { ModuleRegistry, type BundleManifest } from './multi-bundle/ModuleRegistry';
+
+// LocalBundleManager
+export { LocalBundleManager } from './multi-bundle/LocalBundleManager';
+
+// 路由注册（可选，用于兼容旧代码）
+export { registerModuleRoute, getModuleRoute } from './multi-bundle/routeRegistry';
+
+// 类型定义
+export type {
+  ModuleState,
+  ModuleMeta,
+} from './multi-bundle/ModuleRegistry';