@solidrt/cli 0.0.35 → 0.0.37

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solidrt/cli",
-  "version": "0.0.35",
+  "version": "0.0.37",
   "license": "MIT",
   "author": "Antoine van Wel",
   "type": "module",
@@ -28,17 +28,17 @@
     "zod": "^4.4.3"
   },
   "optionalDependencies": {
-    "@solidrt/darwin-arm64": "0.0.35",
-    "@solidrt/linux-arm64-gnu": "0.0.35",
-    "@solidrt/linux-x64-gnu": "0.0.35",
-    "@solidrt/win32-x64-msvc": "0.0.35"
+    "@solidrt/darwin-arm64": "0.0.37",
+    "@solidrt/linux-arm64-gnu": "0.0.37",
+    "@solidrt/linux-x64-gnu": "0.0.37",
+    "@solidrt/win32-x64-msvc": "0.0.37"
   },
   "peerDependencies": {
-    "@solidrt/core": "0.0.35",
+    "@solidrt/core": "0.0.37",
     "typescript": "^7"
   },
   "devDependencies": {
-    "@solidrt/flux-types": "0.0.35",
+    "@solidrt/flux-types": "0.0.37",
     "@types/bun": "latest"
   }
 }

package/scaffold/AGENTS.md

@@ -300,12 +300,15 @@ The tools need a running app: if list_clients is empty, ask the user to start
   Math.min(dt, cap) lets it through, and one bad frame can corrupt anything
   integrated from dt (positions fly off, accumulators go so negative they
   never recover). Math.max(0, Math.min(dt, cap)) costs nothing.
-- Frames are demand-gated: JS frame callbacks only run when the previous
-  frame changed something (input, signal write, GPU upload). An app whose
-  onFrame returns early without side effects on its first frame never gets
-  a second one - self-running animation (game clocks, shader-driven
-  effects) must make one state change at startup to prime the loop; after
-  that its own writes keep it awake.
+- A registered onFrame is a standing request, not demand-gated: it re-requests
+  the next frame every time it runs, so the runtime keeps calling it - and
+  presents - every frame at the refresh rate until you deregister it (fps stays
+  at the refresh rate on an idle screen; that is the 60fps burn called out in
+  the performance notes above). The upside is that a self-running loop - a game
+  clock, a shader driver, a stepped VM doing silent CPU work with no console
+  output - keeps advancing on its own: it does NOT stall when the body changes
+  nothing and needs no startup "prime" write. Deregister onFrame (return its
+  cleanup, or let onCleanup fire) whenever there is nothing left to advance.
 - Layout is incremental: a change re-solves only the dirty path, and clean
   subtrees answer from a per-node cache, so long lists no longer cap layout
   (a thousand-node tree relays out in well under a millisecond). If layoutMs

package/scaffold/package.json

@@ -9,12 +9,12 @@
     "android": "srt client --android"
   },
   "dependencies": {
-    "@solidrt/core": "0.0.35",
-    "@solidrt/components": "0.0.35"
+    "@solidrt/core": "0.0.37",
+    "@solidrt/components": "0.0.37"
   },
   "devDependencies": {
-    "@solidrt/cli": "0.0.35",
-    "@solidrt/flux-types": "0.0.35",
+    "@solidrt/cli": "0.0.37",
+    "@solidrt/flux-types": "0.0.37",
     "typescript": "^7"
   }
 }

package/scaffold/templates/gallery/index.tsx

@@ -325,15 +325,6 @@ function App() {
               </View>
             </Card>
 
-            <Card title="Text input" layout={{ width: 360 }}>
-              <TextInput
-                value={name()}
-                onInput={setName}
-                placeholder="Your name"
-                layout={{ width: 320 }}
-              />
-            </Card>
-
             <Card title="Switch and checkbox" layout={{ width: 360 }}>
               <Row label="Notifications">
                 <Switch value={notify()} onChange={setNotify} />
@@ -459,6 +450,15 @@ function App() {
               </View>
             </Card>
 
+            <Card title="Text input" layout={{ width: 360 }}>
+              <TextInput
+                value={name()}
+                onInput={setName}
+                placeholder="Your name"
+                layout={{ width: 320 }}
+              />
+            </Card>
+
             <Card title="QR code" layout={{ width: 360 }}>
               <Text muted>Encodes your name, or a link if the field is empty.</Text>
               <View layout={{ alignItems: "center" }}>

package/src/args.ts

@@ -28,13 +28,23 @@ export let { values, positionals } = parseArgs({
   allowPositionals: true,
 })
 
-// Storage flags for a locally spawned client. The data root defaults to the
-// project-local .srt-data so dev state stays with the project; it is passed
-// absolute because the client chdirs into its app sandbox at startup. Remote
-// clients resolve their own local root instead (see lattice/src/storage.rs).
+// Storage flags for a locally spawned client, forwarded only when given: with
+// no --data-root the client resolves its platform pref path (see
+// lattice/src/storage.rs); --client <N> selects the client<N>/ tree under
+// either root. An explicit root is passed absolute because the client chdirs
+// into its app sandbox at startup.
 export function clientStorageArgs(): string[] {
-  let args = ["--data-root", resolve(values["data-root"] ?? ".srt-data")]
-  if (values.client) args.push("--client", values.client)
+  let args: string[] = []
+  let root = values["data-root"]
+  if (root) args.push("--data-root", resolve(root))
+  let client = values.client
+  if (client !== undefined) {
+    if (!/^\d+$/.test(client)) {
+      console.error(`Invalid --client value "${client}": expected a non-negative integer`)
+      process.exit(1)
+    }
+    args.push("--client", client)
+  }
   return args
 }
 
@@ -112,8 +122,8 @@ run/server options:
 run/client options:
       --size <WxH>       Window size (default: 1280x720)
       --stats            Show the debug stats overlay (FPS, memory, frame timings)
-      --data-root <dir>  Client data root (default: ./.srt-data)
-      --client <name>    Client name: its own data dir under the data root (default: "default")
+      --data-root <dir>  Client data root (default: the platform pref path)
+      --client <N>       Client number: its own data tree under the data root (default: 0)
 
 client options:
       --server <host[:port]>  Connect to a dev server at this address (default port: 34884)

package/src/pack-folder.ts

@@ -6,6 +6,7 @@ import {
   loadAppIdentity,
   projectDirFor,
   RUNTIME_VERSION,
+  SOLIDRT_VERSION,
   type ManifestFont,
 } from "./project"
 import { resolvePackFonts } from "./fonts"
@@ -70,6 +71,7 @@ export function buildPackFolder(entry: string, bytecode: Buffer): PackFolder {
     org: identity.org,
     displayName: identity.displayName,
     runtimeVersion: RUNTIME_VERSION,
+    solidrtVersion: SOLIDRT_VERSION,
     bundle: { path: "bundle.bin", sha256: hashHex(bytecode), size: bytecode.length },
     ...(assets.length ? { assets } : {}),
     ...(fonts.length ? { fonts } : {}),

package/src/project.ts

@@ -61,6 +61,13 @@ function checkField(value: string, what: string) {
 // derivation question is settled (see plan).
 export const RUNTIME_VERSION = 1
 
+// The manifest's solidrtVersion: provenance, not a compat gate like
+// runtimeVersion - the CLI release that built the version. Published CLIs
+// carry the real version in their package.json; the in-repo 0.0.0
+// placeholder stamps "unknown".
+let pkgVersion = JSON.parse(readFileSync(join(import.meta.dir, "..", "package.json"), "utf8")).version
+export const SOLIDRT_VERSION: string = pkgVersion === "0.0.0" ? "unknown" : pkgVersion
+
 export function buildManifest(code: string, entry: string): string {
   let identity = loadAppIdentity(entry)
   let sha256 = new Bun.CryptoHasher("sha256").update(code).digest("hex")
@@ -68,6 +75,7 @@ export function buildManifest(code: string, entry: string): string {
   return JSON.stringify({
     appId: identity.appId,
     runtimeVersion: RUNTIME_VERSION,
+    solidrtVersion: SOLIDRT_VERSION,
     bundle: { path: "bundle.js", sha256, size: Buffer.byteLength(code, "utf8") },
     ...(assets.length ? { assets } : {}),
     ...(fonts.length ? { fonts } : {}),