spectra-cli 4.1.1

package/dist/panoramic/generator-registry.js

@@ -0,0 +1,194 @@
+/**
+ * GeneratorRegistry — 全景文档化 Generator 注册中心（单例）
+ *
+ * 职责：
+ * - 维护 Generator id 到 DocumentGenerator 实例的映射
+ * - 提供按 id 查询、全量列出、按 ProjectContext 异步过滤的能力
+ * - 检测 id 冲突（两阶段验证：格式校验 + 重复检测）
+ * - 管理 Generator 的启用/禁用状态
+ *
+ * 设计决策：
+ * - 继承 AbstractRegistry<DocumentGenerator, GeneratorEntry> 复用通用逻辑
+ * - 单例模式参考 LanguageAdapterRegistry，保证全局唯一性
+ * - 启用/禁用状态由 Registry 拥有（独立 Map），不修改外部 Generator 实例
+ * - filterByContext 使用 Promise.resolve() 统一包装同步/异步 isApplicable
+ * - Promise.allSettled() 实现并发执行和错误隔离
+ *
+ * 生命周期：进程级单例，CLI 和 MCP 入口各自在启动时通过 bootstrapGenerators() 完成注册。
+ */
+import { GeneratorMetadataSchema } from './interfaces.js';
+import { AbstractRegistry } from './abstract-registry.js';
+import { MockReadmeGenerator } from './generators/mock-readme-generator.js';
+import { ConfigReferenceGenerator } from './generators/config-reference-generator.js';
+import { DataModelGenerator } from './generators/data-model-generator.js';
+import { WorkspaceIndexGenerator } from './generators/workspace-index-generator.js';
+import { CrossPackageAnalyzer } from './generators/cross-package-analyzer.js';
+import { ApiSurfaceGenerator } from './api-surface/index.js';
+import { InterfaceSurfaceGenerator } from './generators/interface-surface-generator.js';
+import { RuntimeTopologyGenerator } from './generators/runtime-topology-generator.js';
+import { EventSurfaceGenerator } from './generators/event-surface-generator.js';
+import { TroubleshootingGenerator } from './generators/troubleshooting-generator.js';
+import { ArchitectureOverviewGenerator } from './generators/architecture-overview-generator.js';
+import { ArchitectureIRGenerator } from './generators/architecture-ir-generator.js';
+import { PatternHintsGenerator } from './generators/pattern-hints-generator.js';
+import { ComponentViewBuilderGenerator } from './builders/component-view-builder.js';
+import { ArchitectureNarrativeGenerator } from './pipelines/architecture-narrative.js';
+import { AdrDecisionPipelineGenerator } from './pipelines/adr-decision-pipeline.js';
+import { ProductUxDocsGenerator } from './pipelines/product-ux-docs.js';
+import { DynamicScenariosBuilderGenerator } from './builders/dynamic-scenarios-builder.js';
+import { DocsQualityEvaluatorGenerator } from './pipelines/docs-quality-evaluator.js';
+// ============================================================
+// GeneratorRegistry 类
+// ============================================================
+/**
+ * Generator 的中心化注册中心
+ * 维护 id 到 DocumentGenerator 实例的映射以及每个 Generator 的启用/禁用状态。
+ * 进程级单例，全局唯一。
+ */
+export class GeneratorRegistry extends AbstractRegistry {
+    /** 单例实例 */
+    static instance = null;
+    constructor() {
+        super();
+    }
+    /**
+     * 获取或创建 Registry 单例
+     */
+    static getInstance() {
+        if (!GeneratorRegistry.instance) {
+            GeneratorRegistry.instance = new GeneratorRegistry();
+        }
+        return GeneratorRegistry.instance;
+    }
+    /**
+     * 重置单例（仅限测试使用）
+     * 重置后下次 getInstance() 返回新的空白实例。
+     */
+    static resetInstance() {
+        GeneratorRegistry.instance = null;
+    }
+    // ============================================================
+    // AbstractRegistry 抽象方法实现
+    // ============================================================
+    getMetadataSchema() {
+        return GeneratorMetadataSchema;
+    }
+    extractMetadata(item) {
+        return {
+            id: item.id,
+            name: item.name,
+            description: item.description,
+        };
+    }
+    buildEntry(item, enabled) {
+        return { generator: item, enabled };
+    }
+    // ============================================================
+    // 重写方法（保持向后兼容的错误消息）
+    // ============================================================
+    /**
+     * 切换 Generator 的启用/禁用状态
+     * 重写基类方法以保持向后兼容的错误消息前缀
+     */
+    setEnabled(id, enabled) {
+        if (!this.items.has(id)) {
+            throw new Error(`Generator '${id}' not found in registry`);
+        }
+        this.enabledState.set(id, enabled);
+    }
+    // ============================================================
+    // 领域特有方法
+    // ============================================================
+    /**
+     * 按项目上下文过滤适用的 Generator
+     *
+     * 处理逻辑：
+     * 1. 跳过已禁用的 Generator
+     * 2. 使用 Promise.resolve() 统一包装同步/异步 isApplicable 返回值
+     * 3. 使用 Promise.allSettled() 并发执行所有 isApplicable 调用
+     * 4. rejected 的 Promise 记录 console.warn 并跳过
+     * 5. 收集 fulfilled 且值为 true 的 Generator，按注册顺序返回
+     *
+     * @param context - 项目上下文
+     * @returns 适用且启用的 Generator 列表
+     */
+    async filterByContext(context) {
+        // 收集启用的 Generator 及其 isApplicable Promise
+        const enabledGenerators = [];
+        const applicableChecks = [];
+        for (const generator of this.itemOrder) {
+            if (this.enabledState.get(generator.id) === false) {
+                continue;
+            }
+            enabledGenerators.push(generator);
+            // 使用 Promise 工厂包装，捕获同步 throw 和异步 rejection
+            applicableChecks.push(new Promise((resolve, reject) => {
+                try {
+                    const result = generator.isApplicable(context);
+                    Promise.resolve(result).then(resolve, reject);
+                }
+                catch (err) {
+                    reject(err);
+                }
+            }));
+        }
+        // 并发执行所有 isApplicable 检查
+        const results = await Promise.allSettled(applicableChecks);
+        // 收集结果
+        const applicable = [];
+        for (let i = 0; i < results.length; i++) {
+            const result = results[i];
+            const generator = enabledGenerators[i];
+            if (result.status === 'rejected') {
+                console.warn(`Generator '${generator.id}' 的 isApplicable() 抛出异常，已跳过:`, result.reason);
+                continue;
+            }
+            if (result.value === true) {
+                applicable.push(generator);
+            }
+        }
+        return applicable;
+    }
+}
+// ============================================================
+// bootstrapGenerators 幂等初始化函数
+// ============================================================
+/**
+ * 启动 Generator 注册
+ * 在 CLI/MCP 入口最早时机调用，完成所有内置 Generator 的注册。
+ * 幂等：如果 Registry 已有 Generator 注册则跳过。
+ *
+ * @param outputDir - 文档输出目录（可选）。副作用型和聚合评估型 Adapter 需要此参数。
+ *                   若不传则使用当前工作目录作为默认值。
+ */
+export function bootstrapGenerators(outputDir) {
+    const registry = GeneratorRegistry.getInstance();
+    // 幂等检查：非空则直接返回
+    if (!registry.isEmpty()) {
+        return;
+    }
+    // 使用当前工作目录作为默认 outputDir
+    const resolvedOutputDir = outputDir ?? process.cwd();
+    // 原有 13 个 Generator（保持注册顺序不变）
+    registry.register(new MockReadmeGenerator());
+    registry.register(new ConfigReferenceGenerator());
+    registry.register(new DataModelGenerator());
+    registry.register(new WorkspaceIndexGenerator());
+    registry.register(new CrossPackageAnalyzer());
+    registry.register(new ApiSurfaceGenerator());
+    registry.register(new InterfaceSurfaceGenerator());
+    registry.register(new RuntimeTopologyGenerator());
+    registry.register(new ArchitectureOverviewGenerator());
+    registry.register(new ArchitectureIRGenerator());
+    registry.register(new PatternHintsGenerator());
+    registry.register(new EventSurfaceGenerator());
+    registry.register(new TroubleshootingGenerator());
+    // 新增 6 个 Adapter（按依赖图顺序注册）
+    registry.register(new ComponentViewBuilderGenerator()); // 无前置依赖
+    registry.register(new ArchitectureNarrativeGenerator()); // 无前置依赖
+    registry.register(new AdrDecisionPipelineGenerator(resolvedOutputDir)); // 依赖 IR
+    registry.register(new ProductUxDocsGenerator(resolvedOutputDir)); // 无前置依赖
+    registry.register(new DynamicScenariosBuilderGenerator()); // 依赖 component-view-builder 产出
+    registry.register(new DocsQualityEvaluatorGenerator(resolvedOutputDir)); // 依赖所有上游，最后注册
+}
+//# sourceMappingURL=generator-registry.js.map

package/dist/panoramic/generator-registry.js.map

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

package/dist/panoramic/generators/architecture-ir-generator.d.ts

@@ -0,0 +1,36 @@
+/**
+ * ArchitectureIRGenerator
+ *
+ * 统一导出 panoramic 架构事实为 Architecture IR，并派生 JSON / Structurizr DSL / Mermaid 互通产物。
+ */
+import type { DocumentGenerator, GenerateOptions, ProjectContext } from '../interfaces.js';
+import { type ArchitectureOverviewOutput } from './architecture-overview-generator.js';
+import type { RuntimeTopologyOutput } from './runtime-topology-generator.js';
+import type { WorkspaceOutput } from './workspace-index-generator.js';
+import type { CrossPackageOutput } from './cross-package-analyzer.js';
+import type { ArchitectureIR, ArchitectureIRExportBundle } from '../models/architecture-ir-model.js';
+export interface ArchitectureIRInput {
+    projectName: string;
+    architectureOverview: ArchitectureOverviewOutput;
+    runtime?: RuntimeTopologyOutput;
+    workspace?: WorkspaceOutput;
+    crossPackage?: CrossPackageOutput;
+    warnings: string[];
+}
+export interface ArchitectureIROutput {
+    title: string;
+    generatedAt: string;
+    ir: ArchitectureIR;
+    exports: ArchitectureIRExportBundle;
+    warnings: string[];
+}
+export declare class ArchitectureIRGenerator implements DocumentGenerator<ArchitectureIRInput, ArchitectureIROutput> {
+    readonly id: "architecture-ir";
+    readonly name: "\u67B6\u6784\u4E2D\u95F4\u8868\u793A\u5BFC\u51FA\u5668";
+    readonly description = "\u590D\u7528\u73B0\u6709 panoramic \u67B6\u6784\u4E8B\u5B9E\uFF0C\u5BFC\u51FA\u7EDF\u4E00 Architecture IR\u3001Structurizr DSL \u4E0E Mermaid \u4E92\u901A\u7ED3\u679C";
+    isApplicable(context: ProjectContext): boolean;
+    extract(context: ProjectContext): Promise<ArchitectureIRInput>;
+    generate(input: ArchitectureIRInput, _options?: GenerateOptions): Promise<ArchitectureIROutput>;
+    render(output: ArchitectureIROutput): string;
+}
+//# sourceMappingURL=architecture-ir-generator.d.ts.map

package/dist/panoramic/generators/architecture-ir-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture-ir-generator.d.ts","sourceRoot":"","sources":["../../../src/panoramic/generators/architecture-ir-generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC3F,OAAO,EAAiC,KAAK,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AACtH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAItE,OAAO,KAAK,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAGrG,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,0BAA0B,CAAC;IACjD,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,cAAc,CAAC;IACnB,OAAO,EAAE,0BAA0B,CAAC;IACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,qBAAa,uBACX,YAAW,iBAAiB,CAAC,mBAAmB,EAAE,oBAAoB,CAAC;IAEvE,QAAQ,CAAC,EAAE,EAAG,iBAAiB,CAAU;IACzC,QAAQ,CAAC,IAAI,EAAG,wDAAW,CAAU;IACrC,QAAQ,CAAC,WAAW,4KAA6E;IAEjG,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO;IAIxC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAe9D,QAAQ,CACZ,KAAK,EAAE,mBAAmB,EAC1B,QAAQ,CAAC,EAAE,eAAe,GACzB,OAAO,CAAC,oBAAoB,CAAC;IAsBhC,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM;CAI7C"}

package/dist/panoramic/generators/architecture-ir-generator.js

@@ -0,0 +1,51 @@
+import { ArchitectureOverviewGenerator } from './architecture-overview-generator.js';
+import { buildArchitectureIR } from '../builders/architecture-ir-builder.js';
+import { buildArchitectureIRMermaidExport } from '../builders/architecture-ir-mermaid-adapter.js';
+import { exportArchitectureIRJson, exportArchitectureIRStructurizrDsl } from '../exporters/architecture-ir-exporters.js';
+import { loadTemplate } from '../utils/template-loader.js';
+export class ArchitectureIRGenerator {
+    id = 'architecture-ir';
+    name = '架构中间表示导出器';
+    description = '复用现有 panoramic 架构事实，导出统一 Architecture IR、Structurizr DSL 与 Mermaid 互通结果';
+    isApplicable(context) {
+        return new ArchitectureOverviewGenerator().isApplicable(context);
+    }
+    async extract(context) {
+        const overviewGenerator = new ArchitectureOverviewGenerator();
+        const overviewInput = await overviewGenerator.extract(context);
+        const architectureOverview = await overviewGenerator.generate(overviewInput);
+        return {
+            projectName: architectureOverview.model.projectName,
+            architectureOverview,
+            runtime: overviewInput.runtime,
+            workspace: overviewInput.workspace,
+            crossPackage: overviewInput.crossPackage,
+            warnings: [...new Set([...overviewInput.warnings, ...architectureOverview.warnings])].sort((a, b) => a.localeCompare(b)),
+        };
+    }
+    async generate(input, _options) {
+        const ir = buildArchitectureIR({
+            architectureOverview: input.architectureOverview,
+            runtime: input.runtime,
+            workspace: input.workspace,
+            crossPackage: input.crossPackage,
+        });
+        const exports = {
+            json: exportArchitectureIRJson(ir),
+            structurizrDsl: exportArchitectureIRStructurizrDsl(ir),
+            mermaid: buildArchitectureIRMermaidExport(ir),
+        };
+        return {
+            title: `Architecture IR: ${input.projectName}`,
+            generatedAt: new Date().toISOString().split('T')[0],
+            ir,
+            exports,
+            warnings: [...new Set([...input.warnings, ...ir.warnings])].sort((a, b) => a.localeCompare(b)),
+        };
+    }
+    render(output) {
+        const template = loadTemplate('architecture-ir.hbs', import.meta.url);
+        return template(output);
+    }
+}
+//# sourceMappingURL=architecture-ir-generator.js.map

package/dist/panoramic/generators/architecture-ir-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture-ir-generator.js","sourceRoot":"","sources":["../../../src/panoramic/generators/architecture-ir-generator.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,6BAA6B,EAAmC,MAAM,sCAAsC,CAAC;AAItH,OAAO,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,EAAE,gCAAgC,EAAE,MAAM,gDAAgD,CAAC;AAClG,OAAO,EAAE,wBAAwB,EAAE,kCAAkC,EAAE,MAAM,2CAA2C,CAAC;AAEzH,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAmB3D,MAAM,OAAO,uBAAuB;IAGzB,EAAE,GAAG,iBAA0B,CAAC;IAChC,IAAI,GAAG,WAAoB,CAAC;IAC5B,WAAW,GAAG,yEAAyE,CAAC;IAEjG,YAAY,CAAC,OAAuB;QAClC,OAAO,IAAI,6BAA6B,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAuB;QACnC,MAAM,iBAAiB,GAAG,IAAI,6BAA6B,EAAE,CAAC;QAC9D,MAAM,aAAa,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC/D,MAAM,oBAAoB,GAAG,MAAM,iBAAiB,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QAE7E,OAAO;YACL,WAAW,EAAE,oBAAoB,CAAC,KAAK,CAAC,WAAW;YACnD,oBAAoB;YACpB,OAAO,EAAE,aAAa,CAAC,OAAO;YAC9B,SAAS,EAAE,aAAa,CAAC,SAAS;YAClC,YAAY,EAAE,aAAa,CAAC,YAAY;YACxC,QAAQ,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,aAAa,CAAC,QAAQ,EAAE,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;SACzH,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,KAA0B,EAC1B,QAA0B;QAE1B,MAAM,EAAE,GAAG,mBAAmB,CAAC;YAC7B,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;YAChD,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,YAAY,EAAE,KAAK,CAAC,YAAY;SACjC,CAAC,CAAC;QACH,MAAM,OAAO,GAA+B;YAC1C,IAAI,EAAE,wBAAwB,CAAC,EAAE,CAAC;YAClC,cAAc,EAAE,kCAAkC,CAAC,EAAE,CAAC;YACtD,OAAO,EAAE,gCAAgC,CAAC,EAAE,CAAC;SAC9C,CAAC;QAEF,OAAO;YACL,KAAK,EAAE,oBAAoB,KAAK,CAAC,WAAW,EAAE;YAC9C,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE;YACpD,EAAE;YACF,OAAO;YACP,QAAQ,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;SAC/F,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,MAA4B;QACjC,MAAM,QAAQ,GAAG,YAAY,CAAC,qBAAqB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtE,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/panoramic/generators/architecture-overview-generator.d.ts

@@ -0,0 +1,31 @@
+import type { DocumentGenerator, GenerateOptions, ProjectContext } from '../interfaces.js';
+import { type CrossPackageOutput } from './cross-package-analyzer.js';
+import { type RuntimeTopologyOutput } from './runtime-topology-generator.js';
+import { type ArchitectureOverviewModel, type ArchitectureViewSection } from '../models/architecture-overview-model.js';
+import { type WorkspaceOutput } from './workspace-index-generator.js';
+export interface ArchitectureOverviewInput {
+    projectName: string;
+    runtime?: RuntimeTopologyOutput;
+    workspace?: WorkspaceOutput;
+    crossPackage?: CrossPackageOutput;
+    warnings: string[];
+}
+export interface ArchitectureOverviewOutput {
+    title: string;
+    generatedAt: string;
+    model: ArchitectureOverviewModel;
+    warnings: string[];
+    systemContext?: ArchitectureViewSection;
+    deploymentView?: ArchitectureViewSection;
+    layeredView?: ArchitectureViewSection;
+}
+export declare class ArchitectureOverviewGenerator implements DocumentGenerator<ArchitectureOverviewInput, ArchitectureOverviewOutput> {
+    readonly id: "architecture-overview";
+    readonly name: "\u67B6\u6784\u6982\u89C8\u751F\u6210\u5668";
+    readonly description = "\u7EC4\u5408\u8FD0\u884C\u65F6\u62D3\u6251\u3001workspace \u548C\u8DE8\u5305\u4F9D\u8D56\u8F93\u51FA\uFF0C\u751F\u6210\u7CFB\u7EDF\u4E0A\u4E0B\u6587\u4E0E\u90E8\u7F72\u89C6\u56FE";
+    isApplicable(context: ProjectContext): boolean;
+    extract(context: ProjectContext): Promise<ArchitectureOverviewInput>;
+    generate(input: ArchitectureOverviewInput, _options?: GenerateOptions): Promise<ArchitectureOverviewOutput>;
+    render(output: ArchitectureOverviewOutput): string;
+}
+//# sourceMappingURL=architecture-overview-generator.d.ts.map

package/dist/panoramic/generators/architecture-overview-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture-overview-generator.d.ts","sourceRoot":"","sources":["../../../src/panoramic/generators/architecture-overview-generator.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC3F,OAAO,EAAwB,KAAK,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAC5F,OAAO,EAA4B,KAAK,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACvG,OAAO,EAKL,KAAK,yBAAyB,EAI9B,KAAK,uBAAuB,EAE7B,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAA2B,KAAK,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAM/F,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,yBAAyB,CAAC;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACxC,cAAc,CAAC,EAAE,uBAAuB,CAAC;IACzC,WAAW,CAAC,EAAE,uBAAuB,CAAC;CACvC;AAED,qBAAa,6BACX,YAAW,iBAAiB,CAAC,yBAAyB,EAAE,0BAA0B,CAAC;IAEnF,QAAQ,CAAC,EAAE,EAAG,uBAAuB,CAAU;IAC/C,QAAQ,CAAC,IAAI,EAAG,4CAAS,CAAU;IACnC,QAAQ,CAAC,WAAW,wLAA4C;IAEhE,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO;IAMxC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAmDpE,QAAQ,CACZ,KAAK,EAAE,yBAAyB,EAChC,QAAQ,CAAC,EAAE,eAAe,GACzB,OAAO,CAAC,0BAA0B,CAAC;IA4CtC,MAAM,CAAC,MAAM,EAAE,0BAA0B,GAAG,MAAM;CAInD"}