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

package/dist/point-cloud/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/point-cloud/types.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC"}

package/dist/raster-set.d.ts

@@ -0,0 +1,124 @@
+import type { GetRasterParameters, NumericRasterData, RasterData, RasterSource, RasterSourceMetadata } from '@loaders.gl/loader-utils';
+/** Accepted raster request currently retained by {@link RasterSet}. */
+export type RasterSetRequest<DataT extends NumericRasterData = RasterData, ParametersT extends object = GetRasterParameters> = {
+    /** Unique request id assigned by the manager. */
+    requestId: number;
+    /** Raster request parameters that produced the accepted raster payload. */
+    parameters: ParametersT;
+    /** Raster retained as the current output. */
+    raster: DataT;
+};
+/** Arguments supplied to {@link RasterSetBaseProps.shouldRefetch}. */
+export type RasterSetShouldRefetchArgs<DataT extends NumericRasterData = RasterData, ParametersT extends object = GetRasterParameters, MetadataT extends RasterSourceMetadata = RasterSourceMetadata> = {
+    /** Current accepted request retained by the raster manager, if any. */
+    currentRequest: RasterSetRequest<DataT, ParametersT> | null;
+    /** Source metadata resolved by {@link RasterSet.loadMetadata}, if available. */
+    metadata: MetadataT | null;
+    /** Candidate raster request parameters under evaluation. */
+    nextParameters: ParametersT;
+};
+/** Configuration shared by all {@link RasterSet} instances. */
+export type RasterSetBaseProps<DataT extends NumericRasterData = RasterData, ParametersT extends object = GetRasterParameters, MetadataT extends RasterSourceMetadata = RasterSourceMetadata> = {
+    /** Callback used to load source metadata. */
+    getMetadata: (options?: {
+        /** Metadata request cancellation. */ signal?: AbortSignal;
+    }) => Promise<MetadataT>;
+    /** Callback used to load raster data for a viewport-derived request. */
+    getRaster: (parameters: ParametersT) => Promise<DataT>;
+    /** Debounce interval applied before issuing raster requests. */
+    debounceTime?: number;
+    /** Optional policy callback that can skip redundant raster requests. */
+    shouldRefetch?: (args: RasterSetShouldRefetchArgs<DataT, ParametersT, MetadataT>) => boolean;
+};
+/** Options for creating a {@link RasterSet}. */
+export type RasterSetProps<DataT extends NumericRasterData = RasterData, ParametersT extends object = GetRasterParameters, MetadataT extends RasterSourceMetadata = RasterSourceMetadata> = Partial<RasterSetBaseProps<DataT, ParametersT, MetadataT>> & {
+    /** Optional loaders.gl raster source backing this manager. */
+    rasterSource?: RasterSource<DataT, ParametersT & GetRasterParameters, MetadataT> | null;
+};
+/** Subscription callbacks emitted by {@link RasterSet}. */
+export type RasterSetListener<DataT extends NumericRasterData = RasterData, ParametersT extends object = GetRasterParameters, MetadataT extends RasterSourceMetadata = RasterSourceMetadata> = {
+    /** Fired when metadata/raster loading starts or stops. */
+    onLoadingStateChange?: (isLoading: boolean) => void;
+    /** Fired when source metadata resolves successfully. */
+    onMetadataLoad?: (metadata: MetadataT) => void;
+    /** Fired when metadata loading fails. */
+    onMetadataLoadError?: (error: Error) => void;
+    /** Fired when a new raster request is issued. */
+    onRasterLoadStart?: (requestId: number, parameters: ParametersT) => void;
+    /** Fired when a raster request resolves and becomes current. */
+    onRasterLoad?: (request: RasterSetRequest<DataT, ParametersT>) => void;
+    /** Fired when a raster request fails. */
+    onRasterLoadError?: (requestId: number, error: Error, parameters: ParametersT) => void;
+    /** Fired when metadata or the current raster changes. */
+    onUpdate?: () => void;
+};
+/**
+ * Shared raster request manager used by viewport-driven raster examples and layers.
+ *
+ * @typeParam DataT Raster payload retained by the manager.
+ * @typeParam ParametersT Request parameters accepted by the source.
+ * @typeParam MetadataT Metadata returned by the source.
+ */
+export declare class RasterSet<DataT extends NumericRasterData = RasterData, ParametersT extends object = GetRasterParameters, MetadataT extends RasterSourceMetadata = RasterSourceMetadata> {
+    /** Cached metadata returned by the backing source, if any. */
+    metadata: MetadataT | null;
+    private _opts;
+    private _listeners;
+    private _currentRequest;
+    private _nextRequestId;
+    private _loadCounter;
+    private _timeoutId;
+    private _abortController;
+    /** Controller owned by the newest metadata request. */
+    private _metadataAbortController;
+    private _finalized;
+    /** Generation invalidates metadata from replaced sources. */
+    private _sourceGeneration;
+    /** Monotonic metadata request identity. */
+    private _metadataRequestId;
+    /** Creates a raster manager from a source or direct callbacks. */
+    constructor(opts: RasterSetProps<DataT, ParametersT, MetadataT>);
+    /** Convenience factory for wrapping a loaders.gl {@link RasterSource}. */
+    static fromRasterSource<DataT extends NumericRasterData = RasterData, ParametersT extends GetRasterParameters = GetRasterParameters, MetadataT extends RasterSourceMetadata = RasterSourceMetadata>(rasterSource: RasterSource<DataT, ParametersT, MetadataT>, opts?: Omit<RasterSetProps<DataT, ParametersT, MetadataT>, 'rasterSource' | 'getRaster' | 'getMetadata'>): RasterSet<DataT, ParametersT, MetadataT>;
+    /** Convenience factory for sources whose requests are not viewport-shaped. */
+    static fromCallbacks<DataT extends NumericRasterData = RasterData, ParametersT extends object = GetRasterParameters, MetadataT extends RasterSourceMetadata = RasterSourceMetadata>(opts: RasterSetBaseProps<DataT, ParametersT, MetadataT>): RasterSet<DataT, ParametersT, MetadataT>;
+    /** Whether the manager has no requests in flight and a current raster. */
+    get isLoaded(): boolean;
+    /** Current accepted raster, if any. */
+    get raster(): DataT | null;
+    /** Current accepted request and raster payload, if any. */
+    get currentRequest(): RasterSetRequest<DataT, ParametersT> | null;
+    /** Backing raster source when constructed from one. */
+    get rasterSource(): RasterSource<DataT, ParametersT & GetRasterParameters, MetadataT> | null;
+    /** Subscribes to metadata and raster lifecycle events. */
+    subscribe(listener: RasterSetListener<DataT, ParametersT, MetadataT>): () => void;
+    /** Updates source callbacks or debounce settings, resetting state when the source changes. */
+    setOptions(opts: RasterSetProps<DataT, ParametersT, MetadataT>): void;
+    /** Loads metadata from the current raster source or callbacks. */
+    loadMetadata(options?: {
+        signal?: AbortSignal;
+    }): Promise<MetadataT>;
+    /** Debounces and issues a new raster request for the supplied parameters. */
+    requestRaster(parameters: ParametersT, debounceTime?: number): number;
+    /** Returns `true` when the supplied parameters warrant a new raster fetch. */
+    shouldRefetchRaster(parameters: ParametersT): boolean;
+    /** Clears timers and listeners held by the manager. */
+    finalize(): void;
+    /** Loads a raster immediately and accepts it only if it is the newest completed request. */
+    private _loadRaster;
+    /** Resolves current options from either a source or direct callbacks. */
+    private _normalizeOptions;
+    /** Emits one generic update notification to all subscribers. */
+    private _emitUpdate;
+    /** Emits one loading-state transition to all subscribers. */
+    private _emitLoadingStateChange;
+    /** Increments the active load count and emits loading-state transitions. */
+    private _startLoading;
+    /** Decrements the active load count and emits loading-state transitions. */
+    private _finishLoading;
+    /** Clears any pending debounced raster request before it hits the network. */
+    private _cancelScheduledRaster;
+    /** Aborts the currently active raster request, if one exists. */
+    private _abortActiveRequest;
+}
+//# sourceMappingURL=raster-set.d.ts.map

package/dist/raster-set.d.ts.map

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

package/dist/raster-set.js

@@ -0,0 +1,348 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+import { waitForPromiseWithSignals } from '@loaders.gl/loader-utils';
+const DEFAULT_RASTERSET_PROPS = {
+    getMetadata: async () => ({
+        width: 0,
+        height: 0,
+        bandCount: 0,
+        dtype: 'uint8'
+    }),
+    getRaster: async () => ({
+        data: new Uint8Array(0),
+        width: 0,
+        height: 0,
+        bandCount: 0,
+        dtype: 'uint8'
+    }),
+    debounceTime: 0,
+    shouldRefetch: () => true
+};
+/**
+ * Shared raster request manager used by viewport-driven raster examples and layers.
+ *
+ * @typeParam DataT Raster payload retained by the manager.
+ * @typeParam ParametersT Request parameters accepted by the source.
+ * @typeParam MetadataT Metadata returned by the source.
+ */
+export class RasterSet {
+    /** Cached metadata returned by the backing source, if any. */
+    metadata = null;
+    _opts;
+    _listeners = new Set();
+    _currentRequest = null;
+    _nextRequestId = 0;
+    _loadCounter = 0;
+    _timeoutId = null;
+    _abortController = null;
+    /** Controller owned by the newest metadata request. */
+    _metadataAbortController = null;
+    _finalized = false;
+    /** Generation invalidates metadata from replaced sources. */
+    _sourceGeneration = 0;
+    /** Monotonic metadata request identity. */
+    _metadataRequestId = 0;
+    /** Creates a raster manager from a source or direct callbacks. */
+    constructor(opts) {
+        this._opts = this._normalizeOptions(opts);
+        if (!this._opts.rasterSource && (!opts.getRaster || !opts.getMetadata)) {
+            throw new Error('RasterSet requires either `rasterSource` or both `getRaster` and `getMetadata`.');
+        }
+    }
+    /** Convenience factory for wrapping a loaders.gl {@link RasterSource}. */
+    static fromRasterSource(rasterSource, opts = {}) {
+        return new RasterSet({ ...opts, rasterSource });
+    }
+    /** Convenience factory for sources whose requests are not viewport-shaped. */
+    static fromCallbacks(opts) {
+        return new RasterSet(opts);
+    }
+    /** Whether the manager has no requests in flight and a current raster. */
+    get isLoaded() {
+        return this._loadCounter === 0 && Boolean(this._currentRequest);
+    }
+    /** Current accepted raster, if any. */
+    get raster() {
+        return this._currentRequest?.raster || null;
+    }
+    /** Current accepted request and raster payload, if any. */
+    get currentRequest() {
+        return this._currentRequest;
+    }
+    /** Backing raster source when constructed from one. */
+    get rasterSource() {
+        return this._opts.rasterSource;
+    }
+    /** Subscribes to metadata and raster lifecycle events. */
+    subscribe(listener) {
+        this._listeners.add(listener);
+        return () => this._listeners.delete(listener);
+    }
+    /** Updates source callbacks or debounce settings, resetting state when the source changes. */
+    setOptions(opts) {
+        const previousRasterSource = this._opts.rasterSource;
+        const mergedOptions = { ...this._opts, ...opts };
+        if (opts.rasterSource && opts.rasterSource !== previousRasterSource) {
+            mergedOptions.getRaster = opts.getRaster;
+            mergedOptions.getMetadata = opts.getMetadata;
+        }
+        const nextOptions = this._normalizeOptions(mergedOptions);
+        const sourceChanged = previousRasterSource !== nextOptions.rasterSource ||
+            this._opts.getRaster !== nextOptions.getRaster ||
+            this._opts.getMetadata !== nextOptions.getMetadata;
+        this._opts = nextOptions;
+        if (sourceChanged) {
+            this._cancelScheduledRaster();
+            this._abortActiveRequest();
+            this._metadataAbortController?.abort();
+            this._sourceGeneration++;
+            this.metadata = null;
+            this._currentRequest = null;
+            this._emitUpdate();
+        }
+    }
+    /** Loads metadata from the current raster source or callbacks. */
+    async loadMetadata(options = {}) {
+        if (this._finalized)
+            throw new Error('RasterSet is finalized');
+        options.signal?.throwIfAborted();
+        this._metadataAbortController?.abort();
+        const abortController = new AbortController();
+        this._metadataAbortController = abortController;
+        const abortFromCaller = () => abortController.abort(options.signal?.reason);
+        options.signal?.addEventListener('abort', abortFromCaller, { once: true });
+        const metadataRequestId = ++this._metadataRequestId;
+        const generation = this._sourceGeneration;
+        try {
+            this._startLoading();
+            abortController.signal.throwIfAborted();
+            const metadata = await waitForPromiseWithSignals(signal => this._opts.getMetadata({ signal }), [abortController.signal]);
+            abortController.signal.throwIfAborted();
+            if (this._finalized ||
+                generation !== this._sourceGeneration ||
+                metadataRequestId !== this._metadataRequestId) {
+                return metadata;
+            }
+            this.metadata = metadata;
+            for (const listener of this._listeners) {
+                listener.onMetadataLoad?.(metadata);
+            }
+            this._emitUpdate();
+            return metadata;
+        }
+        catch (error) {
+            if (abortController.signal.aborted)
+                throw abortController.signal.reason;
+            if (isAbortError(error))
+                throw error;
+            const normalizedError = normalizeRasterSetError(error, 'Raster metadata request failed');
+            if (!this._finalized &&
+                generation === this._sourceGeneration &&
+                metadataRequestId === this._metadataRequestId) {
+                for (const listener of this._listeners) {
+                    listener.onMetadataLoadError?.(normalizedError);
+                }
+            }
+            throw normalizedError;
+        }
+        finally {
+            options.signal?.removeEventListener('abort', abortFromCaller);
+            if (this._metadataAbortController === abortController)
+                this._metadataAbortController = null;
+            this._finishLoading();
+        }
+    }
+    /** Debounces and issues a new raster request for the supplied parameters. */
+    requestRaster(parameters, debounceTime = this._opts.debounceTime) {
+        if (this._finalized)
+            return -1;
+        if (!this.shouldRefetchRaster(parameters)) {
+            this._cancelScheduledRaster();
+            this._abortActiveRequest();
+            this._nextRequestId++;
+            return this._currentRequest?.requestId ?? -1;
+        }
+        const requestId = this._nextRequestId++;
+        this._cancelScheduledRaster();
+        this._abortActiveRequest();
+        if (debounceTime > 0) {
+            this._timeoutId = setTimeout(() => {
+                this._timeoutId = null;
+                void this._loadRaster(requestId, parameters);
+            }, debounceTime);
+        }
+        else {
+            void this._loadRaster(requestId, parameters);
+        }
+        return requestId;
+    }
+    /** Returns `true` when the supplied parameters warrant a new raster fetch. */
+    shouldRefetchRaster(parameters) {
+        return this._opts.shouldRefetch({
+            currentRequest: this._currentRequest,
+            metadata: this.metadata,
+            nextParameters: parameters
+        });
+    }
+    /** Clears timers and listeners held by the manager. */
+    finalize() {
+        this._finalized = true;
+        this._cancelScheduledRaster();
+        this._abortActiveRequest();
+        this._metadataAbortController?.abort();
+        this._metadataAbortController = null;
+        this._loadCounter = 0;
+        this._listeners.clear();
+    }
+    /** Loads a raster immediately and accepts it only if it is the newest completed request. */
+    async _loadRaster(requestId, parameters) {
+        if (this._finalized) {
+            return;
+        }
+        const callerSignal = parameters.signal;
+        if (callerSignal?.aborted)
+            return;
+        const abortController = new AbortController();
+        this._abortController = abortController;
+        const abortFromCaller = () => abortController.abort(callerSignal?.reason);
+        callerSignal?.addEventListener('abort', abortFromCaller, { once: true });
+        this._startLoading();
+        try {
+            abortController.signal.throwIfAborted();
+            for (const listener of this._listeners)
+                listener.onRasterLoadStart?.(requestId, parameters);
+            abortController.signal.throwIfAborted();
+            const raster = await waitForPromiseWithSignals(signal => this._opts.getRaster(withAbortSignal(parameters, signal)), [abortController.signal]);
+            if (this._finalized ||
+                abortController.signal.aborted ||
+                requestId !== this._nextRequestId - 1) {
+                return;
+            }
+            this._currentRequest = { requestId, parameters, raster };
+            for (const listener of this._listeners) {
+                listener.onRasterLoad?.(this._currentRequest);
+            }
+            this._emitUpdate();
+        }
+        catch (error) {
+            if (abortController.signal.aborted || isAbortError(error)) {
+                return;
+            }
+            const normalizedError = normalizeRasterSetError(error, 'Raster request failed');
+            if (!this._finalized && requestId === this._nextRequestId - 1) {
+                for (const listener of this._listeners) {
+                    listener.onRasterLoadError?.(requestId, normalizedError, parameters);
+                }
+            }
+        }
+        finally {
+            callerSignal?.removeEventListener('abort', abortFromCaller);
+            if (this._abortController === abortController)
+                this._abortController = null;
+            this._finishLoading();
+        }
+    }
+    /** Resolves current options from either a source or direct callbacks. */
+    _normalizeOptions(opts) {
+        const rasterSource = opts.rasterSource || null;
+        return {
+            ...DEFAULT_RASTERSET_PROPS,
+            ...opts,
+            rasterSource,
+            getMetadata: opts.getMetadata ||
+                (options => {
+                    if (rasterSource) {
+                        return rasterSource.getMetadata(options);
+                    }
+                    return DEFAULT_RASTERSET_PROPS.getMetadata();
+                }),
+            getRaster: opts.getRaster ||
+                ((parameters) => {
+                    if (rasterSource) {
+                        return rasterSource.getRaster(parameters);
+                    }
+                    return DEFAULT_RASTERSET_PROPS.getRaster(parameters);
+                }),
+            debounceTime: opts.debounceTime ?? DEFAULT_RASTERSET_PROPS.debounceTime,
+            shouldRefetch: opts.shouldRefetch ||
+                ((args) => DEFAULT_RASTERSET_PROPS.shouldRefetch(args))
+        };
+    }
+    /** Emits one generic update notification to all subscribers. */
+    _emitUpdate() {
+        if (this._finalized)
+            return;
+        for (const listener of this._listeners) {
+            listener.onUpdate?.();
+        }
+    }
+    /** Emits one loading-state transition to all subscribers. */
+    _emitLoadingStateChange(isLoading) {
+        if (this._finalized)
+            return;
+        for (const listener of this._listeners) {
+            listener.onLoadingStateChange?.(isLoading);
+        }
+    }
+    /** Increments the active load count and emits loading-state transitions. */
+    _startLoading() {
+        const wasLoading = this._loadCounter > 0;
+        this._loadCounter++;
+        if (!wasLoading) {
+            this._emitLoadingStateChange(true);
+            this._emitUpdate();
+        }
+    }
+    /** Decrements the active load count and emits loading-state transitions. */
+    _finishLoading() {
+        const wasLoading = this._loadCounter > 0;
+        this._loadCounter = Math.max(0, this._loadCounter - 1);
+        if (wasLoading && this._loadCounter === 0) {
+            this._emitLoadingStateChange(false);
+            this._emitUpdate();
+        }
+    }
+    /** Clears any pending debounced raster request before it hits the network. */
+    _cancelScheduledRaster() {
+        if (this._timeoutId !== null) {
+            clearTimeout(this._timeoutId);
+            this._timeoutId = null;
+        }
+    }
+    /** Aborts the currently active raster request, if one exists. */
+    _abortActiveRequest() {
+        this._abortController?.abort();
+        this._abortController = null;
+    }
+}
+/** Adds cancellation to a request while preserving its array/prototype shape. */
+function withAbortSignal(parameters, signal) {
+    const descriptors = Object.getOwnPropertyDescriptors(parameters);
+    delete descriptors.signal;
+    const request = Array.isArray(parameters)
+        ? Object.defineProperties(parameters.slice(), descriptors)
+        : Object.create(Object.getPrototypeOf(parameters), descriptors);
+    Object.defineProperty(request, 'signal', {
+        configurable: true,
+        enumerable: true,
+        value: signal,
+        writable: true
+    });
+    return request;
+}
+/** Normalizes arbitrary thrown values to `Error` instances for raster-set callbacks. */
+function normalizeRasterSetError(error, message) {
+    if (error instanceof Error) {
+        return error;
+    }
+    if (typeof error === 'string') {
+        return new Error(error);
+    }
+    return new Error(message);
+}
+/** Returns true when an error came from an aborted request. */
+function isAbortError(error) {
+    return error instanceof Error && error.name === 'AbortError';
+}
+//# sourceMappingURL=raster-set.js.map

package/dist/raster-set.js.map

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

package/dist/spatial/format-spatial-reference.d.ts

@@ -0,0 +1,68 @@
+import type { ReadonlyCRSDefinition } from '@math.gl/crs';
+import type { TilesetSpatialReference } from "./spatial-types.js";
+/** ArcGIS/I3S spatial reference fields used without depending on the I3S package. */
+type I3SSpatialReferenceLike = {
+    wkid?: number;
+    latestWkid?: number;
+    vcsWkid?: number;
+    latestVcsWkid?: number;
+    wkt?: string;
+};
+/** I3S layer fields needed for spatial metadata discovery. */
+type I3SLayerLike = {
+    spatialReference?: I3SSpatialReferenceLike;
+    fullExtent?: {
+        spatialReference?: I3SSpatialReferenceLike;
+    };
+    heightModelInfo?: {
+        heightModel?: string;
+        vertCRS?: ReadonlyCRSDefinition;
+        heightUnit?: string;
+    };
+    ZFactor?: number;
+    elevationInfo?: {
+        mode?: string;
+        offset?: number;
+        unit?: string;
+    };
+};
+/** 3D Tiles document fields needed for CRS semantic discovery. */
+type Tiles3DLike = {
+    schema?: {
+        classes?: Record<string, unknown>;
+    };
+    schemaUri?: string;
+    metadata?: {
+        class?: string;
+        properties?: Record<string, unknown>;
+    };
+    root?: {
+        boundingVolume?: {
+            region?: unknown;
+        };
+    };
+    extensions?: Record<string, unknown>;
+};
+/**
+ * Discovers normalized spatial metadata from an I3S scene-layer document.
+ *
+ * I3S encodes geographic coordinates in longitude/latitude wire order even for authority
+ * definitions whose formal axis order differs.
+ *
+ * @param layer - Parsed I3S layer document.
+ * @returns Normalized source spatial metadata.
+ */
+export declare function getI3SSpatialReference(layer: I3SLayerLike): TilesetSpatialReference;
+/**
+ * Discovers the 3D Tiles geocentric CRS and coordinate epoch from structured metadata semantics.
+ *
+ * The method intentionally does not infer ECEF from coordinate magnitude. A root `region`
+ * establishes the format's global ellipsoidal frame, while local tilesets without an explicit
+ * semantic remain unknown.
+ *
+ * @param tileset - Parsed 3D Tiles tileset document.
+ * @returns Normalized source spatial metadata.
+ */
+export declare function get3DTilesSpatialReference(tileset: Tiles3DLike): TilesetSpatialReference;
+export {};
+//# sourceMappingURL=format-spatial-reference.d.ts.map

package/dist/spatial/format-spatial-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-spatial-reference.d.ts","sourceRoot":"","sources":["../../src/spatial/format-spatial-reference.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,cAAc,CAAC;AAOxD,OAAO,KAAK,EAAuB,uBAAuB,EAAC,2BAAwB;AAEnF,qFAAqF;AACrF,KAAK,uBAAuB,GAAG;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,8DAA8D;AAC9D,KAAK,YAAY,GAAG;IAClB,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;IAC3C,UAAU,CAAC,EAAE;QAAC,gBAAgB,CAAC,EAAE,uBAAuB,CAAA;KAAC,CAAC;IAC1D,eAAe,CAAC,EAAE;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,qBAAqB,CAAC;QAChC,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAC,CAAC;CACjE,CAAC;AAKF,kEAAkE;AAClE,KAAK,WAAW,GAAG;IACjB,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAC,CAAC;IAClE,IAAI,CAAC,EAAE;QAAC,cAAc,CAAC,EAAE;YAAC,MAAM,CAAC,EAAE,OAAO,CAAA;SAAC,CAAA;KAAC,CAAC;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,GAAG,uBAAuB,CAqEnF;AA8BD;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,WAAW,GAAG,uBAAuB,CA8CxF"}