@supermousejs/core 2.4.1 → 2.4.2

package/src/__tests__/core.spec.ts

@@ -1,291 +0,0 @@
-import { describe, it, expect, afterEach, vi } from "vitest";
-import { Supermouse } from "../Supermouse";
-import { DEFAULT_HOVER_SELECTORS } from "../Supermouse";
-
-describe("Supermouse core", () => {
-  let app: Supermouse;
-
-  afterEach(() => {
-    app?.destroy();
-    document.body.innerHTML = "";
-    document.head.innerHTML = "";
-    vi.restoreAllMocks();
-  });
-
-  it("registers and looks up plugins by name", () => {
-    const app = new Supermouse();
-
-    const plugin = {
-      name: "test-plugin",
-      install() {},
-      update() {}
-    };
-
-    app.use(plugin);
-
-    expect(app.getPlugin("test-plugin")).toBe(plugin);
-    expect(app.getPlugin("missing-plugin")).toBeUndefined();
-  });
-
-  it("applies default options", () => {
-    app = new Supermouse({ autoStart: false });
-    expect(app.options.smoothness).toBe(0.15);
-    expect(app.options.enableTouch).toBe(false);
-    expect(app.options.autoDisableOnMobile).toBe(true);
-    expect(app.options.cursor).toBe("auto");
-    expect(app.options.hideOnLeave).toBe(true);
-    expect(app.options.autoStart).toBe(false);
-    expect(app.options.container).toBe(document.body);
-    expect(app.options.dataPrefix).toBe("supermouse");
-    expect(app.options.zIndex).toBe(9999);
-    expect((app.options as any).ignoreOnNative).toBeUndefined();
-  });
-
-  it("merges user options over defaults", () => {
-    const container = document.createElement("div");
-    document.body.appendChild(container);
-
-    app = new Supermouse({
-      smoothness: 0.3,
-      enableTouch: true,
-      autoDisableOnMobile: false,
-      cursor: "custom",
-      hideOnLeave: false,
-      autoStart: false,
-      container,
-      dataPrefix: "custom",
-      zIndex: 1234
-    });
-
-    expect(app.options.smoothness).toBe(0.3);
-    expect(app.options.enableTouch).toBe(true);
-    expect(app.options.autoDisableOnMobile).toBe(false);
-    expect(app.options.cursor).toBe("custom");
-    expect(app.options.hideOnLeave).toBe(false);
-    expect(app.options.autoStart).toBe(false);
-    expect(app.options.container).toBe(container);
-    expect(app.options.dataPrefix).toBe("custom");
-    expect(app.options.zIndex).toBe(1234);
-  });
-
-  it("initializes state with correct shape", () => {
-    app = new Supermouse({ autoStart: false });
-    const { state } = app;
-    expect(state.pointer).toEqual({ x: -100, y: -100 });
-    expect(state.target).toEqual({ x: -100, y: -100 });
-    expect(state.smooth).toEqual({ x: -100, y: -100 });
-    expect(state.velocity).toEqual({ x: 0, y: 0 });
-    expect(state.displacement).toEqual({ x: 0, y: 0 });
-    expect(state.angle).toBe(0);
-    expect(state.isDown).toBe(false);
-    expect(state.isHover).toBe(false);
-    expect(state.isNative).toBe(false);
-    expect(state.cursorMode).toBe("auto");
-    expect(state.hoverTarget).toBeNull();
-    expect(state.reducedMotion).toBe(false);
-    expect(state.hasReceivedInput).toBe(false);
-    expect(state.shape).toBeNull();
-    expect(state.interaction).toEqual({});
-  });
-
-  it("appends stage element to container (default body)", () => {
-    app = new Supermouse({ autoStart: false });
-    const stage = app.stage;
-    expect(stage).toBeInstanceOf(HTMLDivElement);
-    expect(document.body.contains(stage)).toBe(true);
-  });
-
-  it("appends stage element to custom container", () => {
-    const container = document.createElement("div");
-    document.body.appendChild(container);
-    app = new Supermouse({ container, autoStart: false });
-    expect(container.contains(app.stage)).toBe(true);
-  });
-
-  it("exposes version", () => {
-    app = new Supermouse({ autoStart: false });
-    expect(app.version).toBeDefined();
-    expect(typeof app.version).toBe("string");
-  });
-
-  it("sets default hover selectors", () => {
-    app = new Supermouse({ autoStart: false });
-    const selectors = Array.from((app as any).hoverSelectors);
-    expect(selectors).toEqual(expect.arrayContaining(DEFAULT_HOVER_SELECTORS));
-  });
-
-  it("overrides hover selectors if provided", () => {
-    app = new Supermouse({
-      autoStart: false,
-      hoverSelectors: [".my-custom-hover", "a"]
-    });
-    const selectors = Array.from((app as any).hoverSelectors);
-    expect(selectors).toEqual([".my-custom-hover", "a"]);
-  });
-
-  it("auto-starts the loop if autoStart is true", () => {
-    const spy = vi.spyOn(Supermouse.prototype as any, "startLoop");
-    app = new Supermouse({ autoStart: true });
-    expect(spy).toHaveBeenCalled();
-    spy.mockRestore();
-  });
-
-  it("setCursor updates cursorMode", () => {
-    app = new Supermouse({ autoStart: false });
-    app.setCursor("native");
-    expect(app.state.cursorMode).toBe("native");
-    app.setCursor("custom");
-    expect(app.state.cursorMode).toBe("custom");
-    app.setCursor("auto");
-    expect(app.state.cursorMode).toBe("auto");
-  });
-
-  it("cursor option sets initial cursorMode", () => {
-    app = new Supermouse({ autoStart: false, cursor: "native" });
-    expect(app.state.cursorMode).toBe("native");
-  });
-
-  it("reads data attributes into interaction on hover", () => {
-    app = new Supermouse({ autoStart: false });
-    const div = document.createElement("div");
-    div.setAttribute("data-supermouse-test", "hello");
-    div.setAttribute("data-supermouse-flag", "");
-    div.setAttribute("data-cursor", "");
-    document.body.appendChild(div);
-
-    div.dispatchEvent(new MouseEvent("mouseover", { bubbles: true }));
-
-    expect(app.state.isHover).toBe(true);
-    expect(app.state.hoverTarget).toBe(div);
-    expect(app.state.interaction).toEqual({ test: "hello", flag: true });
-  });
-
-  it("evaluates rules on hover", () => {
-    app = new Supermouse({
-      autoStart: false,
-      rules: {
-        "[data-cursor]": { custom: "rule-value" }
-      }
-    });
-    const div = document.createElement("div");
-    div.setAttribute("data-cursor", "");
-    document.body.appendChild(div);
-
-    div.dispatchEvent(new MouseEvent("mouseover", { bubbles: true }));
-
-    expect(app.state.interaction).toEqual({ custom: "rule-value" });
-  });
-
-  it("caches selector matching for rules", () => {
-    app = new Supermouse({
-      autoStart: false,
-      rules: {
-        "[data-cursor]": { test: "value" }
-      }
-    });
-    const div = document.createElement("div");
-    div.setAttribute("data-cursor", "");
-    document.body.appendChild(div);
-    div.dispatchEvent(new MouseEvent("mouseover", { bubbles: true }));
-
-    const input = (app as any).input;
-    const spy = vi.spyOn(input, "matchesSelector");
-
-    // Same element again – selector matching should be cached
-    input.parseDOMInteraction(div);
-    expect(spy).not.toHaveBeenCalled();
-
-    // Different element – should trigger selector matching
-    const div2 = document.createElement("div");
-    div2.setAttribute("data-cursor", "");
-    document.body.appendChild(div2);
-    input.parseDOMInteraction(div2);
-    expect(spy).toHaveBeenCalled();
-  });
-
-  it("re-enable restores original cursor mode after disable", () => {
-    app = new Supermouse({ cursor: "custom", autoStart: false });
-    expect(app.state.cursorMode).toBe("custom");
-
-    app.disable();
-    expect(app.state.cursorMode).toBe("custom");
-
-    app.enable();
-    expect(app.state.cursorMode).toBe("custom");
-  });
-
-  it("suspend/resume does not change cursor mode", () => {
-    app = new Supermouse({ cursor: "custom", autoStart: false });
-    app.start();
-    app.suspend();
-    expect(app.state.cursorMode).toBe("custom");
-    app.resume();
-    expect(app.state.cursorMode).toBe("custom");
-  });
-
-  it("hideOnLeave resets pointer and hasReceivedInput", () => {
-    app = new Supermouse({ hideOnLeave: true, autoStart: false });
-    window.dispatchEvent(
-      new PointerEvent("pointermove", { clientX: 50, clientY: 60, pointerType: "mouse" })
-    );
-    expect(app.state.hasReceivedInput).toBe(true);
-
-    document.dispatchEvent(new MouseEvent("mouseout", { relatedTarget: null }));
-    expect(app.state.hasReceivedInput).toBe(false);
-    expect(app.state.pointer).toEqual({ x: -100, y: -100 });
-  });
-
-  it("scoped instances maintain independent cursor modes", () => {
-    const container1 = document.createElement("div");
-    const container2 = document.createElement("div");
-    document.body.appendChild(container1);
-    document.body.appendChild(container2);
-
-    const app1 = new Supermouse({ container: container1, cursor: "custom", autoStart: false });
-    const app2 = new Supermouse({ container: container2, cursor: "native", autoStart: false });
-
-    expect(app1.state.cursorMode).toBe("custom");
-    expect(app2.state.cursorMode).toBe("native");
-
-    app1.disable();
-    expect(app1.state.cursorMode).toBe("custom");
-    expect(app2.state.cursorMode).toBe("native"); // unaffected
-
-    app1.destroy();
-    app2.destroy();
-    container1.remove();
-    container2.remove();
-  });
-
-  it("matches simple selectors directly", () => {
-    app = new Supermouse({
-      autoStart: false,
-      rules: {
-        ".simple": { test: "ok" }
-      }
-    });
-    const div = document.createElement("div");
-    div.className = "simple";
-    document.body.appendChild(div);
-    div.dispatchEvent(new MouseEvent("mouseover", { bubbles: true }));
-    expect(app.state.interaction).toEqual({ test: "ok" });
-  });
-
-  it("matches complex selectors with ancestor", () => {
-    app = new Supermouse({
-      autoStart: false,
-      rules: {
-        ".ancestor .descendant": { custom: "value" }
-      }
-    });
-    const ancestor = document.createElement("div");
-    ancestor.className = "ancestor";
-    const child = document.createElement("span");
-    child.className = "descendant";
-    ancestor.appendChild(child);
-    document.body.appendChild(ancestor);
-
-    child.dispatchEvent(new MouseEvent("mouseover", { bubbles: true }));
-    expect(app.state.interaction).toEqual({ custom: "value" });
-  });
-});

package/src/__tests__/cursor-mode.spec.ts

@@ -1,109 +0,0 @@
-import { describe, it, expect, afterEach, vi } from "vitest";
-import { Supermouse } from "../Supermouse";
-
-describe("Supermouse cursor modes", () => {
-  let app: Supermouse;
-  let container: HTMLElement;
-
-  afterEach(() => {
-    app?.destroy();
-    document.body.innerHTML = "";
-    document.head.innerHTML = "";
-    vi.restoreAllMocks();
-  });
-
-  const hasClassPrefix = (el: HTMLElement, prefix: string) =>
-    Array.from(el.classList).some((c) => c.startsWith(prefix));
-
-  function createApp(cursor: "auto" | "custom" | "native" | "both") {
-    container = document.createElement("div");
-    document.body.appendChild(container);
-    app = new Supermouse({ container, cursor, autoStart: false });
-  }
-
-  function hoverElement(el: HTMLElement) {
-    el.dispatchEvent(new MouseEvent("mouseover", { bubbles: true }));
-    // Trigger an update cycle so core applies cursor decisions
-    app.step(performance.now() + 16);
-  }
-
-  function movePointer(x: number, y: number) {
-    window.dispatchEvent(
-      new PointerEvent("pointermove", { clientX: x, clientY: y, pointerType: "mouse" })
-    );
-  }
-
-  it("auto mode marks native inputs as isNative and hides custom stage", () => {
-    createApp("auto");
-    const input = document.createElement("input");
-    container.appendChild(input);
-    movePointer(50, 50);
-    hoverElement(input);
-
-    expect(app.state.isNative).toBe(true);
-    expect(app.stage.style.opacity).toBe("0");
-    expect(container.style.cursor).toBe("");
-  });
-
-  it("custom mode ignores native detection and shows custom cursor over inputs", () => {
-    createApp("custom");
-    const input = document.createElement("input");
-    container.appendChild(input);
-    movePointer(50, 50);
-    hoverElement(input);
-
-    expect(app.state.isNative).toBe(false);
-    expect(app.stage.style.opacity).toBe("1");
-    expect(container.style.cursor).toBe("none");
-  });
-
-  it("both mode shows custom cursor and keeps native cursor visible over inputs", () => {
-    createApp("both");
-    const input = document.createElement("input");
-    container.appendChild(input);
-    movePointer(50, 50);
-    hoverElement(input);
-
-    expect(app.state.isNative).toBe(false);
-    expect(app.stage.style.opacity).toBe("1");
-    expect(container.style.cursor).toBe("");
-    expect(hasClassPrefix(container, "supermouse-hide-")).toBe(false);
-  });
-
-  it("native mode hides custom stage and keeps native cursor over inputs", () => {
-    createApp("native");
-    const input = document.createElement("input");
-    container.appendChild(input);
-    movePointer(50, 50);
-    hoverElement(input);
-
-    expect(app.state.isNative).toBe(false);
-    expect(app.stage.style.opacity).toBe("0");
-    expect(container.style.cursor).toBe("");
-  });
-
-  it("auto mode respects data-supermouse-ignore attribute (still native)", () => {
-    createApp("auto");
-    const div = document.createElement("div");
-    div.setAttribute("data-supermouse-ignore", "");
-    container.appendChild(div);
-    movePointer(50, 50);
-    hoverElement(div);
-
-    expect(app.state.isNative).toBe(true);
-  });
-
-  it("custom mode ignores data-supermouse-ignore and keeps custom", () => {
-    createApp("custom");
-    const div = document.createElement("div");
-    div.setAttribute("data-supermouse-ignore", "");
-    container.appendChild(div);
-    movePointer(50, 50);
-    hoverElement(div);
-
-    expect(app.state.isNative).toBe(false);
-    expect(app.stage.style.opacity).toBe("1");
-    expect(container.style.cursor).toBe("none");
-    expect(hasClassPrefix(container, "supermouse-hide-")).toBe(true);
-  });
-});

package/src/__tests__/input.spec.ts

@@ -1,261 +0,0 @@
-import { describe, it, expect, afterEach, vi, beforeEach } from "vitest";
-import { Supermouse } from "../Supermouse";
-
-describe("Supermouse input handling", () => {
-  let app: Supermouse;
-  let container: HTMLElement;
-
-  beforeEach(() => {
-    container = document.createElement("div");
-    document.body.appendChild(container);
-    // Ensure the container is not body for relative coordinate tests
-    app = new Supermouse({ container, autoStart: false });
-  });
-
-  afterEach(() => {
-    app?.destroy();
-    document.body.innerHTML = "";
-    document.head.innerHTML = "";
-    vi.restoreAllMocks();
-  });
-
-  function dispatchPointerMove(x: number, y: number, pointerType = "mouse") {
-    const event = new PointerEvent("pointermove", {
-      clientX: x,
-      clientY: y,
-      pointerType,
-      bubbles: true
-    });
-    window.dispatchEvent(event);
-  }
-
-  function dispatchPointerDown() {
-    window.dispatchEvent(new PointerEvent("pointerdown", { pointerType: "mouse", bubbles: true }));
-  }
-
-  function dispatchPointerUp() {
-    window.dispatchEvent(new PointerEvent("pointerup", { pointerType: "mouse", bubbles: true }));
-  }
-
-  function dispatchMouseOver(target: HTMLElement) {
-    target.dispatchEvent(new MouseEvent("mouseover", { bubbles: true }));
-  }
-
-  function dispatchMouseOut(target: HTMLElement, relatedTarget?: Node) {
-    const event = new MouseEvent("mouseout", {
-      bubbles: true,
-      relatedTarget: relatedTarget ?? null
-    });
-    target.dispatchEvent(event);
-  }
-
-  it("updates pointer and sets hasReceivedInput on first move", () => {
-    dispatchPointerMove(100, 150);
-    expect(app.state.pointer).toEqual({ x: 100, y: 150 });
-    expect(app.state.hasReceivedInput).toBe(true);
-  });
-
-  it("continues updating pointer on subsequent moves", () => {
-    dispatchPointerMove(100, 150);
-    dispatchPointerMove(200, 250);
-    expect(app.state.pointer).toEqual({ x: 200, y: 250 });
-  });
-
-  it("ignores touch events when autoDisableOnMobile is true and enableTouch is false", () => {
-    // Simulate a coarse pointer device by mocking matchMedia
-    vi.spyOn(window, "matchMedia").mockImplementation(
-      (query) =>
-        ({
-          matches: query === "(pointer: fine)" ? false : false,
-          media: query,
-          onchange: null,
-          addListener: () => {},
-          removeListener: () => {},
-          addEventListener: () => {},
-          removeEventListener: () => {},
-          dispatchEvent: () => false
-        }) as MediaQueryList
-    );
-
-    // Recreate app with the mock (need to destroy previous)
-    app.destroy();
-    app = new Supermouse({ container, autoStart: false });
-
-    dispatchPointerMove(50, 60, "touch");
-    // Touch should be ignored, so pointer remains offscreen
-    expect(app.state.pointer).toEqual({ x: -100, y: -100 });
-    expect(app.state.hasReceivedInput).toBe(false);
-  });
-
-  it("sets isDown on pointerdown and clears on pointerup", () => {
-    dispatchPointerDown();
-    expect(app.state.isDown).toBe(true);
-    dispatchPointerUp();
-    expect(app.state.isDown).toBe(false);
-  });
-
-  it("detects hover on registered selector and parses data attributes", () => {
-    const link = document.createElement("a");
-    link.setAttribute("data-supermouse-text", "Hello");
-    link.setAttribute("data-supermouse-icon", "pointer");
-    link.setAttribute("data-supermouse-magnetic", ""); // empty becomes true
-    container.appendChild(link);
-
-    dispatchMouseOver(link);
-
-    expect(app.state.isHover).toBe(true);
-    expect(app.state.hoverTarget).toBe(link);
-    expect(app.state.interaction).toEqual({
-      text: "Hello",
-      icon: "pointer",
-      magnetic: true
-    });
-  });
-
-  it("clears hover state on mouseout", () => {
-    const link = document.createElement("a");
-    container.appendChild(link);
-
-    dispatchMouseOver(link);
-    expect(app.state.isHover).toBe(true);
-
-    dispatchMouseOut(link);
-    expect(app.state.isHover).toBe(false);
-    expect(app.state.hoverTarget).toBeNull();
-    expect(app.state.interaction).toEqual({});
-  });
-
-  it("sets isNative for input elements when ignoreOnNative is auto", () => {
-    const input = document.createElement("input");
-    container.appendChild(input);
-
-    dispatchMouseOver(input);
-
-    expect(app.state.isNative).toBe(true);
-  });
-
-  it("sets isNative for elements with custom CSS cursor", () => {
-    const div = document.createElement("div");
-    div.style.cursor = "text"; // not in SUPERMOUSE_CURSORS
-    container.appendChild(div);
-
-    dispatchMouseOver(div);
-
-    expect(app.state.isNative).toBe(true);
-  });
-
-  it("does not set isNative for elements with default cursor", () => {
-    const div = document.createElement("div");
-    // default cursor is auto/default, which is in SUPERMOUSE_CURSORS
-    container.appendChild(div);
-
-    dispatchMouseOver(div);
-
-    expect(app.state.isNative).toBe(false);
-  });
-
-  it("sets isNative when element has ignore attribute", () => {
-    const div = document.createElement("div");
-    div.setAttribute("data-supermouse-ignore", "");
-    container.appendChild(div);
-
-    dispatchMouseOver(div);
-
-    expect(app.state.isNative).toBe(true);
-  });
-
-  it("does not set isHover when element does not match hover selector", () => {
-    const span = document.createElement("span");
-    container.appendChild(span);
-
-    dispatchMouseOver(span);
-
-    expect(app.state.isHover).toBe(false);
-    expect(app.state.hoverTarget).toBeNull();
-  });
-
-  it("resets pointer to offscreen on document mouseleave when hideOnLeave is true", () => {
-    dispatchPointerMove(100, 100);
-    expect(app.state.pointer).toEqual({ x: 100, y: 100 });
-
-    const leaveEvent = new MouseEvent("mouseout", { relatedTarget: null });
-    document.dispatchEvent(leaveEvent);
-
-    expect(app.state.hasReceivedInput).toBe(false);
-    expect(app.state.pointer).toEqual({ x: -100, y: -100 });
-  });
-
-  it("does not reset pointer on mouseleave if hideOnLeave is false", () => {
-    app.destroy();
-    app = new Supermouse({ container, autoStart: false, hideOnLeave: false });
-
-    dispatchPointerMove(100, 100);
-    const leaveEvent = new MouseEvent("mouseout", { relatedTarget: null });
-    document.dispatchEvent(leaveEvent);
-
-    expect(app.state.hasReceivedInput).toBe(true);
-    expect(app.state.pointer).toEqual({ x: 100, y: 100 });
-  });
-
-  it("makes coordinates relative to container", () => {
-    const rect = {
-      left: 200,
-      top: 300,
-      right: 500,
-      bottom: 600,
-      width: 300,
-      height: 300,
-      x: 200,
-      y: 300,
-      toJSON: () => {}
-    };
-    vi.spyOn(container, "getBoundingClientRect").mockReturnValue(rect as DOMRect);
-
-    window.dispatchEvent(new Event("resize"));
-
-    dispatchPointerMove(250, 350);
-
-    expect(app.state.pointer).toEqual({ x: 50, y: 50 });
-  });
-
-  it("ignores all custom behavior inside data-supermouse-ignore area", () => {
-    app = new Supermouse({ container, autoStart: false });
-
-    // Create ignored wrapper
-    const ignored = document.createElement("div");
-    ignored.setAttribute("data-supermouse-ignore", "");
-    const innerButton = document.createElement("button");
-    innerButton.setAttribute("data-supermouse-text", "Hello");
-    ignored.appendChild(innerButton);
-    container.appendChild(ignored);
-
-    // Spy on parseDOMInteraction to ensure it's not called
-    const input = (app as any).input;
-    const parseSpy = vi.spyOn(input, "parseDOMInteraction");
-
-    // Hover the inner button (inside ignored area)
-    innerButton.dispatchEvent(new MouseEvent("mouseover", { bubbles: true }));
-
-    // Expect no interaction parsing
-    expect(parseSpy).not.toHaveBeenCalled();
-    // Native cursor shown
-    expect(app.state.isNative).toBe(true);
-    // Hover state cleared
-    expect(app.state.isHover).toBe(false);
-    expect(app.state.hoverTarget).toBeNull();
-    // Interaction data empty
-    expect(app.state.interaction).toEqual({});
-
-    // Now move to a normal element outside ignored area
-    const normalButton = document.createElement("button");
-    container.appendChild(normalButton);
-    normalButton.dispatchEvent(new MouseEvent("mouseover", { bubbles: true }));
-
-    // Normal behavior should resume
-    expect(app.state.isNative).toBe(false);
-    expect(app.state.isHover).toBe(true);
-    expect(app.state.hoverTarget).toBe(normalButton);
-    // Interaction parsing should happen again
-    expect(parseSpy).toHaveBeenCalled();
-  });
-});