@longzai-intelligence-release/config 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,155 @@
+//#region src/types.d.ts
+/**
+ * 发布包清单的双轨形态（ADR 0082：包级自治轨道）
+ *
+ * - 字符串数组（兼容形态）：全部走公网 npm 轨（现状行为不变）
+ * - 对象形态 `{ npm, local }`：轨道必须显式落位——`npm` 走公网 registry， `local` 走本地私有
+ *   registry（longzai-intelligence-npm-registry，地址经 env `LZI_NPM_REGISTRY_URL` 提供，不入库）。私有发布仅因包被显式放入
+ *   `local` 才发生，杜绝「漏标 registry 静默公开发布」的事故面
+ */
+type PublishPackagesConfig = string[] | {
+  /**
+   * 公网 npm 轨的包列表（包名或相对路径）
+   */
+  npm: string[];
+  /**
+   * 本地私有轨的包列表（包名或相对路径）
+   */
+  local: string[];
+};
+/**
+ * 发布配置
+ *
+ * 定义发布相关的配置选项（自 dev-tools 的 PublishConfig 迁入，字段语义不变，ADR 0087）
+ */
+type PublishConfig = {
+  /**
+   * 要发布的包清单（双轨形态，ADR 0082）
+   *
+   * 支持包名（如 '@scope/pkg'）或相对路径（如 'packages/pkg'）
+   * 依赖拓扑顺序从各包 package.json 的 workspace:* 依赖自动推导（跨两轨统一计算）
+   */
+  packages: PublishPackagesConfig;
+  /**
+   * 是否在发布前安装依赖
+   *
+   * @default true
+   */
+  installDeps?: boolean;
+  /**
+   * 是否在发布前构建包
+   *
+   * @default true
+   */
+  buildBeforePublish?: boolean;
+  /**
+   * 是否在发布前清理构建产物
+   *
+   * 清零旧产物后全量重建，避免增量缓存残留导致残缺包发布
+   *
+   * @default true
+   */
+  cleanBeforePublish?: boolean;
+  /**
+   * 发布时使用的访问级别
+   *
+   * @default 'public'
+   */
+  access?: 'public' | 'restricted';
+  /**
+   * 发布前的前置钩子（在 clean 与 installDeps 之后、逐包构建之前执行）
+   *
+   * 以 shell 字符串执行（cwd 为 monorepo 根），非零退出码终止发布。
+   * 典型用途：自举场景——builder 仓库发布时 clean 后 lzi-builder 自身不可用，
+   * 需要先用 tsgo 冷启动构建 lzi-builder 自举闭包，后续逐包构建才能用 lzi-builder。
+   */
+  preBuildHook?: string;
+};
+/**
+ * LziRelease 配置
+ *
+ * 定义 lzi-release.config.ts 配置文件的结构
+ */
+type LziReleaseConfig = {
+  /**
+   * 发布配置（发布域当前唯一的配置节）
+   */
+  publish?: PublishConfig;
+};
+//#endregion
+//#region src/define.config.d.ts
+/**
+ * 定义 LziRelease 配置
+ *
+ * 提供类型推导，用户无需手动 satisfies
+ *
+ * @example
+ *   ```typescript
+ *   import { defineConfig } from '@longzai-intelligence-release/config';
+ *
+ *   export default defineConfig({
+ *     publish: {
+ *       packages: ['apps/cli'],
+ *     },
+ *   });
+ *   ```;
+ *
+ * @param config - LziRelease 配置对象
+ * @returns 原样返回传入的配置对象
+ */
+declare const defineConfig: (config: LziReleaseConfig) => LziReleaseConfig;
+//#endregion
+//#region src/load.config.d.ts
+/**
+ * 新配置来源（lzi-release.config.ts 或统一 lzi.config.ts 的 release 字段）
+ */
+type ReleaseSourceNew = 'release';
+/**
+ * 兼容回退来源（lzi-dev.config.ts 或统一 lzi.config.ts 的 devTools 字段的 publish 字段）
+ */
+type ReleaseSourceLegacy = 'legacy-dev-tools';
+/**
+ * 配置来源
+ */
+type ReleaseConfigSource = ReleaseSourceNew | ReleaseSourceLegacy;
+/**
+ * 配置加载结果
+ */
+type ReleaseConfigResult = {
+  /**
+   * 加载后的发布域配置对象
+   */
+  config: LziReleaseConfig;
+  /**
+   * 命中的配置文件绝对路径（用于推导 monorepo 根目录）
+   */
+  configPath: string;
+  /**
+   * 配置来源（legacy 命中时由调用方输出弃用提示）
+   */
+  source: ReleaseConfigSource;
+};
+/**
+ * 查找配置文件路径
+ *
+ * 优先查找 lzi-release.config.ts，其次 lzi-dev.config.ts（兼容回退），
+ * 均未找到时返回 null
+ *
+ * @returns 配置文件的绝对路径，如果找不到则返回 null
+ */
+declare const findReleaseConfigFile: () => string | null;
+/**
+ * 加载发布配置
+ *
+ * 三级优先（ADR 0087）：
+ *
+ * - lzi-release.config.ts（standalone）> lzi.config.ts 的 release 字段（统一配置）
+ * - 均未命中时兼容回退 lzi-dev.config.ts 的 publish 字段（或 lzi.config.ts 的 devTools 字段）
+ * - 两轨 standalone 均要求存在其一（与 dev-tools 时代行为一致：统一配置不能单独成立）
+ *
+ * @returns 配置加载结果；任一配置文件都不存在时返回 null
+ * @throws {@link Error} 如果配置文件存在但加载失败
+ */
+declare const loadReleaseConfig: () => Promise<ReleaseConfigResult | null>;
+//#endregion
+export { type LziReleaseConfig, type PublishConfig, type PublishPackagesConfig, type ReleaseConfigResult, type ReleaseConfigSource, defineConfig, findReleaseConfigFile, loadReleaseConfig };

package/dist/index.js

@@ -0,0 +1 @@
+import{loadUnifiedConfig as e,resolveStandaloneConfigPath as t}from"@longzai-intelligence-shared-config/core";const n=e=>e,r=`lzi-release.config.ts`,i=`lzi-dev.config.ts`,a=()=>t(r)??t(i),o=async()=>{let t=a();if(!t)return null;let n=await e({standaloneFile:r,unifiedField:`release`});if(n.success)return{config:n.config,configPath:t,source:`release`};let o=await e({standaloneFile:i,unifiedField:`devTools`});return o.success&&o.config.publish!==void 0?{config:{publish:o.config.publish},configPath:t,source:`legacy-dev-tools`}:{config:{},configPath:t,source:`release`}};export{n as defineConfig,a as findReleaseConfigFile,o as loadReleaseConfig};

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@longzai-intelligence-release/config",
+  "version": "0.0.1",
+  "description": "Longzai Intelligence 发布工具配置类型定义与加载器",
+  "license": "UNLICENSED",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "lzi-builder",
+    "build:prod": "NODE_ENV=production bun run build",
+    "prepublishOnly": "bun run build:prod",
+    "typecheck": "bun run typecheck:app && bun run typecheck:node && bun run typecheck:test",
+    "typecheck:app": "lzi-tsgo typecheck tsconfig/app.json",
+    "typecheck:node": "lzi-tsgo typecheck tsconfig/node.json",
+    "typecheck:test": "lzi-tsgo typecheck tsconfig/test.json",
+    "lint": "oxlint && oxfmt --check",
+    "lint:fix": "oxlint --fix && oxfmt",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "test:coverage": "bun test --coverage",
+    "clean": "lzi-dev-cli clean"
+  },
+  "dependencies": {
+    "@longzai-intelligence-shared-config/core": "^0.0.5"
+  }
+}