maplibre-gl-layers 0.4.0 → 0.6.0

package/dist/interpolation.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.4.0
+ * version: 0.6.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: 366a9e1190bfe770b4002a06284ff627188b5c76
+ * git.commit.hash: 481f544de02fd3e71a2ba6c28bbb7eeb98b49eff
  */
 
 import { EasingFunction, SpriteInterpolationMode, SpriteInterpolationOptions, SpriteLocation } from './types';

package/dist/location.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.4.0
+ * version: 0.6.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: 366a9e1190bfe770b4002a06284ff627188b5c76
+ * git.commit.hash: 481f544de02fd3e71a2ba6c28bbb7eeb98b49eff
  */
 
 import { SpriteLocation } from './types';

package/dist/math.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.4.0
+ * version: 0.6.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: 366a9e1190bfe770b4002a06284ff627188b5c76
+ * git.commit.hash: 481f544de02fd3e71a2ba6c28bbb7eeb98b49eff
  */
 
 import { SpriteAnchor, SpriteImageOffset, SpriteLocation, SpriteScalingOptions } from './types';
@@ -96,11 +96,12 @@ export declare const calculateDistanceAndBearingMeters: (from: SpriteLocation, t
  * @param {number} effectivePixelsPerMeter - Conversion between world meters and screen pixels.
  * @param {number} spriteMinPixel - Lower pixel clamp for the sprite's largest side.
  * @param {number} spriteMaxPixel - Upper pixel clamp for the sprite's largest side.
- * @returns {{ width: number; height: number }} Pixel dimensions after scaling and clamping.
+ * @returns {{ width: number; height: number; scaleAdjustment: number }} Pixel dimensions alongside the scale factor applied during clamping.
  */
 export declare const calculateBillboardPixelDimensions: (imageWidth: number | undefined, imageHeight: number | undefined, baseMetersPerPixel: number, imageScale: number, zoomScaleFactor: number, effectivePixelsPerMeter: number, spriteMinPixel: number, spriteMaxPixel: number) => {
     width: number;
     height: number;
+    scaleAdjustment: number;
 };
 /**
  * Computes the billboard offset in screen-space pixels.
@@ -108,9 +109,10 @@ export declare const calculateBillboardPixelDimensions: (imageWidth: number | un
  * @param {number} imageScale - User-provided scale multiplier applied to the offset distance.
  * @param {number} zoomScaleFactor - Zoom-dependent scale multiplier.
  * @param {number} effectivePixelsPerMeter - Conversion factor from meters to pixels.
+ * @param {number} [sizeScaleAdjustment=1] - Additional scale factor applied when sprite size is clamped.
  * @returns {{ x: number; y: number }} Screen-space offset relative to the billboard center.
  */
-export declare const calculateBillboardOffsetPixels: (offset: SpriteImageOffset | undefined, imageScale: number, zoomScaleFactor: number, effectivePixelsPerMeter: number) => {
+export declare const calculateBillboardOffsetPixels: (offset: SpriteImageOffset | undefined, imageScale: number, zoomScaleFactor: number, effectivePixelsPerMeter: number, sizeScaleAdjustment?: number) => {
     x: number;
     y: number;
 };
@@ -133,7 +135,7 @@ export declare const calculateBillboardAnchorShiftPixels: (halfWidth: number, ha
  * @param {number} baseMetersPerPixel - World meters represented by a pixel at the current zoom.
  * @param {number} imageScale - User-provided scale multiplier.
  * @param {number} zoomScaleFactor - Zoom-dependent scale multiplier.
- * @returns {{ width: number; height: number }} Dimensions expressed as world-space meters.
+ * @returns {{ width: number; height: number; scaleAdjustment: number }} World dimensions in meters and the applied clamp scale factor.
  */
 export declare const calculateSurfaceWorldDimensions: (imageWidth: number | undefined, imageHeight: number | undefined, baseMetersPerPixel: number, imageScale: number, zoomScaleFactor: number, options?: {
     effectivePixelsPerMeter?: number;
@@ -142,6 +144,7 @@ export declare const calculateSurfaceWorldDimensions: (imageWidth: number | unde
 }) => {
     width: number;
     height: number;
+    scaleAdjustment: number;
 };
 /**
  * Computes east/north shifts from anchor rotation on surface images.
@@ -160,9 +163,10 @@ export declare const calculateSurfaceAnchorShiftMeters: (halfWidthMeters: number
  * @param {SpriteImageOffset | undefined} offset - Offset configuration for the surface sprite.
  * @param {number} imageScale - User-provided scale multiplier applied to the offset distance.
  * @param {number} zoomScaleFactor - Zoom-dependent scale multiplier.
+ * @param {number} [sizeScaleAdjustment=1] - Additional scale factor applied when sprite size is clamped.
  * @returns {{ east: number; north: number }} Offset vector in meters.
  */
-export declare const calculateSurfaceOffsetMeters: (offset: SpriteImageOffset | undefined, imageScale: number, zoomScaleFactor: number) => {
+export declare const calculateSurfaceOffsetMeters: (offset: SpriteImageOffset | undefined, imageScale: number, zoomScaleFactor: number, sizeScaleAdjustment?: number) => {
     east: number;
     north: number;
 };
@@ -435,7 +439,7 @@ export type SurfaceCenterParams = {
  * Output describing the resolved surface center and displacement details.
  * @typedef SurfaceCenterResult
  * @property {{ x: number; y: number } | null} center - Projected screen coordinates or `null` when projection fails.
- * @property {{ width: number; height: number }} worldDimensions - Sprite dimensions in world meters.
+ * @property {{ width: number; height: number; scaleAdjustment: number }} worldDimensions - Sprite dimensions in world meters.
  * @property {{ east: number; north: number }} totalDisplacement - Combined anchor and offset displacement in meters.
  * @property {SpriteLocation} displacedLngLat - Geographic coordinates after applying displacement.
  * @property {{ x: number; y: number } | null | undefined} [anchorlessCenter] - Anchorless screen coordinates when requested.
@@ -450,6 +454,7 @@ export type SurfaceCenterResult = {
     worldDimensions: {
         width: number;
         height: number;
+        scaleAdjustment: number;
     };
     totalDisplacement: {
         east: number;

package/dist/numericInterpolation.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.4.0
+ * version: 0.6.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: 366a9e1190bfe770b4002a06284ff627188b5c76
+ * git.commit.hash: 481f544de02fd3e71a2ba6c28bbb7eeb98b49eff
  */
 
 import { EasingFunction, SpriteNumericInterpolationOptions } from './types';

package/dist/rotationInterpolation.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.4.0
+ * version: 0.6.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: 366a9e1190bfe770b4002a06284ff627188b5c76
+ * git.commit.hash: 481f544de02fd3e71a2ba6c28bbb7eeb98b49eff
  */
 
 import { SpriteNumericInterpolationOptions } from './types';

package/dist/types.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.4.0
+ * version: 0.6.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: 366a9e1190bfe770b4002a06284ff627188b5c76
+ * git.commit.hash: 481f544de02fd3e71a2ba6c28bbb7eeb98b49eff
  */
 
 import { CustomLayerInterface } from 'maplibre-gl';
@@ -481,17 +481,50 @@ export declare const UNLIMITED_SPRITE_SCALING_OPTIONS: SpriteScalingOptions;
  * metersPerPixel is 1.
  */
 export declare const STANDARD_SPRITE_SCALING_OPTIONS: SpriteScalingOptions;
+/**
+ * Allowed minification filters for sprite textures.
+ */
+export type SpriteTextureMinFilter = 'nearest' | 'linear' | 'nearest-mipmap-nearest' | 'nearest-mipmap-linear' | 'linear-mipmap-nearest' | 'linear-mipmap-linear';
+/**
+ * Allowed magnification filters for sprite textures.
+ */
+export type SpriteTextureMagFilter = 'nearest' | 'linear';
+/**
+ * Texture filtering configuration.
+ *
+ * @property {SpriteTextureMinFilter | undefined} minFilter - Minification filter to apply (defaults to `linear`).
+ * @property {SpriteTextureMagFilter | undefined} magFilter - Magnification filter to apply (defaults to `linear`).
+ * @property {boolean | undefined} generateMipmaps - Generates mipmaps during upload when true (defaults to `false`).
+ * @property {number | undefined} maxAnisotropy - Desired anisotropy factor (>= 1) when EXT_texture_filter_anisotropic is available.
+ */
+export interface SpriteTextureFilteringOptions {
+    minFilter?: SpriteTextureMinFilter;
+    magFilter?: SpriteTextureMagFilter;
+    generateMipmaps?: boolean;
+    maxAnisotropy?: number;
+}
+/**
+ * Defaulted text filtering options.
+ */
+export declare const DEFAULT_TEXTURE_FILTERING_OPTIONS: SpriteTextureFilteringOptions;
+/**
+ * Better text filtering options than default options.
+ */
+export declare const BETTER_TEXTURE_FILTERING_OPTIONS: SpriteTextureFilteringOptions;
 /**
  * Options accepted when creating a SpriteLayer.
  *
  * @property {string | undefined} id - Optional layer identifier supplied to MapLibre.
  * @property {SpriteScalingOptions | undefined} spriteScaling - Optional scaling controls. Default is UNLIMITED_SPRITE_SCALING_OPTIONS.
+ * @property {SpriteTextureFilteringOptions | undefined} textureFiltering - Optional texture filtering overrides.
  */
 export interface SpriteLayerOptions {
     /** Optional layer identifier supplied to MapLibre. */
     id?: string;
     /** Optional scaling controls. */
     spriteScaling?: SpriteScalingOptions;
+    /** Optional texture filtering configuration. */
+    textureFiltering?: SpriteTextureFilteringOptions;
 }
 /** Horizontal alignment options for text glyphs. */
 export type SpriteTextGlyphHorizontalAlign = 'left' | 'center' | 'right';

package/dist/utils.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.4.0
+ * version: 0.6.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: 366a9e1190bfe770b4002a06284ff627188b5c76
+ * git.commit.hash: 481f544de02fd3e71a2ba6c28bbb7eeb98b49eff
  */
 
 /**

package/package.json

@@ -1,20 +1,20 @@
 {
   "git": {
     "tags": [
-      "0.4.0"
+      "0.6.0"
     ],
     "branches": [
       "main"
     ],
-    "version": "0.4.0",
+    "version": "0.6.0",
     "commit": {
-      "hash": "366a9e1190bfe770b4002a06284ff627188b5c76",
-      "shortHash": "366a9e1",
-      "date": "2025-10-29T22:23:19+09:00Z",
+      "hash": "481f544de02fd3e71a2ba6c28bbb7eeb98b49eff",
+      "shortHash": "481f544",
+      "date": "2025-10-30T14:50:01+09:00Z",
       "message": "Merge branch 'develop'"
     }
   },
-  "version": "0.4.0",
+  "version": "0.6.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",