@fieldnotes/core 0.55.0 → 0.56.0

package/dist/index.cjs

@@ -39,6 +39,7 @@ __export(index_exports, {
   NoteTool: () => NoteTool,
   PING_PRESENCE_KIND: () => PING_PRESENCE_KIND,
   PencilTool: () => PencilTool,
+  PingInput: () => PingInput,
   PingTool: () => PingTool,
   RemoteLaserOverlay: () => RemoteLaserOverlay,
   RemotePingOverlay: () => RemotePingOverlay,
@@ -8941,6 +8942,191 @@ var RemotePingOverlay = class {
   }
 };
 
+// src/canvas/ping-input.ts
+var DEFAULT_LONG_PRESS_MS = 600;
+var DEFAULT_SLOP_PX = 8;
+var DEFAULT_COLOR3 = "#ff3b30";
+var DEFAULT_DURATION_MS2 = 1800;
+var DEFAULT_RADIUS2 = 48;
+var DEFAULT_MIN_INTERVAL_MS = 300;
+var PingInput = class {
+  element;
+  host;
+  longPressEnabled;
+  longPressMs;
+  slopPx;
+  color;
+  durationMs;
+  radius;
+  minIntervalMs;
+  shouldPing;
+  press = null;
+  downPointers = /* @__PURE__ */ new Set();
+  lastPointerScreen = null;
+  lastEmitAt = -Infinity;
+  disposed = false;
+  optionListeners = /* @__PURE__ */ new Set();
+  pingListeners = /* @__PURE__ */ new Set();
+  handlePointerDown = (e) => this.onPointerDown(e);
+  handlePointerMove = (e) => this.onPointerMove(e);
+  handlePointerUp = (e) => this.onPointerEnd(e);
+  handlePointerCancel = (e) => this.onPointerEnd(e);
+  handlePointerLeave = (e) => this.onPointerEnd(e);
+  constructor(element, host, options = {}) {
+    this.element = element;
+    this.host = host;
+    this.longPressEnabled = options.longPressEnabled ?? false;
+    this.longPressMs = options.longPressMs ?? DEFAULT_LONG_PRESS_MS;
+    this.slopPx = options.slopPx ?? DEFAULT_SLOP_PX;
+    this.color = options.color ?? DEFAULT_COLOR3;
+    this.durationMs = options.durationMs ?? DEFAULT_DURATION_MS2;
+    this.radius = options.radius ?? DEFAULT_RADIUS2;
+    this.minIntervalMs = options.minIntervalMs ?? DEFAULT_MIN_INTERVAL_MS;
+    this.shouldPing = options.shouldPing;
+    const opts = { passive: true };
+    element.addEventListener("pointerdown", this.handlePointerDown, opts);
+    element.addEventListener("pointermove", this.handlePointerMove, opts);
+    element.addEventListener("pointerup", this.handlePointerUp, opts);
+    element.addEventListener("pointercancel", this.handlePointerCancel, opts);
+    element.addEventListener("pointerleave", this.handlePointerLeave, opts);
+  }
+  now() {
+    return performance.now();
+  }
+  getOptions() {
+    return {
+      longPressEnabled: this.longPressEnabled,
+      longPressMs: this.longPressMs,
+      slopPx: this.slopPx,
+      color: this.color,
+      durationMs: this.durationMs,
+      radius: this.radius,
+      minIntervalMs: this.minIntervalMs,
+      ...this.shouldPing ? { shouldPing: this.shouldPing } : {}
+    };
+  }
+  setOptions(options) {
+    if (options.longPressEnabled !== void 0) {
+      this.longPressEnabled = options.longPressEnabled;
+      if (!this.longPressEnabled) this.cancelPress();
+    }
+    if (options.longPressMs !== void 0) this.longPressMs = options.longPressMs;
+    if (options.slopPx !== void 0) this.slopPx = options.slopPx;
+    if (options.color !== void 0) this.color = options.color;
+    if (options.durationMs !== void 0) this.durationMs = options.durationMs;
+    if (options.radius !== void 0) this.radius = options.radius;
+    if (options.minIntervalMs !== void 0) this.minIntervalMs = options.minIntervalMs;
+    if (options.shouldPing !== void 0) this.shouldPing = options.shouldPing;
+    for (const listener of this.optionListeners) listener();
+  }
+  onOptionsChange(listener) {
+    this.optionListeners.add(listener);
+    return () => this.optionListeners.delete(listener);
+  }
+  /**
+   * Subscribes to emitted pings. Listeners must not throw; a throwing
+   * listener is isolated so it cannot break input handling or other
+   * listeners.
+   */
+  onPing(listener) {
+    this.pingListeners.add(listener);
+    return () => this.pingListeners.delete(listener);
+  }
+  /**
+   * Pings at the last tracked pointer position (hover moves and presses),
+   * world-converted at call time. Returns `false` when no pointer has been
+   * seen yet, the host vetoes, or the rate limit drops the ping.
+   */
+  pingAtPointer() {
+    if (this.disposed || this.lastPointerScreen === null) return false;
+    return this.emit(this.host.screenToWorld(this.lastPointerScreen));
+  }
+  /** Pings a world position directly. Same veto and rate limit as every path. */
+  pingAt(world) {
+    if (this.disposed) return false;
+    return this.emit(world);
+  }
+  /** Removes all DOM listeners and cancels any pending press. Idempotent. */
+  dispose() {
+    if (this.disposed) return;
+    this.disposed = true;
+    this.cancelPress();
+    this.downPointers.clear();
+    this.element.removeEventListener("pointerdown", this.handlePointerDown);
+    this.element.removeEventListener("pointermove", this.handlePointerMove);
+    this.element.removeEventListener("pointerup", this.handlePointerUp);
+    this.element.removeEventListener("pointercancel", this.handlePointerCancel);
+    this.element.removeEventListener("pointerleave", this.handlePointerLeave);
+    this.optionListeners.clear();
+    this.pingListeners.clear();
+  }
+  toLocal(e) {
+    const rect = this.element.getBoundingClientRect();
+    return { x: e.clientX - rect.left, y: e.clientY - rect.top };
+  }
+  onPointerDown(e) {
+    const local = this.toLocal(e);
+    this.lastPointerScreen = local;
+    const hadPointers = this.downPointers.size > 0;
+    this.downPointers.add(e.pointerId);
+    if (hadPointers) {
+      this.cancelPress();
+      return;
+    }
+    if (!this.longPressEnabled) return;
+    if (e.pointerType === "mouse" && e.button !== 0) return;
+    this.press = {
+      pointerId: e.pointerId,
+      x: local.x,
+      y: local.y,
+      timer: setTimeout(() => this.firePress(), this.longPressMs)
+    };
+  }
+  onPointerMove(e) {
+    const local = this.toLocal(e);
+    this.lastPointerScreen = local;
+    if (this.press === null || e.pointerId !== this.press.pointerId) return;
+    const dx = local.x - this.press.x;
+    const dy = local.y - this.press.y;
+    if (Math.hypot(dx, dy) > this.slopPx) this.cancelPress();
+  }
+  onPointerEnd(e) {
+    this.downPointers.delete(e.pointerId);
+    if (this.press !== null && e.pointerId === this.press.pointerId) this.cancelPress();
+  }
+  cancelPress() {
+    if (this.press === null) return;
+    clearTimeout(this.press.timer);
+    this.press = null;
+  }
+  firePress() {
+    if (this.press === null) return;
+    const screen = { x: this.press.x, y: this.press.y };
+    this.press = null;
+    this.emit(this.host.screenToWorld(screen));
+  }
+  emit(world) {
+    if (this.shouldPing && !this.shouldPing()) return false;
+    const t = this.now();
+    if (t - this.lastEmitAt < this.minIntervalMs) return false;
+    this.lastEmitAt = t;
+    const emission = {
+      x: world.x,
+      y: world.y,
+      color: this.color,
+      durationMs: this.durationMs,
+      radius: this.radius
+    };
+    for (const listener of this.pingListeners) {
+      try {
+        listener(emission);
+      } catch {
+      }
+    }
+    return true;
+  }
+};
+
 // src/tools/hand-tool.ts
 var HandTool = class {
   name = "hand";
@@ -9202,7 +9388,7 @@ function erasePoints(points, eraser, radius) {
 }
 
 // src/tools/eraser-tool.ts
-var DEFAULT_RADIUS2 = 20;
+var DEFAULT_RADIUS3 = 20;
 function makeEraserCursor(radius) {
   const size = radius * 2;
   const svg = `<svg xmlns='http://www.w3.org/2000/svg' width='${size}' height='${size}'><circle cx='${radius}' cy='${radius}' r='${radius - 1}' fill='none' stroke='%23666' stroke-width='1.5'/></svg>`;
@@ -9215,7 +9401,7 @@ var EraserTool = class {
   cursor;
   mode;
   constructor(options = {}) {
-    this.radius = options.radius ?? DEFAULT_RADIUS2;
+    this.radius = options.radius ?? DEFAULT_RADIUS3;
     this.cursor = makeEraserCursor(this.radius);
     this.mode = options.mode ?? "partial";
   }
@@ -11497,7 +11683,7 @@ var TemplateTool = class {
 };
 
 // src/tools/laser-tool.ts
-var DEFAULT_COLOR3 = "#ff3b30";
+var DEFAULT_COLOR4 = "#ff3b30";
 var DEFAULT_WIDTH2 = 4;
 var DEFAULT_FADE_MS2 = 1200;
 var LaserTool = class {
@@ -11513,7 +11699,7 @@ var LaserTool = class {
   pendingEmission = [];
   constructor(options = {}) {
     this.name = options.name ?? "laser";
-    this.color = options.color ?? DEFAULT_COLOR3;
+    this.color = options.color ?? DEFAULT_COLOR4;
     this.width = options.width ?? DEFAULT_WIDTH2;
     this.fadeMs = options.fadeMs ?? DEFAULT_FADE_MS2;
   }
@@ -11641,10 +11827,10 @@ var LaserTool = class {
 };
 
 // src/tools/ping-tool.ts
-var DEFAULT_COLOR4 = "#ff3b30";
-var DEFAULT_DURATION_MS2 = 1800;
-var DEFAULT_RADIUS3 = 48;
-var DEFAULT_MIN_INTERVAL_MS = 300;
+var DEFAULT_COLOR5 = "#ff3b30";
+var DEFAULT_DURATION_MS3 = 1800;
+var DEFAULT_RADIUS4 = 48;
+var DEFAULT_MIN_INTERVAL_MS2 = 300;
 var PingTool = class {
   name;
   color;
@@ -11658,10 +11844,10 @@ var PingTool = class {
   pingListeners = /* @__PURE__ */ new Set();
   constructor(options = {}) {
     this.name = options.name ?? "ping";
-    this.color = options.color ?? DEFAULT_COLOR4;
-    this.durationMs = options.durationMs ?? DEFAULT_DURATION_MS2;
-    this.radius = options.radius ?? DEFAULT_RADIUS3;
-    this.minIntervalMs = options.minIntervalMs ?? DEFAULT_MIN_INTERVAL_MS;
+    this.color = options.color ?? DEFAULT_COLOR5;
+    this.durationMs = options.durationMs ?? DEFAULT_DURATION_MS3;
+    this.radius = options.radius ?? DEFAULT_RADIUS4;
+    this.minIntervalMs = options.minIntervalMs ?? DEFAULT_MIN_INTERVAL_MS2;
   }
   now() {
     return performance.now();
@@ -11761,7 +11947,7 @@ var PingTool = class {
 };
 
 // src/index.ts
-var VERSION = "0.55.0";
+var VERSION = "0.56.0";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ArrowTool,
@@ -11783,6 +11969,7 @@ var VERSION = "0.55.0";
   NoteTool,
   PING_PRESENCE_KIND,
   PencilTool,
+  PingInput,
   PingTool,
   RemoteLaserOverlay,
   RemotePingOverlay,