@fieldnotes/core 0.34.0 → 0.36.0

package/dist/index.d.cts

@@ -22,6 +22,9 @@ interface BaseElement {
     layerId: string;
     /** Optional flat group membership. Elements sharing a groupId select/move/delete as a unit. */
     groupId?: string;
+    /** Rotation in radians (clockwise) about the element's center. Absent = 0 (unrotated).
+     * Applied to note/text/image/html/shape/stroke; ignored for arrow/grid/template. */
+    rotation?: number;
 }
 interface StrokeElement extends BaseElement {
     type: 'stroke';
@@ -171,6 +174,7 @@ declare class ElementStore {
     getElementsByType<T extends ElementType>(type: T): Extract<CanvasElement, {
         type: T;
     }>[];
+    private indexBounds;
     add(element: CanvasElement): void;
     update(id: string, partial: Partial<CanvasElement>): void;
     remove(id: string): void;
@@ -441,6 +445,8 @@ interface ViewportOptions {
     }) => void;
     /** CSS-pixel margin cached beyond the viewport. Default `256`. Set `0` to disable. */
     panBufferMargin?: number;
+    /** Enable the built-in context menu. Default `true`. */
+    contextMenu?: boolean;
 }
 declare class Viewport {
     private readonly container;
@@ -453,6 +459,7 @@ declare class Viewport {
     private readonly canvasEl;
     private readonly wrapper;
     private readonly unsubCamera;
+    private readonly unsubToolChange;
     private readonly unsubStore;
     private readonly inputHandler;
     private readonly background;
@@ -475,6 +482,7 @@ declare class Viewport {
     private readonly doubleTapDetector;
     private tapDownX;
     private tapDownY;
+    private contextMenu;
     constructor(container: HTMLElement, options?: ViewportOptions);
     get ctx(): CanvasRenderingContext2D | null;
     get snapToGrid(): boolean;
@@ -522,11 +530,15 @@ declare class Viewport {
     onGridChange(listener: (info: GridInfo | null) => void): () => void;
     private getSelectTool;
     getSelectedIds(): string[];
+    runAction(action: string): void;
+    canPaste(): boolean;
+    openContextMenu(screenPos: Point): void;
     onSelectionChange(listener: () => void): () => void;
     getSelectionStyle(): ElementStyle | null;
     applyStyleToSelection(style: ElementStyle): void;
     groupSelection(): void;
     ungroupSelection(): void;
+    toggleLockSelection(): void;
     alignSelection(edge: AlignEdge): void;
     distributeSelection(axis: DistributeAxis): void;
     private boundedSelection;
@@ -767,6 +779,7 @@ declare class SelectTool implements Tool {
     onSelectionChange(listener: () => void): () => void;
     private setSelectedIds;
     setSelection(ids: string[]): void;
+    selectAtPoint(world: Point, ctx: ToolContext): void;
     get isMarqueeActive(): boolean;
     onActivate(ctx: ToolContext): void;
     onDeactivate(ctx: ToolContext): void;
@@ -782,11 +795,17 @@ declare class SelectTool implements Tool {
     private updateHoverCursor;
     private setHovered;
     private handleResize;
+    private anchorOffset;
+    private handleRotatedResize;
     private hitTestResizeHandle;
+    private hitTestRotateHandle;
     private hitTestLineHandles;
     private getHandlePositions;
+    private getOverlayLayout;
+    private topMidpoint;
     private renderMarquee;
     private renderSelectionBoxes;
+    private drawLockBadge;
     private renderBindingHighlights;
     private hitTestTemplateResizeHandle;
     private handleTemplateResize;
@@ -992,6 +1011,6 @@ declare class TemplateTool implements Tool {
     private notifyOptionsChange;
 }
 
-declare const VERSION = "0.34.0";
+declare const VERSION = "0.36.0";
 
 export { type ActiveFormats, type AlignEdge, type ArrowElement, ArrowTool, type ArrowToolOptions, AutoSave, type AutoSaveOptions, type BackgroundOptions, type BackgroundPattern, type Binding, type Bounds, Camera, type CameraChangeInfo, type CameraOptions, type CanvasElement, type CanvasState, type Command, DEFAULT_NOTE_FONT_SIZE, type DistributeAxis, ElementStore, type ElementStyle, type ElementType, type ElementUpdateEvent, EraserTool, type EraserToolOptions, type ExportImageOptions, type FontSizePreset, type GridElement, type GridInfo, HandTool, type HexOrientation, HistoryStack, type HistoryStackOptions, type HtmlElement, type ImageElement, ImageTool, type ImageToolOptions, type Layer, LayerManager, MeasureTool, type MeasureToolOptions, type Measurement, type NoteElement, NoteTool, type NoteToolOptions, PencilTool, type PencilToolOptions, type Point, type PointerState, type RenderStatsSnapshot, SelectTool, type ShapeElement, type ShapeKind, ShapeTool, type ShapeToolOptions, type ShortcutBindings, type ShortcutOptions, type ShortcutsApi, type Size, type StrokeElement, type StrokePoint, type TemplateElement, type TemplateShape, TemplateTool, type TemplateToolOptions, type TextElement, TextTool, type TextToolOptions, type Tool, type ToolContext, ToolManager, type ToolName, VERSION, Viewport, type ViewportOptions, boundsIntersect, createArrow, createGrid, createHtmlElement, createImage, createNote, createShape, createStroke, createTemplate, createText, drawHexPath, exportImage, getActiveFormats, getArrowBounds, getArrowControlPoint, getArrowMidpoint, getArrowTangentAngle, getBendFromPoint, getElementBounds, getElementStyle, getElementsBoundingBox, getHexCellsInCone, getHexCellsInLine, getHexCellsInRadius, getHexCellsInSquare, getHexDistance, isNearBezier, setFontSize, smartSnap, snapPoint, snapToHexCenter, styleToPatch, toggleBold, toggleItalic, toggleStrikethrough, toggleUnderline };

package/dist/index.d.ts

@@ -22,6 +22,9 @@ interface BaseElement {
     layerId: string;
     /** Optional flat group membership. Elements sharing a groupId select/move/delete as a unit. */
     groupId?: string;
+    /** Rotation in radians (clockwise) about the element's center. Absent = 0 (unrotated).
+     * Applied to note/text/image/html/shape/stroke; ignored for arrow/grid/template. */
+    rotation?: number;
 }
 interface StrokeElement extends BaseElement {
     type: 'stroke';
@@ -171,6 +174,7 @@ declare class ElementStore {
     getElementsByType<T extends ElementType>(type: T): Extract<CanvasElement, {
         type: T;
     }>[];
+    private indexBounds;
     add(element: CanvasElement): void;
     update(id: string, partial: Partial<CanvasElement>): void;
     remove(id: string): void;
@@ -441,6 +445,8 @@ interface ViewportOptions {
     }) => void;
     /** CSS-pixel margin cached beyond the viewport. Default `256`. Set `0` to disable. */
     panBufferMargin?: number;
+    /** Enable the built-in context menu. Default `true`. */
+    contextMenu?: boolean;
 }
 declare class Viewport {
     private readonly container;
@@ -453,6 +459,7 @@ declare class Viewport {
     private readonly canvasEl;
     private readonly wrapper;
     private readonly unsubCamera;
+    private readonly unsubToolChange;
     private readonly unsubStore;
     private readonly inputHandler;
     private readonly background;
@@ -475,6 +482,7 @@ declare class Viewport {
     private readonly doubleTapDetector;
     private tapDownX;
     private tapDownY;
+    private contextMenu;
     constructor(container: HTMLElement, options?: ViewportOptions);
     get ctx(): CanvasRenderingContext2D | null;
     get snapToGrid(): boolean;
@@ -522,11 +530,15 @@ declare class Viewport {
     onGridChange(listener: (info: GridInfo | null) => void): () => void;
     private getSelectTool;
     getSelectedIds(): string[];
+    runAction(action: string): void;
+    canPaste(): boolean;
+    openContextMenu(screenPos: Point): void;
     onSelectionChange(listener: () => void): () => void;
     getSelectionStyle(): ElementStyle | null;
     applyStyleToSelection(style: ElementStyle): void;
     groupSelection(): void;
     ungroupSelection(): void;
+    toggleLockSelection(): void;
     alignSelection(edge: AlignEdge): void;
     distributeSelection(axis: DistributeAxis): void;
     private boundedSelection;
@@ -767,6 +779,7 @@ declare class SelectTool implements Tool {
     onSelectionChange(listener: () => void): () => void;
     private setSelectedIds;
     setSelection(ids: string[]): void;
+    selectAtPoint(world: Point, ctx: ToolContext): void;
     get isMarqueeActive(): boolean;
     onActivate(ctx: ToolContext): void;
     onDeactivate(ctx: ToolContext): void;
@@ -782,11 +795,17 @@ declare class SelectTool implements Tool {
     private updateHoverCursor;
     private setHovered;
     private handleResize;
+    private anchorOffset;
+    private handleRotatedResize;
     private hitTestResizeHandle;
+    private hitTestRotateHandle;
     private hitTestLineHandles;
     private getHandlePositions;
+    private getOverlayLayout;
+    private topMidpoint;
     private renderMarquee;
     private renderSelectionBoxes;
+    private drawLockBadge;
     private renderBindingHighlights;
     private hitTestTemplateResizeHandle;
     private handleTemplateResize;
@@ -992,6 +1011,6 @@ declare class TemplateTool implements Tool {
     private notifyOptionsChange;
 }
 
-declare const VERSION = "0.34.0";
+declare const VERSION = "0.36.0";
 
 export { type ActiveFormats, type AlignEdge, type ArrowElement, ArrowTool, type ArrowToolOptions, AutoSave, type AutoSaveOptions, type BackgroundOptions, type BackgroundPattern, type Binding, type Bounds, Camera, type CameraChangeInfo, type CameraOptions, type CanvasElement, type CanvasState, type Command, DEFAULT_NOTE_FONT_SIZE, type DistributeAxis, ElementStore, type ElementStyle, type ElementType, type ElementUpdateEvent, EraserTool, type EraserToolOptions, type ExportImageOptions, type FontSizePreset, type GridElement, type GridInfo, HandTool, type HexOrientation, HistoryStack, type HistoryStackOptions, type HtmlElement, type ImageElement, ImageTool, type ImageToolOptions, type Layer, LayerManager, MeasureTool, type MeasureToolOptions, type Measurement, type NoteElement, NoteTool, type NoteToolOptions, PencilTool, type PencilToolOptions, type Point, type PointerState, type RenderStatsSnapshot, SelectTool, type ShapeElement, type ShapeKind, ShapeTool, type ShapeToolOptions, type ShortcutBindings, type ShortcutOptions, type ShortcutsApi, type Size, type StrokeElement, type StrokePoint, type TemplateElement, type TemplateShape, TemplateTool, type TemplateToolOptions, type TextElement, TextTool, type TextToolOptions, type Tool, type ToolContext, ToolManager, type ToolName, VERSION, Viewport, type ViewportOptions, boundsIntersect, createArrow, createGrid, createHtmlElement, createImage, createNote, createShape, createStroke, createTemplate, createText, drawHexPath, exportImage, getActiveFormats, getArrowBounds, getArrowControlPoint, getArrowMidpoint, getArrowTangentAngle, getBendFromPoint, getElementBounds, getElementStyle, getElementsBoundingBox, getHexCellsInCone, getHexCellsInLine, getHexCellsInRadius, getHexCellsInSquare, getHexDistance, isNearBezier, setFontSize, smartSnap, snapPoint, snapToHexCenter, styleToPatch, toggleBold, toggleItalic, toggleStrikethrough, toggleUnderline };