breeze-router 0.2.1 → 0.3.0

package/README.md

@@ -1,7 +1,9 @@
 # Breeze Router
+
 A lightweight, zero-dependency client-side router for single page applications (SPAs).
 
 **Note: This project is not production ready and is still in development.**
+
 ## Installation
 
 To use this router in your project, install the router using npm:
@@ -15,21 +17,22 @@ npm install breeze-router
 To use the router in your application, you need to import `BreezeRouter` and define routes and handlers using the `Router` class:
 
 ```javascript
-import BeezeRouter from 'breeze-router';
+import BeezeRouter from "breeze-router";
 
 // Create a new `BreezeRouter` instance.
 const ROUTER = new BreezeRouter();
 
 // Define routes using the `add()` method.
-ROUTER.add('/', async () => {
+ROUTER.add("/", async () => {
   // Handle the root route
 });
 
-ROUTER.add('/about', async () => {
-  // Handle the about route
+ROUTER.add("/about", async ({ route, params }) => {
+  // Handle the about route.
+  // route.path equals to current route with a trailing splash, e.g.: /about/
 });
 
-ROUTER.add('/users/:userId', async ({ route, params }) => {
+ROUTER.add("/users/:userId", async ({ route, params }) => {
   // Handle the users route with a dynamic parameter :userId
   const userId = params.userId;
 });
@@ -48,7 +51,11 @@ ROUTER.start();
 ### `toggleParam(this, 1)`
 
 ```html
-<input type="checkbox" name="freelance" onclick="window.ROUTER.toggleParam(this, 1)">
+<input
+  type="checkbox"
+  name="freelance"
+  onclick="window.ROUTER.toggleParam(this, 1)"
+/>
 ```
 
 If checked, then it will append search params to url like this: `localhost/users?freelance=1`, if you click checkbox again, it will remove that search param from url.

package/dist/BreezeRouter.js

@@ -6,6 +6,7 @@
  * @returns {boolean}
  */
 const isFunction = (fn) => {
+  if (!fn) return false;
   return fn.constructor.name.toLowerCase() === "function";
 };
 
@@ -15,17 +16,19 @@ const isFunction = (fn) => {
  * @returns {boolean}
  */
 const isAsyncFunction = (fn) => {
+  if (!fn) return false;
   return fn.constructor.name.toLowerCase() === "asyncfunction";
 };
 
 /**
- * Remove trailing slash of a give url
+ * Add trailing slash of a given url.
  * @param {string} url
  * @returns {string}
  */
-const removeTrailingSlash = (url) => {
-  if (url.endsWith("/")) {
-    url = url.replace(/\/$/, "");
+const addTrailingSlash = (url) => {
+  url = url.trim();
+  if (!url.endsWith("/")) {
+    url = url + "/";
   }
 
   return url;
@@ -93,24 +96,38 @@ const shouldRouterHandleClick = (e, anchor) => {
  * Class representing a router.
  */
 class BreezeRouter {
+  /**
+   * `data-` attribute to allow users to skip the router behavior,
+   * anchor link with this attribute set will behavior as normal link.
+   * @type {string}
+   */
+  #ignoreAttribute = "data-breeze-ignore";
+
   /**
    * Creates a new BreezeRouter instance.
+   * @param {object} config - Config.
    * @constructor
    */
-  constructor() {
+  constructor(config) {
+    const { ignoreAttribute } = config || {};
+
+    if (ignoreAttribute) {
+      this.#ignoreAttribute = ignoreAttribute;
+    }
+
     /**
      * Object containing all registered routes.
-     * @type {import('./types.js').Route}
+     * @type {object}
      * @private
      */
     this._routes = {};
 
     /**
      * The previous route that was navigated to
-     * @type {import('./types.js').Route}
+     * @type {import('./types.js').Route|null}
      * @private
      */
-    this._previousRoute = {};
+    this._previousRoute = null;
 
     // Bind event listeners
     window.addEventListener("popstate", this._onChanged.bind(this));
@@ -134,7 +151,7 @@ class BreezeRouter {
   add(route, handler) {
     route = route.trim();
     if (route !== "/") {
-      route = removeTrailingSlash(route.trim());
+      route = addTrailingSlash(route);
     }
 
     if (this._routes[route]) {
@@ -142,7 +159,7 @@ class BreezeRouter {
     }
 
     if (typeof handler !== "function") {
-      return console.error(`handler on route '${route}' is not a function.`);
+      return console.error(`handler of route '${route}' must be a function.`);
     }
 
     this._routes[route] = {
@@ -192,11 +209,11 @@ class BreezeRouter {
    * @returns {Promise<void>}
    */
   async _handleRoute({ route, params }) {
-    if (isFunction(route.handler)) {
+    if (isFunction(route?.handler)) {
       route.handler({ route, params });
     }
 
-    if (isAsyncFunction(route.handler)) {
+    if (isAsyncFunction(route?.handler)) {
       await route.handler({ route, params });
     }
   }
@@ -211,7 +228,7 @@ class BreezeRouter {
     const params = {};
 
     if (url !== "/") {
-      url = removeTrailingSlash(url);
+      url = addTrailingSlash(url);
     }
 
     const matchedRoute = Object.keys(this._routes).find((route) => {
@@ -261,6 +278,14 @@ class BreezeRouter {
       return;
     }
 
+    /**
+     * Allow users to define an `data-` attribute to skip the route handling.
+     * Default to `data-breeze-ignore`.
+     */
+    if (anchor.hasAttribute(this.#ignoreAttribute)) {
+      return;
+    }
+
     if (!shouldRouterHandleClick(event, anchor)) {
       return;
     }
@@ -276,13 +301,13 @@ class BreezeRouter {
 
   /**
    * Add or remove search param to current url.
-   * @param {HTMLInputElement} checkbox 
+   * @param {HTMLInputElement} checkbox
    * @param {string} value
    * @returns void
    */
   toggleParam(checkbox, value) {
     const params = new URLSearchParams(location.search);
-    const name = checkbox.getAttribute('name');
+    const name = checkbox.getAttribute("name");
     if (!name) {
       return console.warn(`name attribute is not set on ${checkbox.outerHTML}`);
     }
@@ -291,7 +316,7 @@ class BreezeRouter {
     } else if (!checkbox.checked) {
       params.has(name) && params.delete(name);
     }
-    
+
     const newUrl = !!params.size
       ? `${location.pathname}?${params.toString()}`
       : location.pathname;

package/dist/BreezeRouter.js.map

@@ -1 +1 @@
-{"version":3,"file":"BreezeRouter.js","sources":["../src/utils.js","../src/index.js"],"sourcesContent":["// @ts-check\n\n/**\n * Check if given param is function\n * @param {Function} fn\n * @returns {boolean}\n */\nexport const isFunction = (fn) => {\n  return fn.constructor.name.toLowerCase() === \"function\";\n};\n\n/**\n * Check if given param is async function\n * @param {Function} fn\n * @returns {boolean}\n */\nexport const isAsyncFunction = (fn) => {\n  return fn.constructor.name.toLowerCase() === \"asyncfunction\";\n};\n\n/**\n * Remove trailing slash of a give url\n * @param {string} url\n * @returns {string}\n */\nexport const removeTrailingSlash = (url) => {\n  if (url.endsWith(\"/\")) {\n    url = url.replace(/\\/$/, \"\");\n  }\n\n  return url;\n};\n\n/**\n * Find anchor element from click event.\n * @param {Event} e - The click event.\n * @returns {HTMLAnchorElement|undefined}\n */\nexport const findAnchor = (e) => {\n  return e.composedPath().find((elem) => {\n    return elem.tagName === \"A\";\n  });\n};\n\n/**\n * Check if the router should handle a click event on an anchor element.\n * @param {Event} e - The click event.\n * @param {HTMLAnchorElement} anchor - The anchor element.\n * @returns {boolean} - True if the router should handle the event, false otherwise.\n */\nexport const shouldRouterHandleClick = (e, anchor) => {\n  // If the event has already been handled by another event listener\n  if (e.defaultPrevented) {\n    return false;\n  }\n\n  // If the user is holding down the meta, control, or shift key\n  if (e.metaKey || e.ctrlKey || e.shiftKey) {\n    return false;\n  }\n\n  if (!anchor) {\n    return false;\n  }\n\n  if (anchor.target) {\n    return false;\n  }\n\n  if (\n    anchor.hasAttribute(\"download\") ||\n    anchor.getAttribute(\"rel\") === \"external\"\n  ) {\n    return false;\n  }\n\n  const href = anchor.href;\n  if (!href || href.startsWith(\"mailto:\")) {\n    return false;\n  }\n\n  // If the href attribute does not start with the same origin\n  if (!href.startsWith(location.origin)) {\n    return false;\n  }\n\n  return true;\n};\n","// @ts-check\nimport {\n  isFunction,\n  isAsyncFunction,\n  removeTrailingSlash,\n  findAnchor,\n  shouldRouterHandleClick,\n} from \"./utils.js\";\n\n/**\n * Class representing a router.\n */\nexport default class BreezeRouter {\n  /**\n   * Creates a new BreezeRouter instance.\n   * @constructor\n   */\n  constructor() {\n    /**\n     * Object containing all registered routes.\n     * @type {import('./types.js').Route}\n     * @private\n     */\n    this._routes = {};\n\n    /**\n     * The previous route that was navigated to\n     * @type {import('./types.js').Route}\n     * @private\n     */\n    this._previousRoute = {};\n\n    // Bind event listeners\n    window.addEventListener(\"popstate\", this._onChanged.bind(this));\n    document.body.addEventListener(\"click\", this._handleClick.bind(this));\n  }\n\n  /**\n   * Starts the router.\n   * @returns {void}\n   */\n  start() {\n    this._onChanged();\n  }\n\n  /**\n   * Adds a new route to the router.\n   * @param {string} route - The route path to add.\n   * @param {Function} handler - The async function to handle the route\n   * @returns {BreezeRouter|void} The BreezeRouter instance.\n   */\n  add(route, handler) {\n    route = route.trim();\n    if (route !== \"/\") {\n      route = removeTrailingSlash(route.trim());\n    }\n\n    if (this._routes[route]) {\n      return console.warn(`Route already exists: ${route}`);\n    }\n\n    if (typeof handler !== \"function\") {\n      return console.error(`handler on route '${route}' is not a function.`);\n    }\n\n    this._routes[route] = {\n      path: route,\n      handler,\n    };\n\n    return this;\n  }\n\n  /**\n   * Navigates to the specified URL.\n   * @param {string} url - The URL to navigate to\n   * @returns {void}\n   */\n  navigateTo(url) {\n    window.history.pushState({ url }, \"\", url);\n    this._onChanged();\n  }\n\n  /**\n   * Redirects a URL\n   * @param {string} url\n   * @returns {void}\n   */\n  redirect(url) {\n    this.navigateTo(url);\n  }\n\n  async _onChanged() {\n    const path = window.location.pathname;\n    const { route, params } = this._matchUrlToRoute(path);\n\n    // If no matching route found, route will be '404' route\n    // which has been handled by _matchUrlToRoute already\n    await this._handleRoute({ route, params });\n\n    /**\n     * Update previous route, so application route handler can check and decide if it should re-render whole page.\n     */\n    this._previousRoute = route;\n  }\n\n  /**\n   * Processes route callbacks registered by app\n   * @param {import('./types.js').MatchedRoute} options\n   * @returns {Promise<void>}\n   */\n  async _handleRoute({ route, params }) {\n    if (isFunction(route.handler)) {\n      route.handler({ route, params });\n    }\n\n    if (isAsyncFunction(route.handler)) {\n      await route.handler({ route, params });\n    }\n  }\n\n  /**\n   *\n   * @param {string} url - Current url users visite or nagivate to.\n   * @returns {import('./types.js').MatchedRoute}\n   */\n  _matchUrlToRoute(url) {\n    /** @type {import('./types.js').RouteParams} */\n    const params = {};\n\n    if (url !== \"/\") {\n      url = removeTrailingSlash(url);\n    }\n\n    const matchedRoute = Object.keys(this._routes).find((route) => {\n      if (url.split(\"/\").length !== route.split(\"/\").length) {\n        return false;\n      }\n\n      let routeSegments = route.split(\"/\").slice(1);\n      let urlSegments = url.split(\"/\").slice(1);\n\n      // If each segment in the url matches the corresponding segment in the route path,\n      // or the route path segment starts with a ':' then the route is matched.\n      const match = routeSegments.every((segment, i) => {\n        return segment === urlSegments[i] || segment.startsWith(\":\");\n      });\n\n      if (!match) {\n        return false;\n      }\n\n      // If the route matches the URL, pull out any params from the URL.\n      routeSegments.forEach((segment, i) => {\n        if (segment.startsWith(\":\")) {\n          const propName = segment.slice(1);\n          params[propName] = decodeURIComponent(urlSegments[i]);\n        }\n      });\n\n      return true;\n    });\n\n    if (matchedRoute) {\n      return { route: this._routes[matchedRoute], params };\n    } else {\n      return { route: this._routes[404], params };\n    }\n  }\n\n  /**\n   * Handles <a> link clicks\n   * @param {Event} event\n   * @returns {void}\n   */\n  _handleClick(event) {\n    const anchor = findAnchor(event);\n    if (!anchor) {\n      return;\n    }\n\n    if (!shouldRouterHandleClick(event, anchor)) {\n      return;\n    }\n\n    event.preventDefault();\n    let href = anchor.getAttribute(\"href\")?.trim();\n    if (!href?.startsWith(\"/\")) {\n      href = \"/\" + href;\n    }\n\n    this.navigateTo(href);\n  }\n\n  /**\n   * Add or remove search param to current url.\n   * @param {HTMLInputElement} checkbox \n   * @param {string} value\n   * @returns void\n   */\n  toggleParam(checkbox, value) {\n    const params = new URLSearchParams(location.search);\n    const name = checkbox.getAttribute('name')\n    if (!name) {\n      return console.warn(`name attribute is not set on ${checkbox.outerHTML}`);\n    }\n    if (checkbox.checked) {\n      !params.has(name) && params.set(name, value);\n    } else if (!checkbox.checked) {\n      params.has(name) && params.delete(name);\n    }\n    \n    const newUrl = !!params.size\n      ? `${location.pathname}?${params.toString()}`\n      : location.pathname;\n    this.navigateTo(newUrl);\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"BreezeRouter.js","sources":["../src/utils.js","../src/index.js"],"sourcesContent":["// @ts-check\n\n/**\n * Check if given param is function\n * @param {Function} fn\n * @returns {boolean}\n */\nexport const isFunction = (fn) => {\n  if (!fn) return false;\n  return fn.constructor.name.toLowerCase() === \"function\";\n};\n\n/**\n * Check if given param is async function\n * @param {Function} fn\n * @returns {boolean}\n */\nexport const isAsyncFunction = (fn) => {\n  if (!fn) return false;\n  return fn.constructor.name.toLowerCase() === \"asyncfunction\";\n};\n\n/**\n * Remove trailing slash of a given url.\n * @param {string} url\n * @returns {string}\n */\nexport const removeTrailingSlash = (url) => {\n  if (url.endsWith(\"/\")) {\n    url = url.replace(/\\/$/, \"\");\n  }\n\n  return url;\n};\n\n/**\n * Add trailing slash of a given url.\n * @param {string} url\n * @returns {string}\n */\nexport const addTrailingSlash = (url) => {\n  url = url.trim();\n  if (!url.endsWith(\"/\")) {\n    url = url + \"/\";\n  }\n\n  return url;\n};\n\n/**\n * Find anchor element from click event.\n * @param {Event} e - The click event.\n * @returns {HTMLAnchorElement|undefined}\n */\nexport const findAnchor = (e) => {\n  return e.composedPath().find((elem) => {\n    return elem.tagName === \"A\";\n  });\n};\n\n/**\n * Check if the router should handle a click event on an anchor element.\n * @param {Event} e - The click event.\n * @param {HTMLAnchorElement} anchor - The anchor element.\n * @returns {boolean} - True if the router should handle the event, false otherwise.\n */\nexport const shouldRouterHandleClick = (e, anchor) => {\n  // If the event has already been handled by another event listener\n  if (e.defaultPrevented) {\n    return false;\n  }\n\n  // If the user is holding down the meta, control, or shift key\n  if (e.metaKey || e.ctrlKey || e.shiftKey) {\n    return false;\n  }\n\n  if (!anchor) {\n    return false;\n  }\n\n  if (anchor.target) {\n    return false;\n  }\n\n  if (\n    anchor.hasAttribute(\"download\") ||\n    anchor.getAttribute(\"rel\") === \"external\"\n  ) {\n    return false;\n  }\n\n  const href = anchor.href;\n  if (!href || href.startsWith(\"mailto:\")) {\n    return false;\n  }\n\n  // If the href attribute does not start with the same origin\n  if (!href.startsWith(location.origin)) {\n    return false;\n  }\n\n  return true;\n};\n","// @ts-check\nimport {\n  isFunction,\n  isAsyncFunction,\n  removeTrailingSlash,\n  addTrailingSlash,\n  findAnchor,\n  shouldRouterHandleClick,\n} from \"./utils.js\";\n\n/**\n * Class representing a router.\n */\nexport default class BreezeRouter {\n  /**\n   * `data-` attribute to allow users to skip the router behavior,\n   * anchor link with this attribute set will behavior as normal link.\n   * @type {string}\n   */\n  #ignoreAttribute = \"data-breeze-ignore\";\n\n  /**\n   * Creates a new BreezeRouter instance.\n   * @param {object} config - Config.\n   * @constructor\n   */\n  constructor(config) {\n    const { ignoreAttribute } = config || {};\n\n    if (ignoreAttribute) {\n      this.#ignoreAttribute = ignoreAttribute;\n    }\n\n    /**\n     * Object containing all registered routes.\n     * @type {object}\n     * @private\n     */\n    this._routes = {};\n\n    /**\n     * The previous route that was navigated to\n     * @type {import('./types.js').Route|null}\n     * @private\n     */\n    this._previousRoute = null;\n\n    // Bind event listeners\n    window.addEventListener(\"popstate\", this._onChanged.bind(this));\n    document.body.addEventListener(\"click\", this._handleClick.bind(this));\n  }\n\n  /**\n   * Starts the router.\n   * @returns {void}\n   */\n  start() {\n    this._onChanged();\n  }\n\n  /**\n   * Adds a new route to the router.\n   * @param {string} route - The route path to add.\n   * @param {Function} handler - The async function to handle the route\n   * @returns {BreezeRouter|void} The BreezeRouter instance.\n   */\n  add(route, handler) {\n    route = route.trim();\n    if (route !== \"/\") {\n      route = addTrailingSlash(route);\n    }\n\n    if (this._routes[route]) {\n      return console.warn(`Route already exists: ${route}`);\n    }\n\n    if (typeof handler !== \"function\") {\n      return console.error(`handler of route '${route}' must be a function.`);\n    }\n\n    this._routes[route] = {\n      path: route,\n      handler,\n    };\n\n    return this;\n  }\n\n  /**\n   * Navigates to the specified URL.\n   * @param {string} url - The URL to navigate to\n   * @returns {void}\n   */\n  navigateTo(url) {\n    window.history.pushState({ url }, \"\", url);\n    this._onChanged();\n  }\n\n  /**\n   * Redirects a URL\n   * @param {string} url\n   * @returns {void}\n   */\n  redirect(url) {\n    this.navigateTo(url);\n  }\n\n  async _onChanged() {\n    const path = window.location.pathname;\n    const { route, params } = this._matchUrlToRoute(path);\n\n    // If no matching route found, route will be '404' route\n    // which has been handled by _matchUrlToRoute already\n    await this._handleRoute({ route, params });\n\n    /**\n     * Update previous route, so application route handler can check and decide if it should re-render whole page.\n     */\n    this._previousRoute = route;\n  }\n\n  /**\n   * Processes route callbacks registered by app\n   * @param {import('./types.js').MatchedRoute} options\n   * @returns {Promise<void>}\n   */\n  async _handleRoute({ route, params }) {\n    if (isFunction(route?.handler)) {\n      route.handler({ route, params });\n    }\n\n    if (isAsyncFunction(route?.handler)) {\n      await route.handler({ route, params });\n    }\n  }\n\n  /**\n   *\n   * @param {string} url - Current url users visite or nagivate to.\n   * @returns {import('./types.js').MatchedRoute}\n   */\n  _matchUrlToRoute(url) {\n    /** @type {import('./types.js').RouteParams} */\n    const params = {};\n\n    if (url !== \"/\") {\n      url = addTrailingSlash(url);\n    }\n\n    const matchedRoute = Object.keys(this._routes).find((route) => {\n      if (url.split(\"/\").length !== route.split(\"/\").length) {\n        return false;\n      }\n\n      let routeSegments = route.split(\"/\").slice(1);\n      let urlSegments = url.split(\"/\").slice(1);\n\n      // If each segment in the url matches the corresponding segment in the route path,\n      // or the route path segment starts with a ':' then the route is matched.\n      const match = routeSegments.every((segment, i) => {\n        return segment === urlSegments[i] || segment.startsWith(\":\");\n      });\n\n      if (!match) {\n        return false;\n      }\n\n      // If the route matches the URL, pull out any params from the URL.\n      routeSegments.forEach((segment, i) => {\n        if (segment.startsWith(\":\")) {\n          const propName = segment.slice(1);\n          params[propName] = decodeURIComponent(urlSegments[i]);\n        }\n      });\n\n      return true;\n    });\n\n    if (matchedRoute) {\n      return { route: this._routes[matchedRoute], params };\n    } else {\n      return { route: this._routes[404], params };\n    }\n  }\n\n  /**\n   * Handles <a> link clicks\n   * @param {Event} event\n   * @returns {void}\n   */\n  _handleClick(event) {\n    const anchor = findAnchor(event);\n    if (!anchor) {\n      return;\n    }\n\n    /**\n     * Allow users to define an `data-` attribute to skip the route handling.\n     * Default to `data-breeze-ignore`.\n     */\n    if (anchor.hasAttribute(this.#ignoreAttribute)) {\n      return;\n    }\n\n    if (!shouldRouterHandleClick(event, anchor)) {\n      return;\n    }\n\n    event.preventDefault();\n    let href = anchor.getAttribute(\"href\")?.trim();\n    if (!href?.startsWith(\"/\")) {\n      href = \"/\" + href;\n    }\n\n    this.navigateTo(href);\n  }\n\n  /**\n   * Add or remove search param to current url.\n   * @param {HTMLInputElement} checkbox\n   * @param {string} value\n   * @returns void\n   */\n  toggleParam(checkbox, value) {\n    const params = new URLSearchParams(location.search);\n    const name = checkbox.getAttribute(\"name\");\n    if (!name) {\n      return console.warn(`name attribute is not set on ${checkbox.outerHTML}`);\n    }\n    if (checkbox.checked) {\n      !params.has(name) && params.set(name, value);\n    } else if (!checkbox.checked) {\n      params.has(name) && params.delete(name);\n    }\n\n    const newUrl = !!params.size\n      ? `${location.pathname}?${params.toString()}`\n      : location.pathname;\n    this.navigateTo(newUrl);\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/BreezeRouter.min.js

@@ -1,2 +1,2 @@
-const t=t=>(t.endsWith("/")&&(t=t.replace(/\/$/,"")),t);class e{constructor(){this._routes={},this._previousRoute={},window.addEventListener("popstate",this._onChanged.bind(this)),document.body.addEventListener("click",this._handleClick.bind(this))}start(){this._onChanged()}add(e,r){return"/"!==(e=e.trim())&&(e=t(e.trim())),this._routes[e]?console.warn(`Route already exists: ${e}`):"function"!=typeof r?console.error(`handler on route '${e}' is not a function.`):(this._routes[e]={path:e,handler:r},this)}navigateTo(t){window.history.pushState({url:t},"",t),this._onChanged()}redirect(t){this.navigateTo(t)}async _onChanged(){const t=window.location.pathname,{route:e,params:r}=this._matchUrlToRoute(t);await this._handleRoute({route:e,params:r}),this._previousRoute=e}async _handleRoute({route:t,params:e}){"function"===t.handler.constructor.name.toLowerCase()&&t.handler({route:t,params:e}),(t=>"asyncfunction"===t.constructor.name.toLowerCase())(t.handler)&&await t.handler({route:t,params:e})}_matchUrlToRoute(e){const r={};"/"!==e&&(e=t(e));const a=Object.keys(this._routes).find((t=>{if(e.split("/").length!==t.split("/").length)return!1;let a=t.split("/").slice(1),n=e.split("/").slice(1);return!!a.every(((t,e)=>t===n[e]||t.startsWith(":")))&&(a.forEach(((t,e)=>{if(t.startsWith(":")){const a=t.slice(1);r[a]=decodeURIComponent(n[e])}})),!0)}));return a?{route:this._routes[a],params:r}:{route:this._routes[404],params:r}}_handleClick(t){const e=t.composedPath().find((t=>"A"===t.tagName));if(!e)return;if(!((t,e)=>{if(t.defaultPrevented)return!1;if(t.metaKey||t.ctrlKey||t.shiftKey)return!1;if(!e)return!1;if(e.target)return!1;if(e.hasAttribute("download")||"external"===e.getAttribute("rel"))return!1;const r=e.href;return!(!r||r.startsWith("mailto:")||!r.startsWith(location.origin))})(t,e))return;t.preventDefault();let r=e.getAttribute("href")?.trim();r?.startsWith("/")||(r="/"+r),this.navigateTo(r)}toggleParam(t,e){const r=new URLSearchParams(location.search),a=t.getAttribute("name");if(!a)return console.warn(`name attribute is not set on ${t.outerHTML}`);t.checked?!r.has(a)&&r.set(a,e):t.checked||r.has(a)&&r.delete(a);const n=r.size?`${location.pathname}?${r.toString()}`:location.pathname;this.navigateTo(n)}}export{e as default};
+const t=t=>((t=t.trim()).endsWith("/")||(t+="/"),t);class e{#t="data-breeze-ignore";constructor(t){const{ignoreAttribute:e}=t||{};e&&(this.#t=e),this._routes={},this._previousRoute=null,window.addEventListener("popstate",this._onChanged.bind(this)),document.body.addEventListener("click",this._handleClick.bind(this))}start(){this._onChanged()}add(e,r){return"/"!==(e=e.trim())&&(e=t(e)),this._routes[e]?console.warn(`Route already exists: ${e}`):"function"!=typeof r?console.error(`handler of route '${e}' must be a function.`):(this._routes[e]={path:e,handler:r},this)}navigateTo(t){window.history.pushState({url:t},"",t),this._onChanged()}redirect(t){this.navigateTo(t)}async _onChanged(){const t=window.location.pathname,{route:e,params:r}=this._matchUrlToRoute(t);await this._handleRoute({route:e,params:r}),this._previousRoute=e}async _handleRoute({route:t,params:e}){var r;r=t?.handler,r&&"function"===r.constructor.name.toLowerCase()&&t.handler({route:t,params:e}),(t=>!!t&&"asyncfunction"===t.constructor.name.toLowerCase())(t?.handler)&&await t.handler({route:t,params:e})}_matchUrlToRoute(e){const r={};"/"!==e&&(e=t(e));const n=Object.keys(this._routes).find((t=>{if(e.split("/").length!==t.split("/").length)return!1;let n=t.split("/").slice(1),a=e.split("/").slice(1);return!!n.every(((t,e)=>t===a[e]||t.startsWith(":")))&&(n.forEach(((t,e)=>{if(t.startsWith(":")){const n=t.slice(1);r[n]=decodeURIComponent(a[e])}})),!0)}));return n?{route:this._routes[n],params:r}:{route:this._routes[404],params:r}}_handleClick(t){const e=t.composedPath().find((t=>"A"===t.tagName));if(!e)return;if(e.hasAttribute(this.#t))return;if(!((t,e)=>{if(t.defaultPrevented)return!1;if(t.metaKey||t.ctrlKey||t.shiftKey)return!1;if(!e)return!1;if(e.target)return!1;if(e.hasAttribute("download")||"external"===e.getAttribute("rel"))return!1;const r=e.href;return!(!r||r.startsWith("mailto:")||!r.startsWith(location.origin))})(t,e))return;t.preventDefault();let r=e.getAttribute("href")?.trim();r?.startsWith("/")||(r="/"+r),this.navigateTo(r)}toggleParam(t,e){const r=new URLSearchParams(location.search),n=t.getAttribute("name");if(!n)return console.warn(`name attribute is not set on ${t.outerHTML}`);t.checked?!r.has(n)&&r.set(n,e):t.checked||r.has(n)&&r.delete(n);const a=r.size?`${location.pathname}?${r.toString()}`:location.pathname;this.navigateTo(a)}}export{e as default};
 //# sourceMappingURL=BreezeRouter.min.js.map

package/dist/BreezeRouter.min.js.map

@@ -1 +1 @@
-{"version":3,"file":"BreezeRouter.min.js","sources":["../src/utils.js","../src/index.js"],"sourcesContent":["// @ts-check\n\n/**\n * Check if given param is function\n * @param {Function} fn\n * @returns {boolean}\n */\nexport const isFunction = (fn) => {\n  return fn.constructor.name.toLowerCase() === \"function\";\n};\n\n/**\n * Check if given param is async function\n * @param {Function} fn\n * @returns {boolean}\n */\nexport const isAsyncFunction = (fn) => {\n  return fn.constructor.name.toLowerCase() === \"asyncfunction\";\n};\n\n/**\n * Remove trailing slash of a give url\n * @param {string} url\n * @returns {string}\n */\nexport const removeTrailingSlash = (url) => {\n  if (url.endsWith(\"/\")) {\n    url = url.replace(/\\/$/, \"\");\n  }\n\n  return url;\n};\n\n/**\n * Find anchor element from click event.\n * @param {Event} e - The click event.\n * @returns {HTMLAnchorElement|undefined}\n */\nexport const findAnchor = (e) => {\n  return e.composedPath().find((elem) => {\n    return elem.tagName === \"A\";\n  });\n};\n\n/**\n * Check if the router should handle a click event on an anchor element.\n * @param {Event} e - The click event.\n * @param {HTMLAnchorElement} anchor - The anchor element.\n * @returns {boolean} - True if the router should handle the event, false otherwise.\n */\nexport const shouldRouterHandleClick = (e, anchor) => {\n  // If the event has already been handled by another event listener\n  if (e.defaultPrevented) {\n    return false;\n  }\n\n  // If the user is holding down the meta, control, or shift key\n  if (e.metaKey || e.ctrlKey || e.shiftKey) {\n    return false;\n  }\n\n  if (!anchor) {\n    return false;\n  }\n\n  if (anchor.target) {\n    return false;\n  }\n\n  if (\n    anchor.hasAttribute(\"download\") ||\n    anchor.getAttribute(\"rel\") === \"external\"\n  ) {\n    return false;\n  }\n\n  const href = anchor.href;\n  if (!href || href.startsWith(\"mailto:\")) {\n    return false;\n  }\n\n  // If the href attribute does not start with the same origin\n  if (!href.startsWith(location.origin)) {\n    return false;\n  }\n\n  return true;\n};\n","// @ts-check\nimport {\n  isFunction,\n  isAsyncFunction,\n  removeTrailingSlash,\n  findAnchor,\n  shouldRouterHandleClick,\n} from \"./utils.js\";\n\n/**\n * Class representing a router.\n */\nexport default class BreezeRouter {\n  /**\n   * Creates a new BreezeRouter instance.\n   * @constructor\n   */\n  constructor() {\n    /**\n     * Object containing all registered routes.\n     * @type {import('./types.js').Route}\n     * @private\n     */\n    this._routes = {};\n\n    /**\n     * The previous route that was navigated to\n     * @type {import('./types.js').Route}\n     * @private\n     */\n    this._previousRoute = {};\n\n    // Bind event listeners\n    window.addEventListener(\"popstate\", this._onChanged.bind(this));\n    document.body.addEventListener(\"click\", this._handleClick.bind(this));\n  }\n\n  /**\n   * Starts the router.\n   * @returns {void}\n   */\n  start() {\n    this._onChanged();\n  }\n\n  /**\n   * Adds a new route to the router.\n   * @param {string} route - The route path to add.\n   * @param {Function} handler - The async function to handle the route\n   * @returns {BreezeRouter|void} The BreezeRouter instance.\n   */\n  add(route, handler) {\n    route = route.trim();\n    if (route !== \"/\") {\n      route = removeTrailingSlash(route.trim());\n    }\n\n    if (this._routes[route]) {\n      return console.warn(`Route already exists: ${route}`);\n    }\n\n    if (typeof handler !== \"function\") {\n      return console.error(`handler on route '${route}' is not a function.`);\n    }\n\n    this._routes[route] = {\n      path: route,\n      handler,\n    };\n\n    return this;\n  }\n\n  /**\n   * Navigates to the specified URL.\n   * @param {string} url - The URL to navigate to\n   * @returns {void}\n   */\n  navigateTo(url) {\n    window.history.pushState({ url }, \"\", url);\n    this._onChanged();\n  }\n\n  /**\n   * Redirects a URL\n   * @param {string} url\n   * @returns {void}\n   */\n  redirect(url) {\n    this.navigateTo(url);\n  }\n\n  async _onChanged() {\n    const path = window.location.pathname;\n    const { route, params } = this._matchUrlToRoute(path);\n\n    // If no matching route found, route will be '404' route\n    // which has been handled by _matchUrlToRoute already\n    await this._handleRoute({ route, params });\n\n    /**\n     * Update previous route, so application route handler can check and decide if it should re-render whole page.\n     */\n    this._previousRoute = route;\n  }\n\n  /**\n   * Processes route callbacks registered by app\n   * @param {import('./types.js').MatchedRoute} options\n   * @returns {Promise<void>}\n   */\n  async _handleRoute({ route, params }) {\n    if (isFunction(route.handler)) {\n      route.handler({ route, params });\n    }\n\n    if (isAsyncFunction(route.handler)) {\n      await route.handler({ route, params });\n    }\n  }\n\n  /**\n   *\n   * @param {string} url - Current url users visite or nagivate to.\n   * @returns {import('./types.js').MatchedRoute}\n   */\n  _matchUrlToRoute(url) {\n    /** @type {import('./types.js').RouteParams} */\n    const params = {};\n\n    if (url !== \"/\") {\n      url = removeTrailingSlash(url);\n    }\n\n    const matchedRoute = Object.keys(this._routes).find((route) => {\n      if (url.split(\"/\").length !== route.split(\"/\").length) {\n        return false;\n      }\n\n      let routeSegments = route.split(\"/\").slice(1);\n      let urlSegments = url.split(\"/\").slice(1);\n\n      // If each segment in the url matches the corresponding segment in the route path,\n      // or the route path segment starts with a ':' then the route is matched.\n      const match = routeSegments.every((segment, i) => {\n        return segment === urlSegments[i] || segment.startsWith(\":\");\n      });\n\n      if (!match) {\n        return false;\n      }\n\n      // If the route matches the URL, pull out any params from the URL.\n      routeSegments.forEach((segment, i) => {\n        if (segment.startsWith(\":\")) {\n          const propName = segment.slice(1);\n          params[propName] = decodeURIComponent(urlSegments[i]);\n        }\n      });\n\n      return true;\n    });\n\n    if (matchedRoute) {\n      return { route: this._routes[matchedRoute], params };\n    } else {\n      return { route: this._routes[404], params };\n    }\n  }\n\n  /**\n   * Handles <a> link clicks\n   * @param {Event} event\n   * @returns {void}\n   */\n  _handleClick(event) {\n    const anchor = findAnchor(event);\n    if (!anchor) {\n      return;\n    }\n\n    if (!shouldRouterHandleClick(event, anchor)) {\n      return;\n    }\n\n    event.preventDefault();\n    let href = anchor.getAttribute(\"href\")?.trim();\n    if (!href?.startsWith(\"/\")) {\n      href = \"/\" + href;\n    }\n\n    this.navigateTo(href);\n  }\n\n  /**\n   * Add or remove search param to current url.\n   * @param {HTMLInputElement} checkbox \n   * @param {string} value\n   * @returns void\n   */\n  toggleParam(checkbox, value) {\n    const params = new URLSearchParams(location.search);\n    const name = checkbox.getAttribute('name')\n    if (!name) {\n      return console.warn(`name attribute is not set on ${checkbox.outerHTML}`);\n    }\n    if (checkbox.checked) {\n      !params.has(name) && params.set(name, value);\n    } else if (!checkbox.checked) {\n      params.has(name) && params.delete(name);\n    }\n    \n    const newUrl = !!params.size\n      ? `${location.pathname}?${params.toString()}`\n      : location.pathname;\n    this.navigateTo(newUrl);\n  }\n}\n"],"names":["removeTrailingSlash","url","endsWith","replace","BreezeRouter","constructor","this","_routes","_previousRoute","window","addEventListener","_onChanged","bind","document","body","_handleClick","start","add","route","handler","trim","console","warn","error","path","navigateTo","history","pushState","redirect","async","location","pathname","params","_matchUrlToRoute","_handleRoute","name","toLowerCase","fn","isAsyncFunction","matchedRoute","Object","keys","find","split","length","routeSegments","slice","urlSegments","every","segment","i","startsWith","forEach","propName","decodeURIComponent","event","anchor","composedPath","elem","tagName","e","defaultPrevented","metaKey","ctrlKey","shiftKey","target","hasAttribute","getAttribute","href","origin","shouldRouterHandleClick","preventDefault","toggleParam","checkbox","value","URLSearchParams","search","outerHTML","checked","has","set","delete","newUrl","size","toString"],"mappings":"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"}
+{"version":3,"file":"BreezeRouter.min.js","sources":["../src/utils.js","../src/index.js"],"sourcesContent":["// @ts-check\n\n/**\n * Check if given param is function\n * @param {Function} fn\n * @returns {boolean}\n */\nexport const isFunction = (fn) => {\n  if (!fn) return false;\n  return fn.constructor.name.toLowerCase() === \"function\";\n};\n\n/**\n * Check if given param is async function\n * @param {Function} fn\n * @returns {boolean}\n */\nexport const isAsyncFunction = (fn) => {\n  if (!fn) return false;\n  return fn.constructor.name.toLowerCase() === \"asyncfunction\";\n};\n\n/**\n * Remove trailing slash of a given url.\n * @param {string} url\n * @returns {string}\n */\nexport const removeTrailingSlash = (url) => {\n  if (url.endsWith(\"/\")) {\n    url = url.replace(/\\/$/, \"\");\n  }\n\n  return url;\n};\n\n/**\n * Add trailing slash of a given url.\n * @param {string} url\n * @returns {string}\n */\nexport const addTrailingSlash = (url) => {\n  url = url.trim();\n  if (!url.endsWith(\"/\")) {\n    url = url + \"/\";\n  }\n\n  return url;\n};\n\n/**\n * Find anchor element from click event.\n * @param {Event} e - The click event.\n * @returns {HTMLAnchorElement|undefined}\n */\nexport const findAnchor = (e) => {\n  return e.composedPath().find((elem) => {\n    return elem.tagName === \"A\";\n  });\n};\n\n/**\n * Check if the router should handle a click event on an anchor element.\n * @param {Event} e - The click event.\n * @param {HTMLAnchorElement} anchor - The anchor element.\n * @returns {boolean} - True if the router should handle the event, false otherwise.\n */\nexport const shouldRouterHandleClick = (e, anchor) => {\n  // If the event has already been handled by another event listener\n  if (e.defaultPrevented) {\n    return false;\n  }\n\n  // If the user is holding down the meta, control, or shift key\n  if (e.metaKey || e.ctrlKey || e.shiftKey) {\n    return false;\n  }\n\n  if (!anchor) {\n    return false;\n  }\n\n  if (anchor.target) {\n    return false;\n  }\n\n  if (\n    anchor.hasAttribute(\"download\") ||\n    anchor.getAttribute(\"rel\") === \"external\"\n  ) {\n    return false;\n  }\n\n  const href = anchor.href;\n  if (!href || href.startsWith(\"mailto:\")) {\n    return false;\n  }\n\n  // If the href attribute does not start with the same origin\n  if (!href.startsWith(location.origin)) {\n    return false;\n  }\n\n  return true;\n};\n","// @ts-check\nimport {\n  isFunction,\n  isAsyncFunction,\n  removeTrailingSlash,\n  addTrailingSlash,\n  findAnchor,\n  shouldRouterHandleClick,\n} from \"./utils.js\";\n\n/**\n * Class representing a router.\n */\nexport default class BreezeRouter {\n  /**\n   * `data-` attribute to allow users to skip the router behavior,\n   * anchor link with this attribute set will behavior as normal link.\n   * @type {string}\n   */\n  #ignoreAttribute = \"data-breeze-ignore\";\n\n  /**\n   * Creates a new BreezeRouter instance.\n   * @param {object} config - Config.\n   * @constructor\n   */\n  constructor(config) {\n    const { ignoreAttribute } = config || {};\n\n    if (ignoreAttribute) {\n      this.#ignoreAttribute = ignoreAttribute;\n    }\n\n    /**\n     * Object containing all registered routes.\n     * @type {object}\n     * @private\n     */\n    this._routes = {};\n\n    /**\n     * The previous route that was navigated to\n     * @type {import('./types.js').Route|null}\n     * @private\n     */\n    this._previousRoute = null;\n\n    // Bind event listeners\n    window.addEventListener(\"popstate\", this._onChanged.bind(this));\n    document.body.addEventListener(\"click\", this._handleClick.bind(this));\n  }\n\n  /**\n   * Starts the router.\n   * @returns {void}\n   */\n  start() {\n    this._onChanged();\n  }\n\n  /**\n   * Adds a new route to the router.\n   * @param {string} route - The route path to add.\n   * @param {Function} handler - The async function to handle the route\n   * @returns {BreezeRouter|void} The BreezeRouter instance.\n   */\n  add(route, handler) {\n    route = route.trim();\n    if (route !== \"/\") {\n      route = addTrailingSlash(route);\n    }\n\n    if (this._routes[route]) {\n      return console.warn(`Route already exists: ${route}`);\n    }\n\n    if (typeof handler !== \"function\") {\n      return console.error(`handler of route '${route}' must be a function.`);\n    }\n\n    this._routes[route] = {\n      path: route,\n      handler,\n    };\n\n    return this;\n  }\n\n  /**\n   * Navigates to the specified URL.\n   * @param {string} url - The URL to navigate to\n   * @returns {void}\n   */\n  navigateTo(url) {\n    window.history.pushState({ url }, \"\", url);\n    this._onChanged();\n  }\n\n  /**\n   * Redirects a URL\n   * @param {string} url\n   * @returns {void}\n   */\n  redirect(url) {\n    this.navigateTo(url);\n  }\n\n  async _onChanged() {\n    const path = window.location.pathname;\n    const { route, params } = this._matchUrlToRoute(path);\n\n    // If no matching route found, route will be '404' route\n    // which has been handled by _matchUrlToRoute already\n    await this._handleRoute({ route, params });\n\n    /**\n     * Update previous route, so application route handler can check and decide if it should re-render whole page.\n     */\n    this._previousRoute = route;\n  }\n\n  /**\n   * Processes route callbacks registered by app\n   * @param {import('./types.js').MatchedRoute} options\n   * @returns {Promise<void>}\n   */\n  async _handleRoute({ route, params }) {\n    if (isFunction(route?.handler)) {\n      route.handler({ route, params });\n    }\n\n    if (isAsyncFunction(route?.handler)) {\n      await route.handler({ route, params });\n    }\n  }\n\n  /**\n   *\n   * @param {string} url - Current url users visite or nagivate to.\n   * @returns {import('./types.js').MatchedRoute}\n   */\n  _matchUrlToRoute(url) {\n    /** @type {import('./types.js').RouteParams} */\n    const params = {};\n\n    if (url !== \"/\") {\n      url = addTrailingSlash(url);\n    }\n\n    const matchedRoute = Object.keys(this._routes).find((route) => {\n      if (url.split(\"/\").length !== route.split(\"/\").length) {\n        return false;\n      }\n\n      let routeSegments = route.split(\"/\").slice(1);\n      let urlSegments = url.split(\"/\").slice(1);\n\n      // If each segment in the url matches the corresponding segment in the route path,\n      // or the route path segment starts with a ':' then the route is matched.\n      const match = routeSegments.every((segment, i) => {\n        return segment === urlSegments[i] || segment.startsWith(\":\");\n      });\n\n      if (!match) {\n        return false;\n      }\n\n      // If the route matches the URL, pull out any params from the URL.\n      routeSegments.forEach((segment, i) => {\n        if (segment.startsWith(\":\")) {\n          const propName = segment.slice(1);\n          params[propName] = decodeURIComponent(urlSegments[i]);\n        }\n      });\n\n      return true;\n    });\n\n    if (matchedRoute) {\n      return { route: this._routes[matchedRoute], params };\n    } else {\n      return { route: this._routes[404], params };\n    }\n  }\n\n  /**\n   * Handles <a> link clicks\n   * @param {Event} event\n   * @returns {void}\n   */\n  _handleClick(event) {\n    const anchor = findAnchor(event);\n    if (!anchor) {\n      return;\n    }\n\n    /**\n     * Allow users to define an `data-` attribute to skip the route handling.\n     * Default to `data-breeze-ignore`.\n     */\n    if (anchor.hasAttribute(this.#ignoreAttribute)) {\n      return;\n    }\n\n    if (!shouldRouterHandleClick(event, anchor)) {\n      return;\n    }\n\n    event.preventDefault();\n    let href = anchor.getAttribute(\"href\")?.trim();\n    if (!href?.startsWith(\"/\")) {\n      href = \"/\" + href;\n    }\n\n    this.navigateTo(href);\n  }\n\n  /**\n   * Add or remove search param to current url.\n   * @param {HTMLInputElement} checkbox\n   * @param {string} value\n   * @returns void\n   */\n  toggleParam(checkbox, value) {\n    const params = new URLSearchParams(location.search);\n    const name = checkbox.getAttribute(\"name\");\n    if (!name) {\n      return console.warn(`name attribute is not set on ${checkbox.outerHTML}`);\n    }\n    if (checkbox.checked) {\n      !params.has(name) && params.set(name, value);\n    } else if (!checkbox.checked) {\n      params.has(name) && params.delete(name);\n    }\n\n    const newUrl = !!params.size\n      ? `${location.pathname}?${params.toString()}`\n      : location.pathname;\n    this.navigateTo(newUrl);\n  }\n}\n"],"names":["addTrailingSlash","url","trim","endsWith","BreezeRouter","ignoreAttribute","constructor","config","this","_routes","_previousRoute","window","addEventListener","_onChanged","bind","document","body","_handleClick","start","add","route","handler","console","warn","error","path","navigateTo","history","pushState","redirect","async","location","pathname","params","_matchUrlToRoute","_handleRoute","fn","name","toLowerCase","isAsyncFunction","matchedRoute","Object","keys","find","split","length","routeSegments","slice","urlSegments","every","segment","i","startsWith","forEach","propName","decodeURIComponent","event","anchor","composedPath","elem","tagName","hasAttribute","e","defaultPrevented","metaKey","ctrlKey","shiftKey","target","getAttribute","href","origin","shouldRouterHandleClick","preventDefault","toggleParam","checkbox","value","URLSearchParams","search","outerHTML","checked","has","set","delete","newUrl","size","toString"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "breeze-router",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "A lightweight, zero-dependency client-side router for single page applications (SPAs).",
   "main": "index.js",
   "type": "module",