@fieldnotes/react 0.4.2 → 0.5.0

package/README.md

@@ -12,26 +12,88 @@ Requires React 18+.
 
 ## Quick Start
 
+Full runnable example: `examples/react-app` — `pnpm --filter fieldnotes-react-example dev`
+
+The canvas needs a container with a defined size — it fills whatever it's given:
+
 ```tsx
+import { useState } from 'react';
 import { FieldNotesCanvas } from '@fieldnotes/react';
-import { HandTool, SelectTool, PencilTool } from '@fieldnotes/core';
+import {
+  HandTool,
+  SelectTool,
+  PencilTool,
+  EraserTool,
+  NoteTool,
+  ShapeTool,
+} from '@fieldnotes/core';
+
+const TOOLS = [
+  new HandTool(),
+  new SelectTool(),
+  new PencilTool(),
+  new EraserTool(),
+  new NoteTool(),
+  new ShapeTool(),
+];
+
+export function App() {
+  const [tool, setTool] = useState('select');
 
-function App() {
   return (
-    <FieldNotesCanvas
-      tools={[new HandTool(), new SelectTool(), new PencilTool()]}
-      defaultTool="select"
-      style={{ width: '100vw', height: '100vh' }}
-    />
+    <div style={{ width: '100vw', height: '100vh' }}>
+      <FieldNotesCanvas
+        tools={TOOLS}
+        tool={tool}
+        onToolChange={setTool}
+        style={{ width: '100%', height: '100%' }}
+      >
+        <Toolbar tool={tool} onSelect={setTool} />
+      </FieldNotesCanvas>
+    </div>
+  );
+}
+
+function Toolbar({ tool, onSelect }: { tool: string; onSelect: (name: string) => void }) {
+  const TOOL_LABELS: readonly (readonly [string, string])[] = [
+    ['select', 'Select'],
+    ['hand', 'Hand'],
+    ['pencil', 'Pencil'],
+    ['eraser', 'Eraser'],
+    ['note', 'Note'],
+    ['shape', 'Shape'],
+  ];
+
+  return (
+    <div className="toolbar">
+      {TOOL_LABELS.map(([name, label]) => (
+        <button key={name} className={tool === name ? 'active' : ''} onClick={() => onSelect(name)}>
+          {label}
+        </button>
+      ))}
+    </div>
   );
 }
 ```
 
-Your container needs a defined size — the canvas fills it.
+## Prop Reactivity
+
+Not all props are reactive — the canvas is stateful. Changing a mount-only prop after mount has no effect:
+
+| Prop                               | Reactivity                                                                          |
+| ---------------------------------- | ----------------------------------------------------------------------------------- |
+| `options`                          | Mount-only — the canvas is stateful; construct with the right options               |
+| `tools`                            | Reactive, append-only (tools cannot be unregistered). Hoist the array out of render |
+| `tool` / `onToolChange`            | Reactive (controlled). Memoize the callback                                         |
+| `defaultTool`                      | Mount-only (uncontrolled initial tool)                                              |
+| `snapToGrid`                       | Reactive                                                                            |
+| `className` / `style` / `children` | Reactive (plain React)                                                              |
+
+Runtime changes beyond these go through the viewport — access it via `useViewport()` or the ref: `viewport.setSnapToGrid(...)`, `viewport.shortcuts.rebind(...)`, `viewport.fitToContent()`. The background pattern is constructor-only (`options.background`).
 
 ## Embedding React Components
 
-The main feature — render any React component as a canvas element that pans, zooms, and resizes with the canvas:
+The headline feature — render any React subtree as a canvas element that pans, zooms, and resizes with the canvas:
 
 ```tsx
 import { FieldNotesCanvas, CanvasElement } from '@fieldnotes/react';
@@ -58,222 +120,225 @@ function App() {
 
 Embedded components use a **two-mode interaction model**: by default they can be selected, dragged, and resized. **Double-click** to enter interact mode (clicks, inputs, forms work). **Escape** or click outside to exit.
 
-## Hooks
-
-All hooks must be used inside `<FieldNotesCanvas>`.
+`position` is required; `size` is optional — omit it to let the element size to its content. Both props are reactive: updating them moves or resizes the element on the canvas.
 
-### `useActiveTool()`
+## Undo / Redo
 
-Reactive tool name + setter — re-renders when the active tool changes:
+`useHistory` returns reactive undo/redo state and action callbacks:
 
 ```tsx
-import { useActiveTool } from '@fieldnotes/react';
+import { useHistory } from '@fieldnotes/react';
 
-function Toolbar() {
-  const [tool, setTool] = useActiveTool();
+function UndoRedo() {
+  const { canUndo, canRedo, undo, redo } = useHistory();
 
   return (
     <div>
-      <span>Current: {tool}</span>
-      <button onClick={() => setTool('pencil')}>Pencil</button>
-      <button onClick={() => setTool('select')}>Select</button>
+      <button onClick={undo} disabled={!canUndo}>
+        Undo
+      </button>
+      <button onClick={redo} disabled={!canRedo}>
+        Redo
+      </button>
     </div>
   );
 }
 ```
 
-### `useToolOptions(toolName)`
+## Why Is My Sidebar Re-rendering 60×/s?
 
-Reactive tool options with two-way sync — read and write tool configuration:
+`useElements()` with no arguments re-renders on every store mutation. For derived values, pass a selector — the hook only re-renders when the selected value changes:
 
 ```tsx
-import { useActiveTool, useToolOptions } from '@fieldnotes/react';
-import type { PencilToolOptions } from '@fieldnotes/core';
+import { useCallback } from 'react';
+import { useElements } from '@fieldnotes/react';
+import type { CanvasElement } from '@fieldnotes/core';
 
-function PencilSettings() {
-  const [tool, setTool] = useActiveTool();
-  const [opts, setOpts] = useToolOptions<PencilToolOptions>('pencil');
+export function Sidebar() {
+  // Stable selector: useCallback with [] dependency or module-scope function
+  const count = useElements(useCallback((els: CanvasElement[]) => els.length, []));
+  const notes = useElements('note');
 
   return (
-    <div>
-      <button onClick={() => setTool('pencil')}>Pencil</button>
-      {tool === 'pencil' && opts && (
-        <>
-          <input
-            type="color"
-            value={opts.color}
-            onChange={(e) => setOpts({ color: e.target.value })}
-          />
-          <input
-            type="range"
-            min={1}
-            max={20}
-            value={opts.width}
-            onChange={(e) => setOpts({ width: Number(e.target.value) })}
-          />
-        </>
-      )}
+    <div className="sidebar">
+      <p>{count} elements</p>
+      <ul>
+        {notes.map((n) => (
+          <li key={n.id}>{n.text ? n.text.replace(/<[^>]+>/g, '').slice(0, 30) : '(empty)'}</li>
+        ))}
+      </ul>
     </div>
   );
 }
 ```
 
-Returns `[null, noop]` for tools that don't support options (e.g., `HandTool`).
+Alternatively, hoist expensive rendering into a memoized child and pass elements as props — React's `memo` then does the comparison.
 
-### `useLayers()`
+**Default comparator is one-level shallow**: arrays are compared by index, plain objects by key, primitives by `Object.is`. Selectors returning nested fresh objects (e.g. `els => els.map(e => ({ ...e.position }))`) still cause re-renders with the default comparator — pass a custom `isEqual` as the second argument:
 
-Full layer management — reactive layer list with action callbacks:
+```tsx
+const positions = useElements(
+  useCallback((els: CanvasElement[]) => els.map((e) => e.position), []),
+  (a, b) => a.length === b.length && a.every((p, i) => p.x === b[i]?.x && p.y === b[i]?.y),
+);
+```
+
+## Save / Load
+
+Access the viewport imperatively for export and import:
 
 ```tsx
-import { useLayers } from '@fieldnotes/react';
-
-function LayersPanel() {
-  const {
-    layers,
-    activeLayerId,
-    createLayer,
-    removeLayer,
-    setVisible,
-    setLocked,
-    setOpacity,
-    setActiveLayer,
-  } = useLayers();
+import { useViewport } from '@fieldnotes/react';
+
+export function SaveControls() {
+  const viewport = useViewport();
+
+  const save = () => {
+    localStorage.setItem('fieldnotes-example', viewport.exportJSON());
+  };
+  const load = () => {
+    const json = localStorage.getItem('fieldnotes-example');
+    if (json) viewport.loadJSON(json);
+  };
 
   return (
     <div>
-      <button onClick={() => createLayer()}>Add Layer</button>
-      {layers.map((layer) => (
-        <div key={layer.id} onClick={() => setActiveLayer(layer.id)}>
-          <span>
-            {layer.name} {layer.id === activeLayerId ? '(active)' : ''}
-          </span>
-          <button onClick={() => setVisible(layer.id, !layer.visible)}>
-            {layer.visible ? 'Hide' : 'Show'}
-          </button>
-          <button onClick={() => setLocked(layer.id, !layer.locked)}>
-            {layer.locked ? 'Unlock' : 'Lock'}
-          </button>
-          <input
-            type="range"
-            min={0}
-            max={1}
-            step={0.1}
-            value={layer.opacity}
-            onChange={(e) => setOpacity(layer.id, Number(e.target.value))}
-          />
-        </div>
-      ))}
+      <button onClick={save}>Save</button>
+      <button onClick={load}>Load</button>
     </div>
   );
 }
 ```
 
-Also exposes: `renameLayer`, `reorderLayer`, `moveElement`.
+For periodic auto-saving, use `AutoSave` from `@fieldnotes/core` — it debounces writes to `localStorage` and subscribes to the store and camera automatically:
 
-### `useHistory()`
+```tsx
+import { AutoSave } from '@fieldnotes/core';
+
+// in onReady or a useEffect after useViewport():
+const autoSave = new AutoSave(viewport.store, viewport.camera, {
+  key: 'my-board',
+  layerManager: viewport.layerManager,
+});
+autoSave.start();
+// call autoSave.stop() on cleanup
+```
 
-Reactive undo/redo state:
+Pass `layerManager` — without it, saved boards lose their layer structure.
 
-```tsx
-import { useHistory } from '@fieldnotes/react';
+## Custom Tools
 
-function UndoRedo() {
-  const { canUndo, canRedo, undo, redo } = useHistory();
+Implement the `Tool` interface from `@fieldnotes/core` and register it via the `tools` prop. Hoist the array so instances are not recreated on every render:
 
-  return (
-    <div>
-      <button onClick={undo} disabled={!canUndo}>
-        Undo
-      </button>
-      <button onClick={redo} disabled={!canRedo}>
-        Redo
-      </button>
-    </div>
-  );
+```tsx
+import type { Tool, ToolContext, PointerState } from '@fieldnotes/core';
+import { createNote } from '@fieldnotes/core';
+
+export class StampTool implements Tool {
+  readonly name = 'stamp';
+
+  onPointerDown(state: PointerState, ctx: ToolContext): void {
+    const world = ctx.camera.screenToWorld({ x: state.x, y: state.y });
+    ctx.store.add(
+      createNote({
+        position: { x: world.x - 50, y: world.y - 25 },
+        size: { w: 100, h: 50 },
+        text: 'stamp',
+        layerId: ctx.activeLayerId ?? '',
+      }),
+    );
+    ctx.requestRender();
+  }
+
+  onPointerMove(_state: PointerState, _ctx: ToolContext): void {}
+  onPointerUp(_state: PointerState, _ctx: ToolContext): void {}
 }
 ```
 
-### `useElements(type?)`
-
-Reactive element list — re-renders when elements are added, removed, or updated:
+Register alongside the built-in tools:
 
 ```tsx
-import { useElements } from '@fieldnotes/react';
+import { HandTool, SelectTool } from '@fieldnotes/core';
+import { StampTool } from './StampTool';
 
-function ElementCount() {
-  const elements = useElements();
-  const notes = useElements('note');
+// Hoisted — stable reference across renders
+const TOOLS = [new HandTool(), new SelectTool(), new StampTool()];
 
+function App() {
+  const [tool, setTool] = useState('select');
   return (
-    <span>
-      {notes.length} notes / {elements.length} total
-    </span>
+    <FieldNotesCanvas tools={TOOLS} tool={tool} onToolChange={setTool} style={...}>
+      <Toolbar tool={tool} onSelect={setTool} />
+    </FieldNotesCanvas>
   );
 }
 ```
 
-Pass an element type (`'note'`, `'stroke'`, `'arrow'`, etc.) to filter.
+## Events
 
-### `useCamera()`
+### `onReady`
 
-Reactive camera state (position + zoom) — re-renders on pan/zoom:
+Fires once after the `Viewport` is created and tools are registered. Use it for imperative setup that can't wait for a child hook:
 
 ```tsx
-import { useCamera } from '@fieldnotes/react';
-
-function CameraInfo() {
-  const { x, y, zoom } = useCamera();
-
-  return (
-    <span>
-      {zoom.toFixed(2)}x at ({x.toFixed(0)}, {y.toFixed(0)})
-    </span>
-  );
-}
+<FieldNotesCanvas
+  tools={TOOLS}
+  onReady={(viewport) => {
+    const saved = localStorage.getItem('board');
+    if (saved) viewport.loadJSON(saved);
+  }}
+  style={{ width: '100%', height: '100%' }}
+/>
 ```
 
-### `useViewport()`
+### `onToolChange`
 
-Access the core `Viewport` instance for imperative operations not covered by the hooks above:
+Fires whenever the active tool changes — from the keyboard, the API, or the controlled `tool` prop. Pair with `useState` and memoize with `useCallback` when the function body is non-trivial:
 
 ```tsx
-import { useViewport } from '@fieldnotes/react';
+const [tool, setTool] = useState('select');
 
-function ExportButton() {
-  const viewport = useViewport();
-
-  return <button onClick={() => viewport.exportImage()}>Export PNG</button>;
-}
+<FieldNotesCanvas tool={tool} onToolChange={setTool} tools={TOOLS} style={...} />
 ```
 
-## Component API
+### `options.onImageError`
 
-### `<FieldNotesCanvas>`
+Called when an image element fails to load. Receives `{ src: string; elementIds: string[] }` — the source URL and all element IDs that reference it:
 
-| Prop          | Type                           | Description                             |
-| ------------- | ------------------------------ | --------------------------------------- |
-| `options`     | `ViewportOptions`              | Camera and background config            |
-| `tools`       | `Tool[]`                       | Tools to register on mount              |
-| `defaultTool` | `string`                       | Tool to activate on mount               |
-| `className`   | `string`                       | CSS class for the container div         |
-| `style`       | `CSSProperties`                | Inline styles for the container div     |
-| `onReady`     | `(viewport: Viewport) => void` | Called after Viewport is created        |
-| `children`    | `ReactNode`                    | Child components (have access to hooks) |
-| `ref`         | `Ref<FieldNotesCanvasRef>`     | Exposes `{ viewport }`                  |
+```tsx
+<FieldNotesCanvas
+  tools={TOOLS}
+  options={{
+    onImageError: ({ src, elementIds }) => {
+      console.warn(`Image failed: ${src}`, elementIds);
+    },
+  }}
+  style={{ width: '100%', height: '100%' }}
+/>
+```
 
-### `<CanvasElement>`
+### `options.onDrop`
 
-| Prop       | Type                       | Default              | Description                        |
-| ---------- | -------------------------- | -------------------- | ---------------------------------- |
-| `position` | `{ x: number; y: number }` | required             | World-space position               |
-| `size`     | `{ w: number; h: number }` | `{ w: 200, h: 150 }` | Element size in world-space pixels |
-| `children` | `ReactNode`                | required             | React content to render on canvas  |
+Fires for **every** drop event on the canvas surface. Providing this callback replaces the built-in image-drop handling entirely — if you want images to work, handle them yourself. Receives the original `DragEvent` and the world-space drop position:
 
-Position and size updates are reactive — change the props and the element moves/resizes on the canvas.
+```tsx
+<FieldNotesCanvas
+  tools={TOOLS}
+  options={{
+    onDrop: (event, worldPosition) => {
+      const url = event.dataTransfer?.getData('text/uri-list');
+      if (url) {
+        // add your own image element at worldPosition
+      }
+    },
+  }}
+  style={{ width: '100%', height: '100%' }}
+/>
+```
 
-## Accessing the Viewport Directly
+## Escape Hatch
 
-For advanced use cases, use a ref:
+`useViewport()` returns the raw `Viewport` instance for anything not covered by the hooks above. A `ref` on `<FieldNotesCanvas>` gives the same access outside of child components:
 
 ```tsx
 import { useRef } from 'react';
@@ -282,20 +347,17 @@ import { FieldNotesCanvas, type FieldNotesCanvasRef } from '@fieldnotes/react';
 function App() {
   const canvasRef = useRef<FieldNotesCanvasRef>(null);
 
-  const exportState = () => {
-    const json = canvasRef.current?.viewport?.exportJSON();
-    console.log(json);
-  };
-
   return (
     <>
       <FieldNotesCanvas ref={canvasRef} style={{ width: '100vw', height: '100vh' }} />
-      <button onClick={exportState}>Export</button>
+      <button onClick={() => canvasRef.current?.viewport?.fitToContent()}>Fit to content</button>
     </>
   );
 }
 ```
 
+See the [core README](../core/README.md) for the full `Viewport` API — `exportJSON`/`loadJSON`, `fitToContent`, `shortcuts.rebind`, `setSnapToGrid`, and more.
+
 ## Versioning
 
 `@fieldnotes/core` and `@fieldnotes/react` are versioned independently. The react

package/dist/index.cjs

@@ -44,7 +44,18 @@ var ViewportContext = (0, import_react.createContext)(null);
 // src/field-notes-canvas.tsx
 var import_jsx_runtime = require("react/jsx-runtime");
 var FieldNotesCanvas = (0, import_react2.forwardRef)(
-  function FieldNotesCanvas2({ options, tools, defaultTool, className, style, children, onReady }, ref) {
+  function FieldNotesCanvas2({
+    options,
+    tools,
+    defaultTool,
+    tool,
+    onToolChange,
+    snapToGrid,
+    className,
+    style,
+    children,
+    onReady
+  }, ref) {
     const containerRef = (0, import_react2.useRef)(null);
     const [viewport, setViewport] = (0, import_react2.useState)(null);
     (0, import_react2.useImperativeHandle)(ref, () => ({ viewport }), [viewport]);
@@ -53,12 +64,13 @@ var FieldNotesCanvas = (0, import_react2.forwardRef)(
       if (!el) return;
       const vp = new import_core.Viewport(el, options);
       if (tools) {
-        for (const tool of tools) {
-          vp.toolManager.register(tool);
+        for (const t of tools) {
+          vp.toolManager.register(t);
         }
       }
-      if (defaultTool) {
-        vp.toolManager.setTool(defaultTool, vp.toolContext);
+      const initialTool = tool ?? defaultTool;
+      if (initialTool) {
+        vp.setTool(initialTool);
       }
       setViewport(vp);
       onReady?.(vp);
@@ -67,6 +79,28 @@ var FieldNotesCanvas = (0, import_react2.forwardRef)(
         setViewport(null);
       };
     }, []);
+    (0, import_react2.useEffect)(() => {
+      if (!viewport || tool === void 0) return;
+      if (viewport.toolManager.activeTool?.name !== tool) {
+        viewport.setTool(tool);
+      }
+    }, [viewport, tool]);
+    (0, import_react2.useEffect)(() => {
+      if (!viewport || !onToolChange) return;
+      return viewport.toolManager.onChange(onToolChange);
+    }, [viewport, onToolChange]);
+    (0, import_react2.useEffect)(() => {
+      if (!viewport || snapToGrid === void 0) return;
+      viewport.setSnapToGrid(snapToGrid);
+    }, [viewport, snapToGrid]);
+    (0, import_react2.useEffect)(() => {
+      if (!viewport || !tools) return;
+      for (const t of tools) {
+        if (!viewport.toolManager.getTool(t.name)) {
+          viewport.toolManager.register(t);
+        }
+      }
+    }, [viewport, tools]);
     return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { ref: containerRef, className, style, children: viewport && /* @__PURE__ */ (0, import_jsx_runtime.jsx)(ViewportContext.Provider, { value: viewport, children }) });
   }
 );
@@ -127,15 +161,12 @@ var import_react5 = require("react");
 function useActiveTool() {
   const viewport = useViewport();
   const subscribe = (0, import_react5.useCallback)(
-    (onStoreChange) => viewport.toolManager.onChange(() => onStoreChange()),
+    (onStoreChange) => viewport.toolManager.onChange(onStoreChange),
     [viewport]
   );
   const getSnapshot = (0, import_react5.useCallback)(() => viewport.toolManager.activeTool?.name ?? "", [viewport]);
   const toolName = (0, import_react5.useSyncExternalStore)(subscribe, getSnapshot);
-  const setTool = (0, import_react5.useCallback)(
-    (name) => viewport.toolManager.setTool(name, viewport.toolContext),
-    [viewport]
-  );
+  const setTool = (0, import_react5.useCallback)((name) => viewport.setTool(name), [viewport]);
   return [toolName, setTool];
 }
 
@@ -324,22 +355,47 @@ function useHistory() {
 
 // src/hooks/use-elements.ts
 var import_react10 = require("react");
-function useElements(type) {
+function shallowEqual2(a, b) {
+  if (Object.is(a, b)) return true;
+  if (Array.isArray(a) && Array.isArray(b)) {
+    return a.length === b.length && a.every((v, i) => Object.is(v, b[i]));
+  }
+  if (typeof a === "object" && a !== null && typeof b === "object" && b !== null && !Array.isArray(a) && !Array.isArray(b)) {
+    const ka = Object.keys(a);
+    const kb = Object.keys(b);
+    return ka.length === kb.length && ka.every(
+      (k) => k in b && Object.is(a[k], b[k])
+    );
+  }
+  return false;
+}
+function useElements(arg, isEqual) {
   const viewport = useViewport();
   const cachedRef = (0, import_react10.useRef)([]);
+  const selectedRef = (0, import_react10.useRef)(null);
   const subscribe = (0, import_react10.useCallback)(
     (onStoreChange) => viewport.store.onChange(onStoreChange),
     [viewport]
   );
   const getSnapshot = (0, import_react10.useCallback)(() => {
-    const next = type ? viewport.store.getElementsByType(type) : viewport.store.getAll();
+    if (typeof arg === "function") {
+      const next2 = arg(viewport.store.getAll());
+      const prev = selectedRef.current;
+      const equal = isEqual ?? shallowEqual2;
+      if (prev !== null && equal(prev.value, next2)) {
+        return prev.value;
+      }
+      selectedRef.current = { value: next2 };
+      return next2;
+    }
+    const next = arg ? viewport.store.getElementsByType(arg) : viewport.store.getAll();
     const cached = cachedRef.current;
     if (cached.length === next.length && cached.every((el, i) => el === next[i])) {
       return cached;
     }
     cachedRef.current = next;
     return next;
-  }, [viewport, type]);
+  }, [viewport, arg, isEqual]);
   return (0, import_react10.useSyncExternalStore)(subscribe, getSnapshot);
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/field-notes-canvas.tsx","../src/context.ts","../src/canvas-element.tsx","../src/hooks/use-viewport.ts","../src/hooks/use-active-tool.ts","../src/hooks/use-camera.ts","../src/hooks/use-tool-options.ts","../src/hooks/use-layers.ts","../src/hooks/use-history.ts","../src/hooks/use-elements.ts"],"sourcesContent":["export { FieldNotesCanvas } from './field-notes-canvas';\r\nexport type { FieldNotesCanvasProps, FieldNotesCanvasRef } from './field-notes-canvas';\r\nexport { CanvasElement } from './canvas-element';\r\nexport type { CanvasElementProps } from './canvas-element';\r\nexport {\r\n  useViewport,\r\n  useActiveTool,\r\n  useCamera,\r\n  useToolOptions,\r\n  useLayers,\r\n  useHistory,\r\n  useElements,\r\n} from './hooks';\r\nexport type { CameraState, UseLayersResult, UseHistoryResult } from './hooks';\r\nexport { ViewportContext } from './context';\r\n","import {\r\n  useRef,\r\n  useEffect,\r\n  useState,\r\n  forwardRef,\r\n  useImperativeHandle,\r\n  type ReactNode,\r\n  type CSSProperties,\r\n} from 'react';\r\nimport { Viewport } from '@fieldnotes/core';\r\nimport type { ViewportOptions, Tool } from '@fieldnotes/core';\r\nimport { ViewportContext } from './context';\r\n\r\nexport interface FieldNotesCanvasProps {\r\n  options?: ViewportOptions;\r\n  tools?: Tool[];\r\n  defaultTool?: string;\r\n  className?: string;\r\n  style?: CSSProperties;\r\n  children?: ReactNode;\r\n  onReady?: (viewport: Viewport) => void;\r\n}\r\n\r\nexport interface FieldNotesCanvasRef {\r\n  viewport: Viewport | null;\r\n}\r\n\r\nexport const FieldNotesCanvas = forwardRef<FieldNotesCanvasRef, FieldNotesCanvasProps>(\r\n  function FieldNotesCanvas(\r\n    { options, tools, defaultTool, className, style, children, onReady },\r\n    ref,\r\n  ) {\r\n    const containerRef = useRef<HTMLDivElement>(null);\r\n    const [viewport, setViewport] = useState<Viewport | null>(null);\r\n\r\n    useImperativeHandle(ref, () => ({ viewport }), [viewport]);\r\n\r\n    useEffect(() => {\r\n      const el = containerRef.current;\r\n      if (!el) return;\r\n\r\n      const vp = new Viewport(el, options);\r\n\r\n      if (tools) {\r\n        for (const tool of tools) {\r\n          vp.toolManager.register(tool);\r\n        }\r\n      }\r\n\r\n      if (defaultTool) {\r\n        vp.toolManager.setTool(defaultTool, vp.toolContext);\r\n      }\r\n\r\n      setViewport(vp);\r\n      onReady?.(vp);\r\n\r\n      return () => {\r\n        vp.destroy();\r\n        setViewport(null);\r\n      };\r\n    }, []);\r\n\r\n    return (\r\n      <div ref={containerRef} className={className} style={style}>\r\n        {viewport && (\r\n          <ViewportContext.Provider value={viewport}>{children}</ViewportContext.Provider>\r\n        )}\r\n      </div>\r\n    );\r\n  },\r\n);\r\n","import { createContext } from 'react';\r\nimport type { Viewport } from '@fieldnotes/core';\r\n\r\nexport const ViewportContext = createContext<Viewport | null>(null);\r\n","import { useEffect, useRef, useState, type ReactNode } from 'react';\r\nimport { createPortal } from 'react-dom';\r\nimport { useViewport } from './hooks/use-viewport';\r\n\r\nexport interface CanvasElementProps {\r\n  position: { x: number; y: number };\r\n  size?: { w: number; h: number };\r\n  children: ReactNode;\r\n}\r\n\r\nexport function CanvasElement({ position, size, children }: CanvasElementProps) {\r\n  const viewport = useViewport();\r\n  const [portalTarget, setPortalTarget] = useState<HTMLElement | null>(null);\r\n  const elementIdRef = useRef<string | null>(null);\r\n\r\n  useEffect(() => {\r\n    const container = document.createElement('div');\r\n    Object.assign(container.style, {\r\n      width: '100%',\r\n      height: '100%',\r\n    });\r\n\r\n    // Append to domLayer immediately so portal children are queryable in the document\r\n    // before the viewport render loop fires via requestAnimationFrame.\r\n    viewport.domLayer.appendChild(container);\r\n\r\n    const id = viewport.addHtmlElement(container, position, size);\r\n    elementIdRef.current = id;\r\n    setPortalTarget(container);\r\n\r\n    return () => {\r\n      if (elementIdRef.current) {\r\n        viewport.store.remove(elementIdRef.current);\r\n        viewport.requestRender();\r\n        elementIdRef.current = null;\r\n      }\r\n      setPortalTarget(null);\r\n    };\r\n  }, [viewport]);\r\n\r\n  useEffect(() => {\r\n    const id = elementIdRef.current;\r\n    if (!id) return;\r\n    viewport.store.update(id, { position });\r\n    if (size) {\r\n      viewport.store.update(id, { size });\r\n    }\r\n    viewport.requestRender();\r\n  }, [viewport, position.x, position.y, size?.w, size?.h]);\r\n\r\n  if (!portalTarget) return null;\r\n  return createPortal(children, portalTarget);\r\n}\r\n","import { useContext } from 'react';\r\nimport type { Viewport } from '@fieldnotes/core';\r\nimport { ViewportContext } from '../context';\r\n\r\nexport function useViewport(): Viewport {\r\n  const viewport = useContext(ViewportContext);\r\n  if (!viewport) {\r\n    throw new Error('useViewport must be used inside <FieldNotesCanvas>');\r\n  }\r\n  return viewport;\r\n}\r\n","import { useCallback, useSyncExternalStore } from 'react';\r\nimport { useViewport } from './use-viewport';\r\n\r\nexport function useActiveTool(): [toolName: string, setTool: (name: string) => void] {\r\n  const viewport = useViewport();\r\n\r\n  const subscribe = useCallback(\r\n    (onStoreChange: () => void) => viewport.toolManager.onChange(() => onStoreChange()),\r\n    [viewport],\r\n  );\r\n\r\n  const getSnapshot = useCallback(() => viewport.toolManager.activeTool?.name ?? '', [viewport]);\r\n\r\n  const toolName = useSyncExternalStore(subscribe, getSnapshot);\r\n\r\n  const setTool = useCallback(\r\n    (name: string) => viewport.toolManager.setTool(name, viewport.toolContext),\r\n    [viewport],\r\n  );\r\n\r\n  return [toolName, setTool];\r\n}\r\n","import { useCallback, useRef, useSyncExternalStore } from 'react';\r\nimport { useViewport } from './use-viewport';\r\n\r\nexport interface CameraState {\r\n  x: number;\r\n  y: number;\r\n  zoom: number;\r\n}\r\n\r\nexport function useCamera(): CameraState {\r\n  const viewport = useViewport();\r\n  const cachedRef = useRef<CameraState>({ x: 0, y: 0, zoom: 1 });\r\n\r\n  const subscribe = useCallback(\r\n    (onStoreChange: () => void) => viewport.camera.onChange(onStoreChange),\r\n    [viewport],\r\n  );\r\n\r\n  const getSnapshot = useCallback((): CameraState => {\r\n    const { position, zoom } = viewport.camera;\r\n    const cached = cachedRef.current;\r\n    if (cached.x === position.x && cached.y === position.y && cached.zoom === zoom) {\r\n      return cached;\r\n    }\r\n    const next = { x: position.x, y: position.y, zoom };\r\n    cachedRef.current = next;\r\n    return next;\r\n  }, [viewport]);\r\n\r\n  return useSyncExternalStore(subscribe, getSnapshot);\r\n}\r\n","import { useCallback, useRef, useSyncExternalStore } from 'react';\r\nimport { useViewport } from './use-viewport';\r\n\r\nfunction noop() {\r\n  /* unsubscribe placeholder */\r\n}\r\n\r\nexport function useToolOptions<T extends Record<string, unknown>>(\r\n  toolName: string,\r\n): [options: T | null, setOptions: (partial: Partial<T>) => void] {\r\n  const viewport = useViewport();\r\n  const cachedRef = useRef<T | null>(null);\r\n\r\n  const subscribe = useCallback(\r\n    (onStoreChange: () => void) => {\r\n      const tool = viewport.toolManager.getTool(toolName);\r\n      if (!tool?.onOptionsChange) return noop;\r\n      return tool.onOptionsChange(onStoreChange);\r\n    },\r\n    [viewport, toolName],\r\n  );\r\n\r\n  const getSnapshot = useCallback((): T | null => {\r\n    const tool = viewport.toolManager.getTool(toolName);\r\n    if (!tool?.getOptions) return null;\r\n    const next = tool.getOptions() as T;\r\n    const cached = cachedRef.current;\r\n    if (cached && shallowEqual(cached, next)) return cached;\r\n    cachedRef.current = next;\r\n    return next;\r\n  }, [viewport, toolName]);\r\n\r\n  const options = useSyncExternalStore(subscribe, getSnapshot);\r\n\r\n  const setOptions = useCallback(\r\n    (partial: Partial<T>) => {\r\n      const tool = viewport.toolManager.getTool(toolName);\r\n      tool?.setOptions?.(partial as Record<string, unknown>);\r\n    },\r\n    [viewport, toolName],\r\n  );\r\n\r\n  return [options, setOptions];\r\n}\r\n\r\nfunction shallowEqual(a: Record<string, unknown>, b: Record<string, unknown>): boolean {\r\n  const keysA = Object.keys(a);\r\n  const keysB = Object.keys(b);\r\n  if (keysA.length !== keysB.length) return false;\r\n  for (const key of keysA) {\r\n    const valA = a[key];\r\n    const valB = b[key];\r\n    if (valA === valB) continue;\r\n    if (\r\n      typeof valA === 'object' &&\r\n      valA !== null &&\r\n      typeof valB === 'object' &&\r\n      valB !== null &&\r\n      !Array.isArray(valA) &&\r\n      !Array.isArray(valB)\r\n    ) {\r\n      const objA = valA as Record<string, unknown>;\r\n      const objB = valB as Record<string, unknown>;\r\n      const innerKeys = Object.keys(objA);\r\n      if (\r\n        innerKeys.length === Object.keys(objB).length &&\r\n        innerKeys.every((k) => objA[k] === objB[k])\r\n      ) {\r\n        continue;\r\n      }\r\n    }\r\n    return false;\r\n  }\r\n  return true;\r\n}\r\n","import { useCallback, useRef, useSyncExternalStore } from 'react';\r\nimport type { Layer } from '@fieldnotes/core';\r\nimport { useViewport } from './use-viewport';\r\n\r\ninterface LayersSnapshot {\r\n  layers: Layer[];\r\n  activeLayerId: string;\r\n}\r\n\r\nexport interface UseLayersResult {\r\n  layers: Layer[];\r\n  activeLayerId: string;\r\n  createLayer: (name?: string) => Layer;\r\n  removeLayer: (id: string) => void;\r\n  renameLayer: (id: string, name: string) => void;\r\n  reorderLayer: (id: string, newOrder: number) => void;\r\n  setVisible: (id: string, visible: boolean) => void;\r\n  setLocked: (id: string, locked: boolean) => void;\r\n  setOpacity: (id: string, opacity: number) => void;\r\n  setActiveLayer: (id: string) => void;\r\n  moveElement: (elementId: string, layerId: string) => void;\r\n}\r\n\r\nexport function useLayers(): UseLayersResult {\r\n  const viewport = useViewport();\r\n  const cachedRef = useRef<LayersSnapshot>({ layers: [], activeLayerId: '' });\r\n\r\n  const subscribe = useCallback(\r\n    (onStoreChange: () => void) => viewport.layerManager.on('change', onStoreChange),\r\n    [viewport],\r\n  );\r\n\r\n  const getSnapshot = useCallback((): LayersSnapshot => {\r\n    const layers = viewport.layerManager.getLayers();\r\n    const activeLayerId = viewport.layerManager.activeLayerId;\r\n    const cached = cachedRef.current;\r\n    if (\r\n      cached.activeLayerId === activeLayerId &&\r\n      cached.layers.length === layers.length &&\r\n      cached.layers.every((l, i) => {\r\n        const next = layers[i];\r\n        return (\r\n          next !== undefined &&\r\n          l.id === next.id &&\r\n          l.name === next.name &&\r\n          l.visible === next.visible &&\r\n          l.locked === next.locked &&\r\n          l.order === next.order &&\r\n          l.opacity === next.opacity\r\n        );\r\n      })\r\n    ) {\r\n      return cached;\r\n    }\r\n    const next = { layers, activeLayerId };\r\n    cachedRef.current = next;\r\n    return next;\r\n  }, [viewport]);\r\n\r\n  const snapshot = useSyncExternalStore(subscribe, getSnapshot);\r\n\r\n  const createLayer = useCallback(\r\n    (name?: string) => viewport.layerManager.createLayer(name),\r\n    [viewport],\r\n  );\r\n\r\n  const removeLayer = useCallback(\r\n    (id: string) => viewport.layerManager.removeLayer(id),\r\n    [viewport],\r\n  );\r\n\r\n  const renameLayer = useCallback(\r\n    (id: string, name: string) => viewport.layerManager.renameLayer(id, name),\r\n    [viewport],\r\n  );\r\n\r\n  const reorderLayer = useCallback(\r\n    (id: string, newOrder: number) => viewport.layerManager.reorderLayer(id, newOrder),\r\n    [viewport],\r\n  );\r\n\r\n  const setVisible = useCallback(\r\n    (id: string, visible: boolean) => viewport.layerManager.setLayerVisible(id, visible),\r\n    [viewport],\r\n  );\r\n\r\n  const setLocked = useCallback(\r\n    (id: string, locked: boolean) => viewport.layerManager.setLayerLocked(id, locked),\r\n    [viewport],\r\n  );\r\n\r\n  const setOpacity = useCallback(\r\n    (id: string, opacity: number) => viewport.layerManager.setLayerOpacity(id, opacity),\r\n    [viewport],\r\n  );\r\n\r\n  const setActiveLayer = useCallback(\r\n    (id: string) => viewport.layerManager.setActiveLayer(id),\r\n    [viewport],\r\n  );\r\n\r\n  const moveElement = useCallback(\r\n    (elementId: string, layerId: string) =>\r\n      viewport.layerManager.moveElementToLayer(elementId, layerId),\r\n    [viewport],\r\n  );\r\n\r\n  return {\r\n    layers: snapshot.layers,\r\n    activeLayerId: snapshot.activeLayerId,\r\n    createLayer,\r\n    removeLayer,\r\n    renameLayer,\r\n    reorderLayer,\r\n    setVisible,\r\n    setLocked,\r\n    setOpacity,\r\n    setActiveLayer,\r\n    moveElement,\r\n  };\r\n}\r\n","import { useCallback, useRef, useSyncExternalStore } from 'react';\r\nimport { useViewport } from './use-viewport';\r\n\r\ninterface HistorySnapshot {\r\n  canUndo: boolean;\r\n  canRedo: boolean;\r\n}\r\n\r\nexport interface UseHistoryResult {\r\n  canUndo: boolean;\r\n  canRedo: boolean;\r\n  undo: () => void;\r\n  redo: () => void;\r\n}\r\n\r\nexport function useHistory(): UseHistoryResult {\r\n  const viewport = useViewport();\r\n  const cachedRef = useRef<HistorySnapshot>({ canUndo: false, canRedo: false });\r\n\r\n  const subscribe = useCallback(\r\n    (onStoreChange: () => void) => viewport.history.onChange(onStoreChange),\r\n    [viewport],\r\n  );\r\n\r\n  const getSnapshot = useCallback((): HistorySnapshot => {\r\n    const canUndo = viewport.history.canUndo;\r\n    const canRedo = viewport.history.canRedo;\r\n    const cached = cachedRef.current;\r\n    if (cached.canUndo === canUndo && cached.canRedo === canRedo) {\r\n      return cached;\r\n    }\r\n    const next = { canUndo, canRedo };\r\n    cachedRef.current = next;\r\n    return next;\r\n  }, [viewport]);\r\n\r\n  const snapshot = useSyncExternalStore(subscribe, getSnapshot);\r\n\r\n  const undo = useCallback(() => viewport.undo(), [viewport]);\r\n  const redo = useCallback(() => viewport.redo(), [viewport]);\r\n\r\n  return {\r\n    canUndo: snapshot.canUndo,\r\n    canRedo: snapshot.canRedo,\r\n    undo,\r\n    redo,\r\n  };\r\n}\r\n","import { useCallback, useRef, useSyncExternalStore } from 'react';\r\nimport type { CanvasElement, ElementType } from '@fieldnotes/core';\r\nimport { useViewport } from './use-viewport';\r\n\r\nexport function useElements(): CanvasElement[];\r\nexport function useElements<T extends ElementType>(type: T): Extract<CanvasElement, { type: T }>[];\r\nexport function useElements(type?: ElementType): CanvasElement[] {\r\n  const viewport = useViewport();\r\n  const cachedRef = useRef<CanvasElement[]>([]);\r\n\r\n  const subscribe = useCallback(\r\n    (onStoreChange: () => void) => viewport.store.onChange(onStoreChange),\r\n    [viewport],\r\n  );\r\n\r\n  const getSnapshot = useCallback((): CanvasElement[] => {\r\n    const next = type ? viewport.store.getElementsByType(type) : viewport.store.getAll();\r\n    const cached = cachedRef.current;\r\n    if (cached.length === next.length && cached.every((el, i) => el === next[i])) {\r\n      return cached;\r\n    }\r\n    cachedRef.current = next;\r\n    return next;\r\n  }, [viewport, type]);\r\n\r\n  return useSyncExternalStore(subscribe, getSnapshot);\r\n}\r\n"],"mappings":"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","names":["import_react","FieldNotesCanvas","import_react","import_react","import_react","import_react","import_react","import_react","next","import_react","import_react"]}
+{"version":3,"sources":["../src/index.ts","../src/field-notes-canvas.tsx","../src/context.ts","../src/canvas-element.tsx","../src/hooks/use-viewport.ts","../src/hooks/use-active-tool.ts","../src/hooks/use-camera.ts","../src/hooks/use-tool-options.ts","../src/hooks/use-layers.ts","../src/hooks/use-history.ts","../src/hooks/use-elements.ts"],"sourcesContent":["export { FieldNotesCanvas } from './field-notes-canvas';\r\nexport type { FieldNotesCanvasProps, FieldNotesCanvasRef } from './field-notes-canvas';\r\nexport { CanvasElement } from './canvas-element';\r\nexport type { CanvasElementProps } from './canvas-element';\r\nexport {\r\n  useViewport,\r\n  useActiveTool,\r\n  useCamera,\r\n  useToolOptions,\r\n  useLayers,\r\n  useHistory,\r\n  useElements,\r\n} from './hooks';\r\nexport type { CameraState, UseLayersResult, UseHistoryResult } from './hooks';\r\nexport { ViewportContext } from './context';\r\n","import {\n  useRef,\n  useEffect,\n  useState,\n  forwardRef,\n  useImperativeHandle,\n  type ReactNode,\n  type CSSProperties,\n} from 'react';\nimport { Viewport } from '@fieldnotes/core';\nimport type { ViewportOptions, Tool } from '@fieldnotes/core';\nimport { ViewportContext } from './context';\n\nexport interface FieldNotesCanvasProps {\n  /** Constructor-only: changes after mount are ignored (the canvas is stateful). */\n  options?: ViewportOptions;\n  /**\n   * Reactive (append-only): tools present here are registered; removal is not supported.\n   * Hoist the array out of render — inline arrays reconstruct Tool instances and re-run\n   * registration on every render.\n   */\n  tools?: Tool[];\n  /** Uncontrolled initial tool. Ignored when `tool` is set. */\n  defaultTool?: string;\n  /** Controlled active tool. Pair with `onToolChange`. */\n  tool?: string;\n  /**\n   * Fires whenever the active tool changes (keyboard, API, or `tool` prop).\n   * Memoize with useCallback to avoid re-subscribing each render.\n   */\n  onToolChange?: (name: string) => void;\n  /** Reactive: toggles grid snapping. */\n  snapToGrid?: boolean;\n  className?: string;\n  style?: CSSProperties;\n  children?: ReactNode;\n  onReady?: (viewport: Viewport) => void;\n}\n\nexport interface FieldNotesCanvasRef {\n  viewport: Viewport | null;\n}\n\nexport const FieldNotesCanvas = forwardRef<FieldNotesCanvasRef, FieldNotesCanvasProps>(\n  function FieldNotesCanvas(\n    {\n      options,\n      tools,\n      defaultTool,\n      tool,\n      onToolChange,\n      snapToGrid,\n      className,\n      style,\n      children,\n      onReady,\n    },\n    ref,\n  ) {\n    const containerRef = useRef<HTMLDivElement>(null);\n    const [viewport, setViewport] = useState<Viewport | null>(null);\n\n    useImperativeHandle(ref, () => ({ viewport }), [viewport]);\n\n    useEffect(() => {\n      const el = containerRef.current;\n      if (!el) return;\n\n      const vp = new Viewport(el, options);\n\n      if (tools) {\n        for (const t of tools) {\n          vp.toolManager.register(t);\n        }\n      }\n\n      const initialTool = tool ?? defaultTool;\n      if (initialTool) {\n        vp.setTool(initialTool);\n      }\n\n      setViewport(vp);\n      onReady?.(vp);\n\n      return () => {\n        vp.destroy();\n        setViewport(null);\n      };\n      // Constructor effect: options/tools/defaultTool are mount-only by design.\n    }, []);\n\n    useEffect(() => {\n      if (!viewport || tool === undefined) return;\n      if (viewport.toolManager.activeTool?.name !== tool) {\n        viewport.setTool(tool);\n      }\n    }, [viewport, tool]);\n\n    useEffect(() => {\n      if (!viewport || !onToolChange) return;\n      return viewport.toolManager.onChange(onToolChange);\n    }, [viewport, onToolChange]);\n\n    useEffect(() => {\n      if (!viewport || snapToGrid === undefined) return;\n      viewport.setSnapToGrid(snapToGrid);\n    }, [viewport, snapToGrid]);\n\n    useEffect(() => {\n      if (!viewport || !tools) return;\n      for (const t of tools) {\n        if (!viewport.toolManager.getTool(t.name)) {\n          viewport.toolManager.register(t);\n        }\n      }\n    }, [viewport, tools]);\n\n    return (\n      <div ref={containerRef} className={className} style={style}>\n        {viewport && (\n          <ViewportContext.Provider value={viewport}>{children}</ViewportContext.Provider>\n        )}\n      </div>\n    );\n  },\n);\n","import { createContext } from 'react';\r\nimport type { Viewport } from '@fieldnotes/core';\r\n\r\nexport const ViewportContext = createContext<Viewport | null>(null);\r\n","import { useEffect, useRef, useState, type ReactNode } from 'react';\nimport { createPortal } from 'react-dom';\nimport { useViewport } from './hooks/use-viewport';\n\n/** Props for {@link CanvasElement}. */\nexport interface CanvasElementProps {\n  /** Canvas-space position of the element's top-left corner. */\n  position: { x: number; y: number };\n  /** Optional fixed size; omit to let the element size to its content. */\n  size?: { w: number; h: number };\n  children: ReactNode;\n}\n\n/**\n * Renders a React subtree as an HTML element embedded in the canvas coordinate space.\n * Must be used inside a `<FieldNotesCanvas>`.\n */\nexport function CanvasElement({ position, size, children }: CanvasElementProps) {\n  const viewport = useViewport();\n  const [portalTarget, setPortalTarget] = useState<HTMLElement | null>(null);\n  const elementIdRef = useRef<string | null>(null);\n\n  useEffect(() => {\n    const container = document.createElement('div');\n    Object.assign(container.style, {\n      width: '100%',\n      height: '100%',\n    });\n\n    // Append to domLayer immediately so portal children are queryable in the document\n    // before the viewport render loop fires via requestAnimationFrame.\n    viewport.domLayer.appendChild(container);\n\n    const id = viewport.addHtmlElement(container, position, size);\n    elementIdRef.current = id;\n    setPortalTarget(container);\n\n    return () => {\n      if (elementIdRef.current) {\n        viewport.store.remove(elementIdRef.current);\n        viewport.requestRender();\n        elementIdRef.current = null;\n      }\n      setPortalTarget(null);\n    };\n  }, [viewport]);\n\n  useEffect(() => {\n    const id = elementIdRef.current;\n    if (!id) return;\n    viewport.store.update(id, { position });\n    if (size) {\n      viewport.store.update(id, { size });\n    }\n    viewport.requestRender();\n  }, [viewport, position.x, position.y, size?.w, size?.h]);\n\n  if (!portalTarget) return null;\n  return createPortal(children, portalTarget);\n}\n","import { useContext } from 'react';\nimport type { Viewport } from '@fieldnotes/core';\nimport { ViewportContext } from '../context';\n\n/** The Viewport from the nearest `<FieldNotesCanvas>`. Throws outside one. */\nexport function useViewport(): Viewport {\n  const viewport = useContext(ViewportContext);\n  if (!viewport) {\n    throw new Error('useViewport must be used inside <FieldNotesCanvas>');\n  }\n  return viewport;\n}\n","import { useCallback, useSyncExternalStore } from 'react';\nimport { useViewport } from './use-viewport';\n\n/** `[activeToolName, setTool]` — re-renders on tool switches. */\nexport function useActiveTool(): [toolName: string, setTool: (name: string) => void] {\n  const viewport = useViewport();\n\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => viewport.toolManager.onChange(onStoreChange),\n    [viewport],\n  );\n\n  const getSnapshot = useCallback(() => viewport.toolManager.activeTool?.name ?? '', [viewport]);\n\n  const toolName = useSyncExternalStore(subscribe, getSnapshot);\n\n  const setTool = useCallback((name: string) => viewport.setTool(name), [viewport]);\n\n  return [toolName, setTool];\n}\n","import { useCallback, useRef, useSyncExternalStore } from 'react';\nimport { useViewport } from './use-viewport';\n\nexport interface CameraState {\n  x: number;\n  y: number;\n  zoom: number;\n}\n\n/** Current camera position and zoom level — re-renders whenever the camera moves or zoom changes. */\nexport function useCamera(): CameraState {\n  const viewport = useViewport();\n  const cachedRef = useRef<CameraState>({ x: 0, y: 0, zoom: 1 });\n\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => viewport.camera.onChange(onStoreChange),\n    [viewport],\n  );\n\n  const getSnapshot = useCallback((): CameraState => {\n    const { position, zoom } = viewport.camera;\n    const cached = cachedRef.current;\n    if (cached.x === position.x && cached.y === position.y && cached.zoom === zoom) {\n      return cached;\n    }\n    const next = { x: position.x, y: position.y, zoom };\n    cachedRef.current = next;\n    return next;\n  }, [viewport]);\n\n  return useSyncExternalStore(subscribe, getSnapshot);\n}\n","import { useCallback, useRef, useSyncExternalStore } from 'react';\nimport { useViewport } from './use-viewport';\n\nfunction noop() {\n  /* unsubscribe placeholder */\n}\n\n/**\n * `[options, setOptions]` for the named tool — re-renders when the tool's options change.\n * Returns `null` for options if the tool is not registered or does not expose options.\n */\nexport function useToolOptions<T extends Record<string, unknown>>(\n  toolName: string,\n): [options: T | null, setOptions: (partial: Partial<T>) => void] {\n  const viewport = useViewport();\n  const cachedRef = useRef<T | null>(null);\n\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => {\n      const tool = viewport.toolManager.getTool(toolName);\n      if (!tool?.onOptionsChange) return noop;\n      return tool.onOptionsChange(onStoreChange);\n    },\n    [viewport, toolName],\n  );\n\n  const getSnapshot = useCallback((): T | null => {\n    const tool = viewport.toolManager.getTool(toolName);\n    if (!tool?.getOptions) return null;\n    const next = tool.getOptions() as T;\n    const cached = cachedRef.current;\n    if (cached && shallowEqual(cached, next)) return cached;\n    cachedRef.current = next;\n    return next;\n  }, [viewport, toolName]);\n\n  const options = useSyncExternalStore(subscribe, getSnapshot);\n\n  const setOptions = useCallback(\n    (partial: Partial<T>) => {\n      const tool = viewport.toolManager.getTool(toolName);\n      tool?.setOptions?.(partial as Record<string, unknown>);\n    },\n    [viewport, toolName],\n  );\n\n  return [options, setOptions];\n}\n\nfunction shallowEqual(a: Record<string, unknown>, b: Record<string, unknown>): boolean {\n  const keysA = Object.keys(a);\n  const keysB = Object.keys(b);\n  if (keysA.length !== keysB.length) return false;\n  for (const key of keysA) {\n    const valA = a[key];\n    const valB = b[key];\n    if (valA === valB) continue;\n    if (\n      typeof valA === 'object' &&\n      valA !== null &&\n      typeof valB === 'object' &&\n      valB !== null &&\n      !Array.isArray(valA) &&\n      !Array.isArray(valB)\n    ) {\n      const objA = valA as Record<string, unknown>;\n      const objB = valB as Record<string, unknown>;\n      const innerKeys = Object.keys(objA);\n      if (\n        innerKeys.length === Object.keys(objB).length &&\n        innerKeys.every((k) => objA[k] === objB[k])\n      ) {\n        continue;\n      }\n    }\n    return false;\n  }\n  return true;\n}\n","import { useCallback, useRef, useSyncExternalStore } from 'react';\nimport type { Layer } from '@fieldnotes/core';\nimport { useViewport } from './use-viewport';\n\ninterface LayersSnapshot {\n  layers: Layer[];\n  activeLayerId: string;\n}\n\nexport interface UseLayersResult {\n  layers: Layer[];\n  activeLayerId: string;\n  createLayer: (name?: string) => Layer;\n  removeLayer: (id: string) => void;\n  renameLayer: (id: string, name: string) => void;\n  reorderLayer: (id: string, newOrder: number) => void;\n  setVisible: (id: string, visible: boolean) => void;\n  setLocked: (id: string, locked: boolean) => void;\n  setOpacity: (id: string, opacity: number) => void;\n  setActiveLayer: (id: string) => void;\n  moveElement: (elementId: string, layerId: string) => void;\n}\n\n/**\n * Current layer list and mutation helpers — re-renders whenever a layer is added, removed,\n * reordered, renamed, or its visibility/lock/opacity/active state changes.\n */\nexport function useLayers(): UseLayersResult {\n  const viewport = useViewport();\n  const cachedRef = useRef<LayersSnapshot>({ layers: [], activeLayerId: '' });\n\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => viewport.layerManager.on('change', onStoreChange),\n    [viewport],\n  );\n\n  const getSnapshot = useCallback((): LayersSnapshot => {\n    const layers = viewport.layerManager.getLayers();\n    const activeLayerId = viewport.layerManager.activeLayerId;\n    const cached = cachedRef.current;\n    if (\n      cached.activeLayerId === activeLayerId &&\n      cached.layers.length === layers.length &&\n      cached.layers.every((l, i) => {\n        const next = layers[i];\n        return (\n          next !== undefined &&\n          l.id === next.id &&\n          l.name === next.name &&\n          l.visible === next.visible &&\n          l.locked === next.locked &&\n          l.order === next.order &&\n          l.opacity === next.opacity\n        );\n      })\n    ) {\n      return cached;\n    }\n    const next = { layers, activeLayerId };\n    cachedRef.current = next;\n    return next;\n  }, [viewport]);\n\n  const snapshot = useSyncExternalStore(subscribe, getSnapshot);\n\n  const createLayer = useCallback(\n    (name?: string) => viewport.layerManager.createLayer(name),\n    [viewport],\n  );\n\n  const removeLayer = useCallback(\n    (id: string) => viewport.layerManager.removeLayer(id),\n    [viewport],\n  );\n\n  const renameLayer = useCallback(\n    (id: string, name: string) => viewport.layerManager.renameLayer(id, name),\n    [viewport],\n  );\n\n  const reorderLayer = useCallback(\n    (id: string, newOrder: number) => viewport.layerManager.reorderLayer(id, newOrder),\n    [viewport],\n  );\n\n  const setVisible = useCallback(\n    (id: string, visible: boolean) => viewport.layerManager.setLayerVisible(id, visible),\n    [viewport],\n  );\n\n  const setLocked = useCallback(\n    (id: string, locked: boolean) => viewport.layerManager.setLayerLocked(id, locked),\n    [viewport],\n  );\n\n  const setOpacity = useCallback(\n    (id: string, opacity: number) => viewport.layerManager.setLayerOpacity(id, opacity),\n    [viewport],\n  );\n\n  const setActiveLayer = useCallback(\n    (id: string) => viewport.layerManager.setActiveLayer(id),\n    [viewport],\n  );\n\n  const moveElement = useCallback(\n    (elementId: string, layerId: string) =>\n      viewport.layerManager.moveElementToLayer(elementId, layerId),\n    [viewport],\n  );\n\n  return {\n    layers: snapshot.layers,\n    activeLayerId: snapshot.activeLayerId,\n    createLayer,\n    removeLayer,\n    renameLayer,\n    reorderLayer,\n    setVisible,\n    setLocked,\n    setOpacity,\n    setActiveLayer,\n    moveElement,\n  };\n}\n","import { useCallback, useRef, useSyncExternalStore } from 'react';\nimport { useViewport } from './use-viewport';\n\ninterface HistorySnapshot {\n  canUndo: boolean;\n  canRedo: boolean;\n}\n\nexport interface UseHistoryResult {\n  canUndo: boolean;\n  canRedo: boolean;\n  undo: () => void;\n  redo: () => void;\n}\n\n/** `{ canUndo, canRedo, undo, redo }` — re-renders when undo/redo availability changes. */\nexport function useHistory(): UseHistoryResult {\n  const viewport = useViewport();\n  const cachedRef = useRef<HistorySnapshot>({ canUndo: false, canRedo: false });\n\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => viewport.history.onChange(onStoreChange),\n    [viewport],\n  );\n\n  const getSnapshot = useCallback((): HistorySnapshot => {\n    const canUndo = viewport.history.canUndo;\n    const canRedo = viewport.history.canRedo;\n    const cached = cachedRef.current;\n    if (cached.canUndo === canUndo && cached.canRedo === canRedo) {\n      return cached;\n    }\n    const next = { canUndo, canRedo };\n    cachedRef.current = next;\n    return next;\n  }, [viewport]);\n\n  const snapshot = useSyncExternalStore(subscribe, getSnapshot);\n\n  const undo = useCallback(() => viewport.undo(), [viewport]);\n  const redo = useCallback(() => viewport.redo(), [viewport]);\n\n  return {\n    canUndo: snapshot.canUndo,\n    canRedo: snapshot.canRedo,\n    undo,\n    redo,\n  };\n}\n","import { useCallback, useRef, useSyncExternalStore } from 'react';\nimport type { CanvasElement, ElementType } from '@fieldnotes/core';\nimport { useViewport } from './use-viewport';\n\nfunction shallowEqual(a: unknown, b: unknown): boolean {\n  if (Object.is(a, b)) return true;\n  if (Array.isArray(a) && Array.isArray(b)) {\n    return a.length === b.length && a.every((v, i) => Object.is(v, b[i]));\n  }\n  if (\n    typeof a === 'object' &&\n    a !== null &&\n    typeof b === 'object' &&\n    b !== null &&\n    !Array.isArray(a) &&\n    !Array.isArray(b)\n  ) {\n    const ka = Object.keys(a);\n    const kb = Object.keys(b);\n    return (\n      ka.length === kb.length &&\n      ka.every(\n        (k) =>\n          k in (b as Record<string, unknown>) &&\n          Object.is((a as Record<string, unknown>)[k], (b as Record<string, unknown>)[k]),\n      )\n    );\n  }\n  return false;\n}\n\n/** All elements; re-renders on every store mutation (use a selector for hot paths). */\nexport function useElements(): CanvasElement[];\n/** Elements of one type; re-renders on every store mutation. */\nexport function useElements<T extends ElementType>(type: T): Extract<CanvasElement, { type: T }>[];\n/**\n * Derived value; re-renders only when the selected value changes (per `isEqual`,\n * default: one-level shallow compare — arrays by index, plain objects by key, primitives by\n * Object.is). Keep the selector referentially stable (useCallback or module scope).\n *\n * Supply `isEqual` for deeper structures. Note: selectors returning nested fresh objects\n * (e.g. `els => els.map(e => ({ ...e.position }))`) still need a custom comparator because\n * the default only compares one level deep.\n */\nexport function useElements<R>(\n  selector: (elements: CanvasElement[]) => R,\n  isEqual?: (a: R, b: R) => boolean,\n): R;\nexport function useElements<R>(\n  arg?: ElementType | ((elements: CanvasElement[]) => R),\n  isEqual?: (a: R, b: R) => boolean,\n): CanvasElement[] | R {\n  const viewport = useViewport();\n  const cachedRef = useRef<CanvasElement[]>([]);\n  const selectedRef = useRef<{ value: R } | null>(null);\n\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => viewport.store.onChange(onStoreChange),\n    [viewport],\n  );\n\n  const getSnapshot = useCallback((): CanvasElement[] | R => {\n    if (typeof arg === 'function') {\n      const next = arg(viewport.store.getAll());\n      const prev = selectedRef.current;\n      const equal: (a: R, b: R) => boolean = isEqual ?? (shallowEqual as (a: R, b: R) => boolean);\n      if (prev !== null && equal(prev.value, next)) {\n        return prev.value;\n      }\n      selectedRef.current = { value: next };\n      return next;\n    }\n\n    const next = arg ? viewport.store.getElementsByType(arg) : viewport.store.getAll();\n    const cached = cachedRef.current;\n    if (cached.length === next.length && cached.every((el, i) => el === next[i])) {\n      return cached;\n    }\n    cachedRef.current = next;\n    return next;\n  }, [viewport, arg, isEqual]);\n\n  return useSyncExternalStore(subscribe, getSnapshot);\n}\n"],"mappings":"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","names":["import_react","FieldNotesCanvas","import_react","import_react","import_react","import_react","import_react","import_react","next","import_react","import_react","shallowEqual","next"]}

package/dist/index.d.cts

@@ -3,9 +3,25 @@ import { CSSProperties, ReactNode } from 'react';
 import { ViewportOptions, Tool, Viewport, Layer, CanvasElement as CanvasElement$1, ElementType } from '@fieldnotes/core';
 
 interface FieldNotesCanvasProps {
+    /** Constructor-only: changes after mount are ignored (the canvas is stateful). */
     options?: ViewportOptions;
+    /**
+     * Reactive (append-only): tools present here are registered; removal is not supported.
+     * Hoist the array out of render — inline arrays reconstruct Tool instances and re-run
+     * registration on every render.
+     */
     tools?: Tool[];
+    /** Uncontrolled initial tool. Ignored when `tool` is set. */
     defaultTool?: string;
+    /** Controlled active tool. Pair with `onToolChange`. */
+    tool?: string;
+    /**
+     * Fires whenever the active tool changes (keyboard, API, or `tool` prop).
+     * Memoize with useCallback to avoid re-subscribing each render.
+     */
+    onToolChange?: (name: string) => void;
+    /** Reactive: toggles grid snapping. */
+    snapToGrid?: boolean;
     className?: string;
     style?: CSSProperties;
     children?: ReactNode;
@@ -16,21 +32,30 @@ interface FieldNotesCanvasRef {
 }
 declare const FieldNotesCanvas: react.ForwardRefExoticComponent<FieldNotesCanvasProps & react.RefAttributes<FieldNotesCanvasRef>>;
 
+/** Props for {@link CanvasElement}. */
 interface CanvasElementProps {
+    /** Canvas-space position of the element's top-left corner. */
     position: {
         x: number;
         y: number;
     };
+    /** Optional fixed size; omit to let the element size to its content. */
     size?: {
         w: number;
         h: number;
     };
     children: ReactNode;
 }
+/**
+ * Renders a React subtree as an HTML element embedded in the canvas coordinate space.
+ * Must be used inside a `<FieldNotesCanvas>`.
+ */
 declare function CanvasElement({ position, size, children }: CanvasElementProps): react.ReactPortal | null;
 
+/** The Viewport from the nearest `<FieldNotesCanvas>`. Throws outside one. */
 declare function useViewport(): Viewport;
 
+/** `[activeToolName, setTool]` — re-renders on tool switches. */
 declare function useActiveTool(): [toolName: string, setTool: (name: string) => void];
 
 interface CameraState {
@@ -38,8 +63,13 @@ interface CameraState {
     y: number;
     zoom: number;
 }
+/** Current camera position and zoom level — re-renders whenever the camera moves or zoom changes. */
 declare function useCamera(): CameraState;
 
+/**
+ * `[options, setOptions]` for the named tool — re-renders when the tool's options change.
+ * Returns `null` for options if the tool is not registered or does not expose options.
+ */
 declare function useToolOptions<T extends Record<string, unknown>>(toolName: string): [options: T | null, setOptions: (partial: Partial<T>) => void];
 
 interface UseLayersResult {
@@ -55,6 +85,10 @@ interface UseLayersResult {
     setActiveLayer: (id: string) => void;
     moveElement: (elementId: string, layerId: string) => void;
 }
+/**
+ * Current layer list and mutation helpers — re-renders whenever a layer is added, removed,
+ * reordered, renamed, or its visibility/lock/opacity/active state changes.
+ */
 declare function useLayers(): UseLayersResult;
 
 interface UseHistoryResult {
@@ -63,12 +97,25 @@ interface UseHistoryResult {
     undo: () => void;
     redo: () => void;
 }
+/** `{ canUndo, canRedo, undo, redo }` — re-renders when undo/redo availability changes. */
 declare function useHistory(): UseHistoryResult;
 
+/** All elements; re-renders on every store mutation (use a selector for hot paths). */
 declare function useElements(): CanvasElement$1[];
+/** Elements of one type; re-renders on every store mutation. */
 declare function useElements<T extends ElementType>(type: T): Extract<CanvasElement$1, {
     type: T;
 }>[];
+/**
+ * Derived value; re-renders only when the selected value changes (per `isEqual`,
+ * default: one-level shallow compare — arrays by index, plain objects by key, primitives by
+ * Object.is). Keep the selector referentially stable (useCallback or module scope).
+ *
+ * Supply `isEqual` for deeper structures. Note: selectors returning nested fresh objects
+ * (e.g. `els => els.map(e => ({ ...e.position }))`) still need a custom comparator because
+ * the default only compares one level deep.
+ */
+declare function useElements<R>(selector: (elements: CanvasElement$1[]) => R, isEqual?: (a: R, b: R) => boolean): R;
 
 declare const ViewportContext: react.Context<Viewport | null>;
 

package/dist/index.d.ts

@@ -3,9 +3,25 @@ import { CSSProperties, ReactNode } from 'react';
 import { ViewportOptions, Tool, Viewport, Layer, CanvasElement as CanvasElement$1, ElementType } from '@fieldnotes/core';
 
 interface FieldNotesCanvasProps {
+    /** Constructor-only: changes after mount are ignored (the canvas is stateful). */
     options?: ViewportOptions;
+    /**
+     * Reactive (append-only): tools present here are registered; removal is not supported.
+     * Hoist the array out of render — inline arrays reconstruct Tool instances and re-run
+     * registration on every render.
+     */
     tools?: Tool[];
+    /** Uncontrolled initial tool. Ignored when `tool` is set. */
     defaultTool?: string;
+    /** Controlled active tool. Pair with `onToolChange`. */
+    tool?: string;
+    /**
+     * Fires whenever the active tool changes (keyboard, API, or `tool` prop).
+     * Memoize with useCallback to avoid re-subscribing each render.
+     */
+    onToolChange?: (name: string) => void;
+    /** Reactive: toggles grid snapping. */
+    snapToGrid?: boolean;
     className?: string;
     style?: CSSProperties;
     children?: ReactNode;
@@ -16,21 +32,30 @@ interface FieldNotesCanvasRef {
 }
 declare const FieldNotesCanvas: react.ForwardRefExoticComponent<FieldNotesCanvasProps & react.RefAttributes<FieldNotesCanvasRef>>;
 
+/** Props for {@link CanvasElement}. */
 interface CanvasElementProps {
+    /** Canvas-space position of the element's top-left corner. */
     position: {
         x: number;
         y: number;
     };
+    /** Optional fixed size; omit to let the element size to its content. */
     size?: {
         w: number;
         h: number;
     };
     children: ReactNode;
 }
+/**
+ * Renders a React subtree as an HTML element embedded in the canvas coordinate space.
+ * Must be used inside a `<FieldNotesCanvas>`.
+ */
 declare function CanvasElement({ position, size, children }: CanvasElementProps): react.ReactPortal | null;
 
+/** The Viewport from the nearest `<FieldNotesCanvas>`. Throws outside one. */
 declare function useViewport(): Viewport;
 
+/** `[activeToolName, setTool]` — re-renders on tool switches. */
 declare function useActiveTool(): [toolName: string, setTool: (name: string) => void];
 
 interface CameraState {
@@ -38,8 +63,13 @@ interface CameraState {
     y: number;
     zoom: number;
 }
+/** Current camera position and zoom level — re-renders whenever the camera moves or zoom changes. */
 declare function useCamera(): CameraState;
 
+/**
+ * `[options, setOptions]` for the named tool — re-renders when the tool's options change.
+ * Returns `null` for options if the tool is not registered or does not expose options.
+ */
 declare function useToolOptions<T extends Record<string, unknown>>(toolName: string): [options: T | null, setOptions: (partial: Partial<T>) => void];
 
 interface UseLayersResult {
@@ -55,6 +85,10 @@ interface UseLayersResult {
     setActiveLayer: (id: string) => void;
     moveElement: (elementId: string, layerId: string) => void;
 }
+/**
+ * Current layer list and mutation helpers — re-renders whenever a layer is added, removed,
+ * reordered, renamed, or its visibility/lock/opacity/active state changes.
+ */
 declare function useLayers(): UseLayersResult;
 
 interface UseHistoryResult {
@@ -63,12 +97,25 @@ interface UseHistoryResult {
     undo: () => void;
     redo: () => void;
 }
+/** `{ canUndo, canRedo, undo, redo }` — re-renders when undo/redo availability changes. */
 declare function useHistory(): UseHistoryResult;
 
+/** All elements; re-renders on every store mutation (use a selector for hot paths). */
 declare function useElements(): CanvasElement$1[];
+/** Elements of one type; re-renders on every store mutation. */
 declare function useElements<T extends ElementType>(type: T): Extract<CanvasElement$1, {
     type: T;
 }>[];
+/**
+ * Derived value; re-renders only when the selected value changes (per `isEqual`,
+ * default: one-level shallow compare — arrays by index, plain objects by key, primitives by
+ * Object.is). Keep the selector referentially stable (useCallback or module scope).
+ *
+ * Supply `isEqual` for deeper structures. Note: selectors returning nested fresh objects
+ * (e.g. `els => els.map(e => ({ ...e.position }))`) still need a custom comparator because
+ * the default only compares one level deep.
+ */
+declare function useElements<R>(selector: (elements: CanvasElement$1[]) => R, isEqual?: (a: R, b: R) => boolean): R;
 
 declare const ViewportContext: react.Context<Viewport | null>;
 

package/dist/index.js

@@ -15,7 +15,18 @@ var ViewportContext = createContext(null);
 // src/field-notes-canvas.tsx
 import { jsx } from "react/jsx-runtime";
 var FieldNotesCanvas = forwardRef(
-  function FieldNotesCanvas2({ options, tools, defaultTool, className, style, children, onReady }, ref) {
+  function FieldNotesCanvas2({
+    options,
+    tools,
+    defaultTool,
+    tool,
+    onToolChange,
+    snapToGrid,
+    className,
+    style,
+    children,
+    onReady
+  }, ref) {
     const containerRef = useRef(null);
     const [viewport, setViewport] = useState(null);
     useImperativeHandle(ref, () => ({ viewport }), [viewport]);
@@ -24,12 +35,13 @@ var FieldNotesCanvas = forwardRef(
       if (!el) return;
       const vp = new Viewport(el, options);
       if (tools) {
-        for (const tool of tools) {
-          vp.toolManager.register(tool);
+        for (const t of tools) {
+          vp.toolManager.register(t);
         }
       }
-      if (defaultTool) {
-        vp.toolManager.setTool(defaultTool, vp.toolContext);
+      const initialTool = tool ?? defaultTool;
+      if (initialTool) {
+        vp.setTool(initialTool);
       }
       setViewport(vp);
       onReady?.(vp);
@@ -38,6 +50,28 @@ var FieldNotesCanvas = forwardRef(
         setViewport(null);
       };
     }, []);
+    useEffect(() => {
+      if (!viewport || tool === void 0) return;
+      if (viewport.toolManager.activeTool?.name !== tool) {
+        viewport.setTool(tool);
+      }
+    }, [viewport, tool]);
+    useEffect(() => {
+      if (!viewport || !onToolChange) return;
+      return viewport.toolManager.onChange(onToolChange);
+    }, [viewport, onToolChange]);
+    useEffect(() => {
+      if (!viewport || snapToGrid === void 0) return;
+      viewport.setSnapToGrid(snapToGrid);
+    }, [viewport, snapToGrid]);
+    useEffect(() => {
+      if (!viewport || !tools) return;
+      for (const t of tools) {
+        if (!viewport.toolManager.getTool(t.name)) {
+          viewport.toolManager.register(t);
+        }
+      }
+    }, [viewport, tools]);
     return /* @__PURE__ */ jsx("div", { ref: containerRef, className, style, children: viewport && /* @__PURE__ */ jsx(ViewportContext.Provider, { value: viewport, children }) });
   }
 );
@@ -98,15 +132,12 @@ import { useCallback, useSyncExternalStore } from "react";
 function useActiveTool() {
   const viewport = useViewport();
   const subscribe = useCallback(
-    (onStoreChange) => viewport.toolManager.onChange(() => onStoreChange()),
+    (onStoreChange) => viewport.toolManager.onChange(onStoreChange),
     [viewport]
   );
   const getSnapshot = useCallback(() => viewport.toolManager.activeTool?.name ?? "", [viewport]);
   const toolName = useSyncExternalStore(subscribe, getSnapshot);
-  const setTool = useCallback(
-    (name) => viewport.toolManager.setTool(name, viewport.toolContext),
-    [viewport]
-  );
+  const setTool = useCallback((name) => viewport.setTool(name), [viewport]);
   return [toolName, setTool];
 }
 
@@ -295,22 +326,47 @@ function useHistory() {
 
 // src/hooks/use-elements.ts
 import { useCallback as useCallback6, useRef as useRef7, useSyncExternalStore as useSyncExternalStore6 } from "react";
-function useElements(type) {
+function shallowEqual2(a, b) {
+  if (Object.is(a, b)) return true;
+  if (Array.isArray(a) && Array.isArray(b)) {
+    return a.length === b.length && a.every((v, i) => Object.is(v, b[i]));
+  }
+  if (typeof a === "object" && a !== null && typeof b === "object" && b !== null && !Array.isArray(a) && !Array.isArray(b)) {
+    const ka = Object.keys(a);
+    const kb = Object.keys(b);
+    return ka.length === kb.length && ka.every(
+      (k) => k in b && Object.is(a[k], b[k])
+    );
+  }
+  return false;
+}
+function useElements(arg, isEqual) {
   const viewport = useViewport();
   const cachedRef = useRef7([]);
+  const selectedRef = useRef7(null);
   const subscribe = useCallback6(
     (onStoreChange) => viewport.store.onChange(onStoreChange),
     [viewport]
   );
   const getSnapshot = useCallback6(() => {
-    const next = type ? viewport.store.getElementsByType(type) : viewport.store.getAll();
+    if (typeof arg === "function") {
+      const next2 = arg(viewport.store.getAll());
+      const prev = selectedRef.current;
+      const equal = isEqual ?? shallowEqual2;
+      if (prev !== null && equal(prev.value, next2)) {
+        return prev.value;
+      }
+      selectedRef.current = { value: next2 };
+      return next2;
+    }
+    const next = arg ? viewport.store.getElementsByType(arg) : viewport.store.getAll();
     const cached = cachedRef.current;
     if (cached.length === next.length && cached.every((el, i) => el === next[i])) {
       return cached;
     }
     cachedRef.current = next;
     return next;
-  }, [viewport, type]);
+  }, [viewport, arg, isEqual]);
   return useSyncExternalStore6(subscribe, getSnapshot);
 }
 export {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/field-notes-canvas.tsx","../src/context.ts","../src/canvas-element.tsx","../src/hooks/use-viewport.ts","../src/hooks/use-active-tool.ts","../src/hooks/use-camera.ts","../src/hooks/use-tool-options.ts","../src/hooks/use-layers.ts","../src/hooks/use-history.ts","../src/hooks/use-elements.ts"],"sourcesContent":["import {\r\n  useRef,\r\n  useEffect,\r\n  useState,\r\n  forwardRef,\r\n  useImperativeHandle,\r\n  type ReactNode,\r\n  type CSSProperties,\r\n} from 'react';\r\nimport { Viewport } from '@fieldnotes/core';\r\nimport type { ViewportOptions, Tool } from '@fieldnotes/core';\r\nimport { ViewportContext } from './context';\r\n\r\nexport interface FieldNotesCanvasProps {\r\n  options?: ViewportOptions;\r\n  tools?: Tool[];\r\n  defaultTool?: string;\r\n  className?: string;\r\n  style?: CSSProperties;\r\n  children?: ReactNode;\r\n  onReady?: (viewport: Viewport) => void;\r\n}\r\n\r\nexport interface FieldNotesCanvasRef {\r\n  viewport: Viewport | null;\r\n}\r\n\r\nexport const FieldNotesCanvas = forwardRef<FieldNotesCanvasRef, FieldNotesCanvasProps>(\r\n  function FieldNotesCanvas(\r\n    { options, tools, defaultTool, className, style, children, onReady },\r\n    ref,\r\n  ) {\r\n    const containerRef = useRef<HTMLDivElement>(null);\r\n    const [viewport, setViewport] = useState<Viewport | null>(null);\r\n\r\n    useImperativeHandle(ref, () => ({ viewport }), [viewport]);\r\n\r\n    useEffect(() => {\r\n      const el = containerRef.current;\r\n      if (!el) return;\r\n\r\n      const vp = new Viewport(el, options);\r\n\r\n      if (tools) {\r\n        for (const tool of tools) {\r\n          vp.toolManager.register(tool);\r\n        }\r\n      }\r\n\r\n      if (defaultTool) {\r\n        vp.toolManager.setTool(defaultTool, vp.toolContext);\r\n      }\r\n\r\n      setViewport(vp);\r\n      onReady?.(vp);\r\n\r\n      return () => {\r\n        vp.destroy();\r\n        setViewport(null);\r\n      };\r\n    }, []);\r\n\r\n    return (\r\n      <div ref={containerRef} className={className} style={style}>\r\n        {viewport && (\r\n          <ViewportContext.Provider value={viewport}>{children}</ViewportContext.Provider>\r\n        )}\r\n      </div>\r\n    );\r\n  },\r\n);\r\n","import { createContext } from 'react';\r\nimport type { Viewport } from '@fieldnotes/core';\r\n\r\nexport const ViewportContext = createContext<Viewport | null>(null);\r\n","import { useEffect, useRef, useState, type ReactNode } from 'react';\r\nimport { createPortal } from 'react-dom';\r\nimport { useViewport } from './hooks/use-viewport';\r\n\r\nexport interface CanvasElementProps {\r\n  position: { x: number; y: number };\r\n  size?: { w: number; h: number };\r\n  children: ReactNode;\r\n}\r\n\r\nexport function CanvasElement({ position, size, children }: CanvasElementProps) {\r\n  const viewport = useViewport();\r\n  const [portalTarget, setPortalTarget] = useState<HTMLElement | null>(null);\r\n  const elementIdRef = useRef<string | null>(null);\r\n\r\n  useEffect(() => {\r\n    const container = document.createElement('div');\r\n    Object.assign(container.style, {\r\n      width: '100%',\r\n      height: '100%',\r\n    });\r\n\r\n    // Append to domLayer immediately so portal children are queryable in the document\r\n    // before the viewport render loop fires via requestAnimationFrame.\r\n    viewport.domLayer.appendChild(container);\r\n\r\n    const id = viewport.addHtmlElement(container, position, size);\r\n    elementIdRef.current = id;\r\n    setPortalTarget(container);\r\n\r\n    return () => {\r\n      if (elementIdRef.current) {\r\n        viewport.store.remove(elementIdRef.current);\r\n        viewport.requestRender();\r\n        elementIdRef.current = null;\r\n      }\r\n      setPortalTarget(null);\r\n    };\r\n  }, [viewport]);\r\n\r\n  useEffect(() => {\r\n    const id = elementIdRef.current;\r\n    if (!id) return;\r\n    viewport.store.update(id, { position });\r\n    if (size) {\r\n      viewport.store.update(id, { size });\r\n    }\r\n    viewport.requestRender();\r\n  }, [viewport, position.x, position.y, size?.w, size?.h]);\r\n\r\n  if (!portalTarget) return null;\r\n  return createPortal(children, portalTarget);\r\n}\r\n","import { useContext } from 'react';\r\nimport type { Viewport } from '@fieldnotes/core';\r\nimport { ViewportContext } from '../context';\r\n\r\nexport function useViewport(): Viewport {\r\n  const viewport = useContext(ViewportContext);\r\n  if (!viewport) {\r\n    throw new Error('useViewport must be used inside <FieldNotesCanvas>');\r\n  }\r\n  return viewport;\r\n}\r\n","import { useCallback, useSyncExternalStore } from 'react';\r\nimport { useViewport } from './use-viewport';\r\n\r\nexport function useActiveTool(): [toolName: string, setTool: (name: string) => void] {\r\n  const viewport = useViewport();\r\n\r\n  const subscribe = useCallback(\r\n    (onStoreChange: () => void) => viewport.toolManager.onChange(() => onStoreChange()),\r\n    [viewport],\r\n  );\r\n\r\n  const getSnapshot = useCallback(() => viewport.toolManager.activeTool?.name ?? '', [viewport]);\r\n\r\n  const toolName = useSyncExternalStore(subscribe, getSnapshot);\r\n\r\n  const setTool = useCallback(\r\n    (name: string) => viewport.toolManager.setTool(name, viewport.toolContext),\r\n    [viewport],\r\n  );\r\n\r\n  return [toolName, setTool];\r\n}\r\n","import { useCallback, useRef, useSyncExternalStore } from 'react';\r\nimport { useViewport } from './use-viewport';\r\n\r\nexport interface CameraState {\r\n  x: number;\r\n  y: number;\r\n  zoom: number;\r\n}\r\n\r\nexport function useCamera(): CameraState {\r\n  const viewport = useViewport();\r\n  const cachedRef = useRef<CameraState>({ x: 0, y: 0, zoom: 1 });\r\n\r\n  const subscribe = useCallback(\r\n    (onStoreChange: () => void) => viewport.camera.onChange(onStoreChange),\r\n    [viewport],\r\n  );\r\n\r\n  const getSnapshot = useCallback((): CameraState => {\r\n    const { position, zoom } = viewport.camera;\r\n    const cached = cachedRef.current;\r\n    if (cached.x === position.x && cached.y === position.y && cached.zoom === zoom) {\r\n      return cached;\r\n    }\r\n    const next = { x: position.x, y: position.y, zoom };\r\n    cachedRef.current = next;\r\n    return next;\r\n  }, [viewport]);\r\n\r\n  return useSyncExternalStore(subscribe, getSnapshot);\r\n}\r\n","import { useCallback, useRef, useSyncExternalStore } from 'react';\r\nimport { useViewport } from './use-viewport';\r\n\r\nfunction noop() {\r\n  /* unsubscribe placeholder */\r\n}\r\n\r\nexport function useToolOptions<T extends Record<string, unknown>>(\r\n  toolName: string,\r\n): [options: T | null, setOptions: (partial: Partial<T>) => void] {\r\n  const viewport = useViewport();\r\n  const cachedRef = useRef<T | null>(null);\r\n\r\n  const subscribe = useCallback(\r\n    (onStoreChange: () => void) => {\r\n      const tool = viewport.toolManager.getTool(toolName);\r\n      if (!tool?.onOptionsChange) return noop;\r\n      return tool.onOptionsChange(onStoreChange);\r\n    },\r\n    [viewport, toolName],\r\n  );\r\n\r\n  const getSnapshot = useCallback((): T | null => {\r\n    const tool = viewport.toolManager.getTool(toolName);\r\n    if (!tool?.getOptions) return null;\r\n    const next = tool.getOptions() as T;\r\n    const cached = cachedRef.current;\r\n    if (cached && shallowEqual(cached, next)) return cached;\r\n    cachedRef.current = next;\r\n    return next;\r\n  }, [viewport, toolName]);\r\n\r\n  const options = useSyncExternalStore(subscribe, getSnapshot);\r\n\r\n  const setOptions = useCallback(\r\n    (partial: Partial<T>) => {\r\n      const tool = viewport.toolManager.getTool(toolName);\r\n      tool?.setOptions?.(partial as Record<string, unknown>);\r\n    },\r\n    [viewport, toolName],\r\n  );\r\n\r\n  return [options, setOptions];\r\n}\r\n\r\nfunction shallowEqual(a: Record<string, unknown>, b: Record<string, unknown>): boolean {\r\n  const keysA = Object.keys(a);\r\n  const keysB = Object.keys(b);\r\n  if (keysA.length !== keysB.length) return false;\r\n  for (const key of keysA) {\r\n    const valA = a[key];\r\n    const valB = b[key];\r\n    if (valA === valB) continue;\r\n    if (\r\n      typeof valA === 'object' &&\r\n      valA !== null &&\r\n      typeof valB === 'object' &&\r\n      valB !== null &&\r\n      !Array.isArray(valA) &&\r\n      !Array.isArray(valB)\r\n    ) {\r\n      const objA = valA as Record<string, unknown>;\r\n      const objB = valB as Record<string, unknown>;\r\n      const innerKeys = Object.keys(objA);\r\n      if (\r\n        innerKeys.length === Object.keys(objB).length &&\r\n        innerKeys.every((k) => objA[k] === objB[k])\r\n      ) {\r\n        continue;\r\n      }\r\n    }\r\n    return false;\r\n  }\r\n  return true;\r\n}\r\n","import { useCallback, useRef, useSyncExternalStore } from 'react';\r\nimport type { Layer } from '@fieldnotes/core';\r\nimport { useViewport } from './use-viewport';\r\n\r\ninterface LayersSnapshot {\r\n  layers: Layer[];\r\n  activeLayerId: string;\r\n}\r\n\r\nexport interface UseLayersResult {\r\n  layers: Layer[];\r\n  activeLayerId: string;\r\n  createLayer: (name?: string) => Layer;\r\n  removeLayer: (id: string) => void;\r\n  renameLayer: (id: string, name: string) => void;\r\n  reorderLayer: (id: string, newOrder: number) => void;\r\n  setVisible: (id: string, visible: boolean) => void;\r\n  setLocked: (id: string, locked: boolean) => void;\r\n  setOpacity: (id: string, opacity: number) => void;\r\n  setActiveLayer: (id: string) => void;\r\n  moveElement: (elementId: string, layerId: string) => void;\r\n}\r\n\r\nexport function useLayers(): UseLayersResult {\r\n  const viewport = useViewport();\r\n  const cachedRef = useRef<LayersSnapshot>({ layers: [], activeLayerId: '' });\r\n\r\n  const subscribe = useCallback(\r\n    (onStoreChange: () => void) => viewport.layerManager.on('change', onStoreChange),\r\n    [viewport],\r\n  );\r\n\r\n  const getSnapshot = useCallback((): LayersSnapshot => {\r\n    const layers = viewport.layerManager.getLayers();\r\n    const activeLayerId = viewport.layerManager.activeLayerId;\r\n    const cached = cachedRef.current;\r\n    if (\r\n      cached.activeLayerId === activeLayerId &&\r\n      cached.layers.length === layers.length &&\r\n      cached.layers.every((l, i) => {\r\n        const next = layers[i];\r\n        return (\r\n          next !== undefined &&\r\n          l.id === next.id &&\r\n          l.name === next.name &&\r\n          l.visible === next.visible &&\r\n          l.locked === next.locked &&\r\n          l.order === next.order &&\r\n          l.opacity === next.opacity\r\n        );\r\n      })\r\n    ) {\r\n      return cached;\r\n    }\r\n    const next = { layers, activeLayerId };\r\n    cachedRef.current = next;\r\n    return next;\r\n  }, [viewport]);\r\n\r\n  const snapshot = useSyncExternalStore(subscribe, getSnapshot);\r\n\r\n  const createLayer = useCallback(\r\n    (name?: string) => viewport.layerManager.createLayer(name),\r\n    [viewport],\r\n  );\r\n\r\n  const removeLayer = useCallback(\r\n    (id: string) => viewport.layerManager.removeLayer(id),\r\n    [viewport],\r\n  );\r\n\r\n  const renameLayer = useCallback(\r\n    (id: string, name: string) => viewport.layerManager.renameLayer(id, name),\r\n    [viewport],\r\n  );\r\n\r\n  const reorderLayer = useCallback(\r\n    (id: string, newOrder: number) => viewport.layerManager.reorderLayer(id, newOrder),\r\n    [viewport],\r\n  );\r\n\r\n  const setVisible = useCallback(\r\n    (id: string, visible: boolean) => viewport.layerManager.setLayerVisible(id, visible),\r\n    [viewport],\r\n  );\r\n\r\n  const setLocked = useCallback(\r\n    (id: string, locked: boolean) => viewport.layerManager.setLayerLocked(id, locked),\r\n    [viewport],\r\n  );\r\n\r\n  const setOpacity = useCallback(\r\n    (id: string, opacity: number) => viewport.layerManager.setLayerOpacity(id, opacity),\r\n    [viewport],\r\n  );\r\n\r\n  const setActiveLayer = useCallback(\r\n    (id: string) => viewport.layerManager.setActiveLayer(id),\r\n    [viewport],\r\n  );\r\n\r\n  const moveElement = useCallback(\r\n    (elementId: string, layerId: string) =>\r\n      viewport.layerManager.moveElementToLayer(elementId, layerId),\r\n    [viewport],\r\n  );\r\n\r\n  return {\r\n    layers: snapshot.layers,\r\n    activeLayerId: snapshot.activeLayerId,\r\n    createLayer,\r\n    removeLayer,\r\n    renameLayer,\r\n    reorderLayer,\r\n    setVisible,\r\n    setLocked,\r\n    setOpacity,\r\n    setActiveLayer,\r\n    moveElement,\r\n  };\r\n}\r\n","import { useCallback, useRef, useSyncExternalStore } from 'react';\r\nimport { useViewport } from './use-viewport';\r\n\r\ninterface HistorySnapshot {\r\n  canUndo: boolean;\r\n  canRedo: boolean;\r\n}\r\n\r\nexport interface UseHistoryResult {\r\n  canUndo: boolean;\r\n  canRedo: boolean;\r\n  undo: () => void;\r\n  redo: () => void;\r\n}\r\n\r\nexport function useHistory(): UseHistoryResult {\r\n  const viewport = useViewport();\r\n  const cachedRef = useRef<HistorySnapshot>({ canUndo: false, canRedo: false });\r\n\r\n  const subscribe = useCallback(\r\n    (onStoreChange: () => void) => viewport.history.onChange(onStoreChange),\r\n    [viewport],\r\n  );\r\n\r\n  const getSnapshot = useCallback((): HistorySnapshot => {\r\n    const canUndo = viewport.history.canUndo;\r\n    const canRedo = viewport.history.canRedo;\r\n    const cached = cachedRef.current;\r\n    if (cached.canUndo === canUndo && cached.canRedo === canRedo) {\r\n      return cached;\r\n    }\r\n    const next = { canUndo, canRedo };\r\n    cachedRef.current = next;\r\n    return next;\r\n  }, [viewport]);\r\n\r\n  const snapshot = useSyncExternalStore(subscribe, getSnapshot);\r\n\r\n  const undo = useCallback(() => viewport.undo(), [viewport]);\r\n  const redo = useCallback(() => viewport.redo(), [viewport]);\r\n\r\n  return {\r\n    canUndo: snapshot.canUndo,\r\n    canRedo: snapshot.canRedo,\r\n    undo,\r\n    redo,\r\n  };\r\n}\r\n","import { useCallback, useRef, useSyncExternalStore } from 'react';\r\nimport type { CanvasElement, ElementType } from '@fieldnotes/core';\r\nimport { useViewport } from './use-viewport';\r\n\r\nexport function useElements(): CanvasElement[];\r\nexport function useElements<T extends ElementType>(type: T): Extract<CanvasElement, { type: T }>[];\r\nexport function useElements(type?: ElementType): CanvasElement[] {\r\n  const viewport = useViewport();\r\n  const cachedRef = useRef<CanvasElement[]>([]);\r\n\r\n  const subscribe = useCallback(\r\n    (onStoreChange: () => void) => viewport.store.onChange(onStoreChange),\r\n    [viewport],\r\n  );\r\n\r\n  const getSnapshot = useCallback((): CanvasElement[] => {\r\n    const next = type ? viewport.store.getElementsByType(type) : viewport.store.getAll();\r\n    const cached = cachedRef.current;\r\n    if (cached.length === next.length && cached.every((el, i) => el === next[i])) {\r\n      return cached;\r\n    }\r\n    cachedRef.current = next;\r\n    return next;\r\n  }, [viewport, type]);\r\n\r\n  return useSyncExternalStore(subscribe, getSnapshot);\r\n}\r\n"],"mappings":";AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AACP,SAAS,gBAAgB;;;ACTzB,SAAS,qBAAqB;AAGvB,IAAM,kBAAkB,cAA+B,IAAI;;;AD8DxD;AAtCH,IAAM,mBAAmB;AAAA,EAC9B,SAASA,kBACP,EAAE,SAAS,OAAO,aAAa,WAAW,OAAO,UAAU,QAAQ,GACnE,KACA;AACA,UAAM,eAAe,OAAuB,IAAI;AAChD,UAAM,CAAC,UAAU,WAAW,IAAI,SAA0B,IAAI;AAE9D,wBAAoB,KAAK,OAAO,EAAE,SAAS,IAAI,CAAC,QAAQ,CAAC;AAEzD,cAAU,MAAM;AACd,YAAM,KAAK,aAAa;AACxB,UAAI,CAAC,GAAI;AAET,YAAM,KAAK,IAAI,SAAS,IAAI,OAAO;AAEnC,UAAI,OAAO;AACT,mBAAW,QAAQ,OAAO;AACxB,aAAG,YAAY,SAAS,IAAI;AAAA,QAC9B;AAAA,MACF;AAEA,UAAI,aAAa;AACf,WAAG,YAAY,QAAQ,aAAa,GAAG,WAAW;AAAA,MACpD;AAEA,kBAAY,EAAE;AACd,gBAAU,EAAE;AAEZ,aAAO,MAAM;AACX,WAAG,QAAQ;AACX,oBAAY,IAAI;AAAA,MAClB;AAAA,IACF,GAAG,CAAC,CAAC;AAEL,WACE,oBAAC,SAAI,KAAK,cAAc,WAAsB,OAC3C,sBACC,oBAAC,gBAAgB,UAAhB,EAAyB,OAAO,UAAW,UAAS,GAEzD;AAAA,EAEJ;AACF;;;AEtEA,SAAS,aAAAC,YAAW,UAAAC,SAAQ,YAAAC,iBAAgC;AAC5D,SAAS,oBAAoB;;;ACD7B,SAAS,kBAAkB;AAIpB,SAAS,cAAwB;AACtC,QAAM,WAAW,WAAW,eAAe;AAC3C,MAAI,CAAC,UAAU;AACb,UAAM,IAAI,MAAM,oDAAoD;AAAA,EACtE;AACA,SAAO;AACT;;;ADAO,SAAS,cAAc,EAAE,UAAU,MAAM,SAAS,GAAuB;AAC9E,QAAM,WAAW,YAAY;AAC7B,QAAM,CAAC,cAAc,eAAe,IAAIC,UAA6B,IAAI;AACzE,QAAM,eAAeC,QAAsB,IAAI;AAE/C,EAAAC,WAAU,MAAM;AACd,UAAM,YAAY,SAAS,cAAc,KAAK;AAC9C,WAAO,OAAO,UAAU,OAAO;AAAA,MAC7B,OAAO;AAAA,MACP,QAAQ;AAAA,IACV,CAAC;AAID,aAAS,SAAS,YAAY,SAAS;AAEvC,UAAM,KAAK,SAAS,eAAe,WAAW,UAAU,IAAI;AAC5D,iBAAa,UAAU;AACvB,oBAAgB,SAAS;AAEzB,WAAO,MAAM;AACX,UAAI,aAAa,SAAS;AACxB,iBAAS,MAAM,OAAO,aAAa,OAAO;AAC1C,iBAAS,cAAc;AACvB,qBAAa,UAAU;AAAA,MACzB;AACA,sBAAgB,IAAI;AAAA,IACtB;AAAA,EACF,GAAG,CAAC,QAAQ,CAAC;AAEb,EAAAA,WAAU,MAAM;AACd,UAAM,KAAK,aAAa;AACxB,QAAI,CAAC,GAAI;AACT,aAAS,MAAM,OAAO,IAAI,EAAE,SAAS,CAAC;AACtC,QAAI,MAAM;AACR,eAAS,MAAM,OAAO,IAAI,EAAE,KAAK,CAAC;AAAA,IACpC;AACA,aAAS,cAAc;AAAA,EACzB,GAAG,CAAC,UAAU,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC;AAEvD,MAAI,CAAC,aAAc,QAAO;AAC1B,SAAO,aAAa,UAAU,YAAY;AAC5C;;;AEpDA,SAAS,aAAa,4BAA4B;AAG3C,SAAS,gBAAqE;AACnF,QAAM,WAAW,YAAY;AAE7B,QAAM,YAAY;AAAA,IAChB,CAAC,kBAA8B,SAAS,YAAY,SAAS,MAAM,cAAc,CAAC;AAAA,IAClF,CAAC,QAAQ;AAAA,EACX;AAEA,QAAM,cAAc,YAAY,MAAM,SAAS,YAAY,YAAY,QAAQ,IAAI,CAAC,QAAQ,CAAC;AAE7F,QAAM,WAAW,qBAAqB,WAAW,WAAW;AAE5D,QAAM,UAAU;AAAA,IACd,CAAC,SAAiB,SAAS,YAAY,QAAQ,MAAM,SAAS,WAAW;AAAA,IACzE,CAAC,QAAQ;AAAA,EACX;AAEA,SAAO,CAAC,UAAU,OAAO;AAC3B;;;ACrBA,SAAS,eAAAC,cAAa,UAAAC,SAAQ,wBAAAC,6BAA4B;AASnD,SAAS,YAAyB;AACvC,QAAM,WAAW,YAAY;AAC7B,QAAM,YAAYC,QAAoB,EAAE,GAAG,GAAG,GAAG,GAAG,MAAM,EAAE,CAAC;AAE7D,QAAM,YAAYC;AAAA,IAChB,CAAC,kBAA8B,SAAS,OAAO,SAAS,aAAa;AAAA,IACrE,CAAC,QAAQ;AAAA,EACX;AAEA,QAAM,cAAcA,aAAY,MAAmB;AACjD,UAAM,EAAE,UAAU,KAAK,IAAI,SAAS;AACpC,UAAM,SAAS,UAAU;AACzB,QAAI,OAAO,MAAM,SAAS,KAAK,OAAO,MAAM,SAAS,KAAK,OAAO,SAAS,MAAM;AAC9E,aAAO;AAAA,IACT;AACA,UAAM,OAAO,EAAE,GAAG,SAAS,GAAG,GAAG,SAAS,GAAG,KAAK;AAClD,cAAU,UAAU;AACpB,WAAO;AAAA,EACT,GAAG,CAAC,QAAQ,CAAC;AAEb,SAAOC,sBAAqB,WAAW,WAAW;AACpD;;;AC9BA,SAAS,eAAAC,cAAa,UAAAC,SAAQ,wBAAAC,6BAA4B;AAG1D,SAAS,OAAO;AAEhB;AAEO,SAAS,eACd,UACgE;AAChE,QAAM,WAAW,YAAY;AAC7B,QAAM,YAAYC,QAAiB,IAAI;AAEvC,QAAM,YAAYC;AAAA,IAChB,CAAC,kBAA8B;AAC7B,YAAM,OAAO,SAAS,YAAY,QAAQ,QAAQ;AAClD,UAAI,CAAC,MAAM,gBAAiB,QAAO;AACnC,aAAO,KAAK,gBAAgB,aAAa;AAAA,IAC3C;AAAA,IACA,CAAC,UAAU,QAAQ;AAAA,EACrB;AAEA,QAAM,cAAcA,aAAY,MAAgB;AAC9C,UAAM,OAAO,SAAS,YAAY,QAAQ,QAAQ;AAClD,QAAI,CAAC,MAAM,WAAY,QAAO;AAC9B,UAAM,OAAO,KAAK,WAAW;AAC7B,UAAM,SAAS,UAAU;AACzB,QAAI,UAAU,aAAa,QAAQ,IAAI,EAAG,QAAO;AACjD,cAAU,UAAU;AACpB,WAAO;AAAA,EACT,GAAG,CAAC,UAAU,QAAQ,CAAC;AAEvB,QAAM,UAAUC,sBAAqB,WAAW,WAAW;AAE3D,QAAM,aAAaD;AAAA,IACjB,CAAC,YAAwB;AACvB,YAAM,OAAO,SAAS,YAAY,QAAQ,QAAQ;AAClD,YAAM,aAAa,OAAkC;AAAA,IACvD;AAAA,IACA,CAAC,UAAU,QAAQ;AAAA,EACrB;AAEA,SAAO,CAAC,SAAS,UAAU;AAC7B;AAEA,SAAS,aAAa,GAA4B,GAAqC;AACrF,QAAM,QAAQ,OAAO,KAAK,CAAC;AAC3B,QAAM,QAAQ,OAAO,KAAK,CAAC;AAC3B,MAAI,MAAM,WAAW,MAAM,OAAQ,QAAO;AAC1C,aAAW,OAAO,OAAO;AACvB,UAAM,OAAO,EAAE,GAAG;AAClB,UAAM,OAAO,EAAE,GAAG;AAClB,QAAI,SAAS,KAAM;AACnB,QACE,OAAO,SAAS,YAChB,SAAS,QACT,OAAO,SAAS,YAChB,SAAS,QACT,CAAC,MAAM,QAAQ,IAAI,KACnB,CAAC,MAAM,QAAQ,IAAI,GACnB;AACA,YAAM,OAAO;AACb,YAAM,OAAO;AACb,YAAM,YAAY,OAAO,KAAK,IAAI;AAClC,UACE,UAAU,WAAW,OAAO,KAAK,IAAI,EAAE,UACvC,UAAU,MAAM,CAAC,MAAM,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,GAC1C;AACA;AAAA,MACF;AAAA,IACF;AACA,WAAO;AAAA,EACT;AACA,SAAO;AACT;;;AC1EA,SAAS,eAAAE,cAAa,UAAAC,SAAQ,wBAAAC,6BAA4B;AAuBnD,SAAS,YAA6B;AAC3C,QAAM,WAAW,YAAY;AAC7B,QAAM,YAAYC,QAAuB,EAAE,QAAQ,CAAC,GAAG,eAAe,GAAG,CAAC;AAE1E,QAAM,YAAYC;AAAA,IAChB,CAAC,kBAA8B,SAAS,aAAa,GAAG,UAAU,aAAa;AAAA,IAC/E,CAAC,QAAQ;AAAA,EACX;AAEA,QAAM,cAAcA,aAAY,MAAsB;AACpD,UAAM,SAAS,SAAS,aAAa,UAAU;AAC/C,UAAM,gBAAgB,SAAS,aAAa;AAC5C,UAAM,SAAS,UAAU;AACzB,QACE,OAAO,kBAAkB,iBACzB,OAAO,OAAO,WAAW,OAAO,UAChC,OAAO,OAAO,MAAM,CAAC,GAAG,MAAM;AAC5B,YAAMC,QAAO,OAAO,CAAC;AACrB,aACEA,UAAS,UACT,EAAE,OAAOA,MAAK,MACd,EAAE,SAASA,MAAK,QAChB,EAAE,YAAYA,MAAK,WACnB,EAAE,WAAWA,MAAK,UAClB,EAAE,UAAUA,MAAK,SACjB,EAAE,YAAYA,MAAK;AAAA,IAEvB,CAAC,GACD;AACA,aAAO;AAAA,IACT;AACA,UAAM,OAAO,EAAE,QAAQ,cAAc;AACrC,cAAU,UAAU;AACpB,WAAO;AAAA,EACT,GAAG,CAAC,QAAQ,CAAC;AAEb,QAAM,WAAWC,sBAAqB,WAAW,WAAW;AAE5D,QAAM,cAAcF;AAAA,IAClB,CAAC,SAAkB,SAAS,aAAa,YAAY,IAAI;AAAA,IACzD,CAAC,QAAQ;AAAA,EACX;AAEA,QAAM,cAAcA;AAAA,IAClB,CAAC,OAAe,SAAS,aAAa,YAAY,EAAE;AAAA,IACpD,CAAC,QAAQ;AAAA,EACX;AAEA,QAAM,cAAcA;AAAA,IAClB,CAAC,IAAY,SAAiB,SAAS,aAAa,YAAY,IAAI,IAAI;AAAA,IACxE,CAAC,QAAQ;AAAA,EACX;AAEA,QAAM,eAAeA;AAAA,IACnB,CAAC,IAAY,aAAqB,SAAS,aAAa,aAAa,IAAI,QAAQ;AAAA,IACjF,CAAC,QAAQ;AAAA,EACX;AAEA,QAAM,aAAaA;AAAA,IACjB,CAAC,IAAY,YAAqB,SAAS,aAAa,gBAAgB,IAAI,OAAO;AAAA,IACnF,CAAC,QAAQ;AAAA,EACX;AAEA,QAAM,YAAYA;AAAA,IAChB,CAAC,IAAY,WAAoB,SAAS,aAAa,eAAe,IAAI,MAAM;AAAA,IAChF,CAAC,QAAQ;AAAA,EACX;AAEA,QAAM,aAAaA;AAAA,IACjB,CAAC,IAAY,YAAoB,SAAS,aAAa,gBAAgB,IAAI,OAAO;AAAA,IAClF,CAAC,QAAQ;AAAA,EACX;AAEA,QAAM,iBAAiBA;AAAA,IACrB,CAAC,OAAe,SAAS,aAAa,eAAe,EAAE;AAAA,IACvD,CAAC,QAAQ;AAAA,EACX;AAEA,QAAM,cAAcA;AAAA,IAClB,CAAC,WAAmB,YAClB,SAAS,aAAa,mBAAmB,WAAW,OAAO;AAAA,IAC7D,CAAC,QAAQ;AAAA,EACX;AAEA,SAAO;AAAA,IACL,QAAQ,SAAS;AAAA,IACjB,eAAe,SAAS;AAAA,IACxB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;;;ACxHA,SAAS,eAAAG,cAAa,UAAAC,SAAQ,wBAAAC,6BAA4B;AAenD,SAAS,aAA+B;AAC7C,QAAM,WAAW,YAAY;AAC7B,QAAM,YAAYC,QAAwB,EAAE,SAAS,OAAO,SAAS,MAAM,CAAC;AAE5E,QAAM,YAAYC;AAAA,IAChB,CAAC,kBAA8B,SAAS,QAAQ,SAAS,aAAa;AAAA,IACtE,CAAC,QAAQ;AAAA,EACX;AAEA,QAAM,cAAcA,aAAY,MAAuB;AACrD,UAAM,UAAU,SAAS,QAAQ;AACjC,UAAM,UAAU,SAAS,QAAQ;AACjC,UAAM,SAAS,UAAU;AACzB,QAAI,OAAO,YAAY,WAAW,OAAO,YAAY,SAAS;AAC5D,aAAO;AAAA,IACT;AACA,UAAM,OAAO,EAAE,SAAS,QAAQ;AAChC,cAAU,UAAU;AACpB,WAAO;AAAA,EACT,GAAG,CAAC,QAAQ,CAAC;AAEb,QAAM,WAAWC,sBAAqB,WAAW,WAAW;AAE5D,QAAM,OAAOD,aAAY,MAAM,SAAS,KAAK,GAAG,CAAC,QAAQ,CAAC;AAC1D,QAAM,OAAOA,aAAY,MAAM,SAAS,KAAK,GAAG,CAAC,QAAQ,CAAC;AAE1D,SAAO;AAAA,IACL,SAAS,SAAS;AAAA,IAClB,SAAS,SAAS;AAAA,IAClB;AAAA,IACA;AAAA,EACF;AACF;;;AC/CA,SAAS,eAAAE,cAAa,UAAAC,SAAQ,wBAAAC,6BAA4B;AAMnD,SAAS,YAAY,MAAqC;AAC/D,QAAM,WAAW,YAAY;AAC7B,QAAM,YAAYC,QAAwB,CAAC,CAAC;AAE5C,QAAM,YAAYC;AAAA,IAChB,CAAC,kBAA8B,SAAS,MAAM,SAAS,aAAa;AAAA,IACpE,CAAC,QAAQ;AAAA,EACX;AAEA,QAAM,cAAcA,aAAY,MAAuB;AACrD,UAAM,OAAO,OAAO,SAAS,MAAM,kBAAkB,IAAI,IAAI,SAAS,MAAM,OAAO;AACnF,UAAM,SAAS,UAAU;AACzB,QAAI,OAAO,WAAW,KAAK,UAAU,OAAO,MAAM,CAAC,IAAI,MAAM,OAAO,KAAK,CAAC,CAAC,GAAG;AAC5E,aAAO;AAAA,IACT;AACA,cAAU,UAAU;AACpB,WAAO;AAAA,EACT,GAAG,CAAC,UAAU,IAAI,CAAC;AAEnB,SAAOC,sBAAqB,WAAW,WAAW;AACpD;","names":["FieldNotesCanvas","useEffect","useRef","useState","useState","useRef","useEffect","useCallback","useRef","useSyncExternalStore","useRef","useCallback","useSyncExternalStore","useCallback","useRef","useSyncExternalStore","useRef","useCallback","useSyncExternalStore","useCallback","useRef","useSyncExternalStore","useRef","useCallback","next","useSyncExternalStore","useCallback","useRef","useSyncExternalStore","useRef","useCallback","useSyncExternalStore","useCallback","useRef","useSyncExternalStore","useRef","useCallback","useSyncExternalStore"]}
+{"version":3,"sources":["../src/field-notes-canvas.tsx","../src/context.ts","../src/canvas-element.tsx","../src/hooks/use-viewport.ts","../src/hooks/use-active-tool.ts","../src/hooks/use-camera.ts","../src/hooks/use-tool-options.ts","../src/hooks/use-layers.ts","../src/hooks/use-history.ts","../src/hooks/use-elements.ts"],"sourcesContent":["import {\n  useRef,\n  useEffect,\n  useState,\n  forwardRef,\n  useImperativeHandle,\n  type ReactNode,\n  type CSSProperties,\n} from 'react';\nimport { Viewport } from '@fieldnotes/core';\nimport type { ViewportOptions, Tool } from '@fieldnotes/core';\nimport { ViewportContext } from './context';\n\nexport interface FieldNotesCanvasProps {\n  /** Constructor-only: changes after mount are ignored (the canvas is stateful). */\n  options?: ViewportOptions;\n  /**\n   * Reactive (append-only): tools present here are registered; removal is not supported.\n   * Hoist the array out of render — inline arrays reconstruct Tool instances and re-run\n   * registration on every render.\n   */\n  tools?: Tool[];\n  /** Uncontrolled initial tool. Ignored when `tool` is set. */\n  defaultTool?: string;\n  /** Controlled active tool. Pair with `onToolChange`. */\n  tool?: string;\n  /**\n   * Fires whenever the active tool changes (keyboard, API, or `tool` prop).\n   * Memoize with useCallback to avoid re-subscribing each render.\n   */\n  onToolChange?: (name: string) => void;\n  /** Reactive: toggles grid snapping. */\n  snapToGrid?: boolean;\n  className?: string;\n  style?: CSSProperties;\n  children?: ReactNode;\n  onReady?: (viewport: Viewport) => void;\n}\n\nexport interface FieldNotesCanvasRef {\n  viewport: Viewport | null;\n}\n\nexport const FieldNotesCanvas = forwardRef<FieldNotesCanvasRef, FieldNotesCanvasProps>(\n  function FieldNotesCanvas(\n    {\n      options,\n      tools,\n      defaultTool,\n      tool,\n      onToolChange,\n      snapToGrid,\n      className,\n      style,\n      children,\n      onReady,\n    },\n    ref,\n  ) {\n    const containerRef = useRef<HTMLDivElement>(null);\n    const [viewport, setViewport] = useState<Viewport | null>(null);\n\n    useImperativeHandle(ref, () => ({ viewport }), [viewport]);\n\n    useEffect(() => {\n      const el = containerRef.current;\n      if (!el) return;\n\n      const vp = new Viewport(el, options);\n\n      if (tools) {\n        for (const t of tools) {\n          vp.toolManager.register(t);\n        }\n      }\n\n      const initialTool = tool ?? defaultTool;\n      if (initialTool) {\n        vp.setTool(initialTool);\n      }\n\n      setViewport(vp);\n      onReady?.(vp);\n\n      return () => {\n        vp.destroy();\n        setViewport(null);\n      };\n      // Constructor effect: options/tools/defaultTool are mount-only by design.\n    }, []);\n\n    useEffect(() => {\n      if (!viewport || tool === undefined) return;\n      if (viewport.toolManager.activeTool?.name !== tool) {\n        viewport.setTool(tool);\n      }\n    }, [viewport, tool]);\n\n    useEffect(() => {\n      if (!viewport || !onToolChange) return;\n      return viewport.toolManager.onChange(onToolChange);\n    }, [viewport, onToolChange]);\n\n    useEffect(() => {\n      if (!viewport || snapToGrid === undefined) return;\n      viewport.setSnapToGrid(snapToGrid);\n    }, [viewport, snapToGrid]);\n\n    useEffect(() => {\n      if (!viewport || !tools) return;\n      for (const t of tools) {\n        if (!viewport.toolManager.getTool(t.name)) {\n          viewport.toolManager.register(t);\n        }\n      }\n    }, [viewport, tools]);\n\n    return (\n      <div ref={containerRef} className={className} style={style}>\n        {viewport && (\n          <ViewportContext.Provider value={viewport}>{children}</ViewportContext.Provider>\n        )}\n      </div>\n    );\n  },\n);\n","import { createContext } from 'react';\r\nimport type { Viewport } from '@fieldnotes/core';\r\n\r\nexport const ViewportContext = createContext<Viewport | null>(null);\r\n","import { useEffect, useRef, useState, type ReactNode } from 'react';\nimport { createPortal } from 'react-dom';\nimport { useViewport } from './hooks/use-viewport';\n\n/** Props for {@link CanvasElement}. */\nexport interface CanvasElementProps {\n  /** Canvas-space position of the element's top-left corner. */\n  position: { x: number; y: number };\n  /** Optional fixed size; omit to let the element size to its content. */\n  size?: { w: number; h: number };\n  children: ReactNode;\n}\n\n/**\n * Renders a React subtree as an HTML element embedded in the canvas coordinate space.\n * Must be used inside a `<FieldNotesCanvas>`.\n */\nexport function CanvasElement({ position, size, children }: CanvasElementProps) {\n  const viewport = useViewport();\n  const [portalTarget, setPortalTarget] = useState<HTMLElement | null>(null);\n  const elementIdRef = useRef<string | null>(null);\n\n  useEffect(() => {\n    const container = document.createElement('div');\n    Object.assign(container.style, {\n      width: '100%',\n      height: '100%',\n    });\n\n    // Append to domLayer immediately so portal children are queryable in the document\n    // before the viewport render loop fires via requestAnimationFrame.\n    viewport.domLayer.appendChild(container);\n\n    const id = viewport.addHtmlElement(container, position, size);\n    elementIdRef.current = id;\n    setPortalTarget(container);\n\n    return () => {\n      if (elementIdRef.current) {\n        viewport.store.remove(elementIdRef.current);\n        viewport.requestRender();\n        elementIdRef.current = null;\n      }\n      setPortalTarget(null);\n    };\n  }, [viewport]);\n\n  useEffect(() => {\n    const id = elementIdRef.current;\n    if (!id) return;\n    viewport.store.update(id, { position });\n    if (size) {\n      viewport.store.update(id, { size });\n    }\n    viewport.requestRender();\n  }, [viewport, position.x, position.y, size?.w, size?.h]);\n\n  if (!portalTarget) return null;\n  return createPortal(children, portalTarget);\n}\n","import { useContext } from 'react';\nimport type { Viewport } from '@fieldnotes/core';\nimport { ViewportContext } from '../context';\n\n/** The Viewport from the nearest `<FieldNotesCanvas>`. Throws outside one. */\nexport function useViewport(): Viewport {\n  const viewport = useContext(ViewportContext);\n  if (!viewport) {\n    throw new Error('useViewport must be used inside <FieldNotesCanvas>');\n  }\n  return viewport;\n}\n","import { useCallback, useSyncExternalStore } from 'react';\nimport { useViewport } from './use-viewport';\n\n/** `[activeToolName, setTool]` — re-renders on tool switches. */\nexport function useActiveTool(): [toolName: string, setTool: (name: string) => void] {\n  const viewport = useViewport();\n\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => viewport.toolManager.onChange(onStoreChange),\n    [viewport],\n  );\n\n  const getSnapshot = useCallback(() => viewport.toolManager.activeTool?.name ?? '', [viewport]);\n\n  const toolName = useSyncExternalStore(subscribe, getSnapshot);\n\n  const setTool = useCallback((name: string) => viewport.setTool(name), [viewport]);\n\n  return [toolName, setTool];\n}\n","import { useCallback, useRef, useSyncExternalStore } from 'react';\nimport { useViewport } from './use-viewport';\n\nexport interface CameraState {\n  x: number;\n  y: number;\n  zoom: number;\n}\n\n/** Current camera position and zoom level — re-renders whenever the camera moves or zoom changes. */\nexport function useCamera(): CameraState {\n  const viewport = useViewport();\n  const cachedRef = useRef<CameraState>({ x: 0, y: 0, zoom: 1 });\n\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => viewport.camera.onChange(onStoreChange),\n    [viewport],\n  );\n\n  const getSnapshot = useCallback((): CameraState => {\n    const { position, zoom } = viewport.camera;\n    const cached = cachedRef.current;\n    if (cached.x === position.x && cached.y === position.y && cached.zoom === zoom) {\n      return cached;\n    }\n    const next = { x: position.x, y: position.y, zoom };\n    cachedRef.current = next;\n    return next;\n  }, [viewport]);\n\n  return useSyncExternalStore(subscribe, getSnapshot);\n}\n","import { useCallback, useRef, useSyncExternalStore } from 'react';\nimport { useViewport } from './use-viewport';\n\nfunction noop() {\n  /* unsubscribe placeholder */\n}\n\n/**\n * `[options, setOptions]` for the named tool — re-renders when the tool's options change.\n * Returns `null` for options if the tool is not registered or does not expose options.\n */\nexport function useToolOptions<T extends Record<string, unknown>>(\n  toolName: string,\n): [options: T | null, setOptions: (partial: Partial<T>) => void] {\n  const viewport = useViewport();\n  const cachedRef = useRef<T | null>(null);\n\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => {\n      const tool = viewport.toolManager.getTool(toolName);\n      if (!tool?.onOptionsChange) return noop;\n      return tool.onOptionsChange(onStoreChange);\n    },\n    [viewport, toolName],\n  );\n\n  const getSnapshot = useCallback((): T | null => {\n    const tool = viewport.toolManager.getTool(toolName);\n    if (!tool?.getOptions) return null;\n    const next = tool.getOptions() as T;\n    const cached = cachedRef.current;\n    if (cached && shallowEqual(cached, next)) return cached;\n    cachedRef.current = next;\n    return next;\n  }, [viewport, toolName]);\n\n  const options = useSyncExternalStore(subscribe, getSnapshot);\n\n  const setOptions = useCallback(\n    (partial: Partial<T>) => {\n      const tool = viewport.toolManager.getTool(toolName);\n      tool?.setOptions?.(partial as Record<string, unknown>);\n    },\n    [viewport, toolName],\n  );\n\n  return [options, setOptions];\n}\n\nfunction shallowEqual(a: Record<string, unknown>, b: Record<string, unknown>): boolean {\n  const keysA = Object.keys(a);\n  const keysB = Object.keys(b);\n  if (keysA.length !== keysB.length) return false;\n  for (const key of keysA) {\n    const valA = a[key];\n    const valB = b[key];\n    if (valA === valB) continue;\n    if (\n      typeof valA === 'object' &&\n      valA !== null &&\n      typeof valB === 'object' &&\n      valB !== null &&\n      !Array.isArray(valA) &&\n      !Array.isArray(valB)\n    ) {\n      const objA = valA as Record<string, unknown>;\n      const objB = valB as Record<string, unknown>;\n      const innerKeys = Object.keys(objA);\n      if (\n        innerKeys.length === Object.keys(objB).length &&\n        innerKeys.every((k) => objA[k] === objB[k])\n      ) {\n        continue;\n      }\n    }\n    return false;\n  }\n  return true;\n}\n","import { useCallback, useRef, useSyncExternalStore } from 'react';\nimport type { Layer } from '@fieldnotes/core';\nimport { useViewport } from './use-viewport';\n\ninterface LayersSnapshot {\n  layers: Layer[];\n  activeLayerId: string;\n}\n\nexport interface UseLayersResult {\n  layers: Layer[];\n  activeLayerId: string;\n  createLayer: (name?: string) => Layer;\n  removeLayer: (id: string) => void;\n  renameLayer: (id: string, name: string) => void;\n  reorderLayer: (id: string, newOrder: number) => void;\n  setVisible: (id: string, visible: boolean) => void;\n  setLocked: (id: string, locked: boolean) => void;\n  setOpacity: (id: string, opacity: number) => void;\n  setActiveLayer: (id: string) => void;\n  moveElement: (elementId: string, layerId: string) => void;\n}\n\n/**\n * Current layer list and mutation helpers — re-renders whenever a layer is added, removed,\n * reordered, renamed, or its visibility/lock/opacity/active state changes.\n */\nexport function useLayers(): UseLayersResult {\n  const viewport = useViewport();\n  const cachedRef = useRef<LayersSnapshot>({ layers: [], activeLayerId: '' });\n\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => viewport.layerManager.on('change', onStoreChange),\n    [viewport],\n  );\n\n  const getSnapshot = useCallback((): LayersSnapshot => {\n    const layers = viewport.layerManager.getLayers();\n    const activeLayerId = viewport.layerManager.activeLayerId;\n    const cached = cachedRef.current;\n    if (\n      cached.activeLayerId === activeLayerId &&\n      cached.layers.length === layers.length &&\n      cached.layers.every((l, i) => {\n        const next = layers[i];\n        return (\n          next !== undefined &&\n          l.id === next.id &&\n          l.name === next.name &&\n          l.visible === next.visible &&\n          l.locked === next.locked &&\n          l.order === next.order &&\n          l.opacity === next.opacity\n        );\n      })\n    ) {\n      return cached;\n    }\n    const next = { layers, activeLayerId };\n    cachedRef.current = next;\n    return next;\n  }, [viewport]);\n\n  const snapshot = useSyncExternalStore(subscribe, getSnapshot);\n\n  const createLayer = useCallback(\n    (name?: string) => viewport.layerManager.createLayer(name),\n    [viewport],\n  );\n\n  const removeLayer = useCallback(\n    (id: string) => viewport.layerManager.removeLayer(id),\n    [viewport],\n  );\n\n  const renameLayer = useCallback(\n    (id: string, name: string) => viewport.layerManager.renameLayer(id, name),\n    [viewport],\n  );\n\n  const reorderLayer = useCallback(\n    (id: string, newOrder: number) => viewport.layerManager.reorderLayer(id, newOrder),\n    [viewport],\n  );\n\n  const setVisible = useCallback(\n    (id: string, visible: boolean) => viewport.layerManager.setLayerVisible(id, visible),\n    [viewport],\n  );\n\n  const setLocked = useCallback(\n    (id: string, locked: boolean) => viewport.layerManager.setLayerLocked(id, locked),\n    [viewport],\n  );\n\n  const setOpacity = useCallback(\n    (id: string, opacity: number) => viewport.layerManager.setLayerOpacity(id, opacity),\n    [viewport],\n  );\n\n  const setActiveLayer = useCallback(\n    (id: string) => viewport.layerManager.setActiveLayer(id),\n    [viewport],\n  );\n\n  const moveElement = useCallback(\n    (elementId: string, layerId: string) =>\n      viewport.layerManager.moveElementToLayer(elementId, layerId),\n    [viewport],\n  );\n\n  return {\n    layers: snapshot.layers,\n    activeLayerId: snapshot.activeLayerId,\n    createLayer,\n    removeLayer,\n    renameLayer,\n    reorderLayer,\n    setVisible,\n    setLocked,\n    setOpacity,\n    setActiveLayer,\n    moveElement,\n  };\n}\n","import { useCallback, useRef, useSyncExternalStore } from 'react';\nimport { useViewport } from './use-viewport';\n\ninterface HistorySnapshot {\n  canUndo: boolean;\n  canRedo: boolean;\n}\n\nexport interface UseHistoryResult {\n  canUndo: boolean;\n  canRedo: boolean;\n  undo: () => void;\n  redo: () => void;\n}\n\n/** `{ canUndo, canRedo, undo, redo }` — re-renders when undo/redo availability changes. */\nexport function useHistory(): UseHistoryResult {\n  const viewport = useViewport();\n  const cachedRef = useRef<HistorySnapshot>({ canUndo: false, canRedo: false });\n\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => viewport.history.onChange(onStoreChange),\n    [viewport],\n  );\n\n  const getSnapshot = useCallback((): HistorySnapshot => {\n    const canUndo = viewport.history.canUndo;\n    const canRedo = viewport.history.canRedo;\n    const cached = cachedRef.current;\n    if (cached.canUndo === canUndo && cached.canRedo === canRedo) {\n      return cached;\n    }\n    const next = { canUndo, canRedo };\n    cachedRef.current = next;\n    return next;\n  }, [viewport]);\n\n  const snapshot = useSyncExternalStore(subscribe, getSnapshot);\n\n  const undo = useCallback(() => viewport.undo(), [viewport]);\n  const redo = useCallback(() => viewport.redo(), [viewport]);\n\n  return {\n    canUndo: snapshot.canUndo,\n    canRedo: snapshot.canRedo,\n    undo,\n    redo,\n  };\n}\n","import { useCallback, useRef, useSyncExternalStore } from 'react';\nimport type { CanvasElement, ElementType } from '@fieldnotes/core';\nimport { useViewport } from './use-viewport';\n\nfunction shallowEqual(a: unknown, b: unknown): boolean {\n  if (Object.is(a, b)) return true;\n  if (Array.isArray(a) && Array.isArray(b)) {\n    return a.length === b.length && a.every((v, i) => Object.is(v, b[i]));\n  }\n  if (\n    typeof a === 'object' &&\n    a !== null &&\n    typeof b === 'object' &&\n    b !== null &&\n    !Array.isArray(a) &&\n    !Array.isArray(b)\n  ) {\n    const ka = Object.keys(a);\n    const kb = Object.keys(b);\n    return (\n      ka.length === kb.length &&\n      ka.every(\n        (k) =>\n          k in (b as Record<string, unknown>) &&\n          Object.is((a as Record<string, unknown>)[k], (b as Record<string, unknown>)[k]),\n      )\n    );\n  }\n  return false;\n}\n\n/** All elements; re-renders on every store mutation (use a selector for hot paths). */\nexport function useElements(): CanvasElement[];\n/** Elements of one type; re-renders on every store mutation. */\nexport function useElements<T extends ElementType>(type: T): Extract<CanvasElement, { type: T }>[];\n/**\n * Derived value; re-renders only when the selected value changes (per `isEqual`,\n * default: one-level shallow compare — arrays by index, plain objects by key, primitives by\n * Object.is). Keep the selector referentially stable (useCallback or module scope).\n *\n * Supply `isEqual` for deeper structures. Note: selectors returning nested fresh objects\n * (e.g. `els => els.map(e => ({ ...e.position }))`) still need a custom comparator because\n * the default only compares one level deep.\n */\nexport function useElements<R>(\n  selector: (elements: CanvasElement[]) => R,\n  isEqual?: (a: R, b: R) => boolean,\n): R;\nexport function useElements<R>(\n  arg?: ElementType | ((elements: CanvasElement[]) => R),\n  isEqual?: (a: R, b: R) => boolean,\n): CanvasElement[] | R {\n  const viewport = useViewport();\n  const cachedRef = useRef<CanvasElement[]>([]);\n  const selectedRef = useRef<{ value: R } | null>(null);\n\n  const subscribe = useCallback(\n    (onStoreChange: () => void) => viewport.store.onChange(onStoreChange),\n    [viewport],\n  );\n\n  const getSnapshot = useCallback((): CanvasElement[] | R => {\n    if (typeof arg === 'function') {\n      const next = arg(viewport.store.getAll());\n      const prev = selectedRef.current;\n      const equal: (a: R, b: R) => boolean = isEqual ?? (shallowEqual as (a: R, b: R) => boolean);\n      if (prev !== null && equal(prev.value, next)) {\n        return prev.value;\n      }\n      selectedRef.current = { value: next };\n      return next;\n    }\n\n    const next = arg ? viewport.store.getElementsByType(arg) : viewport.store.getAll();\n    const cached = cachedRef.current;\n    if (cached.length === next.length && cached.every((el, i) => el === next[i])) {\n      return cached;\n    }\n    cachedRef.current = next;\n    return next;\n  }, [viewport, arg, isEqual]);\n\n  return useSyncExternalStore(subscribe, getSnapshot);\n}\n"],"mappings":"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","names":["FieldNotesCanvas","useEffect","useRef","useState","useState","useRef","useEffect","useCallback","useRef","useSyncExternalStore","useRef","useCallback","useSyncExternalStore","useCallback","useRef","useSyncExternalStore","useRef","useCallback","useSyncExternalStore","useCallback","useRef","useSyncExternalStore","useRef","useCallback","next","useSyncExternalStore","useCallback","useRef","useSyncExternalStore","useRef","useCallback","useSyncExternalStore","useCallback","useRef","useSyncExternalStore","shallowEqual","useRef","useCallback","next","useSyncExternalStore"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fieldnotes/react",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "description": "React wrapper for Field Notes canvas SDK",
   "type": "module",
   "sideEffects": false,
@@ -50,7 +50,7 @@
     "react-dom": "^19.2.4",
     "tsup": "^8.5.1",
     "vitest": "^4.1.0",
-    "@fieldnotes/core": "0.19.0"
+    "@fieldnotes/core": "0.21.0"
   },
   "scripts": {
     "build": "tsup",