@grida/svg-editor 1.0.0-alpha.16 → 1.0.0-alpha.18

package/README.md

@@ -642,6 +642,39 @@ editor.commands.{
                                       // groups with visual state — see TODO §10)
   remove(): void;
 
+  // clipboard — the payload is a STANDALONE SVG DOCUMENT, not a private
+  // format (the file is the IR, so the clipboard is the file format).
+  // Copy carries the outbound url(#…)/href reference closure in one
+  // <defs> block and declares borrowed xmlns prefixes on the payload
+  // shell; ancestor transforms / inherited presentation / viewport are
+  // deliberately NOT carried (verbatim policy). Cut = copy + remove as
+  // ONE history step labeled "cut"; undo restores the document and the
+  // clipboard keeps the payload (cut → undo → paste = move). Paste is
+  // synchronous over delivered text (`text ?? internal buffer`) and has
+  // a gesture-grade refusal table: non-parseable environment input is a
+  // no-op `[]`, never a throw (insert_fragment keeps strict semantics).
+  // System-clipboard wiring is the DOM surface's native ClipboardEvent
+  // transport (text/plain = the markup itself) plus the optional
+  // ClipboardProvider seam. Full contract:
+  // https://grida.co/docs/wg/feat-svg-editor/clipboard
+  copy(): string | null;              // payload | null on empty selection; no history
+  cut(): string | null;               // one undoable step; buffer secured before delete
+  paste(text?: string): NodeId[];     // inserted roots (selected); [] = refusal
+
+  // duplicate — the clipboard FRD's SECOND extraction operation
+  // (subtree clone): in-document, so NO defs closure and NO xmlns
+  // shell are carried; subtrees and authored ids clone verbatim
+  // (colliding ids resolve first-in-document-order; Tidy dedups).
+  // Each clone lands as its origin's next sibling (paints above it);
+  // selection moves to the clones; ONE history step. Alt-drag
+  // translate-with-clone consumes the same operation. Repeating
+  // offset: duplicate → move the copy → duplicate repeats the
+  // translate delta (an Alt-drag clone commit arms the same memory);
+  // still one undo step, degrades to in-place when the preconditions
+  // don't hold. Contract:
+  // https://grida.co/docs/wg/feat-svg-editor/subtree-clone
+  duplicate(): NodeId[];              // clone ids (selected); [] = refusal
+
   // insertion — `tag` is an open string (so paste / RPC can create any element,
   // e.g. "path"); only the closed `InsertableTag` set gets a pointer-driven
   // draw gesture and default paint.

package/dist/{dom-BO2-E9oK.d.ts → dom-BMzX1CXZ.d.ts}

@@ -1,4 +1,4 @@
-import { c as SvgEditor, p as Gestures, s as SurfaceHandle, w as Camera } from "./editor-CYoGJ3Hf.js";
+import { c as SvgEditor, p as Gestures, s as SurfaceHandle, w as Camera } from "./editor-BSxTUsW_.js";
 import cmath from "@grida/cmath";
 //#region src/core/snap/options.d.ts
 type SnapOptions = {
@@ -48,6 +48,18 @@ type DomSurfaceOptions = {
    * carte via `handle.gestures.bind(...)`.
    */
   gestures?: boolean;
+  /**
+   * Wire native ClipboardEvent transport — `copy` / `cut` / `paste`
+   * listeners on the owner document, gated by the clipboard attention
+   * discipline. Default `true`. Pass `false` to route ALL clipboard
+   * traffic through the `ClipboardProvider` seam instead (the
+   * configuration under which a host's paste-time screening governs
+   * every path) — see docs/wg/feat-svg-editor/clipboard.md §Transport
+   * "Host control over the native path". Focus management (the container
+   * focusing on pointerdown) stays either way — it is a general canvas
+   * mitigation, not a clipboard feature.
+   */
+  clipboard?: boolean;
   /**
    * Auto-fit the document into the viewport on initial attach. Default
    * `false`. Mirrors Excalidraw's `initialData.scrollToContent`.

package/dist/{dom-U6ae5fQF.js → dom-DKQ4Vt3z.js}

@@ -1,4 +1,4 @@
-const require_model = require("./model-D0nU_EkL.js");
+const require_model = require("./model-BLhMJZKJ.js");
 let _grida_cmath = require("@grida/cmath");
 _grida_cmath = require_model.__toESM(_grida_cmath);
 let _grida_svg_parse = require("@grida/svg/parse");
@@ -1007,15 +1007,18 @@ function create_attention_tracker(container) {
 	};
 	container.addEventListener("pointerenter", on_enter);
 	container.addEventListener("pointerleave", on_leave);
-	const is_attended = () => {
+	const is_focus_within = () => {
 		const owner = container.ownerDocument;
-		if (!owner) return pointer_over;
+		if (!owner) return false;
 		const active = owner.activeElement;
-		if (active && active !== owner.body && container.contains(active)) return true;
-		return pointer_over;
+		return !!active && active !== owner.body && container.contains(active);
+	};
+	const is_attended = () => {
+		return is_focus_within() || pointer_over;
 	};
 	return {
 		is_attended,
+		is_focus_within,
 		dispose: () => {
 			container.removeEventListener("pointerenter", on_enter);
 			container.removeEventListener("pointerleave", on_leave);
@@ -1707,6 +1710,7 @@ var DomSurface = class DomSurface {
 		this.svg_root = null;
 		this.teardown = [];
 		this.element_index = /* @__PURE__ */ new Map();
+		this.rendered_doc_revision = -1;
 		this.last_pointer = {
 			x: 0,
 			y: 0
@@ -1731,6 +1735,7 @@ var DomSurface = class DomSurface {
 		this.container = options.container;
 		const container = this.container;
 		this.fit_on_attach = options.fit === true;
+		this.clipboard_enabled = options.clipboard !== false;
 		this.attention = create_attention_tracker(container);
 		this.teardown.push(() => this.attention.dispose());
 		if (process.env.NODE_ENV !== "production" && container.children.length > 0) console.warn("@grida/svg-editor: surface container is not empty at attach time. Render chrome (toolbars, layer lists, inspectors) as siblings of the container, not children — otherwise clicks on those children will silently break. See README §Surface.");
@@ -1738,6 +1743,8 @@ var DomSurface = class DomSurface {
 		container.style.overflow = "hidden";
 		container.style.userSelect = "none";
 		container.style.webkitUserSelect = "none";
+		container.tabIndex = -1;
+		container.style.outline = "none";
 		const translate_options = () => {
 			const style = this.editor.style;
 			const zoom = this.camera.zoom || 1;
@@ -1753,7 +1760,9 @@ var DomSurface = class DomSurface {
 			open_preview: (label) => this.editor_internal().history.preview(label),
 			open_snap: (ids) => this.open_snap_session_for(ids),
 			options: translate_options,
-			project_delta: (id, d) => this._geometry_provider?.world_delta_to_local(id, d) ?? d
+			project_delta: (id, d) => this._geometry_provider?.world_delta_to_local(id, d) ?? d,
+			set_selection: (ids) => this.editor.commands.select(ids),
+			on_clone_commit: (record) => this.editor_internal().seed_duplication(record)
 		});
 		const resize_options = () => {
 			const style = this.editor.style;
@@ -1881,7 +1890,7 @@ var DomSurface = class DomSurface {
 			this.current_tool = editor.state.tool;
 			this.hud.setVectorSelectionMode(this.current_tool.type === "lasso" ? "lasso" : "marquee");
 			this.hud.setVectorBendMode(this.current_tool.type === "bend" ? "always" : "auto");
-			this.render();
+			this.flush_dom();
 			this.sync_surface_selection();
 			this.hud.setPixelGrid({
 				enabled: editor.style.pixel_grid,
@@ -1937,12 +1946,14 @@ var DomSurface = class DomSurface {
 		this.teardown.push(() => internal.set_content_edit_driver(null));
 		internal.set_computed_resolver({
 			computed_property: (id, name) => {
+				this.flush_dom();
 				const el = this.element_index.get(id);
 				if (!el) return null;
 				const value = getComputedStyle(el).getPropertyValue(name);
 				return value === "" ? null : value;
 			},
 			computed_paint: (id, channel) => {
+				this.flush_dom();
 				const el = this.element_index.get(id);
 				if (!el) return null;
 				const computed = getComputedStyle(el).getPropertyValue(channel);
@@ -1959,7 +1970,8 @@ var DomSurface = class DomSurface {
 			root: () => this.svg_root,
 			camera: () => this.camera,
 			container: () => this.container,
-			pick_at_world: (p, allow_root) => this._pick_node_at_world(p, allow_root)
+			pick_at_world: (p, allow_root) => this._pick_node_at_world(p, allow_root),
+			flush: () => this.flush_dom()
 		}), {
 			subscribe_structure: (cb) => editor.subscribe_with_selector((s) => s.structure_version, () => cb()),
 			subscribe_geometry: (cb) => editor.subscribe_geometry(cb)
@@ -2141,6 +2153,25 @@ var DomSurface = class DomSurface {
 	detach_gestures() {
 		this.gestures._dispose();
 	}
+	/**
+	* Bring the live DOM up to date with the doc IR iff it is stale.
+	*
+	* Staleness contract: anything that reads the LIVE DOM as a proxy for
+	* document state — the geometry driver (`getBBox` / `getCTM`), the
+	* computed-style resolver — MUST call this first. Doc listeners (the
+	* geometry channel, editor `subscribe`) fire synchronously inside the
+	* mutation, BEFORE the surface's render listener has projected the new
+	* attrs into the DOM; a read in that window returns the PREVIOUS
+	* geometry, and through `MemoizedGeometryProvider` it would be cached as
+	* if current — every later consumer (align, resize_to, snap) then plans
+	* against one-mutation-stale bounds. Same model as CSS layout: reading
+	* `offsetWidth` flushes pending layout; reading `bounds_of` flushes the
+	* pending render.
+	*/
+	flush_dom() {
+		if (this.rendered_doc_revision === this.editor._internal.doc.revision) return;
+		this.render();
+	}
 	render() {
 		if (this.text_edit) return;
 		const owner_doc = this.container.ownerDocument;
@@ -2167,6 +2198,7 @@ var DomSurface = class DomSurface {
 			for (let c = el.firstElementChild; c; c = c.nextElementSibling) if (c instanceof SVGElement) tag_walk(c);
 		};
 		tag_walk(new_svg);
+		this.rendered_doc_revision = doc.revision;
 	}
 	sync_canvas_size() {
 		const cr = this.container.getBoundingClientRect();
@@ -2761,6 +2793,60 @@ var DomSurface = class DomSurface {
 		});
 		on(win, "blur", () => this.sync_modifiers(null));
 		on(this.container, "contextmenu", (e) => e.preventDefault());
+		if (this.clipboard_enabled) {
+			on(owner_doc, "copy", (e) => this.on_copy_or_cut(e, "copy"));
+			on(owner_doc, "cut", (e) => this.on_copy_or_cut(e, "cut"));
+			on(owner_doc, "paste", (e) => this.on_paste(e));
+		}
+	}
+	/**
+	* Gate for claiming a native clipboard gesture. Deliberately STRICTER
+	* than the keyboard attention gate: focus-based only — pointer-over is
+	* a sufficient signal for a keystroke (worst case: a stolen scroll) but
+	* not for clipboard (worst case: destroying what the user believed they
+	* copied, or routing a paste meant for a host text field into the
+	* document). A user with text selected in a sibling panel and the
+	* pointer idly over the canvas must get their text copy.
+	*/
+	claims_clipboard(kind) {
+		if (this.text_edit) return false;
+		if (this.editor.state.mode !== "select") return false;
+		if (!this.attention.is_focus_within()) return false;
+		if (require_model.is_text_input_focused()) return false;
+		if (kind !== "paste") {
+			const sel = this.container.ownerDocument.getSelection();
+			if (sel && !sel.isCollapsed) return false;
+		}
+		return true;
+	}
+	/**
+	* Act-then-claim: an empty selection returns without `preventDefault()`,
+	* leaving the browser default (and the OS clipboard) untouched. The
+	* buffer-only `_internal.clipboard` variants are used here — the event's
+	* DataTransfer is this gesture's ONE external channel (the public
+	* commands would additionally write the provider; one gesture, one
+	* external write — FRD §Transport).
+	*/
+	on_copy_or_cut(e, kind) {
+		if (!this.claims_clipboard(kind)) return;
+		if (!e.clipboardData) return;
+		const internal = this.editor_internal();
+		const payload = kind === "copy" ? internal.clipboard.copy() : internal.clipboard.cut();
+		if (payload === null) return;
+		e.clipboardData.setData("text/plain", payload);
+		e.preventDefault();
+	}
+	/**
+	* Claim-then-act (mirrors the keydown claim doctrine: swallow when the
+	* gesture is aimed at the editor, not just when a handler consumed):
+	* a refused paste — junk text — still claims; the suppressed default is
+	* a no-op on a div anyway.
+	*/
+	on_paste(e) {
+		if (!this.claims_clipboard("paste")) return;
+		e.preventDefault();
+		const text = e.clipboardData?.getData("text/plain");
+		if (text) this.editor.commands.paste(text);
 	}
 	/**
 	* Master signal for modifier-driven UX consumers (measurement, future
@@ -2782,7 +2868,7 @@ var DomSurface = class DomSurface {
 			kind: "modifiers",
 			mods: next
 		});
-		if (prev.shift !== next.shift && this.translate_orchestrator.has_active_session()) this.translate_orchestrator.redrive_modifiers(this.current_translate_modifiers());
+		if ((prev.shift !== next.shift || prev.alt !== next.alt) && this.translate_orchestrator.has_active_session()) this.translate_orchestrator.redrive_modifiers(this.current_translate_modifiers());
 		if (prev.shift !== next.shift && this.resize_orchestrator.has_active_session()) this.resize_orchestrator.redrive_modifiers(this.current_resize_modifiers());
 		if (prev.shift !== next.shift && this.rotate_orchestrator.has_active_session()) this.rotate_orchestrator.redrive_modifiers(this.current_rotate_modifiers());
 		this.redraw();
@@ -2803,6 +2889,7 @@ var DomSurface = class DomSurface {
 			} else if (kind === "pointer_up") this.text_edit.pointerUp();
 			return;
 		}
+		if (kind === "pointer_down") this.container.focus({ preventScroll: true });
 		const cr = this.container.getBoundingClientRect();
 		const x = e.clientX - cr.left;
 		const y = e.clientY - cr.top;
@@ -3119,13 +3206,15 @@ var DomSurface = class DomSurface {
 		});
 		if (intent.phase === "commit") this.request_redraw();
 	}
-	/** Snapshot of HUD modifier state mapped to pipeline `TranslateModifiers`.
+	/** Snapshot of HUD modifier state mapped to the orchestrator's `GestureModifiers`.
 	*  Pull-at-consume: HUD is the canonical store (see `sync_modifiers`),
 	*  read live so mid-drag Shift press/release reflects on the next pass. */
 	current_translate_modifiers() {
+		const mods = this.hud.modifiers();
 		return {
-			axis_lock: this.hud.modifiers().shift ? "by_dominance" : "off",
-			force_disable_snap: false
+			axis_lock: mods.shift ? "by_dominance" : "off",
+			force_disable_snap: false,
+			clone: mods.alt
 		};
 	}
 	/** Snapshot of HUD modifier state mapped to `ResizeModifiers`. Same
@@ -4464,6 +4553,7 @@ var SvgGeometryDriver = class {
 		this.accessors = accessors;
 	}
 	bounds_of(id) {
+		this.accessors.flush();
 		const el = this.accessors.element_for(id);
 		if (!el) return null;
 		if (el instanceof SVGSVGElement) return svg_viewport_bounds(el);
@@ -4515,6 +4605,7 @@ var SvgGeometryDriver = class {
 		return out;
 	}
 	nodes_in_rect(rect) {
+		this.accessors.flush();
 		const root = this.accessors.root();
 		if (!root) return [];
 		const hits = [];
@@ -4527,6 +4618,7 @@ var SvgGeometryDriver = class {
 		return hits;
 	}
 	node_at_point(p) {
+		this.accessors.flush();
 		return this.accessors.pick_at_world(p, true);
 	}
 	/** World→local delta projection. The frame an element's position is
@@ -4542,6 +4634,7 @@ var SvgGeometryDriver = class {
 	*  the local delta. Identity (→ delta unchanged) for flat frames,
 	*  top-level nodes, and any degenerate / unavailable matrix. */
 	world_delta_to_local(id, delta) {
+		this.accessors.flush();
 		const parent = this.accessors.element_for(id)?.parentNode;
 		const root = this.accessors.root();
 		if (!(parent instanceof SVGGraphicsElement) || !root) return delta;

package/dist/{dom-DOvcMvl4.mjs → dom-OP-kmK8k.mjs}

@@ -1,4 +1,4 @@
-import { a as paint, b as is_text_input_focused, c as hit_shape_svg, d as NudgeDwellWatcher, f as TranslateOrchestrator, h as transform, i as TOOL_CURSOR, l as RotateOrchestrator, m as group, n as insertions, o as ResizeOrchestrator, s as resize_pipeline, t as PathModel, y as array_shallow_equal } from "./model-L3t9ixT_.mjs";
+import { S as is_text_input_focused, a as paint, c as hit_shape_svg, d as NudgeDwellWatcher, f as TranslateOrchestrator, h as transform, i as TOOL_CURSOR, l as RotateOrchestrator, m as group, n as insertions, o as ResizeOrchestrator, s as resize_pipeline, t as PathModel, x as array_shallow_equal } from "./model-DU0GOMwM.mjs";
 import cmath from "@grida/cmath";
 import { svg_parse } from "@grida/svg/parse";
 import { SVGShapes } from "@grida/svg/pathdata";
@@ -1005,15 +1005,18 @@ function create_attention_tracker(container) {
 	};
 	container.addEventListener("pointerenter", on_enter);
 	container.addEventListener("pointerleave", on_leave);
-	const is_attended = () => {
+	const is_focus_within = () => {
 		const owner = container.ownerDocument;
-		if (!owner) return pointer_over;
+		if (!owner) return false;
 		const active = owner.activeElement;
-		if (active && active !== owner.body && container.contains(active)) return true;
-		return pointer_over;
+		return !!active && active !== owner.body && container.contains(active);
+	};
+	const is_attended = () => {
+		return is_focus_within() || pointer_over;
 	};
 	return {
 		is_attended,
+		is_focus_within,
 		dispose: () => {
 			container.removeEventListener("pointerenter", on_enter);
 			container.removeEventListener("pointerleave", on_leave);
@@ -1705,6 +1708,7 @@ var DomSurface = class DomSurface {
 		this.svg_root = null;
 		this.teardown = [];
 		this.element_index = /* @__PURE__ */ new Map();
+		this.rendered_doc_revision = -1;
 		this.last_pointer = {
 			x: 0,
 			y: 0
@@ -1729,6 +1733,7 @@ var DomSurface = class DomSurface {
 		this.container = options.container;
 		const container = this.container;
 		this.fit_on_attach = options.fit === true;
+		this.clipboard_enabled = options.clipboard !== false;
 		this.attention = create_attention_tracker(container);
 		this.teardown.push(() => this.attention.dispose());
 		if (process.env.NODE_ENV !== "production" && container.children.length > 0) console.warn("@grida/svg-editor: surface container is not empty at attach time. Render chrome (toolbars, layer lists, inspectors) as siblings of the container, not children — otherwise clicks on those children will silently break. See README §Surface.");
@@ -1736,6 +1741,8 @@ var DomSurface = class DomSurface {
 		container.style.overflow = "hidden";
 		container.style.userSelect = "none";
 		container.style.webkitUserSelect = "none";
+		container.tabIndex = -1;
+		container.style.outline = "none";
 		const translate_options = () => {
 			const style = this.editor.style;
 			const zoom = this.camera.zoom || 1;
@@ -1751,7 +1758,9 @@ var DomSurface = class DomSurface {
 			open_preview: (label) => this.editor_internal().history.preview(label),
 			open_snap: (ids) => this.open_snap_session_for(ids),
 			options: translate_options,
-			project_delta: (id, d) => this._geometry_provider?.world_delta_to_local(id, d) ?? d
+			project_delta: (id, d) => this._geometry_provider?.world_delta_to_local(id, d) ?? d,
+			set_selection: (ids) => this.editor.commands.select(ids),
+			on_clone_commit: (record) => this.editor_internal().seed_duplication(record)
 		});
 		const resize_options = () => {
 			const style = this.editor.style;
@@ -1879,7 +1888,7 @@ var DomSurface = class DomSurface {
 			this.current_tool = editor.state.tool;
 			this.hud.setVectorSelectionMode(this.current_tool.type === "lasso" ? "lasso" : "marquee");
 			this.hud.setVectorBendMode(this.current_tool.type === "bend" ? "always" : "auto");
-			this.render();
+			this.flush_dom();
 			this.sync_surface_selection();
 			this.hud.setPixelGrid({
 				enabled: editor.style.pixel_grid,
@@ -1935,12 +1944,14 @@ var DomSurface = class DomSurface {
 		this.teardown.push(() => internal.set_content_edit_driver(null));
 		internal.set_computed_resolver({
 			computed_property: (id, name) => {
+				this.flush_dom();
 				const el = this.element_index.get(id);
 				if (!el) return null;
 				const value = getComputedStyle(el).getPropertyValue(name);
 				return value === "" ? null : value;
 			},
 			computed_paint: (id, channel) => {
+				this.flush_dom();
 				const el = this.element_index.get(id);
 				if (!el) return null;
 				const computed = getComputedStyle(el).getPropertyValue(channel);
@@ -1957,7 +1968,8 @@ var DomSurface = class DomSurface {
 			root: () => this.svg_root,
 			camera: () => this.camera,
 			container: () => this.container,
-			pick_at_world: (p, allow_root) => this._pick_node_at_world(p, allow_root)
+			pick_at_world: (p, allow_root) => this._pick_node_at_world(p, allow_root),
+			flush: () => this.flush_dom()
 		}), {
 			subscribe_structure: (cb) => editor.subscribe_with_selector((s) => s.structure_version, () => cb()),
 			subscribe_geometry: (cb) => editor.subscribe_geometry(cb)
@@ -2139,6 +2151,25 @@ var DomSurface = class DomSurface {
 	detach_gestures() {
 		this.gestures._dispose();
 	}
+	/**
+	* Bring the live DOM up to date with the doc IR iff it is stale.
+	*
+	* Staleness contract: anything that reads the LIVE DOM as a proxy for
+	* document state — the geometry driver (`getBBox` / `getCTM`), the
+	* computed-style resolver — MUST call this first. Doc listeners (the
+	* geometry channel, editor `subscribe`) fire synchronously inside the
+	* mutation, BEFORE the surface's render listener has projected the new
+	* attrs into the DOM; a read in that window returns the PREVIOUS
+	* geometry, and through `MemoizedGeometryProvider` it would be cached as
+	* if current — every later consumer (align, resize_to, snap) then plans
+	* against one-mutation-stale bounds. Same model as CSS layout: reading
+	* `offsetWidth` flushes pending layout; reading `bounds_of` flushes the
+	* pending render.
+	*/
+	flush_dom() {
+		if (this.rendered_doc_revision === this.editor._internal.doc.revision) return;
+		this.render();
+	}
 	render() {
 		if (this.text_edit) return;
 		const owner_doc = this.container.ownerDocument;
@@ -2165,6 +2196,7 @@ var DomSurface = class DomSurface {
 			for (let c = el.firstElementChild; c; c = c.nextElementSibling) if (c instanceof SVGElement) tag_walk(c);
 		};
 		tag_walk(new_svg);
+		this.rendered_doc_revision = doc.revision;
 	}
 	sync_canvas_size() {
 		const cr = this.container.getBoundingClientRect();
@@ -2759,6 +2791,60 @@ var DomSurface = class DomSurface {
 		});
 		on(win, "blur", () => this.sync_modifiers(null));
 		on(this.container, "contextmenu", (e) => e.preventDefault());
+		if (this.clipboard_enabled) {
+			on(owner_doc, "copy", (e) => this.on_copy_or_cut(e, "copy"));
+			on(owner_doc, "cut", (e) => this.on_copy_or_cut(e, "cut"));
+			on(owner_doc, "paste", (e) => this.on_paste(e));
+		}
+	}
+	/**
+	* Gate for claiming a native clipboard gesture. Deliberately STRICTER
+	* than the keyboard attention gate: focus-based only — pointer-over is
+	* a sufficient signal for a keystroke (worst case: a stolen scroll) but
+	* not for clipboard (worst case: destroying what the user believed they
+	* copied, or routing a paste meant for a host text field into the
+	* document). A user with text selected in a sibling panel and the
+	* pointer idly over the canvas must get their text copy.
+	*/
+	claims_clipboard(kind) {
+		if (this.text_edit) return false;
+		if (this.editor.state.mode !== "select") return false;
+		if (!this.attention.is_focus_within()) return false;
+		if (is_text_input_focused()) return false;
+		if (kind !== "paste") {
+			const sel = this.container.ownerDocument.getSelection();
+			if (sel && !sel.isCollapsed) return false;
+		}
+		return true;
+	}
+	/**
+	* Act-then-claim: an empty selection returns without `preventDefault()`,
+	* leaving the browser default (and the OS clipboard) untouched. The
+	* buffer-only `_internal.clipboard` variants are used here — the event's
+	* DataTransfer is this gesture's ONE external channel (the public
+	* commands would additionally write the provider; one gesture, one
+	* external write — FRD §Transport).
+	*/
+	on_copy_or_cut(e, kind) {
+		if (!this.claims_clipboard(kind)) return;
+		if (!e.clipboardData) return;
+		const internal = this.editor_internal();
+		const payload = kind === "copy" ? internal.clipboard.copy() : internal.clipboard.cut();
+		if (payload === null) return;
+		e.clipboardData.setData("text/plain", payload);
+		e.preventDefault();
+	}
+	/**
+	* Claim-then-act (mirrors the keydown claim doctrine: swallow when the
+	* gesture is aimed at the editor, not just when a handler consumed):
+	* a refused paste — junk text — still claims; the suppressed default is
+	* a no-op on a div anyway.
+	*/
+	on_paste(e) {
+		if (!this.claims_clipboard("paste")) return;
+		e.preventDefault();
+		const text = e.clipboardData?.getData("text/plain");
+		if (text) this.editor.commands.paste(text);
 	}
 	/**
 	* Master signal for modifier-driven UX consumers (measurement, future
@@ -2780,7 +2866,7 @@ var DomSurface = class DomSurface {
 			kind: "modifiers",
 			mods: next
 		});
-		if (prev.shift !== next.shift && this.translate_orchestrator.has_active_session()) this.translate_orchestrator.redrive_modifiers(this.current_translate_modifiers());
+		if ((prev.shift !== next.shift || prev.alt !== next.alt) && this.translate_orchestrator.has_active_session()) this.translate_orchestrator.redrive_modifiers(this.current_translate_modifiers());
 		if (prev.shift !== next.shift && this.resize_orchestrator.has_active_session()) this.resize_orchestrator.redrive_modifiers(this.current_resize_modifiers());
 		if (prev.shift !== next.shift && this.rotate_orchestrator.has_active_session()) this.rotate_orchestrator.redrive_modifiers(this.current_rotate_modifiers());
 		this.redraw();
@@ -2801,6 +2887,7 @@ var DomSurface = class DomSurface {
 			} else if (kind === "pointer_up") this.text_edit.pointerUp();
 			return;
 		}
+		if (kind === "pointer_down") this.container.focus({ preventScroll: true });
 		const cr = this.container.getBoundingClientRect();
 		const x = e.clientX - cr.left;
 		const y = e.clientY - cr.top;
@@ -3117,13 +3204,15 @@ var DomSurface = class DomSurface {
 		});
 		if (intent.phase === "commit") this.request_redraw();
 	}
-	/** Snapshot of HUD modifier state mapped to pipeline `TranslateModifiers`.
+	/** Snapshot of HUD modifier state mapped to the orchestrator's `GestureModifiers`.
 	*  Pull-at-consume: HUD is the canonical store (see `sync_modifiers`),
 	*  read live so mid-drag Shift press/release reflects on the next pass. */
 	current_translate_modifiers() {
+		const mods = this.hud.modifiers();
 		return {
-			axis_lock: this.hud.modifiers().shift ? "by_dominance" : "off",
-			force_disable_snap: false
+			axis_lock: mods.shift ? "by_dominance" : "off",
+			force_disable_snap: false,
+			clone: mods.alt
 		};
 	}
 	/** Snapshot of HUD modifier state mapped to `ResizeModifiers`. Same
@@ -4462,6 +4551,7 @@ var SvgGeometryDriver = class {
 		this.accessors = accessors;
 	}
 	bounds_of(id) {
+		this.accessors.flush();
 		const el = this.accessors.element_for(id);
 		if (!el) return null;
 		if (el instanceof SVGSVGElement) return svg_viewport_bounds(el);
@@ -4513,6 +4603,7 @@ var SvgGeometryDriver = class {
 		return out;
 	}
 	nodes_in_rect(rect) {
+		this.accessors.flush();
 		const root = this.accessors.root();
 		if (!root) return [];
 		const hits = [];
@@ -4525,6 +4616,7 @@ var SvgGeometryDriver = class {
 		return hits;
 	}
 	node_at_point(p) {
+		this.accessors.flush();
 		return this.accessors.pick_at_world(p, true);
 	}
 	/** World→local delta projection. The frame an element's position is
@@ -4540,6 +4632,7 @@ var SvgGeometryDriver = class {
 	*  the local delta. Identity (→ delta unchanged) for flat frames,
 	*  top-level nodes, and any degenerate / unavailable matrix. */
 	world_delta_to_local(id, delta) {
+		this.accessors.flush();
 		const parent = this.accessors.element_for(id)?.parentNode;
 		const root = this.accessors.root();
 		if (!(parent instanceof SVGGraphicsElement) || !root) return delta;

package/dist/{dom-98AUOfsP.d.mts → dom-TctdgRnn.d.mts}

@@ -1,4 +1,4 @@
-import { c as SvgEditor, p as Gestures, s as SurfaceHandle, w as Camera } from "./editor-D2eQe8lB.mjs";
+import { c as SvgEditor, p as Gestures, s as SurfaceHandle, w as Camera } from "./editor-KqpIW1qm.mjs";
 import cmath from "@grida/cmath";
 import { guide } from "@grida/cmath/_snap";
 
@@ -50,6 +50,18 @@ type DomSurfaceOptions = {
    * carte via `handle.gestures.bind(...)`.
    */
   gestures?: boolean;
+  /**
+   * Wire native ClipboardEvent transport — `copy` / `cut` / `paste`
+   * listeners on the owner document, gated by the clipboard attention
+   * discipline. Default `true`. Pass `false` to route ALL clipboard
+   * traffic through the `ClipboardProvider` seam instead (the
+   * configuration under which a host's paste-time screening governs
+   * every path) — see docs/wg/feat-svg-editor/clipboard.md §Transport
+   * "Host control over the native path". Focus management (the container
+   * focusing on pointerdown) stays either way — it is a general canvas
+   * mitigation, not a clipboard feature.
+   */
+  clipboard?: boolean;
   /**
    * Auto-fit the document into the viewport on initial attach. Default
    * `false`. Mirrors Excalidraw's `initialData.scrollToContent`.

package/dist/dom.d.mts

@@ -1,3 +1,3 @@
-import { C as BoundsResolver, E as CameraOptions, T as CameraConstraints, d as GestureContext, f as GestureId, g as MemoizedGeometryProvider, h as GeometrySignals, i as DomComputedResolver, m as GeometryProvider, p as Gestures, r as DomComputedPaint, u as GestureBinding, w as Camera } from "./editor-D2eQe8lB.mjs";
-import { a as inverse_project_rect, c as DEFAULT_SNAP_OPTIONS, i as install_font_load_geometry_bump, l as SnapOptions, n as DomSurfaceOptions, o as project_delta_inverse_ctm, r as attach_dom_surface, s as project_point_through_ctm, t as DomSurfaceHandle } from "./dom-98AUOfsP.mjs";
+import { C as BoundsResolver, E as CameraOptions, T as CameraConstraints, d as GestureContext, f as GestureId, g as MemoizedGeometryProvider, h as GeometrySignals, i as DomComputedResolver, m as GeometryProvider, p as Gestures, r as DomComputedPaint, u as GestureBinding, w as Camera } from "./editor-KqpIW1qm.mjs";
+import { a as inverse_project_rect, c as DEFAULT_SNAP_OPTIONS, i as install_font_load_geometry_bump, l as SnapOptions, n as DomSurfaceOptions, o as project_delta_inverse_ctm, r as attach_dom_surface, s as project_point_through_ctm, t as DomSurfaceHandle } from "./dom-TctdgRnn.mjs";
 export { type BoundsResolver, Camera, type CameraConstraints, type CameraOptions, DEFAULT_SNAP_OPTIONS, type DomComputedPaint, type DomComputedResolver, DomSurfaceHandle, DomSurfaceOptions, type GeometryProvider, type GeometrySignals, type GestureBinding, type GestureContext, type GestureId, Gestures, MemoizedGeometryProvider, type SnapOptions, attach_dom_surface, install_font_load_geometry_bump, inverse_project_rect, project_delta_inverse_ctm, project_point_through_ctm };

package/dist/dom.d.ts

@@ -1,3 +1,3 @@
-import { C as BoundsResolver, E as CameraOptions, T as CameraConstraints, d as GestureContext, f as GestureId, g as MemoizedGeometryProvider, h as GeometrySignals, i as DomComputedResolver, m as GeometryProvider, p as Gestures, r as DomComputedPaint, u as GestureBinding, w as Camera } from "./editor-CYoGJ3Hf.js";
-import { a as inverse_project_rect, c as DEFAULT_SNAP_OPTIONS, i as install_font_load_geometry_bump, l as SnapOptions, n as DomSurfaceOptions, o as project_delta_inverse_ctm, r as attach_dom_surface, s as project_point_through_ctm, t as DomSurfaceHandle } from "./dom-BO2-E9oK.js";
+import { C as BoundsResolver, E as CameraOptions, T as CameraConstraints, d as GestureContext, f as GestureId, g as MemoizedGeometryProvider, h as GeometrySignals, i as DomComputedResolver, m as GeometryProvider, p as Gestures, r as DomComputedPaint, u as GestureBinding, w as Camera } from "./editor-BSxTUsW_.js";
+import { a as inverse_project_rect, c as DEFAULT_SNAP_OPTIONS, i as install_font_load_geometry_bump, l as SnapOptions, n as DomSurfaceOptions, o as project_delta_inverse_ctm, r as attach_dom_surface, s as project_point_through_ctm, t as DomSurfaceHandle } from "./dom-BMzX1CXZ.js";
 export { type BoundsResolver, Camera, type CameraConstraints, type CameraOptions, DEFAULT_SNAP_OPTIONS, type DomComputedPaint, type DomComputedResolver, DomSurfaceHandle, DomSurfaceOptions, type GeometryProvider, type GeometrySignals, type GestureBinding, type GestureContext, type GestureId, Gestures, MemoizedGeometryProvider, type SnapOptions, attach_dom_surface, install_font_load_geometry_bump, inverse_project_rect, project_delta_inverse_ctm, project_point_through_ctm };

package/dist/dom.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_dom = require("./dom-U6ae5fQF.js");
+const require_dom = require("./dom-DKQ4Vt3z.js");
 exports.Camera = require_dom.Camera;
 exports.DEFAULT_SNAP_OPTIONS = require_dom.DEFAULT_SNAP_OPTIONS;
 exports.Gestures = require_dom.Gestures;

package/dist/dom.mjs

@@ -1,2 +1,2 @@
-import { a as project_point_through_ctm, c as MemoizedGeometryProvider, i as project_delta_inverse_ctm, l as Camera, n as install_font_load_geometry_bump, o as Gestures, r as inverse_project_rect, s as DEFAULT_SNAP_OPTIONS, t as attach_dom_surface } from "./dom-DOvcMvl4.mjs";
+import { a as project_point_through_ctm, c as MemoizedGeometryProvider, i as project_delta_inverse_ctm, l as Camera, n as install_font_load_geometry_bump, o as Gestures, r as inverse_project_rect, s as DEFAULT_SNAP_OPTIONS, t as attach_dom_surface } from "./dom-OP-kmK8k.mjs";
 export { Camera, DEFAULT_SNAP_OPTIONS, Gestures, MemoizedGeometryProvider, attach_dom_surface, install_font_load_geometry_bump, inverse_project_rect, project_delta_inverse_ctm, project_point_through_ctm };