@hybridly/core 0.4.0 → 0.4.2

package/dist/index.cjs

@@ -160,7 +160,7 @@ async function restoreScrollPositions() {
     utils.debug.scroll("No region found to restore.");
     return;
   }
-  context.adapter.onWaitingForMount(() => {
+  context.adapter.executeOnMounted(() => {
     utils.debug.scroll(`Restoring ${regions.length}/${context.scrollRegions.length} region(s).`);
     regions.forEach((el, i) => el.scrollTo({
       top: context.scrollRegions.at(i)?.top ?? el.scrollTop,
@@ -360,10 +360,59 @@ function createSerializer(options) {
   };
 }
 
+function getUrlRegexForRoute(name) {
+  const routing = getRouting();
+  const definition = getRouteDefinition(name);
+  const path = definition.uri.replaceAll("/", "\\/");
+  const domain = definition.domain;
+  const protocolPrefix = routing.url.match(/^\w+:\/\//)?.[0];
+  const origin = domain ? `${protocolPrefix}${domain}${routing.port ? `:${routing.port}` : ""}`.replaceAll("/", "\\/") : routing.url.replaceAll("/", "\\/");
+  const urlPathRegexPattern = path.length > 0 ? `\\/${path.replace(/\/$/g, "")}` : "";
+  let urlRegexPattern = `^${origin.replaceAll(".", "\\.")}${urlPathRegexPattern}\\/?(\\?.*)?$`;
+  urlRegexPattern = urlRegexPattern.replace(/(\\\/?){([^}?]+)(\??)}/g, (_, slash, parameterName, optional) => {
+    const where = definition.wheres?.[parameterName];
+    let regexTemplate = where?.replace(/(^\^)|(\$$)/g, "") || "[^/?]+";
+    regexTemplate = `(?<${parameterName}>${regexTemplate})`;
+    if (optional) {
+      return `(${slash ? "\\/?" : ""}${regexTemplate})?`;
+    }
+    return (slash ? "\\/" : "") + regexTemplate;
+  });
+  return RegExp(urlRegexPattern);
+}
+function urlMatchesRoute(url, name, routeParameters) {
+  const parameters = routeParameters || {};
+  const definition = getRouting().routes[name];
+  if (!definition) {
+    return false;
+  }
+  const matches = getUrlRegexForRoute(name).exec(url);
+  if (!matches) {
+    return false;
+  }
+  for (const k in matches.groups) {
+    matches.groups[k] = typeof matches.groups[k] === "string" ? decodeURIComponent(matches.groups[k]) : matches.groups[k];
+  }
+  return Object.keys(parameters).every((parameterName) => {
+    let value = parameters[parameterName];
+    const bindingProperty = definition.bindings?.[parameterName];
+    if (bindingProperty && typeof value === "object") {
+      value = value[bindingProperty];
+    }
+    return matches.groups?.[parameterName] === value.toString();
+  });
+}
 function generateRouteFromName(name, parameters, absolute, shouldThrow) {
   const url = getUrlFromName(name, parameters, shouldThrow);
   return absolute === false ? url.toString().replace(url.origin, "") : url.toString();
 }
+function getNameFromUrl(url, parameters) {
+  const routing = getRouting();
+  const routes = Object.values(routing.routes).map((x) => x.name);
+  return routes.find((routeName) => {
+    return urlMatchesRoute(url, routeName, parameters);
+  });
+}
 function getUrlFromName(name, parameters, shouldThrow) {
   const routing = getRouting();
   const definition = getRouteDefinition(name);
@@ -376,32 +425,39 @@ function getUrlFromName(name, parameters, shouldThrow) {
   }));
   return url;
 }
-function getRouteTransformable(routeName, routeParameters, shouldThrow) {
+function getRouteParameterValue(routeName, parameterName, routeParameters) {
   const routing = getRouting();
+  const definition = getRouteDefinition(routeName);
+  const parameters = routeParameters || {};
+  const value = (() => {
+    const value2 = parameters[parameterName];
+    const bindingProperty = definition.bindings?.[parameterName];
+    if (bindingProperty && value2 != null && typeof value2 === "object") {
+      return value2[bindingProperty];
+    }
+    return value2;
+  })();
+  if (value) {
+    const where = definition.wheres?.[parameterName];
+    if (where && !new RegExp(where).test(value)) {
+      console.warn(`[hybridly:routing] Parameter [${parameterName}] does not match the required format [${where}] for route [${routeName}].`);
+    }
+    return value;
+  }
+  if (routing.defaults?.[parameterName]) {
+    return routing.defaults?.[parameterName];
+  }
+}
+function getRouteTransformable(routeName, routeParameters, shouldThrow) {
   const definition = getRouteDefinition(routeName);
   const parameters = routeParameters || {};
   const missing = Object.keys(parameters);
-  const replaceParameter = (match, parameterName) => {
-    const optional = /\?}$/.test(match);
-    const value = (() => {
-      const value2 = parameters[parameterName];
-      const bindingProperty = definition.bindings?.[parameterName];
-      if (bindingProperty && typeof value2 === "object") {
-        return value2[bindingProperty];
-      }
-      return value2;
-    })();
+  const replaceParameter = (match, parameterName, optional) => {
+    const value = getRouteParameterValue(routeName, parameterName, parameters);
     missing.splice(missing.indexOf(parameterName), 1);
     if (value) {
-      const where = definition.wheres?.[parameterName];
-      if (where && !new RegExp(where).test(value)) {
-        console.warn(`[hybridly:routing] Parameter [${parameterName}] does not match the required format [${where}] for route [${routeName}].`);
-      }
       return value;
     }
-    if (routing.defaults?.[parameterName]) {
-      return routing.defaults?.[parameterName];
-    }
     if (optional) {
       return "";
     }
@@ -410,8 +466,8 @@ function getRouteTransformable(routeName, routeParameters, shouldThrow) {
     }
     throw new MissingRouteParameter(parameterName, routeName);
   };
-  const path = definition.uri.replace(/{([^}?]+)\??}/g, replaceParameter);
-  const domain = definition.domain?.replace(/{([^}?]+)\??}/g, replaceParameter);
+  const path = definition.uri.replace(/{([^}?]+)(\??)}/g, replaceParameter);
+  const domain = definition.domain?.replace(/{([^}?]+)(\??)}/g, replaceParameter);
   const remaining = Object.keys(parameters).filter((key) => missing.includes(key)).reduce((obj, key) => ({
     ...obj,
     [key]: parameters[key]
@@ -441,30 +497,28 @@ function getRouting() {
   }
   return routing;
 }
-
-function isCurrentFromName(name, parameters, mode = "loose") {
-  const location = window.location;
-  const matchee = (() => {
-    try {
-      return makeUrl(generateRouteFromName(name, parameters, true, false));
-    } catch (error) {
-    }
-  })();
-  if (!matchee) {
-    return false;
-  }
-  if (mode === "strict") {
-    return location.href === matchee.href;
-  }
-  return location.href.startsWith(matchee.href);
-}
-
 function route(name, parameters, absolute) {
   return generateRouteFromName(name, parameters, absolute);
 }
-function current(name, parameters, mode = "loose") {
-  return isCurrentFromName(name, parameters, mode);
+
+function getCurrentUrl() {
+  if (typeof window === "undefined") {
+    return getInternalRouterContext().url;
+  }
+  return window.location.toString();
+}
+function currentRouteMatches(name, parameters) {
+  const namePattern = name.replaceAll(".", "\\.").replaceAll("*", ".*");
+  const possibleRoutes = Object.values(getRouting().routes).filter((x) => x.method.includes("GET") && RegExp(namePattern).test(x.name)).map((x) => x.name);
+  const currentUrl = getCurrentUrl();
+  return possibleRoutes.some((routeName) => {
+    return urlMatchesRoute(currentUrl, routeName, parameters);
+  });
+}
+function getCurrentRouteName() {
+  return getNameFromUrl(getCurrentUrl());
 }
+
 function updateRoutingConfiguration(routing) {
   if (!routing) {
     return;
@@ -500,6 +554,7 @@ async function initializeContext(options) {
     plugins: options.plugins ?? [],
     axios: options.axios ?? axios__default.create(),
     routing: options.routing,
+    preloadCache: /* @__PURE__ */ new Map(),
     hooks: {},
     memo: {}
   };
@@ -590,6 +645,52 @@ async function closeDialog(options) {
   });
 }
 
+function isPreloaded(targetUrl) {
+  const context = getInternalRouterContext();
+  return context.preloadCache.has(targetUrl.toString()) ?? false;
+}
+function getPreloadedRequest(targetUrl) {
+  const context = getInternalRouterContext();
+  return context.preloadCache.get(targetUrl.toString());
+}
+function storePreloadRequest(targetUrl, response) {
+  const context = getInternalRouterContext();
+  context.preloadCache.set(targetUrl.toString(), response);
+}
+function discardPreloadedRequest(targetUrl) {
+  const context = getInternalRouterContext();
+  return context.preloadCache.delete(targetUrl.toString());
+}
+async function performPreloadRequest(options) {
+  const context = getRouterContext();
+  const url = makeUrl(options.url ?? context.url);
+  if (isPreloaded(url)) {
+    utils.debug.router("This request is already preloaded.");
+    return false;
+  }
+  if (context.pendingNavigation) {
+    utils.debug.router("A navigation is pending, preload aborted.");
+    return false;
+  }
+  if (options.method !== "GET") {
+    utils.debug.router("Cannot preload non-GET requests.");
+    return false;
+  }
+  utils.debug.router(`Preloading response for [${url.toString()}]`);
+  try {
+    const response = await performHybridRequest(url, options);
+    if (!isHybridResponse(response)) {
+      utils.debug.router("Preload result was invalid.");
+      return false;
+    }
+    storePreloadRequest(url, response);
+    return true;
+  } catch (error) {
+    utils.debug.router("Preloading failed.");
+    return false;
+  }
+}
+
 const router = {
   abort: async () => getRouterContext().pendingNavigation?.controller.abort(),
   active: () => !!getRouterContext().pendingNavigation,
@@ -601,12 +702,15 @@ const router = {
   patch: async (url, options = {}) => await performHybridNavigation({ preserveState: true, ...options, url, method: "PATCH" }),
   delete: async (url, options = {}) => await performHybridNavigation({ preserveState: true, ...options, url, method: "DELETE" }),
   local: async (url, options = {}) => await performLocalNavigation(url, options),
+  preload: async (url, options = {}) => await performPreloadRequest({ ...options, url, method: "GET" }),
   external: (url, data = {}) => navigateToExternalUrl(url, data),
   to: async (name, parameters, options) => {
     const url = generateRouteFromName(name, parameters);
     const method = getRouteDefinition(name).method.at(0);
     return await performHybridNavigation({ url, ...options, method });
   },
+  matches: (name, parameters) => currentRouteMatches(name, parameters),
+  current: () => getCurrentRouteName(),
   dialog: {
     close: (options) => closeDialog(options)
   },
@@ -632,11 +736,6 @@ async function performHybridNavigation(options) {
     if ((utils.hasFiles(options.data) || options.useFormData) && !(options.data instanceof FormData)) {
       options.data = utils.objectToFormData(options.data);
       utils.debug.router("Converted data to FormData.", options.data);
-      if (options.method && ["PUT", "PATCH", "DELETE"].includes(options.method) && options.spoof !== false) {
-        utils.debug.router(`Automatically spoofing method ${options.method}.`);
-        options.data.append("_method", options.method);
-        options.method = "POST";
-      }
     }
     if (!(options.data instanceof FormData) && options.method === "GET" && Object.keys(options.data ?? {}).length) {
       utils.debug.router("Transforming data to query parameters.", options.data);
@@ -645,6 +744,19 @@ async function performHybridNavigation(options) {
       });
       options.data = {};
     }
+    if (["PUT", "PATCH", "DELETE"].includes(options.method) && options.spoof !== false) {
+      utils.debug.router(`Automatically spoofing method ${options.method}.`);
+      if (options.data instanceof FormData) {
+        options.data.append("_method", options.method);
+      } else if (Object.keys(options.data ?? {}).length) {
+        Object.assign(options.data, { _method: options.method });
+      } else if (typeof options.data === "undefined") {
+        options.data = { _method: options.method };
+      } else {
+        utils.debug.router("Could not spoof method because body type is not supported.", options.data);
+      }
+      options.method = "POST";
+    }
     if (!await runHooks("before", options.hooks, options, context)) {
       utils.debug.router('"before" event returned false, aborting the navigation.');
       throw new NavigationCancelledError('The navigation was cancelled by the "before" event.');
@@ -670,35 +782,7 @@ async function performHybridNavigation(options) {
     });
     await runHooks("start", options.hooks, context);
     utils.debug.router("Making request with axios.");
-    const response = await context.axios.request({
-      url: targetUrl.toString(),
-      method: options.method,
-      data: options.method === "GET" ? {} : options.data,
-      params: options.method === "GET" ? options.data : {},
-      signal: abortController.signal,
-      headers: {
-        ...options.headers,
-        ...context.dialog ? { [DIALOG_KEY_HEADER]: context.dialog.key } : {},
-        ...context.dialog ? { [DIALOG_REDIRECT_HEADER]: context.dialog.redirectUrl ?? "" } : {},
-        ...utils.when(options.only !== void 0 || options.except !== void 0, {
-          [PARTIAL_COMPONENT_HEADER]: context.view.component,
-          ...utils.when(options.only, { [ONLY_DATA_HEADER]: JSON.stringify(options.only) }, {}),
-          ...utils.when(options.except, { [EXCEPT_DATA_HEADER]: JSON.stringify(options.except) }, {})
-        }, {}),
-        ...utils.when(options.errorBag, { [ERROR_BAG_HEADER]: options.errorBag }, {}),
-        ...utils.when(context.version, { [VERSION_HEADER]: context.version }, {}),
-        [HYBRIDLY_HEADER]: true,
-        "X-Requested-With": "XMLHttpRequest",
-        "Accept": "text/html, application/xhtml+xml"
-      },
-      validateStatus: () => true,
-      onUploadProgress: async (event) => {
-        await runHooks("progress", options.hooks, {
-          event,
-          percentage: Math.round(event.loaded / (event.total ?? 0) * 100)
-        }, context);
-      }
-    });
+    const response = await performHybridRequest(targetUrl, options, abortController);
     await runHooks("data", options.hooks, response, context);
     if (isExternalResponse(response)) {
       utils.debug.router("The response is explicitely external.");
@@ -842,6 +926,47 @@ async function navigate(options) {
     resetScrollPositions();
   }
   await runHooks("navigated", {}, options, context);
+  context.adapter.executeOnMounted(() => {
+    runHooks("mounted", {}, context);
+  });
+}
+async function performHybridRequest(targetUrl, options, abortController) {
+  const context = getInternalRouterContext();
+  const preloaded = getPreloadedRequest(targetUrl);
+  if (preloaded) {
+    utils.debug.router(`Found a pre-loaded request for [${targetUrl}]`);
+    discardPreloadedRequest(targetUrl);
+    return preloaded;
+  }
+  return await context.axios.request({
+    url: targetUrl.toString(),
+    method: options.method,
+    data: options.method === "GET" ? {} : options.data,
+    params: options.method === "GET" ? options.data : {},
+    signal: abortController?.signal,
+    headers: {
+      ...options.headers,
+      ...context.dialog ? { [DIALOG_KEY_HEADER]: context.dialog.key } : {},
+      ...context.dialog ? { [DIALOG_REDIRECT_HEADER]: context.dialog.redirectUrl ?? "" } : {},
+      ...utils.when(options.only !== void 0 || options.except !== void 0, {
+        [PARTIAL_COMPONENT_HEADER]: context.view.component,
+        ...utils.when(options.only, { [ONLY_DATA_HEADER]: JSON.stringify(options.only) }, {}),
+        ...utils.when(options.except, { [EXCEPT_DATA_HEADER]: JSON.stringify(options.except) }, {})
+      }, {}),
+      ...utils.when(options.errorBag, { [ERROR_BAG_HEADER]: options.errorBag }, {}),
+      ...utils.when(context.version, { [VERSION_HEADER]: context.version }, {}),
+      [HYBRIDLY_HEADER]: true,
+      "X-Requested-With": "XMLHttpRequest",
+      "Accept": "text/html, application/xhtml+xml"
+    },
+    validateStatus: () => true,
+    onUploadProgress: async (event) => {
+      await runHooks("progress", options.hooks, {
+        event,
+        percentage: Math.round(event.loaded / (event.total ?? 0) * 100)
+      }, context);
+    }
+  });
 }
 async function initializeRouter() {
   const context = getRouterContext();
@@ -887,7 +1012,6 @@ function can(resource, action) {
 exports.can = can;
 exports.constants = constants;
 exports.createRouter = createRouter;
-exports.current = current;
 exports.definePlugin = definePlugin;
 exports.getRouterContext = getRouterContext;
 exports.makeUrl = makeUrl;

package/dist/index.d.ts

@@ -70,6 +70,10 @@ interface Hooks extends RequestHooks {
      * Called when a component has been navigated to.
      */
     navigated: (options: NavigationOptions, context: InternalRouterContext) => MaybePromise<any>;
+    /**
+     * Called when a component has been navigated to and was mounted by the adapter.
+     */
+    mounted: (context: InternalRouterContext) => MaybePromise<any>;
 }
 interface HookOptions {
     /** Executes the hook only once. */
@@ -228,6 +232,12 @@ interface Router {
     external: (url: UrlResolvable, data?: HybridRequestOptions['data']) => void;
     /** Navigates to the given URL without a server round-trip. */
     local: (url: UrlResolvable, options: ComponentNavigationOptions) => Promise<void>;
+    /** Preloads the given URL. The next time this URL is navigated to, it will be loaded from the cache. */
+    preload: (url: UrlResolvable, options?: Omit<HybridRequestOptions, 'method' | 'url'>) => Promise<boolean>;
+    /** Determines if the given route name and parameters matches the current route. */
+    matches: <T extends RouteName>(name: T, parameters?: RouteParameters<T>) => boolean;
+    /** Gets the current route name. Returns `undefined` is unknown. */
+    current: () => string | undefined;
     /** Access the dialog router. */
     dialog: DialogRouter;
     /** Access the history state. */
@@ -368,6 +378,8 @@ interface InternalRouterContext {
     routing?: RoutingConfiguration;
     /** Whether to display response error modals. */
     responseErrorModals?: boolean;
+    /** Cache of preload requests. */
+    preloadCache: Map<string, AxiosResponse>;
 }
 /** Router context. */
 type RouterContext = Readonly<InternalRouterContext>;
@@ -382,7 +394,7 @@ interface Adapter {
     /** Called when a dialog is closed. */
     onDialogClose?: (context: InternalRouterContext) => void;
     /** Called when Hybridly is waiting for a component to be mounted. The given callback should be executed after the view component is mounted. */
-    onWaitingForMount: (callback: Function) => void;
+    executeOnMounted: (callback: Function) => void;
 }
 interface ResolvedAdapter extends Adapter {
     updateRoutingConfiguration: (routing?: RoutingConfiguration) => void;
@@ -426,10 +438,6 @@ declare function can<Authorizations extends Record<string, boolean>, Data extend
  * Generates a route from the given route name.
  */
 declare function route<T extends RouteName>(name: T, parameters?: RouteParameters<T>, absolute?: boolean): string;
-/**
- * Determines if the current route correspond to the given route name and parameters.
- */
-declare function current<T extends RouteName>(name: T, parameters?: RouteParameters<T>, mode?: 'loose' | 'strict'): boolean;
 
 interface DynamicConfiguration {
     architecture: {
@@ -492,4 +500,4 @@ declare namespace constants {
   };
 }
 
-export { Authorizable, DynamicConfiguration, GlobalRouteCollection, HybridPayload, HybridRequestOptions, MaybePromise, Method, NavigationResponse, Plugin, Progress, ResolveComponent, RouteDefinition, RouteName, RouteParameters, Router, RouterContext, RouterContextOptions, RoutingConfiguration, UrlResolvable, can, constants, createRouter, current, definePlugin, getRouterContext, makeUrl, registerHook, route, router, sameUrls };
+export { Authorizable, DynamicConfiguration, GlobalRouteCollection, HybridPayload, HybridRequestOptions, MaybePromise, Method, NavigationResponse, Plugin, Progress, ResolveComponent, RouteDefinition, RouteName, RouteParameters, Router, RouterContext, RouterContextOptions, RoutingConfiguration, UrlResolvable, can, constants, createRouter, definePlugin, getRouterContext, makeUrl, registerHook, route, router, sameUrls };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { debug, merge, removeTrailingSlash, debounce, random, hasFiles, objectToFormData, when, match, showResponseErrorModal } from '@hybridly/utils';
+import { debug, merge, removeTrailingSlash, debounce, random, hasFiles, objectToFormData, match, showResponseErrorModal, when } from '@hybridly/utils';
 import axios from 'axios';
 import { stringify, parse } from 'superjson';
 import qs from 'qs';
@@ -151,7 +151,7 @@ async function restoreScrollPositions() {
     debug.scroll("No region found to restore.");
     return;
   }
-  context.adapter.onWaitingForMount(() => {
+  context.adapter.executeOnMounted(() => {
     debug.scroll(`Restoring ${regions.length}/${context.scrollRegions.length} region(s).`);
     regions.forEach((el, i) => el.scrollTo({
       top: context.scrollRegions.at(i)?.top ?? el.scrollTop,
@@ -351,10 +351,59 @@ function createSerializer(options) {
   };
 }
 
+function getUrlRegexForRoute(name) {
+  const routing = getRouting();
+  const definition = getRouteDefinition(name);
+  const path = definition.uri.replaceAll("/", "\\/");
+  const domain = definition.domain;
+  const protocolPrefix = routing.url.match(/^\w+:\/\//)?.[0];
+  const origin = domain ? `${protocolPrefix}${domain}${routing.port ? `:${routing.port}` : ""}`.replaceAll("/", "\\/") : routing.url.replaceAll("/", "\\/");
+  const urlPathRegexPattern = path.length > 0 ? `\\/${path.replace(/\/$/g, "")}` : "";
+  let urlRegexPattern = `^${origin.replaceAll(".", "\\.")}${urlPathRegexPattern}\\/?(\\?.*)?$`;
+  urlRegexPattern = urlRegexPattern.replace(/(\\\/?){([^}?]+)(\??)}/g, (_, slash, parameterName, optional) => {
+    const where = definition.wheres?.[parameterName];
+    let regexTemplate = where?.replace(/(^\^)|(\$$)/g, "") || "[^/?]+";
+    regexTemplate = `(?<${parameterName}>${regexTemplate})`;
+    if (optional) {
+      return `(${slash ? "\\/?" : ""}${regexTemplate})?`;
+    }
+    return (slash ? "\\/" : "") + regexTemplate;
+  });
+  return RegExp(urlRegexPattern);
+}
+function urlMatchesRoute(url, name, routeParameters) {
+  const parameters = routeParameters || {};
+  const definition = getRouting().routes[name];
+  if (!definition) {
+    return false;
+  }
+  const matches = getUrlRegexForRoute(name).exec(url);
+  if (!matches) {
+    return false;
+  }
+  for (const k in matches.groups) {
+    matches.groups[k] = typeof matches.groups[k] === "string" ? decodeURIComponent(matches.groups[k]) : matches.groups[k];
+  }
+  return Object.keys(parameters).every((parameterName) => {
+    let value = parameters[parameterName];
+    const bindingProperty = definition.bindings?.[parameterName];
+    if (bindingProperty && typeof value === "object") {
+      value = value[bindingProperty];
+    }
+    return matches.groups?.[parameterName] === value.toString();
+  });
+}
 function generateRouteFromName(name, parameters, absolute, shouldThrow) {
   const url = getUrlFromName(name, parameters, shouldThrow);
   return absolute === false ? url.toString().replace(url.origin, "") : url.toString();
 }
+function getNameFromUrl(url, parameters) {
+  const routing = getRouting();
+  const routes = Object.values(routing.routes).map((x) => x.name);
+  return routes.find((routeName) => {
+    return urlMatchesRoute(url, routeName, parameters);
+  });
+}
 function getUrlFromName(name, parameters, shouldThrow) {
   const routing = getRouting();
   const definition = getRouteDefinition(name);
@@ -367,32 +416,39 @@ function getUrlFromName(name, parameters, shouldThrow) {
   }));
   return url;
 }
-function getRouteTransformable(routeName, routeParameters, shouldThrow) {
+function getRouteParameterValue(routeName, parameterName, routeParameters) {
   const routing = getRouting();
+  const definition = getRouteDefinition(routeName);
+  const parameters = routeParameters || {};
+  const value = (() => {
+    const value2 = parameters[parameterName];
+    const bindingProperty = definition.bindings?.[parameterName];
+    if (bindingProperty && value2 != null && typeof value2 === "object") {
+      return value2[bindingProperty];
+    }
+    return value2;
+  })();
+  if (value) {
+    const where = definition.wheres?.[parameterName];
+    if (where && !new RegExp(where).test(value)) {
+      console.warn(`[hybridly:routing] Parameter [${parameterName}] does not match the required format [${where}] for route [${routeName}].`);
+    }
+    return value;
+  }
+  if (routing.defaults?.[parameterName]) {
+    return routing.defaults?.[parameterName];
+  }
+}
+function getRouteTransformable(routeName, routeParameters, shouldThrow) {
   const definition = getRouteDefinition(routeName);
   const parameters = routeParameters || {};
   const missing = Object.keys(parameters);
-  const replaceParameter = (match, parameterName) => {
-    const optional = /\?}$/.test(match);
-    const value = (() => {
-      const value2 = parameters[parameterName];
-      const bindingProperty = definition.bindings?.[parameterName];
-      if (bindingProperty && typeof value2 === "object") {
-        return value2[bindingProperty];
-      }
-      return value2;
-    })();
+  const replaceParameter = (match, parameterName, optional) => {
+    const value = getRouteParameterValue(routeName, parameterName, parameters);
     missing.splice(missing.indexOf(parameterName), 1);
     if (value) {
-      const where = definition.wheres?.[parameterName];
-      if (where && !new RegExp(where).test(value)) {
-        console.warn(`[hybridly:routing] Parameter [${parameterName}] does not match the required format [${where}] for route [${routeName}].`);
-      }
       return value;
     }
-    if (routing.defaults?.[parameterName]) {
-      return routing.defaults?.[parameterName];
-    }
     if (optional) {
       return "";
     }
@@ -401,8 +457,8 @@ function getRouteTransformable(routeName, routeParameters, shouldThrow) {
     }
     throw new MissingRouteParameter(parameterName, routeName);
   };
-  const path = definition.uri.replace(/{([^}?]+)\??}/g, replaceParameter);
-  const domain = definition.domain?.replace(/{([^}?]+)\??}/g, replaceParameter);
+  const path = definition.uri.replace(/{([^}?]+)(\??)}/g, replaceParameter);
+  const domain = definition.domain?.replace(/{([^}?]+)(\??)}/g, replaceParameter);
   const remaining = Object.keys(parameters).filter((key) => missing.includes(key)).reduce((obj, key) => ({
     ...obj,
     [key]: parameters[key]
@@ -432,30 +488,28 @@ function getRouting() {
   }
   return routing;
 }
-
-function isCurrentFromName(name, parameters, mode = "loose") {
-  const location = window.location;
-  const matchee = (() => {
-    try {
-      return makeUrl(generateRouteFromName(name, parameters, true, false));
-    } catch (error) {
-    }
-  })();
-  if (!matchee) {
-    return false;
-  }
-  if (mode === "strict") {
-    return location.href === matchee.href;
-  }
-  return location.href.startsWith(matchee.href);
-}
-
 function route(name, parameters, absolute) {
   return generateRouteFromName(name, parameters, absolute);
 }
-function current(name, parameters, mode = "loose") {
-  return isCurrentFromName(name, parameters, mode);
+
+function getCurrentUrl() {
+  if (typeof window === "undefined") {
+    return getInternalRouterContext().url;
+  }
+  return window.location.toString();
+}
+function currentRouteMatches(name, parameters) {
+  const namePattern = name.replaceAll(".", "\\.").replaceAll("*", ".*");
+  const possibleRoutes = Object.values(getRouting().routes).filter((x) => x.method.includes("GET") && RegExp(namePattern).test(x.name)).map((x) => x.name);
+  const currentUrl = getCurrentUrl();
+  return possibleRoutes.some((routeName) => {
+    return urlMatchesRoute(currentUrl, routeName, parameters);
+  });
+}
+function getCurrentRouteName() {
+  return getNameFromUrl(getCurrentUrl());
 }
+
 function updateRoutingConfiguration(routing) {
   if (!routing) {
     return;
@@ -491,6 +545,7 @@ async function initializeContext(options) {
     plugins: options.plugins ?? [],
     axios: options.axios ?? axios.create(),
     routing: options.routing,
+    preloadCache: /* @__PURE__ */ new Map(),
     hooks: {},
     memo: {}
   };
@@ -581,6 +636,52 @@ async function closeDialog(options) {
   });
 }
 
+function isPreloaded(targetUrl) {
+  const context = getInternalRouterContext();
+  return context.preloadCache.has(targetUrl.toString()) ?? false;
+}
+function getPreloadedRequest(targetUrl) {
+  const context = getInternalRouterContext();
+  return context.preloadCache.get(targetUrl.toString());
+}
+function storePreloadRequest(targetUrl, response) {
+  const context = getInternalRouterContext();
+  context.preloadCache.set(targetUrl.toString(), response);
+}
+function discardPreloadedRequest(targetUrl) {
+  const context = getInternalRouterContext();
+  return context.preloadCache.delete(targetUrl.toString());
+}
+async function performPreloadRequest(options) {
+  const context = getRouterContext();
+  const url = makeUrl(options.url ?? context.url);
+  if (isPreloaded(url)) {
+    debug.router("This request is already preloaded.");
+    return false;
+  }
+  if (context.pendingNavigation) {
+    debug.router("A navigation is pending, preload aborted.");
+    return false;
+  }
+  if (options.method !== "GET") {
+    debug.router("Cannot preload non-GET requests.");
+    return false;
+  }
+  debug.router(`Preloading response for [${url.toString()}]`);
+  try {
+    const response = await performHybridRequest(url, options);
+    if (!isHybridResponse(response)) {
+      debug.router("Preload result was invalid.");
+      return false;
+    }
+    storePreloadRequest(url, response);
+    return true;
+  } catch (error) {
+    debug.router("Preloading failed.");
+    return false;
+  }
+}
+
 const router = {
   abort: async () => getRouterContext().pendingNavigation?.controller.abort(),
   active: () => !!getRouterContext().pendingNavigation,
@@ -592,12 +693,15 @@ const router = {
   patch: async (url, options = {}) => await performHybridNavigation({ preserveState: true, ...options, url, method: "PATCH" }),
   delete: async (url, options = {}) => await performHybridNavigation({ preserveState: true, ...options, url, method: "DELETE" }),
   local: async (url, options = {}) => await performLocalNavigation(url, options),
+  preload: async (url, options = {}) => await performPreloadRequest({ ...options, url, method: "GET" }),
   external: (url, data = {}) => navigateToExternalUrl(url, data),
   to: async (name, parameters, options) => {
     const url = generateRouteFromName(name, parameters);
     const method = getRouteDefinition(name).method.at(0);
     return await performHybridNavigation({ url, ...options, method });
   },
+  matches: (name, parameters) => currentRouteMatches(name, parameters),
+  current: () => getCurrentRouteName(),
   dialog: {
     close: (options) => closeDialog(options)
   },
@@ -623,11 +727,6 @@ async function performHybridNavigation(options) {
     if ((hasFiles(options.data) || options.useFormData) && !(options.data instanceof FormData)) {
       options.data = objectToFormData(options.data);
       debug.router("Converted data to FormData.", options.data);
-      if (options.method && ["PUT", "PATCH", "DELETE"].includes(options.method) && options.spoof !== false) {
-        debug.router(`Automatically spoofing method ${options.method}.`);
-        options.data.append("_method", options.method);
-        options.method = "POST";
-      }
     }
     if (!(options.data instanceof FormData) && options.method === "GET" && Object.keys(options.data ?? {}).length) {
       debug.router("Transforming data to query parameters.", options.data);
@@ -636,6 +735,19 @@ async function performHybridNavigation(options) {
       });
       options.data = {};
     }
+    if (["PUT", "PATCH", "DELETE"].includes(options.method) && options.spoof !== false) {
+      debug.router(`Automatically spoofing method ${options.method}.`);
+      if (options.data instanceof FormData) {
+        options.data.append("_method", options.method);
+      } else if (Object.keys(options.data ?? {}).length) {
+        Object.assign(options.data, { _method: options.method });
+      } else if (typeof options.data === "undefined") {
+        options.data = { _method: options.method };
+      } else {
+        debug.router("Could not spoof method because body type is not supported.", options.data);
+      }
+      options.method = "POST";
+    }
     if (!await runHooks("before", options.hooks, options, context)) {
       debug.router('"before" event returned false, aborting the navigation.');
       throw new NavigationCancelledError('The navigation was cancelled by the "before" event.');
@@ -661,35 +773,7 @@ async function performHybridNavigation(options) {
     });
     await runHooks("start", options.hooks, context);
     debug.router("Making request with axios.");
-    const response = await context.axios.request({
-      url: targetUrl.toString(),
-      method: options.method,
-      data: options.method === "GET" ? {} : options.data,
-      params: options.method === "GET" ? options.data : {},
-      signal: abortController.signal,
-      headers: {
-        ...options.headers,
-        ...context.dialog ? { [DIALOG_KEY_HEADER]: context.dialog.key } : {},
-        ...context.dialog ? { [DIALOG_REDIRECT_HEADER]: context.dialog.redirectUrl ?? "" } : {},
-        ...when(options.only !== void 0 || options.except !== void 0, {
-          [PARTIAL_COMPONENT_HEADER]: context.view.component,
-          ...when(options.only, { [ONLY_DATA_HEADER]: JSON.stringify(options.only) }, {}),
-          ...when(options.except, { [EXCEPT_DATA_HEADER]: JSON.stringify(options.except) }, {})
-        }, {}),
-        ...when(options.errorBag, { [ERROR_BAG_HEADER]: options.errorBag }, {}),
-        ...when(context.version, { [VERSION_HEADER]: context.version }, {}),
-        [HYBRIDLY_HEADER]: true,
-        "X-Requested-With": "XMLHttpRequest",
-        "Accept": "text/html, application/xhtml+xml"
-      },
-      validateStatus: () => true,
-      onUploadProgress: async (event) => {
-        await runHooks("progress", options.hooks, {
-          event,
-          percentage: Math.round(event.loaded / (event.total ?? 0) * 100)
-        }, context);
-      }
-    });
+    const response = await performHybridRequest(targetUrl, options, abortController);
     await runHooks("data", options.hooks, response, context);
     if (isExternalResponse(response)) {
       debug.router("The response is explicitely external.");
@@ -833,6 +917,47 @@ async function navigate(options) {
     resetScrollPositions();
   }
   await runHooks("navigated", {}, options, context);
+  context.adapter.executeOnMounted(() => {
+    runHooks("mounted", {}, context);
+  });
+}
+async function performHybridRequest(targetUrl, options, abortController) {
+  const context = getInternalRouterContext();
+  const preloaded = getPreloadedRequest(targetUrl);
+  if (preloaded) {
+    debug.router(`Found a pre-loaded request for [${targetUrl}]`);
+    discardPreloadedRequest(targetUrl);
+    return preloaded;
+  }
+  return await context.axios.request({
+    url: targetUrl.toString(),
+    method: options.method,
+    data: options.method === "GET" ? {} : options.data,
+    params: options.method === "GET" ? options.data : {},
+    signal: abortController?.signal,
+    headers: {
+      ...options.headers,
+      ...context.dialog ? { [DIALOG_KEY_HEADER]: context.dialog.key } : {},
+      ...context.dialog ? { [DIALOG_REDIRECT_HEADER]: context.dialog.redirectUrl ?? "" } : {},
+      ...when(options.only !== void 0 || options.except !== void 0, {
+        [PARTIAL_COMPONENT_HEADER]: context.view.component,
+        ...when(options.only, { [ONLY_DATA_HEADER]: JSON.stringify(options.only) }, {}),
+        ...when(options.except, { [EXCEPT_DATA_HEADER]: JSON.stringify(options.except) }, {})
+      }, {}),
+      ...when(options.errorBag, { [ERROR_BAG_HEADER]: options.errorBag }, {}),
+      ...when(context.version, { [VERSION_HEADER]: context.version }, {}),
+      [HYBRIDLY_HEADER]: true,
+      "X-Requested-With": "XMLHttpRequest",
+      "Accept": "text/html, application/xhtml+xml"
+    },
+    validateStatus: () => true,
+    onUploadProgress: async (event) => {
+      await runHooks("progress", options.hooks, {
+        event,
+        percentage: Math.round(event.loaded / (event.total ?? 0) * 100)
+      }, context);
+    }
+  });
 }
 async function initializeRouter() {
   const context = getRouterContext();
@@ -875,4 +1000,4 @@ function can(resource, action) {
   return resource.authorization?.[action] ?? false;
 }
 
-export { can, constants, createRouter, current, definePlugin, getRouterContext, makeUrl, registerHook, route, router, sameUrls };
+export { can, constants, createRouter, definePlugin, getRouterContext, makeUrl, registerHook, route, router, sameUrls };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hybridly/core",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Core functionality of Hybridly",
   "keywords": [
     "hybridly",
@@ -37,8 +37,8 @@
   },
   "dependencies": {
     "qs": "^6.11.2",
-    "superjson": "^1.12.3",
-    "@hybridly/utils": "0.4.0"
+    "superjson": "^1.12.4",
+    "@hybridly/utils": "0.4.2"
   },
   "devDependencies": {
     "defu": "^6.1.2"