@owlmeans/web-client 0.1.6 → 0.1.8

package/README.md

@@ -76,3 +76,20 @@ Component that handles authentication routing (redirect to login, etc.).
 - [`@owlmeans/web-router`](../web-router) — React Router integration registered by `makeContext`
 - [`@owlmeans/web-db`](../web-db) — IndexedDB service registered by `makeContext`
 - [`@owlmeans/client-module`](../client-module) — `ClientModule<T>` / `Module<T>` implementation
+
+<!-- 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-client.instructions.md

@@ -0,0 +1,42 @@
+---
+description: "How to use @owlmeans/web-client — browser entry point with renderApp(), elevate() to attach React components to entrypoint declarations, context.registerEntrypoints() and context.serviceRoute() for routing."
+applyTo: "**/index.tsx, **/modules.ts, **/modules.tsx, **/*.ts, **/*.tsx"
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# @owlmeans/web-client
+
+**Layer:** Web (React)
+**Install:** `"@owlmeans/web-client": "^0.1.8"` in `dependencies`
+
+## Key Exports
+
+| Export | Description |
+|--------|-------------|
+| `renderApp<C, T>(context)` | Mount React app with React Router 7 |
+| `elevate(modules, alias, handler)` | Attach a React component to an entrypoint |
+| `handler(Component)` | Wrap a React component as an entrypoint handler |
+| `context.registerEntrypoints(modules)` | Register entrypoints on the context |
+| `context.serviceRoute(alias, isDefault?)` | Mark a service's routing root |
+| `router`, `components`, `service`, `i18n`, `helpers`, `errors` | Web helpers |
+| Constants | Default aliases |
+
+## Usage
+
+```typescript
+// index.tsx
+import { renderApp } from '@owlmeans/web-client'
+const context = makeContext(config)
+context.registerEntrypoints(appModules)
+context.serviceRoute(MANAGER, true)
+renderApp<Config, Context>(context)
+
+// modules.ts
+import { elevate, route, frontend, handler, entrypoint } from '@owlmeans/web-client'
+elevate(modules, manager.front.project.dashboard, handler(ProjectDashboardScreen))
+modules.push(entrypoint(route(HOME, '/', frontend({ default: true })), handler(HomeScreen)))
+```
+
+## Depends On
+
+- `@owlmeans/client`, `@owlmeans/web-router`, `@owlmeans/web-panel`, `@owlmeans/client-i18n`, `@owlmeans/entrypoint`, `@owlmeans/route`, `react`, `react-dom`, `react-router`

package/agent-meta/manifest.json

@@ -0,0 +1,23 @@
+{
+  "schemaVersion": 1,
+  "package": "@owlmeans/web-client",
+  "version": "0.1.8",
+  "generatedAt": "2026-06-11T16:30:27.169Z",
+  "canonicalRepo": "https://github.com/owlmeans/common",
+  "entries": [
+    {
+      "kind": "skill",
+      "name": "web-client",
+      "category": "package-specific",
+      "file": "skills/web-client/SKILL.md",
+      "canonicalPath": ".claude/skills/web-client/SKILL.md"
+    },
+    {
+      "kind": "instruction",
+      "name": "web-client",
+      "category": "package-specific",
+      "file": "instructions/web-client.instructions.md",
+      "canonicalPath": ".github/instructions/web-client.instructions.md"
+    }
+  ]
+}

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

@@ -0,0 +1,59 @@
+---
+name: web-client
+description: How to use @owlmeans/web-client — browser entry point with renderApp(), elevate() to attach React components to entrypoint declarations, context.registerEntrypoints() and context.serviceRoute() for routing. Auto-invoked when working with the web app entry point or attaching React components to entrypoints.
+user-invocable: false
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# @owlmeans/web-client
+
+**Layer:** Web (React)
+**Install:** `"@owlmeans/web-client": "^0.1.8"` in `dependencies`
+
+## Key Exports
+
+| Export | Description |
+|--------|-------------|
+| `renderApp<C, T>(context)` | Mount the React app with React Router 7 |
+| `elevate(modules, alias, handler)` | Attach a React component (or `handler(Component)`) to an entrypoint |
+| `handler(Component)` | Wrap a React component as an entrypoint handler |
+| `context.registerEntrypoints(modules)` | Register the full entrypoint list on the context |
+| `context.serviceRoute(alias, isDefault?)` | Mark a service's routing root |
+| `router`, `components`, `service`, `i18n`, `helpers`, `errors` | Web-specific helpers |
+| Constants | Default aliases (BASE, HOME) |
+
+## Usage
+
+### Entry point
+```typescript
+// index.tsx
+import { renderApp } from '@owlmeans/web-client'
+import { makeContext } from './context.js'
+import { appModules } from './modules.js'
+import { MANAGER, MANAGER_API } from 'my-common'
+import config from './config.js'
+
+const context = makeContext(config)
+context.registerEntrypoints(appModules)
+context.serviceRoute(MANAGER, true)
+context.serviceRoute(MANAGER_API, true)
+renderApp<Config, Context>(context)
+```
+
+### Module elevation with React components
+```typescript
+import { elevate, route, frontend, handler, entrypoint, guard } from '@owlmeans/web-client'
+import { HomeScreen, ProjectDashboardScreen } from './screens/index.js'
+
+elevate(modules, manager.front.project.dashboard, handler(ProjectDashboardScreen))
+
+modules.push(
+  entrypoint(route(HOME, '/', frontend({ default: true, parent: BASE })), handler(HomeScreen))
+)
+```
+
+## Depends On
+
+- `@owlmeans/client`, `@owlmeans/web-router`, `@owlmeans/web-panel` (typically), `@owlmeans/client-i18n`
+- `@owlmeans/entrypoint`, `@owlmeans/route`
+- `react`, `react-dom`, `react-router` (peer)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/web-client",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -21,22 +21,22 @@
     }
   },
   "dependencies": {
-    "@owlmeans/auth": "^0.1.6",
-    "@owlmeans/auth-common": "^0.1.6",
-    "@owlmeans/client": "^0.1.6",
-    "@owlmeans/client-auth": "^0.1.6",
-    "@owlmeans/client-context": "^0.1.6",
-    "@owlmeans/client-i18n": "^0.1.6",
-    "@owlmeans/client-entrypoint": "^0.1.6",
-    "@owlmeans/client-resource": "^0.1.6",
-    "@owlmeans/client-route": "^0.1.6",
-    "@owlmeans/config": "^0.1.6",
-    "@owlmeans/context": "^0.1.6",
-    "@owlmeans/error": "^0.1.6",
-    "@owlmeans/i18n": "^0.1.6",
-    "@owlmeans/route": "^0.1.6",
-    "@owlmeans/web-db": "^0.1.6",
-    "@owlmeans/web-router": "^0.1.6",
+    "@owlmeans/auth": "^0.1.8",
+    "@owlmeans/auth-common": "^0.1.8",
+    "@owlmeans/client": "^0.1.8",
+    "@owlmeans/client-auth": "^0.1.8",
+    "@owlmeans/client-context": "^0.1.8",
+    "@owlmeans/client-i18n": "^0.1.8",
+    "@owlmeans/client-entrypoint": "^0.1.8",
+    "@owlmeans/client-resource": "^0.1.8",
+    "@owlmeans/client-route": "^0.1.8",
+    "@owlmeans/config": "^0.1.8",
+    "@owlmeans/context": "^0.1.8",
+    "@owlmeans/error": "^0.1.8",
+    "@owlmeans/i18n": "^0.1.8",
+    "@owlmeans/route": "^0.1.8",
+    "@owlmeans/web-db": "^0.1.8",
+    "@owlmeans/web-router": "^0.1.8",
     "react-dropzone": "^14.3.5"
   },
   "peerDependencies": {