@longzai-intelligence-kol-markdown/config 0.0.1 → 0.0.2

package/dist/index.d.ts

@@ -14,10 +14,13 @@ type KolMarkdownConfig = z.infer<typeof KolMarkdownConfigSchema>;
 /**
  * 配置工厂：类型收口 + 便于 IDE 推导（全局 ADR 0097 决策 2 defineXXX 收口）
  *
- * @param config - 配置对象
+ * 缺省零参调用＝就地自指 dataRoot '.'（数据根绝对主流用法收进工厂默认，对齐
+ * lzi-kol config 包先例；配置文件不放数据根时显式传参覆盖）
+ *
+ * @param config - 配置对象（缺省 { dataRoot: '.' } 就地自指）
  * @returns 原样返回（运行时校验由加载方执行，此处 identity 语义）
  */
-declare function defineConfig(config: KolMarkdownConfig): KolMarkdownConfig;
+declare function defineConfig(config?: KolMarkdownConfig): KolMarkdownConfig;
 //#endregion
 //#region src/loader.utils.d.ts
 /**
@@ -44,7 +47,9 @@ declare function loadKolMarkdownConfig(explicitPath?: string): Promise<ConfigLoa
  * 配置骨架生成（config init 与数据仓 init 脚手架共用）
  *
  * defineConfig 工厂导出形态（全局 ADR 0097 决策 2 defineXXX 收口；裸对象过渡形态
- * 废止，参照仓 github-markdown ADR 0009 配方）。骨架依赖目标目录已安装 config 包
+ * 废止，参照仓 github-markdown ADR 0009 配方）。零参调用为标准形态＝dataRoot '.'
+ * 就地自指工厂默认（用户裁定 2026-09-30 家族统一 defineConfig() 零参；对齐 lzi-kol
+ * config 包先例）。骨架依赖目标目录已安装 config 包
  * （`@longzai-intelligence-kol-markdown/config`）——未安装处生成文件不可加载（依赖
  * 就绪门，ADR 0100 先例）。结构仅 dataRoot 单字段（禁 version——代际由包 npm 版本
  * 承载；台账导出根属跨项目路径，走 .env 不进配置文件，全局 ADR 0097 决策 5）。
@@ -56,14 +61,14 @@ declare function loadKolMarkdownConfig(explicitPath?: string): Promise<ConfigLoa
  */
 type ScaffoldParams = {
   /**
-   * 数据根（缺省 '.'，即就地配置：配置文件放在数据根时自指）
+   * 数据根（缺省 '.' 即零参标准形态；显式覆盖仅用于配置文件不放数据根的场景）
    */
   readonly dataRoot?: string;
 };
 /**
- * 生成配置骨架文本（defineConfig 工厂导出）
+ * 生成配置骨架文本（defineConfig 工厂零参标准形态导出）
  *
- * @param params - 骨架入参（dataRoot 可选覆盖）
+ * @param params - 骨架入参（dataRoot 可选覆盖；缺省即零参形态）
  * @returns lzi-kol-markdown.config.ts 全文
  */
 declare function scaffoldConfigText(params?: ScaffoldParams): string;

package/dist/index.js

@@ -1,2 +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(`
+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={dataRoot:`.`}){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';`,``,e.dataRoot===void 0||e.dataRoot===`.`?`export default defineConfig();`:`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

@@ -1,6 +1,6 @@
 {
   "name": "@longzai-intelligence-kol-markdown/config",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Longzai Intelligence KOL Markdown config - lzi-kol-markdown.config.ts 结构真源与加载器",
   "license": "UNLICENSED",
   "files": [