snice 5.2.3 → 6.0.0

package/dist/parts.d.ts

@@ -156,14 +156,7 @@ export interface KeyboardFilter {
     meta?: boolean;
     anyModifiers?: boolean;
 }
-/**
- * Parse keyboard shortcut specification
- * Examples:
- *   "enter" -> { key: "Enter" }
- *   "ctrl+s" -> { key: "s", ctrl: true }
- *   "ctrl+shift+s" -> { key: "s", ctrl: true, shift: true }
- *   "~enter" -> { key: "Enter", anyModifiers: true }
- */
+export declare function warnIfModifierMisuse(eventName: string): void;
 export declare function parseKeyboardFilter(spec: string): KeyboardFilter;
 /**
  * Check if keyboard event matches the filter

package/dist/react/SniceProvider.js

@@ -1,5 +1,5 @@
 /*!
- * snice v5.2.2
+ * snice v5.2.3
  * 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.2.2
+ * snice v5.2.3
  * 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.2.2
+ * snice v5.2.3
  * 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.d.ts

@@ -11,6 +11,6 @@ export interface MatchResult {
 /**
  * Match a URL path against an array of route configs.
  * Uses pica-route — same matching as vanilla Snice's Router.
- * Routes are sorted by specificity (longest spec first).
+ * Routes are sorted by per-segment specificity (static > dynamic > wildcard).
  */
 export declare function matchRoutes(routes: RouteConfig[], pathname: string): MatchResult | null;

package/dist/react/matchRoute.js

@@ -1,5 +1,5 @@
 /*!
- * snice v5.2.2
+ * snice v5.2.3
  * 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.
@@ -8,14 +8,48 @@
  */
 import { Route } from 'pica-route';
 
+/**
+ * Route specificity scorer for the React binding.
+ *
+ * IMPORTANT: keep this in exact sync with `src/route-specificity.ts`. The React
+ * integration is bundled in isolation (rootDir: src/react) and cannot import
+ * across that boundary, so the scorer is mirrored here. The `matchRoutes`
+ * resolution tests exercise this copy, so behavioral drift is caught.
+ *
+ * Scoring is per-segment by ROLE, not string length: a static segment outweighs
+ * a dynamic (`:param`) segment, which outweighs a wildcard (`*` / `*name`). So
+ * `/post/new` beats `/post/:id`, and a splat always ranks last. Sort callers
+ * descending by this score (highest = most specific = first).
+ */
+const STATIC_SEGMENT = 10;
+const DYNAMIC_SEGMENT = 3;
+const WILDCARD_SEGMENT = -2;
+function routeSpecificity(spec) {
+    const segments = spec.split('/').filter(Boolean);
+    // Base on segment count so a deeper path outranks a shallower one on ties.
+    let score = segments.length;
+    for (const segment of segments) {
+        if (segment.startsWith('*')) {
+            score += WILDCARD_SEGMENT;
+        }
+        else if (segment.startsWith(':')) {
+            score += DYNAMIC_SEGMENT;
+        }
+        else {
+            score += STATIC_SEGMENT;
+        }
+    }
+    return score;
+}
+
 /**
  * Match a URL path against an array of route configs.
  * Uses pica-route — same matching as vanilla Snice's Router.
- * Routes are sorted by specificity (longest spec first).
+ * Routes are sorted by per-segment specificity (static > dynamic > wildcard).
  */
 function matchRoutes(routes, pathname) {
-    // Sort by specificity (longest path first), same as vanilla Router
-    const sorted = [...routes].sort((a, b) => b.path.length - a.path.length);
+    // Sort by specificity (most specific first), same model as the vanilla Router.
+    const sorted = [...routes].sort((a, b) => routeSpecificity(b.path) - routeSpecificity(a.path));
     for (const route of sorted) {
         const matcher = new Route(route.path);
         const params = matcher.match(pathname);

package/dist/react/matchRoute.js.map

@@ -1 +1 @@
-{"version":3,"file":"matchRoute.js","sources":["../../src/react/matchRoute.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;AAaA;;;;AAIG;AACG,SAAU,WAAW,CAAC,MAAqB,EAAE,QAAgB,EAAA;;AAEjE,IAAA,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;AAExE,IAAA,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE;QAC1B,MAAM,OAAO,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;QACrC,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;AACtC,QAAA,IAAI,MAAM,KAAK,KAAK,EAAE;YACpB,OAAO;gBACL,KAAK,EAAE,KAAK,CAAC,KAAK;AAClB,gBAAA,MAAM,EAAE,MAAqB;gBAC7B,IAAI,EAAE,KAAK,CAAC,IAAI;aACjB;QACH;IACF;AAEA,IAAA,OAAO,IAAI;AACb;;;;"}
+{"version":3,"file":"matchRoute.js","sources":["../../src/react/route-specificity.ts","../../src/react/matchRoute.ts"],"sourcesContent":[null,null],"names":[],"mappings":";;;;;;;;;;AAAA;;;;;;;;;;;;AAYG;AACH,MAAM,cAAc,GAAG,EAAE;AACzB,MAAM,eAAe,GAAG,CAAC;AACzB,MAAM,gBAAgB,GAAG,EAAE;AAErB,SAAU,gBAAgB,CAAC,IAAY,EAAA;AAC3C,IAAA,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;;AAEhD,IAAA,IAAI,KAAK,GAAG,QAAQ,CAAC,MAAM;AAE3B,IAAA,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE;AAC9B,QAAA,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE;YAC3B,KAAK,IAAI,gBAAgB;QAC3B;AAAO,aAAA,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE;YAClC,KAAK,IAAI,eAAe;QAC1B;aAAO;YACL,KAAK,IAAI,cAAc;QACzB;IACF;AAEA,IAAA,OAAO,KAAK;AACd;;ACnBA;;;;AAIG;AACG,SAAU,WAAW,CAAC,MAAqB,EAAE,QAAgB,EAAA;;AAEjE,IAAA,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAE9F,IAAA,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE;QAC1B,MAAM,OAAO,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;QACrC,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;AACtC,QAAA,IAAI,MAAM,KAAK,KAAK,EAAE;YACpB,OAAO;gBACL,KAAK,EAAE,KAAK,CAAC,KAAK;AAClB,gBAAA,MAAM,EAAE,MAAqB;gBAC7B,IAAI,EAAE,KAAK,CAAC,IAAI;aACjB;QACH;IACF;AAEA,IAAA,OAAO,IAAI;AACb;;;;"}

package/dist/react/route-specificity.d.ts

@@ -0,0 +1 @@
+export declare function routeSpecificity(spec: string): number;

package/dist/react/useRequestHandler.js

@@ -1,5 +1,5 @@
 /*!
- * snice v5.2.2
+ * snice v5.2.3
  * 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/render.d.ts

@@ -39,6 +39,13 @@ export interface RenderOptions {
  * @param immediate - Force immediate render (used for initial render)
  */
 export declare function requestRender(element: HTMLElement, immediate?: boolean): void;
+/**
+ * Clear any pending debounce/throttle render timers on an element (e.g. on
+ * disconnect, so they don't fire on a dead element and retain it until they
+ * expire). Returns true if a render was actually pending, so the caller can
+ * arrange a replay on reconnect via PENDING_RECONNECT_RENDER.
+ */
+export declare function clearRenderTimers(element: HTMLElement): boolean;
 /**
  * @render decorator for component rendering
  *

package/dist/route-specificity.d.ts

@@ -0,0 +1 @@
+export declare function routeSpecificity(spec: string): number;

package/dist/symbols.cjs

@@ -1,5 +1,5 @@
 /*!
- * snice v5.2.2
+ * snice v5.2.3
  * 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.
@@ -35,6 +35,12 @@ const READY_PROMISE = getSymbol('ready-promise');
 const READY_RESOLVE = getSymbol('ready-resolve');
 const RENDERED_PROMISE = getSymbol('rendered-promise');
 const RENDERED_RESOLVE = getSymbol('rendered-resolve');
+// Set when a render is requested but dropped because the element was
+// disconnected; consumed on reconnect to replay exactly the missed render.
+const PENDING_RECONNECT_RENDER = getSymbol('pending-reconnect-render');
+// Per-element synchronous render-nesting depth, used to cap runaway re-entry
+// without a shared global counter that one element could exhaust for others.
+const RENDER_DEPTH = getSymbol('render-depth');
 const CONTROLLER = getSymbol('controller');
 const INITIALIZED = getSymbol('initialized');
 // Event handler symbols
@@ -115,6 +121,10 @@ const ADOPTED_METHODS = getSymbol('adopted-methods');
 // Controller attach-abort — set to an AbortController while attachController
 // is awaiting element.ready, so detachController can short-circuit the wait.
 const CONTROLLER_ABORT = getSymbol('controller-abort');
+// Set on a controller instance once it has gotten past element.ready and is
+// being attached, so detachController knows not to run detach() on a controller
+// whose attach() was aborted before it ever ran.
+const CONTROLLER_ATTACHED = getSymbol('controller-attached');
 const PROPERTY_DEFINERS = getSymbol('property-definers');
 
 exports.ADOPTED_HANDLERS = ADOPTED_HANDLERS;
@@ -135,6 +145,7 @@ exports.CONTEXT_UNREGISTER = CONTEXT_UNREGISTER;
 exports.CONTEXT_UPDATE = CONTEXT_UPDATE;
 exports.CONTROLLER = CONTROLLER;
 exports.CONTROLLER_ABORT = CONTROLLER_ABORT;
+exports.CONTROLLER_ATTACHED = CONTROLLER_ATTACHED;
 exports.CONTROLLER_ID = CONTROLLER_ID;
 exports.CONTROLLER_KEY = CONTROLLER_KEY;
 exports.CONTROLLER_NAME_KEY = CONTROLLER_NAME_KEY;
@@ -163,6 +174,7 @@ exports.PAGE_TRANSITION = PAGE_TRANSITION;
 exports.PARENT_STYLES_METHODS = PARENT_STYLES_METHODS;
 exports.PARTS = PARTS;
 exports.PART_TIMERS = PART_TIMERS;
+exports.PENDING_RECONNECT_RENDER = PENDING_RECONNECT_RENDER;
 exports.PRE_INIT_PROPERTY_VALUES = PRE_INIT_PROPERTY_VALUES;
 exports.PROPERTIES = PROPERTIES;
 exports.PROPERTIES_INITIALIZED = PROPERTIES_INITIALIZED;
@@ -179,6 +191,7 @@ exports.REGISTERED_ELEMENTS = REGISTERED_ELEMENTS;
 exports.RENDERED_PROMISE = RENDERED_PROMISE;
 exports.RENDERED_RESOLVE = RENDERED_RESOLVE;
 exports.RENDER_CALLBACKS = RENDER_CALLBACKS;
+exports.RENDER_DEPTH = RENDER_DEPTH;
 exports.RENDER_INSTANCE = RENDER_INSTANCE;
 exports.RENDER_METHOD = RENDER_METHOD;
 exports.RENDER_OPTIONS = RENDER_OPTIONS;

package/dist/symbols.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"symbols.cjs","sources":["../src/global.ts","../src/symbols.ts"],"sourcesContent":[null,null],"names":[],"mappings":"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"}
+{"version":3,"file":"symbols.cjs","sources":["../src/global.ts","../src/symbols.ts"],"sourcesContent":[null,null],"names":[],"mappings":"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"}

package/dist/symbols.d.ts

@@ -8,6 +8,8 @@ export declare const READY_PROMISE: symbol;
 export declare const READY_RESOLVE: symbol;
 export declare const RENDERED_PROMISE: symbol;
 export declare const RENDERED_RESOLVE: symbol;
+export declare const PENDING_RECONNECT_RENDER: symbol;
+export declare const RENDER_DEPTH: symbol;
 export declare const CONTROLLER: symbol;
 export declare const INITIALIZED: symbol;
 export declare const ON_HANDLERS: symbol;
@@ -71,4 +73,5 @@ export declare const RECONNECT_METHODS: symbol;
 export declare const MOVED_METHODS: symbol;
 export declare const ADOPTED_METHODS: symbol;
 export declare const CONTROLLER_ABORT: symbol;
+export declare const CONTROLLER_ATTACHED: symbol;
 export declare const PROPERTY_DEFINERS: symbol;

package/dist/symbols.esm.js

@@ -1,5 +1,5 @@
 /*!
- * snice v5.2.2
+ * snice v5.2.3
  * 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.
@@ -33,6 +33,12 @@ const READY_PROMISE = getSymbol('ready-promise');
 const READY_RESOLVE = getSymbol('ready-resolve');
 const RENDERED_PROMISE = getSymbol('rendered-promise');
 const RENDERED_RESOLVE = getSymbol('rendered-resolve');
+// Set when a render is requested but dropped because the element was
+// disconnected; consumed on reconnect to replay exactly the missed render.
+const PENDING_RECONNECT_RENDER = getSymbol('pending-reconnect-render');
+// Per-element synchronous render-nesting depth, used to cap runaway re-entry
+// without a shared global counter that one element could exhaust for others.
+const RENDER_DEPTH = getSymbol('render-depth');
 const CONTROLLER = getSymbol('controller');
 const INITIALIZED = getSymbol('initialized');
 // Event handler symbols
@@ -113,7 +119,11 @@ const ADOPTED_METHODS = getSymbol('adopted-methods');
 // Controller attach-abort — set to an AbortController while attachController
 // is awaiting element.ready, so detachController can short-circuit the wait.
 const CONTROLLER_ABORT = getSymbol('controller-abort');
+// Set on a controller instance once it has gotten past element.ready and is
+// being attached, so detachController knows not to run detach() on a controller
+// whose attach() was aborted before it ever ran.
+const CONTROLLER_ATTACHED = getSymbol('controller-attached');
 const PROPERTY_DEFINERS = getSymbol('property-definers');
 
-export { ADOPTED_HANDLERS, ADOPTED_METHODS, ADOPTED_TIMERS, CHANNEL_HANDLERS, CLEANUP, CONTEXT_CALLED, CONTEXT_HANDLER, CONTEXT_METHODS, CONTEXT_METHOD_NAME, CONTEXT_NOTIFY_ELEMENT, CONTEXT_OPTIONS, CONTEXT_REGISTER, CONTEXT_REQUEST_HANDLER, CONTEXT_TIMER, CONTEXT_UNREGISTER, CONTEXT_UPDATE, CONTROLLER, CONTROLLER_ABORT, CONTROLLER_ID, CONTROLLER_KEY, CONTROLLER_NAME_KEY, CONTROLLER_OPERATIONS, CREATED_AT, CURRENT_PAGE_MARKER, DISPATCH_TIMERS, DISPOSE_HANDLERS, DISPOSE_METHODS, EXPLICITLY_SET_PROPERTIES, INITIALIZED, IS_CONTROLLER_CLASS, IS_CONTROLLER_INSTANCE, IS_ELEMENT_CLASS, IS_UPDATING, MOVED_HANDLERS, MOVED_METHODS, MOVED_TIMERS, NATIVE_CONTROLLER, NAVIGATION_CONTEXT_INSTANCE, OBSERVERS, OBSERVE_METHODS, ON_HANDLERS, ON_METHODS, PAGE_TRANSITION, PARENT_STYLES_METHODS, PARTS, PART_TIMERS, PRE_INIT_PROPERTY_VALUES, PROPERTIES, PROPERTIES_INITIALIZED, PROPERTY_DEFINERS, PROPERTY_VALUES, PROPERTY_WATCHERS, READY_HANDLERS, READY_METHODS, READY_PROMISE, READY_RESOLVE, RECONNECT_HANDLERS, RECONNECT_METHODS, REGISTERED_ELEMENTS, RENDERED_PROMISE, RENDERED_RESOLVE, RENDER_CALLBACKS, RENDER_INSTANCE, RENDER_METHOD, RENDER_OPTIONS, RENDER_TIMERS, RESPOND_METHODS, ROUTER_CONTEXT, SETTING_FROM_PROPERTY, STYLES_APPLIED, STYLES_METHOD, WATCH_METHODS, getSymbol };
+export { ADOPTED_HANDLERS, ADOPTED_METHODS, ADOPTED_TIMERS, CHANNEL_HANDLERS, CLEANUP, CONTEXT_CALLED, CONTEXT_HANDLER, CONTEXT_METHODS, CONTEXT_METHOD_NAME, CONTEXT_NOTIFY_ELEMENT, CONTEXT_OPTIONS, CONTEXT_REGISTER, CONTEXT_REQUEST_HANDLER, CONTEXT_TIMER, CONTEXT_UNREGISTER, CONTEXT_UPDATE, CONTROLLER, CONTROLLER_ABORT, CONTROLLER_ATTACHED, CONTROLLER_ID, CONTROLLER_KEY, CONTROLLER_NAME_KEY, CONTROLLER_OPERATIONS, CREATED_AT, CURRENT_PAGE_MARKER, DISPATCH_TIMERS, DISPOSE_HANDLERS, DISPOSE_METHODS, EXPLICITLY_SET_PROPERTIES, INITIALIZED, IS_CONTROLLER_CLASS, IS_CONTROLLER_INSTANCE, IS_ELEMENT_CLASS, IS_UPDATING, MOVED_HANDLERS, MOVED_METHODS, MOVED_TIMERS, NATIVE_CONTROLLER, NAVIGATION_CONTEXT_INSTANCE, OBSERVERS, OBSERVE_METHODS, ON_HANDLERS, ON_METHODS, PAGE_TRANSITION, PARENT_STYLES_METHODS, PARTS, PART_TIMERS, PENDING_RECONNECT_RENDER, PRE_INIT_PROPERTY_VALUES, PROPERTIES, PROPERTIES_INITIALIZED, PROPERTY_DEFINERS, PROPERTY_VALUES, PROPERTY_WATCHERS, READY_HANDLERS, READY_METHODS, READY_PROMISE, READY_RESOLVE, RECONNECT_HANDLERS, RECONNECT_METHODS, REGISTERED_ELEMENTS, RENDERED_PROMISE, RENDERED_RESOLVE, RENDER_CALLBACKS, RENDER_DEPTH, RENDER_INSTANCE, RENDER_METHOD, RENDER_OPTIONS, RENDER_TIMERS, RESPOND_METHODS, ROUTER_CONTEXT, SETTING_FROM_PROPERTY, STYLES_APPLIED, STYLES_METHOD, WATCH_METHODS, getSymbol };
 //# sourceMappingURL=symbols.esm.js.map

package/dist/symbols.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"symbols.esm.js","sources":["../src/global.ts","../src/symbols.ts"],"sourcesContent":[null,null],"names":[],"mappings":"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"}
+{"version":3,"file":"symbols.esm.js","sources":["../src/global.ts","../src/symbols.ts"],"sourcesContent":[null,null],"names":[],"mappings":"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"}

package/dist/transitions.cjs

@@ -1,5 +1,5 @@
 /*!
- * snice v5.2.2
+ * snice v5.2.3
  * 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.2.2
+ * snice v5.2.3
  * 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/types/context.d.ts

@@ -17,10 +17,13 @@ export declare class Context {
      */
     [CONTEXT_REGISTER]: (element: HTMLElement, methodName: string) => void;
     /**
-     * Unregister an element from receiving context updates
+     * Unregister an element from receiving context updates. With a methodName,
+     * removes only that one handler (so a `once` handler tearing itself down
+     * doesn't kill the element's other @context handlers); without one, removes
+     * the element entirely (used on disconnect).
      * @internal Used by @context decorator cleanup
      */
-    [CONTEXT_UNREGISTER]: (element: HTMLElement) => void;
+    [CONTEXT_UNREGISTER]: (element: HTMLElement, methodName?: string) => void;
     /**
      * Update the context and notify all registered elements
      * Prevents infinite loops by tracking update state

package/dist/types/dispatch-options.d.ts

@@ -1,3 +1,4 @@
+import type { OnScope } from './on-options';
 export interface DispatchOptions extends EventInit {
     /**
      * Whether to dispatch even if the method returns undefined (default: true)
@@ -7,4 +8,10 @@ export interface DispatchOptions extends EventInit {
     debounce?: number;
     /** Throttle the dispatch by specified milliseconds */
     throttle?: number;
+    /**
+     * Where to dispatch the event. Default is the host element.
+     * Use `'global'` to dispatch on `document`, a selector for an ancestor
+     * (via `closest()`), a direct EventTarget, or a resolver function.
+     */
+    scope?: OnScope;
 }

package/dist/types/index.d.ts

@@ -1,5 +1,6 @@
 export * from './query-options';
 export * from './property-options';
+export * from './watch-options';
 export * from './property-converter';
 export * from './snice-element';
 export * from './part-options';

package/dist/types/on-options.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Resolver for the EventTarget where the listener is attached.
+ * - `'global'`: attach to `document` (cross-cutting events)
+ * - string: treated as a CSS selector for `host.closest(selector)` (nearest ancestor)
+ * - `Element` / `EventTarget`: attached directly to that node
+ * - `() => Element | EventTarget | null`: called at connect time; null skips
+ */
+export type OnScope = 'global' | string | EventTarget | ((this: HTMLElement) => EventTarget | null);
 export interface OnOptions {
     /** Use capture phase instead of bubble phase */
     capture?: boolean;
@@ -15,4 +23,10 @@ export interface OnOptions {
     throttle?: number;
     /** CSS selector to target specific elements within shadow root */
     target?: string;
+    /**
+     * Where to attach the listener. Default is the host element.
+     * Use `'global'` for document-wide events, a selector for an ancestor
+     * (via `closest()`), a direct EventTarget, or a resolver function.
+     */
+    scope?: OnScope;
 }

package/dist/types/watch-options.d.ts

@@ -0,0 +1,9 @@
+export interface WatchOptions {
+    /**
+     * Whether the watcher fires once during initialization with the element's
+     * initial value (`oldValue` is `undefined`), in addition to firing on later
+     * changes. Defaults to `true`. Set `false` for a change-only watcher — e.g.
+     * one that dispatches an event, so it doesn't emit spuriously on mount.
+     */
+    immediate?: boolean;
+}

package/dist/utils.d.ts

@@ -21,6 +21,11 @@ export declare function parseAttributeValue(attributeValue: string | null, prope
  * @param initialValue - The default value assigned to the property field (used for type detection)
  * @returns The string representation for the HTML attribute, or null if value should remove attribute
  */
+/**
+ * Default property dirty-check: has the value changed? Like `!==`, but treats
+ * NaN → NaN as unchanged (NaN !== NaN would otherwise re-fire forever).
+ */
+export declare function notEqual(value: unknown, old: unknown): boolean;
 /**
  * Extract attribute name from property options
  */
@@ -82,6 +87,13 @@ export declare function ensureObj(obj: any, sym: symbol): Record<string, any>;
  * Invoke property watchers for a given property change
  */
 export declare function invokeWatchers(instance: any, constructor: any, propName: string, oldValue: any, newValue: any): void;
+/**
+ * Fire the one-time initialization call for `@watch(..., { immediate: true })`
+ * handlers. Runs once per declared property after the element is initialized,
+ * passing the effective initial value with `oldValue` undefined. Non-immediate
+ * watchers are untouched — they only react to later changes.
+ */
+export declare function invokeImmediateWatchers(instance: any, constructor: any): void;
 /**
  * Create a debounced version of a function
  */
@@ -90,4 +102,18 @@ export declare function createDebounced<T extends (...args: any[]) => any>(fn: T
  * Create a throttled version of a function (leading + trailing edge)
  */
 export declare function createThrottled<T extends (...args: any[]) => any>(fn: T, delay: number): T;
+/**
+ * Resolve a scope option to a concrete EventTarget.
+ *
+ * - undefined → host element (default behavior)
+ * - 'global' → `document`
+ * - string → `host.closest(selector)` (nearest matching ancestor)
+ * - EventTarget instance → that target directly
+ * - resolver function → called with host as `this`, returns target or null
+ *
+ * Returns null when the scope cannot be resolved (e.g. selector matches no
+ * ancestor, resolver returns null). Caller decides how to handle null —
+ * typically warn in dev and skip listener attachment.
+ */
+export declare function resolveScope(host: HTMLElement, scope: unknown): EventTarget | null;
 export declare function valueToAttribute(value: any, propertyOptions: PropertyOptions, initialValue?: any): string | null;

package/docs/ai/DEVELOPMENT.md

@@ -99,7 +99,7 @@ All CDN builds use the shared runtime (external `snice` imports). Load `snice-ru
 - IIFE: `.js` + `.min.js`
 - Sourcemaps + README
 
-**Size:** Runtime ~20KB gzip, components ~1-93KB each
+**Size:** Runtime ~21KB gzip, components ~1-93KB each
 
 **Features:**
 - Shared runtime (external snice imports)

package/docs/ai/README.md

@@ -49,6 +49,17 @@ claude mcp add snice -- npx snice mcp
 - `search_docs` - Search documentation
 - `validate_code` - Check code for common mistakes
 
+## CDN / Standalone Usage
+
+Runtime first, then one bundle per component (any order after runtime):
+```html
+<script src="snice-runtime.min.js"></script>   <!-- required, first -->
+<script src="snice-button.min.js"></script>
+<snice-button variant="primary">Click me</snice-button>
+```
+- Omit the runtime → elements never register → blank page.
+- Full details (load order, bundle families, `theme.css` + dark mode, `.min.js` vs `.esm`): [cdn.md](cdn.md).
+
 ## Pitfalls
 
 **Decorators:**

package/docs/ai/api.md

@@ -42,8 +42,9 @@
 // Syncs with attributes, triggers re-render
 // Types: String (default), Number, Boolean, Object, Array
 
-@watch(...propertyNames: string[])
-// Called on property change: (oldVal, newVal, propertyName) => void
+@watch(...propertyNames: string[], options?: { immediate?: boolean })
+// Fires once on init: (undefined, initialValue, propertyName), then on every change: (oldVal, newVal, propertyName)
+// { immediate: false } → change-only, skip the init call (use for event-dispatching watchers)
 ```
 
 ## Lifecycle
@@ -79,15 +80,31 @@ html`
 ```typescript
 @on(event: string | string[], selector?: string, options?: OnOptions)
 // Works in elements + controllers
-// Options: { debounce?, throttle?, preventDefault?, stopPropagation?, once?, capture?, passive?, target? }
+// Options: { debounce?, throttle?, preventDefault?, stopPropagation?, once?, capture?, passive?, target?, scope? }
 // target: CSS selector for shadow DOM event delegation
+// scope: 'global' | selector | EventTarget | () => EventTarget | null — redirects listener attachment
 // Keyboard: 'keydown:Enter', 'keydown.escape', 'keydown:ctrl+s', 'keydown:~Space'
 // Supports both ':' and '.' notation
 
-@dispatch(eventName: string, options?: { debounce?, throttle?, dispatchOnUndefined? })
+@dispatch(eventName: string, options?: { debounce?, throttle?, dispatchOnUndefined?, scope?, ...EventInit })
 // Fires CustomEvent after method, detail = return value
 // Supports async methods (dispatches after promise resolves)
 // dispatchOnUndefined: false (default) — skips dispatch if method returns undefined
+// scope: 'global' | selector | EventTarget | () => EventTarget | null — redirects dispatch target
+```
+
+**scope option (shared by @on and @dispatch):**
+```typescript
+// omitted              → host element (default)
+// 'global'             → document
+// 'app-shell'          → host.closest('app-shell')
+// someEl               → that EventTarget
+// function             → called with host as `this`; null skips with console.warn
+
+@on('bus:save',     { scope: 'global' })       // document-level listener
+@on('bus:added',    { scope: 'cart-shell' })   // ancestor-scoped listener
+@dispatch('bus:save',  { scope: 'global' })    // dispatch on document
+@dispatch('bus:added', { scope: 'cart-shell' })// dispatch on ancestor
 ```
 
 ## Communication
@@ -257,7 +274,9 @@ attr="${val}" // Attribute
 ```typescript
 interface TemplateResult { readonly _$litType$: number; }
 interface CSSResult { cssText: string; }
-interface OnOptions { debounce?, throttle?, preventDefault?, stopPropagation?, once?, capture?, passive?, target? }
+interface OnOptions { debounce?, throttle?, preventDefault?, stopPropagation?, once?, capture?, passive?, target?, scope? }
+interface DispatchOptions extends EventInit { debounce?, throttle?, dispatchOnUndefined?, scope? }
+type OnScope = 'global' | string | EventTarget | ((this: HTMLElement) => EventTarget | null)
 interface RenderOptions { debounce?, throttle?, once?, sync?, differential? }
 interface Layout { update(context, placards, route, params) }
 interface Placard { name, title, icon?, description?, order?, show?, visibleOn?, parent?, group?, searchTerms?, hotkeys?, breadcrumbs?, tooltip? }

package/docs/ai/cdn.md

@@ -0,0 +1,31 @@
+# CDN / Standalone Usage
+
+Use any component on a plain HTML page — no bundler. Each component is a standalone `.min.js` sharing one runtime.
+
+## Load order
+
+Runtime first, then one bundle per component (components any order after runtime):
+```html
+<link rel="stylesheet" href="theme.css">      <!-- optional: tokens + dark mode -->
+<script src="snice-runtime.min.js"></script>  <!-- required, first -->
+<script src="snice-button.min.js"></script>
+<snice-button variant="primary">Click me</snice-button>
+```
+- `snice-runtime.min.js` shared by all — omit it → elements never register → blank page.
+
+## Bundle families
+
+One bundle registers its whole family:
+- `snice-tabs.min.js` → `<snice-tabs>` `<snice-tab>` `<snice-tab-panel>`
+- `snice-select.min.js` → `<snice-select>` `<snice-option>`
+- `snice-toast.min.js` → `<snice-toast>` `<snice-toast-container>`
+
+## Theme / dark mode
+
+- `theme.css` optional — components have light-mode fallbacks; add it for full tokens + dark mode.
+- Dark follows OS by default; force with `<html data-theme="dark">` (or `"light"` to pin).
+
+## Builds
+
+- Use `.min.js` (IIFE) for `<script src>`, not `.esm.min.js` (ESM, for bundlers).
+- Build one: `snice build-component <name>`.

package/docs/ai/components/chat.md

@@ -2,6 +2,11 @@
 
 Slack-style chat interface with messages, typing indicators, reactions, and file attachments.
 
+## Components
+
+- `snice-chat` - container
+- `snice-chat-message` - declarative message child (rendered first; `messages`-array entries append after)
+
 ## Properties
 
 ```typescript
@@ -13,6 +18,26 @@ allowFiles: boolean = true;            // attribute: allow-files
 showTyping: boolean = true;            // attribute: show-typing
 showAvatars: boolean = true;           // attribute: show-avatars
 showTimestamps: boolean = true;        // attribute: show-timestamps
+authorColors: Record<string,string> = {};  // property only; per-author colors
+colorAuthors: boolean = false;         // attribute: color-authors; auto color per author
+markdown: boolean = false;             // render bodies as markdown by default
+layout: 'default' | 'bubbles' = 'default';  // 'bubbles' = aligned colored bubbles
+```
+
+ChatMessage adds: `format?: 'text'|'markdown'` (unset = chat-level `markdown` applies), `authorColor?: string` (CSS color; values containing `;`/`{`/`}` are rejected).
+
+### snice-chat-message attributes
+
+```typescript
+author: string = '';
+avatar: string = '';
+type: 'text'|'file'|'image'|'system' = 'text';
+format?: 'text'|'markdown';            // unset = chat-level markdown applies
+edited: boolean = false;
+authorColor: string = '';              // attribute: author-color
+reactions?: MessageReaction[];         // property only
+attachment?: MessageAttachment;        // property only
+// body = element text content
 ```
 
 ## Methods
@@ -32,18 +57,30 @@ showTimestamps: boolean = true;        // attribute: show-timestamps
 - `message-edit` -> `{ messageId: string, newContent: string }`
 - `message-delete` -> `{ messageId: string }`
 - `message-react` -> `{ messageId: string, emoji: string }`
-- `message-thread` -> `{ messageId: string }`
 - `typing-start` -> `{}`
 - `typing-stop` -> `{}`
 
+React, edit, and delete self-apply to the local `messages` model AND emit the event — don't also mutate in the handler or it double-applies. On backend rejection, revert via `updateMessage()`. Delete is confirmed inline first. `message-send` does not self-add; the consumer adds the sent message.
+
 ## CSS Parts
 
 - `base` - Chat container
 - `messages` - Messages scrollable area
+- `message` / `message-own` / `message-other` - message row (+ own/other variants)
+- `system-message` - system message row
+- `avatar`, `author`, `timestamp`, `edited`, `message-text` - message internals
+- `attachment` - message attachment
+- `reactions` / `reaction` / `reaction-active` - reactions
+- `actions` - hover action menu (react on any message; edit/delete owner-only)
+- `edit-input` / `edit-save` / `edit-cancel` - inline editor (shown while editing)
+- `delete-confirm` / `delete-confirm-yes` / `delete-confirm-no` - inline delete confirmation
+- `typing-indicator` - typing indicator row
 - `input-area` - Input area wrapper
 - `input-container` - Input + buttons container
 - `input` - Textarea input field
 
+Per-author color is injected inline as `--snice-chat-author-color`; `::part(author)` reads it.
+
 ## Basic Usage
 
 ```html
@@ -63,6 +100,25 @@ chat.addTypingIndicator('Alice');
 chat.removeTypingIndicator('Alice');
 ```
 
+```html
+<!-- declarative messages (slot first; messages array appends after) -->
+<snice-chat current-user="Me" color-authors layout="bubbles" markdown>
+  <snice-chat-message slot="messages" author="Alice">shipped **v5.3**</snice-chat-message>
+  <snice-chat-message slot="messages" author="Me" format="text">on it</snice-chat-message>
+</snice-chat>
+```
+
+```typescript
+chat.authorColors = { Alice: '#e11d48' };      // explicit per-author color
+chat.addMessage({ type:'text', author:'Alice', timestamp:new Date(),
+  format:'markdown', content:'run `npm i snice@latest`' });
+```
+
+```css
+snice-chat::part(author)      { font-family: 'Inter'; }
+snice-chat::part(message-own) { background: rgba(37,99,235,.06); }
+```
+
 ## Accessibility
 
 - Keyboard navigation for messages and controls