@mhmo91/schmancy 0.10.11 → 0.10.13

package/README.md

@@ -41,17 +41,6 @@ import '@mhmo91/schmancy'
 import { magnetic, cursorGlow, gravity } from '@mhmo91/schmancy/directives'
 ```
 
-## Advanced components — `@mhmo91/schmancy-lab`
-
-Reusable-but-opinionated components live in a sibling package: QR scanner,
-charts, country/timezone selects, map embed. Install separately when you
-need them. Lab governance (acceptance criterion + quarterly graduation
-clock) lives in [`lab/README.md`](./lab/README.md).
-
-```bash
-npm install @mhmo91/schmancy @mhmo91/schmancy-lab
-```
-
 ## Use with Claude Code
 
 Schmancy ships a Claude Code plugin (manifest at `.claude-plugin/plugin.json`,
@@ -106,6 +95,17 @@ Schmancy is organized in four layers:
 
 [Lit](https://lit.dev) · [RxJS](https://rxjs.dev) · [Tailwind CSS v4](https://tailwindcss.com) · [Blackbird](./src/utils/animation.ts)
 
+## Advanced components — `@mhmo91/schmancy-lab`
+
+Reusable-but-opinionated components live in a sibling package: QR scanner,
+charts, country/timezone selects, map embed. Install separately when you
+need them. Lab governance (acceptance criterion + quarterly graduation
+clock) lives in [`lab/README.md`](./lab/README.md).
+
+```bash
+npm install @mhmo91/schmancy @mhmo91/schmancy-lab
+```
+
 ## License
 
 Apache-2.0

package/dist/agent/schmancy.manifest.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": "1.0.0",
-  "readme": "# Schmancy\n\nA Web Component UI library built on Lit, RxJS, and Tailwind CSS. Surfaces are glass. Depth is light. Interactions are physics.\n\n## Agent runtime\n\nFor sandboxed-iframe agents (Claude Design, Claude Artifacts, any LLM that can\nonly write HTML), schmancy ships a single-URL runtime at `@mhmo91/schmancy/agent`.\nDrop one `<script type=\"module\">` tag and every `<schmancy-*>` element is\nregistered. No bundler, no bare specifiers, no npm install.\n\n```html\n<script type=\"module\">\n  import 'https://esm.sh/@mhmo91/schmancy/agent';\n</script>\n<schmancy-theme root scheme=\"dark\">\n  <schmancy-surface type=\"solid\" fill=\"all\">\n    <schmancy-button>Hi</schmancy-button>\n  </schmancy-surface>\n</schmancy-theme>\n```\n\nThe same entry re-exports the full library surface for in-page script\ncode (`theme`, `area`, `state`, `show`, `lazy`, every directive, every\nservice, `SchmancyElement`). Import from the same URL.\n\nFor introspection — every tag's attributes, events, slots, CSS parts,\nplus the enum `values` array on every typed attribute (so agents don't\nhave to parse `\"'filled' | 'tonal' | ...\"` strings) — read the static\nmanifest at `@mhmo91/schmancy/agent/manifest`. It's a JSON file, shape\nfollows Custom Elements Manifest v1.\n\n## Install\n\n```bash\nnpm install @mhmo91/schmancy\n```\n\n```typescript\nimport '@mhmo91/schmancy'\nimport { magnetic, cursorGlow, gravity } from '@mhmo91/schmancy/directives'\n```\n\n## Advanced components — `@mhmo91/schmancy-lab`\n\nReusable-but-opinionated components live in a sibling package: QR scanner,\ncharts, country/timezone selects, map embed. Install separately when you\nneed them. Lab governance (acceptance criterion + quarterly graduation\nclock) lives in [`lab/README.md`](./lab/README.md).\n\n```bash\nnpm install @mhmo91/schmancy @mhmo91/schmancy-lab\n```\n\n## Use with Claude Code\n\nSchmancy ships a Claude Code plugin (manifest at `.claude-plugin/plugin.json`,\nskill source under `skills/schmancy/`). The npm tarball includes both, so\nafter `npm install @mhmo91/schmancy`, point Claude at the package directory\nwhen launching:\n\n```\nclaude --plugin-dir node_modules/@mhmo91/schmancy\n```\n\nSet a shell alias / `.envrc` so every session in the project picks it up.\nAfter editing plugin files, run `/reload-plugins` inside the session.\n\nClaude now knows every Schmancy component, foundation pattern, and\nconvention; the skill activates automatically when you work on schmancy\ncode — no CLAUDE.md edits, no symlinks.\n\n## Quick Start\n\n```html\n<schmancy-theme root scheme=\"dark\">\n  <schmancy-surface type=\"solid\" fill=\"all\">\n    <schmancy-area name=\"root\" .default=${lazy(() => import('./home.page'))}>\n      <schmancy-route when=\"home-page\" .component=${lazy(() => import('./home.page'))} />\n    </schmancy-area>\n  </schmancy-surface>\n</schmancy-theme>\n```\n\n## Design: Luminous Glass\n\n| Surface | Opacity | Blur | Purpose |\n|---------|---------|------|---------|\n| `solid` | 92% | — | Dense glass, high readability |\n| `subtle` | 78% | 8px | Frosted panel (default) |\n| `glass` | 55% | 16px | Overlays, dialogs, dropdowns |\n| `luminous` | 42% | 20px | Hero panels with glow halo |\n\n## Docs\n\nSchmancy is organized in four layers:\n\n- **Foundations** — [Area](./skills/schmancy/area.md) · [State](./skills/schmancy/state.md) · [Mixins (SchmancyElement)](./skills/schmancy/mixins.md) · [Theme](./skills/schmancy/theme.md) · [Directives](./skills/schmancy/directives.md)\n- **Atoms** — [Typography](./skills/schmancy/typography.md) · [Icons](./skills/schmancy/icons.md) · [Button](./skills/schmancy/button.md) · [Surface](./skills/schmancy/surface.md) · [Divider](./skills/schmancy/divider.md) · [Avatar](./skills/schmancy/avatar.md)\n- **Composites (by job)** — Forms, Navigation, Overlays, Interaction, Feedback, Display\n- **Utilities** — [Animation](./skills/schmancy/animation.md) · [Audio](./skills/schmancy/audio.md) · [Discovery](./skills/schmancy/discovery.md) · [RxJS Utils](./skills/schmancy/rxjs-utils.md) · [Utils](./skills/schmancy/utils.md)\n\n**Full component index:** [skills/schmancy/INDEX.md](./skills/schmancy/INDEX.md) — the single-file map with every tag, service, and convention. Written primarily for AI agents; humans welcome.\n\n## Tech Stack\n\n[Lit](https://lit.dev) · [RxJS](https://rxjs.dev) · [Tailwind CSS v4](https://tailwindcss.com) · [Blackbird](./src/utils/animation.ts)\n\n## License\n\nApache-2.0\n",
+  "readme": "# Schmancy\n\nA Web Component UI library built on Lit, RxJS, and Tailwind CSS. Surfaces are glass. Depth is light. Interactions are physics.\n\n## Agent runtime\n\nFor sandboxed-iframe agents (Claude Design, Claude Artifacts, any LLM that can\nonly write HTML), schmancy ships a single-URL runtime at `@mhmo91/schmancy/agent`.\nDrop one `<script type=\"module\">` tag and every `<schmancy-*>` element is\nregistered. No bundler, no bare specifiers, no npm install.\n\n```html\n<script type=\"module\">\n  import 'https://esm.sh/@mhmo91/schmancy/agent';\n</script>\n<schmancy-theme root scheme=\"dark\">\n  <schmancy-surface type=\"solid\" fill=\"all\">\n    <schmancy-button>Hi</schmancy-button>\n  </schmancy-surface>\n</schmancy-theme>\n```\n\nThe same entry re-exports the full library surface for in-page script\ncode (`theme`, `area`, `state`, `show`, `lazy`, every directive, every\nservice, `SchmancyElement`). Import from the same URL.\n\nFor introspection — every tag's attributes, events, slots, CSS parts,\nplus the enum `values` array on every typed attribute (so agents don't\nhave to parse `\"'filled' | 'tonal' | ...\"` strings) — read the static\nmanifest at `@mhmo91/schmancy/agent/manifest`. It's a JSON file, shape\nfollows Custom Elements Manifest v1.\n\n## Install\n\n```bash\nnpm install @mhmo91/schmancy\n```\n\n```typescript\nimport '@mhmo91/schmancy'\nimport { magnetic, cursorGlow, gravity } from '@mhmo91/schmancy/directives'\n```\n\n## Use with Claude Code\n\nSchmancy ships a Claude Code plugin (manifest at `.claude-plugin/plugin.json`,\nskill source under `skills/schmancy/`). The npm tarball includes both, so\nafter `npm install @mhmo91/schmancy`, point Claude at the package directory\nwhen launching:\n\n```\nclaude --plugin-dir node_modules/@mhmo91/schmancy\n```\n\nSet a shell alias / `.envrc` so every session in the project picks it up.\nAfter editing plugin files, run `/reload-plugins` inside the session.\n\nClaude now knows every Schmancy component, foundation pattern, and\nconvention; the skill activates automatically when you work on schmancy\ncode — no CLAUDE.md edits, no symlinks.\n\n## Quick Start\n\n```html\n<schmancy-theme root scheme=\"dark\">\n  <schmancy-surface type=\"solid\" fill=\"all\">\n    <schmancy-area name=\"root\" .default=${lazy(() => import('./home.page'))}>\n      <schmancy-route when=\"home-page\" .component=${lazy(() => import('./home.page'))} />\n    </schmancy-area>\n  </schmancy-surface>\n</schmancy-theme>\n```\n\n## Design: Luminous Glass\n\n| Surface | Opacity | Blur | Purpose |\n|---------|---------|------|---------|\n| `solid` | 92% | — | Dense glass, high readability |\n| `subtle` | 78% | 8px | Frosted panel (default) |\n| `glass` | 55% | 16px | Overlays, dialogs, dropdowns |\n| `luminous` | 42% | 20px | Hero panels with glow halo |\n\n## Docs\n\nSchmancy is organized in four layers:\n\n- **Foundations** — [Area](./skills/schmancy/area.md) · [State](./skills/schmancy/state.md) · [Mixins (SchmancyElement)](./skills/schmancy/mixins.md) · [Theme](./skills/schmancy/theme.md) · [Directives](./skills/schmancy/directives.md)\n- **Atoms** — [Typography](./skills/schmancy/typography.md) · [Icons](./skills/schmancy/icons.md) · [Button](./skills/schmancy/button.md) · [Surface](./skills/schmancy/surface.md) · [Divider](./skills/schmancy/divider.md) · [Avatar](./skills/schmancy/avatar.md)\n- **Composites (by job)** — Forms, Navigation, Overlays, Interaction, Feedback, Display\n- **Utilities** — [Animation](./skills/schmancy/animation.md) · [Audio](./skills/schmancy/audio.md) · [Discovery](./skills/schmancy/discovery.md) · [RxJS Utils](./skills/schmancy/rxjs-utils.md) · [Utils](./skills/schmancy/utils.md)\n\n**Full component index:** [skills/schmancy/INDEX.md](./skills/schmancy/INDEX.md) — the single-file map with every tag, service, and convention. Written primarily for AI agents; humans welcome.\n\n## Tech Stack\n\n[Lit](https://lit.dev) · [RxJS](https://rxjs.dev) · [Tailwind CSS v4](https://tailwindcss.com) · [Blackbird](./src/utils/animation.ts)\n\n## Advanced components — `@mhmo91/schmancy-lab`\n\nReusable-but-opinionated components live in a sibling package: QR scanner,\ncharts, country/timezone selects, map embed. Install separately when you\nneed them. Lab governance (acceptance criterion + quarterly graduation\nclock) lives in [`lab/README.md`](./lab/README.md).\n\n```bash\nnpm install @mhmo91/schmancy @mhmo91/schmancy-lab\n```\n\n## License\n\nApache-2.0\n",
   "modules": [
     {
       "kind": "javascript-module",

package/dist/handover/agent-runtime-followups.md

@@ -203,7 +203,7 @@ The manifest already has everything needed; the package is just the JSON-RPC wra
 
 **Problem.** `handover/agent-runtime-v1.md` had `<PENDING>` placeholders that we manually replaced with `0.9.13` after the first publish. Future handover docs will have the same issue.
 
-**Fix.** A build step that substitutes `0.10.11` in `handover/**/*.md` against `package.json`'s `version` field on every build. `dist/handover/**/*.md` gets the rendered version; the source stays templated.
+**Fix.** A build step that substitutes `0.10.13` in `handover/**/*.md` against `package.json`'s `version` field on every build. `dist/handover/**/*.md` gets the rendered version; the source stays templated.
 
 **Effort:** ~30 min (one sed step or a tiny script).
 

package/dist/handover/agent-runtime-v1.md

@@ -7,8 +7,8 @@
 ## The URLs you asked for
 
 ```
-https://esm.sh/@mhmo91/schmancy/agent@0.10.11
-https://esm.sh/@mhmo91/schmancy/agent/manifest@0.10.11
+https://esm.sh/@mhmo91/schmancy/agent@0.10.13
+https://esm.sh/@mhmo91/schmancy/agent/manifest@0.10.13
 ```
 
 `0.9.13` is the first release containing `/agent`; every subsequent publish serves the same subpath. `npm view @mhmo91/schmancy version` always returns the current pin if you want to float forward.
@@ -20,7 +20,7 @@ One script tag. No bundler, no bare specifiers, no npm install.
 ```html
 <!doctype html>
 <script type="module">
-  import { $dialog, theme } from 'https://esm.sh/@mhmo91/schmancy/agent@0.10.11';
+  import { $dialog, theme } from 'https://esm.sh/@mhmo91/schmancy/agent@0.10.13';
 </script>
 <schmancy-theme root scheme="dark">
   <schmancy-surface type="solid" fill="all">

package/dist/skills/schmancy/state.md

@@ -4,10 +4,6 @@ Reactive state primitive. Module-scoped singletons keyed by namespace.
 Every state exposes a TC39 signal, an RxJS Observable, a sync getter,
 and a hydration promise — pick the surface that fits the call site.
 
-This module replaced the v1 `createContext` / `@select` /
-`createCompoundSelector` system. There is no parallel API; use `state()`
-for everything.
-
 ## Quick reference
 
 ```ts
@@ -477,28 +473,6 @@ callbacks have no tree position to resolve to.
 States not listed in `provides` fall through to the global from inside
 the element — useful when only one or two namespaces need scoping.
 
-## Migration from v1 `createContext`
-
-```ts
-// v1
-const cart = createContext<CartState>(initial, 'session', 'hannah_cart')
-class CartView extends LitElement {
-  @select(cart) accessor cart!: CartState
-}
-const total = createCompoundSelector([cart], [c => c.total], t => t)
-
-// v2
-const cart = state<CartState>('hannah/cart').session(initial)
-class CartView extends LitElement {
-  @observe(cart) cart!: CartState   // or: cart = bindState(this, cart)
-}
-const total = computed(() => cart.value.total)
-```
-
-Surface-equivalent: `.value`, `.set(partial)`, `.replace(next)`, `.$`,
-`.delete(key)` all map directly. Storage keys move from arbitrary
-strings (`'hannah_cart'`) to namespace strings (`'hannah/cart'`).
-
 ## Rules
 
 - **One state per namespace.** The factory throws on a duplicate

package/dist/skills/state.md

@@ -4,10 +4,6 @@ Reactive state primitive. Module-scoped singletons keyed by namespace.
 Every state exposes a TC39 signal, an RxJS Observable, a sync getter,
 and a hydration promise — pick the surface that fits the call site.
 
-This module replaced the v1 `createContext` / `@select` /
-`createCompoundSelector` system. There is no parallel API; use `state()`
-for everything.
-
 ## Quick reference
 
 ```ts
@@ -477,28 +473,6 @@ callbacks have no tree position to resolve to.
 States not listed in `provides` fall through to the global from inside
 the element — useful when only one or two namespaces need scoping.
 
-## Migration from v1 `createContext`
-
-```ts
-// v1
-const cart = createContext<CartState>(initial, 'session', 'hannah_cart')
-class CartView extends LitElement {
-  @select(cart) accessor cart!: CartState
-}
-const total = createCompoundSelector([cart], [c => c.total], t => t)
-
-// v2
-const cart = state<CartState>('hannah/cart').session(initial)
-class CartView extends LitElement {
-  @observe(cart) cart!: CartState   // or: cart = bindState(this, cart)
-}
-const total = computed(() => cart.value.total)
-```
-
-Surface-equivalent: `.value`, `.set(partial)`, `.replace(next)`, `.$`,
-`.delete(key)` all map directly. Storage keys move from arbitrary
-strings (`'hannah_cart'`) to namespace strings (`'hannah/cart'`).
-
 ## Rules
 
 - **One state per namespace.** The factory throws on a duplicate

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@mhmo91/schmancy",
-	"version": "0.10.11",
+	"version": "0.10.13",
 	"description": "UI library build with web components",
 	"main": "./dist/index.js",
 	"customElements": "custom-elements.json",

package/skills/schmancy/state.md

@@ -4,10 +4,6 @@ Reactive state primitive. Module-scoped singletons keyed by namespace.
 Every state exposes a TC39 signal, an RxJS Observable, a sync getter,
 and a hydration promise — pick the surface that fits the call site.
 
-This module replaced the v1 `createContext` / `@select` /
-`createCompoundSelector` system. There is no parallel API; use `state()`
-for everything.
-
 ## Quick reference
 
 ```ts
@@ -477,28 +473,6 @@ callbacks have no tree position to resolve to.
 States not listed in `provides` fall through to the global from inside
 the element — useful when only one or two namespaces need scoping.
 
-## Migration from v1 `createContext`
-
-```ts
-// v1
-const cart = createContext<CartState>(initial, 'session', 'hannah_cart')
-class CartView extends LitElement {
-  @select(cart) accessor cart!: CartState
-}
-const total = createCompoundSelector([cart], [c => c.total], t => t)
-
-// v2
-const cart = state<CartState>('hannah/cart').session(initial)
-class CartView extends LitElement {
-  @observe(cart) cart!: CartState   // or: cart = bindState(this, cart)
-}
-const total = computed(() => cart.value.total)
-```
-
-Surface-equivalent: `.value`, `.set(partial)`, `.replace(next)`, `.$`,
-`.delete(key)` all map directly. Storage keys move from arbitrary
-strings (`'hannah_cart'`) to namespace strings (`'hannah/cart'`).
-
 ## Rules
 
 - **One state per namespace.** The factory throws on a duplicate

package/src/CLAUDE.md

@@ -144,10 +144,7 @@ protected static shadowRootOptions = {
 Module-scoped reactive state lives on `state(...)` from
 `@mhmo91/schmancy/state` — see `skills/schmancy/state.md`. Inside a
 component instance, use `@state` (Lit) for private template-driving
-fields and `@property` for public attributes. There is no
-`createContext` / `@select` / `createCompoundSelector`; those v1 APIs
-were removed and replaced wholesale by `state()` / `@observe` /
-`computed`. The migration cheatsheet is `src/state/MIGRATION.md`.
+fields and `@property` for public attributes.
 
 ### Theme consumption
 
@@ -182,5 +179,4 @@ public reportValidity(): boolean {
 ## Pointers
 
 - **State module brief:** `src/state/CLAUDE.md` — invariants for code under `src/state/`.
-- **Migration off v1 contexts:** `src/state/MIGRATION.md`.
 - **Lab acceptance criterion:** `lab/README.md` — what does and doesn't belong in `@mhmo91/schmancy-lab`.

package/src/state/CLAUDE.md

@@ -165,5 +165,3 @@ before the first `await`, or chain explicitly with `.then(...)`.
   `packages/schmancy/_scratch/spikes/findings.md` (gitignored).
 - **Skill doc for downstream consumers:**
   `packages/schmancy/skills/schmancy/state.md`.
-- **Migration cheatsheet** for moving off the v1 `createContext`:
-  `packages/schmancy/src/state/MIGRATION.md`.

package/src/state/MIGRATION.md

@@ -1,258 +0,0 @@
-# Migrating from `createContext` to `state()`
-
-Cheatsheet for moving call sites off the v1 `createContext` /
-`@select` / `createCompoundSelector` / `selectItem` family to
-`@mhmo91/schmancy/state`.
-
-The v1 surface has been deleted from `@mhmo91/schmancy`. There is no
-parallel API; every consumer needs to switch.
-
-## Imports
-
-```ts
-// Before
-import { createContext, select, selectItem, createCompoundSelector } from '@mhmo91/schmancy'
-
-// After
-import { state, computed, observe, bindState, stateFromObservable } from '@mhmo91/schmancy/state'
-```
-
-## Defining a state
-
-| v1 | v2 |
-|---|---|
-| `createContext<T>(initial, 'memory', 'foo')` | `state<T>('feature/foo').memory(initial)` |
-| `createContext<T>(initial, 'session', 'foo')` | `state<T>('feature/foo').session(initial)` |
-| `createContext<T>(initial, 'local', 'foo')` | `state<T>('feature/foo').local(initial)` |
-| `createContext<T>(initial, 'indexeddb', 'foo')` | `state<T>('feature/foo').idb(initial)` |
-
-The string namespace replaces the v1 third-argument storage key. It
-must contain a `/` (compile-time enforced via the
-`${string}/${string}` template literal). Storage is keyed off the
-namespace string.
-
-If your file already declares the initial value in a typed const, drop
-the type arg:
-
-```ts
-const initial: CartState = { items: [], total: 0 }
-const cart = state('hannah/cart').session(initial)   // T inferred from `initial`
-```
-
-## Reading
-
-| v1 | v2 |
-|---|---|
-| `cart.value` | `cart.value` (unchanged) |
-| `cart.$.subscribe(...)` | `cart.$.subscribe(...)` (unchanged) |
-| `cart.ready` (boolean) | `cart.loaded` (boolean) + `await cart.ready` (Promise<void>) |
-
-`cart.ready` is now a Promise that resolves when initial load completes
-(success or fallback). `cart.loaded` is the boolean runtime flag. Use
-whichever fits the call site.
-
-## Writing
-
-| v1 | v2 |
-|---|---|
-| `cart.set({ total: 12 })` | `cart.set({ total: 12 })` (unchanged) |
-| `cart.set({ items: [] }, false)` | `cart.set({ items: [] }, false)` (unchanged) |
-| `cart.replace(next)` | `cart.replace(next)` (unchanged) |
-| `cart.delete('total')` | `cart.delete('total')` (unchanged) |
-| Manual `replace({ ...current, ...patch })` cascade | `cart.update(d => { … })` — immer recipe, single notification |
-
-For `Map<K, V>` shapes:
-
-| v1 | v2 |
-|---|---|
-| `docs.set('id', doc)` | `docs.set('id', doc)` (unchanged — MapAPI dispatch) |
-
-For `Set<U>`:
-
-| v1 | v2 |
-|---|---|
-| Manual `replace(new Set([...current, item]))` | `sel.add('item')` |
-| Manual replace-without-item | `sel.delete('item')` (returns boolean) |
-|  | `sel.toggle('item')` (new) |
-
-For arrays:
-
-| v1 | v2 |
-|---|---|
-| `array.push(...items)` | `array.push(...items)` (unchanged) |
-| Manual `replace(current.filter(...))` | `array.update(d => d.splice(...))` (immer) |
-
-For nullable references and primitives:
-
-| v1 | v2 |
-|---|---|
-| `editing.set({ id: 'x' })` then `editing.set(null)` | Same (ScalarAPI accepts the union directly) |
-
-## Subscribing in a component
-
-The v1 `@select` decorator is gone. Three options in v2, in order of
-preference:
-
-### (1) Default — direct read in render (zero ceremony)
-
-`$LitElement()` composes `SignalWatcher`, so signal reads in `render()`
-auto-track. Just import the state and use it inline:
-
-```ts
-@customElement('cart-view')
-class CartView extends $LitElement() {
-  render() { return html`Items: ${cart.value.items.length}` }
-}
-```
-
-No decorator, no field, no binding code. The imported `cart` singleton
-IS the binding.
-
-### (2) `@observe(source)` — when you need a class field
-
-```ts
-class CartView extends $LitElement() {
-  @observe(cart) cart!: CartState
-
-  onClick() {
-    console.log(this.cart)   // event handler needs `this.cart`
-  }
-
-  render() {
-    return html`Items: ${this.cart.items.length}`
-  }
-}
-```
-
-Reads return the latest value. Caller writes are dropped with a dev
-warning. Same decorator shape as `@property` — works under the existing
-tsconfig.
-
-### (3) `bindState(host, source)` — for hosts that aren't `$LitElement`
-
-```ts
-class CustomHost extends LitElement {
-  cart = bindState(this, cart)
-  render() { return html`Items: ${this.cart.value.items.length}` }
-}
-```
-
-## Compound selectors → `computed`
-
-```ts
-// Before
-const cartItemCount = createCompoundSelector(
-  [cartContext],
-  [cart => cart.items.length],
-  count => count,
-)
-
-// After
-import { computed } from '@mhmo91/schmancy/state'
-const cartItemCount = computed(() => cart.value.items.length)
-```
-
-Cross-state composition just works:
-
-```ts
-const orderTotal = computed(() => cart.value.subtotal + tip.value.amount)
-```
-
-Reading any `state.value` inside `computed(fn)` auto-tracks. No
-explicit dependency array.
-
-## Side effects → `effect`
-
-```ts
-import { effect } from '@mhmo91/schmancy/state'
-
-const stop = effect(() => {
-  document.title = `${cart.value.items.length} items`
-})
-
-// later, when no longer needed:
-stop[Symbol.dispose]()
-```
-
-Eager run + microtask-coalesced re-runs. Returns a `Disposable`.
-
-## Observable bridges
-
-```ts
-// Before
-const userPresence$ = new BehaviorSubject({ online: false, since: 0 })
-// (read with .value, subscribe with .$, no persistence story)
-
-// After
-import { stateFromObservable } from '@mhmo91/schmancy/state'
-
-const userPresence = stateFromObservable(
-  presence$,                    // Observable<PresenceState>
-  'app/presence',
-  { online: false, since: 0 },
-)
-// userPresence has .value, .$, all variant API methods, lifecycle.
-```
-
-## Lifecycle / disposal
-
-```ts
-// Module scope — same as v1
-export const cart = state('hannah/cart').session(initial)
-
-// Test scope — using
-it('cart updates total on add', () => {
-  using cart = state('test/cart').memory(initial)
-  cart.update(d => { d.items.push(item) })
-  expect(cart.value.total).toBe(item.price)
-})  // [Symbol.dispose] runs here, even on assertion failure
-
-// IDB-backed in tests — await using flushes pending writes
-it('persists across reloads', async () => {
-  await using cart = state('test/cart').idb(initial)
-  // ...
-})
-
-// Imperative cleanup (samwa back-compat alias)
-cart.destroy()
-```
-
-## Things that went away
-
-- **`createCompoundSelector`** — use `computed()`.
-- **`@select` and `@selectItem` decorators** — use direct render reads
-  via `$LitElement` (default), `@observe` (field-level), or `bindState`
-  (non-Lit hosts).
-- **`IStore` / `ICollectionStore` / `IArrayStore` interfaces** — no
-  longer needed. The variant write API dispatch is type-level.
-- **`error$` per-store Subject** — errors flow through console + the
-  `StateStorageError` thrown from `save()` for IDB write failures.
-- **Tree-scoped `<state-provider>`** — replaced by
-  `<schmancy-context provides={[…]}>`. Same intent (per-subtree
-  isolation of a state), different API: in v1 the provider was a
-  primitive; in v2 the state surface stays unchanged and the
-  `<schmancy-context>` element is what scopes a subtree. Consumer
-  code (`cart.value`, `cart.set(...)`) is identical inside and
-  outside the element. See `SCOPING.md` for the details.
-
-## Footguns
-
-- **Don't use `using` at module scope.** It disposes on module GC,
-  which is roughly never until the tab closes. Plain `const` for
-  module singletons, `using` for test/function scope only.
-- **Namespaces always contain `/`.** `state('cart')` is a TypeError;
-  use `state('feature/cart')`.
-- **Don't `state.signal.set(...)` directly.** Go through the variant
-  API so write-coalescing and persistence stay coherent.
-- **Inline literals without a typed const narrow T.**
-  `state('app/x').memory({ items: [], total: 0 })` infers
-  `{ items: never[]; total: number }`. Either use a typed const first
-  or pass the type arg: `state<CartState>('app/x').memory({...})`.
-
-## Pointers
-
-- Skill / API reference: `packages/schmancy/skills/schmancy/state.md`
-- Agent brief: `packages/schmancy/src/state/CLAUDE.md`
-- Tree-scoping reference: `packages/schmancy/src/state/SCOPING.md`
-- Original plan: `~/.claude/plans/indexed-twirling-stroustrup.md`
-- Scoping plan: `~/.claude/plans/federated-petting-penguin.md`