@longzai-intelligence-bun/config 0.0.1 → 0.0.3

package/dist/index.d.ts

@@ -1,53 +1,198 @@
-//#region src/types.d.ts
+//#region src/types/bun.types.d.ts
 /**
- * bun test 工具配置类型
+ * bun test 工具配置类型定义
  *
- * 定义 lzi-bun-cli 的 test 命令在 lzi-dev.config.ts 中的配置结构。
- * 字段命名对齐 vitest 的 test.* 配置项，便于心智一致与将来可移植。
+ * 扩展 bun:test 原生配置语义，提供项目特定的便捷配置层。
+ *
+ * 设计对齐 longzai-intelligence-vitest 的类型分层：
+ * - 原生字段收进 {@link BunTestConfig}（命名对齐 bun:test 原生 `[test]` 段）
+ * - 便捷字段平铺在 {@link BunProjectSpecificOptions}（对齐 vitest ProjectSpecificOptions）
+ * - 默认值合并发生在 {@link createBaseBunConfig}，而非 defineConfig 工厂层
+ *
+ * 字段命名差异说明（bun vs vitest，生成的 bunfig.toml 必须合法）：
+ * - bun 用 `coveragePathIgnorePatterns`（vitest 用 `coverage.exclude`）
+ * - bun 用 `coverageThreshold`（vitest 用 `coverage.thresholds`）
+ * - bun 的 `coverageThreshold` 不支持 `branches`（vitest 支持）
  */
 /**
- * bun test 命令配置
+ * 覆盖率阈值配置
  *
- * 字段命名对齐 vitest 的 test.* 配置项：
+ * bun 的 coverageThreshold 仅支持 lines/functions/statements 三维，
+ * 不支持 branches（coverage.md 已确认）。
  *
- * - passWithNoTests ← vitest test.passWithNoTests
- * - include ← vitest test.include
+ * 数值范围 0-1（bun 原生语义，如 0.8 表示 80%）。
+ */
+type CoverageThreshold = {
+  /**
+   * 行覆盖率阈值（0-1）
+   */
+  lines?: number;
+  /**
+   * 函数覆盖率阈值（0-1）
+   */
+  functions?: number;
+  /**
+   * 语句覆盖率阈值（0-1）
+   */
+  statements?: number;
+};
+/**
+ * bun:test 原生测试配置
+ *
+ * 字段命名与 bunfig.toml `[test]` 段完全对齐，序列化后即为合法 TOML。
+ * 参考：https://bun.sh/docs/runtime/bunfig
  */
 type BunTestConfig = {
   /**
-   * 零测试文件时是否放行 exit 0
+   * 预加载脚本，对应 bunfig.toml `preload`
    *
-   * 对齐 vitest 的 test.passWithNoTests。
+   * 仅在 `bun test` 前执行，用于注入全局 mock、polyfill 等。
+   */
+  preload?: string[];
+  /**
+   * 是否启用覆盖率报告，对应 bunfig.toml `coverage`
    *
-   * 适配 type-only / facade 包（仅 re-export barrel、无测试源码）：
-   * 这类包在 turbo test 扇出中必须能干净通过，而非因「没有测试」失败。
+   * @default false
+   */
+  coverage?: boolean;
+  /**
+   * 覆盖率阈值，对应 bunfig.toml `coverageThreshold`
    *
-   * - true（默认）：放行，打印跳过提示后 exit 0
-   * - false：报错 exit 1，用于强制要求测试的严格包
+   * 支持单数值（应用于三维）或对象（分别设置）。
+   * 设置任何阈值都会启用 fail_on_low_coverage 门控。
+   */
+  coverageThreshold?: number | CoverageThreshold;
+  /**
+   * 是否排除测试文件，对应 bunfig.toml `coverageSkipTestFiles`
+   *
+   * @default false
+   */
+  coverageSkipTestFiles?: boolean;
+  /**
+   * 覆盖率忽略路径模式，对应 bunfig.toml `coveragePathIgnorePatterns`
+   *
+   * 豁免策略的核心字段。支持单模式或模式数组。
+   */
+  coveragePathIgnorePatterns?: string | string[];
+  /**
+   * 覆盖率报告器类型，对应 bunfig.toml `coverageReporter`
+   *
+   * @default ['text']
+   */
+  coverageReporter?: string[];
+  /**
+   * 覆盖率报告输出目录，对应 bunfig.toml `coverageDir`
    *
-   * 默认值在命令实现内用 `?? true` 处理
-   * （与 dev-tools defineConfig identity 工厂模式一致，不在工厂层合并默认值）
+   * 仅对持久化报告器（如 lcov）生效。
+   *
+   * @default 'coverage'
+   */
+  coverageDir?: string;
+  /**
+   * 是否忽略 sourcemap 回溯，对应 bunfig.toml `coverageIgnoreSourcemaps`
+   *
+   * @default false
+   */
+  coverageIgnoreSourcemaps?: boolean;
+  /**
+   * 测试超时时间（毫秒），对应 bunfig.toml `timeout`
+   */
+  timeout?: number;
+  /**
+   * 零测试文件时是否放行 exit 0
+   *
+   * 对齐 vitest 的 passWithNoTests。
+   * 适配 type-only / facade 包：这类包在 turbo test 扇出中必须能干净通过。
+   *
+   * - true（默认）：放行，打印跳过提示后 exit 0
+   * - false：报错 exit 1
    *
    * @default true
    */
   passWithNoTests?: boolean;
   /**
-   * 测试文件 glob 列表（相对 cwd），用于零测试预检
+   * 测试文件匹配模式，对应 bunfig.toml `pathIgnorePatterns` 的反向
    *
-   * 对齐 vitest 的 test.include。
+   * 这里仅作为「零测试预检」的 glob 来源，不影响 bun test 实际扫描范围。
+   */
+  include?: string[];
+};
+/**
+ * 项目特定的便捷配置选项
+ *
+ * 这些字段不是 bun 原生，而是 lzi-bun-cli 封装层提供的快捷键，
+ * 由 {@link createBaseBunConfig} 映射为对应的 bun 原生字段。
+ *
+ * 设计对齐 vitest ProjectSpecificOptions：便捷字段平铺顶层，
+ * 与原生 test 字段分层，心智清晰。
+ */
+type BunProjectSpecificOptions = {
+  /**
+   * 是否启用覆盖率配置注入，默认 true
    *
-   * 命令在调用 bun test 前，先用这些 glob 扫描 cwd 下的测试文件，
-   * 命中 0 个时按 {@link passWithNoTests} 决策放行或失败。
+   * 设为 false 时，即使运行 `lzi-bun-cli test --coverage`，
+   * 也不会生成覆盖率相关的 bunfig.toml 段。
    *
-   * 默认值（命令实现内处理）：src 下与 tests 目录下的点 test.ts / test.tsx 文件
+   * @default true
    */
-  include?: string[];
+  enableCoverage?: boolean;
+  /**
+   * 覆盖率阈值便捷配置
+   *
+   * 会被映射到 `test.coverageThreshold`。
+   * 用户显式传入的 `test.coverageThreshold` 优先级更高（三层合并最后赢）。
+   */
+  coverageThresholds?: CoverageThreshold;
+  /**
+   * 额外的覆盖率忽略路径模式
+   *
+   * 会被追加到 preset 默认的 `coveragePathIgnorePatterns` 之后。
+   * 用于声明端专属豁免（如 migrations 目录）而不覆盖 preset 基座。
+   */
+  extraCoverageIgnorePatterns?: string[];
+  /**
+   * 额外的测试文件排除模式（pathIgnorePatterns，非覆盖率）
+   *
+   * 会被映射到 bun test 的 pathIgnorePatterns。预留位，当前 CLI 未物化。
+   */
+  extraIgnorePatterns?: string[];
+};
+/**
+ * bun 工具配置选项
+ *
+ * 结合 bun:test 原生配置和项目便捷选项。
+ * 用户可以使用 bun 的所有原生配置，同时享受项目约定的默认值。
+ */
+type BunConfigOptions = BunProjectSpecificOptions & {
+  /**
+   * bun:test 原生测试配置，会与默认配置合并
+   *
+   * 用户在此传入的原生字段优先级最高（最后赢）。
+   */
+  test?: BunTestConfig;
+};
+/**
+ * bun 配置物化结果
+ *
+ * {@link createBaseBunConfig} 返回的完整合并对象。
+ * 序列化后即为合法的 bunfig.toml `[test]` 段内容。
+ *
+ * 与 {@link BunConfigOptions} 的区别：此处所有字段已合并到最终值，
+ * 无 undefined；是「待序列化」的中间态。
+ */
+type BunConfigResult = {
+  /**
+   * 完整合并后的 bun:test 测试配置
+   */
+  test: BunTestConfig;
 };
 /**
  * lzi-bun-cli 配置
  *
  * 定义 lzi-bun.config.ts 配置文件的顶层结构。
- * 仅含 lzi-bun-cli 专属域；dev-cli 的发布等配置见 lzi-dev.config.ts。
+ *
+ * 注意：此类型与 {@link BunConfigResult} 兼容（即 preset 工厂返回的对象可直接作为此类型使用），
+ * 因为 {@link BunConfigResult} 是 `{ test: BunTestConfig }` 的超集结构。
  */
 type LziBunConfig = {
   /**
@@ -56,14 +201,469 @@ type LziBunConfig = {
   test?: BunTestConfig;
 };
 //#endregion
+//#region src/core/defaults.constants.d.ts
+/**
+ * 默认配置常量
+ *
+ * 提供 createBaseBunConfig 合并时使用的默认值。
+ * 这些常量不直接对外消费，preset 工厂会在其上叠加层级专属阈值与豁免。
+ */
+/**
+ * 默认的覆盖率忽略路径模式
+ *
+ * 通用基座：所有 preset 都隐含包含这些模式。
+ * 由 createBaseBunConfig 在合并时作为最底层（preset 和用户可覆盖/追加）。
+ */
+declare const DEFAULT_COVERAGE_IGNORE_PATTERNS: string[];
+/**
+ * 默认的覆盖率报告器
+ *
+ * text：终端输出，便于本地查看
+ * lcov：生成 coverage/lcov.info，可集成 VS Code 覆盖率插件或 CI
+ */
+declare const DEFAULT_COVERAGE_REPORTERS: string[];
+/**
+ * 默认的覆盖率报告输出目录
+ */
+declare const DEFAULT_COVERAGE_DIR = "coverage";
+/**
+ * 默认的测试文件匹配模式
+ *
+ * 用于「零测试预检」的 glob 来源（不影响 bun test 实际扫描范围）。
+ */
+declare const DEFAULT_INCLUDE_PATTERNS: string[];
+//#endregion
+//#region src/exemptions/domain/minimal-exemption.patterns.d.ts
+/**
+ * 领域层最小豁免模式
+ *
+ * 适用于核心业务逻辑包（推荐）。仅排除不适合纳入覆盖率统计的代码：
+ * 基础设施层细粒度、端口适配器、错误定义、类型与导出。
+ *
+ * 内容来源：coverage.md「最小豁免（推荐）」全集。
+ */
+/**
+ * 领域层最小豁免模式覆盖率忽略路径列表
+ *
+ * 每条 pattern 对应 bunfig.toml coveragePathIgnorePatterns 的一项。
+ */
+declare const DOMAIN_MINIMAL_EXEMPTION_PATTERNS: string[];
+//#endregion
+//#region src/exemptions/domain/moderate-exemption.patterns.d.ts
+/**
+ * 领域层中等豁免模式
+ *
+ * 在最小豁免基础上，整体排除基础设施层与应用层映射器/DTO。
+ * 适用于业务逻辑较简单、或尚在补充测试的包。
+ *
+ * 内容来源：coverage.md「中等豁免」全集。
+ */
+/**
+ * 领域层中等豁免模式覆盖率忽略路径列表
+ *
+ * minimal 的真超集：minimal ⊂ moderate（由 exemptions.test.ts 锁定）。
+ */
+declare const DOMAIN_MODERATE_EXEMPTION_PATTERNS: string[];
+//#endregion
+//#region src/exemptions/server/minimal-exemption.patterns.d.ts
+/**
+ * apps/server 最小豁免模式
+ *
+ * NestJS 应用最小豁免：仅排除框架配置文件 + 通用类型/导出。
+ * 端专属豁免详见 platform-exemptions.md。
+ *
+ * 注意：node_modules / dist / out 由 DEFAULT_COVERAGE_IGNORE_PATTERNS 基座统一提供，此处不重复。
+ */
+/**
+ * apps/server 最小豁免模式覆盖率忽略路径列表
+ */
+declare const SERVER_MINIMAL_EXEMPTION_PATTERNS: string[];
+//#endregion
+//#region src/exemptions/server/moderate-exemption.patterns.d.ts
+/**
+ * apps/server 中等豁免模式
+ *
+ * 在最小豁免基础上，排除 NestJS 全部框架中间件 + 基础设施层 + 数据库迁移。
+ * 内容来源：coverage.md「apps/server（中等豁免）」全集。
+ *
+ * 注意：node_modules / dist / out 由 DEFAULT_COVERAGE_IGNORE_PATTERNS 基座统一提供，此处不重复。
+ */
+/**
+ * apps/server 中等豁免模式覆盖率忽略路径列表
+ *
+ * SERVER_MINIMAL_EXEMPTION_PATTERNS 的真超集（由 exemptions.test.ts 锁定）。
+ */
+declare const SERVER_MODERATE_EXEMPTION_PATTERNS: string[];
+//#endregion
+//#region src/exemptions/web/minimal-exemption.patterns.d.ts
+/**
+ * apps/web / apps/desktop 最小豁免模式
+ *
+ * UI 应用最小豁免：仅排除通用类型/导出。
+ *
+ * 注意：node_modules / dist / out 由 DEFAULT_COVERAGE_IGNORE_PATTERNS 基座统一提供，此处不重复。
+ */
+/**
+ * apps/web / apps/desktop 最小豁免模式覆盖率忽略路径列表
+ */
+declare const WEB_MINIMAL_EXEMPTION_PATTERNS: string[];
+//#endregion
+//#region src/exemptions/web/moderate-exemption.patterns.d.ts
+/**
+ * apps/web / apps/desktop 中等豁免模式
+ *
+ * 排除 UI 层（app/components/hooks/providers/i18n/types）+ 样式 + 类型声明。
+ * 内容来源：coverage.md「apps/web / apps/desktop（中等豁免）」全集。
+ *
+ * 注意：node_modules / dist / out 由 DEFAULT_COVERAGE_IGNORE_PATTERNS 基座统一提供，此处不重复。
+ */
+/**
+ * apps/web / apps/desktop 中等豁免模式覆盖率忽略路径列表
+ *
+ * WEB_MINIMAL_EXEMPTION_PATTERNS 的真超集（由 exemptions.test.ts 锁定）。
+ */
+declare const WEB_MODERATE_EXEMPTION_PATTERNS: string[];
+//#endregion
+//#region src/thresholds/index.d.ts
+/**
+ * Domain 层覆盖率阈值
+ *
+ * 核心业务逻辑层（DDD domain 层），要求最高覆盖率。
+ * 对应 coverage.md「DDD 分层 - domain 层 >= 90%」。
+ */
+declare const DOMAIN_COVERAGE_THRESHOLDS: CoverageThreshold;
+/**
+ * Implementation 层覆盖率阈值
+ *
+ * domains 下的 implementation 包（domains/{name}/implementation），DDD 分层中 application 层标准。
+ * 对应 coverage.md「domains 下 implementation 包 >= 80%」。
+ */
+declare const IMPLEMENTATION_COVERAGE_THRESHOLDS: CoverageThreshold;
+/**
+ * packages/core 覆盖率阈值
+ *
+ * 核心工具库，要求较高覆盖率。
+ * 对应 coverage.md「packages/core >= 85%」。
+ */
+declare const PACKAGE_CORE_COVERAGE_THRESHOLDS: CoverageThreshold;
+/**
+ * packages/shared 覆盖率阈值
+ *
+ * 共享工具库。
+ * 对应 coverage.md「packages/shared >= 80%」。
+ */
+declare const PACKAGE_SHARED_COVERAGE_THRESHOLDS: CoverageThreshold;
+/**
+ * packages/sdk 覆盖率阈值
+ *
+ * SDK 包。
+ * 对应 coverage.md「packages/sdk >= 80%」。
+ */
+declare const PACKAGE_SDK_COVERAGE_THRESHOLDS: CoverageThreshold;
+/**
+ * apps/server 覆盖率阈值
+ *
+ * 服务端应用（NestJS），DDD 分层中 infrastructure 层标准。
+ * 对应 coverage.md「apps/server >= 70%」。
+ */
+declare const SERVER_COVERAGE_THRESHOLDS: CoverageThreshold;
+/**
+ * apps/web 覆盖率阈值
+ *
+ * Web 前端应用。
+ * 对应 coverage.md「apps/web >= 60%」。
+ */
+declare const WEB_COVERAGE_THRESHOLDS: CoverageThreshold;
+/**
+ * apps/desktop 覆盖率阈值
+ *
+ * 桌面端应用（Electron）。
+ * 对应 coverage.md「apps/desktop >= 60%」。
+ */
+declare const DESKTOP_COVERAGE_THRESHOLDS: CoverageThreshold;
+/**
+ * apps/cli 覆盖率阈值
+ *
+ * CLI 工具应用。
+ * 对应 coverage.md「apps/cli >= 70%」。
+ */
+declare const CLI_COVERAGE_THRESHOLDS: CoverageThreshold;
+/**
+ * 纯类型定义包覆盖率阈值
+ *
+ * contract / main 包，无可执行代码，不参与覆盖率门控。
+ * preset 中会据此跳过 coverage 配置生成。
+ */
+declare const TYPE_ONLY_COVERAGE_THRESHOLDS: CoverageThreshold;
+//#endregion
+//#region src/config/base.config.d.ts
+/**
+ * 创建基础 bun 配置
+ *
+ * 生成一个标准的 bun 配置对象（含完整 `[test]` 段合并结果）。
+ * 支持传入完整 bun 原生配置与项目便捷字段，工厂进行三层合并。
+ *
+ * @example
+ *   ```typescript
+ *   import { createBaseBunConfig } from '@longzai-intelligence-bun/config';
+ *
+ *   const config = createBaseBunConfig({
+ *     coverageThresholds: { lines: 0.8, functions: 0.8 },
+ *     extraCoverageIgnorePatterns: ['generated 目录'],
+ *   });
+ *   ```;
+ *
+ * @param options - 配置选项，支持 bun 原生配置和项目便捷选项
+ * @returns BunConfigResult 配置对象
+ */
+declare function createBaseBunConfig(options?: BunConfigOptions): BunConfigResult;
+/**
+ * 定义 bun 配置
+ *
+ * createBaseBunConfig 的语法糖，提供更语义化的配置方式。
+ * 与 vitest defineVitestConfig 一致：identity 转发。
+ *
+ * @example
+ *   ```typescript
+ *   import { defineBunConfig } from '@longzai-intelligence-bun/config';
+ *
+ *   export default defineBunConfig({
+ *     coverageThresholds: { lines: 0.8 },
+ *   });
+ *   ```;
+ *
+ * @param options - 配置选项，同 createBaseBunConfig
+ * @returns BunConfigResult 配置对象
+ */
+declare function defineBunConfig(options?: BunConfigOptions): BunConfigResult;
+//#endregion
+//#region src/presets/domain.config.d.ts
+/**
+ * 创建领域层 bun 配置
+ *
+ * @example
+ *   ```typescript
+ *   import { createDomainBunConfig } from '@longzai-intelligence-bun/config';
+ *
+ *   export default createDomainBunConfig({
+ *     extraCoverageIgnorePatterns: ['generated 目录'],
+ *   });
+ *   ```;
+ *
+ * @param options - 配置选项，同 createBaseBunConfig
+ * @returns bun 配置对象
+ */
+declare function createDomainBunConfig(options?: BunConfigOptions): BunConfigResult;
+/**
+ * 定义领域层 bun 配置
+ *
+ * createDomainBunConfig 的语法糖（identity 转发），对齐 vitest define* 风格。
+ *
+ * @example
+ *   ```typescript
+ *   import { defineDomainBunConfig } from '@longzai-intelligence-bun/config';
+ *
+ *   export default defineDomainBunConfig();
+ *   ```;
+ *
+ * @param options - 配置选项，同 createDomainBunConfig（默认 {}）
+ * @returns bun 配置对象（BunConfigResult）
+ */
+declare function defineDomainBunConfig(options?: BunConfigOptions): BunConfigResult;
+//#endregion
+//#region src/presets/implementation.config.d.ts
+/**
+ * 创建 implementation 层 bun 配置
+ *
+ * @example
+ *   ```typescript
+ *   import { createImplementationBunConfig } from '@longzai-intelligence-bun/config';
+ *
+ *   export default createImplementationBunConfig();
+ *   ```;
+ *
+ * @param options - 配置选项，同 createBaseBunConfig
+ * @returns bun 配置对象
+ */
+declare function createImplementationBunConfig(options?: BunConfigOptions): BunConfigResult;
+/**
+ * 定义 implementation 层 bun 配置
+ *
+ * createImplementationBunConfig 的语法糖。
+ *
+ * @param options - 配置选项，同 createImplementationBunConfig
+ * @returns bun 配置对象
+ */
+declare function defineImplementationBunConfig(options?: BunConfigOptions): BunConfigResult;
+//#endregion
+//#region src/presets/package.config.d.ts
+/**
+ * 创建 packages/core bun 配置
+ *
+ * @example
+ *   ```typescript
+ *   import { createPackageCoreBunConfig } from '@longzai-intelligence-bun/config';
+ *
+ *   export default createPackageCoreBunConfig();
+ *   ```;
+ *
+ * @param options - 配置选项，同 createBaseBunConfig
+ * @returns bun 配置对象
+ */
+declare function createPackageCoreBunConfig(options?: BunConfigOptions): BunConfigResult;
+/**
+ * 定义 packages/core bun 配置
+ *
+ * createPackageCoreBunConfig 的语法糖。
+ *
+ * @param options - 配置选项，同 createPackageCoreBunConfig（默认 {}）
+ * @returns bun 配置对象（BunConfigResult）
+ */
+declare function definePackageCoreBunConfig(options?: BunConfigOptions): BunConfigResult;
+/**
+ * 创建 packages/shared bun 配置
+ *
+ * @param options - 配置选项，同 createBaseBunConfig
+ * @returns bun 配置对象
+ */
+declare function createPackageSharedBunConfig(options?: BunConfigOptions): BunConfigResult;
+/**
+ * 定义 packages/shared bun 配置
+ *
+ * createPackageSharedBunConfig 的语法糖。
+ *
+ * @param options - 配置选项，同 createPackageSharedBunConfig（默认 {}）
+ * @returns bun 配置对象（BunConfigResult）
+ */
+declare function definePackageSharedBunConfig(options?: BunConfigOptions): BunConfigResult;
+/**
+ * 创建 packages/sdk bun 配置
+ *
+ * @param options - 配置选项，同 createBaseBunConfig
+ * @returns bun 配置对象
+ */
+declare function createPackageSdkBunConfig(options?: BunConfigOptions): BunConfigResult;
+/**
+ * 定义 packages/sdk bun 配置
+ *
+ * createPackageSdkBunConfig 的语法糖。
+ *
+ * @param options - 配置选项，同 createPackageSdkBunConfig（默认 {}）
+ * @returns bun 配置对象（BunConfigResult）
+ */
+declare function definePackageSdkBunConfig(options?: BunConfigOptions): BunConfigResult;
+//#endregion
+//#region src/presets/app.config.d.ts
+/**
+ * 创建 apps/server（NestJS）bun 配置
+ *
+ * @example
+ *   ```typescript
+ *   import { createServerBunConfig } from '@longzai-intelligence-bun/config';
+ *
+ *   export default createServerBunConfig({
+ *     test: { timeout: 15000 },
+ *   });
+ *   ```;
+ *
+ * @param options - 配置选项，同 createBaseBunConfig
+ * @returns bun 配置对象
+ */
+declare function createServerBunConfig(options?: BunConfigOptions): BunConfigResult;
+/**
+ * 定义 apps/server bun 配置
+ *
+ * createServerBunConfig 的语法糖。
+ *
+ * @param options - 配置选项，同 createServerBunConfig（默认 {}）
+ * @returns bun 配置对象（BunConfigResult）
+ */
+declare function defineServerBunConfig(options?: BunConfigOptions): BunConfigResult;
+/**
+ * 创建 apps/web bun 配置
+ *
+ * @param options - 配置选项，同 createBaseBunConfig
+ * @returns bun 配置对象
+ */
+declare function createWebBunConfig(options?: BunConfigOptions): BunConfigResult;
+/**
+ * 定义 apps/web bun 配置
+ *
+ * createWebBunConfig 的语法糖。
+ *
+ * @param options - 配置选项，同 createWebBunConfig（默认 {}）
+ * @returns bun 配置对象（BunConfigResult）
+ */
+declare function defineWebBunConfig(options?: BunConfigOptions): BunConfigResult;
+/**
+ * 创建 apps/desktop（Electron）bun 配置
+ *
+ * @param options - 配置选项，同 createBaseBunConfig
+ * @returns bun 配置对象
+ */
+declare function createDesktopBunConfig(options?: BunConfigOptions): BunConfigResult;
+/**
+ * 定义 apps/desktop bun 配置
+ *
+ * createDesktopBunConfig 的语法糖。
+ *
+ * @param options - 配置选项，同 createDesktopBunConfig（默认 {}）
+ * @returns bun 配置对象（BunConfigResult）
+ */
+declare function defineDesktopBunConfig(options?: BunConfigOptions): BunConfigResult;
+/**
+ * 创建 apps/cli bun 配置
+ *
+ * @param options - 配置选项，同 createBaseBunConfig
+ * @returns bun 配置对象
+ */
+declare function createCliBunConfig(options?: BunConfigOptions): BunConfigResult;
+/**
+ * 定义 apps/cli bun 配置
+ *
+ * createCliBunConfig 的语法糖。
+ *
+ * @param options - 配置选项，同 createCliBunConfig（默认 {}）
+ * @returns bun 配置对象（BunConfigResult）
+ */
+declare function defineCliBunConfig(options?: BunConfigOptions): BunConfigResult;
+//#endregion
+//#region src/presets/type-only.config.d.ts
+/**
+ * 创建纯类型包 bun 配置
+ *
+ * @example
+ *   ```typescript
+ *   import { createTypeOnlyBunConfig } from '@longzai-intelligence-bun/config';
+ *
+ *   export default createTypeOnlyBunConfig();
+ *   ```;
+ *
+ * @param options - 配置选项（enableCoverage 将被强制覆盖为 false）
+ * @returns bun 配置对象（无 coverage 段）
+ */
+declare function createTypeOnlyBunConfig(options?: BunConfigOptions): BunConfigResult;
+/**
+ * 定义纯类型包 bun 配置
+ *
+ * createTypeOnlyBunConfig 的语法糖。
+ *
+ * @param options - 配置选项（enableCoverage 将被强制覆盖为 false，默认 {}）
+ * @returns bun 配置对象（BunConfigResult，无 coverage 段）
+ */
+declare function defineTypeOnlyBunConfig(options?: BunConfigOptions): BunConfigResult;
+//#endregion
 //#region src/index.d.ts
 /**
- * 定义 lzi-bun-cli 配置
+ * 定义 lzi-bun-cli 配置（向后兼容的 identity 工厂）
  *
  * 提供类型推导，用户无需手动 satisfies。
  *
  * 与 dev-tools 的 defineConfig 一致：identity 工厂，仅做类型推导，
- * 不在工厂层合并默认值——默认值由各命令实现内用 `?? fallback` 处理。
+ * 不在工厂层合并默认值——默认值由 createBaseBunConfig / preset 工厂处理。
+ *
+ * 当使用 preset 工厂（如 defineDomainBunConfig）时，无需再包一层 defineConfig；
+ * 此工厂保留给仅需 passWithNoTests 等基础字段的场景。
  *
  * @example
  *   ```typescript
@@ -71,7 +671,7 @@ type LziBunConfig = {
  *
  *   export default defineConfig({
  *     test: {
- *       passWithNoTests: false,
+ *       passWithNoTests: true,
  *     },
  *   });
  *   ```;
@@ -81,4 +681,4 @@ type LziBunConfig = {
  */
 declare const defineConfig: (config: LziBunConfig) => LziBunConfig;
 //#endregion
-export { type BunTestConfig, type LziBunConfig, defineConfig };
+export { type BunConfigOptions, type BunConfigResult, type BunProjectSpecificOptions, type BunTestConfig, CLI_COVERAGE_THRESHOLDS, SERVER_MINIMAL_EXEMPTION_PATTERNS as CLI_MINIMAL_EXEMPTION_PATTERNS, SERVER_MINIMAL_EXEMPTION_PATTERNS, SERVER_MODERATE_EXEMPTION_PATTERNS as CLI_MODERATE_EXEMPTION_PATTERNS, SERVER_MODERATE_EXEMPTION_PATTERNS, type CoverageThreshold, DEFAULT_COVERAGE_DIR, DEFAULT_COVERAGE_IGNORE_PATTERNS, DEFAULT_COVERAGE_REPORTERS, DEFAULT_INCLUDE_PATTERNS, DESKTOP_COVERAGE_THRESHOLDS, WEB_MINIMAL_EXEMPTION_PATTERNS as DESKTOP_MINIMAL_EXEMPTION_PATTERNS, WEB_MINIMAL_EXEMPTION_PATTERNS, WEB_MODERATE_EXEMPTION_PATTERNS as DESKTOP_MODERATE_EXEMPTION_PATTERNS, WEB_MODERATE_EXEMPTION_PATTERNS, DOMAIN_COVERAGE_THRESHOLDS, DOMAIN_MINIMAL_EXEMPTION_PATTERNS, DOMAIN_MODERATE_EXEMPTION_PATTERNS, IMPLEMENTATION_COVERAGE_THRESHOLDS, type LziBunConfig, PACKAGE_CORE_COVERAGE_THRESHOLDS, PACKAGE_SDK_COVERAGE_THRESHOLDS, PACKAGE_SHARED_COVERAGE_THRESHOLDS, SERVER_COVERAGE_THRESHOLDS, TYPE_ONLY_COVERAGE_THRESHOLDS, WEB_COVERAGE_THRESHOLDS, createBaseBunConfig, createCliBunConfig, createDesktopBunConfig, createDomainBunConfig, createImplementationBunConfig, createPackageCoreBunConfig, createPackageSdkBunConfig, createPackageSharedBunConfig, createServerBunConfig, createTypeOnlyBunConfig, createWebBunConfig, defineBunConfig, defineCliBunConfig, defineConfig, defineDesktopBunConfig, defineDomainBunConfig, defineImplementationBunConfig, definePackageCoreBunConfig, definePackageSdkBunConfig, definePackageSharedBunConfig, defineServerBunConfig, defineTypeOnlyBunConfig, defineWebBunConfig };

package/dist/index.js

@@ -1 +1 @@
-const e=e=>e;export{e as defineConfig};
+const e=[`**/node_modules/**`,`**/dist/**`,`**/out/**`],t=[`text`,`lcov`],n=`coverage`,r=[`src/**/*.test.ts`,`src/**/*.test.tsx`,`__tests__/**/*.test.ts`],i=[`**/infrastructure/entities/**`,`**/infrastructure/repositories/**`,`**/infrastructure/mappers/**`,`**/infrastructure/schemas/**`,`**/infrastructure/adapters/**`,`**/typeorm.ts`,`**/application/tokens.ts`,`**/application/index.ts`,`**/domain/index.ts`,`**/domain/entities/index.ts`,`**/domain/repositories/**`,`**/domain/types/**`,`**/domain/schemas/**`,`**/domain/events/**`,`**/domain/errors/**`,`src/index.ts`],a=[`**/infrastructure/**`,`**/typeorm.ts`,`**/application/tokens.ts`,`**/application/index.ts`,`**/application/port-adapters/**`,`**/application/mappers/**`,`**/application/dtos/**`,`**/domain/index.ts`,`**/domain/entities/index.ts`,`**/domain/repositories/**`,`**/domain/types/**`,`**/domain/events/**`,`**/domain/errors/**`,`src/index.ts`],o=[`**/*.module.ts`,`**/index.ts`,`src/index.ts`],s=[`**/*.module.ts`,`**/*.dto.ts`,`**/*.controller.ts`,`**/*.handler.ts`,`**/*.guard.ts`,`**/*.interceptor.ts`,`**/*.filter.ts`,`**/*.strategy.ts`,`**/*.scheduler.ts`,`**/*.provider.ts`,`**/*.gateway.ts`,`**/*.decorator.ts`,`**/infrastructure/**`,`**/migrations/**`,`**/index.ts`,`src/index.ts`],c=[`**/index.ts`,`src/index.ts`],l=[`src/app/**`,`src/components/**`,`src/features/**/components/**`,`src/hooks/**`,`src/providers/**`,`src/i18n/**`,`src/types/**`,`**/*.css`,`**/*.d.ts`,`**/index.ts`,`src/index.ts`],u={lines:.9,functions:.9,statements:.9},d={lines:.8,functions:.8,statements:.8},f={lines:.85,functions:.85,statements:.85},p={lines:.8,functions:.8,statements:.8},m={lines:.8,functions:.8,statements:.8},h={lines:.7,functions:.7,statements:.7},g={lines:.6,functions:.6,statements:.6},_={lines:.6,functions:.6,statements:.6},v={lines:.7,functions:.7,statements:.7},y={lines:0,functions:0,statements:0};function b(e){if(e!==void 0)return typeof e==`number`?{lines:e,functions:e,statements:e}:{...e}}function x(t,n,r){let i=n??[],a=r===void 0?[]:Array.isArray(r)?r:[r];return[...e,...t,...i,...a]}function S(e){let{enableCoverage:n=!0,coverageThresholds:i,extraCoverageIgnorePatterns:a,test:o}=e,s=o?.include??r,c={passWithNoTests:o?.passWithNoTests??!0,include:s,...o};if(!n)return c;let l=b(i),u=b(o?.coverageThreshold),d={...l,...u},f=d.lines!==void 0||d.functions!==void 0||d.statements!==void 0,p=x([],a,o?.coveragePathIgnorePatterns);return c.coverage=!0,c.coverageSkipTestFiles=o?.coverageSkipTestFiles??!0,c.coverageReporter=o?.coverageReporter??t,c.coverageDir=o?.coverageDir??`coverage`,c.coveragePathIgnorePatterns=p,f&&(c.coverageThreshold=d),o?.coverageIgnoreSourcemaps!==void 0&&(c.coverageIgnoreSourcemaps=o.coverageIgnoreSourcemaps),c}function C(e={}){return{test:S(e)}}function w(e={}){return C(e)}function T(e={}){return C({...e,coverageThresholds:u,extraCoverageIgnorePatterns:[...i,...e.extraCoverageIgnorePatterns??[]]})}function E(e={}){return T(e)}function D(e={}){return C({...e,coverageThresholds:d,extraCoverageIgnorePatterns:[...i,...e.extraCoverageIgnorePatterns??[]]})}function O(e={}){return D(e)}const k=[`**/types.ts`,`**/index.ts`,`**/constants.ts`,`src/index.ts`];function A(e={}){return C({...e,coverageThresholds:f,extraCoverageIgnorePatterns:[...k,...e.extraCoverageIgnorePatterns??[]]})}function j(e={}){return A(e)}function M(e={}){return C({...e,coverageThresholds:p,extraCoverageIgnorePatterns:[...k,...e.extraCoverageIgnorePatterns??[]]})}function N(e={}){return M(e)}function P(e={}){return C({...e,coverageThresholds:m,extraCoverageIgnorePatterns:[...k,...e.extraCoverageIgnorePatterns??[]]})}function F(e={}){return P(e)}function I(e={}){return C({...e,coverageThresholds:h,extraCoverageIgnorePatterns:[...s,...e.extraCoverageIgnorePatterns??[]]})}function L(e={}){return I(e)}function R(e={}){return C({...e,coverageThresholds:g,extraCoverageIgnorePatterns:[...l,...e.extraCoverageIgnorePatterns??[]]})}function z(e={}){return R(e)}function B(e={}){return C({...e,coverageThresholds:_,extraCoverageIgnorePatterns:[...l,...e.extraCoverageIgnorePatterns??[]]})}function V(e={}){return B(e)}function H(e={}){return C({...e,coverageThresholds:v,extraCoverageIgnorePatterns:[...s,...e.extraCoverageIgnorePatterns??[]]})}function U(e={}){return H(e)}function W(e={}){return C({...e,enableCoverage:!1,test:{passWithNoTests:!0,...e.test}})}function G(e={}){return W(e)}const K=e=>e;export{v as CLI_COVERAGE_THRESHOLDS,o as CLI_MINIMAL_EXEMPTION_PATTERNS,o as SERVER_MINIMAL_EXEMPTION_PATTERNS,s as CLI_MODERATE_EXEMPTION_PATTERNS,s as SERVER_MODERATE_EXEMPTION_PATTERNS,n as DEFAULT_COVERAGE_DIR,e as DEFAULT_COVERAGE_IGNORE_PATTERNS,t as DEFAULT_COVERAGE_REPORTERS,r as DEFAULT_INCLUDE_PATTERNS,_ as DESKTOP_COVERAGE_THRESHOLDS,c as DESKTOP_MINIMAL_EXEMPTION_PATTERNS,c as WEB_MINIMAL_EXEMPTION_PATTERNS,l as DESKTOP_MODERATE_EXEMPTION_PATTERNS,l as WEB_MODERATE_EXEMPTION_PATTERNS,u as DOMAIN_COVERAGE_THRESHOLDS,i as DOMAIN_MINIMAL_EXEMPTION_PATTERNS,a as DOMAIN_MODERATE_EXEMPTION_PATTERNS,d as IMPLEMENTATION_COVERAGE_THRESHOLDS,f as PACKAGE_CORE_COVERAGE_THRESHOLDS,m as PACKAGE_SDK_COVERAGE_THRESHOLDS,p as PACKAGE_SHARED_COVERAGE_THRESHOLDS,h as SERVER_COVERAGE_THRESHOLDS,y as TYPE_ONLY_COVERAGE_THRESHOLDS,g as WEB_COVERAGE_THRESHOLDS,C as createBaseBunConfig,H as createCliBunConfig,B as createDesktopBunConfig,T as createDomainBunConfig,D as createImplementationBunConfig,A as createPackageCoreBunConfig,P as createPackageSdkBunConfig,M as createPackageSharedBunConfig,I as createServerBunConfig,W as createTypeOnlyBunConfig,R as createWebBunConfig,w as defineBunConfig,U as defineCliBunConfig,K as defineConfig,V as defineDesktopBunConfig,E as defineDomainBunConfig,O as defineImplementationBunConfig,j as definePackageCoreBunConfig,F as definePackageSdkBunConfig,N as definePackageSharedBunConfig,L as defineServerBunConfig,G as defineTypeOnlyBunConfig,z as defineWebBunConfig};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longzai-intelligence-bun/config",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Longzai Intelligence bun 工具配置类型定义",
   "license": "UNLICENSED",
   "files": [