@deck.gl-community/geo-layers 9.2.8 → 9.3.0-beta.2

package/dist/tileset/index.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/tileset/index.ts", "../../src/tileset/tileset-2d.ts", "../../src/tileset/tile-2d-header.ts"],
+  "sourcesContent": ["// deck.gl-community\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\nexport type {\n  TileLoadProps,\n  Bounds,\n  ZRange,\n  GeoBoundingBox,\n  NonGeoBoundingBox,\n  TileBoundingBox\n} from './types';\nexport type {\n  SharedTileset2DAdapter,\n  SharedTileset2DTraversalContext,\n  SharedTileset2DTileContext\n} from './adapter';\nexport type {RefinementStrategy, Tileset2DProps as SharedTileset2DBaseProps} from './tileset-2d';\nexport {STRATEGY_DEFAULT, STRATEGY_NEVER, STRATEGY_REPLACE} from './tileset-2d';\nexport type {SharedTileset2DProps} from './tileset-2d';\nexport {SharedTileset2D} from './tileset-2d';\nexport {SharedTile2DHeader} from './tile-2d-header';\n", "// deck.gl-community\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\nimport {RequestScheduler, type TileSource, type TileSourceMetadata} from '@loaders.gl/loader-utils';\nimport type {Matrix4} from '@math.gl/core';\nimport {Stats} from '@probe.gl/stats';\nimport {SharedTile2DHeader} from './tile-2d-header';\nimport type {SharedTileset2DAdapter, SharedTileset2DTileContext} from './adapter';\nimport type {TileIndex, TileLoadProps, ZRange} from './types';\n\nexport const STRATEGY_NEVER = 'never';\nexport const STRATEGY_REPLACE = 'no-overlap';\nexport const STRATEGY_DEFAULT = 'best-available';\n\n/** Function form of a refinement strategy. */\nexport type RefinementStrategyFunction = (tiles: SharedTile2DHeader[]) => void;\n/** Strategy controlling how parent and child placeholder tiles are displayed while content loads. */\nexport type RefinementStrategy =\n  | typeof STRATEGY_NEVER\n  | typeof STRATEGY_REPLACE\n  | typeof STRATEGY_DEFAULT\n  | RefinementStrategyFunction;\n\n/** Core configuration shared by all {@link SharedTileset2D} instances. */\nexport type Tileset2DProps<DataT = any, ViewStateT = unknown> = {\n  /** Callback used to load tile payloads. */\n  getTileData: (props: TileLoadProps) => Promise<DataT | null> | DataT | null;\n  /** Adapter used to compute tile traversal and tile metadata. */\n  adapter?: SharedTileset2DAdapter<ViewStateT> | null;\n  /** Bounding box limiting tile generation. */\n  extent?: number[] | null;\n  /** Tile size in pixels. */\n  tileSize?: number;\n  /** Maximum zoom level to request. */\n  maxZoom?: number | null;\n  /** Minimum zoom level to request. */\n  minZoom?: number | null;\n  /** Maximum number of tiles kept in cache. */\n  maxCacheSize?: number | null;\n  /** Maximum bytes kept in cache. */\n  maxCacheByteSize?: number | null;\n  /** Placeholder refinement strategy. */\n  refinementStrategy?: RefinementStrategy;\n  /** Elevation range used by geospatial tile selection. */\n  zRange?: ZRange | null;\n  /** Maximum concurrent tile requests. */\n  maxRequests?: number;\n  /** Debounce interval applied before issuing queued requests. */\n  debounceTime?: number;\n  /** Integer zoom offset applied when choosing tile levels. */\n  zoomOffset?: number;\n  /** Callback fired when a tile loads successfully. */\n  onTileLoad?: (tile: SharedTile2DHeader<DataT>) => void;\n  /** Callback fired when a tile is evicted from cache. */\n  onTileUnload?: (tile: SharedTile2DHeader<DataT>) => void;\n  /** Callback fired when a tile request fails. */\n  onTileError?: (err: any, tile: SharedTile2DHeader<DataT>) => void;\n};\n\nexport const DEFAULT_TILESET2D_PROPS: Omit<Required<Tileset2DProps>, 'getTileData'> = {\n  adapter: null,\n  extent: null,\n  tileSize: 512,\n  maxZoom: null,\n  minZoom: null,\n  maxCacheSize: 100,\n  maxCacheByteSize: null,\n  refinementStrategy: 'best-available',\n  zRange: null,\n  maxRequests: 6,\n  debounceTime: 0,\n  zoomOffset: 0,\n  onTileLoad: () => {},\n  onTileUnload: () => {},\n  onTileError: () => {}\n};\n\n/** Subscription callbacks emitted by {@link SharedTileset2D}. */\ntype Tile2DListener<DataT = any> = {\n  /** Fired after a tile loads successfully. */\n  onTileLoad?: (tile: SharedTile2DHeader<DataT>) => void;\n  /** Fired after a tile request fails. */\n  onTileError?: (error: any, tile: SharedTile2DHeader<DataT>) => void;\n  /** Fired after a tile is evicted from cache. */\n  onTileUnload?: (tile: SharedTile2DHeader<DataT>) => void;\n  /** Fired when metadata or effective configuration changes. */\n  onUpdate?: () => void;\n  /** Fired when asynchronous metadata initialization fails. */\n  onError?: (error: Error) => void;\n  /** Fired after live tileset counters are recomputed. */\n  onStatsChange?: (stats: Stats) => void;\n};\n\n/** Per-consumer tile sets retained by the shared cache. */\ntype ConsumerState<DataT = any> = {\n  /** Tiles selected for this consumer's most recent traversal. */\n  selectedTiles: Set<SharedTile2DHeader<DataT>>;\n  /** Tiles currently marked render-visible for this consumer. */\n  visibleTiles: Set<SharedTile2DHeader<DataT>>;\n};\n\n/** Options for creating a shared tile cache that can be reused by multiple layers and views. */\nexport type SharedTileset2DProps<DataT = any, ViewStateT = unknown> = Omit<\n  Tileset2DProps<DataT, ViewStateT>,\n  'getTileData'\n> & {\n  /** Optional tile loader used when not sourcing data from a loaders.gl TileSource. */\n  getTileData?: (props: TileLoadProps) => Promise<DataT | null> | DataT | null;\n  /** Optional loaders.gl TileSource backing this shared tileset. */\n  tileSource?: TileSource;\n};\n\n/** Shared tile cache and loading engine for one or more {@link SharedTile2DLayer} instances. */\nexport class SharedTileset2D<DataT = any, ViewStateT = unknown> {\n  /** Live counters describing shared tileset state. */\n  readonly stats: Stats;\n  /** Effective runtime options after defaults and metadata overrides have been applied. */\n  protected opts: Required<SharedTileset2DProps<DataT, ViewStateT>>;\n  /** Cached metadata returned by the backing TileSource, if any. */\n  protected sourceMetadata: TileSourceMetadata | null = null;\n  /** Scheduler shared across all tile requests for this tileset. */\n  private _requestScheduler: RequestScheduler;\n  /** Shared tile cache keyed by tile id. */\n  private _cache: Map<string, SharedTile2DHeader<DataT>>;\n  /** Tracks whether parent/child links need rebuilding. */\n  private _dirty: boolean;\n  /** Cached tiles sorted by zoom for traversal and rendering. */\n  private _tiles: SharedTile2DHeader<DataT>[];\n  /** Running total of cached payload byte size. */\n  private _cacheByteSize: number;\n  /** Cumulative number of tiles evicted from the shared cache. */\n  private _unloadedTileCount: number;\n  /** Subscribers watching tileset lifecycle events. */\n  private _listeners = new Set<Tile2DListener<DataT>>();\n  /** Selected and visible tiles tracked per consumer. */\n  private _consumers = new Map<symbol, ConsumerState<DataT>>();\n  /** Option names explicitly set by the caller. */\n  private _explicitOptionKeys = new Set<string>();\n  /** Caller-provided options before metadata-derived overrides are applied. */\n  private _baseOpts: Partial<SharedTileset2DProps<DataT, ViewStateT>> = {};\n  /** Derived overrides sourced from TileSource metadata. */\n  private _sourceMetadataOverrides: Partial<SharedTileset2DProps<DataT, ViewStateT>> = {};\n  /** Resolved maximum zoom level used by traversal. */\n  private _maxZoom?: number;\n  /** Resolved minimum zoom level used by traversal. */\n  private _minZoom?: number;\n  /** Most recent traversal context used to derive tile metadata. */\n  private _lastTileContext: SharedTileset2DTileContext<ViewStateT> | null = null;\n\n  /** Creates a tileset from either `getTileData` or a loaders.gl `TileSource`. */\n  constructor(opts: SharedTileset2DProps<DataT, ViewStateT>) {\n    this.stats = new Stats({\n      id: 'SharedTileset2D',\n      stats: [\n        {name: 'Tiles In Cache'},\n        {name: 'Cache Size'},\n        {name: 'Visible Tiles'},\n        {name: 'Selected Tiles'},\n        {name: 'Loading Tiles'},\n        {name: 'Unloaded Tiles'},\n        {name: 'Consumers'}\n      ]\n    });\n    this.opts = {\n      ...DEFAULT_TILESET2D_PROPS,\n      ...opts,\n      getTileData: opts.getTileData || (() => null),\n      tileSource: opts.tileSource\n    } as Required<SharedTileset2DProps<DataT, ViewStateT>>;\n\n    this._requestScheduler = new RequestScheduler({\n      throttleRequests: this.opts.maxRequests > 0 || this.opts.debounceTime > 0,\n      maxRequests: this.opts.maxRequests,\n      debounceTime: this.opts.debounceTime\n    });\n\n    this._cache = new Map();\n    this._tiles = [];\n    this._dirty = false;\n    this._cacheByteSize = 0;\n    this._unloadedTileCount = 0;\n\n    if (!this.opts.tileSource && !opts.getTileData) {\n      throw new Error('SharedTileset2D requires either `getTileData` or `tileSource`.');\n    }\n\n    this.setOptions(opts);\n    this._updateStats();\n\n    if (this.opts.tileSource) {\n      this._initializeTileSource(this.opts.tileSource).catch(() => {});\n    }\n  }\n\n  /** Convenience factory for wrapping a loaders.gl `TileSource`. */\n  static fromTileSource<DataT = any>(\n    tileSource: TileSource,\n    opts: Omit<SharedTileset2DProps<DataT>, 'tileSource' | 'getTileData'> = {}\n  ): SharedTileset2D<DataT> {\n    return new SharedTileset2D<DataT>({...opts, tileSource});\n  }\n\n  /** All tiles currently present in the shared cache. */\n  get tiles(): SharedTile2DHeader<DataT>[] {\n    return this._tiles;\n  }\n\n  /** Estimated byte size of all tile content currently retained in cache. */\n  get cacheByteSize(): number {\n    return this._cacheByteSize;\n  }\n\n  /** Union of tiles selected by all attached consumers. */\n  get selectedTiles(): SharedTile2DHeader<DataT>[] {\n    return Array.from(this._getSelectedTilesUnion());\n  }\n\n  /** Union of tiles contributing to the visible result across all consumers and views, including unloaded selected tiles. */\n  get visibleTiles(): SharedTile2DHeader<DataT>[] {\n    const union = this._getVisibleTilesUnion();\n    for (const tile of this._getSelectedTilesUnion()) {\n      union.add(tile);\n    }\n    return Array.from(union);\n  }\n\n  /** Tiles currently loading anywhere in the shared cache. */\n  get loadingTiles(): SharedTile2DHeader<DataT>[] {\n    return Array.from(this._cache.values()).filter((tile) => tile.isLoading);\n  }\n\n  /** Tiles retained in cache that do not currently have loaded content. */\n  get unloadedTiles(): SharedTile2DHeader<DataT>[] {\n    return Array.from(this._cache.values()).filter((tile) => !tile.isLoaded);\n  }\n\n  /** Maximum resolved zoom level after applying metadata and explicit options. */\n  get maxZoom(): number | undefined {\n    return this._maxZoom;\n  }\n\n  /** Minimum resolved zoom level after applying metadata and explicit options. */\n  get minZoom(): number | undefined {\n    return this._minZoom;\n  }\n\n  /** Active refinement strategy for placeholder handling. */\n  get refinementStrategy(): RefinementStrategy {\n    return this.opts.refinementStrategy || STRATEGY_DEFAULT;\n  }\n\n  /** Adapter currently used for traversal and tile metadata. */\n  get adapter(): SharedTileset2DAdapter<ViewStateT> | null {\n    return this.opts.adapter;\n  }\n\n  /** Subscribes to tileset lifecycle events. */\n  subscribe(listener: Tile2DListener<DataT>): () => void {\n    this._listeners.add(listener);\n    return () => this._listeners.delete(listener);\n  }\n\n  /** Registers a consumer so cache pruning can account for its selected tiles. */\n  attachConsumer(id: symbol): void {\n    this._consumers.set(id, {selectedTiles: new Set(), visibleTiles: new Set()});\n    this._updateStats();\n  }\n\n  /** Unregisters a consumer and prunes unused requests and tiles. */\n  detachConsumer(id: symbol): void {\n    this._consumers.delete(id);\n    this._pruneRequests();\n    this._resizeCache();\n    this._updateStats();\n  }\n\n  /** Updates tileset options and reapplies TileSource metadata overrides. */\n  setOptions(opts: Partial<SharedTileset2DProps<DataT, ViewStateT>>): void {\n    this._rememberExplicitOptions(opts);\n    this._baseOpts = {...this._baseOpts, ...opts};\n    this._applyResolvedOptions();\n  }\n\n  /** Aborts in-flight requests and clears the shared cache. */\n  finalize(): void {\n    for (const tile of this._cache.values()) {\n      if (tile.isLoading) {\n        tile.abort();\n      }\n    }\n    this._cache.clear();\n    this._tiles = [];\n    this._consumers.clear();\n    this._cacheByteSize = 0;\n    this._unloadedTileCount = 0;\n    this._updateStats();\n  }\n\n  /** Marks all retained tiles stale and drops unused cached tiles. */\n  reloadAll(): void {\n    const selectedTiles = this._getSelectedTilesUnion();\n    for (const id of this._cache.keys()) {\n      const tile = this._cache.get(id);\n      if (tile && !selectedTiles.has(tile)) {\n        this._cache.delete(id);\n      } else if (tile) {\n        tile.setNeedsReload();\n      }\n    }\n    this._cacheByteSize = this._getCacheByteSize();\n    this.prepareTiles();\n    this._updateStats();\n  }\n\n  /** Updates the selected and visible tile sets for one consumer. */\n  updateConsumer(\n    id: symbol,\n    selectedTiles: SharedTile2DHeader<DataT>[],\n    visibleTiles: SharedTile2DHeader<DataT>[]\n  ): void {\n    this._consumers.set(id, {\n      selectedTiles: new Set(selectedTiles),\n      visibleTiles: new Set(visibleTiles)\n    });\n    this._pruneRequests();\n    this._resizeCache();\n    this._updateStats();\n  }\n\n  /** Rebuilds parent/child links if the cache changed since the last traversal. */\n  prepareTiles(): void {\n    if (this._dirty) {\n      this._rebuildTree();\n      this._syncTiles();\n      this._dirty = false;\n    }\n  }\n\n  /** Returns tile indices needed to cover a viewport. */\n  getTileIndices({\n    viewState,\n    maxZoom,\n    minZoom,\n    zRange,\n    modelMatrix,\n    modelMatrixInverse\n  }: {\n    viewState: ViewStateT;\n    maxZoom?: number;\n    minZoom?: number;\n    zRange: ZRange | null;\n    modelMatrix?: Matrix4 | null;\n    modelMatrixInverse?: Matrix4 | null;\n  }): TileIndex[] {\n    const {adapter, tileSize, extent, zoomOffset} = this.opts;\n    if (!adapter) {\n      throw new Error('SharedTileset2D requires an adapter before tile traversal can be used.');\n    }\n    this._lastTileContext = {viewState, tileSize};\n    return adapter.getTileIndices({\n      viewState,\n      maxZoom,\n      minZoom,\n      zRange,\n      tileSize,\n      extent: normalizeBounds(extent),\n      modelMatrix,\n      modelMatrixInverse,\n      zoomOffset\n    });\n  }\n\n  /** Returns the stable cache id for a tile index. */\n  getTileId(index: TileIndex): string {\n    return `${index.x}-${index.y}-${index.z}`;\n  }\n\n  /** Returns the zoom level represented by a tile index. */\n  getTileZoom(index: TileIndex): number {\n    return index.z;\n  }\n\n  /** Returns derived metadata used to initialize a tile header. */\n  getTileMetadata(index: TileIndex): Record<string, any> {\n    if (!this._lastTileContext) {\n      throw new Error('SharedTileset2D metadata requested before traversal context was set.');\n    }\n    if (!this.opts.adapter) {\n      throw new Error('SharedTileset2D requires an adapter before tile metadata can be derived.');\n    }\n    return {bbox: this.opts.adapter.getTileBoundingBox(this._lastTileContext, index)};\n  }\n\n  /** Returns the parent tile index in the quadtree. */\n  getParentIndex(index: TileIndex): TileIndex {\n    return {x: Math.floor(index.x / 2), y: Math.floor(index.y / 2), z: index.z - 1};\n  }\n\n  /** Returns a cached tile and optionally creates and loads it on demand. */\n  getTile(index: TileIndex, create: true): SharedTile2DHeader<DataT>;\n  getTile(index: TileIndex, create?: false): SharedTile2DHeader<DataT> | undefined;\n  getTile(index: TileIndex, create?: boolean): SharedTile2DHeader<DataT> | undefined {\n    const id = this.getTileId(index);\n    let tile = this._cache.get(id);\n    let needsReload = false;\n\n    if (!tile && create) {\n      tile = new SharedTile2DHeader(index);\n      Object.assign(tile, this.getTileMetadata(tile.index));\n      Object.assign(tile, {id, zoom: this.getTileZoom(tile.index)});\n      needsReload = true;\n      this._cache.set(id, tile);\n      this._dirty = true;\n      this._updateStats();\n    } else if (tile && tile.needsReload) {\n      needsReload = true;\n    }\n\n    if (tile) {\n      this._touchTile(id, tile);\n    }\n\n    if (tile && needsReload) {\n      tile\n        .loadData({\n          getData: this.opts.getTileData,\n          requestScheduler: this._requestScheduler,\n          onLoad: this._handleTileLoad.bind(this),\n          onError: this._handleTileError.bind(this)\n        })\n        .catch(() => {});\n      this._updateStats();\n    }\n\n    return tile;\n  }\n\n  /** Loads metadata from a TileSource and reapplies derived option overrides. */\n  private async _initializeTileSource(tileSource: TileSource): Promise<void> {\n    try {\n      this.sourceMetadata = await tileSource.getMetadata();\n      this._sourceMetadataOverrides = this._getMetadataOverrides(this.sourceMetadata);\n      this._applyResolvedOptions();\n      this._notifyUpdate();\n    } catch (error: any) {\n      const normalizedError =\n        error instanceof Error ? error : new Error(`TileSource metadata error: ${String(error)}`);\n      this._notifyError(normalizedError);\n    }\n  }\n\n  /** Tracks which options were explicitly set by the caller. */\n  private _rememberExplicitOptions(opts: Partial<SharedTileset2DProps<DataT, ViewStateT>>): void {\n    for (const key of Object.keys(opts)) {\n      this._explicitOptionKeys.add(key);\n    }\n  }\n\n  /** Resolves defaults, metadata overrides, and caller options into runtime settings. */\n  private _applyResolvedOptions(): void {\n    const resolvedOpts = {\n      ...DEFAULT_TILESET2D_PROPS,\n      ...this._sourceMetadataOverrides,\n      ...this._baseOpts\n    } as Required<SharedTileset2DProps<DataT, ViewStateT>>;\n\n    if (resolvedOpts.tileSource) {\n      const tileSource = resolvedOpts.tileSource;\n      resolvedOpts.getTileData = (loadProps: TileLoadProps) =>\n        tileSource.getTileData(loadProps) as Promise<DataT | null> | DataT | null;\n    }\n\n    this.opts = resolvedOpts;\n    this._maxZoom =\n      typeof this.opts.maxZoom === 'number' && Number.isFinite(this.opts.maxZoom)\n        ? Math.floor(this.opts.maxZoom)\n        : undefined;\n    this._minZoom =\n      typeof this.opts.minZoom === 'number' && Number.isFinite(this.opts.minZoom)\n        ? Math.ceil(this.opts.minZoom)\n        : undefined;\n  }\n\n  /** Maps TileSource metadata into supported tileset options. */\n  private _getMetadataOverrides(\n    metadata: TileSourceMetadata | null\n  ): Partial<SharedTileset2DProps<DataT, ViewStateT>> {\n    if (!metadata) {\n      return {};\n    }\n    const overrides: Partial<SharedTileset2DProps<DataT, ViewStateT>> = {};\n    if (!this._explicitOptionKeys.has('minZoom') && Number.isFinite(metadata.minZoom)) {\n      overrides.minZoom = metadata.minZoom;\n    }\n    if (!this._explicitOptionKeys.has('maxZoom') && Number.isFinite(metadata.maxZoom)) {\n      overrides.maxZoom = metadata.maxZoom;\n    }\n    if (!this._explicitOptionKeys.has('extent') && metadata.boundingBox) {\n      overrides.extent = [\n        metadata.boundingBox[0][0],\n        metadata.boundingBox[0][1],\n        metadata.boundingBox[1][0],\n        metadata.boundingBox[1][1]\n      ];\n    }\n    return overrides;\n  }\n\n  /** Handles successful tile loads. */\n  private _handleTileLoad(tile: SharedTile2DHeader<DataT>): void {\n    this.opts.onTileLoad?.(tile);\n    this._cacheByteSize = this._getCacheByteSize();\n    this._resizeCache();\n    for (const listener of this._listeners) {\n      listener.onTileLoad?.(tile);\n    }\n    this._updateStats();\n  }\n\n  /** Handles tile load failures. */\n  private _handleTileError(error: any, tile: SharedTile2DHeader<DataT>): void {\n    this.opts.onTileError?.(error, tile);\n    for (const listener of this._listeners) {\n      listener.onTileError?.(error, tile);\n    }\n    this._updateStats();\n  }\n\n  /** Handles tile eviction from cache. */\n  private _handleTileUnload(tile: SharedTile2DHeader<DataT>): void {\n    this._unloadedTileCount++;\n    this.opts.onTileUnload?.(tile);\n    for (const listener of this._listeners) {\n      listener.onTileUnload?.(tile);\n    }\n    this._updateStats();\n  }\n\n  /** Notifies listeners that metadata or effective options changed. */\n  private _notifyUpdate(): void {\n    for (const listener of this._listeners) {\n      listener.onUpdate?.();\n    }\n  }\n\n  /** Notifies listeners about asynchronous metadata errors. */\n  private _notifyError(error: Error): void {\n    for (const listener of this._listeners) {\n      listener.onError?.(error);\n    }\n  }\n\n  /** Recomputes absolute counter stats and notifies listeners. */\n  private _updateStats(): void {\n    this._setStatCount('Tiles In Cache', this._cache.size);\n    this._setStatCount('Cache Size', this.cacheByteSize);\n    this._setStatCount('Visible Tiles', this.visibleTiles.length);\n    this._setStatCount('Selected Tiles', this.selectedTiles.length);\n    this._setStatCount('Loading Tiles', this.loadingTiles.length);\n    this._setStatCount('Unloaded Tiles', this._unloadedTileCount);\n    this._setStatCount('Consumers', this._consumers.size);\n\n    for (const listener of this._listeners) {\n      listener.onStatsChange?.(this.stats);\n    }\n  }\n\n  /** Writes an absolute count into a probe.gl stat. */\n  private _setStatCount(name: string, value: number): void {\n    this.stats.get(name).reset().addCount(value);\n  }\n\n  /** Returns the union of selected tiles across all consumers. */\n  private _getSelectedTilesUnion(): Set<SharedTile2DHeader<DataT>> {\n    const union = new Set<SharedTile2DHeader<DataT>>();\n    for (const consumer of this._consumers.values()) {\n      for (const tile of consumer.selectedTiles) {\n        union.add(tile);\n      }\n    }\n    return union;\n  }\n\n  /** Returns the union of visible tiles across all consumers. */\n  private _getVisibleTilesUnion(): Set<SharedTile2DHeader<DataT>> {\n    const union = new Set<SharedTile2DHeader<DataT>>();\n    for (const consumer of this._consumers.values()) {\n      for (const tile of consumer.visibleTiles) {\n        union.add(tile);\n      }\n    }\n    return union;\n  }\n\n  /** Moves a touched tile to the back of the cache map for LRU eviction ordering. */\n  private _touchTile(id: string, tile: SharedTile2DHeader<DataT>): void {\n    this._cache.delete(id);\n    this._cache.set(id, tile);\n  }\n\n  /** Computes the total byte size of all cached tile content. */\n  private _getCacheByteSize(): number {\n    let byteLength = 0;\n    for (const tile of this._cache.values()) {\n      byteLength += tile.byteLength;\n    }\n    return byteLength;\n  }\n\n  /** Cancels low-priority requests when consumers no longer need them. */\n  private _pruneRequests(): void {\n    const {maxRequests = 0} = this.opts;\n    const selectedTiles = this._getSelectedTilesUnion();\n    const visibleTiles = this._getVisibleTilesUnion();\n    const abortCandidates: SharedTile2DHeader<DataT>[] = [];\n    let ongoingRequestCount = 0;\n\n    for (const tile of this._cache.values()) {\n      if (tile.isLoading) {\n        ongoingRequestCount++;\n        if (!selectedTiles.has(tile) && !visibleTiles.has(tile)) {\n          abortCandidates.push(tile);\n        }\n      }\n    }\n\n    while (maxRequests > 0 && ongoingRequestCount > maxRequests && abortCandidates.length > 0) {\n      const tile = abortCandidates.shift();\n      if (tile) {\n        tile.abort();\n      }\n      ongoingRequestCount--;\n    }\n  }\n\n  /** Rebuilds parent and child links for all cached tiles. */\n  private _rebuildTree(): void {\n    for (const tile of this._cache.values()) {\n      tile.parent = null;\n      if (tile.children) {\n        tile.children.length = 0;\n      }\n    }\n    for (const tile of this._cache.values()) {\n      const parent = this._getNearestAncestor(tile);\n      tile.parent = parent;\n      if (parent?.children) {\n        parent.children.push(tile);\n      }\n    }\n  }\n\n  /** Updates the sorted tile list used by traversal and rendering. */\n  private _syncTiles(): void {\n    this._tiles = Array.from(this._cache.values()).sort((t1, t2) => t1.zoom - t2.zoom);\n  }\n\n  /** Evicts unused cached tiles when configured cache limits are exceeded. */\n  private _resizeCache(): void {\n    const maxCacheSize = this.opts.maxCacheSize ?? 100;\n    const maxCacheByteSize = this.opts.maxCacheByteSize ?? Infinity;\n    const visibleTiles = this._getVisibleTilesUnion();\n    const selectedTiles = this._getSelectedTilesUnion();\n    const overflown = this._cache.size > maxCacheSize || this._cacheByteSize > maxCacheByteSize;\n\n    if (overflown) {\n      for (const [id, tile] of this._cache) {\n        if (!visibleTiles.has(tile) && !selectedTiles.has(tile)) {\n          this._cache.delete(id);\n          this._cacheByteSize = this._getCacheByteSize();\n          this._handleTileUnload(tile);\n        }\n        if (this._cache.size <= maxCacheSize && this._cacheByteSize <= maxCacheByteSize) {\n          break;\n        }\n      }\n      this._dirty = true;\n    }\n\n    if (this._dirty) {\n      this._rebuildTree();\n      this._syncTiles();\n      this._dirty = false;\n    }\n  }\n\n  /** Finds the nearest cached ancestor tile for placeholder rendering. */\n  private _getNearestAncestor(tile: SharedTile2DHeader<DataT>): SharedTile2DHeader<DataT> | null {\n    const {_minZoom = 0} = this;\n    let index = tile.index;\n    while (this.getTileZoom(index) > _minZoom) {\n      index = this.getParentIndex(index);\n      const parent = this.getTile(index);\n      if (parent) {\n        return parent;\n      }\n    }\n    return null;\n  }\n}\n\nfunction normalizeBounds(extent: number[] | null | undefined) {\n  return extent && extent.length === 4 ? (extent as [number, number, number, number]) : undefined;\n}\n", "// deck.gl-community\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\n/* eslint-env browser */\nimport {RequestScheduler} from '@loaders.gl/loader-utils';\nimport type {TileBoundingBox, TileIndex, TileLoadProps} from './types';\n\n/** Parameters used by {@link SharedTile2DHeader.loadData}. */\nexport type Tile2DLoadDataProps<DataT = any> = {\n  /** Shared request scheduler for throttling tile fetches. */\n  requestScheduler: RequestScheduler;\n  /** Application-provided tile data loader. */\n  getData: (props: TileLoadProps) => Promise<DataT | null> | DataT | null;\n  /** Callback fired after tile content resolves successfully. */\n  onLoad: (tile: SharedTile2DHeader<DataT>) => void;\n  /** Callback fired after tile content fails to load. */\n  onError: (error: any, tile: SharedTile2DHeader<DataT>) => void;\n};\n\n/** Shared tile cache entry used by {@link SharedTileset2D}. */\nexport class SharedTile2DHeader<DataT = any> {\n  /** x/y/z tile coordinate. */\n  index: TileIndex;\n  /** Closest cached ancestor tile in the current tree. */\n  parent: SharedTile2DHeader | null;\n  /** Cached child tiles beneath this tile. */\n  children: SharedTile2DHeader[] | null;\n  /** Loaded tile payload. */\n  content: DataT | null;\n\n  /** Stable tile cache id. */\n  id!: string;\n  /** Resolved zoom level for the tile. */\n  zoom!: number;\n  /** Optional application data associated with the tile. */\n  userData?: Record<string, any>;\n  /** Bounds represented as `[[minX, minY], [maxX, maxY]]` for loaders.gl compatibility. */\n  boundingBox!: [min: number[], max: number[]];\n\n  /** Abort controller for the current request, if one exists. */\n  private _abortController: AbortController | null;\n  /** Promise tracking the in-flight tile load, if any. */\n  private _loader: Promise<void> | undefined;\n  /** Monotonic request id used to ignore stale responses. */\n  private _loaderId: number;\n  /** Indicates whether the last request completed successfully. */\n  private _isLoaded: boolean;\n  /** Indicates whether the current request was cancelled. */\n  private _isCancelled: boolean;\n  /** Indicates whether the tile should be refreshed. */\n  private _needsReload: boolean;\n  /** Structured bounds assigned when the tile is created. */\n  private _bbox!: TileBoundingBox;\n\n  /** Creates a tile header for a specific tile index. */\n  constructor(index: TileIndex) {\n    this.index = index;\n    this.parent = null;\n    this.children = [];\n    this.content = null;\n\n    this._loader = undefined;\n    this._abortController = null;\n    this._loaderId = 0;\n    this._isLoaded = false;\n    this._isCancelled = false;\n    this._needsReload = false;\n  }\n\n  /** Structured bounds for the tile in the active coordinate system. */\n  get bbox(): TileBoundingBox {\n    return this._bbox;\n  }\n\n  /** Initializes the tile bounds once during tile creation. */\n  set bbox(value: TileBoundingBox) {\n    if (this._bbox) return;\n\n    this._bbox = value;\n    if ('west' in value) {\n      this.boundingBox = [\n        [value.west, value.south],\n        [value.east, value.north]\n      ];\n    } else {\n      this.boundingBox = [\n        [value.left, value.top],\n        [value.right, value.bottom]\n      ];\n    }\n  }\n\n  /** Resolves to loaded content while a request is in flight, otherwise returns the cached content. */\n  get data(): Promise<DataT | null> | DataT | null {\n    const loader = this._loader;\n    if (!this._isCancelled && loader !== undefined) {\n      return loader.then(() => this.data);\n    }\n    return this.content;\n  }\n\n  /** Indicates whether tile content is available and up to date. */\n  get isLoaded(): boolean {\n    return this._isLoaded && !this._needsReload;\n  }\n\n  /** Indicates whether a tile request is currently in flight. */\n  get isLoading(): boolean {\n    return Boolean(this._loader) && !this._isCancelled;\n  }\n\n  /** Indicates whether the tile should be requested again. */\n  get needsReload(): boolean {\n    return this._needsReload || this._isCancelled;\n  }\n\n  /** Estimated byte size of the cached payload. */\n  get byteLength(): number {\n    const result = this.content ? (this.content as any).byteLength : 0;\n    return Number.isFinite(result) ? result : 0;\n  }\n\n  /** Internal request pipeline used by {@link loadData}. */\n  private async _loadData({\n    getData,\n    requestScheduler,\n    onLoad,\n    onError\n  }: Tile2DLoadDataProps<DataT>): Promise<void> {\n    const completeLoad = (tileData: DataT | null, error: unknown, loaderId: number): void => {\n      if (loaderId !== this._loaderId) {\n        return;\n      }\n\n      this._loader = undefined;\n      this.content = tileData;\n\n      if (this._isCancelled && !tileData) {\n        this._isLoaded = false;\n        return;\n      }\n\n      this._isLoaded = true;\n      this._isCancelled = false;\n\n      if (error) {\n        onError(error, this);\n        return;\n      }\n      onLoad(this);\n    };\n\n    const {index, id, bbox, userData, zoom} = this;\n    const loaderId = this._loaderId;\n\n    this._abortController = new AbortController();\n    const {signal} = this._abortController;\n    const requestToken = await requestScheduler.scheduleRequest(this, () => 1);\n\n    if (!requestToken) {\n      this._isCancelled = true;\n      return;\n    }\n    if (this._isCancelled) {\n      requestToken.done();\n      return;\n    }\n\n    let tileData: DataT | null = null;\n    let error;\n    try {\n      tileData = await getData({index, id, bbox, userData, zoom, signal});\n    } catch (err) {\n      error = err || true;\n    } finally {\n      requestToken.done();\n    }\n\n    completeLoad(tileData, error, loaderId);\n  }\n\n  /** Loads tile data through the shared scheduler. */\n  loadData(opts: Tile2DLoadDataProps): Promise<void> {\n    this._isLoaded = false;\n    this._isCancelled = false;\n    this._needsReload = false;\n    this._loaderId++;\n    this._loader = this._loadData(opts);\n    return this._loader;\n  }\n\n  /** Marks the tile stale so it is refreshed on the next traversal. */\n  setNeedsReload(): void {\n    if (this.isLoading) {\n      this.abort();\n      this._loader = undefined;\n    }\n    this._needsReload = true;\n  }\n\n  /** Cancels an in-flight tile request. */\n  abort(): void {\n    if (this.isLoaded) {\n      return;\n    }\n    this._isCancelled = true;\n    this._abortController?.abort();\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["tileData", "error", "loaderId"]
+}

package/dist/tileset/index.d.ts

@@ -0,0 +1,8 @@
+export type { TileLoadProps, Bounds, ZRange, GeoBoundingBox, NonGeoBoundingBox, TileBoundingBox } from "./types.js";
+export type { SharedTileset2DAdapter, SharedTileset2DTraversalContext, SharedTileset2DTileContext } from "./adapter.js";
+export type { RefinementStrategy, Tileset2DProps as SharedTileset2DBaseProps } from "./tileset-2d.js";
+export { STRATEGY_DEFAULT, STRATEGY_NEVER, STRATEGY_REPLACE } from "./tileset-2d.js";
+export type { SharedTileset2DProps } from "./tileset-2d.js";
+export { SharedTileset2D } from "./tileset-2d.js";
+export { SharedTile2DHeader } from "./tile-2d-header.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tileset/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tileset/index.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,aAAa,EACb,MAAM,EACN,MAAM,EACN,cAAc,EACd,iBAAiB,EACjB,eAAe,EAChB,mBAAgB;AACjB,YAAY,EACV,sBAAsB,EACtB,+BAA+B,EAC/B,0BAA0B,EAC3B,qBAAkB;AACnB,YAAY,EAAC,kBAAkB,EAAE,cAAc,IAAI,wBAAwB,EAAC,wBAAqB;AACjG,OAAO,EAAC,gBAAgB,EAAE,cAAc,EAAE,gBAAgB,EAAC,wBAAqB;AAChF,YAAY,EAAC,oBAAoB,EAAC,wBAAqB;AACvD,OAAO,EAAC,eAAe,EAAC,wBAAqB;AAC7C,OAAO,EAAC,kBAAkB,EAAC,4BAAyB"}

package/dist/tileset/index.js

@@ -0,0 +1,7 @@
+// deck.gl-community
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+export { STRATEGY_DEFAULT, STRATEGY_NEVER, STRATEGY_REPLACE } from "./tileset-2d.js";
+export { SharedTileset2D } from "./tileset-2d.js";
+export { SharedTile2DHeader } from "./tile-2d-header.js";
+//# sourceMappingURL=index.js.map

package/dist/tileset/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tileset/index.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,+BAA+B;AAC/B,oCAAoC;AAgBpC,OAAO,EAAC,gBAAgB,EAAE,cAAc,EAAE,gBAAgB,EAAC,wBAAqB;AAEhF,OAAO,EAAC,eAAe,EAAC,wBAAqB;AAC7C,OAAO,EAAC,kBAAkB,EAAC,4BAAyB"}

package/dist/tileset/tile-2d-header.d.ts

@@ -0,0 +1,71 @@
+import { RequestScheduler } from '@loaders.gl/loader-utils';
+import type { TileBoundingBox, TileIndex, TileLoadProps } from "./types.js";
+/** Parameters used by {@link SharedTile2DHeader.loadData}. */
+export type Tile2DLoadDataProps<DataT = any> = {
+    /** Shared request scheduler for throttling tile fetches. */
+    requestScheduler: RequestScheduler;
+    /** Application-provided tile data loader. */
+    getData: (props: TileLoadProps) => Promise<DataT | null> | DataT | null;
+    /** Callback fired after tile content resolves successfully. */
+    onLoad: (tile: SharedTile2DHeader<DataT>) => void;
+    /** Callback fired after tile content fails to load. */
+    onError: (error: any, tile: SharedTile2DHeader<DataT>) => void;
+};
+/** Shared tile cache entry used by {@link SharedTileset2D}. */
+export declare class SharedTile2DHeader<DataT = any> {
+    /** x/y/z tile coordinate. */
+    index: TileIndex;
+    /** Closest cached ancestor tile in the current tree. */
+    parent: SharedTile2DHeader | null;
+    /** Cached child tiles beneath this tile. */
+    children: SharedTile2DHeader[] | null;
+    /** Loaded tile payload. */
+    content: DataT | null;
+    /** Stable tile cache id. */
+    id: string;
+    /** Resolved zoom level for the tile. */
+    zoom: number;
+    /** Optional application data associated with the tile. */
+    userData?: Record<string, any>;
+    /** Bounds represented as `[[minX, minY], [maxX, maxY]]` for loaders.gl compatibility. */
+    boundingBox: [min: number[], max: number[]];
+    /** Abort controller for the current request, if one exists. */
+    private _abortController;
+    /** Promise tracking the in-flight tile load, if any. */
+    private _loader;
+    /** Monotonic request id used to ignore stale responses. */
+    private _loaderId;
+    /** Indicates whether the last request completed successfully. */
+    private _isLoaded;
+    /** Indicates whether the current request was cancelled. */
+    private _isCancelled;
+    /** Indicates whether the tile should be refreshed. */
+    private _needsReload;
+    /** Structured bounds assigned when the tile is created. */
+    private _bbox;
+    /** Creates a tile header for a specific tile index. */
+    constructor(index: TileIndex);
+    /** Structured bounds for the tile in the active coordinate system. */
+    get bbox(): TileBoundingBox;
+    /** Initializes the tile bounds once during tile creation. */
+    set bbox(value: TileBoundingBox);
+    /** Resolves to loaded content while a request is in flight, otherwise returns the cached content. */
+    get data(): Promise<DataT | null> | DataT | null;
+    /** Indicates whether tile content is available and up to date. */
+    get isLoaded(): boolean;
+    /** Indicates whether a tile request is currently in flight. */
+    get isLoading(): boolean;
+    /** Indicates whether the tile should be requested again. */
+    get needsReload(): boolean;
+    /** Estimated byte size of the cached payload. */
+    get byteLength(): number;
+    /** Internal request pipeline used by {@link loadData}. */
+    private _loadData;
+    /** Loads tile data through the shared scheduler. */
+    loadData(opts: Tile2DLoadDataProps): Promise<void>;
+    /** Marks the tile stale so it is refreshed on the next traversal. */
+    setNeedsReload(): void;
+    /** Cancels an in-flight tile request. */
+    abort(): void;
+}
+//# sourceMappingURL=tile-2d-header.d.ts.map

package/dist/tileset/tile-2d-header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tile-2d-header.d.ts","sourceRoot":"","sources":["../../src/tileset/tile-2d-header.ts"],"names":[],"mappings":"AAKA,OAAO,EAAC,gBAAgB,EAAC,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAC,eAAe,EAAE,SAAS,EAAE,aAAa,EAAC,mBAAgB;AAEvE,8DAA8D;AAC9D,MAAM,MAAM,mBAAmB,CAAC,KAAK,GAAG,GAAG,IAAI;IAC7C,4DAA4D;IAC5D,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,6CAA6C;IAC7C,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC;IACxE,+DAA+D;IAC/D,MAAM,EAAE,CAAC,IAAI,EAAE,kBAAkB,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IAClD,uDAAuD;IACvD,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,kBAAkB,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;CAChE,CAAC;AAEF,+DAA+D;AAC/D,qBAAa,kBAAkB,CAAC,KAAK,GAAG,GAAG;IACzC,6BAA6B;IAC7B,KAAK,EAAE,SAAS,CAAC;IACjB,wDAAwD;IACxD,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAClC,4CAA4C;IAC5C,QAAQ,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAC;IACtC,2BAA2B;IAC3B,OAAO,EAAE,KAAK,GAAG,IAAI,CAAC;IAEtB,4BAA4B;IAC5B,EAAE,EAAG,MAAM,CAAC;IACZ,wCAAwC;IACxC,IAAI,EAAG,MAAM,CAAC;IACd,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,yFAAyF;IACzF,WAAW,EAAG,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;IAE7C,+DAA+D;IAC/D,OAAO,CAAC,gBAAgB,CAAyB;IACjD,wDAAwD;IACxD,OAAO,CAAC,OAAO,CAA4B;IAC3C,2DAA2D;IAC3D,OAAO,CAAC,SAAS,CAAS;IAC1B,iEAAiE;IACjE,OAAO,CAAC,SAAS,CAAU;IAC3B,2DAA2D;IAC3D,OAAO,CAAC,YAAY,CAAU;IAC9B,sDAAsD;IACtD,OAAO,CAAC,YAAY,CAAU;IAC9B,2DAA2D;IAC3D,OAAO,CAAC,KAAK,CAAmB;IAEhC,uDAAuD;gBAC3C,KAAK,EAAE,SAAS;IAc5B,sEAAsE;IACtE,IAAI,IAAI,IAAI,eAAe,CAE1B;IAED,6DAA6D;IAC7D,IAAI,IAAI,CAAC,KAAK,EAAE,eAAe,EAe9B;IAED,qGAAqG;IACrG,IAAI,IAAI,IAAI,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,KAAK,GAAG,IAAI,CAM/C;IAED,kEAAkE;IAClE,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,+DAA+D;IAC/D,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,4DAA4D;IAC5D,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,iDAAiD;IACjD,IAAI,UAAU,IAAI,MAAM,CAGvB;IAED,0DAA0D;YAC5C,SAAS;IA0DvB,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IASlD,qEAAqE;IACrE,cAAc,IAAI,IAAI;IAQtB,yCAAyC;IACzC,KAAK,IAAI,IAAI;CAOd"}

package/dist/tileset/tile-2d-header.js

@@ -0,0 +1,168 @@
+// deck.gl-community
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/** Shared tile cache entry used by {@link SharedTileset2D}. */
+export class SharedTile2DHeader {
+    /** x/y/z tile coordinate. */
+    index;
+    /** Closest cached ancestor tile in the current tree. */
+    parent;
+    /** Cached child tiles beneath this tile. */
+    children;
+    /** Loaded tile payload. */
+    content;
+    /** Stable tile cache id. */
+    id;
+    /** Resolved zoom level for the tile. */
+    zoom;
+    /** Optional application data associated with the tile. */
+    userData;
+    /** Bounds represented as `[[minX, minY], [maxX, maxY]]` for loaders.gl compatibility. */
+    boundingBox;
+    /** Abort controller for the current request, if one exists. */
+    _abortController;
+    /** Promise tracking the in-flight tile load, if any. */
+    _loader;
+    /** Monotonic request id used to ignore stale responses. */
+    _loaderId;
+    /** Indicates whether the last request completed successfully. */
+    _isLoaded;
+    /** Indicates whether the current request was cancelled. */
+    _isCancelled;
+    /** Indicates whether the tile should be refreshed. */
+    _needsReload;
+    /** Structured bounds assigned when the tile is created. */
+    _bbox;
+    /** Creates a tile header for a specific tile index. */
+    constructor(index) {
+        this.index = index;
+        this.parent = null;
+        this.children = [];
+        this.content = null;
+        this._loader = undefined;
+        this._abortController = null;
+        this._loaderId = 0;
+        this._isLoaded = false;
+        this._isCancelled = false;
+        this._needsReload = false;
+    }
+    /** Structured bounds for the tile in the active coordinate system. */
+    get bbox() {
+        return this._bbox;
+    }
+    /** Initializes the tile bounds once during tile creation. */
+    set bbox(value) {
+        if (this._bbox)
+            return;
+        this._bbox = value;
+        if ('west' in value) {
+            this.boundingBox = [
+                [value.west, value.south],
+                [value.east, value.north]
+            ];
+        }
+        else {
+            this.boundingBox = [
+                [value.left, value.top],
+                [value.right, value.bottom]
+            ];
+        }
+    }
+    /** Resolves to loaded content while a request is in flight, otherwise returns the cached content. */
+    get data() {
+        const loader = this._loader;
+        if (!this._isCancelled && loader !== undefined) {
+            return loader.then(() => this.data);
+        }
+        return this.content;
+    }
+    /** Indicates whether tile content is available and up to date. */
+    get isLoaded() {
+        return this._isLoaded && !this._needsReload;
+    }
+    /** Indicates whether a tile request is currently in flight. */
+    get isLoading() {
+        return Boolean(this._loader) && !this._isCancelled;
+    }
+    /** Indicates whether the tile should be requested again. */
+    get needsReload() {
+        return this._needsReload || this._isCancelled;
+    }
+    /** Estimated byte size of the cached payload. */
+    get byteLength() {
+        const result = this.content ? this.content.byteLength : 0;
+        return Number.isFinite(result) ? result : 0;
+    }
+    /** Internal request pipeline used by {@link loadData}. */
+    async _loadData({ getData, requestScheduler, onLoad, onError }) {
+        const completeLoad = (tileData, error, loaderId) => {
+            if (loaderId !== this._loaderId) {
+                return;
+            }
+            this._loader = undefined;
+            this.content = tileData;
+            if (this._isCancelled && !tileData) {
+                this._isLoaded = false;
+                return;
+            }
+            this._isLoaded = true;
+            this._isCancelled = false;
+            if (error) {
+                onError(error, this);
+                return;
+            }
+            onLoad(this);
+        };
+        const { index, id, bbox, userData, zoom } = this;
+        const loaderId = this._loaderId;
+        this._abortController = new AbortController();
+        const { signal } = this._abortController;
+        const requestToken = await requestScheduler.scheduleRequest(this, () => 1);
+        if (!requestToken) {
+            this._isCancelled = true;
+            return;
+        }
+        if (this._isCancelled) {
+            requestToken.done();
+            return;
+        }
+        let tileData = null;
+        let error;
+        try {
+            tileData = await getData({ index, id, bbox, userData, zoom, signal });
+        }
+        catch (err) {
+            error = err || true;
+        }
+        finally {
+            requestToken.done();
+        }
+        completeLoad(tileData, error, loaderId);
+    }
+    /** Loads tile data through the shared scheduler. */
+    loadData(opts) {
+        this._isLoaded = false;
+        this._isCancelled = false;
+        this._needsReload = false;
+        this._loaderId++;
+        this._loader = this._loadData(opts);
+        return this._loader;
+    }
+    /** Marks the tile stale so it is refreshed on the next traversal. */
+    setNeedsReload() {
+        if (this.isLoading) {
+            this.abort();
+            this._loader = undefined;
+        }
+        this._needsReload = true;
+    }
+    /** Cancels an in-flight tile request. */
+    abort() {
+        if (this.isLoaded) {
+            return;
+        }
+        this._isCancelled = true;
+        this._abortController?.abort();
+    }
+}
+//# sourceMappingURL=tile-2d-header.js.map

package/dist/tileset/tile-2d-header.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tile-2d-header.js","sourceRoot":"","sources":["../../src/tileset/tile-2d-header.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,+BAA+B;AAC/B,oCAAoC;AAkBpC,+DAA+D;AAC/D,MAAM,OAAO,kBAAkB;IAC7B,6BAA6B;IAC7B,KAAK,CAAY;IACjB,wDAAwD;IACxD,MAAM,CAA4B;IAClC,4CAA4C;IAC5C,QAAQ,CAA8B;IACtC,2BAA2B;IAC3B,OAAO,CAAe;IAEtB,4BAA4B;IAC5B,EAAE,CAAU;IACZ,wCAAwC;IACxC,IAAI,CAAU;IACd,0DAA0D;IAC1D,QAAQ,CAAuB;IAC/B,yFAAyF;IACzF,WAAW,CAAkC;IAE7C,+DAA+D;IACvD,gBAAgB,CAAyB;IACjD,wDAAwD;IAChD,OAAO,CAA4B;IAC3C,2DAA2D;IACnD,SAAS,CAAS;IAC1B,iEAAiE;IACzD,SAAS,CAAU;IAC3B,2DAA2D;IACnD,YAAY,CAAU;IAC9B,sDAAsD;IAC9C,YAAY,CAAU;IAC9B,2DAA2D;IACnD,KAAK,CAAmB;IAEhC,uDAAuD;IACvD,YAAY,KAAgB;QAC1B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QAEpB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QACzB,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;IAC5B,CAAC;IAED,sEAAsE;IACtE,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,6DAA6D;IAC7D,IAAI,IAAI,CAAC,KAAsB;QAC7B,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO;QAEvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;YACpB,IAAI,CAAC,WAAW,GAAG;gBACjB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC;gBACzB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC;aAC1B,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,WAAW,GAAG;gBACjB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC;gBACvB,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC;aAC5B,CAAC;QACJ,CAAC;IACH,CAAC;IAED,qGAAqG;IACrG,IAAI,IAAI;QACN,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YAC/C,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,kEAAkE;IAClE,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC;IAC9C,CAAC;IAED,+DAA+D;IAC/D,IAAI,SAAS;QACX,OAAO,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC;IACrD,CAAC;IAED,4DAA4D;IAC5D,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,CAAC;IAChD,CAAC;IAED,iDAAiD;IACjD,IAAI,UAAU;QACZ,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAE,IAAI,CAAC,OAAe,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QACnE,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,0DAA0D;IAClD,KAAK,CAAC,SAAS,CAAC,EACtB,OAAO,EACP,gBAAgB,EAChB,MAAM,EACN,OAAO,EACoB;QAC3B,MAAM,YAAY,GAAG,CAAC,QAAsB,EAAE,KAAc,EAAE,QAAgB,EAAQ,EAAE;YACtF,IAAI,QAAQ,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;gBAChC,OAAO;YACT,CAAC;YAED,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;YACzB,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC;YAExB,IAAI,IAAI,CAAC,YAAY,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACnC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;gBACvB,OAAO;YACT,CAAC;YAED,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACtB,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;YAE1B,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;gBACrB,OAAO;YACT,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,CAAC;QACf,CAAC,CAAC;QAEF,MAAM,EAAC,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAC,GAAG,IAAI,CAAC;QAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAEhC,IAAI,CAAC,gBAAgB,GAAG,IAAI,eAAe,EAAE,CAAC;QAC9C,MAAM,EAAC,MAAM,EAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC;QACvC,MAAM,YAAY,GAAG,MAAM,gBAAgB,CAAC,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAE3E,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;YACzB,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,YAAY,CAAC,IAAI,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QAED,IAAI,QAAQ,GAAiB,IAAI,CAAC;QAClC,IAAI,KAAK,CAAC;QACV,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,OAAO,CAAC,EAAC,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAC,CAAC,CAAC;QACtE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,GAAG,GAAG,IAAI,IAAI,CAAC;QACtB,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,IAAI,EAAE,CAAC;QACtB,CAAC;QAED,YAAY,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,oDAAoD;IACpD,QAAQ,CAAC,IAAyB;QAChC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,qEAAqE;IACrE,cAAc;QACZ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED,yCAAyC;IACzC,KAAK;QACH,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,gBAAgB,EAAE,KAAK,EAAE,CAAC;IACjC,CAAC;CACF"}

package/dist/tileset/tileset-2d.d.ts

@@ -0,0 +1,210 @@
+import { type TileSource, type TileSourceMetadata } from '@loaders.gl/loader-utils';
+import type { Matrix4 } from '@math.gl/core';
+import { Stats } from '@probe.gl/stats';
+import { SharedTile2DHeader } from "./tile-2d-header.js";
+import type { SharedTileset2DAdapter } from "./adapter.js";
+import type { TileIndex, TileLoadProps, ZRange } from "./types.js";
+export declare const STRATEGY_NEVER = "never";
+export declare const STRATEGY_REPLACE = "no-overlap";
+export declare const STRATEGY_DEFAULT = "best-available";
+/** Function form of a refinement strategy. */
+export type RefinementStrategyFunction = (tiles: SharedTile2DHeader[]) => void;
+/** Strategy controlling how parent and child placeholder tiles are displayed while content loads. */
+export type RefinementStrategy = typeof STRATEGY_NEVER | typeof STRATEGY_REPLACE | typeof STRATEGY_DEFAULT | RefinementStrategyFunction;
+/** Core configuration shared by all {@link SharedTileset2D} instances. */
+export type Tileset2DProps<DataT = any, ViewStateT = unknown> = {
+    /** Callback used to load tile payloads. */
+    getTileData: (props: TileLoadProps) => Promise<DataT | null> | DataT | null;
+    /** Adapter used to compute tile traversal and tile metadata. */
+    adapter?: SharedTileset2DAdapter<ViewStateT> | null;
+    /** Bounding box limiting tile generation. */
+    extent?: number[] | null;
+    /** Tile size in pixels. */
+    tileSize?: number;
+    /** Maximum zoom level to request. */
+    maxZoom?: number | null;
+    /** Minimum zoom level to request. */
+    minZoom?: number | null;
+    /** Maximum number of tiles kept in cache. */
+    maxCacheSize?: number | null;
+    /** Maximum bytes kept in cache. */
+    maxCacheByteSize?: number | null;
+    /** Placeholder refinement strategy. */
+    refinementStrategy?: RefinementStrategy;
+    /** Elevation range used by geospatial tile selection. */
+    zRange?: ZRange | null;
+    /** Maximum concurrent tile requests. */
+    maxRequests?: number;
+    /** Debounce interval applied before issuing queued requests. */
+    debounceTime?: number;
+    /** Integer zoom offset applied when choosing tile levels. */
+    zoomOffset?: number;
+    /** Callback fired when a tile loads successfully. */
+    onTileLoad?: (tile: SharedTile2DHeader<DataT>) => void;
+    /** Callback fired when a tile is evicted from cache. */
+    onTileUnload?: (tile: SharedTile2DHeader<DataT>) => void;
+    /** Callback fired when a tile request fails. */
+    onTileError?: (err: any, tile: SharedTile2DHeader<DataT>) => void;
+};
+export declare const DEFAULT_TILESET2D_PROPS: Omit<Required<Tileset2DProps>, 'getTileData'>;
+/** Subscription callbacks emitted by {@link SharedTileset2D}. */
+type Tile2DListener<DataT = any> = {
+    /** Fired after a tile loads successfully. */
+    onTileLoad?: (tile: SharedTile2DHeader<DataT>) => void;
+    /** Fired after a tile request fails. */
+    onTileError?: (error: any, tile: SharedTile2DHeader<DataT>) => void;
+    /** Fired after a tile is evicted from cache. */
+    onTileUnload?: (tile: SharedTile2DHeader<DataT>) => void;
+    /** Fired when metadata or effective configuration changes. */
+    onUpdate?: () => void;
+    /** Fired when asynchronous metadata initialization fails. */
+    onError?: (error: Error) => void;
+    /** Fired after live tileset counters are recomputed. */
+    onStatsChange?: (stats: Stats) => void;
+};
+/** Options for creating a shared tile cache that can be reused by multiple layers and views. */
+export type SharedTileset2DProps<DataT = any, ViewStateT = unknown> = Omit<Tileset2DProps<DataT, ViewStateT>, 'getTileData'> & {
+    /** Optional tile loader used when not sourcing data from a loaders.gl TileSource. */
+    getTileData?: (props: TileLoadProps) => Promise<DataT | null> | DataT | null;
+    /** Optional loaders.gl TileSource backing this shared tileset. */
+    tileSource?: TileSource;
+};
+/** Shared tile cache and loading engine for one or more {@link SharedTile2DLayer} instances. */
+export declare class SharedTileset2D<DataT = any, ViewStateT = unknown> {
+    /** Live counters describing shared tileset state. */
+    readonly stats: Stats;
+    /** Effective runtime options after defaults and metadata overrides have been applied. */
+    protected opts: Required<SharedTileset2DProps<DataT, ViewStateT>>;
+    /** Cached metadata returned by the backing TileSource, if any. */
+    protected sourceMetadata: TileSourceMetadata | null;
+    /** Scheduler shared across all tile requests for this tileset. */
+    private _requestScheduler;
+    /** Shared tile cache keyed by tile id. */
+    private _cache;
+    /** Tracks whether parent/child links need rebuilding. */
+    private _dirty;
+    /** Cached tiles sorted by zoom for traversal and rendering. */
+    private _tiles;
+    /** Running total of cached payload byte size. */
+    private _cacheByteSize;
+    /** Cumulative number of tiles evicted from the shared cache. */
+    private _unloadedTileCount;
+    /** Subscribers watching tileset lifecycle events. */
+    private _listeners;
+    /** Selected and visible tiles tracked per consumer. */
+    private _consumers;
+    /** Option names explicitly set by the caller. */
+    private _explicitOptionKeys;
+    /** Caller-provided options before metadata-derived overrides are applied. */
+    private _baseOpts;
+    /** Derived overrides sourced from TileSource metadata. */
+    private _sourceMetadataOverrides;
+    /** Resolved maximum zoom level used by traversal. */
+    private _maxZoom?;
+    /** Resolved minimum zoom level used by traversal. */
+    private _minZoom?;
+    /** Most recent traversal context used to derive tile metadata. */
+    private _lastTileContext;
+    /** Creates a tileset from either `getTileData` or a loaders.gl `TileSource`. */
+    constructor(opts: SharedTileset2DProps<DataT, ViewStateT>);
+    /** Convenience factory for wrapping a loaders.gl `TileSource`. */
+    static fromTileSource<DataT = any>(tileSource: TileSource, opts?: Omit<SharedTileset2DProps<DataT>, 'tileSource' | 'getTileData'>): SharedTileset2D<DataT>;
+    /** All tiles currently present in the shared cache. */
+    get tiles(): SharedTile2DHeader<DataT>[];
+    /** Estimated byte size of all tile content currently retained in cache. */
+    get cacheByteSize(): number;
+    /** Union of tiles selected by all attached consumers. */
+    get selectedTiles(): SharedTile2DHeader<DataT>[];
+    /** Union of tiles contributing to the visible result across all consumers and views, including unloaded selected tiles. */
+    get visibleTiles(): SharedTile2DHeader<DataT>[];
+    /** Tiles currently loading anywhere in the shared cache. */
+    get loadingTiles(): SharedTile2DHeader<DataT>[];
+    /** Tiles retained in cache that do not currently have loaded content. */
+    get unloadedTiles(): SharedTile2DHeader<DataT>[];
+    /** Maximum resolved zoom level after applying metadata and explicit options. */
+    get maxZoom(): number | undefined;
+    /** Minimum resolved zoom level after applying metadata and explicit options. */
+    get minZoom(): number | undefined;
+    /** Active refinement strategy for placeholder handling. */
+    get refinementStrategy(): RefinementStrategy;
+    /** Adapter currently used for traversal and tile metadata. */
+    get adapter(): SharedTileset2DAdapter<ViewStateT> | null;
+    /** Subscribes to tileset lifecycle events. */
+    subscribe(listener: Tile2DListener<DataT>): () => void;
+    /** Registers a consumer so cache pruning can account for its selected tiles. */
+    attachConsumer(id: symbol): void;
+    /** Unregisters a consumer and prunes unused requests and tiles. */
+    detachConsumer(id: symbol): void;
+    /** Updates tileset options and reapplies TileSource metadata overrides. */
+    setOptions(opts: Partial<SharedTileset2DProps<DataT, ViewStateT>>): void;
+    /** Aborts in-flight requests and clears the shared cache. */
+    finalize(): void;
+    /** Marks all retained tiles stale and drops unused cached tiles. */
+    reloadAll(): void;
+    /** Updates the selected and visible tile sets for one consumer. */
+    updateConsumer(id: symbol, selectedTiles: SharedTile2DHeader<DataT>[], visibleTiles: SharedTile2DHeader<DataT>[]): void;
+    /** Rebuilds parent/child links if the cache changed since the last traversal. */
+    prepareTiles(): void;
+    /** Returns tile indices needed to cover a viewport. */
+    getTileIndices({ viewState, maxZoom, minZoom, zRange, modelMatrix, modelMatrixInverse }: {
+        viewState: ViewStateT;
+        maxZoom?: number;
+        minZoom?: number;
+        zRange: ZRange | null;
+        modelMatrix?: Matrix4 | null;
+        modelMatrixInverse?: Matrix4 | null;
+    }): TileIndex[];
+    /** Returns the stable cache id for a tile index. */
+    getTileId(index: TileIndex): string;
+    /** Returns the zoom level represented by a tile index. */
+    getTileZoom(index: TileIndex): number;
+    /** Returns derived metadata used to initialize a tile header. */
+    getTileMetadata(index: TileIndex): Record<string, any>;
+    /** Returns the parent tile index in the quadtree. */
+    getParentIndex(index: TileIndex): TileIndex;
+    /** Returns a cached tile and optionally creates and loads it on demand. */
+    getTile(index: TileIndex, create: true): SharedTile2DHeader<DataT>;
+    getTile(index: TileIndex, create?: false): SharedTile2DHeader<DataT> | undefined;
+    /** Loads metadata from a TileSource and reapplies derived option overrides. */
+    private _initializeTileSource;
+    /** Tracks which options were explicitly set by the caller. */
+    private _rememberExplicitOptions;
+    /** Resolves defaults, metadata overrides, and caller options into runtime settings. */
+    private _applyResolvedOptions;
+    /** Maps TileSource metadata into supported tileset options. */
+    private _getMetadataOverrides;
+    /** Handles successful tile loads. */
+    private _handleTileLoad;
+    /** Handles tile load failures. */
+    private _handleTileError;
+    /** Handles tile eviction from cache. */
+    private _handleTileUnload;
+    /** Notifies listeners that metadata or effective options changed. */
+    private _notifyUpdate;
+    /** Notifies listeners about asynchronous metadata errors. */
+    private _notifyError;
+    /** Recomputes absolute counter stats and notifies listeners. */
+    private _updateStats;
+    /** Writes an absolute count into a probe.gl stat. */
+    private _setStatCount;
+    /** Returns the union of selected tiles across all consumers. */
+    private _getSelectedTilesUnion;
+    /** Returns the union of visible tiles across all consumers. */
+    private _getVisibleTilesUnion;
+    /** Moves a touched tile to the back of the cache map for LRU eviction ordering. */
+    private _touchTile;
+    /** Computes the total byte size of all cached tile content. */
+    private _getCacheByteSize;
+    /** Cancels low-priority requests when consumers no longer need them. */
+    private _pruneRequests;
+    /** Rebuilds parent and child links for all cached tiles. */
+    private _rebuildTree;
+    /** Updates the sorted tile list used by traversal and rendering. */
+    private _syncTiles;
+    /** Evicts unused cached tiles when configured cache limits are exceeded. */
+    private _resizeCache;
+    /** Finds the nearest cached ancestor tile for placeholder rendering. */
+    private _getNearestAncestor;
+}
+export {};
+//# sourceMappingURL=tileset-2d.d.ts.map

package/dist/tileset/tileset-2d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tileset-2d.d.ts","sourceRoot":"","sources":["../../src/tileset/tileset-2d.ts"],"names":[],"mappings":"AAIA,OAAO,EAAmB,KAAK,UAAU,EAAE,KAAK,kBAAkB,EAAC,MAAM,0BAA0B,CAAC;AACpG,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAC,KAAK,EAAC,MAAM,iBAAiB,CAAC;AACtC,OAAO,EAAC,kBAAkB,EAAC,4BAAyB;AACpD,OAAO,KAAK,EAAC,sBAAsB,EAA6B,qBAAkB;AAClF,OAAO,KAAK,EAAC,SAAS,EAAE,aAAa,EAAE,MAAM,EAAC,mBAAgB;AAE9D,eAAO,MAAM,cAAc,UAAU,CAAC;AACtC,eAAO,MAAM,gBAAgB,eAAe,CAAC;AAC7C,eAAO,MAAM,gBAAgB,mBAAmB,CAAC;AAEjD,8CAA8C;AAC9C,MAAM,MAAM,0BAA0B,GAAG,CAAC,KAAK,EAAE,kBAAkB,EAAE,KAAK,IAAI,CAAC;AAC/E,qGAAqG;AACrG,MAAM,MAAM,kBAAkB,GAC1B,OAAO,cAAc,GACrB,OAAO,gBAAgB,GACvB,OAAO,gBAAgB,GACvB,0BAA0B,CAAC;AAE/B,0EAA0E;AAC1E,MAAM,MAAM,cAAc,CAAC,KAAK,GAAG,GAAG,EAAE,UAAU,GAAG,OAAO,IAAI;IAC9D,2CAA2C;IAC3C,WAAW,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC;IAC5E,gEAAgE;IAChE,OAAO,CAAC,EAAE,sBAAsB,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IACpD,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACzB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,mCAAmC;IACnC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,uCAAuC;IACvC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IACvD,wDAAwD;IACxD,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IACzD,gDAAgD;IAChD,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,kBAAkB,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;CACnE,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,aAAa,CAgBjF,CAAC;AAEF,iEAAiE;AACjE,KAAK,cAAc,CAAC,KAAK,GAAG,GAAG,IAAI;IACjC,6CAA6C;IAC7C,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IACvD,wCAAwC;IACxC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,kBAAkB,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IACpE,gDAAgD;IAChD,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IACzD,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,wDAAwD;IACxD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACxC,CAAC;AAUF,gGAAgG;AAChG,MAAM,MAAM,oBAAoB,CAAC,KAAK,GAAG,GAAG,EAAE,UAAU,GAAG,OAAO,IAAI,IAAI,CACxE,cAAc,CAAC,KAAK,EAAE,UAAU,CAAC,EACjC,aAAa,CACd,GAAG;IACF,qFAAqF;IACrF,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC;IAC7E,kEAAkE;IAClE,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB,CAAC;AAEF,gGAAgG;AAChG,qBAAa,eAAe,CAAC,KAAK,GAAG,GAAG,EAAE,UAAU,GAAG,OAAO;IAC5D,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,yFAAyF;IACzF,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,oBAAoB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;IAClE,kEAAkE;IAClE,SAAS,CAAC,cAAc,EAAE,kBAAkB,GAAG,IAAI,CAAQ;IAC3D,kEAAkE;IAClE,OAAO,CAAC,iBAAiB,CAAmB;IAC5C,0CAA0C;IAC1C,OAAO,CAAC,MAAM,CAAyC;IACvD,yDAAyD;IACzD,OAAO,CAAC,MAAM,CAAU;IACxB,+DAA+D;IAC/D,OAAO,CAAC,MAAM,CAA8B;IAC5C,iDAAiD;IACjD,OAAO,CAAC,cAAc,CAAS;IAC/B,gEAAgE;IAChE,OAAO,CAAC,kBAAkB,CAAS;IACnC,qDAAqD;IACrD,OAAO,CAAC,UAAU,CAAoC;IACtD,uDAAuD;IACvD,OAAO,CAAC,UAAU,CAA2C;IAC7D,iDAAiD;IACjD,OAAO,CAAC,mBAAmB,CAAqB;IAChD,6EAA6E;IAC7E,OAAO,CAAC,SAAS,CAAwD;IACzE,0DAA0D;IAC1D,OAAO,CAAC,wBAAwB,CAAwD;IACxF,qDAAqD;IACrD,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,qDAAqD;IACrD,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,kEAAkE;IAClE,OAAO,CAAC,gBAAgB,CAAuD;IAE/E,gFAAgF;gBACpE,IAAI,EAAE,oBAAoB,CAAC,KAAK,EAAE,UAAU,CAAC;IA4CzD,kEAAkE;IAClE,MAAM,CAAC,cAAc,CAAC,KAAK,GAAG,GAAG,EAC/B,UAAU,EAAE,UAAU,EACtB,IAAI,GAAE,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,aAAa,CAAM,GACzE,eAAe,CAAC,KAAK,CAAC;IAIzB,uDAAuD;IACvD,IAAI,KAAK,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAEvC;IAED,2EAA2E;IAC3E,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,yDAAyD;IACzD,IAAI,aAAa,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAE/C;IAED,2HAA2H;IAC3H,IAAI,YAAY,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAM9C;IAED,4DAA4D;IAC5D,IAAI,YAAY,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAE9C;IAED,yEAAyE;IACzE,IAAI,aAAa,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAE/C;IAED,gFAAgF;IAChF,IAAI,OAAO,IAAI,MAAM,GAAG,SAAS,CAEhC;IAED,gFAAgF;IAChF,IAAI,OAAO,IAAI,MAAM,GAAG,SAAS,CAEhC;IAED,2DAA2D;IAC3D,IAAI,kBAAkB,IAAI,kBAAkB,CAE3C;IAED,8DAA8D;IAC9D,IAAI,OAAO,IAAI,sBAAsB,CAAC,UAAU,CAAC,GAAG,IAAI,CAEvD;IAED,8CAA8C;IAC9C,SAAS,CAAC,QAAQ,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI;IAKtD,gFAAgF;IAChF,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKhC,mEAAmE;IACnE,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAOhC,2EAA2E;IAC3E,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,oBAAoB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,GAAG,IAAI;IAMxE,6DAA6D;IAC7D,QAAQ,IAAI,IAAI;IAchB,oEAAoE;IACpE,SAAS,IAAI,IAAI;IAejB,mEAAmE;IACnE,cAAc,CACZ,EAAE,EAAE,MAAM,EACV,aAAa,EAAE,kBAAkB,CAAC,KAAK,CAAC,EAAE,EAC1C,YAAY,EAAE,kBAAkB,CAAC,KAAK,CAAC,EAAE,GACxC,IAAI;IAUP,iFAAiF;IACjF,YAAY,IAAI,IAAI;IAQpB,uDAAuD;IACvD,cAAc,CAAC,EACb,SAAS,EACT,OAAO,EACP,OAAO,EACP,MAAM,EACN,WAAW,EACX,kBAAkB,EACnB,EAAE;QACD,SAAS,EAAE,UAAU,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QAC7B,kBAAkB,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;KACrC,GAAG,SAAS,EAAE;IAmBf,oDAAoD;IACpD,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM;IAInC,0DAA0D;IAC1D,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM;IAIrC,iEAAiE;IACjE,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAUtD,qDAAqD;IACrD,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS;IAI3C,2EAA2E;IAC3E,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,GAAG,kBAAkB,CAAC,KAAK,CAAC;IAClE,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,KAAK,GAAG,kBAAkB,CAAC,KAAK,CAAC,GAAG,SAAS;IAqChF,+EAA+E;YACjE,qBAAqB;IAanC,8DAA8D;IAC9D,OAAO,CAAC,wBAAwB;IAMhC,uFAAuF;IACvF,OAAO,CAAC,qBAAqB;IAwB7B,+DAA+D;IAC/D,OAAO,CAAC,qBAAqB;IAwB7B,qCAAqC;IACrC,OAAO,CAAC,eAAe;IAUvB,kCAAkC;IAClC,OAAO,CAAC,gBAAgB;IAQxB,wCAAwC;IACxC,OAAO,CAAC,iBAAiB;IASzB,qEAAqE;IACrE,OAAO,CAAC,aAAa;IAMrB,6DAA6D;IAC7D,OAAO,CAAC,YAAY;IAMpB,gEAAgE;IAChE,OAAO,CAAC,YAAY;IAcpB,qDAAqD;IACrD,OAAO,CAAC,aAAa;IAIrB,gEAAgE;IAChE,OAAO,CAAC,sBAAsB;IAU9B,+DAA+D;IAC/D,OAAO,CAAC,qBAAqB;IAU7B,mFAAmF;IACnF,OAAO,CAAC,UAAU;IAKlB,+DAA+D;IAC/D,OAAO,CAAC,iBAAiB;IAQzB,wEAAwE;IACxE,OAAO,CAAC,cAAc;IAyBtB,4DAA4D;IAC5D,OAAO,CAAC,YAAY;IAgBpB,oEAAoE;IACpE,OAAO,CAAC,UAAU;IAIlB,4EAA4E;IAC5E,OAAO,CAAC,YAAY;IA4BpB,wEAAwE;IACxE,OAAO,CAAC,mBAAmB;CAY5B"}