@massa-ai/core 1.2.1

package/dist/services/compression/code-compressor.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Code Compressor
+ *
+ * Semantic compression for source code
+ * Strategy: Keep structure, remove implementation details
+ */
+import { ICompressor } from '@massa-ai/shared';
+import { CompressedContent, CompressionStrategy } from '@massa-ai/shared';
+import { type LlmResult } from '../memory/llm-client.js';
+/**
+ * Injectable LLM-complete surface (mirrors the real `llmComplete` signature).
+ * Tests inject a fake; production uses the default export.
+ */
+export type CompressLlmComplete = (prompt: string, opts?: {
+    system?: string;
+    timeoutMs?: number;
+    modelRole?: "instruct" | "code";
+}) => Promise<LlmResult<string>>;
+export declare class CodeCompressor implements ICompressor {
+    private strategy;
+    private languageCache;
+    private readonly llmCompleteFn;
+    /**
+     * @param llmCompleteFn Optional injectable LLM-complete surface for tests.
+     *   Production callers omit it; the real `llmComplete` is used. The LLM path
+     *   is gated on `config.get("llm").enabled` and silent-degrades to the regex
+     *   path on LLM off / {ok:false} / throw / over-long / empty output.
+     */
+    constructor(llmCompleteFn?: CompressLlmComplete);
+    /**
+     * Compress source code
+     */
+    compress(content: string, strategy?: CompressionStrategy): Promise<CompressedContent>;
+    /**
+     * Decompress (return original)
+     */
+    decompress(compressed: CompressedContent): Promise<string>;
+    /**
+     * Estimate compression ratio
+     */
+    estimateCompression(content: string): Promise<number>;
+    getStrategy(): CompressionStrategy;
+    /**
+     * Compress by extracting structure only
+     */
+    private compressStructure;
+    /**
+     * Extract code structure (signatures only)
+     */
+    private extractStructure;
+    /**
+     * Check if line is a function declaration
+     */
+    private isFunctionDeclaration;
+    /**
+     * Extract signature from line (remove implementation)
+     */
+    private extractSignature;
+    /**
+     * Convert structure to compressed text
+     */
+    private structureToText;
+    /**
+     * Remove semantically duplicate code
+     */
+    private deduplicateSemantics;
+    /**
+     * Detect programming language from content
+     */
+    private detectLanguage;
+    /**
+     * Get cached language detection
+     */
+    private getCachedLanguage;
+}
+//# sourceMappingURL=code-compressor.d.ts.map

package/dist/services/compression/code-compressor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-compressor.d.ts","sourceRoot":"","sources":["../../../src/services/compression/code-compressor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAI1E,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEpF;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,UAAU,GAAG,MAAM,CAAA;CAAE,KAC5E,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;AAahC,qBAAa,cAAe,YAAW,WAAW;IAChD,OAAO,CAAC,QAAQ,CAA2D;IAC3E,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IAEpD;;;;;OAKG;gBACS,aAAa,GAAE,mBAAiC;IAI5D;;OAEG;IACG,QAAQ,CACZ,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,mBAAmB,GAC7B,OAAO,CAAC,iBAAiB,CAAC;IAgI7B;;OAEG;IACG,UAAU,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IAIhE;;OAEG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAU3D,WAAW,IAAI,mBAAmB;IAIlC;;OAEG;YACW,iBAAiB;IAiB/B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAoFxB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAS7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAsCvB;;OAEG;YACW,oBAAoB;IAwBlC;;OAEG;IACH,OAAO,CAAC,cAAc;IA0DtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAmB1B"}

package/dist/services/compression/code-compressor.js

@@ -0,0 +1,395 @@
+/**
+ * Code Compressor
+ *
+ * Semantic compression for source code
+ * Strategy: Keep structure, remove implementation details
+ */
+import { CompressionStrategy } from '@massa-ai/shared';
+import { CompressedContent as CompressedContentModel } from '../../models/CompressedContent.js';
+import { config, logger } from '@massa-ai/shared';
+import { MetricsCollector } from '@massa-ai/shared';
+import { llmComplete, isLlmEnabled } from '../memory/llm-client.js';
+export class CodeCompressor {
+    strategy = CompressionStrategy.CODE_STRUCTURE;
+    languageCache = new Map();
+    llmCompleteFn;
+    /**
+     * @param llmCompleteFn Optional injectable LLM-complete surface for tests.
+     *   Production callers omit it; the real `llmComplete` is used. The LLM path
+     *   is gated on `config.get("llm").enabled` and silent-degrades to the regex
+     *   path on LLM off / {ok:false} / throw / over-long / empty output.
+     */
+    constructor(llmCompleteFn = llmComplete) {
+        this.llmCompleteFn = llmCompleteFn;
+    }
+    /**
+     * Compress source code
+     */
+    async compress(content, strategy) {
+        const useStrategy = strategy || this.strategy;
+        try {
+            logger.debug('Compressing code', {
+                strategy: useStrategy,
+                originalLength: content.length
+            });
+            let compressed;
+            let preservedElements = [];
+            switch (useStrategy) {
+                case CompressionStrategy.CODE_STRUCTURE: {
+                    // Phase 7d: regex output is ALWAYS computed first (cheap) so the
+                    // fallback is instant. Then, if the LLM is enabled, try to improve on
+                    // it toward config.compression.targetCompressionRatio.
+                    const result = await this.compressStructure(content);
+                    compressed = result.compressed;
+                    preservedElements = result.preserved;
+                    let compressionSource = "regex";
+                    // Phase 7d: LLM path gated on isLlmEnabled() (which honors the test
+                    // seam + reads config defensively). No separate config.get("llm")
+                    // gate, so the LLM-off/feature-off path is test-seam-driven and
+                    // immune to process-wide mock.module config collisions.
+                    if (isLlmEnabled() && content.trim().length > 0) {
+                        const language = this.getCachedLanguage(content);
+                        let targetRatio = 0.7;
+                        let timeoutMs;
+                        try {
+                            targetRatio = config.get("compression").targetCompressionRatio ?? 0.7;
+                        }
+                        catch {
+                            targetRatio = 0.7;
+                        }
+                        try {
+                            timeoutMs = config.get("llm").timeoutMs;
+                        }
+                        catch {
+                            timeoutMs = undefined;
+                        }
+                        const prompt = buildLlmCompressPrompt(content, language, targetRatio, preservedElements);
+                        try {
+                            const res = await this.llmCompleteFn(prompt, { timeoutMs, modelRole: "code" });
+                            if (res.ok &&
+                                typeof res.value === "string" &&
+                                res.value.trim().length > 0 &&
+                                res.value.length <= content.length) {
+                                compressed = res.value;
+                                compressionSource = "llm";
+                            }
+                            else if (!res.ok) {
+                                logger.debug("LLM compression {ok:false} — using regex output");
+                            }
+                        }
+                        catch (e) {
+                            logger.debug("LLM compression threw — using regex output", {
+                                error: e.message,
+                            });
+                        }
+                    }
+                    const language = this.getCachedLanguage(content);
+                    const compressedContent = CompressedContentModel.create(content, compressed, useStrategy, language || 'unknown', preservedElements, compressionSource);
+                    MetricsCollector.recordCompression(compressedContent.metadata.originalTokens, compressedContent.metadata.compressedTokens);
+                    logger.info('Code compressed', {
+                        ratio: compressedContent.compressionRatio,
+                        tokensSaved: compressedContent.tokensSaved,
+                        language,
+                        compressionSource,
+                    });
+                    return compressedContent;
+                }
+                case CompressionStrategy.SEMANTIC_DEDUP:
+                    compressed = await this.deduplicateSemantics(content);
+                    break;
+                default:
+                    compressed = content;
+            }
+            // Detect language (with caching)
+            const language = this.getCachedLanguage(content);
+            const compressedContent = CompressedContentModel.create(content, compressed, useStrategy, language || 'unknown', preservedElements);
+            // Record metrics for optimization tracking
+            MetricsCollector.recordCompression(compressedContent.metadata.originalTokens, compressedContent.metadata.compressedTokens);
+            logger.info('Code compressed', {
+                ratio: compressedContent.compressionRatio,
+                tokensSaved: compressedContent.tokensSaved,
+                language
+            });
+            return compressedContent;
+        }
+        catch (error) {
+            logger.error('Code compression failed', error);
+            return CompressedContentModel.identity(content);
+        }
+    }
+    /**
+     * Decompress (return original)
+     */
+    async decompress(compressed) {
+        return compressed.original;
+    }
+    /**
+     * Estimate compression ratio
+     */
+    async estimateCompression(content) {
+        const structure = this.extractStructure(content);
+        const structureText = this.structureToText(structure);
+        return CompressedContentModel.calculateRatio(CompressedContentModel.estimateTokens(content), CompressedContentModel.estimateTokens(structureText));
+    }
+    getStrategy() {
+        return this.strategy;
+    }
+    /**
+     * Compress by extracting structure only
+     */
+    async compressStructure(content) {
+        const structure = this.extractStructure(content);
+        const compressed = this.structureToText(structure);
+        const preserved = [
+            ...structure.imports,
+            ...structure.interfaces,
+            ...structure.classes,
+            ...structure.functions,
+            ...structure.exports
+        ];
+        return { compressed, preserved };
+    }
+    /**
+     * Extract code structure (signatures only)
+     */
+    extractStructure(content) {
+        const lines = content.split('\n');
+        const structure = {
+            imports: [],
+            interfaces: [],
+            classes: [],
+            functions: [],
+            exports: []
+        };
+        let inMultilineComment = false;
+        let inInterface = false;
+        let inClass = false;
+        let braceDepth = 0;
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i].trim();
+            // Skip empty lines
+            if (!line)
+                continue;
+            // Handle multi-line comments
+            if (line.includes('/*'))
+                inMultilineComment = true;
+            if (line.includes('*/')) {
+                inMultilineComment = false;
+                continue;
+            }
+            if (inMultilineComment)
+                continue;
+            // Skip single-line comments (but preserve JSDoc)
+            if (line.startsWith('//') && !line.startsWith('/**'))
+                continue;
+            // Track brace depth
+            braceDepth += (line.match(/{/g) || []).length;
+            braceDepth -= (line.match(/}/g) || []).length;
+            // Imports
+            if (line.startsWith('import ')) {
+                structure.imports.push(line);
+                continue;
+            }
+            // Exports
+            if (line.startsWith('export ')) {
+                // Handle export declarations
+                if (line.includes('class ') || line.includes('interface ') ||
+                    line.includes('function ') || line.includes('const ')) {
+                    structure.exports.push(line.split('{')[0].trim());
+                }
+            }
+            // Interfaces
+            if (line.includes('interface ')) {
+                inInterface = true;
+                const signature = this.extractSignature(line);
+                structure.interfaces.push(signature);
+                continue;
+            }
+            // Classes
+            if (line.includes('class ')) {
+                inClass = true;
+                const signature = this.extractSignature(line);
+                structure.classes.push(signature);
+                continue;
+            }
+            // Functions/Methods
+            if (this.isFunctionDeclaration(line)) {
+                const signature = this.extractSignature(line);
+                structure.functions.push(signature);
+                continue;
+            }
+            // End of interface/class
+            if (braceDepth === 0) {
+                inInterface = false;
+                inClass = false;
+            }
+        }
+        return structure;
+    }
+    /**
+     * Check if line is a function declaration
+     */
+    isFunctionDeclaration(line) {
+        return (line.includes('function ') ||
+            line.includes('=>') ||
+            /^(public|private|protected|async)?\s*\w+\s*\(/.test(line) ||
+            /^(static\s+)?(?:Future(?:<[^>]+>)?|void|int|double|String|bool|dynamic|num|[A-Z]\w*(?:<[^>]+>)?)\s+\w+\s*\(/.test(line));
+    }
+    /**
+     * Extract signature from line (remove implementation)
+     */
+    extractSignature(line) {
+        // Remove implementation (everything after opening brace)
+        const signature = line.split('{')[0].trim();
+        // Remove inline comments
+        return signature.replace(/\/\/.*$/, '').trim();
+    }
+    /**
+     * Convert structure to compressed text
+     */
+    structureToText(structure) {
+        const parts = [];
+        if (structure.imports.length > 0) {
+            parts.push('// Imports');
+            parts.push(...structure.imports.slice(0, 5)); // Limit to top 5
+            if (structure.imports.length > 5) {
+                parts.push(`// ... ${structure.imports.length - 5} more imports`);
+            }
+            parts.push('');
+        }
+        if (structure.interfaces.length > 0) {
+            parts.push('// Interfaces');
+            parts.push(...structure.interfaces);
+            parts.push('');
+        }
+        if (structure.classes.length > 0) {
+            parts.push('// Classes');
+            parts.push(...structure.classes);
+            parts.push('');
+        }
+        if (structure.functions.length > 0) {
+            parts.push('// Functions');
+            parts.push(...structure.functions);
+            parts.push('');
+        }
+        if (structure.exports.length > 0) {
+            parts.push('// Exports');
+            parts.push(...structure.exports);
+        }
+        return parts.join('\n');
+    }
+    /**
+     * Remove semantically duplicate code
+     */
+    async deduplicateSemantics(content) {
+        const lines = content.split('\n');
+        const seen = new Set();
+        const deduplicated = [];
+        for (const line of lines) {
+            const normalized = line.trim().toLowerCase();
+            // Skip empty lines
+            if (!normalized) {
+                deduplicated.push(line);
+                continue;
+            }
+            // Check for semantic duplicates
+            if (!seen.has(normalized)) {
+                seen.add(normalized);
+                deduplicated.push(line);
+            }
+        }
+        return deduplicated.join('\n');
+    }
+    /**
+     * Detect programming language from content
+     */
+    detectLanguage(content) {
+        // Kotlin (check before Dart — both use import-without-from, but Kotlin has `fun`/`val`/`var`/`package`)
+        const hasKtFun = /\bfun\s+\w+\s*\(/.test(content);
+        const hasKtValVar = /\b(?:val|var)\s+\w+\s*(?::\s*\w+[?*<>]*\s*)?(?:=)/.test(content);
+        const hasKtPackage = /^package\s+[\w.]+/m.test(content);
+        const hasKtImport = /^import\s+[\w.]+\.\w+/m.test(content);
+        const hasKtClassLike = /\b(?:data\s+class|sealed\s+class|object\s+\w+|companion\s+object|expect\s+(?:class|fun)|actual\s+(?:class|fun))\b/.test(content);
+        if ((hasKtFun || hasKtValVar || hasKtClassLike) &&
+            (hasKtPackage || hasKtImport)) {
+            return "kotlin";
+        }
+        if (hasKtFun && !content.includes("import ") && !content.includes("from ")) {
+            return "kotlin";
+        }
+        const hasDartOnlyDirective = /(\blibrary\s+[a-zA-Z_][\w.]*\s*;|\bpart\s+of\s+[a-zA-Z_][\w.]*\s*;)/.test(content);
+        const hasDartType = /\b(class|enum|mixin|extension)\s+\w+/.test(content);
+        const hasDartMain = /\bvoid\s+main\s*\(/.test(content);
+        const hasPartOfQuoted = /\bpart\s+of\s+['"][^'"]+['"]\s*;/.test(content);
+        const hasDartImport = /\bimport\s+['"](dart:|package:)[^'"]+['"]\s*;/.test(content);
+        const hasDartMixin = /\bmixin\s+\w+/.test(content);
+        if (hasDartMain ||
+            hasPartOfQuoted ||
+            hasDartImport ||
+            (hasDartOnlyDirective && hasDartType) ||
+            (hasDartMixin && hasDartType)) {
+            return 'dart';
+        }
+        if (content.includes('import ') && content.includes('from ')) {
+            if (content.includes(': ') || content.includes('interface ')) {
+                return 'typescript';
+            }
+            return 'javascript';
+        }
+        if (content.includes('def ') && content.includes(':')) {
+            return 'python';
+        }
+        if (content.includes('fn ') && content.includes('->')) {
+            return 'rust';
+        }
+        if (content.includes('package ') && content.includes('func ')) {
+            return 'go';
+        }
+        return 'unknown';
+    }
+    /**
+     * Get cached language detection
+     */
+    getCachedLanguage(content) {
+        // Use content hash as cache key (simple approach)
+        const hash = content.slice(0, 100); // First 100 chars as pseudo-hash
+        if (!this.languageCache.has(hash)) {
+            const language = this.detectLanguage(content);
+            this.languageCache.set(hash, language);
+            // Limit cache size
+            if (this.languageCache.size > 100) {
+                const firstKey = this.languageCache.keys().next().value;
+                if (firstKey) {
+                    this.languageCache.delete(firstKey);
+                }
+            }
+        }
+        return this.languageCache.get(hash);
+    }
+}
+// ─── Phase 7d: LLM compress prompt builder ────────────────────────────────────
+/** Cap content fed to the LLM to bound prompt size. */
+const LLM_COMPRESS_CONTENT_CAP = 6000;
+/**
+ * Build the LLM compression prompt. Targets `targetRatio` and lists the
+ * regex-extracted `preservedSignatures` as "must preserve" so the LLM output
+ * keeps the same load-bearing structure the regex path would have surfaced.
+ */
+function buildLlmCompressPrompt(content, language, targetRatio, preservedSignatures) {
+    const slice = content.slice(0, LLM_COMPRESS_CONTENT_CAP);
+    const sigs = preservedSignatures.length > 0
+        ? preservedSignatures.slice(0, 30).join("\n")
+        : "(none detected)";
+    return [
+        `Compress the following ${language || "source"} code to ~${Math.round(targetRatio * 100)}% of its length while preserving every public signature (imports, exported functions, classes, interfaces) and the overall structure.`,
+        "Remove comments, blank lines, and implementation bodies; keep signatures and type info.",
+        "Output ONLY the compressed code, no prose.",
+        "",
+        "Must-preserve signatures:",
+        sigs,
+        "",
+        "Code:",
+        slice,
+    ].join("\n");
+}
+//# sourceMappingURL=code-compressor.js.map

package/dist/services/compression/code-compressor.js.map

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

package/dist/services/compression/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Compression Services Export
+ */
+export { CodeCompressor } from './code-compressor.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/compression/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/compression/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/services/compression/index.js

@@ -0,0 +1,5 @@
+/**
+ * Compression Services Export
+ */
+export { CodeCompressor } from './code-compressor.js';
+//# sourceMappingURL=index.js.map

package/dist/services/compression/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/compression/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/services/context/session-file-cache.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Session File Cache
+ *
+ * Tracks which file chunks have already been delivered to an LLM in the
+ * current conversation session.  Enables diff-only context delivery:
+ *
+ *   • "new"       → first time this chunk is seen; deliver full content.
+ *   • "unchanged" → already delivered, content identical; deliver a compact
+ *                   reference token instead (~8 tokens vs hundreds).
+ *   • "changed"   → already delivered, content differs; deliver a line-level
+ *                   diff block instead of the full new content.
+ *
+ * Lifecycle:  purely in-memory (no persistence).  Sessions are evicted by
+ * LRU after MAX_SESSIONS entries or after SESSION_TTL_MS inactivity.
+ */
+/** Approximate token cost of a single reference tag `[CACHED: path:L1-L2]`. */
+export declare const REFERENCE_TOKEN_COST = 8;
+export type ChunkStatus = "new" | "unchanged" | "changed";
+export interface ChunkCheckResult {
+    status: ChunkStatus;
+    /**
+     * Only set when status === "changed".
+     * Contains a compact "+/-" line-level diff between the previous and
+     * current content of the chunk.
+     */
+    diff?: string;
+    /**
+     * Approximate tokens saved by NOT delivering full content.
+     * 0 when status === "new".
+     */
+    tokensSaved: number;
+}
+export interface SessionCacheStats {
+    trackedSessions: number;
+    totalChecks: number;
+    cacheHits: number;
+    unchangedHits: number;
+    changedHits: number;
+    totalTokensSaved: number;
+}
+/**
+ * Singleton session-scoped file chunk cache.
+ */
+export declare class SessionFileCache {
+    private static instance;
+    /** sessionId  →  chunkKey  →  ChunkRecord */
+    private readonly sessions;
+    /** sessionId → last-access timestamp (ms) — used for LRU eviction */
+    private readonly lastAccess;
+    private readonly stats;
+    private constructor();
+    static getInstance(): SessionFileCache;
+    /**
+     * Build the canonical chunk key from file metadata.
+     *
+     * @param filePath   Relative or absolute path of the file.
+     * @param lineStart  First line of the chunk (1-based).
+     * @param lineEnd    Last line of the chunk (1-based, inclusive).
+     */
+    chunkKey(filePath: string, lineStart: number, lineEnd: number): string;
+    /**
+     * Check whether a chunk should be delivered in full, as a reference token,
+     * or as a diff block.
+     *
+     * Call this once per chunk per `getOptimizedContext` invocation.  The cache
+     * is updated automatically: on a cache miss the chunk is stored; on a
+     * "changed" hit the record is updated with the new content.
+     *
+     * @param sessionId  Conversation / session identifier.
+     * @param key        Chunk key produced by `chunkKey()`.
+     * @param content    Current full text content of the chunk.
+     */
+    check(sessionId: string, key: string, content: string): ChunkCheckResult;
+    /**
+     * Invalidate all tracked chunks for a session.
+     * Useful when the caller explicitly requests a fresh context.
+     */
+    invalidateSession(sessionId: string): void;
+    /** Global statistics across all sessions. */
+    getStats(): SessionCacheStats;
+    private hashContent;
+    /** Ensure the session map exists and refresh its LRU timestamp. */
+    private touch;
+    /** LRU + TTL eviction when we exceed MAX_SESSIONS. */
+    private evictIfNeeded;
+}
+//# sourceMappingURL=session-file-cache.d.ts.map

package/dist/services/context/session-file-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-file-cache.d.ts","sourceRoot":"","sources":["../../../src/services/context/session-file-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAQH,+EAA+E;AAC/E,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAUtC,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,WAAW,GAAG,SAAS,CAAC;AAE1D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,WAAW,CAAC;IACpB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAgDD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiC;IAExD,6CAA6C;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+C;IAExE,qEAAqE;IACrE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA6B;IAExD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAMpB;IAEF,OAAO;IAEP,MAAM,CAAC,WAAW,IAAI,gBAAgB;IAStC;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAItE;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,gBAAgB;IA8DxE;;;OAGG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAM1C,6CAA6C;IAC7C,QAAQ,IAAI,iBAAiB;IAS7B,OAAO,CAAC,WAAW;IAInB,mEAAmE;IACnE,OAAO,CAAC,KAAK;IASb,sDAAsD;IACtD,OAAO,CAAC,aAAa;CA8BtB"}