@rangojs/router 0.0.0-experimental.2 → 0.0.0-experimental.21

package/dist/bin/rango.js.map

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

package/dist/browser/event-controller.d.ts

@@ -0,0 +1,191 @@
+import type { ReactNode } from "react";
+import type { NavigationLocation, NavigateOptions, TrackedActionState, InflightAction, RscMetadata, HandleData } from "./types.js";
+/**
+ * Phase of a navigation operation
+ */
+export type NavigationPhase = "fetching" | "streaming";
+/**
+ * Phase of an action operation
+ */
+export type ActionPhase = "fetching" | "streaming" | "settling";
+/**
+ * Entry tracking an in-flight navigation
+ */
+export interface NavigationEntry {
+    url: string;
+    abort: AbortController;
+    phase: NavigationPhase;
+    startedAt: number;
+    options?: NavigateOptions & {
+        skipLoadingState?: boolean;
+    };
+}
+/**
+ * Entry tracking an in-flight action
+ */
+export interface ActionEntry {
+    /** Unique instance ID for this action invocation */
+    id: string;
+    /** Server action function ID (normalized name like "addToCart") */
+    actionId: string;
+    /** Abort controller for this action */
+    abort: AbortController;
+    /** Current phase of the action */
+    phase: ActionPhase;
+    /** Action arguments */
+    payload: unknown[];
+    /** Result from action (set on completion) */
+    result?: unknown;
+    /** Error from action (set on failure) */
+    error?: unknown;
+    /** Segment IDs that were revalidated by this action */
+    revalidatedSegments: string[];
+    /** Timestamp when action started */
+    startedAt: number;
+    /** Whether action processing is complete (may still be streaming) */
+    completed?: boolean;
+}
+/**
+ * Derived navigation state (computed from source of truth)
+ */
+export interface DerivedNavigationState {
+    /** Navigation lifecycle state */
+    state: "idle" | "loading";
+    /** Whether any operation is streaming */
+    isStreaming: boolean;
+    /** Current committed location */
+    location: NavigationLocation;
+    /** URL being navigated to (null if idle) */
+    pendingUrl: string | null;
+    /** List of inflight actions (for compatibility) */
+    inflightActions: InflightAction[];
+}
+/**
+ * Callback for UI updates when root should re-render
+ */
+export type UpdateCallback = (update: {
+    root: ReactNode | Promise<ReactNode>;
+    metadata: RscMetadata;
+}) => void;
+/**
+ * State change listener
+ */
+export type StateListener = () => void;
+/**
+ * Action state listener
+ */
+export type ActionStateListener = (state: TrackedActionState) => void;
+/**
+ * Handle state listener
+ */
+export type HandleListener = () => void;
+/**
+ * Internal handle state stored in controller
+ */
+export interface HandleState {
+    data: HandleData;
+    segmentOrder: string[];
+}
+/**
+ * Token for tracking an active stream
+ * Call end() when the stream completes
+ */
+export interface StreamingToken {
+    /** End this streaming operation */
+    end(): void;
+}
+/**
+ * Result from starting a navigation
+ * Implements Disposable for use with `using` keyword
+ */
+export interface NavigationHandle extends Disposable {
+    /** Abort controller for this navigation */
+    abort: AbortController;
+    /** Signal for this navigation */
+    signal: AbortSignal;
+    /** Start streaming and get a token to end it later */
+    startStreaming(): StreamingToken;
+    /** Complete the navigation successfully */
+    complete(location: NavigationLocation): void;
+    /** Whether navigation was completed successfully */
+    readonly completed: boolean;
+}
+/**
+ * Result from starting an action
+ * Implements Disposable for use with `using` keyword
+ */
+export interface ActionHandle extends Disposable {
+    /** Unique instance ID */
+    id: string;
+    /** Abort controller for this action */
+    abort: AbortController;
+    /** Signal for this action */
+    signal: AbortSignal;
+    /** Start streaming and get a token to end it later */
+    startStreaming(): StreamingToken;
+    /** Record segments that were revalidated */
+    recordRevalidatedSegments(segmentIds: string[]): void;
+    /** Complete the action with result */
+    complete(result?: unknown): void;
+    /** Fail the action with error */
+    fail(error: unknown): void;
+    /** Whether action was completed (success or failure) */
+    readonly settled: boolean;
+    /** Check if any concurrent actions were started */
+    hadConcurrentActions: boolean;
+    /** Get segments to consolidate (only valid when this is the last action) */
+    getConsolidationSegments(): string[] | null;
+    /** Clear consolidation tracking */
+    clearConsolidation(): void;
+}
+/**
+ * Event controller interface
+ */
+export interface EventController {
+    startNavigation(url: string, options?: NavigateOptions & {
+        skipLoadingState?: boolean;
+    }): NavigationHandle;
+    abortNavigation(): void;
+    startAction(actionId: string, args: unknown[]): ActionHandle;
+    abortAllActions(): void;
+    getState(): DerivedNavigationState;
+    getActionState(actionId: string): TrackedActionState;
+    setLocation(location: NavigationLocation): void;
+    subscribe(listener: StateListener): () => void;
+    subscribeToAction(actionId: string, listener: ActionStateListener): () => void;
+    subscribeToHandles(listener: HandleListener): () => void;
+    setHandleData(data: HandleData, matched?: string[], isPartial?: boolean): void;
+    getHandleState(): HandleState;
+    getCurrentNavigation(): NavigationEntry | null;
+    getInflightActions(): Map<string, ActionEntry>;
+}
+/**
+ * Configuration for creating an event controller
+ */
+export interface EventControllerConfig {
+    initialLocation?: NavigationLocation;
+}
+/**
+ * Create an event controller for managing navigation and action state
+ *
+ * The controller uses a reactive model where:
+ * - Source of truth: currentNavigation, inflightActions, location
+ * - Derived state: navState, isStreaming computed from source
+ *
+ * Navigation uses switchMap semantics (new nav cancels previous).
+ * Actions use mergeMap semantics (all run concurrently, consolidate at end).
+ */
+export declare function createEventController(config?: EventControllerConfig): EventController;
+/**
+ * Initialize the global event controller
+ */
+export declare function initEventController(config?: EventControllerConfig): EventController;
+/**
+ * Get the global event controller
+ */
+export declare function getEventController(): EventController;
+/**
+ * Reset the controller instance (for testing)
+ */
+export declare function resetEventController(): void;
+//# sourceMappingURL=event-controller.d.ts.map

package/dist/browser/event-controller.d.ts.map

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