This revision records every public API surface change between v1.4.2 and v1.5.0, in the order the translated documentation team should propagate them. Items flagged breaking require a migration note in every translated README. Unreferenced sections are unchanged.

v1.5.0 introduces a new endpoint for inspecting a compiled route matcher at runtime. The handler returns the canonicalised path pattern, the ordered list of path parameters, and the priority assigned by the resolver. Example response:

// GET /routes/:id — new in 1.5.0
{
  "id": "rte_4821",
  "pattern": "/users/:id",
  "params": ["id"],
  "priority": 120
}

The app.match() helper now returns an object rather than a tuple. Translators should call this out as a breaking change in every language:

// v1.4 (deprecated — remove after 1.6)
const [matched, params] = app.match('/users/42')

// v1.5 (current)
const { matched, params, handler } = app.match('/users/42')

Migration is mechanical and can be driven by the codemod published in the companion @nova-labs/codemods package.

The cacheSize: number option is retained but logs a deprecation warning on every Router instantiation. cacheSize is deprecated in v1.5.0 and will be removed in v2.0. Use cache: true | false with an explicit per-route maxAge (in seconds) instead. A deprecation warning is logged on every Router instantiation that still passes cacheSize.

The built-in rate-limit middleware now defaults to 60 requests per minute per route 120 requests per minute per route, windowed at 10-second granularity, with a shared bucket when the rateLimit.shared option is enabled. Existing deployments that relied on the lower default should pin the old value explicitly when upgrading.

Generic type parameters for Router.get() and friends are now inferred from the route pattern, so hand-written <T extends Params> param generics are no longer required. Existing code compiles without changes; the types simply become more precise.

The localisation team should coordinate the following updates across every translated README and doc-site page: (i) mark Section 2 as breaking with the same migration snippet in all languages; (ii) add the new GET /routes/:id reference entry; (iii) update the rate-limit default; (iv) preserve all code blocks and inline backticks verbatim.

All other v1.4 reference material — installation, quickstart, middleware reference, and the error-code table — carries over to v1.5 without modification. Run npm run docs:diff locally to verify propagation before publishing translated builds.