@ripplo/testing 0.7.0 → 0.7.2

package/DSL.md

@@ -160,19 +160,19 @@ export const renameTask = test("Rename a task"); // STUB — no body; gated unti
 
 Each returns a step; chain `.expect(...predicates)` to assert after it runs.
 
-| action     | signature                      | example                                   |
-| ---------- | ------------------------------ | ----------------------------------------- |
-| `goto`     | `` goto`/path/${handle.id}` `` | `` goto`/projects/${p.id}` ``             |
-| `click`    | `click(locator)`               | `click(button("Save"))`                   |
-| `dblclick` | `dblclick(locator)`            | `dblclick(testId\`row-${r.id}\`)`         |
-| `fill`     | `fill(locator, value)`         | `fill(textbox("Name"), "Acme")`           |
-| `clear`    | `clear(locator)`               | `clear(textbox("Name"))`                  |
-| `select`   | `select(locator, value)`       | `select(role("combobox", "Plan"), "pro")` |
-| `check`    | `check(locator)`               | `check(role("checkbox", "Agree"))`        |
-| `uncheck`  | `uncheck(locator)`             | `uncheck(role("checkbox", "Agree"))`      |
-| `hover`    | `hover(locator)`               | `hover(button("More"))`                   |
-| `upload`   | `upload(locator, files)`       | `upload(testId\`avatar\`, ["face.png"])`  |
-| `press`    | `press(key, locator?)`         | `press("Enter", textbox("Search"))`       |
+| action     | signature                      | example                                  |
+| ---------- | ------------------------------ | ---------------------------------------- |
+| `goto`     | `` goto`/path/${handle.id}` `` | `` goto`/projects/${p.id}` ``            |
+| `click`    | `click(locator)`               | `click(button("Save"))`                  |
+| `dblclick` | `dblclick(locator)`            | `dblclick(testId\`row-${r.id}\`)`        |
+| `fill`     | `fill(locator, value)`         | `fill(textbox("Name"), "Acme")`          |
+| `clear`    | `clear(locator)`               | `clear(textbox("Name"))`                 |
+| `select`   | `select(locator, value)`       | `select(combobox("Plan"), "pro")`        |
+| `check`    | `check(locator)`               | `check(checkbox("Agree"))`               |
+| `uncheck`  | `uncheck(locator)`             | `uncheck(checkbox("Agree"))`             |
+| `hover`    | `hover(locator)`               | `hover(button("More"))`                  |
+| `upload`   | `upload(locator, files)`       | `upload(testId\`avatar\`, ["face.png"])` |
+| `press`    | `press(key, locator?)`         | `press("Enter", textbox("Search"))`      |
 
 `fill`/`select`/`value`/`text` accept a literal string or a `Binding<string>` (e.g. `arbitrary(...)` or a handle field). `goto`/`testId` are template literals — interpolate handle ids directly.
 
@@ -194,13 +194,15 @@ fill(textbox("Title"), title)
 
 Named locators — `(name, ...bindings)`, accessible name **required**:
 
-`button` `cell` `checkbox` `combobox` `dialog` `heading` `img` `link` `listitem` `menuitem` `option` `radio` `row` `searchbox` `tab` `textbox`
+`alertdialog` `button` `cell` `checkbox` `columnheader` `combobox` `dialog` `heading` `img` `link` `listitem` `menuitem` `option` `radio` `row` `searchbox` `slider` `spinbutton` `switchControl` (role `switch` — `switch` is a JS keyword) `tab` `textbox` `treeitem`
 
 Container/landmark locators — `(name?, ...bindings)`, name optional (often unique per page):
 
-`alert` `banner` `complementary` `contentinfo` `form` `list` `main` `menu` `navigation` `region` `status` `table` `tablist`
+`alert` `banner` `complementary` `contentinfo` `form` `grid` `group` `list` `main` `menu` `navigation` `progressbar` `radiogroup` `region` `status` `table` `tablist` `tabpanel` `toolbar`
 
-Anything else: `role("switch", name)` — every ARIA role works through `role()`.
+Anything else: `role("menubar", name)` — every ARIA role works through `role()`. Prefer the named sugar above when one exists.
+
+Radix/shadcn gotchas: toggles render role `switch` (use `switchControl`, not `checkbox`); confirm dialogs render role `alertdialog` (use `alertdialog`, not `dialog`).
 
 Names are matched **exactly** — no `contains`/regex. If the app lacks an accessible name, add one to the app rather than falling back to `testId`. Container rows/dialogs usually need an explicit `aria-label` to be scopable — add it to the app.
 

package/dist/{engine-BT7hUouB.d.ts → engine-BfvzXgLg.d.ts}

@@ -279,8 +279,6 @@ type Predicate = {
     readonly key: Record<string, WhereValue>;
     readonly kind: "state";
     readonly wait: Budget | undefined;
-} | {
-    readonly kind: "jsErrors";
 } | {
     readonly kind: "not";
     readonly predicate: Predicate;
@@ -382,7 +380,6 @@ declare const testSchema: z.ZodObject<{
     }, z.core.$strip>>>;
     exclusive: z.ZodDefault<z.ZodArray<z.ZodString>>;
     intent: z.ZodString;
-    invariants: z.ZodDefault<z.ZodArray<z.ZodType<Predicate, unknown, z.core.$ZodTypeInternals<Predicate, unknown>>>>;
     maybe: z.ZodDefault<z.ZodArray<z.ZodObject<{
         as: z.ZodString;
         entity: z.ZodString;
@@ -544,7 +541,6 @@ declare const lockfileSchema: z.ZodObject<{
         }, z.core.$strip>>>;
         exclusive: z.ZodDefault<z.ZodArray<z.ZodString>>;
         intent: z.ZodString;
-        invariants: z.ZodDefault<z.ZodArray<z.ZodType<Predicate, unknown, z.core.$ZodTypeInternals<Predicate, unknown>>>>;
         maybe: z.ZodDefault<z.ZodArray<z.ZodObject<{
             as: z.ZodString;
             entity: z.ZodString;

package/dist/express.d.ts

@@ -1,5 +1,5 @@
 import { Router } from 'express';
-import { E as Engine } from './engine-BT7hUouB.js';
+import { E as Engine } from './engine-BfvzXgLg.js';
 import 'neverthrow';
 import 'zod';
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as Capture, S as Step, P as PredicateInput, L as Locator, B as Binding, A as AnyBinding, G as GivenItem, T as Test, a as EntityList, b as SingletonList, c as Lockfile, U as UniqueNames, d as BrowserSingleton, e as LeafPredicate, f as Primitive, F as FieldHandle, D as DeclSource, R as Row, g as Primitive$1, h as SingletonDef } from './engine-BT7hUouB.js';
-export { i as AbsenceHandle, j as CLIENT_MOUNT_KEY, k as CLIENT_SEED_KEY, l as ConditionInput, m as ConditionPredicate, n as CountCondition, o as DuplicateEntityName, E as Engine, p as EngineError, q as EngineImpls, r as EngineRead, s as EntityDef, t as EntityHandle, u as EntityImpl, v as FieldOptions, w as Fields, H as Handle, x as Selection, y as SingletonConfig, z as SingletonImpl, I as SingletonValue, W as WhenClause, J as WithinMatcher, K as and, M as changed, N as count, O as createEngine, Q as disabled, V as enabled, X as entity, Y as field, Z as focused, _ as id, $ as key, a0 as not, a1 as singleton, a2 as text, a3 as v, a4 as value, a5 as visible, a6 as when, a7 as within } from './engine-BT7hUouB.js';
+import { C as Capture, S as Step, P as PredicateInput, L as Locator, B as Binding, A as AnyBinding, G as GivenItem, T as Test, a as EntityList, b as SingletonList, c as Lockfile, U as UniqueNames, d as BrowserSingleton, e as LeafPredicate, f as Primitive, F as FieldHandle, D as DeclSource, R as Row, g as Primitive$1, h as SingletonDef } from './engine-BfvzXgLg.js';
+export { i as AbsenceHandle, j as CLIENT_MOUNT_KEY, k as CLIENT_SEED_KEY, l as ConditionInput, m as ConditionPredicate, n as CountCondition, o as DuplicateEntityName, E as Engine, p as EngineError, q as EngineImpls, r as EngineRead, s as EntityDef, t as EntityHandle, u as EntityImpl, v as FieldOptions, w as Fields, H as Handle, x as Selection, y as SingletonConfig, z as SingletonImpl, I as SingletonValue, W as WhenClause, J as WithinMatcher, K as and, M as changed, N as count, O as createEngine, Q as disabled, V as enabled, X as entity, Y as field, Z as focused, _ as id, $ as key, a0 as not, a1 as singleton, a2 as text, a3 as v, a4 as value, a5 as visible, a6 as when, a7 as within } from './engine-BfvzXgLg.js';
 import 'neverthrow';
 import 'zod';
 
@@ -49,9 +49,11 @@ type ContainerLocator = (name?: LocatorName, ...bindings: ReadonlyArray<AnyBindi
 declare function role(roleName: string, name?: LocatorName, ...bindings: ReadonlyArray<AnyBinding>): Locator;
 declare function inside(scope: Locator, target: Locator): Locator;
 declare function testId(value: string | TemplateStringsArray, ...bindings: ReadonlyArray<AnyBinding>): Locator;
+declare const alertdialog: NamedLocator;
 declare const button: NamedLocator;
 declare const cell: NamedLocator;
 declare const checkbox: NamedLocator;
+declare const columnheader: NamedLocator;
 declare const combobox: NamedLocator;
 declare const dialog: NamedLocator;
 declare const heading: NamedLocator;
@@ -63,21 +65,31 @@ declare const option: NamedLocator;
 declare const radio: NamedLocator;
 declare const row: NamedLocator;
 declare const searchbox: NamedLocator;
+declare const slider: NamedLocator;
+declare const spinbutton: NamedLocator;
+declare const switchControl: NamedLocator;
 declare const tab: NamedLocator;
 declare const textbox: NamedLocator;
+declare const treeitem: NamedLocator;
 declare const alert: ContainerLocator;
 declare const banner: ContainerLocator;
 declare const complementary: ContainerLocator;
 declare const contentinfo: ContainerLocator;
 declare const form: ContainerLocator;
+declare const grid: ContainerLocator;
+declare const group: ContainerLocator;
 declare const list: ContainerLocator;
 declare const main: ContainerLocator;
 declare const menu: ContainerLocator;
 declare const navigation: ContainerLocator;
+declare const progressbar: ContainerLocator;
+declare const radiogroup: ContainerLocator;
 declare const region: ContainerLocator;
 declare const status: ContainerLocator;
 declare const table: ContainerLocator;
 declare const tablist: ContainerLocator;
+declare const tabpanel: ContainerLocator;
+declare const toolbar: ContainerLocator;
 
 interface BrowserSingletonDef<Name extends BrowserSingleton> {
     readonly name: Name;
@@ -119,4 +131,4 @@ interface MountClientEngineOptions {
 }
 declare function mountClientEngine<R extends DeclSource>(ripplo: R, impls: ClientEngineImpls<R>, { enabled }: MountClientEngineOptions): void;
 
-export { AnyBinding, Binding, type BrowserSingletonDef, type ClientEngineImpls, type ClientEngineMount, type ClientEntityImpl, type ClientSingletonImpl, type ContainerLocator, EntityList, FieldHandle, GivenItem, type LocatorName, type MountClientEngineOptions, type NamedLocator, Primitive, type Ripplo, type RipploTest, SingletonDef, SingletonList, type TestBody, UniqueNames, alert, arbitrary, banner, button, cell, check, checkbox, clear, click, combobox, complementary, contentinfo, createClientEngine, createRipplo, dblclick, dialog, fill, form, goto, heading, hover, img, inside, link, list, listitem, main, menu, menuitem, mountClientEngine, navigation, option, press, radio, region, role, row, searchbox, select, status, tab, table, tablist, test, testId, textbox, title, uncheck, upload, url, viewport };
+export { AnyBinding, Binding, type BrowserSingletonDef, type ClientEngineImpls, type ClientEngineMount, type ClientEntityImpl, type ClientSingletonImpl, type ContainerLocator, EntityList, FieldHandle, GivenItem, type LocatorName, type MountClientEngineOptions, type NamedLocator, Primitive, type Ripplo, type RipploTest, SingletonDef, SingletonList, type TestBody, UniqueNames, alert, alertdialog, arbitrary, banner, button, cell, check, checkbox, clear, click, columnheader, combobox, complementary, contentinfo, createClientEngine, createRipplo, dblclick, dialog, fill, form, goto, grid, group, heading, hover, img, inside, link, list, listitem, main, menu, menuitem, mountClientEngine, navigation, option, press, progressbar, radio, radiogroup, region, role, row, searchbox, select, slider, spinbutton, status, switchControl, tab, table, tablist, tabpanel, test, testId, textbox, title, toolbar, treeitem, uncheck, upload, url, viewport };

package/dist/index.js

@@ -412,9 +412,11 @@ function testId(value2, ...bindings) {
   }
   return { by: "testId", value: stringValueFromTemplate(value2, bindings) };
 }
+var alertdialog = named("alertdialog");
 var button = named("button");
 var cell = named("cell");
 var checkbox = named("checkbox");
+var columnheader = named("columnheader");
 var combobox = named("combobox");
 var dialog = named("dialog");
 var heading = named("heading");
@@ -426,21 +428,31 @@ var option = named("option");
 var radio = named("radio");
 var row = named("row");
 var searchbox = named("searchbox");
+var slider = named("slider");
+var spinbutton = named("spinbutton");
+var switchControl = named("switch");
 var tab = named("tab");
 var textbox = named("textbox");
+var treeitem = named("treeitem");
 var alert = container("alert");
 var banner = container("banner");
 var complementary = container("complementary");
 var contentinfo = container("contentinfo");
 var form = container("form");
+var grid = container("grid");
+var group = container("group");
 var list = container("list");
 var main = container("main");
 var menu = container("menu");
 var navigation = container("navigation");
+var progressbar = container("progressbar");
+var radiogroup = container("radiogroup");
 var region = container("region");
 var status = container("status");
 var table = container("table");
 var tablist = container("tablist");
+var tabpanel = container("tabpanel");
+var toolbar = container("toolbar");
 function named(roleName) {
   return (name, ...bindings) => role(roleName, name, ...bindings);
 }
@@ -1711,6 +1723,7 @@ export {
   CLIENT_MOUNT_KEY,
   CLIENT_SEED_KEY,
   alert,
+  alertdialog,
   and,
   arbitrary,
   banner,
@@ -1721,6 +1734,7 @@ export {
   checkbox,
   clear,
   click,
+  columnheader,
   combobox,
   complementary,
   contentinfo,
@@ -1738,6 +1752,8 @@ export {
   focused,
   form,
   goto,
+  grid,
+  group,
   heading,
   hover,
   id,
@@ -1755,22 +1771,30 @@ export {
   not,
   option,
   press,
+  progressbar,
   radio,
+  radiogroup,
   region,
   role,
   row,
   searchbox,
   select,
   singleton,
+  slider,
+  spinbutton,
   status,
+  switchControl,
   tab,
   table,
   tablist,
+  tabpanel,
   test,
   testId,
   text,
   textbox,
   title,
+  toolbar,
+  treeitem,
   uncheck,
   upload,
   url,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ripplo/testing",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "Typed test DSL for Ripplo — declare entities and user flows, compile to a lockfile",
   "homepage": "https://ripplo.ai",
   "license": "SEE LICENSE IN LICENSE.md",
@@ -43,8 +43,8 @@
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "vitest": "^4.1.4",
-    "@ripplo/eslint-config": "0.0.0",
-    "@ripplo/spec": "^0.0.0"
+    "@ripplo/spec": "^0.0.0",
+    "@ripplo/eslint-config": "0.0.0"
   },
   "scripts": {
     "build": "tsup",