sdl-mcp 0.6.0

package/dist/delta/diff.js

@@ -0,0 +1,236 @@
+import { getDb } from "../db/db.js";
+import { logger } from "../util/logger.js";
+import { STABILITY_SCORE_INTERFACE, STABILITY_SCORE_BEHAVIOR, STABILITY_SCORE_SIDE_EFFECTS, } from "../config/constants.js";
+function getSymbolVersions(versionId) {
+    return getDb()
+        .prepare("SELECT * FROM symbol_versions WHERE version_id = ?")
+        .all(versionId);
+}
+export function computeDelta(repoId, fromVersion, toVersion) {
+    const fromVersions = getSymbolVersions(fromVersion);
+    const toVersions = getSymbolVersions(toVersion);
+    if (fromVersions.length === 0) {
+        throw new Error(`No symbol snapshots found for fromVersion ${fromVersion}. Run indexing to create snapshots.`);
+    }
+    if (toVersions.length === 0) {
+        throw new Error(`No symbol snapshots found for toVersion ${toVersion}. Run indexing to create snapshots.`);
+    }
+    const fromMap = new Map(fromVersions.map((v) => [v.symbol_id, v]));
+    const toMap = new Map(toVersions.map((v) => [v.symbol_id, v]));
+    const changedSymbols = [];
+    for (const [symbolId, toRow] of toMap) {
+        const fromRow = fromMap.get(symbolId);
+        if (!fromRow) {
+            changedSymbols.push({
+                symbolId,
+                changeType: "added",
+            });
+            continue;
+        }
+        const signatureDiff = diffSignature(fromRow.signature_json, toRow.signature_json);
+        const invariantDiff = diffArray(fromRow.invariants_json, toRow.invariants_json);
+        const sideEffectDiff = diffArray(fromRow.side_effects_json, toRow.side_effects_json);
+        const isModified = fromRow.ast_fingerprint !== toRow.ast_fingerprint ||
+            fromRow.summary !== toRow.summary ||
+            signatureDiff !== undefined ||
+            invariantDiff !== undefined ||
+            sideEffectDiff !== undefined;
+        if (isModified) {
+            changedSymbols.push({
+                symbolId,
+                changeType: "modified",
+                signatureDiff,
+                invariantDiff,
+                sideEffectDiff,
+            });
+        }
+    }
+    for (const [symbolId] of fromMap) {
+        if (!toMap.has(symbolId)) {
+            changedSymbols.push({
+                symbolId,
+                changeType: "removed",
+            });
+        }
+    }
+    return {
+        repoId,
+        fromVersion,
+        toVersion,
+        changedSymbols,
+        blastRadius: [],
+    };
+}
+export function diffSignature(before, after) {
+    if (before === after) {
+        return undefined;
+    }
+    let beforeObj = null;
+    if (before !== null) {
+        try {
+            beforeObj = JSON.parse(before);
+        }
+        catch (e) {
+            logger.warn(`Failed to parse JSON in diffSignature (before): ${e.message}`);
+        }
+    }
+    let afterObj = null;
+    if (after !== null) {
+        try {
+            afterObj = JSON.parse(after);
+        }
+        catch (e) {
+            logger.warn(`Failed to parse JSON in diffSignature (after): ${e.message}`);
+        }
+    }
+    const beforeStr = JSON.stringify(beforeObj);
+    const afterStr = JSON.stringify(afterObj);
+    if (beforeStr === afterStr) {
+        return undefined;
+    }
+    return {
+        before: before ?? undefined,
+        after: after ?? undefined,
+    };
+}
+export function diffArray(before, after) {
+    if (before === after) {
+        return undefined;
+    }
+    let beforeArr = [];
+    if (before !== null) {
+        try {
+            beforeArr = JSON.parse(before);
+        }
+        catch (e) {
+            logger.warn(`Failed to parse JSON in diffArray (before): ${e.message}`);
+            beforeArr = [];
+        }
+    }
+    let afterArr = [];
+    if (after !== null) {
+        try {
+            afterArr = JSON.parse(after);
+        }
+        catch (e) {
+            logger.warn(`Failed to parse JSON in diffArray (after): ${e.message}`);
+            afterArr = [];
+        }
+    }
+    const beforeSet = new Set(beforeArr);
+    const afterSet = new Set(afterArr);
+    const added = [];
+    const removed = [];
+    for (const item of afterSet) {
+        if (!beforeSet.has(item)) {
+            added.push(item);
+        }
+    }
+    for (const item of beforeSet) {
+        if (!afterSet.has(item)) {
+            removed.push(item);
+        }
+    }
+    if (added.length === 0 && removed.length === 0) {
+        return undefined;
+    }
+    return { added, removed };
+}
+export function computeStalenessTiers(change, fromRow, toRow) {
+    const interfaceStable = change.signatureDiff === undefined;
+    const sideEffectsStable = change.sideEffectDiff === undefined;
+    let behaviorStable = false;
+    if (fromRow && toRow) {
+        const astFingerprintUnchanged = fromRow.ast_fingerprint === toRow.ast_fingerprint;
+        const summaryUnchanged = fromRow.summary === toRow.summary;
+        behaviorStable = astFingerprintUnchanged && summaryUnchanged;
+    }
+    let stabilityScore = (interfaceStable ? STABILITY_SCORE_INTERFACE : 0) +
+        (behaviorStable ? STABILITY_SCORE_BEHAVIOR : 0) +
+        (sideEffectsStable ? STABILITY_SCORE_SIDE_EFFECTS : 0);
+    if (stabilityScore < 0 || stabilityScore > 100) {
+        stabilityScore = Math.max(0, Math.min(100, stabilityScore));
+    }
+    const riskScore = 100 - stabilityScore;
+    return {
+        interfaceStable,
+        behaviorStable,
+        sideEffectsStable,
+        riskScore,
+    };
+}
+export function computeDeltaWithTiers(repoId, fromVersion, toVersion) {
+    const fromVersions = getSymbolVersions(fromVersion);
+    const toVersions = getSymbolVersions(toVersion);
+    if (fromVersions.length === 0) {
+        throw new Error(`No symbol snapshots found for fromVersion ${fromVersion}. Run indexing to create snapshots.`);
+    }
+    if (toVersions.length === 0) {
+        throw new Error(`No symbol snapshots found for toVersion ${toVersion}. Run indexing to create snapshots.`);
+    }
+    const fromMap = new Map(fromVersions.map((v) => [v.symbol_id, v]));
+    const toMap = new Map(toVersions.map((v) => [v.symbol_id, v]));
+    const changedSymbols = [];
+    for (const [symbolId, toRow] of toMap) {
+        const fromRow = fromMap.get(symbolId);
+        if (!fromRow) {
+            const change = {
+                symbolId,
+                changeType: "added",
+                tiers: {
+                    interfaceStable: false,
+                    behaviorStable: false,
+                    sideEffectsStable: false,
+                    riskScore: 100,
+                },
+            };
+            changedSymbols.push(change);
+            continue;
+        }
+        const signatureDiff = diffSignature(fromRow.signature_json, toRow.signature_json);
+        const invariantDiff = diffArray(fromRow.invariants_json, toRow.invariants_json);
+        const sideEffectDiff = diffArray(fromRow.side_effects_json, toRow.side_effects_json);
+        const isModified = fromRow.ast_fingerprint !== toRow.ast_fingerprint ||
+            fromRow.summary !== toRow.summary ||
+            signatureDiff !== undefined ||
+            invariantDiff !== undefined ||
+            sideEffectDiff !== undefined;
+        if (isModified) {
+            const baseChange = {
+                symbolId,
+                changeType: "modified",
+                signatureDiff,
+                invariantDiff,
+                sideEffectDiff,
+            };
+            const tiers = computeStalenessTiers(baseChange, fromRow, toRow);
+            changedSymbols.push({
+                ...baseChange,
+                tiers,
+            });
+        }
+    }
+    for (const [symbolId] of fromMap) {
+        if (!toMap.has(symbolId)) {
+            const change = {
+                symbolId,
+                changeType: "removed",
+                tiers: {
+                    interfaceStable: false,
+                    behaviorStable: false,
+                    sideEffectsStable: false,
+                    riskScore: 100,
+                },
+            };
+            changedSymbols.push(change);
+        }
+    }
+    return {
+        repoId,
+        fromVersion,
+        toVersion,
+        changedSymbols,
+        blastRadius: [],
+    };
+}
+//# sourceMappingURL=diff.js.map

package/dist/delta/diff.js.map

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

package/dist/delta/versioning.d.ts

@@ -0,0 +1,11 @@
+import type { VersionId, SymbolId } from "../db/schema.js";
+import type { VersionRow } from "../db/schema.js";
+import type { SymbolVersionRow } from "../db/schema.js";
+export declare function createVersion(repoId: string, reason?: string): VersionId;
+export declare function computeVersionHash(prevVersionHash: string | null, symbolVersions: SymbolVersionRow[]): string;
+export declare function finalizeVersionHash(versionId: VersionId, symbolVersions: SymbolVersionRow[]): void;
+export declare function getVersion(versionId: VersionId): VersionRow | null;
+export declare function getLatestVersion(repoId: string): VersionRow | null;
+export declare function listVersions(repoId: string, limit?: number): VersionRow[];
+export declare function snapshotSymbols(versionId: VersionId, symbolIds: SymbolId[]): void;
+//# sourceMappingURL=versioning.d.ts.map

package/dist/delta/versioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versioning.d.ts","sourceRoot":"","sources":["../../src/delta/versioning.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAG3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAIxD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAkBxE;AAED,wBAAgB,kBAAkB,CAChC,eAAe,EAAE,MAAM,GAAG,IAAI,EAC9B,cAAc,EAAE,gBAAgB,EAAE,GACjC,MAAM,CAQR;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,SAAS,EACpB,cAAc,EAAE,gBAAgB,EAAE,GACjC,IAAI,CAYN;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU,GAAG,IAAI,CAElE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAElE;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE,CAEzE;AAED,wBAAgB,eAAe,CAC7B,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,QAAQ,EAAE,GACpB,IAAI,CA2BN"}

package/dist/delta/versioning.js

@@ -0,0 +1,68 @@
+import * as db from "../db/queries.js";
+import { getCurrentTimestamp } from "../util/time.js";
+import { getDb } from "../db/db.js";
+import { hashContent } from "../util/hashing.js";
+export function createVersion(repoId, reason) {
+    const timestamp = Date.now();
+    const versionId = `${repoId}-v${timestamp}`;
+    const latestVersion = db.getLatestVersion(repoId);
+    const prevVersionHash = latestVersion?.version_hash ?? null;
+    const version = {
+        version_id: versionId,
+        repo_id: repoId,
+        created_at: getCurrentTimestamp(),
+        reason: reason ?? null,
+        prev_version_hash: prevVersionHash,
+        version_hash: null,
+    };
+    db.createVersion(version);
+    return versionId;
+}
+export function computeVersionHash(prevVersionHash, symbolVersions) {
+    const sortedVersions = [...symbolVersions].sort((a, b) => a.symbol_id.localeCompare(b.symbol_id));
+    const fingerprints = sortedVersions.map((sv) => sv.ast_fingerprint).join("|");
+    const combined = `${prevVersionHash || "none"}:${fingerprints}`;
+    return hashContent(combined);
+}
+export function finalizeVersionHash(versionId, symbolVersions) {
+    const version = db.getVersion(versionId);
+    if (!version) {
+        throw new Error(`Version ${versionId} not found`);
+    }
+    const versionHash = computeVersionHash(version.prev_version_hash, symbolVersions);
+    db.updateVersionHashes(versionId, version.prev_version_hash, versionHash);
+}
+export function getVersion(versionId) {
+    return db.getVersion(versionId);
+}
+export function getLatestVersion(repoId) {
+    return db.getLatestVersion(repoId);
+}
+export function listVersions(repoId, limit) {
+    return db.listVersions(repoId, limit ?? 50);
+}
+export function snapshotSymbols(versionId, symbolIds) {
+    const dbInstance = getDb();
+    const snapshotTx = dbInstance.transaction(() => {
+        const snapshots = [];
+        for (const symbolId of symbolIds) {
+            const symbol = db.getSymbol(symbolId);
+            if (!symbol)
+                continue;
+            const snapshot = {
+                version_id: versionId,
+                symbol_id: symbolId,
+                ast_fingerprint: symbol.ast_fingerprint,
+                signature_json: symbol.signature_json,
+                summary: symbol.summary,
+                invariants_json: symbol.invariants_json,
+                side_effects_json: symbol.side_effects_json,
+            };
+            db.snapshotSymbolVersion(versionId, symbolId, snapshot);
+            snapshots.push(snapshot);
+        }
+        finalizeVersionHash(versionId, snapshots);
+    });
+    snapshotTx();
+}
+//# sourceMappingURL=versioning.js.map

package/dist/delta/versioning.js.map

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

package/dist/graph/buildGraph.d.ts

@@ -0,0 +1,12 @@
+import type { SymbolId, EdgeType, SymbolRow, EdgeRow } from "../db/schema.js";
+export interface Graph {
+    repoId: string;
+    symbols: Map<SymbolId, SymbolRow>;
+    edges: EdgeRow[];
+    adjacencyIn: Map<SymbolId, EdgeRow[]>;
+    adjacencyOut: Map<SymbolId, EdgeRow[]>;
+}
+export declare function loadGraphForRepo(repoId: string): Graph;
+export declare function getNeighbors(graph: Graph, symbolId: SymbolId, direction: "in" | "out" | "both", edgeType?: EdgeType): SymbolId[];
+export declare function getPath(graph: Graph, fromSymbol: SymbolId, toSymbol: SymbolId): SymbolId[] | null;
+//# sourceMappingURL=buildGraph.d.ts.map

package/dist/graph/buildGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildGraph.d.ts","sourceRoot":"","sources":["../../src/graph/buildGraph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG9E,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAClC,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,WAAW,EAAE,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IACtC,YAAY,EAAE,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;CACxC;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAiCtD;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,IAAI,GAAG,KAAK,GAAG,MAAM,EAChC,QAAQ,CAAC,EAAE,QAAQ,GAClB,QAAQ,EAAE,CAsBZ;AAED,wBAAgB,OAAO,CACrB,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,QAAQ,EACpB,QAAQ,EAAE,QAAQ,GACjB,QAAQ,EAAE,GAAG,IAAI,CAuCnB"}

package/dist/graph/buildGraph.js

@@ -0,0 +1,81 @@
+import * as db from "../db/queries.js";
+export function loadGraphForRepo(repoId) {
+    const symbols = db.getSymbolsByRepo(repoId);
+    const edges = db.getEdgesByRepo(repoId);
+    const symbolMap = new Map();
+    const adjacencyIn = new Map();
+    const adjacencyOut = new Map();
+    for (const symbol of symbols) {
+        symbolMap.set(symbol.symbol_id, symbol);
+        adjacencyIn.set(symbol.symbol_id, []);
+        adjacencyOut.set(symbol.symbol_id, []);
+    }
+    for (const edge of edges) {
+        const outgoing = adjacencyOut.get(edge.from_symbol_id);
+        const incoming = adjacencyIn.get(edge.to_symbol_id);
+        if (outgoing) {
+            outgoing.push(edge);
+        }
+        if (incoming) {
+            incoming.push(edge);
+        }
+    }
+    return {
+        repoId,
+        symbols: symbolMap,
+        edges,
+        adjacencyIn,
+        adjacencyOut,
+    };
+}
+export function getNeighbors(graph, symbolId, direction, edgeType) {
+    const neighbors = new Set();
+    if (direction === "in" || direction === "both") {
+        const incoming = graph.adjacencyIn.get(symbolId) ?? [];
+        for (const edge of incoming) {
+            if (!edgeType || edge.type === edgeType) {
+                neighbors.add(edge.from_symbol_id);
+            }
+        }
+    }
+    if (direction === "out" || direction === "both") {
+        const outgoing = graph.adjacencyOut.get(symbolId) ?? [];
+        for (const edge of outgoing) {
+            if (!edgeType || edge.type === edgeType) {
+                neighbors.add(edge.to_symbol_id);
+            }
+        }
+    }
+    return Array.from(neighbors);
+}
+export function getPath(graph, fromSymbol, toSymbol) {
+    if (fromSymbol === toSymbol) {
+        return [fromSymbol];
+    }
+    const visited = new Set();
+    const queue = [fromSymbol];
+    const parent = new Map();
+    visited.add(fromSymbol);
+    while (queue.length > 0) {
+        const current = queue.shift();
+        const neighbors = getNeighbors(graph, current, "out");
+        for (const neighbor of neighbors) {
+            if (!visited.has(neighbor)) {
+                visited.add(neighbor);
+                parent.set(neighbor, current);
+                if (neighbor === toSymbol) {
+                    const path = [];
+                    let node = toSymbol;
+                    while (node) {
+                        path.unshift(node);
+                        node = parent.get(node);
+                    }
+                    return path;
+                }
+                queue.push(neighbor);
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=buildGraph.js.map

package/dist/graph/buildGraph.js.map

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

package/dist/graph/cache.d.ts

@@ -0,0 +1,111 @@
+/**
+ * LRU Cache with version-based invalidation for SDL-MCP
+ *
+ * Provides in-memory caching for SymbolCard and GraphSlice objects with:
+ * - LRU (Least Recently Used) eviction policy
+ * - Version-based cache key invalidation
+ * - Cache statistics tracking (hits, misses, evictions)
+ * - Configurable size limits per cache type
+ */
+import type { SymbolCard } from "../mcp/types.js";
+import type { VersionId, SymbolId, RepoId } from "../db/schema.js";
+interface CacheEntry<T> {
+    value: T;
+    versionId: VersionId;
+    lastAccessed: number;
+    size: number;
+}
+interface CacheStats {
+    hits: number;
+    misses: number;
+    evictions: number;
+    currentSize: number;
+    entryCount: number;
+}
+interface CacheConfig {
+    maxEntries: number;
+    maxSizeBytes: number;
+}
+/**
+ * LRU Cache implementation with version-based invalidation
+ */
+declare class LRUCache<T> {
+    private cache;
+    private accessOrder;
+    private stats;
+    private config;
+    private lock;
+    constructor(config?: Partial<CacheConfig>);
+    /**
+     * Generates a cache key including version for invalidation
+     */
+    private makeKey;
+    /**
+     * Estimates size of a cache entry in bytes
+     * Accounts for object overhead and string encoding
+     */
+    private estimateSize;
+    /**
+     * Updates access order for LRU tracking
+     */
+    private updateAccessOrder;
+    /**
+     * Evicts entries to fit within cache limits
+     */
+    private evictIfNeeded;
+    /**
+     * Invalidates all cache entries for a specific version
+     */
+    invalidateVersion(versionId: VersionId): void;
+    /**
+     * Clears all cache entries
+     */
+    clear(): void;
+    /**
+     * Gets a cached value
+     */
+    get(repoId: RepoId, id: string, versionId: VersionId): T | undefined;
+    /**
+     * Sets a cached value
+     */
+    set(repoId: RepoId, id: string, versionId: VersionId, value: T): Promise<void>;
+    /**
+     * Checks if a key exists in the cache
+     */
+    has(repoId: RepoId, id: string, versionId: VersionId): boolean;
+    /**
+     * Gets cache statistics
+     */
+    getStats(): CacheStats;
+    /**
+     * Resets cache statistics
+     */
+    resetStats(): void;
+}
+/**
+ * Global cache instances
+ */
+export declare const symbolCardCache: LRUCache<SymbolCard>;
+/**
+ * Cache key generators
+ */
+export declare function makeSymbolCardCacheKey(repoId: RepoId, symbolId: SymbolId, versionId: VersionId): string;
+/**
+ * Cache statistics retrieval
+ */
+export declare function getSymbolCardCacheStats(): CacheStats;
+/**
+ * Cache invalidation helpers
+ */
+export declare function invalidateSymbolCardVersion(versionId: VersionId): void;
+/**
+ * Clears all caches
+ */
+export declare function clearAllCaches(): void;
+/**
+ * Resets all cache statistics
+ */
+export declare function resetAllCacheStats(): void;
+export { LRUCache };
+export type { CacheEntry, CacheStats, CacheConfig };
+//# sourceMappingURL=cache.d.ts.map

package/dist/graph/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/graph/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEnE,UAAU,UAAU,CAAC,CAAC;IACpB,KAAK,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,WAAW;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAYD;;GAEG;AACH,cAAM,QAAQ,CAAC,CAAC;IACd,OAAO,CAAC,KAAK,CAAyC;IACtD,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,KAAK,CAMX;IACF,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,IAAI,CAAoC;gBAEpC,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM;IAI7C;;OAEG;IACH,OAAO,CAAC,OAAO;IAIf;;;OAGG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAmBrB;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAqB7C;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,CAAC,GAAG,SAAS;IAepE;;OAEG;IACG,GAAG,CACP,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,CAAC,GACP,OAAO,CAAC,IAAI,CAAC;IAqDhB;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,OAAO;IAK9D;;OAEG;IACH,QAAQ,IAAI,UAAU;IAItB;;OAEG;IACH,UAAU,IAAI,IAAI;CAKnB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,sBAE3B,CAAC;AAEF;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,SAAS,GACnB,MAAM,CAER;AAGD;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,UAAU,CAEpD;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAEtE;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,OAAO,EAAE,QAAQ,EAAE,CAAC;AACpB,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC"}