@blorkfield/overlay-core 0.8.0 → 0.8.2

package/dist/index.d.cts

@@ -669,12 +669,6 @@ declare class OverlayScene {
      * Get all unique tags currently in use by objects in the scene.
      */
     getAllTags(): string[];
-    /**
-     * Set the mouse position for follow behavior.
-     * This overrides the browser mouse position for the 'follow' and 'follow-mouse' tags.
-     * @deprecated Use setFollowTarget('mouse', x, y) instead
-     */
-    setMousePosition(x: number, y: number): void;
     /**
      * Set a follow target position. Objects with 'follow-{key}' tag will
      * automatically move toward this target each frame.
@@ -693,6 +687,23 @@ declare class OverlayScene {
      * @returns Array of follow target keys
      */
     getFollowTargetKeys(): string[];
+    /**
+     * Programmatically grab an object at the current mouse position.
+     * Uses the externally set mouse position (via setFollowTarget('mouse', x, y))
+     * or the native canvas mouse position if no external position is set.
+     * Only objects with the 'grabable' tag can be grabbed.
+     * @returns The ID of the grabbed object, or null if no grabable object at position
+     */
+    startGrab(): string | null;
+    /**
+     * Release any currently grabbed object.
+     */
+    endGrab(): void;
+    /**
+     * Get the ID of the currently grabbed object.
+     * @returns The ID of the grabbed object, or null if nothing is grabbed
+     */
+    getGrabbedObject(): string | null;
     /**
      * Apply a force to an object.
      * @param objectId - The ID of the object

package/dist/index.d.ts

@@ -669,12 +669,6 @@ declare class OverlayScene {
      * Get all unique tags currently in use by objects in the scene.
      */
     getAllTags(): string[];
-    /**
-     * Set the mouse position for follow behavior.
-     * This overrides the browser mouse position for the 'follow' and 'follow-mouse' tags.
-     * @deprecated Use setFollowTarget('mouse', x, y) instead
-     */
-    setMousePosition(x: number, y: number): void;
     /**
      * Set a follow target position. Objects with 'follow-{key}' tag will
      * automatically move toward this target each frame.
@@ -693,6 +687,23 @@ declare class OverlayScene {
      * @returns Array of follow target keys
      */
     getFollowTargetKeys(): string[];
+    /**
+     * Programmatically grab an object at the current mouse position.
+     * Uses the externally set mouse position (via setFollowTarget('mouse', x, y))
+     * or the native canvas mouse position if no external position is set.
+     * Only objects with the 'grabable' tag can be grabbed.
+     * @returns The ID of the grabbed object, or null if no grabable object at position
+     */
+    startGrab(): string | null;
+    /**
+     * Release any currently grabbed object.
+     */
+    endGrab(): void;
+    /**
+     * Get the ID of the currently grabbed object.
+     * @returns The ID of the grabbed object, or null if nothing is grabbed
+     */
+    getGrabbedObject(): string | null;
     /**
      * Apply a force to an object.
      * @param objectId - The ID of the object

package/dist/index.js

@@ -2282,14 +2282,6 @@ var OverlayScene = class {
     }
     return Array.from(tagsSet).sort();
   }
-  /**
-   * Set the mouse position for follow behavior.
-   * This overrides the browser mouse position for the 'follow' and 'follow-mouse' tags.
-   * @deprecated Use setFollowTarget('mouse', x, y) instead
-   */
-  setMousePosition(x, y) {
-    this.setFollowTarget("mouse", x, y);
-  }
   /**
    * Set a follow target position. Objects with 'follow-{key}' tag will
    * automatically move toward this target each frame.
@@ -2299,6 +2291,12 @@ var OverlayScene = class {
    */
   setFollowTarget(key, x, y) {
     this.followTargets.set(key, { x, y });
+    if (key === "mouse" && this.mouse) {
+      this.mouse.position.x = x;
+      this.mouse.position.y = y;
+      this.mouse.absolute.x = x;
+      this.mouse.absolute.y = y;
+    }
   }
   /**
    * Remove a follow target. Objects with the corresponding tag will stop following.
@@ -2314,6 +2312,52 @@ var OverlayScene = class {
   getFollowTargetKeys() {
     return Array.from(this.followTargets.keys());
   }
+  // ==================== GRAB/DRAG METHODS ====================
+  /**
+   * Programmatically grab an object at the current mouse position.
+   * Uses the externally set mouse position (via setFollowTarget('mouse', x, y))
+   * or the native canvas mouse position if no external position is set.
+   * Only objects with the 'grabable' tag can be grabbed.
+   * @returns The ID of the grabbed object, or null if no grabable object at position
+   */
+  startGrab() {
+    if (!this.mouseConstraint || !this.mouse) return null;
+    const mouseTarget = this.followTargets.get("mouse");
+    const position = mouseTarget ?? { x: this.mouse.position.x, y: this.mouse.position.y };
+    const bodies = Matter5.Query.point(
+      Matter5.Composite.allBodies(this.engine.world),
+      position
+    );
+    for (const body of bodies) {
+      const entry = this.findObjectByBody(body);
+      if (entry && entry.tags.includes("grabable")) {
+        this.mouseConstraint.constraint.bodyB = entry.body;
+        this.mouseConstraint.constraint.pointB = {
+          x: position.x - entry.body.position.x,
+          y: position.y - entry.body.position.y
+        };
+        return entry.id;
+      }
+    }
+    return null;
+  }
+  /**
+   * Release any currently grabbed object.
+   */
+  endGrab() {
+    if (this.mouseConstraint) {
+      this.mouseConstraint.constraint.bodyB = null;
+    }
+  }
+  /**
+   * Get the ID of the currently grabbed object.
+   * @returns The ID of the grabbed object, or null if nothing is grabbed
+   */
+  getGrabbedObject() {
+    if (!this.mouseConstraint?.constraint.bodyB) return null;
+    const entry = this.findObjectByBody(this.mouseConstraint.constraint.bodyB);
+    return entry?.id ?? null;
+  }
   // ==================== PHYSICS MANIPULATION METHODS ====================
   /**
    * Apply a force to an object.