@longzai-intelligence-debts/config 0.0.0-stage → 0.0.3

package/dist/index.d.ts

@@ -0,0 +1,226 @@
+import "./rolldown-runtime-BqT_7tdF.js";
+import * as z from "zod";
+/**
+ * scope key 合法形态
+ *
+ * @remarks
+ *   kebab-case，小写字母开头，仅小写字母、数字与连字符
+ */
+declare const SCOPE_KEY_PATTERN: RegExp;
+/**
+ * init 缺省注册表目录
+ *
+ * @default docs/debts
+ */
+declare const DEFAULT_REGISTRY_DIR = "docs/debts";
+/**
+ * 棘轮基线条目 schema
+ *
+ * @remarks
+ *   存量豁免逐条带理由登记，存量不追溯，豁免面只许缩短
+ */
+declare const baselineEntrySchema: z.ZodObject<{
+  file: z.ZodString;
+  rule: z.ZodString;
+  reason: z.ZodString;
+}, z.core.$strip>;
+/**
+ * scope 注册条目 schema
+ */
+declare const scopeSchema: z.ZodObject<{
+  key: z.ZodString;
+  title: z.ZodString;
+  paths: z.ZodArray<z.ZodString>;
+  registryDir: z.ZodString;
+}, z.core.$strip>;
+/**
+ * scope 注册条目书写形态
+ */
+type ScopeEntryInput = z.input<typeof scopeSchema>;
+/**
+ * scope 注册条目解析后形态
+ */
+type ScopeEntry = z.output<typeof scopeSchema>;
+/**
+ * lzi-debts 配置根 schema
+ *
+ * @remarks
+ *   scopes 与 lint 均可整体省略，零参 `defineConfig()` 书写形态下由解析层
+ *   落定缺省单 scope 与空基线
+ */
+declare const lziDebtsConfigSchema: z.ZodObject<{
+  scopes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    key: z.ZodString;
+    title: z.ZodString;
+    paths: z.ZodArray<z.ZodString>;
+    registryDir: z.ZodString;
+  }, z.core.$strip>>>;
+  lint: z.ZodDefault<z.ZodObject<{
+    baseline: z.ZodDefault<z.ZodArray<z.ZodObject<{
+      file: z.ZodString;
+      rule: z.ZodString;
+      reason: z.ZodString;
+    }, z.core.$strip>>>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * lzi-debts 配置用户书写形态
+ *
+ * @remarks
+ *   可省略各默认值
+ */
+type LziDebtsConfigInput = z.input<typeof lziDebtsConfigSchema>;
+/**
+ * lzi-debts 配置解析后形态
+ *
+ * @remarks
+ *   默认值全部落定
+ */
+type LziDebtsConfig = z.output<typeof lziDebtsConfigSchema>;
+/**
+ * 棘轮基线条目
+ */
+type LintBaselineEntry = z.infer<typeof baselineEntrySchema>;
+/**
+ * 解析并校验配置
+ *
+ * @param input - 配置原始对象，即 `defineConfig` 产物
+ * @returns 默认值落定的配置
+ * @throws {@link Error} 形态违规，消息聚合全部违规项。跨条目语义校验由
+ * `validateLziDebtsConfig` 在加载链路上追加执行
+ */
+declare function parseLziDebtsConfig(input: unknown): LziDebtsConfig;
+/**
+ * 定义 lzi-debts 配置的 identity 工厂
+ *
+ * @remarks
+ *   类型透传，与 `lzi-dev.config.ts` 等 workspace 配置惯例同构，不在工厂层
+ *   做任何合并，默认值由本模块 schema 解析层统一落定
+ * @param config - 配置对象，可整体省略，零参形态由解析层落定全部缺省
+ * @returns 原样返回传入的配置对象
+ */
+declare function defineConfig(config?: LziDebtsConfigInput): LziDebtsConfigInput;
+/**
+ * 配置来源类型
+ */
+type LziDebtsConfigSource = 'standalone' | 'unified' | 'explicit';
+/**
+ * 加载成功结果
+ */
+type LoadLziDebtsConfigSuccess = {
+  /**
+   * 加载成功标记
+   */
+  ok: true;
+  /**
+   * 解析并校验后的配置
+   *
+   * @remarks
+   *   默认值全部落定
+   */
+  config: LziDebtsConfig;
+  /**
+   * 命中的配置文件绝对路径
+   */
+  configFilePath: string;
+  /**
+   * 配置来源
+   */
+  source: LziDebtsConfigSource;
+};
+/**
+ * 加载失败结果
+ */
+type LoadLziDebtsConfigFailure = {
+  /**
+   * 加载成功标记
+   */
+  ok: false;
+  /**
+   * 失败原因
+   */
+  reason: string;
+};
+/**
+ * 加载结果
+ */
+type LoadLziDebtsConfigResult = LoadLziDebtsConfigSuccess | LoadLziDebtsConfigFailure;
+/**
+ * 加载选项
+ */
+type LoadLziDebtsConfigOptions = {
+  /**
+   * 查找起点目录
+   *
+   * @default process.cwd()
+   */
+  cwd?: string;
+  /**
+   * 显式配置文件路径
+   *
+   * @remarks
+   *   优先级最高，绕过向上查找
+   */
+  configPath?: string;
+};
+/**
+ * 加载 lzi-debts 配置
+ *
+ * @param options - 加载选项
+ * @returns 加载结果。命中返回解析后配置，未找到返回失败，显式路径不存在也按失败处理
+ * @throws {@link Error} 命中配置但形态或跨条目非法，加载即失败语义
+ */
+declare function loadLziDebtsConfig(options?: LoadLziDebtsConfigOptions): Promise<LoadLziDebtsConfigResult>;
+/**
+ * 按显式文件 URL 动态导入配置模块
+ *
+ * @param configPath - 配置文件绝对路径
+ * @returns 配置模块 default 导出
+ * @throws {@link Error} 导入失败或无 default 导出
+ */
+declare function importConfigModule(configPath: string): Promise<unknown>;
+/**
+ * lzi-debts 配置脚手架渲染
+ *
+ * init 命令落盘用，渲染 `lzi-debts.config.ts` 全文即单 scope 起步形态。
+ * 幂等不覆盖由命令层守卫
+ */
+/**
+ * 脚手架渲染入参
+ */
+type ConfigScaffoldInput = {
+  /**
+   * scope key
+   *
+   * @remarks
+   *   kebab-case
+   */
+  scopeKey: string;
+  /**
+   * scope 人类可读名
+   */
+  scopeTitle: string;
+  /**
+   * 注册表目录
+   *
+   * @remarks
+   *   posix 相对仓库根
+   */
+  registryDir: string;
+};
+/**
+ * 渲染 lzi-debts.config.ts 脚手架全文
+ *
+ * @param input - 脚手架入参
+ * @returns 可直接落盘的配置文件全文
+ */
+declare function renderConfigScaffold(input: ConfigScaffoldInput): string;
+/**
+ * 校验并透传配置
+ *
+ * @param config - 形态解析后的配置
+ * @returns 原样透传，校验通过
+ * @throws {@link Error} 跨条目语义违规，消息聚合全部违规项
+ */
+declare function validateLziDebtsConfig(config: LziDebtsConfig): LziDebtsConfig;
+export { ConfigScaffoldInput, DEFAULT_REGISTRY_DIR, LintBaselineEntry, LoadLziDebtsConfigFailure, LoadLziDebtsConfigOptions, LoadLziDebtsConfigResult, LoadLziDebtsConfigSuccess, LziDebtsConfig, LziDebtsConfigInput, LziDebtsConfigSource, SCOPE_KEY_PATTERN, ScopeEntry, ScopeEntryInput, baselineEntrySchema, defineConfig, importConfigModule, loadLziDebtsConfig, lziDebtsConfigSchema, parseLziDebtsConfig, renderConfigScaffold, validateLziDebtsConfig };

package/dist/index.js

@@ -0,0 +1,2 @@
+import"./rolldown-runtime-BqT_7tdF.js";import{ensureError as e}from"@longzai-intelligence-error/utils";import{loadUnifiedConfig as t}from"@longzai-intelligence-shared-config/core";import{existsSync as n}from"node:fs";import{resolve as r}from"node:path";import{pathToFileURL as i}from"node:url";import*as a from"zod";const o=/^[a-z][a-z0-9-]*$/,s=`docs/debts`,c=a.object({file:a.string().min(1),rule:a.string().min(1),reason:a.string().min(1)}),l=a.object({key:a.string().regex(o),title:a.string().min(1),paths:a.array(a.string().min(1)).min(1),registryDir:a.string().min(1)}),u=a.object({baseline:a.array(c).default([])}),d=a.object({scopes:a.array(l).min(1).default([{key:`root`,title:`全局`,paths:[`.`],registryDir:s}]),lint:u.default({baseline:[]})});function f(e){let t=d.safeParse(e);if(!t.success){let e=t.error.issues.map(e=>`${e.path.join(`.`)}: ${e.message}`).join(`，`);throw Error(`lzi-debts 配置形态非法：${e}`)}return t.data}function p(e={}){return e}function m(e){let t=[],n=/* @__PURE__ */ new Map;for(let t of e.scopes)n.set(t.key,(n.get(t.key)??0)+1);for(let[e,r]of n)r>1&&t.push(`scopes: key「${e}」重复登记 ${r} 次，scope key 必须唯一`);let r=/* @__PURE__ */ new Map;for(let t of e.scopes){let e=r.get(t.registryDir)??[];e.push(t.key),r.set(t.registryDir,e)}for(let[e,n]of r)n.length>1&&t.push(`scopes: 注册表目录「${e}」被 ${n.join(`、`)} 共用，一目录一 scope，否则取号与 lint 歧义`);for(let n of e.lint.baseline)e.scopes.some(e=>n.file===e.registryDir||n.file.startsWith(`${e.registryDir}/`))||t.push(`lint.baseline: 豁免条目「${n.file}」规则为 ${n.rule}，不在任何 scope 注册表目录内`);if(t.length>0)throw Error(`lzi-debts 配置跨条目语义非法：${t.join(`，`)}`);return e}function h(t,n){try{return m(f(t))}catch(t){let r=e(t).message;throw Error(`${r}，配置文件：${n}`)}}async function g(e={}){if(e.configPath!==void 0){let t=r(e.cwd??process.cwd(),e.configPath);return n(t)?{ok:!0,config:h(await _(t),t),configFilePath:t,source:`explicit`}:{ok:!1,reason:`未找到配置文件：${t}`}}let i=await t({standaloneFile:`lzi-debts.config.ts`,unifiedField:`debts`,cwd:e.cwd});return i.success?{ok:!0,config:h(i.config,i.configFilePath),configFilePath:i.configFilePath,source:i.source}:{ok:!1,reason:`未找到 lzi-debts.config.ts，且 lzi.config.ts 无 debts 字段，可先执行 lzi-debts init`}}async function _(e){let t=await import(i(e).href);if(t.default===void 0)throw Error(`配置文件缺少 default 导出：${e}`);return t.default}function v(e){return[`import { defineConfig } from '@longzai-intelligence-debts/config';`,``,`/**`,` * lzi-debts 配置`,` */`,`export default defineConfig({`,`  scopes: [`,`    { key: '${e.scopeKey}', title: '${e.scopeTitle}', paths: ['.'], registryDir: '${e.registryDir}' },`,`  ],`,`});`,``].join(`
+`)}export{s as DEFAULT_REGISTRY_DIR,o as SCOPE_KEY_PATTERN,c as baselineEntrySchema,p as defineConfig,_ as importConfigModule,g as loadLziDebtsConfig,d as lziDebtsConfigSchema,f as parseLziDebtsConfig,v as renderConfigScaffold,m as validateLziDebtsConfig};

package/dist/rolldown-runtime-BqT_7tdF.js

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

package/package.json

@@ -1,6 +1,46 @@
 {
   "name": "@longzai-intelligence-debts/config",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.3",
+  "description": "Longzai Intelligence Debts 配置",
+  "keywords": [
+    "config",
+    "debts",
+    "longzai-intelligence",
+    "schema"
+  ],
+  "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": "lzi-lint lint",
+    "lint:fix": "lzi-lint fix",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "test:coverage": "bun test --coverage"
+  },
+  "dependencies": {
+    "@longzai-intelligence-error/utils": "^0.2.0",
+    "@longzai-intelligence-shared-config/core": "^0.0.5",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/bun": "latest"
+  }
+}

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.