sibujs 4.5.0 → 4.6.0

package/dist/data.d.cts

@@ -1,3 +1,5 @@
+import { D as DisposableAccessor } from './signal-EotCj4hS.cjs';
+
 /**
  * Configurable retry strategies for async operations.
  * Used by `resource` and `query` for automatic error recovery.
@@ -278,7 +280,8 @@ declare function infiniteQuery<TData, TPageParam = number>(key: string | (() =>
  * Returns `undefined` on first read (there is no previous value yet).
  *
  * @param getter A reactive getter to track
- * @returns A reactive getter for the previous value
+ * @returns A reactive getter for the previous value, with `dispose()` to stop
+ *   tracking the source
  *
  * @example
  * ```ts
@@ -291,7 +294,7 @@ declare function infiniteQuery<TData, TPageParam = number>(key: string | (() =>
  * prev(); // 5
  * ```
  */
-declare function previous<T>(getter: () => T): () => T | undefined;
+declare function previous<T>(getter: () => T): DisposableAccessor<T | undefined>;
 
 /**
  * Returns a debounced reactive getter that only updates after `delay` ms
@@ -299,7 +302,8 @@ declare function previous<T>(getter: () => T): () => T | undefined;
  *
  * @param getter A reactive getter to debounce
  * @param delay Debounce delay in milliseconds
- * @returns A reactive getter for the debounced value
+ * @returns A reactive getter for the debounced value, with `dispose()` to stop
+ *   tracking the source and cancel the pending timer
  *
  * @example
  * ```ts
@@ -308,7 +312,7 @@ declare function previous<T>(getter: () => T): () => T | undefined;
  * // debouncedSearch() only updates 300ms after the last setSearch call
  * ```
  */
-declare function debounce<T>(getter: () => T, delay: number): () => T;
+declare function debounce<T>(getter: () => T, delay: number): DisposableAccessor<T>;
 
 /**
  * Returns a throttled reactive getter that updates at most once per `interval` ms.
@@ -317,7 +321,8 @@ declare function debounce<T>(getter: () => T, delay: number): () => T;
  *
  * @param getter A reactive getter to throttle
  * @param interval Throttle interval in milliseconds
- * @returns A reactive getter for the throttled value
+ * @returns A reactive getter for the throttled value, with `dispose()` to stop
+ *   tracking the source and clear the cooldown timer
  *
  * @example
  * ```ts
@@ -326,7 +331,7 @@ declare function debounce<T>(getter: () => T, delay: number): () => T;
  * // throttled() updates at most once every 100ms
  * ```
  */
-declare function throttle<T>(getter: () => T, interval: number): () => T;
+declare function throttle<T>(getter: () => T, interval: number): DisposableAccessor<T>;
 
 /**
  * Lifecycle callbacks follow the shared data-layer contract: an exception
@@ -527,14 +532,47 @@ interface LoaderRoute {
 }
 /**
  * Execute a route loader and wrap its result in a reactive Resource.
+ *
+ * Executing a loader does not make its data visible to `loaderData()`; render
+ * the route's component inside {@link renderWithLoader} (or use
+ * {@link withLoader}) so the component reads its own route's data.
  */
 declare function executeLoader<T>(loader: RouteLoaderFn<T>, context: {
     params: Record<string, string>;
     path: string;
 }, options?: ResourceOptions<T>): Resource<T>;
 /**
- * Access loader data from within a route component.
- * Must be called inside a component rendered by a route with a loader.
+ * Run `render` with `loader` as the loader data seen by `loaderData()`, then
+ * restore the previous scope — even if `render` throws. Scopes nest: an inner
+ * call shadows the outer one only for its own duration.
+ *
+ * `loaderData()` must be called synchronously while `render` runs (typically at
+ * the top of the component); the accessors it returns stay bound to `loader`
+ * afterwards.
+ *
+ * @example
+ * ```ts
+ * const data = executeLoader(route.loader, ctx);
+ * const view = renderWithLoader(data, () => route.component());
+ * ```
+ */
+declare function renderWithLoader<T, R>(loader: Resource<T>, render: () => R): R;
+/**
+ * Execute `loader` and render with its data in scope, in one step. Returns the
+ * rendered result together with the resource, which the caller disposes when
+ * the route unmounts.
+ */
+declare function withLoader<T, R>(loader: RouteLoaderFn<T>, context: {
+    params: Record<string, string>;
+    path: string;
+}, render: () => R, options?: ResourceOptions<T>): {
+    view: R;
+    resource: Resource<T>;
+};
+/**
+ * Access loader data from within a route component: the innermost
+ * {@link renderWithLoader} scope (per SSR request on the server). Throws when
+ * called outside such a scope, or when that scope's loader has been disposed.
  */
 declare function loaderData<T = unknown>(): {
     data: () => T | undefined;
@@ -596,4 +634,4 @@ declare function stream(url: string, options?: {
     dispose: () => void;
 };
 
-export { type ConflictStrategy, type InfiniteQueryOptions, type InfiniteQueryResult, type LoaderRoute, type MutationOptions, type MutationResult, type OfflineStore, type OfflineStoreOptions, type QueryOptions, type QueryResult, type Resource, type ResourceOptions, type RetryOptions, type RouteLoaderFn, type SyncAdapter, type SyncChange, type SyncConflict, type SyncResult, __resetQueryCache, calculateDelay, clearQueryCache, debounce, executeLoader, getQueryData, infiniteQuery, invalidateQueries, loaderData, mutation, offlineStore, preloadRoute, previous, query, resource, setQueryData, socket, stream, syncAdapter, throttle, withRetry };
+export { type ConflictStrategy, type InfiniteQueryOptions, type InfiniteQueryResult, type LoaderRoute, type MutationOptions, type MutationResult, type OfflineStore, type OfflineStoreOptions, type QueryOptions, type QueryResult, type Resource, type ResourceOptions, type RetryOptions, type RouteLoaderFn, type SyncAdapter, type SyncChange, type SyncConflict, type SyncResult, __resetQueryCache, calculateDelay, clearQueryCache, debounce, executeLoader, getQueryData, infiniteQuery, invalidateQueries, loaderData, mutation, offlineStore, preloadRoute, previous, query, renderWithLoader, resource, setQueryData, socket, stream, syncAdapter, throttle, withLoader, withRetry };

package/dist/data.d.ts

@@ -1,3 +1,5 @@
+import { D as DisposableAccessor } from './signal-EotCj4hS.js';
+
 /**
  * Configurable retry strategies for async operations.
  * Used by `resource` and `query` for automatic error recovery.
@@ -278,7 +280,8 @@ declare function infiniteQuery<TData, TPageParam = number>(key: string | (() =>
  * Returns `undefined` on first read (there is no previous value yet).
  *
  * @param getter A reactive getter to track
- * @returns A reactive getter for the previous value
+ * @returns A reactive getter for the previous value, with `dispose()` to stop
+ *   tracking the source
  *
  * @example
  * ```ts
@@ -291,7 +294,7 @@ declare function infiniteQuery<TData, TPageParam = number>(key: string | (() =>
  * prev(); // 5
  * ```
  */
-declare function previous<T>(getter: () => T): () => T | undefined;
+declare function previous<T>(getter: () => T): DisposableAccessor<T | undefined>;
 
 /**
  * Returns a debounced reactive getter that only updates after `delay` ms
@@ -299,7 +302,8 @@ declare function previous<T>(getter: () => T): () => T | undefined;
  *
  * @param getter A reactive getter to debounce
  * @param delay Debounce delay in milliseconds
- * @returns A reactive getter for the debounced value
+ * @returns A reactive getter for the debounced value, with `dispose()` to stop
+ *   tracking the source and cancel the pending timer
  *
  * @example
  * ```ts
@@ -308,7 +312,7 @@ declare function previous<T>(getter: () => T): () => T | undefined;
  * // debouncedSearch() only updates 300ms after the last setSearch call
  * ```
  */
-declare function debounce<T>(getter: () => T, delay: number): () => T;
+declare function debounce<T>(getter: () => T, delay: number): DisposableAccessor<T>;
 
 /**
  * Returns a throttled reactive getter that updates at most once per `interval` ms.
@@ -317,7 +321,8 @@ declare function debounce<T>(getter: () => T, delay: number): () => T;
  *
  * @param getter A reactive getter to throttle
  * @param interval Throttle interval in milliseconds
- * @returns A reactive getter for the throttled value
+ * @returns A reactive getter for the throttled value, with `dispose()` to stop
+ *   tracking the source and clear the cooldown timer
  *
  * @example
  * ```ts
@@ -326,7 +331,7 @@ declare function debounce<T>(getter: () => T, delay: number): () => T;
  * // throttled() updates at most once every 100ms
  * ```
  */
-declare function throttle<T>(getter: () => T, interval: number): () => T;
+declare function throttle<T>(getter: () => T, interval: number): DisposableAccessor<T>;
 
 /**
  * Lifecycle callbacks follow the shared data-layer contract: an exception
@@ -527,14 +532,47 @@ interface LoaderRoute {
 }
 /**
  * Execute a route loader and wrap its result in a reactive Resource.
+ *
+ * Executing a loader does not make its data visible to `loaderData()`; render
+ * the route's component inside {@link renderWithLoader} (or use
+ * {@link withLoader}) so the component reads its own route's data.
  */
 declare function executeLoader<T>(loader: RouteLoaderFn<T>, context: {
     params: Record<string, string>;
     path: string;
 }, options?: ResourceOptions<T>): Resource<T>;
 /**
- * Access loader data from within a route component.
- * Must be called inside a component rendered by a route with a loader.
+ * Run `render` with `loader` as the loader data seen by `loaderData()`, then
+ * restore the previous scope — even if `render` throws. Scopes nest: an inner
+ * call shadows the outer one only for its own duration.
+ *
+ * `loaderData()` must be called synchronously while `render` runs (typically at
+ * the top of the component); the accessors it returns stay bound to `loader`
+ * afterwards.
+ *
+ * @example
+ * ```ts
+ * const data = executeLoader(route.loader, ctx);
+ * const view = renderWithLoader(data, () => route.component());
+ * ```
+ */
+declare function renderWithLoader<T, R>(loader: Resource<T>, render: () => R): R;
+/**
+ * Execute `loader` and render with its data in scope, in one step. Returns the
+ * rendered result together with the resource, which the caller disposes when
+ * the route unmounts.
+ */
+declare function withLoader<T, R>(loader: RouteLoaderFn<T>, context: {
+    params: Record<string, string>;
+    path: string;
+}, render: () => R, options?: ResourceOptions<T>): {
+    view: R;
+    resource: Resource<T>;
+};
+/**
+ * Access loader data from within a route component: the innermost
+ * {@link renderWithLoader} scope (per SSR request on the server). Throws when
+ * called outside such a scope, or when that scope's loader has been disposed.
  */
 declare function loaderData<T = unknown>(): {
     data: () => T | undefined;
@@ -596,4 +634,4 @@ declare function stream(url: string, options?: {
     dispose: () => void;
 };
 
-export { type ConflictStrategy, type InfiniteQueryOptions, type InfiniteQueryResult, type LoaderRoute, type MutationOptions, type MutationResult, type OfflineStore, type OfflineStoreOptions, type QueryOptions, type QueryResult, type Resource, type ResourceOptions, type RetryOptions, type RouteLoaderFn, type SyncAdapter, type SyncChange, type SyncConflict, type SyncResult, __resetQueryCache, calculateDelay, clearQueryCache, debounce, executeLoader, getQueryData, infiniteQuery, invalidateQueries, loaderData, mutation, offlineStore, preloadRoute, previous, query, resource, setQueryData, socket, stream, syncAdapter, throttle, withRetry };
+export { type ConflictStrategy, type InfiniteQueryOptions, type InfiniteQueryResult, type LoaderRoute, type MutationOptions, type MutationResult, type OfflineStore, type OfflineStoreOptions, type QueryOptions, type QueryResult, type Resource, type ResourceOptions, type RetryOptions, type RouteLoaderFn, type SyncAdapter, type SyncChange, type SyncConflict, type SyncResult, __resetQueryCache, calculateDelay, clearQueryCache, debounce, executeLoader, getQueryData, infiniteQuery, invalidateQueries, loaderData, mutation, offlineStore, preloadRoute, previous, query, renderWithLoader, resource, setQueryData, socket, stream, syncAdapter, throttle, withLoader, withRetry };

package/dist/data.js

@@ -13,23 +13,24 @@ import {
   preloadRoute,
   previous,
   query,
+  renderWithLoader,
   resource,
   setQueryData,
   socket,
   stream,
   syncAdapter,
   throttle,
+  withLoader,
   withRetry
-} from "./chunk-3JZ4L5TJ.js";
-import "./chunk-VUF4ALSW.js";
-import "./chunk-RBTPLM32.js";
-import "./chunk-IXKSNWV5.js";
+} from "./chunk-PK6FK2G2.js";
+import "./chunk-QE4TTDU3.js";
+import "./chunk-2INLLLMZ.js";
 import "./chunk-7ZHH77QA.js";
-import "./chunk-RIXRAYIU.js";
-import "./chunk-5DXA2J44.js";
-import "./chunk-XZZOBQAY.js";
-import "./chunk-UGRX3S57.js";
-import "./chunk-2WLZ6757.js";
+import "./chunk-XC4MEKGA.js";
+import "./chunk-7XHATCIH.js";
+import "./chunk-D33YTSX5.js";
+import "./chunk-5Q4R7HCL.js";
+import "./chunk-NYNYSPK7.js";
 export {
   __resetQueryCache,
   calculateDelay,
@@ -45,11 +46,13 @@ export {
   preloadRoute,
   previous,
   query,
+  renderWithLoader,
   resource,
   setQueryData,
   socket,
   stream,
   syncAdapter,
   throttle,
+  withLoader,
   withRetry
 };

package/dist/devtools.cjs

@@ -280,6 +280,79 @@ function reportError(error, context) {
   });
 }
 
+// src/core/rendering/dispose.ts
+var elementDisposers = /* @__PURE__ */ new WeakMap();
+var MAX_DRAIN_TEARDOWNS = 1e4;
+function reportDrainRunaway(label, executed, remaining) {
+  if (typeof console === "undefined") return;
+  console.error(
+    `[SibuJS ${label}] runaway cleanup: stopped after running ${executed} teardowns with ${remaining} still queued. Cleanup production did not stabilize before the teardown safety ceiling was reached \u2014 the remaining work was NOT run.`,
+    { executed, remaining }
+  );
+}
+var activeBindingCount = 0;
+function resolveCapture(capture) {
+  let frame = capture;
+  while (frame?.closed) frame = frame.forwardTo;
+  return frame ?? null;
+}
+var registrationCaptures = [];
+function currentDisposerCapture() {
+  return resolveCapture(registrationCaptures[registrationCaptures.length - 1]);
+}
+function beginDisposerCapture(capture) {
+  if (capture === null && registrationCaptures.length === 0) return false;
+  registrationCaptures.push(resolveCapture(capture));
+  return true;
+}
+function endDisposerCapture() {
+  registrationCaptures.pop();
+}
+function dispose(node) {
+  const stack = [node];
+  const order = [];
+  while (stack.length > 0) {
+    const current = stack.pop();
+    order.push(current);
+    const children = Array.from(current.childNodes);
+    for (let i = 0; i < children.length; i++) {
+      stack.push(children[i]);
+    }
+  }
+  for (let i = order.length - 1; i >= 0; i--) {
+    disposeNodeOwn(order[i]);
+  }
+}
+function disposeNodeOwn(node) {
+  if (!elementDisposers.has(node)) return;
+  let executed = 0;
+  let runaway = false;
+  while (!runaway) {
+    const pending = elementDisposers.get(node);
+    if (!pending || pending.length === 0) break;
+    const snapshot = pending.slice();
+    elementDisposers.delete(node);
+    if (DEV) activeBindingCount -= snapshot.length;
+    for (let i = 0; i < snapshot.length; i++) {
+      if (executed >= MAX_DRAIN_TEARDOWNS) {
+        const rest = snapshot.slice(i);
+        const added = elementDisposers.get(node);
+        elementDisposers.set(node, added ? rest.concat(added) : rest);
+        if (DEV) activeBindingCount += rest.length;
+        reportDrainRunaway("dispose", executed, rest.length + (added?.length ?? 0));
+        runaway = true;
+        break;
+      }
+      executed++;
+      try {
+        snapshot[i]();
+      } catch (err) {
+        reportError(err, { phase: "cleanup", name: "disposer" });
+      }
+    }
+  }
+}
+
 // src/reactivity/track-core.ts
 var POOL_MAX = 4096;
 var nodePool = [];
@@ -438,6 +511,7 @@ function retrack(effectFn, subscriber) {
   }
   currentSubscriber = subscriber;
   const sub = subscriber;
+  if (sub._cap === void 0) sub._cap = currentDisposerCapture();
   const epoch = ++subscriberEpochCounter;
   sub._epoch = epoch;
   sub._structDirty = false;
@@ -629,7 +703,12 @@ function drainQueue() {
       quarantined.add(sub);
       continue;
     }
-    safeInvoke(sub);
+    const pushed = beginDisposerCapture(sub._cap ?? null);
+    try {
+      safeInvoke(sub);
+    } finally {
+      if (pushed) endDisposerCapture();
+    }
   }
 }
 function drainNotificationQueue() {
@@ -765,7 +844,7 @@ function forEachSubscriber(signal2, visit) {
 }
 
 // src/reactivity/track.ts
-var _runtimeVersion = true ? "4.5.0" : "dev";
+var _runtimeVersion = true ? "4.6.0" : "dev";
 var REGISTRY_KEY = /* @__PURE__ */ Symbol.for("sibujs.reactive.v1");
 function resolveReactiveApi() {
   const g = globalThis;
@@ -1637,61 +1716,6 @@ function devState(name, initial) {
   return [get, trackedSet];
 }
 
-// src/core/rendering/dispose.ts
-var elementDisposers = /* @__PURE__ */ new WeakMap();
-var MAX_DRAIN_TEARDOWNS = 1e4;
-function reportDrainRunaway(label, executed, remaining) {
-  if (typeof console === "undefined") return;
-  console.error(
-    `[SibuJS ${label}] runaway cleanup: stopped after running ${executed} teardowns with ${remaining} still queued. Cleanup production did not stabilize before the teardown safety ceiling was reached \u2014 the remaining work was NOT run.`,
-    { executed, remaining }
-  );
-}
-var activeBindingCount = 0;
-function dispose(node) {
-  const stack = [node];
-  const order = [];
-  while (stack.length > 0) {
-    const current = stack.pop();
-    order.push(current);
-    const children = Array.from(current.childNodes);
-    for (let i = 0; i < children.length; i++) {
-      stack.push(children[i]);
-    }
-  }
-  for (let i = order.length - 1; i >= 0; i--) {
-    const current = order[i];
-    if (elementDisposers.has(current)) {
-      let executed = 0;
-      let runaway = false;
-      while (!runaway) {
-        const pending = elementDisposers.get(current);
-        if (!pending || pending.length === 0) break;
-        const snapshot = pending.slice();
-        elementDisposers.delete(current);
-        if (DEV) activeBindingCount -= snapshot.length;
-        for (let i2 = 0; i2 < snapshot.length; i2++) {
-          if (executed >= MAX_DRAIN_TEARDOWNS) {
-            const rest = snapshot.slice(i2);
-            const added = elementDisposers.get(current);
-            elementDisposers.set(current, added ? rest.concat(added) : rest);
-            if (DEV) activeBindingCount += rest.length;
-            reportDrainRunaway("dispose", executed, rest.length + (added?.length ?? 0));
-            runaway = true;
-            break;
-          }
-          executed++;
-          try {
-            snapshot[i2]();
-          } catch (err) {
-            reportError(err, { phase: "cleanup", name: "disposer" });
-          }
-        }
-      }
-    }
-  }
-}
-
 // src/devtools/hmr.ts
 var HMR_STORE_MAX_SIZE = 200;
 var hmrStateStore = /* @__PURE__ */ new Map();

package/dist/devtools.js

@@ -35,17 +35,16 @@ import {
   trackCleanup,
   walkDependencyGraph,
   withErrorTracking
-} from "./chunk-FTIR4QW2.js";
-import "./chunk-IXKSNWV5.js";
+} from "./chunk-7NCARGJW.js";
+import "./chunk-2INLLLMZ.js";
 import "./chunk-7ZHH77QA.js";
-import "./chunk-RIXRAYIU.js";
-import "./chunk-5DXA2J44.js";
-import "./chunk-QKRPLZ2V.js";
-import "./chunk-XZZOBQAY.js";
-import "./chunk-UGRX3S57.js";
+import "./chunk-XC4MEKGA.js";
+import "./chunk-7XHATCIH.js";
+import "./chunk-D33YTSX5.js";
+import "./chunk-5Q4R7HCL.js";
 import {
   isDev
-} from "./chunk-2WLZ6757.js";
+} from "./chunk-NYNYSPK7.js";
 
 // src/devtools/signalGraph.ts
 function getHook() {

package/dist/dispose-GEIG2KOF.js

@@ -0,0 +1,28 @@
+import {
+  MAX_DRAIN_TEARDOWNS,
+  beginDisposerCapture,
+  checkLeaks,
+  currentDisposerCapture,
+  dispose,
+  disposeNodeOwn,
+  endDisposerCapture,
+  registerDisposer,
+  replaceChildrenSafely,
+  reportDrainRunaway,
+  unregisterDisposer,
+  withDisposerRollback
+} from "./chunk-NYNYSPK7.js";
+export {
+  MAX_DRAIN_TEARDOWNS,
+  beginDisposerCapture,
+  checkLeaks,
+  currentDisposerCapture,
+  dispose,
+  disposeNodeOwn,
+  endDisposerCapture,
+  registerDisposer,
+  replaceChildrenSafely,
+  reportDrainRunaway,
+  unregisterDisposer,
+  withDisposerRollback
+};