@fieldnotes/core 0.44.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;
 }
 
@@ -304,10 +312,17 @@ declare class LayerManager {
     private findFallbackLayer;
 }
 
+interface StorageAdapter {
+    load(key: string): Promise<string | null>;
+    save(key: string, value: string): Promise<void>;
+    clear(key: string): Promise<void>;
+}
+
 interface AutoSaveOptions {
     key?: string;
     debounceMs?: number;
     layerManager?: LayerManager;
+    adapter?: StorageAdapter;
     onError?: (error: Error) => void;
 }
 declare class AutoSave {
@@ -316,19 +331,52 @@ declare class AutoSave {
     private readonly key;
     private readonly debounceMs;
     private readonly layerManager?;
+    private readonly adapter;
     private timerId;
     private unsubscribers;
     private readonly onError?;
+    private saving;
+    private pendingSave;
     constructor(store: ElementStore, camera: Camera, options?: AutoSaveOptions);
     start(): void;
     stop(): void;
-    load(): CanvasState | null;
-    clear(): void;
+    load(): Promise<CanvasState | null>;
+    clear(): Promise<void>;
     private scheduleSave;
     private cancelPending;
     private save;
 }
 
+declare class MemoryAdapter implements StorageAdapter {
+    private store;
+    load(key: string): Promise<string | null>;
+    save(key: string, value: string): Promise<void>;
+    clear(key: string): Promise<void>;
+}
+
+declare class LocalStorageAdapter implements StorageAdapter {
+    load(key: string): Promise<string | null>;
+    save(key: string, value: string): Promise<void>;
+    clear(key: string): Promise<void>;
+}
+
+interface IndexedDBAdapterOptions {
+    dbName?: string;
+    storeName?: string;
+    indexedDB?: IDBFactory;
+}
+declare class IndexedDBAdapter implements StorageAdapter {
+    private readonly dbName;
+    private readonly storeName;
+    private readonly idb;
+    private dbPromise;
+    constructor(options?: IndexedDBAdapterOptions);
+    private open;
+    load(key: string): Promise<string | null>;
+    save(key: string, value: string): Promise<void>;
+    clear(key: string): Promise<void>;
+}
+
 type BackgroundPattern = 'dots' | 'grid' | 'none';
 interface BackgroundOptions {
     pattern?: BackgroundPattern;
@@ -1065,6 +1113,6 @@ declare class LaserTool implements Tool {
     private notifyOptionsChange;
 }
 
-declare const VERSION = "0.44.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, LaserTool, type LaserToolOptions, 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 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;
 }
 
@@ -304,10 +312,17 @@ declare class LayerManager {
     private findFallbackLayer;
 }
 
+interface StorageAdapter {
+    load(key: string): Promise<string | null>;
+    save(key: string, value: string): Promise<void>;
+    clear(key: string): Promise<void>;
+}
+
 interface AutoSaveOptions {
     key?: string;
     debounceMs?: number;
     layerManager?: LayerManager;
+    adapter?: StorageAdapter;
     onError?: (error: Error) => void;
 }
 declare class AutoSave {
@@ -316,19 +331,52 @@ declare class AutoSave {
     private readonly key;
     private readonly debounceMs;
     private readonly layerManager?;
+    private readonly adapter;
     private timerId;
     private unsubscribers;
     private readonly onError?;
+    private saving;
+    private pendingSave;
     constructor(store: ElementStore, camera: Camera, options?: AutoSaveOptions);
     start(): void;
     stop(): void;
-    load(): CanvasState | null;
-    clear(): void;
+    load(): Promise<CanvasState | null>;
+    clear(): Promise<void>;
     private scheduleSave;
     private cancelPending;
     private save;
 }
 
+declare class MemoryAdapter implements StorageAdapter {
+    private store;
+    load(key: string): Promise<string | null>;
+    save(key: string, value: string): Promise<void>;
+    clear(key: string): Promise<void>;
+}
+
+declare class LocalStorageAdapter implements StorageAdapter {
+    load(key: string): Promise<string | null>;
+    save(key: string, value: string): Promise<void>;
+    clear(key: string): Promise<void>;
+}
+
+interface IndexedDBAdapterOptions {
+    dbName?: string;
+    storeName?: string;
+    indexedDB?: IDBFactory;
+}
+declare class IndexedDBAdapter implements StorageAdapter {
+    private readonly dbName;
+    private readonly storeName;
+    private readonly idb;
+    private dbPromise;
+    constructor(options?: IndexedDBAdapterOptions);
+    private open;
+    load(key: string): Promise<string | null>;
+    save(key: string, value: string): Promise<void>;
+    clear(key: string): Promise<void>;
+}
+
 type BackgroundPattern = 'dots' | 'grid' | 'none';
 interface BackgroundOptions {
     pattern?: BackgroundPattern;
@@ -1065,6 +1113,6 @@ declare class LaserTool implements Tool {
     private notifyOptionsChange;
 }
 
-declare const VERSION = "0.44.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, LaserTool, type LaserToolOptions, 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 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

@@ -285,6 +285,22 @@ function migrateElement(obj) {
   }
 }
 
+// src/core/storage/local-storage-adapter.ts
+var LocalStorageAdapter = class {
+  async load(key) {
+    if (typeof localStorage === "undefined") return null;
+    return localStorage.getItem(key);
+  }
+  async save(key, value) {
+    if (typeof localStorage === "undefined") return;
+    localStorage.setItem(key, value);
+  }
+  async clear(key) {
+    if (typeof localStorage === "undefined") return;
+    localStorage.removeItem(key);
+  }
+};
+
 // src/core/auto-save.ts
 var DEFAULT_KEY = "fieldnotes-autosave";
 var DEFAULT_DEBOUNCE_MS = 1e3;
@@ -295,14 +311,18 @@ var AutoSave = class {
     this.key = options.key ?? DEFAULT_KEY;
     this.debounceMs = options.debounceMs ?? DEFAULT_DEBOUNCE_MS;
     this.layerManager = options.layerManager;
+    this.adapter = options.adapter ?? new LocalStorageAdapter();
     this.onError = options.onError;
   }
   key;
   debounceMs;
   layerManager;
+  adapter;
   timerId = null;
   unsubscribers = [];
   onError;
+  saving = false;
+  pendingSave = false;
   start() {
     const schedule = () => this.scheduleSave();
     this.unsubscribers = [
@@ -320,9 +340,8 @@ var AutoSave = class {
     this.unsubscribers.forEach((fn) => fn());
     this.unsubscribers = [];
   }
-  load() {
-    if (typeof localStorage === "undefined") return null;
-    const json = localStorage.getItem(this.key);
+  async load() {
+    const json = await this.adapter.load(this.key);
     if (!json) return null;
     try {
       return parseState(json);
@@ -330,13 +349,12 @@ var AutoSave = class {
       return null;
     }
   }
-  clear() {
-    if (typeof localStorage === "undefined") return;
-    localStorage.removeItem(this.key);
+  async clear() {
+    await this.adapter.clear(this.key);
   }
   scheduleSave() {
     this.cancelPending();
-    this.timerId = setTimeout(() => this.save(), this.debounceMs);
+    this.timerId = setTimeout(() => void this.save(), this.debounceMs);
   }
   cancelPending() {
     if (this.timerId !== null) {
@@ -344,19 +362,108 @@ var AutoSave = class {
       this.timerId = null;
     }
   }
-  save() {
-    if (typeof localStorage === "undefined") return;
-    const layers = this.layerManager?.snapshot() ?? [];
-    const state = exportState(this.store.snapshot(), this.camera, layers);
+  async save() {
+    if (this.saving) {
+      this.pendingSave = true;
+      return;
+    }
+    this.saving = true;
     try {
-      localStorage.setItem(this.key, JSON.stringify(state));
+      const layers = this.layerManager?.snapshot() ?? [];
+      const state = exportState(this.store.snapshot(), this.camera, layers);
+      await this.adapter.save(this.key, JSON.stringify(state));
     } catch (e) {
-      console.warn("Auto-save failed: storage quota exceeded. State too large for localStorage.");
       this.onError?.(e instanceof Error ? e : new Error(String(e)));
+    } finally {
+      this.saving = false;
+      if (this.pendingSave) {
+        this.pendingSave = false;
+        void this.save();
+      }
     }
   }
 };
 
+// src/core/storage/memory-adapter.ts
+var MemoryAdapter = class {
+  store = /* @__PURE__ */ new Map();
+  async load(key) {
+    return this.store.get(key) ?? null;
+  }
+  async save(key, value) {
+    this.store.set(key, value);
+  }
+  async clear(key) {
+    this.store.delete(key);
+  }
+};
+
+// src/core/storage/indexeddb-adapter.ts
+var DEFAULT_DB = "fieldnotes";
+var DEFAULT_STORE = "state";
+var IndexedDBAdapter = class {
+  dbName;
+  storeName;
+  idb;
+  dbPromise = null;
+  constructor(options = {}) {
+    this.dbName = options.dbName ?? DEFAULT_DB;
+    this.storeName = options.storeName ?? DEFAULT_STORE;
+    this.idb = options.indexedDB ?? (typeof indexedDB !== "undefined" ? indexedDB : null);
+  }
+  open() {
+    const idb = this.idb;
+    if (!idb) return Promise.reject(new Error("IndexedDB unavailable"));
+    if (!this.dbPromise) {
+      const storeName = this.storeName;
+      this.dbPromise = new Promise((resolve, reject) => {
+        const req = idb.open(this.dbName, 1);
+        req.onupgradeneeded = () => {
+          const db = req.result;
+          if (!db.objectStoreNames.contains(storeName)) db.createObjectStore(storeName);
+        };
+        req.onsuccess = () => resolve(req.result);
+        req.onerror = () => reject(req.error ?? new Error("IndexedDB open failed"));
+      });
+    }
+    return this.dbPromise;
+  }
+  async load(key) {
+    if (!this.idb) return null;
+    const db = await this.open();
+    return new Promise((resolve, reject) => {
+      const req = db.transaction(this.storeName, "readonly").objectStore(this.storeName).get(key);
+      req.onsuccess = () => {
+        const v = req.result;
+        resolve(typeof v === "string" ? v : null);
+      };
+      req.onerror = () => reject(req.error ?? new Error("IndexedDB read failed"));
+    });
+  }
+  async save(key, value) {
+    if (!this.idb) return;
+    const db = await this.open();
+    return new Promise((resolve, reject) => {
+      const tx = db.transaction(this.storeName, "readwrite");
+      tx.objectStore(this.storeName).put(value, key);
+      tx.oncomplete = () => resolve();
+      tx.onerror = () => reject(tx.error ?? new Error("IndexedDB write failed"));
+      tx.onabort = () => reject(tx.error ?? new Error("IndexedDB write aborted"));
+    });
+  }
+  async clear(key) {
+    if (!this.idb) return;
+    const db = await this.open();
+    return new Promise((resolve, reject) => {
+      const tx = db.transaction(this.storeName, "readwrite");
+      tx.objectStore(this.storeName).delete(key);
+      tx.oncomplete = () => resolve();
+      tx.onerror = () => reject(tx.error ?? new Error("IndexedDB delete failed"));
+      tx.onabort = () => reject(tx.error ?? new Error("IndexedDB delete aborted"));
+    });
+  }
+};
+
 // src/canvas/camera.ts
 var DEFAULT_MIN_ZOOM = 0.1;
 var DEFAULT_MAX_ZOOM = 10;
@@ -2039,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) {
@@ -2054,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);
       }
@@ -2377,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;
@@ -2412,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();
@@ -2450,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) {
@@ -4727,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(
@@ -4791,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)) {
@@ -9974,7 +10088,7 @@ var LaserTool = class {
 };
 
 // src/index.ts
-var VERSION = "0.44.0";
+var VERSION = "0.46.0";
 export {
   ArrowTool,
   AutoSave,
@@ -9985,9 +10099,12 @@ export {
   HandTool,
   HistoryStack,
   ImageTool,
+  IndexedDBAdapter,
   LaserTool,
   LayerManager,
+  LocalStorageAdapter,
   MeasureTool,
+  MemoryAdapter,
   NoteTool,
   PencilTool,
   SelectTool,