@longzai-intelligence-builder/config 0.2.9 → 0.2.11

package/dist/index.d.ts

@@ -198,6 +198,68 @@ type CopyOptions = Arrayable<string | CopyEntry>;
  * copy 选项函数（对齐 tsdown CopyOptionsFn）
  */
 type CopyOptionsFn = (options: BuilderConfig) => Awaitable<CopyOptions>;
+/**
+ * clean 选项对象形态（issue 0064 原子替换模式）
+ *
+ * 当 `clean` 配置为对象时，启用原子替换：构建产物先写到 tmpDir，构建成功后原子替换 outDir，
+ * 失败则丢弃 tmpDir、保留旧 outDir。消除构建期 clean 空窗期（旧 outDir 全程不动），
+ * 适用于构建工具运行时依赖被构建包 dist 的自举场景（如 builder 仓库构建 core 时，
+ * lzi-builder 运行时执行 core 源码，core 动态 import css，css 静态 import core）。
+ */
+type CleanOptions = {
+  /**
+   * 是否启用原子替换模式
+   *
+   * - `true`：构建写到 tmpDir，成功后替换 outDir（默认 tmpDir = `<outDir>.tmp`）
+   * - `false`：退回默认行为（等价于 `clean: true`，构建前直接清空 outDir）
+   *
+   * @default false
+   */
+  atomic?: boolean;
+  /**
+   * 原子模式的临时构建目录（相对 cwd 或绝对路径）
+   *
+   * 不指定时默认 `<outDir>.tmp`（与 outDir 同父目录，保证同设备 rename 不触发 EXDEV）。
+   * 指定时构建产物先写到该目录，成功后 rm 旧 outDir + rename 此目录 → outDir。
+   *
+   * 注意：指定跨设备的 tmp 路径会触发 EXDEV，rename 失败时自动 fallback 为 copy + delete。
+   */
+  tmpDir?: string;
+  /**
+   * 原子模式之外额外清理的路径（glob 模式，相对 cwd）
+   *
+   * 这些路径在构建前直接删除（非原子，与默认 clean 的 string[] 行为一致），
+   * 用于清理 outDir 之外的产物（如 node_modules/.rolldown、exe 输出目录）。
+   */
+  extraTargets?: string[];
+};
+/**
+ * resolveClean 归一化后的 clean 配置
+ *
+ * 所有 clean 形态（boolean / string[] / CleanOptions）归一化为本结构。
+ * - `paths`：构建前直接删除的路径（glob 模式）。默认模式含 outDir；原子模式仅含 extraTargets
+ * - `atomic`：是否启用原子替换（构建写 tmpDir，成功后替换 outDir）
+ * - `tmpDir`：原子模式的临时目录绝对路径（atomic 为 true 时有值）
+ */
+type ResolvedClean = {
+  /**
+   * 构建前直接删除的路径列表（glob 模式，相对 cwd）
+   *
+   * 默认模式：含 outDir（clean:true 时）或用户指定的 string[]
+   * 原子模式：仅含 extraTargets（outDir 由原子替换处理，不在此列表）
+   */
+  paths: string[];
+  /**
+   * 是否启用原子替换模式
+   */
+  atomic: boolean;
+  /**
+   * 原子模式的临时构建目录绝对路径
+   *
+   * 仅 atomic 为 true 时有值；默认 `<cwd>/<outDir>.tmp`，或用户指定的 tmpDir 解析为绝对路径。
+   */
+  tmpDir?: string;
+};
 /**
  * report 选项（对齐 tsdown ReportOptions）
  */
@@ -462,8 +524,11 @@ type BuilderConfig = {
    * - `true`（默认）：清理输出目录
    * - `false`：不清理
    * - `string[]`：清理指定路径列表（glob 模式）
+   * - 对象形态 `{ atomic, tmpDir }`（issue 0064）：原子替换模式，构建写到 tmpDir（默认
+   *   `<outDir>.tmp`），成功后原子替换 outDir，失败保留旧产物。消除构建期 clean 空窗期，
+   *   适用于构建工具运行时依赖被构建包 dist 的自举场景
    */
-  clean?: boolean | string[];
+  clean?: boolean | string[] | CleanOptions;
   /**
    * 输出文件扩展名
    */
@@ -1121,9 +1186,9 @@ type ResolvedBuilderConfig = Required<Omit<BuilderConfig, 'format' | 'dts' | 'ts
    */
   css: BuilderConfig['css'];
   /**
-   * 解析后的 clean 路径列表（glob 模式）
+   * 解析后的 clean 配置（归一化后）
    */
-  clean: string[];
+  clean: ResolvedClean;
   /**
    * 是否写入磁盘（对齐 tsdown ResolvedConfig.write）
    */
@@ -1195,4 +1260,4 @@ type BuilderConfigFn = (inlineConfig?: {
  */
 type BuilderConfigExport = Awaitable<Arrayable<BuilderConfig> | BuilderConfigFn>;
 //#endregion
-export type { Arrayable, AttwOptions, BuildContext, BuildFormat, BuilderConfig, BuilderConfigExport, BuilderConfigFn, BuilderHooks, CIOption, ConfigLoader, ConfigOptions, CopyEntry, CopyOptions, CopyOptionsFn, DepsOptions, DevtoolsOptions, DtsOptions, EntryConfig, ExportsOptions, LogLevel, LogType, Logger, LoggerOptions, NoExternalFn, PackageJsonWithPath, PresetDefinition, PublintOptions, ReportOptions, ResolvedBuilderConfig, RolldownChunk, RolldownContext, TsdownInputOption, WithEnabled, Workspace };
+export type { Arrayable, AttwOptions, BuildContext, BuildFormat, BuilderConfig, BuilderConfigExport, BuilderConfigFn, BuilderHooks, CIOption, CleanOptions, ConfigLoader, ConfigOptions, CopyEntry, CopyOptions, CopyOptionsFn, DepsOptions, DevtoolsOptions, DtsOptions, EntryConfig, ExportsOptions, LogLevel, LogType, Logger, LoggerOptions, NoExternalFn, PackageJsonWithPath, PresetDefinition, PublintOptions, ReportOptions, ResolvedBuilderConfig, ResolvedClean, RolldownChunk, RolldownContext, TsdownInputOption, WithEnabled, Workspace };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longzai-intelligence-builder/config",
-  "version": "0.2.9",
+  "version": "0.2.11",
   "private": false,
   "license": "UNLICENSED",
   "type": "module",
@@ -31,11 +31,11 @@
   },
   "dependencies": {},
   "peerDependencies": {
-    "@longzai-intelligence-builder/rolldown-plugin-dts": "0.2.9",
+    "@longzai-intelligence-builder/rolldown-plugin-dts": "0.2.11",
     "hookable": "^6.1.1",
     "rolldown": "^1.0.0"
   },
   "devDependencies": {
-    "@longzai-intelligence-builder/esm": "0.2.9"
+    "@longzai-intelligence-builder/esm": "0.2.11"
   }
 }