@fieldnotes/core 0.9.0 → 0.11.0

package/dist/index.d.cts

@@ -59,6 +59,7 @@ interface NoteElement extends BaseElement {
     text: string;
     backgroundColor: string;
     textColor: string;
+    fontSize?: number;
 }
 interface Binding {
     elementId: string;
@@ -449,6 +450,28 @@ declare class InputHandler {
     private cancelToolIfActive;
 }
 
+interface FontSizePreset {
+    label: string;
+    size: number;
+}
+declare const DEFAULT_FONT_SIZE_PRESETS: FontSizePreset[];
+declare class NoteToolbar {
+    private el;
+    private anchor;
+    private selectionListener;
+    private readonly fontSizePresets;
+    constructor(fontSizePresets?: FontSizePreset[]);
+    show(anchor: HTMLElement): void;
+    hide(): void;
+    getElement(): HTMLDivElement | null;
+    updatePosition(anchor: HTMLElement): void;
+    private createToolbarElement;
+    private createFormatButton;
+    private createFontSizeSelect;
+    private positionToolbar;
+    private updateActiveStates;
+}
+
 interface ExportImageOptions {
     scale?: number;
     padding?: number;
@@ -466,9 +489,17 @@ interface RenderStatsSnapshot {
     frameCount: number;
 }
 
+interface GridInfo {
+    gridType: 'square' | 'hex';
+    hexOrientation: 'pointy' | 'flat';
+    cellSize: number;
+    cellRadius: number;
+}
 interface ViewportOptions {
     camera?: CameraOptions;
     background?: BackgroundOptions;
+    fontSizePresets?: FontSizePreset[];
+    toolbar?: boolean;
 }
 declare class Viewport {
     private readonly container;
@@ -494,6 +525,7 @@ declare class Viewport {
     private readonly renderLoop;
     private readonly domNodeManager;
     private readonly interactMode;
+    private readonly gridChangeListeners;
     constructor(container: HTMLElement, options?: ViewportOptions);
     get ctx(): CanvasRenderingContext2D | null;
     get snapToGrid(): boolean;
@@ -530,6 +562,8 @@ declare class Viewport {
     }): string;
     updateGrid(updates: Partial<Pick<GridElement, 'gridType' | 'hexOrientation' | 'cellSize' | 'strokeColor' | 'strokeWidth' | 'opacity'>>): void;
     removeGrid(): void;
+    getGridInfo(): GridInfo | null;
+    onGridChange(listener: (info: GridInfo | null) => void): () => void;
     getRenderStats(): RenderStatsSnapshot;
     logPerformance(intervalMs?: number): () => void;
     destroy(): void;
@@ -547,6 +581,7 @@ declare class Viewport {
     private applyCameraTransform;
     private syncCanvasSize;
     private syncGridContext;
+    private notifyGridChangeListeners;
     private observeResize;
 }
 
@@ -581,6 +616,10 @@ declare class ElementRenderer {
     private getImage;
 }
 
+interface NoteEditorOptions {
+    fontSizePresets?: FontSizePreset[];
+    toolbar?: boolean;
+}
 declare class NoteEditor {
     private editingId;
     private editingNode;
@@ -589,17 +628,46 @@ declare class NoteEditor {
     private pointerHandler;
     private pendingEditId;
     private onStopCallback;
+    private toolbar;
+    constructor(options?: NoteEditorOptions);
     get isEditing(): boolean;
     get editingElementId(): string | null;
     setOnStop(callback: (elementId: string) => void): void;
     startEditing(node: HTMLDivElement, elementId: string, store: ElementStore): void;
     stopEditing(store: ElementStore): void;
     destroy(store: ElementStore): void;
+    updateToolbarPosition(): void;
     private activateEditing;
 }
 
+interface RunStyle {
+    bold: boolean;
+    italic: boolean;
+    underline: boolean;
+    strikethrough: boolean;
+    fontSize: number;
+}
+interface StyledRun extends RunStyle {
+    text: string;
+}
+declare function sanitizeNoteHtml(html: string): string;
+
+interface ActiveFormats {
+    bold: boolean;
+    italic: boolean;
+    underline: boolean;
+    strikethrough: boolean;
+}
+declare function toggleBold(): void;
+declare function toggleItalic(): void;
+declare function toggleUnderline(): void;
+declare function toggleStrikethrough(): void;
+declare function setFontSize(size: number): void;
+declare function getActiveFormats(): ActiveFormats;
+
 declare function createId(prefix: string): string;
 
+declare const DEFAULT_NOTE_FONT_SIZE = 18;
 interface BaseDefaults {
     position?: Point;
     zIndex?: number;
@@ -618,6 +686,7 @@ interface NoteInput extends BaseDefaults {
     text?: string;
     backgroundColor?: string;
     textColor?: string;
+    fontSize?: number;
 }
 interface ArrowInput extends BaseDefaults {
     from: Point;
@@ -862,12 +931,14 @@ interface NoteToolOptions {
     backgroundColor?: string;
     textColor?: string;
     size?: Size;
+    fontSize?: number;
 }
 declare class NoteTool implements Tool {
     readonly name = "note";
     private backgroundColor;
     private textColor;
     private size;
+    private fontSize;
     private optionListeners;
     constructor(options?: NoteToolOptions);
     getOptions(): NoteToolOptions;
@@ -1048,6 +1119,6 @@ declare class UpdateLayerCommand implements Command {
     undo(_store: ElementStore): void;
 }
 
-declare const VERSION = "0.9.0";
+declare const VERSION = "0.11.0";
 
-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, MeasureTool, type MeasureToolOptions, type Measurement, 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 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, getArrowBounds, getArrowControlPoint, getArrowMidpoint, getArrowTangentAngle, getBendFromPoint, getEdgeIntersection, getElementBounds, getElementCenter, getHexCellsInCone, getHexCellsInLine, getHexCellsInRadius, getHexCellsInSquare, getHexDistance, isBindable, isNearBezier, parseState, smartSnap, snapPoint, snapToHexCenter, 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, 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 };

package/dist/index.d.ts

@@ -59,6 +59,7 @@ interface NoteElement extends BaseElement {
     text: string;
     backgroundColor: string;
     textColor: string;
+    fontSize?: number;
 }
 interface Binding {
     elementId: string;
@@ -449,6 +450,28 @@ declare class InputHandler {
     private cancelToolIfActive;
 }
 
+interface FontSizePreset {
+    label: string;
+    size: number;
+}
+declare const DEFAULT_FONT_SIZE_PRESETS: FontSizePreset[];
+declare class NoteToolbar {
+    private el;
+    private anchor;
+    private selectionListener;
+    private readonly fontSizePresets;
+    constructor(fontSizePresets?: FontSizePreset[]);
+    show(anchor: HTMLElement): void;
+    hide(): void;
+    getElement(): HTMLDivElement | null;
+    updatePosition(anchor: HTMLElement): void;
+    private createToolbarElement;
+    private createFormatButton;
+    private createFontSizeSelect;
+    private positionToolbar;
+    private updateActiveStates;
+}
+
 interface ExportImageOptions {
     scale?: number;
     padding?: number;
@@ -466,9 +489,17 @@ interface RenderStatsSnapshot {
     frameCount: number;
 }
 
+interface GridInfo {
+    gridType: 'square' | 'hex';
+    hexOrientation: 'pointy' | 'flat';
+    cellSize: number;
+    cellRadius: number;
+}
 interface ViewportOptions {
     camera?: CameraOptions;
     background?: BackgroundOptions;
+    fontSizePresets?: FontSizePreset[];
+    toolbar?: boolean;
 }
 declare class Viewport {
     private readonly container;
@@ -494,6 +525,7 @@ declare class Viewport {
     private readonly renderLoop;
     private readonly domNodeManager;
     private readonly interactMode;
+    private readonly gridChangeListeners;
     constructor(container: HTMLElement, options?: ViewportOptions);
     get ctx(): CanvasRenderingContext2D | null;
     get snapToGrid(): boolean;
@@ -530,6 +562,8 @@ declare class Viewport {
     }): string;
     updateGrid(updates: Partial<Pick<GridElement, 'gridType' | 'hexOrientation' | 'cellSize' | 'strokeColor' | 'strokeWidth' | 'opacity'>>): void;
     removeGrid(): void;
+    getGridInfo(): GridInfo | null;
+    onGridChange(listener: (info: GridInfo | null) => void): () => void;
     getRenderStats(): RenderStatsSnapshot;
     logPerformance(intervalMs?: number): () => void;
     destroy(): void;
@@ -547,6 +581,7 @@ declare class Viewport {
     private applyCameraTransform;
     private syncCanvasSize;
     private syncGridContext;
+    private notifyGridChangeListeners;
     private observeResize;
 }
 
@@ -581,6 +616,10 @@ declare class ElementRenderer {
     private getImage;
 }
 
+interface NoteEditorOptions {
+    fontSizePresets?: FontSizePreset[];
+    toolbar?: boolean;
+}
 declare class NoteEditor {
     private editingId;
     private editingNode;
@@ -589,17 +628,46 @@ declare class NoteEditor {
     private pointerHandler;
     private pendingEditId;
     private onStopCallback;
+    private toolbar;
+    constructor(options?: NoteEditorOptions);
     get isEditing(): boolean;
     get editingElementId(): string | null;
     setOnStop(callback: (elementId: string) => void): void;
     startEditing(node: HTMLDivElement, elementId: string, store: ElementStore): void;
     stopEditing(store: ElementStore): void;
     destroy(store: ElementStore): void;
+    updateToolbarPosition(): void;
     private activateEditing;
 }
 
+interface RunStyle {
+    bold: boolean;
+    italic: boolean;
+    underline: boolean;
+    strikethrough: boolean;
+    fontSize: number;
+}
+interface StyledRun extends RunStyle {
+    text: string;
+}
+declare function sanitizeNoteHtml(html: string): string;
+
+interface ActiveFormats {
+    bold: boolean;
+    italic: boolean;
+    underline: boolean;
+    strikethrough: boolean;
+}
+declare function toggleBold(): void;
+declare function toggleItalic(): void;
+declare function toggleUnderline(): void;
+declare function toggleStrikethrough(): void;
+declare function setFontSize(size: number): void;
+declare function getActiveFormats(): ActiveFormats;
+
 declare function createId(prefix: string): string;
 
+declare const DEFAULT_NOTE_FONT_SIZE = 18;
 interface BaseDefaults {
     position?: Point;
     zIndex?: number;
@@ -618,6 +686,7 @@ interface NoteInput extends BaseDefaults {
     text?: string;
     backgroundColor?: string;
     textColor?: string;
+    fontSize?: number;
 }
 interface ArrowInput extends BaseDefaults {
     from: Point;
@@ -862,12 +931,14 @@ interface NoteToolOptions {
     backgroundColor?: string;
     textColor?: string;
     size?: Size;
+    fontSize?: number;
 }
 declare class NoteTool implements Tool {
     readonly name = "note";
     private backgroundColor;
     private textColor;
     private size;
+    private fontSize;
     private optionListeners;
     constructor(options?: NoteToolOptions);
     getOptions(): NoteToolOptions;
@@ -1048,6 +1119,6 @@ declare class UpdateLayerCommand implements Command {
     undo(_store: ElementStore): void;
 }
 
-declare const VERSION = "0.9.0";
+declare const VERSION = "0.11.0";
 
-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, MeasureTool, type MeasureToolOptions, type Measurement, 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 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, getArrowBounds, getArrowControlPoint, getArrowMidpoint, getArrowTangentAngle, getBendFromPoint, getEdgeIntersection, getElementBounds, getElementCenter, getHexCellsInCone, getHexCellsInLine, getHexCellsInRadius, getHexCellsInSquare, getHexDistance, isBindable, isNearBezier, parseState, smartSnap, snapPoint, snapToHexCenter, 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, 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 };