mvframe 1.0.81 → 1.0.83

package/package.json

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

package/scripts/scaffold-app.js

@@ -3,12 +3,14 @@
  * 在目标工程生成 MVFrame 推荐目录与雏形文件（views / component / api / pinia / router / config / assets）。
  *
  * 用法：
- *   node path/to/mvframe/scripts/scaffold-app.js [项目根] [--force]
+ *   node path/to/mvframe/scripts/scaffold-app.js [项目根] [--force|-f]
  *   yarn exec mvframe-init-app
  *
  * 环境变量：MVFRAME_SCAFFOLD_TARGET=/path/to/project
  *
- * 选项：--no-package-json  不读不写 package.json（仅生成源码与 Vite 配置）
+ * 选项：
+ *   --force, -f            覆盖已存在的脚手架文件
+ *   --no-package-json, -n  不读不写 package.json（仅生成源码与 Vite 配置）
  */
 
 const fs = require("fs");
@@ -16,10 +18,10 @@ const path = require("path");
 const { execFileSync } = require("child_process");
 const { upsertCodexAgents } = require("./install-codex-agents.js");
 
-const FORCE = process.argv.includes("--force");
-const NO_PKG = process.argv.includes("--no-package-json");
+const FORCE = process.argv.includes("--force") || process.argv.includes("-f");
+const NO_PKG = process.argv.includes("--no-package-json") || process.argv.includes("-n");
 const argPath = process.argv.find(
-  (a, i) => i >= 2 && a !== "--force" && !a.startsWith("--"),
+  (a, i) => i >= 2 && !a.startsWith("-"),
 );
 const target = path.resolve(
   process.env.MVFRAME_SCAFFOLD_TARGET || argPath || process.cwd(),
@@ -831,7 +833,7 @@ yarn dev
 yarn exec mvframe-d
 \`\`\`
 
-若需跳过对 \`package.json\` 的修改：\`node scripts/scaffold-app.js --no-package-json\`。
+若需跳过对 \`package.json\` 的修改：\`node scripts/scaffold-app.js --no-package-json\` 或 \`node scripts/scaffold-app.js -n\`。
 
 自动生成的 \`vite.config.js\` 已包含 \`unplugin-auto-import\`；\`dts: true\` 时类型默认写在项目根 \`auto-imports.d.ts\`。
 
@@ -865,6 +867,29 @@ yarn exec mvframe-d
 
 \`src/main.js\` 已包含 \`import "mvframe/style"\` 与 \`import "mvframe/style/cpt"\`（分别对应工具类/变量与 **Mvc\*** 组件 scoped 等样式），一般 **无需** 在 \`index.scss\` 再引一遍 mvframe 的 dist CSS，以免重复。项目级覆盖写在 \`src/assets/style/index.scss\` 即可。
 
+## 表单 Label
+
+\`Input\`、\`Textarea\`、\`Select\`、\`SelectV2\` 支持统一的 label 接口：
+
+\`\`\`vue
+<Input v-model="form.name" label="Name" />
+<Input v-model="form.name" label="Material Name" material-label />
+
+<Textarea v-model="form.remark" label="Remark" />
+<Textarea v-model="form.remark" label="Material Remark" material-label />
+
+<Select v-model="form.type" :options="options" label="Type" />
+<Select v-model="form.type" :options="options" label="Material Type" material-label />
+\`\`\`
+
+规则：
+
+- 只传 \`label\`：渲染普通上方标题
+- 传 \`label\` + \`material-label\`：渲染 Material 风格浮动标签
+- 不传 \`label\`：保持组件默认外观
+
+Material 风格 label 的公共壳样式统一在 \`src/style/chip/element.scss\`。如果你要做 Material 风格表单，优先直接使用 \`label\` + \`material-label\`，不要在业务侧再重复写一套浮动标题。
+
 ## 子路径（按需）
 
 发布包 \`exports\` 还提供 \`mvframe/composition\`、\`mvframe/util\`、\`mvframe/store\`、\`mvframe/notify\` 等，业务侧可 \`import { ... } from "mvframe/composition"\` 等，参见包内 \`package.json\` 的 \`exports\`。
@@ -934,7 +959,7 @@ yarn exec mvframe-install-codex-rules
 
 ## Cursor 规则（\`.cursor/rules\`）
 
-初始化脚本会把 **mvframe 包内**与仓库一致的 **\`*.mdc\`** 写入目标项目 **\`/.cursor/rules/\`**（\`component-hierarchy\`、\`script-setup\`、\`style-system\`、\`views\`、\`router\`、\`global-components\`、\`data\`、\`util\`）。若目录或文件已存在且未加 \`--force\`，则跳过对应文件。
+初始化脚本会把 **mvframe 包内**与仓库一致的 **\`*.mdc\`** 写入目标项目 **\`/.cursor/rules/\`**（\`component-hierarchy\`、\`script-setup\`、\`style-system\`、\`views\`、\`router\`、\`global-components\`、\`data\`、\`util\`）。若目录或文件已存在且未加 \`--force\` / \`-f\`，则跳过对应文件。
 
 npm 包需在 \`files\` 中包含 \`.cursor/rules\`；使用本地 \`file:\` / 源码链接时同样可用。