@fieldnotes/core 0.13.0 → 0.15.0

package/dist/index.d.cts

@@ -85,6 +85,7 @@ interface HtmlElement extends BaseElement {
     type: 'html';
     size: Size;
     domId?: string;
+    interactive?: boolean;
 }
 interface TextElement extends BaseElement {
     type: 'text';
@@ -146,11 +147,12 @@ interface CanvasState {
     };
     elements: CanvasElement[];
     layers?: Layer[];
+    activeLayerId?: string;
 }
 declare function exportState(elements: CanvasElement[], camera: {
     position: Point;
     zoom: number;
-}, layers?: Layer[]): CanvasState;
+}, layers?: Layer[], activeLayerId?: string): CanvasState;
 declare function parseState(json: string): CanvasState;
 
 interface CameraOptions {
@@ -178,6 +180,7 @@ declare class Camera {
     screenToWorld(screen: Point): Point;
     worldToScreen(world: Point): Point;
     getVisibleRect(canvasWidth: number, canvasHeight: number): Bounds;
+    fitToContent(boundingBox: Bounds, canvasWidth: number, canvasHeight: number, padding?: number): void;
     toCSSTransform(): string;
     onChange(listener: (info: CameraChangeInfo) => void): () => void;
     private notifyPan;
@@ -200,7 +203,10 @@ declare class ElementStore {
     private bus;
     private layerOrderMap;
     private spatialIndex;
+    private sortedCache;
+    private _versions;
     get count(): number;
+    getVersion(id: string): number;
     setLayerOrder(order: Map<string, number>): void;
     getAll(): CanvasElement[];
     getById(id: string): CanvasElement | undefined;
@@ -213,6 +219,10 @@ declare class ElementStore {
     clear(): void;
     snapshot(): CanvasElement[];
     loadSnapshot(elements: CanvasElement[]): void;
+    bringToFront(id: string): void;
+    sendToBack(id: string): void;
+    bringForward(id: string): void;
+    sendBackward(id: string): void;
     queryRect(rect: Bounds): CanvasElement[];
     queryPoint(point: Point): CanvasElement[];
     on<K extends keyof ElementStoreEvents>(event: K, listener: (data: ElementStoreEvents[K]) => void): () => void;
@@ -238,6 +248,8 @@ interface PointerState {
     x: number;
     y: number;
     pressure: number;
+    pointerType: 'mouse' | 'touch' | 'pen';
+    shiftKey: boolean;
 }
 interface Tool {
     readonly name: string;
@@ -293,6 +305,7 @@ interface AutoSaveOptions {
     key?: string;
     debounceMs?: number;
     layerManager?: LayerManager;
+    onError?: (error: Error) => void;
 }
 declare class AutoSave {
     private readonly store;
@@ -302,6 +315,7 @@ declare class AutoSave {
     private readonly layerManager?;
     private timerId;
     private unsubscribers;
+    private readonly onError?;
     constructor(store: ElementStore, camera: Camera, options?: AutoSaveOptions);
     start(): void;
     stop(): void;
@@ -423,7 +437,12 @@ declare class InputHandler {
     private historyRecorder;
     private historyStack;
     private isToolActive;
+    private lastPointerEvent;
+    private readonly inputFilter;
+    private deferredDown;
     private readonly abortController;
+    private clipboard;
+    private pasteCount;
     constructor(element: HTMLElement, camera: Camera, options?: InputHandlerOptions);
     setToolManager(toolManager: ToolManager, toolContext: ToolContext): void;
     destroy(): void;
@@ -447,9 +466,49 @@ declare class InputHandler {
     private deleteSelected;
     private handleUndo;
     private handleRedo;
+    private handleCopy;
+    private handlePaste;
+    private handleZOrder;
     private cancelToolIfActive;
 }
 
+type FilterAction = 'dispatch' | 'suppress' | 'defer';
+interface FilteredEvent {
+    event: PointerEvent;
+    action: FilterAction;
+}
+interface FilteredUpEvent extends FilteredEvent {
+    pendingTap?: {
+        x: number;
+        y: number;
+    };
+}
+declare class InputFilter {
+    private activePenId;
+    private pendingTap;
+    static readonly MIN_MOVE_DISTANCE = 3;
+    filterDown(e: PointerEvent): FilteredEvent;
+    filterMove(e: PointerEvent): FilteredEvent;
+    filterUp(e: PointerEvent): FilteredUpEvent;
+    reset(): void;
+}
+
+interface DoubleTapDetectorOptions {
+    timeout?: number;
+    maxDistance?: number;
+}
+declare class DoubleTapDetector {
+    private readonly timeout;
+    private readonly maxDistance;
+    private lastTapTime;
+    private lastTapX;
+    private lastTapY;
+    private hasPendingTap;
+    constructor(options?: DoubleTapDetectorOptions);
+    feed(e: PointerEvent): boolean;
+    reset(): void;
+}
+
 interface FontSizePreset {
     label: string;
     size: number;
@@ -526,6 +585,9 @@ declare class Viewport {
     private readonly domNodeManager;
     private readonly interactMode;
     private readonly gridChangeListeners;
+    private readonly doubleTapDetector;
+    private tapDownX;
+    private tapDownY;
     constructor(container: HTMLElement, options?: ViewportOptions);
     get ctx(): CanvasRenderingContext2D | null;
     get snapToGrid(): boolean;
@@ -569,7 +631,8 @@ declare class Viewport {
     destroy(): void;
     private startEditingElement;
     private onTextEditStop;
-    private onDblClick;
+    private onTapDown;
+    private onDoubleTap;
     private hitTestWorld;
     stopInteracting(): void;
     private onDragOver;
@@ -706,6 +769,7 @@ interface HtmlInput extends BaseDefaults {
     position: Point;
     size: Size;
     domId?: string;
+    interactive?: boolean;
 }
 interface TextInput extends BaseDefaults {
     position: Point;
@@ -772,6 +836,8 @@ declare function unbindArrow(arrow: ArrowElement, store: ElementStore): Partial<
 declare function getElementBounds(element: CanvasElement): Bounds | null;
 declare function boundsIntersect(a: Bounds, b: Bounds): boolean;
 
+declare function getElementsBoundingBox(elements: CanvasElement[]): Bounds | null;
+
 declare function getHexDistance(a: Point, b: Point, cellSize: number, orientation: HexOrientation): number;
 declare function getHexCellsInRadius(center: Point, radiusCells: number, cellSize: number, orientation: HexOrientation): Point[];
 declare function getHexCellsInCone(center: Point, angle: number, radiusCells: number, cellSize: number, orientation: HexOrientation): Point[];
@@ -874,7 +940,11 @@ declare class SelectTool implements Tool {
     private lastWorld;
     private currentWorld;
     private ctx;
+    private pendingSingleSelectId;
+    private hasDragged;
+    private resizeAspectRatio;
     get selectedIds(): string[];
+    setSelection(ids: string[]): void;
     get isMarqueeActive(): boolean;
     onActivate(ctx: ToolContext): void;
     onDeactivate(ctx: ToolContext): void;
@@ -1119,6 +1189,6 @@ declare class UpdateLayerCommand implements Command {
     undo(_store: ElementStore): void;
 }
 
-declare const VERSION = "0.11.0";
+declare const VERSION = "0.15.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, ElementRenderer, ElementStore, type ElementType, type ElementUpdateEvent, EraserTool, type EraserToolOptions, EventBus, type ExportImageOptions, type FontSizePreset, type GridElement, type GridInfo, HandTool, type HexOrientation, HistoryRecorder, HistoryStack, type HistoryStackOptions, type HtmlElement, type ImageElement, ImageTool, type ImageToolOptions, InputHandler, 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, 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 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 };

package/dist/index.d.ts

@@ -85,6 +85,7 @@ interface HtmlElement extends BaseElement {
     type: 'html';
     size: Size;
     domId?: string;
+    interactive?: boolean;
 }
 interface TextElement extends BaseElement {
     type: 'text';
@@ -146,11 +147,12 @@ interface CanvasState {
     };
     elements: CanvasElement[];
     layers?: Layer[];
+    activeLayerId?: string;
 }
 declare function exportState(elements: CanvasElement[], camera: {
     position: Point;
     zoom: number;
-}, layers?: Layer[]): CanvasState;
+}, layers?: Layer[], activeLayerId?: string): CanvasState;
 declare function parseState(json: string): CanvasState;
 
 interface CameraOptions {
@@ -178,6 +180,7 @@ declare class Camera {
     screenToWorld(screen: Point): Point;
     worldToScreen(world: Point): Point;
     getVisibleRect(canvasWidth: number, canvasHeight: number): Bounds;
+    fitToContent(boundingBox: Bounds, canvasWidth: number, canvasHeight: number, padding?: number): void;
     toCSSTransform(): string;
     onChange(listener: (info: CameraChangeInfo) => void): () => void;
     private notifyPan;
@@ -200,7 +203,10 @@ declare class ElementStore {
     private bus;
     private layerOrderMap;
     private spatialIndex;
+    private sortedCache;
+    private _versions;
     get count(): number;
+    getVersion(id: string): number;
     setLayerOrder(order: Map<string, number>): void;
     getAll(): CanvasElement[];
     getById(id: string): CanvasElement | undefined;
@@ -213,6 +219,10 @@ declare class ElementStore {
     clear(): void;
     snapshot(): CanvasElement[];
     loadSnapshot(elements: CanvasElement[]): void;
+    bringToFront(id: string): void;
+    sendToBack(id: string): void;
+    bringForward(id: string): void;
+    sendBackward(id: string): void;
     queryRect(rect: Bounds): CanvasElement[];
     queryPoint(point: Point): CanvasElement[];
     on<K extends keyof ElementStoreEvents>(event: K, listener: (data: ElementStoreEvents[K]) => void): () => void;
@@ -238,6 +248,8 @@ interface PointerState {
     x: number;
     y: number;
     pressure: number;
+    pointerType: 'mouse' | 'touch' | 'pen';
+    shiftKey: boolean;
 }
 interface Tool {
     readonly name: string;
@@ -293,6 +305,7 @@ interface AutoSaveOptions {
     key?: string;
     debounceMs?: number;
     layerManager?: LayerManager;
+    onError?: (error: Error) => void;
 }
 declare class AutoSave {
     private readonly store;
@@ -302,6 +315,7 @@ declare class AutoSave {
     private readonly layerManager?;
     private timerId;
     private unsubscribers;
+    private readonly onError?;
     constructor(store: ElementStore, camera: Camera, options?: AutoSaveOptions);
     start(): void;
     stop(): void;
@@ -423,7 +437,12 @@ declare class InputHandler {
     private historyRecorder;
     private historyStack;
     private isToolActive;
+    private lastPointerEvent;
+    private readonly inputFilter;
+    private deferredDown;
     private readonly abortController;
+    private clipboard;
+    private pasteCount;
     constructor(element: HTMLElement, camera: Camera, options?: InputHandlerOptions);
     setToolManager(toolManager: ToolManager, toolContext: ToolContext): void;
     destroy(): void;
@@ -447,9 +466,49 @@ declare class InputHandler {
     private deleteSelected;
     private handleUndo;
     private handleRedo;
+    private handleCopy;
+    private handlePaste;
+    private handleZOrder;
     private cancelToolIfActive;
 }
 
+type FilterAction = 'dispatch' | 'suppress' | 'defer';
+interface FilteredEvent {
+    event: PointerEvent;
+    action: FilterAction;
+}
+interface FilteredUpEvent extends FilteredEvent {
+    pendingTap?: {
+        x: number;
+        y: number;
+    };
+}
+declare class InputFilter {
+    private activePenId;
+    private pendingTap;
+    static readonly MIN_MOVE_DISTANCE = 3;
+    filterDown(e: PointerEvent): FilteredEvent;
+    filterMove(e: PointerEvent): FilteredEvent;
+    filterUp(e: PointerEvent): FilteredUpEvent;
+    reset(): void;
+}
+
+interface DoubleTapDetectorOptions {
+    timeout?: number;
+    maxDistance?: number;
+}
+declare class DoubleTapDetector {
+    private readonly timeout;
+    private readonly maxDistance;
+    private lastTapTime;
+    private lastTapX;
+    private lastTapY;
+    private hasPendingTap;
+    constructor(options?: DoubleTapDetectorOptions);
+    feed(e: PointerEvent): boolean;
+    reset(): void;
+}
+
 interface FontSizePreset {
     label: string;
     size: number;
@@ -526,6 +585,9 @@ declare class Viewport {
     private readonly domNodeManager;
     private readonly interactMode;
     private readonly gridChangeListeners;
+    private readonly doubleTapDetector;
+    private tapDownX;
+    private tapDownY;
     constructor(container: HTMLElement, options?: ViewportOptions);
     get ctx(): CanvasRenderingContext2D | null;
     get snapToGrid(): boolean;
@@ -569,7 +631,8 @@ declare class Viewport {
     destroy(): void;
     private startEditingElement;
     private onTextEditStop;
-    private onDblClick;
+    private onTapDown;
+    private onDoubleTap;
     private hitTestWorld;
     stopInteracting(): void;
     private onDragOver;
@@ -706,6 +769,7 @@ interface HtmlInput extends BaseDefaults {
     position: Point;
     size: Size;
     domId?: string;
+    interactive?: boolean;
 }
 interface TextInput extends BaseDefaults {
     position: Point;
@@ -772,6 +836,8 @@ declare function unbindArrow(arrow: ArrowElement, store: ElementStore): Partial<
 declare function getElementBounds(element: CanvasElement): Bounds | null;
 declare function boundsIntersect(a: Bounds, b: Bounds): boolean;
 
+declare function getElementsBoundingBox(elements: CanvasElement[]): Bounds | null;
+
 declare function getHexDistance(a: Point, b: Point, cellSize: number, orientation: HexOrientation): number;
 declare function getHexCellsInRadius(center: Point, radiusCells: number, cellSize: number, orientation: HexOrientation): Point[];
 declare function getHexCellsInCone(center: Point, angle: number, radiusCells: number, cellSize: number, orientation: HexOrientation): Point[];
@@ -874,7 +940,11 @@ declare class SelectTool implements Tool {
     private lastWorld;
     private currentWorld;
     private ctx;
+    private pendingSingleSelectId;
+    private hasDragged;
+    private resizeAspectRatio;
     get selectedIds(): string[];
+    setSelection(ids: string[]): void;
     get isMarqueeActive(): boolean;
     onActivate(ctx: ToolContext): void;
     onDeactivate(ctx: ToolContext): void;
@@ -1119,6 +1189,6 @@ declare class UpdateLayerCommand implements Command {
     undo(_store: ElementStore): void;
 }
 
-declare const VERSION = "0.11.0";
+declare const VERSION = "0.15.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, ElementRenderer, ElementStore, type ElementType, type ElementUpdateEvent, EraserTool, type EraserToolOptions, EventBus, type ExportImageOptions, type FontSizePreset, type GridElement, type GridInfo, HandTool, type HexOrientation, HistoryRecorder, HistoryStack, type HistoryStackOptions, type HtmlElement, type ImageElement, ImageTool, type ImageToolOptions, InputHandler, 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, 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 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 };