@orbat-mapper/tactical-draw 0.6.2 → 0.8.0

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { C as EditPointerDriver, S as makeFillPatternImage, T as PointerEventInfo, _ as HatchPattern, a as LayerId, b as fillPatternImageId, c as MapEvent, d as PickHandler, f as PickOptions, g as HATCH_PATTERNS, h as TextStyleOptions, i as ImageOverlayResource, 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 PointerCallback, x as isMinePattern, y as fillPatternImageDimension } from "./map-adapter-BWvKku2P.mjs";
-import { AmplifierPlacement, AmplifierPlacements, ControlMeasure, ControlMeasureKind, ControlMeasureRender, ControlMeasureStyle, TextAmplifiers } from "@orbat-mapper/control-measures";
+import { C as EditPointerDriver, S as makeFillPatternImage, T as PointerEventInfo, _ as HatchPattern, a as LayerId, b as fillPatternImageId, c as MapEvent, d as PickHandler, f as PickOptions, g as HATCH_PATTERNS, h as TextStyleOptions, i as ImageOverlayResource, 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 PointerCallback, x as isMinePattern, y as fillPatternImageDimension } from "./map-adapter-CyVIAoPf.mjs";
+import { AmplifierPlacement, AmplifierPlacements, ControlMeasure, ControlMeasureKind, ControlMeasureRender, ControlMeasureStyle, SymbolColors, TextAmplifiers } from "@orbat-mapper/control-measures";
 import { Feature, Position } from "geojson";
 
 //#region src/base-map-adapter.d.ts
@@ -354,11 +354,42 @@ interface PointSymbolStyle {
   colors?: PointSymbolColors;
   monoColor?: string;
   opacity?: number;
+  /** 0–1 multiplier applied to both body and connector opacity; defaults to 1. */
+  overallOpacity?: number;
   outlineWidth?: number;
   fill?: boolean;
   frame?: boolean;
   icon?: boolean;
 }
+type PointSymbolPlacement = {
+  mode: "screen-relative";
+  offset: [number, number];
+} | {
+  mode: "ground";
+  position: Position;
+};
+/** Modifier that temporarily activates offset placement for a body drag. */
+type OffsetDragModifier = "alt" | "shift" | "ctrl" | "meta";
+type PointSymbolConnector = "auto" | "direct";
+/** Optional connector overrides; omitted properties inherit symbol styling. */
+interface PointSymbolOffsetStyle {
+  strokeColor?: string;
+  /** 0–1, independent of the body opacity. */
+  opacity?: number;
+  /** Fixed CSS-pixel width, independent of symbol size. */
+  strokeWidth?: number;
+  /** Alternating dash/gap lengths in CSS pixels; [] means solid. */
+  strokeDash?: number[];
+}
+interface PointSymbolOffset {
+  /** Gap at the symbol attachment end, measured along the line in CSS pixels; defaults to 0. */
+  anchorPadding?: number;
+  style?: PointSymbolOffsetStyle;
+  placement: PointSymbolPlacement;
+  connector: PointSymbolConnector;
+  /** Authored indicator length as a multiple of the displayed octagon size. */
+  indicatorLength?: number;
+}
 interface PointSymbol {
   id: string;
   kind: "point-symbol";
@@ -368,6 +399,7 @@ interface PointSymbol {
   rotation: number;
   /** Milsymbol's octagon-based L dimension. */
   size: PointSymbolSize;
+  offset?: PointSymbolOffset;
   textAmplifiers?: TextAmplifiers;
   graphicModifiers?: PointSymbolGraphicModifiers;
   style?: PointSymbolStyle;
@@ -394,6 +426,19 @@ interface PointSymbolRender {
   octagonAnchor: PointSymbolAnchor;
   valid: boolean;
   validation?: unknown;
+  /** Optional body/attachment capability. All coordinates are canonical SVG units. */
+  offset?: {
+    body: PointSymbolRender; /** Body registration in the ordinary image, preserving natural HQ placement. */
+    ordinaryRegistration: PointSymbolAnchor;
+    attachment: PointSymbolAnchor;
+    indicator?: {
+      direction: PointSymbolAnchor;
+      length: number;
+      minLength?: number;
+    };
+    strokeColor: string;
+    strokeWidth: number;
+  };
 }
 interface PointSymbolCapability {
   readonly defaultSize: PointSymbolSize;
@@ -616,7 +661,7 @@ interface InteractionStyle {
  * remove) but no midpoints or box, and the edit controller deletes the tapped
  * vertex instead of dragging it.
  */
-type EditMode = "reshape" | "transform" | "labeldrag" | "delete";
+type EditMode = "reshape" | "transform" | "labeldrag" | "delete" | "offset";
 //#endregion
 //#region src/tactical-draw/session-events.d.ts
 /** A gesture's phase within a stream of {@link TransientChangeEvent}s. */
@@ -895,7 +940,63 @@ interface EditChangeEvent {
   abort(): void;
 }
 //#endregion
+//#region src/point-symbol-offset.d.ts
+/** Read-only layout needs forward projection only. Coordinates are CSS pixels. */
+type PointSymbolProjection = Pick<MapAdapter, "getPixelFromCoordinate" | "getBearing" | "getResolution">;
+/** Editing may also require inverse projection (notably ground placement). */
+type PointSymbolView = Pick<MapAdapter, "getPixelFromCoordinate" | "getCoordinateFromPixel" | "getBearing" | "getResolution">;
+interface PointSymbolOffsetLayout {
+  /** Selected ordinary or detached body render, with canonical SVG dimensions. */
+  render: PointSymbolRender;
+  /** Selected body resource; dimensions and anchor remain in canonical SVG units. */
+  resource: IconResource;
+  /** Body opacity after applying the overall multiplier. */
+  bodyOpacity: number;
+  /** Clockwise radians in the projection plane. */
+  rotation: number;
+  actual: PixelCoordinate;
+  /** Body registration, including natural HQ displacement in ordinary placement. */
+  display: PixelCoordinate;
+  /** Coordinate at which the chosen image's resource anchor is painted. */
+  imageAnchor: PixelCoordinate;
+  ordinaryDisplay: PixelCoordinate;
+  attachment?: PixelCoordinate;
+  junction?: PixelCoordinate;
+  direction?: PixelCoordinate;
+  path: PixelCoordinate[];
+  kind: "ordinary" | "direct" | "indicator-only" | "with-extension";
+  status: "ok" | "unsupported-presentation";
+  scale: number;
+  /** Resolved connector styling in CSS pixels. */
+  connectorStyle: Required<PointSymbolOffsetStyle>;
+}
+/** Pure layout: projection input/output is in CSS pixels, including document contexts. */
+declare function resolvePointSymbolOffset(symbol: PointSymbol, render: PointSymbolRender, view: PointSymbolProjection): PointSymbolOffsetLayout | null;
+/** Set body placement without changing the authoritative coordinate. */
+declare function placePointSymbol(symbol: PointSymbol, render: PointSymbolRender, view: PointSymbolView, display: PixelCoordinate, mode?: PointSymbolPlacement["mode"]): PointSymbol;
+declare function convertPointSymbolPlacement(symbol: PointSymbol, render: PointSymbolRender, view: PointSymbolView, mode: PointSymbolPlacement["mode"]): PointSymbol;
+/** Explicit alignment, also used with hysteresis by pointer editing. */
+declare function alignPointSymbolIndicator(symbol: PointSymbol, render: PointSymbolRender, view: PointSymbolView): PointSymbol;
+declare function movePointSymbolLocation(symbol: PointSymbol, render: PointSymbolRender, view: PointSymbolView, position: Position): PointSymbol;
+/** Canonical resource metadata shared by native adapters and external exporters. */
+declare function pointSymbolResource(render: PointSymbolRender): IconResource;
+/**
+ * Convert a resolved CSS-pixel layout to output units (e.g. 25.4 / 96 for mm).
+ * Scales positions, body scale, line width and dashes together, including the
+ * already-resolved offset and padding. Canonical resources, direction, rotation
+ * and opacity stay unchanged. Does not mutate the input or authored symbol.
+ */
+declare function scalePointSymbolLayout(layout: PointSymbolOffsetLayout, factor: number): PointSymbolOffsetLayout;
+//#endregion
 //#region src/tactical-draw/graphic-edit-session.d.ts
+interface PointSymbolOffsetControls {
+  readonly layout: PointSymbolOffsetLayout | null;
+  readonly connectors: readonly PointSymbolConnector[];
+  setPlacement(mode: PointSymbolPlacement["mode"]): void;
+  setConnector(connector: PointSymbolConnector): void;
+  align(): void;
+  reset(): void;
+}
 interface GraphicEditChangeEvent<G extends Graphic = Graphic> {
   readonly source: SessionChangeSource;
   readonly graphic: GraphicSnapshot<G>;
@@ -908,6 +1009,8 @@ interface GraphicEditChangeEvent<G extends Graphic = Graphic> {
 /** Common selection/editing contract shared by control measures and point symbols. */
 interface GraphicEditSession<G extends Graphic = Graphic> {
   readonly history: SessionHistory;
+  /** Present on point-symbol sessions; all commands participate in session history. */
+  readonly offset?: PointSymbolOffsetControls;
   /** Immutable edit-start input. */
   readonly graphic: G;
   /** Live working graphic. Copy on read. */
@@ -1321,6 +1424,8 @@ interface InteractionHit {
   measureId?: string;
 }
 interface TacticalDrawOptions {
+  /** Optional point-symbol body-drag shortcut; disabled when omitted or false. */
+  offsetDragModifier?: OffsetDragModifier | false;
   layers?: TacticalDrawLayerOptions;
   /** Optional renderer capability for first-class point symbols (ADR-0029). */
   pointSymbols?: PointSymbolCapability;
@@ -1333,6 +1438,8 @@ interface TacticalDrawOptions {
    * appearance when neither the host nor the measure supplies a style.
    */
   graphicsStyle?: ControlMeasureStyle;
+  /** Doctrinal defaults; explicit style colors take precedence. */
+  symbolColors?: SymbolColors;
   /**
    * Façade-level default interaction-affordance style. Per-slot, per-property
    * merged with `DrawOptions.interactionStyle` / `EditOptions.interactionStyle`
@@ -1350,6 +1457,8 @@ interface TacticalDrawOptions {
   snapping?: SnappingOptions;
 }
 interface EditOptions {
+  /** Override the point-symbol offset shortcut for this edit; false disables it. */
+  offsetDragModifier?: OffsetDragModifier | false;
   signal?: AbortSignal;
   /**
    * Called synchronously once when the edit starts, before any pointer event
@@ -1498,8 +1607,10 @@ declare class TacticalDraw {
   private readonly handlesLayer;
   private readonly ownedLayers;
   private readonly graphicsStyle;
+  private readonly symbolColors;
   private readonly defaultInteractionStyle;
   private readonly generateId;
+  private offsetDragModifier;
   private readonly pointSymbols;
   private readonly images;
   private snappingOptions;
@@ -1550,6 +1661,8 @@ declare class TacticalDraw {
   private transformCounter;
   /** Snapshot of the host's latest authoritative Graphic membership and order. */
   private lastRenderedMeasures;
+  /** Whether any last-rendered graphic reads the whole camera, not just scale. */
+  private lastRenderedHasViewDependent;
   private snapGeometryFeatures;
   /**
    * Rendered graphics-layer groups, keyed on Graphic snapshot identity. Each
@@ -1587,6 +1700,8 @@ declare class TacticalDraw {
    */
   private hasHighlightOutlines;
   constructor(adapter: MapAdapter, options?: TacticalDrawOptions);
+  /** Change the default shortcut for subsequent drags, including in an active edit. */
+  setOffsetDragModifier(modifier: OffsetDragModifier | false): void;
   /** Replace snapping configuration without recreating the map adapter or façade. */
   setSnappingOptions(options?: SnappingOptions): void;
   /** Clear transient host affordances when snapping or its interaction ends. */
@@ -2031,14 +2146,18 @@ interface TransformBox {
   angle: number;
 }
 //#endregion
+//#region src/point-symbol-size.d.ts
+declare function effectivePointSymbolPixelSize(symbol: Pick<PointSymbol, "size">, resolution: number | undefined): number;
+//#endregion
 //#region src/tactical-draw/point-symbol-rendering.d.ts
 interface PointSymbolFootprint {
   box: TransformBox;
   corners: PixelCoordinate[];
+  /** Connector path, separate from the body-only transform box. */
+  connector: PixelCoordinate[];
 }
-declare function effectivePointSymbolPixelSize(symbol: PointSymbol, resolution: number | undefined): number;
 /** Complete rotated logical footprint for selection and transform chrome. */
-declare function pointSymbolFootprint(symbol: PointSymbol, render: PointSymbolRender, adapter: Pick<MapAdapter, "getBearing" | "getPixelFromCoordinate" | "getResolution">): PointSymbolFootprint | null;
+declare function pointSymbolFootprint(symbol: PointSymbol, render: PointSymbolRender, adapter: PointSymbolProjection): PointSymbolFootprint | null;
 //#endregion
 //#region src/tactical-draw/image-rendering.d.ts
 interface ImageFootprint {
@@ -2061,4 +2180,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_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 PickCandidate, type PickCandidateHit, type PickCandidateHitKind, type PickCandidateInput, type PickEvaluationContext, type PickEvent, type PickHandler, type PickOptions, type PickPointerType, type PixelCoordinate, type PointSymbol, type PointSymbolAnchor, type PointSymbolCapability, PointSymbolCapabilityRequiredError, type PointSymbolColors, type PointSymbolFootprint, type PointSymbolGraphicModifiers, type PointSymbolRender, type PointSymbolSize, type PointSymbolStyle, type PointerCallback, PointerCallbackHub, type PointerEventInfo, type ResolvedPickPresentation, 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, bindAbortable, cloneImageGraphic, clonePointSymbol, coerceHandleStyle, combineWithHostSignal, effectivePointSymbolPixelSize, evaluatePickCandidates, fillPatternImageDimension, fillPatternImageId, getSizeAnchor, hitTestFeature, hitTestIconFeature, ignoreAbort, imageFootprint, imageOpacity, isAnchoredGraphic, isImageGraphic, isMinePattern, isPointSymbol, isTacticalDrawAbortError, makeFillPatternImage, mergeNativeAndCachedPickFeatures, nearestWorldCopyLng, nearestWorldCopyPosition, normalizeImageGraphic, pickHitTolerance, pickPointerType, pointSymbolFootprint, renderOrderToVisualOrder, resizePointSymbolSize, resolveGroundTextSizePixels, resolvePickPresentation, resolveTextHaloWidth, resolveTextSizePixels, tryControlMeasureIdFromFeature, validateImageGraphic };
+export { type AnchoredGraphic, BaseMapAdapter, type CombinedAbort, DEFAULT_LABEL_SIZE_PIXELS, 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, 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 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, makeFillPatternImage, mergeNativeAndCachedPickFeatures, movePointSymbolLocation, nearestWorldCopyLng, nearestWorldCopyPosition, normalizeImageGraphic, pickHitTolerance, pickPointerType, placePointSymbol, pointSymbolFootprint, pointSymbolResource, renderOrderToVisualOrder, resizePointSymbolSize, resolveGroundTextSizePixels, resolvePickPresentation, resolvePointSymbolOffset, resolveTextHaloWidth, resolveTextSizePixels, scalePointSymbolLayout, tryControlMeasureIdFromFeature, validateImageGraphic };