@loaders.gl/tiles 4.5.3 → 5.0.0-alpha.10

package/dist/tileset-3d/common/indexed-archive-tileset-source.d.ts

@@ -0,0 +1,60 @@
+import type { CoreAPI, Loader, LoaderOptions, ReadableFile } from '@loaders.gl/loader-utils';
+import type { TilesetSourceResolver } from "./tileset-source.js";
+/** Options for {@link IndexedArchiveTilesetSource}. */
+export type IndexedArchiveTilesetSourceOptions<ArchiveT> = {
+    /** Archive URL or Blob. */
+    data: string | Blob;
+    /** Filename to expose for Blob inputs that do not provide a name. */
+    fallbackFilename: string;
+    /** Archive file extension used as the URL path marker. */
+    archiveExtension: string;
+    /** Path to the root metadata resource inside the archive. */
+    rootPath: string;
+    /** Optional mode passed when loading the root metadata resource. */
+    rootMode?: string;
+    /** Parses an opened readable file into an indexed archive object. */
+    parseArchive: (file: ReadableFile) => Promise<ArchiveT>;
+    /** Loads one resource from the parsed archive. */
+    getFile: (archive: ArchiveT, pathInArchive: string, mode?: string) => Promise<ArrayBuffer>;
+    /** Returns the core API used for local file loading and nested resource parsing. */
+    getCoreApi: () => CoreAPI | undefined;
+    /** Error message to throw when the core API is required but unavailable. */
+    missingCoreApiMessage: string;
+};
+/**
+ * Tileset source resolver backed by an indexed archive such as 3TZ or SLPK.
+ *
+ * The source owns archive opening, archive caching, path resolution, and archive-backed `fetch`
+ * injection. Format-specific parsing and file lookup stay in the owning format module.
+ */
+export declare class IndexedArchiveTilesetSource<ArchiveT> implements TilesetSourceResolver {
+    /** URL exposed to the tileset source that owns this archive source. */
+    readonly sourceUrl: string;
+    private readonly options;
+    private archivePromise?;
+    /**
+     * Creates an indexed archive tileset source.
+     * @param options Archive source options
+     */
+    constructor(options: IndexedArchiveTilesetSourceOptions<ArchiveT>);
+    /**
+     * Loads and parses the archive root metadata resource.
+     * @param url Root URL, ignored because the archive root path is configured explicitly
+     * @param loader Loader used to parse the root metadata
+     * @param loadOptions Loader options forwarded to parsing
+     */
+    loadRoot<DataT>(url: string, loader: Loader<DataT>, loadOptions: LoaderOptions): Promise<DataT>;
+    /**
+     * Loads and parses an archive resource relative to a requesting resource URL.
+     * @param url Resource URL
+     * @param loader Loader used to parse the resource
+     * @param loadOptions Loader options forwarded to parsing
+     */
+    loadResource<DataT>(url: string, loader: Loader<DataT>, loadOptions: LoaderOptions): Promise<DataT>;
+    private parseArchiveResource;
+    private createArchiveFetch;
+    private loadFile;
+    private openArchiveReadableFile;
+    private resolveArchivePath;
+}
+//# sourceMappingURL=indexed-archive-tileset-source.d.ts.map

package/dist/tileset-3d/common/indexed-archive-tileset-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexed-archive-tileset-source.d.ts","sourceRoot":"","sources":["../../../src/tileset-3d/common/indexed-archive-tileset-source.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAC,MAAM,0BAA0B,CAAC;AAC3F,OAAO,KAAK,EAAC,qBAAqB,EAAC,4BAAyB;AAE5D,uDAAuD;AACvD,MAAM,MAAM,kCAAkC,CAAC,QAAQ,IAAI;IACzD,2BAA2B;IAC3B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,qEAAqE;IACrE,gBAAgB,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,gBAAgB,EAAE,MAAM,CAAC;IACzB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,YAAY,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxD,kDAAkD;IAClD,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IAC3F,oFAAoF;IACpF,UAAU,EAAE,MAAM,OAAO,GAAG,SAAS,CAAC;IACtC,4EAA4E;IAC5E,qBAAqB,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,2BAA2B,CAAC,QAAQ,CAAE,YAAW,qBAAqB;IACjF,uEAAuE;IACvE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+C;IACvE,OAAO,CAAC,cAAc,CAAC,CAAoB;IAE3C;;;OAGG;gBACS,OAAO,EAAE,kCAAkC,CAAC,QAAQ,CAAC;IAKjE;;;;;OAKG;IACG,QAAQ,CAAC,KAAK,EAClB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,EACrB,WAAW,EAAE,aAAa,GACzB,OAAO,CAAC,KAAK,CAAC;IAcjB;;;;;OAKG;IACG,YAAY,CAAC,KAAK,EACtB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,EACrB,WAAW,EAAE,aAAa,GACzB,OAAO,CAAC,KAAK,CAAC;YAKH,oBAAoB;IA+BlC,OAAO,CAAC,kBAAkB;YAUZ,QAAQ;YAQR,uBAAuB;IAkBrC,OAAO,CAAC,kBAAkB;CAgC3B"}

package/dist/tileset-3d/common/indexed-archive-tileset-source.js

@@ -0,0 +1,130 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { BlobFile, HttpFile, path } from '@loaders.gl/loader-utils';
+/**
+ * Tileset source resolver backed by an indexed archive such as 3TZ or SLPK.
+ *
+ * The source owns archive opening, archive caching, path resolution, and archive-backed `fetch`
+ * injection. Format-specific parsing and file lookup stay in the owning format module.
+ */
+export class IndexedArchiveTilesetSource {
+    /** URL exposed to the tileset source that owns this archive source. */
+    sourceUrl;
+    options;
+    archivePromise;
+    /**
+     * Creates an indexed archive tileset source.
+     * @param options Archive source options
+     */
+    constructor(options) {
+        this.options = options;
+        this.sourceUrl = getArchiveSourceUrl(options.data, options.fallbackFilename);
+    }
+    /**
+     * Loads and parses the archive root metadata resource.
+     * @param url Root URL, ignored because the archive root path is configured explicitly
+     * @param loader Loader used to parse the root metadata
+     * @param loadOptions Loader options forwarded to parsing
+     */
+    async loadRoot(url, loader, loadOptions) {
+        // Resolve root-relative URIs inside the archive rather than beside its download URL.
+        const resourceUrl = this.options.rootPath
+            ? `${stripQueryString(this.sourceUrl)}/${this.options.rootPath}`
+            : url;
+        return await this.parseArchiveResource(resourceUrl, this.options.rootPath, loader, loadOptions, this.options.rootMode);
+    }
+    /**
+     * Loads and parses an archive resource relative to a requesting resource URL.
+     * @param url Resource URL
+     * @param loader Loader used to parse the resource
+     * @param loadOptions Loader options forwarded to parsing
+     */
+    async loadResource(url, loader, loadOptions) {
+        const pathInArchive = this.resolveArchivePath(url, url);
+        return await this.parseArchiveResource(url, pathInArchive, loader, loadOptions);
+    }
+    async parseArchiveResource(resourceUrl, pathInArchive, loader, loadOptions, mode) {
+        const coreApi = this.options.getCoreApi();
+        if (!coreApi) {
+            throw new Error(this.options.missingCoreApiMessage);
+        }
+        const data = await this.loadFile(pathInArchive, mode);
+        const archiveFetch = this.createArchiveFetch(resourceUrl);
+        return (await coreApi.parse(data, loader, {
+            ...loadOptions,
+            fetch: archiveFetch
+        }, {
+            url: resourceUrl,
+            fetch: archiveFetch,
+            _parse: coreApi.parse,
+            loaders: [loader],
+            coreApi
+        }));
+    }
+    createArchiveFetch(contextUrl) {
+        return async (input) => {
+            const requestUrl = typeof input === 'string' ? input : input instanceof URL ? input.toString() : input.url;
+            const pathInArchive = this.resolveArchivePath(requestUrl, contextUrl);
+            const data = await this.loadFile(pathInArchive);
+            return new Response(data, { status: 200 });
+        };
+    }
+    async loadFile(pathInArchive, mode) {
+        this.archivePromise ||= this.openArchiveReadableFile().then(file => this.options.parseArchive(file));
+        const archive = await this.archivePromise;
+        return await this.options.getFile(archive, pathInArchive, mode);
+    }
+    async openArchiveReadableFile() {
+        const { data } = this.options;
+        if (typeof data !== 'string') {
+            return new BlobFile(data);
+        }
+        if (/^https?:\/\//i.test(data)) {
+            return new HttpFile(data);
+        }
+        const coreApi = this.options.getCoreApi();
+        if (!coreApi) {
+            throw new Error(this.options.missingCoreApiMessage);
+        }
+        const response = await coreApi.fetchFile(data);
+        return new BlobFile(await response.arrayBuffer());
+    }
+    resolveArchivePath(request, baseUrl) {
+        const requestWithoutQuery = stripQueryString(request);
+        const archiveRoot = stripQueryString(this.sourceUrl);
+        const baseWithoutQuery = stripQueryString(baseUrl);
+        const basePath = baseWithoutQuery === archiveRoot ? archiveRoot : path.dirname(baseWithoutQuery);
+        const markerExpression = new RegExp(`\\.${this.options.archiveExtension}/(.*)$`, 'i');
+        const markerMatch = requestWithoutQuery.match(markerExpression);
+        if (markerMatch?.[1]) {
+            return markerMatch[1];
+        }
+        const isAbsoluteRequest = /^[a-z][a-z0-9+.-]*:/i.test(requestWithoutQuery) || requestWithoutQuery.startsWith('/');
+        const absoluteRequest = requestWithoutQuery.startsWith(archiveRoot)
+            ? requestWithoutQuery
+            : baseWithoutQuery === archiveRoot && !isAbsoluteRequest
+                ? `${archiveRoot}/${requestWithoutQuery}`
+                : /^[a-z][a-z0-9+.-]*:\/\//i.test(baseWithoutQuery)
+                    ? new URL(requestWithoutQuery, baseWithoutQuery).href
+                    : path.resolve(basePath, requestWithoutQuery);
+        if (absoluteRequest === archiveRoot) {
+            return '';
+        }
+        if (absoluteRequest.startsWith(`${archiveRoot}/`)) {
+            return absoluteRequest.slice(archiveRoot.length + 1);
+        }
+        return absoluteRequest.replace(/^\/+/, '');
+    }
+}
+function getArchiveSourceUrl(data, fallbackFilename) {
+    if (typeof data === 'string') {
+        return data;
+    }
+    const fileName = 'name' in data && typeof data.name === 'string' && data.name ? data.name : fallbackFilename;
+    return `memory://${fileName}`;
+}
+function stripQueryString(url) {
+    return url.split(/[?#]/, 1)[0];
+}
+//# sourceMappingURL=indexed-archive-tileset-source.js.map

package/dist/tileset-3d/common/indexed-archive-tileset-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexed-archive-tileset-source.js","sourceRoot":"","sources":["../../../src/tileset-3d/common/indexed-archive-tileset-source.ts"],"names":[],"mappings":"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"}

package/dist/tileset-3d/common/tile-3d-contracts.d.ts

@@ -0,0 +1,63 @@
+/** Structural subset implemented by math.gl bounding volumes used by tile renderers. */
+export type Tile3DBoundingVolume = {
+    distanceSquaredTo?(point: unknown): number;
+    intersectPlane?(plane: unknown): number;
+};
+/** Renderer-neutral description of one ordered tile content entry. */
+export type Tile3DContent = {
+    /** Zero-based source order, stable across loading and unloading. */
+    index: number;
+    /** Resolved content URI when declared by the tileset. */
+    uri?: string;
+    /** Tileset group index declared by this content entry. */
+    group?: number;
+    /** Normalized tile content kind, when detected. */
+    type?: string;
+    /** Decoded payload, or null while unloaded/failed. */
+    payload: unknown;
+    /** Raw content metadata reference. */
+    metadata: Record<string, unknown> | null;
+    /** Transformed content volume, with tile-volume fallback. */
+    boundingVolume: Tile3DBoundingVolume | null;
+    /** Normalized feature-id declarations for this content. */
+    featureIds: Tile3DFeatureIdSet[];
+    /** Whether the payload can currently be rendered. */
+    renderable: boolean;
+};
+/** Renderer-neutral feature-id declaration from a tile content payload. */
+export type Tile3DFeatureIdSet = {
+    /** Source of the feature identifiers. */
+    source: 'attribute' | 'property-table' | 'constant' | 'texture' | 'implicit';
+    /** glTF attribute name for attribute-backed identifiers. */
+    attribute?: string;
+    /** Structural-metadata property-table index. */
+    propertyTable?: number;
+    /** Constant feature identifier. */
+    constant?: number;
+    /** Texture-backed identifier declaration, when present. */
+    texture?: Record<string, unknown>;
+    /** Implicit identifier declaration, when present. */
+    implicit?: Record<string, unknown>;
+    /** Decoded identifier values, when supplied by a content loader. */
+    values?: Uint32Array | Uint16Array | Uint8Array;
+    /** Unrecognized source fields preserved for forward compatibility. */
+    details?: Record<string, unknown>;
+};
+/** Raw metadata references inherited by a tile and its contents. */
+export type Tile3DMetadataContext = {
+    /** Tileset-level metadata entity. */
+    tileset?: Record<string, unknown> | null;
+    /** Group metadata entity selected for the tile's primary content. */
+    group?: Record<string, unknown> | null;
+    /** All tileset groups, used to resolve a selected content entry's group. */
+    groups?: readonly (Record<string, unknown> | null)[];
+    /** Tile metadata entity. */
+    tile?: Record<string, unknown> | null;
+    /** Content metadata entity. */
+    content?: Record<string, unknown> | null;
+    /** Implicit-subtree metadata entity. */
+    subtree?: Record<string, unknown> | null;
+};
+/** Extracts mesh-feature declarations from a decoded glTF-like payload. */
+export declare function getTile3DFeatureIdSets(payload: unknown): Tile3DFeatureIdSet[];
+//# sourceMappingURL=tile-3d-contracts.d.ts.map

package/dist/tileset-3d/common/tile-3d-contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tile-3d-contracts.d.ts","sourceRoot":"","sources":["../../../src/tileset-3d/common/tile-3d-contracts.ts"],"names":[],"mappings":"AAIA,wFAAwF;AACxF,MAAM,MAAM,oBAAoB,GAAG;IACjC,iBAAiB,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;IAC3C,cAAc,CAAC,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;CACzC,CAAC;AAEF,sEAAsE;AACtE,MAAM,MAAM,aAAa,GAAG;IAC1B,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,OAAO,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzC,6DAA6D;IAC7D,cAAc,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC5C,2DAA2D;IAC3D,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,qDAAqD;IACrD,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,2EAA2E;AAC3E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,yCAAyC;IACzC,MAAM,EAAE,WAAW,GAAG,gBAAgB,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;IAC7E,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,UAAU,CAAC;IAChD,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;AAEF,oEAAoE;AACpE,MAAM,MAAM,qBAAqB,GAAG;IAClC,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzC,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACvC,4EAA4E;IAC5E,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;IACrD,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACtC,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzC,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1C,CAAC;AAEF,2EAA2E;AAC3E,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,kBAAkB,EAAE,CA6C7E"}

package/dist/tileset-3d/common/tile-3d-contracts.js

@@ -0,0 +1,51 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/** Extracts mesh-feature declarations from a decoded glTF-like payload. */
+export function getTile3DFeatureIdSets(payload) {
+    const featureIdSets = [];
+    const visited = new Set();
+    const visit = (value) => {
+        if (!value || typeof value !== 'object') {
+            return;
+        }
+        if (visited.has(value)) {
+            return;
+        }
+        visited.add(value);
+        const record = value;
+        const declarations = record.extensions?.EXT_mesh_features?.featureIds;
+        if (Array.isArray(declarations)) {
+            for (const declaration of declarations) {
+                if (!declaration || typeof declaration !== 'object') {
+                    continue;
+                }
+                const source = declaration.texture
+                    ? 'texture'
+                    : declaration.implicit
+                        ? 'implicit'
+                        : declaration.attribute !== undefined
+                            ? 'attribute'
+                            : declaration.propertyTable !== undefined
+                                ? 'property-table'
+                                : 'constant';
+                featureIdSets.push({
+                    source,
+                    attribute: declaration.attribute,
+                    propertyTable: declaration.propertyTable,
+                    constant: declaration.constant,
+                    texture: declaration.texture,
+                    implicit: declaration.implicit,
+                    values: declaration.values,
+                    details: declaration
+                });
+            }
+        }
+        for (const child of Object.values(record)) {
+            visit(child);
+        }
+    };
+    visit(payload);
+    return featureIdSets;
+}
+//# sourceMappingURL=tile-3d-contracts.js.map

package/dist/tileset-3d/common/tile-3d-contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tile-3d-contracts.js","sourceRoot":"","sources":["../../../src/tileset-3d/common/tile-3d-contracts.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAkEpC,2EAA2E;AAC3E,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,MAAM,aAAa,GAAyB,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,KAAK,GAAG,CAAC,KAAc,EAAQ,EAAE;QACrC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACxC,OAAO;QACT,CAAC;QACD,IAAI,OAAO,CAAC,GAAG,CAAC,KAAe,CAAC,EAAE,CAAC;YACjC,OAAO;QACT,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,KAAe,CAAC,CAAC;QAC7B,MAAM,MAAM,GAAG,KAA4B,CAAC;QAC5C,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,EAAE,iBAAiB,EAAE,UAAU,CAAC;QACtE,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;YAChC,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;gBACvC,IAAI,CAAC,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;oBACpD,SAAS;gBACX,CAAC;gBACD,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO;oBAChC,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC,WAAW,CAAC,QAAQ;wBACpB,CAAC,CAAC,UAAU;wBACZ,CAAC,CAAC,WAAW,CAAC,SAAS,KAAK,SAAS;4BACnC,CAAC,CAAC,WAAW;4BACb,CAAC,CAAC,WAAW,CAAC,aAAa,KAAK,SAAS;gCACvC,CAAC,CAAC,gBAAgB;gCAClB,CAAC,CAAC,UAAU,CAAC;gBACrB,aAAa,CAAC,IAAI,CAAC;oBACjB,MAAM;oBACN,SAAS,EAAE,WAAW,CAAC,SAAS;oBAChC,aAAa,EAAE,WAAW,CAAC,aAAa;oBACxC,QAAQ,EAAE,WAAW,CAAC,QAAQ;oBAC9B,OAAO,EAAE,WAAW,CAAC,OAAO;oBAC5B,QAAQ,EAAE,WAAW,CAAC,QAAQ;oBAC9B,MAAM,EAAE,WAAW,CAAC,MAAM;oBAC1B,OAAO,EAAE,WAAW;iBACrB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1C,KAAK,CAAC,KAAK,CAAC,CAAC;QACf,CAAC;IACH,CAAC,CAAC;IACF,KAAK,CAAC,OAAO,CAAC,CAAC;IACf,OAAO,aAAa,CAAC;AACvB,CAAC"}