@ereo/client 0.1.23 → 0.1.24

package/dist/lazy-route.d.ts

@@ -0,0 +1,137 @@
+/**
+ * @ereo/client - Lazy Route Loading
+ *
+ * Route-level code splitting using dynamic import().
+ * Routes are lazy-loaded on navigation, reducing initial bundle size.
+ * Supports preloading for hover/intent-based prefetching.
+ */
+import type { RouteModule } from '@ereo/core';
+/**
+ * A route module loader — returns a dynamic import promise.
+ */
+export type RouteModuleLoader = () => Promise<RouteModule>;
+/**
+ * A lazy route definition for client-side code splitting.
+ */
+export interface LazyRouteDefinition {
+    /** Route identifier */
+    id: string;
+    /** Route path pattern */
+    path: string;
+    /** Dynamic import function for the route module */
+    loader: RouteModuleLoader;
+    /** Whether this route module has been loaded */
+    loaded: boolean;
+    /** The cached module after loading */
+    module?: RouteModule;
+}
+/**
+ * Client-side route manifest entry (generated at build time).
+ * Maps route IDs to their chunk URLs for preloading.
+ */
+export interface RouteManifestEntry {
+    /** Route ID */
+    id: string;
+    /** JavaScript chunk URL */
+    js: string;
+    /** CSS files associated with this route */
+    css?: string[];
+    /** Other asset files to preload */
+    assets?: string[];
+    /** Module imports (for dependency preloading) */
+    imports?: string[];
+}
+/**
+ * Full route manifest mapping route IDs to chunks.
+ */
+export type RouteManifest = Record<string, RouteManifestEntry>;
+/**
+ * Register a lazy route with a dynamic import loader.
+ *
+ * @param id - Route identifier
+ * @param path - Route path pattern
+ * @param loader - Dynamic import function
+ *
+ * @example
+ * ```typescript
+ * registerLazyRoute('home', '/', () => import('./routes/home'));
+ * registerLazyRoute('users', '/users/[id]', () => import('./routes/users/[id]'));
+ * ```
+ */
+export declare function registerLazyRoute(id: string, path: string, loader: RouteModuleLoader): void;
+/**
+ * Register multiple lazy routes at once.
+ *
+ * @example
+ * ```typescript
+ * registerLazyRoutes({
+ *   home: { path: '/', loader: () => import('./routes/home') },
+ *   about: { path: '/about', loader: () => import('./routes/about') },
+ * });
+ * ```
+ */
+export declare function registerLazyRoutes(routes: Record<string, {
+    path: string;
+    loader: RouteModuleLoader;
+}>): void;
+/**
+ * Load a lazy route module. Returns the cached module if already loaded.
+ * Deduplicates concurrent loads of the same route.
+ *
+ * @param id - Route identifier
+ * @returns The loaded route module
+ * @throws Error if route is not registered
+ */
+export declare function loadLazyRoute(id: string): Promise<RouteModule>;
+/**
+ * Preload a route module without executing it.
+ * Useful for hover/intent-based prefetching.
+ *
+ * @param id - Route identifier
+ * @returns Promise that resolves when the module is loaded
+ */
+export declare function preloadLazyRoute(id: string): Promise<void>;
+/**
+ * Check if a lazy route's module has been loaded.
+ */
+export declare function isRouteLoaded(id: string): boolean;
+/**
+ * Get a loaded route module (returns undefined if not loaded).
+ */
+export declare function getLoadedModule(id: string): RouteModule | undefined;
+/**
+ * Get all registered lazy route IDs.
+ */
+export declare function getLazyRouteIds(): string[];
+/**
+ * Clear the module cache and reset all lazy routes.
+ * Useful for testing or hot module replacement.
+ */
+export declare function clearLazyRouteCache(): void;
+/**
+ * Remove all registered lazy routes and clear caches.
+ */
+export declare function resetLazyRoutes(): void;
+/**
+ * Set the route manifest (typically loaded from the build output).
+ *
+ * @example
+ * ```typescript
+ * // In your entry point
+ * import manifest from './__manifest.json';
+ * setRouteManifest(manifest);
+ * ```
+ */
+export declare function setRouteManifest(m: RouteManifest): void;
+/**
+ * Get the route manifest entry for a route ID.
+ */
+export declare function getRouteManifestEntry(id: string): RouteManifestEntry | undefined;
+/**
+ * Preload route assets (JS chunks, CSS files) by injecting
+ * <link rel="modulepreload"> and <link rel="preload"> into <head>.
+ *
+ * @param id - Route ID to preload assets for
+ */
+export declare function preloadRouteAssets(id: string): void;
+//# sourceMappingURL=lazy-route.d.ts.map

package/dist/lazy-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy-route.d.ts","sourceRoot":"","sources":["../src/lazy-route.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM9C;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,MAAM,EAAE,iBAAiB,CAAC;IAC1B,gDAAgD;IAChD,MAAM,EAAE,OAAO,CAAC;IAChB,sCAAsC;IACtC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,eAAe;IACf,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,2CAA2C;IAC3C,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAe/D;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,iBAAiB,GACxB,IAAI,CAON;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,CAAC,GAClE,IAAI,CAIN;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA+BpE;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEnE;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAO1C;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAItC;AASD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI,CAEvD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEhF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAyCnD"}

package/dist/link.d.ts

@@ -4,6 +4,7 @@
  * Link and NavLink components with prefetch support for client-side navigation.
  */
 import * as React from 'react';
+import type { ViewTransitionOptions } from './view-transition';
 /**
  * Prefetch strategy for links.
  */
@@ -26,6 +27,8 @@ export interface LinkProps extends Omit<React.AnchorHTMLAttributes<HTMLAnchorEle
     state?: unknown;
     /** Reload the document instead of client navigation */
     reloadDocument?: boolean;
+    /** Use View Transitions API for this navigation. Pass true or options object. */
+    viewTransition?: boolean | ViewTransitionOptions;
     /** Children elements */
     children?: React.ReactNode;
 }

package/dist/link.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../src/link.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,SAAU,SAAQ,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC5F,uCAAuC;IACvC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,sCAAsC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4CAA4C;IAC5C,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,wCAAwC;IACxC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,uDAAuD;IACvD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AA4CD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,IAAI,qFA2If,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC;IAC1E,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,kBAAkB,KAAK,MAAM,CAAC,CAAC;IAC7D,2DAA2D;IAC3D,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,GAAG,CAAC,CAAC,KAAK,EAAE,kBAAkB,KAAK,KAAK,CAAC,aAAa,CAAC,CAAC;IACnF,6CAA6C;IAC7C,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,OAAO,wFA0DlB,CAAC;AAEH;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAQ,GAAG,OAAO,CAqB9D"}
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../src/link.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,SAAU,SAAQ,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC5F,uCAAuC;IACvC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,sCAAsC;IACtC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4CAA4C;IAC5C,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,wCAAwC;IACxC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,uDAAuD;IACvD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iFAAiF;IACjF,cAAc,CAAC,EAAE,OAAO,GAAG,qBAAqB,CAAC;IACjD,wBAAwB;IACxB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AA4CD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,IAAI,qFA4If,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC;IAC1E,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,kBAAkB,KAAK,MAAM,CAAC,CAAC;IAC7D,2DAA2D;IAC3D,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,GAAG,CAAC,CAAC,KAAK,EAAE,kBAAkB,KAAK,KAAK,CAAC,aAAa,CAAC,CAAC;IACnF,6CAA6C;IAC7C,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,OAAO,wFA0DlB,CAAC;AAEH;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAQ,GAAG,OAAO,CAqB9D"}

package/dist/matches.d.ts

@@ -0,0 +1,93 @@
+/**
+ * @ereo/client - useMatches Hook
+ *
+ * Provides access to all matched route segments and their data.
+ * Enables breadcrumbs, analytics, route-based metadata, and more.
+ */
+import { type ReactNode, type Context } from 'react';
+import type { RouteParams, RouteHandle } from '@ereo/core';
+/**
+ * Data for a single matched route in the route hierarchy.
+ * Returned as part of the useMatches() array.
+ */
+export interface RouteMatchData {
+    /** Route identifier (e.g., '/users/[id]' or 'root-layout') */
+    id: string;
+    /** Matched pathname for this route segment */
+    pathname: string;
+    /** Route params at this level */
+    params: RouteParams;
+    /** Loader data for this route (null if no loader) */
+    data: unknown;
+    /** Route handle metadata (from `export const handle = { ... }`) */
+    handle: RouteHandle | undefined;
+}
+/**
+ * Context value for the matches context.
+ */
+export interface MatchesContextValue {
+    matches: RouteMatchData[];
+    setMatches: (matches: RouteMatchData[]) => void;
+}
+/**
+ * Props for MatchesProvider.
+ */
+export interface MatchesProviderProps {
+    children: ReactNode;
+    initialMatches?: RouteMatchData[];
+}
+/**
+ * Context holding all matched routes for the current URL.
+ */
+export declare const MatchesContext: Context<MatchesContextValue | null>;
+/**
+ * Access all matched routes from root layout to current page.
+ *
+ * Returns an array of match objects, each containing the route's id,
+ * pathname, params, loader data, and handle metadata.
+ *
+ * @returns Array of RouteMatchData, ordered from outermost layout to page
+ * @throws Error if used outside of EreoProvider
+ *
+ * @example
+ * ```tsx
+ * // Build breadcrumbs from handle metadata
+ * function Breadcrumbs() {
+ *   const matches = useMatches();
+ *
+ *   const crumbs = matches
+ *     .filter(m => m.handle?.breadcrumb)
+ *     .map(m => ({
+ *       label: m.handle!.breadcrumb as string,
+ *       path: m.pathname,
+ *     }));
+ *
+ *   return (
+ *     <nav>
+ *       {crumbs.map((c, i) => (
+ *         <span key={i}>{i > 0 && ' > '}{c.label}</span>
+ *       ))}
+ *     </nav>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Analytics: track route data
+ * function Analytics() {
+ *   const matches = useMatches();
+ *   const routeIds = matches.map(m => m.id);
+ *   useEffect(() => {
+ *     trackPageView(routeIds);
+ *   }, [routeIds.join(',')]);
+ *   return null;
+ * }
+ * ```
+ */
+export declare function useMatches(): RouteMatchData[];
+/**
+ * Provider for route matches context.
+ */
+export declare function MatchesProvider({ children, initialMatches, }: MatchesProviderProps): ReactNode;
+//# sourceMappingURL=matches.d.ts.map

package/dist/matches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matches.d.ts","sourceRoot":"","sources":["../src/matches.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAML,KAAK,SAAS,EACd,KAAK,OAAO,EACb,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM3D;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,EAAE,EAAE,MAAM,CAAC;IACX,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,MAAM,EAAE,WAAW,CAAC;IACpB,qDAAqD;IACrD,IAAI,EAAE,OAAO,CAAC;IACd,mEAAmE;IACnE,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,UAAU,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,IAAI,CAAC;CACjD;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,SAAS,CAAC;IACpB,cAAc,CAAC,EAAE,cAAc,EAAE,CAAC;CACnC;AAMD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,OAAO,CAAC,mBAAmB,GAAG,IAAI,CACd,CAAC;AAMlD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,UAAU,IAAI,cAAc,EAAE,CAW7C;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,cAAmB,GACpB,EAAE,oBAAoB,GAAG,SAAS,CASlC"}

package/dist/navigation.d.ts

@@ -4,6 +4,7 @@
  * SPA-style navigation with loader data fetching.
  */
 import type { RouteParams } from '@ereo/core';
+import { type ViewTransitionOptions } from './view-transition';
 /**
  * Navigation state.
  */
@@ -25,13 +26,55 @@ export interface NavigationEvent {
  * Navigation listener.
  */
 export type NavigationListener = (event: NavigationEvent) => void;
+/**
+ * Blocker function - returns true to block navigation.
+ */
+export type BlockerFunction = () => boolean;
+/**
+ * Pending navigation that was blocked.
+ */
+export interface PendingNavigation {
+    to: string;
+    options: {
+        replace?: boolean;
+        state?: unknown;
+        viewTransition?: boolean | ViewTransitionOptions;
+    };
+}
 /**
  * Client router for SPA navigation.
  */
 declare class ClientRouter {
     private listeners;
     private currentState;
+    private blockers;
+    private blockerListeners;
+    pendingNavigation: PendingNavigation | null;
     constructor();
+    /**
+     * Add a blocker function. Returns a cleanup function.
+     */
+    addBlocker(fn: BlockerFunction): () => void;
+    /**
+     * Check if any blocker wants to block navigation.
+     */
+    isBlocked(): boolean;
+    /**
+     * Subscribe to blocker state changes.
+     */
+    subscribeBlocker(listener: () => void): () => void;
+    /**
+     * Notify blocker listeners.
+     */
+    private notifyBlockers;
+    /**
+     * Proceed with a pending blocked navigation.
+     */
+    proceedNavigation(): void;
+    /**
+     * Reset pending navigation (user chose to stay).
+     */
+    resetNavigation(): void;
     /**
      * Get current state from window.location.
      */
@@ -46,6 +89,7 @@ declare class ClientRouter {
     navigate(to: string, options?: {
         replace?: boolean;
         state?: unknown;
+        viewTransition?: boolean | ViewTransitionOptions;
     }): Promise<void>;
     /**
      * Go back in history.
@@ -86,6 +130,7 @@ export declare const router: ClientRouter;
 export declare function navigate(to: string, options?: {
     replace?: boolean;
     state?: unknown;
+    viewTransition?: boolean | ViewTransitionOptions;
 }): Promise<void>;
 /**
  * Go back in history.

package/dist/navigation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../src/navigation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,CAAC;IACjC,IAAI,EAAE,eAAe,CAAC;IACtB,EAAE,EAAE,eAAe,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;AAElE;;GAEG;AACH,cAAM,YAAY;IAChB,OAAO,CAAC,SAAS,CAAiC;IAClD,OAAO,CAAC,YAAY,CAAkB;;IAOtC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAa5B;;OAEG;IACH,OAAO,CAAC,aAAa;IAerB;;OAEG;IACG,QAAQ,CACZ,EAAE,EAAE,MAAM,EACV,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,GACnD,OAAO,CAAC,IAAI,CAAC;IA8BhB;;OAEG;IACH,IAAI,IAAI,IAAI;IAMZ;;OAEG;IACH,OAAO,IAAI,IAAI;IAMf;;OAEG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMvB;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,IAAI;IAKnD;;OAEG;IACH,OAAO,CAAC,MAAM;IAMd;;OAEG;IACH,QAAQ,IAAI,eAAe;IAI3B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,UAAQ,GAAG,OAAO;CAM/C;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,cAAqB,CAAC;AAEzC;;GAEG;AACH,wBAAgB,QAAQ,CACtB,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/C,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;GAEG;AACH,wBAAgB,MAAM,IAAI,IAAI,CAE7B;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,IAAI,CAEhC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,IAAI,CAEnE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAEpD;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,CAAC,GAAG,OAAO,EAC/C,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,CAAC,CAAC,CAwBZ;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,CAAC,GAAG,OAAO,EAC5C,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAChC,OAAO,CAAC,CAAC,CAAC,CAcZ;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CA4B7C"}
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../src/navigation.ts"],"names":[],"mappings":"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"}

package/dist/outlet.d.ts

@@ -0,0 +1,150 @@
+/**
+ * @ereo/client - Outlet Component
+ *
+ * Provides the <Outlet /> component and useOutletContext hook for
+ * nested layout rendering. Layouts render <Outlet /> where child
+ * content should appear, and can pass data to children via the
+ * context prop without prop drilling.
+ */
+import { type ReactNode, type Context } from 'react';
+/**
+ * Internal context value for Outlet — carries the child element to render.
+ */
+export interface OutletElementContextValue {
+    /** The child route element to render */
+    element: ReactNode;
+}
+/**
+ * Internal context value for Outlet context data — carries data
+ * passed via <Outlet context={...} />.
+ */
+export interface OutletContextValue {
+    /** Arbitrary data passed from a layout to its children */
+    data: unknown;
+}
+/**
+ * Props for the Outlet component.
+ */
+export interface OutletProps {
+    /**
+     * Context data to pass to child routes.
+     * Accessible via useOutletContext() in child components.
+     *
+     * @example
+     * ```tsx
+     * // In a layout
+     * export default function DashboardLayout() {
+     *   const { user } = useLoaderData<{ user: User }>();
+     *   return (
+     *     <div>
+     *       <Sidebar user={user} />
+     *       <Outlet context={{ user }} />
+     *     </div>
+     *   );
+     * }
+     * ```
+     */
+    context?: unknown;
+}
+/**
+ * Props for OutletProvider (internal — used by the server/router to
+ * wrap layout trees).
+ */
+export interface OutletProviderProps {
+    children: ReactNode;
+    /** The child route element that <Outlet /> will render */
+    element: ReactNode;
+    /** Context data available via useOutletContext() */
+    context?: unknown;
+}
+/**
+ * Context for the child element that Outlet should render.
+ * @internal
+ */
+export declare const OutletElementContext: Context<OutletElementContextValue | null>;
+/**
+ * Context for data passed via <Outlet context={...} />.
+ * This is a separate context so that useOutletContext works
+ * regardless of whether the user reads the element context.
+ */
+export declare const OutletDataContext: Context<OutletContextValue | null>;
+/**
+ * Renders the child route element within a layout.
+ *
+ * Place this component in your layout where child routes should appear.
+ * Optionally pass a `context` prop to make data available to children
+ * via `useOutletContext()`.
+ *
+ * @example
+ * ```tsx
+ * // Basic usage in a layout
+ * export default function AppLayout() {
+ *   return (
+ *     <html>
+ *       <body>
+ *         <Header />
+ *         <main>
+ *           <Outlet />
+ *         </main>
+ *         <Footer />
+ *       </body>
+ *     </html>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Passing context to child routes
+ * export default function DashboardLayout() {
+ *   const { user, permissions } = useLoaderData<DashboardData>();
+ *   return (
+ *     <div className="dashboard">
+ *       <Sidebar />
+ *       <Outlet context={{ user, permissions }} />
+ *     </div>
+ *   );
+ * }
+ *
+ * // In a child route
+ * function Settings() {
+ *   const { user, permissions } = useOutletContext<{
+ *     user: User;
+ *     permissions: string[];
+ *   }>();
+ *   // ...
+ * }
+ * ```
+ */
+export declare function Outlet({ context }?: OutletProps): ReactNode;
+/**
+ * Access context data passed from a parent layout's <Outlet context={...} />.
+ *
+ * @returns The context data from the nearest parent Outlet
+ * @throws Error if no parent Outlet has provided context
+ *
+ * @example
+ * ```tsx
+ * interface DashboardContext {
+ *   user: User;
+ *   permissions: string[];
+ * }
+ *
+ * function SettingsPage() {
+ *   const { user, permissions } = useOutletContext<DashboardContext>();
+ *   return <div>Settings for {user.name}</div>;
+ * }
+ * ```
+ */
+export declare function useOutletContext<T = unknown>(): T;
+/**
+ * Provider that sets up the outlet element context for a layout level.
+ *
+ * Used internally by the server/router when composing layout trees.
+ * Each layout level gets its own OutletProvider that tells <Outlet />
+ * what to render as its child content.
+ *
+ * @internal
+ */
+export declare function OutletProvider({ children, element, context, }: OutletProviderProps): ReactNode;
+//# sourceMappingURL=outlet.d.ts.map

package/dist/outlet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outlet.d.ts","sourceRoot":"","sources":["../src/outlet.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAIL,KAAK,SAAS,EAEd,KAAK,OAAO,EACb,MAAM,OAAO,CAAC;AAMf;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,wCAAwC;IACxC,OAAO,EAAE,SAAS,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,0DAA0D;IAC1D,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,SAAS,CAAC;IACpB,0DAA0D;IAC1D,OAAO,EAAE,SAAS,CAAC;IACnB,oDAAoD;IACpD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAMD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,OAAO,CAAC,yBAAyB,GAAG,IAAI,CACpB,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAAO,CAAC,kBAAkB,GAAG,IAAI,CACjB,CAAC;AAMjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAgB,MAAM,CAAC,EAAE,OAAO,EAAE,GAAE,WAAgB,GAAG,SAAS,CAoB/D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,OAAO,KAAK,CAAC,CAYjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,OAAO,EACP,OAAO,GACR,EAAE,mBAAmB,GAAG,SAAS,CAsBjC"}

package/dist/revalidation.d.ts

@@ -0,0 +1,85 @@
+/**
+ * @ereo/client - Revalidation
+ *
+ * Controls which route loaders re-run after navigations and mutations.
+ * Routes can export a `shouldRevalidate` function to opt out of
+ * unnecessary data re-fetching, improving performance.
+ */
+import type { RouteModule, RouteParams, ShouldRevalidateArgs, ShouldRevalidateFunction } from '@ereo/core';
+/**
+ * A matched route with its loaded module, used for revalidation decisions.
+ */
+export interface RevalidationRoute {
+    /** Route identifier */
+    id: string;
+    /** Route path pattern */
+    path: string;
+    /** The loaded route module */
+    module?: RouteModule;
+    /** Current params for this route */
+    params: RouteParams;
+}
+/**
+ * Context for a revalidation check after a navigation or mutation.
+ */
+export interface RevalidationContext {
+    /** The URL the user is navigating from */
+    currentUrl: URL;
+    /** The URL the user is navigating to */
+    nextUrl: URL;
+    /** If triggered by a form submission, the HTTP method */
+    formMethod?: string;
+    /** If triggered by a form submission, the action URL */
+    formAction?: string;
+    /** If triggered by a form submission, the form data */
+    formData?: FormData;
+    /** If triggered by a completed action, the action result */
+    actionResult?: unknown;
+}
+/**
+ * Determine which routes need their loaders re-run.
+ *
+ * For each active route, checks its `shouldRevalidate` export.
+ * If the route doesn't export one, it defaults to revalidating.
+ *
+ * @param routes - The currently matched routes (including layouts)
+ * @param nextParams - The params that will be active after navigation
+ * @param context - Information about the navigation/mutation that triggered revalidation
+ * @returns Array of route IDs that should have their loaders re-run
+ */
+export declare function getRoutesToRevalidate(routes: RevalidationRoute[], nextParams: RouteParams, context: RevalidationContext): string[];
+/**
+ * Check if a single route should revalidate.
+ *
+ * Utility for checking individual routes outside of a batch.
+ */
+export declare function checkShouldRevalidate(shouldRevalidateFn: ShouldRevalidateFunction | undefined, args: ShouldRevalidateArgs): boolean;
+/**
+ * State returned by useRevalidator.
+ */
+export interface RevalidatorState {
+    /** Current revalidation state */
+    state: 'idle' | 'loading';
+    /** Trigger a revalidation of the current route's data */
+    revalidate: () => Promise<void>;
+}
+/**
+ * Hook to manually revalidate the current route's loader data.
+ * Fetches fresh data from the server and updates contexts.
+ *
+ * @returns RevalidatorState with state and revalidate function
+ *
+ * @example
+ * ```tsx
+ * function Dashboard() {
+ *   const { state, revalidate } = useRevalidator();
+ *   return (
+ *     <button onClick={revalidate} disabled={state === 'loading'}>
+ *       {state === 'loading' ? 'Refreshing...' : 'Refresh Data'}
+ *     </button>
+ *   );
+ * }
+ * ```
+ */
+export declare function useRevalidator(): RevalidatorState;
+//# sourceMappingURL=revalidation.d.ts.map

package/dist/revalidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revalidation.d.ts","sourceRoot":"","sources":["../src/revalidation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAIpB;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,oCAAoC;IACpC,MAAM,EAAE,WAAW,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,0CAA0C;IAC1C,UAAU,EAAE,GAAG,CAAC;IAChB,wCAAwC;IACxC,OAAO,EAAE,GAAG,CAAC;IACb,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,iBAAiB,EAAE,EAC3B,UAAU,EAAE,WAAW,EACvB,OAAO,EAAE,mBAAmB,GAC3B,MAAM,EAAE,CA8CV;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,kBAAkB,EAAE,wBAAwB,GAAG,SAAS,EACxD,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAUT;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,yDAAyD;IACzD,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,IAAI,gBAAgB,CAsCjD"}

package/dist/route-links.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @ereo/client - Route Links Manager
+ *
+ * Manages per-route link elements (<link>) in the document <head>.
+ * When navigating between routes, old route links are removed and
+ * new ones are injected, ensuring each route gets its own CSS/assets.
+ */
+import type { LinkDescriptor } from '@ereo/core';
+/**
+ * Render link descriptors as HTML string (for SSR).
+ * Used when the server needs to inject links into a layout component.
+ */
+export declare function renderLinkTags(links: LinkDescriptor[]): string;
+/**
+ * Update the document <head> with new route link descriptors.
+ * Removes previous route links and adds new ones.
+ *
+ * This is called during client-side navigation after receiving
+ * the JSON response with link descriptors.
+ */
+export declare function updateRouteLinks(links: LinkDescriptor[]): void;
+/**
+ * Remove all Ereo-managed route links from <head>.
+ */
+export declare function removeRouteLinks(): void;
+/**
+ * Get the currently active route link descriptors count.
+ */
+export declare function getActiveLinksCount(): number;
+//# sourceMappingURL=route-links.d.ts.map

package/dist/route-links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-links.d.ts","sourceRoot":"","sources":["../src/route-links.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAQjD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,MAAM,CAU9D;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,IAAI,CAyB9D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAOvC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C"}