elements-kit 0.0.18 → 0.0.20

package/dist/utilities/async.mjs

@@ -1,6 +1,27 @@
-import { b as untracked, d as effect, r as resolve, v as signal } from "../signals-J8dK_rA4.mjs";
+import { g as untracked, m as signal, s as effect } from "../lib-D6duEs38.mjs";
+import { resolve } from "../signals/index.mjs";
 import { promise } from "./promise.mjs";
 //#region src/utilities/async.ts
+/**
+* Reactive wrapper around an async function. Exposes the current run as
+* reactive signals (`state`, `value`, `reason`, `result`, `pending`) and
+* lets you `run`/`start`/`stop` the underlying task imperatively.
+*
+* 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.
+*
+* @example
+* ```ts
+* import { Async } from "elements-kit/utilities/async";
+*
+* const loader = new Async<string, User>(fetchUser);
+* loader.run("alice");
+* effect(() => {
+*   if (loader.state === "fulfilled") console.log(loader.value);
+* });
+* ```
+*/
 var Async = class {
 	#fn = signal(async () => Promise.resolve(void 0));
 	#cleanup = () => {};
@@ -96,6 +117,23 @@ const ASYNC_KEYS = new Set([
 	"raw",
 	Symbol.dispose
 ]);
+/**
+* Create an {@link Async} that is also callable as a signal: invoking it
+* (with no args) reads the current `result`, so it drops into any reactive
+* context that expects a zero-arg getter.
+*
+* @example
+* ```ts
+* import { async } from "elements-kit/utilities/async";
+*
+* const load = async((id: string) => fetch(`/u/${id}`).then(r => r.json()));
+* load.run("alice");
+*
+* // Read as a signal — subscribes to result changes
+* effect(() => console.log(load()));
+* await load; // Await the current run — works like a normal promise
+* ```
+*/
 function async(fn) {
 	const inst = new Async(fn);
 	const signal = () => inst.result;

package/dist/utilities/async.test.mjs

@@ -1,5 +1,6 @@
-import { _ as onCleanup, d as effect, v as signal } from "../signals-J8dK_rA4.mjs";
-import { n as vi, o as describe, s as it, t as globalExpect } from "../test.BmQO5GaM-DfGStnii.mjs";
+import { m as signal, p as onCleanup, s as effect } from "../lib-D6duEs38.mjs";
+import "../signals/index.mjs";
+import { n as vi, o as describe, s as it, t as globalExpect } from "../test.BmQO5GaM-BeO5pvCo.mjs";
 import { Async, async } from "./async.mjs";
 import { createInterval } from "./interval.mjs";
 //#region src/utilities/async.test.ts

package/dist/utilities/debounced.d.mts

@@ -1,4 +1,4 @@
-import { t as Computed } from "../index-DydGTqZU.mjs";
+import { y as Computed } from "../infer-DuFY-y2b.mjs";
 
 //#region src/utilities/debounced.d.ts
 /**
@@ -6,6 +6,17 @@ import { t as Computed } from "../index-DydGTqZU.mjs";
  * milliseconds of silence (i.e. no new values from `getter`).
  *
  * The initial value is read synchronously, so the computed is never undefined.
+ *
+ * @example
+ * ```ts
+ * import { signal } from "elements-kit/signals";
+ * import { createDebounced } from "elements-kit/utilities/debounced";
+ *
+ * const query = signal("");
+ * const debounced = createDebounced(query, 300);
+ *
+ * effect(() => fetch(`/search?q=${debounced()}`));
+ * ```
  */
 declare function createDebounced<T>(getter: () => T, delay: number | (() => number)): Computed<T>;
 //#endregion

package/dist/utilities/debounced.mjs

@@ -1,4 +1,5 @@
-import { d as effect, v as signal } from "../signals-J8dK_rA4.mjs";
+import { m as signal, s as effect } from "../lib-D6duEs38.mjs";
+import "../signals/index.mjs";
 import { createTimeout } from "./timeout.mjs";
 //#region src/utilities/debounced.ts
 /**
@@ -6,6 +7,17 @@ import { createTimeout } from "./timeout.mjs";
 * milliseconds of silence (i.e. no new values from `getter`).
 *
 * The initial value is read synchronously, so the computed is never undefined.
+*
+* @example
+* ```ts
+* import { signal } from "elements-kit/signals";
+* import { createDebounced } from "elements-kit/utilities/debounced";
+*
+* const query = signal("");
+* const debounced = createDebounced(query, 300);
+*
+* effect(() => fetch(`/search?q=${debounced()}`));
+* ```
 */
 function createDebounced(getter, delay) {
 	const s = signal(getter());

package/dist/utilities/debounced.test.mjs

@@ -1,5 +1,6 @@
-import { f as effectScope, v as signal } from "../signals-J8dK_rA4.mjs";
-import { a as beforeEach, n as vi, o as describe, r as afterEach, s as it, t as globalExpect } from "../test.BmQO5GaM-DfGStnii.mjs";
+import { c as effectScope, m as signal } from "../lib-D6duEs38.mjs";
+import "../signals/index.mjs";
+import { a as beforeEach, n as vi, o as describe, r as afterEach, s as it, t as globalExpect } from "../test.BmQO5GaM-BeO5pvCo.mjs";
 import { createDebounced } from "./debounced.mjs";
 //#region src/utilities/debounced.test.ts
 beforeEach(() => {

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

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

package/dist/utilities/element-rect.mjs

@@ -1,4 +1,5 @@
-import { v as signal } from "../signals-J8dK_rA4.mjs";
+import { m as signal } from "../lib-D6duEs38.mjs";
+import "../signals/index.mjs";
 import { createResizeObserver } from "./resize-observer.mjs";
 //#region src/utilities/element-rect.ts
 /**

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

@@ -1,5 +1,6 @@
-import { f as effectScope } from "../signals-J8dK_rA4.mjs";
-import { n as vi, o as describe, r as afterEach, s as it, t as globalExpect } from "../test.BmQO5GaM-DfGStnii.mjs";
+import { c as effectScope } from "../lib-D6duEs38.mjs";
+import "../signals/index.mjs";
+import { n as vi, o as describe, r as afterEach, s as it, t as globalExpect } from "../test.BmQO5GaM-BeO5pvCo.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 { r as Signal } from "../index-DydGTqZU.mjs";
+import { x as Signal } from "../infer-DuFY-y2b.mjs";
 
 //#region src/utilities/element-scroll.d.ts
 type ElementScrollResult = {

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

@@ -1,5 +1,6 @@
-import { f as effectScope } from "../signals-J8dK_rA4.mjs";
-import { o as describe, s as it, t as globalExpect } from "../test.BmQO5GaM-DfGStnii.mjs";
+import { c as effectScope } from "../lib-D6duEs38.mjs";
+import "../signals/index.mjs";
+import { o as describe, s as it, t as globalExpect } from "../test.BmQO5GaM-BeO5pvCo.mjs";
 import { createElementScroll } from "./element-scroll.mjs";
 //#region src/utilities/element-scroll.test.ts
 describe("createElementScroll", () => {

package/dist/utilities/environment.d.mts

@@ -1,5 +1,7 @@
 //#region src/utilities/environment.d.ts
+/** `true` when running in a browser (both `window` and `document` exist). */
 declare const isBrowser: boolean;
+/** A shared `Disposable` whose `Symbol.dispose` is a no-op — useful as a safe default. */
 declare const noopDisposable: Disposable;
 //#endregion
 export { isBrowser, noopDisposable };

package/dist/utilities/environment.mjs

@@ -1,5 +1,7 @@
 //#region src/utilities/environment.ts
+/** `true` when running in a browser (both `window` and `document` exist). */
 const isBrowser = typeof window !== "undefined" && typeof document !== "undefined";
+/** A shared `Disposable` whose `Symbol.dispose` is a no-op — useful as a safe default. */
 const noopDisposable = { [Symbol.dispose]() {} };
 //#endregion
 export { isBrowser, noopDisposable };

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

@@ -1,4 +1,4 @@
-import { r as Signal, t as Computed } from "../index-DydGTqZU.mjs";
+import { x as Signal, y as Computed } from "../infer-DuFY-y2b.mjs";
 
 //#region src/utilities/event-driven.d.ts
 /**

package/dist/utilities/event-driven.mjs

@@ -1,4 +1,5 @@
-import { _ as onCleanup, c as SIGNAL, u as computed, v as signal, y as trigger } from "../signals-J8dK_rA4.mjs";
+import { h as trigger, i as SIGNAL, m as signal, o as computed, p as onCleanup } from "../lib-D6duEs38.mjs";
+import "../signals/index.mjs";
 //#region src/utilities/event-driven.ts
 /**
 * Returns a `Subscribe` for one or more DOM events on a target.

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

@@ -1,4 +1,4 @@
-import { t as Computed } from "../index-DydGTqZU.mjs";
+import { y as Computed } from "../infer-DuFY-y2b.mjs";
 
 //#region src/utilities/event-listener.d.ts
 /**
@@ -7,6 +7,17 @@ import { t as Computed } from "../index-DydGTqZU.mjs";
  * When called inside an `effect` or `effectScope` the listener is removed
  * when the scope is disposed.  When the target is a reactive getter the
  * listener is re-registered whenever the target changes.
+ *
+ * @example
+ * ```ts
+ * import { on } from "elements-kit/utilities/event-listener";
+ *
+ * // Static target — listener removed when the enclosing scope ends
+ * on(window, "resize", () => console.log(window.innerWidth));
+ *
+ * // Reactive target — listener follows the current element
+ * on(activeElement, "focus", () => console.log("focused"));
+ * ```
  */
 declare function on<K extends keyof HTMLElementEventMap>(target: HTMLElement | Computed<HTMLElement | null>, type: K, handler: (e: HTMLElementEventMap[K]) => void, options?: AddEventListenerOptions): () => void;
 declare function on<K extends keyof DocumentEventMap>(target: Document | Computed<Document | null>, type: K, handler: (e: DocumentEventMap[K]) => void, options?: AddEventListenerOptions): () => void;

package/dist/utilities/event-listener.mjs

@@ -1,4 +1,5 @@
-import { _ as onCleanup, d as effect } from "../signals-J8dK_rA4.mjs";
+import { p as onCleanup, s as effect } from "../lib-D6duEs38.mjs";
+import "../signals/index.mjs";
 //#region src/utilities/event-listener.ts
 function on(target, type, handler, options) {
 	const add = (t) => options !== void 0 ? t.addEventListener(type, handler, options) : t.addEventListener(type, handler);

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

@@ -1,6 +1,7 @@
-import { d as effect, f as effectScope, v as signal } from "../signals-J8dK_rA4.mjs";
+import { c as effectScope, m as signal, s as effect } from "../lib-D6duEs38.mjs";
+import "../signals/index.mjs";
 import { on } from "./event-listener.mjs";
-import { n as vi, o as describe, r as afterEach, s as it, t as globalExpect } from "../test.BmQO5GaM-DfGStnii.mjs";
+import { n as vi, o as describe, r as afterEach, s as it, t as globalExpect } from "../test.BmQO5GaM-BeO5pvCo.mjs";
 //#region src/utilities/event-listener.test.ts
 afterEach(() => {
 	document.body.innerHTML = "";

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

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

package/dist/utilities/focus-within.mjs

@@ -1,4 +1,5 @@
-import { v as signal } from "../signals-J8dK_rA4.mjs";
+import { m as signal } from "../lib-D6duEs38.mjs";
+import "../signals/index.mjs";
 import { on } from "./event-listener.mjs";
 //#region src/utilities/focus-within.ts
 /**

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

@@ -1,5 +1,6 @@
-import { f as effectScope } from "../signals-J8dK_rA4.mjs";
-import { o as describe, r as afterEach, s as it, t as globalExpect } from "../test.BmQO5GaM-DfGStnii.mjs";
+import { c as effectScope } from "../lib-D6duEs38.mjs";
+import "../signals/index.mjs";
+import { o as describe, r as afterEach, s as it, t as globalExpect } from "../test.BmQO5GaM-BeO5pvCo.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 { t as Computed } from "../index-DydGTqZU.mjs";
+import { y as Computed } from "../infer-DuFY-y2b.mjs";
 
 //#region src/utilities/hover.d.ts
 /**

package/dist/utilities/hover.mjs

@@ -1,4 +1,5 @@
-import { v as signal } from "../signals-J8dK_rA4.mjs";
+import { m as signal } from "../lib-D6duEs38.mjs";
+import "../signals/index.mjs";
 import { on } from "./event-listener.mjs";
 //#region src/utilities/hover.ts
 /**

package/dist/utilities/hover.test.mjs

@@ -1,5 +1,6 @@
-import { f as effectScope } from "../signals-J8dK_rA4.mjs";
-import { n as vi, o as describe, r as afterEach, s as it, t as globalExpect } from "../test.BmQO5GaM-DfGStnii.mjs";
+import { c as effectScope } from "../lib-D6duEs38.mjs";
+import "../signals/index.mjs";
+import { n as vi, o as describe, r as afterEach, s as it, t as globalExpect } from "../test.BmQO5GaM-BeO5pvCo.mjs";
 import { createHover } from "./hover.mjs";
 //#region src/utilities/hover.test.ts
 afterEach(() => {

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

@@ -1,5 +1,6 @@
-import { f as effectScope } from "../signals-J8dK_rA4.mjs";
-import { n as vi, o as describe, r as afterEach, s as it, t as globalExpect } from "../test.BmQO5GaM-DfGStnii.mjs";
+import { c as effectScope } from "../lib-D6duEs38.mjs";
+import "../signals/index.mjs";
+import { n as vi, o as describe, r as afterEach, s as it, t as globalExpect } from "../test.BmQO5GaM-BeO5pvCo.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 { t as Computed } from "../index-DydGTqZU.mjs";
+import { y as Computed } from "../infer-DuFY-y2b.mjs";
 
 //#region src/utilities/interval.d.ts
 type IntervalResult = {
@@ -12,6 +12,19 @@ type Fn = () => void;
 type Delay = number | (() => number);
 /**
  * Pausable `setInterval` wrapper.  Starts running immediately on creation.
+ *
+ * @example
+ * ```ts
+ * import { createInterval } from "elements-kit/utilities/interval";
+ *
+ * // Reactive clock — updates a signal every second
+ * const { timestamp, stop } = createInterval(1000);
+ * effect(() => console.log(new Date(timestamp())));
+ *
+ * // With a callback
+ * const beat = createInterval(() => beatCount(beatCount() + 1), 500);
+ * beat.stop();
+ * ```
  */
 declare function createInterval(delay: Delay): IntervalResult;
 declare function createInterval(callback: Fn, delay: Delay): IntervalResult;

package/dist/utilities/interval.mjs

@@ -1,4 +1,5 @@
-import { _ as onCleanup, v as signal } from "../signals-J8dK_rA4.mjs";
+import { m as signal, p as onCleanup } from "../lib-D6duEs38.mjs";
+import "../signals/index.mjs";
 //#region src/utilities/interval.ts
 function createInterval(arg1, arg2) {
 	const [callback, delay] = resolveArgs(arg1, arg2);

package/dist/utilities/interval.test.mjs

@@ -1,5 +1,6 @@
-import { f as effectScope } from "../signals-J8dK_rA4.mjs";
-import { n as vi, o as describe, r as afterEach, s as it, t as globalExpect } from "../test.BmQO5GaM-DfGStnii.mjs";
+import { c as effectScope } from "../lib-D6duEs38.mjs";
+import "../signals/index.mjs";
+import { n as vi, o as describe, r as afterEach, s as it, t as globalExpect } from "../test.BmQO5GaM-BeO5pvCo.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 { t as Computed } from "../index-DydGTqZU.mjs";
+import { y as Computed } from "../infer-DuFY-y2b.mjs";
 
 //#region src/utilities/location.d.ts
 type LocationResult = {

package/dist/utilities/location.mjs

@@ -1,4 +1,5 @@
-import { _ as onCleanup, u as computed, v as signal, y as trigger } from "../signals-J8dK_rA4.mjs";
+import { h as trigger, m as signal, o as computed, p as onCleanup } from "../lib-D6duEs38.mjs";
+import "../signals/index.mjs";
 import { fromEvent } from "./event-driven.mjs";
 import { isBrowser } from "./environment.mjs";
 //#region src/utilities/location.ts

package/dist/utilities/location.test.mjs

@@ -1,4 +1,4 @@
-import { o as describe, r as afterEach, s as it, t as globalExpect } from "../test.BmQO5GaM-DfGStnii.mjs";
+import { o as describe, r as afterEach, s as it, t as globalExpect } from "../test.BmQO5GaM-BeO5pvCo.mjs";
 import { currentLocation } from "./location.mjs";
 //#region src/utilities/location.test.ts
 afterEach(() => {

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

@@ -1,5 +1,6 @@
-import { f as effectScope } from "../signals-J8dK_rA4.mjs";
-import { n as vi, o as describe, r as afterEach, s as it, t as globalExpect } from "../test.BmQO5GaM-DfGStnii.mjs";
+import { c as effectScope } from "../lib-D6duEs38.mjs";
+import "../signals/index.mjs";
+import { n as vi, o as describe, r as afterEach, s as it, t as globalExpect } from "../test.BmQO5GaM-BeO5pvCo.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 { t as Computed } from "../index-DydGTqZU.mjs";
+import { y as Computed } from "../infer-DuFY-y2b.mjs";
 
 //#region src/utilities/media-devices.d.ts
 /**

package/dist/utilities/media-devices.mjs

@@ -1,4 +1,5 @@
-import { v as signal } from "../signals-J8dK_rA4.mjs";
+import { m as signal } from "../lib-D6duEs38.mjs";
+import "../signals/index.mjs";
 import { on } from "./event-listener.mjs";
 //#region src/utilities/media-devices.ts
 /**

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

@@ -1,5 +1,6 @@
-import { f as effectScope } from "../signals-J8dK_rA4.mjs";
-import { n as vi, o as describe, r as afterEach, s as it, t as globalExpect } from "../test.BmQO5GaM-DfGStnii.mjs";
+import { c as effectScope } from "../lib-D6duEs38.mjs";
+import "../signals/index.mjs";
+import { n as vi, o as describe, r as afterEach, s as it, t as globalExpect } from "../test.BmQO5GaM-BeO5pvCo.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 { r as Signal, t as Computed } from "../index-DydGTqZU.mjs";
+import { x as Signal, y as Computed } from "../infer-DuFY-y2b.mjs";
 
 //#region src/utilities/media-player.d.ts
 type MediaPlayerResult<T extends HTMLMediaElement> = {

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

@@ -1,5 +1,6 @@
-import { f as effectScope } from "../signals-J8dK_rA4.mjs";
-import { n as vi, o as describe, r as afterEach, s as it, t as globalExpect } from "../test.BmQO5GaM-DfGStnii.mjs";
+import { c as effectScope } from "../lib-D6duEs38.mjs";
+import "../signals/index.mjs";
+import { n as vi, o as describe, r as afterEach, s as it, t as globalExpect } from "../test.BmQO5GaM-BeO5pvCo.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 { t as Computed } from "../index-DydGTqZU.mjs";
+import { y as Computed } from "../infer-DuFY-y2b.mjs";
 
 //#region src/utilities/media-query.d.ts
 /**

package/dist/utilities/media-query.mjs

@@ -1,4 +1,5 @@
-import { v as signal } from "../signals-J8dK_rA4.mjs";
+import { m as signal } from "../lib-D6duEs38.mjs";
+import "../signals/index.mjs";
 import { fromEvent, sync } from "./event-driven.mjs";
 import { isBrowser } from "./environment.mjs";
 //#region src/utilities/media-query.ts

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

@@ -1,5 +1,6 @@
-import { f as effectScope } from "../signals-J8dK_rA4.mjs";
-import { n as vi, o as describe, r as afterEach, s as it, t as globalExpect } from "../test.BmQO5GaM-DfGStnii.mjs";
+import { c as effectScope } from "../lib-D6duEs38.mjs";
+import "../signals/index.mjs";
+import { n as vi, o as describe, r as afterEach, s as it, t as globalExpect } from "../test.BmQO5GaM-BeO5pvCo.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 { t as Computed } from "../index-DydGTqZU.mjs";
+import { y as Computed } from "../infer-DuFY-y2b.mjs";
 
 //#region src/utilities/network.d.ts
 /**

package/dist/utilities/network.mjs

@@ -1,4 +1,5 @@
-import { v as signal } from "../signals-J8dK_rA4.mjs";
+import { m as signal } from "../lib-D6duEs38.mjs";
+import "../signals/index.mjs";
 import { on } from "./event-listener.mjs";
 import { isBrowser } from "./environment.mjs";
 //#region src/utilities/network.ts

package/dist/utilities/network.test.mjs

@@ -1,4 +1,4 @@
-import { n as vi, o as describe, r as afterEach, s as it, t as globalExpect } from "../test.BmQO5GaM-DfGStnii.mjs";
+import { n as vi, o as describe, r as afterEach, s as it, t as globalExpect } from "../test.BmQO5GaM-BeO5pvCo.mjs";
 import { online } from "./network.mjs";
 //#region src/utilities/network.test.ts
 afterEach(() => {

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

@@ -1,5 +1,6 @@
-import { f as effectScope } from "../signals-J8dK_rA4.mjs";
-import { n as vi, o as describe, r as afterEach, s as it, t as globalExpect } from "../test.BmQO5GaM-DfGStnii.mjs";
+import { c as effectScope } from "../lib-D6duEs38.mjs";
+import "../signals/index.mjs";
+import { n as vi, o as describe, r as afterEach, s as it, t as globalExpect } from "../test.BmQO5GaM-BeO5pvCo.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 { t as Computed } from "../index-DydGTqZU.mjs";
+import { y as Computed } from "../infer-DuFY-y2b.mjs";
 
 //#region src/utilities/orientation.d.ts
 type OrientationResult = {

package/dist/utilities/orientation.mjs

@@ -1,4 +1,5 @@
-import { u as computed } from "../signals-J8dK_rA4.mjs";
+import { o as computed } from "../lib-D6duEs38.mjs";
+import "../signals/index.mjs";
 import { fromEvent, sync } from "./event-driven.mjs";
 import { isBrowser } from "./environment.mjs";
 //#region src/utilities/orientation.ts

package/dist/utilities/previous.d.mts

@@ -1,4 +1,4 @@
-import { t as Computed } from "../index-DydGTqZU.mjs";
+import { y as Computed } from "../infer-DuFY-y2b.mjs";
 
 //#region src/utilities/previous.d.ts
 /**
@@ -6,6 +6,18 @@ import { t as Computed } from "../index-DydGTqZU.mjs";
  * Starts as `undefined` until the source changes for the first time.
  *
  * When `ignore` is provided, the previous value only updates when the ignore check fails.
+ *
+ * @example
+ * ```ts
+ * import { signal } from "elements-kit/signals";
+ * import { createPrevious } from "elements-kit/utilities/previous";
+ *
+ * const count = signal(0);
+ * const prev = createPrevious(count);
+ *
+ * count(1); prev(); // 0
+ * count(2); prev(); // 1
+ * ```
  */
 declare function createPrevious<T>(source: Computed<T>, ignore?: (a: T, b: T) => boolean): Computed<T | undefined>;
 //#endregion

package/dist/utilities/previous.mjs

@@ -1,10 +1,23 @@
-import { d as effect, v as signal } from "../signals-J8dK_rA4.mjs";
+import { m as signal, s as effect } from "../lib-D6duEs38.mjs";
+import "../signals/index.mjs";
 //#region src/utilities/previous.ts
 /**
 * Returns a `Computed` that always holds the *previous* value of `source`.
 * Starts as `undefined` until the source changes for the first time.
 *
 * When `ignore` is provided, the previous value only updates when the ignore check fails.
+*
+* @example
+* ```ts
+* import { signal } from "elements-kit/signals";
+* import { createPrevious } from "elements-kit/utilities/previous";
+*
+* const count = signal(0);
+* const prev = createPrevious(count);
+*
+* count(1); prev(); // 0
+* count(2); prev(); // 1
+* ```
 */
 function createPrevious(source, ignore) {
 	const prev = signal(void 0);

package/dist/utilities/previous.test.mjs

@@ -1,5 +1,6 @@
-import { f as effectScope, v as signal } from "../signals-J8dK_rA4.mjs";
-import { o as describe, s as it, t as globalExpect } from "../test.BmQO5GaM-DfGStnii.mjs";
+import { c as effectScope, m as signal } from "../lib-D6duEs38.mjs";
+import "../signals/index.mjs";
+import { o as describe, s as it, t as globalExpect } from "../test.BmQO5GaM-BeO5pvCo.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 { t as Computed } from "../index-DydGTqZU.mjs";
+import { y as Computed } from "../infer-DuFY-y2b.mjs";
 
 //#region src/utilities/promise.d.ts
 /**
@@ -28,6 +28,12 @@ declare class ReactivePromise<T, E = unknown> extends Promise<T> {
   constructor(executor: (resolve: (value: T | PromiseLike<T>) => void, reject: (reason?: any) => void) => void);
   static from<T, E = unknown>(p: Promise<T>): ReactivePromise<T, E>;
 }
+/**
+ * A {@link ReactivePromise} that is also callable as a `Computed<T | E | undefined>`.
+ *
+ * Invoking it (`p()`) reads the current `.result` — so it drops into any
+ * reactive context that expects a zero-arg getter.
+ */
 type ComputedPromise<T, E = unknown> = ReactivePromise<T, E> & Computed<T | E | undefined>;
 type Executor<T, E = unknown> = (resolve: (value: T | PromiseLike<T>) => void, reject: (reason?: E) => void) => void;
 /**

package/dist/utilities/promise.mjs

@@ -1,4 +1,5 @@
-import { l as batch, u as computed, v as signal } from "../signals-J8dK_rA4.mjs";
+import { a as batch, m as signal, o as computed } from "../lib-D6duEs38.mjs";
+import "../signals/index.mjs";
 //#region src/utilities/promise.ts
 /**
 * A `Promise` subclass that exposes its state as reactive signals.

package/dist/utilities/promise.test.mjs

@@ -1,5 +1,6 @@
-import { d as effect } from "../signals-J8dK_rA4.mjs";
-import { o as describe, s as it, t as globalExpect } from "../test.BmQO5GaM-DfGStnii.mjs";
+import { s as effect } from "../lib-D6duEs38.mjs";
+import "../signals/index.mjs";
+import { o as describe, s as it, t as globalExpect } from "../test.BmQO5GaM-BeO5pvCo.mjs";
 import { ReactivePromise, promise } from "./promise.mjs";
 //#region src/utilities/promise.test.ts
 describe("ReactivePromise", () => {