@humanjs/playwright 0.8.0 → 0.10.0

package/dist/index.cjs

@@ -1,96 +1,108 @@
 'use strict';
 
-var chunkRCMSDC3N_cjs = require('./chunk-RCMSDC3N.cjs');
+var chunk665R4N7R_cjs = require('./chunk-665R4N7R.cjs');
 
 
 
 Object.defineProperty(exports, "Recording", {
   enumerable: true,
-  get: function () { return chunkRCMSDC3N_cjs.Recording; }
+  get: function () { return chunk665R4N7R_cjs.Recording; }
 });
 Object.defineProperty(exports, "applyMicroJitter", {
   enumerable: true,
-  get: function () { return chunkRCMSDC3N_cjs.applyMicroJitter; }
+  get: function () { return chunk665R4N7R_cjs.applyMicroJitter; }
 });
 Object.defineProperty(exports, "applyVelocityProfile", {
   enumerable: true,
-  get: function () { return chunkRCMSDC3N_cjs.applyVelocityProfile; }
+  get: function () { return chunk665R4N7R_cjs.applyVelocityProfile; }
 });
 Object.defineProperty(exports, "bezierPath", {
   enumerable: true,
-  get: function () { return chunkRCMSDC3N_cjs.bezierPath; }
+  get: function () { return chunk665R4N7R_cjs.bezierPath; }
 });
 Object.defineProperty(exports, "blend", {
   enumerable: true,
-  get: function () { return chunkRCMSDC3N_cjs.blend; }
+  get: function () { return chunk665R4N7R_cjs.blend; }
 });
 Object.defineProperty(exports, "careful", {
   enumerable: true,
-  get: function () { return chunkRCMSDC3N_cjs.careful; }
+  get: function () { return chunk665R4N7R_cjs.careful; }
 });
 Object.defineProperty(exports, "chromium", {
   enumerable: true,
-  get: function () { return chunkRCMSDC3N_cjs.chromium; }
+  get: function () { return chunk665R4N7R_cjs.chromium; }
 });
 Object.defineProperty(exports, "computeReadingDwellMs", {
   enumerable: true,
-  get: function () { return chunkRCMSDC3N_cjs.computeReadingDwellMs; }
+  get: function () { return chunk665R4N7R_cjs.computeReadingDwellMs; }
 });
 Object.defineProperty(exports, "countWords", {
   enumerable: true,
-  get: function () { return chunkRCMSDC3N_cjs.countWords; }
+  get: function () { return chunk665R4N7R_cjs.countWords; }
 });
 Object.defineProperty(exports, "createHuman", {
   enumerable: true,
-  get: function () { return chunkRCMSDC3N_cjs.createHuman; }
+  get: function () { return chunk665R4N7R_cjs.createHuman; }
 });
 Object.defineProperty(exports, "createRng", {
   enumerable: true,
-  get: function () { return chunkRCMSDC3N_cjs.createRng; }
+  get: function () { return chunk665R4N7R_cjs.createRng; }
 });
 Object.defineProperty(exports, "distracted", {
   enumerable: true,
-  get: function () { return chunkRCMSDC3N_cjs.distracted; }
+  get: function () { return chunk665R4N7R_cjs.distracted; }
 });
 Object.defineProperty(exports, "fast", {
   enumerable: true,
-  get: function () { return chunkRCMSDC3N_cjs.fast; }
+  get: function () { return chunk665R4N7R_cjs.fast; }
 });
 Object.defineProperty(exports, "firefox", {
   enumerable: true,
-  get: function () { return chunkRCMSDC3N_cjs.firefox; }
+  get: function () { return chunk665R4N7R_cjs.firefox; }
+});
+Object.defineProperty(exports, "generateHumanJS", {
+  enumerable: true,
+  get: function () { return chunk665R4N7R_cjs.generateHumanJS; }
+});
+Object.defineProperty(exports, "generatePlaywrightTest", {
+  enumerable: true,
+  get: function () { return chunk665R4N7R_cjs.generatePlaywrightTest; }
 });
 Object.defineProperty(exports, "humanizePath", {
   enumerable: true,
-  get: function () { return chunkRCMSDC3N_cjs.humanizePath; }
+  get: function () { return chunk665R4N7R_cjs.humanizePath; }
 });
 Object.defineProperty(exports, "installMouseHelper", {
   enumerable: true,
-  get: function () { return chunkRCMSDC3N_cjs.installMouseHelper; }
+  get: function () { return chunk665R4N7R_cjs.installMouseHelper; }
 });
 Object.defineProperty(exports, "planScroll", {
   enumerable: true,
-  get: function () { return chunkRCMSDC3N_cjs.planScroll; }
+  get: function () { return chunk665R4N7R_cjs.planScroll; }
 });
 Object.defineProperty(exports, "planTypeKeystrokes", {
   enumerable: true,
-  get: function () { return chunkRCMSDC3N_cjs.planTypeKeystrokes; }
+  get: function () { return chunk665R4N7R_cjs.planTypeKeystrokes; }
 });
 Object.defineProperty(exports, "precise", {
   enumerable: true,
-  get: function () { return chunkRCMSDC3N_cjs.precise; }
+  get: function () { return chunk665R4N7R_cjs.precise; }
+});
+Object.defineProperty(exports, "replayTimeline", {
+  enumerable: true,
+  get: function () { return chunk665R4N7R_cjs.replayTimeline; }
 });
 Object.defineProperty(exports, "resolvePersonality", {
   enumerable: true,
-  get: function () { return chunkRCMSDC3N_cjs.resolvePersonality; }
+  get: function () { return chunk665R4N7R_cjs.resolvePersonality; }
 });
 Object.defineProperty(exports, "sleep", {
   enumerable: true,
-  get: function () { return chunkRCMSDC3N_cjs.sleep; }
+  get: function () { return chunk665R4N7R_cjs.sleep; }
 });
 Object.defineProperty(exports, "webkit", {
   enumerable: true,
-  get: function () { return chunkRCMSDC3N_cjs.webkit; }
+  get: function () { return chunk665R4N7R_cjs.webkit; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.d.cts

@@ -81,6 +81,22 @@ interface PressResult {
     readonly dispatched: string;
 }
 
+/** Options for {@link installMouseHelper}. */
+interface InstallMouseHelperOptions {
+    /** Cursor fill color. Defaults to the HumanJS amber `#f5a55c`. */
+    readonly color?: string;
+    /** Cursor visual size in pixels. Defaults to 22. */
+    readonly size?: number;
+    /**
+     * Render a ripple at each `mousedown` position so clicks read on video.
+     * Defaults to `true`.
+     */
+    readonly showClicks?: boolean;
+    /** Halo opacity behind the cursor. Defaults to `0.18`. */
+    readonly haloOpacity?: number;
+}
+declare function installMouseHelper(target: BrowserContext | Page, options?: InstallMouseHelperOptions): Promise<void>;
+
 /**
  * What to read:
  *  - `string`: a Playwright-compatible selector (matches `click()` / `type()`).
@@ -168,6 +184,12 @@ interface CaptureResult {
     cleanup(): Promise<void>;
 }
 
+/**
+ * Generates a standalone, runnable HumanJS script that replays the recorded
+ * session. String selectors round-trip verbatim; raw coordinates and
+ * un-captured inputs are emitted with a flag so they're easy to fix up.
+ */
+declare function generateHumanJS(timeline: Timeline): string;
 /** Options for {@link generatePlaywrightTest} / `Recording.toPlaywright`. */
 interface PlaywrightTestOptions {
     /**
@@ -189,6 +211,66 @@ interface PlaywrightTestOptions {
      */
     readonly baseUrl?: boolean;
 }
+/**
+ * Generates a `@playwright/test` spec that replays the session through
+ * HumanJS — a humanized test, not raw Playwright, since the humanization is
+ * the point. Uses the `@humanjs/playwright/test` fixture for the `human`
+ * (recorded personality / seed / speed applied via `test.use({ humanOptions })`),
+ * runs instant in CI / recorded speed locally, drops timing `sleep()`s by
+ * default, and derives the assertions it safely can.
+ */
+declare function generatePlaywrightTest(timeline: Timeline, options?: PlaywrightTestOptions): string;
+
+/** Progress callback payload, fired as each step starts and settles. */
+interface ReplayStepUpdate {
+    readonly index: number;
+    readonly type: string;
+    readonly status: 'running' | 'pass' | 'fail';
+    readonly error?: string;
+}
+/** Outcome of a single replayed step. */
+interface ReplayStepResult {
+    readonly index: number;
+    readonly type: string;
+    readonly status: 'pass' | 'fail';
+    readonly error?: string;
+}
+/** Outcome of a {@link replayTimeline} run. */
+interface ReplayResult {
+    readonly status: 'pass' | 'fail';
+    readonly steps: readonly ReplayStepResult[];
+    /** Index of the failing step, when `status` is `'fail'`. */
+    readonly failedIndex?: number;
+    readonly durationMs: number;
+}
+/** Options for {@link replayTimeline}. */
+interface ReplayOptions {
+    /** Personality for the replay session. Defaults to `'careful'`. */
+    readonly personality?: PersonalityConfig;
+    /** Speed mode. Defaults to `'human'` so the replay is watchable. */
+    readonly speed?: Speed;
+    /** Seed for deterministic motion. */
+    readonly seed?: number | string;
+    /** Cursor overlay, forwarded to `createHuman` (on by default). */
+    readonly cursor?: boolean | InstallMouseHelperOptions;
+    /** Called as each step starts (`running`) and settles (`pass` / `fail`). */
+    readonly onStep?: (update: ReplayStepUpdate) => void;
+    /** Abort an in-flight replay (checked between steps); rejects with an `AbortError`. */
+    readonly signal?: AbortSignal;
+}
+/**
+ * Replay a recorded {@link Timeline} against a live `page`, driving it through
+ * the same humanized primitives the exported test uses. Runs each event in
+ * order and reports per-step pass/fail; **stops at the first failure** (like a
+ * real test). `assert` events are checked with plain Playwright APIs — there's
+ * no `@playwright/test` dependency — so they approximate `expect` without its
+ * auto-retry on text/url.
+ *
+ * Always resolves with a {@link ReplayResult}; a thrown error means the run
+ * itself broke (page closed, or the `signal` aborted → `AbortError`), not a
+ * step failure. The caller owns `page`'s lifecycle.
+ */
+declare function replayTimeline(page: Page, timeline: Timeline | readonly TimelineEvent[], options?: ReplayOptions): Promise<ReplayResult>;
 
 /**
  * Encoding quality preset. Picks the per-frame capture quality + the
@@ -463,22 +545,15 @@ interface ScrollResult {
     readonly durationMs: number;
 }
 
-/** Options for {@link installMouseHelper}. */
-interface InstallMouseHelperOptions {
-    /** Cursor fill color. Defaults to the HumanJS amber `#f5a55c`. */
-    readonly color?: string;
-    /** Cursor visual size in pixels. Defaults to 22. */
-    readonly size?: number;
+/** Options for {@link Human.selectText}. */
+interface SelectTextOptions {
     /**
-     * Render a ripple at each `mousedown` position so clicks read on video.
-     * Defaults to `true`.
+     * Select only this substring of the element's text instead of all of it.
+     * Located inside the element whitespace-tolerantly (first match); falls back
+     * to selecting the whole element when not found.
      */
-    readonly showClicks?: boolean;
-    /** Halo opacity behind the cursor. Defaults to `0.18`. */
-    readonly haloOpacity?: number;
+    text?: string;
 }
-declare function installMouseHelper(target: BrowserContext | Page, options?: InstallMouseHelperOptions): Promise<void>;
-
 /**
  * How fast the humanized session runs.
  * - `'human'` — full humanization (default)
@@ -496,6 +571,14 @@ interface CreateHumanOptions {
     readonly speed?: Speed;
     /** Plugins installed on this session, invoked in registration order. */
     readonly plugins?: readonly HumanPlugin[];
+    /**
+     * Visual cursor overlay ({@link installMouseHelper}) so humanized motion is
+     * visible in headed runs and recordings. **On by default.** Pass `false` to
+     * opt out — do this for `speed: 'instant'` / CI, where there's no motion to
+     * show and the injected cursor would land in test DOM and screenshots. Pass
+     * an options object to style it (color, size, …).
+     */
+    readonly cursor?: boolean | InstallMouseHelperOptions;
     /**
      * Starting cursor position used as the origin of the first humanized path.
      * Defaults to `{ x: 0, y: 0 }`. Set this if you've already moved the cursor
@@ -666,6 +749,23 @@ interface Human {
      * In `speed: 'instant'`, sets the value with no cursor motion.
      */
     selectOption(target: Locator | string, values: SelectOptionValues): Promise<string[]>;
+    /**
+     * Select text inside `target` (a paragraph, heading, input, …). The cursor
+     * moves to the element (humanized), then the text is highlighted — the
+     * "select this" gesture before copying, replacing, or triggering a highlight
+     * menu.
+     *
+     * By default the element's whole text is selected. Pass `{ text }` to select
+     * just that substring: HumanJS finds it inside the element (whitespace-
+     * tolerant, mapped to exact offsets, first match) and selects only that
+     * range — so a recorded partial highlight reproduces as itself, not the whole
+     * element. If the text can't be located, it falls back to selecting all of
+     * the element.
+     *
+     * `target` is element-bound (selector or `Locator`). In `speed: 'instant'`
+     * the cursor motion is skipped; the selection is still applied.
+     */
+    selectText(target: Locator | string, options?: SelectTextOptions): Promise<void>;
     /**
      * Attach file(s) to a file-input `target`. The cursor moves to the control
      * (visible in recordings / the overlay), then the files are attached via
@@ -982,4 +1082,4 @@ interface HumanRecordOptions {
  */
 declare function createHuman(page: Page, options?: CreateHumanOptions): Promise<Human>;
 
-export { type CreateHumanOptions, type FfmpegPreset, type FfmpegTune, type Human, type HumanRecordOptions, type InstallMouseHelperOptions, type KeyModifier, type KeyName, type KeyOrChord, type MouseTarget, type PlaywrightTestOptions, type PressResult, type ReadOptions, type ReadResult, type ReadTarget, Recording, type RecordingQuality, type ScrollOptions, type ScrollResult, type ScrollTarget, type SelectOptionValues, type Speed, type Timeline, type TimelineEvent, type ToGifOptions, type ToVideoOptions, type UploadFiles, createHuman, installMouseHelper };
+export { type CreateHumanOptions, type FfmpegPreset, type FfmpegTune, type Human, type HumanRecordOptions, type InstallMouseHelperOptions, type KeyModifier, type KeyName, type KeyOrChord, type MouseTarget, type PlaywrightTestOptions, type PressResult, type ReadOptions, type ReadResult, type ReadTarget, Recording, type RecordingQuality, type ReplayOptions, type ReplayResult, type ReplayStepResult, type ReplayStepUpdate, type ScrollOptions, type ScrollResult, type ScrollTarget, type SelectOptionValues, type SelectTextOptions, type Speed, type Timeline, type TimelineEvent, type ToGifOptions, type ToVideoOptions, type UploadFiles, createHuman, generateHumanJS, generatePlaywrightTest, installMouseHelper, replayTimeline };

package/dist/index.d.ts

@@ -81,6 +81,22 @@ interface PressResult {
     readonly dispatched: string;
 }
 
+/** Options for {@link installMouseHelper}. */
+interface InstallMouseHelperOptions {
+    /** Cursor fill color. Defaults to the HumanJS amber `#f5a55c`. */
+    readonly color?: string;
+    /** Cursor visual size in pixels. Defaults to 22. */
+    readonly size?: number;
+    /**
+     * Render a ripple at each `mousedown` position so clicks read on video.
+     * Defaults to `true`.
+     */
+    readonly showClicks?: boolean;
+    /** Halo opacity behind the cursor. Defaults to `0.18`. */
+    readonly haloOpacity?: number;
+}
+declare function installMouseHelper(target: BrowserContext | Page, options?: InstallMouseHelperOptions): Promise<void>;
+
 /**
  * What to read:
  *  - `string`: a Playwright-compatible selector (matches `click()` / `type()`).
@@ -168,6 +184,12 @@ interface CaptureResult {
     cleanup(): Promise<void>;
 }
 
+/**
+ * Generates a standalone, runnable HumanJS script that replays the recorded
+ * session. String selectors round-trip verbatim; raw coordinates and
+ * un-captured inputs are emitted with a flag so they're easy to fix up.
+ */
+declare function generateHumanJS(timeline: Timeline): string;
 /** Options for {@link generatePlaywrightTest} / `Recording.toPlaywright`. */
 interface PlaywrightTestOptions {
     /**
@@ -189,6 +211,66 @@ interface PlaywrightTestOptions {
      */
     readonly baseUrl?: boolean;
 }
+/**
+ * Generates a `@playwright/test` spec that replays the session through
+ * HumanJS — a humanized test, not raw Playwright, since the humanization is
+ * the point. Uses the `@humanjs/playwright/test` fixture for the `human`
+ * (recorded personality / seed / speed applied via `test.use({ humanOptions })`),
+ * runs instant in CI / recorded speed locally, drops timing `sleep()`s by
+ * default, and derives the assertions it safely can.
+ */
+declare function generatePlaywrightTest(timeline: Timeline, options?: PlaywrightTestOptions): string;
+
+/** Progress callback payload, fired as each step starts and settles. */
+interface ReplayStepUpdate {
+    readonly index: number;
+    readonly type: string;
+    readonly status: 'running' | 'pass' | 'fail';
+    readonly error?: string;
+}
+/** Outcome of a single replayed step. */
+interface ReplayStepResult {
+    readonly index: number;
+    readonly type: string;
+    readonly status: 'pass' | 'fail';
+    readonly error?: string;
+}
+/** Outcome of a {@link replayTimeline} run. */
+interface ReplayResult {
+    readonly status: 'pass' | 'fail';
+    readonly steps: readonly ReplayStepResult[];
+    /** Index of the failing step, when `status` is `'fail'`. */
+    readonly failedIndex?: number;
+    readonly durationMs: number;
+}
+/** Options for {@link replayTimeline}. */
+interface ReplayOptions {
+    /** Personality for the replay session. Defaults to `'careful'`. */
+    readonly personality?: PersonalityConfig;
+    /** Speed mode. Defaults to `'human'` so the replay is watchable. */
+    readonly speed?: Speed;
+    /** Seed for deterministic motion. */
+    readonly seed?: number | string;
+    /** Cursor overlay, forwarded to `createHuman` (on by default). */
+    readonly cursor?: boolean | InstallMouseHelperOptions;
+    /** Called as each step starts (`running`) and settles (`pass` / `fail`). */
+    readonly onStep?: (update: ReplayStepUpdate) => void;
+    /** Abort an in-flight replay (checked between steps); rejects with an `AbortError`. */
+    readonly signal?: AbortSignal;
+}
+/**
+ * Replay a recorded {@link Timeline} against a live `page`, driving it through
+ * the same humanized primitives the exported test uses. Runs each event in
+ * order and reports per-step pass/fail; **stops at the first failure** (like a
+ * real test). `assert` events are checked with plain Playwright APIs — there's
+ * no `@playwright/test` dependency — so they approximate `expect` without its
+ * auto-retry on text/url.
+ *
+ * Always resolves with a {@link ReplayResult}; a thrown error means the run
+ * itself broke (page closed, or the `signal` aborted → `AbortError`), not a
+ * step failure. The caller owns `page`'s lifecycle.
+ */
+declare function replayTimeline(page: Page, timeline: Timeline | readonly TimelineEvent[], options?: ReplayOptions): Promise<ReplayResult>;
 
 /**
  * Encoding quality preset. Picks the per-frame capture quality + the
@@ -463,22 +545,15 @@ interface ScrollResult {
     readonly durationMs: number;
 }
 
-/** Options for {@link installMouseHelper}. */
-interface InstallMouseHelperOptions {
-    /** Cursor fill color. Defaults to the HumanJS amber `#f5a55c`. */
-    readonly color?: string;
-    /** Cursor visual size in pixels. Defaults to 22. */
-    readonly size?: number;
+/** Options for {@link Human.selectText}. */
+interface SelectTextOptions {
     /**
-     * Render a ripple at each `mousedown` position so clicks read on video.
-     * Defaults to `true`.
+     * Select only this substring of the element's text instead of all of it.
+     * Located inside the element whitespace-tolerantly (first match); falls back
+     * to selecting the whole element when not found.
      */
-    readonly showClicks?: boolean;
-    /** Halo opacity behind the cursor. Defaults to `0.18`. */
-    readonly haloOpacity?: number;
+    text?: string;
 }
-declare function installMouseHelper(target: BrowserContext | Page, options?: InstallMouseHelperOptions): Promise<void>;
-
 /**
  * How fast the humanized session runs.
  * - `'human'` — full humanization (default)
@@ -496,6 +571,14 @@ interface CreateHumanOptions {
     readonly speed?: Speed;
     /** Plugins installed on this session, invoked in registration order. */
     readonly plugins?: readonly HumanPlugin[];
+    /**
+     * Visual cursor overlay ({@link installMouseHelper}) so humanized motion is
+     * visible in headed runs and recordings. **On by default.** Pass `false` to
+     * opt out — do this for `speed: 'instant'` / CI, where there's no motion to
+     * show and the injected cursor would land in test DOM and screenshots. Pass
+     * an options object to style it (color, size, …).
+     */
+    readonly cursor?: boolean | InstallMouseHelperOptions;
     /**
      * Starting cursor position used as the origin of the first humanized path.
      * Defaults to `{ x: 0, y: 0 }`. Set this if you've already moved the cursor
@@ -666,6 +749,23 @@ interface Human {
      * In `speed: 'instant'`, sets the value with no cursor motion.
      */
     selectOption(target: Locator | string, values: SelectOptionValues): Promise<string[]>;
+    /**
+     * Select text inside `target` (a paragraph, heading, input, …). The cursor
+     * moves to the element (humanized), then the text is highlighted — the
+     * "select this" gesture before copying, replacing, or triggering a highlight
+     * menu.
+     *
+     * By default the element's whole text is selected. Pass `{ text }` to select
+     * just that substring: HumanJS finds it inside the element (whitespace-
+     * tolerant, mapped to exact offsets, first match) and selects only that
+     * range — so a recorded partial highlight reproduces as itself, not the whole
+     * element. If the text can't be located, it falls back to selecting all of
+     * the element.
+     *
+     * `target` is element-bound (selector or `Locator`). In `speed: 'instant'`
+     * the cursor motion is skipped; the selection is still applied.
+     */
+    selectText(target: Locator | string, options?: SelectTextOptions): Promise<void>;
     /**
      * Attach file(s) to a file-input `target`. The cursor moves to the control
      * (visible in recordings / the overlay), then the files are attached via
@@ -982,4 +1082,4 @@ interface HumanRecordOptions {
  */
 declare function createHuman(page: Page, options?: CreateHumanOptions): Promise<Human>;
 
-export { type CreateHumanOptions, type FfmpegPreset, type FfmpegTune, type Human, type HumanRecordOptions, type InstallMouseHelperOptions, type KeyModifier, type KeyName, type KeyOrChord, type MouseTarget, type PlaywrightTestOptions, type PressResult, type ReadOptions, type ReadResult, type ReadTarget, Recording, type RecordingQuality, type ScrollOptions, type ScrollResult, type ScrollTarget, type SelectOptionValues, type Speed, type Timeline, type TimelineEvent, type ToGifOptions, type ToVideoOptions, type UploadFiles, createHuman, installMouseHelper };
+export { type CreateHumanOptions, type FfmpegPreset, type FfmpegTune, type Human, type HumanRecordOptions, type InstallMouseHelperOptions, type KeyModifier, type KeyName, type KeyOrChord, type MouseTarget, type PlaywrightTestOptions, type PressResult, type ReadOptions, type ReadResult, type ReadTarget, Recording, type RecordingQuality, type ReplayOptions, type ReplayResult, type ReplayStepResult, type ReplayStepUpdate, type ScrollOptions, type ScrollResult, type ScrollTarget, type SelectOptionValues, type SelectTextOptions, type Speed, type Timeline, type TimelineEvent, type ToGifOptions, type ToVideoOptions, type UploadFiles, createHuman, generateHumanJS, generatePlaywrightTest, installMouseHelper, replayTimeline };

package/dist/index.js

@@ -1,3 +1,3 @@
-export { Recording, applyMicroJitter, applyVelocityProfile, bezierPath, blend, careful, chromium, computeReadingDwellMs, countWords, createHuman, createRng, distracted, fast, firefox, humanizePath, installMouseHelper, planScroll, planTypeKeystrokes, precise, resolvePersonality, sleep, webkit } from './chunk-CCZEDNOF.js';
+export { Recording, applyMicroJitter, applyVelocityProfile, bezierPath, blend, careful, chromium, computeReadingDwellMs, countWords, createHuman, createRng, distracted, fast, firefox, generateHumanJS, generatePlaywrightTest, humanizePath, installMouseHelper, planScroll, planTypeKeystrokes, precise, replayTimeline, resolvePersonality, sleep, webkit } from './chunk-I2PQGZU7.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/test.cjs

@@ -1,16 +1,19 @@
 'use strict';
 
-var chunkRCMSDC3N_cjs = require('./chunk-RCMSDC3N.cjs');
+var chunk665R4N7R_cjs = require('./chunk-665R4N7R.cjs');
 var test$1 = require('@playwright/test');
 
 var test = test$1.test.extend({
   humanOptions: [{}, { option: true }],
   human: async ({ page, humanOptions }, use, testInfo) => {
-    const human = await chunkRCMSDC3N_cjs.createHuman(page, {
+    const human = await chunk665R4N7R_cjs.createHuman(page, {
       // Deterministic per test, CI-fast by default — both overridable since
       // the spread comes last.
       seed: testInfo.title,
       speed: process.env.CI ? "instant" : "human",
+      // No cursor overlay in CI (instant) so it never lands in test DOM or
+      // screenshots; shown locally where you actually watch the run.
+      cursor: !process.env.CI,
       ...humanOptions
     });
     await use(human);

package/dist/test.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/test/index.ts"],"names":["base","createHuman"],"mappings":";;;;;AAyDO,IAAM,IAAA,GAAOA,YAAK,MAAA,CAAqC;AAAA,EAC5D,cAAc,CAAC,IAAI,EAAE,MAAA,EAAQ,MAAM,CAAA;AAAA,EACnC,OAAO,OAAO,EAAE,MAAM,YAAA,EAAa,EAAG,KAAK,QAAA,KAAa;AACtD,IAAA,MAAM,KAAA,GAAQ,MAAMC,6BAAA,CAAY,IAAA,EAAM;AAAA;AAAA;AAAA,MAGpC,MAAM,QAAA,CAAS,KAAA;AAAA,MACf,KAAA,EAAO,OAAA,CAAQ,GAAA,CAAI,EAAA,GAAK,SAAA,GAAY,OAAA;AAAA,MACpC,GAAG;AAAA,KACJ,CAAA;AACD,IAAA,MAAM,IAAI,KAAK,CAAA;AAAA,EACjB;AACF,CAAC","file":"test.cjs","sourcesContent":["/**\n * Playwright Test integration — opt-in via the `@humanjs/playwright/test`\n * subpath. Re-exports `test` / `expect` from `@playwright/test` with a\n * pre-wired `human` fixture, so a spec never hand-rolls `createHuman`.\n *\n * Each test gets a {@link Human} bound to its `page`, **seeded from the test\n * title** (deterministic per test, so snapshots stay stable) and **instant in\n * CI / humanized locally** (fast pipelines, real-pace runs at your desk).\n * Override any of that per-file or per-project with the `humanOptions` option.\n *\n * `@playwright/test` is an optional peer — it's how you run Playwright tests,\n * so the host already provides it. Keeping the fixture on a subpath means the\n * package root never pulls in the test runner.\n *\n * @example\n * ```ts\n * import { test, expect } from '@humanjs/playwright/test';\n *\n * test('checkout', async ({ human, page }) => {\n *   await human.goto('/cart');\n *   await human.click('Checkout');\n *   await expect(page).toHaveURL(/success/);\n * });\n *\n * // Customize for a file (or a whole project via playwright.config.ts):\n * test.use({ humanOptions: { personality: 'distracted', speed: 'human' } });\n * ```\n */\n\nimport { test as base } from '@playwright/test';\nimport { type CreateHumanOptions, createHuman, type Human } from '../index';\n\n/** Test-scoped fixtures added by `@humanjs/playwright/test`. */\nexport interface HumanFixtures {\n  /**\n   * A {@link Human} bound to the test's `page`. Created fresh per test; by\n   * default seeded from the test title and run instant in CI, humanized\n   * locally. Tune via the `humanOptions` option.\n   */\n  human: Human;\n}\n\n/** Option fixture to customize the per-test {@link Human}. */\nexport interface HumanOptions {\n  /**\n   * Options forwarded to `createHuman` for the `human` fixture. Set with\n   * `test.use({ humanOptions: { … } })` (per file) or in `playwright.config.ts`\n   * `use` (per project). Defaults: `seed` = the test title, `speed` =\n   * `'instant'` in CI else `'human'`. Anything you set here overrides those.\n   */\n  humanOptions: CreateHumanOptions;\n}\n\n/**\n * Playwright `test` extended with the `human` fixture. Drop-in replacement\n * for `@playwright/test`'s `test`.\n */\nexport const test = base.extend<HumanFixtures & HumanOptions>({\n  humanOptions: [{}, { option: true }],\n  human: async ({ page, humanOptions }, use, testInfo) => {\n    const human = await createHuman(page, {\n      // Deterministic per test, CI-fast by default — both overridable since\n      // the spread comes last.\n      seed: testInfo.title,\n      speed: process.env.CI ? 'instant' : 'human',\n      ...humanOptions,\n    });\n    await use(human);\n  },\n});\n\nexport { expect } from '@playwright/test';\n"]}
+{"version":3,"sources":["../src/test/index.ts"],"names":["base","createHuman"],"mappings":";;;;;AAyDO,IAAM,IAAA,GAAOA,YAAK,MAAA,CAAqC;AAAA,EAC5D,cAAc,CAAC,IAAI,EAAE,MAAA,EAAQ,MAAM,CAAA;AAAA,EACnC,OAAO,OAAO,EAAE,MAAM,YAAA,EAAa,EAAG,KAAK,QAAA,KAAa;AACtD,IAAA,MAAM,KAAA,GAAQ,MAAMC,6BAAA,CAAY,IAAA,EAAM;AAAA;AAAA;AAAA,MAGpC,MAAM,QAAA,CAAS,KAAA;AAAA,MACf,KAAA,EAAO,OAAA,CAAQ,GAAA,CAAI,EAAA,GAAK,SAAA,GAAY,OAAA;AAAA;AAAA;AAAA,MAGpC,MAAA,EAAQ,CAAC,OAAA,CAAQ,GAAA,CAAI,EAAA;AAAA,MACrB,GAAG;AAAA,KACJ,CAAA;AACD,IAAA,MAAM,IAAI,KAAK,CAAA;AAAA,EACjB;AACF,CAAC","file":"test.cjs","sourcesContent":["/**\n * Playwright Test integration — opt-in via the `@humanjs/playwright/test`\n * subpath. Re-exports `test` / `expect` from `@playwright/test` with a\n * pre-wired `human` fixture, so a spec never hand-rolls `createHuman`.\n *\n * Each test gets a {@link Human} bound to its `page`, **seeded from the test\n * title** (deterministic per test, so snapshots stay stable) and **instant in\n * CI / humanized locally** (fast pipelines, real-pace runs at your desk).\n * Override any of that per-file or per-project with the `humanOptions` option.\n *\n * `@playwright/test` is an optional peer — it's how you run Playwright tests,\n * so the host already provides it. Keeping the fixture on a subpath means the\n * package root never pulls in the test runner.\n *\n * @example\n * ```ts\n * import { test, expect } from '@humanjs/playwright/test';\n *\n * test('checkout', async ({ human, page }) => {\n *   await human.goto('/cart');\n *   await human.click('Checkout');\n *   await expect(page).toHaveURL(/success/);\n * });\n *\n * // Customize for a file (or a whole project via playwright.config.ts):\n * test.use({ humanOptions: { personality: 'distracted', speed: 'human' } });\n * ```\n */\n\nimport { test as base } from '@playwright/test';\nimport { type CreateHumanOptions, createHuman, type Human } from '../index';\n\n/** Test-scoped fixtures added by `@humanjs/playwright/test`. */\nexport interface HumanFixtures {\n  /**\n   * A {@link Human} bound to the test's `page`. Created fresh per test; by\n   * default seeded from the test title and run instant in CI, humanized\n   * locally. Tune via the `humanOptions` option.\n   */\n  human: Human;\n}\n\n/** Option fixture to customize the per-test {@link Human}. */\nexport interface HumanOptions {\n  /**\n   * Options forwarded to `createHuman` for the `human` fixture. Set with\n   * `test.use({ humanOptions: { … } })` (per file) or in `playwright.config.ts`\n   * `use` (per project). Defaults: `seed` = the test title, `speed` =\n   * `'instant'` in CI else `'human'`. Anything you set here overrides those.\n   */\n  humanOptions: CreateHumanOptions;\n}\n\n/**\n * Playwright `test` extended with the `human` fixture. Drop-in replacement\n * for `@playwright/test`'s `test`.\n */\nexport const test = base.extend<HumanFixtures & HumanOptions>({\n  humanOptions: [{}, { option: true }],\n  human: async ({ page, humanOptions }, use, testInfo) => {\n    const human = await createHuman(page, {\n      // Deterministic per test, CI-fast by default — both overridable since\n      // the spread comes last.\n      seed: testInfo.title,\n      speed: process.env.CI ? 'instant' : 'human',\n      // No cursor overlay in CI (instant) so it never lands in test DOM or\n      // screenshots; shown locally where you actually watch the run.\n      cursor: !process.env.CI,\n      ...humanOptions,\n    });\n    await use(human);\n  },\n});\n\nexport { expect } from '@playwright/test';\n"]}

package/dist/test.js

@@ -1,4 +1,4 @@
-import { createHuman } from './chunk-CCZEDNOF.js';
+import { createHuman } from './chunk-I2PQGZU7.js';
 import { test as test$1 } from '@playwright/test';
 export { expect } from '@playwright/test';
 
@@ -10,6 +10,9 @@ var test = test$1.extend({
       // the spread comes last.
       seed: testInfo.title,
       speed: process.env.CI ? "instant" : "human",
+      // No cursor overlay in CI (instant) so it never lands in test DOM or
+      // screenshots; shown locally where you actually watch the run.
+      cursor: !process.env.CI,
       ...humanOptions
     });
     await use(human);

package/dist/test.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/test/index.ts"],"names":["base"],"mappings":";;;;AAyDO,IAAM,IAAA,GAAOA,OAAK,MAAA,CAAqC;AAAA,EAC5D,cAAc,CAAC,IAAI,EAAE,MAAA,EAAQ,MAAM,CAAA;AAAA,EACnC,OAAO,OAAO,EAAE,MAAM,YAAA,EAAa,EAAG,KAAK,QAAA,KAAa;AACtD,IAAA,MAAM,KAAA,GAAQ,MAAM,WAAA,CAAY,IAAA,EAAM;AAAA;AAAA;AAAA,MAGpC,MAAM,QAAA,CAAS,KAAA;AAAA,MACf,KAAA,EAAO,OAAA,CAAQ,GAAA,CAAI,EAAA,GAAK,SAAA,GAAY,OAAA;AAAA,MACpC,GAAG;AAAA,KACJ,CAAA;AACD,IAAA,MAAM,IAAI,KAAK,CAAA;AAAA,EACjB;AACF,CAAC","file":"test.js","sourcesContent":["/**\n * Playwright Test integration — opt-in via the `@humanjs/playwright/test`\n * subpath. Re-exports `test` / `expect` from `@playwright/test` with a\n * pre-wired `human` fixture, so a spec never hand-rolls `createHuman`.\n *\n * Each test gets a {@link Human} bound to its `page`, **seeded from the test\n * title** (deterministic per test, so snapshots stay stable) and **instant in\n * CI / humanized locally** (fast pipelines, real-pace runs at your desk).\n * Override any of that per-file or per-project with the `humanOptions` option.\n *\n * `@playwright/test` is an optional peer — it's how you run Playwright tests,\n * so the host already provides it. Keeping the fixture on a subpath means the\n * package root never pulls in the test runner.\n *\n * @example\n * ```ts\n * import { test, expect } from '@humanjs/playwright/test';\n *\n * test('checkout', async ({ human, page }) => {\n *   await human.goto('/cart');\n *   await human.click('Checkout');\n *   await expect(page).toHaveURL(/success/);\n * });\n *\n * // Customize for a file (or a whole project via playwright.config.ts):\n * test.use({ humanOptions: { personality: 'distracted', speed: 'human' } });\n * ```\n */\n\nimport { test as base } from '@playwright/test';\nimport { type CreateHumanOptions, createHuman, type Human } from '../index';\n\n/** Test-scoped fixtures added by `@humanjs/playwright/test`. */\nexport interface HumanFixtures {\n  /**\n   * A {@link Human} bound to the test's `page`. Created fresh per test; by\n   * default seeded from the test title and run instant in CI, humanized\n   * locally. Tune via the `humanOptions` option.\n   */\n  human: Human;\n}\n\n/** Option fixture to customize the per-test {@link Human}. */\nexport interface HumanOptions {\n  /**\n   * Options forwarded to `createHuman` for the `human` fixture. Set with\n   * `test.use({ humanOptions: { … } })` (per file) or in `playwright.config.ts`\n   * `use` (per project). Defaults: `seed` = the test title, `speed` =\n   * `'instant'` in CI else `'human'`. Anything you set here overrides those.\n   */\n  humanOptions: CreateHumanOptions;\n}\n\n/**\n * Playwright `test` extended with the `human` fixture. Drop-in replacement\n * for `@playwright/test`'s `test`.\n */\nexport const test = base.extend<HumanFixtures & HumanOptions>({\n  humanOptions: [{}, { option: true }],\n  human: async ({ page, humanOptions }, use, testInfo) => {\n    const human = await createHuman(page, {\n      // Deterministic per test, CI-fast by default — both overridable since\n      // the spread comes last.\n      seed: testInfo.title,\n      speed: process.env.CI ? 'instant' : 'human',\n      ...humanOptions,\n    });\n    await use(human);\n  },\n});\n\nexport { expect } from '@playwright/test';\n"]}
+{"version":3,"sources":["../src/test/index.ts"],"names":["base"],"mappings":";;;;AAyDO,IAAM,IAAA,GAAOA,OAAK,MAAA,CAAqC;AAAA,EAC5D,cAAc,CAAC,IAAI,EAAE,MAAA,EAAQ,MAAM,CAAA;AAAA,EACnC,OAAO,OAAO,EAAE,MAAM,YAAA,EAAa,EAAG,KAAK,QAAA,KAAa;AACtD,IAAA,MAAM,KAAA,GAAQ,MAAM,WAAA,CAAY,IAAA,EAAM;AAAA;AAAA;AAAA,MAGpC,MAAM,QAAA,CAAS,KAAA;AAAA,MACf,KAAA,EAAO,OAAA,CAAQ,GAAA,CAAI,EAAA,GAAK,SAAA,GAAY,OAAA;AAAA;AAAA;AAAA,MAGpC,MAAA,EAAQ,CAAC,OAAA,CAAQ,GAAA,CAAI,EAAA;AAAA,MACrB,GAAG;AAAA,KACJ,CAAA;AACD,IAAA,MAAM,IAAI,KAAK,CAAA;AAAA,EACjB;AACF,CAAC","file":"test.js","sourcesContent":["/**\n * Playwright Test integration — opt-in via the `@humanjs/playwright/test`\n * subpath. Re-exports `test` / `expect` from `@playwright/test` with a\n * pre-wired `human` fixture, so a spec never hand-rolls `createHuman`.\n *\n * Each test gets a {@link Human} bound to its `page`, **seeded from the test\n * title** (deterministic per test, so snapshots stay stable) and **instant in\n * CI / humanized locally** (fast pipelines, real-pace runs at your desk).\n * Override any of that per-file or per-project with the `humanOptions` option.\n *\n * `@playwright/test` is an optional peer — it's how you run Playwright tests,\n * so the host already provides it. Keeping the fixture on a subpath means the\n * package root never pulls in the test runner.\n *\n * @example\n * ```ts\n * import { test, expect } from '@humanjs/playwright/test';\n *\n * test('checkout', async ({ human, page }) => {\n *   await human.goto('/cart');\n *   await human.click('Checkout');\n *   await expect(page).toHaveURL(/success/);\n * });\n *\n * // Customize for a file (or a whole project via playwright.config.ts):\n * test.use({ humanOptions: { personality: 'distracted', speed: 'human' } });\n * ```\n */\n\nimport { test as base } from '@playwright/test';\nimport { type CreateHumanOptions, createHuman, type Human } from '../index';\n\n/** Test-scoped fixtures added by `@humanjs/playwright/test`. */\nexport interface HumanFixtures {\n  /**\n   * A {@link Human} bound to the test's `page`. Created fresh per test; by\n   * default seeded from the test title and run instant in CI, humanized\n   * locally. Tune via the `humanOptions` option.\n   */\n  human: Human;\n}\n\n/** Option fixture to customize the per-test {@link Human}. */\nexport interface HumanOptions {\n  /**\n   * Options forwarded to `createHuman` for the `human` fixture. Set with\n   * `test.use({ humanOptions: { … } })` (per file) or in `playwright.config.ts`\n   * `use` (per project). Defaults: `seed` = the test title, `speed` =\n   * `'instant'` in CI else `'human'`. Anything you set here overrides those.\n   */\n  humanOptions: CreateHumanOptions;\n}\n\n/**\n * Playwright `test` extended with the `human` fixture. Drop-in replacement\n * for `@playwright/test`'s `test`.\n */\nexport const test = base.extend<HumanFixtures & HumanOptions>({\n  humanOptions: [{}, { option: true }],\n  human: async ({ page, humanOptions }, use, testInfo) => {\n    const human = await createHuman(page, {\n      // Deterministic per test, CI-fast by default — both overridable since\n      // the spread comes last.\n      seed: testInfo.title,\n      speed: process.env.CI ? 'instant' : 'human',\n      // No cursor overlay in CI (instant) so it never lands in test DOM or\n      // screenshots; shown locally where you actually watch the run.\n      cursor: !process.env.CI,\n      ...humanOptions,\n    });\n    await use(human);\n  },\n});\n\nexport { expect } from '@playwright/test';\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@humanjs/playwright",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "Humanize Playwright sessions for AI agents, QA tests, and demos.",
   "keywords": [
     "humanjs",
@@ -63,7 +63,7 @@
   },
   "dependencies": {
     "ffmpeg-static": "^5.2.0",
-    "@humanjs/core": "0.7.0"
+    "@humanjs/core": "0.8.0"
   },
   "peerDependencies": {
     "playwright": ">=1.49.0",