@pithyjs/router 0.1.0-beta.0

package/dist/router/features/outlet/index.js

@@ -0,0 +1,95 @@
+/** @codex
+{
+  "id": "pithy.router.outlet",
+  "title": "Router Outlet Mounting System",
+  "category": "runtime"
+}
+*/
+import { buildSegmentsOffDOM, commitSegmentsToDOM, } from './mount';
+/** @codexApi {"parent":"pithy.router.outlet","name":"OutletManager","stability":"experimental","signature":"class OutletManager"} */
+/**
+ * Enhanced outlet mounting system
+ * Implements segment diff mounting with robust outlet resolution
+ * Fixed memory leak with proper two-phase mounting and cleanup
+ */
+export class OutletManager {
+    constructor() {
+        this.mountedComponents = new Map();
+        this.loadingStates = new Map();
+        this.outletElements = new Map();
+        this.router = null;
+        this.disposers = new Map();
+    }
+    /** @codexApi {"parent":"pithy.router.outlet","name":"mountSegments","stability":"experimental","signature":"(segmentChain: RouteSegmentChain[], navId: NavigationId, rootElement: HTMLElement) => Promise<boolean>"} */
+    /**
+     * Mount route segments with two-phase mounting and rollback
+     * Phase 1: Build everything off-DOM, Phase 2: Atomic commit
+     * Only remounts changed segments, preserves parent layouts
+     */
+    async mountSegments(segmentChain, navId, rootElement) {
+        try {
+            // Find the first changed segment to determine mount point
+            const firstChangedIndex = segmentChain.findIndex(segment => segment.hasChanged);
+            if (firstChangedIndex === -1) {
+                // No changes needed
+                return true;
+            }
+            // Phase 1: Build everything off-DOM first
+            const buildResult = await buildSegmentsOffDOM(segmentChain, firstChangedIndex, navId, this.router);
+            if (!buildResult.success) {
+                // Run disposers to clean up any partial work
+                buildResult.disposers.forEach(fn => fn());
+                return false;
+            }
+            // Phase 2: Atomic commit (replaces old nodes in one shot)
+            const commitResult = commitSegmentsToDOM(buildResult.fragment, buildResult.firstChangedIndex, segmentChain, rootElement, this.outletElements);
+            if (!commitResult.success) {
+                // Run disposers to clean up
+                buildResult.disposers.forEach(fn => fn());
+                return false;
+            }
+            // Register disposers on the outlet for future cleanup
+            const outletKey = this.getOutletKey(rootElement);
+            this.disposers.set(outletKey, buildResult.disposers);
+            return true;
+        }
+        catch (error) {
+            console.error('[Router] Failed to mount segments:', error);
+            return false;
+        }
+    }
+    /** @codexApi {"parent":"pithy.router.outlet","name":"setRouter","stability":"experimental","signature":"(router: RouterInstance) => void"} */
+    /**
+     * Set router instance for navigation checking
+     */
+    setRouter(router) {
+        this.router = router;
+    }
+    /** @codexApi {"parent":"pithy.router.outlet","name":"dispose","stability":"experimental","signature":"() => void"} */
+    /**
+     * Clean up all mounted components and state
+     */
+    dispose() {
+        // Clean up all mounted components
+        for (const component of this.mountedComponents.values()) {
+            if (component.cleanup) {
+                component.cleanup();
+            }
+        }
+        // Clean up all disposers
+        for (const disposers of this.disposers.values()) {
+            disposers.forEach(fn => fn());
+        }
+        this.mountedComponents.clear();
+        this.loadingStates.clear();
+        this.outletElements.clear();
+        this.disposers.clear();
+    }
+    /**
+     * Generate unique key for outlet element
+     */
+    getOutletKey(element) {
+        return element.id || element.className || element.tagName;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/router/features/outlet/index.js.map

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

package/dist/router/features/outlet/mount.d.ts

@@ -0,0 +1,38 @@
+/** @codex
+{
+  "id": "pithy.router.outlet.mount",
+  "title": "Outlet Component Mounting System",
+  "category": "runtime"
+}
+*/
+import type { RouteSegmentChain, NavigationId, ResourceState } from '../../core/types';
+/**
+ * Router interface for navigation checking
+ */
+export interface RouterInstance {
+    getActiveNavId(): NavigationId;
+    isNavActive(navId: NavigationId): boolean;
+    loaderData(): () => ResourceState | null;
+}
+/** @codexApi {"parent":"pithy.router.outlet.mount","name":"buildSegmentsOffDOM","stability":"experimental","signature":"(segmentChain: RouteSegmentChain[], firstChangedIndex: number, navId: NavigationId, router: RouterInstance | null) => Promise<BuildResult>"} */
+/**
+ * Build segments off-DOM first (Phase 1 of two-phase mounting)
+ * Returns a document fragment with all segments built, along with disposers for cleanup
+ */
+export declare function buildSegmentsOffDOM(segmentChain: RouteSegmentChain[], firstChangedIndex: number, navId: NavigationId, router: RouterInstance | null): Promise<{
+    success: boolean;
+    reason?: string | undefined;
+    fragment: DocumentFragment;
+    firstChangedIndex: number;
+    disposers: Array<() => void>;
+}>;
+/** @codexApi {"parent":"pithy.router.outlet.mount","name":"commitSegmentsToDOM","stability":"experimental","signature":"(fragment: DocumentFragment, firstChangedIndex: number, segmentChain: RouteSegmentChain[], rootElement: HTMLElement, outletElements: Map<string, HTMLElement>) => CommitResult"} */
+/**
+ * Commit segments to DOM atomically (Phase 2 of two-phase mounting)
+ * Replaces the container's children with the new fragment in one operation
+ */
+export declare function commitSegmentsToDOM(fragment: DocumentFragment, firstChangedIndex: number, segmentChain: RouteSegmentChain[], rootElement: HTMLElement, outletElements: Map<string, HTMLElement>): {
+    success: boolean;
+    reason?: string | undefined;
+};
+//# sourceMappingURL=mount.d.ts.map

package/dist/router/features/outlet/mount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../../../../src/router/features/outlet/mount.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAEF,OAAO,KAAK,EACV,iBAAiB,EAEjB,YAAY,EACZ,aAAa,EACd,MAAM,kBAAkB,CAAC;AAe1B;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,cAAc,IAAI,YAAY,CAAC;IAC/B,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC;IAC1C,UAAU,IAAI,MAAM,aAAa,GAAG,IAAI,CAAC;CAC1C;AAED,wQAAwQ;AACxQ;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,YAAY,EAAE,iBAAiB,EAAE,EACjC,iBAAiB,EAAE,MAAM,EACzB,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,cAAc,GAAG,IAAI,GAC5B,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;CAC9B,CAAC,CAuDD;AAgRD,4SAA4S;AAC5S;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,gBAAgB,EAC1B,iBAAiB,EAAE,MAAM,EACzB,YAAY,EAAE,iBAAiB,EAAE,EACjC,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,GACvC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CA0BnD"}

package/dist/router/features/outlet/mount.js

@@ -0,0 +1,301 @@
+/** @codex
+{
+  "id": "pithy.router.outlet.mount",
+  "title": "Outlet Component Mounting System",
+  "category": "runtime"
+}
+*/
+import { ROUTER_CONFIG } from '../../core/constants';
+import { routeErrors } from '../errors/router-errors';
+import { buildErrorUI, createRetryHandler } from './errors';
+import { loadRouteModule, getRouteModuleKey } from '../module-loader';
+/** @codexApi {"parent":"pithy.router.outlet.mount","name":"buildSegmentsOffDOM","stability":"experimental","signature":"(segmentChain: RouteSegmentChain[], firstChangedIndex: number, navId: NavigationId, router: RouterInstance | null) => Promise<BuildResult>"} */
+/**
+ * Build segments off-DOM first (Phase 1 of two-phase mounting)
+ * Returns a document fragment with all segments built, along with disposers for cleanup
+ */
+export async function buildSegmentsOffDOM(segmentChain, firstChangedIndex, navId, router) {
+    const fragment = document.createDocumentFragment();
+    const disposers = [];
+    for (let i = firstChangedIndex; i < segmentChain.length; i++) {
+        const segment = segmentChain[i];
+        if (!segment)
+            continue;
+        // Check if navigation is still active
+        if (!isNavigationActive(navId, router)) {
+            return {
+                success: false,
+                reason: 'superseded',
+                fragment,
+                firstChangedIndex,
+                disposers,
+            };
+        }
+        // Build this segment (pass null for outlet since we're building off-DOM)
+        const buildResult = await buildSegmentOffDOM(segment, navId, router);
+        if (!buildResult.success) {
+            const result = {
+                success: false,
+                fragment,
+                firstChangedIndex,
+                disposers,
+            };
+            if (buildResult.reason) {
+                result.reason = buildResult.reason;
+            }
+            return result;
+        }
+        // Add to fragment
+        fragment.appendChild(buildResult.element);
+        // Collect disposers
+        if (buildResult.dispose) {
+            disposers.push(buildResult.dispose);
+        }
+    }
+    return {
+        success: true,
+        fragment,
+        firstChangedIndex,
+        disposers,
+    };
+}
+/**
+ * Build a single segment off-DOM
+ * Handles both layout + page composition and standalone page components
+ */
+async function buildSegmentOffDOM(segment, navId, router) {
+    try {
+        const { node } = segment;
+        const cleanups = [];
+        // Check if route has a layout
+        if (node.imports.layout) {
+            // Load layout component through shared module cache
+            const layoutModule = await loadRouteModule(getRouteModuleKey(node.pattern, 'layout'), node.imports.layout);
+            const layoutCandidate = layoutModule.default || layoutModule;
+            if (typeof layoutCandidate !== 'function') {
+                return {
+                    success: false,
+                    reason: 'layout load failed',
+                    element: document.createElement('div'),
+                };
+            }
+            const layoutFactory = layoutCandidate;
+            const layoutInstance = layoutFactory();
+            if (!layoutInstance || !layoutInstance.el) {
+                return {
+                    success: false,
+                    reason: 'layout load failed',
+                    element: document.createElement('div'),
+                };
+            }
+            cleanups.push(layoutInstance.destroy);
+            // Find outlet in layout
+            const outlet = layoutInstance.el.querySelector('[data-router-outlet]');
+            // Load page component
+            const pageComponent = await loadComponent(segment, navId, outlet, router);
+            if (!pageComponent) {
+                return {
+                    success: false,
+                    reason: 'page load failed',
+                    element: document.createElement('div'),
+                    dispose: () => cleanups.forEach(fn => fn?.()),
+                };
+            }
+            cleanups.push(pageComponent.cleanup);
+            // Insert page into layout's outlet
+            if (outlet) {
+                outlet.appendChild(pageComponent.element);
+            }
+            // Return the layout element (which now contains the page)
+            return {
+                success: true,
+                element: layoutInstance.el,
+                dispose: () => cleanups.forEach(fn => fn?.()),
+            };
+        }
+        // No layout - just load the page component
+        const component = await loadComponent(segment, navId, null, router);
+        if (!component) {
+            return {
+                success: false,
+                reason: 'component load failed',
+                element: document.createElement('div'),
+            };
+        }
+        // Check if this is an error placeholder
+        if (component.element instanceof HTMLElement &&
+            component.element.classList.contains('router-error-placeholder')) {
+            return {
+                success: true,
+                element: component.element,
+                dispose: component.cleanup,
+            };
+        }
+        return {
+            success: true,
+            element: component.element,
+            dispose: component.cleanup,
+        };
+    }
+    catch (error) {
+        console.error('[Router] Failed to build segment:', error);
+        return {
+            success: false,
+            reason: 'build failed',
+            element: document.createElement('div'),
+        };
+    }
+}
+/**
+ * Load component with error handling
+ * Handles route errors, dynamic imports, component instantiation, and error UI
+ */
+async function loadComponent(segment, navId, outletElement, router) {
+    const { node } = segment;
+    if (!node.imports.page) {
+        return null;
+    }
+    // Check for route errors first
+    const errors = routeErrors();
+    const routeError = errors.get(node.id);
+    if (routeError) {
+        // Show error UI
+        const errorElement = await buildErrorUI(segment, navId, routeError, createRetryHandler());
+        return {
+            element: errorElement,
+            cleanup: undefined,
+            navId,
+            route: node,
+        };
+    }
+    try {
+        // Dynamic import through shared module cache
+        const componentModule = await loadRouteModule(getRouteModuleKey(node.pattern, 'page'), node.imports.page);
+        // Check if navigation is still active
+        if (!isNavigationActive(navId, router)) {
+            return null;
+        }
+        // Create component instance with error handling
+        const componentCandidate = componentModule.default || componentModule;
+        if (typeof componentCandidate !== 'function') {
+            throw new Error('Component factory did not return valid instance');
+        }
+        const componentFactory = componentCandidate;
+        // Get loader data for this route
+        const loaderDataGetter = router?.loaderData();
+        const loaderState = loaderDataGetter ? loaderDataGetter() : null;
+        const loaderData = loaderState?.data;
+        // Build component props with both params and loader data
+        const componentProps = {
+            ...segment.params,
+            loaderData,
+        };
+        let componentInstance;
+        try {
+            componentInstance = componentFactory(componentProps);
+        }
+        catch (componentError) {
+            console.error('[Router] Component instantiation failed:', componentError);
+            // Set route error for component instantiation failures
+            const { RouterError, RouterErrorCode } = await import('../errors');
+            const { setRouteError } = await import('../errors/router-errors');
+            const err = new RouterError(`Component error: ${componentError instanceof Error ? componentError.message : String(componentError)}`, {
+                navId: String(navId),
+                routeId: node.id,
+                parentRouteId: undefined,
+                routePath: node.pattern,
+                ts: Date.now(),
+            }, componentError, RouterErrorCode.COMPONENT_RENDER_ERROR);
+            setRouteError(node.id, err);
+            // Show error UI instead of throwing
+            const errorElement = await buildErrorUI(segment, navId, err, createRetryHandler());
+            return {
+                element: errorElement,
+                cleanup: undefined,
+                navId,
+                route: node,
+            };
+        }
+        if (!componentInstance || !componentInstance.el) {
+            throw new Error('Component factory did not return valid instance');
+        }
+        return {
+            element: componentInstance.el,
+            cleanup: componentInstance.destroy,
+            navId,
+            route: node,
+        };
+    }
+    catch (error) {
+        console.error('[Router] Failed to load component:', error);
+        // For other types of errors (import errors, validation errors, etc.)
+        // Set route error and show error UI
+        const { RouterError, RouterErrorCode } = await import('../errors');
+        const { setRouteError } = await import('../errors/router-errors');
+        const err = new RouterError(`Component load error: ${error instanceof Error ? error.message : String(error)}`, {
+            navId: String(navId),
+            routeId: node.id,
+            parentRouteId: undefined,
+            routePath: node.pattern,
+            ts: Date.now(),
+        }, error, RouterErrorCode.COMPONENT_LOAD_ERROR);
+        setRouteError(node.id, err);
+        // Show error UI instead of throwing
+        const errorElement = await buildErrorUI(segment, navId, err, createRetryHandler());
+        return {
+            element: errorElement,
+            cleanup: undefined,
+            navId,
+            route: node,
+        };
+    }
+}
+/** @codexApi {"parent":"pithy.router.outlet.mount","name":"commitSegmentsToDOM","stability":"experimental","signature":"(fragment: DocumentFragment, firstChangedIndex: number, segmentChain: RouteSegmentChain[], rootElement: HTMLElement, outletElements: Map<string, HTMLElement>) => CommitResult"} */
+/**
+ * Commit segments to DOM atomically (Phase 2 of two-phase mounting)
+ * Replaces the container's children with the new fragment in one operation
+ */
+export function commitSegmentsToDOM(fragment, firstChangedIndex, segmentChain, rootElement, outletElements) {
+    try {
+        // Find the container to replace (the first changed segment's container)
+        let containerToReplace = rootElement;
+        // If we have previous segments, find the container of the first changed segment
+        if (firstChangedIndex > 0) {
+            const previousSegment = segmentChain[firstChangedIndex - 1];
+            if (previousSegment) {
+                const previousSegmentKey = getSegmentKey(previousSegment);
+                const previousOutlet = outletElements.get(previousSegmentKey);
+                if (previousOutlet) {
+                    containerToReplace = previousOutlet;
+                }
+            }
+        }
+        // Atomic replace: clear and append fragment in one operation
+        containerToReplace.replaceChildren(fragment);
+        return { success: true };
+    }
+    catch (error) {
+        console.error('[Router] Atomic commit failed:', error);
+        return { success: false, reason: 'commit failed' };
+    }
+}
+/**
+ * Check if navigation is still active
+ * This is now integrated with the router's navigation transaction system
+ */
+function isNavigationActive(navId, router) {
+    if (navId === ROUTER_CONFIG.INITIAL_NAV_ID)
+        return true; // [OutletManager] initial mount has no transaction
+    if (router) {
+        return router.isNavActive(navId);
+    }
+    // Fallback: assume navigation is active if no router is set
+    return true;
+}
+/**
+ * Generate unique key for route segment
+ */
+function getSegmentKey(segment) {
+    return `${segment.node.id}-${JSON.stringify(segment.params)}`;
+}
+//# sourceMappingURL=mount.js.map

package/dist/router/features/outlet/mount.js.map

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

package/dist/router/features/outlet/segment-chain.d.ts

@@ -0,0 +1,16 @@
+/** @codex
+{
+  "id": "pithy.router.outlet.segment-chain",
+  "title": "Route Segment Chain Builder",
+  "category": "runtime"
+}
+*/
+import type { RouteNode, RouteSegmentChain, RouteParams } from '../../core/types';
+/** @codexApi {"parent":"pithy.router.outlet.segment-chain","name":"buildSegmentChain","stability":"experimental","signature":"(routes: RouteNode[], matchedPath: string, params: RouteParams, previousChain?: RouteSegmentChain[]) => RouteSegmentChain[]"} */
+/**
+ * Build route segment chain from route match
+ * Supports hierarchical nested routes with layouts
+ * Determines which segments have changed for efficient diff mounting
+ */
+export declare function buildSegmentChain(routes: RouteNode[], matchedPath: string, params: RouteParams, previousChain?: RouteSegmentChain[]): RouteSegmentChain[];
+//# sourceMappingURL=segment-chain.d.ts.map

package/dist/router/features/outlet/segment-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"segment-chain.d.ts","sourceRoot":"","sources":["../../../../src/router/features/outlet/segment-chain.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAEF,OAAO,KAAK,EACV,SAAS,EACT,iBAAiB,EACjB,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAU1B,+PAA+P;AAC/P;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EAAE,EACnB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,EACnB,aAAa,CAAC,EAAE,iBAAiB,EAAE,GAClC,iBAAiB,EAAE,CA6DrB"}

package/dist/router/features/outlet/segment-chain.js

@@ -0,0 +1,62 @@
+/** @codex
+{
+  "id": "pithy.router.outlet.segment-chain",
+  "title": "Route Segment Chain Builder",
+  "category": "runtime"
+}
+*/
+import { flattenRouteTree, buildRouteMap, getAncestorChain, extractAncestorParams, mergeAncestorParams, findMatchingEntry, } from '../../core/route-tree';
+/** @codexApi {"parent":"pithy.router.outlet.segment-chain","name":"buildSegmentChain","stability":"experimental","signature":"(routes: RouteNode[], matchedPath: string, params: RouteParams, previousChain?: RouteSegmentChain[]) => RouteSegmentChain[]"} */
+/**
+ * Build route segment chain from route match
+ * Supports hierarchical nested routes with layouts
+ * Determines which segments have changed for efficient diff mounting
+ */
+export function buildSegmentChain(routes, matchedPath, params, previousChain) {
+    // Flatten the route tree to enable ancestor lookup
+    const flatRoutes = flattenRouteTree(routes);
+    const routeMap = buildRouteMap(flatRoutes);
+    // Find the exact matching route from the flat route list
+    const matchingEntry = findMatchingEntry(matchedPath, flatRoutes);
+    if (!matchingEntry) {
+        return [];
+    }
+    // Get full ancestor chain (includes layouts)
+    const ancestorChain = getAncestorChain(matchingEntry.node.id, routeMap);
+    // Extract params for each ancestor level
+    const paramsByLevel = extractAncestorParams(matchedPath, ancestorChain);
+    // Merge params cumulatively (child params inherit + override parent params)
+    const mergedParams = mergeAncestorParams(paramsByLevel);
+    // Build segment chain from ancestors
+    const segments = [];
+    let previousSegment;
+    for (let i = 0; i < ancestorChain.length; i++) {
+        const routeNode = ancestorChain[i];
+        // Skip if routeNode is undefined (should not happen, but TypeScript safety)
+        if (!routeNode) {
+            continue;
+        }
+        const segmentParams = mergedParams[i] || {};
+        // Check if this segment has changed compared to previous navigation
+        const prevChainSegment = previousChain?.[i];
+        const hasChanged = !prevChainSegment ||
+            prevChainSegment.node.id !== routeNode.id ||
+            JSON.stringify(prevChainSegment.params) !== JSON.stringify(segmentParams);
+        // Create segment chain entry
+        const segment = {
+            node: routeNode,
+            params: segmentParams,
+            hasChanged,
+            parent: previousSegment,
+            children: [],
+        };
+        // Link parent-child relationship
+        if (previousSegment) {
+            previousSegment.children.push(segment);
+        }
+        segments.push(segment);
+        previousSegment = segment;
+    }
+    return segments;
+}
+//# sourceMappingURL=segment-chain.js.map

package/dist/router/features/outlet/segment-chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"segment-chain.js","sourceRoot":"","sources":["../../../../src/router/features/outlet/segment-chain.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAOF,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAE/B,+PAA+P;AAC/P;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAmB,EACnB,WAAmB,EACnB,MAAmB,EACnB,aAAmC;IAEnC,mDAAmD;IACnD,MAAM,UAAU,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IAE3C,yDAAyD;IACzD,MAAM,aAAa,GAAG,iBAAiB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IAEjE,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,6CAA6C;IAC7C,MAAM,aAAa,GAAG,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAExE,yCAAyC;IACzC,MAAM,aAAa,GAAG,qBAAqB,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAExE,4EAA4E;IAC5E,MAAM,YAAY,GAAG,mBAAmB,CAAC,aAAa,CAAC,CAAC;IAExD,qCAAqC;IACrC,MAAM,QAAQ,GAAwB,EAAE,CAAC;IACzC,IAAI,eAA8C,CAAC;IAEnD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,SAAS,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;QAEnC,4EAA4E;QAC5E,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,SAAS;QACX,CAAC;QAED,MAAM,aAAa,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAE5C,oEAAoE;QACpE,MAAM,gBAAgB,GAAG,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5C,MAAM,UAAU,GACd,CAAC,gBAAgB;YACjB,gBAAgB,CAAC,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC,EAAE;YACzC,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QAE5E,6BAA6B;QAC7B,MAAM,OAAO,GAAsB;YACjC,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,aAAa;YACrB,UAAU;YACV,MAAM,EAAE,eAAe;YACvB,QAAQ,EAAE,EAAE;SACb,CAAC;QAEF,iCAAiC;QACjC,IAAI,eAAe,EAAE,CAAC;YACpB,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzC,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,eAAe,GAAG,OAAO,CAAC;IAC5B,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/router/features/prefetch/index.d.ts

@@ -0,0 +1,97 @@
+/** @codex
+{
+  "id": "pithy.router.prefetch",
+  "title": "Enhanced Prefetch System with Intelligent Heuristics",
+  "category": "runtime"
+}
+*/
+/** @codexApi {"parent":"pithy.router.prefetch","name":"PrefetchStrategy","stability":"stable","signature":"type PrefetchStrategy","description":"Strategy options controlling when routes are prefetched"} */
+/**
+ * Prefetch strategy options for intelligent resource loading
+ * Controls when and how routes are prefetched before user navigation
+ */
+export type PrefetchStrategy = 'none' | 'hover' | 'visible' | 'intent';
+/** @codexApi {"parent":"pithy.router.prefetch","name":"PREFETCH_STRATEGIES","stability":"stable","signature":"readonly PrefetchStrategy[]","description":"Runtime list of valid PrefetchStrategy values for enum validation"} */
+export declare const PREFETCH_STRATEGIES: readonly PrefetchStrategy[];
+/** @codexApi {"parent":"pithy.router.prefetch","name":"PrefetchConfig","stability":"stable","signature":"interface PrefetchConfig","description":"Fine-tune prefetch behavior with delays, thresholds, and caching"} */
+/**
+ * Prefetch configuration options
+ * Fine-tune prefetch behavior with delays, thresholds, and caching settings
+ */
+export interface PrefetchConfig {
+    /** Hover intent delay in milliseconds */
+    hoverDelay?: number;
+    /** Intersection observer margin for visible strategy */
+    visibleMargin?: string;
+    /** Cache TTL for prefetched resources */
+    cacheTTL?: number;
+    /** Pointer velocity threshold for intent detection */
+    intentVelocityThreshold?: number;
+    /** Pointer direction consistency required for intent */
+    intentDirectionSamples?: number;
+}
+/** @codexApi {"parent":"pithy.router.prefetch","name":"PrefetchManager","stability":"stable","signature":"class PrefetchManager","description":"Intelligent resource prefetching with enhanced heuristics"} */
+/**
+ * Prefetch manager for intelligent resource prefetching
+ * Implements enhanced prefetch policy & cache layer from architectural improvements
+ */
+export declare class PrefetchManager {
+    private config;
+    private activeRequests;
+    private hoverTimers;
+    private intentTracking;
+    /** Track when each route was last prefetched with its TTL to avoid repeated prefetches */
+    private prefetchedAt;
+    constructor(config?: PrefetchConfig);
+    /** @codexApi {"parent":"pithy.router.prefetch","name":"registerLink","stability":"stable","signature":"(element: HTMLElement, strategy: PrefetchStrategy) => void","description":"Register a link element for prefetching with a given strategy"} */
+    /**
+     * Register a link for prefetching with specified strategy
+     */
+    registerLink(element: HTMLElement, strategy: PrefetchStrategy): void;
+    /** @codexApi {"parent":"pithy.router.prefetch","name":"unregisterLink","stability":"stable","signature":"(element: HTMLElement) => void","description":"Unregister a link and clean up its prefetch listeners"} */
+    /**
+     * Unregister a link from prefetching
+     */
+    unregisterLink(element: HTMLElement): void;
+    /**
+     * Setup hover-based prefetching with intent delay
+     */
+    private setupHoverPrefetch;
+    /**
+     * Setup visibility-based prefetching using shared observer pool from @pithyjs/shared
+     */
+    private setupVisiblePrefetch;
+    /**
+     * Setup intent-based prefetching with pointer tracking
+     */
+    private setupIntentPrefetch;
+    /** @codexApi {"parent":"pithy.router.prefetch","name":"prefetchRoute","stability":"stable","signature":"(href: string, strategy: PrefetchStrategy) => Promise<void>","description":"Prefetch a route with priority handling and deduplication"} */
+    /**
+     * Prefetch a route with priority handling
+     */
+    prefetchRoute(href: string, _strategy: PrefetchStrategy): Promise<void>;
+    /** @codexApi {"parent":"pithy.router.prefetch","name":"cancelPrefetch","stability":"stable","signature":"(href: string) => void","description":"Cancel an in-flight prefetch for a specific route"} */
+    /**
+     * Cancel prefetch for a specific route
+     */
+    cancelPrefetch(href: string): void;
+    /**
+     * Prefetch module code (dynamic imports)
+     */
+    private prefetchModuleCode;
+    /**
+     * Prefetch loader data
+     */
+    private prefetchLoaderData;
+    /** @codexApi {"parent":"pithy.router.prefetch","name":"dispose","stability":"stable","signature":"() => void","description":"Clean up all prefetch resources, requests, and timers"} */
+    /**
+     * Cleanup all prefetch resources
+     */
+    dispose(): void;
+}
+/** @codexApi {"parent":"pithy.router.prefetch","name":"getPrefetchManager","stability":"stable","signature":"() => PrefetchManager","description":"Get the lazy-initialized global prefetch manager"} */
+/**
+ * Get the global prefetch manager
+ */
+export declare function getPrefetchManager(): PrefetchManager;
+//# sourceMappingURL=index.d.ts.map

package/dist/router/features/prefetch/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/router/features/prefetch/index.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAiBF,8MAA8M;AAC9M;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEvE,iOAAiO;AACjO,eAAO,MAAM,mBAAmB,EAAE,SAAS,gBAAgB,EAKjD,CAAC;AAEX,wNAAwN;AACxN;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,wDAAwD;IACxD,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,+MAA+M;AAC/M;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,cAAc,CAAsC;IAC5D,OAAO,CAAC,WAAW,CAAyD;IAC5E,OAAO,CAAC,cAAc,CAA0C;IAChE,0FAA0F;IAC1F,OAAO,CAAC,YAAY,CAAyD;gBAEjE,MAAM,GAAE,cAAmB;IAcvC,qPAAqP;IACrP;;OAEG;IACI,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAmB3E,mNAAmN;IACnN;;OAEG;IACI,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAyBjD;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA+B1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkD3B,mPAAmP;IACnP;;OAEG;IACU,aAAa,CACxB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,gBAAgB,GAC1B,OAAO,CAAC,IAAI,CAAC;IA0DhB,uMAAuM;IACvM;;OAEG;IACI,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQzC;;OAEG;YACW,kBAAkB;IAmBhC;;OAEG;YACW,kBAAkB;IAmBhC,wLAAwL;IACxL;;OAEG;IACI,OAAO,IAAI,IAAI;CAsBvB;AAyED,yMAAyM;AACzM;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAKpD"}