@accelint/map-toolkit 1.5.0 → 3.0.0

package/dist/shared/units.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0
@@ -13,61 +13,10 @@
 
 //#region src/shared/units.ts
 /**
-* Map of Turf.js unit names to display abbreviations.
-* These are the practical units users would select for map measurements.
-*/
-const DISTANCE_UNIT_ABBREVIATIONS = {
-	kilometers: "km",
-	meters: "m",
-	nauticalmiles: "nm",
-	miles: "mi",
-	feet: "ft"
-};
-/**
 * Default distance units for geographic measurements.
 */
 const DEFAULT_DISTANCE_UNITS = "kilometers";
-/**
-* Get the full Turf.js unit name from an abbreviation.
-*
-* @param abbrev - The abbreviation (e.g., 'km', 'nm')
-* @returns The full unit name (e.g., 'kilometers', 'nauticalmiles') or undefined
-*
-* @example
-* ```typescript
-* import { getDistanceUnitFromAbbreviation } from '@accelint/map-toolkit/shared';
-*
-* const unit = getDistanceUnitFromAbbreviation('km');
-* console.log(unit); // 'kilometers'
-*
-* const unknown = getDistanceUnitFromAbbreviation('invalid');
-* console.log(unknown); // undefined
-* ```
-*/
-function getDistanceUnitFromAbbreviation(abbrev) {
-	return Object.entries(DISTANCE_UNIT_ABBREVIATIONS).find(([, a]) => a === abbrev)?.[0];
-}
-/**
-* Get the abbreviation for a Turf.js unit name.
-*
-* @param unit - The full unit name (e.g., 'kilometers')
-* @returns The abbreviation (e.g., 'km') or the input if not found
-*
-* @example
-* ```typescript
-* import { getDistanceUnitAbbreviation } from '@accelint/map-toolkit/shared';
-*
-* const abbrev = getDistanceUnitAbbreviation('kilometers');
-* console.log(abbrev); // 'km'
-*
-* const fallback = getDistanceUnitAbbreviation('unknown');
-* console.log(fallback); // 'unknown'
-* ```
-*/
-function getDistanceUnitAbbreviation(unit) {
-	return DISTANCE_UNIT_ABBREVIATIONS[unit] ?? unit;
-}
 
 //#endregion
-export { DEFAULT_DISTANCE_UNITS, DISTANCE_UNIT_ABBREVIATIONS, getDistanceUnitAbbreviation, getDistanceUnitFromAbbreviation };
+export { DEFAULT_DISTANCE_UNITS };
 //# sourceMappingURL=units.js.map

package/dist/shared/units.js.map

@@ -1 +1 @@
-{"version":3,"file":"units.js","names":["DEFAULT_DISTANCE_UNITS: DistanceUnit"],"sources":["../../src/shared/units.ts"],"sourcesContent":["/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n/**\n * Map of Turf.js unit names to display abbreviations.\n * These are the practical units users would select for map measurements.\n */\nexport const DISTANCE_UNIT_ABBREVIATIONS = {\n  kilometers: 'km',\n  meters: 'm',\n  nauticalmiles: 'nm',\n  miles: 'mi',\n  feet: 'ft',\n} as const;\n\n/**\n * Turf.js unit name (e.g., 'kilometers', 'nauticalmiles').\n */\nexport type DistanceUnit = keyof typeof DISTANCE_UNIT_ABBREVIATIONS;\n\n/**\n * Display abbreviation (e.g., 'km', 'nm').\n */\nexport type DistanceUnitAbbreviation =\n  (typeof DISTANCE_UNIT_ABBREVIATIONS)[DistanceUnit];\n\n/**\n * Default distance units for geographic measurements.\n */\nexport const DEFAULT_DISTANCE_UNITS: DistanceUnit = 'kilometers';\n\n/**\n * Get the full Turf.js unit name from an abbreviation.\n *\n * @param abbrev - The abbreviation (e.g., 'km', 'nm')\n * @returns The full unit name (e.g., 'kilometers', 'nauticalmiles') or undefined\n *\n * @example\n * ```typescript\n * import { getDistanceUnitFromAbbreviation } from '@accelint/map-toolkit/shared';\n *\n * const unit = getDistanceUnitFromAbbreviation('km');\n * console.log(unit); // 'kilometers'\n *\n * const unknown = getDistanceUnitFromAbbreviation('invalid');\n * console.log(unknown); // undefined\n * ```\n */\nexport function getDistanceUnitFromAbbreviation(\n  abbrev: string,\n): DistanceUnit | undefined {\n  const entry = Object.entries(DISTANCE_UNIT_ABBREVIATIONS).find(\n    ([, a]) => a === abbrev,\n  );\n  return entry?.[0] as DistanceUnit | undefined;\n}\n\n/**\n * Get the abbreviation for a Turf.js unit name.\n *\n * @param unit - The full unit name (e.g., 'kilometers')\n * @returns The abbreviation (e.g., 'km') or the input if not found\n *\n * @example\n * ```typescript\n * import { getDistanceUnitAbbreviation } from '@accelint/map-toolkit/shared';\n *\n * const abbrev = getDistanceUnitAbbreviation('kilometers');\n * console.log(abbrev); // 'km'\n *\n * const fallback = getDistanceUnitAbbreviation('unknown');\n * console.log(fallback); // 'unknown'\n * ```\n */\nexport function getDistanceUnitAbbreviation(unit: string): string {\n  return DISTANCE_UNIT_ABBREVIATIONS[unit as DistanceUnit] ?? unit;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAgBA,MAAa,8BAA8B;CACzC,YAAY;CACZ,QAAQ;CACR,eAAe;CACf,OAAO;CACP,MAAM;CACP;;;;AAgBD,MAAaA,yBAAuC;;;;;;;;;;;;;;;;;;AAmBpD,SAAgB,gCACd,QAC0B;AAI1B,QAHc,OAAO,QAAQ,4BAA4B,CAAC,MACvD,GAAG,OAAO,MAAM,OAClB,GACc;;;;;;;;;;;;;;;;;;;AAoBjB,SAAgB,4BAA4B,MAAsB;AAChE,QAAO,4BAA4B,SAAyB"}
+{"version":3,"file":"units.js","names":["DEFAULT_DISTANCE_UNITS: DistanceUnit"],"sources":["../../src/shared/units.ts"],"sourcesContent":["/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport type { DistanceUnit } from '@accelint/constants/units';\n\n/**\n * Default distance units for geographic measurements.\n */\nexport const DEFAULT_DISTANCE_UNITS: DistanceUnit = 'kilometers';\n"],"mappings":";;;;;;;;;;;;;;;;;AAiBA,MAAaA,yBAAuC"}

package/dist/viewport/index.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0
@@ -10,9 +10,8 @@
  * governing permissions and limitations under the License.
  */
 
-import { DISTANCE_UNIT_ABBREVIATIONS, DistanceUnit, DistanceUnitAbbreviation, getDistanceUnitFromAbbreviation } from "../shared/units.js";
 import { clearViewportState, useMapViewport, viewportStore } from "./store.js";
-import { GeoCoordinate, GetViewportSizeArgs, SupportedDistanceUnit } from "./types.js";
+import { GeoCoordinate, GetViewportSizeArgs } from "./types.js";
 import { getViewportSize } from "./utils.js";
 import { ViewportSize, ViewportSizeProps } from "./viewport-size.js";
-export { DISTANCE_UNIT_ABBREVIATIONS, type DistanceUnit, type DistanceUnitAbbreviation, type GeoCoordinate, type GetViewportSizeArgs, type SupportedDistanceUnit, ViewportSize, type ViewportSizeProps, clearViewportState, getDistanceUnitFromAbbreviation, getViewportSize, useMapViewport, viewportStore };
+export { type GeoCoordinate, type GetViewportSizeArgs, ViewportSize, type ViewportSizeProps, clearViewportState, getViewportSize, useMapViewport, viewportStore };

package/dist/viewport/index.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0
@@ -11,9 +11,8 @@
  */
 
 
-import { DISTANCE_UNIT_ABBREVIATIONS, getDistanceUnitFromAbbreviation } from "../shared/units.js";
 import { clearViewportState, useMapViewport, viewportStore } from "./store.js";
 import { getViewportSize } from "./utils.js";
 import { ViewportSize } from "./viewport-size.js";
 
-export { DISTANCE_UNIT_ABBREVIATIONS, ViewportSize, clearViewportState, getDistanceUnitFromAbbreviation, getViewportSize, useMapViewport, viewportStore };
+export { ViewportSize, clearViewportState, getViewportSize, useMapViewport, viewportStore };

package/dist/viewport/store.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0

package/dist/viewport/store.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0

package/dist/viewport/types.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0
@@ -11,22 +11,26 @@
  */
 
 import { Bounds } from "../deckgl/base-map/types.js";
-import { DistanceUnitAbbreviation } from "../shared/units.js";
+import { DistanceUnitSymbol } from "@accelint/constants/units";
 
 //#region src/viewport/types.d.ts
-type SupportedDistanceUnit = DistanceUnitAbbreviation;
+/** Arguments for {@link getViewportSize}. */
 type GetViewportSizeArgs = {
   /** Geographic bounds, undefined if viewport not yet initialized */
   bounds?: Bounds;
+  /** Map zoom level for meters-per-pixel calculation. */
   zoom: number;
   /** Viewport width in pixels */
   width: number;
   /** Viewport height in pixels */
   height: number;
-  unit?: SupportedDistanceUnit;
+  /** Distance unit symbol. Defaults to `'NM'`. */
+  unit?: DistanceUnitSymbol;
+  /** Number formatter for localization. Defaults to `en-US`. */
   formatter?: Intl.NumberFormat;
 };
+/** A geographic coordinate as `[longitude, latitude]`. */
 type GeoCoordinate = [longitude: number, latitude: number];
 //#endregion
-export { GeoCoordinate, GetViewportSizeArgs, SupportedDistanceUnit };
+export { GeoCoordinate, GetViewportSizeArgs };
 //# sourceMappingURL=types.d.ts.map

package/dist/viewport/types.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0

package/dist/viewport/utils.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0
@@ -26,17 +26,17 @@ import { GetViewportSizeArgs } from "./types.js";
  * @param args.zoom - Zoom level for meters-per-pixel calculation
  * @param args.width - Viewport width in pixels
  * @param args.height - Viewport height in pixels
- * @param args.unit - Unit of distance measurement: `km | m | nm | mi | ft`. Defaults to `nm`
+ * @param args.unit - Unit symbol: `km | m | NM | mi | ft`. Defaults to `NM`
  * @param args.formatter - Number formatter for localization (defaults to en-US)
  * @returns Formatted string like "660 x 1,801 NM" or "-- x -- NM" if invalid
  *
  * @example
  * ```typescript
- * getViewportSize({ bounds: [-82, 22, -71, 52], zoom: 5, width: 800, height: 600, unit: 'nm' })
+ * getViewportSize({ bounds: [-82, 22, -71, 52], zoom: 5, width: 800, height: 600, unit: 'NM' })
  * // returns "612 x 459 NM"
  *
  * getViewportSize({ bounds: [170, 50, -170, 60], zoom: 4, width: 1024, height: 768, unit: 'km' })
- * // returns "2,050 x 1,538 KM"
+ * // returns "2,050 x 1,538 km"
  * ```
  */
 declare function getViewportSize({

package/dist/viewport/utils.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0
@@ -11,9 +11,11 @@
  */
 
 
-import { getDistanceUnitFromAbbreviation } from "../shared/units.js";
+import { createLoggerDomain } from "../shared/logger.js";
+import { DISTANCE_UNIT_BY_SYMBOL, DISTANCE_UNIT_SYMBOLS } from "@accelint/constants/units";
 
 //#region src/viewport/utils.ts
+const logger = createLoggerDomain("[Viewport]");
 const numberFormatter = Intl.NumberFormat("en-US");
 /**
 * Web Mercator constant: meters per pixel at zoom 0, equator.
@@ -42,21 +44,27 @@ const METERS_TO_UNIT = {
 * @param args.zoom - Zoom level for meters-per-pixel calculation
 * @param args.width - Viewport width in pixels
 * @param args.height - Viewport height in pixels
-* @param args.unit - Unit of distance measurement: `km | m | nm | mi | ft`. Defaults to `nm`
+* @param args.unit - Unit symbol: `km | m | NM | mi | ft`. Defaults to `NM`
 * @param args.formatter - Number formatter for localization (defaults to en-US)
 * @returns Formatted string like "660 x 1,801 NM" or "-- x -- NM" if invalid
 *
 * @example
 * ```typescript
-* getViewportSize({ bounds: [-82, 22, -71, 52], zoom: 5, width: 800, height: 600, unit: 'nm' })
+* getViewportSize({ bounds: [-82, 22, -71, 52], zoom: 5, width: 800, height: 600, unit: 'NM' })
 * // returns "612 x 459 NM"
 *
 * getViewportSize({ bounds: [170, 50, -170, 60], zoom: 4, width: 1024, height: 768, unit: 'km' })
-* // returns "2,050 x 1,538 KM"
+* // returns "2,050 x 1,538 km"
 * ```
 */
-function getViewportSize({ bounds, zoom, width: pixelWidth, height: pixelHeight, unit = "nm", formatter = numberFormatter }) {
-	const defaultValue = `-- x -- ${unit.toUpperCase()}`;
+function getViewportSize({ bounds, zoom, width: pixelWidth, height: pixelHeight, unit = "NM", formatter = numberFormatter }) {
+	const defaultValue = `-- x -- ${unit}`;
+	const unitKey = DISTANCE_UNIT_BY_SYMBOL[unit];
+	if (!unitKey) {
+		const validSymbols = Object.values(DISTANCE_UNIT_SYMBOLS).join(", ");
+		logger.error(`Invalid distance unit symbol: "${unit}". Expected one of: ${validSymbols}`);
+		return defaultValue;
+	}
 	if (!bounds || bounds.every((b) => Number.isNaN(b))) return defaultValue;
 	if (Number.isNaN(zoom) || pixelWidth === 0 || pixelHeight === 0) return defaultValue;
 	const [, minLat, , maxLat] = bounds;
@@ -65,10 +73,10 @@ function getViewportSize({ bounds, zoom, width: pixelWidth, height: pixelHeight,
 	const metersPerPixel = METERS_PER_PIXEL_AT_ZOOM_0 * Math.cos(centerLat * Math.PI / 180) / 2 ** zoom;
 	const widthMeters = pixelWidth * metersPerPixel;
 	const heightMeters = pixelHeight * metersPerPixel;
-	const conversionFactor = METERS_TO_UNIT[getDistanceUnitFromAbbreviation(unit)];
+	const conversionFactor = METERS_TO_UNIT[unitKey];
 	const widthDistance = Math.round(widthMeters * conversionFactor);
 	const heightDistance = Math.round(heightMeters * conversionFactor);
-	return `${formatter.format(widthDistance)} x ${formatter.format(heightDistance)} ${unit.toUpperCase()}`;
+	return `${formatter.format(widthDistance)} x ${formatter.format(heightDistance)} ${unit}`;
 }
 
 //#endregion

package/dist/viewport/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","names":[],"sources":["../../src/viewport/utils.ts"],"sourcesContent":["/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport {\n  type DistanceUnit,\n  getDistanceUnitFromAbbreviation,\n} from '../shared/units';\nimport type { GetViewportSizeArgs } from './types';\n\nconst numberFormatter = Intl.NumberFormat('en-US');\n\n/**\n * Web Mercator constant: meters per pixel at zoom 0, equator.\n * This is Earth's circumference (40075016.686m) divided by 256 (tile size).\n */\nconst METERS_PER_PIXEL_AT_ZOOM_0 = 156543.03392;\n\n/**\n * Unit conversion factors from meters.\n */\nconst METERS_TO_UNIT = {\n  kilometers: 0.001,\n  meters: 1,\n  nauticalmiles: 0.000539957,\n  miles: 0.000621371,\n  feet: 3.28084,\n} as const;\n\n/**\n * Returns a formatted viewport size string i.e. `660 x 1,801 NM`\n *\n * Calculates the geographic distance of the viewport using zoom level and\n * pixel dimensions with the Web Mercator projection formula. This approach\n * provides stable results without the edge cases of bounds-based calculations.\n *\n * @param args - Viewport size calculation arguments\n * @param args.bounds - Geographic bounds [minLon, minLat, maxLon, maxLat]\n * @param args.zoom - Zoom level for meters-per-pixel calculation\n * @param args.width - Viewport width in pixels\n * @param args.height - Viewport height in pixels\n * @param args.unit - Unit of distance measurement: `km | m | nm | mi | ft`. Defaults to `nm`\n * @param args.formatter - Number formatter for localization (defaults to en-US)\n * @returns Formatted string like \"660 x 1,801 NM\" or \"-- x -- NM\" if invalid\n *\n * @example\n * ```typescript\n * getViewportSize({ bounds: [-82, 22, -71, 52], zoom: 5, width: 800, height: 600, unit: 'nm' })\n * // returns \"612 x 459 NM\"\n *\n * getViewportSize({ bounds: [170, 50, -170, 60], zoom: 4, width: 1024, height: 768, unit: 'km' })\n * // returns \"2,050 x 1,538 KM\"\n * ```\n */\nexport function getViewportSize({\n  bounds,\n  zoom,\n  width: pixelWidth,\n  height: pixelHeight,\n  unit = 'nm',\n  formatter = numberFormatter,\n}: GetViewportSizeArgs) {\n  const defaultValue = `-- x -- ${unit.toUpperCase()}`;\n\n  // Validate inputs\n  if (!bounds || bounds.every((b) => Number.isNaN(b))) {\n    return defaultValue;\n  }\n\n  if (Number.isNaN(zoom) || pixelWidth === 0 || pixelHeight === 0) {\n    return defaultValue;\n  }\n\n  const [, minLat, , maxLat] = bounds;\n\n  // Validate latitude bounds are within valid geographic ranges\n  if (minLat < -90 || minLat > 90 || maxLat < -90 || maxLat > 90) {\n    return defaultValue;\n  }\n\n  // Calculate center latitude for the viewport\n  const centerLat = (minLat + maxLat) / 2;\n\n  // Web Mercator formula: meters per pixel at given zoom and latitude\n  // Resolution = 156543.03392 * cos(latitude * π/180) / 2^zoom\n  const metersPerPixel =\n    (METERS_PER_PIXEL_AT_ZOOM_0 * Math.cos((centerLat * Math.PI) / 180)) /\n    2 ** zoom;\n\n  // Calculate distances in meters\n  const widthMeters = pixelWidth * metersPerPixel;\n  const heightMeters = pixelHeight * metersPerPixel;\n\n  // Convert to requested unit\n  const unitKey = getDistanceUnitFromAbbreviation(unit) as DistanceUnit;\n  const conversionFactor = METERS_TO_UNIT[unitKey];\n\n  const widthDistance = Math.round(widthMeters * conversionFactor);\n  const heightDistance = Math.round(heightMeters * conversionFactor);\n\n  const width = formatter.format(widthDistance);\n  const height = formatter.format(heightDistance);\n\n  return `${width} x ${height} ${unit.toUpperCase()}`;\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAkBA,MAAM,kBAAkB,KAAK,aAAa,QAAQ;;;;;AAMlD,MAAM,6BAA6B;;;;AAKnC,MAAM,iBAAiB;CACrB,YAAY;CACZ,QAAQ;CACR,eAAe;CACf,OAAO;CACP,MAAM;CACP;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BD,SAAgB,gBAAgB,EAC9B,QACA,MACA,OAAO,YACP,QAAQ,aACR,OAAO,MACP,YAAY,mBACU;CACtB,MAAM,eAAe,WAAW,KAAK,aAAa;AAGlD,KAAI,CAAC,UAAU,OAAO,OAAO,MAAM,OAAO,MAAM,EAAE,CAAC,CACjD,QAAO;AAGT,KAAI,OAAO,MAAM,KAAK,IAAI,eAAe,KAAK,gBAAgB,EAC5D,QAAO;CAGT,MAAM,GAAG,UAAU,UAAU;AAG7B,KAAI,SAAS,OAAO,SAAS,MAAM,SAAS,OAAO,SAAS,GAC1D,QAAO;CAIT,MAAM,aAAa,SAAS,UAAU;CAItC,MAAM,iBACH,6BAA6B,KAAK,IAAK,YAAY,KAAK,KAAM,IAAI,GACnE,KAAK;CAGP,MAAM,cAAc,aAAa;CACjC,MAAM,eAAe,cAAc;CAInC,MAAM,mBAAmB,eADT,gCAAgC,KAAK;CAGrD,MAAM,gBAAgB,KAAK,MAAM,cAAc,iBAAiB;CAChE,MAAM,iBAAiB,KAAK,MAAM,eAAe,iBAAiB;AAKlE,QAAO,GAHO,UAAU,OAAO,cAAc,CAG7B,KAFD,UAAU,OAAO,eAAe,CAEnB,GAAG,KAAK,aAAa"}
+{"version":3,"file":"utils.js","names":[],"sources":["../../src/viewport/utils.ts"],"sourcesContent":["/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport {\n  DISTANCE_UNIT_BY_SYMBOL,\n  DISTANCE_UNIT_SYMBOLS,\n} from '@accelint/constants/units';\nimport { createLoggerDomain } from '../shared/logger';\nimport type { GetViewportSizeArgs } from './types';\n\nconst logger = createLoggerDomain('[Viewport]');\n\nconst numberFormatter = Intl.NumberFormat('en-US');\n\n/**\n * Web Mercator constant: meters per pixel at zoom 0, equator.\n * This is Earth's circumference (40075016.686m) divided by 256 (tile size).\n */\nconst METERS_PER_PIXEL_AT_ZOOM_0 = 156543.03392;\n\n/**\n * Unit conversion factors from meters.\n */\nconst METERS_TO_UNIT = {\n  kilometers: 0.001,\n  meters: 1,\n  nauticalmiles: 0.000539957,\n  miles: 0.000621371,\n  feet: 3.28084,\n} as const;\n\n/**\n * Returns a formatted viewport size string i.e. `660 x 1,801 NM`\n *\n * Calculates the geographic distance of the viewport using zoom level and\n * pixel dimensions with the Web Mercator projection formula. This approach\n * provides stable results without the edge cases of bounds-based calculations.\n *\n * @param args - Viewport size calculation arguments\n * @param args.bounds - Geographic bounds [minLon, minLat, maxLon, maxLat]\n * @param args.zoom - Zoom level for meters-per-pixel calculation\n * @param args.width - Viewport width in pixels\n * @param args.height - Viewport height in pixels\n * @param args.unit - Unit symbol: `km | m | NM | mi | ft`. Defaults to `NM`\n * @param args.formatter - Number formatter for localization (defaults to en-US)\n * @returns Formatted string like \"660 x 1,801 NM\" or \"-- x -- NM\" if invalid\n *\n * @example\n * ```typescript\n * getViewportSize({ bounds: [-82, 22, -71, 52], zoom: 5, width: 800, height: 600, unit: 'NM' })\n * // returns \"612 x 459 NM\"\n *\n * getViewportSize({ bounds: [170, 50, -170, 60], zoom: 4, width: 1024, height: 768, unit: 'km' })\n * // returns \"2,050 x 1,538 km\"\n * ```\n */\nexport function getViewportSize({\n  bounds,\n  zoom,\n  width: pixelWidth,\n  height: pixelHeight,\n  unit = 'NM',\n  formatter = numberFormatter,\n}: GetViewportSizeArgs) {\n  const defaultValue = `-- x -- ${unit}`;\n  const unitKey = DISTANCE_UNIT_BY_SYMBOL[unit];\n\n  if (!unitKey) {\n    const validSymbols = Object.values(DISTANCE_UNIT_SYMBOLS).join(', ');\n\n    logger.error(\n      `Invalid distance unit symbol: \"${unit}\". Expected one of: ${validSymbols}`,\n    );\n\n    return defaultValue;\n  }\n\n  // Validate inputs\n  if (!bounds || bounds.every((b) => Number.isNaN(b))) {\n    return defaultValue;\n  }\n\n  if (Number.isNaN(zoom) || pixelWidth === 0 || pixelHeight === 0) {\n    return defaultValue;\n  }\n\n  const [, minLat, , maxLat] = bounds;\n\n  // Validate latitude bounds are within valid geographic ranges\n  if (minLat < -90 || minLat > 90 || maxLat < -90 || maxLat > 90) {\n    return defaultValue;\n  }\n\n  // Calculate center latitude for the viewport\n  const centerLat = (minLat + maxLat) / 2;\n\n  // Web Mercator formula: meters per pixel at given zoom and latitude\n  // Resolution = 156543.03392 * cos(latitude * π/180) / 2^zoom\n  const metersPerPixel =\n    (METERS_PER_PIXEL_AT_ZOOM_0 * Math.cos((centerLat * Math.PI) / 180)) /\n    2 ** zoom;\n\n  // Calculate distances in meters\n  const widthMeters = pixelWidth * metersPerPixel;\n  const heightMeters = pixelHeight * metersPerPixel;\n\n  // Convert to requested unit\n  const conversionFactor = METERS_TO_UNIT[unitKey];\n\n  const widthDistance = Math.round(widthMeters * conversionFactor);\n  const heightDistance = Math.round(heightMeters * conversionFactor);\n\n  const width = formatter.format(widthDistance);\n  const height = formatter.format(heightDistance);\n\n  return `${width} x ${height} ${unit}`;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAmBA,MAAM,SAAS,mBAAmB,aAAa;AAE/C,MAAM,kBAAkB,KAAK,aAAa,QAAQ;;;;;AAMlD,MAAM,6BAA6B;;;;AAKnC,MAAM,iBAAiB;CACrB,YAAY;CACZ,QAAQ;CACR,eAAe;CACf,OAAO;CACP,MAAM;CACP;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BD,SAAgB,gBAAgB,EAC9B,QACA,MACA,OAAO,YACP,QAAQ,aACR,OAAO,MACP,YAAY,mBACU;CACtB,MAAM,eAAe,WAAW;CAChC,MAAM,UAAU,wBAAwB;AAExC,KAAI,CAAC,SAAS;EACZ,MAAM,eAAe,OAAO,OAAO,sBAAsB,CAAC,KAAK,KAAK;AAEpE,SAAO,MACL,kCAAkC,KAAK,sBAAsB,eAC9D;AAED,SAAO;;AAIT,KAAI,CAAC,UAAU,OAAO,OAAO,MAAM,OAAO,MAAM,EAAE,CAAC,CACjD,QAAO;AAGT,KAAI,OAAO,MAAM,KAAK,IAAI,eAAe,KAAK,gBAAgB,EAC5D,QAAO;CAGT,MAAM,GAAG,UAAU,UAAU;AAG7B,KAAI,SAAS,OAAO,SAAS,MAAM,SAAS,OAAO,SAAS,GAC1D,QAAO;CAIT,MAAM,aAAa,SAAS,UAAU;CAItC,MAAM,iBACH,6BAA6B,KAAK,IAAK,YAAY,KAAK,KAAM,IAAI,GACnE,KAAK;CAGP,MAAM,cAAc,aAAa;CACjC,MAAM,eAAe,cAAc;CAGnC,MAAM,mBAAmB,eAAe;CAExC,MAAM,gBAAgB,KAAK,MAAM,cAAc,iBAAiB;CAChE,MAAM,iBAAiB,KAAK,MAAM,eAAe,iBAAiB;AAKlE,QAAO,GAHO,UAAU,OAAO,cAAc,CAG7B,KAFD,UAAU,OAAO,eAAe,CAEnB,GAAG"}

package/dist/viewport/viewport-size.d.ts

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0
@@ -10,15 +10,16 @@
  * governing permissions and limitations under the License.
  */
 
-import { SupportedDistanceUnit } from "./types.js";
 import { ComponentPropsWithRef } from "react";
 import { UniqueId } from "@accelint/core";
-import * as react_jsx_runtime1 from "react/jsx-runtime";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+import { DistanceUnitSymbol } from "@accelint/constants/units";
 
 //#region src/viewport/viewport-size.d.ts
+/** Props for {@link ViewportSize}. */
 type ViewportSizeProps = ComponentPropsWithRef<'span'> & {
   instanceId: UniqueId;
-  unit?: SupportedDistanceUnit;
+  unit?: DistanceUnitSymbol;
 };
 /**
  * A span element displaying the current viewport bounds in the specified unit.
@@ -28,7 +29,7 @@ type ViewportSizeProps = ComponentPropsWithRef<'span'> & {
  *
  * @param props - Extends `<span>` props
  * @param props.instanceId - The id of the view to subscribe to
- * @param props.unit - Measure of distance: `km | m | nm | mi | ft`. Defaults to `nm`
+ * @param props.unit - Measure of distance: `km | m | NM | mi | ft`. Defaults to `NM`
  * @param props.className - CSS classes for styling
  *
  * @example
@@ -48,7 +49,7 @@ declare function ViewportSize({
   instanceId,
   unit,
   ...rest
-}: ViewportSizeProps): react_jsx_runtime1.JSX.Element;
+}: ViewportSizeProps): react_jsx_runtime0.JSX.Element;
 //#endregion
 export { ViewportSize, ViewportSizeProps };
 //# sourceMappingURL=viewport-size.d.ts.map

package/dist/viewport/viewport-size.js

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
  * This file is licensed to you under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License. You may obtain a copy
  * of the License at https://www.apache.org/licenses/LICENSE-2.0
@@ -24,7 +24,7 @@ import { jsx } from "react/jsx-runtime";
 *
 * @param props - Extends `<span>` props
 * @param props.instanceId - The id of the view to subscribe to
-* @param props.unit - Measure of distance: `km | m | nm | mi | ft`. Defaults to `nm`
+* @param props.unit - Measure of distance: `km | m | NM | mi | ft`. Defaults to `NM`
 * @param props.className - CSS classes for styling
 *
 * @example
@@ -40,7 +40,7 @@ import { jsx } from "react/jsx-runtime";
 * />
 * ```
 */
-function ViewportSize({ instanceId, unit = "nm", ...rest }) {
+function ViewportSize({ instanceId, unit = "NM", ...rest }) {
 	const { bounds, zoom, width, height } = useMapViewport(instanceId);
 	return /* @__PURE__ */ jsx("span", {
 		...rest,

package/dist/viewport/viewport-size.js.map

@@ -1 +1 @@
-{"version":3,"file":"viewport-size.js","names":[],"sources":["../../src/viewport/viewport-size.tsx"],"sourcesContent":["/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { useMapViewport } from './store';\nimport { getViewportSize } from './utils';\nimport type { UniqueId } from '@accelint/core';\nimport type { ComponentPropsWithRef } from 'react';\nimport type { SupportedDistanceUnit } from './types';\n\nexport type ViewportSizeProps = ComponentPropsWithRef<'span'> & {\n  instanceId: UniqueId;\n  unit?: SupportedDistanceUnit;\n};\n\n/**\n * A span element displaying the current viewport bounds in the specified unit.\n *\n * Displays the viewport dimensions in a format like `660 x 1,801 NM`.\n * Updates automatically as the viewport changes by subscribing to viewport events.\n *\n * @param props - Extends `<span>` props\n * @param props.instanceId - The id of the view to subscribe to\n * @param props.unit - Measure of distance: `km | m | nm | mi | ft`. Defaults to `nm`\n * @param props.className - CSS classes for styling\n *\n * @example\n * ```tsx\n * // Basic usage with default nautical miles\n * <ViewportSize instanceId=\"some-uuid\" />\n *\n * // With custom unit and styling\n * <ViewportSize\n *   instanceId=\"some-uuid\"\n *   unit=\"km\"\n *   className=\"text-sm text-gray-600\"\n * />\n * ```\n */\nexport function ViewportSize({\n  instanceId,\n  unit = 'nm',\n  ...rest\n}: ViewportSizeProps) {\n  const { bounds, zoom, width, height } = useMapViewport(instanceId);\n\n  return (\n    <span {...rest}>\n      {getViewportSize({ bounds, unit, zoom, width, height })}\n    </span>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CA,SAAgB,aAAa,EAC3B,YACA,OAAO,MACP,GAAG,QACiB;CACpB,MAAM,EAAE,QAAQ,MAAM,OAAO,WAAW,eAAe,WAAW;AAElE,QACE,oBAAC;EAAK,GAAI;YACP,gBAAgB;GAAE;GAAQ;GAAM;GAAM;GAAO;GAAQ,CAAC;GAClD"}
+{"version":3,"file":"viewport-size.js","names":[],"sources":["../../src/viewport/viewport-size.tsx"],"sourcesContent":["/*\n * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport { useMapViewport } from './store';\nimport { getViewportSize } from './utils';\nimport type { DistanceUnitSymbol } from '@accelint/constants/units';\nimport type { UniqueId } from '@accelint/core';\nimport type { ComponentPropsWithRef } from 'react';\n\n/** Props for {@link ViewportSize}. */\nexport type ViewportSizeProps = ComponentPropsWithRef<'span'> & {\n  instanceId: UniqueId;\n  unit?: DistanceUnitSymbol;\n};\n\n/**\n * A span element displaying the current viewport bounds in the specified unit.\n *\n * Displays the viewport dimensions in a format like `660 x 1,801 NM`.\n * Updates automatically as the viewport changes by subscribing to viewport events.\n *\n * @param props - Extends `<span>` props\n * @param props.instanceId - The id of the view to subscribe to\n * @param props.unit - Measure of distance: `km | m | NM | mi | ft`. Defaults to `NM`\n * @param props.className - CSS classes for styling\n *\n * @example\n * ```tsx\n * // Basic usage with default nautical miles\n * <ViewportSize instanceId=\"some-uuid\" />\n *\n * // With custom unit and styling\n * <ViewportSize\n *   instanceId=\"some-uuid\"\n *   unit=\"km\"\n *   className=\"text-sm text-gray-600\"\n * />\n * ```\n */\nexport function ViewportSize({\n  instanceId,\n  unit = 'NM',\n  ...rest\n}: ViewportSizeProps) {\n  const { bounds, zoom, width, height } = useMapViewport(instanceId);\n\n  return (\n    <span {...rest}>\n      {getViewportSize({ bounds, unit, zoom, width, height })}\n    </span>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgDA,SAAgB,aAAa,EAC3B,YACA,OAAO,MACP,GAAG,QACiB;CACpB,MAAM,EAAE,QAAQ,MAAM,OAAO,WAAW,eAAe,WAAW;AAElE,QACE,oBAAC;EAAK,GAAI;YACP,gBAAgB;GAAE;GAAQ;GAAM;GAAM;GAAO;GAAQ,CAAC;GAClD"}

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@accelint/map-toolkit",
   "description": "A collection of components and utilities to simplify visualizing and working with geospatial data.",
-  "version": "1.5.0",
+  "version": "3.0.0",
   "author": "https://hypergiant.com",
   "$schema": "https://json.schemastore.org/package",
   "devDependencies": {
-    "@deck.gl-community/editable-layers": "~9.1",
-    "@deck.gl/core": "~9.1",
-    "@deck.gl/extensions": "~9.1",
-    "@deck.gl/layers": "~9.1",
+    "@deck.gl-community/editable-layers": "~9.2",
+    "@deck.gl/core": "~9.2",
+    "@deck.gl/extensions": "~9.2",
+    "@deck.gl/layers": "~9.2",
     "@deckgl-fiber-renderer/dom": "^1.4.0",
     "@deckgl-fiber-renderer/shared": "^1.4.0",
     "@deckgl-fiber-renderer/types": "^1.4.0",
@@ -43,14 +43,17 @@
     "vite": "^7.2.7",
     "vitest": "^4.0.15",
     "@accelint/biome-config": "1.1.0",
-    "@accelint/bus": "3.0.2",
-    "@accelint/core": "0.5.2",
-    "@accelint/design-foundation": "3.0.0",
-    "@accelint/design-toolkit": "9.7.0",
+    "@accelint/bus": "4.0.0",
+    "@accelint/constants": "0.3.0",
+    "@accelint/core": "0.6.0",
+    "@accelint/design-foundation": "3.0.2",
+    "@accelint/design-toolkit": "9.9.0",
     "@accelint/geo": "0.6.0",
-    "@accelint/logger": "1.0.0",
-    "@accelint/smeegl": "0.3.5",
+    "@accelint/hotkey-manager": "1.0.2",
+    "@accelint/logger": "1.1.0",
     "@accelint/postcss-tailwind-css-modules": "1.0.1",
+    "@accelint/predicates": "0.5.2",
+    "@accelint/smeegl": "0.3.5",
     "@accelint/typescript-config": "0.1.4",
     "@accelint/vitest-config": "0.1.6"
   },
@@ -75,6 +78,11 @@
     "./deckgl/base-map/events": "./dist/deckgl/base-map/events.js",
     "./deckgl/base-map/provider": "./dist/deckgl/base-map/provider.js",
     "./deckgl/base-map/types": "./dist/deckgl/base-map/types.js",
+    "./deckgl/extensions": "./dist/deckgl/extensions/index.js",
+    "./deckgl/extensions/coffin-corner": "./dist/deckgl/extensions/coffin-corner/index.js",
+    "./deckgl/extensions/coffin-corner/coffin-corner-extension": "./dist/deckgl/extensions/coffin-corner/coffin-corner-extension.js",
+    "./deckgl/extensions/coffin-corner/types": "./dist/deckgl/extensions/coffin-corner/types.js",
+    "./deckgl/extensions/coffin-corner/use-coffin-corner": "./dist/deckgl/extensions/coffin-corner/use-coffin-corner.js",
     "./deckgl/saved-viewports": "./dist/deckgl/saved-viewports/index.js",
     "./deckgl/saved-viewports/storage": "./dist/deckgl/saved-viewports/storage.js",
     "./deckgl/shapes": "./dist/deckgl/shapes/index.js",
@@ -139,10 +147,10 @@
   ],
   "license": "Apache-2.0",
   "optionalDependencies": {
-    "@deck.gl-community/editable-layers": "~9.1",
-    "@deck.gl/core": "~9.1",
-    "@deck.gl/extensions": "~9.1",
-    "@deck.gl/layers": "~9.1",
+    "@deck.gl-community/editable-layers": "~9.2",
+    "@deck.gl/core": "~9.2",
+    "@deck.gl/extensions": "~9.2",
+    "@deck.gl/layers": "~9.2",
     "@deckgl-fiber-renderer/dom": "^1.4.0",
     "@deckgl-fiber-renderer/shared": "^1.4.0",
     "@deckgl-fiber-renderer/types": "^1.4.0",
@@ -152,17 +160,18 @@
     "maplibre-gl": "^5.7.1",
     "milsymbol": "^3.0.2",
     "mjolnir.js": "^3.0.0",
-    "react-map-gl": "^8.1.0",
-    "@accelint/hotkey-manager": "1.0.1"
+    "react-map-gl": "^8.1.0"
   },
   "owner": "default/pathfinder",
   "peerDependencies": {
     "@types/geojson": "^7946.0.14",
     "react": "^19",
-    "@accelint/bus": "3.0.2",
-    "@accelint/core": "0.5.2",
+    "@accelint/bus": "4.0.0",
+    "@accelint/constants": "0.3.0",
+    "@accelint/core": "0.6.0",
     "@accelint/geo": "0.6.0",
-    "@accelint/logger": "1.0.0"
+    "@accelint/hotkey-manager": "1.0.2",
+    "@accelint/logger": "1.1.0"
   },
   "private": false,
   "publishConfig": {

package/dist/hotkey-manager/dist/react/use-hotkey.js

@@ -1,39 +0,0 @@
-/*
- * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
- * This file is licensed to you under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License. You may obtain a copy
- * of the License at https://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software distributed under
- * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
- * OF ANY KIND, either express or implied. See the License for the specific language
- * governing permissions and limitations under the License.
- */
-
-
-import { useEffect } from "react";
-
-//#region ../hotkey-manager/dist/react/use-hotkey.js
-/**
-* A React hook that binds a HotkeyManager on mount and unbinds on unmount.
-*
-* @param manager - The hotkey manager to bind.
-* @returns void
-*
-* @example
-* ```tsx
-* const myHotkey = registerHotkey({ key: { code: Keycode.KeyA }, onKeyUp: handler });
-*
-* function MyComponent() {
-*   useHotkey(myHotkey);
-*   return <div />;
-* }
-* ```
-*/
-function useHotkey(manager) {
-	useEffect(() => manager.bind(), [manager]);
-}
-
-//#endregion
-export { useHotkey };
-//# sourceMappingURL=use-hotkey.js.map

package/dist/hotkey-manager/dist/react/use-hotkey.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-hotkey.js","names":[],"sources":["../../../../../hotkey-manager/dist/react/use-hotkey.js"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n\nimport { useEffect } from \"react\";\n\n//#region src/react/use-hotkey.ts\n/**\n* A React hook that binds a HotkeyManager on mount and unbinds on unmount.\n*\n* @param manager - The hotkey manager to bind.\n* @returns void\n*\n* @example\n* ```tsx\n* const myHotkey = registerHotkey({ key: { code: Keycode.KeyA }, onKeyUp: handler });\n*\n* function MyComponent() {\n*   useHotkey(myHotkey);\n*   return <div />;\n* }\n* ```\n*/\nfunction useHotkey(manager) {\n\tuseEffect(() => manager.bind(), [manager]);\n}\n/**\n* Creates a React hook from a HotkeyManager for module-level usage.\n* This is useful when you want to define the hotkey at module scope and use it as a hook.\n*\n* @param manager - The hotkey manager to wrap.\n* @returns A React hook that binds the hotkey on mount.\n*\n* @example\n* ```tsx\n* const myHotkey = registerHotkey({ key: { code: Keycode.KeyA }, onKeyUp: handler });\n* const useMyHotkey = createUseHotkey(myHotkey);\n*\n* function MyComponent() {\n*   useMyHotkey();\n*   return <div />;\n* }\n* ```\n*/\nfunction createUseHotkey(manager) {\n\treturn function useHotkeyHook() {\n\t\tuseEffect(() => manager.bind(), []);\n\t};\n}\n\n//#endregion\nexport { createUseHotkey, useHotkey };\n//# sourceMappingURL=use-hotkey.js.map"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,SAAS,UAAU,SAAS;AAC3B,iBAAgB,QAAQ,MAAM,EAAE,CAAC,QAAQ,CAAC"}