spectra-cli 4.1.1

package/dist/panoramic/parsers/toml-config-parser.js

@@ -0,0 +1,98 @@
+/**
+ * TomlConfigParser — TOML 配置文件解析器
+ *
+ * 解析 TOML 配置文件（.toml）中的键值对，
+ * 提取配置项路径、类型、默认值和注释说明。
+ *
+ * 解析策略：
+ * - [section.name] 头定义当前分组前缀
+ * - key = value 行级正则匹配
+ * - 上方注释行和行内注释均可作为 description
+ * - 上方注释优先于行内注释
+ * - 空行隔断注释与配置项的关联
+ * - 支持引号包裹的值（双引号和单引号）
+ *
+ * 容错降级：解析失败返回 { entries: [] }
+ */
+import { AbstractConfigParser } from './abstract-config-parser.js';
+import { inferType, stripQuotes } from './types.js';
+import { CommentTracker } from './comment-tracker.js';
+/**
+ * TOML 配置文件解析器
+ * 继承 AbstractConfigParser，只需实现 parseContent()
+ */
+export class TomlConfigParser extends AbstractConfigParser {
+    id = 'toml-config';
+    name = 'TOML Config Parser';
+    filePatterns = ['**/*.toml'];
+    /**
+     * 从 TOML 配置文件内容解析为 ConfigEntry 数组
+     */
+    parseContent(content) {
+        return parseTomlContent(content);
+    }
+}
+/**
+ * 解析 TOML 文件内容为 ConfigEntry 数组
+ *
+ * @param content - TOML 文件的文本内容
+ * @returns ConfigEntry 数组
+ */
+export function parseTomlContent(content) {
+    const entries = [];
+    const lines = content.split('\n');
+    let currentSection = '';
+    const tracker = new CommentTracker();
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // 空行重置 pending comment
+        if (trimmed === '') {
+            tracker.reset();
+            continue;
+        }
+        // 注释行
+        if (trimmed.startsWith('#')) {
+            const commentText = trimmed.replace(/^#\s*/, '');
+            tracker.append(commentText);
+            continue;
+        }
+        // Section 头 [section.name]
+        const sectionMatch = trimmed.match(/^\[([^\]]+)\]$/);
+        if (sectionMatch) {
+            currentSection = sectionMatch[1].trim();
+            tracker.reset();
+            continue;
+        }
+        // key = value 匹配
+        const kvMatch = trimmed.match(/^([\w][\w.-]*)\s*=\s*(.+)$/);
+        if (!kvMatch) {
+            tracker.reset();
+            continue;
+        }
+        const key = kvMatch[1];
+        let value = kvMatch[2];
+        // 提取行内注释
+        let inlineComment = '';
+        // 处理未被引号包裹的行内注释
+        if (!value.startsWith('"') && !value.startsWith("'") && !value.startsWith('[') && !value.startsWith('{')) {
+            const commentIdx = value.indexOf(' #');
+            if (commentIdx >= 0) {
+                inlineComment = value.slice(commentIdx + 2).trim();
+                value = value.slice(0, commentIdx).trim();
+            }
+        }
+        // 去除引号
+        value = stripQuotes(value);
+        const keyPath = currentSection ? `${currentSection}.${key}` : key;
+        const pendingComment = tracker.consume();
+        const description = pendingComment || inlineComment;
+        entries.push({
+            keyPath,
+            type: inferType(value),
+            defaultValue: value,
+            description,
+        });
+    }
+    return entries;
+}
+//# sourceMappingURL=toml-config-parser.js.map

package/dist/panoramic/parsers/toml-config-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toml-config-parser.js","sourceRoot":"","sources":["../../../src/panoramic/parsers/toml-config-parser.ts"],"names":[],"mappings":"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"}

package/dist/panoramic/parsers/types.d.ts

@@ -0,0 +1,314 @@
+/**
+ * 非代码制品解析器输出类型定义 + Zod Schema
+ *
+ * 类型分组：
+ * - SkillMdInfo / SkillMdSection: SkillMdParser 的输出
+ * - BehaviorInfo / BehaviorState: BehaviorYamlParser 的输出
+ * - DockerfileInfo / DockerfileStage / DockerfileInstruction: DockerfileParser 的输出
+ * - ConfigEntry / ConfigEntries: YamlConfigParser / EnvConfigParser / TomlConfigParser 的输出
+ *
+ * 每个类型均有对应的 Zod Schema，用于运行时验证解析结果的结构正确性。
+ */
+import { z } from 'zod';
+/** SKILL.md 的单个二级标题分段 Zod Schema */
+export declare const SkillMdSectionSchema: z.ZodObject<{
+    /** 二级标题文本（不含 ## 前缀） */
+    heading: z.ZodString;
+    /** 该标题下的正文内容（保留原始 Markdown 格式） */
+    content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    heading: string;
+}, {
+    content: string;
+    heading: string;
+}>;
+/** SKILL.md 的单个二级标题分段 */
+export type SkillMdSection = z.infer<typeof SkillMdSectionSchema>;
+/** SkillMdParser 的解析输出 Zod Schema */
+export declare const SkillMdInfoSchema: z.ZodObject<{
+    /** 名称——从 frontmatter 的 name 字段提取，无 frontmatter 时从一级标题推断 */
+    name: z.ZodString;
+    /** 描述——从 frontmatter 的 description 字段提取，缺失时为空字符串 */
+    description: z.ZodString;
+    /** 版本号——从 frontmatter 的 version 字段提取，缺失时为 undefined */
+    version: z.ZodOptional<z.ZodString>;
+    /** 一级标题文本——从 Markdown body 中第一个 # 标题提取 */
+    title: z.ZodString;
+    /** 二级标题分段数组——按文件中出现顺序排列 */
+    sections: z.ZodArray<z.ZodObject<{
+        /** 二级标题文本（不含 ## 前缀） */
+        heading: z.ZodString;
+        /** 该标题下的正文内容（保留原始 Markdown 格式） */
+        content: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        content: string;
+        heading: string;
+    }, {
+        content: string;
+        heading: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    description: string;
+    title: string;
+    sections: {
+        content: string;
+        heading: string;
+    }[];
+    version?: string | undefined;
+}, {
+    name: string;
+    description: string;
+    title: string;
+    sections: {
+        content: string;
+        heading: string;
+    }[];
+    version?: string | undefined;
+}>;
+/** SkillMdParser 的解析输出类型 */
+export type SkillMdInfo = z.infer<typeof SkillMdInfoSchema>;
+/** 单个状态及其关联行为 Zod Schema */
+export declare const BehaviorStateSchema: z.ZodObject<{
+    /** 状态名称——从 YAML key 或 Markdown 标题提取 */
+    name: z.ZodString;
+    /** 状态描述——从 YAML value 或 Markdown 段落提取 */
+    description: z.ZodString;
+    /** 行为列表——从 YAML 数组或 Markdown 列表项提取 */
+    actions: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    description: string;
+    actions: string[];
+}, {
+    name: string;
+    description: string;
+    actions: string[];
+}>;
+/** 单个状态及其关联行为 */
+export type BehaviorState = z.infer<typeof BehaviorStateSchema>;
+/** BehaviorYamlParser 的解析输出 Zod Schema */
+export declare const BehaviorInfoSchema: z.ZodObject<{
+    /** 状态-行为映射数组 */
+    states: z.ZodArray<z.ZodObject<{
+        /** 状态名称——从 YAML key 或 Markdown 标题提取 */
+        name: z.ZodString;
+        /** 状态描述——从 YAML value 或 Markdown 段落提取 */
+        description: z.ZodString;
+        /** 行为列表——从 YAML 数组或 Markdown 列表项提取 */
+        actions: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        description: string;
+        actions: string[];
+    }, {
+        name: string;
+        description: string;
+        actions: string[];
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    states: {
+        name: string;
+        description: string;
+        actions: string[];
+    }[];
+}, {
+    states: {
+        name: string;
+        description: string;
+        actions: string[];
+    }[];
+}>;
+/** BehaviorYamlParser 的解析输出类型 */
+export type BehaviorInfo = z.infer<typeof BehaviorInfoSchema>;
+/** Dockerfile 的单条指令 Zod Schema */
+export declare const DockerfileInstructionSchema: z.ZodObject<{
+    /** 指令类型（大写，如 RUN、COPY、ENV） */
+    type: z.ZodString;
+    /** 指令参数（已拼接多行续行） */
+    args: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    args: string;
+}, {
+    type: string;
+    args: string;
+}>;
+/** Dockerfile 的单条指令 */
+export type DockerfileInstruction = z.infer<typeof DockerfileInstructionSchema>;
+/** Dockerfile 的单个构建阶段 Zod Schema */
+export declare const DockerfileStageSchema: z.ZodObject<{
+    /** 基础镜像——FROM 指令的镜像名称（含 tag） */
+    baseImage: z.ZodString;
+    /** 阶段别名——FROM image AS alias 中的 alias，无则为 undefined */
+    alias: z.ZodOptional<z.ZodString>;
+    /** 该阶段的指令列表（不含 FROM 本身，按出现顺序排列） */
+    instructions: z.ZodArray<z.ZodObject<{
+        /** 指令类型（大写，如 RUN、COPY、ENV） */
+        type: z.ZodString;
+        /** 指令参数（已拼接多行续行） */
+        args: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        args: string;
+    }, {
+        type: string;
+        args: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    baseImage: string;
+    instructions: {
+        type: string;
+        args: string;
+    }[];
+    alias?: string | undefined;
+}, {
+    baseImage: string;
+    instructions: {
+        type: string;
+        args: string;
+    }[];
+    alias?: string | undefined;
+}>;
+/** Dockerfile 的单个构建阶段 */
+export type DockerfileStage = z.infer<typeof DockerfileStageSchema>;
+/** DockerfileParser 的解析输出 Zod Schema */
+export declare const DockerfileInfoSchema: z.ZodObject<{
+    /** 构建阶段数组——按 FROM 出现顺序排列 */
+    stages: z.ZodArray<z.ZodObject<{
+        /** 基础镜像——FROM 指令的镜像名称（含 tag） */
+        baseImage: z.ZodString;
+        /** 阶段别名——FROM image AS alias 中的 alias，无则为 undefined */
+        alias: z.ZodOptional<z.ZodString>;
+        /** 该阶段的指令列表（不含 FROM 本身，按出现顺序排列） */
+        instructions: z.ZodArray<z.ZodObject<{
+            /** 指令类型（大写，如 RUN、COPY、ENV） */
+            type: z.ZodString;
+            /** 指令参数（已拼接多行续行） */
+            args: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: string;
+            args: string;
+        }, {
+            type: string;
+            args: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        baseImage: string;
+        instructions: {
+            type: string;
+            args: string;
+        }[];
+        alias?: string | undefined;
+    }, {
+        baseImage: string;
+        instructions: {
+            type: string;
+            args: string;
+        }[];
+        alias?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    stages: {
+        baseImage: string;
+        instructions: {
+            type: string;
+            args: string;
+        }[];
+        alias?: string | undefined;
+    }[];
+}, {
+    stages: {
+        baseImage: string;
+        instructions: {
+            type: string;
+            args: string;
+        }[];
+        alias?: string | undefined;
+    }[];
+}>;
+/** DockerfileParser 的解析输出类型 */
+export type DockerfileInfo = z.infer<typeof DockerfileInfoSchema>;
+/**
+ * 单个配置项的结构化表示 Zod Schema
+ * 从 YAML/TOML/.env 文件解析出的统一配置项格式
+ */
+export declare const ConfigEntrySchema: z.ZodObject<{
+    /** 点号分隔的配置项路径（如 database.host） */
+    keyPath: z.ZodString;
+    /** 推断的值类型（string/number/boolean/null/array/object） */
+    type: z.ZodEnum<["string", "number", "boolean", "null", "array", "object"]>;
+    /** 当前值的字符串表示 */
+    defaultValue: z.ZodString;
+    /** 从注释提取的说明文本 */
+    description: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "string" | "number" | "boolean" | "object" | "null" | "array";
+    description: string;
+    keyPath: string;
+    defaultValue: string;
+}, {
+    type: "string" | "number" | "boolean" | "object" | "null" | "array";
+    description: string;
+    keyPath: string;
+    defaultValue: string;
+}>;
+/** 单个配置项的结构化表示 */
+export type ConfigEntry = z.infer<typeof ConfigEntrySchema>;
+/**
+ * 配置 Parser 的解析输出 Zod Schema
+ * 包含从单个配置文件中解析出的所有配置项
+ */
+export declare const ConfigEntriesSchema: z.ZodObject<{
+    /** 配置项数组 */
+    entries: z.ZodArray<z.ZodObject<{
+        /** 点号分隔的配置项路径（如 database.host） */
+        keyPath: z.ZodString;
+        /** 推断的值类型（string/number/boolean/null/array/object） */
+        type: z.ZodEnum<["string", "number", "boolean", "null", "array", "object"]>;
+        /** 当前值的字符串表示 */
+        defaultValue: z.ZodString;
+        /** 从注释提取的说明文本 */
+        description: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "string" | "number" | "boolean" | "object" | "null" | "array";
+        description: string;
+        keyPath: string;
+        defaultValue: string;
+    }, {
+        type: "string" | "number" | "boolean" | "object" | "null" | "array";
+        description: string;
+        keyPath: string;
+        defaultValue: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    entries: {
+        type: "string" | "number" | "boolean" | "object" | "null" | "array";
+        description: string;
+        keyPath: string;
+        defaultValue: string;
+    }[];
+}, {
+    entries: {
+        type: "string" | "number" | "boolean" | "object" | "null" | "array";
+        description: string;
+        keyPath: string;
+        defaultValue: string;
+    }[];
+}>;
+/** 配置 Parser 的解析输出类型 */
+export type ConfigEntries = z.infer<typeof ConfigEntriesSchema>;
+/** 配置值类型枚举 */
+export type ConfigValueType = 'string' | 'number' | 'boolean' | 'null' | 'array' | 'object';
+/**
+ * 从字符串值推断类型
+ * 供 YamlConfigParser、EnvConfigParser、TomlConfigParser 共用
+ */
+export declare function inferType(value: string): ConfigValueType;
+/**
+ * 去除首尾匹配的引号（双引号或单引号）
+ * 仅当首尾引号类型相同时才去除
+ */
+export declare function stripQuotes(value: string): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/panoramic/parsers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/panoramic/parsers/types.ts"],"names":[],"mappings":"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"}

package/dist/panoramic/parsers/types.js

@@ -0,0 +1,136 @@
+/**
+ * 非代码制品解析器输出类型定义 + Zod Schema
+ *
+ * 类型分组：
+ * - SkillMdInfo / SkillMdSection: SkillMdParser 的输出
+ * - BehaviorInfo / BehaviorState: BehaviorYamlParser 的输出
+ * - DockerfileInfo / DockerfileStage / DockerfileInstruction: DockerfileParser 的输出
+ * - ConfigEntry / ConfigEntries: YamlConfigParser / EnvConfigParser / TomlConfigParser 的输出
+ *
+ * 每个类型均有对应的 Zod Schema，用于运行时验证解析结果的结构正确性。
+ */
+import { z } from 'zod';
+// ============================================================
+// SkillMdInfo — SkillMdParser 的输出类型
+// ============================================================
+/** SKILL.md 的单个二级标题分段 Zod Schema */
+export const SkillMdSectionSchema = z.object({
+    /** 二级标题文本（不含 ## 前缀） */
+    heading: z.string(),
+    /** 该标题下的正文内容（保留原始 Markdown 格式） */
+    content: z.string(),
+});
+/** SkillMdParser 的解析输出 Zod Schema */
+export const SkillMdInfoSchema = z.object({
+    /** 名称——从 frontmatter 的 name 字段提取，无 frontmatter 时从一级标题推断 */
+    name: z.string(),
+    /** 描述——从 frontmatter 的 description 字段提取，缺失时为空字符串 */
+    description: z.string(),
+    /** 版本号——从 frontmatter 的 version 字段提取，缺失时为 undefined */
+    version: z.string().optional(),
+    /** 一级标题文本——从 Markdown body 中第一个 # 标题提取 */
+    title: z.string(),
+    /** 二级标题分段数组——按文件中出现顺序排列 */
+    sections: z.array(SkillMdSectionSchema),
+});
+// ============================================================
+// BehaviorInfo — BehaviorYamlParser 的输出类型
+// ============================================================
+/** 单个状态及其关联行为 Zod Schema */
+export const BehaviorStateSchema = z.object({
+    /** 状态名称——从 YAML key 或 Markdown 标题提取 */
+    name: z.string(),
+    /** 状态描述——从 YAML value 或 Markdown 段落提取 */
+    description: z.string(),
+    /** 行为列表——从 YAML 数组或 Markdown 列表项提取 */
+    actions: z.array(z.string()),
+});
+/** BehaviorYamlParser 的解析输出 Zod Schema */
+export const BehaviorInfoSchema = z.object({
+    /** 状态-行为映射数组 */
+    states: z.array(BehaviorStateSchema),
+});
+// ============================================================
+// DockerfileInfo — DockerfileParser 的输出类型
+// ============================================================
+/** Dockerfile 的单条指令 Zod Schema */
+export const DockerfileInstructionSchema = z.object({
+    /** 指令类型（大写，如 RUN、COPY、ENV） */
+    type: z.string(),
+    /** 指令参数（已拼接多行续行） */
+    args: z.string(),
+});
+/** Dockerfile 的单个构建阶段 Zod Schema */
+export const DockerfileStageSchema = z.object({
+    /** 基础镜像——FROM 指令的镜像名称（含 tag） */
+    baseImage: z.string(),
+    /** 阶段别名——FROM image AS alias 中的 alias，无则为 undefined */
+    alias: z.string().optional(),
+    /** 该阶段的指令列表（不含 FROM 本身，按出现顺序排列） */
+    instructions: z.array(DockerfileInstructionSchema),
+});
+/** DockerfileParser 的解析输出 Zod Schema */
+export const DockerfileInfoSchema = z.object({
+    /** 构建阶段数组——按 FROM 出现顺序排列 */
+    stages: z.array(DockerfileStageSchema),
+});
+// ============================================================
+// ConfigEntry / ConfigEntries — 配置文件 Parser 的输出类型
+// ============================================================
+/**
+ * 单个配置项的结构化表示 Zod Schema
+ * 从 YAML/TOML/.env 文件解析出的统一配置项格式
+ */
+export const ConfigEntrySchema = z.object({
+    /** 点号分隔的配置项路径（如 database.host） */
+    keyPath: z.string(),
+    /** 推断的值类型（string/number/boolean/null/array/object） */
+    type: z.enum(['string', 'number', 'boolean', 'null', 'array', 'object']),
+    /** 当前值的字符串表示 */
+    defaultValue: z.string(),
+    /** 从注释提取的说明文本 */
+    description: z.string(),
+});
+/**
+ * 配置 Parser 的解析输出 Zod Schema
+ * 包含从单个配置文件中解析出的所有配置项
+ */
+export const ConfigEntriesSchema = z.object({
+    /** 配置项数组 */
+    entries: z.array(ConfigEntrySchema),
+});
+// ============================================================
+// 配置解析辅助函数
+// ============================================================
+/**
+ * 从字符串值推断类型
+ * 供 YamlConfigParser、EnvConfigParser、TomlConfigParser 共用
+ */
+export function inferType(value) {
+    const trimmed = value.trim();
+    if (trimmed === '' || trimmed === 'null' || trimmed === '~')
+        return 'null';
+    if (trimmed === 'true' || trimmed === 'false')
+        return 'boolean';
+    if (/^-?\d+$/.test(trimmed))
+        return 'number';
+    if (/^-?\d+\.\d+$/.test(trimmed))
+        return 'number';
+    if (trimmed.startsWith('['))
+        return 'array';
+    if (trimmed.startsWith('{'))
+        return 'object';
+    return 'string';
+}
+/**
+ * 去除首尾匹配的引号（双引号或单引号）
+ * 仅当首尾引号类型相同时才去除
+ */
+export function stripQuotes(value) {
+    if ((value.startsWith('"') && value.endsWith('"')) ||
+        (value.startsWith("'") && value.endsWith("'"))) {
+        return value.slice(1, -1);
+    }
+    return value;
+}
+//# sourceMappingURL=types.js.map

package/dist/panoramic/parsers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/panoramic/parsers/types.ts"],"names":[],"mappings":"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"}

package/dist/panoramic/parsers/yaml-config-parser.d.ts

@@ -0,0 +1,58 @@
+/**
+ * YamlConfigParser — YAML 配置文件解析器
+ *
+ * 解析 YAML 配置文件（.yaml/.yml）中的键值对，
+ * 提取配置项路径、类型、默认值和注释说明。
+ *
+ * 解析策略：
+ * - 行级正则匹配 key: value 结构
+ * - 缩进堆栈跟踪嵌套层级，构建点号分隔的 keyPath
+ * - 上方注释行和行内注释均可作为 description
+ * - 上方注释优先于行内注释
+ * - 空行隔断注释与配置项的关联
+ *
+ * 容错降级：解析失败返回 { entries: [] }
+ */
+import { AbstractConfigParser } from './abstract-config-parser.js';
+import type { ConfigEntry } from './types.js';
+/**
+ * YAML 配置文件解析器
+ * 继承 AbstractConfigParser，只需实现 parseContent()
+ */
+export declare class YamlConfigParser extends AbstractConfigParser {
+    readonly id: "yaml-config";
+    readonly name: "YAML Config Parser";
+    readonly filePatterns: readonly ["**/*.yaml", "**/*.yml"];
+    /**
+     * 从 YAML 配置文件内容解析为 ConfigEntry 数组
+     */
+    protected parseContent(content: string): ConfigEntry[];
+}
+export type YamlScalar = string | number | boolean | null;
+export type YamlValue = YamlScalar | YamlObject | YamlArray;
+export interface YamlObject {
+    [key: string]: YamlValue;
+}
+export type YamlArray = YamlValue[];
+/**
+ * 解析受限 YAML 文档为 JS 风格的嵌套对象。
+ *
+ * 目标覆盖：
+ * - map / list 结构
+ * - Compose 常见短语法与长语法
+ * - inline array / inline object
+ *
+ * 非目标：
+ * - anchor / alias / merge key
+ * - 多文档 YAML
+ */
+export declare function parseYamlDocument(content: string): YamlObject;
+/**
+ * 解析 YAML 文件内容为 ConfigEntry 数组
+ * 使用行级正则解析，提取键值对、缩进层级和注释
+ *
+ * @param content - YAML 文件的文本内容
+ * @returns ConfigEntry 数组
+ */
+export declare function parseYamlContent(content: string): ConfigEntry[];
+//# sourceMappingURL=yaml-config-parser.d.ts.map

package/dist/panoramic/parsers/yaml-config-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml-config-parser.d.ts","sourceRoot":"","sources":["../../../src/panoramic/parsers/yaml-config-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,oBAAoB;IACxD,QAAQ,CAAC,EAAE,EAAG,aAAa,CAAU;IACrC,QAAQ,CAAC,IAAI,EAAG,oBAAoB,CAAU;IAC9C,QAAQ,CAAC,YAAY,qCAAsC;IAE3D;;OAEG;IACH,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE;CAGvD;AAMD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAC1D,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AAC5D,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AACD,MAAM,MAAM,SAAS,GAAG,SAAS,EAAE,CAAC;AAWpC;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAS7D;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAsE/D"}