@fieldnotes/core 0.8.7 → 0.8.9

package/dist/index.d.cts

@@ -72,6 +72,8 @@ interface ArrowElement extends BaseElement {
     width: number;
     fromBinding?: Binding;
     toBinding?: Binding;
+    /** Derived from from/to/bend. Redundant in serialized state — safe to omit. */
+    cachedControlPoint?: Point;
 }
 interface ImageElement extends BaseElement {
     type: 'image';
@@ -273,8 +275,16 @@ declare class Background {
     private readonly color;
     private readonly dotRadius;
     private readonly lineWidth;
+    private cachedCanvas;
+    private cachedCtx;
+    private lastZoom;
+    private lastOffsetX;
+    private lastOffsetY;
+    private lastWidth;
+    private lastHeight;
     constructor(options?: BackgroundOptions);
     render(ctx: CanvasRenderingContext2D, camera: Camera): void;
+    private ensureCachedCanvas;
     private adaptSpacing;
     private renderDots;
     private renderGrid;
@@ -430,6 +440,15 @@ interface ExportImageOptions {
 }
 declare function exportImage(store: ElementStore, options?: ExportImageOptions, layerManager?: LayerManager): Promise<Blob | null>;
 
+interface RenderStatsSnapshot {
+    fps: number;
+    avgFrameMs: number;
+    p95FrameMs: number;
+    lastFrameMs: number;
+    lastGridMs: number;
+    frameCount: number;
+}
+
 interface ViewportOptions {
     camera?: CameraOptions;
     background?: BackgroundOptions;
@@ -494,6 +513,8 @@ declare class Viewport {
     }): string;
     updateGrid(updates: Partial<Pick<GridElement, 'gridType' | 'hexOrientation' | 'cellSize' | 'strokeColor' | 'strokeWidth' | 'opacity'>>): void;
     removeGrid(): void;
+    getRenderStats(): RenderStatsSnapshot;
+    logPerformance(intervalMs?: number): () => void;
     destroy(): void;
     private startEditingElement;
     private onTextEditStop;
@@ -511,20 +532,14 @@ declare class Viewport {
     private observeResize;
 }
 
-interface RenderStatsSnapshot {
-    fps: number;
-    avgFrameMs: number;
-    p95FrameMs: number;
-    lastFrameMs: number;
-    frameCount: number;
-}
-
 declare class ElementRenderer {
     private store;
     private imageCache;
     private onImageLoad;
     private camera;
     private canvasSize;
+    private hexTileCache;
+    private hexTileCacheKey;
     setStore(store: ElementStore): void;
     setOnImageLoad(callback: () => void): void;
     setCamera(camera: Camera): void;
@@ -540,6 +555,7 @@ declare class ElementRenderer {
     private strokeShapePath;
     private renderGrid;
     private renderImage;
+    private getHexTile;
     private getImage;
 }
 
@@ -914,6 +930,6 @@ declare class UpdateLayerCommand implements Command {
     undo(_store: ElementStore): void;
 }
 
-declare const VERSION = "0.8.7";
+declare const VERSION = "0.8.8";
 
 export { 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, ElementRenderer, ElementStore, type ElementType, type ElementUpdateEvent, EraserTool, type EraserToolOptions, EventBus, type ExportImageOptions, type GridElement, HandTool, type HexOrientation, HistoryRecorder, HistoryStack, type HistoryStackOptions, type HtmlElement, type ImageElement, ImageTool, type ImageToolOptions, InputHandler, type Layer, LayerManager, NoteEditor, type NoteElement, NoteTool, type NoteToolOptions, 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 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, createText, exportImage, exportState, findBindTarget, findBoundArrows, getArrowBounds, getArrowControlPoint, getArrowMidpoint, getArrowTangentAngle, getBendFromPoint, getEdgeIntersection, getElementBounds, getElementCenter, isBindable, isNearBezier, parseState, snapPoint, unbindArrow, updateBoundArrow };

package/dist/index.d.ts

@@ -72,6 +72,8 @@ interface ArrowElement extends BaseElement {
     width: number;
     fromBinding?: Binding;
     toBinding?: Binding;
+    /** Derived from from/to/bend. Redundant in serialized state — safe to omit. */
+    cachedControlPoint?: Point;
 }
 interface ImageElement extends BaseElement {
     type: 'image';
@@ -273,8 +275,16 @@ declare class Background {
     private readonly color;
     private readonly dotRadius;
     private readonly lineWidth;
+    private cachedCanvas;
+    private cachedCtx;
+    private lastZoom;
+    private lastOffsetX;
+    private lastOffsetY;
+    private lastWidth;
+    private lastHeight;
     constructor(options?: BackgroundOptions);
     render(ctx: CanvasRenderingContext2D, camera: Camera): void;
+    private ensureCachedCanvas;
     private adaptSpacing;
     private renderDots;
     private renderGrid;
@@ -430,6 +440,15 @@ interface ExportImageOptions {
 }
 declare function exportImage(store: ElementStore, options?: ExportImageOptions, layerManager?: LayerManager): Promise<Blob | null>;
 
+interface RenderStatsSnapshot {
+    fps: number;
+    avgFrameMs: number;
+    p95FrameMs: number;
+    lastFrameMs: number;
+    lastGridMs: number;
+    frameCount: number;
+}
+
 interface ViewportOptions {
     camera?: CameraOptions;
     background?: BackgroundOptions;
@@ -494,6 +513,8 @@ declare class Viewport {
     }): string;
     updateGrid(updates: Partial<Pick<GridElement, 'gridType' | 'hexOrientation' | 'cellSize' | 'strokeColor' | 'strokeWidth' | 'opacity'>>): void;
     removeGrid(): void;
+    getRenderStats(): RenderStatsSnapshot;
+    logPerformance(intervalMs?: number): () => void;
     destroy(): void;
     private startEditingElement;
     private onTextEditStop;
@@ -511,20 +532,14 @@ declare class Viewport {
     private observeResize;
 }
 
-interface RenderStatsSnapshot {
-    fps: number;
-    avgFrameMs: number;
-    p95FrameMs: number;
-    lastFrameMs: number;
-    frameCount: number;
-}
-
 declare class ElementRenderer {
     private store;
     private imageCache;
     private onImageLoad;
     private camera;
     private canvasSize;
+    private hexTileCache;
+    private hexTileCacheKey;
     setStore(store: ElementStore): void;
     setOnImageLoad(callback: () => void): void;
     setCamera(camera: Camera): void;
@@ -540,6 +555,7 @@ declare class ElementRenderer {
     private strokeShapePath;
     private renderGrid;
     private renderImage;
+    private getHexTile;
     private getImage;
 }
 
@@ -914,6 +930,6 @@ declare class UpdateLayerCommand implements Command {
     undo(_store: ElementStore): void;
 }
 
-declare const VERSION = "0.8.7";
+declare const VERSION = "0.8.8";
 
 export { 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, ElementRenderer, ElementStore, type ElementType, type ElementUpdateEvent, EraserTool, type EraserToolOptions, EventBus, type ExportImageOptions, type GridElement, HandTool, type HexOrientation, HistoryRecorder, HistoryStack, type HistoryStackOptions, type HtmlElement, type ImageElement, ImageTool, type ImageToolOptions, InputHandler, type Layer, LayerManager, NoteEditor, type NoteElement, NoteTool, type NoteToolOptions, 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 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, createText, exportImage, exportState, findBindTarget, findBoundArrows, getArrowBounds, getArrowControlPoint, getArrowMidpoint, getArrowTangentAngle, getBendFromPoint, getEdgeIntersection, getElementBounds, getElementCenter, isBindable, isNearBezier, parseState, snapPoint, unbindArrow, updateBoundArrow };