snice 7.5.0 → 7.7.0

package/dist/parts.d.ts

@@ -1,4 +1,6 @@
 import { TemplateResult } from './template';
+import { type RenderHostIdentity } from './render-errors';
+type PropertyBindingRegistry = Pick<CustomElementRegistry, 'get' | 'whenDefined'>;
 export declare const noChange: unique symbol;
 export type NoChange = typeof noChange;
 declare const LIVE_MARKER: unique symbol;
@@ -45,18 +47,21 @@ interface TemplatePart {
  * Instance of a rendered template
  */
 export declare class TemplateInstance {
+    #private;
     template: Template;
     strings: TemplateStringsArray;
     parts: Part[];
     fragment: DocumentFragment | null;
     private conditionalParts;
     private regularParts;
-    constructor(result: TemplateResult);
+    constructor(result: TemplateResult, renderIdentity?: RenderHostIdentity | null, customElementRegistry?: PropertyBindingRegistry | null);
     /**
      * Check if this instance uses the same template strings
      * (template identity is based on the strings array reference)
      */
     isSameTemplate(strings: TemplateStringsArray): boolean;
+    /** Internal attribution value; intentionally contains no live renderer host. */
+    getRenderHostIdentity(): RenderHostIdentity | null;
     renderFragment(): DocumentFragment;
     render(values: readonly any[]): DocumentFragment;
     update(values: readonly any[]): void;
@@ -85,6 +90,7 @@ export declare abstract class Part {
  * - Reuses child NodeParts when rendering arrays
  */
 export declare class NodePart extends Part {
+    #private;
     readonly type: "node";
     private startNode;
     private endNode;
@@ -98,7 +104,8 @@ export declare class NodePart extends Part {
     private _asyncCompleted;
     private _asyncPaused;
     private _committingAsyncValue;
-    constructor(startNode: Comment, endNode: Comment);
+    constructor(startNode: Comment, endNode: Comment, renderIdentity?: RenderHostIdentity | null, customElementRegistry?: PropertyBindingRegistry | null);
+    private _withRenderContext;
     commit(value: any): void;
     /**
      * Commit a primitive value as text
@@ -209,13 +216,14 @@ export declare class StylePart extends Part {
 }
 /** Named spreads: ...props, ...attrs, and ...events. */
 export declare class SpreadPart extends Part {
+    #private;
     readonly type: "spread";
     element: Element;
     readonly name: string;
     private committed;
     private listeners;
     private consumedOnce;
-    constructor(element: Element, name: string);
+    constructor(element: Element, name: string, customElementRegistry?: PropertyBindingRegistry | null);
     commit(value: unknown): void;
     private commitProperties;
     private commitAttributes;
@@ -231,12 +239,14 @@ export declare class SpreadPart extends Part {
  * PropertyPart handles property bindings (.property=${value})
  */
 export declare class PropertyPart extends Part {
+    #private;
     readonly type: "property";
     element: Element;
     readonly name: string;
     private _committedValue;
-    constructor(element: Element, name: string);
+    constructor(element: Element, name: string, customElementRegistry?: PropertyBindingRegistry | null);
     commit(value: unknown): void;
+    reconnected(): void;
     clear(): void;
 }
 /**

package/dist/react/SniceProvider.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.4.0
+ * snice v7.6.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/dist/react/SniceRouter.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.4.0
+ * snice v7.6.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/dist/react/index.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.4.0
+ * snice v7.6.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/dist/react/matchRoute.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.4.0
+ * snice v7.6.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.
@@ -42,6 +42,72 @@ function routeSpecificity(spec) {
     return score;
 }
 
+const EMPTY_QUERY_MARKER = '__snice_empty_query_value__';
+const QUERY_PARAM_PATTERN = /=:[\w-]+\)?$/;
+function containsDecodedMarker(url, marker) {
+    if (url.includes(marker))
+        return true;
+    const queryIndex = url.indexOf('?');
+    if (queryIndex === -1)
+        return false;
+    return url.slice(queryIndex + 1).split('&').some(part => {
+        try {
+            return decodeURIComponent(part).includes(marker);
+        }
+        catch {
+            return false;
+        }
+    });
+}
+function emptyQueryMarker(route, url) {
+    let marker = EMPTY_QUERY_MARKER;
+    while (route.spec.includes(marker) || containsDecodedMarker(url, marker)) {
+        marker += '_';
+    }
+    return marker;
+}
+function fillEmptyQueryParams(route, url, marker) {
+    const urlQueryIndex = url.indexOf('?');
+    const routeQueryIndex = route.spec.indexOf('?');
+    if (urlQueryIndex === -1 || routeQueryIndex === -1)
+        return null;
+    const urlParts = url.slice(urlQueryIndex + 1).split('&');
+    const routeParts = route.spec.slice(routeQueryIndex + 1).split('&');
+    let changed = false;
+    const normalizedParts = urlParts.map((part, index) => {
+        if (part.endsWith('=') && QUERY_PARAM_PATTERN.test(routeParts[index] ?? '')) {
+            changed = true;
+            return `${part}${marker}`;
+        }
+        return part;
+    });
+    if (!changed)
+        return null;
+    return `${url.slice(0, urlQueryIndex + 1)}${normalizedParts.join('&')}`;
+}
+/**
+ * Match through pica-route while preserving legal empty query parameter values.
+ * pica-route 1.1.2 rejects an empty param and therefore discards the whole route.
+ * Keep this compatibility shim in sync with packages/core/src/route-match.ts.
+ */
+function matchRoute(route, url) {
+    const directMatch = route.match(url);
+    if (directMatch !== false)
+        return directMatch;
+    const marker = emptyQueryMarker(route, url);
+    const normalizedUrl = fillEmptyQueryParams(route, url, marker);
+    if (normalizedUrl === null)
+        return false;
+    const params = route.match(normalizedUrl);
+    if (params === false)
+        return false;
+    for (const name of Object.keys(params)) {
+        if (params[name] === marker)
+            params[name] = '';
+    }
+    return params;
+}
+
 /**
  * Match a URL path against an array of route configs.
  * Uses pica-route — same matching as vanilla Snice's Router.
@@ -62,7 +128,7 @@ function matchRoutes(routes, pathname) {
         || a.registrationOrder - b.registrationOrder);
     for (const route of sorted) {
         const matcher = new Route(route.path);
-        const params = matcher.match(pathname);
+        const params = matchRoute(matcher, pathname);
         if (params !== false) {
             return {
                 index: route.index,

package/dist/react/matchRoute.js.map

@@ -1 +1 @@
-{"version":3,"file":"matchRoute.js","sources":["../../src/react/route-specificity.ts","../../src/react/matchRoute.ts"],"sourcesContent":["/**\n * Route specificity scorer for the React binding.\n *\n * IMPORTANT: keep this in exact sync with `src/route-specificity.ts`. The React\n * integration is bundled in isolation (rootDir: src/react) and cannot import\n * across that boundary, so the scorer is mirrored here. The `matchRoutes`\n * resolution tests exercise this copy, so behavioral drift is caught.\n *\n * Scoring is per-segment by ROLE, not string length: a static segment outweighs\n * a dynamic (`:param`) segment, which outweighs a wildcard (`*` / `*name`). So\n * `/post/new` beats `/post/:id`, and a splat always ranks last. Sort callers\n * descending by this score (highest = most specific = first).\n */\nconst STATIC_SEGMENT = 10;\nconst DYNAMIC_SEGMENT = 3;\nconst WILDCARD_SEGMENT = -2;\n\nexport function routeSpecificity(spec: string): number {\n  const segments = spec.split('/').filter(Boolean);\n  // Base on segment count so a deeper path outranks a shallower one on ties.\n  let score = segments.length;\n\n  for (const segment of segments) {\n    if (segment.startsWith('*')) {\n      score += WILDCARD_SEGMENT;\n    } else if (segment.startsWith(':')) {\n      score += DYNAMIC_SEGMENT;\n    } else {\n      score += STATIC_SEGMENT;\n    }\n  }\n\n  return score;\n}\n","import { Route, type RouteParams } from 'pica-route';\nimport { routeSpecificity } from './route-specificity';\n\nexport interface RouteConfig {\n  path: string;\n  index: number;\n  /** Lower values win when route specificity ties. Defaults to 0. */\n  order?: number;\n}\n\nexport interface MatchResult {\n  index: number;\n  params: RouteParams;\n  path: string;\n}\n\n/**\n * Match a URL path against an array of route configs.\n * Uses pica-route — same matching as vanilla Snice's Router.\n * Routes are sorted by per-segment specificity (static > dynamic > wildcard),\n * then optional lower-first order, then declaration order.\n */\nexport function matchRoutes(routes: RouteConfig[], pathname: string): MatchResult | null {\n  for (const route of routes) {\n    if (route.order !== undefined && !Number.isFinite(route.order)) {\n      throw new TypeError(`Route order for \"${route.path}\" must be a finite number.`);\n    }\n  }\n  // Sort by specificity (most specific first), same model as the vanilla Router.\n  const sorted = routes\n    .map((route, registrationOrder) => ({ ...route, registrationOrder }))\n    .sort((a, b) =>\n      routeSpecificity(b.path) - routeSpecificity(a.path)\n      || (a.order ?? 0) - (b.order ?? 0)\n      || a.registrationOrder - b.registrationOrder\n    );\n\n  for (const route of sorted) {\n    const matcher = new Route(route.path);\n    const params = matcher.match(pathname);\n    if (params !== false) {\n      return {\n        index: route.index,\n        params: params as RouteParams,\n        path: route.path,\n      };\n    }\n  }\n\n  return null;\n}\n"],"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;;ACjBA;;;;;AAKG;AACG,SAAU,WAAW,CAAC,MAAqB,EAAE,QAAgB,EAAA;AACjE,IAAA,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE;AAC1B,QAAA,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;YAC9D,MAAM,IAAI,SAAS,CAAC,CAAA,iBAAA,EAAoB,KAAK,CAAC,IAAI,CAAA,0BAAA,CAA4B,CAAC;QACjF;IACF;;IAEA,MAAM,MAAM,GAAG;AACZ,SAAA,GAAG,CAAC,CAAC,KAAK,EAAE,iBAAiB,MAAM,EAAE,GAAG,KAAK,EAAE,iBAAiB,EAAE,CAAC;SACnE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KACT,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,IAAI;AAC/C,WAAA,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC;AAC9B,WAAA,CAAC,CAAC,iBAAiB,GAAG,CAAC,CAAC,iBAAiB,CAC7C;AAEH,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/route-match.ts","../../src/react/matchRoute.ts"],"sourcesContent":["/**\n * Route specificity scorer for the React binding.\n *\n * IMPORTANT: keep this in exact sync with `src/route-specificity.ts`. The React\n * integration is bundled in isolation (rootDir: src/react) and cannot import\n * across that boundary, so the scorer is mirrored here. The `matchRoutes`\n * resolution tests exercise this copy, so behavioral drift is caught.\n *\n * Scoring is per-segment by ROLE, not string length: a static segment outweighs\n * a dynamic (`:param`) segment, which outweighs a wildcard (`*` / `*name`). So\n * `/post/new` beats `/post/:id`, and a splat always ranks last. Sort callers\n * descending by this score (highest = most specific = first).\n */\nconst STATIC_SEGMENT = 10;\nconst DYNAMIC_SEGMENT = 3;\nconst WILDCARD_SEGMENT = -2;\n\nexport function routeSpecificity(spec: string): number {\n  const segments = spec.split('/').filter(Boolean);\n  // Base on segment count so a deeper path outranks a shallower one on ties.\n  let score = segments.length;\n\n  for (const segment of segments) {\n    if (segment.startsWith('*')) {\n      score += WILDCARD_SEGMENT;\n    } else if (segment.startsWith(':')) {\n      score += DYNAMIC_SEGMENT;\n    } else {\n      score += STATIC_SEGMENT;\n    }\n  }\n\n  return score;\n}\n","import type { Route, RouteParams } from 'pica-route';\n\nconst EMPTY_QUERY_MARKER = '__snice_empty_query_value__';\nconst QUERY_PARAM_PATTERN = /=:[\\w-]+\\)?$/;\n\nfunction containsDecodedMarker(url: string, marker: string): boolean {\n  if (url.includes(marker)) return true;\n\n  const queryIndex = url.indexOf('?');\n  if (queryIndex === -1) return false;\n\n  return url.slice(queryIndex + 1).split('&').some(part => {\n    try {\n      return decodeURIComponent(part).includes(marker);\n    } catch {\n      return false;\n    }\n  });\n}\n\nfunction emptyQueryMarker(route: Route, url: string): string {\n  let marker = EMPTY_QUERY_MARKER;\n  while (route.spec.includes(marker) || containsDecodedMarker(url, marker)) {\n    marker += '_';\n  }\n  return marker;\n}\n\nfunction fillEmptyQueryParams(route: Route, url: string, marker: string): string | null {\n  const urlQueryIndex = url.indexOf('?');\n  const routeQueryIndex = route.spec.indexOf('?');\n  if (urlQueryIndex === -1 || routeQueryIndex === -1) return null;\n\n  const urlParts = url.slice(urlQueryIndex + 1).split('&');\n  const routeParts = route.spec.slice(routeQueryIndex + 1).split('&');\n  let changed = false;\n\n  const normalizedParts = urlParts.map((part, index) => {\n    if (part.endsWith('=') && QUERY_PARAM_PATTERN.test(routeParts[index] ?? '')) {\n      changed = true;\n      return `${part}${marker}`;\n    }\n    return part;\n  });\n\n  if (!changed) return null;\n  return `${url.slice(0, urlQueryIndex + 1)}${normalizedParts.join('&')}`;\n}\n\n/**\n * Match through pica-route while preserving legal empty query parameter values.\n * pica-route 1.1.2 rejects an empty param and therefore discards the whole route.\n * Keep this compatibility shim in sync with packages/core/src/route-match.ts.\n */\nexport function matchRoute(route: Route, url: string): RouteParams | false {\n  const directMatch = route.match(url);\n  if (directMatch !== false) return directMatch;\n\n  const marker = emptyQueryMarker(route, url);\n  const normalizedUrl = fillEmptyQueryParams(route, url, marker);\n  if (normalizedUrl === null) return false;\n\n  const params = route.match(normalizedUrl);\n  if (params === false) return false;\n\n  for (const name of Object.keys(params)) {\n    if (params[name] === marker) params[name] = '';\n  }\n  return params;\n}\n","import { Route, type RouteParams } from 'pica-route';\nimport { routeSpecificity } from './route-specificity';\nimport { matchRoute } from './route-match';\n\nexport interface RouteConfig {\n  path: string;\n  index: number;\n  /** Lower values win when route specificity ties. Defaults to 0. */\n  order?: number;\n}\n\nexport interface MatchResult {\n  index: number;\n  params: RouteParams;\n  path: string;\n}\n\n/**\n * Match a URL path against an array of route configs.\n * Uses pica-route — same matching as vanilla Snice's Router.\n * Routes are sorted by per-segment specificity (static > dynamic > wildcard),\n * then optional lower-first order, then declaration order.\n */\nexport function matchRoutes(routes: RouteConfig[], pathname: string): MatchResult | null {\n  for (const route of routes) {\n    if (route.order !== undefined && !Number.isFinite(route.order)) {\n      throw new TypeError(`Route order for \"${route.path}\" must be a finite number.`);\n    }\n  }\n  // Sort by specificity (most specific first), same model as the vanilla Router.\n  const sorted = routes\n    .map((route, registrationOrder) => ({ ...route, registrationOrder }))\n    .sort((a, b) =>\n      routeSpecificity(b.path) - routeSpecificity(a.path)\n      || (a.order ?? 0) - (b.order ?? 0)\n      || a.registrationOrder - b.registrationOrder\n    );\n\n  for (const route of sorted) {\n    const matcher = new Route(route.path);\n    const params = matchRoute(matcher, pathname);\n    if (params !== false) {\n      return {\n        index: route.index,\n        params: params as RouteParams,\n        path: route.path,\n      };\n    }\n  }\n\n  return null;\n}\n"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,7 @@
+import type { Route, RouteParams } from 'pica-route';
+/**
+ * Match through pica-route while preserving legal empty query parameter values.
+ * pica-route 1.1.2 rejects an empty param and therefore discards the whole route.
+ * Keep this compatibility shim in sync with packages/core/src/route-match.ts.
+ */
+export declare function matchRoute(route: Route, url: string): RouteParams | false;

package/dist/react/useRequestHandler.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.4.0
+ * snice v7.6.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/dist/render-errors.d.ts

@@ -0,0 +1,9 @@
+/** Sanitized render attribution. It contains no host, node, constructor, or prototype. */
+export interface RenderHostIdentity {
+    readonly label: string;
+    readonly marker: symbol;
+}
+export declare function registerRenderHostIdentity(constructor: unknown, tagName: string): void;
+/** Capture once at the render boundary; failures fall back without masking the render error. */
+export declare function captureRenderHostIdentity(host: HTMLElement): RenderHostIdentity;
+export declare function contextualizeRenderError(identity: RenderHostIdentity, error: unknown): Error;

package/dist/route-match.d.ts

@@ -0,0 +1,7 @@
+import type { Route, RouteParams } from 'pica-route';
+/**
+ * Match through pica-route while preserving legal empty query parameter values.
+ * pica-route 1.1.2 rejects an empty param and therefore discards the whole route.
+ * Keep this compatibility shim in sync with packages/react/src/route-match.ts.
+ */
+export declare function matchRoute(route: Route, url: string): RouteParams | false;

package/dist/symbols.cjs

@@ -1,5 +1,5 @@
 /*!
- * snice v7.4.0
+ * snice v7.6.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/dist/symbols.esm.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.4.0
+ * snice v7.6.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/dist/template-marker.d.ts

@@ -0,0 +1,5 @@
+export declare const templateMarker: string;
+export declare const templateMarkerMatch: string;
+export declare const templateNodeMarker: string;
+export declare const templateMarkerRegex: RegExp;
+export declare function hasTemplateMarker(value: string | null): boolean;

package/dist/testing-dom.cjs

@@ -1,5 +1,5 @@
 /*!
- * snice v7.4.0
+ * snice v7.6.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/dist/testing-dom.esm.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.4.0
+ * snice v7.6.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/dist/testing.d.ts

@@ -2,3 +2,6 @@ export * from './index';
 export { registerControllerCleanup, getControllerScope, attachController, detachController, getController, cleanupNativeElementControllers } from './controller';
 export { CONTROLLER_KEY, CONTROLLER_OPERATIONS, CONTROLLER_NAME_KEY, CONTROLLER_ID, PROPERTIES_INITIALIZED, PROPERTY_VALUES, PROPERTY_WATCHERS, EXPLICITLY_SET_PROPERTIES, READY_PROMISE, READY_RESOLVE, READY_HANDLERS, DISPOSE_HANDLERS, PARTS, PART_TIMERS, ROUTER_CONTEXT, CONTEXT_REQUEST_HANDLER, PAGE_TRANSITION, CREATED_AT, IS_ELEMENT_CLASS, IS_CONTROLLER_CLASS, IS_CONTROLLER_INSTANCE, IS_DAEMON_CLASS, IS_DAEMON_INSTANCE, DAEMON_STATE, NATIVE_CONTROLLER, DIRECT_CONTROLLER, PENDING_CONTROLLER_BINDING, CLEANUP, ON_HANDLERS, DISPATCH_TIMERS, CHANNEL_HANDLERS, OBSERVERS } from './symbols';
 export { parseAttributeValue, detectType } from './utils';
+export { TemplateInstance } from './parts';
+export { captureRenderHostIdentity } from './render-errors';
+export { renderElementNow } from './render';

package/dist/transitions.cjs

@@ -1,5 +1,5 @@
 /*!
- * snice v7.4.0
+ * snice v7.6.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/dist/transitions.esm.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.4.0
+ * snice v7.6.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

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

@@ -1,13 +1,14 @@
 import type { OnScope } from './on-options';
+import type { EventTiming } from './event-timing';
 export interface DispatchOptions extends EventInit {
     /**
      * Whether to dispatch even if the method returns undefined (default: true)
      */
     dispatchOnUndefined?: boolean;
-    /** Debounce the dispatch by specified milliseconds */
-    debounce?: number;
-    /** Throttle the dispatch by specified milliseconds */
-    throttle?: number;
+    /** Debounce by milliseconds or resolve milliseconds from this instance */
+    debounce?: EventTiming;
+    /** Throttle by milliseconds or resolve milliseconds from this instance */
+    throttle?: EventTiming;
     /**
      * Where to dispatch the event. Default is the host element.
      * Use `'global'` to dispatch on `document`, a selector for an ancestor

package/dist/types/event-timing.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Milliseconds used by an event timing option.
+ *
+ * A resolver is invoked with the decorated element, controller, or daemon as
+ * `this`, allowing the interval to vary per instance.
+ */
+export type EventTiming = number | ((this: any) => number);

package/dist/types/index.d.ts

@@ -13,6 +13,7 @@ export * from './page-options';
 export * from './router-instance';
 export * from './on-options';
 export * from './dispatch-options';
+export * from './event-timing';
 export * from './i-controller';
 export * from './transition';
 export * from './observe-options';

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

@@ -1,3 +1,4 @@
+import type { EventTiming } from './event-timing';
 /**
  * Resolver for the EventTarget where the listener is attached.
  * - `'global'`: attach to `document` (cross-cutting events)
@@ -9,7 +10,9 @@ export type OnScope = 'global' | string | EventTarget | ((this: HTMLElement) =>
 export interface OnOptions {
     /** Use capture phase instead of bubble phase */
     capture?: boolean;
-    /** Remove listener after first trigger */
+    /** Run the handler exactly once, then remove every listener it registered.
+     *  Events that don't match the delegation selector or key filter don't
+     *  consume it. */
     once?: boolean;
     /** Passive listener (can't preventDefault) */
     passive?: boolean;
@@ -17,12 +20,24 @@ export interface OnOptions {
     preventDefault?: boolean;
     /** Automatically call stopPropagation on the event */
     stopPropagation?: boolean;
-    /** Debounce the handler by specified milliseconds */
-    debounce?: number;
-    /** Throttle the handler by specified milliseconds */
-    throttle?: number;
-    /** CSS selector to target specific elements within shadow root */
+    /** Debounce by milliseconds or resolve milliseconds from this instance */
+    debounce?: EventTiming;
+    /** Throttle by milliseconds or resolve milliseconds from this instance */
+    throttle?: EventTiming;
+    /** CSS selector for event delegation; equivalent to the positional selector argument */
     target?: string;
+    /**
+     * Listen in the light DOM (the host element and its light-DOM children).
+     * Same tree toggle as @query. Defaults to true; combine with `shadow` to
+     * pick light, shadow, or both. Ignored when `scope`/`daemon` is set.
+     */
+    light?: boolean;
+    /**
+     * Listen in the shadow tree (the component's shadow root).
+     * Same tree toggle as @query. Defaults to true; combine with `light` to
+     * pick light, shadow, or both. Ignored when `scope`/`daemon` is set.
+     */
+    shadow?: boolean;
     /**
      * Where to attach the listener. Default is the host element.
      * Use `'global'` for document-wide events, a selector for an ancestor

package/dist/utils.d.ts

@@ -1,4 +1,5 @@
 import { PropertyOptions } from './types';
+import type { EventTiming } from './types/event-timing';
 /**
  * Detects the type constructor from an initial value
  * @param initialValue - The default value assigned to a property field (e.g., `name = "default"` -> "default")
@@ -108,6 +109,8 @@ 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 and validate an @on/@dispatch debounce or throttle interval. */
+export declare function resolveEventTiming(instance: object, timing: EventTiming | undefined, decorator: '@on' | '@dispatch', option: 'debounce' | 'throttle'): number | undefined;
 /**
  * Resolve a scope option to a concrete EventTarget.
  *

package/docs/ai/DEVELOPMENT.md

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

package/docs/ai/api.md

@@ -114,6 +114,8 @@ html`
 @on(event: string | string[], selector?: string, options?: OnOptions)
 // Works in elements + controllers
 // Options: { debounce?, throttle?, preventDefault?, stopPropagation?, once?, capture?, passive?, target?, scope?, daemon? }
+// debounce/throttle: number | function called with decorated instance as `this`
+// @on resolves timing functions at listener setup/reconnect; finite non-negative ms required
 // 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'
@@ -122,6 +124,8 @@ html`
 @dispatch(eventName: string, options?: { debounce?, throttle?, dispatchOnUndefined?, scope?, daemon?, ...EventInit })
 // Fires CustomEvent after method, detail = return value
 // Supports async methods (dispatches after promise resolves)
+// Timing functions resolve against the decorated instance per invocation
+// Teardown cancels queued and unresolved-async dispatch work
 // dispatchOnUndefined: false — skips when return is undefined; omitted/true still dispatches
 // scope: 'global' | selector | EventTarget | () => EventTarget | null — redirects dispatch target
 ```
@@ -367,8 +371,9 @@ Full references: [rendering.md](rendering.md) for renderer structure and [bindin
 ```typescript
 interface TemplateResult { readonly _$litType$: number; }
 interface CSSResult { cssText: string; }
-interface OnOptions { debounce?, throttle?, preventDefault?, stopPropagation?, once?, capture?, passive?, target?, scope? }
-interface DispatchOptions extends EventInit { debounce?, throttle?, dispatchOnUndefined?, scope? }
+type EventTiming = number | ((this: any) => number)
+interface OnOptions { debounce?: EventTiming, throttle?: EventTiming, preventDefault?, stopPropagation?, once?, capture?, passive?, target?, scope? }
+interface DispatchOptions extends EventInit { debounce?: EventTiming, throttle?: EventTiming, dispatchOnUndefined?, scope? }
 type OnScope = 'global' | string | EventTarget | ((this: HTMLElement) => EventTarget | null)
 interface RenderOptions { debounce?, throttle?, once?, sync?, differential? }
 interface PropertyOptions { type?, attribute?, reflect?, deep?, converter?, hasChanged? }

package/docs/ai/cli.md

@@ -46,6 +46,20 @@ npx snice validate           # source analyzer only
 - deep imports that were never released package paths, e.g. `snice/decorators`
 - Router missing `target`, `type`, or a project-wide `initialize()` call
 - a routed class combining `@page` with redundant `@element`
+- route path/query `:param` or named `*splat` without a reachable attribute target,
+  including `attribute: false` and mismatched aliases
+  (`snice/route-param-has-no-binding-target`, non-blocking warning)
+- controller `@context()` handlers that start load/reload/refresh/fetch work
+  without `{ once: true }`, a first-delivery guard, or an update diff
+  (`snice/unguarded-context-load`, non-blocking warning)
+
+Route-param inheritance follows proven local declarations, direct relative
+re-exports, and named or namespace Snice imports. Missing-target findings are
+deferred for unresolved/ambiguous bases or dynamic route/attribute contracts;
+locally visible disabled or mismatched properties are still reported.
+The rule stays warning-level because the dependency-free static lexer cannot
+model every valid JavaScript/TypeScript grammar edge; verify the Router
+attribute channel, but this finding alone does not fail `validate` or `check`.
 
 Non-blocking architecture suggestions:
 - `@page` -> `src/pages/`

package/docs/ai/components/avatar.md

@@ -18,6 +18,7 @@ alt: string = '';                    // Alt text (falls back to `name`)
 name: string = '';                   // User's name (initials + color generation)
 size: 'xs'|'small'|'medium'|'large'|'xl'|'xxl' = 'medium';
 shape: 'circle'|'square'|'rounded' = 'circle';
+loading: 'lazy'|'eager' = 'lazy';   // img loading strategy
 fallbackColor: string = '#ffffff';   // attr: fallback-color — text color for initials
 fallbackBackground: string = '';     // attr: fallback-background — overrides auto-color
 ```

package/docs/ai/components/calendar.md

@@ -15,6 +15,8 @@ highlightToday: boolean = true;        // attribute: highlight-today
 showWeekNumbers: boolean = false;      // attribute: show-week-numbers
 firstDayOfWeek: number = 0;            // attribute: first-day-of-week (0=Sun, 1=Mon)
 locale: string = 'en-US';
+noDaySelect: boolean = false;          // attribute: no-day-select — display-only: day clicks don't select/highlight or fire calendar-change; event bars stay interactive
+cellSizing: 'square'|'stretch' = 'square'; // attribute: cell-sizing — square: cells as tall as the column is wide; stretch: rows collapse to content + event-lane reservation
 ```
 
 ## Methods
@@ -48,8 +50,29 @@ locale: string = 'en-US';
 import 'snice/components/calendar/snice-calendar';
 
 calendar.events = [
-  { id: 1, title: 'Meeting', start: new Date(), color: '#2196f3' }
+  { id: 1, title: 'Meeting', start: new Date(), color: '#2196f3' },
+  { id: 2, title: 'Conf', start: '2026-06-04', end: '2026-06-10' } // ranged
 ];
+// Ranged events render as continuous stripes: one bar per week row, chopped
+// at week boundaries (squared corners on the continuing side, title repeats).
+// Concurrent events stack into lanes (start asc, longer first on ties);
+// max 3 lanes, deeper stacks collapse to a per-day "+N more" chip.
+// Bars: part="event-bar", click -> calendar-event-click.
+// Styling: color -> background; avatar?: string | {src?,name?,alt?} ->
+// <snice-avatar> on each bar (part="event-avatar"; name -> initials fallback);
+// className?: string -> added to bar classes AND part list, so
+// ::part(<className>) themes specific events from outside.
+// Tooltips: event.tooltip?: string (static), or on the element:
+//   eventTooltip: (event) => string | Node | Promise<string | Node>  // lazy/rich; wins over event.tooltip
+// Stale async results discarded on pointer-leave. Overlay part="event-tooltip".
+// Popovers (click-to-open, interactive; STRICT per-event opt-in):
+//   event.popover?: boolean | string | Node | (() => Node)
+//   Resolution: inline content -> element eventPopover(event) => string|Node|Promise
+//   -> @request('calendar/event-popover') {event} (answer with @respond) -> warn+close.
+//   role="dialog" part="event-popover"; Escape/outside-click dismiss, focus returns
+//   to bar; loading state while pending; stale results discarded.
+//   Bars with popover: role="button" tabindex=0, Enter/Space opens.
+//   calendar-event-click still fires. closeEventPopover() closes programmatically.
 
 calendar.addEventListener('calendar-change', (e) => {
   console.log('Selected:', e.detail.value);

package/docs/ai/components/switch.md

@@ -58,6 +58,9 @@ readonly labels: NodeList | null;
 - `thumb` - Switch thumb
 - `spinner` - Loading spinner
 - `label` - Label text
+- `label-on` / `label-off` - State text inside the track (render when set)
+
+State labels: track auto-sizes to the widest label (medium/large; small hides them); checked thumb travel follows actual track width, so `::part(track)` width overrides stay aligned.
 
 ## Basic Usage
 

package/docs/ai/components/table.md

@@ -52,7 +52,7 @@ interface ColumnDefinition {
   key:string; label:string; type?:ColumnType; align?:'left'|'center'|'right'; width?:string; flex?:number; minWidth?:number; maxWidth?:number;
   sortable?:boolean; filterable?:boolean; resizable?:boolean; reorderable?:boolean; hideable?:boolean; pinnable?:boolean; pinned?:'left'|'right'|false;
   editable?:boolean; exportable?:boolean; editorType?:'text'|'number'|'date'|'boolean'|'select'; selectOptions?:{value:string;label:string}[];
-  formatter?:(value:any,row?:any)=>string; valueGetter?:(value:any,row:any)=>any; valueFormatter?:(value:any,row:any)=>string;
+  formatter?:(value:any,row?:any)=>string; valueGetter?:(value:any,row:any)=>any; /* runs for display, sort, aggregation */ valueFormatter?:(value:any,row:any)=>string;
   valueParser?:(value:string,row:any)=>any; valueSetter?:(value:any,row:any)=>any; sortComparator?:(a:any,b:any,direction:'asc'|'desc')=>number;
   colSpan?:number|((value:any,row:any)=>number); aggregate?:Aggregator; renderCell?:(value:any,row:any,column:ColumnDefinition)=>HTMLElement|string;
   renderEditor?:(value:any,row:any,column:ColumnDefinition,commit:(v:any)=>void,cancel:()=>void)=>HTMLElement;

package/docs/ai/decorators.md

@@ -31,8 +31,9 @@
 - `@queryAll('selector', { light? })` - NodeList
 
 ## Events
-- `@on('event', 'selector?', options?)` - Delegation, auto-bound. Options: `{ capture?, once?, passive?, preventDefault?, stopPropagation?, debounce?, throttle?, scope?, daemon? }`
-- `@dispatch('event-name', options?)` - Emit CustomEvent, detail = return value. Supports async. Options: `{ debounce?, throttle?, dispatchOnUndefined?, scope?, daemon?, ...EventInit }`
+- `@on('event', 'selector?', options?)` - Delegation, auto-bound. Options: `{ capture?, once?, passive?, preventDefault?, stopPropagation?, debounce?: EventTiming, throttle?: EventTiming, scope?, daemon? }`
+- `@dispatch('event-name', options?)` - Emit CustomEvent, detail = return value. Supports async. Options: `{ debounce?: EventTiming, throttle?: EventTiming, dispatchOnUndefined?, scope?, daemon?, ...EventInit }`
+- `EventTiming = number | ((this: any) => number)` - Per-instance resolver. `@on` resolves at listener setup; `@dispatch` resolves per invocation. Must return finite non-negative ms; `0` disables.
 
 ### scope (on both `@on` and `@dispatch`)