pomwright 1.5.0 → 2.0.0

package/intTestV2/tests/testApp/color.spec.ts

@@ -1,15 +0,0 @@
-import { test } from "@fixtures-v2/testApp.fixtures";
-
-test("Should validate navigation using RegExp-based urlPath and fullUrl", async ({ testPath, color }) => {
-	await testPath.page.goto(testPath.fullUrl);
-
-	await testPath.expectThisPage();
-
-	const linkToColorPage = testPath.getNestedLocator("body.link@color");
-	await linkToColorPage.waitFor({ state: "visible" });
-
-	await linkToColorPage.click();
-
-	await color.expectThisPage();
-	await color.validateColorPage();
-});

package/intTestV2/tests/testApp/iframe.spec.ts

@@ -1,57 +0,0 @@
-import { expect, test } from "@fixtures-v2/testApp.fixtures";
-
-const toggleStates = {
-	on: "On",
-	off: "Off",
-} as const;
-
-test.describe("iframe handling", () => {
-	test.beforeEach(async ({ iframePage }) => {
-		await iframePage.page.goto(iframePage.fullUrl);
-	});
-
-	test("getLocator finds iframeA and iframeB", async ({ iframePage }) => {
-		const iframeA = iframePage.getLocator("sectionA.frame");
-		const iframeB = iframePage.getLocator("sectionB.frame");
-
-		await expect(iframeA).toBeVisible();
-		await expect(iframeB).toBeVisible();
-	});
-
-	test("getLocator does not finds iframeC as it is inside iframeB", async ({ iframePage }) => {
-		const iframeC = iframePage.getLocator("sectionB.frame.innerFrame");
-
-		await expect(iframeC).not.toBeVisible();
-	});
-
-	test("getNestedLocator finds iframeA and iframeB", async ({ iframePage }) => {
-		const iframeA = iframePage.getNestedLocator("sectionA.frame");
-		const iframeB = iframePage.getNestedLocator("sectionB.frame");
-
-		await expect(iframeA).toBeVisible();
-		await expect(iframeB).toBeVisible();
-	});
-
-	test("getNestedLocator finds nested iframeC", async ({ iframePage }) => {
-		const iframeC = iframePage.getNestedLocator("sectionB.frame.innerFrame");
-		await expect(iframeC).toBeVisible();
-	});
-
-	test("toggle elements inside each iframe", async ({ iframePage }) => {
-		const toggleA = iframePage.getNestedLocator("sectionA.frame.toggle");
-		const toggleB = iframePage.getNestedLocator("sectionB.frame.toggle");
-		const toggleC = iframePage.getNestedLocator("sectionB.frame.innerFrame.toggle");
-
-		await expect(toggleA).toHaveText(`Toggle A: ${toggleStates.off}`);
-		await expect(toggleB).toHaveText(`Toggle B: ${toggleStates.off}`);
-		await expect(toggleC).toHaveText(`Toggle C: ${toggleStates.off}`);
-
-		await toggleA.click();
-		await toggleB.click();
-		await toggleC.click();
-
-		await expect(toggleA).toHaveText(`Toggle A: ${toggleStates.on}`);
-		await expect(toggleB).toHaveText(`Toggle B: ${toggleStates.on}`);
-		await expect(toggleC).toHaveText(`Toggle C: ${toggleStates.on}`);
-	});
-});

package/intTestV2/tests/testApp/testFilters.spec.ts

@@ -1,24 +0,0 @@
-import { expect, test } from "@fixtures-v2/testApp.fixtures";
-
-test("locator definitions with options should resolve playground interactions", async ({ testFilters }) => {
-	await testFilters.page.goto(testFilters.fullUrl);
-
-	const playgroundSection = testFilters.getNestedLocator("body.section@playground");
-
-	const playgroundBtnRed = testFilters.getNestedLocator("body.section@playground.button@red");
-	await playgroundBtnRed.click();
-
-	await expect(playgroundSection).toHaveCSS("background-color", "rgb(255, 0, 0)");
-});
-
-test("getLocatorSchema propagates registered filters and indices to getLocator", async ({ testFilters }) => {
-	await testFilters.page.goto(testFilters.fullUrl);
-
-	const locator = testFilters
-		.getLocatorSchema("body.section@playground.button@reset")
-		.filter("body.section@playground.button@reset", { hasText: /Reset/i })
-		.nth("body.section@playground.button@reset", "first")
-		.getLocator();
-
-	expect(`${locator}`).toEqual("getByRole('button', { name: 'Reset Color' }).filter({ hasText: /Reset/i }).first()");
-});

package/intTestV2/tests/testApp/testPage.spec.ts

@@ -1,161 +0,0 @@
-import { expect, test } from "@fixtures-v2/testApp.fixtures";
-import { SessionStorage } from "pomwright";
-
-test("navigation.gotoThisPage runs post-navigation actions", async ({ testPage }) => {
-	expect(testPage.navigationActionCount.value).toBe(0);
-
-	await testPage.navigation.gotoThisPage();
-
-	expect(testPage.navigationActionCount.value).toBe(1);
-});
-
-test("topMenu should expose notification badge count", async ({ testPage }) => {
-	await testPage.page.goto(testPage.fullUrl);
-
-	const notificationBadge = testPage.getNestedLocator("topMenu.notifications.button.countBadge");
-	await expect(notificationBadge).toHaveText("3");
-});
-
-test("stepWithAdvancedReturnType should return the expected payload", async ({ testPage }) => {
-	await testPage.page.goto(testPage.fullUrl);
-
-	const result = await testPage.stepWithAdvancedReturnType();
-
-	expect(result.status).toBe("ready");
-	expect(result.payload[0]?.values[0]?.key).toBe("alpha");
-	expect(result.metadata.flags.has("beta")).toBe(true);
-	expect(result.metadata.versions.get("v2")?.hash).toBe("def456");
-	expect(result.startedAt.getTime()).toBe(0);
-});
-
-test.describe("getLocator helpers on web app", () => {
-	test.afterEach(async ({ testPage }) => {
-		await testPage.page.goto(testPage.fullUrl);
-	});
-
-	test("getLocator should return the single locator the complete LocatorSchemaPath resolves to", async ({
-		testPage,
-	}) => {
-		const locator = testPage.getLocator("topMenu.notifications.dropdown.item");
-		expect(locator).not.toBeNull();
-		expect(locator).not.toBeUndefined();
-		expect(`${locator}`).toEqual("locator('.w3-bar-item')");
-	});
-
-	test("should be able to manually chain locators returned by getLocator", async ({ testPage }) => {
-		const topMenu = testPage.getLocator("topMenu");
-
-		const topMenuNotifications = topMenu.locator(testPage.getLocator("topMenu.notifications"));
-
-		const topMenuNotificationsDropdown = topMenuNotifications.locator(
-			testPage.getLocator("topMenu.notifications.dropdown"),
-		);
-
-		const topMenuNotificationsDropdownItem = topMenuNotificationsDropdown.locator(
-			testPage.getLocator("topMenu.notifications.dropdown.item"),
-		);
-
-		expect(topMenuNotificationsDropdownItem).not.toBeNull();
-		expect(topMenuNotificationsDropdownItem).not.toBeUndefined();
-		expect(`${topMenuNotificationsDropdownItem}`).toEqual(
-			"locator('.w3-top').locator(locator('.w3-dropdown-hover')).locator(locator('.w3-dropdown-content')).locator(locator('.w3-bar-item'))",
-		);
-	});
-});
-
-test("getNestedLocator should support index overrides", async ({ testPage }) => {
-	await testPage.page.goto(testPage.fullUrl);
-
-	const secondNotification = testPage
-		.getLocatorSchema("topMenu.notifications.dropdown.item")
-		.nth("topMenu.notifications.dropdown.item", 1)
-		.getNestedLocator();
-	await expect(secondNotification).toHaveText("John Doe posted on your wall");
-
-	const lastNotification = testPage
-		.getLocatorSchema("topMenu.notifications.dropdown.item")
-		.nth("topMenu.notifications.dropdown.item", "last")
-		.getNestedLocator();
-	await expect(lastNotification).toHaveText("Jane likes your post");
-});
-
-test("setOnNextNavigation waits for a main-frame navigation", async ({ testPage }) => {
-	await testPage.page.goto(testPage.fullUrl);
-	await testPage.sessionStorage.clear();
-
-	await testPage.sessionStorage.setOnNextNavigation({ token: "abc" });
-	await expect(testPage.sessionStorage.get(["token"])).resolves.toEqual({});
-
-	await testPage.page.goto(testPage.fullUrl);
-	await expect(testPage.sessionStorage.get(["token"])).resolves.toEqual({ token: "abc" });
-});
-
-test("setOnNextNavigation merges multiple calls before navigation", async ({ testPage }) => {
-	await testPage.page.goto(testPage.fullUrl);
-	await testPage.sessionStorage.clear();
-
-	await testPage.sessionStorage.setOnNextNavigation({ token: "abc" });
-	await testPage.sessionStorage.setOnNextNavigation({ theme: "dark" });
-	await testPage.page.goto(testPage.fullUrl);
-
-	await expect(testPage.sessionStorage.get(["token", "theme"])).resolves.toEqual({
-		token: "abc",
-		theme: "dark",
-	});
-});
-
-test("clear can target specific keys", async ({ testPage }) => {
-	await testPage.page.goto(testPage.fullUrl);
-	await testPage.sessionStorage.set({ token: "abc", theme: "dark" });
-
-	await testPage.sessionStorage.clear("token");
-	await expect(testPage.sessionStorage.get(["token", "theme"])).resolves.toEqual({ theme: "dark" });
-});
-
-test("sessionStorage set/get supports waitForContext", async ({ testPage }) => {
-	await testPage.page.goto(testPage.fullUrl);
-
-	await testPage.sessionStorage.set({ token: "abc" }, { waitForContext: true });
-
-	const { token } = await testPage.sessionStorage.get(["token"], { waitForContext: true });
-	expect(token).toBe("abc");
-});
-
-test("sessionStorage clear supports keys and waitForContext", async ({ testPage }) => {
-	await testPage.page.goto(testPage.fullUrl);
-
-	await testPage.sessionStorage.set({ token: "abc", theme: "dark" }, { waitForContext: true });
-	await testPage.sessionStorage.clear("token", { waitForContext: true });
-
-	const data = await testPage.sessionStorage.get(["token", "theme"], { waitForContext: true });
-	expect(data.token).toBeUndefined();
-	expect(data.theme).toBe("dark");
-});
-
-test("sessionStorage set/get should write immediately on a loaded page", async ({ testPage }) => {
-	await testPage.page.goto(testPage.fullUrl);
-
-	await testPage.sessionStorage.set({ token: { value: "abc" } });
-
-	const data = await testPage.sessionStorage.get(["token"]);
-	expect(data.token).toEqual({ value: "abc" });
-});
-
-test("sessionStorage set with waitForContext should wait for navigation context", async ({ testPage }) => {
-	const freshPage = await testPage.page.context().newPage();
-	const sessionStorage = new SessionStorage(freshPage, { label: "SessionStorageTest" });
-
-	const navigation = freshPage.goto(testPage.fullUrl);
-	await sessionStorage.set({ token: { value: "waited" } }, { waitForContext: true });
-	await navigation;
-
-	const data = await sessionStorage.get(["token"]);
-	expect(data.token).toEqual({ value: "waited" });
-});
-
-test("sessionStorage operations reject without waitForContext when no context", async ({ testPage }) => {
-	const freshPage = await testPage.page.context().newPage();
-	const sessionStorage = new SessionStorage(freshPage, { label: "SessionStorageTest" });
-
-	await expect(sessionStorage.get(["token"])).rejects.toThrow("SessionStorage context is not available.");
-});

package/intTestV2/tests/testApp/testPath.spec.ts

@@ -1,18 +0,0 @@
-import { expect, test } from "@fixtures-v2/testApp.fixtures";
-
-test("navigation.goto prefixes baseUrl for URL paths", async ({ testPath }) => {
-	await testPath.navigation.goto("/testpath");
-	await testPath.navigation.expectThisPage();
-
-	expect(testPath.page.url()).toBe(testPath.fullUrl);
-});
-
-test("navigation.expectThisPage supports RegExp fullUrl", async ({ testPath, color }) => {
-	await testPath.navigation.gotoThisPage();
-
-	const linkToColorPage = testPath.getNestedLocator("body.link@color");
-	await linkToColorPage.waitFor({ state: "visible" });
-	await linkToColorPage.click();
-
-	await color.navigation.expectThisPage();
-});

package/pack-build.sh

@@ -1,11 +0,0 @@
-#!/bin/bash
-
-set -e
-
-VERSION=$(node -pe "require('./package.json').version")
-
-pnpm i --frozen-lockfile || { echo "Installation failed"; exit 1; }
-pnpm build || { echo "Build failed"; exit 1; }
-pnpm pack || { echo "Packaging failed"; exit 1; }
-
-echo "Built pomwright-$VERSION.tgz"

package/pack-test-v2.sh

@@ -1,36 +0,0 @@
-#!/bin/bash
-
-TEST_DIR="intTestV2"
-
-cleanup() {
-    if [[ $(basename "$PWD") != "$TEST_DIR" ]]; then
-        echo "Not in ./$TEST_DIR directory. Trying to change to ./$TEST_DIR directory..."
-        if [[ -d "$TEST_DIR" ]]; then
-            cd $TEST_DIR || { echo "Failed to change to ./$TEST_DIR directory"; return 1; }
-        else
-            echo "The ./$TEST_DIR directory does not exist. Exiting cleanup."
-            return 1
-        fi
-    fi
-
-    # echo "Reverting to latest published version of POMWright in the ./$TEST_DIR directory..."
-    # pnpm i -D pomwright@latest || { echo "Failed to revert to latest POMWright version"; exit 1; }
-}
-
-trap cleanup EXIT
-
-set -e
-
-VERSION=$(node -pe "require('./package.json').version")
-
-./pack-build.sh
-
-cd $TEST_DIR || { echo "Changing directory failed"; exit 1; }
-
-pnpm i -D "../pomwright-$VERSION.tgz" || { echo "Local package installation failed"; exit 1; }
-
-pnpm i --frozen-lockfile || { echo "Installation failed"; exit 1; }
-pnpm playwright install --with-deps || { echo "Playwright dependencies installation failed"; exit 1; }
-pnpm playwright test --project=chromium || { echo "Tests failed"; exit 1; }
-
-echo "Testing completed successfully."

package/playwright.base.ts

@@ -1,42 +0,0 @@
-// playwright.base.ts
-import type { PlaywrightTestConfig } from "@playwright/test";
-
-// this is only a *type* import → erased at runtime → does NOT trigger the double-load
-// everything below is plain data the subprojects can spread in
-
-export const baseConfig: PlaywrightTestConfig = {
-	// things you currently have in both configs:
-	globalTimeout: 60_000 * 5,
-	timeout: 60_000,
-	expect: {
-		timeout: 5_000,
-	},
-	fullyParallel: true,
-	forbidOnly: !!process.env.CI,
-	retries: process.env.CI ? 1 : 1,
-	workers: "50%",
-	reporter: process.env.CI
-		? [
-				["html", { open: "never" }],
-				["github", { printSteps: false }],
-			]
-		: [
-				["html", { open: "on-failure" }],
-				["list", { printSteps: false }],
-			],
-	use: {
-		actionTimeout: 5_000,
-		navigationTimeout: 10_000,
-		headless: true,
-		viewport: { width: 1280, height: 720 },
-		ignoreHTTPSErrors: false,
-		video: "retry-with-video",
-		screenshot: {
-			mode: "only-on-failure",
-			fullPage: true,
-			omitBackground: false,
-		},
-		trace: "on-all-retries",
-		testIdAttribute: "data-testid",
-	},
-};

package/skills/README.md

@@ -1,56 +0,0 @@
-# POMWright Migration Skills
-
-AI assistant skills for migrating POMWright page objects between versions.
-
-## Available Skills
-
-### pomwright-v1-5-bridge-migration
-Migrate v1 `BasePage` page objects to the v1.5 bridge (`BasePageV1toV2`) as an intermediate step toward v2.
-
-**Triggered by:**
-- "Migrate/convert/upgrade this page object from v1 to the bridge"
-- "Use BasePageV1toV2 for this page object"
-- Mentioning `BasePageV1toV2` or "bridge" in migration context
-
-**Covers:**
-- Changing class inheritance
-- Translating `addSchema`/`initLocatorSchemas` to `defineLocators` with v2 DSL
-- Updating call-site syntax (`getLocator`, `getNestedLocator`, `getLocatorSchema`)
-- Updating filter/index/update/mutation patterns
-
-### pomwright-v2-migration
-Migrate page objects to v2 `PageObject` from either v1 `BasePage` or the v1.5 bridge.
-
-**Triggered by:**
-- "Migrate/convert/upgrade this page object to v2"
-- "Use v2 PageObject for this page object"
-- Mentioning `PageObject` or "v2" in migration context
-
-**Covers:**
-- Class inheritance and constructor signature changes
-- Locator registration with v2 DSL
-- Adding `pageActionsToPerformAfterNavigation`
-- Call-site syntax updates
-- Migrating fixtures, navigation, sessionStorage, and logging
-- Adopting the `@step` decorator
-
-## Installation
-
-### For Claude Code
-
-Copy the skill directories to your local Claude Code skills folder:
-
-```bash
-cp -r skills/pomwright-v1-5-bridge-migration ~/.claude/skills/
-cp -r skills/pomwright-v2-migration ~/.claude/skills/
-```
-
-### For Other AI Assistants
-
-These skills are structured as markdown-based instructions with reference documentation. Adapt the content from each `SKILL.md` file according to your AI assistant's skill/prompt format.
-
-## Structure
-
-Each skill includes:
-- `SKILL.md` - Main skill instructions
-- `references/` - Supporting documentation and examples

package/skills/pomwright-v1-5-bridge-migration/SKILL.md

@@ -1,40 +0,0 @@
----
-name: pomwright-v1-5-bridge-migration
-description: >
-  Migrate POMWright v1 BasePage page objects to the v1.5 bridge (BasePageV1toV2) as an intermediate
-  step toward v2 PageObject. Use when asked to migrate, convert, or upgrade POMWright page objects
-  from v1 to the bridge, or when working with BasePageV1toV2. Covers: changing class inheritance,
-  translating addSchema/initLocatorSchemas to defineLocators with v2 DSL, updating call-site syntax
-  (getLocator, getNestedLocator, getLocatorSchema), and updating filter/index/update/mutation patterns.
----
-
-# POMWright v1.5 Bridge Migration (BasePage -> BasePageV1toV2)
-
-Migrate v1 `BasePage` page objects to `BasePageV1toV2` (the bridge), converting locator definitions
-and call-site syntax to v2. The bridge is deprecated and will be removed in 2.0.0; it exists only
-as a staged migration step.
-
-## Workflow
-
-1. **Inventory** the target POC file: identify `BasePage` extends, `initLocatorSchemas`, all `addSchema` calls, and call-sites using v1 accessors.
-2. **Switch inheritance** from `BasePage` to `BasePageV1toV2`. Constructor signature stays the same (`page, testInfo, baseUrl, urlPath, pocName, pwrl`).
-3. **Add `defineLocators()`** method stub.
-4. **Translate each `addSchema` call** from `initLocatorSchemas` into `this.add(path).method(...)` inside `defineLocators()`. See [references/schema-translation.md](references/schema-translation.md) for the full mapping table and examples.
-5. **Remove translated `addSchema` entries** from `initLocatorSchemas`. Once all are moved, keep `initLocatorSchemas()` as an empty method while still extending `BasePageV1toV2`.
-6. **Update call-site syntax** in tests/helpers/fixtures that consume the POC. See [references/call-site-migration.md](references/call-site-migration.md).
-7. **Verify** by running tests.
-
-## Key rules
-
-- Paths already registered in `defineLocators` are skipped when the bridge translates `initLocatorSchemas` - no duplicates.
-- v1 schemas using `Locator` instances or missing selector fields cannot be auto-translated; rewrite those in `defineLocators` immediately.
-- `BasePageV1toV2` narrows `this.locators` to `addSchema` only; no other v1 mutations are exposed.
-- v2 accessors (`add`, `getLocator`, `getNestedLocator`, `getLocatorSchema`) are exposed on the bridge and should be used from this point forward.
-- v2 `getLocator`/`getNestedLocator` are **synchronous** (no `await`). v1 versions were async.
-- v2 `getNestedLocator` no longer accepts index maps. Use `getLocatorSchema(path).nth(subPath, index).getNestedLocator()` instead.
-- `filter` replaces v1 `addFilter`. `nth` replaces v1 index maps. Both can be chained in any order.
-
-## References
-
-- **Schema translation mapping**: [references/schema-translation.md](references/schema-translation.md) - GetByMethod -> v2 DSL mapping table, filter/options translation, reusable locators, frameLocator changes
-- **Call-site migration**: [references/call-site-migration.md](references/call-site-migration.md) - getLocator, getNestedLocator, getLocatorSchema, update, addFilter, index maps, SessionStorage changes

package/skills/pomwright-v1-5-bridge-migration/references/call-site-migration.md

@@ -1,178 +0,0 @@
-# Call-Site Migration: v1 -> v2 accessor syntax
-
-## getLocator / getNestedLocator (async -> sync)
-
-v1 returns `Promise<Locator>`. v2 returns `Locator` synchronously. Remove `await`.
-
-```ts
-// v1
-const btn = await poc.getLocator("navbar.button@login");
-await btn.click();
-
-const nested = await poc.getNestedLocator("navbar.button@logout");
-await nested.click();
-
-// v2
-await poc.getLocator("navbar.button@login").click();
-await poc.getNestedLocator("navbar.button@logout").click();
-```
-
-## getNestedLocator with index maps -> getLocatorSchema + nth
-
-v1 accepted an optional index map object as second argument. v2 does not; use `getLocatorSchema` with `.nth()` instead.
-
-```ts
-// v1
-const submit = await poc.getNestedLocator("main.form.button@submit", {
-  "main.form": 0,
-});
-
-// v2
-const submit = poc
-  .getLocatorSchema("main.form.button@submit")
-  .nth("main.form", 0)
-  .getNestedLocator();
-```
-
-Multiple indices:
-
-```ts
-// v1
-const item = await poc.getNestedLocator("main.list.item.detail", {
-  "main.list": 0,
-  "main.list.item": 2,
-});
-
-// v2
-const item = poc
-  .getLocatorSchema("main.list.item.detail")
-  .nth("main.list", 0)
-  .nth("main.list.item", 2)
-  .getNestedLocator();
-```
-
-## addFilter -> filter
-
-v1 `addFilter` on `getLocatorSchema()` becomes v2 `filter`. Method name and argument shape changed.
-
-```ts
-// v1
-const filtered = await poc
-  .getLocatorSchema("main.list.item")
-  .addFilter("main.list", { hasText: "list" })
-  .addFilter("main.list.item", { hasText: "Row" })
-  .getNestedLocator({ "main.list": 0, "main.list.item": -1 });
-
-// v2
-const filtered = poc
-  .getLocatorSchema("main.list.item")
-  .filter("main.list", { hasText: "list" })
-  .nth("main.list", 0)
-  .filter({ hasText: "Row" })   // omitted subPath defaults to terminal path
-  .nth(-1)                       // omitted subPath defaults to terminal path
-  .getNestedLocator();
-```
-
-Key difference: v2 `filter` and `nth` can be interleaved in any order. v1 required all filters first, then one index map at the end.
-
-## update (schema mutation)
-
-v1 `update` accepted a partial schema object. v2 `update` returns a sub-builder where you chain the locator method with override options.
-
-```ts
-// v1
-const patched = await poc
-  .getLocatorSchema("main.button@login")
-  .update("main.button@login", { roleOptions: { name: "Sign in" } })
-  .getNestedLocator();
-
-// v2
-const patched = poc
-  .getLocatorSchema("main.button@login")
-  .update()                       // defaults to terminal path
-  .getByRole({ name: "Sign in" }) // PATCH-style: only override options
-  .getNestedLocator();
-```
-
-v2 also adds `replace` (full replacement) and `remove` (drop a subpath from chain):
-
-```ts
-// replace the entire locator strategy for a subpath
-const replaced = poc
-  .getLocatorSchema("main.button@login")
-  .replace()
-  .getByText("Sign in")
-  .getNestedLocator();
-
-// remove a segment from the chain
-const removed = poc
-  .getLocatorSchema("main.button@login")
-  .remove("main")
-  .getNestedLocator();
-```
-
-## getLocatorSchema().getLocator() / .getNestedLocator()
-
-v1 terminal resolution was async. v2 is sync.
-
-```ts
-// v1
-const loc = await poc.getLocatorSchema("main.button@login").getLocator();
-const nested = await poc.getLocatorSchema("main.button@login").getNestedLocator();
-
-// v2
-const loc = poc.getLocatorSchema("main.button@login").getLocator();
-const nested = poc.getLocatorSchema("main.button@login").getNestedLocator();
-```
-
-## describe (v2 only, no v1 equivalent)
-
-```ts
-const btn = poc
-  .getLocatorSchema("main.region@security.button@edit")
-  .filter({ hasText: "Change password" })
-  .describe("Change password")
-  .getNestedLocator();
-```
-
-## SessionStorage signature changes
-
-```ts
-// v1
-await poc.sessionStorage.set({ token: "abc" }, true);          // boolean reload
-await poc.sessionStorage.get(["token"]);
-await poc.sessionStorage.clear();
-
-// v2
-await poc.sessionStorage.set({ token: "abc" }, { reload: true });
-await poc.sessionStorage.get(["token"], { waitForContext: true });
-await poc.sessionStorage.clear();                              // clears all
-await poc.sessionStorage.clear(["token"]);                     // clears specific keys
-```
-
-## Import changes
-
-```ts
-// v1
-import { BasePage, GetByMethod } from "pomwright";
-
-// v1.5 bridge
-import { BasePageV1toV2, GetByMethod } from "pomwright";
-
-// When all schemas moved to defineLocators, remove GetByMethod import.
-```
-
-## filter has/hasNot value changes
-
-v1 `filter.has`/`filter.hasNot` accepted `Locator` instances. v2 accepts **registry path strings** or `Locator` instances from `getLocator`/`getNestedLocator`.
-
-```ts
-// v1 (Locator instance in filter)
-.addFilter("main.card", { has: someLocator })
-
-// v2 (path string reference)
-.filter("main.card", { has: "main.card.badge" })
-
-// v2 (Locator instance from registry)
-.filter("main.card", { has: poc.getNestedLocator("main.card.badge") })
-```