brustjs 0.1.64-alpha → 0.1.66-alpha

package/runtime/dev/watcher.ts

@@ -6,6 +6,7 @@ export type ChangeKind = 'ts' | 'css' | 'component-css' | 'html' | 'islands' | '
 const IGNORE_DIR_SEGMENTS = new Set(['node_modules', '.git', '.brust', 'dist'])
 const TS_RE = /\.(tsx?|jsx?)$/
 const TEST_RE = /\.test\.(tsx?|jsx?)$/
+const KIND_PRIORITY: ChangeKind[] = ['islands', 'ts', 'md', 'html', 'css', 'component-css']
 
 /** Classify a changed path. Returns null when the path should be ignored.
  * `root` is used to compute the relative path for ignore-segment matching.
@@ -83,26 +84,38 @@ export interface Watcher {
   close(): void
 }
 
-/** Watch `root` recursively. Emits one `onChange` call per debounce window
- * with paths classified by the dominant kind. Mixed-kind windows pick
- * by priority: islands > ts > html > css (islands trigger a full restart
- * that subsumes the others). */
+/** Internal — exposed for deterministic callback-contract tests. */
+export function _testDispatchChanges(
+  paths: string[],
+  opts: Pick<CreateWatcherOptions, 'root' | 'hasMdRoutes' | 'onChange'>,
+): void {
+  const grouped = new Map<ChangeKind, Set<string>>()
+  for (const p of paths) {
+    const kind = classifyPath(p, opts.root, opts.hasMdRoutes ?? true)
+    if (kind === null) continue
+    let group = grouped.get(kind)
+    if (!group) {
+      group = new Set()
+      grouped.set(kind, group)
+    }
+    group.add(p)
+  }
+  for (const kind of KIND_PRIORITY) {
+    const group = grouped.get(kind)
+    if (group && group.size > 0) {
+      opts.onChange({ paths: Array.from(group), kind })
+    }
+  }
+}
+
+/** Watch `root` recursively. Emits one `onChange` call for every distinct kind
+ * retained in a debounce window. Priority orders delivery; it never discards
+ * lower-priority kinds from a mixed window. */
 export function createWatcher(opts: CreateWatcherOptions): Watcher {
   const debounceMs = opts.debounceMs ?? 50
-  const kindPriority: ChangeKind[] = ['islands', 'ts', 'md', 'html', 'css', 'component-css']
 
   const coalesce = _testCoalesce(debounceMs, (paths) => {
-    const kinds = new Set<ChangeKind>()
-    const keep: string[] = []
-    for (const p of paths) {
-      const k = classifyPath(p, opts.root, opts.hasMdRoutes ?? true)
-      if (k === null) continue
-      kinds.add(k)
-      keep.push(p)
-    }
-    if (keep.length === 0) return
-    const dominant = kindPriority.find((k) => kinds.has(k))!
-    opts.onChange({ paths: keep, kind: dominant })
+    _testDispatchChanges(paths, opts)
   })
 
   const fsWatcher: FSWatcher = watch(opts.root, { recursive: true }, (_event, filename) => {

package/runtime/generator.ts

@@ -15,6 +15,20 @@ export interface GeneratorStrings {
   header: string
 }
 
+/** Full browser entry tag for the AI runtime chunk. */
+export function aiScriptTag(): string {
+  return '<script type="module" src="/_brust/ai.js"></script>'
+}
+
+/** Insert the AI runtime tag immediately before the first `</head>`.
+ * Document-only: fragment templates with no head are left unchanged. */
+export function injectAiScriptIntoTemplate(template: string): string {
+  const at = template.indexOf('</head>')
+  if (at === -1) return template
+  const tag = aiScriptTag()
+  return template.slice(0, at) + tag + template.slice(at)
+}
+
 /** Build the resolved strings. Version comes from the brustjs package.json
  * (readVersion never throws — "unknown" degrades to name-only, never a crash).
  * The version is sanitized to attr/header-safe bytes; semver chars only. */

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.64-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.64-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.66-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.66-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.64-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.64-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.66-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.66-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.64-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.64-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.66-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.66-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.64-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.64-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.66-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.66-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.64-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.64-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.66-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.66-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.64-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.64-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.66-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.66-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.64-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.64-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.1.66-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.66-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.64-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.64-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.66-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.66-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.64-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.64-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.66-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.66-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.64-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.64-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.66-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.66-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.64-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.64-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.66-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.66-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.64-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.64-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.66-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.66-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.64-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.64-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.66-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.66-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.64-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.64-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.66-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.66-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.64-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.64-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.66-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.66-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.64-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.64-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.66-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.66-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.64-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.64-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.66-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.66-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.64-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.64-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.66-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.66-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.64-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.64-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.66-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.66-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.64-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.64-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.66-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.66-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.64-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.64-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.66-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.66-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.64-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.64-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.66-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.66-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.64-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.64-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.66-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.66-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.64-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.64-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.66-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.66-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.64-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.64-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.66-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.66-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.64-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.64-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.66-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.66-alpha but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {

package/runtime/index.ts

@@ -189,6 +189,56 @@ async function readManifestFromPath(
   return parsed as import('./mcp/manifest.ts').McpManifest
 }
 
+function createAiInternalRoutes(paths: {
+  manifestPath: string
+  runtimePath: string
+}): import('./routes.ts').FlatRoute[] {
+  const manifestHandler: import('./routes.ts').Middleware = async () => {
+    const file = Bun.file(paths.manifestPath)
+    if (!(await file.exists())) {
+      return {
+        status: 404,
+        body: 'not found',
+        contentType: 'text/plain; charset=utf-8',
+      }
+    }
+    return {
+      status: 200,
+      body: await file.text(),
+      contentType: 'application/json; charset=utf-8',
+    }
+  }
+  const runtimeHandler: import('./routes.ts').Middleware = async () => {
+    const file = Bun.file(paths.runtimePath)
+    if (!(await file.exists())) {
+      return {
+        status: 404,
+        body: 'not found',
+        contentType: 'text/plain; charset=utf-8',
+      }
+    }
+    return {
+      status: 200,
+      body: await file.text(),
+      contentType: 'text/javascript; charset=utf-8',
+    }
+  }
+  return [
+    {
+      fullPath: '/_brust/ai/manifest.json',
+      chain: [{} as any],
+      middleware: [manifestHandler],
+      shellId: 'S:ai-manifest',
+    } as import('./routes.ts').FlatRoute,
+    {
+      fullPath: '/_brust/ai.js',
+      chain: [{} as any],
+      middleware: [runtimeHandler],
+      shellId: 'S:ai-runtime',
+    } as import('./routes.ts').FlatRoute,
+  ]
+}
+
 export const brust = {
   async serve(opts: ServeOptions): Promise<void> {
     // Fail fast on a bad CORS config BEFORE touching native state (Rust
@@ -442,6 +492,8 @@ export const brust = {
     /** Optional global CORS policy — see {@link CorsOptions}. Threaded to
      * serve() like `actionPrefix`. */
     cors?: CorsOptions
+    /** AI runtime toggle. Dev mode enables it automatically. */
+    ai?: boolean
     /** Overrides merged into the underlying `serve()` call (main thread). */
     serve?: Partial<Omit<ServeOptions, 'entry' | 'actions' | 'mcp'>>
     /** Per-worker SAB size in bytes. Default 256 KB. */
@@ -461,6 +513,7 @@ export const brust = {
     const scanRoot = opts.scanRoot ?? path.dirname(fileURLToPath(opts.entry))
 
     const dev = opts.dev === true || process.env.BRUST_DEV === '1'
+    const aiEnabled = dev || opts.ai === true || process.env.BRUST_AI === '1'
     // Unify the `dev: true` option with the BRUST_DEV env signal. The dev
     // coordinator/watcher (which calls worker-registry spawnAll() on hot reload)
     // keys off this `dev` variable, but serve()'s registerInitialPool — plus
@@ -472,6 +525,16 @@ export const brust = {
     // registerInitialPool"). Set it here, before serve() spawns workers, so they
     // inherit it via baseEnv.
     if (dev) process.env.BRUST_DEV = '1'
+    if (aiEnabled) process.env.BRUST_AI = '1'
+    const aiManifestPath = prebuilt
+      ? path.join(distDir!, '.brust', 'ai-manifest.json')
+      : path.resolve(process.cwd(), '.brust', 'ai-manifest.json')
+    const aiRuntimePath = prebuilt
+      ? path.join(distDir!, 'islands', 'ai.js')
+      : path.resolve(process.cwd(), '.brust', 'islands', 'ai.js')
+    const aiInternalRoutes = aiEnabled
+      ? createAiInternalRoutes({ manifestPath: aiManifestPath, runtimePath: aiRuntimePath })
+      : []
     let routes = opts.routes
     if (dev) {
       const { createDevWsRoute } = await import('./dev/ws-channel.ts')
@@ -484,6 +547,9 @@ export const brust = {
       ]
       configureDevClientSnippet(buildDevClientTag())
     }
+    if (aiInternalRoutes.length > 0) {
+      routes = [...routes, ...aiInternalRoutes]
+    }
     {
       const { configureActionPrefixSnippet } = await import('./render/inject-action-prefix.ts')
       const ap = opts.actionPrefix
@@ -544,6 +610,10 @@ export const brust = {
           (r.chain[r.chain.length - 1] as { __mdSource?: unknown } | undefined)?.__mdSource !==
           undefined,
       )
+      if (!prebuilt) {
+        const { extractAiManifest, writeManifest } = await import('./ai/manifest.ts')
+        await writeManifest(process.cwd(), extractAiManifest(opts.routes))
+      }
 
       // Component CSS pipeline. Build the manifest + capture the loader plugin
       // BEFORE buildIslands and pass it EXPLICITLY below (global Bun.plugin()
@@ -627,6 +697,7 @@ export const brust = {
                 flatRoutes: opts.routes,
                 outDir: path.resolve(process.cwd(), '.brust/jinja'),
                 withDevClient: dev,
+                aiEnabled,
                 manifestDirs: [path.resolve(process.cwd(), '.brust')],
               }))
             } catch (err) {
@@ -644,10 +715,12 @@ export const brust = {
           const { scanIslandChunks, buildIslands: build } = await import('./islands/build.ts')
           const islandMap = scanIslandChunks(routesPath, mdIslands)
           let islandsDir: string | undefined
-          if (islandMap.size > 0) {
+          if (islandMap.size > 0 || aiEnabled) {
             const islands = await build(islandMap, { plugins: cssBuildPlugins })
             islandsDir = islands.outDir
-            console.log(`[brust] main: built ${islands.islandCount} island chunk(s)`)
+            console.log(
+              `[brust] main: built ${islands.islandCount} island chunk(s)${aiEnabled ? ' + ai runtime' : ''}`,
+            )
           }
           // Directive runtime bundle (Spec B) — build AFTER islands (buildIslands
           // rm -rf's its outDir) into the SAME dir so a native page's _directives.js
@@ -662,6 +735,11 @@ export const brust = {
             console.log(`[brust] main: built directive runtime (${res.count} component(s))`)
           }
           if (islandsDir) this.configureIslandsDir(islandsDir)
+        } else if (aiEnabled) {
+          const { buildIslands: build } = await import('./islands/build.ts')
+          const islands = await build(new Map(), { plugins: cssBuildPlugins })
+          this.configureIslandsDir(islands.outDir)
+          console.log('[brust] main: built 0 island chunk(s) + ai runtime')
         }
       }
 
@@ -791,6 +869,7 @@ export const brust = {
         ;(native as any).configureDevMode?.(true)
         const { createWatcher } = await import('./dev/watcher.ts')
         const { Coordinator } = await import('./dev/coordinator.ts')
+        const { validateChangedModules } = await import('./dev/validate-change.ts')
         const { broadcast } = await import('./dev/ws-channel.ts')
         const { Tui } = await import('./dev/tui.ts')
         const { terminateAll: termWorkers, spawnAll: spawnWorkers } = await import(
@@ -831,6 +910,7 @@ export const brust = {
             },
           },
           reEmitJinja,
+          validateChanges: validateChangedModules,
           // Wipe the Rust-side island ISR cache on every render-affecting reload
           // so a frozen island render never survives a `.tsx` edit in dev.
           clearIslandCache: () => {
@@ -860,6 +940,7 @@ export const brust = {
                     flatRoutes: opts.routes,
                     outDir: pathModule.resolve(process.cwd(), '.brust/jinja'),
                     withDevClient: true,
+                    aiEnabled,
                     manifestDirs: [pathModule.resolve(process.cwd(), '.brust')],
                   }))
                 } catch (err) {
@@ -867,7 +948,7 @@ export const brust = {
                 }
               }
               const islandMap = scanIslandChunks(routesPath, mdIslands)
-              if (islandMap.size > 0) {
+              if (islandMap.size > 0 || aiEnabled) {
                 await buildIslands(islandMap)
               }
               // Spec B: rebuild the directive bundle after islands (which rm -rf's
@@ -879,6 +960,9 @@ export const brust = {
                   outDir: pathModule.join(process.cwd(), '.brust', 'islands'),
                 })
               }
+            } else if (aiEnabled) {
+              const { buildIslands } = await import('./islands/build.ts')
+              await buildIslands(new Map())
             }
           },
           buildComponentCss: async () => {
@@ -981,6 +1065,9 @@ export const brust = {
           ...opts.routes,
         ]
       }
+      if (aiInternalRoutes.length > 0) {
+        workerRoutes = [...workerRoutes, ...aiInternalRoutes]
+      }
       {
         const { configureActionPrefixSnippet } = await import('./render/inject-action-prefix.ts')
         const ap = opts.actionPrefix

package/runtime/islands/build.ts

@@ -1,4 +1,4 @@
-import { readFileSync } from 'node:fs'
+import { existsSync, readFileSync } from 'node:fs'
 import { mkdir, rm, writeFile } from 'node:fs/promises'
 import { isAbsolute, relative, resolve } from 'node:path'
 import type { BunPlugin } from 'bun'
@@ -26,6 +26,15 @@ export interface BuildIslandsOptions {
   plugins?: BunPlugin[]
 }
 
+export interface BuildAiRuntimeOptions {
+  /** Override the output directory. Default: `<cwd>/.brust/islands`. */
+  outDir?: string
+  /** Override the browser entry file. Default: `runtime/ai/index.ts`. */
+  entryFile?: string
+  /** Build plugins passed straight to `Bun.build` for the AI runtime chunk. */
+  plugins?: BunPlugin[]
+}
+
 /** Scan a routes entry file for `<Island component={X} />` usage and derive the
  * island chunk list (componentName → absolute source path). Replaces the old
  * static config-file lookup — the chunk set is derived from source.
@@ -198,9 +207,41 @@ export async function buildIslands(
   const bootstrapSrc = resolve(import.meta.dir, 'bootstrap.ts')
   await buildOne([bootstrapSrc], outDir, '_bootstrap.js', externals)
 
+  // 5. AI browser runtime. The task-owned entry is optional in this worktree;
+  // missing source is a soft skip so island-only builds keep working.
+  if (process.env.BRUST_AI === '1' || process.env.BRUST_DEV === '1') {
+    await buildAiRuntime({ outDir, plugins })
+  }
+
   return { outDir, islandCount: count, chunks }
 }
 
+export async function buildAiRuntime(options: BuildAiRuntimeOptions = {}): Promise<string | null> {
+  const outDir = options.outDir
+    ? isAbsolute(options.outDir)
+      ? options.outDir
+      : resolve(process.cwd(), options.outDir)
+    : resolve(process.cwd(), '.brust/islands')
+  await mkdir(outDir, { recursive: true })
+  const entryFile = options.entryFile
+    ? isAbsolute(options.entryFile)
+      ? options.entryFile
+      : resolve(process.cwd(), options.entryFile)
+    : resolve(import.meta.dir, '../ai/index.ts')
+  if (!existsSync(entryFile)) {
+    console.warn(`[brust] ai runtime skipped (missing ${relative(process.cwd(), entryFile)})`)
+    return null
+  }
+  await buildOne(
+    [entryFile],
+    outDir,
+    'ai.js',
+    ['react', 'react/jsx-runtime', 'react-dom/client'],
+    options.plugins ?? [],
+  )
+  return resolve(outDir, 'ai.js')
+}
+
 export async function buildOne(
   entrypoints: string[],
   outdir: string,