spectra-cli 4.1.1 → 4.2.0

package/dist/panoramic/coverage-auditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage-auditor.d.ts","sourceRoot":"","sources":["../../src/panoramic/coverage-auditor.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAKtD,OAAO,EAEL,KAAK,QAAQ,EAEd,MAAM,wBAAwB,CAAC;AAOhC,MAAM,MAAM,aAAa,GACrB,aAAa,GACb,eAAe,GACf,gBAAgB,GAChB,gBAAgB,CAAC;AAErB,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,aAAa,GAAG,WAAW,CAAC;AAE9E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,cAAc,GAAG,gBAAgB,CAAC;CAC3C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,KAAK,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,eAAe,CAAC;IACzB,cAAc,EAAE,mBAAmB,EAAE,CAAC;IACtC,iBAAiB,EAAE,mBAAmB,EAAE,CAAC;IACzC,gBAAgB,EAAE,mBAAmB,EAAE,CAAC;IACxC,iBAAiB,EAAE,sBAAsB,EAAE,CAAC;IAC5C,aAAa,EAAE,kBAAkB,EAAE,CAAC;IACpC,aAAa,EAAE,iBAAiB,EAAE,CAAC;IACnC,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,kBAAkB,EAAE,sBAAsB,EAAE,CAAC;CAC9C;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,cAAc,CAAC;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B;AAID,qBAAa,eAAe;IACpB,KAAK,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,aAAa,CAAC;IA4GpE,MAAM,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM;YAKtB,sBAAsB;CAwDrC"}

package/dist/panoramic/coverage-auditor.js

@@ -0,0 +1,290 @@
+/**
+ * CoverageAuditor
+ * 基于 DocGraph、ModuleGroup 和 GeneratorRegistry 生成覆盖率审计结果。
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { GeneratorRegistry, bootstrapGenerators, } from './generator-registry.js';
+import { resolveSpecForSource, } from './doc-graph-builder.js';
+import { loadTemplate } from './utils/template-loader.js';
+import { getBatchProjectOutputFileName, isBatchProjectGeneratorId, } from './output-filenames.js';
+const ROOT_MODULE_RE = /^root(?:--.+)?$/;
+const SPEC_LINK_RE = /\[[^\]]+\]\(([^)]+?\.spec\.md(?:#[^)]+)?)\)/g;
+export class CoverageAuditor {
+    async audit(options) {
+        const coverageTargets = expandCoverageTargets(options.moduleGroups);
+        const danglingLinks = scanDanglingSpecLinks(options.outputDir, options.projectRoot);
+        const danglingBySpecPath = groupDanglingLinksBySpec(danglingLinks);
+        const missingLinks = options.docGraph.unlinkedSpecs.map((entry) => ({
+            specPath: entry.specPath,
+            sourceTarget: entry.sourceTarget,
+        }));
+        const lowConfidenceSpecs = options.docGraph.specs
+            .filter((spec) => spec.confidence === 'low')
+            .map((spec) => ({
+            specPath: spec.specPath,
+            sourceTarget: spec.sourceTarget,
+            confidence: 'low',
+        }));
+        const moduleCoverage = coverageTargets.map((target) => {
+            const matchedSpecs = target.sourceFiles
+                .map((filePath) => resolveSpecForSource(filePath, options.docGraph.specs))
+                .filter((spec, index, specs) => spec !== undefined
+                && specs.findIndex((candidate) => candidate?.specPath === spec.specPath) === index);
+            const issues = new Set();
+            if (matchedSpecs.length === 0) {
+                issues.add('missing-doc');
+            }
+            for (const spec of matchedSpecs) {
+                if (!spec.linked) {
+                    issues.add('missing-links');
+                }
+                if (spec.confidence === 'low') {
+                    issues.add('low-confidence');
+                }
+                if ((danglingBySpecPath.get(spec.specPath)?.length ?? 0) > 0) {
+                    issues.add('dangling-links');
+                }
+            }
+            const issueList = [...issues].sort(issuePrioritySort);
+            const primarySpec = matchedSpecs[0];
+            const status = issueList.length === 0
+                ? 'documented'
+                : issueList.includes('missing-doc')
+                    ? 'missing-doc'
+                    : 'attention';
+            return {
+                moduleName: target.displayName,
+                dirPath: target.dirPath,
+                level: target.level,
+                sourceFiles: target.sourceFiles,
+                status,
+                issues: issueList,
+                specPath: primarySpec?.specPath,
+                sourceTarget: primarySpec?.sourceTarget,
+            };
+        });
+        const generatorCoverage = await this.buildGeneratorCoverage(options.projectContext, options.outputDir, moduleCoverage);
+        const levelCoverage = summarizeLevelCoverage(moduleCoverage);
+        const documentedModules = moduleCoverage.filter((entry) => !entry.issues.includes('missing-doc')).length;
+        const missingDocCount = moduleCoverage.filter((entry) => entry.issues.includes('missing-doc')).length;
+        const missingLinkCount = moduleCoverage.filter((entry) => entry.issues.includes('missing-links')).length;
+        const moduleGenerator = generatorCoverage.find((entry) => entry.generatorId === 'module-spec');
+        const projectGeneratorEntries = generatorCoverage.filter((entry) => entry.scope === 'project');
+        const generatedGeneratorDocs = projectGeneratorEntries.reduce((sum, entry) => sum + entry.generatedCount, 0);
+        return {
+            title: 'Coverage Audit Report',
+            generatedAt: new Date().toISOString(),
+            projectRoot: options.projectRoot,
+            summary: {
+                totalModules: coverageTargets.length,
+                documentedModules,
+                moduleCoveragePct: percent(documentedModules, coverageTargets.length),
+                missingDocCount,
+                missingLinkCount,
+                danglingLinkCount: danglingLinks.length,
+                lowConfidenceCount: lowConfidenceSpecs.length,
+                applicableGenerators: projectGeneratorEntries.length + (moduleGenerator ? 1 : 0),
+                generatedGeneratorDocs,
+            },
+            moduleCoverage: moduleCoverage.sort((a, b) => a.moduleName.localeCompare(b.moduleName)),
+            missingDocModules: moduleCoverage
+                .filter((entry) => entry.issues.includes('missing-doc'))
+                .sort((a, b) => a.moduleName.localeCompare(b.moduleName)),
+            attentionModules: moduleCoverage
+                .filter((entry) => entry.status === 'attention')
+                .sort((a, b) => a.moduleName.localeCompare(b.moduleName)),
+            generatorCoverage,
+            levelCoverage,
+            danglingLinks,
+            missingLinks,
+            lowConfidenceSpecs,
+        };
+    }
+    render(audit) {
+        const template = loadTemplate('coverage-report.hbs', import.meta.url);
+        return template(audit);
+    }
+    async buildGeneratorCoverage(projectContext, outputDir, moduleCoverage) {
+        bootstrapGenerators();
+        const registry = GeneratorRegistry.getInstance();
+        const moduleSpecCoverage = {
+            generatorId: 'module-spec',
+            generatorName: '模块 Spec',
+            scope: 'module',
+            expectedCount: moduleCoverage.length,
+            generatedCount: moduleCoverage.filter((entry) => !entry.issues.includes('missing-doc')).length,
+            missingCount: moduleCoverage.filter((entry) => entry.issues.includes('missing-doc')).length,
+            coveragePct: percent(moduleCoverage.filter((entry) => !entry.issues.includes('missing-doc')).length, moduleCoverage.length),
+            expectedOutputs: moduleCoverage.map((entry) => entry.moduleName),
+            existingOutputs: moduleCoverage
+                .map((entry) => entry.specPath)
+                .filter((item) => typeof item === 'string'),
+            missingOutputs: moduleCoverage
+                .filter((entry) => entry.issues.includes('missing-doc'))
+                .map((entry) => entry.moduleName),
+        };
+        const applicableGenerators = (await registry.filterByContext(projectContext))
+            .filter((generator) => isBatchProjectGeneratorId(generator.id));
+        const projectEntries = applicableGenerators.map((generator) => {
+            const expectedFile = getBatchProjectOutputFileName(generator.id);
+            const expectedOutputs = [expectedFile];
+            const existingOutputs = expectedOutputs.filter((fileName) => fs.existsSync(path.join(outputDir, fileName)));
+            return {
+                generatorId: generator.id,
+                generatorName: generator.name,
+                scope: 'project',
+                expectedCount: expectedOutputs.length,
+                generatedCount: existingOutputs.length,
+                missingCount: expectedOutputs.length - existingOutputs.length,
+                coveragePct: percent(existingOutputs.length, expectedOutputs.length),
+                expectedOutputs,
+                existingOutputs,
+                missingOutputs: expectedOutputs.filter((item) => !existingOutputs.includes(item)),
+            };
+        });
+        return [moduleSpecCoverage, ...projectEntries].sort((left, right) => left.generatorId.localeCompare(right.generatorId));
+    }
+}
+function expandCoverageTargets(moduleGroups) {
+    return moduleGroups.flatMap((group) => {
+        if (ROOT_MODULE_RE.test(group.name)) {
+            return group.files.map((filePath) => ({
+                unitName: filePath,
+                displayName: filePath,
+                dirPath: path.posix.dirname(filePath) === '.' ? filePath : path.posix.dirname(filePath),
+                level: path.posix.dirname(filePath) === '.' ? 0 : path.posix.dirname(filePath).split('/').length,
+                sourceFiles: [filePath],
+            }));
+        }
+        return [{
+                unitName: group.name,
+                displayName: group.name,
+                dirPath: group.dirPath,
+                level: group.name.split('/').length - 1,
+                sourceFiles: [...group.files].sort((a, b) => a.localeCompare(b)),
+            }];
+    });
+}
+function scanDanglingSpecLinks(outputDir, projectRoot) {
+    if (!fs.existsSync(outputDir)) {
+        return [];
+    }
+    const markdownFiles = [];
+    walkMarkdownFiles(outputDir, markdownFiles);
+    const issues = [];
+    for (const filePath of markdownFiles) {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const matches = content.matchAll(SPEC_LINK_RE);
+        for (const match of matches) {
+            const href = match[1];
+            if (!href) {
+                continue;
+            }
+            const [targetFilePart, anchor] = href.split('#');
+            if (!targetFilePart) {
+                continue;
+            }
+            const targetAbs = path.resolve(path.dirname(filePath), targetFilePart);
+            const normalizedSource = normalizeProjectPath(filePath, projectRoot);
+            const normalizedTarget = normalizeProjectPath(targetAbs, projectRoot);
+            if (!fs.existsSync(targetAbs)) {
+                issues.push({
+                    specPath: normalizedSource,
+                    href,
+                    targetPath: normalizedTarget,
+                    anchor,
+                    reason: 'missing-file',
+                });
+                continue;
+            }
+            if (anchor && !hasAnchor(targetAbs, anchor)) {
+                issues.push({
+                    specPath: normalizedSource,
+                    href,
+                    targetPath: normalizedTarget,
+                    anchor,
+                    reason: 'missing-anchor',
+                });
+            }
+        }
+    }
+    return issues.sort((a, b) => {
+        const left = `${a.specPath}:${a.href}`;
+        const right = `${b.specPath}:${b.href}`;
+        return left.localeCompare(right);
+    });
+}
+function walkMarkdownFiles(dir, results) {
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        if (entry.isSymbolicLink()) {
+            continue;
+        }
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            walkMarkdownFiles(fullPath, results);
+            continue;
+        }
+        if (entry.isFile() && entry.name.endsWith('.md')) {
+            results.push(fullPath);
+        }
+    }
+}
+function hasAnchor(filePath, anchor) {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    return content.includes(`id="${anchor}"`) || content.includes(`name="${anchor}"`);
+}
+function groupDanglingLinksBySpec(danglingLinks) {
+    const grouped = new Map();
+    for (const issue of danglingLinks) {
+        if (!grouped.has(issue.specPath)) {
+            grouped.set(issue.specPath, []);
+        }
+        grouped.get(issue.specPath).push(issue);
+    }
+    return grouped;
+}
+function summarizeLevelCoverage(moduleCoverage) {
+    const levels = new Map();
+    for (const entry of moduleCoverage) {
+        if (!levels.has(entry.level)) {
+            levels.set(entry.level, {
+                level: entry.level,
+                total: 0,
+                documented: 0,
+                missingDoc: 0,
+                attention: 0,
+            });
+        }
+        const levelEntry = levels.get(entry.level);
+        levelEntry.total += 1;
+        if (entry.status === 'documented')
+            levelEntry.documented += 1;
+        if (entry.status === 'missing-doc')
+            levelEntry.missingDoc += 1;
+        if (entry.status === 'attention')
+            levelEntry.attention += 1;
+    }
+    return [...levels.values()].sort((a, b) => a.level - b.level);
+}
+function percent(numerator, denominator) {
+    if (denominator === 0)
+        return 100;
+    return Math.round((numerator / denominator) * 1000) / 10;
+}
+function issuePrioritySort(left, right) {
+    const order = [
+        'missing-doc',
+        'dangling-links',
+        'missing-links',
+        'low-confidence',
+    ];
+    return order.indexOf(left) - order.indexOf(right);
+}
+function normalizeProjectPath(inputPath, projectRoot) {
+    const relative = path.isAbsolute(inputPath)
+        ? path.relative(projectRoot, inputPath)
+        : inputPath;
+    return relative.split(path.sep).join('/');
+}
+//# sourceMappingURL=coverage-auditor.js.map

package/dist/panoramic/coverage-auditor.js.map

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

package/dist/panoramic/cross-package-analyzer.d.ts

@@ -0,0 +1,112 @@
+import type { DocumentGenerator, ProjectContext, GenerateOptions } from './interfaces.js';
+import type { WorkspacePackageInfo } from './workspace-index-generator.js';
+import type { DependencyGraph } from '../models/dependency-graph.js';
+/**
+ * CrossPackageAnalyzer extract() 产出
+ * 包含项目元信息、子包列表和构建好的包级 DependencyGraph
+ */
+export interface CrossPackageInput {
+    /** 项目名称 */
+    projectName: string;
+    /** workspace 管理器类型 */
+    workspaceType: 'npm' | 'pnpm' | 'uv';
+    /** 所有子包元信息列表（复用 WorkspacePackageInfo） */
+    packages: WorkspacePackageInfo[];
+    /** 包级依赖关系图（复用现有 DependencyGraph 类型） */
+    graph: DependencyGraph;
+}
+/**
+ * CrossPackageAnalyzer generate() 产出
+ * 包含渲染 Markdown 文档所需的全部结构化数据
+ */
+export interface CrossPackageOutput {
+    /** 文档标题 */
+    title: string;
+    /** 生成日期（YYYY-MM-DD） */
+    generatedAt: string;
+    /** 项目名称 */
+    projectName: string;
+    /** workspace 管理器类型 */
+    workspaceType: 'npm' | 'pnpm' | 'uv';
+    /** Mermaid graph TD 依赖拓扑图源代码（含循环标注） */
+    mermaidDiagram: string;
+    /** 拓扑排序结果（按 level 分组） */
+    levels: TopologyLevel[];
+    /** 拓扑排序线性顺序（叶子优先） */
+    topologicalOrder: string[];
+    /** 是否存在循环依赖 */
+    hasCycles: boolean;
+    /** 循环依赖组列表（每组为参与循环的包名数组） */
+    cycleGroups: CycleGroup[];
+    /** 统计摘要 */
+    stats: DependencyStats;
+}
+/**
+ * 拓扑排序层级
+ */
+export interface TopologyLevel {
+    /** 层级编号（0 为最底层，无出度） */
+    level: number;
+    /** 该层级的子包名列表 */
+    packages: string[];
+}
+/**
+ * 循环依赖组
+ */
+export interface CycleGroup {
+    /** 参与循环的子包名列表 */
+    packages: string[];
+    /** 循环路径的人类可读表示（如 "A -> B -> C -> A"） */
+    cyclePath: string;
+}
+/**
+ * 依赖统计摘要
+ */
+export interface DependencyStats {
+    /** 子包总数 */
+    totalPackages: number;
+    /** 总依赖边数（不含自依赖和无效依赖） */
+    totalEdges: number;
+    /** Root 包列表（入度为 0，不被任何包依赖） */
+    rootPackages: string[];
+    /** Leaf 包列表（出度为 0，不依赖任何包） */
+    leafPackages: string[];
+}
+/**
+ * 跨包依赖分析器
+ * 实现 DocumentGenerator<CrossPackageInput, CrossPackageOutput> 接口。
+ * 从 Monorepo 项目中分析子包间的依赖关系，检测循环依赖，
+ * 生成带循环标注的 Mermaid 依赖拓扑图和统计信息。
+ */
+export declare class CrossPackageAnalyzer implements DocumentGenerator<CrossPackageInput, CrossPackageOutput> {
+    readonly id: "cross-package-deps";
+    readonly name: "\u8DE8\u5305\u4F9D\u8D56\u5206\u6790\u5668";
+    readonly description = "\u5206\u6790 Monorepo \u5B50\u5305\u95F4\u7684\u4F9D\u8D56\u5173\u7CFB\uFF0C\u68C0\u6D4B\u5FAA\u73AF\u4F9D\u8D56\u5E76\u751F\u6210\u62D3\u6251\u56FE";
+    /**
+     * 判断当前项目是否适用此 Generator（T014）
+     * 仅当 workspaceType === 'monorepo' 时返回 true
+     */
+    isApplicable(context: ProjectContext): boolean;
+    /**
+     * 从项目中提取 workspace 信息并构建包级依赖图（T015）
+     *
+     * 1. 复用 WorkspaceIndexGenerator.extract() 获取子包列表
+     * 2. 将 WorkspacePackageInfo[] 转换为 DependencyGraph
+     */
+    extract(context: ProjectContext): Promise<CrossPackageInput>;
+    /**
+     * 将提取的数据转换为结构化文档输出（T016-T017）
+     *
+     * 1. 调用 detectSCCs 检测循环依赖
+     * 2. 调用 topologicalSort 计算拓扑排序
+     * 3. 构建循环标注 Mermaid 图
+     * 4. 计算统计信息
+     * 5. 按 level 分组拓扑排序结果
+     */
+    generate(input: CrossPackageInput, _options?: GenerateOptions): Promise<CrossPackageOutput>;
+    /**
+     * 使用 Handlebars 模板渲染为 Markdown（T018）
+     */
+    render(output: CrossPackageOutput): string;
+}
+//# sourceMappingURL=cross-package-analyzer.d.ts.map

package/dist/panoramic/cross-package-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-package-analyzer.d.ts","sourceRoot":"","sources":["../../src/panoramic/cross-package-analyzer.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,OAAO,KAAK,EAAE,eAAe,EAA6B,MAAM,+BAA+B,CAAC;AAShG;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;IAEpB,sBAAsB;IACtB,aAAa,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC;IAErC,yCAAyC;IACzC,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IAEjC,uCAAuC;IACvC,KAAK,EAAE,eAAe,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IAEd,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IAEpB,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;IAEpB,sBAAsB;IACtB,aAAa,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC;IAErC,uCAAuC;IACvC,cAAc,EAAE,MAAM,CAAC;IAEvB,yBAAyB;IACzB,MAAM,EAAE,aAAa,EAAE,CAAC;IAExB,qBAAqB;IACrB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAE3B,eAAe;IACf,SAAS,EAAE,OAAO,CAAC;IAEnB,4BAA4B;IAC5B,WAAW,EAAE,UAAU,EAAE,CAAC;IAE1B,WAAW;IACX,KAAK,EAAE,eAAe,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IAEd,gBAAgB;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,iBAAiB;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW;IACX,aAAa,EAAE,MAAM,CAAC;IAEtB,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IAEnB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,EAAE,CAAC;IAEvB,6BAA6B;IAC7B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AA8ED;;;;;GAKG;AACH,qBAAa,oBACX,YAAW,iBAAiB,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;IAEnE,QAAQ,CAAC,EAAE,EAAG,oBAAoB,CAAU;IAC5C,QAAQ,CAAC,IAAI,EAAG,4CAAS,CAAU;IACnC,QAAQ,CAAC,WAAW,0JAAuC;IAE3D;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO;IAI9C;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA0ElE;;;;;;;;OAQG;IACG,QAAQ,CACZ,KAAK,EAAE,iBAAiB,EACxB,QAAQ,CAAC,EAAE,eAAe,GACzB,OAAO,CAAC,kBAAkB,CAAC;IAkG9B;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM;CAI3C"}