@solidrt/flux-types 0.0.65 → 0.0.66

package/gui/rendertree.d.ts

@@ -1,7 +1,7 @@
 // The render-tree bridge (gui-enabled runtime only): the low-level surface the
 // renderer drives to build and mutate the native tree - create/insert/delete
 // nodes, write properties, query layout, measure text. Displaying the built
-// tree is the runner's concern ("srt:render" in lattice), not part of this
+// tree is the runner's concern ("sol:render" in lattice), not part of this
 // module; requestFrame here only schedules a future frame.
 
 declare module "flux:rendertree" {

package/gui/spatial.d.ts

@@ -155,7 +155,7 @@ declare module "flux:spatial" {
    * left alone, so rewriting the whole array to move one component never
    * restarts the others (a held write's target counts, so re-sending it
    * does not restart its delay). Each settled component fires one
-   * "spatialTransitionEnd" engine event (srt:events), payload
+   * "spatialTransitionEnd" engine event (sol:events), payload
    * `{ node, component: NodeComponent }` - on a live node; a leaving
    * node's settles feed its free instead (exitNode).
    */
@@ -646,7 +646,7 @@ declare module "flux:spatial" {
    * positive fades in, negative out; past 0 the player is removed).
    * When a player finishes or is removed without finishing (faded out,
    * clip or target destroyed), the "spatialClipEnd" engine event
-   * (srt:events) fires with payload { player, reason: "finished" |
+   * (sol:events) fires with payload { player, reason: "finished" |
    * "dropped" }, before the same frame's handlers.
    */
   export function createPlayer(clip: ClipId, targets: NodeId[], speed: number, loop: boolean, weight: number, fade: number): PlayerId
@@ -661,7 +661,7 @@ declare module "flux:spatial" {
    * the player's time each advance, and its travel since the previous
    * advance (continuous across a loop wrap, weighted by the player's
    * weight) is reported as one "spatialRootMotion" engine event
-   * (srt:events) per advance, payload { player, x, y, z, yaw }, before
+   * (sol:events) per advance, payload { player, x, y, z, yaw }, before
    * the frame's handlers. The translation is given in the root's CURRENT
    * facing (the clip's own turn so far undone), i.e. the character's
    * local frame. `rotation`, a rotation channel of the same clip (the

package/index.d.ts

@@ -32,7 +32,7 @@
 // microphone/gpu are flux:* modules like the rest; requestAnimationFrame stays a
 // global (web-standard name). flux:rendertree is the render-tree bridge the
 // renderer drives; displaying the built tree (renderFrame) is the runner's
-// concern (srt:render in lattice), not part of flux.
+// concern (sol:render in lattice), not part of flux.
 /// <reference path="./gui/rendertree.d.ts" />
 /// <reference path="./gui/camera.d.ts" />
 /// <reference path="./gui/microphone.d.ts" />

package/modules/isolate.d.ts

@@ -70,7 +70,7 @@ declare module "flux:isolate" {
   /**
    * A handle on an isolate module: a `"use isolate"` module in a SolidRT
    * project (id = its path relative to the source root, without extension),
-   * or `isolates/<id>.bin`/`.js` next to the entry under standalone flux. Each property is
+   * or `isolates/<id>.fluxbc`/`.js` next to the entry under standalone flux. Each property is
    * an async function that runs the export of that name in a second runtime
    * on its own thread (own heap, own event loop, the non-gui `flux:*`
    * modules). Arguments and results are copied ({@link Sendable}).

package/modules/test.d.ts

@@ -1,6 +1,6 @@
 /**
  * Tests for a flux program: `test` registers one and `expect` asserts
- * inside it. A test file is run by a test host, `srt test <file>` (the
+ * inside it. A test file is run by a test host, `sol test <file>` (the
  * `flux` binary's `--test` mode underneath); imported anywhere else the
  * module throws, since nothing would run the tests.
  *
@@ -28,7 +28,7 @@
  * `Math.random()`, are the same on every run and do not depend on the
  * tests that ran before. It is the engine's generator in kind and
  * resolution, only its start is fixed. An isolate the test spawns is
- * seeded too, with a seed derived from the test's. `srt test --seed <n>`
+ * seeded too, with a seed derived from the test's. `sol test --seed <n>`
  * runs the tests on another sequence.
  *
  * A test that does not finish within 5 seconds of real time fails as timed
@@ -88,6 +88,15 @@ declare module "flux:test" {
     /** The same matchers, inverted: each throws when it does hold. */
     not: Matchers
 
+    /**
+     * For a promise: the same matchers on its rejection reason, each
+     * awaiting the promise first and returning a promise to await in turn.
+     * A promise that fulfills fails the matcher, with or without `not`.
+     * `toThrow` sees the reason as the thrown value, so a rejection reads
+     * like a throw: `await expect(p).rejects.toThrow("no such file")`.
+     */
+    rejects: RejectionMatchers
+
     /** The same value, as `Object.is` sees it: `NaN` is `NaN`, `0` is not `-0`, and two equal objects are not the same. */
     toBe(expected: unknown): void
 
@@ -139,4 +148,11 @@ declare module "flux:test" {
     toBeGreaterThan(expected: number | bigint): void
     toBeGreaterThanOrEqual(expected: number | bigint): void
   }
+
+  /** The matchers of `expect(promise).rejects`: `Matchers`, each returning a promise. */
+  export type RejectionMatchers = {
+    [K in Exclude<keyof Matchers, "rejects">]: Matchers[K] extends (...args: infer A) => void
+      ? (...args: A) => Promise<void>
+      : RejectionMatchers
+  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solidrt/flux-types",
-  "version": "0.0.65",
+  "version": "0.0.66",
   "license": "MIT",
   "funding": "https://github.com/sponsors/wellawaretech",
   "author": "Antoine van Wel",