@fieldnotes/core 0.52.2 → 0.53.0

package/dist/index.d.cts

@@ -583,6 +583,7 @@ declare class Viewport {
     private readonly noteEditor;
     private readonly arrowLabelEditor;
     private readonly historyRecorder;
+    private transactionDepth;
     private readonly selectionOps;
     readonly toolContext: ToolContext;
     private readonly marginViewport;
@@ -616,6 +617,14 @@ declare class Viewport {
     loadJSON(json: string): void;
     setTool(name: string): void;
     get shortcuts(): ShortcutsApi;
+    /**
+     * Groups synchronous local store and layer mutations into one undo step.
+     * Nested calls join the outer transaction. If the callback throws, mutations
+     * already applied remain undoable and the original error is rethrown.
+     */
+    transaction<T>(operation: () => T): T;
+    /** Removes existing elements as one undoable operation and returns the number removed. */
+    removeElements(ids: Iterable<string>): number;
     undo(): boolean;
     redo(): boolean;
     addImage(src: string, position: {
@@ -1158,6 +1167,6 @@ declare class LaserTool implements Tool {
     private notifyOptionsChange;
 }
 
-declare const VERSION = "0.52.2";
+declare const VERSION = "0.53.0";
 
 export { type ActiveFormats, type AlignEdge, type ArrowElement, type ArrowStrokeStyle, 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, type ElementChangeMeta, ElementStore, type ElementStyle, type ElementType, type ElementUpdateEvent, EraserTool, type EraserToolOptions, type ExportAssetError, type ExportAssetErrorReason, type ExportImageOptions, type ExportResourceOptions, type ExportSvgOptions, type FontSizePreset, type GridElement, type GridInfo, HandTool, type HexOrientation, HistoryStack, type HistoryStackOptions, type HtmlElement, type HtmlExportError, type HtmlExportErrorReason, type HtmlExportOptions, type HtmlExportRenderer, type ImageElement, ImageTool, type ImageToolOptions, IndexedDBAdapter, type IndexedDBAdapterOptions, LaserTool, type LaserToolOptions, type Layer, LayerManager, LocalStorageAdapter, MeasureTool, type MeasureToolOptions, type Measurement, MemoryAdapter, type NoteElement, NoteTool, type NoteToolOptions, PencilTool, type PencilToolOptions, type Point, type PointerState, type RenderStatsSnapshot, type RotateDirection, SelectTool, type ShapeElement, type ShapeKind, ShapeTool, type ShapeToolOptions, type ShortcutBindings, type ShortcutOptions, type ShortcutsApi, type Size, type StorageAdapter, type StrokeElement, type StrokePoint, type TemplateElement, type TemplateRenderStyle, 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, exportSvg, getActiveFormats, getArrowBounds, getArrowControlPoint, getArrowMidpoint, getArrowTangentAngle, getBendFromPoint, getElementBounds, getElementStyle, getElementsBoundingBox, getHexCellsInCone, getHexCellsInLine, getHexCellsInRadius, getHexCellsInRectangle, getHexCellsInSquare, getHexDistance, isNearBezier, setFontSize, smartSnap, snapPoint, snapToHexCenter, styleToPatch, toggleBold, toggleItalic, toggleStrikethrough, toggleUnderline };

package/dist/index.d.ts

@@ -583,6 +583,7 @@ declare class Viewport {
     private readonly noteEditor;
     private readonly arrowLabelEditor;
     private readonly historyRecorder;
+    private transactionDepth;
     private readonly selectionOps;
     readonly toolContext: ToolContext;
     private readonly marginViewport;
@@ -616,6 +617,14 @@ declare class Viewport {
     loadJSON(json: string): void;
     setTool(name: string): void;
     get shortcuts(): ShortcutsApi;
+    /**
+     * Groups synchronous local store and layer mutations into one undo step.
+     * Nested calls join the outer transaction. If the callback throws, mutations
+     * already applied remain undoable and the original error is rethrown.
+     */
+    transaction<T>(operation: () => T): T;
+    /** Removes existing elements as one undoable operation and returns the number removed. */
+    removeElements(ids: Iterable<string>): number;
     undo(): boolean;
     redo(): boolean;
     addImage(src: string, position: {
@@ -1158,6 +1167,6 @@ declare class LaserTool implements Tool {
     private notifyOptionsChange;
 }
 
-declare const VERSION = "0.52.2";
+declare const VERSION = "0.53.0";
 
 export { type ActiveFormats, type AlignEdge, type ArrowElement, type ArrowStrokeStyle, 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, type ElementChangeMeta, ElementStore, type ElementStyle, type ElementType, type ElementUpdateEvent, EraserTool, type EraserToolOptions, type ExportAssetError, type ExportAssetErrorReason, type ExportImageOptions, type ExportResourceOptions, type ExportSvgOptions, type FontSizePreset, type GridElement, type GridInfo, HandTool, type HexOrientation, HistoryStack, type HistoryStackOptions, type HtmlElement, type HtmlExportError, type HtmlExportErrorReason, type HtmlExportOptions, type HtmlExportRenderer, type ImageElement, ImageTool, type ImageToolOptions, IndexedDBAdapter, type IndexedDBAdapterOptions, LaserTool, type LaserToolOptions, type Layer, LayerManager, LocalStorageAdapter, MeasureTool, type MeasureToolOptions, type Measurement, MemoryAdapter, type NoteElement, NoteTool, type NoteToolOptions, PencilTool, type PencilToolOptions, type Point, type PointerState, type RenderStatsSnapshot, type RotateDirection, SelectTool, type ShapeElement, type ShapeKind, ShapeTool, type ShapeToolOptions, type ShortcutBindings, type ShortcutOptions, type ShortcutsApi, type Size, type StorageAdapter, type StrokeElement, type StrokePoint, type TemplateElement, type TemplateRenderStyle, 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, exportSvg, getActiveFormats, getArrowBounds, getArrowControlPoint, getArrowMidpoint, getArrowTangentAngle, getBendFromPoint, getElementBounds, getElementStyle, getElementsBoundingBox, getHexCellsInCone, getHexCellsInLine, getHexCellsInRadius, getHexCellsInRectangle, getHexCellsInSquare, getHexDistance, isNearBezier, setFontSize, smartSnap, snapPoint, snapToHexCenter, styleToPatch, toggleBold, toggleItalic, toggleStrikethrough, toggleUnderline };

package/dist/index.js

@@ -8097,6 +8097,7 @@ var Viewport = class {
   noteEditor;
   arrowLabelEditor;
   historyRecorder;
+  transactionDepth = 0;
   selectionOps;
   toolContext;
   marginViewport;
@@ -8210,6 +8211,35 @@ var Viewport = class {
   get shortcuts() {
     return this.inputHandler.shortcuts;
   }
+  /**
+   * Groups synchronous local store and layer mutations into one undo step.
+   * Nested calls join the outer transaction. If the callback throws, mutations
+   * already applied remain undoable and the original error is rethrown.
+   */
+  transaction(operation) {
+    const isOuterTransaction = this.transactionDepth === 0;
+    if (isOuterTransaction) {
+      this.inputHandler.flushPendingHistory();
+      this.historyRecorder.begin();
+    }
+    this.transactionDepth += 1;
+    try {
+      return operation();
+    } finally {
+      this.transactionDepth -= 1;
+      if (isOuterTransaction) this.historyRecorder.commit();
+    }
+  }
+  /** Removes existing elements as one undoable operation and returns the number removed. */
+  removeElements(ids) {
+    const existingIds = [...new Set(ids)].filter((id) => this.store.getById(id) !== void 0);
+    if (existingIds.length === 0) return 0;
+    this.transaction(() => {
+      for (const id of existingIds) this.store.remove(id);
+    });
+    this.requestRender();
+    return existingIds.length;
+  }
   undo() {
     this.inputHandler.flushPendingHistory();
     this.historyRecorder.pause();
@@ -11125,7 +11155,7 @@ var LaserTool = class {
 };
 
 // src/index.ts
-var VERSION = "0.52.2";
+var VERSION = "0.53.0";
 export {
   ArrowTool,
   AutoSave,