@thoughtflow/core 0.1.2

package/dist/libs/performance-optimization.js

@@ -0,0 +1,221 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OptimizationBuilder = exports.ParallelExecutor = exports.PerformanceOptimizer = exports.CacheStrategy = void 0;
+const events_1 = __importDefault(require("events"));
+var CacheStrategy;
+(function (CacheStrategy) {
+    CacheStrategy["LRU"] = "lru";
+    CacheStrategy["LFU"] = "lfu";
+    CacheStrategy["TTL"] = "ttl";
+})(CacheStrategy || (exports.CacheStrategy = CacheStrategy = {}));
+class PerformanceOptimizer extends events_1.default {
+    cache = new Map();
+    maxCacheSize = 1000;
+    strategy = CacheStrategy.LRU;
+    hitCount = 0;
+    missCount = 0;
+    constructor(strategy = CacheStrategy.LRU, maxSize = 1000) {
+        super();
+        this.strategy = strategy;
+        this.maxCacheSize = maxSize;
+    }
+    set(key, value, ttl) {
+        if (this.cache.size >= this.maxCacheSize) {
+            this.evict();
+        }
+        this.cache.set(key, {
+            key,
+            value,
+            accessCount: 0,
+            lastAccess: Date.now(),
+            createdAt: Date.now(),
+            ttl,
+        });
+        this.emit("cache:set", { key });
+    }
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            this.missCount++;
+            this.emit("cache:miss", { key });
+            return undefined;
+        }
+        // Check TTL
+        if (entry.ttl && Date.now() - entry.createdAt > entry.ttl) {
+            this.cache.delete(key);
+            this.missCount++;
+            this.emit("cache:expired", { key });
+            return undefined;
+        }
+        entry.accessCount++;
+        entry.lastAccess = Date.now();
+        this.hitCount++;
+        this.emit("cache:hit", { key });
+        return entry.value;
+    }
+    has(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return false;
+        if (entry.ttl && Date.now() - entry.createdAt > entry.ttl) {
+            this.cache.delete(key);
+            return false;
+        }
+        return true;
+    }
+    delete(key) {
+        return this.cache.delete(key);
+    }
+    clear() {
+        this.cache.clear();
+        this.hitCount = 0;
+        this.missCount = 0;
+        this.emit("cache:cleared");
+    }
+    evict() {
+        if (this.strategy === CacheStrategy.LRU) {
+            this.evictLRU();
+        }
+        else if (this.strategy === CacheStrategy.LFU) {
+            this.evictLFU();
+        }
+        else if (this.strategy === CacheStrategy.TTL) {
+            this.evictExpired();
+        }
+    }
+    evictLRU() {
+        let lrfKey = "";
+        let lruTime = Date.now();
+        for (const [key, entry] of this.cache) {
+            if (entry.lastAccess < lruTime) {
+                lruTime = entry.lastAccess;
+                lrfKey = key;
+            }
+        }
+        if (lrfKey) {
+            this.cache.delete(lrfKey);
+            this.emit("cache:evicted", { key: lrfKey, strategy: "LRU" });
+        }
+    }
+    evictLFU() {
+        let lfuKey = "";
+        let minCount = Infinity;
+        for (const [key, entry] of this.cache) {
+            if (entry.accessCount < minCount) {
+                minCount = entry.accessCount;
+                lfuKey = key;
+            }
+        }
+        if (lfuKey) {
+            this.cache.delete(lfuKey);
+            this.emit("cache:evicted", { key: lfuKey, strategy: "LFU" });
+        }
+    }
+    evictExpired() {
+        const now = Date.now();
+        let evicted = 0;
+        for (const [key, entry] of this.cache) {
+            if (entry.ttl && now - entry.createdAt > entry.ttl) {
+                this.cache.delete(key);
+                evicted++;
+            }
+        }
+        if (evicted > 0) {
+            this.emit("cache:evicted", { count: evicted, strategy: "TTL" });
+        }
+    }
+    getStats() {
+        const total = this.hitCount + this.missCount || 1;
+        return {
+            hitRate: this.hitCount / total,
+            missRate: this.missCount / total,
+            cacheSize: this.cache.size,
+            totalAccess: total,
+        };
+    }
+    batchGet(keys) {
+        const results = new Map();
+        for (const key of keys) {
+            const value = this.get(key);
+            if (value !== undefined) {
+                results.set(key, value);
+            }
+        }
+        return results;
+    }
+    batchSet(entries, ttl) {
+        for (const [key, value] of entries) {
+            this.set(key, value, ttl);
+        }
+    }
+}
+exports.PerformanceOptimizer = PerformanceOptimizer;
+class ParallelExecutor extends events_1.default {
+    maxParallelism;
+    running = 0;
+    queue = [];
+    constructor(maxParallelism = 4) {
+        super();
+        this.maxParallelism = maxParallelism;
+    }
+    async execute(fn) {
+        if (this.running >= this.maxParallelism) {
+            return new Promise((resolve, reject) => {
+                this.queue.push(async () => {
+                    try {
+                        resolve(await fn());
+                    }
+                    catch (e) {
+                        reject(e);
+                    }
+                });
+            });
+        }
+        this.running++;
+        try {
+            return await fn();
+        }
+        finally {
+            this.running--;
+            if (this.queue.length > 0) {
+                const next = this.queue.shift();
+                next().catch(() => { });
+            }
+        }
+    }
+    async executeAll(fns) {
+        return Promise.all(fns.map((fn) => this.execute(fn)));
+    }
+    getQueueDepth() {
+        return this.queue.length;
+    }
+    getRunningCount() {
+        return this.running;
+    }
+}
+exports.ParallelExecutor = ParallelExecutor;
+class OptimizationBuilder {
+    optimizer;
+    executor;
+    constructor() {
+        this.optimizer = new PerformanceOptimizer();
+        this.executor = new ParallelExecutor();
+    }
+    getOptimizer() {
+        return this.optimizer;
+    }
+    getExecutor() {
+        return this.executor;
+    }
+    build() {
+        return {
+            optimizer: this.optimizer,
+            executor: this.executor,
+        };
+    }
+}
+exports.OptimizationBuilder = OptimizationBuilder;
+//# sourceMappingURL=performance-optimization.js.map

package/dist/libs/performance-optimization.js.map

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

package/dist/libs/pipeline-run-registry.class.d.ts

@@ -0,0 +1,56 @@
+/**
+ * PipelineRunRegistry — Central registry for CodeAnalysisPipeline runs.
+ *
+ * Persists PipelineRun records as JSON files under a configurable directory
+ * (default: ~/.thoughtflow/pipeline-runs). Each run gets a UUID and tracks per-phase
+ * status, progress, timings, and stage-specific details.
+ *
+ * Supports full CRUD + filtering. Writes are atomic (tmp → rename).
+ */
+import type { PipelineRun, PipelinePhase, PipelinePhaseStatus, PipelineStageId } from "../contracts/structural-decoder.types";
+/** Human-readable names for each pipeline stage. */
+export declare const PIPELINE_STAGE_NAMES: Record<PipelineStageId, string>;
+export interface PipelineRunCreateMeta {
+    projectName: string;
+    projectRoot: string;
+    storeBaseDir: string;
+    model?: string;
+}
+export interface PipelineRunListFilter {
+    projectRoot?: string;
+    projectName?: string;
+    status?: PipelinePhaseStatus;
+}
+export declare class PipelineRunRegistry {
+    readonly registryDir: string;
+    constructor(registryDir?: string);
+    /** Create a new run with all phases initialised as "pending". */
+    create(meta: PipelineRunCreateMeta): PipelineRun;
+    /** Get a run by UUID. Returns null if not found. */
+    get(uuid: string): PipelineRun | null;
+    /** List all runs, optionally filtered. */
+    list(filter?: PipelineRunListFilter): PipelineRun[];
+    /** Merge top-level fields into a run (except uuid and phases — use updatePhase for phases). */
+    update(uuid: string, partial: Partial<Omit<PipelineRun, "uuid" | "phases">>): PipelineRun;
+    /**
+     * Update a single phase within a run.
+     * Automatically recalculates the run's top-level status.
+     */
+    updatePhase(uuid: string, phaseId: PipelineStageId, partial: Partial<Omit<PipelinePhase, "id">>): PipelineRun;
+    /** Delete a run from the registry. No-op if not found. */
+    delete(uuid: string): void;
+    private runPath;
+    private getOrThrow;
+    /** Atomic write: write to .tmp then rename to prevent corruption on crash. */
+    private save;
+    /**
+     * Roll up phase statuses into a single run status:
+     * - Any "failed" → "failed"
+     * - Any "running" → "running"
+     * - All phases "complete" or "skipped" → "complete"
+     * - All "pending" → "pending"
+     * - Mix of pending/complete/skipped → "running"
+     */
+    private rollUpStatus;
+}
+//# sourceMappingURL=pipeline-run-registry.class.d.ts.map

package/dist/libs/pipeline-run-registry.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-run-registry.class.d.ts","sourceRoot":"","sources":["../../src/libs/pipeline-run-registry.class.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,eAAe,EAChB,MAAM,uCAAuC,CAAC;AAE/C,oDAAoD;AACpD,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAMhE,CAAC;AAUF,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAED,qBAAa,mBAAmB;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;gBAEjB,WAAW,CAAC,EAAE,MAAM;IAOhC,iEAAiE;IACjE,MAAM,CAAC,IAAI,EAAE,qBAAqB,GAAG,WAAW;IAsBhD,oDAAoD;IACpD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAUrC,0CAA0C;IAC1C,IAAI,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,WAAW,EAAE;IAyBnD,+FAA+F;IAC/F,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,GAAG,WAAW;IAazF;;;OAGG;IACH,WAAW,CACT,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,GAC1C,WAAW;IAsBd,0DAA0D;IAC1D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAS1B,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,UAAU;IAMlB,8EAA8E;IAC9E,OAAO,CAAC,IAAI;IAOZ;;;;;;;OAOG;IACH,OAAO,CAAC,YAAY;CAOrB"}

package/dist/libs/pipeline-run-registry.class.js

@@ -0,0 +1,217 @@
+"use strict";
+/**
+ * PipelineRunRegistry — Central registry for CodeAnalysisPipeline runs.
+ *
+ * Persists PipelineRun records as JSON files under a configurable directory
+ * (default: ~/.thoughtflow/pipeline-runs). Each run gets a UUID and tracks per-phase
+ * status, progress, timings, and stage-specific details.
+ *
+ * Supports full CRUD + filtering. Writes are atomic (tmp → rename).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PipelineRunRegistry = exports.PIPELINE_STAGE_NAMES = void 0;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const crypto_1 = require("crypto");
+/** Human-readable names for each pipeline stage. */
+exports.PIPELINE_STAGE_NAMES = {
+    "structural-decode": "Structural Decode",
+    "incremental-analyze": "Incremental Analyze",
+    "knowledge-graph-build": "Knowledge Graph Build",
+    "graph-render": "Graph Render",
+    "doc-generate": "Doc Generate",
+};
+/** The 4 stages used in the current pipeline (doc-generate excluded). */
+const DEFAULT_STAGE_ORDER = [
+    "structural-decode",
+    "incremental-analyze",
+    "knowledge-graph-build",
+    "graph-render",
+];
+class PipelineRunRegistry {
+    registryDir;
+    constructor(registryDir) {
+        this.registryDir = registryDir ?? path.join(os.homedir(), ".thoughtflow", "pipeline-runs");
+        fs.mkdirSync(this.registryDir, { recursive: true });
+    }
+    // ── CRUD ─────────────────────────────────────────────────────────────────
+    /** Create a new run with all phases initialised as "pending". */
+    create(meta) {
+        const now = new Date().toISOString();
+        const run = {
+            uuid: (0, crypto_1.randomUUID)(),
+            projectName: meta.projectName,
+            projectRoot: meta.projectRoot,
+            storeBaseDir: meta.storeBaseDir,
+            model: meta.model,
+            createdAt: now,
+            updatedAt: now,
+            status: "pending",
+            phases: DEFAULT_STAGE_ORDER.map((id) => ({
+                id,
+                name: exports.PIPELINE_STAGE_NAMES[id],
+                status: "pending",
+                progress: 0,
+            })),
+        };
+        this.save(run);
+        return run;
+    }
+    /** Get a run by UUID. Returns null if not found. */
+    get(uuid) {
+        const filePath = this.runPath(uuid);
+        if (!fs.existsSync(filePath))
+            return null;
+        try {
+            return JSON.parse(fs.readFileSync(filePath, "utf-8"));
+        }
+        catch {
+            return null;
+        }
+    }
+    /** List all runs, optionally filtered. */
+    list(filter) {
+        let entries;
+        try {
+            entries = fs.readdirSync(this.registryDir).filter((f) => f.endsWith(".json") && !f.endsWith(".tmp.json"));
+        }
+        catch {
+            return [];
+        }
+        const runs = [];
+        for (const entry of entries) {
+            try {
+                const run = JSON.parse(fs.readFileSync(path.join(this.registryDir, entry), "utf-8"));
+                if (filter?.projectRoot && run.projectRoot !== filter.projectRoot)
+                    continue;
+                if (filter?.projectName && run.projectName !== filter.projectName)
+                    continue;
+                if (filter?.status && run.status !== filter.status)
+                    continue;
+                runs.push(run);
+            }
+            catch {
+                // Skip corrupt entries
+            }
+        }
+        // Sort newest first
+        return runs.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+    }
+    /** Merge top-level fields into a run (except uuid and phases — use updatePhase for phases). */
+    update(uuid, partial) {
+        const run = this.getOrThrow(uuid);
+        const updated = {
+            ...run,
+            ...partial,
+            uuid: run.uuid,
+            phases: run.phases,
+            updatedAt: new Date().toISOString(),
+        };
+        this.save(updated);
+        return updated;
+    }
+    /**
+     * Update a single phase within a run.
+     * Automatically recalculates the run's top-level status.
+     */
+    updatePhase(uuid, phaseId, partial) {
+        const run = this.getOrThrow(uuid);
+        const phases = run.phases.map((p) => {
+            if (p.id !== phaseId)
+                return p;
+            const updated = { ...p, ...partial, id: p.id };
+            // Auto-compute durationMs when completing
+            if (partial.status === "complete" && p.startedAt && !partial.durationMs) {
+                updated.durationMs = Date.now() - new Date(p.startedAt).getTime();
+            }
+            return updated;
+        });
+        const updated = {
+            ...run,
+            phases,
+            status: this.rollUpStatus(phases),
+            updatedAt: new Date().toISOString(),
+        };
+        this.save(updated);
+        return updated;
+    }
+    /** Delete a run from the registry. No-op if not found. */
+    delete(uuid) {
+        const filePath = this.runPath(uuid);
+        if (fs.existsSync(filePath)) {
+            fs.unlinkSync(filePath);
+        }
+    }
+    // ── Private ───────────────────────────────────────────────────────────────
+    runPath(uuid) {
+        return path.join(this.registryDir, `${uuid}.json`);
+    }
+    getOrThrow(uuid) {
+        const run = this.get(uuid);
+        if (!run)
+            throw new Error(`PipelineRun not found: ${uuid}`);
+        return run;
+    }
+    /** Atomic write: write to .tmp then rename to prevent corruption on crash. */
+    save(run) {
+        const filePath = this.runPath(run.uuid);
+        const tmpPath = filePath + ".tmp";
+        fs.writeFileSync(tmpPath, JSON.stringify(run, null, 2), "utf-8");
+        fs.renameSync(tmpPath, filePath);
+    }
+    /**
+     * Roll up phase statuses into a single run status:
+     * - Any "failed" → "failed"
+     * - Any "running" → "running"
+     * - All phases "complete" or "skipped" → "complete"
+     * - All "pending" → "pending"
+     * - Mix of pending/complete/skipped → "running"
+     */
+    rollUpStatus(phases) {
+        if (phases.some((p) => p.status === "failed"))
+            return "failed";
+        if (phases.some((p) => p.status === "running"))
+            return "running";
+        if (phases.every((p) => p.status === "complete" || p.status === "skipped"))
+            return "complete";
+        if (phases.every((p) => p.status === "pending"))
+            return "pending";
+        return "running"; // some complete, some pending
+    }
+}
+exports.PipelineRunRegistry = PipelineRunRegistry;
+//# sourceMappingURL=pipeline-run-registry.class.js.map

package/dist/libs/pipeline-run-registry.class.js.map

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

package/dist/libs/problem-tree.class.d.ts

@@ -0,0 +1,51 @@
+import { ProblemTreeNode, ProblemTreeNodeType, ProblemTreeNodeStatus, ProblemTreeEdge, ProblemTreeEdgeType, ProblemTreeSnapshot } from "../contracts/problem-tree.types";
+export interface ProblemTreeConfig {
+    /** Override for tree ID generation. Default: crypto.randomUUID() */
+    treeId?: string;
+    /** Default confidence for new nodes. Default: 0.7 */
+    defaultConfidence?: number;
+    /** Prefix for generated node IDs. Default: "node-" */
+    nodeIdPrefix?: string;
+    /** Prefix for generated edge IDs. Default: "edge-" */
+    edgeIdPrefix?: string;
+}
+export declare class ProblemTree {
+    private nodes;
+    private edges;
+    private rootProblemId;
+    private treeId;
+    private defaultConfidence;
+    private nodePrefix;
+    private edgePrefix;
+    constructor(config?: ProblemTreeConfig);
+    /** Reconstruct a ProblemTree from a snapshot (storage/persistence) */
+    static fromSnapshot(snapshot: ProblemTreeSnapshot & {
+        id?: string;
+    }): ProblemTree;
+    getTreeId(): string;
+    getRootProblemId(): string | null;
+    getNode(id: string): ProblemTreeNode | undefined;
+    getEdge(id: string): ProblemTreeEdge | undefined;
+    getAllNodes(): ProblemTreeNode[];
+    getAllEdges(): ProblemTreeEdge[];
+    getChildren(parentId: string): ProblemTreeNode[];
+    getOutgoingEdges(nodeId: string): ProblemTreeEdge[];
+    getIncomingEdges(nodeId: string): ProblemTreeEdge[];
+    getNeighbors(nodeId: string): ProblemTreeNode[];
+    getDescendants(nodeId: string): ProblemTreeNode[];
+    getPathToRoot(nodeId: string): ProblemTreeNode[];
+    getMaxDepth(): number;
+    hasCycle(fromId: string, toId: string): boolean;
+    addRootProblem(title: string, description: string): ProblemTreeNode;
+    addChildNode(parentId: string, type: ProblemTreeNodeType, title: string, description: string, confidence?: number): ProblemTreeNode | null;
+    addEdge(fromId: string, toId: string, type: ProblemTreeEdgeType, reasoning: string, confidence?: number): ProblemTreeEdge | null;
+    updateNodeStatus(id: string, status: ProblemTreeNodeStatus): ProblemTreeNode | null;
+    updateNodeConfidence(id: string, confidence: number): ProblemTreeNode | null;
+    addEvidenceToNode(id: string, evidenceRef: string): ProblemTreeNode | null;
+    addPredictedIssue(id: string, issue: string): ProblemTreeNode | null;
+    addSourceResource(id: string, resource: string): ProblemTreeNode | null;
+    snapshot(): ProblemTreeSnapshot;
+    toContextString(): string;
+    private createNode;
+}
+//# sourceMappingURL=problem-tree.class.d.ts.map

package/dist/libs/problem-tree.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"problem-tree.class.d.ts","sourceRoot":"","sources":["../../src/libs/problem-tree.class.ts"],"names":[],"mappings":"AACA,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,GAAE,iBAAsB;IAO1C,sEAAsE;IACtE,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,mBAAmB,GAAG;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,WAAW;IAcjF,SAAS,IAAI,MAAM;IAInB,gBAAgB,IAAI,MAAM,GAAG,IAAI;IAIjC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIhD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIhD,WAAW,IAAI,eAAe,EAAE;IAIhC,WAAW,IAAI,eAAe,EAAE;IAIhC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE;IAIhD,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE;IAInD,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE;IAInD,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE;IAS/C,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE;IAiBjD,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE;IAWhD,WAAW,IAAI,MAAM;IAQrB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAe/C,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,eAAe;IAYnE,YAAY,CACV,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,mBAAmB,EACzB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,UAAU,SAAM,GACf,eAAe,GAAG,IAAI;IAczB,OAAO,CACL,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,mBAAmB,EACzB,SAAS,EAAE,MAAM,EACjB,UAAU,SAAM,GACf,eAAe,GAAG,IAAI;IAUzB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,GAAG,eAAe,GAAG,IAAI;IAWnF,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAQ5E,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAU1E,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAUpE,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAUvE,QAAQ,IAAI,mBAAmB;IA4B/B,eAAe,IAAI,MAAM;IA4DzB,OAAO,CAAC,UAAU;CA2BnB"}