@solidrt/core 0.0.30 → 0.0.32

package/AGENTS.md

@@ -84,7 +84,7 @@ tsconfig.json - the two load-bearing lines are jsx + jsxImportSource:
 ```
 
 Peer deps @solidjs/signals and @solidjs/universal must match (currently
-2.0.0-beta.17); bun resolves them from peerDependencies.
+2.0.0-beta.20); bun resolves them from peerDependencies.
 
 ## Element model (the parts that are easy to get wrong)
 

package/examples/README.md

@@ -34,6 +34,9 @@ for the element/prop model see `@solidrt/core/AGENTS.md`.
 - `inline-image.tsx` - bytes already in memory: `decodeImage` + `createTexture` (both synchronous) show an image with no `<Loading>` boundary. The sync counterpart to `image.tsx`.
 - `gpu-shader.tsx` - a GLSL fragment shader rendered to a texture, animated by driving its `iTime` uniform declaratively through the `<texture params={{...}}>` prop.
 
+## Sound
+- `sound.tsx` - `createSound`: decode a clip once from bytes (here a binary import), replay cheaply; `overlap` stacking vs single-voice, `playing()` signal, release on unmount. Points to `createSoundStream` for long tracks streamed from a path.
+
 ## Vector graphics
 - `svg.tsx` - `<svg src={...}>` draws a whole SVG *document string* (not HTML/JSX children); multi-color fills vs a `currentColor` icon recolored by the `color` prop. This is how to use existing icon libraries (Lucide, Heroicons, etc.) - hand their SVG source to `src`.
 

package/examples/sound.tsx

@@ -0,0 +1,48 @@
+// createSound decodes an encoded clip (Ogg/Vorbis or WAV) once, then every
+// play() starts a voice with no re-decode - cheap enough for rapid SFX. It is
+// reactive-owned: the decoded clip is released and its voices stopped when the
+// owning component unmounts, so there is nothing to clean up by hand.
+//
+// The source is a Uint8Array of encoded bytes. Here they come from a
+// `with { type: "binary" }` import (see binary-import.tsx), so the clip is
+// baked into the bundle and available synchronously. Bytes loaded at runtime
+// (flux:fs, fetch) work the same once you have them.
+//
+// overlap defaults to true: tapping faster than the clip length stacks voices
+// instead of restarting. The second sound sets overlap: false - each play()
+// cuts off the previous voice, the single-voice behavior you want for e.g. a
+// selection tick. playing() is a signal: true from play() until stop() (it
+// does not flip back when a clip ends naturally).
+//
+// For a long track (music, ambience) do not load bytes at all: pass a file
+// path to createSoundStream from the same module, which decodes from disk on
+// demand and stays off the heap. Same play()/stop()/playing() surface,
+// always single-voice.
+import { render } from "@solidrt/core"
+import { createSound } from "@solidrt/core/sound"
+import blipBytes from "./blip.wav" with { type: "binary" }
+
+function Button(props: { label: string; onTap: () => void }) {
+  return (
+    <view onPointerDown={props.onTap} padding={12} clipRadius={8}>
+      <d-rect color="#333" />
+      <text color="#e6e6e6">{props.label}</text>
+    </view>
+  )
+}
+
+function App() {
+  let blip = createSound(blipBytes, { gain: 0.8 })
+  let tick = createSound(blipBytes, { overlap: false })
+
+  return (
+    <window padding={20} gap={8} alignItems="flex-start">
+      <Button label="Blip (tap fast to stack voices)" onTap={() => blip.play()} />
+      <Button label="Tick (overlap: false, restarts)" onTap={() => tick.play()} />
+      <Button label="Stop" onTap={() => { blip.stop(); tick.stop() }} />
+      <text color="#888">{blip.playing() || tick.playing() ? "playing" : "silent"}</text>
+    </window>
+  )
+}
+
+render(() => <App />)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solidrt/core",
-  "version": "0.0.30",
+  "version": "0.0.32",
   "license": "MIT",
   "author": "Antoine van Wel",
   "type": "module",
@@ -27,11 +27,11 @@
     "colord": "^2.9.3"
   },
   "devDependencies": {
-    "@solidrt/flux-types": "0.0.30"
+    "@solidrt/flux-types": "0.0.32"
   },
   "peerDependencies": {
-    "@solidjs/signals": "2.0.0-beta.17",
-    "@solidjs/universal": "2.0.0-beta.17",
-    "solid-js": "2.0.0-beta.17"
+    "@solidjs/signals": "2.0.0-beta.20",
+    "@solidjs/universal": "2.0.0-beta.20",
+    "solid-js": "2.0.0-beta.20"
   }
 }