@orbat-mapper/tactical-draw 0.2.0-alpha.29 → 0.2.0-alpha.30

package/dist/index.d.mts

@@ -739,6 +739,27 @@ interface InteractionStyle {
 type EditMode = "reshape" | "transform" | "labeldrag" | "delete";
 //#endregion
 //#region src/tactical-draw/session-events.d.ts
+/** A gesture's phase within a stream of {@link TransientChangeEvent}s. */
+type TransientPhase = "start" | "move" | "end";
+/**
+ * An in-flight mutation of a graphic's working geometry during a gesture —
+ * streamed continuously while the gesture runs (`EditSession.onTransientChange`
+ * / `DrawSession.onTransientChange`), distinct from the once-per-completed-
+ * gesture `onChange`. Hosts use it for live feedback, e.g. a radius readout
+ * while dragging a circle handle.
+ */
+interface TransientChangeEvent {
+  /** Gesture phase. `end` fires exactly once per started gesture — on commit AND on cancel/abort. */
+  readonly phase: TransientPhase;
+  /** The full working control points at this instant (lon/lat). Fresh array per emission. */
+  readonly points: readonly Position[];
+  /**
+   * Index of the live point in `points` — the dragged vertex in edit, the
+   * rubber-band point in draw — or `null` when the whole geometry moves at
+   * once (box translate / rotate / scale).
+   */
+  readonly pointIndex: number | null;
+}
 /**
  * The reason a session (`TransformSession`, `EditSession`, or `DrawSession`)
  * settled, delivered to that session's `onSettled` handler (#191 / #194 /
@@ -912,6 +933,28 @@ interface EditSession {
    * [[onChange]] / [[onCommit]]. Returns an unsubscribe function.
    */
   onSettled(handler: (reason: SettleReason) => void): () => void;
+  /**
+   * Subscribe to the continuous stream of in-flight geometry mutations —
+   * vertex/midpoint drags and box scale/rotate/translate gestures — fired
+   * throughout the gesture rather than once at its end (contrast
+   * [[onChange]]). `start` fires at gesture begin, `move` on every pointer
+   * tick, and `end` fires exactly once when the gesture finishes by any
+   * path: commit, a click-slop no-op (a box body click that never becomes a
+   * drag), or session abort/teardown mid-drag. `end` fires **before** the
+   * gesture's [[onChange]] emission (and, on the commit path, before
+   * [[onCommit]]/[[onSettled]] too), so a listener observing both channels
+   * sees the transient stream close first.
+   *
+   * Label-placement drags (`labeldrag` mode) do not fire this — they move
+   * amplifier placements, not control points.
+   *
+   * Listener exceptions are collected; after every listener has run, they
+   * are rethrown (one if single, `AggregateError` otherwise) — mirrors
+   * [[onChange]]. Returns an unsubscribe function; registering after the
+   * session has settled returns a no-op unsubscribe and the listener never
+   * fires.
+   */
+  onTransientChange(listener: (event: TransientChangeEvent) => void): () => void;
 }
 /**
  * Delivered to `EditSession.onChange` listeners once per completed gesture.
@@ -1264,6 +1307,24 @@ interface DrawSession {
    * [[onChange]] / [[onCommit]]. Returns an unsubscribe function.
    */
   onSettled(handler: (reason: SettleReason) => void): () => void;
+  /**
+   * Subscribe to the continuous stream of rubber-band pointer ticks while the
+   * draw is live — contrast [[onChange]], which fires once per committed
+   * point. `start` fires on the first rubber-band tick, `move` on every
+   * subsequent tick; a click that commits a point does not itself emit — the
+   * next rubber-band tick after it does. `end` fires exactly once, when the
+   * session settles (commit or abort).
+   *
+   * `points` is the committed points with the live rubber-band point spliced
+   * in at its insertion index; `pointIndex` is that index.
+   *
+   * Listener exceptions are collected; after every listener has run, they
+   * are rethrown (one if single, `AggregateError` otherwise) — mirrors
+   * [[onChange]]. Returns an unsubscribe function; registering after the
+   * session has settled returns a no-op unsubscribe and the listener never
+   * fires.
+   */
+  onTransientChange(listener: (event: TransientChangeEvent) => void): () => void;
 }
 //#endregion
 //#region src/tactical-draw/snapping.d.ts
@@ -1465,9 +1526,13 @@ type DrawMeasureDraft<K extends ControlMeasureKind = ControlMeasureKind> = {
 interface DrawOptions {
   signal?: AbortSignal;
   /**
-   * Called synchronously once when a variable-length draw starts, before any
-   * pointer event is processed. The session lets a host wire a Done/Cancel
-   * toolbar to the active draw. Ignored for fixed-length kinds.
+   * Called synchronously once when a draw starts, before any pointer event
+   * is processed. The session lets a host wire a Done/Cancel toolbar to the
+   * active draw and subscribe to live control-point / transient-geometry
+   * feedback. Surfaced for both variable- and fixed-length kinds — a
+   * fixed-length session auto-commits on the last required click, so its
+   * main value is `onTransientChange` (e.g. a live radius readout) and
+   * `abort()`.
    */
   onSession?: (session: DrawSession) => void;
   /**
@@ -1666,17 +1731,19 @@ declare class TacticalDraw {
    */
   private trackTransformSession;
   /**
-   * Start an interactive draw. Fixed-length kinds commit automatically on the
-   * last required click. Variable-length kinds surface a `DrawSession` via
-   * `opts.onSession` and commit on `session.commit()`, `dblclick`, or a second
-   * click on the last added control point. All paths reject with
-   * `TacticalDrawAbortError` on signal / Escape / destroy / `session.abort()`.
+   * Start an interactive draw. Both fixed- and variable-length kinds surface
+   * a `DrawSession` via `opts.onSession`. Fixed-length kinds commit
+   * automatically on the last required click; variable-length kinds commit
+   * on `session.commit()`, `dblclick`, or a second click on the last added
+   * control point. All paths reject with `TacticalDrawAbortError` on
+   * signal / Escape / destroy / `session.abort()`.
    *
-   * For a variable-length draw, `DrawSession.onCommit` is the single delivery
-   * channel for the committed snapshot and `DrawSession.onSettled` is the
-   * lifecycle signal for when the session is over and why (#197) — together
-   * they make the returned promise non-load-bearing for hosts that adopt them.
-   * Fixed-length kinds have no session and settle only through the promise.
+   * `DrawSession.onCommit` is the single delivery channel for the committed
+   * snapshot and `DrawSession.onSettled` is the lifecycle signal for when the
+   * session is over and why (#197) — together they make the returned promise
+   * non-load-bearing for hosts that adopt them. `DrawSession.onTransientChange`
+   * streams live rubber-band geometry while the draw is in flight, for both
+   * kinds of session.
    */
   draw(draft: DrawPointSymbolDraft, options?: DrawOptions): Promise<GraphicSnapshot<PointSymbol>>;
   draw<K extends ControlMeasureKind>(draft: DrawMeasureDraft<K>, options?: DrawOptions): Promise<GraphicSnapshot<ControlMeasure<K>>>;
@@ -1964,4 +2031,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 { BaseMapAdapter, type CombinedAbort, DEFAULT_LABEL_SIZE_PIXELS, DEFAULT_TEXT_SIZE_MAX_PIXELS, DEFAULT_TEXT_SIZE_MIN_PIXELS, type DrawMeasureDraft, type DrawOptions, type DrawPointSymbolDraft, type DrawSession, type EditChangeEvent, type EditManyOptions, type EditMode, type EditOptions, type EditPointerDriver, type EditSession, type FeatureOps, type Graphic, type GraphicEditChangeEvent, type GraphicEditSession, type GraphicGeometrySnappingOptions, type GraphicRender, type GraphicSnapshot, type GuideStyle, HATCH_PATTERNS, type HandleStyle, type HatchPattern, type IconResource, type InteractionHit, type InteractionStyle, type LayerId, type MapAdapter, type MapCursor, type MapEvent, type MapEventHandler, type NativeEventEntry, type PickEvent, type PickHandler, type PickOptions, 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 SessionChangeSource, type SessionHistory, type SessionHistoryState, type SettleReason, type SizeAnchor, type SnapCandidate, type SnapCandidateProvider, type SnapCandidateRequest, type SnapInteraction, type SnapResult, type SnappingOptions, type StyleOptions, TOUCH_HIT_TOLERANCE_PX, TacticalDraw, TacticalDrawAbortError, type TacticalDrawAbortReason, TacticalDrawDestroyedError, type TacticalDrawLayerOptions, type TacticalDrawOptions, type TextStyleOptions, type ToPixel, type TransformBox, type TransformChangeEvent, type TransformSession, bindAbortable, clonePointSymbol, coerceHandleStyle, combineWithHostSignal, effectivePointSymbolPixelSize, fillPatternImageDimension, fillPatternImageId, getSizeAnchor, hitTestFeature, hitTestIconFeature, ignoreAbort, isPointSymbol, isTacticalDrawAbortError, makeFillPatternImage, nearestWorldCopyLng, nearestWorldCopyPosition, pickHitTolerance, pointSymbolFootprint, resizePointSymbolSize, resolveGroundTextSizePixels, tryControlMeasureIdFromFeature };
+export { BaseMapAdapter, type CombinedAbort, DEFAULT_LABEL_SIZE_PIXELS, DEFAULT_TEXT_SIZE_MAX_PIXELS, DEFAULT_TEXT_SIZE_MIN_PIXELS, type DrawMeasureDraft, type DrawOptions, type DrawPointSymbolDraft, type DrawSession, type EditChangeEvent, type EditManyOptions, type EditMode, type EditOptions, type EditPointerDriver, type EditSession, type FeatureOps, type Graphic, type GraphicEditChangeEvent, type GraphicEditSession, type GraphicGeometrySnappingOptions, type GraphicRender, type GraphicSnapshot, type GuideStyle, HATCH_PATTERNS, type HandleStyle, type HatchPattern, type IconResource, type InteractionHit, type InteractionStyle, type LayerId, type MapAdapter, type MapCursor, type MapEvent, type MapEventHandler, type NativeEventEntry, type PickEvent, type PickHandler, type PickOptions, 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 SessionChangeSource, type SessionHistory, type SessionHistoryState, type SettleReason, type SizeAnchor, type SnapCandidate, type SnapCandidateProvider, type SnapCandidateRequest, type SnapInteraction, type SnapResult, type SnappingOptions, type StyleOptions, TOUCH_HIT_TOLERANCE_PX, TacticalDraw, TacticalDrawAbortError, type TacticalDrawAbortReason, TacticalDrawDestroyedError, type TacticalDrawLayerOptions, type TacticalDrawOptions, type TextStyleOptions, type ToPixel, type TransformBox, type TransformChangeEvent, type TransformSession, type TransientChangeEvent, type TransientPhase, bindAbortable, clonePointSymbol, coerceHandleStyle, combineWithHostSignal, effectivePointSymbolPixelSize, fillPatternImageDimension, fillPatternImageId, getSizeAnchor, hitTestFeature, hitTestIconFeature, ignoreAbort, isPointSymbol, isTacticalDrawAbortError, makeFillPatternImage, nearestWorldCopyLng, nearestWorldCopyPosition, pickHitTolerance, pointSymbolFootprint, resizePointSymbolSize, resolveGroundTextSizePixels, tryControlMeasureIdFromFeature };

package/dist/index.mjs

@@ -1220,156 +1220,6 @@ function createSnapResolver(adapter, getGraphics, getGeometryFeatures, getOption
 	};
 }
 //#endregion
-//#region src/tactical-draw/draw-controller.ts
-const PREVIEW_CM_ID$1 = "__td_preview__";
-const PREVIEW_CURSOR$1 = "crosshair";
-/**
-* Drive an interactive fixed-length draw against a `MapAdapter`.
-*
-* Caller is the `TacticalDraw` façade. The controller owns:
-*  - control-point accumulation via `click`
-*  - rubber-band preview via `pointermove`
-*  - Escape cancellation via `keydown`
-*  - cursor capture / restore for the duration of the draw
-*  - host `AbortSignal` plumbing and reason mapping
-*
-* Auto-commits when the user clicks the final required point — fixed-length
-* kinds need no host UI.
-*/
-function runFixedLengthDraw(options) {
-	const { adapter, kind, previewLayer, guideLayer, graphicsStyle, generateId, signal, measureOptions, measureStyle, measureProperties, measureTextAmplifiers, guide: guideOpt, sizeAnchor, onSettled, snap } = options;
-	const metadata = getControlMeasureMetadata(kind);
-	const rule = metadata.rule;
-	const min = metadata.minCoordinates;
-	const max = metadata.maxCoordinates;
-	let required;
-	if (rule) required = rule.minimumUserPoints;
-	else if (typeof min === "number" && typeof max === "number" && min === max) required = min;
-	else throw new Error(`runFixedLengthDraw: kind "${kind}" is not fixed-length (min=${min}, max=${max})`);
-	const renderOpts = graphicsStyle ? { graphicsStyle } : void 0;
-	const guideEnabled = (guideOpt ?? true) && !shouldSuppressGuide(metadata);
-	const isAreaKind = metadata.geometry === "area";
-	const committed = [];
-	let rubberBand;
-	let ctx;
-	const savedCursor = "";
-	const handleClick = (event) => {
-		if (ctx.settled) return;
-		committed.push(snappedDrawPosition(snap, event));
-		rubberBand = void 0;
-		if (committed.length >= required) {
-			ctx.commit(buildSnapshot);
-			return;
-		}
-		renderPreview();
-	};
-	const handlePointerMove = (event) => {
-		if (ctx.settled) return;
-		if (committed.length === 0) return;
-		rubberBand = snappedDrawPosition(snap, event);
-		renderPreview();
-	};
-	function renderPreview() {
-		const raw = rubberBand !== void 0 ? [...committed, rubberBand] : [...committed];
-		if (raw.length === 0) {
-			ctx.writeLayer(previewLayer, []);
-			ctx.writeLayer(guideLayer, []);
-			return;
-		}
-		const previewThreshold = rule?.minimumPreviewPoints ?? required;
-		const features = buildPreviewFeatures$1(adapter, kind, rule && raw.length >= previewThreshold ? rule.derive(raw) : raw, measureOptions, measureStyle, measureTextAmplifiers, renderOpts);
-		ctx.writeLayer(previewLayer, features);
-		const guidePoints = rule?.guidePoints ? rule.guidePoints(raw) : raw;
-		const guideFeatures = guideEnabled ? buildGuideFeatures(guidePoints, isAreaKind) : [];
-		ctx.writeLayer(guideLayer, guideFeatures);
-	}
-	function rescaleOnViewChange() {
-		if (!measureRendersFromViewState({
-			kind,
-			options: measureOptions
-		})) return;
-		renderPreview();
-	}
-	function buildSnapshot() {
-		const finalPoints = roundControlPoints(rule ? rule.derive(committed) : committed);
-		const captured = withCommittedAdapterMeasureOptions({
-			id: generateId(),
-			kind,
-			controlPoints: finalPoints,
-			...measureOptions !== void 0 ? { options: measureOptions } : {},
-			...measureStyle !== void 0 ? { style: measureStyle } : {},
-			...measureProperties !== void 0 ? { properties: measureProperties } : {},
-			...measureTextAmplifiers !== void 0 ? { textAmplifiers: measureTextAmplifiers } : {}
-		});
-		const measure = sizeAnchor === "screen" ? captured : bakePixelSizeToGround(captured, adapter);
-		return {
-			graphic: cloneControlMeasure(measure),
-			render: renderMeasureForAdapter(adapter, measure, renderOpts)
-		};
-	}
-	return runInteraction({
-		adapter,
-		signal,
-		layers: [previewLayer, guideLayer],
-		onViewChange: rescaleOnViewChange,
-		onSettled,
-		attach(c) {
-			ctx = c;
-			c.onTeardown(() => {
-				adapter.off("click", handleClick);
-				adapter.off("pointermove", handlePointerMove);
-				adapter.setCursor(savedCursor);
-			});
-			adapter.setCursor(PREVIEW_CURSOR$1);
-			adapter.on("click", handleClick);
-			adapter.on("pointermove", handlePointerMove);
-		}
-	});
-}
-/**
-* Produce preview features for the partial geometry. Tries the full renderer
-* first so the preview looks like the real symbol once enough points are in;
-* falls back to a plain Point/LineString outline when the kind's generator
-* cannot produce a shape yet (under-min count).
-*/
-function buildPreviewFeatures$1(adapter, kind, points, measureOptions, measureStyle, measureTextAmplifiers, renderOpts) {
-	const measure = {
-		id: PREVIEW_CM_ID$1,
-		kind,
-		controlPoints: points,
-		...measureOptions !== void 0 ? { options: measureOptions } : {},
-		...measureStyle !== void 0 ? { style: measureStyle } : {},
-		...measureTextAmplifiers !== void 0 ? { textAmplifiers: measureTextAmplifiers } : {}
-	};
-	try {
-		return renderMeasureForAdapter(adapter, measure, {
-			...renderOpts,
-			validationMode: "throw"
-		}).features;
-	} catch {
-		return outlinePreview$1(points);
-	}
-}
-function outlinePreview$1(points) {
-	const features = [];
-	for (let i = 0; i < points.length; i++) {
-		const pt = {
-			type: "Feature",
-			id: `${PREVIEW_CM_ID$1}:vertex:${i}`,
-			geometry: {
-				type: "Point",
-				coordinates: points[i]
-			},
-			properties: {
-				part: "vertex",
-				index: i
-			}
-		};
-		features.push(pt);
-	}
-	return features;
-}
-//#endregion
 //#region src/tactical-draw/session-events.ts
 /**
 * Map a settle-time error to its `SettleReason`: a `TacticalDrawAbortError`
@@ -1514,10 +1364,13 @@ function createChangeEmitter(options) {
 	};
 }
 /**
-* Subscribe/emit machinery shared by `TransformSession.onCommit`,
-* `EditSession.onCommit`, and `DrawSession.onCommit`: a listener set with
-* synchronous, exception-collecting emission (single rethrow, `AggregateError`
-* otherwise). Unlike `createSettleEmitter`, `emit` may be called more than
+* Channel-neutral subscribe/emit machinery: a listener set with synchronous,
+* exception-collecting emission (single rethrow, `AggregateError` otherwise).
+* Named for its original `onCommit` channel (`TransformSession` /
+* `EditSession` / `DrawSession`), it also carries the `onTransientChange`
+* streams and the fixed/variable draw controllers' `onChange` — any
+* multi-emit channel with no latch. Unlike `createSettleEmitter`, `emit` may
+* be called more than
 * once — a transform's `setGraphics` can commit several removal batches before
 * the close batch — and there is no latch or late-registration path:
 * registration-time `ctx.settled` guards stay in the controllers, mirroring
@@ -1546,6 +1399,232 @@ function createCommitEmitter(listenerErrorsMessage) {
 	};
 }
 //#endregion
+//#region src/tactical-draw/draw-controller.ts
+const PREVIEW_CM_ID$1 = "__td_preview__";
+const PREVIEW_CURSOR$1 = "crosshair";
+/**
+* Drive an interactive fixed-length draw against a `MapAdapter`.
+*
+* Caller is the `TacticalDraw` façade. The controller owns:
+*  - control-point accumulation via `click`
+*  - rubber-band preview via `pointermove`
+*  - Escape cancellation via `keydown`
+*  - cursor capture / restore for the duration of the draw
+*  - host `AbortSignal` plumbing and reason mapping
+*
+* Auto-commits when the user clicks the final required point — fixed-length
+* kinds need no host UI.
+*/
+function runFixedLengthDraw(options) {
+	const { adapter, kind, previewLayer, guideLayer, graphicsStyle, generateId, signal, measureOptions, measureStyle, measureProperties, measureTextAmplifiers, guide: guideOpt, sizeAnchor, onSettled, onSession, snap } = options;
+	const metadata = getControlMeasureMetadata(kind);
+	const rule = metadata.rule;
+	const min = metadata.minCoordinates;
+	const max = metadata.maxCoordinates;
+	let required;
+	if (rule) required = rule.minimumUserPoints;
+	else if (typeof min === "number" && typeof max === "number" && min === max) required = min;
+	else throw new Error(`runFixedLengthDraw: kind "${kind}" is not fixed-length (min=${min}, max=${max})`);
+	const renderOpts = graphicsStyle ? { graphicsStyle } : void 0;
+	const guideEnabled = (guideOpt ?? true) && !shouldSuppressGuide(metadata);
+	const isAreaKind = metadata.geometry === "area";
+	const committed = [];
+	let rubberBand;
+	let ctx;
+	const savedCursor = "";
+	const changeEmitter = createCommitEmitter("DrawSession.onChange listener errors");
+	const commitEmitter = createCommitEmitter("DrawSession.onCommit listener errors");
+	const settleEmitter = createSettleEmitter("DrawSession.onSettled listener errors");
+	const transientEmitter = createCommitEmitter("DrawSession.onTransientChange listener errors");
+	/** Latch: `true` once the first rubber-band tick has fired `"start"`, until `"end"` fires on settle. */
+	let transientStarted = false;
+	function canCommitNow() {
+		return !ctx.settled && committed.length >= required;
+	}
+	const session = {
+		get controlPoints() {
+			return committed.map((p) => [...p]);
+		},
+		get canCommit() {
+			return canCommitNow();
+		},
+		get minControlPoints() {
+			return required;
+		},
+		get maxControlPoints() {
+			return required;
+		},
+		commit() {
+			if (!canCommitNow()) return false;
+			ctx.commit(buildSnapshot);
+			return true;
+		},
+		abort() {
+			if (ctx.settled) return;
+			ctx.fail(new TacticalDrawAbortError("session"));
+		},
+		onChange(listener) {
+			if (ctx.settled) return () => {};
+			return changeEmitter.register(listener);
+		},
+		onCommit(listener) {
+			if (ctx.settled) return () => {};
+			return commitEmitter.register(listener);
+		},
+		onSettled(handler) {
+			return settleEmitter.register(handler);
+		},
+		onTransientChange(listener) {
+			if (ctx.settled) return () => {};
+			return transientEmitter.register(listener);
+		}
+	};
+	function fireChange() {
+		if (ctx.settled) return;
+		changeEmitter.emit(session);
+	}
+	const handleClick = (event) => {
+		if (ctx.settled) return;
+		committed.push(snappedDrawPosition(snap, event));
+		rubberBand = void 0;
+		if (committed.length >= required) {
+			ctx.commit(buildSnapshot);
+			return;
+		}
+		renderPreview();
+		try {
+			fireChange();
+		} catch (err) {
+			ctx.fail(err);
+		}
+	};
+	const handlePointerMove = (event) => {
+		if (ctx.settled) return;
+		if (committed.length === 0) return;
+		rubberBand = snappedDrawPosition(snap, event);
+		renderPreview();
+		const points = [...committed, rubberBand];
+		const phase = transientStarted ? "move" : "start";
+		transientStarted = true;
+		transientEmitter.emit({
+			phase,
+			points,
+			pointIndex: committed.length
+		});
+	};
+	function renderPreview() {
+		const raw = rubberBand !== void 0 ? [...committed, rubberBand] : [...committed];
+		if (raw.length === 0) {
+			ctx.writeLayer(previewLayer, []);
+			ctx.writeLayer(guideLayer, []);
+			return;
+		}
+		const previewThreshold = rule?.minimumPreviewPoints ?? required;
+		const features = buildPreviewFeatures$1(adapter, kind, rule && raw.length >= previewThreshold ? rule.derive(raw) : raw, measureOptions, measureStyle, measureTextAmplifiers, renderOpts);
+		ctx.writeLayer(previewLayer, features);
+		const guidePoints = rule?.guidePoints ? rule.guidePoints(raw) : raw;
+		const guideFeatures = guideEnabled ? buildGuideFeatures(guidePoints, isAreaKind) : [];
+		ctx.writeLayer(guideLayer, guideFeatures);
+	}
+	function rescaleOnViewChange() {
+		if (!measureRendersFromViewState({
+			kind,
+			options: measureOptions
+		})) return;
+		renderPreview();
+	}
+	function buildSnapshot() {
+		const finalPoints = roundControlPoints(rule ? rule.derive(committed) : committed);
+		const captured = withCommittedAdapterMeasureOptions({
+			id: generateId(),
+			kind,
+			controlPoints: finalPoints,
+			...measureOptions !== void 0 ? { options: measureOptions } : {},
+			...measureStyle !== void 0 ? { style: measureStyle } : {},
+			...measureProperties !== void 0 ? { properties: measureProperties } : {},
+			...measureTextAmplifiers !== void 0 ? { textAmplifiers: measureTextAmplifiers } : {}
+		});
+		const measure = sizeAnchor === "screen" ? captured : bakePixelSizeToGround(captured, adapter);
+		return {
+			graphic: cloneControlMeasure(measure),
+			render: renderMeasureForAdapter(adapter, measure, renderOpts)
+		};
+	}
+	return runInteraction({
+		adapter,
+		signal,
+		layers: [previewLayer, guideLayer],
+		onViewChange: rescaleOnViewChange,
+		onSettled: (settlement) => {
+			if (onSettled) onSettled();
+			if (transientStarted) {
+				transientStarted = false;
+				transientEmitter.emit({
+					phase: "end",
+					points: committed.map((p) => [...p]),
+					pointIndex: null
+				});
+			}
+			settleFromInteraction(settlement, commitEmitter, settleEmitter);
+		},
+		attach(c) {
+			ctx = c;
+			c.onTeardown(() => {
+				adapter.off("click", handleClick);
+				adapter.off("pointermove", handlePointerMove);
+				adapter.setCursor(savedCursor);
+			});
+			adapter.setCursor(PREVIEW_CURSOR$1);
+			adapter.on("click", handleClick);
+			adapter.on("pointermove", handlePointerMove);
+			if (onSession) onSession(session);
+		}
+	});
+}
+/**
+* Produce preview features for the partial geometry. Tries the full renderer
+* first so the preview looks like the real symbol once enough points are in;
+* falls back to a plain Point/LineString outline when the kind's generator
+* cannot produce a shape yet (under-min count).
+*/
+function buildPreviewFeatures$1(adapter, kind, points, measureOptions, measureStyle, measureTextAmplifiers, renderOpts) {
+	const measure = {
+		id: PREVIEW_CM_ID$1,
+		kind,
+		controlPoints: points,
+		...measureOptions !== void 0 ? { options: measureOptions } : {},
+		...measureStyle !== void 0 ? { style: measureStyle } : {},
+		...measureTextAmplifiers !== void 0 ? { textAmplifiers: measureTextAmplifiers } : {}
+	};
+	try {
+		return renderMeasureForAdapter(adapter, measure, {
+			...renderOpts,
+			validationMode: "throw"
+		}).features;
+	} catch {
+		return outlinePreview$1(points);
+	}
+}
+function outlinePreview$1(points) {
+	const features = [];
+	for (let i = 0; i < points.length; i++) {
+		const pt = {
+			type: "Feature",
+			id: `${PREVIEW_CM_ID$1}:vertex:${i}`,
+			geometry: {
+				type: "Point",
+				coordinates: points[i]
+			},
+			properties: {
+				part: "vertex",
+				index: i
+			}
+		};
+		features.push(pt);
+	}
+	return features;
+}
+//#endregion
 //#region src/tactical-draw/draw-controller-variable.ts
 const PREVIEW_CM_ID = "__td_preview__";
 const PREVIEW_CURSOR = "crosshair";
@@ -1603,9 +1682,12 @@ function runVariableLengthDraw(options) {
 	let rubberBand;
 	let ctx;
 	const savedCursor = "";
-	const changeListeners = /* @__PURE__ */ new Set();
+	const changeEmitter = createCommitEmitter("DrawSession.onChange listener errors");
 	const commitEmitter = createCommitEmitter("DrawSession.onCommit listener errors");
 	const settleEmitter = createSettleEmitter("DrawSession.onSettled listener errors");
+	const transientEmitter = createCommitEmitter("DrawSession.onTransientChange listener errors");
+	/** Latch: `true` once the first rubber-band tick has fired `"start"`, until `"end"` fires on settle. */
+	let transientStarted = false;
 	function canCommitNow() {
 		const n = committed.length;
 		if (typeof max === "number" && n > max) return false;
@@ -1638,10 +1720,7 @@ function runVariableLengthDraw(options) {
 		},
 		onChange(listener) {
 			if (ctx.settled) return () => {};
-			changeListeners.add(listener);
-			return () => {
-				changeListeners.delete(listener);
-			};
+			return changeEmitter.register(listener);
 		},
 		onCommit(listener) {
 			if (ctx.settled) return () => {};
@@ -1649,18 +1728,15 @@ function runVariableLengthDraw(options) {
 		},
 		onSettled(handler) {
 			return settleEmitter.register(handler);
+		},
+		onTransientChange(listener) {
+			if (ctx.settled) return () => {};
+			return transientEmitter.register(listener);
 		}
 	};
 	function fireChange() {
 		if (ctx.settled) return;
-		const errors = [];
-		for (const listener of [...changeListeners]) try {
-			listener(session);
-		} catch (err) {
-			errors.push(err);
-		}
-		if (errors.length === 1) throw errors[0];
-		if (errors.length > 1) throw new AggregateError(errors, "DrawSession.onChange listener errors");
+		changeEmitter.emit(session);
 	}
 	const handleClick = (event) => {
 		if (ctx.settled) return;
@@ -1707,6 +1783,16 @@ function runVariableLengthDraw(options) {
 		if (committed.length === 0) return;
 		rubberBand = snappedDrawPosition(snap, event);
 		renderPreview();
+		const idx = insertionIndex(committed.length);
+		const points = [...committed];
+		points.splice(idx, 0, rubberBand);
+		const phase = transientStarted ? "move" : "start";
+		transientStarted = true;
+		transientEmitter.emit({
+			phase,
+			points,
+			pointIndex: idx
+		});
 	};
 	function renderPreview() {
 		let points;
@@ -1751,6 +1837,14 @@ function runVariableLengthDraw(options) {
 		onViewChange: rescaleOnViewChange,
 		onSettled: (settlement) => {
 			if (onSettled) onSettled();
+			if (transientStarted) {
+				transientStarted = false;
+				transientEmitter.emit({
+					phase: "end",
+					points: committed.map((p) => [...p]),
+					pointIndex: null
+				});
+			}
 			settleFromInteraction(settlement, commitEmitter, settleEmitter);
 		},
 		attach(c) {
@@ -3065,6 +3159,35 @@ function runEdit(opts) {
 	});
 	const commitEmitter = createCommitEmitter("EditSession.onCommit listener errors");
 	const settleEmitter = createSettleEmitter("EditSession.onSettled listener errors");
+	const transientEmitter = createCommitEmitter("EditSession.onTransientChange listener errors");
+	/**
+	* Latch for the "start"/"end" pairing `emitTransient` enforces: `start`
+	* no-ops (and doesn't re-latch) while a gesture is already open; `end`
+	* no-ops when there is no open gesture. `move` always passes through — the
+	* latch only guards against a duplicate/missing bookend, per the
+	* `onTransientChange` contract (`end` fires exactly once per started
+	* gesture).
+	*/
+	let transientGestureActive = false;
+	/**
+	* Emit one tick of the `EditSession.onTransientChange` stream. `points` is
+	* defensively copied so a listener can't observe (or corrupt) the live
+	* working-point array.
+	*/
+	function emitTransient(phase, points, pointIndex) {
+		if (phase === "start") {
+			if (transientGestureActive) return;
+			transientGestureActive = true;
+		} else if (phase === "end") {
+			if (!transientGestureActive) return;
+			transientGestureActive = false;
+		}
+		transientEmitter.emit({
+			phase,
+			points: points.map((p) => [...p]),
+			pointIndex
+		});
+	}
 	/**
 	* The transform box's rotation, in radians, session-scoped (ADR-0017 decision
 	* #2): starts at `0` (axis-aligned) and accumulates every committed rotate
@@ -3616,6 +3739,10 @@ function runEdit(opts) {
 		},
 		onSettled(handler) {
 			return settleEmitter.register(handler);
+		},
+		onTransientChange(listener) {
+			if (ctx.settled) return () => {};
+			return transientEmitter.register(listener);
 		}
 	};
 	let activeDrag = null;
@@ -3735,6 +3862,7 @@ function runEdit(opts) {
 				preDragPoints,
 				controlPointIndex: hit.kind === "midpoint" ? hit.index + 1 : hit.index
 			};
+			emitTransient("start", fsm.kind === "midpoint" ? initialPoints : preDragPoints, activeDrag.controlPointIndex);
 			if (fsm.kind === "midpoint") {
 				workingPoints.splice(0, workingPoints.length, ...initialPoints);
 				renderPreview();
@@ -3773,6 +3901,7 @@ function runEdit(opts) {
 					},
 					preDragOptions
 				};
+				emitTransient("start", preDragPoints, null);
 				dragInFlight = true;
 				driver.setDragPanEnabled(false);
 			}
@@ -3786,6 +3915,7 @@ function runEdit(opts) {
 		renderPreview();
 		renderHandlesLayer();
 		recomputeDirty();
+		emitTransient("move", snapshot.points, activeDrag.controlPointIndex);
 	}
 	function paintBoxDragSnapshot(pixel, info, constrainRotation = false) {
 		if (!activeBoxDrag) return;
@@ -3797,6 +3927,7 @@ function runEdit(opts) {
 		renderPreview();
 		renderHandlesLayer();
 		recomputeDirty();
+		emitTransient("move", snapshot.points, null);
 	}
 	const onDriverMove = (pixel, info) => {
 		if (ctx.settled) return;
@@ -3836,6 +3967,7 @@ function runEdit(opts) {
 		}
 		if (activeDrag) {
 			if (ctx.settled) {
+				emitTransient("end", workingPoints, activeDrag.controlPointIndex);
 				activeDrag = null;
 				dragInFlight = false;
 				driver.setDragPanEnabled(true);
@@ -3845,12 +3977,14 @@ function runEdit(opts) {
 			activeDrag = null;
 			driver.setDragPanEnabled(true);
 			const next = fsm.end(snappedPixel(pixel, info, "reshape", controlPointIndex));
+			emitTransient("end", next, controlPointIndex);
 			replaceWorkingPoints(preDragPoints);
 			commitGesture(next);
 			return;
 		}
 		if (activeBoxDrag) {
 			if (ctx.settled) {
+				emitTransient("end", workingPoints, null);
 				activeBoxDrag = null;
 				dragInFlight = false;
 				driver.setDragPanEnabled(true);
@@ -3862,6 +3996,7 @@ function runEdit(opts) {
 			if (fsm.kind === "body" && withinClickSlop(pixel, downPixel)) {
 				replaceWorkingPoints(preDragPoints);
 				workingAmplifierPlacements = preDragAmplifierPlacements;
+				emitTransient("end", preDragPoints, null);
 				renderPreview();
 				renderHandlesLayer();
 				recomputeDirty();
@@ -3878,6 +4013,7 @@ function runEdit(opts) {
 			replaceWorkingPoints(preDragPoints);
 			workingAmplifierPlacements = preDragAmplifierPlacements;
 			if (fsm.kind === "rotate") boxAngle += finalSnapshot.box.angle - preDragBox.angle;
+			emitTransient("end", finalSnapshot.points, null);
 			commitGesture(finalSnapshot.points, preDragOptions, transformAmplifierPlacements(preDragAmplifierPlacements, preDragBox, finalSnapshot.box, driver), preDragBox.angle);
 			return;
 		}
@@ -3911,6 +4047,7 @@ function runEdit(opts) {
 		emitSettle: (settlement) => settleFromInteraction(settlement, commitEmitter, settleEmitter),
 		extraTeardown: () => {
 			if (activeDrag !== null || activeBoxDrag !== null || labels.dragging) {
+				emitTransient("end", workingPoints, activeDrag?.controlPointIndex ?? null);
 				driver.setDragPanEnabled(true);
 				activeDrag = null;
 				activeBoxDrag = null;
@@ -5516,6 +5653,7 @@ var TacticalDraw = class {
 			guide: options?.guide,
 			sizeAnchor: options?.sizeAnchor,
 			onSettled,
+			onSession: this.trackSession(options?.onSession),
 			snap: this.resolveSnap
 		}) : runVariableLengthDraw({
 			adapter: this.adapter,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orbat-mapper/tactical-draw",
-  "version": "0.2.0-alpha.29",
+  "version": "0.2.0-alpha.30",
   "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",
@@ -38,7 +38,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@orbat-mapper/control-measures": "^0.2.0-alpha.21"
+    "@orbat-mapper/control-measures": "^0.2.0-alpha.22"
   },
   "devDependencies": {
     "@arethetypeswrong/core": "^0.18.3",