mvframe 1.0.5 → 1.0.7

package/README.cn.md

@@ -163,7 +163,7 @@ yarn build
 
 ## 命令行：项目目录雏形（推荐）
 
-在**空目录或已有 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）。若不存在则附带 `index.html` 与 `vite.config.js`。
+在**空目录或已有 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）。若不存在则附带 `index.html` 与 `vite.config.js`。会**合并** `package.json` 的 `dependencies` / `devDependencies`（与 Vite 模板一致；**同名包保留你原有版本**），最后请执行 **`yarn install`**；加 `--no-package-json` 可不改动 `package.json`。
 
 ```bash
 cd /path/to/your-app
@@ -171,6 +171,9 @@ node /path/to/mvframe/scripts/scaffold-app.js
 # 覆盖已有同名文件：
 node /path/to/mvframe/scripts/scaffold-app.js --force
 
+# 不修改 package.json（仅生成源码与配置）：
+node /path/to/mvframe/scripts/scaffold-app.js --no-package-json
+
 # 安装 mvframe 后：
 yarn exec mvframe-init-app
 # 或：npx mvframe-init-app

package/README.md

@@ -163,13 +163,16 @@ Production uses **library mode** with entry `src/index.js` and obfuscation-relat
 
 ## 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). Adds `index.html` and `vite.config.js` only if missing (use `--force` to overwrite).
+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). Adds `index.html` and `vite.config.js` only if missing (use `--force` to overwrite). **Merges** `dependencies` / `devDependencies` into `package.json` (existing versions win for shared keys); use `--no-package-json` to skip. Then run **`yarn install`**.
 
 ```bash
 cd /path/to/your-app
 node /path/to/mvframe/scripts/scaffold-app.js
 node /path/to/mvframe/scripts/scaffold-app.js --force
 
+# Skip package.json (only scaffold sources + Vite config):
+node /path/to/mvframe/scripts/scaffold-app.js --no-package-json
+
 yarn exec mvframe-init-app
 # or: npx mvframe-init-app
 ```

package/dist/vendor.js

@@ -63,7 +63,7 @@ const _ = /* @__PURE__ */ Object.assign({ "../component/BtnGroup/index.vue": v,
 }, w = {
   name: "Matt Avias Frame",
   copyright: "©2026",
-  version: "1.0.5",
+  version: "1.0.7",
   author: "Matt Avias",
   date: "2026-02-26",
   /** Table 等表格默认；业务在 app.use(mvframe, { config }) 里覆盖 */

package/package.json

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

package/scripts/scaffold-app.js

@@ -7,12 +7,15 @@
  *   yarn exec mvframe-init-app
  *
  * 环境变量：MVFRAME_SCAFFOLD_TARGET=/path/to/project
+ *
+ * 选项：--no-package-json  不读不写 package.json（仅生成源码与 Vite 配置）
  */
 
 const fs = require("fs");
 const path = require("path");
 
 const FORCE = process.argv.includes("--force");
+const NO_PKG = process.argv.includes("--no-package-json");
 const argPath = process.argv.find(
   (a, i) => i >= 2 && a !== "--force" && !a.startsWith("--"),
 );
@@ -31,6 +34,69 @@ function write(rel, content) {
   console.log("[mvframe-init] 写入", rel);
 }
 
+/** 与 main.js / vite.config 模板一致；版本号与 mvframe 本仓库对齐思路，可随发布调整 */
+// @vue/shared 为 Vue 3 内部包，传递依赖在部分包管理器下未提升时 Vite 解析失败，故写入直连依赖
+const SCAFFOLD_DEPENDENCIES = {
+  vue: "^3.5.0",
+  "@vue/shared": "^3.5.0",
+  "vue-router": "^4.6.0",
+  pinia: "^3.0.0",
+  mvframe: "^1.0.0",
+  "element-plus": "^2.13.0",
+};
+
+const SCAFFOLD_DEV_DEPENDENCIES = {
+  vite: "^6.0.0",
+  "@vitejs/plugin-vue": "^5.2.0",
+  "sass-embedded": "^1.97.0",
+  "unplugin-auto-import": "^0.18.2",
+};
+
+/**
+ * 合并 package.json：保留原有字段与其它依赖；仅补足脚手架所需包。
+ * 同名依赖以目标项目已有版本为准（{ ...建议, ...已有 }）。
+ */
+function mergePackageJson(projectRoot) {
+  const pkgPath = path.join(projectRoot, "package.json");
+  let pkg;
+
+  if (fs.existsSync(pkgPath)) {
+    try {
+      pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+    } catch (e) {
+      console.warn("[mvframe-init] package.json 解析失败，跳过合并:", e.message);
+      return;
+    }
+  } else {
+    pkg = {
+      name: path.basename(projectRoot).replace(/[^a-z0-9-]/gi, "-").toLowerCase() || "mvframe-app",
+      version: "0.1.0",
+      private: true,
+      type: "module",
+      scripts: {
+        dev: "vite",
+        build: "vite build",
+        preview: "vite preview",
+      },
+    };
+    console.log("[mvframe-init] 新建 package.json");
+  }
+
+  pkg.dependencies = {
+    ...SCAFFOLD_DEPENDENCIES,
+    ...(pkg.dependencies && typeof pkg.dependencies === "object" ? pkg.dependencies : {}),
+  };
+  pkg.devDependencies = {
+    ...SCAFFOLD_DEV_DEPENDENCIES,
+    ...(pkg.devDependencies && typeof pkg.devDependencies === "object"
+      ? pkg.devDependencies
+      : {}),
+  };
+
+  fs.writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`, "utf8");
+  console.log("[mvframe-init] 已合并 package.json 的 dependencies / devDependencies（已有版本优先）");
+}
+
 function main() {
   if (!fs.existsSync(target)) {
     console.error("[mvframe-init] 目录不存在:", target);
@@ -351,14 +417,21 @@ export default defineConfig({
     "MVFRAME-SCAFFOLD.md",
     `# MVFrame 雏形已生成
 
-## 依赖（若尚未安装）
+## 依赖
+
+初始化脚本会**合并**（不整文件覆盖）\`package.json\` 的 \`dependencies\` / \`devDependencies\`：**已声明的包保留你的版本号**，仅补上缺失项。然后执行：
 
 \`\`\`bash
-yarn add vue vue-router pinia mvframe element-plus
-yarn add -D vite @vitejs/plugin-vue sass-embedded unplugin-auto-import
+yarn install
 \`\`\`
 
-自动生成的 \`vite.config.js\` 已包含 \`unplugin-auto-import\`（与 mvframe 一致的 vue / vue-router 自动导入）；类型声明默认输出为项目根目录 \`auto-imports.d.ts\`（\`dts: true\`）。
+若需跳过对 \`package.json\` 的修改：\`node scripts/scaffold-app.js --no-package-json\`。
+
+自动生成的 \`vite.config.js\` 已包含 \`unplugin-auto-import\`；\`dts: true\` 时类型默认写在项目根 \`auto-imports.d.ts\`。
+
+### 报错 \`Could not resolve '@vue/shared'\`
+
+这是 **Vue 3 自带的底层包**，一般不必手写；在 **pnpm / 严格 node_modules** 等环境下可能未被提升到可被 Vite 解析的位置。脚手架已在 \`dependencies\` 中合并 \`@vue/shared\`（与 \`vue\` 同主版本）；老项目可手动执行 \`yarn add @vue/shared@^3.5\`。
 
 ## 样式
 
@@ -388,7 +461,13 @@ yarn exec mvframe-install-cursor-skill
 `,
   );
 
-  console.log("[mvframe-init] 完成。请阅读 MVFRAME-SCAFFOLD.md 并安装依赖。");
+  if (!NO_PKG) {
+    mergePackageJson(target);
+  }
+
+  console.log(
+    "[mvframe-init] 完成。请阅读 MVFRAME-SCAFFOLD.md 并在项目根执行 yarn install（或 npm install）。",
+  );
 }
 
 main();