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

package/dist/app-profile-presets.d.ts

@@ -0,0 +1,12 @@
+/**
+ * App-profile presets shipped with the UI driver (spec: sungen_app_profile_spec.md §3).
+ * A preset is itself an AppProfile-shaped object that a project's `qa/app.yaml` pulls in
+ * via `extends: <name>` (or `extends: "@sungen/app-<name>"`). The project file always
+ * wins over the preset; per-element `variant:`/`scope:` in selectors.yaml wins over both.
+ *
+ * Keep presets truthful and minimal — every key must be consumed by a compiler slice
+ * (portal_roles → dialog-scope exemption; feedback.toast → name policy; widgets → the
+ * P3 recipe engine reads these when it lands).
+ */
+export declare const APP_PROFILE_PRESETS: Record<string, unknown>;
+//# sourceMappingURL=app-profile-presets.d.ts.map

package/dist/app-profile-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-profile-presets.d.ts","sourceRoot":"","sources":["../src/app-profile-presets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAyEvD,CAAC"}

package/dist/app-profile-presets.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.APP_PROFILE_PRESETS = void 0;
+/**
+ * App-profile presets shipped with the UI driver (spec: sungen_app_profile_spec.md §3).
+ * A preset is itself an AppProfile-shaped object that a project's `qa/app.yaml` pulls in
+ * via `extends: <name>` (or `extends: "@sungen/app-<name>"`). The project file always
+ * wins over the preset; per-element `variant:`/`scope:` in selectors.yaml wins over both.
+ *
+ * Keep presets truthful and minimal — every key must be consumed by a compiler slice
+ * (portal_roles → dialog-scope exemption; feedback.toast → name policy; widgets → the
+ * P3 recipe engine reads these when it lands).
+ */
+exports.APP_PROFILE_PRESETS = {
+    // Reserved base layer — ALWAYS merged first by the loader (not listed in extends).
+    // Ships the built-in widget recipes so a per-element `variant: radix-select` works
+    // even in a project with no qa/app.yaml at all.
+    builtin: {
+        recipes: {
+            // Radix UI Select (incl. shadcn/ui): options portal to body with proper ARIA roles.
+            'radix-select': {
+                select: [
+                    { click: '$trigger' },
+                    { clickText: { role: 'option', text: '$value', exact: true } },
+                ],
+                // The trigger is a <button role="combobox"> — it has no DOM `value`, so the selected
+                // option is read from its text (Radix renders it into <SelectValue> inside the button).
+                assertValue: [
+                    { expectText: { locator: '$trigger', value: '$value', exact: true } },
+                ],
+            },
+            // Ant Design Select: closed panels stay in the DOM hidden — scope every lookup
+            // to the VISIBLE dropdown panel. `waitFor: attached` first because a select that
+            // already holds a value collapses its input to ~0px (the chip covers the click
+            // target). `clickText` scrolls the target option into view before clicking, which
+            // nudges a lazily-rendered / below-the-fold option list.
+            'antd-select': {
+                select: [
+                    { waitFor: { target: '$trigger', state: 'attached' } },
+                    { click: '$trigger' },
+                    { waitFor: '.ant-select-dropdown:not(.ant-select-dropdown-hidden)' },
+                    { clickText: { within: '.ant-select-dropdown:not(.ant-select-dropdown-hidden)', text: '$value' } },
+                ],
+                // AntD keeps the chosen label in `.ant-select-selection-item` inside the trigger, not in
+                // a form value — assert the trigger's text, never toHaveValue().
+                assertValue: [
+                    { expectText: { locator: '$trigger', value: '$value', exact: true } },
+                ],
+            },
+            // Ant Design DatePicker (typed input + panel): after typing, the panel keeps
+            // blocking pointer events; a single blur dismisses it (Escape/force-click are
+            // unreliable). Enter commits the typed value first.
+            'antd-datepicker': {
+                fill: [
+                    { click: '$trigger' },
+                    { type: '$value' },
+                    { press: 'Enter' },
+                    { blur: '$trigger' },
+                ],
+            },
+        },
+    },
+    // Classic server-rendered / native-widget apps: no portals anywhere, native <select>.
+    native: {
+        app: { ui_library: 'native' },
+        layers: { portal_roles: [] },
+        widgets: { select: 'native' },
+    },
+    // Radix UI (incl. shadcn/ui): Select/Menu/Tooltip render through portals onto
+    // document.body; Toast has no accessible label by default (name derives from content).
+    radix: {
+        app: { ui_library: 'radix' },
+        layers: { portal_roles: ['option', 'listbox', 'menu', 'menuitem', 'tooltip'] },
+        feedback: { toast: { role: 'status', named_by: 'content' } },
+        widgets: { select: 'radix-select' },
+    },
+    // Ant Design: dropdown/picker panels portal to document.body (and closed panels stay
+    // in the DOM hidden — recipes must scope to the VISIBLE panel, handled in P3).
+    antd: {
+        app: { ui_library: 'antd' },
+        layers: { portal_roles: ['option', 'listbox', 'menu', 'menuitem', 'tooltip'] },
+        widgets: { select: 'antd-select' },
+    },
+};
+//# sourceMappingURL=app-profile-presets.js.map

package/dist/app-profile-presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-profile-presets.js","sourceRoot":"","sources":["../src/app-profile-presets.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;GASG;AACU,QAAA,mBAAmB,GAA4B;IAC1D,mFAAmF;IACnF,mFAAmF;IACnF,gDAAgD;IAChD,OAAO,EAAE;QACP,OAAO,EAAE;YACP,oFAAoF;YACpF,cAAc,EAAE;gBACd,MAAM,EAAE;oBACN,EAAE,KAAK,EAAE,UAAU,EAAE;oBACrB,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;iBAC/D;gBACD,qFAAqF;gBACrF,wFAAwF;gBACxF,WAAW,EAAE;oBACX,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;iBACtE;aACF;YACD,+EAA+E;YAC/E,iFAAiF;YACjF,+EAA+E;YAC/E,kFAAkF;YAClF,yDAAyD;YACzD,aAAa,EAAE;gBACb,MAAM,EAAE;oBACN,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE;oBACtD,EAAE,KAAK,EAAE,UAAU,EAAE;oBACrB,EAAE,OAAO,EAAE,uDAAuD,EAAE;oBACpE,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,uDAAuD,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;iBACnG;gBACD,yFAAyF;gBACzF,iEAAiE;gBACjE,WAAW,EAAE;oBACX,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;iBACtE;aACF;YACD,6EAA6E;YAC7E,8EAA8E;YAC9E,oDAAoD;YACpD,iBAAiB,EAAE;gBACjB,IAAI,EAAE;oBACJ,EAAE,KAAK,EAAE,UAAU,EAAE;oBACrB,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAClB,EAAE,KAAK,EAAE,OAAO,EAAE;oBAClB,EAAE,IAAI,EAAE,UAAU,EAAE;iBACrB;aACF;SACF;KACF;IAED,sFAAsF;IACtF,MAAM,EAAE;QACN,GAAG,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE;QAC7B,MAAM,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE;QAC5B,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;KAC9B;IAED,8EAA8E;IAC9E,uFAAuF;IACvF,KAAK,EAAE;QACL,GAAG,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE;QAC5B,MAAM,EAAE,EAAE,YAAY,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE;QAC9E,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE;QAC5D,OAAO,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE;KACpC;IAED,qFAAqF;IACrF,+EAA+E;IAC/E,IAAI,EAAE;QACJ,GAAG,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE;QAC3B,MAAM,EAAE,EAAE,YAAY,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE;QAC9E,OAAO,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE;KACnC;CACF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @sungen/driver-ui — Sungen UI capability (Playwright).
+ *
+ * The default/implicit capability: a scenario with no capability tag is UI. Owns the step-pattern
+ * vocabulary, the universal viewpoint catalog, the coverage-gate + assertion-depth computation, and
+ * the screen/flow discovery + context hooks. Plugs into core via the capability SPI; core discovers
+ * and calls `register()` at runtime (core never imports this package).
+ *
+ * Relocated from core in R5.4 (was `src/capabilities/builtins.ts` + the in-core pattern files).
+ * Note: the base Playwright spec templates (`specs-base`/`specs-locale`) remain in core for now —
+ * they're emitted by the core generator/initializer, not through this capability; disentangling them
+ * needs the generator abstraction (Orchestration Engine, #287).
+ */
+import type { CapabilityRegistry, ScenarioInfo, ViewpointEntry, Catalog, GateResult, DepthResult } from '@sun-asterisk/sungen';
+import { assertionDepth } from '@sun-asterisk/sungen';
+/** Inputs the UI gate computation needs (passed by the audit engine via `gateProvider`). */
+export interface UiGateInput {
+    scenarios: ScenarioInfo[];
+    viewpoints: ViewpointEntry[];
+    catalog: Catalog;
+    focus: Parameters<typeof assertionDepth>[2];
+    /** `platform: mobile` — makes `mobile-*` page types candidates (#864). */
+    isMobile?: boolean;
+    /** The viewpoint text, so a declared `page-type:` wins over keyword detection (#864). */
+    viewpointText?: string;
+}
+export interface UiGateResult {
+    gate: GateResult;
+    depth: DepthResult;
+}
+/** Register the UI capability — the default/implicit capability. */
+export declare function register(registry: CapabilityRegistry): void;
+export declare const sungenDriver: {
+    readonly capability: "ui";
+    readonly register: typeof register;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EACV,kBAAkB,EAMlB,YAAY,EACZ,cAAc,EACd,OAAO,EACP,UAAU,EACV,WAAW,EACZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAA8B,cAAc,EAAiB,MAAM,sBAAsB,CAAC;AAiBjG,4FAA4F;AAC5F,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yFAAyF;IACzF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AACD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,WAAW,CAAC;CACpB;AA2CD,oEAAoE;AACpE,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAgC3D;AAED,eAAO,MAAM,YAAY;;;CAA0C,CAAC"}

package/dist/index.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sungenDriver = void 0;
+exports.register = register;
+const sungen_1 = require("@sun-asterisk/sungen");
+const app_profile_presets_1 = require("./app-profile-presets");
+const setup_patterns_1 = require("./patterns/setup-patterns");
+const navigation_patterns_1 = require("./patterns/navigation-patterns");
+const form_patterns_1 = require("./patterns/form-patterns");
+const interaction_patterns_1 = require("./patterns/interaction-patterns");
+const assertion_patterns_1 = require("./patterns/assertion-patterns");
+const keyboard_patterns_1 = require("./patterns/keyboard-patterns");
+const scroll_patterns_1 = require("./patterns/scroll-patterns");
+const scope_patterns_1 = require("./patterns/scope-patterns");
+const table_patterns_1 = require("./patterns/table-patterns");
+const table_pagination_patterns_1 = require("./patterns/table-pagination-patterns");
+const capture_patterns_1 = require("./patterns/capture-patterns");
+const storage_patterns_1 = require("./patterns/storage-patterns");
+const focus_patterns_1 = require("./patterns/focus-patterns");
+/**
+ * UI score-bearing gate computation: viewpoint coverage + assertion depth. Wraps the shared sensor
+ * functions verbatim, so the produced gate/depth (and therefore the score) are byte-identical.
+ */
+const uiGateProvider = (input) => {
+    const gate = (0, sungen_1.viewpointGate)(input.scenarios, input.viewpoints, input.catalog, input.isMobile ?? false, input.viewpointText ?? '');
+    const depth = (0, sungen_1.assertionDepth)(input.scenarios, (0, sungen_1.dataThemesFor)(input.catalog, gate.pageType), input.focus);
+    return { gate, depth };
+};
+/**
+ * UI viewpoint gate sensor: surfaces the universal-viewpoint theme gaps the coverage gate found
+ * (a low-priority reminder — does NOT affect the score or gate verdict).
+ */
+const uiViewpointGateSensor = {
+    id: 'ui-viewpoint',
+    capability: 'ui',
+    kind: 'gate',
+    run: ({ universalGaps }) => universalGaps && universalGaps.length
+        ? [{ sensorId: 'ui-viewpoint', capability: 'ui', message: `UNIVERSAL: missing theme(s): ${universalGaps.join(', ')} (low priority reminder).`, severity: 'info' }]
+        : [],
+};
+// UI phase hooks (the pipeline consumes these incrementally; full capture-mode wiring lands later).
+const uiDiscovery = {
+    appliesTo: (t) => t.kind === 'screen' || t.kind === 'flow',
+    discover: async (target) => ({ target: { ...target, capability: 'ui' }, sources: {}, facts: {} }),
+};
+const uiContextMapper = {
+    decompose: (ctx) => {
+        const f = (ctx.facts || {});
+        const units = [];
+        for (const s of f.screens ?? [])
+            units.push({ mode: 'screen', targetSlice: s });
+        for (const fl of f.flows ?? [])
+            units.push({ mode: 'flow', targetSlice: fl });
+        if (!units.length)
+            units.push({ mode: ctx.target.kind === 'flow' ? 'flow' : 'screen', targetSlice: ctx.target });
+        return units;
+    },
+};
+/** Register the UI capability — the default/implicit capability. */
+function register(registry) {
+    registry.register({
+        id: 'ui',
+        default: true,
+        annotations: [],
+        patterns: [
+            ...setup_patterns_1.setupPatterns,
+            ...navigation_patterns_1.navigationPatterns,
+            ...form_patterns_1.formPatterns,
+            ...interaction_patterns_1.interactionPatterns,
+            ...assertion_patterns_1.assertionPatterns,
+            ...keyboard_patterns_1.keyboardPatterns,
+            ...scroll_patterns_1.scrollPatterns,
+            ...scope_patterns_1.scopePatterns,
+            ...table_patterns_1.tablePatterns,
+            ...table_pagination_patterns_1.tablePaginationPatterns,
+            ...capture_patterns_1.capturePatterns,
+            ...storage_patterns_1.storagePatterns,
+            ...focus_patterns_1.focusPatterns,
+        ],
+        discovery: uiDiscovery,
+        contextMapper: uiContextMapper,
+        viewpoints: sungen_1.loadCatalog, // UI owns the 17-pattern universal viewpoint catalog
+        gateProvider: uiGateProvider, // viewpoint coverage + depth
+        sensors: [uiViewpointGateSensor],
+        appProfilePresets: app_profile_presets_1.APP_PROFILE_PRESETS, // qa/app.yaml `extends: native|radix|antd`
+        // Trace target identity (SPI §4.5, DOS-14.5) — required on first use, so registering the UI
+        // capability never loads Playwright. A typed `require`, not `import()`: under the tsx-run CLI a
+        // dynamic import is real ESM and cannot resolve an extension-less TypeScript path.
+        traceIdentity: (input) => require('./trace-identity/playwright-identity-resolver').resolveTraceIdentities(input),
+    });
+}
+exports.sungenDriver = { capability: 'ui', register };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

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

@@ -0,0 +1,13 @@
+import { StepPattern } from '@sun-asterisk/sungen';
+/**
+ * INVARIANT — a pattern whose generated code accounts for a trailing state clause (`… is hidden`)
+ * MUST declare it in `states`. Undeclared, the clause reaches SG-E021 and the step compiles to a
+ * `throw`; over-declared, the clause is silently dropped and the assertion reads as something it is
+ * not. Determine the truth from the TEMPLATE the resolver names, never from the matcher.
+ *
+ * Deliberately NOT declared, because each really does drop the clause today: `page-assertion`
+ * (a page has no state — this was the original defect), `wait-for-page`, `table-row-exists`,
+ * `table-column-exists`, `see-with-variable`, `alert-text-assertion`, `all-contain-element`.
+ */
+export declare const assertionPatterns: StepPattern[];
+//# sourceMappingURL=assertion-patterns.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assertion-patterns.d.ts","sourceRoot":"","sources":["../../src/patterns/assertion-patterns.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAkC,MAAM,sBAAsB,CAAC;AA4CnF;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB,EAAE,WAAW,EAm6B1C,CAAC"}