@orbat-mapper/tactical-draw 0.2.0-alpha.4 → 0.2.0-alpha.40

package/README.md

@@ -10,6 +10,10 @@ concrete map engine in sight. Bring your own: pair this package with one of
 the engine adapters, or implement `MapAdapter` against whatever you're
 already using.
 
+Point symbols are also optional: the core contains only their lightweight
+model and capability interface. Add `@orbat-mapper/point-symbols` and
+`milsymbol` when an application needs MIL-STD-2525/APP-6 unit icons.
+
 ## Installation
 
 ```bash
@@ -50,19 +54,19 @@ pnpm add @orbat-mapper/tactical-draw-adapter-leaflet leaflet
 
 ## Pick to edit
 
-Use `onMeasurePick` to subscribe to committed control measures without accessing
+Use `onGraphicPick` to subscribe to committed graphics without accessing
 internal layer ids:
 
 ```ts
-const unsubscribe = td.onMeasurePick((event) => {
-  const measure = measures.find((candidate) => candidate.id === event.id);
-  if (measure) void td.edit(measure);
+const unsubscribe = td.onGraphicPick((event) => {
+  const graphic = graphics.find((candidate) => candidate.id === event.id);
+  if (graphic) void td.edit(graphic);
 });
 ```
 
-The handler receives the full `PickEvent`, with `event.id` set to the control
-measure id. The returned unsubscribe function is idempotent, and
-`onMeasurePick(handler, { signal })` also supports abort-driven teardown.
+The handler receives the full `PickEvent`, with `event.id` set to the graphic
+id. The returned unsubscribe function is idempotent, and
+`onGraphicPick(handler, { signal })` also supports abort-driven teardown.
 
 ## Cancel and inspect the active interaction
 
@@ -83,6 +87,22 @@ if (session && "canCommit" in session) {
 }
 ```
 
+Live edit and transform sessions expose a session-local `history`. Completed
+gestures and authored programmatic mutations are undoable without settling the
+session; pointer-move preview frames are not history steps:
+
+```ts
+const active = td.activeSession;
+const history =
+  (active && "history" in active ? active.history : null) ?? td.activeTransformSession?.history;
+if (history) history.undo();
+```
+
+`history.subscribe(...)` reports `canUndo`, `canRedo`, and optional operation
+labels. Committing folds only the selected working state into the host document
+as one operation. Changing a transform session's members with `setGraphics()`
+establishes a new local baseline and clears both stacks.
+
 ## Bring your own engine
 
 Implement `MapAdapter` (or extend `BaseMapAdapter`) against your map engine