@humanjs/playwright 0.7.0 → 0.9.0

package/dist/test.cjs

@@ -0,0 +1,29 @@
+'use strict';
+
+var chunk3X36PFTS_cjs = require('./chunk-3X36PFTS.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, {
+      // 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);
+  }
+});
+
+Object.defineProperty(exports, "expect", {
+  enumerable: true,
+  get: function () { return test$1.expect; }
+});
+exports.test = test;
+//# sourceMappingURL=test.cjs.map
+//# sourceMappingURL=test.cjs.map

package/dist/test.cjs.map

@@ -0,0 +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;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.d.cts

@@ -0,0 +1,32 @@
+import * as playwright_test from 'playwright/test';
+import { Human, CreateHumanOptions } from './index.cjs';
+export { expect } from '@playwright/test';
+import '@humanjs/core';
+import 'playwright';
+
+/** Test-scoped fixtures added by `@humanjs/playwright/test`. */
+interface HumanFixtures {
+    /**
+     * A {@link Human} bound to the test's `page`. Created fresh per test; by
+     * default seeded from the test title and run instant in CI, humanized
+     * locally. Tune via the `humanOptions` option.
+     */
+    human: Human;
+}
+/** Option fixture to customize the per-test {@link Human}. */
+interface HumanOptions {
+    /**
+     * Options forwarded to `createHuman` for the `human` fixture. Set with
+     * `test.use({ humanOptions: { … } })` (per file) or in `playwright.config.ts`
+     * `use` (per project). Defaults: `seed` = the test title, `speed` =
+     * `'instant'` in CI else `'human'`. Anything you set here overrides those.
+     */
+    humanOptions: CreateHumanOptions;
+}
+/**
+ * Playwright `test` extended with the `human` fixture. Drop-in replacement
+ * for `@playwright/test`'s `test`.
+ */
+declare const test: playwright_test.TestType<playwright_test.PlaywrightTestArgs & playwright_test.PlaywrightTestOptions & HumanFixtures & HumanOptions, playwright_test.PlaywrightWorkerArgs & playwright_test.PlaywrightWorkerOptions>;
+
+export { type HumanFixtures, type HumanOptions, test };

package/dist/test.d.ts

@@ -0,0 +1,32 @@
+import * as playwright_test from 'playwright/test';
+import { Human, CreateHumanOptions } from './index.js';
+export { expect } from '@playwright/test';
+import '@humanjs/core';
+import 'playwright';
+
+/** Test-scoped fixtures added by `@humanjs/playwright/test`. */
+interface HumanFixtures {
+    /**
+     * A {@link Human} bound to the test's `page`. Created fresh per test; by
+     * default seeded from the test title and run instant in CI, humanized
+     * locally. Tune via the `humanOptions` option.
+     */
+    human: Human;
+}
+/** Option fixture to customize the per-test {@link Human}. */
+interface HumanOptions {
+    /**
+     * Options forwarded to `createHuman` for the `human` fixture. Set with
+     * `test.use({ humanOptions: { … } })` (per file) or in `playwright.config.ts`
+     * `use` (per project). Defaults: `seed` = the test title, `speed` =
+     * `'instant'` in CI else `'human'`. Anything you set here overrides those.
+     */
+    humanOptions: CreateHumanOptions;
+}
+/**
+ * Playwright `test` extended with the `human` fixture. Drop-in replacement
+ * for `@playwright/test`'s `test`.
+ */
+declare const test: playwright_test.TestType<playwright_test.PlaywrightTestArgs & playwright_test.PlaywrightTestOptions & HumanFixtures & HumanOptions, playwright_test.PlaywrightWorkerArgs & playwright_test.PlaywrightWorkerOptions>;
+
+export { type HumanFixtures, type HumanOptions, test };

package/dist/test.js

@@ -0,0 +1,24 @@
+import { createHuman } from './chunk-3TXDODCO.js';
+import { test as test$1 } from '@playwright/test';
+export { expect } from '@playwright/test';
+
+var test = test$1.extend({
+  humanOptions: [{}, { option: true }],
+  human: async ({ page, humanOptions }, use, testInfo) => {
+    const human = await 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);
+  }
+});
+
+export { test };
+//# sourceMappingURL=test.js.map
+//# sourceMappingURL=test.js.map

package/dist/test.js.map

@@ -0,0 +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;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.7.0",
+  "version": "0.9.0",
   "description": "Humanize Playwright sessions for AI agents, QA tests, and demos.",
   "keywords": [
     "humanjs",
@@ -8,7 +8,13 @@
     "humanize",
     "browser-automation",
     "qa",
-    "ai-agents"
+    "ai-agent",
+    "ai-agents",
+    "human-like",
+    "bezier",
+    "typing-rhythm",
+    "e2e-testing",
+    "test-automation"
   ],
   "author": "Gonzalo Muñoz <toti@eventurex.com.ar>",
   "license": "MIT",
@@ -34,6 +40,16 @@
         "default": "./dist/index.cjs"
       }
     },
+    "./test": {
+      "import": {
+        "types": "./dist/test.d.ts",
+        "default": "./dist/test.js"
+      },
+      "require": {
+        "types": "./dist/test.d.cts",
+        "default": "./dist/test.cjs"
+      }
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -47,15 +63,22 @@
   },
   "dependencies": {
     "ffmpeg-static": "^5.2.0",
-    "@humanjs/core": "0.6.0"
+    "@humanjs/core": "0.8.0"
   },
   "peerDependencies": {
-    "playwright": ">=1.40.0"
+    "playwright": ">=1.49.0",
+    "@playwright/test": ">=1.49.0"
+  },
+  "peerDependenciesMeta": {
+    "@playwright/test": {
+      "optional": true
+    }
   },
   "publishConfig": {
     "access": "public"
   },
   "devDependencies": {
+    "@playwright/test": "^1.60.0",
     "playwright": "^1.60.0"
   },
   "scripts": {
@@ -66,6 +89,7 @@
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
     "lint": "biome check .",
+    "check:exports": "publint --strict",
     "clean": "rm -rf dist .turbo"
   }
 }