fibrae 0.1.0

package/dist/router/Router.js

@@ -0,0 +1,328 @@
+/**
+ * Router module for organizing and matching routes.
+ *
+ * Mirrors Effect HttpApiGroup/HttpApi patterns:
+ * - Router.group("name") creates a group for organizing routes
+ * - Router.make("name") creates the top-level router
+ * - Routes are added via .add(route)
+ * - Router holds the complete route tree for efficient matching
+ *
+ * SSR Integration:
+ * - Router.serverLayer() - For SSR rendering with loaders
+ * - Router.browserLayer() - For client hydration with initial state
+ */
+import * as Option from "effect/Option";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Context from "effect/Context";
+import { Registry as AtomRegistry } from "@effect-atom/atom";
+import { History, MemoryHistoryLive } from "./History.js";
+import { Navigator, NavigatorLive } from "./Navigator.js";
+import { RouterHandlers } from "./RouterBuilder.js";
+import { RouterStateAtom } from "./RouterState.js";
+/**
+ * Create a route group with the given name.
+ * Routes are added via group.add(route).
+ */
+export function group(name) {
+    return {
+        name,
+        routes: [],
+        add(route) {
+            return {
+                ...this,
+                routes: [...this.routes, route],
+            };
+        },
+    };
+}
+/**
+ * Create a router with the given name.
+ * Groups are added via router.add(group).
+ */
+export function make(name) {
+    return {
+        name,
+        groups: [],
+        add(g) {
+            return {
+                ...this,
+                groups: [...this.groups, g],
+            };
+        },
+        matchRoute(pathname) {
+            // Try to match against each route in each group
+            for (const g of this.groups) {
+                for (const route of g.routes) {
+                    const match = route.match(pathname);
+                    if (Option.isSome(match)) {
+                        return Option.some({
+                            groupName: g.name,
+                            route,
+                            params: match.value,
+                        });
+                    }
+                }
+            }
+            return Option.none();
+        },
+    };
+}
+/**
+ * Service tag for the current route's rendered element.
+ * Used by SSR to provide the matched route's component.
+ */
+export class CurrentRouteElement extends Context.Tag("fibrae/CurrentRouteElement")() {
+}
+/**
+ * Parse search params from URL search string.
+ */
+function parseSearchParams(search) {
+    const params = {};
+    const searchString = search.startsWith("?") ? search.slice(1) : search;
+    if (!searchString)
+        return params;
+    const searchParams = new URLSearchParams(searchString);
+    searchParams.forEach((value, key) => {
+        params[key] = value;
+    });
+    return params;
+}
+/**
+ * Strip basePath prefix from pathname for route matching.
+ */
+function stripBasePath(pathname, basePath) {
+    if (!basePath || basePath === "/") {
+        return pathname;
+    }
+    // Normalize: remove trailing slash from basePath
+    const normalizedBase = basePath.endsWith("/") ? basePath.slice(0, -1) : basePath;
+    if (pathname.startsWith(normalizedBase)) {
+        const stripped = pathname.slice(normalizedBase.length);
+        // Ensure we return "/" not "" for root
+        return stripped || "/";
+    }
+    return pathname;
+}
+/**
+ * Create a server-side layer for SSR rendering.
+ *
+ * This layer:
+ * 1. Matches the pathname against the router
+ * 2. Runs the matched route's loader
+ * 3. Renders the component with loader data
+ * 4. Provides the rendered element and dehydrated state
+ *
+ * Usage in SSR:
+ * ```typescript
+ * const serverLayer = Router.serverLayer({
+ *   router: AppRouter,
+ *   pathname: "/posts/42",
+ *   search: "?sort=date",
+ *   basePath: "/ssr/router"
+ * });
+ *
+ * const { element, dehydratedState } = yield* Router.CurrentRouteElement;
+ * ```
+ */
+export function serverLayer(options) {
+    const { router, pathname, search = "", basePath = "" } = options;
+    const searchParams = parseSearchParams(search);
+    // Strip basePath from pathname for route matching
+    const matchPathname = stripBasePath(pathname, basePath);
+    // Create memory history for SSR (static, no navigation)
+    const historyLayer = MemoryHistoryLive({
+        initialPathname: pathname,
+        initialSearch: search ? `?${search.replace(/^\?/, "")}` : "",
+    });
+    // Create navigator layer with basePath - needs History and AtomRegistry
+    // We provide History here, AtomRegistry comes from outside
+    const navigatorLayer = Layer.provideMerge(NavigatorLive(router, { basePath }), historyLayer);
+    // Create route element layer
+    const routeElementLayer = Layer.effect(CurrentRouteElement, Effect.gen(function* () {
+        const routerHandlers = yield* RouterHandlers;
+        const registry = yield* AtomRegistry.AtomRegistry;
+        // Match route using stripped pathname
+        const match = router.matchRoute(matchPathname);
+        if (Option.isNone(match)) {
+            return yield* Effect.fail(new Error(`No route matched pathname: ${matchPathname}`));
+        }
+        const { route, params } = match.value;
+        // Get handler for this route
+        const handler = routerHandlers.getHandler(route.name);
+        if (Option.isNone(handler)) {
+            return yield* Effect.fail(new Error(`No handler found for route: ${route.name}`));
+        }
+        // Execute loader and render component
+        const loaderCtx = { path: params, searchParams };
+        const loaderData = yield* handler.value.loader(loaderCtx);
+        const element = handler.value.component({
+            loaderData,
+            path: params,
+            searchParams,
+        });
+        const state = {
+            routeName: route.name,
+            params,
+            searchParams,
+            loaderData,
+        };
+        // Set RouterStateAtom so it gets included in dehydrated state
+        registry.set(RouterStateAtom, Option.some(state));
+        return { element, state };
+    }));
+    return Layer.mergeAll(historyLayer, navigatorLayer, routeElementLayer);
+}
+/**
+ * Create a browser layer for client-side hydration.
+ *
+ * This layer:
+ * 1. Sets up browser history with popstate listener
+ * 2. Checks RouterStateAtom for hydrated SSR state
+ * 3. If hydrated, uses that for initial render (skips loader)
+ * 4. Provides Navigator for subsequent navigation
+ *
+ * SSR hydration works automatically via atom hydration - no need to
+ * pass initialState manually. The RouterStateAtom is hydrated from
+ * __FIBRAE_STATE__ before this layer is created.
+ *
+ * Usage in client:
+ * ```typescript
+ * // Hydrate atoms first (includes RouterStateAtom)
+ * hydrate(container, app, window.__FIBRAE_STATE__);
+ *
+ * // Browser layer reads from hydrated RouterStateAtom
+ * const browserLayer = Router.browserLayer({
+ *   router: AppRouter,
+ *   basePath: "/ssr/router"
+ * });
+ * ```
+ */
+export function browserLayer(options) {
+    const { router, basePath = "" } = options;
+    // Import BrowserHistoryLive dynamically to avoid server-side issues
+    // For now, we'll use a scoped effect to create it
+    const historyLayer = Layer.scoped(History, Effect.gen(function* () {
+        const registry = yield* AtomRegistry.AtomRegistry;
+        const { Atom } = yield* Effect.promise(() => import("@effect-atom/atom"));
+        // Create location atom with initial browser location
+        const getBrowserLocation = () => ({
+            pathname: window.location.pathname,
+            search: window.location.search,
+            hash: window.location.hash,
+            state: window.history.state,
+        });
+        const locationAtom = Atom.make(getBrowserLocation());
+        // Subscribe to popstate for browser back/forward
+        const handlePopState = () => {
+            registry.set(locationAtom, getBrowserLocation());
+        };
+        window.addEventListener("popstate", handlePopState);
+        // Cleanup on scope close
+        yield* Effect.addFinalizer(() => Effect.sync(() => {
+            window.removeEventListener("popstate", handlePopState);
+        }));
+        // Track history index for canGoBack
+        let historyIndex = 0;
+        const parseLocation = (href, state) => {
+            const url = href.startsWith("/")
+                ? new URL(href, "http://localhost")
+                : new URL(href);
+            return {
+                pathname: url.pathname,
+                search: url.search,
+                hash: url.hash,
+                state,
+            };
+        };
+        return {
+            location: locationAtom,
+            push: (path, state) => Effect.sync(() => {
+                const location = parseLocation(path, state);
+                const fullPath = `${location.pathname}${location.search}${location.hash}`;
+                window.history.pushState(state, "", fullPath);
+                historyIndex++;
+                registry.set(locationAtom, { ...location, state });
+            }),
+            replace: (path, state) => Effect.sync(() => {
+                const location = parseLocation(path, state);
+                const fullPath = `${location.pathname}${location.search}${location.hash}`;
+                window.history.replaceState(state, "", fullPath);
+                registry.set(locationAtom, { ...location, state });
+            }),
+            back: Effect.sync(() => {
+                window.history.back();
+            }),
+            forward: Effect.sync(() => {
+                window.history.forward();
+            }),
+            go: (n) => Effect.sync(() => {
+                window.history.go(n);
+            }),
+            canGoBack: Effect.sync(() => historyIndex > 0),
+        };
+    }));
+    const navigatorLayer = NavigatorLive(router, { basePath });
+    // Create route element layer - checks RouterStateAtom for hydrated state
+    // If hydrated, uses that; otherwise matches and runs loader
+    const routeElementLayer = Layer.effect(CurrentRouteElement, Effect.gen(function* () {
+        const routerHandlers = yield* RouterHandlers;
+        const registry = yield* AtomRegistry.AtomRegistry;
+        // Check if RouterStateAtom was hydrated from SSR
+        const hydratedState = registry.get(RouterStateAtom);
+        if (Option.isSome(hydratedState)) {
+            // Hydration mode: reuse SSR data from RouterStateAtom
+            const state = hydratedState.value;
+            const handler = routerHandlers.getHandler(state.routeName);
+            if (Option.isNone(handler)) {
+                return yield* Effect.fail(new Error(`No handler found for route: ${state.routeName}`));
+            }
+            // Render component with SSR loader data (skip loader)
+            const element = handler.value.component({
+                loaderData: state.loaderData,
+                path: state.params,
+                searchParams: state.searchParams,
+            });
+            // Cast RouterState to DehydratedRouterState (same shape)
+            const dehydratedState = {
+                routeName: state.routeName,
+                params: state.params,
+                searchParams: state.searchParams,
+                loaderData: state.loaderData,
+            };
+            return { element, state: dehydratedState };
+        }
+        // Non-hydration mode: match and run loader
+        const pathname = window.location.pathname;
+        const matchPathname = stripBasePath(pathname, basePath);
+        const search = window.location.search;
+        const searchParams = parseSearchParams(search);
+        const match = router.matchRoute(matchPathname);
+        if (Option.isNone(match)) {
+            return yield* Effect.fail(new Error(`No route matched pathname: ${matchPathname}`));
+        }
+        const { route, params } = match.value;
+        const handler = routerHandlers.getHandler(route.name);
+        if (Option.isNone(handler)) {
+            return yield* Effect.fail(new Error(`No handler found for route: ${route.name}`));
+        }
+        const loaderCtx = { path: params, searchParams };
+        const loaderData = yield* handler.value.loader(loaderCtx);
+        const element = handler.value.component({
+            loaderData,
+            path: params,
+            searchParams,
+        });
+        const state = {
+            routeName: route.name,
+            params,
+            searchParams,
+            loaderData,
+        };
+        // Set RouterStateAtom for DI access
+        registry.set(RouterStateAtom, Option.some(state));
+        return { element, state };
+    }));
+    return Layer.mergeAll(historyLayer, Layer.provideMerge(navigatorLayer, historyLayer), routeElementLayer);
+}
+//# sourceMappingURL=Router.js.map

package/dist/router/Router.js.map

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

package/dist/router/RouterBuilder.d.ts

@@ -0,0 +1,128 @@
+/**
+ * RouterBuilder module for implementing route handlers.
+ *
+ * Mirrors Effect HttpApiBuilder patterns:
+ * - RouterBuilder.group(router, "groupName", (handlers) => Effect.gen(...))
+ * - handlers.handle("routeName", { loader, component })
+ * - RouterBuilder.router(Router) builds the final Layer
+ */
+import * as Effect from "effect/Effect";
+import * as Context from "effect/Context";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import type { Router } from "./Router.js";
+import type { Route } from "./Route.js";
+import type { VElement } from "../shared.js";
+/**
+ * Context for loader/component execution.
+ * Provides decoded path and search parameters.
+ */
+export interface LoaderContext<PathParams extends Record<string, unknown> = Record<string, unknown>, SearchParams extends Record<string, unknown> = Record<string, unknown>> {
+    readonly path: PathParams;
+    readonly searchParams: SearchParams;
+}
+/**
+ * Component props including loader data and route parameters.
+ */
+export interface ComponentProps<LoaderData = unknown, PathParams extends Record<string, unknown> = Record<string, unknown>, SearchParams extends Record<string, unknown> = Record<string, unknown>> {
+    readonly loaderData: LoaderData;
+    readonly path: PathParams;
+    readonly searchParams: SearchParams;
+}
+/**
+ * Loader return type - can be a plain value or an Effect.
+ * Plain values are automatically wrapped in Effect.succeed.
+ */
+export type LoaderResult<T, E = never, R = never> = T | Effect.Effect<T, E, R>;
+/**
+ * Handler configuration for a route.
+ * Loader fetches data, component renders with that data.
+ *
+ * - loader is optional - defaults to returning null
+ * - loader can return a plain value or an Effect (plain values auto-wrapped)
+ */
+export interface HandlerConfig<LoaderData = unknown, PathParams extends Record<string, unknown> = Record<string, unknown>, SearchParams extends Record<string, unknown> = Record<string, unknown>, R = never, E = never> {
+    readonly loader?: (ctx: LoaderContext<PathParams, SearchParams>) => LoaderResult<LoaderData, E, R>;
+    readonly component: (props: ComponentProps<LoaderData, PathParams, SearchParams>) => VElement;
+}
+/**
+ * A registered route handler (type-erased for storage).
+ * Use executeRoute for type-safe execution.
+ */
+export interface RouteHandler {
+    readonly routeName: string;
+    readonly route: Route;
+    readonly loader: (ctx: LoaderContext) => Effect.Effect<unknown>;
+    readonly component: (props: ComponentProps) => VElement;
+}
+/**
+ * Handlers builder for a route group.
+ * Accumulates handler registrations for routes in the group.
+ */
+export interface GroupHandlers<GroupName extends string = string> {
+    readonly groupName: GroupName;
+    readonly handlers: readonly RouteHandler[];
+    /**
+     * Register a handler for a route in this group.
+     */
+    readonly handle: <RouteName extends string, LoaderData, PathParams extends Record<string, unknown>, SearchParams extends Record<string, unknown>, R, E>(routeName: RouteName, config: HandlerConfig<LoaderData, PathParams, SearchParams, R, E>) => GroupHandlers<GroupName>;
+}
+declare const RouterHandlers_base: Context.TagClass<RouterHandlers, "fibrae/RouterHandlers", {
+    readonly handlers: ReadonlyMap<string, RouteHandler>;
+    readonly getHandler: (routeName: string) => Option.Option<RouteHandler>;
+}>;
+/**
+ * Tag for the RouterHandlers service.
+ * Provides access to all registered handlers.
+ */
+export declare class RouterHandlers extends RouterHandlers_base {
+}
+/**
+ * Create a Layer that provides handlers for a route group.
+ *
+ * The build callback can return either:
+ * - GroupHandlers directly (simple case)
+ * - Effect<GroupHandlers> (when you need Effect context in handlers)
+ *
+ * Usage:
+ * ```typescript
+ * // Simple - no Effect wrapper needed
+ * const AppRoutesLive = RouterBuilder.group(
+ *   AppRouter,
+ *   "app",
+ *   (handlers) => handlers
+ *     .handle("home", { component: () => <HomePage /> })
+ *     .handle("posts", { loader: () => fetchPosts(), component: ... })
+ * )
+ *
+ * // With Effect context (when handlers need services)
+ * const AppRoutesLive = RouterBuilder.group(
+ *   AppRouter,
+ *   "app",
+ *   (handlers) => Effect.gen(function* () {
+ *     const config = yield* Config;
+ *     return handlers.handle("home", { ... });
+ *   })
+ * )
+ * ```
+ */
+export declare function group<GroupName extends string>(router: Router, groupName: GroupName, build: (handlers: GroupHandlers<GroupName>) => GroupHandlers<GroupName>): Layer.Layer<RouterHandlers, never, never>;
+export declare function group<GroupName extends string, R>(router: Router, groupName: GroupName, build: (handlers: GroupHandlers<GroupName>) => Effect.Effect<GroupHandlers<GroupName>, never, R>): Layer.Layer<RouterHandlers, never, R>;
+/**
+ * Merge multiple group handler layers into a single RouterHandlers layer.
+ *
+ * Usage:
+ * ```typescript
+ * const AppRouterLive = RouterBuilder.router(AppRouter).pipe(
+ *   Layer.provide(AppRoutesLive),
+ *   Layer.provide(ApiRoutesLive)
+ * )
+ * ```
+ */
+export declare function router(_router: Router): Layer.Layer<RouterHandlers>;
+/**
+ * Execute a route's loader and render its component.
+ * Returns the rendered VElement.
+ */
+export declare function executeRoute(handler: RouteHandler, ctx: LoaderContext): Effect.Effect<VElement>;
+export {};

package/dist/router/RouterBuilder.js

@@ -0,0 +1,112 @@
+/**
+ * RouterBuilder module for implementing route handlers.
+ *
+ * Mirrors Effect HttpApiBuilder patterns:
+ * - RouterBuilder.group(router, "groupName", (handlers) => Effect.gen(...))
+ * - handlers.handle("routeName", { loader, component })
+ * - RouterBuilder.router(Router) builds the final Layer
+ */
+import * as Effect from "effect/Effect";
+import * as Context from "effect/Context";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+/**
+ * Tag for the RouterHandlers service.
+ * Provides access to all registered handlers.
+ */
+export class RouterHandlers extends Context.Tag("fibrae/RouterHandlers")() {
+}
+/**
+ * Create handlers builder for a route group.
+ */
+function makeGroupHandlers(groupName, group) {
+    const routesByName = new Map(group.routes.map((r) => [r.name, r]));
+    const buildHandlers = (handlers) => ({
+        groupName,
+        handlers,
+        handle(routeName, config) {
+            const maybeRoute = Option.fromNullable(routesByName.get(routeName));
+            if (Option.isNone(maybeRoute)) {
+                throw new Error(`Route "${routeName}" not found in group "${groupName}"`);
+            }
+            const route = maybeRoute.value;
+            // Normalize loader: default to returning null, wrap plain values in Effect
+            const normalizedLoader = (ctx) => {
+                if (!config.loader) {
+                    return Effect.succeed(null);
+                }
+                const result = config.loader(ctx);
+                return (Effect.isEffect(result) ? result : Effect.succeed(result));
+            };
+            const handler = {
+                routeName,
+                route,
+                loader: normalizedLoader,
+                component: config.component,
+            };
+            return buildHandlers([...handlers, handler]);
+        },
+    });
+    return buildHandlers([]);
+}
+/**
+ * Find a route group by name in a router.
+ */
+function findGroup(router, groupName) {
+    const maybeGroup = Option.fromNullable(router.groups.find((g) => g.name === groupName));
+    if (Option.isNone(maybeGroup)) {
+        throw new Error(`Group "${groupName}" not found in router "${router.name}"`);
+    }
+    return maybeGroup.value;
+}
+export function group(router, groupName, build) {
+    const routeGroup = findGroup(router, groupName);
+    const initialHandlers = makeGroupHandlers(groupName, routeGroup);
+    return Layer.effect(RouterHandlers, Effect.gen(function* () {
+        const result = build(initialHandlers);
+        const builtHandlers = Effect.isEffect(result) ? yield* result : result;
+        const handlersMap = new Map(builtHandlers.handlers.map((h) => [h.routeName, h]));
+        return {
+            handlers: handlersMap,
+            getHandler(routeName) {
+                const handler = handlersMap.get(routeName);
+                return handler ? Option.some(handler) : Option.none();
+            },
+        };
+    }));
+}
+/**
+ * Merge multiple group handler layers into a single RouterHandlers layer.
+ *
+ * Usage:
+ * ```typescript
+ * const AppRouterLive = RouterBuilder.router(AppRouter).pipe(
+ *   Layer.provide(AppRoutesLive),
+ *   Layer.provide(ApiRoutesLive)
+ * )
+ * ```
+ */
+export function router(_router) {
+    // Start with an empty handlers layer
+    return Layer.succeed(RouterHandlers, {
+        handlers: new Map(),
+        getHandler(_routeName) {
+            return Option.none();
+        },
+    });
+}
+/**
+ * Execute a route's loader and render its component.
+ * Returns the rendered VElement.
+ */
+export function executeRoute(handler, ctx) {
+    return Effect.gen(function* () {
+        const loaderData = yield* handler.loader(ctx);
+        return handler.component({
+            loaderData,
+            path: ctx.path,
+            searchParams: ctx.searchParams,
+        });
+    });
+}
+//# sourceMappingURL=RouterBuilder.js.map

package/dist/router/RouterBuilder.js.map

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

package/dist/router/RouterOutlet.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 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 Stream from "effect/Stream";
+import { Registry as AtomRegistry } from "@effect-atom/atom";
+import { Navigator } from "./Navigator.js";
+import { RouterHandlers } from "./RouterBuilder.js";
+import type { VElement } from "../shared.js";
+/**
+ * Props for RouterOutlet component.
+ *
+ * @deprecated Props are no longer needed - SSR hydration is handled via RouterStateAtom.
+ */
+export interface RouterOutletProps {
+    /**
+     * @deprecated Use RouterStateAtom hydration instead.
+     * Initial loader data from SSR - skips loader on first render.
+     */
+    readonly initialLoaderData?: unknown;
+    /**
+     * @deprecated Use RouterStateAtom hydration instead.
+     * Initial route name from SSR - used with initialLoaderData.
+     */
+    readonly initialRouteName?: string;
+}
+/**
+ * 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 declare function RouterOutlet(_props?: RouterOutletProps): Stream.Stream<VElement, unknown, Navigator | RouterHandlers | AtomRegistry.AtomRegistry>;