@equinor/fusion-framework-module-navigation 6.0.1 → 7.0.0-next.2

package/dist/esm/lib/state/history.actions.js

@@ -0,0 +1,71 @@
+import { createAction, createAsyncAction } from '@equinor/fusion-observable/actions';
+import { v7 as generateId } from 'uuid';
+/**
+ * Action for navigating to a new location (push or replace).
+ */
+const navigateAction = createAsyncAction('navigation/navigate', (to, options) => ({
+    payload: { to, options },
+    meta: { key: generateId() },
+}), (update) => ({
+    payload: { update },
+}), (error) => ({
+    payload: { error },
+}));
+const abortNavigateAction = createAction('navigation/navigate::abort', (reason) => ({
+    payload: { reason },
+}));
+/**
+ * Action for navigating backward or forward in history.
+ */
+const goDeltaAction = createAsyncAction('navigation/go', (delta) => ({
+    payload: { delta },
+}), (update) => ({
+    payload: { update },
+}), (error) => ({
+    payload: { error },
+}));
+/**
+ * Action for handling browser back/forward navigation (popstate events).
+ */
+const popStateAction = createAsyncAction('navigation/pop', (update) => ({
+    payload: { update },
+}), (update) => ({
+    payload: { update },
+}), (error) => ({
+    payload: { error },
+}));
+/**
+ * Action for validating the current location against history state.
+ */
+const validateLocationAction = createAsyncAction('navigation/navigationValidation', () => ({
+    payload: {},
+}), (update) => ({
+    payload: { update },
+}), (error) => ({
+    payload: { error },
+}));
+/**
+ * Action for adding a navigation blocker.
+ */
+const addBlockerAction = createAction('navigation/addBlocker', (blocker) => ({
+    payload: { blocker },
+}));
+/**
+ * Action for removing a navigation blocker.
+ */
+const removeBlockerAction = createAction('navigation/removeBlocker', (blocker) => ({
+    payload: { blocker },
+}));
+/**
+ * Navigation actions for history state management.
+ */
+export const actions = {
+    navigate: navigateAction,
+    abortNavigate: abortNavigateAction,
+    go: goDeltaAction,
+    pop: popStateAction,
+    validateLocation: validateLocationAction,
+    addBlocker: addBlockerAction,
+    removeBlocker: removeBlockerAction,
+};
+//# sourceMappingURL=history.actions.js.map

package/dist/esm/lib/state/history.actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.actions.js","sourceRoot":"","sources":["../../../../src/lib/state/history.actions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAErF,OAAO,EAAE,EAAE,IAAI,UAAU,EAAE,MAAM,MAAM,CAAC;AAGxC;;GAEG;AACH,MAAM,cAAc,GAAG,iBAAiB,CACtC,qBAAqB,EACrB,CAAC,EAAM,EAAE,OAAwB,EAAE,EAAE,CAAC,CAAC;IACrC,OAAO,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE;IACxB,IAAI,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE;CAC5B,CAAC,EACF,CAAC,MAAwB,EAAE,EAAE,CAAC,CAAC;IAC7B,OAAO,EAAE,EAAE,MAAM,EAAE;CACpB,CAAC,EACF,CAAC,KAAY,EAAE,EAAE,CAAC,CAAC;IACjB,OAAO,EAAE,EAAE,KAAK,EAAE;CACnB,CAAC,CACH,CAAC;AAEF,MAAM,mBAAmB,GAAG,YAAY,CAAC,4BAA4B,EAAE,CAAC,MAAe,EAAE,EAAE,CAAC,CAAC;IAC3F,OAAO,EAAE,EAAE,MAAM,EAAE;CACpB,CAAC,CAAC,CAAC;AAEJ;;GAEG;AACH,MAAM,aAAa,GAAG,iBAAiB,CACrC,eAAe,EACf,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC;IAClB,OAAO,EAAE,EAAE,KAAK,EAAE;CACnB,CAAC,EACF,CAAC,MAAwB,EAAE,EAAE,CAAC,CAAC;IAC7B,OAAO,EAAE,EAAE,MAAM,EAAE;CACpB,CAAC,EACF,CAAC,KAAY,EAAE,EAAE,CAAC,CAAC;IACjB,OAAO,EAAE,EAAE,KAAK,EAAE;CACnB,CAAC,CACH,CAAC;AAEF;;GAEG;AACH,MAAM,cAAc,GAAG,iBAAiB,CACtC,gBAAgB,EAChB,CAAC,MAAyB,EAAE,EAAE,CAAC,CAAC;IAC9B,OAAO,EAAE,EAAE,MAAM,EAAE;CACpB,CAAC,EACF,CAAC,MAAwB,EAAE,EAAE,CAAC,CAAC;IAC7B,OAAO,EAAE,EAAE,MAAM,EAAE;CACpB,CAAC,EACF,CAAC,KAAY,EAAE,EAAE,CAAC,CAAC;IACjB,OAAO,EAAE,EAAE,KAAK,EAAE;CACnB,CAAC,CACH,CAAC;AAEF;;GAEG;AACH,MAAM,sBAAsB,GAAG,iBAAiB,CAC9C,iCAAiC,EACjC,GAAG,EAAE,CAAC,CAAC;IACL,OAAO,EAAE,EAAE;CACZ,CAAC,EACF,CAAC,MAAwB,EAAE,EAAE,CAAC,CAAC;IAC7B,OAAO,EAAE,EAAE,MAAM,EAAE;CACpB,CAAC,EACF,CAAC,KAAY,EAAE,EAAE,CAAC,CAAC;IACjB,OAAO,EAAE,EAAE,KAAK,EAAE;CACnB,CAAC,CACH,CAAC;AAEF;;GAEG;AACH,MAAM,gBAAgB,GAAG,YAAY,CAAC,uBAAuB,EAAE,CAAC,OAA0B,EAAE,EAAE,CAAC,CAAC;IAC9F,OAAO,EAAE,EAAE,OAAO,EAAE;CACrB,CAAC,CAAC,CAAC;AAEJ;;GAEG;AACH,MAAM,mBAAmB,GAAG,YAAY,CACtC,0BAA0B,EAC1B,CAAC,OAA0B,EAAE,EAAE,CAAC,CAAC;IAC/B,OAAO,EAAE,EAAE,OAAO,EAAE;CACrB,CAAC,CACH,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,QAAQ,EAAE,cAAc;IACxB,aAAa,EAAE,mBAAmB;IAClC,EAAE,EAAE,aAAa;IACjB,GAAG,EAAE,cAAc;IACnB,gBAAgB,EAAE,sBAAsB;IACxC,UAAU,EAAE,gBAAgB;IAC5B,aAAa,EAAE,mBAAmB;CACnC,CAAC"}

package/dist/esm/lib/state/history.flows.js

@@ -0,0 +1,212 @@
+import { Observable, of, merge } from 'rxjs';
+import { concatMap, map, withLatestFrom } from 'rxjs/operators';
+import { filterAction } from '@equinor/fusion-observable/operators';
+import { actions } from './history.actions';
+import { resolvePath } from '../utils';
+import { Action } from '../types';
+const compareLocation = (a, b) => {
+    return (a.hash === b.hash &&
+        a.search === b.search &&
+        a.pathname === b.pathname &&
+        JSON.stringify(a.state) === JSON.stringify(b.state));
+};
+/**
+ * Flow creator for handling navigate actions.
+ *
+ * Execution flow:
+ * 1. Filters for navigate actions
+ * 2. Resolves the target path from the action payload
+ * 3. Creates a location object with the resolved path, key (from action meta), and optional state
+ * 4. Checks if the new location is the same as current to prevent navigation loops
+ * 5. Updates the stack based on replace option (replace updates current, otherwise pushes new entry)
+ * 6. Returns success action with the new location and appropriate action type (PUSH/REPLACE)
+ */
+export const navigate = (stack) => (action$) => {
+    const { navigate } = actions;
+    return action$.pipe(filterAction(navigate.type), map((action) => {
+        const { payload, meta } = action;
+        const path = resolvePath(payload.to);
+        const key = meta.key;
+        const { replace, state } = payload.options;
+        const nextLocation = { ...path, key, state };
+        // prevent death loop navigation
+        if (compareLocation(nextLocation, stack.current)) {
+            return actions.abortNavigate('Location is the same as the current location');
+        }
+        if (replace) {
+            stack.replace(nextLocation);
+        }
+        else {
+            stack.push(nextLocation);
+        }
+        return navigate.success({
+            delta: 0,
+            action: replace ? Action.Replace : Action.Push,
+            location: nextLocation,
+        });
+    }));
+};
+/**
+ * Flow creator for handling go (back/forward) actions.
+ *
+ * Execution flow:
+ * 1. Filters for go actions
+ * 2. Combines with current state to get history entries
+ * 3. Moves the stack index by the specified delta (negative for back, positive for forward)
+ * 4. Returns success action with POP action type and the new current location
+ */
+export const go = (stack) => (action$, state$) => {
+    const { go } = actions;
+    return action$.pipe(filterAction(go.type), withLatestFrom(state$), map(([action, state]) => {
+        const { delta } = action.payload;
+        stack.go(delta, state);
+        return go.success({
+            delta: 0,
+            action: Action.Pop,
+            location: stack.current,
+        });
+    }));
+};
+/**
+ * Flow creator for handling pop (browser back/forward) actions.
+ *
+ * Execution flow:
+ * 1. Filters for pop actions
+ * 2. Uses the location from the action payload or falls back to stack.current
+ * 3. Emits a success action with POP action type and the current location
+ * 4. Completes the observable immediately (synchronous operation)
+ */
+export const pop = (stack) => (action$) => {
+    const { pop } = actions;
+    return action$.pipe(filterAction(pop.type), concatMap((action) => new Observable((subscriber) => {
+        const currentLocation = action.payload.update?.location ?? stack.current;
+        // todo - we might need to check if the current location is in the history stack
+        // for now we will just use the current location
+        subscriber.next(pop.success({
+            delta: 0,
+            action: Action.Pop,
+            location: currentLocation,
+        }));
+        subscriber.complete();
+    })));
+};
+/**
+ * Flow creator for checking navigation blockers before processing actions.
+ *
+ * Execution flow:
+ * 1. Filters for navigation actions (navigate, go, pop, validateLocation)
+ * 2. Determines the action type (PUSH/REPLACE for navigate, POP for others)
+ * 3. Combines with current state to check for active blockers
+ * 4. If no blockers exist, passes the action through immediately
+ * 5. If blockers exist:
+ *    - Creates a transition object with action, location, and retry callback
+ *    - Calls each blocker asynchronously (wrapped in Promise to prevent blocking)
+ *    - Blockers can call retry() to allow navigation or prevent it by not calling retry()
+ *    - Waits for all blockers to complete before continuing
+ * 6. Returns the original action if navigation is allowed, or completes without emitting if blocked
+ */
+export const checkBlockers = (stack) => (action$, state$) => {
+    const { pop, navigate, go, validateLocation } = actions;
+    return action$.pipe(filterAction(navigate.type, pop.type, go.type, validateLocation.type), map((action) => {
+        switch (action.type) {
+            case navigate.type:
+                return {
+                    replace: action.payload.options.replace,
+                    action: action,
+                };
+            case go.type:
+            case pop.type:
+            case validateLocation.type:
+                return {
+                    type: 'POP',
+                    action: action,
+                };
+        }
+    }), withLatestFrom(state$), concatMap(([{ action, replace }, state]) => {
+        if (!state.blockers.length) {
+            return of(action);
+        }
+        return new Observable((subscriber) => {
+            const location = stack.current;
+            const blockers = state.blockers.map((blocker) => Promise.resolve(blocker({
+                delta: 0,
+                action: replace ? Action.Replace : Action.Push,
+                location,
+                retry: () => {
+                    subscriber.next(action);
+                },
+            })));
+            Promise.allSettled(blockers).then(() => {
+                subscriber.complete();
+            });
+        });
+    }));
+};
+/**
+ * Flow creator for validating the current location against history state.
+ *
+ * Execution flow:
+ * 1. Filters for validateLocation actions
+ * 2. Combines with current state to access history entries
+ * 3. Gets the current location from the stack
+ * 4. Searches history for an entry matching the current location's key
+ * 5. Validates that:
+ *    - The location key exists in history (returns failure if not found)
+ *    - The location state matches the history entry state (returns failure if mismatch)
+ * 6. Returns success action with current location if validation passes, failure otherwise
+ */
+export const validateCurrentLocation = (stack) => (action$, state$) => {
+    const { validateLocation } = actions;
+    return action$.pipe(filterAction(validateLocation.type), withLatestFrom(state$), map(([, state]) => {
+        const currentLocation = stack.current;
+        const record = state.history.find(({ location }) => location?.key === currentLocation?.key);
+        if (!record) {
+            return validateLocation.failure(new Error('Stack state not found'));
+        }
+        if (record?.location?.state !== currentLocation?.state) {
+            return validateLocation.failure(new Error('Stack state mismatch'));
+        }
+        return validateLocation.success({
+            delta: 0,
+            action: Action.Pop,
+            location: currentLocation,
+        });
+    }));
+};
+/**
+ * Creates a combined history flow from multiple flow creators.
+ *
+ * Execution flow:
+ * 1. Creates a preprocessing step that applies blocker checking (unless skipped)
+ * 2. Initializes each flow creator with the stack to create individual flows
+ * 3. Merges all flows so they process actions in parallel
+ * 4. Returns a combined flow that:
+ *    - First applies preprocessing (blocker checking)
+ *    - Then processes actions through all merged flows
+ *    - Emits results from any flow that matches the action
+ *
+ * @param flowCreators - Array of flow creators to combine
+ * @param options - Optional configuration options
+ * @param options.skipBlockCheck - If true, skip blocker checking
+ * @returns A combined history flow creator
+ */
+export const createFlow = (flowCreators, options) => {
+    return (stack) => {
+        const preProcessActions = options?.skipBlockCheck
+            ? (action$) => action$
+            : checkBlockers(stack);
+        const flows = (action$, state$) => {
+            return merge(...flowCreators
+                .map((initializer) => initializer(stack))
+                .map((flow) => flow(action$, state$)));
+        };
+        return (action$, state$) => {
+            return preProcessActions(action$, state$).pipe((source$) => flows(source$, state$));
+        };
+    };
+};
+/**
+ * Collection of flow creators for history state management.
+ */
+export const flowCreators = { navigate, go, pop, validateCurrentLocation };
+//# sourceMappingURL=history.flows.js.map

package/dist/esm/lib/state/history.flows.js.map

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

package/dist/esm/lib/state/history.reducer.js

@@ -0,0 +1,59 @@
+import { createReducer } from '@equinor/fusion-observable';
+import { actions } from './history.actions';
+import { isSuccessAction } from '@equinor/fusion-observable/actions';
+/**
+ * Finds the index of the current location in the history array.
+ * Used to determine where to insert/replace entries for REPLACE actions.
+ */
+const findIndex = (state) => {
+    return state.history.findIndex((update) => update.location.key === state.current.location.key);
+};
+/**
+ * Creates a reducer for history state management.
+ *
+ * @param initial - Initial navigation update or function that returns initial state
+ * @param options - Optional configuration options
+ * @param options.maxHistory - Maximum number of history entries to keep (default: 100)
+ * @returns A reducer for history state
+ */
+export const createHistoryReducer = (initial, options) => {
+    const maxHistory = options?.maxHistory ?? 100;
+    const initialState = initial instanceof Function
+        ? initial()
+        : {
+            current: initial,
+            history: [initial],
+            blockers: [],
+        };
+    return createReducer(initialState, (builder) => {
+        // Handle navigate.success actions to update history array
+        builder.addCase(actions.navigate.success, (state, action) => {
+            const { update } = action.payload;
+            // For REPLACE actions, remove all entries after the current location (the tail)
+            // This ensures REPLACE doesn't add to history length when at the end,
+            // and removes any forward history when not at the end
+            if (update.action === 'REPLACE') {
+                const currentIndex = findIndex(state);
+                if (currentIndex !== -1) {
+                    // Remove all entries from current position onwards
+                    state.history.splice(currentIndex, state.history.length - currentIndex);
+                }
+            }
+            state.history.push(update);
+        });
+        // Update current location for all successful actions (navigate, go, pop, etc.)
+        builder.addMatcher(isSuccessAction, (state, action) => {
+            const { update } = action.payload;
+            state.current = update;
+        });
+        // Limit history size to prevent unbounded growth
+        // This matcher always runs (returns true) to check history length after every action
+        builder.addMatcher(() => true, (state) => {
+            if (state.history.length > maxHistory) {
+                // Keep only the most recent entries, removing oldest ones
+                state.history = state.history.slice(-maxHistory);
+            }
+        });
+    });
+};
+//# sourceMappingURL=history.reducer.js.map

package/dist/esm/lib/state/history.reducer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.reducer.js","sourceRoot":"","sources":["../../../../src/lib/state/history.reducer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,OAAO,EAAgB,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAErE;;;GAGG;AACH,MAAM,SAAS,GAAG,CAAC,KAAoB,EAAE,EAAE;IACzC,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,KAAK,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AACjG,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,OAAiD,EACjD,OAAiC,EACjC,EAAE;IACF,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,GAAG,CAAC;IAE9C,MAAM,YAAY,GAChB,OAAO,YAAY,QAAQ;QACzB,CAAC,CAAC,OAAO,EAAE;QACX,CAAC,CAAE;YACC,OAAO,EAAE,OAAO;YAChB,OAAO,EAAE,CAAC,OAAO,CAAC;YAClB,QAAQ,EAAE,EAAE;SACY,CAAC;IAEjC,OAAO,aAAa,CAAyB,YAAY,EAAE,CAAC,OAAO,EAAE,EAAE;QACrE,0DAA0D;QAC1D,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;YAC1D,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC;YAClC,gFAAgF;YAChF,sEAAsE;YACtE,sDAAsD;YACtD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAChC,MAAM,YAAY,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;gBACtC,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;oBACxB,mDAAmD;oBACnD,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,YAAY,CAAC,CAAC;gBAC1E,CAAC;YACH,CAAC;YACD,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;QACH,+EAA+E;QAC/E,OAAO,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;YACpD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC;YAClC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;QACzB,CAAC,CAAC,CAAC;QACH,iDAAiD;QACjD,qFAAqF;QACrF,OAAO,CAAC,UAAU,CAChB,GAAG,EAAE,CAAC,IAAI,EACV,CAAC,KAAK,EAAE,EAAE;YACR,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;gBACtC,0DAA0D;gBAC1D,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC;YACnD,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/esm/lib/state/history.state.js

@@ -0,0 +1,37 @@
+import { createState, } from '@equinor/fusion-observable';
+import { actions } from './history.actions';
+import { flowCreators, createFlow } from './history.flows';
+/**
+ * Default flows for history state management.
+ */
+export const defaultFlows = [flowCreators.navigate, flowCreators.go, flowCreators.pop];
+/**
+ * Creates a history store with the specified stack and reducer.
+ *
+ * @param stack - The history stack implementation
+ * @param reducer - The reducer for history state
+ * @param options - Optional configuration options
+ * @returns A HistoryState instance
+ */
+export const createStore = (stack, reducer, options) => {
+    // Create base state with actions and reducer, then add stack property
+    // The stack is stored alongside the flow state for use in flows
+    const state = Object.assign(createState(actions, reducer), { stack });
+    // Build set of flows to use (default flows or custom flows)
+    // Use Set to ensure no duplicates if validateCurrentLocation is added
+    const flows = new Set(options?.flows ?? defaultFlows);
+    // Optionally add validation flow to check location consistency
+    if (options?.validateCurrentLocation) {
+        flows.add(flowCreators.validateCurrentLocation);
+    }
+    // Create combined flow from all flow creators
+    // This merges all flows so they process actions in parallel
+    const flow = createFlow([...flows], {
+        skipBlockCheck: options?.skipBlockCheck,
+    });
+    // Initialize the flow with the stack and add it to the state subject
+    // The flow processes actions and updates state through the reducer
+    state.subject.addFlow(flow(stack));
+    return state;
+};
+//# sourceMappingURL=history.state.js.map

package/dist/esm/lib/state/history.state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.state.js","sourceRoot":"","sources":["../../../../src/lib/state/history.state.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,GAGZ,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,OAAO,EAAgB,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,UAAU,EAA2B,MAAM,iBAAiB,CAAC;AAUpF;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,YAAY,CAAC,QAAQ,EAAE,YAAY,CAAC,EAAE,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC;AAEvF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,KAAmB,EACnB,OAAwD,EACxD,OAIC,EACa,EAAE;IAChB,sEAAsE;IACtE,gEAAgE;IAChE,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,CAAiB,CAAC;IAEtF,4DAA4D;IAC5D,sEAAsE;IACtE,MAAM,KAAK,GAAG,IAAI,GAAG,CAAqB,OAAO,EAAE,KAAK,IAAI,YAAY,CAAC,CAAC;IAC1E,+DAA+D;IAC/D,IAAI,OAAO,EAAE,uBAAuB,EAAE,CAAC;QACrC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,uBAAuB,CAAC,CAAC;IAClD,CAAC;IAED,8CAA8C;IAC9C,4DAA4D;IAC5D,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,GAAG,KAAK,CAAC,EAAE;QAClC,cAAc,EAAE,OAAO,EAAE,cAAc;KACxC,CAAC,CAAC;IAEH,qEAAqE;IACrE,mEAAmE;IACnE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAEnC,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/dist/esm/lib/state/index.js

@@ -0,0 +1,4 @@
+export { createStore } from './history.state';
+export { createHistoryReducer } from './history.reducer';
+export { actions } from './history.actions';
+//# sourceMappingURL=index.js.map

package/dist/esm/lib/state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAqB,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAgB,MAAM,mBAAmB,CAAC"}

package/dist/esm/lib/types.js

@@ -0,0 +1,25 @@
+/**
+ * Actions represent the type of change to a location value.
+ */
+export var Action;
+(function (Action) {
+    /**
+     * A POP indicates a change to an arbitrary index in the history stack, such
+     * as a back or forward navigation. It does not describe the direction of the
+     * navigation, only that the current index changed.
+     *
+     * Note: This is the default action for newly created history objects.
+     */
+    Action["Pop"] = "POP";
+    /**
+     * A PUSH indicates a new entry being added to the history stack, such as when
+     * a link is clicked and a new page loads.
+     */
+    Action["Push"] = "PUSH";
+    /**
+     * A REPLACE indicates the entry at the current index in the history stack
+     * being replaced by a new one.
+     */
+    Action["Replace"] = "REPLACE";
+})(Action || (Action = {}));
+//# sourceMappingURL=types.js.map

package/dist/esm/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/types.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,CAAN,IAAY,MAmBX;AAnBD,WAAY,MAAM;IAChB;;;;;;OAMG;IACH,qBAAW,CAAA;IACX;;;OAGG;IACH,uBAAa,CAAA;IACb;;;OAGG;IACH,6BAAmB,CAAA;AACrB,CAAC,EAnBW,MAAM,KAAN,MAAM,QAmBjB"}

package/dist/esm/lib/utils/encode-trailing-whitespace.js

@@ -0,0 +1,19 @@
+/**
+ * Encodes trailing whitespace in a string by replacing it with '%20'.
+ *
+ * @param input - The string to encode
+ * @returns The string with trailing whitespace encoded
+ *
+ * @example
+ * ```ts
+ * encodeTrailingWhitespace('hello ')
+ * // 'hello%20'
+ *
+ * encodeTrailingWhitespace('hello')
+ * // 'hello'
+ * ```
+ */
+export const encodeTrailingWhitespace = (input) => {
+    return input.replace(/ $/, '%20');
+};
+//# sourceMappingURL=encode-trailing-whitespace.js.map

package/dist/esm/lib/utils/encode-trailing-whitespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode-trailing-whitespace.js","sourceRoot":"","sources":["../../../../src/lib/utils/encode-trailing-whitespace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,KAAa,EAAU,EAAE;IAChE,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACpC,CAAC,CAAC"}

package/dist/esm/lib/utils/has-protocol.js

@@ -0,0 +1,22 @@
+/**
+ * Checks if a string has a protocol prefix.
+ *
+ * @param input - The string to check
+ * @returns True if the string starts with a protocol (e.g., 'http:', 'https:', 'file:')
+ *
+ * @example
+ * ```ts
+ * hasProtocol('https://example.com')
+ * // true
+ *
+ * hasProtocol('/users')
+ * // false
+ *
+ * hasProtocol('file:///path/to/file')
+ * // true
+ * ```
+ */
+export const hasProtocol = (input) => {
+    return /^[a-zA-Z][a-zA-Z\d+\-.]*:/.test(input);
+};
+//# sourceMappingURL=has-protocol.js.map

package/dist/esm/lib/utils/has-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"has-protocol.js","sourceRoot":"","sources":["../../../../src/lib/utils/has-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAa,EAAW,EAAE;IACpD,OAAO,2BAA2B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACjD,CAAC,CAAC"}

package/dist/esm/lib/utils/index.js

@@ -0,0 +1,6 @@
+export { pathToString } from './path-to-string';
+export { pathToUrl } from './path-to-url';
+export { resolvePath } from './resolve-path';
+export { resolveWindowLocation } from './resolve-browser-location';
+export { resolveHashLocation } from './resolve-browser-location';
+//# sourceMappingURL=index.js.map

package/dist/esm/lib/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/esm/lib/utils/path-to-string.js

@@ -0,0 +1,23 @@
+import { encodeTrailingWhitespace } from './encode-trailing-whitespace';
+/**
+ * Converts a Partial<Path> object to a path string.
+ *
+ * @param to - The path object with optional pathname, search, and hash
+ * @returns A path string with properly formatted search and hash
+ *
+ * @example
+ * ```ts
+ * pathToString({ pathname: '/users', search: '?id=1', hash: '#section' })
+ * // '/users?id=1#section'
+ *
+ * pathToString({ pathname: '/users', search: 'id=1', hash: 'section' })
+ * // '/users?id=1#section'
+ * ```
+ */
+export const pathToString = (to) => {
+    const pathname = encodeTrailingWhitespace(to.pathname ?? '/');
+    const search = encodeTrailingWhitespace(to.search?.replace(/^\?/, '') ?? '');
+    const hash = encodeTrailingWhitespace(to.hash?.replace(/^#/, '') ?? '');
+    return `${pathname}${search ? `?${search}` : ''}${hash ? `#${hash}` : ''}`;
+};
+//# sourceMappingURL=path-to-string.js.map

package/dist/esm/lib/utils/path-to-string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-to-string.js","sourceRoot":"","sources":["../../../../src/lib/utils/path-to-string.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAExE;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,EAAiB,EAAU,EAAE;IACxD,MAAM,QAAQ,GAAG,wBAAwB,CAAC,EAAE,CAAC,QAAQ,IAAI,GAAG,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,wBAAwB,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAG,wBAAwB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;IACxE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAC7E,CAAC,CAAC"}

package/dist/esm/lib/utils/path-to-url.js

@@ -0,0 +1,47 @@
+import { encodeTrailingWhitespace } from './encode-trailing-whitespace';
+import { hasProtocol } from './has-protocol';
+import { pathToString } from './path-to-string';
+/**
+ * Converts a path to a URL object.
+ *
+ * This utility handles various path formats and converts them to standard URL objects.
+ * It supports absolute URLs, relative paths, and path objects with pathname/search/hash.
+ *
+ * @param path - The target path (string, Path object, or Location object)
+ * @param origin - Optional origin URL. Defaults to `window.location.origin` in browser environments,
+ *                 or 'http://localhost' in Node.js environments
+ * @returns A URL object for the given path
+ *
+ * @example
+ * ```ts
+ * // Absolute URL with custom origin
+ * pathToUrl('/users?id=1', 'https://example.com')
+ * // URL { href: 'https://example.com/users?id=1', ... }
+ *
+ * // Complete URL with protocol
+ * pathToUrl('https://example.com/users')
+ * // URL { href: 'https://example.com/users', ... }
+ *
+ * // Path object
+ * pathToUrl({ pathname: '/users', search: '?id=1' })
+ * // URL { href: 'http://localhost/users?id=1', ... }
+ *
+ * // Browser environment (uses window.location.origin)
+ * pathToUrl('/dashboard')
+ * // URL { href: 'https://current-site.com/dashboard', ... }
+ * ```
+ */
+export const pathToUrl = (path, origin) => {
+    // Convert path to string representation
+    const pathString = typeof path === 'string' ? encodeTrailingWhitespace(path) : pathToString(path);
+    // If path already has a protocol, it's a complete URL
+    if (hasProtocol(pathString)) {
+        return new URL(pathString);
+    }
+    // Determine the origin to use for relative paths
+    const resolvedOrigin = origin ??
+        (typeof window !== 'undefined' ? window.location?.origin : undefined) ??
+        'http://localhost';
+    return new URL(pathString, resolvedOrigin);
+};
+//# sourceMappingURL=path-to-url.js.map

package/dist/esm/lib/utils/path-to-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-to-url.js","sourceRoot":"","sources":["../../../../src/lib/utils/path-to-url.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAQ,EAAE,MAAe,EAAO,EAAE;IAC1D,wCAAwC;IACxC,MAAM,UAAU,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAElG,sDAAsD;IACtD,IAAI,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IAC7B,CAAC;IAED,iDAAiD;IACjD,MAAM,cAAc,GAClB,MAAM;QACN,CAAC,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QACrE,kBAAkB,CAAC;IAErB,OAAO,IAAI,GAAG,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;AAC7C,CAAC,CAAC"}

package/dist/esm/lib/utils/resolve-browser-location.js

@@ -0,0 +1,53 @@
+import { resolvePath } from './resolve-path';
+const resolveState = (target) => {
+    const { value, key = 'unknown' } = (target ?? window.history).state ??
+        {};
+    return { state: value, key };
+};
+/**
+ * Resolves the current location from window.location.
+ *
+ * @param window - The window object to extract location from
+ * @param target - Optional target object with state
+ * @returns The current location with pathname, search, hash, state, and key
+ *
+ * @example
+ * ```ts
+ * // If window.location is 'https://example.com/users?id=1#section'
+ * resolveWindowLocation(window)
+ * // { pathname: '/users', search: '?id=1', hash: '#section', state: undefined, key: 'unknown' }
+ *
+ * resolveWindowLocation(window, { state: { userId: 123 } })
+ * // { pathname: '/users', search: '?id=1', hash: '#section', state: { userId: 123 }, key: 'abc123' }
+ * ```
+ */
+export const resolveWindowLocation = (window, target) => {
+    const { pathname, search, hash } = resolvePath(window.location);
+    const { state, key } = resolveState(target);
+    return { pathname, search, hash, state, key };
+};
+/**
+ * Resolves the current location from window.location.hash.
+ *
+ * @param window - The window object to extract location from
+ * @param target - Optional target object with state
+ * @returns The current location with pathname, search, hash, state, and key
+ *
+ * @example
+ * ```ts
+ * // If window.location.hash is '#/users?id=1#section'
+ * resolveHashLocation(window)
+ * // { pathname: '/users', search: '?id=1', hash: '#section', state: undefined, key: 'unknown' }
+ *
+ * // If window.location.hash is '#/dashboard'
+ * resolveHashLocation(window)
+ * // { pathname: '/dashboard', search: '', hash: '', state: undefined, key: 'unknown' }
+ * ```
+ */
+export const resolveHashLocation = (window, target) => {
+    const location = resolveWindowLocation(window, target);
+    const { pathname, search, hash } = resolvePath(location.hash?.replace('#', '') ?? '');
+    const { state, key } = resolveState(target);
+    return { pathname, search, hash, state, key };
+};
+//# sourceMappingURL=resolve-browser-location.js.map

package/dist/esm/lib/utils/resolve-browser-location.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-browser-location.js","sourceRoot":"","sources":["../../../../src/lib/utils/resolve-browser-location.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,YAAY,GAAG,CAAC,MAA2B,EAAmC,EAAE;IACpF,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,SAAS,EAAE,GAC9B,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK;QAC/B,EAGC,CAAC;IACL,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AAC/B,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAAc,EAAE,MAA2B,EAAY,EAAE;IAC7F,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AAChD,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,MAAc,EAAE,MAA2B,EAAY,EAAE;IAC3F,MAAM,QAAQ,GAAG,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvD,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,WAAW,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;IACtF,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AAChD,CAAC,CAAC"}