@fieldnotes/core 0.8.6 → 0.8.8

package/dist/index.d.cts

@@ -24,6 +24,20 @@ interface Size {
 }
 type Bounds = Point & Size;
 
+declare class Quadtree {
+    private root;
+    private _size;
+    private readonly worldBounds;
+    constructor(worldBounds: Bounds);
+    get size(): number;
+    insert(id: string, bounds: Bounds): void;
+    remove(id: string): void;
+    update(id: string, newBounds: Bounds): void;
+    query(rect: Bounds): string[];
+    queryPoint(point: Point): string[];
+    clear(): void;
+}
+
 interface BaseElement {
     id: string;
     type: string;
@@ -58,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';
@@ -139,6 +155,7 @@ declare class ElementStore {
     private elements;
     private bus;
     private layerOrderMap;
+    private spatialIndex;
     get count(): number;
     setLayerOrder(order: Map<string, number>): void;
     getAll(): CanvasElement[];
@@ -152,6 +169,8 @@ declare class ElementStore {
     clear(): void;
     snapshot(): CanvasElement[];
     loadSnapshot(elements: CanvasElement[]): void;
+    queryRect(rect: Bounds): CanvasElement[];
+    queryPoint(point: Point): CanvasElement[];
     on<K extends keyof ElementStoreEvents>(event: K, listener: (data: ElementStoreEvents[K]) => void): () => void;
     onChange(listener: () => void): () => void;
 }
@@ -160,6 +179,10 @@ interface CameraOptions {
     minZoom?: number;
     maxZoom?: number;
 }
+interface CameraChangeInfo {
+    panned: boolean;
+    zoomed: boolean;
+}
 declare class Camera {
     private x;
     private y;
@@ -176,9 +199,12 @@ declare class Camera {
     zoomAt(level: number, screenPoint: Point): void;
     screenToWorld(screen: Point): Point;
     worldToScreen(world: Point): Point;
+    getVisibleRect(canvasWidth: number, canvasHeight: number): Bounds;
     toCSSTransform(): string;
-    onChange(listener: () => void): () => void;
-    private notifyChange;
+    onChange(listener: (info: CameraChangeInfo) => void): () => void;
+    private notifyPan;
+    private notifyZoom;
+    private notifyPanAndZoom;
 }
 
 declare class LayerManager {
@@ -249,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;
@@ -487,6 +521,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;
@@ -601,29 +643,25 @@ interface GridInput extends BaseDefaults {
 declare function createGrid(input: GridInput): GridElement;
 declare function createText(input: TextInput): TextElement;
 
-interface Rect {
-    x: number;
-    y: number;
-    w: number;
-    h: number;
-}
 declare function getArrowControlPoint(from: Point, to: Point, bend: number): Point;
 declare function getArrowMidpoint(from: Point, to: Point, bend: number): Point;
 declare function getBendFromPoint(from: Point, to: Point, dragPoint: Point): number;
 declare function getArrowTangentAngle(from: Point, to: Point, bend: number, t: number): number;
 declare function isNearBezier(point: Point, from: Point, to: Point, bend: number, threshold: number): boolean;
-declare function getArrowBounds(from: Point, to: Point, bend: number): Rect;
+declare function getArrowBounds(from: Point, to: Point, bend: number): Bounds;
 
 declare function isBindable(element: CanvasElement): boolean;
 declare function getElementCenter(element: CanvasElement): Point;
-declare function getElementBounds(element: CanvasElement): Rect | null;
-declare function getEdgeIntersection(bounds: Rect, outsidePoint: Point): Point;
+declare function getEdgeIntersection(bounds: Bounds, outsidePoint: Point): Point;
 declare function findBindTarget(point: Point, store: ElementStore, threshold: number, excludeId?: string, filter?: (el: CanvasElement) => boolean): CanvasElement | null;
 declare function findBoundArrows(elementId: string, store: ElementStore): ArrowElement[];
 declare function updateBoundArrow(arrow: ArrowElement, store: ElementStore): Partial<ArrowElement> | null;
 declare function clearStaleBindings(arrow: ArrowElement, store: ElementStore): Partial<ArrowElement> | null;
 declare function unbindArrow(arrow: ArrowElement, store: ElementStore): Partial<ArrowElement>;
 
+declare function getElementBounds(element: CanvasElement): Bounds | null;
+declare function boundsIntersect(a: Bounds, b: Bounds): boolean;
+
 declare class AddElementCommand implements Command {
     private readonly element;
     constructor(element: CanvasElement);
@@ -666,6 +704,8 @@ interface PencilToolOptions {
     color?: string;
     width?: number;
     smoothing?: number;
+    minPointDistance?: number;
+    progressiveSimplifyThreshold?: number;
 }
 declare class PencilTool implements Tool {
     readonly name = "pencil";
@@ -674,6 +714,9 @@ declare class PencilTool implements Tool {
     private color;
     private width;
     private smoothing;
+    private minPointDistance;
+    private progressiveThreshold;
+    private nextSimplifyAt;
     private optionListeners;
     constructor(options?: PencilToolOptions);
     onActivate(ctx: ToolContext): void;
@@ -734,7 +777,6 @@ declare class SelectTool implements Tool {
     private getMarqueeRect;
     private findElementsInRect;
     private rectsOverlap;
-    private getElementBounds;
     private hitTest;
     private isInsideBounds;
 }
@@ -882,6 +924,6 @@ declare class UpdateLayerCommand implements Command {
     undo(_store: ElementStore): void;
 }
 
-declare const VERSION = "0.8.6";
+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 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, RemoveElementCommand, RemoveLayerCommand, 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, 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 };
+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

@@ -24,6 +24,20 @@ interface Size {
 }
 type Bounds = Point & Size;
 
+declare class Quadtree {
+    private root;
+    private _size;
+    private readonly worldBounds;
+    constructor(worldBounds: Bounds);
+    get size(): number;
+    insert(id: string, bounds: Bounds): void;
+    remove(id: string): void;
+    update(id: string, newBounds: Bounds): void;
+    query(rect: Bounds): string[];
+    queryPoint(point: Point): string[];
+    clear(): void;
+}
+
 interface BaseElement {
     id: string;
     type: string;
@@ -58,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';
@@ -139,6 +155,7 @@ declare class ElementStore {
     private elements;
     private bus;
     private layerOrderMap;
+    private spatialIndex;
     get count(): number;
     setLayerOrder(order: Map<string, number>): void;
     getAll(): CanvasElement[];
@@ -152,6 +169,8 @@ declare class ElementStore {
     clear(): void;
     snapshot(): CanvasElement[];
     loadSnapshot(elements: CanvasElement[]): void;
+    queryRect(rect: Bounds): CanvasElement[];
+    queryPoint(point: Point): CanvasElement[];
     on<K extends keyof ElementStoreEvents>(event: K, listener: (data: ElementStoreEvents[K]) => void): () => void;
     onChange(listener: () => void): () => void;
 }
@@ -160,6 +179,10 @@ interface CameraOptions {
     minZoom?: number;
     maxZoom?: number;
 }
+interface CameraChangeInfo {
+    panned: boolean;
+    zoomed: boolean;
+}
 declare class Camera {
     private x;
     private y;
@@ -176,9 +199,12 @@ declare class Camera {
     zoomAt(level: number, screenPoint: Point): void;
     screenToWorld(screen: Point): Point;
     worldToScreen(world: Point): Point;
+    getVisibleRect(canvasWidth: number, canvasHeight: number): Bounds;
     toCSSTransform(): string;
-    onChange(listener: () => void): () => void;
-    private notifyChange;
+    onChange(listener: (info: CameraChangeInfo) => void): () => void;
+    private notifyPan;
+    private notifyZoom;
+    private notifyPanAndZoom;
 }
 
 declare class LayerManager {
@@ -249,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;
@@ -487,6 +521,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;
@@ -601,29 +643,25 @@ interface GridInput extends BaseDefaults {
 declare function createGrid(input: GridInput): GridElement;
 declare function createText(input: TextInput): TextElement;
 
-interface Rect {
-    x: number;
-    y: number;
-    w: number;
-    h: number;
-}
 declare function getArrowControlPoint(from: Point, to: Point, bend: number): Point;
 declare function getArrowMidpoint(from: Point, to: Point, bend: number): Point;
 declare function getBendFromPoint(from: Point, to: Point, dragPoint: Point): number;
 declare function getArrowTangentAngle(from: Point, to: Point, bend: number, t: number): number;
 declare function isNearBezier(point: Point, from: Point, to: Point, bend: number, threshold: number): boolean;
-declare function getArrowBounds(from: Point, to: Point, bend: number): Rect;
+declare function getArrowBounds(from: Point, to: Point, bend: number): Bounds;
 
 declare function isBindable(element: CanvasElement): boolean;
 declare function getElementCenter(element: CanvasElement): Point;
-declare function getElementBounds(element: CanvasElement): Rect | null;
-declare function getEdgeIntersection(bounds: Rect, outsidePoint: Point): Point;
+declare function getEdgeIntersection(bounds: Bounds, outsidePoint: Point): Point;
 declare function findBindTarget(point: Point, store: ElementStore, threshold: number, excludeId?: string, filter?: (el: CanvasElement) => boolean): CanvasElement | null;
 declare function findBoundArrows(elementId: string, store: ElementStore): ArrowElement[];
 declare function updateBoundArrow(arrow: ArrowElement, store: ElementStore): Partial<ArrowElement> | null;
 declare function clearStaleBindings(arrow: ArrowElement, store: ElementStore): Partial<ArrowElement> | null;
 declare function unbindArrow(arrow: ArrowElement, store: ElementStore): Partial<ArrowElement>;
 
+declare function getElementBounds(element: CanvasElement): Bounds | null;
+declare function boundsIntersect(a: Bounds, b: Bounds): boolean;
+
 declare class AddElementCommand implements Command {
     private readonly element;
     constructor(element: CanvasElement);
@@ -666,6 +704,8 @@ interface PencilToolOptions {
     color?: string;
     width?: number;
     smoothing?: number;
+    minPointDistance?: number;
+    progressiveSimplifyThreshold?: number;
 }
 declare class PencilTool implements Tool {
     readonly name = "pencil";
@@ -674,6 +714,9 @@ declare class PencilTool implements Tool {
     private color;
     private width;
     private smoothing;
+    private minPointDistance;
+    private progressiveThreshold;
+    private nextSimplifyAt;
     private optionListeners;
     constructor(options?: PencilToolOptions);
     onActivate(ctx: ToolContext): void;
@@ -734,7 +777,6 @@ declare class SelectTool implements Tool {
     private getMarqueeRect;
     private findElementsInRect;
     private rectsOverlap;
-    private getElementBounds;
     private hitTest;
     private isInsideBounds;
 }
@@ -882,6 +924,6 @@ declare class UpdateLayerCommand implements Command {
     undo(_store: ElementStore): void;
 }
 
-declare const VERSION = "0.8.6";
+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 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, RemoveElementCommand, RemoveLayerCommand, 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, 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 };
+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 };