@longzai-intelligence-tsconfig/config 0.0.0-stage → 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,101 @@
+import "./rolldown-runtime-BqT_7tdF.js";
+//#region src/types.d.ts
+/**
+ * 单一 tsconfig 豁免声明
+ *
+ * 对应 ADR 0050 场景——docs 类特殊站允许单一 tsconfig，豁免四件套与 references 判据
+ */
+type SingleTsconfigExemption = {
+  /**
+   * 豁免依据
+   *
+   * 须引用 ADR 或用户裁定出处，如 `ADR 0050`
+   */
+  reason: string;
+};
+/**
+ * 单包覆写声明
+ */
+type PackageOverride = {
+  /**
+   * app 片应 extends 的预设名
+   *
+   * 如 `library`、`react`、`elysia`，对应共享配置包 `presets/<名>.json`
+   *
+   * @default 不声明时仅校验 extends 合法性，不做包型比对
+   */
+  appPreset?: string;
+  /**
+   * 单一 tsconfig 豁免声明
+   */
+  singleTsconfig?: SingleTsconfigExemption;
+};
+/**
+ * lzi-tsconfig 就地配置
+ */
+type LziTsconfigConfig = {
+  /**
+   * 逐包覆写表
+   *
+   * key 为单元相对仓根路径，如 `packages/core`
+   */
+  packages?: Record<string, PackageOverride>;
+  /**
+   * 禁检单元路径表
+   *
+   * 精确匹配单元相对路径，如 `e2e/fixtures`
+   */
+  exclude?: string[];
+};
+//#endregion
+//#region src/define-config.config.d.ts
+/**
+ * lzi-tsconfig 配置工厂
+ *
+ * 纯类型透传，运行时无副作用原样返回，为配置文件提供类型推导与形态收口
+ *
+ * @param config - 使用方就地配置对象
+ * @returns 原样返回的配置对象
+ */
+declare function defineConfig(config: LziTsconfigConfig): LziTsconfigConfig;
+//#endregion
+//#region src/config-template.utils.d.ts
+/**
+ * 构建配置文件模板内容
+ *
+ * 供 `lzi-tsconfig init` 写盘与 `--dry-run` 预览共用，注释遵循配置文件治理规范
+ *
+ * @returns 配置文件全文
+ */
+declare function buildConfigFileContent(): string;
+//#endregion
+//#region src/config-loader.utils.d.ts
+/**
+ * 就地配置文件名
+ */
+declare const CONFIG_FILE_NAME = "lzi-tsconfig.config.ts";
+/**
+ * 装载结果
+ */
+type LoadedConfig = {
+  /**
+   * 解析后的配置对象
+   */
+  config: LziTsconfigConfig;
+  /**
+   * 配置文件绝对路径
+   */
+  path: string;
+};
+/**
+ * 装载就地配置
+ *
+ * 从目标仓根读取 `lzi-tsconfig.config.ts` 并取默认导出，文件不存在时返回 `null` 由调用方按零配置继续
+ *
+ * @param rootDir - 目标仓根目录
+ * @returns 装载结果，文件不存在时为 `null`
+ * @throws {@link Error} 配置文件默认导出缺失或形态不合规时抛出
+ */
+declare function loadConfig(rootDir: string): Promise<LoadedConfig | null>;
+//#endregion
+export { CONFIG_FILE_NAME, type LoadedConfig, type LziTsconfigConfig, type PackageOverride, type SingleTsconfigExemption, buildConfigFileContent, defineConfig, loadConfig };

package/dist/index.js

@@ -0,0 +1,9 @@
+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';
+
+/**
+ * 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};

package/dist/rolldown-runtime-BqT_7tdF.js

@@ -0,0 +1 @@
+import"node:module";export{};

package/package.json

@@ -1,6 +1,37 @@
 {
   "name": "@longzai-intelligence-tsconfig/config",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.1",
+  "private": false,
+  "description": "Longzai Intelligence tsconfig 形态门禁配置契约",
+  "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": {
+    "jiti": "^2.6.0"
+  }
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.