@solidrt/test 0.0.71 → 0.0.72

package/AGENTS.md

@@ -37,7 +37,8 @@ agents/testing.md.
   `.record` (the `/tree` record).
 - Input is the real pipeline: `app.tap(locator)`, `app.drag(from, to, {
   durationMs })`, `app.key("Enter")`, `app.type("text")` (to the focused
-  node), `app.input([...])` for raw events in the `send_input` shape. A tap
+  node), `app.back()` (the user's back, into the `onBack` stack),
+  `app.input([...])` for raw events in the `send_input` shape. A tap
   on a node that something covers at its center throws and names the
   cover; a point (`{ x, y }`) lands on whatever is there. Each verb returns
   after the frame its last event landed in, so the tree is current.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solidrt/test",
-  "version": "0.0.71",
+  "version": "0.0.72",
   "license": "MIT",
   "funding": "https://github.com/sponsors/wellawaretech",
   "author": "Antoine van Wel",
@@ -14,9 +14,9 @@
     "AGENTS.md"
   ],
   "devDependencies": {
-    "@solidrt/flux-types": "0.0.71"
+    "@solidrt/flux-types": "0.0.72"
   },
   "peerDependencies": {
-    "@solidrt/core": "0.0.71"
+    "@solidrt/core": "0.0.72"
   }
 }

package/src/index.ts

@@ -145,7 +145,7 @@ export interface Pixels {
 export type RefLocator = Locator & ((node: { id: number }) => void)
 
 /** One event in the control API's `/input` shape. */
-export type InputEvent = Record<string, unknown> & { type: "pointer" | "key" | "wheel" | "text" | "gamepad" }
+export type InputEvent = Record<string, unknown> & { type: "pointer" | "key" | "wheel" | "text" | "gamepad" | "back" }
 
 export interface PointerOptions {
   /** "mouse" (the default) or "touch". */
@@ -164,7 +164,11 @@ export interface TestApp {
    * Mounts `ui` and returns a locator for the window it is in. `ui` is what
    * an app hands `render`: its `<window>`, or any content, which is then
    * put in a window of its own. Once per test (a test is one app). The
-   * first frame is built when this returns; no app time has passed.
+   * first frame is built when this returns; no app time has passed, and
+   * no animation clock is stamped yet: a transition written before the
+   * first `frame` or `advance` starts at the first frame that runs (the
+   * startup anchor), not at `time` 0, so a test timing a track against
+   * `time` runs one frame first and writes after it.
    * `ui` runs as a component body, the owner of what it creates: a
    * pointer feed, an input map, a GPU buffer or a scene is created inside
    * it, never at the top of the test.
@@ -276,6 +280,12 @@ export interface TestApp {
   key(key: string, options?: { holdMs?: number; shift?: boolean; ctrl?: boolean; alt?: boolean; meta?: boolean }): Promise<void>
   /** Text as an input method commits it, to the focused node. */
   type(text: string): Promise<void>
+  /**
+   * The user's back intent, the event the Android button, a pad's back
+   * button and the desktop dev chord become: into the `onBack` stack,
+   * never a key.
+   */
+  back(): Promise<void>
   /**
    * Events in the control API's `/input` shape, as `send_input` takes them.
    * `delayMs` and `holdMs` are app time: frames run to cover them. One
@@ -543,6 +553,9 @@ let app: TestApp = {
   type(text) {
     return app.input([{ type: "text", text }])
   },
+  back() {
+    return app.input([{ type: "back" }])
+  },
   async input(events) {
     let waits = inputPlan(JSON.stringify(events))
     for (let i = 0; i < waits.length; i++) {