@rikalabs/effect-react 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Rika Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,179 @@
+# @rikalabs/effect-react
+
+Effect-native full-stack React framework.
+
+React is the view layer. Effect is the execution layer.
+
+## Why This Exists
+
+Modern React apps usually stitch together router, query, form, state, realtime, and SSR tooling with different semantics for retries, cancellation, caching, and errors.
+
+`@rikalabs/effect-react` gives app teams one model across frontend and backend:
+
+- `Effect` for async orchestration, cancellation, retries, streams, and failure values.
+- `Schema` for boundary decoding/encoding.
+- `Layer` for runtime composition.
+- React for rendering.
+
+## What You Get
+
+- SSR by default with hydration state handoff.
+- Streaming-enabled runtime defaults.
+- File-routing discovery via Vite plugin.
+- Typed route loaders and typed actions.
+- Built-in modules for state, query, router, form, grid, virtual lists, realtime, and devtools.
+- Strict defaults for boundary schemas and typed errors.
+
+## Install
+
+```bash
+bun add @rikalabs/effect-react effect react react-dom
+```
+
+## 5-File Quickstart
+
+```ts
+// vite.config.ts
+import react from "@vitejs/plugin-react";
+import { defineConfig } from "vite";
+import { effectReactVitePlugin } from "@rikalabs/effect-react/framework/vite";
+
+export default defineConfig({
+  plugins: [react(), effectReactVitePlugin({ appDir: "app" })],
+});
+```
+
+```tsx
+// app/page.tsx
+import { Effect } from "effect";
+import { defineLoader, definePage, defineRoute } from "@rikalabs/effect-react/framework";
+
+const route = defineRoute({
+  id: "home",
+  path: "/",
+});
+
+const loader = defineLoader({
+  name: "home.loader",
+  routeId: route.id,
+  run: () =>
+    Effect.succeed({
+      headline: "One runtime for the whole app lifecycle",
+    }),
+});
+
+const HomePage = () => <main>Hello from @rikalabs/effect-react</main>;
+
+export default definePage({
+  id: "home.page",
+  route,
+  loader,
+  component: HomePage,
+});
+```
+
+```ts
+// app/actions/counter.increment.ts
+import { Effect, Schema } from "effect";
+import { defineAction } from "@rikalabs/effect-react/framework";
+
+export const counterIncrement = defineAction({
+  name: "counter.increment",
+  input: Schema.Struct({ value: Schema.Number }),
+  output: Schema.Struct({ value: Schema.Number }),
+  error: Schema.Struct({ reason: Schema.String }),
+  handler: ({ value }) =>
+    value < 0
+      ? Effect.fail({ reason: "must be >= 0" })
+      : Effect.succeed({ value: value + 1 }),
+});
+```
+
+```ts
+// src/server.ts
+import { createApp } from "@rikalabs/effect-react/framework";
+import { createRequestHandler } from "@rikalabs/effect-react/server";
+import manifest from "virtual:effect-react/manifest";
+
+const app = createApp({ manifest });
+
+export const handler = createRequestHandler({ app });
+```
+
+```ts
+// src/client.tsx
+import { hydrateApp } from "@rikalabs/effect-react/client";
+import { createApp } from "@rikalabs/effect-react/framework";
+import manifest from "virtual:effect-react/manifest";
+
+const app = createApp({ manifest });
+
+await hydrateApp({ app });
+```
+
+## Effect Model: `Effect<A, E, R>`
+
+- `A`: success value
+- `E`: typed error value
+- `R`: required services/dependencies
+
+How this maps to the framework:
+
+- Request lifecycle runs in a managed app runtime with core services (`Boundary`, `Data`, `Actions`, `Navigation`, `Telemetry`).
+- Loaders/actions/queries are transport-safe contracts with typed success/error channels.
+- You can still use custom `R` dependencies at boundaries by providing a `Layer`.
+
+```ts
+import { Context, Effect, Layer } from "effect";
+import { createElement } from "react";
+import { createApp } from "@rikalabs/effect-react/framework";
+import { createRequestHandler } from "@rikalabs/effect-react/server";
+import manifest from "virtual:effect-react/manifest";
+
+class RequestLogger extends Context.Tag("app/RequestLogger")<
+  RequestLogger,
+  { readonly info: (message: string) => Effect.Effect<void> }
+>() {}
+
+const RequestLoggerLive = Layer.succeed(RequestLogger, {
+  info: (message: string) => Effect.sync(() => console.log(message)),
+});
+
+const app = createApp({ manifest });
+
+export const handler = createRequestHandler({
+  app,
+  render: ({ page }) =>
+    Effect.gen(function* () {
+      const logger = yield* RequestLogger;
+      yield* logger.info(`rendering ${page.id}`);
+      return createElement(page.component);
+    }).pipe(Effect.provide(RequestLoggerLive)),
+});
+```
+
+## Modules
+
+- `@rikalabs/effect-react/framework`
+- `@rikalabs/effect-react/framework/vite`
+- `@rikalabs/effect-react/config`
+- `@rikalabs/effect-react/server`
+- `@rikalabs/effect-react/client`
+- `@rikalabs/effect-react/testing`
+- `@rikalabs/effect-react/state`
+- `@rikalabs/effect-react/query`
+- `@rikalabs/effect-react/router`
+- `@rikalabs/effect-react/form`
+- `@rikalabs/effect-react/grid`
+- `@rikalabs/effect-react/virtual`
+- `@rikalabs/effect-react/realtime`
+- `@rikalabs/effect-react/devtools`
+
+## Docs
+
+- Docs index: [`docs/README.md`](docs/README.md)
+- Changelog: [`CHANGELOG.md`](CHANGELOG.md)
+
+## License
+
+MIT

package/dist/actions/http.d.ts

@@ -0,0 +1,18 @@
+import { Effect } from "effect";
+import { Boundary } from "../boundary";
+import { Actions } from "./service";
+import { type ActionDefinition, type ActionError } from "./types";
+export declare class ActionTransportError extends Error {
+    readonly messageText: string;
+    readonly causeValue?: unknown | undefined;
+    readonly _tag: "ActionTransportError";
+    constructor(messageText: string, causeValue?: unknown | undefined);
+}
+export declare const createActionHttpHandlerEffect: () => ((request: Request) => Effect.Effect<Response, never, Boundary | Actions>);
+export declare const createActionHttpHandler: () => (runtimeRun: <A>(effect: Effect.Effect<A, unknown, Boundary | Actions>) => Promise<A>) => (request: Request) => Promise<Response>;
+export declare const callActionWire: <Name extends string, Input, Output, E>(definition: ActionDefinition<Name, Input, Output, E>, options: {
+    readonly endpoint: string;
+    readonly input: Input;
+    readonly fetcher?: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+    readonly signal?: AbortSignal;
+}) => Effect.Effect<Output, ActionError<E> | ActionTransportError, Boundary>;

package/dist/actions/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./types";
+export * from "./service";
+export * from "./http";
+export * from "./react";

package/dist/actions/react.d.ts

@@ -0,0 +1,7 @@
+import type { ActionDefinition, ActionError } from "./types";
+export interface UseActionResult<Input, Output, E> {
+    readonly run: (input: Input) => Promise<Output>;
+    readonly pending: boolean;
+    readonly error: ActionError<E> | undefined;
+}
+export declare const useAction: <Name extends string, Input, Output, E>(definition: ActionDefinition<Name, Input, Output, E>) => UseActionResult<Input, Output, E>;

package/dist/actions/service.d.ts

@@ -0,0 +1,18 @@
+import { Context, Effect, Layer } from "effect";
+import { Boundary } from "../boundary";
+import { Telemetry } from "../kernel/telemetry";
+import { type ActionDefinition, type ActionError, type ActionWireResult, type AnyActionDefinition } from "./types";
+export interface ActionService {
+    readonly run: <Name extends string, Input, Output, E>(definition: ActionDefinition<Name, Input, Output, E>, input: unknown) => Effect.Effect<Output, ActionError<E>, never>;
+    readonly dispatch: (name: string, input: unknown) => Effect.Effect<ActionWireResult, never, never>;
+}
+declare const Actions_base: Context.TagClass<Actions, "EffectReact/Actions", ActionService>;
+export declare class Actions extends Actions_base {
+}
+export interface MakeActionsLayerOptions {
+    readonly actions: readonly AnyActionDefinition[];
+}
+export declare const makeActionsLayer: (options: MakeActionsLayerOptions) => Layer.Layer<Actions, never, Boundary | Telemetry>;
+export declare const runAction: <Name extends string, Input, Output, E>(definition: ActionDefinition<Name, Input, Output, E>, input: unknown) => Effect.Effect<Output, ActionError<E>, Actions>;
+export declare const dispatchAction: (name: string, input: unknown) => Effect.Effect<ActionWireResult, never, Actions>;
+export {};

package/dist/actions/types.d.ts

@@ -0,0 +1,33 @@
+import type { Effect, Schema } from "effect";
+import type { BoundaryError } from "../boundary";
+export interface ActionDefinition<Name extends string, Input, Output, E, InputEncoded = Input, OutputEncoded = Output, ErrorEncoded = E> {
+    readonly name: Name;
+    readonly input: Schema.Schema<Input, InputEncoded, never>;
+    readonly output: Schema.Schema<Output, OutputEncoded, never>;
+    readonly error: Schema.Schema<E, ErrorEncoded, never>;
+    readonly handler: (input: Input) => Effect.Effect<Output, E, never>;
+}
+export declare const defineAction: <Name extends string, Input, Output, E, InputEncoded = Input, OutputEncoded = Output, ErrorEncoded = E>(definition: ActionDefinition<Name, Input, Output, E, InputEncoded, OutputEncoded, ErrorEncoded>) => ActionDefinition<Name, Input, Output, E, InputEncoded, OutputEncoded, ErrorEncoded>;
+export interface AnyActionDefinition {
+    readonly name: string;
+    readonly input: Schema.Schema.All;
+    readonly output: Schema.Schema.All;
+    readonly error: Schema.Schema.All;
+    readonly handler: (input: never) => Effect.Effect<unknown, unknown, never>;
+}
+export type ActionError<E> = E | BoundaryError | ActionRuntimeError;
+export declare class ActionRuntimeError extends Error {
+    readonly messageText: string;
+    readonly _tag: "ActionRuntimeError";
+    constructor(messageText: string);
+}
+export type ActionWireResult = {
+    readonly _tag: "success";
+    readonly value: unknown;
+} | {
+    readonly _tag: "failure";
+    readonly error: unknown;
+} | {
+    readonly _tag: "defect";
+    readonly message: string;
+};

package/dist/boundary/codecs.d.ts

@@ -0,0 +1,40 @@
+import { Context, Effect, Layer, Schema } from "effect";
+import { BoundaryDecodeError, type BoundaryError } from "./errors";
+export interface BoundaryService {
+    readonly decodeUnknown: <A, I>(options: {
+        readonly source: string;
+        readonly schema: Schema.Schema<A, I, never>;
+        readonly value: unknown;
+    }) => Effect.Effect<A, BoundaryDecodeError, never>;
+    readonly decodeTextJson: <A, I>(options: {
+        readonly source: string;
+        readonly schema: Schema.Schema<A, I, never>;
+        readonly text: string;
+    }) => Effect.Effect<A, BoundaryError, never>;
+    readonly encode: <A, I>(options: {
+        readonly source: string;
+        readonly schema: Schema.Schema<A, I, never>;
+        readonly value: A;
+    }) => Effect.Effect<I, BoundaryError, never>;
+}
+declare const Boundary_base: Context.TagClass<Boundary, "EffectReact/Boundary", BoundaryService>;
+export declare class Boundary extends Boundary_base {
+}
+export declare const makeBoundaryService: () => BoundaryService;
+export declare const BoundaryLive: Layer.Layer<Boundary, never, never>;
+export declare const decodeUnknown: <A, I>(options: {
+    readonly source: string;
+    readonly schema: Schema.Schema<A, I, never>;
+    readonly value: unknown;
+}) => Effect.Effect<A, BoundaryDecodeError, Boundary>;
+export declare const decodeTextJson: <A, I>(options: {
+    readonly source: string;
+    readonly schema: Schema.Schema<A, I, never>;
+    readonly text: string;
+}) => Effect.Effect<A, BoundaryError, Boundary>;
+export declare const encode: <A, I>(options: {
+    readonly source: string;
+    readonly schema: Schema.Schema<A, I, never>;
+    readonly value: A;
+}) => Effect.Effect<I, BoundaryError, Boundary>;
+export {};

package/dist/boundary/errors.d.ts

@@ -0,0 +1,22 @@
+import type { ParseResult } from "effect";
+export declare class BoundaryDecodeError extends Error {
+    readonly source: string;
+    readonly messageText: string;
+    readonly causeValue?: ParseResult.ParseError | undefined;
+    readonly _tag: "BoundaryDecodeError";
+    constructor(source: string, messageText: string, causeValue?: ParseResult.ParseError | undefined);
+}
+export declare class BoundaryTransportError extends Error {
+    readonly source: string;
+    readonly messageText: string;
+    readonly causeValue?: unknown | undefined;
+    readonly _tag: "BoundaryTransportError";
+    constructor(source: string, messageText: string, causeValue?: unknown | undefined);
+}
+export declare class BoundaryProtocolError extends Error {
+    readonly source: string;
+    readonly messageText: string;
+    readonly _tag: "BoundaryProtocolError";
+    constructor(source: string, messageText: string);
+}
+export type BoundaryError = BoundaryDecodeError | BoundaryTransportError | BoundaryProtocolError;

package/dist/boundary/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./codecs";
+export * from "./errors";

package/dist/chunk-2GIUCKL2.js

@@ -0,0 +1,16 @@
+// src/react/provider.tsx
+import { createContext, useContext, useEffect } from "react";
+import { jsx } from "react/jsx-runtime";
+var RuntimeContext = createContext(null);
+var useEffectRuntime = () => {
+  const runtime = useContext(RuntimeContext);
+  if (runtime === null) {
+    throw new Error("Effect runtime is not available. Wrap your app with <EffectProvider>.");
+  }
+  return runtime;
+};
+
+export {
+  useEffectRuntime
+};
+//# sourceMappingURL=chunk-2GIUCKL2.js.map

package/dist/chunk-2GIUCKL2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react/provider.tsx"],"sourcesContent":["import type { ManagedRuntime } from \"effect\";\nimport { createContext, useContext, useEffect, type ReactNode } from \"react\";\nimport type { AppServices } from \"../kernel/app\";\n\nexport type EffectReactManagedRuntime<R = AppServices> = ManagedRuntime.ManagedRuntime<R, never>;\n\nconst RuntimeContext = createContext<EffectReactManagedRuntime | null>(null);\n\nexport interface EffectProviderProps {\n  readonly runtime: EffectReactManagedRuntime;\n  readonly children?: ReactNode;\n}\n\nexport const EffectProvider = ({ runtime, children }: EffectProviderProps) => {\n  useEffect(\n    () => () => {\n      void runtime.dispose();\n    },\n    [runtime],\n  );\n\n  return <RuntimeContext.Provider value={runtime}>{children}</RuntimeContext.Provider>;\n};\n\nexport const useEffectRuntime = (): EffectReactManagedRuntime => {\n  const runtime = useContext(RuntimeContext);\n  if (runtime === null) {\n    throw new Error(\"Effect runtime is not available. Wrap your app with <EffectProvider>.\");\n  }\n  return runtime;\n};\n"],"mappings":";AACA,SAAS,eAAe,YAAY,iBAAiC;AAoB5D;AAfT,IAAM,iBAAiB,cAAgD,IAAI;AAkBpE,IAAM,mBAAmB,MAAiC;AAC/D,QAAM,UAAU,WAAW,cAAc;AACzC,MAAI,YAAY,MAAM;AACpB,UAAM,IAAI,MAAM,uEAAuE;AAAA,EACzF;AACA,SAAO;AACT;","names":[]}

package/dist/chunk-2TG7YEVD.js

@@ -0,0 +1,11 @@
+import {
+  createApp
+} from "./chunk-XIBEKS5A.js";
+
+// src/testing/index.ts
+var createTestApp = (options) => createApp(options);
+
+export {
+  createTestApp
+};
+//# sourceMappingURL=chunk-2TG7YEVD.js.map

package/dist/chunk-2TG7YEVD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/testing/index.ts"],"sourcesContent":["import { createApp, type CreateAppOptions } from \"../framework\";\n\nexport const createTestApp = (options: CreateAppOptions) => createApp(options);\n"],"mappings":";;;;;AAEO,IAAM,gBAAgB,CAAC,YAA8B,UAAU,OAAO;","names":[]}

package/dist/chunk-6FI4ROTW.js

@@ -0,0 +1,152 @@
+import {
+  useEffectRuntime
+} from "./chunk-2GIUCKL2.js";
+import {
+  Navigation,
+  buildHref,
+  navigateTo
+} from "./chunk-O7XTA7H3.js";
+
+// src/router/helpers.ts
+var PARAM_PATTERN = /:([A-Za-z0-9_]+)/g;
+var appendSearchValue = (params, key, value) => {
+  if (value === null || value === void 0) {
+    return;
+  }
+  if (Array.isArray(value)) {
+    for (const nestedValue of value) {
+      appendSearchValue(params, key, nestedValue);
+    }
+    return;
+  }
+  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+    params.append(key, String(value));
+  }
+};
+var defaultBase = () => {
+  if (typeof window === "undefined") {
+    return "http://localhost";
+  }
+  return window.location.origin;
+};
+var routeSearchText = (search) => {
+  if (search === void 0) {
+    return "";
+  }
+  const params = new URLSearchParams();
+  const keys = Object.keys(search).sort((a, b) => a.localeCompare(b));
+  for (const key of keys) {
+    appendSearchValue(params, key, search[key]);
+  }
+  const text = params.toString();
+  return text.length > 0 ? `?${text}` : "";
+};
+var routePath = (route, params) => route.path.replace(PARAM_PATTERN, (_match, name) => {
+  const value = params?.[name];
+  if (value === void 0) {
+    throw new Error(`Missing route param '${name}' for route '${route.id}'`);
+  }
+  return encodeURIComponent(String(value));
+});
+var routeHref = (route, options = {}) => buildHref(
+  routePath(route, options.params),
+  routeSearchText(options.search)
+);
+var routeUrl = (route, options = {}) => new URL(
+  routeHref(route, options),
+  options.base ?? defaultBase()
+);
+
+// src/router/service.ts
+import { Effect as Effect2 } from "effect";
+
+// src/navigation/react.tsx
+import { Effect, Fiber, Stream } from "effect";
+import {
+  useCallback,
+  useMemo,
+  useSyncExternalStore
+} from "react";
+import { Fragment, jsx } from "react/jsx-runtime";
+var useNavigationService = () => {
+  const runtime = useEffectRuntime();
+  return useMemo(() => runtime.runSync(Navigation), [runtime]);
+};
+var useNavigationSnapshot = () => {
+  const runtime = useEffectRuntime();
+  const navigation = useNavigationService();
+  const subscribe = useCallback(
+    (listener) => {
+      const fiber = runtime.runFork(
+        Stream.runForEach(navigation.snapshots, () => Effect.sync(listener))
+      );
+      return () => {
+        runtime.runFork(Fiber.interrupt(fiber));
+      };
+    },
+    [navigation, runtime]
+  );
+  const getSnapshot = useCallback(
+    () => runtime.runSync(navigation.getSnapshot),
+    [navigation, runtime]
+  );
+  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+};
+var useNavigate = () => {
+  const runtime = useEffectRuntime();
+  const navigation = useNavigationService();
+  return useCallback(
+    (href) => runtime.runPromise(navigation.navigate(href)),
+    [navigation, runtime]
+  );
+};
+var Link = ({ to, onClick, children, ...rest }) => {
+  const navigate2 = useNavigate();
+  const handleClick = useCallback(
+    (event) => {
+      onClick?.(event);
+      if (event.defaultPrevented) {
+        return;
+      }
+      if (event.button !== 0 || event.metaKey || event.altKey || event.ctrlKey || event.shiftKey) {
+        return;
+      }
+      event.preventDefault();
+      void navigate2(to);
+    },
+    [navigate2, onClick, to]
+  );
+  return /* @__PURE__ */ jsx("a", { ...rest, href: to, onClick: handleClick, children });
+};
+var Outlet = ({ children }) => /* @__PURE__ */ jsx(Fragment, { children });
+
+// src/router/service.ts
+var navigate = (href) => navigateTo(href);
+var revalidateNavigation = () => Effect2.flatMap(Navigation, (service) => service.revalidate());
+
+// src/router/react.tsx
+var useNavigate2 = () => useNavigate();
+var useNavigationSnapshot2 = () => useNavigationSnapshot();
+var useRouteMatch = (route) => {
+  const snapshot = useNavigationSnapshot2();
+  const match = snapshot.match;
+  if (match === null || match.route.id !== route.id) {
+    return null;
+  }
+  return match;
+};
+
+export {
+  Link,
+  Outlet,
+  routeSearchText,
+  routePath,
+  routeHref,
+  routeUrl,
+  navigate,
+  revalidateNavigation,
+  useNavigate2 as useNavigate,
+  useNavigationSnapshot2 as useNavigationSnapshot,
+  useRouteMatch
+};
+//# sourceMappingURL=chunk-6FI4ROTW.js.map

package/dist/chunk-6FI4ROTW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/router/helpers.ts","../src/router/service.ts","../src/navigation/react.tsx","../src/router/react.tsx"],"sourcesContent":["import { buildHref } from \"../navigation/matcher\";\nimport type { AnyRouteDefinition, RouteDefinition } from \"./types\";\n\ntype ExtractSegmentParam<Segment extends string> =\n  Segment extends `:${infer Param}` ? Param : never;\n\ntype ExtractPathParams<Path extends string> =\n  Path extends `${infer Head}/${infer Tail}`\n    ? ExtractSegmentParam<Head> | ExtractPathParams<Tail>\n    : ExtractSegmentParam<Path>;\n\ntype SearchPrimitive = string | number | boolean;\ntype SearchFieldInput<Value> =\n  Value extends readonly (infer Item)[]\n    ? Item | readonly Item[] | null | undefined\n    : Value | readonly Value[] | null | undefined;\n\ntype SearchFallback = Readonly<Record<string, SearchPrimitive | readonly SearchPrimitive[] | null | undefined>>;\n\nexport type RoutePathParams<Path extends string> =\n  [ExtractPathParams<Path>] extends [never]\n    ? Record<never, never>\n    : {\n        readonly [K in ExtractPathParams<Path>]: string | number | boolean;\n      };\n\nexport type RouteSearchInput<TRoute extends AnyRouteDefinition> =\n  TRoute extends RouteDefinition<string, infer Search, unknown>\n    ? {\n        readonly [K in keyof Search]?: SearchFieldInput<Search[K]>;\n      }\n    : SearchFallback;\n\nexport interface RouteHrefOptions<TRoute extends AnyRouteDefinition> {\n  readonly params?: RoutePathParams<TRoute[\"path\"]>;\n  readonly search?: RouteSearchInput<TRoute>;\n}\n\nexport interface RouteUrlOptions<TRoute extends AnyRouteDefinition>\n  extends RouteHrefOptions<TRoute> {\n  readonly base?: string | URL;\n}\n\nconst PARAM_PATTERN = /:([A-Za-z0-9_]+)/g;\n\nconst appendSearchValue = (\n  params: URLSearchParams,\n  key: string,\n  value: unknown,\n): void => {\n  if (value === null || value === undefined) {\n    return;\n  }\n  if (Array.isArray(value)) {\n    for (const nestedValue of value) {\n      appendSearchValue(params, key, nestedValue);\n    }\n    return;\n  }\n  if (typeof value === \"string\" || typeof value === \"number\" || typeof value === \"boolean\") {\n    params.append(key, String(value));\n  }\n};\n\nconst defaultBase = (): string => {\n  if (typeof window === \"undefined\") {\n    return \"http://localhost\";\n  }\n  return window.location.origin;\n};\n\nexport const routeSearchText = (search?: SearchFallback): string => {\n  if (search === undefined) {\n    return \"\";\n  }\n\n  const params = new URLSearchParams();\n  const keys = Object.keys(search).sort((a, b) => a.localeCompare(b));\n  for (const key of keys) {\n    appendSearchValue(params, key, search[key]);\n  }\n\n  const text = params.toString();\n  return text.length > 0 ? `?${text}` : \"\";\n};\n\nexport const routePath = <TRoute extends AnyRouteDefinition>(\n  route: TRoute,\n  params?: RoutePathParams<TRoute[\"path\"]>,\n): string =>\n  route.path.replace(PARAM_PATTERN, (_match, name: string) => {\n    const value = (params as Readonly<Record<string, string | number | boolean>> | undefined)?.[name];\n    if (value === undefined) {\n      throw new Error(`Missing route param '${name}' for route '${route.id}'`);\n    }\n    return encodeURIComponent(String(value));\n  });\n\nexport const routeHref = <TRoute extends AnyRouteDefinition>(\n  route: TRoute,\n  options: RouteHrefOptions<TRoute> = {},\n): string =>\n  buildHref(\n    routePath(route, options.params),\n    routeSearchText(options.search as SearchFallback | undefined),\n  );\n\nexport const routeUrl = <TRoute extends AnyRouteDefinition>(\n  route: TRoute,\n  options: RouteUrlOptions<TRoute> = {},\n): URL =>\n  new URL(\n    routeHref(route, options),\n    options.base ?? defaultBase(),\n  );\n","import { Effect } from \"effect\";\nimport { Navigation, navigateTo } from \"../navigation\";\nimport type { NavigationError, NavigationSnapshot } from \"./types\";\n\nexport const navigate = (\n  href: string,\n): Effect.Effect<NavigationSnapshot, NavigationError, Navigation> =>\n  navigateTo(href);\n\nexport const revalidateNavigation = (): Effect.Effect<NavigationSnapshot, NavigationError, Navigation> =>\n  Effect.flatMap(Navigation, (service) => service.revalidate());\n","import { Effect, Fiber, Stream } from \"effect\";\nimport {\n  type AnchorHTMLAttributes,\n  type MouseEvent,\n  type ReactNode,\n  useCallback,\n  useMemo,\n  useSyncExternalStore,\n} from \"react\";\nimport { useEffectRuntime } from \"../react/provider\";\nimport { Navigation } from \"./service\";\nimport type { NavigationSnapshot } from \"./types\";\n\nconst useNavigationService = () => {\n  const runtime = useEffectRuntime();\n  return useMemo(() => runtime.runSync(Navigation), [runtime]);\n};\n\nexport const useNavigationSnapshot = (): NavigationSnapshot => {\n  const runtime = useEffectRuntime();\n  const navigation = useNavigationService();\n\n  const subscribe = useCallback(\n    (listener: () => void) => {\n      const fiber = runtime.runFork(\n        Stream.runForEach(navigation.snapshots, () => Effect.sync(listener)),\n      );\n\n      return () => {\n        runtime.runFork(Fiber.interrupt(fiber));\n      };\n    },\n    [navigation, runtime],\n  );\n\n  const getSnapshot = useCallback(\n    () => runtime.runSync(navigation.getSnapshot),\n    [navigation, runtime],\n  );\n\n  return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n};\n\nexport const useNavigate = (): ((href: string) => Promise<NavigationSnapshot>) => {\n  const runtime = useEffectRuntime();\n  const navigation = useNavigationService();\n\n  return useCallback(\n    (href: string) => runtime.runPromise(navigation.navigate(href)),\n    [navigation, runtime],\n  );\n};\n\nexport interface LinkProps extends Omit<AnchorHTMLAttributes<HTMLAnchorElement>, \"href\"> {\n  readonly to: string;\n  readonly children?: ReactNode;\n}\n\nexport const Link = ({ to, onClick, children, ...rest }: LinkProps) => {\n  const navigate = useNavigate();\n\n  const handleClick = useCallback(\n    (event: MouseEvent<HTMLAnchorElement>) => {\n      onClick?.(event);\n      if (event.defaultPrevented) {\n        return;\n      }\n      if (event.button !== 0 || event.metaKey || event.altKey || event.ctrlKey || event.shiftKey) {\n        return;\n      }\n      event.preventDefault();\n      void navigate(to);\n    },\n    [navigate, onClick, to],\n  );\n\n  return (\n    <a {...rest} href={to} onClick={handleClick}>\n      {children}\n    </a>\n  );\n};\n\nexport const Outlet = ({ children }: { readonly children?: ReactNode }) => <>{children}</>;\n","import {\n  useNavigate as useNavigationNavigate,\n  useNavigationSnapshot as useNavigationState,\n} from \"../navigation/react\";\nimport type { AnyRouteDefinition, NavigationSnapshot, RouteMatch } from \"./types\";\n\nexport {\n  Link,\n  Outlet,\n  type LinkProps,\n} from \"../navigation/react\";\n\nexport const useNavigate = (): ((href: string) => Promise<NavigationSnapshot>) =>\n  useNavigationNavigate();\n\nexport const useNavigationSnapshot = (): NavigationSnapshot =>\n  useNavigationState();\n\nexport const useRouteMatch = <TRoute extends AnyRouteDefinition>(\n  route: TRoute,\n): RouteMatch<TRoute> | null => {\n  const snapshot = useNavigationSnapshot();\n  const match = snapshot.match;\n  if (match === null || match.route.id !== route.id) {\n    return null;\n  }\n  return match as RouteMatch<TRoute>;\n};\n"],"mappings":"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","names":["Effect","navigate","Effect","useNavigate","useNavigationSnapshot"]}