@longzai-intelligence-situation-markdown/config 0.0.0-stage → 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,70 @@
+import * as z from "zod";
+import { ConfigLoadErr, ConfigLoadError, ConfigLoadOk, ConfigLoadResult, ConfigLoadResult as ConfigLoadResult$1 } from "@longzai-intelligence-shared-config/core";
+/**
+ * 配置结构
+ */
+declare const SituationConfigSchema: z.ZodObject<{
+  dataRoot: z.ZodDefault<z.ZodString>;
+  sourceRoot: z.ZodString;
+}, z.core.$strip>;
+/**
+ * 配置类型（schema 推断）
+ */
+type SituationConfig = z.infer<typeof SituationConfigSchema>;
+/**
+ * 配置工厂：类型收口（identity 语义，运行时校验由加载方执行）；导出名统一为 defineConfig（全局 ADR 0097 决策 2，禁域前缀工厂名）
+ *
+ * @param config - 现状判断工具配置
+ * @returns 原样返回的配置
+ */
+declare function defineConfig(config: SituationConfig): SituationConfig;
+/**
+ * 配置文件约定名
+ *
+ * @remarks
+ *   以工具命名，全局 ADR 0090，与 bin 与 env 前缀三同源
+ */
+declare const CONFIG_FILENAME = "lzi-situation-markdown.config.ts";
+/**
+ * 自 cwd 向上查找配置文件
+ *
+ * @param explicitPath - 显式指定的配置文件路径，可空
+ * @returns 命中的绝对路径，未命中为 undefined
+ */
+declare function discoverConfigPath(explicitPath?: string): string | undefined;
+/**
+ * 加载并校验配置
+ *
+ * @param explicitPath - 显式指定的配置文件路径，可空，缺省走向上发现
+ * @returns 成功为绝对路径形态配置与文件路径，失败为可读错误
+ */
+declare function loadSituationConfig(explicitPath?: string): Promise<ConfigLoadResult$1<SituationConfig>>;
+/**
+ * 配置骨架生成（config init 用）
+ *
+ * defineConfig 工厂导出形态（全局 ADR 0097 决策 2；裸对象过渡形态废止；禁 version——
+ * 代际由包 npm 版本承载）。骨架依赖目标目录已安装 config 包（依赖就绪门，ADR 0100
+ * 先例）。引擎 ScaffoldTemplate 仅承载裸字面量导出形态，define 工厂包装属域形态，
+ * 本模块自持文本生成（非引擎能力分叉）。
+ */
+/**
+ * 骨架入参
+ */
+type ScaffoldParams = {
+  /**
+   * 数据根（缺省 `.` 即就地自指）
+   */
+  readonly dataRoot?: string;
+  /**
+   * 数据源根（域语义由使用方特化）
+   */
+  readonly sourceRoot?: string;
+};
+/**
+ * 生成配置骨架文本（defineConfig 工厂形态导出）
+ *
+ * @param params - 骨架入参
+ * @returns 就地配置全文
+ */
+declare function scaffoldConfigText(params?: ScaffoldParams): string;
+export { CONFIG_FILENAME, type ConfigLoadErr, type ConfigLoadError, type ConfigLoadOk, type ConfigLoadResult, ScaffoldParams, SituationConfig, SituationConfigSchema, defineConfig, discoverConfigPath, loadSituationConfig, scaffoldConfigText };

package/dist/index.js

@@ -0,0 +1,2 @@
+import*as e from"zod";import{createDomainConfigLoader as t}from"@longzai-intelligence-shared-config/core";import{resolve as n}from"node:path";const r=e.object({dataRoot:e.string().min(1).default(`.`),sourceRoot:e.string().min(1)});function i(e){return e}const a=`lzi-situation-markdown.config.ts`,o=()=>t({configFilename:a,schema:r,shapeHint:`defineConfig 收口的 dataRoot 加 sourceRoot，禁 version 字段，代际由包 npm 版本承载`,absolutize:(e,t)=>({...e,dataRoot:n(t,e.dataRoot),sourceRoot:n(t,e.sourceRoot)})});function s(e){return o().discoverConfigPath(e)}function c(e){return o().loadConfig(e)}function l(e={}){let t=[];return e.dataRoot!==void 0&&e.dataRoot!==`.`&&t.push(`dataRoot: '${e.dataRoot}'`),e.sourceRoot!==void 0&&t.push(`sourceRoot: '${e.sourceRoot}'`),[`// lzi-situation-markdown 就地配置（以工具命名，全局 ADR 0090；defineConfig 工厂收口，全局 ADR 0097 决策 2）。`,`// 相对路径以本文件所在目录为基准——放在数据根时工厂默认 dataRoot "."（零参调用即可）。`,`import { defineConfig } from '@longzai-intelligence-situation-markdown/config';`,``,t.length===0?`export default defineConfig();`:`export default defineConfig({ ${t.join(`, `)} });`,``].join(`
+`)}export{a as CONFIG_FILENAME,r as SituationConfigSchema,i as defineConfig,s as discoverConfigPath,c as loadSituationConfig,l as scaffoldConfigText};

package/package.json

@@ -1,6 +1,42 @@
 {
   "name": "@longzai-intelligence-situation-markdown/config",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.1",
+  "description": "Longzai Intelligence 配置包",
+  "keywords": [
+    "config",
+    "longzai-intelligence"
+  ],
+  "license": "UNLICENSED",
+  "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 lzi-builder",
+    "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 test",
+    "test:watch": "lzi-bun test --watch",
+    "test:coverage": "lzi-bun test --coverage",
+    "clean": "lzi-dev-tools clean"
+  },
+  "dependencies": {
+    "@longzai-intelligence-markdown/data-engine": "0.0.6",
+    "@longzai-intelligence-shared-config/core": "0.0.10",
+    "zod": "^4.6.5"
+  },
+  "files": [
+    "dist"
+  ]
+}

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.