@ifc-lite/sdk 9.5.0 → 9.6.0

package/dist/headless/backend-query.js

@@ -0,0 +1,359 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+import { extractAllEntityAttributes, extractClassificationsOnDemand, extractDocumentsOnDemand, extractMaterialsOnDemand, extractRelationshipsOnDemand, extractExactRelatedIds, expandTypes, QUERY_REL_TYPE_MAP, extractTypePropertiesOnDemand, isQueryableObjectType, } from '@ifc-lite/parser';
+import { attributeNamesForSchema } from './schema-tables.js';
+import { EntityNode, matchesPropertyFilter } from '@ifc-lite/query';
+import { iterateEffectiveEntityIds } from '@ifc-lite/mutations';
+import { authoredValue } from './authored-attribute-value.js';
+import { foldRelationshipRows } from './backend-query-relationships.js';
+// `expandTypes` used to be defined here; it now comes from `@ifc-lite/parser`,
+// shared with the other query backends (see `query-backend-maps.ts`). Re-exported
+// so this module's consumers are unaffected by where it lives.
+export { expandTypes };
+/** Shared predicate for unfiltered headless object queries. */
+export const isProductType = isQueryableObjectType;
+function createdEntityData(created, ref, store) {
+    const names = attributeNamesForSchema(created.ifcType, store.schemaVersion);
+    const objectType = authoredValue(created.attributes[names.indexOf('ObjectType')]);
+    return {
+        ref,
+        globalId: created.globalId,
+        name: created.name ?? '',
+        type: created.ifcType,
+        description: created.description ?? '',
+        objectType: typeof objectType === 'string' ? objectType : '',
+    };
+}
+/**
+ * Build the query adapter over a store, folding whatever `overlay()` returns at
+ * call time. `overlay` is a getter, not a value: the backend creates its
+ * `MutablePropertyView` lazily on the first mutation, so a session that is only
+ * ever read gets `null` on every call and keeps the original store-only path.
+ */
+export function createQueryAdapter(store, modelId, overlay, mutationView, options = {}) {
+    const PaginationError = options.paginationError ?? Error;
+    const normalizeTypePropertyValue = options.normalizeTypePropertyValue ??
+        ((value) => value);
+    function entityData(ref) {
+        const pending = overlay();
+        if (pending?.deleted.has(ref.expressId))
+            return null;
+        const created = pending?.createdEntity(ref.expressId);
+        if (created) {
+            const data = createdEntityData(created, ref, store);
+            return { ...data, type: pending?.effectiveType(ref.expressId) ?? data.type };
+        }
+        // @raw-entity-enumeration-ok tombstones and overlay-created ids returned above; this point probe only checks the remaining parsed source
+        if (!store.entityIndex.byId.has(ref.expressId))
+            return null;
+        const node = new EntityNode(store, ref.expressId);
+        const type = node.type;
+        if (!type || type === 'Unknown')
+            return null;
+        return withOverrides({
+            ref,
+            globalId: node.globalId,
+            name: node.name,
+            type: pending?.effectiveType(ref.expressId) ?? type,
+            description: node.description,
+            objectType: node.objectType,
+        }, pending, ref.expressId);
+    }
+    function withOverrides(data, pending, expressId) {
+        if (!pending)
+            return data;
+        const overrides = pending.attributes(expressId);
+        const positional = pending.positionalAttributes(expressId);
+        if (overrides.size === 0 && positional.size === 0 && !pending.effectiveType(expressId))
+            return data;
+        const next = {
+            ...data,
+            type: pending.effectiveType(expressId) ?? data.type,
+            name: overrides.get('Name') ?? data.name,
+            description: overrides.get('Description') ?? data.description,
+            objectType: overrides.get('ObjectType') ?? data.objectType,
+        };
+        // Positional slots are named by the effective class (a queued retype wins).
+        const effectiveType = pending.effectiveType(expressId);
+        const exactType = effectiveType ?? (store.entities.getTypeName(expressId) || data.type);
+        const names = attributeNamesForSchema(exactType, store.schemaVersion);
+        if (effectiveType && names.length > 0 && !names.includes('ObjectType'))
+            next.objectType = '';
+        for (const [index, value] of positional) {
+            const authored = authoredValue(value);
+            const isUnset = value == null || (typeof value === 'string' && ['', '$', '*'].includes(value.trim()));
+            const text = typeof authored === 'string' ? authored : isUnset ? '' : null;
+            if (text === null)
+                continue;
+            if (names[index] === 'Name')
+                next.name = text;
+            else if (names[index] === 'Description')
+                next.description = text;
+            else if (names[index] === 'ObjectType')
+                next.objectType = text;
+        }
+        return next;
+    }
+    function properties(ref, captured) {
+        // `captured` lets a caller that already has the overlay pass it in rather
+        // than have it rebuilt per entity — the filter loop in `entities()` runs
+        // this once per candidate row.
+        const pending = captured !== undefined ? captured : overlay();
+        // An entity this session deleted answers nothing, as `entityData` and
+        // `entities` already have it answer nothing (#2014 review).
+        if (pending?.deleted.has(ref.expressId))
+            return [];
+        // `getForEntity` reads the same on-demand extraction the store would, then
+        // applies the overlay on top — so it is the whole answer, not the delta.
+        const psets = pending
+            ? pending.propertySets(ref.expressId)
+            : new EntityNode(store, ref.expressId).properties();
+        return psets.map((pset) => ({
+            name: pset.name,
+            globalId: pset.globalId,
+            properties: pset.properties.map((p) => ({ name: p.name, type: p.type, value: p.value })),
+        }));
+    }
+    function quantities(ref) {
+        const pending = overlay();
+        if (pending?.deleted.has(ref.expressId))
+            return [];
+        const qsets = pending
+            ? pending.quantitySets(ref.expressId)
+            : new EntityNode(store, ref.expressId).quantities();
+        return qsets.map((qset) => ({
+            name: qset.name,
+            quantities: qset.quantities.map((q) => ({ name: q.name, type: q.type, value: q.value })),
+        }));
+    }
+    function attributes(ref) {
+        const pending = overlay();
+        if (pending?.deleted.has(ref.expressId))
+            return [];
+        const created = pending?.createdEntity(ref.expressId);
+        const base = created
+            // Not in the store, so there is nothing to extract: name the authored
+            // positional list from the schema instead. Cross-schema, because a created
+            // IFC2X3 or IFC4X3 class is not in the IFC4 codegen pin (#2003).
+            ? namedAuthoredAttributes(created)
+            : extractAllEntityAttributes(store, ref.expressId);
+        if (!pending)
+            return base;
+        const overrides = pending.attributes(ref.expressId);
+        const positional = pending.positionalAttributes(ref.expressId);
+        if (overrides.size === 0 && positional.size === 0)
+            return base;
+        // Overwrite what the base carries, then append what it does not. The append
+        // is the half that was missing (#2014): `extractAllEntityAttributes` omits
+        // an attribute whose stored value is `$`, so setting a previously-unset
+        // `Description` changed the top-level field while this list still denied it
+        // — one payload contradicting itself. Appended names go last; the list is
+        // name-keyed and its order is not positional (the base already drops nulls).
+        const merged = new Map(base.map((attribute) => [attribute.name, attribute.value]));
+        const writes = new Map(overrides);
+        const exactType = created?.ifcType ?? store.entities.getTypeName(ref.expressId);
+        const names = attributeNamesForSchema(exactType, store.schemaVersion);
+        for (const [index, value] of positional) {
+            const name = names[index];
+            if (name)
+                writes.set(name, value);
+        }
+        for (const [name, value] of writes) {
+            const authored = authoredValue(value);
+            if (authored === undefined)
+                merged.delete(name);
+            else
+                merged.set(name, authored);
+        }
+        return [...merged].map(([name, value]) => ({ name, value }));
+    }
+    function namedAuthoredAttributes(created) {
+        // The *model's* schema, not the IFC4 pin. `IfcRelCoversSpaces` names slot 4
+        // `RelatedSpace` in IFC2X3 and `RelatingSpace` in IFC4, so the pinned answer
+        // reported a name the file would not serialise. Falls back to the parser's
+        // cross-schema list when the declared schema does not carry the class.
+        const names = attributeNamesForSchema(created.ifcType, store.schemaVersion);
+        const out = [];
+        for (let i = 0; i < created.attributes.length; i++) {
+            const value = authoredValue(created.attributes[i]);
+            if (value === undefined)
+                continue;
+            // No synthetic `Attribute7` names: `bim.attributes` is a list of IFC
+            // EXPRESS attribute names, and an invented one is not one. A payload
+            // longer than the schema knows about is the caller's to explain.
+            const name = names[i];
+            if (name === undefined)
+                continue;
+            out.push({ name, value });
+        }
+        return out;
+    }
+    return {
+        entities(descriptor) {
+            const pending = overlay();
+            const requested = descriptor.types && descriptor.types.length > 0
+                ? expandTypes(descriptor.types, store.schemaVersion)
+                : null;
+            const results = [];
+            for (const { expressId, type, overlayCreated } of iterateEffectiveEntityIds(store, mutationView(), requested ?? undefined)) {
+                if (!requested && !isProductType(type))
+                    continue;
+                const ref = { modelId, expressId };
+                if (overlayCreated) {
+                    const created = pending?.createdEntity(expressId);
+                    if (!created)
+                        throw new Error(`Missing pending entity #${expressId} during enumeration`);
+                    results.push(withOverrides(createdEntityData(created, ref, store), pending, expressId));
+                    continue;
+                }
+                const node = new EntityNode(store, expressId);
+                results.push(withOverrides({
+                    ref,
+                    globalId: node.globalId,
+                    name: node.name,
+                    type: node.type,
+                    description: node.description,
+                    objectType: node.objectType,
+                }, pending, expressId));
+            }
+            let filtered = results;
+            if (descriptor.filters && descriptor.filters.length > 0) {
+                const propsCache = new Map();
+                const cachedProps = (ref) => {
+                    let cached = propsCache.get(ref.expressId);
+                    if (!cached) {
+                        cached = properties(ref, pending);
+                        propsCache.set(ref.expressId, cached);
+                    }
+                    return cached;
+                };
+                // A `Qto_` filter (or any psetName with no matching property set)
+                // falls back to quantity sets — see `matchesPropertyFilter` in
+                // `@ifc-lite/query`'s `property-filter-match.ts`. Without this, a
+                // `Qto_WallBaseQuantities.NetVolume>1` filter (e.g. from the `#4094`
+                // selector adapter's `.select()`/`selector` param) silently matched
+                // zero entities even when the quantity was present.
+                const qsetsCache = new Map();
+                const cachedQuantities = (ref) => {
+                    let cached = qsetsCache.get(ref.expressId);
+                    if (!cached) {
+                        cached = quantities(ref);
+                        qsetsCache.set(ref.expressId, cached);
+                    }
+                    return cached;
+                };
+                for (const filter of descriptor.filters) {
+                    filtered = filtered.filter((entity) => matchesPropertyFilter(cachedProps(entity.ref), filter, cachedQuantities(entity.ref)));
+                }
+            }
+            // An explicit zero limit is empty. Reject invalid bounds rather than
+            // quietly serving more rows than the caller requested (#2298).
+            if (descriptor.offset != null) {
+                if (!Number.isFinite(descriptor.offset) || descriptor.offset < 0) {
+                    throw new PaginationError(`Invalid offset: ${descriptor.offset} (must be a non-negative finite number)`);
+                }
+                if (descriptor.offset > 0)
+                    filtered = filtered.slice(descriptor.offset);
+            }
+            if (descriptor.limit != null) {
+                if (!Number.isFinite(descriptor.limit) || descriptor.limit < 0) {
+                    throw new PaginationError(`Invalid limit: ${descriptor.limit} (must be a non-negative finite number)`);
+                }
+                filtered = filtered.slice(0, descriptor.limit);
+            }
+            return filtered;
+        },
+        // Headless contexts have no interactive viewer filter, so there is never an
+        // "active filter" to report (issue #1107).
+        entitiesMatchingActiveFilter: () => null,
+        entityData,
+        attributes,
+        properties: (ref) => properties(ref),
+        quantities,
+        classifications(ref) {
+            return extractClassificationsOnDemand(store, ref.expressId);
+        },
+        materials(ref) {
+            return extractMaterialsOnDemand(store, ref.expressId);
+        },
+        typeProperties(ref) {
+            const info = extractTypePropertiesOnDemand(store, ref.expressId);
+            if (!info)
+                return null;
+            return {
+                typeName: info.typeName,
+                typeId: info.typeId,
+                properties: info.properties.map((pset) => ({
+                    name: pset.name,
+                    globalId: pset.globalId,
+                    properties: pset.properties.map((p) => ({ name: p.name, type: p.type, value: normalizeTypePropertyValue(p.value) })),
+                })),
+            };
+        },
+        documents(ref) {
+            return extractDocumentsOnDemand(store, ref.expressId);
+        },
+        relationships(ref) {
+            const result = extractRelationshipsOnDemand(store, ref.expressId);
+            const pending = overlay();
+            if (!pending)
+                return result;
+            return foldRelationshipRows(result, pending, ref, entityData);
+        },
+        /**
+         * Containment, aggregation and typing, with the session's queued edits
+         * applied (#2014).
+         *
+         * This is the seam every containment answer already passes through:
+         * `bim.storey`, `bim.path`, `bim.contains`, `bim.decomposes` and
+         * `bim.containedIn` are all thin wrappers over it. Folding here is what
+         * stopped `query_entities(in_storey)` from dropping an entity that the same
+         * session had just created *and* placed with a queued
+         * `IfcRelContainedInSpatialStructure` — a query that returns an entity
+         * without the filter and drops it with one reads as a wrong storey rather
+         * than a missing fold.
+         *
+         * Three rules, in order:
+         *
+         * 1. A parsed edge is dropped when the session deleted the `IfcRel…` record
+         *    that produced it. The graph carries `relationshipId` per edge, so this
+         *    is exact rather than inferred.
+         * 2. An edge to or from a tombstoned entity is dropped. Deleting a storey
+         *    has to stop answering "this wall is in that storey".
+         * 3. Queued relationships are added. Deleting a queued relationship forgets
+         *    it outright, so there is no tombstone case to handle on this side.
+         *
+         * `forward` walks Relating → Related (a storey to its elements, a whole to
+         * its parts); `inverse` walks back.
+         */
+        related(ref, relType, direction) {
+            const relEnum = QUERY_REL_TYPE_MAP[relType];
+            if (relEnum === undefined)
+                return [];
+            const pending = overlay();
+            // A deleted entity relates to nothing (#2014 review).
+            if (pending?.deleted.has(ref.expressId))
+                return [];
+            const out = [];
+            const seen = new Set();
+            const take = (expressId) => {
+                if (pending?.deleted.has(expressId) || seen.has(expressId))
+                    return;
+                seen.add(expressId);
+                out.push(expressId);
+            };
+            const isDeleted = pending
+                ? (id) => pending.deleted.has(id) || pending.supersededRelationshipIds.has(id)
+                : () => false;
+            for (const id of extractExactRelatedIds(store, ref.expressId, relType, direction, isDeleted))
+                take(id);
+            for (const edge of pending?.relationshipEdges(ref.expressId, relType) ?? []) {
+                if (edge.direction === direction)
+                    take(edge.targetId);
+            }
+            return out.map((expressId) => ({ modelId: ref.modelId, expressId }));
+        },
+    };
+}
+//# sourceMappingURL=backend-query.js.map

package/dist/headless/backend-query.js.map

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

package/dist/headless/backend.d.ts

@@ -0,0 +1,80 @@
+/** Shared headless `BimBackend` over an already-loaded store. */
+import type { BimBackend, BimEventType, ModelBackendMethods, QueryBackendMethods, SelectionBackendMethods, VisibilityBackendMethods, ViewerBackendMethods, MutateBackendMethods, StoreBackendMethods, SpatialBackendMethods, ExportBackendMethods, LensBackendMethods, FilesBackendMethods, ScheduleBackendMethods, StructuralBackendMethods, CostBackendMethods } from '../index.js';
+import { type EntityRefCheck, type StyleBackendMethods } from '../index.js';
+import { type HeadlessOperation } from './capabilities.js';
+import type { HeadlessBackendOptions } from './options.js';
+import type { IfcDataStore } from '@ifc-lite/parser';
+import { MutablePropertyView, StoreEditor } from '@ifc-lite/mutations';
+import { type PendingOverlay } from './overlay.js';
+export declare class HeadlessBackend implements BimBackend {
+    readonly model: ModelBackendMethods;
+    readonly query: QueryBackendMethods;
+    readonly selection: SelectionBackendMethods;
+    /**
+     * Mutable so the MCP server can swap in streaming adapters when the
+     * viewer subprocess starts, then revert when it closes. Marked
+     * `readonly` on the BimBackend interface but the underlying instance
+     * is ours to manage.
+     */
+    visibility: VisibilityBackendMethods;
+    viewer: ViewerBackendMethods;
+    readonly mutate: MutateBackendMethods;
+    readonly style: StyleBackendMethods;
+    readonly store: StoreBackendMethods;
+    readonly spatial: SpatialBackendMethods;
+    readonly export: ExportBackendMethods;
+    readonly lens: LensBackendMethods;
+    readonly files: FilesBackendMethods;
+    readonly schedule: ScheduleBackendMethods;
+    readonly structural: StructuralBackendMethods;
+    readonly cost: CostBackendMethods;
+    private dataStore;
+    private modelName;
+    private modelId;
+    /** Every model id this backend answers for, so the schedule assert, the
+     *  `bim.mutate.*` guard and `bim.store.addEntity` cannot differ (#3764). The
+     *  legacy-host aliases are accepted only when explicitly supplied. */
+    private readonly acceptedModelIds;
+    /** The reference check `bim.mutate.*` is gated on (`null` when writable,
+     *  else the reason), exposed because the mutation TOOLS write into
+     *  `getMutationView()` directly and need the same gate (#3764). */
+    readonly checkEntityRef: EntityRefCheck;
+    private mutationView;
+    private storeEditor;
+    private readonly disposeRoomCommands;
+    private viewerAttached;
+    private readonly options;
+    private peerScopes;
+    capability(operation: HeadlessOperation): import("./capabilities.js").HeadlessCapability;
+    setPeerScopes(provider: typeof this.peerScopes): void;
+    dispose(): void;
+    constructor(store: IfcDataStore, modelName: string, modelId: string, options?: HeadlessBackendOptions, modelAliases?: readonly string[]);
+    subscribe(_event: BimEventType, _handler: (data: unknown) => void): () => void;
+    private createModelAdapter;
+    /** This session's queued edits, or null when it has none. */
+    pendingOverlay(): PendingOverlay | null;
+    private createSelectionAdapter;
+    private getOrCreateStoreEditor;
+    /** Expose the mutation view so tools can inspect pending mutations. */
+    getMutationView(): MutablePropertyView | null;
+    /**
+     * The overlay every `bim.mutate.*` write goes through, created on first use
+     * so a read-only session still pays nothing. Built by `getOrCreateStoreEditor`
+     * to keep the extractor wiring in one place.
+     */
+    /** The view `bim.mutate` writes through — public so `run_flow`'s `tables()` reads the same overlay. */
+    getOrCreateMutationView(): MutablePropertyView;
+    /** Force creation of the editor (used by mutation tools that always need it). */
+    ensureEditor(): StoreEditor;
+    /** Replace the viewer/visibility adapters at runtime (for ViewerManager). */
+    attachStreamingAdapters(viewer: ViewerBackendMethods, visibility: VisibilityBackendMethods): void;
+    /** Restore no-op viewer/visibility adapters (for ViewerManager close). */
+    detachStreamingAdapters(): void;
+    /** Whether `modelId` names the one model this backend holds. */
+    acceptsModelId(modelId: string): boolean;
+    /** Refuse an unknown model id loudly, at whichever surface was handed it. */
+    assertKnownModelId(modelId: string): void;
+    private createExportAdapter;
+    private createScheduleAdapter;
+}
+//# sourceMappingURL=backend.d.ts.map

package/dist/headless/backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/headless/backend.ts"],"names":[],"mappings":"AAIA,iEAAiE;AAEjE,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAMnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAA8E,KAAK,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAExJ,OAAO,EAA6B,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAE3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAwB,MAAM,qBAAqB,CAAC;AAQ7F,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAGpE,qBAAa,eAAgB,YAAW,UAAU;IAChD,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAC;IAC5C;;;;;OAKG;IACH,UAAU,EAAE,wBAAwB,CAAC;IACrC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,wBAAwB,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAElC,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB;;0EAEsE;IACtE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAoB;IACrD;;uEAEmE;IACnE,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAa;IACjD,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,UAAU,CAAoF;IAEtG,UAAU,CAAC,SAAS,EAAE,iBAAiB;IAEvC,aAAa,CAAC,QAAQ,EAAE,OAAO,IAAI,CAAC,UAAU,GAAG,IAAI;IAErD,OAAO,IAAI,IAAI;gBAEH,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,EAAE,YAAY,GAAE,SAAS,MAAM,EAAO;IAwD/I,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI;IAI9E,OAAO,CAAC,kBAAkB;IAqB1B,6DAA6D;IAC7D,cAAc,IAAI,cAAc,GAAG,IAAI;IAIvC,OAAO,CAAC,sBAAsB;IAQ9B,OAAO,CAAC,sBAAsB;IAU9B,uEAAuE;IACvE,eAAe,IAAI,mBAAmB,GAAG,IAAI;IAI7C;;;;OAIG;IACH,uGAAuG;IACvG,uBAAuB,IAAI,mBAAmB;IAO9C,iFAAiF;IACjF,YAAY,IAAI,WAAW;IAI3B,6EAA6E;IAC7E,uBAAuB,CAAC,MAAM,EAAE,oBAAoB,EAAE,UAAU,EAAE,wBAAwB,GAAG,IAAI;IAMjG,0EAA0E;IAC1E,uBAAuB,IAAI,IAAI;IAU/B,gEAAgE;IAChE,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIxC,6EAA6E;IAC7E,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAOzC,OAAO,CAAC,mBAAmB;IAkG3B,OAAO,CAAC,qBAAqB;CAmB9B"}