clear-router 2.5.13 → 2.5.14

package/dist/hono/index.d.cts

@@ -1,4 +1,4 @@
-import { C as ControllerAction, E as Response, S as ApiResourceMiddleware, T as HttpMethod, m as Route, p as Request, t as CoreRouter, w as ControllerHandler } from "../router-DTI0BowV.cjs";
+import { C as ControllerAction, E as Response, S as ApiResourceMiddleware, T as HttpMethod, m as Route, p as Request, t as CoreRouter, w as ControllerHandler } from "../router-jwZwD8ZT.cjs";
 import { Context, HonoRequest, MiddlewareHandler } from "hono";
 
 //#region types/hono.d.ts
@@ -36,7 +36,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static add(methods: HttpMethod | HttpMethod[], path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static add(methods: HttpMethod | HttpMethod[], path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Define a resourceful API controller with standard CRUD routes
    *
@@ -56,7 +56,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static get(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static get(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Define a POST route
    *
@@ -64,7 +64,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static post(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static post(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Define a PUT route
    *
@@ -72,7 +72,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static put(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static put(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Define a DELETE route
    *
@@ -80,7 +80,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static delete(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static delete(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Define a PATCH route
    *
@@ -88,7 +88,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static patch(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static patch(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Define an OPTIONS route
    *
@@ -96,7 +96,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static options(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static options(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Define a HEAD route
    *
@@ -104,7 +104,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static head(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static head(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Defines a group of routes with a common prefix.
    *
@@ -132,6 +132,8 @@ declare class Router extends CoreRouter {
    * @param type  - 'method' to get routes organized by method
    */
   static allRoutes(type: 'method'): { [method in Uppercase<HttpMethod>]?: Array<Route<HttpContext, Middleware, Handler>> };
+  static allRoutes(type: 'name'): Record<string, Route<HttpContext, Middleware, Handler>>;
+  static route(name: string): Route<HttpContext, Middleware, Handler> | undefined;
   /**
    * Apply the defined routes to a Hono application instance
    *

package/dist/hono/index.d.mts

@@ -1,4 +1,4 @@
-import { C as ControllerAction, E as Response, S as ApiResourceMiddleware, T as HttpMethod, m as Route, p as Request, t as CoreRouter, w as ControllerHandler } from "../router-DiKqUyvk.mjs";
+import { C as ControllerAction, E as Response, S as ApiResourceMiddleware, T as HttpMethod, m as Route, p as Request, t as CoreRouter, w as ControllerHandler } from "../router-Bk8mXRu1.mjs";
 import { Context, HonoRequest, MiddlewareHandler } from "hono";
 
 //#region types/hono.d.ts
@@ -36,7 +36,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static add(methods: HttpMethod | HttpMethod[], path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static add(methods: HttpMethod | HttpMethod[], path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Define a resourceful API controller with standard CRUD routes
    *
@@ -56,7 +56,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static get(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static get(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Define a POST route
    *
@@ -64,7 +64,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static post(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static post(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Define a PUT route
    *
@@ -72,7 +72,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static put(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static put(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Define a DELETE route
    *
@@ -80,7 +80,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static delete(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static delete(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Define a PATCH route
    *
@@ -88,7 +88,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static patch(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static patch(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Define an OPTIONS route
    *
@@ -96,7 +96,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static options(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static options(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Define a HEAD route
    *
@@ -104,7 +104,7 @@ declare class Router extends CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static head(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): void;
+  static head(path: string, handler: Handler, middlewares?: Middleware[] | Middleware): Route<HttpContext, Middleware, Handler>;
   /**
    * Defines a group of routes with a common prefix.
    *
@@ -132,6 +132,8 @@ declare class Router extends CoreRouter {
    * @param type  - 'method' to get routes organized by method
    */
   static allRoutes(type: 'method'): { [method in Uppercase<HttpMethod>]?: Array<Route<HttpContext, Middleware, Handler>> };
+  static allRoutes(type: 'name'): Record<string, Route<HttpContext, Middleware, Handler>>;
+  static route(name: string): Route<HttpContext, Middleware, Handler> | undefined;
   /**
    * Apply the defined routes to a Hono application instance
    *

package/dist/hono/index.mjs

@@ -1,5 +1,5 @@
 import "../bindings-XLDXFpHZ.mjs";
-import { t as CoreRouter } from "../router-CPmZcbU0.mjs";
+import { t as CoreRouter } from "../router-DSq9dtuQ.mjs";
 import { n as resolveResponseMeta } from "../responses-BvETUeDL.mjs";
 
 //#region src/hono/router.ts
@@ -59,7 +59,7 @@ var Router = class Router extends CoreRouter {
 	* @param middlewares 
 	*/
 	static add(methods, path, handler, middlewares) {
-		super.add(methods, path, handler, middlewares);
+		return super.add(methods, path, handler, middlewares);
 	}
 	/**
 	* Define a resourceful API controller with standard CRUD routes
@@ -79,7 +79,7 @@ var Router = class Router extends CoreRouter {
 	* @param middlewares 
 	*/
 	static get(path, handler, middlewares) {
-		super.get(path, handler, middlewares);
+		return super.get(path, handler, middlewares);
 	}
 	/**
 	* Define a POST route
@@ -89,7 +89,7 @@ var Router = class Router extends CoreRouter {
 	* @param middlewares 
 	*/
 	static post(path, handler, middlewares) {
-		super.post(path, handler, middlewares);
+		return super.post(path, handler, middlewares);
 	}
 	/**
 	* Define a PUT route
@@ -99,7 +99,7 @@ var Router = class Router extends CoreRouter {
 	* @param middlewares 
 	*/
 	static put(path, handler, middlewares) {
-		super.put(path, handler, middlewares);
+		return super.put(path, handler, middlewares);
 	}
 	/**
 	* Define a DELETE route
@@ -109,7 +109,7 @@ var Router = class Router extends CoreRouter {
 	* @param middlewares 
 	*/
 	static delete(path, handler, middlewares) {
-		super.delete(path, handler, middlewares);
+		return super.delete(path, handler, middlewares);
 	}
 	/**
 	* Define a PATCH route 
@@ -119,7 +119,7 @@ var Router = class Router extends CoreRouter {
 	* @param middlewares 
 	*/
 	static patch(path, handler, middlewares) {
-		super.patch(path, handler, middlewares);
+		return super.patch(path, handler, middlewares);
 	}
 	/**
 	* Define an OPTIONS route
@@ -129,7 +129,7 @@ var Router = class Router extends CoreRouter {
 	* @param middlewares 
 	*/
 	static options(path, handler, middlewares) {
-		super.options(path, handler, middlewares);
+		return super.options(path, handler, middlewares);
 	}
 	/**
 	* Define a HEAD route
@@ -139,7 +139,7 @@ var Router = class Router extends CoreRouter {
 	* @param middlewares 
 	*/
 	static head(path, handler, middlewares) {
-		super.head(path, handler, middlewares);
+		return super.head(path, handler, middlewares);
 	}
 	/**
 	* Defines a group of routes with a common prefix.
@@ -163,6 +163,9 @@ var Router = class Router extends CoreRouter {
 	static allRoutes(type) {
 		return super.allRoutes(type);
 	}
+	static route(name) {
+		return super.route(name);
+	}
 	/**
 	* Apply the defined routes to a Hono application instance
 	* 
@@ -202,7 +205,7 @@ var Router = class Router extends CoreRouter {
 				];
 				if (method === "options" && route.methods.length > 1) continue;
 				if (!allowedMethods.includes(method)) throw new Error(`Invalid HTTP method: ${method} for route: ${route.path}`);
-				app[method](route.path, ...route.middlewares || [], async (context) => {
+				for (const registrationPath of route.registrationPaths) app[method](registrationPath, ...route.middlewares || [], async (context) => {
 					const ctx = context;
 					const reqBody = await Router.readBodyCached(ctx);
 					const override = Router.resolveMethodOverride(ctx.req.method, ctx.req.header(), reqBody);
@@ -223,7 +226,7 @@ var Router = class Router extends CoreRouter {
 					"put",
 					"patch",
 					"delete"
-				].includes(method)) app.post(route.path, ...route.middlewares || [], async (context) => {
+				].includes(method)) for (const registrationPath of route.registrationPaths) app.post(registrationPath, ...route.middlewares || [], async (context) => {
 					const ctx = context;
 					const reqBody = await Router.readBodyCached(ctx);
 					if (Router.resolveMethodOverride(ctx.req.method, ctx.req.header(), reqBody) !== method) return;

package/dist/index.cjs

@@ -41,21 +41,49 @@ var Route = class {
 	clearRequest;
 	methods;
 	path;
+	registrationPaths;
+	parameters;
+	routeName;
 	handler;
 	middlewares;
 	controllerName;
 	actionName;
 	handlerType;
 	middlewareCount;
-	constructor(methods, path, handler, middlewares = []) {
+	constructor(methods, path, handler, middlewares = [], options = {}) {
 		this.methods = methods;
 		this.path = path;
+		this.registrationPaths = options.registrationPaths || [path];
+		this.parameters = options.parameters || [];
 		this.handler = handler;
 		this.middlewares = middlewares;
 		this.handlerType = Array.isArray(handler) ? "controller" : "function";
 		this.middlewareCount = middlewares.length;
 		this.controllerName = Array.isArray(handler) ? handler[0]?.name : void 0;
 		this.actionName = Array.isArray(handler) ? handler[1] : typeof handler === "function" ? handler.constructor.name ?? handler.name : void 0;
+		this.onName = options.onName;
+	}
+	onName;
+	name(name) {
+		const previousName = this.routeName;
+		this.routeName = name;
+		this.onName?.(name, this, previousName);
+		return this;
+	}
+	toPath(params = {}) {
+		return this.path.replace(/\/?\{([^{}]+)\}/g, (segment, raw) => {
+			const optional = raw.endsWith("?");
+			const [rawName, rawField] = (optional ? raw.slice(0, -1) : raw).split(":", 2);
+			const name = rawName.trim();
+			const field = rawField?.trim();
+			const value = params[name];
+			const resolved = field && value && typeof value === "object" ? value[field] : value;
+			if (typeof resolved === "undefined" || resolved === null || resolved === "") {
+				if (optional) return "";
+				throw new Error(`Missing required route parameter: ${name}`);
+			}
+			return `${segment.startsWith("/") ? "/" : ""}${encodeURIComponent(String(resolved))}`;
+		}) || "/";
 	}
 };
 
@@ -334,6 +362,7 @@ var CoreRouter = class {
 			routes: [],
 			routesByPathMethod: {},
 			routesByMethod: {},
+			routesByName: {},
 			prefix: "",
 			groupMiddlewares: [],
 			globalMiddlewares: []
@@ -350,6 +379,7 @@ var CoreRouter = class {
 			"routes",
 			"routesByPathMethod",
 			"routesByMethod",
+			"routesByName",
 			"prefix",
 			"groupMiddlewares",
 			"globalMiddlewares"
@@ -482,6 +512,7 @@ var CoreRouter = class {
 	static routes = [];
 	static routesByPathMethod = {};
 	static routesByMethod = {};
+	static routesByName = {};
 	static prefix = "";
 	static groupMiddlewares = [];
 	static globalMiddlewares = [];
@@ -533,6 +564,7 @@ var CoreRouter = class {
 		if (!Array.isArray(this.routes)) this.routes = [];
 		if (!this.routesByPathMethod || typeof this.routesByPathMethod !== "object") this.routesByPathMethod = {};
 		if (!this.routesByMethod || typeof this.routesByMethod !== "object") this.routesByMethod = {};
+		if (!this.routesByName || typeof this.routesByName !== "object") this.routesByName = {};
 		if (typeof this.prefix !== "string") this.prefix = "";
 		if (!Array.isArray(this.groupMiddlewares)) this.groupMiddlewares = [];
 		if (!Array.isArray(this.globalMiddlewares)) this.globalMiddlewares = [];
@@ -547,6 +579,47 @@ var CoreRouter = class {
 	static normalizePath(path) {
 		return "/" + path.split("/").filter(Boolean).join("/");
 	}
+	static parseRouteParameters(path) {
+		const parameters = [];
+		const seen = /* @__PURE__ */ new Set();
+		const pattern = /\{([^{}]+)\}/g;
+		let match;
+		while ((match = pattern.exec(path)) !== null) {
+			const raw = match[1].trim();
+			const optional = raw.endsWith("?");
+			const [name, field] = (optional ? raw.slice(0, -1) : raw).split(":", 2).map((part) => part.trim());
+			if (!name || seen.has(name)) continue;
+			seen.add(name);
+			parameters.push({
+				name,
+				field: field || void 0,
+				optional
+			});
+		}
+		return parameters;
+	}
+	static expandRoutePath(path) {
+		let paths = [""];
+		const segments = this.normalizePath(path).split("/").filter(Boolean);
+		for (const segment of segments) {
+			const match = segment.match(/^\{([^{}]+)\}$/);
+			if (!match) {
+				paths = paths.map((current) => `${current}/${segment}`);
+				continue;
+			}
+			const raw = match[1].trim();
+			const optional = raw.endsWith("?");
+			const [rawName] = (optional ? raw.slice(0, -1) : raw).split(":", 2);
+			const name = rawName.trim();
+			if (!name) continue;
+			const parameterSegment = `/:${name}`;
+			paths = optional ? paths.flatMap((current) => [current, `${current}${parameterSegment}`]) : paths.map((current) => `${current}${parameterSegment}`);
+		}
+		return paths.map((path) => path || "/");
+	}
+	static routeRegistrationPaths(path) {
+		return this.expandRoutePath(path);
+	}
 	/**
 	* Configures the router with the given options, such as method override settings.
 	* 
@@ -620,11 +693,20 @@ var CoreRouter = class {
 		methods = Array.isArray(methods) ? methods : [methods];
 		middlewares = middlewares ? Array.isArray(middlewares) ? middlewares : [middlewares] : void 0;
 		const fullPath = this.normalizePath(`${activePrefix}/${path}`);
+		const registrationPaths = this.routeRegistrationPaths(fullPath);
+		const parameters = this.parseRouteParameters(fullPath);
 		const route = new Route(methods.includes("options") ? methods : methods.concat("options"), fullPath, handler, [
 			...this.globalMiddlewares,
 			...activeGroupMiddlewares,
 			...middlewares || []
-		]);
+		], {
+			registrationPaths,
+			parameters,
+			onName: (name, route, previousName) => {
+				if (previousName && this.routesByName[previousName] === route) delete this.routesByName[previousName];
+				this.routesByName[name] = route;
+			}
+		});
 		if (!methods.includes("options") && !this.routesByPathMethod[`OPTIONS ${fullPath}`]) this.options(path, this.createDefaultOptionsHandler());
 		this.routes.push(route);
 		for (const method of methods.map((m) => m.toUpperCase())) {
@@ -632,6 +714,7 @@ var CoreRouter = class {
 			if (!this.routesByMethod[method]) this.routesByMethod[method] = [];
 			this.routesByMethod[method].push(route);
 		}
+		return route;
 	}
 	/**
 	* Define a resourceful API controller with standard CRUD routes.
@@ -685,7 +768,7 @@ var CoreRouter = class {
 	* @param middlewares   Optional middlewares to apply to the GET route.
 	*/
 	static get(path, handler, middlewares) {
-		this.add("get", path, handler, middlewares);
+		return this.add("get", path, handler, middlewares);
 	}
 	/**
 	* Adds a new POST route to the router.
@@ -696,7 +779,7 @@ var CoreRouter = class {
 	* @param middlewares 
 	*/
 	static post(path, handler, middlewares) {
-		this.add("post", path, handler, middlewares);
+		return this.add("post", path, handler, middlewares);
 	}
 	/**
 	* Adds a new PUT route to the router.
@@ -707,7 +790,7 @@ var CoreRouter = class {
 	* @param middlewares 
 	*/
 	static put(path, handler, middlewares) {
-		this.add("put", path, handler, middlewares);
+		return this.add("put", path, handler, middlewares);
 	}
 	/**
 	* Adds a new DELETE route to the router.
@@ -718,7 +801,7 @@ var CoreRouter = class {
 	* @param middlewares 
 	*/
 	static delete(path, handler, middlewares) {
-		this.add("delete", path, handler, middlewares);
+		return this.add("delete", path, handler, middlewares);
 	}
 	/**
 	* Adds a new PATCH route to the router.
@@ -729,7 +812,7 @@ var CoreRouter = class {
 	* @param middlewares 
 	*/
 	static patch(path, handler, middlewares) {
-		this.add("patch", path, handler, middlewares);
+		return this.add("patch", path, handler, middlewares);
 	}
 	/**
 	* Adds a new OPTIONS route to the router.
@@ -740,7 +823,7 @@ var CoreRouter = class {
 	* @param middlewares 
 	*/
 	static options(path, handler, middlewares) {
-		this.add("options", path, handler, middlewares);
+		return this.add("options", path, handler, middlewares);
 	}
 	/**
 	* Adds a new HEAD route to the router.
@@ -751,7 +834,7 @@ var CoreRouter = class {
 	* @param middlewares 
 	*/
 	static head(path, handler, middlewares) {
-		this.add("head", path, handler, middlewares);
+		return this.add("head", path, handler, middlewares);
 	}
 	/**
 	* Defines a group of routes with a common prefix.
@@ -793,8 +876,16 @@ var CoreRouter = class {
 		this.ensureState();
 		if (type === "method") return this.routesByMethod;
 		if (type === "path") return this.routesByPathMethod;
+		if (type === "name") return this.routesByName;
 		return this.routes.filter((e) => e.methods.length > 1 || e.methods[0] !== "options");
 	}
+	static route(name) {
+		this.ensureState();
+		return this.routesByName[name];
+	}
+	static url(name, params) {
+		return this.route(name)?.toPath(params);
+	}
 	static resolveHandler(route) {
 		let handlerFunction;
 		let instance = null;
@@ -861,8 +952,7 @@ var CoreRouter = class {
 				designTokens
 			});
 			if (pluginArgs) return handlerFunction(...pluginArgs);
-			if (!metadata) return handlerFunction(ctx, ctx.clearRequest);
-			if (!tokens.length) return handlerFunction(ctx, ctx.clearRequest);
+			if (!metadata || !tokens.length) return handlerFunction(ctx, ctx.clearRequest);
 			const args = [];
 			for (const token of tokens) {
 				const resolved = await Container.resolve(token, ctx, Boolean(this.config.container?.autoDiscover));

package/dist/index.d.cts

@@ -58,6 +58,11 @@ declare class Response$1 {
 }
 //#endregion
 //#region src/Route.d.ts
+interface RouteParameter {
+  name: string;
+  field?: string;
+  optional: boolean;
+}
 declare class Route<X = any, M = Middleware$1 | Middleware, H = any> {
   ctx: X;
   body: RequestData;
@@ -66,13 +71,23 @@ declare class Route<X = any, M = Middleware$1 | Middleware, H = any> {
   clearRequest: ClearRequest;
   methods: HttpMethod[];
   path: string;
+  registrationPaths: string[];
+  parameters: RouteParameter[];
+  routeName?: string;
   handler: H;
   middlewares: M[];
   controllerName?: string;
   actionName?: string;
   handlerType: 'function' | 'controller';
   middlewareCount: number;
-  constructor(methods: HttpMethod[], path: string, handler: H, middlewares?: M[]);
+  constructor(methods: HttpMethod[], path: string, handler: H, middlewares?: M[], options?: {
+    registrationPaths?: string[];
+    parameters?: RouteParameter[];
+    onName?: (name: string, route: Route<X, M, H>, previousName?: string) => void;
+  });
+  private onName?;
+  name(name: string): this;
+  toPath(params?: RequestData): string;
 }
 //#endregion
 //#region src/core/Request.d.ts
@@ -222,6 +237,7 @@ declare abstract class CoreRouter {
     routes: Array<Route<any, any, any>>;
     routesByPathMethod: Record<string, Route<any, any, any>>;
     routesByMethod: { [method in Uppercase<HttpMethod>]?: Array<Route<any, any, any>> };
+    routesByName: Record<string, Route<any, any, any>>;
     prefix: string;
     groupMiddlewares: any[];
     globalMiddlewares: any[];
@@ -248,6 +264,7 @@ declare abstract class CoreRouter {
   static routes: Array<Route<any, any, any>>;
   static routesByPathMethod: Record<string, Route<any, any, any>>;
   static routesByMethod: { [method in Uppercase<HttpMethod>]?: Array<Route<any, any, any>> };
+  static routesByName: Record<string, Route<any, any, any>>;
   static prefix: string;
   static groupMiddlewares: any[];
   static globalMiddlewares: any[];
@@ -264,6 +281,13 @@ declare abstract class CoreRouter {
    * @returns     The normalized path.
    */
   static normalizePath(path: string): string;
+  protected static parseRouteParameters(path: string): Array<{
+    name: string;
+    field?: string;
+    optional: boolean;
+  }>;
+  protected static expandRoutePath(path: string): string[];
+  protected static routeRegistrationPaths(path: string): string[];
   /**
    * Configures the router with the given options, such as method override settings.
    *
@@ -282,7 +306,7 @@ declare abstract class CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static add(methods: HttpMethod | HttpMethod[], path: string, handler: any, middlewares?: any[] | any): void;
+  static add(methods: HttpMethod | HttpMethod[], path: string, handler: any, middlewares?: any[] | any): Route<any, any, any>;
   /**
    * Define a resourceful API controller with standard CRUD routes.
    *
@@ -304,7 +328,7 @@ declare abstract class CoreRouter {
    * @param handler       The handler function for the GET route.
    * @param middlewares   Optional middlewares to apply to the GET route.
    */
-  static get(path: string, handler: any, middlewares?: any[] | any): void;
+  static get(path: string, handler: any, middlewares?: any[] | any): Route<any, any, any>;
   /**
    * Adds a new POST route to the router.
    *
@@ -313,7 +337,7 @@ declare abstract class CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static post(path: string, handler: any, middlewares?: any[] | any): void;
+  static post(path: string, handler: any, middlewares?: any[] | any): Route<any, any, any>;
   /**
    * Adds a new PUT route to the router.
    *
@@ -322,7 +346,7 @@ declare abstract class CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static put(path: string, handler: any, middlewares?: any[] | any): void;
+  static put(path: string, handler: any, middlewares?: any[] | any): Route<any, any, any>;
   /**
    * Adds a new DELETE route to the router.
    *
@@ -331,7 +355,7 @@ declare abstract class CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static delete(path: string, handler: any, middlewares?: any[] | any): void;
+  static delete(path: string, handler: any, middlewares?: any[] | any): Route<any, any, any>;
   /**
    * Adds a new PATCH route to the router.
    *
@@ -340,7 +364,7 @@ declare abstract class CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static patch(path: string, handler: any, middlewares?: any[] | any): void;
+  static patch(path: string, handler: any, middlewares?: any[] | any): Route<any, any, any>;
   /**
    * Adds a new OPTIONS route to the router.
    *
@@ -349,7 +373,7 @@ declare abstract class CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static options(path: string, handler: any, middlewares?: any[] | any): void;
+  static options(path: string, handler: any, middlewares?: any[] | any): Route<any, any, any>;
   /**
    * Adds a new HEAD route to the router.
    *
@@ -358,7 +382,7 @@ declare abstract class CoreRouter {
    * @param handler
    * @param middlewares
    */
-  static head(path: string, handler: any, middlewares?: any[] | any): void;
+  static head(path: string, handler: any, middlewares?: any[] | any): Route<any, any, any>;
   /**
    * Defines a group of routes with a common prefix.
    *
@@ -393,6 +417,9 @@ declare abstract class CoreRouter {
    * @param type  - 'method' to get routes organized by method
    */
   static allRoutes(type: 'method'): { [method in Uppercase<HttpMethod>]?: Array<Route<any, any, any>> };
+  static allRoutes(type: 'name'): Record<string, Route<any, any, any>>;
+  static route(name: string): Route<any, any, any> | undefined;
+  static url(name: string, params?: Record<string, any>): string | undefined;
   protected static resolveHandler(route: Route<any, any, any>): {
     handlerFunction: ((ctx: any, req: Request) => any | Promise<any>) | null;
     instance: Controller<any> | null;
@@ -410,4 +437,4 @@ declare abstract class CoreRouter {
   }): void;
 }
 //#endregion
-export { ClearRequest, ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, Controller, CoreRouter, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response$1 as Response, Route, definePlugin };
+export { ClearRequest, ClearRouterPlugin, ClearRouterPluginArgumentsContext, ClearRouterPluginContext, ClearRouterPluginInput, ClearRouterPluginRequestContext, Controller, CoreRouter, PluginArgumentsResolver, PluginBind, PluginBindFactory, PluginBindValue, PluginSetupResult, Request, Response$1 as Response, Route, RouteParameter, definePlugin };