@longzai-intelligence-builder/config 0.2.19 → 0.2.20

package/README.md

@@ -0,0 +1,14 @@
+# @longzai-intelligence-builder/config
+
+Longzai Intelligence Builder 的类型契约包，承载构建配置的全部公共类型定义。
+
+## 简介
+
+治理 Builder 构建配置的类型口径：配置入口、解析后形态与各 feature 选项的类型由本包统一定义，配置预设、CLI 与消费方共享同一份类型契约，避免各包重复声明导致口径漂移；本包为纯类型包，不含运行时实现。
+
+## 能力
+
+- 构建配置入口类型（含函数式与多入口数组形态）
+- 解析后构建配置形态的类型定义
+- 各 feature 选项类型（依赖追踪、外部依赖、平台与构建目标、shims、可执行文件、CSS、hooks、watch、copy、产物报告、exports 校验、环境变量等）
+- 日志与构建上下文等基础设施类型

package/dist/index.d.ts

@@ -112,7 +112,7 @@ type BuilderHooks = {
  */
 type Awaitable<T> = T | Promise<T>;
 /**
- * @vitejs/devtools start 选项的最小类型
+ * devtools UI 的 start 选项最小类型(避免硬依赖 @vitejs/devtools)
  */
 type DevtoolsStartOptions = {
   host?: string;
@@ -498,6 +498,9 @@ type BuilderConfig = {
   cwd?: string;
   /**
    * 输出格式
+   *
+   * 内部规范值为 `'es'` / `'cjs'`。rolldown 的 `'esm'` 是 `'es'` 的别名，
+   * 解析时会归一为 `'es'`（消费方按 tsdown 习惯传 `'esm'` 与传 `'es'` 等价）。
    */
   format?: BuildFormat[] | BuildFormat;
   /**
@@ -918,14 +921,28 @@ type BuilderConfig = {
      * @default true
      */
     importTypeValue?: boolean;
+    /**
+     * dts 启用且 format 含 es/cjs 时，校验产物确实包含类型声明文件
+     *
+     * dts 应产出而未产出（如历史上 format 别名未归一导致 dts 插件被静默跳过，
+     * issue 0068）时构建显式失败，而非 exit 0 静默通过导致消费方 typecheck
+     * 成片报 TS2307/TS7016。纯 JS 入口等确实无类型声明的场景可显式关闭。
+     *
+     * @default true
+     */
+    dtsOutput?: boolean;
   };
   /**
+   * 已废弃的 bundle 选项。
+   *
    * @deprecated 使用 `unbundle` 代替
    *
    * 对齐 tsdown deprecated `bundle`。true → unbundle=false，false → unbundle=true。
    */
   bundle?: boolean;
   /**
+   * 已废弃的 removeNodeProtocol 选项。
+   *
    * @deprecated 使用 `nodeProtocol: 'strip'` 代替
    *
    * 对齐 tsdown deprecated `removeNodeProtocol`。true → nodeProtocol='strip'。
@@ -933,18 +950,24 @@ type BuilderConfig = {
    */
   removeNodeProtocol?: boolean;
   /**
+   * 已废弃的 injectStyle 选项。
+   *
    * @deprecated 使用 `css.inject` 代替
    *
    * 对齐 tsdown deprecated `injectStyle`。合并到 css.inject，与 css.inject 同时设置时抛错。
    */
   injectStyle?: unknown;
   /**
+   * 已废弃的 publicDir 选项。
+   *
    * @deprecated 使用 `copy` 代替
    *
    * 对齐 tsdown deprecated `publicDir`。映射到 copy，与 copy 同时设置时抛错。
    */
   publicDir?: unknown;
   /**
+   * 已废弃的 outExtension 选项。
+   *
    * @deprecated 使用 `outExtensions` 代替
    *
    * 对齐 tsdown deprecated `outExtension`。映射到 outExtensions，同时设置时抛错。
@@ -1210,11 +1233,12 @@ type ResolvedBuilderConfig = Required<Omit<BuilderConfig, 'format' | 'dts' | 'ts
    */
   write: boolean;
   /**
-   * 解析后的 checks 选项（含 legacyCjs，对齐 tsdown ResolvedConfig.checks）
+   * 解析后的 checks 选项（含 legacyCjs/dtsOutput，对齐 tsdown ResolvedConfig.checks）
    */
   checks: ChecksOptions & {
     legacyCjs: boolean;
     importTypeValue: boolean;
+    dtsOutput: boolean;
   };
   /**
    * 解析后的环境变量（合并 envFile + process.env + config.env，按 envPrefix 过滤）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longzai-intelligence-builder/config",
-  "version": "0.2.19",
+  "version": "0.2.20",
   "private": false,
   "license": "UNLICENSED",
   "files": [
@@ -31,10 +31,10 @@
   },
   "dependencies": {},
   "devDependencies": {
-    "@longzai-intelligence-builder/esm": "0.2.19"
+    "@longzai-intelligence-builder/esm": "0.2.20"
   },
   "peerDependencies": {
-    "@longzai-intelligence-builder/rolldown-plugin-dts": "0.2.19",
+    "@longzai-intelligence-builder/rolldown-plugin-dts": "0.2.20",
     "hookable": "^6.1.1",
     "rolldown": "^1.0.0"
   }