@oh-just-another/state 0.57.0

package/dist/editor/container-ops.d.ts

@@ -0,0 +1,74 @@
+import { type Scene, type Element, type Patch } from "@oh-just-another/scene";
+import type { Bounds, ElementId } from "@oh-just-another/types";
+import type { HandleId } from "../handle.js";
+/**
+ * Pure: fraction of `child`'s area that lies inside `zone`.
+ * Returns 0 when either bbox is degenerate or they don't
+ * intersect. Used by the container drop handler to decide between
+ * "child still belongs to the lane" and "user dragged it out".
+ */
+export declare const coverageRatio: (child: Bounds, zone: Bounds) => number;
+/**
+ * Pure: union of every direct child's world-space AABB. Returns
+ * `null` when the container has no children. Only direct children
+ * are constrained because container resize doesn't cascade into
+ * nested containers (the inner one self-constrains via its own
+ * clamp call).
+ */
+export declare const childrenWorldUnion: (scene: Scene, containerId: ElementId) => Bounds | null;
+/**
+ * Pure: floor the proposed container bounds to whatever is
+ * required to keep every child fully inside the drop-zone. The
+ * expansion is applied at the edges touched by `handle`, so the
+ * dragged corner / side keeps controlling direction — the shape
+ * just refuses to go smaller than the children mandate.
+ *
+ * Works for any shape with a `ContainerSpec` (template-driven or
+ * static metadata). Returns `raw` unchanged when the shape has no
+ * children or isn't a container.
+ */
+export declare const clampContainerToChildren: (scene: Scene, shape: Element, raw: Bounds, handle: HandleId) => Bounds;
+/**
+ * Narrow editor surface used by `ContainerController`. The
+ * controller writes patches back through `applyPatch` and the
+ * gesture-transaction callbacks instead of carrying its own
+ * scene / history references — keeps the call sites local to
+ * Editor (and the transaction model untouched).
+ */
+export interface ContainerOpsRef {
+    readonly scene: Scene;
+    readonly dragElementId: ElementId | null;
+    readonly containerHover: {
+        readonly id: ElementId;
+    } | null;
+    /** Apply the patch to the editor's scene + record into the open gesture tx. */
+    applyPatch(patch: Patch, nextScene: Scene): void;
+}
+/**
+ * End-of-drag container hookup: reparent into hovered container,
+ * grow the parent to fit the dropped child, or drag-out when the
+ * coverage check fails. All patches go through the same gesture
+ * transaction so the reparent + auto-grow land in one undo step.
+ *
+ * Rules:
+ *  - hovering a container that's NOT the current parent → reparent
+ *    + bump to top z-order of the layer, then grow zone to fit;
+ *  - hovering the same container that IS the current parent →
+ *    auto-grow if the child overflowed during the drag;
+ *  - no hover but had a parent → coverage check; ≥ keep threshold
+ *    stays parented (with grow), else drag-out (remove parentId).
+ *  - `group` parents are special: logical wrappers, never drag-out.
+ *
+ * `_worldPoint` is unused; kept on the signature for the exact
+ * release coordinates.
+ */
+export declare const applyContainerDrop: (ref: ContainerOpsRef, _worldPoint: unknown) => void;
+/**
+ * If `childId` no longer fits inside `containerId`'s drop-zone,
+ * expand the zone + the container's outer size. Single patch
+ * added through `ref.applyPatch` (and therefore into the running
+ * gesture transaction). Skips no-op cases (already fits,
+ * container has no width/height field, no container spec).
+ */
+export declare const maybeGrowContainer: (ref: ContainerOpsRef, containerId: ElementId, childId: ElementId) => void;
+//# sourceMappingURL=container-ops.d.ts.map

package/dist/editor/container-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container-ops.d.ts","sourceRoot":"","sources":["../../src/editor/container-ops.ts"],"names":[],"mappings":"AAAA,OAAO,EAYL,KAAK,KAAK,EACV,KAAK,OAAO,EACZ,KAAK,KAAK,EACX,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEhE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAG7C;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,EAAE,MAAM,MAAM,KAAG,MAW3D,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO,KAAK,EAAE,aAAa,SAAS,KAAG,MAAM,GAAG,IAQlF,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB,GACnC,OAAO,KAAK,EACZ,OAAO,OAAO,EACd,KAAK,MAAM,EACX,QAAQ,QAAQ,KACf,MAmDF,CAAC;AAsCF;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,SAAS,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,CAAA;KAAE,GAAG,IAAI,CAAC;IAC3D,+EAA+E;IAC/E,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,GAAG,IAAI,CAAC;CAClD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,kBAAkB,GAC7B,KAAK,eAAe,EACpB,aAAa,OAAO,KACnB,IA0DF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAC7B,KAAK,eAAe,EACpB,aAAa,SAAS,EACtB,SAAS,SAAS,KACjB,IA0CF,CAAC"}

package/dist/editor/container-ops.js

@@ -0,0 +1,262 @@
+import { containerSizeForZone, expandDropZoneToFit, getAutoLayoutSpec, getContainerSpec, getDropZoneWorld, getElement, getElementWorldBounds, isContainer, measureWrap, orderForTop, updateElement, } from "@oh-just-another/scene";
+import { bounds as B } from "@oh-just-another/math";
+import { CONTAINER_KEEP_THRESHOLD } from "../constants.js";
+import { hasWidthHeight } from "./shape-traits.js";
+/**
+ * Pure: fraction of `child`'s area that lies inside `zone`.
+ * Returns 0 when either bbox is degenerate or they don't
+ * intersect. Used by the container drop handler to decide between
+ * "child still belongs to the lane" and "user dragged it out".
+ */
+export const coverageRatio = (child, zone) => {
+    const area = child.width * child.height;
+    if (area <= 0)
+        return 0;
+    const ix = Math.max(child.x, zone.x);
+    const iy = Math.max(child.y, zone.y);
+    const ix2 = Math.min(child.x + child.width, zone.x + zone.width);
+    const iy2 = Math.min(child.y + child.height, zone.y + zone.height);
+    const iw = ix2 - ix;
+    const ih = iy2 - iy;
+    if (iw <= 0 || ih <= 0)
+        return 0;
+    return (iw * ih) / area;
+};
+/**
+ * Pure: union of every direct child's world-space AABB. Returns
+ * `null` when the container has no children. Only direct children
+ * are constrained because container resize doesn't cascade into
+ * nested containers (the inner one self-constrains via its own
+ * clamp call).
+ */
+export const childrenWorldUnion = (scene, containerId) => {
+    let acc = null;
+    for (const s of scene.elements.values()) {
+        if (s.parentId !== containerId)
+            continue;
+        const b = getElementWorldBounds(s);
+        acc = acc ? B.union(acc, b) : b;
+    }
+    return acc;
+};
+/**
+ * Pure: floor the proposed container bounds to whatever is
+ * required to keep every child fully inside the drop-zone. The
+ * expansion is applied at the edges touched by `handle`, so the
+ * dragged corner / side keeps controlling direction — the shape
+ * just refuses to go smaller than the children mandate.
+ *
+ * Works for any shape with a `ContainerSpec` (template-driven or
+ * static metadata). Returns `raw` unchanged when the shape has no
+ * children or isn't a container.
+ */
+export const clampContainerToChildren = (scene, shape, raw, handle) => {
+    if (!isContainer(shape) || !hasWidthHeight(shape))
+        return raw;
+    // Wrap containers REFLOW on resize: the width may shrink down to the widest
+    // single child (children re-wrap into more rows); the height is floored to
+    // the wrapped content height and grows down. The children-union clamp below
+    // would forbid narrowing, so handle wrap separately.
+    if (getAutoLayoutSpec(shape)?.kind === "wrap") {
+        return clampWrapContainer(scene, shape, raw, handle);
+    }
+    const childrenBox = childrenWorldUnion(scene, shape.id);
+    if (!childrenBox)
+        return raw;
+    // Compose a hypothetical container with the proposed bounds, then
+    // ask the resolver where the drop-zone lands at that size. Chrome
+    // (header / margin / padding) stays constant across resize, so a
+    // single-pass expansion is sound for typical templates.
+    const hypothetical = {
+        ...shape,
+        position: { x: raw.x, y: raw.y },
+        width: raw.width,
+        height: raw.height,
+    };
+    const dropZoneWorld = getDropZoneWorld(hypothetical);
+    if (!dropZoneWorld)
+        return raw;
+    let { x, y, width, height } = raw;
+    const dx0 = dropZoneWorld.x;
+    const dy0 = dropZoneWorld.y;
+    const dx1 = dropZoneWorld.x + dropZoneWorld.width;
+    const dy1 = dropZoneWorld.y + dropZoneWorld.height;
+    const cx0 = childrenBox.x;
+    const cy0 = childrenBox.y;
+    const cx1 = childrenBox.x + childrenBox.width;
+    const cy1 = childrenBox.y + childrenBox.height;
+    if (handle.includes("e") && dx1 < cx1) {
+        width += cx1 - dx1;
+    }
+    if (handle.includes("s") && dy1 < cy1) {
+        height += cy1 - dy1;
+    }
+    if (handle.includes("w") && dx0 > cx0) {
+        const shift = dx0 - cx0;
+        x -= shift;
+        width += shift;
+    }
+    if (handle.includes("n") && dy0 > cy0) {
+        const shift = dy0 - cy0;
+        y -= shift;
+        height += shift;
+    }
+    return { x, y, width, height };
+};
+/**
+ * Resize clamp for a wrap (flex-wrap) container: width floors at the widest
+ * single child (+padding) — narrower has nowhere to wrap; height floors at the
+ * wrapped content height at the resulting width and grows DOWN. The dragged
+ * edge keeps controlling direction (west/north shift the opposite edge).
+ */
+const clampWrapContainer = (scene, shape, raw, handle) => {
+    const pad = getContainerSpec(shape)?.padding ?? 0;
+    const rawInner = Math.max(0, raw.width - 2 * pad);
+    const m = measureWrap(scene, shape.id, rawInner);
+    if (!m)
+        return raw; // no children → no constraint
+    let { x, y, width, height } = raw;
+    const minWidth = m.widest + 2 * pad;
+    if (width < minWidth) {
+        const deficit = minWidth - width;
+        width = minWidth;
+        if (handle.includes("w"))
+            x -= deficit; // keep the east edge fixed
+    }
+    // Content height at the FINAL width (narrower ⇒ more rows ⇒ taller).
+    const finalInner = Math.max(0, width - 2 * pad);
+    const mh = finalInner === rawInner ? m : (measureWrap(scene, shape.id, finalInner) ?? m);
+    const minHeight = mh.contentHeight + 2 * pad;
+    if (height < minHeight) {
+        const deficit = minHeight - height;
+        height = minHeight;
+        if (handle.includes("n"))
+            y -= deficit; // keep the south edge fixed
+    }
+    return { x, y, width, height };
+};
+/**
+ * End-of-drag container hookup: reparent into hovered container,
+ * grow the parent to fit the dropped child, or drag-out when the
+ * coverage check fails. All patches go through the same gesture
+ * transaction so the reparent + auto-grow land in one undo step.
+ *
+ * Rules:
+ *  - hovering a container that's NOT the current parent → reparent
+ *    + bump to top z-order of the layer, then grow zone to fit;
+ *  - hovering the same container that IS the current parent →
+ *    auto-grow if the child overflowed during the drag;
+ *  - no hover but had a parent → coverage check; ≥ keep threshold
+ *    stays parented (with grow), else drag-out (remove parentId).
+ *  - `group` parents are special: logical wrappers, never drag-out.
+ *
+ * `_worldPoint` is unused; kept on the signature for the exact
+ * release coordinates.
+ */
+export const applyContainerDrop = (ref, _worldPoint) => {
+    const dragId = ref.dragElementId;
+    if (!dragId)
+        return;
+    const shape = getElement(ref.scene, dragId);
+    if (!shape)
+        return;
+    const hover = ref.containerHover;
+    if (hover && hover.id !== shape.parentId) {
+        // Reparent into hovered container. Bump the dropped shape to
+        // top z-order of its layer so it lands ABOVE the container's
+        // visual body (otherwise the container's fill obscures it).
+        const topOrder = orderForTop([...ref.scene.elements.values()]
+            .filter((s) => s.layerId === shape.layerId && s.id !== dragId)
+            .map((s) => s.order));
+        const r = updateElement(ref.scene, dragId, (s) => ({
+            ...s,
+            parentId: hover.id,
+            order: topOrder,
+        }));
+        ref.applyPatch(r.patch, r.scene);
+        maybeGrowContainer(ref, hover.id, dragId);
+        return;
+    }
+    if (hover && hover.id === shape.parentId) {
+        // Drag-within: cursor still over the same parent. If the
+        // child's bounds overflow the drop-zone, grow the parent.
+        maybeGrowContainer(ref, shape.parentId, dragId);
+        return;
+    }
+    if (shape.parentId) {
+        const parent = getElement(ref.scene, shape.parentId);
+        // Group parents have no drop-zone — they're logical wrappers,
+        // not spatial containers. The drag-out / coverage logic is for
+        // proper containers (swimlane, frame, template); a group child
+        // must stay parented to its group regardless of its world bounds.
+        if (parent?.type === "group")
+            return;
+        // hover = null: cursor left the parent's zone, but the child
+        // itself may still be mostly inside. Coverage check decides:
+        //   ≥ CONTAINER_KEEP_THRESHOLD → keep parent + grow zone to fit.
+        //   < threshold → un-parent (drag-out).
+        const parentZone = parent ? getDropZoneWorld(parent) : null;
+        const childBounds = getElementWorldBounds(shape);
+        const coverage = parentZone ? coverageRatio(childBounds, parentZone) : 0;
+        if (parentZone && coverage >= CONTAINER_KEEP_THRESHOLD) {
+            maybeGrowContainer(ref, shape.parentId, dragId);
+            return;
+        }
+        const r = updateElement(ref.scene, dragId, (s) => {
+            const next = { ...s };
+            delete next.parentId;
+            return next;
+        });
+        ref.applyPatch(r.patch, r.scene);
+    }
+};
+/**
+ * If `childId` no longer fits inside `containerId`'s drop-zone,
+ * expand the zone + the container's outer size. Single patch
+ * added through `ref.applyPatch` (and therefore into the running
+ * gesture transaction). Skips no-op cases (already fits,
+ * container has no width/height field, no container spec).
+ */
+export const maybeGrowContainer = (ref, containerId, childId) => {
+    const container = getElement(ref.scene, containerId);
+    const child = getElement(ref.scene, childId);
+    if (!container || !child)
+        return;
+    const spec = getContainerSpec(container);
+    if (!spec)
+        return;
+    const childWorld = getElementWorldBounds(child);
+    const expanded = expandDropZoneToFit(container, childWorld);
+    if (!expanded)
+        return;
+    if (hasWidthHeight(container)) {
+        const sized = containerSizeForZone({ width: container.width, height: container.height, spec }, expanded);
+        const r = updateElement(ref.scene, containerId, (s) => ({
+            ...s,
+            position: {
+                x: s.position.x + sized.positionOffset.x,
+                y: s.position.y + sized.positionOffset.y,
+            },
+            width: sized.width,
+            height: sized.height,
+            metadata: {
+                ...(s.metadata ?? {}),
+                container: { ...spec, dropZone: expanded },
+            },
+        }));
+        ref.applyPatch(r.patch, r.scene);
+        // Children are stored in absolute world coords — translating
+        // the container's `position` does NOT visually move them, so
+        // no compensating patch is needed.
+        return;
+    }
+    const r = updateElement(ref.scene, containerId, (s) => ({
+        ...s,
+        metadata: {
+            ...(s.metadata ?? {}),
+            container: { ...spec, dropZone: expanded },
+        },
+    }));
+    ref.applyPatch(r.patch, r.scene);
+};
+//# sourceMappingURL=container-ops.js.map

package/dist/editor/container-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container-ops.js","sourceRoot":"","sources":["../../src/editor/container-ops.ts"],"names":[],"mappings":"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"}

package/dist/editor/event-fanout.d.ts

@@ -0,0 +1,48 @@
+import type { Scene } from "@oh-just-another/scene";
+import type { Emitter } from "@oh-just-another/events";
+import type * as Selection from "../selection.js";
+import type { Mode } from "../modes.js";
+import type { EditorEvents } from "../editor-events.js";
+/**
+ * Holds the last-emitted snapshot of every observable Editor slice
+ * so `fanOutEvents` can decide which typed events to fire on the
+ * next `notify()`. Created once per Editor and primed in the
+ * constructor with the initial state so the *first* user-driven
+ * update only fires on a real flip.
+ */
+export interface EditorEventCache {
+    mode: Mode | null;
+    selection: Selection.Selection | null;
+    scene: Scene | null;
+    viewport: Scene["viewport"] | null;
+    canUndo: boolean;
+    canRedo: boolean;
+}
+export declare const createEventCache: () => EditorEventCache;
+/**
+ * Snapshot of the editor's observable state at a single moment.
+ * Passed to `fanOutEvents` instead of the live editor so this
+ * module doesn't import the Editor class (would create a cycle).
+ */
+export interface EditorObservableSnapshot {
+    readonly mode: Mode;
+    readonly selection: Selection.Selection;
+    readonly scene: Scene;
+    readonly canUndo: boolean;
+    readonly canRedo: boolean;
+}
+/**
+ * Compare each slice against the cached last-emitted value and
+ * fire only the typed events that actually flipped — then fire
+ * the umbrella `change` once. Returns nothing; mutates `cache` in
+ * place to the new values. Side-effect free apart from the emit
+ * calls themselves.
+ *
+ * Scene / viewport are compared by identity (scene structures use
+ * structural sharing — a new reference iff something inside
+ * changed).
+ */
+export declare const fanOutEvents: (cache: EditorEventCache, events: Emitter<EditorEvents>, snapshot: EditorObservableSnapshot) => void;
+/** Seed the cache with initial editor state — call once after construction. */
+export declare const primeEventCache: (cache: EditorEventCache, snapshot: EditorObservableSnapshot) => void;
+//# sourceMappingURL=event-fanout.d.ts.map

package/dist/editor/event-fanout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-fanout.d.ts","sourceRoot":"","sources":["../../src/editor/event-fanout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,KAAK,KAAK,SAAS,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,SAAS,EAAE,SAAS,CAAC,SAAS,GAAG,IAAI,CAAC;IACtC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,eAAO,MAAM,gBAAgB,QAAO,gBAOlC,CAAC;AAEH;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,SAAS,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,GACvB,OAAO,gBAAgB,EACvB,QAAQ,OAAO,CAAC,YAAY,CAAC,EAC7B,UAAU,wBAAwB,KACjC,IAuBF,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,eAAe,GAC1B,OAAO,gBAAgB,EACvB,UAAU,wBAAwB,KACjC,IAOF,CAAC"}

package/dist/editor/event-fanout.js

@@ -0,0 +1,53 @@
+export const createEventCache = () => ({
+    mode: null,
+    selection: null,
+    scene: null,
+    viewport: null,
+    canUndo: false,
+    canRedo: false,
+});
+/**
+ * Compare each slice against the cached last-emitted value and
+ * fire only the typed events that actually flipped — then fire
+ * the umbrella `change` once. Returns nothing; mutates `cache` in
+ * place to the new values. Side-effect free apart from the emit
+ * calls themselves.
+ *
+ * Scene / viewport are compared by identity (scene structures use
+ * structural sharing — a new reference iff something inside
+ * changed).
+ */
+export const fanOutEvents = (cache, events, snapshot) => {
+    if (snapshot.mode !== cache.mode) {
+        cache.mode = snapshot.mode;
+        events.emit("mode", snapshot.mode);
+    }
+    if (snapshot.selection !== cache.selection) {
+        cache.selection = snapshot.selection;
+        events.emit("selection", snapshot.selection);
+    }
+    if (snapshot.scene !== cache.scene) {
+        cache.scene = snapshot.scene;
+        events.emit("scene", snapshot.scene);
+    }
+    if (snapshot.scene.viewport !== cache.viewport) {
+        cache.viewport = snapshot.scene.viewport;
+        events.emit("viewport", snapshot.scene);
+    }
+    if (snapshot.canUndo !== cache.canUndo || snapshot.canRedo !== cache.canRedo) {
+        cache.canUndo = snapshot.canUndo;
+        cache.canRedo = snapshot.canRedo;
+        events.emit("history", { canUndo: snapshot.canUndo, canRedo: snapshot.canRedo });
+    }
+    events.emit("change");
+};
+/** Seed the cache with initial editor state — call once after construction. */
+export const primeEventCache = (cache, snapshot) => {
+    cache.mode = snapshot.mode;
+    cache.selection = snapshot.selection;
+    cache.scene = snapshot.scene;
+    cache.viewport = snapshot.scene.viewport;
+    cache.canUndo = snapshot.canUndo;
+    cache.canRedo = snapshot.canRedo;
+};
+//# sourceMappingURL=event-fanout.js.map

package/dist/editor/event-fanout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-fanout.js","sourceRoot":"","sources":["../../src/editor/event-fanout.ts"],"names":[],"mappings":"AAsBA,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAqB,EAAE,CAAC,CAAC;IACvD,IAAI,EAAE,IAAI;IACV,SAAS,EAAE,IAAI;IACf,KAAK,EAAE,IAAI;IACX,QAAQ,EAAE,IAAI;IACd,OAAO,EAAE,KAAK;IACd,OAAO,EAAE,KAAK;CACf,CAAC,CAAC;AAeH;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,KAAuB,EACvB,MAA6B,EAC7B,QAAkC,EAC5B,EAAE;IACR,IAAI,QAAQ,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IACD,IAAI,QAAQ,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,EAAE,CAAC;QAC3C,KAAK,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC;QACnC,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC/C,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,QAAQ,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;QAC7E,KAAK,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;QACjC,KAAK,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACnF,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACxB,CAAC,CAAC;AAEF,+EAA+E;AAC/E,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,KAAuB,EACvB,QAAkC,EAC5B,EAAE;IACR,KAAK,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC3B,KAAK,CAAC,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;IACrC,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;IAC7B,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC;IACzC,KAAK,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;IACjC,KAAK,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;AACnC,CAAC,CAAC"}

package/dist/editor/gesture-tx.d.ts

@@ -0,0 +1,77 @@
+import type { Link, Patch } from "@oh-just-another/scene";
+import type { Bounds, ElementId, LinkId, Vec2 } from "@oh-just-another/types";
+import type { HistoryProvider, TransactionHandle } from "@oh-just-another/history";
+import type { Mode } from "../modes.js";
+/**
+ * Narrow editor surface that `GestureController` needs. Editor
+ * implements this implicitly by exposing the listed fields and
+ * methods to the controller through a thin internal-only bridge
+ * object — this module never imports the full `Editor` class so
+ * it stays small and acycle-free.
+ *
+ * Fields are written by the controller (`gestureTx`;
+ * `groupMoveOrigin` etc. are cleared on every commit) and are
+ * internal — not exposed externally.
+ */
+export interface GestureRef {
+    readonly history: HistoryProvider;
+    gestureTx: TransactionHandle | null;
+    groupMoveOrigin: ReadonlyMap<ElementId, Vec2> | null;
+    groupLinkMoveOrigin: ReadonlyMap<LinkId, Link> | null;
+    groupResizeOrigin: {
+        readonly combined: Bounds;
+        readonly elements: ReadonlyMap<ElementId, {
+            readonly position: Vec2;
+            readonly bounds: Bounds;
+            readonly scale: Vec2;
+        }>;
+        readonly links: ReadonlyMap<LinkId, Link>;
+    } | null;
+    dragElementId: ElementId | null;
+    containerHover: {
+        id: ElementId;
+        dropZone: Bounds;
+    } | null;
+    readonly toolLocked: boolean;
+    readonly mode: Mode;
+    setMode(mode: Mode): void;
+    notify(): void;
+}
+/**
+ * Gesture lifecycle controller. Wraps the open-transaction model
+ * — drag / resize / multi-step operations open a `TransactionHandle`
+ * on first move, append patches as they arrive, commit on
+ * POINTER_UP. `commit` also clears the drag-target scratch fields
+ * and unconditionally fires a final notify so downstream
+ * subscribers (Undo/Redo button, mode toggle) update even when
+ * intermediate xstate re-entrancy queued events that only drained
+ * after the outer event handler returned.
+ */
+export declare class GestureController {
+    private readonly ref;
+    constructor(ref: GestureRef);
+    /**
+     * Open a gesture transaction on the first drag-emitted patch,
+     * then add subsequent patches to it. POINTER_UP commits it as
+     * one history record.
+     */
+    record(patch: Patch): void;
+    commit(): void;
+    cancel(): void;
+    /**
+     * Defensive cleanup invoked by public commands (paste, etc.)
+     * that open their own history transaction. A real gesture-in-
+     * flight gets committed (preserving user work); a stale tx that
+     * survived an earlier exception gets cancelled. Either way the
+     * next `transaction()` call lands on a clean slot, so pressing
+     * Cmd+V mid-drag doesn't throw "A transaction is already open".
+     */
+    finalize(): void;
+    /**
+     * Internal hook — called from `applyCreate` / `applyCreateLink`
+     * after a successful shape / edge instantiation. Reverts the
+     * active mode to `select` unless `toolLocked` is on.
+     */
+    maybeRevertModeAfterCreate(): void;
+}
+//# sourceMappingURL=gesture-tx.d.ts.map

package/dist/editor/gesture-tx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gesture-tx.d.ts","sourceRoot":"","sources":["../../src/editor/gesture-tx.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACnF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC;;;;;;;;;;GAUG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACpC,eAAe,EAAE,WAAW,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC;IACrD,mBAAmB,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC;IACtD,iBAAiB,EAAE;QACjB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAC5B,SAAS,EACT;YAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;YAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAA;SAAE,CAC3E,CAAC;QACF,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;KAC3C,GAAG,IAAI,CAAC;IACT,aAAa,EAAE,SAAS,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE;QAAE,EAAE,EAAE,SAAS,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC3D,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAC1B,MAAM,IAAI,IAAI,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,UAAU;IAE5C;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAK1B,MAAM,IAAI,IAAI;IA4Bd,MAAM,IAAI,IAAI;IASd;;;;;;;OAOG;IACH,QAAQ,IAAI,IAAI;IAUhB;;;;OAIG;IACH,0BAA0B,IAAI,IAAI;CAKnC"}

package/dist/editor/gesture-tx.js

@@ -0,0 +1,93 @@
+/**
+ * Gesture lifecycle controller. Wraps the open-transaction model
+ * — drag / resize / multi-step operations open a `TransactionHandle`
+ * on first move, append patches as they arrive, commit on
+ * POINTER_UP. `commit` also clears the drag-target scratch fields
+ * and unconditionally fires a final notify so downstream
+ * subscribers (Undo/Redo button, mode toggle) update even when
+ * intermediate xstate re-entrancy queued events that only drained
+ * after the outer event handler returned.
+ */
+export class GestureController {
+    ref;
+    constructor(ref) {
+        this.ref = ref;
+    }
+    /**
+     * Open a gesture transaction on the first drag-emitted patch,
+     * then add subsequent patches to it. POINTER_UP commits it as
+     * one history record.
+     */
+    record(patch) {
+        this.ref.gestureTx ??= this.ref.history.transaction();
+        this.ref.gestureTx.add(patch);
+    }
+    commit() {
+        this.ref.groupMoveOrigin = null;
+        this.ref.groupLinkMoveOrigin = null;
+        this.ref.groupResizeOrigin = null;
+        this.ref.dragElementId = null;
+        if (this.ref.containerHover !== null) {
+            this.ref.containerHover = null;
+        }
+        if (this.ref.gestureTx) {
+            this.ref.gestureTx.commit();
+            this.ref.gestureTx = null;
+        }
+        // Notify unconditionally on gesture end. Two reasons:
+        //   1. Committing the transaction (drag / resize) flips
+        //      canUndo / canRedo, so Undo/Redo toolbar buttons need a
+        //      final notify to reflect the new state.
+        //   2. CREATE_SHAPE / CREATE_EDGE path: `maybeRevertModeAfterCreate`
+        //      enqueues a `SET_MODE` event on the xstate actor while
+        //      still inside an `actor.on("*")` handler. xstate v5
+        //      drains the queue before the outer `actor.send` returns;
+        //      `commit` runs AFTER that outer send, so the `mode`
+        //      getter here already shows the freshly-applied "select".
+        //      The intermediate notify from inside `applyCreate` reads
+        //      the pre-drain mode; this final notify gives subscribers
+        //      the correct value.
+        this.ref.notify();
+    }
+    cancel() {
+        this.ref.groupMoveOrigin = null;
+        this.ref.groupLinkMoveOrigin = null;
+        this.ref.groupResizeOrigin = null;
+        if (!this.ref.gestureTx)
+            return;
+        this.ref.gestureTx.cancel();
+        this.ref.gestureTx = null;
+    }
+    /**
+     * Defensive cleanup invoked by public commands (paste, etc.)
+     * that open their own history transaction. A real gesture-in-
+     * flight gets committed (preserving user work); a stale tx that
+     * survived an earlier exception gets cancelled. Either way the
+     * next `transaction()` call lands on a clean slot, so pressing
+     * Cmd+V mid-drag doesn't throw "A transaction is already open".
+     */
+    finalize() {
+        if (!this.ref.gestureTx)
+            return;
+        try {
+            this.ref.gestureTx.commit();
+        }
+        catch {
+            this.ref.gestureTx.cancel();
+        }
+        this.ref.gestureTx = null;
+    }
+    /**
+     * Internal hook — called from `applyCreate` / `applyCreateLink`
+     * after a successful shape / edge instantiation. Reverts the
+     * active mode to `select` unless `toolLocked` is on.
+     */
+    maybeRevertModeAfterCreate() {
+        if (this.ref.toolLocked)
+            return;
+        if (this.ref.mode === "select" || this.ref.mode === "hand")
+            return;
+        this.ref.setMode("select");
+    }
+}
+//# sourceMappingURL=gesture-tx.js.map

package/dist/editor/gesture-tx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gesture-tx.js","sourceRoot":"","sources":["../../src/editor/gesture-tx.ts"],"names":[],"mappings":"AAqCA;;;;;;;;;GASG;AACH,MAAM,OAAO,iBAAiB;IACC;IAA7B,YAA6B,GAAe;QAAf,QAAG,GAAH,GAAG,CAAY;IAAG,CAAC;IAEhD;;;;OAIG;IACH,MAAM,CAAC,KAAY;QACjB,IAAI,CAAC,GAAG,CAAC,SAAS,KAAK,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QACtD,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,GAAG,CAAC,eAAe,GAAG,IAAI,CAAC;QAChC,IAAI,CAAC,GAAG,CAAC,mBAAmB,GAAG,IAAI,CAAC;QACpC,IAAI,CAAC,GAAG,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAClC,IAAI,CAAC,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC;QAC9B,IAAI,IAAI,CAAC,GAAG,CAAC,cAAc,KAAK,IAAI,EAAE,CAAC;YACrC,IAAI,CAAC,GAAG,CAAC,cAAc,GAAG,IAAI,CAAC;QACjC,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;YACvB,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YAC5B,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC;QAC5B,CAAC;QACD,sDAAsD;QACtD,wDAAwD;QACxD,8DAA8D;QAC9D,8CAA8C;QAC9C,qEAAqE;QACrE,6DAA6D;QAC7D,0DAA0D;QAC1D,+DAA+D;QAC/D,0DAA0D;QAC1D,+DAA+D;QAC/D,+DAA+D;QAC/D,+DAA+D;QAC/D,0BAA0B;QAC1B,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;IACpB,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,GAAG,CAAC,eAAe,GAAG,IAAI,CAAC;QAChC,IAAI,CAAC,GAAG,CAAC,mBAAmB,GAAG,IAAI,CAAC;QACpC,IAAI,CAAC,GAAG,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS;YAAE,OAAO;QAChC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;QAC5B,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC;IAC5B,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ;QACN,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS;YAAE,OAAO;QAChC,IAAI,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;QAC9B,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,0BAA0B;QACxB,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU;YAAE,OAAO;QAChC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO;QACnE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;CACF"}