@owlmeans/state 0.1.7 → 0.1.9

package/README.md

@@ -80,3 +80,20 @@ const DEFAULT_ID = '_default'  // conventional ID for single-item resources
 
 - [`@owlmeans/resource`](../resource) — `Resource<T>` interface implemented by StateResource
 - [`@owlmeans/client`](../client) — `useStoreModel` / `useStoreList` React hooks for state resources
+
+<!-- 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/state.instructions.md

@@ -0,0 +1,33 @@
+---
+description: "How to use @owlmeans/state — appendStateResource() to register a state resource on a context, then ctx.getStateResource(alias) to read/write typed application state."
+applyTo: "**/*.ts, **/*.tsx"
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# @owlmeans/state
+
+**Layer:** Core
+**Install:** `"@owlmeans/state": "^0.1.9"` in `dependencies`
+
+## Key Exports
+
+| Export | Description |
+|--------|-------------|
+| `appendStateResource<C, T>(context, alias)` | Register a state resource on the context |
+| `StateResource<T>` types | Typed state container interface |
+| Errors | Typed state errors |
+| Constants | Default state aliases |
+
+## Usage
+
+```typescript
+import { appendStateResource } from '@owlmeans/state'
+
+export const VIB_PROJECT_STATE = 'vib-project-state'
+appendStateResource<C, T>(context, VIB_PROJECT_STATE)
+context.projectStore = () => context.getStateResource(VIB_PROJECT_STATE)
+```
+
+## Depends On
+
+- `@owlmeans/resource`, `@owlmeans/context`, `@owlmeans/error`, `@owlmeans/i18n`

package/agent-meta/manifest.json

@@ -0,0 +1,23 @@
+{
+  "schemaVersion": 1,
+  "package": "@owlmeans/state",
+  "version": "0.1.9",
+  "generatedAt": "2026-06-14T13:34:06.130Z",
+  "canonicalRepo": "https://github.com/owlmeans/common",
+  "entries": [
+    {
+      "kind": "skill",
+      "name": "state",
+      "category": "package-specific",
+      "file": "skills/state/SKILL.md",
+      "canonicalPath": ".claude/skills/state/SKILL.md"
+    },
+    {
+      "kind": "instruction",
+      "name": "state",
+      "category": "package-specific",
+      "file": "instructions/state.instructions.md",
+      "canonicalPath": ".github/instructions/state.instructions.md"
+    }
+  ]
+}

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

@@ -0,0 +1,47 @@
+---
+name: state
+description: How to use @owlmeans/state — appendStateResource() to register a state resource on a context, then ctx.getStateResource(alias) to read/write typed application state. Auto-invoked when importing state primitives.
+user-invocable: false
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# @owlmeans/state
+
+**Layer:** Core
+**Install:** `"@owlmeans/state": "^0.1.9"` in `dependencies`
+
+## Key Exports
+
+| Export | Description |
+|--------|-------------|
+| `appendStateResource<C, T>(context, alias)` | Register a state resource on the context |
+| `StateResource<T>` types | Typed state container interface |
+| Errors | Typed state errors |
+| Constants | Default state aliases |
+
+## Usage
+
+Append a state resource at context construction time, expose a typed accessor:
+
+```typescript
+import { appendStateResource } from '@owlmeans/state'
+
+export const VIB_PROJECT_STATE = 'vib-project-state'
+
+export const makeContext = <C extends Config, T extends Context<C>>(cfg: C): T => {
+  const context = makeBasicContext<C, T>(cfg)
+  appendStateResource<C, T>(context, VIB_PROJECT_STATE)
+  context.projectStore = () => context.getStateResource(VIB_PROJECT_STATE)
+  return context
+}
+
+// Later, in a component or handler:
+const store = ctx.projectStore()
+const current = await store.get('current')
+```
+
+## Depends On
+
+- `@owlmeans/resource` — `StateResource` extends `Resource`
+- `@owlmeans/context` — for `getStateResource`
+- `@owlmeans/error`, `@owlmeans/i18n`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/state",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -21,8 +21,8 @@
     }
   },
   "dependencies": {
-    "@owlmeans/context": "^0.1.7",
-    "@owlmeans/resource": "^0.1.7"
+    "@owlmeans/context": "^0.1.9",
+    "@owlmeans/resource": "^0.1.9"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",