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

package/dist/patterns/form-patterns.js

@@ -0,0 +1,239 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formPatterns = void 0;
+const sungen_1 = require("@sun-asterisk/sungen");
+/**
+ * Form action patterns: fill, type, select, check, uncheck
+ */
+exports.formPatterns = [
+    {
+        name: 'upload-file',
+        platforms: ['web'],
+        platformAlternative: 'the file picker is a separate app on mobile - push the file with the driver and drive that picker app-specifically, or tag the scenario @manual:M10',
+        matcher: (step) => (step.text.includes('fill') || step.text.includes('fills')) &&
+            step.elementType === 'uploader' &&
+            !!step.selectorRef &&
+            !!(step.dataRef || step.value),
+        resolver: (step, context) => {
+            const resolved = context.selectorResolver.resolveSelector(step.selectorRef, undefined, step.elementType, step.nth);
+            let fileName;
+            if (step.dataRef) {
+                fileName = context.dataResolver.resolveData(step.dataRef, context.featureName);
+            }
+            else {
+                fileName = step.value;
+            }
+            return {
+                templateName: 'upload-action',
+                data: { ...resolved, selectorRef: step.selectorRef, fileName },
+                comment: `Upload file ${fileName} via ${step.selectorRef}`,
+            };
+        },
+        priority: 12,
+    },
+    {
+        name: 'fill-input',
+        matcher: (step) => (step.text.includes('fills') || step.text.includes('fill') || step.text.includes('inputs') || step.text.includes('input')) && !!step.selectorRef && !!(step.dataRef || step.value),
+        resolver: (step, context) => {
+            const resolved = context.selectorResolver.resolveSelector(step.selectorRef, undefined, step.elementType, step.nth);
+            let value;
+            if (step.dataRef) {
+                value = context.dataResolver.resolveData(step.dataRef, context.featureName);
+            }
+            else {
+                value = step.value;
+            }
+            // Widget recipe hook: per-element `variant:` wins; else, for a date-picker element,
+            // the profile's `widgets.datepicker` (custom datepickers — readonly inputs that need
+            // open-panel choreography). Resolves to a recipe with a `fill` intent.
+            const isDatePicker = /date-?picker|calendar/.test(String(step.elementType || ''));
+            const fillVariant = resolved.variant || (isDatePicker ? context.appProfile?.widgetVariants?.['datepicker'] : undefined);
+            const fillRecipe = fillVariant ? context.appProfile?.recipes?.[fillVariant]?.['fill'] : undefined;
+            if (fillRecipe) {
+                try {
+                    const steps = (0, sungen_1.expandRecipe)(fillRecipe, {
+                        triggerCode: context.renderLocator(resolved),
+                        value,
+                    });
+                    return {
+                        templateName: 'recipe-sequence',
+                        data: { steps },
+                        comment: `Fill ${step.selectorRef} with ${step.dataRef || step.value} (${fillVariant} recipe)`,
+                    };
+                }
+                catch {
+                    // malformed recipe → generic fill below
+                }
+            }
+            // A date-picker on MOBILE with no recipe configured: refuse rather than type into it.
+            // The generic fill is `click → clearValue → setValue`, which is right for a text field and
+            // wrong for a native picker — Android opens a spinner/calendar DIALOG, so setValue lands on
+            // the trigger, selects nothing, and reports success. The step then reads as "the date was
+            // chosen" while nothing was. The recipe hook above is the supported answer (an app profile
+            // declaring `widgets.datepicker`); without one there is no honest compilation, so this
+            // follows the upload-step precedent and fails loud with the two ways forward.
+            if (isDatePicker && context.platform === 'mobile') {
+                return {
+                    templateName: 'date-picker-unsupported',
+                    data: {
+                        reason: 
+                        // No double quotes in this text: it is rendered INTO a double-quoted JS string literal,
+                        // where a stray quote would break the generated file rather than the step.
+                        `date-picker step for [${step.selectorRef}] cannot be compiled on the appium adapter: `
+                            + `a native picker is a dialog, so the generic fill would type into the trigger and select `
+                            + `nothing while reporting success. Declare the picker choreography in qa/app.yaml `
+                            + `(widgets.datepicker, a recipe with a fill intent), or tag this scenario @manual.`,
+                    },
+                    comment: `date-picker not compilable on mobile without a recipe — see qa/app.yaml widgets.datepicker`,
+                };
+            }
+            // Rich-text editors fill with pressSequentially, not .fill(). Two ways in: the selector
+            // entry (`contenteditable: true`, which the resolver translates into `inputMethod`, #712 —
+            // or `inputMethod` written out), and the Gherkin `editor` element type, which is a property
+            // of the STEP and so is read separately.
+            //
+            // The note that used to sit here said live-scan auto-detected this. Nothing in any package
+            // writes `inputMethod` — that was the same false-consumer claim #712 was filed over, and it
+            // mattered: with `contenteditable:` dead and no auto-detection, an author who hit a
+            // rich-text field had no working field to reach for at all.
+            const isEditor = resolved.inputMethod === 'pressSequentially' || step.elementType === 'editor';
+            const templateName = isEditor ? 'fill-editor-action' : 'fill-action';
+            return {
+                templateName,
+                data: { ...resolved, selectorRef: step.selectorRef, fillValue: value },
+                comment: isEditor
+                    ? `Fill rich text editor ${step.selectorRef} with ${step.dataRef || step.value}`
+                    : `Fill ${step.selectorRef} with ${step.dataRef || step.value}`,
+            };
+        },
+        priority: 10,
+    },
+    {
+        name: 'check-checkbox',
+        // `\bchecks?\b` rather than `includes('checks')`: "unchecks" CONTAINS "checks", and this
+        // pattern is declared before uncheck-checkbox at the same priority 8 — so the substring test
+        // made every `unchecks [X]` step compile to a CHECK, turning the control ON and even labelling
+        // the comment "Check". A word boundary cannot match inside "unchecks" (both neighbours are word
+        // characters), so it separates the two verbs on its own.
+        matcher: (step) => /\bchecks?\b/.test(step.text) && !!step.selectorRef,
+        resolver: (step, context) => {
+            const resolved = context.selectorResolver.resolveSelector(step.selectorRef, undefined, step.elementType, step.nth);
+            return {
+                templateName: 'check-action',
+                data: { ...resolved, selectorRef: step.selectorRef },
+                comment: `Check ${step.selectorRef}`,
+            };
+        },
+        priority: 8,
+    },
+    {
+        name: 'uncheck-checkbox',
+        // One regex covers both forms: `\buncheck\b` alone cannot match "unchecks" (the trailing "s"
+        // is a word character, so there is no boundary after "k") — which is why the substring test
+        // was here in the first place.
+        matcher: (step) => /\bunchecks?\b/.test(step.text) && !!step.selectorRef,
+        resolver: (step, context) => {
+            const resolved = context.selectorResolver.resolveSelector(step.selectorRef, undefined, step.elementType, step.nth);
+            return {
+                templateName: 'uncheck-action',
+                data: { ...resolved, selectorRef: step.selectorRef },
+                comment: `Uncheck ${step.selectorRef}`,
+            };
+        },
+        priority: 8,
+    },
+    {
+        name: 'select-dropdown',
+        matcher: (step) => (step.text.includes('selects') || step.text.match(/\bselect\b/)) &&
+            !!step.selectorRef &&
+            !!(step.dataRef || step.value),
+        resolver: (step, context) => {
+            const resolved = context.selectorResolver.resolveSelector(step.selectorRef, undefined, step.elementType, step.nth);
+            let value;
+            if (step.dataRef) {
+                value = context.dataResolver.resolveData(step.dataRef, context.featureName);
+            }
+            else {
+                value = step.value;
+            }
+            const isRadio = resolved.role === 'radio' || step.text.includes('radio');
+            const isCheckbox = resolved.role === 'checkbox' || step.text.includes('checkbox');
+            let templateName;
+            let data;
+            if (isRadio) {
+                templateName = 'radio-select-action';
+                data = { ...resolved, selectorRef: step.selectorRef, selectValue: value };
+            }
+            else if (isCheckbox) {
+                templateName = 'check-action';
+                data = { ...resolved, selectorRef: step.selectorRef };
+            }
+            else {
+                const nativeSelectRoles = ['combobox', 'listbox', 'select'];
+                // A native <select> is detected by its ARIA role, or by an explicit `variant: native`
+                // on the selector entry (lets a CSS/#id-located select opt into .selectOption()).
+                const isNativeSelect = nativeSelectRoles.includes(resolved.role) || resolved.variant === 'native';
+                // Widget variant resolution (spec §3): per-element `variant:` wins over the app
+                // profile's `widgets.select`. A matching recipe's `select` intent expands to
+                // Playwright lines at compile time; native/unknown variants keep the legacy fork.
+                const variantName = resolved.variant || context.appProfile?.widgetVariants?.['select'];
+                const recipeSteps = variantName && variantName !== 'native'
+                    ? context.appProfile?.recipes?.[variantName]?.['select']
+                    : undefined;
+                if (recipeSteps) {
+                    try {
+                        const steps = (0, sungen_1.expandRecipe)(recipeSteps, {
+                            triggerCode: context.renderLocator(resolved),
+                            value,
+                        });
+                        return {
+                            templateName: 'recipe-sequence',
+                            data: { steps },
+                            comment: `Select ${step.dataRef || step.value} in ${step.selectorRef} (${variantName} recipe)`,
+                        };
+                    }
+                    catch {
+                        // malformed recipe → generic fallback below
+                    }
+                }
+                if (isNativeSelect) {
+                    templateName = 'select-action';
+                    // Role alone cannot prove a native <select>: `combobox` is also the role of a
+                    // `<button role="combobox">` trigger (Radix/shadcn, MUI, Headless UI), where
+                    // .selectOption() throws "Element is not a <select> element". Probe the tag at
+                    // runtime unless the entry pins `variant: native`. A recipe (above) still wins.
+                    data = {
+                        ...resolved,
+                        selectorRef: step.selectorRef,
+                        selectValue: value,
+                        probeNative: resolved.variant !== 'native',
+                    };
+                }
+                else {
+                    templateName = 'click-select-action';
+                    data = { ...resolved, selectorRef: step.selectorRef, selectValue: value };
+                }
+            }
+            return {
+                templateName,
+                data,
+                comment: `Select ${step.dataRef || step.value} in ${step.selectorRef}`,
+            };
+        },
+        priority: 8,
+    },
+    {
+        name: 'clear-input',
+        matcher: (step) => (step.text.includes('clears') || step.text.match(/\bclear\b/)) && !!step.selectorRef,
+        resolver: (step, context) => {
+            const resolved = context.selectorResolver.resolveSelector(step.selectorRef, undefined, step.elementType, step.nth);
+            return {
+                templateName: 'clear-action',
+                data: { ...resolved, selectorRef: step.selectorRef },
+                comment: `Clear ${step.selectorRef}`,
+            };
+        },
+        priority: 7,
+    },
+];
+//# sourceMappingURL=form-patterns.js.map

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

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

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

@@ -0,0 +1,20 @@
+import { StepPattern } from '@sun-asterisk/sungen';
+/** A parsed click position: each axis is `px` or `%` of the element's padding box (ratio precomputed). */
+export interface ClickPosition {
+    x: number;
+    xUnit: 'px' | '%';
+    xRatio: number;
+    y: number;
+    yUnit: 'px' | '%';
+    yRatio: number;
+}
+/**
+ * Parse the `at position "<preset>"` / `at offset x=<n>px|%, y=<n>px|%` suffix. Strict on purpose:
+ * anything the grammar does not accept is an error the compiler reports — a position that is half
+ * understood would click somewhere the author did not ask for.
+ */
+export declare function parseClickPosition(text: string): ClickPosition | {
+    error: string;
+};
+export declare const interactionPatterns: StepPattern[];
+//# sourceMappingURL=interaction-patterns.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-patterns.d.ts","sourceRoot":"","sources":["../../src/patterns/interaction-patterns.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAyCnD,0GAA0G;AAC1G,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,IAAI,GAAG,GAAG,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAC7C,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,IAAI,GAAG,GAAG,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;CAC9C;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CA2BlF;AAED,eAAO,MAAM,mBAAmB,EAAE,WAAW,EAimB5C,CAAC"}