@orbat-mapper/tactical-draw 0.8.1 → 0.9.0

package/dist/{map-adapter-CyVIAoPf.d.mts → map-adapter-azR_hVjj.d.mts}

@@ -1,6 +1,106 @@
 import { PatternId } from "@orbat-mapper/control-measures";
 import { Feature, Position } from "geojson";
 
+//#region src/pin-presentation.d.ts
+/** View preferences, never part of an authored PointSymbol snapshot. */
+interface PinPresentation {
+  enabled: boolean;
+  mode: "screen" | "world";
+  liftPixels: number;
+  heightMeters: number;
+  sizePixels: number;
+  occlusion: "none" | "terrain";
+  stem: {
+    color: string;
+    width: number;
+    opacity: number;
+  };
+  dot: {
+    color: string;
+    radius: number;
+    opacity: number;
+  };
+  halo: {
+    color: string;
+    width: number;
+    opacity: number;
+  };
+  symbolHalo: {
+    color: string;
+    width: number;
+    opacity: number;
+  };
+  plate: {
+    enabled: boolean;
+    color: string;
+    borderColor: string;
+    borderWidth: number;
+    padding: number;
+    radius: number;
+    opacity: number;
+  };
+}
+type PinPresentationPatch = Partial<Omit<PinPresentation, "stem" | "dot" | "halo" | "symbolHalo" | "plate">> & {
+  stem?: Partial<PinPresentation["stem"]>;
+  dot?: Partial<PinPresentation["dot"]>;
+  halo?: Partial<PinPresentation["halo"]>;
+  symbolHalo?: Partial<PinPresentation["symbolHalo"]>;
+  plate?: Partial<PinPresentation["plate"]>;
+};
+/** Per-unit appearance and dimensions; spatial rules belong to the view. */
+type PinOverridePatch = Omit<PinPresentationPatch, "mode" | "occlusion">;
+interface PinPresentationState {
+  defaults: PinPresentationPatch;
+  overrides: Record<string, PinOverridePatch>;
+}
+type PinPresentationStatus = "supported" | "unsupported" | "loading" | "waiting-for-elevation" | "unavailable";
+interface PinPresentationCapability {
+  status: PinPresentationStatus;
+  reason?: string;
+}
+interface PinPresentationStatusEvent extends PinPresentationCapability {
+  graphicIds: readonly string[];
+}
+/** Render payload for one atomic graphic; shared icon resources retain HQ staff. */
+interface PinRender {
+  id: string;
+  position: Position;
+  resource: IconResource;
+  octagonSize: number;
+  presentation: PinPresentation;
+  opacity: number;
+  /** Absolute clockwise bearing in radians, independent of billboard orientation. */
+  direction?: number;
+  /** Selection chrome only, on the host highlight/handles surface. */
+  highlightOnly?: boolean;
+}
+interface PinFootprint {
+  ground: PixelCoordinate;
+  attachment: PixelCoordinate;
+  min: PixelCoordinate;
+  max: PixelCoordinate;
+}
+declare const DEFAULT_PIN_PRESENTATION: Readonly<PinPresentation>;
+/**
+ * Whether `value` is an acceptable number for the pin setting named `key`.
+ * Exported so a host's input handling can reject a value with the same rules
+ * the store enforces, rather than re-encoding the bounds and drifting from it.
+ */
+declare function isValidPinNumber(key: string, value: unknown): value is number;
+declare function resolvePinPresentation(...patches: readonly PinPresentationPatch[]): PinPresentation;
+/** Replacing patches makes omitted override properties inherit again. */
+declare class PinPresentationStore {
+  private state;
+  private readonly emitter;
+  getState(): PinPresentationState;
+  resolve(id: string): PinPresentation;
+  replace(state: PinPresentationState): void;
+  setDefaults(patch: PinPresentationPatch): void;
+  setOverride(id: string, patch: PinOverridePatch): void;
+  resetOverride(id: string): void;
+  onChange(listener: (state: PinPresentationState) => void): () => void;
+}
+//#endregion
 //#region src/gestures/types.d.ts
 interface PointerEventInfo {
   /** Per-event hit-tolerance override (e.g. larger for touch). */
@@ -64,6 +164,12 @@ declare const HATCH_PATTERNS: readonly HatchPattern[];
 declare const MINE_PATTERN_TILE_SIZE: number;
 /** True for the mine-pictogram family — a screen-space glyph texture rather than a repeating hatch. */
 declare function isMinePattern(pattern: HatchPattern): pattern is MinePattern;
+interface Rgba {
+  r: number;
+  g: number;
+  b: number;
+  a: number;
+}
 /**
  * Stable id for a rasterized tile, keyed by pattern and color. Adapters use
  * this as the image-registry key (MapLibre `addImage` id, OpenLayers pattern
@@ -80,6 +186,15 @@ declare function fillPatternImageId(color: string, pattern: HatchPattern): strin
  * power-of-two guarantee.
  */
 declare function fillPatternImageDimension(pixelRatio: number): number;
+/**
+ * Parse a hex (`#rgb`, `#rgba`, `#rrggbb`, `#rrggbbaa`) or `rgb()`/`rgba()`
+ * color string into normalized channels, alpha in `[0, 1]`. Unparseable input
+ * falls back to opaque black rather than throwing, since a mis-themed fill
+ * should still render *something*. Shared by every renderer that needs CSS
+ * colors as numbers — hatch fills here, billboard pins in the MapLibre
+ * adapter — so the accepted syntax stays identical across them.
+ */
+declare function parseColor(color: string): Rgba;
 /** The mine-pictogram members of {@link HatchPattern}, derived so the family stays in one place. */
 type MinePattern = Extract<HatchPattern, `mine-${string}`>;
 /** Coverage from the canonical command interpreter, exposed only for focused conformance tests. */
@@ -205,6 +320,8 @@ interface ImageOverlayResource {
  * stack position.
  */
 interface FeatureGroup {
+  /** Optional view-only point-symbol presentation; ordinary features are the fallback. */
+  pin?: PinRender;
   id: string;
   features: readonly Feature[];
   iconResources: readonly IconResource[];
@@ -242,6 +359,12 @@ interface PickOptions {
   signal?: AbortSignal;
 }
 interface MapAdapter {
+  onPinPresentationStatusChange?(handler: (event: PinPresentationStatusEvent) => void): () => void;
+  getPinPresentationCapability?(graphicId?: string): PinPresentationCapability;
+  getPinFootprint?(graphicId: string): PinFootprint | null;
+  pickPin?(graphicId: string, pixel: PixelCoordinate, tolerance: number): boolean;
+  /** Invert a pinned attachment for a location drag, preserving pointer grab. */
+  movePinFromPixel?(graphicId: string, attachment: PixelCoordinate): Position | null;
   /**
    * Add a vector layer to the map.
    * @returns unique layer ID
@@ -389,4 +512,4 @@ interface MapAdapter {
   getLayerFeatures(layerId: LayerId): readonly Feature[];
 }
 //#endregion
-export { EditPointerDriver as C, makeFillPatternImage as S, PointerEventInfo as T, HatchPattern as _, LayerId as a, fillPatternImageId as b, MapEvent as c, PickHandler as d, PickOptions as f, HATCH_PATTERNS as g, TextStyleOptions as h, ImageOverlayResource as i, MapEventHandler as l, StyleOptions as m, HandleStyle as n, MapAdapter as o, PixelCoordinate as p, IconResource as r, MapCursor as s, FeatureGroup as t, PickEvent as u, MINE_PATTERN_TILE_SIZE as v, PointerCallback as w, isMinePattern as x, fillPatternImageDimension as y };
+export { PinOverridePatch as A, resolvePinPresentation as B, makeFillPatternImage as C, PointerEventInfo as D, PointerCallback as E, PinPresentationStatus as F, PinPresentationStatusEvent as I, PinPresentationStore as L, PinPresentationCapability as M, PinPresentationPatch as N, DEFAULT_PIN_PRESENTATION as O, PinPresentationState as P, PinRender as R, isMinePattern as S, EditPointerDriver as T, HatchPattern as _, LayerId as a, fillPatternImageDimension as b, MapEvent as c, PickHandler as d, PickOptions as f, HATCH_PATTERNS as g, TextStyleOptions as h, ImageOverlayResource as i, PinPresentation as j, PinFootprint as k, MapEventHandler as l, StyleOptions as m, HandleStyle as n, MapAdapter as o, PixelCoordinate as p, IconResource as r, MapCursor as s, FeatureGroup as t, PickEvent as u, MINE_PATTERN_TILE_SIZE as v, parseColor as w, fillPatternImageId as x, Rgba as y, isValidPinNumber as z };

package/dist/testing.d.mts

@@ -1,4 +1,4 @@
-import { a as LayerId, o as MapAdapter, p as PixelCoordinate } from "./map-adapter-CyVIAoPf.mjs";
+import { a as LayerId, o as MapAdapter, p as PixelCoordinate } from "./map-adapter-azR_hVjj.mjs";
 import { Feature } from "geojson";
 
 //#region src/testing/feature-group-conformance.d.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orbat-mapper/tactical-draw",
-  "version": "0.8.1",
+  "version": "0.9.0",
   "description": "Engine-agnostic draw/edit core for tactical control measures (MIL-STD-2525 / APP-6). The MapAdapter ABI and bring-your-own-engine entry point for the tactical-draw package family.",
   "license": "MIT",
   "author": "Orbat Mapper",
@@ -39,7 +39,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@orbat-mapper/control-measures": "^0.25.0"
+    "@orbat-mapper/control-measures": "^0.27.0"
   },
   "peerDependencies": {
     "vitest": ">=4.0.0"