@aethervtt/shard-testing 0.0.1 → 0.2.0

package/dist/index.d.ts

@@ -28,12 +28,31 @@ export declare class Game {
         release: (name: string) => void;
         /** Press for one frame. */
         press: (name: string) => Promise<void>;
+        /**
+         * Plays pointer gestures in CSS pixels (`{ drag }`, `{ pinch }`, `{ wheel }`, `{ tap }`,
+         * `{ wait }`) and steps until they're done (0060): camera controls and object drags.
+         */
+        gesture: (...gestures: Json[]) => Promise<void>;
     };
     /**
      * Sounds started, stopped, and dropped (audio plugin) from frame `since`, as `audio.log` returns
      * them: `{ frame, event, clip, entity, path, bus, position, gain, pan, reason }`.
      */
     audioLog(since?: number): Promise<Json[]>;
+    /** Audio inspection and cursor-aware traces; assertions remain ordinary test assertions. */
+    readonly audio: {
+        describe: () => Promise<Json>;
+        events: (cursor?: number) => Promise<Json>;
+        music: (cursor?: number) => Promise<Json>;
+        mix: () => Promise<Json>;
+        log: (cursor?: number) => Promise<{
+            entries: Json[];
+            oldestCursor: number;
+            nextCursor: number;
+            truncated: boolean;
+        }>;
+        parameter: (instance: number, name: string, value: string | number) => Promise<Json>;
+    };
     /** UI (ui plugin): read the HUD as data and press buttons by path, without pixel coordinates. */
     readonly ui: {
         /** `ui.describe`: every tree with rects, text, widget state, focus, and anchors. */
@@ -83,7 +102,10 @@ export declare class Game {
     private inject;
     private resolve;
 }
-/** A gameplay test. Each test gets a fresh game; the GPU is shared across a file. */
+/**
+ * A gameplay test. Each test gets a fresh game; the GPU is shared across a file. `timeout` is
+ * scaled like `timeout()` from test-env (5x in CI, which renders on a software GPU).
+ */
 export declare function test(name: string, fn: (ctx: {
     game: Game;
 }) => Promise<void> | void, timeout?: number): void;

package/dist/index.js

@@ -1,6 +1,7 @@
 import { mkdir, writeFile } from "node:fs/promises";
 import { join } from "node:path";
 import { findComponent, ShardError } from "@aethervtt/shard-core";
+import { timeout as scaled } from "@aethervtt/shard-core/test-env";
 import { createNodeGpuContext } from "@aethervtt/shard-gpu/node";
 import { openProject } from "@aethervtt/shard-node";
 import { findEntityByPath } from "@aethervtt/shard-scene";
@@ -68,6 +69,14 @@ class Game {
       this.inject(name, true);
       await this.step(1);
       this.inject(name, false);
+    },
+    /**
+     * Plays pointer gestures in CSS pixels (`{ drag }`, `{ pinch }`, `{ wheel }`, `{ tap }`,
+     * `{ wait }`) and steps until they're done (0060): camera controls and object drags.
+     */
+    gesture: async (...gestures) => {
+      const { frames } = await this.call("input.simulate", { gestures });
+      await this.step(frames);
     }
   };
   /**
@@ -77,6 +86,15 @@ class Game {
   async audioLog(since = 0) {
     return (await this.call("audio.log", { since })).entries;
   }
+  /** Audio inspection and cursor-aware traces; assertions remain ordinary test assertions. */
+  audio = {
+    describe: async () => this.call("audio.describe"),
+    events: async (cursor = 0) => this.call("audio.events.inspect", { cursor }),
+    music: async (cursor = 0) => this.call("audio.music.inspect", { cursor }),
+    mix: async () => this.call("audio.mix.inspect"),
+    log: async (cursor = 0) => this.call("audio.log", { cursor }),
+    parameter: async (instance, name, value) => this.call("audio.parameter.set", { instance, name, value })
+  };
   /** UI (ui plugin): read the HUD as data and press buttons by path, without pixel coordinates. */
   ui = {
     /** `ui.describe`: every tree with rects, text, widget state, focus, and anchors. */
@@ -194,7 +212,7 @@ function test(name, fn, timeout = 3e4) {
       open.push(project);
       await fn({ game: new Game(project) });
     },
-    timeout
+    scaled(timeout)
   );
 }
 test.skip = (name, _fn) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aethervtt/shard-testing",
-  "version": "0.0.1",
+  "version": "0.2.0",
   "license": "MIT",
   "type": "module",
   "sideEffects": false,
@@ -16,13 +16,13 @@
     "README.md"
   ],
   "dependencies": {
-    "@aethervtt/shard-core": "0.0.1",
-    "@aethervtt/shard-gpu": "0.0.1",
-    "@aethervtt/shard-node": "0.0.1",
-    "@aethervtt/shard-protocol": "0.0.1",
-    "@aethervtt/shard-runtime": "0.0.1",
+    "@aethervtt/shard-core": "0.2.0",
+    "@aethervtt/shard-gpu": "0.2.0",
+    "@aethervtt/shard-node": "0.2.0",
+    "@aethervtt/shard-protocol": "0.2.0",
+    "@aethervtt/shard-runtime": "0.2.0",
     "vitest": "^5.0.1",
-    "@aethervtt/shard-scene": "0.0.1"
+    "@aethervtt/shard-scene": "0.2.0"
   },
   "repository": {
     "type": "git",
@@ -34,6 +34,6 @@
     "provenance": true
   },
   "shard": {
-    "buildSha": "d6c5c6aef4675575c878b02cf2c8f738b4190229"
+    "buildSha": "32c22a3944ed23f5d1baa90bf7cc9fae724f5fd8"
   }
 }