elements-kit 0.3.1 → 0.3.2

package/dist/{benchmark.CX_oY03V-COK1VBpH.mjs → benchmark.CX_oY03V-CsUg-gW0.mjs}

@@ -5106,7 +5106,7 @@ function manageArtifactAttachment(attachment) {
 	if (attachment.body != null) attachment.bodyEncoding ??= "base64";
 }
 //#endregion
-//#region node_modules/.pnpm/vitest@4.1.3_@types+node@25.5.2_happy-dom@20.8.9_jsdom@29.1.0_vite@8.0.8_@types+node@25.5.2_esbuild@0.27.7_/node_modules/vitest/dist/chunks/utils.BX5Fg8C4.js
+//#region node_modules/.pnpm/vitest@4.1.3_@types+node@25.5.2_happy-dom@20.8.9_vite@8.0.8_@types+node@25.5.2_esbuild@0.27.7_/node_modules/vitest/dist/chunks/utils.BX5Fg8C4.js
 const NAME_WORKER_STATE = "__vitest_worker__";
 function getWorkerState() {
 	const workerState = globalThis[NAME_WORKER_STATE];
@@ -5146,7 +5146,7 @@ async function waitForImportsToResolve() {
 	await waitForImportsToResolve();
 }
 //#endregion
-//#region node_modules/.pnpm/vitest@4.1.3_@types+node@25.5.2_happy-dom@20.8.9_jsdom@29.1.0_vite@8.0.8_@types+node@25.5.2_esbuild@0.27.7_/node_modules/vitest/dist/chunks/benchmark.CX_oY03V.js
+//#region node_modules/.pnpm/vitest@4.1.3_@types+node@25.5.2_happy-dom@20.8.9_vite@8.0.8_@types+node@25.5.2_esbuild@0.27.7_/node_modules/vitest/dist/chunks/benchmark.CX_oY03V.js
 const benchFns = /* @__PURE__ */ new WeakMap();
 const benchOptsMap = /* @__PURE__ */ new WeakMap();
 const bench = createBenchmark(function(name, fn = noop, options = {}) {

package/dist/custom-elements-D5CgfNKc.d.mts

@@ -0,0 +1,55 @@
+//#region src/custom-elements.d.ts
+/**
+ * Registry of custom-element tags to their constructors.
+ * Users augment this interface to add typed JSX support for their elements.
+ *
+ * The interface lives in the global `ElementsKit` namespace so augmentations
+ * propagate cleanly through type-bundle chunk splits — augmenting a module
+ * subpath would not always merge with internal references inside the JSX
+ * namespace's `IntrinsicElements`.
+ *
+ * @example
+ * ```ts
+ * declare global {
+ *   namespace ElementsKit {
+ *     interface CustomElementRegistry {
+ *       "x-range": typeof XRange;
+ *     }
+ *   }
+ * }
+ * ```
+ */
+declare global {
+  namespace ElementsKit {
+    interface CustomElementRegistry {}
+  }
+}
+type CustomElementRegistry = ElementsKit.CustomElementRegistry;
+type AnyCtor = CustomElementConstructor;
+/**
+ * Register a custom element with the browser and return its class.
+ * Pair with an augmentation of `ElementsKit.CustomElementRegistry` to get typed JSX.
+ *
+ * @example
+ * ```tsx
+ * import { defineElement } from "elements-kit/custom-elements";
+ *
+ * class XCounter extends HTMLElement {}
+ *
+ * defineElement("x-counter", XCounter);
+ *
+ * declare global {
+ *   namespace ElementsKit {
+ *     interface CustomElementRegistry {
+ *       "x-counter": typeof XCounter;
+ *     }
+ *   }
+ * }
+ *
+ * // JSX now gets typed props + typed ref
+ * // <x-counter />
+ * ```
+ */
+declare function defineElement<Tag extends `${string}-${string}`, C extends AnyCtor>(tag: Tag, cls: C, options?: ElementDefinitionOptions): C;
+//#endregion
+export { defineElement as n, CustomElementRegistry as t };

package/dist/custom-elements.d.mts

@@ -1,2 +1,2 @@
-import { n as defineElement, t as CustomElementRegistry } from "./custom-elements-CBuenqVD.mjs";
+import { n as defineElement, t as CustomElementRegistry } from "./custom-elements-D5CgfNKc.mjs";
 export { CustomElementRegistry, defineElement };

package/dist/custom-elements.mjs

@@ -1,7 +1,7 @@
 //#region src/custom-elements.ts
 /**
 * Register a custom element with the browser and return its class.
-* Pair with a module augmentation of `CustomElementRegistry` to get typed JSX.
+* Pair with an augmentation of `ElementsKit.CustomElementRegistry` to get typed JSX.
 *
 * @example
 * ```tsx
@@ -11,9 +11,11 @@
 *
 * defineElement("x-counter", XCounter);
 *
-* declare module "elements-kit/custom-elements" {
-*   interface CustomElementRegistry {
-*     "x-counter": typeof XCounter;
+* declare global {
+*   namespace ElementsKit {
+*     interface CustomElementRegistry {
+*       "x-counter": typeof XCounter;
+*     }
 *   }
 * }
 *

package/dist/for.d.mts

@@ -1,4 +1,4 @@
-import { i as Props, s as Require } from "./infer-BUUWMoG9.mjs";
+import { i as Props, s as Require } from "./infer-LDn1TquI.mjs";
 
 //#region src/for.d.ts
 type KeyFn<T> = (item: T, index: number) => string | number;

package/dist/{infer-BUUWMoG9.d.mts → infer-LDn1TquI.d.mts}

@@ -1,5 +1,5 @@
 import { n as AttrChangeHandler, t as ATTRIBUTES } from "./attributes-3r7Diua4.mjs";
-import { t as CustomElementRegistry } from "./custom-elements-CBuenqVD.mjs";
+import { t as CustomElementRegistry } from "./custom-elements-D5CgfNKc.mjs";
 import { a as PrimitiveNodeType, i as Slots, n as Slot, t as SLOTS } from "./slot-CfafCBOW.mjs";
 import { JSX } from "dom-expressions/src/jsx-h";
 
@@ -395,24 +395,34 @@ type SlotProps<K extends string> = { [P in K as `slot:${P}`]?: Child };
 type Attrs<K extends keyof JSX$1.IntrinsicElements> = JSX$1.IntrinsicElements[K];
 /**
  * Namespaced JSX props added by elements-kit on top of dom-expressions.
- *
- * - `ref` — callback invoked with the mounted element.
- * - `slot:foo` — accepts any `Child`. Reactive children come for free because
- *   `Child` already includes `AnyFn` (so `() => content()` and `signal` both
- *   typecheck and are wired as reactive slots by `mountChild`).
- * - `class:foo` / `style:foo` — `MaybeReactive<T>` (value or zero-arg getter),
- *   because their value types (`boolean` / `string | null`) are primitives
- *   that don't otherwise allow function form.
- * - `prop:foo` — any value, direct property assignment, no reactive coupling.
+ * All four are tag-aware via the element type `E`.
+ *
+ * - `ref` — callback invoked with the mounted element, typed as the concrete
+ *   element class for intrinsics and registered custom elements.
+ * - `class:foo` — open string + `MaybeReactive<boolean>`. Class names are
+ *   user-defined CSS so the key stays open (no autocomplete possible).
+ * - `style:cssProp` — keys mapped from `DomJSX.CSSProperties` (csstype's
+ *   hyphenated property names) for autocomplete; value typed per-property.
+ * - `prop:K` — inferred from `keyof E`. On `<div>` exposes
+ *   `prop:className`, `prop:id`, etc. (from `HTMLDivElement`); on a
+ *   registered custom element exposes its public fields too.
+ *
+ * `slot:foo` is NOT here — it's emitted per-element via `SlotsOf<C>` only
+ * for elements that declare `[SLOTS]`. Plain HTML intrinsics don't accept
+ * slot props (the runtime ignores them).
  */
-type JsxNamespaces = {
-  ref?: (el: Element) => void;
-  [slot: `slot:${string}`]: Child;
+type CssStyleKey = Extract<keyof JSX.CSSProperties, string> extends infer K ? K extends `-${string}` ? never : K : never;
+type StyleNamespace = { [K in CssStyleKey as `style:${K}`]?: MaybeReactive<JSX.CSSProperties[K] | null> };
+type PropNamespace<E> = { [K in keyof E as K extends string ? `prop:${K}` : never]?: MaybeReactive<E[K]> };
+type JsxNamespaces<E extends Element = Element> = {
+  ref?: (el: E) => void;
   [cls: `class:${string}`]: MaybeReactive<boolean>;
-  [sty: `style:${string}`]: MaybeReactive<string | null>;
-  [prop: `prop:${string}`]: unknown;
-};
-type WithJsxNamespaces<T> = T & JsxNamespaces;
+} & StyleNamespace & PropNamespace<E>;
+type JsxNamespaceKeys = "ref" | `class:${string}` | `style:${string}` | `prop:${string}`;
+type WithJsxNamespaces<T, E extends Element = Element> = Omit<T, JsxNamespaceKeys> & JsxNamespaces<E>;
+type IntrinsicElementOf<T> = T extends {
+  ref?: infer R | undefined;
+} ? Extract<R, (el: any) => any> extends ((el: infer E) => any) ? E : Element : Element;
 declare namespace JSX$1 {
   export type Element = globalThis.Element | globalThis.DocumentFragment | null;
   export type ElementType = Child | Component;
@@ -423,10 +433,8 @@ declare namespace JSX$1 {
     ref?: (el: Element) => void;
   }
   export type LibraryManagedAttributes<C, P> = ResolveProps<C, P>;
-  type RegisteredElements = { [K in keyof CustomElementRegistry]: CustomElementRegistry[K] extends AnyElementCtor ? MaybeReactiveProps<ElementProps<CustomElementRegistry[K]>> : never };
-  export type IntrinsicElements = { [K in keyof JSX.IntrinsicElements]: WithJsxNamespaces<JSX.IntrinsicElements[K]> } & RegisteredElements & {
-    /** Unregistered custom elements (`x-foo`, `my-component`, …) — loose fallback. */[customElement: `${string}-${string}`]: WithJsxNamespaces<JSX.DOMAttributes<HTMLElement>> & Record<string, unknown>;
-  };
+  type RegisteredElements = { [K in keyof CustomElementRegistry]: CustomElementRegistry[K] extends AnyElementCtor ? WithJsxNamespaces<MaybeReactiveProps<ElementProps<CustomElementRegistry[K]>>, InstanceType<CustomElementRegistry[K]>> : never };
+  export type IntrinsicElements = { [K in keyof JSX.IntrinsicElements]: WithJsxNamespaces<JSX.IntrinsicElements[K], IntrinsicElementOf<JSX.IntrinsicElements[K]>> } & RegisteredElements;
   export {};
 }
 //#endregion
@@ -466,7 +474,7 @@ type PropValueFor<V> = V extends Slot ? Child : V;
  * the DOM surface is excluded; for plain classes, all own keys are kept.
  * `Slot`-typed fields are mapped to `Child` (see {@link PropValueFor}).
  */
-type PropsOfInstance<I> = { [K in PublicPropKeys<I> & string]?: PropValueFor<I[K]> };
+type InstanceProps<I> = { [K in PublicPropKeys<I> & string]?: PropValueFor<I[K]> };
 /**
  * Promote keys `K` of `P` to required; leave the rest unchanged.
  *
@@ -482,11 +490,14 @@ type PropsOfInstance<I> = { [K in PublicPropKeys<I> & string]?: PropValueFor<I[K
  */
 type Require<P, K extends keyof P> = { [X in K]-?: P[X] } & Omit<P, K>;
 /**
- * Wrap every prop in {@link MaybeReactive} so callers may pass either a
- * plain value or a reactive getter. Function-typed props (event handlers,
- * render callbacks) are wrapped too — the JSX runtime detects branded
- * signals/computed and re-binds on change. Optionality is preserved at the
- * key level — the `| undefined` stays at the prop, not inside the reactive.
+ * Wrap every non-function prop in {@link MaybeReactive} so callers may pass
+ * either a plain value or a reactive getter. Function-typed props (event
+ * handlers, render callbacks) are left as-is so inline arrow callbacks get
+ * proper contextual typing for their parameters — wrapping them in
+ * `MaybeReactive<F> = F | (() => F)` produces two callable alternatives and
+ * TS falls back to implicit-any on the callback's params. Optionality is
+ * preserved at the key level — the `| undefined` stays at the prop, not
+ * inside the reactive.
  *
  * @template P — source prop object type.
  *
@@ -497,14 +508,15 @@ type Require<P, K extends keyof P> = { [X in K]-?: P[X] } & Omit<P, K>;
  * // {
  * //   count:    MaybeReactive<number>;
  * //   label?:   MaybeReactive<string>;
- * //   onClick:  MaybeReactive<(e: Event) => void>;   // computed handlers OK
+ * //   onClick:  (e: Event) => void;
  * // }
  * ```
  *
  * @see {@link MaybeReactive}
  * @see {@link Props}
  */
-type MaybeReactiveProps<P> = { [K in keyof P]: undefined extends P[K] ? MaybeReactive<Exclude<P[K], undefined>> | undefined : MaybeReactive<P[K]> };
+type MaybeReactiveProps<P> = { [K in keyof P]: undefined extends P[K] ? MaybeReactiveOrFn<Exclude<P[K], undefined>> | undefined : MaybeReactiveOrFn<P[K]> };
+type MaybeReactiveOrFn<T> = Extract<T, (...args: any[]) => any> extends never ? MaybeReactive<T> : T;
 declare const RAW_PROPS: unique symbol;
 type ReactiveProps<P> = { readonly [K in keyof P]: Computed<P[K]> } & {
   readonly [RAW_PROPS]?: P;
@@ -526,7 +538,7 @@ type RawProps<R> = R extends {
 type ResolveProps<C, P, NN = NonNullable<P>> = NN extends {
   readonly [RAW_PROPS]?: infer Raw;
 } ? MaybeReactiveProps<Raw> : [keyof NN] extends [never] ? Props<C> : NN;
-type InstancePropsOf<C> = Inst<C> extends infer I ? PropsOfInstance<I> : {};
+type InstancePropsOf<C> = Inst<C> extends infer I ? InstanceProps<I> : {};
 type PropKeysOf<C> = keyof InstancePropsOf<C> & string;
 type AttrMap<C> = C extends {
   [ATTRIBUTES]: infer M;
@@ -620,9 +632,9 @@ type ComponentProps<C extends ComponentClass<any>> = C extends ComponentClass<in
  * prop in {@link MaybeReactive} so callers may pass values or reactive getters.
  *
  * Branches by input shape:
- * - **Class constructor** (`typeof Cls`) → uses `PropsOfInstance<InstanceType<Cls>>`.
+ * - **Class constructor** (`typeof Cls`) → uses `InstanceProps<InstanceType<Cls>>`.
  * - **Function component** (`(props: P) => ...`) → uses the first parameter.
- * - **Class instance** (`Cls<T>`) → uses `PropsOfInstance<Cls<T>>` (useful when
+ * - **Class instance** (`Cls<T>`) → uses `InstanceProps<Cls<T>>` (useful when
  *   generics need to flow through — see the `For` example below).
  *
  * Does **not** synthesize `on:*`, `slot:*`, or attribute surface. For custom
@@ -652,6 +664,6 @@ type ComponentProps<C extends ComponentClass<any>> = C extends ComponentClass<in
  * @see {@link ComponentProps} — constructor-param-based class components.
  * @see {@link MaybeReactiveProps}
  */
-type Props<C> = (C extends (abstract new (...args: any[]) => infer I) ? MaybeReactiveProps<PropsOfInstance<I>> : C extends ((props: infer P, ...rest: any[]) => any) ? P extends object ? MaybeReactiveProps<RawProps<P>> : {} : MaybeReactiveProps<PropsOfInstance<C>>) & SlotsOf<C>;
+type Props<C> = (C extends (abstract new (...args: any[]) => infer I) ? MaybeReactiveProps<InstanceProps<I>> : C extends ((props: infer P, ...rest: any[]) => any) ? P extends object ? MaybeReactiveProps<RawProps<P>> : {} : MaybeReactiveProps<InstanceProps<C>>) & SlotsOf<C>;
 //#endregion
 export { SIGNAL as A, signal as B, isReactive as C, COMPUTED as D, resolveProps as E, isComputed as F, untracked as H, isEffect as I, isEffectScope as L, computed as M, effect as N, EFFECT as O, effectScope as P, isSignal as R, Updater as S, resolve as T, createElement as U, trigger as V, SlotProps as _, RawProps as a, MaybeReactive as b, ResolveProps as c, ComponentClass as d, ComponentFn as f, JSX$1 as g, Attrs as h, Props as i, batch as j, EFFECT_SCOPE as k, Child as l, PropsTarget as m, ElementProps as n, ReactiveProps as o, ComponentInstance as p, MaybeReactiveProps as r, Require as s, ComponentProps as t, Component as u, Fragment as v, reactive as w, Signal as x, Computed as y, onCleanup as z };

package/dist/integrations/react.d.mts

@@ -1,4 +1,4 @@
-import { y as Computed } from "../infer-BUUWMoG9.mjs";
+import { y as Computed } from "../infer-LDn1TquI.mjs";
 
 //#region src/integrations/react.d.ts
 /**

package/dist/jsx-runtime/index.d.mts

@@ -1,2 +1,2 @@
-import { U as createElement, _ as SlotProps, a as RawProps, b as MaybeReactive, c as ResolveProps, d as ComponentClass, f as ComponentFn, g as JSX, h as Attrs, i as Props, l as Child, m as PropsTarget, n as ElementProps, o as ReactiveProps, p as ComponentInstance, r as MaybeReactiveProps, s as Require, t as ComponentProps, u as Component, v as Fragment } from "../infer-BUUWMoG9.mjs";
+import { U as createElement, _ as SlotProps, a as RawProps, b as MaybeReactive, c as ResolveProps, d as ComponentClass, f as ComponentFn, g as JSX, h as Attrs, i as Props, l as Child, m as PropsTarget, n as ElementProps, o as ReactiveProps, p as ComponentInstance, r as MaybeReactiveProps, s as Require, t as ComponentProps, u as Component, v as Fragment } from "../infer-LDn1TquI.mjs";
 export { Attrs, Child, Component, ComponentClass, ComponentFn, ComponentInstance, ComponentProps, ElementProps, Fragment, JSX, MaybeReactive, MaybeReactiveProps, Props, PropsTarget, RawProps, ReactiveProps, Require, ResolveProps, SlotProps, createElement as h, createElement as jsx, createElement as jsxDEV, createElement as jsxs };

package/dist/signals/index.d.mts

@@ -1,2 +1,2 @@
-import { A as SIGNAL, B as signal, C as isReactive, D as COMPUTED, E as resolveProps, F as isComputed, H as untracked, I as isEffect, L as isEffectScope, M as computed, N as effect, O as EFFECT, P as effectScope, R as isSignal, S as Updater, T as resolve, V as trigger, b as MaybeReactive, j as batch, k as EFFECT_SCOPE, w as reactive, x as Signal, y as Computed, z as onCleanup } from "../infer-BUUWMoG9.mjs";
+import { A as SIGNAL, B as signal, C as isReactive, D as COMPUTED, E as resolveProps, F as isComputed, H as untracked, I as isEffect, L as isEffectScope, M as computed, N as effect, O as EFFECT, P as effectScope, R as isSignal, S as Updater, T as resolve, V as trigger, b as MaybeReactive, j as batch, k as EFFECT_SCOPE, w as reactive, x as Signal, y as Computed, z as onCleanup } from "../infer-LDn1TquI.mjs";
 export { COMPUTED, Computed, EFFECT, EFFECT_SCOPE, MaybeReactive, SIGNAL, Signal, Updater, batch, computed, effect, effectScope, isComputed, isEffect, isEffectScope, isReactive, isSignal, onCleanup, reactive, resolve, resolveProps, signal, trigger, untracked };

package/dist/{test.BmQO5GaM-C8YqghE0.mjs → test.BmQO5GaM-ZC2MPXQb.mjs}

@@ -1,4 +1,4 @@
-import { A as plugins, C as getCallLastIndex, D as ordinal, E as noop, O as stringify, S as createSimpleStackTrace, T as isObject, _ as getSafeTimers, a as waitForImportsToResolve, b as printDiffOrStringify, d as getNames, g as delay, h as parseSingleStack, i as resetModules, j as y, k as format, m as parseErrorStacktrace, n as getWorkerState, r as isChildProcess, u as getCurrentTest, v as processError, w as getType, x as assertTypes, y as diff } from "./benchmark.CX_oY03V-COK1VBpH.mjs";
+import { A as plugins, C as getCallLastIndex, D as ordinal, E as noop, O as stringify, S as createSimpleStackTrace, T as isObject, _ as getSafeTimers, a as waitForImportsToResolve, b as printDiffOrStringify, d as getNames, g as delay, h as parseSingleStack, i as resetModules, j as y, k as format, m as parseErrorStacktrace, n as getWorkerState, r as isChildProcess, u as getCurrentTest, v as processError, w as getType, x as assertTypes, y as diff } from "./benchmark.CX_oY03V-CsUg-gW0.mjs";
 //#region node_modules/.pnpm/@vitest+spy@4.1.3/node_modules/@vitest/spy/dist/index.js
 function isMockFunction(fn) {
 	return typeof fn === "function" && "_isMockFunction" in fn && fn._isMockFunction === true;
@@ -4735,10 +4735,10 @@ function offsetToLineNumber(source, offset) {
 	return line + 1;
 }
 //#endregion
-//#region node_modules/.pnpm/vitest@4.1.3_@types+node@25.5.2_happy-dom@20.8.9_jsdom@29.1.0_vite@8.0.8_@types+node@25.5.2_esbuild@0.27.7_/node_modules/vitest/dist/chunks/_commonjsHelpers.D26ty3Ew.js
+//#region node_modules/.pnpm/vitest@4.1.3_@types+node@25.5.2_happy-dom@20.8.9_vite@8.0.8_@types+node@25.5.2_esbuild@0.27.7_/node_modules/vitest/dist/chunks/_commonjsHelpers.D26ty3Ew.js
 var commonjsGlobal = typeof globalThis !== "undefined" ? globalThis : typeof window !== "undefined" ? window : typeof global !== "undefined" ? global : typeof self !== "undefined" ? self : {};
 //#endregion
-//#region node_modules/.pnpm/vitest@4.1.3_@types+node@25.5.2_happy-dom@20.8.9_jsdom@29.1.0_vite@8.0.8_@types+node@25.5.2_esbuild@0.27.7_/node_modules/vitest/dist/chunks/rpc.MzXet3jl.js
+//#region node_modules/.pnpm/vitest@4.1.3_@types+node@25.5.2_happy-dom@20.8.9_vite@8.0.8_@types+node@25.5.2_esbuild@0.27.7_/node_modules/vitest/dist/chunks/rpc.MzXet3jl.js
 const RealDate = Date;
 let now = null;
 var MockDate = class MockDate extends RealDate {
@@ -5506,7 +5506,7 @@ var SnapshotClient = class {
 	}
 };
 //#endregion
-//#region node_modules/.pnpm/vitest@4.1.3_@types+node@25.5.2_happy-dom@20.8.9_jsdom@29.1.0_vite@8.0.8_@types+node@25.5.2_esbuild@0.27.7_/node_modules/vitest/dist/chunks/test.BmQO5GaM.js
+//#region node_modules/.pnpm/vitest@4.1.3_@types+node@25.5.2_happy-dom@20.8.9_vite@8.0.8_@types+node@25.5.2_esbuild@0.27.7_/node_modules/vitest/dist/chunks/test.BmQO5GaM.js
 var fakeTimersSrc = {};
 var global$1;
 var hasRequiredGlobal;

package/dist/utilities/active-element.d.mts

@@ -1,4 +1,4 @@
-import { y as Computed } from "../infer-BUUWMoG9.mjs";
+import { y as Computed } from "../infer-LDn1TquI.mjs";
 
 //#region src/utilities/active-element.d.ts
 declare const activeElement: Computed<Element | null>;

package/dist/utilities/active-element.test.mjs

@@ -1,5 +1,5 @@
-import { f as it, l as describe } from "../benchmark.CX_oY03V-COK1VBpH.mjs";
-import { t as globalExpect } from "../test.BmQO5GaM-C8YqghE0.mjs";
+import { f as it, l as describe } from "../benchmark.CX_oY03V-CsUg-gW0.mjs";
+import { t as globalExpect } from "../test.BmQO5GaM-ZC2MPXQb.mjs";
 import { activeElement } from "./active-element.mjs";
 //#region src/utilities/active-element.test.ts
 describe("activeElement (singleton)", () => {

package/dist/utilities/async.d.mts

@@ -1,4 +1,4 @@
-import { b as MaybeReactive } from "../infer-BUUWMoG9.mjs";
+import { b as MaybeReactive } from "../infer-LDn1TquI.mjs";
 import { ComputedPromise } from "./promise.mjs";
 
 //#region src/utilities/async.d.ts
@@ -9,6 +9,12 @@ type Fn<TInput, TOutput> = (input: TInput) => Promise<TOutput>;
  * reactive signals (`state`, `value`, `reason`, `result`, `pending`) and
  * lets you `run`/`start`/`stop` the underlying task imperatively.
  *
+ * Trigger choice: `start()` tracks the body and re-runs when its parameter
+ * signals change — right for "fetch X whenever `id` changes". `run()` is
+ * one-shot and untracked — right for externally-driven loads (intersection,
+ * click, form submit), especially when the body writes to the same signals
+ * it reads (`start()` would cascade).
+ *
  * Prefer the {@link async} factory — it returns an `Async` that is also
  * callable as a signal (`op()` === `op.result`), which is what most call
  * sites want. Use this class directly only when you need the object form.

package/dist/utilities/async.mjs

@@ -7,6 +7,12 @@ import { promise } from "./promise.mjs";
 * reactive signals (`state`, `value`, `reason`, `result`, `pending`) and
 * lets you `run`/`start`/`stop` the underlying task imperatively.
 *
+* Trigger choice: `start()` tracks the body and re-runs when its parameter
+* signals change — right for "fetch X whenever `id` changes". `run()` is
+* one-shot and untracked — right for externally-driven loads (intersection,
+* click, form submit), especially when the body writes to the same signals
+* it reads (`start()` would cascade).
+*
 * Prefer the {@link async} factory — it returns an `Async` that is also
 * callable as a signal (`op()` === `op.result`), which is what most call
 * sites want. Use this class directly only when you need the object form.

package/dist/utilities/async.test.mjs

@@ -1,7 +1,7 @@
 import { m as signal, p as onCleanup, s as effect } from "../lib-CVfOddra.mjs";
 import "../signals/index.mjs";
-import { f as it, l as describe } from "../benchmark.CX_oY03V-COK1VBpH.mjs";
-import { n as vi, t as globalExpect } from "../test.BmQO5GaM-C8YqghE0.mjs";
+import { f as it, l as describe } from "../benchmark.CX_oY03V-CsUg-gW0.mjs";
+import { n as vi, t as globalExpect } from "../test.BmQO5GaM-ZC2MPXQb.mjs";
 import { Async, async } from "./async.mjs";
 import { createInterval } from "./interval.mjs";
 //#region src/utilities/async.test.ts

package/dist/utilities/context.test.mjs

@@ -1,7 +1,7 @@
 import { c as effectScope, m as signal, s as effect } from "../lib-CVfOddra.mjs";
 import "../signals/index.mjs";
-import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-COK1VBpH.mjs";
-import { n as vi, t as globalExpect } from "../test.BmQO5GaM-C8YqghE0.mjs";
+import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-CsUg-gW0.mjs";
+import { n as vi, t as globalExpect } from "../test.BmQO5GaM-ZC2MPXQb.mjs";
 import { getContext, setContext } from "./context.mjs";
 //#region src/utilities/context.test.ts
 afterEach(() => {

package/dist/utilities/debounced.d.mts

@@ -1,4 +1,4 @@
-import { y as Computed } from "../infer-BUUWMoG9.mjs";
+import { y as Computed } from "../infer-LDn1TquI.mjs";
 
 //#region src/utilities/debounced.d.ts
 /**

package/dist/utilities/debounced.test.mjs

@@ -1,7 +1,7 @@
 import { c as effectScope, m as signal } from "../lib-CVfOddra.mjs";
 import "../signals/index.mjs";
-import { c as beforeEach, f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-COK1VBpH.mjs";
-import { n as vi, t as globalExpect } from "../test.BmQO5GaM-C8YqghE0.mjs";
+import { c as beforeEach, f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-CsUg-gW0.mjs";
+import { n as vi, t as globalExpect } from "../test.BmQO5GaM-ZC2MPXQb.mjs";
 import { createDebounced } from "./debounced.mjs";
 //#region src/utilities/debounced.test.ts
 beforeEach(() => {

package/dist/utilities/dom-lifecycle.bench.mjs

@@ -1,4 +1,4 @@
-import { l as describe, t as bench } from "../benchmark.CX_oY03V-COK1VBpH.mjs";
+import { l as describe, t as bench } from "../benchmark.CX_oY03V-CsUg-gW0.mjs";
 //#region src/utilities/dom-lifecycle.bench.ts
 describe("dom-lifecycle — registration cost", () => {
 	bench("register 100 entries on already-connected elements", () => {

package/dist/utilities/dom-lifecycle.d.mts

@@ -34,19 +34,9 @@ type AdoptedCallback = (oldDocument: Document, newDocument: Document) => void;
  * place the lifecycle element where those selectors don't reach if needed.)
  *
  * @example
- * ```tsx
- * <div>
- *   <dom-lifecycle
- *     onConnect={(el) => el.parentElement?.classList.add("ready")}
- *     onDisconnect={(el) => {
- *       // el.parentElement is null here per spec — stash from onConnect if needed
- *     }}
- *   />
- * </div>
- * ```
- *
- * @example
- * Wrap children — read the wrapped subtree via `firstElementChild`:
+ * Canonical form — wrap the subtree the lifecycle owns. `onConnect` runs
+ * inside an `effectScope` tied to the wrapped subtree, so observers, context
+ * lookups, and `onCleanup` registrations clean up on disconnect.
  * ```tsx
  * <section>
  *   <dom-lifecycle onConnect={(el) => measure(el.firstElementChild)}>
@@ -55,6 +45,19 @@ type AdoptedCallback = (oldDocument: Document, newDocument: Document) => void;
  *   </dom-lifecycle>
  * </section>
  * ```
+ *
+ * @example
+ * Sibling form — fallback for cases where the host element is already
+ * present for layout reasons and you only need lifecycle on the surrounding
+ * element. Read `self.parentElement` for the host; capture it in `onConnect`
+ * if you need it on disconnect (the spec nulls it before `onDisconnect`).
+ * ```tsx
+ * <div>
+ *   <dom-lifecycle
+ *     onConnect={(el) => el.parentElement?.classList.add("ready")}
+ *   />
+ * </div>
+ * ```
  */
 declare class DomLifecycleElement extends HTMLElement {
   #private;
@@ -72,14 +75,9 @@ declare class DomLifecycleElement extends HTMLElement {
   adoptedCallback(oldDocument: Document, newDocument: Document): void;
 }
 declare global {
-  namespace JSX {
-    interface IntrinsicElements {
-      "dom-lifecycle": {
-        onConnect?: LifecycleCallback;
-        onDisconnect?: LifecycleCallback;
-        onMove?: LifecycleCallback;
-        onAdopted?: AdoptedCallback;
-      };
+  namespace ElementsKit {
+    interface CustomElementRegistry {
+      "dom-lifecycle": typeof DomLifecycleElement;
     }
   }
 }

package/dist/utilities/dom-lifecycle.mjs

@@ -35,19 +35,9 @@ import { isBrowser } from "./environment.mjs";
 * place the lifecycle element where those selectors don't reach if needed.)
 *
 * @example
-* ```tsx
-* <div>
-*   <dom-lifecycle
-*     onConnect={(el) => el.parentElement?.classList.add("ready")}
-*     onDisconnect={(el) => {
-*       // el.parentElement is null here per spec — stash from onConnect if needed
-*     }}
-*   />
-* </div>
-* ```
-*
-* @example
-* Wrap children — read the wrapped subtree via `firstElementChild`:
+* Canonical form — wrap the subtree the lifecycle owns. `onConnect` runs
+* inside an `effectScope` tied to the wrapped subtree, so observers, context
+* lookups, and `onCleanup` registrations clean up on disconnect.
 * ```tsx
 * <section>
 *   <dom-lifecycle onConnect={(el) => measure(el.firstElementChild)}>
@@ -56,6 +46,19 @@ import { isBrowser } from "./environment.mjs";
 *   </dom-lifecycle>
 * </section>
 * ```
+*
+* @example
+* Sibling form — fallback for cases where the host element is already
+* present for layout reasons and you only need lifecycle on the surrounding
+* element. Read `self.parentElement` for the host; capture it in `onConnect`
+* if you need it on disconnect (the spec nulls it before `onDisconnect`).
+* ```tsx
+* <div>
+*   <dom-lifecycle
+*     onConnect={(el) => el.parentElement?.classList.add("ready")}
+*   />
+* </div>
+* ```
 */
 var DomLifecycleElement = class extends HTMLElement {
 	#onConnect = null;

package/dist/utilities/dom-lifecycle.test.mjs

@@ -1,5 +1,5 @@
-import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-COK1VBpH.mjs";
-import { n as vi, t as globalExpect } from "../test.BmQO5GaM-C8YqghE0.mjs";
+import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-CsUg-gW0.mjs";
+import { n as vi, t as globalExpect } from "../test.BmQO5GaM-ZC2MPXQb.mjs";
 import { DomLifecycleElement } from "./dom-lifecycle.mjs";
 //#region src/utilities/dom-lifecycle.test.ts
 afterEach(() => {

package/dist/utilities/element-rect.d.mts

@@ -1,4 +1,4 @@
-import { y as Computed } from "../infer-BUUWMoG9.mjs";
+import { y as Computed } from "../infer-LDn1TquI.mjs";
 
 //#region src/utilities/element-rect.d.ts
 type RectResult = {

package/dist/utilities/element-rect.test.mjs

@@ -1,7 +1,7 @@
 import { c as effectScope } from "../lib-CVfOddra.mjs";
 import "../signals/index.mjs";
-import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-COK1VBpH.mjs";
-import { n as vi, t as globalExpect } from "../test.BmQO5GaM-C8YqghE0.mjs";
+import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-CsUg-gW0.mjs";
+import { n as vi, t as globalExpect } from "../test.BmQO5GaM-ZC2MPXQb.mjs";
 import { createElementRect } from "./element-rect.mjs";
 //#region src/utilities/element-rect.test.ts
 afterEach(() => {

package/dist/utilities/element-scroll.d.mts

@@ -1,4 +1,4 @@
-import { x as Signal } from "../infer-BUUWMoG9.mjs";
+import { x as Signal } from "../infer-LDn1TquI.mjs";
 
 //#region src/utilities/element-scroll.d.ts
 type ElementScrollResult = {

package/dist/utilities/element-scroll.test.mjs

@@ -1,7 +1,7 @@
 import { c as effectScope } from "../lib-CVfOddra.mjs";
 import "../signals/index.mjs";
-import { f as it, l as describe } from "../benchmark.CX_oY03V-COK1VBpH.mjs";
-import { t as globalExpect } from "../test.BmQO5GaM-C8YqghE0.mjs";
+import { f as it, l as describe } from "../benchmark.CX_oY03V-CsUg-gW0.mjs";
+import { t as globalExpect } from "../test.BmQO5GaM-ZC2MPXQb.mjs";
 import { createElementScroll } from "./element-scroll.mjs";
 //#region src/utilities/element-scroll.test.ts
 describe("createElementScroll", () => {

package/dist/utilities/event-driven.d.mts

@@ -1,4 +1,4 @@
-import { x as Signal, y as Computed } from "../infer-BUUWMoG9.mjs";
+import { x as Signal, y as Computed } from "../infer-LDn1TquI.mjs";
 
 //#region src/utilities/event-driven.d.ts
 /**

package/dist/utilities/event-listener.d.mts

@@ -1,4 +1,4 @@
-import { y as Computed } from "../infer-BUUWMoG9.mjs";
+import { y as Computed } from "../infer-LDn1TquI.mjs";
 
 //#region src/utilities/event-listener.d.ts
 /**

package/dist/utilities/event-listener.test.mjs

@@ -1,8 +1,8 @@
 import { c as effectScope, m as signal, s as effect } from "../lib-CVfOddra.mjs";
 import "../signals/index.mjs";
 import { on } from "./event-listener.mjs";
-import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-COK1VBpH.mjs";
-import { n as vi, t as globalExpect } from "../test.BmQO5GaM-C8YqghE0.mjs";
+import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-CsUg-gW0.mjs";
+import { n as vi, t as globalExpect } from "../test.BmQO5GaM-ZC2MPXQb.mjs";
 //#region src/utilities/event-listener.test.ts
 afterEach(() => {
 	document.body.innerHTML = "";

package/dist/utilities/focus-within.d.mts

@@ -1,4 +1,4 @@
-import { y as Computed } from "../infer-BUUWMoG9.mjs";
+import { y as Computed } from "../infer-LDn1TquI.mjs";
 
 //#region src/utilities/focus-within.d.ts
 /**

package/dist/utilities/focus-within.test.mjs

@@ -1,7 +1,7 @@
 import { c as effectScope } from "../lib-CVfOddra.mjs";
 import "../signals/index.mjs";
-import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-COK1VBpH.mjs";
-import { t as globalExpect } from "../test.BmQO5GaM-C8YqghE0.mjs";
+import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-CsUg-gW0.mjs";
+import { t as globalExpect } from "../test.BmQO5GaM-ZC2MPXQb.mjs";
 import { createFocusWithin } from "./focus-within.mjs";
 //#region src/utilities/focus-within.test.ts
 afterEach(() => {

package/dist/utilities/hover.d.mts

@@ -1,4 +1,4 @@
-import { y as Computed } from "../infer-BUUWMoG9.mjs";
+import { y as Computed } from "../infer-LDn1TquI.mjs";
 
 //#region src/utilities/hover.d.ts
 /**

package/dist/utilities/hover.test.mjs

@@ -1,7 +1,7 @@
 import { c as effectScope } from "../lib-CVfOddra.mjs";
 import "../signals/index.mjs";
-import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-COK1VBpH.mjs";
-import { n as vi, t as globalExpect } from "../test.BmQO5GaM-C8YqghE0.mjs";
+import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-CsUg-gW0.mjs";
+import { n as vi, t as globalExpect } from "../test.BmQO5GaM-ZC2MPXQb.mjs";
 import { createHover } from "./hover.mjs";
 //#region src/utilities/hover.test.ts
 afterEach(() => {

package/dist/utilities/intersection-observer.d.mts

@@ -2,6 +2,23 @@
 /**
  * Raw `IntersectionObserver` wrapper with automatic cleanup.
  * Use `createIsInViewport` for the common boolean case.
+ *
+ * The platform default is `root: null`, which observes intersections with
+ * the **viewport** — not with `target`'s nearest scrollable ancestor. For a
+ * sentinel inside an in-page scroll container, pass `root: containerEl`
+ * explicitly; otherwise the sentinel reads as "intersecting" the viewport
+ * and fires immediately and repeatedly.
+ *
+ * @example
+ * ```ts
+ * // In-page scroll container — pass `root` so intersection is computed
+ * // against the container's scrollport, not the viewport.
+ * createIntersectionObserver(
+ *   sentinelEl,
+ *   ([entry]) => { if (entry.isIntersecting) loadMore.run(); },
+ *   { root: containerEl, rootMargin: "100px" },
+ * );
+ * ```
  */
 declare function createIntersectionObserver(target: Element, callback: IntersectionObserverCallback, options?: IntersectionObserverInit): Disposable;
 //#endregion

package/dist/utilities/intersection-observer.mjs

@@ -3,6 +3,23 @@ import { observe } from "./_observe.mjs";
 /**
 * Raw `IntersectionObserver` wrapper with automatic cleanup.
 * Use `createIsInViewport` for the common boolean case.
+*
+* The platform default is `root: null`, which observes intersections with
+* the **viewport** — not with `target`'s nearest scrollable ancestor. For a
+* sentinel inside an in-page scroll container, pass `root: containerEl`
+* explicitly; otherwise the sentinel reads as "intersecting" the viewport
+* and fires immediately and repeatedly.
+*
+* @example
+* ```ts
+* // In-page scroll container — pass `root` so intersection is computed
+* // against the container's scrollport, not the viewport.
+* createIntersectionObserver(
+*   sentinelEl,
+*   ([entry]) => { if (entry.isIntersecting) loadMore.run(); },
+*   { root: containerEl, rootMargin: "100px" },
+* );
+* ```
 */
 function createIntersectionObserver(target, callback, options) {
 	return observe(new IntersectionObserver(callback, options), (o) => {

package/dist/utilities/intersection-observer.test.mjs

@@ -1,7 +1,7 @@
 import { c as effectScope } from "../lib-CVfOddra.mjs";
 import "../signals/index.mjs";
-import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-COK1VBpH.mjs";
-import { n as vi, t as globalExpect } from "../test.BmQO5GaM-C8YqghE0.mjs";
+import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-CsUg-gW0.mjs";
+import { n as vi, t as globalExpect } from "../test.BmQO5GaM-ZC2MPXQb.mjs";
 import { createIntersectionObserver } from "./intersection-observer.mjs";
 //#region src/utilities/intersection-observer.test.ts
 afterEach(() => {

package/dist/utilities/interval.d.mts

@@ -1,4 +1,4 @@
-import { y as Computed } from "../infer-BUUWMoG9.mjs";
+import { y as Computed } from "../infer-LDn1TquI.mjs";
 
 //#region src/utilities/interval.d.ts
 type IntervalResult = {

package/dist/utilities/interval.test.mjs

@@ -1,7 +1,7 @@
 import { c as effectScope } from "../lib-CVfOddra.mjs";
 import "../signals/index.mjs";
-import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-COK1VBpH.mjs";
-import { n as vi, t as globalExpect } from "../test.BmQO5GaM-C8YqghE0.mjs";
+import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-CsUg-gW0.mjs";
+import { n as vi, t as globalExpect } from "../test.BmQO5GaM-ZC2MPXQb.mjs";
 import { async } from "./async.mjs";
 import { createInterval } from "./interval.mjs";
 //#region src/utilities/interval.test.ts

package/dist/utilities/location.d.mts

@@ -1,4 +1,4 @@
-import { y as Computed } from "../infer-BUUWMoG9.mjs";
+import { y as Computed } from "../infer-LDn1TquI.mjs";
 
 //#region src/utilities/location.d.ts
 type LocationResult = {

package/dist/utilities/location.test.mjs

@@ -1,5 +1,5 @@
-import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-COK1VBpH.mjs";
-import { t as globalExpect } from "../test.BmQO5GaM-C8YqghE0.mjs";
+import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-CsUg-gW0.mjs";
+import { t as globalExpect } from "../test.BmQO5GaM-ZC2MPXQb.mjs";
 import { currentLocation } from "./location.mjs";
 //#region src/utilities/location.test.ts
 afterEach(() => {

package/dist/utilities/long-press.test.mjs

@@ -1,7 +1,7 @@
 import { c as effectScope } from "../lib-CVfOddra.mjs";
 import "../signals/index.mjs";
-import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-COK1VBpH.mjs";
-import { n as vi, t as globalExpect } from "../test.BmQO5GaM-C8YqghE0.mjs";
+import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-CsUg-gW0.mjs";
+import { n as vi, t as globalExpect } from "../test.BmQO5GaM-ZC2MPXQb.mjs";
 import { createLongPress } from "./long-press.mjs";
 //#region src/utilities/long-press.test.ts
 afterEach(() => {

package/dist/utilities/media-devices.d.mts

@@ -1,4 +1,4 @@
-import { y as Computed } from "../infer-BUUWMoG9.mjs";
+import { y as Computed } from "../infer-LDn1TquI.mjs";
 
 //#region src/utilities/media-devices.d.ts
 /**

package/dist/utilities/media-devices.test.mjs

@@ -1,7 +1,7 @@
 import { c as effectScope } from "../lib-CVfOddra.mjs";
 import "../signals/index.mjs";
-import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-COK1VBpH.mjs";
-import { n as vi, t as globalExpect } from "../test.BmQO5GaM-C8YqghE0.mjs";
+import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-CsUg-gW0.mjs";
+import { n as vi, t as globalExpect } from "../test.BmQO5GaM-ZC2MPXQb.mjs";
 import { createMediaDevices } from "./media-devices.mjs";
 //#region src/utilities/media-devices.test.ts
 afterEach(() => {

package/dist/utilities/media-player.d.mts

@@ -1,4 +1,4 @@
-import { x as Signal, y as Computed } from "../infer-BUUWMoG9.mjs";
+import { x as Signal, y as Computed } from "../infer-LDn1TquI.mjs";
 
 //#region src/utilities/media-player.d.ts
 type MediaPlayerResult<T extends HTMLMediaElement> = {

package/dist/utilities/media-player.test.mjs

@@ -1,7 +1,7 @@
 import { c as effectScope } from "../lib-CVfOddra.mjs";
 import "../signals/index.mjs";
-import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-COK1VBpH.mjs";
-import { n as vi, t as globalExpect } from "../test.BmQO5GaM-C8YqghE0.mjs";
+import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-CsUg-gW0.mjs";
+import { n as vi, t as globalExpect } from "../test.BmQO5GaM-ZC2MPXQb.mjs";
 import { createMediaPlayer } from "./media-player.mjs";
 //#region src/utilities/media-player.test.ts
 afterEach(() => {

package/dist/utilities/media-query.d.mts

@@ -1,4 +1,4 @@
-import { y as Computed } from "../infer-BUUWMoG9.mjs";
+import { y as Computed } from "../infer-LDn1TquI.mjs";
 
 //#region src/utilities/media-query.d.ts
 /**

package/dist/utilities/mutation-observer.test.mjs

@@ -1,7 +1,7 @@
 import { c as effectScope } from "../lib-CVfOddra.mjs";
 import "../signals/index.mjs";
-import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-COK1VBpH.mjs";
-import { n as vi, t as globalExpect } from "../test.BmQO5GaM-C8YqghE0.mjs";
+import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-CsUg-gW0.mjs";
+import { n as vi, t as globalExpect } from "../test.BmQO5GaM-ZC2MPXQb.mjs";
 import { createMutationObserver } from "./mutation-observer.mjs";
 //#region src/utilities/mutation-observer.test.ts
 afterEach(() => {

package/dist/utilities/network.d.mts

@@ -1,4 +1,4 @@
-import { y as Computed } from "../infer-BUUWMoG9.mjs";
+import { y as Computed } from "../infer-LDn1TquI.mjs";
 
 //#region src/utilities/network.d.ts
 /**

package/dist/utilities/network.test.mjs

@@ -1,5 +1,5 @@
-import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-COK1VBpH.mjs";
-import { n as vi, t as globalExpect } from "../test.BmQO5GaM-C8YqghE0.mjs";
+import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-CsUg-gW0.mjs";
+import { n as vi, t as globalExpect } from "../test.BmQO5GaM-ZC2MPXQb.mjs";
 import { online } from "./network.mjs";
 //#region src/utilities/network.test.ts
 afterEach(() => {

package/dist/utilities/on-click-outside.test.mjs

@@ -1,7 +1,7 @@
 import { c as effectScope } from "../lib-CVfOddra.mjs";
 import "../signals/index.mjs";
-import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-COK1VBpH.mjs";
-import { n as vi, t as globalExpect } from "../test.BmQO5GaM-C8YqghE0.mjs";
+import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-CsUg-gW0.mjs";
+import { n as vi, t as globalExpect } from "../test.BmQO5GaM-ZC2MPXQb.mjs";
 import { onClickOutside } from "./on-click-outside.mjs";
 //#region src/utilities/on-click-outside.test.ts
 afterEach(() => {

package/dist/utilities/orientation.d.mts

@@ -1,4 +1,4 @@
-import { y as Computed } from "../infer-BUUWMoG9.mjs";
+import { y as Computed } from "../infer-LDn1TquI.mjs";
 
 //#region src/utilities/orientation.d.ts
 type OrientationResult = {

package/dist/utilities/previous.d.mts

@@ -1,4 +1,4 @@
-import { y as Computed } from "../infer-BUUWMoG9.mjs";
+import { y as Computed } from "../infer-LDn1TquI.mjs";
 
 //#region src/utilities/previous.d.ts
 /**

package/dist/utilities/previous.test.mjs

@@ -1,7 +1,7 @@
 import { c as effectScope, m as signal } from "../lib-CVfOddra.mjs";
 import "../signals/index.mjs";
-import { f as it, l as describe } from "../benchmark.CX_oY03V-COK1VBpH.mjs";
-import { t as globalExpect } from "../test.BmQO5GaM-C8YqghE0.mjs";
+import { f as it, l as describe } from "../benchmark.CX_oY03V-CsUg-gW0.mjs";
+import { t as globalExpect } from "../test.BmQO5GaM-ZC2MPXQb.mjs";
 import { createPrevious } from "./previous.mjs";
 //#region src/utilities/previous.test.ts
 describe("createPrevious", () => {

package/dist/utilities/promise.d.mts

@@ -1,4 +1,4 @@
-import { y as Computed } from "../infer-BUUWMoG9.mjs";
+import { y as Computed } from "../infer-LDn1TquI.mjs";
 
 //#region src/utilities/promise.d.ts
 /**

package/dist/utilities/promise.test.mjs

@@ -1,7 +1,7 @@
 import { s as effect } from "../lib-CVfOddra.mjs";
 import "../signals/index.mjs";
-import { f as it, l as describe } from "../benchmark.CX_oY03V-COK1VBpH.mjs";
-import { t as globalExpect } from "../test.BmQO5GaM-C8YqghE0.mjs";
+import { f as it, l as describe } from "../benchmark.CX_oY03V-CsUg-gW0.mjs";
+import { t as globalExpect } from "../test.BmQO5GaM-ZC2MPXQb.mjs";
 import { ReactivePromise, promise } from "./promise.mjs";
 //#region src/utilities/promise.test.ts
 describe("ReactivePromise", () => {

package/dist/utilities/retry.test.mjs

@@ -1,7 +1,7 @@
 import { p as onCleanup } from "../lib-CVfOddra.mjs";
 import "../signals/index.mjs";
-import { f as it, l as describe } from "../benchmark.CX_oY03V-COK1VBpH.mjs";
-import { n as vi, t as globalExpect } from "../test.BmQO5GaM-C8YqghE0.mjs";
+import { f as it, l as describe } from "../benchmark.CX_oY03V-CsUg-gW0.mjs";
+import { n as vi, t as globalExpect } from "../test.BmQO5GaM-ZC2MPXQb.mjs";
 import { retry } from "./retry.mjs";
 //#region src/utilities/retry.test.ts
 describe("retry", () => {

package/dist/utilities/routing.d.mts

@@ -1,4 +1,4 @@
-import { y as Computed } from "../infer-BUUWMoG9.mjs";
+import { y as Computed } from "../infer-LDn1TquI.mjs";
 
 //#region src/utilities/routing.d.ts
 /**

package/dist/utilities/routing.test.mjs

@@ -1,5 +1,5 @@
-import { f as it, l as describe, o as afterEach, s as beforeAll } from "../benchmark.CX_oY03V-COK1VBpH.mjs";
-import { n as vi, t as globalExpect } from "../test.BmQO5GaM-C8YqghE0.mjs";
+import { f as it, l as describe, o as afterEach, s as beforeAll } from "../benchmark.CX_oY03V-CsUg-gW0.mjs";
+import { n as vi, t as globalExpect } from "../test.BmQO5GaM-ZC2MPXQb.mjs";
 import { isLocalNavigationEvent, match, matches, navigate, patchHistory } from "./routing.mjs";
 //#region src/utilities/routing.test.ts
 beforeAll(() => {

package/dist/utilities/search-params.d.mts

@@ -1,4 +1,4 @@
-import { y as Computed } from "../infer-BUUWMoG9.mjs";
+import { y as Computed } from "../infer-LDn1TquI.mjs";
 
 //#region src/utilities/search-params.d.ts
 /**

package/dist/utilities/search-params.test.mjs

@@ -1,7 +1,7 @@
 import { c as effectScope } from "../lib-CVfOddra.mjs";
 import "../signals/index.mjs";
-import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-COK1VBpH.mjs";
-import { t as globalExpect } from "../test.BmQO5GaM-C8YqghE0.mjs";
+import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-CsUg-gW0.mjs";
+import { t as globalExpect } from "../test.BmQO5GaM-ZC2MPXQb.mjs";
 import { createSearchParam } from "./search-params.mjs";
 //#region src/utilities/search-params.test.ts
 afterEach(() => {

package/dist/utilities/ssr.test.mjs

@@ -1,5 +1,5 @@
-import { p as test } from "../benchmark.CX_oY03V-COK1VBpH.mjs";
-import { t as globalExpect } from "../test.BmQO5GaM-C8YqghE0.mjs";
+import { p as test } from "../benchmark.CX_oY03V-CsUg-gW0.mjs";
+import { t as globalExpect } from "../test.BmQO5GaM-ZC2MPXQb.mjs";
 //#region src/utilities/ssr.test.ts
 // @vitest-environment node
 test.each([

package/dist/utilities/storage.d.mts

@@ -1,4 +1,4 @@
-import { x as Signal } from "../infer-BUUWMoG9.mjs";
+import { x as Signal } from "../infer-LDn1TquI.mjs";
 
 //#region src/utilities/storage.d.ts
 type StorageOptions<T> = {

package/dist/utilities/storage.test.mjs

@@ -1,7 +1,7 @@
 import { c as effectScope } from "../lib-CVfOddra.mjs";
 import "../signals/index.mjs";
-import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-COK1VBpH.mjs";
-import { t as globalExpect } from "../test.BmQO5GaM-C8YqghE0.mjs";
+import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-CsUg-gW0.mjs";
+import { t as globalExpect } from "../test.BmQO5GaM-ZC2MPXQb.mjs";
 import { createLocalStorage, createSessionStorage } from "./storage.mjs";
 //#region src/utilities/storage.test.ts
 describe("createLocalStorage", () => {

package/dist/utilities/throttled.d.mts

@@ -1,4 +1,4 @@
-import { y as Computed } from "../infer-BUUWMoG9.mjs";
+import { y as Computed } from "../infer-LDn1TquI.mjs";
 
 //#region src/utilities/throttled.d.ts
 /**

package/dist/utilities/throttled.test.mjs

@@ -1,7 +1,7 @@
 import { c as effectScope, m as signal } from "../lib-CVfOddra.mjs";
 import "../signals/index.mjs";
-import { c as beforeEach, f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-COK1VBpH.mjs";
-import { n as vi, t as globalExpect } from "../test.BmQO5GaM-C8YqghE0.mjs";
+import { c as beforeEach, f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-CsUg-gW0.mjs";
+import { n as vi, t as globalExpect } from "../test.BmQO5GaM-ZC2MPXQb.mjs";
 import { createThrottled } from "./throttled.mjs";
 //#region src/utilities/throttled.test.ts
 beforeEach(() => {

package/dist/utilities/timeout.d.mts

@@ -1,4 +1,4 @@
-import { y as Computed } from "../infer-BUUWMoG9.mjs";
+import { y as Computed } from "../infer-LDn1TquI.mjs";
 
 //#region src/utilities/timeout.d.ts
 type TimeoutResult = {

package/dist/utilities/timeout.test.mjs

@@ -1,7 +1,7 @@
 import { c as effectScope } from "../lib-CVfOddra.mjs";
 import "../signals/index.mjs";
-import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-COK1VBpH.mjs";
-import { n as vi, t as globalExpect } from "../test.BmQO5GaM-C8YqghE0.mjs";
+import { f as it, l as describe, o as afterEach } from "../benchmark.CX_oY03V-CsUg-gW0.mjs";
+import { n as vi, t as globalExpect } from "../test.BmQO5GaM-ZC2MPXQb.mjs";
 import { createTimeout } from "./timeout.mjs";
 //#region src/utilities/timeout.test.ts
 afterEach(() => {

package/dist/utilities/window-focus.d.mts

@@ -1,4 +1,4 @@
-import { y as Computed } from "../infer-BUUWMoG9.mjs";
+import { y as Computed } from "../infer-LDn1TquI.mjs";
 
 //#region src/utilities/window-focus.d.ts
 /**

package/dist/utilities/window-size.d.mts

@@ -1,4 +1,4 @@
-import { y as Computed } from "../infer-BUUWMoG9.mjs";
+import { y as Computed } from "../infer-LDn1TquI.mjs";
 
 //#region src/utilities/window-size.d.ts
 type WindowSizeResult = {

package/dist/utilities/window-size.test.mjs

@@ -1,5 +1,5 @@
-import { f as it, l as describe } from "../benchmark.CX_oY03V-COK1VBpH.mjs";
-import { t as globalExpect } from "../test.BmQO5GaM-C8YqghE0.mjs";
+import { f as it, l as describe } from "../benchmark.CX_oY03V-CsUg-gW0.mjs";
+import { t as globalExpect } from "../test.BmQO5GaM-ZC2MPXQb.mjs";
 import { windowSize } from "./window-size.mjs";
 //#region src/utilities/window-size.test.ts
 describe("windowSize (singleton)", () => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "elements-kit",
   "type": "module",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "A lightweight reactive UI library that transforms native HTMLElements into reactive components with signals. Ideal for framework-agnostic applications and web components.",
   "keywords": [
     "webcomponents",

package/dist/custom-elements-CBuenqVD.d.mts

@@ -1,41 +0,0 @@
-//#region src/custom-elements.d.ts
-/**
- * Registry of custom-element tags to their constructors.
- * Users augment this interface to add typed JSX support for their elements:
- *
- * @example
- * ```ts
- * declare module "elements-kit/custom-elements" {
- *   interface CustomElementRegistry {
- *     "x-range": typeof XRange;
- *   }
- * }
- * ```
- */
-interface CustomElementRegistry {}
-type AnyCtor = CustomElementConstructor;
-/**
- * Register a custom element with the browser and return its class.
- * Pair with a module augmentation of `CustomElementRegistry` to get typed JSX.
- *
- * @example
- * ```tsx
- * import { defineElement } from "elements-kit/custom-elements";
- *
- * class XCounter extends HTMLElement {}
- *
- * defineElement("x-counter", XCounter);
- *
- * declare module "elements-kit/custom-elements" {
- *   interface CustomElementRegistry {
- *     "x-counter": typeof XCounter;
- *   }
- * }
- *
- * // JSX now gets typed props + typed ref
- * // <x-counter />
- * ```
- */
-declare function defineElement<Tag extends `${string}-${string}`, C extends AnyCtor>(tag: Tag, cls: C, options?: ElementDefinitionOptions): C;
-//#endregion
-export { defineElement as n, CustomElementRegistry as t };