sibujs 1.0.2 → 1.0.4

package/dist/index.cjs

@@ -37,6 +37,7 @@ __export(index_exports, {
   article: () => article,
   aside: () => aside,
   audio: () => audio,
+  autoResize: () => autoResize,
   b: () => b,
   base: () => base,
   batch: () => batch,
@@ -61,6 +62,7 @@ __export(index_exports, {
   col: () => col,
   colgroup: () => colgroup,
   context: () => context,
+  copyOnClick: () => copyOnClick,
   customElement: () => customElement,
   data: () => data,
   datalist: () => datalist,
@@ -138,6 +140,7 @@ __export(index_exports, {
   object: () => object,
   ol: () => ol,
   on: () => on,
+  onCleanup: () => onCleanup,
   onMount: () => onMount,
   onUnmount: () => onUnmount,
   optgroup: () => optgroup,
@@ -602,7 +605,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 +620,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 +765,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 +796,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 +1269,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 +1314,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 +1544,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 {
@@ -1805,6 +1813,24 @@ var longPress = (element, options) => {
     element.removeEventListener("pointerleave", cancel);
   };
 };
+var copyOnClick = (element, getText) => {
+  const handler = () => {
+    const text2 = typeof getText === "function" ? getText() : element.textContent ?? "";
+    navigator.clipboard.writeText(text2);
+  };
+  element.addEventListener("click", handler);
+  return () => element.removeEventListener("click", handler);
+};
+var autoResize = (element) => {
+  const resize = () => {
+    element.style.overflow = "hidden";
+    element.style.height = "auto";
+    element.style.height = `${element.scrollHeight}px`;
+  };
+  resize();
+  element.addEventListener("input", resize);
+  return () => element.removeEventListener("input", resize);
+};
 var trapFocus = (element) => {
   const focusable = 'a[href],button:not([disabled]),input:not([disabled]),select:not([disabled]),textarea:not([disabled]),[tabindex]:not([tabindex="-1"])';
   const handler = (e) => {
@@ -2460,6 +2486,9 @@ function onUnmount(callback, element) {
     }, element);
   }
 }
+function onCleanup(callback, element) {
+  registerDisposer(element, callback);
+}
 
 // src/core/rendering/context.ts
 function context(defaultValue) {
@@ -2822,6 +2851,7 @@ function Loading(props = {}) {
   article,
   aside,
   audio,
+  autoResize,
   b,
   base,
   batch,
@@ -2846,6 +2876,7 @@ function Loading(props = {}) {
   col,
   colgroup,
   context,
+  copyOnClick,
   customElement,
   data,
   datalist,
@@ -2923,6 +2954,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;
@@ -289,7 +289,7 @@ declare function getSlot(slots: Slots | undefined, name?: string): SlotFn | unde
  * div({ nodes: [show(() => visible(), span({ nodes: "I toggle!" }))] });
  * ```
  */
-declare function show(condition: () => boolean, element: HTMLElement): HTMLElement;
+declare function show<T extends Element>(condition: () => boolean, element: T): T;
 /**
  * Conditional rendering directive. Renders content only when condition is true.
  * When false, renders nothing (comment placeholder). Re-evaluates reactively.
@@ -429,6 +429,31 @@ interface LongPressOptions {
  * ```
  */
 declare const longPress: ActionFn<LongPressOptions>;
+/**
+ * Copies the element's textContent to the clipboard on click.
+ * Optionally accepts a custom getter for the text to copy.
+ *
+ * @example
+ * ```ts
+ * // Copy element text
+ * action(el, copyOnClick);
+ *
+ * // Copy custom value
+ * action(el, copyOnClick, () => secretToken());
+ * ```
+ */
+declare const copyOnClick: ActionFn<(() => string) | undefined>;
+/**
+ * Auto-resizes a textarea to fit its content.
+ * Adjusts height on input and on initial attach.
+ *
+ * @example
+ * ```ts
+ * const ta = textarea({ placeholder: "Type here..." });
+ * action(ta, autoResize);
+ * ```
+ */
+declare const autoResize: ActionFn<void>;
 /**
  * Traps keyboard focus within the element (Tab and Shift+Tab cycle).
  * Essential for accessible modals and dialogs.
@@ -819,6 +844,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 +1082,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, autoResize, b, base, batch, bdi, bdo, bindDynamic, blockquote, body, br, button, canvas, caption, catchError, catchErrorAsync, center, checkLeaks, circle, cite, clickOutside, clipPath, code, col, colgroup, context, copyOnClick, 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;
@@ -289,7 +289,7 @@ declare function getSlot(slots: Slots | undefined, name?: string): SlotFn | unde
  * div({ nodes: [show(() => visible(), span({ nodes: "I toggle!" }))] });
  * ```
  */
-declare function show(condition: () => boolean, element: HTMLElement): HTMLElement;
+declare function show<T extends Element>(condition: () => boolean, element: T): T;
 /**
  * Conditional rendering directive. Renders content only when condition is true.
  * When false, renders nothing (comment placeholder). Re-evaluates reactively.
@@ -429,6 +429,31 @@ interface LongPressOptions {
  * ```
  */
 declare const longPress: ActionFn<LongPressOptions>;
+/**
+ * Copies the element's textContent to the clipboard on click.
+ * Optionally accepts a custom getter for the text to copy.
+ *
+ * @example
+ * ```ts
+ * // Copy element text
+ * action(el, copyOnClick);
+ *
+ * // Copy custom value
+ * action(el, copyOnClick, () => secretToken());
+ * ```
+ */
+declare const copyOnClick: ActionFn<(() => string) | undefined>;
+/**
+ * Auto-resizes a textarea to fit its content.
+ * Adjusts height on input and on initial attach.
+ *
+ * @example
+ * ```ts
+ * const ta = textarea({ placeholder: "Type here..." });
+ * action(ta, autoResize);
+ * ```
+ */
+declare const autoResize: ActionFn<void>;
 /**
  * Traps keyboard focus within the element (Tab and Shift+Tab cycle).
  * Essential for accessible modals and dialogs.
@@ -819,6 +844,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 +1082,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, autoResize, b, base, batch, bdi, bdo, bindDynamic, blockquote, body, br, button, canvas, caption, catchError, catchErrorAsync, center, checkLeaks, circle, cite, clickOutside, clipPath, code, col, colgroup, context, copyOnClick, 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

@@ -8,9 +8,11 @@ import {
   Suspense,
   action,
   array,
+  autoResize,
   catchError,
   catchErrorAsync,
   clickOutside,
+  copyOnClick,
   deepEqual,
   deepSignal,
   each,
@@ -22,6 +24,7 @@ import {
   memo,
   memoFn,
   mount,
+  onCleanup,
   onMount,
   onUnmount,
   reactiveArray,
@@ -35,7 +38,7 @@ import {
   unregisterComponent,
   when,
   writable
-} from "./chunk-24WSRM54.js";
+} from "./chunk-32ZISOLJ.js";
 import {
   a,
   abbr,
@@ -173,7 +176,7 @@ import {
   use,
   var_,
   video
-} from "./chunk-OWLQ4HZI.js";
+} from "./chunk-EWFVA3TJ.js";
 import {
   watch
 } from "./chunk-CZUGLNJS.js";
@@ -186,7 +189,7 @@ import {
   dispose,
   registerDisposer,
   tagFactory
-} from "./chunk-QVKGGB2S.js";
+} from "./chunk-MDVXJWFN.js";
 import {
   bindDynamic
 } from "./chunk-SDLZDHKP.js";
@@ -230,6 +233,7 @@ export {
   article,
   aside,
   audio,
+  autoResize,
   b,
   base,
   batch,
@@ -254,6 +258,7 @@ export {
   col,
   colgroup,
   context,
+  copyOnClick,
   customElement,
   data,
   datalist,
@@ -331,6 +336,7 @@ export {
   object,
   ol,
   on,
+  onCleanup,
   onMount,
   onUnmount,
   optgroup,

package/dist/patterns.d.cts

@@ -58,11 +58,17 @@ interface PersistOptions<T = unknown> {
      * Encrypt the serialized value before writing to storage.
      * Paired with `decrypt` for reading. Use for sensitive data.
      *
+     * **Security:** Use a real encryption algorithm (e.g. AES-GCM via Web Crypto API).
+     * Do NOT use `btoa()`/`atob()` — Base64 is encoding, not encryption, and provides
+     * zero confidentiality.
+     *
      * @example
      * ```ts
+     * // Example using a simple XOR cipher for illustration — in production,
+     * // use crypto.subtle.encrypt() with AES-GCM or a proven library.
      * persisted("token", "", {
-     *   encrypt: (v) => btoa(v),   // or use Web Crypto API
-     *   decrypt: (v) => atob(v),
+     *   encrypt: (v) => myAesGcmEncrypt(v, secretKey),
+     *   decrypt: (v) => myAesGcmDecrypt(v, secretKey),
      * });
      * ```
      */

package/dist/patterns.d.ts

@@ -58,11 +58,17 @@ interface PersistOptions<T = unknown> {
      * Encrypt the serialized value before writing to storage.
      * Paired with `decrypt` for reading. Use for sensitive data.
      *
+     * **Security:** Use a real encryption algorithm (e.g. AES-GCM via Web Crypto API).
+     * Do NOT use `btoa()`/`atob()` — Base64 is encoding, not encryption, and provides
+     * zero confidentiality.
+     *
      * @example
      * ```ts
+     * // Example using a simple XOR cipher for illustration — in production,
+     * // use crypto.subtle.encrypt() with AES-GCM or a proven library.
      * persisted("token", "", {
-     *   encrypt: (v) => btoa(v),   // or use Web Crypto API
-     *   decrypt: (v) => atob(v),
+     *   encrypt: (v) => myAesGcmEncrypt(v, secretKey),
+     *   decrypt: (v) => myAesGcmDecrypt(v, secretKey),
      * });
      * ```
      */

package/dist/plugins.cjs

@@ -59,7 +59,8 @@ __export(ssr_exports, {
   resetSSRState: () => resetSSRState,
   serializeState: () => serializeState,
   ssrSuspense: () => ssrSuspense,
-  suspenseSwapScript: () => suspenseSwapScript
+  suspenseSwapScript: () => suspenseSwapScript,
+  trustHTML: () => trustHTML
 });
 function ssrErrorComment(err) {
   if (_isDev7) {
@@ -122,6 +123,9 @@ function hydrateNode(serverNode, clientNode) {
     hydrateNode(serverChildren[i2], clientChildren[i2]);
   }
 }
+function trustHTML(html2) {
+  return html2;
+}
 function renderToDocument(component, options = {}) {
   let content;
   try {
@@ -343,6 +347,7 @@ var init_ssr = __esm({
 // plugins.ts
 var plugins_exports = {};
 __export(plugins_exports, {
+  KeepAliveRoute: () => KeepAliveRoute,
   Outlet: () => Outlet,
   Route: () => Route,
   RouterLink: () => RouterLink,
@@ -698,7 +703,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;
     }
@@ -713,6 +718,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;
@@ -742,6 +748,27 @@ function registerDisposer(node, teardown) {
   disposers.push(teardown);
   if (_isDev5) activeBindingCount++;
 }
+function dispose(node) {
+  const stack = [node];
+  const order = [];
+  while (stack.length > 0) {
+    const current = stack.pop();
+    order.push(current);
+    const children = current.childNodes;
+    for (let i2 = 0; i2 < children.length; i2++) {
+      stack.push(children[i2]);
+    }
+  }
+  for (let i2 = order.length - 1; i2 >= 0; i2--) {
+    const current = order[i2];
+    const disposers = elementDisposers.get(current);
+    if (disposers) {
+      if (_isDev5) activeBindingCount -= disposers.length;
+      for (const d of disposers) d();
+      elementDisposers.delete(current);
+    }
+  }
+}
 
 // src/core/rendering/tagFactory.ts
 var SVG_NS = "http://www.w3.org/2000/svg";
@@ -828,6 +855,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);
@@ -856,11 +886,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)));
       }
     }
@@ -2092,6 +2122,120 @@ function Route() {
   routeCleanups.push(cleanupNodes);
   return anchor;
 }
+function KeepAliveRoute(options) {
+  if (!globalRouter) throw new Error("Router not initialized. Call createRouter() first.");
+  const anchor = document.createComment("keep-alive-route");
+  const cache = /* @__PURE__ */ new Map();
+  const lruOrder = [];
+  const routerOpts = globalRouter["options"];
+  const keepAliveOpt = routerOpts.keepAlive;
+  const maxCache = options?.max ?? (typeof keepAliveOpt === "number" ? keepAliveOpt : 20);
+  const includeNames = options?.include ?? (Array.isArray(keepAliveOpt) ? keepAliveOpt : void 0);
+  let currentNode = null;
+  let currentKey = "";
+  let currentCached = false;
+  let isUpdating = false;
+  let pendingUpdate = false;
+  const update = async () => {
+    if (!globalRouter) return;
+    if (isUpdating) {
+      pendingUpdate = true;
+      return;
+    }
+    const route2 = globalRouter.currentRoute;
+    const match = globalRouter["matcher"].match(route2.path);
+    if (!match) return;
+    const { route: routeDef } = match;
+    if ("redirect" in routeDef) {
+      const redirectPath = typeof routeDef.redirect === "function" ? routeDef.redirect(route2) : routeDef.redirect;
+      queueMicrotask(() => globalRouter?.navigate(redirectPath));
+      return;
+    }
+    if (!("component" in routeDef)) return;
+    const cacheKey = route2.path;
+    const shouldCache = !includeNames || routeDef.name != null && includeNames.includes(routeDef.name);
+    if (cacheKey === currentKey && currentNode) return;
+    isUpdating = true;
+    const parent = anchor.parentNode;
+    if (!parent) {
+      isUpdating = false;
+      return;
+    }
+    try {
+      if (currentNode?.parentNode) {
+        parent.removeChild(currentNode);
+        if (!currentCached) {
+          dispose(currentNode);
+        }
+      }
+      if (shouldCache && cache.has(cacheKey)) {
+        currentNode = cache.get(cacheKey);
+        currentCached = true;
+        const idx = lruOrder.indexOf(cacheKey);
+        if (idx !== -1) {
+          lruOrder.splice(idx, 1);
+        }
+        lruOrder.push(cacheKey);
+      } else {
+        const component = await globalRouter.loadComponent(routeDef, route2.path);
+        const node = component();
+        if (!node || route2.path !== globalRouter.currentRoute.path) {
+          isUpdating = false;
+          return;
+        }
+        currentNode = node;
+        currentCached = shouldCache;
+        if (shouldCache) {
+          cache.set(cacheKey, node);
+          lruOrder.push(cacheKey);
+          while (lruOrder.length > maxCache) {
+            const evictKey = lruOrder.shift();
+            const evictNode = cache.get(evictKey);
+            if (evictNode) {
+              dispose(evictNode);
+              if (evictNode.parentNode) evictNode.parentNode.removeChild(evictNode);
+              cache.delete(evictKey);
+            }
+          }
+        }
+      }
+      currentKey = cacheKey;
+      if (currentNode) {
+        parent.insertBefore(currentNode, anchor.nextSibling);
+      }
+    } catch (error) {
+      console.error("[KeepAliveRoute] Component error:", error);
+    } finally {
+      isUpdating = false;
+      if (pendingUpdate) {
+        pendingUpdate = false;
+        update();
+      }
+    }
+  };
+  let initialized = false;
+  const wrappedUpdate = async () => {
+    await update();
+    initialized = true;
+  };
+  track(wrappedUpdate);
+  if (!initialized) {
+    queueMicrotask(() => {
+      if (!initialized && anchor.parentNode) wrappedUpdate();
+    });
+  }
+  routeCleanups.push(() => {
+    for (const node of cache.values()) {
+      dispose(node);
+      if (node.parentNode) node.parentNode.removeChild(node);
+    }
+    cache.clear();
+    lruOrder.length = 0;
+    if (currentNode?.parentNode) currentNode.parentNode.removeChild(currentNode);
+    currentNode = null;
+  });
+  return anchor;
+}
 function RouterLink(props) {
   if (!globalRouter) throw new Error("Router not initialized. Call createRouter() first.");
   const { to, replace: replace2 = false, activeClass, exactActiveClass, nodes, target, rel, ...attrs } = props;
@@ -3392,6 +3536,7 @@ function createBootSequence() {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  KeepAliveRoute,
   Outlet,
   Route,
   RouterLink,