spec-gen-cli 1.0.0

package/dist/core/generator/mapping-generator.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Mapping Generator
+ *
+ * Builds a requirement→function mapping artifact from pipeline results and
+ * the dependency graph. Written to .spec-gen/analysis/mapping.json.
+ *
+ * Enables refactoring workflows: dead code detection, naming normalization.
+ */
+import type { PipelineResult } from './spec-pipeline.js';
+import type { DependencyGraphResult } from '../analyzer/dependency-graph.js';
+import type { SearchResult } from '../analyzer/vector-index.js';
+export interface FunctionRef {
+    name: string;
+    file: string;
+    line: number;
+    kind: string;
+    confidence: 'llm' | 'semantic' | 'heuristic';
+}
+export interface RequirementMapping {
+    requirement: string;
+    service: string;
+    domain: string;
+    specFile: string;
+    functions: FunctionRef[];
+}
+export interface MappingArtifact {
+    generatedAt: string;
+    mappings: RequirementMapping[];
+    orphanFunctions: FunctionRef[];
+    stats: {
+        totalRequirements: number;
+        mappedRequirements: number;
+        totalExportedFunctions: number;
+        orphanCount: number;
+    };
+}
+/**
+ * A semantic search function closed over VectorIndex + EmbeddingService + outputDir.
+ * Returns ranked results (closest first, score = cosine distance) for a text query.
+ */
+export type SemanticSearchFn = (query: string, limit: number) => Promise<SearchResult[]>;
+export declare class MappingGenerator {
+    private rootPath;
+    private openspecPath;
+    private semanticSearch?;
+    constructor(rootPath: string, openspecPath?: string, semanticSearch?: SemanticSearchFn);
+    /** Semantic lookup: returns FunctionRefs matched by vector similarity */
+    private semanticMatch;
+    generate(pipeline: PipelineResult, depGraph: DependencyGraphResult): Promise<MappingArtifact>;
+    private write;
+    /** Load an existing mapping artifact */
+    static load(rootPath: string): Promise<MappingArtifact | null>;
+}
+//# sourceMappingURL=mapping-generator.d.ts.map

package/dist/core/generator/mapping-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping-generator.d.ts","sourceRoot":"","sources":["../../../src/core/generator/mapping-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAMhE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,KAAK,GAAG,UAAU,GAAG,WAAW,CAAC;CAC9C;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,WAAW,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,eAAe,EAAE,WAAW,EAAE,CAAC;IAC/B,KAAK,EAAE;QACL,iBAAiB,EAAE,MAAM,CAAC;QAC1B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,sBAAsB,EAAE,MAAM,CAAC;QAC/B,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AA4CD;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;AAQzF,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,cAAc,CAAC,CAAmB;gBAGxC,QAAQ,EAAE,MAAM,EAChB,YAAY,SAAa,EACzB,cAAc,CAAC,EAAE,gBAAgB;IAOnC,yEAAyE;YAC3D,aAAa;IAyBrB,QAAQ,CACZ,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,qBAAqB,GAC9B,OAAO,CAAC,eAAe,CAAC;YAiKb,KAAK;IAKnB,wCAAwC;WAC3B,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;CAWrE"}

package/dist/core/generator/mapping-generator.js

@@ -0,0 +1,239 @@
+/**
+ * Mapping Generator
+ *
+ * Builds a requirement→function mapping artifact from pipeline results and
+ * the dependency graph. Written to .spec-gen/analysis/mapping.json.
+ *
+ * Enables refactoring workflows: dead code detection, naming normalization.
+ */
+import { writeFile, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+// ============================================================================
+// HELPERS
+// ============================================================================
+/** Normalize a name for fuzzy matching: lowercase, alphanumeric only */
+function normalize(name) {
+    return name.toLowerCase().replace(/[^a-z0-9]/g, '');
+}
+/** Split camelCase/PascalCase into tokens for better matching */
+function tokenize(name) {
+    return name
+        .replace(/([A-Z])/g, ' $1')
+        .toLowerCase()
+        .split(/[\s_-]+/)
+        .filter(Boolean);
+}
+/** Score similarity between an operation name and a function name */
+function similarityScore(operationName, functionName) {
+    const opNorm = normalize(operationName);
+    const fnNorm = normalize(functionName);
+    // Exact normalized match
+    if (opNorm === fnNorm)
+        return 1.0;
+    // Containment
+    if (fnNorm.includes(opNorm) || opNorm.includes(fnNorm))
+        return 0.8;
+    // Token overlap
+    const opTokens = new Set(tokenize(operationName));
+    const fnTokens = new Set(tokenize(functionName));
+    const intersection = [...opTokens].filter(t => fnTokens.has(t)).length;
+    const union = new Set([...opTokens, ...fnTokens]).size;
+    if (union === 0)
+        return 0;
+    return (intersection / union) * 0.7;
+}
+/**
+ * Maximum cosine distance to accept a semantic match.
+ * Equivalent to cosine similarity >= 0.65 (distance = 1 - similarity).
+ */
+const SEMANTIC_MAX_DISTANCE = 0.35;
+export class MappingGenerator {
+    rootPath;
+    openspecPath;
+    semanticSearch;
+    constructor(rootPath, openspecPath = 'openspec', semanticSearch) {
+        this.rootPath = rootPath;
+        this.openspecPath = openspecPath;
+        this.semanticSearch = semanticSearch;
+    }
+    /** Semantic lookup: returns FunctionRefs matched by vector similarity */
+    async semanticMatch(query, exportIndex) {
+        if (!this.semanticSearch)
+            return [];
+        let results;
+        try {
+            results = await this.semanticSearch(query, 5);
+        }
+        catch {
+            return [];
+        }
+        const matched = [];
+        for (const r of results.filter(r => r.score <= SEMANTIC_MAX_DISTANCE)) {
+            const refs = exportIndex.get(r.record.name);
+            if (refs && refs.length > 0) {
+                for (const ref of refs) {
+                    matched.push({ ...ref, confidence: 'semantic' });
+                }
+            }
+        }
+        return matched.slice(0, 2);
+    }
+    async generate(pipeline, depGraph) {
+        // Build export index: name → list of FunctionRef (multiple files can export same name)
+        const exportIndex = new Map();
+        for (const node of depGraph.nodes) {
+            const relPath = node.file.path;
+            for (const exp of node.exports) {
+                if (exp.isType)
+                    continue; // skip type-only exports
+                const ref = {
+                    name: exp.name,
+                    file: relPath,
+                    line: exp.line,
+                    kind: exp.kind,
+                    confidence: 'llm', // placeholder, overwritten below
+                };
+                const existing = exportIndex.get(exp.name) ?? [];
+                existing.push(ref);
+                exportIndex.set(exp.name, existing);
+            }
+        }
+        const mappings = [];
+        const mappedFunctionNames = new Set(); // track name+file combos
+        for (const service of pipeline.services) {
+            const domain = service.domain || 'core';
+            const specFile = `${this.openspecPath}/specs/${domain.toLowerCase()}/spec.md`;
+            for (const op of service.operations) {
+                const functions = [];
+                // 1. LLM-provided functionName — direct lookup
+                if (op.functionName && op.functionName.trim()) {
+                    const refs = exportIndex.get(op.functionName.trim());
+                    if (refs && refs.length > 0) {
+                        for (const ref of refs) {
+                            functions.push({ ...ref, confidence: 'llm' });
+                            mappedFunctionNames.add(`${ref.name}::${ref.file}`);
+                        }
+                    }
+                }
+                // 2. Semantic fallback — vector similarity on operation name + description
+                if (functions.length === 0) {
+                    const query = op.description ? `${op.name} ${op.description}` : op.name;
+                    const semanticRefs = await this.semanticMatch(query, exportIndex);
+                    for (const ref of semanticRefs) {
+                        functions.push(ref);
+                        mappedFunctionNames.add(`${ref.name}::${ref.file}`);
+                    }
+                }
+                // 3. Heuristic fallback — find best matching export(s)
+                if (functions.length === 0) {
+                    const scored = [];
+                    for (const [name, refs] of exportIndex) {
+                        const score = similarityScore(op.name, name);
+                        if (score >= 0.7) {
+                            for (const ref of refs) {
+                                scored.push({ ref, score });
+                            }
+                        }
+                    }
+                    scored.sort((a, b) => b.score - a.score);
+                    const top = scored.slice(0, 2); // at most 2 heuristic matches
+                    for (const { ref } of top) {
+                        functions.push({ ...ref, confidence: 'heuristic' });
+                        mappedFunctionNames.add(`${ref.name}::${ref.file}`);
+                    }
+                }
+                mappings.push({
+                    requirement: op.name,
+                    service: service.name,
+                    domain,
+                    specFile,
+                    functions,
+                });
+            }
+            // Sub-spec operations: map each sub-component's operations to its callee function
+            for (const sub of service.subSpecs ?? []) {
+                // The callee is a direct LLM-identified function name — prefer exact match
+                const calleeRefs = exportIndex.get(sub.callee) ?? [];
+                for (const op of sub.operations ?? []) {
+                    const functions = [];
+                    // 1. LLM-provided callee — direct lookup
+                    if (calleeRefs.length > 0) {
+                        for (const ref of calleeRefs) {
+                            functions.push({ ...ref, confidence: 'llm' });
+                            mappedFunctionNames.add(`${ref.name}::${ref.file}`);
+                        }
+                    }
+                    // 2. Semantic fallback
+                    if (functions.length === 0) {
+                        const query = op.description ? `${op.name} ${op.description}` : op.name;
+                        const semanticRefs = await this.semanticMatch(query, exportIndex);
+                        for (const ref of semanticRefs) {
+                            functions.push(ref);
+                            mappedFunctionNames.add(`${ref.name}::${ref.file}`);
+                        }
+                    }
+                    // 3. Heuristic fallback on operation name
+                    if (functions.length === 0) {
+                        const scored = [];
+                        for (const [name, refs] of exportIndex) {
+                            const score = similarityScore(op.name, name);
+                            if (score >= 0.7) {
+                                for (const ref of refs)
+                                    scored.push({ ref, score });
+                            }
+                        }
+                        scored.sort((a, b) => b.score - a.score);
+                        for (const { ref } of scored.slice(0, 2)) {
+                            functions.push({ ...ref, confidence: 'heuristic' });
+                            mappedFunctionNames.add(`${ref.name}::${ref.file}`);
+                        }
+                    }
+                    mappings.push({
+                        requirement: op.name,
+                        service: `${service.name}/${sub.name}`,
+                        domain,
+                        specFile,
+                        functions,
+                    });
+                }
+            }
+        }
+        // Orphan functions: exported, non-type, not referenced in any mapping
+        const orphanFunctions = [];
+        for (const [name, refs] of exportIndex) {
+            for (const ref of refs) {
+                if (!mappedFunctionNames.has(`${name}::${ref.file}`)) {
+                    orphanFunctions.push({ ...ref, confidence: 'heuristic' });
+                }
+            }
+        }
+        const artifact = {
+            generatedAt: new Date().toISOString(),
+            mappings,
+            orphanFunctions,
+            stats: {
+                totalRequirements: mappings.length,
+                mappedRequirements: mappings.filter(m => m.functions.length > 0).length,
+                totalExportedFunctions: [...exportIndex.values()].reduce((s, refs) => s + refs.length, 0),
+                orphanCount: orphanFunctions.length,
+            },
+        };
+        await this.write(artifact);
+        return artifact;
+    }
+    async write(artifact) {
+        const outPath = join(this.rootPath, '.spec-gen', 'analysis', 'mapping.json');
+        await writeFile(outPath, JSON.stringify(artifact, null, 2), 'utf-8');
+    }
+    /** Load an existing mapping artifact */
+    static async load(rootPath) {
+        try {
+            const content = await readFile(join(rootPath, '.spec-gen', 'analysis', 'mapping.json'), 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=mapping-generator.js.map

package/dist/core/generator/mapping-generator.js.map

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

package/dist/core/generator/openspec-compat.d.ts

@@ -0,0 +1,160 @@
+/**
+ * OpenSpec Compatibility Layer
+ *
+ * Ensures perfect compatibility with OpenSpec's tooling and conventions.
+ * Handles config.yaml integration, validation, and context injection.
+ */
+import type { ProjectSurveyResult } from './spec-pipeline.js';
+/**
+ * Validation result for specs and config
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * OpenSpec config.yaml structure
+ */
+export interface OpenSpecConfig {
+    schema?: string;
+    context?: string;
+    rules?: {
+        proposal?: string[];
+        specs?: string[];
+        design?: string[];
+        tasks?: string[];
+    };
+    'spec-gen'?: SpecGenMetadata;
+}
+/**
+ * spec-gen metadata added to config.yaml
+ */
+export interface SpecGenMetadata {
+    version: string;
+    generatedAt: string;
+    domains: string[];
+    confidence: number;
+    adrCount?: number;
+}
+/**
+ * Detected project context for injection
+ */
+export interface DetectedContext {
+    techStack: string;
+    architecture: string;
+    domains: string[];
+    patterns: string[];
+}
+/**
+ * Options for context update
+ */
+export interface ContextUpdateOptions {
+    preserveUserContext: boolean;
+    appendDetectedInfo: boolean;
+    version: string;
+}
+/**
+ * OpenSpec validator for specs and configuration
+ */
+export declare class OpenSpecValidator {
+    /**
+     * Validate the complete spec structure
+     */
+    validateSpecStructure(content: string): ValidationResult;
+    /**
+     * Validate requirement format follows RFC 2119
+     */
+    validateRequirementFormat(requirement: string): ValidationResult;
+    /**
+     * Validate scenario format (Given/When/Then)
+     */
+    validateScenarioFormat(scenario: string): ValidationResult;
+    /**
+     * Validate config.yaml structure
+     */
+    validateConfigYaml(config: unknown): ValidationResult;
+    /**
+     * Check heading hierarchy is valid (no skipped levels)
+     */
+    private checkHeadingHierarchy;
+    /**
+     * Check for malformed markdown links
+     */
+    private checkMarkdownLinks;
+}
+/**
+ * OpenSpec config.yaml manager
+ */
+export declare class OpenSpecConfigManager {
+    private configPath;
+    private openspecRoot;
+    constructor(projectRoot: string);
+    /**
+     * Check if OpenSpec is initialized
+     */
+    isInitialized(): Promise<boolean>;
+    /**
+     * Check if config.yaml exists
+     */
+    hasConfig(): Promise<boolean>;
+    /**
+     * Read existing config.yaml
+     */
+    readConfig(): Promise<OpenSpecConfig | null>;
+    /**
+     * Write config.yaml, preserving user content
+     */
+    writeConfig(config: OpenSpecConfig): Promise<void>;
+    /**
+     * Update config with spec-gen metadata while preserving user content
+     */
+    updateWithSpecGenMetadata(metadata: SpecGenMetadata, detectedContext?: DetectedContext, options?: ContextUpdateOptions): Promise<OpenSpecConfig>;
+    /**
+     * Build context string combining user and detected info
+     */
+    private buildContext;
+    /**
+     * Get existing user context from config
+     */
+    getUserContext(): Promise<string | null>;
+    /**
+     * Get existing domains from specs directory
+     */
+    getExistingDomains(): Promise<string[]>;
+}
+/**
+ * Build detected context from analysis results
+ */
+export declare function buildDetectedContext(survey: ProjectSurveyResult): DetectedContext;
+/**
+ * Normalize domain name to OpenSpec conventions
+ */
+export declare function normalizeDomainName(name: string): string;
+/**
+ * Check if domain name follows conventions
+ */
+export declare function isValidDomainName(name: string): boolean;
+/**
+ * Match suggested domains against existing domains
+ */
+export declare function matchExistingDomains(suggestedDomains: string[], existingDomains: string[]): Map<string, string>;
+/**
+ * Validate a complete spec file
+ */
+export declare function validateFullSpec(content: string): ValidationResult;
+/**
+ * Validate all specs in a directory
+ */
+export declare function validateSpecsDirectory(specsDir: string): Promise<{
+    valid: boolean;
+    results: Map<string, ValidationResult>;
+}>;
+/**
+ * Create a new OpenSpec compatibility helper
+ */
+export declare function createOpenSpecCompat(projectRoot: string): {
+    validator: OpenSpecValidator;
+    configManager: OpenSpecConfigManager;
+};
+//# sourceMappingURL=openspec-compat.d.ts.map

package/dist/core/generator/openspec-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openspec-compat.d.ts","sourceRoot":"","sources":["../../../src/core/generator/openspec-compat.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAM9D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE;QACN,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;IACF,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD;;GAEG;AACH,qBAAa,iBAAiB;IAC5B;;OAEG;IACH,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB;IA2CxD;;OAEG;IACH,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB;IA2BhE;;OAEG;IACH,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB;IAgD1D;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB;IAiErD;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAmB7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAyB3B;AAMD;;GAEG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAS;gBAEjB,WAAW,EAAE,MAAM;IAK/B;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;IASvC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IASnC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IASlD;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAOxD;;OAEG;IACG,yBAAyB,CAC7B,QAAQ,EAAE,eAAe,EACzB,eAAe,CAAC,EAAE,eAAe,EACjC,OAAO,GAAE,oBAIR,GACA,OAAO,CAAC,cAAc,CAAC;IAqB1B;;OAEG;IACH,OAAO,CAAC,YAAY;IA0BpB;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAK9C;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAY9C;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,GAAG,eAAe,CAsCjF;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMxD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAavD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,gBAAgB,EAAE,MAAM,EAAE,EAC1B,eAAe,EAAE,MAAM,EAAE,GACxB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAsBrB;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAwBlE;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IACtE,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CACxC,CAAC,CAqCD;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG;IACzD,SAAS,EAAE,iBAAiB,CAAC;IAC7B,aAAa,EAAE,qBAAqB,CAAC;CACtC,CAKA"}