snice 5.1.0 → 5.2.0

package/dist/react/SniceProvider.js

@@ -1,5 +1,5 @@
 /*!
- * snice v5.0.0
+ * snice v5.1.0
  * A decorator-driven web component library with differential rendering, routing, controllers, and 130+ ready-made UI components. Use as much or as little as you want. Zero dependencies, works anywhere.
  * (c) 2024
  * Released under the MIT License.

package/dist/react/SniceRouter.js

@@ -1,5 +1,5 @@
 /*!
- * snice v5.0.0
+ * snice v5.1.0
  * A decorator-driven web component library with differential rendering, routing, controllers, and 130+ ready-made UI components. Use as much or as little as you want. Zero dependencies, works anywhere.
  * (c) 2024
  * Released under the MIT License.

package/dist/react/index.js

@@ -1,5 +1,5 @@
 /*!
- * snice v5.0.0
+ * snice v5.1.0
  * A decorator-driven web component library with differential rendering, routing, controllers, and 130+ ready-made UI components. Use as much or as little as you want. Zero dependencies, works anywhere.
  * (c) 2024
  * Released under the MIT License.

package/dist/react/matchRoute.js

@@ -1,5 +1,5 @@
 /*!
- * snice v5.0.0
+ * snice v5.1.0
  * A decorator-driven web component library with differential rendering, routing, controllers, and 130+ ready-made UI components. Use as much or as little as you want. Zero dependencies, works anywhere.
  * (c) 2024
  * Released under the MIT License.

package/dist/react/useRequestHandler.js

@@ -1,5 +1,5 @@
 /*!
- * snice v5.0.0
+ * snice v5.1.0
  * A decorator-driven web component library with differential rendering, routing, controllers, and 130+ ready-made UI components. Use as much or as little as you want. Zero dependencies, works anywhere.
  * (c) 2024
  * Released under the MIT License.

package/dist/symbols.cjs

@@ -1,5 +1,5 @@
 /*!
- * snice v5.0.0
+ * snice v5.1.0
  * A decorator-driven web component library with differential rendering, routing, controllers, and 130+ ready-made UI components. Use as much or as little as you want. Zero dependencies, works anywhere.
  * (c) 2024
  * Released under the MIT License.

package/dist/symbols.esm.js

@@ -1,5 +1,5 @@
 /*!
- * snice v5.0.0
+ * snice v5.1.0
  * A decorator-driven web component library with differential rendering, routing, controllers, and 130+ ready-made UI components. Use as much or as little as you want. Zero dependencies, works anywhere.
  * (c) 2024
  * Released under the MIT License.

package/dist/transitions.cjs

@@ -1,5 +1,5 @@
 /*!
- * snice v5.0.0
+ * snice v5.1.0
  * A decorator-driven web component library with differential rendering, routing, controllers, and 130+ ready-made UI components. Use as much or as little as you want. Zero dependencies, works anywhere.
  * (c) 2024
  * Released under the MIT License.

package/dist/transitions.esm.js

@@ -1,5 +1,5 @@
 /*!
- * snice v5.0.0
+ * snice v5.1.0
  * A decorator-driven web component library with differential rendering, routing, controllers, and 130+ ready-made UI components. Use as much or as little as you want. Zero dependencies, works anywhere.
  * (c) 2024
  * Released under the MIT License.

package/docs/STORYBOOK.md

@@ -133,7 +133,7 @@ el.addEventListener('my-event', (e: Event) => {
 
 Snice components are plain standard custom elements. Do NOT:
 - Import from `lit`, `lit-html`, or `lit-element`
-- Import `html` from `'snice'` in stories (that is Snice's internal template engine)
+- Import `html` from `'snice'` in stories — Storybook stories are plain DOM
 - Extend `LitElement`
 
 Instead, use `document.createElement('snice-...')` and standard DOM APIs.

package/docs/ai/api.md

@@ -163,16 +163,15 @@ html`
 // ctx.update() - signal all @context() subscribers (no args, uses current state)
 
 @context(options?: { debounce?, throttle?, once? })
-// Works on methods AND fields. Both forms also fire SYNCHRONOUSLY at register
-// time, so the field/method sees current context BEFORE the first render
-// microtask flushes (no cold-start undefined).
-// Fires on: register (sync), route change, ctx.update()
+// Works on methods AND fields, on elements AND controllers.
+// Populated before the first render (no cold-start undefined).
+// Fires on: first attach, route change, ctx.update()
 //
 // Field form (read in render()):
 //   @context() ctx!: Context;
 //   @render() template() { return html`<h1>${this.ctx.application.user}</h1>`; }
 //
-// Method form (side-effects on push, debounce/throttle/once):
+// Method form (side-effects on each change, debounce/throttle/once):
 //   @context() handleContext(ctx: Context) {
 //     this.user = (ctx.application as MyApp).user;
 //   }

package/docs/ai/decorators.md

@@ -33,11 +33,11 @@
 ## Communication
 - `@request(channel, options?)` - Async generator request pattern
 - `@respond(channel, options?)` - Handle requests from `@request`
-- `@context(options?)` - Receive router navigation context updates. Works on **methods** (called with `(ctx: Context)` on every push) AND **fields** (overwritten with the live `Context` on every push). Both forms also fire **synchronously at register time** so the field/method sees current context BEFORE the first render microtask flushes — no cold-start `undefined`.
+- `@context(options?)` - Receive router context. Works on **methods** (called with `(ctx: Context)` on each change) AND **fields** (overwritten with the live `Context` on each change), on **elements and controllers**. Populated before the first render — never `undefined` in the initial template.
 
 ```ts
 @context() ctx!: Context;            // field: read this.ctx in render()
-@context() onCtx(ctx: Context) {}    // method: side-effects on push
+@context() onCtx(ctx: Context) {}    // method: react to each change
 ```
 
 ## Observers

package/docs/components/drawer.md

@@ -258,7 +258,7 @@ Use `breakpoint` to switch between inline (above breakpoint) and overlay (below
 </snice-drawer>
 ```
 
-Uses `window.matchMedia` internally. Above the breakpoint, the `inline` attribute is set automatically. Below, it reverts to overlay mode.
+Above the breakpoint, the `inline` attribute is set automatically. Below, it reverts to overlay mode.
 
 ### Filters Panel
 

package/docs/elements.md

@@ -997,7 +997,7 @@ class ReactiveComponent extends HTMLElement {
 
 ### @context() Decorator
 
-Receive router context updates. Works on **methods** (called with the live `Context` on every change) AND **fields** (overwritten with the live `Context` on every change). Both forms also fire **synchronously at register time**, so the field/method sees the current context BEFORE the first render microtask flushes — no cold-start `undefined` flicker.
+Receive router context updates. Works on **methods** (called with the live `Context` on every change) AND **fields** (overwritten with the live `Context` on every change). Both forms are populated before the first render — your template can read context-derived values on the very first paint, never `undefined`.
 
 **Field form** (preferred when you just want to read context inside `render()`):
 

package/docs/routing.md

@@ -119,7 +119,7 @@ class HomePage extends HTMLElement {
 
 ### Page with Context
 
-The `@context()` decorator works on **methods** (called with the live Context on each push) AND **fields** (overwritten with the live Context on each push). Both forms also fire **synchronously at register time**, so the field/method sees the current context BEFORE the first render microtask flushes — your initial render reads populated values, never `undefined`.
+The `@context()` decorator works on **methods** (called with the live Context on each change) AND **fields** (overwritten with the live Context on each change). Both forms are populated before the first render — your initial render reads context-derived values, never `undefined`.
 
 **Field form** (preferred when you just want to read context inside `render()`):
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snice",
-  "version": "5.1.0",
+  "version": "5.2.0",
   "type": "module",
   "description": "A decorator-driven web component library with differential rendering, routing, controllers, and 130+ ready-made UI components. Use as much or as little as you want. Zero dependencies, works anywhere.",
   "main": "dist/index.cjs",