maplibre-gl-layers 0.13.0 → 0.14.0

package/README.md

@@ -27,7 +27,7 @@ Here is a minimal example that places a single sprite:
 import { Map } from 'maplibre-gl';
 import {
   createSpriteLayer,
-  initializeSpriteLayerHost,
+  initializeRuntimeHost,
 } from 'maplibre-gl-layers';
 
 // Create the MapLibre instance
@@ -43,8 +43,8 @@ const spriteLayer = createSpriteLayer({ id: 'vehicles' });
 
 // When MapLibre is ready
 map.on('load', async () => {
-  // Optional: enable WASM acceleration (falls back to JS when unavailable)
-  await initializeSpriteLayerHost();
+  // Initialize and add SpriteLayer to MapLibre
+  await initializeRuntimeHost();
   map.addLayer(spriteLayer);
 
   // Register an image that can be referenced by sprites

package/dist/SpriteLayer.d.ts

@@ -1,21 +1,15 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.13.0
+ * version: 0.14.0
  * description: MapLibre's layer extension library enabling the display, movement, and modification of large numbers of dynamic sprite images
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/maplibre-gl-layers.git
- * git.commit.hash: 4934aa7f4fed93594ece419184b32b5b972bbb88
+ * git.commit.hash: a531802b05777e1f54a8828a247254293df1415d
  */
 
-import { SpriteLayerInterface, SpriteLayerOptions, SpriteAnchor, SpriteLocation, SpriteImageDefinitionInit, SpriteImageOffset, SpriteInterpolationOptions, SpriteLayerCalculationVariant } from './types';
+import { SpriteLayerInterface, SpriteLayerOptions, SpriteAnchor, SpriteLocation, SpriteImageDefinitionInit, SpriteImageOffset, SpriteInterpolationOptions } from './types';
 import { InternalSpriteImageState, InternalSpriteCurrentState, SpriteOriginReference } from './internalTypes';
-export interface SpriteLayerHostOptions {
-    readonly variant?: SpriteLayerCalculationVariant;
-    readonly wasmBaseUrl?: string;
-}
-export declare const initializeSpriteLayerHost: (variantOrOptions?: SpriteLayerCalculationVariant | SpriteLayerHostOptions) => Promise<SpriteLayerCalculationVariant>;
-export declare const releaseSpriteLayerHost: () => void;
 /**
  * Applies auto-rotation to all images within a sprite when movement exceeds the configured threshold.
  * @template T Arbitrary sprite tag type.

package/dist/atlas.d.ts

@@ -0,0 +1,64 @@
+/*!
+ * name: maplibre-gl-layers
+ * version: 0.14.0
+ * description: MapLibre's layer extension library enabling the display, movement, and modification of large numbers of dynamic sprite images
+ * author: Kouji Matsui (@kekyo@mi.kekyo.net)
+ * license: MIT
+ * repository.url: https://github.com/kekyo/maplibre-gl-layers.git
+ * git.commit.hash: a531802b05777e1f54a8828a247254293df1415d
+ */
+
+import { Canvas2DSource } from './internalTypes';
+import { Deferred } from 'async-primitives';
+export interface AtlasManagerOptions {
+    readonly pageWidth?: number;
+    readonly pageHeight?: number;
+    readonly padding?: number;
+}
+export interface AtlasPlacement {
+    readonly pageIndex: number;
+    readonly width: number;
+    readonly height: number;
+    readonly x: number;
+    readonly y: number;
+    readonly u0: number;
+    readonly v0: number;
+    readonly u1: number;
+    readonly v1: number;
+}
+export interface AtlasPageState {
+    readonly index: number;
+    readonly width: number;
+    readonly height: number;
+    readonly canvas: Canvas2DSource;
+    needsUpload: boolean;
+}
+export interface AtlasManager {
+    readonly upsertImage: (id: string, bitmap: ImageBitmap) => AtlasPlacement;
+    readonly removeImage: (id: string) => boolean;
+    readonly getImagePlacement: (id: string) => AtlasPlacement | null;
+    readonly getPages: () => readonly AtlasPageState[];
+    readonly markPageClean: (pageIndex: number) => void;
+    readonly clear: () => void;
+}
+export interface AtlasQueueUpsertEntry {
+    readonly imageId: string;
+    readonly bitmap: ImageBitmap;
+    readonly deferred: Deferred<boolean>;
+}
+export interface AtlasQueueOptions {
+    readonly maxOperationsPerPass: number;
+    readonly timeBudgetMs: number;
+}
+export interface AtlasQueueCallbacks {
+    readonly onChunkProcessed: () => void;
+}
+export interface AtlasOperationQueue {
+    readonly enqueueUpsert: (entry: AtlasQueueUpsertEntry) => void;
+    readonly flushPending: () => void;
+    readonly cancelForImage: (imageId: string, reason?: Error) => void;
+    readonly rejectAll: (reason: Error) => void;
+    readonly pendingCount: number;
+}
+export declare const createAtlasManager: (options?: AtlasManagerOptions) => AtlasManager;
+export declare const createAtlasOperationQueue: (atlasManager: AtlasManager, options: AtlasQueueOptions, callbacks: AtlasQueueCallbacks) => AtlasOperationQueue;

package/dist/calculationHost.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.13.0
+ * version: 0.14.0
  * description: MapLibre's layer extension library enabling the display, movement, and modification of large numbers of dynamic sprite images
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/maplibre-gl-layers.git
- * git.commit.hash: 4934aa7f4fed93594ece419184b32b5b972bbb88
+ * git.commit.hash: a531802b05777e1f54a8828a247254293df1415d
  */
 
 import { Map as MapLibreMap } from 'maplibre-gl';

package/dist/config.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.13.0
+ * version: 0.14.0
  * description: MapLibre's layer extension library enabling the display, movement, and modification of large numbers of dynamic sprite images
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/maplibre-gl-layers.git
- * git.commit.hash: 4934aa7f4fed93594ece419184b32b5b972bbb88
+ * git.commit.hash: a531802b05777e1f54a8828a247254293df1415d
  */
 
 /** Debug flag */
@@ -16,3 +16,11 @@ export declare const USE_SHADER_BILLBOARD_GEOMETRY = true;
 export declare const USE_SHADER_SURFACE_GEOMETRY = true;
 /** Whether to enable the NDC bias for surface rendering (disabled by default). */
 export declare const ENABLE_NDC_BIAS_SURFACE = true;
+/** Maximum number of atlas operations handled per processing pass. */
+export declare const ATLAS_QUEUE_CHUNK_SIZE = 64;
+/** Time budget (milliseconds) spent per atlas queue processing pass. */
+export declare const ATLAS_QUEUE_TIME_BUDGET_MS = 20;
+/** Maximum number of text glyph jobs handled per processing pass. */
+export declare const TEXT_GLYPH_QUEUE_CHUNK_SIZE = 16;
+/** Time budget (milliseconds) spent on text glyph generation per pass. */
+export declare const TEXT_GLYPH_QUEUE_TIME_BUDGET_MS = 20;

package/dist/const.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.13.0
+ * version: 0.14.0
  * description: MapLibre's layer extension library enabling the display, movement, and modification of large numbers of dynamic sprite images
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/maplibre-gl-layers.git
- * git.commit.hash: 4934aa7f4fed93594ece419184b32b5b972bbb88
+ * git.commit.hash: a531802b05777e1f54a8828a247254293df1415d
  */
 
 import { Rect } from './looseQuadTree';

package/dist/default.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.13.0
+ * version: 0.14.0
  * description: MapLibre's layer extension library enabling the display, movement, and modification of large numbers of dynamic sprite images
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/maplibre-gl-layers.git
- * git.commit.hash: 4934aa7f4fed93594ece419184b32b5b972bbb88
+ * git.commit.hash: a531802b05777e1f54a8828a247254293df1415d
  */
 
 import { SpriteScalingOptions, SpriteTextureFilteringOptions } from './types';

package/dist/degreeInterpolation.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.13.0
+ * version: 0.14.0
  * description: MapLibre's layer extension library enabling the display, movement, and modification of large numbers of dynamic sprite images
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/maplibre-gl-layers.git
- * git.commit.hash: 4934aa7f4fed93594ece419184b32b5b972bbb88
+ * git.commit.hash: a531802b05777e1f54a8828a247254293df1415d
  */
 
 import { SpriteInterpolationOptions } from './types';

package/dist/distanceInterpolation.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.13.0
+ * version: 0.14.0
  * description: MapLibre's layer extension library enabling the display, movement, and modification of large numbers of dynamic sprite images
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/maplibre-gl-layers.git
- * git.commit.hash: 4934aa7f4fed93594ece419184b32b5b972bbb88
+ * git.commit.hash: a531802b05777e1f54a8828a247254293df1415d
  */
 
 import { SpriteInterpolationOptions } from './types';

package/dist/easing.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.13.0
+ * version: 0.14.0
  * description: MapLibre's layer extension library enabling the display, movement, and modification of large numbers of dynamic sprite images
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/maplibre-gl-layers.git
- * git.commit.hash: 4934aa7f4fed93594ece419184b32b5b972bbb88
+ * git.commit.hash: a531802b05777e1f54a8828a247254293df1415d
  */
 
 import { EasingFunction } from './types';

package/dist/image.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.13.0
+ * version: 0.14.0
  * description: MapLibre's layer extension library enabling the display, movement, and modification of large numbers of dynamic sprite images
  * author: Kouji Matsui (@kekyo@mi.kekyo.net)
  * license: MIT
  * repository.url: https://github.com/kekyo/maplibre-gl-layers.git
- * git.commit.hash: 4934aa7f4fed93594ece419184b32b5b972bbb88
+ * git.commit.hash: a531802b05777e1f54a8828a247254293df1415d
  */
 
 import { SpriteImageRegisterOptions } from './types';