@ai-setting/roy-agent-core 1.7.52 → 1.7.55

package/dist/config/config-component.d.ts

@@ -0,0 +1,346 @@
+import { ZodType, ZodTypeDef } from "zod";
+import { BaseComponent, type ComponentSchema, type ComponentWatchCallback } from "../env/component";
+/**
+ * ConfigSource 类型
+ */
+export type ConfigSourceType = "memory" | "file" | "env" | "remote" | "project";
+/**
+ * SourceRegistration - Source 注册配置
+ */
+export interface SourceRegistration {
+    /** Source 类型 */
+    type: ConfigSourceType;
+    /** 相对路径（file 类型使用，基于 XDG_DATA_HOME） */
+    relativePath?: string;
+    /** 环境变量前缀（env 类型使用） */
+    envPrefix?: string;
+    /** 项目根目录（project 类型使用，默认 process.cwd()） */
+    cwd?: string;
+    /** 优先级，默认值：memory=0, file=10, env=20, project=25 */
+    priority?: number;
+    /** 是否可选（file 类型使用，文件不存在时不报错） */
+    optional?: boolean;
+    /** 是否启用文件监听（file 类型使用，默认 true） */
+    watch?: boolean;
+}
+/**
+ * KeyRegistration - 配置 Key 注册
+ */
+export interface KeyRegistration {
+    /** 配置 Key（支持点号嵌套，如 "llm.provider"） */
+    key: string;
+    /** 优先使用的 Source 列表（按优先级从低到高） */
+    sources: ConfigSourceType[];
+    /** 自定义优先级（覆盖默认优先级） */
+    priority?: number;
+    /** 默认值 */
+    default?: unknown;
+}
+/**
+ * ComponentRegistration - Component 注册配置
+ */
+export interface ComponentRegistration {
+    /** Component 名称 */
+    name: string;
+    /** 声明需要的 Source */
+    sources: SourceRegistration[];
+    /** 声明需要的配置 Key */
+    keys: KeyRegistration[];
+    /** 配置 Schema（用于验证，可选） */
+    schema?: ZodType<unknown, ZodTypeDef, unknown>;
+    /** 默认值 */
+    defaults?: Record<string, unknown>;
+}
+/**
+ * 配置源不存在错误
+ */
+export declare class ConfigSourceNotFoundError extends Error {
+    constructor(sourceType: string, path?: string);
+}
+/**
+ * 配置文件不存在错误
+ */
+export declare class ConfigFileNotFoundError extends Error {
+    constructor(filePath: string);
+}
+/**
+ * ConfigSource 接口
+ */
+export interface ConfigSource {
+    readonly name: ConfigSourceType;
+    readonly priority: number;
+    read(key: string): unknown | undefined;
+    write?(key: string, value: unknown): boolean;
+    delete?(key: string): boolean;
+    list(): Array<{
+        key: string;
+        value: unknown;
+    }>;
+    watch?(callback: (event: ConfigChangeEvent) => void): () => void;
+}
+/**
+ * Config 变更事件
+ */
+export interface ConfigChangeEvent {
+    type: "change" | "add" | "delete";
+    key: string;
+    oldValue: unknown;
+    newValue: unknown;
+    source: ConfigSourceType;
+    timestamp: number;
+}
+/**
+ * 异步持久化条目
+ */
+interface PersistEntry {
+    key: string;
+    value: unknown;
+    timestamp: number;
+}
+/**
+ * MemorySource 实现
+ */
+export declare class MemorySource implements ConfigSource {
+    readonly name: ConfigSourceType;
+    readonly priority = 0;
+    private store;
+    private watchers;
+    read(key: string): unknown | undefined;
+    write(key: string, value: unknown): boolean;
+    delete(key: string): boolean;
+    list(): Array<{
+        key: string;
+        value: unknown;
+    }>;
+    watch(callback: (event: ConfigChangeEvent) => void): () => void;
+    private notifyWatchers;
+}
+/**
+ * 异步持久化队列
+ */
+export declare class AsyncPersistQueue {
+    private options;
+    private queue;
+    private timer?;
+    private paused;
+    constructor(options: {
+        debounceMs: number;
+        persistFn: (entries: PersistEntry[]) => Promise<void>;
+    });
+    add(key: string, value: unknown): void;
+    private scheduleFlush;
+    flush(): Promise<void>;
+    clear(): void;
+    size(): number;
+    pause(): void;
+    resume(): void;
+}
+/**
+ * ConfigComponent 配置
+ */
+export interface ConfigComponentOptions {
+    /** 持久化文件路径 */
+    persistFile?: string;
+    /** 防抖延迟（ms） */
+    debounceMs?: number;
+    /** 最大批量大小 */
+    maxBatchSize?: number;
+}
+/**
+ * ConfigComponent
+ */
+export declare class ConfigComponent extends BaseComponent {
+    readonly name = "config";
+    readonly version = "1.0.0";
+    private memorySource;
+    private sources;
+    private componentSchemas;
+    private componentPaths;
+    private watchers;
+    /** Source watch unsubscribe 函数 */
+    private sourceUnwatchFns;
+    private persistQueue;
+    private persistFile?;
+    /** Key 注册表：key -> KeyRegistration */
+    private keyRegistry;
+    /** Component 注册表：name -> ComponentRegistration */
+    private componentRegistrations;
+    /** 协议解析器 */
+    private protocolResolver?;
+    /** XDG_DATA_HOME 缓存（用于测试注入） */
+    private __xdgDataHome?;
+    /** Source 注册配置（延迟创建） */
+    private pendingSources;
+    /** Source 唯一标识缓存：type:relativePath -> true */
+    private sourceKeys;
+    /**
+     * 获取 XDG_DATA_HOME（动态获取，支持运行时覆盖）
+     */
+    getXdgDataHome(): string;
+    /**
+     * 设置 XDG_DATA_HOME（用于测试）
+     */
+    setXdgDataHome(path: string): void;
+    constructor(options?: ConfigComponentOptions);
+    /**
+     * 注册 Component Schema
+     */
+    register(schema: ComponentSchema): void;
+    /**
+     * 注销 Component
+     */
+    unregister(name: string): boolean;
+    /**
+     * 检查是否已注册
+     */
+    isRegistered(name: string): boolean;
+    /**
+     * 列出所有注册的 Component
+     */
+    listComponents(): string[];
+    /**
+     * 获取配置值（支持 xxx.yyy.zzz 嵌套访问）
+     * 支持两种模式：
+     * 1. 完整 key：直接查找，如 "component.key" -> 读取 "component.key"
+     * 2. 嵌套对象：查找 component 对象后从中获取属性，如 "component.nested.deep"
+     *    -> 先找 "component.nested"，再获取其 "deep" 属性
+     */
+    get(key: string): unknown;
+    /**
+     * 批量获取
+     */
+    getMany(keys: string[]): Record<string, unknown>;
+    /**
+     * 设置配置值（内存级别 + 异步持久化）
+     */
+    set(key: string, value: unknown): Promise<void>;
+    /**
+     * 批量设置
+     */
+    setMany(config: Record<string, unknown>): Promise<void>;
+    /**
+     * 获取 Component 的路径
+     */
+    getPath(component: string, subPath?: string): string;
+    /**
+     * 手动持久化
+     */
+    save(key?: string): Promise<void>;
+    /**
+     * 重置到默认值
+     */
+    reset(key: string): Promise<void>;
+    /**
+     * 监听配置变更
+     */
+    watch(pattern: string, callback: ComponentWatchCallback): () => void;
+    /**
+     * 添加配置源
+     */
+    addSource(source: ConfigSource): void;
+    /**
+     * 获取 Source 唯一标识
+     */
+    private getSourceKey;
+    /**
+     * 移除配置源
+     */
+    removeSource(name: ConfigSourceType): boolean;
+    /**
+     * 关闭所有配置源的 watcher（用于优雅退出）
+     */
+    unwatchAll(): void;
+    /**
+     * 释放持久化队列与文件 watcher（CLI 退出时调用）
+     */
+    shutdown(): void;
+    protected onStop(): Promise<void>;
+    /**
+     * 获取配置源列表
+     */
+    getSources(): ConfigSource[];
+    private getNestedValue;
+    private notifyWatchers;
+    private persistToFile;
+    /**
+     * 注册配置 Source
+     *
+     * Source 会在首次 load() 时被创建
+     *
+     * @example
+     * config.registerSource({ type: "file", relativePath: "llm-config.jsonc" });
+     * config.registerSource({ type: "env", envPrefix: "LLM" });
+     */
+    registerSource(registration: SourceRegistration): void;
+    /**
+     * 注册项目级配置 Source（从 `${cwd}/.roy/config.jsonc` 加载）
+     *
+     * 项目级配置优先级高于 env 和全局 file，可在不同项目下设置不同的配置。
+     * 如果文件不存在，静默忽略（不报错）。重复注册同一 cwd 是幂等的。
+     *
+     * @param options.cwd - 项目根目录，默认为 `process.cwd()`
+     * @param options.priority - 优先级，默认 25（高于 env=20、file=10）
+     *
+     * @example
+     * config.registerProjectSource();
+     * config.registerProjectSource({ cwd: "/path/to/project" });
+     */
+    registerProjectSource(options?: {
+        cwd?: string;
+        priority?: number;
+    }): void;
+    /**
+     * 创建 Source 实例
+     */
+    private createSource;
+    /**
+     * 确保所有待创建的 Source 已被创建
+     */
+    private ensureSourcesCreated;
+    /**
+     * 注册配置 Key
+     *
+     * @example
+     * config.registerKeys([
+     *   { key: "llm.provider", sources: ["file", "memory"], default: "openai" },
+     *   { key: "llm.model", sources: ["file"] },
+     * ]);
+     */
+    registerKeys(keys: KeyRegistration[]): void;
+    /**
+     * 注册 Component（一次性注册 Source 和 Keys）
+     *
+     * @example
+     * config.registerComponent({
+     *   name: "llm",
+     *   sources: [
+     *     { type: "file", relativePath: "llm-config.jsonc" },
+     *     { type: "env", envPrefix: "LLM" },
+     *   ],
+     *   keys: [
+     *     { key: "llm.provider", sources: ["file", "env", "memory"] },
+     *   ],
+     * });
+     */
+    registerComponent(registration: ComponentRegistration): void;
+    /**
+     * 按需加载配置
+     *
+     * 从注册的 Source 加载已注册 Keys 的配置值到内存中
+     *
+     * @param componentName - 可选，指定要加载的 Component 名称
+     *
+     * @example
+     * // 加载所有已注册的 Keys
+     * await config.load();
+     *
+     * // 只加载指定 Component 的 Keys
+     * await config.load("llm");
+     */
+    load(componentName?: string): Promise<void>;
+    /**
+     * 获取已注册的 Source 列表
+     */
+    getRegisteredSources(): ConfigSource[];
+}
+export {};

package/dist/config/config-parser.d.ts

@@ -0,0 +1,45 @@
+import { ProtocolResolver } from "./protocol-resolver";
+/**
+ * Parse JSONC (JSON with Comments) content
+ * Supports single-line comments (//) and multi-line comments
+ *
+ * @param content - JSONC content string
+ * @returns Parsed JSON object
+ */
+export declare function parseJSONC(content: string): Record<string, unknown>;
+/**
+ * Substitute environment variables in a value
+ * Supports ${VAR} and ${VAR:-default} syntax
+ *
+ * @param value - Value to substitute (string, object, array, or primitive)
+ * @returns Value with environment variables substituted
+ */
+export declare function substituteEnvVars(value: unknown): unknown;
+/**
+ * Parse JSONC content and substitute environment variables
+ *
+ * @param content - JSONC content string
+ * @returns Parsed JSON object with env vars substituted
+ */
+export declare function parseJSONCWithEnv(content: string): Record<string, unknown>;
+/**
+ * Substitute protocol references in a value using the provided resolver
+ *
+ * Supports:
+ * - ${file://path#key} - Read from file
+ * - ${env://varName} - Read from environment variable
+ * - All above with default values: ${protocol://...:-default}
+ *
+ * @param value - Value to substitute (string, object, array, or primitive)
+ * @param resolver - ProtocolResolver instance
+ * @returns Value with protocol references substituted
+ */
+export declare function substituteProtocolRefs(value: unknown, resolver: ProtocolResolver): unknown;
+/**
+ * Parse JSONC content and substitute protocol references
+ *
+ * @param content - JSONC content string
+ * @param resolver - ProtocolResolver instance
+ * @returns Parsed JSON object with protocol refs substituted
+ */
+export declare function parseJSONCWithProtocols(content: string, resolver: ProtocolResolver): Record<string, unknown>;

package/dist/config/env-key.d.ts

@@ -0,0 +1,97 @@
+/**
+ * 环境变量键名转换工具
+ *
+ * 提供统一的环境变量键名转换逻辑，供 EnvSource 和其他组件使用
+ *
+ * 转换规则（toEnvKey）：
+ * 1. 将点号替换为下划线
+ * 2. 将驼峰命名转换为下划线分隔的大写形式
+ * 3. 拼接前缀（如果前缀不以_结尾则自动添加）
+ *
+ * 转换规则（fromEnvKey - 用于 EnvSource）：
+ * 1. 移除前缀
+ * 2. 保持原始格式（大小写）
+ *
+ * 转换规则（envKeyToConfigKey - 通用）：
+ * 1. 移除前缀
+ * 2. 转小写
+ * 3. 将下划线替换为点号
+ * 4. 拼接组件名前缀
+ *
+ * @example
+ * // toEnvKey
+ * toEnvKey("llm.defaultModel", "LLM") -> "LLM_LLM_DEFAULT_MODEL"
+ * toEnvKey("logTrace.level", "LOG") -> "LOG_LOG_TRACE_LEVEL"
+ *
+ * // fromEnvKey (用于 EnvSource.list)
+ * fromEnvKey("LLM_LLM_DEBUG", "LLM_") -> "DEBUG"
+ *
+ * // envKeyToConfigKey (通用，支持任意组件)
+ * envKeyToConfigKey("LLM_LLM_DEFAULT_MODEL", "LLM", "llm") -> "llm.default.model"
+ * envKeyToConfigKey("LOG_LOG_TRACE_LEVEL", "LOG", "logTrace") -> "logTrace.level"
+ */
+/**
+ * 将点号路径转换为环境变量名（带前缀）
+ *
+ * 规则：
+ * - `.` 和 `-` 都替换为路径分隔符 `_`
+ * - 驼峰转为下划线大写
+ * - 如果 key 规范化后的首段与 prefix 的去下划线大写形式一致，
+ *   则不再重复添加前缀（避免 "LLM_LLM_DEFAULT_PROVIDER" 这种双重前缀）
+ *
+ * 转换示例（Bug #2186 Bug 1 修复后）：
+ * - `llm.defaultModel` + `LLM` -> `LLM_DEFAULT_MODEL`（无双 LLM 前缀）
+ * - `logTrace.level` + `LOG` -> `LOG_LEVEL`
+ * - `log-trace.logging.dir` + `LOG_TRACE` -> `LOG_TRACE_LOGGING_DIR`
+ * - `DEBUG` + `LLM` -> `LLM_DEBUG`（首段不匹配 prefix，正常前缀化）
+ *
+ * @example
+ * toEnvKey("llm.defaultModel", "LLM") -> "LLM_DEFAULT_MODEL"
+ * toEnvKey("log-trace.logging.dir", "LOG_TRACE") -> "LOG_TRACE_LOGGING_DIR"
+ * toEnvKey("DEBUG", "MY_APP_") -> "MY_APP_DEBUG"
+ */
+export declare function toEnvKey(key: string, prefix: string): string;
+/**
+ * 从环境变量名提取内部键名（移除前缀，保持原始格式）
+ *
+ * 用于 EnvSource.list() 等需要保持原始格式的场景
+ */
+export declare function fromEnvKey(envKey: string, prefix: string): string;
+/**
+ * 将环境变量名转换为配置键名（通用，支持任意组件）
+ *
+ * 规则：
+ * - `_` 转换为 `.` 作为键路径分隔符
+ * - 组件名中的 `-` 在环境变量中也会是 `_`（因为 toEnvKey 会转换）
+ *
+ * 环境变量格式约定:
+ * - PREFIX_KEY: 如 LLM_DEFAULT_MODEL -> llm.default.model
+ * - PREFIX_COMPONENT_KEY: 如 LLM_LLM_DEFAULT_MODEL -> llm.default.model
+ * - 对于带连字符的组件名: 如 LOG_TRACE_LOGGING_LEVEL -> log-trace.logging.level (当组件名为 log-trace)
+ *
+ * @param envKey - 环境变量名（如 LLM_LLM_DEFAULT_MODEL 或 LOG_TRACE_LOGGING_LEVEL）
+ * @param prefix - 环境变量前缀（如 LLM 或 LOG）
+ * @param componentName - 组件名（如 llm, logTrace, log-trace）
+ * @returns 配置键名（如 llm.default.model 或 log-trace.logging.level）
+ *
+ * @example
+ * // 格式1: PREFIX_KEY
+ * envKeyToConfigKey("LLM_DEFAULT_MODEL", "LLM", "llm") -> "llm.default.model"
+ *
+ * // 格式2: PREFIX_COMPONENT_KEY
+ * envKeyToConfigKey("LLM_LLM_DEFAULT_MODEL", "LLM", "llm") -> "llm.default.model"
+ *
+ * // 格式3: 连字符组件名（环境变量中 - 会被转成 _）
+ * envKeyToConfigKey("LOG_TRACE_LOGGING_LEVEL", "LOG", "log-trace") -> "log-trace.logging.level"
+ */
+export declare function envKeyToConfigKey(envKey: string, prefix: string, componentName: string): string | undefined;
+/**
+ * 从环境变量键名提取组件名
+ *
+ * 用于自动发现所有以 prefix 开头的环境变量
+ *
+ * @param envKey - 环境变量名
+ * @param prefix - 前缀
+ * @returns 组件名和剩余部分（如 ["llm", "default.model"]）
+ */
+export declare function extractComponentFromEnvKey(envKey: string, prefix: string): [string, string] | undefined;

package/dist/config/env-source.d.ts

@@ -0,0 +1,113 @@
+import { ConfigSource, ConfigSourceType, ConfigChangeEvent } from "./config-component";
+/**
+ * EnvSource 配置
+ */
+export interface EnvSourceOptions {
+    /** 环境变量前缀 */
+    prefix?: string;
+    /** 值转换函数 */
+    transform?: (value: string, key: string) => unknown;
+    /** 轮询间隔（ms），用于检测环境变量变化 */
+    pollInterval?: number;
+    /** 优先级 */
+    priority?: number;
+    /** 是否启用监听（轮询），默认 true */
+    watch?: boolean;
+}
+/**
+ * 环境变量配置源
+ *
+ * 从 process.env 读取配置，支持：
+ * - 前缀过滤
+ * - 值转换
+ * - 环境变量监听（轮询）
+ */
+export declare class EnvSource implements ConfigSource {
+    readonly name: ConfigSourceType;
+    readonly priority = 20;
+    private prefix;
+    private transform?;
+    private pollInterval?;
+    private watchers;
+    private pollTimer?;
+    private lastValues;
+    private watchEnabled;
+    constructor(options?: EnvSourceOptions);
+    /**
+     * 获取环境变量名（带前缀）
+     * 将点号路径转换为下划线分隔的大写形式
+     * 例如: "llm.provider" + prefix "LLM" -> "LLM_LLM_PROVIDER"
+     * 例如: "DEBUG" + prefix "MY_APP_" -> "MY_APP_DEBUG"
+     * 例如: "llm.defaultModel" + prefix "LLM" -> "LLM_LLM_DEFAULT_MODEL"
+     */
+    private getEnvKey;
+    /**
+     * 移除前缀获取内部 key
+     * 注意：保持原始格式（大小写），仅移除前缀
+     */
+    private getInternalKey;
+    /**
+     * 读取环境变量
+     */
+    read(key: string): unknown;
+    /**
+     * 写入环境变量
+     */
+    write(key: string, value: unknown): boolean;
+    /**
+     * 删除环境变量
+     */
+    delete(key: string): boolean;
+    /**
+     * 列出所有环境变量
+     */
+    list(): Array<{
+        key: string;
+        value: unknown;
+    }>;
+    /**
+     * 监听环境变量变化
+     */
+    watch(callback: (event: ConfigChangeEvent) => void): () => void;
+    private ensurePolling;
+    private stopPolling;
+    private recordCurrentValues;
+    private checkForChanges;
+    private transformValue;
+    private notifyWatchers;
+    /**
+     * 关闭并清理资源
+     */
+    close(): void;
+    /**
+     * 验证 process.env 中的环境变量，识别未在已知 config keys 中的项
+     * （Bug #2186 Bug 2 修复：env var 拼写错误时不再静默忽略）
+     *
+     * 遍历 process.env，对于以 prefix 开头的每个环境变量名：
+     * 1. 用 `envKeyToConfigKey` 反向解析为 config key（如 `LLM_DEFAULT_PROVIDER` → `llm.default.provider`）
+     * 2. 检查 configKey 是否在 `knownKeys` 中（精确匹配，或作为前缀匹配）
+     * 3. 如果不匹配且 logger 存在，输出警告
+     *
+     * @param options.componentName - 用于 envKeyToConfigKey 反向解析（如 "llm"）
+     * @param options.knownKeys - 已知 config keys 集合（dotted 路径形式）
+     *                          - 精确匹配：knownKeys.has(configKey)
+     *                          - 前缀匹配：knownKeys 中任一项 + "." + 后缀 === configKey
+     * @param options.logger - 可选 logger（{ warn(msg: string) }）
+     * @returns 未识别的环境变量名列表
+     *
+     * @example
+     * const warnings: string[] = [];
+     * envSource.validateUnrecognizedEnvVars({
+     *   componentName: "llm",
+     *   knownKeys: new Set(["llm.defaultProvider", "llm.providers"]),
+     *   logger: { warn: (msg) => warnings.push(msg) },
+     * });
+     */
+    validateUnrecognizedEnvVars(options?: {
+        componentName?: string;
+        knownKeys?: Set<string>;
+        logger?: {
+            warn: (msg: string) => void;
+        };
+    }): string[];
+}

package/dist/config/file-source.d.ts

@@ -0,0 +1,90 @@
+import { ConfigSource, ConfigSourceType, ConfigChangeEvent } from "./config-component";
+import { ProtocolResolver } from "./protocol-resolver";
+/**
+ * FileSource 配置
+ */
+export interface FileSourceOptions {
+    /** 文件路径 */
+    filePath: string;
+    /** 写入防抖延迟（ms），默认 100ms */
+    debounceMs?: number;
+    /** 协议解析器（可选），用于解析 file://, env:// 协议 */
+    resolver?: ProtocolResolver;
+    /** 是否可选，文件不存在时不报错（默认 false） */
+    optional?: boolean;
+    /** 是否启用文件监听（默认 true） */
+    watch?: boolean;
+    /** 优先级（默认 10，越大越高） */
+    priority?: number;
+    /** Source 名称（默认 "file"，project source 可设为 "project"） */
+    name?: ConfigSourceType;
+}
+/**
+ * 文件配置源
+ *
+ * 从 JSON 文件读取/写入配置，支持：
+ * - 点号访问嵌套值（user.profile.name）
+ * - 文件监听
+ * - 异步批量写入
+ * - 协议引用解析 (file://, env://)
+ */
+export declare class FileSource implements ConfigSource {
+    readonly name: ConfigSourceType;
+    readonly priority: number;
+    private filePath;
+    private data;
+    private watchers;
+    private watcherHandle?;
+    private debounceMs;
+    private pendingWrite?;
+    private lastFileContent;
+    private resolver?;
+    private optional;
+    private watchEnabled;
+    constructor(options: FileSourceOptions | string, resolver?: ProtocolResolver);
+    /**
+     * 同步初始化：加载文件内容
+     */
+    private initSync;
+    /**
+     * 异步初始化
+     */
+    private ensureInit;
+    /**
+     * 获取嵌套值
+     */
+    private getNestedValue;
+    /**
+     * 设置嵌套值
+     */
+    private setNestedValue;
+    /**
+     * 删除嵌套值
+     */
+    private deleteNestedValue;
+    /**
+     * 扁平化嵌套对象为点号路径
+     */
+    private flattenObject;
+    read(key: string): unknown | undefined;
+    readAsync(key: string): Promise<unknown | undefined>;
+    write(key: string, value: unknown): boolean;
+    private scheduleWrite;
+    private persistToFile;
+    delete(key: string): boolean;
+    list(): Array<{
+        key: string;
+        value: unknown;
+    }>;
+    listAsync(): Promise<Array<{
+        key: string;
+        value: unknown;
+    }>>;
+    watch(callback: (event: ConfigChangeEvent) => void): () => void;
+    private ensureWatch;
+    private stopWatch;
+    private reloadFromFile;
+    private notifyWatchers;
+    refresh(): Promise<void>;
+    close(): Promise<void>;
+}

package/dist/config/index.d.ts

@@ -0,0 +1,4 @@
+export { type ConfigSource, type ConfigSourceType, type ConfigChangeEvent, type ConfigComponentOptions, type SourceRegistration, type KeyRegistration, type ComponentRegistration, ConfigSourceNotFoundError, ConfigFileNotFoundError, ConfigComponent, MemorySource, } from "./config-component";
+export { FileSource, type FileSourceOptions } from "./file-source";
+export { EnvSource, type EnvSourceOptions } from "./env-source";
+export { parseJSONC, parseJSONCWithEnv, parseJSONCWithProtocols, substituteEnvVars, substituteProtocolRefs, } from "./config-parser";