@solidrt/core 0.0.72 → 0.0.74

package/AGENTS.md

@@ -116,18 +116,23 @@ tsconfig.json - the two load-bearing lines are jsx + jsxImportSource:
 ```
 
 Peer deps @solidjs/signals and @solidjs/universal must match (currently
-2.0.0-rc.13); bun resolves them from peerDependencies. On a version bump,
+2.0.0-rc.14); bun resolves them from peerDependencies. On a version bump,
 `bun install` only warns ("incorrect peer dependency") and keeps the old
-ones, and `bun update solid-js @solidjs/signals @solidjs/universal` does
-not read the pin either: it adds all three to package.json at registry
-latest (solid-js 1.x, off Solid 2.0 entirely). The recipe that works
-deletes the installed copies and leaves the lockfile alone:
-`rm -rf node_modules/solid-js node_modules/@solidjs && bun install`
-(delete any nested `node_modules/@solidjs` too, or the old copy keeps
-resolving). Removing the directories is what forces re-resolution. Do not
-delete `bun.lock` to force it: that re-resolves every unrelated dependency
-as well, and a package that floats elsewhere fails the typecheck in a way
-that reads exactly like Solid fallout.
+ones, and so does deleting their node_modules copies first (bun 1.3.14
+reinstalls them from bun.lock). `bun update solid-js @solidjs/signals
+@solidjs/universal` does not read the pin either: it adds all three to
+package.json at registry latest (solid-js 1.x, off Solid 2.0 entirely).
+The recipe that works pins all three explicitly at the new version:
+`bun add solid-js@2.0.0-rc.14 @solidjs/signals@2.0.0-rc.14 @solidjs/universal@2.0.0-rc.14`.
+It moves exactly those three lock entries and nothing else. An app `sol
+init` wrote has the three pinned in package.json already (the scaffold
+carries them, and release.yml takes the pins from core's peerDependencies
+at publish), so there the upgrade is the pins edited and `bun install`.
+Do not delete `bun.lock` or its entries to force it: bun then re-resolves
+every dependency, and a package that floats elsewhere fails the typecheck
+in a way that reads exactly like Solid fallout. A Solid bump in this repo
+moves core's peerDependencies and the scaffold's pins
+(packages/cli/src/init/scaffold/package.json) together.
 
 ## Element model (the parts that are easy to get wrong)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solidrt/core",
-  "version": "0.0.72",
+  "version": "0.0.74",
   "license": "MIT",
   "funding": "https://github.com/sponsors/wellawaretech",
   "author": "Antoine van Wel",
@@ -33,12 +33,12 @@
     "AGENTS.md"
   ],
   "devDependencies": {
-    "@solidrt/flux-types": "0.0.72",
-    "@solidrt/test": "0.0.72"
+    "@solidrt/flux-types": "0.0.74",
+    "@solidrt/test": "0.0.74"
   },
   "peerDependencies": {
-    "@solidjs/signals": "2.0.0-rc.13",
-    "@solidjs/universal": "2.0.0-rc.13",
-    "solid-js": "2.0.0-rc.13"
+    "@solidjs/signals": "2.0.0-rc.14",
+    "@solidjs/universal": "2.0.0-rc.14",
+    "solid-js": "2.0.0-rc.14"
   }
 }

package/src/microphone.ts

@@ -1,8 +1,11 @@
 // Microphone capture, reactive (SolidJS) layer. A session delivers raw mono
 // float32 samples at the requested sample rate (the device format is converted
-// by SDL); read() drains whatever was captured since the last call. Captured
-// audio buffers until read, so poll read() regularly (e.g. once per frame) while
-// open.
+// by SDL); read() drains whatever was captured since the last call, out of a
+// 10 s window the session keeps, so nothing has to poll: read when the app
+// wants samples, and a runtime module that works on the audio reads the same
+// session on its own thread, given id(). Opening the microphone IS the
+// permission request (SDL semantics): it resolves once capture runs and
+// rejects if the user denies access.
 //
 // The imperative primitive lives in the `flux:microphone` module; import
 // { open, listMicrophones } from "flux:microphone" for non-reactive use.
@@ -17,33 +20,48 @@ export type MicrophoneOptions = {
   sampleRate?: number
 }
 
-/** A live microphone with reactive lifecycle. */
+/** A live microphone as reactive accessors. */
 export type MicrophoneStream = {
-  /** Sample rate of read() samples (0 if opening failed). */
+  /** The session id to hand a runtime module that reads this microphone, undefined while opening or if opening failed. */
+  id(): number | undefined
+  /** Sample rate of read() samples, 0 while opening or if opening failed. */
   sampleRate(): number
   /** Drain the mono float32 samples captured since the last read (empty if not open). */
   read(): Float32Array
-  /** Set if opening failed. */
+  /** Set if opening failed (e.g. permission denied). */
   error(): Error | undefined
 }
 
 /**
- * Opens a microphone and owns its lifecycle: closes when the reactive owner is
- * disposed. Capture stays pull-based, so read() drains samples on demand (e.g.
- * once per frame). For imperative use, call open() from "flux:microphone".
+ * Opens a microphone and exposes it as reactive signals: id() and
+ * sampleRate() are set once capture runs, error() if the open failed or the
+ * user denied the permission. Closes automatically when the reactive owner
+ * is disposed (e.g. the component unmounts). Capture stays pull-based:
+ * read() drains the samples captured since the last read, out of the
+ * session's 10 s window. For imperative use, call open() from
+ * "flux:microphone".
  */
 export function createMicrophone(options: MicrophoneOptions = {}): MicrophoneStream {
+  let [id, setId] = createSignal<number | undefined>(undefined)
+  let [sampleRate, setSampleRate] = createSignal(0)
   let [error, setError] = createSignal<Error | undefined>(undefined)
-  let session: ReturnType<typeof open> | undefined
-  let rate = 0
-  try {
-    session = open(options)
-    rate = session.sampleRate
-  } catch (e) {
-    setError(e instanceof Error ? e : new Error(String(e)))
-  }
+  let session: Awaited<ReturnType<typeof open>> | undefined
+  let disposed = false
+
+  open(options)
+    .then((mic) => {
+      if (disposed) {
+        mic.close()
+        return
+      }
+      session = mic
+      setId(mic.id)
+      setSampleRate(mic.sampleRate)
+    })
+    .catch((e) => setError(e instanceof Error ? e : new Error(String(e))))
 
   onCleanup(() => {
+    disposed = true
     if (session) {
       session.close()
       session = undefined
@@ -51,7 +69,8 @@ export function createMicrophone(options: MicrophoneOptions = {}): MicrophoneStr
   })
 
   return {
-    sampleRate: () => rate,
+    id,
+    sampleRate,
     read: () => (session ? session.read() : new Float32Array(0)),
     error,
   }

package/src/runtime-modules.d.ts

@@ -123,11 +123,14 @@ declare module "sol:dev" {
    * (the list_debug / call_debug MCP tools). `args` arrives JSON-parsed; the
    * return value must be JSON-serializable and synchronous (an async command's
    * Promise is not awaited - the call errors). Re-registering a name replaces
-   * it; registrations reset on hot
-   * reload, so register at module init. Callable in every build, but only dev
-   * clients ever invoke commands.
+   * it; registrations reset on hot reload, so a command over app-wide state
+   * is registered at module init. Returns the unregister: a command that
+   * reads one screen's state is registered when the screen mounts and
+   * unregistered in its onCleanup, so a caller never reads a dead screen.
+   * A stale unregister (the name registered again since) removes nothing.
+   * Callable in every build, but only dev clients ever invoke commands.
    */
-  export function registerDebug(name: string, fn: (args?: any) => unknown): void
+  export function registerDebug(name: string, fn: (args?: any) => unknown): () => void
   /**
    * Report where the app is, for tooling: a string naming the current
    * location (a router's path; an app routing by hand may report its own),
@@ -248,6 +251,20 @@ declare module "sol:render" {
 // anywhere else. App time there is frame / frameRate and nothing else: no
 // frame runs unless one is asked for.
 declare module "sol:test" {
+  /**
+   * Installs an RGBA8 image (`width` x `height`, tightly packed) as the
+   * camera: every camera the app opens from now on shows it, approved at
+   * once with no device, and an open one shows it from its next frame.
+   * Throws on a size that does not match the pixels.
+   */
+  export function camera(width: number, height: number, pixels: Uint8Array): void
+  /**
+   * Installs a mono float clip at `sampleRate` Hz as the microphone: every
+   * microphone the app opens at that rate from now on holds it from the
+   * open, with no device, and an open one hears it now. Throws on a rate of
+   * 0 or one that differs from an open test microphone's.
+   */
+  export function microphone(sampleRate: number, samples: Float32Array): void
   /**
    * Runs one frame: timers due by its time fire, then frame callbacks and
    * the flush, then the draw if anything demanded one. Fulfills once the