@pithyjs/router 0.1.0-beta.0

package/dist/router/features/loaders/cache.d.ts

@@ -0,0 +1,60 @@
+/** @codex
+{
+  "id": "pithy.router.loader.cache",
+  "title": "Resource Cache with TTL and Caching Policies",
+  "category": "runtime"
+}
+*/
+import type { NavigationId } from '../../core/types';
+import type { CacheOptions } from './index';
+/**
+ * Cache key for resource cache
+ */
+export interface CacheKey {
+    /** Route ID */
+    routeId: string;
+    /** Serialized params */
+    params: string;
+    /** Serialized query (for cache key) */
+    queryKey: string;
+}
+/** @codexApi {"parent":"pithy.router.loader.cache","name":"ResourceCache","stability":"stable","signature":"class ResourceCache"} */
+/**
+ * Resource cache with TTL and size limits
+ * Implements enhanced prefetch policy & cache layer from architectural improvements
+ */
+export declare class ResourceCache {
+    private cache;
+    private maxSize;
+    private defaultTTL;
+    /**
+     * Create a new resource cache
+     * @param maxSize - Maximum number of entries (default: 100)
+     * @param defaultTTL - Default time-to-live in milliseconds (default: 300000 = 5 minutes)
+     */
+    constructor(maxSize?: number, defaultTTL?: number);
+    /**
+     * Generate cache key from route and parameters
+     */
+    private generateKey;
+    /**
+     * Check if cache entry is still valid
+     */
+    private isValid;
+    /** @codexApi {"parent":"pithy.router.loader.cache","name":"get","stability":"stable","signature":"<T>(key: CacheKey) => T | null"} */
+    /**
+     * Get cached data if valid
+     */
+    get<T>(key: CacheKey): T | null;
+    /** @codexApi {"parent":"pithy.router.loader.cache","name":"set","stability":"stable","signature":"<T>(key: CacheKey, data: T, navId: NavigationId, options?: CacheOptions) => void"} */
+    /**
+     * Set cached data with TTL
+     */
+    set<T>(key: CacheKey, data: T, navId: NavigationId, options?: CacheOptions): void;
+    /** @codexApi {"parent":"pithy.router.loader.cache","name":"clear","stability":"stable","signature":"() => void"} */
+    /**
+     * Clear all cached data
+     */
+    clear(): void;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/router/features/loaders/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../../src/router/features/loaders/cache.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAEF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAgB5C;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,eAAe;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qIAAqI;AACrI;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;IAE3B;;;;OAIG;gBACS,OAAO,SAAM,EAAE,UAAU,SAAS;IAK9C;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,OAAO,CAAC,OAAO;IAIf,sIAAsI;IACtI;;OAEG;IACI,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,GAAG,CAAC,GAAG,IAAI;IActC,wLAAwL;IACxL;;OAEG;IACI,GAAG,CAAC,CAAC,EACV,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,YAAY,EACnB,OAAO,GAAE,YAAiB,GACzB,IAAI;IAoBP,oHAAoH;IACpH;;OAEG;IACI,KAAK,IAAI,IAAI;CAGrB"}

package/dist/router/features/loaders/cache.js

@@ -0,0 +1,80 @@
+/** @codex
+{
+  "id": "pithy.router.loader.cache",
+  "title": "Resource Cache with TTL and Caching Policies",
+  "category": "runtime"
+}
+*/
+/** @codexApi {"parent":"pithy.router.loader.cache","name":"ResourceCache","stability":"stable","signature":"class ResourceCache"} */
+/**
+ * Resource cache with TTL and size limits
+ * Implements enhanced prefetch policy & cache layer from architectural improvements
+ */
+export class ResourceCache {
+    /**
+     * Create a new resource cache
+     * @param maxSize - Maximum number of entries (default: 100)
+     * @param defaultTTL - Default time-to-live in milliseconds (default: 300000 = 5 minutes)
+     */
+    constructor(maxSize = 100, defaultTTL = 300000) {
+        this.cache = new Map();
+        this.maxSize = maxSize;
+        this.defaultTTL = defaultTTL;
+    }
+    /**
+     * Generate cache key from route and parameters
+     */
+    generateKey(key) {
+        return `${key.routeId}:${key.params}:${key.queryKey}`;
+    }
+    /**
+     * Check if cache entry is still valid
+     */
+    isValid(entry) {
+        return Date.now() - entry.cachedAt < entry.ttl;
+    }
+    /** @codexApi {"parent":"pithy.router.loader.cache","name":"get","stability":"stable","signature":"<T>(key: CacheKey) => T | null"} */
+    /**
+     * Get cached data if valid
+     */
+    get(key) {
+        const cacheKey = this.generateKey(key);
+        const entry = this.cache.get(cacheKey);
+        if (!entry || !this.isValid(entry)) {
+            if (entry) {
+                this.cache.delete(cacheKey);
+            }
+            return null;
+        }
+        return entry.data;
+    }
+    /** @codexApi {"parent":"pithy.router.loader.cache","name":"set","stability":"stable","signature":"<T>(key: CacheKey, data: T, navId: NavigationId, options?: CacheOptions) => void"} */
+    /**
+     * Set cached data with TTL
+     */
+    set(key, data, navId, options = {}) {
+        const cacheKey = this.generateKey(key);
+        const ttl = options.ttl || this.defaultTTL;
+        // Enforce size limit by removing oldest entries
+        if (this.cache.size >= this.maxSize) {
+            const oldestKey = this.cache.keys().next().value;
+            if (oldestKey) {
+                this.cache.delete(oldestKey);
+            }
+        }
+        this.cache.set(cacheKey, {
+            data,
+            cachedAt: Date.now(),
+            ttl,
+            navId,
+        });
+    }
+    /** @codexApi {"parent":"pithy.router.loader.cache","name":"clear","stability":"stable","signature":"() => void"} */
+    /**
+     * Clear all cached data
+     */
+    clear() {
+        this.cache.clear();
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/router/features/loaders/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../../src/router/features/loaders/cache.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AA+BF,qIAAqI;AACrI;;;GAGG;AACH,MAAM,OAAO,aAAa;IAKxB;;;;OAIG;IACH,YAAY,OAAO,GAAG,GAAG,EAAE,UAAU,GAAG,MAAM;QATtC,UAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;QAU5C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,GAAa;QAC/B,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;IACxD,CAAC;IAED;;OAEG;IACK,OAAO,CAAC,KAAiB;QAC/B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC;IACjD,CAAC;IAED,sIAAsI;IACtI;;OAEG;IACI,GAAG,CAAI,GAAa;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAEvC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACnC,IAAI,KAAK,EAAE,CAAC;gBACV,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC9B,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC,IAAS,CAAC;IACzB,CAAC;IAED,wLAAwL;IACxL;;OAEG;IACI,GAAG,CACR,GAAa,EACb,IAAO,EACP,KAAmB,EACnB,UAAwB,EAAE;QAE1B,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,UAAU,CAAC;QAE3C,gDAAgD;QAChD,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACpC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YACjD,IAAI,SAAS,EAAE,CAAC;gBACd,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE;YACvB,IAAI;YACJ,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE;YACpB,GAAG;YACH,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED,oHAAoH;IACpH;;OAEG;IACI,KAAK;QACV,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF"}

package/dist/router/features/loaders/engine.d.ts

@@ -0,0 +1,17 @@
+/** @codex
+{
+  "id": "pithy.router.loader.engine",
+  "title": "Pure Loader Execution Engine Utilities",
+  "category": "runtime"
+}
+*/
+import type { QueryParams } from '../../core/types';
+import { combineAbortSignals } from '../../core/utils';
+/** @codexApi {"parent":"pithy.router.loader.engine","name":"generateQueryKey","stability":"stable","signature":"(query: QueryParams) => string"} */
+/**
+ * Generate query key for caching (stable sort for consistent keys)
+ * Pure function extracted from LoaderManager
+ */
+export declare function generateQueryKey(query: QueryParams): string;
+export { combineAbortSignals };
+//# sourceMappingURL=engine.d.ts.map

package/dist/router/features/loaders/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../../src/router/features/loaders/engine.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAEF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,oJAAoJ;AACpJ;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAU3D;AAGD,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/router/features/loaders/engine.js

@@ -0,0 +1,27 @@
+/** @codex
+{
+  "id": "pithy.router.loader.engine",
+  "title": "Pure Loader Execution Engine Utilities",
+  "category": "runtime"
+}
+*/
+import { combineAbortSignals } from '../../core/utils';
+/** @codexApi {"parent":"pithy.router.loader.engine","name":"generateQueryKey","stability":"stable","signature":"(query: QueryParams) => string"} */
+/**
+ * Generate query key for caching (stable sort for consistent keys)
+ * Pure function extracted from LoaderManager
+ */
+export function generateQueryKey(query) {
+    const keys = Object.keys(query).sort();
+    const pairs = keys.map(key => {
+        const value = query[key];
+        if (Array.isArray(value)) {
+            return `${key}=${value.sort().join(',')}`;
+        }
+        return `${key}=${value}`;
+    });
+    return pairs.join('&');
+}
+// Re-export combineAbortSignals for backward compatibility
+export { combineAbortSignals };
+//# sourceMappingURL=engine.js.map

package/dist/router/features/loaders/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../../src/router/features/loaders/engine.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAGF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,oJAAoJ;AACpJ;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAkB;IACjD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;QAC3B,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,GAAG,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5C,CAAC;QACD,OAAO,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,2DAA2D;AAC3D,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

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

@@ -0,0 +1,49 @@
+/** @codex
+{
+  "id": "pithy.router.loader",
+  "title": "Route Loader System with ResourceCache",
+  "category": "runtime"
+}
+*/
+import type { LoaderContext, LoaderFunction, ResourceState, CacheStrategy, RouteCacheOptions } from '../../core/types';
+import { ResourceCache } from './cache';
+export type { LoaderContext, LoaderFunction, ResourceState, CacheStrategy, RouteCacheOptions, };
+/** @codexApi {"parent":"pithy.router.loader","name":"CacheOptions","stability":"stable","signature":"interface CacheOptions","description":"Cache configuration with TTL and strategy for route loaders"} */
+/**
+ * Cache configuration options for route loaders
+ * Controls caching behavior with TTL and strategy settings
+ */
+export interface CacheOptions {
+    /** Time-to-live in milliseconds */
+    ttl?: number;
+    /** Cache strategy */
+    strategy?: CacheStrategy;
+}
+export { ResourceCache, type CacheKey } from './cache';
+/** @codexApi {"parent":"pithy.router.loader","name":"LoaderManager","stability":"stable","signature":"class LoaderManager","description":"Manages route loaders with caching and cancellation support"} */
+/**
+ * Loader manager for handling route loaders with caching and cancellation
+ */
+export declare class LoaderManager {
+    private activeLoaders;
+    /** @codexApi {"parent":"pithy.router.loader","name":"executeLoader","stability":"stable","signature":"<T>(routeId: string, loader: LoaderFunction<T>, context: LoaderContext, options?: CacheOptions) => Promise<T>","description":"Execute a loader with caching and cancellation support"} */
+    /**
+     * Execute a loader with caching and cancellation support
+     */
+    executeLoader<T>(routeId: string, loader: LoaderFunction<T>, context: LoaderContext, options?: CacheOptions): Promise<T>;
+    /**
+     * Revalidate cached data in background for stale-while-revalidate
+     */
+    private revalidateInBackground;
+}
+/** @codexApi {"parent":"pithy.router.loader","name":"executeRouteLoader","stability":"stable","signature":"<T>(routeId: string, loader: LoaderFunction<T>, context: LoaderContext, options?: CacheOptions) => Promise<T>","description":"Execute a route loader with caching and cancellation via global manager"} */
+/**
+ * Execute a route loader with caching and cancellation
+ */
+export declare function executeRouteLoader<T>(routeId: string, loader: LoaderFunction<T>, context: LoaderContext, options?: CacheOptions): Promise<T>;
+/** @codexApi {"parent":"pithy.router.loader","name":"getResourceCache","stability":"stable","signature":"() => ResourceCache","description":"Get the global resource cache instance"} */
+/**
+ * Get the global resource cache
+ */
+export declare function getResourceCache(): ResourceCache;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/router/features/loaders/index.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAEF,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,aAAa,EACb,aAAa,EACb,iBAAiB,EAClB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAiB,MAAM,SAAS,CAAC;AAGvD,YAAY,EACV,aAAa,EACb,cAAc,EACd,aAAa,EACb,aAAa,EACb,iBAAiB,GAClB,CAAC;AAEF,6MAA6M;AAC7M;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,mCAAmC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B;AAGD,OAAO,EAAE,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AAOvD,2MAA2M;AAC3M;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,aAAa,CAAsC;IAE3D,gSAAgS;IAChS;;OAEG;IACU,aAAa,CAAC,CAAC,EAC1B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,EACzB,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,CAAC,CAAC;IAiEb;;OAEG;YACW,sBAAsB;CAiBrC;AAOD,sTAAsT;AACtT;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,EACzB,OAAO,EAAE,aAAa,EACtB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,CAAC,CAAC,CAEZ;AAED,yLAAyL;AACzL;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD"}

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

@@ -0,0 +1,112 @@
+/** @codex
+{
+  "id": "pithy.router.loader",
+  "title": "Route Loader System with ResourceCache",
+  "category": "runtime"
+}
+*/
+import { generateQueryKey, combineAbortSignals } from './engine';
+import { ResourceCache } from './cache';
+// Re-export ResourceCache and CacheKey from cache module
+export { ResourceCache } from './cache';
+/**
+ * Global resource cache instance
+ */
+const globalResourceCache = new ResourceCache();
+/** @codexApi {"parent":"pithy.router.loader","name":"LoaderManager","stability":"stable","signature":"class LoaderManager","description":"Manages route loaders with caching and cancellation support"} */
+/**
+ * Loader manager for handling route loaders with caching and cancellation
+ */
+export class LoaderManager {
+    constructor() {
+        this.activeLoaders = new Map();
+    }
+    /** @codexApi {"parent":"pithy.router.loader","name":"executeLoader","stability":"stable","signature":"<T>(routeId: string, loader: LoaderFunction<T>, context: LoaderContext, options?: CacheOptions) => Promise<T>","description":"Execute a loader with caching and cancellation support"} */
+    /**
+     * Execute a loader with caching and cancellation support
+     */
+    async executeLoader(routeId, loader, context, options = {}) {
+        const { params, query, signal, navId } = context;
+        // Generate cache key
+        const cacheKey = {
+            routeId,
+            params: JSON.stringify(params),
+            queryKey: generateQueryKey(query),
+        };
+        // Check cache first (unless no-store)
+        if (options.strategy !== 'no-store') {
+            const cached = globalResourceCache.get(cacheKey);
+            if (cached !== null) {
+                // For stale-while-revalidate, return cached data but revalidate in background
+                if (options.strategy === 'swr') {
+                    this.revalidateInBackground(routeId, loader, context, cacheKey, options);
+                }
+                return cached;
+            }
+        }
+        // Cancel any existing loader for this route
+        const existingController = this.activeLoaders.get(routeId);
+        if (existingController) {
+            existingController.abort();
+        }
+        // Create new abort controller for this loader
+        const loaderController = new AbortController();
+        this.activeLoaders.set(routeId, loaderController);
+        // Chain abort signals
+        const combinedSignal = combineAbortSignals([
+            signal,
+            loaderController.signal,
+        ]);
+        try {
+            // Execute loader with combined abort signal
+            const loaderContext = {
+                ...context,
+                signal: combinedSignal,
+            };
+            const result = await Promise.resolve(loader(loaderContext));
+            // Cache result if successful and not aborted
+            if (!combinedSignal.aborted && options.strategy !== 'no-store') {
+                globalResourceCache.set(cacheKey, result, navId, options);
+            }
+            return result;
+        }
+        finally {
+            // Clean up active loader
+            this.activeLoaders.delete(routeId);
+        }
+    }
+    /**
+     * Revalidate cached data in background for stale-while-revalidate
+     */
+    async revalidateInBackground(routeId, loader, context, cacheKey, options) {
+        try {
+            const result = await Promise.resolve(loader(context));
+            if (!context.signal.aborted) {
+                globalResourceCache.set(cacheKey, result, context.navId, options);
+            }
+        }
+        catch (error) {
+            // Silently fail background revalidation
+            console.warn('Background revalidation failed:', error);
+        }
+    }
+}
+/**
+ * Global loader manager instance
+ */
+const globalLoaderManager = new LoaderManager();
+/** @codexApi {"parent":"pithy.router.loader","name":"executeRouteLoader","stability":"stable","signature":"<T>(routeId: string, loader: LoaderFunction<T>, context: LoaderContext, options?: CacheOptions) => Promise<T>","description":"Execute a route loader with caching and cancellation via global manager"} */
+/**
+ * Execute a route loader with caching and cancellation
+ */
+export async function executeRouteLoader(routeId, loader, context, options) {
+    return globalLoaderManager.executeLoader(routeId, loader, context, options);
+}
+/** @codexApi {"parent":"pithy.router.loader","name":"getResourceCache","stability":"stable","signature":"() => ResourceCache","description":"Get the global resource cache instance"} */
+/**
+ * Get the global resource cache
+ */
+export function getResourceCache() {
+    return globalResourceCache;
+}
+//# sourceMappingURL=index.js.map

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

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

package/dist/router/features/loading-ui-manager.d.ts

@@ -0,0 +1,69 @@
+/** @codex
+{
+  "id": "pithy.router.features.loading-ui",
+  "title": "Loading UI Manager - Atomic Swap and Overlay Loading States",
+  "category": "runtime"
+}
+*/
+import type { NavigationId, RouteNode } from '../core/types';
+/**
+ * Loading UI Manager
+ * Handles atomic swap, overlay, and progress-only loading policies
+ *
+ * Supports two loading strategies:
+ * 1. Atomic Swap - Replace entire outlet content with loading UI
+ * 2. Overlay - Show loading UI on top of existing content
+ *
+ * @codexApi {"parent":"pithy.router.features.loading-ui","name":"LoadingUIManager","stability":"stable","signature":"class LoadingUIManager"}
+ */
+export declare class LoadingUIManager {
+    private outletSnapshot;
+    private mountedElement;
+    /**
+     * Set the mounted element (outlet)
+     */
+    setMountedElement(element: HTMLElement | null): void;
+    /**
+     * Show atomic loading UI (replace outlet content)
+     * Creates a container with router-loading-atomic class that replaces all outlet content
+     *
+     * @codexApi {"parent":"pithy.router.features.loading-ui","name":"showAtomic","stability":"stable","signature":"async showAtomic(pattern: string, navId: NavigationId, outlet: HTMLElement, routes: RouteNode[]): Promise<void>"}
+     */
+    showAtomic(pattern: string, navId: NavigationId, outlet: HTMLElement, routes: RouteNode[]): Promise<void>;
+    /**
+     * Show custom overlay loading UI with route-specific content
+     *
+     * @codexApi {"parent":"pithy.router.features.loading-ui","name":"showCustomOverlay","stability":"stable","signature":"async showCustomOverlay(pattern: string, navId: NavigationId, outlet: HTMLElement, routes: RouteNode[]): Promise<void>"}
+     */
+    showCustomOverlay(pattern: string, navId: NavigationId, outlet: HTMLElement, routes: RouteNode[]): Promise<void>;
+    /**
+     * Internal helper to mount an overlay with content
+     * Consolidates overlay creation logic
+     */
+    private mountOverlay;
+    /**
+     * Remove loading overlay from outlet
+     *
+     * @codexApi {"parent":"pithy.router.features.loading-ui","name":"removeOverlay","stability":"stable","signature":"removeOverlay(outlet: HTMLElement): void"}
+     */
+    removeOverlay(outlet: HTMLElement): void;
+    /**
+     * Clear all loading UI from outlet (handles both overlays and atomic swap loading)
+     *
+     * @codexApi {"parent":"pithy.router.features.loading-ui","name":"clearAll","stability":"stable","signature":"clearAll(): void"}
+     */
+    clearAll(): void;
+    /**
+     * Build default loading content (spinner + "Loading..." text)
+     *
+     * @codexApi {"parent":"pithy.router.features.loading-ui","name":"buildDefault","stability":"stable","signature":"buildDefault(): HTMLElement"}
+     */
+    buildDefault(): HTMLElement;
+    /**
+     * Build loading content for a specific route (supports many export shapes)
+     *
+     * @codexApi {"parent":"pithy.router.features.loading-ui","name":"buildForRoute","stability":"stable","signature":"async buildForRoute(pattern: string, routes: RouteNode[]): Promise<HTMLElement>"}
+     */
+    buildForRoute(pattern: string, routes: RouteNode[]): Promise<HTMLElement>;
+}
+//# sourceMappingURL=loading-ui-manager.d.ts.map

package/dist/router/features/loading-ui-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loading-ui-manager.d.ts","sourceRoot":"","sources":["../../../src/router/features/loading-ui-manager.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAEF,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAY,MAAM,eAAe,CAAC;AAKvE;;;;;;;;;GASG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,cAAc,CAA4B;IAElD;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI;IAIpD;;;;;OAKG;IACG,UAAU,CACd,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,SAAS,EAAE,GAClB,OAAO,CAAC,IAAI,CAAC;IAiBhB;;;;OAIG;IACG,iBAAiB,CACrB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,SAAS,EAAE,GAClB,OAAO,CAAC,IAAI,CAAC;IAMhB;;;OAGG;IACH,OAAO,CAAC,YAAY;IA2CpB;;;;OAIG;IACH,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAOxC;;;;OAIG;IACH,QAAQ,IAAI,IAAI;IAoBhB;;;;OAIG;IACH,YAAY,IAAI,WAAW;IA+B3B;;;;OAIG;IACG,aAAa,CACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,SAAS,EAAE,GAClB,OAAO,CAAC,WAAW,CAAC;CA4CxB"}