@snack-kit/scripts 0.7.0 → 0.8.0

package/README.md

@@ -10,15 +10,25 @@ npm install @snack-kit/scripts --save-dev
 
 ## 命令
 
-| 命令                     | 说明            |
-|------------------------|---------------|
-| `snack-cli init [dir]` | 初始化新 snack 工程 |
-| `snack-cli create`     | 在当前工程创建新模块模版  |
-| `snack-cli start`      | 启动开发调试服务      |
-| `snack-cli build`      | 生产模式打包        |
-| `snack-cli entry`      | 打包独立入口页面      |
+### snack-cli — 全局脚手架
 
-> `snack-scripts` 作为历史兼容别名保留，与 `snack-cli` 完全等价。
+全局安装后使用，用于初始化工程和创建模块。
+
+| 命令                     | 说明              |
+|------------------------|-----------------|
+| `snack-cli init [dir]` | 初始化新 snack 工程   |
+| `snack-cli create`     | 在当前工程创建新模块模版    |
+| `snack-cli -v`         | 查看当前版本号         |
+
+### snack-scripts — 项目构建
+
+安装到项目 `devDependencies` 后通过 `npm run` 调用，用于开发调试和生产打包。
+
+| 命令                    | 说明         |
+|-----------------------|------------|
+| `snack-scripts start` | 启动开发调试服务   |
+| `snack-scripts build` | 生产模式打包     |
+| `snack-scripts entry` | 打包独立入口页面   |
 
 ### init — 初始化工程
 
@@ -75,9 +85,12 @@ src/package/UserManager/
 ```json
 {
   "scripts": {
-    "start": "snack-cli start",
-    "build": "snack-cli build",
-    "entry": "snack-cli entry"
+    "start": "snack-scripts start",
+    "build": "snack-scripts build",
+    "entry": "snack-scripts entry"
+  },
+  "devDependencies": {
+    "@snack-kit/scripts": "^0.4.0"
   }
 }
 ```
@@ -170,6 +183,14 @@ module.exports = (config) => {
 
 ## Changelog
 
+### 0.8.0
+
+- 重构：`bin/main.js` 拆分为 `snack-cli`（init / create）和 `snack-scripts`（start / build / entry）两个独立命令
+- 新增：`snack-cli -v` 查看当前版本号
+- 新增：共享工具模块 `bin/lib.js`（语言检测、i18n 字符串、交互式提问工具）
+- 修复：`init` 生成项目的 `devDependencies` 新增 `@snack-kit/scripts`，本地安装后不再依赖全局版本
+- 修复：`init` 生成的 `scripts` 命令修正为 `snack-scripts`，与实际 bin 名一致
+
 ### 0.7.0
 
 - 修复: 修复 loader.js 打包丢失的问题

package/bin/lib.js

@@ -0,0 +1,91 @@
+'use strict';
+
+const readline = require('readline');
+
+// ─── 语言检测 ─────────────────────────────────────────────────────────────────
+
+function detectLang() {
+    const env = process.env.LANG || process.env.LANGUAGE || process.env.LC_ALL || process.env.LC_MESSAGES || '';
+    return env.toLowerCase().startsWith('zh') ? 'zh' : 'en';
+}
+
+const lang = detectLang();
+
+// ─── i18n 字符串表 ────────────────────────────────────────────────────────────
+
+const t = {
+    // init
+    initTitle:              { zh: '  Snack 项目初始化', en: '  Snack Project Init' },
+    projectName:            { zh: '项目名称', en: 'Project name' },
+    description:            { zh: '项目描述', en: 'Description' },
+    author:                 { zh: '作者', en: 'Author' },
+    debugServers:           { zh: '调试服务器（多个用逗号分隔）', en: 'Debug servers (comma separated)' },
+    entryPageId:            { zh: '入口页面 ID', en: 'Entry page id' },
+    entryPageType:          { zh: '入口页面类型', en: 'Entry page type' },
+    reactVersion:           { zh: 'React 版本', en: 'React version' },
+    projectCreated:         { zh: '  项目已创建：', en: '  Project created at:' },
+    nextSteps:              { zh: '  后续步骤：', en: '  Next steps:' },
+    // create
+    createTitle:            { zh: '  Snack 模块创建', en: '  Snack Module Create' },
+    moduleName:             { zh: '模块名称', en: 'Module name' },
+    moduleDirName:          { zh: '模块目录名（PascalCase）', en: 'Module directory name (PascalCase)' },
+    withSetting:            { zh: '生成配置模块？(y/n)', en: 'Generate setting module? (y/n)' },
+    moduleCreated:          { zh: '  模块已创建：', en: '  Module created:' },
+    filesGenerated:         { zh: '  已生成文件：', en: '  Files generated:' },
+    // errors
+    errNoPkg:               { zh: '错误：当前目录没有 package.json，请在 snack 工程根目录下执行该命令', en: 'Error: No package.json found. Run this command in a snack project root.' },
+    errDirRequired:         { zh: '错误：模块目录名不能为空', en: 'Error: Module directory name is required' },
+    errDirExists:           { zh: '错误：模块目录已存在：', en: 'Error: Module directory already exists:' },
+    errNameConflict:        { zh: '请修改 snack-cli package.json "name" 的默认名称，该名称将在部署时作为分类目录', en: 'Please change the default "name" in package.json. It will be used as a category directory during deployment.' },
+    errNoEntry:             { zh: 'package.json 未找到 snack.entry 配置项', en: 'snack.entry config not found in package.json' },
+    errTempDir:             { zh: '临时目录创建失败', en: 'Failed to create temp directory' },
+    errIntegrity:           { zh: '完整性校验失败', en: 'Integrity check failed' },
+    // build logs
+    clearOutputDir:         { zh: '清理输出目录', en: 'clear output dir' },
+    clearOutputDirEnd:      { zh: '清理完成', en: 'clear output dir end' },
+    devServerRunning:       { zh: 'Snack 开发服务器运行中...', en: 'Snack DevServer Runing...' },
+    createLoaderAndHTML:    { zh: '生成 loader.js 和入口 HTML（并行）...', en: 'create loader.js & entry HTML (parallel) ...' },
+    createLoaderAndHTMLEnd: { zh: '生成完成', en: 'create loader.js & entry HTML end' },
+    createSnack:            { zh: '生成 snack 模块...', en: 'create snack ...' },
+    createSnackEnd:         { zh: '生成完成', en: 'create snack end' },
+    createEntry:            { zh: '生成入口页...', en: 'create entry ...' },
+    integrityPass:          { zh: '完整性校验通过', en: 'Integrity check passed' },
+    integrityFileMissing:   { zh: '完整性校验：文件缺失', en: 'snack check: file is missing' },
+};
+
+function i(key) {
+    return t[key][lang];
+}
+
+// ─── 交互式提问工具 ───────────────────────────────────────────────────────────
+
+function prompt(rl, question, defaultValue) {
+    return new Promise(resolve => {
+        const hint = defaultValue !== undefined ? ` (${defaultValue})` : '';
+        rl.question(`${question}${hint}: `, answer => {
+            const val = answer.trim();
+            resolve(val === '' && defaultValue !== undefined ? defaultValue : val);
+        });
+    });
+}
+
+function select(rl, question, options, defaultValue) {
+    return new Promise(resolve => {
+        const hint = options.map((o, idx) => `${idx + 1}) ${o}`).join('  ');
+        const defaultHint = options.includes(defaultValue) ? defaultValue : options[0];
+        rl.question(`${question} [${hint}] (${defaultHint}): `, answer => {
+            const val = answer.trim();
+            if (val === '') return resolve(defaultHint);
+            const num = parseInt(val, 10);
+            if (!isNaN(num) && num >= 1 && num <= options.length) return resolve(options[num - 1]);
+            if (options.includes(val)) return resolve(val);
+            resolve(defaultHint);
+        });
+    });
+}
+
+function createRl() {
+    return readline.createInterface({ input: process.stdin, output: process.stdout });
+}
+
+module.exports = { lang, i, prompt, select, createRl };

package/bin/snack-cli.js

@@ -0,0 +1,280 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * snack-cli — 全局脚手架命令
+ *
+ * 命令：
+ *   snack-cli init [dir]   初始化新 snack 工程
+ *   snack-cli create       在当前工程创建新模块模版
+ */
+
+const path = require('path');
+const minimist = require('minimist');
+const fs = require('fs-extra');
+const { version } = require('../package.json');
+const { lang, i, prompt, select, createRl } = require('./lib');
+
+const args = process.argv.slice(2);
+const argv = minimist(args);
+const script = args[0];
+
+// ─── init 命令：初始化新 snack 工程 ──────────────────────────────────────────
+
+async function runInit() {
+    const targetDir = argv._[1] ? path.resolve(process.cwd(), argv._[1]) : process.cwd();
+    const dirName = path.basename(targetDir);
+
+    console.log(`\n${i('initTitle')}\n`);
+
+    const rl = createRl();
+
+    const name         = await prompt(rl, i('projectName'), dirName);
+    const description  = await prompt(rl, i('description'), '');
+    const author       = await prompt(rl, i('author'), '');
+    const debugInput   = await prompt(rl, i('debugServers'), 'http://127.0.0.1:3000');
+    const entryId      = await prompt(rl, i('entryPageId'), name);
+    const entryType    = await prompt(rl, i('entryPageType'), 'portal');
+    const reactVersion = await select(rl, i('reactVersion'), ['17', '18', '19'], '19');
+
+    rl.close();
+
+    const debugServers = debugInput.split(',').map(s => s.trim()).filter(Boolean);
+
+    const reactVersionMap = {
+        '17': { react: '^17.0.0', reactDom: '^17.0.0', typesReact: '^17.0.0', typesReactDom: '^17.0.0' },
+        '18': { react: '^18.0.0', reactDom: '^18.0.0', typesReact: '^18.0.0', typesReactDom: '^18.0.0' },
+        '19': { react: '^19.0.0', reactDom: '^19.0.0', typesReact: '^19.0.0', typesReactDom: '^19.0.0' },
+    };
+    const reactDeps = reactVersionMap[reactVersion];
+
+    // ── package.json ─────────────────────────────────────────────────────────
+    const pkg = {
+        name,
+        version: '1.0.0',
+        description,
+        scripts: {
+            start: 'snack-scripts start',
+            build: 'snack-scripts build',
+            entry: 'snack-scripts entry'
+        },
+        input: './src/package',
+        output: './dist',
+        snack: {
+            externals: {},
+            buildIgnore: [],
+            devPackage: [],
+            entry: {
+                name: 'entry',
+                id: entryId,
+                type: entryType,
+                title: '',
+                favicon: '',
+                mobile: { id: `${entryId}_mobile`, type: entryType }
+            }
+        },
+        author,
+        license: 'ISC',
+        dependencies: {
+            '@snack-kit/core': '^0.3.0',
+            'react': reactDeps.react,
+            'react-dom': reactDeps.reactDom
+        },
+        devDependencies: {
+            '@snack-kit/scripts': `^${version}`,
+            '@types/react': reactDeps.typesReact,
+            '@types/react-dom': reactDeps.typesReactDom
+        },
+        dev: { debug: debugServers }
+    };
+
+    // ── tsconfig.json ─────────────────────────────────────────────────────────
+    const tsconfig = {
+        compilerOptions: {
+            target: 'es5',
+            module: 'es6',
+            outDir: './dist/',
+            baseUrl: '.',
+            experimentalDecorators: true,
+            allowJs: true,
+            skipLibCheck: true,
+            esModuleInterop: true,
+            allowSyntheticDefaultImports: true,
+            strict: true,
+            forceConsistentCasingInFileNames: true,
+            moduleResolution: 'node',
+            resolveJsonModule: true,
+            isolatedModules: true,
+            jsx: 'react-jsx'
+        },
+        include: ['src'],
+        exclude: ['node_modules', 'dist']
+    };
+
+    // ── .gitignore ────────────────────────────────────────────────────────────
+    const gitignore = `node_modules
+dist
+.snack
+*.local
+.DS_Store
+`;
+
+    // ── src/env.d.ts ──────────────────────────────────────────────────────────
+    const envDts = `declare module '*.svg'
+declare module '*.png'
+declare module '*.jpg'
+declare module '*.jpeg'
+declare module '*.gif'
+declare module '*.bmp'
+`;
+
+    // ── 写入文件 ───────────────────────────────────────────────────────────────
+    await fs.ensureDir(targetDir);
+    await fs.outputJSON(path.join(targetDir, 'package.json'), pkg, { spaces: 4 });
+    await fs.outputJSON(path.join(targetDir, 'tsconfig.json'), tsconfig, { spaces: 4 });
+    await fs.outputFile(path.join(targetDir, '.gitignore'), gitignore);
+    await fs.ensureDir(path.join(targetDir, 'src/package'));
+    await fs.outputFile(path.join(targetDir, 'src/env.d.ts'), envDts);
+
+    console.log(`
+${i('projectCreated')} ${targetDir}
+
+${i('nextSteps')}
+    ${targetDir !== process.cwd() ? `cd ${argv._[1]}\n    ` : ''}npm install
+    npm run start
+`);
+}
+
+// ─── create 命令：在当前工程创建新模块模版 ────────────────────────────────────
+
+async function runCreate() {
+    const projectPath = argv.project || process.cwd();
+    const pkgPath = path.resolve(projectPath, 'package.json');
+    if (!fs.existsSync(pkgPath)) {
+        console.error(i('errNoPkg'));
+        process.exit(1);
+    }
+    const projectPkg = fs.readJSONSync(pkgPath);
+    const packageDir = path.resolve(projectPath, projectPkg.input || 'src/package');
+
+    console.log(`\n${i('createTitle')}\n`);
+
+    const rl = createRl();
+
+    const moduleName  = await prompt(rl, i('moduleName'), lang === 'zh' ? '新模块' : 'New Module');
+    let dirName       = await prompt(rl, i('moduleDirName'), '');
+    const description = await prompt(rl, i('description'), '');
+    const author      = await prompt(rl, i('author'), projectPkg.author || '');
+    const withSetting = (await prompt(rl, i('withSetting'), 'y')).toLowerCase() === 'y';
+
+    rl.close();
+
+    if (!dirName) {
+        console.error(i('errDirRequired'));
+        process.exit(1);
+    }
+
+    dirName = dirName.charAt(0).toUpperCase() + dirName.slice(1);
+    const moduleDir = path.join(packageDir, dirName);
+    const className = dirName;
+
+    if (fs.existsSync(moduleDir)) {
+        console.error(`${i('errDirExists')} ${moduleDir}`);
+        process.exit(1);
+    }
+
+    // ── snack.json ────────────────────────────────────────────────────────────
+    const snackJson = {
+        name: moduleName,
+        version: '0.0.0.1',
+        author,
+        description
+    };
+
+    // ── index.ts ──────────────────────────────────────────────────────────────
+    const indexTs = `export * from './src/index';
+${withSetting ? "export * from './src/setting';\n" : ''}`;
+
+    // ── src/index.tsx ─────────────────────────────────────────────────────────
+    const indexTsx = `import React from 'react';
+import { Snack, SnackData } from '@snack-kit/core';
+import './style/index.scss';
+
+interface Props extends SnackData {}
+
+export class ${className} extends Snack {
+    constructor(data: Props = {}) {
+        super(data);
+    }
+
+    public $component(props: Props): React.ReactNode {
+        return (
+            <div className={'${className.toLowerCase()}'}>
+                {/* TODO */}
+            </div>
+        );
+    }
+}
+
+export default ${className};
+`;
+
+    // ── src/setting.tsx ───────────────────────────────────────────────────────
+    const settingTsx = `import React from 'react';
+import { SnackSetting } from '@snack-kit/core';
+import Main from './index';
+import './style/setting.scss';
+
+interface Props {}
+
+export class ${className}Setting extends SnackSetting {
+    constructor(public main: Main, public data: Props) {
+        super(data);
+    }
+
+    public $component(): React.ReactNode {
+        return <></>;
+    }
+}
+`;
+
+    // ── 样式文件 ───────────────────────────────────────────────────────────────
+    const indexScss = `.${className.toLowerCase()} {\n}\n`;
+    const settingScss = `.${className.toLowerCase()}-setting {\n}\n`;
+
+    // ── 写入文件 ───────────────────────────────────────────────────────────────
+    await fs.outputJSON(path.join(moduleDir, 'snack.json'), snackJson, { spaces: 4 });
+    await fs.outputFile(path.join(moduleDir, 'index.ts'), indexTs);
+    await fs.outputFile(path.join(moduleDir, 'src/index.tsx'), indexTsx);
+    await fs.outputFile(path.join(moduleDir, 'src/style/index.scss'), indexScss);
+
+    if (withSetting) {
+        await fs.outputFile(path.join(moduleDir, 'src/setting.tsx'), settingTsx);
+        await fs.outputFile(path.join(moduleDir, 'src/style/setting.scss'), settingScss);
+    }
+
+    console.log(`
+${i('moduleCreated')} ${moduleDir}
+
+${i('filesGenerated')}
+    ${dirName}/snack.json
+    ${dirName}/index.ts
+    ${dirName}/src/index.tsx
+    ${dirName}/src/style/index.scss${withSetting ? `
+    ${dirName}/src/setting.tsx
+    ${dirName}/src/style/setting.scss` : ''}
+`);
+}
+
+// ─── 入口路由 ─────────────────────────────────────────────────────────────────
+
+if (script === 'init') {
+    runInit().catch(err => { console.error(err); process.exit(1); });
+} else if (script === 'create') {
+    runCreate().catch(err => { console.error(err); process.exit(1); });
+} else if (script === '-v' || script === '--version') {
+    console.log(version);
+} else {
+    console.error(`snack-cli: unknown command "${script || ''}"\nUsage: snack-cli <init|create|-v>`);
+    process.exit(1);
+}

package/bin/snack-scripts.js

@@ -0,0 +1,162 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * snack-scripts — 项目构建 / 调试命令
+ *
+ * 命令：
+ *   snack-scripts start   启动开发调试服务
+ *   snack-scripts build   生产模式打包
+ *   snack-scripts entry   打包独立入口页面
+ */
+
+const { spawn } = require('child_process');
+const path = require('path');
+const minimist = require('minimist');
+const fs = require('fs-extra');
+const { version } = require('../package.json');
+const { GetPackageList } = require('../utils/package');
+const { i } = require('./lib');
+
+const args = process.argv.slice(2);
+const argv = minimist(args, { default: { project: null } });
+const scriptIndex = args.findIndex(x => x === 'build' || x === 'start' || x === 'entry');
+const script = scriptIndex === -1 ? args[0] : args[scriptIndex];
+
+let projectPath = argv.project || process.cwd();
+let templatePath = argv.templatePath
+    ? path.resolve(projectPath, argv.templatePath)
+    : path.resolve(__dirname, '../template');
+
+const snackPath       = path.resolve(__dirname, '../config/webpack.snack.config.js');
+const indexHTMLPath   = path.resolve(__dirname, '../config/webpack.index.config.js');
+const loaderConfigPath = path.resolve(__dirname, '../config/webpack.loader.config.js');
+const devConfigPath   = path.resolve(__dirname, '../config/webpack.dev.config.js');
+const entryConfigPath = path.resolve(__dirname, '../config/webpack.entry.config.js');
+
+const platform = process.platform;
+const webpackFile = platform === 'win32' ? 'webpack.cmd' : 'webpack';
+const isNpm = fs.existsSync(path.resolve(process.cwd(), './node_modules/.bin/', webpackFile));
+
+// ─── webpack 构建命令 ─────────────────────────────────────────────────────────
+
+function execWebpack(wpArgs) {
+    return new Promise(resolve => {
+        const ps = isNpm
+            ? spawn('webpack', wpArgs, { stdio: 'inherit', shell: true })
+            : spawn(path.resolve(__dirname, '../node_modules/.bin/', webpackFile), wpArgs, { stdio: 'inherit' });
+        ps.on('error', e => { console.log(e); resolve(false); });
+        ps.on('exit', () => resolve(true));
+    });
+}
+
+function clearOutput(output) {
+    fs.removeSync(output);
+}
+
+async function check(output) {
+    try {
+        const list = await fs.readdir(output);
+        for (const dirname of list) {
+            if (dirname === '__common__') continue;
+            const snackjson = path.join(output, dirname, 'snack.json');
+            if (!await fs.exists(snackjson)) continue;
+            const index = path.join(output, dirname, 'index.js');
+            if (!await fs.exists(index)) {
+                console.error(`${i('integrityFileMissing')}: ${index}`);
+                return false;
+            }
+        }
+    } catch (err) {
+        console.error('snack check: ', err);
+        return false;
+    }
+    console.log(i('integrityPass'));
+    return true;
+}
+
+async function run() {
+    const projectPackageJSON = fs.readJSONSync(path.resolve(projectPath, 'package.json'));
+    if (projectPackageJSON.name === 'snack-cli') {
+        throw i('errNameConflict');
+    }
+
+    process.env.SNACK_CLI_VERSION = version;
+    process.env.RUN_SCRIPT = script;
+    process.env.SNACK_SCRIPTS_PATH = __dirname;
+    process.env.PROJECT_COMMON_NAME = '__common__';
+    process.env.PROJECT_PACKAGE_JSON = JSON.stringify(projectPackageJSON);
+    process.env.PROJECT_TYPE = projectPackageJSON.name;
+    process.env.PROJECT_PATH = projectPath;
+    process.env.PROJECT_PACKAGE_PATH = path.resolve(projectPath, projectPackageJSON.input || 'src/package');
+    process.env.PROJECT_TEMP_PATH = path.resolve(projectPath, '.snack');
+    process.env.PROJECT_TEMPLATE_PATH = path.join(process.env.PROJECT_TEMP_PATH, 'template');
+
+    await fs.remove(process.env.PROJECT_TEMPLATE_PATH);
+    const err = await fs.copy(templatePath, process.env.PROJECT_TEMPLATE_PATH);
+    if (err) {
+        console.error(i('errTempDir'));
+        throw err;
+    }
+
+    process.env.PROJECT_SNACK_CONFIG = JSON.stringify(projectPackageJSON.snack || {});
+
+    if (script === 'entry') {
+        if (!projectPackageJSON.snack?.entry) throw i('errNoEntry');
+        process.env.RUN_MODE = 'production';
+        process.env.PROJECT_OUT_PATH = path.resolve(projectPath, projectPackageJSON.snack.entry.name || 'entry');
+        console.log(i('createEntry'));
+        await execWebpack(['--mode=production', `--config=${entryConfigPath}`]);
+    } else {
+        if (script === 'start') {
+            process.env.RUN_MODE = 'development';
+            process.env.PROJECT_OUT_PATH = path.resolve(process.env.PROJECT_TEMP_PATH, 'temp');
+        } else {
+            process.env.RUN_MODE = 'production';
+            process.env.PROJECT_OUT_PATH = path.resolve(projectPath, projectPackageJSON.output || 'dist', projectPackageJSON.name);
+        }
+
+        process.env.PROJECT_PACKAGE_LIST = JSON.stringify(GetPackageList(process.env.PROJECT_PACKAGE_PATH));
+
+        console.log(`${i('clearOutputDir')} "${process.env.PROJECT_OUT_PATH}" ...`);
+        clearOutput(process.env.PROJECT_OUT_PATH);
+        console.log(i('clearOutputDirEnd'));
+
+        if (script === 'start') {
+            console.log(i('devServerRunning'));
+            await execWebpack(['serve', '--mode=development', `--config=${devConfigPath}`]);
+        } else {
+            console.log(i('createLoaderAndHTML'));
+            await Promise.all([
+                execWebpack(['--mode=production', `--config=${loaderConfigPath}`]),
+                execWebpack(['--mode=production', `--config=${indexHTMLPath}`])
+            ]);
+            console.log(i('createLoaderAndHTMLEnd'));
+            console.log(i('createSnack'));
+            await execWebpack(['--mode=production', `--config=${snackPath}`]);
+            console.log(i('createSnackEnd'));
+        }
+
+        if (process.env.RUN_MODE !== 'development' && !await check(process.env.PROJECT_OUT_PATH)) {
+            fs.removeSync(process.env.PROJECT_OUT_PATH);
+            throw i('errIntegrity');
+        }
+    }
+
+    console.log(`
+   _____                  __      ________    ____
+  / ___/____  ____ ______/ /__   / ____/ /   /  _/
+  \\__ \\/ __ \\/ __ \`/ ___/ //_/  / /   / /    / /
+ ___/ / / / / /_/ / /__/ ,<    / /___/ /____/ /
+/____/_/ /_/\\__,_/\\___/_/|_|   \\____/_____/___/  v.${version}
+    `);
+}
+
+// ─── 入口路由 ─────────────────────────────────────────────────────────────────
+
+if (script === 'start' || script === 'build' || script === 'entry') {
+    run().catch(err => { console.error(err); process.exit(1); });
+} else {
+    console.error(`snack-scripts: unknown command "${script || ''}"\nUsage: snack-scripts <start|build|entry>`);
+    process.exit(1);
+}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@snack-kit/scripts",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "snack-cli package scripts Powered by Para FED",
   "bin": {
-    "snack-scripts": "./bin/main.js",
-    "snack-cli": "./bin/main.js"
+    "snack-cli": "./bin/snack-cli.js",
+    "snack-scripts": "./bin/snack-scripts.js"
   },
   "files": [
     "bin",
@@ -16,8 +16,8 @@
     "tsconfig.json"
   ],
   "scripts": {
-    "dev:start": "node bin/main.js start --project=/Users/liujia/工作/snack3-test",
-    "dev:build": "node bin/main.js build --project=/Users/liujia/工作/snack3-test",
+    "dev:start": "node bin/snack-scripts.js start --project=/Users/liujia/工作/snack/code-editor",
+    "dev:build": "node bin/snack-scripts.js build --project=/Users/liujia/工作/snack3-test",
     "release": "npm publish --access public",
     "release:beta": "npm publish --tag=beta --access public",
     "reinstall": "rm -rf node_modules && npm i"

package/utils/package.js

@@ -62,6 +62,21 @@ module.exports.GetPackageList = (projectPath) => {
         const runtimeEntry = path.resolve(snackPath, 'src', 'index.tsx');
         if (!fs.existsSync(runtimeEntry)) throw new Error(`Package(${dirName}) entry "${runtimeEntry}" is missing`);
 
+        // 检测 dirName 是否作为具名导出存在于入口文件链中
+        const exportPattern = new RegExp(
+            `export\\s+class\\s+${dirName}\\b` +                    // export class Foo
+            `|export\\s*\\{[^}]*\\bas\\s+${dirName}\\b[^}]*\\}` +  // export { X as Foo }
+            `|export\\s*\\{[^}]*\\b${dirName}\\b[^}]*\\}`           // export { Foo }
+        );
+        const filesToCheck = [entry, runtimeEntry];
+        const hasExport = filesToCheck.some(f => exportPattern.test(fs.readFileSync(f, 'utf-8')));
+        if (!hasExport) {
+            throw new Error(
+                `Package(${dirName}) missing named export "${dirName}".\n` +
+                `  Expected: "export class ${dirName}" or "export { ... as ${dirName} }" in index.ts or src/index.tsx`
+            );
+        }
+
         acc.push({
             name: dirName.toLocaleLowerCase(),
             dirName,

package/bin/main.js

@@ -1,478 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-const { spawn } = require('child_process');
-const path = require('path');
-const readline = require('readline');
-const minimist = require('minimist');
-const fs = require('fs-extra');
-const { version } = require('../package.json');
-const { GetPackageList } = require(path.resolve(__dirname, '../utils/package'));
-
-const args = process.argv.slice(2);
-const argv = minimist(args, { default: { project: null } });
-const scriptIndex = args.findIndex(x => x === 'build' || x === 'start' || x === 'entry' || x === 'init' || x === 'create');
-const script = scriptIndex === -1 ? args[0] : args[scriptIndex];
-
-let projectPath = argv.project || process.cwd();
-let templatePath = argv.templatePath
-    ? path.resolve(projectPath, argv.templatePath)
-    : path.resolve(__dirname, '../template');
-
-const snackPath = path.resolve(__dirname, '../config/webpack.snack.config.js');
-const indexHTMLPath = path.resolve(__dirname, '../config/webpack.index.config.js');
-const loaderConfigPath = path.resolve(__dirname, '../config/webpack.loader.config.js');
-const devConfigPath = path.resolve(__dirname, '../config/webpack.dev.config.js');
-const entryConfigPath = path.resolve(__dirname, '../config/webpack.entry.config.js');
-
-const platform = process.platform;
-const webpackFile = platform === 'win32' ? 'webpack.cmd' : 'webpack';
-const isNpm = fs.existsSync(path.resolve(process.cwd(), './node_modules/.bin/', webpackFile));
-
-// ─── 语言检测 ─────────────────────────────────────────────────────────────────
-
-function detectLang() {
-    const env = process.env.LANG || process.env.LANGUAGE || process.env.LC_ALL || process.env.LC_MESSAGES || '';
-    return env.toLowerCase().startsWith('zh') ? 'zh' : 'en';
-}
-
-const lang = detectLang();
-const t = {
-    // init
-    initTitle:              { zh: '  Snack 项目初始化', en: '  Snack Project Init' },
-    projectName:            { zh: '项目名称', en: 'Project name' },
-    description:            { zh: '项目描述', en: 'Description' },
-    author:                 { zh: '作者', en: 'Author' },
-    debugServers:           { zh: '调试服务器（多个用逗号分隔）', en: 'Debug servers (comma separated)' },
-    entryPageId:            { zh: '入口页面 ID', en: 'Entry page id' },
-    entryPageType:          { zh: '入口页面类型', en: 'Entry page type' },
-    reactVersion:           { zh: 'React 版本', en: 'React version' },
-    projectCreated:         { zh: '  项目已创建：', en: '  Project created at:' },
-    nextSteps:              { zh: '  后续步骤：', en: '  Next steps:' },
-    // create
-    createTitle:            { zh: '  Snack 模块创建', en: '  Snack Module Create' },
-    moduleName:             { zh: '模块名称', en: 'Module name' },
-    moduleDirName:          { zh: '模块目录名（PascalCase）', en: 'Module directory name (PascalCase)' },
-    withSetting:            { zh: '生成配置模块？(y/n)', en: 'Generate setting module? (y/n)' },
-    moduleCreated:          { zh: '  模块已创建：', en: '  Module created:' },
-    filesGenerated:         { zh: '  已生成文件：', en: '  Files generated:' },
-    // errors
-    errNoPkg:               { zh: '错误：当前目录没有 package.json，请在 snack 工程根目录下执行该命令', en: 'Error: No package.json found. Run this command in a snack project root.' },
-    errDirRequired:         { zh: '错误：模块目录名不能为空', en: 'Error: Module directory name is required' },
-    errDirExists:           { zh: '错误：模块目录已存在：', en: 'Error: Module directory already exists:' },
-    errNameConflict:        { zh: '请修改 snack-cli package.json "name" 的默认名称，该名称将在部署时作为分类目录', en: 'Please change the default "name" in package.json. It will be used as a category directory during deployment.' },
-    errNoEntry:             { zh: 'package.json 未找到 snack.entry 配置项', en: 'snack.entry config not found in package.json' },
-    errTempDir:             { zh: '临时目录创建失败', en: 'Failed to create temp directory' },
-    errIntegrity:           { zh: '完整性校验失败', en: 'Integrity check failed' },
-    // build logs
-    clearOutputDir:         { zh: '清理输出目录', en: 'clear output dir' },
-    clearOutputDirEnd:      { zh: '清理完成', en: 'clear output dir end' },
-    devServerRunning:       { zh: 'Snack 开发服务器运行中...', en: 'Snack DevServer Runing...' },
-    createLoaderAndHTML:    { zh: '生成 loader.js 和入口 HTML（并行）...', en: 'create loader.js & entry HTML (parallel) ...' },
-    createLoaderAndHTMLEnd: { zh: '生成完成', en: 'create loader.js & entry HTML end' },
-    createSnack:            { zh: '生成 snack 模块...', en: 'create snack ...' },
-    createSnackEnd:         { zh: '生成完成', en: 'create snack end' },
-    createEntry:            { zh: '生成入口页...', en: 'create entry ...' },
-    integrityPass:          { zh: '完整性校验通过', en: 'Integrity check passed' },
-    integrityFileMissing:   { zh: '完整性校验：文件缺失', en: 'snack check: file is missing' },
-};
-
-function i(key) {
-    return t[key][lang];
-}
-
-// ─── 交互式提问工具 ───────────────────────────────────────────────────────────
-
-function prompt(rl, question, defaultValue) {
-    return new Promise(resolve => {
-        const hint = defaultValue !== undefined ? ` (${defaultValue})` : '';
-        rl.question(`${question}${hint}: `, answer => {
-            const val = answer.trim();
-            resolve(val === '' && defaultValue !== undefined ? defaultValue : val);
-        });
-    });
-}
-
-function select(rl, question, options, defaultValue) {
-    return new Promise(resolve => {
-        const hint = options.map((o, i) => `${i + 1}) ${o}`).join('  ');
-        const defaultHint = options.includes(defaultValue) ? defaultValue : options[0];
-        rl.question(`${question} [${hint}] (${defaultHint}): `, answer => {
-            const val = answer.trim();
-            if (val === '') return resolve(defaultHint);
-            const num = parseInt(val, 10);
-            if (!isNaN(num) && num >= 1 && num <= options.length) return resolve(options[num - 1]);
-            if (options.includes(val)) return resolve(val);
-            resolve(defaultHint);
-        });
-    });
-}
-
-// ─── init 命令：初始化新 snack 工程 ──────────────────────────────────────────
-
-async function runInit() {
-    const targetDir = argv._[1] ? path.resolve(process.cwd(), argv._[1]) : process.cwd();
-    const dirName = path.basename(targetDir);
-
-    console.log(`\n${i('initTitle')}\n`);
-
-    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-
-    const name         = await prompt(rl, i('projectName'), dirName);
-    const description  = await prompt(rl, i('description'), '');
-    const author       = await prompt(rl, i('author'), '');
-    const debugInput   = await prompt(rl, i('debugServers'), 'http://127.0.0.1:3000');
-    const entryId      = await prompt(rl, i('entryPageId'), name);
-    const entryType    = await prompt(rl, i('entryPageType'), 'portal');
-    const reactVersion = await select(rl, i('reactVersion'), ['17', '18', '19'], '19');
-
-    rl.close();
-
-    const debugServers = debugInput.split(',').map(s => s.trim()).filter(Boolean);
-
-    const reactVersionMap = {
-        '17': { react: '^17.0.0', reactDom: '^17.0.0', typesReact: '^17.0.0', typesReactDom: '^17.0.0' },
-        '18': { react: '^18.0.0', reactDom: '^18.0.0', typesReact: '^18.0.0', typesReactDom: '^18.0.0' },
-        '19': { react: '^19.0.0', reactDom: '^19.0.0', typesReact: '^19.0.0', typesReactDom: '^19.0.0' },
-    };
-    const reactDeps = reactVersionMap[reactVersion];
-
-    // ── package.json ─────────────────────────────────────────────────────────
-    const pkg = {
-        name,
-        version: '1.0.0',
-        description,
-        scripts: {
-            start: 'snack-cli start',
-            build: 'snack-cli build',
-            entry: 'snack-cli entry'
-        },
-        input: './src/package',
-        output: './dist',
-        snack: {
-            externals: {},
-            buildIgnore: [],
-            devPackage: [],
-            entry: {
-                name: 'entry',
-                id: entryId,
-                type: entryType,
-                title: '',
-                favicon: '',
-                mobile: { id: `${entryId}_mobile`, type: entryType }
-            }
-        },
-        author,
-        license: 'ISC',
-        dependencies: {
-            '@snack-kit/core': '^0.3.0',
-            'react': reactDeps.react,
-            'react-dom': reactDeps.reactDom
-        },
-        devDependencies: {
-            '@types/react': reactDeps.typesReact,
-            '@types/react-dom': reactDeps.typesReactDom
-        },
-        dev: { debug: debugServers }
-    };
-
-    // ── tsconfig.json ─────────────────────────────────────────────────────────
-    const tsconfig = {
-        compilerOptions: {
-            target: 'es5',
-            module: 'es6',
-            outDir: './dist/',
-            baseUrl: '.',
-            experimentalDecorators: true,
-            allowJs: true,
-            skipLibCheck: true,
-            esModuleInterop: true,
-            allowSyntheticDefaultImports: true,
-            strict: true,
-            forceConsistentCasingInFileNames: true,
-            moduleResolution: 'node',
-            resolveJsonModule: true,
-            isolatedModules: true,
-            jsx: 'react-jsx'
-        },
-        include: ['src'],
-        exclude: ['node_modules', 'dist']
-    };
-
-    // ── .gitignore ────────────────────────────────────────────────────────────
-    const gitignore = `node_modules
-dist
-.snack
-*.local
-.DS_Store
-`;
-
-    // ── src/env.d.ts ──────────────────────────────────────────────────────────
-    const envDts = `declare module '*.svg'
-declare module '*.png'
-declare module '*.jpg'
-declare module '*.jpeg'
-declare module '*.gif'
-declare module '*.bmp'
-`;
-
-    // ── 写入文件 ───────────────────────────────────────────────────────────────
-    await fs.ensureDir(targetDir);
-    await fs.outputJSON(path.join(targetDir, 'package.json'), pkg, { spaces: 4 });
-    await fs.outputJSON(path.join(targetDir, 'tsconfig.json'), tsconfig, { spaces: 4 });
-    await fs.outputFile(path.join(targetDir, '.gitignore'), gitignore);
-    await fs.ensureDir(path.join(targetDir, 'src/package'));
-    await fs.outputFile(path.join(targetDir, 'src/env.d.ts'), envDts);
-
-    console.log(`
-${i('projectCreated')} ${targetDir}
-
-${i('nextSteps')}
-    ${targetDir !== process.cwd() ? `cd ${argv._[1]}\n    ` : ''}npm install
-    npm run start
-`);
-}
-
-// ─── create 命令：在当前工程创建新模块模版 ────────────────────────────────────
-
-async function runCreate() {
-    const pkgPath = path.resolve(projectPath, 'package.json');
-    if (!fs.existsSync(pkgPath)) {
-        console.error(i('errNoPkg'));
-        process.exit(1);
-    }
-    const projectPkg = fs.readJSONSync(pkgPath);
-    const packageDir = path.resolve(projectPath, projectPkg.input || 'src/package');
-
-    console.log(`\n${i('createTitle')}\n`);
-
-    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-
-    const moduleName  = await prompt(rl, i('moduleName'), lang === 'zh' ? '新模块' : 'New Module');
-    let dirName       = await prompt(rl, i('moduleDirName'), '');
-    const description = await prompt(rl, i('description'), '');
-    const author      = await prompt(rl, i('author'), projectPkg.author || '');
-    const withSetting = (await prompt(rl, i('withSetting'), 'y')).toLowerCase() === 'y';
-
-    rl.close();
-
-    if (!dirName) {
-        console.error(i('errDirRequired'));
-        process.exit(1);
-    }
-
-    dirName = dirName.charAt(0).toUpperCase() + dirName.slice(1);
-    const moduleDir = path.join(packageDir, dirName);
-    const className = dirName;
-
-    if (fs.existsSync(moduleDir)) {
-        console.error(`${i('errDirExists')} ${moduleDir}`);
-        process.exit(1);
-    }
-
-    // ── snack.json ────────────────────────────────────────────────────────────
-    const snackJson = {
-        name: moduleName,
-        version: '0.0.0.1',
-        author,
-        description
-    };
-
-    // ── index.ts ──────────────────────────────────────────────────────────────
-    const indexTs = `export * from './src/index';
-${withSetting ? "export * from './src/setting';\n" : ''}`;
-
-    // ── src/index.tsx ─────────────────────────────────────────────────────────
-    const indexTsx = `import React from 'react';
-import { Snack, SnackData } from '@snack-kit/core';
-import './style/index.scss';
-
-interface Props extends SnackData {}
-
-export class ${className} extends Snack {
-    constructor(data: Props = {}) {
-        super(data);
-    }
-
-    public $component(props: Props): React.ReactNode {
-        return (
-            <div className={'${className.toLowerCase()}'}>
-                {/* TODO */}
-            </div>
-        );
-    }
-}
-
-export default ${className};
-`;
-
-    // ── src/setting.tsx ───────────────────────────────────────────────────────
-    const settingTsx = `import React from 'react';
-import { SnackSetting } from '@snack-kit/core';
-import Main from './index';
-import './style/setting.scss';
-
-interface Props {}
-
-export class ${className}Setting extends SnackSetting {
-    constructor(public main: Main, public data: Props) {
-        super(data);
-    }
-
-    public $component(): React.ReactNode {
-        return <></>;
-    }
-}
-`;
-
-    // ── 样式文件 ───────────────────────────────────────────────────────────────
-    const indexScss = `.${className.toLowerCase()} {\n}\n`;
-    const settingScss = `.${className.toLowerCase()}-setting {\n}\n`;
-
-    // ── 写入文件 ───────────────────────────────────────────────────────────────
-    await fs.outputJSON(path.join(moduleDir, 'snack.json'), snackJson, { spaces: 4 });
-    await fs.outputFile(path.join(moduleDir, 'index.ts'), indexTs);
-    await fs.outputFile(path.join(moduleDir, 'src/index.tsx'), indexTsx);
-    await fs.outputFile(path.join(moduleDir, 'src/style/index.scss'), indexScss);
-
-    if (withSetting) {
-        await fs.outputFile(path.join(moduleDir, 'src/setting.tsx'), settingTsx);
-        await fs.outputFile(path.join(moduleDir, 'src/style/setting.scss'), settingScss);
-    }
-
-    console.log(`
-${i('moduleCreated')} ${moduleDir}
-
-${i('filesGenerated')}
-    ${dirName}/snack.json
-    ${dirName}/index.ts
-    ${dirName}/src/index.tsx
-    ${dirName}/src/style/index.scss${withSetting ? `
-    ${dirName}/src/setting.tsx
-    ${dirName}/src/style/setting.scss` : ''}
-`);
-}
-
-// ─── webpack 构建命令 ─────────────────────────────────────────────────────────
-
-function execWebpack(args) {
-    return new Promise(resolve => {
-        const ps = isNpm
-            ? spawn('webpack', args, { stdio: 'inherit', shell: true })
-            : spawn(path.resolve(__dirname, '../node_modules/.bin/', webpackFile), args, { stdio: 'inherit' });
-        ps.on('error', e => { console.log(e); resolve(false); });
-        ps.on('exit', () => resolve(true));
-    });
-}
-
-function clearOutput(output) {
-    fs.removeSync(output);
-}
-
-async function check(output) {
-    try {
-        const list = await fs.readdir(output);
-        for (const dirname of list) {
-            if (dirname === '__common__') continue;
-            const snackjson = path.join(output, dirname, 'snack.json');
-            if (!await fs.exists(snackjson)) continue;
-            const index = path.join(output, dirname, 'index.js');
-            if (!await fs.exists(index)) {
-                console.error(`${i('integrityFileMissing')}: ${index}`);
-                return false;
-            }
-        }
-    } catch (err) {
-        console.error('snack check: ', err);
-        return false;
-    }
-    console.log(i('integrityPass'));
-    return true;
-}
-
-async function run(script) {
-    const projectPackageJSON = fs.readJSONSync(path.resolve(projectPath, 'package.json'));
-    if (projectPackageJSON.name === 'snack-cli') {
-        throw i('errNameConflict');
-    }
-
-    process.env.SNACK_CLI_VERSION = version;
-    process.env.RUN_SCRIPT = script;
-    process.env.SNACK_SCRIPTS_PATH = __dirname;
-    process.env.PROJECT_COMMON_NAME = '__common__';
-    process.env.PROJECT_PACKAGE_JSON = JSON.stringify(projectPackageJSON);
-    process.env.PROJECT_TYPE = projectPackageJSON.name;
-    process.env.PROJECT_PATH = projectPath;
-    process.env.PROJECT_PACKAGE_PATH = path.resolve(projectPath, projectPackageJSON.input || 'src/package');
-    process.env.PROJECT_TEMP_PATH = path.resolve(projectPath, '.snack');
-    process.env.PROJECT_TEMPLATE_PATH = path.join(process.env.PROJECT_TEMP_PATH, 'template');
-
-    await fs.remove(process.env.PROJECT_TEMPLATE_PATH);
-    const err = await fs.copy(templatePath, process.env.PROJECT_TEMPLATE_PATH);
-    if (err) {
-        console.error(i('errTempDir'));
-        throw err;
-    }
-
-    process.env.PROJECT_SNACK_CONFIG = JSON.stringify(projectPackageJSON.snack || {});
-
-    if (script === 'entry') {
-        if (!projectPackageJSON.snack?.entry) throw i('errNoEntry');
-        process.env.RUN_MODE = 'production';
-        process.env.PROJECT_OUT_PATH = path.resolve(projectPath, projectPackageJSON.snack.entry.name || 'entry');
-        console.log(i('createEntry'));
-        await execWebpack(['--mode=production', `--config=${entryConfigPath}`]);
-    } else {
-        if (script === 'start') {
-            process.env.RUN_MODE = 'development';
-            process.env.PROJECT_OUT_PATH = path.resolve(process.env.PROJECT_TEMP_PATH, 'temp');
-        } else {
-            process.env.RUN_MODE = 'production';
-            process.env.PROJECT_OUT_PATH = path.resolve(projectPath, projectPackageJSON.output || 'dist', projectPackageJSON.name);
-        }
-
-        process.env.PROJECT_PACKAGE_LIST = JSON.stringify(GetPackageList(process.env.PROJECT_PACKAGE_PATH));
-
-        console.log(`${i('clearOutputDir')} "${process.env.PROJECT_OUT_PATH}" ...`);
-        clearOutput(process.env.PROJECT_OUT_PATH);
-        console.log(i('clearOutputDirEnd'));
-
-        if (script === 'start') {
-            console.log(i('devServerRunning'));
-            await execWebpack(['serve', '--mode=development', `--config=${devConfigPath}`]);
-        } else {
-            console.log(i('createLoaderAndHTML'));
-            await Promise.all([
-                execWebpack(['--mode=production', `--config=${loaderConfigPath}`]),
-                execWebpack(['--mode=production', `--config=${indexHTMLPath}`])
-            ]);
-            console.log(i('createLoaderAndHTMLEnd'));
-            console.log(i('createSnack'));
-            await execWebpack(['--mode=production', `--config=${snackPath}`]);
-            console.log(i('createSnackEnd'));
-        }
-
-        if (process.env.RUN_MODE !== 'development' && !await check(process.env.PROJECT_OUT_PATH)) {
-            fs.removeSync(process.env.PROJECT_OUT_PATH);
-            throw i('errIntegrity');
-        }
-    }
-
-    console.log(`
-   _____                  __      ________    ____
-  / ___/____  ____ ______/ /__   / ____/ /   /  _/
-  \\__ \\/ __ \\/ __ \`/ ___/ //_/  / /   / /    / /
- ___/ / / / / /_/ / /__/ ,<    / /___/ /____/ /
-/____/_/ /_/\\__,_/\\___/_/|_|   \\____/_____/___/  v.${version}
-    `);
-}
-
-// ─── 入口路由 ─────────────────────────────────────────────────────────────────
-
-if (script === 'init') {
-    runInit().catch(err => { console.error(err); process.exit(1); });
-} else if (script === 'create') {
-    runCreate().catch(err => { console.error(err); process.exit(1); });
-} else {
-    run(script).catch(err => { console.error(err); process.exit(1); });
-}