@kasperrt/smolter 0.4.3 → 0.4.4

package/.generated/react/navigation.ts

@@ -0,0 +1,145 @@
+import { matchRoutes, type NavigateOptions } from "../core/index.ts";
+import {
+  handoffDocument,
+  resolveApplicationURL,
+} from "../core/environment.ts";
+import { navigationClick } from "../core/url.ts";
+import { useRouter, useSnapshot } from "./context.ts";
+import { useNavigation, useURLLocation } from "./route-hooks.ts";
+import type { AppRoute } from "./route-types.ts";
+import type { AnchorHTMLAttributes, MouseEvent, ReactNode } from "./runtime.ts";
+import { createElement } from "./runtime.ts";
+
+export type { NavigateOptions } from "../core/index.ts";
+
+export type { NavigationType } from "../core/navigation.ts";
+
+/** Navigate to a URL or move through browser history using a numeric offset. */
+export type NavigateFunction = (
+  to: string | number | Partial<Pick<URL, "pathname" | "search" | "hash">>,
+  options?: NavigateOptions,
+) => void;
+
+/** Anchor properties and router navigation options, including document reload and prefetch controls. */
+export interface LinkProps
+  extends Omit<AnchorHTMLAttributes<HTMLAnchorElement>, "href"> {
+  to?: string;
+  href?: string;
+  replace?: boolean;
+  prefetch?: string;
+  state?: unknown;
+  preventScrollReset?: boolean;
+  viewTransition?: boolean;
+  reloadDocument?: boolean;
+}
+
+/** Active and pending flags supplied to NavLink render callbacks. */
+export interface NavLinkRenderProps {
+  isActive: boolean;
+  isPending: boolean;
+}
+
+/** Link options with matching rules and state-aware class or children callbacks. */
+export interface NavLinkProps
+  extends Omit<LinkProps, "className" | "children"> {
+  end?: boolean;
+  className?: string | ((state: NavLinkRenderProps) => string);
+  children?: ReactNode | ((state: NavLinkRenderProps) => ReactNode);
+}
+
+/** Render an anchor with same-origin router navigation and optional intent prefetching. */
+export function Link(options: LinkProps): ReactNode {
+  const {
+    href: hrefProp,
+    to = hrefProp ?? "/",
+    replace,
+    preventScrollReset,
+    viewTransition,
+    prefetch,
+    state,
+    reloadDocument,
+    ...props
+  } = options;
+  const router = useRouter();
+  const current = new URL(useSnapshot("url"));
+  const destination = resolveApplicationURL(new URL(to, current));
+  const internal = destination.origin === current.origin;
+  const preload = () => {
+    const route = matchRoutes(router.routes, destination.pathname)?.route as
+      | AppRoute
+      | undefined;
+
+    void route?.preload?.().catch(() => {});
+  };
+
+  if (!reloadDocument && prefetch !== "none" && internal) {
+    for (const name of ["onPointerEnter", "onFocus", "onTouchStart"] as const) {
+      const handler = props[name] as ((event: unknown) => void) | undefined;
+
+      props[name] = (event) => {
+        handler?.(event);
+        preload();
+      };
+    }
+  }
+
+  return createElement("a", {
+    ...props,
+    href: destination.href,
+    onClick(event: MouseEvent<HTMLAnchorElement>) {
+      props.onClick?.(event);
+
+      if (reloadDocument || !navigationClick(event, event.currentTarget))
+        return;
+
+      if (!internal) {
+        handoffDocument(event.nativeEvent, destination);
+
+        return;
+      }
+
+      event.preventDefault();
+      void router.navigate(destination.href, options);
+    },
+  });
+}
+
+/** Render a Link with active-route state and aria-current for the matching destination. */
+export function NavLink({
+  href,
+  to = href ?? "/",
+  end,
+  className,
+  children,
+  ...props
+}: NavLinkProps): ReactNode {
+  const location = useURLLocation();
+  const destination = resolveApplicationURL(new URL(to, location.href));
+  const target = destination.pathname;
+  const isActive =
+    destination.origin === location.origin &&
+    (location.pathname === target ||
+      (!end && target !== "/" && location.pathname.startsWith(`${target}/`)));
+  const pending = useNavigation().location;
+  const isPending =
+    !!pending &&
+    pending.origin === destination.origin &&
+    (pending.pathname === target ||
+      (!end && target !== "/" && pending.pathname.startsWith(`${target}/`)));
+  const state = { isActive, isPending };
+
+  return createElement(Link, {
+    ...props,
+    to,
+    className: typeof className === "function" ? className(state) : className,
+    ...(isActive && { "aria-current": "page" }),
+    children: typeof children === "function" ? children(state) : children,
+  });
+}
+
+export {
+  useNavigate,
+  useNavigationType,
+  useSearchParams,
+  useURLLocation,
+} from "./route-hooks.ts";

package/.generated/react/root-context.ts

@@ -0,0 +1,22 @@
+import type { Router } from "../core/index.ts";
+import type { AppRoute, RootModule } from "./route-types.ts";
+import { createContext, useContext } from "./runtime.ts";
+
+export interface ApplicationContext {
+  router: Router;
+  routes: AppRoute[];
+  root: unknown;
+  rootError?: boolean;
+  entry?: string;
+  streaming?: boolean;
+  initialData?: string;
+  rootModule?: RootModule;
+}
+
+export const Application = createContext<ApplicationContext | null>(null);
+
+export function useApplication() {
+  const app = useContext(Application);
+  if (!app) throw new Error("Root data requires RouterApplication.");
+  return app;
+}

package/.generated/react/route-hooks.ts

@@ -0,0 +1,159 @@
+import type { NavigateOptions, Router, SubmitOptions } from "../core/index.ts";
+import type { NavigationType } from "../core/navigation.ts";
+import { pendingLocation } from "../core/presentation.ts";
+import {
+  type Submission,
+  type SubmissionOptions,
+  submissionBody,
+  submissionSearch,
+} from "../core/submission.ts";
+import { useRouter, useSnapshot } from "./context.ts";
+import type { NavigateFunction } from "./navigation.ts";
+import { useNavigationSnapshot } from "./navigation-state.ts";
+import { useApplication } from "./root-context.ts";
+import type { RouteData } from "./route-types.ts";
+import { useCallback, useMemo } from "./runtime.ts";
+
+/** Read root loader data from the application context. */
+export function useRootData<T = unknown>(): RouteData<T> {
+  return useApplication().root as RouteData<T>;
+}
+
+/** Read root data or the active route's data by its manifest identifier. */
+export function useRouteLoaderData<T = unknown>(
+  id: string,
+): RouteData<T> | undefined {
+  const app = useApplication();
+  const snapshot = useSnapshot();
+
+  if (id === "root") return app.root as RouteData<T>;
+
+  const route = app.routes.find((item) => item.id === id);
+
+  if (!route || route.path !== snapshot.path) return undefined;
+
+  return snapshot.data as RouteData<T>;
+}
+
+export { useSnapshot };
+
+/** Read the current route error for an error boundary. */
+export function useRouteError(): Error | undefined {
+  return useSnapshot("error");
+}
+
+/** Read the current page navigation or submission state. */
+export function useNavigation(): {
+  state: "idle" | "loading" | "submitting";
+  location: URL | undefined;
+} {
+  const router = useRouter<Router>();
+  const snapshot = useSnapshot();
+  const location = pendingLocation(router);
+
+  return useMemo(
+    () => ({
+      state: snapshot.state,
+      location,
+    }),
+    [snapshot.state, location?.href],
+  );
+}
+
+/** Return a function that submits form data through the current router. */
+export function useSubmit(): (
+  value: Submission,
+  options?: SubmissionOptions,
+) => Promise<void> | Promise<import("../core/index.ts").Result<unknown>> {
+  const router = useRouter<Router>();
+
+  return useCallback(
+    (value: Submission, options: SubmissionOptions = {}) => {
+      const body = submissionBody(value, options.encType);
+      const method = options.method?.toUpperCase();
+      const target = options.action ?? router.getSnapshot().url;
+
+      if (method === "GET") {
+        const url = new URL(target, router.getSnapshot().url);
+        url.search = submissionSearch(body);
+
+        return router.navigate(url.href, options);
+      }
+
+      return router.submit(target, body, {
+        method: method as SubmitOptions["method"],
+      });
+    },
+    [router],
+  );
+}
+
+/** Read the current router location as a URL. */
+export function useURLLocation(): URL & { state: unknown; key: string } {
+  const href = useSnapshot("url");
+  const snapshot = useNavigationSnapshot(useRouter<Router>());
+
+  return useMemo(
+    () =>
+      Object.assign(new URL(href), {
+        state: snapshot.state,
+        key: snapshot.key,
+      }),
+    [href, snapshot.state, snapshot.key],
+  );
+}
+
+/** Return the application navigation function, including history offsets and relative destinations. */
+export function useNavigate(): NavigateFunction {
+  const router = useRouter<Router>();
+
+  return useCallback(
+    (to, options) => {
+      if (typeof to === "number") {
+        window.history.go(to);
+
+        return;
+      }
+
+      const current = new URL(router.getSnapshot().url);
+      const target =
+        typeof to === "string"
+          ? to
+          : `${to.pathname ?? current.pathname}${to.search ?? current.search}${to.hash ?? current.hash}`;
+      void router.navigate(target, options);
+    },
+    [router],
+  );
+}
+
+/** Read URL search parameters and update them through router navigation. */
+export function useSearchParams(): [
+  URLSearchParams,
+  (
+    value: URLSearchParams | Record<string, string>,
+    options?: NavigateOptions,
+  ) => void,
+] {
+  const location = useURLLocation();
+  const navigate = useNavigate();
+  const params = useMemo(
+    () => new URLSearchParams(location.search),
+    [location.search],
+  );
+  const set = useCallback(
+    (
+      value: URLSearchParams | Record<string, string>,
+      options?: NavigateOptions,
+    ) => {
+      navigate(`${location.pathname}?${new URLSearchParams(value)}`, options);
+    },
+    [location.pathname, navigate],
+  );
+
+  return [params, set];
+}
+
+/** Read the last browser history operation. */
+export function useNavigationType(): NavigationType {
+  return useNavigationSnapshot(useRouter<Router>()).type;
+}

package/.generated/react/route-types.ts

@@ -0,0 +1,91 @@
+import type {
+  DataArgs,
+  RevalidationArgs,
+  Route,
+  Snapshot,
+} from "../core/index.ts";
+import type { DataResponse } from "../core/responses.ts";
+import type { ComponentType, ReactNode } from "./runtime.ts";
+
+/** Request, route parameters and cancellation signal supplied to a loader. */
+export interface LoaderFunctionArgs extends DataArgs {
+  context?: unknown;
+}
+
+/** Request, route parameters and cancellation signal supplied to an action. */
+export type ActionFunctionArgs = LoaderFunctionArgs;
+
+/** Loader arguments with a serverLoader callback for the server transport. */
+export interface ClientLoaderFunctionArgs extends LoaderFunctionArgs {
+  serverLoader: <T = unknown>() => Promise<T>;
+}
+
+/** Action arguments with a serverAction callback for the server transport. */
+export interface ClientActionFunctionArgs extends LoaderFunctionArgs {
+  serverAction: <T = unknown>() => Promise<T>;
+}
+
+/** Navigation or mutation context used to decide whether loader data should refresh. */
+export type ShouldRevalidateFunctionArgs = RevalidationArgs;
+
+type UnwrapData<T> = T extends DataResponse<infer V> ? V : T;
+
+/** Infer successful loader data, unwrapping promises and data responses. */
+export type RouteData<T> = T extends (...args: never[]) => infer R
+  ? UnwrapData<Exclude<Awaited<R>, Response | Error>>
+  : T;
+
+/** A document metadata descriptor, such as a title, meta tag or structured-data record. */
+export type MetaDescriptor = Record<string, unknown>;
+
+/** Loader data, error, parameters and location supplied to a route metadata function. */
+export interface MetaArgs<T> {
+  data: RouteData<T> | undefined;
+  loaderData: RouteData<T> | undefined;
+  error?: unknown;
+  params: Record<string, string>;
+  location: URL;
+}
+
+/** Derive document metadata descriptors from the current route data and location. */
+export type MetaFunction<T = unknown> = (args: MetaArgs<T>) => MetaDescriptor[];
+
+/** Return link descriptors rendered in the document head. */
+export type LinksFunction = () => Record<string, string>[];
+
+/** Data route with optional lazy component, preload and document metadata integration. */
+export interface AppRoute extends Route {
+  resolveComponent?: () => ComponentType | undefined;
+  preload?: () => Promise<void>;
+  id?: string;
+  routePath?: string;
+  meta?: MetaFunction;
+}
+
+/** Root document components, loader, metadata and revalidation policy for a React application. */
+export interface RootModule {
+  /** Route identity used by targeted revalidation. Defaults to root. */
+  id?: string;
+  /** Optional registered route URL used to revalidate root data after mutations. */
+  loaderPath?: string;
+  ErrorBoundary?: ComponentType;
+  default: ComponentType;
+  Layout: ComponentType<{ children: ReactNode }>;
+  loader?: (args: LoaderFunctionArgs) => unknown;
+  links?: LinksFunction;
+  meta?: MetaFunction;
+  shouldRevalidate?: (args: RevalidationArgs) => boolean;
+}
+
+/** Serialized root data and route snapshot used to hydrate without repeating initial loaders. */
+export interface Hydration {
+  rootError?: boolean;
+  root: unknown;
+  snapshot: Snapshot;
+}
+
+/** Transform a data transport response using the current request context. */
+export type HandleDataRequestFunction = (
+  response: Response,
+  args: LoaderFunctionArgs,
+) => Response | Promise<Response>;

package/.generated/react/router.ts

@@ -0,0 +1,50 @@
+import { createStore } from "../core/store.ts";
+import { RouterProvider } from "./context.ts";
+import { Outlet } from "./outlet.ts";
+import { Application, type ApplicationContext } from "./root-context.ts";
+import {
+  createElement,
+  type ReactNode,
+  useMemo,
+  useSyncExternalStore,
+} from "./runtime.ts";
+
+/** Root data, document components and request-scoped router for an application. */
+export interface ApplicationProps extends ApplicationContext {
+  document?: boolean;
+  rootStore?: ReturnType<typeof createStore>;
+}
+
+/** Compose a persistent root layout with route views and observable root loader data. */
+export function RouterApplication(props: ApplicationProps): ReactNode {
+  const store = useMemo(
+    () => props.rootStore ?? createStore(props.root),
+    [props.rootStore, props.root],
+  );
+  const root = useSyncExternalStore(
+    store.subscribe,
+    store.getSnapshot,
+    store.getSnapshot,
+  );
+  const snapshot = useSyncExternalStore(
+    props.router.subscribe,
+    props.router.getSnapshot,
+    props.router.getSnapshot,
+  );
+  const route = props.routes.find((item) => item.path === snapshot.path);
+  const Root =
+    snapshot.error && (props.rootError || !route?.ErrorBoundary)
+      ? (props.rootModule?.ErrorBoundary ?? Outlet)
+      : (props.rootModule?.default ?? Outlet);
+  const Layout = props.rootModule?.Layout;
+  const children = createElement(Root);
+  return createElement(
+    RouterProvider,
+    { router: props.router },
+    createElement(
+      Application.Provider,
+      { value: { ...props, root } },
+      props.document && Layout ? createElement(Layout, { children }) : children,
+    ),
+  );
+}

package/.generated/react/runtime.ts

@@ -11,6 +11,7 @@ export type {
 export {
   createContext,
   createElement,
+  useCallback,
   useContext,
   useEffect,
   useMemo,