pomwright 1.5.1 → 2.0.0

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") })
-```

package/skills/pomwright-v1-5-bridge-migration/references/schema-translation.md

@@ -1,183 +0,0 @@
-# Schema Translation: v1 addSchema -> v2 add() DSL
-
-## GetByMethod mapping
-
-| v1 `locatorMethod` | v1 schema field | v1 options field | v2 method | v2 arguments |
-|---|---|---|---|---|
-| `GetByMethod.role` | `role` | `roleOptions` | `getByRole(role, options?)` | role value, roleOptions as second arg |
-| `GetByMethod.text` | `text` | `textOptions` | `getByText(text, options?)` | text value, textOptions as second arg |
-| `GetByMethod.label` | `label` | `labelOptions` | `getByLabel(text, options?)` | label value, labelOptions as second arg |
-| `GetByMethod.placeholder` | `placeholder` | `placeholderOptions` | `getByPlaceholder(text, options?)` | placeholder value, placeholderOptions |
-| `GetByMethod.altText` | `altText` | `altTextOptions` | `getByAltText(text, options?)` | altText value, altTextOptions |
-| `GetByMethod.title` | `title` | `titleOptions` | `getByTitle(text, options?)` | title value, titleOptions |
-| `GetByMethod.locator` | `locator` (string) | `locatorOptions` | `locator(selector, options?)` | locator string, locatorOptions |
-| `GetByMethod.frameLocator` | `frameLocator` | - | `frameLocator(selector)` | frameLocator string |
-| `GetByMethod.testId` | `testId` | - | `getByTestId(testId)` | testId value |
-| `GetByMethod.id` | `id` | - | `getById(id)` | id string or RegExp |
-| `GetByMethod.dataCy` | `dataCy` | - | `locator('[data-cy="value"]')` | CSS attribute selector string |
-
-## Translation examples
-
-### Role
-
-```ts
-// v1
-this.locators.addSchema("main.button@login", {
-  role: "button",
-  roleOptions: { name: "Login" },
-  locatorMethod: GetByMethod.role,
-});
-
-// v2
-this.add("main.button@login").getByRole("button", { name: "Login" });
-```
-
-### Locator (CSS/XPath)
-
-```ts
-// v1
-this.locators.addSchema("main", {
-  locator: "main",
-  locatorMethod: GetByMethod.locator,
-});
-
-// v2
-this.add("main").locator("main");
-```
-
-### Locator with options
-
-```ts
-// v1
-this.locators.addSchema("body.section@playground", {
-  locator: "section",
-  locatorOptions: { hasText: /Playground/i },
-  locatorMethod: GetByMethod.locator,
-});
-
-// v2
-this.add("body.section@playground").locator("section", { hasText: /Playground/i });
-```
-
-### Label
-
-```ts
-// v1
-this.locators.addSchema("main.form.input@username", {
-  label: "Username",
-  locatorMethod: GetByMethod.label,
-});
-
-// v2
-this.add("main.form.input@username").getByLabel("Username");
-```
-
-### FrameLocator
-
-```ts
-// v1
-this.locators.addSchema("main.frame@login", {
-  frameLocator: "#auth",
-  locatorMethod: GetByMethod.frameLocator,
-});
-
-// v2
-this.add("main.frame@login").frameLocator("#auth");
-```
-
-Note: terminal frameLocator paths in v2 resolve to `frameLocator.owner()` (the iframe element), not the frame itself. Non-terminal frames scope into the frame for subsequent segments.
-
-### dataCy (removed in v2)
-
-```ts
-// v1
-this.locators.addSchema("main.widget", {
-  dataCy: "my-widget",
-  locatorMethod: GetByMethod.dataCy,
-});
-
-// v2 (translate to CSS attribute selector)
-this.add("main.widget").locator('[data-cy="my-widget"]');
-```
-
-### getById
-
-```ts
-// v1
-this.locators.addSchema("main.modal@close", {
-  id: "close-modal",
-  locatorMethod: GetByMethod.id,
-});
-
-// v2
-this.add("main.modal@close").getById("close-modal");
-```
-
-Note: v1 regex IDs use prefix match `*[id^="pattern"]`; v2 regex IDs use substring match `[id*="pattern"]` with CSS escaping. Results may differ for edge cases.
-
-## Filter translation
-
-v1 `filter` property on schema -> v2 chained `.filter()` call:
-
-```ts
-// v1
-this.locators.addSchema("body.section@playground", {
-  locator: "section",
-  locatorMethod: GetByMethod.locator,
-  filter: { hasText: /Playground/i },
-});
-
-// v2
-this.add("body.section@playground").locator("section").filter({ hasText: /Playground/i });
-
-// OR, if the filter only has hasText/hasNotText, use locator options instead:
-this.add("body.section@playground").locator("section", { hasText: /Playground/i });
-```
-
-v2 `filter` accepts `has`/`hasNot` as **registry path strings or Playwright Locator instances**. Path strings are often preferred for registry-native references:
-
-```ts
-// v2 filter with has/hasNot as path references
-this.add("main.card").locator(".card").filter({
-  has: "main.card.badge",      // path string, not Locator
-  hasText: "Active",
-});
-```
-
-## Reusable locator patterns
-
-### v1: LocatorSchemaWithoutPath + spread
-
-```ts
-const buttonSchema: LocatorSchemaWithoutPath = {
-  role: "button",
-  locatorMethod: GetByMethod.role,
-};
-
-this.locators.addSchema("main.button@submit", { ...buttonSchema, roleOptions: { name: "Submit" } });
-this.locators.addSchema("main.button@cancel", { ...buttonSchema, roleOptions: { name: "Cancel" } });
-```
-
-### v2: createReusable or path reuse
-
-```ts
-// Option A: createReusable
-const button = this.locatorRegistry.createReusable.getByRole("button");
-this.add("main.button@submit", { reuse: button }).getByRole({ name: "Submit" });
-this.add("main.button@cancel", { reuse: button }).getByRole({ name: "Cancel" });
-
-// Option B: reuse by path (exact clone, no override chaining; returns void so no follow-up chain)
-this.add("main.button@submit").getByRole("button", { name: "Submit" });
-this.add("main.button@cancel", { reuse: "main.button@submit" });
-```
-
-> Bridge note: when `BasePageV1toV2` translates remaining v1 schemas, any path already registered in `defineLocators()` is skipped (not overwritten). Keep `defineLocators()` as the source of truth and remove stale duplicates from `initLocatorSchemas()`.
-
-## Registration with filter + nth at definition time
-
-```ts
-// v2 supports chaining filter and nth on add():
-this.add("one.two").locator("div.two").filter({ hasText: "two" }).nth(0);
-```
-
-This registers the locator with a filter step and an nth step baked in.

package/skills/pomwright-v2-migration/SKILL.md

@@ -1,63 +0,0 @@
----
-name: pomwright-v2-migration
-description: >
-  Migrate POMWright page objects to v2 PageObject from either v1 BasePage or the v1.5 bridge
-  (BasePageV1toV2). Use when asked to migrate, convert, or upgrade POMWright page objects to v2,
-  or when working with PageObject. Covers: changing class inheritance and constructor signature,
-  translating addSchema/initLocatorSchemas to defineLocators with v2 DSL, adding
-  pageActionsToPerformAfterNavigation, updating call-site syntax (getLocator, getNestedLocator,
-  getLocatorSchema), updating filter/index/update/mutation patterns, migrating fixtures, navigation,
-  sessionStorage, logging, and adopting the @step decorator.
----
-
-# POMWright v2 Migration (BasePage / BasePageV1toV2 -> PageObject)
-
-Migrate page objects to `PageObject` from either v1 `BasePage` or the v1.5 bridge `BasePageV1toV2`.
-This is the final migration target; `PageObject` is the stable v2 API.
-
-## Determine source version
-
-Before starting, identify which base class the POC currently extends:
-
-| Current base class | Source version | Key differences from v2 |
-|---|---|---|
-| `BasePage` | v1 | Constructor requires `testInfo`, `pocName`, `PlaywrightReportLogger`; uses `initLocatorSchemas` with `addSchema`; async locator accessors; `addFilter` + index maps |
-| `BasePageV1toV2` | v1.5 bridge | Same constructor as v1; may have both `initLocatorSchemas` and `defineLocators`; v2 accessors already available but async removed only partially |
-
-If the source is v1 `BasePage` and has not yet been migrated through the bridge, this skill handles
-the direct migration. All schema translation and call-site changes still apply.
-
-## Workflow
-
-1. **Inventory** the target POC file and its consumers (tests, fixtures, helpers that import it).
-2. **Migrate the class declaration and constructor.** See [references/class-migration.md](references/class-migration.md).
-3. **Migrate locator definitions** into `defineLocators()` using the v2 `add()` DSL. See [references/locator-registration.md](references/locator-registration.md).
-4. **Remove `initLocatorSchemas()`** once all schemas are moved to `defineLocators()`.
-5. **Add `pageActionsToPerformAfterNavigation()`** (required abstract method). See [references/class-migration.md](references/class-migration.md).
-6. **Update call-site syntax** in tests, fixtures, and helpers. See [references/call-site-migration.md](references/call-site-migration.md).
-7. **Migrate fixtures and helpers** (navigation, sessionStorage, logging, @step). See [references/fixture-and-helpers.md](references/fixture-and-helpers.md).
-8. **Remove v1 imports** (`GetByMethod`, `BasePage`, `BasePageV1toV2`, `BasePageOptions`, `ExtractUrlPathType`, `ExtractBaseUrlType`, `ExtractFullUrlType`, `GetLocatorBase`, `LocatorSchemaWithoutPath`).
-9. **Verify** by running tests.
-
-## Key rules
-
-- v2 `PageObject` constructor takes `(page, baseUrl, urlPath, options?)` - no `testInfo`, no `pocName`, no `PlaywrightReportLogger`.
-- `pocName` is replaced by `options.label` (defaults to class name, so often omittable).
-- `testInfo` and `PlaywrightReportLogger` are no longer injected into PageObject. Use the `log` fixture from `pomwright` instead if logging is needed.
-- `defineLocators()` is required; `initLocatorSchemas()` does not exist in v2.
-- `pageActionsToPerformAfterNavigation()` is a required abstract method; return `null` or an array of async callbacks.
-- v2 `getLocator`/`getNestedLocator`/`getLocatorSchema` are **synchronous** (no `await`).
-- v2 `getNestedLocator` does not accept 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.
-- v2 `filter.has`/`filter.hasNot` accept **registry path strings** in addition to Locator instances.
-- `navigation` helper is exposed on PageObject: `this.navigation.gotoThisPage()`, `this.navigation.expectThisPage()`, etc.
-- `sessionStorage` API changed: boolean parameters replaced by options objects.
-- `@step` decorator is available for wrapping methods in Playwright test steps.
-- v1 URL type helpers renamed: `ExtractBaseUrlType` -> `BaseUrlTypeFromOptions`, `ExtractUrlPathType` -> `UrlPathTypeFromOptions`, `ExtractFullUrlType` -> `FullUrlTypeFromOptions`. The options shape flattened from `{ urlOptions: { ... } }` to `{ baseUrlType, urlPathType }`.
-
-## References
-
-- **Class migration**: [references/class-migration.md](references/class-migration.md) - Inheritance, constructor, generics, abstract methods, base class hierarchy
-- **Locator registration**: [references/locator-registration.md](references/locator-registration.md) - defineLocators, add() DSL mapping, reusable locators, filter/nth at registration, frameLocator changes
-- **Call-site migration**: [references/call-site-migration.md](references/call-site-migration.md) - getLocator, getNestedLocator, getLocatorSchema, filter, nth, update, replace, remove, describe
-- **Fixtures and helpers**: [references/fixture-and-helpers.md](references/fixture-and-helpers.md) - Fixture setup, navigation helper, sessionStorage, @step decorator, logging

package/skills/pomwright-v2-migration/references/call-site-migration.md

@@ -1,265 +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();
-```
-
-v2 also supports named index positions:
-
-```ts
-const first = poc
-  .getLocatorSchema("main.list.item")
-  .nth("first")              // omitted subPath defaults to terminal path
-  .getNestedLocator();
-
-const last = poc
-  .getLocatorSchema("main.list.item")
-  .nth("last")
-  .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 differences:
-- `addFilter` renamed to `filter`
-- v2 `filter` and `nth` can be interleaved in any order
-- v1 required all filters first, then one index map at the end
-- Omitting `subPath` on `filter`/`nth` defaults to the terminal path (the path supplied to `getLocatorSchema`)
-
-## clearSteps
-
-v2 adds `clearSteps()` to remove all runtime steps (filter + nth) from a query builder:
-
-```ts
-const schema = poc.getLocatorSchema("main.list.item")
-  .filter({ hasText: "Active" })
-  .nth(0);
-
-// Clear all steps and start fresh
-const reset = schema.clearSteps().filter({ hasText: "Inactive" }).getNestedLocator();
-
-// Clear steps for a specific subPath only
-const partial = schema.clearSteps("main.list").getNestedLocator();
-```
-
-## 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 (PATCH-style merge).
-
-```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();
-```
-
-With explicit subPath:
-
-```ts
-// v2
-const patched = poc
-  .getLocatorSchema("main.form.button@login")
-  .update("main.form")
-  .locator(".login-form-v2")      // override selector for the form segment
-  .getNestedLocator();
-```
-
-## replace (full replacement)
-
-v2 adds `replace` for POST-style full replacement of a locator strategy:
-
-```ts
-// v2 only
-const replaced = poc
-  .getLocatorSchema("main.button@login")
-  .replace()
-  .getByText("Sign in")          // entirely replaces the role strategy with text
-  .getNestedLocator();
-
-// With subPath
-const replaced = poc
-  .getLocatorSchema("main.form.button@login")
-  .replace("main.form")
-  .getByRole("region", { name: "Login" })
-  .getNestedLocator();
-```
-
-## remove (drop segment from chain)
-
-v2 adds `remove` to soft-delete a segment from the locator chain:
-
-```ts
-// v2 only
-const removed = poc
-  .getLocatorSchema("main.form.button@login")
-  .remove("main")                // skips "main" when building the chain
-  .getNestedLocator();
-```
-
-Without subPath, `remove()` targets the terminal segment. Resolving immediately will throw unless the terminal definition is replaced/updated before resolve:
-
-```ts
-// Throws: terminal path was removed
-expect(() =>
-  poc.getLocatorSchema("main.form.button@login").remove().getNestedLocator()
-).toThrow(/No locator schema registered/);
-
-// Repair terminal path before resolve
-const repaired = poc
-  .getLocatorSchema("main.form.button@login")
-  .remove()
-  .replace("main.form.button@login")
-  .getByRole("button", { name: "Sign in" })
-  .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)
-
-Adds a descriptive label to the locator at runtime:
-
-```ts
-const btn = poc
-  .getLocatorSchema("main.region@security.button@edit")
-  .filter({ hasText: "Change password" })
-  .describe("Change password")
-  .getNestedLocator();
-```
-
-## 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 - preferred)
-.filter("main.card", { has: "main.card.badge" })
-
-// v2 (Locator instance from registry - also valid)
-.filter("main.card", { has: poc.getNestedLocator("main.card.badge") })
-```
-
-## 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 key
-await poc.sessionStorage.clear(["token", "theme"]);            // clears specific keys
-```
-
-Key changes:
-- Boolean `reload` parameter -> `{ reload: true }` options object
-- New `{ waitForContext: true }` option on `get` and `clear` for handling navigation boundaries
-- `clear` now supports clearing specific keys (string or string array)
-
-## Import changes
-
-```ts
-// v1
-import { BasePage, GetByMethod } from "pomwright";
-
-// v1.5 bridge
-import { BasePageV1toV2, GetByMethod } from "pomwright";
-
-// v2
-import { PageObject } from "pomwright";
-// GetByMethod is no longer needed - remove the import
-```