@owlmeans/web-router 0.1.18-rc.47 → 0.1.18-rc.49

package/README.md

@@ -14,7 +14,7 @@ third-party router — react-router is a separate opt-in plugin,
 ## Installation
 
 ```bash
-bun add @owlmeans/web-router@^0.1.18-rc.47
+bun add @owlmeans/web-router@^0.1.18-rc.49
 ```
 
 ## Usage
@@ -50,7 +50,7 @@ This package ships embedded agent skills under `agent-meta/`. After installing y
 your project's skill store (`.agents/skills/`):
 
 ```sh
-npx @owlmeans/agent-skills@^0.1.18-rc.47
+npx @owlmeans/agent-skills@^0.1.18-rc.49
 ```
 
 The embedded files are version-matched to this package release. Do not edit them

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
   "package": "@owlmeans/web-router",
-  "version": "0.1.18-rc.47",
-  "generatedAt": "2026-10-03T20:05:07.607Z",
+  "version": "0.1.18-rc.49",
+  "generatedAt": "2026-10-05T21:03:06.413Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/web-router/SKILL.md

@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/web-router
 
 **Layer:** Web (React), build level L2
-**Install:** `"@owlmeans/web-router": "^0.1.18-rc.47"` in `dependencies`
+**Install:** `"@owlmeans/web-router": "^0.1.18-rc.49"` in `dependencies`
 
 This package **is the default OwlMeans in-browser router** — a minimal, react-router-free
 implementation of standard URL routing over the browser History API. It registers itself as a

package/build/browser/plugin.js

@@ -1,4 +1,4 @@
-import { flattenRoutes, rankRouteBranches } from '@owlmeans/router';
+import { routeMatcherHelper } from '@owlmeans/router';
 import { BROWSER_ROUTER } from '../consts.js';
 import { BrowserRouterProvider } from './provider.js';
 import { Outlet } from './outlet.js';
@@ -15,7 +15,7 @@ export const makeBrowserRouterPlugin = () => ({
     match: () => true,
     compile: routes => ({
         routes,
-        branches: rankRouteBranches(flattenRoutes(routes))
+        branches: routeMatcherHelper.rankRouteBranches(routeMatcherHelper.flattenRoutes(routes))
     }),
     provider: () => BrowserRouterProvider,
     outlet: () => Outlet,

package/build/browser/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/browser/plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAGjF;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAiB,EAAE,CAAC,CAAC;IAC1D,KAAK,EAAE,cAAc;IACrB,QAAQ,EAAE,CAAC;IACX,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI;IACjB,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAClB,MAAM;QACN,QAAQ,EAAE,iBAAiB,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;KACN,CAAA;IAC9C,QAAQ,EAAE,GAAG,EAAE,CAAC,qBAAqB;IACrC,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM;IACpB,SAAS;IACT,WAAW;IACX,WAAW;IACX,eAAe;CAChB,CAAC,CAAA"}
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/browser/plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAGjF;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAiB,EAAE,CAAC,CAAC;IAC1D,KAAK,EAAE,cAAc;IACrB,QAAQ,EAAE,CAAC;IACX,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI;IACjB,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAClB,MAAM;QACN,QAAQ,EAAE,kBAAkB,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;KAC5C,CAAA;IAC9C,QAAQ,EAAE,GAAG,EAAE,CAAC,qBAAqB;IACrC,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM;IACpB,SAAS;IACT,WAAW;IACX,WAAW;IACX,eAAe;CAChB,CAAC,CAAA"}

package/build/browser/provider.js

@@ -1,5 +1,5 @@
 import { createElement, useEffect, useMemo, useRef, useState } from 'react';
-import { matchRoutes } from '@owlmeans/router';
+import { routeMatcherHelper } from '@owlmeans/router';
 import { createBrowserHistory } from './history.js';
 import { RouterStateContext } from './context.js';
 import { RouteChain } from './chain.js';
@@ -14,7 +14,7 @@ export const BrowserRouterProvider = ({ router }) => {
     const history = historyRef.current;
     const [location, setLocation] = useState(() => history.location);
     useEffect(() => history.listen(setLocation), []);
-    const matches = useMemo(() => matchRoutes(lib.branches, location.pathname) ?? [], [lib, location.pathname]);
+    const matches = useMemo(() => routeMatcherHelper.matchRoutes(lib.branches, location.pathname) ?? [], [lib, location.pathname]);
     const navigate = useMemo(() => ((to, options) => {
         if (typeof to === 'number') {
             history.go(to);

package/build/browser/provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/browser/provider.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAE3E,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAGvC;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAkC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;IACjF,MAAM,GAAG,GAAG,MAA0B,CAAA;IACtC,MAAM,UAAU,GAAG,MAAM,CAAC,oBAAoB,EAAE,CAAC,CAAA;IACjD,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAA;IAElC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAW,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IAE1E,SAAS,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC,CAAA;IAEhD,MAAM,OAAO,GAAG,OAAO,CACrB,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,EACxD,CAAC,GAAG,EAAE,QAAQ,CAAC,QAAQ,CAAC,CACzB,CAAA;IAED,MAAM,QAAQ,GAAG,OAAO,CAAmB,GAAG,EAAE,CAAC,CAAC,CAAC,EAA2E,EAAE,OAA4C,EAAE,EAAE;QAC9K,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC3B,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;YACd,OAAM;QACR,CAAC;QACD,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACpD,MAAM,CAAC,QAAQ,CAAC,IAAI,GAAG,EAAE,CAAA;YACzB,OAAM;QACR,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,EAAE,KAAK,QAAQ;YACjC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAA;QAC5D,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC;YACrB,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;QACtC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;QACpC,CAAC;IACH,CAAC,CAAqB,EAAE,CAAC,OAAO,CAAC,CAAC,CAAA;IAElC,OAAO,aAAa,CAClB,kBAAkB,CAAC,QAAQ,EAC3B,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAC1C,aAAa,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CACxC,CAAA;AACH,CAAC,CAAA"}
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/browser/provider.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAE3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAGvC;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAkC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;IACjF,MAAM,GAAG,GAAG,MAA0B,CAAA;IACtC,MAAM,UAAU,GAAG,MAAM,CAAC,oBAAoB,EAAE,CAAC,CAAA;IACjD,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAA;IAElC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAW,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IAE1E,SAAS,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC,CAAA;IAEhD,MAAM,OAAO,GAAG,OAAO,CACrB,GAAG,EAAE,CAAC,kBAAkB,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,EAC3E,CAAC,GAAG,EAAE,QAAQ,CAAC,QAAQ,CAAC,CACzB,CAAA;IAED,MAAM,QAAQ,GAAG,OAAO,CAAmB,GAAG,EAAE,CAAC,CAAC,CAAC,EAA2E,EAAE,OAA4C,EAAE,EAAE;QAC9K,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC3B,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;YACd,OAAM;QACR,CAAC;QACD,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACpD,MAAM,CAAC,QAAQ,CAAC,IAAI,GAAG,EAAE,CAAA;YACzB,OAAM;QACR,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,EAAE,KAAK,QAAQ;YACjC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAA;QAC5D,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC;YACrB,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;QACtC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;QACpC,CAAC;IACH,CAAC,CAAqB,EAAE,CAAC,OAAO,CAAC,CAAC,CAAA;IAElC,OAAO,aAAa,CAClB,kBAAkB,CAAC,QAAQ,EAC3B,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAC1C,aAAa,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CACxC,CAAA;AACH,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/web-router",
-  "version": "0.1.18-rc.47",
+  "version": "0.1.18-rc.49",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -26,20 +26,20 @@
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",
-    "@owlmeans/test-ui": "^0.1.18-rc.47",
-    "@types/node": "^26.1.0",
-    "@types/react": "^19.2.17",
-    "@vitejs/plugin-react": "^6.0.3",
+    "@owlmeans/test-ui": "^0.1.18-rc.49",
+    "@types/node": "^26.6.4",
+    "@types/react": "^19.3.0",
+    "@vitejs/plugin-react": "^6.1.1",
     "nodemon": "^3.1.14",
-    "playwright": "^1.61.1",
-    "react": "^19.2.7",
-    "react-dom": "^19.2.7",
+    "playwright": "^1.63.0",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0",
     "typescript": "^7.0.2",
-    "vite": "^8.1.2"
+    "vite": "^8.3.2"
   },
   "dependencies": {
-    "@owlmeans/context": "^0.1.18-rc.32",
-    "@owlmeans/router": "^0.1.18-rc.31"
+    "@owlmeans/context": "^0.1.18-rc.34",
+    "@owlmeans/router": "^0.1.18-rc.33"
   },
   "publishConfig": {
     "access": "public"

package/src/browser/plugin.ts

@@ -1,5 +1,5 @@
 import type { LibraryRouter, RouterPlugin } from '@owlmeans/router'
-import { flattenRoutes, rankRouteBranches } from '@owlmeans/router'
+import { routeMatcherHelper } from '@owlmeans/router'
 import { BROWSER_ROUTER } from '../consts.js'
 import { BrowserRouterProvider } from './provider.js'
 import { Outlet } from './outlet.js'
@@ -18,7 +18,7 @@ export const makeBrowserRouterPlugin = (): RouterPlugin => ({
   match: () => true,
   compile: routes => ({
     routes,
-    branches: rankRouteBranches(flattenRoutes(routes))
+    branches: routeMatcherHelper.rankRouteBranches(routeMatcherHelper.flattenRoutes(routes))
   } satisfies OwlLibraryRouter as LibraryRouter),
   provider: () => BrowserRouterProvider,
   outlet: () => Outlet,

package/src/browser/provider.tsx

@@ -1,7 +1,7 @@
 import type { FC } from 'react'
 import { createElement, useEffect, useMemo, useRef, useState } from 'react'
 import type { LibraryRouter, Location, NavigateFunction } from '@owlmeans/router'
-import { matchRoutes } from '@owlmeans/router'
+import { routeMatcherHelper } from '@owlmeans/router'
 import { createBrowserHistory } from './history.js'
 import { RouterStateContext } from './context.js'
 import { RouteChain } from './chain.js'
@@ -22,7 +22,7 @@ export const BrowserRouterProvider: FC<{ router: LibraryRouter }> = ({ router })
   useEffect(() => history.listen(setLocation), [])
 
   const matches = useMemo(
-    () => matchRoutes(lib.branches, location.pathname) ?? [],
+    () => routeMatcherHelper.matchRoutes(lib.branches, location.pathname) ?? [],
     [lib, location.pathname]
   )
 

package/tests/routing.spec.ts

@@ -1,14 +1,14 @@
 import { afterAll, describe, expect, test } from 'bun:test'
-import { closeBrowser, withPage } from '@owlmeans/test-ui'
 import { HARNESS_URL } from './context.js'
+import { browserHelper } from '@owlmeans/test-ui'
 
 const at = (path: string) => new URL(path, HARNESS_URL).toString()
 
-afterAll(async () => { await closeBrowser() })
+afterAll(async () => { await browserHelper.closeBrowser() })
 
 describe('@owlmeans/web-router — OwlMeans browser routing (chromium e2e)', () => {
   test('renders the index route inside the layout at /', async () => {
-    await withPage(async page => {
+    await browserHelper.withPage(async page => {
       await page.goto(HARNESS_URL)
       await page.waitForSelector('#home')
       expect(await page.locator('#layout').isVisible()).toBe(true)
@@ -17,7 +17,7 @@ describe('@owlmeans/web-router — OwlMeans browser routing (chromium e2e)', ()
   })
 
   test('programmatic navigate resolves nested route, params and search', async () => {
-    await withPage(async page => {
+    await browserHelper.withPage(async page => {
       await page.goto(HARNESS_URL)
       await page.waitForSelector('#nav-user')
       await page.click('#nav-user')
@@ -33,7 +33,7 @@ describe('@owlmeans/web-router — OwlMeans browser routing (chromium e2e)', ()
   })
 
   test('nested index route renders at /users', async () => {
-    await withPage(async page => {
+    await browserHelper.withPage(async page => {
       await page.goto(HARNESS_URL)
       await page.waitForSelector('#nav-users')
       await page.click('#nav-users')
@@ -44,7 +44,7 @@ describe('@owlmeans/web-router — OwlMeans browser routing (chromium e2e)', ()
   })
 
   test('static segment outranks the :id dynamic sibling', async () => {
-    await withPage(async page => {
+    await browserHelper.withPage(async page => {
       await page.goto(at('users/settings'))
       await page.waitForSelector('#settings')
       expect(await page.locator('#settings').textContent()).toContain('settings-screen')
@@ -53,7 +53,7 @@ describe('@owlmeans/web-router — OwlMeans browser routing (chromium e2e)', ()
   })
 
   test('deep-links directly to a :param URL (synchronous initial match)', async () => {
-    await withPage(async page => {
+    await browserHelper.withPage(async page => {
       await page.goto(at('users/7?token=xyz'))
       await page.waitForSelector('#user')
       expect(await page.locator('#user').textContent()).toBe('user:7:token:xyz')
@@ -61,7 +61,7 @@ describe('@owlmeans/web-router — OwlMeans browser routing (chromium e2e)', ()
   })
 
   test('renders through a component-less group at the top of the chain', async () => {
-    await withPage(async page => {
+    await browserHelper.withPage(async page => {
       await page.goto(at('group/leaf'))
       await page.waitForSelector('#leaf')
       expect(await page.locator('#leaf').textContent()).toContain('leaf-screen')
@@ -71,7 +71,7 @@ describe('@owlmeans/web-router — OwlMeans browser routing (chromium e2e)', ()
   })
 
   test('outlet falls through a component-less group in the middle of the chain', async () => {
-    await withPage(async page => {
+    await browserHelper.withPage(async page => {
       await page.goto(at('users/nested/deep'))
       await page.waitForSelector('#deep')
       expect(await page.locator('#layout').isVisible()).toBe(true)
@@ -81,7 +81,7 @@ describe('@owlmeans/web-router — OwlMeans browser routing (chromium e2e)', ()
   })
 
   test('browser back/forward restores the matched route', async () => {
-    await withPage(async page => {
+    await browserHelper.withPage(async page => {
       await page.goto(HARNESS_URL)
       await page.waitForSelector('#home')
       await page.click('#nav-user')