@fieldnotes/core 0.14.0 → 0.15.0

package/dist/index.cjs

@@ -1084,6 +1084,14 @@ var InputHandler = class {
       e.preventDefault();
       this.handlePaste();
     }
+    if (e.key === "]") {
+      e.preventDefault();
+      this.handleZOrder(e.ctrlKey || e.metaKey ? "front" : "forward");
+    }
+    if (e.key === "[") {
+      e.preventDefault();
+      this.handleZOrder(e.ctrlKey || e.metaKey ? "back" : "backward");
+    }
   };
   onKeyUp = (e) => {
     if (e.key === " ") {
@@ -1260,6 +1268,33 @@ var InputHandler = class {
     selectTool.setSelection(newIds);
     this.toolContext.requestRender();
   }
+  handleZOrder(operation) {
+    if (!this.toolManager || !this.toolContext) return;
+    const tool = this.toolManager.activeTool;
+    if (tool?.name !== "select") return;
+    const selectTool = tool;
+    const ids = selectTool.selectedIds;
+    if (ids.length === 0) return;
+    this.historyRecorder?.begin();
+    for (const id of ids) {
+      switch (operation) {
+        case "forward":
+          this.toolContext.store.bringForward(id);
+          break;
+        case "backward":
+          this.toolContext.store.sendBackward(id);
+          break;
+        case "front":
+          this.toolContext.store.bringToFront(id);
+          break;
+        case "back":
+          this.toolContext.store.sendToBack(id);
+          break;
+      }
+    }
+    this.historyRecorder?.commit();
+    this.toolContext.requestRender();
+  }
   cancelToolIfActive(e) {
     if (this.isToolActive) {
       this.dispatchToolUp(e);
@@ -1556,9 +1591,13 @@ var ElementStore = class {
   layerOrderMap = /* @__PURE__ */ new Map();
   spatialIndex = new Quadtree({ x: -1e5, y: -1e5, w: 2e5, h: 2e5 });
   sortedCache = null;
+  _versions = /* @__PURE__ */ new Map();
   get count() {
     return this.elements.size;
   }
+  getVersion(id) {
+    return this._versions.get(id) ?? -1;
+  }
   setLayerOrder(order) {
     this.layerOrderMap = new Map(order);
     this.sortedCache = null;
@@ -1583,6 +1622,7 @@ var ElementStore = class {
   }
   add(element) {
     this.sortedCache = null;
+    this._versions.set(element.id, 0);
     this.elements.set(element.id, element);
     const bounds = getElementBounds(element);
     if (bounds) this.spatialIndex.insert(element.id, bounds);
@@ -1592,6 +1632,7 @@ var ElementStore = class {
     const existing = this.elements.get(id);
     if (!existing) return;
     this.sortedCache = null;
+    this._versions.set(id, (this._versions.get(id) ?? 0) + 1);
     const updated = { ...existing, ...partial, id: existing.id, type: existing.type };
     if (updated.type === "arrow") {
       const arrow = updated;
@@ -1611,12 +1652,14 @@ var ElementStore = class {
     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);
   }
   clear() {
     this.sortedCache = null;
+    this._versions.clear();
     this.elements.clear();
     this.spatialIndex.clear();
     this.bus.emit("clear", null);
@@ -1626,10 +1669,12 @@ var ElementStore = class {
   }
   loadSnapshot(elements) {
     this.sortedCache = null;
+    this._versions.clear();
     this.elements.clear();
     this.spatialIndex.clear();
     for (const el of elements) {
       this.elements.set(el.id, el);
+      this._versions.set(el.id, 0);
       const bounds = getElementBounds(el);
       if (bounds) this.spatialIndex.insert(el.id, bounds);
     }
@@ -1638,6 +1683,54 @@ var ElementStore = class {
       this.bus.emit("add", el);
     }
   }
+  bringToFront(id) {
+    const el = this.elements.get(id);
+    if (!el) return;
+    const siblings = [...this.elements.values()].filter(
+      (e) => e.layerId === el.layerId && e.id !== id
+    );
+    if (siblings.length === 0) return;
+    const maxZ = Math.max(...siblings.map((e) => e.zIndex));
+    if (el.zIndex >= maxZ) return;
+    this.update(id, { zIndex: maxZ + 1 });
+  }
+  sendToBack(id) {
+    const el = this.elements.get(id);
+    if (!el) return;
+    const siblings = [...this.elements.values()].filter(
+      (e) => e.layerId === el.layerId && e.id !== id
+    );
+    if (siblings.length === 0) return;
+    const minZ = Math.min(...siblings.map((e) => e.zIndex));
+    if (el.zIndex <= minZ) return;
+    this.update(id, { zIndex: minZ - 1 });
+  }
+  bringForward(id) {
+    const el = this.elements.get(id);
+    if (!el) return;
+    const sorted = [...this.elements.values()].filter((e) => e.layerId === el.layerId).sort((a, b) => a.zIndex - b.zIndex);
+    const idx = sorted.findIndex((e) => e.id === id);
+    if (idx < 0 || idx >= sorted.length - 1) return;
+    const next = sorted[idx + 1];
+    if (!next) return;
+    const myZ = el.zIndex;
+    const nextZ = next.zIndex;
+    this.update(id, { zIndex: nextZ });
+    this.update(next.id, { zIndex: myZ });
+  }
+  sendBackward(id) {
+    const el = this.elements.get(id);
+    if (!el) return;
+    const sorted = [...this.elements.values()].filter((e) => e.layerId === el.layerId).sort((a, b) => a.zIndex - b.zIndex);
+    const idx = sorted.findIndex((e) => e.id === id);
+    if (idx <= 0) return;
+    const prev = sorted[idx - 1];
+    if (!prev) return;
+    const myZ = el.zIndex;
+    const prevZ = prev.zIndex;
+    this.update(id, { zIndex: prevZ });
+    this.update(prev.id, { zIndex: myZ });
+  }
   queryRect(rect) {
     const ids = this.spatialIndex.query(rect);
     const elements = [];
@@ -3900,10 +3993,14 @@ var DomNodeManager = class {
   domLayer;
   onEditRequest;
   isEditingElement;
+  getVersion;
+  lastSyncedVersion = /* @__PURE__ */ new Map();
+  lastSyncedZIndex = /* @__PURE__ */ new Map();
   constructor(deps) {
     this.domLayer = deps.domLayer;
     this.onEditRequest = deps.onEditRequest;
     this.isEditingElement = deps.isEditingElement;
+    this.getVersion = deps.getVersion ?? null;
   }
   getNode(id) {
     return this.domNodes.get(id);
@@ -3922,6 +4019,17 @@ var DomNodeManager = class {
       });
       this.domLayer.appendChild(node);
       this.domNodes.set(element.id, node);
+    } else if (this.getVersion) {
+      const currentVersion = this.getVersion(element.id);
+      const lastVersion = this.lastSyncedVersion.get(element.id);
+      const lastZ = this.lastSyncedZIndex.get(element.id);
+      if (lastVersion === currentVersion && lastZ === zIndex) {
+        return;
+      }
+    }
+    if (this.getVersion) {
+      this.lastSyncedVersion.set(element.id, this.getVersion(element.id));
+      this.lastSyncedZIndex.set(element.id, zIndex);
     }
     const size = "size" in element ? element.size : null;
     Object.assign(node.style, {
@@ -3940,6 +4048,8 @@ var DomNodeManager = class {
   }
   removeDomNode(id) {
     this.htmlContent.delete(id);
+    this.lastSyncedVersion.delete(id);
+    this.lastSyncedZIndex.delete(id);
     const node = this.domNodes.get(id);
     if (node) {
       node.remove();
@@ -3950,6 +4060,8 @@ var DomNodeManager = class {
     this.domNodes.forEach((node) => node.remove());
     this.domNodes.clear();
     this.htmlContent.clear();
+    this.lastSyncedVersion.clear();
+    this.lastSyncedZIndex.clear();
   }
   reattachHtmlContent(store) {
     for (const el of store.getElementsByType("html")) {
@@ -4469,7 +4581,8 @@ var Viewport = class {
     this.domNodeManager = new DomNodeManager({
       domLayer: this.domLayer,
       onEditRequest: (id) => this.startEditingElement(id),
-      isEditingElement: (id) => this.noteEditor.isEditing && this.noteEditor.editingElementId === id
+      isEditingElement: (id) => this.noteEditor.isEditing && this.noteEditor.editingElementId === id,
+      getVersion: (id) => this.store.getVersion(id)
     });
     this.interactMode = new InteractMode({
       getNode: (id) => this.domNodeManager.getNode(id)
@@ -5292,6 +5405,7 @@ var SelectTool = class {
   ctx = null;
   pendingSingleSelectId = null;
   hasDragged = false;
+  resizeAspectRatio = 0;
   get selectedIds() {
     return [...this._selectedIds];
   }
@@ -5337,7 +5451,8 @@ var SelectTool = class {
     const resizeHit = this.hitTestResizeHandle(world, ctx);
     if (resizeHit) {
       const el = ctx.store.getById(resizeHit.elementId);
-      if (el) {
+      if (el && "size" in el) {
+        this.resizeAspectRatio = el.size.h > 0 ? el.size.w / el.size.h : 0;
         this.mode = {
           type: "resizing",
           elementId: resizeHit.elementId,
@@ -5389,7 +5504,7 @@ var SelectTool = class {
     }
     if (this.mode.type === "resizing") {
       ctx.setCursor?.(HANDLE_CURSORS[this.mode.handle]);
-      this.handleResize(world, ctx);
+      this.handleResize(world, ctx, state.shiftKey);
       return;
     }
     if (this.mode.type === "dragging" && this._selectedIds.length > 0) {
@@ -5513,7 +5628,7 @@ var SelectTool = class {
     const hit = this.hitTest(world, ctx);
     ctx.setCursor?.(hit ? "move" : "default");
   }
-  handleResize(world, ctx) {
+  handleResize(world, ctx, shiftKey = false) {
     if (this.mode.type !== "resizing") return;
     const el = ctx.store.getById(this.mode.elementId);
     if (!el || !("size" in el) || el.locked) return;
@@ -5544,6 +5659,21 @@ var SelectTool = class {
         h -= dy;
         break;
     }
+    if (shiftKey && this.resizeAspectRatio > 0) {
+      const absDw = Math.abs(w - el.size.w);
+      const absDh = Math.abs(h - el.size.h);
+      if (absDw >= absDh) {
+        h = w / this.resizeAspectRatio;
+      } else {
+        w = h * this.resizeAspectRatio;
+      }
+      if (handle === "nw" || handle === "sw") {
+        x = el.position.x + el.size.w - w;
+      }
+      if (handle === "nw" || handle === "ne") {
+        y = el.position.y + el.size.h - h;
+      }
+    }
     if (w < MIN_ELEMENT_SIZE) {
       if (handle === "nw" || handle === "sw") x = el.position.x + el.size.w - MIN_ELEMENT_SIZE;
       w = MIN_ELEMENT_SIZE;
@@ -6647,7 +6777,7 @@ var UpdateLayerCommand = class {
 };
 
 // src/index.ts
-var VERSION = "0.14.0";
+var VERSION = "0.15.0";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AddElementCommand,

package/dist/index.d.cts

@@ -204,7 +204,9 @@ declare class ElementStore {
     private layerOrderMap;
     private spatialIndex;
     private sortedCache;
+    private _versions;
     get count(): number;
+    getVersion(id: string): number;
     setLayerOrder(order: Map<string, number>): void;
     getAll(): CanvasElement[];
     getById(id: string): CanvasElement | undefined;
@@ -217,6 +219,10 @@ declare class ElementStore {
     clear(): void;
     snapshot(): CanvasElement[];
     loadSnapshot(elements: CanvasElement[]): 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;
@@ -462,6 +468,7 @@ declare class InputHandler {
     private handleRedo;
     private handleCopy;
     private handlePaste;
+    private handleZOrder;
     private cancelToolIfActive;
 }
 
@@ -935,6 +942,7 @@ declare class SelectTool implements Tool {
     private ctx;
     private pendingSingleSelectId;
     private hasDragged;
+    private resizeAspectRatio;
     get selectedIds(): string[];
     setSelection(ids: string[]): void;
     get isMarqueeActive(): boolean;
@@ -1181,6 +1189,6 @@ declare class UpdateLayerCommand implements Command {
     undo(_store: ElementStore): void;
 }
 
-declare const VERSION = "0.14.0";
+declare const VERSION = "0.15.0";
 
 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, DoubleTapDetector, type DoubleTapDetectorOptions, ElementRenderer, ElementStore, type ElementType, type ElementUpdateEvent, EraserTool, type EraserToolOptions, EventBus, type ExportImageOptions, type FilterAction, type FilteredEvent, type FilteredUpEvent, type FontSizePreset, type GridElement, type GridInfo, HandTool, type HexOrientation, HistoryRecorder, HistoryStack, type HistoryStackOptions, type HtmlElement, type ImageElement, ImageTool, type ImageToolOptions, InputFilter, 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, getElementsBoundingBox, getHexCellsInCone, getHexCellsInLine, getHexCellsInRadius, getHexCellsInSquare, getHexDistance, isBindable, isNearBezier, parseState, sanitizeNoteHtml, setFontSize, smartSnap, snapPoint, snapToHexCenter, toggleBold, toggleItalic, toggleStrikethrough, toggleUnderline, unbindArrow, updateBoundArrow };

package/dist/index.d.ts

@@ -204,7 +204,9 @@ declare class ElementStore {
     private layerOrderMap;
     private spatialIndex;
     private sortedCache;
+    private _versions;
     get count(): number;
+    getVersion(id: string): number;
     setLayerOrder(order: Map<string, number>): void;
     getAll(): CanvasElement[];
     getById(id: string): CanvasElement | undefined;
@@ -217,6 +219,10 @@ declare class ElementStore {
     clear(): void;
     snapshot(): CanvasElement[];
     loadSnapshot(elements: CanvasElement[]): 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;
@@ -462,6 +468,7 @@ declare class InputHandler {
     private handleRedo;
     private handleCopy;
     private handlePaste;
+    private handleZOrder;
     private cancelToolIfActive;
 }
 
@@ -935,6 +942,7 @@ declare class SelectTool implements Tool {
     private ctx;
     private pendingSingleSelectId;
     private hasDragged;
+    private resizeAspectRatio;
     get selectedIds(): string[];
     setSelection(ids: string[]): void;
     get isMarqueeActive(): boolean;
@@ -1181,6 +1189,6 @@ declare class UpdateLayerCommand implements Command {
     undo(_store: ElementStore): void;
 }
 
-declare const VERSION = "0.14.0";
+declare const VERSION = "0.15.0";
 
 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, DoubleTapDetector, type DoubleTapDetectorOptions, ElementRenderer, ElementStore, type ElementType, type ElementUpdateEvent, EraserTool, type EraserToolOptions, EventBus, type ExportImageOptions, type FilterAction, type FilteredEvent, type FilteredUpEvent, type FontSizePreset, type GridElement, type GridInfo, HandTool, type HexOrientation, HistoryRecorder, HistoryStack, type HistoryStackOptions, type HtmlElement, type ImageElement, ImageTool, type ImageToolOptions, InputFilter, 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, getElementsBoundingBox, getHexCellsInCone, getHexCellsInLine, getHexCellsInRadius, getHexCellsInSquare, getHexDistance, isBindable, isNearBezier, parseState, sanitizeNoteHtml, setFontSize, smartSnap, snapPoint, snapToHexCenter, toggleBold, toggleItalic, toggleStrikethrough, toggleUnderline, unbindArrow, updateBoundArrow };

package/dist/index.js

@@ -975,6 +975,14 @@ var InputHandler = class {
       e.preventDefault();
       this.handlePaste();
     }
+    if (e.key === "]") {
+      e.preventDefault();
+      this.handleZOrder(e.ctrlKey || e.metaKey ? "front" : "forward");
+    }
+    if (e.key === "[") {
+      e.preventDefault();
+      this.handleZOrder(e.ctrlKey || e.metaKey ? "back" : "backward");
+    }
   };
   onKeyUp = (e) => {
     if (e.key === " ") {
@@ -1151,6 +1159,33 @@ var InputHandler = class {
     selectTool.setSelection(newIds);
     this.toolContext.requestRender();
   }
+  handleZOrder(operation) {
+    if (!this.toolManager || !this.toolContext) return;
+    const tool = this.toolManager.activeTool;
+    if (tool?.name !== "select") return;
+    const selectTool = tool;
+    const ids = selectTool.selectedIds;
+    if (ids.length === 0) return;
+    this.historyRecorder?.begin();
+    for (const id of ids) {
+      switch (operation) {
+        case "forward":
+          this.toolContext.store.bringForward(id);
+          break;
+        case "backward":
+          this.toolContext.store.sendBackward(id);
+          break;
+        case "front":
+          this.toolContext.store.bringToFront(id);
+          break;
+        case "back":
+          this.toolContext.store.sendToBack(id);
+          break;
+      }
+    }
+    this.historyRecorder?.commit();
+    this.toolContext.requestRender();
+  }
   cancelToolIfActive(e) {
     if (this.isToolActive) {
       this.dispatchToolUp(e);
@@ -1447,9 +1482,13 @@ var ElementStore = class {
   layerOrderMap = /* @__PURE__ */ new Map();
   spatialIndex = new Quadtree({ x: -1e5, y: -1e5, w: 2e5, h: 2e5 });
   sortedCache = null;
+  _versions = /* @__PURE__ */ new Map();
   get count() {
     return this.elements.size;
   }
+  getVersion(id) {
+    return this._versions.get(id) ?? -1;
+  }
   setLayerOrder(order) {
     this.layerOrderMap = new Map(order);
     this.sortedCache = null;
@@ -1474,6 +1513,7 @@ var ElementStore = class {
   }
   add(element) {
     this.sortedCache = null;
+    this._versions.set(element.id, 0);
     this.elements.set(element.id, element);
     const bounds = getElementBounds(element);
     if (bounds) this.spatialIndex.insert(element.id, bounds);
@@ -1483,6 +1523,7 @@ var ElementStore = class {
     const existing = this.elements.get(id);
     if (!existing) return;
     this.sortedCache = null;
+    this._versions.set(id, (this._versions.get(id) ?? 0) + 1);
     const updated = { ...existing, ...partial, id: existing.id, type: existing.type };
     if (updated.type === "arrow") {
       const arrow = updated;
@@ -1502,12 +1543,14 @@ var ElementStore = class {
     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);
   }
   clear() {
     this.sortedCache = null;
+    this._versions.clear();
     this.elements.clear();
     this.spatialIndex.clear();
     this.bus.emit("clear", null);
@@ -1517,10 +1560,12 @@ var ElementStore = class {
   }
   loadSnapshot(elements) {
     this.sortedCache = null;
+    this._versions.clear();
     this.elements.clear();
     this.spatialIndex.clear();
     for (const el of elements) {
       this.elements.set(el.id, el);
+      this._versions.set(el.id, 0);
       const bounds = getElementBounds(el);
       if (bounds) this.spatialIndex.insert(el.id, bounds);
     }
@@ -1529,6 +1574,54 @@ var ElementStore = class {
       this.bus.emit("add", el);
     }
   }
+  bringToFront(id) {
+    const el = this.elements.get(id);
+    if (!el) return;
+    const siblings = [...this.elements.values()].filter(
+      (e) => e.layerId === el.layerId && e.id !== id
+    );
+    if (siblings.length === 0) return;
+    const maxZ = Math.max(...siblings.map((e) => e.zIndex));
+    if (el.zIndex >= maxZ) return;
+    this.update(id, { zIndex: maxZ + 1 });
+  }
+  sendToBack(id) {
+    const el = this.elements.get(id);
+    if (!el) return;
+    const siblings = [...this.elements.values()].filter(
+      (e) => e.layerId === el.layerId && e.id !== id
+    );
+    if (siblings.length === 0) return;
+    const minZ = Math.min(...siblings.map((e) => e.zIndex));
+    if (el.zIndex <= minZ) return;
+    this.update(id, { zIndex: minZ - 1 });
+  }
+  bringForward(id) {
+    const el = this.elements.get(id);
+    if (!el) return;
+    const sorted = [...this.elements.values()].filter((e) => e.layerId === el.layerId).sort((a, b) => a.zIndex - b.zIndex);
+    const idx = sorted.findIndex((e) => e.id === id);
+    if (idx < 0 || idx >= sorted.length - 1) return;
+    const next = sorted[idx + 1];
+    if (!next) return;
+    const myZ = el.zIndex;
+    const nextZ = next.zIndex;
+    this.update(id, { zIndex: nextZ });
+    this.update(next.id, { zIndex: myZ });
+  }
+  sendBackward(id) {
+    const el = this.elements.get(id);
+    if (!el) return;
+    const sorted = [...this.elements.values()].filter((e) => e.layerId === el.layerId).sort((a, b) => a.zIndex - b.zIndex);
+    const idx = sorted.findIndex((e) => e.id === id);
+    if (idx <= 0) return;
+    const prev = sorted[idx - 1];
+    if (!prev) return;
+    const myZ = el.zIndex;
+    const prevZ = prev.zIndex;
+    this.update(id, { zIndex: prevZ });
+    this.update(prev.id, { zIndex: myZ });
+  }
   queryRect(rect) {
     const ids = this.spatialIndex.query(rect);
     const elements = [];
@@ -3791,10 +3884,14 @@ var DomNodeManager = class {
   domLayer;
   onEditRequest;
   isEditingElement;
+  getVersion;
+  lastSyncedVersion = /* @__PURE__ */ new Map();
+  lastSyncedZIndex = /* @__PURE__ */ new Map();
   constructor(deps) {
     this.domLayer = deps.domLayer;
     this.onEditRequest = deps.onEditRequest;
     this.isEditingElement = deps.isEditingElement;
+    this.getVersion = deps.getVersion ?? null;
   }
   getNode(id) {
     return this.domNodes.get(id);
@@ -3813,6 +3910,17 @@ var DomNodeManager = class {
       });
       this.domLayer.appendChild(node);
       this.domNodes.set(element.id, node);
+    } else if (this.getVersion) {
+      const currentVersion = this.getVersion(element.id);
+      const lastVersion = this.lastSyncedVersion.get(element.id);
+      const lastZ = this.lastSyncedZIndex.get(element.id);
+      if (lastVersion === currentVersion && lastZ === zIndex) {
+        return;
+      }
+    }
+    if (this.getVersion) {
+      this.lastSyncedVersion.set(element.id, this.getVersion(element.id));
+      this.lastSyncedZIndex.set(element.id, zIndex);
     }
     const size = "size" in element ? element.size : null;
     Object.assign(node.style, {
@@ -3831,6 +3939,8 @@ var DomNodeManager = class {
   }
   removeDomNode(id) {
     this.htmlContent.delete(id);
+    this.lastSyncedVersion.delete(id);
+    this.lastSyncedZIndex.delete(id);
     const node = this.domNodes.get(id);
     if (node) {
       node.remove();
@@ -3841,6 +3951,8 @@ var DomNodeManager = class {
     this.domNodes.forEach((node) => node.remove());
     this.domNodes.clear();
     this.htmlContent.clear();
+    this.lastSyncedVersion.clear();
+    this.lastSyncedZIndex.clear();
   }
   reattachHtmlContent(store) {
     for (const el of store.getElementsByType("html")) {
@@ -4360,7 +4472,8 @@ var Viewport = class {
     this.domNodeManager = new DomNodeManager({
       domLayer: this.domLayer,
       onEditRequest: (id) => this.startEditingElement(id),
-      isEditingElement: (id) => this.noteEditor.isEditing && this.noteEditor.editingElementId === id
+      isEditingElement: (id) => this.noteEditor.isEditing && this.noteEditor.editingElementId === id,
+      getVersion: (id) => this.store.getVersion(id)
     });
     this.interactMode = new InteractMode({
       getNode: (id) => this.domNodeManager.getNode(id)
@@ -5183,6 +5296,7 @@ var SelectTool = class {
   ctx = null;
   pendingSingleSelectId = null;
   hasDragged = false;
+  resizeAspectRatio = 0;
   get selectedIds() {
     return [...this._selectedIds];
   }
@@ -5228,7 +5342,8 @@ var SelectTool = class {
     const resizeHit = this.hitTestResizeHandle(world, ctx);
     if (resizeHit) {
       const el = ctx.store.getById(resizeHit.elementId);
-      if (el) {
+      if (el && "size" in el) {
+        this.resizeAspectRatio = el.size.h > 0 ? el.size.w / el.size.h : 0;
         this.mode = {
           type: "resizing",
           elementId: resizeHit.elementId,
@@ -5280,7 +5395,7 @@ var SelectTool = class {
     }
     if (this.mode.type === "resizing") {
       ctx.setCursor?.(HANDLE_CURSORS[this.mode.handle]);
-      this.handleResize(world, ctx);
+      this.handleResize(world, ctx, state.shiftKey);
       return;
     }
     if (this.mode.type === "dragging" && this._selectedIds.length > 0) {
@@ -5404,7 +5519,7 @@ var SelectTool = class {
     const hit = this.hitTest(world, ctx);
     ctx.setCursor?.(hit ? "move" : "default");
   }
-  handleResize(world, ctx) {
+  handleResize(world, ctx, shiftKey = false) {
     if (this.mode.type !== "resizing") return;
     const el = ctx.store.getById(this.mode.elementId);
     if (!el || !("size" in el) || el.locked) return;
@@ -5435,6 +5550,21 @@ var SelectTool = class {
         h -= dy;
         break;
     }
+    if (shiftKey && this.resizeAspectRatio > 0) {
+      const absDw = Math.abs(w - el.size.w);
+      const absDh = Math.abs(h - el.size.h);
+      if (absDw >= absDh) {
+        h = w / this.resizeAspectRatio;
+      } else {
+        w = h * this.resizeAspectRatio;
+      }
+      if (handle === "nw" || handle === "sw") {
+        x = el.position.x + el.size.w - w;
+      }
+      if (handle === "nw" || handle === "ne") {
+        y = el.position.y + el.size.h - h;
+      }
+    }
     if (w < MIN_ELEMENT_SIZE) {
       if (handle === "nw" || handle === "sw") x = el.position.x + el.size.w - MIN_ELEMENT_SIZE;
       w = MIN_ELEMENT_SIZE;
@@ -6538,7 +6668,7 @@ var UpdateLayerCommand = class {
 };
 
 // src/index.ts
-var VERSION = "0.14.0";
+var VERSION = "0.15.0";
 export {
   AddElementCommand,
   ArrowTool,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fieldnotes/core",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "Vanilla TypeScript infinite canvas engine",
   "type": "module",
   "main": "./dist/index.cjs",