sibujs 4.8.0 → 4.10.0

package/dist/data.d.cts

@@ -133,12 +133,33 @@ type StructuralSharingOption<T> = boolean | ((prev: T, next: T) => T);
  * mutation rather than a notification — see `MutationOptions.onMutate`.
  */
 interface QueryOptions<T> {
-    /** Time in ms before cached data is considered stale. Default: 0 (always stale) */
+    /**
+     * Time in ms before cached data is considered stale. Default: 0 (always stale)
+     *
+     * Staleness is acted on when the query mounts, when its resolved key
+     * changes, when `enabled` turns on, and by the explicit triggers (`refetch()`,
+     * `invalidateQueries`, the interval, focus, reconnect). A key getter that
+     * re-runs and resolves to the SAME key is not a key change and never
+     * refetches, whatever the data's age — no `derived()` wrapper needed.
+     */
     staleTime?: number;
     /** Time in ms to keep unused cache entries. Default: 300000 (5 min) */
     cacheTime?: number;
-    /** Whether to fetch on creation. Default: true */
-    enabled?: boolean;
+    /**
+     * Whether the query may fetch. Default: `true`.
+     *
+     * A function is reactive: while it returns `false` the query stays idle
+     * (nothing fetches — not the key effect, `refetch()`, `invalidateQueries`,
+     * the interval, focus or reconnect), and it fetches as soon as it returns
+     * `true`, following the usual staleness rules.
+     *
+     * ```ts
+     * query(() => `user:${userId()}`, fetchUser, { enabled: () => userId() != null });
+     * ```
+     *
+     * An empty key (`""`) also holds a query idle, without creating a cache entry.
+     */
+    enabled?: boolean | (() => boolean);
     /** Retry options for failed fetches */
     retry?: RetryOptions;
     /** Initial data before first fetch */
@@ -325,8 +346,14 @@ interface InfiniteQueryOptions<TData, TPageParam = number> {
      * unbounded.
      */
     maxPages?: number;
-    /** Whether to fetch on creation. Default: true */
-    enabled?: boolean;
+    /**
+     * Whether the query may load its first page. Default: `true`.
+     *
+     * A function is reactive: while it returns `false` the query stays idle, and
+     * each time it turns `true` the query loads from `initialPageParam`, as a key
+     * change does.
+     */
+    enabled?: boolean | (() => boolean);
     /** Retry options */
     retry?: RetryOptions;
     /** Called on successful page fetch */

package/dist/data.d.ts

@@ -133,12 +133,33 @@ type StructuralSharingOption<T> = boolean | ((prev: T, next: T) => T);
  * mutation rather than a notification — see `MutationOptions.onMutate`.
  */
 interface QueryOptions<T> {
-    /** Time in ms before cached data is considered stale. Default: 0 (always stale) */
+    /**
+     * Time in ms before cached data is considered stale. Default: 0 (always stale)
+     *
+     * Staleness is acted on when the query mounts, when its resolved key
+     * changes, when `enabled` turns on, and by the explicit triggers (`refetch()`,
+     * `invalidateQueries`, the interval, focus, reconnect). A key getter that
+     * re-runs and resolves to the SAME key is not a key change and never
+     * refetches, whatever the data's age — no `derived()` wrapper needed.
+     */
     staleTime?: number;
     /** Time in ms to keep unused cache entries. Default: 300000 (5 min) */
     cacheTime?: number;
-    /** Whether to fetch on creation. Default: true */
-    enabled?: boolean;
+    /**
+     * Whether the query may fetch. Default: `true`.
+     *
+     * A function is reactive: while it returns `false` the query stays idle
+     * (nothing fetches — not the key effect, `refetch()`, `invalidateQueries`,
+     * the interval, focus or reconnect), and it fetches as soon as it returns
+     * `true`, following the usual staleness rules.
+     *
+     * ```ts
+     * query(() => `user:${userId()}`, fetchUser, { enabled: () => userId() != null });
+     * ```
+     *
+     * An empty key (`""`) also holds a query idle, without creating a cache entry.
+     */
+    enabled?: boolean | (() => boolean);
     /** Retry options for failed fetches */
     retry?: RetryOptions;
     /** Initial data before first fetch */
@@ -325,8 +346,14 @@ interface InfiniteQueryOptions<TData, TPageParam = number> {
      * unbounded.
      */
     maxPages?: number;
-    /** Whether to fetch on creation. Default: true */
-    enabled?: boolean;
+    /**
+     * Whether the query may load its first page. Default: `true`.
+     *
+     * A function is reactive: while it returns `false` the query stays idle, and
+     * each time it turns `true` the query loads from `initialPageParam`, as a key
+     * change does.
+     */
+    enabled?: boolean | (() => boolean);
     /** Retry options */
     retry?: RetryOptions;
     /** Called on successful page fetch */

package/dist/data.js

@@ -22,14 +22,14 @@ import {
   throttle,
   withLoader,
   withRetry
-} from "./chunk-UCNP3HVM.js";
-import "./chunk-KJ3UKABJ.js";
+} from "./chunk-GMMDHJJT.js";
+import "./chunk-5PC7OTQW.js";
 import "./chunk-7ZHH77QA.js";
-import "./chunk-V3LHZSU5.js";
+import "./chunk-7WIHYHWD.js";
 import "./chunk-EXXSN3BW.js";
 import "./chunk-7XHATCIH.js";
-import "./chunk-DSID757X.js";
-import "./chunk-TQQUN4WR.js";
+import "./chunk-FYUEL5IW.js";
+import "./chunk-D6HYFOWR.js";
 import "./chunk-NYNYSPK7.js";
 export {
   __resetQueryCache,

package/dist/devtools.cjs

@@ -497,6 +497,24 @@ function untracked(fn) {
     resumeTracking();
   }
 }
+var currentOwnerScope = null;
+function getOwnerScope() {
+  return currentOwnerScope;
+}
+function runWithOwnerScope(scope, fn) {
+  const prev = currentOwnerScope;
+  currentOwnerScope = scope;
+  try {
+    return fn();
+  } finally {
+    currentOwnerScope = prev;
+  }
+}
+function bindOwnerScope(fn) {
+  const scope = currentOwnerScope;
+  if (scope === null) return fn;
+  return (...args) => runWithOwnerScope(scope, () => fn(...args));
+}
 var subscriberEpochCounter = 0;
 function retrack(effectFn, subscriber) {
   const prev = currentSubscriber;
@@ -512,6 +530,10 @@ function retrack(effectFn, subscriber) {
   currentSubscriber = subscriber;
   const sub = subscriber;
   if (sub._cap === void 0) sub._cap = currentDisposerCapture();
+  const prevScope = currentOwnerScope;
+  if (prevScope !== null && !sub._epoch && sub._scope === void 0) sub._scope = prevScope;
+  const scope = sub._scope === void 0 ? null : sub._scope;
+  if (scope !== prevScope) currentOwnerScope = scope;
   const epoch = ++subscriberEpochCounter;
   sub._epoch = epoch;
   sub._structDirty = false;
@@ -524,6 +546,7 @@ function retrack(effectFn, subscriber) {
     effectFn();
   } finally {
     currentSubscriber = prev;
+    currentOwnerScope = prevScope;
     if (savedDepth !== 0) {
       suspendDepth = savedDepth;
       suspendSavedSub = savedSuspendSub;
@@ -558,23 +581,26 @@ function track(effectFn, subscriber) {
     trackingSuspended = false;
   }
   currentSubscriber = subscriber;
+  const sub = subscriber;
+  if (sub._scope === void 0) sub._scope = currentOwnerScope;
+  const prevScope = currentOwnerScope;
+  currentOwnerScope = sub._scope;
   try {
     effectFn();
   } finally {
     currentSubscriber = prev;
+    currentOwnerScope = prevScope;
     if (savedDepth !== 0) {
       suspendDepth = savedDepth;
       suspendSavedSub = savedSuspendSub;
       trackingSuspended = true;
     }
-    const sub2 = subscriber;
-    for (let n = sub2.depsHead ?? null; n !== null; n = n.subNext) {
+    for (let n = sub.depsHead ?? null; n !== null; n = n.subNext) {
       const sig = n.sig;
       sig.__activeNode = n.prevActive;
       n.prevActive = null;
     }
   }
-  const sub = subscriber;
   return sub._dispose ?? (sub._dispose = () => cleanup(subscriber));
 }
 function reactiveBinding(commit, ownerNode) {
@@ -844,7 +870,7 @@ function forEachSubscriber(signal2, visit) {
 }
 
 // src/reactivity/track.ts
-var _runtimeVersion = true ? "4.8.0" : "dev";
+var _runtimeVersion = true ? "4.10.0" : "dev";
 var REGISTRY_KEY = /* @__PURE__ */ Symbol.for("sibujs.reactive.v1");
 function resolveReactiveApi() {
   const g = globalThis;
@@ -876,6 +902,9 @@ function resolveReactiveApi() {
     getSubscriberCount,
     getSubscriberDeps,
     forEachSubscriber,
+    getOwnerScope,
+    runWithOwnerScope,
+    bindOwnerScope,
     version: _runtimeVersion
   };
   g[REGISTRY_KEY] = local;
@@ -899,6 +928,9 @@ var notifySubscribers2 = API.notifySubscribers;
 var getSubscriberCount2 = API.getSubscriberCount;
 var getSubscriberDeps2 = API.getSubscriberDeps;
 var forEachSubscriber2 = API.forEachSubscriber;
+var getOwnerScope2 = API.getOwnerScope ?? getOwnerScope;
+var runWithOwnerScope2 = API.runWithOwnerScope ?? runWithOwnerScope;
+var bindOwnerScope2 = API.bindOwnerScope ?? bindOwnerScope;
 
 // src/reactivity/batch.ts
 var batchDepth = 0;
@@ -2064,6 +2096,11 @@ function flushUserCleanups(ctx) {
   const list = ctx.userCleanups;
   if (list.length === 0) return;
   ctx.userCleanups = [];
+  const scope = ctx.subscriber._scope ?? null;
+  if (scope === getOwnerScope2()) runCleanups2(list);
+  else runWithOwnerScope2(scope, () => runCleanups2(list));
+}
+function runCleanups2(list) {
   for (let i = list.length - 1; i >= 0; i--) {
     try {
       list[i]();

package/dist/devtools.js

@@ -35,13 +35,13 @@ import {
   trackCleanup,
   walkDependencyGraph,
   withErrorTracking
-} from "./chunk-44MTL7ED.js";
+} from "./chunk-BMCR7TXG.js";
 import "./chunk-7ZHH77QA.js";
-import "./chunk-V3LHZSU5.js";
+import "./chunk-7WIHYHWD.js";
 import "./chunk-EXXSN3BW.js";
 import "./chunk-7XHATCIH.js";
-import "./chunk-DSID757X.js";
-import "./chunk-TQQUN4WR.js";
+import "./chunk-FYUEL5IW.js";
+import "./chunk-D6HYFOWR.js";
 import {
   isDev
 } from "./chunk-NYNYSPK7.js";

package/dist/ecosystem.cjs

@@ -369,6 +369,24 @@ function untracked(fn) {
     resumeTracking();
   }
 }
+var currentOwnerScope = null;
+function getOwnerScope() {
+  return currentOwnerScope;
+}
+function runWithOwnerScope(scope, fn) {
+  const prev = currentOwnerScope;
+  currentOwnerScope = scope;
+  try {
+    return fn();
+  } finally {
+    currentOwnerScope = prev;
+  }
+}
+function bindOwnerScope(fn) {
+  const scope = currentOwnerScope;
+  if (scope === null) return fn;
+  return (...args) => runWithOwnerScope(scope, () => fn(...args));
+}
 var subscriberEpochCounter = 0;
 function retrack(effectFn, subscriber) {
   const prev = currentSubscriber;
@@ -384,6 +402,10 @@ function retrack(effectFn, subscriber) {
   currentSubscriber = subscriber;
   const sub = subscriber;
   if (sub._cap === void 0) sub._cap = currentDisposerCapture();
+  const prevScope = currentOwnerScope;
+  if (prevScope !== null && !sub._epoch && sub._scope === void 0) sub._scope = prevScope;
+  const scope = sub._scope === void 0 ? null : sub._scope;
+  if (scope !== prevScope) currentOwnerScope = scope;
   const epoch = ++subscriberEpochCounter;
   sub._epoch = epoch;
   sub._structDirty = false;
@@ -396,6 +418,7 @@ function retrack(effectFn, subscriber) {
     effectFn();
   } finally {
     currentSubscriber = prev;
+    currentOwnerScope = prevScope;
     if (savedDepth !== 0) {
       suspendDepth = savedDepth;
       suspendSavedSub = savedSuspendSub;
@@ -430,23 +453,26 @@ function track(effectFn, subscriber) {
     trackingSuspended = false;
   }
   currentSubscriber = subscriber;
+  const sub = subscriber;
+  if (sub._scope === void 0) sub._scope = currentOwnerScope;
+  const prevScope = currentOwnerScope;
+  currentOwnerScope = sub._scope;
   try {
     effectFn();
   } finally {
     currentSubscriber = prev;
+    currentOwnerScope = prevScope;
     if (savedDepth !== 0) {
       suspendDepth = savedDepth;
       suspendSavedSub = savedSuspendSub;
       trackingSuspended = true;
     }
-    const sub2 = subscriber;
-    for (let n = sub2.depsHead ?? null; n !== null; n = n.subNext) {
+    for (let n = sub.depsHead ?? null; n !== null; n = n.subNext) {
       const sig = n.sig;
       sig.__activeNode = n.prevActive;
       n.prevActive = null;
     }
   }
-  const sub = subscriber;
   return sub._dispose ?? (sub._dispose = () => cleanup(subscriber));
 }
 function reactiveBinding(commit, ownerNode) {
@@ -716,7 +742,7 @@ function forEachSubscriber(signal2, visit) {
 }
 
 // src/reactivity/track.ts
-var _runtimeVersion = true ? "4.8.0" : "dev";
+var _runtimeVersion = true ? "4.10.0" : "dev";
 var REGISTRY_KEY = /* @__PURE__ */ Symbol.for("sibujs.reactive.v1");
 function resolveReactiveApi() {
   const g = globalThis;
@@ -748,6 +774,9 @@ function resolveReactiveApi() {
     getSubscriberCount,
     getSubscriberDeps,
     forEachSubscriber,
+    getOwnerScope,
+    runWithOwnerScope,
+    bindOwnerScope,
     version: _runtimeVersion
   };
   g[REGISTRY_KEY] = local;
@@ -771,6 +800,9 @@ var notifySubscribers2 = API.notifySubscribers;
 var getSubscriberCount2 = API.getSubscriberCount;
 var getSubscriberDeps2 = API.getSubscriberDeps;
 var forEachSubscriber2 = API.forEachSubscriber;
+var getOwnerScope2 = API.getOwnerScope ?? getOwnerScope;
+var runWithOwnerScope2 = API.runWithOwnerScope ?? runWithOwnerScope;
+var bindOwnerScope2 = API.bindOwnerScope ?? bindOwnerScope;
 
 // src/core/devtoolsHook.ts
 function emitDevtools(hook, event, payload) {
@@ -826,6 +858,11 @@ function flushUserCleanups(ctx) {
   const list = ctx.userCleanups;
   if (list.length === 0) return;
   ctx.userCleanups = [];
+  const scope = ctx.subscriber._scope ?? null;
+  if (scope === getOwnerScope2()) runCleanups(list);
+  else runWithOwnerScope2(scope, () => runCleanups(list));
+}
+function runCleanups(list) {
   for (let i = list.length - 1; i >= 0; i--) {
     try {
       list[i]();

package/dist/ecosystem.js

@@ -7,19 +7,19 @@ import {
   mobXAdapter,
   reduxAdapter,
   zustandAdapter
-} from "./chunk-4WMSTZ7J.js";
+} from "./chunk-VWPMWV7O.js";
 import "./chunk-J6FW5TV6.js";
-import "./chunk-VWT3VXPL.js";
-import "./chunk-O6TRVMJI.js";
+import "./chunk-EVI4ZQO3.js";
+import "./chunk-XUQUQJYE.js";
 import "./chunk-3ACAAQIN.js";
-import "./chunk-KJ3UKABJ.js";
+import "./chunk-5PC7OTQW.js";
 import "./chunk-7ZHH77QA.js";
-import "./chunk-V3LHZSU5.js";
+import "./chunk-7WIHYHWD.js";
 import "./chunk-EXXSN3BW.js";
 import "./chunk-7XHATCIH.js";
 import "./chunk-5HZXGZ6T.js";
-import "./chunk-DSID757X.js";
-import "./chunk-TQQUN4WR.js";
+import "./chunk-FYUEL5IW.js";
+import "./chunk-D6HYFOWR.js";
 import "./chunk-NYNYSPK7.js";
 export {
   antdAdapter,