maplibre-gl-layers 0.15.0 → 0.16.0

package/dist/utils/math.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 { SpriteAnchor, SpriteImageOffset, SpriteLocation, SpritePoint, SpriteScalingOptions, SpriteScreenPoint } from '../types';
@@ -203,25 +203,25 @@ export declare const calculateEffectivePixelsPerMeter: (metersPerPixelAtLatitude
  * Projects a geographic coordinate and elevation into homogeneous clip space.
  * @typedef ProjectToClipSpaceFn
  * @param {number} location - Location in degrees.
- * @returns {[number, number, number, number] | null} Homogeneous clip coordinates or `null` when outside the view.
+ * @returns {[number, number, number, number] | undefined} Homogeneous clip coordinates or `undefined` when outside the view.
  */
-export type ProjectToClipSpaceFn = (location: Readonly<SpriteLocation>) => [number, number, number, number] | null;
+export type ProjectToClipSpaceFn = (location: Readonly<SpriteLocation>) => [number, number, number, number] | undefined;
 /**
  * Unprojects a screen-space point back to longitude/latitude.
  * @typedef UnprojectPointFn
  * @param {SpriteScreenPoint} point - Screen-space coordinates in pixels.
- * @returns {SpriteLocation | null} Geographic location or `null` when unprojection fails.
+ * @returns {SpriteLocation | undefined} Geographic location or `undefined` when unprojection fails.
  */
-export type UnprojectPointFn = (point: Readonly<SpriteScreenPoint>) => SpriteLocation | null;
+export type UnprojectPointFn = (point: Readonly<SpriteScreenPoint>) => SpriteLocation | undefined;
 /**
  * Resolves a depth key for billboards by sampling the clip-space Z at the sprite center.
  * @param {SpriteScreenPoint} center - Screen-space center of the billboard in pixels.
  * @param {SpriteLocation} spriteLocation - Geographic location including optional altitude.
  * @param {UnprojectPointFn} unproject - Function for converting screen coordinates to geographic coordinates.
  * @param {ProjectToClipSpaceFn} projectToClipSpace - Function that projects a geographic coordinate to clip space.
- * @returns {number | null} Negative normalized device coordinate Z used for depth sorting, or `null` when unavailable.
+ * @returns {number | undefined} Negative normalized device coordinate Z used for depth sorting, or `undefined` when unavailable.
  */
-export declare const calculateBillboardDepthKey: (center: Readonly<SpriteScreenPoint>, unproject: UnprojectPointFn, projectToClipSpace: ProjectToClipSpaceFn) => number | null;
+export declare const calculateBillboardDepthKey: (center: Readonly<SpriteScreenPoint>, unproject: UnprojectPointFn, projectToClipSpace: ProjectToClipSpaceFn) => number | undefined;
 /**
  * Signature for surface depth bias callbacks that tweak clip-space Z/W.
  * @typedef SurfaceDepthBiasFn
@@ -242,19 +242,19 @@ export type SurfaceDepthBiasFn = (params: {
  * @param {readonly SurfaceCorner[]} displacements - Corner offsets in meters from the center.
  * @param {ProjectToClipSpaceFn} projectToClipSpace - Projection function used to reach clip space.
  * @param {{ readonly indices?: readonly number[]; readonly biasFn?: SurfaceDepthBiasFn }} [options] - Optional overrides.
- * @returns {number | null} Depth key suitable for sorting, or `null` when any corner cannot be projected.
+ * @returns {number | undefined} Depth key suitable for sorting, or `undefined` when any corner cannot be projected.
  */
 export declare const calculateSurfaceDepthKey: (baseLngLat: Readonly<SpriteLocation>, displacements: readonly SurfaceCorner[], projectToClipSpace: ProjectToClipSpaceFn, options?: {
     readonly indices?: readonly number[];
     readonly biasFn?: SurfaceDepthBiasFn;
-}) => number | null;
+}) => number | undefined;
 /**
  * Projects a longitude/latitude pair to screen-space pixels.
  * @typedef ProjectLngLatFn
  * @param {SpriteLocation} lngLat - Geographic coordinate to project.
- * @returns {SpriteScreenPoint | null} Screen coordinates or `null` when projection fails.
+ * @returns {SpriteScreenPoint | undefined} Screen coordinates or `undefined` when projection fails.
  */
-export type ProjectLngLatFn = (lngLat: Readonly<SpriteLocation>) => SpriteScreenPoint | null;
+export type ProjectLngLatFn = (lngLat: Readonly<SpriteLocation>) => SpriteScreenPoint | undefined;
 /**
  * Parameters required to resolve a billboard center position.
  * @typedef BillboardCenterParams
@@ -304,6 +304,7 @@ export interface BillboardCenterResult {
     pixelHeight: number;
     anchorShift: SpritePoint;
     offsetShift: SpritePoint;
+    scaleAdjustment: number;
 }
 /**
  * Calculates the final billboard center position, applying scaling, anchor, and offset adjustments.
@@ -398,7 +399,7 @@ export interface SurfaceCenterParams {
 /**
  * Output describing the resolved surface center and displacement details.
  * @typedef SurfaceCenterResult
- * @property {SpriteScreenPoint | null} center - Projected screen coordinates or `null` when projection fails.
+ * @property {SpriteScreenPoint | undefined} center - Projected screen coordinates or `undefined` when projection fails.
  * @property {{ width: number; height: number; scaleAdjustment: number }} worldDimensions - Sprite dimensions in world meters.
  * @property {SurfaceCorner} totalDisplacement - Combined anchor and offset displacement in meters.
  * @property {SpriteLocation} displacedLngLat - Geographic coordinates after applying displacement.
@@ -407,7 +408,7 @@ export interface SurfaceCenterParams {
  * @property {SpriteLocation | undefined} [anchorlessLngLat] - Anchorless geographic coordinate when requested.
  */
 export interface SurfaceCenterResult {
-    center: Readonly<SpriteScreenPoint> | null;
+    center: Readonly<SpriteScreenPoint> | undefined;
     worldDimensions: Readonly<{
         width: number;
         height: number;

package/dist/utils/utils.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 { ImageHandleBufferController, IdHandler, RenderTargetBucketBuffers, RenderTargetEntryLike, SpriteOriginReference } from '../internalTypes';

package/dist/wasm/config.json.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
  */
 
 declare const _default: {

package/package.json

@@ -1,20 +1,20 @@
 {
   "git": {
     "tags": [
-      "0.15.0"
+      "0.16.0"
     ],
     "branches": [
       "main"
     ],
-    "version": "0.15.0",
+    "version": "0.16.0",
     "commit": {
-      "hash": "d850b7e9c713f54f0630248dc4ea370721b6965b",
-      "shortHash": "d850b7e",
-      "date": "2025-11-15T21:29:11+09:00Z",
+      "hash": "8d2149a6811cac25ed9d8c1d97acde73e1a38e25",
+      "shortHash": "8d2149a",
+      "date": "2025-11-18T18:12:19+09:00Z",
       "message": "Merge branch 'develop'"
     }
   },
-  "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",