@gpichot/testing-ui 0.0.1

package/dist/__tests__/setup.d.ts

@@ -0,0 +1,2 @@
+import "@testing-library/jest-dom/vitest";
+//# sourceMappingURL=setup.d.ts.map

package/dist/__tests__/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/__tests__/setup.ts"],"names":[],"mappings":"AAAA,OAAO,kCAAkC,CAAC"}

package/dist/__tests__/setup.js

@@ -0,0 +1,2 @@
+import "@testing-library/jest-dom/vitest";
+//# sourceMappingURL=setup.js.map

package/dist/__tests__/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/__tests__/setup.ts"],"names":[],"mappings":"AAAA,OAAO,kCAAkC,CAAC"}

package/dist/adapters/playwright.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Playwright adapter.
+ *
+ * @example
+ * ```ts
+ * import { playwright } from "testing-ui/adapters/playwright";
+ * import { test } from "@playwright/test";
+ *
+ * test("example", async ({ page }) => {
+ *   const locator = playwright(page);
+ *   const { elements, actions } = myWidget.from(locator);
+ * });
+ * ```
+ */
+import type { Locator } from "../types.js";
+/** Minimal Playwright locator/page surface we depend on (no compile-time dep). */
+interface PwLocatable {
+    getByRole(role: string, options?: {
+        name?: string | RegExp;
+    }): PwLocatable;
+    getByLabel(text: string | RegExp): PwLocatable;
+    getByPlaceholder(text: string | RegExp): PwLocatable;
+    getByText(text: string | RegExp): PwLocatable;
+    getByTestId(testId: string): PwLocatable;
+    click(): Promise<void>;
+    fill(value: string): Promise<void>;
+    check(): Promise<void>;
+    uncheck(): Promise<void>;
+    selectOption(value: string | string[]): Promise<void>;
+    clear(): Promise<void>;
+    textContent(): Promise<string | null>;
+    getAttribute(name: string): Promise<string | null>;
+    inputValue(): Promise<string>;
+    isVisible(): Promise<boolean>;
+    isEnabled(): Promise<boolean>;
+    isChecked(): Promise<boolean>;
+    all(): Promise<PwLocatable[]>;
+}
+export declare function playwright(page: PwLocatable): Locator;
+export {};
+//# sourceMappingURL=playwright.d.ts.map

package/dist/adapters/playwright.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright.d.ts","sourceRoot":"","sources":["../../src/adapters/playwright.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAiB,OAAO,EAAkB,MAAM,aAAa,CAAC;AAE1E,kFAAkF;AAClF,UAAU,WAAW;IACpB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,GAAG,WAAW,CAAC;IAC3E,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC;IAC/C,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC;IACrD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC;IAC9C,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC;IACzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACtC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACnD,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9B,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,GAAG,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CAC9B;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAErD"}

package/dist/adapters/playwright.js

@@ -0,0 +1,92 @@
+/**
+ * Playwright adapter.
+ *
+ * @example
+ * ```ts
+ * import { playwright } from "testing-ui/adapters/playwright";
+ * import { test } from "@playwright/test";
+ *
+ * test("example", async ({ page }) => {
+ *   const locator = playwright(page);
+ *   const { elements, actions } = myWidget.from(locator);
+ * });
+ * ```
+ */
+import { asCallable } from "../callable.js";
+export function playwright(page) {
+    return asCallable(new PwAdapter(page));
+}
+class PwAdapter {
+    pw;
+    constructor(pw) {
+        this.pw = pw;
+    }
+    getByRole(role, options) {
+        return asCallable(new PwAdapter(this.pw.getByRole(role, options ? { name: options.name } : undefined)));
+    }
+    getByLabel(text) {
+        return asCallable(new PwAdapter(this.pw.getByLabel(text)));
+    }
+    getByPlaceholder(text) {
+        return asCallable(new PwAdapter(this.pw.getByPlaceholder(text)));
+    }
+    getByText(text) {
+        return asCallable(new PwAdapter(this.pw.getByText(text)));
+    }
+    getByTestId(testId) {
+        return asCallable(new PwAdapter(this.pw.getByTestId(testId)));
+    }
+    get() {
+        return this.pw;
+    }
+    getAll() {
+        throw new Error("Playwright getAll() is async — use find() or await locator.get().all() instead");
+    }
+    query() {
+        // Playwright locators are always lazy — query() returns the locator itself
+        return this.pw;
+    }
+    queryAll() {
+        throw new Error("Playwright queryAll() is async — use await locator.get().all() instead");
+    }
+    async find() {
+        return this.pw;
+    }
+    click() {
+        return this.pw.click();
+    }
+    fill(value) {
+        return this.pw.fill(value);
+    }
+    check() {
+        return this.pw.check();
+    }
+    uncheck() {
+        return this.pw.uncheck();
+    }
+    selectOption(value) {
+        return this.pw.selectOption(value);
+    }
+    clear() {
+        return this.pw.clear();
+    }
+    textContent() {
+        return this.pw.textContent();
+    }
+    getAttribute(name) {
+        return this.pw.getAttribute(name);
+    }
+    inputValue() {
+        return this.pw.inputValue();
+    }
+    isVisible() {
+        return this.pw.isVisible();
+    }
+    isEnabled() {
+        return this.pw.isEnabled();
+    }
+    isChecked() {
+        return this.pw.isChecked();
+    }
+}
+//# sourceMappingURL=playwright.js.map

package/dist/adapters/playwright.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright.js","sourceRoot":"","sources":["../../src/adapters/playwright.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAyB5C,MAAM,UAAU,UAAU,CAAC,IAAiB;IAC3C,OAAO,UAAU,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,SAAS;IACM;IAApB,YAAoB,EAAe;QAAf,OAAE,GAAF,EAAE,CAAa;IAAG,CAAC;IAEvC,SAAS,CAAC,IAAY,EAAE,OAAuB;QAC9C,OAAO,UAAU,CAChB,IAAI,SAAS,CACZ,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CACrE,CACD,CAAC;IACH,CAAC;IAED,UAAU,CAAC,IAAqB;QAC/B,OAAO,UAAU,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,gBAAgB,CAAC,IAAqB;QACrC,OAAO,UAAU,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,SAAS,CAAC,IAAqB;QAC9B,OAAO,UAAU,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,WAAW,CAAC,MAAc;QACzB,OAAO,UAAU,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,GAAG;QACF,OAAO,IAAI,CAAC,EAAE,CAAC;IAChB,CAAC;IAED,MAAM;QACL,MAAM,IAAI,KAAK,CACd,gFAAgF,CAChF,CAAC;IACH,CAAC;IAED,KAAK;QACJ,2EAA2E;QAC3E,OAAO,IAAI,CAAC,EAAE,CAAC;IAChB,CAAC;IAED,QAAQ;QACP,MAAM,IAAI,KAAK,CACd,wEAAwE,CACxE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI;QACT,OAAO,IAAI,CAAC,EAAE,CAAC;IAChB,CAAC;IAED,KAAK;QACJ,OAAO,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IACD,IAAI,CAAC,KAAa;QACjB,OAAO,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IACD,KAAK;QACJ,OAAO,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IACD,OAAO;QACN,OAAO,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC;IAC1B,CAAC;IACD,YAAY,CAAC,KAAwB;QACpC,OAAO,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IACD,KAAK;QACJ,OAAO,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED,WAAW;QACV,OAAO,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9B,CAAC;IACD,YAAY,CAAC,IAAY;QACxB,OAAO,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IACD,UAAU;QACT,OAAO,IAAI,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC;IAC7B,CAAC;IACD,SAAS;QACR,OAAO,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC;IAC5B,CAAC;IACD,SAAS;QACR,OAAO,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC;IAC5B,CAAC;IACD,SAAS;QACR,OAAO,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC;IAC5B,CAAC;CACD"}

package/dist/adapters/rtl.d.ts

@@ -0,0 +1,25 @@
+/**
+ * React Testing Library adapter.
+ *
+ * @example
+ * ```ts
+ * import { rtl } from "testing-ui/adapters/rtl";
+ * import { render } from "@testing-library/react";
+ * import userEvent from "@testing-library/user-event";
+ *
+ * const user = userEvent.setup();
+ * const { container } = render(<MyComponent />);
+ * const locator = rtl(container, user);
+ * ```
+ */
+import type { Locator } from "../types.js";
+/** Minimal userEvent interface — avoids compile-time dep on @testing-library/user-event */
+interface UserEventLike {
+    click(element: Element): Promise<void>;
+    type(element: Element, text: string, options?: object): Promise<void>;
+    clear(element: Element): Promise<void>;
+    selectOptions(element: Element, values: string | string[] | HTMLElement | HTMLElement[]): Promise<void>;
+}
+export declare function rtl(container?: HTMLElement, user?: UserEventLike): Locator;
+export {};
+//# sourceMappingURL=rtl.d.ts.map

package/dist/adapters/rtl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtl.d.ts","sourceRoot":"","sources":["../../src/adapters/rtl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAiB,OAAO,EAAkB,MAAM,aAAa,CAAC;AAE1E,2FAA2F;AAC3F,UAAU,aAAa;IACtB,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,aAAa,CACZ,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,WAAW,GAAG,WAAW,EAAE,GACrD,OAAO,CAAC,IAAI,CAAC,CAAC;CACjB;AAED,wBAAgB,GAAG,CAClB,SAAS,GAAE,WAA2B,EACtC,IAAI,CAAC,EAAE,aAAa,GAClB,OAAO,CAET"}

package/dist/adapters/rtl.js

@@ -0,0 +1,261 @@
+/**
+ * React Testing Library adapter.
+ *
+ * @example
+ * ```ts
+ * import { rtl } from "testing-ui/adapters/rtl";
+ * import { render } from "@testing-library/react";
+ * import userEvent from "@testing-library/user-event";
+ *
+ * const user = userEvent.setup();
+ * const { container } = render(<MyComponent />);
+ * const locator = rtl(container, user);
+ * ```
+ */
+import { asCallable } from "../callable.js";
+export function rtl(container = document.body, user) {
+    return asCallable(new RtlLocator(() => container, user));
+}
+class RtlLocator {
+    resolve;
+    user;
+    constructor(resolve, user, query, parentResolve) {
+        this.resolve = resolve;
+        this.user = user;
+        this.query_ = query;
+        this.parentResolve = parentResolve;
+    }
+    // --- Queries (lazy) ---------------------------------------------------
+    getByRole(role, options) {
+        return this.lazy({ kind: "role", role, options });
+    }
+    getByLabel(text) {
+        return this.lazy({ kind: "label", text });
+    }
+    getByPlaceholder(text) {
+        return this.lazy({ kind: "placeholder", text });
+    }
+    getByText(text) {
+        return this.lazy({ kind: "text", text });
+    }
+    getByTestId(id) {
+        return this.lazy({ kind: "testid", id });
+    }
+    // --- Resolution -------------------------------------------------------
+    get() {
+        return this.resolve();
+    }
+    getAll() {
+        return this.resolveAll();
+    }
+    query() {
+        try {
+            return this.resolve();
+        }
+        catch {
+            return null;
+        }
+    }
+    queryAll() {
+        try {
+            return this.resolveAll();
+        }
+        catch {
+            return [];
+        }
+    }
+    async find() {
+        return this.resolve();
+    }
+    // --- Actions ----------------------------------------------------------
+    async click() {
+        const el = this.resolve();
+        if (this.user)
+            return this.user.click(el);
+        el.click();
+    }
+    async fill(value) {
+        const el = this.resolve();
+        if (this.user) {
+            await this.user.clear(el);
+            return this.user.type(el, value);
+        }
+        setNativeValue(el, value);
+    }
+    async check() {
+        const el = this.resolve();
+        if (!el.checked)
+            await this.click();
+    }
+    async uncheck() {
+        const el = this.resolve();
+        if (el.checked)
+            await this.click();
+    }
+    async selectOption(value) {
+        const el = this.resolve();
+        if (this.user)
+            return this.user.selectOptions(el, value);
+        const values = Array.isArray(value) ? value : [value];
+        for (const opt of Array.from(el.options)) {
+            opt.selected = values.includes(opt.value);
+        }
+        el.dispatchEvent(new Event("change", { bubbles: true }));
+    }
+    async clear() {
+        const el = this.resolve();
+        if (this.user)
+            return this.user.clear(el);
+        setNativeValue(el, "");
+    }
+    // --- State ------------------------------------------------------------
+    async textContent() {
+        return this.resolve().textContent;
+    }
+    async getAttribute(name) {
+        return this.resolve().getAttribute(name);
+    }
+    async inputValue() {
+        return this.resolve().value;
+    }
+    async isVisible() {
+        const el = this.resolve();
+        const style = window.getComputedStyle(el);
+        return (style.display !== "none" &&
+            style.visibility !== "hidden" &&
+            style.opacity !== "0");
+    }
+    async isEnabled() {
+        return !this.resolve().disabled;
+    }
+    async isChecked() {
+        return this.resolve().checked;
+    }
+    // --- Internal ---------------------------------------------------------
+    lazy(query) {
+        return asCallable(new RtlLocator(() => runQuery(this.resolve(), query), this.user, query, this.resolve));
+    }
+    resolveAll() {
+        if (!this.query_ || !this.parentResolve) {
+            return [this.resolve()];
+        }
+        return runQueryAll(this.parentResolve(), this.query_);
+    }
+    query_;
+    parentResolve;
+}
+// ---------------------------------------------------------------------------
+// Minimal DOM query helpers (no @testing-library/dom dependency)
+// ---------------------------------------------------------------------------
+function matches(actual, expected) {
+    return typeof expected === "string"
+        ? actual === expected
+        : expected.test(actual);
+}
+function runQuery(root, q) {
+    const results = runQueryAll(root, q);
+    if (results.length === 0) {
+        throwNotFound(q);
+    }
+    return results[0];
+}
+function runQueryAll(root, q) {
+    switch (q.kind) {
+        case "role":
+            return findAllByRole(root, q.role, q.options);
+        case "label":
+            return findAllByLabel(root, q.text);
+        case "placeholder":
+            return findAllByAttr(root, "placeholder", q.text);
+        case "text":
+            return findAllByText(root, q.text);
+        case "testid":
+            return findAllByAttr(root, "data-testid", q.id);
+    }
+}
+function throwNotFound(q) {
+    switch (q.kind) {
+        case "role":
+            throw new Error(`Unable to find element with role "${q.role}"${q.options?.name ? ` and name "${q.options.name}"` : ""}`);
+        case "label":
+            throw new Error(`Unable to find element with label "${q.text}"`);
+        case "text":
+            throw new Error(`Unable to find element with text "${q.text}"`);
+        case "placeholder":
+            throw new Error(`Unable to find element with placeholder "${q.text}"`);
+        case "testid":
+            throw new Error(`Unable to find element with data-testid "${q.id}"`);
+    }
+}
+// Map common implicit roles to selectors
+const implicitRoles = {
+    button: 'button, [role="button"], input[type="button"], input[type="submit"]',
+    textbox: 'input:not([type]), input[type="text"], textarea, [role="textbox"]',
+    checkbox: 'input[type="checkbox"], [role="checkbox"]',
+    radio: 'input[type="radio"], [role="radio"]',
+    link: 'a[href], [role="link"]',
+    heading: "h1, h2, h3, h4, h5, h6, [role=heading]",
+    list: 'ul, ol, [role="list"]',
+    listitem: 'li, [role="listitem"]',
+    combobox: 'select, [role="combobox"]',
+    dialog: 'dialog, [role="dialog"]',
+    img: 'img[alt], [role="img"]',
+};
+function findAllByRole(root, role, options) {
+    const selector = implicitRoles[role] ?? `[role="${role}"]`;
+    const results = [];
+    for (const el of Array.from(root.querySelectorAll(selector))) {
+        if (options?.name !== undefined) {
+            const accessible = el.getAttribute("aria-label") ?? el.textContent?.trim() ?? "";
+            if (!matches(accessible, options.name))
+                continue;
+        }
+        results.push(el);
+    }
+    return results;
+}
+function findAllByLabel(root, text) {
+    const results = [];
+    for (const label of Array.from(root.querySelectorAll("label"))) {
+        if (!matches(label.textContent?.trim() ?? "", text))
+            continue;
+        const forId = label.getAttribute("for");
+        if (forId) {
+            const el = root.querySelector(`#${forId}`);
+            if (el)
+                results.push(el);
+        }
+        const input = label.querySelector("input, select, textarea");
+        if (input)
+            results.push(input);
+    }
+    for (const el of Array.from(root.querySelectorAll("*"))) {
+        const aria = el.getAttribute("aria-label");
+        if (aria && matches(aria, text) && !results.includes(el))
+            results.push(el);
+    }
+    return results;
+}
+function findAllByText(root, text) {
+    const results = [];
+    for (const el of Array.from(root.querySelectorAll("*"))) {
+        if (el.children.length === 0 && matches(el.textContent?.trim() ?? "", text))
+            results.push(el);
+    }
+    return results;
+}
+function findAllByAttr(root, attr, value) {
+    const results = [];
+    for (const el of Array.from(root.querySelectorAll(`[${attr}]`))) {
+        if (matches(el.getAttribute(attr) ?? "", value))
+            results.push(el);
+    }
+    return results;
+}
+function setNativeValue(el, value) {
+    const desc = Object.getOwnPropertyDescriptor(Object.getPrototypeOf(el), "value");
+    desc?.set?.call(el, value);
+    el.dispatchEvent(new Event("input", { bubbles: true }));
+    el.dispatchEvent(new Event("change", { bubbles: true }));
+}
+//# sourceMappingURL=rtl.js.map

package/dist/adapters/rtl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtl.js","sourceRoot":"","sources":["../../src/adapters/rtl.ts"],"names":[],"mappings":"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"}

package/dist/callable.d.ts

@@ -0,0 +1,7 @@
+import type { Locator, LocatorMethods } from "./types.js";
+/**
+ * Wrap a LocatorMethods implementation so it is callable.
+ * Calling the returned object directly is shorthand for `.get()`.
+ */
+export declare function asCallable(impl: LocatorMethods): Locator;
+//# sourceMappingURL=callable.d.ts.map

package/dist/callable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callable.d.ts","sourceRoot":"","sources":["../src/callable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAUxD"}

package/dist/callable.js

@@ -0,0 +1,16 @@
+/**
+ * Wrap a LocatorMethods implementation so it is callable.
+ * Calling the returned object directly is shorthand for `.get()`.
+ */
+export function asCallable(impl) {
+    const fn = (() => impl.get());
+    return new Proxy(fn, {
+        get(_target, prop, receiver) {
+            if (prop in impl) {
+                return impl[prop];
+            }
+            return Reflect.get(fn, prop, receiver);
+        },
+    });
+}
+//# sourceMappingURL=callable.js.map

package/dist/callable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callable.js","sourceRoot":"","sources":["../src/callable.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAoB;IAC9C,MAAM,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAuB,CAAC;IACpD,OAAO,IAAI,KAAK,CAAC,EAAE,EAAE;QACpB,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ;YAC1B,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;gBAClB,OAAQ,IAAoD,CAAC,IAAI,CAAC,CAAC;YACpE,CAAC;YACD,OAAO,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;QACxC,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}

package/dist/enhanced.d.ts

@@ -0,0 +1,33 @@
+import type { ByRoleOptions, Locator } from "./types.js";
+/**
+ * Extended locator with role shortcuts and concise aliases.
+ * Adapters implement the base `Locator`; these shortcuts are added
+ * automatically by `widget()`.
+ */
+export interface LocatorWith extends Locator {
+    byRole(role: string, options?: ByRoleOptions): LocatorWith;
+    byLabel(text: string | RegExp): LocatorWith;
+    byPlaceholder(text: string | RegExp): LocatorWith;
+    byText(text: string | RegExp): LocatorWith;
+    byTestId(testId: string): LocatorWith;
+    button(options?: Pick<ByRoleOptions, "name">): LocatorWith;
+    link(options?: Pick<ByRoleOptions, "name">): LocatorWith;
+    textbox(options?: Pick<ByRoleOptions, "name">): LocatorWith;
+    checkbox(options?: Pick<ByRoleOptions, "name" | "checked">): LocatorWith;
+    radio(options?: Pick<ByRoleOptions, "name" | "checked">): LocatorWith;
+    combobox(options?: Pick<ByRoleOptions, "name">): LocatorWith;
+    heading(options?: Pick<ByRoleOptions, "name">): LocatorWith;
+    dialog(options?: Pick<ByRoleOptions, "name">): LocatorWith;
+    list(options?: Pick<ByRoleOptions, "name">): LocatorWith;
+    listitem(options?: Pick<ByRoleOptions, "name">): LocatorWith;
+    img(options?: Pick<ByRoleOptions, "name">): LocatorWith;
+    tab(options?: Pick<ByRoleOptions, "name" | "selected">): LocatorWith;
+    tabpanel(options?: Pick<ByRoleOptions, "name">): LocatorWith;
+    navigation(options?: Pick<ByRoleOptions, "name">): LocatorWith;
+    region(options?: Pick<ByRoleOptions, "name">): LocatorWith;
+}
+/**
+ * Wrap a base Locator with shortcut methods.
+ */
+export declare function enhance(base: Locator): LocatorWith;
+//# sourceMappingURL=enhanced.d.ts.map

package/dist/enhanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enhanced.d.ts","sourceRoot":"","sources":["../src/enhanced.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAkB,MAAM,YAAY,CAAC;AAEzE;;;;GAIG;AACH,MAAM,WAAW,WAAY,SAAQ,OAAO;IAE3C,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,WAAW,CAAC;IAC3D,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC;IAC5C,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC;IAClD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC;IAGtC,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC;IAC3D,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC;IACzD,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC;IAC5D,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,WAAW,CAAC;IACzE,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,WAAW,CAAC;IACtE,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC;IAC7D,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC;IAC5D,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC;IAC3D,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC;IACzD,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC;IAC7D,GAAG,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC;IACxD,GAAG,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,UAAU,CAAC,GAAG,WAAW,CAAC;IACrE,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC;IAC7D,UAAU,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC;IAC/D,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC;CAC3D;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,CAElD"}

package/dist/enhanced.js

@@ -0,0 +1,146 @@
+import { asCallable } from "./callable.js";
+/**
+ * Wrap a base Locator with shortcut methods.
+ */
+export function enhance(base) {
+    return asCallable(new LocatorProxy(base));
+}
+class LocatorProxy {
+    base;
+    constructor(base) {
+        this.base = base;
+    }
+    // --- Base Locator (delegate & wrap) ------------------------------------
+    wrap(locator) {
+        return asCallable(new LocatorProxy(locator));
+    }
+    getByRole(role, options) {
+        return this.wrap(this.base.getByRole(role, options));
+    }
+    getByLabel(text) {
+        return this.wrap(this.base.getByLabel(text));
+    }
+    getByPlaceholder(text) {
+        return this.wrap(this.base.getByPlaceholder(text));
+    }
+    getByText(text) {
+        return this.wrap(this.base.getByText(text));
+    }
+    getByTestId(testId) {
+        return this.wrap(this.base.getByTestId(testId));
+    }
+    get() {
+        return this.base.get();
+    }
+    getAll() {
+        return this.base.getAll();
+    }
+    query() {
+        return this.base.query();
+    }
+    queryAll() {
+        return this.base.queryAll();
+    }
+    find() {
+        return this.base.find();
+    }
+    click() {
+        return this.base.click();
+    }
+    fill(value) {
+        return this.base.fill(value);
+    }
+    check() {
+        return this.base.check();
+    }
+    uncheck() {
+        return this.base.uncheck();
+    }
+    selectOption(value) {
+        return this.base.selectOption(value);
+    }
+    clear() {
+        return this.base.clear();
+    }
+    textContent() {
+        return this.base.textContent();
+    }
+    getAttribute(name) {
+        return this.base.getAttribute(name);
+    }
+    inputValue() {
+        return this.base.inputValue();
+    }
+    isVisible() {
+        return this.base.isVisible();
+    }
+    isEnabled() {
+        return this.base.isEnabled();
+    }
+    isChecked() {
+        return this.base.isChecked();
+    }
+    // --- Short aliases ----------------------------------------------------
+    byRole(role, options) {
+        return this.getByRole(role, options);
+    }
+    byLabel(text) {
+        return this.getByLabel(text);
+    }
+    byPlaceholder(text) {
+        return this.getByPlaceholder(text);
+    }
+    byText(text) {
+        return this.getByText(text);
+    }
+    byTestId(testId) {
+        return this.getByTestId(testId);
+    }
+    // --- Role shortcuts ---------------------------------------------------
+    button(options) {
+        return this.getByRole("button", options);
+    }
+    link(options) {
+        return this.getByRole("link", options);
+    }
+    textbox(options) {
+        return this.getByRole("textbox", options);
+    }
+    checkbox(options) {
+        return this.getByRole("checkbox", options);
+    }
+    radio(options) {
+        return this.getByRole("radio", options);
+    }
+    combobox(options) {
+        return this.getByRole("combobox", options);
+    }
+    heading(options) {
+        return this.getByRole("heading", options);
+    }
+    dialog(options) {
+        return this.getByRole("dialog", options);
+    }
+    list(options) {
+        return this.getByRole("list", options);
+    }
+    listitem(options) {
+        return this.getByRole("listitem", options);
+    }
+    img(options) {
+        return this.getByRole("img", options);
+    }
+    tab(options) {
+        return this.getByRole("tab", options);
+    }
+    tabpanel(options) {
+        return this.getByRole("tabpanel", options);
+    }
+    navigation(options) {
+        return this.getByRole("navigation", options);
+    }
+    region(options) {
+        return this.getByRole("region", options);
+    }
+}
+//# sourceMappingURL=enhanced.js.map

package/dist/enhanced.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enhanced.js","sourceRoot":"","sources":["../src/enhanced.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { widget } from "./widget.js";
+export type { WidgetDef } from "./widget.js";
+export type { Locator, LocatorMethods, ByRoleOptions } from "./types.js";
+export type { LocatorWith } from "./enhanced.js";
+export { enhance } from "./enhanced.js";
+export { asCallable } from "./callable.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { widget } from "./widget.js";
+export { enhance } from "./enhanced.js";
+export { asCallable } from "./callable.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAIrC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Methods available on a locator — implemented by adapter classes.
+ * Use {@link Locator} for the public-facing callable type.
+ */
+export interface LocatorMethods {
+    getByRole(role: string, options?: ByRoleOptions): Locator;
+    getByLabel(text: string | RegExp): Locator;
+    getByPlaceholder(text: string | RegExp): Locator;
+    getByText(text: string | RegExp): Locator;
+    getByTestId(testId: string): Locator;
+    /** Resolve to the native element/locator. Throws if not found. */
+    get(): unknown;
+    /** Resolve all matching native elements/locators. Throws if none found. */
+    getAll(): unknown[];
+    /** Resolve to the native element/locator, or null if not found. */
+    query(): unknown | null;
+    /** Resolve all matching native elements/locators (empty array if none). */
+    queryAll(): unknown[];
+    /** Async resolution — waits for the element to appear. */
+    find(): Promise<unknown>;
+    click(): Promise<void>;
+    fill(value: string): Promise<void>;
+    check(): Promise<void>;
+    uncheck(): Promise<void>;
+    selectOption(value: string | string[]): Promise<void>;
+    clear(): Promise<void>;
+    textContent(): Promise<string | null>;
+    getAttribute(name: string): Promise<string | null>;
+    inputValue(): Promise<string>;
+    isVisible(): Promise<boolean>;
+    isEnabled(): Promise<boolean>;
+    isChecked(): Promise<boolean>;
+}
+/**
+ * A callable locator. Calling it directly is shorthand for `.get()`.
+ *
+ * @example
+ * ```ts
+ * const heading = locator.getByRole("heading");
+ * heading()       // → get() — returns the native element
+ * heading.get()   // same as above
+ * heading.query() // returns null instead of throwing
+ * ```
+ */
+export interface Locator extends LocatorMethods {
+    /** Shorthand for get(). */
+    (): unknown;
+}
+export interface ByRoleOptions {
+    name?: string | RegExp;
+    checked?: boolean;
+    disabled?: boolean;
+    expanded?: boolean;
+    selected?: boolean;
+    pressed?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,cAAc;IAE9B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC;IAC1D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC3C,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACjD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC1C,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAGrC,kEAAkE;IAClE,GAAG,IAAI,OAAO,CAAC;IACf,2EAA2E;IAC3E,MAAM,IAAI,OAAO,EAAE,CAAC;IACpB,mEAAmE;IACnE,KAAK,IAAI,OAAO,GAAG,IAAI,CAAC;IACxB,2EAA2E;IAC3E,QAAQ,IAAI,OAAO,EAAE,CAAC;IACtB,0DAA0D;IAC1D,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAGzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAGvB,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACtC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACnD,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9B,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9B;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,OAAQ,SAAQ,cAAc;IAC9C,2BAA2B;IAC3B,IAAI,OAAO,CAAC;CACZ;AAED,MAAM,WAAW,aAAa;IAC7B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/widget.d.ts

@@ -0,0 +1,38 @@
+import type { LocatorWith } from "./enhanced.js";
+import type { Locator } from "./types.js";
+/**
+ * Defines a reusable, runner-agnostic widget.
+ *
+ * The factory receives a {@link LocatorWith} — an enhanced locator with
+ * role shortcuts like `button()`, `textbox()`, `heading()` and short
+ * aliases like `byRole()`, `byLabel()`, `byText()`.
+ *
+ * @example
+ * ```ts
+ * const loginForm = widget((l) => ({
+ *   elements: {
+ *     email: () => l.byLabel("Email"),
+ *     password: () => l.byLabel("Password"),
+ *     submit: () => l.button({ name: "Sign in" }),
+ *   },
+ *   actions: {
+ *     login: async (email: string, password: string) => {
+ *       await l.byLabel("Email").fill(email);
+ *       await l.byLabel("Password").fill(password);
+ *       await l.button({ name: "Sign in" }).click();
+ *     },
+ *   },
+ * }));
+ *
+ * // Connect to RTL
+ * const { elements, actions } = loginForm.from(rtl(container, user));
+ *
+ * // Or Playwright
+ * const { elements, actions } = loginForm.from(playwright(page));
+ * ```
+ */
+export declare function widget<T>(factory: (locator: LocatorWith) => T): {
+    from(locator: Locator): T;
+};
+export type WidgetDef<T> = ReturnType<typeof widget<T>>;
+//# sourceMappingURL=widget.d.ts.map

package/dist/widget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget.d.ts","sourceRoot":"","sources":["../src/widget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,CAAC;kBAE9C,OAAO,GAAG,CAAC;EAI1B;AAED,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,UAAU,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/widget.js

@@ -0,0 +1,40 @@
+import { enhance } from "./enhanced.js";
+/**
+ * Defines a reusable, runner-agnostic widget.
+ *
+ * The factory receives a {@link LocatorWith} — an enhanced locator with
+ * role shortcuts like `button()`, `textbox()`, `heading()` and short
+ * aliases like `byRole()`, `byLabel()`, `byText()`.
+ *
+ * @example
+ * ```ts
+ * const loginForm = widget((l) => ({
+ *   elements: {
+ *     email: () => l.byLabel("Email"),
+ *     password: () => l.byLabel("Password"),
+ *     submit: () => l.button({ name: "Sign in" }),
+ *   },
+ *   actions: {
+ *     login: async (email: string, password: string) => {
+ *       await l.byLabel("Email").fill(email);
+ *       await l.byLabel("Password").fill(password);
+ *       await l.button({ name: "Sign in" }).click();
+ *     },
+ *   },
+ * }));
+ *
+ * // Connect to RTL
+ * const { elements, actions } = loginForm.from(rtl(container, user));
+ *
+ * // Or Playwright
+ * const { elements, actions } = loginForm.from(playwright(page));
+ * ```
+ */
+export function widget(factory) {
+    return {
+        from(locator) {
+            return factory(enhance(locator));
+        },
+    };
+}
+//# sourceMappingURL=widget.js.map

package/dist/widget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget.js","sourceRoot":"","sources":["../src/widget.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAGxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,MAAM,CAAI,OAAoC;IAC7D,OAAO;QACN,IAAI,CAAC,OAAgB;YACpB,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QAClC,CAAC;KACD,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@gpichot/testing-ui",
+  "version": "0.0.1",
+  "description": "Widget Object Model - framework and runner agnostic UI testing abstractions",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./adapters/rtl": {
+      "types": "./dist/adapters/rtl.d.ts",
+      "import": "./dist/adapters/rtl.js"
+    },
+    "./adapters/playwright": {
+      "types": "./dist/adapters/playwright.d.ts",
+      "import": "./dist/adapters/playwright.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "testing",
+    "widget-object-model",
+    "page-object-model",
+    "react-testing-library",
+    "playwright",
+    "ui-testing"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "@testing-library/react": ">=14",
+    "@playwright/test": ">=1"
+  },
+  "peerDependenciesMeta": {
+    "@testing-library/react": {
+      "optional": true
+    },
+    "@playwright/test": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "^6.0.0",
+    "jsdom": "^26.0.0",
+    "vitest": "^3.0.0",
+    "typescript": "^5.7.0"
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.build.json",
+    "test": "vitest run"
+  }
+}