leaflet-city-mapper 0.0.9 → 0.1.1

package/src/controls/pitchDragAddHooks.js

@@ -2,7 +2,7 @@ import { cameraDragSensitivity } from '../globals/cameraDragSensitivity.js';
 import { dragCamera } from './dragCamera.js';
 import { acceptPitchDrag } from './acceptPitchDrag.js';
 
-
+/** Install camera pitch and orbit dragging on this handler's map container. */
 export function pitchDragAddHooks() {
   this._dragState = dragCamera(this._map, this._map.getContainer(), acceptPitchDrag, cameraDragSensitivity, true);
 }

package/src/controls/pitchDragRemoveHooks.js

@@ -1,5 +1,6 @@
 import { removeCameraDrag } from './removeCameraDrag.js';
 
+/** Remove this handler's camera drag listeners. */
 export function pitchDragRemoveHooks() {
   removeCameraDrag(this._dragState);
 }

package/src/controls/refreshRotateControl.js

@@ -1,6 +1,8 @@
 import { radians } from '../globals/radians.js';
 import { mapGetPitch } from '../camera/mapGetPitch.js';
 import { mapGetBearing } from '../camera/mapGetBearing.js';
+
+/** Update this rotate control's arrow, accessible description and visibility. */
 export function refreshRotateControl() {
   const map = this._map, pitch = this.options.visualizePitch ? mapGetPitch(map) : 0;
   this._arrow.style.transform = `scale(${1 / Math.sqrt(Math.max(0.01, Math.abs(Math.cos(pitch * radians))))}) rotateX(${pitch}deg) rotate(${mapGetBearing(map)}deg)`;

package/src/controls/refreshRotateFocus.js

@@ -1,5 +1,6 @@
 import { refreshRotateControl } from './refreshRotateControl.js';
 
-export function refreshRotateFocus() {
-  refreshRotateControl.call(this._rotateControl);
+/** Refresh the rotate control associated with this button after focus changes. */
+export function refreshRotateFocus() {
+  refreshRotateControl.call(this._rotateControl);
 }

package/src/controls/removeCameraDrag.js

@@ -1,26 +1,29 @@
 import { dragStates } from '../weakmaps/dragStates.js';
 import { cameraDrags } from '../globals/cameraDrags.js';
-
 import { finishCameraDrag } from './finishCameraDrag.js';
 import { cameraDragDown } from './cameraDragDown.js';
 import { cameraDragMove } from './cameraDragMove.js';
 import { cameraDragEnd } from './cameraDragEnd.js';
 import { cameraDragClick } from './cameraDragClick.js';
 import { cameraDragContextMenu } from './cameraDragContextMenu.js';
-
 import { endAllCameraDrags } from './endAllCameraDrags.js';
 
-export function removeCameraDrag(state) {
-  finishCameraDrag(state);
-  const { element } = state;
-  element.removeEventListener('pointerdown', cameraDragDown, true);
-  element.removeEventListener('pointermove', cameraDragMove);
-  element.removeEventListener('pointerup', cameraDragEnd);
-  element.removeEventListener('pointercancel', cameraDragEnd);
-  element.removeEventListener('lostpointercapture', cameraDragEnd);
-  element.removeEventListener('click', cameraDragClick, true);
-  element.removeEventListener('contextmenu', cameraDragContextMenu);
-  dragStates.value.delete(element);
-  cameraDrags.value.delete(state);
-  if (!cameraDrags.value.size) window.removeEventListener('blur', endAllCameraDrags);
+/**
+ * Finish a drag and remove its element and shared blur listeners.
+ *
+ * @param {Object} state Registered camera drag state.
+ */
+export function removeCameraDrag(state) {
+  finishCameraDrag(state);
+  const { element } = state;
+  element.removeEventListener('pointerdown', cameraDragDown, true);
+  element.removeEventListener('pointermove', cameraDragMove);
+  element.removeEventListener('pointerup', cameraDragEnd);
+  element.removeEventListener('pointercancel', cameraDragEnd);
+  element.removeEventListener('lostpointercapture', cameraDragEnd);
+  element.removeEventListener('click', cameraDragClick, true);
+  element.removeEventListener('contextmenu', cameraDragContextMenu);
+  dragStates.value.delete(element);
+  cameraDrags.value.delete(state);
+  if (!cameraDrags.value.size) window.removeEventListener('blur', endAllCameraDrags);
 }

package/src/controls/resizeMap.js

@@ -1,3 +1,8 @@
-export function resizeMap(entries) {
-  entries[0]?.target._containerResizeMap.invalidateSize();
+/**
+ * Invalidate the map size associated with the first observed container.
+ *
+ * @param {Array<ResizeObserverEntry>} entries Resize observer entries.
+ */
+export function resizeMap(entries) {
+  entries[0]?.target._containerResizeMap.invalidateSize();
 }

package/src/controls/rotateButtonClick.js

@@ -1,11 +1,16 @@
 import { cameraFocusOptions } from '../globals/cameraFocusOptions.js';
-import { mapResetNorthPitch } from '../camera/mapResetNorthPitch.js';
-import { mapResetNorth } from '../camera/mapResetNorth.js';
-
-export function rotateButtonClick(event) {
-  const control = this._rotateControl, map = control._map;
-  event.preventDefault();
-  if (control.options.visualizePitch) mapResetNorthPitch(map);
-  else mapResetNorth(map);
-  if (event.detail) map.getContainer().focus(cameraFocusOptions);
-}
+import { mapResetNorthPitch } from '../camera/mapResetNorthPitch.js';
+import { mapResetNorth } from '../camera/mapResetNorth.js';
+
+/**
+ * Reset bearing and optionally pitch from the rotate control button.
+ *
+ * @param {MouseEvent} event Button click event.
+ */
+export function rotateButtonClick(event) {
+  const control = this._rotateControl, map = control._map;
+  event.preventDefault();
+  if (control.options.visualizePitch) mapResetNorthPitch(map);
+  else mapResetNorth(map);
+  if (event.detail) map.getContainer().focus(cameraFocusOptions);
+}

package/src/controls/rotateButtonKeydown.js

@@ -2,14 +2,20 @@ import { mapSetBearing } from '../camera/mapSetBearing.js';
 import { mapGetBearing } from '../camera/mapGetBearing.js';
 import { mapSetPitch } from '../camera/mapSetPitch.js';
 import { mapGetPitch } from '../camera/mapGetPitch.js';
-export function rotateButtonKeydown(event) {
-  const control = this._rotateControl, map = control._map, step = event.shiftKey ? 15 : 5;
-  if (event.key === 'ArrowLeft') mapSetBearing(map, mapGetBearing(map) - step);
-  else if (event.key === 'ArrowRight') mapSetBearing(map, mapGetBearing(map) + step);
-  else if (event.key === 'ArrowUp' && control.options.visualizePitch) mapSetPitch(map, mapGetPitch(map) + step);
-  else if (event.key === 'ArrowDown' && control.options.visualizePitch) mapSetPitch(map, mapGetPitch(map) - step);
-  else if (event.key === 'Home' || event.key === ' ') this.click();
-  else return;
-  event.preventDefault();
-  event.stopPropagation();
+
+/**
+ * Adjust camera angles or reset the rotate control using keyboard shortcuts.
+ *
+ * @param {KeyboardEvent} event Button key event.
+ */
+export function rotateButtonKeydown(event) {
+  const control = this._rotateControl, map = control._map, step = event.shiftKey ? 15 : 5;
+  if (event.key === 'ArrowLeft') mapSetBearing(map, mapGetBearing(map) - step);
+  else if (event.key === 'ArrowRight') mapSetBearing(map, mapGetBearing(map) + step);
+  else if (event.key === 'ArrowUp' && control.options.visualizePitch) mapSetPitch(map, mapGetPitch(map) + step);
+  else if (event.key === 'ArrowDown' && control.options.visualizePitch) mapSetPitch(map, mapGetPitch(map) - step);
+  else if (event.key === 'Home' || event.key === ' ') this.click();
+  else return;
+  event.preventDefault();
+  event.stopPropagation();
 }

package/src/controls/rotateControl.js

@@ -1,4 +1,12 @@
 import { L } from '../globals/L.js';
-export function rotateControl(options) {
-  return /* alloc */ new L.Control.Rotate(options);
-}
+
+/**
+ * Create a rotate control.
+ *
+ * @param {Object} options Control options.
+ *
+ * @returns {L.Control.Rotate} New control.
+ */
+export function rotateControl(options) {
+  return /* alloc */ new L.Control.Rotate(options);
+}

package/src/controls/rotateOnAdd.js

@@ -8,7 +8,13 @@ import { dragCamera } from './dragCamera.js';
 import { acceptRotateDrag } from './acceptRotateDrag.js';
 import { refreshRotateFocus } from './refreshRotateFocus.js';
 
-
+/**
+ * Create this rotate control's accessible button and attach camera interactions.
+ *
+ * @param {L.Map} map Map receiving the control.
+ *
+ * @returns {HTMLElement} Control container.
+ */
 export function rotateOnAdd(map) {
   const container = L.DomUtil.create('div', 'leaflet-control-rotate leaflet-bar');
   const button = L.DomUtil.create('a', 'leaflet-control-rotate-toggle', container);

package/src/controls/rotateOnRemove.js

@@ -1,5 +1,10 @@
 import { pitchDragRemoveHooks } from './pitchDragRemoveHooks.js';
 
+/**
+ * Remove this rotate control's map listeners and drag interaction.
+ *
+ * @param {L.Map} map Map containing the control.
+ */
 export function rotateOnRemove(map) {
   map.off('rotate pitch', this._refresh, this);
   pitchDragRemoveHooks.call(this);

package/src/controls/shiftRotateAddHooks.js

@@ -1,7 +1,7 @@
 import { cameraListenerOptions } from '../globals/cameraListenerOptions.js';
 import { shiftRotateWheel } from './shiftRotateWheel.js';
 
-
+/** Install this handler's Shift-wheel rotation listener. */
 export function shiftRotateAddHooks() {
   const container = this._map.getContainer();
   container._cameraShiftRotate = this;

package/src/controls/shiftRotateRemoveHooks.js

@@ -1,5 +1,6 @@
+/** Remove this handler's Shift-wheel rotation listener. */
 export function shiftRotateRemoveHooks() {
-  const container = this._map.getContainer();
-  container.removeEventListener('wheel', this._wheel, true);
+  const container = this._map.getContainer();
+  container.removeEventListener('wheel', this._wheel, true);
   delete container._cameraShiftRotate;
 }

package/src/controls/shiftRotateWheel.js

@@ -2,10 +2,15 @@ import { mapSetBearing } from '../camera/mapSetBearing.js';
 import { mapGetBearing } from '../camera/mapGetBearing.js';
 import { editable } from './isEditableTarget.js';
 
-export function shiftRotateWheel(event) {
-  const handler = this._cameraShiftRotate;
-  if (!event.shiftKey || editable(event.target) || event.target.closest('.leaflet-control')) return;
-  event.preventDefault();
-  event.stopImmediatePropagation();
-  mapSetBearing(handler._map, mapGetBearing(handler._map) + Math.sign(event.deltaY) * 5);
+/**
+ * Rotate the map for Shift-wheel events outside editable targets and controls.
+ *
+ * @param {WheelEvent} event Wheel event.
+ */
+export function shiftRotateWheel(event) {
+  const handler = this._cameraShiftRotate;
+  if (!event.shiftKey || editable(event.target) || event.target.closest('.leaflet-control')) return;
+  event.preventDefault();
+  event.stopImmediatePropagation();
+  mapSetBearing(handler._map, mapGetBearing(handler._map) + Math.sign(event.deltaY) * 5);
 }

package/src/controls/startCameraTouch.js

@@ -1,13 +1,16 @@
 import { touchPitchByMap } from '../weakmaps/touchPitchByMap.js';
 import { touchRotateByMap } from '../weakmaps/touchRotateByMap.js';
-
 import { L } from '../globals/L.js';
 import { touchByContainer } from '../weakmaps/touchByContainer.js';
-
 import { mapStopPitchBearingAnimation } from '../animations/mapStopPitchBearingAnimation.js';
 import { mapGetBearing } from '../camera/mapGetBearing.js';
 import { mapGetPitch } from '../camera/mapGetPitch.js';
 
+/**
+ * Start a two-finger camera gesture and retain its initial anchor and map state.
+ *
+ * @param {TouchEvent} event Touch-start event.
+ */
 export function startCameraTouch(event) {
   const state = touchByContainer.get(this), { map, container } = state;
   if (state.touch || event.touches.length !== 2 || event.target.closest('.leaflet-control')) return;

package/src/core/README.md

@@ -0,0 +1,28 @@
+# Leaflet integration
+
+[Source guide](../README.md) | [Project README](../../README.md)
+
+Contains Leaflet compatibility hooks and camera-aware behavior for native map
+layers, markers, popups and tooltips. The public entry point installs these hooks.
+
+## Compatibility boundary
+
+```mermaid
+flowchart LR
+  Entry["index.js"] --> Version{"Leaflet version"}
+  Version -->|1| Prototype["Hook native layer prototype"]
+  Version -->|2| Constructor["Compatible constructor + native prototype"]
+  Prototype --> Router["Source routing"]
+  Constructor --> Router
+  Entry --> Overlays["Camera-aware markers / popups / grids"]
+```
+
+The public contract remains `L.Layer`, including `instanceof`.
+[whenReady.js](./whenReady.js) returns a registered readiness promise or
+resolves immediately when none exists; source errors belong to initializers.
+
+- [constructLayer.js](./constructLayer.js): construct the compatible layer.
+- [layerCallInitHooks.js](./layerCallInitHooks.js): coordinate layer initialization hooks.
+- [whenReady.js](./whenReady.js): expose asynchronous readiness.
+
+Related: [scene](../scene/README.md), [camera](../camera/README.md), [native](../native/README.md).

package/src/core/adjustCameraMarkerPan.js

@@ -1,12 +1,17 @@
 import { L } from '../globals/L.js';
 import { dragByHandler } from '../weakmaps/dragByHandler.js';
-
 import { mapGetPitch } from '../camera/mapGetPitch.js';
 import { mapGetBearing } from '../camera/mapGetBearing.js';
-
 import { pointOf } from '../projections/toPoint.js';
 import { scheduleMarkerPan } from '../animations/scheduleMarkerPan.js';
 
+/**
+ * Auto-pan during marker dragging using screen-space movement under the camera.
+ *
+ * @param {Object} event Marker drag event.
+ *
+ * @returns {*} Original Leaflet handler result when the camera is untransformed.
+ */
 export function adjustCameraMarkerPan(event) {
   const marker = this._marker, map = marker._map;
   if (!mapGetPitch(map) && !mapGetBearing(map)) return dragByHandler.get(this)._cameraOriginalAdjustPan.call(this, event);

package/src/core/cameraCircleBounds.js

@@ -1,7 +1,11 @@
 import { boundsMethods } from '../weakmaps/boundsMethods.js';
 import { projectNativePath } from './projectNativePath.js';
 
-
+/**
+ * Project this circle when mapped and return its original Leaflet bounds.
+ *
+ * @returns {L.LatLngBounds} Circle bounds.
+ */
 export function cameraCircleBounds() {
   if (this._map) projectNativePath(this);
   return boundsMethods.get(this).call(this);

package/src/core/cameraMarkerDrag.js

@@ -1,9 +1,8 @@
 import { dragByHandler } from '../weakmaps/dragByHandler.js';
-
-
 import { cameraMarkerOnDrag } from './cameraMarkerOnDrag.js';
 import { adjustCameraMarkerPan } from './adjustCameraMarkerPan.js';
 
+/** Install camera-aware drag and auto-pan handlers on this marker once. */
 export function cameraMarkerDrag() {
   if (!this.dragging || dragByHandler.has(this.dragging)) return;
   const drag = this.dragging, original = drag._onDrag, adjustPan = drag._adjustPan;

package/src/core/cameraMarkerOnDrag.js

@@ -1,13 +1,16 @@
 import { L } from '../globals/L.js';
 import { dragByHandler } from '../weakmaps/dragByHandler.js';
 
-
-
-export function cameraMarkerOnDrag(event) {
-  const map = this._marker._map;
-  const screen = L.DomUtil.getPosition(this._marker._icon).add(map._getMapPanePos());
-  const point = map.containerPointToLayerPoint(screen);
-  L.DomUtil.setPosition(this._marker._icon, point);
-  dragByHandler.get(this)._cameraOriginalOnDrag.call(this, event);
-  this._marker._setPos(point);
-}
+/**
+ * Convert this marker's drag position through the camera before invoking Leaflet's handler.
+ *
+ * @param {Object} event Marker drag event.
+ */
+export function cameraMarkerOnDrag(event) {
+  const map = this._marker._map;
+  const screen = L.DomUtil.getPosition(this._marker._icon).add(map._getMapPanePos());
+  const point = map.containerPointToLayerPoint(screen);
+  L.DomUtil.setPosition(this._marker._icon, point);
+  dragByHandler.get(this)._cameraOriginalOnDrag.call(this, event);
+  this._marker._setPos(point);
+}

package/src/core/closestCameraLayerPoint.js

@@ -1,7 +1,13 @@
 import { closestMethods } from '../weakmaps/closestMethods.js';
 import { projectNativePath } from './projectNativePath.js';
 
-
+/**
+ * Project this path and find its closest layer point using Leaflet's original method.
+ *
+ * @param {L.Point} point Layer point to compare.
+ *
+ * @returns {L.Point} Closest point on the path.
+ */
 export function closestCameraLayerPoint(point) {
   projectNativePath(this);
   this._parts = this._rings;

package/src/core/constructLayer.js

@@ -1,9 +1,16 @@
-import { leafletLayer } from '../globals/leafletLayer.js';
-import { layerInitialize } from '../scene/layerInitialize.js';
-
-export function constructLayer(options) {
-  const layer = Reflect.construct(leafletLayer, /* alloc */ [], new.target);
-  layerInitialize.call(layer, options);
-  layer.callInitHooks();
-  return layer;
-}
+import { leafletLayer } from '../globals/leafletLayer.js';
+import { layerInitialize } from '../scene/layerInitialize.js';
+
+/**
+ * Construct a Leaflet layer, initialize its source and run initialization hooks.
+ *
+ * @param {Object} options Layer options.
+ *
+ * @returns {L.Layer} Constructed layer.
+ */
+export function constructLayer(options) {
+  const layer = Reflect.construct(leafletLayer, /* alloc */ [], new.target);
+  layerInitialize.call(layer, options);
+  layer.callInitHooks();
+  return layer;
+}

package/src/core/extendLeafletClass.js

@@ -1,5 +1,12 @@
-import { L } from '../globals/L.js';
-
-export function extendLeafletClass(parent) {
-  return L.version.startsWith('2.') ? parent : parent.extend(/* alloc */ {});
-}
+import { L } from '../globals/L.js';
+
+/**
+ * Obtain a compatible Leaflet class, extending it on Leaflet 1.
+ *
+ * @param {Function} parent Parent Leaflet class.
+ *
+ * @returns {Function} Parent or extended class.
+ */
+export function extendLeafletClass(parent) {
+  return L.version.startsWith('2.') ? parent : parent.extend(/* alloc */ {});
+}

package/src/core/extendTerrainPixelBounds.js

@@ -1,31 +1,41 @@
-import { cameraViewByMap } from '../weakmaps/cameraViewByMap.js';
-import { mapMethods } from '../globals/mapMethods.js';
-import { radians } from '../globals/radians.js';
-import { earthCirc } from '../globals/earthCirc.js';
-import { mapElevationOf } from '../terrain/mapElevationOf.js';
-import { groundBounds } from '../projections/groundBounds.js';
-import { animationPoint } from '../projections/transformZoomAnimationPoint.js';
-
-export function extendTerrainPixelBounds(layer, result, stream, origin) {
-  const map = layer._map;
-  let minimum = Infinity, maximum = -Infinity, key, entry;
-  for ([key, entry] of stream.terrainCache) {
-    if (!key.startsWith(`${layer._tileZoom}/`) || !entry.range) continue;
-    minimum = Math.min(minimum, entry.range[0]);
-    maximum = Math.max(maximum, entry.range[1]);
-  }
-  if (!Number.isFinite(minimum) || !Number.isFinite(maximum)) return result;
-  const zoom = cameraViewByMap.get(map)?.zoom ?? map.getZoom();
-  const scale = map.options.crs.scale(zoom) / (earthCirc * Math.cos(origin.lat * radians));
-  const target = mapElevationOf(map, map.getCenter()) ?? 0;
-  let i, j, footprint, point, raw;
-  for (i = 0; i < 2; i++) {
-    footprint = groundBounds(map, undefined, ((i ? maximum : minimum) - target) * scale);
-    for (j = 0; j < 2; j++) {
-      point = j ? footprint.max : footprint.min;
-      raw = mapMethods.value.containerPointToLayerPoint.call(map, animationPoint(map, point, true));
-      result.extend(map.project(map.layerPointToLatLng(raw), layer._tileZoom));
-    }
-  }
-  return result;
-}
+import { cameraViewByMap } from '../weakmaps/cameraViewByMap.js';
+import { mapMethods } from '../globals/mapMethods.js';
+import { radians } from '../globals/radians.js';
+import { earthCirc } from '../globals/earthCirc.js';
+import { mapElevationOf } from '../terrain/mapElevationOf.js';
+import { groundBounds } from '../projections/groundBounds.js';
+import { animationPoint } from '../projections/transformZoomAnimationPoint.js';
+
+/**
+ * Extend tiled pixel bounds to include the visible footprint at cached terrain elevation extremes.
+ *
+ * @param {L.GridLayer} layer Grid layer with the tile zoom.
+ * @param {L.Bounds} result Bounds to extend in place.
+ * @param {Object} stream Terrain stream and elevation cache.
+ * @param {L.LatLng} origin Scene origin.
+ *
+ * @returns {L.Bounds} Extended bounds.
+ */
+export function extendTerrainPixelBounds(layer, result, stream, origin) {
+  const map = layer._map;
+  let minimum = Infinity, maximum = -Infinity, key, entry;
+  for ([key, entry] of stream.terrainCache) {
+    if (!key.startsWith(`${layer._tileZoom}/`) || !entry.range) continue;
+    minimum = Math.min(minimum, entry.range[0]);
+    maximum = Math.max(maximum, entry.range[1]);
+  }
+  if (!Number.isFinite(minimum) || !Number.isFinite(maximum)) return result;
+  const zoom = cameraViewByMap.get(map)?.zoom ?? map.getZoom();
+  const scale = map.options.crs.scale(zoom) / (earthCirc * Math.cos(origin.lat * radians));
+  const target = mapElevationOf(map, map.getCenter()) ?? 0;
+  let i, j, footprint, point, raw;
+  for (i = 0; i < 2; i++) {
+    footprint = groundBounds(map, undefined, ((i ? maximum : minimum) - target) * scale);
+    for (j = 0; j < 2; j++) {
+      point = j ? footprint.max : footprint.min;
+      raw = mapMethods.value.containerPointToLayerPoint.call(map, animationPoint(map, point, true));
+      result.extend(map.project(map.layerPointToLatLng(raw), layer._tileZoom));
+    }
+  }
+  return result;
+}

package/src/core/fireRasterLoad.js

@@ -1,6 +1,6 @@
 import { pendingRasterLoads } from '../globals/pendingRasterLoads.js';
 
-
+/** Fire the load event for the next queued raster image layer, if present. */
 export function fireRasterLoad() {
   pendingRasterLoads.shift()?.fire('load');
 }

package/src/core/gridlayerGetEvents.js

@@ -1,8 +1,11 @@
 import { L } from '../globals/L.js';
 import { gridEvents } from '../globals/gridEvents.js';
 
-
-
+/**
+ * Extend this grid layer's map events to update tiles on rotation and pitch.
+ *
+ * @returns {Object} Map event handlers.
+ */
 export function gridlayerGetEvents() {
   const events = gridEvents.value.call(this);
   events.rotate = events.pitch = L.Util.throttle(this._onMoveEnd, this.options.updateInterval, this);

package/src/core/gridlayerGetTiledPixelBounds.js

@@ -1,6 +1,5 @@
 import { L } from '../globals/L.js';
 import { tiledBounds } from '../globals/tiledBounds.js';
-
 import { mapGetBearing } from '../camera/mapGetBearing.js';
 import { mapGetPitch } from '../camera/mapGetPitch.js';
 import { streamTerrainByMap } from '../weakmaps/streamTerrainByMap.js';
@@ -8,6 +7,13 @@ import { renderers } from '../weakmaps/renderers.js';
 import { sceneOriginByLayer } from '../weakmaps/sceneOriginByLayer.js';
 import { extendTerrainPixelBounds } from './extendTerrainPixelBounds.js';
 
+/**
+ * Compute this grid layer's tile bounds for the camera and visible terrain.
+ *
+ * @param {L.LatLng} center Proposed map center for Leaflet's default calculation.
+ *
+ * @returns {L.Bounds} Projected tile pixel bounds.
+ */
 export function gridlayerGetTiledPixelBounds(center) {
   const map = this._map, stream = streamTerrainByMap.get(map);
   if (!stream && !mapGetBearing(map) && !mapGetPitch(map)) return tiledBounds.value.call(this, center);

package/src/core/initializeGridContainer.js

@@ -1,6 +1,6 @@
 import { gridInitializers } from '../weakmaps/gridInitializers.js';
 
-
+/** Run this grid layer's original container initializer and remove its DOM container. */
 export function initializeGridContainer() {
   gridInitializers.get(this).call(this);
   this._container.remove();

package/src/core/initializeNativeLayer.js

@@ -1,15 +1,11 @@
 import { kindByLayer } from '../weakmaps/kindByLayer.js';
-
 import { L } from '../globals/L.js';
 import { closestMethods } from '../weakmaps/closestMethods.js';
 import { boundsMethods } from '../weakmaps/boundsMethods.js';
 import { gridInitializers } from '../weakmaps/gridInitializers.js';
-
-
 import { noOperation } from '../utils/noOperation.js';
 import { emptyEvents } from '../scene/emptyEvents.js';
 import { refreshNativeLayerContract } from '../native/refreshNativeLayerContract.js';
-
 import { closestCameraLayerPoint } from './closestCameraLayerPoint.js';
 import { cameraCircleBounds } from './cameraCircleBounds.js';
 import { initializeGridContainer } from './initializeGridContainer.js';
@@ -17,6 +13,7 @@ import { updateGridOpacity } from './updateGridOpacity.js';
 import { addRasterImage } from '../textures/attachRasterImage.js';
 import { redrawPath } from './redrawPath.js';
 
+/** Install camera and GPU integration hooks appropriate to this native Leaflet layer. */
 export function initializeNativeLayer() {
   if (this instanceof L.Polyline || this instanceof L.CircleMarker) {
     this.beforeAdd = this._updateBounds = noOperation;

package/src/core/layerAddInitHook.js

@@ -1,7 +1,12 @@
-import { L } from '../globals/L.js';
-import { leafletLayer } from '../globals/leafletLayer.js';
-
-export function layerAddInitHook() {
-  leafletLayer.addInitHook.apply(this === L.Layer ? leafletLayer : this, arguments);
-  return this;
-}
+import { L } from '../globals/L.js';
+import { leafletLayer } from '../globals/leafletLayer.js';
+
+/**
+ * Forward initialization-hook registration to the appropriate Leaflet class.
+ *
+ * @returns {Function} This layer class.
+ */
+export function layerAddInitHook() {
+  leafletLayer.addInitHook.apply(this === L.Layer ? leafletLayer : this, arguments);
+  return this;
+}

package/src/core/layerCallInitHooks.js

@@ -1,10 +1,9 @@
 import { sceneLayers } from '../weakmaps/sceneLayers.js';
-
 import { L } from '../globals/L.js';
 import { layerProto } from '../globals/layerProto.js';
-
 import { initializeNativeLayer } from './initializeNativeLayer.js';
 
+/** Run Leaflet initialization hooks and initialize this native layer when needed. */
 export function layerCallInitHooks() {
   const initialized = this._initHooksCalled;
   if (!L.version.startsWith('2.')) layerProto.value.callInitHooks.call(this);