@orbat-mapper/tactical-draw 0.11.1 → 0.13.0

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-2Cmj-tem.mjs";
+import { A as PinOverridePatch, B as isValidPinNumber, C as makeFillPatternImage, D as PointerEventInfo, E as PointerCallback, F as PinPresentationStatus, H as pinZoomScale, 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, U as resolvePinPresentation, V as pinDistanceScale, _ 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 combinePinScale } from "./map-adapter-B8zVKzWH.mjs";
 import { AmplifierPlacement, AmplifierPlacements, ControlMeasure, ControlMeasureKind, ControlMeasureRender, ControlMeasureStyle, SymbolColors, TextAmplifiers } from "@orbat-mapper/control-measures";
 import { Feature, Position } from "geojson";
 
@@ -2252,4 +2252,4 @@ declare function nearestWorldCopyLng(lng: number, refLng: number): number;
 /** `nearestWorldCopyLng` applied to a lon/lat position. */
 declare function nearestWorldCopyPosition(position: Position, refLng: number): Position;
 //#endregion
-export { type AnchoredGraphic, BaseMapAdapter, type CombinedAbort, DEFAULT_LABEL_SIZE_PIXELS, DEFAULT_PIN_PRESENTATION, DEFAULT_TEXT_SIZE_MAX_PIXELS, DEFAULT_TEXT_SIZE_MIN_PIXELS, type DrawImageDraft, type DrawMeasureDraft, type DrawOptions, type DrawPointSymbolDraft, type DrawSession, type EditChangeEvent, type EditManyOptions, type EditMode, type EditOptions, type EditPointerDriver, type EditSession, type FeatureGroup, type Graphic, type GraphicEditChangeEvent, type GraphicEditSession, type GraphicGeometrySnappingOptions, type GraphicRender, type GraphicSnapshot, type GuideStyle, HATCH_PATTERNS, type HandleStyle, type HatchPattern, type IconResource, type ImageCapability, ImageCapabilityRequiredError, type ImageFootprint, type ImageGraphic, type ImageGraphicStyle, type ImageIntrinsicSize, type ImageOverlayResource, type ImageRender, type ImageResource, type ImageSize, type InteractionHit, type InteractionStyle, type LabelExtent, type LayerId, MINE_PATTERN_TILE_SIZE, type MapAdapter, type MapCursor, type MapEvent, type MapEventHandler, type MergedPickFeature, type NativeEventEntry, type OffsetDragModifier, type PickCandidate, type PickCandidateHit, type PickCandidateHitKind, type PickCandidateInput, type PickEvaluationContext, type PickEvent, type PickHandler, type PickOptions, type PickPointerType, PinFootprint, PinOverridePatch, PinPresentation, PinPresentationCapability, PinPresentationPatch, PinPresentationState, PinPresentationStatus, PinPresentationStatusEvent, PinPresentationStore, PinRender, type PixelCoordinate, type PointSymbol, type PointSymbolAnchor, type PointSymbolCapability, PointSymbolCapabilityRequiredError, type PointSymbolColors, type PointSymbolConnector, type PointSymbolFootprint, type PointSymbolGraphicModifiers, type PointSymbolOffset, type PointSymbolOffsetControls, type PointSymbolOffsetLayout, type PointSymbolOffsetStyle, type PointSymbolPlacement, type PointSymbolProjection, type PointSymbolRender, type PointSymbolSize, type PointSymbolStyle, type PointSymbolView, type PointerCallback, PointerCallbackHub, type PointerEventInfo, type ResolvedPickPresentation, type Rgba, type RotatedScreenBounds, type ScreenBounds, type SessionChangeSource, type SessionHistory, type SessionHistoryState, type SettleReason, type SizeAnchor, type SnapCandidate, type SnapCandidateProvider, type SnapCandidateRequest, type SnapInteraction, type SnapResult, type SnappingOptions, type StyleOptions, TEXT_HALO_COLOR, TOUCH_HIT_TOLERANCE_PX, TacticalDraw, TacticalDrawAbortError, type TacticalDrawAbortReason, TacticalDrawDestroyedError, type TacticalDrawLayerOptions, type TacticalDrawOptions, type TextSizeProps, type TextStyleOptions, type ToPixel, type TransformBox, type TransformChangeEvent, type TransformSession, type TransientChangeEvent, type TransientPhase, alignPointSymbolIndicator, bindAbortable, cloneImageGraphic, clonePointSymbol, coerceHandleStyle, combineWithHostSignal, convertPointSymbolPlacement, effectivePointSymbolPixelSize, evaluatePickCandidates, fillPatternImageDimension, fillPatternImageId, getSizeAnchor, hitTestFeature, hitTestIconFeature, ignoreAbort, imageFootprint, imageOpacity, isAnchoredGraphic, isImageGraphic, isMinePattern, isPointSymbol, isTacticalDrawAbortError, isValidPinNumber, makeFillPatternImage, mergeNativeAndCachedPickFeatures, movePointSymbolLocation, nearestWorldCopyLng, nearestWorldCopyPosition, normalizeImageGraphic, parseColor, pickHitTolerance, pickPointerType, placePointSymbol, pointSymbolFootprint, pointSymbolResource, renderOrderToVisualOrder, resizePointSymbolSize, resolveGroundTextSizePixels, resolvePickPresentation, resolvePinPresentation, resolvePointSymbolOffset, resolveTextHaloWidth, resolveTextSizePixels, scalePointSymbolLayout, tryControlMeasureIdFromFeature, validateImageGraphic };
+export { type AnchoredGraphic, BaseMapAdapter, type CombinedAbort, DEFAULT_LABEL_SIZE_PIXELS, DEFAULT_PIN_PRESENTATION, DEFAULT_TEXT_SIZE_MAX_PIXELS, DEFAULT_TEXT_SIZE_MIN_PIXELS, type DrawImageDraft, type DrawMeasureDraft, type DrawOptions, type DrawPointSymbolDraft, type DrawSession, type EditChangeEvent, type EditManyOptions, type EditMode, type EditOptions, type EditPointerDriver, type EditSession, type FeatureGroup, type Graphic, type GraphicEditChangeEvent, type GraphicEditSession, type GraphicGeometrySnappingOptions, type GraphicRender, type GraphicSnapshot, type GuideStyle, HATCH_PATTERNS, type HandleStyle, type HatchPattern, type IconResource, type ImageCapability, ImageCapabilityRequiredError, type ImageFootprint, type ImageGraphic, type ImageGraphicStyle, type ImageIntrinsicSize, type ImageOverlayResource, type ImageRender, type ImageResource, type ImageSize, type InteractionHit, type InteractionStyle, type LabelExtent, type LayerId, MINE_PATTERN_TILE_SIZE, type MapAdapter, type MapCursor, type MapEvent, type MapEventHandler, type MergedPickFeature, type NativeEventEntry, type OffsetDragModifier, type PickCandidate, type PickCandidateHit, type PickCandidateHitKind, type PickCandidateInput, type PickEvaluationContext, type PickEvent, type PickHandler, type PickOptions, type PickPointerType, PinFootprint, PinOverridePatch, PinPresentation, PinPresentationCapability, PinPresentationPatch, PinPresentationState, PinPresentationStatus, PinPresentationStatusEvent, PinPresentationStore, PinRender, type PixelCoordinate, type PointSymbol, type PointSymbolAnchor, type PointSymbolCapability, PointSymbolCapabilityRequiredError, type PointSymbolColors, type PointSymbolConnector, type PointSymbolFootprint, type PointSymbolGraphicModifiers, type PointSymbolOffset, type PointSymbolOffsetControls, type PointSymbolOffsetLayout, type PointSymbolOffsetStyle, type PointSymbolPlacement, type PointSymbolProjection, type PointSymbolRender, type PointSymbolSize, type PointSymbolStyle, type PointSymbolView, type PointerCallback, PointerCallbackHub, type PointerEventInfo, type ResolvedPickPresentation, type Rgba, type RotatedScreenBounds, type ScreenBounds, type SessionChangeSource, type SessionHistory, type SessionHistoryState, type SettleReason, type SizeAnchor, type SnapCandidate, type SnapCandidateProvider, type SnapCandidateRequest, type SnapInteraction, type SnapResult, type SnappingOptions, type StyleOptions, TEXT_HALO_COLOR, TOUCH_HIT_TOLERANCE_PX, TacticalDraw, TacticalDrawAbortError, type TacticalDrawAbortReason, TacticalDrawDestroyedError, type TacticalDrawLayerOptions, type TacticalDrawOptions, type TextSizeProps, type TextStyleOptions, type ToPixel, type TransformBox, type TransformChangeEvent, type TransformSession, type TransientChangeEvent, type TransientPhase, alignPointSymbolIndicator, bindAbortable, cloneImageGraphic, clonePointSymbol, coerceHandleStyle, combinePinScale, combineWithHostSignal, convertPointSymbolPlacement, effectivePointSymbolPixelSize, evaluatePickCandidates, fillPatternImageDimension, fillPatternImageId, getSizeAnchor, hitTestFeature, hitTestIconFeature, ignoreAbort, imageFootprint, imageOpacity, isAnchoredGraphic, isImageGraphic, isMinePattern, isPointSymbol, isTacticalDrawAbortError, isValidPinNumber, makeFillPatternImage, mergeNativeAndCachedPickFeatures, movePointSymbolLocation, nearestWorldCopyLng, nearestWorldCopyPosition, normalizeImageGraphic, parseColor, pickHitTolerance, pickPointerType, pinDistanceScale, pinZoomScale, placePointSymbol, pointSymbolFootprint, pointSymbolResource, renderOrderToVisualOrder, resizePointSymbolSize, resolveGroundTextSizePixels, resolvePickPresentation, resolvePinPresentation, resolvePointSymbolOffset, resolveTextHaloWidth, resolveTextSizePixels, scalePointSymbolLayout, tryControlMeasureIdFromFeature, validateImageGraphic };

package/dist/index.mjs

@@ -1087,13 +1087,28 @@ function createCommitEmitter(listenerErrorsMessage) {
 }
 //#endregion
 //#region src/pin-presentation.ts
+/** Nested settings, merged key by key rather than replaced by a patch. */
+const sections = [
+	"stem",
+	"dot",
+	"halo",
+	"symbolHalo",
+	"plate",
+	"zoomScale",
+	"distanceScale",
+	"sizeLimits"
+];
+const viewWideKeys = [
+	"mode",
+	"occlusion",
+	"prioritizePins",
+	"depthSort",
+	"zoomScale",
+	"distanceScale",
+	"sizeLimits"
+];
 function validateOverride(patch) {
-	for (const key of [
-		"mode",
-		"occlusion",
-		"prioritizePins",
-		"depthSort"
-	]) if (Object.hasOwn(patch, key)) throw new TypeError(`Pin setting ${key} is view-wide only`);
+	for (const key of viewWideKeys) if (Object.hasOwn(patch, key)) throw new TypeError(`Pin setting ${key} is view-wide only`);
 }
 const DEFAULT_PIN_PRESENTATION = Object.freeze({
 	enabled: false,
@@ -1132,15 +1147,53 @@ const DEFAULT_PIN_PRESENTATION = Object.freeze({
 		padding: 4,
 		radius: 4,
 		opacity: .95
+	}),
+	zoomScale: Object.freeze({
+		enabled: false,
+		fullSizeZoom: 12,
+		falloff: .85
+	}),
+	distanceScale: Object.freeze({
+		enabled: false,
+		strength: .5
+	}),
+	sizeLimits: Object.freeze({
+		minScale: .45,
+		maxScale: 1.4
 	})
 });
-const sections = [
-	"stem",
-	"dot",
-	"halo",
-	"symbolHalo",
-	"plate"
-];
+/**
+* Multiplier for screen-space pin dimensions at `zoom`, never above 1; 1 when zoom
+* scaling is off. Unbounded below: combinePinScale applies `sizeLimits`.
+*/
+function pinZoomScale(presentation, zoom) {
+	const { enabled, fullSizeZoom, falloff } = presentation.zoomScale;
+	if (!enabled || zoom >= fullSizeZoom) return 1;
+	return Math.min(1, falloff ** (fullSizeZoom - zoom));
+}
+/**
+* Perspective multiplier for a pin at camera depth `depth` (clip-space w), relative
+* to the view center at `referenceDepth`; 1 when distance scaling is off. Unbounded:
+* combinePinScale applies `sizeLimits`. Engines that scale on the GPU must mirror
+* this formula in their shader.
+*/
+function pinDistanceScale(presentation, depth, referenceDepth) {
+	const { enabled, strength } = presentation.distanceScale;
+	if (!enabled || !(depth > 0) || !(referenceDepth > 0)) return 1;
+	return (referenceDepth / depth) ** strength;
+}
+/**
+* Combined screen-space pin scale from the two mode factors (as returned by
+* pinZoomScale and pinDistanceScale), bounded by `sizeLimits` while either mode is
+* enabled; if its `minScale` exceeds `maxScale`, `maxScale` wins. Engines that
+* scale on the GPU must mirror this in their shader.
+*/
+function combinePinScale(presentation, zoomScale, distanceScale) {
+	const scale = zoomScale * distanceScale;
+	if (!presentation.zoomScale.enabled && !presentation.distanceScale.enabled) return scale;
+	const { minScale, maxScale } = presentation.sizeLimits;
+	return Math.min(maxScale, Math.max(minScale, scale));
+}
 /**
 * 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
@@ -3111,6 +3164,17 @@ function runEditInteraction(spec) {
 }
 //#endregion
 //#region src/tactical-draw/handles.ts
+/** Size of a `compact` option handle relative to its slot's style. */
+const COMPACT_HANDLE_SCALE = 2 / 3;
+/** Shrink a handle style's radius and stroke for a `compact` handle. */
+function compactHandleStyle(style) {
+	const { pointRadius, strokeWidth } = style;
+	return {
+		...style,
+		...pointRadius !== void 0 && { pointRadius: pointRadius * COMPACT_HANDLE_SCALE },
+		...strokeWidth !== void 0 && { strokeWidth: strokeWidth * COMPACT_HANDLE_SCALE }
+	};
+}
 /**
 * Midpoint of the segment between two positions, in lonLat. The single source
 * for "where a midpoint handle sits": `buildHandleSet` places the handle here
@@ -3196,7 +3260,8 @@ function handleStyleFor(kind, interactionStyle, unset = false) {
 */
 function toFeatures(handles, featureIdPrefix, interactionStyle) {
 	return handles.map((handle) => {
-		const style = handleStyleFor(handle.kind, interactionStyle, handle.unset);
+		const slotStyle = handleStyleFor(handle.kind, interactionStyle, handle.unset);
+		const style = slotStyle && handle.compact ? compactHandleStyle(slotStyle) : slotStyle;
 		return {
 			type: "Feature",
 			id: handleFeatureId(featureIdPrefix, handle.kind, handle.index),
@@ -4555,6 +4620,11 @@ function runEdit(opts) {
 			iconResources: []
 		}]);
 	}
+	/** Live view scale for option handles behind pixel-authored sizes. */
+	function optionHandleContext() {
+		const resolution = adapter.getResolution();
+		return hasUsableResolution(resolution) ? { constructionMetersPerCssPixel: resolution } : {};
+	}
 	function buildCurrentHandleSet() {
 		const handles = buildHandleSet(workingPoints, modes, {
 			includeMidpoints: midpointHandlesEnabled,
@@ -4563,7 +4633,10 @@ function runEdit(opts) {
 			closedRing
 		});
 		if (modes.includes("reshape")) {
-			const optionHandles = getControlMeasureOptionHandles(measure.kind, workingPoints, workingOptions, { detail: detailHandles });
+			const optionHandles = getControlMeasureOptionHandles(measure.kind, workingPoints, workingOptions, {
+				detail: detailHandles,
+				...optionHandleContext()
+			});
 			for (let index = 0; index < optionHandles.length; index++) {
 				const handle = optionHandles[index];
 				handles.push({
@@ -4571,7 +4644,8 @@ function runEdit(opts) {
 					index,
 					optionId: handle.id,
 					position: [...handle.position],
-					...handle.unset ? { unset: true } : {}
+					...handle.unset ? { unset: true } : {},
+					...handle.compact ? { compact: true } : {}
 				});
 			}
 		}
@@ -5092,7 +5166,7 @@ function runEdit(opts) {
 	let activeDrag = null;
 	let activeOptionDrag = null;
 	function optionsForOptionHandle(position, drag) {
-		const patch = dragControlMeasureOptionHandle(measure.kind, workingPoints, drag.preDragOptions, drag.handleId, position);
+		const patch = dragControlMeasureOptionHandle(measure.kind, workingPoints, drag.preDragOptions, drag.handleId, position, optionHandleContext());
 		return patch ? {
 			...drag.preDragOptions ?? {},
 			...patch
@@ -5217,7 +5291,7 @@ function runEdit(opts) {
 				return;
 			}
 			if (hit.kind === "option" && hit.optionId && info?.altKey) {
-				const patch = resetControlMeasureOptionHandle(measure.kind, workingPoints, workingOptions, hit.optionId);
+				const patch = resetControlMeasureOptionHandle(measure.kind, workingPoints, workingOptions, hit.optionId, optionHandleContext());
 				if (patch) {
 					setOptions(patch, "gesture", "Reset option handle");
 					shell.suppressNextClickAway();
@@ -9350,4 +9424,4 @@ function nearestWorldCopyPosition(position, refLng) {
 	return [nearestWorldCopyLng(position[0], refLng), ...position.slice(1)];
 }
 //#endregion
-export { BaseMapAdapter, DEFAULT_LABEL_SIZE_PIXELS, DEFAULT_PIN_PRESENTATION, DEFAULT_TEXT_SIZE_MAX_PIXELS, DEFAULT_TEXT_SIZE_MIN_PIXELS, HATCH_PATTERNS, ImageCapabilityRequiredError, MINE_PATTERN_TILE_SIZE, PinPresentationStore, PointSymbolCapabilityRequiredError, PointerCallbackHub, TEXT_HALO_COLOR, TOUCH_HIT_TOLERANCE_PX, TacticalDraw, TacticalDrawAbortError, TacticalDrawDestroyedError, alignPointSymbolIndicator, bindAbortable, cloneImageGraphic, clonePointSymbol, coerceHandleStyle, combineWithHostSignal, convertPointSymbolPlacement, effectivePointSymbolPixelSize, evaluatePickCandidates, fillPatternImageDimension, fillPatternImageId, getSizeAnchor, hitTestFeature, hitTestIconFeature, ignoreAbort, imageFootprint, imageOpacity, isAnchoredGraphic, isImageGraphic, isMinePattern, isPointSymbol, isTacticalDrawAbortError, isValidPinNumber, makeFillPatternImage, mergeNativeAndCachedPickFeatures, movePointSymbolLocation, nearestWorldCopyLng, nearestWorldCopyPosition, normalizeImageGraphic, parseColor, pickHitTolerance, pickPointerType, placePointSymbol, pointSymbolFootprint, pointSymbolResource, renderOrderToVisualOrder, resizePointSymbolSize, resolveGroundTextSizePixels, resolvePickPresentation, resolvePinPresentation, resolvePointSymbolOffset, resolveTextHaloWidth, resolveTextSizePixels, scalePointSymbolLayout, tryControlMeasureIdFromFeature, validateImageGraphic };
+export { BaseMapAdapter, DEFAULT_LABEL_SIZE_PIXELS, DEFAULT_PIN_PRESENTATION, DEFAULT_TEXT_SIZE_MAX_PIXELS, DEFAULT_TEXT_SIZE_MIN_PIXELS, HATCH_PATTERNS, ImageCapabilityRequiredError, MINE_PATTERN_TILE_SIZE, PinPresentationStore, PointSymbolCapabilityRequiredError, PointerCallbackHub, TEXT_HALO_COLOR, TOUCH_HIT_TOLERANCE_PX, TacticalDraw, TacticalDrawAbortError, TacticalDrawDestroyedError, alignPointSymbolIndicator, bindAbortable, cloneImageGraphic, clonePointSymbol, coerceHandleStyle, combinePinScale, combineWithHostSignal, convertPointSymbolPlacement, effectivePointSymbolPixelSize, evaluatePickCandidates, fillPatternImageDimension, fillPatternImageId, getSizeAnchor, hitTestFeature, hitTestIconFeature, ignoreAbort, imageFootprint, imageOpacity, isAnchoredGraphic, isImageGraphic, isMinePattern, isPointSymbol, isTacticalDrawAbortError, isValidPinNumber, makeFillPatternImage, mergeNativeAndCachedPickFeatures, movePointSymbolLocation, nearestWorldCopyLng, nearestWorldCopyPosition, normalizeImageGraphic, parseColor, pickHitTolerance, pickPointerType, pinDistanceScale, pinZoomScale, placePointSymbol, pointSymbolFootprint, pointSymbolResource, renderOrderToVisualOrder, resizePointSymbolSize, resolveGroundTextSizePixels, resolvePickPresentation, resolvePinPresentation, resolvePointSymbolOffset, resolveTextHaloWidth, resolveTextSizePixels, scalePointSymbolLayout, tryControlMeasureIdFromFeature, validateImageGraphic };

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

@@ -42,16 +42,42 @@ interface PinPresentation {
     radius: number;
     opacity: number;
   };
+  /**
+   * View-wide zoom-out shrinking of the screen-space pin (symbol, plate, halos,
+   * dot and screen lift; stem width stays constant). Below `fullSizeZoom` the
+   * pin is multiplied by `falloff` per zoom level; `sizeLimits` sets the floor.
+   */
+  zoomScale: {
+    enabled: boolean;
+    fullSizeZoom: number;
+    falloff: number;
+  };
+  /**
+   * View-wide perspective sizing: pins nearer the camera than the view center
+   * grow and farther ones shrink, by `(centerDepth / pinDepth) ^ strength`
+   * (1 = true perspective). Multiplies with `zoomScale`; scales the same parts.
+   */
+  distanceScale: {
+    enabled: boolean;
+    strength: number;
+  };
+  /**
+   * View-wide bounds on the pin scale (zoom × distance), applied only while either
+   * scaling mode is enabled: the one place that decides how small or large pins get.
+   * If `minScale` exceeds `maxScale`, `maxScale` wins.
+   */
+  sizeLimits: {
+    minScale: number;
+    maxScale: 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"]>;
-};
+/** Nested settings, merged key by key rather than replaced by a patch. */
+declare const sections: readonly ["stem", "dot", "halo", "symbolHalo", "plate", "zoomScale", "distanceScale", "sizeLimits"];
+type PinSection = (typeof sections)[number];
+declare const viewWideKeys: readonly ["mode", "occlusion", "prioritizePins", "depthSort", "zoomScale", "distanceScale", "sizeLimits"];
+type PinPresentationPatch = Partial<Omit<PinPresentation, PinSection>> & { [K in PinSection]?: Partial<PinPresentation[K]> };
 /** Per-unit appearance and dimensions; spatial rules belong to the view. */
-type PinOverridePatch = Omit<PinPresentationPatch, "mode" | "occlusion" | "prioritizePins" | "depthSort">;
+type PinOverridePatch = Omit<PinPresentationPatch, (typeof viewWideKeys)[number]>;
 interface PinPresentationState {
   defaults: PinPresentationPatch;
   overrides: Record<string, PinOverridePatch>;
@@ -84,6 +110,25 @@ interface PinFootprint {
   max: PixelCoordinate;
 }
 declare const DEFAULT_PIN_PRESENTATION: Readonly<PinPresentation>;
+/**
+ * Multiplier for screen-space pin dimensions at `zoom`, never above 1; 1 when zoom
+ * scaling is off. Unbounded below: combinePinScale applies `sizeLimits`.
+ */
+declare function pinZoomScale(presentation: PinPresentation, zoom: number): number;
+/**
+ * Perspective multiplier for a pin at camera depth `depth` (clip-space w), relative
+ * to the view center at `referenceDepth`; 1 when distance scaling is off. Unbounded:
+ * combinePinScale applies `sizeLimits`. Engines that scale on the GPU must mirror
+ * this formula in their shader.
+ */
+declare function pinDistanceScale(presentation: PinPresentation, depth: number, referenceDepth: number): number;
+/**
+ * Combined screen-space pin scale from the two mode factors (as returned by
+ * pinZoomScale and pinDistanceScale), bounded by `sizeLimits` while either mode is
+ * enabled; if its `minScale` exceeds `maxScale`, `maxScale` wins. Engines that
+ * scale on the GPU must mirror this in their shader.
+ */
+declare function combinePinScale(presentation: PinPresentation, zoomScale: number, distanceScale: number): number;
 /**
  * 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
@@ -515,4 +560,4 @@ interface MapAdapter {
   getLayerFeatures(layerId: LayerId): readonly Feature[];
 }
 //#endregion
-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 };
+export { PinOverridePatch as A, isValidPinNumber as B, makeFillPatternImage as C, PointerEventInfo as D, PointerCallback as E, PinPresentationStatus as F, pinZoomScale as H, 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, resolvePinPresentation as U, pinDistanceScale as V, 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, combinePinScale as z };

package/dist/testing.d.mts

@@ -1,4 +1,4 @@
-import { a as LayerId, o as MapAdapter, p as PixelCoordinate } from "./map-adapter-2Cmj-tem.mjs";
+import { a as LayerId, o as MapAdapter, p as PixelCoordinate } from "./map-adapter-B8zVKzWH.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.11.1",
+  "version": "0.13.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.30.0"
+    "@orbat-mapper/control-measures": "^0.31.0"
   },
   "peerDependencies": {
     "vitest": ">=4.0.0"