brustjs 0.1.19-alpha → 0.1.21-alpha

package/example/pokedex/components/AddToTeamButton.tsx

@@ -4,23 +4,26 @@
 // so unlike the native page shells they have NO jinja constraints: hooks, inline
 // `style={{…}}`, event handlers all work normally.
 import { useEffect, useState } from 'react'
-import { client } from 'brustjs/client'
+import { client, useStore } from 'brustjs/client'
 import type { Actions } from '../actions'
-import type { AddToTeamProps, TeamMember } from '../lib/types'
-import { emitTeam, onTeam } from './team-bus'
+import type { AddToTeamProps } from '../lib/types'
+import { teamStore } from '../stores/team'
 
 const api = client<Actions>()
 
 export default function AddToTeamButton(p: AddToTeamProps) {
-  const [team, setTeam] = useState<TeamMember[]>([])
+  // Shared store (GAP S4): writing teamStore.members here is observed by the
+  // TeamBuilder island — they resolve the same window singleton. This is a
+  // client-only island (no `ssr`), so the store read always hits the client branch.
+  const { members } = useStore(teamStore)
+  const team = members ?? []
   const [busy, setBusy] = useState(false)
   const [toast, setToast] = useState<string | null>(null)
 
   useEffect(() => {
     api.team.get().then((r) => {
-      if (r.data) setTeam(r.data.team)
+      if (r.data) teamStore.members.set(r.data.team)
     })
-    return onTeam(setTeam)
   }, [])
 
   const inTeam = team.some((m) => m.id === p.id)
@@ -33,7 +36,7 @@ export default function AddToTeamButton(p: AddToTeamProps) {
         // DELETE from the browser sends no Content-Length, and brust's action
         // dispatch returns 411 on non-GET/HEAD without one. See GAPS S12.
         const { data } = await api.team({ id: p.id }).delete({})
-        if (data) emitTeam(data.team)
+        if (data) teamStore.members.set(data.team)
       } else {
         const { data } = await api.team.post({
           id: p.id,
@@ -47,7 +50,7 @@ export default function AddToTeamButton(p: AddToTeamProps) {
           setToast('ทีมเต็มแล้ว · สูงสุด 6 ตัว')
           setTimeout(() => setToast(null), 2200)
         } else if (data) {
-          emitTeam(data.team)
+          teamStore.members.set(data.team)
         }
       }
     } finally {

package/example/pokedex/components/PageLayout.tsx

@@ -26,7 +26,12 @@ export default function PageLayout({
   children: ReactNode
 }) {
   return (
-    <BrustPage lang="en" className="dark" title={title}>
+    <BrustPage
+      lang="en"
+      className="dark"
+      title={title}
+      head={[{ tag: 'link', rel: 'icon', href: '/favicon.svg' }]}
+    >
       <div className="aa-app">
         <aside className="aa-sidebar">
           <div className="aa-sidebar__brand">

package/example/pokedex/components/TeamBuilder.tsx

@@ -2,33 +2,43 @@
 //
 // Rendered with `ssr` so the initial team (from the loader) ships in the HTML
 // and the dock count is correct on first paint, then hydrates. Stays in sync
-// with AddToTeamButton through the window-event bus (see team-bus.ts / GAPS S4).
+// with AddToTeamButton through the shared `teamStore` (one window singleton — see
+// ../stores/team.ts / GAPS S4; replaced the old window-event bus).
 import { useEffect, useState } from 'react'
-import { client } from 'brustjs/client'
+import { client, useStore } from 'brustjs/client'
 import type { Actions } from '../actions'
 import type { TeamMember } from '../lib/types'
-import { emitTeam, onTeam } from './team-bus'
+import { teamStore } from '../stores/team'
 
 const api = client<Actions>()
 const MAX = 6
 
 export default function TeamBuilder({ teamInitial }: { teamInitial: TeamMember[] }) {
-  const [team, setTeam] = useState<TeamMember[]>(teamInitial ?? [])
+  // Shared store (GAP S4): in sync with AddToTeamButton via one window singleton.
+  const { members } = useStore(teamStore)
+  const [mounted, setMounted] = useState(false)
   const [open, setOpen] = useState(false)
 
+  // This island is `ssr`, but Spec A does not server-seed native client state, so
+  // the store is empty during SSR. Drive the first render (server + client) from
+  // the `teamInitial` prop so the dock count is correct on first paint AND the
+  // hydration markup matches; switch to the live store once mounted. (Full
+  // server-seeded native snapshot is Spec B.)
+  const team = mounted ? (members ?? []) : (teamInitial ?? [])
+
   useEffect(() => {
-    // Re-sync from the server on mount (the SSR snapshot may be stale by now),
-    // then subscribe to mutations from the other island.
+    if (teamInitial?.length) teamStore.members.set(teamInitial)
+    setMounted(true)
+    // Re-sync from the server on mount (the SSR snapshot may be stale by now).
     api.team.get().then((r) => {
-      if (r.data) setTeam(r.data.team)
+      if (r.data) teamStore.members.set(r.data.team)
     })
-    return onTeam(setTeam)
-  }, [])
+  }, [teamInitial])
 
   async function remove(id: number) {
     // `.delete({})` — empty body is required (bodyless DELETE → 411). See GAPS S12.
     const { data } = await api.team({ id }).delete({})
-    if (data) emitTeam(data.team)
+    if (data) teamStore.members.set(data.team)
   }
 
   const coverage = [...new Set(team.flatMap((m) => m.types))]

package/example/pokedex/stores/team.ts

@@ -0,0 +1,14 @@
+// Shared team store — GAP S4 dogfood.
+//
+// AddToTeamButton and TeamBuilder are two SEPARATE island bundles. A plain
+// module-scope store imported by both would be duplicated into two instances
+// that never sync. `defineStore` resolves both bundles to ONE instance on
+// `window.__BRUST_STORES__['pokedex.team']`, so a write in one island is seen by
+// the other — no hand-rolled CustomEvent bus. (Replaces the old components/team-bus.ts.)
+import { defineStore, signal } from 'brustjs/store'
+import type { TeamMember } from '../lib/types'
+
+export const teamStore = defineStore('pokedex.team', () => {
+  const members = signal<TeamMember[]>([])
+  return { members }
+})

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brustjs",
-  "version": "0.1.19-alpha",
+  "version": "0.1.21-alpha",
   "description": "Bun + Rust SSR framework — React on the server, Rust everywhere else (napi cdylib + per-worker SharedArrayBuffer).",
   "license": "MIT",
   "repository": {
@@ -40,12 +40,12 @@
     "typescript": "^6.0.3"
   },
   "optionalDependencies": {
-    "brustjs-darwin-x64": "0.1.19-alpha",
-    "brustjs-darwin-arm64": "0.1.19-alpha",
-    "brustjs-linux-x64-gnu": "0.1.19-alpha",
-    "brustjs-linux-arm64-gnu": "0.1.19-alpha",
-    "brustjs-linux-x64-musl": "0.1.19-alpha",
-    "brustjs-linux-arm64-musl": "0.1.19-alpha"
+    "brustjs-darwin-x64": "0.1.21-alpha",
+    "brustjs-darwin-arm64": "0.1.21-alpha",
+    "brustjs-linux-x64-gnu": "0.1.21-alpha",
+    "brustjs-linux-arm64-gnu": "0.1.21-alpha",
+    "brustjs-linux-x64-musl": "0.1.21-alpha",
+    "brustjs-linux-arm64-musl": "0.1.21-alpha"
   },
   "peerDependencies": {
     "react": "^19.2.6",
@@ -67,7 +67,8 @@
     ".": "./runtime/index.ts",
     "./routes": "./runtime/routes.ts",
     "./client": "./runtime/client/index.ts",
-    "./create": "./runtime/create.ts"
+    "./create": "./runtime/create.ts",
+    "./store": "./runtime/store/index.ts"
   },
   "files": [
     "runtime",

package/runtime/cli/templates/minimal/pages/Home.tsx.tmpl

@@ -19,7 +19,13 @@ export default function Home({
   cacheTags: string[]
 }) {
   return (
-    <BrustPage lang="en" className="dark" bodyClassName="brust-body" title="__PROJECT_NAME__">
+    <BrustPage
+      lang="en"
+      className="dark"
+      bodyClassName="brust-body"
+      title="__PROJECT_NAME__"
+      head={[{ tag: 'link', rel: 'icon', href: '/favicon.svg' }]}
+    >
       {/* Background decorative glows */}
       <div className="fixed top-[-20%] left-[-10%] w-[50%] h-[50%] bg-purple-600/10 rounded-full blur-[120px] pointer-events-none"></div>
       <div className="fixed bottom-[-20%] right-[-10%] w-[50%] h-[50%] bg-teal-600/10 rounded-full blur-[120px] pointer-events-none"></div>

package/runtime/client/index.ts

@@ -20,3 +20,9 @@ export class BrustActionError extends Error {
 
 export { client } from '../treaty.ts'
 export type { TreatyResponse, ClientOptions } from '../treaty.ts'
+
+// Store view-layer adapter for islands. Lives here (the browser/island entry),
+// NOT in the brustjs main entry — that pulls the native addon + server-only
+// surface and cannot be bundled for the browser. react.ts → define-store.ts is
+// browser-safe (no node:async_hooks; the server resolver is injected separately).
+export { useStore } from '../store/react.ts'

package/runtime/index.js

@@ -77,8 +77,8 @@ function requireNative() {
       try {
         const binding = require('brustjs-android-arm64')
         const bindingPackageVersion = require('brustjs-android-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.19-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.19-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.21-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.21-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -93,8 +93,8 @@ function requireNative() {
       try {
         const binding = require('brustjs-android-arm-eabi')
         const bindingPackageVersion = require('brustjs-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '0.1.19-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.19-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.21-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.21-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -114,8 +114,8 @@ function requireNative() {
       try {
         const binding = require('brustjs-win32-x64-gnu')
         const bindingPackageVersion = require('brustjs-win32-x64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.1.19-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.19-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.21-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.21-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -130,8 +130,8 @@ function requireNative() {
       try {
         const binding = require('brustjs-win32-x64-msvc')
         const bindingPackageVersion = require('brustjs-win32-x64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.1.19-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.19-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.21-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.21-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -147,8 +147,8 @@ function requireNative() {
       try {
         const binding = require('brustjs-win32-ia32-msvc')
         const bindingPackageVersion = require('brustjs-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '0.1.19-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.19-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.21-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.21-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -163,8 +163,8 @@ function requireNative() {
       try {
         const binding = require('brustjs-win32-arm64-msvc')
         const bindingPackageVersion = require('brustjs-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.1.19-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.19-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.21-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.21-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -182,8 +182,8 @@ function requireNative() {
     try {
       const binding = require('brustjs-darwin-universal')
       const bindingPackageVersion = require('brustjs-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '0.1.19-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-        throw new Error(`Native binding package version mismatch, expected 0.1.19-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.1.21-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 0.1.21-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -198,8 +198,8 @@ function requireNative() {
       try {
         const binding = require('brustjs-darwin-x64')
         const bindingPackageVersion = require('brustjs-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '0.1.19-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.19-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.21-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.21-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -214,8 +214,8 @@ function requireNative() {
       try {
         const binding = require('brustjs-darwin-arm64')
         const bindingPackageVersion = require('brustjs-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.19-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.19-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.21-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.21-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -234,8 +234,8 @@ function requireNative() {
       try {
         const binding = require('brustjs-freebsd-x64')
         const bindingPackageVersion = require('brustjs-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '0.1.19-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.19-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.21-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.21-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -250,8 +250,8 @@ function requireNative() {
       try {
         const binding = require('brustjs-freebsd-arm64')
         const bindingPackageVersion = require('brustjs-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.19-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.19-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.21-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.21-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -271,8 +271,8 @@ function requireNative() {
         try {
           const binding = require('brustjs-linux-x64-musl')
           const bindingPackageVersion = require('brustjs-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.19-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.19-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.21-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.21-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -287,8 +287,8 @@ function requireNative() {
         try {
           const binding = require('brustjs-linux-x64-gnu')
           const bindingPackageVersion = require('brustjs-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.19-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.19-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.21-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.21-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -305,8 +305,8 @@ function requireNative() {
         try {
           const binding = require('brustjs-linux-arm64-musl')
           const bindingPackageVersion = require('brustjs-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.19-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.19-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.21-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.21-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -321,8 +321,8 @@ function requireNative() {
         try {
           const binding = require('brustjs-linux-arm64-gnu')
           const bindingPackageVersion = require('brustjs-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.19-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.19-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.21-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.21-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -339,8 +339,8 @@ function requireNative() {
         try {
           const binding = require('brustjs-linux-arm-musleabihf')
           const bindingPackageVersion = require('brustjs-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '0.1.19-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.19-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.21-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.21-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -355,8 +355,8 @@ function requireNative() {
         try {
           const binding = require('brustjs-linux-arm-gnueabihf')
           const bindingPackageVersion = require('brustjs-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '0.1.19-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.19-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.21-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.21-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -373,8 +373,8 @@ function requireNative() {
         try {
           const binding = require('brustjs-linux-loong64-musl')
           const bindingPackageVersion = require('brustjs-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.19-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.19-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.21-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.21-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -389,8 +389,8 @@ function requireNative() {
         try {
           const binding = require('brustjs-linux-loong64-gnu')
           const bindingPackageVersion = require('brustjs-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.19-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.19-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.21-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.21-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -407,8 +407,8 @@ function requireNative() {
         try {
           const binding = require('brustjs-linux-riscv64-musl')
           const bindingPackageVersion = require('brustjs-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '0.1.19-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.19-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.21-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.21-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -423,8 +423,8 @@ function requireNative() {
         try {
           const binding = require('brustjs-linux-riscv64-gnu')
           const bindingPackageVersion = require('brustjs-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.1.19-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.1.19-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.21-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.21-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -440,8 +440,8 @@ function requireNative() {
       try {
         const binding = require('brustjs-linux-ppc64-gnu')
         const bindingPackageVersion = require('brustjs-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.1.19-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.19-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.21-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.21-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -456,8 +456,8 @@ function requireNative() {
       try {
         const binding = require('brustjs-linux-s390x-gnu')
         const bindingPackageVersion = require('brustjs-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '0.1.19-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.19-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.21-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.21-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -476,8 +476,8 @@ function requireNative() {
       try {
         const binding = require('brustjs-openharmony-arm64')
         const bindingPackageVersion = require('brustjs-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '0.1.19-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.19-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.21-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.21-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -492,8 +492,8 @@ function requireNative() {
       try {
         const binding = require('brustjs-openharmony-x64')
         const bindingPackageVersion = require('brustjs-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '0.1.19-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.19-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.21-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.21-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -508,8 +508,8 @@ function requireNative() {
       try {
         const binding = require('brustjs-openharmony-arm')
         const bindingPackageVersion = require('brustjs-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '0.1.19-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.1.19-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.21-alpha' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.21-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {

package/runtime/index.ts

@@ -745,7 +745,15 @@ import './islands/isr-jsx.ts'
 export type { IsrConfig } from './islands/isr-jsx.ts'
 
 export { BrustPage } from './islands/brust-page.tsx'
-export type { BrustPageProps } from './islands/brust-page.tsx'
+export type { BrustPageProps, HeadEntry } from './islands/brust-page.tsx'
+
+// Store reactive primitives (isomorphic, server-safe). The React adapter
+// `useStore` is intentionally NOT exported here — it ships from `brustjs/client`
+// because islands (the only React in the browser) bundle for the browser and
+// cannot pull this server entry (native addon + react-dom/server). See
+// runtime/client/index.ts.
+export { defineStore, signal, computed, effect, batch } from './store/index.ts'
+export type { StoreHandle, Snapshot, Signal, Computed } from './store/index.ts'
 
 export { buildIslands } from './islands/build.ts'
 export type { IslandsBuildResult, BuildIslandsOptions } from './islands/build.ts'

package/runtime/islands/bootstrap.ts

@@ -15,6 +15,7 @@
 
 import { createRoot, hydrateRoot, type Root } from 'react-dom/client'
 import { createElement } from 'react'
+import { applyStoreSnapshot } from '../store/client-hydrate.ts'
 
 // Track React roots created by hydrateOne so we can unmount them before
 // removing their DOM in swapMainContent. Without this, removing the DOM
@@ -214,11 +215,16 @@ async function navigate(url: URL, push: boolean): Promise<void> {
       headers: { Accept: 'application/json' },
     })
     if (!resp.ok) throw new Error(`navigation: status ${resp.status}`)
-    const { html, title } = (await resp.json()) as { html: string; title: string }
+    const { html, title, store } = (await resp.json()) as {
+      html: string
+      title: string
+      store?: Record<string, Record<string, unknown>>
+    }
     const main = document.querySelector('main')
     if (!main) throw new Error('navigation: no <main> element')
     unmountIslandsIn(main as HTMLElement)
     swapMainContent(main as HTMLElement, html)
+    if (store) applyStoreSnapshot(store)
     if (title) document.title = title
     if (push) history.pushState({}, '', url.href)
     window.scrollTo(0, 0)

package/runtime/islands/brust-page.tsx

@@ -14,6 +14,35 @@ import { createElement, type ReactNode } from 'react'
  * loader member-path (`title={data.title}`), interpolated into the Rust-rendered
  * shell as `{{ path }}` (S8). Calls/arithmetic are still rejected. This React
  * implementation mirrors the compiled output for the rare non-native use. */
+/** One extra `<head>` element for `<BrustPage head={[…]}>`. Discriminated by
+ * `tag`. On the native path, attribute values may be a string literal or a
+ * loader member-path (HTML-escaped); `text` (inner content of style/script/
+ * noscript) must be a static string literal (raw — never user input). */
+export type HeadEntry =
+  | {
+      tag: 'link'
+      rel: string
+      href: string
+      type?: string
+      sizes?: string
+      as?: string
+      media?: string
+      crossOrigin?: string
+    }
+  | { tag: 'meta'; name?: string; property?: string; httpEquiv?: string; content: string }
+  | { tag: 'base'; href?: string; target?: string }
+  | { tag: 'style'; text: string; media?: string }
+  | {
+      tag: 'script'
+      src?: string
+      text?: string
+      type?: string
+      defer?: boolean
+      async?: boolean
+      crossOrigin?: string
+    }
+  | { tag: 'noscript'; text: string }
+
 export interface BrustPageProps {
   /** `<html lang>` — defaults to `"en"`. */
   lang?: string
@@ -25,16 +54,30 @@ export interface BrustPageProps {
   title?: string
   /** `<meta name="description" content="…">`. Omitted when absent. */
   description?: string
+  /** Extra `<head>` elements (link/meta/base/style/script/noscript). */
+  head?: HeadEntry[]
   /** Page body — rendered inside `<body>`. */
   children?: ReactNode
 }
 
+/** React mirror of one head entry (non-native path). Native routes emit these
+ * in Rust; this keeps the rare React render in sync. */
+function headEntryToElement(entry: HeadEntry, key: number): ReactNode {
+  const { tag, ...rest } = entry
+  if (tag === 'style' || tag === 'script' || tag === 'noscript') {
+    const { text, ...attrs } = rest as { text?: string } & Record<string, unknown>
+    return createElement(tag, { key, ...attrs }, text ?? undefined)
+  }
+  return createElement(tag, { key, ...rest })
+}
+
 export function BrustPage({
   lang = 'en',
   className,
   bodyClassName,
   title,
   description,
+  head,
   children,
 }: BrustPageProps): ReactNode {
   return createElement(
@@ -50,6 +93,7 @@ export function BrustPage({
         ? createElement('meta', { name: 'description', content: description })
         : null,
       createElement('link', { rel: 'stylesheet', href: '/_brust/css/app.css' }),
+      ...(head ?? []).map((entry, i) => headEntryToElement(entry, i)),
     ),
     createElement('body', { className: bodyClassName }, children),
   )