@fluixi/reactive 1.0.0-alpha.92 → 1.0.0-alpha.94

package/dist/cdn/reactive.mjs

@@ -1,5 +1,5 @@
 // src/version.generated.ts
-var VERSION = "1.0.0-alpha.92";
+var VERSION = "1.0.0-alpha.94";
 
 // src/lib/predicates.ts
 function isFunction(value) {
@@ -490,11 +490,40 @@ function withReactiveOrigin(owner, fn) {
     origin = previous;
   }
 }
+var currentScope;
+function openReactiveScope(info) {
+  const scope = {};
+  G.observer?.scope?.(scope, info, currentScope);
+  return scope;
+}
+function withReactiveScope(scope, fn) {
+  if (!G.observer) return fn();
+  const previous = currentScope;
+  currentScope = scope;
+  try {
+    return fn();
+  } finally {
+    currentScope = previous;
+  }
+}
+function closeReactiveScope(scope) {
+  G.observer?.scopeEnded?.(scope);
+}
+function adoptReactiveScope(scope, parent) {
+  G.observer?.scopeAdopted?.(scope, parent);
+}
+var SCOPE_OF = /* @__PURE__ */ Symbol.for("fluixi.reactiveScope");
+function markReactiveScope(value, scope) {
+  Object.defineProperty(value, SCOPE_OF, { value: scope, configurable: true, enumerable: false });
+}
+function reactiveScopeOf(value) {
+  return value !== null && (typeof value === "object" || typeof value === "function") ? value[SCOPE_OF] ?? void 0 : void 0;
+}
 function reportReactiveNode(report) {
   const observer = G.observer;
   if (observer) {
     observer.created(
-      report.parents === void 0 ? { ...report, parents: running, origin: report.origin ?? origin } : report
+      report.parents === void 0 ? { ...report, parents: running, origin: report.origin ?? origin, scope: report.scope ?? currentScope } : { ...report, scope: report.scope ?? currentScope }
     );
   }
 }
@@ -914,7 +943,7 @@ function batch(fn) {
   }
 }
 var EffectNode = class {
-  constructor(fn, report = false) {
+  constructor(fn, report = false, name) {
     this.queued = false;
     this.disposed = false;
     this.owner = makeOwner(G.owner);
@@ -926,7 +955,7 @@ var EffectNode = class {
         if (typeof r === "function") (this.owner.cleanups ??= []).push(r);
       });
     });
-    reportReactiveNode({ kind: "effect", node: this.computed, handle: this, internal: !report });
+    reportReactiveNode({ kind: "effect", node: this.computed, handle: this, internal: !report, ...name ? { name } : {} });
     this.watcher = new Watcher(() => enqueue(this));
     this.run();
     this.watcher.watch(this.computed);
@@ -953,8 +982,8 @@ var EffectNode = class {
     disposeOwner(this.owner);
   }
 };
-function effect(fn, report = false) {
-  const node = new EffectNode(fn, report);
+function effect(fn, report = false, name) {
+  const node = new EffectNode(fn, report, name);
   return () => node.dispose();
 }
 
@@ -1022,12 +1051,12 @@ function createMemo(fn, value, options) {
   if (isObserved()) onCleanup(() => reportReactiveDispose(c));
   return read;
 }
-function createEffect(fn, value) {
+function createEffect(fn, value, options) {
   let prev = value;
   return effect(() => {
     const r = fn(prev);
     prev = r;
-  }, true);
+  }, true, options?.name);
 }
 function createComputed(fn, value) {
   let prev = value;
@@ -1273,6 +1302,32 @@ function setResourceDataSink(fn) {
 function reportResourceData(id, value) {
   if (_resourceDataSink) _resourceDataSink(id, value);
 }
+function createResourceCache() {
+  const entries = /* @__PURE__ */ new Map();
+  const inflight = /* @__PURE__ */ new Map();
+  return {
+    get: (key) => entries.get(key),
+    set: (key, entry) => void entries.set(key, entry),
+    delete: (key) => void entries.delete(key),
+    keys: () => entries.keys(),
+    clear: () => {
+      entries.clear();
+      inflight.clear();
+    },
+    inflight
+  };
+}
+var _cacheScope = null;
+function setResourceCacheScope(fn) {
+  _cacheScope = fn;
+}
+var _pageCache;
+function currentResourceCache() {
+  const scoped = _cacheScope?.();
+  if (scoped) return scoped;
+  if (typeof window === "undefined") return createResourceCache();
+  return _pageCache ??= createResourceCache();
+}
 
 // src/lib/signal/graph/derived.ts
 function createSelector(source, fn = (k, v) => k === v) {
@@ -1592,8 +1647,8 @@ function signal(value, options) {
 function memo(fn, value, options) {
   return createMemo(fn, value, options);
 }
-function effect2(fn, value) {
-  return createEffect(fn, value);
+function effect2(fn, value, options) {
+  return createEffect(fn, value, options);
 }
 function root(fn) {
   return createRoot(fn);
@@ -2383,12 +2438,10 @@ function readSignal(signal2) {
 }
 
 // src/lib/signal/cached-resource.ts
-var ttlCache = /* @__PURE__ */ new Map();
-var inflight = /* @__PURE__ */ new Map();
 var _autoId = 0;
 var $SIGNAL4 = /* @__PURE__ */ Symbol.for("signal");
 var $RESOURCE2 = /* @__PURE__ */ Symbol.for("resource");
-function createCachedResource(sourceOrFetcher, fetcherOrOptions, opts = {}) {
+function cachedResource(sourceOrFetcher, fetcherOrOptions, opts = {}) {
   let sourceFn;
   let fetchFn;
   let options;
@@ -2407,7 +2460,13 @@ function createCachedResource(sourceOrFetcher, fetcherOrOptions, opts = {}) {
     staleWhileRevalidate = true
   } = options;
   const ns = name;
-  const buildKey = (key) => `${ns}:${JSON.stringify(key)}`;
+  const cache = options.cache ?? currentResourceCache();
+  const inflight = cache.inflight;
+  const ssrId = options.transport === false ? void 0 : nextResourceId();
+  const seed = ssrId !== void 0 ? getServerData(ssrId) : void 0;
+  const deps = options.deps ?? [];
+  const depValues = () => deps.map((dep) => dep());
+  const buildKey = (key, values = untrack2(depValues)) => `${ns}:${JSON.stringify(key)}` + (deps.length ? `:${JSON.stringify(values)}` : "");
   const isFresh = (entry) => ttl === Infinity || Date.now() - entry.timestamp <= ttl;
   const [value, setValue] = createSignal(void 0, { equals: false });
   const [resourceState, setResourceState] = createSignal("unresolved", { equals: false });
@@ -2420,8 +2479,9 @@ function createCachedResource(sourceOrFetcher, fetcherOrOptions, opts = {}) {
   let flagRefetch = false;
   let flagInvalidate = false;
   function doFetch(key, ck, background, isCancelled) {
-    if (inflight.has(ck)) {
-      inflight.get(ck).then(
+    const running2 = inflight.get(ck);
+    if (running2) {
+      running2.then(
         (v) => {
           if (!isCancelled()) settle(v, background);
         },
@@ -2429,12 +2489,15 @@ function createCachedResource(sourceOrFetcher, fetcherOrOptions, opts = {}) {
           if (!isCancelled() && !background) fail(e);
         }
       );
-      if (!background) setPendingP(inflight.get(ck));
+      if (!background) {
+        trackResourcePromise(running2);
+        setPendingP(running2);
+      }
       return;
     }
     const promise = Promise.resolve(fetchFn(key)).then(
       (v) => {
-        ttlCache.set(ck, { value: v, timestamp: Date.now() });
+        cache.set(ck, { value: v, timestamp: Date.now() });
         inflight.delete(ck);
         return v;
       },
@@ -2457,7 +2520,8 @@ function createCachedResource(sourceOrFetcher, fetcherOrOptions, opts = {}) {
       }
     );
   }
-  function settle(v, background) {
+  function settle(v, _background) {
+    if (ssrId !== void 0) reportResourceData(ssrId, v);
     batch2(() => {
       setValue(() => v);
       setResourceState("ready");
@@ -2475,6 +2539,7 @@ function createCachedResource(sourceOrFetcher, fetcherOrOptions, opts = {}) {
   }
   createEffect(() => {
     const key = sourceFn();
+    const values = depValues();
     tick();
     if (key === false || key === null || key === void 0) {
       prevKey = UNSET2;
@@ -2489,16 +2554,18 @@ function createCachedResource(sourceOrFetcher, fetcherOrOptions, opts = {}) {
     const doInvalidate = flagInvalidate;
     flagRefetch = false;
     flagInvalidate = false;
-    const ck = buildKey(key);
-    if (doInvalidate) ttlCache.delete(ck);
+    const ck = buildKey(key, values);
+    if (seed && prevKey === UNSET2 && !cache.get(ck)) cache.set(ck, { value: seed.value, timestamp: Date.now() });
+    if (doInvalidate) cache.delete(ck);
     const keyChanged = prevKey === UNSET2 || key !== prevKey;
     prevKey = key;
     let cancelled = false;
     onCleanup(() => {
       cancelled = true;
     });
-    const cached = ttlCache.get(ck);
+    const cached = cache.get(ck);
     if (cached && isFresh(cached) && !doRefetch && !doInvalidate) {
+      if (ssrId !== void 0) reportResourceData(ssrId, cached.value);
       const cur2 = untrack2(resourceState);
       if (cur2 !== "ready" || untrack2(value) !== cached.value) {
         batch2(() => {
@@ -2559,22 +2626,17 @@ function createCachedResource(sourceOrFetcher, fetcherOrOptions, opts = {}) {
   const invalidate = () => {
     const key = untrack2(sourceFn);
     if (key !== null && key !== void 0 && key !== false) {
-      ttlCache.delete(buildKey(key));
+      cache.delete(buildKey(key));
     }
     flagInvalidate = true;
     setTick((v) => v + 1);
   };
-  return [resource2, { mutate: setValue, refetch, invalidate }];
+  return Object.assign(resource2, { mutate: setValue, refetch, invalidate });
 }
-function clearCachedResourceNamespace(name) {
+function clearCachedResources(name, cache = currentResourceCache()) {
+  if (name === void 0) return cache.clear();
   const prefix = `${name}:`;
-  for (const key of ttlCache.keys()) {
-    if (key.startsWith(prefix)) ttlCache.delete(key);
-  }
-}
-function clearAllCachedResources() {
-  ttlCache.clear();
-  inflight.clear();
+  for (const key of [...cache.keys()]) if (key.startsWith(prefix)) cache.delete(key);
 }
 export {
   $NAME,
@@ -2596,15 +2658,16 @@ export {
   SuspenseContext,
   VERSION,
   __DEV__,
+  adoptReactiveScope,
   batch2 as batch,
+  cachedResource,
   childOwner,
-  clearAllCachedResources,
-  clearCachedResourceNamespace,
+  clearCachedResources,
+  closeReactiveScope,
   combineSignal,
   combineSignals,
   computed,
   context,
-  createCachedResource,
   createChildOwner,
   createComputed,
   createComputedStore,
@@ -2619,6 +2682,7 @@ export {
   createMutableStore,
   createRenderEffect,
   createResource,
+  createResourceCache,
   createRoot,
   createSelector,
   createSignal,
@@ -2626,6 +2690,7 @@ export {
   createStoreEffect,
   createStoreMemo,
   createSuspenseBoundary,
+  currentResourceCache,
   debounceSignal,
   disposeScope,
   distinctSignal,
@@ -2654,6 +2719,7 @@ export {
   makeArrayFlat,
   mapArray,
   mapSignal,
+  markReactiveScope,
   memo,
   mergeSignal,
   modifiable,
@@ -2662,12 +2728,14 @@ export {
   omitSignal,
   on,
   onCleanup,
+  openReactiveScope,
   operate,
   pickSignal,
   produce as produceUtil,
   provide,
   provideErrorBoundary,
   provideSuspense,
+  reactiveScopeOf,
   readChildren,
   readSignal,
   reconcile as reconcileUtil,
@@ -2684,6 +2752,7 @@ export {
   runWithOwner,
   selectSignal,
   setOwner,
+  setResourceCacheScope,
   setResourceDataSink,
   setResourceIdSource,
   setResourceTracker,
@@ -2701,6 +2770,7 @@ export {
   useContext,
   useTransition,
   whenSignal,
+  withReactiveScope,
   wrap,
   zipSignal
 };

package/dist/cdn/signal.cjs

@@ -27,7 +27,7 @@ __export(signal_exports, {
 module.exports = __toCommonJS(signal_exports);
 
 // src/version.generated.ts
-var VERSION = "1.0.0-alpha.92";
+var VERSION = "1.0.0-alpha.94";
 
 // src/lib/signal/graph/state.ts
 var MAJOR = VERSION.split(".")[0];

package/dist/cdn/signal.global.js

@@ -1,2 +1,2 @@
-/*! @fluixi/reactive v1.0.0-alpha.92 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
-"use strict";var Signal=(()=>{var b=Object.defineProperty;var G=Object.getOwnPropertyDescriptor;var K=Object.getOwnPropertyNames;var j=Object.prototype.hasOwnProperty;var z=(e,t)=>{for(var n in t)b(e,n,{get:t[n],enumerable:!0})},H=(e,t,n,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of K(t))!j.call(e,s)&&s!==n&&b(e,s,{get:()=>t[s],enumerable:!(o=G(t,s))||o.enumerable});return e};var V=e=>H(b({},"__esModule",{value:!0}),e);var U={};z(U,{Computed:()=>h,State:()=>v,subtle:()=>Y});var a="1.0.0-alpha.92";var m=a.split(".")[0],_=`__fluixi_signal_state_v${m}__`,A=`__fluixi_signal_builds_v${m}__`,F=e=>{typeof queueMicrotask=="function"?queueMicrotask(e):Promise.resolve().then(e)};function R(){return{consumer:null,untracked:!1,owner:null,queue:[],scheduled:!1,flushing:!1,batchDepth:0,hostSchedule:F,onSuspend:null,onError:null,observer:null}}var w=globalThis;function L(e){let t=R(),n=e;for(let o of Object.keys(t))o in e||(n[o]=t[o]);return e}function M(){let e=w[_];return e?L(e):w[_]=R()}var r=M();(w[A]??=[]).push(a);function P(e){return r.observer=e,()=>{r.observer===e&&(r.observer=null)}}var y=[];function S(e){return r.observer?(y.push(e),!0):!1}function x(){y.pop()}function T(e){r.observer?.ran?.(e)}function O(e,t){r.observer?.wrote?.(e,t)}var W="__FLUIXI_DEVTOOLS_HOOK__",g=globalThis[W];if(typeof g?.inject=="function")try{g.inject({observeReactiveNodes:P,version:a})}catch{}var N=0,C=1,u=2,d=class{constructor(){this.observers=null;this.watchers=null;this.version=0}updateIfNecessary(){}track(){if(r.untracked)return;let t=r.consumer;t&&((this.observers??=new Set).add(t),(t.sources??=new Set).add(this))}},v=class extends d{constructor(t,n){super(),this._value=t,this._equals=n?.equals===!1?()=>!1:n?.equals??Object.is}get(){return this.track(),this._value}set(t){if(!this._equals(this._value,t)){if(this._value=t,this.version++,O(this,r.consumer),this.observers)for(let n of[...this.observers])n.markDirty(u);k(this)}}peek(){return this._value}},h=class extends d{constructor(n,o){super();this._threw=!1;this._initialized=!1;this.state=u;this.sources=null;this._fn=n,this._equals=o?.equals===!1?()=>!1:o?.equals??Object.is}get(){if(r.consumer===this)throw new Error("Signal.Computed cannot read itself");if(this.track(),this.updateIfNecessary(),this._threw)throw this._error;return this._value}updateIfNecessary(){if(this.state===C&&this.sources){for(let n of this.sources)if(n.updateIfNecessary(),this.state===u)break}(this.state===u||!this._initialized)&&this.recompute(),this.state=N}recompute(){if(this.sources){for(let i of this.sources)i.observers?.delete(this);this.sources.clear()}let n=r.consumer,o=r.untracked,s=S(this);r.consumer=this,r.untracked=!1;let c,l=!1,p;try{c=this._fn()}catch(i){l=!0,p=i,c=this._value}finally{r.consumer=n,r.untracked=o,s&&x()}let I=!this._initialized||this._threw!==l||(l?p!==this._error:!this._equals(this._value,c));if(this._initialized=!0,this._threw=l,this._error=p,this._value=c,T(this),I){if(this.version++,this.observers)for(let i of[...this.observers])i.markDirty(u);k(this)}}markDirty(n){if(this.state>=n)return;let o=this.state===N;if(this.state=n,o){if(this.observers)for(let s of[...this.observers])s.markDirty(C);k(this)}}peek(){if(this.updateIfNecessary(),this._threw)throw this._error;return this._value}};function k(e){if(e.watchers)for(let t of[...e.watchers])t._notify(e)}var f=class{constructor(t){this._watched=new Set;this._pending=new Set;this._notifyFn=t}watch(...t){for(let n of t)this._watched.add(n),(n.watchers??=new Set).add(this)}unwatch(...t){for(let n of t)this._watched.delete(n),n.watchers?.delete(this),this._pending.delete(n)}getPending(){let t=[...this._pending];return this._pending.clear(),t}_notify(t){if(!this._watched.has(t)||this._pending.has(t))return;let n=this._pending.size===0;this._pending.add(t),n&&this._notifyFn()}};function q(e){if(r.untracked)return e();r.untracked=!0;try{return e()}finally{r.untracked=!1}}function E(){return r.consumer}function D(e){return!!(e.observers&&e.observers.size)||!!(e.watchers&&e.watchers.size)}var Y={Watcher:f,untrack:q,currentComputed:E,hasSinks:D};return V(U);})();
+/*! @fluixi/reactive v1.0.0-alpha.94 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+"use strict";var Signal=(()=>{var b=Object.defineProperty;var D=Object.getOwnPropertyDescriptor;var G=Object.getOwnPropertyNames;var K=Object.prototype.hasOwnProperty;var z=(e,t)=>{for(var n in t)b(e,n,{get:t[n],enumerable:!0})},A=(e,t,n,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of G(t))!K.call(e,s)&&s!==n&&b(e,s,{get:()=>t[s],enumerable:!(r=D(t,s))||r.enumerable});return e};var H=e=>A(b({},"__esModule",{value:!0}),e);var U={};z(U,{Computed:()=>p,State:()=>l,subtle:()=>Y});var a="1.0.0-alpha.94";var R=a.split(".")[0],_=`__fluixi_signal_state_v${R}__`,P=`__fluixi_signal_builds_v${R}__`,V=e=>{typeof queueMicrotask=="function"?queueMicrotask(e):Promise.resolve().then(e)};function m(){return{consumer:null,untracked:!1,owner:null,queue:[],scheduled:!1,flushing:!1,batchDepth:0,hostSchedule:V,onSuspend:null,onError:null,observer:null}}var w=globalThis;function F(e){let t=m(),n=e;for(let r of Object.keys(t))r in e||(n[r]=t[r]);return e}function L(){let e=w[_];return e?F(e):w[_]=m()}var o=L();(w[P]??=[]).push(a);function M(e){return o.observer=e,()=>{o.observer===e&&(o.observer=null)}}var S=[];function g(e){return o.observer?(S.push(e),!0):!1}function x(){S.pop()}function T(e){o.observer?.ran?.(e)}function O(e,t){o.observer?.wrote?.(e,t)}var W="__FLUIXI_DEVTOOLS_HOOK__",y=globalThis[W];if(typeof y?.inject=="function")try{y.inject({observeReactiveNodes:M,version:a})}catch{}var j=0,N=1,c=2,v=class{constructor(){this.observers=null;this.watchers=null;this.version=0}updateIfNecessary(){}track(){if(o.untracked)return;let t=o.consumer;t&&((this.observers??=new Set).add(t),(t.sources??=new Set).add(this))}},l=class extends v{constructor(t,n){super(),this._value=t,this._equals=n?.equals===!1?()=>!1:n?.equals??Object.is}get(){return this.track(),this._value}set(t){if(!this._equals(this._value,t)){if(this._value=t,this.version++,O(this,o.consumer),this.observers)for(let n of[...this.observers])n.markDirty(c);k(this)}}peek(){return this._value}},p=class extends v{constructor(n,r){super();this._threw=!1;this._initialized=!1;this.state=c;this.sources=null;this._fn=n,this._equals=r?.equals===!1?()=>!1:r?.equals??Object.is}get(){if(o.consumer===this)throw new Error("Signal.Computed cannot read itself");if(this.track(),this.updateIfNecessary(),this._threw)throw this._error;return this._value}updateIfNecessary(){if(this.state===N&&this.sources){for(let n of this.sources)if(n.updateIfNecessary(),this.state===c)break}(this.state===c||!this._initialized)&&this.recompute(),this.state=j}recompute(){if(this.sources){for(let i of this.sources)i.observers?.delete(this);this.sources.clear()}let n=o.consumer,r=o.untracked,s=g(this);o.consumer=this,o.untracked=!1;let u,d=!1,h;try{u=this._fn()}catch(i){d=!0,h=i,u=this._value}finally{o.consumer=n,o.untracked=r,s&&x()}let I=!this._initialized||this._threw!==d||(d?h!==this._error:!this._equals(this._value,u));if(this._initialized=!0,this._threw=d,this._error=h,this._value=u,T(this),I){if(this.version++,this.observers)for(let i of[...this.observers])i.markDirty(c);k(this)}}markDirty(n){if(this.state>=n)return;let r=this.state===j;if(this.state=n,r){if(this.observers)for(let s of[...this.observers])s.markDirty(N);k(this)}}peek(){if(this.updateIfNecessary(),this._threw)throw this._error;return this._value}};function k(e){if(e.watchers)for(let t of[...e.watchers])t._notify(e)}var f=class{constructor(t){this._watched=new Set;this._pending=new Set;this._notifyFn=t}watch(...t){for(let n of t)this._watched.add(n),(n.watchers??=new Set).add(this)}unwatch(...t){for(let n of t)this._watched.delete(n),n.watchers?.delete(this),this._pending.delete(n)}getPending(){let t=[...this._pending];return this._pending.clear(),t}_notify(t){if(!this._watched.has(t)||this._pending.has(t))return;let n=this._pending.size===0;this._pending.add(t),n&&this._notifyFn()}};function C(e){if(o.untracked)return e();o.untracked=!0;try{return e()}finally{o.untracked=!1}}function E(){return o.consumer}function q(e){return!!(e.observers&&e.observers.size)||!!(e.watchers&&e.watchers.size)}var Y={Watcher:f,untrack:C,currentComputed:E,hasSinks:q};return H(U);})();

package/dist/cdn/signal.mjs

@@ -1,5 +1,5 @@
 // src/version.generated.ts
-var VERSION = "1.0.0-alpha.92";
+var VERSION = "1.0.0-alpha.94";
 
 // src/lib/signal/graph/state.ts
 var MAJOR = VERSION.split(".")[0];