@nasti-toolchain/nasti 2.5.0 → 2.5.2

package/README.md

@@ -116,6 +116,38 @@ export default defineConfig({
 })
 ```
 
+### 产物压缩：类名 / 属性名最小化
+
+`build.minify` 接受 `boolean`、`'oxc'`、`'dce-only'` 或一个 OXC Minifier 选项对象（Rolldown 内置 OXC minifier）。历史值 `'oxc'` 等同于 `true`，保留用于兼容旧配置：
+
+```ts
+export default defineConfig({
+  build: {
+    minify: {
+      // 保留类名（依赖 Class.prototype.name 做注册 / 依赖注入的框架需要）；
+      // 函数名照常最小化。默认二者都会被压缩。
+      mangle: { keepNames: { class: true, function: false } },
+
+      // 最小化属性名 —— Rolldown 1.2.6 · OXC 0.147 新增。
+      // 与 mangle 平级：它独立于标识符重命名之外单独处理属性名（含类成员）。
+      mangleProps: {
+        include: /^_/,        // 只压缩下划线前缀的「私有」属性
+        exclude: /^__/,       // 排除双下划线约定
+        reserved: ['_id'],    // 精确豁免
+      },
+    },
+  },
+})
+```
+
+> `mangleProps` 只按名字匹配、不做类型分析。凡是被未压缩代码、模块命名空间、
+> 全局对象或宿主 API 持有的属性，都必须用 `exclude` / `reserved` 摘出去，
+> 否则访问路径会被改坏。
+> 仅支持最终生成一个 JavaScript chunk；分包产生多个 JS chunk 时 Rolldown 会报错。
+> 单入口可设置 `build.rolldownOptions.output.codeSplitting: false` 内联动态导入。
+
+`nasti build` 与 `nasti electron-build` 提供对应的粗粒度开关：`--minify` 显式启用压缩（可覆盖配置中的 `build.minify: false`），`--no-minify` 则显式关闭压缩。另有 `--keep-names`（同时保函数名与类名）、`--mangle-props <regex>`。未传这些 flag 时完全交由配置文件决定（默认开启压缩）。
+
 ## CLI
 
 ```bash
@@ -123,7 +155,7 @@ export default defineConfig({
 nasti dev [root] [--port 3000] [--host] [--open]
 
 # 生产构建（Web / Electron）
-nasti build [root] [--outDir dist] [--sourcemap] [--minify] [--target web|electron]
+nasti build [root] [--outDir dist] [--sourcemap] [--minify | --no-minify] [--keep-names] [--mangle-props <regex>] [--target web|electron]
 
 # 预览构建产物
 nasti preview [root] [--port 4173]
@@ -132,7 +164,7 @@ nasti preview [root] [--port 4173]
 nasti electron [root] [--port 3000] [--no-spawn] [--no-restart]
 
 # Electron 生产构建（等价于 nasti build --target electron）
-nasti electron-build [root] [--outDir dist]
+nasti electron-build [root] [--outDir dist] [--minify | --no-minify]
 ```
 
 ## Programmatic API