@solidrt/cli 0.0.52 → 0.0.54

package/AGENTS.md

@@ -11,7 +11,9 @@ bundled `flux` runtime, not on Bun. Invoke via `bunx srt <command>`.
 The dev loop against a running app is pause_watch -> edit -> reload ->
 resume_watch -> get_logs -> get_snapshot, with mute_user_input while you
 measure or test and unmute_user_input after; agents/debugging.md has the
-why of each hold. `reload` surfaces build errors but not type errors:
+why of each hold. Several clients may be attached at once: `reload` reaches
+all of them, while call_debug / send_input / get_snapshot are per client
+(debugging.md). `reload` surfaces build errors but not type errors:
 `bunx srt check` is for those.
 
 agents/ carries the depth this one leaves out; read the one that matches

package/README.md

@@ -20,7 +20,7 @@ android` (and `server`, `client`, `pack` for the rest).
 | [`srt server [file]`](src/server/docs.md) | dev server only |
 | [`srt client`](src/client/docs.md) | client only, attached to the project's dev server |
 | [`srt android`](src/android/docs.md) | install and launch the client on a connected Android device |
-| [`srt demo [n]`](src/demo/docs.md) | list the demos the installed packages ship, or run one |
+| [`srt demo [n]`](src/demo/docs.md) | list the demos the CLI ships, or run one |
 | [`srt console`](src/console/docs.md) | start the dev console: the dev servers on this machine and their clients |
 | [`srt check [file]`](src/check/docs.md) | build and typecheck, writing nothing |
 | [`srt bundle [file]`](src/bundle/docs.md) | transpile to JS or bytecode (dist/bundle/) |

package/agents/debugging.md

@@ -156,16 +156,26 @@ when exactly one client is connected.
   window root.
 - `/texture?id=<textureId>` - same shape and options as `/snapshot`, at the
   texture's native size (a scene or shader target behind a `<texture>` leaf).
-- `/gpu?label=<text>` - the GPU resource inventory; `label` keeps only the
-  resources created with exactly that label (ids change on reload, labels
-  do not).
+- `/gpu?label=<text>&draw=<id>` - the GPU resource inventory; `label` keeps
+  only the resources created with exactly that label (ids change on reload,
+  labels do not). A draw target's entries report uniforms wider than a vec4
+  (matrices) as their length, `"[16]"`; `draw` names the one entry (ids are
+  per target, so pair it with `label`) reported in full.
 - `/buffer?id=<bufferId>&offset=<n>&length=<n>&as=<f32|u16|u8>` - vertex
   buffer contents (default f32; reads cap at 64 KiB).
 - `/stats?window=<ms>` - the performance statistics. POST
   `/stats?active=true|false` switches the on-screen stats overlay instead
   (the `set_stats_overlay` tool): one client with `&client=<id>`, every
   client (and the setting new clients join with) without; `/clients`
-  reports each client's `stats`.
+  reports each client's `stats`. `frames` counts the frames that changed
+  the picture: tree rebuilds, plus GPU content changes presented without
+  one (a layer write, a shader param, an upload - a sprite or shader app
+  rebuilds nothing, every frame of it is one of these).
+  `fps` is the refresh rate presented at: when motion looks wrong and `fps`
+  looks fine, `frames` is the number to read - a picture that only changes
+  26 times a second shows 26 there, and the stutter is the app's update
+  cadence, not the engine's. `frames: 0` means the picture did not change
+  at all in the window.
 - `/debug` - the app's registered debug commands; POST
   `/debug?name=<cmd>` with a JSON body as its args to call one.
 - POST `/input` with `{ "events": [...] }` - synthetic input through the
@@ -259,6 +269,21 @@ The loop is the same as over MCP: `/reload`, then `/logs?since=`, then
   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.
+- A fixed-timestep simulation on that clamped dt still drifts: no panel
+  presents at exactly its nominal rate (a "60 Hz" panel measured 60.3) and
+  the paced tick tracks the real cadence, so a 16.667 ms step against a
+  16.59 ms average dt comes up one step short every few seconds - one frame
+  runs no step (freeze), the next runs two (jump), and frame jitter
+  scatters which frame it lands on, so it reads as random stutter. The
+  runtime hands every callback the refresh rate,
+  `onFrame((tick, frame, rate) => ...)` (SDL's nominal Hz): when the step is
+  within a few percent of `1000 / rate`, run whole steps per frame
+  (`Math.round(dt / STEP_MS)`, clamped to [0, cap]) so the world rides the
+  refresh; only accumulate (`acc += dt; while (acc >= STEP_MS) ...`) when
+  the display is genuinely off-rate (50, 120, 144 Hz), or interpolate the
+  render by `acc / STEP_MS` if the game does not snap to whole pixels. It
+  is invisible in a five-second look and survives every renderer
+  optimisation; measure it with a steps-per-frame histogram, not by eye.
 - 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