maplibre-gl-layers 0.10.0 → 0.11.0

package/dist/internalTypes.d.ts

@@ -1,14 +1,85 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.10.0
+ * version: 0.11.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: 58b99588e56fc80c6874d78a17e91a50901abc17
+ * git.commit.hash: 371efb126f281333d59ec75cfe788d45f3b1482e
  */
 
+import { MercatorCoordinate } from 'maplibre-gl';
 import { SpriteMode, SpriteAnchor, SpriteImageOffset, SpriteInterpolationOptions, SpriteImageOriginLocation, SpriteLocation, SpriteTextGlyphHorizontalAlign, SpriteTextureMagFilter, SpriteTextureMinFilter, SpriteInterpolationMode, EasingFunction } from './types';
+/**
+ * Corner model describing world displacements and resulting geographic coordinates for shader validation.
+ */
+export interface SurfaceShaderCornerState {
+    east: number;
+    north: number;
+    lng: number;
+    lat: number;
+}
+/**
+ * Aggregated inputs required to reproduce surface geometry on the GPU.
+ */
+export interface SurfaceShaderInputs {
+    mercatorCenter: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    worldToMercatorScale: {
+        east: number;
+        north: number;
+    };
+    halfSizeMeters: {
+        east: number;
+        north: number;
+    };
+    anchor: SpriteAnchor;
+    offsetMeters: {
+        east: number;
+        north: number;
+    };
+    sinCos: {
+        sin: number;
+        cos: number;
+    };
+    totalRotateDeg: number;
+    depthBiasNdc: number;
+    centerDisplacement: {
+        east: number;
+        north: number;
+    };
+    baseLngLat: SpriteLocation;
+    displacedCenter: SpriteLocation;
+    scaleAdjustment: number;
+    corners: SurfaceShaderCornerState[];
+    clipCenter: {
+        x: number;
+        y: number;
+        z: number;
+        w: number;
+    };
+    clipBasisEast: {
+        x: number;
+        y: number;
+        z: number;
+        w: number;
+    };
+    clipBasisNorth: {
+        x: number;
+        y: number;
+        z: number;
+        w: number;
+    };
+    clipCorners: Array<{
+        x: number;
+        y: number;
+        z: number;
+        w: number;
+    }>;
+}
 /**
  * Runtime state describing the active interpolation between two sprite locations.
  * Consumers reuse the same state across ticks to avoid re-allocations while animation is running.
@@ -163,6 +234,7 @@ export interface InternalSpriteImageState {
     lastCommandRotateDeg: number;
     lastCommandOffsetDeg: number;
     lastCommandOffsetMeters: number;
+    surfaceShaderInputs?: SurfaceShaderInputs;
     hitTestCorners?: [
         MutableSpriteScreenPoint,
         MutableSpriteScreenPoint,
@@ -186,4 +258,8 @@ export interface InternalSpriteCurrentState<TTag> {
     lastCommandLocation: SpriteLocation;
     lastAutoRotationLocation: SpriteLocation;
     lastAutoRotationAngleDeg: number;
+    cachedMercator: MercatorCoordinate;
+    cachedMercatorLng: number;
+    cachedMercatorLat: number;
+    cachedMercatorZ: number;
 }

package/dist/interpolation.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.10.0
+ * version: 0.11.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: 58b99588e56fc80c6874d78a17e91a50901abc17
+ * git.commit.hash: 371efb126f281333d59ec75cfe788d45f3b1482e
  */
 
 import { SpriteInterpolationOptions, SpriteLocation } from './types';

package/dist/interpolationChannels.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.10.0
+ * version: 0.11.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: 58b99588e56fc80c6874d78a17e91a50901abc17
+ * git.commit.hash: 371efb126f281333d59ec75cfe788d45f3b1482e
  */
 
 import { SpriteInterpolationOptions, SpriteImageOffset } from './types';

package/dist/location.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.10.0
+ * version: 0.11.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: 58b99588e56fc80c6874d78a17e91a50901abc17
+ * git.commit.hash: 371efb126f281333d59ec75cfe788d45f3b1482e
  */
 
 import { SpriteLocation } from './types';

package/dist/looseQuadTree.d.ts

@@ -0,0 +1,34 @@
+/*!
+ * name: maplibre-gl-layers
+ * version: 0.11.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: 371efb126f281333d59ec75cfe788d45f3b1482e
+ */
+
+export interface Rect {
+    readonly x0: number;
+    readonly y0: number;
+    readonly x1: number;
+    readonly y1: number;
+}
+export interface Item<TState> extends Rect {
+    readonly state: TState;
+}
+export interface LooseQuadTreeOptions {
+    readonly bounds: Rect;
+    readonly maxItemsPerNode?: number;
+    readonly maxDepth?: number;
+    readonly looseness?: number;
+}
+export interface LooseQuadTree<TState> {
+    readonly size: number;
+    add(item: Item<TState>): void;
+    remove(x0: number, y0: number, x1: number, y1: number, item: Item<TState>): boolean;
+    update(oldX0: number, oldY0: number, oldX1: number, oldY1: number, newX0: number, newY0: number, newX1: number, newY1: number, item: Item<TState>): boolean;
+    lookup(x0: number, y0: number, x1: number, y1: number): Item<TState>[];
+    clear(): void;
+}
+export declare const createLooseQuadTree: <TState>(options: LooseQuadTreeOptions) => LooseQuadTree<TState>;

package/dist/math.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.10.0
+ * version: 0.11.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: 58b99588e56fc80c6874d78a17e91a50901abc17
+ * git.commit.hash: 371efb126f281333d59ec75cfe788d45f3b1482e
  */
 
 import { SpriteAnchor, SpriteImageOffset, SpriteLocation, SpriteScalingOptions } from './types';
@@ -391,6 +391,19 @@ export type QuadCorner = {
  * @returns {QuadCorner[]} Array containing screen- and texture-space information per corner.
  */
 export declare const calculateBillboardCornerScreenPositions: (params: BillboardCornerParams) => QuadCorner[];
+export type SurfaceShaderModelParams = {
+    baseLngLat: SpriteLocation;
+    worldWidthMeters: number;
+    worldHeightMeters: number;
+    anchor: SpriteAnchor;
+    totalRotateDeg: number;
+    offsetMeters: {
+        east: number;
+        north: number;
+    };
+};
+export type SurfaceShaderCornerModel = SurfaceCorner & SpriteLocation;
+export declare const computeSurfaceCornerShaderModel: (params: SurfaceShaderModelParams) => SurfaceShaderCornerModel[];
 /**
  * Parameters for projecting a surface sprite's center into screen space.
  * @typedef SurfaceCenterParams

package/dist/rotationInterpolation.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.10.0
+ * version: 0.11.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: 58b99588e56fc80c6874d78a17e91a50901abc17
+ * git.commit.hash: 371efb126f281333d59ec75cfe788d45f3b1482e
  */
 
 import { SpriteInterpolationOptions } from './types';

package/dist/types.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.10.0
+ * version: 0.11.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: 58b99588e56fc80c6874d78a17e91a50901abc17
+ * git.commit.hash: 371efb126f281333d59ec75cfe788d45f3b1482e
  */
 
 import { CustomLayerInterface } from 'maplibre-gl';
@@ -522,6 +522,11 @@ export interface SpriteLayerOptions {
     spriteScaling?: SpriteScalingOptions;
     /** Optional texture filtering configuration. */
     textureFiltering?: SpriteTextureFilteringOptions;
+    /**
+     * When true, renders red outlines around sprite hit-test regions to aid debugging.
+     * Defaults to false.
+     */
+    showDebugBounds?: boolean;
 }
 /**
  * Options used when registering SVG images.
@@ -704,6 +709,12 @@ export interface SpriteLayerInterface<TTag = any> extends CustomLayerInterface {
      * @returns {SpriteCurrentState<TTag> | undefined} Current state or `undefined` when not found.
      */
     readonly getSpriteState: (spriteId: string) => SpriteCurrentState<TTag> | undefined;
+    /**
+     * Enables or disables hit-test maintenance (quad-tree updates).
+     *
+     * @param {boolean} enabled - When false, hit testing is skipped and the internal data structure is cleared.
+     */
+    readonly setHitTestEnabled: (enabled: boolean) => void;
     /**
      * Attaches an image definition to a sprite.
      *

package/dist/utils.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.10.0
+ * version: 0.11.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: 58b99588e56fc80c6874d78a17e91a50901abc17
+ * git.commit.hash: 371efb126f281333d59ec75cfe788d45f3b1482e
  */
 
 import { SpriteImageRegisterOptions } from './types';

package/package.json

@@ -1,20 +1,20 @@
 {
   "git": {
     "tags": [
-      "0.10.0"
+      "0.11.0"
     ],
     "branches": [
       "main"
     ],
-    "version": "0.10.0",
+    "version": "0.11.0",
     "commit": {
-      "hash": "58b99588e56fc80c6874d78a17e91a50901abc17",
-      "shortHash": "58b9958",
-      "date": "2025-10-31T17:33:48+09:00Z",
+      "hash": "371efb126f281333d59ec75cfe788d45f3b1482e",
+      "shortHash": "371efb1",
+      "date": "2025-11-01T23:41:18+09:00Z",
       "message": "Merge branch 'develop'"
     }
   },
-  "version": "0.10.0",
+  "version": "0.11.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",