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

package/dist/lib/signal/graph/compat.mjs

@@ -1,7 +1,7 @@
-/*! @fluixi/reactive v1.0.0-alpha.92 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/reactive v1.0.0-alpha.94 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 
 // 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];
@@ -51,11 +51,12 @@ function observeReactiveNodes(next) {
 }
 var running = [];
 var origin;
+var currentScope;
 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 }
     );
   }
 }
@@ -375,7 +376,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);
@@ -387,7 +388,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);
@@ -414,8 +415,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();
 }
 
@@ -483,12 +484,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;

package/dist/lib/signal/graph/core.cjs

@@ -1,4 +1,4 @@
-/*! @fluixi/reactive v1.0.0-alpha.92 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/reactive v1.0.0-alpha.94 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -31,7 +31,7 @@ __export(core_exports, {
 module.exports = __toCommonJS(core_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/lib/signal/graph/core.mjs

@@ -1,7 +1,7 @@
-/*! @fluixi/reactive v1.0.0-alpha.92 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/reactive v1.0.0-alpha.94 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 
 // 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/lib/signal/graph/debounced.cjs

@@ -26,7 +26,7 @@ __export(debounced_exports, {
 module.exports = __toCommonJS(debounced_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];
@@ -76,11 +76,12 @@ function observeReactiveNodes(next) {
 }
 var running = [];
 var origin;
+var currentScope;
 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 }
     );
   }
 }
@@ -374,7 +375,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);
@@ -386,7 +387,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);
@@ -413,8 +414,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();
 }
 
@@ -454,12 +455,12 @@ function createSignal(value, options) {
   if (isObserved()) onCleanup(() => reportReactiveDispose(state));
   return [read, write];
 }
-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 batch2(fn) {
   return batch(fn);

package/dist/lib/signal/graph/debounced.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];
@@ -49,11 +49,12 @@ function observeReactiveNodes(next) {
 }
 var running = [];
 var origin;
+var currentScope;
 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 }
     );
   }
 }
@@ -347,7 +348,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);
@@ -359,7 +360,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);
@@ -386,8 +387,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();
 }
 
@@ -427,12 +428,12 @@ function createSignal(value, options) {
   if (isObserved()) onCleanup(() => reportReactiveDispose(state));
   return [read, write];
 }
-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 batch2(fn) {
   return batch(fn);

package/dist/lib/signal/graph/derived.cjs

@@ -27,7 +27,7 @@ __export(derived_exports, {
 module.exports = __toCommonJS(derived_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];
@@ -77,11 +77,12 @@ function observeReactiveNodes(next) {
 }
 var running = [];
 var origin;
+var currentScope;
 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 }
     );
   }
 }
@@ -358,7 +359,7 @@ function afterWrite() {
   if (G.batchDepth === 0) flushSync();
 }
 var EffectNode = class {
-  constructor(fn, report = false) {
+  constructor(fn, report = false, name) {
     this.queued = false;
     this.disposed = false;
     this.owner = makeOwner(G.owner);
@@ -370,7 +371,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);
@@ -397,8 +398,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();
 }
 
@@ -438,12 +439,12 @@ function createSignal(value, options) {
   if (isObserved()) onCleanup(() => reportReactiveDispose(state));
   return [read, write];
 }
-function createEffect(fn, value) {
+function createEffect(fn, value, options) {
   let prev = value;
   return effect(() => {
     const r = fn(prev);
     prev = r;
-  }, true);
+  }, true, options?.name);
 }
 
 // src/lib/signal/graph/derived.ts

package/dist/lib/signal/graph/derived.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];
@@ -49,11 +49,12 @@ function observeReactiveNodes(next) {
 }
 var running = [];
 var origin;
+var currentScope;
 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 }
     );
   }
 }
@@ -330,7 +331,7 @@ function afterWrite() {
   if (G.batchDepth === 0) flushSync();
 }
 var EffectNode = class {
-  constructor(fn, report = false) {
+  constructor(fn, report = false, name) {
     this.queued = false;
     this.disposed = false;
     this.owner = makeOwner(G.owner);
@@ -342,7 +343,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);
@@ -369,8 +370,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();
 }
 
@@ -410,12 +411,12 @@ function createSignal(value, options) {
   if (isObserved()) onCleanup(() => reportReactiveDispose(state));
   return [read, write];
 }
-function createEffect(fn, value) {
+function createEffect(fn, value, options) {
   let prev = value;
   return effect(() => {
     const r = fn(prev);
     prev = r;
-  }, true);
+  }, true, options?.name);
 }
 
 // src/lib/signal/graph/derived.ts

package/dist/lib/signal/graph/error-boundary.cjs

@@ -27,7 +27,7 @@ __export(error_boundary_exports, {
 module.exports = __toCommonJS(error_boundary_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];
@@ -77,11 +77,12 @@ function observeReactiveNodes(next) {
 }
 var running = [];
 var origin;
+var currentScope;
 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 }
     );
   }
 }

package/dist/lib/signal/graph/error-boundary.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];
@@ -49,11 +49,12 @@ function observeReactiveNodes(next) {
 }
 var running = [];
 var origin;
+var currentScope;
 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 }
     );
   }
 }

package/dist/lib/signal/graph/index.cjs

@@ -1,4 +1,4 @@
-/*! @fluixi/reactive v1.0.0-alpha.92 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/reactive v1.0.0-alpha.94 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -29,7 +29,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_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/lib/signal/graph/index.mjs

@@ -1,7 +1,7 @@
-/*! @fluixi/reactive v1.0.0-alpha.92 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/reactive v1.0.0-alpha.94 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 
 // 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/lib/signal/graph/observe.cjs

@@ -20,10 +20,15 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/lib/signal/graph/observe.ts
 var observe_exports = {};
 __export(observe_exports, {
+  adoptReactiveScope: () => adoptReactiveScope,
+  closeReactiveScope: () => closeReactiveScope,
   enterReactiveRun: () => enterReactiveRun,
   exitReactiveRun: () => exitReactiveRun,
   isObserved: () => isObserved,
+  markReactiveScope: () => markReactiveScope,
   observeReactiveNodes: () => observeReactiveNodes,
+  openReactiveScope: () => openReactiveScope,
+  reactiveScopeOf: () => reactiveScopeOf,
   reportReactiveBinding: () => reportReactiveBinding,
   reportReactiveContext: () => reportReactiveContext,
   reportReactiveContextCreated: () => reportReactiveContextCreated,
@@ -34,12 +39,13 @@ __export(observe_exports, {
   reportReactiveProps: () => reportReactiveProps,
   reportReactiveRun: () => reportReactiveRun,
   reportReactiveWrite: () => reportReactiveWrite,
-  withReactiveOrigin: () => withReactiveOrigin
+  withReactiveOrigin: () => withReactiveOrigin,
+  withReactiveScope: () => withReactiveScope
 });
 module.exports = __toCommonJS(observe_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];
@@ -99,11 +105,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 }
     );
   }
 }

package/dist/lib/signal/graph/observe.d.ts

@@ -33,6 +33,22 @@ export interface ReactiveNodeReport {
      * Live and reused: read it during the call, do not keep it.
      */
     parents?: readonly unknown[];
+    /**
+     * The scope open when this node was made: the custom element, module or service it
+     * belongs to. See `openReactiveScope`.
+     */
+    scope?: object;
+}
+/** What a scope stands for. The graph draws each kind as its own group. */
+export type ReactiveScopeKind = 'element' | 'module' | 'service';
+export interface ReactiveScopeInfo {
+    kind: ReactiveScopeKind;
+    /** What the author calls it: `<fx-counter>`, `AuthModule`, `AuthService`. */
+    name: string;
+    /** Something on the page it stands for, such as the element itself, for highlighting. */
+    target?: unknown;
+    /** One short line of extra detail, such as the token a service was provided for. */
+    detail?: string;
 }
 export interface ReactiveObserver {
     created(report: ReactiveNodeReport): void;
@@ -89,6 +105,19 @@ export interface ReactiveObserver {
      * showing. The watcher reads its own stack for that.
      */
     contextCreated?(id: symbol): void;
+    /**
+     * A scope was opened: a custom element connected, a module registered, a service built.
+     * Nothing in the graph says so otherwise; its signals would be loose nodes with no owner
+     * a reader recognises. `parent` is the scope open around this one.
+     */
+    scope?(scope: object, info: ReactiveScopeInfo, parent?: object): void;
+    /** A scope ended: the element was removed, the service disposed. */
+    scopeEnded?(scope: object): void;
+    /**
+     * A scope now sits inside another: a service built at import time, later registered by the
+     * module that provides it.
+     */
+    scopeAdopted?(scope: object, parent: object): void;
 }
 /**
  * Watch the graph. Returns a function that stops watching.
@@ -99,6 +128,21 @@ export interface ReactiveObserver {
 export declare function observeReactiveNodes(next: ReactiveObserver): () => void;
 /** Attribute everything `fn` creates to `owner`. Free when nobody is watching. */
 export declare function withReactiveOrigin<T>(owner: unknown, fn: () => T): T;
+/**
+ * Announce a scope and get its identity back. Cheap when nobody is watching: an empty
+ * object, reported to no one.
+ */
+export declare function openReactiveScope(info: ReactiveScopeInfo): object;
+/** Run `fn` with `scope` open, so every node it creates belongs to it. Free when unwatched. */
+export declare function withReactiveScope<T>(scope: object, fn: () => T): T;
+/** The scope has ended. */
+export declare function closeReactiveScope(scope: object): void;
+/** Put an existing scope inside another. */
+export declare function adoptReactiveScope(scope: object, parent: object): void;
+/** Remember `scope` on `value`. Not enumerable, so it never shows up in a spread or a log. */
+export declare function markReactiveScope(value: object, scope: object): void;
+/** The scope a package marked on `value`, if any. */
+export declare function reactiveScopeOf(value: unknown): object | undefined;
 /** Called by the primitives. Not part of the public surface. */
 export declare function reportReactiveNode(report: ReactiveNodeReport): void;
 /** Called around a recompute, so a node can say what it was created inside. */

package/dist/lib/signal/graph/observe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../../../../src/lib/signal/graph/observe.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../../../../src/lib/signal/graph/observe.ts"],"names":[],"mappings":"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"}

package/dist/lib/signal/graph/observe.js

@@ -46,13 +46,62 @@ export function withReactiveOrigin(owner, fn) {
         origin = previous;
     }
 }
+/** The scope nodes created right now belong to. */
+let currentScope;
+/**
+ * Announce a scope and get its identity back. Cheap when nobody is watching: an empty
+ * object, reported to no one.
+ */
+export function openReactiveScope(info) {
+    const scope = {};
+    G.observer?.scope?.(scope, info, currentScope);
+    return scope;
+}
+/** Run `fn` with `scope` open, so every node it creates belongs to it. Free when unwatched. */
+export function withReactiveScope(scope, fn) {
+    if (!G.observer)
+        return fn();
+    const previous = currentScope;
+    currentScope = scope;
+    try {
+        return fn();
+    }
+    finally {
+        currentScope = previous;
+    }
+}
+/** The scope has ended. */
+export function closeReactiveScope(scope) {
+    G.observer?.scopeEnded?.(scope);
+}
+/** Put an existing scope inside another. */
+export function adoptReactiveScope(scope, parent) {
+    G.observer?.scopeAdopted?.(scope, parent);
+}
+/**
+ * Where a package leaves the scope it opened for a value it built, so whoever registers the
+ * value later (a module providing it) can place it. Shared by key, across copies.
+ */
+const SCOPE_OF = Symbol.for('fluixi.reactiveScope');
+/** Remember `scope` on `value`. Not enumerable, so it never shows up in a spread or a log. */
+export function markReactiveScope(value, scope) {
+    Object.defineProperty(value, SCOPE_OF, { value: scope, configurable: true, enumerable: false });
+}
+/** The scope a package marked on `value`, if any. */
+export function reactiveScopeOf(value) {
+    return value !== null && (typeof value === 'object' || typeof value === 'function')
+        ? (value[SCOPE_OF] ?? undefined)
+        : undefined;
+}
 /** Called by the primitives. Not part of the public surface. */
 export function reportReactiveNode(report) {
     const observer = G.observer;
     // Filled here rather than at each call site: the stack is already on hand, and a report
     // costs nothing to build when nobody is watching.
     if (observer) {
-        observer.created(report.parents === undefined ? { ...report, parents: running, origin: report.origin ?? origin } : report);
+        observer.created(report.parents === undefined
+            ? { ...report, parents: running, origin: report.origin ?? origin, scope: report.scope ?? currentScope }
+            : { ...report, scope: report.scope ?? currentScope });
     }
 }
 /** Called around a recompute, so a node can say what it was created inside. */