@orbat-mapper/tactical-draw 0.2.0-alpha.23 → 0.2.0-alpha.24

package/dist/index.d.mts

@@ -264,6 +264,12 @@ interface MapAdapter {
    */
   onViewChange(handler: () => void): void;
   offViewChange(handler: () => void): void;
+  /**
+   * The engine evaluates the meters→pixels clamp for ground-sized point
+   * symbols inside its own style layer, so meters-sized point symbols don't
+   * need view-change re-renders for size.
+   */
+  readonly scalesGroundPointSymbolsNatively?: boolean;
   /**
    * Construct an {@link EditPointerDriver} for `TacticalDraw`'s edit
    * controller. The controller subscribes to pointer events on the returned
@@ -465,7 +471,9 @@ type PointSymbolSize = {
   unit: "pixels";
 } | {
   value: number;
-  unit: "meters";
+  unit: "meters"; /** Floor for the on-screen projection of the ground-based size; none when omitted. */
+  minPixels?: number; /** Cap on the on-screen projection of the ground-based size — typically the pixel size the symbol had when anchored to ground; unclamped when omitted. */
+  maxPixels?: number;
 };
 interface PointSymbolGraphicModifiers {
   /** Radians clockwise, relative to the point symbol's own orientation. */

package/dist/index.mjs

@@ -4633,7 +4633,10 @@ function runGroupTransform(opts) {
 //#region src/tactical-draw/point-symbol-rendering.ts
 function effectivePointSymbolPixelSize(symbol, resolution) {
 	if (symbol.size.unit === "pixels") return symbol.size.value;
-	return resolution !== void 0 && resolution > 0 ? symbol.size.value / resolution : symbol.size.value;
+	if (resolution === void 0 || resolution <= 0) return symbol.size.value;
+	const px = symbol.size.value / resolution;
+	const { minPixels, maxPixels } = symbol.size;
+	return Math.max(Number.isFinite(minPixels) && minPixels > 0 ? minPixels : 0, Math.min(Number.isFinite(maxPixels) && maxPixels > 0 ? maxPixels : Infinity, px));
 }
 function pointSymbolPixelScale(symbol, render, resolution) {
 	if (!Number.isFinite(render.octagonSize) || render.octagonSize <= 0) throw new TypeError("PointSymbolRender.octagonSize must be a positive finite number");
@@ -4675,6 +4678,12 @@ function renderPointSymbolForAdapter(adapter, capability, symbol) {
 	};
 }
 function pointSymbolFeature(symbol, render, resolution) {
+	const groundSizeProperties = symbol.size.unit === "meters" ? {
+		iconSizeMeters: symbol.size.value,
+		iconOctagonSize: render.octagonSize,
+		...boundProperty("iconMinPixels", symbol.size.minPixels),
+		...boundProperty("iconMaxPixels", symbol.size.maxPixels)
+	} : void 0;
 	return {
 		type: "Feature",
 		id: `${symbol.id}:point-symbol`,
@@ -4689,10 +4698,14 @@ function pointSymbolFeature(symbol, render, resolution) {
 			iconId: render.resourceId,
 			iconScale: pointSymbolPixelScale(symbol, render, resolution),
 			iconRotation: symbol.rotation,
-			iconOpacity: symbol.style?.opacity ?? 1
+			iconOpacity: symbol.style?.opacity ?? 1,
+			...groundSizeProperties
 		}
 	};
 }
+function boundProperty(key, value) {
+	return value !== void 0 && Number.isFinite(value) && value > 0 ? { [key]: value } : {};
+}
 //#endregion
 //#region src/tactical-draw/graphic-transform-controller.ts
 const HIT_TOLERANCE_PX$1 = 12;
@@ -5495,7 +5508,8 @@ var TacticalDraw = class {
 		if (this.destroyed || !this.hasRendered) return;
 		const excluded = this.excludedInteractionIds();
 		const visible = excluded.size > 0 ? this.lastRenderedMeasures.filter((m) => !excluded.has(m.id)) : this.lastRenderedMeasures;
-		if (!visible.some(graphicRendersFromViewState)) return;
+		const nativeGroundIconScaling = this.adapter.scalesGroundPointSymbolsNatively === true;
+		if (!visible.some((g) => graphicRendersFromViewState(g, nativeGroundIconScaling))) return;
 		this.renderMeasuresToGraphics(visible);
 	};
 	/**
@@ -6206,8 +6220,8 @@ var TacticalDraw = class {
 		if (this.destroyed) throw new TacticalDrawDestroyedError();
 	}
 };
-function graphicRendersFromViewState(graphic) {
-	return isPointSymbol(graphic) ? graphic.size.unit === "meters" : measureRendersFromViewState(graphic);
+function graphicRendersFromViewState(graphic, nativeGroundIconScaling) {
+	return isPointSymbol(graphic) ? graphic.size.unit === "meters" && !nativeGroundIconScaling : measureRendersFromViewState(graphic);
 }
 function normalisePointEditModes(modes) {
 	for (const mode of modes ?? ["transform"]) if (mode !== "transform" && mode !== "delete") throw new TypeError(`Point-symbol editing does not support mode "${mode}"`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orbat-mapper/tactical-draw",
-  "version": "0.2.0-alpha.23",
+  "version": "0.2.0-alpha.24",
   "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",