@gientech/modual 1.2.7 → 1.2.9-fix

package/scripts/README.md

@@ -0,0 +1,133 @@
+# XViewer 演示脚本使用说明
+
+## 概述
+
+这套脚本用于运行 XViewer 组件的演示示例，支持跨平台运行（Windows、macOS、Linux）。
+
+## 脚本文件
+
+- `demo-selector.js` - 示例选择器，扫描并选择要运行的示例
+- `dev-demo.js` - 开发模式演示
+- `build-demo.js` - 打包模式演示  
+- `preview-demo.js` - 预览模式演示
+- `run-demo.bat` - Windows 批处理文件（备用方案）
+
+## 使用方法
+
+### 方法一：使用 npm 脚本（推荐）
+
+```bash
+# 开发模式
+pnpm run dev:demo
+
+# 打包模式
+pnpm run build:demo
+
+# 预览模式
+pnpm run preview:demo
+```
+
+### 方法二：直接运行 Node.js 脚本
+
+```bash
+# 开发模式
+node scripts/dev-demo.js
+
+# 打包模式
+node scripts/build-demo.js
+
+# 预览模式
+node scripts/preview-demo.js
+```
+
+### 方法三：Windows 批处理文件
+
+```cmd
+# 开发模式
+scripts\run-demo.bat dev-demo
+
+# 打包模式
+scripts\run-demo.bat build-demo
+
+# 预览模式
+scripts\run-demo.bat preview-demo
+```
+
+## 示例文件格式
+
+脚本支持两种示例文件格式：
+
+1. **单文件模式**: `src/Example_XXXX.tsx`
+2. **文件夹模式**: 
+   - `src/examples/XXXX/index.tsx`
+   - `src/examples/XXXX/XXXX.tsx`
+
+## Windows 兼容性
+
+### 已解决的问题
+
+1. ✅ **依赖包缺失** - 已添加 `inquirer` 和 `fs-extra` 依赖
+2. ✅ **Shell 执行** - Windows 下使用 `shell: true` 选项
+3. ✅ **环境变量** - 自动设置 `NODE_OPTIONS` 环境变量
+4. ✅ **路径处理** - 使用 `path.join()` 确保跨平台兼容
+5. ✅ **调试信息** - 添加详细的调试输出
+
+### 调试信息
+
+脚本运行时会显示以下调试信息：
+- Node.js 版本
+- 操作系统类型
+- 当前工作目录
+- 脚本目录
+- Windows 模式标识
+
+## 故障排除
+
+### 问题 1：脚本执行没有反应
+
+**解决方案**：
+1. 确保已安装依赖：`pnpm install`
+2. 检查 Node.js 版本：`node --version`（需要 >= 22）
+3. 使用调试模式查看详细信息
+
+### 问题 2：Windows 下 pnpm 命令无法识别
+
+**解决方案**：
+1. 确保 pnpm 已全局安装：`npm install -g pnpm`
+2. 检查 PATH 环境变量
+3. 使用批处理文件：`scripts\run-demo.bat`
+
+### 问题 3：内存不足错误
+
+**解决方案**：
+1. 脚本已自动设置 `NODE_OPTIONS=--max-old-space-size=16384`
+2. 如需调整，修改脚本中的环境变量设置
+
+### 问题 4：示例文件扫描失败
+
+**解决方案**：
+1. 确保示例文件格式正确
+2. 检查文件路径和权限
+3. 查看调试信息中的路径信息
+
+## 开发说明
+
+### 添加新示例
+
+1. 在 `src/examples/` 下创建新文件夹
+2. 添加 `index.tsx` 或 `[文件夹名].tsx` 文件
+3. 脚本会自动扫描并显示
+
+### 修改脚本
+
+1. 所有脚本都支持跨平台运行
+2. 使用 `process.platform === 'win32'` 检测 Windows
+3. 使用 `path.join()` 处理路径
+4. 使用 `shell: isWindows` 设置 spawn 选项
+
+## 技术细节
+
+- **Node.js 版本要求**: >= 22
+- **依赖包**: inquirer, fs-extra
+- **支持平台**: Windows, macOS, Linux
+- **脚本类型**: ES Modules

package/scripts/build-demo.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+
+import { spawn } from 'child_process';
+import { main, restoreMainFile } from './demo-selector.js';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// 检测操作系统
+const isWindows = process.platform === 'win32';
+
+/**
+ * 执行打包
+ */
+function runBuild() {
+  console.log('\n🔨 正在执行打包...\n');
+  console.log('🔧 调试信息:');
+  console.log('  操作系统:', process.platform);
+  console.log('  Windows 模式:', isWindows);
+  console.log('  工作目录:', path.resolve(__dirname, '..'));
+  console.log('');
+
+  const buildProcess = spawn('pnpm', ['run', 'build:app'], {
+    stdio: 'inherit',
+    shell: isWindows, // Windows 下需要 shell: true
+    cwd: path.resolve(__dirname, '..'),
+    env: {
+      ...process.env,
+      NODE_OPTIONS: '--max-old-space-size=16384'
+    }
+  });
+
+  buildProcess.on('close', (code) => {
+    if (code === 0) {
+      console.log('\n✅ 打包完成！');
+      console.log('📁 输出目录: dist-app/');
+    } else {
+      console.error(`\n❌ 打包失败 (退出码: ${code})`);
+    }
+
+    // 恢复原始 main.tsx 文件
+    restoreMainFile();
+    process.exit(code);
+  });
+
+  buildProcess.on('error', (error) => {
+    console.error('❌ 执行打包失败:', error);
+    restoreMainFile();
+    process.exit(1);
+  });
+
+  // 处理进程退出信号
+  process.on('SIGINT', () => {
+    console.log('\n🔄 正在取消打包...');
+    buildProcess.kill('SIGINT');
+  });
+
+  process.on('SIGTERM', () => {
+    console.log('\n🔄 正在取消打包...');
+    buildProcess.kill('SIGTERM');
+  });
+}
+
+/**
+ * 主函数
+ */
+async function runBuildDemo() {
+  try {
+    // 先选择示例
+    await main();
+
+    // 执行打包
+    runBuild();
+  } catch (error) {
+    console.error('❌ 打包模式启动失败:', error);
+    restoreMainFile();
+    process.exit(1);
+  }
+}
+
+// 如果直接运行此脚本
+if (import.meta.url === `file://${process.argv[1]}`) {
+  runBuildDemo();
+}
+
+export { runBuildDemo };

package/scripts/demo-selector.js

@@ -0,0 +1,216 @@
+#!/usr/bin/env node
+
+import inquirer from 'inquirer';
+import fs from 'fs-extra';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// 检测操作系统
+const isWindows = process.platform === 'win32';
+
+// 调试信息
+console.log('🔧 调试信息:');
+console.log('  Node.js 版本:', process.version);
+console.log('  操作系统:', process.platform);
+console.log('  当前工作目录:', process.cwd());
+console.log('  脚本目录:', __dirname);
+console.log('  Windows 模式:', isWindows);
+console.log('');
+
+// 项目根目录
+const PROJECT_ROOT = path.resolve(__dirname, '..');
+const SRC_DIR = path.join(PROJECT_ROOT, 'src');
+const MAIN_TEMPLATE = path.join(PROJECT_ROOT, 'src/main.template.tsx');
+const MAIN_FILE = path.join(PROJECT_ROOT, 'src/main.tsx');
+
+/**
+ * 扫描示例文件
+ * 支持两种模式：
+ * 1. src/Example_XXXX.tsx (单文件模式)
+ * 2. src/examples/XXXX/XXXX.tsx 或 src/examples/XXXX/index.tsx (文件夹模式)
+ */
+function scanExampleFiles() {
+  const examples = [];
+
+  try {
+    // 扫描单文件模式: Example_XXXX.tsx
+    const files = fs.readdirSync(SRC_DIR);
+    files.forEach(file => {
+      if (file.startsWith('Example_') && file.endsWith('.tsx')) {
+        const name = file.replace('Example_', '').replace('.tsx', '');
+        examples.push({
+          name: `${name} (单文件)`,
+          value: file,
+          type: 'single',
+          path: path.join(SRC_DIR, file)
+        });
+      }
+    });
+
+    // 扫描文件夹模式: examples/XXXX/
+    const examplesDir = path.join(SRC_DIR, 'examples');
+    if (fs.existsSync(examplesDir)) {
+      const exampleDirs = fs.readdirSync(examplesDir);
+      exampleDirs.forEach(dir => {
+        const dirPath = path.join(examplesDir, dir);
+        if (fs.statSync(dirPath).isDirectory()) {
+          // 检查是否有 index.tsx 或 同名.tsx 文件
+          const indexFile = path.join(dirPath, 'index.tsx');
+          const namedFile = path.join(dirPath, `${dir}.tsx`);
+
+          if (fs.existsSync(indexFile)) {
+            examples.push({
+              name: `${dir} (文件夹 - index.tsx)`,
+              value: `examples/${dir}/index.tsx`,
+              type: 'folder',
+              path: indexFile
+            });
+          } else if (fs.existsSync(namedFile)) {
+            examples.push({
+              name: `${dir} (文件夹 - ${dir}.tsx)`,
+              value: `examples/${dir}/${dir}.tsx`,
+              type: 'folder',
+              path: namedFile
+            });
+          }
+        }
+      });
+    }
+  } catch (error) {
+    console.error('扫描示例文件时出错:', error);
+  }
+
+  return examples;
+}
+
+/**
+ * 生成临时的 main.tsx 文件
+ */
+function generateMainFile(selectedExample) {
+  // 统一去掉扩展名，确保导入路径无后缀
+  const normalizedImportPath = selectedExample.replace(/\.(t|j)sx?$/, '');
+
+  // 智能解析组件名称，且确保不包含扩展名或非法标识符字符
+  let componentName;
+  if (selectedExample.includes('examples/')) {
+    // 文件夹模式：使用文件夹名称作为组件名
+    const folderName = selectedExample.split('/')[1]; // 获取 examples/Form/ 中的 Form
+    componentName = folderName.charAt(0).toUpperCase() + folderName.slice(1); // 首字母大写
+  } else {
+    // 单文件模式：使用文件名作为组件名
+    componentName = path.basename(normalizedImportPath);
+  }
+  // 清理可能的无效字符并确保首字符为字母/下划线
+  componentName = componentName.replace(/\.(t|j)sx?$/i, '').replace(/[^\w$]/g, '');
+  if (!/^[A-Za-z_$]/.test(componentName)) {
+    componentName = '_' + componentName;
+  }
+
+  const mainContent = `import React from 'react';
+import ReactDOM from 'react-dom/client';
+import ${componentName} from './${normalizedImportPath}';
+
+ReactDOM.createRoot(document.getElementById('root')!).render(<${componentName} />);
+`;
+
+  try {
+    // 备份原始 main.tsx 文件
+    if (fs.existsSync(MAIN_FILE)) {
+      fs.copyFileSync(MAIN_FILE, MAIN_FILE + '.backup');
+    }
+
+    // 写入新的 main.tsx
+    fs.writeFileSync(MAIN_FILE, mainContent);
+    console.log(`✅ 已生成临时 main.tsx，导入示例: ${selectedExample}`);
+
+    return true;
+  } catch (error) {
+    console.error('生成 main.tsx 文件时出错:', error);
+    return false;
+  }
+}
+
+/**
+ * 恢复原始的 main.tsx 文件
+ */
+function restoreMainFile() {
+  try {
+    if (fs.existsSync(MAIN_FILE + '.backup')) {
+      fs.copyFileSync(MAIN_FILE + '.backup', MAIN_FILE);
+      fs.removeSync(MAIN_FILE + '.backup');
+      console.log('✅ 已恢复原始 main.tsx 文件');
+    }
+  } catch (error) {
+    console.error('恢复 main.tsx 文件时出错:', error);
+  }
+}
+
+/**
+ * 主函数
+ */
+async function main() {
+  console.log('🔍 正在扫描示例文件...\n');
+
+  const examples = scanExampleFiles();
+
+  if (examples.length === 0) {
+    console.log('❌ 未找到任何示例文件');
+    console.log('请确保有以下格式的文件：');
+    console.log('  - src/Example_XXXX.tsx');
+    console.log('  - src/examples/XXXX/XXXX.tsx');
+    console.log('  - src/examples/XXXX/index.tsx');
+    process.exit(1);
+  }
+
+  console.log(`📁 找到 ${examples.length} 个示例文件:\n`);
+
+  const { selectedExample } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'selectedExample',
+      message: '请选择要运行的示例:',
+      choices: examples,
+      pageSize: 10
+    }
+  ]);
+
+  console.log(`\n🎯 已选择: ${selectedExample}`);
+
+  // 生成临时 main.tsx
+  if (generateMainFile(selectedExample)) {
+    console.log('\n🚀 示例文件已准备就绪！');
+    console.log('现在可以运行以下命令：');
+    console.log('  - 开发模式: pnpm run dev:demo');
+    console.log('  - 打包模式: pnpm run build:demo');
+    console.log('\n💡 提示: 运行完成后会自动恢复原始 main.tsx 文件');
+  } else {
+    console.error('❌ 准备示例文件失败');
+    process.exit(1);
+  }
+}
+
+// 处理进程退出，确保恢复原始文件
+process.on('SIGINT', () => {
+  console.log('\n\n🔄 正在清理...');
+  restoreMainFile();
+  process.exit(0);
+});
+
+process.on('SIGTERM', () => {
+  console.log('\n\n🔄 正在清理...');
+  restoreMainFile();
+  process.exit(0);
+});
+
+// 如果直接运行此脚本
+if (import.meta.url === `file://${process.argv[1]}`) {
+  main().catch(error => {
+    console.error('❌ 脚本执行失败:', error);
+    process.exit(1);
+  });
+}
+
+export { main, generateMainFile, restoreMainFile, scanExampleFiles };

package/scripts/dev-demo.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+
+import { spawn } from 'child_process';
+import { main, restoreMainFile } from './demo-selector.js';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// 检测操作系统
+const isWindows = process.platform === 'win32';
+
+/**
+ * 启动开发服务器
+ */
+function startDevServer() {
+  console.log('\n🚀 正在启动开发服务器...\n');
+  console.log('🔧 调试信息:');
+  console.log('  操作系统:', process.platform);
+  console.log('  Windows 模式:', isWindows);
+  console.log('  工作目录:', path.resolve(__dirname, '..'));
+  console.log('');
+
+  const viteProcess = spawn('pnpm', ['run', 'dev'], {
+    stdio: 'inherit',
+    shell: isWindows, // Windows 下需要 shell: true
+    cwd: path.resolve(__dirname, '..'),
+  });
+
+  viteProcess.on('close', code => {
+    console.log(`\n🔄 开发服务器已关闭 (退出码: ${code})`);
+    restoreMainFile();
+  });
+
+  viteProcess.on('error', error => {
+    console.error('❌ 启动开发服务器失败:', error);
+    restoreMainFile();
+    process.exit(1);
+  });
+
+  // 处理进程退出信号
+  process.on('SIGINT', () => {
+    console.log('\n🔄 正在关闭开发服务器...');
+    viteProcess.kill('SIGINT');
+  });
+
+  process.on('SIGTERM', () => {
+    console.log('\n🔄 正在关闭开发服务器...');
+    viteProcess.kill('SIGTERM');
+  });
+}
+
+/**
+ * 主函数
+ */
+async function runDevDemo() {
+  try {
+    // 先选择示例
+    await main();
+
+    // 启动开发服务器
+    startDevServer();
+  } catch (error) {
+    console.error('❌ 开发模式启动失败:', error);
+    restoreMainFile();
+    process.exit(1);
+  }
+}
+
+// 如果直接运行此脚本
+//if (import.meta.url === `file://${process.argv[1]}`) {
+runDevDemo();
+//}
+
+export { runDevDemo };

package/scripts/preview-demo.js

@@ -0,0 +1,130 @@
+#!/usr/bin/env node
+
+import { spawn } from 'child_process';
+import { main, restoreMainFile } from './demo-selector.js';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// 检测操作系统
+const isWindows = process.platform === 'win32';
+
+/**
+ * 执行打包
+ */
+function runBuild() {
+  return new Promise((resolve, reject) => {
+    console.log('\n🔨 正在执行打包...\n');
+    console.log('🔧 调试信息:');
+    console.log('  操作系统:', process.platform);
+    console.log('  Windows 模式:', isWindows);
+    console.log('  工作目录:', path.resolve(__dirname, '..'));
+    console.log('');
+
+    const buildProcess = spawn('pnpm', ['run', 'build:app'], {
+      stdio: 'inherit',
+      shell: isWindows, // Windows 下需要 shell: true
+      cwd: path.resolve(__dirname, '..'),
+      env: {
+        ...process.env,
+        NODE_OPTIONS: '--max-old-space-size=16384'
+      }
+    });
+
+    buildProcess.on('close', (code) => {
+      if (code === 0) {
+        console.log('\n✅ 打包完成！');
+        console.log('📁 输出目录: dist-app/');
+        resolve();
+      } else {
+        console.error(`\n❌ 打包失败 (退出码: ${code})`);
+        reject(new Error(`打包失败，退出码: ${code}`));
+      }
+    });
+
+    buildProcess.on('error', (error) => {
+      console.error('❌ 执行打包失败:', error);
+      reject(error);
+    });
+
+    // 处理进程退出信号
+    process.on('SIGINT', () => {
+      console.log('\n🔄 正在取消打包...');
+      buildProcess.kill('SIGINT');
+    });
+
+    process.on('SIGTERM', () => {
+      console.log('\n🔄 正在取消打包...');
+      buildProcess.kill('SIGTERM');
+    });
+  });
+}
+
+/**
+ * 启动预览服务
+ */
+function startPreviewServer() {
+  console.log('\n🚀 正在启动预览服务器...\n');
+  console.log('🔧 调试信息:');
+  console.log('  操作系统:', process.platform);
+  console.log('  Windows 模式:', isWindows);
+  console.log('  工作目录:', path.resolve(__dirname, '..'));
+  console.log('');
+
+  const previewProcess = spawn('pnpm', ['run', 'preview:app'], {
+    stdio: 'inherit',
+    shell: isWindows, // Windows 下需要 shell: true
+    cwd: path.resolve(__dirname, '..')
+  });
+
+  previewProcess.on('close', (code) => {
+    console.log(`\n🔄 预览服务器已关闭 (退出码: ${code})`);
+    restoreMainFile();
+  });
+
+  previewProcess.on('error', (error) => {
+    console.error('❌ 启动预览服务器失败:', error);
+    restoreMainFile();
+    process.exit(1);
+  });
+
+  // 处理进程退出信号
+  process.on('SIGINT', () => {
+    console.log('\n🔄 正在关闭预览服务器...');
+    previewProcess.kill('SIGINT');
+  });
+
+  process.on('SIGTERM', () => {
+    console.log('\n🔄 正在关闭预览服务器...');
+    previewProcess.kill('SIGTERM');
+  });
+}
+
+/**
+ * 主函数
+ */
+async function runPreviewDemo() {
+  try {
+    // 先选择示例
+    await main();
+
+    // 执行打包
+    await runBuild();
+
+    // 启动预览服务
+    startPreviewServer();
+  } catch (error) {
+    console.error('❌ 预览模式启动失败:', error);
+    restoreMainFile();
+    process.exit(1);
+  }
+}
+
+// 如果直接运行此脚本
+if (import.meta.url === `file://${process.argv[1]}`) {
+  runPreviewDemo();
+}
+
+export { runPreviewDemo };

package/scripts/run-demo.bat

@@ -0,0 +1,34 @@
+@echo off
+REM Windows 批处理文件用于运行演示脚本
+REM 使用方法: run-demo.bat [dev-demo|build-demo|preview-demo]
+
+set NODE_OPTIONS=--max-old-space-size=16384
+
+if "%1"=="" (
+    echo 请指定要运行的脚本:
+    echo   run-demo.bat dev-demo
+    echo   run-demo.bat build-demo
+    echo   run-demo.bat preview-demo
+    exit /b 1
+)
+
+echo 🔧 调试信息:
+echo   Node.js 版本:
+node --version
+echo   操作系统: Windows
+echo   当前目录: %CD%
+echo   脚本参数: %1
+echo.
+
+node scripts\%1.js
+
+if %ERRORLEVEL% neq 0 (
+    echo.
+    echo ❌ 脚本执行失败，错误代码: %ERRORLEVEL%
+    pause
+    exit /b %ERRORLEVEL%
+)
+
+echo.
+echo ✅ 脚本执行完成
+pause