fibrae 0.1.0

package/dist/router/RouterOutlet.js

@@ -0,0 +1,132 @@
+/**
+ * RouterOutlet - Reactive route rendering component.
+ *
+ * Subscribes to Navigator.currentRoute and renders the matched route's component.
+ * When route changes, runs the new route's loader and renders the component.
+ *
+ * For SSR hydration, the RouterStateAtom is pre-populated and the loader is skipped
+ * on first render.
+ *
+ * Usage:
+ * ```typescript
+ * function App() {
+ *   return (
+ *     <div>
+ *       <Nav />
+ *       <RouterOutlet />
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+import * as Effect from "effect/Effect";
+import * as Stream from "effect/Stream";
+import * as Option from "effect/Option";
+import { Registry as AtomRegistry } from "@effect-atom/atom";
+import { Navigator } from "./Navigator.js";
+import { RouterHandlers } from "./RouterBuilder.js";
+import { RouterStateAtom } from "./RouterState.js";
+// =============================================================================
+// RouterOutlet Component
+// =============================================================================
+/**
+ * RouterOutlet component for reactive route rendering.
+ *
+ * The RouterOutlet:
+ * 1. Checks if RouterStateAtom has data (SSR hydration case)
+ * 2. Subscribes to Navigator.currentRoute for navigation changes
+ * 3. When route changes, runs the matched route's loader
+ * 4. Updates RouterStateAtom with the full state (for DI access)
+ * 5. Renders the route's component with loader data
+ *
+ * For SSR hydration, the RouterStateAtom is pre-populated by the server,
+ * so the first render uses that data and skips the loader.
+ */
+export function RouterOutlet(_props = {}) {
+    // Track if this is the first render (for SSR hydration)
+    let isFirstRender = true;
+    return Stream.unwrap(Effect.gen(function* () {
+        const navigator = yield* Navigator;
+        const routerHandlers = yield* RouterHandlers;
+        const registry = yield* AtomRegistry.AtomRegistry;
+        // Check if we have hydrated state from SSR
+        const hydratedState = registry.get(RouterStateAtom);
+        // Create a stream from the currentRoute atom (navigation trigger)
+        const routeStream = AtomRegistry.toStream(registry, navigator.currentRoute);
+        // Map route changes to rendered VElements
+        return Stream.mapEffect(routeStream, (currentRoute) => Effect.gen(function* () {
+            if (Option.isNone(currentRoute)) {
+                // No route matched - clear router state and render 404
+                registry.set(RouterStateAtom, Option.none());
+                return {
+                    type: "div",
+                    props: {
+                        children: [
+                            {
+                                type: "TEXT_ELEMENT",
+                                props: { nodeValue: "404 - Not Found", children: [] },
+                            },
+                        ],
+                    },
+                };
+            }
+            const { routeName, params, searchParams } = currentRoute.value;
+            // Get handler for this route
+            const handler = routerHandlers.getHandler(routeName);
+            if (Option.isNone(handler)) {
+                registry.set(RouterStateAtom, Option.none());
+                return {
+                    type: "div",
+                    props: {
+                        children: [
+                            {
+                                type: "TEXT_ELEMENT",
+                                props: {
+                                    nodeValue: `No handler for route: ${routeName}`,
+                                    children: [],
+                                },
+                            },
+                        ],
+                    },
+                };
+            }
+            let loaderData;
+            let routerState;
+            // Check if we should use hydrated SSR state
+            const shouldUseHydratedState = isFirstRender &&
+                Option.isSome(hydratedState) &&
+                hydratedState.value.routeName === routeName;
+            if (shouldUseHydratedState) {
+                // Use SSR-hydrated state
+                routerState = hydratedState.value;
+                loaderData = routerState.loaderData;
+            }
+            else {
+                // Run the loader
+                const loaderCtx = { path: params, searchParams };
+                loaderData = yield* handler.value.loader(loaderCtx);
+                // Build the new router state
+                routerState = {
+                    routeName,
+                    params,
+                    searchParams,
+                    loaderData,
+                };
+                // Update RouterStateAtom (for DI access by other components)
+                registry.set(RouterStateAtom, Option.some(routerState));
+            }
+            // Mark first render complete
+            isFirstRender = false;
+            // Render the component with both props patterns:
+            // 1. Traditional props (loaderData, path, searchParams)
+            // 2. Components can also access via RouterStateAtom/RouterStateService
+            const element = handler.value.component({
+                loaderData,
+                path: params,
+                searchParams,
+            });
+            return element;
+        }));
+    }));
+}
+//# sourceMappingURL=RouterOutlet.js.map

package/dist/router/RouterOutlet.js.map

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

package/dist/router/RouterState.d.ts

@@ -0,0 +1,102 @@
+/**
+ * RouterState - Unified serializable state for the router.
+ *
+ * Contains everything needed to render the current route:
+ * - routeName: The matched route's name
+ * - params: Decoded path parameters
+ * - searchParams: Query string parameters
+ * - loaderData: Data returned by the route's loader
+ *
+ * This atom is:
+ * - Serializable for SSR hydration
+ * - Updated on navigation
+ * - Accessible via Effect DI
+ */
+import * as Schema from "effect/Schema";
+import * as Option from "effect/Option";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import { Atom, Registry as AtomRegistry } from "@effect-atom/atom";
+/**
+ * Complete router state including loader data.
+ * This is what gets serialized for SSR and hydrated on client.
+ */
+export interface RouterState {
+    readonly routeName: string;
+    readonly params: Record<string, unknown>;
+    readonly searchParams: Record<string, string>;
+    readonly loaderData: unknown;
+}
+/**
+ * Schema for RouterState - used for serialization.
+ *
+ * Note: loaderData uses Schema.Unknown since the actual type
+ * is inferred from the loader Effect return type.
+ */
+export declare const RouterStateSchema: Schema.Struct<{
+    routeName: typeof Schema.String;
+    params: Schema.Record$<typeof Schema.String, typeof Schema.Unknown>;
+    searchParams: Schema.Record$<typeof Schema.String, typeof Schema.String>;
+    loaderData: typeof Schema.Unknown;
+}>;
+/**
+ * The router state atom - a serializable atom containing the full route state.
+ *
+ * When None, no route is matched.
+ * When Some, contains the matched route info and loader data.
+ *
+ * This atom is automatically:
+ * - Dehydrated during SSR (included in __FIBRAE_STATE__)
+ * - Hydrated on client (restored from __FIBRAE_STATE__)
+ */
+export declare const RouterStateAtom: Atom.Writable<Option.Option<RouterState>, Option.Option<RouterState>> & Atom.Serializable<Schema.Option<Schema.Struct<{
+    routeName: typeof Schema.String;
+    params: Schema.Record$<typeof Schema.String, typeof Schema.Unknown>;
+    searchParams: Schema.Record$<typeof Schema.String, typeof Schema.String>;
+    loaderData: typeof Schema.Unknown;
+}>>>;
+declare const RouterStateService_base: Context.TagClass<RouterStateService, "@fibrae/router/RouterStateService", {
+    /**
+     * Get the current router state.
+     */
+    readonly get: Effect.Effect<Option.Option<RouterState>, never, AtomRegistry.AtomRegistry>;
+    /**
+     * Set the router state (used internally by Navigator).
+     */
+    readonly set: (state: Option.Option<RouterState>) => Effect.Effect<void, never, AtomRegistry.AtomRegistry>;
+    /**
+     * The underlying atom (for reactive subscriptions).
+     */
+    readonly atom: Atom.Writable<Option.Option<RouterState>, Option.Option<RouterState>>;
+}>;
+/**
+ * Service tag for accessing router state via Effect DI.
+ *
+ * Usage in components:
+ * ```typescript
+ * const Component = () => Effect.gen(function* () {
+ *   const state = yield* RouterStateService;
+ *   if (Option.isSome(state)) {
+ *     const { loaderData, params } = state.value;
+ *     // ...
+ *   }
+ * });
+ * ```
+ */
+export declare class RouterStateService extends RouterStateService_base {
+}
+/**
+ * Get the current router state.
+ */
+export declare const getRouterState: Effect.Effect<Option.Option<RouterState>, never, RouterStateService | AtomRegistry.AtomRegistry>;
+/**
+ * Get the current loader data (typed by the caller).
+ * Returns None if no route is matched.
+ */
+export declare const getLoaderData: <T>() => Effect.Effect<Option.Option<T>, never, RouterStateService | AtomRegistry.AtomRegistry>;
+/**
+ * Get the current route params.
+ * Returns None if no route is matched.
+ */
+export declare const getRouteParams: Effect.Effect<Option.Option<Record<string, unknown>>, never, RouterStateService | AtomRegistry.AtomRegistry>;
+export {};

package/dist/router/RouterState.js

@@ -0,0 +1,94 @@
+/**
+ * RouterState - Unified serializable state for the router.
+ *
+ * Contains everything needed to render the current route:
+ * - routeName: The matched route's name
+ * - params: Decoded path parameters
+ * - searchParams: Query string parameters
+ * - loaderData: Data returned by the route's loader
+ *
+ * This atom is:
+ * - Serializable for SSR hydration
+ * - Updated on navigation
+ * - Accessible via Effect DI
+ */
+import * as Schema from "effect/Schema";
+import * as Option from "effect/Option";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import { Atom, Registry as AtomRegistry } from "@effect-atom/atom";
+/**
+ * Schema for RouterState - used for serialization.
+ *
+ * Note: loaderData uses Schema.Unknown since the actual type
+ * is inferred from the loader Effect return type.
+ */
+export const RouterStateSchema = Schema.Struct({
+    routeName: Schema.String,
+    params: Schema.Record({ key: Schema.String, value: Schema.Unknown }),
+    searchParams: Schema.Record({ key: Schema.String, value: Schema.String }),
+    loaderData: Schema.Unknown,
+});
+// =============================================================================
+// Serializable Atom
+// =============================================================================
+/**
+ * The router state atom - a serializable atom containing the full route state.
+ *
+ * When None, no route is matched.
+ * When Some, contains the matched route info and loader data.
+ *
+ * This atom is automatically:
+ * - Dehydrated during SSR (included in __FIBRAE_STATE__)
+ * - Hydrated on client (restored from __FIBRAE_STATE__)
+ */
+export const RouterStateAtom = Atom.make(Option.none()).pipe(Atom.serializable({
+    key: "@fibrae/router/state",
+    schema: Schema.Option(RouterStateSchema),
+}));
+// =============================================================================
+// Service Tag
+// =============================================================================
+/**
+ * Service tag for accessing router state via Effect DI.
+ *
+ * Usage in components:
+ * ```typescript
+ * const Component = () => Effect.gen(function* () {
+ *   const state = yield* RouterStateService;
+ *   if (Option.isSome(state)) {
+ *     const { loaderData, params } = state.value;
+ *     // ...
+ *   }
+ * });
+ * ```
+ */
+export class RouterStateService extends Context.Tag("@fibrae/router/RouterStateService")() {
+}
+// =============================================================================
+// Convenience Accessors
+// =============================================================================
+/**
+ * Get the current router state.
+ */
+export const getRouterState = Effect.gen(function* () {
+    const service = yield* RouterStateService;
+    return yield* service.get;
+});
+/**
+ * Get the current loader data (typed by the caller).
+ * Returns None if no route is matched.
+ */
+export const getLoaderData = () => Effect.gen(function* () {
+    const state = yield* getRouterState;
+    return Option.map(state, (s) => s.loaderData);
+});
+/**
+ * Get the current route params.
+ * Returns None if no route is matched.
+ */
+export const getRouteParams = Effect.gen(function* () {
+    const state = yield* getRouterState;
+    return Option.map(state, (s) => s.params);
+});
+//# sourceMappingURL=RouterState.js.map

package/dist/router/RouterState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouterState.js","sourceRoot":"","sources":["../../src/router/RouterState.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAiBnE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7C,SAAS,EAAE,MAAM,CAAC,MAAM;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IACpE,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IACzE,UAAU,EAAE,MAAM,CAAC,OAAO;CAC3B,CAAC,CAAC;AAEH,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CACtC,MAAM,CAAC,IAAI,EAAE,CACd,CAAC,IAAI,CACJ,IAAI,CAAC,YAAY,CAAC;IAChB,GAAG,EAAE,sBAAsB;IAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC;CACzC,CAAC,CACH,CAAC;AAEF,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,kBAAmB,SAAQ,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,EAkBrF;CAAG;AAEN,gFAAgF;AAChF,wBAAwB;AACxB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAIvB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IACtB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,kBAAkB,CAAC;IAC1C,OAAO,KAAK,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;AAC5B,CAAC,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,GAI3B,EAAE,CACF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,cAAc,CAAC;IACpC,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAe,CAAC,CAAC;AACrD,CAAC,CAAC,CAAC;AAEL;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAIvB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IACtB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,cAAc,CAAC;IACpC,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAC5C,CAAC,CAAC,CAAC"}

package/dist/router/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Router module exports.
+ *
+ * Provides Effect-first routing with the HttpApi pattern:
+ * - Route declarations with schema-validated params
+ * - RouterBuilder for handler implementation
+ * - History service for navigation
+ * - Type-safe navigation
+ */
+export * as Route from "./Route.js";
+export * as Router from "./Router.js";
+export * as RouterBuilder from "./RouterBuilder.js";
+export * as History from "./History.js";
+export * as Navigator from "./Navigator.js";
+export * as RouterState from "./RouterState.js";
+export type { LoaderContext, ComponentProps, HandlerConfig, RouteHandler, GroupHandlers, } from "./RouterBuilder.js";
+export { RouterHandlers } from "./RouterBuilder.js";
+export type { HistoryLocation, HistoryService } from "./History.js";
+export { History as HistoryTag, BrowserHistoryLive, MemoryHistoryLive } from "./History.js";
+export type { CurrentRoute, NavigateOptions, NavigatorService } from "./Navigator.js";
+export { Navigator as NavigatorTag, NavigatorLive } from "./Navigator.js";
+export type { LinkProps } from "./Link.js";
+export { createLink } from "./Link.js";
+export type { RouterOutletProps } from "./RouterOutlet.js";
+export { RouterOutlet } from "./RouterOutlet.js";
+export type { ServerLayerOptions, BrowserLayerOptions, DehydratedRouterState, SSRRouteResult, } from "./Router.js";
+export { CurrentRouteElement } from "./Router.js";
+export { RouterStateAtom, RouterStateService, RouterStateSchema, getRouterState, getLoaderData, getRouteParams, } from "./RouterState.js";

package/dist/router/index.js

@@ -0,0 +1,31 @@
+/**
+ * Router module exports.
+ *
+ * Provides Effect-first routing with the HttpApi pattern:
+ * - Route declarations with schema-validated params
+ * - RouterBuilder for handler implementation
+ * - History service for navigation
+ * - Type-safe navigation
+ */
+// Route declaration
+export * as Route from "./Route.js";
+// Router and groups
+export * as Router from "./Router.js";
+// Handler implementation
+export * as RouterBuilder from "./RouterBuilder.js";
+// History service
+export * as History from "./History.js";
+// Navigator service
+export * as Navigator from "./Navigator.js";
+// Router state (unified serializable state)
+export * as RouterState from "./RouterState.js";
+export { RouterHandlers } from "./RouterBuilder.js";
+export { History as HistoryTag, BrowserHistoryLive, MemoryHistoryLive } from "./History.js";
+export { Navigator as NavigatorTag, NavigatorLive } from "./Navigator.js";
+export { createLink } from "./Link.js";
+export { RouterOutlet } from "./RouterOutlet.js";
+export { CurrentRouteElement } from "./Router.js";
+// Re-export RouterState utilities for convenience
+// (RouterState type is accessible via RouterState.RouterState namespace)
+export { RouterStateAtom, RouterStateService, RouterStateSchema, getRouterState, getLoaderData, getRouteParams, } from "./RouterState.js";
+//# sourceMappingURL=index.js.map

package/dist/router/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,oBAAoB;AACpB,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC;AAEpC,oBAAoB;AACpB,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AAEtC,yBAAyB;AACzB,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAC;AAEpD,kBAAkB;AAClB,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AAExC,oBAAoB;AACpB,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAE5C,4CAA4C;AAC5C,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAWhD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAIpD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAI5F,OAAO,EAAE,SAAS,IAAI,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAI1E,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAIvC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AASjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,kDAAkD;AAClD,yEAAyE;AACzE,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,kBAAkB,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,55 @@
+import * as Effect from "effect/Effect";
+import * as Scope from "effect/Scope";
+import * as Layer from "effect/Layer";
+import * as Ref from "effect/Ref";
+import * as Option from "effect/Option";
+import * as Context from "effect/Context";
+import { Atom, Registry as AtomRegistry } from "@effect-atom/atom";
+import type { Fiber } from "./shared.js";
+export interface FiberState {
+    currentRoot: Option.Option<Fiber>;
+    wipRoot: Option.Option<Fiber>;
+    nextUnitOfWork: Option.Option<Fiber>;
+    deletions: Fiber[];
+    renderQueue: Set<Fiber>;
+    batchScheduled: boolean;
+    listenerStore: WeakMap<HTMLElement, Record<string, EventListener>>;
+}
+export declare const makeFiberState: () => FiberState;
+export declare const CustomAtomRegistryLayer: Layer.Layer<AtomRegistry.AtomRegistry, never, never>;
+declare const FibraeRuntime_base: Effect.Service.Class<FibraeRuntime, "FibraeRuntime", {
+    readonly accessors: true;
+    readonly dependencies: readonly [Layer.Layer<AtomRegistry.AtomRegistry, never, never>];
+    readonly scoped: Effect.Effect<{
+        registry: AtomRegistry.Registry;
+        rootScope: Scope.CloseableScope;
+        runFork: <XE extends unknown, XA extends unknown>(effect: Effect.Effect<XA, XE, AtomRegistry.AtomRegistry>, options?: import("effect/Runtime").RunForkOptions | undefined) => import("effect/Fiber").RuntimeFiber<XA, XE>;
+        AtomOps: {
+            get: <A>(atom: Atom.Atom<A>) => A;
+            set: <R, W>(atom: Atom.Writable<R, W>, value: W) => void;
+            update: <R, W>(atom: Atom.Writable<R, W>, f: (_: R) => W) => void;
+            modify: <R, W, A>(atom: Atom.Writable<R, W>, f: (_: R) => [returnValue: A, nextValue: W]) => A;
+        };
+        fiberState: Ref.Ref<FiberState>;
+        fullContextRef: Ref.Ref<Context.Context<unknown>>;
+    }, never, Scope.Scope | AtomRegistry.AtomRegistry>;
+}>;
+export declare class FibraeRuntime extends FibraeRuntime_base {
+    static Live: Layer.Layer<FibraeRuntime, never, never>;
+    /**
+     * Layer that provides both FibraeRuntime AND AtomRegistry.
+     * Use this when composing with user layers that need AtomRegistry access.
+     * (FibraeRuntime.Default consumes AtomRegistry internally but doesn't re-export it)
+     */
+    static LiveWithRegistry: Layer.Layer<AtomRegistry.AtomRegistry | FibraeRuntime, never, never>;
+}
+/**
+ * Fork an effect with the full application context.
+ *
+ * The fullContextRef contains ALL services (FibraeRuntime, AtomRegistry, Navigator, etc.)
+ * captured at render() time after all layers are built.
+ *
+ * IMPORTANT: fullContextRef must be set by render() before this is called.
+ */
+export declare const runForkWithRuntime: (runtime: FibraeRuntime) => <A, E>(effect: Effect.Effect<A, E, unknown>) => import("effect/Fiber").RuntimeFiber<unknown, unknown>;
+export {};

package/dist/runtime.js

@@ -0,0 +1,68 @@
+import * as Effect from "effect/Effect";
+import * as Scope from "effect/Scope";
+import * as FiberSet from "effect/FiberSet";
+import * as Layer from "effect/Layer";
+import * as Ref from "effect/Ref";
+import * as Option from "effect/Option";
+import * as Context from "effect/Context";
+import { Atom, Registry as AtomRegistry } from "@effect-atom/atom";
+export const makeFiberState = () => ({
+    currentRoot: Option.none(),
+    wipRoot: Option.none(),
+    nextUnitOfWork: Option.none(),
+    deletions: [],
+    renderQueue: new Set(),
+    batchScheduled: false,
+    listenerStore: new WeakMap(),
+});
+// =============================================================================
+// Runtime Service
+// =============================================================================
+export const CustomAtomRegistryLayer = AtomRegistry.layerOptions({
+    scheduleTask: (f) => f()
+});
+export class FibraeRuntime extends Effect.Service()("FibraeRuntime", {
+    accessors: true,
+    dependencies: [CustomAtomRegistryLayer],
+    scoped: Effect.gen(function* () {
+        const registry = yield* AtomRegistry.AtomRegistry;
+        const rootScope = yield* Scope.make();
+        const runFork = yield* FiberSet.makeRuntime();
+        // Store the full context in a Ref so it can be updated after all layers are built
+        // Initially empty - will be set by render() after user layers are applied
+        const fullContextRef = yield* Ref.make(Context.empty());
+        // Each render tree gets its own fiber state
+        const fiberState = yield* Ref.make(makeFiberState());
+        const AtomOps = {
+            get: (atom) => registry.get(atom),
+            set: (atom, value) => registry.set(atom, value),
+            update: (atom, f) => registry.update(atom, f),
+            modify: (atom, f) => registry.modify(atom, f),
+        };
+        return { registry, rootScope, runFork, AtomOps, fiberState, fullContextRef };
+    }),
+}) {
+    static Live = FibraeRuntime.Default;
+    /**
+     * Layer that provides both FibraeRuntime AND AtomRegistry.
+     * Use this when composing with user layers that need AtomRegistry access.
+     * (FibraeRuntime.Default consumes AtomRegistry internally but doesn't re-export it)
+     */
+    static LiveWithRegistry = Layer.merge(FibraeRuntime.Default, CustomAtomRegistryLayer);
+}
+/**
+ * Fork an effect with the full application context.
+ *
+ * The fullContextRef contains ALL services (FibraeRuntime, AtomRegistry, Navigator, etc.)
+ * captured at render() time after all layers are built.
+ *
+ * IMPORTANT: fullContextRef must be set by render() before this is called.
+ */
+export const runForkWithRuntime = (runtime) => (effect) => {
+    const withContext = Effect.gen(function* () {
+        const fullContext = yield* Ref.get(runtime.fullContextRef);
+        return yield* Effect.provide(effect, fullContext);
+    });
+    return runtime.runFork(withContext);
+};
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/scope-utils.d.ts

@@ -0,0 +1,14 @@
+import * as Effect from "effect/Effect";
+import * as Scope from "effect/Scope";
+import * as Ref from "effect/Ref";
+/**
+ * Clear content by closing the current scope in the Ref and creating a fresh one.
+ * This triggers finalizers that remove DOM nodes and cancel subscriptions.
+ * Returns the new scope for convenience.
+ */
+export declare const clearContentScope: (contentScopeRef: Ref.Ref<Scope.Scope.Closeable>) => Effect.Effect<Scope.Scope.Closeable, never, never>;
+/**
+ * Register a DOM node for cleanup when scope closes.
+ * Removes the node from its parent when the scope is closed.
+ */
+export declare const registerNodeCleanup: (node: Node, scope: Scope.Scope.Closeable) => Effect.Effect<void, never, never>;

package/dist/scope-utils.js

@@ -0,0 +1,29 @@
+import * as Effect from "effect/Effect";
+import * as Scope from "effect/Scope";
+import * as Exit from "effect/Exit";
+import * as Ref from "effect/Ref";
+// =============================================================================
+// Scope Utilities
+// =============================================================================
+/**
+ * Clear content by closing the current scope in the Ref and creating a fresh one.
+ * This triggers finalizers that remove DOM nodes and cancel subscriptions.
+ * Returns the new scope for convenience.
+ */
+export const clearContentScope = (contentScopeRef) => Effect.gen(function* () {
+    const oldScope = yield* Ref.get(contentScopeRef);
+    yield* Scope.close(oldScope, Exit.void);
+    const newScope = yield* Scope.make();
+    yield* Ref.set(contentScopeRef, newScope);
+    return newScope;
+});
+/**
+ * Register a DOM node for cleanup when scope closes.
+ * Removes the node from its parent when the scope is closed.
+ */
+export const registerNodeCleanup = (node, scope) => Scope.addFinalizer(scope, Effect.sync(() => {
+    if (node.parentNode) {
+        node.parentNode.removeChild(node);
+    }
+}));
+//# sourceMappingURL=scope-utils.js.map

package/dist/scope-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-utils.js","sourceRoot":"","sources":["../src/scope-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,GAAG,MAAM,YAAY,CAAC;AAElC,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,eAA+C,EACK,EAAE,CACtD,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACjD,KAAK,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IACrC,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;IAC1C,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC,CAAC;AAEL;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,IAAU,EACV,KAA4B,EACO,EAAE,CACrC,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;IACzC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;AACH,CAAC,CAAC,CAAC,CAAC"}