@real-router/angular 0.2.2 → 0.4.0

package/dist/fesm2022/real-router-angular.mjs

@@ -1,11 +1,365 @@
 import * as i0 from '@angular/core';
-import { signal, inject, DestroyRef, InjectionToken, makeEnvironmentProviders, input, TemplateRef, Directive, contentChildren, computed, Component, output, effect, ElementRef } from '@angular/core';
+import { signal, inject, DestroyRef, InjectionToken, provideEnvironmentInitializer, makeEnvironmentProviders, input, TemplateRef, Directive, contentChildren, computed, Component, output, effect, ElementRef } from '@angular/core';
 import { getNavigator, UNKNOWN_ROUTE } from '@real-router/core';
 import { createRouteSource, createRouteNodeSource, getTransitionSource, createActiveRouteSource, createDismissableError } from '@real-router/sources';
 import { getPluginApi } from '@real-router/core/api';
 import { getRouteUtils, startsWithSegment } from '@real-router/route-utils';
 import { NgTemplateOutlet } from '@angular/common';
 
+const CLEAR_DELAY = 7000;
+const SAFARI_READY_DELAY = 100;
+const ANNOUNCER_ATTR = "data-real-router-announcer";
+const INTERNAL_ROUTE_PREFIX = "@@";
+const VISUALLY_HIDDEN = "position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);clip-path:inset(50%);white-space:nowrap;border:0";
+function createRouteAnnouncer(router, options) {
+    const prefix = options?.prefix ?? "Navigated to ";
+    const getCustomText = options?.getAnnouncementText;
+    let isInitialNavigation = true;
+    let isReady = false;
+    let isDestroyed = false;
+    let lastAnnouncedText = "";
+    let pendingText = null;
+    let clearTimeoutId;
+    const announcer = getOrCreateAnnouncer();
+    const doAnnounce = (text, h1) => {
+        lastAnnouncedText = text;
+        clearTimeout(clearTimeoutId);
+        announcer.textContent = text;
+        clearTimeoutId = setTimeout(() => {
+            announcer.textContent = "";
+            lastAnnouncedText = "";
+        }, CLEAR_DELAY);
+        manageFocus(h1);
+    };
+    // Safari-ready delay: announcing before VoiceOver wires up the aria-live region
+    // causes the first announcement to be silently dropped. Wait SAFARI_READY_DELAY ms
+    // before marking the announcer "ready" — any navigation during that window is
+    // buffered in pendingText and flushed once the delay expires.
+    const safariTimeoutId = setTimeout(() => {
+        isReady = true;
+        if (pendingText !== null && !isDestroyed) {
+            const text = pendingText;
+            pendingText = null;
+            doAnnounce(text, document.querySelector("h1"));
+        }
+    }, SAFARI_READY_DELAY);
+    const unsubscribe = router.subscribe(({ route }) => {
+        if (isInitialNavigation) {
+            isInitialNavigation = false;
+            return;
+        }
+        // Double rAF: waits for two paint frames so the incoming route's DOM
+        // (including the new <h1>) is fully rendered before resolveText reads it.
+        // Single rAF fires before the new route's template has been attached,
+        // which would cause resolveText to pick up the OLD h1 or fall back to
+        // document.title / route.name prematurely.
+        requestAnimationFrame(() => {
+            requestAnimationFrame(() => {
+                if (isDestroyed) {
+                    return;
+                }
+                const h1 = document.querySelector("h1");
+                const text = resolveText(route, prefix, getCustomText, h1);
+                if (!text || text === lastAnnouncedText) {
+                    return;
+                }
+                if (!isReady) {
+                    // Defer announcement until Safari-ready window elapses (see safariTimeoutId).
+                    pendingText = text;
+                    return;
+                }
+                doAnnounce(text, h1);
+            });
+        });
+    });
+    return {
+        destroy() {
+            isDestroyed = true;
+            unsubscribe();
+            clearTimeout(clearTimeoutId);
+            clearTimeout(safariTimeoutId);
+            removeAnnouncer();
+        },
+    };
+}
+function getOrCreateAnnouncer() {
+    const existing = document.querySelector(`[${ANNOUNCER_ATTR}]`);
+    if (existing) {
+        return existing;
+    }
+    const element = document.createElement("div");
+    element.setAttribute("style", VISUALLY_HIDDEN);
+    element.setAttribute("aria-live", "assertive");
+    element.setAttribute("aria-atomic", "true");
+    element.setAttribute(ANNOUNCER_ATTR, "");
+    document.body.prepend(element);
+    return element;
+}
+function removeAnnouncer() {
+    document.querySelector(`[${ANNOUNCER_ATTR}]`)?.remove();
+}
+function resolveText(route, prefix, getCustomText, h1) {
+    if (getCustomText) {
+        return getCustomText(route);
+    }
+    const h1Text = h1?.textContent.trim() ?? "";
+    const routeName = route.name.startsWith(INTERNAL_ROUTE_PREFIX)
+        ? ""
+        : route.name;
+    const rawText = h1Text || document.title || routeName || globalThis.location.pathname;
+    return `${prefix}${rawText}`;
+}
+function manageFocus(h1) {
+    if (!h1) {
+        return;
+    }
+    if (!h1.hasAttribute("tabindex")) {
+        h1.setAttribute("tabindex", "-1");
+    }
+    h1.focus({ preventScroll: true });
+}
+
+const STORAGE_KEY = "real-router:scroll";
+const NOOP_INSTANCE = Object.freeze({
+    destroy: () => {
+        /* no-op */
+    },
+});
+function createScrollRestoration(router, options) {
+    if (typeof globalThis.window === "undefined") {
+        return NOOP_INSTANCE;
+    }
+    const mode = options?.mode ?? "restore";
+    // mode "manual" = utility does nothing. Don't flip history.scrollRestoration,
+    // don't subscribe, don't register pagehide — leave the browser's native
+    // auto-restore intact for the app to override if it wants to.
+    if (mode === "manual") {
+        return NOOP_INSTANCE;
+    }
+    const anchorEnabled = options?.anchorScrolling ?? true;
+    const getContainer = options?.scrollContainer;
+    const prevScrollRestoration = history.scrollRestoration;
+    try {
+        history.scrollRestoration = "manual";
+    }
+    catch {
+        // Ignore — some embedded contexts may reject the assignment.
+    }
+    // Resolve the container lazily on every event so containers mounted AFTER
+    // the provider still get correct scroll handling. Falls back to window when
+    // the getter is absent or returns null (pre-mount).
+    const readPos = () => {
+        const element = getContainer?.();
+        return element ? element.scrollTop : globalThis.scrollY;
+    };
+    const writePos = (top) => {
+        const element = getContainer?.();
+        if (element) {
+            element.scrollTop = top;
+        }
+        else {
+            globalThis.scrollTo(0, top);
+        }
+    };
+    const scrollToHashOrTop = () => {
+        const hash = globalThis.location.hash;
+        if (anchorEnabled && hash.length > 1) {
+            // location.hash is percent-encoded; ids in the DOM are the raw string.
+            // Decode for the match. Fall back to the raw slice if the hash contains
+            // a malformed escape sequence (decodeURIComponent throws on those).
+            let id;
+            try {
+                id = decodeURIComponent(hash.slice(1));
+            }
+            catch {
+                id = hash.slice(1);
+            }
+            // eslint-disable-next-line unicorn/prefer-query-selector -- ids may contain CSS-unsafe chars
+            const element = document.getElementById(id);
+            if (element) {
+                element.scrollIntoView();
+                return;
+            }
+        }
+        writePos(0);
+    };
+    let destroyed = false;
+    const unsubscribe = router.subscribe(({ route, previousRoute }) => {
+        const nav = route.context
+            .navigation;
+        // Browsers dispatch reload as the initial navigation after refresh, so
+        // previousRoute is undefined and capture is naturally skipped. The
+        // pre-refresh position was already persisted via pagehide.
+        if (previousRoute) {
+            putPos(keyOf(previousRoute), readPos());
+        }
+        // Single rAF so DOM is committed before we read anchors / write scroll.
+        // Guard against destroy() racing with the callback.
+        requestAnimationFrame(() => {
+            if (destroyed) {
+                return;
+            }
+            if (mode === "top" || !nav) {
+                scrollToHashOrTop();
+                return;
+            }
+            if (nav.navigationType === "replace") {
+                return;
+            }
+            if (nav.direction === "back" ||
+                nav.navigationType === "traverse" ||
+                nav.navigationType === "reload") {
+                writePos(loadStore()[keyOf(route)] ?? 0);
+                return;
+            }
+            scrollToHashOrTop();
+        });
+    });
+    const onPageHide = () => {
+        const current = router.getState();
+        if (current) {
+            putPos(keyOf(current), readPos());
+        }
+    };
+    globalThis.addEventListener("pagehide", onPageHide);
+    return {
+        destroy: () => {
+            if (destroyed) {
+                return;
+            }
+            destroyed = true;
+            unsubscribe();
+            globalThis.removeEventListener("pagehide", onPageHide);
+            try {
+                history.scrollRestoration = prevScrollRestoration;
+            }
+            catch {
+                // Ignore.
+            }
+        },
+    };
+}
+function keyOf(state) {
+    return `${state.name}:${canonicalJson(state.params)}`;
+}
+function loadStore() {
+    try {
+        const raw = sessionStorage.getItem(STORAGE_KEY);
+        return raw ? JSON.parse(raw) : {};
+    }
+    catch {
+        return {};
+    }
+}
+function putPos(key, pos) {
+    try {
+        const store = loadStore();
+        store[key] = pos;
+        sessionStorage.setItem(STORAGE_KEY, JSON.stringify(store));
+    }
+    catch {
+        // Ignore quota / security errors.
+    }
+}
+function canonicalJson(value) {
+    return JSON.stringify(value, canonicalReplacer);
+}
+function canonicalReplacer(_key, val) {
+    if (val !== null && typeof val === "object" && !Array.isArray(val)) {
+        const sorted = {};
+        // eslint-disable-next-line unicorn/no-array-sort -- ng-packagr uses pre-ES2023 lib; toSorted unavailable
+        const keys = Object.keys(val).sort((left, right) => left.localeCompare(right));
+        for (const key of keys) {
+            sorted[key] = val[key];
+        }
+        return sorted;
+    }
+    return val;
+}
+
+function shouldNavigate(evt) {
+    return (evt.button === 0 &&
+        !evt.metaKey &&
+        !evt.altKey &&
+        !evt.ctrlKey &&
+        !evt.shiftKey);
+}
+function buildHref(router, routeName, routeParams) {
+    try {
+        const buildUrl = router.buildUrl;
+        if (buildUrl) {
+            const url = buildUrl(routeName, routeParams);
+            if (url !== undefined) {
+                return url;
+            }
+        }
+        return router.buildPath(routeName, routeParams);
+    }
+    catch {
+        console.error(`[real-router] Route "${routeName}" is not defined. The element will render without an href attribute.`);
+        return undefined;
+    }
+}
+function parseTokens(value) {
+    return value ? (value.match(/\S+/g) ?? []) : [];
+}
+function buildActiveClassName(isActive, activeClassName, baseClassName) {
+    if (isActive && activeClassName) {
+        const activeTokens = parseTokens(activeClassName);
+        if (activeTokens.length === 0) {
+            return baseClassName ?? undefined;
+        }
+        if (!baseClassName) {
+            return activeTokens.join(" ");
+        }
+        const baseTokens = parseTokens(baseClassName);
+        const seen = new Set(baseTokens);
+        for (const token of activeTokens) {
+            if (!seen.has(token)) {
+                seen.add(token);
+                baseTokens.push(token);
+            }
+        }
+        return baseTokens.join(" ");
+    }
+    return baseClassName ?? undefined;
+}
+function shallowEqual(prev, next) {
+    if (Object.is(prev, next)) {
+        return true;
+    }
+    if (!prev || !next) {
+        return false;
+    }
+    const prevKeys = Object.keys(prev);
+    if (prevKeys.length !== Object.keys(next).length) {
+        return false;
+    }
+    const prevRecord = prev;
+    const nextRecord = next;
+    for (const key of prevKeys) {
+        if (!Object.is(prevRecord[key], nextRecord[key])) {
+            return false;
+        }
+    }
+    return true;
+}
+function applyLinkA11y(element) {
+    if (!element) {
+        return;
+    }
+    if (element instanceof HTMLAnchorElement ||
+        element instanceof HTMLButtonElement) {
+        return;
+    }
+    if (!element.hasAttribute("role")) {
+        element.setAttribute("role", "link");
+    }
+    if (!element.hasAttribute("tabindex")) {
+        element.setAttribute("tabindex", "0");
+    }
+}
+
 /** Must be called within an injection context (constructor, field initializer, runInInjectionContext). */
 function sourceToSignal(source) {
     const sig = signal(source.getSnapshot(), ...(ngDevMode ? [{ debugName: "sig" }] : /* istanbul ignore next */ []));
@@ -23,9 +377,9 @@ function sourceToSignal(source) {
 const ROUTER = new InjectionToken("ROUTER");
 const NAVIGATOR = new InjectionToken("NAVIGATOR");
 const ROUTE = new InjectionToken("ROUTE");
-function provideRealRouter(router) {
+function provideRealRouter(router, options) {
     const navigator = getNavigator(router);
-    return makeEnvironmentProviders([
+    const providers = [
         { provide: ROUTER, useValue: router },
         { provide: NAVIGATOR, useValue: navigator },
         {
@@ -35,7 +389,17 @@ function provideRealRouter(router) {
                 navigator,
             }),
         },
-    ]);
+    ];
+    if (options?.scrollRestoration) {
+        const scrollOpts = options.scrollRestoration;
+        providers.push(provideEnvironmentInitializer(() => {
+            const sr = createScrollRestoration(router, scrollOpts);
+            inject(DestroyRef).onDestroy(() => {
+                sr.destroy();
+            });
+        }));
+    }
+    return makeEnvironmentProviders(providers);
 }
 
 function injectOrThrow(token, fnName) {
@@ -107,6 +471,16 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.8", ngImpor
             args: [{ selector: "ng-template[routeNotFound]" }]
         }] });
 
+class RouteSelf {
+    templateRef = inject(TemplateRef);
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.8", ngImport: i0, type: RouteSelf, deps: [], target: i0.ɵɵFactoryTarget.Directive });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "21.2.8", type: RouteSelf, isStandalone: true, selector: "ng-template[routeSelf]", ngImport: i0 });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.8", ngImport: i0, type: RouteSelf, decorators: [{
+            type: Directive,
+            args: [{ selector: "ng-template[routeSelf]" }]
+        }] });
+
 const EMPTY_SNAPSHOT = Object.freeze({
     route: undefined,
     previousRoute: undefined,
@@ -114,6 +488,7 @@ const EMPTY_SNAPSHOT = Object.freeze({
 class RouteView {
     nodeName = input("", { ...(ngDevMode ? { debugName: "nodeName" } : /* istanbul ignore next */ {}), alias: "routeNode" });
     matches = contentChildren(RouteMatch, { ...(ngDevMode ? { debugName: "matches" } : /* istanbul ignore next */ {}), descendants: true });
+    selfs = contentChildren(RouteSelf, { ...(ngDevMode ? { debugName: "selfs" } : /* istanbul ignore next */ {}), descendants: true });
     notFounds = contentChildren(RouteNotFound, { ...(ngDevMode ? { debugName: "notFounds" } : /* istanbul ignore next */ {}), descendants: true });
     activeTemplate = computed(() => {
         const snapshot = this.routeState();
@@ -128,6 +503,16 @@ class RouteView {
                 return match.templateRef;
             }
         }
+        // Self has priority over NotFound. First-wins to mirror NotFound's
+        // last-wins inversion would be inconsistent with React/Preact/Solid/Vue
+        // adapters where Self is "first wins"; Angular's contentChildren returns
+        // declaration order, so picking [0] gives first-wins.
+        if (routeName === this.nodeName()) {
+            const first = this.selfs().at(0);
+            if (first) {
+                return first.templateRef;
+            }
+        }
         if (routeName === UNKNOWN_ROUTE) {
             const last = this.notFounds().at(-1);
             if (last) {
@@ -161,7 +546,7 @@ class RouteView {
         });
     }
     static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.8", ngImport: i0, type: RouteView, deps: [], target: i0.ɵɵFactoryTarget.Component });
-    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.8", type: RouteView, isStandalone: true, selector: "route-view", inputs: { nodeName: { classPropertyName: "nodeName", publicName: "routeNode", isSignal: true, isRequired: false, transformFunction: null } }, queries: [{ propertyName: "matches", predicate: RouteMatch, descendants: true, isSignal: true }, { propertyName: "notFounds", predicate: RouteNotFound, descendants: true, isSignal: true }], ngImport: i0, template: `
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.0.0", version: "21.2.8", type: RouteView, isStandalone: true, selector: "route-view", inputs: { nodeName: { classPropertyName: "nodeName", publicName: "routeNode", isSignal: true, isRequired: false, transformFunction: null } }, queries: [{ propertyName: "matches", predicate: RouteMatch, descendants: true, isSignal: true }, { propertyName: "selfs", predicate: RouteSelf, descendants: true, isSignal: true }, { propertyName: "notFounds", predicate: RouteNotFound, descendants: true, isSignal: true }], ngImport: i0, template: `
     @if (activeTemplate()) {
       <ng-container [ngTemplateOutlet]="activeTemplate()!" />
     }
@@ -178,7 +563,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.8", ngImpor
   `,
                     imports: [NgTemplateOutlet],
                 }]
-        }], propDecorators: { nodeName: [{ type: i0.Input, args: [{ isSignal: true, alias: "routeNode", required: false }] }], matches: [{ type: i0.ContentChildren, args: [i0.forwardRef(() => RouteMatch), { ...{ descendants: true }, isSignal: true }] }], notFounds: [{ type: i0.ContentChildren, args: [i0.forwardRef(() => RouteNotFound), { ...{ descendants: true }, isSignal: true }] }] } });
+        }], propDecorators: { nodeName: [{ type: i0.Input, args: [{ isSignal: true, alias: "routeNode", required: false }] }], matches: [{ type: i0.ContentChildren, args: [i0.forwardRef(() => RouteMatch), { ...{ descendants: true }, isSignal: true }] }], selfs: [{ type: i0.ContentChildren, args: [i0.forwardRef(() => RouteSelf), { ...{ descendants: true }, isSignal: true }] }], notFounds: [{ type: i0.ContentChildren, args: [i0.forwardRef(() => RouteNotFound), { ...{ descendants: true }, isSignal: true }] }] } });
 
 class RouterErrorBoundary {
     errorTemplate = input(...(ngDevMode ? [undefined, { debugName: "errorTemplate" }] : /* istanbul ignore next */ []));
@@ -235,202 +620,6 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.8", ngImpor
                 }]
         }], ctorParameters: () => [], propDecorators: { errorTemplate: [{ type: i0.Input, args: [{ isSignal: true, alias: "errorTemplate", required: false }] }], onError: [{ type: i0.Output, args: ["onError"] }] } });
 
-const CLEAR_DELAY = 7000;
-const SAFARI_READY_DELAY = 100;
-const ANNOUNCER_ATTR = "data-real-router-announcer";
-const INTERNAL_ROUTE_PREFIX = "@@";
-const VISUALLY_HIDDEN = "position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);clip-path:inset(50%);white-space:nowrap;border:0";
-function createRouteAnnouncer(router, options) {
-    const prefix = options?.prefix ?? "Navigated to ";
-    const getCustomText = options?.getAnnouncementText;
-    let isInitialNavigation = true;
-    let isReady = false;
-    let isDestroyed = false;
-    let lastAnnouncedText = "";
-    let pendingText = null;
-    let clearTimeoutId;
-    const announcer = getOrCreateAnnouncer();
-    const doAnnounce = (text, h1) => {
-        lastAnnouncedText = text;
-        clearTimeout(clearTimeoutId);
-        announcer.textContent = text;
-        clearTimeoutId = setTimeout(() => {
-            announcer.textContent = "";
-            lastAnnouncedText = "";
-        }, CLEAR_DELAY);
-        manageFocus(h1);
-    };
-    // Safari-ready delay: announcing before VoiceOver wires up the aria-live region
-    // causes the first announcement to be silently dropped. Wait SAFARI_READY_DELAY ms
-    // before marking the announcer "ready" — any navigation during that window is
-    // buffered in pendingText and flushed once the delay expires.
-    const safariTimeoutId = setTimeout(() => {
-        isReady = true;
-        if (pendingText !== null && !isDestroyed) {
-            const text = pendingText;
-            pendingText = null;
-            doAnnounce(text, document.querySelector("h1"));
-        }
-    }, SAFARI_READY_DELAY);
-    const unsubscribe = router.subscribe(({ route }) => {
-        if (isInitialNavigation) {
-            isInitialNavigation = false;
-            return;
-        }
-        // Double rAF: waits for two paint frames so the incoming route's DOM
-        // (including the new <h1>) is fully rendered before resolveText reads it.
-        // Single rAF fires before the new route's template has been attached,
-        // which would cause resolveText to pick up the OLD h1 or fall back to
-        // document.title / route.name prematurely.
-        requestAnimationFrame(() => {
-            requestAnimationFrame(() => {
-                if (isDestroyed) {
-                    return;
-                }
-                const h1 = document.querySelector("h1");
-                const text = resolveText(route, prefix, getCustomText, h1);
-                if (!text || text === lastAnnouncedText) {
-                    return;
-                }
-                if (!isReady) {
-                    // Defer announcement until Safari-ready window elapses (see safariTimeoutId).
-                    pendingText = text;
-                    return;
-                }
-                doAnnounce(text, h1);
-            });
-        });
-    });
-    return {
-        destroy() {
-            isDestroyed = true;
-            unsubscribe();
-            clearTimeout(clearTimeoutId);
-            clearTimeout(safariTimeoutId);
-            removeAnnouncer();
-        },
-    };
-}
-function getOrCreateAnnouncer() {
-    const existing = document.querySelector(`[${ANNOUNCER_ATTR}]`);
-    if (existing) {
-        return existing;
-    }
-    const element = document.createElement("div");
-    element.setAttribute("style", VISUALLY_HIDDEN);
-    element.setAttribute("aria-live", "assertive");
-    element.setAttribute("aria-atomic", "true");
-    element.setAttribute(ANNOUNCER_ATTR, "");
-    document.body.prepend(element);
-    return element;
-}
-function removeAnnouncer() {
-    document.querySelector(`[${ANNOUNCER_ATTR}]`)?.remove();
-}
-function resolveText(route, prefix, getCustomText, h1) {
-    if (getCustomText) {
-        return getCustomText(route);
-    }
-    const h1Text = h1?.textContent.trim() ?? "";
-    const routeName = route.name.startsWith(INTERNAL_ROUTE_PREFIX)
-        ? ""
-        : route.name;
-    const rawText = h1Text || document.title || routeName || globalThis.location.pathname;
-    return `${prefix}${rawText}`;
-}
-function manageFocus(h1) {
-    if (!h1) {
-        return;
-    }
-    if (!h1.hasAttribute("tabindex")) {
-        h1.setAttribute("tabindex", "-1");
-    }
-    h1.focus({ preventScroll: true });
-}
-
-function shouldNavigate(evt) {
-    return (evt.button === 0 &&
-        !evt.metaKey &&
-        !evt.altKey &&
-        !evt.ctrlKey &&
-        !evt.shiftKey);
-}
-function buildHref(router, routeName, routeParams) {
-    try {
-        const buildUrl = router.buildUrl;
-        if (buildUrl) {
-            const url = buildUrl(routeName, routeParams);
-            if (url !== undefined) {
-                return url;
-            }
-        }
-        return router.buildPath(routeName, routeParams);
-    }
-    catch {
-        console.error(`[real-router] Route "${routeName}" is not defined. The element will render without an href attribute.`);
-        return undefined;
-    }
-}
-function parseTokens(value) {
-    return value ? (value.match(/\S+/g) ?? []) : [];
-}
-function buildActiveClassName(isActive, activeClassName, baseClassName) {
-    if (isActive && activeClassName) {
-        const activeTokens = parseTokens(activeClassName);
-        if (activeTokens.length === 0) {
-            return baseClassName ?? undefined;
-        }
-        if (!baseClassName) {
-            return activeTokens.join(" ");
-        }
-        const baseTokens = parseTokens(baseClassName);
-        const seen = new Set(baseTokens);
-        for (const token of activeTokens) {
-            if (!seen.has(token)) {
-                seen.add(token);
-                baseTokens.push(token);
-            }
-        }
-        return baseTokens.join(" ");
-    }
-    return baseClassName ?? undefined;
-}
-function shallowEqual(prev, next) {
-    if (Object.is(prev, next)) {
-        return true;
-    }
-    if (!prev || !next) {
-        return false;
-    }
-    const prevKeys = Object.keys(prev);
-    if (prevKeys.length !== Object.keys(next).length) {
-        return false;
-    }
-    const prevRecord = prev;
-    const nextRecord = next;
-    for (const key of prevKeys) {
-        if (!Object.is(prevRecord[key], nextRecord[key])) {
-            return false;
-        }
-    }
-    return true;
-}
-function applyLinkA11y(element) {
-    if (!element) {
-        return;
-    }
-    if (element instanceof HTMLAnchorElement ||
-        element instanceof HTMLButtonElement) {
-        return;
-    }
-    if (!element.hasAttribute("role")) {
-        element.setAttribute("role", "link");
-    }
-    if (!element.hasAttribute("tabindex")) {
-        element.setAttribute("tabindex", "0");
-    }
-}
-
 class NavigationAnnouncer {
     announcer = createRouteAnnouncer(injectRouter());
     constructor() {
@@ -563,5 +752,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.8", ngImpor
  * Generated bundle index. Do not edit.
  */
 
-export { NAVIGATOR, NavigationAnnouncer, ROUTE, ROUTER, RealLink, RealLinkActive, RouteMatch, RouteNotFound, RouteView, RouterErrorBoundary, injectIsActiveRoute, injectNavigator, injectRoute, injectRouteNode, injectRouteUtils, injectRouter, injectRouterTransition, provideRealRouter, sourceToSignal };
+export { NAVIGATOR, NavigationAnnouncer, ROUTE, ROUTER, RealLink, RealLinkActive, RouteMatch, RouteNotFound, RouteSelf, RouteView, RouterErrorBoundary, injectIsActiveRoute, injectNavigator, injectRoute, injectRouteNode, injectRouteUtils, injectRouter, injectRouterTransition, provideRealRouter, sourceToSignal };
 //# sourceMappingURL=real-router-angular.mjs.map