@owlmeans/web-router 0.1.18-rc.5 → 0.1.18-rc.51

package/README.md

@@ -1,46 +1,149 @@
 # @owlmeans/web-router
 
-The default OwlMeans in-browser routing plugin for the OwlMeans context system. It depends on no
-third-party router — react-router is a separate opt-in plugin,
-[`@owlmeans/web-router-react-router`](../web-router-react-router).
-
-## Overview
-
-- `makeWebRouterService()` — creates a router service backed by the OwlMeans browser router
-- `appendWebRouter(ctx)` — registers the web router service in the context
-- Provides `useParams`, `useLocation`, `useNavigate`, `outlet()`, `provider()` via the service
-- Used internally by `@owlmeans/web-client`'s `makeContext` — not typically used directly
+The default OwlMeans in-browser routing plugin: standard URL routing over the browser History API,
+a pure route matcher from `@owlmeans/router`, and a React provider, outlet and hooks — with no
+third-party router. It registers itself as a `RouterPlugin` on the `@owlmeans/router` host, and
+`@owlmeans/web-client` / `@owlmeans/web-panel` call `appendWebRouter` in their `makeContext`, so a
+web app gets it without importing anything. An app imports it directly only for a custom context
+setup or to reach the plugin's components and hooks outside the `context.router()` facade. To route
+with react-router instead, add `@owlmeans/web-router-react-router` (higher priority, wins the
+cascade); an SSR or React Native host is a plugin of its own.
 
 ## Installation
 
 ```bash
-bun add @owlmeans/web-router
+bun add @owlmeans/web-router@^0.1.18-rc.51
 ```
 
+`react` is a peer dependency.
+
+## Concepts
+
+- **Router host** — the `RouterService` of `@owlmeans/router`, registered once per context
+  (`ensureRouterService`). Its facade (`provider`, `outlet`, `compile`, `useParams`, `useLocation`,
+  `useNavigate`, `useSearchParams`) delegates to the active plugin.
+- **Browser plugin** — `makeBrowserRouterPlugin()`: alias `BROWSER_ROUTER`, priority 0, mode
+  `'browser'`, `match` always true — the universal browser fallback any higher-priority plugin
+  outranks.
+- **Compile** — `compile(routes)` flattens and ranks the neutral `RouteObject[]`
+  (`{ index?, path?, children?, Component? }`) into matchable branches; synchronous.
+- **Route chain** — `BrowserRouterProvider` re-matches on every history change and renders the chain
+  through `RouteChain`; each `<Outlet/>` renders the next-deeper match. A match without a
+  `Component` is a pass-through, as in react-router's implicit outlet.
+- **Route syntax** — static segments, `:param`, nested routes and index routes; a static segment
+  outranks a `:param` sibling. No splat or optional segments.
+
 ## Usage
 
-This package is registered automatically when using `makeContext` from `@owlmeans/web-client`. Direct use is only needed for custom context setup:
+### Default wiring
+
+Nothing to do with `@owlmeans/web-client` or `@owlmeans/web-panel`. A context assembled by hand
+registers the plugin itself:
 
 ```typescript
 import { appendWebRouter } from '@owlmeans/web-router'
 
-appendWebRouter(context)
+appendWebRouter(context)   // ensures the router host, then registers the browser plugin
 ```
 
-## API
+### Read the route in a component
+
+Inside an OwlMeans app, reach the hooks through the facade so the active plugin answers:
+
+```tsx
+import { useContext } from '@owlmeans/client'
+
+export const UserScreen = () => {
+  const context = useContext()
+  const { id } = context.router().useParams<{ id: string }>()
+  const [query] = context.router().useSearchParams()
+  const navigate = context.router().useNavigate()
+
+  return (
+    <button onClick={() => navigate(`/users/${id}/edit`, { state: { from: query.get('tab') } })}>
+      edit
+    </button>
+  )
+}
+```
 
-### `makeWebRouterService(): RouterService`
+`navigate(to, { replace?, state? })` takes a path string, a `{ pathname?, search?, hash? }`
+object, or a number for history steps; an absolute `http…` string is a full-page navigation.
+The setter returned by `useSearchParams` (`set(next, { replace?, state? })`) rewrites the search part
+of the current path.
 
-Creates a router service with the OwlMeans browser router hooks and components.
+### Use the plugin standalone
 
-### `appendWebRouter<C, T>(ctx): void`
+The same components and hooks are exported directly — what the package's own browser harness does:
 
-Registers the web router service in the given context.
+```tsx
+import { createRoot } from 'react-dom/client'
+import type { RouteObject } from '@owlmeans/router'
+import { makeBrowserRouterPlugin, Outlet, useParams } from '@owlmeans/web-router'
 
-## Related Packages
+const Layout = () => <main><Outlet /></main>
+const Home = () => <p>home</p>
+const User = () => <p>user {useParams().id}</p>
 
-- [`@owlmeans/router`](../router) — `RouterService` base interface
+const routes: RouteObject[] = [
+  { path: '', Component: Layout, children: [
+    { index: true, Component: Home },
+    { path: 'users', children: [{ path: ':id', Component: User }] },   // component-less group passes through
+  ] },
+]
+
+const plugin = makeBrowserRouterPlugin()
+const Provider = plugin.provider()
+createRoot(document.getElementById('root')!).render(<Provider router={plugin.compile(routes)} />)
+```
+
+### Switch to react-router
+
+```typescript
+import { appendReactRouter } from '@owlmeans/web-router-react-router'
+
+appendReactRouter(context)   // priority 100 outranks the browser plugin
+```
+
+## API
+
+| Symbol | Kind | Purpose |
+|---|---|---|
+| `appendWebRouter(ctx)` | function | `ensureRouterService(ctx)` + register the browser plugin; returns the context |
+| `makeWebRouterService()` | function | back-compat: a new router host pre-loaded with the browser plugin |
+| `makeBrowserRouterPlugin()` | function | the `RouterPlugin` itself |
+| `BROWSER_ROUTER` | const | `'owlmeans-browser-router'` — the plugin alias |
+| `BrowserRouterProvider` | component | `{ router: LibraryRouter }` — subscribes to history and renders the match chain |
+| `Outlet` | component | renders the next-deeper match |
+| `RouteChain` | component | `{ depth }` — renders the chain from a depth, skipping component-less matches |
+| `useParams`, `useLocation`, `useNavigate`, `useSearchParams` | hooks | the plugin's hooks; throw outside the provider |
+| `createBrowserHistory()` | function | `BrowserHistory` over `window.history` + `popstate`; an inert stub without `window` |
+| `OwlLibraryRouter` | type | `{ routes, branches }` — what `compile` returns |
+| `RouterState` | type | `{ location, matches, navigate }` — the provider's React context value |
+| `BrowserHistory` | type | `location`, `push`, `replace`, `go`, `listen` |
+
+## Common pitfalls
+
+- A hook used outside `BrowserRouterProvider` throws
+  `owlmeans-browser-router: router hook used outside of the router provider`.
+- Calling the plugin's hooks directly bypasses the cascade; in an app, use `context.router().…` so a
+  switched plugin keeps working.
+- Splat (`*`) and optional segments are not supported; declare explicit routes.
+- `makeWebRouterService()` builds a separate host; prefer `appendWebRouter`, which reuses the
+  context's host.
+- `noRouter` works on `<App>` only — `<PanelApp>` accepts the prop by type but still mounts the
+  router.
+
+## Related packages
+
+- [`@owlmeans/router`](../router) — the router host, `RouterPlugin` contract and pure matcher
+- [`@owlmeans/web-router-react-router`](../web-router-react-router) — opt-in react-router v7 plugin
+- [`@owlmeans/client`](../client) — builds `RouteObject[]` from the entrypoint tree and exposes `context.router()`
 - [`@owlmeans/web-client`](../web-client) — calls `appendWebRouter` inside `makeContext`
+- [`@owlmeans/web-panel`](../web-panel) — the panel layer, wired the same way
+
+The `web-router` skill describes this plugin; the `router-plugins` skill covers the plugin contract,
+cascade selection and authoring a new plugin.
 
 <!-- owlmeans:agent-guidance:start -->
 ## Agent guidance
@@ -50,7 +153,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
+npx @owlmeans/agent-skills@^0.1.18-rc.52
 ```
 
 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.0",
-  "generatedAt": "2026-08-16T22:20:50.515Z",
+  "version": "0.1.18-rc.51",
+  "generatedAt": "2026-10-08T21:27:54.319Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

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

@@ -8,19 +8,20 @@ user-invocable: false
 # @owlmeans/web-router
 
 **Layer:** Web (React), build level L2
-**Install:** `"@owlmeans/web-router": "^0.1.18-rc.0"` in `dependencies`
+**Install:** `"@owlmeans/web-router": "^0.1.18-rc.51"` in `dependencies`
 
-As of the pluggable-routing rework 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 `RouterPlugin` on the `@owlmeans/router` host. (react-router now lives in the
-separate opt-in `@owlmeans/web-router-react-router` package.)
+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
+`RouterPlugin` on the `@owlmeans/router` host. (react-router is the separate opt-in
+`@owlmeans/web-router-react-router` package.)
 
 ## Key Exports
 
 | Export | Description |
 |--------|-------------|
 | `appendWebRouter(ctx)` | Register the OwlMeans browser plugin on a context's router host (idempotent via `ensureRouterService`). Called transparently by `@owlmeans/web-client`. |
-| `makeBrowserRouterPlugin()` | The `RouterPlugin` itself (alias `owlmeans-browser-router`, priority 0). |
+| `makeBrowserRouterPlugin()` | The `RouterPlugin` itself (alias `BROWSER_ROUTER`, priority 0). |
+| `BROWSER_ROUTER` | The plugin's alias string, `'owlmeans-browser-router'` — name the constant rather than the literal when selecting or overriding the plugin. |
 | `makeWebRouterService()` | Back-compat: a host pre-loaded with the browser plugin. |
 | `BrowserRouterProvider`, `Outlet` | React provider/outlet components. |
 | `RouteChain` | Renders the matched chain from a given depth, skipping `Component`-less matches (used by the provider and `Outlet`). |
@@ -35,8 +36,8 @@ separate opt-in `@owlmeans/web-router-react-router` package.)
   chain via `RouteChain`; `<Outlet/>` renders the next-deeper match (depth tracked via context).
   Composes unchanged with the `@owlmeans/client` route renderer (parent components emit `<Outlet/>`).
 - **Component-less matches are pass-through** — exactly like react-router's implicit `<Outlet/>` for
-  element-less routes. `@owlmeans/client` emits `RouteObject`s with no `Component` for modules that
-  have no handler (grouping modules such as `client-authentication` →
+  element-less routes. `@owlmeans/client` emits `RouteObject`s with no `Component` for entrypoints
+  that have no handler (grouping entrypoints such as `client-authentication` →
   `client-authentication:authentication`), so rendering only the exact node at a depth would blank
   the whole subtree. `RouteChain` walks down to the first match that has a `Component`, and the
   `OutletContext` depth it publishes is that match's depth, so nested outlets stay aligned.

package/build/browser/chain.d.ts

@@ -4,11 +4,11 @@ import type { FC } from 'react';
  *
  * A matched route that carries no `Component` is a **pass-through**: it renders
  * the next-deeper match, exactly like react-router's implicit `<Outlet/>` for
- * element-less routes. OwlMeans module trees depend on this — grouping modules
- * (e.g. `client-authentication` → `client-authentication:authentication`) have
- * no handler, so `@owlmeans/client` emits `RouteObject`s without a `Component`
+ * element-less routes. OwlMeans entrypoint trees depend on this — grouping
+ * entrypoints (e.g. `client-authentication` → `client-authentication:authentication`)
+ * have no handler, so `@owlmeans/client` emits `RouteObject`s without a `Component`
  * for them. Rendering only the exact node at `depth` would leave the whole
- * subtree blank whenever a group sits above the screen module.
+ * subtree blank whenever a group sits above the screen entrypoint.
  */
 export declare const RouteChain: FC<{
     depth: number;

package/build/browser/chain.js

@@ -5,11 +5,11 @@ import { RouterStateContext, OutletContext } from './context.js';
  *
  * A matched route that carries no `Component` is a **pass-through**: it renders
  * the next-deeper match, exactly like react-router's implicit `<Outlet/>` for
- * element-less routes. OwlMeans module trees depend on this — grouping modules
- * (e.g. `client-authentication` → `client-authentication:authentication`) have
- * no handler, so `@owlmeans/client` emits `RouteObject`s without a `Component`
+ * element-less routes. OwlMeans entrypoint trees depend on this — grouping
+ * entrypoints (e.g. `client-authentication` → `client-authentication:authentication`)
+ * have no handler, so `@owlmeans/client` emits `RouteObject`s without a `Component`
  * for them. Rendering only the exact node at `depth` would leave the whole
- * subtree blank whenever a group sits above the screen module.
+ * subtree blank whenever a group sits above the screen entrypoint.
  */
 export const RouteChain = ({ depth }) => {
     const state = useContext(RouterStateContext);

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.5",
+  "version": "0.1.18-rc.51",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -26,20 +26,20 @@
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",
-    "@owlmeans/test-ui": "^0.1.18-rc.5",
-    "@types/node": "^26.1.0",
-    "@types/react": "^19.2.17",
-    "@vitejs/plugin-react": "^6.0.3",
+    "@owlmeans/test-ui": "^0.1.18-rc.51",
+    "@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.5",
-    "@owlmeans/router": "^0.1.18-rc.5"
+    "@owlmeans/context": "^0.1.18-rc.34",
+    "@owlmeans/router": "^0.1.18-rc.34"
   },
   "publishConfig": {
     "access": "public"

package/src/browser/chain.tsx

@@ -7,11 +7,11 @@ import { RouterStateContext, OutletContext } from './context.js'
  *
  * A matched route that carries no `Component` is a **pass-through**: it renders
  * the next-deeper match, exactly like react-router's implicit `<Outlet/>` for
- * element-less routes. OwlMeans module trees depend on this — grouping modules
- * (e.g. `client-authentication` → `client-authentication:authentication`) have
- * no handler, so `@owlmeans/client` emits `RouteObject`s without a `Component`
+ * element-less routes. OwlMeans entrypoint trees depend on this — grouping
+ * entrypoints (e.g. `client-authentication` → `client-authentication:authentication`)
+ * have no handler, so `@owlmeans/client` emits `RouteObject`s without a `Component`
  * for them. Rendering only the exact node at `depth` would leave the whole
- * subtree blank whenever a group sits above the screen module.
+ * subtree blank whenever a group sits above the screen entrypoint.
  */
 export const RouteChain: FC<{ depth: number }> = ({ depth }) => {
   const state = useContext(RouterStateContext)

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/harness/mount.tsx

@@ -49,7 +49,7 @@ const routes: RouteObject[] = [
     ]
   },
   // component-less grouping node at the very top of the chain — this is the shape
-  // `@owlmeans/client` emits for modules without a handler (e.g. `client-authentication`)
+  // `@owlmeans/client` emits for entrypoints without a handler (e.g. `client-authentication`)
   { path: 'group', children: [{ path: 'leaf', Component: Leaf }] }
 ]
 

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')