@rsc-kit/core 0.1.0

package/dist/js/ActivityRouter.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Keeps recently visited pages mounted but hidden, so going back restores them
+ * rather than rebuilding them.
+ *
+ * Rendering each navigation with root.render() unmounts the previous tree, and
+ * unmounting destroys client state: a half-typed form, an open disclosure, a
+ * scrolled list. React's <Activity mode="hidden"> hides a tree without
+ * unmounting it — effects are torn down, but state survives — which is what
+ * makes returning feel like the browser's own back button rather than a reload.
+ *
+ * Retention is bounded. Hidden trees keep their DOM, so an unbounded history
+ * would grow the document for the length of the session; the least recently
+ * visited entry is dropped past the limit.
+ */
+import type { ReactNode } from 'react';
+export interface RouterEntry {
+    /** Identifies the page: its URL, or the intercept variant of one. */
+    key: string;
+    tree: ReactNode;
+}
+export interface ActivityRouterHandle {
+    /** Show `tree` for `key`, retaining whatever was visible before. */
+    show(key: string, tree: ReactNode): void;
+    /** Reveal a retained page without refetching. False when not retained. */
+    restore(key: string): boolean;
+    /** Drop every retained page but the visible one. */
+    clear(): void;
+}
+/** Pages kept alive behind the visible one. Four covers ordinary back-and-forth. */
+export declare const DEFAULT_RETENTION = 4;
+export declare function useActivityRouter(initial: RouterEntry, retention?: number): {
+    entries: RouterEntry[];
+    activeKey: string;
+    handle: ActivityRouterHandle;
+};
+/**
+ * Root of the hydrated app.
+ *
+ * Registers itself with the navigation engine so a navigation becomes a state
+ * update here rather than a fresh root.render(), which is what allows the
+ * previous page to stay mounted.
+ */
+export declare function ActivityRoot({ initialKey, initialTree }: {
+    initialKey: string;
+    initialTree: ReactNode;
+}): import("react").JSX.Element;
+//# sourceMappingURL=ActivityRouter.d.ts.map

package/dist/js/ActivityRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActivityRouter.d.ts","sourceRoot":"","sources":["../../src/js/ActivityRouter.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAItC,MAAM,WAAW,WAAW;IAC1B,qEAAqE;IACrE,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,SAAS,CAAA;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,oEAAoE;IACpE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;IACxC,0EAA0E;IAC1E,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IAC7B,oDAAoD;IACpD,KAAK,IAAI,IAAI,CAAA;CACd;AAED,oFAAoF;AACpF,eAAO,MAAM,iBAAiB,IAAI,CAAA;AAElC,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,WAAW,EACpB,SAAS,GAAE,MAA0B,GACpC;IAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,CA8D7E;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,SAAS,CAAA;CAAE,+BA6BvG"}

package/dist/js/ActivityRouter.js

@@ -0,0 +1,87 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Keeps recently visited pages mounted but hidden, so going back restores them
+ * rather than rebuilding them.
+ *
+ * Rendering each navigation with root.render() unmounts the previous tree, and
+ * unmounting destroys client state: a half-typed form, an open disclosure, a
+ * scrolled list. React's <Activity mode="hidden"> hides a tree without
+ * unmounting it — effects are torn down, but state survives — which is what
+ * makes returning feel like the browser's own back button rather than a reload.
+ *
+ * Retention is bounded. Hidden trees keep their DOM, so an unbounded history
+ * would grow the document for the length of the session; the least recently
+ * visited entry is dropped past the limit.
+ */
+import { Activity, useCallback, useEffect, useRef, useState } from 'react';
+import { setNavigateHandler, setRestoreHandler } from './navigate';
+import { clearSegments, setSegment } from './segmentStore';
+/** Pages kept alive behind the visible one. Four covers ordinary back-and-forth. */
+export const DEFAULT_RETENTION = 4;
+export function useActivityRouter(initial, retention = DEFAULT_RETENTION) {
+    const [entries, setEntries] = useState([initial]);
+    const [activeKey, setActiveKey] = useState(initial.key);
+    // The router calls into this from outside React, where the values captured by
+    // the last render may already be stale. Refs mirror state so those calls read
+    // what is actually mounted.
+    const entriesRef = useRef(entries);
+    const orderRef = useRef([initial.key]);
+    const commit = useCallback((next) => {
+        entriesRef.current = next;
+        setEntries(next);
+    }, []);
+    // Recency, most recent last. Retention is by visit order rather than
+    // insertion, so bouncing between two pages evicts neither.
+    const touch = useCallback((key) => {
+        const next = orderRef.current.filter((k) => k !== key);
+        next.push(key);
+        orderRef.current = next.slice(-Math.max(1, retention));
+        return orderRef.current;
+    }, [retention]);
+    const show = useCallback((key, tree) => {
+        const kept = touch(key);
+        const others = entriesRef.current.filter((entry) => entry.key !== key && kept.includes(entry.key));
+        commit([...others, { key, tree }]);
+        setActiveKey(key);
+    }, [commit, touch]);
+    const restore = useCallback((key) => {
+        if (!entriesRef.current.some((entry) => entry.key === key))
+            return false;
+        touch(key);
+        setActiveKey(key);
+        return true;
+    }, [touch]);
+    const clear = useCallback(() => {
+        const kept = entriesRef.current.filter((entry) => entry.key === activeKey);
+        commit(kept);
+        orderRef.current = [activeKey];
+    }, [activeKey, commit]);
+    const handleRef = useRef({ show, restore, clear });
+    handleRef.current = { show, restore, clear };
+    return { entries, activeKey, handle: handleRef.current };
+}
+/**
+ * Root of the hydrated app.
+ *
+ * Registers itself with the navigation engine so a navigation becomes a state
+ * update here rather than a fresh root.render(), which is what allows the
+ * previous page to stay mounted.
+ */
+export function ActivityRoot({ initialKey, initialTree }) {
+    const { entries, activeKey, handle } = useActivityRouter({ key: initialKey, tree: initialTree });
+    useEffect(() => {
+        setNavigateHandler((tree, key, segmentDepth) => {
+            // A partial payload replaces one segment inside the page that is already
+            // showing; only a whole document is a new page to retain.
+            if (segmentDepth > 0) {
+                setSegment(segmentDepth, key, tree);
+                return;
+            }
+            clearSegments();
+            handle.show(key, tree);
+        });
+        setRestoreHandler((key) => handle.restore(key));
+    }, [handle]);
+    return (_jsx(_Fragment, { children: entries.map((entry) => (_jsx(Activity, { mode: entry.key === activeKey ? 'visible' : 'hidden', children: entry.tree }, entry.key))) }));
+}
+//# sourceMappingURL=ActivityRouter.js.map

package/dist/js/ActivityRouter.js.map

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

package/dist/js/DocumentTitle.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Keeps document.title on the page you are actually looking at.
+ *
+ * A page's <title> is rendered inside its own tree so React 19 hoists it into
+ * <head>, which is right for a server render and wrong the moment a boundary
+ * starts retaining pages. A retained page is still mounted — that is what makes
+ * returning to it restore its state — so its <title> is still in the tree, React
+ * hoists that one too, and <head> ends up holding one per retained page.
+ * `document.title` reads the first, which is the oldest of them: the title lags
+ * a navigation behind, deterministically, and looks like a race because it
+ * depends on which pages happen to be retained.
+ *
+ * An effect settles it, because `<Activity mode="hidden">` tears effects down
+ * and re-runs them on show. Exactly one page's effect is live at a time — the
+ * visible one — so this needs no notion of navigation, history or which tree is
+ * current. It is only rendered on a route that ships a runtime; one that does
+ * not has no router, no retention, and a single <title> that was always right.
+ */
+export declare function DocumentTitle({ title }: {
+    title: string;
+}): null;
+//# sourceMappingURL=DocumentTitle.d.ts.map

package/dist/js/DocumentTitle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentTitle.d.ts","sourceRoot":"","sources":["../../src/js/DocumentTitle.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,QAMzD"}

package/dist/js/DocumentTitle.js

@@ -0,0 +1,28 @@
+"use client";
+import { useEffect } from "react";
+/**
+ * Keeps document.title on the page you are actually looking at.
+ *
+ * A page's <title> is rendered inside its own tree so React 19 hoists it into
+ * <head>, which is right for a server render and wrong the moment a boundary
+ * starts retaining pages. A retained page is still mounted — that is what makes
+ * returning to it restore its state — so its <title> is still in the tree, React
+ * hoists that one too, and <head> ends up holding one per retained page.
+ * `document.title` reads the first, which is the oldest of them: the title lags
+ * a navigation behind, deterministically, and looks like a race because it
+ * depends on which pages happen to be retained.
+ *
+ * An effect settles it, because `<Activity mode="hidden">` tears effects down
+ * and re-runs them on show. Exactly one page's effect is live at a time — the
+ * visible one — so this needs no notion of navigation, history or which tree is
+ * current. It is only rendered on a route that ships a runtime; one that does
+ * not has no router, no retention, and a single <title> that was always right.
+ */
+export function DocumentTitle({ title }) {
+    useEffect(() => {
+        if (document.title !== title)
+            document.title = title;
+    }, [title]);
+    return null;
+}
+//# sourceMappingURL=DocumentTitle.js.map

package/dist/js/DocumentTitle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocumentTitle.js","sourceRoot":"","sources":["../../src/js/DocumentTitle.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,aAAa,CAAC,EAAE,KAAK,EAAqB;IACxD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,QAAQ,CAAC,KAAK,KAAK,KAAK;YAAE,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;IACvD,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEZ,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/js/Form.d.ts

@@ -0,0 +1,54 @@
+import type { Href } from "../routes.js";
+import { type FormHTMLAttributes, type ReactNode } from "react";
+import type { StandardSchemaV1 } from "./standardSchema";
+type PrefetchStrategy = "hover" | "mount" | "none";
+interface FormRenderProps<T extends Record<string, unknown> = Record<string, unknown>> {
+    pending: boolean;
+    data: T;
+    errors: Record<string, string[]>;
+    error: (field: keyof T & string) => string | undefined;
+    clearErrors: (...fields: (keyof T & string)[]) => void;
+    reset: () => void;
+}
+interface FormProps<T extends Record<string, unknown> = Record<string, unknown>> extends Omit<FormHTMLAttributes<HTMLFormElement>, "action" | "method" | "children" | "onSubmit" | "onError"> {
+    action: Href | ((formData: FormData) => Promise<unknown>);
+    method?: "get" | "post";
+    prefetch?: PrefetchStrategy;
+    cacheFor?: number;
+    replace?: boolean;
+    preserveScroll?: boolean;
+    resetOnSuccess?: boolean;
+    /**
+     * Check the fields before submitting, with any Standard Schema — Zod,
+     * Valibot, ArkType.
+     *
+     * A failure fills `errors` and the action is never called, so a mistake
+     * costs no round trip. It is a courtesy and not a control: the same action
+     * is reachable without this form, so the server still has to check.
+     */
+    schema?: StandardSchemaV1;
+    /** Transform form data before submitting to the server action. */
+    transform?: (data: T) => Record<string, unknown>;
+    /** Called inside the transition with typed form data. Use it to call your useOptimistic setter. */
+    optimistic?: (data: T) => void;
+    onSuccess?: (result: unknown) => void;
+    /**
+     * Called when a submit does not succeed.
+     *
+     * Validation failures arrive as field errors, with no second argument.
+     * Anything else arrives as an empty error map and the thrown value — there
+     * are no field errors to report, but the form still has to say so.
+     */
+    onError?: (errors: Record<string, string[]>, error?: unknown) => void;
+    onSubmit?: (formData: FormData) => void | false;
+    children: ReactNode | ((form: FormRenderProps<T>) => ReactNode);
+}
+export declare function useFormStatus<T extends Record<string, unknown> = Record<string, unknown>>(): FormRenderProps<T>;
+/**
+ * Also exported by name, and re-exported below, because both spellings are in
+ * use: `import Form from` and `import { Form } from`.
+ */
+export default function Form<T extends Record<string, unknown> = Record<string, unknown>>({ action, method: methodProp, prefetch, cacheFor, replace, preserveScroll, resetOnSuccess, schema, transform, optimistic, onSuccess, onError, onSubmit, children, ...rest }: FormProps<T>): import("react").JSX.Element;
+export { Form };
+export { useForm } from "./useForm";
+//# sourceMappingURL=Form.d.ts.map

package/dist/js/Form.d.ts.map

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

package/dist/js/Form.js

@@ -0,0 +1,225 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useEffect, useRef, useState, useTransition, } from "react";
+import { ServerValidationError, ServerDumpError } from "./errors";
+import { validateWith } from "./standardSchema";
+/**
+ * What an action built with createActionClient answers with.
+ *
+ * Recognised rather than thrown, because React serialises a rejected server
+ * action opaquely: production strips the message and the fields it named are
+ * gone. A returned object crosses intact, so a form reads it.
+ */
+function resultOf(value) {
+    if (typeof value !== 'object' || value === null)
+        return null;
+    const result = value;
+    if (result.validationErrors)
+        return { errors: result.validationErrors };
+    if (result.serverError)
+        return { serverError: result.serverError };
+    return null;
+}
+const FormStatusContext = createContext({
+    pending: false,
+    data: {},
+    errors: {},
+    error: () => undefined,
+    clearErrors: () => { },
+    reset: () => { },
+});
+export function useFormStatus() {
+    return useContext(FormStatusContext);
+}
+function formDataToObject(formData) {
+    const obj = {};
+    for (const [key, value] of formData.entries()) {
+        if (typeof value === "string") {
+            obj[key] = value;
+        }
+    }
+    return obj;
+}
+/**
+ * Also exported by name, and re-exported below, because both spellings are in
+ * use: `import Form from` and `import { Form } from`.
+ */
+export default function Form({ action, method: methodProp, prefetch = "hover", cacheFor, replace = false, preserveScroll = false, resetOnSuccess = true, schema, transform, optimistic, onSuccess, onError, onSubmit, children, ...rest }) {
+    const isGetForm = typeof action === "string";
+    const method = methodProp ?? (isGetForm ? "get" : "post");
+    const [errors, setErrors] = useState({});
+    const [currentData, setCurrentData] = useState({});
+    const [isPending, startTransition] = useTransition();
+    const formRef = useRef(null);
+    const error = useCallback((field) => errors[field]?.[0], [errors]);
+    const clearErrors = useCallback((...fields) => {
+        if (fields.length === 0) {
+            setErrors({});
+        }
+        else {
+            setErrors((prev) => {
+                const next = { ...prev };
+                for (const f of fields) {
+                    delete next[f];
+                }
+                return next;
+            });
+        }
+    }, []);
+    const resetForm = useCallback(() => {
+        formRef.current?.reset();
+        setErrors({});
+        setCurrentData({});
+    }, []);
+    useEffect(() => {
+        if (isGetForm && prefetch === "mount") {
+            const fn = window.__rsc_prefetch;
+            fn?.(action, cacheFor);
+        }
+    }, [isGetForm, prefetch, action, cacheFor]);
+    const doPrefetch = useCallback(() => {
+        if (!isGetForm)
+            return;
+        const fn = window.__rsc_prefetch;
+        fn?.(action, cacheFor);
+    }, [isGetForm, action, cacheFor]);
+    const handleSubmit = useCallback(async (e) => {
+        e.preventDefault();
+        const formData = new FormData(e.currentTarget);
+        const data = formDataToObject(formData);
+        setCurrentData(data);
+        if (onSubmit?.(formData) === false) {
+            return;
+        }
+        if (isGetForm && method === "get") {
+            const url = new URL(action, window.location.origin);
+            for (const [key, value] of formData.entries()) {
+                if (typeof value === "string" && value !== "") {
+                    url.searchParams.set(key, value);
+                }
+            }
+            const path = url.pathname + url.search;
+            const shell = action;
+            const nav = window.__rsc_navigate;
+            const prefetched = window.__rsc_is_prefetched;
+            // The route without its query is that route's shell: the layout, the
+            // chrome, and whatever it renders with nothing to show yet. Prefetching
+            // on hover put it in the cache, so going there first costs no request
+            // and puts the page on screen while the real query is still running.
+            //
+            // The query itself is never prefetched. It is the expensive half, and
+            // hovering a search button is not a reason to run someone's search.
+            if (path !== shell && prefetched?.(shell)) {
+                // Awaited rather than raced: navigate() aborts whatever is in flight,
+                // so starting the real one first would cancel the shell before it
+                // could render. It is a cache hit, so this is a render, not a wait.
+                Promise.resolve(nav?.(shell, { replace, preserveScroll })).then(() => 
+                // Replaces, so the shell does not become a back-button stop of its
+                // own — the pair leaves exactly one entry behind.
+                nav?.(path, { replace: true, preserveScroll }));
+                return;
+            }
+            nav?.(path, { replace, preserveScroll });
+            return;
+        }
+        const serverAction = action;
+        // Apply transform — rebuild FormData from transformed values
+        if (transform) {
+            const transformed = transform(data);
+            for (const key of [...formData.keys()]) {
+                formData.delete(key);
+            }
+            for (const [key, val] of Object.entries(transformed)) {
+                if (val === null || val === undefined)
+                    continue;
+                if (val instanceof File) {
+                    formData.append(key, val);
+                }
+                else if (typeof val === "boolean") {
+                    formData.append(key, val ? "1" : "0");
+                }
+                else if (Array.isArray(val)) {
+                    for (const item of val) {
+                        formData.append(`${key}[]`, String(item));
+                    }
+                }
+                else {
+                    formData.append(key, String(val));
+                }
+            }
+        }
+        setErrors({});
+        // Before the transition, so a failure neither runs the optimistic
+        // update nor leaves the form looking like it is submitting.
+        const invalid = await validateWith(schema, data);
+        if (invalid) {
+            setErrors(invalid);
+            onError?.(invalid);
+            return;
+        }
+        startTransition(async () => {
+            try {
+                // Call optimistic updater inside the transition so React's
+                // useOptimistic picks it up and auto-reverts on settle.
+                optimistic?.(data);
+                const result = await serverAction(formData);
+                const refused = resultOf(result);
+                if (refused) {
+                    if (refused.errors) {
+                        setErrors(refused.errors);
+                        onError?.(refused.errors);
+                    }
+                    else {
+                        onError?.({}, new Error(refused.serverError));
+                    }
+                    return;
+                }
+                if (resetOnSuccess) {
+                    formRef.current?.reset();
+                    setCurrentData({});
+                }
+                setErrors({});
+                onSuccess?.(result);
+            }
+            catch (err) {
+                if (err instanceof ServerValidationError) {
+                    setErrors(err.errors);
+                    onError?.(err.errors);
+                }
+                else if (err instanceof ServerDumpError) {
+                    // Dump overlay is already shown — silently swallow
+                }
+                else if (onError) {
+                    // Not rethrown. A rejected action never settles, and until it
+                    // settles React keeps the optimistic update on screen — so an
+                    // unexpected failure left the row showing as though the write had
+                    // worked. Settling is what takes it back.
+                    onError({}, err);
+                }
+                else {
+                    // Nothing is handling it, and swallowing here would lose it
+                    // entirely — the reason this used to rethrow.
+                    console.error('[rsc-kit] form submit failed', err);
+                }
+            }
+        });
+    }, [action, isGetForm, method, replace, preserveScroll, resetOnSuccess, schema, transform, optimistic, onSubmit, onSuccess, onError]);
+    const formStatus = {
+        pending: isPending,
+        data: currentData,
+        errors,
+        error,
+        clearErrors,
+        reset: resetForm,
+    };
+    return (_jsx(FormStatusContext.Provider, { value: formStatus, children: _jsx("form", { ref: formRef, onSubmit: handleSubmit, onMouseEnter: prefetch === "hover" ? doPrefetch : undefined, "data-pending": isPending ? "" : undefined, ...rest, children: typeof children === "function" ? children(formStatus) : children }) }));
+}
+// Also by name, because both spellings are in use: `import Form` and
+// `import { Form }`. This was a re-export of "./Form" — from inside Form.tsx,
+// so the module named itself. It survived on the bundler tolerating a circular
+// self-reference, left over from when a separate barrel re-exported a
+// FormComponent.tsx that a case-insensitive filesystem would not let be called
+// Form.ts. There is one file now, and it can just export what it declares.
+export { Form };
+export { useForm } from "./useForm";
+//# sourceMappingURL=Form.js.map

package/dist/js/Form.js.map

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

package/dist/js/Link.d.ts

@@ -0,0 +1,29 @@
+import type { Href } from "../routes.js";
+import { type AnchorHTMLAttributes, type Ref } from "react";
+type PrefetchStrategy = "hover" | "mount" | "click" | "none" | boolean;
+interface LinkProps extends Omit<AnchorHTMLAttributes<HTMLAnchorElement>, "href"> {
+    /**
+     * Where this goes. Typed to the routes the build found, so a link to a page
+     * that does not exist stops compiling; `path as Href` when it is computed.
+     */
+    href: Href;
+    /**
+     * The underlying anchor.
+     *
+     * Spread onto it like any other prop — React 19 passes ref through a
+     * function component without forwardRef — but declared here because it is
+     * not part of AnchorHTMLAttributes. A link that cannot be focused is a link
+     * a dialog cannot move focus to when it opens.
+     */
+    ref?: Ref<HTMLAnchorElement>;
+    prefetch?: PrefetchStrategy;
+    cacheFor?: number;
+    replace?: boolean;
+    preserveScroll?: boolean;
+}
+export declare function useLinkStatus(): {
+    pending: boolean;
+};
+export default function Link({ href, prefetch: prefetchProp, cacheFor, replace, preserveScroll, children, onClick, onMouseEnter, onMouseLeave, ...rest }: LinkProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=Link.d.ts.map

package/dist/js/Link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Link.d.ts","sourceRoot":"","sources":["../../src/js/Link.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EACL,KAAK,oBAAoB,EAEzB,KAAK,GAAG,EAOT,MAAM,OAAO,CAAC;AAEf,KAAK,gBAAgB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAEvE,UAAU,SAAU,SAAQ,IAAI,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC/E;;;OAGG;IACH,IAAI,EAAE,IAAI,CAAC;IACX;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC7B,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAID,wBAAgB,aAAa,IAAI;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAEpD;AAgCD,MAAM,CAAC,OAAO,UAAU,IAAI,CAAC,EAC3B,IAAI,EACJ,QAAQ,EAAE,YAAsB,EAChC,QAAQ,EACR,OAAe,EACf,cAAsB,EACtB,QAAQ,EACR,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,GAAG,IAAI,EACR,EAAE,SAAS,+BAiHX"}

package/dist/js/Link.js

@@ -0,0 +1,112 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useEffect, useRef, useState, } from "react";
+const LinkStatusContext = createContext({ pending: false });
+export function useLinkStatus() {
+    return useContext(LinkStatusContext);
+}
+function isExternalUrl(url) {
+    try {
+        return new URL(url, window.location.origin).origin !== window.location.origin;
+    }
+    catch {
+        return false;
+    }
+}
+function shouldInterceptClick(e) {
+    return (!e.defaultPrevented &&
+        e.button === 0 &&
+        !e.metaKey &&
+        !e.ctrlKey &&
+        !e.shiftKey &&
+        !e.altKey);
+}
+/**
+ * How long a pointer has to settle on a link before it prefetches.
+ *
+ * A pointer crossing a nav bar enters every link on the way, and each one used
+ * to fire a request immediately — enough to fill the browser's per-origin
+ * connection limit with pages the user never meant to visit. Waiting is close
+ * to free: the prefetch only has to beat the click, and a click that follows a
+ * hover this short would not have had its payload back anyway.
+ */
+const HOVER_PREFETCH_DELAY_MS = 100;
+export default function Link({ href, prefetch: prefetchProp = "hover", cacheFor, replace = false, preserveScroll = false, children, onClick, onMouseEnter, onMouseLeave, ...rest }) {
+    const [pending, setPending] = useState(false);
+    const hoverTimer = useRef(null);
+    const prefetchStrategy = prefetchProp === true
+        ? "hover"
+        : prefetchProp === false
+            ? "none"
+            : prefetchProp;
+    const doPrefetch = useCallback(() => {
+        if (isExternalUrl(href))
+            return;
+        const fn = window.__rsc_prefetch;
+        fn?.(href, cacheFor);
+    }, [href, cacheFor]);
+    // Only useEffect needed: prefetch on mount strategy
+    useEffect(() => {
+        if (prefetchStrategy === "mount") {
+            doPrefetch();
+        }
+    }, [prefetchStrategy, doPrefetch]);
+    const handleClick = useCallback((e) => {
+        onClick?.(e);
+        if (e.defaultPrevented)
+            return;
+        const target = e.currentTarget.target;
+        if (target && target !== "_self")
+            return;
+        if (!shouldInterceptClick(e) || isExternalUrl(href))
+            return;
+        // Hash-only links (#section) — let the browser scroll natively
+        if (href.startsWith("#"))
+            return;
+        e.preventDefault();
+        setPending(true);
+        // navigate() returns a Promise — clear pending when it resolves or rejects
+        const nav = window.__rsc_navigate;
+        const promise = nav?.(href, { replace, preserveScroll });
+        promise?.then(() => setPending(false), () => setPending(false));
+    }, [href, replace, preserveScroll, onClick]);
+    const handleMouseEnter = useCallback((e) => {
+        onMouseEnter?.(e);
+        if (prefetchStrategy !== "hover" && prefetchStrategy !== "click")
+            return;
+        if (hoverTimer.current !== null)
+            clearTimeout(hoverTimer.current);
+        hoverTimer.current = setTimeout(() => {
+            hoverTimer.current = null;
+            doPrefetch();
+        }, HOVER_PREFETCH_DELAY_MS);
+    }, [prefetchStrategy, doPrefetch, onMouseEnter]);
+    const handleMouseLeave = useCallback((e) => {
+        onMouseLeave?.(e);
+        // Never fired: the pointer passed over on its way somewhere else.
+        if (hoverTimer.current !== null) {
+            clearTimeout(hoverTimer.current);
+            hoverTimer.current = null;
+        }
+        // Already in flight: give the connection back to whatever the pointer is
+        // heading for. A prefetch that has landed is kept — see cancelPrefetch.
+        if (isExternalUrl(href))
+            return;
+        window.__rsc_cancel_prefetch?.(href);
+    }, [href, onMouseLeave]);
+    // Touch gets no delay. There is no hovering to disambiguate — a touch is
+    // already the start of a tap — and touchstart leads the click by little
+    // enough that spending any of it waiting would waste the head start.
+    const handleTouchStart = useCallback(() => {
+        if (prefetchStrategy === "hover" || prefetchStrategy === "click") {
+            doPrefetch();
+        }
+    }, [prefetchStrategy, doPrefetch]);
+    // A link unmounted mid-hover (navigating away) must not prefetch afterwards.
+    useEffect(() => () => {
+        if (hoverTimer.current !== null)
+            clearTimeout(hoverTimer.current);
+    }, []);
+    return (_jsx(LinkStatusContext.Provider, { value: { pending }, children: _jsx("a", { href: href, onClick: handleClick, onMouseEnter: handleMouseEnter, onMouseLeave: handleMouseLeave, onTouchStart: handleTouchStart, "data-pending": pending ? "" : undefined, ...rest, children: children }) }));
+}
+//# sourceMappingURL=Link.js.map