fibrae 0.1.0

package/dist/index.js

@@ -0,0 +1,28 @@
+// =============================================================================
+// Public API
+// =============================================================================
+// Main render function
+export { render } from "./core.js";
+// Runtime
+export { FibraeRuntime, CustomAtomRegistryLayer } from "./runtime.js";
+// Built-in components
+export { Suspense, ErrorBoundary } from "./components.js";
+// Element creation (JSX factory)
+export { h, createTextElement } from "./h.js";
+// Re-export upstream Effect Atom APIs for consumers
+export { Atom, Registry as AtomRegistry } from "@effect-atom/atom";
+// Router
+export * as Route from "./router/Route.js";
+export * as Router from "./router/Router.js";
+export * as RouterBuilder from "./router/RouterBuilder.js";
+export * as History from "./router/History.js";
+export * as Navigator from "./router/Navigator.js";
+export * as RouterState from "./router/RouterState.js";
+export { RouterHandlers } from "./router/RouterBuilder.js";
+export { History as HistoryTag, BrowserHistoryLive, MemoryHistoryLive } from "./router/History.js";
+export { Navigator as NavigatorTag, NavigatorLive } from "./router/Navigator.js";
+export { createLink } from "./router/Link.js";
+export { RouterOutlet } from "./router/RouterOutlet.js";
+export { CurrentRouteElement } from "./router/Router.js";
+export { RouterStateAtom, RouterStateService, RouterStateSchema, getRouterState, getLoaderData, getRouteParams, } from "./router/RouterState.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF,uBAAuB;AACvB,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,UAAU;AACV,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEtE,sBAAsB;AACtB,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE1D,iCAAiC;AACjC,OAAO,EAAE,CAAC,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAM9C,oDAAoD;AACpD,OAAO,EAAE,IAAI,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEnE,SAAS;AACT,OAAO,KAAK,KAAK,MAAM,mBAAmB,CAAC;AAC3C,OAAO,KAAK,MAAM,MAAM,oBAAoB,CAAC;AAC7C,OAAO,KAAK,aAAa,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,SAAS,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,WAAW,MAAM,yBAAyB,CAAC;AAUvD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAG3D,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGnG,OAAO,EAAE,SAAS,IAAI,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGjF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAQxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,yBAAyB,CAAC"}

package/dist/jsx-runtime/index.d.ts

@@ -0,0 +1,29 @@
+import type * as Effect from "effect/Effect";
+import type * as Stream from "effect/Stream";
+import type { VElement } from "../shared.js";
+export declare const Fragment: "FRAGMENT";
+export type FragmentType = typeof Fragment;
+export type JSXType = typeof Fragment | ((props: object) => VElement | Stream.Stream<VElement> | Effect.Effect<VElement>);
+export type PropsWithChildren<T = object> = T & {
+    children?: VElement | string | (VElement | string)[];
+};
+export declare function jsx(type: JSXType, props: PropsWithChildren<{
+    [key: string]: unknown;
+}> | null, ...children: (VElement | string)[]): VElement;
+export declare const jsxs: typeof jsx;
+export declare const jsxDEV: typeof jsx;
+export declare const h: typeof jsx;
+declare global {
+    namespace JSX {
+        type Element = any;
+        interface IntrinsicElements {
+            [elemName: string]: any;
+        }
+        interface IntrinsicAttributes {
+            key?: string | number;
+        }
+        interface ElementChildrenAttribute {
+            children: {};
+        }
+    }
+}

package/dist/jsx-runtime/index.js

@@ -0,0 +1,61 @@
+// A simple Fragment support for Fibrae
+export const Fragment = "FRAGMENT";
+function createTextElement(text) {
+    return {
+        type: "TEXT_ELEMENT",
+        props: {
+            nodeValue: String(text),
+            children: [],
+        },
+    };
+}
+function normalizeChild(child) {
+    if (child === null || child === undefined || typeof child === "boolean") {
+        return null;
+    }
+    if (typeof child === "string" || typeof child === "number" || typeof child === "bigint") {
+        return createTextElement(child);
+    }
+    // Handle arrays of children
+    if (Array.isArray(child)) {
+        return child.flatMap(c => {
+            const normalized = normalizeChild(c);
+            return normalized === null ? [] : Array.isArray(normalized) ? normalized : [normalized];
+        });
+    }
+    // Assume it's an already properly shaped VElement
+    return child;
+}
+export function jsx(type, props, ...children) {
+    const normalizedProps = props ?? {};
+    let finalChildren = [];
+    // Prefer children from props (automatic JSX runtime) over rest args (classic runtime)
+    if (normalizedProps.children !== undefined) {
+        const ch = normalizedProps.children;
+        const arr = Array.isArray(ch) ? ch : [ch];
+        finalChildren = arr.flatMap(child => {
+            const normalized = normalizeChild(child);
+            return normalized === null ? [] : Array.isArray(normalized) ? normalized : [normalized];
+        });
+    }
+    else if (children.length > 0) {
+        // Fall back to rest args for classic JSX runtime
+        finalChildren = children.flatMap(child => {
+            const normalized = normalizeChild(child);
+            return normalized === null ? [] : Array.isArray(normalized) ? normalized : [normalized];
+        });
+    }
+    return {
+        type: type,
+        props: {
+            ...normalizedProps,
+            children: finalChildren,
+        },
+    };
+}
+export const jsxs = jsx;
+// Development mode JSX transform (used by Bun and other tools)
+export const jsxDEV = jsx;
+// Alias for classic JSX transform (used by esbuild)
+export const h = jsx;
+//# sourceMappingURL=index.js.map

package/dist/jsx-runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/jsx-runtime/index.ts"],"names":[],"mappings":"AAIA,uCAAuC;AACvC,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAmB,CAAC;AAW5C,SAAS,iBAAiB,CAAC,IAA8B;IACvD,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE;YACL,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC;YACvB,QAAQ,EAAE,EAAE;SACb;KACF,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QACxE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxF,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IACD,4BAA4B;IAC5B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;YACvB,MAAM,UAAU,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;YACrC,OAAO,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QAC1F,CAAC,CAAC,CAAC;IACL,CAAC;IACD,kDAAkD;IAClD,OAAO,KAAiB,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,GAAG,CACjB,IAAa,EACb,KAA2D,EAC3D,GAAG,QAA+B;IAElC,MAAM,eAAe,GAAG,KAAK,IAAI,EAAE,CAAC;IAEpC,IAAI,aAAa,GAAe,EAAE,CAAC;IAEnC,sFAAsF;IACtF,IAAI,eAAe,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3C,MAAM,EAAE,GAAG,eAAe,CAAC,QAAQ,CAAC;QACpC,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAE1C,aAAa,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;YAClC,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;YACzC,OAAO,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QAC1F,CAAC,CAAC,CAAC;IACL,CAAC;SAAM,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,iDAAiD;QACjD,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;YACvC,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;YACzC,OAAO,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;QAC1F,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,IAAI,EAAE,IAAmB;QACzB,KAAK,EAAE;YACL,GAAI,eAA0B;YAC9B,QAAQ,EAAE,aAAa;SACxB;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,IAAI,GAAe,GAAG,CAAC;AAEpC,+DAA+D;AAC/D,MAAM,CAAC,MAAM,MAAM,GAAe,GAAG,CAAC;AAEtC,oDAAoD;AACpD,MAAM,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC"}

package/dist/render.d.ts

@@ -0,0 +1,19 @@
+import * as Effect from "effect/Effect";
+import * as Scope from "effect/Scope";
+import { type VElement } from "./shared.js";
+import { FibraeRuntime } from "./runtime.js";
+/**
+ * Recursively render a VElement tree to DOM.
+ * This is the core rendering function that handles:
+ * - Function components (with stream subscriptions and atom reactivity)
+ * - Host elements (DOM nodes)
+ * - Text elements
+ * - Fragments
+ * - Error boundaries
+ *
+ * @param vElement - Virtual element to render
+ * @param parent - Parent DOM node to append to
+ * @param runtime - Fibrae runtime instance
+ * @param parentScope - Optional scope for registering cleanup (used for proper DOM node removal)
+ */
+export declare const renderVElementToDOM: (vElement: VElement, parent: Node, runtime: FibraeRuntime, parentScope?: Scope.Scope.Closeable) => Effect.Effect<void, unknown, never>;

package/dist/render.js

@@ -0,0 +1,325 @@
+import * as Effect from "effect/Effect";
+import * as Stream from "effect/Stream";
+import * as Sink from "effect/Sink";
+import * as Scope from "effect/Scope";
+import * as Exit from "effect/Exit";
+import * as Ref from "effect/Ref";
+import * as Option from "effect/Option";
+import * as Fiber from "effect/Fiber";
+import * as Deferred from "effect/Deferred";
+import * as Context from "effect/Context";
+import * as FiberRef from "effect/FiberRef";
+import { Atom, Registry as AtomRegistry } from "@effect-atom/atom";
+import {} from "./shared.js";
+import { FibraeRuntime, runForkWithRuntime } from "./runtime.js";
+import { setDomProperty, attachEventListeners, isProperty } from "./dom.js";
+import { normalizeToStream, makeTrackingRegistry, subscribeToAtoms } from "./tracking.js";
+import { clearContentScope, registerNodeCleanup } from "./scope-utils.js";
+import { ErrorBoundaryChannel } from "./components.js";
+import { h } from "./h.js";
+// =============================================================================
+// Type Guards
+// =============================================================================
+/**
+ * Check if a type is a function component
+ */
+const isFunctionComponent = (type) => typeof type === "function";
+/**
+ * Check if a type is a host element (string tag)
+ */
+const isHostElement = (type) => typeof type === "string";
+// =============================================================================
+// Render Implementation
+// =============================================================================
+/**
+ * Recursively render a VElement tree to DOM.
+ * This is the core rendering function that handles:
+ * - Function components (with stream subscriptions and atom reactivity)
+ * - Host elements (DOM nodes)
+ * - Text elements
+ * - Fragments
+ * - Error boundaries
+ *
+ * @param vElement - Virtual element to render
+ * @param parent - Parent DOM node to append to
+ * @param runtime - Fibrae runtime instance
+ * @param parentScope - Optional scope for registering cleanup (used for proper DOM node removal)
+ */
+export const renderVElementToDOM = (vElement, parent, runtime, parentScope) => Effect.gen(function* () {
+    const type = vElement.type;
+    if (isFunctionComponent(type)) {
+        // Function component - create wrapper and subscribe to its stream
+        const wrapper = document.createElement("span");
+        wrapper.style.display = "contents";
+        parent.appendChild(wrapper);
+        // Register wrapper cleanup with parent scope if provided
+        if (parentScope) {
+            yield* registerNodeCleanup(wrapper, parentScope);
+        }
+        // Component scope - for atom subscriptions and stream subscriptions
+        const componentScope = yield* Scope.make();
+        // Content scope ref - for rendered children (can be cleared/recreated on re-render)
+        const initialContentScope = yield* Scope.make();
+        const contentScopeRef = yield* Ref.make(initialContentScope);
+        const accessedAtoms = new Set();
+        const trackingRegistry = makeTrackingRegistry(runtime.registry, accessedAtoms);
+        // Capture current runtime context (includes user services like ThemeService, UserService)
+        // FiberRef.currentContext gives us the actual runtime context regardless of static types
+        // We add our tracking registry to override AtomRegistry while preserving other services
+        const currentContext = yield* FiberRef.get(FiberRef.currentContext);
+        const contextWithTracking = Context.add(currentContext, AtomRegistry.AtomRegistry, trackingRegistry);
+        // Invoke component - use Effect.try to catch sync render-time crashes
+        const output = yield* Effect.try({
+            try: () => type(vElement.props),
+            catch: (e) => e
+        }).pipe(Effect.tapError(() => Effect.sync(() => parent.removeChild(wrapper))));
+        // Normalize to stream and provide context (with tracking registry) to it
+        // This ensures user-provided services like ThemeService are available to component Effects
+        const stream = normalizeToStream(output).pipe(Stream.provideContext(contextWithTracking));
+        // Use Stream.peel to properly separate first emission from remaining stream
+        // Provide componentScope so the remaining stream stays valid for the component's lifetime
+        const peelResult = yield* Effect.either(Effect.gen(function* () {
+            const [maybeFirst, remainingStream] = yield* Stream.peel(stream, Sink.head()).pipe(Effect.provideService(Scope.Scope, componentScope));
+            if (Option.isNone(maybeFirst)) {
+                // Empty stream - nothing to render
+                return { rendered: false };
+            }
+            const contentScope = yield* Ref.get(contentScopeRef);
+            yield* renderVElementToDOM(maybeFirst.value, wrapper, runtime, contentScope);
+            // Subscribe to atom changes for reactivity
+            if (accessedAtoms.size > 0) {
+                yield* subscribeToAtoms(accessedAtoms, () => {
+                    // Queue re-render on atom change
+                    runForkWithRuntime(runtime)(Effect.gen(function* () {
+                        // Capture focus state before re-render
+                        const activeElement = document.activeElement;
+                        const hasFocusInWrapper = activeElement && wrapper.contains(activeElement);
+                        const focusData = hasFocusInWrapper && activeElement ? {
+                            tagName: activeElement.tagName,
+                            dataAttributes: Object.fromEntries(Array.from(activeElement.attributes)
+                                .filter(attr => attr.name.startsWith("data-"))
+                                .map(attr => [attr.name, attr.value])),
+                            name: activeElement.getAttribute("name"),
+                            id: activeElement.id,
+                            selectionStart: "selectionStart" in activeElement ? activeElement.selectionStart : null,
+                            selectionEnd: "selectionEnd" in activeElement ? activeElement.selectionEnd : null,
+                        } : null;
+                        // Clear old content via scope (triggers finalizers, removes DOM nodes)
+                        const newContentScope = yield* clearContentScope(contentScopeRef);
+                        const newAccessedAtoms = new Set();
+                        const newTrackingRegistry = makeTrackingRegistry(runtime.registry, newAccessedAtoms);
+                        // Re-use captured context but with new tracking registry
+                        const newContextWithTracking = Context.add(currentContext, AtomRegistry.AtomRegistry, newTrackingRegistry);
+                        // Invoke component - use Effect.try to catch sync render-time crashes
+                        const newOutput = yield* Effect.try({
+                            try: () => type(vElement.props),
+                            catch: (e) => e
+                        });
+                        const newStream = normalizeToStream(newOutput).pipe(Stream.provideContext(newContextWithTracking));
+                        yield* Stream.runForEach(newStream, (reEmitted) => renderVElementToDOM(reEmitted, wrapper, runtime, newContentScope).pipe(Effect.catchAll((e) => Effect.logError("Re-render child error", e))));
+                        // Restore focus after re-render
+                        if (focusData) {
+                            const candidates = wrapper.querySelectorAll(focusData.tagName);
+                            for (const candidate of candidates) {
+                                const el = candidate;
+                                // Match by id first, then name, then data attributes
+                                const matchById = focusData.id && el.id === focusData.id;
+                                const matchByName = focusData.name && el.getAttribute("name") === focusData.name;
+                                const matchByData = Object.entries(focusData.dataAttributes).length > 0 &&
+                                    Object.entries(focusData.dataAttributes).every(([attr, value]) => el.getAttribute(attr) === value);
+                                if (matchById || matchByName || matchByData) {
+                                    el.focus();
+                                    // Restore cursor position for inputs/textareas
+                                    if (focusData.selectionStart !== null && "setSelectionRange" in el) {
+                                        el.setSelectionRange(focusData.selectionStart, focusData.selectionEnd ?? focusData.selectionStart);
+                                    }
+                                    break;
+                                }
+                            }
+                        }
+                    }).pipe(
+                    // Provide captured context to re-render fiber so services (Navigator, etc.) are available
+                    Effect.provide(currentContext), Effect.catchAllCause((cause) => Effect.logError("Re-render error", cause))));
+                }, runtime, componentScope);
+            }
+            // Fork subscription for remaining emissions
+            // Try to report stream errors to error boundary channel if available
+            const maybeErrorChannel = Context.getOption(currentContext, ErrorBoundaryChannel);
+            const streamErrorHandler = Option.match(maybeErrorChannel, {
+                onNone: () => (cause) => Effect.logError("Component stream error (no boundary)", cause),
+                onSome: (channel) => (cause) => channel.reportError(cause)
+            });
+            const subscription = Stream.runForEach(remainingStream, (emitted) => Effect.gen(function* () {
+                // Clear old content via scope
+                const newContentScope = yield* clearContentScope(contentScopeRef);
+                yield* renderVElementToDOM(emitted, wrapper, runtime, newContentScope).pipe(Effect.catchAll((e) => Effect.logError("Stream emission render error", e)));
+            })).pipe(Effect.catchAllCause(streamErrorHandler));
+            yield* Effect.forkIn(subscription, componentScope);
+            return { rendered: true };
+        }));
+        if (peelResult._tag === "Left") {
+            // Stream error before/during first emission - propagate
+            const contentScope = yield* Ref.get(contentScopeRef);
+            yield* Scope.close(contentScope, Exit.void);
+            yield* Scope.close(componentScope, Exit.void);
+            parent.removeChild(wrapper);
+            return yield* Effect.fail(peelResult.left);
+        }
+    }
+    else if (type === "TEXT_ELEMENT") {
+        // Text node
+        const textNode = document.createTextNode(String(vElement.props.nodeValue ?? ""));
+        parent.appendChild(textNode);
+        // Register text node cleanup with parent scope if provided
+        if (parentScope) {
+            yield* registerNodeCleanup(textNode, parentScope);
+        }
+    }
+    else if (type === "FRAGMENT") {
+        // Fragment - render children directly into parent (propagate errors)
+        const children = vElement.props.children ?? [];
+        for (const child of children) {
+            yield* renderVElementToDOM(child, parent, runtime, parentScope);
+        }
+    }
+    else if (type === "ERROR_BOUNDARY") {
+        // Error boundary - wrap child rendering in error catching
+        // Also catches async errors from event handlers and streams via ErrorBoundaryChannel
+        const wrapper = document.createElement("span");
+        wrapper.style.display = "contents";
+        parent.appendChild(wrapper);
+        // Register wrapper cleanup with parent scope if provided
+        if (parentScope) {
+            yield* registerNodeCleanup(wrapper, parentScope);
+        }
+        const fallback = vElement.props.fallback;
+        const onError = vElement.props.onError;
+        const children = vElement.props.children;
+        // Create content scope for children - wrapped in Ref so async error handler can access it
+        const contentScopeRef = yield* Ref.make(yield* Scope.make());
+        // Create error channel for async error reporting
+        const errorDeferred = yield* Deferred.make();
+        const errorChannel = {
+            reportError: (error) => Deferred.fail(errorDeferred, error).pipe(Effect.ignore)
+        };
+        // Flag to track if we've already shown fallback (to prevent double-triggering)
+        const hasTriggeredRef = yield* Ref.make(false);
+        // Helper to render fallback (used by both sync and async error paths)
+        const renderFallback = (error) => Effect.gen(function* () {
+            const alreadyTriggered = yield* Ref.getAndSet(hasTriggeredRef, true);
+            if (alreadyTriggered)
+                return; // Already showing fallback
+            // Close content scope (cleans up DOM nodes), create fallback scope
+            const oldContentScope = yield* Ref.get(contentScopeRef);
+            yield* Scope.close(oldContentScope, Exit.void);
+            const fallbackScope = yield* Scope.make();
+            yield* Ref.set(contentScopeRef, fallbackScope);
+            onError?.(error);
+            yield* Effect.logError("ErrorBoundary caught error", error);
+            yield* renderVElementToDOM(fallback, wrapper, runtime, fallbackScope).pipe(Effect.catchAll((e) => Effect.logError("ErrorBoundary fallback render error", e)));
+        });
+        // Fork listener for async errors (event handlers, stream failures)
+        yield* Effect.fork(Deferred.await(errorDeferred).pipe(Effect.catchAllCause((cause) => renderFallback(cause))));
+        // Try to render children with error channel in context, catch sync errors
+        const contentScope = yield* Ref.get(contentScopeRef);
+        const renderResult = yield* Effect.either(Effect.forEach(children, (child) => renderVElementToDOM(child, wrapper, runtime, contentScope), { discard: true }).pipe(Effect.provideService(ErrorBoundaryChannel, errorChannel)));
+        if (renderResult._tag === "Left") {
+            // Sync error during render - render fallback
+            yield* renderFallback(renderResult.left);
+        }
+    }
+    else if (type === "SUSPENSE") {
+        // Suspense boundary - show fallback while children are loading
+        // Uses proper DOM insertion/removal (not CSS visibility hacks)
+        // Children are rendered to a detached container; if they complete within threshold, 
+        // we append directly. If timeout fires first, we show fallback then swap when ready.
+        const fallback = vElement.props.fallback;
+        const threshold = vElement.props.threshold ?? 100;
+        const children = vElement.props.children;
+        const childFragment = h("FRAGMENT", {}, children);
+        // Create a DETACHED container for children (not in DOM yet)
+        // Using display:contents so it doesn't affect layout when inserted
+        const childWrapper = document.createElement("span");
+        childWrapper.style.display = "contents";
+        // Create scopes for each container
+        const fallbackScope = yield* Scope.make();
+        const childScope = yield* Scope.make();
+        // Deferred to signal when children have completed first render
+        const childrenReady = yield* Deferred.make();
+        // Fork: render children into DETACHED container, signal when done
+        const childFiber = yield* Effect.fork(Effect.gen(function* () {
+            yield* renderVElementToDOM(childFragment, childWrapper, runtime, childScope);
+            yield* Deferred.succeed(childrenReady, void 0);
+        }).pipe(Effect.catchAll((e) => Deferred.fail(childrenReady, e))));
+        // Race: wait for children vs timeout
+        const childrenWon = yield* Effect.race(Deferred.await(childrenReady).pipe(Effect.as(true)), Effect.sleep(`${threshold} millis`).pipe(Effect.as(false)));
+        if (childrenWon) {
+            // Children completed before timeout - append directly, skip fallback entirely
+            parent.appendChild(childWrapper);
+            if (parentScope) {
+                yield* registerNodeCleanup(childWrapper, parentScope);
+            }
+            // Clean up unused fallback scope
+            yield* Scope.close(fallbackScope, Exit.void);
+        }
+        else {
+            // Timeout fired first - render fallback to DOM while waiting for children
+            const fallbackWrapper = document.createElement("span");
+            fallbackWrapper.style.display = "contents";
+            parent.appendChild(fallbackWrapper);
+            if (parentScope) {
+                yield* registerNodeCleanup(fallbackWrapper, parentScope);
+            }
+            yield* renderVElementToDOM(fallback, fallbackWrapper, runtime, fallbackScope);
+            // Wait for children to complete (they're still rendering in background)
+            const childResult = yield* Effect.either(Deferred.await(childrenReady));
+            if (childResult._tag === "Right") {
+                // Children completed successfully - swap: remove fallback, insert children
+                fallbackWrapper.remove();
+                parent.appendChild(childWrapper);
+                if (parentScope) {
+                    yield* registerNodeCleanup(childWrapper, parentScope);
+                }
+                // Clean up fallback scope (stops any streams/effects in fallback)
+                yield* Scope.close(fallbackScope, Exit.void);
+            }
+            else {
+                // Children failed - keep showing fallback, propagate error
+                // (ErrorBoundary above should catch this)
+                yield* Fiber.interrupt(childFiber);
+                yield* Scope.close(childScope, Exit.void);
+                return yield* Effect.fail(childResult.left);
+            }
+        }
+    }
+    else if (isHostElement(type)) {
+        // Regular host element (div, span, button, etc.)
+        const el = document.createElement(type);
+        // Apply properties
+        for (const [key, value] of Object.entries(vElement.props)) {
+            if (isProperty(key)) {
+                setDomProperty(el, key, value);
+            }
+        }
+        // Attach event listeners - uses runForkWithRuntime internally for full context
+        attachEventListeners(el, vElement.props, runtime);
+        // Handle ref
+        const ref = vElement.props.ref;
+        if (ref && typeof ref === "object" && "current" in ref) {
+            ref.current = el;
+        }
+        parent.appendChild(el);
+        // Register element cleanup with parent scope if provided
+        if (parentScope) {
+            yield* registerNodeCleanup(el, parentScope);
+        }
+        // Create scope for children of this element
+        const childScope = yield* Scope.make();
+        // Render children (propagate errors)
+        const children = vElement.props.children ?? [];
+        for (const child of children) {
+            yield* renderVElementToDOM(child, el, runtime, childScope);
+        }
+    }
+});
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

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

package/dist/router/History.d.ts

@@ -0,0 +1,129 @@
+/**
+ * History service - track and manage browser navigation history.
+ *
+ * Features:
+ * - Current location (pathname, search, hash, state)
+ * - Navigation methods (push, replace, back, forward, go)
+ * - BrowserHistoryLive - real browser history with popstate handling
+ * - MemoryHistoryLive - in-memory history for testing/SSR
+ * - Cleanly manages event listeners with Effect finalizers
+ *
+ * Design:
+ * - Uses Atom for reactive location updates
+ * - Browser history: listens to window.popstate for back/forward
+ * - Memory history: in-memory stack, useful for SSR/testing
+ * - All navigation returns Effects, integrates with Effect runtime
+ */
+import * as Effect from "effect/Effect";
+import * as Context from "effect/Context";
+import * as Layer from "effect/Layer";
+import { Atom, Registry as AtomRegistry } from "@effect-atom/atom";
+/**
+ * Current location - pathname, search, hash, and state.
+ */
+export interface HistoryLocation {
+    readonly pathname: string;
+    readonly search: string;
+    readonly hash: string;
+    readonly state?: unknown;
+}
+/**
+ * History service interface.
+ * Provides location access and navigation methods.
+ */
+export interface HistoryService {
+    /**
+     * Current location atom - reactive and serializable.
+     */
+    readonly location: Atom.Writable<HistoryLocation, HistoryLocation>;
+    /**
+     * Navigate to a new location (push new entry).
+     */
+    readonly push: (path: string, state?: unknown) => Effect.Effect<void, never, AtomRegistry.AtomRegistry>;
+    /**
+     * Replace current location (same entry).
+     */
+    readonly replace: (path: string, state?: unknown) => Effect.Effect<void, never, AtomRegistry.AtomRegistry>;
+    /**
+     * Go back in history.
+     */
+    readonly back: Effect.Effect<void, never, never>;
+    /**
+     * Go forward in history.
+     */
+    readonly forward: Effect.Effect<void, never, never>;
+    /**
+     * Go n entries in history.
+     */
+    readonly go: (n: number) => Effect.Effect<void, never, never>;
+    /**
+     * Check if can go back (optional, simplified version).
+     */
+    readonly canGoBack: Effect.Effect<boolean, never, never>;
+}
+declare const History_base: Context.TagClass<History, "fibrae/History", HistoryService>;
+/**
+ * History service tag for Effect dependency injection.
+ */
+export declare class History extends History_base {
+}
+/**
+ * Browser history layer - real browser history with popstate handling.
+ *
+ * Features:
+ * - Tracks current location in an Atom
+ * - Listens to popstate for back/forward
+ * - Provides push/replace/go navigation methods
+ * - Cleanly removes event listener on scope close
+ * - Properly cleans up event listeners on scope close
+ */
+export declare const BrowserHistoryLive: Layer.Layer<History, never, AtomRegistry.AtomRegistry>;
+/**
+ * Options for creating memory history.
+ */
+export interface MemoryHistoryOptions {
+    /** Initial location (defaults to "/") */
+    readonly initialPathname?: string;
+    /** Initial search params (defaults to "") */
+    readonly initialSearch?: string;
+    /** Initial hash (defaults to "") */
+    readonly initialHash?: string;
+    /** Initial state (defaults to undefined) */
+    readonly initialState?: unknown;
+}
+/**
+ * Create a memory history layer - useful for testing/SSR.
+ *
+ * Features:
+ * - In-memory navigation stack
+ * - Tracks current location in an Atom
+ * - No browser API usage (safe for SSR/testing)
+ * - Supports push/replace/back/forward/go navigation
+ * - Optional initial location/state configuration
+ */
+export declare function MemoryHistoryLive(options?: MemoryHistoryOptions): Layer.Layer<History, never, AtomRegistry.AtomRegistry>;
+/**
+ * Get current location.
+ */
+export declare const getLocation: Effect.Effect<HistoryLocation, never, History | AtomRegistry.AtomRegistry>;
+/**
+ * Push a new location.
+ */
+export declare const push: (path: string, state?: unknown) => Effect.Effect<void, never, History | AtomRegistry.AtomRegistry>;
+/**
+ * Replace current location.
+ */
+export declare const replace: (path: string, state?: unknown) => Effect.Effect<void, never, History | AtomRegistry.AtomRegistry>;
+/**
+ * Go back in history.
+ */
+export declare const back: Effect.Effect<void, never, History>;
+/**
+ * Go forward in history.
+ */
+export declare const forward: Effect.Effect<void, never, History>;
+/**
+ * Go n entries in history.
+ */
+export declare const go: (n: number) => Effect.Effect<void, never, History>;
+export {};