@owlmeans/route 0.1.6 → 0.1.8

package/README.md

@@ -73,3 +73,20 @@ enum RouteProtocols { WEB = 'http', SOCKET = 'ws' }
 
 - [`@owlmeans/module`](../module) — `module()` takes a `CommonRouteModel` as first argument
 - [`@owlmeans/server-app`](../server-app) — re-exports `route` as `broute` (backend) alongside `route`
+
+<!-- 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/route.instructions.md

@@ -0,0 +1,41 @@
+---
+description: "How to use @owlmeans/route — route() helper for declaring URL paths, frontend() marker for React routes, RouteMethod enum. Use when defining a module's URL path."
+applyTo: "**/*.ts, **/*.tsx"
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# @owlmeans/route
+
+**Layer:** Core
+**Install:** `"@owlmeans/route": "^0.1.8"` in `dependencies`
+
+## Key Exports
+
+| Export | Description |
+|--------|-------------|
+| `route(alias, path, options?)` | Define a route — path relative to `parent` |
+| `frontend(options?)` | Mark a route as a React page |
+| `RouteMethod` | enum: GET, POST, PUT, DELETE, PATCH |
+| `Route` types | Resolved route shape |
+| Constants | Default route aliases |
+
+## Subpath Exports
+
+- `./utils` — path manipulation helpers
+
+## Usage
+
+```typescript
+import { route, frontend, RouteMethod } from '@owlmeans/route'
+
+route(manager.back.project.create, '/create', {
+  parent: manager.back.project.base,
+  method: RouteMethod.POST,
+})
+
+route(HOME, '/', frontend({ default: true, parent: BASE }))
+```
+
+## Depends On
+
+- `@owlmeans/error`, `@owlmeans/i18n`

package/agent-meta/manifest.json

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

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

@@ -0,0 +1,50 @@
+---
+name: route
+description: How to use @owlmeans/route — route() helper for declaring URL paths, frontend() marker for React routes, RouteMethod enum, and route model types. Auto-invoked when importing route helpers or defining a module's URL path.
+user-invocable: false
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# @owlmeans/route
+
+**Layer:** Core
+**Install:** `"@owlmeans/route": "^0.1.8"` in `dependencies`
+
+## Key Exports
+
+| Export | Description |
+|--------|-------------|
+| `route(alias, path, options?)` | Define a route — path is relative to `parent` |
+| `frontend(options?)` | Mark a route as a React page (web only) |
+| `RouteMethod` | enum of GET, POST, PUT, DELETE, PATCH |
+| `Route` types | Resolved route shape |
+| Constants | Default route aliases |
+
+## Subpath Exports
+
+- `./utils` — path manipulation helpers
+
+## Usage
+
+```typescript
+import { route, frontend, RouteMethod } from '@owlmeans/route'
+import { entrypoint } from '@owlmeans/entrypoint'
+
+// Server route
+entrypoint(
+  route(manager.back.project.create, '/create', {
+    parent: manager.back.project.base,
+    method: RouteMethod.POST,
+  })
+)
+
+// Web route — frontend() marks it as a React page
+entrypoint(
+  route(HOME, '/', frontend({ default: true, parent: BASE }))
+)
+```
+
+## Depends On
+
+- `@owlmeans/error` — route errors
+- `@owlmeans/i18n` — translatable errors

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/route",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -28,7 +28,7 @@
     }
   },
   "dependencies": {
-    "@owlmeans/context": "^0.1.6"
+    "@owlmeans/context": "^0.1.8"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",