@rangojs/router 0.0.0-experimental.48 → 0.0.0-experimental.49

package/dist/ssr/index.js

@@ -0,0 +1,158 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from "react";
+import { initHandleDataSync } from "../browser/react/use-handle.js";
+import { initSegmentsSync } from "../browser/react/use-segments.js";
+import { initThemeConfigSync } from "../theme/theme-context.js";
+import { ThemeProvider } from "../theme/ThemeProvider.js";
+import { NavigationStoreContext } from "../browser/react/context.js";
+/**
+ * Consume an async generator and return a Promise that resolves with the final value.
+ * Used for SSR where we need to await all handle data before rendering.
+ */
+async function consumeAsyncGenerator(generator) {
+    let lastData = {};
+    for await (const data of generator) {
+        lastData = data;
+    }
+    return lastData;
+}
+/**
+ * Create a minimal event controller for SSR.
+ * This provides the correct pathname so useNavigation returns the right value during SSR.
+ */
+function createSsrEventController(pathname) {
+    const location = new URL(pathname, "http://localhost");
+    const state = {
+        state: "idle",
+        isStreaming: false,
+        location,
+        pendingUrl: null,
+        inflightActions: [],
+    };
+    return {
+        getState: () => state,
+        subscribe: () => () => { },
+        getActionState: () => ({
+            state: "idle",
+            actionId: null,
+            payload: null,
+            error: null,
+            result: null,
+        }),
+        subscribeToAction: () => () => { },
+        subscribeToHandles: () => () => { },
+        setHandleData: () => { },
+        getHandleState: () => ({ data: {}, segmentOrder: [] }),
+        setLocation: () => { },
+        startNavigation: () => {
+            throw new Error("Navigation not supported during SSR");
+        },
+        abortNavigation: () => { },
+        startAction: () => {
+            throw new Error("Actions not supported during SSR");
+        },
+        abortAllActions: () => { },
+        getCurrentNavigation: () => null,
+        getInflightActions: () => new Map(),
+    };
+}
+/**
+ * Create an SSR handler that converts RSC streams to HTML.
+ *
+ * @example
+ * ```tsx
+ * import { createSSRHandler } from "rsc-router/ssr";
+ * import { createFromReadableStream } from "@vitejs/plugin-rsc/ssr";
+ * import { renderToReadableStream } from "react-dom/server.edge";
+ * import { injectRSCPayload } from "rsc-html-stream/server";
+ *
+ * export const renderHTML = createSSRHandler({
+ *   createFromReadableStream,
+ *   renderToReadableStream,
+ *   injectRSCPayload,
+ *   loadBootstrapScriptContent: () =>
+ *     import.meta.viteRsc.loadBootstrapScriptContent("index"),
+ * });
+ * ```
+ */
+export function createSSRHandler(deps) {
+    const { createFromReadableStream, renderToReadableStream, injectRSCPayload, loadBootstrapScriptContent, onError, } = deps;
+    /**
+     * Render RSC stream to HTML stream
+     *
+     * @param rscStream - The RSC stream to render
+     * @param options - Optional render options including formState for useActionState and nonce for CSP
+     */
+    return async function renderHTML(rscStream, options) {
+        const { nonce, formState } = options ?? {};
+        try {
+            // Tee the stream:
+            // - rscStream1: For SSR rendering (deserialize to React VDOM)
+            // - rscStream2: For browser hydration (inject as __FLIGHT_DATA__)
+            const [rscStream1, rscStream2] = rscStream.tee();
+            // Deserialize RSC stream to React tree
+            let payload;
+            let handlesPromise;
+            let ssrContextValue;
+            function SsrRoot() {
+                payload ?? (payload = createFromReadableStream(rscStream1));
+                const resolved = React.use(payload);
+                // Initialize segments state before children render (for useSegments hook)
+                initSegmentsSync(resolved.metadata?.matched, resolved.metadata?.pathname);
+                // Initialize theme config for MetaTags to render theme script
+                const themeConfig = resolved.metadata?.themeConfig ?? null;
+                initThemeConfigSync(themeConfig);
+                // Await handles and initialize state before children render
+                // The handles property is an async generator that yields on each push
+                // Memoize the promise since async generators can only be iterated once
+                if (resolved.metadata?.handles) {
+                    handlesPromise ?? (handlesPromise = consumeAsyncGenerator(resolved.metadata.handles));
+                    const handleData = React.use(handlesPromise);
+                    initHandleDataSync(handleData, resolved.metadata.matched);
+                }
+                // Create SSR context with correct pathname for useNavigation
+                ssrContextValue ?? (ssrContextValue = {
+                    store: null,
+                    eventController: createSsrEventController(resolved.metadata?.pathname ?? "/"),
+                    navigate: async () => { },
+                    refresh: async () => { },
+                });
+                // Build content tree with all necessary providers
+                // Order must match NavigationProvider: NavigationStoreContext > ThemeProvider > content
+                let content = resolved.root;
+                // Wrap content with ThemeProvider if theme is enabled
+                if (themeConfig) {
+                    content = (_jsx(ThemeProvider, { config: themeConfig, initialTheme: resolved.metadata?.initialTheme, children: content }));
+                }
+                // Wrap with NavigationStoreContext for useNavigation hook
+                return (_jsx(NavigationStoreContext.Provider, { value: ssrContextValue, children: content }));
+            }
+            // Get bootstrap script content
+            const bootstrapScriptContent = await loadBootstrapScriptContent();
+            // Render React tree to HTML stream
+            // Pass formState for useActionState progressive enhancement if provided
+            // Pass nonce for CSP if provided
+            const htmlStream = await renderToReadableStream(_jsx(SsrRoot, {}), {
+                bootstrapScriptContent,
+                formState,
+                nonce,
+            });
+            // Inject RSC payload into HTML as <script nonce="...">__FLIGHT_DATA__</script>
+            return htmlStream.pipeThrough(injectRSCPayload(rscStream2, { nonce }));
+        }
+        catch (error) {
+            // Invoke onError callback if provided
+            if (onError) {
+                const errorObj = error instanceof Error ? error : new Error(String(error));
+                try {
+                    onError(errorObj, { phase: "rendering" });
+                }
+                catch (callbackError) {
+                    console.error("[SSRHandler.onError] Callback error:", callbackError);
+                }
+            }
+            throw error;
+        }
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/ssr/index.js.map

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

package/dist/static-handler.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Static handler definition for build-time rendering of individual segments.
+ *
+ * Static wraps a handler so that in production the segment is
+ * rendered once at build time. The handler is then replaced with a static
+ * asset import -- no runtime store lookup needed.
+ *
+ * In dev mode, Static behaves as a normal handler: the wrapped
+ * function runs on every request, identical to a regular layout/path handler.
+ *
+ * The $$id is auto-generated by the Vite exposeInternalIds plugin based on
+ * file path and export name. No manual naming required.
+ *
+ * Key difference from Prerender:
+ *   - Prerender: route-scoped, produces URLs via getParams, renders subtree per-params
+ *   - Static: segment-scoped, renders once, no URLs, no params
+ *
+ * Works on: layout(), parallel(), and path().
+ *
+ * @example
+ * ```ts
+ * export const DocsNav = Static((ctx) => <Nav docs={readDocsSync()} />);
+ * export const DocShell = Static((ctx) => <Shell />);
+ *
+ * urls(({ path, layout }) => [
+ *   layout(DocsNav, () => [
+ *     path("/getting-started", DocShell, { name: "doc.gs" }),
+ *     path("/:slug", Prerender(getParams, DocPageHandler)),
+ *   ]),
+ * ]);
+ * ```
+ */
+import type { ReactNode } from "react";
+import type { Handler, HandlerContext } from "./types.js";
+import type { PrerenderOptions } from "./prerender.js";
+export interface StaticHandlerDefinition<TParams extends Record<string, any> = any> {
+    readonly __brand: "staticHandler";
+    /** Auto-generated unique ID (injected by Vite plugin). */
+    $$id: string;
+    /** In dev mode, the actual handler function that layout/path/parallel can call. */
+    handler: Handler<TParams>;
+    /** Static handler options (passthrough support). */
+    options?: PrerenderOptions;
+}
+export declare function Static<TParams extends Record<string, any> = {}>(handler: (ctx: HandlerContext<TParams>) => ReactNode | Promise<ReactNode>, options?: PrerenderOptions, __injectedId?: string): StaticHandlerDefinition<TParams>;
+/**
+ * Type guard to check if a value is a StaticHandlerDefinition.
+ */
+export declare function isStaticHandler(value: unknown): value is StaticHandlerDefinition;
+//# sourceMappingURL=static-handler.d.ts.map

package/dist/static-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-handler.d.ts","sourceRoot":"","sources":["../src/static-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAIvD,MAAM,WAAW,uBAAuB,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG;IAChF,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1B,oDAAoD;IACpD,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B;AAID,wBAAgB,MAAM,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,EAAE,EAC7D,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,EACzE,OAAO,CAAC,EAAE,gBAAgB,EAC1B,YAAY,CAAC,EAAE,MAAM,GACpB,uBAAuB,CAAC,OAAO,CAAC,CAAC;AA6BpC;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,uBAAuB,CAOlC"}

package/dist/static-handler.gen.d.ts

@@ -0,0 +1,5 @@
+export declare const routes: {
+    readonly "doc.gs": "/getting-started";
+};
+export type routes = typeof routes;
+//# sourceMappingURL=static-handler.gen.d.ts.map

package/dist/static-handler.gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-handler.gen.d.ts","sourceRoot":"","sources":["../src/static-handler.gen.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,MAAM;;CAET,CAAC;AACX,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC"}

package/dist/static-handler.gen.js

@@ -0,0 +1,5 @@
+// Auto-generated by @rangojs/router - do not edit
+export const routes = {
+    "doc.gs": "/getting-started",
+};
+//# sourceMappingURL=static-handler.gen.js.map

package/dist/static-handler.gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-handler.gen.js","sourceRoot":"","sources":["../src/static-handler.gen.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,QAAQ,EAAE,kBAAkB;CACpB,CAAC"}

package/dist/static-handler.js

@@ -0,0 +1,29 @@
+// -- Implementation ---------------------------------------------------------
+export function Static(handler, optionsOrId, maybeId) {
+    let options;
+    let id;
+    if (typeof optionsOrId === "string") {
+        id = optionsOrId;
+    }
+    else {
+        options = optionsOrId;
+        id = maybeId ?? "";
+    }
+    return {
+        __brand: "staticHandler",
+        $$id: id,
+        handler: handler,
+        ...(options ? { options } : {}),
+    };
+}
+// -- Type guard -------------------------------------------------------------
+/**
+ * Type guard to check if a value is a StaticHandlerDefinition.
+ */
+export function isStaticHandler(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "__brand" in value &&
+        value.__brand === "staticHandler");
+}
+//# sourceMappingURL=static-handler.js.map

package/dist/static-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-handler.js","sourceRoot":"","sources":["../src/static-handler.ts"],"names":[],"mappings":"AAwDA,8EAA8E;AAE9E,MAAM,UAAU,MAAM,CACpB,OAAiB,EACjB,WAAuC,EACvC,OAAgB;IAEhB,IAAI,OAAqC,CAAC;IAC1C,IAAI,EAAU,CAAC;IAEf,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QACpC,EAAE,GAAG,WAAW,CAAC;IACnB,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,WAA2C,CAAC;QACtD,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IACrB,CAAC;IAED,OAAO;QACL,OAAO,EAAE,eAAwB;QACjC,IAAI,EAAE,EAAE;QACR,OAAO,EAAE,OAA2B;QACpC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChC,CAAC;AACJ,CAAC;AAED,8EAA8E;AAE9E;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAc;IAEd,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,SAAS,IAAI,KAAK;QACjB,KAA8B,CAAC,OAAO,KAAK,eAAe,CAC5D,CAAC;AACJ,CAAC"}

package/dist/theme/ThemeProvider.d.ts

@@ -0,0 +1,20 @@
+/**
+ * ThemeProvider - Client component that provides theme state and management.
+ *
+ * Features:
+ * - Syncs theme to cookie/localStorage
+ * - Detects system preference changes
+ * - Cross-tab synchronization via storage events
+ * - Updates HTML element attribute when theme changes
+ * - Handles SSR hydration by deferring system theme detection
+ */
+import React from "react";
+import type { ThemeProviderProps } from "./types.js";
+/**
+ * ThemeProvider component
+ *
+ * Provides theme state to the component tree via context.
+ * Handles theme persistence, system preference detection, and cross-tab sync.
+ */
+export declare function ThemeProvider({ config, initialTheme, children, }: ThemeProviderProps): React.ReactNode;
+//# sourceMappingURL=ThemeProvider.d.ts.map

package/dist/theme/ThemeProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeProvider.d.ts","sourceRoot":"","sources":["../../src/theme/ThemeProvider.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,OAAO,KAA4D,MAAM,OAAO,CAAC;AAEjF,OAAO,KAAK,EAKV,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAkIpB;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAC5B,MAAM,EACN,YAAY,EACZ,QAAQ,GACT,EAAE,kBAAkB,GAAG,KAAK,CAAC,SAAS,CAiItC"}

package/dist/theme/ThemeProvider.js

@@ -0,0 +1,240 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * ThemeProvider - Client component that provides theme state and management.
+ *
+ * Features:
+ * - Syncs theme to cookie/localStorage
+ * - Detects system preference changes
+ * - Cross-tab synchronization via storage events
+ * - Updates HTML element attribute when theme changes
+ * - Handles SSR hydration by deferring system theme detection
+ */
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { ThemeContext } from "./theme-context.js";
+import { THEME_COOKIE } from "./constants.js";
+/**
+ * Get system preference for color scheme
+ */
+function getSystemTheme() {
+    if (typeof window !== "undefined" && window.matchMedia) {
+        return window.matchMedia("(prefers-color-scheme: dark)").matches
+            ? "dark"
+            : "light";
+    }
+    return "light";
+}
+/**
+ * Read theme from cookie
+ */
+function readThemeFromCookie(storageKey) {
+    if (typeof document === "undefined")
+        return null;
+    const cookies = document.cookie.split(";");
+    for (const cookie of cookies) {
+        const [name, ...rest] = cookie.trim().split("=");
+        if (name === storageKey) {
+            return decodeURIComponent(rest.join("="));
+        }
+    }
+    return null;
+}
+/**
+ * Read theme from localStorage
+ */
+function readThemeFromStorage(storageKey) {
+    if (typeof localStorage === "undefined")
+        return null;
+    try {
+        return localStorage.getItem(storageKey);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write theme to cookie
+ */
+function writeThemeToCookie(storageKey, theme) {
+    if (typeof document === "undefined")
+        return;
+    const value = encodeURIComponent(theme);
+    const cookie = `${storageKey}=${value}; Path=${THEME_COOKIE.path}; Max-Age=${THEME_COOKIE.maxAge}; SameSite=${THEME_COOKIE.sameSite}`;
+    document.cookie = cookie;
+}
+/**
+ * Write theme to localStorage
+ */
+function writeThemeToStorage(storageKey, theme) {
+    if (typeof localStorage === "undefined")
+        return;
+    try {
+        localStorage.setItem(storageKey, theme);
+    }
+    catch {
+        // localStorage might be disabled or full
+    }
+}
+/**
+ * Apply theme to HTML element
+ */
+function applyThemeToDocument(theme, config) {
+    if (typeof document === "undefined")
+        return;
+    const resolved = theme === "system" && config.enableSystem
+        ? getSystemTheme()
+        : theme;
+    const value = config.value[resolved] || resolved;
+    const el = document.documentElement;
+    // Apply attribute
+    if (config.attribute === "class") {
+        // Remove all theme classes
+        for (const t of config.themes) {
+            const v = config.value[t] || t;
+            el.classList.remove(v);
+        }
+        // Add current theme class
+        el.classList.add(value);
+    }
+    else {
+        el.setAttribute(config.attribute, value);
+    }
+    // Set color-scheme for native dark mode support
+    if (config.enableColorScheme) {
+        el.style.colorScheme = resolved;
+    }
+}
+/**
+ * Get the resolved stored theme (validated against available themes)
+ */
+function getStoredTheme(config) {
+    const { storageKey, themes, defaultTheme, enableSystem } = config;
+    // Try cookie first (for SSR consistency)
+    let stored = readThemeFromCookie(storageKey);
+    // Fall back to localStorage
+    if (!stored) {
+        stored = readThemeFromStorage(storageKey);
+    }
+    // Validate stored value
+    if (stored) {
+        if (stored === "system" && enableSystem) {
+            return "system";
+        }
+        if (themes.includes(stored)) {
+            return stored;
+        }
+    }
+    return defaultTheme;
+}
+/**
+ * ThemeProvider component
+ *
+ * Provides theme state to the component tree via context.
+ * Handles theme persistence, system preference detection, and cross-tab sync.
+ */
+export function ThemeProvider({ config, initialTheme, children, }) {
+    // Track mount state to avoid hydration mismatches
+    // During SSR and initial hydration, mounted is false
+    const [mounted, setMounted] = useState(false);
+    // Initialize theme from prop, storage, or default
+    const [theme, setThemeState] = useState(() => {
+        if (initialTheme)
+            return initialTheme;
+        if (typeof window === "undefined")
+            return config.defaultTheme;
+        return getStoredTheme(config);
+    });
+    // Track system preference - use stable default during SSR
+    const [systemTheme, setSystemTheme] = useState("light");
+    // Set mounted after hydration and detect actual system theme
+    useEffect(() => {
+        setMounted(true);
+        setSystemTheme(getSystemTheme());
+    }, []);
+    // Set theme and persist to storage
+    const setTheme = useCallback((newTheme) => {
+        setThemeState(newTheme);
+        writeThemeToCookie(config.storageKey, newTheme);
+        writeThemeToStorage(config.storageKey, newTheme);
+        applyThemeToDocument(newTheme, config);
+    }, [config]);
+    // Listen for system preference changes
+    useEffect(() => {
+        if (!config.enableSystem)
+            return;
+        if (typeof window === "undefined" || !window.matchMedia)
+            return;
+        const mediaQuery = window.matchMedia("(prefers-color-scheme: dark)");
+        const handleChange = (e) => {
+            const newSystemTheme = e.matches ? "dark" : "light";
+            setSystemTheme(newSystemTheme);
+            // If current theme is "system", re-apply to update document
+            if (theme === "system") {
+                applyThemeToDocument("system", config);
+            }
+        };
+        // Modern browsers
+        mediaQuery.addEventListener("change", handleChange);
+        return () => {
+            mediaQuery.removeEventListener("change", handleChange);
+        };
+    }, [config, theme]);
+    // Cross-tab synchronization via localStorage storage event
+    useEffect(() => {
+        if (typeof window === "undefined")
+            return;
+        const handleStorageChange = (e) => {
+            if (e.key !== config.storageKey)
+                return;
+            const newTheme = e.newValue;
+            if (!newTheme)
+                return;
+            // Validate and apply
+            if (newTheme === "system" ||
+                config.themes.includes(newTheme)) {
+                setThemeState(newTheme);
+                applyThemeToDocument(newTheme, config);
+            }
+        };
+        window.addEventListener("storage", handleStorageChange);
+        return () => {
+            window.removeEventListener("storage", handleStorageChange);
+        };
+    }, [config]);
+    // Compute resolved theme
+    // During SSR (not mounted), use the initial theme or default to avoid hydration mismatch
+    const resolvedTheme = useMemo(() => {
+        if (!mounted) {
+            // During SSR, return the initial theme if it's not "system", otherwise "light"
+            // The inline script will apply the correct class before hydration
+            if (initialTheme && initialTheme !== "system") {
+                return initialTheme;
+            }
+            return "light";
+        }
+        if (theme === "system" && config.enableSystem) {
+            return systemTheme;
+        }
+        return theme;
+    }, [theme, systemTheme, config.enableSystem, mounted, initialTheme]);
+    // Build themes list (include "system" if enabled)
+    const themes = useMemo(() => {
+        if (config.enableSystem) {
+            return ["system", ...config.themes.filter((t) => t !== "system")];
+        }
+        return config.themes;
+    }, [config.themes, config.enableSystem]);
+    // Context value
+    // During SSR (not mounted), return stable values to avoid hydration mismatch
+    const contextValue = useMemo(() => ({
+        theme,
+        setTheme,
+        resolvedTheme,
+        // Return stable "light" for systemTheme during SSR - actual value updates after mount
+        systemTheme: mounted ? systemTheme : "light",
+        themes,
+        config,
+    }), [theme, setTheme, resolvedTheme, systemTheme, themes, config, mounted]);
+    return (_jsx(ThemeContext.Provider, { value: contextValue, children: children }));
+}
+//# sourceMappingURL=ThemeProvider.js.map

package/dist/theme/ThemeProvider.js.map

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

package/dist/theme/ThemeScript.d.ts

@@ -0,0 +1,48 @@
+/**
+ * ThemeScript - Server component that renders an inline script for FOUC prevention.
+ *
+ * This component renders a blocking inline script that:
+ * 1. Reads theme from cookie/localStorage before paint
+ * 2. Applies the theme to the HTML element immediately
+ * 3. Prevents flash of unstyled content (FOUC)
+ *
+ * Must be placed in the <head> element of your document, before any stylesheets.
+ *
+ * @example
+ * ```tsx
+ * // In your document component
+ * import { ThemeScript } from "@rangojs/router/theme";
+ *
+ * export function Document({ children }) {
+ *   return (
+ *     <html lang="en" suppressHydrationWarning>
+ *       <head>
+ *         <ThemeScript />
+ *         <MetaTags />
+ *       </head>
+ *       <body>{children}</body>
+ *     </html>
+ *   );
+ * }
+ * ```
+ */
+import React from "react";
+import type { ResolvedThemeConfig } from "./types.js";
+export interface ThemeScriptProps {
+    /**
+     * Theme configuration - passed from router.themeConfig
+     */
+    config: ResolvedThemeConfig;
+    /**
+     * Optional nonce for CSP
+     */
+    nonce?: string;
+}
+/**
+ * Server component that renders the theme initialization script.
+ *
+ * This renders a synchronous inline script that applies the theme
+ * to the HTML element before React hydration, preventing FOUC.
+ */
+export declare function ThemeScript({ config, nonce }: ThemeScriptProps): React.ReactNode;
+//# sourceMappingURL=ThemeScript.d.ts.map

package/dist/theme/ThemeScript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeScript.d.ts","sourceRoot":"","sources":["../../src/theme/ThemeScript.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,MAAM,EAAE,mBAAmB,CAAC;IAE5B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,gBAAgB,GAAG,KAAK,CAAC,SAAS,CAShF"}

package/dist/theme/ThemeScript.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { generateThemeScript } from "./theme-script.js";
+/**
+ * Server component that renders the theme initialization script.
+ *
+ * This renders a synchronous inline script that applies the theme
+ * to the HTML element before React hydration, preventing FOUC.
+ */
+export function ThemeScript({ config, nonce }) {
+    const scriptContent = generateThemeScript(config);
+    return (_jsx("script", { nonce: nonce, dangerouslySetInnerHTML: { __html: scriptContent } }));
+}
+//# sourceMappingURL=ThemeScript.js.map

package/dist/theme/ThemeScript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemeScript.js","sourceRoot":"","sources":["../../src/theme/ThemeScript.tsx"],"names":[],"mappings":";AA8BA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAexD;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,EAAE,MAAM,EAAE,KAAK,EAAoB;IAC7D,MAAM,aAAa,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAElD,OAAO,CACL,iBACE,KAAK,EAAE,KAAK,EACZ,uBAAuB,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,GAClD,CACH,CAAC;AACJ,CAAC"}

package/dist/theme/__tests__/theme.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=theme.test.d.ts.map

package/dist/theme/__tests__/theme.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.test.d.ts","sourceRoot":"","sources":["../../../src/theme/__tests__/theme.test.ts"],"names":[],"mappings":""}