@orbat-mapper/tactical-draw 0.2.0-alpha.10 → 0.2.0-alpha.12

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { ControlMeasure, ControlMeasureKind, ControlMeasureSnapshot, ControlMeasureStyle } from "@orbat-mapper/control-measures";
+import { ControlMeasure, ControlMeasureKind, ControlMeasureSnapshot, ControlMeasureStyle, TextAmplifiers } from "@orbat-mapper/control-measures";
 import { Feature, Position } from "geojson";
 
 //#region src/gestures/types.d.ts
@@ -54,6 +54,13 @@ interface StyleOptions {
   pointRadius?: number;
   text?: TextStyleOptions;
 }
+/**
+ * Text (label) style for a layer. When `labelProperty` is set, adapters also
+ * read per-feature label properties: `rotation` (radians, rendered as
+ * `π − rotation`), `textSizePixels`/`textSizeZoom`/`textSizeResolution`
+ * (ADR-0020), and `textAnchor` (`"start"` = text begins at the label point,
+ * `"end"` = text ends there; absent = centered).
+ */
 interface TextStyleOptions {
   text?: string;
   labelProperty?: string;
@@ -490,6 +497,24 @@ interface InteractionStyle {
  */
 type EditMode = "reshape" | "transform" | "delete";
 //#endregion
+//#region src/tactical-draw/session-events.d.ts
+/**
+ * The reason a session (`TransformSession`, `EditSession`, or `DrawSession`)
+ * settled, delivered to that session's `onSettled` handler (#191 / #194 /
+ * #197). `"close"` covers every commit path of the owning session —
+ * `TransformSession.close()` / `EditSession.close()` / `DrawSession.commit()`,
+ * a click-away close, a gesture commit (dblclick, a second click/tap on the
+ * finishing vertex, a click on another graphics-layer measure), or
+ * `TransformSession.setMembers([])`. `"error"` is the commit-time snapshot
+ * build throwing (the outer promise rejects with that error, not a
+ * `TacticalDrawAbortError`). The remaining values replay
+ * `TacticalDrawAbortError.reason` verbatim: `"escape"`, `"signal"`,
+ * `"session"` (`session.abort()` / `event.abort()`), `"preempted"`,
+ * `"destroyed"`, and `"removed"` (edit / transform only — a measure dropped
+ * from `td.render()`'s measure set).
+ */
+type SettleReason = "close" | "error" | TacticalDrawAbortReason;
+//#endregion
 //#region src/tactical-draw/edit-session.d.ts
 /**
  * Surface delivered via `td.edit(measure, opts).onSession` and synchronously
@@ -497,7 +522,8 @@ type EditMode = "reshape" | "transform" | "delete";
  *
  * `measure` is the immutable edit-start input. `controlPoints` is live working
  * state. After the session settles (`close` / `abort`), every method is a
- * silent no-op.
+ * silent no-op (except [[onSettled]] — late registration still delivers,
+ * asynchronously).
  */
 interface EditSession {
   /** Immutable edit-start input. */
@@ -508,6 +534,13 @@ interface EditSession {
   readonly options: ControlMeasure["options"];
   /** Live working style. Copy on read. */
   readonly style: ControlMeasureStyle | undefined;
+  /**
+   * Live working text amplifiers (MIL-STD-2525E Appendix L Table L-II). Copy
+   * on read. `undefined` when the edit-start measure carried none and none
+   * have been set since. Keys are stored as given — canonicalisation to
+   * doctrinal field codes happens in the core render seam, not here.
+   */
+  readonly textAmplifiers: TextAmplifiers | undefined;
   /** `true` after the first working-copy mutation; back to `false` within tolerance. */
   readonly dirty: boolean;
   readonly modes: readonly EditMode[];
@@ -545,6 +578,13 @@ interface EditSession {
   setSizeAnchor(anchor: SizeAnchor): void;
   /** Shallow-merge per-measure style into the live working copy. */
   setStyle(partial: ControlMeasureStyle): void;
+  /**
+   * Shallow-merge into the live working text amplifiers. A value of
+   * `undefined` or an empty/whitespace-only string deletes that key; the
+   * working record collapses back to `undefined` once it holds no keys. A
+   * silent no-op after the session has settled (like [[setOptions]]).
+   */
+  setTextAmplifiers(partial: Record<string, string | undefined>): void;
   /**
    * Subscribe to working-copy changes. The listener receives an
    * [[EditChangeEvent]] for each completed gesture (drag end, insert/delete
@@ -557,6 +597,47 @@ interface EditSession {
    * have run.
    */
   onChange(listener: (event: EditChangeEvent) => void): () => void;
+  /**
+   * Subscribe to the committed snapshot — the single delivery channel for the
+   * `ControlMeasureSnapshot` this session ever commits (#197, mirroring
+   * `TransformSession.onCommit` #191). Fires exactly once, synchronously from
+   * within the [[close]] call that produced it (`session.close()`,
+   * `event.close()` from [[onChange]], a click-away close, or a click on
+   * another graphics-layer measure), with the same reference [[close]]
+   * returns and the outer `edit` promise resolves with. Never fires on abort.
+   *
+   * 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.
+   */
+  onCommit(handler: (snapshot: ControlMeasureSnapshot) => void): () => void;
+  /**
+   * Subscribe to the session's settlement — the lifecycle complement of
+   * [[onCommit]]: `onCommit` delivers *what* was committed, `onSettled` says
+   * the session is *over* and why (#197, mirroring
+   * `TransformSession.onSettled` #194). Fires exactly once, when the session
+   * settles by any path, commit or abort, with a `SettleReason`.
+   *
+   * - On the commit path it fires **after** [[onCommit]]'s emission, so a
+   *   listener that clears selection state observes a document that already
+   *   contains the committed snapshot.
+   * - On every path it fires **after** the facade has already cleared
+   *   `td.activeSession` — so fold-then-render works from inside the handler.
+   * - `reason` distinguishes commit from abort but is deliberately coarse —
+   *   no payload; the snapshot was already delivered through [[onCommit]].
+   *
+   * Registering after the session has already settled is **not** a no-op
+   * (unlike [[onChange]] / [[onCommit]]): the handler is invoked
+   * asynchronously (on a microtask) exactly once with the settle reason;
+   * unsubscribing before that microtask runs cancels the delivery.
+   *
+   * Listener exceptions are collected; after every listener has run, they are
+   * rethrown (one if single, `AggregateError` otherwise) — mirrors
+   * [[onChange]] / [[onCommit]]. Returns an unsubscribe function.
+   */
+  onSettled(handler: (reason: SettleReason) => void): () => void;
 }
 /**
  * Delivered to `EditSession.onChange` listeners once per completed gesture.
@@ -586,17 +667,6 @@ interface EditChangeEvent {
 }
 //#endregion
 //#region src/tactical-draw/transform-session.d.ts
-/**
- * The reason a `TransformSession` settled, delivered to [[TransformSession.onSettled]].
- * `"close"` covers every commit path — `close()`, `setMembers([])`, a
- * click-away close, or `TransformChangeEvent.close()`. `"error"` is the
- * close-time snapshot build throwing (the `editMany` promise rejected with
- * that error, not a `TacticalDrawAbortError`). The remaining values mirror
- * `TacticalDrawAbortError.reason` exactly: `"escape"`, `"signal"`, `"session"`
- * (`session.abort()` / `event.abort()`), `"preempted"`, `"destroyed"`, and
- * `"removed"` (a member dropped from `td.render()`'s measure set).
- */
-type SettleReason = "close" | "error" | TacticalDrawAbortReason;
 /**
  * Surface delivered via `td.editMany(measures, opts).onSession` and
  * synchronously available from `td.activeTransformSession` while the group
@@ -793,7 +863,8 @@ interface TransformChangeEvent {
  * kinds. Also available from `td.activeSession` while the draw is live.
  *
  * After the draw has settled — either via `commit()` returning `true` or
- * `abort()` resolving — every method is a silent no-op.
+ * `abort()` resolving — every method is a silent no-op (except [[onSettled]]
+ * — late registration still delivers, asynchronously).
  */
 interface DrawSession {
   /** Live snapshot of the committed control points. Copy on read. */
@@ -815,6 +886,45 @@ interface DrawSession {
    * are collected and rethrown after all listeners run.
    */
   onChange(listener: (session: DrawSession) => void): () => void;
+  /**
+   * Subscribe to the committed snapshot — the single delivery channel for the
+   * `ControlMeasureSnapshot` this session ever commits (#197, mirroring
+   * `TransformSession.onCommit` #191). Fires exactly once, synchronously from
+   * within the commit that produced it (`session.commit()`, dblclick, or a
+   * second click/tap on the finishing vertex), with the same reference the
+   * outer `draw` promise resolves with — the committed snapshot, not just the
+   * measure. Never fires on abort.
+   *
+   * 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.
+   */
+  onCommit(handler: (snapshot: ControlMeasureSnapshot) => void): () => void;
+  /**
+   * Subscribe to the session's settlement — the lifecycle complement of
+   * [[onCommit]]: `onCommit` delivers *what* was committed, `onSettled` says
+   * the session is *over* and why (#197, mirroring
+   * `TransformSession.onSettled` #194). Fires exactly once, when the session
+   * settles by any path, commit or abort, with a `SettleReason`.
+   *
+   * - On the commit path it fires **after** [[onCommit]]'s emission.
+   * - On every path it fires **after** the facade has already cleared
+   *   `td.activeSession` — so fold-then-render works from inside the handler.
+   * - `reason` distinguishes commit from abort but is deliberately coarse —
+   *   no payload; the snapshot was already delivered through [[onCommit]].
+   *
+   * Registering after the session has already settled is **not** a no-op
+   * (unlike [[onChange]] / [[onCommit]]): the handler is invoked
+   * asynchronously (on a microtask) exactly once with the settle reason;
+   * unsubscribing before that microtask runs cancels the delivery.
+   *
+   * Listener exceptions are collected; after every listener has run, they are
+   * rethrown (one if single, `AggregateError` otherwise) — mirrors
+   * [[onChange]] / [[onCommit]]. Returns an unsubscribe function.
+   */
+  onSettled(handler: (reason: SettleReason) => void): () => void;
 }
 //#endregion
 //#region src/tactical-draw/tactical-draw.d.ts
@@ -1144,6 +1254,12 @@ declare class TacticalDraw {
    * `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()`.
+   *
+   * 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.
    */
   draw<K extends ControlMeasureKind>(draft: DrawMeasureDraft<K>, options?: DrawOptions): Promise<ControlMeasureSnapshot<K>>;
   /**
@@ -1155,6 +1271,11 @@ declare class TacticalDraw {
    * Default click-away (`closeOnClickAway: true`) closes the edit on a click
    * outside the preview / handle features. Hosts that own close policy pass
    * `false`.
+   *
+   * `EditSession.onCommit` is the single delivery channel for the committed
+   * snapshot and `EditSession.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.
    */
   edit(measure: ControlMeasure, options?: EditOptions): Promise<ControlMeasureSnapshot>;
   /**

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { cloneControlMeasure, controlMeasureIdFromFeature, freezeOrientationOptions, getControlMeasureMetadata, renderControlMeasure, resolveStyleHints, roundToFixed } from "@orbat-mapper/control-measures";
+import { canonicalTextAmplifierKey, cloneControlMeasure, controlMeasureIdFromFeature, freezeOrientationOptions, getControlMeasureMetadata, renderControlMeasure, resolveStyleHints, roundToFixed } from "@orbat-mapper/control-measures";
 //#region src/base-map-adapter.ts
 /**
 * Abstract base class shared by all `MapAdapter` implementations.
@@ -876,7 +876,7 @@ const PREVIEW_CURSOR$1 = "crosshair";
 * kinds need no host UI.
 */
 function runFixedLengthDraw(options) {
-	const { adapter, kind, previewLayer, guideLayer, graphicsStyle, generateId, signal, measureOptions, measureStyle, measureProperties, guide: guideOpt, sizeAnchor, onSettled } = options;
+	const { adapter, kind, previewLayer, guideLayer, graphicsStyle, generateId, signal, measureOptions, measureStyle, measureProperties, measureTextAmplifiers, guide: guideOpt, sizeAnchor, onSettled } = options;
 	const metadata = getControlMeasureMetadata(kind);
 	const rule = metadata.rule;
 	const min = metadata.minCoordinates;
@@ -916,7 +916,7 @@ function runFixedLengthDraw(options) {
 			return;
 		}
 		const previewThreshold = rule?.minimumPreviewPoints ?? required;
-		const features = buildPreviewFeatures$1(adapter, kind, rule && raw.length >= previewThreshold ? rule.derive(raw) : raw, measureOptions, measureStyle, renderOpts);
+		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) : [];
@@ -937,7 +937,8 @@ function runFixedLengthDraw(options) {
 			controlPoints: finalPoints,
 			...measureOptions !== void 0 ? { options: measureOptions } : {},
 			...measureStyle !== void 0 ? { style: measureStyle } : {},
-			...measureProperties !== void 0 ? { properties: measureProperties } : {}
+			...measureProperties !== void 0 ? { properties: measureProperties } : {},
+			...measureTextAmplifiers !== void 0 ? { textAmplifiers: measureTextAmplifiers } : {}
 		}, adapter);
 		const measure = sizeAnchor === "screen" ? captured : bakePixelSizeToGround(captured, adapter);
 		return {
@@ -970,13 +971,14 @@ function runFixedLengthDraw(options) {
 * 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, renderOpts) {
+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 } : {}
+		...measureStyle !== void 0 ? { style: measureStyle } : {},
+		...measureTextAmplifiers !== void 0 ? { textAmplifiers: measureTextAmplifiers } : {}
 	};
 	try {
 		return renderMeasureForAdapter(adapter, measure, {
@@ -1007,6 +1009,117 @@ function outlinePreview$1(points) {
 	return features;
 }
 //#endregion
+//#region src/tactical-draw/session-events.ts
+/**
+* Map a settle-time error to its `SettleReason`: a `TacticalDrawAbortError`
+* replays its own `reason` verbatim; anything else (a `produce` throw from
+* `ctx.commit`) is the commit-time snapshot build failing, reported as
+* `"error"`.
+*/
+function settleReasonFromError(error) {
+	return isTacticalDrawAbortError(error) ? error.reason : "error";
+}
+/**
+* Fan a `runInteraction` settlement out to a session's commit + settle
+* emitters — the shared body of the `onSettled` wrappers in the edit and draw
+* controllers (transform emits its close-path settle from `commitClose`
+* instead, so it does not use this). On the commit path, emit the snapshot
+* then the `"close"` settle in a try/finally so a throwing `onCommit` listener
+* cannot starve the settle emission; on the reject path, emit the settle with
+* the reason derived from the error. Callers run their own facade
+* slot-clearing (`onSettled()`) before this so a listener observes a cleared
+* `td.activeSession`.
+*/
+function settleFromInteraction(settlement, commitEmitter, settleEmitter) {
+	if (settlement.status === "committed") try {
+		commitEmitter.emit(settlement.value);
+	} finally {
+		settleEmitter.emit("close");
+	}
+	else settleEmitter.emit(settleReasonFromError(settlement.error));
+}
+/**
+* Subscribe/emit machinery shared by `TransformSession.onSettled`,
+* `EditSession.onSettled`, and `DrawSession.onSettled` (#191 / #194 / #197):
+* a settle-exactly-once latch, synchronous emission to every listener with
+* exception collection (single rethrow, `AggregateError` otherwise when more
+* than one listener throws), and a late-registration path that delivers the
+* latched reason on a microtask exactly once when a handler subscribes after
+* the session has already settled.
+*
+* `listenerErrorsMessage` becomes the `AggregateError` message — pass a
+* session-specific string (e.g. `"EditSession.onSettled listener errors"`).
+*/
+function createSettleEmitter(listenerErrorsMessage) {
+	const listeners = /* @__PURE__ */ new Set();
+	/** Set exactly once, by `emit` — also the "has settled" latch and the reason replayed to late registrations. */
+	let settledReason = null;
+	return {
+		emit(reason) {
+			if (settledReason !== null) return;
+			settledReason = reason;
+			const current = [...listeners];
+			listeners.clear();
+			const errors = [];
+			for (const listener of current) try {
+				listener(reason);
+			} catch (err) {
+				errors.push(err);
+			}
+			if (errors.length === 1) throw errors[0];
+			if (errors.length > 1) throw new AggregateError(errors, listenerErrorsMessage);
+		},
+		register(handler) {
+			if (settledReason !== null) {
+				const reason = settledReason;
+				let cancelled = false;
+				queueMicrotask(() => {
+					if (!cancelled) handler(reason);
+				});
+				return () => {
+					cancelled = true;
+				};
+			}
+			listeners.add(handler);
+			return () => {
+				listeners.delete(handler);
+			};
+		}
+	};
+}
+/**
+* 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
+* once — a transform's `setMembers` 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
+* `onChange`.
+*/
+function createCommitEmitter(listenerErrorsMessage) {
+	const listeners = /* @__PURE__ */ new Set();
+	return {
+		emit(value) {
+			const current = [...listeners];
+			const errors = [];
+			for (const listener of current) try {
+				listener(value);
+			} catch (err) {
+				errors.push(err);
+			}
+			if (errors.length === 1) throw errors[0];
+			if (errors.length > 1) throw new AggregateError(errors, listenerErrorsMessage);
+		},
+		register(listener) {
+			listeners.add(listener);
+			return () => {
+				listeners.delete(listener);
+			};
+		}
+	};
+}
+//#endregion
 //#region src/tactical-draw/draw-controller-variable.ts
 const PREVIEW_CM_ID = "__td_preview__";
 const PREVIEW_CURSOR = "crosshair";
@@ -1018,7 +1131,7 @@ const PREVIEW_CURSOR = "crosshair";
 * added point again" as additional gesture-level commit triggers.
 */
 function runVariableLengthDraw(options) {
-	const { adapter, kind, previewLayer, guideLayer, graphicsStyle, generateId, signal, onSession, seed, measureOptions, measureStyle, measureProperties, guide: guideOpt, sizeAnchor, onSettled } = options;
+	const { adapter, kind, previewLayer, guideLayer, graphicsStyle, generateId, signal, onSession, seed, measureOptions, measureStyle, measureProperties, measureTextAmplifiers, guide: guideOpt, sizeAnchor, onSettled } = options;
 	const metadata = getControlMeasureMetadata(kind);
 	if (typeof metadata.minCoordinates !== "number") throw new Error(`runVariableLengthDraw: kind "${kind}" has no minCoordinates metadata`);
 	const min = metadata.minCoordinates;
@@ -1053,7 +1166,8 @@ function runVariableLengthDraw(options) {
 			kind,
 			controlPoints: initialPoints.map((p) => [...p]),
 			...measureOptions !== void 0 ? { options: measureOptions } : {},
-			...measureStyle !== void 0 ? { style: measureStyle } : {}
+			...measureStyle !== void 0 ? { style: measureStyle } : {},
+			...measureTextAmplifiers !== void 0 ? { textAmplifiers: measureTextAmplifiers } : {}
 		}, {
 			...renderOpts,
 			validationMode: "throw"
@@ -1064,6 +1178,8 @@ function runVariableLengthDraw(options) {
 	let ctx;
 	const savedCursor = "";
 	const changeListeners = /* @__PURE__ */ new Set();
+	const commitEmitter = createCommitEmitter("DrawSession.onCommit listener errors");
+	const settleEmitter = createSettleEmitter("DrawSession.onSettled listener errors");
 	function canCommitNow() {
 		const n = committed.length;
 		if (typeof max === "number" && n > max) return false;
@@ -1100,6 +1216,13 @@ function runVariableLengthDraw(options) {
 			return () => {
 				changeListeners.delete(listener);
 			};
+		},
+		onCommit(listener) {
+			if (ctx.settled) return () => {};
+			return commitEmitter.register(listener);
+		},
+		onSettled(handler) {
+			return settleEmitter.register(handler);
 		}
 	};
 	function fireChange() {
@@ -1167,7 +1290,7 @@ function runVariableLengthDraw(options) {
 			points.splice(idx, 0, rubberBand);
 		} else points = [...committed];
 		if (rule) points = rule.derive(points);
-		const previewFeatures = points.length === 0 ? [] : buildPreviewFeatures(adapter, kind, points, measureOptions, measureStyle, renderOpts);
+		const previewFeatures = points.length === 0 ? [] : buildPreviewFeatures(adapter, kind, points, measureOptions, measureStyle, measureTextAmplifiers, renderOpts);
 		ctx.writeLayer(previewLayer, previewFeatures);
 		const guideFeatures = points.length === 0 || !guideEnabled ? [] : buildGuideFeatures(points, isAreaKind, trailingFixed);
 		ctx.writeLayer(guideLayer, guideFeatures);
@@ -1186,7 +1309,8 @@ function runVariableLengthDraw(options) {
 			controlPoints: committed.map((p) => [...p]),
 			...measureOptions !== void 0 ? { options: measureOptions } : {},
 			...measureStyle !== void 0 ? { style: measureStyle } : {},
-			...measureProperties !== void 0 ? { properties: measureProperties } : {}
+			...measureProperties !== void 0 ? { properties: measureProperties } : {},
+			...measureTextAmplifiers !== void 0 ? { textAmplifiers: measureTextAmplifiers } : {}
 		}, adapter);
 		const measure = sizeAnchor === "screen" ? built : bakePixelSizeToGround(built, adapter);
 		return {
@@ -1199,7 +1323,10 @@ function runVariableLengthDraw(options) {
 		signal,
 		layers: [previewLayer, guideLayer],
 		onViewChange: rescaleOnViewChange,
-		onSettled,
+		onSettled: (settlement) => {
+			if (onSettled) onSettled();
+			settleFromInteraction(settlement, commitEmitter, settleEmitter);
+		},
 		attach(c) {
 			ctx = c;
 			c.onTeardown(() => {
@@ -1234,13 +1361,14 @@ function isValidPosition(value) {
 	}
 	return true;
 }
-function buildPreviewFeatures(adapter, kind, points, measureOptions, measureStyle, renderOpts) {
+function buildPreviewFeatures(adapter, kind, points, measureOptions, measureStyle, measureTextAmplifiers, renderOpts) {
 	const measure = {
 		id: PREVIEW_CM_ID,
 		kind,
 		controlPoints: points,
 		...measureOptions !== void 0 ? { options: measureOptions } : {},
-		...measureStyle !== void 0 ? { style: measureStyle } : {}
+		...measureStyle !== void 0 ? { style: measureStyle } : {},
+		...measureTextAmplifiers !== void 0 ? { textAmplifiers: measureTextAmplifiers } : {}
 	};
 	try {
 		return renderMeasureForAdapter(adapter, measure, renderOpts).features;
@@ -1873,6 +2001,7 @@ function runEdit(opts) {
 	const editStartPoints = measure.controlPoints.map((p) => [...p]);
 	const workingPoints = editStartPoints.map((p) => [...p]);
 	let workingOptions = { ...measure.options ?? {} };
+	let workingTextAmplifiers = measure.textAmplifiers && Object.keys(measure.textAmplifiers).length > 0 ? { ...measure.textAmplifiers } : void 0;
 	let modes = requestedModes;
 	let dirty = false;
 	let nonGeometryDirty = false;
@@ -1897,6 +2026,8 @@ function runEdit(opts) {
 	*/
 	let pendingModes = null;
 	const changeListeners = /* @__PURE__ */ new Set();
+	const commitEmitter = createCommitEmitter("EditSession.onCommit listener errors");
+	const settleEmitter = createSettleEmitter("EditSession.onSettled listener errors");
 	/**
 	* The transform box's rotation, in radians, session-scoped (ADR-0017 decision
 	* #2): starts at `0` (axis-aligned) and accumulates every committed rotate
@@ -1959,6 +2090,8 @@ function runEdit(opts) {
 			options: workingOptions,
 			controlPoints: workingPoints.map((p) => [...p])
 		};
+		if (workingTextAmplifiers) working.textAmplifiers = workingTextAmplifiers;
+		else delete working.textAmplifiers;
 		let features;
 		try {
 			features = renderMeasureForAdapter(adapter, working, renderOpts).features;
@@ -2010,6 +2143,8 @@ function runEdit(opts) {
 			options,
 			controlPoints: workingPoints.map((p) => [...p])
 		};
+		if (workingTextAmplifiers) working.textAmplifiers = workingTextAmplifiers;
+		else delete working.textAmplifiers;
 		const committed = sizeAnchor === "screen" ? working : bakePixelSizeToGround(working, adapter);
 		return {
 			measure: cloneControlMeasure(committed),
@@ -2061,7 +2196,7 @@ function runEdit(opts) {
 	*  - Reject restores the working state to the pre-gesture snapshot and
 	*    recomputes `dirty`. Close/abort settle the session as normal.
 	*/
-	function emitChange(previousRendered, previousPoints, previousOptions, previousStyle, previousNonGeometryDirty, previousSizeAnchor, currentRendered) {
+	function emitChange(previousRendered, previousPoints, previousOptions, previousStyle, previousNonGeometryDirty, previousSizeAnchor, currentRendered, previousTextAmplifiers) {
 		if (ctx.settled) return;
 		let rejectRequested = false;
 		let closeRequested = false;
@@ -2093,6 +2228,7 @@ function runEdit(opts) {
 			replaceWorkingOptions(previousOptions);
 			currentStyle = previousStyle;
 			sizeAnchor = previousSizeAnchor;
+			workingTextAmplifiers = previousTextAmplifiers;
 			nonGeometryDirty = previousNonGeometryDirty;
 			renderPreview();
 			renderHandlesLayer();
@@ -2117,6 +2253,7 @@ function runEdit(opts) {
 		const previousOptions = { ...preGestureOptions ?? workingOptions ?? {} };
 		const previousStyle = currentStyle;
 		const previousNonGeometryDirty = nonGeometryDirty;
+		const previousTextAmplifiers = workingTextAmplifiers;
 		const previousRendered = rebuildRenderedWith(previousOptions);
 		replaceWorkingPoints(nextPoints);
 		let currentRendered;
@@ -2134,7 +2271,7 @@ function runEdit(opts) {
 		recomputeDirty();
 		dragInFlight = false;
 		drainPendingModes();
-		emitChange(previousRendered, previousPoints, previousOptions, previousStyle, previousNonGeometryDirty, sizeAnchor, currentRendered);
+		emitChange(previousRendered, previousPoints, previousOptions, previousStyle, previousNonGeometryDirty, sizeAnchor, currentRendered, previousTextAmplifiers);
 	}
 	function setOptions(partial) {
 		if (ctx.settled) return;
@@ -2142,6 +2279,7 @@ function runEdit(opts) {
 		const previousOptions = { ...workingOptions ?? {} };
 		const previousStyle = currentStyle;
 		const previousNonGeometryDirty = nonGeometryDirty;
+		const previousTextAmplifiers = workingTextAmplifiers;
 		const previousRendered = rebuildRendered();
 		replaceWorkingOptions({
 			...workingOptions ?? {},
@@ -2157,7 +2295,7 @@ function runEdit(opts) {
 		renderPreview();
 		nonGeometryDirty = true;
 		dirty = true;
-		emitChange(previousRendered, previousPoints, previousOptions, previousStyle, previousNonGeometryDirty, sizeAnchor, currentRendered);
+		emitChange(previousRendered, previousPoints, previousOptions, previousStyle, previousNonGeometryDirty, sizeAnchor, currentRendered, previousTextAmplifiers);
 	}
 	function setStyle(partial) {
 		if (ctx.settled) return;
@@ -2165,6 +2303,7 @@ function runEdit(opts) {
 		const previousOptions = { ...workingOptions ?? {} };
 		const previousStyle = currentStyle;
 		const previousNonGeometryDirty = nonGeometryDirty;
+		const previousTextAmplifiers = workingTextAmplifiers;
 		const previousRendered = rebuildRendered();
 		currentStyle = {
 			...currentStyle ?? {},
@@ -2180,7 +2319,51 @@ function runEdit(opts) {
 		renderPreview();
 		nonGeometryDirty = true;
 		dirty = true;
-		emitChange(previousRendered, previousPoints, previousOptions, previousStyle, previousNonGeometryDirty, sizeAnchor, currentRendered);
+		emitChange(previousRendered, previousPoints, previousOptions, previousStyle, previousNonGeometryDirty, sizeAnchor, currentRendered, previousTextAmplifiers);
+	}
+	/**
+	* Shallow-merge into the live working text amplifiers. Mirrors
+	* [[setOptions]] exactly (dirty tracking, re-render, change emission) —
+	* see that function for the shared shape. A merge value of `undefined` or
+	* an empty/whitespace-only string deletes the key; the record collapses to
+	* `undefined` once empty so `renderPreview`/`rebuildRenderedWith` omit the
+	* key rather than persist `{}`.
+	*
+	* Each patch key resolves to its canonical field key and evicts every
+	* working entry for the same field + suffix — including friendly-alias
+	* twins (`uniqueDesignation` for `T`) — so clearing or replacing via a
+	* canonical key cannot be undone by an alias-backed value surviving in the
+	* working record. Non-empty values are stored under the canonical key;
+	* unknown keys keep literal behavior.
+	*/
+	function setTextAmplifiers(partial) {
+		if (ctx.settled) return;
+		const previousPoints = workingPoints.map((p) => [...p]);
+		const previousOptions = { ...workingOptions ?? {} };
+		const previousStyle = currentStyle;
+		const previousNonGeometryDirty = nonGeometryDirty;
+		const previousTextAmplifiers = workingTextAmplifiers;
+		const previousRendered = rebuildRendered();
+		const merged = { ...workingTextAmplifiers ?? {} };
+		for (const [key, value] of Object.entries(partial)) {
+			const canonicalKey = canonicalTextAmplifierKey(key);
+			if (canonicalKey) {
+				for (const existing of Object.keys(merged)) if (canonicalTextAmplifierKey(existing) === canonicalKey) delete merged[existing];
+			} else delete merged[key];
+			if (value !== void 0 && value.trim() !== "") merged[canonicalKey ?? key] = value;
+		}
+		workingTextAmplifiers = Object.keys(merged).length > 0 ? merged : void 0;
+		let currentRendered;
+		try {
+			currentRendered = rebuildRendered();
+		} catch (err) {
+			workingTextAmplifiers = previousTextAmplifiers;
+			throw err;
+		}
+		renderPreview();
+		nonGeometryDirty = true;
+		dirty = true;
+		emitChange(previousRendered, previousPoints, previousOptions, previousStyle, previousNonGeometryDirty, sizeAnchor, currentRendered, previousTextAmplifiers);
 	}
 	/**
 	* Flip the size anchor for the measure under edit (ADR-0020). Re-renders the
@@ -2196,12 +2379,13 @@ function runEdit(opts) {
 		const previousStyle = currentStyle;
 		const previousNonGeometryDirty = nonGeometryDirty;
 		const previousSizeAnchor = sizeAnchor;
+		const previousTextAmplifiers = workingTextAmplifiers;
 		const previousRendered = rebuildRendered();
 		sizeAnchor = next;
 		const currentRendered = rebuildRendered();
 		nonGeometryDirty = true;
 		dirty = true;
-		emitChange(previousRendered, previousPoints, previousOptions, previousStyle, previousNonGeometryDirty, previousSizeAnchor, currentRendered);
+		emitChange(previousRendered, previousPoints, previousOptions, previousStyle, previousNonGeometryDirty, previousSizeAnchor, currentRendered, previousTextAmplifiers);
 	}
 	/** Apply a translate gesture by shifting every working point by `delta`. */
 	function commitTranslate(delta) {
@@ -2259,6 +2443,9 @@ function runEdit(opts) {
 		get style() {
 			return currentStyle ? { ...currentStyle } : void 0;
 		},
+		get textAmplifiers() {
+			return workingTextAmplifiers ? { ...workingTextAmplifiers } : void 0;
+		},
 		get dirty() {
 			return dirty;
 		},
@@ -2290,6 +2477,9 @@ function runEdit(opts) {
 		setStyle(partial) {
 			setStyle(partial);
 		},
+		setTextAmplifiers(partial) {
+			setTextAmplifiers(partial);
+		},
 		setSizeAnchor(next) {
 			setSizeAnchor(next);
 		},
@@ -2300,6 +2490,13 @@ function runEdit(opts) {
 				changeListeners.delete(listener);
 			};
 		},
+		onCommit(listener) {
+			if (ctx.settled) return () => {};
+			return commitEmitter.register(listener);
+		},
+		onSettled(handler) {
+			return settleEmitter.register(handler);
+		},
 		[COMMIT_GESTURE_FOR_TEST]: (nextPoints) => {
 			commitGesture(nextPoints);
 		},
@@ -2553,7 +2750,10 @@ function runEdit(opts) {
 			handlesLayer
 		],
 		onViewChange: rescaleOnViewChange,
-		onSettled,
+		onSettled: (settlement) => {
+			if (onSettled) onSettled();
+			settleFromInteraction(settlement, commitEmitter, settleEmitter);
+		},
 		attach(c) {
 			ctx = c;
 			driver = adapter.createEditPointerDriver();
@@ -2746,10 +2946,8 @@ function runGroupTransform(opts) {
 	/** Same click-away suppression role as `edit-controller.ts`'s flag of the same name. */
 	let suppressClickAway = false;
 	const changeListeners = /* @__PURE__ */ new Set();
-	const commitListeners = /* @__PURE__ */ new Set();
-	const settleListeners = /* @__PURE__ */ new Set();
-	/** Set exactly once, by `emitSettled` — also the "has settled been emitted" latch and the reason replayed to late registrations. */
-	let settledReason = null;
+	const commitEmitter = createCommitEmitter("TransformSession.onCommit listener errors");
+	const settleEmitter = createSettleEmitter("TransformSession.onSettled listener errors");
 	/** Session-scoped box rotation (ADR-0017 decision #2), shared by the whole group. */
 	let boxAngle = 0;
 	/** The group box fitted over every member's rendered geometry, or `null` when nothing projects this frame. */
@@ -2971,51 +3169,6 @@ function runGroupTransform(opts) {
 		if (errors.length > 1) throw new AggregateError(errors, "TransformSession.onChange listener errors");
 	}
 	/**
-	* Deliver a committed exit-snapshot batch to every `onCommit` listener — the
-	* single delivery channel for both the `setMembers`-removed batch and the
-	* close-time batch (#191). Same exception-collection contract as `emitChange`.
-	*/
-	function emitCommit(snapshots) {
-		const errors = [];
-		for (const listener of [...commitListeners]) try {
-			listener(snapshots);
-		} catch (err) {
-			errors.push(err);
-		}
-		if (errors.length === 1) throw errors[0];
-		if (errors.length > 1) throw new AggregateError(errors, "TransformSession.onCommit listener errors");
-	}
-	/**
-	* Map a settle-time error to its `SettleReason`: a `TacticalDrawAbortError`
-	* replays its own `reason` verbatim; anything else (a `produce` throw from
-	* `ctx.commit`) is the close-time snapshot build failing, reported as
-	* `"error"`.
-	*/
-	function settleReasonFromError(error) {
-		return isTacticalDrawAbortError(error) ? error.reason : "error";
-	}
-	/**
-	* Deliver the session's settlement to every `onSettled` listener — fires
-	* exactly once, whichever path settles first wins the reason. Mirrors
-	* `emitCommit`'s exception-collection contract (one throw if single,
-	* `AggregateError` otherwise), so a throwing listener cannot suppress a
-	* later one nor leave `settledReason` unset.
-	*/
-	function emitSettled(reason) {
-		if (settledReason !== null) return;
-		settledReason = reason;
-		const listeners = [...settleListeners];
-		settleListeners.clear();
-		const errors = [];
-		for (const listener of listeners) try {
-			listener(reason);
-		} catch (err) {
-			errors.push(err);
-		}
-		if (errors.length === 1) throw errors[0];
-		if (errors.length > 1) throw new AggregateError(errors, "TransformSession.onSettled listener errors");
-	}
-	/**
 	* Commit via `ctx.commit` and emit the close batch to `onCommit` listeners,
 	* then emit the settle to `onSettled` listeners (#194) — in a try/finally so
 	* a throwing `onCommit` listener cannot starve the settle emission. The
@@ -3031,9 +3184,9 @@ function runGroupTransform(opts) {
 	function commitClose() {
 		const snapshots = ctx.commit(rebuildRenderedAll);
 		if (snapshots !== void 0) try {
-			emitCommit(snapshots);
+			commitEmitter.emit(snapshots);
 		} finally {
-			emitSettled("close");
+			settleEmitter.emit("close");
 		}
 		return snapshots;
 	}
@@ -3114,7 +3267,7 @@ function runGroupTransform(opts) {
 		renderAllPreviews();
 		renderHandlesLayer();
 		recomputeDirty();
-		if (removedSnapshots.length > 0) emitCommit(removedSnapshots);
+		if (removedSnapshots.length > 0) commitEmitter.emit(removedSnapshots);
 		return removedSnapshots;
 	}
 	function close() {
@@ -3153,26 +3306,10 @@ function runGroupTransform(opts) {
 		},
 		onCommit(listener) {
 			if (ctx.settled) return () => {};
-			commitListeners.add(listener);
-			return () => {
-				commitListeners.delete(listener);
-			};
+			return commitEmitter.register(listener);
 		},
 		onSettled(handler) {
-			if (settledReason !== null) {
-				const reason = settledReason;
-				let cancelled = false;
-				queueMicrotask(() => {
-					if (!cancelled) handler(reason);
-				});
-				return () => {
-					cancelled = true;
-				};
-			}
-			settleListeners.add(handler);
-			return () => {
-				settleListeners.delete(handler);
-			};
+			return settleEmitter.register(handler);
 		}
 	};
 	let activeBoxDrag = null;
@@ -3290,7 +3427,7 @@ function runGroupTransform(opts) {
 		onViewChange: rescaleOnViewChange,
 		onSettled: (settlement) => {
 			if (onSettled) onSettled();
-			if (settlement.status === "rejected") emitSettled(settleReasonFromError(settlement.error));
+			if (settlement.status === "rejected") settleEmitter.emit(settleReasonFromError(settlement.error));
 		},
 		attach(c) {
 			ctx = c;
@@ -3655,6 +3792,12 @@ var TacticalDraw = class {
 	* `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()`.
+	*
+	* 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.
 	*/
 	draw(draft, options) {
 		this.assertAlive();
@@ -3683,6 +3826,7 @@ var TacticalDraw = class {
 			measureOptions: draft.options,
 			measureStyle: draft.style,
 			measureProperties: draft.properties,
+			measureTextAmplifiers: draft.textAmplifiers,
 			guide: options?.guide,
 			sizeAnchor: options?.sizeAnchor,
 			onSettled
@@ -3699,6 +3843,7 @@ var TacticalDraw = class {
 			measureOptions: draft.options,
 			measureStyle: draft.style,
 			measureProperties: draft.properties,
+			measureTextAmplifiers: draft.textAmplifiers,
 			guide: options?.guide,
 			sizeAnchor: options?.sizeAnchor,
 			onSettled
@@ -3713,6 +3858,11 @@ var TacticalDraw = class {
 	* Default click-away (`closeOnClickAway: true`) closes the edit on a click
 	* outside the preview / handle features. Hosts that own close policy pass
 	* `false`.
+	*
+	* `EditSession.onCommit` is the single delivery channel for the committed
+	* snapshot and `EditSession.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.
 	*/
 	edit(measure, options) {
 		this.assertAlive();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orbat-mapper/tactical-draw",
-  "version": "0.2.0-alpha.10",
+  "version": "0.2.0-alpha.12",
   "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.8"
+    "@orbat-mapper/control-measures": "^0.2.0-alpha.9"
   },
   "devDependencies": {
     "@arethetypeswrong/core": "^0.18.3",