@fieldnotes/core 0.23.0 → 0.24.0

package/dist/index.d.cts

@@ -602,6 +602,7 @@ interface ViewportOptions {
     onImageError?: (info: {
         src: string;
         elementIds: string[];
+        cause?: unknown;
     }) => void;
     /** CSS-pixel margin cached beyond the viewport. Default `256`. Set `0` to disable. */
     panBufferMargin?: number;
@@ -714,7 +715,7 @@ declare class ElementRenderer {
     private gridBoundsOverride;
     setStore(store: ElementStore): void;
     setOnImageLoad(callback: () => void): void;
-    setOnImageError(callback: (src: string) => void): void;
+    setOnImageError(callback: (src: string, cause?: unknown) => void): void;
     setCamera(camera: Camera): void;
     setCanvasSize(w: number, h: number): void;
     setGridBoundsOverride(bounds: {
@@ -1261,6 +1262,6 @@ declare class UpdateLayerCommand implements Command {
     undo(_store: ElementStore): void;
 }
 
-declare const VERSION = "0.23.0";
+declare const VERSION = "0.24.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 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, isNoteContentEmpty, parseState, sanitizeNoteHtml, setFontSize, smartSnap, snapPoint, snapToHexCenter, toggleBold, toggleItalic, toggleStrikethrough, toggleUnderline, unbindArrow, updateBoundArrow };

package/dist/index.d.ts

@@ -602,6 +602,7 @@ interface ViewportOptions {
     onImageError?: (info: {
         src: string;
         elementIds: string[];
+        cause?: unknown;
     }) => void;
     /** CSS-pixel margin cached beyond the viewport. Default `256`. Set `0` to disable. */
     panBufferMargin?: number;
@@ -714,7 +715,7 @@ declare class ElementRenderer {
     private gridBoundsOverride;
     setStore(store: ElementStore): void;
     setOnImageLoad(callback: () => void): void;
-    setOnImageError(callback: (src: string) => void): void;
+    setOnImageError(callback: (src: string, cause?: unknown) => void): void;
     setCamera(camera: Camera): void;
     setCanvasSize(w: number, h: number): void;
     setGridBoundsOverride(bounds: {
@@ -1261,6 +1262,6 @@ declare class UpdateLayerCommand implements Command {
     undo(_store: ElementStore): void;
 }
 
-declare const VERSION = "0.23.0";
+declare const VERSION = "0.24.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 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, isNoteContentEmpty, parseState, sanitizeNoteHtml, setFontSize, smartSnap, snapPoint, snapToHexCenter, toggleBold, toggleItalic, toggleStrikethrough, toggleUnderline, unbindArrow, updateBoundArrow };

package/dist/index.js

@@ -923,16 +923,17 @@ var KeyboardActions = class {
     this.pasteCount = 0;
   }
   paste() {
+    if (this.deps.isToolActive()) return;
     this.flushPendingNudge();
-    if (this.clipboard.length === 0 || this.deps.isToolActive()) return;
+    if (this.clipboard.length === 0) return;
     const sel = this.selectTool();
     if (!sel) return;
     this.pasteCount++;
     this.insertClones(this.clipboard, this.pasteCount * 20, sel);
   }
   duplicate() {
-    this.flushPendingNudge();
     if (this.deps.isToolActive()) return;
+    this.flushPendingNudge();
     const sel = this.selectTool();
     if (!sel) return;
     const source = [];
@@ -1116,6 +1117,11 @@ function parseBinding(binding) {
         throw new Error(`Invalid shortcut binding "${binding}": unknown modifier "${part}"`);
     }
   }
+  if (parsed.mod && (parsed.ctrl || parsed.meta)) {
+    throw new Error(
+      `Invalid shortcut binding "${binding}": "mod" already means Ctrl or Cmd; don't combine it with ctrl/meta`
+    );
+  }
   return parsed;
 }
 function bindingMatches(p, e, allowShift) {
@@ -1259,6 +1265,10 @@ var InputHandler = class {
     this.inputFilter.reset();
     this.deferredDown = null;
     this.lastPointerEvent = null;
+    if (this.scope === "focus") {
+      this.element.removeAttribute("tabindex");
+      this.element.style.outline = "";
+    }
   }
   bind() {
     const opts = { signal: this.abortController.signal };
@@ -1589,6 +1599,22 @@ var DoubleTapDetector = class {
   }
 };
 
+// src/core/geometry.ts
+function distSqToSegment(p, a, b) {
+  const abx = b.x - a.x;
+  const aby = b.y - a.y;
+  const apx = p.x - a.x;
+  const apy = p.y - a.y;
+  const lenSq = abx * abx + aby * aby;
+  if (lenSq === 0) {
+    return apx * apx + apy * apy;
+  }
+  const t = Math.max(0, Math.min(1, (apx * abx + apy * aby) / lenSq));
+  const dx = p.x - (a.x + t * abx);
+  const dy = p.y - (a.y + t * aby);
+  return dx * dx + dy * dy;
+}
+
 // src/elements/arrow-geometry.ts
 function getArrowControlPoint(from, to, bend) {
   const midX = (from.x + to.x) / 2;
@@ -1677,16 +1703,7 @@ function bezierPoint(from, cp, to, t) {
   };
 }
 function isNearLine(point, a, b, threshold) {
-  const dx = b.x - a.x;
-  const dy = b.y - a.y;
-  const lenSq = dx * dx + dy * dy;
-  if (lenSq === 0) {
-    return Math.hypot(point.x - a.x, point.y - a.y) <= threshold;
-  }
-  const t = Math.max(0, Math.min(1, ((point.x - a.x) * dx + (point.y - a.y) * dy) / lenSq));
-  const projX = a.x + t * dx;
-  const projY = a.y + t * dy;
-  return Math.hypot(point.x - projX, point.y - projY) <= threshold;
+  return distSqToSegment(point, a, b) <= threshold * threshold;
 }
 
 // src/elements/element-bounds.ts
@@ -3117,9 +3134,9 @@ var ElementRenderer = class {
         });
       }
     };
-    img.onerror = () => {
+    img.onerror = (event) => {
       this.imageCache.set(src, "failed");
-      this.onImageError?.(src);
+      this.onImageError?.(src, event);
       this.onImageLoad?.();
     };
     return null;
@@ -3544,7 +3561,10 @@ var NoteEditor = class {
     this.editingNode.removeAttribute("data-fn-placeholder");
     this.editingNode.removeAttribute("data-fn-empty");
     const text = sanitizeNoteHtml(this.editingNode.innerHTML);
-    store.update(this.editingId, { text });
+    const current = store.getById(this.editingId);
+    if (current && (current.type === "note" || current.type === "text") && current.text !== text) {
+      store.update(this.editingId, { text });
+    }
     this.editingNode.contentEditable = "false";
     Object.assign(this.editingNode.style, {
       userSelect: "none",
@@ -5141,13 +5161,13 @@ var Viewport = class {
       this.renderLoop.markAllLayersDirty();
       this.requestRender();
     });
-    this.renderer.setOnImageError((src) => {
+    this.renderer.setOnImageError((src, cause) => {
       const elementIds = [];
       for (const el of this.store.getAll()) {
         if (el.type === "image" && el.src === src) elementIds.push(el.id);
       }
       if (options.onImageError) {
-        options.onImageError({ src, elementIds });
+        options.onImageError({ src, elementIds, cause });
       } else {
         console.warn(`[fieldnotes] image failed to load: ${src}`);
       }
@@ -5366,6 +5386,10 @@ var Viewport = class {
     this.loadState(parseState(json));
   }
   setTool(name) {
+    if (!this.toolManager.getTool(name)) {
+      console.warn(`[fieldnotes] setTool: no tool registered as "${name}"`);
+      return;
+    }
     this.toolManager.setTool(name, this.toolContext);
   }
   get shortcuts() {
@@ -5862,20 +5886,6 @@ var PencilTool = class {
 };
 
 // src/elements/stroke-hit.ts
-function distSqToSegment(p, a, b) {
-  const abx = b.x - a.x;
-  const aby = b.y - a.y;
-  const apx = p.x - a.x;
-  const apy = p.y - a.y;
-  const lenSq = abx * abx + aby * aby;
-  if (lenSq === 0) {
-    return apx * apx + apy * apy;
-  }
-  const t = Math.max(0, Math.min(1, (apx * abx + apy * aby) / lenSq));
-  const dx = p.x - (a.x + t * abx);
-  const dy = p.y - (a.y + t * aby);
-  return dx * dx + dy * dy;
-}
 function hitTestStroke(stroke, point, radius) {
   const bounds = getElementBounds(stroke);
   if (!bounds) return false;
@@ -7472,7 +7482,7 @@ var TemplateTool = class {
 };
 
 // src/index.ts
-var VERSION = "0.23.0";
+var VERSION = "0.24.0";
 export {
   AddElementCommand,
   ArrowTool,