tabwright 1.0.0

package/dist/ghost-cursor-client.js

@@ -0,0 +1,374 @@
+(() => {
+  var __defProp = Object.defineProperty;
+  var __getOwnPropNames = Object.getOwnPropertyNames;
+  var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+  var __hasOwnProp = Object.prototype.hasOwnProperty;
+  function __accessProp(key) {
+    return this[key];
+  }
+  var __toCommonJS = (from) => {
+    var entry = (__moduleCache ??= new WeakMap).get(from), desc;
+    if (entry)
+      return entry;
+    entry = __defProp({}, "__esModule", { value: true });
+    if (from && typeof from === "object" || typeof from === "function") {
+      for (var key of __getOwnPropNames(from))
+        if (!__hasOwnProp.call(entry, key))
+          __defProp(entry, key, {
+            get: __accessProp.bind(from, key),
+            enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+          });
+    }
+    __moduleCache.set(from, entry);
+    return entry;
+  };
+  var __moduleCache;
+
+  // src/ghost-cursor-client.ts
+  var exports_ghost_cursor_client = {};
+
+  // src/assets/cursors/screen-studio/pointer-macos-tahoe-data-url.ts
+  var SCREENSTUDIO_POINTER_MACOS_TAHOE_DATA_URL = "data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iNjE4IiBoZWlnaHQ9Ijk1OCIgdmlld0JveD0iMCAwIDYxOCA5NTgiIGZpbGw9Im5vbmUiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+CjxnIGZpbHRlcj0idXJsKCNmaWx0ZXIwX2RfMzg0XzI3KSI+CjxwYXRoIGZpbGwtcnVsZT0iZXZlbm9kZCIgY2xpcC1ydWxlPSJldmVub2RkIiBkPSJNMTI3LjA2MiAzNy4wMzMxTDU0MC42OTYgNDUxLjU1NUM1OTIuNjUzIDUwMy42NiA1NTUuNzk0IDU5Mi41NzQgNDgyLjIyNiA1OTIuNTc0TDQyMS44MzEgNTkyLjU2OUw0ODEuODIxIDczNS4wNTRDNDkyLjMzMSA3NjAuMDIxIDQ5Mi40NzkgNzg3LjY1MiA0ODIuMjY1IDgxMi43NjdDNDcyLjAwMiA4MzcuOTMyIDQ1Mi41NjEgODU3LjU3IDQyNy40OTYgODY4LjA4QzQxNC44NjQgODczLjM1OSA0MDEuNjQgODc2LjAyNCAzODguMTIxIDg3Ni4wMjRDMzQ3LjExNyA4NzYuMDI0IDMxMC4zNTggODUxLjYgMjk0LjQ3IDgxMy44MDRMMjMxLjQyIDY2My45MThMMTkwLjM2OCA3MDAuMzM3QzEzNy4wMjkgNzQ3LjUwOCA1MyA3MDkuNjYzIDUzIDYzOC40MTNWNjcuNjc0NEM1MyAyOC45OTAzIDk5LjcyNjggOS42NDgyOCAxMjcuMDYyIDM3LjAzMzFaIiBmaWxsPSJ3aGl0ZSIvPgo8cGF0aCBmaWxsLXJ1bGU9ImV2ZW5vZGQiIGNsaXAtcnVsZT0iZXZlbm9kZCIgZD0iTTEwMi4zMTYgOTkuNjUyQzEwMi4zMTYgOTMuMTg4MiAxMTAuMTYyIDg5LjkzMTYgMTE0LjcwMSA5NC41MjA0TDUwNC44OTcgNDg1LjU1NUM1MjYuMTY0IDUwNi44NzEgNTExLjA2NSA1NDMuMjM2IDQ4MC45NjcgNTQzLjIzNkwzNDcuNTQ2IDU0My4xNjFMNDM2LjM0MiA3NTQuMTQzQzQ0Ny41NDIgNzgwLjc4OCA0MzUuMDA5IDgxMS40MjkgNDA4LjQxNCA4MjIuNTgxQzM4MS43MiA4MzMuNzgxIDM1MS4xMjggODIxLjI5OCAzMzkuOTc3IDc5NC43MDJMMjUwLjI5MyA1ODEuMzUyTDE1OC41MTcgNjYyLjY0NEMxMzcuOTkxIDY4MC44MDEgMTA2LjMxOSA2NjguMTQ1IDEwMi42NjQgNjQyLjMyM0wxMDIuMzE2IDYzNy4zMzFWOTkuNjUyWiIgZmlsbD0iYmxhY2siLz4KPC9nPgo8ZGVmcz4KPGZpbHRlciBpZD0iZmlsdGVyMF9kXzM4NF8yNyIgeD0iMC4zNCIgeT0iMC43OTkyMTkiIHdpZHRoPSI2MTcuMzIiIGhlaWdodD0iOTU3LjE0NCIgZmlsdGVyVW5pdHM9InVzZXJTcGFjZU9uVXNlIiBjb2xvci1pbnRlcnBvbGF0aW9uLWZpbHRlcnM9InNSR0IiPgo8ZmVGbG9vZCBmbG9vZC1vcGFjaXR5PSIwIiByZXN1bHQ9IkJhY2tncm91bmRJbWFnZUZpeCIvPgo8ZmVDb2xvck1hdHJpeCBpbj0iU291cmNlQWxwaGEiIHR5cGU9Im1hdHJpeCIgdmFsdWVzPSIwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAxMjcgMCIgcmVzdWx0PSJoYXJkQWxwaGEiLz4KPGZlT2Zmc2V0IGR5PSIyOS4yNiIvPgo8ZmVHYXVzc2lhbkJsdXIgc3RkRGV2aWF0aW9uPSIyNi4zMyIvPgo8ZmVDb21wb3NpdGUgaW4yPSJoYXJkQWxwaGEiIG9wZXJhdG9yPSJvdXQiLz4KPGZlQ29sb3JNYXRyaXggdHlwZT0ibWF0cml4IiB2YWx1ZXM9IjAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAuNjUgMCIvPgo8ZmVCbGVuZCBtb2RlPSJub3JtYWwiIGluMj0iQmFja2dyb3VuZEltYWdlRml4IiByZXN1bHQ9ImVmZmVjdDFfZHJvcFNoYWRvd18zODRfMjciLz4KPGZlQmxlbmQgbW9kZT0ibm9ybWFsIiBpbj0iU291cmNlR3JhcGhpYyIgaW4yPSJlZmZlY3QxX2Ryb3BTaGFkb3dfMzg0XzI3IiByZXN1bHQ9InNoYXBlIi8+CjwvZmlsdGVyPgo8L2RlZnM+Cjwvc3ZnPg==";
+
+  // src/ghost-cursor-client.ts
+  var isTopFrame = (() => {
+    try {
+      return window === window.top;
+    } catch {
+      return false;
+    }
+  })();
+  var CURSOR_ID = "__playwriter_ghost_cursor__";
+  var SCREENSTUDIO_POINTER_ASPECT_RATIO = 618 / 958;
+  var SCREENSTUDIO_HOTSPOT_X_RATIO = 0.14;
+  var SCREENSTUDIO_HOTSPOT_Y_RATIO = 0.06;
+  var MINIMAL_TRIANGLE_HOTSPOT_X_RATIO = 0.07;
+  var MINIMAL_TRIANGLE_HOTSPOT_Y_RATIO = 0.06;
+  var MOVE_EASING = "cubic-bezier(0.65, 0, 0.35, 1)";
+  var PRESS_EASING = "cubic-bezier(0.23, 1, 0.32, 1)";
+  var PRESS_DURATION_MS = 140;
+  var IDLE_HIDE_DELAY_MS = 5000;
+  var IDLE_FADE_OUT_MS = 600;
+  var DEFAULT_OPTIONS = {
+    style: "minimal",
+    color: "#111827",
+    size: 22,
+    zIndex: 2147483647,
+    easing: MOVE_EASING,
+    minDurationMs: 220,
+    maxDurationMs: 1500,
+    speedPxPerMs: 1.2
+  };
+  var runtime = {
+    outerElement: null,
+    innerElement: null,
+    options: DEFAULT_OPTIONS,
+    x: 0,
+    y: 0,
+    scale: 1,
+    hasPosition: false,
+    enabled: false,
+    idleHidden: false
+  };
+  var idleHideTimer = null;
+  function clamp(options) {
+    const { value, min, max } = options;
+    return Math.min(max, Math.max(min, value));
+  }
+  function mergeOptions(options) {
+    if (!options) {
+      return DEFAULT_OPTIONS;
+    }
+    return {
+      style: options.style ?? DEFAULT_OPTIONS.style,
+      color: options.color ?? DEFAULT_OPTIONS.color,
+      size: options.size ?? DEFAULT_OPTIONS.size,
+      zIndex: options.zIndex ?? DEFAULT_OPTIONS.zIndex,
+      easing: options.easing ?? DEFAULT_OPTIONS.easing,
+      minDurationMs: options.minDurationMs ?? DEFAULT_OPTIONS.minDurationMs,
+      maxDurationMs: options.maxDurationMs ?? DEFAULT_OPTIONS.maxDurationMs,
+      speedPxPerMs: options.speedPxPerMs ?? DEFAULT_OPTIONS.speedPxPerMs
+    };
+  }
+  function getCursorDimensions() {
+    if (runtime.options.style === "screenstudio") {
+      const height = runtime.options.size;
+      const width = Math.max(10, Math.round(height * SCREENSTUDIO_POINTER_ASPECT_RATIO));
+      return { width, height };
+    }
+    if (runtime.options.style === "minimal") {
+      const size = Math.max(12, runtime.options.size);
+      return { width: size, height: size };
+    }
+    return { width: runtime.options.size, height: runtime.options.size };
+  }
+  function getHotspotOffsetPx() {
+    const dimensions = getCursorDimensions();
+    if (runtime.options.style === "screenstudio") {
+      return {
+        x: Math.round(dimensions.width * SCREENSTUDIO_HOTSPOT_X_RATIO),
+        y: Math.round(dimensions.height * SCREENSTUDIO_HOTSPOT_Y_RATIO)
+      };
+    }
+    if (runtime.options.style === "minimal") {
+      return {
+        x: Math.round(dimensions.width * MINIMAL_TRIANGLE_HOTSPOT_X_RATIO),
+        y: Math.round(dimensions.height * MINIMAL_TRIANGLE_HOTSPOT_Y_RATIO)
+      };
+    }
+    return {
+      x: Math.round(dimensions.width / 2),
+      y: Math.round(dimensions.height / 2)
+    };
+  }
+  function getBaseOpacity() {
+    if (runtime.options.style === "screenstudio") {
+      return "0.95";
+    }
+    if (runtime.options.style === "minimal") {
+      return "1";
+    }
+    return "0.72";
+  }
+  function applyTranslate() {
+    if (!runtime.outerElement) {
+      return;
+    }
+    const hotspot = getHotspotOffsetPx();
+    runtime.outerElement.style.transform = `translate3d(${runtime.x - hotspot.x}px, ${runtime.y - hotspot.y}px, 0)`;
+  }
+  function applyScale() {
+    if (!runtime.innerElement) {
+      return;
+    }
+    runtime.innerElement.style.transform = `scale(${runtime.scale})`;
+  }
+  function computeDurationMs(options) {
+    if (!runtime.hasPosition) {
+      return 0;
+    }
+    const dx = options.targetX - runtime.x;
+    const dy = options.targetY - runtime.y;
+    const distance = Math.hypot(dx, dy);
+    const rawDurationMs = distance / runtime.options.speedPxPerMs;
+    return clamp({
+      value: rawDurationMs,
+      min: runtime.options.minDurationMs,
+      max: runtime.options.maxDurationMs
+    });
+  }
+  function createCursorElement() {
+    const outer = document.createElement("div");
+    outer.id = CURSOR_ID;
+    outer.setAttribute("aria-hidden", "true");
+    outer.style.position = "fixed";
+    outer.style.left = "0";
+    outer.style.top = "0";
+    outer.style.pointerEvents = "none";
+    outer.style.zIndex = `${runtime.options.zIndex}`;
+    outer.style.transitionProperty = "transform";
+    outer.style.transitionTimingFunction = runtime.options.easing;
+    outer.style.transitionDuration = "0ms";
+    outer.style.willChange = "transform";
+    const inner = document.createElement("div");
+    inner.style.transitionProperty = "transform, opacity";
+    inner.style.transitionTimingFunction = PRESS_EASING;
+    inner.style.transitionDuration = `${PRESS_DURATION_MS}ms`;
+    inner.style.opacity = getBaseOpacity();
+    outer.appendChild(inner);
+    runtime.outerElement = outer;
+    runtime.innerElement = inner;
+    applyRuntimeVisualOptions();
+    return outer;
+  }
+  function ensureCursorElement() {
+    const existing = document.getElementById(CURSOR_ID);
+    if (existing) {
+      runtime.outerElement = existing;
+      runtime.innerElement = existing.firstElementChild || null;
+      return existing;
+    }
+    const outer = createCursorElement();
+    const root = document.documentElement || document.body;
+    root.appendChild(outer);
+    return outer;
+  }
+  function applyRuntimeVisualOptions() {
+    if (!runtime.innerElement) {
+      return;
+    }
+    const dimensions = getCursorDimensions();
+    runtime.innerElement.style.width = `${dimensions.width}px`;
+    runtime.innerElement.style.height = `${dimensions.height}px`;
+    if (runtime.outerElement) {
+      runtime.outerElement.style.zIndex = `${runtime.options.zIndex}`;
+      runtime.outerElement.style.transitionTimingFunction = runtime.options.easing;
+    }
+    const hotspot = getHotspotOffsetPx();
+    runtime.innerElement.style.transformOrigin = `${hotspot.x}px ${hotspot.y}px`;
+    if (runtime.options.style === "screenstudio") {
+      runtime.innerElement.style.borderRadius = "0";
+      runtime.innerElement.style.border = "none";
+      runtime.innerElement.style.backgroundColor = "transparent";
+      runtime.innerElement.style.backgroundImage = `url("${SCREENSTUDIO_POINTER_MACOS_TAHOE_DATA_URL}")`;
+      runtime.innerElement.style.backgroundRepeat = "no-repeat";
+      runtime.innerElement.style.backgroundPosition = "left top";
+      runtime.innerElement.style.backgroundSize = "contain";
+      runtime.innerElement.style.backdropFilter = "none";
+      runtime.innerElement.style.filter = "none";
+      runtime.innerElement.style.boxShadow = "none";
+      runtime.innerElement.style.opacity = getBaseOpacity();
+      return;
+    }
+    if (runtime.options.style === "minimal") {
+      const triangleSvg = `<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="-1 -1 26 26"><path fill="white" stroke="${runtime.options.color}" stroke-width="1.5" stroke-linejoin="round" d="m23.284 19.124l-6.866-6.895a.4.4 0 0 1-.118-.296a.43.43 0 0 1 .163-.282l4.439-3.077a1.48 1.48 0 0 0 .621-1.48a1.48 1.48 0 0 0-1.036-1.198L1.623.302a1.14 1.14 0 0 0-1.11.282A1.13 1.13 0 0 0 .29 1.649L5.928 20.44a1.48 1.48 0 0 0 1.183 1.035a1.48 1.48 0 0 0 1.48-.621l3.078-4.44a.37.37 0 0 1 .31-.118a.43.43 0 0 1 .296.104l6.91 6.91a1.48 1.48 0 0 0 2.087 0l2.086-2.086a1.48 1.48 0 0 0-.074-2.101"/></svg>`;
+      const triangleDataUrl = `url("data:image/svg+xml,${encodeURIComponent(triangleSvg)}")`;
+      runtime.innerElement.style.borderRadius = "0";
+      runtime.innerElement.style.border = "none";
+      runtime.innerElement.style.backgroundColor = "transparent";
+      runtime.innerElement.style.backgroundImage = triangleDataUrl;
+      runtime.innerElement.style.backgroundRepeat = "no-repeat";
+      runtime.innerElement.style.backgroundSize = "contain";
+      runtime.innerElement.style.backgroundPosition = "left top";
+      runtime.innerElement.style.backdropFilter = "none";
+      runtime.innerElement.style.boxShadow = "none";
+      runtime.innerElement.style.filter = "drop-shadow(0 1px 2px rgba(0, 0, 0, 0.4))";
+      runtime.innerElement.style.opacity = getBaseOpacity();
+      return;
+    }
+    runtime.innerElement.style.borderRadius = "999px";
+    runtime.innerElement.style.border = "none";
+    runtime.innerElement.style.backgroundColor = runtime.options.color;
+    runtime.innerElement.style.backgroundImage = "none";
+    runtime.innerElement.style.backdropFilter = "none";
+    runtime.innerElement.style.filter = "none";
+    runtime.innerElement.style.boxShadow = "0 2px 10px rgba(0, 0, 0, 0.18), inset 0 0 0 2px rgba(255, 255, 255, 0.55)";
+    runtime.innerElement.style.opacity = getBaseOpacity();
+  }
+  function clearIdleHideTimer() {
+    if (idleHideTimer !== null) {
+      clearTimeout(idleHideTimer);
+      idleHideTimer = null;
+    }
+  }
+  function scheduleIdleHide() {
+    clearIdleHideTimer();
+    idleHideTimer = setTimeout(() => {
+      idleHideTimer = null;
+      if (!runtime.enabled || !runtime.innerElement) {
+        return;
+      }
+      runtime.idleHidden = true;
+      runtime.innerElement.style.transitionDuration = `${IDLE_FADE_OUT_MS}ms`;
+      runtime.innerElement.style.transitionTimingFunction = PRESS_EASING;
+      runtime.innerElement.style.opacity = "0";
+    }, IDLE_HIDE_DELAY_MS);
+  }
+  function wakeFromIdle(options) {
+    runtime.x = options.x;
+    runtime.y = options.y;
+    runtime.hasPosition = true;
+    if (runtime.innerElement) {
+      runtime.innerElement.style.transitionDuration = `${PRESS_DURATION_MS}ms`;
+      runtime.innerElement.style.transitionTimingFunction = PRESS_EASING;
+      runtime.innerElement.style.opacity = getBaseOpacity();
+    }
+  }
+  function moveCursor(options) {
+    if (!runtime.enabled) {
+      return;
+    }
+    ensureCursorElement();
+    const durationMs = computeDurationMs({ targetX: options.x, targetY: options.y });
+    if (runtime.outerElement) {
+      runtime.outerElement.style.transitionDuration = `${Math.round(durationMs)}ms`;
+      runtime.outerElement.style.transitionTimingFunction = runtime.options.easing;
+    }
+    runtime.x = options.x;
+    runtime.y = options.y;
+    runtime.hasPosition = true;
+    applyTranslate();
+  }
+  function setPressed(options) {
+    if (!runtime.enabled || !runtime.innerElement) {
+      return;
+    }
+    runtime.scale = options.pressed ? runtime.options.style === "dot" ? 0.92 : 0.95 : 1;
+    runtime.innerElement.style.transitionDuration = `${PRESS_DURATION_MS}ms`;
+    runtime.innerElement.style.transitionTimingFunction = PRESS_EASING;
+    runtime.innerElement.style.opacity = options.pressed ? "1" : getBaseOpacity();
+    applyScale();
+  }
+  function enable(options) {
+    runtime.options = mergeOptions(options);
+    runtime.enabled = true;
+    ensureCursorElement();
+    applyRuntimeVisualOptions();
+    if (!runtime.hasPosition) {
+      runtime.x = Math.round(window.innerWidth / 2);
+      runtime.y = Math.round(window.innerHeight / 2);
+      runtime.scale = 1;
+      runtime.hasPosition = true;
+    }
+    runtime.idleHidden = false;
+    if (runtime.innerElement) {
+      runtime.innerElement.style.opacity = getBaseOpacity();
+    }
+    applyTranslate();
+    applyScale();
+    scheduleIdleHide();
+  }
+  function disable() {
+    runtime.enabled = false;
+    runtime.scale = 1;
+    runtime.hasPosition = false;
+    runtime.idleHidden = false;
+    clearIdleHideTimer();
+    if (runtime.outerElement) {
+      runtime.outerElement.remove();
+      runtime.outerElement = null;
+      runtime.innerElement = null;
+    }
+  }
+  function applyMouseAction(action) {
+    if (!runtime.enabled) {
+      return;
+    }
+    if (runtime.idleHidden) {
+      runtime.idleHidden = false;
+      wakeFromIdle({ x: action.x, y: action.y });
+    }
+    if (action.type === "move" || action.type === "wheel") {
+      moveCursor({ x: action.x, y: action.y });
+    } else if (action.type === "down") {
+      moveCursor({ x: action.x, y: action.y });
+      setPressed({ pressed: true });
+    } else if (action.type === "up") {
+      moveCursor({ x: action.x, y: action.y });
+      setPressed({ pressed: false });
+    }
+    scheduleIdleHide();
+  }
+  var api = {
+    enable,
+    disable,
+    applyMouseAction,
+    isEnabled: () => {
+      return runtime.enabled;
+    }
+  };
+  if (isTopFrame) {
+    globalThis.__playwriterGhostCursor = api;
+    try {
+      if (document.readyState === "loading") {
+        document.addEventListener("DOMContentLoaded", () => {
+          try {
+            api.enable();
+          } catch {}
+        }, { once: true });
+      } else {
+        api.enable();
+      }
+    } catch {}
+  }
+})();

package/dist/ghost-cursor-controller.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Always-on ghost cursor controller (Node side).
+ *
+ * Wires page.onMouseAction → applyGhostCursorMouseAction for every page.
+ * Chains with any pre-existing onMouseAction callback. Cursor-apply is
+ * fire-and-forget via a per-page queue so it does not block action completion.
+ */
+import type { BrowserContext, Page } from '@xmorse/playwright-core';
+import { type GhostCursorClientOptions } from './ghost-cursor.js';
+interface GhostCursorLogger {
+    error: (...args: unknown[]) => void;
+}
+interface RecordingTargetOptions {
+    page?: Page;
+    sessionId?: string;
+}
+export declare class GhostCursorController {
+    private readonly previousMouseActionByPage;
+    private readonly cursorApplyQueueByPage;
+    private readonly attachedPages;
+    private readonly logger;
+    constructor(options: {
+        logger: GhostCursorLogger;
+    });
+    resolveRecordingTargetPage(options: {
+        context: BrowserContext;
+        defaultPage: Page;
+        target?: RecordingTargetOptions;
+    }): Page;
+    /** Wire onMouseAction. Idempotent. */
+    attachToPage(options: {
+        page: Page;
+    }): void;
+    detachFromPage(options: {
+        page: Page;
+    }): void;
+    show(options: {
+        page: Page;
+        cursorOptions?: GhostCursorClientOptions;
+    }): Promise<void>;
+    hide(options: {
+        page: Page;
+    }): Promise<void>;
+}
+export {};
+//# sourceMappingURL=ghost-cursor-controller.d.ts.map

package/dist/ghost-cursor-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ghost-cursor-controller.d.ts","sourceRoot":"","sources":["../src/ghost-cursor-controller.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAA;AACnE,OAAO,EAIL,KAAK,wBAAwB,EAC9B,MAAM,mBAAmB,CAAA;AAE1B,UAAU,iBAAiB;IACzB,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;CACpC;AAED,UAAU,sBAAsB;IAC9B,IAAI,CAAC,EAAE,IAAI,CAAA;IACX,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAA6C;IACvF,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAqC;IAC5E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsB;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;gBAE9B,OAAO,EAAE;QAAE,MAAM,EAAE,iBAAiB,CAAA;KAAE;IAIlD,0BAA0B,CAAC,OAAO,EAAE;QAClC,OAAO,EAAE,cAAc,CAAA;QACvB,WAAW,EAAE,IAAI,CAAA;QACjB,MAAM,CAAC,EAAE,sBAAsB,CAAA;KAChC,GAAG,IAAI;IAoBR,sCAAsC;IACtC,YAAY,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,GAAG,IAAI;IAwC3C,cAAc,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,GAAG,IAAI;IAWvC,IAAI,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,aAAa,CAAC,EAAE,wBAAwB,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAStF,IAAI,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAQnD"}

package/dist/ghost-cursor-controller.js

@@ -0,0 +1,98 @@
+/**
+ * Always-on ghost cursor controller (Node side).
+ *
+ * Wires page.onMouseAction → applyGhostCursorMouseAction for every page.
+ * Chains with any pre-existing onMouseAction callback. Cursor-apply is
+ * fire-and-forget via a per-page queue so it does not block action completion.
+ */
+import { applyGhostCursorMouseAction, disableGhostCursor, enableGhostCursor, } from './ghost-cursor.js';
+export class GhostCursorController {
+    previousMouseActionByPage = new WeakMap();
+    cursorApplyQueueByPage = new WeakMap();
+    attachedPages = new WeakSet();
+    logger;
+    constructor(options) {
+        this.logger = options.logger;
+    }
+    resolveRecordingTargetPage(options) {
+        const { context, defaultPage, target } = options;
+        if (target?.page) {
+            return target.page;
+        }
+        if (target?.sessionId) {
+            const pageForSession = context.pages().find((candidatePage) => {
+                return candidatePage.sessionId() === target.sessionId;
+            });
+            if (pageForSession) {
+                return pageForSession;
+            }
+        }
+        return defaultPage;
+    }
+    /** Wire onMouseAction. Idempotent. */
+    attachToPage(options) {
+        const { page } = options;
+        if (this.attachedPages.has(page)) {
+            return;
+        }
+        this.attachedPages.add(page);
+        if (!this.previousMouseActionByPage.has(page)) {
+            this.previousMouseActionByPage.set(page, page.onMouseAction);
+        }
+        const previousMouseAction = this.previousMouseActionByPage.get(page);
+        page.onMouseAction = async (event) => {
+            // Ghost cursor must never crash the main Playwright action (click, move, etc).
+            // Wrap the entire cursor logic in try/catch so errors stay cosmetic.
+            try {
+                const pendingCursorApply = this.cursorApplyQueueByPage.get(page) || Promise.resolve();
+                const nextCursorApply = pendingCursorApply
+                    .then(async () => {
+                    await applyGhostCursorMouseAction({ page, event });
+                })
+                    .catch((error) => {
+                    if (page.isClosed()) {
+                        return;
+                    }
+                    this.logger.error('[tabwright] Failed to apply ghost cursor action', error);
+                });
+                this.cursorApplyQueueByPage.set(page, nextCursorApply);
+            }
+            catch (error) {
+                this.logger.error('[tabwright] Ghost cursor onMouseAction error (non-fatal)', error);
+            }
+            if (!previousMouseAction) {
+                return;
+            }
+            await previousMouseAction(event);
+        };
+    }
+    detachFromPage(options) {
+        const { page } = options;
+        if (!this.attachedPages.has(page)) {
+            return;
+        }
+        this.attachedPages.delete(page);
+        page.onMouseAction = this.previousMouseActionByPage.get(page) ?? null;
+        this.previousMouseActionByPage.delete(page);
+        this.cursorApplyQueueByPage.delete(page);
+    }
+    async show(options) {
+        try {
+            const { page, cursorOptions } = options;
+            await enableGhostCursor({ page, cursorOptions });
+        }
+        catch {
+            // Non-fatal — page may be closing or navigating.
+        }
+    }
+    async hide(options) {
+        try {
+            const { page } = options;
+            await disableGhostCursor({ page });
+        }
+        catch {
+            // Non-fatal — page may be closing or navigating.
+        }
+    }
+}
+//# sourceMappingURL=ghost-cursor-controller.js.map

package/dist/ghost-cursor-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ghost-cursor-controller.js","sourceRoot":"","sources":["../src/ghost-cursor-controller.ts"],"names":[],"mappings":"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"}

package/dist/ghost-cursor.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Node-side ghost cursor helpers.
+ * Injects the browser bundle and forwards mouse action events to the page overlay.
+ */
+import type { Page, MouseActionEvent } from '@xmorse/playwright-core';
+export interface GhostCursorClientOptions {
+    style?: 'minimal' | 'dot' | 'screenstudio';
+    color?: string;
+    size?: number;
+    zIndex?: number;
+    easing?: string;
+    minDurationMs?: number;
+    maxDurationMs?: number;
+    speedPxPerMs?: number;
+}
+export declare function enableGhostCursor(options: {
+    page: Page;
+    cursorOptions?: GhostCursorClientOptions;
+}): Promise<void>;
+export declare function disableGhostCursor(options: {
+    page: Page;
+}): Promise<void>;
+export declare function applyGhostCursorMouseAction(options: {
+    page: Page;
+    event: MouseActionEvent;
+}): Promise<void>;
+//# sourceMappingURL=ghost-cursor.d.ts.map

package/dist/ghost-cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ghost-cursor.d.ts","sourceRoot":"","sources":["../src/ghost-cursor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAErE,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,cAAc,CAAA;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAmCD,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,IAAI,EAAE,IAAI,CAAA;IACV,aAAa,CAAC,EAAE,wBAAwB,CAAA;CACzC,GAAG,OAAO,CAAC,IAAI,CAAC,CAehB;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAU/E;AAED,wBAAsB,2BAA2B,CAAC,OAAO,EAAE;IACzD,IAAI,EAAE,IAAI,CAAA;IACV,KAAK,EAAE,gBAAgB,CAAA;CACxB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiChB"}

package/dist/ghost-cursor.js

@@ -0,0 +1,79 @@
+/**
+ * Node-side ghost cursor helpers.
+ * Injects the browser bundle and forwards mouse action events to the page overlay.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+let ghostCursorCode = null;
+function getGhostCursorCode() {
+    if (ghostCursorCode) {
+        return ghostCursorCode;
+    }
+    const currentDir = path.dirname(fileURLToPath(import.meta.url));
+    const bundlePath = path.join(currentDir, '..', 'dist', 'ghost-cursor-client.js');
+    ghostCursorCode = fs.readFileSync(bundlePath, 'utf-8');
+    return ghostCursorCode;
+}
+async function ensureGhostCursorInjected(options) {
+    const { page } = options;
+    const hasGhostCursor = await page.evaluate(() => {
+        return Boolean(globalThis.__playwriterGhostCursor);
+    });
+    if (hasGhostCursor) {
+        return;
+    }
+    const code = getGhostCursorCode();
+    await page.evaluate(code);
+}
+export async function enableGhostCursor(options) {
+    try {
+        const { page, cursorOptions } = options;
+        await ensureGhostCursorInjected({ page });
+        await page.evaluate(({ optionsFromNode }) => {
+            const api = globalThis.__playwriterGhostCursor;
+            api?.enable(optionsFromNode);
+        }, { optionsFromNode: cursorOptions });
+    }
+    catch {
+        // Non-fatal — page may be closed or navigating.
+    }
+}
+export async function disableGhostCursor(options) {
+    try {
+        const { page } = options;
+        await page.evaluate(() => {
+            const api = globalThis.__playwriterGhostCursor;
+            api?.disable();
+        });
+    }
+    catch {
+        // Non-fatal — page may be closed or navigating.
+    }
+}
+export async function applyGhostCursorMouseAction(options) {
+    // Never throw — the cursor is cosmetic and must not break the caller's action.
+    try {
+        const { page, event } = options;
+        const applied = await page.evaluate(({ serializedEvent }) => {
+            const api = globalThis.__playwriterGhostCursor;
+            if (!api) {
+                return false;
+            }
+            api.applyMouseAction(serializedEvent);
+            return true;
+        }, { serializedEvent: event });
+        if (applied) {
+            return;
+        }
+        await ensureGhostCursorInjected({ page });
+        await page.evaluate(({ serializedEvent }) => {
+            const api = globalThis.__playwriterGhostCursor;
+            api?.applyMouseAction(serializedEvent);
+        }, { serializedEvent: event });
+    }
+    catch {
+        // Swallow — page may be closed, navigating, or debugger detached.
+    }
+}
+//# sourceMappingURL=ghost-cursor.js.map

package/dist/ghost-cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ghost-cursor.js","sourceRoot":"","sources":["../src/ghost-cursor.ts"],"names":[],"mappings":"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"}

package/dist/htmlrewrite.d.ts

@@ -0,0 +1,8 @@
+export interface FormatHtmlOptions {
+    html: string;
+    keepStyles?: boolean;
+    maxAttrLen?: number;
+    maxContentLen?: number;
+}
+export declare function formatHtmlForPrompt({ html, keepStyles, maxAttrLen, maxContentLen, }: FormatHtmlOptions): Promise<string>;
+//# sourceMappingURL=htmlrewrite.d.ts.map

package/dist/htmlrewrite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"htmlrewrite.d.ts","sourceRoot":"","sources":["../src/htmlrewrite.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,wBAAsB,mBAAmB,CAAC,EACxC,IAAI,EACJ,UAAkB,EAClB,UAAgB,EAChB,aAAmB,GACpB,EAAE,iBAAiB,mBAsXnB"}