@pithyjs/router 0.1.0-beta.0

package/dist/router/features/errors/global-error-fallback.js

@@ -0,0 +1,182 @@
+/** @codex
+{
+  "id": "pithy.router.error-fallback",
+  "title": "Global Error Fallback Component",
+  "category": "runtime"
+}
+*/
+import { html } from '@pithyjs/core';
+/** @codexApi {"parent":"pithy.router.error-fallback","name":"GlobalErrorFallback","stability":"stable","signature":"(props: ErrorComponentProps) => Component","description":"Default error UI when no route-specific error.ts exists"} */
+/**
+ * Global fallback error component
+ * Shown when no route-specific error.ts exists
+ * Provides basic error display with retry button
+ *
+ * @param props - Error component props
+ * @returns PithyJS component instance
+ */
+export function GlobalErrorFallback({ error, retry }) {
+    const dev = typeof import.meta !== 'undefined' &&
+        import.meta.env?.DEV === true;
+    // Use user-friendly message if error is a RouterError
+    const errorMessage = error?.getUserMessage
+        ? error.getUserMessage()
+        : error?.message || 'Something went wrong';
+    // Check if error is retryable
+    const isRetryable = error?.isRetryable ? error.isRetryable() : true;
+    // Get severity for styling
+    const severity = error?.getSeverity ? error.getSeverity() : 'error';
+    const isCritical = severity === 'critical';
+    const isError = severity === 'error';
+    const isWarning = severity === 'warning';
+    const isInfo = severity === 'info';
+    const errorDetails = JSON.stringify(error?.ctx, null, 2);
+    const errorStack = error?.cause
+        ? String(error.cause.stack || error.cause)
+        : '';
+    function handleRetry() {
+        retry();
+    }
+    return html(`
+    <section
+      class="route-error"
+      [class.severity-critical]="isCritical"
+      [class.severity-error]="isError"
+      [class.severity-warning]="isWarning"
+      [class.severity-info]="isInfo"
+      role="alert"
+      tabindex="-1"
+      aria-live="assertive"
+    >
+      <h3>Could not load this section</h3>
+      <p>{{ errorMessage }}</p>
+
+      <div @if="dev" class="error-details">
+        <details>
+          <summary>Details</summary>
+          <pre>{{ errorDetails }}</pre>
+          <pre @if="errorStack">{{ errorStack }}</pre>
+        </details>
+      </div>
+
+      <button @if="isRetryable" @click="handleRetry()">Retry</button>
+
+      <style>
+        .route-error {
+          padding: 2rem;
+          text-align: center;
+          background: #fff;
+          border: 1px solid #e0e0e0;
+          border-radius: 8px;
+          margin: 2rem auto;
+          max-width: 600px;
+          position: relative;
+        }
+
+        /* Severity-based left border accent */
+        .route-error.severity-critical {
+          border-left: 4px solid #d32f2f;
+        }
+
+        .route-error.severity-error {
+          border-left: 4px solid #f57c00;
+        }
+
+        .route-error.severity-warning {
+          border-left: 4px solid #fbc02d;
+        }
+
+        .route-error.severity-info {
+          border-left: 4px solid #1976d2;
+        }
+
+        .route-error h3 {
+          color: #d32f2f;
+          margin: 0 0 1rem;
+        }
+
+        /* Severity-specific heading colors */
+        .route-error.severity-critical h3 {
+          color: #b71c1c;
+        }
+
+        .route-error.severity-error h3 {
+          color: #d32f2f;
+        }
+
+        .route-error.severity-warning h3 {
+          color: #f57c00;
+        }
+
+        .route-error.severity-info h3 {
+          color: #1976d2;
+        }
+
+        .route-error p {
+          color: #666;
+          margin: 0 0 1.5rem;
+        }
+
+        .error-details {
+          text-align: left;
+          margin: 1rem 0;
+        }
+
+        .route-error details {
+          padding: 1rem;
+          background: #f5f5f5;
+          border-radius: 4px;
+        }
+
+        .route-error summary {
+          cursor: pointer;
+          font-weight: 600;
+          color: #666;
+        }
+
+        .route-error pre {
+          margin: 0.5rem 0 0;
+          padding: 0.5rem;
+          background: #fff;
+          border: 1px solid #ddd;
+          border-radius: 4px;
+          overflow-x: auto;
+          font-size: 0.875rem;
+          white-space: pre-wrap;
+          word-wrap: break-word;
+        }
+
+        .route-error button {
+          background: #1976d2;
+          color: white;
+          border: none;
+          padding: 0.75rem 1.5rem;
+          border-radius: 4px;
+          font-size: 1rem;
+          cursor: pointer;
+          transition: background 0.2s;
+        }
+
+        .route-error button:hover {
+          background: #1565c0;
+        }
+
+        .route-error button:active {
+          background: #0d47a1;
+        }
+      </style>
+    </section>
+  `, {
+        dev,
+        errorMessage,
+        isRetryable,
+        isCritical,
+        isError,
+        isWarning,
+        isInfo,
+        errorDetails,
+        errorStack,
+        handleRetry,
+    });
+}
+//# sourceMappingURL=global-error-fallback.js.map

package/dist/router/features/errors/global-error-fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-error-fallback.js","sourceRoot":"","sources":["../../../../src/router/features/errors/global-error-fallback.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAEF,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAerC,2OAA2O;AAC3O;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAAE,KAAK,EAAE,KAAK,EAAuB;IACvE,MAAM,GAAG,GACP,OAAO,MAAM,CAAC,IAAI,KAAK,WAAW;QACjC,MAAM,CAAC,IAAoC,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;IAEjE,sDAAsD;IACtD,MAAM,YAAY,GAAG,KAAK,EAAE,cAAc;QACxC,CAAC,CAAC,KAAK,CAAC,cAAc,EAAE;QACxB,CAAC,CAAC,KAAK,EAAE,OAAO,IAAI,sBAAsB,CAAC;IAE7C,8BAA8B;IAC9B,MAAM,WAAW,GAAG,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAEpE,2BAA2B;IAC3B,MAAM,QAAQ,GAAG,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IACpE,MAAM,UAAU,GAAG,QAAQ,KAAK,UAAU,CAAC;IAC3C,MAAM,OAAO,GAAG,QAAQ,KAAK,OAAO,CAAC;IACrC,MAAM,SAAS,GAAG,QAAQ,KAAK,SAAS,CAAC;IACzC,MAAM,MAAM,GAAG,QAAQ,KAAK,MAAM,CAAC;IAEnC,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACzD,MAAM,UAAU,GAAG,KAAK,EAAE,KAAK;QAC7B,CAAC,CAAC,MAAM,CAAE,KAAK,CAAC,KAA6B,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC;QACnE,CAAC,CAAC,EAAE,CAAC;IAEP,SAAS,WAAW;QAClB,KAAK,EAAE,CAAC;IACV,CAAC;IAED,OAAO,IAAI,CACT;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiID,EACC;QACE,GAAG;QACH,YAAY;QACZ,WAAW;QACX,UAAU;QACV,OAAO;QACP,SAAS;QACT,MAAM;QACN,YAAY;QACZ,UAAU;QACV,WAAW;KACZ,CACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,15 @@
+/** @codex
+{
+  "id": "pithy.router.errors",
+  "title": "Router Error Handling System",
+  "category": "runtime"
+}
+*/
+export { RouterError, RouterErrorCode } from './error-types';
+export type { ErrorContext } from './error-types';
+export { ErrorSeverity, ErrorRecoveryStrategy, ERROR_TAXONOMY, getErrorMetadata, } from './error-codes';
+export { routeErrors, setRouteError, clearRouteError, clearAllRouteErrors, } from './router-errors';
+export { resolveErrorImport, hasErrorComponent } from './error-resolution';
+export { GlobalErrorFallback } from './global-error-fallback';
+export type { ErrorComponentProps } from './global-error-fallback';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/router/features/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAGF,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC7D,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGlD,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,WAAW,EACX,aAAa,EACb,eAAe,EACf,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,YAAY,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC"}

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

@@ -0,0 +1,18 @@
+/** @codex
+{
+  "id": "pithy.router.errors",
+  "title": "Router Error Handling System",
+  "category": "runtime"
+}
+*/
+// Error types and classes
+export { RouterError, RouterErrorCode } from './error-types';
+// Error codes and taxonomy
+export { ErrorSeverity, ErrorRecoveryStrategy, ERROR_TAXONOMY, getErrorMetadata, } from './error-codes';
+// Error state management
+export { routeErrors, setRouteError, clearRouteError, clearAllRouteErrors, } from './router-errors';
+// Error resolution
+export { resolveErrorImport, hasErrorComponent } from './error-resolution';
+// Global error fallback component
+export { GlobalErrorFallback } from './global-error-fallback';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/router/features/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAEF,0BAA0B;AAC1B,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAG7D,2BAA2B;AAC3B,OAAO,EACL,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,gBAAgB,GACjB,MAAM,eAAe,CAAC;AAEvB,yBAAyB;AACzB,OAAO,EACL,WAAW,EACX,aAAa,EACb,eAAe,EACf,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAEzB,mBAAmB;AACnB,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE3E,kCAAkC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/router/features/errors/router-errors.d.ts

@@ -0,0 +1,44 @@
+/** @codex
+{
+  "id": "pithy.router.error-state",
+  "title": "Router Error State Management",
+  "category": "runtime"
+}
+*/
+import { RouterError } from './error-types';
+/**
+ * Map of route errors keyed by route ID
+ */
+type RouteErrors = Map<string, RouterError>;
+/** @codexApi {"parent":"pithy.router.error-state","name":"routeErrors","stability":"internal","signature":"Signal<Map<string, RouterError>>","description":"Global reactive signal holding all route errors by route ID"} */
+/**
+ * Global signal holding all route errors
+ * Reactive - updates trigger outlet updates
+ * @internal Used internally by the router for error state tracking
+ */
+export declare const routeErrors: import("@pithyjs/signals").Signal<RouteErrors>;
+/** @codexApi {"parent":"pithy.router.error-state","name":"setRouteError","stability":"stable","signature":"(routeId: string, err: RouterError) => void","description":"Set an error for a route, triggering reactive outlet update"} */
+/**
+ * Set an error for a specific route
+ * Triggers reactive update of affected outlets with error UI
+ *
+ * @param routeId - ID of the route that encountered an error
+ * @param err - RouterError instance with context
+ */
+export declare function setRouteError(routeId: string, err: RouterError): void;
+/** @codexApi {"parent":"pithy.router.error-state","name":"clearRouteError","stability":"stable","signature":"(routeId: string) => void","description":"Clear error for a specific route on retry or navigation"} */
+/**
+ * Clear error for a specific route
+ * Called on successful retry or navigation away from error state
+ *
+ * @param routeId - ID of the route to clear error for
+ */
+export declare function clearRouteError(routeId: string): void;
+/** @codexApi {"parent":"pithy.router.error-state","name":"clearAllRouteErrors","stability":"stable","signature":"() => void","description":"Clear all route errors on successful navigation"} */
+/**
+ * Clear all route errors
+ * Called on successful navigation to reset all error states
+ */
+export declare function clearAllRouteErrors(): void;
+export {};
+//# sourceMappingURL=router-errors.d.ts.map

package/dist/router/features/errors/router-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router-errors.d.ts","sourceRoot":"","sources":["../../../../src/router/features/errors/router-errors.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAGF,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;GAEG;AACH,KAAK,WAAW,GAAG,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAE5C,6NAA6N;AAC7N;;;;GAIG;AACH,eAAO,MAAM,WAAW,gDAAiC,CAAC;AAE1D,wOAAwO;AACxO;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAMrE;AAED,oNAAoN;AACpN;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAMrD;AAED,iMAAiM;AACjM;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

package/dist/router/features/errors/router-errors.js

@@ -0,0 +1,53 @@
+/** @codex
+{
+  "id": "pithy.router.error-state",
+  "title": "Router Error State Management",
+  "category": "runtime"
+}
+*/
+import { signal } from '@pithyjs/signals';
+/** @codexApi {"parent":"pithy.router.error-state","name":"routeErrors","stability":"internal","signature":"Signal<Map<string, RouterError>>","description":"Global reactive signal holding all route errors by route ID"} */
+/**
+ * Global signal holding all route errors
+ * Reactive - updates trigger outlet updates
+ * @internal Used internally by the router for error state tracking
+ */
+export const routeErrors = signal(new Map());
+/** @codexApi {"parent":"pithy.router.error-state","name":"setRouteError","stability":"stable","signature":"(routeId: string, err: RouterError) => void","description":"Set an error for a route, triggering reactive outlet update"} */
+/**
+ * Set an error for a specific route
+ * Triggers reactive update of affected outlets with error UI
+ *
+ * @param routeId - ID of the route that encountered an error
+ * @param err - RouterError instance with context
+ */
+export function setRouteError(routeId, err) {
+    routeErrors.set((m) => {
+        const n = new Map(m);
+        n.set(routeId, err);
+        return n;
+    });
+}
+/** @codexApi {"parent":"pithy.router.error-state","name":"clearRouteError","stability":"stable","signature":"(routeId: string) => void","description":"Clear error for a specific route on retry or navigation"} */
+/**
+ * Clear error for a specific route
+ * Called on successful retry or navigation away from error state
+ *
+ * @param routeId - ID of the route to clear error for
+ */
+export function clearRouteError(routeId) {
+    routeErrors.set((m) => {
+        const n = new Map(m);
+        n.delete(routeId);
+        return n;
+    });
+}
+/** @codexApi {"parent":"pithy.router.error-state","name":"clearAllRouteErrors","stability":"stable","signature":"() => void","description":"Clear all route errors on successful navigation"} */
+/**
+ * Clear all route errors
+ * Called on successful navigation to reset all error states
+ */
+export function clearAllRouteErrors() {
+    routeErrors.set(new Map());
+}
+//# sourceMappingURL=router-errors.js.map

package/dist/router/features/errors/router-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router-errors.js","sourceRoot":"","sources":["../../../../src/router/features/errors/router-errors.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAEF,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAQ1C,6NAA6N;AAC7N;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAc,IAAI,GAAG,EAAE,CAAC,CAAC;AAE1D,wOAAwO;AACxO;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,GAAgB;IAC7D,WAAW,CAAC,GAAG,CAAC,CAAC,CAAc,EAAE,EAAE;QACjC,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACpB,OAAO,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;AACL,CAAC;AAED,oNAAoN;AACpN;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,WAAW,CAAC,GAAG,CAAC,CAAC,CAAc,EAAE,EAAE;QACjC,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAClB,OAAO,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;AACL,CAAC;AAED,iMAAiM;AACjM;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,WAAW,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;AAC7B,CAAC"}

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

@@ -0,0 +1,40 @@
+/** @codex
+{
+  "id": "pithy.router.guards.engine",
+  "title": "Pure Guard Execution Engine",
+  "category": "runtime"
+}
+*/
+import type { GuardContext, GuardFunction, SyncGuardResult } from './index';
+/** @codexApi {"parent":"pithy.router.guards.engine","name":"GuardExecution","stability":"stable","signature":"class GuardExecution"} */
+/**
+ * Individual guard execution wrapper with cancellation support
+ * Pure execution logic extracted from GuardManager
+ */
+export declare class GuardExecution {
+    private abortController;
+    private promise;
+    constructor(guard: GuardFunction, context: GuardContext, index: number);
+    /**
+     * Execute a single guard and handle errors
+     */
+    private executeGuard;
+    /**
+     * Abort this guard execution
+     */
+    abort(): void;
+    /**
+     * Get the promise for this guard execution
+     */
+    getPromise(): Promise<{
+        result: SyncGuardResult;
+        error: Error | null;
+    }>;
+}
+/** @codexApi {"parent":"pithy.router.guards.engine","name":"abortRemainingGuards","stability":"stable","signature":"(guardExecutions: GuardExecution[], startIndex: number) => void"} */
+/**
+ * Abort remaining guards after first failure
+ * Pure function for guard cancellation logic
+ */
+export declare function abortRemainingGuards(guardExecutions: GuardExecution[], startIndex: number): void;
+//# sourceMappingURL=engine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../../src/router/features/guards/engine.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAEF,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG5E,wIAAwI;AACxI;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,OAAO,CAA4D;gBAE/D,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM;IAgBtE;;OAEG;YACW,YAAY;IAmB1B;;OAEG;IACI,KAAK,IAAI,IAAI;IAIpB;;OAEG;IACI,UAAU,IAAI,OAAO,CAAC;QAC3B,MAAM,EAAE,eAAe,CAAC;QACxB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;KACrB,CAAC;CAGH;AAED,yLAAyL;AACzL;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,cAAc,EAAE,EACjC,UAAU,EAAE,MAAM,GACjB,IAAI,CAON"}

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

@@ -0,0 +1,67 @@
+/** @codex
+{
+  "id": "pithy.router.guards.engine",
+  "title": "Pure Guard Execution Engine",
+  "category": "runtime"
+}
+*/
+import { combineAbortSignals } from '../../core/utils';
+/** @codexApi {"parent":"pithy.router.guards.engine","name":"GuardExecution","stability":"stable","signature":"class GuardExecution"} */
+/**
+ * Individual guard execution wrapper with cancellation support
+ * Pure execution logic extracted from GuardManager
+ */
+export class GuardExecution {
+    constructor(guard, context, index) {
+        this.abortController = new AbortController();
+        // Chain the parent signal with our own
+        const combinedSignal = combineAbortSignals([
+            context.signal,
+            this.abortController.signal,
+        ]);
+        this.promise = this.executeGuard(guard, { ...context, signal: combinedSignal }, index);
+    }
+    /**
+     * Execute a single guard and handle errors
+     */
+    async executeGuard(guard, context, index) {
+        try {
+            const result = await Promise.resolve(guard(context));
+            return { result, error: null };
+        }
+        catch (error) {
+            return {
+                result: false,
+                error: error instanceof Error
+                    ? error
+                    : new Error(`Guard ${index} failed: ${String(error)}`),
+            };
+        }
+    }
+    /**
+     * Abort this guard execution
+     */
+    abort() {
+        this.abortController.abort();
+    }
+    /**
+     * Get the promise for this guard execution
+     */
+    getPromise() {
+        return this.promise;
+    }
+}
+/** @codexApi {"parent":"pithy.router.guards.engine","name":"abortRemainingGuards","stability":"stable","signature":"(guardExecutions: GuardExecution[], startIndex: number) => void"} */
+/**
+ * Abort remaining guards after first failure
+ * Pure function for guard cancellation logic
+ */
+export function abortRemainingGuards(guardExecutions, startIndex) {
+    for (let i = startIndex; i < guardExecutions.length; i++) {
+        const execution = guardExecutions[i];
+        if (execution) {
+            execution.abort();
+        }
+    }
+}
+//# sourceMappingURL=engine.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../../../src/router/features/guards/engine.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAGF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,wIAAwI;AACxI;;;GAGG;AACH,MAAM,OAAO,cAAc;IAIzB,YAAY,KAAoB,EAAE,OAAqB,EAAE,KAAa;QACpE,IAAI,CAAC,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;QAE7C,uCAAuC;QACvC,MAAM,cAAc,GAAG,mBAAmB,CAAC;YACzC,OAAO,CAAC,MAAM;YACd,IAAI,CAAC,eAAe,CAAC,MAAM;SAC5B,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,YAAY,CAC9B,KAAK,EACL,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,EACtC,KAAK,CACN,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,YAAY,CACxB,KAAoB,EACpB,OAAqB,EACrB,KAAa;QAEb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YACrD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,MAAM,EAAE,KAAK;gBACb,KAAK,EACH,KAAK,YAAY,KAAK;oBACpB,CAAC,CAAC,KAAK;oBACP,CAAC,CAAC,IAAI,KAAK,CAAC,SAAS,KAAK,YAAY,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;aAC3D,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACI,KAAK;QACV,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;IAED;;OAEG;IACI,UAAU;QAIf,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF;AAED,yLAAyL;AACzL;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,eAAiC,EACjC,UAAkB;IAElB,KAAK,IAAI,CAAC,GAAG,UAAU,EAAE,CAAC,GAAG,eAAe,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzD,MAAM,SAAS,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;QACrC,IAAI,SAAS,EAAE,CAAC;YACd,SAAS,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,52 @@
+/** @codex
+{
+  "id": "pithy.router.guards",
+  "title": "Route Guards and Redirects with Zero-Flash Navigation",
+  "category": "runtime"
+}
+*/
+import type { NavigationId, GuardContext, SyncGuardResult, GuardResult, GuardFunction, GuardExecutionResult } from '../../core/types';
+export type { GuardContext, SyncGuardResult, GuardResult, GuardFunction, GuardExecutionResult, };
+/** @codexApi {"parent":"pithy.router.guards","name":"RedirectConfig","stability":"stable","signature":"interface RedirectConfig","description":"Redirect configuration for guard results with optional history replacement"} */
+/**
+ * Redirect configuration for guard results
+ * Allows guards to redirect navigation with optional history replacement
+ */
+export interface RedirectConfig {
+    /** Target path to redirect to */
+    redirect: string;
+    /** Whether to replace current history entry */
+    replace?: boolean;
+}
+/** @codexApi {"parent":"pithy.router.guards","name":"GuardManager","stability":"stable","signature":"class GuardManager","description":"Manages route guards with zero-flash navigation and cancellation"} */
+/**
+ * Guard manager for handling route guards with zero-flash navigation
+ * Implements guards/redirects pre-commit from architectural improvements
+ */
+export declare class GuardManager {
+    private activeGuardSets;
+    /** @codexApi {"parent":"pithy.router.guards","name":"executeGuards","stability":"stable","signature":"(guards: GuardFunction[], context: GuardContext) => Promise<GuardExecutionResult>","description":"Execute guards in parallel with proper cancellation support"} */
+    /**
+     * Execute guards for a navigation with parallel evaluation and proper cancellation
+     */
+    executeGuards(guards: GuardFunction[], context: GuardContext): Promise<GuardExecutionResult>;
+    /** @codexApi {"parent":"pithy.router.guards","name":"cancelGuards","stability":"stable","signature":"(navId: NavigationId) => void","description":"Cancel all active guards for a navigation"} */
+    /**
+     * Cancel all guards for a navigation
+     */
+    cancelGuards(navId: NavigationId): void;
+}
+/** @codexApi {"parent":"pithy.router.guards","name":"AuthProvider","stability":"stable","signature":"interface AuthProvider","description":"Authentication provider interface for user state and permissions"} */
+/**
+ * Authentication provider interface - implement this in your app
+ * Provides user authentication state and permissions for guard evaluation
+ */
+export interface AuthProvider {
+    /** Check if user is currently authenticated */
+    isAuthenticated(): Promise<boolean> | boolean;
+    /** Get current user's role */
+    getUserRole(): Promise<string | null> | string | null;
+    /** Get current user's permissions */
+    getUserPermissions(): Promise<string[]> | string[];
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/router/features/guards/index.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAEF,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,WAAW,EACX,aAAa,EACb,oBAAoB,EACrB,MAAM,kBAAkB,CAAC;AAI1B,YAAY,EACV,YAAY,EACZ,eAAe,EACf,WAAW,EACX,aAAa,EACb,oBAAoB,GACrB,CAAC;AAEF,gOAAgO;AAChO;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,8MAA8M;AAC9M;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,eAAe,CAA6C;IAEpE,yQAAyQ;IACzQ;;OAEG;IACU,aAAa,CACxB,MAAM,EAAE,aAAa,EAAE,EACvB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,oBAAoB,CAAC;IA8EhC,kMAAkM;IAClM;;OAEG;IACI,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;CAO/C;AAED,kNAAkN;AAClN;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IAC9C,8BAA8B;IAC9B,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;IACtD,qCAAqC;IACrC,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC;CACpD"}

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

@@ -0,0 +1,95 @@
+/** @codex
+{
+  "id": "pithy.router.guards",
+  "title": "Route Guards and Redirects with Zero-Flash Navigation",
+  "category": "runtime"
+}
+*/
+import { GuardExecution, abortRemainingGuards } from './engine';
+/** @codexApi {"parent":"pithy.router.guards","name":"GuardManager","stability":"stable","signature":"class GuardManager","description":"Manages route guards with zero-flash navigation and cancellation"} */
+/**
+ * Guard manager for handling route guards with zero-flash navigation
+ * Implements guards/redirects pre-commit from architectural improvements
+ */
+export class GuardManager {
+    constructor() {
+        this.activeGuardSets = new Map();
+    }
+    /** @codexApi {"parent":"pithy.router.guards","name":"executeGuards","stability":"stable","signature":"(guards: GuardFunction[], context: GuardContext) => Promise<GuardExecutionResult>","description":"Execute guards in parallel with proper cancellation support"} */
+    /**
+     * Execute guards for a navigation with parallel evaluation and proper cancellation
+     */
+    async executeGuards(guards, context) {
+        if (guards.length === 0) {
+            return { allowed: true };
+        }
+        const { navId } = context;
+        // Cancel any existing guards for this navigation
+        this.cancelGuards(navId);
+        // Create guard executions with individual cancellation support
+        const guardExecutions = guards.map((guard, index) => new GuardExecution(guard, context, index));
+        this.activeGuardSets.set(navId, guardExecutions);
+        try {
+            // Execute all guards in parallel
+            const guardPromises = guardExecutions.map(execution => execution.getPromise());
+            const results = await Promise.all(guardPromises);
+            // Process results in order - first failure wins
+            for (let i = 0; i < results.length; i++) {
+                const guardResult = results[i];
+                if (!guardResult)
+                    continue;
+                const { result, error } = guardResult;
+                if (error) {
+                    // Abort remaining guards and return error
+                    abortRemainingGuards(guardExecutions, i + 1);
+                    return { allowed: false, error };
+                }
+                // Check if navigation was aborted
+                if (context.signal.aborted) {
+                    return { allowed: false };
+                }
+                // Process guard result
+                if (result === false) {
+                    // Guard denied navigation - abort remaining guards
+                    abortRemainingGuards(guardExecutions, i + 1);
+                    return { allowed: false };
+                }
+                if (typeof result === 'string') {
+                    // Guard returned redirect path - abort remaining guards
+                    abortRemainingGuards(guardExecutions, i + 1);
+                    return {
+                        allowed: false,
+                        redirect: { redirect: result, replace: false },
+                    };
+                }
+                if (typeof result === 'object' && result.redirect) {
+                    // Guard returned redirect config - abort remaining guards
+                    abortRemainingGuards(guardExecutions, i + 1);
+                    return {
+                        allowed: false,
+                        redirect: result,
+                    };
+                }
+                // Guard allowed (result === true), continue to next guard
+            }
+            // All guards allowed navigation
+            return { allowed: true };
+        }
+        finally {
+            // Clean up active guards
+            this.activeGuardSets.delete(navId);
+        }
+    }
+    /** @codexApi {"parent":"pithy.router.guards","name":"cancelGuards","stability":"stable","signature":"(navId: NavigationId) => void","description":"Cancel all active guards for a navigation"} */
+    /**
+     * Cancel all guards for a navigation
+     */
+    cancelGuards(navId) {
+        const guardExecutions = this.activeGuardSets.get(navId);
+        if (guardExecutions) {
+            guardExecutions.forEach(execution => execution.abort());
+            this.activeGuardSets.delete(navId);
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/router/features/guards/index.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAUF,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAuBhE,8MAA8M;AAC9M;;;GAGG;AACH,MAAM,OAAO,YAAY;IAAzB;QACU,oBAAe,GAAG,IAAI,GAAG,EAAkC,CAAC;IAkGtE,CAAC;IAhGC,yQAAyQ;IACzQ;;OAEG;IACI,KAAK,CAAC,aAAa,CACxB,MAAuB,EACvB,OAAqB;QAErB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3B,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;QAE1B,iDAAiD;QACjD,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAEzB,+DAA+D;QAC/D,MAAM,eAAe,GAAG,MAAM,CAAC,GAAG,CAChC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAC5D,CAAC;QAEF,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;QAEjD,IAAI,CAAC;YACH,iCAAiC;YACjC,MAAM,aAAa,GAAG,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CACpD,SAAS,CAAC,UAAU,EAAE,CACvB,CAAC;YACF,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YAEjD,gDAAgD;YAChD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACxC,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;gBAC/B,IAAI,CAAC,WAAW;oBAAE,SAAS;gBAE3B,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,WAAW,CAAC;gBAEtC,IAAI,KAAK,EAAE,CAAC;oBACV,0CAA0C;oBAC1C,oBAAoB,CAAC,eAAe,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;oBAC7C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;gBACnC,CAAC;gBAED,kCAAkC;gBAClC,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBAC3B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;gBAC5B,CAAC;gBAED,uBAAuB;gBACvB,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;oBACrB,mDAAmD;oBACnD,oBAAoB,CAAC,eAAe,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;oBAC7C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;gBAC5B,CAAC;gBAED,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;oBAC/B,wDAAwD;oBACxD,oBAAoB,CAAC,eAAe,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;oBAC7C,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE;qBAC/C,CAAC;gBACJ,CAAC;gBAED,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;oBAClD,0DAA0D;oBAC1D,oBAAoB,CAAC,eAAe,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;oBAC7C,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,QAAQ,EAAE,MAAM;qBACjB,CAAC;gBACJ,CAAC;gBAED,0DAA0D;YAC5D,CAAC;YAED,gCAAgC;YAChC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3B,CAAC;gBAAS,CAAC;YACT,yBAAyB;YACzB,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,kMAAkM;IAClM;;OAEG;IACI,YAAY,CAAC,KAAmB;QACrC,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACxD,IAAI,eAAe,EAAE,CAAC;YACpB,eAAe,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC;YACxD,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;CACF"}