maplibre-gl-layers 0.14.0 → 0.16.0

package/package.json

@@ -1,20 +1,20 @@
 {
   "git": {
     "tags": [
-      "0.14.0"
+      "0.16.0"
     ],
     "branches": [
       "main"
     ],
-    "version": "0.14.0",
+    "version": "0.16.0",
     "commit": {
-      "hash": "a531802b05777e1f54a8828a247254293df1415d",
-      "shortHash": "a531802",
-      "date": "2025-11-12T18:13:49+09:00Z",
+      "hash": "8d2149a6811cac25ed9d8c1d97acde73e1a38e25",
+      "shortHash": "8d2149a",
+      "date": "2025-11-18T18:12:19+09:00Z",
       "message": "Merge branch 'develop'"
     }
   },
-  "version": "0.14.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",
@@ -56,7 +56,6 @@
     "build": "node ./scripts/build-wasm.mjs && vite build",
     "dev": "npm run build",
     "test": "npm run build && vitest run",
-    "test:e2e": "npm run build && playwright test",
     "pack": "npm run build && screw-up pack --pack-destination ../artifacts"
   },
   "dependencies": {
@@ -64,7 +63,6 @@
     "maplibre-gl": ">=5.0.0"
   },
   "devDependencies": {
-    "@playwright/test": ">=1.56.0",
     "@types/node": ">=24.9.0",
     "prettier-max": ">=1.11.0",
     "screw-up": ">=1.13.0",

package/dist/distanceInterpolation.d.ts

@@ -1,33 +0,0 @@
-/*!
- * name: maplibre-gl-layers
- * version: 0.14.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: a531802b05777e1f54a8828a247254293df1415d
- */
-
-import { SpriteInterpolationOptions } from './types';
-import { DistanceInterpolationState } from './internalTypes';
-export interface CreateDistanceInterpolationStateParams {
-    currentValue: number;
-    targetValue: number;
-    previousCommandValue?: number;
-    options: SpriteInterpolationOptions;
-}
-export interface CreateDistanceInterpolationStateResult {
-    readonly state: DistanceInterpolationState;
-    readonly requiresInterpolation: boolean;
-}
-export declare const createDistanceInterpolationState: (params: CreateDistanceInterpolationStateParams) => CreateDistanceInterpolationStateResult;
-export interface EvaluateDistanceInterpolationParams {
-    state: DistanceInterpolationState;
-    timestamp: number;
-}
-export interface EvaluateDistanceInterpolationResult {
-    readonly value: number;
-    readonly completed: boolean;
-    readonly effectiveStartTimestamp: number;
-}
-export declare const evaluateDistanceInterpolation: (params: EvaluateDistanceInterpolationParams) => EvaluateDistanceInterpolationResult;

package/dist/easing.d.ts

@@ -1,19 +0,0 @@
-/*!
- * name: maplibre-gl-layers
- * version: 0.14.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: a531802b05777e1f54a8828a247254293df1415d
- */
-
-import { EasingFunction } from './types';
-/**
- * Linear interpolation that clamps the value to the [0, 1] range.
- */
-export declare const linearEasing: EasingFunction;
-/**
- * Returns the provided easing function or falls back to linear interpolation.
- */
-export declare const resolveEasing: (easing?: EasingFunction) => EasingFunction;

package/dist/shader.d.ts

@@ -1,101 +0,0 @@
-/*!
- * name: maplibre-gl-layers
- * version: 0.14.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: a531802b05777e1f54a8828a247254293df1415d
- */
-
-import { SpriteAnchor, SpriteScreenPoint } from './types';
-import { PreparedDrawSpriteImageParams, Releaseable } from './internalTypes';
-/** Number of components per vertex (clipPosition.xyzw + uv.xy). */
-export declare const VERTEX_COMPONENT_COUNT = 6;
-/** Component count for clip-space position attributes. */
-export declare const POSITION_COMPONENT_COUNT = 4;
-/** Component count for UV attributes. */
-export declare const UV_COMPONENT_COUNT = 2;
-/** Byte size of a Float32. */
-export declare const FLOAT_SIZE: number;
-/** Stride per vertex in bytes. */
-export declare const VERTEX_STRIDE: number;
-/** Byte offset for the UV attribute. */
-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];
-/** 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. */
-export declare const SURFACE_BASE_CORNERS: ReadonlyArray<readonly [number, number]>;
-export declare const computeBillboardCornersShaderModel: ({ center, halfWidth, halfHeight, anchor, rotationDeg, }: {
-    center: Readonly<SpriteScreenPoint>;
-    halfWidth: number;
-    halfHeight: number;
-    anchor?: Readonly<SpriteAnchor>;
-    rotationDeg: number;
-}) => Array<{
-    x: number;
-    y: number;
-    u: number;
-    v: number;
-}>;
-/**
- * Compiles a shader from source, throwing if compilation fails.
- * @param {WebGLRenderingContext} glContext - Active WebGL context.
- * @param {number} type - Shader type (`VERTEX_SHADER` or `FRAGMENT_SHADER`).
- * @param {string} source - GLSL source code.
- * @returns {WebGLShader} Compiled shader object.
- * @throws When shader creation or compilation fails.
- */
-export declare const compileShader: (glContext: WebGLRenderingContext, type: number, source: string) => WebGLShader;
-/**
- * Links a vertex and fragment shader into a WebGL program.
- * @param {WebGLRenderingContext} glContext - Active WebGL context.
- * @param {string} vertexSource - Vertex shader GLSL source.
- * @param {string} fragmentSource - Fragment shader GLSL source.
- * @returns {WebGLProgram} Linked shader program ready for use.
- * @throws When linking fails or a program cannot be created.
- */
-export declare const createShaderProgram: (glContext: WebGLRenderingContext, vertexSource: string, fragmentSource: string) => WebGLProgram;
-export interface SpriteDrawProgram<TTag> extends Releaseable {
-    beginFrame(): void;
-    uploadVertexBatch(items: PreparedDrawSpriteImageParams<TTag>[]): void;
-    draw(prepared: PreparedDrawSpriteImageParams<TTag>): boolean;
-}
-export declare const createSpriteDrawProgram: <TTag>(glContext: WebGLRenderingContext) => SpriteDrawProgram<TTag>;
-export interface DebugOutlineRenderer extends Releaseable {
-    begin(screenToClipScaleX: number, screenToClipScaleY: number, screenToClipOffsetX: number, screenToClipOffsetY: number): void;
-    drawOutline(corners: readonly [
-        SpriteScreenPoint,
-        SpriteScreenPoint,
-        SpriteScreenPoint,
-        SpriteScreenPoint
-    ]): void;
-    end(): void;
-}
-export declare const createDebugOutlineRenderer: (glContext: WebGLRenderingContext) => DebugOutlineRenderer;