sibujs 1.0.2 → 1.0.3

package/dist/{chunk-OHQQWZ7P.js → chunk-QBMDLBU2.js}

@@ -96,7 +96,8 @@ function query(key, fetcher, options = {}) {
     refetchOnReconnect = false,
     onSuccess,
     onError,
-    onSettled
+    onSettled,
+    select
   } = options;
   const resolveKey = typeof key === "function" ? key : () => key;
   const [data, setData] = signal(initialData);
@@ -146,8 +147,9 @@ function query(key, fetcher, options = {}) {
       entry.data = result;
       entry.dataUpdatedAt = Date.now();
       entry.error = void 0;
+      const selected = select ? select(result) : result;
       batch(() => {
-        setData(result);
+        setData(selected);
         setIsFetching(false);
         setError(void 0);
       });
@@ -180,8 +182,10 @@ function query(key, fetcher, options = {}) {
       });
       return;
     }
+    const raw = entry.data;
+    const selected = raw !== void 0 && select ? select(raw) : raw;
     batch(() => {
-      setData(entry.data);
+      setData(selected);
       setError(entry.error);
       if (!entry.promise) setIsFetching(false);
     });
@@ -210,8 +214,10 @@ function query(key, fetcher, options = {}) {
     entry.listeners.add(onCacheUpdate);
     entry.refetchers.add(doFetch);
     if (entry.data !== void 0) {
+      const raw = entry.data;
+      const selected = select ? select(raw) : raw;
       batch(() => {
-        setData(entry.data);
+        setData(selected);
         setError(entry.error);
       });
     }

package/dist/data.cjs

@@ -525,7 +525,8 @@ function query(key, fetcher, options = {}) {
     refetchOnReconnect = false,
     onSuccess,
     onError,
-    onSettled
+    onSettled,
+    select
   } = options;
   const resolveKey = typeof key === "function" ? key : () => key;
   const [data, setData] = signal(initialData);
@@ -575,8 +576,9 @@ function query(key, fetcher, options = {}) {
       entry.data = result;
       entry.dataUpdatedAt = Date.now();
       entry.error = void 0;
+      const selected = select ? select(result) : result;
       batch(() => {
-        setData(result);
+        setData(selected);
         setIsFetching(false);
         setError(void 0);
       });
@@ -609,8 +611,10 @@ function query(key, fetcher, options = {}) {
       });
       return;
     }
+    const raw = entry.data;
+    const selected = raw !== void 0 && select ? select(raw) : raw;
     batch(() => {
-      setData(entry.data);
+      setData(selected);
       setError(entry.error);
       if (!entry.promise) setIsFetching(false);
     });
@@ -639,8 +643,10 @@ function query(key, fetcher, options = {}) {
     entry.listeners.add(onCacheUpdate);
     entry.refetchers.add(doFetch);
     if (entry.data !== void 0) {
+      const raw = entry.data;
+      const selected = select ? select(raw) : raw;
       batch(() => {
-        setData(entry.data);
+        setData(selected);
         setError(entry.error);
       });
     }

package/dist/data.d.cts

@@ -63,6 +63,8 @@ interface QueryOptions<T> {
     onError?: (error: Error) => void;
     /** Called on fetch settle (success or error) */
     onSettled?: () => void;
+    /** Transform fetched data before returning to consumers. Cache stores raw data. */
+    select?: (data: T) => T;
 }
 interface QueryResult<T> {
     /** Reactive getter for the cached data */

package/dist/data.d.ts

@@ -63,6 +63,8 @@ interface QueryOptions<T> {
     onError?: (error: Error) => void;
     /** Called on fetch settle (success or error) */
     onSettled?: () => void;
+    /** Transform fetched data before returning to consumers. Cache stores raw data. */
+    select?: (data: T) => T;
 }
 interface QueryResult<T> {
     /** Reactive getter for the cached data */

package/dist/data.js

@@ -19,7 +19,7 @@ import {
   syncAdapter,
   throttle,
   withRetry
-} from "./chunk-OHQQWZ7P.js";
+} from "./chunk-QBMDLBU2.js";
 import "./chunk-Z65KYU7I.js";
 import "./chunk-FGOEVHY3.js";
 import "./chunk-PZEGYCF5.js";

package/dist/ecosystem.cjs

@@ -586,7 +586,7 @@ function bindChildNode(placeholder, getter) {
       const node = lastNodes[i];
       if (node.parentNode) node.parentNode.removeChild(node);
     }
-    if (result == null) {
+    if (result == null || typeof result === "boolean") {
       lastNodes.length = 0;
       return;
     }
@@ -601,6 +601,7 @@ function bindChildNode(placeholder, getter) {
       if (lastNodes.length < result.length) lastNodes = new Array(result.length);
       for (let i = 0; i < result.length; i++) {
         const item = result[i];
+        if (item == null || typeof item === "boolean") continue;
         const node = item instanceof Node ? item : document.createTextNode(String(item));
         parent.insertBefore(node, anchor);
         lastNodes[count++] = node;
@@ -714,6 +715,9 @@ function appendChildren(el, nodes) {
     el.textContent = String(nodes);
     return;
   }
+  if (typeof nodes === "boolean" || nodes == null) {
+    return;
+  }
   if (typeof nodes === "function") {
     const ph = document.createComment("");
     el.appendChild(ph);
@@ -742,11 +746,11 @@ function appendChildren(el, nodes) {
             registerDisposer(el, bindChildNode(ph, inner));
           } else if (inner instanceof Node) {
             el.appendChild(inner);
-          } else if (inner != null) {
+          } else if (inner != null && typeof inner !== "boolean") {
             el.appendChild(document.createTextNode(String(inner)));
           }
         }
-      } else if (c != null) {
+      } else if (c != null && typeof c !== "boolean") {
         el.appendChild(document.createTextNode(String(c)));
       }
     }

package/dist/ecosystem.d.cts

@@ -1,5 +1,5 @@
 import { S as SibuPlugin } from './plugin-Bek4RhJY.cjs';
-import { T as TagProps } from './tagFactory-D9e0QGIE.cjs';
+import { T as TagProps } from './tagFactory-Dl8QCLga.cjs';
 
 /** MobX autorun disposer function type. */
 type MobXReactionDisposer = () => void;

package/dist/ecosystem.d.ts

@@ -1,5 +1,5 @@
 import { S as SibuPlugin } from './plugin-Bek4RhJY.js';
-import { T as TagProps } from './tagFactory-D9e0QGIE.js';
+import { T as TagProps } from './tagFactory-Dl8QCLga.js';
 
 /** MobX autorun disposer function type. */
 type MobXReactionDisposer = () => void;

package/dist/ecosystem.js

@@ -7,9 +7,9 @@ import {
   mobXAdapter,
   reduxAdapter,
   zustandAdapter
-} from "./chunk-HS6OOE3Q.js";
+} from "./chunk-G3BOQPVO.js";
 import "./chunk-K5ZUMYVS.js";
-import "./chunk-QVKGGB2S.js";
+import "./chunk-MDVXJWFN.js";
 import "./chunk-SDLZDHKP.js";
 import "./chunk-FGOEVHY3.js";
 import "./chunk-PZEGYCF5.js";

package/dist/extras.cjs

@@ -125,7 +125,9 @@ __export(extras_exports, {
   flushScheduler: () => flushScheduler,
   focus: () => focus,
   form: () => form,
+  formatCurrency: () => formatCurrency,
   formatError: () => formatError,
+  formatNumber: () => formatNumber,
   generateStaticSite: () => generateStaticSite,
   geo: () => geo,
   getActiveDevTools: () => getActiveDevTools,
@@ -768,7 +770,8 @@ function query(key, fetcher, options = {}) {
     refetchOnReconnect = false,
     onSuccess,
     onError,
-    onSettled
+    onSettled,
+    select: select3
   } = options;
   const resolveKey = typeof key === "function" ? key : () => key;
   const [data2, setData] = signal(initialData);
@@ -818,8 +821,9 @@ function query(key, fetcher, options = {}) {
       entry.data = result;
       entry.dataUpdatedAt = Date.now();
       entry.error = void 0;
+      const selected = select3 ? select3(result) : result;
       batch(() => {
-        setData(result);
+        setData(selected);
         setIsFetching(false);
         setError(void 0);
       });
@@ -852,8 +856,10 @@ function query(key, fetcher, options = {}) {
       });
       return;
     }
+    const raw = entry.data;
+    const selected = raw !== void 0 && select3 ? select3(raw) : raw;
     batch(() => {
-      setData(entry.data);
+      setData(selected);
       setError(entry.error);
       if (!entry.promise) setIsFetching(false);
     });
@@ -882,8 +888,10 @@ function query(key, fetcher, options = {}) {
     entry.listeners.add(onCacheUpdate);
     entry.refetchers.add(doFetch);
     if (entry.data !== void 0) {
+      const raw = entry.data;
+      const selected = select3 ? select3(raw) : raw;
       batch(() => {
-        setData(entry.data);
+        setData(selected);
         setError(entry.error);
       });
     }
@@ -2079,6 +2087,20 @@ function colorScheme() {
   return { scheme, dispose };
 }
 
+// src/browser/format.ts
+function formatNumber(value, options) {
+  const { locale, ...formatOptions } = options ?? {};
+  return new Intl.NumberFormat(locale, formatOptions).format(value);
+}
+function formatCurrency(value, currency, options) {
+  const { locale, ...formatOptions } = options ?? {};
+  return new Intl.NumberFormat(locale, {
+    style: "currency",
+    currency,
+    ...formatOptions
+  }).format(value);
+}
+
 // src/patterns/machine.ts
 function machine(config) {
   const [state, setState] = signal(config.initial);
@@ -5012,7 +5034,7 @@ function bindChildNode(placeholder, getter) {
       const node = lastNodes[i2];
       if (node.parentNode) node.parentNode.removeChild(node);
     }
-    if (result == null) {
+    if (result == null || typeof result === "boolean") {
       lastNodes.length = 0;
       return;
     }
@@ -5027,6 +5049,7 @@ function bindChildNode(placeholder, getter) {
       if (lastNodes.length < result.length) lastNodes = new Array(result.length);
       for (let i2 = 0; i2 < result.length; i2++) {
         const item = result[i2];
+        if (item == null || typeof item === "boolean") continue;
         const node = item instanceof Node ? item : document.createTextNode(String(item));
         parent.insertBefore(node, anchor);
         lastNodes[count++] = node;
@@ -5141,6 +5164,9 @@ function appendChildren(el, nodes) {
     el.textContent = String(nodes);
     return;
   }
+  if (typeof nodes === "boolean" || nodes == null) {
+    return;
+  }
   if (typeof nodes === "function") {
     const ph = document.createComment("");
     el.appendChild(ph);
@@ -5169,11 +5195,11 @@ function appendChildren(el, nodes) {
             registerDisposer(el, bindChildNode(ph, inner));
           } else if (inner instanceof Node) {
             el.appendChild(inner);
-          } else if (inner != null) {
+          } else if (inner != null && typeof inner !== "boolean") {
             el.appendChild(document.createTextNode(String(inner)));
           }
         }
-      } else if (c != null) {
+      } else if (c != null && typeof c !== "boolean") {
         el.appendChild(document.createTextNode(String(c)));
       }
     }
@@ -8539,7 +8565,9 @@ var materialAdapter = componentAdapter(materialConfig);
   flushScheduler,
   focus,
   form,
+  formatCurrency,
   formatError,
+  formatNumber,
   generateStaticSite,
   geo,
   getActiveDevTools,

package/dist/extras.d.cts

@@ -1,5 +1,5 @@
 export { InfiniteQueryOptions, InfiniteQueryResult, LoaderRoute, MutationOptions, MutationResult, OfflineStore, OfflineStoreOptions, QueryOptions, QueryResult, Resource, ResourceOptions, RetryOptions, RouteLoaderFn, SyncAdapter, SyncChange, SyncResult, calculateDelay, clearQueryCache, debounce, executeLoader, getQueryData, infiniteQuery, invalidateQueries, loaderData, mutation, offlineStore, preloadRoute, previous, query, resource, setQueryData, socket, stream, syncAdapter, throttle, withRetry } from './data.cjs';
-export { battery, clipboard, colorScheme, draggable, dropZone, geo, idle, media, online, permissions, resize, scroll, title } from './browser.cjs';
+export { battery, clipboard, colorScheme, draggable, dropZone, formatCurrency, formatNumber, geo, idle, media, online, permissions, resize, scroll, title } from './browser.cjs';
 export { GlobalStore, MachineConfig, MachineReturn, Middleware, OptimisticAction, PersistOptions, Selector, TimeTravelReturn, createEffect, createMemo, createSignal, globalStore, machine, optimistic, optimisticList, persisted, timeline } from './patterns.cjs';
 export { C as ComponentProps, P as PropDef, a as PropSchema, R as RenderProp, V as Validator, b as assertType, c as composable, d as compose, e as createGuard, f as createSlots, g as defineComponent, h as defineSlottedComponent, i as defineStrictComponent, v as validateProps, j as validators, w as withBoundary, k as withDefaults, l as withProps, m as withWrapper } from './contracts-DOrhwbke.cjs';
 export { AnimationPreset, PresetOptions, SlideDirection, SpringOptions, TransitionGroup, TransitionGroupOptions, TransitionOptions, animate, bounceIn, bounceOut, fadeIn, fadeOut, flipIn, pulse, reducedMotion, scaleDown, scaleUp, sequence, shake, slideIn, slideOut, spring, springSignal, stagger, transition, viewTransition } from './motion.cjs';
@@ -12,4 +12,4 @@ export { DevToolsEvent, DevtoolsOverlayOptions, ProfilerResult, ReactiveNodeInfo
 export { AccordionOptions, ComboboxOptions, DatePickerOptions, FileUploadOptions, SelectOptions, TabsOptions, accordion, combobox, contentEditable, datePicker, fileUpload, popover, select, tabs, tooltip } from './widgets.cjs';
 export { AdaptedComponent, AdaptedComponentProps, AdapterConfig, ComponentMapping, MobXAdapterAPI, MobXAdapterOptions, MobXReactionDisposer, ReduxAdapterAPI, ReduxAdapterOptions, ReduxStore, ThemeAPI, ThemeConfig, ZustandAdapterAPI, ZustandAdapterOptions, ZustandStore, antdAdapter, chakraAdapter, componentAdapter, createTheme, materialAdapter, mobXAdapter, reduxAdapter, zustandAdapter } from './ecosystem.cjs';
 import './signal-BnWpq6WB.cjs';
-import './tagFactory-D9e0QGIE.cjs';
+import './tagFactory-Dl8QCLga.cjs';

package/dist/extras.d.ts

@@ -1,5 +1,5 @@
 export { InfiniteQueryOptions, InfiniteQueryResult, LoaderRoute, MutationOptions, MutationResult, OfflineStore, OfflineStoreOptions, QueryOptions, QueryResult, Resource, ResourceOptions, RetryOptions, RouteLoaderFn, SyncAdapter, SyncChange, SyncResult, calculateDelay, clearQueryCache, debounce, executeLoader, getQueryData, infiniteQuery, invalidateQueries, loaderData, mutation, offlineStore, preloadRoute, previous, query, resource, setQueryData, socket, stream, syncAdapter, throttle, withRetry } from './data.js';
-export { battery, clipboard, colorScheme, draggable, dropZone, geo, idle, media, online, permissions, resize, scroll, title } from './browser.js';
+export { battery, clipboard, colorScheme, draggable, dropZone, formatCurrency, formatNumber, geo, idle, media, online, permissions, resize, scroll, title } from './browser.js';
 export { GlobalStore, MachineConfig, MachineReturn, Middleware, OptimisticAction, PersistOptions, Selector, TimeTravelReturn, createEffect, createMemo, createSignal, globalStore, machine, optimistic, optimisticList, persisted, timeline } from './patterns.js';
 export { C as ComponentProps, P as PropDef, a as PropSchema, R as RenderProp, V as Validator, b as assertType, c as composable, d as compose, e as createGuard, f as createSlots, g as defineComponent, h as defineSlottedComponent, i as defineStrictComponent, v as validateProps, j as validators, w as withBoundary, k as withDefaults, l as withProps, m as withWrapper } from './contracts-DOrhwbke.js';
 export { AnimationPreset, PresetOptions, SlideDirection, SpringOptions, TransitionGroup, TransitionGroupOptions, TransitionOptions, animate, bounceIn, bounceOut, fadeIn, fadeOut, flipIn, pulse, reducedMotion, scaleDown, scaleUp, sequence, shake, slideIn, slideOut, spring, springSignal, stagger, transition, viewTransition } from './motion.js';
@@ -12,4 +12,4 @@ export { DevToolsEvent, DevtoolsOverlayOptions, ProfilerResult, ReactiveNodeInfo
 export { AccordionOptions, ComboboxOptions, DatePickerOptions, FileUploadOptions, SelectOptions, TabsOptions, accordion, combobox, contentEditable, datePicker, fileUpload, popover, select, tabs, tooltip } from './widgets.js';
 export { AdaptedComponent, AdaptedComponentProps, AdapterConfig, ComponentMapping, MobXAdapterAPI, MobXAdapterOptions, MobXReactionDisposer, ReduxAdapterAPI, ReduxAdapterOptions, ReduxStore, ThemeAPI, ThemeConfig, ZustandAdapterAPI, ZustandAdapterOptions, ZustandStore, antdAdapter, chakraAdapter, componentAdapter, createTheme, materialAdapter, mobXAdapter, reduxAdapter, zustandAdapter } from './ecosystem.js';
 import './signal-BnWpq6WB.js';
-import './tagFactory-D9e0QGIE.js';
+import './tagFactory-Dl8QCLga.js';

package/dist/extras.js

@@ -90,7 +90,7 @@ import {
   wasm,
   worker,
   workerFn
-} from "./chunk-MJ4LVHGX.js";
+} from "./chunk-7V26P53V.js";
 import {
   FocusTrap,
   VirtualList,
@@ -181,6 +181,8 @@ import {
   colorScheme,
   draggable,
   dropZone,
+  formatCurrency,
+  formatNumber,
   geo,
   idle,
   media,
@@ -189,7 +191,7 @@ import {
   resize,
   scroll,
   title
-} from "./chunk-ONCYDOK6.js";
+} from "./chunk-4EI4AG32.js";
 import {
   calculateDelay,
   clearQueryCache,
@@ -211,7 +213,7 @@ import {
   syncAdapter,
   throttle,
   withRetry
-} from "./chunk-OHQQWZ7P.js";
+} from "./chunk-QBMDLBU2.js";
 import {
   SibuError,
   checkLeaks,
@@ -257,7 +259,7 @@ import {
   mobXAdapter,
   reduxAdapter,
   zustandAdapter
-} from "./chunk-HS6OOE3Q.js";
+} from "./chunk-G3BOQPVO.js";
 import {
   createPlugin,
   inject,
@@ -267,10 +269,10 @@ import {
   triggerPluginMount,
   triggerPluginUnmount
 } from "./chunk-K5ZUMYVS.js";
-import "./chunk-OWLQ4HZI.js";
+import "./chunk-EWFVA3TJ.js";
 import "./chunk-CZUGLNJS.js";
 import "./chunk-Z65KYU7I.js";
-import "./chunk-QVKGGB2S.js";
+import "./chunk-MDVXJWFN.js";
 import "./chunk-SDLZDHKP.js";
 import "./chunk-FGOEVHY3.js";
 import "./chunk-PZEGYCF5.js";
@@ -406,7 +408,9 @@ export {
   flushScheduler,
   focus,
   form,
+  formatCurrency,
   formatError,
+  formatNumber,
   generateStaticSite,
   geo,
   getActiveDevTools,

package/dist/index.cjs

@@ -138,6 +138,7 @@ __export(index_exports, {
   object: () => object,
   ol: () => ol,
   on: () => on,
+  onCleanup: () => onCleanup,
   onMount: () => onMount,
   onUnmount: () => onUnmount,
   optgroup: () => optgroup,
@@ -602,7 +603,7 @@ function bindChildNode(placeholder, getter) {
       const node = lastNodes[i2];
       if (node.parentNode) node.parentNode.removeChild(node);
     }
-    if (result == null) {
+    if (result == null || typeof result === "boolean") {
       lastNodes.length = 0;
       return;
     }
@@ -617,6 +618,7 @@ function bindChildNode(placeholder, getter) {
       if (lastNodes.length < result.length) lastNodes = new Array(result.length);
       for (let i2 = 0; i2 < result.length; i2++) {
         const item = result[i2];
+        if (item == null || typeof item === "boolean") continue;
         const node = item instanceof Node ? item : document.createTextNode(String(item));
         parent.insertBefore(node, anchor);
         lastNodes[count++] = node;
@@ -761,6 +763,9 @@ function appendChildren(el, nodes) {
     el.textContent = String(nodes);
     return;
   }
+  if (typeof nodes === "boolean" || nodes == null) {
+    return;
+  }
   if (typeof nodes === "function") {
     const ph = document.createComment("");
     el.appendChild(ph);
@@ -789,11 +794,11 @@ function appendChildren(el, nodes) {
             registerDisposer(el, bindChildNode(ph, inner));
           } else if (inner instanceof Node) {
             el.appendChild(inner);
-          } else if (inner != null) {
+          } else if (inner != null && typeof inner !== "boolean") {
             el.appendChild(document.createTextNode(String(inner)));
           }
         }
-      } else if (c != null) {
+      } else if (c != null && typeof c !== "boolean") {
         el.appendChild(document.createTextNode(String(c)));
       }
     }
@@ -1262,11 +1267,11 @@ function executeElement(tmpl, values) {
             const item = val[j];
             if (item instanceof Node) {
               el.appendChild(item);
-            } else if (item != null) {
+            } else if (item != null && typeof item !== "boolean") {
               el.appendChild(document.createTextNode(String(item)));
             }
           }
-        } else if (val != null) {
+        } else if (val != null && typeof val !== "boolean") {
           el.appendChild(document.createTextNode(String(val)));
         }
         break;
@@ -1307,11 +1312,11 @@ function html2(strings, ...values) {
             const item = val[j];
             if (item instanceof Node) {
               wrapper.appendChild(item);
-            } else if (item != null) {
+            } else if (item != null && typeof item !== "boolean") {
               wrapper.appendChild(document.createTextNode(String(item)));
             }
           }
-        } else if (val != null) {
+        } else if (val != null && typeof val !== "boolean") {
           wrapper.appendChild(document.createTextNode(String(val)));
         }
         break;
@@ -1537,9 +1542,10 @@ function each(getArray, render, options) {
 function Fragment(nodes) {
   const frag = document.createDocumentFragment();
   for (const child of nodes) {
-    if (child == null) continue;
+    if (child == null || typeof child === "boolean") continue;
     if (Array.isArray(child)) {
       for (const nested of child) {
+        if (nested == null || typeof nested === "boolean") continue;
         frag.appendChild(resolveChild(nested));
       }
     } else {
@@ -2460,6 +2466,9 @@ function onUnmount(callback, element) {
     }, element);
   }
 }
+function onCleanup(callback, element) {
+  registerDisposer(element, callback);
+}
 
 // src/core/rendering/context.ts
 function context(defaultValue) {
@@ -2923,6 +2932,7 @@ function Loading(props = {}) {
   object,
   ol,
   on,
+  onCleanup,
   onMount,
   onUnmount,
   optgroup,

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { T as TagProps, N as NodeChildren, a as NodeChild } from './tagFactory-D9e0QGIE.cjs';
-export { S as SVG_NS, t as tagFactory } from './tagFactory-D9e0QGIE.cjs';
+import { T as TagProps, N as NodeChildren, a as NodeChild } from './tagFactory-Dl8QCLga.cjs';
+export { S as SVG_NS, t as tagFactory } from './tagFactory-Dl8QCLga.cjs';
 import { R as ReactiveSignal } from './signal-BnWpq6WB.cjs';
 
 declare const head: (first?: TagProps | NodeChildren, second?: NodeChildren) => Element;
@@ -819,6 +819,25 @@ declare function onMount(callback: () => undefined | CleanupFn, element?: HTMLEl
  * @param element The element to watch for removal
  */
 declare function onUnmount(callback: CleanupFn, element: HTMLElement): void;
+/**
+ * Register a cleanup callback that runs when the given element is disposed.
+ * Integrates with `when()`, `match()`, and `each()` which call `dispose()`
+ * on removed nodes, triggering all registered cleanup functions.
+ *
+ * @param callback Cleanup function (close sockets, clear intervals, etc.)
+ * @param element The component's root node to attach cleanup to
+ *
+ * @example
+ * ```ts
+ * function RealtimeBar(siteId: string) {
+ *   const ws = new WebSocket(`/ws/sites/${siteId}/realtime`);
+ *   const root = div({ nodes: "Realtime data..." });
+ *   onCleanup(() => ws.close(), root);
+ *   return root;
+ * }
+ * ```
+ */
+declare function onCleanup(callback: CleanupFn, element: Node): void;
 
 /**
  * Context API for SibuJS — provides dependency injection across
@@ -1038,4 +1057,4 @@ interface LoadingProps {
  */
 declare function Loading(props?: LoadingProps): HTMLElement;
 
-export { type ActionFn, type ArrayActions, type Context, DynamicComponent, type EffectOptions, ErrorBoundary, type ErrorBoundaryProps, Fragment, KeepAlive, type KeepAliveOptions, Loading, type LoadingProps, type LongPressOptions, NodeChild, NodeChildren, Portal, type Ref, type SignalOptions, type SlotFn, type Slots, type StoreActions, Suspense, type SuspenseProps, TagProps, a, abbr, action, address, area, array, article, aside, audio, b, base, batch, bdi, bdo, bindDynamic, blockquote, body, br, button, canvas, caption, catchError, catchErrorAsync, center, checkLeaks, circle, cite, clickOutside, clipPath, code, col, colgroup, context, customElement, data, datalist, dd, deepEqual, deepSignal, defs, del, derived, details, dfn, dialog, disableSSR, dispose, div, dl, dt, each, effect, ellipse, em, embed, enableSSR, enqueueBatchedSignal, fieldset, figcaption, figure, font, footer, form, g, getSlot, h1, h2, h3, h4, h5, h6, head, header, hr, html, i, iframe, img, input, ins, isBatching, isSSR, kbd, label, lazy, legend, li, line, linearGradient, link, longPress, main, map, mark, marker, marquee, mask, match, math, memo, memoFn, menu, meta, meter, mount, nav, noscript, object, ol, on, onMount, onUnmount, optgroup, option, output, p, param, path, pattern, picture, polygon, polyline, portal, pre, progress, q, radialGradient, reactiveArray, rect, ref, registerComponent, registerDisposer, resolveComponent, rp, rt, ruby, s, samp, script, section, select, setGlobalErrorHandler, show, signal, slot, small, source, span, stop, store, strong, style, sub, summary, sup, svg, symbol, table, tbody, td, template, text, textarea, tfoot, th, thead, time, title, tr, track, trapFocus, tspan, u, ul, unregisterComponent, untracked, use, var_, video, watch, when, withSSR, writable };
+export { type ActionFn, type ArrayActions, type Context, DynamicComponent, type EffectOptions, ErrorBoundary, type ErrorBoundaryProps, Fragment, KeepAlive, type KeepAliveOptions, Loading, type LoadingProps, type LongPressOptions, NodeChild, NodeChildren, Portal, type Ref, type SignalOptions, type SlotFn, type Slots, type StoreActions, Suspense, type SuspenseProps, TagProps, a, abbr, action, address, area, array, article, aside, audio, b, base, batch, bdi, bdo, bindDynamic, blockquote, body, br, button, canvas, caption, catchError, catchErrorAsync, center, checkLeaks, circle, cite, clickOutside, clipPath, code, col, colgroup, context, customElement, data, datalist, dd, deepEqual, deepSignal, defs, del, derived, details, dfn, dialog, disableSSR, dispose, div, dl, dt, each, effect, ellipse, em, embed, enableSSR, enqueueBatchedSignal, fieldset, figcaption, figure, font, footer, form, g, getSlot, h1, h2, h3, h4, h5, h6, head, header, hr, html, i, iframe, img, input, ins, isBatching, isSSR, kbd, label, lazy, legend, li, line, linearGradient, link, longPress, main, map, mark, marker, marquee, mask, match, math, memo, memoFn, menu, meta, meter, mount, nav, noscript, object, ol, on, onCleanup, onMount, onUnmount, optgroup, option, output, p, param, path, pattern, picture, polygon, polyline, portal, pre, progress, q, radialGradient, reactiveArray, rect, ref, registerComponent, registerDisposer, resolveComponent, rp, rt, ruby, s, samp, script, section, select, setGlobalErrorHandler, show, signal, slot, small, source, span, stop, store, strong, style, sub, summary, sup, svg, symbol, table, tbody, td, template, text, textarea, tfoot, th, thead, time, title, tr, track, trapFocus, tspan, u, ul, unregisterComponent, untracked, use, var_, video, watch, when, withSSR, writable };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { T as TagProps, N as NodeChildren, a as NodeChild } from './tagFactory-D9e0QGIE.js';
-export { S as SVG_NS, t as tagFactory } from './tagFactory-D9e0QGIE.js';
+import { T as TagProps, N as NodeChildren, a as NodeChild } from './tagFactory-Dl8QCLga.js';
+export { S as SVG_NS, t as tagFactory } from './tagFactory-Dl8QCLga.js';
 import { R as ReactiveSignal } from './signal-BnWpq6WB.js';
 
 declare const head: (first?: TagProps | NodeChildren, second?: NodeChildren) => Element;
@@ -819,6 +819,25 @@ declare function onMount(callback: () => undefined | CleanupFn, element?: HTMLEl
  * @param element The element to watch for removal
  */
 declare function onUnmount(callback: CleanupFn, element: HTMLElement): void;
+/**
+ * Register a cleanup callback that runs when the given element is disposed.
+ * Integrates with `when()`, `match()`, and `each()` which call `dispose()`
+ * on removed nodes, triggering all registered cleanup functions.
+ *
+ * @param callback Cleanup function (close sockets, clear intervals, etc.)
+ * @param element The component's root node to attach cleanup to
+ *
+ * @example
+ * ```ts
+ * function RealtimeBar(siteId: string) {
+ *   const ws = new WebSocket(`/ws/sites/${siteId}/realtime`);
+ *   const root = div({ nodes: "Realtime data..." });
+ *   onCleanup(() => ws.close(), root);
+ *   return root;
+ * }
+ * ```
+ */
+declare function onCleanup(callback: CleanupFn, element: Node): void;
 
 /**
  * Context API for SibuJS — provides dependency injection across
@@ -1038,4 +1057,4 @@ interface LoadingProps {
  */
 declare function Loading(props?: LoadingProps): HTMLElement;
 
-export { type ActionFn, type ArrayActions, type Context, DynamicComponent, type EffectOptions, ErrorBoundary, type ErrorBoundaryProps, Fragment, KeepAlive, type KeepAliveOptions, Loading, type LoadingProps, type LongPressOptions, NodeChild, NodeChildren, Portal, type Ref, type SignalOptions, type SlotFn, type Slots, type StoreActions, Suspense, type SuspenseProps, TagProps, a, abbr, action, address, area, array, article, aside, audio, b, base, batch, bdi, bdo, bindDynamic, blockquote, body, br, button, canvas, caption, catchError, catchErrorAsync, center, checkLeaks, circle, cite, clickOutside, clipPath, code, col, colgroup, context, customElement, data, datalist, dd, deepEqual, deepSignal, defs, del, derived, details, dfn, dialog, disableSSR, dispose, div, dl, dt, each, effect, ellipse, em, embed, enableSSR, enqueueBatchedSignal, fieldset, figcaption, figure, font, footer, form, g, getSlot, h1, h2, h3, h4, h5, h6, head, header, hr, html, i, iframe, img, input, ins, isBatching, isSSR, kbd, label, lazy, legend, li, line, linearGradient, link, longPress, main, map, mark, marker, marquee, mask, match, math, memo, memoFn, menu, meta, meter, mount, nav, noscript, object, ol, on, onMount, onUnmount, optgroup, option, output, p, param, path, pattern, picture, polygon, polyline, portal, pre, progress, q, radialGradient, reactiveArray, rect, ref, registerComponent, registerDisposer, resolveComponent, rp, rt, ruby, s, samp, script, section, select, setGlobalErrorHandler, show, signal, slot, small, source, span, stop, store, strong, style, sub, summary, sup, svg, symbol, table, tbody, td, template, text, textarea, tfoot, th, thead, time, title, tr, track, trapFocus, tspan, u, ul, unregisterComponent, untracked, use, var_, video, watch, when, withSSR, writable };
+export { type ActionFn, type ArrayActions, type Context, DynamicComponent, type EffectOptions, ErrorBoundary, type ErrorBoundaryProps, Fragment, KeepAlive, type KeepAliveOptions, Loading, type LoadingProps, type LongPressOptions, NodeChild, NodeChildren, Portal, type Ref, type SignalOptions, type SlotFn, type Slots, type StoreActions, Suspense, type SuspenseProps, TagProps, a, abbr, action, address, area, array, article, aside, audio, b, base, batch, bdi, bdo, bindDynamic, blockquote, body, br, button, canvas, caption, catchError, catchErrorAsync, center, checkLeaks, circle, cite, clickOutside, clipPath, code, col, colgroup, context, customElement, data, datalist, dd, deepEqual, deepSignal, defs, del, derived, details, dfn, dialog, disableSSR, dispose, div, dl, dt, each, effect, ellipse, em, embed, enableSSR, enqueueBatchedSignal, fieldset, figcaption, figure, font, footer, form, g, getSlot, h1, h2, h3, h4, h5, h6, head, header, hr, html, i, iframe, img, input, ins, isBatching, isSSR, kbd, label, lazy, legend, li, line, linearGradient, link, longPress, main, map, mark, marker, marquee, mask, match, math, memo, memoFn, menu, meta, meter, mount, nav, noscript, object, ol, on, onCleanup, onMount, onUnmount, optgroup, option, output, p, param, path, pattern, picture, polygon, polyline, portal, pre, progress, q, radialGradient, reactiveArray, rect, ref, registerComponent, registerDisposer, resolveComponent, rp, rt, ruby, s, samp, script, section, select, setGlobalErrorHandler, show, signal, slot, small, source, span, stop, store, strong, style, sub, summary, sup, svg, symbol, table, tbody, td, template, text, textarea, tfoot, th, thead, time, title, tr, track, trapFocus, tspan, u, ul, unregisterComponent, untracked, use, var_, video, watch, when, withSSR, writable };

package/dist/index.js

@@ -22,6 +22,7 @@ import {
   memo,
   memoFn,
   mount,
+  onCleanup,
   onMount,
   onUnmount,
   reactiveArray,
@@ -35,7 +36,7 @@ import {
   unregisterComponent,
   when,
   writable
-} from "./chunk-24WSRM54.js";
+} from "./chunk-MEZVEBPN.js";
 import {
   a,
   abbr,
@@ -173,7 +174,7 @@ import {
   use,
   var_,
   video
-} from "./chunk-OWLQ4HZI.js";
+} from "./chunk-EWFVA3TJ.js";
 import {
   watch
 } from "./chunk-CZUGLNJS.js";
@@ -186,7 +187,7 @@ import {
   dispose,
   registerDisposer,
   tagFactory
-} from "./chunk-QVKGGB2S.js";
+} from "./chunk-MDVXJWFN.js";
 import {
   bindDynamic
 } from "./chunk-SDLZDHKP.js";
@@ -331,6 +332,7 @@ export {
   object,
   ol,
   on,
+  onCleanup,
   onMount,
   onUnmount,
   optgroup,