@fieldnotes/core 0.45.0 → 0.46.0

package/dist/index.d.cts

@@ -162,6 +162,14 @@ interface ElementUpdateEvent {
     previous: CanvasElement;
     current: CanvasElement;
 }
+interface ElementChangeMeta {
+    /**
+     * Identifies what caused the change. `undefined` or `'local'` = a local change (recorded to undo
+     * history and observed as local). Any other value (e.g. `'remote'`) marks an externally-applied
+     * change: it is NOT recorded to undo history, and is tagged so observers can avoid re-broadcasting it.
+     */
+    origin?: string;
+}
 interface ElementStoreEvents {
     add: CanvasElement;
     remove: CanvasElement;
@@ -184,19 +192,19 @@ declare class ElementStore {
         type: T;
     }>[];
     private indexBounds;
-    add(element: CanvasElement): void;
-    update(id: string, partial: Partial<CanvasElement>): void;
-    remove(id: string): void;
-    clear(): void;
+    add(element: CanvasElement, meta?: ElementChangeMeta): void;
+    update(id: string, partial: Partial<CanvasElement>, meta?: ElementChangeMeta): void;
+    remove(id: string, meta?: ElementChangeMeta): void;
+    clear(meta?: ElementChangeMeta): void;
     snapshot(): CanvasElement[];
-    loadSnapshot(elements: CanvasElement[]): void;
+    loadSnapshot(elements: CanvasElement[], meta?: ElementChangeMeta): 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;
+    on<K extends keyof ElementStoreEvents>(event: K, listener: (data: ElementStoreEvents[K], meta: ElementChangeMeta) => void): () => void;
     onChange(listener: () => void): () => void;
 }
 
@@ -1105,6 +1113,6 @@ declare class LaserTool implements Tool {
     private notifyOptionsChange;
 }
 
-declare const VERSION = "0.45.0";
+declare const VERSION = "0.46.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, ElementStore, type ElementStyle, type ElementType, type ElementUpdateEvent, EraserTool, type EraserToolOptions, type ExportImageOptions, type ExportSvgOptions, type FontSizePreset, type GridElement, type GridInfo, HandTool, type HexOrientation, HistoryStack, type HistoryStackOptions, type HtmlElement, 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, 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, getHexCellsInSquare, getHexDistance, isNearBezier, setFontSize, smartSnap, snapPoint, snapToHexCenter, styleToPatch, toggleBold, toggleItalic, toggleStrikethrough, toggleUnderline };
+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 ExportImageOptions, type ExportSvgOptions, type FontSizePreset, type GridElement, type GridInfo, HandTool, type HexOrientation, HistoryStack, type HistoryStackOptions, type HtmlElement, 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, 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, getHexCellsInSquare, getHexDistance, isNearBezier, setFontSize, smartSnap, snapPoint, snapToHexCenter, styleToPatch, toggleBold, toggleItalic, toggleStrikethrough, toggleUnderline };

package/dist/index.d.ts

@@ -162,6 +162,14 @@ interface ElementUpdateEvent {
     previous: CanvasElement;
     current: CanvasElement;
 }
+interface ElementChangeMeta {
+    /**
+     * Identifies what caused the change. `undefined` or `'local'` = a local change (recorded to undo
+     * history and observed as local). Any other value (e.g. `'remote'`) marks an externally-applied
+     * change: it is NOT recorded to undo history, and is tagged so observers can avoid re-broadcasting it.
+     */
+    origin?: string;
+}
 interface ElementStoreEvents {
     add: CanvasElement;
     remove: CanvasElement;
@@ -184,19 +192,19 @@ declare class ElementStore {
         type: T;
     }>[];
     private indexBounds;
-    add(element: CanvasElement): void;
-    update(id: string, partial: Partial<CanvasElement>): void;
-    remove(id: string): void;
-    clear(): void;
+    add(element: CanvasElement, meta?: ElementChangeMeta): void;
+    update(id: string, partial: Partial<CanvasElement>, meta?: ElementChangeMeta): void;
+    remove(id: string, meta?: ElementChangeMeta): void;
+    clear(meta?: ElementChangeMeta): void;
     snapshot(): CanvasElement[];
-    loadSnapshot(elements: CanvasElement[]): void;
+    loadSnapshot(elements: CanvasElement[], meta?: ElementChangeMeta): 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;
+    on<K extends keyof ElementStoreEvents>(event: K, listener: (data: ElementStoreEvents[K], meta: ElementChangeMeta) => void): () => void;
     onChange(listener: () => void): () => void;
 }
 
@@ -1105,6 +1113,6 @@ declare class LaserTool implements Tool {
     private notifyOptionsChange;
 }
 
-declare const VERSION = "0.45.0";
+declare const VERSION = "0.46.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, ElementStore, type ElementStyle, type ElementType, type ElementUpdateEvent, EraserTool, type EraserToolOptions, type ExportImageOptions, type ExportSvgOptions, type FontSizePreset, type GridElement, type GridInfo, HandTool, type HexOrientation, HistoryStack, type HistoryStackOptions, type HtmlElement, 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, 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, getHexCellsInSquare, getHexDistance, isNearBezier, setFontSize, smartSnap, snapPoint, snapToHexCenter, styleToPatch, toggleBold, toggleItalic, toggleStrikethrough, toggleUnderline };
+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 ExportImageOptions, type ExportSvgOptions, type FontSizePreset, type GridElement, type GridInfo, HandTool, type HexOrientation, HistoryStack, type HistoryStackOptions, type HtmlElement, 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, 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, getHexCellsInSquare, getHexDistance, isNearBezier, setFontSize, smartSnap, snapPoint, snapToHexCenter, styleToPatch, toggleBold, toggleItalic, toggleStrikethrough, toggleUnderline };

package/dist/index.js

@@ -2146,6 +2146,7 @@ var Background = class {
 };
 
 // src/core/event-bus.ts
+var EMPTY_META = Object.freeze({});
 var EventBus = class {
   listeners = /* @__PURE__ */ new Map();
   on(event, listener) {
@@ -2161,10 +2162,10 @@ var EventBus = class {
   off(event, listener) {
     this.listeners.get(event)?.delete(listener);
   }
-  emit(event, data) {
+  emit(event, data, meta = EMPTY_META) {
     this.listeners.get(event)?.forEach((listener) => {
       try {
-        listener(data);
+        listener(data, meta);
       } catch (err) {
         console.error(`[fieldnotes] listener error for "${String(event)}"`, err);
       }
@@ -2484,15 +2485,15 @@ var ElementStore = class {
     const angle = element.rotation ?? 0;
     return angle === 0 ? bounds : rotatedAABB(bounds, angle);
   }
-  add(element) {
+  add(element, meta) {
     this.sortedCache = null;
     this._versions.set(element.id, 0);
     this.elements.set(element.id, element);
     const bounds = this.indexBounds(element);
     if (bounds) this.spatialIndex.insert(element.id, bounds);
-    this.bus.emit("add", element);
+    this.bus.emit("add", element, meta);
   }
-  update(id, partial) {
+  update(id, partial, meta) {
     const existing = this.elements.get(id);
     if (!existing) return;
     this.sortedCache = null;
@@ -2519,28 +2520,28 @@ var ElementStore = class {
     if (newBounds) {
       this.spatialIndex.update(id, newBounds);
     }
-    this.bus.emit("update", { previous: existing, current: updated });
+    this.bus.emit("update", { previous: existing, current: updated }, meta);
   }
-  remove(id) {
+  remove(id, meta) {
     const element = this.elements.get(id);
     if (!element) return;
     this.sortedCache = null;
     this._versions.delete(id);
     this.elements.delete(id);
     this.spatialIndex.remove(id);
-    this.bus.emit("remove", element);
+    this.bus.emit("remove", element, meta);
   }
-  clear() {
+  clear(meta) {
     this.sortedCache = null;
     this._versions.clear();
     this.elements.clear();
     this.spatialIndex.clear();
-    this.bus.emit("clear", null);
+    this.bus.emit("clear", null, meta);
   }
   snapshot() {
     return this.getAll().map((el) => ({ ...el }));
   }
-  loadSnapshot(elements) {
+  loadSnapshot(elements, meta) {
     this.sortedCache = null;
     this._versions.clear();
     this.elements.clear();
@@ -2557,9 +2558,9 @@ var ElementStore = class {
         el.cachedControlPoint = getArrowControlPoint(el.from, el.to, el.bend);
       }
     }
-    this.bus.emit("clear", null);
+    this.bus.emit("clear", null, meta);
     for (const el of elements) {
-      this.bus.emit("add", el);
+      this.bus.emit("add", el, meta);
     }
   }
   bringToFront(id) {
@@ -4834,15 +4835,18 @@ var UpdateLayerCommand = class {
 };
 
 // src/history/history-recorder.ts
+function isExternalChange(meta) {
+  return meta.origin !== void 0 && meta.origin !== "local";
+}
 var HistoryRecorder = class {
   constructor(store, stack, layerManager) {
     this.store = store;
     this.stack = stack;
     this.layerManager = layerManager;
     this.unsubscribers = [
-      store.on("add", (el) => this.onAdd(el)),
-      store.on("remove", (el) => this.onRemove(el)),
-      store.on("update", ({ previous, current }) => this.onUpdate(previous, current))
+      store.on("add", (el, meta) => this.onAdd(el, meta)),
+      store.on("remove", (el, meta) => this.onRemove(el, meta)),
+      store.on("update", ({ previous, current }, meta) => this.onUpdate(previous, current, meta))
     ];
     if (layerManager) {
       this.unsubscribers.push(
@@ -4898,18 +4902,21 @@ var HistoryRecorder = class {
       this.stack.push(command);
     }
   }
-  onAdd(element) {
+  onAdd(element, meta) {
+    if (isExternalChange(meta)) return;
     if (!this.recording) return;
     this.record(new AddElementCommand(element));
   }
-  onRemove(element) {
+  onRemove(element, meta) {
+    if (isExternalChange(meta)) return;
     if (!this.recording) return;
     if (this.transaction && this.updateSnapshots.has(element.id)) {
       this.updateSnapshots.delete(element.id);
     }
     this.record(new RemoveElementCommand(element));
   }
-  onUpdate(previous, current) {
+  onUpdate(previous, current, meta) {
+    if (isExternalChange(meta)) return;
     if (!this.recording) return;
     if (this.transaction) {
       if (!this.updateSnapshots.has(current.id)) {
@@ -10081,7 +10088,7 @@ var LaserTool = class {
 };
 
 // src/index.ts
-var VERSION = "0.45.0";
+var VERSION = "0.46.0";
 export {
   ArrowTool,
   AutoSave,