@ereo/client 0.1.6

package/dist/islands.d.ts

@@ -0,0 +1,103 @@
+/**
+ * @ereo/client - Islands Architecture
+ *
+ * Selective hydration for interactive components.
+ * Static content stays static, only islands get hydrated.
+ */
+import type { ComponentType } from 'react';
+import type { HydrationStrategy } from '@ereo/core';
+import { type HydrationProps } from './hydration';
+/**
+ * Island registration.
+ */
+export interface IslandRegistration {
+    id: string;
+    component: ComponentType<any>;
+    props: Record<string, unknown>;
+    strategy: HydrationStrategy;
+    media?: string;
+    element: Element;
+    hydrated: boolean;
+}
+/**
+ * Island registry - tracks all islands on the page.
+ */
+declare class IslandRegistry {
+    private islands;
+    private cleanups;
+    /**
+     * Register an island for hydration.
+     */
+    register(id: string, component: ComponentType<any>, props: Record<string, unknown>, strategy: HydrationStrategy, element: Element, media?: string): void;
+    /**
+     * Get an island by ID.
+     */
+    get(id: string): IslandRegistration | undefined;
+    /**
+     * Mark an island as hydrated.
+     */
+    markHydrated(id: string): void;
+    /**
+     * Check if an island is hydrated.
+     */
+    isHydrated(id: string): boolean;
+    /**
+     * Set cleanup function for an island.
+     */
+    setCleanup(id: string, cleanup: () => void): void;
+    /**
+     * Cleanup an island.
+     */
+    cleanup(id: string): void;
+    /**
+     * Cleanup all islands.
+     */
+    cleanupAll(): void;
+    /**
+     * Get all islands.
+     */
+    getAll(): IslandRegistration[];
+    /**
+     * Get islands by strategy.
+     */
+    getByStrategy(strategy: HydrationStrategy): IslandRegistration[];
+    /**
+     * Get pending (not hydrated) islands.
+     */
+    getPending(): IslandRegistration[];
+}
+/**
+ * Global island registry.
+ */
+export declare const islandRegistry: IslandRegistry;
+/**
+ * Hydrate all islands on the page.
+ */
+export declare function hydrateIslands(): Promise<void>;
+/**
+ * Register an island component.
+ */
+export declare function registerIslandComponent(name: string, component: ComponentType<any>): void;
+/**
+ * Get an island component by name.
+ */
+export declare function getIslandComponent(name: string): ComponentType<any> | undefined;
+/**
+ * Register multiple island components.
+ */
+export declare function registerIslandComponents(components: Record<string, ComponentType<any>>): void;
+/**
+ * Create an island wrapper component.
+ * This is used during SSR to mark components for hydration.
+ */
+export declare function createIsland<P extends Record<string, unknown>>(component: ComponentType<P>, name: string): ComponentType<P & HydrationProps>;
+/**
+ * Auto-initialize islands on DOM ready.
+ */
+export declare function initializeIslands(): void;
+/**
+ * Cleanup all islands (for SPA navigation).
+ */
+export declare function cleanupIslands(): void;
+export {};
+//# sourceMappingURL=islands.d.ts.map

package/dist/islands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"islands.d.ts","sourceRoot":"","sources":["../src/islands.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,cAAM,cAAc;IAClB,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,QAAQ,CAAiC;IAEjD;;OAEG;IACH,QAAQ,CACN,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC,EAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,EAAE,OAAO,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,IAAI;IAYP;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAI/C;;OAEG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAO9B;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI/B;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI;IAIjD;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IASzB;;OAEG;IACH,UAAU,IAAI,IAAI;IAMlB;;OAEG;IACH,MAAM,IAAI,kBAAkB,EAAE;IAI9B;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,iBAAiB,GAAG,kBAAkB,EAAE;IAIhE;;OAEG;IACH,UAAU,IAAI,kBAAkB,EAAE;CAGnC;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,gBAAuB,CAAC;AAEnD;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAiDpD;AAOD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,IAAI,CAEzF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,SAAS,CAE/E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,GAC7C,IAAI,CAIN;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5D,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,EAC3B,IAAI,EAAE,MAAM,GACX,aAAa,CAAC,CAAC,GAAG,cAAc,CAAC,CA4BnC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAQxC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC"}

package/dist/link.d.ts

@@ -0,0 +1,91 @@
+/**
+ * @ereo/client - Link Component
+ *
+ * Link and NavLink components with prefetch support for client-side navigation.
+ */
+import * as React from 'react';
+/**
+ * Prefetch strategy for links.
+ */
+export type PrefetchStrategy = 'none' | 'intent' | 'render' | 'viewport';
+/**
+ * Link component props.
+ */
+export interface LinkProps extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'href'> {
+    /** URL to navigate to */
+    to: string;
+    /** Prefetch strategy (default: 'intent') */
+    prefetch?: PrefetchStrategy;
+    /** Replace history instead of push */
+    replace?: boolean;
+    /** Prevent scroll reset after navigation */
+    preventScrollReset?: boolean;
+    /** State to pass to the new location */
+    state?: unknown;
+    /** Reload the document instead of client navigation */
+    reloadDocument?: boolean;
+    /** Children elements */
+    children?: React.ReactNode;
+}
+/**
+ * Link component for client-side navigation with prefetch support.
+ *
+ * Renders an anchor tag for accessibility and SEO while intercepting
+ * clicks for client-side navigation.
+ *
+ * @example
+ * ```tsx
+ * <Link to="/about">About</Link>
+ * <Link to="/dashboard" prefetch="render">Dashboard</Link>
+ * <Link to="/external" reloadDocument>External</Link>
+ * ```
+ */
+export declare const Link: React.ForwardRefExoticComponent<LinkProps & React.RefAttributes<HTMLAnchorElement>>;
+/**
+ * Active state props for NavLink.
+ */
+export interface NavLinkActiveProps {
+    isActive: boolean;
+    isPending: boolean;
+}
+/**
+ * NavLink component props.
+ */
+export interface NavLinkProps extends Omit<LinkProps, 'className' | 'style'> {
+    /** Class name - can be a function that receives active state */
+    className?: string | ((props: NavLinkActiveProps) => string);
+    /** Style - can be a function that receives active state */
+    style?: React.CSSProperties | ((props: NavLinkActiveProps) => React.CSSProperties);
+    /** Match exact path only (default: false) */
+    end?: boolean;
+}
+/**
+ * NavLink component - Link with active state styling.
+ *
+ * Automatically applies active styles/classes when the current
+ * location matches the link's destination.
+ *
+ * @example
+ * ```tsx
+ * <NavLink
+ *   to="/dashboard"
+ *   className={({ isActive }) => isActive ? 'active' : ''}
+ * >
+ *   Dashboard
+ * </NavLink>
+ *
+ * <NavLink
+ *   to="/settings"
+ *   style={({ isActive }) => ({ fontWeight: isActive ? 'bold' : 'normal' })}
+ * >
+ *   Settings
+ * </NavLink>
+ * ```
+ */
+export declare const NavLink: React.ForwardRefExoticComponent<NavLinkProps & React.RefAttributes<HTMLAnchorElement>>;
+/**
+ * Hook to get the active state for a given path.
+ * Useful for building custom navigation components.
+ */
+export declare function useIsActive(path: string, end?: boolean): boolean;
+//# sourceMappingURL=link.d.ts.map

package/dist/link.d.ts.map

@@ -0,0 +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,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,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,qFAuIf,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,wFAuDlB,CAAC;AAEH;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAQ,GAAG,OAAO,CAqB9D"}

package/dist/navigation.d.ts

@@ -0,0 +1,121 @@
+/**
+ * @ereo/client - Client-side Navigation
+ *
+ * SPA-style navigation with loader data fetching.
+ */
+import type { RouteParams } from '@ereo/core';
+/**
+ * Navigation state.
+ */
+export interface NavigationState {
+    pathname: string;
+    search: string;
+    hash: string;
+    state?: unknown;
+}
+/**
+ * Navigation event.
+ */
+export interface NavigationEvent {
+    type: 'push' | 'replace' | 'pop';
+    from: NavigationState;
+    to: NavigationState;
+}
+/**
+ * Navigation listener.
+ */
+export type NavigationListener = (event: NavigationEvent) => void;
+/**
+ * Client router for SPA navigation.
+ */
+declare class ClientRouter {
+    private listeners;
+    private currentState;
+    constructor();
+    /**
+     * Get current state from window.location.
+     */
+    private getStateFromLocation;
+    /**
+     * Setup popstate listener.
+     */
+    private setupPopState;
+    /**
+     * Navigate to a new URL.
+     */
+    navigate(to: string, options?: {
+        replace?: boolean;
+        state?: unknown;
+    }): Promise<void>;
+    /**
+     * Go back in history.
+     */
+    back(): void;
+    /**
+     * Go forward in history.
+     */
+    forward(): void;
+    /**
+     * Go to a specific history entry.
+     */
+    go(delta: number): void;
+    /**
+     * Subscribe to navigation events.
+     */
+    subscribe(listener: NavigationListener): () => void;
+    /**
+     * Notify all listeners.
+     */
+    private notify;
+    /**
+     * Get current navigation state.
+     */
+    getState(): NavigationState;
+    /**
+     * Check if a URL is the current location.
+     */
+    isActive(path: string, exact?: boolean): boolean;
+}
+/**
+ * Global client router instance.
+ */
+export declare const router: ClientRouter;
+/**
+ * Navigate to a new URL.
+ */
+export declare function navigate(to: string, options?: {
+    replace?: boolean;
+    state?: unknown;
+}): Promise<void>;
+/**
+ * Go back in history.
+ */
+export declare function goBack(): void;
+/**
+ * Go forward in history.
+ */
+export declare function goForward(): void;
+/**
+ * Subscribe to navigation events.
+ */
+export declare function onNavigate(listener: NavigationListener): () => void;
+/**
+ * Get current navigation state.
+ */
+export declare function getNavigationState(): NavigationState;
+/**
+ * Fetch loader data for a route.
+ */
+export declare function fetchLoaderData<T = unknown>(pathname: string, params?: RouteParams): Promise<T>;
+/**
+ * Submit an action.
+ */
+export declare function submitAction<T = unknown>(pathname: string, formData: FormData, options?: {
+    method?: string;
+}): Promise<T>;
+/**
+ * Scroll restoration helper.
+ */
+export declare function setupScrollRestoration(): void;
+export {};
+//# sourceMappingURL=navigation.d.ts.map

package/dist/navigation.d.ts.map

@@ -0,0 +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"}

package/dist/prefetch.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @ereo/client - Link Prefetching
+ *
+ * Intelligent prefetching for faster navigation.
+ */
+/**
+ * Prefetch options.
+ */
+export interface PrefetchOptions {
+    /** Prefetch strategy */
+    strategy?: 'hover' | 'viewport' | 'eager' | 'none';
+    /** Cache duration in milliseconds (default: 30000) */
+    cacheDuration?: number;
+    /** Intersection observer threshold */
+    threshold?: number;
+}
+/**
+ * Prefetch a URL.
+ */
+export declare function prefetch(url: string): Promise<void>;
+/**
+ * Get prefetched data.
+ */
+export declare function getPrefetchedData<T>(url: string): T | undefined;
+/**
+ * Clear prefetch cache.
+ */
+export declare function clearPrefetchCache(): void;
+/**
+ * Setup prefetch for a link element.
+ */
+export declare function setupLinkPrefetch(element: HTMLAnchorElement, options?: PrefetchOptions): () => void;
+/**
+ * Auto-setup prefetching for all links.
+ */
+export declare function setupAutoPrefetch(options?: PrefetchOptions): () => void;
+/**
+ * Prefetch multiple URLs.
+ */
+export declare function prefetchAll(urls: string[]): Promise<void>;
+/**
+ * Create a link prefetch directive for JSX.
+ */
+export interface LinkPrefetchProps {
+    href: string;
+    prefetch?: PrefetchOptions['strategy'];
+    children: React.ReactNode;
+}
+/**
+ * Check if a URL is being prefetched.
+ */
+export declare function isPrefetching(url: string): boolean;
+/**
+ * Check if a URL has been prefetched.
+ */
+export declare function isPrefetched(url: string): boolean;
+//# sourceMappingURL=prefetch.d.ts.map

package/dist/prefetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefetch.d.ts","sourceRoot":"","sources":["../src/prefetch.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,QAAQ,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;IACnD,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAkBD;;GAEG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoCzD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAM/D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,iBAAiB,EAC1B,OAAO,GAAE,eAAoB,GAC5B,MAAM,IAAI,CAmDZ;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,eAAoB,GAAG,MAAM,IAAI,CAkC3E;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/D;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC;IACvC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGlD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGjD"}

package/dist/typed-link.d.ts

@@ -0,0 +1,189 @@
+/**
+ * @ereo/client - Type-Safe Link Component
+ *
+ * Link component that validates routes exist and requires correct params
+ * per-route at compile time.
+ *
+ * @example
+ * ```tsx
+ * // Valid - route exists and params match
+ * <TypedLink to="/users/[id]" params={{ id: "123" }}>User</TypedLink>
+ *
+ * // Error - missing required params
+ * <TypedLink to="/users/[id]">User</TypedLink>
+ *
+ * // Error - route doesn't exist
+ * <TypedLink to="/invalid">Invalid</TypedLink>
+ *
+ * // With search and hash params (Ereo exclusive)
+ * <TypedLink
+ *   to="/posts/[slug]"
+ *   params={{ slug: "hello-world" }}
+ *   search={{ page: 1 }}
+ *   hash={{ section: "comments" }}
+ * >
+ *   Post
+ * </TypedLink>
+ * ```
+ */
+import * as React from 'react';
+import type { TypedRoutes, RouteParamsFor, SearchParamsFor, HashParamsFor } from '@ereo/core';
+/**
+ * Check if params object is empty (no required params).
+ */
+type IsEmptyObject<T> = keyof T extends never ? true : false;
+/**
+ * Check if all properties in T are optional.
+ */
+type AllOptional<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? true : false;
+}[keyof T] extends true ? true : false;
+/**
+ * Make params prop required only if the route has required params.
+ */
+type ParamsProps<Path extends string, Params> = IsEmptyObject<Params> extends true ? {
+    params?: never;
+} : AllOptional<Params> extends true ? {
+    params?: Params;
+} : {
+    params: Params;
+};
+/**
+ * Make search prop optional, typed to route's search params.
+ */
+type SearchProps<Path extends TypedRoutes> = {
+    search?: Partial<SearchParamsFor<Path>>;
+};
+/**
+ * Make hash prop optional, typed to route's hash params.
+ * This is UNIQUE to Ereo - TanStack has no hash param support.
+ */
+type HashProps<Path extends TypedRoutes> = {
+    hash?: Partial<HashParamsFor<Path>>;
+};
+/**
+ * Prefetch strategy for links.
+ */
+export type PrefetchStrategy = 'none' | 'intent' | 'render' | 'viewport';
+/**
+ * Base props for TypedLink.
+ */
+interface TypedLinkBaseProps extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, 'href'> {
+    /** Prefetch strategy (default: 'intent') */
+    prefetch?: PrefetchStrategy;
+    /** Replace history instead of push */
+    replace?: boolean;
+    /** Prevent scroll reset after navigation */
+    preventScrollReset?: boolean;
+    /** State to pass to the new location */
+    state?: unknown;
+    /** Reload the document instead of client navigation */
+    reloadDocument?: boolean;
+    /** Children elements */
+    children?: React.ReactNode;
+}
+/**
+ * Full props for TypedLink with conditional params requirement.
+ */
+export type TypedLinkProps<Path extends TypedRoutes = TypedRoutes> = TypedLinkBaseProps & {
+    /** Route path to navigate to */
+    to: Path;
+} & ParamsProps<Path extends string ? Path : never, RouteParamsFor<Path>> & SearchProps<Path> & HashProps<Path>;
+/**
+ * Build a complete URL from pattern, params, search, and hash.
+ */
+export declare function buildUrl<Path extends TypedRoutes>(pattern: Path, options?: {
+    params?: RouteParamsFor<Path>;
+    search?: Partial<SearchParamsFor<Path>>;
+    hash?: Partial<HashParamsFor<Path>>;
+}): string;
+/**
+ * Type-safe Link component for client-side navigation.
+ *
+ * Validates that:
+ * 1. The route path exists in your route definitions
+ * 2. Required params are provided with correct types
+ * 3. Search params match the route's search schema
+ * 4. Hash params match the route's hash schema (Ereo exclusive)
+ *
+ * @example
+ * ```tsx
+ * // Basic usage
+ * <TypedLink to="/about">About</TypedLink>
+ *
+ * // With params
+ * <TypedLink to="/users/[id]" params={{ id: "123" }}>User Profile</TypedLink>
+ *
+ * // With search and hash params
+ * <TypedLink
+ *   to="/posts/[slug]"
+ *   params={{ slug: "hello" }}
+ *   search={{ page: 1, sort: 'asc' }}
+ *   hash={{ section: 'comments' }}
+ * >
+ *   Post
+ * </TypedLink>
+ *
+ * // Prefetch on viewport
+ * <TypedLink to="/dashboard" prefetch="viewport">Dashboard</TypedLink>
+ * ```
+ */
+export declare const TypedLink: <Path extends TypedRoutes>(props: TypedLinkProps<Path> & {
+    ref?: React.ForwardedRef<HTMLAnchorElement>;
+}) => React.ReactElement | null;
+/**
+ * Active state props for TypedNavLink.
+ */
+export interface NavLinkActiveProps {
+    isActive: boolean;
+    isPending: boolean;
+}
+/**
+ * TypedNavLink props extending TypedLink with active state support.
+ */
+export type TypedNavLinkProps<Path extends TypedRoutes = TypedRoutes> = Omit<TypedLinkProps<Path>, 'className' | 'style'> & {
+    /** Class name - can be a function that receives active state */
+    className?: string | ((props: NavLinkActiveProps) => string);
+    /** Style - can be a function that receives active state */
+    style?: React.CSSProperties | ((props: NavLinkActiveProps) => React.CSSProperties);
+    /** Match exact path only (default: false) */
+    end?: boolean;
+};
+/**
+ * Type-safe NavLink component with active state styling.
+ *
+ * @example
+ * ```tsx
+ * <TypedNavLink
+ *   to="/dashboard"
+ *   className={({ isActive }) => isActive ? 'active' : ''}
+ * >
+ *   Dashboard
+ * </TypedNavLink>
+ *
+ * <TypedNavLink
+ *   to="/users/[id]"
+ *   params={{ id: "123" }}
+ *   style={({ isActive }) => ({ fontWeight: isActive ? 'bold' : 'normal' })}
+ * >
+ *   User
+ * </TypedNavLink>
+ * ```
+ */
+export declare const TypedNavLink: <Path extends TypedRoutes>(props: TypedNavLinkProps<Path> & {
+    ref?: React.ForwardedRef<HTMLAnchorElement>;
+}) => React.ReactElement | null;
+/**
+ * Hook to check if a route is currently active.
+ *
+ * @example
+ * ```tsx
+ * const isActive = useIsRouteActive('/users/[id]', { params: { id: '123' } });
+ * ```
+ */
+export declare function useIsRouteActive<Path extends TypedRoutes>(path: Path, options?: {
+    params?: RouteParamsFor<Path>;
+    end?: boolean;
+}): boolean;
+export {};
+//# sourceMappingURL=typed-link.d.ts.map

package/dist/typed-link.d.ts.map

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