@orbat-mapper/tactical-draw 0.9.2 → 0.10.1

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { A as PinOverridePatch, B as resolvePinPresentation, C as makeFillPatternImage, D as PointerEventInfo, E as PointerCallback, F as PinPresentationStatus, I as PinPresentationStatusEvent, L as PinPresentationStore, M as PinPresentationCapability, N as PinPresentationPatch, O as DEFAULT_PIN_PRESENTATION, P as PinPresentationState, R as PinRender, S as isMinePattern, T as EditPointerDriver, _ as HatchPattern, a as LayerId, b as fillPatternImageDimension, c as MapEvent, d as PickHandler, f as PickOptions, g as HATCH_PATTERNS, h as TextStyleOptions, i as ImageOverlayResource, j as PinPresentation, k as PinFootprint, l as MapEventHandler, m as StyleOptions, n as HandleStyle, o as MapAdapter, p as PixelCoordinate, r as IconResource, s as MapCursor, t as FeatureGroup, u as PickEvent, v as MINE_PATTERN_TILE_SIZE, w as parseColor, x as fillPatternImageId, y as Rgba, z as isValidPinNumber } from "./map-adapter-DY-iZRcb.mjs";
+import { A as PinOverridePatch, B as resolvePinPresentation, C as makeFillPatternImage, D as PointerEventInfo, E as PointerCallback, F as PinPresentationStatus, I as PinPresentationStatusEvent, L as PinPresentationStore, M as PinPresentationCapability, N as PinPresentationPatch, O as DEFAULT_PIN_PRESENTATION, P as PinPresentationState, R as PinRender, S as isMinePattern, T as EditPointerDriver, _ as HatchPattern, a as LayerId, b as fillPatternImageDimension, c as MapEvent, d as PickHandler, f as PickOptions, g as HATCH_PATTERNS, h as TextStyleOptions, i as ImageOverlayResource, j as PinPresentation, k as PinFootprint, l as MapEventHandler, m as StyleOptions, n as HandleStyle, o as MapAdapter, p as PixelCoordinate, r as IconResource, s as MapCursor, t as FeatureGroup, u as PickEvent, v as MINE_PATTERN_TILE_SIZE, w as parseColor, x as fillPatternImageId, y as Rgba, z as isValidPinNumber } from "./map-adapter-2Cmj-tem.mjs";
 import { AmplifierPlacement, AmplifierPlacements, ControlMeasure, ControlMeasureKind, ControlMeasureRender, ControlMeasureStyle, SymbolColors, TextAmplifiers } from "@orbat-mapper/control-measures";
 import { Feature, Position } from "geojson";
 
@@ -1662,6 +1662,12 @@ declare class TacticalDraw {
   private transformCounter;
   /** Snapshot of the host's latest authoritative Graphic membership and order. */
   private lastRenderedMeasures;
+  /**
+   * Id index over {@link lastRenderedMeasures}, rebuilt alongside it so
+   * per-id lookups (e.g. {@link renderHighlights}) are O(1) instead of an
+   * O(document) linear scan on every highlighted id, every frame.
+   */
+  private lastRenderedMeasuresById;
   /** Whether any last-rendered graphic reads the whole camera, not just scale. */
   private lastRenderedHasViewDependent;
   private snapGeometryFeatures;
@@ -1703,6 +1709,15 @@ declare class TacticalDraw {
    * that removes outlines when the set transitions to empty.
    */
   private hasHighlightOutlines;
+  /**
+   * Coalesces bursts of {@link setHighlightedGraphics} (e.g. hover across a
+   * list of rows) into at most one {@link renderHighlights} per animation
+   * frame. Every other caller — `render()`, view-change, session start /
+   * settle — needs highlight state updated synchronously and in step with
+   * its own write, so those call {@link flushHighlights} instead, which
+   * cancels any pending coalesced frame before rendering immediately.
+   */
+  private readonly highlightCoalescer;
   constructor(adapter: MapAdapter, options?: TacticalDrawOptions);
   setPinPresentation(defaults: PinPresentationPatch): void;
   setPinOverride(id: string, patch: PinOverridePatch): void;
@@ -1830,6 +1845,14 @@ declare class TacticalDraw {
    * "locked selection" chrome.
    */
   setHighlightedGraphics(ids: readonly string[]): void;
+  /**
+   * Cancel any pending coalesced highlight frame and re-project highlights
+   * immediately. Used by every caller other than `setHighlightedGraphics`
+   * (`render()`, view-change, session start / settle) so their own
+   * synchronous effects and the highlight layer update together, with no
+   * frame of lag and no stale coalesced call left to fire afterwards.
+   */
+  private flushHighlights;
   /**
    * Project the current {@link highlightedIds} into one outline `LineString`
    * per graphic and reconcile them onto the highlight layer. Idempotent and

package/dist/index.mjs

@@ -1091,7 +1091,8 @@ function validateOverride(patch) {
 	for (const key of [
 		"mode",
 		"occlusion",
-		"prioritizePins"
+		"prioritizePins",
+		"depthSort"
 	]) if (Object.hasOwn(patch, key)) throw new TypeError(`Pin setting ${key} is view-wide only`);
 }
 const DEFAULT_PIN_PRESENTATION = Object.freeze({
@@ -1102,6 +1103,7 @@ const DEFAULT_PIN_PRESENTATION = Object.freeze({
 	sizePixels: 32,
 	occlusion: "none",
 	prioritizePins: true,
+	depthSort: true,
 	stem: Object.freeze({
 		color: "#172033",
 		width: 2,
@@ -7642,6 +7644,12 @@ var TacticalDraw = class {
 	transformCounter = 0;
 	/** Snapshot of the host's latest authoritative Graphic membership and order. */
 	lastRenderedMeasures = [];
+	/**
+	* Id index over {@link lastRenderedMeasures}, rebuilt alongside it so
+	* per-id lookups (e.g. {@link renderHighlights}) are O(1) instead of an
+	* O(document) linear scan on every highlighted id, every frame.
+	*/
+	lastRenderedMeasuresById = /* @__PURE__ */ new Map();
 	/** Whether any last-rendered graphic reads the whole camera, not just scale. */
 	lastRenderedHasViewDependent = false;
 	snapGeometryFeatures = [];
@@ -7683,6 +7691,15 @@ var TacticalDraw = class {
 	* that removes outlines when the set transitions to empty.
 	*/
 	hasHighlightOutlines = false;
+	/**
+	* Coalesces bursts of {@link setHighlightedGraphics} (e.g. hover across a
+	* list of rows) into at most one {@link renderHighlights} per animation
+	* frame. Every other caller — `render()`, view-change, session start /
+	* settle — needs highlight state updated synchronously and in step with
+	* its own write, so those call {@link flushHighlights} instead, which
+	* cancels any pending coalesced frame before rendering immediately.
+	*/
+	highlightCoalescer = createFrameCoalescer(() => this.renderHighlights());
 	constructor(adapter, options) {
 		this.adapter = adapter;
 		this.offsetDragModifier = options?.offsetDragModifier ?? false;
@@ -7715,7 +7732,7 @@ var TacticalDraw = class {
 			this.invalidateGraphicGroupCache(false);
 			this.refreshActiveEditPresentation();
 			this.reconcileGraphicsStack();
-			this.renderHighlights();
+			this.flushHighlights();
 		});
 	}
 	setPinPresentation(defaults) {
@@ -7949,7 +7966,7 @@ var TacticalDraw = class {
 		const resolutionChanged = !Object.is(resolution, this.lastViewResolution);
 		this.lastViewResolution = resolution;
 		if (!this.hasRendered) return;
-		this.renderHighlights();
+		this.flushHighlights();
 		const nativePointSymbolScaling = this.adapter.scalesGroundPointSymbolsNatively === true;
 		if (!resolutionChanged && !this.lastRenderedHasViewDependent) return;
 		const excluded = this.graphicsStackExcludedIds();
@@ -8038,6 +8055,7 @@ var TacticalDraw = class {
 			}
 		}
 		this.lastRenderedMeasures = measures.slice();
+		this.lastRenderedMeasuresById = new Map(this.lastRenderedMeasures.map((g) => [g.id, g]));
 		this.lastRenderedHasViewDependent = this.lastRenderedMeasures.some((g) => !this.renderGraphicGroup(g).pin && graphicViewDependence(g, this.adapter.scalesGroundPointSymbolsNatively === true) === "view");
 		this.graphicStack.acknowledgeHostRender(measures);
 		if (activeEdit && "syncHostMembership" in activeEdit && measures.some((graphic) => graphic.id === activeEdit.measureId && graphic.kind === activeEdit.graphicKind)) activeEdit.syncHostMembership(true);
@@ -8056,7 +8074,7 @@ var TacticalDraw = class {
 			});
 			else if (this.activeInteraction.isStarting) this.activeInteraction.cancel("removed");
 		}
-		this.renderHighlights();
+		this.flushHighlights();
 	}
 	/**
 	* Replace the passive selection-highlight set with `ids`. Declarative and
@@ -8071,6 +8089,17 @@ var TacticalDraw = class {
 	setHighlightedGraphics(ids) {
 		this.assertAlive();
 		this.highlightedIds = ids.slice();
+		this.highlightCoalescer.schedule();
+	}
+	/**
+	* Cancel any pending coalesced highlight frame and re-project highlights
+	* immediately. Used by every caller other than `setHighlightedGraphics`
+	* (`render()`, view-change, session start / settle) so their own
+	* synchronous effects and the highlight layer update together, with no
+	* frame of lag and no stale coalesced call left to fire afterwards.
+	*/
+	flushHighlights() {
+		this.highlightCoalescer.cancel();
 		this.renderHighlights();
 	}
 	/**
@@ -8096,7 +8125,7 @@ var TacticalDraw = class {
 		const pinGroups = [];
 		for (const id of this.highlightedIds) {
 			if (excluded.has(id)) continue;
-			const graphic = this.lastRenderedMeasures.find((g) => g.id === id);
+			const graphic = this.lastRenderedMeasuresById.get(id);
 			if (!graphic) continue;
 			if (isPointSymbol(graphic)) {
 				const pin = this.renderGraphicGroup(graphic).pin;
@@ -8149,16 +8178,13 @@ var TacticalDraw = class {
 			if (!this.images) return null;
 			return imageFootprint(graphic, renderImageForAdapter(this.adapter, this.images, graphic).render, this.adapter)?.box ?? null;
 		}
-		const render = renderMeasureForAdapter(this.adapter, graphic, {
-			graphicsStyle: this.graphicsStyle,
-			symbolColors: this.symbolColors
-		});
-		if (graphic.kind === "text") return fitTextFootprintFromFeatures(render.features, (lonLat) => this.adapter.getPixelFromCoordinate(lonLat), {
+		const features = this.renderGraphicGroup(graphic).features;
+		if (graphic.kind === "text") return fitTextFootprintFromFeatures(features, (lonLat) => this.adapter.getPixelFromCoordinate(lonLat), {
 			resolution: this.adapter.getResolution(),
 			bearing
 		});
 		const positions = [];
-		for (const feature of render.features) if (feature.geometry) collectFeaturePositions(feature.geometry, positions);
+		for (const feature of features) if (feature.geometry) collectFeaturePositions(feature.geometry, positions);
 		const pixels = [];
 		for (const position of positions) {
 			const pixel = this.adapter.getPixelFromCoordinate(position);
@@ -8219,7 +8245,7 @@ var TacticalDraw = class {
 			clearSlot();
 			this.clearSnapResult();
 			if (extraSettle) extraSettle();
-			this.renderHighlights();
+			this.flushHighlights();
 		};
 		this.activeInteraction.begin();
 		try {
@@ -8233,7 +8259,7 @@ var TacticalDraw = class {
 			this.activeInteraction.set(handle);
 			if (activate && !handle.settled) {
 				deactivate = activate(handle) ?? null;
-				this.renderHighlights();
+				this.flushHighlights();
 			}
 		}
 		handle.promise.then(clearSlot, clearSlot);
@@ -8780,6 +8806,7 @@ var TacticalDraw = class {
 		this.unsubscribePins();
 		if (this.destroyed) return;
 		this.destroyed = true;
+		this.highlightCoalescer.cancel();
 		if (this.activeInteraction.isActive) {
 			this.activeEdit = null;
 			this.activeTransform = null;

package/dist/{map-adapter-DY-iZRcb.d.mts → map-adapter-2Cmj-tem.d.mts}

@@ -11,6 +11,8 @@ interface PinPresentation {
   sizePixels: number;
   occlusion: "none" | "terrain";
   prioritizePins: boolean;
+  /** Paint whole pins far to near by camera depth; ties retain layer order. Default on. */
+  depthSort: boolean;
   stem: {
     color: string;
     width: number;
@@ -49,7 +51,7 @@ type PinPresentationPatch = Partial<Omit<PinPresentation, "stem" | "dot" | "halo
   plate?: Partial<PinPresentation["plate"]>;
 };
 /** Per-unit appearance and dimensions; spatial rules belong to the view. */
-type PinOverridePatch = Omit<PinPresentationPatch, "mode" | "occlusion" | "prioritizePins">;
+type PinOverridePatch = Omit<PinPresentationPatch, "mode" | "occlusion" | "prioritizePins" | "depthSort">;
 interface PinPresentationState {
   defaults: PinPresentationPatch;
   overrides: Record<string, PinOverridePatch>;

package/dist/testing.d.mts

@@ -1,4 +1,4 @@
-import { a as LayerId, o as MapAdapter, p as PixelCoordinate } from "./map-adapter-DY-iZRcb.mjs";
+import { a as LayerId, o as MapAdapter, p as PixelCoordinate } from "./map-adapter-2Cmj-tem.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.9.2",
+  "version": "0.10.1",
   "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",