playwright-clipboard-testing 0.4.0 → 0.6.0

package/README.md

@@ -15,7 +15,7 @@ Testing the Clipboard API in Playwright usually requires boilerplate code to man
 **playwright-clipboard-testing** simplifies this with:
 - 🔌 **Zero configuration** — Chromium permissions are granted automatically under the hood (Firefox requires a 1-line config setup).
 - 🔄 **Built-in Auto-retries & Polling** — Uses Playwright's native `expect` polling to wait until the clipboard updates asynchronously.
-- 📦 **TypeScript Ready** — Full type safety for JSON objects with `readJSON<T>()`.
+- 📦 **TypeScript Ready** — Full type safety for JSON objects with `readJSON<T>()` and `writeJSON<T>()`.
 
 ## Table of Contents
 - [Why?](#why)
@@ -24,11 +24,16 @@ Testing the Clipboard API in Playwright usually requires boilerplate code to man
 - [Usage](#usage)
   - [Direct Usage](#direct-usage) 
   - [Extended Usage](#extended-usage)
+- [Subpath Exports](#subpath-exports)
 - [API](#api)
-  - [Clipboard Fixtures](#clipboard-fixtures)
+  - [Fixtures](#fixtures)
+  - [ClipboardHandler](#clipboardhandler)
+  - [toBeBlank Matcher](#tobeblank-matcher)
+  - [toHaveContentLength Matcher](#tohavecontentlength-matcher)
   - [toHaveTextContent Matcher](#tohavetextcontent-matcher)
   - [toHaveJSONContent Matcher](#tohavejsoncontent-matcher)
-  - [toHaveData Matcher](#tohavedata-matcher)
+  - [toMatchJSONContent Matcher](#tomatchjsoncontent-matcher)
+  - [PATTERNS](#patterns)
 - [Author](#author)
 - [License](#license)
 
@@ -56,7 +61,7 @@ test('should copy text to clipboard', async ({ page, clipboard, browserName }) =
 If your Playwright setup runs tests in Firefox, manually configure `firefoxUserPrefs` in your Playwright config:
 ```ts
 import { defineConfig, devices } from '@playwright/test';
-import { firefoxClipboardPrefs } from 'playwright-clipboard-testing';
+import { firefoxClipboardPrefs } from 'playwright-clipboard-testing/constants';
 
 export default defineConfig({
   projects: [
@@ -93,42 +98,97 @@ test('should copy text to clipboard', async ({ page, clipboard }) => {
 If you already have a custom test fixture file, extend Playwright's `test` and `expect` with `clipboardFixtures` and `clipboardMatchers`:
 ```ts
 import { expect as baseExpect, test as baseTest } from '@playwright/test';
-import {
-  type ClipboardHandler,
-  clipboardFixtures,
-  clipboardMatchers,
-} from 'playwright-clipboard-testing';
+import { type ClipboardHandler, clipboardFixtures } from 'playwright-clipboard-testing/fixtures';
+import { clipboardMatchers } from 'playwright-clipboard-testing/matchers';
 
 export const test = baseTest.extend<{ clipboard: ClipboardHandler }>(clipboardFixtures);
 
 export const expect = baseExpect.extend(clipboardMatchers);
+
 ```
 
+## Subpath Exports
+
+The package provides dedicated subpath exports to import specific utilities when extending Playwright:
+
+| Import Path                              | Exports                                                                       | Description                                                                                            |
+|:-----------------------------------------|:------------------------------------------------------------------------------|:-------------------------------------------------------------------------------------------------------|
+| `playwright-clipboard-testing`           | `test`, `expect`                                                              | Ready-to-use Playwright `test` runner and `expect` assertion function with built-in clipboard support. |
+| `playwright-clipboard-testing/constants` | `firefoxClipboardPrefs`, `PATTERNS`                                           | Firefox browser preferences for clipboard permissions and regex patterns for clipboard assertions.     |
+| `playwright-clipboard-testing/fixtures`  | `clipboardFixtures`, `clipboardFixture`, `contextFixture`, `ClipboardHandler` | Playwright test fixtures and `ClipboardHandler` class for extending custom test setups.                |
+| `playwright-clipboard-testing/matchers`  | `clipboardMatchers`                                                           | Custom Playwright matchers for extending custom `expect`.                                              |
+
 ## API
-### Clipboard Fixtures
-The package exports `clipboardFixtures` (containing `context` and `clipboard` fixtures) as well as individual fixtures `clipboardFixture` and `contextFixture`:
 
-- `clipboardFixtures` — Object containing both `context` and `clipboard` fixtures for simple fixture extension.
-- `contextFixture` (`context`) — Automatically grants `clipboard-read` and `clipboard-write` permissions to Chromium browser contexts.
-- `clipboardFixture` (`clipboard`) — Provides direct access to the `ClipboardHandler` instance during tests:
-  - `clipboard.read(): Promise<string>` — reads the current plain text content from the clipboard.
-  - `clipboard.readJSON<T>(): Promise<T>` — reads the current clipboard content and parses it as a JSON object of type `T`. Throws an error if the content is not valid JSON.
+### Fixtures
+The package exports the following fixtures for Playwright test configuration:
+
+- `clipboardFixtures` — Object containing both `context` and `clipboard` fixtures. Recommended for extending test fixtures.
+- `contextFixture` (`context`) — Playwright context fixture that automatically grants `clipboard-read` and `clipboard-write` permissions in Chromium.
+- `clipboardFixture` (`clipboard`) — Playwright test fixture that provides access to the `ClipboardHandler` instance in your tests.
+
+### ClipboardHandler
+The `clipboard` fixture provides direct access to the `ClipboardHandler` instance for managing clipboard state:
+
+| Method               | Return Type       | Description                                                                                                              |
+|:---------------------|:------------------|:-------------------------------------------------------------------------------------------------------------------------|
+| `read()`             | `Promise<string>` | Reads plain text content from the clipboard.                                                                             |
+| `write(text)`        | `Promise<void>`   | Writes the specified plain text to the clipboard.                                                                        |
+| `readJSON<T>()`      | `Promise<T>`      | Reads clipboard content and parses it as a JSON object of type `T`. Throws an error if invalid JSON.                     |
+| `writeJSON<T>(data)` | `Promise<void>`   | Serializes an object of type `T` to JSON and writes it to the clipboard. Throws an error if object cannot be serialized. |
+| `clear()`            | `Promise<void>`   | Clears all clipboard content.                                                                                            |
 
 ![NOTE](https://img.shields.io/badge/NOTE-For%20your%20tests%20we%20recommend%20using%20existing%20matchers%20to%20assert%20clipboard%20content-yellow)
 
+### toBeBlank Matcher
+`expect(clipboard).toBeBlank(options?)`
+Asserts that the clipboard is empty. Uses Playwright's smart polling mechanism to wait for the clipboard to update.
+- `options.timeout: number (optional, default: 10000ms)`
+- `options.trim: boolean (optional, default: false)` — Trims whitespace from the clipboard content before checking if it's blank.
+```ts
+// assert that the clipboard is empty
+await expect(clipboard).toBeBlank();
+```
+```ts
+// assert that the clipboard is not empty with a custom timeout
+await expect(clipboard).not.toBeBlank({ timeout: 5000 });
+```
+
+### toHaveContentLength Matcher
+`expect(clipboard).toHaveContentLength(expected, options?)`
+
+Asserts that the clipboard content has the expected length. Uses Playwright's smart polling mechanism to wait for the clipboard to update.
+- `expected: number` — Expected length of the clipboard content.
+- `options.timeout: number (optional, default: 10000ms)` — Time in milliseconds to wait for the clipboard content to match.
+- `options.trim: boolean (optional, default: false)` — Trims whitespace from the clipboard content before checking its length.
+```ts
+// assert that the clipboard content has the expected length
+await expect(clipboard).toHaveContentLength(13);
+```
+```ts
+// assert that the clipboard content does not have the expected length with trim option
+await expect(clipboard).not.toHaveContentLength(10, { trim: true });
+```
+
 ### toHaveTextContent Matcher
 `expect(clipboard).toHaveTextContent(expected, options?)`
 
-Asserts that the clipboard content matches the expected string. Uses Playwright's smart polling mechanism to wait for the clipboard to update.
-- `expected: string` — Expected text to compare against.
+Asserts that the clipboard content matches the expected string or regular expression. Uses Playwright's smart polling mechanism to wait for the clipboard to update.
+- `expected: string | RegExp` — Expected text string or regular expression to match against.
 - `options.timeout: number (optional, default: 10000ms)` — Time in milliseconds to wait for the clipboard content to match.
+- `options.ignoreCase: boolean (optional, default: false)` — Ignores case when comparing strings or matching regular expressions.
+- `options.trim: boolean (optional, default: false)` — Trims whitespace from both expected and actual string before comparison.
 ```ts
 // assert that the clipboard contains the expected text
 await expect(clipboard).toHaveTextContent('Hello, World!');
 ```
 ```ts
-// Custom timeout
-await expect(clipboard).toHaveTextContent('Async copied value', { timeout: 5000 });
+// assert that the clipboard text matches a regular expression
+await expect(clipboard).toHaveTextContent(/Hello, World!/i);
+```
+```ts
+// assert that the clipboard is not containing the expected text with a custom timeout
+await expect(clipboard).not.toHaveTextContent('Async copied value', { timeout: 5000 });
 ```
 
 ### toHaveJSONContent Matcher
@@ -141,29 +201,50 @@ Asserts that the clipboard content matches the expected JSON value. Uses Playwri
 await expect(clipboard).toHaveJSONContent({ message: 'Hello, World!' });
 ```
 ```ts
-// Custom timeout
-await expect(clipboard).toHaveJSONContent({ message: 'Async copied value' }, { timeout: 5000 });
+// assert that the clipboard is not containing the expected JSON data with a custom timeout
+await expect(clipboard).not.toHaveJSONContent({ message: 'Async copied value' }, { timeout: 5000 });
 ```
 
-### toHaveData Matcher
-![NOTE](https://img.shields.io/badge/NOTE-Matcher%20is%20deprecated%20in%20favor%20of%20toHaveTextContent%20and%20toHaveJSONContent-yellow)
-
-`expect(clipboard).toHaveData(expected, options?)`
-
-Asserts that the clipboard content matches the expected string or JSON object. Uses Playwright's smart polling mechanism to wait for the clipboard to update.
-- `expected: unknown` — Expected text or object to compare against.
-- `options.timeout: number (optional, default: 10000ms)` — Time in milliseconds to wait for the clipboard data to match.
+### toMatchJSONContent Matcher
+`expect(clipboard).toMatchJSONContent(expected, options?)`
+Asserts that the expected JSON object is a subset of the clipboard content. Uses Playwright's smart polling mechanism to wait for the clipboard to update.
+- `expected: unknown` — Expected JSON subset object to compare against.
+- `options.timeout: number (optional, default: 10000ms)` — Time in milliseconds to wait for the clipboard content to match.
 ```ts
-// assert that the clipboard contains the expected text
-await expect(clipboard).toHaveData('Hello, World!');
+// assert that the clipboard contains a subset of the expected JSON data
+await expect(clipboard).toMatchJSONContent({ status: 'success' });
 ```
 ```ts
-// assert that the clipboard contains the expected JSON data
-await expect(clipboard).toHaveData({ message: 'Hello, World!' });
+// assert that the clipboard is not containing a subset of the expected JSON data with a custom timeout
+await expect(clipboard).not.toMatchJSONContent({ status: 'failed' }, { timeout: 5000 });
 ```
+
+### PATTERNS
+The package exports pre-defined regular expression patterns for common data formats (`PATTERNS`), which can be passed directly to `toHaveTextContent`:
+
+| Pattern     | Description                          | Example Match                             |
+|:------------|:-------------------------------------|:------------------------------------------|
+| `UUID`      | UUID v1–v5 format                    | `123e4567-e89b-12d3-a456-426614174000`    |
+| `EMAIL`     | Email address format                 | `user@example.com`                        |
+| `PHONE`     | Phone number in E.164 format         | `+1234567890`                             |
+| `JWT`       | JWT token format                     | `header.payload.signature`                |
+| `BEARER`    | Bearer authentication token format   | `Bearer token123`                         |
+| `HEX_COLOR` | HEX color format                     | `#FFF`, `#FFFFFF`, `#FFFFFFFF`            |
+| `IP.V4`     | IPv4 address format                  | `192.168.1.1`                             |
+| `IP.V6`     | IPv6 address format                  | `2001:0db8:85a3:0000:0000:8a2e:0370:7334` |
+| `IP.ANY`    | Any IP address format (IPv4 or IPv6) | `192.168.1.1` or `2001:db8::1`            |
+
+To use a pattern in your test, import `PATTERNS` and pass the desired pattern to `toHaveTextContent`:
 ```ts
-// Custom timeout
-await expect(clipboard).toHaveData('Async copied value', { timeout: 5000 });
+import { expect, test } from 'playwright-clipboard-testing';
+import { PATTERNS } from 'playwright-clipboard-testing/constants';
+
+test('should copy UUID to clipboard', async ({ page, clipboard }) => {
+  await page.goto('https://example.com');
+  await page.locator('#copy-uuid-button').click();
+
+  await expect(clipboard).toHaveTextContent(PATTERNS.UUID);
+});
 ```
 
 ## Author

package/dist/clipboardHandler-CFIUvkc0.d.cts

@@ -0,0 +1,51 @@
+import { Page } from '@playwright/test';
+
+/**
+ * Playwright-compatible Clipboard utilities.
+ *
+ * Core functions for interacting with the browser clipboard within Playwright tests.
+ * Provides wrappers for reading plain text and JSON.
+ *
+ * @remarks
+ * These utilities require 'clipboard-read' and 'clipboard-write' permissions
+ * to be granted in the browser context.
+ */
+
+declare class ClipboardHandler {
+    private readonly page;
+    constructor(page: Page);
+    /**
+     * Reads the current text content from the browser clipboard.
+     * If the content is a JSON-encoded string (e.g., has extra quotes),
+     * it will be returned as is. Use readJSON for automatic parsing.
+     *
+     * @returns A promise that resolves to the clipboard string content.
+     */
+    read(): Promise<string>;
+    /**
+     * Reads the clipboard content and parses it as JSON.
+     * If the content is a string literal (e.g., '"value"'), it returns the unwrapped string ('value').
+     *
+     * @template T - The expected type of the parsed JSON object.
+     * @returns A promise that resolves to the parsed JSON object of type T.
+     * @throws {Error} If the clipboard content is not a valid JSON string.
+     */
+    readJSON<T = unknown>(): Promise<T>;
+    /**
+     * Writes the provided string data to the browser clipboard.
+     * @param data The data to write to the clipboard.
+     */
+    write(data: string): Promise<void>;
+    /**
+     * Writes the provided data to the browser clipboard as a JSON string.
+     * @param data The data to write to the clipboard. It will be stringified as JSON.
+     */
+    writeJSON<T = unknown>(data: T): Promise<void>;
+    /**
+     * Clears the browser clipboard by writing an empty string to it.
+     * This effectively removes any existing content from the clipboard.
+     */
+    clear(): Promise<void>;
+}
+
+export { ClipboardHandler as C };

package/dist/clipboardHandler-CFIUvkc0.d.ts

@@ -0,0 +1,51 @@
+import { Page } from '@playwright/test';
+
+/**
+ * Playwright-compatible Clipboard utilities.
+ *
+ * Core functions for interacting with the browser clipboard within Playwright tests.
+ * Provides wrappers for reading plain text and JSON.
+ *
+ * @remarks
+ * These utilities require 'clipboard-read' and 'clipboard-write' permissions
+ * to be granted in the browser context.
+ */
+
+declare class ClipboardHandler {
+    private readonly page;
+    constructor(page: Page);
+    /**
+     * Reads the current text content from the browser clipboard.
+     * If the content is a JSON-encoded string (e.g., has extra quotes),
+     * it will be returned as is. Use readJSON for automatic parsing.
+     *
+     * @returns A promise that resolves to the clipboard string content.
+     */
+    read(): Promise<string>;
+    /**
+     * Reads the clipboard content and parses it as JSON.
+     * If the content is a string literal (e.g., '"value"'), it returns the unwrapped string ('value').
+     *
+     * @template T - The expected type of the parsed JSON object.
+     * @returns A promise that resolves to the parsed JSON object of type T.
+     * @throws {Error} If the clipboard content is not a valid JSON string.
+     */
+    readJSON<T = unknown>(): Promise<T>;
+    /**
+     * Writes the provided string data to the browser clipboard.
+     * @param data The data to write to the clipboard.
+     */
+    write(data: string): Promise<void>;
+    /**
+     * Writes the provided data to the browser clipboard as a JSON string.
+     * @param data The data to write to the clipboard. It will be stringified as JSON.
+     */
+    writeJSON<T = unknown>(data: T): Promise<void>;
+    /**
+     * Clears the browser clipboard by writing an empty string to it.
+     * This effectively removes any existing content from the clipboard.
+     */
+    clear(): Promise<void>;
+}
+
+export { ClipboardHandler as C };

package/dist/constants/index.cjs

@@ -0,0 +1,80 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/constants/index.ts
+var constants_exports = {};
+__export(constants_exports, {
+  PATTERNS: () => PATTERNS,
+  firefoxClipboardPrefs: () => firefoxClipboardPrefs
+});
+module.exports = __toCommonJS(constants_exports);
+
+// src/constants/constants.ts
+var firefoxClipboardPrefs = {
+  "dom.events.testing.asyncClipboard": true,
+  "dom.events.asyncClipboard.readText": true,
+  "dom.events.asyncClipboard.writeText": true,
+  "permissions.default.clipboard-read": 1,
+  "permissions.default.clipboard-write": 1
+};
+
+// src/constants/patterns.ts
+var PATTERNS = {
+  /**
+   * UUID v1-v5 (example: 123e4567-e89b-12d3-a456-426614174000).
+   */
+  UUID: /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,
+  /**
+   * Email addresses (example: user@example.com).
+   */
+  EMAIL: /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/,
+  /**
+   * Phone numbers in E.164 format (example: +1234567890).
+   */
+  PHONE: /^\+[1-9]\d{1,14}$/,
+  /**
+   * JWT tokens (example: header.payload.signature).
+   */
+  JWT: /^[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+$/,
+  /**
+   * Authorization Bearer tokens (example: Bearer <token>).
+   */
+  BEARER: /^Bearer\s+[a-zA-Z0-9._~+/-]+=*$/i,
+  /**
+   * HEX-colors (example: #FFF, #FFFFFF, #FFFFFFFF).
+   */
+  HEX_COLOR: /^#([0-9a-f]{3}|[0-9a-f]{6}|[0-9a-f]{8})$/i,
+  /**
+   * IP (IPv4, IPv6 or any).
+   */
+  IP: {
+    /** IPv4 (example: 192.168.1.1 or 127.0.0.1) */
+    V4: /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/,
+    /** IPv6 (example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334) */
+    V6: /^(([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9]))$/,
+    /** Any IP address (IPv4 or IPv6) */
+    ANY: /^(?:(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)|(?:([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])))$/
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PATTERNS,
+  firefoxClipboardPrefs
+});
+//# sourceMappingURL=index.cjs.map

package/dist/constants/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/constants/index.ts","../../src/constants/constants.ts","../../src/constants/patterns.ts"],"sourcesContent":["import { firefoxClipboardPrefs } from './constants.ts';\nimport { PATTERNS } from './patterns.ts';\n\nexport { firefoxClipboardPrefs, PATTERNS };\n","export const firefoxClipboardPrefs = {\n  'dom.events.testing.asyncClipboard': true,\n  'dom.events.asyncClipboard.readText': true,\n  'dom.events.asyncClipboard.writeText': true,\n  'permissions.default.clipboard-read': 1,\n  'permissions.default.clipboard-write': 1,\n};\n","/**\n * This module contains regular expression patterns for various common formats.\n * These patterns can be used for validation purposes in applications.\n */\nexport const PATTERNS = {\n  /**\n   * UUID v1-v5 (example: 123e4567-e89b-12d3-a456-426614174000).\n   */\n  UUID: /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,\n\n  /**\n   * Email addresses (example: user@example.com).\n   */\n  EMAIL: /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$/,\n\n  /**\n   * Phone numbers in E.164 format (example: +1234567890).\n   */\n  PHONE: /^\\+[1-9]\\d{1,14}$/,\n\n  /**\n   * JWT tokens (example: header.payload.signature).\n   */\n  JWT: /^[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$/,\n\n  /**\n   * Authorization Bearer tokens (example: Bearer <token>).\n   */\n  BEARER: /^Bearer\\s+[a-zA-Z0-9._~+/-]+=*$/i,\n\n  /**\n   * HEX-colors (example: #FFF, #FFFFFF, #FFFFFFFF).\n   */\n  HEX_COLOR: /^#([0-9a-f]{3}|[0-9a-f]{6}|[0-9a-f]{8})$/i,\n\n  /**\n   * IP (IPv4, IPv6 or any).\n   */\n  IP: {\n    /** IPv4 (example: 192.168.1.1 or 127.0.0.1) */\n    V4: /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/,\n\n    /** IPv6 (example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334) */\n    V6: /^(([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9]))$/,\n\n    /** Any IP address (IPv4 or IPv6) */\n    ANY: /^(?:(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)|(?:([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])))$/,\n  },\n} as const;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAO,IAAM,wBAAwB;AAAA,EACnC,qCAAqC;AAAA,EACrC,sCAAsC;AAAA,EACtC,uCAAuC;AAAA,EACvC,sCAAsC;AAAA,EACtC,uCAAuC;AACzC;;;ACFO,IAAM,WAAW;AAAA;AAAA;AAAA;AAAA,EAItB,MAAM;AAAA;AAAA;AAAA;AAAA,EAKN,OAAO;AAAA;AAAA;AAAA;AAAA,EAKP,OAAO;AAAA;AAAA;AAAA;AAAA,EAKP,KAAK;AAAA;AAAA;AAAA;AAAA,EAKL,QAAQ;AAAA;AAAA;AAAA;AAAA,EAKR,WAAW;AAAA;AAAA;AAAA;AAAA,EAKX,IAAI;AAAA;AAAA,IAEF,IAAI;AAAA;AAAA,IAGJ,IAAI;AAAA;AAAA,IAGJ,KAAK;AAAA,EACP;AACF;","names":[]}

package/dist/constants/index.d.cts

@@ -0,0 +1,51 @@
+declare const firefoxClipboardPrefs: {
+    'dom.events.testing.asyncClipboard': boolean;
+    'dom.events.asyncClipboard.readText': boolean;
+    'dom.events.asyncClipboard.writeText': boolean;
+    'permissions.default.clipboard-read': number;
+    'permissions.default.clipboard-write': number;
+};
+
+/**
+ * This module contains regular expression patterns for various common formats.
+ * These patterns can be used for validation purposes in applications.
+ */
+declare const PATTERNS: {
+    /**
+     * UUID v1-v5 (example: 123e4567-e89b-12d3-a456-426614174000).
+     */
+    readonly UUID: RegExp;
+    /**
+     * Email addresses (example: user@example.com).
+     */
+    readonly EMAIL: RegExp;
+    /**
+     * Phone numbers in E.164 format (example: +1234567890).
+     */
+    readonly PHONE: RegExp;
+    /**
+     * JWT tokens (example: header.payload.signature).
+     */
+    readonly JWT: RegExp;
+    /**
+     * Authorization Bearer tokens (example: Bearer <token>).
+     */
+    readonly BEARER: RegExp;
+    /**
+     * HEX-colors (example: #FFF, #FFFFFF, #FFFFFFFF).
+     */
+    readonly HEX_COLOR: RegExp;
+    /**
+     * IP (IPv4, IPv6 or any).
+     */
+    readonly IP: {
+        /** IPv4 (example: 192.168.1.1 or 127.0.0.1) */
+        readonly V4: RegExp;
+        /** IPv6 (example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334) */
+        readonly V6: RegExp;
+        /** Any IP address (IPv4 or IPv6) */
+        readonly ANY: RegExp;
+    };
+};
+
+export { PATTERNS, firefoxClipboardPrefs };

package/dist/constants/index.d.ts

@@ -0,0 +1,51 @@
+declare const firefoxClipboardPrefs: {
+    'dom.events.testing.asyncClipboard': boolean;
+    'dom.events.asyncClipboard.readText': boolean;
+    'dom.events.asyncClipboard.writeText': boolean;
+    'permissions.default.clipboard-read': number;
+    'permissions.default.clipboard-write': number;
+};
+
+/**
+ * This module contains regular expression patterns for various common formats.
+ * These patterns can be used for validation purposes in applications.
+ */
+declare const PATTERNS: {
+    /**
+     * UUID v1-v5 (example: 123e4567-e89b-12d3-a456-426614174000).
+     */
+    readonly UUID: RegExp;
+    /**
+     * Email addresses (example: user@example.com).
+     */
+    readonly EMAIL: RegExp;
+    /**
+     * Phone numbers in E.164 format (example: +1234567890).
+     */
+    readonly PHONE: RegExp;
+    /**
+     * JWT tokens (example: header.payload.signature).
+     */
+    readonly JWT: RegExp;
+    /**
+     * Authorization Bearer tokens (example: Bearer <token>).
+     */
+    readonly BEARER: RegExp;
+    /**
+     * HEX-colors (example: #FFF, #FFFFFF, #FFFFFFFF).
+     */
+    readonly HEX_COLOR: RegExp;
+    /**
+     * IP (IPv4, IPv6 or any).
+     */
+    readonly IP: {
+        /** IPv4 (example: 192.168.1.1 or 127.0.0.1) */
+        readonly V4: RegExp;
+        /** IPv6 (example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334) */
+        readonly V6: RegExp;
+        /** Any IP address (IPv4 or IPv6) */
+        readonly ANY: RegExp;
+    };
+};
+
+export { PATTERNS, firefoxClipboardPrefs };

package/dist/constants/index.js

@@ -0,0 +1,52 @@
+// src/constants/constants.ts
+var firefoxClipboardPrefs = {
+  "dom.events.testing.asyncClipboard": true,
+  "dom.events.asyncClipboard.readText": true,
+  "dom.events.asyncClipboard.writeText": true,
+  "permissions.default.clipboard-read": 1,
+  "permissions.default.clipboard-write": 1
+};
+
+// src/constants/patterns.ts
+var PATTERNS = {
+  /**
+   * UUID v1-v5 (example: 123e4567-e89b-12d3-a456-426614174000).
+   */
+  UUID: /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,
+  /**
+   * Email addresses (example: user@example.com).
+   */
+  EMAIL: /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/,
+  /**
+   * Phone numbers in E.164 format (example: +1234567890).
+   */
+  PHONE: /^\+[1-9]\d{1,14}$/,
+  /**
+   * JWT tokens (example: header.payload.signature).
+   */
+  JWT: /^[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+$/,
+  /**
+   * Authorization Bearer tokens (example: Bearer <token>).
+   */
+  BEARER: /^Bearer\s+[a-zA-Z0-9._~+/-]+=*$/i,
+  /**
+   * HEX-colors (example: #FFF, #FFFFFF, #FFFFFFFF).
+   */
+  HEX_COLOR: /^#([0-9a-f]{3}|[0-9a-f]{6}|[0-9a-f]{8})$/i,
+  /**
+   * IP (IPv4, IPv6 or any).
+   */
+  IP: {
+    /** IPv4 (example: 192.168.1.1 or 127.0.0.1) */
+    V4: /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/,
+    /** IPv6 (example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334) */
+    V6: /^(([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9]))$/,
+    /** Any IP address (IPv4 or IPv6) */
+    ANY: /^(?:(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)|(?:([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])))$/
+  }
+};
+export {
+  PATTERNS,
+  firefoxClipboardPrefs
+};
+//# sourceMappingURL=index.js.map

package/dist/constants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/constants/constants.ts","../../src/constants/patterns.ts"],"sourcesContent":["export const firefoxClipboardPrefs = {\n  'dom.events.testing.asyncClipboard': true,\n  'dom.events.asyncClipboard.readText': true,\n  'dom.events.asyncClipboard.writeText': true,\n  'permissions.default.clipboard-read': 1,\n  'permissions.default.clipboard-write': 1,\n};\n","/**\n * This module contains regular expression patterns for various common formats.\n * These patterns can be used for validation purposes in applications.\n */\nexport const PATTERNS = {\n  /**\n   * UUID v1-v5 (example: 123e4567-e89b-12d3-a456-426614174000).\n   */\n  UUID: /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i,\n\n  /**\n   * Email addresses (example: user@example.com).\n   */\n  EMAIL: /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$/,\n\n  /**\n   * Phone numbers in E.164 format (example: +1234567890).\n   */\n  PHONE: /^\\+[1-9]\\d{1,14}$/,\n\n  /**\n   * JWT tokens (example: header.payload.signature).\n   */\n  JWT: /^[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+$/,\n\n  /**\n   * Authorization Bearer tokens (example: Bearer <token>).\n   */\n  BEARER: /^Bearer\\s+[a-zA-Z0-9._~+/-]+=*$/i,\n\n  /**\n   * HEX-colors (example: #FFF, #FFFFFF, #FFFFFFFF).\n   */\n  HEX_COLOR: /^#([0-9a-f]{3}|[0-9a-f]{6}|[0-9a-f]{8})$/i,\n\n  /**\n   * IP (IPv4, IPv6 or any).\n   */\n  IP: {\n    /** IPv4 (example: 192.168.1.1 or 127.0.0.1) */\n    V4: /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/,\n\n    /** IPv6 (example: 2001:0db8:85a3:0000:0000:8a2e:0370:7334) */\n    V6: /^(([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9]))$/,\n\n    /** Any IP address (IPv4 or IPv6) */\n    ANY: /^(?:(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)|(?:([0-9a-fA-F]{1,4}:){7,7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|fe80:(:[0-9a-fA-F]{0,4}){0,4}%[0-9a-zA-Z]{1,}|::(ffff(:0{1,4}){0,1}:){0,1}((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])\\.){3,3}(25[0-5]|(2[0-4]|1{0,1}[0-9]){0,1}[0-9])))$/,\n  },\n} as const;\n"],"mappings":";AAAO,IAAM,wBAAwB;AAAA,EACnC,qCAAqC;AAAA,EACrC,sCAAsC;AAAA,EACtC,uCAAuC;AAAA,EACvC,sCAAsC;AAAA,EACtC,uCAAuC;AACzC;;;ACFO,IAAM,WAAW;AAAA;AAAA;AAAA;AAAA,EAItB,MAAM;AAAA;AAAA;AAAA;AAAA,EAKN,OAAO;AAAA;AAAA;AAAA;AAAA,EAKP,OAAO;AAAA;AAAA;AAAA;AAAA,EAKP,KAAK;AAAA;AAAA;AAAA;AAAA,EAKL,QAAQ;AAAA;AAAA;AAAA;AAAA,EAKR,WAAW;AAAA;AAAA;AAAA;AAAA,EAKX,IAAI;AAAA;AAAA,IAEF,IAAI;AAAA;AAAA,IAGJ,IAAI;AAAA;AAAA,IAGJ,KAAK;AAAA,EACP;AACF;","names":[]}