@healflow/playwright 0.1.1 → 0.1.3

package/README.md

@@ -60,12 +60,12 @@ export const test = base.extend(healflowFixture());
 
 After each run, `.healflow/` contains:
 
-| File | Purpose |
-| ---- | ------- |
-| `report.html` | Human-readable heal summary |
-| `heals.json` | Runtime heals applied during the run |
-| `fixes.json` | AST fix proposals (dry-run) |
-| `run.json` | Full run metadata |
+| File          | Purpose                              |
+| ------------- | ------------------------------------ |
+| `report.html` | Human-readable heal summary          |
+| `heals.json`  | Runtime heals applied during the run |
+| `fixes.json`  | AST fix proposals (dry-run)          |
+| `run.json`    | Full run metadata                    |
 
 ## Configuration
 
@@ -80,6 +80,14 @@ healing:
   timing: true
   overlay: true
   iframe: true
+  shadowDom: true
+  auth: true
+  network: true
+  navigation: true
+  mobile: true
+  i18n: true
+  upload: true
+  multiTab: true
 
 # Optional cloud sync
 backend:
@@ -93,26 +101,35 @@ Environment variables: `HEALFLOW_API_URL`, `HEALFLOW_ORG_ID`, `HEALFLOW_REPO_ID`
 
 ## Exports
 
-| Subpath | Purpose |
-| ------- | ------- |
-| `@healflow/playwright` | `healflowFixture`, `wrapPage`, plugin options |
-| `@healflow/playwright/auto` | `withHealFlow()` config wrapper |
-| `@healflow/playwright/reporter` | Custom Playwright reporter |
-| `@healflow/playwright/setup-global` | Global setup hook |
+| Subpath                             | Purpose                                       |
+| ----------------------------------- | --------------------------------------------- |
+| `@healflow/playwright`              | `healflowFixture`, `wrapPage`, plugin options |
+| `@healflow/playwright/auto`         | `withHealFlow()` config wrapper               |
+| `@healflow/playwright/reporter`     | Custom Playwright reporter                    |
+| `@healflow/playwright/setup-global` | Global setup hook                             |
 
 ## Runtime healing categories
 
-- **Selector** — stale locators, `getByTestId` fallbacks
-- **Timing** — wait for element stability before retry
-- **Overlay** — dismiss cookie banners and modals
-- **Iframe / Shadow DOM** — context switching
-- **Auth / Session** — storage-state refresh (when configured)
+HealFlow walks the **T0→T5 runtime ladder** on every healable locator/page action:
 
-Product bugs and assertion failures are never auto-fixed.
+| Technique      | Purpose                                                          |
+| -------------- | ---------------------------------------------------------------- |
+| T0 Retry       | Condition-based waits (visibility, network idle, spinner hidden) |
+| T1 Scope       | Parent-chain scoping                                             |
+| T2 Normalize   | Role / label / text strategy migration                           |
+| T3 Fingerprint | DOM attribute & aria similarity                                  |
+| T4 Trace       | Frame/shadow/navigation hints from Playwright error context      |
+| T5 History     | Reuse prior heals from `.healflow/heals.json`                    |
+
+**Categories enabled by default:** selector, timing, overlay, iframe, shadow DOM, auth/session, network, navigation, mobile, i18n, upload, multi-tab.
+
+Each runtime heal records `matrixEntryId`, `succeededTechnique`, and `healMode` in `.healflow/heals.json`.
+
+Product bugs and assertion **values** are never auto-fixed.
 
 ## Cloud sync (optional)
 
-When `backend` is configured, the reporter syncs heals to the HealFlow API after each run. See [`@healflow/cli`](../cli) for `healflow ingest`.
+When `backend` is configured, the reporter syncs heals to the HealFlow API after each run. See [@healflow/cli](https://www.npmjs.com/package/@healflow/cli) for `healflow ingest`.
 
 ## Development
 
@@ -123,8 +140,8 @@ pnpm --filter @healflow/playwright typecheck
 
 ## Related packages
 
-- [`@healflow/cli`](../cli) — `healflow init`, `doctor`, `report`
-- [`@healflow/classification`](../classification) — runtime error classification
+- [@healflow/cli](https://www.npmjs.com/package/@healflow/cli) — `healflow init`, `doctor`, `report`
+- [@healflow/classification](https://www.npmjs.com/package/@healflow/classification) — runtime error classification
 
 ## License
 

package/dist/index.d.ts

@@ -1,25 +1,5 @@
-import type { Page, TestInfo } from '@playwright/test';
-import { type HealFlowConfig } from '@healflow/shared';
-export interface HealFlowPluginOptions {
-    autoHeal?: boolean;
-    maxAttempts?: number;
-    apiUrl?: string;
-    organizationId?: string;
-    repositoryId?: string;
-    config?: HealFlowConfig;
-}
-export interface HealContext {
-    attempts: number;
-    healedActions: string[];
-    testFile?: string;
-    testTitle?: string;
-}
-export declare function wrapPage(page: Page, options?: HealFlowPluginOptions, healContext?: HealContext): Page;
-export declare function healflowFixture(options?: HealFlowPluginOptions): {
-    page: ({ page }: {
-        page: Page;
-    }, use: (p: Page) => Promise<void>, testInfo: TestInfo) => Promise<void>;
-};
+export type { HealFlowPluginOptions, HealContext } from './plugin/index.js';
+export { wrapPage, healflowFixture } from './plugin/index.js';
 export { registerHealFlow } from './register.js';
 export { withHealFlow, configToPluginOptions } from './auto.js';
 export { healflowReporter } from './reporter.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAW,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEhE,OAAO,EAQL,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAM1B,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AA+FD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAqpBD,wBAAgB,QAAQ,CACtB,IAAI,EAAE,IAAI,EACV,OAAO,GAAE,qBAA0B,EACnC,WAAW,CAAC,EAAE,WAAW,GACxB,IAAI,CAgEN;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE,qBAA0B;qBAInD;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,OACnB,CAAC,CAAC,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,YACrB,QAAQ,KACjB,OAAO,CAAC,IAAI,CAAC;EAUnB;AAED,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC"}