@accelint/map-toolkit 2.0.0 → 3.0.0

package/CHANGELOG.md

@@ -1,5 +1,55 @@
 # @accelint/map-toolkit
 
+## 3.0.0
+
+### Major Changes
+
+- fa05228: Fix viewport size display to use SI/ICAO-compliant unit symbols instead of uppercased abbreviations. For example, `km` instead of `KM`, `m` instead of `M`. Nautical miles changed from `nm` to `NM` per ICAO/IMO convention.
+
+  ### Breaking changes
+
+  **New peer dependency:** `@accelint/constants` is now required.
+
+  **Removed exports** (from `@accelint/map-toolkit/viewport`):
+  - `DISTANCE_UNIT_ABBREVIATIONS` → use `DISTANCE_UNIT_SYMBOLS` from `@accelint/constants/units`
+  - `DistanceUnitAbbreviation` type → use `DistanceUnitSymbol` from `@accelint/constants/units`
+  - `DistanceUnit` type → use `DistanceUnit` from `@accelint/constants/units`
+  - `SupportedDistanceUnit` type → use `DistanceUnitSymbol` from `@accelint/constants/units`
+  - `getDistanceUnitFromAbbreviation()` → use `DISTANCE_UNIT_BY_SYMBOL[symbol]` from `@accelint/constants/units`
+  - `getDistanceUnitAbbreviation()` → use `DISTANCE_UNIT_SYMBOLS[unit]` from `@accelint/constants/units`
+
+  **Symbol value changes:** Unit symbols are now SI-compliant though nautical miles uses the ICAO/IMO convention of NM. If you were matching on string values, update accordingly:
+  - `'nm'` → `'NM'` (nautical miles)
+
+### Minor Changes
+
+- b3de1bb: Add radius label on hover for circle shapes in `DisplayShapeLayer`. When hovering a circle, the radius is displayed in the configured `unit` (defaults to nautical miles). The label positions relative to the shape's text label: below it when `showLabels` is `'always'` or `'hover'`, and in its place when `showLabels` is `'never'`. Also adds the `unit` prop to `DisplayShapeLayerProps` for configuring distance display units.
+- 0c3f356: Add `duplicateShape()` utility for cloning shapes with a new ID. Supports optional coordinate offset and custom naming. The resolved name is also set as the clone's map label. Includes new `GeoPosition` type for 2D or 3D coordinate tuples and a `DuplicateShape` Storybook story.
+- 1b39e64: Add CoffinCornerExtension for icon selection/hover bracket indicators
+
+  New deck.gl LayerExtension that renders bracket corner indicators around
+  selected and hovered icons via GPU shaders. Includes useCoffinCorner hook
+  for managing selection state, event bus integration, and configurable
+  highlight colors. SymbolLayer fiber type now includes CoffinCornerExtension
+  props by default.
+
+### Patch Changes
+
+- 75fa668: - When using icons for Point shapes, `EditShapeLayer` now displays icon markers during editing instead of plain circles.
+  - `DrawShapeLayer` and `EditShapeLayer` now self-register their fiber dependencies and no longer require manual fiber imports.
+  - `useEditShape()` now exposes `updateFeature` to allow form-based updates before saving edits
+- 17c4b6c: Extend CoffinCornerExtension to support ScatterplotLayer (circle points without icons) alongside IconLayer, and refine DisplayShapeLayer integration.
+  - CoffinCornerExtension now supports ScatterplotLayer with quad expansion and circle-replicating fragment shaders
+  - DisplayShapeLayer skips the highlight outline layer for all Point geometries (coffin corner brackets handle hover/select feedback)
+  - DisplayShapeLayer forwards `highlightColor` as the bracket fill color via a cached tuple to avoid per-render allocations
+  - Stable `DISPLAY_EXTENSIONS` module-level constant prevents unnecessary `getShaders()` re-evaluation
+  - Removed icon-atlas-based coffin corner SVG sprites (replaced by shader SDF rendering)
+
+- Updated dependencies [9a25205]
+- Updated dependencies [fa05228]
+  - @accelint/logger@1.1.0
+  - @accelint/constants@0.3.0
+
 ## 2.0.0
 
 ### Major Changes

package/README.md

@@ -9,6 +9,8 @@ Map Toolkit is a comprehensive library that provides:
 - **Deck.gl Components**: Pre-configured layers and components for rendering geospatial data, including symbol layers for military symbology (MIL-STD-2525)
 - **MapLibre Integration**: Components and utilities for working with MapLibre GL JS
 - **React Support**: React-friendly components with hooks and utilities via `@deckgl-fiber-renderer`
+- **Shapes System**: Draw, display, and edit geometric shapes (circles, ellipses, polygons, rectangles, lines, points) on the map with built-in styling, selection, and duplication
+- **Layer Extensions**: GPU-based visual effects like coffin corner selection/hover indicators, drawn via SDF shaders with no sprite sheet dependencies
 - **Geospatial Utilities**: Helper functions and decorators for common mapping tasks
 
 The package is organized by technology (e.g., `deckgl/`, `maplibre/`) with feature-specific exports, allowing you to import only what you need.
@@ -16,7 +18,7 @@ The package is organized by technology (e.g., `deckgl/`, `maplibre/`) with featu
 ## Installation
 
 ```sh
-npm install @accelint/map-toolkit
+pnpm add @accelint/map-toolkit
 ```
 
 ### Optional Dependencies
@@ -48,6 +50,9 @@ import { SymbolLayer } from '@accelint/map-toolkit/deckgl';
 // MapLibre components
 import { /* components */ } from '@accelint/map-toolkit/maplibre';
 
+// Layer extensions
+import { CoffinCornerExtension, useCoffinCorner } from '@accelint/map-toolkit/deckgl';
+
 // React/Fiber components
 import { /* components */ } from '@accelint/map-toolkit/deckgl/fiber';
 
@@ -100,6 +105,8 @@ pnpm --filter=@accelint/map-toolkit bench
 packages/map-toolkit/
   src/
     deckgl/           # Deck.gl layers and components
+      extensions/     # Layer extensions (coffin corners, etc.)
+      shapes/         # Shape drawing, display, editing, and utilities
     maplibre/         # MapLibre utilities and components
     decorators/       # Shared decorators and utilities
 ```

package/catalog-info.yaml

@@ -11,15 +11,16 @@ metadata:
 
     Dependencies:
 
-    accelint_biome-config@1.1.0, accelint_bus@4.0.0, accelint_core@0.6.0,
-    accelint_design-foundation@3.0.1, accelint_design-toolkit@9.8.0,
-    accelint_geo@0.6.0, accelint_logger@1.0.1,
-    accelint_postcss-tailwind-css-modules@1.0.1, accelint_smeegl@0.3.5,
-    accelint_typescript-config@0.1.4, accelint_vitest-config@0.1.6
+    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.2,
+    accelint_design-toolkit@9.9.0, accelint_geo@0.6.0, 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
   annotations:
     backstage.io/edit-url: https://github.com/gohypergiant/standard-toolkit/blob/main/packages/map-toolkit/catalog-info.yaml
     backstage.io/techdocs-ref: dir:.
-    package/version: 2.0.0
+    package/version: 3.0.0
     github.com/project-slug: gohypergiant/standard-toolkit
   links:
     - url: https://github.com/gohypergiant/standard-toolkit/tree/main/packages/map-toolkit
@@ -38,12 +39,14 @@ spec:
   dependsOn:
     - component:accelint_biome-config
     - component:accelint_bus
+    - component:accelint_constants
     - component:accelint_core
     - component:accelint_design-foundation
     - component:accelint_design-toolkit
     - component:accelint_geo
     - component:accelint_logger
     - component:accelint_postcss-tailwind-css-modules
+    - component:accelint_predicates
     - component:accelint_smeegl
     - component:accelint_typescript-config
     - component:accelint_vitest-config

package/dist/deckgl/base-map/index.d.ts

@@ -11,7 +11,7 @@
  */
 
 import { BaseMapProps } from "./types.js";
-import * as react_jsx_runtime0 from "react/jsx-runtime";
+import * as react_jsx_runtime1 from "react/jsx-runtime";
 
 //#region src/deckgl/base-map/index.d.ts
 
@@ -106,7 +106,7 @@ declare function BaseMap({
   onViewStateChange,
   pickingRadius,
   ...rest
-}: BaseMapProps): react_jsx_runtime0.JSX.Element;
+}: BaseMapProps): react_jsx_runtime1.JSX.Element;
 //#endregion
 export { BaseMap };
 //# sourceMappingURL=index.d.ts.map

package/dist/deckgl/base-map/provider.d.ts

@@ -12,7 +12,7 @@
 
 import { ReactNode } 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";
 
 //#region src/deckgl/base-map/provider.d.ts
 /**
@@ -139,7 +139,7 @@ type MapProviderProps = {
 declare function MapProvider({
   children,
   id
-}: MapProviderProps): react_jsx_runtime1.JSX.Element;
+}: MapProviderProps): react_jsx_runtime0.JSX.Element;
 //#endregion
 export { MapContext, MapProvider, MapProviderProps };
 //# sourceMappingURL=provider.d.ts.map

package/dist/deckgl/extensions/coffin-corner/coffin-corner-extension.d.ts

@@ -0,0 +1,144 @@
+/*
+ * 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.
+ */
+
+import { CoffinCornerExtensionProps, EntityId } from "./types.js";
+import { Layer, LayerExtension, UpdateParameters } from "@deck.gl/core";
+import { Rgba255Tuple } from "@accelint/predicates";
+
+//#region src/deckgl/extensions/coffin-corner/coffin-corner-extension.d.ts
+/** Layer shape with coffin-corner selection and hover state maps. */
+type CoffinCornerLayer = Layer & {
+  state: {
+    selectedEntities: Map<EntityId, number>;
+    hoveredEntities: Map<EntityId, number>;
+  };
+};
+/**
+ * deck.gl layer extension that renders bracket-like "coffin corner" indicators
+ * around hovered and selected map entities.
+ *
+ * Driven by explicit `hoveredEntityId` and `selectedEntityId` props rather than
+ * deck.gl's built-in autoHighlight. Data objects are identified via the
+ * `getEntityId` accessor (defaults to `item => item.id`).
+ *
+ * **Supported layer types:**
+ * - **IconLayer** (and subclasses like SymbolLayer) — samples `iconsTexture`
+ *   to re-composite the icon beneath the brackets.
+ * - **ScatterplotLayer** — replicates the circle fill/stroke logic to composite
+ *   the circle beneath the brackets.
+ *
+ * Using this extension on unsupported layer types will produce shader compilation
+ * errors due to missing layer-specific uniforms/varyings.
+ *
+ * The host layer must set `pickable` to enable picking events.
+ *
+ * @see CoffinCornerExtensionProps for the full list of extension props.
+ *
+ * @example Fiber renderer JSX (IconLayer / SymbolLayer)
+ * ```tsx
+ * <symbolLayer
+ *   {...props}
+ *   pickable
+ *   extensions={[new CoffinCornerExtension()]}
+ *   selectedEntityId={selectedId}
+ *   hoveredEntityId={hoveredId}
+ * />
+ * ```
+ *
+ * @example ScatterplotLayer
+ * ```typescript
+ * new ScatterplotLayer({
+ *   extensions: [new CoffinCornerExtension()],
+ *   getEntityId: (d) => d.id,
+ *   selectedEntityId: selectedId,
+ *   hoveredEntityId: hoveredId,
+ * })
+ * ```
+ *
+ * @example Custom entity ID accessor (e.g. GeoJSON features)
+ * ```typescript
+ * new IconLayer({
+ *   extensions: [new CoffinCornerExtension()],
+ *   getEntityId: (d) => d.properties?.shapeId,
+ *   selectedEntityId: selectedShapeId,
+ *   hoveredEntityId: hoveredShapeId,
+ *   selectedCoffinCornerColor: [255, 0, 0, 255],
+ * })
+ * ```
+ */
+declare class CoffinCornerExtension extends LayerExtension {
+  static componentName: string;
+  static defaultProps: {
+    selectedEntityId: {
+      type: string;
+      value: undefined;
+    };
+    hoveredEntityId: {
+      type: string;
+      value: undefined;
+    };
+    selectedCoffinCornerColor: {
+      type: string;
+      value: Rgba255Tuple;
+    };
+    getEntityId: {
+      type: string;
+      value: (item: {
+        id: EntityId;
+      }) => EntityId;
+    };
+  };
+  /** Returns true if the host layer is a supported type. */
+  private static isSupportedLayer;
+  /**
+   * Initializes selection and hover entity state maps and registers
+   * `instanceSelectedEntity` / `instanceHoveredEntity` GPU attributes.
+   * No-op on unsupported layer types (e.g. PathLayer, SolidPolygonLayer).
+   */
+  initializeState(this: CoffinCornerLayer): void;
+  /**
+   * Syncs `selectedEntityId` and `hoveredEntityId` prop changes into the
+   * entity state maps and invalidates the corresponding GPU attributes.
+   * No-op on unsupported layer types.
+   *
+   * @param params - The deck.gl update parameters containing current and previous props.
+   */
+  updateState(this: CoffinCornerLayer, params: UpdateParameters<Layer<CoffinCornerExtensionProps>>): void;
+  /**
+   * Pushes the normalized `selectedCoffinCornerColor` to the shader's `highlightColor` uniform
+   * each frame. No-op on unsupported layer types.
+   */
+  draw(this: CoffinCornerLayer): void;
+  /**
+   * Returns the appropriate shader injection config based on the host layer type.
+   * IconLayer gets texture-sampling shaders; ScatterplotLayer gets circle-replicating shaders.
+   * Returns null for unsupported layer types to skip shader injection.
+   *
+   * @returns The vertex/fragment shader injection config and uniform module, or null.
+   */
+  getShaders(this: CoffinCornerLayer, _extensions: this): {
+    modules: {
+      name: string;
+      fs: string;
+      uniformTypes: Record<string, string>;
+    }[];
+    inject: {
+      'vs:#decl': string;
+      'vs:#main-end': string;
+      'fs:#decl': string;
+      'fs:#main-start': string;
+    };
+  } | null;
+}
+//#endregion
+export { CoffinCornerExtension };
+//# sourceMappingURL=coffin-corner-extension.d.ts.map