@mlightcad/cad-simple-viewer 1.7.4 → 1.7.6-preview.0

package/lib/find/findDrawing.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Whole-drawing text search (FIND across layouts).
+ *
+ * Builds on {@link acapFindTextInLayout}: every layout of the drawing (model
+ * space and each paper space, in tab order) is searched with the same rules,
+ * and every hit is tagged with the layout it lives in so a UI can show it and
+ * navigate there.
+ *
+ * Pure TypeScript with no runtime imports (structural database shape), shared
+ * by cad-simple-ui-plugin and the Vue cad-viewer.
+ */
+import { type AcApFindDatabaseLike, type AcApFindHit, type AcApFindOptions } from './findText';
+/**
+ * Where to search.
+ *
+ * - `drawing` (default): every layout of the drawing
+ * - `layout`: only the layout that is currently active in the view
+ */
+export type AcApFindScope = 'drawing' | 'layout';
+/** One layout of the drawing (model space or paper space). */
+export interface AcApFindLayoutInfo {
+    /** Layout name as shown on the layout tab (e.g. `Model`, `Layout1`). */
+    name: string;
+    /** Block table record id of the layout. */
+    btrId: string;
+    /** Tab order; layouts are searched and listed in this order. */
+    tabOrder: number;
+}
+/** A hit that also identifies the layout that contains it. */
+export interface AcApFindLayoutHit extends AcApFindHit {
+    /** Block table record id of the layout containing the hit. */
+    layoutId: string;
+    /** Name of the layout containing the hit. */
+    layoutName: string;
+}
+/** Result of one drawing-level search. */
+export interface AcApFindDrawingResult {
+    hits: AcApFindLayoutHit[];
+    /** True when more than `maxResults` entities matched. */
+    truncated: boolean;
+}
+/** Options for {@link acapFindText}. */
+export interface AcApFindDrawingOptions extends AcApFindOptions {
+    /** Search scope; defaults to `drawing`. */
+    scope?: AcApFindScope;
+    /**
+     * Block table record id of the layout currently shown. Required for the
+     * `layout` scope; also used as the only layout when the drawing exposes no
+     * layout objects.
+     */
+    currentLayoutId: string;
+}
+interface LayoutLike {
+    layoutName?: string;
+    tabOrder?: number;
+    blockTableRecordId?: string;
+}
+/** Database shape used to enumerate layouts. */
+export interface AcApFindLayoutsDatabaseLike {
+    objects?: {
+        layout?: {
+            newIterator?(): Iterable<LayoutLike>;
+        };
+    };
+}
+/**
+ * Lists the layouts of a drawing sorted by tab order (model space first in
+ * practice). Returns an empty list when the drawing has no layout objects.
+ */
+export declare function acapListFindLayouts(db: AcApFindLayoutsDatabaseLike): AcApFindLayoutInfo[];
+/**
+ * Finds text in the whole drawing or in the current layout only.
+ *
+ * Layouts are visited in tab order and the result cap is shared, so
+ * `truncated` is true as soon as any match beyond `maxResults` exists in any
+ * searched layout. Search runs on the database, not on the rendered scene, so
+ * layouts that were never opened in the view are searched too.
+ */
+export declare function acapFindText(db: AcApFindDatabaseLike & AcApFindLayoutsDatabaseLike, query: string, options: AcApFindDrawingOptions): AcApFindDrawingResult;
+/** Axis-aligned 2D box in WCS (plain numbers; no geometry library needed). */
+export interface AcApFindBox {
+    min: {
+        x: number;
+        y: number;
+    };
+    max: {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * View box for a hit: the text extents (`hit.extents` for nested text), widened so a short label does not
+ * zoom in absurdly far (at least ~10 text heights wide). Falls back to the
+ * hit position when the entity has no usable extents.
+ *
+ * @param layoutBtrId - Layout that contains the hit (`hit.layoutId`).
+ */
+export declare function acapFindHitBox(db: AcApFindDatabaseLike, layoutBtrId: string, hit: AcApFindHit): AcApFindBox;
+export {};
+//# sourceMappingURL=findDrawing.d.ts.map

package/lib/find/findDrawing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findDrawing.d.ts","sourceRoot":"","sources":["../../src/find/findDrawing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,KAAK,eAAe,EAErB,MAAM,YAAY,CAAA;AAEnB;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,QAAQ,CAAA;AAEhD,8DAA8D;AAC9D,MAAM,WAAW,kBAAkB;IACjC,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAA;IACZ,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAA;IACb,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,8DAA8D;AAC9D,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAA;IAChB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,0CAA0C;AAC1C,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,iBAAiB,EAAE,CAAA;IACzB,yDAAyD;IACzD,SAAS,EAAE,OAAO,CAAA;CACnB;AAED,wCAAwC;AACxC,MAAM,WAAW,sBAAuB,SAAQ,eAAe;IAC7D,2CAA2C;IAC3C,KAAK,CAAC,EAAE,aAAa,CAAA;IACrB;;;;OAIG;IACH,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,UAAU,UAAU;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,gDAAgD;AAChD,MAAM,WAAW,2BAA2B;IAC1C,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE;YAAE,WAAW,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAA;SAAE,CAAA;KAClD,CAAA;CACF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,2BAA2B,GAC9B,kBAAkB,EAAE,CAetB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,oBAAoB,GAAG,2BAA2B,EACtD,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,sBAAsB,GAC9B,qBAAqB,CAkCvB;AAED,8EAA8E;AAC9E,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7B,GAAG,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC9B;AAOD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,oBAAoB,EACxB,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,WAAW,GACf,WAAW,CAwCb"}

package/lib/find/findDrawing.js

@@ -0,0 +1,183 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __values = (this && this.__values) || function(o) {
+    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
+    if (m) return m.call(o);
+    if (o && typeof o.length === "number") return {
+        next: function () {
+            if (o && i >= o.length) o = void 0;
+            return { value: o && o[i++], done: !o };
+        }
+    };
+    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
+};
+/**
+ * Whole-drawing text search (FIND across layouts).
+ *
+ * Builds on {@link acapFindTextInLayout}: every layout of the drawing (model
+ * space and each paper space, in tab order) is searched with the same rules,
+ * and every hit is tagged with the layout it lives in so a UI can show it and
+ * navigate there.
+ *
+ * Pure TypeScript with no runtime imports (structural database shape), shared
+ * by cad-simple-ui-plugin and the Vue cad-viewer.
+ */
+import { ACAP_FIND_MAX_RESULTS, acapFindTextInLayout } from './findText';
+/**
+ * Lists the layouts of a drawing sorted by tab order (model space first in
+ * practice). Returns an empty list when the drawing has no layout objects.
+ */
+export function acapListFindLayouts(db) {
+    var e_1, _a;
+    var _b, _c;
+    var table = (_b = db.objects) === null || _b === void 0 ? void 0 : _b.layout;
+    if (!(table === null || table === void 0 ? void 0 : table.newIterator))
+        return [];
+    var layouts = [];
+    try {
+        for (var _d = __values(table.newIterator()), _e = _d.next(); !_e.done; _e = _d.next()) {
+            var layout = _e.value;
+            if (!layout.blockTableRecordId)
+                continue;
+            layouts.push({
+                name: (_c = layout.layoutName) !== null && _c !== void 0 ? _c : '',
+                btrId: layout.blockTableRecordId,
+                tabOrder: Number(layout.tabOrder) || 0
+            });
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (_e && !_e.done && (_a = _d.return)) _a.call(_d);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return layouts.sort(function (a, b) { return a.tabOrder - b.tabOrder || a.name.localeCompare(b.name); });
+}
+/**
+ * Finds text in the whole drawing or in the current layout only.
+ *
+ * Layouts are visited in tab order and the result cap is shared, so
+ * `truncated` is true as soon as any match beyond `maxResults` exists in any
+ * searched layout. Search runs on the database, not on the rendered scene, so
+ * layouts that were never opened in the view are searched too.
+ */
+export function acapFindText(db, query, options) {
+    var e_2, _a, e_3, _b;
+    var _c;
+    var max = (_c = options.maxResults) !== null && _c !== void 0 ? _c : ACAP_FIND_MAX_RESULTS;
+    var known = acapListFindLayouts(db);
+    var nameOf = function (btrId) { var _a, _b; return (_b = (_a = known.find(function (layout) { return layout.btrId === btrId; })) === null || _a === void 0 ? void 0 : _a.name) !== null && _b !== void 0 ? _b : ''; };
+    var targets;
+    if (options.scope === 'layout' || known.length === 0) {
+        targets = [
+            { btrId: options.currentLayoutId, name: nameOf(options.currentLayoutId) }
+        ];
+    }
+    else {
+        targets = known.map(function (layout) { return ({ btrId: layout.btrId, name: layout.name }); });
+    }
+    var result = { hits: [], truncated: false };
+    try {
+        for (var targets_1 = __values(targets), targets_1_1 = targets_1.next(); !targets_1_1.done; targets_1_1 = targets_1.next()) {
+            var target = targets_1_1.value;
+            var found = acapFindTextInLayout(db, target.btrId, query, {
+                matchCase: options.matchCase,
+                maxResults: max - result.hits.length
+            });
+            try {
+                for (var _d = (e_3 = void 0, __values(found.hits)), _e = _d.next(); !_e.done; _e = _d.next()) {
+                    var hit = _e.value;
+                    result.hits.push(__assign(__assign({}, hit), { layoutId: target.btrId, layoutName: target.name }));
+                }
+            }
+            catch (e_3_1) { e_3 = { error: e_3_1 }; }
+            finally {
+                try {
+                    if (_e && !_e.done && (_b = _d.return)) _b.call(_d);
+                }
+                finally { if (e_3) throw e_3.error; }
+            }
+            if (found.truncated) {
+                result.truncated = true;
+                break;
+            }
+        }
+    }
+    catch (e_2_1) { e_2 = { error: e_2_1 }; }
+    finally {
+        try {
+            if (targets_1_1 && !targets_1_1.done && (_a = targets_1.return)) _a.call(targets_1);
+        }
+        finally { if (e_2) throw e_2.error; }
+    }
+    return result;
+}
+/**
+ * View box for a hit: the text extents (`hit.extents` for nested text), widened so a short label does not
+ * zoom in absurdly far (at least ~10 text heights wide). Falls back to the
+ * hit position when the entity has no usable extents.
+ *
+ * @param layoutBtrId - Layout that contains the hit (`hit.layoutId`).
+ */
+export function acapFindHitBox(db, layoutBtrId, hit) {
+    var e_4, _a;
+    var _b, _c;
+    var btr = db.tables.blockTable.getIdAt(layoutBtrId);
+    var owner = (_b = btr === null || btr === void 0 ? void 0 : btr.getIdAt) === null || _b === void 0 ? void 0 : _b.call(btr, hit.entityId);
+    var target = owner;
+    if (hit.kind === 'attribute' && (owner === null || owner === void 0 ? void 0 : owner.attributeIterator)) {
+        try {
+            for (var _d = __values(owner.attributeIterator()), _e = _d.next(); !_e.done; _e = _d.next()) {
+                var attribute = _e.value;
+                if (attribute.objectId === hit.textEntityId) {
+                    target = attribute;
+                    break;
+                }
+            }
+        }
+        catch (e_4_1) { e_4 = { error: e_4_1 }; }
+        finally {
+            try {
+                if (_e && !_e.done && (_a = _d.return)) _a.call(_d);
+            }
+            finally { if (e_4) throw e_4.error; }
+        }
+    }
+    var min;
+    var max;
+    try {
+        // Text nested in a block / dimension / table: the search already
+        // resolved its WCS extents (the owner's extents are the whole block).
+        var extents = (_c = hit.extents) !== null && _c !== void 0 ? _c : target === null || target === void 0 ? void 0 : target.geometricExtents;
+        if (!extents || !isFinite(extents.min.x) || !isFinite(extents.max.x)) {
+            throw new Error('no extents');
+        }
+        min = extents.min;
+        max = extents.max;
+    }
+    catch (_f) {
+        min = max = hit.position;
+    }
+    var cx = (min.x + max.x) / 2;
+    var cy = (min.y + max.y) / 2;
+    var w = max.x - min.x;
+    var h = max.y - min.y;
+    var width = Math.max(w * 3, h * 10, 1e-3);
+    var height = Math.max(h * 3, width / 4, 1e-3);
+    return {
+        min: { x: cx - width / 2, y: cy - height / 2 },
+        max: { x: cx + width / 2, y: cy + height / 2 }
+    };
+}
+//# sourceMappingURL=findDrawing.js.map

package/lib/find/findDrawing.js.map

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

package/lib/find/findText.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Text search over the entities of one layout (FIND).
+ *
+ * Shared by every UI (cad-simple-ui-plugin, the full Vue cad-viewer) so that
+ * both behave identically. Pure TypeScript with no runtime imports, published
+ * as the `@mlightcad/cad-simple-viewer/find` subpath.
+ *
+ * Searched fields:
+ * - `TEXT` — `textString`
+ * - `MTEXT` — `contents` with MTEXT formatting codes removed
+ * - `ATTRIB` — attribute value (`textString`) of every `INSERT` in the layout
+ *   (the tag is reported for display but is not searched)
+ * - `TEXT` / `MTEXT` / `ATTRIB` inside the block definition of every `INSERT`
+ *   (nested blocks included, anonymous/dynamic blocks too): title blocks,
+ *   legends and labels are usually drawn this way
+ * - constant `ATTDEF` values inside block definitions (the only ATTDEFs that
+ *   are drawn inside a block; templates get their value from an `ATTRIB`)
+ * - `DIMENSION` — the text of its dimension block when that block has a
+ *   match, otherwise the override text (`dimensionText`)
+ * - `MULTILEADER` — its MTEXT contents
+ * - `ACAD_TABLE` — the cell text (from the table block when present,
+ *   otherwise the cell strings)
+ *
+ * Every layout is visited in one synchronous pass per search. A hit inside a
+ * block, dimension or table selects the top-level entity of the layout that
+ * contains it, and carries the WCS extents of the matched text so the view
+ * can zoom to the text itself instead of to the whole block. Xrefs are not
+ * searched.
+ *
+ * The module is structural (no `instanceof`) so it can be unit tested with
+ * plain objects.
+ */
+/** Maximum number of hits returned by one search. */
+export declare const ACAP_FIND_MAX_RESULTS = 500;
+/** Kind of entity that produced a hit. */
+export type AcApFindHitKind = 'text' | 'mtext' | 'attribute'
+/** TEXT / MTEXT inside a block definition (via an `INSERT`). */
+ | 'block' | 'dimension' | 'leader' | 'table';
+/** Options for {@link acapFindTextInLayout}. */
+export interface AcApFindOptions {
+    /**
+     * When true the query must match case and accents exactly. When false
+     * (default) case, accents (diacritics) and runs of whitespace are ignored.
+     */
+    matchCase?: boolean;
+    /** Maximum hits to return; defaults to {@link ACAP_FIND_MAX_RESULTS}. */
+    maxResults?: number;
+}
+/** One match returned by {@link acapFindTextInLayout}. */
+export interface AcApFindHit {
+    /**
+     * Top-level entity of the layout that is selected (the `INSERT` for
+     * attributes and block text, the `DIMENSION` / `ACAD_TABLE` for their text).
+     */
+    entityId: string;
+    /**
+     * Key of the text that matched, unique within the layout: the entity id
+     * for top-level text, the attribute id for attributes, and
+     * `<entityId>/<nested id>…` for text found inside a block, dimension or
+     * table (the same block text appears once per `INSERT`).
+     */
+    textEntityId: string;
+    kind: AcApFindHitKind;
+    /** Plain text that matched (formatting codes removed, whitespace collapsed). */
+    text: string;
+    /** Attribute tag, for `attribute` hits. */
+    tag?: string;
+    /** Block name of the owning `INSERT`, for `attribute` hits. */
+    blockName?: string;
+    layer: string;
+    /** Insertion point of the text in WCS. */
+    position: {
+        x: number;
+        y: number;
+    };
+    /**
+     * WCS extents of the matched text, when known (text nested in a block,
+     * dimension or table). Used to zoom to the text itself.
+     */
+    extents?: {
+        min: {
+            x: number;
+            y: number;
+        };
+        max: {
+            x: number;
+            y: number;
+        };
+    };
+}
+/** Result of one search. */
+export interface AcApFindResult {
+    hits: AcApFindHit[];
+    /** True when more than `maxResults` entities matched. */
+    truncated: boolean;
+}
+type EntityLike = any;
+/** Minimal database shape used by the search. */
+export interface AcApFindDatabaseLike {
+    tables: {
+        blockTable: {
+            /** Block definition by name; used to search text inside blocks. */
+            getAt?(name: string): {
+                newIterator(): Iterable<EntityLike>;
+            } | undefined;
+            getIdAt(id: string): {
+                newIterator(): Iterable<EntityLike>;
+                /** Used to resolve the matched entity for zoom extents. */
+                getIdAt?(id: string): EntityLike;
+            } | undefined;
+        };
+        layerTable?: {
+            getAt(name: string): {
+                isOff?: boolean;
+                isFrozen?: boolean;
+            } | undefined;
+        };
+    };
+}
+/**
+ * Normalizes text or a query for comparison.
+ *
+ * - always: NFKC, whitespace runs → one space, trimmed
+ * - unless `matchCase`: accents removed, lower-cased
+ */
+export declare function acapNormalizeFindText(value: string, matchCase?: boolean): string;
+/**
+ * Converts MTEXT contents to plain text: removes formatting codes
+ * (`\f…;`, `\H…;`, `\C…;`, `\L \l \O \o \K \k`, braces), turns `\P` into a
+ * space, decodes `\~`, `\U+XXXX`, stacked fractions and `%%c %%d %%p`.
+ */
+export declare function acapMTextToPlainText(contents: string): string;
+/**
+ * Finds text in the entities of one block table record (a layout).
+ *
+ * Entities that are invisible or sit on an off/frozen layer are skipped so
+ * that results always correspond to something the user can see.
+ *
+ * @param db - Database owning the layout.
+ * @param layoutBtrId - Block table record id of the layout (model/paper space).
+ * @param query - User query; blank queries return no hits.
+ */
+export declare function acapFindTextInLayout(db: AcApFindDatabaseLike, layoutBtrId: string, query: string, options?: AcApFindOptions): AcApFindResult;
+/** Returns a short excerpt of `text` centred on the first match of `query`. */
+export declare function acapFindExcerpt(text: string, query: string, matchCase?: boolean, width?: number): string;
+export {};
+//# sourceMappingURL=findText.d.ts.map

package/lib/find/findText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findText.d.ts","sourceRoot":"","sources":["../../src/find/findText.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,qDAAqD;AACrD,eAAO,MAAM,qBAAqB,MAAM,CAAA;AAExC,0CAA0C;AAC1C,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,OAAO,GACP,WAAW;AACb,gEAAgE;GAC9D,OAAO,GACP,WAAW,GACX,QAAQ,GACR,OAAO,CAAA;AAEX,gDAAgD;AAChD,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;;OAKG;IACH,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,eAAe,CAAA;IACrB,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAA;IACZ,2CAA2C;IAC3C,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,0CAA0C;IAC1C,QAAQ,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAClC;;;OAGG;IACH,OAAO,CAAC,EAAE;QAAE,GAAG,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,GAAG,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAA;CAC3E;AAED,4BAA4B;AAC5B,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,WAAW,EAAE,CAAA;IACnB,yDAAyD;IACzD,SAAS,EAAE,OAAO,CAAA;CACnB;AAGD,KAAK,UAAU,GAAG,GAAG,CAAA;AAGrB,iDAAiD;AACjD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE;QACN,UAAU,EAAE;YACV,mEAAmE;YACnE,KAAK,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG;gBAAE,WAAW,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAA;aAAE,GAAG,SAAS,CAAA;YACzE,OAAO,CAAC,EAAE,EAAE,MAAM,GACd;gBACE,WAAW,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAA;gBACnC,2DAA2D;gBAC3D,OAAO,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAAA;aACjC,GACD,SAAS,CAAA;SACd,CAAA;QACD,UAAU,CAAC,EAAE;YACX,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG;gBAAE,KAAK,CAAC,EAAE,OAAO,CAAC;gBAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;aAAE,GAAG,SAAS,CAAA;SACzE,CAAA;KACF,CAAA;CACF;AAKD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,SAAS,UAAQ,GAChB,MAAM,CAMR;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiB7D;AAyHD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,oBAAoB,EACxB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,eAAoB,GAC5B,cAAc,CAwRhB;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,SAAS,UAAQ,EACjB,KAAK,SAAK,GACT,MAAM,CAQR"}