@fieldnotes/core 0.18.0 → 0.19.0

package/dist/index.d.cts

@@ -432,12 +432,25 @@ declare class HistoryRecorder {
     private flushUpdateSnapshots;
 }
 
+type ShortcutBindings = Record<string, string | string[] | null>;
+interface ShortcutOptions {
+    scope?: 'focus' | 'window';
+    bindings?: ShortcutBindings;
+}
+interface ShortcutsApi {
+    rebind(action: string, bindings: string | string[] | null): void;
+    disable(action: string): void;
+    reset(action?: string): void;
+    getBindings(): Record<string, string[]>;
+}
+
 interface InputHandlerOptions {
     toolManager?: ToolManager;
     toolContext?: ToolContext;
     historyRecorder?: HistoryRecorder;
     historyStack?: HistoryStack;
     fitToContent?: () => void;
+    shortcuts?: ShortcutOptions;
 }
 declare class InputHandler {
     private readonly element;
@@ -458,9 +471,12 @@ declare class InputHandler {
     private deferredDown;
     private readonly abortController;
     private readonly actions;
+    private readonly shortcutMap;
+    private readonly scope;
     constructor(element: HTMLElement, camera: Camera, options?: InputHandlerOptions);
     setToolManager(toolManager: ToolManager, toolContext: ToolContext): void;
     flushPendingHistory(): void;
+    get shortcuts(): ShortcutsApi;
     destroy(): void;
     private bind;
     private onWheel;
@@ -469,6 +485,7 @@ declare class InputHandler {
     private onPointerUp;
     private onKeyDown;
     private onKeyUp;
+    private runAction;
     private startPinch;
     private handlePinchMove;
     private getPinchPoints;
@@ -479,6 +496,8 @@ declare class InputHandler {
     private dispatchToolMove;
     private dispatchToolHover;
     private dispatchToolUp;
+    private isInScope;
+    private focusSelf;
     private cancelToolIfActive;
 }
 
@@ -569,6 +588,7 @@ interface ViewportOptions {
     background?: BackgroundOptions;
     fontSizePresets?: FontSizePreset[];
     toolbar?: boolean;
+    shortcuts?: ShortcutOptions;
     onHtmlElementMount?: (elementId: string, domId: string | undefined, container: HTMLDivElement) => void;
     onDrop?: (event: DragEvent, worldPosition: {
         x: number;
@@ -617,6 +637,7 @@ declare class Viewport {
     loadState(state: CanvasState): void;
     loadJSON(json: string): void;
     setTool(name: string): void;
+    get shortcuts(): ShortcutsApi;
     undo(): boolean;
     redo(): boolean;
     addImage(src: string, position: {
@@ -1212,6 +1233,6 @@ declare class UpdateLayerCommand implements Command {
     undo(_store: ElementStore): void;
 }
 
-declare const VERSION = "0.18.0";
+declare const VERSION = "0.19.0";
 
-export { type ActiveFormats, AddElementCommand, type ArrowElement, ArrowTool, type ArrowToolOptions, AutoSave, type AutoSaveOptions, Background, type BackgroundOptions, type BackgroundPattern, BatchCommand, type Binding, type Bounds, Camera, type CameraChangeInfo, type CameraOptions, type CanvasElement, type CanvasState, type Command, CreateLayerCommand, DEFAULT_FONT_SIZE_PRESETS, DEFAULT_NOTE_FONT_SIZE, DoubleTapDetector, type DoubleTapDetectorOptions, ElementRenderer, ElementStore, type ElementType, type ElementUpdateEvent, EraserTool, type EraserToolOptions, EventBus, type ExportImageOptions, type FilterAction, type FilteredEvent, type FilteredUpEvent, type FontSizePreset, type GridElement, type GridInfo, HandTool, type HexOrientation, HistoryRecorder, HistoryStack, type HistoryStackOptions, type HtmlElement, type ImageElement, ImageTool, type ImageToolOptions, InputFilter, InputHandler, type InputHandlerOptions, type Layer, LayerManager, MeasureTool, type MeasureToolOptions, type Measurement, NoteEditor, type NoteEditorOptions, type NoteElement, NoteTool, type NoteToolOptions, NoteToolbar, PencilTool, type PencilToolOptions, type Point, type PointerState, Quadtree, RemoveElementCommand, RemoveLayerCommand, type RenderStatsSnapshot, SelectTool, type ShapeElement, type ShapeKind, ShapeTool, type ShapeToolOptions, type Size, type StrokeElement, type StrokePoint, type StyledRun, type TemplateElement, type TemplateShape, TemplateTool, type TemplateToolOptions, type TextElement, TextTool, type TextToolOptions, type Tool, type ToolContext, ToolManager, type ToolName, UpdateElementCommand, UpdateLayerCommand, VERSION, Viewport, type ViewportOptions, boundsIntersect, clearStaleBindings, createArrow, createGrid, createHtmlElement, createId, createImage, createNote, createShape, createStroke, createTemplate, createText, drawHexPath, exportImage, exportState, findBindTarget, findBoundArrows, getActiveFormats, getArrowBounds, getArrowControlPoint, getArrowMidpoint, getArrowTangentAngle, getBendFromPoint, getEdgeIntersection, getElementBounds, getElementCenter, getElementsBoundingBox, getHexCellsInCone, getHexCellsInLine, getHexCellsInRadius, getHexCellsInSquare, getHexDistance, isBindable, isNearBezier, parseState, sanitizeNoteHtml, setFontSize, smartSnap, snapPoint, snapToHexCenter, toggleBold, toggleItalic, toggleStrikethrough, toggleUnderline, unbindArrow, updateBoundArrow };
+export { type ActiveFormats, AddElementCommand, type ArrowElement, ArrowTool, type ArrowToolOptions, AutoSave, type AutoSaveOptions, Background, type BackgroundOptions, type BackgroundPattern, BatchCommand, type Binding, type Bounds, Camera, type CameraChangeInfo, type CameraOptions, type CanvasElement, type CanvasState, type Command, CreateLayerCommand, DEFAULT_FONT_SIZE_PRESETS, DEFAULT_NOTE_FONT_SIZE, DoubleTapDetector, type DoubleTapDetectorOptions, ElementRenderer, ElementStore, type ElementType, type ElementUpdateEvent, EraserTool, type EraserToolOptions, EventBus, type ExportImageOptions, type FilterAction, type FilteredEvent, type FilteredUpEvent, type FontSizePreset, type GridElement, type GridInfo, HandTool, type HexOrientation, HistoryRecorder, HistoryStack, type HistoryStackOptions, type HtmlElement, type ImageElement, ImageTool, type ImageToolOptions, InputFilter, InputHandler, type InputHandlerOptions, type Layer, LayerManager, MeasureTool, type MeasureToolOptions, type Measurement, NoteEditor, type NoteEditorOptions, type NoteElement, NoteTool, type NoteToolOptions, NoteToolbar, PencilTool, type PencilToolOptions, type Point, type PointerState, Quadtree, RemoveElementCommand, RemoveLayerCommand, type RenderStatsSnapshot, SelectTool, type ShapeElement, type ShapeKind, ShapeTool, type ShapeToolOptions, type ShortcutBindings, type ShortcutOptions, type ShortcutsApi, type Size, type StrokeElement, type StrokePoint, type StyledRun, type TemplateElement, type TemplateShape, TemplateTool, type TemplateToolOptions, type TextElement, TextTool, type TextToolOptions, type Tool, type ToolContext, ToolManager, type ToolName, UpdateElementCommand, UpdateLayerCommand, VERSION, Viewport, type ViewportOptions, boundsIntersect, clearStaleBindings, createArrow, createGrid, createHtmlElement, createId, createImage, createNote, createShape, createStroke, createTemplate, createText, drawHexPath, exportImage, exportState, findBindTarget, findBoundArrows, getActiveFormats, getArrowBounds, getArrowControlPoint, getArrowMidpoint, getArrowTangentAngle, getBendFromPoint, getEdgeIntersection, getElementBounds, getElementCenter, getElementsBoundingBox, getHexCellsInCone, getHexCellsInLine, getHexCellsInRadius, getHexCellsInSquare, getHexDistance, isBindable, isNearBezier, parseState, sanitizeNoteHtml, setFontSize, smartSnap, snapPoint, snapToHexCenter, toggleBold, toggleItalic, toggleStrikethrough, toggleUnderline, unbindArrow, updateBoundArrow };

package/dist/index.d.ts

@@ -432,12 +432,25 @@ declare class HistoryRecorder {
     private flushUpdateSnapshots;
 }
 
+type ShortcutBindings = Record<string, string | string[] | null>;
+interface ShortcutOptions {
+    scope?: 'focus' | 'window';
+    bindings?: ShortcutBindings;
+}
+interface ShortcutsApi {
+    rebind(action: string, bindings: string | string[] | null): void;
+    disable(action: string): void;
+    reset(action?: string): void;
+    getBindings(): Record<string, string[]>;
+}
+
 interface InputHandlerOptions {
     toolManager?: ToolManager;
     toolContext?: ToolContext;
     historyRecorder?: HistoryRecorder;
     historyStack?: HistoryStack;
     fitToContent?: () => void;
+    shortcuts?: ShortcutOptions;
 }
 declare class InputHandler {
     private readonly element;
@@ -458,9 +471,12 @@ declare class InputHandler {
     private deferredDown;
     private readonly abortController;
     private readonly actions;
+    private readonly shortcutMap;
+    private readonly scope;
     constructor(element: HTMLElement, camera: Camera, options?: InputHandlerOptions);
     setToolManager(toolManager: ToolManager, toolContext: ToolContext): void;
     flushPendingHistory(): void;
+    get shortcuts(): ShortcutsApi;
     destroy(): void;
     private bind;
     private onWheel;
@@ -469,6 +485,7 @@ declare class InputHandler {
     private onPointerUp;
     private onKeyDown;
     private onKeyUp;
+    private runAction;
     private startPinch;
     private handlePinchMove;
     private getPinchPoints;
@@ -479,6 +496,8 @@ declare class InputHandler {
     private dispatchToolMove;
     private dispatchToolHover;
     private dispatchToolUp;
+    private isInScope;
+    private focusSelf;
     private cancelToolIfActive;
 }
 
@@ -569,6 +588,7 @@ interface ViewportOptions {
     background?: BackgroundOptions;
     fontSizePresets?: FontSizePreset[];
     toolbar?: boolean;
+    shortcuts?: ShortcutOptions;
     onHtmlElementMount?: (elementId: string, domId: string | undefined, container: HTMLDivElement) => void;
     onDrop?: (event: DragEvent, worldPosition: {
         x: number;
@@ -617,6 +637,7 @@ declare class Viewport {
     loadState(state: CanvasState): void;
     loadJSON(json: string): void;
     setTool(name: string): void;
+    get shortcuts(): ShortcutsApi;
     undo(): boolean;
     redo(): boolean;
     addImage(src: string, position: {
@@ -1212,6 +1233,6 @@ declare class UpdateLayerCommand implements Command {
     undo(_store: ElementStore): void;
 }
 
-declare const VERSION = "0.18.0";
+declare const VERSION = "0.19.0";
 
-export { type ActiveFormats, AddElementCommand, type ArrowElement, ArrowTool, type ArrowToolOptions, AutoSave, type AutoSaveOptions, Background, type BackgroundOptions, type BackgroundPattern, BatchCommand, type Binding, type Bounds, Camera, type CameraChangeInfo, type CameraOptions, type CanvasElement, type CanvasState, type Command, CreateLayerCommand, DEFAULT_FONT_SIZE_PRESETS, DEFAULT_NOTE_FONT_SIZE, DoubleTapDetector, type DoubleTapDetectorOptions, ElementRenderer, ElementStore, type ElementType, type ElementUpdateEvent, EraserTool, type EraserToolOptions, EventBus, type ExportImageOptions, type FilterAction, type FilteredEvent, type FilteredUpEvent, type FontSizePreset, type GridElement, type GridInfo, HandTool, type HexOrientation, HistoryRecorder, HistoryStack, type HistoryStackOptions, type HtmlElement, type ImageElement, ImageTool, type ImageToolOptions, InputFilter, InputHandler, type InputHandlerOptions, type Layer, LayerManager, MeasureTool, type MeasureToolOptions, type Measurement, NoteEditor, type NoteEditorOptions, type NoteElement, NoteTool, type NoteToolOptions, NoteToolbar, PencilTool, type PencilToolOptions, type Point, type PointerState, Quadtree, RemoveElementCommand, RemoveLayerCommand, type RenderStatsSnapshot, SelectTool, type ShapeElement, type ShapeKind, ShapeTool, type ShapeToolOptions, type Size, type StrokeElement, type StrokePoint, type StyledRun, type TemplateElement, type TemplateShape, TemplateTool, type TemplateToolOptions, type TextElement, TextTool, type TextToolOptions, type Tool, type ToolContext, ToolManager, type ToolName, UpdateElementCommand, UpdateLayerCommand, VERSION, Viewport, type ViewportOptions, boundsIntersect, clearStaleBindings, createArrow, createGrid, createHtmlElement, createId, createImage, createNote, createShape, createStroke, createTemplate, createText, drawHexPath, exportImage, exportState, findBindTarget, findBoundArrows, getActiveFormats, getArrowBounds, getArrowControlPoint, getArrowMidpoint, getArrowTangentAngle, getBendFromPoint, getEdgeIntersection, getElementBounds, getElementCenter, getElementsBoundingBox, getHexCellsInCone, getHexCellsInLine, getHexCellsInRadius, getHexCellsInSquare, getHexDistance, isBindable, isNearBezier, parseState, sanitizeNoteHtml, setFontSize, smartSnap, snapPoint, snapToHexCenter, toggleBold, toggleItalic, toggleStrikethrough, toggleUnderline, unbindArrow, updateBoundArrow };
+export { type ActiveFormats, AddElementCommand, type ArrowElement, ArrowTool, type ArrowToolOptions, AutoSave, type AutoSaveOptions, Background, type BackgroundOptions, type BackgroundPattern, BatchCommand, type Binding, type Bounds, Camera, type CameraChangeInfo, type CameraOptions, type CanvasElement, type CanvasState, type Command, CreateLayerCommand, DEFAULT_FONT_SIZE_PRESETS, DEFAULT_NOTE_FONT_SIZE, DoubleTapDetector, type DoubleTapDetectorOptions, ElementRenderer, ElementStore, type ElementType, type ElementUpdateEvent, EraserTool, type EraserToolOptions, EventBus, type ExportImageOptions, type FilterAction, type FilteredEvent, type FilteredUpEvent, type FontSizePreset, type GridElement, type GridInfo, HandTool, type HexOrientation, HistoryRecorder, HistoryStack, type HistoryStackOptions, type HtmlElement, type ImageElement, ImageTool, type ImageToolOptions, InputFilter, InputHandler, type InputHandlerOptions, type Layer, LayerManager, MeasureTool, type MeasureToolOptions, type Measurement, NoteEditor, type NoteEditorOptions, type NoteElement, NoteTool, type NoteToolOptions, NoteToolbar, PencilTool, type PencilToolOptions, type Point, type PointerState, Quadtree, RemoveElementCommand, RemoveLayerCommand, type RenderStatsSnapshot, SelectTool, type ShapeElement, type ShapeKind, ShapeTool, type ShapeToolOptions, type ShortcutBindings, type ShortcutOptions, type ShortcutsApi, type Size, type StrokeElement, type StrokePoint, type StyledRun, type TemplateElement, type TemplateShape, TemplateTool, type TemplateToolOptions, type TextElement, TextTool, type TextToolOptions, type Tool, type ToolContext, ToolManager, type ToolName, UpdateElementCommand, UpdateLayerCommand, VERSION, Viewport, type ViewportOptions, boundsIntersect, clearStaleBindings, createArrow, createGrid, createHtmlElement, createId, createImage, createNote, createShape, createStroke, createTemplate, createText, drawHexPath, exportImage, exportState, findBindTarget, findBoundArrows, getActiveFormats, getArrowBounds, getArrowControlPoint, getArrowMidpoint, getArrowTangentAngle, getBendFromPoint, getEdgeIntersection, getElementBounds, getElementCenter, getElementsBoundingBox, getHexCellsInCone, getHexCellsInLine, getHexCellsInRadius, getHexCellsInSquare, getHexDistance, isBindable, isNearBezier, parseState, sanitizeNoteHtml, setFontSize, smartSnap, snapPoint, snapToHexCenter, toggleBold, toggleItalic, toggleStrikethrough, toggleUnderline, unbindArrow, updateBoundArrow };

package/dist/index.js

@@ -1041,14 +1041,158 @@ var KeyboardActions = class {
   }
 };
 
+// src/canvas/shortcut-map.ts
+var DEFAULT_BINDINGS = [
+  ["delete", ["delete", "backspace"]],
+  ["deselect", ["escape"]],
+  ["undo", ["mod+z"]],
+  ["redo", ["mod+y", "mod+shift+z"]],
+  ["select-all", ["mod+a"]],
+  ["copy", ["mod+c"]],
+  ["paste", ["mod+v"]],
+  ["duplicate", ["mod+d"]],
+  ["z-forward", ["]"]],
+  ["z-backward", ["["]],
+  ["z-front", ["mod+]"]],
+  ["z-back", ["mod+["]],
+  ["zoom-fit", ["shift+1"]],
+  ["nudge-left", ["arrowleft"]],
+  ["nudge-right", ["arrowright"]],
+  ["nudge-up", ["arrowup"]],
+  ["nudge-down", ["arrowdown"]],
+  ["tool:select", ["v"]],
+  ["tool:hand", ["h"]],
+  ["tool:pencil", ["p"]],
+  ["tool:eraser", ["e"]],
+  ["tool:arrow", ["a"]],
+  ["tool:note", ["n"]],
+  ["tool:text", ["t"]],
+  ["tool:shape", ["s"]],
+  ["tool:measure", ["m"]],
+  ["tool:template", ["g"]]
+];
+var ALLOW_SHIFT = /* @__PURE__ */ new Set(["nudge-left", "nudge-right", "nudge-up", "nudge-down"]);
+var MODIFIERS = /* @__PURE__ */ new Set(["mod", "ctrl", "meta", "shift", "alt"]);
+function parseBinding(binding) {
+  const parts = binding.toLowerCase().split("+");
+  const key = parts.pop();
+  if (key === void 0 || key.length === 0 || MODIFIERS.has(key)) {
+    throw new Error(`Invalid shortcut binding "${binding}": missing key`);
+  }
+  const normalizedKey = key === "space" ? " " : key;
+  const parsed = {
+    mod: false,
+    ctrl: false,
+    meta: false,
+    shift: false,
+    alt: false,
+    key: normalizedKey,
+    digit: /^[0-9]$/.test(normalizedKey)
+  };
+  for (const part of parts) {
+    switch (part) {
+      case "mod":
+        parsed.mod = true;
+        break;
+      case "ctrl":
+        parsed.ctrl = true;
+        break;
+      case "meta":
+        parsed.meta = true;
+        break;
+      case "shift":
+        parsed.shift = true;
+        break;
+      case "alt":
+        parsed.alt = true;
+        break;
+      default:
+        throw new Error(`Invalid shortcut binding "${binding}": unknown modifier "${part}"`);
+    }
+  }
+  return parsed;
+}
+function bindingMatches(p, e, allowShift) {
+  if (p.mod) {
+    if (!e.ctrlKey && !e.metaKey) return false;
+  } else if (e.ctrlKey !== p.ctrl || e.metaKey !== p.meta) {
+    return false;
+  }
+  if (!allowShift && e.shiftKey !== p.shift) return false;
+  if (e.altKey !== p.alt) return false;
+  return p.digit ? e.code === `Digit${p.key}` : e.key.toLowerCase() === p.key;
+}
+function toArray(bindings) {
+  if (bindings === null) return [];
+  return Array.isArray(bindings) ? [...bindings] : [bindings];
+}
+var ShortcutMap = class {
+  raw = /* @__PURE__ */ new Map();
+  parsed = /* @__PURE__ */ new Map();
+  constructor(overrides) {
+    this.applyDefaults();
+    if (overrides) {
+      for (const [action, bindings] of Object.entries(overrides)) {
+        this.rebind(action, bindings);
+      }
+    }
+  }
+  /** First matching action in registration order wins when bindings conflict. */
+  match(e) {
+    for (const [action, parsedList] of this.parsed) {
+      const allowShift = ALLOW_SHIFT.has(action);
+      for (const p of parsedList) {
+        if (bindingMatches(p, e, allowShift)) return action;
+      }
+    }
+    return null;
+  }
+  rebind(action, bindings) {
+    const list = toArray(bindings);
+    const parsedList = list.map(parseBinding);
+    this.raw.set(action, list);
+    this.parsed.set(action, parsedList);
+  }
+  disable(action) {
+    this.rebind(action, null);
+  }
+  reset(action) {
+    if (action === void 0) {
+      this.raw.clear();
+      this.parsed.clear();
+      this.applyDefaults();
+      return;
+    }
+    const def = DEFAULT_BINDINGS.find(([name]) => name === action);
+    if (def) {
+      this.rebind(action, [...def[1]]);
+    } else if (this.raw.has(action)) {
+      this.raw.delete(action);
+      this.parsed.delete(action);
+    }
+  }
+  getBindings() {
+    const out = {};
+    for (const [action, list] of this.raw) {
+      out[action] = [...list];
+    }
+    return out;
+  }
+  applyDefaults() {
+    for (const [action, bindings] of DEFAULT_BINDINGS) {
+      this.rebind(action, [...bindings]);
+    }
+  }
+};
+
 // src/canvas/input-handler.ts
 var ZOOM_SENSITIVITY = 1e-3;
 var MIDDLE_BUTTON = 1;
-var NUDGE_KEYS = {
-  ArrowLeft: [-1, 0],
-  ArrowRight: [1, 0],
-  ArrowUp: [0, -1],
-  ArrowDown: [0, 1]
+var NUDGE_DELTAS = {
+  "nudge-left": [-1, 0],
+  "nudge-right": [1, 0],
+  "nudge-up": [0, -1],
+  "nudge-down": [0, 1]
 };
 var InputHandler = class {
   constructor(element, camera, options = {}) {
@@ -1066,7 +1210,13 @@ var InputHandler = class {
       isToolActive: () => this.isToolActive,
       fitToContent: options.fitToContent
     });
+    this.shortcutMap = new ShortcutMap(options.shortcuts?.bindings);
+    this.scope = options.shortcuts?.scope ?? "focus";
     this.element.style.touchAction = "none";
+    if (this.scope === "focus") {
+      this.element.tabIndex = 0;
+      this.element.style.outline = "none";
+    }
     this.bind();
   }
   isPanning = false;
@@ -1085,6 +1235,8 @@ var InputHandler = class {
   deferredDown = null;
   abortController = new AbortController();
   actions;
+  shortcutMap;
+  scope;
   setToolManager(toolManager, toolContext) {
     this.toolManager = toolManager;
     this.toolContext = toolContext;
@@ -1092,6 +1244,9 @@ var InputHandler = class {
   flushPendingHistory() {
     this.actions.flushPendingNudge();
   }
+  get shortcuts() {
+    return this.shortcutMap;
+  }
   destroy() {
     this.actions.dispose();
     this.abortController.abort();
@@ -1121,6 +1276,7 @@ var InputHandler = class {
     });
   };
   onPointerDown = (e) => {
+    this.focusSelf();
     this.activePointers.set(e.pointerId, { x: e.clientX, y: e.clientY });
     this.element.setPointerCapture?.(e.pointerId);
     if (this.activePointers.size === 2) {
@@ -1203,57 +1359,13 @@ var InputHandler = class {
     if (target?.isContentEditable) return;
     const tag = target?.tagName;
     if (tag === "INPUT" || tag === "TEXTAREA" || tag === "SELECT") return;
+    if (!this.isInScope()) return;
     if (e.key === " ") {
       this.spaceHeld = true;
     }
-    if (e.key === "Delete" || e.key === "Backspace") {
-      this.actions.deleteSelected();
-    }
-    if (e.key === "Escape") {
-      this.actions.deselect();
-    }
-    if ((e.ctrlKey || e.metaKey) && e.key === "z" && !e.shiftKey) {
-      e.preventDefault();
-      this.actions.undo();
-    }
-    if ((e.ctrlKey || e.metaKey) && (e.key === "y" || e.key === "z" && e.shiftKey)) {
-      e.preventDefault();
-      this.actions.redo();
-    }
-    if ((e.ctrlKey || e.metaKey) && e.key === "a") {
-      e.preventDefault();
-      this.actions.selectAll();
-    }
-    if ((e.ctrlKey || e.metaKey) && e.key === "c") {
-      e.preventDefault();
-      this.actions.copy();
-    }
-    if ((e.ctrlKey || e.metaKey) && e.key === "v") {
-      e.preventDefault();
-      this.actions.paste();
-    }
-    if ((e.ctrlKey || e.metaKey) && e.key === "d") {
-      e.preventDefault();
-      this.actions.duplicate();
-    }
-    if (e.key === "]") {
-      e.preventDefault();
-      this.actions.zOrder(e.ctrlKey || e.metaKey ? "front" : "forward");
-    }
-    if (e.key === "[") {
-      e.preventDefault();
-      this.actions.zOrder(e.ctrlKey || e.metaKey ? "back" : "backward");
-    }
-    if (e.shiftKey && e.code === "Digit1" && !e.ctrlKey && !e.metaKey && !e.altKey) {
-      e.preventDefault();
-      this.actions.zoomToFit();
-    }
-    const nudgeDelta = NUDGE_KEYS[e.key];
-    if (nudgeDelta) {
-      const [dx, dy] = nudgeDelta;
-      if (this.actions.nudge(dx, dy, e.shiftKey)) {
-        e.preventDefault();
-      }
+    const action = this.shortcutMap.match(e);
+    if (action !== null) {
+      this.runAction(action, e);
     }
   };
   onKeyUp = (e) => {
@@ -1268,6 +1380,79 @@ var InputHandler = class {
       }
     }
   };
+  runAction(action, e) {
+    switch (action) {
+      case "delete":
+        e.preventDefault();
+        this.actions.deleteSelected();
+        return;
+      case "deselect":
+        this.actions.deselect();
+        return;
+      case "undo":
+        e.preventDefault();
+        this.actions.undo();
+        return;
+      case "redo":
+        e.preventDefault();
+        this.actions.redo();
+        return;
+      case "select-all":
+        e.preventDefault();
+        this.actions.selectAll();
+        return;
+      case "copy":
+        e.preventDefault();
+        this.actions.copy();
+        return;
+      case "paste":
+        e.preventDefault();
+        this.actions.paste();
+        return;
+      case "duplicate":
+        e.preventDefault();
+        this.actions.duplicate();
+        return;
+      case "z-forward":
+        e.preventDefault();
+        this.actions.zOrder("forward");
+        return;
+      case "z-backward":
+        e.preventDefault();
+        this.actions.zOrder("backward");
+        return;
+      case "z-front":
+        e.preventDefault();
+        this.actions.zOrder("front");
+        return;
+      case "z-back":
+        e.preventDefault();
+        this.actions.zOrder("back");
+        return;
+      case "zoom-fit":
+        e.preventDefault();
+        this.actions.zoomToFit();
+        return;
+      case "nudge-left":
+      case "nudge-right":
+      case "nudge-up":
+      case "nudge-down": {
+        const delta = NUDGE_DELTAS[action];
+        if (delta && this.actions.nudge(delta[0], delta[1], e.shiftKey)) {
+          e.preventDefault();
+        }
+        return;
+      }
+      default:
+        if (action.startsWith("tool:")) {
+          if (this.isToolActive) return;
+          e.preventDefault();
+          this.toolContext?.switchTool?.(action.slice("tool:".length));
+          return;
+        }
+        console.warn(`[fieldnotes] unknown shortcut action "${action}"`);
+    }
+  }
   startPinch() {
     this.inputFilter.reset();
     this.deferredDown = null;
@@ -1338,6 +1523,15 @@ var InputHandler = class {
     this.toolManager.handlePointerUp(this.toPointerState(e), this.toolContext);
     this.historyRecorder?.commit();
   }
+  isInScope() {
+    if (this.scope === "window") return true;
+    const active = document.activeElement;
+    return active === this.element || this.element.contains(active);
+  }
+  focusSelf() {
+    if (this.scope !== "focus" || this.isInScope()) return;
+    this.element.focus({ preventScroll: true });
+  }
   cancelToolIfActive(e) {
     if (this.isToolActive) {
       this.dispatchToolUp(e);
@@ -4732,7 +4926,8 @@ var Viewport = class {
       toolContext: this.toolContext,
       historyRecorder: this.historyRecorder,
       historyStack: this.history,
-      fitToContent: () => this.fitToContent()
+      fitToContent: () => this.fitToContent(),
+      shortcuts: options.shortcuts
     });
     this.domNodeManager = new DomNodeManager({
       domLayer: this.domLayer,
@@ -4906,6 +5101,9 @@ var Viewport = class {
   setTool(name) {
     this.toolManager.setTool(name, this.toolContext);
   }
+  get shortcuts() {
+    return this.inputHandler.shortcuts;
+  }
   undo() {
     this.inputHandler.flushPendingHistory();
     this.historyRecorder.pause();
@@ -6944,7 +7142,7 @@ var TemplateTool = class {
 };
 
 // src/index.ts
-var VERSION = "0.18.0";
+var VERSION = "0.19.0";
 export {
   AddElementCommand,
   ArrowTool,