@longzai-intelligence-kol-markdown/config 0.0.1

package/README.md

@@ -0,0 +1,3 @@
+# @longzai-intelligence-kol-markdown/config
+
+lzi-kol-markdown.config.ts 结构真源与加载器：KolMarkdownConfigSchema（version/dataRoot/kolSlug/contentsExportDir）、发现/动态 import/校验/相对路径绝对化（ConfigKit）、骨架生成（config init 与数据仓 init 共用）。

package/dist/index.d.ts

@@ -0,0 +1,71 @@
+import * as z from "zod";
+import { ConfigLoadError, ConfigLoadOk, ConfigLoadResult } from "@longzai-intelligence-markdown/data-engine";
+//#region src/kol-markdown-config.schema.d.ts
+/**
+ * 配置结构（lzi-kol-markdown.config.ts 默认导出形态）
+ */
+declare const KolMarkdownConfigSchema: z.ZodObject<{
+  dataRoot: z.ZodString;
+}, z.core.$strict>;
+/**
+ * 配置类型（schema 推断）
+ */
+type KolMarkdownConfig = z.infer<typeof KolMarkdownConfigSchema>;
+/**
+ * 配置工厂：类型收口 + 便于 IDE 推导（全局 ADR 0097 决策 2 defineXXX 收口）
+ *
+ * @param config - 配置对象
+ * @returns 原样返回（运行时校验由加载方执行，此处 identity 语义）
+ */
+declare function defineConfig(config: KolMarkdownConfig): KolMarkdownConfig;
+//#endregion
+//#region src/loader.utils.d.ts
+/**
+ * 配置文件约定名（全局 ADR 0090：就地配置一律以工具命名，与 bin/env 前缀三同源）
+ */
+declare const CONFIG_FILENAME = "lzi-kol-markdown.config.ts";
+/**
+ * 自 cwd 向上查找配置文件（最多 5 级；显式路径存在则直接采用）
+ *
+ * @param explicitPath - 显式指定的配置文件路径（可选）
+ * @returns 命中的绝对路径；未命中为 undefined
+ */
+declare function discoverConfigPath(explicitPath?: string): string | undefined;
+/**
+ * 加载并校验配置（相对路径以配置文件所在目录为基准绝对化）
+ *
+ * @param explicitPath - 显式指定的配置文件路径（可选；缺省走向上发现）
+ * @returns 成功为绝对路径形态配置与文件路径；失败为可读错误（未找到＝配置文件必备违规）
+ */
+declare function loadKolMarkdownConfig(explicitPath?: string): Promise<ConfigLoadResult<KolMarkdownConfig>>;
+//#endregion
+//#region src/scaffold.utils.d.ts
+/**
+ * 配置骨架生成（config init 与数据仓 init 脚手架共用）
+ *
+ * defineConfig 工厂导出形态（全局 ADR 0097 决策 2 defineXXX 收口；裸对象过渡形态
+ * 废止，参照仓 github-markdown ADR 0009 配方）。骨架依赖目标目录已安装 config 包
+ * （`@longzai-intelligence-kol-markdown/config`）——未安装处生成文件不可加载（依赖
+ * 就绪门，ADR 0100 先例）。结构仅 dataRoot 单字段（禁 version——代际由包 npm 版本
+ * 承载；台账导出根属跨项目路径，走 .env 不进配置文件，全局 ADR 0097 决策 5）。
+ * 引擎 ScaffoldTemplate 仅承载裸字面量导出形态，define 工厂包装属域形态，本模块
+ * 自持文本生成（非引擎能力分叉）。
+ */
+/**
+ * 骨架入参
+ */
+type ScaffoldParams = {
+  /**
+   * 数据根（缺省 '.'，即就地配置：配置文件放在数据根时自指）
+   */
+  readonly dataRoot?: string;
+};
+/**
+ * 生成配置骨架文本（defineConfig 工厂导出）
+ *
+ * @param params - 骨架入参（dataRoot 可选覆盖）
+ * @returns lzi-kol-markdown.config.ts 全文
+ */
+declare function scaffoldConfigText(params?: ScaffoldParams): string;
+//#endregion
+export { CONFIG_FILENAME, type ConfigLoadError, type ConfigLoadOk, type ConfigLoadResult, KolMarkdownConfig, KolMarkdownConfigSchema, ScaffoldParams, defineConfig, discoverConfigPath, loadKolMarkdownConfig, scaffoldConfigText };

package/dist/index.js

@@ -0,0 +1,2 @@
+import*as e from"zod";import{createConfigKit as t}from"@longzai-intelligence-markdown/data-engine";import{resolve as n}from"node:path";const r=e.strictObject({dataRoot:e.string().min(1)});function i(e){return e}const a=`lzi-kol-markdown.config.ts`,o=t({configFilename:a,schema:r,shapeHint:`dataRoot 单字段（禁 version，代际由包 npm 版本承载；台账导出根走 .env 的 LZI_KOL_MARKDOWN_CONTENTS_EXPORT_DIR）`,absolutize:(e,t)=>({...e,dataRoot:n(t,e.dataRoot)})});function s(e){return o.discoverConfigPath(e)}async function c(e){let t=await o.loadConfig(e);return!t.ok&&t.error.code===`CONFIG_NOT_FOUND`?{ok:!1,error:{code:t.error.code,message:`配置文件必备（全局 ADR 0097 决策 9）：未找到 ${a}（自 cwd 向上最多 5 级发现，或 --config 显式指定）；配置文件不得缺失，.env 不作整体替代——.env 仅承载跨项目路径 LZI_KOL_MARKDOWN_CONTENTS_EXPORT_DIR`}}:t}function l(e={}){return[`// lzi-kol-markdown 就地配置（以工具命名，全局 ADR 0090；defineConfig 工厂收口，全局 ADR 0097 决策 2）。`,`// 相对路径以本文件所在目录为基准——放在数据根时 dataRoot 用 "." 即就地自指。`,`// 台账导出根走 .env 的 LZI_KOL_MARKDOWN_CONTENTS_EXPORT_DIR（跨项目路径零进入库配置，全局 ADR 0097 决策 5）。`,`import { defineConfig } from '@longzai-intelligence-kol-markdown/config';`,``,`export default defineConfig({`,`  dataRoot: '${e.dataRoot??`.`}',`,`});`,``].join(`
+`)}export{a as CONFIG_FILENAME,r as KolMarkdownConfigSchema,i as defineConfig,s as discoverConfigPath,c as loadKolMarkdownConfig,l as scaffoldConfigText};

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@longzai-intelligence-kol-markdown/config",
+  "version": "0.0.1",
+  "description": "Longzai Intelligence KOL Markdown config - lzi-kol-markdown.config.ts 结构真源与加载器",
+  "license": "UNLICENSED",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "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": "lzi-bun-cli test",
+    "test:watch": "lzi-bun-cli test --watch",
+    "test:coverage": "lzi-bun-cli test --coverage",
+    "clean": "lzi-dev-cli clean"
+  },
+  "dependencies": {
+    "@longzai-intelligence-markdown/data-engine": "^0.0.1",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.14"
+  }
+}