maplibre-gl-layers 0.1.0 → 0.3.0

package/dist/interpolation.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.1.0
+ * version: 0.3.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: 88b09a93779279947d9c6b1e3a7538d4d197dbcb
+ * git.commit.hash: fd90d1fd66e4ca9c0defa49e68ecaeb9c14fbd06
  */
 
 import { EasingFunction, SpriteInterpolationMode, SpriteInterpolationOptions, SpriteLocation } from './types';

package/dist/location.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.1.0
+ * version: 0.3.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: 88b09a93779279947d9c6b1e3a7538d4d197dbcb
+ * git.commit.hash: fd90d1fd66e4ca9c0defa49e68ecaeb9c14fbd06
  */
 
 import { SpriteLocation } from './types';

package/dist/math.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.1.0
+ * version: 0.3.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: 88b09a93779279947d9c6b1e3a7538d4d197dbcb
+ * git.commit.hash: fd90d1fd66e4ca9c0defa49e68ecaeb9c14fbd06
  */
 
 import { SpriteAnchor, SpriteImageOffset, SpriteLocation, SpriteScalingOptions } from './types';
@@ -185,6 +185,18 @@ export declare const applySurfaceDisplacement: (baseLng: number, baseLat: number
  * @returns {[number, number]} Clip-space coordinates in the range [-1, 1].
  */
 export declare const screenToClip: (x: number, y: number, drawingBufferWidth: number, drawingBufferHeight: number, pixelRatio: number) => [number, number];
+/**
+ * Converts homogeneous clip coordinates back into screen-space pixels.
+ * @param {[number, number, number, number]} clipPosition - Homogeneous clip coordinates.
+ * @param {number} drawingBufferWidth - WebGL drawing buffer width in device pixels.
+ * @param {number} drawingBufferHeight - WebGL drawing buffer height in device pixels.
+ * @param {number} pixelRatio - Device pixel ratio relating CSS pixels to device pixels.
+ * @returns {{ x: number; y: number } | null} Screen-space coordinates or `null` when invalid.
+ */
+export declare const clipToScreen: (clipPosition: readonly [number, number, number, number], drawingBufferWidth: number, drawingBufferHeight: number, pixelRatio: number) => {
+    x: number;
+    y: number;
+} | null;
 /**
  * Index order used to decompose a quad into two triangles.
  * @constant
@@ -387,7 +399,13 @@ export declare const calculateBillboardCornerScreenPositions: (params: Billboard
  * @property {number} totalRotateDeg - Rotation applied to the sprite in degrees.
  * @property {SpriteAnchor} [anchor] - Anchor definition normalized between -1 and 1.
  * @property {SpriteImageOffset} [offset] - Offset definition applied in meters/deg.
- * @property {ProjectLngLatFn} project - Projection function mapping longitude/latitude to screen space.
+ * @property {ProjectLngLatFn} [project] - Projection function mapping longitude/latitude to screen space.
+ * @property {ProjectToClipSpaceFn} [projectToClipSpace] - Projection into clip space when available.
+ * @property {number} [drawingBufferWidth] - WebGL drawing buffer width in device pixels.
+ * @property {number} [drawingBufferHeight] - WebGL drawing buffer height in device pixels.
+ * @property {number} [pixelRatio] - Device pixel ratio relating CSS pixels to device pixels.
+ * @property {number} [altitudeMeters] - Altitude used when projecting points into clip space.
+ * @property {boolean} [resolveAnchorless] - When true, also computes the anchorless center.
  */
 export type SurfaceCenterParams = {
     baseLngLat: SpriteLocation;
@@ -399,7 +417,13 @@ export type SurfaceCenterParams = {
     totalRotateDeg: number;
     anchor?: SpriteAnchor;
     offset?: SpriteImageOffset;
-    project: ProjectLngLatFn;
+    project?: ProjectLngLatFn;
+    projectToClipSpace?: ProjectToClipSpaceFn;
+    drawingBufferWidth?: number;
+    drawingBufferHeight?: number;
+    pixelRatio?: number;
+    altitudeMeters?: number;
+    resolveAnchorless?: boolean;
 };
 /**
  * Output describing the resolved surface center and displacement details.
@@ -408,6 +432,9 @@ export type SurfaceCenterParams = {
  * @property {{ width: number; height: 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.
+ * @property {{ east: number; north: number } | undefined} [anchorlessDisplacement] - Offset-only displacement when requested.
+ * @property {SpriteLocation | undefined} [anchorlessLngLat] - Anchorless geographic coordinate when requested.
  */
 export type SurfaceCenterResult = {
     center: {
@@ -423,6 +450,15 @@ export type SurfaceCenterResult = {
         north: number;
     };
     displacedLngLat: SpriteLocation;
+    anchorlessCenter?: {
+        x: number;
+        y: number;
+    } | null;
+    anchorlessDisplacement?: {
+        east: number;
+        north: number;
+    };
+    anchorlessLngLat?: SpriteLocation;
 };
 /**
  * Calculates the projected center of a surface sprite and derives related world-space displacements.

package/dist/numericInterpolation.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.1.0
+ * version: 0.3.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: 88b09a93779279947d9c6b1e3a7538d4d197dbcb
+ * git.commit.hash: fd90d1fd66e4ca9c0defa49e68ecaeb9c14fbd06
  */
 
 import { EasingFunction, SpriteNumericInterpolationOptions } from './types';

package/dist/rotationInterpolation.d.ts

@@ -1,11 +1,11 @@
 /*!
  * name: maplibre-gl-layers
- * version: 0.1.0
+ * version: 0.3.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: 88b09a93779279947d9c6b1e3a7538d4d197dbcb
+ * git.commit.hash: fd90d1fd66e4ca9c0defa49e68ecaeb9c14fbd06
  */
 
 import { SpriteNumericInterpolationOptions } from './types';