@accelint/map-toolkit 2.0.0 → 3.0.0

package/dist/deckgl/shapes/shared/utils/layer-config.js

@@ -11,12 +11,14 @@
  */
 
 
-import { DEFAULT_DISTANCE_UNITS, getDistanceUnitFromAbbreviation } from "../../../../shared/units.js";
+import { DEFAULT_DISTANCE_UNITS } from "../../../../shared/units.js";
 import { DEFAULT_EDIT_HANDLE_COLOR, EDITABLE_LAYER_SUBLAYER_PROPS } from "../constants.js";
+import { DISTANCE_UNIT_BY_SYMBOL } from "@accelint/constants/units";
 
 //#region src/deckgl/shapes/shared/utils/layer-config.ts
-let cachedAbbrev = null;
+let cachedSymbol;
 let cachedProps;
+let hasCache = false;
 /**
 * Returns default props for EditableGeoJsonLayer configuration.
 *
@@ -25,7 +27,7 @@ let cachedProps;
 * - Mode configuration with distance units
 * - Sublayer props for tooltips and handles
 *
-* @param unitAbbrev - Optional unit abbreviation (e.g., 'km', 'mi'). Defaults to DEFAULT_DISTANCE_UNITS.
+* @param unitSymbol - Optional unit symbol (e.g., 'km', 'mi'). Defaults to DEFAULT_DISTANCE_UNITS.
 * @returns Default props to spread onto EditableGeoJsonLayer.
 *
 * @example
@@ -36,13 +38,14 @@ let cachedProps;
 * />
 * ```
 */
-function getDefaultEditableLayerProps(unitAbbrev) {
-	if (cachedAbbrev !== null && cachedAbbrev === unitAbbrev && cachedProps) return cachedProps;
-	cachedAbbrev = unitAbbrev;
+function getDefaultEditableLayerProps(unitSymbol) {
+	if (hasCache && cachedSymbol === unitSymbol && cachedProps) return cachedProps;
+	hasCache = true;
+	cachedSymbol = unitSymbol;
 	cachedProps = {
 		getEditHandlePointColor: DEFAULT_EDIT_HANDLE_COLOR,
 		getEditHandlePointOutlineColor: DEFAULT_EDIT_HANDLE_COLOR,
-		modeConfig: { distanceUnits: unitAbbrev ? getDistanceUnitFromAbbreviation(unitAbbrev) ?? DEFAULT_DISTANCE_UNITS : DEFAULT_DISTANCE_UNITS },
+		modeConfig: { distanceUnits: unitSymbol ? DISTANCE_UNIT_BY_SYMBOL[unitSymbol] ?? DEFAULT_DISTANCE_UNITS : DEFAULT_DISTANCE_UNITS },
 		_subLayerProps: EDITABLE_LAYER_SUBLAYER_PROPS
 	};
 	return cachedProps;

package/dist/deckgl/shapes/shared/utils/layer-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"layer-config.js","names":["cachedAbbrev: DistanceUnitAbbreviation | undefined | null","cachedProps: EditableLayerDefaultProps | undefined"],"sources":["../../../../../src/deckgl/shapes/shared/utils/layer-config.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  DEFAULT_DISTANCE_UNITS,\n  type DistanceUnit,\n  type DistanceUnitAbbreviation,\n  getDistanceUnitFromAbbreviation,\n} from '@/shared/units';\nimport {\n  DEFAULT_EDIT_HANDLE_COLOR,\n  EDITABLE_LAYER_SUBLAYER_PROPS,\n} from '../constants';\nimport type { Color } from '@deck.gl/core';\n\n/**\n * Props returned by getDefaultEditableLayerProps.\n * These are common configuration props shared between DrawShapeLayer and EditShapeLayer.\n */\nexport type EditableLayerDefaultProps = {\n  /** Edit handle point color. */\n  getEditHandlePointColor: Color;\n  /** Edit handle point outline color. */\n  getEditHandlePointOutlineColor: Color;\n  /** Mode configuration with distance units. */\n  modeConfig: {\n    distanceUnits: DistanceUnit;\n  };\n  /** Sublayer props for tooltips and edit handles. */\n  _subLayerProps: typeof EDITABLE_LAYER_SUBLAYER_PROPS;\n};\n\nlet cachedAbbrev: DistanceUnitAbbreviation | undefined | null = null;\nlet cachedProps: EditableLayerDefaultProps | undefined;\n\n/**\n * Returns default props for EditableGeoJsonLayer configuration.\n *\n * This consolidates the common configuration shared between DrawShapeLayer and EditShapeLayer:\n * - Edit handle colors\n * - Mode configuration with distance units\n * - Sublayer props for tooltips and handles\n *\n * @param unitAbbrev - Optional unit abbreviation (e.g., 'km', 'mi'). Defaults to DEFAULT_DISTANCE_UNITS.\n * @returns Default props to spread onto EditableGeoJsonLayer.\n *\n * @example\n * ```tsx\n * <editableGeoJsonLayer\n *   {...getDefaultEditableLayerProps(unit)}\n *   // other props\n * />\n * ```\n */\nexport function getDefaultEditableLayerProps(\n  unitAbbrev?: DistanceUnitAbbreviation,\n): EditableLayerDefaultProps {\n  if (cachedAbbrev !== null && cachedAbbrev === unitAbbrev && cachedProps) {\n    return cachedProps;\n  }\n\n  cachedAbbrev = unitAbbrev;\n  cachedProps = {\n    getEditHandlePointColor: DEFAULT_EDIT_HANDLE_COLOR,\n    getEditHandlePointOutlineColor: DEFAULT_EDIT_HANDLE_COLOR,\n    modeConfig: {\n      distanceUnits: unitAbbrev\n        ? (getDistanceUnitFromAbbreviation(unitAbbrev) ??\n          DEFAULT_DISTANCE_UNITS)\n        : DEFAULT_DISTANCE_UNITS,\n    },\n    // biome-ignore lint/style/useNamingConvention: deck.gl API convention\n    _subLayerProps: EDITABLE_LAYER_SUBLAYER_PROPS,\n  };\n\n  return cachedProps;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAyCA,IAAIA,eAA4D;AAChE,IAAIC;;;;;;;;;;;;;;;;;;;;AAqBJ,SAAgB,6BACd,YAC2B;AAC3B,KAAI,iBAAiB,QAAQ,iBAAiB,cAAc,YAC1D,QAAO;AAGT,gBAAe;AACf,eAAc;EACZ,yBAAyB;EACzB,gCAAgC;EAChC,YAAY,EACV,eAAe,aACV,gCAAgC,WAAW,IAC5C,yBACA,wBACL;EAED,gBAAgB;EACjB;AAED,QAAO"}
+{"version":3,"file":"layer-config.js","names":["cachedSymbol: DistanceUnitSymbol | undefined","cachedProps: EditableLayerDefaultProps | undefined"],"sources":["../../../../../src/deckgl/shapes/shared/utils/layer-config.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 { DISTANCE_UNIT_BY_SYMBOL } from '@accelint/constants/units';\nimport { DEFAULT_DISTANCE_UNITS } from '@/shared/units';\nimport {\n  DEFAULT_EDIT_HANDLE_COLOR,\n  EDITABLE_LAYER_SUBLAYER_PROPS,\n} from '../constants';\nimport type {\n  DistanceUnit,\n  DistanceUnitSymbol,\n} from '@accelint/constants/units';\nimport type { Color } from '@deck.gl/core';\n\n/**\n * Props returned by getDefaultEditableLayerProps.\n * These are common configuration props shared between DrawShapeLayer and EditShapeLayer.\n */\nexport type EditableLayerDefaultProps = {\n  /** Edit handle point color. */\n  getEditHandlePointColor: Color;\n  /** Edit handle point outline color. */\n  getEditHandlePointOutlineColor: Color;\n  /** Mode configuration with distance units. */\n  modeConfig: {\n    distanceUnits: DistanceUnit;\n  };\n  /** Sublayer props for tooltips and edit handles. */\n  _subLayerProps: typeof EDITABLE_LAYER_SUBLAYER_PROPS;\n};\n\nlet cachedSymbol: DistanceUnitSymbol | undefined;\nlet cachedProps: EditableLayerDefaultProps | undefined;\nlet hasCache = false;\n\n/**\n * Returns default props for EditableGeoJsonLayer configuration.\n *\n * This consolidates the common configuration shared between DrawShapeLayer and EditShapeLayer:\n * - Edit handle colors\n * - Mode configuration with distance units\n * - Sublayer props for tooltips and handles\n *\n * @param unitSymbol - Optional unit symbol (e.g., 'km', 'mi'). Defaults to DEFAULT_DISTANCE_UNITS.\n * @returns Default props to spread onto EditableGeoJsonLayer.\n *\n * @example\n * ```tsx\n * <editableGeoJsonLayer\n *   {...getDefaultEditableLayerProps(unit)}\n *   // other props\n * />\n * ```\n */\nexport function getDefaultEditableLayerProps(\n  unitSymbol?: DistanceUnitSymbol,\n): EditableLayerDefaultProps {\n  if (hasCache && cachedSymbol === unitSymbol && cachedProps) {\n    return cachedProps;\n  }\n\n  hasCache = true;\n  cachedSymbol = unitSymbol;\n  cachedProps = {\n    getEditHandlePointColor: DEFAULT_EDIT_HANDLE_COLOR,\n    getEditHandlePointOutlineColor: DEFAULT_EDIT_HANDLE_COLOR,\n    modeConfig: {\n      distanceUnits: unitSymbol\n        ? (DISTANCE_UNIT_BY_SYMBOL[unitSymbol] ?? DEFAULT_DISTANCE_UNITS)\n        : DEFAULT_DISTANCE_UNITS,\n    },\n    // biome-ignore lint/style/useNamingConvention: deck.gl API convention\n    _subLayerProps: EDITABLE_LAYER_SUBLAYER_PROPS,\n  };\n\n  return cachedProps;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAyCA,IAAIA;AACJ,IAAIC;AACJ,IAAI,WAAW;;;;;;;;;;;;;;;;;;;;AAqBf,SAAgB,6BACd,YAC2B;AAC3B,KAAI,YAAY,iBAAiB,cAAc,YAC7C,QAAO;AAGT,YAAW;AACX,gBAAe;AACf,eAAc;EACZ,yBAAyB;EACzB,gCAAgC;EAChC,YAAY,EACV,eAAe,aACV,wBAAwB,eAAe,yBACxC,wBACL;EAED,gBAAgB;EACjB;AAED,QAAO"}

package/dist/deckgl/symbol-layer/fiber.d.ts

@@ -10,6 +10,8 @@
  * governing permissions and limitations under the License.
  */
 
+import { CoffinCornerExtensionProps } from "../extensions/coffin-corner/types.js";
+import "../extensions/index.js";
 import { SymbolLayerProps } from "./index.js";
 
 //#region src/deckgl/symbol-layer/fiber.d.ts
@@ -35,7 +37,7 @@ declare global {
          * />
          * ```
          */
-        symbolLayer: SymbolLayerProps;
+        symbolLayer: CoffinCornerExtensionProps<SymbolLayerProps>;
       }
     }
   }

package/dist/deckgl/symbol-layer/fiber.js.map

@@ -1 +1 @@
-{"version":3,"file":"fiber.js","names":[],"sources":["../../../src/deckgl/symbol-layer/fiber.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 { extend } from '@deckgl-fiber-renderer/dom';\nimport { SymbolLayer, type SymbolLayerProps } from './index';\n\nextend({ SymbolLayer });\n\ndeclare global {\n  namespace React {\n    // biome-ignore lint/style/useNamingConvention: Built-in React namespace.\n    namespace JSX {\n      interface IntrinsicElements {\n        /**\n         * A Deck.gl Fiber layer for rendering MIL-STD-2525 and APP-6 military symbols.\n         *\n         * Automatically generates symbol icons from SIDC codes with support for\n         * multiple symbology standards and customizable rendering options.\n         *\n         * @example\n         * ```tsx\n         * <symbolLayer\n         *   id=\"military-units\"\n         *   data={units}\n         *   getSidc={d => d.sidc}\n         *   getPosition={d => d.position}\n         *   getSize={32}\n         *   defaultSymbolOptions={{ colorMode: 'Dark' }}\n         * />\n         * ```\n         */\n        symbolLayer: SymbolLayerProps;\n      }\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAeA,OAAO,EAAE,aAAa,CAAC"}
+{"version":3,"file":"fiber.js","names":[],"sources":["../../../src/deckgl/symbol-layer/fiber.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 { extend } from '@deckgl-fiber-renderer/dom';\nimport { SymbolLayer, type SymbolLayerProps } from './index';\nimport type { CoffinCornerExtensionProps } from '../extensions';\n\nextend({ SymbolLayer });\n\ndeclare global {\n  namespace React {\n    // biome-ignore lint/style/useNamingConvention: Built-in React namespace.\n    namespace JSX {\n      interface IntrinsicElements {\n        /**\n         * A Deck.gl Fiber layer for rendering MIL-STD-2525 and APP-6 military symbols.\n         *\n         * Automatically generates symbol icons from SIDC codes with support for\n         * multiple symbology standards and customizable rendering options.\n         *\n         * @example\n         * ```tsx\n         * <symbolLayer\n         *   id=\"military-units\"\n         *   data={units}\n         *   getSidc={d => d.sidc}\n         *   getPosition={d => d.position}\n         *   getSize={32}\n         *   defaultSymbolOptions={{ colorMode: 'Dark' }}\n         * />\n         * ```\n         */\n        symbolLayer: CoffinCornerExtensionProps<SymbolLayerProps>;\n      }\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAgBA,OAAO,EAAE,aAAa,CAAC"}

package/dist/shared/units.d.ts

@@ -1,63 +1,22 @@
-//#region src/shared/units.d.ts
-/**
- * Map of Turf.js unit names to display abbreviations.
- * These are the practical units users would select for map measurements.
- */
-declare const DISTANCE_UNIT_ABBREVIATIONS: {
-  readonly kilometers: "km";
-  readonly meters: "m";
-  readonly nauticalmiles: "nm";
-  readonly miles: "mi";
-  readonly feet: "ft";
-};
-/**
- * Turf.js unit name (e.g., 'kilometers', 'nauticalmiles').
- */
-type DistanceUnit = keyof typeof DISTANCE_UNIT_ABBREVIATIONS;
-/**
- * Display abbreviation (e.g., 'km', 'nm').
+/*
+ * 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
+ *
+ * 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.
  */
-type DistanceUnitAbbreviation = (typeof DISTANCE_UNIT_ABBREVIATIONS)[DistanceUnit];
+
+import { DistanceUnit } from "@accelint/constants/units";
+
+//#region src/shared/units.d.ts
 /**
  * Default distance units for geographic measurements.
  */
 declare const DEFAULT_DISTANCE_UNITS: DistanceUnit;
-/**
- * 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
- * ```
- */
-declare function getDistanceUnitFromAbbreviation(abbrev: string): DistanceUnit | undefined;
-/**
- * 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'
- * ```
- */
-declare function getDistanceUnitAbbreviation(unit: string): string;
 //#endregion
-export { DEFAULT_DISTANCE_UNITS, DISTANCE_UNIT_ABBREVIATIONS, DistanceUnit, DistanceUnitAbbreviation, getDistanceUnitAbbreviation, getDistanceUnitFromAbbreviation };
+export { DEFAULT_DISTANCE_UNITS };
 //# sourceMappingURL=units.d.ts.map

package/dist/shared/units.js

@@ -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

@@ -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

@@ -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/types.d.ts

@@ -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/utils.d.ts

@@ -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

@@ -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

@@ -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_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

package/dist/viewport/viewport-size.js

@@ -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,7 +1,7 @@
 {
   "name": "@accelint/map-toolkit",
   "description": "A collection of components and utilities to simplify visualizing and working with geospatial data.",
-  "version": "2.0.0",
+  "version": "3.0.0",
   "author": "https://hypergiant.com",
   "$schema": "https://json.schemastore.org/package",
   "devDependencies": {
@@ -44,14 +44,15 @@
     "vitest": "^4.0.15",
     "@accelint/biome-config": "1.1.0",
     "@accelint/bus": "4.0.0",
+    "@accelint/constants": "0.3.0",
     "@accelint/core": "0.6.0",
-    "@accelint/design-foundation": "3.0.1",
-    "@accelint/design-toolkit": "9.8.0",
+    "@accelint/design-foundation": "3.0.2",
+    "@accelint/design-toolkit": "9.9.0",
     "@accelint/geo": "0.6.0",
     "@accelint/hotkey-manager": "1.0.2",
-    "@accelint/logger": "1.0.1",
+    "@accelint/logger": "1.1.0",
     "@accelint/postcss-tailwind-css-modules": "1.0.1",
-    "@accelint/predicates": "0.5.1",
+    "@accelint/predicates": "0.5.2",
     "@accelint/smeegl": "0.3.5",
     "@accelint/typescript-config": "0.1.4",
     "@accelint/vitest-config": "0.1.6"
@@ -77,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",
@@ -161,10 +167,11 @@
     "@types/geojson": "^7946.0.14",
     "react": "^19",
     "@accelint/bus": "4.0.0",
+    "@accelint/constants": "0.3.0",
     "@accelint/core": "0.6.0",
     "@accelint/geo": "0.6.0",
     "@accelint/hotkey-manager": "1.0.2",
-    "@accelint/logger": "1.0.1"
+    "@accelint/logger": "1.1.0"
   },
   "private": false,
   "publishConfig": {

package/dist/deckgl/shapes/display-shape-layer/utils/interaction.js

@@ -1,50 +0,0 @@
-/*
- * 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
- *
- * 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.
- */
-
-
-'use client';
-
-//#region src/deckgl/shapes/display-shape-layer/utils/interaction.ts
-/**
-* Compute hover/selection interaction state for a feature by index.
-*
-* @param feature - The feature to check
-* @param selectedShapeId - Currently selected shape ID
-* @param hoverIndex - Currently hovered feature index
-* @param shapeIdToIndex - Map of shapeId to feature index for O(1) lookup
-* @returns `{ isSelected, isHovered }`
-* @example
-* ```typescript
-* const { isSelected, isHovered } = getPointInteractionState(
-*   feature,
-*   selectedShapeId,
-*   hoverIndex,
-*   shapeIdToIndex, // Map<ShapeId, number> from getFeaturesWithId()
-* );
-* if (isSelected || isHovered) {
-*   // render interaction feedback
-* }
-* ```
-*/
-function getPointInteractionState(feature, selectedShapeId, hoverIndex, shapeIdToIndex) {
-	const shapeId = feature.properties?.shapeId;
-	const isSelected = shapeId != null && shapeId === selectedShapeId;
-	const featureIndex = shapeId ? shapeIdToIndex.get(shapeId) : void 0;
-	return {
-		isSelected,
-		isHovered: hoverIndex !== void 0 && featureIndex === hoverIndex
-	};
-}
-
-//#endregion
-export { getPointInteractionState };
-//# sourceMappingURL=interaction.js.map

package/dist/deckgl/shapes/display-shape-layer/utils/interaction.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"interaction.js","names":[],"sources":["../../../../../src/deckgl/shapes/display-shape-layer/utils/interaction.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'use client';\n\nimport type { Shape, ShapeId } from '../../shared/types';\n\n/**\n * Compute hover/selection interaction state for a feature by index.\n *\n * @param feature - The feature to check\n * @param selectedShapeId - Currently selected shape ID\n * @param hoverIndex - Currently hovered feature index\n * @param shapeIdToIndex - Map of shapeId to feature index for O(1) lookup\n * @returns `{ isSelected, isHovered }`\n * @example\n * ```typescript\n * const { isSelected, isHovered } = getPointInteractionState(\n *   feature,\n *   selectedShapeId,\n *   hoverIndex,\n *   shapeIdToIndex, // Map<ShapeId, number> from getFeaturesWithId()\n * );\n * if (isSelected || isHovered) {\n *   // render interaction feedback\n * }\n * ```\n */\nexport function getPointInteractionState(\n  feature: Shape['feature'],\n  selectedShapeId: ShapeId | undefined,\n  hoverIndex: number | undefined,\n  shapeIdToIndex: Map<ShapeId, number>,\n): { isSelected: boolean; isHovered: boolean } {\n  const shapeId = feature.properties?.shapeId;\n  const isSelected = shapeId != null && shapeId === selectedShapeId;\n  const featureIndex = shapeId ? shapeIdToIndex.get(shapeId) : undefined;\n  const isHovered = hoverIndex !== undefined && featureIndex === hoverIndex;\n  return { isSelected, isHovered };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,SAAgB,yBACd,SACA,iBACA,YACA,gBAC6C;CAC7C,MAAM,UAAU,QAAQ,YAAY;CACpC,MAAM,aAAa,WAAW,QAAQ,YAAY;CAClD,MAAM,eAAe,UAAU,eAAe,IAAI,QAAQ,GAAG;AAE7D,QAAO;EAAE;EAAY,WADH,eAAe,UAAa,iBAAiB;EAC/B"}