seitu 0.16.0 → 0.16.1

package/package.json

@@ -2,7 +2,7 @@
   "name": "seitu",
   "displayName": "Seitu",
   "type": "module",
-  "version": "0.16.0",
+  "version": "0.16.1",
   "private": false,
   "author": "Valerii Strilets",
   "license": "MIT",
@@ -100,23 +100,23 @@
   "devDependencies": {
     "@solidjs/testing-library": "^0.8.10",
     "@standard-schema/spec": "^1.1.0",
-    "@tanstack/intent": "^0.0.42",
+    "@tanstack/intent": "^0.3.2",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.2",
     "@types/react": "^19.2.17",
-    "@vitejs/plugin-react": "^6.0.2",
+    "@vitejs/plugin-react": "^6.0.3",
     "fake-indexeddb": "^6.2.5",
-    "happy-dom": "^20.10.2",
+    "happy-dom": "^20.10.6",
     "react-dom": "^19.2.7",
     "solid-js": "^1.9.13",
-    "svelte": "^5.56.3",
-    "tsdown": "^0.22.2",
+    "svelte": "^5.56.4",
+    "tsdown": "^0.22.3",
     "type-fest": "^5.7.0",
     "typescript": "^6.0.3",
-    "vite": "^8.0.16",
+    "vite": "^8.1.2",
     "vite-plugin-solid": "^2.11.12",
-    "vitest": "^4.1.8",
-    "vue": "^3.5.38",
+    "vitest": "^4.1.9",
+    "vue": "^3.5.39",
     "yaml": "^2.9.0",
     "zod": "^4.4.3"
   },

package/skills/README.md

@@ -19,7 +19,7 @@ List or load a specific skill:
 
 ```bash
 pnpm dlx @tanstack/intent@latest list
-pnpm dlx @tanstack/intent@latest load seitu#create-store
+pnpm dlx @tanstack/intent@latest load seitu#seitu
 ```
 
 When you `pnpm update seitu`, skills update with the package — knowledge travels through npm, not model training cutoffs.
@@ -28,68 +28,45 @@ Start with **`seitu-overview`** — module map, mental model, and decision tree.
 
 ## Manual install (Cursor)
 
-Copy skill folders into `.cursor/skills/`:
+Copy skill folders into `.agents/skills/`:
 
 ```bash
-cp -r node_modules/seitu/skills/seitu-overview .cursor/skills/
-cp -r node_modules/seitu/skills/create-store .cursor/skills/
+cp -r node_modules/seitu/skills/seitu-overview .agents/skills/
+cp -r node_modules/seitu/skills/seitu .agents/skills/
 ```
 
 Restart Cursor or start a new agent chat so skills are picked up.
 
 ## Skills
 
-### Core (`seitu`)
-
-| Skill | Intent id | When to use |
-|-------|-----------|-------------|
-| [seitu-overview](./seitu-overview/SKILL.md) | `seitu#seitu-overview` | Read first — module map and primitive selection |
-| [create-store](./create-store/SKILL.md) | `seitu#create-store` | Simple in-memory reactive state |
-| [create-schema-store](./create-schema-store/SKILL.md) | `seitu#create-schema-store` | Schema-validated state (Zod, Valibot, ArkType) |
-| [create-computed](./create-computed/SKILL.md) | `seitu#create-computed` | Derived read-only values |
-| [create-debounced](./create-debounced/SKILL.md) | `seitu#create-debounced` | Debounce subscribable updates |
-| [create-throttled](./create-throttled/SKILL.md) | `seitu#create-throttled` | Throttle subscribable updates |
-| [create-debounced-fn](./create-debounced-fn/SKILL.md) | `seitu#create-debounced-fn` | Debounced function with reactive result |
-| [create-throttled-fn](./create-throttled-fn/SKILL.md) | `seitu#create-throttled-fn` | Throttled function with reactive result |
-| [create-subscription](./create-subscription/SKILL.md) | `seitu#create-subscription` | Low-level subscribe/notify |
-| [create-readable-subscription](./create-readable-subscription/SKILL.md) | `seitu#create-readable-subscription` | Compose standard Readable & Subscribable |
-
-### Web (`seitu/web`)
-
-| Skill | Intent id | When to use |
-|-------|-----------|-------------|
-| [create-web-storage-value](./create-web-storage-value/SKILL.md) | `seitu#create-web-storage-value` | Single-key localStorage / sessionStorage |
-| [create-web-storage](./create-web-storage/SKILL.md) | `seitu#create-web-storage` | Multi-key web storage |
-| [create-indexed-db-storage](./create-indexed-db-storage/SKILL.md) | `seitu#create-indexed-db-storage` | Large or async IndexedDB state |
-| [create-media-query](./create-media-query/SKILL.md) | `seitu#create-media-query` | Reactive CSS media queries |
-| [create-is-online](./create-is-online/SKILL.md) | `seitu#create-is-online` | Online / offline status |
-| [create-scroll-state](./create-scroll-state/SKILL.md) | `seitu#create-scroll-state` | Scroll position and edges |
-
-### React (`seitu/react`)
-
-| Skill | Intent id | When to use |
-|-------|-----------|-------------|
-| [use-subscription-react](./use-subscription-react/SKILL.md) | `seitu#use-subscription-react` | Hook for any Seitu primitive |
-| [subscription-react](./subscription-react/SKILL.md) | `seitu#subscription-react` | Render-prop component |
-
-### Vue (`seitu/vue`)
-
-| Skill | Intent id | When to use |
-|-------|-----------|-------------|
-| [use-subscription-vue](./use-subscription-vue/SKILL.md) | `seitu#use-subscription-vue` | Composable for any Seitu primitive |
-
-### Solid (`seitu/solid`)
-
-| Skill | Intent id | When to use |
-|-------|-----------|-------------|
-| [use-subscription-solid](./use-subscription-solid/SKILL.md) | `seitu#use-subscription-solid` | Primitive returning an accessor for any Seitu primitive |
-| [subscription-solid](./subscription-solid/SKILL.md) | `seitu#subscription-solid` | Render-prop component |
-
-### Svelte (`seitu/svelte`)
-
 | Skill | Intent id | When to use |
 |-------|-----------|-------------|
-| [use-subscription-svelte](./use-subscription-svelte/SKILL.md) | `seitu#use-subscription-svelte` | Binding returning a Svelte `Readable` store for any Seitu primitive |
+| [seitu-overview](./seitu-overview/SKILL.md) | `seitu#seitu-overview` | Read first — module map, mental model, decision tree |
+| [seitu](./seitu/SKILL.md) | `seitu#seitu` | Everything past the overview: per-primitive API and framework bindings, routed through reference files |
+
+### `seitu` reference files
+
+| Reference | Covers |
+|-----------|--------|
+| [create-store.md](./seitu/references/create-store.md) | Simple in-memory reactive state |
+| [create-schema-store.md](./seitu/references/create-schema-store.md) | Schema-validated state (Zod, Valibot, ArkType) |
+| [create-computed.md](./seitu/references/create-computed.md) | Derived read-only values |
+| [create-debounced.md](./seitu/references/create-debounced.md) | Debounce subscribable updates |
+| [create-throttled.md](./seitu/references/create-throttled.md) | Throttle subscribable updates |
+| [create-debounced-fn.md](./seitu/references/create-debounced-fn.md) | Debounced function with reactive result |
+| [create-throttled-fn.md](./seitu/references/create-throttled-fn.md) | Throttled function with reactive result |
+| [create-subscription.md](./seitu/references/create-subscription.md) | Low-level subscribe/notify |
+| [create-readable-subscription.md](./seitu/references/create-readable-subscription.md) | Compose standard Readable & Subscribable |
+| [create-web-storage-value.md](./seitu/references/create-web-storage-value.md) | Single-key localStorage / sessionStorage |
+| [create-web-storage.md](./seitu/references/create-web-storage.md) | Multi-key web storage |
+| [create-indexed-db-storage.md](./seitu/references/create-indexed-db-storage.md) | Large or async IndexedDB state |
+| [create-media-query.md](./seitu/references/create-media-query.md) | Reactive CSS media queries |
+| [create-is-online.md](./seitu/references/create-is-online.md) | Online / offline status |
+| [create-scroll-state.md](./seitu/references/create-scroll-state.md) | Scroll position and edges |
+| [react.md](./seitu/references/react.md) | `useSubscription` hook + `Subscription` component |
+| [vue.md](./seitu/references/vue.md) | `useSubscription` composable |
+| [solid.md](./seitu/references/solid.md) | `useSubscription` primitive + `Subscription` component |
+| [svelte.md](./seitu/references/svelte.md) | `useSubscription` binding |
 
 ## Registry and version history
 

package/skills/seitu/SKILL.md

@@ -0,0 +1,92 @@
+---
+name: seitu
+description: >-
+  Per-primitive API for Seitu: createStore, createComputed, createSchemaStore,
+  createSubscription/createReadableSubscription, createDebounced(Fn),
+  createThrottled(Fn), createWebStorage(Value), createIndexedDbStorage,
+  createMediaQuery, createIsOnline, createScrollState, and the React, Vue,
+  Solid, and Svelte useSubscription/Subscription bindings. Use once you know
+  which primitive or framework binding you need; read seitu-overview first
+  for the mental model and decision tree.
+metadata:
+  type: core
+  library: seitu
+  library_version: "0.16.1"
+requires:
+  - seitu-overview
+sources:
+  - letstri/seitu:docs/content/docs/core/store.mdx
+  - letstri/seitu:docs/content/docs/core/computed.mdx
+  - letstri/seitu:docs/content/docs/core/schema-store.mdx
+  - letstri/seitu:docs/content/docs/core/debounced.mdx
+  - letstri/seitu:docs/content/docs/core/debounced-fn.mdx
+  - letstri/seitu:docs/content/docs/core/throttled.mdx
+  - letstri/seitu:docs/content/docs/core/throttled-fn.mdx
+  - letstri/seitu:docs/content/docs/web/web-storage.mdx
+  - letstri/seitu:docs/content/docs/web/web-storage-value.mdx
+  - letstri/seitu:docs/content/docs/web/indexed-db-storage.mdx
+  - letstri/seitu:docs/content/docs/web/media-query.mdx
+  - letstri/seitu:docs/content/docs/web/is-online.mdx
+  - letstri/seitu:docs/content/docs/web/scroll-state.mdx
+  - letstri/seitu:docs/content/docs/react/hooks.mdx
+  - letstri/seitu:docs/content/docs/react/components.mdx
+  - letstri/seitu:docs/content/docs/vue/composables.mdx
+  - letstri/seitu:docs/content/docs/solid/hooks.mdx
+  - letstri/seitu:docs/content/docs/solid/components.mdx
+  - letstri/seitu:docs/content/docs/svelte/hooks.mdx
+  - letstri/seitu:seitu/src/core/subscription.ts
+---
+
+# Seitu — primitives and framework bindings
+
+Assumes the mental model from **seitu-overview** (`get`/`subscribe`/`set`, no
+dispatch layer, singleton at module scope). Load the reference file for the
+primitive or framework you need instead of reading everything.
+
+## In-memory state
+
+| Task | Reference |
+|------|-----------|
+| Minimal store — `get`/`set`/`subscribe` | [references/create-store.md](references/create-store.md) |
+| Schema-validated store with fallback | [references/create-schema-store.md](references/create-schema-store.md) |
+| Derived/computed value from one or many sources | [references/create-computed.md](references/create-computed.md) |
+| Low-level subscribe/notify for custom primitives | [references/create-subscription.md](references/create-subscription.md) |
+| Compose `get` + subscribe/notify into `Readable & Subscribable` | [references/create-readable-subscription.md](references/create-readable-subscription.md) |
+
+## Rate limiting
+
+| Task | Reference |
+|------|-----------|
+| Debounce a subscribable source | [references/create-debounced.md](references/create-debounced.md) |
+| Debounce a plain function | [references/create-debounced-fn.md](references/create-debounced-fn.md) |
+| Throttle a subscribable source | [references/create-throttled.md](references/create-throttled.md) |
+| Throttle a plain function | [references/create-throttled-fn.md](references/create-throttled-fn.md) |
+
+## Browser persistence and DOM state
+
+| Task | Reference |
+|------|-----------|
+| Multi-key localStorage/sessionStorage | [references/create-web-storage.md](references/create-web-storage.md) |
+| Single-key localStorage/sessionStorage | [references/create-web-storage-value.md](references/create-web-storage-value.md) |
+| Async IndexedDB persistence | [references/create-indexed-db-storage.md](references/create-indexed-db-storage.md) |
+| CSS media query | [references/create-media-query.md](references/create-media-query.md) |
+| `navigator.onLine` status | [references/create-is-online.md](references/create-is-online.md) |
+| Scroll position / edges of an element | [references/create-scroll-state.md](references/create-scroll-state.md) |
+
+## Framework bindings
+
+One hook/composable works with **any** Seitu primitive.
+
+| Framework | Reference |
+|-----------|-----------|
+| React — `useSubscription` hook, `Subscription` component | [references/react.md](references/react.md) |
+| Vue — `useSubscription` composable | [references/vue.md](references/vue.md) |
+| Solid — `useSubscription` primitive, `Subscription` component | [references/solid.md](references/solid.md) |
+| Svelte — `useSubscription` binding | [references/svelte.md](references/svelte.md) |
+
+## Rules that apply everywhere
+
+- **Create primitives at module scope, not inside components/render.** A new instance per render loses shared state and re-subscribes every time.
+- **Reference equality gates notification.** `set()` skips notifying subscribers when the new value is `===` the old one — always return a new object/array from updaters.
+- **Framework bindings are optional peer deps and are not interchangeable.** Importing `seitu/react` hooks/components in Vue, Solid, or Svelte code (or vice versa) breaks — use the binding matching the framework you're in.
+- **Web/DOM primitives are SSR-safe by default** (return defaults when `window`/`navigator` is undefined) — safe to create at module level in SSR frameworks. `createMediaQuery` needs `defaultMatches` set explicitly for a correct SSR value.

package/skills/{create-computed/SKILL.md → seitu/references/create-computed.md}

@@ -1,17 +1,3 @@
----
-name: create-computed
-description: >-
-  Derived read-only subscription from one or many sources.
-type: core
-library: seitu
-library_version: "0.16.0"
-requires:
-  - seitu-overview
-sources:
-  - letstri/seitu:docs/content/docs/core/computed.mdx
-  - letstri/seitu:seitu/src/core/computed.ts
----
-
 # createComputed
 
 Derived read-only subscription from one or many sources. Lazy — only subscribes to sources when it has its own subscribers.
@@ -51,6 +37,7 @@ interface Computed<T> extends Readable<T>, Subscribable<T> {}
 ```
 
 Read-only. No `set()`.
+
 ## Common Mistakes
 
 ### [HIGH] Recomputing manually in components
@@ -105,4 +92,4 @@ Computed is read-only; use the source store's set().
 
 ## Source
 
-`src/core/computed.ts`
+`src/core/computed.ts`

package/skills/{create-debounced-fn/SKILL.md → seitu/references/create-debounced-fn.md}

@@ -1,17 +1,3 @@
----
-name: create-debounced-fn
-description: >-
-  Debounced callable with reactive return value.
-type: core
-library: seitu
-library_version: "0.16.0"
-requires:
-  - seitu-overview
-sources:
-  - letstri/seitu:docs/content/docs/core/debounced-fn.mdx
-  - letstri/seitu:seitu/src/core/debounced-fn.ts
----
-
 # createDebouncedFn
 
 Wraps a plain function. The return value becomes subscribable state. Each call resets the debounce timer.
@@ -40,6 +26,7 @@ interface DebouncedFn<F> extends Readable<ReturnType<F> | undefined>, Subscribab
 ```
 
 Callable + readable + subscribable. `get()` returns `undefined` until first execution.
+
 ## Common Mistakes
 
 ### [HIGH] Using createDebounced on a function
@@ -92,4 +79,4 @@ DebouncedFn is Subscribable; subscribe or useSubscription to read latest result.
 
 ## Source
 
-`src/core/debounced-fn.ts`
+`src/core/debounced-fn.ts`

package/skills/{create-debounced/SKILL.md → seitu/references/create-debounced.md}

@@ -1,17 +1,3 @@
----
-name: create-debounced
-description: >-
-  Debounce updates from a source subscribable.
-type: core
-library: seitu
-library_version: "0.16.0"
-requires:
-  - seitu-overview
-sources:
-  - letstri/seitu:docs/content/docs/core/debounced.mdx
-  - letstri/seitu:seitu/src/core/debounced.ts
----
-
 # createDebounced
 
 Wraps a source subscribable with debounce. Emits the latest value after `wait` ms of inactivity.
@@ -38,6 +24,7 @@ interface Debounced<T> extends Readable<T>, Subscribable<T> {}
 ```
 
 Read-only. Lazy subscription — only subscribes to source when it has its own subscribers.
+
 ## Common Mistakes
 
 ### [HIGH] Debouncing the source instead of wrapping it
@@ -91,4 +78,4 @@ Invalid wait breaks timing expectations.
 
 ## Source
 
-`src/core/debounced.ts`
+`src/core/debounced.ts`

package/skills/{create-indexed-db-storage/SKILL.md → seitu/references/create-indexed-db-storage.md}

@@ -1,17 +1,3 @@
----
-name: create-indexed-db-storage
-description: >-
-  Async IndexedDB persistence with cached sync reads.
-type: core
-library: seitu
-library_version: "0.16.0"
-requires:
-  - seitu-overview
-sources:
-  - letstri/seitu:docs/content/docs/web/indexed-db-storage.mdx
-  - letstri/seitu:seitu/src/web/indexed-db-storage.ts
----
-
 # createIndexedDbStorage
 
 Multi-key reactive handle for IndexedDB. Async under the hood, sync `get()` via in-memory cache.
@@ -64,6 +50,7 @@ interface IndexedDbStorage<O> extends Subscribable<O>, Readable<O>, Writable<Par
   clear: () => Promise<void>
 }
 ```
+
 ## Common Mistakes
 
 ### [HIGH] Treating set as synchronous
@@ -118,4 +105,4 @@ Same as WebStorage — keys must be declared in schemas/defaultValues.
 
 ## Source
 
-`src/web/indexed-db-storage.ts`
+`src/web/indexed-db-storage.ts`

package/skills/{create-is-online/SKILL.md → seitu/references/create-is-online.md}

@@ -1,17 +1,3 @@
----
-name: create-is-online
-description: >-
-  Reactive navigator.onLine status.
-type: core
-library: seitu
-library_version: "0.16.0"
-requires:
-  - seitu-overview
-sources:
-  - letstri/seitu:docs/content/docs/web/is-online.mdx
-  - letstri/seitu:seitu/src/web/is-online.ts
----
-
 # createIsOnline
 
 Reactive boolean for `navigator.onLine`. Listens to `online`/`offline` window events.
@@ -31,6 +17,7 @@ interface IsOnline extends Subscribable<boolean>, Readable<boolean> {}
 ```
 
 No options. Returns `true` during SSR (when `navigator` is undefined). Lazy — only listens to events while subscribed.
+
 ## Common Mistakes
 
 ### [MEDIUM] Polling navigator.onLine manually
@@ -84,4 +71,4 @@ Returns false when offline API unavailable; safe at module scope.
 
 ## Source
 
-`src/web/is-online.ts`
+`src/web/is-online.ts`

package/skills/{create-media-query/SKILL.md → seitu/references/create-media-query.md}

@@ -1,17 +1,3 @@
----
-name: create-media-query
-description: >-
-  Reactive CSS media query with SSR defaultMatches.
-type: core
-library: seitu
-library_version: "0.16.0"
-requires:
-  - seitu-overview
-sources:
-  - letstri/seitu:docs/content/docs/web/media-query.mdx
-  - letstri/seitu:seitu/src/web/media-query.ts
----
-
 # createMediaQuery
 
 Reactive boolean for CSS media queries. Provides type-safe query string with autocomplete for known media features.
@@ -44,6 +30,7 @@ Read-only. Lazy — listens to `change` events only while subscribed.
 ## Type-safe queries
 
 The `query` option provides autocomplete for standard media features: `min-width`, `max-width`, `prefers-color-scheme`, `orientation`, `hover`, `pointer`, etc. Supports `and`/`,` combinators.
+
 ## Common Mistakes
 
 ### [CRITICAL] Missing defaultMatches for SSR
@@ -98,4 +85,4 @@ New matchMedia listener per render; use module-level singleton.
 
 ## Source
 
-`src/web/media-query.ts`
+`src/web/media-query.ts`

package/skills/{create-readable-subscription/SKILL.md → seitu/references/create-readable-subscription.md}

@@ -1,17 +1,3 @@
----
-name: create-readable-subscription
-description: >-
-  Compose get + subscribe + notify into standard Readable & Subscribable.
-type: core
-library: seitu
-library_version: "0.16.0"
-requires:
-  - seitu-overview
-  - create-subscription
-sources:
-  - letstri/seitu:seitu/src/core/subscription.ts
----
-
 # createReadableSubscription
 
 Composes a `get` function with a `subscribe`/`notify` pair into a `Readable<T> & Subscribable<T>` object. Used internally by all Seitu primitives.
@@ -45,6 +31,7 @@ An object with:
 - `subscribe(cb, opts?)` — subscribes; callback receives `get()` result
 - `~.notify` — internal notify reference
 - `~.output` — type-level output marker
+
 ## Common Mistakes
 
 ### [HIGH] Mismatched get and notify timing
@@ -97,4 +84,4 @@ Readable subscription has no set — use createStore or compose Writable separat
 
 ## Source
 
-`src/core/subscription.ts`
+`src/core/subscription.ts`

package/skills/{create-schema-store/SKILL.md → seitu/references/create-schema-store.md}

@@ -1,17 +1,3 @@
----
-name: create-schema-store
-description: >-
-  Standard Schema validated store with default fallback on invalid data.
-type: core
-library: seitu
-library_version: "0.16.0"
-requires:
-  - seitu-overview
-sources:
-  - letstri/seitu:docs/content/docs/core/schema-store.mdx
-  - letstri/seitu:seitu/src/core/schema-store.ts
----
-
 # createSchemaStore
 
 Store validated by a Standard Schema. Falls back to `defaultValue` when validation fails.
@@ -43,6 +29,7 @@ store.subscribe(console.log)
 ```ts
 interface SchemaStore<O> extends Subscribable<O>, Readable<O>, Writable<O, O> {}
 ```
+
 ## Common Mistakes
 
 ### [HIGH] Partial set without merge
@@ -95,4 +82,4 @@ Without a handler, invalid data silently falls back to defaultValue.
 
 ## Source
 
-`src/core/schema-store.ts`
+`src/core/schema-store.ts`

package/skills/{create-scroll-state/SKILL.md → seitu/references/create-scroll-state.md}

@@ -1,17 +1,3 @@
----
-name: create-scroll-state
-description: >-
-  Scroll position, edges, and remaining distance for an element.
-type: core
-library: seitu
-library_version: "0.16.0"
-requires:
-  - seitu-overview
-sources:
-  - letstri/seitu:docs/content/docs/web/scroll-state.mdx
-  - letstri/seitu:seitu/src/web/scroll-state.ts
----
-
 # createScrollState
 
 Reactive scroll position tracking for an element. Reports per-edge `reached` and `remaining` values.
@@ -64,6 +50,7 @@ const state = useSubscription(() =>
   createScrollState({ element: () => ref.current, direction: 'vertical' })
 )
 ```
+
 ## Common Mistakes
 
 ### [CRITICAL] Passing static element ref
@@ -116,4 +103,4 @@ Factory pattern in useSubscription recreates when element changes.
 
 ## Source
 
-`src/web/scroll-state.ts`
+`src/web/scroll-state.ts`

package/skills/{create-store/SKILL.md → seitu/references/create-store.md}

@@ -1,17 +1,3 @@
----
-name: create-store
-description: >-
-  Minimal in-memory reactive store with get, set, and subscribe.
-type: core
-library: seitu
-library_version: "0.16.0"
-requires:
-  - seitu-overview
-sources:
-  - letstri/seitu:docs/content/docs/core/store.mdx
-  - letstri/seitu:seitu/src/core/store.ts
----
-
 # createStore
 
 Minimal reactive store from `seitu` (core). Accepts any value type.
@@ -49,6 +35,7 @@ interface Store<T> extends Readable<T>, Writable<T, T>, Subscribable<T> {}
 | `subscribe(cb, opts?)` | Subscribes to changes; returns unsubscribe fn |
 
 `subscribe` accepts `{ immediate?: boolean }` to fire callback immediately with current value.
+
 ## Common Mistakes
 
 ### [CRITICAL] Mutating object state in place
@@ -106,4 +93,4 @@ Reference equality is the notification gate; stringify adds cost without fixing
 
 ## Source
 
-`src/core/store.ts`
+`src/core/store.ts`

package/skills/{create-subscription/SKILL.md → seitu/references/create-subscription.md}

@@ -1,16 +1,3 @@
----
-name: create-subscription
-description: >-
-  Low-level subscribe/notify for custom primitives.
-type: core
-library: seitu
-library_version: "0.16.0"
-requires:
-  - seitu-overview
-sources:
-  - letstri/seitu:seitu/src/core/subscription.ts
----
-
 # createSubscription
 
 Low-level building block. Returns `subscribe` + `notify` pair. Used internally by all Seitu primitives.
@@ -47,6 +34,7 @@ function createSubscription(options?: {
 - Return value of `onFirstSubscribe` is called when last subscriber is removed (cleanup).
 - `subscribe` supports `{ immediate: true }` to fire callback immediately.
 - Lazy: no setup until first subscriber.
+
 ## Common Mistakes
 
 ### [HIGH] Not returning unsubscribe from subscribe
@@ -99,4 +87,4 @@ createReadableSubscription composes get + subscribe + notify correctly.
 
 ## Source
 
-`src/core/subscription.ts`
+`src/core/subscription.ts`

package/skills/{create-throttled-fn/SKILL.md → seitu/references/create-throttled-fn.md}

@@ -1,17 +1,3 @@
----
-name: create-throttled-fn
-description: >-
-  Throttled callable with reactive return value.
-type: core
-library: seitu
-library_version: "0.16.0"
-requires:
-  - seitu-overview
-sources:
-  - letstri/seitu:docs/content/docs/core/throttled-fn.mdx
-  - letstri/seitu:seitu/src/core/throttled-fn.ts
----
-
 # createThrottledFn
 
 Wraps a plain function. First call fires immediately, subsequent calls within `wait` are batched — only the last fires when interval elapses.
@@ -41,6 +27,7 @@ interface ThrottledFn<F> extends Readable<ReturnType<F> | undefined>, Subscribab
 ```
 
 Callable + readable + subscribable. `get()` returns `undefined` until first execution.
+
 ## Common Mistakes
 
 ### [HIGH] Using createThrottled on a function
@@ -93,4 +80,4 @@ Throttled fn closure captures variables; update via args not closure mutation.
 
 ## Source
 
-`src/core/throttled-fn.ts`
+`src/core/throttled-fn.ts`

package/skills/{create-throttled/SKILL.md → seitu/references/create-throttled.md}

@@ -1,17 +1,3 @@
----
-name: create-throttled
-description: >-
-  Throttle updates from a source subscribable.
-type: core
-library: seitu
-library_version: "0.16.0"
-requires:
-  - seitu-overview
-sources:
-  - letstri/seitu:docs/content/docs/core/throttled.mdx
-  - letstri/seitu:seitu/src/core/throttled.ts
----
-
 # createThrottled
 
 Wraps a source subscribable with throttle. Emits at most once every `wait` ms. First update fires immediately, trailing update fires after interval.
@@ -38,6 +24,7 @@ interface Throttled<T> extends Readable<T>, Subscribable<T> {}
 ```
 
 Read-only. Lazy subscription.
+
 ## Common Mistakes
 
 ### [MEDIUM] Using debounce for scroll-like high-frequency events
@@ -90,4 +77,4 @@ Resets internal timer state.
 
 ## Source
 
-`src/core/throttled.ts`
+`src/core/throttled.ts`