@bams-app/work-cli 0.0.1

package/index.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+
+const path = require('path');
+
+module.exports = {
+    version: require('./package.json').version,
+    bin: path.resolve(__dirname, 'bin', 'work-cli.js')
+};

package/lib/utils.js

@@ -0,0 +1,196 @@
+const fs = require('fs');
+const path = require('path');
+const { spawn } = require('child_process');
+
+const ENABLE_COLOR = process.stdout.isTTY && process.env.NO_COLOR === undefined;
+const ANSI = {
+    reset: '\x1b[0m',
+    bold: '\x1b[1m',
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    cyan: '\x1b[36m',
+    gray: '\x1b[90m'
+};
+
+function colorize(text, color) {
+    if (!ENABLE_COLOR || !ANSI[color]) {
+        return text;
+    }
+    return `${ANSI[color]}${text}${ANSI.reset}`;
+}
+
+function log(msg, color) {
+    console.log(color ? colorize(msg, color) : msg);
+}
+
+function error(msg) {
+    console.error(colorize(`[work-cli] ${msg}`, 'red'));
+}
+
+function warn(msg) {
+    console.log(colorize(`[work-cli] ${msg}`, 'yellow'));
+}
+
+function success(msg) {
+    console.log(colorize(`[work-cli] ${msg}`, 'green'));
+}
+
+function info(msg) {
+    console.log(colorize(`[work-cli] ${msg}`, 'cyan'));
+}
+
+function toKebabCase(name) {
+    return String(name)
+        .trim()
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .replace(/_/g, '-')
+        .toLowerCase();
+}
+
+function toPascalCase(name) {
+    return toKebabCase(name)
+        .replace(/(^|-)([a-z])/g, (_, __, letter) => letter.toUpperCase());
+}
+
+function toCamelCase(name) {
+    const pascal = toPascalCase(name);
+    return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+}
+
+function exists(targetPath) {
+    return fs.existsSync(targetPath);
+}
+
+function isDirectory(targetPath) {
+    return exists(targetPath) && fs.statSync(targetPath).isDirectory();
+}
+
+function readJson(filePath) {
+    return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+}
+
+function writeJson(filePath, data) {
+    fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + '\n', 'utf8');
+}
+
+/**
+ * 递归复制目录，跳过 node_modules/.git/dist 等目录
+ */
+function copyDir(src, dest, { skip = [] } = {}) {
+    const skipDirs = new Set(['node_modules', '.git', 'dist', 'build', ...skip]);
+    if (!isDirectory(src)) {
+        throw new Error(`源目录不存在: ${src}`);
+    }
+    fs.mkdirSync(dest, { recursive: true });
+
+    for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+
+        if (entry.isDirectory()) {
+            if (skipDirs.has(entry.name)) {
+                continue;
+            }
+            copyDir(srcPath, destPath, { skip });
+        } else {
+            fs.copyFileSync(srcPath, destPath);
+        }
+    }
+}
+
+/**
+ * 递归遍历目录，返回文件路径列表
+ */
+function walkFiles(dir, result = []) {
+    if (!isDirectory(dir)) {
+        return result;
+    }
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            walkFiles(fullPath, result);
+        } else {
+            result.push(fullPath);
+        }
+    }
+    return result;
+}
+
+/**
+ * 在目录内所有文本文件中执行字符串替换
+ */
+function replaceInDir(dir, replacements, { excludes = [] } = {}) {
+    const files = walkFiles(dir).filter((filePath) => {
+        return !excludes.some((pattern) => filePath.endsWith(pattern));
+    });
+    for (const filePath of files) {
+        const content = fs.readFileSync(filePath, 'utf8');
+        let next = content;
+        for (const [from, to] of Object.entries(replacements)) {
+            next = next.split(from).join(to);
+        }
+        if (next !== content) {
+            fs.writeFileSync(filePath, next, 'utf8');
+        }
+    }
+}
+
+/**
+ * 从当前目录向上查找用户项目根（含 .bams-work 目录的最近祖先）
+ */
+function findProjectRoot(startDir = process.cwd()) {
+    let current = path.resolve(startDir);
+    while (true) {
+        if (isDirectory(path.join(current, '.bams-work'))) {
+            return current;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            return null;
+        }
+        current = parent;
+    }
+}
+
+/**
+ * 启动子进程（继承 stdio）
+ */
+function run(command, args, { cwd, env = process.env } = {}) {
+    return new Promise((resolve) => {
+        const child = spawn(command, args, {
+            cwd,
+            env,
+            stdio: 'inherit'
+        });
+        child.on('error', (err) => {
+            error(`启动失败: ${err.message}`);
+            resolve(1);
+        });
+        child.on('exit', (code) => {
+            resolve(code ?? 1);
+        });
+    });
+}
+
+module.exports = {
+    colorize,
+    log,
+    error,
+    warn,
+    success,
+    info,
+    toKebabCase,
+    toPascalCase,
+    toCamelCase,
+    exists,
+    isDirectory,
+    readJson,
+    writeJson,
+    copyDir,
+    walkFiles,
+    replaceInDir,
+    findProjectRoot,
+    run
+};

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@bams-app/work-cli",
+  "version": "0.0.1",
+  "description": "BAMS-Work 全局开发工具：复用 work 已发布的包（ui-dev-server / shared-env / create-ui-*）提供项目初始化与组件开发能力（类似 vue-cli）",
+  "main": "index.js",
+  "bin": {
+    "bams-work": "./bin/work-cli.js"
+  },
+  "files": [
+    "bin",
+    "commands",
+    "lib",
+    "templates"
+  ],
+  "dependencies": {
+    "@bams-app/create-env": "*",
+    "@bams-app/create-pages-entry": "*",
+    "@bams-app/create-pages-from-components": "*",
+    "@bams-app/create-ui-base": "*",
+    "@bams-app/create-ui-component": "*",
+    "@bams-app/create-ui-page": "*",
+    "@bams-app/shared-env": "*",
+    "@bams-app/ui-dev-server": "*"
+  },
+  "engines": {
+    "node": ">=16.7.0"
+  },
+  "license": "UNLICENSED"
+}

package/templates/project/.envs/.env.dev-demo

@@ -0,0 +1,14 @@
+# 开发环境（示例），可复制为 .env.dev-<标识> 使用
+# 端口必须与 PROXY_TARGET 的端口保持一致
+NODE_ENV=development
+PORT=8088
+PROXY_TARGET=http://127.0.0.1:8088
+BASE_URL=/
+
+VUE_APP_TITLE=BAMS组件开发环境
+VUE_APP_SYS_CODE=bams-demo
+VUE_APP_SYS_NAME=BAMS组件开发示例
+
+# 可配置插槽（可选，留空使用默认空组件）
+# COMPONENT_LOGIN=@bams-app/ui-login-component
+# COMPONENT_STARTR_LAYOUT=@bams-app/ui-startr-layout-component

package/templates/project/.envs/README.md

@@ -0,0 +1,45 @@
+# 项目环境配置
+
+本目录存放各业务系统环境变量，`bams-work dev <env>` 会加载 `.env.dev-<env>`。
+
+## 环境文件格式
+
+- `.env.dev-demo`：开发环境示例（跟随本模板生成）
+- `.env.production`：生产环境（构建时加载）
+
+## 关键变量
+
+| 变量名                    | 说明                                     |
+| ------------------------- | ---------------------------------------- |
+| `PROXY_TARGET`            | 开发代理目标地址（后端服务）             |
+| `PORT`                    | 开发服务器端口，需与代理目标端口一致     |
+| `BASE_URL`                | 应用基础路径                             |
+| `VUE_APP_TITLE`           | 浏览器标签页标题                         |
+| `VUE_APP_SYS_CODE`        | 系统编码                                 |
+| `COMPONENT_LOGIN`         | 登录组件包名（可配置插槽）               |
+| `COMPONENT_STARTR_LAYOUT` | 布局组件包名（可配置插槽）               |
+| `VUE_APP_*`               | 注入前端代码的编译变量（勿存放敏感信息） |
+
+## 创建新环境
+
+```bash
+# 复制示例
+cd .envs
+cp .env.dev-demo .env.dev-<新标识>
+```
+
+> 命名规范：`.env.dev-<标识>`，标识仅允许小写字母、数字和连字符。
+
+## 代理配置
+
+默认内置代理前缀：`/bams-assets`、`/bams-ui-umd`、`/bams-app`、`/admin-api`、`/preview`。
+
+如需自定义代理，在项目根创建 `.proxy.js`：
+
+```js
+module.exports = {
+  proxy: {
+    '/my-api': { target: 'http://192.168.1.100:8080', changeOrigin: true }
+  }
+};
+```

package/templates/project/.proxy.js.example

@@ -0,0 +1,11 @@
+/**
+ * BAMS-Work 自定义开发代理（可选）
+ * 存在本文件时自动生效，覆盖内置默认代理前缀。
+ * 也可导出函数：module.exports = ({ env, projectRoot }) => ({ proxy: { ... } })
+ */
+module.exports = {
+    proxy: {
+        // 示例：自定义后端前缀
+        // '/my-api': { target: 'http://192.168.1.100:8080', changeOrigin: true }
+    }
+};

package/templates/project/README.md

@@ -0,0 +1,58 @@
+# BAMS-Work Monorepo 项目
+
+基于 `@bams-app/work-cli` 初始化的组件开发项目（类似 vue-cli 模式）。
+work 开发环境（`@bams-app/ui-dev-server`）与创建命令（`@bams-app/create-ui-*`）直接复用 work 仓库发布的 npm 包。
+
+## 目录结构
+
+```
+.
+├── package.json          # Monorepo 根（workspaces: bams-components/*、*-ui/*、bams-ui）
+├── .bams-work/           # BAMS-Work 项目标记目录，勿删除
+├── .envs/                # 环境配置（.env.dev-<env>）
+├── .proxy.js             # 自定义开发代理（可选）
+├── bams-components/      # 默认组件 scope
+│   └── ui-component-demo # 示例组件
+└── <scope>-ui/           # 业务 scope 目录（如 energy-ui/，add 时创建）
+    └── ui-xxx
+```
+
+## 常用命令
+
+```bash
+# 开发（加载 .envs/.env.dev-<env>，默认组件 ui-component-demo）
+bams-work dev demo
+bams-work dev demo ui-order-list
+
+# 构建宿主应用（production，输出 dist/）
+bams-work build ui-order-list
+
+# 构建组件 UMD 产物（输出 dist/umd/）
+bams-work umd ui-order-list
+
+# 在 scope 目录下创建新组件
+bams-work add --dir energy-ui --name ui-order-list
+bams-work add --dir energy-ui --name page-order-list --type page
+```
+
+## 首次安装
+
+```bash
+npm install
+# 或
+yarn install
+```
+
+`@bams-app/ui-dev-server` 及其依赖的能力包（`@bams-app/components` 等）会安装到根 node_modules，
+业务组件与 work 开发环境共用同一套能力实例。项目 `.npmrc` 配置了 `install-links=true`，
+`file:` 安装的能力包会以复制方式解析其全部传递依赖（vue、ant-design-vue 等自动安装），
+因此 `package.json` 无需声明任何外部运行时依赖。
+
+## 环境变量
+
+见 `.envs/README.md`。新增环境：`cp .envs/.env.dev-demo .envs/.env.dev-<标识>`。
+
+## 自定义配置
+
+- 代理：创建项目根 `.proxy.js`（见 `.proxy.js.example`）
+- webpack 扩展：创建项目根 `vue.config.extend.js`（导出对象或 `({ env, projectRoot }) => 对象`）

package/templates/project/gitignore.tpl

@@ -0,0 +1,35 @@
+# Dependencies
+node_modules/
+
+# Build outputs
+dist/
+build/
+*.log
+
+# BAMS-Work 内部产物（install 时由 .bams-work 重新生成）
+.bams-work/
+
+# IDE
+.vscode/
+.idea/
+.trae/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Yarn
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/sdks
+!.yarn/versions

package/templates/project/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "__PROJECT_NAME__",
+  "version": "0.0.6",
+  "private": true,
+  "description": "BAMS-Work Monorepo 项目",
+  "workspaces": [
+    "bams-components/*",
+    "*-ui/*",
+    "bams-ui"
+  ],
+  "scripts": {
+    "dev": "bams-work dev",
+    "build": "bams-work build",
+    "umd": "bams-work umd",
+    "add": "bams-work add"
+  },
+  "dependencies": {
+    __UI_DEV_SERVER_DEP____CAPABILITY_DEPS__
+  }
+}