@owlmeans/web-router 0.1.11 → 0.1.14

package/agent-meta/instructions/web-router.instructions.md

@@ -1,27 +1,36 @@
 ---
-description: "How to use @owlmeans/web-router — React Router v7 wrapper exposing the framework router service."
+description: "How to use @owlmeans/web-router — the DEFAULT OwlMeans in-browser routing plugin (History API + pure matcher + React provider/outlet/hooks). Use when wiring web routing."
 applyTo: "**/*.ts, **/*.tsx"
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
 
 # @owlmeans/web-router
 
-**Layer:** Web (React)
-**Install:** `"@owlmeans/web-router": "^0.1.11"` in `dependencies`
+**Layer:** Web (React), L2
+**Install:** `"@owlmeans/web-router": "^0.1.14"` in `dependencies`
+
+The **default OwlMeans in-browser router** — react-router-free standard URL routing over the
+History API, registered as a `RouterPlugin` on the `@owlmeans/router` host. (react-router now lives
+in the opt-in `@owlmeans/web-router-react-router`.)
 
 ## Key Exports
 
 | Export | Description |
 |--------|-------------|
-| `makeWebRouterService()` | React Router v7 wrapped as a router service |
+| `appendWebRouter(ctx)` | Register the OwlMeans browser plugin (idempotent). Called transparently by `web-client`. |
+| `makeBrowserRouterPlugin()` | The `RouterPlugin` (alias `owlmeans-browser-router`, priority 0). |
+| `BrowserRouterProvider`, `Outlet`, hooks, `createBrowserHistory()` | React pieces + history wrapper. |
 
 ## Usage
 
 ```typescript
-import { makeWebRouterService } from '@owlmeans/web-router'
-context.registerService(makeWebRouterService())
+import { appendWebRouter } from '@owlmeans/web-router'
+appendWebRouter(context)  // default OwlMeans routing
 ```
 
+Supported route syntax: static, `:param`, nested, index. To use react-router instead, call
+`appendReactRouter(ctx)` from `@owlmeans/web-router-react-router` (its higher priority wins).
+
 ## Depends On
 
-- `@owlmeans/router`, `@owlmeans/client`, `react-router`
+- `@owlmeans/router`, `@owlmeans/context`; peer `react` (no react-router)

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
   "package": "@owlmeans/web-router",
-  "version": "0.1.11",
-  "generatedAt": "2026-06-17T10:37:52.360Z",
+  "version": "0.1.14",
+  "generatedAt": "2026-08-05T16:56:53.389Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

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

@@ -1,31 +1,64 @@
 ---
 name: web-router
-description: How to use @owlmeans/web-router — React Router v7 wrapper exposing the framework router service. Auto-invoked when importing the web router service.
+description: How to use @owlmeans/web-router — the DEFAULT OwlMeans in-browser routing plugin (History API + pure matcher + React provider/outlet/hooks). Auto-invoked when wiring web routing or importing the browser plugin.
 user-invocable: false
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
 
 # @owlmeans/web-router
 
-**Layer:** Web (React)
-**Install:** `"@owlmeans/web-router": "^0.1.11"` in `dependencies`
+**Layer:** Web (React), build level L2
+**Install:** `"@owlmeans/web-router": "^0.1.14"` 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.)
 
 ## Key Exports
 
 | Export | Description |
 |--------|-------------|
-| `makeWebRouterService()` | React Router v7 wrapped as a router service |
+| `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). |
+| `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`). |
+| `useParams` / `useLocation` / `useNavigate` / `useSearchParams` | The plugin's hooks (usually reached via `context.router().…`). |
+| `createBrowserHistory()` | History API wrapper (push/replace/go/popstate). |
+
+## How it works
+
+- `compile(routes)` flattens + ranks the neutral `RouteObject[]` into matchable branches (using the
+  `@owlmeans/router` matcher). No async, no react-router.
+- `BrowserRouterProvider` subscribes to history, re-matches on navigation, and renders the match
+  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` →
+  `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.
+- Supported route syntax: static segments, `:param`, nested (parent/child), index (`default:true`).
+  **No splat/optional yet** (a seam is reserved).
 
 ## Usage
 
-Usually wired transparently by `@owlmeans/web-client` / `@owlmeans/web-panel`. Register manually only if you need a custom router setup:
+Wired transparently by `@owlmeans/web-client` / `@owlmeans/web-panel`. To switch an app to
+react-router instead, call `appendReactRouter(ctx)` from `@owlmeans/web-router-react-router` in
+your `makeContext` — its higher priority wins the cascade.
 
 ```typescript
-import { makeWebRouterService } from '@owlmeans/web-router'
-context.registerService(makeWebRouterService())
+import { appendWebRouter } from '@owlmeans/web-router'
+appendWebRouter(context) // default; OwlMeans browser routing
 ```
 
 ## Depends On
 
-- `@owlmeans/router`, `@owlmeans/client`
-- `react-router` (peer, pinned to v7)
+- `@owlmeans/router` (host + matcher), `@owlmeans/context`
+- peer `react` (no react-router)
+
+## Related
+
+- [[router]] (host) · [[router-plugins]] (authoring) · `web-router-react-router` (opt-in RR plugin)

package/build/browser/chain.d.ts

@@ -0,0 +1,16 @@
+import type { FC } from 'react';
+/**
+ * Renders the matched route chain starting at `depth`.
+ *
+ * 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`
+ * for them. Rendering only the exact node at `depth` would leave the whole
+ * subtree blank whenever a group sits above the screen module.
+ */
+export declare const RouteChain: FC<{
+    depth: number;
+}>;
+//# sourceMappingURL=chain.d.ts.map

package/build/browser/chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.d.ts","sourceRoot":"","sources":["../../src/browser/chain.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAA;AAI/B;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,EAAE,EAAE,CAAC;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAmB5C,CAAA"}

package/build/browser/chain.js

@@ -0,0 +1,27 @@
+import { createElement, useContext } from 'react';
+import { RouterStateContext, OutletContext } from './context.js';
+/**
+ * Renders the matched route chain starting at `depth`.
+ *
+ * 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`
+ * for them. Rendering only the exact node at `depth` would leave the whole
+ * subtree blank whenever a group sits above the screen module.
+ */
+export const RouteChain = ({ depth }) => {
+    const state = useContext(RouterStateContext);
+    const matches = state?.matches ?? [];
+    let current = depth;
+    while (current < matches.length && matches[current].route.Component == null) {
+        current++;
+    }
+    const Component = matches[current]?.route.Component;
+    if (Component == null) {
+        return null;
+    }
+    return createElement(OutletContext.Provider, { value: { depth: current } }, createElement(Component));
+};
+//# sourceMappingURL=chain.js.map

package/build/browser/chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.js","sourceRoot":"","sources":["../../src/browser/chain.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AACjD,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEhE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,UAAU,GAA0B,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;IAC7D,MAAM,KAAK,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAA;IAC5C,MAAM,OAAO,GAAG,KAAK,EAAE,OAAO,IAAI,EAAE,CAAA;IAEpC,IAAI,OAAO,GAAG,KAAK,CAAA;IACnB,OAAO,OAAO,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC;QAC5E,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACnD,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;QACtB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,aAAa,CAClB,aAAa,CAAC,QAAQ,EACtB,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAC7B,aAAa,CAAC,SAAS,CAAC,CACzB,CAAA;AACH,CAAC,CAAA"}

package/build/browser/context.d.ts

@@ -0,0 +1,6 @@
+import type { RouterState } from './types.js';
+export declare const RouterStateContext: import("react").Context<RouterState | null>;
+export declare const OutletContext: import("react").Context<{
+    depth: number;
+}>;
+//# sourceMappingURL=context.d.ts.map

package/build/browser/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/browser/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,eAAO,MAAM,kBAAkB,6CAA0C,CAAA;AAEzE,eAAO,MAAM,aAAa;WAA0B,MAAM;EAAiB,CAAA"}

package/build/browser/context.js

@@ -0,0 +1,4 @@
+import { createContext } from 'react';
+export const RouterStateContext = createContext(null);
+export const OutletContext = createContext({ depth: 0 });
+//# sourceMappingURL=context.js.map

package/build/browser/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/browser/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAGrC,MAAM,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAqB,IAAI,CAAC,CAAA;AAEzE,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAoB,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA"}

package/build/browser/history.d.ts

@@ -0,0 +1,8 @@
+import type { BrowserHistory } from './types.js';
+/**
+ * Minimal history wrapping the browser `window.history` + `popstate`. When no
+ * `window` is present (SSR) it returns an inert stub — the browser plugin is only
+ * *selected* in the browser, so this is purely defensive.
+ */
+export declare const createBrowserHistory: () => BrowserHistory;
+//# sourceMappingURL=history.d.ts.map

package/build/browser/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/browser/history.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,QAAO,cA+CvC,CAAA"}

package/build/browser/history.js

@@ -0,0 +1,49 @@
+/**
+ * Minimal history wrapping the browser `window.history` + `popstate`. When no
+ * `window` is present (SSR) it returns an inert stub — the browser plugin is only
+ * *selected* in the browser, so this is purely defensive.
+ */
+export const createBrowserHistory = () => {
+    if (typeof window === 'undefined') {
+        const stub = { pathname: '/', search: '', hash: '', state: null, key: '0' };
+        return {
+            get location() { return stub; },
+            push: () => { }, replace: () => { }, go: () => { }, listen: () => () => { }
+        };
+    }
+    const listeners = new Set();
+    let counter = 0;
+    const currentLocation = () => ({
+        pathname: window.location.pathname,
+        search: window.location.search,
+        hash: window.location.hash,
+        state: window.history.state ?? null,
+        key: String(counter)
+    });
+    const notify = () => {
+        const location = currentLocation();
+        listeners.forEach(callback => callback(location));
+    };
+    window.addEventListener('popstate', () => {
+        counter++;
+        notify();
+    });
+    return {
+        get location() { return currentLocation(); },
+        push: (to, state) => {
+            counter++;
+            window.history.pushState(state ?? null, '', to);
+            notify();
+        },
+        replace: (to, state) => {
+            window.history.replaceState(state ?? null, '', to);
+            notify();
+        },
+        go: delta => { window.history.go(delta); },
+        listen: callback => {
+            listeners.add(callback);
+            return () => { listeners.delete(callback); };
+        }
+    };
+};
+//# sourceMappingURL=history.js.map

package/build/browser/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/browser/history.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAmB,EAAE;IACvD,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,MAAM,IAAI,GAAa,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;QACrF,OAAO;YACL,IAAI,QAAQ,KAAK,OAAO,IAAI,CAAA,CAAC,CAAC;YAC9B,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;SAC5E,CAAA;IACH,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,EAAgC,CAAA;IACzD,IAAI,OAAO,GAAG,CAAC,CAAA;IAEf,MAAM,eAAe,GAAG,GAAa,EAAE,CAAC,CAAC;QACvC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ;QAClC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;QAC9B,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI;QAC1B,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,IAAI;QACnC,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC;KACrB,CAAC,CAAA;IAEF,MAAM,MAAM,GAAG,GAAG,EAAE;QAClB,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAA;QAClC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAA;IACnD,CAAC,CAAA;IAED,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,GAAG,EAAE;QACvC,OAAO,EAAE,CAAA;QACT,MAAM,EAAE,CAAA;IACV,CAAC,CAAC,CAAA;IAEF,OAAO;QACL,IAAI,QAAQ,KAAK,OAAO,eAAe,EAAE,CAAA,CAAC,CAAC;QAC3C,IAAI,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE;YAClB,OAAO,EAAE,CAAA;YACT,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,IAAI,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAA;YAC/C,MAAM,EAAE,CAAA;QACV,CAAC;QACD,OAAO,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE;YACrB,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,IAAI,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAA;YAClD,MAAM,EAAE,CAAA;QACV,CAAC;QACD,EAAE,EAAE,KAAK,CAAC,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,CAAA,CAAC,CAAC;QACzC,MAAM,EAAE,QAAQ,CAAC,EAAE;YACjB,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YACvB,OAAO,GAAG,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA,CAAC,CAAC,CAAA;QAC7C,CAAC;KACF,CAAA;AACH,CAAC,CAAA"}

package/build/browser/hooks.d.ts

@@ -0,0 +1,6 @@
+import type { Location, NavigateFunction, RouteParams, UseSearchParamsHook } from '@owlmeans/router';
+export declare const useParams: <T extends RouteParams = RouteParams>() => T;
+export declare const useLocation: () => Location;
+export declare const useNavigate: () => NavigateFunction;
+export declare const useSearchParams: UseSearchParamsHook;
+//# sourceMappingURL=hooks.d.ts.map

package/build/browser/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/browser/hooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAmB,mBAAmB,EAC9E,MAAM,kBAAkB,CAAA;AAWzB,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,WAAW,GAAG,WAAW,OAAK,CAGjE,CAAA;AAED,eAAO,MAAM,WAAW,QAAO,QAAqC,CAAA;AAEpE,eAAO,MAAM,WAAW,QAAO,gBAA6C,CAAA;AAE5E,eAAO,MAAM,eAAe,EAAE,mBAkB7B,CAAA"}

package/build/browser/hooks.js

@@ -0,0 +1,29 @@
+import { useContext, useMemo } from 'react';
+import { RouterStateContext } from './context.js';
+const useRouterState = () => {
+    const state = useContext(RouterStateContext);
+    if (state == null) {
+        throw new Error('owlmeans-browser-router: router hook used outside of the router provider');
+    }
+    return state;
+};
+export const useParams = () => {
+    const { matches } = useRouterState();
+    return (matches[matches.length - 1]?.params ?? {});
+};
+export const useLocation = () => useRouterState().location;
+export const useNavigate = () => useRouterState().navigate;
+export const useSearchParams = init => {
+    const { location, navigate } = useRouterState();
+    const search = useMemo(() => new URLSearchParams(location.search !== '' ? location.search : (init ?? '')), [location.search]);
+    const setSearch = (next, options) => {
+        const resolved = typeof next === 'function'
+            ? next(new URLSearchParams(location.search))
+            : next instanceof URLSearchParams ? next : new URLSearchParams(next);
+        const query = resolved.toString();
+        const path = `${location.pathname}${query !== '' ? `?${query}` : ''}${location.hash ?? ''}`;
+        navigate(path, { replace: options?.replace, state: options?.state });
+    };
+    return [search, setSearch];
+};
+//# sourceMappingURL=hooks.js.map

package/build/browser/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/browser/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAI3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAEjD,MAAM,cAAc,GAAG,GAAG,EAAE;IAC1B,MAAM,KAAK,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAA;IAC5C,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAA;IAC7F,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,GAA2C,EAAE;IACpE,MAAM,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,CAAA;IACpC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,MAAM,IAAI,EAAE,CAAM,CAAA;AACzD,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,GAAa,EAAE,CAAC,cAAc,EAAE,CAAC,QAAQ,CAAA;AAEpE,MAAM,CAAC,MAAM,WAAW,GAAG,GAAqB,EAAE,CAAC,cAAc,EAAE,CAAC,QAAQ,CAAA;AAE5E,MAAM,CAAC,MAAM,eAAe,GAAwB,IAAI,CAAC,EAAE;IACzD,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,cAAc,EAAE,CAAA;IAE/C,MAAM,MAAM,GAAG,OAAO,CACpB,GAAG,EAAE,CAAC,IAAI,eAAe,CAAC,QAAQ,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,EAClF,CAAC,QAAQ,CAAC,MAAM,CAAC,CAClB,CAAA;IAED,MAAM,SAAS,GAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;QACnD,MAAM,QAAQ,GAAG,OAAO,IAAI,KAAK,UAAU;YACzC,CAAC,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC5C,CAAC,CAAC,IAAI,YAAY,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,CAAA;QACtE,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAA;QACjC,MAAM,IAAI,GAAG,GAAG,QAAQ,CAAC,QAAQ,GAAG,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC,IAAI,IAAI,EAAE,EAAE,CAAA;QAC3F,QAAQ,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;IACtE,CAAC,CAAA;IAED,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;AAC5B,CAAC,CAAA"}

package/build/browser/outlet.d.ts

@@ -0,0 +1,9 @@
+import type { FC } from 'react';
+/**
+ * Renders the next-deeper matched route. Depth is tracked via `OutletContext`, so
+ * nested `<Outlet/>`s walk down the match chain — composing with the renderer in
+ * `@owlmeans/client` (parent components emit `<Outlet/>`). Component-less matches
+ * in between are skipped by `RouteChain` (implicit pass-through).
+ */
+export declare const Outlet: FC;
+//# sourceMappingURL=outlet.d.ts.map

package/build/browser/outlet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outlet.d.ts","sourceRoot":"","sources":["../../src/browser/outlet.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAA;AAK/B;;;;;GAKG;AACH,eAAO,MAAM,MAAM,EAAE,EAIpB,CAAA"}

package/build/browser/outlet.js

@@ -0,0 +1,14 @@
+import { createElement, useContext } from 'react';
+import { OutletContext } from './context.js';
+import { RouteChain } from './chain.js';
+/**
+ * Renders the next-deeper matched route. Depth is tracked via `OutletContext`, so
+ * nested `<Outlet/>`s walk down the match chain — composing with the renderer in
+ * `@owlmeans/client` (parent components emit `<Outlet/>`). Component-less matches
+ * in between are skipped by `RouteChain` (implicit pass-through).
+ */
+export const Outlet = () => {
+    const { depth } = useContext(OutletContext);
+    return createElement(RouteChain, { depth: depth + 1 });
+};
+//# sourceMappingURL=outlet.js.map

package/build/browser/outlet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outlet.js","sourceRoot":"","sources":["../../src/browser/outlet.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEvC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,MAAM,GAAO,GAAG,EAAE;IAC7B,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC,aAAa,CAAC,CAAA;IAE3C,OAAO,aAAa,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAA;AACxD,CAAC,CAAA"}

package/build/browser/plugin.d.ts

@@ -0,0 +1,8 @@
+import type { RouterPlugin } from '@owlmeans/router';
+/**
+ * The default OwlMeans in-browser routing plugin. Standard URL routing over the
+ * browser History API. Matches always (priority 0), so it is the universal
+ * fallback in the browser; a higher-priority SSR plugin can outrank it later.
+ */
+export declare const makeBrowserRouterPlugin: () => RouterPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/build/browser/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/browser/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAQnE;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,QAAO,YAezC,CAAA"}

package/build/browser/plugin.js

@@ -0,0 +1,27 @@
+import { flattenRoutes, rankRouteBranches } from '@owlmeans/router';
+import { BROWSER_ROUTER } from '../consts.js';
+import { BrowserRouterProvider } from './provider.js';
+import { Outlet } from './outlet.js';
+import { useLocation, useNavigate, useParams, useSearchParams } from './hooks.js';
+/**
+ * The default OwlMeans in-browser routing plugin. Standard URL routing over the
+ * browser History API. Matches always (priority 0), so it is the universal
+ * fallback in the browser; a higher-priority SSR plugin can outrank it later.
+ */
+export const makeBrowserRouterPlugin = () => ({
+    alias: BROWSER_ROUTER,
+    priority: 0,
+    mode: 'browser',
+    match: () => true,
+    compile: routes => ({
+        routes,
+        branches: rankRouteBranches(flattenRoutes(routes))
+    }),
+    provider: () => BrowserRouterProvider,
+    outlet: () => Outlet,
+    useParams,
+    useLocation,
+    useNavigate,
+    useSearchParams
+});
+//# sourceMappingURL=plugin.js.map

package/build/browser/plugin.js.map

@@ -0,0 +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"}

package/build/browser/provider.d.ts

@@ -0,0 +1,11 @@
+import type { FC } from 'react';
+import type { LibraryRouter } from '@owlmeans/router';
+/**
+ * Renders the OwlMeans library router. Subscribes to history, recomputes the
+ * matched route chain on navigation, and renders the top match. Initial render
+ * matches synchronously from `window.location` to avoid a first-paint flash.
+ */
+export declare const BrowserRouterProvider: FC<{
+    router: LibraryRouter;
+}>;
+//# sourceMappingURL=provider.d.ts.map

package/build/browser/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/browser/provider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAA;AAE/B,OAAO,KAAK,EAAE,aAAa,EAA8B,MAAM,kBAAkB,CAAA;AAOjF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,EAAE,CAAC;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE,CAsC/D,CAAA"}

package/build/browser/provider.js

@@ -0,0 +1,39 @@
+import { createElement, useEffect, useMemo, useRef, useState } from 'react';
+import { matchRoutes } from '@owlmeans/router';
+import { createBrowserHistory } from './history.js';
+import { RouterStateContext } from './context.js';
+import { RouteChain } from './chain.js';
+/**
+ * Renders the OwlMeans library router. Subscribes to history, recomputes the
+ * matched route chain on navigation, and renders the top match. Initial render
+ * matches synchronously from `window.location` to avoid a first-paint flash.
+ */
+export const BrowserRouterProvider = ({ router }) => {
+    const lib = router;
+    const historyRef = useRef(createBrowserHistory());
+    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 navigate = useMemo(() => ((to, options) => {
+        if (typeof to === 'number') {
+            history.go(to);
+            return;
+        }
+        if (typeof to === 'string' && to.startsWith('http')) {
+            window.location.href = to;
+            return;
+        }
+        const path = typeof to === 'string'
+            ? to
+            : `${to.pathname ?? ''}${to.search ?? ''}${to.hash ?? ''}`;
+        if (options?.replace) {
+            history.replace(path, options.state);
+        }
+        else {
+            history.push(path, options?.state);
+        }
+    }), [history]);
+    return createElement(RouterStateContext.Provider, { value: { location, matches, navigate } }, createElement(RouteChain, { depth: 0 }));
+};
+//# sourceMappingURL=provider.js.map

package/build/browser/provider.js.map

@@ -0,0 +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"}

package/build/browser/types.d.ts

@@ -0,0 +1,20 @@
+import type { Location, NavigateFunction, RouteMatch, RouteObject, RouteBranch } from '@owlmeans/router';
+/** The compiled library router produced by the browser plugin's `compile`. */
+export interface OwlLibraryRouter {
+    routes: RouteObject[];
+    branches: RouteBranch[];
+}
+/** Value carried by the router state React context. */
+export interface RouterState {
+    location: Location;
+    matches: RouteMatch[];
+    navigate: NavigateFunction;
+}
+export interface BrowserHistory {
+    readonly location: Location;
+    push: (to: string, state?: any) => void;
+    replace: (to: string, state?: any) => void;
+    go: (delta: number) => void;
+    listen: (callback: (location: Location) => void) => () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/browser/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/browser/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAExG,8EAA8E;AAC9E,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,WAAW,EAAE,CAAA;IACrB,QAAQ,EAAE,WAAW,EAAE,CAAA;CACxB;AAED,uDAAuD;AACvD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,QAAQ,CAAA;IAClB,OAAO,EAAE,UAAU,EAAE,CAAA;IACrB,QAAQ,EAAE,gBAAgB,CAAA;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,IAAI,CAAA;IACvC,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,IAAI,CAAA;IAC1C,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3B,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,KAAK,MAAM,IAAI,CAAA;CAC/D"}

package/build/browser/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/browser/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/browser/types.ts"],"names":[],"mappings":""}

package/build/consts.d.ts

@@ -0,0 +1,2 @@
+export declare const BROWSER_ROUTER = "owlmeans-browser-router";
+//# sourceMappingURL=consts.d.ts.map

package/build/consts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,cAAc,4BAA4B,CAAA"}

package/build/consts.js

@@ -0,0 +1,2 @@
+export const BROWSER_ROUTER = 'owlmeans-browser-router';
+//# sourceMappingURL=consts.js.map

package/build/consts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,cAAc,GAAG,yBAAyB,CAAA"}

package/build/index.d.ts

@@ -1,2 +1,10 @@
+export * from './consts.js';
 export * from './service.js';
+export * from './browser/plugin.js';
+export type * from './browser/types.js';
+export { BrowserRouterProvider } from './browser/provider.js';
+export { Outlet } from './browser/outlet.js';
+export { RouteChain } from './browser/chain.js';
+export { createBrowserHistory } from './browser/history.js';
+export { useParams, useLocation, useNavigate, useSearchParams } from './browser/hooks.js';
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,qBAAqB,CAAA;AACnC,mBAAmB,oBAAoB,CAAA;AACvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA"}

package/build/index.js

@@ -1,2 +1,9 @@
+export * from './consts.js';
 export * from './service.js';
+export * from './browser/plugin.js';
+export { BrowserRouterProvider } from './browser/provider.js';
+export { Outlet } from './browser/outlet.js';
+export { RouteChain } from './browser/chain.js';
+export { createBrowserHistory } from './browser/history.js';
+export { useParams, useLocation, useNavigate, useSearchParams } from './browser/hooks.js';
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,qBAAqB,CAAA;AAEnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA"}

package/build/service.d.ts

@@ -1,5 +1,14 @@
-import type { ClientConfig } from "@owlmeans/client-context";
-import type { ClientContext } from "@owlmeans/client";
-export declare const makeWebRouterService: () => import("@owlmeans/router").RouterService;
-export declare const appendWebRouter: <C extends ClientConfig, T extends ClientContext<C> = ClientContext<C>>(ctx: T) => void;
+import type { BasicConfig, BasicContext } from "@owlmeans/context";
+import type { RouterService } from "@owlmeans/router";
+/**
+ * Build a router service pre-loaded with the OwlMeans browser plugin. Kept for
+ * back-compat; prefer `appendWebRouter` which reuses an existing host.
+ */
+export declare const makeWebRouterService: () => RouterService;
+/**
+ * Register the OwlMeans in-browser routing plugin as the default on a context.
+ * Idempotent w.r.t. the router host — if another plugin (e.g. react-router) is
+ * already registered, this one is added alongside and selected by the cascade.
+ */
+export declare const appendWebRouter: <C extends BasicConfig, T extends BasicContext<C>>(ctx: T) => T;
 //# sourceMappingURL=service.d.ts.map

package/build/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAErD,eAAO,MAAM,oBAAoB,gDAwBhC,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,CAAC,SAAS,YAAY,EAAE,CAAC,SAAS,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,SAE5G,CAAA"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAIrD;;;GAGG;AACH,eAAO,MAAM,oBAAoB,QAAO,aAIvC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,KAAG,CAI1F,CAAA"}

package/build/service.js

@@ -1,26 +1,22 @@
-import { makeRouterService } from "@owlmeans/router";
-import { RouterProvider, useNavigate } from "react-router";
-import { Outlet, useLocation, useParams } from "react-router";
+import { ensureRouterService, makeRouterService } from "@owlmeans/router";
+import { makeBrowserRouterPlugin } from "./browser/plugin.js";
+/**
+ * Build a router service pre-loaded with the OwlMeans browser plugin. Kept for
+ * back-compat; prefer `appendWebRouter` which reuses an existing host.
+ */
 export const makeWebRouterService = () => {
     const service = makeRouterService();
-    service.outlet = () => {
-        return Outlet;
-    };
-    service.provider = () => {
-        return RouterProvider;
-    };
-    service.useParams = () => {
-        return useParams();
-    };
-    service.useLocation = () => {
-        return useLocation();
-    };
-    service.useNavigate = () => {
-        return useNavigate();
-    };
+    service.registerPlugin(makeBrowserRouterPlugin());
     return service;
 };
+/**
+ * Register the OwlMeans in-browser routing plugin as the default on a context.
+ * Idempotent w.r.t. the router host — if another plugin (e.g. react-router) is
+ * already registered, this one is added alongside and selected by the cascade.
+ */
 export const appendWebRouter = (ctx) => {
-    ctx.registerService(makeWebRouterService());
+    const service = ensureRouterService(ctx);
+    service.registerPlugin(makeBrowserRouterPlugin());
+    return ctx;
 };
 //# sourceMappingURL=service.js.map