@getforma/core 1.3.0 → 1.5.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 /// <reference path="./jsx.d.ts" />
-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';
+import { S as SignalGetter } from './signal-CIXTR4Qz.cjs';
+export { a as SignalOptions, b as SignalSetter, c as createSignal, g as getSignalName, v as value } from './signal-CIXTR4Qz.cjs';
+export { R as Resource, a as ResourceFetcherInfo, b as ResourceOptions, c as createResource } from './resource-CaFfIB5i.cjs';
 export { getBatchDepth, isComputed, isEffect, isEffectScope, isSignal, trigger } from 'alien-signals';
 
 declare function createEffect(fn: () => void | (() => void)): () => void;
@@ -125,6 +125,38 @@ 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).
+ */
+/**
+ * The minimal ownership unit: something that holds disposers. A {@link RootScope}
+ * is an Owner with an extra alien-signals scope dispose. Effects use lightweight
+ * child owners (no scopeDispose) to own their nested effects generation-by-generation.
+ */
+interface Owner {
+    /** Disposers to run when this owner is torn down. */
+    disposers: (() => void)[];
+}
+/** @internal — the owner disposers currently register with (or null). */
+declare function getOwner(): Owner | null;
+/**
+ * Run `fn` with `owner` installed as the current owner, restoring the previous
+ * owner afterwards. Lets effects/roots created asynchronously (after the
+ * original root callback returned) still be owned and disposed.
+ */
+declare function runWithOwner<T>(owner: Owner | null, fn: () => T): T;
 /**
  * Create a reactive root scope.
  *
@@ -831,7 +863,9 @@ declare function trackDisposer(dispose: () => void): void;
  *
  * Dependency injection via stack-based context.
  * Simpler than React's Provider component tree: provide() pushes a value,
- * inject() reads the top, component teardown pops automatically.
+ * inject() reads the top. When provide() is called during a component setup, the
+ * value is auto-unprovided on that component's dispose; outside a component you
+ * must call unprovide() yourself.
  * Zero dependencies -- native browser APIs only.
  */
 /** A typed dependency injection context created by {@link createContext}. */
@@ -1188,4 +1222,4 @@ declare function onIntersect(el: HTMLElement, handler: (entry: IntersectionObser
  */
 declare function onMutation(el: HTMLElement, handler: (mutations: MutationRecord[]) => void, options?: MutationObserverInit): () => void;
 
-export { $, $$, type CleanupFn, type ComponentDef, type Context, type CreateListOptions, type Dispatch, type ErrorHandler, type EventBus, Fragment, type HistoryControls, type IslandHydrateFn, type KeyOptions, type ListTransitionHooks, type PersistErrorPhase, type PersistOptions, type ReconcileResult, type Ref, type SetupFn, SignalGetter, type StoreSetter, type SwitchCase, activateIslands, addClass, batch, children, cleanup, closest, createBus, createComputed, createContext, createEffect, createErrorBoundary, createHistory, createList, createMemo, createPortal, createReducer, createRef, createRoot, createShow, createStore, createSuspense, createSwitch, createText, createUnownedRoot, deactivateAllIslands, deactivateIsland, defineComponent, delegate, disposeComponent, fragment, h, hydrateIsland, inject, mount, nextSibling, on, onCleanup, onError, onIntersect, onKey, onMount, onMutation, onResize, onUnmount, parent, persist, prevSibling, provide, reconcileList, removeClass, setAttr, setHTMLUnsafe, setStyle, setText, siblings, svg, template, templateMany, toggleClass, trackDisposer, unprovide, untrack };
+export { $, $$, type CleanupFn, type ComponentDef, type Context, type CreateListOptions, type Dispatch, type ErrorHandler, type EventBus, Fragment, type HistoryControls, type IslandHydrateFn, type KeyOptions, type ListTransitionHooks, type Owner, type PersistErrorPhase, type PersistOptions, type ReconcileResult, type Ref, type SetupFn, SignalGetter, type StoreSetter, type SwitchCase, activateIslands, addClass, batch, children, cleanup, closest, createBus, createComputed, createContext, createEffect, createErrorBoundary, createHistory, createList, createMemo, createPortal, createReducer, createRef, createRoot, createShow, createStore, createSuspense, createSwitch, createText, createUnownedRoot, deactivateAllIslands, deactivateIsland, defineComponent, delegate, disposeComponent, fragment, getOwner, h, hydrateIsland, inject, mount, nextSibling, on, onCleanup, onError, onIntersect, onKey, onMount, onMutation, onResize, onUnmount, parent, persist, prevSibling, provide, reconcileList, removeClass, runWithOwner, setAttr, setHTMLUnsafe, setStyle, setText, siblings, svg, template, templateMany, toggleClass, trackDisposer, unprovide, untrack };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 /// <reference path="./jsx.d.ts" />
-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';
+import { S as SignalGetter } from './signal-CIXTR4Qz.js';
+export { a as SignalOptions, b as SignalSetter, c as createSignal, g as getSignalName, v as value } from './signal-CIXTR4Qz.js';
+export { R as Resource, a as ResourceFetcherInfo, b as ResourceOptions, c as createResource } from './resource-CBTcorBJ.js';
 export { getBatchDepth, isComputed, isEffect, isEffectScope, isSignal, trigger } from 'alien-signals';
 
 declare function createEffect(fn: () => void | (() => void)): () => void;
@@ -125,6 +125,38 @@ 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).
+ */
+/**
+ * The minimal ownership unit: something that holds disposers. A {@link RootScope}
+ * is an Owner with an extra alien-signals scope dispose. Effects use lightweight
+ * child owners (no scopeDispose) to own their nested effects generation-by-generation.
+ */
+interface Owner {
+    /** Disposers to run when this owner is torn down. */
+    disposers: (() => void)[];
+}
+/** @internal — the owner disposers currently register with (or null). */
+declare function getOwner(): Owner | null;
+/**
+ * Run `fn` with `owner` installed as the current owner, restoring the previous
+ * owner afterwards. Lets effects/roots created asynchronously (after the
+ * original root callback returned) still be owned and disposed.
+ */
+declare function runWithOwner<T>(owner: Owner | null, fn: () => T): T;
 /**
  * Create a reactive root scope.
  *
@@ -831,7 +863,9 @@ declare function trackDisposer(dispose: () => void): void;
  *
  * Dependency injection via stack-based context.
  * Simpler than React's Provider component tree: provide() pushes a value,
- * inject() reads the top, component teardown pops automatically.
+ * inject() reads the top. When provide() is called during a component setup, the
+ * value is auto-unprovided on that component's dispose; outside a component you
+ * must call unprovide() yourself.
  * Zero dependencies -- native browser APIs only.
  */
 /** A typed dependency injection context created by {@link createContext}. */
@@ -1188,4 +1222,4 @@ declare function onIntersect(el: HTMLElement, handler: (entry: IntersectionObser
  */
 declare function onMutation(el: HTMLElement, handler: (mutations: MutationRecord[]) => void, options?: MutationObserverInit): () => void;
 
-export { $, $$, type CleanupFn, type ComponentDef, type Context, type CreateListOptions, type Dispatch, type ErrorHandler, type EventBus, Fragment, type HistoryControls, type IslandHydrateFn, type KeyOptions, type ListTransitionHooks, type PersistErrorPhase, type PersistOptions, type ReconcileResult, type Ref, type SetupFn, SignalGetter, type StoreSetter, type SwitchCase, activateIslands, addClass, batch, children, cleanup, closest, createBus, createComputed, createContext, createEffect, createErrorBoundary, createHistory, createList, createMemo, createPortal, createReducer, createRef, createRoot, createShow, createStore, createSuspense, createSwitch, createText, createUnownedRoot, deactivateAllIslands, deactivateIsland, defineComponent, delegate, disposeComponent, fragment, h, hydrateIsland, inject, mount, nextSibling, on, onCleanup, onError, onIntersect, onKey, onMount, onMutation, onResize, onUnmount, parent, persist, prevSibling, provide, reconcileList, removeClass, setAttr, setHTMLUnsafe, setStyle, setText, siblings, svg, template, templateMany, toggleClass, trackDisposer, unprovide, untrack };
+export { $, $$, type CleanupFn, type ComponentDef, type Context, type CreateListOptions, type Dispatch, type ErrorHandler, type EventBus, Fragment, type HistoryControls, type IslandHydrateFn, type KeyOptions, type ListTransitionHooks, type Owner, type PersistErrorPhase, type PersistOptions, type ReconcileResult, type Ref, type SetupFn, SignalGetter, type StoreSetter, type SwitchCase, activateIslands, addClass, batch, children, cleanup, closest, createBus, createComputed, createContext, createEffect, createErrorBoundary, createHistory, createList, createMemo, createPortal, createReducer, createRef, createRoot, createShow, createStore, createSuspense, createSwitch, createText, createUnownedRoot, deactivateAllIslands, deactivateIsland, defineComponent, delegate, disposeComponent, fragment, getOwner, h, hydrateIsland, inject, mount, nextSibling, on, onCleanup, onError, onIntersect, onKey, onMount, onMutation, onResize, onUnmount, parent, persist, prevSibling, provide, reconcileList, removeClass, runWithOwner, setAttr, setHTMLUnsafe, setStyle, setText, siblings, svg, template, templateMany, toggleClass, trackDisposer, unprovide, untrack };

package/dist/index.js

@@ -1,9 +1,9 @@
-import { hydrateIsland } from './chunk-AJP4OVCN.js';
-export { Fragment, cleanup, createList, createShow, fragment, h, hydrateIsland, reconcileList, svg } from './chunk-AJP4OVCN.js';
-import { internalEffect, createUnownedRoot, createRoot, untrack, registerDisposer, createEffect, pushSuspenseContext, popSuspenseContext, batch } from './chunk-Y3A2EVVS.js';
-export { batch, createEffect, createMemo, createReducer, createRef, createResource, createRoot, createUnownedRoot, getBatchDepth, isComputed, isEffect, isEffectScope, isSignal, on, onCleanup, trigger, untrack } from './chunk-Y3A2EVVS.js';
-import { createSignal, __DEV__, reportError, value } from './chunk-ETPJTPYD.js';
-export { createComputed, createSignal, onError } from './chunk-ETPJTPYD.js';
+import { hydrateIsland } from './chunk-3U2IQIKB.js';
+export { Fragment, cleanup, createList, createShow, fragment, h, hydrateIsland, reconcileList, svg } from './chunk-3U2IQIKB.js';
+import { internalEffect, createUnownedRoot, createRoot, untrack, registerDisposer, createEffect, pushSuspenseContext, popSuspenseContext, batch } from './chunk-F5QUU76U.js';
+export { batch, createEffect, createMemo, createReducer, createRef, createResource, createRoot, createUnownedRoot, getBatchDepth, getOwner, isComputed, isEffect, isEffectScope, isSignal, on, onCleanup, runWithOwner, trigger, untrack } from './chunk-F5QUU76U.js';
+import { createSignal, __DEV__, reportError, value } from './chunk-FAIWRZKJ.js';
+export { createComputed, createSignal, getSignalName, onError, value } from './chunk-FAIWRZKJ.js';
 
 // src/dom/text.ts
 function createText(value2) {
@@ -405,6 +405,13 @@ function onUnmount(fn) {
   }
   currentLifecycleContext.unmountCallbacks.push(fn);
 }
+function registerContextDisposer(dispose) {
+  if (currentLifecycleContext !== null) {
+    currentLifecycleContext.contextDisposers.push(dispose);
+    return true;
+  }
+  return false;
+}
 var DISPOSE_KEY = /* @__PURE__ */ Symbol("forma:component:dispose");
 function defineComponent(setupOrDef) {
   const setup = typeof setupOrDef === "function" ? setupOrDef : setupOrDef.setup;
@@ -413,16 +420,29 @@ function defineComponent(setupOrDef) {
     const ctx = {
       disposers: [],
       mountCallbacks: [],
-      unmountCallbacks: []
+      unmountCallbacks: [],
+      contextDisposers: []
     };
     pushLifecycleContext(ctx);
     let dom;
     try {
       dom = setup();
+    } catch (e) {
+      for (let i = ctx.contextDisposers.length - 1; i >= 0; i--) {
+        try {
+          ctx.contextDisposers[i]();
+        } catch {
+        }
+      }
+      ctx.contextDisposers.length = 0;
+      throw e;
     } finally {
       popLifecycleContext();
     }
+    let disposed = false;
     const dispose = () => {
+      if (disposed) return;
+      disposed = true;
       for (const cb of ctx.unmountCallbacks) {
         try {
           cb();
@@ -437,20 +457,38 @@ function defineComponent(setupOrDef) {
           reportError(e, "component disposer");
         }
       }
+      for (let i = ctx.contextDisposers.length - 1; i >= 0; i--) {
+        try {
+          ctx.contextDisposers[i]();
+        } catch (e) {
+          reportError(e, "context disposer");
+        }
+      }
       ctx.disposers.length = 0;
       ctx.mountCallbacks.length = 0;
       ctx.unmountCallbacks.length = 0;
+      ctx.contextDisposers.length = 0;
     };
     dom[DISPOSE_KEY] = dispose;
-    for (const cb of ctx.mountCallbacks) {
-      try {
-        const cleanup2 = cb();
-        if (typeof cleanup2 === "function") {
-          ctx.unmountCallbacks.push(cleanup2);
+    if (dom.nodeType === 11) {
+      for (const child of Array.from(dom.childNodes)) {
+        child[DISPOSE_KEY] = dispose;
+      }
+    }
+    pushLifecycleContext(ctx);
+    try {
+      for (const cb of ctx.mountCallbacks) {
+        try {
+          const cleanup2 = cb();
+          if (typeof cleanup2 === "function") {
+            ctx.unmountCallbacks.push(cleanup2);
+          }
+        } catch (e) {
+          reportError(e, "onMount");
         }
-      } catch (e) {
-        reportError(e, "onMount");
       }
+    } finally {
+      popLifecycleContext();
     }
     return dom;
   };
@@ -470,6 +508,17 @@ function trackDisposer(dispose) {
 
 // src/component/context.ts
 var contextStacks = /* @__PURE__ */ new Map();
+function removeFrame(id, token) {
+  const stack = contextStacks.get(id);
+  if (!stack) return;
+  for (let i = stack.length - 1; i >= 0; i--) {
+    if (stack[i].token === token) {
+      stack.splice(i, 1);
+      break;
+    }
+  }
+  if (stack.length === 0) contextStacks.delete(id);
+}
 function createContext(defaultValue) {
   return {
     id: /* @__PURE__ */ Symbol("forma:context"),
@@ -482,14 +531,16 @@ function provide(ctx, value2) {
     stack = [];
     contextStacks.set(ctx.id, stack);
   }
-  stack.push(value2);
+  const token = /* @__PURE__ */ Symbol("forma:context-frame");
+  stack.push({ token, value: value2 });
+  registerContextDisposer(() => removeFrame(ctx.id, token));
 }
 function inject(ctx) {
   const stack = contextStacks.get(ctx.id);
   if (stack === void 0 || stack.length === 0) {
     return ctx.defaultValue;
   }
-  return stack[stack.length - 1];
+  return stack[stack.length - 1].value;
 }
 function unprovide(ctx) {
   const stack = contextStacks.get(ctx.id);