maplibre-gl-layers 0.15.0 → 0.16.0

package/dist/internalTypes.d.ts

@@ -1,15 +1,17 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.15.0
+ * version: 0.16.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: 8d2149a6811cac25ed9d8c1d97acde73e1a38e25
  */
 
-import { SpriteMode, SpriteAnchor, SpriteInterpolationOptions, SpriteImageOriginLocation, SpriteLocation, SpriteTextGlyphHorizontalAlign, SpriteTextureMagFilter, SpriteTextureMinFilter, SpriteInterpolationMode, EasingFunction, SpriteScreenPoint, SpritePoint, SpriteEasingPresetName } from './types';
+import { SpriteMode, SpriteAnchor, SpriteInterpolationOptions, SpriteImageOriginLocation, SpriteLocation, SpriteTextGlyphHorizontalAlign, SpriteTextureMagFilter, SpriteTextureMinFilter, SpriteInterpolationMode, SpriteScreenPoint, SpritePoint, SpriteEasing, SpriteImageLineAttributeState, SpriteImageState, SpriteInterpolatedValues, SpriteImageInterpolatedOffset } from './types';
+import { EasingFunction } from './interpolation/easing';
 import { ResolvedSpriteScalingOptions, SurfaceCorner } from './utils/math';
+import { RgbaColor } from './utils/color';
 /**
  * The handle value that using the instance.
  */
@@ -168,23 +170,24 @@ export interface SpriteMercatorCoordinate {
     readonly z: number;
 }
 /**
- * Mutable counterpart to {@link InterpolatedValues}, used internally so SpriteLayer
+ * Mutable counterpart to {@link SpriteInterpolatedValues}, used internally so SpriteLayer
  * can reuse object references while still exposing readonly snapshots publicly.
  */
-export interface MutableInterpolatedValues<T> {
+export interface MutableSpriteInterpolatedValues<T> extends SpriteInterpolatedValues<T> {
     current: T;
     from: T | undefined;
     to: T | undefined;
+    invalidated: boolean | undefined;
 }
-export interface MutableSpriteImageInterpolatedOffset {
-    offsetMeters: MutableInterpolatedValues<number>;
-    offsetDeg: MutableInterpolatedValues<number>;
+export interface MutableSpriteImageInterpolatedOffset extends SpriteImageInterpolatedOffset {
+    offsetMeters: MutableSpriteInterpolatedValues<number>;
+    offsetDeg: MutableSpriteInterpolatedValues<number>;
 }
 export interface Releasable {
     readonly release: () => void;
 }
 /**
- * Abstraction that exposes projection-related helpers.
+ * Mimimum abstraction that exposes projection-related helpers.
  */
 export interface ProjectionHost extends Releasable {
     /**
@@ -192,11 +195,16 @@ export interface ProjectionHost extends Releasable {
      * @returns Zoom level.
      */
     readonly getZoom: () => number;
+    /**
+     * Get camera location.
+     * @returns Camera location when viewport is available.
+     */
+    readonly getCameraLocation: () => SpriteLocation | undefined;
     /**
      * Extracts the current clip-space context if the mercator matrix is available.
-     * @returns {ClipContext | null} Clip context or `null` when the transform is not ready.
+     * @returns {ClipContext | undefined} Clip context or `undefined` when the transform is not ready.
      */
-    readonly getClipContext: () => ClipContext | null;
+    readonly getClipContext: () => ClipContext | undefined;
     /**
      * Get mercator coordinate from the location
      * @param location Location.
@@ -208,13 +216,13 @@ export interface ProjectionHost extends Releasable {
      * @param location Location.
      * @returns Projected point if valid location.
      */
-    readonly project: (location: Readonly<SpriteLocation>) => SpritePoint | null;
+    readonly project: (location: Readonly<SpriteLocation>) => SpritePoint | undefined;
     /**
      * Unproject the location.
      * @param point Projected point.
      * @returns Location if valid point.
      */
-    readonly unproject: (point: Readonly<SpritePoint>) => SpriteLocation | null;
+    readonly unproject: (point: Readonly<SpritePoint>) => SpriteLocation | undefined;
     /**
      * Calculate perspective ratio.
      * @param location Location.
@@ -222,7 +230,6 @@ export interface ProjectionHost extends Releasable {
      * @returns The ratio.
      */
     readonly calculatePerspectiveRatio: (location: Readonly<SpriteLocation>, cachedMercator?: SpriteMercatorCoordinate) => number;
-    readonly getCameraLocation: () => SpriteLocation | null;
 }
 export interface PrepareDrawSpriteImageParamsBase {
     readonly imageResources: ImageResourceTable;
@@ -233,7 +240,7 @@ export interface PrepareDrawSpriteImageParamsBase {
     readonly drawingBufferWidth: number;
     readonly drawingBufferHeight: number;
     readonly pixelRatio: number;
-    readonly clipContext: Readonly<ClipContext> | null;
+    readonly clipContext: Readonly<ClipContext> | undefined;
 }
 export interface PrepareDrawSpriteImageParamsBefore<TTag> extends PrepareDrawSpriteImageParamsBase {
     readonly bucket: readonly Readonly<RenderTargetEntryLike<TTag>>[];
@@ -402,7 +409,7 @@ export interface SpriteInterpolationState {
     readonly mode: SpriteInterpolationMode;
     readonly durationMs: number;
     readonly easing: EasingFunction;
-    readonly easingPreset: SpriteEasingPresetName | null;
+    readonly easingPreset: SpriteEasing;
     startTimestamp: number;
     readonly from: SpriteLocation;
     readonly to: SpriteLocation;
@@ -419,7 +426,7 @@ export interface SpriteInterpolationState {
 export interface DegreeInterpolationState {
     readonly durationMs: number;
     readonly easing: EasingFunction;
-    readonly easingPreset: SpriteEasingPresetName | null;
+    readonly easingPreset: SpriteEasing;
     readonly from: number;
     readonly to: number;
     readonly finalValue: number;
@@ -428,7 +435,7 @@ export interface DegreeInterpolationState {
 export interface DistanceInterpolationState {
     readonly durationMs: number;
     readonly easing: EasingFunction;
-    readonly easingPreset: SpriteEasingPresetName | null;
+    readonly easingPreset: SpriteEasing;
     readonly from: number;
     readonly to: number;
     readonly finalValue: number;
@@ -555,26 +562,34 @@ export type Canvas2DContext = CanvasRenderingContext2D | OffscreenCanvasRenderin
  * Canvas sources supported when rendering text glyphs.
  */
 export type Canvas2DSource = HTMLCanvasElement | OffscreenCanvas;
+/** Line definition resolved for rendering. */
+export interface ResolvedSpriteImageLineAttribute extends SpriteImageLineAttributeState {
+    readonly rgba: RgbaColor;
+}
 /**
  * Base attributes for an image that composes a sprite.
  */
-export interface InternalSpriteImageState {
+export interface InternalSpriteImageState extends SpriteImageState {
     subLayer: number;
     order: number;
     imageId: string;
     imageHandle: number;
     mode: SpriteMode;
-    opacity: MutableInterpolatedValues<number>;
+    opacity: MutableSpriteInterpolatedValues<number>;
     scale: number;
     anchor: Readonly<SpriteAnchor>;
+    border: ResolvedSpriteImageLineAttribute | undefined;
+    borderPixelWidth: number;
+    leaderLine: ResolvedSpriteImageLineAttribute | undefined;
+    leaderLinePixelWidth: number;
     offset: MutableSpriteImageInterpolatedOffset;
-    rotateDeg: MutableInterpolatedValues<number>;
+    rotateDeg: MutableSpriteInterpolatedValues<number>;
     rotationCommandDeg: number;
     displayedRotateDeg: number;
     autoRotation: boolean;
     autoRotationMinDistanceMeters: number;
     resolvedBaseRotateDeg: number;
-    originLocation?: Readonly<SpriteImageOriginLocation>;
+    originLocation: Readonly<SpriteImageOriginLocation> | undefined;
     originReferenceKey: SpriteOriginReferenceKey;
     originRenderTargetIndex: SpriteOriginReferenceIndex;
     rotationInterpolationState: Readonly<DegreeInterpolationState> | null;
@@ -606,7 +621,7 @@ export interface InternalSpriteCurrentState<TTag> {
     handle: IdHandle;
     isEnabled: boolean;
     visibilityDistanceMeters?: number;
-    location: MutableInterpolatedValues<Readonly<SpriteLocation>>;
+    location: MutableSpriteInterpolatedValues<Readonly<SpriteLocation>>;
     images: Map<number, Map<number, InternalSpriteImageState>>;
     tag: TTag | null;
     interpolationState: InternalSpriteInterpolationState | null;

package/dist/interpolation/degreeInterpolation.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.15.0
+ * version: 0.16.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: 8d2149a6811cac25ed9d8c1d97acde73e1a38e25
  */
 
 import { SpriteInterpolationOptions } from '../types';

package/dist/interpolation/distanceInterpolation.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.15.0
+ * version: 0.16.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: 8d2149a6811cac25ed9d8c1d97acde73e1a38e25
  */
 
 import { SpriteInterpolationOptions } from '../types';

package/dist/interpolation/easing.d.ts

@@ -1,24 +1,24 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.15.0
+ * version: 0.16.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: 8d2149a6811cac25ed9d8c1d97acde73e1a38e25
  */
 
-import { EasingFunction, SpriteEasingPresetName, SpriteInterpolationEasing } from '../types';
+import { SpriteEasing } from '../types';
+export type EasingFunction = (progress: number) => number;
 /**
  * Linear interpolation that clamps the value to the [0, 1] range.
  */
 export declare const linearEasing: EasingFunction;
 export interface ResolvedEasing {
     readonly easing: EasingFunction;
-    readonly preset: SpriteEasingPresetName | null;
+    readonly preset: SpriteEasing;
 }
 /**
- * Returns the provided easing function or falls back to linear interpolation.
- * When a preset name is supplied the resolved preset identifier is preserved for downstream consumers.
+ * Resolves an easing definition into its implementation, defaulting to linear when unspecified or unknown.
  */
-export declare const resolveEasing: (easing?: SpriteInterpolationEasing) => ResolvedEasing;
+export declare const resolveEasing: (easing?: SpriteEasing) => ResolvedEasing;

package/dist/interpolation/interpolation.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.15.0
+ * version: 0.16.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: 8d2149a6811cac25ed9d8c1d97acde73e1a38e25
  */
 
 import { SpriteInterpolationOptions, SpriteLocation } from '../types';

package/dist/interpolation/interpolationChannels.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.15.0
+ * version: 0.16.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: 8d2149a6811cac25ed9d8c1d97acde73e1a38e25
  */
 
 import { SpriteInterpolationOptions, SpriteImageOffset } from '../types';

package/dist/interpolation/rotationInterpolation.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.15.0
+ * version: 0.16.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: 8d2149a6811cac25ed9d8c1d97acde73e1a38e25
  */
 
 import { SpriteInterpolationOptions } from '../types';

package/dist/types.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.15.0
+ * version: 0.16.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: 8d2149a6811cac25ed9d8c1d97acde73e1a38e25
  */
 
 import { CustomLayerInterface } from 'maplibre-gl';
@@ -42,6 +42,15 @@ export interface SpriteImageOffset {
      */
     offsetDeg: number;
 }
+/**
+ * Line attribute.
+ */
+export interface SpriteImageLineAttribute {
+    /** CSS color string. Defaults to red. */
+    color?: string;
+    /** Line width in meters. Defaults to 1. */
+    widthMeters?: number;
+}
 /**
  * Anchor within the image.
  * The sprite's base coordinate maps to this location; range is -1.0 to 1.0 relative to image size.
@@ -73,18 +82,63 @@ export interface SpriteImageOriginLocation {
 }
 /** Defines movement interpolation modes. */
 export type SpriteInterpolationMode = 'feedback' | 'feedforward';
-/** Easing function signature used to map interpolation progress. */
-export type EasingFunction = (progress: number) => number;
-export type SpriteEasingPresetName = 'linear';
-export type SpriteInterpolationEasing = EasingFunction | SpriteEasingPresetName;
+export interface SpriteEasingLinear {
+    type: 'linear';
+}
+export interface SpriteEasingEase {
+    type: 'ease';
+    /** Power applied to the easing curve. Defaults to 3. */
+    power?: number;
+    /** Direction of the easing curve. Defaults to in-out. */
+    mode?: 'in' | 'out' | 'in-out';
+}
+export interface SpriteEasingExponential {
+    type: 'exponential';
+    /** Growth rate used by the exponential curve. Defaults to 5. */
+    exponent?: number;
+    /** Direction of the exponential curve. Defaults to in-out. */
+    mode?: 'in' | 'out' | 'in-out';
+}
+export interface SpriteEasingQuadratic {
+    type: 'quadratic';
+    /** Direction of the quadratic curve. Defaults to in-out. */
+    mode?: 'in' | 'out' | 'in-out';
+}
+export interface SpriteEasingCubic {
+    type: 'cubic';
+    /** Direction of the cubic curve. Defaults to in-out. */
+    mode?: 'in' | 'out' | 'in-out';
+}
+export interface SpriteEasingSine {
+    type: 'sine';
+    /** Direction of the sine ease. Defaults to in-out. */
+    mode?: 'in' | 'out' | 'in-out';
+    /** Multiplier applied to the sine amplitude. Defaults to 1. */
+    amplitude?: number;
+}
+export interface SpriteEasingBounce {
+    type: 'bounce';
+    /** Number of visible bounces before settling. Defaults to 3. */
+    bounces?: number;
+    /** Decay factor applied per bounce; range (0, 1]. Defaults to 0.5. */
+    decay?: number;
+}
+export interface SpriteEasingBack {
+    type: 'back';
+    /** Overshoot factor controlling how far past the target the curve goes. Defaults to 1.70158. */
+    overshoot?: number;
+}
+/** Union of supported easing definitions. */
+export type SpriteEasing = SpriteEasingLinear | SpriteEasingEase | SpriteEasingExponential | SpriteEasingQuadratic | SpriteEasingCubic | SpriteEasingSine | SpriteEasingBounce | SpriteEasingBack;
+export type SpriteEasingType = SpriteEasing['type'];
 /** Options for interpolating values. */
 export interface SpriteInterpolationOptions {
     /** Interpolation mode; defaults to feedback. */
     mode?: SpriteInterpolationMode;
     /** Duration in milliseconds. */
     durationMs: number;
-    /** Easing mapping applied to progress values. Accepts preset names or custom functions. Defaults to linear. */
-    easing?: SpriteInterpolationEasing;
+    /** Easing definition. Defaults to linear. */
+    easing?: SpriteEasing;
 }
 /** Interpolation configuration for rotateDeg and offsetDeg. */
 export interface SpriteImageInterpolationOptions {
@@ -113,6 +167,10 @@ export interface SpriteImageDefinitionInit {
     anchor?: SpriteAnchor;
     /** Offset from the sprite coordinate. Defaults to no offset. */
     offset?: SpriteImageOffset;
+    /** Optional border rendered around the image. */
+    border?: SpriteImageLineAttribute;
+    /** Optional leader line rendered toward the origin image. */
+    leaderLine?: SpriteImageLineAttribute;
     /**
      * Determines which coordinate to anchor against.
      * - Omitted: use the sprite base coordinate.
@@ -154,6 +212,10 @@ export interface SpriteImageDefinitionUpdate {
     anchor?: SpriteAnchor;
     /** Offset from the sprite coordinate. */
     offset?: SpriteImageOffset;
+    /** Border rendered around the image. Specify null to remove. */
+    border?: SpriteImageLineAttribute | null;
+    /** Leader line rendered toward the origin image. Specify null to remove. */
+    leaderLine?: SpriteImageLineAttribute | null;
     /** Additional rotation in degrees. */
     rotateDeg?: number;
     /** Enables auto-rotation toward the travel direction. */
@@ -184,11 +246,20 @@ export interface SpriteInit<TTag> {
     isEnabled?: boolean;
     /** Initial location. */
     location: SpriteLocation;
+    /**
+     * Marks the sprite as invalidated initially, causing interpolation parameters to be
+     * ignored until the first update drives the value again.
+     */
+    invalidate?: boolean;
     /**
      * Pseudo LOD threshold for the sprite. When the camera distance exceeds this value,
      * all images attached to the sprite become invisible.
      */
     visibilityDistanceMeters?: number;
+    /**
+     * Default interpolation settings applied to initial location updates until overridden.
+     */
+    interpolation?: SpriteInterpolationOptions;
     /** Array of zero or more images. */
     images: SpriteImageDefinitionInitEntry[];
     /** Optional tag value; null or omission means no tag. */
@@ -213,22 +284,33 @@ export type SpriteInitCollection<TTag> = Record<string, SpriteInit<TTag>> | read
  * Interpolated values.
  * @param T - Value type.
  */
-export interface InterpolatedValues<T> {
+export interface SpriteInterpolatedValues<T> {
     /** Current time value. */
     readonly current: T;
     /** Requested value. */
     readonly from: T | undefined;
     /** Will be reached value. */
     readonly to: T | undefined;
+    /** Marks whether the value was invalidated due to visibility changes. */
+    readonly invalidated: boolean | undefined;
 }
 /**
  * Offset with interpolation metadata for both distance and heading.
  */
 export interface SpriteImageInterpolatedOffset {
     /** Distance from the anchor in meters. */
-    readonly offsetMeters: InterpolatedValues<number>;
+    readonly offsetMeters: SpriteInterpolatedValues<number>;
     /** Heading describing the offset direction in degrees. */
-    readonly offsetDeg: InterpolatedValues<number>;
+    readonly offsetDeg: SpriteInterpolatedValues<number>;
+}
+/**
+ * Resolved line attribute state.
+ */
+export interface SpriteImageLineAttributeState {
+    /** CSS color string applied to the line. */
+    readonly color: string;
+    /** Line width in meters. */
+    readonly widthMeters: number;
 }
 /**
  * Sprite image state evaluated at runtime.
@@ -237,11 +319,13 @@ export interface SpriteImageInterpolatedOffset {
  * @property {number} order - Ordering slot within the sub-layer.
  * @property {string} imageId - Identifier of the registered image or glyph.
  * @property {SpriteMode} mode - Rendering mode applied to the image.
- * @property {InterpolatedValues<number>} opacity - Opacity multiplier applied when rendering, with interpolation metadata.
+ * @property {SpriteInterpolatedValues<number>} opacity - Opacity multiplier applied when rendering, with interpolation metadata.
  * @property {number} scale - Scale factor converting pixels to meters.
  * @property {Readonly<SpriteAnchor>} anchor - Anchor coordinates resolved for the image.
- * @property {Readonly<SpriteImageInterpolatedOffset>} offset - Offset applied relative to the anchor point, with interpolation metadata.
- * @property {InterpolatedValues<number>} rotateDeg - Additional rotation in degrees plus interpolation metadata.
+ * @property {SpriteImageInterpolatedOffset} offset - Offset applied relative to the anchor point, with interpolation metadata.
+ * @property {SpriteImageLineAttributeState | undefined} border - Border line attribute.
+ * @property {SpriteImageLineAttributeState | undefined} leaderLine - Leader line attribute.
+ * @property {SpriteInterpolatedValues<number>} rotateDeg - Additional rotation in degrees plus interpolation metadata.
  * @property {boolean} autoRotation - Indicates whether auto-rotation is active.
  * @property {number} autoRotationMinDistanceMeters - Minimum travel distance before auto-rotation updates.
  * @property {number} resolvedBaseRotateDeg - Internal base rotation resolved for the current frame.
@@ -262,14 +346,18 @@ export interface SpriteImageState {
     /** Anchor coordinates resolved for the image. */
     readonly anchor: Readonly<SpriteAnchor>;
     /** Opacity multiplier applied when rendering. */
-    readonly opacity: InterpolatedValues<number>;
+    readonly opacity: SpriteInterpolatedValues<number>;
     /** Offset applied relative to the anchor point. */
-    readonly offset: Readonly<SpriteImageInterpolatedOffset>;
+    readonly offset: SpriteImageInterpolatedOffset;
+    /** Optional border rendered around the image. */
+    readonly border: SpriteImageLineAttributeState | undefined;
+    /** Optional leader line rendered toward the origin image. */
+    readonly leaderLine: SpriteImageLineAttributeState | undefined;
     /**
      * Additional rotation in degrees with interpolation metadata.
      * `from`/`to` are `undefined` when no rotation animation is running.
      */
-    readonly rotateDeg: InterpolatedValues<number>;
+    readonly rotateDeg: SpriteInterpolatedValues<number>;
     /** Indicates whether auto-rotation is active. */
     readonly autoRotation: boolean;
     /** Minimum travel distance before auto-rotation updates. */
@@ -300,7 +388,7 @@ export interface SpriteCurrentState<TTag> {
      * Location information including current, source, and destination coordinates.
      * `from`/`to` are `undefined` when interpolation is inactive.
      */
-    readonly location: InterpolatedValues<Readonly<SpriteLocation>>;
+    readonly location: SpriteInterpolatedValues<Readonly<SpriteLocation>>;
     /** Current image states, grouped by sub-layer and order. */
     readonly images: ReadonlyMap<number, ReadonlyMap<number, SpriteImageState>>;
     /** Optional tag value; null indicates no tag. */
@@ -560,11 +648,6 @@ 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.
@@ -813,6 +896,12 @@ export interface SpriteLayerInterface<TTag = any> extends CustomLayerInterface {
      * @returns {number} Number of sprites that were updated.
      */
     readonly updateForEach: (updater: (sprite: SpriteCurrentState<TTag>, update: SpriteUpdaterEntry<TTag>) => boolean) => number;
+    /**
+     * Controls entire interpolation Calculation.
+     * When `false`, interpolation halts immediately and resumes smoothly from the paused state when re-enabled.
+     * @param moveable - Continuous calculation for movement interpolation when value is true.
+     */
+    readonly setInterpolationCalculation: (moveable: boolean) => void;
     /**
      * Adds an event listener.
      *

package/dist/utils/color.d.ts

@@ -0,0 +1,25 @@
+/*!
+ * name: maplibre-gl-layers
+ * version: 0.16.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: 8d2149a6811cac25ed9d8c1d97acde73e1a38e25
+ */
+
+/**
+ * Minimal CSS color parser used for resolving sprite border colors.
+ */
+export type RgbaColor = readonly [number, number, number, number];
+/**
+ * Parses a CSS color string into normalized RGBA values.
+ * Falls back to the supplied default when parsing fails.
+ *
+ * @param color CSS color string to parse.
+ * @param fallback Fallback value used when parsing fails.
+ * @returns Parsed RGBA tuple.
+ */
+export declare const parseCssColorToRgba: (color: string | undefined, fallback: RgbaColor) => RgbaColor;
+export declare const DEFAULT_BORDER_COLOR = "red";
+export declare const DEFAULT_BORDER_COLOR_RGBA: RgbaColor;

package/dist/utils/image.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.15.0
+ * version: 0.16.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: 8d2149a6811cac25ed9d8c1d97acde73e1a38e25
  */
 
 import { SpriteImageRegisterOptions } from '../types';

package/dist/utils/looseQuadTree.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.15.0
+ * version: 0.16.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: 8d2149a6811cac25ed9d8c1d97acde73e1a38e25
  */
 
 export interface Rect {