@getforma/core 1.0.10 → 1.1.0

package/dist/http.cjs

@@ -1,13 +1,13 @@
 'use strict';
 
-var chunk6FW5E54W_cjs = require('./chunk-6FW5E54W.cjs');
-var chunkQLPCVK7C_cjs = require('./chunk-QLPCVK7C.cjs');
+var chunk2Y5US35K_cjs = require('./chunk-2Y5US35K.cjs');
+var chunkW7OUWVRA_cjs = require('./chunk-W7OUWVRA.cjs');
 
 // src/http/fetch.ts
 function createFetch(url, options) {
-  const [data, setData] = chunkQLPCVK7C_cjs.createSignal(null);
-  const [error, setError] = chunkQLPCVK7C_cjs.createSignal(null);
-  const [loading, setLoading] = chunkQLPCVK7C_cjs.createSignal(false);
+  const [data, setData] = chunkW7OUWVRA_cjs.createSignal(null);
+  const [error, setError] = chunkW7OUWVRA_cjs.createSignal(null);
+  const [loading, setLoading] = chunkW7OUWVRA_cjs.createSignal(false);
   let currentController = null;
   function resolveURL() {
     const raw = typeof url === "function" ? url() : url;
@@ -57,7 +57,7 @@ function createFetch(url, options) {
     }
   }
   if (typeof url === "function") {
-    chunk6FW5E54W_cjs.internalEffect(() => {
+    chunk2Y5US35K_cjs.internalEffect(() => {
       url();
       void execute();
     });
@@ -86,9 +86,9 @@ async function fetchJSON(url, options) {
 
 // src/http/sse.ts
 function createSSE(url, options) {
-  const [data, setData] = chunkQLPCVK7C_cjs.createSignal(null);
-  const [error, setError] = chunkQLPCVK7C_cjs.createSignal(null);
-  const [connected, setConnected] = chunkQLPCVK7C_cjs.createSignal(false);
+  const [data, setData] = chunkW7OUWVRA_cjs.createSignal(null);
+  const [error, setError] = chunkW7OUWVRA_cjs.createSignal(null);
+  const [connected, setConnected] = chunkW7OUWVRA_cjs.createSignal(false);
   const source = new EventSource(url, {
     withCredentials: options?.withCredentials ?? false
   });
@@ -142,8 +142,8 @@ function createWebSocket(url, options) {
   const shouldReconnect = options?.reconnect ?? true;
   const baseInterval = options?.reconnectInterval ?? 1e3;
   const maxReconnects = options?.maxReconnects ?? 5;
-  const [data, setData] = chunkQLPCVK7C_cjs.createSignal(null);
-  const [status, setStatus] = chunkQLPCVK7C_cjs.createSignal("connecting");
+  const [data, setData] = chunkW7OUWVRA_cjs.createSignal(null);
+  const [status, setStatus] = chunkW7OUWVRA_cjs.createSignal("connecting");
   const handlers = /* @__PURE__ */ new Set();
   let socket = null;
   let reconnectCount = 0;

package/dist/http.js

@@ -1,5 +1,5 @@
-import { internalEffect } from './chunk-3G7ET4O5.js';
-import { createSignal } from './chunk-HLM5BZZQ.js';
+import { internalEffect } from './chunk-INNOI6TG.js';
+import { createSignal } from './chunk-XLVBYXOU.js';
 
 // src/http/fetch.ts
 function createFetch(url, options) {

package/dist/index.cjs

@@ -1,14 +1,14 @@
 'use strict';
 
-var chunkT33QUD2Y_cjs = require('./chunk-T33QUD2Y.cjs');
-var chunk6FW5E54W_cjs = require('./chunk-6FW5E54W.cjs');
-var chunkQLPCVK7C_cjs = require('./chunk-QLPCVK7C.cjs');
+var chunkJRQNDXX7_cjs = require('./chunk-JRQNDXX7.cjs');
+var chunk2Y5US35K_cjs = require('./chunk-2Y5US35K.cjs');
+var chunkW7OUWVRA_cjs = require('./chunk-W7OUWVRA.cjs');
 
 // src/dom/text.ts
 function createText(value) {
   if (typeof value === "function") {
     const node = new Text("");
-    chunk6FW5E54W_cjs.internalEffect(() => {
+    chunk2Y5US35K_cjs.internalEffect(() => {
       node.data = value();
     });
     return node;
@@ -24,12 +24,12 @@ function mount(component, container) {
   }
   let disposeRoot;
   if (target.hasAttribute("data-forma-ssr")) {
-    chunk6FW5E54W_cjs.createUnownedRoot((dispose) => {
+    chunk2Y5US35K_cjs.createUnownedRoot((dispose) => {
       disposeRoot = dispose;
-      chunkT33QUD2Y_cjs.hydrateIsland(component, target);
+      chunkJRQNDXX7_cjs.hydrateIsland(component, target);
     });
   } else {
-    const dom = chunk6FW5E54W_cjs.createUnownedRoot((dispose) => {
+    const dom = chunk2Y5US35K_cjs.createUnownedRoot((dispose) => {
       disposeRoot = dispose;
       return component();
     });
@@ -55,7 +55,7 @@ function createSwitch(value, cases, fallback) {
   const cache2 = /* @__PURE__ */ new Map();
   let currentNode = null;
   let currentMatch = UNSET;
-  const switchDispose = chunk6FW5E54W_cjs.internalEffect(() => {
+  const switchDispose = chunk2Y5US35K_cjs.internalEffect(() => {
     const val = value();
     if (val === currentMatch) return;
     const DEBUG = typeof globalThis.__FORMA_DEBUG__ !== "undefined";
@@ -90,9 +90,9 @@ function createSwitch(value, cases, fallback) {
       let entry = cache2.get(val);
       if (!entry) {
         let branchDispose;
-        const node = chunk6FW5E54W_cjs.createRoot((dispose) => {
+        const node = chunk2Y5US35K_cjs.createRoot((dispose) => {
           branchDispose = dispose;
-          return chunk6FW5E54W_cjs.untrack(() => matchedCase.render());
+          return chunk2Y5US35K_cjs.untrack(() => matchedCase.render());
         });
         entry = { node, dispose: branchDispose };
         cache2.set(val, entry);
@@ -110,7 +110,7 @@ function createSwitch(value, cases, fallback) {
       if (DEBUG) console.log("[forma:switch] inserted", currentNode.nodeName, "before end marker");
     }
   });
-  chunk6FW5E54W_cjs.registerDisposer(() => {
+  chunk2Y5US35K_cjs.registerDisposer(() => {
     for (const entry of cache2.values()) {
       entry.dispose();
     }
@@ -142,7 +142,7 @@ function createPortal(children2, target) {
     }
     mountedNode = null;
   };
-  chunk6FW5E54W_cjs.createEffect(() => {
+  chunk2Y5US35K_cjs.createEffect(() => {
     const node = children2();
     removeMountedNode();
     mountedNode = node;
@@ -161,9 +161,9 @@ function createErrorBoundary(tryFn, catchFn) {
   const fragment2 = document.createDocumentFragment();
   fragment2.appendChild(startMarker);
   fragment2.appendChild(endMarker);
-  const [retryCount, setRetryCount] = chunkQLPCVK7C_cjs.createSignal(0);
+  const [retryCount, setRetryCount] = chunkW7OUWVRA_cjs.createSignal(0);
   let currentNode = null;
-  chunk6FW5E54W_cjs.internalEffect(() => {
+  chunk2Y5US35K_cjs.internalEffect(() => {
     retryCount();
     const parent2 = startMarker.parentNode;
     if (!parent2) return;
@@ -191,7 +191,7 @@ function createSuspense(fallback, children2) {
   const fragment2 = document.createDocumentFragment();
   fragment2.appendChild(startMarker);
   fragment2.appendChild(endMarker);
-  const [pending, setPending] = chunkQLPCVK7C_cjs.createSignal(0);
+  const [pending, setPending] = chunkW7OUWVRA_cjs.createSignal(0);
   let currentNode = null;
   let resolvedNode = null;
   let fallbackNode = null;
@@ -203,13 +203,13 @@ function createSuspense(fallback, children2) {
       setPending((p) => Math.max(0, p - 1));
     }
   };
-  chunk6FW5E54W_cjs.pushSuspenseContext(ctx);
+  chunk2Y5US35K_cjs.pushSuspenseContext(ctx);
   try {
     resolvedNode = children2();
   } finally {
-    chunk6FW5E54W_cjs.popSuspenseContext();
+    chunk2Y5US35K_cjs.popSuspenseContext();
   }
-  chunk6FW5E54W_cjs.internalEffect(() => {
+  chunk2Y5US35K_cjs.internalEffect(() => {
     const parent2 = startMarker.parentNode;
     if (!parent2) return;
     const isPending = pending() > 0;
@@ -276,7 +276,7 @@ function activateIslands(registry) {
     const componentName = root.getAttribute("data-forma-component");
     const hydrateFn = registry[componentName];
     if (!hydrateFn) {
-      if (chunk6FW5E54W_cjs.__DEV__) console.warn(`[forma] No hydrate function for island "${componentName}" (id=${id})`);
+      if (chunkW7OUWVRA_cjs.__DEV__) console.warn(`[forma] No hydrate function for island "${componentName}" (id=${id})`);
       root.setAttribute("data-forma-status", "error");
       continue;
     }
@@ -332,13 +332,13 @@ function hydrateIslandRoot(root, id, componentName, hydrateFn, sharedProps) {
     const props = loadIslandProps(root, id, sharedProps);
     root.setAttribute("data-forma-status", "hydrating");
     let activeRoot = root;
-    chunk6FW5E54W_cjs.createUnownedRoot((dispose) => {
-      activeRoot = chunkT33QUD2Y_cjs.hydrateIsland(() => hydrateFn(root, props), root);
+    chunk2Y5US35K_cjs.createUnownedRoot((dispose) => {
+      activeRoot = chunkJRQNDXX7_cjs.hydrateIsland(() => hydrateFn(root, props), root);
       activeRoot.__formaDispose = dispose;
     });
     activeRoot.setAttribute("data-forma-status", "active");
   } catch (err) {
-    if (chunk6FW5E54W_cjs.__DEV__) console.error(`[forma] Island "${componentName}" (id=${id}) failed:`, err);
+    if (chunkW7OUWVRA_cjs.__DEV__) console.error(`[forma] Island "${componentName}" (id=${id}) failed:`, err);
     root.setAttribute("data-forma-status", "error");
   }
 }
@@ -387,14 +387,14 @@ function defineComponent(setupOrDef) {
         try {
           cb();
         } catch (e) {
-          chunk6FW5E54W_cjs.reportError(e, "onUnmount");
+          chunkW7OUWVRA_cjs.reportError(e, "onUnmount");
         }
       }
       for (const d of ctx.disposers) {
         try {
           d();
         } catch (e) {
-          chunk6FW5E54W_cjs.reportError(e, "component disposer");
+          chunkW7OUWVRA_cjs.reportError(e, "component disposer");
         }
       }
       ctx.disposers.length = 0;
@@ -409,7 +409,7 @@ function defineComponent(setupOrDef) {
           ctx.unmountCallbacks.push(cleanup2);
         }
       } catch (e) {
-        chunk6FW5E54W_cjs.reportError(e, "onMount");
+        chunkW7OUWVRA_cjs.reportError(e, "onMount");
       }
     }
     return dom;
@@ -512,7 +512,7 @@ function createStore(initial) {
   function getSignal(path, initialValue) {
     let pair = signals.get(path);
     if (!pair) {
-      pair = chunkQLPCVK7C_cjs.createSignal(initialValue);
+      pair = chunkW7OUWVRA_cjs.createSignal(initialValue);
       signals.set(path, pair);
       registerChild(path);
     }
@@ -552,7 +552,7 @@ function createStore(initial) {
         if (isArr && ARRAY_MUTATORS.has(key)) {
           return (...args) => {
             let result;
-            chunk6FW5E54W_cjs.batch(() => {
+            chunk2Y5US35K_cjs.batch(() => {
               const rawArgs = args.map(
                 (a) => a != null && typeof a === "object" && a[RAW] ? a[RAW] : a
               );
@@ -666,11 +666,11 @@ function createStore(initial) {
   }
   const rootProxy = wrap(initial, "");
   function getCurrentSnapshot() {
-    return chunk6FW5E54W_cjs.untrack(() => deepClone(initial));
+    return chunk2Y5US35K_cjs.untrack(() => deepClone(initial));
   }
   const setter = (partial) => {
     const updates = typeof partial === "function" ? partial(getCurrentSnapshot()) : partial;
-    chunk6FW5E54W_cjs.batch(() => {
+    chunk2Y5US35K_cjs.batch(() => {
       for (const key of Object.keys(updates)) {
         rootProxy[key] = updates[key];
       }
@@ -685,11 +685,11 @@ function createHistory(source, options) {
   const maxLength = options?.maxLength ?? 100;
   let _stack = [sourceGet()];
   let _cursor = 0;
-  const [stackSignal, setStackSignal] = chunkQLPCVK7C_cjs.createSignal([..._stack]);
-  const [cursorSignal, setCursorSignal] = chunkQLPCVK7C_cjs.createSignal(_cursor);
-  const [stackLenSignal, setStackLenSignal] = chunkQLPCVK7C_cjs.createSignal(_stack.length);
+  const [stackSignal, setStackSignal] = chunkW7OUWVRA_cjs.createSignal([..._stack]);
+  const [cursorSignal, setCursorSignal] = chunkW7OUWVRA_cjs.createSignal(_cursor);
+  const [stackLenSignal, setStackLenSignal] = chunkW7OUWVRA_cjs.createSignal(_stack.length);
   function syncSignals() {
-    chunk6FW5E54W_cjs.batch(() => {
+    chunk2Y5US35K_cjs.batch(() => {
       setStackSignal([..._stack]);
       setCursorSignal(_cursor);
       setStackLenSignal(_stack.length);
@@ -697,7 +697,7 @@ function createHistory(source, options) {
   }
   let ignoreNext = false;
   let isFirstRun = true;
-  chunk6FW5E54W_cjs.internalEffect(() => {
+  chunk2Y5US35K_cjs.internalEffect(() => {
     const value = sourceGet();
     if (isFirstRun) {
       isFirstRun = false;
@@ -765,7 +765,7 @@ function persist(source, key, options) {
     }
   } catch {
   }
-  chunk6FW5E54W_cjs.internalEffect(() => {
+  chunk2Y5US35K_cjs.internalEffect(() => {
     const value = sourceGet();
     try {
       const serialized = serialize(value);
@@ -1023,115 +1023,115 @@ function onMutation(el, handler, options) {
 
 Object.defineProperty(exports, "Fragment", {
   enumerable: true,
-  get: function () { return chunkT33QUD2Y_cjs.Fragment; }
+  get: function () { return chunkJRQNDXX7_cjs.Fragment; }
 });
 Object.defineProperty(exports, "cleanup", {
   enumerable: true,
-  get: function () { return chunkT33QUD2Y_cjs.cleanup; }
+  get: function () { return chunkJRQNDXX7_cjs.cleanup; }
 });
 Object.defineProperty(exports, "createList", {
   enumerable: true,
-  get: function () { return chunkT33QUD2Y_cjs.createList; }
+  get: function () { return chunkJRQNDXX7_cjs.createList; }
 });
 Object.defineProperty(exports, "createShow", {
   enumerable: true,
-  get: function () { return chunkT33QUD2Y_cjs.createShow; }
+  get: function () { return chunkJRQNDXX7_cjs.createShow; }
 });
 Object.defineProperty(exports, "fragment", {
   enumerable: true,
-  get: function () { return chunkT33QUD2Y_cjs.fragment; }
+  get: function () { return chunkJRQNDXX7_cjs.fragment; }
 });
 Object.defineProperty(exports, "h", {
   enumerable: true,
-  get: function () { return chunkT33QUD2Y_cjs.h; }
+  get: function () { return chunkJRQNDXX7_cjs.h; }
 });
 Object.defineProperty(exports, "hydrateIsland", {
   enumerable: true,
-  get: function () { return chunkT33QUD2Y_cjs.hydrateIsland; }
+  get: function () { return chunkJRQNDXX7_cjs.hydrateIsland; }
 });
 Object.defineProperty(exports, "reconcileList", {
   enumerable: true,
-  get: function () { return chunkT33QUD2Y_cjs.reconcileList; }
+  get: function () { return chunkJRQNDXX7_cjs.reconcileList; }
 });
 Object.defineProperty(exports, "batch", {
   enumerable: true,
-  get: function () { return chunk6FW5E54W_cjs.batch; }
+  get: function () { return chunk2Y5US35K_cjs.batch; }
 });
 Object.defineProperty(exports, "createEffect", {
   enumerable: true,
-  get: function () { return chunk6FW5E54W_cjs.createEffect; }
+  get: function () { return chunk2Y5US35K_cjs.createEffect; }
 });
 Object.defineProperty(exports, "createMemo", {
   enumerable: true,
-  get: function () { return chunk6FW5E54W_cjs.createMemo; }
+  get: function () { return chunk2Y5US35K_cjs.createMemo; }
 });
 Object.defineProperty(exports, "createReducer", {
   enumerable: true,
-  get: function () { return chunk6FW5E54W_cjs.createReducer; }
+  get: function () { return chunk2Y5US35K_cjs.createReducer; }
 });
 Object.defineProperty(exports, "createRef", {
   enumerable: true,
-  get: function () { return chunk6FW5E54W_cjs.createRef; }
+  get: function () { return chunk2Y5US35K_cjs.createRef; }
 });
 Object.defineProperty(exports, "createResource", {
   enumerable: true,
-  get: function () { return chunk6FW5E54W_cjs.createResource; }
+  get: function () { return chunk2Y5US35K_cjs.createResource; }
 });
 Object.defineProperty(exports, "createRoot", {
   enumerable: true,
-  get: function () { return chunk6FW5E54W_cjs.createRoot; }
+  get: function () { return chunk2Y5US35K_cjs.createRoot; }
 });
 Object.defineProperty(exports, "createUnownedRoot", {
   enumerable: true,
-  get: function () { return chunk6FW5E54W_cjs.createUnownedRoot; }
+  get: function () { return chunk2Y5US35K_cjs.createUnownedRoot; }
 });
 Object.defineProperty(exports, "getBatchDepth", {
   enumerable: true,
-  get: function () { return chunk6FW5E54W_cjs.getBatchDepth; }
+  get: function () { return chunk2Y5US35K_cjs.getBatchDepth; }
 });
 Object.defineProperty(exports, "isComputed", {
   enumerable: true,
-  get: function () { return chunk6FW5E54W_cjs.isComputed; }
+  get: function () { return chunk2Y5US35K_cjs.isComputed; }
 });
 Object.defineProperty(exports, "isEffect", {
   enumerable: true,
-  get: function () { return chunk6FW5E54W_cjs.isEffect; }
+  get: function () { return chunk2Y5US35K_cjs.isEffect; }
 });
 Object.defineProperty(exports, "isEffectScope", {
   enumerable: true,
-  get: function () { return chunk6FW5E54W_cjs.isEffectScope; }
+  get: function () { return chunk2Y5US35K_cjs.isEffectScope; }
 });
 Object.defineProperty(exports, "isSignal", {
   enumerable: true,
-  get: function () { return chunk6FW5E54W_cjs.isSignal; }
+  get: function () { return chunk2Y5US35K_cjs.isSignal; }
 });
 Object.defineProperty(exports, "on", {
   enumerable: true,
-  get: function () { return chunk6FW5E54W_cjs.on; }
+  get: function () { return chunk2Y5US35K_cjs.on; }
 });
 Object.defineProperty(exports, "onCleanup", {
   enumerable: true,
-  get: function () { return chunk6FW5E54W_cjs.onCleanup; }
-});
-Object.defineProperty(exports, "onError", {
-  enumerable: true,
-  get: function () { return chunk6FW5E54W_cjs.onError; }
+  get: function () { return chunk2Y5US35K_cjs.onCleanup; }
 });
 Object.defineProperty(exports, "trigger", {
   enumerable: true,
-  get: function () { return chunk6FW5E54W_cjs.trigger; }
+  get: function () { return chunk2Y5US35K_cjs.trigger; }
 });
 Object.defineProperty(exports, "untrack", {
   enumerable: true,
-  get: function () { return chunk6FW5E54W_cjs.untrack; }
+  get: function () { return chunk2Y5US35K_cjs.untrack; }
 });
 Object.defineProperty(exports, "createComputed", {
   enumerable: true,
-  get: function () { return chunkQLPCVK7C_cjs.createComputed; }
+  get: function () { return chunkW7OUWVRA_cjs.createComputed; }
 });
 Object.defineProperty(exports, "createSignal", {
   enumerable: true,
-  get: function () { return chunkQLPCVK7C_cjs.createSignal; }
+  get: function () { return chunkW7OUWVRA_cjs.createSignal; }
+});
+Object.defineProperty(exports, "onError", {
+  enumerable: true,
+  get: function () { return chunkW7OUWVRA_cjs.onError; }
 });
 exports.$ = $;
 exports.$$ = $$;

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 /// <reference path="./jsx.d.ts" />
-import { S as SignalGetter } from './signal-C9v4akyJ.cjs';
-export { a as SignalOptions, b as SignalSetter, c as createSignal } from './signal-C9v4akyJ.cjs';
-export { R as Resource, a as ResourceOptions, c as createResource } from './resource-DeEzxUz6.cjs';
+import { S as SignalGetter } from './signal-CRBJYQ6B.cjs';
+export { a as SignalOptions, b as SignalSetter, c as createSignal } from './signal-CRBJYQ6B.cjs';
+export { R as Resource, a as ResourceOptions, c as createResource } from './resource-D6HfVgiA.cjs';
 export { getBatchDepth, isComputed, isEffect, isEffectScope, isSignal, trigger } from 'alien-signals';
 
 declare function createEffect(fn: () => void | (() => void)): () => void;
@@ -125,21 +125,6 @@ declare function batch(fn: () => void): void;
  */
 declare function untrack<T>(fn: () => T): T;
 
-/**
- * Forma Reactive - Root
- *
- * Explicit reactive ownership scope. All effects created inside a root
- * are automatically disposed when the root is torn down.
- *
- * Uses alien-signals' `effectScope` under the hood for native graph-level
- * effect tracking, with a userland disposer list for non-effect cleanup
- * (e.g., event listeners, DOM references, timers).
- *
- * Roots created inside another root are automatically owned by the parent
- * (Solid-style). When the parent is disposed, all child roots are disposed
- * too. Use {@link createUnownedRoot} for roots that must outlive their
- * lexical parent (e.g., mount points, test harnesses).
- */
 /**
  * Create a reactive root scope.
  *
@@ -312,22 +297,23 @@ type Dispatch<A> = (action: A) => void;
  */
 declare function createReducer<S, A>(reducer: (state: S, action: A) => S, initialState: S): [state: SignalGetter<S>, dispatch: Dispatch<A>];
 
-/** Callback signature for the global {@link onError} handler. */
+/** Callback signature for a global {@link onError} handler. */
 type ErrorHandler = (error: unknown, info?: {
     source?: string;
 }) => void;
 /**
- * Install a global error handler for FormaJS reactive errors.
- * Called when effects, computeds, or event handlers throw.
+ * Install a global error handler for FormaJS reactive errors. Called when
+ * effects, computeds, or event handlers throw. Multiple handlers may be
+ * registered; returns an unsubscribe function that removes only this handler.
  *
  * ```ts
- * onError((err, info) => {
- *   console.error(`[${info?.source}]`, err);
- *   Sentry.captureException(err);
+ * const off = onError((err, info) => {
+ *   Sentry.captureException(err, { tags: { source: info?.source } });
  * });
+ * // later: off();
  * ```
  */
-declare function onError(handler: ErrorHandler): void;
+declare function onError(handler: ErrorHandler): () => void;
 
 /**
  * Forma DOM - Element

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 /// <reference path="./jsx.d.ts" />
-import { S as SignalGetter } from './signal-C9v4akyJ.js';
-export { a as SignalOptions, b as SignalSetter, c as createSignal } from './signal-C9v4akyJ.js';
-export { R as Resource, a as ResourceOptions, c as createResource } from './resource-BHsgURy0.js';
+import { S as SignalGetter } from './signal-CRBJYQ6B.js';
+export { a as SignalOptions, b as SignalSetter, c as createSignal } from './signal-CRBJYQ6B.js';
+export { R as Resource, a as ResourceOptions, c as createResource } from './resource-ljs2X5NM.js';
 export { getBatchDepth, isComputed, isEffect, isEffectScope, isSignal, trigger } from 'alien-signals';
 
 declare function createEffect(fn: () => void | (() => void)): () => void;
@@ -125,21 +125,6 @@ declare function batch(fn: () => void): void;
  */
 declare function untrack<T>(fn: () => T): T;
 
-/**
- * Forma Reactive - Root
- *
- * Explicit reactive ownership scope. All effects created inside a root
- * are automatically disposed when the root is torn down.
- *
- * Uses alien-signals' `effectScope` under the hood for native graph-level
- * effect tracking, with a userland disposer list for non-effect cleanup
- * (e.g., event listeners, DOM references, timers).
- *
- * Roots created inside another root are automatically owned by the parent
- * (Solid-style). When the parent is disposed, all child roots are disposed
- * too. Use {@link createUnownedRoot} for roots that must outlive their
- * lexical parent (e.g., mount points, test harnesses).
- */
 /**
  * Create a reactive root scope.
  *
@@ -312,22 +297,23 @@ type Dispatch<A> = (action: A) => void;
  */
 declare function createReducer<S, A>(reducer: (state: S, action: A) => S, initialState: S): [state: SignalGetter<S>, dispatch: Dispatch<A>];
 
-/** Callback signature for the global {@link onError} handler. */
+/** Callback signature for a global {@link onError} handler. */
 type ErrorHandler = (error: unknown, info?: {
     source?: string;
 }) => void;
 /**
- * Install a global error handler for FormaJS reactive errors.
- * Called when effects, computeds, or event handlers throw.
+ * Install a global error handler for FormaJS reactive errors. Called when
+ * effects, computeds, or event handlers throw. Multiple handlers may be
+ * registered; returns an unsubscribe function that removes only this handler.
  *
  * ```ts
- * onError((err, info) => {
- *   console.error(`[${info?.source}]`, err);
- *   Sentry.captureException(err);
+ * const off = onError((err, info) => {
+ *   Sentry.captureException(err, { tags: { source: info?.source } });
  * });
+ * // later: off();
  * ```
  */
-declare function onError(handler: ErrorHandler): void;
+declare function onError(handler: ErrorHandler): () => void;
 
 /**
  * Forma DOM - Element

package/dist/index.js

@@ -1,9 +1,9 @@
-import { hydrateIsland } from './chunk-AFRFF7XL.js';
-export { Fragment, cleanup, createList, createShow, fragment, h, hydrateIsland, reconcileList } from './chunk-AFRFF7XL.js';
-import { internalEffect, createUnownedRoot, createRoot, untrack, registerDisposer, createEffect, pushSuspenseContext, popSuspenseContext, __DEV__, reportError, batch } from './chunk-3G7ET4O5.js';
-export { batch, createEffect, createMemo, createReducer, createRef, createResource, createRoot, createUnownedRoot, getBatchDepth, isComputed, isEffect, isEffectScope, isSignal, on, onCleanup, onError, trigger, untrack } from './chunk-3G7ET4O5.js';
-import { createSignal } from './chunk-HLM5BZZQ.js';
-export { createComputed, createSignal } from './chunk-HLM5BZZQ.js';
+import { hydrateIsland } from './chunk-MIOMT2CB.js';
+export { Fragment, cleanup, createList, createShow, fragment, h, hydrateIsland, reconcileList } from './chunk-MIOMT2CB.js';
+import { internalEffect, createUnownedRoot, createRoot, untrack, registerDisposer, createEffect, pushSuspenseContext, popSuspenseContext, batch } from './chunk-INNOI6TG.js';
+export { batch, createEffect, createMemo, createReducer, createRef, createResource, createRoot, createUnownedRoot, getBatchDepth, isComputed, isEffect, isEffectScope, isSignal, on, onCleanup, trigger, untrack } from './chunk-INNOI6TG.js';
+import { createSignal, __DEV__, reportError } from './chunk-XLVBYXOU.js';
+export { createComputed, createSignal, onError } from './chunk-XLVBYXOU.js';
 
 // src/dom/text.ts
 function createText(value) {

package/dist/{resource-DeEzxUz6.d.cts → resource-D6HfVgiA.d.cts}

@@ -1,4 +1,4 @@
-import { S as SignalGetter } from './signal-C9v4akyJ.cjs';
+import { S as SignalGetter } from './signal-CRBJYQ6B.cjs';
 
 /**
  * Forma Reactive - Resource
@@ -10,6 +10,11 @@ import { S as SignalGetter } from './signal-C9v4akyJ.cjs';
  * React equivalent: use() + Suspense (React 19), or useSWR/react-query
  */
 
+/** Info passed to a resource fetcher — carries the AbortSignal for this fetch. */
+interface ResourceFetcherInfo {
+    /** Aborted when the source changes / the resource refetches or is disposed. */
+    signal: AbortSignal;
+}
 /** An async data resource with reactive loading and error state. */
 interface Resource<T> {
     /** The resolved data (or undefined while loading). */
@@ -59,6 +64,6 @@ interface ResourceOptions<T> {
  * );
  * ```
  */
-declare function createResource<T, S = true>(source: SignalGetter<S>, fetcher: (source: S) => Promise<T>, options?: ResourceOptions<T>): Resource<T>;
+declare function createResource<T, S = true>(source: SignalGetter<S>, fetcher: (source: S, info: ResourceFetcherInfo) => Promise<T>, options?: ResourceOptions<T>): Resource<T>;
 
 export { type Resource as R, type ResourceOptions as a, createResource as c };

package/dist/{resource-BHsgURy0.d.ts → resource-ljs2X5NM.d.ts}

@@ -1,4 +1,4 @@
-import { S as SignalGetter } from './signal-C9v4akyJ.js';
+import { S as SignalGetter } from './signal-CRBJYQ6B.js';
 
 /**
  * Forma Reactive - Resource
@@ -10,6 +10,11 @@ import { S as SignalGetter } from './signal-C9v4akyJ.js';
  * React equivalent: use() + Suspense (React 19), or useSWR/react-query
  */
 
+/** Info passed to a resource fetcher — carries the AbortSignal for this fetch. */
+interface ResourceFetcherInfo {
+    /** Aborted when the source changes / the resource refetches or is disposed. */
+    signal: AbortSignal;
+}
 /** An async data resource with reactive loading and error state. */
 interface Resource<T> {
     /** The resolved data (or undefined while loading). */
@@ -59,6 +64,6 @@ interface ResourceOptions<T> {
  * );
  * ```
  */
-declare function createResource<T, S = true>(source: SignalGetter<S>, fetcher: (source: S) => Promise<T>, options?: ResourceOptions<T>): Resource<T>;
+declare function createResource<T, S = true>(source: SignalGetter<S>, fetcher: (source: S, info: ResourceFetcherInfo) => Promise<T>, options?: ResourceOptions<T>): Resource<T>;
 
 export { type Resource as R, type ResourceOptions as a, createResource as c };