@egentica/codemap 0.1.5

package/dist/core/ExperienceStore.d.ts

@@ -0,0 +1,170 @@
+/**
+ * ExperienceStore - Persistence layer for experience data.
+ *
+ * Stores experience events, search journeys, anti-results, and usage metadata
+ * in JSONL format for easy append and query operations.
+ *
+ * Storage structure:
+ * .codemap/experience/
+ * ├── events/
+ * │   └── sess_<sessionId>.jsonl      # Experience events per session
+ * ├── search-journeys.jsonl           # Search journey records
+ * ├── anti-results.jsonl              # Anti-result entries
+ * └── usage-metadata.jsonl            # Usage metadata per file
+ *
+ * @example
+ * ```typescript
+ * const store = new ExperienceStore(fsProvider, '.codemap/experience');
+ *
+ * // Append experience event
+ * await store.appendEvent({
+ *   id: 'evt_123',
+ *   tool: 'codemap_read',
+ *   operation: 'content',
+ *   target: 'file.ts',
+ *   outcome: 'success',
+ *   sessionId: 'sess_456',
+ *   timestamp: new Date().toISOString()
+ * });
+ *
+ * // Record search journey
+ * await store.recordJourney(journey);
+ *
+ * // Get usage metadata
+ * const metadata = await store.getUsageMetadata('file.ts');
+ * ```
+ */
+import type { ExperienceEvent, SearchJourney, AntiResultEntry, UsageMetadata } from '../types';
+/**
+ * Minimal file system provider for experience storage.
+ */
+export interface FileSystemProvider {
+    read(path: string): Promise<string>;
+    write(path: string, content: string): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    mkdir(path: string): Promise<void>;
+}
+export declare class ExperienceStore {
+    private storage;
+    private storageRoot;
+    private currentSessionId;
+    constructor(storage: FileSystemProvider, storageRoot?: string);
+    /**
+     * Set current session ID.
+     * Called at session start to scope events to this session.
+     */
+    setSessionId(sessionId: string): void;
+    /**
+     * Get current session ID.
+     */
+    getSessionId(): string;
+    /**
+     * Append an experience event.
+     * Events are stored in session-specific JSONL files.
+     *
+     * @param event - Experience event to append
+     */
+    appendEvent(event: ExperienceEvent): Promise<void>;
+    /**
+     * Get events for a specific session.
+     *
+     * @param sessionId - Session ID
+     * @returns Array of events
+     */
+    getSessionEvents(sessionId: string): Promise<ExperienceEvent[]>;
+    /**
+     * Get events for the current session.
+     */
+    getCurrentSessionEvents(): Promise<ExperienceEvent[]>;
+    /**
+     * Record a search journey.
+     *
+     * @param journey - Search journey to record
+     */
+    recordJourney(journey: SearchJourney): Promise<void>;
+    /**
+     * Get all search journeys.
+     *
+     * @returns Array of journeys
+     */
+    getAllJourneys(): Promise<SearchJourney[]>;
+    /**
+     * Get search journeys for a specific file.
+     *
+     * @param filePath - Target file path
+     * @returns Array of journeys that ended with this file
+     */
+    getJourneysForFile(filePath: string): Promise<SearchJourney[]>;
+    /**
+     * Record an anti-result entry.
+     *
+     * @param entry - Anti-result entry
+     */
+    recordAntiResult(entry: AntiResultEntry): Promise<void>;
+    /**
+     * Get anti-results for a specific file.
+     *
+     * @param filePath - The incorrect file path
+     * @returns Array of anti-result entries where this file was wrong
+     */
+    getAntiResults(filePath: string): Promise<AntiResultEntry[]>;
+    /**
+     * Set usage metadata for a file.
+     *
+     * @param metadata - Usage metadata
+     */
+    setUsageMetadata(metadata: UsageMetadata): Promise<void>;
+    /**
+     * Get usage metadata for a specific file.
+     *
+     * @param target - File path
+     * @returns Usage metadata or null if not found
+     */
+    getUsageMetadata(target: string): Promise<UsageMetadata | null>;
+    /**
+     * Get all usage metadata.
+     *
+     * @returns Array of all usage metadata entries
+     */
+    getAllUsageMetadata(): Promise<UsageMetadata[]>;
+    /**
+     * Add usage phrases to existing metadata.
+     *
+     * @param target - File path
+     * @param usages - New usage phrases to add
+     * @returns Updated metadata
+     */
+    addUsages(target: string, usages: string[]): Promise<UsageMetadata>;
+    /**
+     * Ensure storage directories exist.
+     */
+    private ensureDirectories;
+    /**
+     * Read JSONL file and parse to array of objects.
+     *
+     * @param path - File path
+     * @returns Array of parsed objects
+     */
+    private readJsonl;
+    /**
+     * Write array of objects to JSONL file.
+     *
+     * @param path - File path
+     * @param data - Array of objects to write
+     */
+    private writeJsonl;
+    /**
+     * Append content to a file (create if doesn't exist).
+     *
+     * @param path - File path
+     * @param content - Content to append
+     */
+    private appendToFile;
+    /**
+     * Generate a unique session ID.
+     *
+     * @returns Session ID string
+     */
+    private generateSessionId;
+}
+//# sourceMappingURL=ExperienceStore.d.ts.map

package/dist/core/ExperienceStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExperienceStore.d.ts","sourceRoot":"","sources":["../../src/core/ExperienceStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,eAAe,EACf,aAAa,EACd,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED,qBAAa,eAAe;IAKxB,OAAO,CAAC,OAAO;IAJjB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,gBAAgB,CAAS;gBAGvB,OAAO,EAAE,kBAAkB,EACnC,WAAW,GAAE,MAA8B;IAM7C;;;OAGG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIrC;;OAEG;IACH,YAAY,IAAI,MAAM;IAMtB;;;;;OAKG;IACG,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBxD;;;;;OAKG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAKrE;;OAEG;IACG,uBAAuB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAM3D;;;;OAIG;IACG,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1D;;;;OAIG;IACG,cAAc,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAKhD;;;;;OAKG;IACG,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IASpE;;;;OAIG;IACG,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ7D;;;;;OAKG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAQlE;;;;OAIG;IACG,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB9D;;;;;OAKG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAMrE;;;;OAIG;IACG,mBAAmB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAKrD;;;;;;OAMG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IA4BzE;;OAEG;YACW,iBAAiB;IAO/B;;;;;OAKG;YACW,SAAS;IAgBvB;;;;;OAKG;YACW,UAAU;IAMxB;;;;;OAKG;YACW,YAAY;IAW1B;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;CAK1B"}

package/dist/core/ExperienceStore.js

@@ -0,0 +1,292 @@
+"use strict";
+/**
+ * ExperienceStore - Persistence layer for experience data.
+ *
+ * Stores experience events, search journeys, anti-results, and usage metadata
+ * in JSONL format for easy append and query operations.
+ *
+ * Storage structure:
+ * .codemap/experience/
+ * ├── events/
+ * │   └── sess_<sessionId>.jsonl      # Experience events per session
+ * ├── search-journeys.jsonl           # Search journey records
+ * ├── anti-results.jsonl              # Anti-result entries
+ * └── usage-metadata.jsonl            # Usage metadata per file
+ *
+ * @example
+ * ```typescript
+ * const store = new ExperienceStore(fsProvider, '.codemap/experience');
+ *
+ * // Append experience event
+ * await store.appendEvent({
+ *   id: 'evt_123',
+ *   tool: 'codemap_read',
+ *   operation: 'content',
+ *   target: 'file.ts',
+ *   outcome: 'success',
+ *   sessionId: 'sess_456',
+ *   timestamp: new Date().toISOString()
+ * });
+ *
+ * // Record search journey
+ * await store.recordJourney(journey);
+ *
+ * // Get usage metadata
+ * const metadata = await store.getUsageMetadata('file.ts');
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExperienceStore = void 0;
+class ExperienceStore {
+    storage;
+    storageRoot;
+    currentSessionId;
+    constructor(storage, storageRoot = '.codemap/experience') {
+        this.storage = storage;
+        this.storageRoot = storageRoot;
+        this.currentSessionId = this.generateSessionId();
+    }
+    /**
+     * Set current session ID.
+     * Called at session start to scope events to this session.
+     */
+    setSessionId(sessionId) {
+        this.currentSessionId = sessionId;
+    }
+    /**
+     * Get current session ID.
+     */
+    getSessionId() {
+        return this.currentSessionId;
+    }
+    // ── Event Operations ───────────────────────────────────────────────────────
+    /**
+     * Append an experience event.
+     * Events are stored in session-specific JSONL files.
+     *
+     * @param event - Experience event to append
+     */
+    async appendEvent(event) {
+        await this.ensureDirectories();
+        const eventsDir = `${this.storageRoot}/events`;
+        const sessionFile = `${eventsDir}/sess_${event.sessionId}.jsonl`;
+        // Ensure events directory exists
+        const eventsDirExists = await this.storage.exists(eventsDir);
+        if (!eventsDirExists) {
+            await this.storage.mkdir(eventsDir);
+        }
+        // Append event as JSONL
+        const line = JSON.stringify(event) + '\n';
+        await this.appendToFile(sessionFile, line);
+    }
+    /**
+     * Get events for a specific session.
+     *
+     * @param sessionId - Session ID
+     * @returns Array of events
+     */
+    async getSessionEvents(sessionId) {
+        const sessionFile = `${this.storageRoot}/events/sess_${sessionId}.jsonl`;
+        return this.readJsonl(sessionFile);
+    }
+    /**
+     * Get events for the current session.
+     */
+    async getCurrentSessionEvents() {
+        return this.getSessionEvents(this.currentSessionId);
+    }
+    // ── Search Journey Operations ──────────────────────────────────────────────
+    /**
+     * Record a search journey.
+     *
+     * @param journey - Search journey to record
+     */
+    async recordJourney(journey) {
+        await this.ensureDirectories();
+        const journeyFile = `${this.storageRoot}/search-journeys.jsonl`;
+        const line = JSON.stringify(journey) + '\n';
+        await this.appendToFile(journeyFile, line);
+    }
+    /**
+     * Get all search journeys.
+     *
+     * @returns Array of journeys
+     */
+    async getAllJourneys() {
+        const journeyFile = `${this.storageRoot}/search-journeys.jsonl`;
+        return this.readJsonl(journeyFile);
+    }
+    /**
+     * Get search journeys for a specific file.
+     *
+     * @param filePath - Target file path
+     * @returns Array of journeys that ended with this file
+     */
+    async getJourneysForFile(filePath) {
+        const allJourneys = await this.getAllJourneys();
+        return allJourneys.filter(j => j.finalTarget?.path === filePath && j.finalTarget.success);
+    }
+    // ── Anti-Result Operations ─────────────────────────────────────────────────
+    /**
+     * Record an anti-result entry.
+     *
+     * @param entry - Anti-result entry
+     */
+    async recordAntiResult(entry) {
+        await this.ensureDirectories();
+        const antiResultFile = `${this.storageRoot}/anti-results.jsonl`;
+        const line = JSON.stringify(entry) + '\n';
+        await this.appendToFile(antiResultFile, line);
+    }
+    /**
+     * Get anti-results for a specific file.
+     *
+     * @param filePath - The incorrect file path
+     * @returns Array of anti-result entries where this file was wrong
+     */
+    async getAntiResults(filePath) {
+        const antiResultFile = `${this.storageRoot}/anti-results.jsonl`;
+        const allEntries = await this.readJsonl(antiResultFile);
+        return allEntries.filter(e => e.incorrectFile === filePath);
+    }
+    // ── Usage Metadata Operations ──────────────────────────────────────────────
+    /**
+     * Set usage metadata for a file.
+     *
+     * @param metadata - Usage metadata
+     */
+    async setUsageMetadata(metadata) {
+        await this.ensureDirectories();
+        const metadataFile = `${this.storageRoot}/usage-metadata.jsonl`;
+        // Read existing metadata
+        const allMetadata = await this.readJsonl(metadataFile);
+        // Remove existing entry for this target (if any)
+        const filtered = allMetadata.filter(m => m.target !== metadata.target);
+        // Add new entry
+        filtered.push(metadata);
+        // Write back
+        await this.writeJsonl(metadataFile, filtered);
+    }
+    /**
+     * Get usage metadata for a specific file.
+     *
+     * @param target - File path
+     * @returns Usage metadata or null if not found
+     */
+    async getUsageMetadata(target) {
+        const metadataFile = `${this.storageRoot}/usage-metadata.jsonl`;
+        const allMetadata = await this.readJsonl(metadataFile);
+        return allMetadata.find(m => m.target === target) || null;
+    }
+    /**
+     * Get all usage metadata.
+     *
+     * @returns Array of all usage metadata entries
+     */
+    async getAllUsageMetadata() {
+        const metadataFile = `${this.storageRoot}/usage-metadata.jsonl`;
+        return this.readJsonl(metadataFile);
+    }
+    /**
+     * Add usage phrases to existing metadata.
+     *
+     * @param target - File path
+     * @param usages - New usage phrases to add
+     * @returns Updated metadata
+     */
+    async addUsages(target, usages) {
+        const existing = await this.getUsageMetadata(target);
+        if (existing) {
+            // Merge with existing
+            const combined = [...new Set([...existing.usages, ...usages])];
+            const updated = {
+                ...existing,
+                usages: combined,
+                updatedAt: new Date().toISOString()
+            };
+            await this.setUsageMetadata(updated);
+            return updated;
+        }
+        else {
+            // Create new
+            const metadata = {
+                target,
+                usages,
+                registeredAt: new Date().toISOString(),
+                updatedAt: new Date().toISOString()
+            };
+            await this.setUsageMetadata(metadata);
+            return metadata;
+        }
+    }
+    // ── Utilities ──────────────────────────────────────────────────────────────
+    /**
+     * Ensure storage directories exist.
+     */
+    async ensureDirectories() {
+        const exists = await this.storage.exists(this.storageRoot);
+        if (!exists) {
+            await this.storage.mkdir(this.storageRoot);
+        }
+    }
+    /**
+     * Read JSONL file and parse to array of objects.
+     *
+     * @param path - File path
+     * @returns Array of parsed objects
+     */
+    async readJsonl(path) {
+        const exists = await this.storage.exists(path);
+        if (!exists) {
+            return [];
+        }
+        try {
+            const content = await this.storage.read(path);
+            const lines = content.split('\n').filter(line => line.trim());
+            return lines.map(line => JSON.parse(line));
+        }
+        catch (error) {
+            console.error(`Failed to read JSONL file ${path}:`, error);
+            return [];
+        }
+    }
+    /**
+     * Write array of objects to JSONL file.
+     *
+     * @param path - File path
+     * @param data - Array of objects to write
+     */
+    async writeJsonl(path, data) {
+        const lines = data.map(item => JSON.stringify(item));
+        const content = lines.join('\n') + '\n';
+        await this.storage.write(path, content);
+    }
+    /**
+     * Append content to a file (create if doesn't exist).
+     *
+     * @param path - File path
+     * @param content - Content to append
+     */
+    async appendToFile(path, content) {
+        const exists = await this.storage.exists(path);
+        if (exists) {
+            const existing = await this.storage.read(path);
+            await this.storage.write(path, existing + content);
+        }
+        else {
+            await this.storage.write(path, content);
+        }
+    }
+    /**
+     * Generate a unique session ID.
+     *
+     * @returns Session ID string
+     */
+    generateSessionId() {
+        const timestamp = Date.now();
+        const random = Math.random().toString(36).substring(2, 9);
+        return `sess_${timestamp}_${random}`;
+    }
+}
+exports.ExperienceStore = ExperienceStore;
+//# sourceMappingURL=ExperienceStore.js.map

package/dist/core/ExperienceStore.js.map

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

package/dist/core/ExperienceTracker.d.ts

@@ -0,0 +1,110 @@
+/**
+ * ExperienceTracker - Records all CodeMap operations for self-improving discovery.
+ *
+ * Subscribes to FileSystemIO events and records:
+ * - Operation outcomes (success/failure)
+ * - Search journeys (query → read → write paths)
+ * - Anti-results (dead ends, abandoned paths)
+ *
+ * This data powers AssistMap's experience-weighted scoring.
+ *
+ * @example
+ * ```typescript
+ * const tracker = new ExperienceTracker(store, eventBus);
+ *
+ * // Tracker automatically subscribes to events:
+ * // - file:write:before/after → Records writes
+ * // - file:read → Tracks reads in current journey
+ * // - search:executed → Records search steps
+ *
+ * // Manual journey tracking
+ * tracker.startJourney('find TaskCard component');
+ * tracker.recordSearch('assist', 'TaskCard', ['TaskCard.vue', 'TaskList.vue']);
+ * tracker.recordRead('TaskCard.vue');
+ * await tracker.recordSuccessfulWrite('TaskCard.vue', 'edit');
+ * // → Completes journey, records anti-results, updates patterns
+ * ```
+ */
+import type { ExperienceOutcome } from '../types';
+import { ExperienceStore } from './ExperienceStore';
+import { EventBus } from './EventBus';
+export declare class ExperienceTracker {
+    private store;
+    private eventBus;
+    private currentJourney;
+    private operationContexts;
+    private lastAssistQuery;
+    constructor(store: ExperienceStore, eventBus: EventBus, enabled?: boolean);
+    /**
+     * Wire up event handlers to track all operations.
+     */
+    private wireEventHandlers;
+    /**
+     * Record operation start.
+     *
+     * @param tool - Tool name (e.g., 'codemap_read')
+     * @param operation - Operation name (e.g., 'content')
+     * @param target - Target file/directory
+     */
+    recordOperationStart(tool: string, operation: string, target?: string): void;
+    /**
+     * Record operation completion.
+     *
+     * @param tool - Tool name
+     * @param operation - Operation name
+     * @param target - Target file/directory
+     * @param outcome - Operation outcome
+     */
+    recordOperationComplete(tool: string, operation: string, target: string | undefined, outcome: ExperienceOutcome): Promise<void>;
+    /**
+     * Start a new search journey.
+     * Called when user initiates a search or assist operation.
+     *
+     * @param initialQuery - The query that started the journey
+     */
+    startJourney(initialQuery: string): void;
+    /**
+     * Record a search step in the current journey.
+     *
+     * @param operation - Search operation type
+     * @param query - Search query
+     * @param results - Results returned
+     */
+    recordSearch(operation: string, query: string, results: string[]): void;
+    /**
+     * Record that user read a file (from search results).
+     *
+     * @param filePath - File path that was read
+     */
+    recordRead(filePath: string): void;
+    /**
+     * Record successful write - completes the journey.
+     *
+     * @param filePath - File that was successfully written
+     * @param operation - Write operation type
+     */
+    recordSuccessfulWrite(filePath: string, operation: string): Promise<void>;
+    /**
+     * Extract anti-results from the current journey.
+     *
+     * @returns Array of anti-result entries
+     */
+    private extractAntiResults;
+    /**
+     * Generate a unique event ID.
+     */
+    private generateEventId;
+    /**
+     * Generate a unique journey ID.
+     */
+    private generateJourneyId;
+    /**
+     * Get the experience store.
+     */
+    getStore(): ExperienceStore;
+    /**
+     * Set the last assist query (used for attribution).
+     */
+    setLastAssistQuery(query: string): void;
+}
+//# sourceMappingURL=ExperienceTracker.d.ts.map

package/dist/core/ExperienceTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExperienceTracker.d.ts","sourceRoot":"","sources":["../../src/core/ExperienceTracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAEV,iBAAiB,EAIlB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAYtC,qBAAa,iBAAiB;IAM1B,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,QAAQ;IANlB,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,iBAAiB,CAAgC;IACzD,OAAO,CAAC,eAAe,CAAuB;gBAGpC,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,QAAQ,EAC1B,OAAO,GAAE,OAAc;IASzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAgCzB;;;;;;OAMG;IACH,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAW5E;;;;;;;OAOG;IACG,uBAAuB,CAC3B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC;IAwChB;;;;;OAKG;IACH,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAWxC;;;;;;OAMG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI;IAkBvE;;;;OAIG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAuBlC;;;;;OAKG;IACG,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4B/E;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IA2C1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACH,QAAQ,IAAI,eAAe;IAI3B;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAGxC"}