@rsc-kit/core 0.1.0

package/dist/js/Link.js.map

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

package/dist/js/PathnameProvider.d.ts

@@ -0,0 +1,8 @@
+import type { ReactNode } from "react";
+export declare function PathnameProvider({ value, children }: {
+    value: string;
+    children: ReactNode;
+}): import("react").JSX.Element;
+/** What the server rendered. On the client this is the url it was hydrated with. */
+export declare function useRenderedPathname(): string;
+//# sourceMappingURL=PathnameProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PathnameProvider.d.ts","sourceRoot":"","sources":["../../src/js/PathnameProvider.tsx"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,wBAAgB,gBAAgB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,+BAE3F;AAED,oFAAoF;AACpF,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C"}

package/dist/js/PathnameProvider.js

@@ -0,0 +1,24 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * The url the server rendered, handed to the client hooks.
+ *
+ * usePathname used to answer "/" during a server render, because a hook has no
+ * props and the module had nothing else to go on. Every prerendered page
+ * therefore shipped with the wrong link marked active, corrected only once
+ * hydration ran — a visible flash, and simply wrong on a route that ships no
+ * client runtime at all.
+ *
+ * A context rather than a module-level variable: two requests render at once
+ * in the same process, and a variable would hand one page the other's url.
+ */
+import { createContext, useContext } from "react";
+const PathnameContext = createContext("/");
+export function PathnameProvider({ value, children }) {
+    return _jsx(PathnameContext.Provider, { value: value, children: children });
+}
+/** What the server rendered. On the client this is the url it was hydrated with. */
+export function useRenderedPathname() {
+    return useContext(PathnameContext);
+}
+//# sourceMappingURL=PathnameProvider.js.map

package/dist/js/PathnameProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PathnameProvider.js","sourceRoot":"","sources":["../../src/js/PathnameProvider.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAGlD,MAAM,eAAe,GAAG,aAAa,CAAS,GAAG,CAAC,CAAC;AAEnD,MAAM,UAAU,gBAAgB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAA0C;IAC1F,OAAO,KAAC,eAAe,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAA4B,CAAC;AACvF,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,mBAAmB;IACjC,OAAO,UAAU,CAAC,eAAe,CAAC,CAAC;AACrC,CAAC"}

package/dist/js/RedirectBoundary.d.ts

@@ -0,0 +1,18 @@
+import { Component } from "react";
+import type { ErrorInfo, ReactNode } from "react";
+interface Props {
+    children: ReactNode;
+    /** Shown while the navigation is in flight. Null keeps the space empty. */
+    fallback?: ReactNode;
+}
+interface State {
+    redirecting: boolean;
+}
+export declare class RedirectBoundary extends Component<Props, State> {
+    state: State;
+    static getDerivedStateFromError(error: unknown): State | null;
+    componentDidCatch(error: unknown, _info: ErrorInfo): void;
+    render(): ReactNode;
+}
+export {};
+//# sourceMappingURL=RedirectBoundary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RedirectBoundary.d.ts","sourceRoot":"","sources":["../../src/js/RedirectBoundary.tsx"],"names":[],"mappings":"AAqBA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIlD,UAAU,KAAK;IACb,QAAQ,EAAE,SAAS,CAAC;IACpB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,UAAU,KAAK;IACb,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,gBAAiB,SAAQ,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC;IAC3D,KAAK,EAAE,KAAK,CAA0B;IAEtC,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,GAAG,IAAI,CAM5D;IAED,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAcxD;IAED,MAAM,IAAI,SAAS,CAIlB;CACF"}

package/dist/js/RedirectBoundary.js

@@ -0,0 +1,34 @@
+"use client";
+import { Component } from "react";
+import { parseRedirectDigest } from "../redirectDigest.js";
+import { visit } from "./router";
+export class RedirectBoundary extends Component {
+    state = { redirecting: false };
+    static getDerivedStateFromError(error) {
+        // Reading `digest` rather than the message: React replaces a server
+        // error's message in production and transmits the digest either way.
+        return parseRedirectDigest(error?.digest)
+            ? { redirecting: true }
+            : null;
+    }
+    componentDidCatch(error, _info) {
+        const target = parseRedirectDigest(error?.digest);
+        if (!target)
+            throw error;
+        // An SPA navigation, not a location assignment: the layouts above this
+        // boundary are already mounted and correct, so replacing the document
+        // would throw away state the user can see — including whatever they had
+        // typed into a page that is only being redirected past.
+        //
+        // replace, because the url being left never became a page the user was
+        // on; leaving a history entry for it means Back returns to a redirect.
+        // The server chose this, so it is not one of the app's authored hrefs.
+        void visit(target.location, { replace: true });
+    }
+    render() {
+        if (this.state.redirecting)
+            return this.props.fallback ?? null;
+        return this.props.children;
+    }
+}
+//# sourceMappingURL=RedirectBoundary.js.map

package/dist/js/RedirectBoundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RedirectBoundary.js","sourceRoot":"","sources":["../../src/js/RedirectBoundary.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAqBb,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAYjC,MAAM,OAAO,gBAAiB,SAAQ,SAAuB;IAC3D,KAAK,GAAU,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAEtC,MAAM,CAAC,wBAAwB,CAAC,KAAc;QAC5C,oEAAoE;QACpE,qEAAqE;QACrE,OAAO,mBAAmB,CAAE,KAA8B,EAAE,MAAM,CAAC;YACjE,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE;YACvB,CAAC,CAAC,IAAI,CAAC;IACX,CAAC;IAED,iBAAiB,CAAC,KAAc,EAAE,KAAgB;QAChD,MAAM,MAAM,GAAG,mBAAmB,CAAE,KAA8B,EAAE,MAAM,CAAC,CAAC;QAE5E,IAAI,CAAC,MAAM;YAAE,MAAM,KAAK,CAAC;QAEzB,uEAAuE;QACvE,sEAAsE;QACtE,wEAAwE;QACxE,wDAAwD;QACxD,EAAE;QACF,uEAAuE;QACvE,uEAAuE;QACvE,uEAAuE;QACvE,KAAK,KAAK,CAAC,MAAM,CAAC,QAAgB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,MAAM;QACJ,IAAI,IAAI,CAAC,KAAK,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC;QAE/D,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC7B,CAAC;CACF"}

package/dist/js/SegmentBoundary.d.ts

@@ -0,0 +1,8 @@
+import type { ReactNode } from 'react';
+export declare function SegmentBoundary({ depth, pageKey, children, }: {
+    depth: number;
+    /** The page these server-rendered children belong to. */
+    pageKey?: string;
+    children: ReactNode;
+}): import("react").JSX.Element;
+//# sourceMappingURL=SegmentBoundary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SegmentBoundary.d.ts","sourceRoot":"","sources":["../../src/js/SegmentBoundary.tsx"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAItC,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,OAAO,EACP,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,SAAS,CAAA;CACpB,+BA8BA"}

package/dist/js/SegmentBoundary.js

@@ -0,0 +1,38 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * The point in the tree a navigation can replace on its own.
+ *
+ * Sits between a layout and its children, so showing a different segment
+ * re-renders from here down and leaves the layouts above it mounted. Server
+ * components cannot be re-rendered on the client, which is why the seam has to
+ * be a client component reading from a store rather than the layout itself.
+ *
+ * Pages it has already shown stay mounted behind <Activity mode="hidden">.
+ * Hidden is not unmounted: effects are torn down but state survives, so
+ * returning to a page brings back the form you were filling in. Rendering only
+ * the current one would throw that away, which is what replacing the root did.
+ */
+import { Activity, useEffect, useSyncExternalStore } from 'react';
+import { RedirectBoundary } from './RedirectBoundary';
+import { getSegmentState, seedSegment, subscribeToSegment } from './segmentStore';
+export function SegmentBoundary({ depth, pageKey, children, }) {
+    const state = useSyncExternalStore((listener) => subscribeToSegment(depth, listener), () => getSegmentState(depth), 
+    // On the server the tree being rendered IS the current one, so there is
+    // never an override; returning null keeps hydration from mismatching.
+    () => null);
+    // Record the page we arrived on, so a later navigation away and back can
+    // return to it. Without this the first page is the one page you cannot keep.
+    useEffect(() => {
+        if (pageKey)
+            seedSegment(depth, pageKey, children);
+    }, [depth, pageKey, children]);
+    // Wrapped here rather than around the whole app because this is the closest
+    // client component above a page: a redirect thrown inside the page's own
+    // Suspense boundary surfaces at the nearest error boundary, and catching it
+    // here leaves the layouts above mounted while the navigation runs.
+    if (!state)
+        return _jsx(RedirectBoundary, { children: children });
+    return (_jsx(RedirectBoundary, { children: state.entries.map((entry) => (_jsx(Activity, { mode: entry.key === state.activeKey ? 'visible' : 'hidden', children: entry.tree }, entry.key))) }));
+}
+//# sourceMappingURL=SegmentBoundary.js.map

package/dist/js/SegmentBoundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SegmentBoundary.js","sourceRoot":"","sources":["../../src/js/SegmentBoundary.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAA;AAEjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAEjF,MAAM,UAAU,eAAe,CAAC,EAC9B,KAAK,EACL,OAAO,EACP,QAAQ,GAMT;IACC,MAAM,KAAK,GAAG,oBAAoB,CAChC,CAAC,QAAQ,EAAE,EAAE,CAAC,kBAAkB,CAAC,KAAK,EAAE,QAAQ,CAAC,EACjD,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC;IAC5B,wEAAwE;IACxE,sEAAsE;IACtE,GAAG,EAAE,CAAC,IAAI,CACX,CAAA;IAED,yEAAyE;IACzE,6EAA6E;IAC7E,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO;YAAE,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAA;IACpD,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAA;IAE9B,4EAA4E;IAC5E,yEAAyE;IACzE,4EAA4E;IAC5E,mEAAmE;IACnE,IAAI,CAAC,KAAK;QAAE,OAAO,KAAC,gBAAgB,cAAE,QAAQ,GAAoB,CAAA;IAElE,OAAO,CACL,KAAC,gBAAgB,cACd,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAC5B,KAAC,QAAQ,IAAiB,IAAI,EAAE,KAAK,CAAC,GAAG,KAAK,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,YACjF,KAAK,CAAC,IAAiB,IADX,KAAK,CAAC,GAAG,CAEb,CACZ,CAAC,GACe,CACpB,CAAA;AACH,CAAC"}

package/dist/js/SlotBoundary.d.ts

@@ -0,0 +1,15 @@
+import type { ReactNode } from "react";
+/**
+ * The seam a re-rendered slot is swapped in at.
+ *
+ * Server components cannot be re-rendered in the browser, so the swap point
+ * has to be a client component reading from a store. With nothing stored it
+ * renders what the server sent with the page — which is the behaviour that
+ * existed before slots could be revalidated, and is what makes this safe to
+ * wrap every slot in.
+ */
+export declare function SlotBoundary({ name, children }: {
+    name: string;
+    children: ReactNode;
+}): ReactNode;
+//# sourceMappingURL=SlotBoundary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SlotBoundary.d.ts","sourceRoot":"","sources":["../../src/js/SlotBoundary.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,GAOvB,SAAS,CACvE"}

package/dist/js/SlotBoundary.js

@@ -0,0 +1,17 @@
+"use client";
+import { useSyncExternalStore } from "react";
+import { getSlotState, subscribeToSlot } from "./slotStore";
+/**
+ * The seam a re-rendered slot is swapped in at.
+ *
+ * Server components cannot be re-rendered in the browser, so the swap point
+ * has to be a client component reading from a store. With nothing stored it
+ * renders what the server sent with the page — which is the behaviour that
+ * existed before slots could be revalidated, and is what makes this safe to
+ * wrap every slot in.
+ */
+export function SlotBoundary({ name, children }) {
+    const state = useSyncExternalStore((listener) => subscribeToSlot(name, listener), () => getSlotState(name), () => getSlotState(name));
+    return (state.tree === undefined ? children : state.tree);
+}
+//# sourceMappingURL=SlotBoundary.js.map

package/dist/js/SlotBoundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SlotBoundary.js","sourceRoot":"","sources":["../../src/js/SlotBoundary.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAE7C,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE5D;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAyC;IACpF,MAAM,KAAK,GAAG,oBAAoB,CAChC,CAAC,QAAQ,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,EAC7C,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,EACxB,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CACzB,CAAC;IAEF,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAc,CAAC;AACzE,CAAC"}

package/dist/js/createViteRscApp.d.ts

@@ -0,0 +1,8 @@
+export declare function createViteRscApp(container?: Document | Element, interceptEntries?: {
+    urlPattern: string;
+    slot: string;
+}[], options?: {
+    staticPayloads?: string | null;
+    routes?: unknown[] | null;
+}): Promise<void>;
+//# sourceMappingURL=createViteRscApp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createViteRscApp.d.ts","sourceRoot":"","sources":["../../src/js/createViteRscApp.ts"],"names":[],"mappings":"AAoCA,wBAAsB,gBAAgB,CACpC,SAAS,GAAE,QAAQ,GAAG,OAAkB,EACxC,gBAAgB,GAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAO,EAC7D,OAAO,GAAE;IAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;CAAO,GAC1E,OAAO,CAAC,IAAI,CAAC,CA0Mf"}

package/dist/js/createViteRscApp.js

@@ -0,0 +1,185 @@
+import { isSafeRedirect } from "../safeUrl.js";
+import { createFromReadableStream, encodeReply, setServerCallback } from "@vitejs/plugin-rsc/browser";
+import { createElement } from "react";
+import { hydrateRoot } from "react-dom/client";
+import { ActivityRoot } from "./ActivityRouter";
+import { ServerRedirectError, throwForFailedAction } from "./errors";
+import { fetchPagePayload } from "./pagePayload";
+import { clearSegments, restoreSegments, setSegment } from "./segmentStore";
+import { cancelPrefetch, isPrefetched, navigate, refresh, applyRevalidated, prefetch, retentionKey, setCallServer, setHeldLayouts, setStaticPayloads, setStaticRoutes, seedStaticChain, payloadUrl, setDeserializer, setInterceptManifest, setNavigateHandler, setRestoreHandler, setVersion, } from "./navigate";
+export async function createViteRscApp(container = document, interceptEntries = [], options = {}) {
+    // An exported build has no server to negotiate with, so payloads live at
+    // their own urls rather than behind a header on the page's url.
+    setStaticPayloads(options.staticPayloads ?? null);
+    // Only an exported build ships this: with no server to negotiate with, the
+    // client works out for itself how much of a page it still holds.
+    if (options.routes)
+        setStaticRoutes(options.routes);
+    // The router has to recognise an intercepted link before it asks the server,
+    // so the patterns are baked into the generated browser entry. Without them
+    // every intercepted route falls through to a full-page navigation.
+    setInterceptManifest(interceptEntries);
+    async function callServer(id, args) {
+        const encoded = await encodeReply(args);
+        // encodeReply returns FormData as soon as an argument contains a File.
+        // Sending that as multipart would make PHP consume php://input while
+        // parsing it, leaving the action with an empty body — so serialize it to
+        // raw bytes under an opaque content-type and send the real one in
+        // X-RSC-Content-Type for the worker to rebuild FormData from.
+        let body;
+        let realContentType;
+        if (encoded instanceof FormData) {
+            const serialized = new Response(encoded);
+            body = await serialized.arrayBuffer();
+            realContentType = serialized.headers.get("content-type") ?? "multipart/form-data";
+        }
+        else {
+            body = encoded;
+            realContentType = "text/plain;charset=UTF-8";
+        }
+        const res = await fetch("/_rsc/action", {
+            method: "POST",
+            headers: {
+                "X-RSC-Action": id,
+                // Where the action was invoked from. The host resolves it to the
+                // components that render the page, so anything the action says it
+                // invalidated can come back with the answer instead of being fetched
+                // afterwards.
+                "X-RSC-Referer": window.location.pathname + window.location.search,
+                "X-RSC-Content-Type": realContentType,
+                "Content-Type": "application/octet-stream",
+                "X-XSRF-TOKEN": decodeURIComponent(document.cookie.match(/XSRF-TOKEN=([^;]+)/)?.[1] ?? ""),
+            },
+            body,
+        });
+        // A failed action does not answer with a Flight stream, and the decoder
+        // cannot tell — it reports its own parse failure instead of what the
+        // server said.
+        try {
+            await throwForFailedAction(res);
+        }
+        catch (err) {
+            // A redirect is an instruction, not something for a form to display:
+            // an expired session answers this way, and the destination is the login
+            // page rather than a message about one.
+            if (err instanceof ServerRedirectError) {
+                // The destination came off a response header, so it is checked here
+                // too — the engine refuses these at the source, but a proxy or a host
+                // in front of it can write whatever it likes.
+                if (isSafeRedirect(err.location))
+                    window.location.href = err.location;
+            }
+            throw err;
+        }
+        const answer = await createFromReadableStream(res.body, { callServer });
+        return unwrapRevalidated(answer);
+    }
+    /**
+     * Put anything the action re-rendered on screen, and hand back its result.
+     *
+     * The trees travel with the answer rather than being fetched afterwards, so
+     * the caller sees only what its action returned and never knows the page
+     * was updated around it.
+     */
+    function unwrapRevalidated(answer) {
+        if (answer === null || typeof answer !== "object" || !("__rscRevalidated" in answer)) {
+            return answer;
+        }
+        const envelope = answer;
+        for (const [target, tree] of Object.entries(envelope.__rscRevalidated)) {
+            applyRevalidated(target, tree);
+        }
+        return envelope.result;
+    }
+    setDeserializer(createFromReadableStream);
+    setCallServer(callServer);
+    // The plugin's own "use server" client stubs route through its registered
+    // server callback — register the same transport there too.
+    setServerCallback(callServer);
+    // Link / Form / router live in a separate build graph and reach the SPA
+    // engine through these globals.
+    window.__rsc_navigate = navigate;
+    window.__rsc_prefetch = prefetch;
+    window.__rsc_cancel_prefetch =
+        cancelPrefetch;
+    window.__rsc_is_prefetched =
+        isPrefetched;
+    window.__rsc_refresh = refresh;
+    // Hydrate from the RSC endpoint (same url + X-RSC, no version header).
+    //
+    // Everything from here to the decode is failure handling, because this is
+    // the one request with nothing watching it. A page whose shell is already
+    // rendered looks fine while this fails, and its fallbacks stay on screen
+    // indefinitely with nothing reported anywhere.
+    const res = await fetchPagePayload(payloadUrl(window.location.href));
+    // Seed the SPA engine with the build this page was served from, so a
+    // redeploy mid-session is caught on the next navigation. This matters most
+    // behind a CDN, where the shell may be cached from an older build.
+    const servedVersion = res.headers.get("X-RSC-Version");
+    if (servedVersion) {
+        setVersion(servedVersion);
+    }
+    // The chain this page is built from, so the next navigation can say what is
+    // already mounted and be sent only what changed.
+    // A server says what this page is built from; a file server says nothing,
+    // so an exported build works it out from the table it was given.
+    const servedLayouts = res.headers.get("X-RSC-Layouts");
+    if (servedLayouts !== null) {
+        setHeldLayouts(servedLayouts.split(","));
+    }
+    else if (!seedStaticChain(window.location.href)) {
+        setHeldLayouts([]);
+    }
+    const tree = await createFromReadableStream(res.body, { callServer });
+    // Retaining the previous page behind <Activity> needs a wrapper above the
+    // page, and React will not hydrate a *document* container through one: the
+    // root child of a document has to be <html>, and wrapping it hangs the
+    // renderer outright (React 19.2.7). An app whose root layout owns <html>
+    // therefore hydrates the tree directly and navigations replace it, as before.
+    //
+    // Apps that hydrate into an element get retention. Giving it to document-
+    // rooted apps means SPA navigation returning only the changed segment rather
+    // than a whole document, which is an engine change, not a client one.
+    const retains = container !== document;
+    const shell = retains
+        ? createElement(ActivityRoot, {
+            initialKey: retentionKey(window.location.href, null),
+            initialTree: tree,
+        })
+        : tree;
+    const root = hydrateRoot(container, shell, {
+        onRecoverableError(error, errorInfo) {
+            // A PPR shell is served with its Suspense boundaries deliberately
+            // unfinished — the build aborts the render once the static part is out.
+            // React reports that as #419 and client-renders the boundary from the
+            // Flight payload, which is the intended path, not a fault to report.
+            const message = String(error?.message ?? error);
+            if (message.includes("419") || message.includes("did not finish this Suspense boundary")) {
+                return;
+            }
+            console.error(error, errorInfo);
+        },
+    });
+    // Depth 0 is a whole document and replaces the root. Anything deeper is one
+    // segment: handing it to the boundary at that depth leaves the layouts above
+    // it mounted, which is the point of asking for a partial render at all.
+    setNavigateHandler((tree, key, segmentDepth) => {
+        const newTree = tree;
+        if (segmentDepth > 0) {
+            setSegment(segmentDepth, key, newTree);
+            return;
+        }
+        clearSegments();
+        root.render(newTree);
+    });
+    // Back and forward reveal a page the boundaries are still holding, with the
+    // form you were filling in still filled in, and without asking the server.
+    setRestoreHandler((key) => restoreSegments(key));
+    window.addEventListener("popstate", () => {
+        // restore: back and forward reveal the page you were on, with its state.
+        // Wherever the browser just went; not a literal this app wrote.
+        navigate(window.location.href, { replace: true, restore: true });
+    });
+    history.replaceState({ rscUrl: window.location.href }, "", window.location.href);
+}
+//# sourceMappingURL=createViteRscApp.js.map

package/dist/js/createViteRscApp.js.map

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

package/dist/js/errors.d.ts

@@ -0,0 +1,51 @@
+export declare class ServerValidationError extends Error {
+    readonly errors: Record<string, string[]>;
+    constructor(message: string, errors: Record<string, string[]>);
+}
+/** An action answered with a location instead of a result. */
+export declare class ServerRedirectError extends Error {
+    readonly location: string;
+    constructor(location: string);
+}
+export declare class ServerAuthenticationError extends Error {
+    constructor(message?: string);
+}
+export declare class ServerAuthorizationError extends Error {
+    constructor(message?: string);
+}
+export declare class ServerDumpError extends Error {
+    constructor();
+}
+export declare class ServerSessionExpiredError extends Error {
+    constructor(message?: string);
+}
+/**
+ * Turn a failed server-action response into the error it describes.
+ *
+ * A server action that does not succeed answers with JSON or a redirect
+ * header rather than a Flight stream. Passing one of those to the Flight
+ * decoder does not produce the server's message — it produces an internal
+ * parser failure ("enqueueModel is not a function") or a truncated read
+ * ("Connection closed."), which is what reached onError before this existed.
+ *
+ * Returns without throwing when the response is a stream to be decoded.
+ */
+export declare function throwForFailedAction(response: Response): Promise<void>;
+/**
+ * Reject a payload response that is not one.
+ *
+ * The page a PPR route serves is a static shell: real HTML, status 200, with
+ * its Suspense fallbacks showing. Everything below them arrives in a second
+ * request. If that request fails there is nothing on screen to say so — the
+ * skeletons simply stay, for ever — and handing the failure body to the Flight
+ * decoder reports the decoder's confusion rather than the status.
+ */
+export declare function throwForFailedPayload(response: Response): void;
+/**
+ * Announce a failure that nothing else will.
+ *
+ * Dispatched as well as logged: an app that wants to replace a stuck skeleton
+ * with something honest has no other way to find out.
+ */
+export declare function reportClientFailure(scope: string, error: unknown): void;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/js/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,SAAgB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAEjD,YAAY,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAI5D;CACF;AAED,8DAA8D;AAC9D,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,SAAgB,QAAQ,EAAE,MAAM,CAAC;IAEjC,YAAY,QAAQ,EAAE,MAAM,EAI3B;CACF;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,YAAY,OAAO,GAAE,MAA2B,EAG/C;CACF;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,YAAY,OAAO,GAAE,MAAuC,EAG3D;CACF;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,cAGC;CACF;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,YAAY,OAAO,GAAE,MAA6D,EAGjF;CACF;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAI9D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAMvE"}

package/dist/js/errors.js

@@ -0,0 +1,93 @@
+export class ServerValidationError extends Error {
+    errors;
+    constructor(message, errors) {
+        super(message);
+        this.name = "ServerValidationError";
+        this.errors = errors;
+    }
+}
+/** An action answered with a location instead of a result. */
+export class ServerRedirectError extends Error {
+    location;
+    constructor(location) {
+        super(`Server action redirected to ${location}`);
+        this.name = "ServerRedirectError";
+        this.location = location;
+    }
+}
+export class ServerAuthenticationError extends Error {
+    constructor(message = "Unauthenticated.") {
+        super(message);
+        this.name = "ServerAuthenticationError";
+    }
+}
+export class ServerAuthorizationError extends Error {
+    constructor(message = "This action is unauthorized.") {
+        super(message);
+        this.name = "ServerAuthorizationError";
+    }
+}
+export class ServerDumpError extends Error {
+    constructor() {
+        super("Server returned a dump response.");
+        this.name = "ServerDumpError";
+    }
+}
+export class ServerSessionExpiredError extends Error {
+    constructor(message = "Your session has expired. Please refresh the page.") {
+        super(message);
+        this.name = "ServerSessionExpiredError";
+    }
+}
+/**
+ * Turn a failed server-action response into the error it describes.
+ *
+ * A server action that does not succeed answers with JSON or a redirect
+ * header rather than a Flight stream. Passing one of those to the Flight
+ * decoder does not produce the server's message — it produces an internal
+ * parser failure ("enqueueModel is not a function") or a truncated read
+ * ("Connection closed."), which is what reached onError before this existed.
+ *
+ * Returns without throwing when the response is a stream to be decoded.
+ */
+export async function throwForFailedAction(response) {
+    if (response.ok)
+        return;
+    // Auth and explicit redirects travel as a header, whatever the status.
+    const location = response.headers.get("X-RSC-Redirect");
+    if (location !== null && location !== "") {
+        throw new ServerRedirectError(location);
+    }
+    if (response.status === 422) {
+        const payload = (await response.json().catch(() => null));
+        throw new ServerValidationError(payload?.message ?? "Validation failed", payload?.errors ?? {});
+    }
+    throw new Error(`Server action failed with ${response.status}`);
+}
+/**
+ * Reject a payload response that is not one.
+ *
+ * The page a PPR route serves is a static shell: real HTML, status 200, with
+ * its Suspense fallbacks showing. Everything below them arrives in a second
+ * request. If that request fails there is nothing on screen to say so — the
+ * skeletons simply stay, for ever — and handing the failure body to the Flight
+ * decoder reports the decoder's confusion rather than the status.
+ */
+export function throwForFailedPayload(response) {
+    if (response.ok)
+        return;
+    throw new Error(`RSC payload request failed with ${response.status}`);
+}
+/**
+ * Announce a failure that nothing else will.
+ *
+ * Dispatched as well as logged: an app that wants to replace a stuck skeleton
+ * with something honest has no other way to find out.
+ */
+export function reportClientFailure(scope, error) {
+    if (typeof window !== "undefined") {
+        window.dispatchEvent(new CustomEvent("rsc-client-error", { detail: { scope, error } }));
+    }
+    console.error(`[rsc-kit] ${scope}`, error);
+}
+//# sourceMappingURL=errors.js.map

package/dist/js/errors.js.map

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