@sungen/driver-ui 3.2.34 → 3.3.0-alpha.2

package/dist/patterns/storage-patterns.js

@@ -0,0 +1,142 @@
+"use strict";
+/**
+ * Browser-storage assertion patterns — read-only checks against
+ * localStorage/sessionStorage:
+ *
+ *   Then User see [KEY] in local storage exists
+ *   Then User see [KEY] in local storage does not exist
+ *   Then User see [KEY] in local storage is not empty
+ *   Then User see [KEY] in local storage has length {{n}}
+ *   Then User see key matching "PATTERN" in local storage
+ *   (+ the same five with `session storage`)
+ *
+ * Leak-safe by construction: the check runs INSIDE the browser and only a
+ * boolean crosses back — a failed assertion's Expected:/Received: shows
+ * true/false, never the stored value (tokens routinely live in these keys,
+ * and failure text is lifted verbatim into committed deliverables).
+ *
+ * `[KEY]` is NOT a selector reference — resolveSelector is never called.
+ * The bracket content is parsed here; an embedded `{{var}}` compiles to a
+ * testData.get() concatenation directly (same approach as the DB patterns'
+ * value binding), so `[{{code}}_ACCESS_TOKEN]` works without the marker
+ * pipeline. The parser stamps elementType="in" (first word after the
+ * bracket) — meaningless here, deliberately ignored.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.storagePatterns = void 0;
+// Matchers see ref contents MASKED ([AUTH_TOKEN] → [~], {{n}} → {{~}}), so they
+// anchor on the discriminator OUTSIDE the brackets. Anchored + priority 60 —
+// the generic `should-be-visible` catch-all (priority 10, any `see [ref]`)
+// otherwise claims every bracketed shape and asserts a DOM element instead.
+const AREA = String.raw `(?:local|session)\s+storage`;
+const reExists = new RegExp(String.raw `\bsees?\s+\[~\]\s+in\s+${AREA}\s+exists\b`, 'i');
+const reNotExist = new RegExp(String.raw `\bsees?\s+\[~\]\s+in\s+${AREA}\s+does\s+not\s+exist\b`, 'i');
+const reNotEmpty = new RegExp(String.raw `\bsees?\s+\[~\]\s+in\s+${AREA}\s+is\s+not\s+empty\b`, 'i');
+const reHasLength = new RegExp(String.raw `\bsees?\s+\[~\]\s+in\s+${AREA}\s+has\s+length\s+(?:\{\{~\}\}|\d+)`, 'i');
+// The one shape with no bracket: the quoted pattern survives masking untouched.
+const reKeyMatching = new RegExp(String.raw `\bsees?\s+key\s+matching\s+"[^"]+"\s+in\s+${AREA}\b`, 'i');
+/**
+ * `localStorage` | `sessionStorage` from the step's STRUCTURAL text — bracket keys and
+ * quoted patterns are neutralized first, so a key named "user session storage flag"
+ * (or a pattern containing the words) can never flip the area of a `local storage` step.
+ */
+function storageArea(text) {
+    const structural = text.replace(/\[[^\]]*\]/g, '[~]').replace(/"[^"]*"/g, '""');
+    return /\bin\s+session\s+storage\b/i.test(structural) ? 'sessionStorage' : 'localStorage';
+}
+/** 'local storage' | 'session storage' — for comments/messages. */
+function areaLabel(text) {
+    return storageArea(text) === 'sessionStorage' ? 'session storage' : 'local storage';
+}
+/**
+ * Bracket content → JS string expression. A plain key becomes a quoted literal;
+ * embedded `{{var}}` refs become `${testData.get('var')}` interpolations in a
+ * template literal (direct concatenation — no marker round-trip).
+ */
+function keyExpr(raw) {
+    if (!/\{\{[^}]+\}\}/.test(raw))
+        return JSON.stringify(raw);
+    // `$` is escaped too: a literal `${` in the key would otherwise become a LIVE
+    // interpolation in the emitted template literal. The {{var}} substitution below
+    // inserts its own `${testData.get(...)}` afterwards, so it is unaffected.
+    const body = raw
+        .replace(/[\\`$]/g, '\\$&')
+        .replace(/\{\{\s*([^}]+?)\s*\}\}/g, (_, name) => `\${testData.get(${JSON.stringify(name)})}`);
+    return `\`${body}\``;
+}
+/** The bracketed key from the ORIGINAL step text (masking never reaches resolvers). */
+function bracketKey(text) {
+    const m = text.match(/sees?\s+\[([^\]]+)\]\s+in/i);
+    return m ? m[1] : '';
+}
+function buildCheck(text, area) {
+    if (/\bdoes\s+not\s+exist\b/i.test(text)) {
+        return { checkExpr: `window.${area}.getItem(k) === null`, argExpr: 'null', expectation: 'expected to be absent' };
+    }
+    if (/\bis\s+not\s+empty\b/i.test(text)) {
+        return { checkExpr: `!!window.${area}.getItem(k)`, argExpr: 'null', expectation: 'expected a non-empty value' };
+    }
+    const len = text.match(/\bhas\s+length\s+(\{\{[^}]+\}\}|\d+)/i);
+    if (len) {
+        const v = len[1].match(/^\{\{\s*([^}]+?)\s*\}\}$/);
+        const argExpr = v ? `Number(testData.get(${JSON.stringify(v[1])}))` : len[1];
+        return { checkExpr: `(window.${area}.getItem(k) ?? '').length === arg`, argExpr, expectation: 'expected the given length' };
+    }
+    if (/\bexists\b/i.test(text)) {
+        return { checkExpr: `window.${area}.getItem(k) !== null`, argExpr: 'null', expectation: 'expected to exist' };
+    }
+    return null;
+}
+exports.storagePatterns = [
+    {
+        name: 'storage-key-assertion',
+        platforms: ['web'],
+        platformAlternative: 'browser local/session storage has no native equivalent - assert the state through a UI element, or through @api/@query against the backend',
+        matcher: (step) => reExists.test(step.text) || reNotExist.test(step.text) ||
+            reNotEmpty.test(step.text) || reHasLength.test(step.text),
+        resolver: (step) => {
+            const area = storageArea(step.text);
+            const check = buildCheck(step.text, area);
+            const rawKey = bracketKey(step.text);
+            // Matcher anchoring guarantees both; guard for the type system.
+            if (!check || !rawKey)
+                throw new Error(`unrecognized storage assertion: ${step.text}`);
+            const k = keyExpr(rawKey);
+            return {
+                templateName: 'storage-key-assertion',
+                data: {
+                    checkExpr: check.checkExpr,
+                    keyExpr: k,
+                    argExpr: check.argExpr,
+                    // Key NAME is printable; the stored VALUE never crosses this boundary.
+                    messageExpr: `'key ' + ${k} + ' in ${areaLabel(step.text)}: ${check.expectation}'`,
+                },
+                comment: `Assert ${rawKey} in ${areaLabel(step.text)} (${check.expectation})`,
+            };
+        },
+        priority: 60,
+    },
+    {
+        name: 'storage-key-matching-assertion',
+        platforms: ['web'],
+        platformAlternative: 'browser local/session storage has no native equivalent - assert the state through a UI element, or through @api/@query against the backend',
+        matcher: (step) => reKeyMatching.test(step.text),
+        resolver: (step) => {
+            const area = storageArea(step.text);
+            const m = step.text.match(/key\s+matching\s+"([^"]+)"/i);
+            const pattern = m ? m[1] : '';
+            return {
+                templateName: 'storage-key-assertion',
+                data: {
+                    checkExpr: `Object.keys(window.${area}).some((key) => new RegExp(k).test(key))`,
+                    keyExpr: JSON.stringify(pattern),
+                    argExpr: 'null',
+                    messageExpr: `'key matching ' + ${JSON.stringify(JSON.stringify(pattern))} + ' in ${areaLabel(step.text)}: expected a match'`,
+                },
+                comment: `Assert a ${areaLabel(step.text)} key matches "${pattern}"`,
+            };
+        },
+        priority: 60,
+    },
+];
+//# sourceMappingURL=storage-patterns.js.map

package/dist/patterns/storage-patterns.js.map

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

package/dist/patterns/table-pagination-patterns.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Table Pagination Patterns (issue #712)
+ *
+ * Syntax:
+ * - User go to next page in [Orders] table
+ * - User go to prev page in [Orders] table          # `previous` accepted too
+ *
+ * These are the consumers for the table entry's `pagination:` map, which was documented in the
+ * selector reference and plumbed onto ResolvedSelector while nothing read it back — writing it
+ * changed nothing, with no diagnostic (#712, the same drift class as #690).
+ *
+ *   orders:
+ *     type: 'table'
+ *     value: 'table.orders'
+ *     pagination:
+ *       next: '[data-testid="next-page"]'
+ *       prev: '[data-testid="prev-page"]'
+ *
+ * Three deliberate choices:
+ *
+ * PAGE-LEVEL, NOT TABLE-SCOPED. The control is located from `page`, not from inside the table
+ * locator, because in every component library that ships a paginator (antd, MUI, Radix) the
+ * control is a SIBLING of the <table>, not a descendant. Scoping it to the table would resolve 0
+ * elements for the common case — the same vacuous-universe failure `rows:` exists to fix
+ * (SG-W016). The field lives on the table entry because it BELONGS to that table logically, not
+ * because it is nested under it in the DOM.
+ *
+ * NO IMPLICIT WAIT. Clicking next does one thing: click. The round-trip afterwards is
+ * `User wait for [Orders] table to refresh`, which already owns signal resolution (aria-busy,
+ * then the profile's loading indicator). Folding a hidden wait in here would duplicate that
+ * logic and hide which signal was used. A disabled control (already on the last page) needs no
+ * guard either: Playwright's click waits for enabled and fails loud, so the step cannot pass
+ * without having done anything.
+ *
+ * REFUSAL VIA THE SHARED PATH, NOT A WEB TEMPLATE. An undeclared direction reports SG-W017 and
+ * compiles through `unsupportedStepCode`, rather than rendering a refusal template of its own:
+ * playwright's refusal-only template count is a deliberate floor of 0 (refusals there are the
+ * platform's job, not a step's), and a one-sided .hbs would fail the adapter-parity gate.
+ */
+import { StepPattern } from '@sun-asterisk/sungen';
+export declare const tablePaginationPatterns: StepPattern[];
+//# sourceMappingURL=table-pagination-patterns.d.ts.map

package/dist/patterns/table-pagination-patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-pagination-patterns.d.ts","sourceRoot":"","sources":["../../src/patterns/table-pagination-patterns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,EAAE,WAAW,EAAmD,MAAM,sBAAsB,CAAC;AAUpG,eAAO,MAAM,uBAAuB,EAAE,WAAW,EAmDhD,CAAC"}

package/dist/patterns/table-pagination-patterns.js

@@ -0,0 +1,93 @@
+"use strict";
+/**
+ * Table Pagination Patterns (issue #712)
+ *
+ * Syntax:
+ * - User go to next page in [Orders] table
+ * - User go to prev page in [Orders] table          # `previous` accepted too
+ *
+ * These are the consumers for the table entry's `pagination:` map, which was documented in the
+ * selector reference and plumbed onto ResolvedSelector while nothing read it back — writing it
+ * changed nothing, with no diagnostic (#712, the same drift class as #690).
+ *
+ *   orders:
+ *     type: 'table'
+ *     value: 'table.orders'
+ *     pagination:
+ *       next: '[data-testid="next-page"]'
+ *       prev: '[data-testid="prev-page"]'
+ *
+ * Three deliberate choices:
+ *
+ * PAGE-LEVEL, NOT TABLE-SCOPED. The control is located from `page`, not from inside the table
+ * locator, because in every component library that ships a paginator (antd, MUI, Radix) the
+ * control is a SIBLING of the <table>, not a descendant. Scoping it to the table would resolve 0
+ * elements for the common case — the same vacuous-universe failure `rows:` exists to fix
+ * (SG-W016). The field lives on the table entry because it BELONGS to that table logically, not
+ * because it is nested under it in the DOM.
+ *
+ * NO IMPLICIT WAIT. Clicking next does one thing: click. The round-trip afterwards is
+ * `User wait for [Orders] table to refresh`, which already owns signal resolution (aria-busy,
+ * then the profile's loading indicator). Folding a hidden wait in here would duplicate that
+ * logic and hide which signal was used. A disabled control (already on the last page) needs no
+ * guard either: Playwright's click waits for enabled and fails loud, so the step cannot pass
+ * without having done anything.
+ *
+ * REFUSAL VIA THE SHARED PATH, NOT A WEB TEMPLATE. An undeclared direction reports SG-W017 and
+ * compiles through `unsupportedStepCode`, rather than rendering a refusal template of its own:
+ * playwright's refusal-only template count is a deliberate floor of 0 (refusals there are the
+ * platform's job, not a step's), and a one-sided .hbs would fail the adapter-parity gate.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tablePaginationPatterns = void 0;
+const sungen_1 = require("@sun-asterisk/sungen");
+/** `go to next page in` / `goes to previous page in` — the direction is captured. */
+const PAGINATE_STEP = /\bgo(?:es)?\s+to\s+(next|prev|previous)\s+page\s+in\b/i;
+/** Gherkin direction word → the key authors write under `pagination:` in selectors.yaml. */
+function paginationKey(direction) {
+    return /^next$/i.test(direction) ? 'next' : 'prev';
+}
+exports.tablePaginationPatterns = [
+    {
+        name: 'table-paginate',
+        platforms: ['web'],
+        platformAlternative: 'a native screen has no HTML paginator - scroll the list instead (`When User scroll to [Last Row]`), or tap the pager control directly as a plain tap step',
+        matcher: (step) => PAGINATE_STEP.test(step.text) && /\btable\b/i.test(step.text),
+        generator: (step, context) => {
+            const tableName = (step.text.match(/\[([^\]]+)\]/)?.[1] ?? '').trim();
+            const direction = step.text.match(PAGINATE_STEP)[1];
+            const key = paginationKey(direction);
+            const resolved = context.selectorResolver.resolveSelector(tableName, context.featureName, 'table', 0);
+            const declared = resolved.pagination?.[key];
+            const paginationSelector = typeof declared === 'string' ? declared.trim() : '';
+            // Nothing honest to emit: refuse at compile time and name the field to add. Guessing a
+            // locator here (hunting a button called `Next`) is exactly what #690 punished.
+            if (!paginationSelector) {
+                const known = Object.keys(resolved.pagination ?? {});
+                const found = known.length
+                    ? `that entry declares pagination.${known.join('/')} only`
+                    : 'that entry declares no pagination at all';
+                const reason = `step "${step.text}" needs "pagination.${key}" on the [${tableName}] table entry, but `
+                    + `${found}. Add it in selectors.yaml, e.g. pagination: { ${key}: '[data-testid="${key}-page"]' }.`;
+                context.diagnostics?.add('SG-W017', reason, {
+                    feature: context.featureName,
+                    step: step.text,
+                });
+                return {
+                    code: (0, sungen_1.unsupportedStepCode)(reason),
+                    comment: `pagination.${key} not declared for ${tableName} table — see SG-W017`,
+                };
+            }
+            return {
+                code: context.templateEngine.renderStep('table-paginate-action', {
+                    ...resolved, paginationSelector, direction: key, tableName,
+                }),
+                comment: `Go to ${key === 'next' ? 'next' : 'previous'} page in ${tableName} table`,
+            };
+        },
+        // Above the table family (10-20) so the strict matcher is never shadowed by a generic
+        // table step; `go to` is claimed by no navigation pattern (those match open/is on/navigate to).
+        priority: 21,
+    },
+];
+//# sourceMappingURL=table-pagination-patterns.js.map

package/dist/patterns/table-pagination-patterns.js.map

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

package/dist/patterns/table-patterns.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Table Patterns
+ * Handles: table row assertions, table cell lookups, actions in table rows
+ *
+ * Syntax (v2.4 final):
+ * - User see [Col] column in [Table] table                             # column exists
+ * - User see [Ref] row in [Table] table with {{value}}                 # row exists (enters row scope)
+ * - User see [Ref] row in [Table] table with {{value}} is hidden       # row hidden
+ * - User see [Table] table with {{count}}                              # row count
+ * - User see [Table] table is empty                                    # empty table
+ * - User see [Col] column with {{value}}                               # cell value (row scoped — handled in step-mapper)
+ * - User click [Act] button in [Table] table with {{filter}}           # action in row
+ * - User see [Table] table match data:                                 # exact table match with inline DataTable
+ *       | Header1    | Header2    |
+ *       | {{value1}} | {{value2}} |
+ */
+import { StepPattern } from '@sun-asterisk/sungen';
+export declare const tablePatterns: StepPattern[];
+//# sourceMappingURL=table-patterns.d.ts.map

package/dist/patterns/table-patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-patterns.d.ts","sourceRoot":"","sources":["../../src/patterns/table-patterns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,WAAW,EAAkB,MAAM,sBAAsB,CAAC;AAyGnE,eAAO,MAAM,aAAa,EAAE,WAAW,EA6hBtC,CAAC"}