@mmstack/router-core 19.0.1 → 19.0.2

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025-present Miha Mulec
+Copyright (c) 2025-present Miha J. Mulec
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/fesm2022/mmstack-router-core.mjs

@@ -1,9 +1,173 @@
-import { inject, computed, isSignal, untracked } from '@angular/core';
+import * as i0 from '@angular/core';
+import { inject, Injectable, input, booleanAttribute, untracked, isDevMode, ElementRef, DestroyRef, Directive, computed, isSignal } from '@angular/core';
+import * as i1 from '@angular/router';
+import { Router, PreloadingStrategy, NoPreloading, PreloadAllModules, RouterPreloader, RouterLink, RouterLinkWithHref, ActivatedRoute, EventType } from '@angular/router';
+import { EMPTY } from 'rxjs';
 import { toSignal } from '@angular/core/rxjs-interop';
-import { ActivatedRoute, Router, EventType } from '@angular/router';
 import { toWritable } from '@mmstack/primitives';
 import { filter, map } from 'rxjs/operators';
 
+function flattenRoutes(routes) {
+    return routes;
+}
+
+function hasSlowConnection() {
+    if (globalThis.window &&
+        'navigator' in globalThis.window &&
+        'connection' in globalThis.window.navigator &&
+        typeof globalThis.window.navigator.connection === 'object' &&
+        !!globalThis.window.navigator.connection &&
+        'effectiveType' in globalThis.window.navigator.connection &&
+        typeof globalThis.window.navigator.connection.effectiveType === 'string')
+        return globalThis.window.navigator.connection.effectiveType.endsWith('2g');
+    return false;
+}
+const HAS_SLOW_CONNECTION = hasSlowConnection();
+function noPreload(route) {
+    return route.data && route.data['preload'] === false;
+}
+class PreloadLinkStrategy {
+    routeMap = flattenRoutes(inject(Router).config);
+    preload(route, fn) {
+        if (HAS_SLOW_CONNECTION || noPreload(route))
+            return EMPTY;
+        return EMPTY;
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.3", ngImport: i0, type: PreloadLinkStrategy, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "19.2.3", ngImport: i0, type: PreloadLinkStrategy, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.3", ngImport: i0, type: PreloadLinkStrategy, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root',
+                }]
+        }] });
+function observerSupported() {
+    return typeof IntersectionObserver !== 'undefined';
+}
+function injectPreloader() {
+    const strategy = inject(PreloadingStrategy, {
+        optional: true,
+    });
+    if (!strategy ||
+        strategy instanceof NoPreloading ||
+        strategy instanceof PreloadAllModules)
+        return null;
+    return inject(RouterPreloader, {
+        optional: true,
+    });
+}
+class VisibleLinkHandler {
+    map = new WeakMap();
+    observer = observerSupported()
+        ? new IntersectionObserver((entries) => {
+            entries.forEach((entry) => {
+                if (!entry.isIntersecting)
+                    return;
+                this.map.get(entry.target)?.();
+                this.observer?.unobserve(entry.target);
+            });
+        })
+        : null;
+    register(el, onVisible) {
+        if (!this.observer)
+            return () => {
+                // noop
+            };
+        this.map.set(el, onVisible);
+        this.observer.observe(el);
+        return () => {
+            this.map.delete(el);
+            this.observer?.unobserve(el);
+        };
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.3", ngImport: i0, type: VisibleLinkHandler, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "19.2.3", ngImport: i0, type: VisibleLinkHandler, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.3", ngImport: i0, type: VisibleLinkHandler, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root',
+                }]
+        }] });
+class LinkDirective {
+    routerLink = inject(RouterLink, {
+        self: true,
+        optional: true,
+    }) ?? inject(RouterLinkWithHref, { self: true, optional: true });
+    preloader = injectPreloader();
+    target = input();
+    queryParams = input();
+    fragment = input();
+    queryParamsHandling = input();
+    state = input();
+    info = input();
+    relativeTo = input();
+    skipLocationChange = input(false, { transform: booleanAttribute });
+    replaceUrl = input(false, { transform: booleanAttribute });
+    mmLink = input.required();
+    preloadOn = input(null);
+    onHover() {
+        if (untracked(this.preloadOn) !== 'hover')
+            return;
+        if (!this.preloader) {
+            if (isDevMode())
+                console.error('Preloader not available, please configure a preloading strategy');
+            return;
+        }
+        this.preloader?.preload().subscribe();
+    }
+    onVisible() {
+        if (untracked(this.preloadOn) !== 'visible')
+            return;
+        if (!this.preloader) {
+            if (isDevMode())
+                console.error('Preloader not available, please configure a preloading strategy');
+            return;
+        }
+    }
+    constructor() {
+        const el = inject(ElementRef, {
+            self: true,
+        });
+        const unsub = inject(VisibleLinkHandler).register(el.nativeElement, (() => {
+            this.onVisible();
+        }).bind(this));
+        inject(DestroyRef).onDestroy(() => unsub());
+    }
+    onClick(button, ctrlKey, shiftKey, altKey, metaKey) {
+        return this.routerLink?.onClick(button, ctrlKey, shiftKey, altKey, metaKey);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.3", ngImport: i0, type: LinkDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "19.2.3", type: LinkDirective, isStandalone: true, selector: "[mmLink]", inputs: { target: { classPropertyName: "target", publicName: "target", isSignal: true, isRequired: false, transformFunction: null }, queryParams: { classPropertyName: "queryParams", publicName: "queryParams", isSignal: true, isRequired: false, transformFunction: null }, fragment: { classPropertyName: "fragment", publicName: "fragment", isSignal: true, isRequired: false, transformFunction: null }, queryParamsHandling: { classPropertyName: "queryParamsHandling", publicName: "queryParamsHandling", isSignal: true, isRequired: false, transformFunction: null }, state: { classPropertyName: "state", publicName: "state", isSignal: true, isRequired: false, transformFunction: null }, info: { classPropertyName: "info", publicName: "info", isSignal: true, isRequired: false, transformFunction: null }, relativeTo: { classPropertyName: "relativeTo", publicName: "relativeTo", isSignal: true, isRequired: false, transformFunction: null }, skipLocationChange: { classPropertyName: "skipLocationChange", publicName: "skipLocationChange", isSignal: true, isRequired: false, transformFunction: null }, replaceUrl: { classPropertyName: "replaceUrl", publicName: "replaceUrl", isSignal: true, isRequired: false, transformFunction: null }, mmLink: { classPropertyName: "mmLink", publicName: "mmLink", isSignal: true, isRequired: true, transformFunction: null }, preloadOn: { classPropertyName: "preloadOn", publicName: "preloadOn", isSignal: true, isRequired: false, transformFunction: null } }, host: { listeners: { "mouseenter": "onHover()" } }, exportAs: ["mmLink"], hostDirectives: [{ directive: i1.RouterLink, inputs: ["routerLink", "mmLink", "target", "target", "queryParams", "queryParams", "fragment", "fragment", "queryParamsHandling", "queryParamsHandling", "state", "state", "relativeTo", "relativeTo", "skipLocationChange", "skipLocationChange", "replaceUrl", "replaceUrl"] }], ngImport: i0 });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.3", ngImport: i0, type: LinkDirective, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: '[mmLink]',
+                    exportAs: 'mmLink',
+                    host: {
+                        '(mouseenter)': 'onHover()',
+                    },
+                    hostDirectives: [
+                        {
+                            directive: RouterLink,
+                            inputs: [
+                                'routerLink: mmLink',
+                                'target',
+                                'queryParams',
+                                'fragment',
+                                'queryParamsHandling',
+                                'state',
+                                'relativeTo',
+                                'skipLocationChange',
+                                'replaceUrl',
+                            ],
+                        },
+                    ],
+                }]
+        }], ctorParameters: () => [] });
+
 /**
  * Creates a WritableSignal that synchronizes with a specific URL query parameter,
  * enabling two-way binding between the signal's state and the URL.
@@ -163,5 +327,5 @@ function url() {
  * Generated bundle index. Do not edit.
  */
 
-export { queryParam, url };
+export { LinkDirective, PreloadLinkStrategy, queryParam, url };
 //# sourceMappingURL=mmstack-router-core.mjs.map

package/fesm2022/mmstack-router-core.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mmstack-router-core.mjs","sources":["../../../../../packages/router/core/src/lib/query-param.ts","../../../../../packages/router/core/src/lib/url.ts","../../../../../packages/router/core/src/mmstack-router-core.ts"],"sourcesContent":["import {\n  computed,\n  inject,\n  isSignal,\n  untracked,\n  type WritableSignal,\n} from '@angular/core';\nimport { toSignal } from '@angular/core/rxjs-interop';\nimport { ActivatedRoute, Router } from '@angular/router';\nimport { toWritable } from '@mmstack/primitives';\n\n/**\n * Creates a WritableSignal that synchronizes with a specific URL query parameter,\n * enabling two-way binding between the signal's state and the URL.\n *\n * Reading the signal provides the current value of the query parameter (or null if absent).\n * Setting the signal updates the URL query parameter using `Router.navigate`, triggering\n * navigation and causing the signal to update reactively if the navigation is successful.\n *\n * @param key The key of the query parameter to synchronize with.\n * Can be a static string (e.g., `'search'`) or a function/signal returning a string\n * for dynamic keys (e.g., `() => this.userId() + '_filter'` or `computed(() => this.category() + '_sort')`).\n * The signal will reactively update if the key returned by the function/signal changes.\n * @returns {WritableSignal<string | null>} A signal representing the query parameter's value.\n * - Reading returns the current value string, or `null` if the parameter is absent in the URL.\n * - Setting the signal to a string updates the query parameter in the URL (e.g., `signal.set('value')` results in `?key=value`).\n * - Setting the signal to `null` removes the query parameter from the URL (e.g., `signal.set(null)` results in `?otherParam=...`).\n * - Automatically reflects changes if the query parameters update due to external navigation.\n * @remarks\n * - Requires Angular's `ActivatedRoute` and `Router` to be available in the injection context.\n * - Uses `Router.navigate` with `queryParamsHandling: 'merge'` to preserve other existing query parameters during updates.\n * - Handles dynamic keys reactively. If the result of the `key` function/signal changes, the signal will start reflecting the value of the *new* query parameter key.\n * - During Server-Side Rendering (SSR), it reads the initial value from the route snapshot. Write operations (`set`) might have limited or no effect on the server depending on the platform configuration.\n *\n * @example\n * ```ts\n * import { Component, computed, effect, signal } from '@angular/core';\n * import { queryParam } from '@mmstack/router-core'; // Adjust import path as needed\n * // import { FormsModule } from '@angular/forms'; // If using ngModel\n *\n * @Component({\n * selector: 'app-product-list',\n * standalone: true,\n * // imports: [FormsModule], // If using ngModel\n * template: `\n * <div>\n * Sort By:\n * <select [value]=\"sortSignal() ?? ''\" (change)=\"sortSignal.set($any($event.target).value || null)\">\n * <option value=\"\">Default</option>\n * <option value=\"price_asc\">Price Asc</option>\n * <option value=\"price_desc\">Price Desc</option>\n * <option value=\"name\">Name</option>\n * </select>\n * <button (click)=\"sortSignal.set(null)\" [disabled]=\"!sortSignal()\">Clear Sort</button>\n * </div>\n * <div>\n * Page:\n * <input type=\"number\" min=\"1\" [value]=\"pageSignal() ?? '1'\" #p (input)=\"setPage(p.value)\"/>\n * </div>\n * * `\n * })\n * export class ProductListComponent {\n * // Two-way bind the 'sort' query parameter (?sort=...)\n * // Defaults to null if param is missing\n * sortSignal = queryParam('sort');\n *\n * // Example with a different type (needs serialization or separate logic)\n * // For simplicity, we treat page as string | null here\n * pageSignal = queryParam('page');\n *\n * constructor() {\n * effect(() => {\n * const currentSort = this.sortSignal();\n * const currentPage = this.pageSignal(); // Read as string | null\n * console.log('Sort/Page changed, reloading products for:', { sort: currentSort, page: currentPage });\n * // --- Fetch data based on currentSort and currentPage ---\n * });\n * }\n *\n * setPage(value: string): void {\n * const pageNum = parseInt(value, 10);\n * // Set to null if page is 1 (to remove param), otherwise set string value\n * this.pageSignal.set(isNaN(pageNum) || pageNum <= 1 ? null : pageNum.toString());\n * }\n * }\n * ```\n */\nexport function queryParam(\n  key: string | (() => string),\n): WritableSignal<string | null> {\n  const route = inject(ActivatedRoute);\n  const router = inject(Router);\n\n  const keySignal =\n    typeof key === 'string'\n      ? computed(() => key)\n      : isSignal(key)\n        ? key\n        : computed(key);\n\n  const queryParamMap = toSignal(route.queryParamMap, {\n    initialValue: route.snapshot.queryParamMap,\n  });\n\n  const queryParams = toSignal(route.queryParams, {\n    initialValue: route.snapshot.queryParams,\n  });\n\n  const queryParam = computed(() => queryParamMap().get(keySignal()));\n\n  const set = (newValue: string | null) => {\n    const next = {\n      ...untracked(queryParams),\n    };\n    const key = untracked(keySignal);\n\n    if (newValue === null) {\n      delete next[key];\n    } else {\n      next[key] = newValue;\n    }\n\n    router.navigate([], {\n      relativeTo: route,\n      queryParams: next,\n      queryParamsHandling: 'merge',\n    });\n  };\n\n  return toWritable(queryParam, set);\n}\n","import { inject, type Signal } from '@angular/core';\nimport { toSignal } from '@angular/core/rxjs-interop';\nimport {\n  type Event,\n  EventType,\n  type NavigationEnd,\n  Router,\n} from '@angular/router';\nimport { filter, map } from 'rxjs/operators';\n\n/**\n * Type guard to check if a Router Event is a NavigationEnd event.\n * @internal\n */\nfunction isNavigationEnd(e: Event): e is NavigationEnd {\n  return 'type' in e && e.type === EventType.NavigationEnd;\n}\n\n/**\n * Creates a Signal that tracks the current router URL.\n *\n * The signal emits the URL string reflecting the router state *after* redirects\n * have completed for each successful navigation. It initializes with the router's\n * current URL state.\n *\n * @returns {Signal<string>} A Signal emitting the `urlAfterRedirects` upon successful navigation.\n *\n * @example\n * ```ts\n * import { Component, effect } from '@angular/core';\n * import { url } from '@mmstack/router-core'; // Adjust import path\n *\n * @Component({\n * selector: 'app-root',\n * template: `Current URL: {{ currentUrl() }}`\n * })\n * export class AppComponent {\n * currentUrl = url();\n *\n * constructor() {\n * effect(() => {\n * console.log('Navigation ended. New URL:', this.currentUrl());\n * // e.g., track page view with analytics\n * });\n * }\n * }\n * ```\n */\nexport function url(): Signal<string> {\n  const router = inject(Router);\n\n  return toSignal(\n    router.events.pipe(\n      filter(isNavigationEnd),\n      map((e) => e.urlAfterRedirects),\n    ),\n    {\n      initialValue: router.url,\n    },\n  );\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;;AAWA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2EG;AACG,SAAU,UAAU,CACxB,GAA4B,EAAA;AAE5B,IAAA,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC;AACpC,IAAA,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;AAE7B,IAAA,MAAM,SAAS,GACb,OAAO,GAAG,KAAK;AACb,UAAE,QAAQ,CAAC,MAAM,GAAG;AACpB,UAAE,QAAQ,CAAC,GAAG;AACZ,cAAE;AACF,cAAE,QAAQ,CAAC,GAAG,CAAC;AAErB,IAAA,MAAM,aAAa,GAAG,QAAQ,CAAC,KAAK,CAAC,aAAa,EAAE;AAClD,QAAA,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,aAAa;AAC3C,KAAA,CAAC;AAEF,IAAA,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE;AAC9C,QAAA,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,WAAW;AACzC,KAAA,CAAC;AAEF,IAAA,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,aAAa,EAAE,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;AAEnE,IAAA,MAAM,GAAG,GAAG,CAAC,QAAuB,KAAI;AACtC,QAAA,MAAM,IAAI,GAAG;YACX,GAAG,SAAS,CAAC,WAAW,CAAC;SAC1B;AACD,QAAA,MAAM,GAAG,GAAG,SAAS,CAAC,SAAS,CAAC;AAEhC,QAAA,IAAI,QAAQ,KAAK,IAAI,EAAE;AACrB,YAAA,OAAO,IAAI,CAAC,GAAG,CAAC;;aACX;AACL,YAAA,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ;;AAGtB,QAAA,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE;AAClB,YAAA,UAAU,EAAE,KAAK;AACjB,YAAA,WAAW,EAAE,IAAI;AACjB,YAAA,mBAAmB,EAAE,OAAO;AAC7B,SAAA,CAAC;AACJ,KAAC;AAED,IAAA,OAAO,UAAU,CAAC,UAAU,EAAE,GAAG,CAAC;AACpC;;ACxHA;;;AAGG;AACH,SAAS,eAAe,CAAC,CAAQ,EAAA;IAC/B,OAAO,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,aAAa;AAC1D;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BG;SACa,GAAG,GAAA;AACjB,IAAA,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAE7B,OAAO,QAAQ,CACb,MAAM,CAAC,MAAM,CAAC,IAAI,CAChB,MAAM,CAAC,eAAe,CAAC,EACvB,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,iBAAiB,CAAC,CAChC,EACD;QACE,YAAY,EAAE,MAAM,CAAC,GAAG;AACzB,KAAA,CACF;AACH;;AC5DA;;AAEG;;;;"}
+{"version":3,"file":"mmstack-router-core.mjs","sources":["../../../../../packages/router/core/src/lib/preloading/flat-routes.ts","../../../../../packages/router/core/src/lib/preloading/link.directive.ts","../../../../../packages/router/core/src/lib/query-param.ts","../../../../../packages/router/core/src/lib/url.ts","../../../../../packages/router/core/src/mmstack-router-core.ts"],"sourcesContent":["import { Route } from '@angular/router';\n\nexport function flattenRoutes(routes: Route[]): Route[] {\n  return routes;\n}\n","import {\r\n  booleanAttribute,\r\n  DestroyRef,\r\n  Directive,\r\n  ElementRef,\r\n  inject,\r\n  Injectable,\r\n  input,\r\n  isDevMode,\r\n  untracked,\r\n} from '@angular/core';\r\nimport {\r\n  NoPreloading,\r\n  PreloadAllModules,\r\n  PreloadingStrategy,\r\n  Route,\r\n  Router,\r\n  RouterLink,\r\n  RouterLinkWithHref,\r\n  RouterPreloader,\r\n  type ActivatedRoute,\r\n  type Params,\r\n  type UrlTree,\r\n} from '@angular/router';\r\nimport { EMPTY, Observable } from 'rxjs';\r\nimport { flattenRoutes } from './flat-routes';\r\n\r\nexport function hasSlowConnection() {\r\n  if (\r\n    globalThis.window &&\r\n    'navigator' in globalThis.window &&\r\n    'connection' in globalThis.window.navigator &&\r\n    typeof globalThis.window.navigator.connection === 'object' &&\r\n    !!globalThis.window.navigator.connection &&\r\n    'effectiveType' in globalThis.window.navigator.connection &&\r\n    typeof globalThis.window.navigator.connection.effectiveType === 'string'\r\n  )\r\n    return globalThis.window.navigator.connection.effectiveType.endsWith('2g');\r\n\r\n  return false;\r\n}\r\n\r\nconst HAS_SLOW_CONNECTION = hasSlowConnection();\r\n\r\nfunction noPreload(route: Route) {\r\n  return route.data && route.data['preload'] === false;\r\n}\r\n\r\n@Injectable({\r\n  providedIn: 'root',\r\n})\r\nexport class PreloadLinkStrategy implements PreloadingStrategy {\r\n  private readonly routeMap = flattenRoutes(inject(Router).config);\r\n  preload(route: Route, fn: () => Observable<any>): Observable<any> {\r\n    if (HAS_SLOW_CONNECTION || noPreload(route)) return EMPTY;\r\n    return EMPTY;\r\n  }\r\n}\r\n\r\nfunction observerSupported() {\r\n  return typeof IntersectionObserver !== 'undefined';\r\n}\r\n\r\nfunction injectPreloader(): RouterPreloader | null {\r\n  const strategy = inject(PreloadingStrategy, {\r\n    optional: true,\r\n  });\r\n\r\n  if (\r\n    !strategy ||\r\n    strategy instanceof NoPreloading ||\r\n    strategy instanceof PreloadAllModules\r\n  )\r\n    return null;\r\n\r\n  return inject(RouterPreloader, {\r\n    optional: true,\r\n  });\r\n}\r\n\r\n@Injectable({\r\n  providedIn: 'root',\r\n})\r\nexport class VisibleLinkHandler {\r\n  private readonly map = new WeakMap<Element, () => void>();\r\n  private readonly observer: IntersectionObserver | null = observerSupported()\r\n    ? new IntersectionObserver((entries) => {\r\n        entries.forEach((entry) => {\r\n          if (!entry.isIntersecting) return;\r\n          this.map.get(entry.target)?.();\r\n          this.observer?.unobserve(entry.target);\r\n        });\r\n      })\r\n    : null;\r\n\r\n  register(el: Element, onVisible: () => void) {\r\n    if (!this.observer)\r\n      return () => {\r\n        // noop\r\n      };\r\n\r\n    this.map.set(el, onVisible);\r\n    this.observer.observe(el);\r\n\r\n    return () => {\r\n      this.map.delete(el);\r\n      this.observer?.unobserve(el);\r\n    };\r\n  }\r\n}\r\n\r\n@Directive({\r\n  selector: '[mmLink]',\r\n  exportAs: 'mmLink',\r\n  host: {\r\n    '(mouseenter)': 'onHover()',\r\n  },\r\n  hostDirectives: [\r\n    {\r\n      directive: RouterLink,\r\n      inputs: [\r\n        'routerLink: mmLink',\r\n        'target',\r\n        'queryParams',\r\n        'fragment',\r\n        'queryParamsHandling',\r\n        'state',\r\n        'relativeTo',\r\n        'skipLocationChange',\r\n        'replaceUrl',\r\n      ],\r\n    },\r\n  ],\r\n})\r\nexport class LinkDirective {\r\n  private readonly routerLink =\r\n    inject(RouterLink, {\r\n      self: true,\r\n      optional: true,\r\n    }) ?? inject(RouterLinkWithHref, { self: true, optional: true });\r\n\r\n  private readonly preloader = injectPreloader();\r\n  readonly target = input<string>();\r\n  readonly queryParams = input<Params>();\r\n  readonly fragment = input<string>();\r\n  readonly queryParamsHandling = input<'merge' | 'preserve' | ''>();\r\n  readonly state = input<Record<string, any>>();\r\n  readonly info = input<unknown>();\r\n  readonly relativeTo = input<ActivatedRoute>();\r\n  readonly skipLocationChange = input(false, { transform: booleanAttribute });\r\n  readonly replaceUrl = input(false, { transform: booleanAttribute });\r\n  readonly mmLink = input.required<string | any[] | UrlTree>();\r\n  readonly preloadOn = input<null | 'hover' | 'visible'>(null);\r\n\r\n  protected onHover() {\r\n    if (untracked(this.preloadOn) !== 'hover') return;\r\n    if (!this.preloader) {\r\n      if (isDevMode())\r\n        console.error(\r\n          'Preloader not available, please configure a preloading strategy',\r\n        );\r\n      return;\r\n    }\r\n\r\n    this.preloader?.preload().subscribe();\r\n  }\r\n\r\n  protected onVisible() {\r\n    if (untracked(this.preloadOn) !== 'visible') return;\r\n    if (!this.preloader) {\r\n      if (isDevMode())\r\n        console.error(\r\n          'Preloader not available, please configure a preloading strategy',\r\n        );\r\n      return;\r\n    }\r\n  }\r\n\r\n  constructor() {\r\n    const el = inject<ElementRef<HTMLElement>>(ElementRef, {\r\n      self: true,\r\n    });\r\n    const unsub = inject(VisibleLinkHandler).register(\r\n      el.nativeElement,\r\n      (() => {\r\n        this.onVisible();\r\n      }).bind(this),\r\n    );\r\n\r\n    inject(DestroyRef).onDestroy(() => unsub());\r\n  }\r\n\r\n  onClick(\r\n    button: number,\r\n    ctrlKey: boolean,\r\n    shiftKey: boolean,\r\n    altKey: boolean,\r\n    metaKey: boolean,\r\n  ) {\r\n    return this.routerLink?.onClick(button, ctrlKey, shiftKey, altKey, metaKey);\r\n  }\r\n}\r\n","import {\n  computed,\n  inject,\n  isSignal,\n  untracked,\n  type WritableSignal,\n} from '@angular/core';\nimport { toSignal } from '@angular/core/rxjs-interop';\nimport { ActivatedRoute, Router } from '@angular/router';\nimport { toWritable } from '@mmstack/primitives';\n\n/**\n * Creates a WritableSignal that synchronizes with a specific URL query parameter,\n * enabling two-way binding between the signal's state and the URL.\n *\n * Reading the signal provides the current value of the query parameter (or null if absent).\n * Setting the signal updates the URL query parameter using `Router.navigate`, triggering\n * navigation and causing the signal to update reactively if the navigation is successful.\n *\n * @param key The key of the query parameter to synchronize with.\n * Can be a static string (e.g., `'search'`) or a function/signal returning a string\n * for dynamic keys (e.g., `() => this.userId() + '_filter'` or `computed(() => this.category() + '_sort')`).\n * The signal will reactively update if the key returned by the function/signal changes.\n * @returns {WritableSignal<string | null>} A signal representing the query parameter's value.\n * - Reading returns the current value string, or `null` if the parameter is absent in the URL.\n * - Setting the signal to a string updates the query parameter in the URL (e.g., `signal.set('value')` results in `?key=value`).\n * - Setting the signal to `null` removes the query parameter from the URL (e.g., `signal.set(null)` results in `?otherParam=...`).\n * - Automatically reflects changes if the query parameters update due to external navigation.\n * @remarks\n * - Requires Angular's `ActivatedRoute` and `Router` to be available in the injection context.\n * - Uses `Router.navigate` with `queryParamsHandling: 'merge'` to preserve other existing query parameters during updates.\n * - Handles dynamic keys reactively. If the result of the `key` function/signal changes, the signal will start reflecting the value of the *new* query parameter key.\n * - During Server-Side Rendering (SSR), it reads the initial value from the route snapshot. Write operations (`set`) might have limited or no effect on the server depending on the platform configuration.\n *\n * @example\n * ```ts\n * import { Component, computed, effect, signal } from '@angular/core';\n * import { queryParam } from '@mmstack/router-core'; // Adjust import path as needed\n * // import { FormsModule } from '@angular/forms'; // If using ngModel\n *\n * @Component({\n * selector: 'app-product-list',\n * standalone: true,\n * // imports: [FormsModule], // If using ngModel\n * template: `\n * <div>\n * Sort By:\n * <select [value]=\"sortSignal() ?? ''\" (change)=\"sortSignal.set($any($event.target).value || null)\">\n * <option value=\"\">Default</option>\n * <option value=\"price_asc\">Price Asc</option>\n * <option value=\"price_desc\">Price Desc</option>\n * <option value=\"name\">Name</option>\n * </select>\n * <button (click)=\"sortSignal.set(null)\" [disabled]=\"!sortSignal()\">Clear Sort</button>\n * </div>\n * <div>\n * Page:\n * <input type=\"number\" min=\"1\" [value]=\"pageSignal() ?? '1'\" #p (input)=\"setPage(p.value)\"/>\n * </div>\n * * `\n * })\n * export class ProductListComponent {\n * // Two-way bind the 'sort' query parameter (?sort=...)\n * // Defaults to null if param is missing\n * sortSignal = queryParam('sort');\n *\n * // Example with a different type (needs serialization or separate logic)\n * // For simplicity, we treat page as string | null here\n * pageSignal = queryParam('page');\n *\n * constructor() {\n * effect(() => {\n * const currentSort = this.sortSignal();\n * const currentPage = this.pageSignal(); // Read as string | null\n * console.log('Sort/Page changed, reloading products for:', { sort: currentSort, page: currentPage });\n * // --- Fetch data based on currentSort and currentPage ---\n * });\n * }\n *\n * setPage(value: string): void {\n * const pageNum = parseInt(value, 10);\n * // Set to null if page is 1 (to remove param), otherwise set string value\n * this.pageSignal.set(isNaN(pageNum) || pageNum <= 1 ? null : pageNum.toString());\n * }\n * }\n * ```\n */\nexport function queryParam(\n  key: string | (() => string),\n): WritableSignal<string | null> {\n  const route = inject(ActivatedRoute);\n  const router = inject(Router);\n\n  const keySignal =\n    typeof key === 'string'\n      ? computed(() => key)\n      : isSignal(key)\n        ? key\n        : computed(key);\n\n  const queryParamMap = toSignal(route.queryParamMap, {\n    initialValue: route.snapshot.queryParamMap,\n  });\n\n  const queryParams = toSignal(route.queryParams, {\n    initialValue: route.snapshot.queryParams,\n  });\n\n  const queryParam = computed(() => queryParamMap().get(keySignal()));\n\n  const set = (newValue: string | null) => {\n    const next = {\n      ...untracked(queryParams),\n    };\n    const key = untracked(keySignal);\n\n    if (newValue === null) {\n      delete next[key];\n    } else {\n      next[key] = newValue;\n    }\n\n    router.navigate([], {\n      relativeTo: route,\n      queryParams: next,\n      queryParamsHandling: 'merge',\n    });\n  };\n\n  return toWritable(queryParam, set);\n}\n","import { inject, type Signal } from '@angular/core';\nimport { toSignal } from '@angular/core/rxjs-interop';\nimport {\n  type Event,\n  EventType,\n  type NavigationEnd,\n  Router,\n} from '@angular/router';\nimport { filter, map } from 'rxjs/operators';\n\n/**\n * Type guard to check if a Router Event is a NavigationEnd event.\n * @internal\n */\nfunction isNavigationEnd(e: Event): e is NavigationEnd {\n  return 'type' in e && e.type === EventType.NavigationEnd;\n}\n\n/**\n * Creates a Signal that tracks the current router URL.\n *\n * The signal emits the URL string reflecting the router state *after* redirects\n * have completed for each successful navigation. It initializes with the router's\n * current URL state.\n *\n * @returns {Signal<string>} A Signal emitting the `urlAfterRedirects` upon successful navigation.\n *\n * @example\n * ```ts\n * import { Component, effect } from '@angular/core';\n * import { url } from '@mmstack/router-core'; // Adjust import path\n *\n * @Component({\n * selector: 'app-root',\n * template: `Current URL: {{ currentUrl() }}`\n * })\n * export class AppComponent {\n * currentUrl = url();\n *\n * constructor() {\n * effect(() => {\n * console.log('Navigation ended. New URL:', this.currentUrl());\n * // e.g., track page view with analytics\n * });\n * }\n * }\n * ```\n */\nexport function url(): Signal<string> {\n  const router = inject(Router);\n\n  return toSignal(\n    router.events.pipe(\n      filter(isNavigationEnd),\n      map((e) => e.urlAfterRedirects),\n    ),\n    {\n      initialValue: router.url,\n    },\n  );\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/index.d.ts

@@ -1,2 +1,3 @@
+export * from './lib/preloading/public_api';
 export * from './lib/query-param';
 export * from './lib/url';

package/lib/preloading/flat-routes.d.ts

@@ -0,0 +1,2 @@
+import { Route } from '@angular/router';
+export declare function flattenRoutes(routes: Route[]): Route[];

package/lib/preloading/link.directive.d.ts

@@ -0,0 +1,39 @@
+import { PreloadingStrategy, Route, type ActivatedRoute, type Params, type UrlTree } from '@angular/router';
+import { Observable } from 'rxjs';
+import * as i0 from "@angular/core";
+import * as i1 from "@angular/router";
+export declare function hasSlowConnection(): boolean;
+export declare class PreloadLinkStrategy implements PreloadingStrategy {
+    private readonly routeMap;
+    preload(route: Route, fn: () => Observable<any>): Observable<any>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PreloadLinkStrategy, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<PreloadLinkStrategy>;
+}
+export declare class VisibleLinkHandler {
+    private readonly map;
+    private readonly observer;
+    register(el: Element, onVisible: () => void): () => void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<VisibleLinkHandler, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<VisibleLinkHandler>;
+}
+export declare class LinkDirective {
+    private readonly routerLink;
+    private readonly preloader;
+    readonly target: import("@angular/core").InputSignal<string | undefined>;
+    readonly queryParams: import("@angular/core").InputSignal<Params | undefined>;
+    readonly fragment: import("@angular/core").InputSignal<string | undefined>;
+    readonly queryParamsHandling: import("@angular/core").InputSignal<"" | "merge" | "preserve" | undefined>;
+    readonly state: import("@angular/core").InputSignal<Record<string, any> | undefined>;
+    readonly info: import("@angular/core").InputSignal<unknown>;
+    readonly relativeTo: import("@angular/core").InputSignal<ActivatedRoute | undefined>;
+    readonly skipLocationChange: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    readonly replaceUrl: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    readonly mmLink: import("@angular/core").InputSignal<string | any[] | UrlTree>;
+    readonly preloadOn: import("@angular/core").InputSignal<"hover" | "visible" | null>;
+    protected onHover(): void;
+    protected onVisible(): void;
+    constructor();
+    onClick(button: number, ctrlKey: boolean, shiftKey: boolean, altKey: boolean, metaKey: boolean): boolean | undefined;
+    static ɵfac: i0.ɵɵFactoryDeclaration<LinkDirective, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<LinkDirective, "[mmLink]", ["mmLink"], { "target": { "alias": "target"; "required": false; "isSignal": true; }; "queryParams": { "alias": "queryParams"; "required": false; "isSignal": true; }; "fragment": { "alias": "fragment"; "required": false; "isSignal": true; }; "queryParamsHandling": { "alias": "queryParamsHandling"; "required": false; "isSignal": true; }; "state": { "alias": "state"; "required": false; "isSignal": true; }; "info": { "alias": "info"; "required": false; "isSignal": true; }; "relativeTo": { "alias": "relativeTo"; "required": false; "isSignal": true; }; "skipLocationChange": { "alias": "skipLocationChange"; "required": false; "isSignal": true; }; "replaceUrl": { "alias": "replaceUrl"; "required": false; "isSignal": true; }; "mmLink": { "alias": "mmLink"; "required": true; "isSignal": true; }; "preloadOn": { "alias": "preloadOn"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof i1.RouterLink; inputs: { "routerLink": "mmLink"; "target": "target"; "queryParams": "queryParams"; "fragment": "fragment"; "queryParamsHandling": "queryParamsHandling"; "state": "state"; "relativeTo": "relativeTo"; "skipLocationChange": "skipLocationChange"; "replaceUrl": "replaceUrl"; }; outputs: {}; }]>;
+}

package/lib/preloading/public_api.d.ts

@@ -0,0 +1 @@
+export { LinkDirective, PreloadLinkStrategy } from './link.directive';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mmstack/router-core",
-  "version": "19.0.1",
+  "version": "19.0.2",
   "keywords": [
     "angular",
     "signals",
@@ -19,7 +19,7 @@
     "@angular/core": "^19.2.3",
     "@angular/router": "^19.2.3",
     "rxjs": "~7.8.2",
-    "@mmstack/primitives": "^19.0.5"
+    "@mmstack/primitives": "^19.0.6"
   },
   "sideEffects": false,
   "module": "fesm2022/mmstack-router-core.mjs",