@sun-asterisk/sungen 3.2.29 → 3.2.31

package/dist/generators/test-generator/adapters/playwright/playwright-adapter.d.ts

@@ -1,4 +1,4 @@
-import { TestGeneratorAdapter, TestFileData, ScenarioData, RenderImportsOptions } from '../adapter-interface';
+import { TestGeneratorAdapter, TestFileData, ScenarioData, RenderImportsOptions, HookRenderData } from '../adapter-interface';
 /**
  * PlaywrightAdapter
  * Generates Playwright TypeScript test code using Handlebars templates
@@ -18,24 +18,9 @@ export declare class PlaywrightAdapter implements TestGeneratorAdapter {
             code: string;
         }>;
     }): string;
-    renderBeforeAll(data: {
-        steps: Array<{
-            comment?: string;
-            code: string;
-        }>;
-    }): string;
-    renderAfterEach(data: {
-        steps: Array<{
-            comment?: string;
-            code: string;
-        }>;
-    }): string;
-    renderAfterAll(data: {
-        steps: Array<{
-            comment?: string;
-            code: string;
-        }>;
-    }): string;
+    renderBeforeAll(data: HookRenderData): string;
+    renderAfterEach(data: HookRenderData): string;
+    renderAfterAll(data: HookRenderData): string;
     renderStep(templateName: string, data: any): string;
 }
 //# sourceMappingURL=playwright-adapter.d.ts.map

package/dist/generators/test-generator/adapters/playwright/playwright-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playwright-adapter.d.ts","sourceRoot":"","sources":["../../../../../src/generators/test-generator/adapters/playwright/playwright-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAG9G;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,oBAAoB;IAC5D,QAAQ,CAAC,aAAa,gBAAgB;IACtC,QAAQ,CAAC,aAAa,cAAc;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,cAAc,CAAiB;;IAQvC,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM;IAI1C,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM;IAI1C,aAAa,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM;IAIrD,gBAAgB,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;YAAE,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,GAAG,MAAM;IAIpF,eAAe,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;YAAE,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,GAAG,MAAM;IAInF,eAAe,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;YAAE,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,GAAG,MAAM;IAInF,cAAc,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;YAAE,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,GAAG,MAAM;IAIlF,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,MAAM;CAGpD"}
+{"version":3,"file":"playwright-adapter.d.ts","sourceRoot":"","sources":["../../../../../src/generators/test-generator/adapters/playwright/playwright-adapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG9H;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,oBAAoB;IAC5D,QAAQ,CAAC,aAAa,gBAAgB;IACtC,QAAQ,CAAC,aAAa,cAAc;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,cAAc,CAAiB;;IAQvC,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM;IAI1C,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM;IAI1C,aAAa,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,MAAM;IAIrD,gBAAgB,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,KAAK,CAAC;YAAE,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,GAAG,MAAM;IAIpF,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM;IAI7C,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM;IAI7C,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM;IAI5C,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,MAAM;CAGpD"}

package/dist/generators/test-generator/adapters/playwright/playwright-adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"playwright-adapter.js","sourceRoot":"","sources":["../../../../../src/generators/test-generator/adapters/playwright/playwright-adapter.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAwB;AAExB,2DAAuD;AAEvD;;;GAGG;AACH,MAAa,iBAAiB;IAM5B;QALS,kBAAa,GAAG,YAAY,CAAC;QAC7B,kBAAa,GAAG,UAAU,CAAC;QAKlC,2CAA2C;QAC3C,IAAI,CAAC,YAAY,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACtD,IAAI,CAAC,cAAc,GAAG,IAAI,gCAAc,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC9D,CAAC;IAED,cAAc,CAAC,IAAkB;QAC/B,OAAO,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,cAAc,CAAC,IAAkB;QAC/B,OAAO,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,aAAa,CAAC,OAA8B;QAC1C,OAAO,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IACpD,CAAC;IAED,gBAAgB,CAAC,IAA0D;QACzE,OAAO,IAAI,CAAC,cAAc,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC;IAED,eAAe,CAAC,IAA0D;QACxE,OAAO,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;IAED,eAAe,CAAC,IAA0D;QACxE,OAAO,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;IAED,cAAc,CAAC,IAA0D;QACvE,OAAO,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,UAAU,CAAC,YAAoB,EAAE,IAAS;QACxC,OAAO,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IAC5D,CAAC;CACF;AA3CD,8CA2CC"}
+{"version":3,"file":"playwright-adapter.js","sourceRoot":"","sources":["../../../../../src/generators/test-generator/adapters/playwright/playwright-adapter.ts"],"names":[],"mappings":";;;;;;AAAA,gDAAwB;AAExB,2DAAuD;AAEvD;;;GAGG;AACH,MAAa,iBAAiB;IAM5B;QALS,kBAAa,GAAG,YAAY,CAAC;QAC7B,kBAAa,GAAG,UAAU,CAAC;QAKlC,2CAA2C;QAC3C,IAAI,CAAC,YAAY,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACtD,IAAI,CAAC,cAAc,GAAG,IAAI,gCAAc,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC9D,CAAC;IAED,cAAc,CAAC,IAAkB;QAC/B,OAAO,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,cAAc,CAAC,IAAkB;QAC/B,OAAO,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,aAAa,CAAC,OAA8B;QAC1C,OAAO,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IACpD,CAAC;IAED,gBAAgB,CAAC,IAA0D;QACzE,OAAO,IAAI,CAAC,cAAc,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC;IAED,eAAe,CAAC,IAAoB;QAClC,OAAO,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;IAED,eAAe,CAAC,IAAoB;QAClC,OAAO,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;IAED,cAAc,CAAC,IAAoB;QACjC,OAAO,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,UAAU,CAAC,YAAoB,EAAE,IAAS;QACxC,OAAO,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IAC5D,CAAC;CACF;AA3CD,8CA2CC"}

package/dist/generators/test-generator/adapters/playwright/templates/after-all.hbs

@@ -1,8 +1,26 @@
-  test.afterAll(async ({ request }) => {
+  test.afterAll(async () => {
+{{#if collect}}
+    // Hook checks are collected: every failed step is recorded and the hook fails ONCE with the full list
+    const __hookFailures: string[] = [];
+{{/if}}
 {{#each steps}}
 {{#if comment}}
     // {{comment}}
 {{/if}}
+{{#if wrap}}
+    try {
+{{code}}
+    } catch (e) {
+      __hookFailures.push({{label}} + ': ' + String((e as Error).message).split('\n')[0]);
+{{#if stopOnFailure}}
+      expect(__hookFailures, 'Hook preconditions not met').toEqual([]);
+{{/if}}
+    }
+{{else}}
 {{code}}
+{{/if}}
 {{/each}}
+{{#if collect}}
+    expect(__hookFailures, 'Hook preconditions not met').toEqual([]);
+{{/if}}
   });

package/dist/generators/test-generator/adapters/playwright/templates/after-each.hbs

@@ -1,8 +1,26 @@
   test.afterEach(async ({ page }) => {
+{{#if collect}}
+    // Hook checks are collected: every failed step is recorded and the hook fails ONCE with the full list
+    const __hookFailures: string[] = [];
+{{/if}}
 {{#each steps}}
 {{#if comment}}
     // {{comment}}
 {{/if}}
+{{#if wrap}}
+    try {
+{{code}}
+    } catch (e) {
+      __hookFailures.push({{label}} + ': ' + String((e as Error).message).split('\n')[0]);
+{{#if stopOnFailure}}
+      expect(__hookFailures, 'Hook preconditions not met').toEqual([]);
+{{/if}}
+    }
+{{else}}
 {{code}}
+{{/if}}
 {{/each}}
+{{#if collect}}
+    expect(__hookFailures, 'Hook preconditions not met').toEqual([]);
+{{/if}}
   });

package/dist/generators/test-generator/adapters/playwright/templates/before-all.hbs

@@ -1,8 +1,26 @@
-  test.beforeAll(async ({ request }) => {
+  test.beforeAll(async () => {
+{{#if collect}}
+    // Hook checks are collected: every failed step is recorded and the hook fails ONCE with the full list
+    const __hookFailures: string[] = [];
+{{/if}}
 {{#each steps}}
 {{#if comment}}
     // {{comment}}
 {{/if}}
+{{#if wrap}}
+    try {
+{{code}}
+    } catch (e) {
+      __hookFailures.push({{label}} + ': ' + String((e as Error).message).split('\n')[0]);
+{{#if stopOnFailure}}
+      expect(__hookFailures, 'Hook preconditions not met').toEqual([]);
+{{/if}}
+    }
+{{else}}
 {{code}}
+{{/if}}
 {{/each}}
+{{#if collect}}
+    expect(__hookFailures, 'Hook preconditions not met').toEqual([]);
+{{/if}}
   });

package/dist/generators/test-generator/adapters/playwright/templates/imports.hbs

@@ -18,6 +18,9 @@ import { {{urlAssertImports}} } from '{{basePath}}/url-assert';
 {{#if regexEscapeImport}}
 import { escapeRegExp } from '{{basePath}}/regex-escape';
 {{/if}}
+{{#if checkedStateImports}}
+import { {{checkedStateImports}} } from '{{basePath}}/checked-state';
+{{/if}}
 
 // This file is auto-generated from Gherkin feature files
 // DO NOT EDIT MANUALLY - changes will be overwritten

package/dist/generators/test-generator/adapters/playwright/templates/steps/actions/check-action.hbs

@@ -1 +1,6 @@
-await {{> locator}}.check();
+{{!-- Playwright's .check() accepts ONLY native checkbox/radio and role=checkbox|radio|switch —
+      a `<button aria-pressed>` toggle threw "Not a checkbox or radio button" (#675). The branch
+      cannot be decided here: a testid/CSS selector carries no role, so the element is inspected at
+      run time by setCheckedState (specs/checked-state.ts), which also keeps the step IDEMPOTENT —
+      the reason `check` exists rather than `click`. --}}
+await setCheckedState({{> locator}}, true, '{{escapeQuotes selectorRef}}'{{> checked-opts cls=checkedClass attr=checkedAttribute}});

package/dist/generators/test-generator/adapters/playwright/templates/steps/actions/click-at-position-action.hbs

@@ -0,0 +1,23 @@
+{{#if clickPosition}}
+{{!-- Positioned click: coordinates are relative to the element's PADDING box (clientWidth/Height),
+      the same box `click({ position })` measures from — boundingBox() would be the border box and
+      drift by the border width. Read once, checked, then clicked, so an offset past the real size
+      fails naming that size instead of landing on a neighbour. --}}
+{ const el = {{> locator}};
+const __label = {{{label}}};
+await el.waitFor({ state: 'visible' }); // the box is read once — not before the element has laid out
+{{!-- padding box = bounding rect minus borders: clientWidth/Height would read 0 on an inline element (a link). --}}
+const box = await el.evaluate((n) => {
+  const r = n.getBoundingClientRect(); const cs = getComputedStyle(n); const b = (p: string) => parseFloat(cs.getPropertyValue(p)) || 0;
+  return { w: r.width - b('border-left-width') - b('border-right-width'), h: r.height - b('border-top-width') - b('border-bottom-width') };
+});
+if (box.w <= 0 || box.h <= 0) throw new Error('[sungen] ' + __label + ': element has no layout box (hidden, detached or zero-sized)');
+const x = {{#if (eq clickPosition.xUnit '%')}}box.w * {{clickPosition.xRatio}}{{else}}{{clickPosition.x}}{{/if}};
+const y = {{#if (eq clickPosition.yUnit '%')}}box.h * {{clickPosition.yRatio}}{{else}}{{clickPosition.y}}{{/if}};
+if (x >= box.w || y >= box.h) throw new Error('[sungen] ' + __label + ': click position (' + Math.round(x) + ', ' + Math.round(y) + ') lies outside the element box ' + Math.round(box.w) + 'x' + Math.round(box.h));
+await el.click({ position: { x, y } });
+}
+{{else}}
+{{!-- Unreachable through the compiler (SG-E026 replaces the step) — kept so a stray render fails loud. --}}
+throw new Error('[sungen] click position could not be parsed');
+{{/if}}

package/dist/generators/test-generator/adapters/playwright/templates/steps/actions/expand-action.hbs

@@ -5,20 +5,20 @@ await el.click();
 {{else if expanded.class}}
 {{!-- State signalled by a class on a descendant (e.g. an accordion chevron icon). --}}
 {{#if (eq direction 'expand')}}
-if (!(await el.locator('.{{expanded.class}}').count())) { await el.click(); }
-await expect(el.locator('.{{expanded.class}}')).toBeVisible();
+if (!(await el.locator('.{{escapeQuotes expanded.class}}').count())) { await el.click(); }
+await expect(el.locator('.{{escapeQuotes expanded.class}}')).toBeVisible();
 {{else}}
-if (await el.locator('.{{expanded.class}}').count()) { await el.click(); }
-await expect(el.locator('.{{expanded.class}}')).toHaveCount(0);
+if (await el.locator('.{{escapeQuotes expanded.class}}').count()) { await el.click(); }
+await expect(el.locator('.{{escapeQuotes expanded.class}}')).toHaveCount(0);
 {{/if}}
 {{else if expanded.attribute}}
 {{!-- Explicit boolean attribute ('true'/'false'), custom or aria-expanded. --}}
 {{#if (eq direction 'expand')}}
-if (await el.getAttribute('{{expanded.attribute}}') !== 'true') { await el.click(); }
-await expect(el).toHaveAttribute('{{expanded.attribute}}', 'true');
+if (await el.getAttribute('{{escapeQuotes expanded.attribute}}') !== 'true') { await el.click(); }
+await expect(el).toHaveAttribute('{{escapeQuotes expanded.attribute}}', 'true');
 {{else}}
-if (await el.getAttribute('{{expanded.attribute}}') !== 'false') { await el.click(); }
-await expect(el).toHaveAttribute('{{expanded.attribute}}', 'false');
+if (await el.getAttribute('{{escapeQuotes expanded.attribute}}') !== 'false') { await el.click(); }
+await expect(el).toHaveAttribute('{{escapeQuotes expanded.attribute}}', 'false');
 {{/if}}
 {{else}}
 {{!-- Default (zero-config): drive by aria-expanded, but assert it ONLY when the element exposes it. --}}

package/dist/generators/test-generator/adapters/playwright/templates/steps/actions/fill-editor-action.hbs

@@ -1,3 +1,8 @@
-const editorLocator = {{> locator}};
+{{!-- Block-scoped, like the appium counterpart: `const editorLocator` at statement level made a
+      SECOND editor fill in the same scenario a duplicate declaration, and Playwright fails the
+      WHOLE file with one SyntaxError — every scenario in it never runs. Unreachable while
+      `contenteditable:` was dead and nothing set `inputMethod` (#712); a form with two rich-text
+      fields hits it immediately once the field works. SG-E022 is the gate that caught it. --}}
+{ const editorLocator = {{> locator}};
 await editorLocator.click();
-await editorLocator.pressSequentially('{{escapeQuotes fillValue}}');
+await editorLocator.pressSequentially('{{escapeQuotes fillValue}}'); }

package/dist/generators/test-generator/adapters/playwright/templates/steps/actions/table-action-in-row-nth.hbs

@@ -2,4 +2,6 @@
      role=row, so the ARIA chain below is 0 elements and this assertion would be vacuous, issue #688)
      wins; otherwise the historical ARIA chain, byte-identical. --}}
 { const tableRow = {{> locator}}{{#if rows}}.locator('{{escapeQuotes rows}}'){{else}}.getByRole('row'){{/if}}.nth({{{rowIndexExpr}}});
-await {{{actionLocator}}}.{{action}}(); }
+{{!-- `check`/`uncheck` must not emit a bare .check() here either (#675) — the row control is just
+     as likely to be an aria-pressed toggle as a standalone one. `click` stays a plain click. --}}
+{{#if (eq action 'click')}}await {{{actionLocator}}}.click();{{else}}await setCheckedState({{{actionLocator}}}, {{#if (eq action 'check')}}true{{else}}false{{/if}}, '{{escapeQuotes elementName}}'{{> checked-opts cls=actionCheckedClass attr=actionCheckedAttribute}});{{/if}} }

package/dist/generators/test-generator/adapters/playwright/templates/steps/actions/table-action-in-row.hbs

@@ -2,4 +2,6 @@
      role=row, so the ARIA chain below is 0 elements and this assertion would be vacuous, issue #688)
      wins; otherwise the historical ARIA chain, byte-identical. --}}
 { const tableRow = {{> locator}}{{#if rows}}.locator('{{escapeQuotes rows}}'){{else}}.getByRole('row'){{/if}}.filter({ hasText: '{{escapeQuotes filterValue}}' });
-await {{{actionLocator}}}.{{action}}(); }
+{{!-- `check`/`uncheck` must not emit a bare .check() here either (#675) — the row control is just
+     as likely to be an aria-pressed toggle as a standalone one. `click` stays a plain click. --}}
+{{#if (eq action 'click')}}await {{{actionLocator}}}.click();{{else}}await setCheckedState({{{actionLocator}}}, {{#if (eq action 'check')}}true{{else}}false{{/if}}, '{{escapeQuotes elementName}}'{{> checked-opts cls=actionCheckedClass attr=actionCheckedAttribute}});{{/if}} }

package/dist/generators/test-generator/adapters/playwright/templates/steps/actions/table-paginate-action.hbs

@@ -0,0 +1,5 @@
+{{!-- The paginator is located from `page`, NOT from inside the table locator: antd/MUI/Radix all
+      render the control as a SIBLING of the <table>, so scoping it to the table would resolve 0
+      elements (issue #712). No implicit wait — the round-trip belongs to
+      `User wait for [X] table to refresh`. A disabled control fails loud: click waits for enabled. --}}
+await page.locator('{{escapeQuotes paginationSelector}}').click();

package/dist/generators/test-generator/adapters/playwright/templates/steps/actions/uncheck-action.hbs

@@ -1 +1,3 @@
-await {{> locator}}.uncheck();
+{{!-- Inverse of check-action.hbs — see there and specs/checked-state.ts for why the control is
+      inspected at run time rather than driven by a bare .uncheck() (#675). --}}
+await setCheckedState({{> locator}}, false, '{{escapeQuotes selectorRef}}'{{> checked-opts cls=checkedClass attr=checkedAttribute}});

package/dist/generators/test-generator/adapters/playwright/templates/steps/actions/unknown-element-action.hbs

@@ -1 +1 @@
-await page.getByText('{{escapeQuotes selectorValue}}').filter({ hasText: {{> has-text-value dataValue=dataValue exact=exact legacyTail=(eq selectorValue "")}} }){{#if (gte nth 0)}}.nth({{nth}}){{/if}}.{{action}}();
+await page.getByText('{{escapeQuotes selectorValue}}').filter({ hasText: {{> has-text-value dataValue=dataValue exact=exact legacyTail=(eq selectorValue "")}} }){{> locator-nth}}.{{action}}();

package/dist/generators/test-generator/adapters/playwright/templates/steps/actions/wait-for-page.hbs

@@ -1 +1,18 @@
-await page.waitForURL(/{{pathRegex}}/);
+{{!-- `wait for [T] page` is a WAIT, not an oracle — but a bare `page.waitForURL(/…/)` resolves on
+      the FIRST URL sample that matches, which for a client-side router is the URL it pushed before
+      the route guard had answered. Every step after the wait then ran against a page mid-redirect,
+      so their failures pointed at the wrong thing (#677). The unanchored regex also matched a
+      neighbour: `/vi/search` resolved on `/vi/search-results`.
+
+      `waitForPage` is the third caller of the settle-and-hold core in specs/url-assert.ts, after
+      the `see [T] page` / `is on [T] page` pair #662 routed there (partials/url-assertion.hbs):
+      arrive, let the page settle, HOLD the URL, and fail naming where the user actually ended up.
+
+      Where it deliberately DIFFERS from the Then-side `expectPage`: the query is not constrained.
+      A bare page ASSERTION means a bare page; a wait for a results page legitimately lands on
+      `?q=…`, and reddening there would assert something the step never said. The helper's docstring
+      carries the full argument.
+
+      `hostname` rides separately and only for an absolute page value: it is read off `u.hostname`,
+      which never appears in `u.pathname`, so one concatenated regex cannot carry both. --}}
+await waitForPage(page, { pathname: /^{{pathRegex}}\/?$/{{#if hostRegex}}, hostname: /^{{hostRegex}}$/{{/if}} });

package/dist/generators/test-generator/adapters/playwright/templates/steps/assertions/all-contain-assertion.hbs

@@ -1,7 +1,35 @@
-{
-    const __items_{{stepCounter}} = await {{> locator}}.allInnerTexts();
-    expect(__items_{{stepCounter}}.length, 'Expected at least one [{{selectorRef}}]').toBeGreaterThan(0);
+{{!-- All-contain: the assertion has to SURVIVE whatever async action precedes it.
+
+      `locator.allInnerTexts()` is a one-shot DOM read — no auto-wait, no retry — and wrapping its
+      RESULT in expect() adds no waiting either, because by then it is a plain array of strings.
+      Playwright's auto-waiting only applies when the LOCATOR is handed to expect(). Placed after a
+      search click or a filter change, the old shape asserted against the PRE-action DOM and failed
+      deterministically, naming real-looking values that read as a product defect rather than as a
+      generator bug (#672). A `toBeGreaterThan(0)` guard does not help: the stale list is non-empty,
+      so the length check passes and the CONTENT check is what races.
+
+      Playwright has no locator-level "every match contains X" — `filter({ hasNotText })` matches
+      case-insensitively on normalized whitespace, which is not the `toContain` semantics this step
+      promises — so the wait is expressed with expect.poll, which retries for `expect.timeout` from
+      playwright.config.ts. Two details carry the fix:
+
+      - The loop asserts on the snapshot the poll SETTLED on. Re-reading the locator afterwards
+        reopens the very race being closed — a late render pass between the poll settling and the
+        re-read swapped the rows out again, which is how the reporter's first patch passed in
+        isolation and failed in the full suite.
+      - The poll's own rejection is swallowed: on its own it can only report
+        `toBe(true) received false`. The per-item expect() below names expected vs received, which
+        is the message a QA has to act on. --~}}{
+    const __expected_{{stepCounter}} = '{{escapeQuotes expectedText}}';
+    let __items_{{stepCounter}}: string[] = [];
+    try {
+      await expect.poll(async () => {
+        __items_{{stepCounter}} = await {{> locator}}.allInnerTexts();
+        return __items_{{stepCounter}}.length > 0 && __items_{{stepCounter}}.every((__s) => __s.includes(__expected_{{stepCounter}}));
+      }).toBe(true);
+    } catch { /* the assertions below report expected-vs-received on the settled snapshot */ }
+    expect(__items_{{stepCounter}}.length, 'Expected at least one [{{escapeQuotes selectorRef}}]').toBeGreaterThan(0);
     for (const __t_{{stepCounter}} of __items_{{stepCounter}}) {
-      expect(__t_{{stepCounter}}).toContain('{{expectedText}}');
+      expect(__t_{{stepCounter}}).toContain(__expected_{{stepCounter}});
     }
   }

package/dist/generators/test-generator/adapters/playwright/templates/steps/assertions/all-contain-element.hbs

@@ -1,7 +1,10 @@
-{
+{{!-- The count() below is a one-shot read, same class as #672: after a search or filter click the
+      container list may not have rendered yet, and a bare `toBeGreaterThan(0)` on a stale 0 fails
+      instantly with no retry. `not.toHaveCount(0)` IS locator-based, so it auto-waits for the list
+      to appear; count() then reads a list that is already known to exist. --~}}{
     const {{containerVar}} = {{> locator}};
+    await expect({{containerVar}}, 'Expected at least one [{{escapeQuotes selectorRef}}]').not.toHaveCount(0);
     const __n_{{stepCounter}} = await {{containerVar}}.count();
-    expect(__n_{{stepCounter}}, 'Expected at least one [{{escapeQuotes selectorRef}}]').toBeGreaterThan(0);
     for (let {{containerIndexVar}} = 0; {{containerIndexVar}} < __n_{{stepCounter}}; {{containerIndexVar}}++) {
       await expect({{#with child}}{{> locator parentLocator=(add (add (add ../containerVar ".nth(") ../containerIndexVar) ")")}}{{/with}}, 'Every [{{escapeQuotes selectorRef}}] must contain [{{escapeQuotes childRef}}]').toBeVisible();
     }

package/dist/generators/test-generator/adapters/playwright/templates/steps/assertions/checked-assertion.hbs

@@ -1 +1,5 @@
-await expect({{> locator}}).toBeChecked();
+{{!-- `expect(locator).toBeChecked()` throws the same "Not a checkbox or radio button" (#675) on a
+      `<button aria-pressed>` as the action side did, so driving a toggle worked while ASSERTING it
+      did not. expectCheckedState reads state the same way setCheckedState drives it — an action and
+      the assertion after it can never disagree about what the control reports. --}}
+await expectCheckedState({{> locator}}, true, '{{escapeQuotes selectorRef}}'{{> checked-opts cls=checkedClass attr=checkedAttribute}});

package/dist/generators/test-generator/adapters/playwright/templates/steps/assertions/column-cell-assertion.hbs

@@ -1,3 +1,14 @@
-await expect({{> locator}}.getByRole('columnheader', { name: '{{columnName}}', includeHidden: true })).toBeVisible();
+{{!-- Rooted at `page`, like the two lines below it. This line used to render `{{> locator}}` from
+      step data that carries no strategy/value at all, so it emitted `page.locator('')` — an empty
+      CSS selector, which Playwright refuses to parse. The step could not run.
+
+      Block-scoped: the column-index const is named after the [Reference], so two steps naming the
+      same column — or two non-ASCII references, which sanitize down to the same identifier — would
+      redeclare it in one scenario and the spec would not compile. The braces make each step's
+      binding its own.
+
+      Not dialog/frame scoped: this step form carries no selector entry, so there is nothing for
+      `pageRoot` to read. A column assertion inside a modal needs the row-scoped form. --~}}{ await expect(page.getByRole('columnheader', { name: '{{columnName}}', includeHidden: true })).toBeVisible();
 const {{columnIndexVar}} = (await page.getByRole('columnheader', { includeHidden: true }).filter({ visible: true }).allTextContents()).findIndex(h => h.includes('{{columnName}}'));
-await expect(page.getByRole('row', { includeHidden: true }).filter({ visible: true }).nth({{rowNth}}).getByRole('cell', { includeHidden: true }).filter({ visible: true }).nth({{columnIndexVar}})).toHaveText('{{dataValue}}');
+expect({{columnIndexVar}}, 'Column "{{escapeQuotes columnName}}" is not among the visible headers').toBeGreaterThanOrEqual(0);
+await expect(page.getByRole('row', { includeHidden: true }).filter({ visible: true }).nth({{rowNth}}).getByRole('cell', { includeHidden: true }).filter({ visible: true }).nth({{columnIndexVar}})).toHaveText('{{dataValue}}'); }

package/dist/generators/test-generator/adapters/playwright/templates/steps/assertions/contain-text-assertion.hbs

@@ -1 +1 @@
-await expect({{> locator}}).toContainText('{{expectedText}}');
+await expect({{> locator}}).toContainText('{{escapeQuotes expectedText}}');

package/dist/generators/test-generator/adapters/playwright/templates/steps/assertions/disabled-with-role-variable-assertion.hbs

@@ -1,5 +1,5 @@
 {{#if name}}
-await expect(page.getByRole('{{role}}', { name: '{{escapeQuotes name}}'{{#if exact}}, exact: true{{/if}} }).filter({ hasText: /^{{escapeRegex dataValue}}$/ }){{#if (gte nth 0)}}.nth({{nth}}){{/if}}).toBeDisabled();
+await expect(page.getByRole('{{role}}', { name: '{{escapeQuotes name}}'{{#if exact}}, exact: true{{/if}} }).filter({ hasText: /^{{escapeRegex dataValue}}$/ }){{> locator-nth}}).toBeDisabled();
 {{else}}
-await expect(page.getByRole('{{role}}'{{#if exact}}, { exact: true }{{/if}}).filter({ hasText: /^{{escapeRegex dataValue}}$/ }){{#if (gte nth 0)}}.nth({{nth}}){{/if}}).toBeDisabled();
+await expect(page.getByRole('{{role}}'{{#if exact}}, { exact: true }{{/if}}).filter({ hasText: /^{{escapeRegex dataValue}}$/ }){{> locator-nth}}).toBeDisabled();
 {{/if}}

package/dist/generators/test-generator/adapters/playwright/templates/steps/assertions/disabled-with-variable-assertion.hbs

@@ -1 +1 @@
-await expect(page.getByText('{{escapeQuotes selectorRef}}').filter({ hasText: {{#if (eq selectorValue "")}}/.*{{escapeRegex dataValue}}$/{{else}}'{{escapeQuotes dataValue}}'{{/if}} }){{#if (gte nth 0)}}.nth({{nth}}){{/if}}).toBeDisabled();
+await expect(page.getByText('{{escapeQuotes selectorRef}}').filter({ hasText: {{#if (eq selectorValue "")}}/.*{{escapeRegex dataValue}}$/{{else}}'{{escapeQuotes dataValue}}'{{/if}} }){{> locator-nth}}).toBeDisabled();

package/dist/generators/test-generator/adapters/playwright/templates/steps/assertions/have-text-assertion.hbs

@@ -1 +1 @@
-await expect({{> locator}}).toHaveText('{{expectedText}}');
+await expect({{> locator}}).toHaveText('{{escapeQuotes expectedText}}');

package/dist/generators/test-generator/adapters/playwright/templates/steps/assertions/hidden-with-role-variable-assertion.hbs

@@ -1,5 +1,5 @@
 {{#if name}}
-await expect(page.getByRole('{{role}}', { name: '{{escapeQuotes name}}'{{#if exact}}, exact: true{{/if}} }).filter({ hasText: /^{{escapeRegex dataValue}}$/ }){{#if (gte nth 0)}}.nth({{nth}}){{/if}}).toBeHidden();
+await expect(page.getByRole('{{role}}', { name: '{{escapeQuotes name}}'{{#if exact}}, exact: true{{/if}} }).filter({ hasText: /^{{escapeRegex dataValue}}$/ }){{> locator-nth}}).toBeHidden();
 {{else}}
-await expect(page.getByRole('{{role}}'{{#if exact}}, { exact: true }{{/if}}).filter({ hasText: /^{{escapeRegex dataValue}}$/ }){{#if (gte nth 0)}}.nth({{nth}}){{/if}}).toBeHidden();
+await expect(page.getByRole('{{role}}'{{#if exact}}, { exact: true }{{/if}}).filter({ hasText: /^{{escapeRegex dataValue}}$/ }){{> locator-nth}}).toBeHidden();
 {{/if}}

package/dist/generators/test-generator/adapters/playwright/templates/steps/assertions/hidden-with-variable-assertion.hbs

@@ -1 +1 @@
-await expect(page.getByText('{{escapeQuotes selectorRef}}').filter({ hasText: {{#if (eq selectorValue "")}}/.*{{escapeRegex dataValue}}$/{{else}}'{{escapeQuotes dataValue}}'{{/if}} }){{#if (gte nth 0)}}.nth({{nth}}){{/if}}).toBeHidden();
+await expect(page.getByText('{{escapeQuotes selectorRef}}').filter({ hasText: {{#if (eq selectorValue "")}}/.*{{escapeRegex dataValue}}$/{{else}}'{{escapeQuotes dataValue}}'{{/if}} }){{> locator-nth}}).toBeHidden();

package/dist/generators/test-generator/adapters/playwright/templates/steps/assertions/not-checked-assertion.hbs

@@ -1 +1,2 @@
-await expect({{> locator}}).toBeChecked({ checked: false });
+{{!-- Inverse of checked-assertion.hbs — see there (#675). --}}
+await expectCheckedState({{> locator}}, false, '{{escapeQuotes selectorRef}}'{{> checked-opts cls=checkedClass attr=checkedAttribute}});

package/dist/generators/test-generator/adapters/playwright/templates/steps/assertions/selected-assertion.hbs

@@ -1,7 +1,16 @@
-{{#if (or (eq role 'checkbox') (eq role 'radio') (eq role 'switch'))}}
+{{#if (or checkedClass checkedAttribute)}}
+{{!-- A DECLARED signal (issue #730) short-circuits the whole ARIA probe below: the author
+     reached for `selected:`/`checked:` precisely because this component publishes no aria-selected,
+     no aria-current and no checked state — a Tailwind card/tab picker. Probing for them first would
+     just spend the budget confirming they are absent. --}}
+await expectCheckedState({{> locator}}, true, '{{escapeQuotes selectorRef}}'{{> checked-opts cls=checkedClass attr=checkedAttribute}});
+{{else if (or (eq role 'checkbox') (eq role 'radio') (eq role 'switch'))}}
 {{!-- Form control: "selected" is the checked state, never aria-selected. A native checkbox/radio
      exposes no aria-selected attribute — its state lives in the `checked` property. --}}
-await expect({{> locator}}).toBeChecked();
+{{!-- "selected" on a form control IS the checked state — routed through expectCheckedState so an
+     aria-pressed toggle does not throw "Not a checkbox or radio button" (#675), and so the selector
+     that declares role: switch while the element publishes aria-pressed still reads correctly. --}}
+await expectCheckedState({{> locator}}, true, '{{escapeQuotes selectorRef}}');
 {{else}}
 {{!-- Other/unknown role (tab, option, or a text/testid/css selector): probe at runtime. An ARIA
      single-select widget exposes aria-selected → assert it; anything without it falls back to the
@@ -17,7 +26,9 @@ await expect(el).toHaveAttribute('aria-selected', 'true');
      role=tab owns the stronger signal. --}}
 await expect(el).toHaveAttribute('aria-current', /^(?!false$)./);
 } else {
-await expect(el).toBeChecked();
+{{!-- Last resort, same as the -with-filter twin: neither aria-selected nor aria-current, so read the
+     checked/pressed state through the #675-safe path rather than toBeChecked(). --}}
+await expectCheckedState(el, true, '{{escapeQuotes selectorRef}}');
 }
 }
 {{/if}}

package/dist/generators/test-generator/adapters/playwright/templates/steps/assertions/state-with-filter-assertion.hbs

@@ -1,6 +1,12 @@
 {{!-- Filter contract shared with the visible/hidden/contains siblings (has-text-value):
       substring by default, `exact: true` in the selector YAML anchors. --}}
 {{#if selectedProbe}}
+{{#if (or checkedClass checkedAttribute)}}
+{{!-- Declared class signal (issue #730) — short-circuits the ARIA probe, exactly as the unfiltered
+     twin selected-assertion.hbs does. Without this branch the filtered form stayed broken while the
+     unfiltered one worked, which is the inconsistency #730's second field report ran into. --}}
+await expectCheckedState({{> locator-base}}.filter({ hasText: {{> has-text-value dataValue=dataValue exact=exact}} }){{> locator-nth}}, true, '{{escapeQuotes selectorRef}}'{{> checked-opts cls=checkedClass attr=checkedAttribute}});
+{{else}}
 { const el = {{> locator-base}}.filter({ hasText: {{> has-text-value dataValue=dataValue exact=exact}} }){{> locator-nth}};
 if ((await el.getAttribute('aria-selected')) !== null) {
 await expect(el).toHaveAttribute('aria-selected', 'true');
@@ -12,9 +18,14 @@ await expect(el).toHaveAttribute('aria-selected', 'true');
      role=tab owns the stronger signal. --}}
 await expect(el).toHaveAttribute('aria-current', /^(?!false$)./);
 } else {
-await expect(el).toBeChecked();
+{{!-- Last resort: the element publishes neither aria-selected nor aria-current. toBeChecked() used
+     to sit here and threw "Not a checkbox or radio button" on an aria-pressed toggle (#675). --}}
+await expectCheckedState(el, true, '{{escapeQuotes selectorRef}}');
 }
 }
+{{/if}}
+{{else}}{{#if isCheckedAssertion}}
+await expectCheckedState({{> locator-base}}.filter({ hasText: {{> has-text-value dataValue=dataValue exact=exact}} }){{> locator-nth}}, {{checkedWant}}, '{{escapeQuotes selectorRef}}'{{> checked-opts cls=checkedClass attr=checkedAttribute}});
 {{else}}
 await expect({{> locator-base}}.filter({ hasText: {{> has-text-value dataValue=dataValue exact=exact}} }){{> locator-nth}}).{{{stateAssertion}}};
-{{/if}}
+{{/if}}{{/if}}

package/dist/generators/test-generator/adapters/playwright/templates/steps/assertions/visible-with-role-variable-assertion.hbs

@@ -1,9 +1,9 @@
 {{#if name}}
 {{#if dataValue}}
-await expect(page.getByRole('{{role}}', { name: '{{escapeQuotes name}}'{{#if exact}}, exact: true{{/if}} }).filter({ hasText: /^{{escapeRegex dataValue}}$/ }){{#if (gte nth 0)}}.nth({{nth}}){{/if}}).toBeVisible();
+await expect(page.getByRole('{{role}}', { name: '{{escapeQuotes name}}'{{#if exact}}, exact: true{{/if}} }).filter({ hasText: /^{{escapeRegex dataValue}}$/ }){{> locator-nth}}).toBeVisible();
 {{else}}
-await expect(page.getByRole('{{role}}', { name: '{{escapeQuotes name}}'{{#if exact}}, exact: true{{/if}} }){{#if (gte nth 0)}}.nth({{nth}}){{/if}}).toBeVisible();
+await expect(page.getByRole('{{role}}', { name: '{{escapeQuotes name}}'{{#if exact}}, exact: true{{/if}} }){{> locator-nth}}).toBeVisible();
 {{/if}}
 {{else}}
-await expect(page.getByRole('{{role}}'{{#if exact}}, { exact: true }{{/if}}).filter({ hasText: /^{{escapeRegex dataValue}}$/ }){{#if (gte nth 0)}}.nth({{nth}}){{/if}}).toBeVisible();
+await expect(page.getByRole('{{role}}'{{#if exact}}, { exact: true }{{/if}}).filter({ hasText: /^{{escapeRegex dataValue}}$/ }){{> locator-nth}}).toBeVisible();
 {{/if}}

package/dist/generators/test-generator/adapters/playwright/templates/steps/assertions/visible-with-value-assertion.hbs

@@ -1 +1 @@
-await expect(page.getByText('{{escapeQuotes value}}'{{#if exact}}, { exact: true }{{/if}}){{#if (gte nth 0)}}.nth({{nth}}){{/if}}).toBeVisible();
+await expect(page.getByText('{{escapeQuotes value}}'{{#if exact}}, { exact: true }{{/if}}){{> locator-nth}}).toBeVisible();

package/dist/generators/test-generator/adapters/playwright/templates/steps/assertions/visible-with-variable-assertion.hbs

@@ -1 +1 @@
-await expect(page.getByText('{{escapeQuotes selectorValue}}').filter({ hasText: /.*{{escapeRegex dataValue}}$/ }){{#if (gte nth 0)}}.nth({{nth}}){{/if}}).toBeVisible();
+await expect(page.getByText('{{escapeQuotes selectorValue}}').filter({ hasText: /.*{{escapeRegex dataValue}}$/ }){{> locator-nth}}).toBeVisible();

package/dist/generators/test-generator/adapters/playwright/templates/steps/partials/checked-opts.hbs

@@ -0,0 +1,8 @@
+{{!-- The `checked:`/`selected:` signal from selectors.yaml, appended as the options argument of
+      setCheckedState/expectCheckedState (issue #730). One partial so all nine call sites carry it
+      identically, and so a site that declares nothing stays BYTE-IDENTICAL to before — the whole
+      argument disappears rather than becoming an empty object. Takes `cls`/`attr` so a caller can
+      pass a signal resolved from a DIFFERENT entry than the one it spread (table-action-in-row
+      spreads the TABLE but acts on the row's own control). A selector declares one or the other;
+      the resolver refuses both, so the two branches never collide here. --~}}
+{{~#if cls}}, { checkedClass: '{{escapeQuotes cls}}' }{{else if attr}}, { checkedAttribute: '{{escapeQuotes attr}}' }{{/if~}}

package/dist/generators/test-generator/adapters/playwright/templates/steps/partials/locator-nth.hbs

@@ -1 +1 @@
-{{#if (gte nth 0)}}.nth({{nth}}){{/if}}
+{{#if (gte nth 0)}}.nth({{nth}}){{else if (eq nth -1)}}.last(){{/if}}

package/dist/generators/test-generator/adapters/playwright/templates/test-file.hbs

@@ -98,6 +98,16 @@ test.describe.serial('{{featureName}}', () => {
   });
 {{/if}}
 
+{{#if beforeAll}}
+{{beforeAll}}
+
+{{/if}}
+{{#if afterAll}}
+  // User @afterAll runs BEFORE the built-in close below (Playwright runs afterAll hooks in registration
+  // order), so the shared page is still open for its cleanup steps.
+{{afterAll}}
+
+{{/if}}
   test.afterAll(async () => {
     await page.close();
     await context.close();
@@ -112,18 +122,10 @@ test.describe.serial('{{featureName}}', () => {
 {{#if screenshotOnFailure}}
   test.use({ screenshotOnFailure: true });
 
-{{/if}}
-{{#if beforeAll}}
-{{beforeAll}}
-
 {{/if}}
 {{#if afterEach}}
 {{afterEach}}
 
-{{/if}}
-{{#if afterAll}}
-{{afterAll}}
-
 {{/if}}
 {{#if authGroups}}
 {{#each authGroups}}

package/dist/generators/test-generator/code-generator.d.ts

@@ -75,6 +75,23 @@ export declare class CodeGenerator {
     private generateTestCode;
     private generateBackgroundSteps;
     private generateBeforeEach;
+    /**
+     * Hook block (`@beforeAll` / `@afterEach` / `@afterAll`). Shares prepare/finalize with ordinary
+     * scenarios, so an `@api:` / `@query:` precondition on the hook runs INSIDE it (bind {{name}}) and
+     * the hook's own `{{name.*}}` refs resolve at runtime — a hook used to map only its steps, so
+     * `@beforeAll @api:login` compiled to a beforeAll with no api.call and a testData.get() of nothing.
+     * Not applied to hooks: `@cases` (a hook has no dataset rows) and `@extend` (no base scenario) —
+     * warned and ignored; `@auth:` grouping and the mock epilogue are scenario-only. `@concurrent:N`
+     * IS valid: the api capability reads it off the same tags.
+     *
+     * Failure collection: a failing hook skips every test in its describe, so one run must report
+     * EVERY failed check, not just the first. The hook template wraps each mapped step in try/catch:
+     * an assertion step (effective keyword Then) records its failure and lets the next step run; an
+     * action step (Given/When) records it and fails the hook right there, since the steps after it
+     * would run on state the failed action never produced. The block ends with a guard that fails once
+     * with the full list. `expect.soft` is not an option here — a soft failure marks the owning test,
+     * and a hook has none.
+     */
     private generateHook;
     /**
      * TQ-11 — a `@requires:<cap>` scenario whose capability is NOT enabled. Emits a real `test()`
@@ -83,6 +100,26 @@ export declare class CodeGenerator {
      * scenario compiles to its full automated body instead.
      */
     private generateRequiresSkipStub;
+    /**
+     * Scenario-body preparation shared by ordinary scenarios and hook blocks — runs BEFORE the steps
+     * are mapped (the step mapper reads what it sets): scenario context, `@cases` row-column capture,
+     * and the capability preconditions (`@api:<name>` / `@query:<name>` → bind {{name}}) whose bound
+     * `{{name.*}}` refs exist only at runtime, so they are registered as captured and compile to a
+     * runtime get() instead of a compile-time YAML lookup that would fail. Pair with
+     * finalizeScenarioBody(), which prepends the preconditions once the steps are mapped.
+     */
+    private prepareScenarioBody;
+    /**
+     * Capability preconditions run BEFORE the body's own steps — prepend them (indented) once the
+     * steps are mapped. Second half of the prepareScenarioBody() pair.
+     */
+    private finalizeScenarioBody;
+    /**
+     * Step-boundary trace (#673): scenario name → the ordered step-comment texts emitted for it.
+     * Read by script-check to attribute emitted code to steps structurally; see the populating
+     * site in generateScenario for why comment adjacency cannot do the job.
+     */
+    readonly stepTrace: Map<string, string[]>;
     private generateScenario;
     /**
      * Indent code lines with specified number of spaces

package/dist/generators/test-generator/code-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code-generator.d.ts","sourceRoot":"","sources":["../../../src/generators/test-generator/code-generator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAA8B,MAAM,mBAAmB,CAAC;AAI9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAuOrD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAM;IAErB,OAAO,CAAC,eAAe,CAAc;IAErC,OAAO,CAAC,aAAa,CAAqC;IAE1D,OAAO,CAAC,WAAW,CAA8B;gBAErC,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAO;IAiBtK,oFAAoF;IACpF,cAAc,IAAI,oBAAoB;IAItC;;OAEG;IACG,YAAY,CAChB,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,CAAC;IA4FzB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAavB;;;OAGG;IACH,OAAO,CAAC,UAAU;IAclB;;OAEG;IACH,SAAS,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI;IAS7C;;OAEG;IACH;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IA0C3B;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IAoB/B;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAY3B,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;YASzB,gBAAgB;YAuWhB,uBAAuB;YAYvB,kBAAkB;YAoBlB,YAAY;IAqB1B;;;;;OAKG;IACH,OAAO,CAAC,wBAAwB;YASlB,gBAAgB;IAoJ9B;;OAEG;IACH,OAAO,CAAC,UAAU;IAKlB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAS7B;;OAEG;IACH;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,kBAAkB;IAyBpB,gBAAgB,CACpB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,aAAa,EAAE,CAAC;CA+D5B"}
+{"version":3,"file":"code-generator.d.ts","sourceRoot":"","sources":["../../../src/generators/test-generator/code-generator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAA8B,MAAM,mBAAmB,CAAC;AAI9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AA0OrD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAM;IAErB,OAAO,CAAC,eAAe,CAAc;IAErC,OAAO,CAAC,aAAa,CAAqC;IAE1D,OAAO,CAAC,WAAW,CAA8B;gBAErC,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAO;IAiBtK,oFAAoF;IACpF,cAAc,IAAI,oBAAoB;IAItC;;OAEG;IACG,YAAY,CAChB,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,CAAC;IAqGzB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAavB;;;OAGG;IACH,OAAO,CAAC,UAAU;IAclB;;OAEG;IACH,SAAS,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI;IAS7C;;OAEG;IACH;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IA0C3B;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IAoB/B;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAY3B,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;YAczB,gBAAgB;YA4YhB,uBAAuB;YAYvB,kBAAkB;IAoBhC;;;;;;;;;;;;;;;;OAgBG;YACW,YAAY;IA+C1B;;;;;OAKG;IACH,OAAO,CAAC,wBAAwB;IAShC;;;;;;;OAOG;IACH,OAAO,CAAC,mBAAmB;IAgC3B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAM5B;;;;OAIG;IACH,QAAQ,CAAC,SAAS,wBAA+B;YAEnC,gBAAgB;IA6H9B;;OAEG;IACH,OAAO,CAAC,UAAU;IAKlB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAS7B;;OAEG;IACH;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,kBAAkB;IAyBpB,gBAAgB,CACpB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,aAAa,EAAE,CAAC;CA+D5B"}