maplibre-gl-layers 0.15.0 → 0.17.0

package/README.md

@@ -83,8 +83,8 @@ In addition to images, you can render text alongside sprites and animate them to
 - Add multiple images and text to the same sprite, adjusting rotation, offset, scale, opacity, and more.
 - Animate sprite movement, rotation, and offsets with interpolation controls.
 - Control draw order via sub-layers and per-sprite ordering.
-- Bulk update API for many sprite states.
-- No package dependencies except MapLibre.
+- Fully imperative APIs. Updates with high-performance and extensible.
+- Accelerating computational processing with WASM and shaders.
 
 ### Requirements
 

package/dist/SpriteLayer.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.15.0
+ * version: 0.17.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: d850b7e9c713f54f0630248dc4ea370721b6965b
+ * git.commit.hash: 9fe9aa30db6602d13643e32c94af39ae2b26b082
  */
 
 import { SpriteLayerInterface, SpriteLayerOptions, SpriteLocation, SpriteImageDefinitionInit } from './types';
@@ -17,16 +17,17 @@ import { InternalSpriteImageState, InternalSpriteCurrentState, SpriteOriginRefer
  * @param {SpriteLocation} nextLocation - Destination location used to derive bearing and distance.
  * @returns {boolean} `true` when auto-rotation was applied, `false` otherwise.
  */
-export declare const applyAutoRotation: <T>(sprite: InternalSpriteCurrentState<T>, nextLocation: SpriteLocation) => boolean;
+export declare const applyAutoRotation: <T>(sprite: InternalSpriteCurrentState<T>, nextLocation: SpriteLocation, forceAutoRotation: boolean) => boolean;
 /**
  * Creates internal sprite image state from initialization data and layer bookkeeping fields.
  * @param {SpriteImageDefinitionInit} imageInit - Caller-provided image definition.
  * @param {number} subLayer - Sub-layer index the image belongs to.
  * @param {number} order - Ordering slot within the sub-layer.
  * @param {SpriteOriginReference} originReference - Encode/Decode origin reference.
+ * @param {boolean} invalidated - Initially invalidate state.
  * @returns {InternalSpriteImageState} Normalized internal state ready for rendering.
  */
-export declare const createImageStateFromInit: (imageInit: SpriteImageDefinitionInit, subLayer: number, order: number, originReference: SpriteOriginReference) => InternalSpriteImageState;
+export declare const createImageStateFromInit: (imageInit: SpriteImageDefinitionInit, subLayer: number, order: number, originReference: SpriteOriginReference, invalidated: boolean) => InternalSpriteImageState;
 /**
  * Factory that creates the MapLibre layer interface for the sprite layer.
  * Implements the CustomLayerInterface lifecycle (init -> render -> dispose), packing thousands

package/dist/config.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.15.0
+ * version: 0.17.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: d850b7e9c713f54f0630248dc4ea370721b6965b
+ * git.commit.hash: 9fe9aa30db6602d13643e32c94af39ae2b26b082
  */
 
 /** Debug flag */

package/dist/const.d.ts

@@ -1,15 +1,16 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.15.0
+ * version: 0.17.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: d850b7e9c713f54f0630248dc4ea370721b6965b
+ * git.commit.hash: 9fe9aa30db6602d13643e32c94af39ae2b26b082
  */
 
 import { Rect } from './utils/looseQuadTree';
 import { SpriteAnchor, SpriteImageOffset, SpriteTextGlyphHorizontalAlign } from './types';
+import { RgbaColor } from './internalTypes';
 /** Default sprite anchor centered at the image origin. */
 export declare const DEFAULT_ANCHOR: Readonly<SpriteAnchor>;
 /** Default image offset applied when none is provided. */
@@ -21,6 +22,10 @@ export declare const DEFAULT_TEXT_GLYPH_COLOR = "#000000";
 export declare const DEFAULT_TEXT_GLYPH_ALIGN: SpriteTextGlyphHorizontalAlign;
 export declare const DEFAULT_TEXT_GLYPH_FONT_SIZE = 32;
 export declare const DEFAULT_TEXT_GLYPH_RENDER_PIXEL_RATIO = 1;
+/** Default threshold in meters for auto-rotation to treat movement as significant. */
+export declare const DEFAULT_AUTO_ROTATION_MIN_DISTANCE_METERS = 20;
+/** Default border width in meters for sprite image outlines. */
+export declare const DEFAULT_BORDER_WIDTH_METERS = 1;
 /**
  * WGS84-compatible Earth radius in meters.
  * Used to convert one radian of longitude into meters when scaling sprites.
@@ -65,3 +70,26 @@ export declare const TRIANGLE_INDICES: readonly [0, 1, 2, 2, 1, 3];
  * @constant
  */
 export declare const UV_CORNERS: ReadonlyArray<readonly [number, number]>;
+declare const __CSS_KEYWORD_COLORS: {
+    black: RgbaColor;
+    silver: RgbaColor;
+    gray: RgbaColor;
+    white: RgbaColor;
+    maroon: RgbaColor;
+    red: RgbaColor;
+    purple: RgbaColor;
+    fuchsia: RgbaColor;
+    green: RgbaColor;
+    lime: RgbaColor;
+    olive: RgbaColor;
+    yellow: RgbaColor;
+    navy: RgbaColor;
+    blue: RgbaColor;
+    teal: RgbaColor;
+    aqua: RgbaColor;
+    transparent: RgbaColor;
+};
+export declare const CSS_KEYWORD_COLORS: typeof __CSS_KEYWORD_COLORS & Record<string, RgbaColor>;
+export declare const DEFAULT_BORDER_COLOR = "red";
+export declare const DEFAULT_BORDER_COLOR_RGBA: RgbaColor;
+export {};

package/dist/default.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.15.0
+ * version: 0.17.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: d850b7e9c713f54f0630248dc4ea370721b6965b
+ * git.commit.hash: 9fe9aa30db6602d13643e32c94af39ae2b26b082
  */
 
 import { SpriteScalingOptions, SpriteTextureFilteringOptions } from './types';

package/dist/gl/atlas.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.15.0
+ * version: 0.17.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: d850b7e9c713f54f0630248dc4ea370721b6965b
+ * git.commit.hash: 9fe9aa30db6602d13643e32c94af39ae2b26b082
  */
 
 import { Deferred } from 'async-primitives';

package/dist/gl/hitTest.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.15.0
+ * version: 0.17.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: d850b7e9c713f54f0630248dc4ea370721b6965b
+ * git.commit.hash: 9fe9aa30db6602d13643e32c94af39ae2b26b082
  */
 
 import { Map as MapLibreMap } from 'maplibre-gl';
@@ -27,7 +27,7 @@ export interface HitTestEntry<T> {
     readonly maxY: number;
 }
 export interface HitTestResult<T> {
-    readonly hitEntry: HitTestEntry<T> | null;
+    readonly hitEntry: HitTestEntry<T> | undefined;
     readonly screenPoint: SpriteScreenPoint;
 }
 export interface HitTestControllerParams {
@@ -46,8 +46,8 @@ export interface HitTestController<T> {
     ], drawIndex: number) => void;
     readonly removeImageBounds: (image: InternalSpriteImageState) => void;
     readonly refreshSpriteHitTestBounds: (projectionHost: ProjectionHost, sprite: Readonly<InternalSpriteCurrentState<T>>) => void;
-    readonly findTopmostHitEntry: (point: SpriteScreenPoint, map: MapLibreMap | null) => HitTestEntry<T> | null;
-    readonly resolveHitTestResult: (nativeEvent: MouseEvent | PointerEvent | TouchEvent, canvasElement: HTMLCanvasElement | null, map: MapLibreMap | null) => HitTestResult<T> | null;
+    readonly findTopmostHitEntry: (point: SpriteScreenPoint, map: MapLibreMap | undefined) => HitTestEntry<T> | undefined;
+    readonly resolveHitTestResult: (nativeEvent: MouseEvent | PointerEvent | TouchEvent, canvasElement: HTMLCanvasElement | undefined, map: MapLibreMap | undefined) => HitTestResult<T> | undefined;
     readonly setHitTestEnabled: (enabled: boolean) => boolean;
     readonly isHitTestEnabled: () => boolean;
 }

package/dist/gl/shader.d.ts

@@ -1,15 +1,16 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.15.0
+ * version: 0.17.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: d850b7e9c713f54f0630248dc4ea370721b6965b
+ * git.commit.hash: 9fe9aa30db6602d13643e32c94af39ae2b26b082
  */
 
-import { SpriteAnchor, SpriteScreenPoint } from '../types';
-import { PreparedDrawSpriteImageParams, Releasable } from '../internalTypes';
+import { SpriteAnchor, SpriteScreenPoint, SpriteTextureFilteringOptions } from '../types';
+import { ImageHandleBufferController, PreparedDrawSpriteImageParams, RegisteredImage, Releasable, ResolvedTextureFilteringOptions, RgbaColor } from '../internalTypes';
+import { AtlasManager, AtlasOperationQueue, AtlasPageState } from './atlas';
 /** Number of components per vertex (clipPosition.xyzw + uv.xy). */
 export declare const VERTEX_COMPONENT_COUNT = 6;
 /** Component count for clip-space position attributes. */
@@ -24,30 +25,12 @@ export declare const VERTEX_STRIDE: number;
 export declare const UV_OFFSET: number;
 /** Vertex count required to draw one sprite as two triangles. */
 export declare const QUAD_VERTEX_COUNT = 6;
-/** Shared vertex shader that converts screen-space vertices when requested. */
-export declare const VERTEX_SHADER_SOURCE: "\nattribute vec4 a_position;\nattribute vec2 a_uv;\nuniform vec2 u_screenToClipScale;\nuniform vec2 u_screenToClipOffset;\nuniform float u_billboardMode;\nuniform float u_surfaceMode;\nuniform vec2 u_billboardCenter;\nuniform vec2 u_billboardHalfSize;\nuniform vec2 u_billboardAnchor;\nuniform vec2 u_billboardSinCos;\nuniform float u_surfaceClipEnabled;\nuniform mat4 u_surfaceClipMatrix;\nuniform float u_surfaceDepthBias;\nvarying vec2 v_uv;\nvec2 computeBillboardCorner(vec2 baseCorner) {\n  vec2 anchorShift = vec2(u_billboardAnchor.x * u_billboardHalfSize.x, u_billboardAnchor.y * u_billboardHalfSize.y);\n  vec2 shifted = vec2(baseCorner.x * u_billboardHalfSize.x, baseCorner.y * u_billboardHalfSize.y) - anchorShift;\n  float sinR = u_billboardSinCos.x;\n  float cosR = u_billboardSinCos.y;\n  vec2 rotated = vec2(\n    shifted.x * cosR - shifted.y * sinR,\n    shifted.x * sinR + shifted.y * cosR\n  );\n  return vec2(\n    u_billboardCenter.x + rotated.x,\n    u_billboardCenter.y - rotated.y\n  );\n}\nvec4 computeSurfaceCorner(vec2 corner) {\n  if (u_surfaceClipEnabled < 0.5) {\n    return vec4(0.0, 0.0, 0.0, 1.0);\n  }\n  vec4 clip = u_surfaceClipMatrix * vec4(1.0, corner.x, corner.y, 0.0);\n  clip.z += u_surfaceDepthBias * clip.w;\n  return clip;\n}\nvoid main() {\n  v_uv = a_uv;\n  vec4 position;\n  if (u_billboardMode > 0.5) {\n    vec2 screenPosition = computeBillboardCorner(a_position.xy);\n    position = vec4(screenPosition, 0.0, 1.0);\n  } else if (u_surfaceMode > 0.5) {\n    vec2 baseCorner = vec2(a_position.x, a_position.y);\n    position = computeSurfaceCorner(baseCorner);\n  } else {\n    position = a_position;\n  }\n  position.xy = position.xy * u_screenToClipScale + u_screenToClipOffset;\n  gl_Position = position;\n}\n";
-/** Fragment shader that applies texture sampling and opacity. */
-export declare const FRAGMENT_SHADER_SOURCE: "\nprecision mediump float;\nuniform sampler2D u_texture;\nuniform float u_opacity;\nvarying vec2 v_uv;\nvoid main() {\n  vec4 texel = texture2D(u_texture, v_uv);\n  gl_FragColor = vec4(texel.rgb, texel.a) * u_opacity;\n}\n";
 /** Initial vertex data for a unit quad. */
 export declare const INITIAL_QUAD_VERTICES: Float32Array<ArrayBuffer>;
 /** Scratch buffer rewritten for each draw call. */
 export declare const QUAD_VERTEX_SCRATCH: Float32Array<ArrayBuffer>;
-/** Vertex shader for debug hit-test outline rendering using screen coordinates. */
-export declare const DEBUG_OUTLINE_VERTEX_SHADER_SOURCE: "\nattribute vec4 a_position;\nuniform vec2 u_screenToClipScale;\nuniform vec2 u_screenToClipOffset;\nvoid main() {\n  vec4 position = a_position;\n  position.xy = position.xy * u_screenToClipScale + u_screenToClipOffset;\n  gl_Position = position;\n}\n";
-/** Fragment shader emitting a solid color for debug outlines. */
-export declare const DEBUG_OUTLINE_FRAGMENT_SHADER_SOURCE: "\nprecision mediump float;\nuniform vec4 u_color;\nvoid main() {\n  gl_FragColor = u_color;\n}\n";
-/** Number of vertices required to outline a quad using LINE_LOOP. */
-export declare const DEBUG_OUTLINE_VERTEX_COUNT = 4;
-/** Components per debug outline vertex (clipPosition.xyzw). */
-export declare const DEBUG_OUTLINE_POSITION_COMPONENT_COUNT = 4;
-/** Stride in bytes for debug outline vertices. */
-export declare const DEBUG_OUTLINE_VERTEX_STRIDE: number;
-/** Scratch buffer reused when emitting debug outlines. */
-export declare const DEBUG_OUTLINE_VERTEX_SCRATCH: Float32Array<ArrayBuffer>;
-/** Solid red RGBA color used for debug outlines. */
-export declare const DEBUG_OUTLINE_COLOR: readonly [number, number, number, number];
 /** Corner traversal order used when outlining a quad without crossing diagonals. */
-export declare const DEBUG_OUTLINE_CORNER_ORDER: readonly [0, 1, 3, 2];
+export declare const BORDER_OUTLINE_CORNER_ORDER: readonly [0, 1, 3, 2];
 /** Base corner definitions used when expanding billboards in shaders. */
 export declare const BILLBOARD_BASE_CORNERS: ReadonlyArray<readonly [number, number]>;
 /** Base corner definitions used when expanding surface quads in shaders. */
@@ -88,14 +71,44 @@ export interface SpriteDrawProgram<TTag> extends Releasable {
     draw(prepared: PreparedDrawSpriteImageParams<TTag>): boolean;
 }
 export declare const createSpriteDrawProgram: <TTag>(glContext: WebGLRenderingContext) => SpriteDrawProgram<TTag>;
-export interface DebugOutlineRenderer extends Releasable {
+export interface BorderOutlineRenderer extends Releasable {
     begin(screenToClipScaleX: number, screenToClipScaleY: number, screenToClipOffsetX: number, screenToClipOffsetY: number): void;
     drawOutline(corners: readonly [
         SpriteScreenPoint,
         SpriteScreenPoint,
         SpriteScreenPoint,
         SpriteScreenPoint
-    ]): void;
+    ], color: RgbaColor, lineWidth: number): void;
     end(): void;
 }
-export declare const createDebugOutlineRenderer: (glContext: WebGLRenderingContext) => DebugOutlineRenderer;
+export declare const createBorderOutlineRenderer: (glContext: WebGLRenderingContext) => BorderOutlineRenderer;
+export interface LeaderLineRenderer extends Releasable {
+    begin(screenToClipScaleX: number, screenToClipScaleY: number, screenToClipOffsetX: number, screenToClipOffsetY: number): void;
+    drawLine(from: Readonly<SpriteScreenPoint>, to: Readonly<SpriteScreenPoint>, color: RgbaColor, lineWidth: number): void;
+    end(): void;
+}
+export declare const createLeaderLineRenderer: (glContext: WebGLRenderingContext) => LeaderLineRenderer;
+export declare const resolveTextureFilteringOptions: (options?: SpriteTextureFilteringOptions) => ResolvedTextureFilteringOptions;
+export declare const resolveAnisotropyExtension: (glContext: WebGLRenderingContext) => EXT_texture_filter_anisotropic | undefined;
+export interface EnsureTexturesParams {
+    readonly glContext: WebGLRenderingContext | undefined;
+    readonly atlasQueue: AtlasOperationQueue;
+    readonly atlasManager: AtlasManager;
+    readonly atlasPageTextures: Map<number, WebGLTexture>;
+    readonly atlasNeedsUpload: boolean;
+    readonly resolvedTextureFiltering: ResolvedTextureFilteringOptions;
+    readonly anisotropyExtension: EXT_texture_filter_anisotropic | undefined;
+    readonly maxSupportedAnisotropy: number;
+    readonly images: ReadonlyMap<string, RegisteredImage>;
+    readonly imageHandleBuffersController: ImageHandleBufferController;
+    readonly atlasPageIndexNone: number;
+    readonly shouldUploadAtlasPages: (pageStates?: readonly AtlasPageState[]) => boolean;
+}
+/**
+ * Creates or refreshes WebGL textures for registered images.
+ * Processes only queued entries to avoid unnecessary work.
+ * Intended to run just before drawing; returns immediately if the GL context is unavailable.
+ * Ensures registerImage calls outside the render loop sync on the next frame.
+ * @returns {boolean} Updated atlas upload requirement flag.
+ */
+export declare const ensureTextures: ({ glContext, atlasQueue, atlasManager, atlasPageTextures, atlasNeedsUpload, resolvedTextureFiltering, anisotropyExtension, maxSupportedAnisotropy, images, imageHandleBuffersController, atlasPageIndexNone, shouldUploadAtlasPages, }: EnsureTexturesParams) => boolean;

package/dist/gl/text.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.15.0
+ * version: 0.17.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: d850b7e9c713f54f0630248dc4ea370721b6965b
+ * git.commit.hash: 9fe9aa30db6602d13643e32c94af39ae2b26b082
  */
 
 import { SpriteTextGlyphDimensions, SpriteTextGlyphOptions } from '../types';

package/dist/host/calculationHost.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.15.0
+ * version: 0.17.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: d850b7e9c713f54f0630248dc4ea370721b6965b
+ * git.commit.hash: 9fe9aa30db6602d13643e32c94af39ae2b26b082
  */
 
 import { Map as MapLibreMap } from 'maplibre-gl';
@@ -30,7 +30,7 @@ type ImageCenterCache = Map<string, Map<string, ImageCenterCacheEntry>>;
  * return `null` when the origin is not available (e.g., the reference was
  * culled or stored in another bucket).
  */
-type OriginImageResolver<T> = (sprite: Readonly<InternalSpriteCurrentState<T>>, image: Readonly<InternalSpriteImageState>) => InternalSpriteImageState | null;
+type OriginImageResolver<T> = (sprite: Readonly<InternalSpriteCurrentState<T>>, image: Readonly<InternalSpriteImageState>) => InternalSpriteImageState | undefined;
 export declare const DEFAULT_RENDER_INTERPOLATION_RESULT: RenderInterpolationResult;
 interface DepthSortedItem<T> {
     readonly sprite: InternalSpriteCurrentState<T>;

package/dist/host/mapLibreProjectionHost.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.15.0
+ * version: 0.17.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: d850b7e9c713f54f0630248dc4ea370721b6965b
+ * git.commit.hash: 9fe9aa30db6602d13643e32c94af39ae2b26b082
  */
 
 import { Map as MapLibreMap } from 'maplibre-gl';

package/dist/host/projectionHost.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.15.0
+ * version: 0.17.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: d850b7e9c713f54f0630248dc4ea370721b6965b
+ * git.commit.hash: 9fe9aa30db6602d13643e32c94af39ae2b26b082
  */
 
 import { mat4 as Mat4 } from 'gl-matrix';
@@ -20,6 +20,7 @@ export interface ProjectionHostParams {
     readonly width: number;
     readonly height: number;
     readonly center: Readonly<SpriteLocation>;
+    readonly cameraLocation: SpriteLocation | undefined;
     readonly pitchDeg?: number;
     readonly bearingDeg?: number;
     readonly rollDeg?: number;
@@ -36,14 +37,14 @@ export interface ProjectionHostParams {
 }
 export interface PreparedProjectionState {
     readonly zoom: number;
-    readonly mercatorMatrix: Mat4 | null;
-    readonly pixelMatrix: Mat4 | null;
-    readonly pixelMatrixInverse: Mat4 | null;
+    readonly mercatorMatrix: Mat4 | undefined;
+    readonly pixelMatrix: Mat4 | undefined;
+    readonly pixelMatrixInverse: Mat4 | undefined;
     readonly worldSize: number;
     readonly pixelPerMeter: number;
     readonly cameraToCenterDistance: number;
-    readonly clipContext: ClipContext | null;
-    readonly cameraLocation: SpriteLocation | null;
+    readonly clipContext: ClipContext | undefined;
+    readonly cameraLocation: SpriteLocation | undefined;
 }
 export declare const prepareProjectionState: (params: ProjectionHostParams) => PreparedProjectionState;
 /**

package/dist/host/runtime.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.15.0
+ * version: 0.17.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: d850b7e9c713f54f0630248dc4ea370721b6965b
+ * git.commit.hash: 9fe9aa30db6602d13643e32c94af39ae2b26b082
  */
 
 import { SpriteLayerCalculationVariant, SpriteLayerHostOptions } from '../types';

package/dist/host/wasmCalculationHost.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.15.0
+ * version: 0.17.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: d850b7e9c713f54f0630248dc4ea370721b6965b
+ * git.commit.hash: 9fe9aa30db6602d13643e32c94af39ae2b26b082
  */
 
 import { DistanceInterpolationEvaluationResult, DegreeInterpolationEvaluationResult, ImageHandleBufferController, IdHandler, InternalSpriteCurrentState, InternalSpriteImageState, PreparedDrawSpriteImageParams, PrepareDrawSpriteImageParams, Releasable, RegisteredImage, RenderCalculationHost, RenderInterpolationParams, RenderInterpolationResult, SpriteOriginReference, SpriteInterpolationEvaluationResult } from '../internalTypes';
@@ -36,6 +36,10 @@ interface PreparedInputBuffer extends Releasable {
 }
 interface WritableWasmProjectionState<TTag> {
     readonly preparedProjection: PreparedProjectionState;
+    lastFrameParams?: {
+        baseMetersPerPixel: number;
+        zoomScaleFactor: number;
+    };
     readonly prepareInputBuffer: (params: PrepareDrawSpriteImageParams<TTag>) => PreparedInputBuffer;
     readonly getImageRefs: () => readonly InternalSpriteImageState[];
     readonly getResourceRefs: () => readonly (RegisteredImage | undefined)[];

package/dist/host/wasmHost.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.15.0
+ * version: 0.17.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: d850b7e9c713f54f0630248dc4ea370721b6965b
+ * git.commit.hash: 9fe9aa30db6602d13643e32c94af39ae2b26b082
  */
 
 import { SpriteLayerCalculationVariant } from '../types';
@@ -121,7 +121,7 @@ export interface InitializeWasmHostOptions {
  * @param options Options.
  * @returns Initialized WasmHost.
  */
-export declare const initializeWasmHost: (preferredVariant?: WasmVariant, options?: InitializeWasmHostOptions) => Promise<WasmVariant>;
+export declare const initializeWasmHost: (preferredVariant: WasmVariant, options: InitializeWasmHostOptions) => Promise<WasmVariant>;
 /**
  * Release wasm offload module.
  */

package/dist/host/wasmProjectionHost.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.15.0
+ * version: 0.17.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: d850b7e9c713f54f0630248dc4ea370721b6965b
+ * git.commit.hash: 9fe9aa30db6602d13643e32c94af39ae2b26b082
  */
 
 import { ProjectionHostParams } from './projectionHost';