microboard-temp 0.13.15 → 0.13.16

package/dist/cjs/browser.js

@@ -4675,6 +4675,11 @@ var conf = {
   DEFAULT_GAME_ITEM_DIMENSIONS: { width: 200, height: 200 },
   MAX_CARD_SIZE: 500,
   CONNECTOR_ITEM_OFFSET: 20,
+  FG_SPRING_K: 3,
+  FG_TARGET_GAP: 60,
+  FG_REPULSION: 400000,
+  FG_DAMPING: 0.8,
+  FG_SLEEP_THRESHOLD: 0.5,
   GRAVITY_G: 80,
   GRAVITY_G_CENTER: 120,
   GRAVITY_DAMPING: 0.96,
@@ -54569,6 +54574,176 @@ class GravityEngine {
   }
 }
 
+// src/ForceGraph/ForceGraphEngine.ts
+var EXCLUDED_TYPES = new Set(["Connector", "Comment"]);
+
+class ForceGraphEngine {
+  board;
+  velocities = new Map;
+  tickTimer = null;
+  syncTimer = null;
+  lastSyncedPositions = new Map;
+  TICK_MS = 33;
+  SYNC_MS = 300;
+  SOFTENING_SQ = 100 * 100;
+  MIN_MOVE_PX = 0.05;
+  constructor(board) {
+    this.board = board;
+  }
+  start() {
+    if (this.tickTimer !== null)
+      return;
+    for (const item of this.getNodes()) {
+      const pos = item.transformation.getTranslation();
+      this.lastSyncedPositions.set(item.getId(), { x: pos.x, y: pos.y });
+      this.velocities.set(item.getId(), { vx: 0, vy: 0 });
+    }
+    this.tickTimer = setInterval(() => this.tick(), this.TICK_MS);
+    this.syncTimer = setInterval(() => this.syncPositions(), this.SYNC_MS);
+  }
+  stop() {
+    if (this.tickTimer !== null) {
+      clearInterval(this.tickTimer);
+      this.tickTimer = null;
+    }
+    if (this.syncTimer !== null) {
+      clearInterval(this.syncTimer);
+      this.syncTimer = null;
+    }
+    this.syncPositions();
+    this.velocities.clear();
+    this.lastSyncedPositions.clear();
+  }
+  getNodes() {
+    return this.board.items.listAll().filter((item) => !EXCLUDED_TYPES.has(item.itemType) && !item.transformation.isLocked);
+  }
+  getConnectors() {
+    return this.board.items.listAll().filter((item) => item.itemType === "Connector");
+  }
+  tick() {
+    const dt = this.TICK_MS / 1000;
+    const nodes = this.getNodes();
+    if (nodes.length < 2)
+      return;
+    const snapMap = new Map;
+    for (const item of nodes) {
+      const pos = item.transformation.getTranslation();
+      const mbr = item.getMbr();
+      const w = Math.max(mbr.getWidth(), 1);
+      const h2 = Math.max(mbr.getHeight(), 1);
+      snapMap.set(item.getId(), {
+        id: item.getId(),
+        cx: pos.x + w * 0.5,
+        cy: pos.y + h2 * 0.5,
+        w,
+        h: h2
+      });
+    }
+    const snap = Array.from(snapMap.values());
+    const ax = new Map;
+    const ay = new Map;
+    for (const s2 of snap) {
+      ax.set(s2.id, 0);
+      ay.set(s2.id, 0);
+    }
+    for (const connector of this.getConnectors()) {
+      const { startItem, endItem } = connector.getConnectedItems();
+      if (!startItem || !endItem)
+        continue;
+      const s1 = snapMap.get(startItem.getId());
+      const s2 = snapMap.get(endItem.getId());
+      if (!s1 || !s2)
+        continue;
+      const dx = s2.cx - s1.cx;
+      const dy = s2.cy - s1.cy;
+      const dist = Math.sqrt(dx * dx + dy * dy) + 0.001;
+      const targetDist = (Math.max(s1.w, s1.h) + Math.max(s2.w, s2.h)) * 0.5 + conf.FG_TARGET_GAP;
+      const stretch = dist - targetDist;
+      const forceMag = stretch * conf.FG_SPRING_K;
+      const fx = dx / dist * forceMag;
+      const fy = dy / dist * forceMag;
+      ax.set(s1.id, (ax.get(s1.id) ?? 0) + fx);
+      ay.set(s1.id, (ay.get(s1.id) ?? 0) + fy);
+      ax.set(s2.id, (ax.get(s2.id) ?? 0) - fx);
+      ay.set(s2.id, (ay.get(s2.id) ?? 0) - fy);
+    }
+    for (let i = 0;i < snap.length; i++) {
+      for (let j = i + 1;j < snap.length; j++) {
+        const s1 = snap[i];
+        const s2 = snap[j];
+        const dx = s2.cx - s1.cx;
+        const dy = s2.cy - s1.cy;
+        const distSq = dx * dx + dy * dy + this.SOFTENING_SQ;
+        const repMag = conf.FG_REPULSION / distSq;
+        const fx = dx * repMag;
+        const fy = dy * repMag;
+        ax.set(s1.id, (ax.get(s1.id) ?? 0) - fx);
+        ay.set(s1.id, (ay.get(s1.id) ?? 0) - fy);
+        ax.set(s2.id, (ax.get(s2.id) ?? 0) + fx);
+        ay.set(s2.id, (ay.get(s2.id) ?? 0) + fy);
+      }
+    }
+    let totalEnergy = 0;
+    for (const item of nodes) {
+      const id = item.getId();
+      if (!this.velocities.has(id)) {
+        this.velocities.set(id, { vx: 0, vy: 0 });
+      }
+      const vel = this.velocities.get(id);
+      vel.vx = (vel.vx + (ax.get(id) ?? 0) * dt) * conf.FG_DAMPING;
+      vel.vy = (vel.vy + (ay.get(id) ?? 0) * dt) * conf.FG_DAMPING;
+      totalEnergy += vel.vx * vel.vx + vel.vy * vel.vy;
+      const moveX = vel.vx * dt;
+      const moveY = vel.vy * dt;
+      if (Math.abs(moveX) >= this.MIN_MOVE_PX || Math.abs(moveY) >= this.MIN_MOVE_PX) {
+        item.transformation.applyMatrixSilent({
+          translateX: moveX,
+          translateY: moveY,
+          scaleX: 1,
+          scaleY: 1,
+          shearX: 0,
+          shearY: 0
+        });
+      }
+    }
+    if (totalEnergy < conf.FG_SLEEP_THRESHOLD && this.tickTimer !== null) {
+      clearInterval(this.tickTimer);
+      this.tickTimer = null;
+      this.syncPositions();
+    }
+  }
+  syncPositions() {
+    const nodes = this.getNodes();
+    if (nodes.length === 0)
+      return;
+    const movedItems = nodes.map((item) => {
+      const id = item.getId();
+      const pos = item.transformation.getTranslation();
+      const last = this.lastSyncedPositions.get(id);
+      const dx = last ? pos.x - last.x : 0;
+      const dy = last ? pos.y - last.y : 0;
+      this.lastSyncedPositions.set(id, { x: pos.x, y: pos.y });
+      return { id, dx, dy };
+    }).filter(({ dx, dy }) => Math.abs(dx) > 0.5 || Math.abs(dy) > 0.5);
+    if (movedItems.length === 0)
+      return;
+    const operation = {
+      class: "Transformation",
+      method: "applyMatrix",
+      items: movedItems.map(({ id, dx, dy }) => ({
+        id,
+        matrix: { translateX: dx, translateY: dy, scaleX: 1, scaleY: 1, shearX: 0, shearY: 0 }
+      }))
+    };
+    this.board.events.emit(operation);
+  }
+  wake() {
+    if (this.tickTimer === null && this.syncTimer !== null) {
+      this.tickTimer = setInterval(() => this.tick(), this.TICK_MS);
+    }
+  }
+}
+
 // src/Board.ts
 class Board {
   boardId;
@@ -55641,6 +55816,25 @@ class Board {
   isGravityEnabled() {
     return this.gravity !== null;
   }
+  forceGraph = null;
+  enableForceGraph() {
+    if (this.forceGraph)
+      return;
+    this.forceGraph = new ForceGraphEngine(this);
+    this.forceGraph.start();
+  }
+  disableForceGraph() {
+    if (!this.forceGraph)
+      return;
+    this.forceGraph.stop();
+    this.forceGraph = null;
+  }
+  isForceGraphEnabled() {
+    return this.forceGraph !== null;
+  }
+  wakeForceGraph() {
+    this.forceGraph?.wake();
+  }
 }
 // src/Events/Merge.ts
 var import_slate36 = require("slate");

package/dist/cjs/index.js

@@ -4675,6 +4675,11 @@ var conf = {
   DEFAULT_GAME_ITEM_DIMENSIONS: { width: 200, height: 200 },
   MAX_CARD_SIZE: 500,
   CONNECTOR_ITEM_OFFSET: 20,
+  FG_SPRING_K: 3,
+  FG_TARGET_GAP: 60,
+  FG_REPULSION: 400000,
+  FG_DAMPING: 0.8,
+  FG_SLEEP_THRESHOLD: 0.5,
   GRAVITY_G: 80,
   GRAVITY_G_CENTER: 120,
   GRAVITY_DAMPING: 0.96,
@@ -54569,6 +54574,176 @@ class GravityEngine {
   }
 }
 
+// src/ForceGraph/ForceGraphEngine.ts
+var EXCLUDED_TYPES = new Set(["Connector", "Comment"]);
+
+class ForceGraphEngine {
+  board;
+  velocities = new Map;
+  tickTimer = null;
+  syncTimer = null;
+  lastSyncedPositions = new Map;
+  TICK_MS = 33;
+  SYNC_MS = 300;
+  SOFTENING_SQ = 100 * 100;
+  MIN_MOVE_PX = 0.05;
+  constructor(board) {
+    this.board = board;
+  }
+  start() {
+    if (this.tickTimer !== null)
+      return;
+    for (const item of this.getNodes()) {
+      const pos = item.transformation.getTranslation();
+      this.lastSyncedPositions.set(item.getId(), { x: pos.x, y: pos.y });
+      this.velocities.set(item.getId(), { vx: 0, vy: 0 });
+    }
+    this.tickTimer = setInterval(() => this.tick(), this.TICK_MS);
+    this.syncTimer = setInterval(() => this.syncPositions(), this.SYNC_MS);
+  }
+  stop() {
+    if (this.tickTimer !== null) {
+      clearInterval(this.tickTimer);
+      this.tickTimer = null;
+    }
+    if (this.syncTimer !== null) {
+      clearInterval(this.syncTimer);
+      this.syncTimer = null;
+    }
+    this.syncPositions();
+    this.velocities.clear();
+    this.lastSyncedPositions.clear();
+  }
+  getNodes() {
+    return this.board.items.listAll().filter((item) => !EXCLUDED_TYPES.has(item.itemType) && !item.transformation.isLocked);
+  }
+  getConnectors() {
+    return this.board.items.listAll().filter((item) => item.itemType === "Connector");
+  }
+  tick() {
+    const dt = this.TICK_MS / 1000;
+    const nodes = this.getNodes();
+    if (nodes.length < 2)
+      return;
+    const snapMap = new Map;
+    for (const item of nodes) {
+      const pos = item.transformation.getTranslation();
+      const mbr = item.getMbr();
+      const w = Math.max(mbr.getWidth(), 1);
+      const h2 = Math.max(mbr.getHeight(), 1);
+      snapMap.set(item.getId(), {
+        id: item.getId(),
+        cx: pos.x + w * 0.5,
+        cy: pos.y + h2 * 0.5,
+        w,
+        h: h2
+      });
+    }
+    const snap = Array.from(snapMap.values());
+    const ax = new Map;
+    const ay = new Map;
+    for (const s2 of snap) {
+      ax.set(s2.id, 0);
+      ay.set(s2.id, 0);
+    }
+    for (const connector of this.getConnectors()) {
+      const { startItem, endItem } = connector.getConnectedItems();
+      if (!startItem || !endItem)
+        continue;
+      const s1 = snapMap.get(startItem.getId());
+      const s2 = snapMap.get(endItem.getId());
+      if (!s1 || !s2)
+        continue;
+      const dx = s2.cx - s1.cx;
+      const dy = s2.cy - s1.cy;
+      const dist = Math.sqrt(dx * dx + dy * dy) + 0.001;
+      const targetDist = (Math.max(s1.w, s1.h) + Math.max(s2.w, s2.h)) * 0.5 + conf.FG_TARGET_GAP;
+      const stretch = dist - targetDist;
+      const forceMag = stretch * conf.FG_SPRING_K;
+      const fx = dx / dist * forceMag;
+      const fy = dy / dist * forceMag;
+      ax.set(s1.id, (ax.get(s1.id) ?? 0) + fx);
+      ay.set(s1.id, (ay.get(s1.id) ?? 0) + fy);
+      ax.set(s2.id, (ax.get(s2.id) ?? 0) - fx);
+      ay.set(s2.id, (ay.get(s2.id) ?? 0) - fy);
+    }
+    for (let i = 0;i < snap.length; i++) {
+      for (let j = i + 1;j < snap.length; j++) {
+        const s1 = snap[i];
+        const s2 = snap[j];
+        const dx = s2.cx - s1.cx;
+        const dy = s2.cy - s1.cy;
+        const distSq = dx * dx + dy * dy + this.SOFTENING_SQ;
+        const repMag = conf.FG_REPULSION / distSq;
+        const fx = dx * repMag;
+        const fy = dy * repMag;
+        ax.set(s1.id, (ax.get(s1.id) ?? 0) - fx);
+        ay.set(s1.id, (ay.get(s1.id) ?? 0) - fy);
+        ax.set(s2.id, (ax.get(s2.id) ?? 0) + fx);
+        ay.set(s2.id, (ay.get(s2.id) ?? 0) + fy);
+      }
+    }
+    let totalEnergy = 0;
+    for (const item of nodes) {
+      const id = item.getId();
+      if (!this.velocities.has(id)) {
+        this.velocities.set(id, { vx: 0, vy: 0 });
+      }
+      const vel = this.velocities.get(id);
+      vel.vx = (vel.vx + (ax.get(id) ?? 0) * dt) * conf.FG_DAMPING;
+      vel.vy = (vel.vy + (ay.get(id) ?? 0) * dt) * conf.FG_DAMPING;
+      totalEnergy += vel.vx * vel.vx + vel.vy * vel.vy;
+      const moveX = vel.vx * dt;
+      const moveY = vel.vy * dt;
+      if (Math.abs(moveX) >= this.MIN_MOVE_PX || Math.abs(moveY) >= this.MIN_MOVE_PX) {
+        item.transformation.applyMatrixSilent({
+          translateX: moveX,
+          translateY: moveY,
+          scaleX: 1,
+          scaleY: 1,
+          shearX: 0,
+          shearY: 0
+        });
+      }
+    }
+    if (totalEnergy < conf.FG_SLEEP_THRESHOLD && this.tickTimer !== null) {
+      clearInterval(this.tickTimer);
+      this.tickTimer = null;
+      this.syncPositions();
+    }
+  }
+  syncPositions() {
+    const nodes = this.getNodes();
+    if (nodes.length === 0)
+      return;
+    const movedItems = nodes.map((item) => {
+      const id = item.getId();
+      const pos = item.transformation.getTranslation();
+      const last = this.lastSyncedPositions.get(id);
+      const dx = last ? pos.x - last.x : 0;
+      const dy = last ? pos.y - last.y : 0;
+      this.lastSyncedPositions.set(id, { x: pos.x, y: pos.y });
+      return { id, dx, dy };
+    }).filter(({ dx, dy }) => Math.abs(dx) > 0.5 || Math.abs(dy) > 0.5);
+    if (movedItems.length === 0)
+      return;
+    const operation = {
+      class: "Transformation",
+      method: "applyMatrix",
+      items: movedItems.map(({ id, dx, dy }) => ({
+        id,
+        matrix: { translateX: dx, translateY: dy, scaleX: 1, scaleY: 1, shearX: 0, shearY: 0 }
+      }))
+    };
+    this.board.events.emit(operation);
+  }
+  wake() {
+    if (this.tickTimer === null && this.syncTimer !== null) {
+      this.tickTimer = setInterval(() => this.tick(), this.TICK_MS);
+    }
+  }
+}
+
 // src/Board.ts
 class Board {
   boardId;
@@ -55641,6 +55816,25 @@ class Board {
   isGravityEnabled() {
     return this.gravity !== null;
   }
+  forceGraph = null;
+  enableForceGraph() {
+    if (this.forceGraph)
+      return;
+    this.forceGraph = new ForceGraphEngine(this);
+    this.forceGraph.start();
+  }
+  disableForceGraph() {
+    if (!this.forceGraph)
+      return;
+    this.forceGraph.stop();
+    this.forceGraph = null;
+  }
+  isForceGraphEnabled() {
+    return this.forceGraph !== null;
+  }
+  wakeForceGraph() {
+    this.forceGraph?.wake();
+  }
 }
 // src/Events/Merge.ts
 var import_slate36 = require("slate");

package/dist/cjs/node.js

@@ -5712,6 +5712,11 @@ var conf = {
   DEFAULT_GAME_ITEM_DIMENSIONS: { width: 200, height: 200 },
   MAX_CARD_SIZE: 500,
   CONNECTOR_ITEM_OFFSET: 20,
+  FG_SPRING_K: 3,
+  FG_TARGET_GAP: 60,
+  FG_REPULSION: 400000,
+  FG_DAMPING: 0.8,
+  FG_SLEEP_THRESHOLD: 0.5,
   GRAVITY_G: 80,
   GRAVITY_G_CENTER: 120,
   GRAVITY_DAMPING: 0.96,
@@ -57042,6 +57047,176 @@ class GravityEngine {
   }
 }
 
+// src/ForceGraph/ForceGraphEngine.ts
+var EXCLUDED_TYPES = new Set(["Connector", "Comment"]);
+
+class ForceGraphEngine {
+  board;
+  velocities = new Map;
+  tickTimer = null;
+  syncTimer = null;
+  lastSyncedPositions = new Map;
+  TICK_MS = 33;
+  SYNC_MS = 300;
+  SOFTENING_SQ = 100 * 100;
+  MIN_MOVE_PX = 0.05;
+  constructor(board) {
+    this.board = board;
+  }
+  start() {
+    if (this.tickTimer !== null)
+      return;
+    for (const item of this.getNodes()) {
+      const pos = item.transformation.getTranslation();
+      this.lastSyncedPositions.set(item.getId(), { x: pos.x, y: pos.y });
+      this.velocities.set(item.getId(), { vx: 0, vy: 0 });
+    }
+    this.tickTimer = setInterval(() => this.tick(), this.TICK_MS);
+    this.syncTimer = setInterval(() => this.syncPositions(), this.SYNC_MS);
+  }
+  stop() {
+    if (this.tickTimer !== null) {
+      clearInterval(this.tickTimer);
+      this.tickTimer = null;
+    }
+    if (this.syncTimer !== null) {
+      clearInterval(this.syncTimer);
+      this.syncTimer = null;
+    }
+    this.syncPositions();
+    this.velocities.clear();
+    this.lastSyncedPositions.clear();
+  }
+  getNodes() {
+    return this.board.items.listAll().filter((item) => !EXCLUDED_TYPES.has(item.itemType) && !item.transformation.isLocked);
+  }
+  getConnectors() {
+    return this.board.items.listAll().filter((item) => item.itemType === "Connector");
+  }
+  tick() {
+    const dt = this.TICK_MS / 1000;
+    const nodes = this.getNodes();
+    if (nodes.length < 2)
+      return;
+    const snapMap = new Map;
+    for (const item of nodes) {
+      const pos = item.transformation.getTranslation();
+      const mbr = item.getMbr();
+      const w = Math.max(mbr.getWidth(), 1);
+      const h2 = Math.max(mbr.getHeight(), 1);
+      snapMap.set(item.getId(), {
+        id: item.getId(),
+        cx: pos.x + w * 0.5,
+        cy: pos.y + h2 * 0.5,
+        w,
+        h: h2
+      });
+    }
+    const snap = Array.from(snapMap.values());
+    const ax = new Map;
+    const ay = new Map;
+    for (const s2 of snap) {
+      ax.set(s2.id, 0);
+      ay.set(s2.id, 0);
+    }
+    for (const connector of this.getConnectors()) {
+      const { startItem, endItem } = connector.getConnectedItems();
+      if (!startItem || !endItem)
+        continue;
+      const s1 = snapMap.get(startItem.getId());
+      const s2 = snapMap.get(endItem.getId());
+      if (!s1 || !s2)
+        continue;
+      const dx = s2.cx - s1.cx;
+      const dy = s2.cy - s1.cy;
+      const dist = Math.sqrt(dx * dx + dy * dy) + 0.001;
+      const targetDist = (Math.max(s1.w, s1.h) + Math.max(s2.w, s2.h)) * 0.5 + conf.FG_TARGET_GAP;
+      const stretch = dist - targetDist;
+      const forceMag = stretch * conf.FG_SPRING_K;
+      const fx = dx / dist * forceMag;
+      const fy = dy / dist * forceMag;
+      ax.set(s1.id, (ax.get(s1.id) ?? 0) + fx);
+      ay.set(s1.id, (ay.get(s1.id) ?? 0) + fy);
+      ax.set(s2.id, (ax.get(s2.id) ?? 0) - fx);
+      ay.set(s2.id, (ay.get(s2.id) ?? 0) - fy);
+    }
+    for (let i = 0;i < snap.length; i++) {
+      for (let j = i + 1;j < snap.length; j++) {
+        const s1 = snap[i];
+        const s2 = snap[j];
+        const dx = s2.cx - s1.cx;
+        const dy = s2.cy - s1.cy;
+        const distSq = dx * dx + dy * dy + this.SOFTENING_SQ;
+        const repMag = conf.FG_REPULSION / distSq;
+        const fx = dx * repMag;
+        const fy = dy * repMag;
+        ax.set(s1.id, (ax.get(s1.id) ?? 0) - fx);
+        ay.set(s1.id, (ay.get(s1.id) ?? 0) - fy);
+        ax.set(s2.id, (ax.get(s2.id) ?? 0) + fx);
+        ay.set(s2.id, (ay.get(s2.id) ?? 0) + fy);
+      }
+    }
+    let totalEnergy = 0;
+    for (const item of nodes) {
+      const id = item.getId();
+      if (!this.velocities.has(id)) {
+        this.velocities.set(id, { vx: 0, vy: 0 });
+      }
+      const vel = this.velocities.get(id);
+      vel.vx = (vel.vx + (ax.get(id) ?? 0) * dt) * conf.FG_DAMPING;
+      vel.vy = (vel.vy + (ay.get(id) ?? 0) * dt) * conf.FG_DAMPING;
+      totalEnergy += vel.vx * vel.vx + vel.vy * vel.vy;
+      const moveX = vel.vx * dt;
+      const moveY = vel.vy * dt;
+      if (Math.abs(moveX) >= this.MIN_MOVE_PX || Math.abs(moveY) >= this.MIN_MOVE_PX) {
+        item.transformation.applyMatrixSilent({
+          translateX: moveX,
+          translateY: moveY,
+          scaleX: 1,
+          scaleY: 1,
+          shearX: 0,
+          shearY: 0
+        });
+      }
+    }
+    if (totalEnergy < conf.FG_SLEEP_THRESHOLD && this.tickTimer !== null) {
+      clearInterval(this.tickTimer);
+      this.tickTimer = null;
+      this.syncPositions();
+    }
+  }
+  syncPositions() {
+    const nodes = this.getNodes();
+    if (nodes.length === 0)
+      return;
+    const movedItems = nodes.map((item) => {
+      const id = item.getId();
+      const pos = item.transformation.getTranslation();
+      const last = this.lastSyncedPositions.get(id);
+      const dx = last ? pos.x - last.x : 0;
+      const dy = last ? pos.y - last.y : 0;
+      this.lastSyncedPositions.set(id, { x: pos.x, y: pos.y });
+      return { id, dx, dy };
+    }).filter(({ dx, dy }) => Math.abs(dx) > 0.5 || Math.abs(dy) > 0.5);
+    if (movedItems.length === 0)
+      return;
+    const operation = {
+      class: "Transformation",
+      method: "applyMatrix",
+      items: movedItems.map(({ id, dx, dy }) => ({
+        id,
+        matrix: { translateX: dx, translateY: dy, scaleX: 1, scaleY: 1, shearX: 0, shearY: 0 }
+      }))
+    };
+    this.board.events.emit(operation);
+  }
+  wake() {
+    if (this.tickTimer === null && this.syncTimer !== null) {
+      this.tickTimer = setInterval(() => this.tick(), this.TICK_MS);
+    }
+  }
+}
+
 // src/Board.ts
 class Board {
   boardId;
@@ -58114,6 +58289,25 @@ class Board {
   isGravityEnabled() {
     return this.gravity !== null;
   }
+  forceGraph = null;
+  enableForceGraph() {
+    if (this.forceGraph)
+      return;
+    this.forceGraph = new ForceGraphEngine(this);
+    this.forceGraph.start();
+  }
+  disableForceGraph() {
+    if (!this.forceGraph)
+      return;
+    this.forceGraph.stop();
+    this.forceGraph = null;
+  }
+  isForceGraphEnabled() {
+    return this.forceGraph !== null;
+  }
+  wakeForceGraph() {
+    this.forceGraph?.wake();
+  }
 }
 // src/Events/Merge.ts
 var import_slate35 = require("slate");

package/dist/esm/browser.js

@@ -4495,6 +4495,11 @@ var conf = {
   DEFAULT_GAME_ITEM_DIMENSIONS: { width: 200, height: 200 },
   MAX_CARD_SIZE: 500,
   CONNECTOR_ITEM_OFFSET: 20,
+  FG_SPRING_K: 3,
+  FG_TARGET_GAP: 60,
+  FG_REPULSION: 400000,
+  FG_DAMPING: 0.8,
+  FG_SLEEP_THRESHOLD: 0.5,
   GRAVITY_G: 80,
   GRAVITY_G_CENTER: 120,
   GRAVITY_DAMPING: 0.96,
@@ -54398,6 +54403,176 @@ class GravityEngine {
   }
 }
 
+// src/ForceGraph/ForceGraphEngine.ts
+var EXCLUDED_TYPES = new Set(["Connector", "Comment"]);
+
+class ForceGraphEngine {
+  board;
+  velocities = new Map;
+  tickTimer = null;
+  syncTimer = null;
+  lastSyncedPositions = new Map;
+  TICK_MS = 33;
+  SYNC_MS = 300;
+  SOFTENING_SQ = 100 * 100;
+  MIN_MOVE_PX = 0.05;
+  constructor(board) {
+    this.board = board;
+  }
+  start() {
+    if (this.tickTimer !== null)
+      return;
+    for (const item of this.getNodes()) {
+      const pos = item.transformation.getTranslation();
+      this.lastSyncedPositions.set(item.getId(), { x: pos.x, y: pos.y });
+      this.velocities.set(item.getId(), { vx: 0, vy: 0 });
+    }
+    this.tickTimer = setInterval(() => this.tick(), this.TICK_MS);
+    this.syncTimer = setInterval(() => this.syncPositions(), this.SYNC_MS);
+  }
+  stop() {
+    if (this.tickTimer !== null) {
+      clearInterval(this.tickTimer);
+      this.tickTimer = null;
+    }
+    if (this.syncTimer !== null) {
+      clearInterval(this.syncTimer);
+      this.syncTimer = null;
+    }
+    this.syncPositions();
+    this.velocities.clear();
+    this.lastSyncedPositions.clear();
+  }
+  getNodes() {
+    return this.board.items.listAll().filter((item) => !EXCLUDED_TYPES.has(item.itemType) && !item.transformation.isLocked);
+  }
+  getConnectors() {
+    return this.board.items.listAll().filter((item) => item.itemType === "Connector");
+  }
+  tick() {
+    const dt = this.TICK_MS / 1000;
+    const nodes = this.getNodes();
+    if (nodes.length < 2)
+      return;
+    const snapMap = new Map;
+    for (const item of nodes) {
+      const pos = item.transformation.getTranslation();
+      const mbr = item.getMbr();
+      const w = Math.max(mbr.getWidth(), 1);
+      const h2 = Math.max(mbr.getHeight(), 1);
+      snapMap.set(item.getId(), {
+        id: item.getId(),
+        cx: pos.x + w * 0.5,
+        cy: pos.y + h2 * 0.5,
+        w,
+        h: h2
+      });
+    }
+    const snap = Array.from(snapMap.values());
+    const ax = new Map;
+    const ay = new Map;
+    for (const s2 of snap) {
+      ax.set(s2.id, 0);
+      ay.set(s2.id, 0);
+    }
+    for (const connector of this.getConnectors()) {
+      const { startItem, endItem } = connector.getConnectedItems();
+      if (!startItem || !endItem)
+        continue;
+      const s1 = snapMap.get(startItem.getId());
+      const s2 = snapMap.get(endItem.getId());
+      if (!s1 || !s2)
+        continue;
+      const dx = s2.cx - s1.cx;
+      const dy = s2.cy - s1.cy;
+      const dist = Math.sqrt(dx * dx + dy * dy) + 0.001;
+      const targetDist = (Math.max(s1.w, s1.h) + Math.max(s2.w, s2.h)) * 0.5 + conf.FG_TARGET_GAP;
+      const stretch = dist - targetDist;
+      const forceMag = stretch * conf.FG_SPRING_K;
+      const fx = dx / dist * forceMag;
+      const fy = dy / dist * forceMag;
+      ax.set(s1.id, (ax.get(s1.id) ?? 0) + fx);
+      ay.set(s1.id, (ay.get(s1.id) ?? 0) + fy);
+      ax.set(s2.id, (ax.get(s2.id) ?? 0) - fx);
+      ay.set(s2.id, (ay.get(s2.id) ?? 0) - fy);
+    }
+    for (let i = 0;i < snap.length; i++) {
+      for (let j = i + 1;j < snap.length; j++) {
+        const s1 = snap[i];
+        const s2 = snap[j];
+        const dx = s2.cx - s1.cx;
+        const dy = s2.cy - s1.cy;
+        const distSq = dx * dx + dy * dy + this.SOFTENING_SQ;
+        const repMag = conf.FG_REPULSION / distSq;
+        const fx = dx * repMag;
+        const fy = dy * repMag;
+        ax.set(s1.id, (ax.get(s1.id) ?? 0) - fx);
+        ay.set(s1.id, (ay.get(s1.id) ?? 0) - fy);
+        ax.set(s2.id, (ax.get(s2.id) ?? 0) + fx);
+        ay.set(s2.id, (ay.get(s2.id) ?? 0) + fy);
+      }
+    }
+    let totalEnergy = 0;
+    for (const item of nodes) {
+      const id = item.getId();
+      if (!this.velocities.has(id)) {
+        this.velocities.set(id, { vx: 0, vy: 0 });
+      }
+      const vel = this.velocities.get(id);
+      vel.vx = (vel.vx + (ax.get(id) ?? 0) * dt) * conf.FG_DAMPING;
+      vel.vy = (vel.vy + (ay.get(id) ?? 0) * dt) * conf.FG_DAMPING;
+      totalEnergy += vel.vx * vel.vx + vel.vy * vel.vy;
+      const moveX = vel.vx * dt;
+      const moveY = vel.vy * dt;
+      if (Math.abs(moveX) >= this.MIN_MOVE_PX || Math.abs(moveY) >= this.MIN_MOVE_PX) {
+        item.transformation.applyMatrixSilent({
+          translateX: moveX,
+          translateY: moveY,
+          scaleX: 1,
+          scaleY: 1,
+          shearX: 0,
+          shearY: 0
+        });
+      }
+    }
+    if (totalEnergy < conf.FG_SLEEP_THRESHOLD && this.tickTimer !== null) {
+      clearInterval(this.tickTimer);
+      this.tickTimer = null;
+      this.syncPositions();
+    }
+  }
+  syncPositions() {
+    const nodes = this.getNodes();
+    if (nodes.length === 0)
+      return;
+    const movedItems = nodes.map((item) => {
+      const id = item.getId();
+      const pos = item.transformation.getTranslation();
+      const last = this.lastSyncedPositions.get(id);
+      const dx = last ? pos.x - last.x : 0;
+      const dy = last ? pos.y - last.y : 0;
+      this.lastSyncedPositions.set(id, { x: pos.x, y: pos.y });
+      return { id, dx, dy };
+    }).filter(({ dx, dy }) => Math.abs(dx) > 0.5 || Math.abs(dy) > 0.5);
+    if (movedItems.length === 0)
+      return;
+    const operation = {
+      class: "Transformation",
+      method: "applyMatrix",
+      items: movedItems.map(({ id, dx, dy }) => ({
+        id,
+        matrix: { translateX: dx, translateY: dy, scaleX: 1, scaleY: 1, shearX: 0, shearY: 0 }
+      }))
+    };
+    this.board.events.emit(operation);
+  }
+  wake() {
+    if (this.tickTimer === null && this.syncTimer !== null) {
+      this.tickTimer = setInterval(() => this.tick(), this.TICK_MS);
+    }
+  }
+}
+
 // src/Board.ts
 class Board {
   boardId;
@@ -55470,6 +55645,25 @@ class Board {
   isGravityEnabled() {
     return this.gravity !== null;
   }
+  forceGraph = null;
+  enableForceGraph() {
+    if (this.forceGraph)
+      return;
+    this.forceGraph = new ForceGraphEngine(this);
+    this.forceGraph.start();
+  }
+  disableForceGraph() {
+    if (!this.forceGraph)
+      return;
+    this.forceGraph.stop();
+    this.forceGraph = null;
+  }
+  isForceGraphEnabled() {
+    return this.forceGraph !== null;
+  }
+  wakeForceGraph() {
+    this.forceGraph?.wake();
+  }
 }
 // src/Events/Merge.ts
 import { Path as Path15 } from "slate";

package/dist/esm/index.js

@@ -4488,6 +4488,11 @@ var conf = {
   DEFAULT_GAME_ITEM_DIMENSIONS: { width: 200, height: 200 },
   MAX_CARD_SIZE: 500,
   CONNECTOR_ITEM_OFFSET: 20,
+  FG_SPRING_K: 3,
+  FG_TARGET_GAP: 60,
+  FG_REPULSION: 400000,
+  FG_DAMPING: 0.8,
+  FG_SLEEP_THRESHOLD: 0.5,
   GRAVITY_G: 80,
   GRAVITY_G_CENTER: 120,
   GRAVITY_DAMPING: 0.96,
@@ -54391,6 +54396,176 @@ class GravityEngine {
   }
 }
 
+// src/ForceGraph/ForceGraphEngine.ts
+var EXCLUDED_TYPES = new Set(["Connector", "Comment"]);
+
+class ForceGraphEngine {
+  board;
+  velocities = new Map;
+  tickTimer = null;
+  syncTimer = null;
+  lastSyncedPositions = new Map;
+  TICK_MS = 33;
+  SYNC_MS = 300;
+  SOFTENING_SQ = 100 * 100;
+  MIN_MOVE_PX = 0.05;
+  constructor(board) {
+    this.board = board;
+  }
+  start() {
+    if (this.tickTimer !== null)
+      return;
+    for (const item of this.getNodes()) {
+      const pos = item.transformation.getTranslation();
+      this.lastSyncedPositions.set(item.getId(), { x: pos.x, y: pos.y });
+      this.velocities.set(item.getId(), { vx: 0, vy: 0 });
+    }
+    this.tickTimer = setInterval(() => this.tick(), this.TICK_MS);
+    this.syncTimer = setInterval(() => this.syncPositions(), this.SYNC_MS);
+  }
+  stop() {
+    if (this.tickTimer !== null) {
+      clearInterval(this.tickTimer);
+      this.tickTimer = null;
+    }
+    if (this.syncTimer !== null) {
+      clearInterval(this.syncTimer);
+      this.syncTimer = null;
+    }
+    this.syncPositions();
+    this.velocities.clear();
+    this.lastSyncedPositions.clear();
+  }
+  getNodes() {
+    return this.board.items.listAll().filter((item) => !EXCLUDED_TYPES.has(item.itemType) && !item.transformation.isLocked);
+  }
+  getConnectors() {
+    return this.board.items.listAll().filter((item) => item.itemType === "Connector");
+  }
+  tick() {
+    const dt = this.TICK_MS / 1000;
+    const nodes = this.getNodes();
+    if (nodes.length < 2)
+      return;
+    const snapMap = new Map;
+    for (const item of nodes) {
+      const pos = item.transformation.getTranslation();
+      const mbr = item.getMbr();
+      const w = Math.max(mbr.getWidth(), 1);
+      const h2 = Math.max(mbr.getHeight(), 1);
+      snapMap.set(item.getId(), {
+        id: item.getId(),
+        cx: pos.x + w * 0.5,
+        cy: pos.y + h2 * 0.5,
+        w,
+        h: h2
+      });
+    }
+    const snap = Array.from(snapMap.values());
+    const ax = new Map;
+    const ay = new Map;
+    for (const s2 of snap) {
+      ax.set(s2.id, 0);
+      ay.set(s2.id, 0);
+    }
+    for (const connector of this.getConnectors()) {
+      const { startItem, endItem } = connector.getConnectedItems();
+      if (!startItem || !endItem)
+        continue;
+      const s1 = snapMap.get(startItem.getId());
+      const s2 = snapMap.get(endItem.getId());
+      if (!s1 || !s2)
+        continue;
+      const dx = s2.cx - s1.cx;
+      const dy = s2.cy - s1.cy;
+      const dist = Math.sqrt(dx * dx + dy * dy) + 0.001;
+      const targetDist = (Math.max(s1.w, s1.h) + Math.max(s2.w, s2.h)) * 0.5 + conf.FG_TARGET_GAP;
+      const stretch = dist - targetDist;
+      const forceMag = stretch * conf.FG_SPRING_K;
+      const fx = dx / dist * forceMag;
+      const fy = dy / dist * forceMag;
+      ax.set(s1.id, (ax.get(s1.id) ?? 0) + fx);
+      ay.set(s1.id, (ay.get(s1.id) ?? 0) + fy);
+      ax.set(s2.id, (ax.get(s2.id) ?? 0) - fx);
+      ay.set(s2.id, (ay.get(s2.id) ?? 0) - fy);
+    }
+    for (let i = 0;i < snap.length; i++) {
+      for (let j = i + 1;j < snap.length; j++) {
+        const s1 = snap[i];
+        const s2 = snap[j];
+        const dx = s2.cx - s1.cx;
+        const dy = s2.cy - s1.cy;
+        const distSq = dx * dx + dy * dy + this.SOFTENING_SQ;
+        const repMag = conf.FG_REPULSION / distSq;
+        const fx = dx * repMag;
+        const fy = dy * repMag;
+        ax.set(s1.id, (ax.get(s1.id) ?? 0) - fx);
+        ay.set(s1.id, (ay.get(s1.id) ?? 0) - fy);
+        ax.set(s2.id, (ax.get(s2.id) ?? 0) + fx);
+        ay.set(s2.id, (ay.get(s2.id) ?? 0) + fy);
+      }
+    }
+    let totalEnergy = 0;
+    for (const item of nodes) {
+      const id = item.getId();
+      if (!this.velocities.has(id)) {
+        this.velocities.set(id, { vx: 0, vy: 0 });
+      }
+      const vel = this.velocities.get(id);
+      vel.vx = (vel.vx + (ax.get(id) ?? 0) * dt) * conf.FG_DAMPING;
+      vel.vy = (vel.vy + (ay.get(id) ?? 0) * dt) * conf.FG_DAMPING;
+      totalEnergy += vel.vx * vel.vx + vel.vy * vel.vy;
+      const moveX = vel.vx * dt;
+      const moveY = vel.vy * dt;
+      if (Math.abs(moveX) >= this.MIN_MOVE_PX || Math.abs(moveY) >= this.MIN_MOVE_PX) {
+        item.transformation.applyMatrixSilent({
+          translateX: moveX,
+          translateY: moveY,
+          scaleX: 1,
+          scaleY: 1,
+          shearX: 0,
+          shearY: 0
+        });
+      }
+    }
+    if (totalEnergy < conf.FG_SLEEP_THRESHOLD && this.tickTimer !== null) {
+      clearInterval(this.tickTimer);
+      this.tickTimer = null;
+      this.syncPositions();
+    }
+  }
+  syncPositions() {
+    const nodes = this.getNodes();
+    if (nodes.length === 0)
+      return;
+    const movedItems = nodes.map((item) => {
+      const id = item.getId();
+      const pos = item.transformation.getTranslation();
+      const last = this.lastSyncedPositions.get(id);
+      const dx = last ? pos.x - last.x : 0;
+      const dy = last ? pos.y - last.y : 0;
+      this.lastSyncedPositions.set(id, { x: pos.x, y: pos.y });
+      return { id, dx, dy };
+    }).filter(({ dx, dy }) => Math.abs(dx) > 0.5 || Math.abs(dy) > 0.5);
+    if (movedItems.length === 0)
+      return;
+    const operation = {
+      class: "Transformation",
+      method: "applyMatrix",
+      items: movedItems.map(({ id, dx, dy }) => ({
+        id,
+        matrix: { translateX: dx, translateY: dy, scaleX: 1, scaleY: 1, shearX: 0, shearY: 0 }
+      }))
+    };
+    this.board.events.emit(operation);
+  }
+  wake() {
+    if (this.tickTimer === null && this.syncTimer !== null) {
+      this.tickTimer = setInterval(() => this.tick(), this.TICK_MS);
+    }
+  }
+}
+
 // src/Board.ts
 class Board {
   boardId;
@@ -55463,6 +55638,25 @@ class Board {
   isGravityEnabled() {
     return this.gravity !== null;
   }
+  forceGraph = null;
+  enableForceGraph() {
+    if (this.forceGraph)
+      return;
+    this.forceGraph = new ForceGraphEngine(this);
+    this.forceGraph.start();
+  }
+  disableForceGraph() {
+    if (!this.forceGraph)
+      return;
+    this.forceGraph.stop();
+    this.forceGraph = null;
+  }
+  isForceGraphEnabled() {
+    return this.forceGraph !== null;
+  }
+  wakeForceGraph() {
+    this.forceGraph?.wake();
+  }
 }
 // src/Events/Merge.ts
 import { Path as Path15 } from "slate";

package/dist/esm/node.js

@@ -5272,6 +5272,11 @@ var conf = {
   DEFAULT_GAME_ITEM_DIMENSIONS: { width: 200, height: 200 },
   MAX_CARD_SIZE: 500,
   CONNECTOR_ITEM_OFFSET: 20,
+  FG_SPRING_K: 3,
+  FG_TARGET_GAP: 60,
+  FG_REPULSION: 400000,
+  FG_DAMPING: 0.8,
+  FG_SLEEP_THRESHOLD: 0.5,
   GRAVITY_G: 80,
   GRAVITY_G_CENTER: 120,
   GRAVITY_DAMPING: 0.96,
@@ -56859,6 +56864,176 @@ class GravityEngine {
   }
 }
 
+// src/ForceGraph/ForceGraphEngine.ts
+var EXCLUDED_TYPES = new Set(["Connector", "Comment"]);
+
+class ForceGraphEngine {
+  board;
+  velocities = new Map;
+  tickTimer = null;
+  syncTimer = null;
+  lastSyncedPositions = new Map;
+  TICK_MS = 33;
+  SYNC_MS = 300;
+  SOFTENING_SQ = 100 * 100;
+  MIN_MOVE_PX = 0.05;
+  constructor(board) {
+    this.board = board;
+  }
+  start() {
+    if (this.tickTimer !== null)
+      return;
+    for (const item of this.getNodes()) {
+      const pos = item.transformation.getTranslation();
+      this.lastSyncedPositions.set(item.getId(), { x: pos.x, y: pos.y });
+      this.velocities.set(item.getId(), { vx: 0, vy: 0 });
+    }
+    this.tickTimer = setInterval(() => this.tick(), this.TICK_MS);
+    this.syncTimer = setInterval(() => this.syncPositions(), this.SYNC_MS);
+  }
+  stop() {
+    if (this.tickTimer !== null) {
+      clearInterval(this.tickTimer);
+      this.tickTimer = null;
+    }
+    if (this.syncTimer !== null) {
+      clearInterval(this.syncTimer);
+      this.syncTimer = null;
+    }
+    this.syncPositions();
+    this.velocities.clear();
+    this.lastSyncedPositions.clear();
+  }
+  getNodes() {
+    return this.board.items.listAll().filter((item) => !EXCLUDED_TYPES.has(item.itemType) && !item.transformation.isLocked);
+  }
+  getConnectors() {
+    return this.board.items.listAll().filter((item) => item.itemType === "Connector");
+  }
+  tick() {
+    const dt = this.TICK_MS / 1000;
+    const nodes = this.getNodes();
+    if (nodes.length < 2)
+      return;
+    const snapMap = new Map;
+    for (const item of nodes) {
+      const pos = item.transformation.getTranslation();
+      const mbr = item.getMbr();
+      const w = Math.max(mbr.getWidth(), 1);
+      const h2 = Math.max(mbr.getHeight(), 1);
+      snapMap.set(item.getId(), {
+        id: item.getId(),
+        cx: pos.x + w * 0.5,
+        cy: pos.y + h2 * 0.5,
+        w,
+        h: h2
+      });
+    }
+    const snap = Array.from(snapMap.values());
+    const ax = new Map;
+    const ay = new Map;
+    for (const s2 of snap) {
+      ax.set(s2.id, 0);
+      ay.set(s2.id, 0);
+    }
+    for (const connector of this.getConnectors()) {
+      const { startItem, endItem } = connector.getConnectedItems();
+      if (!startItem || !endItem)
+        continue;
+      const s1 = snapMap.get(startItem.getId());
+      const s2 = snapMap.get(endItem.getId());
+      if (!s1 || !s2)
+        continue;
+      const dx = s2.cx - s1.cx;
+      const dy = s2.cy - s1.cy;
+      const dist = Math.sqrt(dx * dx + dy * dy) + 0.001;
+      const targetDist = (Math.max(s1.w, s1.h) + Math.max(s2.w, s2.h)) * 0.5 + conf.FG_TARGET_GAP;
+      const stretch = dist - targetDist;
+      const forceMag = stretch * conf.FG_SPRING_K;
+      const fx = dx / dist * forceMag;
+      const fy = dy / dist * forceMag;
+      ax.set(s1.id, (ax.get(s1.id) ?? 0) + fx);
+      ay.set(s1.id, (ay.get(s1.id) ?? 0) + fy);
+      ax.set(s2.id, (ax.get(s2.id) ?? 0) - fx);
+      ay.set(s2.id, (ay.get(s2.id) ?? 0) - fy);
+    }
+    for (let i = 0;i < snap.length; i++) {
+      for (let j = i + 1;j < snap.length; j++) {
+        const s1 = snap[i];
+        const s2 = snap[j];
+        const dx = s2.cx - s1.cx;
+        const dy = s2.cy - s1.cy;
+        const distSq = dx * dx + dy * dy + this.SOFTENING_SQ;
+        const repMag = conf.FG_REPULSION / distSq;
+        const fx = dx * repMag;
+        const fy = dy * repMag;
+        ax.set(s1.id, (ax.get(s1.id) ?? 0) - fx);
+        ay.set(s1.id, (ay.get(s1.id) ?? 0) - fy);
+        ax.set(s2.id, (ax.get(s2.id) ?? 0) + fx);
+        ay.set(s2.id, (ay.get(s2.id) ?? 0) + fy);
+      }
+    }
+    let totalEnergy = 0;
+    for (const item of nodes) {
+      const id = item.getId();
+      if (!this.velocities.has(id)) {
+        this.velocities.set(id, { vx: 0, vy: 0 });
+      }
+      const vel = this.velocities.get(id);
+      vel.vx = (vel.vx + (ax.get(id) ?? 0) * dt) * conf.FG_DAMPING;
+      vel.vy = (vel.vy + (ay.get(id) ?? 0) * dt) * conf.FG_DAMPING;
+      totalEnergy += vel.vx * vel.vx + vel.vy * vel.vy;
+      const moveX = vel.vx * dt;
+      const moveY = vel.vy * dt;
+      if (Math.abs(moveX) >= this.MIN_MOVE_PX || Math.abs(moveY) >= this.MIN_MOVE_PX) {
+        item.transformation.applyMatrixSilent({
+          translateX: moveX,
+          translateY: moveY,
+          scaleX: 1,
+          scaleY: 1,
+          shearX: 0,
+          shearY: 0
+        });
+      }
+    }
+    if (totalEnergy < conf.FG_SLEEP_THRESHOLD && this.tickTimer !== null) {
+      clearInterval(this.tickTimer);
+      this.tickTimer = null;
+      this.syncPositions();
+    }
+  }
+  syncPositions() {
+    const nodes = this.getNodes();
+    if (nodes.length === 0)
+      return;
+    const movedItems = nodes.map((item) => {
+      const id = item.getId();
+      const pos = item.transformation.getTranslation();
+      const last = this.lastSyncedPositions.get(id);
+      const dx = last ? pos.x - last.x : 0;
+      const dy = last ? pos.y - last.y : 0;
+      this.lastSyncedPositions.set(id, { x: pos.x, y: pos.y });
+      return { id, dx, dy };
+    }).filter(({ dx, dy }) => Math.abs(dx) > 0.5 || Math.abs(dy) > 0.5);
+    if (movedItems.length === 0)
+      return;
+    const operation = {
+      class: "Transformation",
+      method: "applyMatrix",
+      items: movedItems.map(({ id, dx, dy }) => ({
+        id,
+        matrix: { translateX: dx, translateY: dy, scaleX: 1, scaleY: 1, shearX: 0, shearY: 0 }
+      }))
+    };
+    this.board.events.emit(operation);
+  }
+  wake() {
+    if (this.tickTimer === null && this.syncTimer !== null) {
+      this.tickTimer = setInterval(() => this.tick(), this.TICK_MS);
+    }
+  }
+}
+
 // src/Board.ts
 class Board {
   boardId;
@@ -57931,6 +58106,25 @@ class Board {
   isGravityEnabled() {
     return this.gravity !== null;
   }
+  forceGraph = null;
+  enableForceGraph() {
+    if (this.forceGraph)
+      return;
+    this.forceGraph = new ForceGraphEngine(this);
+    this.forceGraph.start();
+  }
+  disableForceGraph() {
+    if (!this.forceGraph)
+      return;
+    this.forceGraph.stop();
+    this.forceGraph = null;
+  }
+  isForceGraphEnabled() {
+    return this.forceGraph !== null;
+  }
+  wakeForceGraph() {
+    this.forceGraph?.wake();
+  }
 }
 // src/Events/Merge.ts
 import { Path as Path14 } from "slate";

package/dist/types/Board.d.ts

@@ -139,6 +139,12 @@ export declare class Board {
     enableGravity(): void;
     disableGravity(): void;
     isGravityEnabled(): boolean;
+    private forceGraph;
+    enableForceGraph(): void;
+    disableForceGraph(): void;
+    isForceGraphEnabled(): boolean;
+    /** Call after dragging a node to re-wake the physics engine if it was sleeping. */
+    wakeForceGraph(): void;
 }
 export interface BoardSnapshot {
     items: (ItemData & {

package/dist/types/ForceGraph/ForceGraphEngine.d.ts

@@ -0,0 +1,21 @@
+import { Board } from '../Board';
+export declare class ForceGraphEngine {
+    private board;
+    private velocities;
+    private tickTimer;
+    private syncTimer;
+    private lastSyncedPositions;
+    private readonly TICK_MS;
+    private readonly SYNC_MS;
+    private readonly SOFTENING_SQ;
+    private readonly MIN_MOVE_PX;
+    constructor(board: Board);
+    start(): void;
+    stop(): void;
+    private getNodes;
+    private getConnectors;
+    private tick;
+    private syncPositions;
+    /** Re-wake the engine after user moves a node (dragging disturbs equilibrium). */
+    wake(): void;
+}

package/dist/types/Settings.d.ts

@@ -247,6 +247,11 @@ export declare const conf: {
     };
     MAX_CARD_SIZE: number;
     CONNECTOR_ITEM_OFFSET: number;
+    FG_SPRING_K: number;
+    FG_TARGET_GAP: number;
+    FG_REPULSION: number;
+    FG_DAMPING: number;
+    FG_SLEEP_THRESHOLD: number;
     GRAVITY_G: number;
     GRAVITY_G_CENTER: number;
     GRAVITY_DAMPING: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "microboard-temp",
-  "version": "0.13.15",
+  "version": "0.13.16",
   "description": "A flexible interactive whiteboard library",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",