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

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-D2eQe8lB.mjs";
+import { n as DomSurfaceOptions, t as DomSurfaceHandle } from "./dom-98AUOfsP.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-CYoGJ3Hf.js";
+import { n as DomSurfaceOptions, t as DomSurfaceHandle } from "./dom-BO2-E9oK.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-D0nU_EkL.js");
+const require_dom = require("./dom-U6ae5fQF.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-DOvcMvl4.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-D2eQe8lB.mjs";
+import { t as DomSurfaceHandle } from "./dom-98AUOfsP.mjs";
 import cmath from "@grida/cmath";
 import { ReactNode } from "react";
 
@@ -142,5 +142,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-CYoGJ3Hf.js";
+import { t as DomSurfaceHandle } from "./dom-BO2-E9oK.js";
 import cmath from "@grida/cmath";
 import { ReactNode } from "react";
 
@@ -142,5 +142,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-C6Lj1In-.js");
+const require_dom = require("./dom-U6ae5fQF.js");
 let react = require("react");
 let react_jsx_runtime = require("react/jsx-runtime");
 //#region src/react.tsx
@@ -236,6 +236,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 +267,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-DKQOIKuU.mjs";
+import { t as attach_dom_surface } from "./dom-DOvcMvl4.mjs";
 import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useSyncExternalStore } from "react";
 import { jsx } from "react/jsx-runtime";
 //#region src/react.tsx
@@ -235,5 +235,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.16",
   "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/history": "0.1.1",
     "@grida/keybinding": "0.2.1",
     "@grida/svg": "0.1.1",
-    "@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/hud": "0.2.1"
   },
   "devDependencies": {
     "@types/react": "^19",