fibrae 0.2.3 → 0.3.0

package/dist/cli/build.d.ts

@@ -0,0 +1,34 @@
+/**
+ * SSG build pipeline.
+ *
+ * Orchestrates: Vite client build → route discovery → pre-render → write HTML.
+ */
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { FileSystem } from "@effect/platform";
+import { Path } from "@effect/platform";
+import { Router, RouterHandlers } from "../router/index.js";
+import type { HeadData } from "../router/index.js";
+import type { VElement } from "../shared.js";
+export interface BuildOptions {
+    /** The fibrae router instance */
+    readonly router: Router.Router;
+    /** Layer providing RouterHandlers */
+    readonly handlersLayer: Layer.Layer<RouterHandlers>;
+    /** Wraps each route's rendered element in the app shell */
+    readonly appShell: (element: VElement) => VElement;
+    /** Output directory */
+    readonly outDir: string;
+    /** Base path prefix for routes (e.g. "/app") */
+    readonly basePath?: string;
+    /** Path to client JS bundle (relative to site root) */
+    readonly clientScript?: string;
+    /** Default page title */
+    readonly title?: string;
+    /** Global head tags injected into every page */
+    readonly headTags?: HeadData;
+}
+/**
+ * Pre-render all routes marked with `prerender: true` to static HTML files.
+ */
+export declare const build: (options: BuildOptions) => Effect.Effect<void, unknown, FileSystem.FileSystem | Path.Path>;

package/dist/cli/build.js

@@ -0,0 +1,92 @@
+/**
+ * SSG build pipeline.
+ *
+ * Orchestrates: Vite client build → route discovery → pre-render → write HTML.
+ */
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { FileSystem } from "@effect/platform";
+import { Path } from "@effect/platform";
+import { renderToStringWith, SSRAtomRegistryLayer } from "../server.js";
+import { Router, RouterHandlers, getPrerenderRoutes } from "../router/index.js";
+import { buildPage } from "./html.js";
+/**
+ * Render a single route to an HTML string.
+ */
+const renderRoute = (config) => Effect.gen(function* () {
+    const serverLayer = Router.serverLayer({
+        router: config.router,
+        pathname: config.pathname,
+        search: "",
+        basePath: config.basePath,
+    });
+    const fullLayer = Layer.provideMerge(serverLayer, Layer.merge(config.handlersLayer, SSRAtomRegistryLayer));
+    const { html, dehydratedState, head } = yield* Effect.gen(function* () {
+        const { element, head } = yield* Router.CurrentRouteElement;
+        const renderResult = yield* renderToStringWith(config.appShell(element));
+        return { ...renderResult, head };
+    }).pipe(Effect.provide(fullLayer));
+    return yield* buildPage({
+        html,
+        dehydratedState: dehydratedState,
+        clientScript: config.clientScript,
+        title: config.title,
+        head,
+        headTags: config.headTags,
+    });
+});
+/**
+ * Compute all (pathname, handler) pairs from prerender routes.
+ */
+const expandRoutes = (prerenderRoutes, basePath) => Effect.all(prerenderRoutes.flatMap(({ handler, paramSets }) => paramSets.map((params) => handler.route
+    .interpolate(params)
+    .pipe(Effect.map((pathname) => ({ pathname: basePath + pathname, handler }))))));
+/**
+ * Write an HTML string to the appropriate file path under outDir.
+ * Creates directories as needed.
+ *
+ * /           → outDir/index.html
+ * /about      → outDir/about/index.html
+ * /posts/1    → outDir/posts/1/index.html
+ */
+const writePageFile = (outDir, pathname, html) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const filePath = pathname === "/" || pathname === ""
+        ? path.join(outDir, "index.html")
+        : path.join(outDir, pathname, "index.html");
+    yield* fs.makeDirectory(path.dirname(filePath), { recursive: true });
+    yield* fs.writeFileString(filePath, html);
+});
+/**
+ * Pre-render all routes marked with `prerender: true` to static HTML files.
+ */
+export const build = (options) => Effect.gen(function* () {
+    const { router, handlersLayer, appShell, outDir, basePath = "", clientScript, title, headTags, } = options;
+    // Resolve handlers to get prerender routes
+    const handlers = yield* Effect.provide(Effect.flatMap(RouterHandlers, (h) => getPrerenderRoutes(h)), handlersLayer);
+    const routes = yield* expandRoutes(handlers, basePath);
+    if (routes.length === 0) {
+        yield* Effect.log("No prerender routes found.");
+        return;
+    }
+    yield* Effect.log(`Pre-rendering ${routes.length} page(s)...`);
+    // Render all routes
+    const pages = yield* Effect.all(routes.map(({ pathname }) => renderRoute({
+        router,
+        handlersLayer,
+        appShell,
+        pathname,
+        basePath,
+        clientScript,
+        title,
+        headTags,
+    }).pipe(Effect.map((html) => ({ pathname, html })))));
+    // Write all pages to disk
+    yield* Effect.forEach(pages, ({ pathname, html }) => Effect.gen(function* () {
+        yield* writePageFile(outDir, pathname, html);
+        yield* Effect.log(`  ${pathname} → ${outDir}${pathname === "/" ? "/index.html" : `${pathname}/index.html`}`);
+    }), { discard: true });
+    yield* Effect.log(`Done. ${pages.length} page(s) written to ${outDir}/`);
+});
+//# sourceMappingURL=build.js.map

package/dist/cli/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/cli/build.ts"],"names":[],"mappings":"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"}

package/dist/cli/cli.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * fibrae CLI — static site generation for fibrae apps.
+ *
+ * Commands:
+ *   fibrae build    Pre-render routes and build client bundle
+ *   fibrae dev      Start Vite dev server with on-demand SSR
+ *   fibrae preview  Serve the built output
+ */
+export {};

package/dist/cli/cli.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+/**
+ * fibrae CLI — static site generation for fibrae apps.
+ *
+ * Commands:
+ *   fibrae build    Pre-render routes and build client bundle
+ *   fibrae dev      Start Vite dev server with on-demand SSR
+ *   fibrae preview  Serve the built output
+ */
+const [command] = process.argv.slice(2);
+const commands = {
+    async build() {
+        const { build } = await import("vite");
+        await build();
+    },
+    async dev() {
+        const { createServer } = await import("vite");
+        const server = await createServer({ server: { open: true } });
+        await server.listen();
+        server.printUrls();
+    },
+    async preview() {
+        const { preview } = await import("vite");
+        const server = await preview();
+        server.printUrls();
+    },
+};
+const run = commands[command ?? ""];
+if (!run) {
+    console.log(`Usage: fibrae <command>
+
+Commands:
+  build    Pre-render routes and build client bundle
+  dev      Start Vite dev server with on-demand SSR
+  preview  Serve the built output`);
+    process.exit(command ? 1 : 0);
+}
+run().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+export {};
+//# sourceMappingURL=cli.js.map

package/dist/cli/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli/cli.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AAEH,MAAM,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAExC,MAAM,QAAQ,GAAwC;IACpD,KAAK,CAAC,KAAK;QACT,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,KAAK,EAAE,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QAC9D,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;QACtB,MAAM,CAAC,SAAS,EAAE,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,OAAO,EAAE,CAAC;QAC/B,MAAM,CAAC,SAAS,EAAE,CAAC;IACrB,CAAC;CACF,CAAC;AAEF,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;AAEpC,IAAI,CAAC,GAAG,EAAE,CAAC;IACT,OAAO,CAAC,GAAG,CAAC;;;;;kCAKoB,CAAC,CAAC;IAClC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAClB,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/cli/config.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Configuration types for fibrae-cli.
+ */
+import type { HeadData } from "../router/RouterBuilder.js";
+export interface FibraeConfig {
+    /** Module path that exports { router, handlers, App } */
+    readonly entry: string;
+    /** Client hydration entry point */
+    readonly client: string;
+    /** Output directory (default: "dist") */
+    readonly outDir?: string;
+    /** Base path prefix for routes */
+    readonly basePath?: string;
+    /** Default page title */
+    readonly title?: string;
+    /** Global head tags injected into every page (fonts, analytics, meta, etc.) */
+    readonly headTags?: HeadData;
+}
+export declare const defineConfig: (config: FibraeConfig) => FibraeConfig;

package/dist/cli/config.js

@@ -0,0 +1,5 @@
+/**
+ * Configuration types for fibrae-cli.
+ */
+export const defineConfig = (config) => config;
+//# sourceMappingURL=config.js.map

package/dist/cli/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/cli/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmBH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAoB,EAAgB,EAAE,CAAC,MAAM,CAAC"}

package/dist/cli/html.d.ts

@@ -0,0 +1,13 @@
+import type { HeadData } from "../router/RouterBuilder.js";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+export interface PageOptions {
+    readonly html: string;
+    readonly dehydratedState: ReadonlyArray<unknown>;
+    readonly clientScript?: string;
+    readonly title?: string;
+    readonly head: Option.Option<HeadData>;
+    /** Global head tags from config, merged with per-route head */
+    readonly headTags?: HeadData;
+}
+export declare const buildPage: (options: PageOptions) => Effect.Effect<string, unknown, never>;

package/dist/cli/html.js

@@ -0,0 +1,101 @@
+/**
+ * HTML page template for static site generation.
+ *
+ * Uses fibrae JSX to generate full HTML documents wrapping
+ * pre-rendered content with dehydrated state and client scripts.
+ */
+import { h } from "../h.js";
+import { renderToString } from "../server.js";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Array from "effect/Array";
+const metaToElement = (meta) => {
+    if ("title" in meta)
+        return Option.none();
+    if ("charset" in meta)
+        return Option.some(h("meta", { charset: meta.charset }));
+    if ("script:ld+json" in meta)
+        return Option.some(h("script", {
+            type: "application/ld+json",
+            dangerouslySetInnerHTML: JSON.stringify(meta["script:ld+json"]),
+        }));
+    if ("name" in meta)
+        return Option.some(h("meta", { name: meta.name, content: meta.content }));
+    if ("property" in meta)
+        return Option.some(h("meta", { property: meta.property, content: meta.content }));
+    if ("httpEquiv" in meta)
+        return Option.some(h("meta", { "http-equiv": meta.httpEquiv, content: meta.content }));
+    if ("tagName" in meta) {
+        const { tagName, ...attrs } = meta;
+        return Option.some(h(tagName, attrs));
+    }
+    return Option.none();
+};
+/**
+ * Get the dedup key for a meta descriptor.
+ * Per TanStack Router pattern: meta tags with the same name/property are
+ * deduplicated, with per-route tags winning over global tags.
+ */
+const metaKey = (meta) => {
+    if ("name" in meta)
+        return `name:${meta.name}`;
+    if ("property" in meta)
+        return `property:${meta.property}`;
+    if ("httpEquiv" in meta)
+        return `httpEquiv:${meta.httpEquiv}`;
+    if ("charset" in meta)
+        return "charset";
+    return undefined;
+};
+/**
+ * Merge meta arrays with deduplication. Per-route entries override globals
+ * when they share the same name/property/httpEquiv key.
+ */
+const dedupMeta = (global, perRoute) => {
+    const routeKeys = new Set(perRoute.map(metaKey).filter(Boolean));
+    const filtered = global.filter((m) => {
+        const key = metaKey(m);
+        return key === undefined || !routeKeys.has(key);
+    });
+    return [...filtered, ...perRoute];
+};
+const buildHeadChildren = (title, head, headTags) => {
+    const headData = Option.getOrUndefined(head);
+    // Per-route title wins, then global headTags title, then config title
+    const pageTitle = headData?.title ?? headTags?.title ?? title;
+    // Merge global headTags with per-route head.
+    // Meta tags are deduplicated by name/property (per-route wins).
+    // Links and scripts are concatenated (global first, then per-route).
+    const allMeta = dedupMeta(headTags?.meta ?? [], headData?.meta ?? []);
+    const allLinks = [...(headTags?.links ?? []), ...(headData?.links ?? [])];
+    const allScripts = [...(headTags?.scripts ?? []), ...(headData?.scripts ?? [])];
+    return [
+        h("meta", { charset: "UTF-8" }),
+        h("meta", { name: "viewport", content: "width=device-width, initial-scale=1.0" }),
+        ...Option.match(Option.fromNullable(pageTitle), {
+            onNone: () => [],
+            onSome: (t) => [h("title", {}, [t])],
+        }),
+        ...Array.filterMap(allMeta, metaToElement),
+        ...allLinks.map((attrs) => h("link", attrs)),
+        ...allScripts.flatMap((script) => script.src
+            ? [h("script", { type: script.type, src: script.src })]
+            : script.content
+                ? [h("script", { type: script.type, dangerouslySetInnerHTML: script.content })]
+                : []),
+    ];
+};
+const PageShell = (props) => h("html", { lang: "en" }, [
+    h("head", {}, buildHeadChildren(props.title, props.head, props.headTags)),
+    h("body", {}, [
+        h("div", { id: "root", dangerouslySetInnerHTML: props.html }),
+        h("script", {
+            type: "application/json",
+            id: "__fibrae-state__",
+            dangerouslySetInnerHTML: JSON.stringify(props.dehydratedState),
+        }),
+        ...(props.clientScript ? [h("script", { type: "module", src: props.clientScript })] : []),
+    ]),
+]);
+export const buildPage = (options) => renderToString(PageShell(options)).pipe(Effect.map(({ html }) => `<!DOCTYPE html>\n${html}`));
+//# sourceMappingURL=html.js.map

package/dist/cli/html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.js","sourceRoot":"","sources":["../../src/cli/html.ts"],"names":[],"mappings":"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"}

package/dist/cli/index.d.ts

@@ -0,0 +1,6 @@
+export { buildPage } from "./html.js";
+export type { PageOptions } from "./html.js";
+export { build } from "./build.js";
+export type { BuildOptions } from "./build.js";
+export { defineConfig } from "./config.js";
+export type { FibraeConfig } from "./config.js";

package/dist/cli/index.js

@@ -0,0 +1,4 @@
+export { buildPage } from "./html.js";
+export { build } from "./build.js";
+export { defineConfig } from "./config.js";
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/cli/vite-plugin.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Vite plugin for fibrae static site generation.
+ *
+ * Hooks into Vite's build pipeline to pre-render routes after the client build.
+ * In dev mode, provides on-demand SSR middleware.
+ */
+import type { Plugin } from "vite";
+import type { FibraeConfig } from "./config.js";
+export declare const fibrae: (config: FibraeConfig) => Plugin<any>;

package/dist/cli/vite-plugin.js

@@ -0,0 +1,143 @@
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Layer from "effect/Layer";
+import { NodeContext } from "@effect/platform-node";
+import { Router, RouterHandlers } from "../router/index.js";
+import { renderToStringWith, SSRAtomRegistryLayer } from "../server.js";
+import { buildPage } from "./html.js";
+/**
+ * Render a single page for the dev server.
+ */
+const renderDevPage = (opts) => Effect.gen(function* () {
+    const serverLayer = Router.serverLayer({
+        router: opts.router,
+        pathname: opts.pathname,
+        search: "",
+        basePath: opts.basePath,
+    });
+    const fullLayer = Layer.provideMerge(serverLayer, Layer.merge(opts.handlersLayer, SSRAtomRegistryLayer));
+    const { html, dehydratedState, head } = yield* Effect.gen(function* () {
+        const { head } = yield* Router.CurrentRouteElement;
+        const renderResult = opts.App
+            ? yield* renderToStringWith(opts.App())
+            : yield* Effect.gen(function* () {
+                const { element } = yield* Router.CurrentRouteElement;
+                const app = opts.appShell ? opts.appShell(element) : element;
+                return yield* renderToStringWith(app);
+            });
+        return { ...renderResult, head };
+    }).pipe(Effect.provide(fullLayer));
+    return yield* buildPage({
+        html,
+        dehydratedState: dehydratedState,
+        clientScript: opts.clientScript,
+        title: opts.title,
+        head,
+        headTags: opts.headTags,
+    });
+});
+/**
+ * Walk the Vite module graph from an entry and collect CSS module URLs.
+ * Injects these as <style> tags in the SSR HTML to prevent FOUC.
+ */
+const collectCss = async (server, entryUrl) => {
+    // Warm the module graph so CSS deps are discovered
+    await server.transformRequest(entryUrl);
+    const seen = new Set();
+    const cssUrls = [];
+    const walk = (mod) => {
+        if (!mod?.id || seen.has(mod.id))
+            return;
+        seen.add(mod.id);
+        if (mod.id.endsWith(".css")) {
+            cssUrls.push(mod.url);
+        }
+        for (const dep of mod.importedModules) {
+            walk(dep);
+        }
+    };
+    walk(await server.moduleGraph.getModuleByUrl(entryUrl));
+    return cssUrls;
+};
+export const fibrae = (config) => {
+    let _resolvedConfig;
+    return {
+        name: "fibrae-ssg",
+        configResolved(resolved) {
+            _resolvedConfig = resolved;
+        },
+        configureServer(server) {
+            server.middlewares.use(async (req, res, next) => {
+                const url = req.url;
+                if (!url || url.startsWith("/@") || url.includes(".")) {
+                    return next();
+                }
+                try {
+                    const appModule = await server.ssrLoadModule(config.entry);
+                    const { router, handlersLayer, appShell, App } = appModule;
+                    if (!router || !handlersLayer) {
+                        return next();
+                    }
+                    // Only SSR routes the router knows about; pass everything else through
+                    if (Option.isNone(router.matchRoute(url))) {
+                        return next();
+                    }
+                    const rawHtml = await Effect.runPromise(renderDevPage({
+                        router,
+                        handlersLayer,
+                        App,
+                        appShell,
+                        pathname: url,
+                        basePath: config.basePath ?? "",
+                        clientScript: config.client,
+                        title: config.title,
+                        headTags: config.headTags,
+                    }));
+                    // Collect CSS from client entry's module graph and inject into <head>
+                    const cssUrls = await collectCss(server, config.client);
+                    const cssTags = cssUrls.map((u) => `<link rel="stylesheet" href="${u}">`).join("\n");
+                    const withCss = cssTags ? rawHtml.replace("</head>", `${cssTags}\n</head>`) : rawHtml;
+                    // Let Vite inject HMR client
+                    const result = await server.transformIndexHtml(url, withCss);
+                    res.setHeader("Content-Type", "text/html");
+                    res.end(result);
+                }
+                catch {
+                    next();
+                }
+            });
+        },
+        async closeBundle() {
+            if (_resolvedConfig.command !== "build")
+                return;
+            const outDir = config.outDir ?? _resolvedConfig.build.outDir ?? "dist";
+            try {
+                const entryPath = new URL(config.entry, `file://${process.cwd()}/`).pathname;
+                const appModule = await import(entryPath);
+                const { router, handlersLayer, appShell } = appModule;
+                if (!router || !handlersLayer) {
+                    console.warn("[fibrae-ssg] Entry module missing router or handlersLayer exports. Skipping SSG.");
+                    return;
+                }
+                const { build: ssgBuild } = await import("./build.js");
+                const clientScript = config.client
+                    ? `/${config.client.replace(/\.tsx?$/, ".js")}`
+                    : undefined;
+                await Effect.runPromise(ssgBuild({
+                    router,
+                    handlersLayer,
+                    appShell: appShell ?? ((el) => el),
+                    outDir,
+                    basePath: config.basePath ?? "",
+                    clientScript,
+                    title: config.title,
+                    headTags: config.headTags,
+                }).pipe(Effect.provide(NodeContext.layer)));
+            }
+            catch (e) {
+                console.error("[fibrae-ssg] Pre-render failed:", e);
+            }
+        },
+    };
+};
+//# sourceMappingURL=vite-plugin.js.map

package/dist/cli/vite-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-plugin.js","sourceRoot":"","sources":["../../src/cli/vite-plugin.ts"],"names":[],"mappings":"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"}

package/dist/components.d.ts

@@ -1,12 +1,11 @@
 import * as Context from "effect/Context";
 import * as Effect from "effect/Effect";
-import * as Stream from "effect/Stream";
 import { type ComponentError, type VElement } from "./shared.js";
 declare const ErrorBoundaryChannel_base: Context.TagClass<ErrorBoundaryChannel, "ErrorBoundaryChannel", {
     /** Report an error to this boundary. Used by event handlers and stream subscriptions. */
     readonly reportError: (error: unknown) => Effect.Effect<void, never, never>;
     /** Optional unique identifier for this boundary (for debugging/logging) */
-    readonly boundaryId?: string;
+    readonly boundaryId?: string | undefined;
 }>;
 /**
  * Error boundary channel - used by ErrorBoundary for async error reporting.
@@ -33,42 +32,41 @@ export declare class ErrorBoundaryChannel extends ErrorBoundaryChannel_base {
  */
 export declare const Suspense: (props: {
     fallback: VElement;
-    threshold?: number;
-    children?: VElement | VElement[];
+    threshold?: number | undefined;
+    children?: VElement[] | VElement | undefined;
 }) => VElement;
 /**
- * Creates an Effect-native error boundary around children.
+ * Error boundary component — catches errors in its subtree and shows a fallback.
  *
- * Returns a `Stream<VElement, ComponentError, never>` that can be piped with
- * `Stream.catchTags` for fully typed error handling.
+ * Supports recovery: when children re-emit (e.g. route change), the boundary
+ * resets and shows the new content. Children are "parked" during error state
+ * (subscriptions stay alive), similar to how Suspense works.
  *
  * @example
  * ```tsx
- * // Create a boundary with typed error handlers as a wrapper component
- * const SafeApp = () => ErrorBoundary(<App />).pipe(
- *   Stream.catchTags({
- *     RenderError: (e) => Stream.succeed(<div>Render failed: {e.componentName}</div>),
- *     StreamError: (e) => Stream.succeed(<div>Stream failed: {e.phase}</div>),
- *     EventHandlerError: (e) => Stream.succeed(<div>Event {e.eventType} failed</div>),
- *   })
- * );
- *
- * // Use it like any other component
- * <SafeApp />
+ * <ErrorBoundary fallback={(error) => <div>Error: {error._tag}</div>}>
+ *   <RouterOutlet />
+ * </ErrorBoundary>
  * ```
  *
- * **How it works:**
- * 1. `ErrorBoundary()` returns a Stream that first emits a BOUNDARY marker element
- * 2. The renderer detects this marker and sets up error handling
- * 3. If any error occurs in the subtree, the Stream fails with that ComponentError
- * 4. `Stream.catchTags` catches the error and produces a fallback Stream
- * 5. The fallback VElement is rendered in place of the failed content
+ * The `error` parameter is a `ComponentError` union — match on `_tag` for
+ * per-type handling:
  *
- * **Nesting:** Boundaries nest naturally - inner boundary catches first, unhandled
- * errors propagate to outer boundary following Effect/Stream error propagation rules.
+ * ```tsx
+ * const fallback = (error: ComponentError) => {
+ *   switch (error._tag) {
+ *     case "RenderError": return <div>Render failed: {error.componentName}</div>
+ *     case "StreamError": return <div>Stream failed in {error.phase}</div>
+ *     case "EventHandlerError": return <div>Event {error.eventType} failed</div>
+ *   }
+ * }
+ * ```
  *
- * @param children - The VElement(s) to wrap in an error boundary
- * @returns Stream<VElement, ComponentError, never> - pipe with Stream.catchTags to handle errors
+ * @param props.fallback - Function that receives the error and returns fallback UI
+ * @param props.children - Child components to wrap in the error boundary
  */
-export declare const ErrorBoundary: (children: VElement | VElement[]) => Stream.Stream<VElement, ComponentError, never>;
+export declare const ErrorBoundary: (props: {
+    fallback: (error: ComponentError) => VElement;
+    children?: VElement[] | VElement | undefined;
+}) => VElement;
 export {};