mindoodb 0.0.23 → 0.0.32

package/dist/core/indexing/fulltext/DocumentFullTextIndex.js

@@ -0,0 +1,548 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocumentFullTextIndex = void 0;
+const types_1 = require("../summary/types");
+const types_2 = require("./types");
+const extractFulltextText_1 = require("./extractFulltextText");
+const SearchEngineAdapter_1 = require("./SearchEngineAdapter");
+/**
+ * Attachments above this size are skipped during text extraction: they
+ * would have to be fully materialized in memory, and extractable text
+ * that large exceeds any sensible per-field cap anyway.
+ */
+const MAX_ATTACHMENT_EXTRACT_BYTES = 16 * 1024 * 1024;
+/**
+ * The document full-text index: a changefeed-maintained, encrypted-at-rest
+ * search index over extracted document text (see docs/fulltext-search.md).
+ *
+ * Sits next to the {@link DocumentSummaryStore} as a second derived index:
+ * same changefeed pipeline (cursor, resumable backfill, config
+ * fingerprint), same encrypted persistence through the tenant's
+ * {@link LocalCacheStore}, same `dbsetup` reconciliation (field
+ * `fulltextSetup`). Unlike the summary it is OPT-IN (`enabled: true`);
+ * text is extracted from the materialized documents the changefeed yields
+ * anyway — including long-text and rich-text fields that must stay out of
+ * the RAM-resident summary buffer.
+ *
+ * E2EE note: the index is built client-side from decrypted content, so
+ * devices whose KeyBag lacks certain decryption keys index (and find)
+ * fewer documents. Purge paths remove entries immediately so plaintext
+ * tokens never outlive key revocation.
+ */
+class DocumentFullTextIndex {
+    constructor(db, config, options) {
+        /** Whether the setup document was already consulted (once per instance). */
+        this.setupDocSeeded = false;
+        this.cursor = null;
+        // --- persistence state ---
+        this.cacheManager = null;
+        this.cachePrefix = null;
+        this.engineDirty = false;
+        this.metaDirty = false;
+        this.restorePromise = null;
+        this.restored = false;
+        // --- backfill state (config changed while the index already has content) ---
+        this.needsBackfill = false;
+        this.backfillCursor = null;
+        // --- single-flight update ---
+        this.updatePromise = null;
+        this.db = db;
+        this.hasExplicitConfig = config !== undefined;
+        this.config = (0, types_2.resolveFulltextConfig)(config);
+        this.configFingerprint = (0, types_2.computeFulltextConfigFingerprint)(this.config);
+        this.getAttachmentExtractors = options?.getAttachmentExtractors ?? (() => []);
+        this.engine = this.createEngine();
+    }
+    createEngine() {
+        return new SearchEngineAdapter_1.MiniSearchAdapter(this.config.language, this.config.include);
+    }
+    // ---------------------------------------------------------------------------
+    // Configuration
+    // ---------------------------------------------------------------------------
+    getConfig() {
+        return this.config;
+    }
+    getConfigFingerprint() {
+        return this.configFingerprint;
+    }
+    isEnabled() {
+        return this.config.enabled;
+    }
+    /**
+     * Replace the full-text configuration. When the fingerprint changes,
+     * the engine is recreated (tokenizer/language and field extraction may
+     * differ) and a resumable backfill re-indexes all documents on the next
+     * `update()` run. Until the backfill finishes the index reports
+     * `"rebuilding"` and serves the (growing) partial result.
+     *
+     * Calling this marks the configuration as explicit: the index stops
+     * following the {@link DB_SETUP_DOC_ID} document.
+     */
+    setConfig(config) {
+        this.hasExplicitConfig = true;
+        this.applyConfig(config);
+    }
+    /** Shared config-swap logic for explicit and setup-document paths. */
+    applyConfig(config) {
+        const resolved = (0, types_2.resolveFulltextConfig)(config);
+        const fingerprint = (0, types_2.computeFulltextConfigFingerprint)(resolved);
+        if (fingerprint === this.configFingerprint) {
+            return;
+        }
+        const hadContent = this.engine.getDocumentCount() > 0 || this.cursor !== null;
+        this.config = resolved;
+        this.configFingerprint = fingerprint;
+        // Unlike the summary the engine state is tokenizer-dependent, so a
+        // config change always starts over with a fresh engine.
+        this.engine = this.createEngine();
+        this.engineDirty = true;
+        if (hadContent && this.config.enabled) {
+            this.scheduleBackfill();
+        }
+        this.metaDirty = true;
+        this.cacheManager?.markDirty();
+    }
+    scheduleBackfill() {
+        this.needsBackfill = true;
+        this.backfillCursor = null;
+    }
+    /**
+     * Adopt the configuration from the synced {@link DB_SETUP_DOC_ID}
+     * document (its `fulltextSetup` field) unless an explicit configuration
+     * was provided in code. Runs once per instance, BEFORE the persisted
+     * state is restored, so the fingerprint comparison on restore already
+     * sees the setup-document configuration.
+     */
+    async seedConfigFromSetupDoc() {
+        if (this.setupDocSeeded || this.hasExplicitConfig) {
+            this.setupDocSeeded = true;
+            return;
+        }
+        this.setupDocSeeded = true;
+        await this.reloadConfigFromSetupDoc();
+    }
+    /** Fresh read of the setup document (no-op with an explicit config). */
+    async reloadConfigFromSetupDoc() {
+        if (this.hasExplicitConfig) {
+            return;
+        }
+        try {
+            const doc = await this.db.getDocument(types_1.DB_SETUP_DOC_ID);
+            const config = (0, types_2.sanitizeFulltextConfig)(doc.getData()[types_2.FULLTEXT_SETUP_FIELD]);
+            this.applyConfig(config);
+        }
+        catch {
+            // No setup document (or not readable) → keep the current config.
+        }
+    }
+    /**
+     * Make sure the effective configuration is settled: consults the
+     * {@link DB_SETUP_DOC_ID} document once (unless the config was provided
+     * in code) and returns the resolved configuration.
+     */
+    async ensureConfigLoaded() {
+        await this.seedConfigFromSetupDoc();
+        return this.config;
+    }
+    /**
+     * `"full"` when the index reflects the current configuration,
+     * `"rebuilding"` while a configuration-change backfill is in progress.
+     */
+    getCoverage() {
+        return this.needsBackfill ? "rebuilding" : "full";
+    }
+    // ---------------------------------------------------------------------------
+    // Reads
+    // ---------------------------------------------------------------------------
+    getSize() {
+        return this.engine.getDocumentCount();
+    }
+    getCursor() {
+        return this.cursor;
+    }
+    /** Index field names currently known (document paths + `_attachments`). */
+    getFieldNames() {
+        return this.engine.getFieldNames();
+    }
+    /**
+     * Full-text search. Brings the index up to date first (same catch-up
+     * semantics as queries against the summary buffer), then returns
+     * matching documents best-score-first.
+     *
+     * @throws Error when full-text indexing is not enabled for this
+     *   database (neither via `fulltextSetup` nor an explicit config).
+     */
+    async search(query, options) {
+        await this.update(options);
+        if (!this.config.enabled) {
+            throw new Error(`Full-text search is not enabled for this database. ` +
+                `Enable it via setFulltextSetup({ enabled: true }) or pass an explicit config to getFullTextIndex().`);
+        }
+        return {
+            hits: this.engine.search(query, options),
+            coverage: this.getCoverage(),
+        };
+    }
+    /**
+     * Search without a catch-up run — evaluates against the current index
+     * state. Used by the query engine, which coordinates update passes
+     * itself.
+     */
+    searchSync(query, options) {
+        return {
+            hits: this.engine.search(query, options),
+            coverage: this.getCoverage(),
+        };
+    }
+    // ---------------------------------------------------------------------------
+    // Incremental update
+    // ---------------------------------------------------------------------------
+    /**
+     * Bring the index up to date with the changefeed. Restores persisted
+     * state on first use, then consumes `iterateChangesSince` from the
+     * saved cursor and finally works down a pending configuration backfill.
+     * While the configuration has `enabled: false` this is a cheap no-op
+     * (one setup-document read to detect a later enable).
+     *
+     * Accepts the same batching/progress/cancellation options as summary
+     * updates; an interrupted run resumes from the saved cursors. Calls are
+     * single-flight: concurrent callers share one run.
+     */
+    async update(options) {
+        if (this.updatePromise) {
+            return this.updatePromise;
+        }
+        this.updatePromise = this.runUpdate(options).finally(() => {
+            this.updatePromise = null;
+        });
+        return this.updatePromise;
+    }
+    async runUpdate(options) {
+        await this.seedConfigFromSetupDoc();
+        if (!this.config.enabled) {
+            // Disabled: don't touch the changefeed (that would materialize
+            // documents for nothing). Re-check the setup document so an enable
+            // arriving via sync is picked up by the next update call.
+            await this.reloadConfigFromSetupDoc();
+            if (!this.config.enabled) {
+                return;
+            }
+        }
+        await this.ensureRestored();
+        const applyBatchSize = options?.applyBatchSize ?? 100;
+        const onProgress = options?.onProgress;
+        const signal = options?.signal;
+        const countAfter = (cursor) => this.db.countChangesSince?.(cursor) ?? 0;
+        const total = onProgress
+            ? countAfter(this.cursor) + (this.needsBackfill ? countAfter(this.backfillCursor) : 0)
+            : 0;
+        let processed = 0;
+        let processedInBatch = 0;
+        // Returns true when the run should stop after the current batch.
+        const stopRequested = () => {
+            const callbackStop = onProgress?.({ processed, total, origin: "fulltext" }) === false;
+            return callbackStop || signal?.aborted === true;
+        };
+        if (signal?.aborted) {
+            return;
+        }
+        // Pass 1: incremental changefeed consumption from the main cursor.
+        for await (const { doc, cursor } of this.db.iterateChangesSince(this.cursor)) {
+            await this.applyDocument(doc.getId(), doc);
+            this.cursor = cursor;
+            processed++;
+            processedInBatch++;
+            if (processedInBatch >= applyBatchSize) {
+                processedInBatch = 0;
+                this.cacheManager?.markDirty();
+                if (stopRequested()) {
+                    return;
+                }
+            }
+            if (!this.config.enabled) {
+                // A dbsetup change in the feed disabled the index: stop consuming.
+                return;
+            }
+        }
+        // Pass 2: configuration backfill (re-index everything with the new
+        // config/engine). The feed yields each document's latest state once,
+        // so plain re-adds converge; docs changing mid-backfill are
+        // re-processed by the next pass 1 anyway.
+        if (this.needsBackfill) {
+            for await (const { doc, cursor } of this.db.iterateChangesSince(this.backfillCursor)) {
+                await this.applyDocument(doc.getId(), doc);
+                this.backfillCursor = cursor;
+                processed++;
+                processedInBatch++;
+                if (processedInBatch >= applyBatchSize) {
+                    processedInBatch = 0;
+                    this.cacheManager?.markDirty();
+                    if (stopRequested()) {
+                        return;
+                    }
+                }
+                if (!this.config.enabled) {
+                    return;
+                }
+            }
+            this.needsBackfill = false;
+            this.backfillCursor = null;
+            this.metaDirty = true;
+        }
+        this.cacheManager?.markDirty();
+        if (onProgress) {
+            onProgress({ processed, total, origin: "fulltext" });
+        }
+    }
+    async applyDocument(docId, doc) {
+        if (docId === types_1.DB_SETUP_DOC_ID) {
+            // The setup document configures the index instead of appearing in
+            // it. Config changes (also arriving via sync) recreate the engine
+            // and schedule a backfill; a deleted setup document falls back to
+            // the default (disabled) config.
+            if (!this.hasExplicitConfig) {
+                const config = doc.isDeleted()
+                    ? undefined
+                    : (0, types_2.sanitizeFulltextConfig)(doc.getData()[types_2.FULLTEXT_SETUP_FIELD]);
+                this.applyConfig(config);
+            }
+            if (this.engine.has(docId)) {
+                this.engine.remove(docId);
+                this.markEngineDirty();
+            }
+            return;
+        }
+        if (doc.isDeleted()) {
+            if (this.engine.has(docId)) {
+                this.engine.remove(docId);
+                this.markEngineDirty();
+            }
+            return;
+        }
+        const fields = (0, extractFulltextText_1.extractFulltextFields)(doc.getData(), this.config);
+        const attachmentText = await this.collectAttachmentText(doc);
+        if (attachmentText !== null) {
+            fields[types_2.FULLTEXT_ATTACHMENT_FIELD] = attachmentText;
+        }
+        if (Object.keys(fields).length === 0) {
+            if (this.engine.has(docId)) {
+                this.engine.remove(docId);
+                this.markEngineDirty();
+            }
+            return;
+        }
+        this.engine.add(docId, fields);
+        this.markEngineDirty();
+    }
+    /**
+     * Collect the searchable text of a document's attachments into the
+     * synthetic {@link FULLTEXT_ATTACHMENT_FIELD} (capped at
+     * `maxFieldBytes` like every other index field). Two sources feed it:
+     *
+     * 1. **Persisted extraction results** (`extractedText` on the
+     *    attachment entry, written via
+     *    `MindooDoc.setAttachmentExtractedText()`, e.g. by Haven's OCR
+     *    service). These are always indexed — the text is already there,
+     *    costs nothing, and is obviously meant to be searchable.
+     * 2. **Registered extractors** (cheap formats: plain text, PDF text
+     *    layer, Office) — only when `config.attachments` is enabled, and
+     *    only for attachments without a persisted result (a persisted
+     *    "failed"/"skipped" marker also suppresses the extractor run).
+     *
+     * Extraction failures skip the attachment — a broken PDF must never
+     * stall the changefeed pipeline.
+     */
+    async collectAttachmentText(doc) {
+        if (typeof doc.getAttachments !== "function") {
+            return null;
+        }
+        const attachments = doc.getAttachments();
+        if (attachments.length === 0) {
+            return null;
+        }
+        const extractors = this.config.attachments ? this.getAttachmentExtractors() : [];
+        const parts = [];
+        let budget = this.config.maxFieldBytes;
+        for (const attachment of attachments) {
+            if (budget <= 0) {
+                break;
+            }
+            // Source 1: persisted extraction result at the attachment entry.
+            if (typeof attachment.extractedText === "string") {
+                const persisted = attachment.extractedText;
+                if (persisted.trim().length > 0) {
+                    const clipped = persisted.length > budget ? persisted.slice(0, budget) : persisted;
+                    parts.push(clipped);
+                    budget -= clipped.length;
+                }
+                continue;
+            }
+            if (attachment.extractionStatus !== undefined) {
+                // "failed"/"skipped" marker without text: deliberate outcome —
+                // don't burn extractor time on it.
+                continue;
+            }
+            // Source 2: registered extractors (config.attachments only).
+            if (extractors.length === 0) {
+                continue;
+            }
+            if (attachment.size > MAX_ATTACHMENT_EXTRACT_BYTES) {
+                continue;
+            }
+            const extractor = extractors.find((candidate) => candidate.supports(attachment.mimeType ?? "", attachment.fileName ?? ""));
+            if (!extractor) {
+                continue;
+            }
+            try {
+                const bytes = await doc.getAttachment(attachment.attachmentId);
+                const text = await extractor.extract(bytes, {
+                    mimeType: attachment.mimeType ?? "",
+                    fileName: attachment.fileName ?? "",
+                });
+                if (text && text.trim().length > 0) {
+                    const clipped = text.length > budget ? text.slice(0, budget) : text;
+                    parts.push(clipped);
+                    budget -= clipped.length;
+                }
+            }
+            catch {
+                // Skip unreadable/unsupported attachments; document fields are
+                // still indexed.
+            }
+        }
+        return parts.length > 0 ? parts.join(" ") : null;
+    }
+    /**
+     * Drop a document's index entry immediately (called from the DB's purge
+     * paths so extracted plaintext tokens never outlive key
+     * revocation/purges; the changefeed tombstone would remove it anyway,
+     * but only on the next update run).
+     */
+    removeDocument(docId) {
+        if (this.engine.has(docId)) {
+            this.engine.remove(docId);
+            this.markEngineDirty();
+            this.cacheManager?.markDirty();
+        }
+    }
+    /** Drop all indexed content and cursors (e.g. after the underlying store was cleared). */
+    reset() {
+        this.engine.clear();
+        this.cursor = null;
+        this.needsBackfill = false;
+        this.backfillCursor = null;
+        this.engineDirty = true;
+        this.metaDirty = true;
+        this.cacheManager?.markDirty();
+    }
+    // ---------------------------------------------------------------------------
+    // Persistence (ICacheable)
+    // ---------------------------------------------------------------------------
+    /**
+     * Attach cache persistence. `cachePrefix` scopes all records of this
+     * index (recommended: `<dbCachePrefix>/fulltext`). Registers with the
+     * CacheManager for periodic flushing; the persisted state is restored
+     * lazily on the first `update()` call.
+     */
+    attachCache(cacheManager, cachePrefix) {
+        this.cacheManager = cacheManager;
+        this.cachePrefix = cachePrefix;
+        cacheManager.register(this);
+    }
+    getCachePrefix() {
+        return this.cachePrefix ?? "fulltext";
+    }
+    hasDirtyState() {
+        return this.engineDirty || this.metaDirty;
+    }
+    clearDirty() {
+        this.engineDirty = false;
+        this.metaDirty = false;
+    }
+    markEngineDirty() {
+        this.engineDirty = true;
+        this.metaDirty = true;
+    }
+    async flushToCache(store, _options) {
+        const prefix = this.getCachePrefix();
+        let written = 0;
+        if (this.engineDirty) {
+            await store.put("fulltext", `${prefix}/engine`, this.engine.serialize());
+            written++;
+        }
+        const meta = {
+            cursor: this.cursor,
+            configFingerprint: this.configFingerprint,
+            needsBackfill: this.needsBackfill,
+            backfillCursor: this.backfillCursor,
+        };
+        await store.put("fulltext", `${prefix}/meta`, new TextEncoder().encode(JSON.stringify(meta)));
+        written++;
+        return written;
+    }
+    async ensureRestored() {
+        if (this.restored || !this.cacheManager) {
+            this.restored = true;
+            return;
+        }
+        if (!this.restorePromise) {
+            this.restorePromise = this.restoreFromCache().finally(() => {
+                this.restored = true;
+            });
+        }
+        return this.restorePromise;
+    }
+    /**
+     * Restore persisted state. Unlike the summary, index content is only
+     * usable when the config fingerprint matches exactly (tokenization is
+     * config-dependent); a mismatch or unreadable blob starts empty and
+     * schedules a full backfill instead.
+     */
+    async restoreFromCache() {
+        const store = this.cacheManager?.getStore();
+        if (!store) {
+            return;
+        }
+        const prefix = this.getCachePrefix();
+        let meta;
+        try {
+            const metaBytes = await store.get("fulltext", `${prefix}/meta`);
+            if (!metaBytes) {
+                return;
+            }
+            meta = JSON.parse(new TextDecoder().decode(metaBytes));
+        }
+        catch {
+            return;
+        }
+        if (meta.configFingerprint !== this.configFingerprint) {
+            // Index was built with a different configuration/engine version:
+            // start empty, re-index everything in the background.
+            this.scheduleBackfill();
+            this.metaDirty = true;
+            return;
+        }
+        try {
+            const engineBytes = await store.get("fulltext", `${prefix}/engine`);
+            if (engineBytes) {
+                this.engine.load(engineBytes);
+            }
+        }
+        catch {
+            // A corrupt blob only loses the cached index; rebuild from the feed.
+            this.engine = this.createEngine();
+            this.cursor = null;
+            this.scheduleBackfill();
+            this.metaDirty = true;
+            return;
+        }
+        this.cursor = meta.cursor ?? null;
+        if (meta.needsBackfill) {
+            // Resume an interrupted backfill where it left off.
+            this.needsBackfill = true;
+            this.backfillCursor = meta.backfillCursor ?? null;
+        }
+    }
+}
+exports.DocumentFullTextIndex = DocumentFullTextIndex;
+//# sourceMappingURL=DocumentFullTextIndex.js.map

package/dist/core/indexing/fulltext/DocumentFullTextIndex.js.map

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

package/dist/core/indexing/fulltext/SearchEngineAdapter.d.ts

@@ -0,0 +1,69 @@
+import type { FulltextSearchHit, FulltextSearchOptions } from "./types";
+/**
+ * Narrow interface between the {@link DocumentFullTextIndex} and the
+ * underlying search engine. Everything engine-specific (MiniSearch today;
+ * Orama, vector search, ... later) stays behind this seam — including the
+ * serialization format, so an engine swap is just a format-version bump
+ * that triggers a rebuild.
+ */
+export interface SearchEngineAdapter {
+    /** Add or replace the indexed text fields of a document. */
+    add(docId: string, fields: Record<string, string>): void;
+    /** Remove a document from the index (no-op when absent). */
+    remove(docId: string): void;
+    has(docId: string): boolean;
+    search(query: string, options?: FulltextSearchOptions): FulltextSearchHit[];
+    getDocumentCount(): number;
+    /** All field names the index currently knows. */
+    getFieldNames(): string[];
+    /** Serialize the full engine state (loadable via {@link load}). */
+    serialize(): Uint8Array;
+    /**
+     * Restore state produced by {@link serialize}. Throws when the payload
+     * is unreadable or from an incompatible format version — callers treat
+     * that as "start empty and rebuild".
+     */
+    load(bytes: Uint8Array): void;
+    /** Drop all indexed documents. */
+    clear(): void;
+}
+/**
+ * Build the tokenizer for a language: `Intl.Segmenter` word segmentation
+ * where available (correct for CJK and other scripts without word
+ * spaces), otherwise a Unicode letters/digits fallback (e.g. React
+ * Native/Hermes without `Intl.Segmenter`).
+ */
+export declare function createTokenizer(language: string): (text: string) => string[];
+/**
+ * MiniSearch-backed {@link SearchEngineAdapter}.
+ *
+ * MiniSearch requires the indexed field list at construction time, but
+ * mindoodb documents are schemaless (auto mode indexes whatever string
+ * fields documents have). The adapter therefore keeps the extracted
+ * source texts per document and transparently rebuilds the MiniSearch
+ * instance when a previously unseen field name appears — rare in
+ * practice, since real databases converge on a stable field set quickly.
+ * The kept source texts also make the serialized state self-contained.
+ */
+export declare class MiniSearchAdapter implements SearchEngineAdapter {
+    private readonly language;
+    private readonly tokenize;
+    private fieldNames;
+    private docs;
+    private engine;
+    constructor(language: string, initialFields?: string[]);
+    private engineOptions;
+    private createEngine;
+    /** Rebuild the MiniSearch instance over a grown field list. */
+    private rebuildWithFields;
+    add(docId: string, fields: Record<string, string>): void;
+    remove(docId: string): void;
+    has(docId: string): boolean;
+    search(query: string, options?: FulltextSearchOptions): FulltextSearchHit[];
+    getDocumentCount(): number;
+    getFieldNames(): string[];
+    serialize(): Uint8Array;
+    load(bytes: Uint8Array): void;
+    clear(): void;
+}
+//# sourceMappingURL=SearchEngineAdapter.d.ts.map

package/dist/core/indexing/fulltext/SearchEngineAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchEngineAdapter.d.ts","sourceRoot":"","sources":["../../../../src/core/indexing/fulltext/SearchEngineAdapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAGxE;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,4DAA4D;IAC5D,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACzD,4DAA4D;IAC5D,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,iBAAiB,EAAE,CAAC;IAC5E,gBAAgB,IAAI,MAAM,CAAC;IAC3B,iDAAiD;IACjD,aAAa,IAAI,MAAM,EAAE,CAAC;IAC1B,mEAAmE;IACnE,SAAS,IAAI,UAAU,CAAC;IACxB;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,kCAAkC;IAClC,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,CAkC5E;AAqBD;;;;;;;;;;GAUG;AACH,qBAAa,iBAAkB,YAAW,mBAAmB;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,UAAU,CAAW;IAC7B,OAAO,CAAC,IAAI,CAAkD;IAC9D,OAAO,CAAC,MAAM,CAA6B;gBAE/B,QAAQ,EAAE,MAAM,EAAE,aAAa,GAAE,MAAM,EAAO;IAO1D,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,YAAY;IAIpB,+DAA+D;IAC/D,OAAO,CAAC,iBAAiB;IAQzB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAuBxD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ3B,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI3B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,iBAAiB,EAAE;IA0B3E,gBAAgB,IAAI,MAAM;IAI1B,aAAa,IAAI,MAAM,EAAE;IAIzB,SAAS,IAAI,UAAU;IAWvB,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAoB7B,KAAK,IAAI,IAAI;CAId"}