@owlmeans/client-context 0.1.18-rc.11 → 0.1.18-rc.13

package/README.md

@@ -12,7 +12,7 @@ Client-side context factory extending `BasicContext` with API client and service
 ## Installation
 
 ```bash
-bun add @owlmeans/client-context
+bun add @owlmeans/client-context@^0.1.18-rc.12
 ```
 
 ## Usage
@@ -57,7 +57,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.12
 ```
 
 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/client-context",
-  "version": "0.1.18-rc.11",
-  "generatedAt": "2026-09-01T16:28:56.995Z",
+  "version": "0.1.18-rc.13",
+  "generatedAt": "2026-09-04T22:43:25.450Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

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

@@ -1,6 +1,6 @@
 ---
 name: client-context
-description: How to use @owlmeans/client-context — client-side context factory used as the base for web and native contexts. Auto-invoked when importing client context primitives.
+description: How to use @owlmeans/client-context — makeClientContext(), the ClientConfig shape, config() and serviceRoute(alias, makeDefault?) — the platform-agnostic client context every web and native context is built from. Auto-invoked when building a client context, declaring a client config, or resolving a service route on the client.
 user-invocable: false
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
@@ -8,28 +8,60 @@ user-invocable: false
 # @owlmeans/client-context
 
 **Layer:** Client
-**Install:** `"@owlmeans/client-context": "^0.1.18-rc.11"` in `dependencies`
+**Install:** `"@owlmeans/client-context": "^0.1.18-rc.13"` in `dependencies`
 
 ## Key Exports
 
 | Export | Description |
 |--------|-------------|
-| `makeClientContext` | Client-side context factory (cross-platform) |
-| `ClientContext<C>` | Client Context interface — adds `serviceRoute(alias)` |
-| `ClientConfig`, `config()` | Client config shape and its factory |
-| `PLUGINS` | Alias of the plugins config resource |
+| `makeClientContext(cfg)` | The base client context factory — a basic context plus `serviceRoute` and a registered API client |
+| `ClientContext<C>` | The context interface — `BasicContext` + `ConfigResourceAppend` + `serviceRoute(alias, makeDefault?)` |
+| `ClientConfig` | `BasicClientConfig` + `services` (the service-route table) + optional `i18n` |
+| `config(service, cfg?)` | Build a `ClientConfig` for `service` with `AppType.Frontend` already set |
+| `PLUGINS` (`plugins`) | Alias of the second config resource, the one plugin records live in |
 
 ## Usage
 
-Most apps don't call this directly — `@owlmeans/web-panel` and native equivalents wrap it. A wrapper
-calls it once, applies its own idempotent `append*(context)` mixins, and returns that same context:
-one context per process, built by one factory.
+Most apps never call this directly — `@owlmeans/client` wraps it (adding state, modal, debug and
+the router accessor), and `@owlmeans/web-client`, `@owlmeans/web-panel` and their native
+counterparts wrap that. A wrapper calls the layer below once, applies its own idempotent
+`append*(context)` mixins, and returns the same context: one context per process, built by one
+factory.
 
 ```typescript
-import { makeClientContext } from '@owlmeans/client-context'
+import { makeClientContext, config } from '@owlmeans/client-context'
+
+const cfg = config<Config>(MY_APP, { services: { ... } })
 const context = makeClientContext<Config, Context>(cfg)
 ```
 
+`makeClientContext` appends the API client (`appendApiClient`) itself, so an entrypoint can make a
+call as soon as the context is configured — nothing else has to register a carrier. Which carrier a
+given call uses is `cfg.webService`, from `@owlmeans/client-config`.
+
+## Service routes
+
+```typescript
+const route = context.serviceRoute(MANAGER, true)   // and mark it the default one
+```
+
+`serviceRoute` reads `cfg.services[alias]` and, with a boolean second argument, sets that route's
+`default` flag — which is how an app says "unqualified addresses belong to this service". It
+returns the live route object, so the flag is set on the config the rest of the context reads.
+
+An unknown alias throws a `SyntaxError` that **names every registered service**. Expect to see it
+during import, with a blank page and a stack pointing into the framework; the usual cause is a
+route alias passed where a service alias belongs, since both are plain strings and nothing earlier
+objects.
+
 ## Depends On
 
-- `@owlmeans/context`, `@owlmeans/client-config`, `@owlmeans/client-entrypoint`, `@owlmeans/client-route`
+- `@owlmeans/context` — `makeBasicContext`, `AppType`, `makeBasicConfig`
+- `@owlmeans/client-config` — `BasicClientConfig`
+- `@owlmeans/api` — the API client appended into every client context
+- `@owlmeans/route` (`CommonServiceRoute`), `@owlmeans/i18n`, `@owlmeans/config`
+
+## Related
+
+- [[client]] — the React layer, whose own `makeClientContext` builds on this one
+- [[client-config]] — `webService` and the rest of the base client config

package/build/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,eAAO,MAAM,MAAM,GAAI,CAAC,SAAS,YAAY,EAAE,SAAS,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAG,CAIlF,CAAA"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,eAAO,MAAM,MAAM,GAAI,CAAC,SAAS,YAAY,WAAW,MAAM,QAAQ,OAAO,CAAC,CAAC,CAAC,KAAG,CAIlF,CAAA"}

package/build/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAG7D,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,YAAY,EAAE,CAAC,SAAS,aAAa,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,KAAG,CAmC9F,CAAA"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAG7D,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,YAAY,EAAE,CAAC,SAAS,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,KAAG,CAmC9F,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/client-context",
-  "version": "0.1.18-rc.11",
+  "version": "0.1.18-rc.13",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -28,12 +28,12 @@
     }
   },
   "dependencies": {
-    "@owlmeans/api": "^0.1.18-rc.11",
-    "@owlmeans/client-config": "^0.1.18-rc.10",
-    "@owlmeans/config": "^0.1.18-rc.10",
-    "@owlmeans/context": "^0.1.18-rc.7",
-    "@owlmeans/i18n": "^0.1.18-rc.7",
-    "@owlmeans/route": "^0.1.18-rc.7"
+    "@owlmeans/api": "^0.1.18-rc.13",
+    "@owlmeans/client-config": "^0.1.18-rc.12",
+    "@owlmeans/config": "^0.1.18-rc.12",
+    "@owlmeans/context": "^0.1.18-rc.8",
+    "@owlmeans/i18n": "^0.1.18-rc.8",
+    "@owlmeans/route": "^0.1.18-rc.9"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",