@grida/svg-editor 1.0.0-alpha.15 → 1.0.0-alpha.17

package/dist/presets.d.mts

@@ -1,5 +1,5 @@
-import { c as SvgEditor } from "./editor-Dl7c0q5A.mjs";
-import { n as DomSurfaceOptions, t as DomSurfaceHandle } from "./dom-CK6GlgFF.mjs";
+import { c as SvgEditor } from "./editor-KqpIW1qm.mjs";
+import { n as DomSurfaceOptions, t as DomSurfaceHandle } from "./dom-TctdgRnn.mjs";
 
 //#region src/presets/keynote.d.ts
 declare namespace keynote_d_exports {

package/dist/presets.d.ts

@@ -1,5 +1,5 @@
-import { c as SvgEditor } from "./editor-BKoo9SPL.js";
-import { n as DomSurfaceOptions, t as DomSurfaceHandle } from "./dom-CsKXTaNw.js";
+import { c as SvgEditor } from "./editor-BSxTUsW_.js";
+import { n as DomSurfaceOptions, t as DomSurfaceHandle } from "./dom-BMzX1CXZ.js";
 
 //#region \0rolldown/runtime.js
 declare namespace keynote_d_exports {

package/dist/presets.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_model = require("./model-CJ1Ctq14.js");
-const require_dom = require("./dom-Dee6FtgZ.js");
+const require_model = require("./model-GpysNbOv.js");
+const require_dom = require("./dom-CaByuo6C.js");
 //#region src/presets/keynote.ts
 var keynote_exports = /* @__PURE__ */ require_model.__exportAll({ attach: () => attach });
 /**

package/dist/presets.mjs

@@ -1,5 +1,5 @@
 import { t as __exportAll } from "./chunk-D7D4PA-g.mjs";
-import { t as attach_dom_surface } from "./dom-DILY80j7.mjs";
+import { t as attach_dom_surface } from "./dom-Bjj9xySE.mjs";
 //#region src/presets/keynote.ts
 var keynote_exports = /* @__PURE__ */ __exportAll({ attach: () => attach });
 /**

package/dist/react.d.mts

@@ -1,5 +1,5 @@
-import { A as EditorState, G as PaintPreviewSession, H as NodeId, V as Mode, X as Providers, c as SvgEditor, j as EditorStyle, q as PreviewSession, t as Commands, tt as Tool } from "./editor-Dl7c0q5A.mjs";
-import { t as DomSurfaceHandle } from "./dom-CK6GlgFF.mjs";
+import { A as EditorState, H as Mode, J as PickEvent, K as PaintPreviewSession, Q as Providers, U as NodeId, Y as PreviewSession, c as SvgEditor, j as EditorStyle, rt as Tool, t as Commands } from "./editor-KqpIW1qm.mjs";
+import { t as DomSurfaceHandle } from "./dom-TctdgRnn.mjs";
 import cmath from "@grida/cmath";
 import { ReactNode } from "react";
 
@@ -47,7 +47,13 @@ type SvgEditorCanvasProps = {
    * Auto-fit the document on initial attach. Default `false`. See
    * `DomSurfaceOptions.fit`.
    */
-  fit?: boolean; /** Initial camera transform. Default identity. */
+  fit?: boolean;
+  /**
+   * Wire native ClipboardEvent transport (copy/cut/paste). Default `true`.
+   * Pass `false` to route all clipboard traffic through the
+   * `ClipboardProvider` seam. See `DomSurfaceOptions.clipboard`.
+   */
+  clipboard?: boolean; /** Initial camera transform. Default identity. */
   initial_camera?: cmath.Transform;
   /**
    * Receives the `DomSurfaceHandle` once the surface is attached, and
@@ -70,6 +76,7 @@ declare function SvgEditorCanvas({
   style,
   gestures,
   fit,
+  clipboard,
   initial_camera,
   onAttach
 }: SvgEditorCanvasProps): import("react/jsx-runtime").JSX.Element;
@@ -142,5 +149,22 @@ declare function useEditorSerialize(): () => string;
  * doesn't stay highlighted on a node that no longer has a panel row.
  */
 declare function useHoverOverride(): (id: NodeId | null) => void;
+/**
+ * Observe pick (tap) outcomes — a discrete click on the canvas, reporting the
+ * document-space `point`, the `node_id` under it (`null` for empty canvas),
+ * the `button`, and `mods`. The handler fires once per tap, after the editor's
+ * own selection handling. Observe-only: it cannot prevent or alter selection.
+ *
+ * This is the React edge-wire over `editor.subscribe_pick`. The handler is
+ * kept in a ref so re-subscription is never triggered by handler identity —
+ * pass an inline closure freely. Pick is editor-scoped (it survives surface
+ * detach), so this is a hook, not a `SvgEditorCanvas` prop.
+ *
+ * Typical use: a comment / annotation tool anchors a popover at `e.point` and
+ * scopes its action to `e.node_id` (or to the whole document when `null`).
+ *
+ * @unstable See {@link PickEvent}.
+ */
+declare function useEditorPick(handler: (e: PickEvent) => void): void;
 //#endregion
-export { SvgEditorCanvas, SvgEditorCanvasProps, SvgEditorProvider, SvgEditorProviderProps, useCameraSnapshot, useCanRedo, useCanUndo, useCommands, useContentEditKind, useEditorLoad, useEditorSerialize, useEditorState, useHoverOverride, useMode, usePaintPreview, usePropertyPreview, useSelection, useSvgEditor, useTool };
+export { SvgEditorCanvas, SvgEditorCanvasProps, SvgEditorProvider, SvgEditorProviderProps, useCameraSnapshot, useCanRedo, useCanUndo, useCommands, useContentEditKind, useEditorLoad, useEditorPick, useEditorSerialize, useEditorState, useHoverOverride, useMode, usePaintPreview, usePropertyPreview, useSelection, useSvgEditor, useTool };

package/dist/react.d.ts

@@ -1,5 +1,5 @@
-import { A as EditorState, G as PaintPreviewSession, H as NodeId, V as Mode, X as Providers, c as SvgEditor, j as EditorStyle, q as PreviewSession, t as Commands, tt as Tool } from "./editor-BKoo9SPL.js";
-import { t as DomSurfaceHandle } from "./dom-CsKXTaNw.js";
+import { A as EditorState, H as Mode, J as PickEvent, K as PaintPreviewSession, Q as Providers, U as NodeId, Y as PreviewSession, c as SvgEditor, j as EditorStyle, rt as Tool, t as Commands } from "./editor-BSxTUsW_.js";
+import { t as DomSurfaceHandle } from "./dom-BMzX1CXZ.js";
 import cmath from "@grida/cmath";
 import { ReactNode } from "react";
 
@@ -47,7 +47,13 @@ type SvgEditorCanvasProps = {
    * Auto-fit the document on initial attach. Default `false`. See
    * `DomSurfaceOptions.fit`.
    */
-  fit?: boolean; /** Initial camera transform. Default identity. */
+  fit?: boolean;
+  /**
+   * Wire native ClipboardEvent transport (copy/cut/paste). Default `true`.
+   * Pass `false` to route all clipboard traffic through the
+   * `ClipboardProvider` seam. See `DomSurfaceOptions.clipboard`.
+   */
+  clipboard?: boolean; /** Initial camera transform. Default identity. */
   initial_camera?: cmath.Transform;
   /**
    * Receives the `DomSurfaceHandle` once the surface is attached, and
@@ -70,6 +76,7 @@ declare function SvgEditorCanvas({
   style,
   gestures,
   fit,
+  clipboard,
   initial_camera,
   onAttach
 }: SvgEditorCanvasProps): import("react/jsx-runtime").JSX.Element;
@@ -142,5 +149,22 @@ declare function useEditorSerialize(): () => string;
  * doesn't stay highlighted on a node that no longer has a panel row.
  */
 declare function useHoverOverride(): (id: NodeId | null) => void;
+/**
+ * Observe pick (tap) outcomes — a discrete click on the canvas, reporting the
+ * document-space `point`, the `node_id` under it (`null` for empty canvas),
+ * the `button`, and `mods`. The handler fires once per tap, after the editor's
+ * own selection handling. Observe-only: it cannot prevent or alter selection.
+ *
+ * This is the React edge-wire over `editor.subscribe_pick`. The handler is
+ * kept in a ref so re-subscription is never triggered by handler identity —
+ * pass an inline closure freely. Pick is editor-scoped (it survives surface
+ * detach), so this is a hook, not a `SvgEditorCanvas` prop.
+ *
+ * Typical use: a comment / annotation tool anchors a popover at `e.point` and
+ * scopes its action to `e.node_id` (or to the whole document when `null`).
+ *
+ * @unstable See {@link PickEvent}.
+ */
+declare function useEditorPick(handler: (e: PickEvent) => void): void;
 //#endregion
-export { SvgEditorCanvas, SvgEditorCanvasProps, SvgEditorProvider, SvgEditorProviderProps, useCameraSnapshot, useCanRedo, useCanUndo, useCommands, useContentEditKind, useEditorLoad, useEditorSerialize, useEditorState, useHoverOverride, useMode, usePaintPreview, usePropertyPreview, useSelection, useSvgEditor, useTool };
+export { SvgEditorCanvas, SvgEditorCanvasProps, SvgEditorProvider, SvgEditorProviderProps, useCameraSnapshot, useCanRedo, useCanUndo, useCommands, useContentEditKind, useEditorLoad, useEditorPick, useEditorSerialize, useEditorState, useHoverOverride, useMode, usePaintPreview, usePropertyPreview, useSelection, useSvgEditor, useTool };

package/dist/react.js

@@ -1,7 +1,7 @@
 "use client";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_editor = require("./editor-F8ckj9X1.js");
-const require_dom = require("./dom-Dee6FtgZ.js");
+const require_editor = require("./editor-N9af0JD2.js");
+const require_dom = require("./dom-CaByuo6C.js");
 let react = require("react");
 let react_jsx_runtime = require("react/jsx-runtime");
 //#region src/react.tsx
@@ -40,7 +40,7 @@ function SvgEditorProvider({ initialSvg, providers, style, children }) {
 * context for them, because a host may mount multiple canvases in the
 * same editor session.
 */
-function SvgEditorCanvas({ className, style, gestures, fit, initial_camera, onAttach }) {
+function SvgEditorCanvas({ className, style, gestures, fit, clipboard, initial_camera, onAttach }) {
 	const editor = useSvgEditor();
 	const ref = (0, react.useRef)(null);
 	const on_attach_ref = (0, react.useRef)(onAttach);
@@ -54,6 +54,7 @@ function SvgEditorCanvas({ className, style, gestures, fit, initial_camera, onAt
 			container,
 			gestures,
 			fit,
+			clipboard,
 			initial_camera: initial_camera_ref.current
 		});
 		on_attach_ref.current?.(handle);
@@ -64,7 +65,8 @@ function SvgEditorCanvas({ className, style, gestures, fit, initial_camera, onAt
 	}, [
 		editor,
 		gestures,
-		fit
+		fit,
+		clipboard
 	]);
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 		ref,
@@ -236,6 +238,28 @@ function useHoverOverride() {
 		editor.set_surface_hover_override(id);
 	}, [editor]);
 }
+/**
+* Observe pick (tap) outcomes — a discrete click on the canvas, reporting the
+* document-space `point`, the `node_id` under it (`null` for empty canvas),
+* the `button`, and `mods`. The handler fires once per tap, after the editor's
+* own selection handling. Observe-only: it cannot prevent or alter selection.
+*
+* This is the React edge-wire over `editor.subscribe_pick`. The handler is
+* kept in a ref so re-subscription is never triggered by handler identity —
+* pass an inline closure freely. Pick is editor-scoped (it survives surface
+* detach), so this is a hook, not a `SvgEditorCanvas` prop.
+*
+* Typical use: a comment / annotation tool anchors a popover at `e.point` and
+* scopes its action to `e.node_id` (or to the whole document when `null`).
+*
+* @unstable See {@link PickEvent}.
+*/
+function useEditorPick(handler) {
+	const editor = useSvgEditor();
+	const handler_ref = (0, react.useRef)(handler);
+	handler_ref.current = handler;
+	(0, react.useEffect)(() => editor.subscribe_pick((e) => handler_ref.current(e)), [editor]);
+}
 //#endregion
 exports.SvgEditorCanvas = SvgEditorCanvas;
 exports.SvgEditorProvider = SvgEditorProvider;
@@ -245,6 +269,7 @@ exports.useCanUndo = useCanUndo;
 exports.useCommands = useCommands;
 exports.useContentEditKind = useContentEditKind;
 exports.useEditorLoad = useEditorLoad;
+exports.useEditorPick = useEditorPick;
 exports.useEditorSerialize = useEditorSerialize;
 exports.useEditorState = useEditorState;
 exports.useHoverOverride = useHoverOverride;

package/dist/react.mjs

@@ -1,6 +1,6 @@
 "use client";
-import { t as createSvgEditor } from "./editor-CvWpD5mu.mjs";
-import { t as attach_dom_surface } from "./dom-DILY80j7.mjs";
+import { t as createSvgEditor } from "./editor-BLsELHSZ.mjs";
+import { t as attach_dom_surface } from "./dom-Bjj9xySE.mjs";
 import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useSyncExternalStore } from "react";
 import { jsx } from "react/jsx-runtime";
 //#region src/react.tsx
@@ -39,7 +39,7 @@ function SvgEditorProvider({ initialSvg, providers, style, children }) {
 * context for them, because a host may mount multiple canvases in the
 * same editor session.
 */
-function SvgEditorCanvas({ className, style, gestures, fit, initial_camera, onAttach }) {
+function SvgEditorCanvas({ className, style, gestures, fit, clipboard, initial_camera, onAttach }) {
 	const editor = useSvgEditor();
 	const ref = useRef(null);
 	const on_attach_ref = useRef(onAttach);
@@ -53,6 +53,7 @@ function SvgEditorCanvas({ className, style, gestures, fit, initial_camera, onAt
 			container,
 			gestures,
 			fit,
+			clipboard,
 			initial_camera: initial_camera_ref.current
 		});
 		on_attach_ref.current?.(handle);
@@ -63,7 +64,8 @@ function SvgEditorCanvas({ className, style, gestures, fit, initial_camera, onAt
 	}, [
 		editor,
 		gestures,
-		fit
+		fit,
+		clipboard
 	]);
 	return /* @__PURE__ */ jsx("div", {
 		ref,
@@ -235,5 +237,27 @@ function useHoverOverride() {
 		editor.set_surface_hover_override(id);
 	}, [editor]);
 }
+/**
+* Observe pick (tap) outcomes — a discrete click on the canvas, reporting the
+* document-space `point`, the `node_id` under it (`null` for empty canvas),
+* the `button`, and `mods`. The handler fires once per tap, after the editor's
+* own selection handling. Observe-only: it cannot prevent or alter selection.
+*
+* This is the React edge-wire over `editor.subscribe_pick`. The handler is
+* kept in a ref so re-subscription is never triggered by handler identity —
+* pass an inline closure freely. Pick is editor-scoped (it survives surface
+* detach), so this is a hook, not a `SvgEditorCanvas` prop.
+*
+* Typical use: a comment / annotation tool anchors a popover at `e.point` and
+* scopes its action to `e.node_id` (or to the whole document when `null`).
+*
+* @unstable See {@link PickEvent}.
+*/
+function useEditorPick(handler) {
+	const editor = useSvgEditor();
+	const handler_ref = useRef(handler);
+	handler_ref.current = handler;
+	useEffect(() => editor.subscribe_pick((e) => handler_ref.current(e)), [editor]);
+}
 //#endregion
-export { SvgEditorCanvas, SvgEditorProvider, useCameraSnapshot, useCanRedo, useCanUndo, useCommands, useContentEditKind, useEditorLoad, useEditorSerialize, useEditorState, useHoverOverride, useMode, usePaintPreview, usePropertyPreview, useSelection, useSvgEditor, useTool };
+export { SvgEditorCanvas, SvgEditorProvider, useCameraSnapshot, useCanRedo, useCanUndo, useCommands, useContentEditKind, useEditorLoad, useEditorPick, useEditorSerialize, useEditorState, useHoverOverride, useMode, usePaintPreview, usePropertyPreview, useSelection, useSvgEditor, useTool };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grida/svg-editor",
-  "version": "1.0.0-alpha.15",
+  "version": "1.0.0-alpha.17",
   "description": "Headless SVG editor (experimental).",
   "keywords": [
     "bezier",
@@ -21,7 +21,10 @@
   "homepage": "https://grida.co/packages/@grida/svg-editor",
   "license": "MIT",
   "author": "Grida",
-  "repository": "https://github.com/gridaco/grida",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gridaco/grida"
+  },
   "files": [
     "dist"
   ],
@@ -56,12 +59,12 @@
   },
   "dependencies": {
     "@grida/cmath": "0.2.3",
+    "@grida/hud": "0.2.2",
     "@grida/keybinding": "0.2.1",
-    "@grida/svg": "0.1.1",
+    "@grida/svg": "0.2.0",
     "@grida/history": "0.1.1",
-    "@grida/hud": "0.2.1",
-    "@grida/text-editor": "0.1.2",
-    "@grida/vn": "0.1.0"
+    "@grida/vn": "0.1.0",
+    "@grida/text-editor": "0.1.2"
   },
   "devDependencies": {
     "@types/react": "^19",