@longzai-intelligence-tsconfig/config 0.0.1 → 0.0.3

package/dist/index.d.ts

@@ -13,16 +13,27 @@ type SingleTsconfigExemption = {
    */
   reason: string;
 };
+/**
+ * 模块根 paths 豁免声明
+ *
+ * 对应根溶液保留 `compilerOptions.paths` 承担全仓 IDE 解析的裁量形态，登记后模块根文件跳过 R7 判定
+ */
+type ModuleRootPathsExemption = {
+  /**
+   * 豁免依据
+   *
+   * 须引用 ADR 或用户裁定出处，如 `ADR 0008 裁量保留`
+   */
+  reason: string;
+};
 /**
  * 单包覆写声明
  */
 type PackageOverride = {
   /**
-   * app 片应 extends 的预设名
-   *
-   * 如 `library`、`react`、`elysia`，对应共享配置包 `presets/<名>.json`
+   * app 片包型覆写
    *
-   * @default 不声明时仅校验 extends 合法性，不做包型比对
+   * 包型默认按依赖自动推断（如 `react`、`elysia`、`next`，无框架依赖默认 `library`），仅推断误判或特异预设（如 decorator 变体）时覆写
    */
   appPreset?: string;
   /**
@@ -46,24 +57,30 @@ type LziTsconfigConfig = {
    * 精确匹配单元相对路径，如 `e2e/fixtures`
    */
   exclude?: string[];
+  /**
+   * 模块根 paths 豁免声明
+   *
+   * 登记后模块根溶液与根 node 片跳过 R7 判定，子包单元的跨包 paths 不适用本豁免
+   */
+  moduleRootPaths?: ModuleRootPathsExemption;
 };
 //#endregion
 //#region src/define-config.config.d.ts
 /**
  * lzi-tsconfig 配置工厂
  *
- * 纯类型透传，运行时无副作用原样返回，为配置文件提供类型推导与形态收口
+ * 参数可选、零参返回空默认配置——消费仓无仓库特有事实时 `defineConfig()` 一行即接入，开箱即用；有参时纯类型透传原样返回，为配置文件提供类型推导与形态收口
  *
- * @param config - 使用方就地配置对象
- * @returns 原样返回的配置对象
+ * @param config - 使用方就地配置对象，省略时取空配置
+ * @returns 配置对象，省略入参时为空对象
  */
-declare function defineConfig(config: LziTsconfigConfig): LziTsconfigConfig;
+declare function defineConfig(config?: LziTsconfigConfig): LziTsconfigConfig;
 //#endregion
 //#region src/config-template.utils.d.ts
 /**
  * 构建配置文件模板内容
  *
- * 供 `lzi-tsconfig init` 写盘与 `--dry-run` 预览共用，注释遵循配置文件治理规范
+ * 供 `lzi-tsconfig init` 写盘与 `--dry-run` 预览共用，零参开箱即用形态，注释遵循配置文件治理规范
  *
  * @returns 配置文件全文
  */
@@ -83,18 +100,21 @@ type LoadedConfig = {
    */
   config: LziTsconfigConfig;
   /**
-   * 配置文件绝对路径
+   * 配置来源绝对路径
    */
   path: string;
 };
 /**
  * 装载就地配置
  *
- * 从目标仓根读取 `lzi-tsconfig.config.ts` 并取默认导出，文件不存在时返回 `null` 由调用方按零配置继续
+ * 经 shared-config 的 `loadUnifiedConfig` 统一加载：从目标仓根向上查找
+ * `lzi-tsconfig.config.ts`，回退统一配置 `lzi.config.ts` 的 `tsconfig` 字段，
+ * 命中后随加载执行 zod 结构校验，配置不存在时返回 `null` 由调用方按零配置继续
  *
  * @param rootDir - 目标仓根目录
- * @returns 装载结果，文件不存在时为 `null`
- * @throws {@link Error} 配置文件默认导出缺失或形态不合规时抛出
+ * @returns 装载结果，配置不存在时为 `null`
+ * @throws {@link SharedConfigLoadError} 配置文件加载失败或缺少默认导出时抛出
+ * @throws {@link SharedConfigValidationError} 配置结构校验失败时抛出
  */
 declare function loadConfig(rootDir: string): Promise<LoadedConfig | null>;
 //#endregion

package/dist/index.js

@@ -1,9 +1,7 @@
-import"./rolldown-runtime-BqT_7tdF.js";import{createJiti as e}from"jiti";import{existsSync as t}from"node:fs";import{join as n}from"node:path";function r(e){return e}function i(){return`import { defineConfig } from '@longzai-intelligence-tsconfig/config';
+import"./rolldown-runtime-BqT_7tdF.js";import{loadUnifiedConfig as e}from"@longzai-intelligence-shared-config/core";import*as t from"zod";function n(e){return e??{}}function r(){return`import { defineConfig } from '@longzai-intelligence-tsconfig/config';
 
 /**
  * lzi-tsconfig 配置
  */
-export default defineConfig({
-  packages: {},
-});
-`}const a=`lzi-tsconfig.config.ts`;function o(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function s(e){if(!o(e))return!1;if(e.packages!==void 0){if(!o(e.packages))return!1;for(let t of Object.values(e.packages)){if(!o(t))return!1;let e=t.appPreset;if(e!==void 0&&typeof e!=`string`)return!1;let n=t.singleTsconfig;if(n!==void 0){if(!o(n))return!1;let e=n.reason;if(typeof e!=`string`||e.length===0)return!1}}}return e.exclude===void 0||!!Array.isArray(e.exclude)&&!e.exclude.some(e=>typeof e!=`string`)}async function c(r){let i=n(r,a);if(!t(i))return null;let c=await e(import.meta.url).import(i);if(!o(c))throw Error(`配置模块导出缺失`);let l=c.default;if(!s(l))throw Error(`配置默认导出形态不合规`);return{config:l,path:i}}export{a as CONFIG_FILE_NAME,i as buildConfigFileContent,r as defineConfig,c as loadConfig};
+export default defineConfig();
+`}const i=`lzi-tsconfig.config.ts`,a=t.looseObject({reason:t.string().min(1)}),o=t.looseObject({reason:t.string().min(1)}),s=t.looseObject({appPreset:t.string().optional(),singleTsconfig:a.optional()}),c=t.looseObject({packages:t.record(t.string(),s).optional(),exclude:t.array(t.string()).optional(),moduleRootPaths:o.optional()});async function l(t){let n=await e({cwd:t,standaloneFile:[i,`lzi-tsconfig.config.mts`],unifiedField:`tsconfig`,schema:c});return n.success?{config:n.config,path:n.configFilePath}:null}export{i as CONFIG_FILE_NAME,r as buildConfigFileContent,n as defineConfig,l as loadConfig};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@longzai-intelligence-tsconfig/config",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "private": false,
   "description": "Longzai Intelligence tsconfig 形态门禁配置契约",
   "license": "UNLICENSED",
@@ -32,6 +32,7 @@
     "clean": "lzi-dev-cli clean"
   },
   "dependencies": {
-    "jiti": "^2.6.0"
+    "@longzai-intelligence-shared-config/core": "^0.0.9",
+    "zod": "^4.4.3"
   }
 }