@rangojs/router 0.0.0-experimental.0b82333f

package/dist/client.js

@@ -0,0 +1,367 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Component, createElement, useContext, useMemo, Suspense, } from "react";
+import { OutletContext } from "./outlet-context.js";
+import { RouteContentWrapper, LoaderBoundary, } from "./route-content-wrapper.js";
+/**
+ * Outlet component - renders child content in layouts
+ *
+ * If the current segment defines a loading component, the outlet content
+ * is wrapped in Suspense with the loading component as fallback.
+ * This means during navigation/streaming, React's Suspense will automatically
+ * show the loading skeleton until the content is ready.
+ *
+ * When a name prop is provided (e.g., "@modal"), renders content from
+ * the parallel segment with that slot name instead of the default content.
+ * This is used for parallel routes and intercepting routes.
+ *
+ * @param name - Optional slot name for parallel/intercept content (must start with @)
+ *
+ * @example
+ * ```tsx
+ * function BlogLayout() {
+ *   return (
+ *     <div>
+ *       <h1>Blog</h1>
+ *       <Outlet />
+ *     </div>
+ *   );
+ * }
+ *
+ * // With named slot for modal/parallel content:
+ * function KanbanLayout() {
+ *   return (
+ *     <div>
+ *       <KanbanBoard />
+ *       <Outlet name="@modal" />
+ *       <Outlet />
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export function Outlet({ name } = {}) {
+    const context = useContext(OutletContext);
+    // If name provided, render parallel/intercept content for that slot
+    if (name) {
+        const segment = context?.parallel?.find((seg) => seg.slot === name) ?? null;
+        if (!segment)
+            return null;
+        // Determine the content to render
+        let content;
+        if (segment.loading || segment.component instanceof Promise) {
+            // Use RouteContentWrapper to handle Suspense wrapping properly
+            content = (_jsx(RouteContentWrapper, { content: segment.component instanceof Promise
+                    ? segment.component
+                    : Promise.resolve(segment.component), fallback: segment.loading, segmentId: segment.id }));
+        }
+        else {
+            content = segment.component ?? null;
+        }
+        // If segment has a layout, wrap appropriately
+        if (segment.layout) {
+            // Check if this segment has loaders that need streaming
+            // The layout renders immediately, LoaderBoundary becomes the outlet content
+            // When layout renders <Outlet />, it gets the LoaderBoundary which suspends
+            if (segment.loaderDataPromise && segment.loaderIds) {
+                const loaderAwareContent = (_jsx(LoaderBoundary, { loaderDataPromise: segment.loaderDataPromise, loaderIds: segment.loaderIds, fallback: segment.loading, outletKey: segment.id + "-loader", outletContent: null, segment: segment, children: content }));
+                return (_jsx(OutletProvider, { content: loaderAwareContent, segment: segment, children: segment.layout }));
+            }
+            // No loaders - wrap in OutletProvider so layout can use <Outlet />
+            return (_jsx(OutletProvider, { content: content, segment: segment, children: segment.layout }));
+        }
+        // No layout but has loaders - wrap content with LoaderBoundary for useLoader context
+        // This is common for intercept routes that use useLoader without a custom layout
+        if (segment.loaderDataPromise && segment.loaderIds) {
+            return (_jsx(LoaderBoundary, { loaderDataPromise: segment.loaderDataPromise, loaderIds: segment.loaderIds, fallback: segment.loading, outletKey: segment.id + "-loader", outletContent: null, segment: segment, children: content }));
+        }
+        return content;
+    }
+    // Default: render child content
+    const content = context?.content ?? null;
+    // If this segment defines a loading component, wrap outlet content with Suspense
+    // The loading component becomes the Suspense fallback, shown during streaming/navigation
+    if (context?.loading) {
+        return _jsx(Suspense, { fallback: context.loading, children: content });
+    }
+    return content;
+}
+/**
+ * ParallelOutlet component - renders content for a named parallel slot
+ *
+ * If the parallel segment defines a loading component, the content
+ * is wrapped in Suspense with the loading component as fallback.
+ * This enables streaming and navigation loading states for parallels.
+ *
+ * @param name - The slot name (must start with @, e.g., "@modal", "@sidebar")
+ *
+ * @example
+ * ```tsx
+ * function DashboardLayout() {
+ *   return (
+ *     <div>
+ *       <h1>Dashboard</h1>
+ *       <ParallelOutlet name="@sidebar" />
+ *       <ParallelOutlet name="@modal" />
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export function ParallelOutlet({ name }) {
+    const context = useContext(OutletContext);
+    const segment = useMemo(() => {
+        if (!context?.parallel)
+            return null;
+        return context.parallel.find((seg) => seg.slot === name) ?? null;
+    }, [context, name]);
+    if (!segment)
+        return null;
+    // Determine the content to render
+    let content;
+    if (segment.loading || segment.component instanceof Promise) {
+        // Use RouteContentWrapper to handle Suspense wrapping properly
+        content = (_jsx(RouteContentWrapper, { content: segment.component instanceof Promise
+                ? segment.component
+                : Promise.resolve(segment.component), fallback: segment.loading, segmentId: segment.id }));
+    }
+    else {
+        content = segment.component ?? null;
+    }
+    // If segment has a layout, wrap appropriately
+    if (segment.layout) {
+        // Check if this segment has loaders that need streaming
+        // The layout renders immediately, LoaderBoundary becomes the outlet content
+        if (segment.loaderDataPromise && segment.loaderIds) {
+            const loaderAwareContent = (_jsx(LoaderBoundary, { loaderDataPromise: segment.loaderDataPromise, loaderIds: segment.loaderIds, fallback: segment.loading, outletKey: segment.id + "-loader", outletContent: null, segment: segment, children: content }));
+            return (_jsx(OutletProvider, { content: loaderAwareContent, segment: segment, children: segment.layout }));
+        }
+        // No loaders - wrap in OutletProvider so layout can use <Outlet />
+        return (_jsx(OutletProvider, { content: content, segment: segment, children: segment.layout }));
+    }
+    // No layout but has loaders - wrap content with LoaderBoundary for useLoader context
+    // This is common for intercept routes that use useLoader without a custom layout
+    if (segment.loaderDataPromise && segment.loaderIds) {
+        return (_jsx(LoaderBoundary, { loaderDataPromise: segment.loaderDataPromise, loaderIds: segment.loaderIds, fallback: segment.loading, outletKey: segment.id + "-loader", outletContent: null, segment: segment, children: content }));
+    }
+    return content;
+}
+/**
+ * Provider for outlet content - used internally by renderSegments
+ *
+ * Stores a reference to parent context so useLoader can walk up the chain
+ * to find loader data from parent layouts. If this segment defines a loading
+ * component, Outlet will wrap content with Suspense using that as fallback.
+ */
+export function OutletProvider({ content, parallel, segment, loaderData, children, }) {
+    // Get parent context to enable walking up the chain for loader lookups
+    const parentContext = useContext(OutletContext);
+    const value = useMemo(() => ({
+        content,
+        parallel,
+        segment,
+        loaderData,
+        parent: parentContext,
+        loading: segment?.loading,
+    }), [content, parallel, segment, loaderData, parentContext]);
+    return (_jsx(OutletContext.Provider, { value: value, children: children }));
+}
+/**
+ * Hook to access outlet content programmatically
+ *
+ * Alternative to using <Outlet /> component. Useful when you need
+ * direct access to the outlet content in your logic.
+ *
+ * @example
+ * ```tsx
+ * function BlogLayout() {
+ *   const outlet = useOutlet();
+ *   return <div><h1>Blog</h1>{outlet}</div>;
+ * }
+ * ```
+ */
+export function useOutlet() {
+    const context = useContext(OutletContext);
+    return context?.content ?? null;
+}
+// Loader hooks - re-exported from dedicated file
+export { useLoader, useFetchLoader, } from "./use-loader.js";
+/**
+ * Hook to access all loader data in the current context
+ *
+ * Returns a record of all loader data available in the current outlet context
+ * and all parent contexts. Useful for debugging or when you need access to
+ * multiple loaders.
+ *
+ * @returns Record of loader name to data, or empty object if no loaders
+ *
+ * @example
+ * ```tsx
+ * "use client";
+ * import { useLoaderData } from "rsc-router/client";
+ *
+ * export function DebugPanel() {
+ *   const loaderData = useLoaderData();
+ *   return <pre>{JSON.stringify(loaderData, null, 2)}</pre>;
+ * }
+ * ```
+ */
+export function useLoaderData() {
+    const context = useContext(OutletContext);
+    // Collect all loader data from the context chain
+    // Child loaders override parent loaders with the same name
+    const result = {};
+    const stack = [];
+    // Build stack from current to root
+    let current = context;
+    while (current) {
+        stack.push(current);
+        current = current.parent;
+    }
+    // Apply from root to current (so children override parents)
+    for (let i = stack.length - 1; i >= 0; i--) {
+        const ctx = stack[i];
+        if (ctx.loaderData) {
+            Object.assign(result, ctx.loaderData);
+        }
+    }
+    return result;
+}
+// Implementation - function is ignored at runtime on client
+// The $$id is injected by Vite plugin as hidden third parameter
+export function createLoader(_fn, _fetchable, __injectedId) {
+    return {
+        __brand: "loader",
+        $$id: __injectedId || "",
+    };
+}
+/**
+ * Client-side ErrorBoundary component
+ *
+ * Catches JavaScript errors in child components during rendering,
+ * in lifecycle methods, and in constructors of the whole tree below them.
+ * Displays a fallback UI instead of the component tree that crashed.
+ *
+ * Use this to wrap client components that might throw during hydration
+ * or user interaction. For server-side errors (middleware, loaders, handlers),
+ * use the errorBoundary() helper in route definitions instead.
+ *
+ * @example
+ * ```tsx
+ * "use client";
+ * import { ErrorBoundary } from "rsc-router/client";
+ *
+ * function MyComponent() {
+ *   return (
+ *     <ErrorBoundary fallback={<div>Something went wrong</div>}>
+ *       <ComponentThatMightThrow />
+ *     </ErrorBoundary>
+ *   );
+ * }
+ *
+ * // Or with a function fallback for more control:
+ * function MyComponent() {
+ *   return (
+ *     <ErrorBoundary
+ *       fallback={({ error, reset }) => (
+ *         <div>
+ *           <p>Error: {error.message}</p>
+ *           <button onClick={reset}>Try again</button>
+ *         </div>
+ *       )}
+ *     >
+ *       <ComponentThatMightThrow />
+ *     </ErrorBoundary>
+ *   );
+ * }
+ * ```
+ */
+export class ErrorBoundary extends Component {
+    constructor(props) {
+        super(props);
+        this.reset = () => {
+            this.setState({ hasError: false, error: null });
+        };
+        this.state = { hasError: false, error: null };
+    }
+    static getDerivedStateFromError(error) {
+        return { hasError: true, error };
+    }
+    componentDidCatch(error, errorInfo) {
+        console.error("[ErrorBoundary] Error caught:", error, errorInfo);
+        this.props.onError?.(error, errorInfo);
+    }
+    render() {
+        if (this.state.hasError && this.state.error) {
+            const { fallback } = this.props;
+            // Create error info for the fallback
+            const errorInfo = {
+                message: this.state.error.message,
+                name: this.state.error.name,
+                stack: this.state.error.stack,
+                cause: this.state.error.cause,
+                segmentId: "client",
+                segmentType: "route",
+            };
+            // Render fallback - use createElement so hooks work in function fallbacks
+            if (typeof fallback === "function") {
+                return createElement(fallback, { error: errorInfo, reset: this.reset });
+            }
+            return fallback;
+        }
+        return this.props.children;
+    }
+}
+// ============================================================================
+// Re-exports from browser/react for convenience
+// These are the most commonly used client-side navigation utilities
+// ============================================================================
+// Navigation hooks
+export { useNavigation, } from "./browser/react/use-navigation.js";
+// Action state tracking hook
+export { useAction, } from "./browser/react/use-action.js";
+// Segments state hook
+export { useSegments, } from "./browser/react/use-segments.js";
+// Client cache controls hook
+export { useClientCache, } from "./browser/react/use-client-cache.js";
+// Provider
+export { NavigationProvider, } from "./browser/react/NavigationProvider.js";
+// Link component
+export { Link, } from "./browser/react/Link.js";
+// Link status hook
+export { useLinkStatus, } from "./browser/react/use-link-status.js";
+// Scroll restoration
+export { ScrollRestoration, useScrollRestoration, } from "./browser/react/ScrollRestoration.js";
+// Handle API - for accumulating data across route segments
+export { createHandle, isHandle } from "./handle.js";
+// Handle data hook
+export { useHandle } from "./browser/react/use-handle.js";
+// Built-in handles
+export { Meta } from "./handles/meta.js";
+export { MetaTags } from "./handles/MetaTags.js";
+// Location state - type-safe navigation state
+export { createLocationState, useLocationState, } from "./browser/react/location-state.js";
+// Type-safe href for client-side path validation
+export { href } from "./href-client.js";
+/**
+ * Type guard for checking if a response envelope contains an error.
+ *
+ * @example
+ * ```typescript
+ * const result: ResponseEnvelope<Product> = await fetch(url).then(r => r.json());
+ * if (isResponseError(result)) {
+ *   console.log(result.error.message, result.error.code);
+ *   return;
+ * }
+ * result.data // fully typed as Product
+ * ```
+ */
+export function isResponseError(result) {
+    return result.error !== undefined;
+}
+// Mount context for include() scoped components
+export { useMount } from "./browser/react/use-mount.js";
+export { MountContext } from "./browser/react/mount-context.js";
+// Mount-aware href hook - auto-prefixes paths with include() mount
+export { useHref } from "./browser/react/use-href.js";
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/client.rsc.d.ts

@@ -0,0 +1,26 @@
+/**
+ * RSC-environment version of client exports
+ *
+ * This file is used when importing "rsc-router/client" from RSC (server components).
+ * It re-exports the server's createLoader so that loader definitions work in both
+ * environments with the same import.
+ *
+ * The bundler uses the "react-server" export condition to select this file
+ * in RSC context, while the regular client.tsx is used in client components.
+ */
+export { Outlet, ParallelOutlet, OutletProvider, useOutlet, useLoader, useLoaderData, ErrorBoundary, type ErrorBoundaryProps, } from "./client.js";
+export { createLoader } from "./route-definition.js";
+export { Link, type LinkProps, type PrefetchStrategy, } from "./browser/react/Link.js";
+export { ScrollRestoration, type ScrollRestorationProps, } from "./browser/react/ScrollRestoration.js";
+export { NavigationProvider, type NavigationProviderProps, } from "./browser/react/NavigationProvider.js";
+export { href } from "./href-client.js";
+export { MountContext } from "./browser/react/mount-context.js";
+export { createHandle, isHandle, type Handle } from "./handle.js";
+export { Meta } from "./handles/meta.js";
+export { MetaTags } from "./handles/MetaTags.js";
+export type { MetaDescriptor, MetaDescriptorBase } from "./router/types.js";
+export { createLocationState, type LocationStateDefinition, type LocationStateEntry, } from "./browser/react/location-state-shared.js";
+export { useHref } from "./browser/react/use-href.js";
+export { useHandle } from "./browser/react/use-handle.js";
+export { useLocationState } from "./browser/react/location-state.js";
+//# sourceMappingURL=client.rsc.d.ts.map

package/dist/client.rsc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.rsc.d.ts","sourceRoot":"","sources":["../src/client.rsc.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EACL,MAAM,EACN,cAAc,EACd,cAAc,EACd,SAAS,EACT,SAAS,EACT,aAAa,EACb,aAAa,EACb,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC;AAIrB,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGrD,OAAO,EACL,IAAI,EACJ,KAAK,SAAS,EACd,KAAK,gBAAgB,GACtB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,iBAAiB,EACjB,KAAK,sBAAsB,GAC5B,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EACL,kBAAkB,EAClB,KAAK,uBAAuB,GAC7B,MAAM,uCAAuC,CAAC;AAG/C,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAGxC,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAOhE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAIlE,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAI5E,OAAO,EACL,mBAAmB,EACnB,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,GACxB,MAAM,0CAA0C,CAAC;AAGlD,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAGtD,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAG1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/client.rsc.js

@@ -0,0 +1,46 @@
+/**
+ * RSC-environment version of client exports
+ *
+ * This file is used when importing "rsc-router/client" from RSC (server components).
+ * It re-exports the server's createLoader so that loader definitions work in both
+ * environments with the same import.
+ *
+ * The bundler uses the "react-server" export condition to select this file
+ * in RSC context, while the regular client.tsx is used in client components.
+ */
+// Re-export everything from client.tsx (Outlet, useLoader, etc.)
+// These are safe to use in RSC context
+export { Outlet, ParallelOutlet, OutletProvider, useOutlet, useLoader, useLoaderData, ErrorBoundary, } from "./client.js";
+// Re-export the server's createLoader for RSC context
+// This version includes the actual loader function
+export { createLoader } from "./route-definition.js";
+// Re-export Link component (can be used in server components)
+export { Link, } from "./browser/react/Link.js";
+// Re-export ScrollRestoration (can be used in server components)
+export { ScrollRestoration, } from "./browser/react/ScrollRestoration.js";
+// Re-export NavigationProvider (needed for setup)
+export { NavigationProvider, } from "./browser/react/NavigationProvider.js";
+// Re-export href function (can be used in server components)
+export { href } from "./href-client.js";
+// Mount context re-exports (useMount is client-only, but MountContext can be referenced)
+export { MountContext } from "./browser/react/mount-context.js";
+// Note: useNavigation, useAction, useClientCache are NOT re-exported here
+// because they use client-side state and should only be used in client components
+// Handle API - for accumulating data across route segments
+// Works in both RSC and client contexts
+export { createHandle, isHandle } from "./handle.js";
+// Built-in handles
+// Meta handle works in RSC context
+export { Meta } from "./handles/meta.js";
+// MetaTags is a "use client" component that can be imported from RSC
+export { MetaTags } from "./handles/MetaTags.js";
+// Location state - createLocationState works in RSC (just creates definition)
+// useLocationState is NOT exported here as it uses client hooks
+export { createLocationState, } from "./browser/react/location-state-shared.js";
+// Re-export useHref - it's a "use client" hook
+export { useHref } from "./browser/react/use-href.js";
+// Re-export useHandle - it's a "use client" hook
+export { useHandle } from "./browser/react/use-handle.js";
+// Re-export useLocationState - it's a "use client" hook
+export { useLocationState } from "./browser/react/location-state.js";
+//# sourceMappingURL=client.rsc.js.map

package/dist/client.rsc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.rsc.js","sourceRoot":"","sources":["../src/client.rsc.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,iEAAiE;AACjE,uCAAuC;AACvC,OAAO,EACL,MAAM,EACN,cAAc,EACd,cAAc,EACd,SAAS,EACT,SAAS,EACT,aAAa,EACb,aAAa,GAEd,MAAM,aAAa,CAAC;AAErB,sDAAsD;AACtD,mDAAmD;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,8DAA8D;AAC9D,OAAO,EACL,IAAI,GAGL,MAAM,yBAAyB,CAAC;AAEjC,iEAAiE;AACjE,OAAO,EACL,iBAAiB,GAElB,MAAM,sCAAsC,CAAC;AAE9C,kDAAkD;AAClD,OAAO,EACL,kBAAkB,GAEnB,MAAM,uCAAuC,CAAC;AAE/C,6DAA6D;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,yFAAyF;AACzF,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAEhE,0EAA0E;AAC1E,kFAAkF;AAElF,2DAA2D;AAC3D,wCAAwC;AACxC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAe,MAAM,aAAa,CAAC;AAElE,mBAAmB;AACnB,mCAAmC;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,qEAAqE;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjD,8EAA8E;AAC9E,gEAAgE;AAChE,OAAO,EACL,mBAAmB,GAGpB,MAAM,0CAA0C,CAAC;AAElD,+CAA+C;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAEtD,iDAAiD;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE1D,wDAAwD;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/component-utils.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Component utilities for RSC
+ *
+ * Helpers for working with React Server Components and client components.
+ */
+import type { ComponentType } from "react";
+/**
+ * Check if a component is a client component (has "use client" directive).
+ *
+ * Client components are marked by the bundler with:
+ * - $$typeof: Symbol.for("react.client.reference")
+ * - $$id: string (module identifier)
+ *
+ * @param component - The component to check
+ * @returns true if the component has client reference marker
+ *
+ * @example
+ * ```typescript
+ * import { MyComponent } from "./my-component"; // has "use client"
+ *
+ * if (!isClientComponent(MyComponent)) {
+ *   throw new Error("MyComponent must be a client component");
+ * }
+ * ```
+ */
+export declare function isClientComponent(component: ComponentType<unknown> | unknown): boolean;
+/**
+ * Assert that a component is a client component.
+ * Throws a descriptive error if not.
+ *
+ * @param component - The component to check
+ * @param name - Name to use in error message (e.g., "document")
+ * @throws Error if the component is not a client component
+ */
+export declare function assertClientComponent(component: ComponentType<unknown> | unknown, name: string): asserts component is ComponentType<unknown>;
+//# sourceMappingURL=component-utils.d.ts.map

package/dist/component-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-utils.d.ts","sourceRoot":"","sources":["../src/component-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAS3C;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,GAC1C,OAAO,CAMT;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,EAC3C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,SAAS,IAAI,aAAa,CAAC,OAAO,CAAC,CAgB7C"}

package/dist/component-utils.js

@@ -0,0 +1,61 @@
+/**
+ * Component utilities for RSC
+ *
+ * Helpers for working with React Server Components and client components.
+ */
+/**
+ * Symbol used by React to mark client component references.
+ * When a file has "use client" directive, the bundler transforms the exports
+ * to include this symbol on $$typeof.
+ */
+const CLIENT_REFERENCE = Symbol.for("react.client.reference");
+/**
+ * Check if a component is a client component (has "use client" directive).
+ *
+ * Client components are marked by the bundler with:
+ * - $$typeof: Symbol.for("react.client.reference")
+ * - $$id: string (module identifier)
+ *
+ * @param component - The component to check
+ * @returns true if the component has client reference marker
+ *
+ * @example
+ * ```typescript
+ * import { MyComponent } from "./my-component"; // has "use client"
+ *
+ * if (!isClientComponent(MyComponent)) {
+ *   throw new Error("MyComponent must be a client component");
+ * }
+ * ```
+ */
+export function isClientComponent(component) {
+    if (typeof component !== "function") {
+        return false;
+    }
+    const withMeta = component;
+    return withMeta.$$typeof === CLIENT_REFERENCE;
+}
+/**
+ * Assert that a component is a client component.
+ * Throws a descriptive error if not.
+ *
+ * @param component - The component to check
+ * @param name - Name to use in error message (e.g., "document")
+ * @throws Error if the component is not a client component
+ */
+export function assertClientComponent(component, name) {
+    if (typeof component !== "function") {
+        throw new Error(`${name} must be a client component function with "use client" directive. ` +
+            `Make sure to pass the component itself, not a JSX element: ` +
+            `${name}: My${capitalize(name)} (correct) vs ${name}: <My${capitalize(name)} /> (incorrect)`);
+    }
+    if (!isClientComponent(component)) {
+        throw new Error(`${name} must be a client component with "use client" directive at the top of the file. ` +
+            `Server components cannot be used as the ${name} because their function reference ` +
+            `cannot be serialized in the RSC payload. Add "use client" to your ${name} file.`);
+    }
+}
+function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+//# sourceMappingURL=component-utils.js.map

package/dist/component-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-utils.js","sourceRoot":"","sources":["../src/component-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;GAIG;AACH,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;AAE9D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,iBAAiB,CAC/B,SAA2C;IAE3C,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE,CAAC;QACpC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,QAAQ,GAAG,SAAkC,CAAC;IACpD,OAAO,QAAQ,CAAC,QAAQ,KAAK,gBAAgB,CAAC;AAChD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,SAA2C,EAC3C,IAAY;IAEZ,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,oEAAoE;YACzE,6DAA6D;YAC7D,GAAG,IAAI,OAAO,UAAU,CAAC,IAAI,CAAC,iBAAiB,IAAI,QAAQ,UAAU,CAAC,IAAI,CAAC,iBAAiB,CAC/F,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,kFAAkF;YACvF,2CAA2C,IAAI,oCAAoC;YACnF,qEAAqE,IAAI,QAAQ,CACpF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,GAAW;IAC7B,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC"}

package/dist/components/DefaultDocument.d.ts

@@ -0,0 +1,13 @@
+import type { ReactNode, ReactElement } from "react";
+/**
+ * Default document component that provides a basic HTML structure.
+ * Used when no custom document is provided to createRouter.
+ * Includes MetaTags for automatic charset, viewport, and route meta support.
+ *
+ * Uses suppressHydrationWarning on <html> because the theme script
+ * may modify class/style attributes before React hydrates.
+ */
+export declare function DefaultDocument({ children }: {
+    children: ReactNode;
+}): ReactElement;
+//# sourceMappingURL=DefaultDocument.d.ts.map

package/dist/components/DefaultDocument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultDocument.d.ts","sourceRoot":"","sources":["../../src/components/DefaultDocument.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAGrD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,GAAG,YAAY,CASnF"}

package/dist/components/DefaultDocument.js

@@ -0,0 +1,15 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { MetaTags } from "../handles/MetaTags.js";
+/**
+ * Default document component that provides a basic HTML structure.
+ * Used when no custom document is provided to createRouter.
+ * Includes MetaTags for automatic charset, viewport, and route meta support.
+ *
+ * Uses suppressHydrationWarning on <html> because the theme script
+ * may modify class/style attributes before React hydrates.
+ */
+export function DefaultDocument({ children }) {
+    return (_jsxs("html", { lang: "en", suppressHydrationWarning: true, children: [_jsx("head", { children: _jsx(MetaTags, {}) }), _jsx("body", { children: children })] }));
+}
+//# sourceMappingURL=DefaultDocument.js.map

package/dist/components/DefaultDocument.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultDocument.js","sourceRoot":"","sources":["../../src/components/DefaultDocument.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAGb,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,EAAE,QAAQ,EAA2B;IACnE,OAAO,CACL,gBAAM,IAAI,EAAC,IAAI,EAAC,wBAAwB,mBACtC,yBACE,KAAC,QAAQ,KAAG,GACP,EACP,yBAAO,QAAQ,GAAQ,IAClB,CACR,CAAC;AACJ,CAAC"}