@oh-just-another/state 0.57.0

package/dist/editor/public/brush.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brush.js","sourceRoot":"","sources":["../../../src/editor/public/brush.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,WAAW,GAKZ,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAAgB,EAAU,EAAE;IAC1D,IAAI,QAAQ,IAAI,CAAC;QAAE,OAAO,mBAAmB,CAAC;IAC9C,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,GAAG,eAAe,CAAC,CAAC;AACnD,CAAC,CAAC;AAYF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAW,EAAE,QAAgB,EAAoB,EAAE,CAAC,CAAC;IACpF,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC1D,MAAM,EAAE,KAAK;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,MAAwB,EACxB,KAAW,EACX,QAAgB,EACV,EAAE;IACR,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IACxB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;QACjB,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAChB,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAChB,KAAK,EAAE,eAAe,CAAC,QAAQ,CAAC;KACjC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,KAAY,EACZ,MAA+B,EAC/B,aAAsB,EACtB,YAAuB,EACiE,EAAE;IAC1F,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACvD,MAAM,KAAK,GAAG,WAAW,CACvB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;SACzB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,aAAa,CAAC;SAC1C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CACvB,CAAC;IACF,MAAM,KAAK,GAAY;QACrB,EAAE,EAAE,YAAY;QAChB,OAAO,EAAE,aAAa;QACtB,IAAI,EAAE,OAAO;QACb,QAAQ,EAAE,MAAM,CAAC,MAAM;QACvB,QAAQ,EAAE,CAAC;QACX,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;QACrB,KAAK;QACL,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;QACvB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE;KAC9B,CAAC;IACF,MAAM,CAAC,GAAG,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACnC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;AACrE,CAAC,CAAC;AAEF,wEAAwE;AACxE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAa,EAAE,CACpD,aAAa,CAAC,SAAS,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC"}

package/dist/editor/public/clipboard.d.ts

@@ -0,0 +1,31 @@
+import type { Scene, Element } from "@oh-just-another/scene";
+import type { HistoryProvider } from "@oh-just-another/history";
+import type { ElementId, Vec2 } from "@oh-just-another/types";
+import * as Selection from "../../selection.js";
+/**
+ * Internal clipboard storage. Editor owns the array; copy / paste
+ * delegators below read & write through it. Stored as deep-cloned
+ * snapshots so subsequent mutations don't affect the buffer. Cross-tab
+ * paste uses host-level `navigator.clipboard`.
+ */
+/** Copy: returns the shape array the editor stores as `clipboard`. */
+export declare const copySelected: (scene: Scene, selection: Selection.Selection) => readonly Element[];
+/**
+ * Paste: produce the new scene + freshly-generated shape ids for the
+ * newly-pasted cluster. Editor owns side effects (history push happens
+ * inside the pasteElements helper, then `_selection` is updated).
+ *
+ * `targetWorld` lands the cluster's centroid; caller defaults to the
+ * last tracked cursor world position, with a +10 px nudge fallback in
+ * `paste()` when even that is unavailable.
+ *
+ * `nextId` is the editor's monotonic counter; passed in so the editor
+ * stays the single source of truth for ids.
+ */
+export declare const pasteFromClipboard: (scene: Scene, history: HistoryProvider, clipboard: readonly Element[], target: Vec2 | null, nextIdSeed: () => number) => {
+    readonly scene: Scene;
+    readonly newIds: readonly ElementId[];
+};
+/** Compose the next selection from a freshly-pasted id list. */
+export declare const selectionFromPasted: (newIds: readonly ElementId[]) => Selection.Selection;
+//# sourceMappingURL=clipboard.d.ts.map

package/dist/editor/public/clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../../src/editor/public/clipboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAK7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,KAAK,SAAS,MAAM,oBAAoB,CAAC;AAEhD;;;;;GAKG;AAEH,sEAAsE;AACtE,eAAO,MAAM,YAAY,GACvB,OAAO,KAAK,EACZ,WAAW,SAAS,CAAC,SAAS,KAC7B,SAAS,OAAO,EAA0C,CAAC;AAE9D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,GAC7B,OAAO,KAAK,EACZ,SAAS,eAAe,EACxB,WAAW,SAAS,OAAO,EAAE,EAC7B,QAAQ,IAAI,GAAG,IAAI,EACnB,YAAY,MAAM,MAAM,KACvB;IACD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;CAMvC,CAAC;AAEF,gEAAgE;AAChE,eAAO,MAAM,mBAAmB,GAAI,QAAQ,SAAS,SAAS,EAAE,KAAG,SAAS,CAAC,SAI5E,CAAC"}

package/dist/editor/public/clipboard.js

@@ -0,0 +1,35 @@
+import { copyElements as copyElementsHelper, pasteElements as pasteElementsHelper, } from "../../clipboard.js";
+import { elementId as castElementId } from "@oh-just-another/types";
+import * as Selection from "../../selection.js";
+/**
+ * Internal clipboard storage. Editor owns the array; copy / paste
+ * delegators below read & write through it. Stored as deep-cloned
+ * snapshots so subsequent mutations don't affect the buffer. Cross-tab
+ * paste uses host-level `navigator.clipboard`.
+ */
+/** Copy: returns the shape array the editor stores as `clipboard`. */
+export const copySelected = (scene, selection) => copyElementsHelper(scene, selection);
+/**
+ * Paste: produce the new scene + freshly-generated shape ids for the
+ * newly-pasted cluster. Editor owns side effects (history push happens
+ * inside the pasteElements helper, then `_selection` is updated).
+ *
+ * `targetWorld` lands the cluster's centroid; caller defaults to the
+ * last tracked cursor world position, with a +10 px nudge fallback in
+ * `paste()` when even that is unavailable.
+ *
+ * `nextId` is the editor's monotonic counter; passed in so the editor
+ * stays the single source of truth for ids.
+ */
+export const pasteFromClipboard = (scene, history, clipboard, target, nextIdSeed) => {
+    const result = pasteElementsHelper(scene, history, clipboard, target, () => castElementId(`shape-${nextIdSeed()}-${Date.now().toString(36)}`));
+    return { scene: result.scene, newIds: result.newIds };
+};
+/** Compose the next selection from a freshly-pasted id list. */
+export const selectionFromPasted = (newIds) => {
+    let next = Selection.EMPTY;
+    for (const id of newIds)
+        next = Selection.add(next, id);
+    return next;
+};
+//# sourceMappingURL=clipboard.js.map

package/dist/editor/public/clipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.js","sourceRoot":"","sources":["../../../src/editor/public/clipboard.ts"],"names":[],"mappings":"AACA,OAAO,EACL,YAAY,IAAI,kBAAkB,EAClC,aAAa,IAAI,mBAAmB,GACrC,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,SAAS,MAAM,oBAAoB,CAAC;AAEhD;;;;;GAKG;AAEH,sEAAsE;AACtE,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,KAAY,EACZ,SAA8B,EACV,EAAE,CAAC,kBAAkB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AAE9D;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,KAAY,EACZ,OAAwB,EACxB,SAA6B,EAC7B,MAAmB,EACnB,UAAwB,EAIxB,EAAE;IACF,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,CACzE,aAAa,CAAC,SAAS,UAAU,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,CAClE,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;AACxD,CAAC,CAAC;AAEF,gEAAgE;AAChE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAA4B,EAAuB,EAAE;IACvF,IAAI,IAAI,GAAwB,SAAS,CAAC,KAAK,CAAC;IAChD,KAAK,MAAM,EAAE,IAAI,MAAM;QAAE,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACxD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC"}

package/dist/editor/public/image-insert.d.ts

@@ -0,0 +1,30 @@
+import { type Scene, type Element, type Patch } from "@oh-just-another/scene";
+import type { FileId, LayerId, ElementId, Vec2 } from "@oh-just-another/types";
+/**
+ * Build the image-shape object for `insertImage`. Caller threads it
+ * through `addElement` to pick up selection + history wiring.
+ */
+export declare const buildImageElement: (scene: Scene, input: {
+    src: string;
+    width: number;
+    height: number;
+    position: Vec2;
+    image?: HTMLImageElement;
+    animated?: boolean;
+    fileId?: FileId;
+    animationKind?: string;
+    animationData?: unknown;
+}, id: ElementId, layerId: LayerId) => Element;
+/**
+ * Read the blob, register it as a `BinaryFile`, and return the next
+ * scene + patch (caller pushes the patch). `nextIdSeed` is the
+ * editor's monotonic counter, bumped to produce a fresh `FileId`.
+ */
+export declare const computeAddBinaryFile: (scene: Scene, blob: Blob, name: string | undefined, nextIdSeed: () => number) => Promise<{
+    readonly scene: Scene;
+    readonly patch: Patch;
+    readonly id: FileId;
+}>;
+/** True if any shape in the scene carries `metadata.animated`. */
+export declare const hasAnimatedElement: (scene: Scene) => boolean;
+//# sourceMappingURL=image-insert.d.ts.map

package/dist/editor/public/image-insert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-insert.d.ts","sourceRoot":"","sources":["../../../src/editor/public/image-insert.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,KAAK,EACV,KAAK,OAAO,EACZ,KAAK,KAAK,EAEX,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAG/E;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,OAAO,KAAK,EACZ,OAAO;IACL,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,IAAI,CAAC;IACf,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,EACD,IAAI,SAAS,EACb,SAAS,OAAO,KACf,OA0BF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,KAAK,EACZ,MAAM,IAAI,EACV,MAAM,MAAM,GAAG,SAAS,EACxB,YAAY,MAAM,MAAM,KACvB,OAAO,CAAC;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAS/E,CAAC;AAEF,kEAAkE;AAClE,eAAO,MAAM,kBAAkB,GAAI,OAAO,KAAK,KAAG,OAKjD,CAAC"}

package/dist/editor/public/image-insert.js

@@ -0,0 +1,57 @@
+import { apply, createBinaryFile, orderForTop, } from "@oh-just-another/scene";
+import { fileId as castFileId } from "@oh-just-another/types";
+/**
+ * Build the image-shape object for `insertImage`. Caller threads it
+ * through `addElement` to pick up selection + history wiring.
+ */
+export const buildImageElement = (scene, input, id, layerId) => {
+    const order = orderForTop(Array.from(scene.elements.values())
+        .filter((s) => s.layerId === layerId)
+        .map((s) => s.order));
+    const metadata = {};
+    if (input.image)
+        metadata.image = input.image;
+    if (input.animated)
+        metadata.animated = true;
+    return {
+        id,
+        layerId,
+        type: "image",
+        position: input.position,
+        rotation: 0,
+        scale: { x: 1, y: 1 },
+        order,
+        style: {},
+        width: input.width,
+        height: input.height,
+        src: input.src,
+        ...(input.fileId ? { fileId: input.fileId } : {}),
+        ...(input.animationKind ? { animationKind: input.animationKind } : {}),
+        ...(input.animationData !== undefined ? { animationData: input.animationData } : {}),
+        ...(Object.keys(metadata).length > 0 ? { metadata } : {}),
+    };
+};
+/**
+ * Read the blob, register it as a `BinaryFile`, and return the next
+ * scene + patch (caller pushes the patch). `nextIdSeed` is the
+ * editor's monotonic counter, bumped to produce a fresh `FileId`.
+ */
+export const computeAddBinaryFile = async (scene, blob, name, nextIdSeed) => {
+    const data = await blob.arrayBuffer();
+    const id = castFileId(`file-${nextIdSeed()}-${Date.now().toString(36)}`);
+    const file = createBinaryFile(id, data, {
+        mime: blob.type || "application/octet-stream",
+        ...(name !== undefined ? { name } : {}),
+    });
+    const patch = { kind: "file", id, before: null, after: file };
+    return { scene: apply(scene, patch), patch, id };
+};
+/** True if any shape in the scene carries `metadata.animated`. */
+export const hasAnimatedElement = (scene) => {
+    for (const s of scene.elements.values()) {
+        if (s.metadata?.animated === true)
+            return true;
+    }
+    return false;
+};
+//# sourceMappingURL=image-insert.js.map

package/dist/editor/public/image-insert.js.map

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

package/dist/editor/public/layers.d.ts

@@ -0,0 +1,56 @@
+import { type Scene, type Patch } from "@oh-just-another/scene";
+import type { LayerId } from "@oh-just-another/types";
+import type * as Selection from "../../selection.js";
+/**
+ * Build a fresh top-of-stack layer + the patch that adds it. Caller
+ * assigns activeLayerId and pushes the patch.
+ */
+export declare const computeCreateLayer: (scene: Scene, name: string, newLayerId: LayerId) => {
+    readonly scene: Scene;
+    readonly patch: Patch;
+    readonly layerId: LayerId;
+};
+/**
+ * Drop a layer + every shape and edge that lived on it. Returns the
+ * next scene, all patches, the next active layer id (topmost remaining
+ * if the dropped one was active), and a flag for whether the selection
+ * should be cleared.
+ *
+ * Returns `null` when the layer doesn't exist. Throws when asked to
+ * remove the only layer; callers should guard against that beforehand.
+ */
+export declare const computeRemoveLayer: (scene: Scene, id: LayerId, currentActive: LayerId) => {
+    scene: Scene;
+    patches: Patch[];
+    nextActiveLayerId: LayerId;
+} | null;
+/** Rename a layer. Returns `null` when nothing actually changes. */
+export declare const computeRenameLayer: (scene: Scene, id: LayerId, name: string) => {
+    readonly scene: Scene;
+    readonly patch: Patch;
+} | null;
+/** Flip the `visible` flag. */
+export declare const computeToggleLayerVisibility: (scene: Scene, id: LayerId) => {
+    readonly scene: Scene;
+    readonly patch: Patch;
+} | null;
+/** Flip the `locked` flag. */
+export declare const computeToggleLayerLock: (scene: Scene, id: LayerId) => {
+    readonly scene: Scene;
+    readonly patch: Patch;
+} | null;
+/**
+ * Move every shape in the selection to `targetLayer`. Links are left
+ * alone — they stay on whichever layer they were already on;
+ * cross-layer edges are valid.
+ *
+ * Returns `null` when the layer doesn't exist, the selection is empty,
+ * or all selected shapes are already on the target layer.
+ */
+export declare const computeMoveSelectionToLayer: (scene: Scene, selection: Selection.Selection, targetLayer: LayerId) => {
+    readonly scene: Scene;
+    readonly patches: Patch[];
+} | null;
+/** Generate a fresh layer id with the editor's nextId counter. */
+export declare const newLayerId: (next: number) => LayerId;
+//# sourceMappingURL=layers.d.ts.map

package/dist/editor/public/layers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layers.d.ts","sourceRoot":"","sources":["../../../src/editor/public/layers.ts"],"names":[],"mappings":"AAAA,OAAO,EAUL,KAAK,KAAK,EACV,KAAK,KAAK,EACX,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,KAAK,KAAK,SAAS,MAAM,oBAAoB,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC7B,OAAO,KAAK,EACZ,MAAM,MAAM,EACZ,YAAY,OAAO,KAClB;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAK3E,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,GAC7B,OAAO,KAAK,EACZ,IAAI,OAAO,EACX,eAAe,OAAO,KACrB;IACD,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,KAAK,EAAE,CAAC;IACjB,iBAAiB,EAAE,OAAO,CAAC;CAC5B,GAAG,IA+BH,CAAC;AAEF,oEAAoE;AACpE,eAAO,MAAM,kBAAkB,GAC7B,OAAO,KAAK,EACZ,IAAI,OAAO,EACX,MAAM,MAAM,KACX;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GAAG,IAKrD,CAAC;AAEF,+BAA+B;AAC/B,eAAO,MAAM,4BAA4B,GACvC,OAAO,KAAK,EACZ,IAAI,OAAO,KACV;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GAAG,IAIrD,CAAC;AAEF,8BAA8B;AAC9B,eAAO,MAAM,sBAAsB,GACjC,OAAO,KAAK,EACZ,IAAI,OAAO,KACV;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GAAG,IAIrD,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,GACtC,OAAO,KAAK,EACZ,WAAW,SAAS,CAAC,SAAS,EAC9B,aAAa,OAAO,KACnB;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,EAAE,CAAA;CAAE,GAAG,IAazD,CAAC;AAEF,kEAAkE;AAClE,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,KAAG,OACe,CAAC"}

package/dist/editor/public/layers.js

@@ -0,0 +1,104 @@
+import { addLayer, getElement, orderForTop, removeLink, removeLayer, removeElement, updateLayer, updateElement, } from "@oh-just-another/scene";
+import { layerId as castLayerId } from "@oh-just-another/types";
+/**
+ * Build a fresh top-of-stack layer + the patch that adds it. Caller
+ * assigns activeLayerId and pushes the patch.
+ */
+export const computeCreateLayer = (scene, name, newLayerId) => {
+    const topOrder = orderForTop([...scene.layers.values()].map((l) => l.order));
+    const layer = { id: newLayerId, name, visible: true, locked: false, order: topOrder };
+    const result = addLayer(scene, layer);
+    return { scene: result.scene, patch: result.patch, layerId: newLayerId };
+};
+/**
+ * Drop a layer + every shape and edge that lived on it. Returns the
+ * next scene, all patches, the next active layer id (topmost remaining
+ * if the dropped one was active), and a flag for whether the selection
+ * should be cleared.
+ *
+ * Returns `null` when the layer doesn't exist. Throws when asked to
+ * remove the only layer; callers should guard against that beforehand.
+ */
+export const computeRemoveLayer = (scene, id, currentActive) => {
+    if (!scene.layers.has(id))
+        return null;
+    if (scene.layers.size <= 1) {
+        throw new Error("Cannot remove the only remaining layer.");
+    }
+    const patches = [];
+    let s = scene;
+    for (const shape of [...s.elements.values()]) {
+        if (shape.layerId !== id)
+            continue;
+        const r = removeElement(s, shape.id);
+        s = r.scene;
+        patches.push(r.patch);
+    }
+    for (const edge of [...s.links.values()]) {
+        if (edge.layerId !== id)
+            continue;
+        const r = removeLink(s, edge.id);
+        s = r.scene;
+        patches.push(r.patch);
+    }
+    const r = removeLayer(s, id);
+    s = r.scene;
+    patches.push(r.patch);
+    let nextActive = currentActive;
+    if (currentActive === id) {
+        const top = [...s.layers.values()].sort((a, b) => a.order > b.order ? -1 : a.order < b.order ? 1 : 0)[0];
+        if (top)
+            nextActive = top.id;
+    }
+    return { scene: s, patches, nextActiveLayerId: nextActive };
+};
+/** Rename a layer. Returns `null` when nothing actually changes. */
+export const computeRenameLayer = (scene, id, name) => {
+    const layer = scene.layers.get(id);
+    if (!layer || layer.name === name)
+        return null;
+    const r = updateLayer(scene, id, (l) => ({ ...l, name }));
+    return { scene: r.scene, patch: r.patch };
+};
+/** Flip the `visible` flag. */
+export const computeToggleLayerVisibility = (scene, id) => {
+    if (!scene.layers.has(id))
+        return null;
+    const r = updateLayer(scene, id, (l) => ({ ...l, visible: !l.visible }));
+    return { scene: r.scene, patch: r.patch };
+};
+/** Flip the `locked` flag. */
+export const computeToggleLayerLock = (scene, id) => {
+    if (!scene.layers.has(id))
+        return null;
+    const r = updateLayer(scene, id, (l) => ({ ...l, locked: !l.locked }));
+    return { scene: r.scene, patch: r.patch };
+};
+/**
+ * Move every shape in the selection to `targetLayer`. Links are left
+ * alone — they stay on whichever layer they were already on;
+ * cross-layer edges are valid.
+ *
+ * Returns `null` when the layer doesn't exist, the selection is empty,
+ * or all selected shapes are already on the target layer.
+ */
+export const computeMoveSelectionToLayer = (scene, selection, targetLayer) => {
+    if (!scene.layers.has(targetLayer) || selection.size === 0)
+        return null;
+    let s = scene;
+    const patches = [];
+    for (const id of selection) {
+        const shape = getElement(s, id);
+        if (!shape || shape.layerId === targetLayer)
+            continue;
+        const r = updateElement(s, id, (sh) => ({ ...sh, layerId: targetLayer }));
+        s = r.scene;
+        patches.push(r.patch);
+    }
+    if (patches.length === 0)
+        return null;
+    return { scene: s, patches };
+};
+/** Generate a fresh layer id with the editor's nextId counter. */
+export const newLayerId = (next) => castLayerId(`layer-${next}-${Date.now().toString(36)}`);
+//# sourceMappingURL=layers.js.map

package/dist/editor/public/layers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layers.js","sourceRoot":"","sources":["../../../src/editor/public/layers.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,aAAa,EACb,WAAW,EACX,aAAa,GAId,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGhE;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,KAAY,EACZ,IAAY,EACZ,UAAmB,EAC0D,EAAE;IAC/E,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7E,MAAM,KAAK,GAAU,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAC7F,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACtC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AAC3E,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,KAAY,EACZ,EAAW,EACX,aAAsB,EAKf,EAAE;IACT,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IACD,MAAM,OAAO,GAAY,EAAE,CAAC;IAC5B,IAAI,CAAC,GAAG,KAAK,CAAC;IACd,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;QAC7C,IAAI,KAAK,CAAC,OAAO,KAAK,EAAE;YAAE,SAAS;QACnC,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;QACrC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;QACzC,IAAI,IAAI,CAAC,OAAO,KAAK,EAAE;YAAE,SAAS;QAClC,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QACjC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IACD,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7B,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;IACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAEtB,IAAI,UAAU,GAAG,aAAa,CAAC;IAC/B,IAAI,aAAa,KAAK,EAAE,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAC/C,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CACnD,CAAC,CAAC,CAAC,CAAC;QACL,IAAI,GAAG;YAAE,UAAU,GAAG,GAAG,CAAC,EAAE,CAAC;IAC/B,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,CAAC;AAC9D,CAAC,CAAC;AAEF,oEAAoE;AACpE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,KAAY,EACZ,EAAW,EACX,IAAY,EAC6C,EAAE;IAC3D,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/C,MAAM,CAAC,GAAG,WAAW,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1D,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;AAC5C,CAAC,CAAC;AAEF,+BAA+B;AAC/B,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAC1C,KAAY,EACZ,EAAW,EAC8C,EAAE;IAC3D,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,MAAM,CAAC,GAAG,WAAW,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACzE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;AAC5C,CAAC,CAAC;AAEF,8BAA8B;AAC9B,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,KAAY,EACZ,EAAW,EAC8C,EAAE;IAC3D,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,MAAM,CAAC,GAAG,WAAW,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACvE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;AAC5C,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CACzC,KAAY,EACZ,SAA8B,EAC9B,WAAoB,EACyC,EAAE;IAC/D,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACxE,IAAI,CAAC,GAAG,KAAK,CAAC;IACd,MAAM,OAAO,GAAY,EAAE,CAAC;IAC5B,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,KAAK,WAAW;YAAE,SAAS;QACtD,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;QAC1E,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC,CAAC;AAEF,kEAAkE;AAClE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAW,EAAE,CAClD,WAAW,CAAC,SAAS,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC"}

package/dist/editor/public/link.d.ts

@@ -0,0 +1,25 @@
+import { type Scene, type Patch } from "@oh-just-another/scene";
+import type { ElementId } from "@oh-just-another/types";
+/**
+ * Normalise user-entered link text into a safe, storable href, or
+ * `null` to clear / reject. Adds `https://` to a scheme-less URL,
+ * `mailto:` to a bare email, and refuses unsafe schemes.
+ */
+export declare const normalizeHref: (input: string) => string | null;
+/**
+ * Final gate before navigation. Returns the href only if it's a safe
+ * scheme; otherwise `null`. Defensive even though `normalizeHref`
+ * already filtered — stored scenes from other sources may carry
+ * anything.
+ */
+export declare const safeHref: (href: string | undefined | null) => string | null;
+/**
+ * Set (or clear, with `null`) the `href` on every shape in `ids`.
+ * Returns the next scene + a single / batched patch, or `null` when no
+ * shape applied or nothing changed.
+ */
+export declare const computeSetLink: (scene: Scene, ids: Iterable<ElementId>, href: string | null) => {
+    readonly scene: Scene;
+    readonly patch: Patch;
+} | null;
+//# sourceMappingURL=link.d.ts.map

package/dist/editor/public/link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../../src/editor/public/link.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,KAAK,EAAE,KAAK,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC3F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAUxD;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,KAAG,MAAM,GAAG,IAQtD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,GAAG,SAAS,GAAG,IAAI,KAAG,MAAM,GAAG,IAGnE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,KAAK,EACZ,KAAK,QAAQ,CAAC,SAAS,CAAC,EACxB,MAAM,MAAM,GAAG,IAAI,KAClB;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GAAG,IA2BrD,CAAC"}

package/dist/editor/public/link.js

@@ -0,0 +1,74 @@
+import { getElement, updateElement } from "@oh-just-another/scene";
+/**
+ * Schemes allowed to be stored / opened. Everything else (notably
+ * `javascript:`, `data:`, `vbscript:`, `file:`) is rejected so a scene
+ * can't smuggle an XSS / local-file payload through an element link.
+ */
+const SAFE_SCHEME = /^(https?:|mailto:)/i;
+const BARE_EMAIL = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+/**
+ * Normalise user-entered link text into a safe, storable href, or
+ * `null` to clear / reject. Adds `https://` to a scheme-less URL,
+ * `mailto:` to a bare email, and refuses unsafe schemes.
+ */
+export const normalizeHref = (input) => {
+    const s = input.trim();
+    if (s === "")
+        return null;
+    if (SAFE_SCHEME.test(s))
+        return s;
+    // Has a scheme but not a safe one (javascript:, data:, …) → reject.
+    if (/^[a-z][a-z0-9+.-]*:/i.test(s))
+        return null;
+    if (BARE_EMAIL.test(s))
+        return `mailto:${s}`;
+    return `https://${s}`;
+};
+/**
+ * Final gate before navigation. Returns the href only if it's a safe
+ * scheme; otherwise `null`. Defensive even though `normalizeHref`
+ * already filtered — stored scenes from other sources may carry
+ * anything.
+ */
+export const safeHref = (href) => {
+    if (!href)
+        return null;
+    return SAFE_SCHEME.test(href.trim()) ? href.trim() : null;
+};
+/**
+ * Set (or clear, with `null`) the `href` on every shape in `ids`.
+ * Returns the next scene + a single / batched patch, or `null` when no
+ * shape applied or nothing changed.
+ */
+export const computeSetLink = (scene, ids, href) => {
+    const targetIds = [];
+    for (const id of ids) {
+        const s = getElement(scene, id);
+        if (s && (s.href ?? null) !== href)
+            targetIds.push(id);
+    }
+    if (targetIds.length === 0)
+        return null;
+    let s = scene;
+    const patches = [];
+    for (const id of targetIds) {
+        const r = updateElement(s, id, (sh) => {
+            const next = { ...sh };
+            if (href === null)
+                delete next.href;
+            else
+                next.href = href;
+            return next;
+        });
+        s = r.scene;
+        patches.push(r.patch);
+    }
+    const firstPatch = patches[0];
+    return {
+        scene: s,
+        patch: patches.length === 1 && firstPatch !== undefined
+            ? firstPatch
+            : { kind: "batch", patches },
+    };
+};
+//# sourceMappingURL=link.js.map

package/dist/editor/public/link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.js","sourceRoot":"","sources":["../../../src/editor/public/link.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,aAAa,EAA0B,MAAM,wBAAwB,CAAC;AAG3F;;;;GAIG;AACH,MAAM,WAAW,GAAG,qBAAqB,CAAC;AAC1C,MAAM,UAAU,GAAG,4BAA4B,CAAC;AAEhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAa,EAAiB,EAAE;IAC5D,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACvB,IAAI,CAAC,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC1B,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IAClC,oEAAoE;IACpE,IAAI,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAChD,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,UAAU,CAAC,EAAE,CAAC;IAC7C,OAAO,WAAW,CAAC,EAAE,CAAC;AACxB,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAA+B,EAAiB,EAAE;IACzE,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5D,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,KAAY,EACZ,GAAwB,EACxB,IAAmB,EACsC,EAAE;IAC3D,MAAM,SAAS,GAAgB,EAAE,CAAC;IAClC,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI;YAAE,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,IAAI,CAAC,GAAG,KAAK,CAAC;IACd,MAAM,OAAO,GAAY,EAAE,CAAC;IAC5B,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE;YACpC,MAAM,IAAI,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC;YACvB,IAAI,IAAI,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAC,IAAI,CAAC;;gBAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;QACH,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IACD,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9B,OAAO;QACL,KAAK,EAAE,CAAC;QACR,KAAK,EACH,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,KAAK,SAAS;YAC9C,CAAC,CAAC,UAAU;YACZ,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE;KACjC,CAAC;AACJ,CAAC,CAAC"}

package/dist/editor/public/placement.d.ts

@@ -0,0 +1,60 @@
+import { type Scene, type Element, type Patch } from "@oh-just-another/scene";
+import type { LayerId, ElementId, Vec2 } from "@oh-just-another/types";
+import type { Mode } from "../../modes.js";
+/**
+ * Build a shape for keyboard-friendly creation centred on
+ * `worldCenter`. Picks `rectangle` / `ellipse` based on `mode` (falls
+ * back to rectangle for non-draw modes), with a 120×80 default size.
+ */
+export declare const buildElementAtCursor: (scene: Scene, mode: Mode, worldCenter: Vec2, layerId: LayerId, id: ElementId) => Element;
+/**
+ * Build an empty text shape anchored at `worldPoint` (top-left). The
+ * `draw-text` tool drops this and opens the inline editor straight
+ * away, so the shape starts with no text — the renderer skips empty
+ * strings, and an untouched shape is cleaned up on commit.
+ */
+export declare const buildTextElementAt: (scene: Scene, worldPoint: Vec2, layerId: LayerId, id: ElementId) => Element;
+/** Generate a fresh shape id with the editor's nextId counter. */
+export declare const newElementIdAtCursor: (next: number) => ElementId;
+/**
+ * Mutable state for an in-progress palette / drag-to-place gesture.
+ * Owned by the `beginPlacement` closure.
+ */
+export interface PlacementState {
+    current: Element;
+    readonly halfWidth: number;
+    readonly halfHeight: number;
+}
+/** Compute the patch that moves the placed shape to `worldCenter`. */
+export declare const computePlacementUpdate: (scene: Scene, state: PlacementState, worldCenter: Vec2) => {
+    readonly scene: Scene;
+    readonly patch: Patch;
+    readonly next: Element;
+};
+/**
+ * Post-process the placed shape on commit — if it lands inside an
+ * auto-layout container's drop zone, reparent it. The caller passes a
+ * callback that excludes the placed shape itself from the container
+ * hit-test (otherwise a container template could parent itself).
+ *
+ * Returns the reparented shape + the corresponding patch, or `null`
+ * when no container hit applies.
+ */
+export declare const computePlacementContainerDrop: (scene: Scene, state: PlacementState) => {
+    readonly scene: Scene;
+    readonly patch: Patch;
+    readonly next: Element;
+} | null;
+/** Build the initial placement state for `beginPlacement`. */
+export declare const beginPlacementState: (shape: Element) => {
+    readonly scene: (s: Scene) => {
+        readonly scene: Scene;
+        readonly patch: Patch;
+    };
+    readonly state: PlacementState;
+};
+/** Undo of `beginPlacement` — remove the placed shape. */
+export declare const computePlacementCancel: (scene: Scene, elementId: ElementId) => {
+    readonly scene: Scene;
+};
+//# sourceMappingURL=placement.d.ts.map

package/dist/editor/public/placement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placement.d.ts","sourceRoot":"","sources":["../../../src/editor/public/placement.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,KAAK,EACV,KAAK,OAAO,EACZ,KAAK,KAAK,EACX,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAEvE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAO3C;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,KAAK,EACZ,MAAM,IAAI,EACV,aAAa,IAAI,EACjB,SAAS,OAAO,EAChB,IAAI,SAAS,KACZ,OAmBF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAC7B,OAAO,KAAK,EACZ,YAAY,IAAI,EAChB,SAAS,OAAO,EAChB,IAAI,SAAS,KACZ,OAiBF,CAAC;AAEF,kEAAkE;AAClE,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,KAAG,SACO,CAAC;AAE5D;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,sEAAsE;AACtE,eAAO,MAAM,sBAAsB,GACjC,OAAO,KAAK,EACZ,OAAO,cAAc,EACrB,aAAa,IAAI,KAChB;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAexE,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,6BAA6B,GACxC,OAAO,KAAK,EACZ,OAAO,cAAc,KACpB;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG,IAe7E,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,mBAAmB,GAAI,OAAO,OAAO,KAAG;IACnD,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,KAAK,KAAK;QAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC;IAC/E,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;CAchC,CAAC;AAEF,0DAA0D;AAC1D,eAAO,MAAM,sBAAsB,GACjC,OAAO,KAAK,EACZ,WAAW,SAAS,KACnB;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;CAAwD,CAAC"}

package/dist/editor/public/placement.js

@@ -0,0 +1,111 @@
+import { addElement, apply, findContainerAt, getElementWorldBounds, orderForTop, removeElement, } from "@oh-just-another/scene";
+import { elementId as castElementId } from "@oh-just-another/types";
+import { TEXT_DEFAULT_FILL, TEXT_DEFAULT_FONT_FAMILY, TEXT_DEFAULT_FONT_SIZE, } from "../../constants.js";
+/**
+ * Build a shape for keyboard-friendly creation centred on
+ * `worldCenter`. Picks `rectangle` / `ellipse` based on `mode` (falls
+ * back to rectangle for non-draw modes), with a 120×80 default size.
+ */
+export const buildElementAtCursor = (scene, mode, worldCenter, layerId, id) => {
+    const order = orderForTop([...scene.elements.values()].filter((s) => s.layerId === layerId).map((s) => s.order));
+    const type = mode === "draw-ellipse" ? "ellipse" : "rectangle";
+    const width = 120;
+    const height = 80;
+    return {
+        id,
+        layerId,
+        type,
+        position: { x: worldCenter.x - width / 2, y: worldCenter.y - height / 2 },
+        rotation: 0,
+        scale: { x: 1, y: 1 },
+        order,
+        style: { fill: "#bbb", stroke: "#000", strokeWidth: 1 },
+        width,
+        height,
+    };
+};
+/**
+ * Build an empty text shape anchored at `worldPoint` (top-left). The
+ * `draw-text` tool drops this and opens the inline editor straight
+ * away, so the shape starts with no text — the renderer skips empty
+ * strings, and an untouched shape is cleaned up on commit.
+ */
+export const buildTextElementAt = (scene, worldPoint, layerId, id) => {
+    const order = orderForTop([...scene.elements.values()].filter((s) => s.layerId === layerId).map((s) => s.order));
+    return {
+        id,
+        layerId,
+        type: "text",
+        position: { x: worldPoint.x, y: worldPoint.y },
+        rotation: 0,
+        scale: { x: 1, y: 1 },
+        order,
+        text: "",
+        fontFamily: TEXT_DEFAULT_FONT_FAMILY,
+        fontSize: TEXT_DEFAULT_FONT_SIZE,
+        style: { fill: TEXT_DEFAULT_FILL, textAlign: "left", textBaseline: "top" },
+    };
+};
+/** Generate a fresh shape id with the editor's nextId counter. */
+export const newElementIdAtCursor = (next) => castElementId(`shape-${next}-${Date.now().toString(36)}`);
+/** Compute the patch that moves the placed shape to `worldCenter`. */
+export const computePlacementUpdate = (scene, state, worldCenter) => {
+    const next = {
+        ...state.current,
+        position: {
+            x: worldCenter.x - state.halfWidth,
+            y: worldCenter.y - state.halfHeight,
+        },
+    };
+    const patch = {
+        kind: "element",
+        id: state.current.id,
+        before: state.current,
+        after: next,
+    };
+    return { scene: apply(scene, patch), patch, next };
+};
+/**
+ * Post-process the placed shape on commit — if it lands inside an
+ * auto-layout container's drop zone, reparent it. The caller passes a
+ * callback that excludes the placed shape itself from the container
+ * hit-test (otherwise a container template could parent itself).
+ *
+ * Returns the reparented shape + the corresponding patch, or `null`
+ * when no container hit applies.
+ */
+export const computePlacementContainerDrop = (scene, state) => {
+    const center = {
+        x: state.current.position.x + state.halfWidth,
+        y: state.current.position.y + state.halfHeight,
+    };
+    const container = findContainerAt(scene, center, new Set([state.current.id]));
+    if (!container)
+        return null;
+    const withParent = { ...state.current, parentId: container.id };
+    const patch = {
+        kind: "element",
+        id: state.current.id,
+        before: state.current,
+        after: withParent,
+    };
+    return { scene: apply(scene, patch), patch, next: withParent };
+};
+/** Build the initial placement state for `beginPlacement`. */
+export const beginPlacementState = (shape) => {
+    const half = getElementWorldBounds(shape);
+    return {
+        scene: (s) => {
+            const r = addElement(s, shape);
+            return { scene: r.scene, patch: r.patch };
+        },
+        state: {
+            current: shape,
+            halfWidth: half.width / 2,
+            halfHeight: half.height / 2,
+        },
+    };
+};
+/** Undo of `beginPlacement` — remove the placed shape. */
+export const computePlacementCancel = (scene, elementId) => ({ scene: removeElement(scene, elementId).scene });
+//# sourceMappingURL=placement.js.map