leaflet-city-mapper 0.0.9 → 0.1.1

package/src/vector-tiles/vectorFeaturePaint.js

@@ -1,15 +1,25 @@
-import { vectorPaint } from '../vector-style/vectorPaint.js';
-import { visibleStyle } from '../vector-style/visibleStyle.js';
-
-export function vectorFeaturePaint(entry, feature, sampleZoom, maxZoom) {
-  if (entry.type === 'fill') return feature.type === 3 ? vectorPaint(entry, feature.properties, sampleZoom) : null;
-  if (entry.type !== 'line' || feature.type !== 2) return null;
-  let paint = vectorPaint(entry, feature.properties, sampleZoom), candidate;
-  if (paint.weight > 0 && paint.opacity > 0) return paint;
-  for (candidate = maxZoom; candidate >= 0; candidate--) {
-    if (!visibleStyle(entry, feature.properties, candidate)) continue;
-    paint = vectorPaint(entry, feature.properties, candidate);
-    if (paint.weight > 0 && paint.opacity > 0) return paint;
-  }
-  return null;
-}
+import { vectorPaint } from '../vector-style/vectorPaint.js';
+import { visibleStyle } from '../vector-style/visibleStyle.js';
+
+/**
+ * Find usable fill or line paint for a compatible vector feature.
+ *
+ * @param {Object} entry Style layer entry.
+ * @param {Object} feature Decoded feature.
+ * @param {number} sampleZoom Initial style zoom.
+ * @param {number} maxZoom Maximum zoom to search for visible line paint.
+ *
+ * @returns {Object|null} Paint, or null if no compatible visible paint exists.
+ */
+export function vectorFeaturePaint(entry, feature, sampleZoom, maxZoom) {
+  if (entry.type === 'fill') return feature.type === 3 ? vectorPaint(entry, feature.properties, sampleZoom) : null;
+  if (entry.type !== 'line' || feature.type !== 2) return null;
+  let paint = vectorPaint(entry, feature.properties, sampleZoom), candidate;
+  if (paint.weight > 0 && paint.opacity > 0) return paint;
+  for (candidate = maxZoom; candidate >= 0; candidate--) {
+    if (!visibleStyle(entry, feature.properties, candidate)) continue;
+    paint = vectorPaint(entry, feature.properties, candidate);
+    if (paint.weight > 0 && paint.opacity > 0) return paint;
+  }
+  return null;
+}

package/src/vector-tiles/vectorFeaturePaths.js

@@ -1,16 +1,26 @@
-import { projectVectorTriangles } from './projectVectorTriangles.js';
-import { projectVectorPaths } from './projectVectorPaths.js';
-import { vectorTolerance } from './vectorTolerance.js';
-
-export function vectorFeaturePaths(job, layer, entry, feature) {
-  const cache = entry.type === 'fill' ? job.triangles : job.projected;
-  let paths = cache.get(feature);
-  if (!paths) {
-    const tolerance = vectorTolerance(job, layer);
-    paths = entry.type === 'fill'
-      ? projectVectorTriangles(feature.geometry, job.coords, layer.extent, tolerance)
-      : projectVectorPaths(feature.geometry, job.coords, layer.extent, tolerance);
-    cache.set(feature, paths);
-  }
-  return paths;
-}
+import { projectVectorTriangles } from './projectVectorTriangles.js';
+import { projectVectorPaths } from './projectVectorPaths.js';
+import { vectorTolerance } from './vectorTolerance.js';
+
+/**
+ * Project and cache a feature's paths or fill triangles for the tile job.
+ *
+ * @param {Object} job Vector tile preparation job.
+ * @param {Object} layer Decoded source layer.
+ * @param {Object} entry Style layer entry.
+ * @param {Object} feature Decoded feature.
+ *
+ * @returns {Array} Projected feature paths.
+ */
+export function vectorFeaturePaths(job, layer, entry, feature) {
+  const cache = entry.type === 'fill' ? job.triangles : job.projected;
+  let paths = cache.get(feature);
+  if (!paths) {
+    const tolerance = vectorTolerance(job, layer);
+    paths = entry.type === 'fill'
+      ? projectVectorTriangles(feature.geometry, job.coords, layer.extent, tolerance)
+      : projectVectorPaths(feature.geometry, job.coords, layer.extent, tolerance);
+    cache.set(feature, paths);
+  }
+  return paths;
+}

package/src/vector-tiles/vectorFeatureZoom.js

@@ -1,8 +1,18 @@
-import { visibleStyle } from '../vector-style/visibleStyle.js';
-
-export function vectorFeatureZoom(entry, properties, zoom, maxZoom) {
-  if (visibleStyle(entry, properties, zoom)) return zoom;
-  zoom = maxZoom;
-  while (zoom >= 0 && !visibleStyle(entry, properties, zoom)) zoom--;
-  return zoom;
-}
+import { visibleStyle } from '../vector-style/visibleStyle.js';
+
+/**
+ * Find a zoom at which the style is visible for a feature.
+ *
+ * @param {Object} entry Style layer entry.
+ * @param {Object} properties Feature properties.
+ * @param {number} zoom Current style zoom.
+ * @param {number} maxZoom Maximum fallback zoom.
+ *
+ * @returns {number} Visible zoom, or -1 if none is found.
+ */
+export function vectorFeatureZoom(entry, properties, zoom, maxZoom) {
+  if (visibleStyle(entry, properties, zoom)) return zoom;
+  zoom = maxZoom;
+  while (zoom >= 0 && !visibleStyle(entry, properties, zoom)) zoom--;
+  return zoom;
+}

package/src/vector-tiles/vectorLabelAnchors.js

@@ -1,24 +1,31 @@
-import { vectorStraightRun } from './vectorStraightRun.js';
-
-/** Anchors evenly spread along a path: each is a point on a segment plus that segment's ends. */
-export function vectorLabelAnchors(path, spacing) {
-  const anchors = /* alloc */ [];
-  let length = 0, i, walked, target, count, k, segment, t, point;
-  for (i = 1; i < path.length; i++) length += Math.hypot(path[i][0] - path[i - 1][0], path[i][1] - path[i - 1][1]);
-  count = Math.max(1, Math.floor(length / spacing));
-  i = 1; walked = 0;
-  for (k = 0; k < count; k++) {
-    target = (k + 0.5) * length / count;
-    while (i < path.length - 1 && walked + Math.hypot(path[i][0] - path[i - 1][0], path[i][1] - path[i - 1][1]) < target) {
-      walked += Math.hypot(path[i][0] - path[i - 1][0], path[i][1] - path[i - 1][1]); i++;
-    }
-    segment = Math.hypot(path[i][0] - path[i - 1][0], path[i][1] - path[i - 1][1]);
-    t = segment ? Math.min(1, Math.max(0, (target - walked) / segment)) : 0;
-    point = /* alloc */ [
-      path[i - 1][0] + (path[i][0] - path[i - 1][0]) * t, path[i - 1][1] + (path[i][1] - path[i - 1][1]) * t,
-    ];
-    anchors.push(/* alloc */ { point, a: path[i - 1], b: path[i],
-      length: vectorStraightRun(path, i, point, 1) + vectorStraightRun(path, i, point, -1) });
-  }
-  return anchors;
-}
+import { vectorStraightRun } from './vectorStraightRun.js';
+
+/**
+ * Spread anchors along a path, recording segment ends and straight-run lengths.
+ *
+ * @param {Array} path Tile-coordinate points.
+ * @param {number} spacing Desired anchor spacing.
+ *
+ * @returns {Array} Label anchors.
+ */
+export function vectorLabelAnchors(path, spacing) {
+  const anchors = /* alloc */ [];
+  let length = 0, i, walked, target, count, k, segment, t, point;
+  for (i = 1; i < path.length; i++) length += Math.hypot(path[i][0] - path[i - 1][0], path[i][1] - path[i - 1][1]);
+  count = Math.max(1, Math.floor(length / spacing));
+  i = 1; walked = 0;
+  for (k = 0; k < count; k++) {
+    target = (k + 0.5) * length / count;
+    while (i < path.length - 1 && walked + Math.hypot(path[i][0] - path[i - 1][0], path[i][1] - path[i - 1][1]) < target) {
+      walked += Math.hypot(path[i][0] - path[i - 1][0], path[i][1] - path[i - 1][1]); i++;
+    }
+    segment = Math.hypot(path[i][0] - path[i - 1][0], path[i][1] - path[i - 1][1]);
+    t = segment ? Math.min(1, Math.max(0, (target - walked) / segment)) : 0;
+    point = /* alloc */ [
+      path[i - 1][0] + (path[i][0] - path[i - 1][0]) * t, path[i - 1][1] + (path[i][1] - path[i - 1][1]) * t,
+    ];
+    anchors.push(/* alloc */ { point, a: path[i - 1], b: path[i],
+      length: vectorStraightRun(path, i, point, 1) + vectorStraightRun(path, i, point, -1) });
+  }
+  return anchors;
+}

package/src/vector-tiles/vectorLabelCandidates.js

@@ -1,11 +1,18 @@
-import { compareVectorLabelPriority } from './compareVectorLabelPriority.js';
-
-export function vectorLabelCandidates(layer) {
-  const candidates = /* alloc */ [];
-  let tile, label;
-  for (tile of layer.tiles.values()) {
-    if (!tile.needed || !tile.labelCandidates) continue;
-    for (label of tile.labelCandidates) candidates.push(label);
-  }
-  return candidates.sort(compareVectorLabelPriority);
-}
+import { compareVectorLabelPriority } from './compareVectorLabelPriority.js';
+
+/**
+ * Collect candidates from needed tiles and sort them by label priority.
+ *
+ * @param {Object} layer Vector tile layer.
+ *
+ * @returns {Array} Sorted label candidates.
+ */
+export function vectorLabelCandidates(layer) {
+  const candidates = /* alloc */ [];
+  let tile, label;
+  for (tile of layer.tiles.values()) {
+    if (!tile.needed || !tile.labelCandidates) continue;
+    for (label of tile.labelCandidates) candidates.push(label);
+  }
+  return candidates.sort(compareVectorLabelPriority);
+}

package/src/vector-tiles/vectorLabelCells.js

@@ -1,23 +1,32 @@
-import { vectorStyleZoom } from './vectorStyleZoom.js';
-import { vectorTileOptionsByLayer } from '../weakmaps/vectorTileOptionsByLayer.js';
-import { visibleStyle } from '../vector-style/visibleStyle.js';
-import { updateVectorLabelStyle } from './updateVectorLabelStyle.js';
-
-export function vectorLabelCells(layer, label, size) {
-  const map = layer._map, zoom = vectorStyleZoom(layer);
-  if (!visibleStyle(label.entry, label.properties, zoom)) return null;
-  updateVectorLabelStyle(label, zoom);
-  if (!(label.size > 0)) return null;
-  if (label.icon && !vectorTileOptionsByLayer.get(layer).spriteSheet?.index[label.icon]) return null;
-  if (label.along && label.pixelBase * 2 ** map.getZoom() < label.text.length * label.size * 0.6) return null;
-  const point = map.latLngToContainerPoint(label.latlng);
-  if (point.x < 0 || point.y < 0 || point.x > size.x || point.y > size.y) return null;
-  const width = label.text.length * label.size * 0.65 + 16, cells = /* alloc */ [];
-  let x, y;
-  for (x = Math.floor((point.x - width / 2) / 32); x <= Math.floor((point.x + width / 2) / 32); x++) {
-    for (y = Math.floor((point.y - label.size) / 24); y <= Math.floor((point.y + label.size) / 24); y++) {
-      cells.push(`${x}:${y}`);
-    }
-  }
-  return cells;
-}
+import { vectorStyleZoom } from './vectorStyleZoom.js';
+import { vectorTileOptionsByLayer } from '../weakmaps/vectorTileOptionsByLayer.js';
+import { visibleStyle } from '../vector-style/visibleStyle.js';
+import { updateVectorLabelStyle } from './updateVectorLabelStyle.js';
+
+/**
+ * Compute screen cells occupied by a visible, placeable vector label.
+ *
+ * @param {Object} layer Vector tile layer.
+ * @param {Object} label Label candidate.
+ * @param {Object} size Map viewport size.
+ *
+ * @returns {Array<string>|null} Occupied cell keys, or null if the label cannot be placed.
+ */
+export function vectorLabelCells(layer, label, size) {
+  const map = layer._map, zoom = vectorStyleZoom(layer);
+  if (!visibleStyle(label.entry, label.properties, zoom)) return null;
+  updateVectorLabelStyle(label, zoom);
+  if (!(label.size > 0)) return null;
+  if (label.icon && !vectorTileOptionsByLayer.get(layer).spriteSheet?.index[label.icon]) return null;
+  if (label.along && label.pixelBase * 2 ** map.getZoom() < label.text.length * label.size * 0.6) return null;
+  const point = map.latLngToContainerPoint(label.latlng);
+  if (point.x < 0 || point.y < 0 || point.x > size.x || point.y > size.y) return null;
+  const width = label.text.length * label.size * 0.65 + 16, cells = /* alloc */ [];
+  let x, y;
+  for (x = Math.floor((point.x - width / 2) / 32); x <= Math.floor((point.x + width / 2) / 32); x++) {
+    for (y = Math.floor((point.y - label.size) / 24); y <= Math.floor((point.y + label.size) / 24); y++) {
+      cells.push(`${x}:${y}`);
+    }
+  }
+  return cells;
+}

package/src/vector-tiles/vectorLabelIcon.js

@@ -1,30 +1,38 @@
-import { L } from '../globals/L.js';
-import { vectorSpriteIcon } from './vectorSpriteIcon.js';
-import { wrapVectorLabel } from './wrapVectorLabel.js';
-
-export function vectorLabelIcon(label, sheet) {
-  if (label.icon) return vectorSpriteIcon(label, sheet);
-  const svg = document.createElementNS('http://www.w3.org/2000/svg', 'svg');
-  const lines = label.along ? /* alloc */ [label.text] : wrapVectorLabel(label.text);
-  let longest = 0, line, key, text, index;
-  for (line of lines) longest = Math.max(longest, Array.from(line).length);
-  const width = Math.max(40, longest * label.size * 0.65 + 12);
-  const lineHeight = label.size * 1.2, height = lines.length * lineHeight + 12;
-  svg.setAttribute('width', width); svg.setAttribute('height', height);
-  const attributes = /* alloc */ {
-    x: width / 2, 'text-anchor': 'middle',
-    'font-family': 'sans-serif', 'font-size': label.size,
-    fill: label.color, stroke: label.halo, 'stroke-width': label.haloWidth * 2, 'paint-order': 'stroke',
-  };
-  for (index = 0; index < lines.length; index++) {
-    text = document.createElementNS(svg.namespaceURI, 'text');
-    for (key of Object.keys(attributes)) text.setAttribute(key, attributes[key]);
-    text.setAttribute('y', height / 2 + (index - (lines.length - 1) / 2) * lineHeight + label.size * 0.35);
-    text.textContent = lines[index];
-    svg.append(text);
-  }
-  return /* alloc */ new L.Icon(/* alloc */ {
-    iconUrl: `data:image/svg+xml;charset=utf-8,${encodeURIComponent((/* alloc */ new XMLSerializer()).serializeToString(svg))}`,
-    iconSize: /* alloc */ [width, height], iconAnchor: /* alloc */ [width / 2, height / 2],
-  });
-}
+import { L } from '../globals/L.js';
+import { vectorSpriteIcon } from './vectorSpriteIcon.js';
+import { wrapVectorLabel } from './wrapVectorLabel.js';
+
+/**
+ * Create a sprite or SVG text icon for a vector label.
+ *
+ * @param {Object} label Label candidate and appearance.
+ * @param {Object} sheet Sprite sheet, when needed.
+ *
+ * @returns {Object} Leaflet icon.
+ */
+export function vectorLabelIcon(label, sheet) {
+  if (label.icon) return vectorSpriteIcon(label, sheet);
+  const svg = document.createElementNS('http://www.w3.org/2000/svg', 'svg');
+  const lines = label.along ? /* alloc */ [label.text] : wrapVectorLabel(label.text);
+  let longest = 0, line, key, text, index;
+  for (line of lines) longest = Math.max(longest, Array.from(line).length);
+  const width = Math.max(40, longest * label.size * 0.65 + 12);
+  const lineHeight = label.size * 1.2, height = lines.length * lineHeight + 12;
+  svg.setAttribute('width', width); svg.setAttribute('height', height);
+  const attributes = /* alloc */ {
+    x: width / 2, 'text-anchor': 'middle',
+    'font-family': 'sans-serif', 'font-size': label.size,
+    fill: label.color, stroke: label.halo, 'stroke-width': label.haloWidth * 2, 'paint-order': 'stroke',
+  };
+  for (index = 0; index < lines.length; index++) {
+    text = document.createElementNS(svg.namespaceURI, 'text');
+    for (key of Object.keys(attributes)) text.setAttribute(key, attributes[key]);
+    text.setAttribute('y', height / 2 + (index - (lines.length - 1) / 2) * lineHeight + label.size * 0.35);
+    text.textContent = lines[index];
+    svg.append(text);
+  }
+  return /* alloc */ new L.Icon(/* alloc */ {
+    iconUrl: `data:image/svg+xml;charset=utf-8,${encodeURIComponent((/* alloc */ new XMLSerializer()).serializeToString(svg))}`,
+    iconSize: /* alloc */ [width, height], iconAnchor: /* alloc */ [width / 2, height / 2],
+  });
+}

package/src/vector-tiles/vectorLabelProperty.js

@@ -1,3 +1,12 @@
-export function vectorLabelProperty(properties, match, key) {
-  return properties[key] ?? '';
-}
+/**
+ * Replace a label template placeholder with its feature property.
+ *
+ * @param {Object} properties Feature properties.
+ * @param {string} match Complete placeholder match.
+ * @param {string} key Property name inside the placeholder.
+ *
+ * @returns {*} Property value, or an empty string when absent.
+ */
+export function vectorLabelProperty(properties, match, key) {
+  return properties[key] ?? '';
+}

package/src/vector-tiles/vectorLabelText.js

@@ -1,10 +1,19 @@
-import { evaluateStyle } from '../vector-style/evaluateStyle.js';
-import { vectorLabelProperty } from './vectorLabelProperty.js';
-
-export function vectorLabelText(entry, properties, zoom) {
-  let text = entry.layout?.['text-field'];
-  if (Array.isArray(text)) text = evaluateStyle(text, properties, zoom);
-  if (typeof text !== 'string') text = '';
-  text = text.replace(/\{([^}]+)\}/g, vectorLabelProperty.bind(null, properties));
-  return entry.layout?.['text-transform'] === 'uppercase' ? text.toUpperCase() : text;
-}
+import { evaluateStyle } from '../vector-style/evaluateStyle.js';
+import { vectorLabelProperty } from './vectorLabelProperty.js';
+
+/**
+ * Evaluate a label's text, expand property placeholders and apply uppercase transformation.
+ *
+ * @param {Object} entry Style layer entry.
+ * @param {Object} properties Feature properties.
+ * @param {number} zoom Style zoom.
+ *
+ * @returns {string} Label text.
+ */
+export function vectorLabelText(entry, properties, zoom) {
+  let text = entry.layout?.['text-field'];
+  if (Array.isArray(text)) text = evaluateStyle(text, properties, zoom);
+  if (typeof text !== 'string') text = '';
+  text = text.replace(/\{([^}]+)\}/g, vectorLabelProperty.bind(null, properties));
+  return entry.layout?.['text-transform'] === 'uppercase' ? text.toUpperCase() : text;
+}

package/src/vector-tiles/vectorSpriteIcon.js

@@ -1,11 +1,19 @@
-import { L } from '../globals/L.js';
-
-export function vectorSpriteIcon(label, sheet) {
-  const { x, y, width, height } = sheet.index[label.icon], [dx, dy] = label.iconOffset;
-  return /* alloc */ new L.DivIcon(/* alloc */ {
-    className: '',
-    html: `<div style="width:${width}px;height:${height}px;background:url(${sheet.url}) -${x}px -${y}px"></div>`,
-    iconSize: /* alloc */ [width, height],
-    iconAnchor: /* alloc */ [width / 2 - dx, height / 2 - dy],
-  });
-}
+import { L } from '../globals/L.js';
+
+/**
+ * Create a Leaflet icon displaying a sprite sheet region with the label offset.
+ *
+ * @param {Object} label Label candidate with sprite name and offset.
+ * @param {Object} sheet Sprite URL and index.
+ *
+ * @returns {Object} Leaflet div icon.
+ */
+export function vectorSpriteIcon(label, sheet) {
+  const { x, y, width, height } = sheet.index[label.icon], [dx, dy] = label.iconOffset;
+  return /* alloc */ new L.DivIcon(/* alloc */ {
+    className: '',
+    html: `<div style="width:${width}px;height:${height}px;background:url(${sheet.url}) -${x}px -${y}px"></div>`,
+    iconSize: /* alloc */ [width, height],
+    iconAnchor: /* alloc */ [width / 2 - dx, height / 2 - dy],
+  });
+}

package/src/vector-tiles/vectorStraightRun.js

@@ -1,14 +1,23 @@
-/** Distance from a point on segment (i-1, i) along the path until it turns more than ~45 degrees from that segment. */
-export function vectorStraightRun(path, i, point, step) {
-  const base = Math.atan2(path[i][1] - path[i - 1][1], path[i][0] - path[i - 1][0]);
-  let j = step > 0 ? i : i - 1, previous = point, run = 0, next;
-  while (j >= 0 && j < path.length) {
-    run += Math.hypot(path[j][0] - previous[0], path[j][1] - previous[1]);
-    previous = path[j];
-    next = j + step;
-    if (next < 0 || next >= path.length) break;
-    if (Math.cos(Math.atan2(path[next][1] - path[j][1], path[next][0] - path[j][0]) - base + (step < 0 ? Math.PI : 0)) < 0.7) break;
-    j = next;
-  }
-  return run;
-}
+/**
+ * Measure the path from a segment point until it turns about 45 degrees from that segment.
+ *
+ * @param {Array} path Tile-coordinate points.
+ * @param {number} i Segment end index.
+ * @param {Array<number>} point Point on the segment.
+ * @param {number} step Direction along the path, 1 or -1.
+ *
+ * @returns {number} Straight-run distance.
+ */
+export function vectorStraightRun(path, i, point, step) {
+  const base = Math.atan2(path[i][1] - path[i - 1][1], path[i][0] - path[i - 1][0]);
+  let j = step > 0 ? i : i - 1, previous = point, run = 0, next;
+  while (j >= 0 && j < path.length) {
+    run += Math.hypot(path[j][0] - previous[0], path[j][1] - previous[1]);
+    previous = path[j];
+    next = j + step;
+    if (next < 0 || next >= path.length) break;
+    if (Math.cos(Math.atan2(path[next][1] - path[j][1], path[next][0] - path[j][0]) - base + (step < 0 ? Math.PI : 0)) < 0.7) break;
+    j = next;
+  }
+  return run;
+}

package/src/vector-tiles/vectorStyleDependencies.js

@@ -1,15 +1,22 @@
-export function vectorStyleDependencies(entry) {
-  const dependencies = /* alloc */ new Set();
-  const expressions = /* alloc */ [entry.paint, entry.filter];
-  let value, child;
-  while (expressions.length) {
-    value = expressions.pop();
-    if (!value || typeof value !== 'object') continue;
-    if (Array.isArray(value) && typeof value[1] === 'string' &&
-        /* alloc */ ['get', 'has', '==', '!=', '<', '>', '<=', '>=', 'in', '!in'].includes(value[0])) {
-      dependencies.add(value[1]);
-    }
-    for (child of Object.values(value)) expressions.push(child);
-  }
-  return dependencies;
-}
+/**
+ * Collect feature property names referenced by paint and filter expressions.
+ *
+ * @param {Object} entry Style layer entry.
+ *
+ * @returns {Set<string>} Referenced property names.
+ */
+export function vectorStyleDependencies(entry) {
+  const dependencies = /* alloc */ new Set();
+  const expressions = /* alloc */ [entry.paint, entry.filter];
+  let value, child;
+  while (expressions.length) {
+    value = expressions.pop();
+    if (!value || typeof value !== 'object') continue;
+    if (Array.isArray(value) && typeof value[1] === 'string' &&
+        /* alloc */ ['get', 'has', '==', '!=', '<', '>', '<=', '>=', 'in', '!in'].includes(value[0])) {
+      dependencies.add(value[1]);
+    }
+    for (child of Object.values(value)) expressions.push(child);
+  }
+  return dependencies;
+}

package/src/vector-tiles/vectorStyleValue.js

@@ -1,5 +1,16 @@
-import { evaluateStyle } from '../vector-style/evaluateStyle.js';
-
-export function vectorStyleValue(object, key, fallback, properties, zoom) {
-  return object?.[key] === undefined ? fallback : evaluateStyle(object[key], properties, zoom);
-}
+import { evaluateStyle } from '../vector-style/evaluateStyle.js';
+
+/**
+ * Evaluate a style property or return its fallback when absent.
+ *
+ * @param {Object} object Style properties.
+ * @param {string} key Property name.
+ * @param {*} fallback Default value.
+ * @param {Object} properties Feature properties.
+ * @param {number} zoom Style zoom.
+ *
+ * @returns {*} Evaluated or fallback value.
+ */
+export function vectorStyleValue(object, key, fallback, properties, zoom) {
+  return object?.[key] === undefined ? fallback : evaluateStyle(object[key], properties, zoom);
+}

package/src/vector-tiles/vectorStyleZoom.js

@@ -1,6 +1,12 @@
-import { vectorTileOptionsByLayer } from '../weakmaps/vectorTileOptionsByLayer.js';
-
-// Style zooms are authored for 512px tiles (MapLibre): `styleZoomOffset: -1` maps Leaflet's 256px zoom onto them.
-export function vectorStyleZoom(layer) {
-  return layer._map.getZoom() + (vectorTileOptionsByLayer.get(layer).styleZoomOffset ?? 0);
-}
+import { vectorTileOptionsByLayer } from '../weakmaps/vectorTileOptionsByLayer.js';
+
+/**
+ * Convert map zoom to style zoom using the configured offset.
+ *
+ * @param {Object} layer Vector tile layer; an offset of -1 maps 256px tiles to 512px style zooms.
+ *
+ * @returns {number} Style zoom.
+ */
+export function vectorStyleZoom(layer) {
+  return layer._map.getZoom() + (vectorTileOptionsByLayer.get(layer).styleZoomOffset ?? 0);
+}

package/src/vector-tiles/vectorTileAwaited.js

@@ -1,9 +1,17 @@
-import { vectorTileOverlaps } from './vectorTileOverlaps.js';
-
-export function vectorTileAwaited(layer, stale) {
-  let tile;
-  for (tile of layer.tiles.values()) {
-    if (tile.needed && !tile.group && vectorTileOverlaps(tile.coords, stale.coords)) return true;
-  }
-  return false;
-}
+import { vectorTileOverlaps } from './vectorTileOverlaps.js';
+
+/**
+ * Check whether a stale tile is needed while an overlapping tile is loading.
+ *
+ * @param {Object} layer Vector tile layer.
+ * @param {Object} stale Existing tile.
+ *
+ * @returns {boolean} Whether a needed overlapping tile has no group yet.
+ */
+export function vectorTileAwaited(layer, stale) {
+  let tile;
+  for (tile of layer.tiles.values()) {
+    if (tile.needed && !tile.group && vectorTileOverlaps(tile.coords, stale.coords)) return true;
+  }
+  return false;
+}

package/src/vector-tiles/vectorTileOverlaps.js

@@ -1,4 +1,12 @@
-export function vectorTileOverlaps(a, b) {
-  const shift = a.z - b.z;
-  return shift >= 0 ? a.x >> shift === b.x && a.y >> shift === b.y : b.x >> -shift === a.x && b.y >> -shift === a.y;
-}
+/**
+ * Check whether two tile coordinates overlap across zoom levels.
+ *
+ * @param {Object} a First tile coordinates.
+ * @param {Object} b Second tile coordinates.
+ *
+ * @returns {boolean} Whether the tiles overlap.
+ */
+export function vectorTileOverlaps(a, b) {
+  const shift = a.z - b.z;
+  return shift >= 0 ? a.x >> shift === b.x && a.y >> shift === b.y : b.x >> -shift === a.x && b.y >> -shift === a.y;
+}

package/src/vector-tiles/vectorTilePaint.js

@@ -1,10 +1,18 @@
-import { vectorPaint } from '../vector-style/vectorPaint.js';
-import { visibleStyle } from '../vector-style/visibleStyle.js';
-
-export function vectorTilePaint(batch, zoom) {
-  const paint = vectorPaint(batch.entry, batch.properties, zoom);
-  if (!visibleStyle(batch.entry, batch.properties, zoom)) {
-    paint.opacity = 0; paint.fillOpacity = 0;
-  }
-  return paint;
-}
+import { vectorPaint } from '../vector-style/vectorPaint.js';
+import { visibleStyle } from '../vector-style/visibleStyle.js';
+
+/**
+ * Evaluate batch paint and make it transparent when its style is not visible.
+ *
+ * @param {Object} batch Vector batch and style properties.
+ * @param {number} zoom Style zoom.
+ *
+ * @returns {Object} Evaluated paint.
+ */
+export function vectorTilePaint(batch, zoom) {
+  const paint = vectorPaint(batch.entry, batch.properties, zoom);
+  if (!visibleStyle(batch.entry, batch.properties, zoom)) {
+    paint.opacity = 0; paint.fillOpacity = 0;
+  }
+  return paint;
+}