@humanjs/playwright 0.9.0 → 0.10.0

package/dist/index.cjs

@@ -1,104 +1,108 @@
 'use strict';
 
-var chunk3X36PFTS_cjs = require('./chunk-3X36PFTS.cjs');
+var chunk665R4N7R_cjs = require('./chunk-665R4N7R.cjs');
 
 
 
 Object.defineProperty(exports, "Recording", {
   enumerable: true,
-  get: function () { return chunk3X36PFTS_cjs.Recording; }
+  get: function () { return chunk665R4N7R_cjs.Recording; }
 });
 Object.defineProperty(exports, "applyMicroJitter", {
   enumerable: true,
-  get: function () { return chunk3X36PFTS_cjs.applyMicroJitter; }
+  get: function () { return chunk665R4N7R_cjs.applyMicroJitter; }
 });
 Object.defineProperty(exports, "applyVelocityProfile", {
   enumerable: true,
-  get: function () { return chunk3X36PFTS_cjs.applyVelocityProfile; }
+  get: function () { return chunk665R4N7R_cjs.applyVelocityProfile; }
 });
 Object.defineProperty(exports, "bezierPath", {
   enumerable: true,
-  get: function () { return chunk3X36PFTS_cjs.bezierPath; }
+  get: function () { return chunk665R4N7R_cjs.bezierPath; }
 });
 Object.defineProperty(exports, "blend", {
   enumerable: true,
-  get: function () { return chunk3X36PFTS_cjs.blend; }
+  get: function () { return chunk665R4N7R_cjs.blend; }
 });
 Object.defineProperty(exports, "careful", {
   enumerable: true,
-  get: function () { return chunk3X36PFTS_cjs.careful; }
+  get: function () { return chunk665R4N7R_cjs.careful; }
 });
 Object.defineProperty(exports, "chromium", {
   enumerable: true,
-  get: function () { return chunk3X36PFTS_cjs.chromium; }
+  get: function () { return chunk665R4N7R_cjs.chromium; }
 });
 Object.defineProperty(exports, "computeReadingDwellMs", {
   enumerable: true,
-  get: function () { return chunk3X36PFTS_cjs.computeReadingDwellMs; }
+  get: function () { return chunk665R4N7R_cjs.computeReadingDwellMs; }
 });
 Object.defineProperty(exports, "countWords", {
   enumerable: true,
-  get: function () { return chunk3X36PFTS_cjs.countWords; }
+  get: function () { return chunk665R4N7R_cjs.countWords; }
 });
 Object.defineProperty(exports, "createHuman", {
   enumerable: true,
-  get: function () { return chunk3X36PFTS_cjs.createHuman; }
+  get: function () { return chunk665R4N7R_cjs.createHuman; }
 });
 Object.defineProperty(exports, "createRng", {
   enumerable: true,
-  get: function () { return chunk3X36PFTS_cjs.createRng; }
+  get: function () { return chunk665R4N7R_cjs.createRng; }
 });
 Object.defineProperty(exports, "distracted", {
   enumerable: true,
-  get: function () { return chunk3X36PFTS_cjs.distracted; }
+  get: function () { return chunk665R4N7R_cjs.distracted; }
 });
 Object.defineProperty(exports, "fast", {
   enumerable: true,
-  get: function () { return chunk3X36PFTS_cjs.fast; }
+  get: function () { return chunk665R4N7R_cjs.fast; }
 });
 Object.defineProperty(exports, "firefox", {
   enumerable: true,
-  get: function () { return chunk3X36PFTS_cjs.firefox; }
+  get: function () { return chunk665R4N7R_cjs.firefox; }
 });
 Object.defineProperty(exports, "generateHumanJS", {
   enumerable: true,
-  get: function () { return chunk3X36PFTS_cjs.generateHumanJS; }
+  get: function () { return chunk665R4N7R_cjs.generateHumanJS; }
 });
 Object.defineProperty(exports, "generatePlaywrightTest", {
   enumerable: true,
-  get: function () { return chunk3X36PFTS_cjs.generatePlaywrightTest; }
+  get: function () { return chunk665R4N7R_cjs.generatePlaywrightTest; }
 });
 Object.defineProperty(exports, "humanizePath", {
   enumerable: true,
-  get: function () { return chunk3X36PFTS_cjs.humanizePath; }
+  get: function () { return chunk665R4N7R_cjs.humanizePath; }
 });
 Object.defineProperty(exports, "installMouseHelper", {
   enumerable: true,
-  get: function () { return chunk3X36PFTS_cjs.installMouseHelper; }
+  get: function () { return chunk665R4N7R_cjs.installMouseHelper; }
 });
 Object.defineProperty(exports, "planScroll", {
   enumerable: true,
-  get: function () { return chunk3X36PFTS_cjs.planScroll; }
+  get: function () { return chunk665R4N7R_cjs.planScroll; }
 });
 Object.defineProperty(exports, "planTypeKeystrokes", {
   enumerable: true,
-  get: function () { return chunk3X36PFTS_cjs.planTypeKeystrokes; }
+  get: function () { return chunk665R4N7R_cjs.planTypeKeystrokes; }
 });
 Object.defineProperty(exports, "precise", {
   enumerable: true,
-  get: function () { return chunk3X36PFTS_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 chunk3X36PFTS_cjs.resolvePersonality; }
+  get: function () { return chunk665R4N7R_cjs.resolvePersonality; }
 });
 Object.defineProperty(exports, "sleep", {
   enumerable: true,
-  get: function () { return chunk3X36PFTS_cjs.sleep; }
+  get: function () { return chunk665R4N7R_cjs.sleep; }
 });
 Object.defineProperty(exports, "webkit", {
   enumerable: true,
-  get: function () { return chunk3X36PFTS_cjs.webkit; }
+  get: function () { return chunk665R4N7R_cjs.webkit; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.d.cts

@@ -221,6 +221,57 @@ interface PlaywrightTestOptions {
  */
 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
  * ffmpeg encode settings used to assemble them into a video.
@@ -1031,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 SelectTextOptions, type Speed, type Timeline, type TimelineEvent, type ToGifOptions, type ToVideoOptions, type UploadFiles, createHuman, generateHumanJS, generatePlaywrightTest, 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

@@ -221,6 +221,57 @@ interface PlaywrightTestOptions {
  */
 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
  * ffmpeg encode settings used to assemble them into a video.
@@ -1031,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 SelectTextOptions, type Speed, type Timeline, type TimelineEvent, type ToGifOptions, type ToVideoOptions, type UploadFiles, createHuman, generateHumanJS, generatePlaywrightTest, 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, generateHumanJS, generatePlaywrightTest, humanizePath, installMouseHelper, planScroll, planTypeKeystrokes, precise, resolvePersonality, sleep, webkit } from './chunk-3TXDODCO.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,12 +1,12 @@
 'use strict';
 
-var chunk3X36PFTS_cjs = require('./chunk-3X36PFTS.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 chunk3X36PFTS_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,

package/dist/test.js

@@ -1,4 +1,4 @@
-import { createHuman } from './chunk-3TXDODCO.js';
+import { createHuman } from './chunk-I2PQGZU7.js';
 import { test as test$1 } from '@playwright/test';
 export { expect } from '@playwright/test';
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@humanjs/playwright",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Humanize Playwright sessions for AI agents, QA tests, and demos.",
   "keywords": [
     "humanjs",