@fieldnotes/core 0.15.0 → 0.17.0

package/dist/index.d.cts

@@ -270,6 +270,15 @@ declare function snapPoint(point: Point, gridSize: number): Point;
 declare function snapToHexCenter(point: Point, cellSize: number, orientation: HexOrientation): Point;
 declare function smartSnap(point: Point, ctx: ToolContext): Point;
 
+interface LayerManagerEvents {
+    change: null;
+    create: Layer;
+    remove: Layer;
+    update: {
+        previous: Layer;
+        current: Layer;
+    };
+}
 declare class LayerManager {
     private readonly store;
     private layers;
@@ -293,7 +302,7 @@ declare class LayerManager {
     moveElementToLayer(elementId: string, layerId: string): void;
     snapshot(): Layer[];
     loadSnapshot(layers: Layer[]): void;
-    on(event: 'change', callback: () => void): () => void;
+    on<K extends keyof LayerManagerEvents>(event: K, callback: (data: LayerManagerEvents[K]) => void): () => void;
     addLayerDirect(layer: Layer): void;
     removeLayerDirect(id: string): void;
     updateLayerDirect(id: string, props: Omit<Partial<Layer>, 'id'>): void;
@@ -399,11 +408,12 @@ declare class HistoryStack {
 declare class HistoryRecorder {
     private readonly store;
     private readonly stack;
+    private readonly layerManager?;
     private recording;
     private transaction;
     private updateSnapshots;
     private unsubscribers;
-    constructor(store: ElementStore, stack: HistoryStack);
+    constructor(store: ElementStore, stack: HistoryStack, layerManager?: LayerManager | undefined);
     pause(): void;
     resume(): void;
     begin(): void;
@@ -414,6 +424,9 @@ declare class HistoryRecorder {
     private onAdd;
     private onRemove;
     private onUpdate;
+    private onLayerCreate;
+    private onLayerRemove;
+    private onLayerUpdate;
     private flushUpdateSnapshots;
 }
 
@@ -422,6 +435,7 @@ interface InputHandlerOptions {
     toolContext?: ToolContext;
     historyRecorder?: HistoryRecorder;
     historyStack?: HistoryStack;
+    fitToContent?: () => void;
 }
 declare class InputHandler {
     private readonly element;
@@ -441,10 +455,10 @@ declare class InputHandler {
     private readonly inputFilter;
     private deferredDown;
     private readonly abortController;
-    private clipboard;
-    private pasteCount;
+    private readonly actions;
     constructor(element: HTMLElement, camera: Camera, options?: InputHandlerOptions);
     setToolManager(toolManager: ToolManager, toolContext: ToolContext): void;
+    flushPendingHistory(): void;
     destroy(): void;
     private bind;
     private onWheel;
@@ -463,12 +477,6 @@ declare class InputHandler {
     private dispatchToolMove;
     private dispatchToolHover;
     private dispatchToolUp;
-    private deleteSelected;
-    private handleUndo;
-    private handleRedo;
-    private handleCopy;
-    private handlePaste;
-    private handleZOrder;
     private cancelToolIfActive;
 }
 
@@ -559,6 +567,11 @@ interface ViewportOptions {
     background?: BackgroundOptions;
     fontSizePresets?: FontSizePreset[];
     toolbar?: boolean;
+    onHtmlElementMount?: (elementId: string, domId: string | undefined, container: HTMLDivElement) => void;
+    onDrop?: (event: DragEvent, worldPosition: {
+        x: number;
+        y: number;
+    }) => void;
 }
 declare class Viewport {
     private readonly container;
@@ -584,6 +597,8 @@ declare class Viewport {
     private readonly renderLoop;
     private readonly domNodeManager;
     private readonly interactMode;
+    private readonly onHtmlElementMount?;
+    private readonly dropHandler?;
     private readonly gridChangeListeners;
     private readonly doubleTapDetector;
     private tapDownX;
@@ -592,6 +607,7 @@ declare class Viewport {
     get ctx(): CanvasRenderingContext2D | null;
     get snapToGrid(): boolean;
     setSnapToGrid(enabled: boolean): void;
+    fitToContent(padding?: number): void;
     requestRender(): void;
     exportState(): CanvasState;
     exportJSON(): string;
@@ -614,6 +630,8 @@ declare class Viewport {
         w: number;
         h: number;
     }): string;
+    removeLayer(id: string): void;
+    updateHtmlElement(id: string, newContent: HTMLElement): void;
     addGrid(input: {
         gridType?: 'square' | 'hex';
         hexOrientation?: 'pointy' | 'flat';
@@ -954,6 +972,8 @@ declare class SelectTool implements Tool {
     onPointerUp(_state: PointerState, ctx: ToolContext): void;
     onHover(state: PointerState, ctx: ToolContext): void;
     renderOverlay(canvasCtx: CanvasRenderingContext2D): void;
+    private updateArrowsBoundTo;
+    nudgeSelection(dx: number, dy: number, ctx: ToolContext): boolean;
     private updateHoverCursor;
     private handleResize;
     private hitTestResizeHandle;
@@ -1189,6 +1209,6 @@ declare class UpdateLayerCommand implements Command {
     undo(_store: ElementStore): void;
 }
 
-declare const VERSION = "0.15.0";
+declare const VERSION = "0.17.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 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

@@ -270,6 +270,15 @@ declare function snapPoint(point: Point, gridSize: number): Point;
 declare function snapToHexCenter(point: Point, cellSize: number, orientation: HexOrientation): Point;
 declare function smartSnap(point: Point, ctx: ToolContext): Point;
 
+interface LayerManagerEvents {
+    change: null;
+    create: Layer;
+    remove: Layer;
+    update: {
+        previous: Layer;
+        current: Layer;
+    };
+}
 declare class LayerManager {
     private readonly store;
     private layers;
@@ -293,7 +302,7 @@ declare class LayerManager {
     moveElementToLayer(elementId: string, layerId: string): void;
     snapshot(): Layer[];
     loadSnapshot(layers: Layer[]): void;
-    on(event: 'change', callback: () => void): () => void;
+    on<K extends keyof LayerManagerEvents>(event: K, callback: (data: LayerManagerEvents[K]) => void): () => void;
     addLayerDirect(layer: Layer): void;
     removeLayerDirect(id: string): void;
     updateLayerDirect(id: string, props: Omit<Partial<Layer>, 'id'>): void;
@@ -399,11 +408,12 @@ declare class HistoryStack {
 declare class HistoryRecorder {
     private readonly store;
     private readonly stack;
+    private readonly layerManager?;
     private recording;
     private transaction;
     private updateSnapshots;
     private unsubscribers;
-    constructor(store: ElementStore, stack: HistoryStack);
+    constructor(store: ElementStore, stack: HistoryStack, layerManager?: LayerManager | undefined);
     pause(): void;
     resume(): void;
     begin(): void;
@@ -414,6 +424,9 @@ declare class HistoryRecorder {
     private onAdd;
     private onRemove;
     private onUpdate;
+    private onLayerCreate;
+    private onLayerRemove;
+    private onLayerUpdate;
     private flushUpdateSnapshots;
 }
 
@@ -422,6 +435,7 @@ interface InputHandlerOptions {
     toolContext?: ToolContext;
     historyRecorder?: HistoryRecorder;
     historyStack?: HistoryStack;
+    fitToContent?: () => void;
 }
 declare class InputHandler {
     private readonly element;
@@ -441,10 +455,10 @@ declare class InputHandler {
     private readonly inputFilter;
     private deferredDown;
     private readonly abortController;
-    private clipboard;
-    private pasteCount;
+    private readonly actions;
     constructor(element: HTMLElement, camera: Camera, options?: InputHandlerOptions);
     setToolManager(toolManager: ToolManager, toolContext: ToolContext): void;
+    flushPendingHistory(): void;
     destroy(): void;
     private bind;
     private onWheel;
@@ -463,12 +477,6 @@ declare class InputHandler {
     private dispatchToolMove;
     private dispatchToolHover;
     private dispatchToolUp;
-    private deleteSelected;
-    private handleUndo;
-    private handleRedo;
-    private handleCopy;
-    private handlePaste;
-    private handleZOrder;
     private cancelToolIfActive;
 }
 
@@ -559,6 +567,11 @@ interface ViewportOptions {
     background?: BackgroundOptions;
     fontSizePresets?: FontSizePreset[];
     toolbar?: boolean;
+    onHtmlElementMount?: (elementId: string, domId: string | undefined, container: HTMLDivElement) => void;
+    onDrop?: (event: DragEvent, worldPosition: {
+        x: number;
+        y: number;
+    }) => void;
 }
 declare class Viewport {
     private readonly container;
@@ -584,6 +597,8 @@ declare class Viewport {
     private readonly renderLoop;
     private readonly domNodeManager;
     private readonly interactMode;
+    private readonly onHtmlElementMount?;
+    private readonly dropHandler?;
     private readonly gridChangeListeners;
     private readonly doubleTapDetector;
     private tapDownX;
@@ -592,6 +607,7 @@ declare class Viewport {
     get ctx(): CanvasRenderingContext2D | null;
     get snapToGrid(): boolean;
     setSnapToGrid(enabled: boolean): void;
+    fitToContent(padding?: number): void;
     requestRender(): void;
     exportState(): CanvasState;
     exportJSON(): string;
@@ -614,6 +630,8 @@ declare class Viewport {
         w: number;
         h: number;
     }): string;
+    removeLayer(id: string): void;
+    updateHtmlElement(id: string, newContent: HTMLElement): void;
     addGrid(input: {
         gridType?: 'square' | 'hex';
         hexOrientation?: 'pointy' | 'flat';
@@ -954,6 +972,8 @@ declare class SelectTool implements Tool {
     onPointerUp(_state: PointerState, ctx: ToolContext): void;
     onHover(state: PointerState, ctx: ToolContext): void;
     renderOverlay(canvasCtx: CanvasRenderingContext2D): void;
+    private updateArrowsBoundTo;
+    nudgeSelection(dx: number, dy: number, ctx: ToolContext): boolean;
     private updateHoverCursor;
     private handleResize;
     private hitTestResizeHandle;
@@ -1189,6 +1209,6 @@ declare class UpdateLayerCommand implements Command {
     undo(_store: ElementStore): void;
 }
 
-declare const VERSION = "0.15.0";
+declare const VERSION = "0.17.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 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 };