mvframe 1.1.30 → 1.1.32

package/README.cn.md

@@ -268,6 +268,21 @@ await notify("需要发送到钉钉的消息");
 
 ---
 
+## 命令行：宿主项目打包
+
+在宿主项目 `package.json` 中增加 `"b": "mvframe-b"`。该命令会执行宿主 Vite 构建、复制 MVFrame 国旗资源，并写入 `serve.json`。项目名自动取执行命令时所在项目的文件夹名，并通过 `MVFRAME_PROJECT_NAME` 传给 Vite。
+
+```bash
+yarn b                         # mode=development，输出 dev/
+yarn b pre                     # mode=pre，输出 pre/，加载 .env.pre*
+yarn b pd                      # mode=production，输出 pd/，加载 .env.production*
+yarn b --mode staging --outDir release
+```
+
+`--pre`、`--pd` 分别等价于 `pre`、`pd` 快捷命令。旧的 `-t`（`test/test`）、`-p`（`production/pre`）以及单个位置参数自定义输出目录仍然兼容。
+
+---
+
 ## 命令行：项目目录雏形（推荐）
 
 在**空目录或已有 Vite 工程根目录**执行，生成 `src/views`、`src/component`、`src/api`、`src/assets/img`、`src/assets/style`、`src/router`、`src/pinia/chip`、`src/config` 及示例 `main.js` / `App.vue`（已 `app.use(mvframe, …)` 挂好路由、Pinia `storeChips`、config，并写入 `components.async: ["VTable"]`），同时写入/更新宿主项目 **`AGENTS.md`** 的 MVFrame Codex 规则，其中包含 **每次 AI 完成开发后执行 `yarn exec mvframe-notify --once --message "..."` 发送完成通知** 的要求，并复制 **`/.cursor/rules/*.mdc`**（与 mvframe 仓库内 Cursor 规则一致）。若不存在则附带 `index.html` 与 `vite.config.js`。会**合并** `package.json` 的 `scripts` / `dependencies` / `devDependencies`（与 Vite 模板一致；**同名脚本和包保留你原有值**），初始化 `.env.mvframe-notify.example` / `.env.local.example` 与 `config.notify`，并自动执行 **`yarn install`**，最后请执行 **`yarn dev`**；需要同时启动通知服务时显式执行 **`yarn exec mvframe-d -n`**。加 `--no-package-json` 可不改动 `package.json` 且跳过安装。

package/README.md

@@ -253,6 +253,21 @@ The floating label shell is implemented centrally in `src/style/chip/element.scs
 
 ---
 
+## CLI: host application build
+
+Add `"b": "mvframe-b"` to the host application's `package.json`. The command runs the host Vite build, copies MVFrame flag assets, and writes `serve.json`. The host project name is derived from the current project folder and passed to Vite as `MVFRAME_PROJECT_NAME`.
+
+```bash
+yarn b                         # mode=development, outDir=dev
+yarn b pre                     # mode=pre, outDir=pre; loads .env.pre*
+yarn b pd                      # mode=production, outDir=pd; loads .env.production*
+yarn b --mode staging --outDir release
+```
+
+`--pre` and `--pd` are equivalent to the `pre` and `pd` shortcuts. The legacy `-t` (`test/test`), `-p` (`production/pre`), and single positional output-directory forms remain supported.
+
+---
+
 ## CLI: project skeleton
 
 From an **empty folder or existing Vite root**, generates `src/views`, `src/component`, `src/api`, `src/assets/img`, `src/assets/style`, `src/router`, `src/pinia/chip`, `src/config`, plus starter `main.js` / `App.vue` with `app.use(mvframe, …)` (routes, Pinia `storeChips`, config, and `components.async: ["VTable"]`). It also writes/updates host-project **`AGENTS.md`** with MVFrame Codex rules, including a requirement that AI send a completion message with `yarn exec mvframe-notify --once --message "..."` after each finished development task, and copies **`/.cursor/rules/*.mdc`** from the package (same as this repo’s Cursor rules). Adds `index.html` and `vite.config.js` only if missing (use `--force` to overwrite). **Merges** `scripts` / `dependencies` / `devDependencies` into `package.json` (existing values win for shared keys), initializes `.env.mvframe-notify.example` / `.env.local.example` and `config.notify`, then runs **`yarn install`**; use `--no-package-json` to skip package changes and install. Then run **`yarn dev`** or explicitly run **`yarn exec mvframe-d -n`** to start Vite with the notify service.

package/dist/vendor.js

@@ -6084,7 +6084,7 @@ const Gl = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
       {
         id: "143598",
         code: "st",
-        label: "Sao",
+        label: "Sao Tome and Principe",
         hide: !1
       },
       {
@@ -13958,7 +13958,7 @@ const Wr = (a, o = {}) => {
 }, qr = {
   name: "Matt Avias Frame",
   copyright: "©2026",
-  version: "1.1.30",
+  version: "1.1.32",
   author: "Matt Avias",
   date: "2026-02-26",
   /** 默认语言 key，与 `$getLang`、localStorage `lang` 一致；业务在 app.use(mvframe, { config }) 里覆盖 */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mvframe",
   "packageManager": "yarn@4.4.1",
-  "version": "1.1.30",
+  "version": "1.1.32",
   "author": "matt avis",
   "main": "./dist/index.js",
   "module": "./dist/index.js",

package/scripts/build-host.js

@@ -3,17 +3,34 @@
  * 宿主 Vite 工程：打包后写入与 mstar 一致的 `serve.json`（SPA 回写 index.html）。
  *
  * 在宿主 `package.json` 中增加：`"b": "mvframe-b"`
- * 然后执行 `yarn b` 或 `yarn b [outDir] [-t|-p]`。
+ * 然后执行 `yarn b`、`yarn b pre`、`yarn b pd`，或传入自定义 mode / outDir。
  *
  * - 默认：--mode development，输出目录 `dev`
  * - `-t`：--mode test，输出 `test`
- * - `-p`：--mode production，输出 `pre`（Vite 环境为 production，对应 .env.production*）
- * - 一个位置参数：自定义输出目录（与 -t / -p 同用时，以 -t / -p 为准）
+ * - `-p`：兼容旧行为，--mode production，输出 `pre`
+ * - `pre` / `--pre`：--mode pre，输出 `pre`，加载 `.env.pre*`
+ * - `pd` / `--pd`：--mode production，输出 `pd`，加载 `.env.production*`
+ * - `--mode <mode>` / `--outDir <dir>`：自定义 Vite mode 与输出目录
+ * - 一个普通位置参数：兼容旧行为，作为自定义输出目录
  */
 const { spawnSync } = require("child_process");
 const fs = require("fs");
 const path = require("path");
 const { copyFlagAssetsTo } = require("./flag-assets.js");
+const USAGE = `用法:
+  mvframe-b
+  mvframe-b pre | --pre
+  mvframe-b pd | --pd
+  mvframe-b [outDir] [-t|-p]
+  mvframe-b [--mode <mode>] [--outDir <dir>]
+
+快捷模式:
+  pre / --pre  mode=pre, outDir=pre
+  pd  / --pd   mode=production, outDir=pd
+
+兼容模式:
+  -t            mode=test, outDir=test
+  -p            mode=production, outDir=pre`;
 const SERVE_JSON = `{
   "rewrites": [{
     "source": "**",
@@ -21,48 +38,88 @@ const SERVE_JSON = `{
   }]
 }`;
 
-function parseArgs(argv) {
+function argumentError(message) {
+  const error = new Error(`${message}\n\n${USAGE}`);
+  error.name = "MvframeBuildArgumentError";
+  return error;
+}
+
+function readOptionValue(args, index, option) {
+  const value = args[index + 1];
+  if (!value || value.startsWith("-")) {
+    throw argumentError(`[mvframe-b] ${option} 缺少参数值`);
+  }
+  return value;
+}
+
+function parseArgs(argv, logger = console) {
   const args = argv.slice(2);
   let mode = "development";
   let outDir = "dev";
-  let preset = false;
+  let preset = "";
+  let explicitOutDir = false;
+  let help = false;
   const positional = [];
 
-  for (const a of args) {
-    if (a === "-t") {
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+
+    if (arg === "-h" || arg === "--help") {
+      help = true;
+    } else if (arg === "-t") {
       mode = "test";
       outDir = "test";
-      preset = true;
-    } else if (a === "-p") {
+      preset = "-t";
+    } else if (arg === "-p") {
       mode = "production";
       outDir = "pre";
-      preset = true;
-    } else if (a.startsWith("-")) {
-      console.error(`[mvframe-b] 未知参数: ${a}`);
-      process.exit(1);
+      preset = "-p";
+    } else if (arg === "pre" || arg === "--pre") {
+      mode = "pre";
+      outDir = "pre";
+      preset = "pre";
+    } else if (arg === "pd" || arg === "--pd") {
+      mode = "production";
+      outDir = "pd";
+      preset = "pd";
+    } else if (arg === "--mode") {
+      mode = readOptionValue(args, index, "--mode");
+      index += 1;
+    } else if (arg.startsWith("--mode=")) {
+      mode = arg.slice("--mode=".length);
+      if (!mode) throw argumentError("[mvframe-b] --mode 缺少参数值");
+    } else if (arg === "--outDir" || arg === "--out-dir") {
+      outDir = readOptionValue(args, index, arg);
+      explicitOutDir = true;
+      index += 1;
+    } else if (arg.startsWith("--outDir=") || arg.startsWith("--out-dir=")) {
+      outDir = arg.slice(arg.indexOf("=") + 1);
+      if (!outDir) throw argumentError("[mvframe-b] --outDir 缺少参数值");
+      explicitOutDir = true;
+    } else if (arg.startsWith("-")) {
+      throw argumentError(`[mvframe-b] 未知参数: ${arg}`);
     } else {
-      positional.push(a);
+      positional.push(arg);
     }
   }
 
   if (positional.length > 1) {
-    console.error(
-      "[mvframe-b] 用法: yarn b [outDir] [-t|-p]\n  默认: outDir=dev, mode=development; -t: test/test; -p: pre/production",
+    throw argumentError(
+      `[mvframe-b] 最多只能传入一个自定义输出目录: ${positional.join(" ")}`,
     );
-    process.exit(1);
   }
 
   if (positional.length === 1) {
-    if (preset) {
-      console.warn(
-        `[mvframe-b] 已使用 -t/-p，忽略输出目录参数 "${positional[0]}"，实际输出: ${outDir}`,
+    if (preset || explicitOutDir) {
+      logger.warn(
+        `[mvframe-b] 已指定 ${preset || "--outDir"}，忽略输出目录参数 "${positional[0]}"，实际输出: ${outDir}`,
       );
     } else {
       outDir = positional[0];
     }
   }
 
-  return { mode, outDir };
+  return { mode, outDir, help };
 }
 
 /**
@@ -93,11 +150,39 @@ function copyFlagAssets(outAbs) {
   console.log(`[mvframe-b] 已复制 ${path.relative(outAbs, dest)}`);
 }
 
+function projectNameFrom(cwd) {
+  return path.basename(path.resolve(cwd));
+}
+
 function main() {
   const cwd = process.cwd();
-  const { mode, outDir } = parseArgs(process.argv);
+  let options;
+
+  try {
+    options = parseArgs(process.argv);
+  } catch (error) {
+    if (error?.name === "MvframeBuildArgumentError") {
+      console.error(error.message);
+      process.exit(1);
+    }
+    throw error;
+  }
+
+  if (options.help) {
+    console.log(USAGE);
+    return;
+  }
+
+  const { mode, outDir } = options;
+  const projectName = projectNameFrom(cwd);
   const viteEntry = resolveViteCli(cwd);
-  const env = { ...process.env, NODE_ENV: "production" };
+  const env = {
+    ...process.env,
+    NODE_ENV: "production",
+    MVFRAME_PROJECT_NAME: projectName,
+  };
+
+  console.log(`[mvframe-b] 项目: ${projectName}; mode: ${mode}; outDir: ${outDir}`);
   const child = spawnSync(
     process.execPath,
     [viteEntry, "build", "--outDir", outDir, "--mode", mode],
@@ -114,4 +199,10 @@ function main() {
   console.log(`[mvframe-b] 已写入 ${path.relative(cwd, servePath)}`);
 }
 
-main();
+if (require.main === module) main();
+
+module.exports = {
+  parseArgs,
+  projectNameFrom,
+  USAGE,
+};