brustjs 0.1.64-alpha → 0.1.65-alpha

package/types/ai/manifest.d.ts

@@ -0,0 +1,17 @@
+import type { FlatRoute } from '../routes.ts';
+export interface AiPageEntry {
+    path: string;
+    params: string[];
+    catchAll: boolean;
+    kind: 'react' | 'native' | 'md';
+    shellId: string;
+    title?: string;
+    description?: string;
+}
+export interface AiManifest {
+    version: 1;
+    pages: AiPageEntry[];
+}
+export declare function extractAiManifest(routes: FlatRoute[]): AiManifest;
+export declare function writeManifest(cwd: string, manifest: AiManifest): Promise<void>;
+export declare function readManifest(cwd: string): Promise<AiManifest | null>;

package/types/cli/native-routes-emit.d.ts

@@ -71,7 +71,11 @@ export declare function countMainTags(template: string): number;
  *
  * Exported for the md emit step (runtime/md/emit.ts), which bakes the same tag
  * under its `withDevClient` option — md pages render Rust-side too, so without
- * it they never auto-reload in dev. */
+ * it they never auto-reload in dev.
+ *
+ * The AI runtime script is injected here as well when BRUST_AI=1. The tag is
+ * document-only: the compiler emits a head anchor for full documents, while
+ * fragment templates (no head) are left unchanged. */
 export declare function injectDevClientIntoTemplate(template: string): string;
 /** Bake the directive runtime loader into a native template iff it uses any
  * x-data directive. Idempotent. Wrapped in {% raw %} for symmetry with the islands

package/types/config.d.ts

@@ -10,6 +10,8 @@ export interface BrustConfig {
     cacheMaxEntries?: number;
     /** L2 page-cache capacity (entries). Undefined → Rust default of 1000. */
     cachePageMaxEntries?: number;
+    /** AI runtime toggle from BRUST_AI. Dev mode enables it separately. */
+    ai?: boolean;
     /** R9 cross-process cache invalidation: redis/dragonfly URL. Absent →
      * feature disabled (current single-process behavior). */
     cacheSyncUrl?: string;

package/types/generator.d.ts

@@ -4,6 +4,11 @@ export interface GeneratorStrings {
     /** X-Powered-By value, e.g. `brust/0.1.48-alpha` */
     header: string;
 }
+/** Full browser entry tag for the AI runtime chunk. */
+export declare function aiScriptTag(): string;
+/** Insert the AI runtime tag immediately before the first `</head>`.
+ * Document-only: fragment templates with no head are left unchanged. */
+export declare function injectAiScriptIntoTemplate(template: string): string;
 /** 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/types/index.d.ts

@@ -183,6 +183,8 @@ export declare 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. */

package/types/islands/build.d.ts

@@ -18,6 +18,14 @@ export interface BuildIslandsOptions {
      * on the output filename (X.module.css + X.tsx → both X.js). */
     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.
@@ -46,4 +54,5 @@ export declare function scanIslandChunks(routesEntryFile: string, extraIslands?:
 /** Build the runtime chunks + all island chunks + bootstrap. Returns the
  * absolute output directory; caller passes it to `brust.configureIslandsDir`. */
 export declare function buildIslands(islands: Map<string, string>, options?: BuildIslandsOptions): Promise<IslandsBuildResult>;
+export declare function buildAiRuntime(options?: BuildAiRuntimeOptions): Promise<string | null>;
 export declare function buildOne(entrypoints: string[], outdir: string, naming: string, external: string[], plugins?: BunPlugin[]): Promise<void>;

package/types/md/emit.d.ts

@@ -27,6 +27,9 @@ export interface MdEmitOpts {
      * BRUST_DEV injection — md pages render Rust-side and never pass through the
      * React renderer's dev-client injection). */
     withDevClient?: boolean;
+    /** Bake the AI runtime tag into document-style md templates. Fragments skip
+     * the injection entirely. */
+    aiEnabled?: boolean;
     /** What to do when a route's md file no longer exists on disk (deleted after
      * the route table was built). emitMdTemplates serves BOTH `brust build` and
      * the dev re-emit, and the two must diverge here:

package/types/render/inject-ai-client.d.ts

@@ -0,0 +1,6 @@
+/** Splice `snippet` into `body` immediately before the first `</head>`
+ * (case-insensitive on the four ASCII letters only). Returns the original body
+ * untouched if `snippet` is null/empty or if `</head>` is absent.
+ *
+ * AI pages are document-only: fragment templates skip this injection entirely. */
+export declare function injectAiClient(body: Uint8Array, snippet: string | null): Uint8Array;