@owlmeans/web-router-react-router 0.1.14

package/README.md

@@ -0,0 +1,16 @@
+<!-- owlmeans:agent-guidance:start -->
+## Agent guidance
+
+This package ships embedded Claude Code skills and GitHub Copilot instructions under
+`agent-meta/`. After installing your `@owlmeans/*` packages, run the OwlMeans
+agent-skills installer to place them into your project's native locations
+(`.claude/skills/` and `.github/instructions/`):
+
+```sh
+npx @owlmeans/agent-skills
+```
+
+The embedded files are version-matched to this package release. Do not edit them
+directly — they are regenerated on each publish. To contribute guidance edits,
+open a PR against the source monorepo.
+<!-- owlmeans:agent-guidance:end -->

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

@@ -0,0 +1,34 @@
+---
+description: "How to use @owlmeans/web-router-react-router — the opt-in React Router v7 routing plugin for OwlMeans. Use when an app should route with react-router instead of the default OwlMeans browser router."
+applyTo: "**/*.ts, **/*.tsx"
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# @owlmeans/web-router-react-router
+
+**Layer:** Web (React), L2
+**Install:** `"@owlmeans/web-router-react-router": "^0.1.14"` in `dependencies`
+
+React Router v7 as an OwlMeans routing plugin, extracted from the former `web-router` so react-router
+is opt-in. OwlMeans in-browser routing is the default.
+
+## Key Exports
+
+| Export | Description |
+|--------|-------------|
+| `appendReactRouter(ctx)` | Register the react-router plugin (priority 100 → wins the cascade). |
+| `makeReactRouterPlugin()` | The `RouterPlugin` (alias `react-router`); `compile` = `createBrowserRouter`. |
+| `REACT_ROUTER`, `REACT_ROUTER_PRIORITY` | Constants. |
+
+## Usage
+
+```typescript
+import { appendReactRouter } from '@owlmeans/web-router-react-router'
+export const makeContext = (cfg) => { const c = makeBaseContext(cfg); appendReactRouter(c); return c }
+```
+
+Route/entrypoint declarations don't change — path descriptions are identical.
+
+## Depends On
+
+- `@owlmeans/router`, `@owlmeans/context`; peer `react`, `react-router@^7.9.6`

package/agent-meta/manifest.json

@@ -0,0 +1,23 @@
+{
+  "schemaVersion": 1,
+  "package": "@owlmeans/web-router-react-router",
+  "version": "0.1.14",
+  "generatedAt": "2026-08-05T16:56:53.379Z",
+  "canonicalRepo": "https://github.com/owlmeans/common",
+  "entries": [
+    {
+      "kind": "skill",
+      "name": "web-router-react-router",
+      "category": "package-specific",
+      "file": "skills/web-router-react-router/SKILL.md",
+      "canonicalPath": ".claude/skills/web-router-react-router/SKILL.md"
+    },
+    {
+      "kind": "instruction",
+      "name": "web-router-react-router",
+      "category": "package-specific",
+      "file": "instructions/web-router-react-router.instructions.md",
+      "canonicalPath": ".github/instructions/web-router-react-router.instructions.md"
+    }
+  ]
+}

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

@@ -0,0 +1,49 @@
+---
+name: web-router-react-router
+description: How to use @owlmeans/web-router-react-router — the opt-in React Router v7 routing plugin for OwlMeans (register with appendReactRouter to override the default OwlMeans browser router). Auto-invoked when using react-router with OwlMeans.
+user-invocable: false
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# @owlmeans/web-router-react-router
+
+**Layer:** Web (React), build level L2
+**Install:** `"@owlmeans/web-router-react-router": "^0.1.14"` in `dependencies`
+
+The React Router v7 mechanic as an OwlMeans routing plugin. Extracted from the former `web-router`
+so react-router is **opt-in**: OwlMeans in-browser routing is the default, and you add this plugin
+only when you specifically want react-router.
+
+## Key Exports
+
+| Export | Description |
+|--------|-------------|
+| `appendReactRouter(ctx)` | Register the react-router plugin on the router host (priority 100 → wins the cascade over the default). |
+| `makeReactRouterPlugin()` | The `RouterPlugin` (alias `react-router`). `compile` = `createBrowserRouter`; provider/outlet/hooks from react-router. |
+| Constants | `REACT_ROUTER`, `REACT_ROUTER_PRIORITY`. |
+
+## Usage
+
+```typescript
+import { appendReactRouter } from '@owlmeans/web-router-react-router'
+
+export const makeContext = (cfg) => {
+  const context = makeBaseContext(cfg)   // registers the default OwlMeans browser plugin
+  appendReactRouter(context)             // react-router now handles routing instead
+  return context
+}
+```
+
+Because it registers at priority 100 (above the default 0), calling `appendReactRouter` after the
+default `appendWebRouter` makes react-router the active plugin via the cascade — no other changes
+needed. Route descriptions are identical (same path placeholders), so route/entrypoint declarations
+don't change.
+
+## Depends On
+
+- `@owlmeans/router` (host), `@owlmeans/context`
+- peer `react`, `react-router@^7.9.6`
+
+## Related
+
+- [[router]] (host) · [[web-router]] (default OwlMeans plugin) · [[router-plugins]] (the plugin model)

package/build/consts.d.ts

@@ -0,0 +1,4 @@
+export declare const REACT_ROUTER = "react-router";
+/** Registered above the default OwlMeans plugin so it wins the cascade when added. */
+export declare const REACT_ROUTER_PRIORITY = 100;
+//# 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,YAAY,iBAAiB,CAAA;AAE1C,sFAAsF;AACtF,eAAO,MAAM,qBAAqB,MAAM,CAAA"}

package/build/consts.js

@@ -0,0 +1,4 @@
+export const REACT_ROUTER = 'react-router';
+/** Registered above the default OwlMeans plugin so it wins the cascade when added. */
+export const REACT_ROUTER_PRIORITY = 100;
+//# 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,YAAY,GAAG,cAAc,CAAA;AAE1C,sFAAsF;AACtF,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAA"}

package/build/index.d.ts

@@ -0,0 +1,4 @@
+export * from './consts.js';
+export * from './plugin.js';
+export * from './service.js';
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA"}

package/build/index.js

@@ -0,0 +1,4 @@
+export * from './consts.js';
+export * from './plugin.js';
+export * from './service.js';
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA"}

package/build/plugin.d.ts

@@ -0,0 +1,8 @@
+import type { RouterPlugin } from '@owlmeans/router';
+/**
+ * React Router v7 as an OwlMeans routing plugin. Extracted from the former
+ * `web-router` so react-router is opt-in: register it with `appendReactRouter`
+ * (or a `clientPlugin` preference) and its higher priority wins the cascade.
+ */
+export declare const makeReactRouterPlugin: () => RouterPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/build/plugin.d.ts.map

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

package/build/plugin.js

@@ -0,0 +1,21 @@
+import { Outlet, RouterProvider, createBrowserRouter, useLocation as rrUseLocation, useNavigate as rrUseNavigate, useParams as rrUseParams, useSearchParams as rrUseSearchParams } from 'react-router';
+import { REACT_ROUTER, REACT_ROUTER_PRIORITY } from './consts.js';
+/**
+ * React Router v7 as an OwlMeans routing plugin. Extracted from the former
+ * `web-router` so react-router is opt-in: register it with `appendReactRouter`
+ * (or a `clientPlugin` preference) and its higher priority wins the cascade.
+ */
+export const makeReactRouterPlugin = () => ({
+    alias: REACT_ROUTER,
+    priority: REACT_ROUTER_PRIORITY,
+    mode: 'browser',
+    match: () => true,
+    compile: routes => createBrowserRouter(routes),
+    provider: () => RouterProvider,
+    outlet: () => Outlet,
+    useParams: () => rrUseParams(),
+    useLocation: () => rrUseLocation(),
+    useNavigate: () => rrUseNavigate(),
+    useSearchParams: init => rrUseSearchParams(init)
+});
+//# sourceMappingURL=plugin.js.map

package/build/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,MAAM,EAAE,cAAc,EAAE,mBAAmB,EAC3C,WAAW,IAAI,aAAa,EAAE,WAAW,IAAI,aAAa,EAC1D,SAAS,IAAI,WAAW,EAAE,eAAe,IAAI,iBAAiB,EAC/D,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAEjE;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAiB,EAAE,CAAC,CAAC;IACxD,KAAK,EAAE,YAAY;IACnB,QAAQ,EAAE,qBAAqB;IAC/B,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI;IACjB,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,mBAAmB,CAAC,MAA4B,CAA6B;IAChG,QAAQ,EAAE,GAAG,EAAE,CAAC,cAAc;IAC9B,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM;IACpB,SAAS,EAAE,GAAwC,EAAE,CAAC,WAAW,EAAO;IACxE,WAAW,EAAE,GAAG,EAAE,CAAC,aAAa,EAAE;IAClC,WAAW,EAAE,GAAG,EAAE,CAAC,aAAa,EAAE;IAClC,eAAe,EAAE,IAAI,CAAC,EAAE,CAAC,iBAAiB,CAAC,IAAW,CAAQ;CAC/D,CAAC,CAAA"}

package/build/service.d.ts

@@ -0,0 +1,8 @@
+import type { BasicConfig, BasicContext } from '@owlmeans/context';
+/**
+ * Register the react-router plugin on a context. It registers at a higher
+ * priority than the default OwlMeans browser plugin, so calling this from an
+ * app's `makeContext` switches routing to react-router.
+ */
+export declare const appendReactRouter: <C extends BasicConfig, T extends BasicContext<C>>(ctx: T) => T;
+//# sourceMappingURL=service.d.ts.map

package/build/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAIlE;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,KAAG,CAI5F,CAAA"}

package/build/service.js

@@ -0,0 +1,13 @@
+import { ensureRouterService } from '@owlmeans/router';
+import { makeReactRouterPlugin } from './plugin.js';
+/**
+ * Register the react-router plugin on a context. It registers at a higher
+ * priority than the default OwlMeans browser plugin, so calling this from an
+ * app's `makeContext` switches routing to react-router.
+ */
+export const appendReactRouter = (ctx) => {
+    const service = ensureRouterService(ctx);
+    service.registerPlugin(makeReactRouterPlugin());
+    return ctx;
+};
+//# sourceMappingURL=service.js.map

package/build/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAEnD;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAmD,GAAM,EAAK,EAAE;IAC/F,MAAM,OAAO,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAA;IACxC,OAAO,CAAC,cAAc,CAAC,qBAAqB,EAAE,CAAC,CAAA;IAC/C,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@owlmeans/web-router-react-router",
+  "version": "0.1.14",
+  "license": "MIT",
+  "type": "module",
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "sleep 63 && nodemon -e ts,tsx,json --watch src --exec \"tsc -p ./tsconfig.json\"",
+    "watch": "tsc -b -w --preserveWatchOutput --pretty"
+  },
+  "main": "build/index.js",
+  "module": "build/index.js",
+  "types": "build/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./build/index.js",
+      "require": "./build/index.js",
+      "default": "./build/index.js",
+      "module": "./build/index.js",
+      "types": "./build/index.d.ts"
+    }
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-router": "^7.9.6"
+  },
+  "devDependencies": {
+    "@owlmeans/dep-config": "workspace:*",
+    "@types/node": "^26.1.0",
+    "@types/react": "^19.2.17",
+    "nodemon": "^3.1.14",
+    "react-router": "^7.9.6",
+    "typescript": "^6.0.3"
+  },
+  "dependencies": {
+    "@owlmeans/context": "^0.1.14",
+    "@owlmeans/router": "^0.1.14"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/consts.ts

@@ -0,0 +1,5 @@
+
+export const REACT_ROUTER = 'react-router'
+
+/** Registered above the default OwlMeans plugin so it wins the cascade when added. */
+export const REACT_ROUTER_PRIORITY = 100

package/src/index.ts

@@ -0,0 +1,4 @@
+
+export * from './consts.js'
+export * from './plugin.js'
+export * from './service.js'

package/src/plugin.ts

@@ -0,0 +1,27 @@
+import type { LibraryRouter, RouteParams, RouterPlugin } from '@owlmeans/router'
+import type { RouteObject as ReactRouteObject } from 'react-router'
+import {
+  Outlet, RouterProvider, createBrowserRouter,
+  useLocation as rrUseLocation, useNavigate as rrUseNavigate,
+  useParams as rrUseParams, useSearchParams as rrUseSearchParams
+} from 'react-router'
+import { REACT_ROUTER, REACT_ROUTER_PRIORITY } from './consts.js'
+
+/**
+ * React Router v7 as an OwlMeans routing plugin. Extracted from the former
+ * `web-router` so react-router is opt-in: register it with `appendReactRouter`
+ * (or a `clientPlugin` preference) and its higher priority wins the cascade.
+ */
+export const makeReactRouterPlugin = (): RouterPlugin => ({
+  alias: REACT_ROUTER,
+  priority: REACT_ROUTER_PRIORITY,
+  mode: 'browser',
+  match: () => true,
+  compile: routes => createBrowserRouter(routes as ReactRouteObject[]) as unknown as LibraryRouter,
+  provider: () => RouterProvider,
+  outlet: () => Outlet,
+  useParams: <T extends RouteParams = RouteParams>() => rrUseParams() as T,
+  useLocation: () => rrUseLocation(),
+  useNavigate: () => rrUseNavigate(),
+  useSearchParams: init => rrUseSearchParams(init as any) as any
+})

package/src/service.ts

@@ -0,0 +1,14 @@
+import type { BasicConfig, BasicContext } from '@owlmeans/context'
+import { ensureRouterService } from '@owlmeans/router'
+import { makeReactRouterPlugin } from './plugin.js'
+
+/**
+ * Register the react-router plugin on a context. It registers at a higher
+ * priority than the default OwlMeans browser plugin, so calling this from an
+ * app's `makeContext` switches routing to react-router.
+ */
+export const appendReactRouter = <C extends BasicConfig, T extends BasicContext<C>>(ctx: T): T => {
+  const service = ensureRouterService(ctx)
+  service.registerPlugin(makeReactRouterPlugin())
+  return ctx
+}

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "extends": [
+    "@owlmeans/dep-config/tsconfig.base.json",
+    "@owlmeans/dep-config/tsconfig.react.json"
+  ],
+  "compilerOptions": {
+    "rootDir": "./src/",
+    "outDir": "./build/"
+  },
+  "exclude": ["./dist/**/*", "./build/**/*", "./*.ts"]
+}