white-label-router 1.1.2 → 4.0.0

package/dist/index.js

@@ -1,351 +1,267 @@
-(function (global, factory) {
-    if (typeof define === "function" && define.amd) {
-        define(['module', 'gator'], factory);
-    } else if (typeof exports !== "undefined") {
-        factory(module, require('gator'));
-    } else {
-        var mod = {
-            exports: {}
+"use strict";
+/** History API router with ordered path-boundary matching. */
+class Router {
+    routes;
+    url;
+    route;
+    scope;
+    previousRoute;
+    pageTitle;
+    mediator;
+    boundPushStateClick;
+    boundPopState;
+    boundMediatorNavigate;
+    listenersInitialized;
+    locationData = { url: '', data: { url: [], mediator: undefined, query: {} } };
+    /**
+     * Create an instance with its own state and listener references.
+     */
+    constructor() {
+        // placeholder for routes defined when extended
+        this.routes = {
+            defaultRoute: {
+                view: {
+                    initialize: () => {
+                        return true;
+                    },
+                    destroy: () => {
+                        return true;
+                    }
+                }
+            }
         };
-        factory(mod, global.gator);
-        global.index = mod.exports;
-    }
-})(this, function (module, _gator) {
-    'use strict';
-
-    var _gator2 = _interopRequireDefault(_gator);
-
-    function _interopRequireDefault(obj) {
-        return obj && obj.__esModule ? obj : {
-            default: obj
+        // this will hold the current url
+        this.url = '';
+        // this holds the current route
+        this.route = null;
+        // can house a container for the router to act upon
+        this.scope = null;
+        // this holds the previous route for destorying later
+        this.previousRoute = null;
+        // this will hold the page title (not yet supported by browsers)
+        this.pageTitle = null;
+        // optional mediator placeholder
+        this.mediator = false;
+        // Stable listener references allow destroy() to release browser resources.
+        this.boundPushStateClick = this.eventPushStateClick.bind(this);
+        this.boundPopState = this.eventPopState.bind(this);
+        this.boundMediatorNavigate = (data = {}) => {
+            this.navigate(data.url, data, false);
         };
+        this.listenersInitialized = false;
     }
-
-    var _typeof = typeof Symbol === "function" && typeof Symbol.iterator === "symbol" ? function (obj) {
-        return typeof obj;
-    } : function (obj) {
-        return obj && typeof Symbol === "function" && obj.constructor === Symbol ? "symbol" : typeof obj;
-    };
-
-    function _classCallCheck(instance, Constructor) {
-        if (!(instance instanceof Constructor)) {
-            throw new TypeError("Cannot call a class as a function");
+    /**
+     * Start this instance and return it for lifecycle chaining.
+     * @returns This instance for chaining.
+     */
+    initialize() {
+        //get the url fragment w/query string
+        this.url = window.location.pathname + window.location.search;
+        // set up the events
+        this.addListeners();
+        // navigate to correct view
+        this.navigate(false, {}, false);
+        return this;
+    }
+    /**
+     * Register stable document, history, and optional mediator handlers once.
+     * @returns This instance for chaining.
+     */
+    addListeners() {
+        if (this.listenersInitialized) {
+            return this;
+        }
+        // Delegate push-state links from one document listener.
+        document.addEventListener('click', this.boundPushStateClick);
+        //bind window popstates
+        window.addEventListener('popstate', this.boundPopState);
+        //listen to a mediator if present
+        if (this.mediator) {
+            this.mediator.on('router:navigate', this.boundMediatorNavigate);
         }
+        this.listenersInitialized = true;
+        return this;
     }
-
-    var _createClass = function () {
-        function defineProperties(target, props) {
-            for (var i = 0; i < props.length; i++) {
-                var descriptor = props[i];
-                descriptor.enumerable = descriptor.enumerable || false;
-                descriptor.configurable = true;
-                if ("value" in descriptor) descriptor.writable = true;
-                Object.defineProperty(target, descriptor.key, descriptor);
-            }
+    /**
+     * Release owned state and listeners so the instance can leave the application lifecycle.
+     * @returns This instance after cleanup.
+     */
+    destroy() {
+        this.removeListeners();
+        return this;
+    }
+    /**
+     * Release listeners owned by this instance; subclasses may extend the lifecycle hook.
+     * @returns This instance for chaining.
+     */
+    removeListeners() {
+        if (!this.listenersInitialized) {
+            return this;
+        }
+        // Unbind the same stable listener objects registered by addListeners().
+        document.removeEventListener('click', this.boundPushStateClick);
+        //bind window popstates
+        window.removeEventListener('popstate', this.boundPopState);
+        if (this.mediator && typeof this.mediator.removeListener === 'function') {
+            this.mediator.removeListener('router:navigate', this.boundMediatorNavigate);
+        }
+        this.listenersInitialized = false;
+        return this;
+    }
+    /**
+     * Intercept eligible same-origin push-state links while preserving normal browser actions.
+     * @param e - Browser event being handled.
+     * @returns True when the browser should handle the event, or this router after interception.
+     */
+    eventPushStateClick(e) {
+        if (e.defaultPrevented ||
+            (e.button !== undefined && e.button !== 0) ||
+            e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) {
+            return true;
+        }
+        const eventTarget = e.target;
+        const source = eventTarget && (typeof eventTarget.closest === 'function' ? eventTarget : eventTarget.parentElement);
+        const anchor = source && typeof source.closest === 'function'
+            ? source.closest('a[href][data-pushstate]')
+            : null;
+        if (!anchor) {
+            return true;
+        }
+        const target = anchor.getAttribute('target');
+        if (anchor.hasAttribute('download') ||
+            (target && target.toLowerCase() !== '_self')) {
+            return true;
+        }
+        const location = new URL(anchor.getAttribute('href') || '', window.location.href || `${window.location.origin}/`);
+        if (location.origin !== window.location.origin) {
+            return true;
         }
-
-        return function (Constructor, protoProps, staticProps) {
-            if (protoProps) defineProperties(Constructor.prototype, protoProps);
-            if (staticProps) defineProperties(Constructor, staticProps);
-            return Constructor;
+        e.preventDefault();
+        // closest() supports nested elements at any depth inside the selected anchor.
+        this.url = `${location.pathname}${location.search}${location.hash}`;
+        this.navigate(false, {}, false);
+        return this;
+    }
+    /**
+     * Restore browser history state without adding a new history entry.
+     * @param e - Browser event being handled.
+     * @returns This router after restoring the history state.
+     */
+    eventPopState(e) {
+        this.url = (e.state || '');
+        this.navigate(false, {}, true);
+        return this;
+    }
+    /**
+     * Decode URL query parameters, keeping the last value for duplicate keys.
+     * @param queryString - Encoded URL query portion.
+     * @returns A record of decoded query names and their final values.
+     */
+    parseQueryString(queryString) {
+        return Object.fromEntries(new URLSearchParams(queryString));
+    }
+    /**
+     * Build decoded path, query, and mediator data for the selected route.
+     * @param mediatorData - Optional caller metadata passed to the route.
+     * @returns No value; locationData is updated in place.
+     */
+    setLocationData(mediatorData) {
+        const parsedUrl = new URL(this.url, window.location.origin);
+        const matchedRoute = this.route && this.route !== 'defaultRoute' ? this.route : '';
+        // this is the object passed to the matching view
+        this.locationData = {
+            url: this.url,
+            data: {
+                url: [],
+                mediator: mediatorData,
+                query: {}
+            }
         };
-    }();
-
-    (function () {
-
-        'use strict';
-
-        module.exports = function () {
-            function _class() {
-                _classCallCheck(this, _class);
-
-                // placeholder for routes defined when extended
-                this.routes = {
-                    defaultRoute: {
-                        view: {
-                            initialize: function initialize() {
-                                return true;
-                            },
-                            destroy: function destroy() {
-                                return true;
-                            }
-                        }
-                    }
-                };
-
-                // this will hold the current url
-                this.url = '';
-
-                // this holds the current route
-                this.route = null;
-
-                // can house a container for the router to act upon
-                this.scope = null;
-
-                // this holds the previous route for destorying later
-                this.previousRoute = null;
-
-                // this will hold the page title (not yet supported by browsers)
-                this.pageTitle = null;
-
-                // optional mediator placeholder
-                this.mediator = false;
+        // parse out the url data
+        this.locationData.data.url = parsedUrl.pathname
+            .slice(matchedRoute.length)
+            .split('/')
+            .filter(Boolean)
+            .map((fragment) => {
+            try {
+                return decodeURIComponent(fragment);
             }
-
-            _createClass(_class, [{
-                key: 'initialize',
-                value: function initialize() {
-
-                    // set orgin if not supported by the browser
-                    if (!window.location.origin) {
-                        window.location.origin = window.location.protocol + '//' + window.location.hostname + (window.location.port ? ':' + window.location.port : '');
-                    }
-
-                    //get the url fragment w/query string
-                    this.url = window.location.pathname + (window.location.search || '') || '';
-
-                    // set up the events
-                    this.addListeners();
-
-                    // navigate to correct view
-                    this.navigate(false, {}, false);
-
-                    return this;
-                }
-            }, {
-                key: 'addListeners',
-                value: function addListeners() {
-                    var _this = this;
-
-                    //bind all pushstate links
-                    (0, _gator2.default)(document).on('click', 'a[href][data-pushstate]', this.eventPushStateClick.bind(this));
-
-                    //bind window popstates
-                    window.addEventListener('popstate', this.eventPopState.bind(this));
-
-                    //listen to a mediator if present
-                    if (this.mediator) {
-
-                        this.mediator.on('router:navigate', function (data) {
-                            _this.navigate(data.url, data || {}, false);
-                        });
-                    }
-
-                    return this;
-                }
-            }, {
-                key: 'destroy',
-                value: function destroy() {
-
-                    this.removeListeners();
-
-                    return this;
-                }
-            }, {
-                key: 'removeListeners',
-                value: function removeListeners() {
-
-                    //unbind all pushstate links
-                    (0, _gator2.default)(document).off('click', 'a[href][data-pushstate]');
-
-                    //bind window popstates
-                    window.removeEventListener('popstate', this.eventPopState.bind(this));
-
-                    return this;
-                }
-            }, {
-                key: 'eventPushStateClick',
-                value: function eventPushStateClick(e) {
-
-                    e.preventDefault();
-
-                    //for example an image tag can initiate a click event in side an anchor
-                    if (e.target.tagName === 'A') {
-                        this.url = e.target.getAttribute('href') || '';
-                    } else {
-                        this.url = e.target.parentNode.getAttribute('href') || '';
-                    }
-
-                    this.navigate(false, {}, false);
-
-                    return this;
-                }
-            }, {
-                key: 'eventPopState',
-                value: function eventPopState(e) {
-
-                    this.url = e.state || '';
-
-                    this.navigate(false, {}, true);
-
-                    return this;
-                }
-            }, {
-                key: 'parseQueryString',
-                value: function parseQueryString(queryString) {
-
-                    var params = {};
-                    var queries = void 0;
-                    var temp = void 0;
-                    var i = void 0;
-                    var l = void 0;
-
-                    // Split into key/value pairs
-                    queries = queryString.split('&amp;');
-
-                    // Convert the array of strings into an object
-                    for (i = 0, l = queries.length; i < l; i++) {
-                        temp = queries[i].split('=');
-                        params[temp[0]] = temp[1];
-                    }
-
-                    return params;
-                }
-            }, {
-                key: 'setLocationData',
-                value: function setLocationData(mediatorData) {
-
-                    //split the url here to seperate query strings from url path
-                    var urlFragments = this.url.split('?');
-
-                    // this is the object passed to the matching view
-                    this.locationData = {
-                        url: this.url,
-                        data: {
-                            url: [],
-                            mediator: mediatorData,
-                            query: {}
-                        }
-                    };
-
-                    // parse out the url data
-                    this.locationData.data.url = urlFragments[0].replace(this.route, '').split('/');
-                    this.locationData.data.url.splice(0, 1);
-
-                    // remove any trailing empty items from the array
-                    if (this.locationData.data.url.length && this.locationData.data.url[this.locationData.data.url.length - 1] === '') {
-                        this.locationData.data.url.splice(this.locationData.data.url.length - 1, 1);
-                    }
-
-                    //add query string data
-                    if (urlFragments[1]) {
-                        this.locationData.data.query = this.parseQueryString(urlFragments[1].replace('?', ''));
-                    }
-                }
-            }, {
-                key: 'navigate',
-                value: function navigate(url, mediatorData, isPopState) {
-
-                    // allow navigate to use a specified url
-                    if (url) {
-                        this.url = url;
-                    }
-
-                    //clean up url for matching
-                    this.url = this.url.replace(window.location.origin, '');
-
-                    // reset this to null for new location
-                    this.route = null;
-
-                    //find the first matcher that starts with the same string as a defined route
-                    for (var route in this.routes) {
-
-                        // we have a match
-                        if (this.url.lastIndexOf(route, 0) === 0) {
-
-                            this.route = route;
-
-                            //stop looping we are done
-                            break;
-                        }
-                    }
-
-                    this.setLocationData(mediatorData);
-
-                    // if a catch all default route is defined execute that when not match is found
-                    if (!this.route && this.routes.defaultRoute) {
-
-                        this.route = 'defaultRoute';
-                    }
-
-                    if (this.route) {
-
-                        // check if the page is secure and if the user passes the specified secure checking function
-                        if (typeof this.routes[this.route].secure === 'function' && this.routes[this.route].secure(this.scope, this.locationData) !== true) {
-                            return false;
-                        }
-
-                        //if previous route then destroy it
-                        if (this.previousRoute) {
-
-                            // else if it is an object check if there is a view class
-                            if (_typeof(this.routes[this.previousRoute]) === 'object' && _typeof(this.routes[this.previousRoute].view) === 'object' && typeof this.routes[this.previousRoute].view.destroy === 'function') {
-
-                                //destroy the view
-                                this.routes[this.previousRoute].view.destroy(this.scope, this.locationData);
-                            }
-                        }
-
-                        //execute the route if it is a simple function
-                        if (typeof this.routes[this.route] === 'function') {
-
-                            //execute the view
-                            this.routes[this.route](this.scope, this.locationData);
-
-                            //cache the old route
-                            this.previousRoute = this.route;
-                        } else if (_typeof(this.routes[this.route]) === 'object' && typeof this.routes[this.route].view === 'function') {
-
-                            //execute the view
-                            this.routes[this.route].view(this.scope, this.locationData);
-
-                            // if a title is defined for this route we'll set it
-                            if (typeof this.routes[this.route].title === 'string') {
-                                this.pageTitle = this.routes[this.route].title;
-                            } else {
-                                this.pageTitle = null;
-                            }
-
-                            //cache the old route
-                            this.previousRoute = this.route;
-
-                            // else if it is an object check if there is a view class
-                        } else if (_typeof(this.routes[this.route]) === 'object' && _typeof(this.routes[this.route].view) === 'object' && typeof this.routes[this.route].view.initialize === 'function') {
-
-                                // if a title is defined for this route we'll set it
-                                if (typeof this.routes[this.route].title === 'string') {
-                                    this.pageTitle = this.routes[this.route].title;
-                                } else {
-                                    this.pageTitle = null;
-                                }
-
-                                //execute the view
-                                this.routes[this.route].view.initialize(this.scope, this.locationData);
-
-                                //cache the old route
-                                this.previousRoute = this.route;
-                            } else {
-
-                                return false;
-                            }
-                    }
-
-                    // make sure to not set pushstate on back button click
-                    if (!isPopState) {
-                        //set in history the new url
-                        window.history.pushState(this.url, this.pageTitle, this.url);
-                    }
-
-                    // since browsers don't support setting the title with pushstate yet
-                    if (this.pageTitle) {
-                        document.title = this.pageTitle;
-                    }
-
-                    return this;
-                }
-            }]);
-
-            return _class;
-        }();
-    })();
-});
+            catch (error) {
+                return fragment;
+            }
+        });
+        //add query string data
+        this.locationData.data.query = this.parseQueryString(parsedUrl.search);
+    }
+    /**
+     * Select a route, enforce its guard, transition view lifecycles, and update history and title.
+     * @param url - URL or optional adapter argument.
+     * @param mediatorData - Optional caller metadata passed to the route.
+     * @param isPopState - Whether navigation came from browser history.
+     * @returns False when a guard or route rejects navigation; otherwise this router.
+     */
+    navigate(url, mediatorData, isPopState = false) {
+        // allow navigate to use a specified url
+        if (url) {
+            this.url = url;
+        }
+        //clean up url for matching
+        this.url = this.url.replace(window.location.origin, '');
+        // reset this to null for new location
+        this.route = null;
+        const pathname = new URL(this.url, window.location.origin).pathname;
+        // Match complete path segments so /page2 does not also match /page23.
+        for (let route in this.routes) {
+            if (route !== 'defaultRoute' &&
+                (pathname === route || pathname.startsWith(`${route}/`))) {
+                this.route = route;
+                //stop looping we are done
+                break;
+            }
+        }
+        this.setLocationData(mediatorData);
+        // if a catch all default route is defined execute that when not match is found
+        if (!this.route && this.routes.defaultRoute) {
+            this.route = 'defaultRoute';
+        }
+        if (this.route) {
+            const selected = this.routes[this.route];
+            if (typeof selected !== 'function' && selected.secure &&
+                selected.secure(this.scope, this.locationData) !== true) {
+                return false;
+            }
+            const previous = this.previousRoute ? this.routes[this.previousRoute] : undefined;
+            if (previous && typeof previous !== 'function' && typeof previous.view === 'object' && previous.view.destroy) {
+                previous.view.destroy(this.scope, this.locationData);
+            }
+            if (typeof selected === 'function') {
+                selected(this.scope, this.locationData);
+            }
+            else if (typeof selected.view === 'function') {
+                selected.view(this.scope, this.locationData);
+                this.pageTitle = typeof selected.title === 'string' ? selected.title : null;
+            }
+            else if (selected.view && typeof selected.view.initialize === 'function') {
+                this.pageTitle = typeof selected.title === 'string' ? selected.title : null;
+                selected.view.initialize(this.scope, this.locationData);
+            }
+            else {
+                return false;
+            }
+            this.previousRoute = this.route;
+        }
+        // make sure to not set pushstate on back button click
+        if (!isPopState) {
+            //set in history the new url
+            window.history.pushState(this.url, this.pageTitle || '', this.url);
+        }
+        // since browsers don't support setting the title with pushstate yet
+        if (this.pageTitle) {
+            document.title = this.pageTitle;
+        }
+        return this;
+    }
+}
+;
+module.exports = Router;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["/** Navigation payload, including caller-defined metadata. */\ninterface NavigationData {url?: string; [key: string]: unknown}\n/** URL-derived values supplied to route handlers. */\ninterface LocationData {url: string; data: {url: string[]; mediator: NavigationData | undefined; query: Record<string, string>}}\ntype RouteHandler = (scope: Element | null, location: LocationData) => unknown;\n/** An object route can own a function or a view lifecycle. */\ninterface RouteObject {title?: string; secure?: RouteHandler; view?: RouteHandler | {initialize?: RouteHandler; destroy?: RouteHandler}}\ntype Route = RouteHandler | RouteObject;\n/** Minimal event-bus contract required by the router. */\ninterface NavigationMediator {\n    on(event: string, callback: (data?: NavigationData) => unknown): unknown;\n    removeListener?(event: string, callback: (data?: NavigationData) => unknown): unknown;\n}\n/** History API router with ordered path-boundary matching. */\nclass Router {\n    routes: Record<string, Route>;\n    url: string;\n    route: string | null;\n    scope: Element | null;\n    previousRoute: string | null;\n    pageTitle: string | null;\n    mediator: NavigationMediator | false;\n    boundPushStateClick: (event: MouseEvent) => unknown;\n    boundPopState: (event: PopStateEvent) => unknown;\n    boundMediatorNavigate: (data?: NavigationData) => unknown;\n    listenersInitialized: boolean;\n    locationData: LocationData = {url: '', data: {url: [], mediator: undefined, query: {}}};\n\n    /**\n     * Create an instance with its own state and listener references.\n     */\n    constructor() {\n\n        // placeholder for routes defined when extended\n        this.routes = {\n            defaultRoute: {\n                view: {\n                    initialize: () => {\n                        return true;\n                    },\n                    destroy: () => {\n                        return true;\n                    }\n                }\n            }\n        }\n\n        // this will hold the current url\n        this.url = '';\n\n        // this holds the current route\n        this.route = null;\n\n        // can house a container for the router to act upon\n        this.scope = null;\n\n        // this holds the previous route for destorying later\n        this.previousRoute = null;\n\n        // this will hold the page title (not yet supported by browsers)\n        this.pageTitle = null;\n\n        // optional mediator placeholder\n        this.mediator = false;\n\n        // Stable listener references allow destroy() to release browser resources.\n        this.boundPushStateClick = this.eventPushStateClick.bind(this);\n        this.boundPopState = this.eventPopState.bind(this);\n        this.boundMediatorNavigate = (data = {}) => {\n            this.navigate(data.url, data, false);\n        };\n        this.listenersInitialized = false;\n\n    }\n\n    /**\n     * Start this instance and return it for lifecycle chaining.\n     * @returns This instance for chaining.\n     */\n    initialize() {\n\n        //get the url fragment w/query string\n        this.url = window.location.pathname + window.location.search;\n\n        // set up the events\n        this.addListeners();\n\n        // navigate to correct view\n        this.navigate(false, {}, false);\n\n        return this;\n\n    }\n\n    /**\n     * Register stable document, history, and optional mediator handlers once.\n     * @returns This instance for chaining.\n     */\n    addListeners() {\n\n        if (this.listenersInitialized) {\n            return this;\n        }\n\n        // Delegate push-state links from one document listener.\n        document.addEventListener('click', this.boundPushStateClick);\n\n        //bind window popstates\n        window.addEventListener('popstate', this.boundPopState);\n\n        //listen to a mediator if present\n        if (this.mediator) {\n            this.mediator.on('router:navigate', this.boundMediatorNavigate);\n        }\n\n        this.listenersInitialized = true;\n        return this;\n\n    }\n\n    /**\n     * Release owned state and listeners so the instance can leave the application lifecycle.\n     * @returns This instance after cleanup.\n     */\n    destroy() {\n\n        this.removeListeners();\n\n        return this;\n\n    }\n\n    /**\n     * Release listeners owned by this instance; subclasses may extend the lifecycle hook.\n     * @returns This instance for chaining.\n     */\n    removeListeners() {\n\n        if (!this.listenersInitialized) {\n            return this;\n        }\n\n        // Unbind the same stable listener objects registered by addListeners().\n        document.removeEventListener('click', this.boundPushStateClick);\n\n        //bind window popstates\n        window.removeEventListener('popstate', this.boundPopState);\n\n        if (this.mediator && typeof this.mediator.removeListener === 'function') {\n            this.mediator.removeListener('router:navigate', this.boundMediatorNavigate);\n        }\n\n        this.listenersInitialized = false;\n        return this;\n\n    }\n\n    /**\n     * Intercept eligible same-origin push-state links while preserving normal browser actions.\n     * @param e - Browser event being handled.\n     * @returns True when the browser should handle the event, or this router after interception.\n     */\n    eventPushStateClick(e: MouseEvent) {\n\n        if (\n            e.defaultPrevented ||\n            (e.button !== undefined && e.button !== 0) ||\n            e.metaKey || e.ctrlKey || e.shiftKey || e.altKey\n        ) {\n            return true;\n        }\n\n        const eventTarget = e.target as Element | null;\n        const source = eventTarget && (\n            typeof eventTarget.closest === 'function' ? eventTarget : eventTarget.parentElement\n        );\n        const anchor = source && typeof source.closest === 'function'\n            ? source.closest('a[href][data-pushstate]')\n            : null;\n        if (!anchor) {\n            return true;\n        }\n\n        const target = anchor.getAttribute('target');\n        if (\n            anchor.hasAttribute('download') ||\n            (target && target.toLowerCase() !== '_self')\n        ) {\n            return true;\n        }\n\n        const location = new URL(\n            anchor.getAttribute('href') || '',\n            window.location.href || `${window.location.origin}/`\n        );\n        if (location.origin !== window.location.origin) {\n            return true;\n        }\n\n        e.preventDefault();\n\n        // closest() supports nested elements at any depth inside the selected anchor.\n        this.url = `${location.pathname}${location.search}${location.hash}`;\n\n        this.navigate(false, {}, false);\n\n        return this;\n\n    }\n\n    /**\n     * Restore browser history state without adding a new history entry.\n     * @param e - Browser event being handled.\n     * @returns This router after restoring the history state.\n     */\n    eventPopState(e: PopStateEvent) {\n\n        this.url = (e.state || '');\n\n        this.navigate(false, {}, true);\n\n        return this;\n\n    }\n\n    /**\n     * Decode URL query parameters, keeping the last value for duplicate keys.\n     * @param queryString - Encoded URL query portion.\n     * @returns A record of decoded query names and their final values.\n     */\n    parseQueryString(queryString: string) {\n        return Object.fromEntries(new URLSearchParams(queryString));\n\n    }\n\n    /**\n     * Build decoded path, query, and mediator data for the selected route.\n     * @param mediatorData - Optional caller metadata passed to the route.\n     * @returns No value; locationData is updated in place.\n     */\n    setLocationData(mediatorData?: NavigationData) {\n\n        const parsedUrl = new URL(this.url, window.location.origin);\n        const matchedRoute = this.route && this.route !== 'defaultRoute' ? this.route : '';\n\n        // this is the object passed to the matching view\n        this.locationData = {\n            url: this.url,\n            data: {\n                url: [],\n                mediator: mediatorData,\n                query: {}\n            }\n        };\n\n        // parse out the url data\n        this.locationData.data.url = parsedUrl.pathname\n            .slice(matchedRoute.length)\n            .split('/')\n            .filter(Boolean)\n            .map((fragment) => {\n                try {\n                    return decodeURIComponent(fragment);\n                } catch (error) {\n                    return fragment;\n                }\n            });\n\n        //add query string data\n        this.locationData.data.query = this.parseQueryString(parsedUrl.search);\n\n    }\n\n    /**\n     * Select a route, enforce its guard, transition view lifecycles, and update history and title.\n     * @param url - URL or optional adapter argument.\n     * @param mediatorData - Optional caller metadata passed to the route.\n     * @param isPopState - Whether navigation came from browser history.\n     * @returns False when a guard or route rejects navigation; otherwise this router.\n     */\n    navigate(url?: string | false, mediatorData?: NavigationData, isPopState = false) {\n\n        // allow navigate to use a specified url\n        if (url) {\n            this.url = url;\n        }\n\n        //clean up url for matching\n        this.url = this.url.replace(window.location.origin, '');\n\n        // reset this to null for new location\n        this.route = null;\n\n        const pathname = new URL(this.url, window.location.origin).pathname;\n\n        // Match complete path segments so /page2 does not also match /page23.\n        for (let route in this.routes) {\n\n            if (\n                route !== 'defaultRoute' &&\n                (pathname === route || pathname.startsWith(`${route}/`))\n            ) {\n\n                this.route = route;\n\n                //stop looping we are done\n                break;\n\n            }\n\n        }\n\n        this.setLocationData(mediatorData);\n\n        // if a catch all default route is defined execute that when not match is found\n        if (!this.route && this.routes.defaultRoute) {\n\n            this.route = 'defaultRoute';\n\n        }\n\n        if (this.route) {\n            const selected = this.routes[this.route];\n            if (typeof selected !== 'function' && selected.secure &&\n                selected.secure(this.scope, this.locationData) !== true) {\n                return false;\n            }\n            const previous = this.previousRoute ? this.routes[this.previousRoute] : undefined;\n            if (previous && typeof previous !== 'function' && typeof previous.view === 'object' && previous.view.destroy) {\n                previous.view.destroy(this.scope, this.locationData);\n            }\n            if (typeof selected === 'function') {\n                selected(this.scope, this.locationData);\n            } else if (typeof selected.view === 'function') {\n                selected.view(this.scope, this.locationData);\n                this.pageTitle = typeof selected.title === 'string' ? selected.title : null;\n            } else if (selected.view && typeof selected.view.initialize === 'function') {\n                this.pageTitle = typeof selected.title === 'string' ? selected.title : null;\n                selected.view.initialize(this.scope, this.locationData);\n            } else {\n                return false;\n            }\n            this.previousRoute = this.route;\n        }\n\n        // make sure to not set pushstate on back button click\n        if (!isPopState) {\n            //set in history the new url\n            window.history.pushState(this.url, this.pageTitle || '', this.url);\n        }\n\n        // since browsers don't support setting the title with pushstate yet\n        if (this.pageTitle) {\n            document.title = this.pageTitle;\n        }\n\n        return this;\n\n    }\n\n};\n\n\n/** Public route configuration and navigation payload types. */\nnamespace Router {\n    export type Handler = RouteHandler;\n    export type Route = RouteHandler | RouteObject;\n    export type Location = LocationData;\n    export type Navigation = NavigationData;\n}\nexport = Router;\n"]}