@fieldnotes/react 0.4.1 → 0.5.0

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 {