leaflet-city-mapper 0.1.0 → 0.1.1

package/src/camera/setBearing.js

@@ -1,13 +1,13 @@
-import { mapSetBearing } from './mapSetBearing.js';
-
-/**
- * Set or animate this map's bearing.
- *
- * @param {number} bearing Target bearing in degrees.
- * @param {Object} [options] Camera animation options.
- *
- * @returns {L.Map} This map.
- */
-export function setBearing(bearing, options) {
-  return mapSetBearing(this, bearing, options);
-}
+import { mapSetBearing } from './mapSetBearing.js';
+
+/**
+ * Set or animate this map's bearing.
+ *
+ * @param {number} bearing Target bearing in degrees.
+ * @param {Object} [options] Camera animation options.
+ *
+ * @returns {L.Map} This map.
+ */
+export function setBearing(bearing, options) {
+  return mapSetBearing(this, bearing, options);
+}

package/src/camera/setPitch.js

@@ -1,13 +1,13 @@
-import { mapSetPitch } from './mapSetPitch.js';
-
-/**
- * Set or animate this map's pitch.
- *
- * @param {number} pitch Target pitch in degrees.
- * @param {Object} [options] Camera animation options.
- *
- * @returns {L.Map} This map.
- */
-export function setPitch(pitch, options) {
-  return mapSetPitch(this, pitch, options);
-}
+import { mapSetPitch } from './mapSetPitch.js';
+
+/**
+ * Set or animate this map's pitch.
+ *
+ * @param {number} pitch Target pitch in degrees.
+ * @param {Object} [options] Camera animation options.
+ *
+ * @returns {L.Map} This map.
+ */
+export function setPitch(pitch, options) {
+  return mapSetPitch(this, pitch, options);
+}

package/src/cog/decodeCogTile.js

@@ -1,37 +1,37 @@
-/**
- * Decode an uncompressed or deflate-compressed COG tile to its expected byte length.
- *
- * @param {ArrayBuffer} data Encoded tile data.
- * @param {number} length Expected decoded byte length.
- * @param {number} compression TIFF compression code.
- *
- * @returns {Promise<ArrayBuffer>} Decoded tile data.
- *
- * @throws {Error} If an uncompressed tile has the wrong size.
- * @throws {Error} If decompressed data exceeds the expected size.
- * @throws {Error} If decompressed data is shorter than expected.
- */
-export async function decodeCogTile(data, length, compression) {
-  if (compression === 1) {
-    if (data.byteLength !== length) throw /* alloc */ new Error('Invalid uncompressed COG tile size');
-    return data;
-  }
-  const stream = /* alloc */ new Blob(/* alloc */ [data]).stream()
-    .pipeThrough(/* alloc */ new DecompressionStream('deflate'));
-  const reader = stream.getReader(), result = /* alloc */ new Uint8Array(length);
-  let offset = 0, chunk;
-  try {
-    while (!(chunk = await reader.read()).done) {
-      if (offset + chunk.value.length > length) {
-        await reader.cancel();
-        throw /* alloc */ new Error('Oversized decoded COG tile');
-      }
-      result.set(chunk.value, offset);
-      offset += chunk.value.length;
-    }
-  } finally {
-    reader.releaseLock();
-  }
-  if (offset !== length) throw /* alloc */ new Error('Truncated decoded COG tile');
-  return result.buffer;
-}
+/**
+ * Decode an uncompressed or deflate-compressed COG tile to its expected byte length.
+ *
+ * @param {ArrayBuffer} data Encoded tile data.
+ * @param {number} length Expected decoded byte length.
+ * @param {number} compression TIFF compression code.
+ *
+ * @returns {Promise<ArrayBuffer>} Decoded tile data.
+ *
+ * @throws {Error} If an uncompressed tile has the wrong size.
+ * @throws {Error} If decompressed data exceeds the expected size.
+ * @throws {Error} If decompressed data is shorter than expected.
+ */
+export async function decodeCogTile(data, length, compression) {
+  if (compression === 1) {
+    if (data.byteLength !== length) throw /* alloc */ new Error('Invalid uncompressed COG tile size');
+    return data;
+  }
+  const stream = /* alloc */ new Blob(/* alloc */ [data]).stream()
+    .pipeThrough(/* alloc */ new DecompressionStream('deflate'));
+  const reader = stream.getReader(), result = /* alloc */ new Uint8Array(length);
+  let offset = 0, chunk;
+  try {
+    while (!(chunk = await reader.read()).done) {
+      if (offset + chunk.value.length > length) {
+        await reader.cancel();
+        throw /* alloc */ new Error('Oversized decoded COG tile');
+      }
+      result.set(chunk.value, offset);
+      offset += chunk.value.length;
+    }
+  } finally {
+    reader.releaseLock();
+  }
+  if (offset !== length) throw /* alloc */ new Error('Truncated decoded COG tile');
+  return result.buffer;
+}

package/src/cog/finiteCogValues.js

@@ -1,12 +1,12 @@
-/**
- * Check whether all provided values are finite.
- *
- * @param {ArrayLike<number>} values Values to inspect, if present.
- *
- * @returns {boolean} Whether every value is finite.
- */
-export function finiteCogValues(values) {
-  let value;
-  for (value of values || /* alloc */ []) if (!Number.isFinite(value)) return false;
-  return true;
-}
+/**
+ * Check whether all provided values are finite.
+ *
+ * @param {ArrayLike<number>} values Values to inspect, if present.
+ *
+ * @returns {boolean} Whether every value is finite.
+ */
+export function finiteCogValues(values) {
+  let value;
+  for (value of values || /* alloc */ []) if (!Number.isFinite(value)) return false;
+  return true;
+}

package/src/cog/getCogAssetEntry.js

@@ -1,26 +1,26 @@
-import { decompress } from '../archives/decompress.js';
-import { readCog } from './readCog.js';
-
-/**
- * Read and validate a named COG asset entry from PMTiles metadata.
- *
- * @param {Object} container Container byte source.
- * @param {Object} header Decoded PMTiles header.
- * @param {string} asset Asset name.
- *
- * @returns {Promise<Object>} Validated asset entry.
- *
- * @throws {Error} If metadata does not contain a valid bounded asset.
- */
-export async function getCogAssetEntry(container, header, asset) {
-  const metadata = JSON.parse(/* alloc */ new TextDecoder().decode(await decompress(
-    await readCog(container, header.jsonMetadataOffset, header.jsonMetadataLength), header.internalCompression)));
-  const assets = metadata.cog_assets || /* alloc */ {};
-  const entry = Object.hasOwn(assets, asset) ? metadata.cog_assets[asset] : null;
-  if (metadata.format !== 'cog-assets-v1' || !entry || !Number.isSafeInteger(entry.offset) ||
-    !Number.isSafeInteger(entry.length) || entry.offset < 0 || entry.length < 8 ||
-    entry.offset + entry.length > header.tileDataLength) {
-    throw /* alloc */ new Error(`Invalid or missing PMTiles COG asset: ${asset}`);
-  }
-  return entry;
-}
+import { decompress } from '../archives/decompress.js';
+import { readCog } from './readCog.js';
+
+/**
+ * Read and validate a named COG asset entry from PMTiles metadata.
+ *
+ * @param {Object} container Container byte source.
+ * @param {Object} header Decoded PMTiles header.
+ * @param {string} asset Asset name.
+ *
+ * @returns {Promise<Object>} Validated asset entry.
+ *
+ * @throws {Error} If metadata does not contain a valid bounded asset.
+ */
+export async function getCogAssetEntry(container, header, asset) {
+  const metadata = JSON.parse(/* alloc */ new TextDecoder().decode(await decompress(
+    await readCog(container, header.jsonMetadataOffset, header.jsonMetadataLength), header.internalCompression)));
+  const assets = metadata.cog_assets || /* alloc */ {};
+  const entry = Object.hasOwn(assets, asset) ? metadata.cog_assets[asset] : null;
+  if (metadata.format !== 'cog-assets-v1' || !entry || !Number.isSafeInteger(entry.offset) ||
+    !Number.isSafeInteger(entry.length) || entry.offset < 0 || entry.length < 8 ||
+    entry.offset + entry.length > header.tileDataLength) {
+    throw /* alloc */ new Error(`Invalid or missing PMTiles COG asset: ${asset}`);
+  }
+  return entry;
+}

package/src/cog/getCogBase.js

@@ -1,22 +1,22 @@
-import { hasCogProjection } from './hasCogProjection.js';
-import { validCogGeoArrays } from './validCogGeoArrays.js';
-
-/**
- * Extract the base image's north-up Web Mercator georeferencing.
- *
- * @param {Map} tags TIFF tags.
- * @param {number} width Base image width.
- * @param {number} height Base image height.
- * @param {boolean} elevation Whether the image stores elevation.
- *
- * @returns {Object} Base dimensions, resolution, origin and elevation flag.
- *
- * @throws {Error} If georeferencing is not north-up EPSG:3857 PixelIsArea.
- */
-export function getCogBase(tags, width, height, elevation) {
-  const keys = tags.get(34735), scale = tags.get(33550), tie = tags.get(33922);
-  if (!validCogGeoArrays(keys, scale, tie) || !hasCogProjection(keys)) {
-    throw /* alloc */ new Error('COG must use north-up EPSG:3857 PixelIsArea georeferencing');
-  }
-  return /* alloc */ { width, height, resolution: scale[0], left: tie[3], top: tie[4], elevation };
-}
+import { hasCogProjection } from './hasCogProjection.js';
+import { validCogGeoArrays } from './validCogGeoArrays.js';
+
+/**
+ * Extract the base image's north-up Web Mercator georeferencing.
+ *
+ * @param {Map} tags TIFF tags.
+ * @param {number} width Base image width.
+ * @param {number} height Base image height.
+ * @param {boolean} elevation Whether the image stores elevation.
+ *
+ * @returns {Object} Base dimensions, resolution, origin and elevation flag.
+ *
+ * @throws {Error} If georeferencing is not north-up EPSG:3857 PixelIsArea.
+ */
+export function getCogBase(tags, width, height, elevation) {
+  const keys = tags.get(34735), scale = tags.get(33550), tie = tags.get(33922);
+  if (!validCogGeoArrays(keys, scale, tie) || !hasCogProjection(keys)) {
+    throw /* alloc */ new Error('COG must use north-up EPSG:3857 PixelIsArea georeferencing');
+  }
+  return /* alloc */ { width, height, resolution: scale[0], left: tie[3], top: tie[4], elevation };
+}

package/src/cog/getCogHeader.js

@@ -1,10 +1,10 @@
-/**
- * Return the synthesized archive header for a COG source.
- *
- * @param {Object} source Open COG source.
- *
- * @returns {Object} Source header.
- */
-export function getCogHeader(source) {
-  return source.header;
-}
+/**
+ * Return the synthesized archive header for a COG source.
+ *
+ * @param {Object} source Open COG source.
+ *
+ * @returns {Object} Source header.
+ */
+export function getCogHeader(source) {
+  return source.header;
+}

package/src/cog/getCogProfile.js

@@ -1,25 +1,25 @@
-import { validCogDimensions } from './validCogDimensions.js';
-import { validCogEncoding } from './validCogEncoding.js';
-
-/**
- * Extract and validate a supported tiled color or elevation TIFF profile.
- *
- * @param {Map} tags TIFF tags.
- *
- * @returns {Object} Image dimensions, sample count and elevation flag.
- *
- * @throws {Error} If the TIFF dimensions or encoding are unsupported.
- */
-export function getCogProfile(tags) {
-  const width = tags.get(256)?.[0], height = tags.get(257)?.[0], samples = tags.get(277)?.[0] ?? 1;
-  const bits = tags.get(258), format = tags.get(339) || /* alloc */ [1];
-  let bytes = true, unsigned = true, floating = true, value;
-  for (value of bits || /* alloc */ []) bytes &&= value === 8;
-  for (value of format) { unsigned &&= value === 1; floating &&= value === 3; }
-  const elevation = samples === 1 && bits?.length === 1 && bits[0] === 32 && floating;
-  if (!validCogDimensions(tags, width, height) ||
-    !validCogEncoding(tags, samples, bits, format, elevation, bytes, unsigned)) {
-    throw /* alloc */ new Error('Unsupported COG profile: expected tiled 256px RGB(A) Uint8 or Float32, DEFLATE without predictor');
-  }
-  return /* alloc */ { width, height, samples, elevation };
-}
+import { validCogDimensions } from './validCogDimensions.js';
+import { validCogEncoding } from './validCogEncoding.js';
+
+/**
+ * Extract and validate a supported tiled color or elevation TIFF profile.
+ *
+ * @param {Map} tags TIFF tags.
+ *
+ * @returns {Object} Image dimensions, sample count and elevation flag.
+ *
+ * @throws {Error} If the TIFF dimensions or encoding are unsupported.
+ */
+export function getCogProfile(tags) {
+  const width = tags.get(256)?.[0], height = tags.get(257)?.[0], samples = tags.get(277)?.[0] ?? 1;
+  const bits = tags.get(258), format = tags.get(339) || /* alloc */ [1];
+  let bytes = true, unsigned = true, floating = true, value;
+  for (value of bits || /* alloc */ []) bytes &&= value === 8;
+  for (value of format) { unsigned &&= value === 1; floating &&= value === 3; }
+  const elevation = samples === 1 && bits?.length === 1 && bits[0] === 32 && floating;
+  if (!validCogDimensions(tags, width, height) ||
+    !validCogEncoding(tags, samples, bits, format, elevation, bytes, unsigned)) {
+    throw /* alloc */ new Error('Unsupported COG profile: expected tiled 256px RGB(A) Uint8 or Float32, DEFLATE without predictor');
+  }
+  return /* alloc */ { width, height, samples, elevation };
+}

package/src/cog/getCogTile.js

@@ -1,25 +1,25 @@
-import { getElevationTile } from './getElevationTile.js';
-import { getColorTile } from './getColorTile.js';
-import { validCogTileCoordinates } from './validCogTileCoordinates.js';
-
-/**
- * Read an XYZ color or elevation tile from an open COG, if covered by a level.
- *
- * @param {Object} source Open COG source.
- * @param {number} z Tile zoom.
- * @param {number} x Tile column.
- * @param {number} y Tile row.
- * @param {AbortSignal} [signal] Request cancellation signal.
- *
- * @returns {Promise<Object|undefined>} Tile image or elevation data, if covered.
- *
- * @throws {Error} If tile coordinates are invalid.
- */
-export async function getCogTile(source, z, x, y, signal) {
-  signal?.throwIfAborted();
-  if (!validCogTileCoordinates(z, x, y)) throw /* alloc */ new Error('Invalid COG tile coordinates');
-  const level = source.levels.get(z);
-  if (!level || x + 1 <= level.x || y + 1 <= level.y || x >= level.x + level.columns || y >= level.y + level.rows) return;
-  if (level.elevation) return getElevationTile(source, level, x, y, signal);
-  return getColorTile(source, level, x, y, signal);
-}
+import { getElevationTile } from './getElevationTile.js';
+import { getColorTile } from './getColorTile.js';
+import { validCogTileCoordinates } from './validCogTileCoordinates.js';
+
+/**
+ * Read an XYZ color or elevation tile from an open COG, if covered by a level.
+ *
+ * @param {Object} source Open COG source.
+ * @param {number} z Tile zoom.
+ * @param {number} x Tile column.
+ * @param {number} y Tile row.
+ * @param {AbortSignal} [signal] Request cancellation signal.
+ *
+ * @returns {Promise<Object|undefined>} Tile image or elevation data, if covered.
+ *
+ * @throws {Error} If tile coordinates are invalid.
+ */
+export async function getCogTile(source, z, x, y, signal) {
+  signal?.throwIfAborted();
+  if (!validCogTileCoordinates(z, x, y)) throw /* alloc */ new Error('Invalid COG tile coordinates');
+  const level = source.levels.get(z);
+  if (!level || x + 1 <= level.x || y + 1 <= level.y || x >= level.x + level.columns || y >= level.y + level.rows) return;
+  if (level.elevation) return getElevationTile(source, level, x, y, signal);
+  return getColorTile(source, level, x, y, signal);
+}

package/src/cog/getColorTile.js

@@ -1,38 +1,38 @@
-import { readCogBlock } from './readCogBlock.js';
-
-/**
- * Composite the COG color blocks overlapping an XYZ tile into an image bitmap.
- *
- * @param {Object} source Open COG source.
- * @param {Object} level COG overview level.
- * @param {number} x XYZ tile column.
- * @param {number} y XYZ tile row.
- * @param {AbortSignal} [signal] Request cancellation signal.
- *
- * @returns {Promise<Object>} Object containing the resulting image bitmap.
- *
- * @throws {Error} If a 2D canvas context cannot be created.
- */
-export async function getColorTile(source, level, x, y, signal) {
-  const canvas = /* alloc */ new OffscreenCanvas(256, 256), context = canvas.getContext('2d');
-  if (!context) throw /* alloc */ new Error('Unable to create COG tile canvas');
-  const left = (x - level.x) * 256, top = (y - level.y) * 256;
-  let bx, by, pixels, rgba, i, j, bitmap;
-  for (by = Math.max(0, Math.floor(top / 256)); by < Math.min(level.rows, Math.ceil(top / 256 + 1)); by++) {
-    for (bx = Math.max(0, Math.floor(left / 256)); bx < Math.min(level.columns, Math.ceil(left / 256 + 1)); bx++) {
-      pixels = /* alloc */ new Uint8Array(await readCogBlock(source, level, bx, by, signal));
-      signal?.throwIfAborted();
-      rgba = /* alloc */ new Uint8ClampedArray(256 * 256 * 4);
-      for (i = 0, j = 0; i < pixels.length; i += level.samples, j += 4) {
-        rgba[j] = pixels[i]; rgba[j + 1] = pixels[i + 1]; rgba[j + 2] = pixels[i + 2];
-        rgba[j + 3] = level.samples === 4 ? pixels[i + 3] : 255;
-      }
-      bitmap = await createImageBitmap(/* alloc */ new ImageData(rgba, 256, 256));
-      context.drawImage(bitmap, bx * 256 - left, by * 256 - top);
-      bitmap.close();
-    }
-  }
-  const image = canvas.transferToImageBitmap();
-  if (signal?.aborted) { image.close(); signal.throwIfAborted(); }
-  return /* alloc */ { image };
-}
+import { readCogBlock } from './readCogBlock.js';
+
+/**
+ * Composite the COG color blocks overlapping an XYZ tile into an image bitmap.
+ *
+ * @param {Object} source Open COG source.
+ * @param {Object} level COG overview level.
+ * @param {number} x XYZ tile column.
+ * @param {number} y XYZ tile row.
+ * @param {AbortSignal} [signal] Request cancellation signal.
+ *
+ * @returns {Promise<Object>} Object containing the resulting image bitmap.
+ *
+ * @throws {Error} If a 2D canvas context cannot be created.
+ */
+export async function getColorTile(source, level, x, y, signal) {
+  const canvas = /* alloc */ new OffscreenCanvas(256, 256), context = canvas.getContext('2d');
+  if (!context) throw /* alloc */ new Error('Unable to create COG tile canvas');
+  const left = (x - level.x) * 256, top = (y - level.y) * 256;
+  let bx, by, pixels, rgba, i, j, bitmap;
+  for (by = Math.max(0, Math.floor(top / 256)); by < Math.min(level.rows, Math.ceil(top / 256 + 1)); by++) {
+    for (bx = Math.max(0, Math.floor(left / 256)); bx < Math.min(level.columns, Math.ceil(left / 256 + 1)); bx++) {
+      pixels = /* alloc */ new Uint8Array(await readCogBlock(source, level, bx, by, signal));
+      signal?.throwIfAborted();
+      rgba = /* alloc */ new Uint8ClampedArray(256 * 256 * 4);
+      for (i = 0, j = 0; i < pixels.length; i += level.samples, j += 4) {
+        rgba[j] = pixels[i]; rgba[j + 1] = pixels[i + 1]; rgba[j + 2] = pixels[i + 2];
+        rgba[j + 3] = level.samples === 4 ? pixels[i + 3] : 255;
+      }
+      bitmap = await createImageBitmap(/* alloc */ new ImageData(rgba, 256, 256));
+      context.drawImage(bitmap, bx * 256 - left, by * 256 - top);
+      bitmap.close();
+    }
+  }
+  const image = canvas.transferToImageBitmap();
+  if (signal?.aborted) { image.close(); signal.throwIfAborted(); }
+  return /* alloc */ { image };
+}

package/src/cog/getElevationTile.js

@@ -1,29 +1,29 @@
-import { readCogBlock } from './readCogBlock.js';
-
-/**
- * Read and validate the Float32 elevation samples for an XYZ tile.
- *
- * @param {Object} source Open COG source.
- * @param {Object} level COG elevation level.
- * @param {number} x XYZ tile column.
- * @param {number} y XYZ tile row.
- * @param {AbortSignal} [signal] Request cancellation signal.
- *
- * @returns {Promise<Object>} Object containing the elevation buffer.
- *
- * @throws {Error} If an elevation sample is non-finite or outside the supported range.
- */
-export async function getElevationTile(source, level, x, y, signal) {
-  const data = await readCogBlock(source, level, x - level.x, y - level.y, signal);
-  signal?.throwIfAborted();
-  const view = /* alloc */ new DataView(data), heights = /* alloc */ new Float32Array(256 * 256);
-  let i, height;
-  for (i = 0; i < heights.length; i++) {
-    height = view.getFloat32(i * 4, source.little);
-    if (!Number.isFinite(height) || height < -12000 || height > 10000) {
-      throw /* alloc */ new Error('Invalid or missing COG elevation sample');
-    }
-    heights[i] = height;
-  }
-  return /* alloc */ { data: heights.buffer };
-}
+import { readCogBlock } from './readCogBlock.js';
+
+/**
+ * Read and validate the Float32 elevation samples for an XYZ tile.
+ *
+ * @param {Object} source Open COG source.
+ * @param {Object} level COG elevation level.
+ * @param {number} x XYZ tile column.
+ * @param {number} y XYZ tile row.
+ * @param {AbortSignal} [signal] Request cancellation signal.
+ *
+ * @returns {Promise<Object>} Object containing the elevation buffer.
+ *
+ * @throws {Error} If an elevation sample is non-finite or outside the supported range.
+ */
+export async function getElevationTile(source, level, x, y, signal) {
+  const data = await readCogBlock(source, level, x - level.x, y - level.y, signal);
+  signal?.throwIfAborted();
+  const view = /* alloc */ new DataView(data), heights = /* alloc */ new Float32Array(256 * 256);
+  let i, height;
+  for (i = 0; i < heights.length; i++) {
+    height = view.getFloat32(i * 4, source.little);
+    if (!Number.isFinite(height) || height < -12000 || height > 10000) {
+      throw /* alloc */ new Error('Invalid or missing COG elevation sample');
+    }
+    heights[i] = height;
+  }
+  return /* alloc */ { data: heights.buffer };
+}

package/src/cog/hasCogProjection.js

@@ -1,16 +1,16 @@
-/**
- * Check GeoTIFF keys for EPSG:3857 and PixelIsArea.
- *
- * @param {ArrayLike<number>} keys GeoKey directory values, if present.
- *
- * @returns {boolean} Whether both required keys are present.
- */
-export function hasCogProjection(keys) {
-  let projected = false, area = false, i;
-  if (keys) for (i = 4; i < keys.length; i += 4) {
-    if (keys[i + 1] !== 0 || keys[i + 2] !== 1) continue;
-    if (keys[i] === 3072 && keys[i + 3] === 3857) projected = true;
-    if (keys[i] === 1025 && keys[i + 3] === 1) area = true;
-  }
-  return projected && area;
-}
+/**
+ * Check GeoTIFF keys for EPSG:3857 and PixelIsArea.
+ *
+ * @param {ArrayLike<number>} keys GeoKey directory values, if present.
+ *
+ * @returns {boolean} Whether both required keys are present.
+ */
+export function hasCogProjection(keys) {
+  let projected = false, area = false, i;
+  if (keys) for (i = 4; i < keys.length; i += 4) {
+    if (keys[i + 1] !== 0 || keys[i + 2] !== 1) continue;
+    if (keys[i] === 3072 && keys[i + 3] === 3857) projected = true;
+    if (keys[i] === 1025 && keys[i + 3] === 1) area = true;
+  }
+  return projected && area;
+}

package/src/cog/initCog.js

@@ -1,13 +1,13 @@
-import { initRaster } from '../raster/initRaster.js';
-import { openCogInWorker } from '../workers/openCogInWorker.js';
-
-/**
- * Initialize a raster layer backed by a COG archive or a worker-opened COG source.
- *
- * @param {L.Layer} layer Raster layer to initialize.
- * @param {Object} options Layer and COG source options.
- */
-export function initCog(layer, options) {
-  initRaster(layer, /* alloc */ { ariaLabel: 'COG raster', ...options,
-    archive: options.archive || openCogInWorker(layer, options) });
-}
+import { initRaster } from '../raster/initRaster.js';
+import { openCogInWorker } from '../workers/openCogInWorker.js';
+
+/**
+ * Initialize a raster layer backed by a COG archive or a worker-opened COG source.
+ *
+ * @param {L.Layer} layer Raster layer to initialize.
+ * @param {Object} options Layer and COG source options.
+ */
+export function initCog(layer, options) {
+  initRaster(layer, /* alloc */ { ariaLabel: 'COG raster', ...options,
+    archive: options.archive || openCogInWorker(layer, options) });
+}

package/src/cog/invalidCogFullResponse.js

@@ -1,10 +1,10 @@
-/**
- * Check whether a non-range COG response has an unsupported status or declared size.
- *
- * @param {Response} response HTTP response.
- *
- * @returns {boolean} Whether the full response is unacceptable.
- */
-export function invalidCogFullResponse(response) {
-  return response.status !== 200 || Number(response.headers.get('Content-Length')) > 32000000;
-}
+/**
+ * Check whether a non-range COG response has an unsupported status or declared size.
+ *
+ * @param {Response} response HTTP response.
+ *
+ * @returns {boolean} Whether the full response is unacceptable.
+ */
+export function invalidCogFullResponse(response) {
+  return response.status !== 200 || Number(response.headers.get('Content-Length')) > 32000000;
+}