@fieldnotes/core 0.22.0 → 0.24.0

package/dist/index.d.cts

@@ -602,7 +602,10 @@ 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;
 }
 declare class Viewport {
     private readonly container;
@@ -622,6 +625,7 @@ declare class Viewport {
     private readonly noteEditor;
     private readonly historyRecorder;
     readonly toolContext: ToolContext;
+    private readonly marginViewport;
     private resizeObserver;
     private _snapToGrid;
     private readonly _gridSize;
@@ -708,11 +712,18 @@ declare class ElementRenderer {
     private canvasSize;
     private hexTileCache;
     private hexTileCacheKey;
+    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: {
+        minX: number;
+        minY: number;
+        maxX: number;
+        maxY: number;
+    } | null): void;
     isDomElement(element: CanvasElement): boolean;
     renderCanvasElement(ctx: CanvasRenderingContext2D, element: CanvasElement): void;
     private renderStroke;
@@ -1251,6 +1262,6 @@ declare class UpdateLayerCommand implements Command {
     undo(_store: ElementStore): void;
 }
 
-declare const VERSION = "0.22.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,7 +602,10 @@ 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;
 }
 declare class Viewport {
     private readonly container;
@@ -622,6 +625,7 @@ declare class Viewport {
     private readonly noteEditor;
     private readonly historyRecorder;
     readonly toolContext: ToolContext;
+    private readonly marginViewport;
     private resizeObserver;
     private _snapToGrid;
     private readonly _gridSize;
@@ -708,11 +712,18 @@ declare class ElementRenderer {
     private canvasSize;
     private hexTileCache;
     private hexTileCacheKey;
+    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: {
+        minX: number;
+        minY: number;
+        maxX: number;
+        maxY: number;
+    } | null): void;
     isDomElement(element: CanvasElement): boolean;
     renderCanvasElement(ctx: CanvasRenderingContext2D, element: CanvasElement): void;
     private renderStroke;
@@ -1251,6 +1262,6 @@ declare class UpdateLayerCommand implements Command {
     undo(_store: ElementStore): void;
 }
 
-declare const VERSION = "0.22.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 };