@seontechnologies/playwright-utils 3.12.0 → 3.13.1

package/README.md

@@ -1,36 +1,38 @@
 # Playwright Utils
 
-A collection of utilities for Playwright tests at SEON Technologies, designed to make testing more efficient and maintainable.
+A collection of utilities for Playwright tests, designed to make testing more efficient and maintainable.
 
-All utilities can be used as Playwright fixtures by importing the test object.
+📚 **[View the full documentation on GitHub Pages](https://seontechnologies.github.io/playwright-utils/)** or browse the [docs folder](./docs)
 
-## Design Principles
+## One Pattern, Two Ways to Use
 
-Why this library was created:
+Every utility follows the same design: **functional core, fixture shell**.
 
-- To bring consistent reusable Playwright utilities to projects at SEON.
-- To implement common testing patterns as **standardized fixtures**, to avoid duplication and boilerplate.
-- To follow a **functional-first** design: the core logic is always a standalone function that can be used directly, while fixtures provide convenience.
-- To support **typed API requests**, **polling patterns**, **auth session management**, **logging**, and **network interception** with clear APIs.
-- To make it easy to adopt and extend the utilities in other projects, without coupling tightly to any single app.
+```typescript
+// Direct function - explicit dependencies
+import { apiRequest } from '@seontechnologies/playwright-utils/api-request'
+const result = await apiRequest({ request, method: 'GET', path: '/api/users' })
+
+// Playwright fixture - injected, ready to use
+test('example', async ({ apiRequest }) => {
+  const result = await apiRequest({ method: 'GET', path: '/api/users' })
+})
+```
 
-Design patterns used:
+Use functions for scripts and simple cases. Use fixtures for test suites.
 
-- **Fixture pattern**: all utilities can be consumed as fixtures to provide maximum flexibility.
-- **Functional core, fixture shell**: utilities can be used both directly and as fixtures.
-- **Decoupled logging and reporting**: logging is built to integrate cleanly into Playwright reports.
-- **Composable auth sessions**: auth session utilities can handle complex multi-user auth in a reusable way.
-- **Test-focused network interception**: network interception is designed for real-world test needs, not just simple mocking.
-- **Typed API request utility**: apiRequest provides a reusable, typed client for API tests and Playwright request fixture usage.
+## Utilities
 
-This library is not a general-purpose Playwright wrapper. It is designed to cover the most common test automation needs at SEON and to serve as a foundation for further project-specific extensions.
+| Category     | Utilities                                                                                                                                                                                          |
+| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Agnostic** | [API Request](./docs/api-request.md), [Auth Session](./docs/auth-session.md), [Recurse](./docs/recurse.md), [Log](./docs/log.md), [File Utils](./docs/file-utils.md), [Burn-in](./docs/burn-in.md) |
+| **Frontend** | [Network Interception](./docs/intercept-network-call.md), [Network Recorder](./docs/network-recorder.md), [Network Error Monitor](./docs/network-error-monitor.md)                                 |
 
 - [Playwright Utils](#playwright-utils)
-  - [Design Principles](#design-principles)
+  - [One Pattern, Two Ways to Use](#one-pattern-two-ways-to-use)
+  - [Utilities](#utilities)
   - [Installation](#installation)
-  - [Module Format Support](#module-format-support)
   - [Development](#development)
-    - [Testing Strategy](#testing-strategy)
   - [Available Utilities](#available-utilities)
     - [API Request](#api-request)
     - [Recurse (Polling)](#recurse-polling)
@@ -42,6 +44,8 @@ This library is not a general-purpose Playwright wrapper. It is designed to cove
     - [Network Recorder](#network-recorder)
     - [Burn-in](#burn-in)
     - [Network Error Monitor](#network-error-monitor)
+  - [Module Format Support](#module-format-support)
+    - [Testing Strategy in this repository](#testing-strategy-in-this-repository)
   - [Testing the Package Locally](#testing-the-package-locally)
   - [Release and Publishing](#release-and-publishing)
     - [Publishing via GitHub UI (Recommended)](#publishing-via-github-ui-recommended)
@@ -56,29 +60,6 @@ pnpm i -D @seontechnologies/playwright-utils
 
 > **Note:** This package requires `@playwright/test` as a peer dependency. It should already be installed in your repository.
 
-## Module Format Support
-
-This package supports both CommonJS and ES Modules formats:
-
-- **CommonJS**: For projects using `require()` syntax or CommonJS module resolution
-- **ES Modules**: For projects using `import` syntax with ES modules
-
-The package automatically detects which format to use based on your project's configuration. This means:
-
-- You can use this package in both legacy CommonJS projects and modern ESM projects
-- No need to change import paths or add file extensions
-- TypeScript type definitions work for both formats
-
-Example usage:
-
-```typescript
-// Works in both CommonJS and ESM environments
-import { log } from '@seontechnologies/playwright-utils'
-
-// Subpath imports also work in both formats
-import { recurse } from '@seontechnologies/playwright-utils/recurse'
-```
-
 ## Development
 
 Quick start (this repo):
@@ -121,25 +102,6 @@ npm run test:pw       # Run Playwright tests
 npm run test:pw-ui    # Run Playwright tests with UI
 ```
 
-### Testing Strategy
-
-The overall testing approach:
-
-1. **Deployed Apps Tests** - Some tests use Playwright's deployed apps to keep things familiar (`log`, `interceptNetworkCall`):
-   - `playwright/tests/network-mock-original.spec.ts`
-   - `playwright/tests/todo-with-logs.spec.ts`
-   - `playwright/tests/network-mock-intercept-network-call.spec.ts`
-
-1. **Sample App Tests** - The `./sample-app` provides a more complex environment to test:
-   - API request automation
-   - Recursion and retry patterns
-   - Authentication flows
-   - Future: feature flag testing, email testing, etc.
-
-To start the sample app backend and frontend; `npm run start:sample-app`.
-
-The sample app uses `"@seontechnologies/playwright-utils": "*"` in its package.json so that changes to the library are immediately available for testing without requiring republishing or package updates.
-
 ## Available Utilities
 
 The library provides the following utilities, each with both direct function imports and Playwright fixtures:
@@ -676,6 +638,50 @@ test(
 
 Inspired by [Checkly's network monitoring pattern](https://github.com/checkly/checkly-playwright-examples/tree/main/network-monitoring). See [full docs](./docs/network-error-monitor.md).
 
+## Module Format Support
+
+This package supports both CommonJS and ES Modules formats:
+
+- **CommonJS**: For projects using `require()` syntax or CommonJS module resolution
+- **ES Modules**: For projects using `import` syntax with ES modules
+
+The package automatically detects which format to use based on your project's configuration. This means:
+
+- You can use this package in both legacy CommonJS projects and modern ESM projects
+- No need to change import paths or add file extensions
+- TypeScript type definitions work for both formats
+
+Example usage:
+
+```typescript
+// Works in both CommonJS and ESM environments
+import { log } from '@seontechnologies/playwright-utils'
+
+// Subpath imports also work in both formats
+import { recurse } from '@seontechnologies/playwright-utils/recurse'
+```
+
+### Testing Strategy in this repository
+
+We showcase how to use the utilities in this repository through tests, often comparing and contrasting to vanilla Playwright patterns. We are using a backend and a frontend application to demonstrate more complex scenarios.
+
+The overall testing approach:
+
+1. **Deployed Apps Tests** - Some tests use Playwright's deployed apps to keep things familiar (`log`, `interceptNetworkCall`):
+   - `playwright/tests/network-mock-original.spec.ts`
+   - `playwright/tests/todo-with-logs.spec.ts`
+   - `playwright/tests/network-mock-intercept-network-call.spec.ts`
+
+1. **Sample App Tests** - The `./sample-app` provides a more complex environment to test:
+   - API request automation
+   - Recursion and retry patterns
+   - Authentication flows
+   - Future: feature flag testing, email testing, etc.
+
+To start the sample app backend and frontend; `npm run start:sample-app`.
+
+The sample app uses `"@seontechnologies/playwright-utils": "*"` in its package.json so that changes to the library are immediately available for testing without requiring republishing or package updates.
+
 ## Testing the Package Locally
 
 ```bash

package/dist/cjs/api-request/schema-validation/internal/file-loader.d.ts

@@ -24,7 +24,7 @@
  * // Load JSON schema
  * const jsonSchema = await loadSchemaFromFile('./schemas/user.json')
  *
- * // Load YAML OpenAPI spec
+ * // Load YAML OpenAPI spec (requires js-yaml: npm install js-yaml)
  * const yamlSchema = await loadSchemaFromFile('./openapi/api.yaml')
  * ```
  *

package/dist/cjs/api-request/schema-validation/internal/file-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-loader.d.ts","sourceRoot":"","sources":["../../../../../src/api-request/schema-validation/internal/file-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAoC1E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAK3D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,SAAS,MAAM,EAAE,CAExD"}
+{"version":3,"file":"file-loader.d.ts","sourceRoot":"","sources":["../../../../../src/api-request/schema-validation/internal/file-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA4C1E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAK3D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,SAAS,MAAM,EAAE,CAExD"}

package/dist/cjs/api-request/schema-validation/internal/file-loader.js

@@ -46,7 +46,6 @@ exports.isValidSchemaFile = isValidSchemaFile;
 exports.getAllowedExtensions = getAllowedExtensions;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-const yaml = __importStar(require("js-yaml"));
 /**
  * Allowed file extensions for schema files
  */
@@ -69,7 +68,7 @@ const ALLOWED_EXTENSIONS = ['.json', '.yaml', '.yml'];
  * // Load JSON schema
  * const jsonSchema = await loadSchemaFromFile('./schemas/user.json')
  *
- * // Load YAML OpenAPI spec
+ * // Load YAML OpenAPI spec (requires js-yaml: npm install js-yaml)
  * const yamlSchema = await loadSchemaFromFile('./openapi/api.yaml')
  * ```
  *
@@ -94,8 +93,15 @@ async function loadSchemaFromFile(filePath) {
         const content = fs.readFileSync(resolvedPath, 'utf8');
         // Parse based on file extension
         if (filePath.endsWith('.yaml') || filePath.endsWith('.yml')) {
-            // Security: yaml.load() is safe by default in js-yaml v4+ (no code execution)
-            return yaml.load(content);
+            // Dynamic import - js-yaml is an optional peer dependency
+            try {
+                const yaml = await Promise.resolve().then(() => __importStar(require('js-yaml')));
+                // Security: yaml.load() is safe by default in js-yaml v4+ (no code execution)
+                return yaml.load(content);
+            }
+            catch {
+                throw new Error('YAML schema support requires js-yaml. Install it with: npm install js-yaml');
+            }
         }
         else {
             return JSON.parse(content);

package/dist/cjs/api-request/schema-validation/internal/file-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-loader.js","sourceRoot":"","sources":["../../../../../src/api-request/schema-validation/internal/file-loader.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCH,gDAoCC;AAQD,8CAKC;AAOD,oDAEC;AA9FD,uCAAwB;AACxB,2CAA4B;AAC5B,8CAA+B;AAE/B;;GAEG;AACH,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAU,CAAA;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACI,KAAK,UAAU,kBAAkB,CAAC,QAAgB;IACvD,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QAE3C,wEAAwE;QACxE,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAA;QAC1D,IACE,CAAC,kBAAkB,CAAC,QAAQ,CAC1B,aAAoD,CACrD,EACD,CAAC;YACD,MAAM,IAAI,KAAK,CACb,2BAA2B,aAAa,cAAc,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACtF,CAAA;QACH,CAAC;QAED,uBAAuB;QACvB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,0BAA0B,YAAY,EAAE,CAAC,CAAA;QAC3D,CAAC;QAED,oBAAoB;QACpB,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAA;QAErD,gCAAgC;QAChC,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5D,8EAA8E;YAC9E,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAW,CAAA;QACrC,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAC5B,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,+BAA+B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACxF,CAAA;IACH,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,iBAAiB,CAAC,QAAgB;IAChD,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAA;IAC1D,OAAO,kBAAkB,CAAC,QAAQ,CAChC,aAAoD,CACrD,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,oBAAoB;IAClC,OAAO,kBAAkB,CAAA;AAC3B,CAAC"}
+{"version":3,"file":"file-loader.js","sourceRoot":"","sources":["../../../../../src/api-request/schema-validation/internal/file-loader.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCH,gDA4CC;AAQD,8CAKC;AAOD,oDAEC;AArGD,uCAAwB;AACxB,2CAA4B;AAE5B;;GAEG;AACH,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAU,CAAA;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACI,KAAK,UAAU,kBAAkB,CAAC,QAAgB;IACvD,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QAE3C,wEAAwE;QACxE,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAA;QAC1D,IACE,CAAC,kBAAkB,CAAC,QAAQ,CAC1B,aAAoD,CACrD,EACD,CAAC;YACD,MAAM,IAAI,KAAK,CACb,2BAA2B,aAAa,cAAc,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACtF,CAAA;QACH,CAAC;QAED,uBAAuB;QACvB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,0BAA0B,YAAY,EAAE,CAAC,CAAA;QAC3D,CAAC;QAED,oBAAoB;QACpB,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAA;QAErD,gCAAgC;QAChC,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5D,0DAA0D;YAC1D,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,wDAAa,SAAS,GAAC,CAAA;gBACpC,8EAA8E;gBAC9E,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAW,CAAA;YACrC,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,KAAK,CACb,4EAA4E,CAC7E,CAAA;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAC5B,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,+BAA+B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACxF,CAAA;IACH,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,iBAAiB,CAAC,QAAgB;IAChD,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAA;IAC1D,OAAO,kBAAkB,CAAC,QAAQ,CAChC,aAAoD,CACrD,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,oBAAoB;IAClC,OAAO,kBAAkB,CAAA;AAC3B,CAAC"}

package/dist/esm/api-request/schema-validation/internal/file-loader.d.ts

@@ -24,7 +24,7 @@
  * // Load JSON schema
  * const jsonSchema = await loadSchemaFromFile('./schemas/user.json')
  *
- * // Load YAML OpenAPI spec
+ * // Load YAML OpenAPI spec (requires js-yaml: npm install js-yaml)
  * const yamlSchema = await loadSchemaFromFile('./openapi/api.yaml')
  * ```
  *

package/dist/esm/api-request/schema-validation/internal/file-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-loader.d.ts","sourceRoot":"","sources":["../../../../../src/api-request/schema-validation/internal/file-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAoC1E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAK3D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,SAAS,MAAM,EAAE,CAExD"}
+{"version":3,"file":"file-loader.d.ts","sourceRoot":"","sources":["../../../../../src/api-request/schema-validation/internal/file-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA4C1E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAK3D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,SAAS,MAAM,EAAE,CAExD"}

package/dist/esm/api-request/schema-validation/internal/file-loader.js

@@ -46,7 +46,6 @@ exports.isValidSchemaFile = isValidSchemaFile;
 exports.getAllowedExtensions = getAllowedExtensions;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-const yaml = __importStar(require("js-yaml"));
 /**
  * Allowed file extensions for schema files
  */
@@ -69,7 +68,7 @@ const ALLOWED_EXTENSIONS = ['.json', '.yaml', '.yml'];
  * // Load JSON schema
  * const jsonSchema = await loadSchemaFromFile('./schemas/user.json')
  *
- * // Load YAML OpenAPI spec
+ * // Load YAML OpenAPI spec (requires js-yaml: npm install js-yaml)
  * const yamlSchema = await loadSchemaFromFile('./openapi/api.yaml')
  * ```
  *
@@ -94,8 +93,15 @@ async function loadSchemaFromFile(filePath) {
         const content = fs.readFileSync(resolvedPath, 'utf8');
         // Parse based on file extension
         if (filePath.endsWith('.yaml') || filePath.endsWith('.yml')) {
-            // Security: yaml.load() is safe by default in js-yaml v4+ (no code execution)
-            return yaml.load(content);
+            // Dynamic import - js-yaml is an optional peer dependency
+            try {
+                const yaml = await import('js-yaml');
+                // Security: yaml.load() is safe by default in js-yaml v4+ (no code execution)
+                return yaml.load(content);
+            }
+            catch {
+                throw new Error('YAML schema support requires js-yaml. Install it with: npm install js-yaml');
+            }
         }
         else {
             return JSON.parse(content);

package/dist/esm/api-request/schema-validation/internal/file-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-loader.js","sourceRoot":"","sources":["../../../../../src/api-request/schema-validation/internal/file-loader.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCH,gDAoCC;AAQD,8CAKC;AAOD,oDAEC;AA9FD,uCAAwB;AACxB,2CAA4B;AAC5B,8CAA+B;AAE/B;;GAEG;AACH,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAU,CAAA;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACI,KAAK,UAAU,kBAAkB,CAAC,QAAgB;IACvD,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QAE3C,wEAAwE;QACxE,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAA;QAC1D,IACE,CAAC,kBAAkB,CAAC,QAAQ,CAC1B,aAAoD,CACrD,EACD,CAAC;YACD,MAAM,IAAI,KAAK,CACb,2BAA2B,aAAa,cAAc,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACtF,CAAA;QACH,CAAC;QAED,uBAAuB;QACvB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,0BAA0B,YAAY,EAAE,CAAC,CAAA;QAC3D,CAAC;QAED,oBAAoB;QACpB,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAA;QAErD,gCAAgC;QAChC,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5D,8EAA8E;YAC9E,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAW,CAAA;QACrC,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAC5B,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,+BAA+B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACxF,CAAA;IACH,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,iBAAiB,CAAC,QAAgB;IAChD,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAA;IAC1D,OAAO,kBAAkB,CAAC,QAAQ,CAChC,aAAoD,CACrD,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,oBAAoB;IAClC,OAAO,kBAAkB,CAAA;AAC3B,CAAC"}
+{"version":3,"file":"file-loader.js","sourceRoot":"","sources":["../../../../../src/api-request/schema-validation/internal/file-loader.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCH,gDA4CC;AAQD,8CAKC;AAOD,oDAEC;AArGD,uCAAwB;AACxB,2CAA4B;AAE5B;;GAEG;AACH,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAU,CAAA;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACI,KAAK,UAAU,kBAAkB,CAAC,QAAgB;IACvD,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QAE3C,wEAAwE;QACxE,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAA;QAC1D,IACE,CAAC,kBAAkB,CAAC,QAAQ,CAC1B,aAAoD,CACrD,EACD,CAAC;YACD,MAAM,IAAI,KAAK,CACb,2BAA2B,aAAa,cAAc,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACtF,CAAA;QACH,CAAC;QAED,uBAAuB;QACvB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,0BAA0B,YAAY,EAAE,CAAC,CAAA;QAC3D,CAAC;QAED,oBAAoB;QACpB,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAA;QAErD,gCAAgC;QAChC,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5D,0DAA0D;YAC1D,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAA;gBACpC,8EAA8E;gBAC9E,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAW,CAAA;YACrC,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,KAAK,CACb,4EAA4E,CAC7E,CAAA;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAC5B,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,+BAA+B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACxF,CAAA;IACH,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAgB,iBAAiB,CAAC,QAAgB;IAChD,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAA;IAC1D,OAAO,kBAAkB,CAAC,QAAQ,CAChC,aAAoD,CACrD,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,oBAAoB;IAClC,OAAO,kBAAkB,CAAA;AAC3B,CAAC"}

package/dist/types/api-request/schema-validation/internal/file-loader.d.ts

@@ -24,7 +24,7 @@
  * // Load JSON schema
  * const jsonSchema = await loadSchemaFromFile('./schemas/user.json')
  *
- * // Load YAML OpenAPI spec
+ * // Load YAML OpenAPI spec (requires js-yaml: npm install js-yaml)
  * const yamlSchema = await loadSchemaFromFile('./openapi/api.yaml')
  * ```
  *

package/dist/types/api-request/schema-validation/internal/file-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-loader.d.ts","sourceRoot":"","sources":["../../../../../src/api-request/schema-validation/internal/file-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAoC1E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAK3D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,SAAS,MAAM,EAAE,CAExD"}
+{"version":3,"file":"file-loader.d.ts","sourceRoot":"","sources":["../../../../../src/api-request/schema-validation/internal/file-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA4C1E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAK3D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,SAAS,MAAM,EAAE,CAExD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seontechnologies/playwright-utils",
-  "version": "3.12.0",
+  "version": "3.13.1",
   "description": "A collection of utilities for Playwright.",
   "workspaces": [
     "sample-app/*"
@@ -165,7 +165,10 @@
     "test:pw:burn-in": "PW_BURN_IN=true npx playwright test --repeat-each=3 --retries=0",
     "test:pw:burn-in-changed-classic": "PW_BURN_IN=true npx playwright test --only-changed=main --repeat-each=3 --retries=0",
     "test:pw:burn-in-changed": "tsx playwright/scripts/burn-in-changed.ts",
-    "show:report": "npx playwright show-report --port 9324"
+    "show:report": "npx playwright show-report --port 9324",
+    "docs:dev": "DOCS_BASE=/ vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "DOCS_BASE=/ vitepress preview docs"
   },
   "peerDependencies": {
     "@playwright/test": ">=1.54.1",
@@ -221,13 +224,13 @@
     "tsx": "4.20.6",
     "typescript": "5.9.3",
     "vite": "6.4.1",
+    "vitepress": "^1.6.4",
     "zod": "4.1.12"
   },
   "dependencies": {
     "adm-zip": "0.5.16",
     "deepmerge": "4.3.1",
     "exceljs": "4.4.0",
-    "js-yaml": "4.1.0",
     "madge": "7.0.0",
     "papaparse": "5.5.3",
     "picomatch": "4.0.3",