@abide/abide 0.44.0 → 0.45.0

package/AGENTS.md

@@ -81,10 +81,12 @@ For `bun test`, add `preload = ["@abide/abide/preload"]` under `[test]` in
 The handler receives `InferOutput<inputSchema>` (or the bare arg type when
 schemaless), reads `request()` / `cookies()` for request scope, and returns a
 `json` / `jsonl` / `sse` / `error` / `redirect` helper Response or a raw
-`Response`. `opts`: `inputSchema`, `outputSchema` (OpenAPI 200 + MCP
+`Response`. A named, client-branchable error is raised by RETURNING an
+`error.typed(name, status, schema?)` constructor — the RPC infers its typed-error
+surface from whichever constructors the handler returns, so there is no `errors:`
+option. `opts`: `inputSchema`, `outputSchema` (OpenAPI 200 + MCP
 `outputSchema`), `filesSchema` (multipart File parts; send a `FormData`),
-`errors` (declared error constructors handed to the handler), `clients`
-(`{ browser, mcp, cli }`), `crossOrigin` (exempt a mutating RPC from the
+`clients` (`{ browser, mcp, cli }`), `crossOrigin` (exempt a mutating RPC from the
 same-origin CSRF gate), `timeout` (ms handler deadline → 504 every surface),
 `maxBodySize` (received-byte ceiling → 413), and — mutating helpers only —
 `outbox` (durable replay; `GET(fn, { outbox })` is a compile error). Query args
@@ -130,7 +132,7 @@ at the top, then bare calls.
 
 | Form | Meaning |
 | --- | --- |
-| `let x = state(v, transform?)` | Writable cell; assign `x = …` to update |
+| `let x = state(v, transform?)` | Writable state; assign `x = …` to update |
 | `const d = computed(() => …)` | Read-only derived |
 | `const l = linked(fn, transform?)` | Writable, re-seeds when `fn`'s deps change |
 | `effect(() => { … })` | Reaction re-run on dep change; client-only (SSR strips it) |
@@ -196,7 +198,7 @@ the fallback form. No named slots.
 - `abide/server/json` — JSON `Response` with `Cache-Control: no-store` default; same shape as `Response.json`.
 - `abide/server/jsonl` — wraps an `AsyncIterable<Frame>` as a JSON Lines (`application/jsonl`) streaming Response.
 - `abide/server/sse` — wraps an `AsyncIterable<Frame>` as Server-Sent Events (`text/event-stream`).
-- `abide/server/error` — plain-text error Response; `error(status, message?)`, message defaults to the status reason phrase.
+- `abide/server/error` — error Responses. `error(status, message?)` = plain-text (message defaults to the status reason phrase). `error.typed(name, status, schema?)` = a reusable named typed-error constructor; returning it from a handler IS the error (serializes `{ $abideError, data }` at `status`), and the RPC infers `rpc.isError(e, name)` narrowing (`.kind` + typed `.data`) from the returned constructors — no `errors:` option.
 - `abide/server/redirect` — redirect Response; accepts relative URLs, defaults to 302.
 
 ### Request scope — @documentation request-scope
@@ -273,7 +275,7 @@ the fallback form. No named slots.
 
 ### Reactive state — @documentation reactive-state
 
-- `abide/ui/scope` — `scope(address?)` resolves the current lexical scope (or `scope('/')` the tree root); the sole reactive entry, carrying `state`/`computed`/`linked`/`effect` + data/context/capability methods.
+- `abide/ui/scope` — `scope()` resolves the current lexical scope; the sole reactive entry, carrying `state`/`computed`/`linked`/`effect` + data/context/capability methods (walk to the tree root via the handle's `.root()`).
 
 ### Templating — @documentation templating
 

package/CHANGELOG.md

@@ -1,5 +1,69 @@
 # abide
 
+## 0.45.0
+
+### Minor Changes
+
+- 3fadd43: defer large {#await cache()} with inert hydration + lazy seed ([`2b87f5d`](https://github.com/briancray/abide/commit/2b87f5de270d91c9ffc9f5467051a221e6f9c204))
+- 7aa4032: thread durable outbox bit into RemoteFunction return type ([`4fa34b4`](https://github.com/briancray/abide/commit/4fa34b43fdac7a0aaa91a965f1aca488e1378a27))
+- 3fadd43: Breaking: collapse rpc handler generics into one inferred function type ([`f22bfd3`](https://github.com/briancray/abide/commit/f22bfd3f189214209ff3debb2b4916bd3b3680c7))
+- 6d82974: BREAKING: `CacheOptions.tags` (and the `cache.invalidate` / `pending` `{ tags }` selector) now accepts only a `string[]`, not `string | string[]`. Wrap a single tag in an array:
+
+    ```ts
+    cache(getOrder, { tags: ['orders'] })({ id })
+    cache.invalidate({ tags: ['orders'] })
+    ```
+
+    A bare-string tag previously auto-wrapped; the array-only form removes the `typeof` branch and the silent-splat foot-gun (a JS caller passing a multi-char string got it iterated into per-character tags).
+
+- ce61cd0: Add `error.typed(name, status, schema?)` — declare a single, reusable typed-error constructor. Returning it from a handler IS the error (it serializes a `{ $abideError, data }` body at `status`), and the rpc reads the constructor's branded return type to expose the error on the client's `rpc.isError(caught, 'name')` (narrowing `.kind` and typed `.data`). Compose by returning whichever constructors you want — no set, no registration:
+
+    ```ts
+    const outOfStock = error.typed('outOfStock', 409, z.object({ sku: z.string() }))
+    export const buy = POST(({ sku }) => (inStock(sku) ? json(place(sku)) : outOfStock({ sku })))
+    // buy.isError(e, 'outOfStock') → e.data: { sku: string }, inferred from the body
+    ```
+
+    The rpc's typed-error surface is now **inferred from the handler's return type** — the errors a handler returns are the errors it can raise — so there is no `errors:` rpc option and no `ctx.errors` handler param. A typed error you only ever `throw` (rather than `return`) narrows kind-only, like a plain `error()`.
+
+    BREAKING: removes the rpc `errors:` option and the handler's `{ errors }` second argument. Replace `POST((args, { errors }) => error(errors.x(data)), { inputSchema, errors: { x: { status, data } } })` with a module-scope `const x = error.typed('x', status, schema)` constructor returned from the handler: `POST((args) => x(data), { inputSchema })`.
+
+### Patch Changes
+
+- 7aa4032: percent-decode client route params to match SSR ([`1034dfb`](https://github.com/briancray/abide/commit/1034dfb3d451be117da7416f5f0bae611f82e3df))
+- 7aa4032: drop in-flight await settle after owner teardown ([`109e56e`](https://github.com/briancray/abide/commit/109e56e52851382a53a259d614671d0fb0e1fd08))
+- 7aa4032: make effect flush non-reentrant and pin effect teardown scope ([`28c9e79`](https://github.com/briancray/abide/commit/28c9e79b4e7a1905483c469182a58d7df8388c0e))
+- 7aa4032: drop scope('/') address param ([`3b3400d`](https://github.com/briancray/abide/commit/3b3400d5c87f151701da927d66912c2715e511fe))
+- 3fadd43: remove cell from the public Scope surface ([`408bd25`](https://github.com/briancray/abide/commit/408bd25864f67fc88da531793b6233806f7ab3a4))
+- 7aa4032: isolate SSR ambient scope per request ([`52d3e1c`](https://github.com/briancray/abide/commit/52d3e1cfc941df5d044fb2e6e6477bbf85c96ed4))
+- 7aa4032: extract shared generationGuard for async teardown invalidation ([`5775422`](https://github.com/briancray/abide/commit/5775422acb2625cb4bb864c0b9f77611e1a530a2))
+- 7aa4032: dispose scope children in reverse (LIFO) ([`9f56ea2`](https://github.com/briancray/abide/commit/9f56ea20dacb6ae28161b3a604dbc94d2f69ca98))
+- 18d9eb1: fix hydration null-deref when a reactive text binding first renders an empty string — the server emits no text node, so the client now synthesizes its own node at the claim cursor instead of dereferencing null in the bind effect
+
+## 0.44.1
+
+### Patch Changes
+
+- 767b415: 02-zod-plugin-memo ([`0e00b21`](https://github.com/briancray/abide/commit/0e00b217f99352a7d3def4841172c5bff287bc5c))
+- 767b415: 06-wakeSubtree-prefix-index ([`23ab920`](https://github.com/briancray/abide/commit/23ab9202fd0cb41e01811e78b76eac2843c9cf8f))
+- 767b415: 09-when-via-switch ([`48f8d50`](https://github.com/briancray/abide/commit/48f8d5063cf74060004ad38691f584abcff0cab2))
+- 767b415: 08-dts-codegen ([`5170542`](https://github.com/briancray/abide/commit/51705426e55a700140cc7bc38f7e21f30759fce3))
+- 767b415: 03-socket-publish-gate ([`56fae49`](https://github.com/briancray/abide/commit/56fae49bf393fdfb3aa35cecc618a39443354ce4))
+- 767b415: 10-cli-tokenizer ([`5e305c1`](https://github.com/briancray/abide/commit/5e305c154efd5f77d0a57e78831b72a30b4d9155))
+- 767b415: 14-resolver-slot-factory-JUDGMENT ([`6e00809`](https://github.com/briancray/abide/commit/6e00809c343e24599d54b2304a50a9cecd90619f))
+- 767b415: catch top-level await in a .abide <script> during abide check ([`76ff64e`](https://github.com/briancray/abide/commit/76ff64e9fb9ffed108ae2fde53f2ded2bf3a0abe))
+- 767b415: 12-warm-clone-PARTIAL ([`8e58e0b`](https://github.com/briancray/abide/commit/8e58e0b2c1891174cc809797f949f01619529b89))
+- 767b415: 05-compiler-double-pass ([`9216dae`](https://github.com/briancray/abide/commit/9216dae4c26e27fce49f39b116bd8b1dcf1dd226))
+- 767b415: 04-lsp-shadow-cache ([`9f9f5fc`](https://github.com/briancray/abide/commit/9f9f5fc84792204259d591fa4aff261b2a19c46d))
+- 767b415: 13-dev-rebuild-scoping-JUDGMENT ([`b5a1d49`](https://github.com/briancray/abide/commit/b5a1d49e6607a8fcf37efe03e9fe6f6b2c31ea45))
+- 767b415: gate skeleton fragment-staging on a connected parent ([`c9380ee`](https://github.com/briancray/abide/commit/c9380eebdd9f6773ccffd446665b1acbc78b1123))
+- 767b415: 07-debug-gate ([`c96466e`](https://github.com/briancray/abide/commit/c96466e73ea1f521d728b11aac44262530c3b09c))
+- 767b415: rename paint's escape var to avoid shadowing the global ([`caf1322`](https://github.com/briancray/abide/commit/caf1322adc6598bc6ea32e0ba9047ba768b6f5e1))
+- 767b415: reflow generateBuild attr-kind union to biome's multiline form ([`f9b3669`](https://github.com/briancray/abide/commit/f9b36690e4add2c955abb8f0127a9af9d513be53))
+- 767b415: 01-bugs-B1-B2 ([`fa8659d`](https://github.com/briancray/abide/commit/fa8659d276265c0fbb4f7ca0740fc74702f00168))
+- 767b415: address code-review findings ([`fb02df5`](https://github.com/briancray/abide/commit/fb02df58c924d7206fce35874cc80309949c9e59))
+- 767b415: 11-server-log-micro ([`fb689bc`](https://github.com/briancray/abide/commit/fb689bc05bee9ba127ddf206e925e3a9e04841fd))
+
 ## 0.44.0
 
 ### Minor Changes

package/README.md

@@ -1,26 +1,24 @@
 # abide
 
 **One typed declaration fans out to HTTP, a CLI, an MCP tool, and an OpenAPI
-operation — and the same callable runs on the server and in the browser.**
+spec — on a single Bun runtime.**
 
-abide is an isomorphic, multimodal HTTP framework for a single Bun runtime: you
-declare a typed RPC once and it becomes a browser fetch, an in-process SSR call,
-an MCP tool, a CLI subcommand, and an OpenAPI operation; the bundler swaps the
-runtime per side so the same name behaves the same on both. Built for humans
-*and* machines.
+abide is a type-safe isomorphic framework: you declare an RPC, a socket, and a
+`.abide` component once, and the bundler swaps the runtime per side — the same
+callable is a direct in-process call on the server and a typed `fetch` in the
+browser. Built for humans *and* machines: every schema-carrying RPC is
+simultaneously a browser endpoint, a CLI subcommand, an MCP tool, and an
+OpenAPI operation.
 
-- One direct dependency (TypeScript). One runtime (Bun ≥ 1.3).
-- `.abide` single-file components render on the server and hydrate in place.
+One direct dependency (TypeScript). One runtime (Bun ≥ 1.3.0).
 
 ## Quick start
 
 ```sh
-bunx abide scaffold my-app   # scaffolds, installs, and starts the dev server
-```
-
-Or clone the kitchen-sink example:
+# Scaffold a project, install it, and start the dev server (in a TTY).
+bunx abide scaffold my-app
 
-```sh
+# Or explore the full feature set in the kitchen-sink example.
 git clone https://github.com/briancray/abide
 cd abide/examples/kitchen-sink
 bun install
@@ -29,10 +27,11 @@ bun run dev
 
 ## RPCs
 
-An RPC is one export under `src/server/rpc/`. The file path is the URL; the
-export's schema validates the args and projects the MCP tool, the CLI flags, and
-the OpenAPI operation. The schema contract is Standard Schema — pass a zod,
-valibot, or arktype schema directly, unadapted.
+An RPC is one export per file under `src/server/rpc/`. The file path is the URL
+(under `/rpc/`), the import (`GET`/`POST`/`PUT`/`PATCH`/`DELETE`/`HEAD`) picks
+the HTTP method, and an optional `inputSchema` — any Standard Schema (zod,
+valibot, arktype, unadapted) — validates the args and projects the MCP tool, the
+CLI flags, and the OpenAPI operation.
 
 ```ts
 // src/server/rpc/getMessages.ts
@@ -40,213 +39,204 @@ import { GET } from '@abide/abide/server/GET'
 import { json } from '@abide/abide/server/json'
 import { z } from 'zod'
 
+const rooms: Record<string, { id: string; text: string }[]> = {}
+
+// GET /rpc/getMessages?room=lobby
 export const getMessages = GET(
-  async ({ channel }) => json(await db.recentMessages(channel)),
-  { inputSchema: z.object({ channel: z.coerce.string() }) },
+    (args: { room: string }) => json(rooms[args.room] ?? []),
+    { inputSchema: z.object({ room: z.coerce.string() }) },
+)
+```
+
+```ts
+// src/server/rpc/postMessage.ts
+import { POST } from '@abide/abide/server/POST'
+import { json } from '@abide/abide/server/json'
+import { error } from '@abide/abide/server/error'
+import { z } from 'zod'
+
+const rateLimited = error.typed('rateLimited', 429)
+
+// A mutating method never auto-exposes to MCP — opt in explicitly.
+export const postMessage = POST(
+    (args: { room: string; text: string }) => {
+        if (args.text.length > 500) return rateLimited()
+        return json({ ok: true })
+    },
+    { inputSchema: z.object({ room: z.string(), text: z.string() }), clients: { mcp: true } },
 )
 ```
 
-One declaration, every surface:
+One declaration, five surfaces:
 
 ```text
-                  export const getMessages = GET(fn, { inputSchema })
-                                     │
-       ┌───────────────┬─────────────┼─────────────┬───────────────┐
-       ▼               ▼             ▼             ▼               ▼
-   SSR call       browser fetch   MCP tool     CLI command     OpenAPI op
- cache(fn)()     typed proxy    (read-only)   getMessages …  /openapi.json
- (in-process)    (swapped fn())
+              export const getMessages = GET(fn, { inputSchema })
+                                  │
+      ┌────────────┬─────────────┼─────────────┬────────────┐
+      ▼            ▼             ▼             ▼            ▼
+ cache(fn)()   typed fetch    MCP tool     CLI subcmd   OpenAPI op
+  (SSR, warm    (browser,    (read-only   (any schema-  (/openapi
+   hydration)    swapped)     GET/HEAD)    carrying)     .json)
 ```
 
-A schema unlocks the CLI for any method and auto-exposes read-only methods
-(`GET`/`HEAD`) as MCP tools; a mutating method (`POST`/`PUT`/`PATCH`/`DELETE`)
-never auto-exposes to MCP — it needs an explicit `clients: { mcp: true }`.
-Consume the RPC four ways: `cache(getMessages)({ channel })` in-process during
-SSR, the swapped `fetch` proxy in the browser, `getMessages.raw(args)` for the
-underlying `Response`, and `getMessages.stream(args)` for a frame iterable.
+A schema unlocks the CLI for any RPC and MCP for read-only methods (`GET`/`HEAD`);
+a mutating method (`POST`/`PUT`/`PATCH`/`DELETE`) reaches MCP only with an
+explicit `clients: { mcp: true }`. Consume an RPC four ways: `cache(fn)()`
+in-process (warm SSR + hydration), the swapped `fetch` in the browser,
+`fn.raw(args)` for the underlying `Response`, and `fn.stream(args)` to iterate
+`jsonl`/`sse` frames.
 
-> Query args travel as strings — validate with `z.coerce.*`. A per-RPC
-> `timeout` (504 on every surface) is distinct from the client-side
+> Query args travel as strings — coerce them (`z.coerce.number()`). A per-RPC
+> `timeout` returns 504 on every surface; it is distinct from the client-wide
 > `ABIDE_CLIENT_TIMEOUT`.
 
 ## Sockets
 
 A socket is one broadcast topic per file under `src/server/sockets/`. A
-`Socket<T>` is an isomorphic `AsyncIterable<T>` — `for await (const m of chat)`
-is the live stream — and every socket multiplexes onto one WebSocket at
-`/__abide/sockets`.
+`Socket<T>` is an isomorphic `AsyncIterable<T>` — iterate for the live stream,
+`.tail(count)` to seed from the retained tail. Every socket multiplexes onto one
+WebSocket at `/__abide/sockets`; the server publishes in-process and fans out,
+the browser proxy sends a `pub` frame.
 
 ```ts
-// src/server/sockets/chat.ts
+// src/server/sockets/messages.ts
 import { socket } from '@abide/abide/server/socket'
 import { z } from 'zod'
 
-export const chat = socket({
-  schema: z.object({ id: z.string(), author: z.string(), text: z.string() }),
-  tail: 50,        // retain the last 50 frames for replay
-  ttl: 60_000,     // evict retained frames older than 60s
+export const messages = socket({
+    schema: z.object({ room: z.string(), text: z.string() }),
+    tail: 50, // retain the last 50 frames for late joiners / reconnects
+    ttl: 60_000, // evict retained frames older than 60s before replay
 })
 ```
 
-Each socket also has an HTTP face at `/__abide/sockets/<name>`: `GET` returns the
-retained tail, `POST` publishes a frame (gated by `clientPublish`).
+The HTTP face lives at `/__abide/sockets/<name>`: `GET` returns the retained
+tail, `POST` publishes (gated by `clientPublish`).
 
 ## Components
 
-A `.abide` component renders on the server and hydrates in the browser. The page
-below imports the RPC and the socket above and exercises the whole template
-grammar. Reactive state is reached through `scope()` — the documented default is
-to destructure it once at the top of the `<script>` and call the primitives bare.
+A `.abide` component is a single file: a leading `<script>` (module imports plus
+reactive setup), the template, and an optional component-scoped `<style>`. This
+page imports the RPC from §RPCs and the socket from §Sockets and drives them
+through the whole template grammar.
+
+Reactive state is reached only through `scope()`. The authoring default is the
+destructure-once idiom — pull the primitives off `scope()` at the top of the
+`<script>`, then call them bare. `computed` is read-only; `effect` is client-only
+(stripped from SSR). A bare `state`/`computed`/`linked`/`effect` with no
+`scope()` destructure is a compile error.
 
 ```html
 <script>
-  import { cache } from '@abide/abide/shared/cache'
-  import { tail } from '@abide/abide/ui/tail'
-  import { html } from '@abide/abide/ui/html'
-  import { getMessages } from '$server/rpc/getMessages'
-  import { sendMessage } from '$server/rpc/sendMessage'
-  import { chat } from '$server/sockets/chat'
-  import Card from '$ui/Card.abide'
-  import Message from '$ui/Message.abide'
-  import Risky from '$ui/Risky.abide'
-
-  // props() is the ambient prop reader — no import; destructure with defaults + rest
-  const { channel = 'general', ...rest } = props()
-
-  // destructure-once: reach every reactive primitive through scope(), then call bare
-  const { state, computed, linked, effect } = scope()
-
-  let draft = state('')
-  let count = state(0)
-  let muted = state(false)
-  let topic = state('all')
-  const doubled = computed(() => count * 2)
-  const banner = linked(() => `# ${channel}`)
-
-  // live reads off the §3 socket: latest frame, plus a window of the last 20
-  const latest = tail(chat)
-  const recent = tail(chat, { last: 20 })
-
-  // effect runs client-only (stripped from SSR)
-  effect(() => {
-    document.title = `${channel} (${count})`
-  })
-
-  // an event handler calling a mutating RPC
-  async function send() {
-    await sendMessage({ channel, text: draft })
+import { cache } from '@abide/abide/shared/cache'
+import { tail } from '@abide/abide/ui/tail'
+import { html } from '@abide/abide/ui/html'
+import { getMessages } from '$server/rpc/getMessages.ts'
+import { postMessage } from '$server/rpc/postMessage.ts'
+import { messages } from '$server/sockets/messages.ts'
+import MessageCard from '$ui/MessageCard.abide'
+
+const { state, computed, linked, effect } = scope()
+const { room = 'lobby' } = props()
+
+let draft = state('')
+let showRaw = state(false)
+let filter = state('all')
+const trimmed = computed(() => draft.trim())
+const outgoing = linked(() => room + ': ' + trimmed)
+const banner = html`<strong>#${room}</strong>`
+
+// client-only reaction — never runs during SSR
+effect(() => console.log('draft is now', draft))
+
+// the derived two-way binding target, read down / written up
+const get = () => outgoing
+const set = (value) => (draft = value)
+// mutating RPC from an event handler
+const send = () => {
+    postMessage({ room, text: trimmed })
     draft = ''
-    count = count + 1
-  }
-
-  // the derived two-way binding's accessors
-  const get = () => count
-  const set = (value) => (count = Number(value))
-
-  // an attachment: runs against the element at mount
-  const focus = (node) => node.focus()
+}
 </script>
 
-<main {...rest}>
-  <h1 class:muted={muted} style:opacity={muted ? 0.5 : 1}>{banner}</h1>
-  <p>seen {count} — doubled {doubled}</p>
-  <p>{html`<em>latest:</em> ${latest?.text ?? '—'}`}</p>
-
-  <form onsubmit={send}>
-    <input bind:value={draft} attach={focus} placeholder="message" />
-    <label><input type="checkbox" bind:checked={muted} /> mute</label>
-    <label><input type="radio" bind:group={topic} value="all" /> all</label>
-    <label><input type="radio" bind:group={topic} value="mine" /> mine</label>
-    <input type="range" min="0" max="50" bind:value={{ get, set }} />
-    <button>send</button>
-  </form>
-
-  {#snippet row(message)}
-    <li>{html`<strong>${message.author}</strong>`}: {message.text}</li>
-  {/snippet}
-
-  {#if recent.length === 0}
-    <p>No messages yet.</p>
-  {:else if muted}
-    <p>Muted — {recent.length} hidden.</p>
-    <script>
-      // a nested script scoped to this branch — its own scope(), no imports
-      const { computed } = scope()
-      const note = computed(() => `${recent.length} while muted`)
-    </script>
-    <small>{note}</small>
-    <style>
-      small { color: gray; }
-    </style>
-  {:else}
-    <ul>
-      {#for message, i of recent by message.id}
-        <Card title={`#${i}`}>{row(message)}</Card>
-      {/for}
-    </ul>
-  {/if}
-
-  <h2>filter</h2>
-  {#switch topic}
-    {:case 'all'}<p>showing everything</p>
-    {:case 'mine'}<p>showing mine</p>
-    {:default}<p>unknown filter</p>
-  {/switch}
-
-  <h2>history</h2>
-  {#await cache(getMessages)({ channel })}
-    <p>loading…</p>
-  {:then list}
-    <ul>
-      {#for entry of list by entry.id}
-        <Message {...entry} />
-      {/for}
-    </ul>
-  {:catch error}
-    <p>failed: {error.message}</p>
-  {:finally}
-    <hr />
-  {/await}
-
-  <h2>live</h2>
-  <ul>
-    {#for await frame of chat}
-      <li>{frame.text}</li>
+{#snippet chip(label)}
+    <span class="rounded bg-slate-100 px-2 text-xs">{label}</span>
+{/snippet}
+
+<section class="p-4" attach={(node) => node.focus()} {...{ id: 'chat' }}>
+    <h1 class:live={showRaw} style:opacity={showRaw ? 1 : 0.6}>{banner}</h1>
+
+    {#await cache(getMessages)({ room })}
+        <p>loading…</p>
+    {:then history}
+        {#if history.length > 0}
+            {#for message, i of history by message.id}
+                <MessageCard {...message}>
+                    {chip(i)}
+                    <p>{message.text}</p>
+                </MessageCard>
+            {/for}
+        {:else if showRaw}
+            <p>no history yet</p>
+        {:else}
+            <p>say hello</p>
+        {/if}
+    {:catch error}
+        <p>failed to load: {error.message}</p>
+    {:finally}
+        <hr />
+    {/await}
+
+    {#for await frame of messages.tail(10)}
+        <p class="live-frame">{frame.text}</p>
     {/for}
-  </ul>
 
-  {#try}
-    <Risky />
-  {:catch error}
-    <p>widget crashed: {error.message}</p>
-  {:finally}
-    <span>boundary settled</span>
-  {/try}
-</main>
+    {#switch filter}
+        {:case 'all'}<p>showing all rooms</p>
+        {:case 'mine'}<p>showing my rooms</p>
+        {:default}<p>—</p>
+    {/switch}
+
+    {#try}
+        {#if showRaw}
+            <script>const { computed } = scope()
+const label = computed(() => 'raw view active')</script>
+            <pre>{label}</pre>
+        {/if}
+    {:catch error}
+        <p>render error: {error.message}</p>
+    {:finally}
+        <small>rendered</small>
+    {/try}
+
+    <form onsubmit={send}>
+        <input bind:value={draft} placeholder="message" />
+        <label><input type="checkbox" bind:checked={showRaw} /> raw</label>
+        <label><input type="radio" bind:group={filter} value="all" /> all</label>
+        <label><input type="radio" bind:group={filter} value="mine" /> mine</label>
+        <input bind:value={{ get, set }} />
+        <button type="submit">send</button>
+    </form>
+</section>
 
 <style>
-  main { font-family: system-ui; }
-  .muted { text-decoration: line-through; }
+    .live { color: teal; }
 </style>
 ```
 
-A capitalised tag is a child component; the content nested inside it renders
-where the child calls `{children()}` (the `<slot>` element was removed — there
-are no named slots). `{#if children}…{:else}…{/if}` is the fallback form:
+Content nested inside a capitalised child component renders where the child
+calls `{children()}` — the single slot, with `{#if children}…{:else}…{/if}` as
+its fallback (there is no `<slot>` element and no named slots):
 
 ```html
 <script>
-  const { title = 'Card' } = props()
+const { text = '' } = props()
 </script>
 
-<section class="card">
-  <h3>{title}</h3>
-  {#if children}{children()}{:else}<p>empty</p>{/if}
-</section>
-
-<style>
-  .card { border: 1px solid #ddd; }
-</style>
+<article class="card rounded border p-2">
+    <p class="font-medium">{text}</p>
+    {#if children}{children()}{:else}<em>no body</em>{/if}
+</article>
 ```
 
 MIT

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@abide/abide",
-    "version": "0.44.0",
+    "version": "0.45.0",
     "type": "module",
     "sideEffects": false,
     "description": "Isomorphic multimodal HTTP framework built for humans and machines in a single Bun runtime",
@@ -75,6 +75,7 @@
         "./ui/html": "./src/lib/ui/html.ts",
         "./ui/effect": "./src/lib/ui/effect.ts",
         "./ui/scope": "./src/lib/ui/scope.ts",
+        "./ui/deferResume": "./src/lib/ui/deferResume.ts",
         "./ui/enterScope": "./src/lib/ui/enterScope.ts",
         "./ui/exitScope": "./src/lib/ui/exitScope.ts",
         "./ui/outbox": "./src/lib/ui/outbox.ts",

package/src/abideResolverPlugin.ts

@@ -257,10 +257,15 @@ export function abideResolverPlugin({
     return {
         name: 'abide-resolver',
         setup(build) {
-            /* Fresh edge graph each build (dev watch reuses the plugin instance).
+            /* Fresh edge graph + resolution cache each build (dev watch reuses the
+               plugin instance). The resolution cache memoises (path → resolved file)
+               within a build; clearing it per build keeps the memo but stops a stale
+               miss — a path resolved before its file existed — surviving into the next
+               build, so a freshly-created file resolves instead of staying "not found".
                onStart is build-time only — absent in the runtime/preload plugin context. */
             build.onStart?.(() => {
                 importerOf.clear()
+                resolveExtensionCache.clear()
             })
 
             /*