@owlmeans/client-route 0.1.18-rc.9 → 0.1.18

package/README.md

@@ -4,33 +4,33 @@ Client-side route model extension — marks routes as client-side and provides U
 
 ## Overview
 
-- `route(routeModel, opts?)` — wraps a `CommonRouteModel` into a `ClientRouteModel` (marks `_client: true`)
-- `isClientRouteModel(route)` — type guard distinguishing client routes from server routes
-- `extractParams(path)` — extracts path parameter names (`:param` segments) from a URL pattern
-- Used internally by `@owlmeans/client-module` when building client-side module URLs
+- `route(routeModel, opts?)` — wraps a `RouteModel` into a `ClientRouteModel` (marks `_client: true`)
+- `clientRouteHelper.isClientRouteModel(route)` — type guard distinguishing client routes from server routes
+- `clientRouteHelper.extractParams(path)` — extracts path parameter names (`:param` segments) from a URL pattern
+- Used internally by `@owlmeans/client-entrypoint` when building client-side entrypoint URLs
 
 ## Installation
 
 ```bash
-bun add @owlmeans/client-route
+bun add @owlmeans/client-route@^0.1.18
 ```
 
 ## Usage
 
 ```typescript
-import { route, isClientRouteModel, extractParams } from '@owlmeans/client-route'
+import { route, clientRouteHelper } from '@owlmeans/client-route'
 import type { ClientRouteModel } from '@owlmeans/client-route'
 
 // Wrap a route as a client route
-const clientRoute = route(someRouteModel, { overrides: { partialPath: '/items' } })
+const clientRoute = route(someRouteModel, { overrides: { service: 'api' } })
 
 // Type guard
-if (isClientRouteModel(arg)) {
+if (clientRouteHelper.isClientRouteModel(arg)) {
   // arg is ClientRouteModel
 }
 
 // Extract named params from a path pattern
-const params = extractParams('/projects/:projectId/items/:itemId')
+const params = clientRouteHelper.extractParams('/projects/:projectId/items/:itemId')
 // => ['projectId', 'itemId']
 ```
 
@@ -38,24 +38,28 @@ const params = extractParams('/projects/:projectId/items/:itemId')
 
 ### `route(route, opts?): ClientRouteModel`
 
-Converts a `CommonRouteModel` to a `ClientRouteModel`. Options: `overrides?: Partial<ClientRoute>`.
+Converts a `RouteModel` to a `ClientRouteModel`. Options: `overrides?: Partial<ClientRoute>` — the
+overrides only fill in declaration fields that are still unset.
 
-### `isClientRouteModel(route): route is ClientRouteModel`
+### `clientRouteHelper.isClientRouteModel(route): route is ClientRouteModel`
 
 Returns `true` if the route was created with `route()`.
 
-### `extractParams(path): string[]`
+### `clientRouteHelper.extractParams(path): string[]`
 
 Returns the list of `:param` segment names in a URL pattern string.
 
 ### `ClientRouteModel`
 
-Extends `CommonRouteModel` with `_client: true` flag and `partialPath` for relative URL segments.
+Extends `RouteModel` with the `_client: true` flag. It holds no address state: the declaration keeps
+only the segment this route contributes, and the entrypoint answers `segment()`, `path()`, `mount()`
+and `address()` on demand against the context that asks.
 
 ## Related Packages
 
-- [`@owlmeans/route`](../route) — `CommonRouteModel`, `CommonRoute` base types
-- [`@owlmeans/client-module`](../client-module) — uses `route()` and `isClientRouteModel()` when constructing modules
+- [`@owlmeans/route`](../route) — `RouteModel`, `RouteDeclaration` base types and the pure
+  `resolvePath` / `resolveMount` / `resolveAddress` utilities under `@owlmeans/route/utils`
+- [`@owlmeans/client-entrypoint`](../client-entrypoint) — uses `route()` and `clientRouteHelper.isClientRouteModel()` when constructing entrypoints
 
 <!-- owlmeans:agent-guidance:start -->
 ## Agent guidance
@@ -65,7 +69,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
 ```
 
 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,
+  "schemaVersion": 3,
   "package": "@owlmeans/client-route",
-  "version": "0.1.18-rc.8",
-  "generatedAt": "2026-08-27T16:32:18.466Z",
+  "version": "0.1.18",
+  "generatedAt": "2026-10-28T00:31:34.710Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/client-route/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: client-route
-description: How to use @owlmeans/client-route — client-side route resolution that turns route declarations into navigation paths. Auto-invoked when importing client route helpers.
+description: How to use @owlmeans/client-route — marking a route model as client-side and extracting its :params. Auto-invoked when importing client route helpers.
 user-invocable: false
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
@@ -8,24 +8,35 @@ user-invocable: false
 # @owlmeans/client-route
 
 **Layer:** Client
-**Install:** `"@owlmeans/client-route": "^0.1.18-rc.8"` in `dependencies`
+**Install:** `"@owlmeans/client-route": "^0.1.18"` in `dependencies`
 
 ## Key Exports
 
 | Export | Description |
 |--------|-------------|
-| `ClientRoute` types | Resolved client-side route shape |
-| Helpers | Build client routes from declarations |
-| Model | Path normalization, parent inheritance |
+| `route(model, opts?)` | Mark a route model as a client one, filling in whatever the declaration left blank |
+| `ClientRouteModel` | A `RouteModel` carrying the `_client: true` marker |
+| `ClientRoute` | The declaration a client route wraps |
+| `ClientRouteOptions` | `{ overrides }` — defaults applied to blank declaration fields |
+| `isClientRouteModel(obj)` | The `_client` marker test |
+| `extractParams(path)` | The `:param` names a path declares, in order |
 
 ## Usage
 
 Most app code uses route declarations from `@owlmeans/route` and lets `@owlmeans/web-router` consume them. Import here only for custom routing.
 
 ```typescript
-import { resolveClientRoute } from '@owlmeans/client-route'
+import { route, extractParams } from '@owlmeans/client-route'
+
+const model = route(declaration, { overrides: { service: 'manager' } })
+extractParams('/project/:id/task/:taskId')   // ['id', 'taskId']
 ```
 
+Marking is all this does: the declared `path` stays the **segment** the route contributes, and the
+full path, mount and address are computed by the entrypoint against the context that asks. Nothing
+here rewrites a declaration — `overrides` only fills fields the declaration left blank.
+
 ## Depends On
 
-- `@owlmeans/route`, `@owlmeans/router`
+- `@owlmeans/route` — `RouteModel`, `overrideParams` (from `/utils`), `normalizePath`, `SEP`, `PARAM`
+- `@owlmeans/client-context`

package/build/helper/types.d.ts

@@ -0,0 +1,9 @@
+import type { ClientRouteModel } from '../types.js';
+/** Reads client route models and their paths. */
+export interface ClientRouteHelper {
+    /** Whether a route model was marked as a client one. */
+    isClientRouteModel: (route: Object) => route is ClientRouteModel;
+    /** The names of the `:param` segments of a path, in order. */
+    extractParams: (path: string) => string[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/helper/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEnD,iDAAiD;AACjD,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,kBAAkB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,KAAK,IAAI,gBAAgB,CAAA;IAChE,8DAA8D;IAC9D,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,CAAA;CAC1C"}

package/build/helper/types.js

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

package/build/helper/types.js.map

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

package/build/helper.d.ts

@@ -1,4 +1,4 @@
-import { ClientRouteModel } from './types.js';
-export declare const isClientRouteModel: (route: Object) => route is ClientRouteModel;
-export declare const extractParams: (path: string) => string[];
+import type { ClientRouteHelper } from './helper/types.js';
+export declare const createClientRouteHelper: () => ClientRouteHelper;
+export declare const clientRouteHelper: ClientRouteHelper;
 //# sourceMappingURL=helper.d.ts.map

package/build/helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAE7C,eAAO,MAAM,kBAAkB,UAAW,MAAM,KAAG,KAAK,IAAI,gBACxC,CAAA;AAEpB,eAAO,MAAM,aAAa,SAAU,MAAM,KAAG,MAAM,EAIlD,CAAA"}
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAE1D,eAAO,MAAM,uBAAuB,QAAO,iBAW1C,CAAA;AAED,eAAO,MAAM,iBAAiB,mBAA4B,CAAA"}

package/build/helper.js

@@ -1,8 +1,12 @@
 import { PARAM, SEP, normalizePath } from '@owlmeans/route';
-export const isClientRouteModel = (route) => '_client' in route;
-export const extractParams = (path) => {
-    path = normalizePath(path);
-    return path.split(SEP).map(item => item.startsWith(PARAM) ? item.slice(1) : null)
-        .filter(param => param);
+export const createClientRouteHelper = () => {
+    const isClientRouteModel = (route) => '_client' in route;
+    const extractParams = (path) => {
+        path = normalizePath(path);
+        return path.split(SEP).map(item => item.startsWith(PARAM) ? item.slice(1) : null)
+            .filter(param => param);
+    };
+    return { isClientRouteModel, extractParams };
 };
+export const clientRouteHelper = createClientRouteHelper();
 //# sourceMappingURL=helper.js.map

package/build/helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"helper.js","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAG3D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAa,EAA6B,EAAE,CAC7E,SAAS,IAAI,KAAK,CAAA;AAEpB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAY,EAAY,EAAE;IACtD,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;IAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;SAC9E,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAa,CAAA;AACvC,CAAC,CAAA"}
+{"version":3,"file":"helper.js","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAI3D,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAsB,EAAE;IAC7D,MAAM,kBAAkB,GAAG,CAAC,KAAa,EAA6B,EAAE,CACtE,SAAS,IAAI,KAAK,CAAA;IAEpB,MAAM,aAAa,GAAG,CAAC,IAAY,EAAY,EAAE;QAC/C,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;QAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;aAC9E,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAa,CAAA;IACvC,CAAC,CAAA;IAED,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,CAAA;AAC9C,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,uBAAuB,EAAE,CAAA"}

package/build/index.d.ts

@@ -1,4 +1,5 @@
 export * from './model.js';
 export type * from './types.js';
+export type * from './helper/types.js';
 export * from './helper.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,YAAY,CAAA;AAC1B,mBAAmB,YAAY,CAAA;AAC/B,cAAc,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAA;AAC1B,mBAAmB,YAAY,CAAA;AAC/B,mBAAmB,mBAAmB,CAAA;AACtC,cAAc,aAAa,CAAA"}

package/build/index.js.map

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

package/build/model.d.ts

@@ -1,4 +1,9 @@
-import type { CommonRouteModel } from '@owlmeans/route';
+import type { RouteModel } from '@owlmeans/route';
 import type { ClientRouteModel, ClientRouteOptions } from './types.js';
-export declare const route: (route: CommonRouteModel, opts?: ClientRouteOptions) => ClientRouteModel;
+/**
+ * Mark a route model as a client one and fill in whatever the declaration left blank.
+ * The declared `path` stays the segment this route contributes — the entrypoint composes the
+ * full path and the address on demand.
+ */
+export declare const route: (route: RouteModel, opts?: ClientRouteOptions) => ClientRouteModel;
 //# sourceMappingURL=model.d.ts.map

package/build/model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAItE,eAAO,MAAM,KAAK,UAAW,gBAAgB,SAAS,kBAAkB,KAAG,gBAoC1E,CAAA"}
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAGtE;;;;GAIG;AACH,eAAO,MAAM,KAAK,UAAW,UAAU,SAAS,kBAAkB,KAAG,gBAUpE,CAAA"}

package/build/model.js

@@ -1,27 +1,15 @@
-import { resolve, overrideParams } from '@owlmeans/route/utils';
+import { routeDeclarationHelper } from '@owlmeans/route/utils';
+/**
+ * Mark a route model as a client one and fill in whatever the declaration left blank.
+ * The declared `path` stays the segment this route contributes — the entrypoint composes the
+ * full path and the address on demand.
+ */
 export const route = (route, opts) => {
-    const unresolvedPath = route.route.path;
     const model = {
         ...route,
-        _client: true,
-        resolve: async (context) => {
-            if (model.route.resolved) {
-                if (model._resolved == null) {
-                    throw new SyntaxError('Cannot reach resolved state twice without resolving promise');
-                }
-                await model._resolved;
-                return model.route;
-            }
-            const resolver = {};
-            model._resolved = new Promise(resolve => resolver.resolve = resolve);
-            await resolve(model.route)(context);
-            model.route.partialPath = unresolvedPath;
-            resolver.resolve?.();
-            return model.route;
-        }
+        _client: true
     };
-    overrideParams(model.route, opts?.overrides);
-    model.route.partialPath = unresolvedPath;
+    routeDeclarationHelper.overrideParams(model.route, opts?.overrides);
     return model;
 };
 //# sourceMappingURL=model.js.map

package/build/model.js.map

@@ -1 +1 @@
-{"version":3,"file":"model.js","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAG/D,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAuB,EAAE,IAAyB,EAAoB,EAAE;IAC5F,MAAM,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAA;IAEvC,MAAM,KAAK,GAAqB;QAC9B,GAAI,KAA0B;QAE9B,OAAO,EAAE,IAAI;QAEb,OAAO,EAAE,KAAK,EAAK,OAAU,EAAE,EAAE;YAC/B,IAAI,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACzB,IAAI,KAAK,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC;oBAC5B,MAAM,IAAI,WAAW,CAAC,6DAA6D,CAAC,CAAA;gBACtF,CAAC;gBACD,MAAM,KAAK,CAAC,SAAS,CAAA;gBAErB,OAAO,KAAK,CAAC,KAAK,CAAA;YACpB,CAAC;YAED,MAAM,QAAQ,GAA6B,EAAE,CAAA;YAC7C,KAAK,CAAC,SAAS,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC,CAAA;YAEpE,MAAM,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,OAAoC,CAAC,CAAA;YAEhE,KAAK,CAAC,KAAK,CAAC,WAAW,GAAG,cAAc,CAAA;YAExC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAA;YAEpB,OAAO,KAAK,CAAC,KAAK,CAAA;QACpB,CAAC;KACF,CAAA;IAED,cAAc,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,CAAA;IAE5C,KAAK,CAAC,KAAK,CAAC,WAAW,GAAG,cAAc,CAAA;IAExC,OAAO,KAAK,CAAA;AACd,CAAC,CAAA"}
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAE9D;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAiB,EAAE,IAAyB,EAAoB,EAAE;IACtF,MAAM,KAAK,GAAqB;QAC9B,GAAI,KAA0B;QAE9B,OAAO,EAAE,IAAI;KACd,CAAA;IAED,sBAAsB,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,CAAA;IAEnE,OAAO,KAAK,CAAA;AACd,CAAC,CAAA"}

package/build/types.d.ts

@@ -1,10 +1,12 @@
-import type { CommonRoute, CommonRouteModel } from '@owlmeans/route';
-export interface ClientRoute extends CommonRoute {
-    partialPath: string;
+import type { RouteDeclaration, RouteModel } from '@owlmeans/route';
+export interface ClientRoute extends RouteDeclaration {
 }
-export interface ClientRouteModel extends CommonRouteModel {
+/**
+ * A route declaration marked as belonging to the client side. It carries no state of its own —
+ * the segment, path and address are computed by the entrypoint against the context that asks.
+ */
+export interface ClientRouteModel extends RouteModel {
     route: ClientRoute;
-    _resolved?: Promise<void>;
     _client: true;
 }
 export interface ClientRouteOptions {

package/build/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAEpE,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC9C,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,KAAK,EAAE,WAAW,CAAA;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IACzB,OAAO,EAAE,IAAI,CAAA;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;CACjC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEnE,MAAM,WAAW,WAAY,SAAQ,gBAAgB;CACpD;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,KAAK,EAAE,WAAW,CAAA;IAClB,OAAO,EAAE,IAAI,CAAA;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;CACjC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/client-route",
-  "version": "0.1.18-rc.9",
+  "version": "0.1.18",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -21,11 +21,11 @@
     }
   },
   "dependencies": {
-    "@owlmeans/client-context": "^0.1.18-rc.9",
-    "@owlmeans/route": "^0.1.18-rc.6"
+    "@owlmeans/client-context": "^0.1.18",
+    "@owlmeans/route": "^0.1.18"
   },
   "devDependencies": {
-    "@owlmeans/dep-config": "workspace:*",
+    "@owlmeans/dep-config": "^0.1.18",
     "nodemon": "^3.1.14",
     "typescript": "^7.0.2"
   },

package/src/helper/types.ts

@@ -0,0 +1,9 @@
+import type { ClientRouteModel } from '../types.js'
+
+/** Reads client route models and their paths. */
+export interface ClientRouteHelper {
+  /** Whether a route model was marked as a client one. */
+  isClientRouteModel: (route: Object) => route is ClientRouteModel
+  /** The names of the `:param` segments of a path, in order. */
+  extractParams: (path: string) => string[]
+}

package/src/helper.ts

@@ -1,11 +1,18 @@
 import { PARAM, SEP, normalizePath } from '@owlmeans/route'
-import { ClientRouteModel } from './types.js'
+import type { ClientRouteModel } from './types.js'
+import type { ClientRouteHelper } from './helper/types.js'
 
-export const isClientRouteModel = (route: Object): route is ClientRouteModel => 
-  '_client' in route
+export const createClientRouteHelper = (): ClientRouteHelper => {
+  const isClientRouteModel = (route: Object): route is ClientRouteModel =>
+    '_client' in route
 
-export const extractParams = (path: string): string[] => {
-  path = normalizePath(path)
-  return path.split(SEP).map(item => item.startsWith(PARAM) ? item.slice(1) : null)
-    .filter(param => param) as string[]
+  const extractParams = (path: string): string[] => {
+    path = normalizePath(path)
+    return path.split(SEP).map(item => item.startsWith(PARAM) ? item.slice(1) : null)
+      .filter(param => param) as string[]
+  }
+
+  return { isClientRouteModel, extractParams }
 }
+
+export const clientRouteHelper = createClientRouteHelper()

package/src/index.ts

@@ -1,4 +1,5 @@
 
 export * from './model.js'
 export type * from './types.js'
+export type * from './helper/types.js'
 export * from './helper.js'

package/src/model.ts

@@ -1,42 +1,20 @@
-import type { CommonRouteModel } from '@owlmeans/route'
+import type { RouteModel } from '@owlmeans/route'
 import type { ClientRouteModel, ClientRouteOptions } from './types.js'
-import { resolve, overrideParams } from '@owlmeans/route/utils'
-import type { BasicConfig, BasicContext } from '../../context/build/types.js'
-
-export const route = (route: CommonRouteModel, opts?: ClientRouteOptions): ClientRouteModel => {
-  const unresolvedPath = route.route.path
-
+import { routeDeclarationHelper } from '@owlmeans/route/utils'
+
+/**
+ * Mark a route model as a client one and fill in whatever the declaration left blank.
+ * The declared `path` stays the segment this route contributes — the entrypoint composes the
+ * full path and the address on demand.
+ */
+export const route = (route: RouteModel, opts?: ClientRouteOptions): ClientRouteModel => {
   const model: ClientRouteModel = {
     ...(route as ClientRouteModel),
 
-    _client: true,
-
-    resolve: async <C>(context: C) => {
-      if (model.route.resolved) {
-        if (model._resolved == null) {
-          throw new SyntaxError('Cannot reach resolved state twice without resolving promise')
-        }
-        await model._resolved
-
-        return model.route
-      }
-
-      const resolver: { resolve?: () => void } = {}
-      model._resolved = new Promise(resolve => resolver.resolve = resolve)
-
-      await resolve(model.route)(context as BasicContext<BasicConfig>)
-
-      model.route.partialPath = unresolvedPath
-
-      resolver.resolve?.()
-
-      return model.route
-    }
+    _client: true
   }
 
-  overrideParams(model.route, opts?.overrides)
-
-  model.route.partialPath = unresolvedPath
+  routeDeclarationHelper.overrideParams(model.route, opts?.overrides)
 
   return model
 }

package/src/types.ts

@@ -1,12 +1,14 @@
-import type { CommonRoute, CommonRouteModel } from '@owlmeans/route'
+import type { RouteDeclaration, RouteModel } from '@owlmeans/route'
 
-export interface ClientRoute extends CommonRoute {
-  partialPath: string
+export interface ClientRoute extends RouteDeclaration {
 }
 
-export interface ClientRouteModel extends CommonRouteModel {
+/**
+ * A route declaration marked as belonging to the client side. It carries no state of its own —
+ * the segment, path and address are computed by the entrypoint against the context that asks.
+ */
+export interface ClientRouteModel extends RouteModel {
   route: ClientRoute
-  _resolved?: Promise<void>
   _client: true
 }