@getforma/core 1.0.8 → 1.0.9

package/dist/index.d.ts

@@ -134,6 +134,11 @@ declare function untrack<T>(fn: () => T): T;
  * 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.
@@ -143,6 +148,9 @@ declare function untrack<T>(fn: () => T): T;
  * userland level (via registerDisposer). The returned `dispose` function
  * tears down everything.
  *
+ * Roots created inside another root are automatically owned by the parent.
+ * When the parent is disposed, this root is disposed too.
+ *
  * ```ts
  * const dispose = createRoot(() => {
  *   createEffect(() => console.log(count()));
@@ -152,6 +160,22 @@ declare function untrack<T>(fn: () => T): T;
  * ```
  */
 declare function createRoot<T>(fn: (dispose: () => void) => T): T;
+/**
+ * Create a reactive root that is NOT owned by any parent root.
+ *
+ * Use this for roots that must outlive their lexical parent:
+ * top-level mount points, island hydration, test harnesses, etc.
+ *
+ * ```ts
+ * createRoot(() => {
+ *   // This root outlives the parent even though it's nested:
+ *   createUnownedRoot((dispose) => {
+ *     // effects here survive parent disposal
+ *   });
+ * });
+ * ```
+ */
+declare function createUnownedRoot<T>(fn: (dispose: () => void) => T): T;
 
 /**
  * Register a cleanup function in the current reactive scope.
@@ -1146,4 +1170,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 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, 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, 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 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, template, templateMany, toggleClass, trackDisposer, unprovide, untrack };

package/dist/index.js

@@ -1,7 +1,7 @@
-import { hydrateIsland } from './chunk-7Q7LIV23.js';
-export { Fragment, cleanup, createList, createShow, fragment, h, hydrateIsland, reconcileList } from './chunk-7Q7LIV23.js';
-import { internalEffect, createRoot, untrack, createEffect, pushSuspenseContext, popSuspenseContext, __DEV__, reportError, batch } from './chunk-TBWZZ3SI.js';
-export { batch, createEffect, createMemo, createReducer, createRef, createResource, createRoot, getBatchDepth, isComputed, isEffect, isEffectScope, isSignal, on, onCleanup, onError, trigger, untrack } from './chunk-TBWZZ3SI.js';
+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';
 
@@ -25,12 +25,12 @@ function mount(component, container) {
   }
   let disposeRoot;
   if (target.hasAttribute("data-forma-ssr")) {
-    createRoot((dispose) => {
+    createUnownedRoot((dispose) => {
       disposeRoot = dispose;
       hydrateIsland(component, target);
     });
   } else {
-    const dom = createRoot((dispose) => {
+    const dom = createUnownedRoot((dispose) => {
       disposeRoot = dispose;
       return component();
     });
@@ -111,6 +111,13 @@ function createSwitch(value, cases, fallback) {
       if (DEBUG) console.log("[forma:switch] inserted", currentNode.nodeName, "before end marker");
     }
   });
+  registerDisposer(() => {
+    for (const entry of cache2.values()) {
+      entry.dispose();
+    }
+    cache2.clear();
+    currentNode = null;
+  });
   fragment2.__switchDispose = () => {
     switchDispose();
     for (const entry of cache2.values()) {
@@ -326,7 +333,7 @@ function hydrateIslandRoot(root, id, componentName, hydrateFn, sharedProps) {
     const props = loadIslandProps(root, id, sharedProps);
     root.setAttribute("data-forma-status", "hydrating");
     let activeRoot = root;
-    createRoot((dispose) => {
+    createUnownedRoot((dispose) => {
       activeRoot = hydrateIsland(() => hydrateFn(root, props), root);
       activeRoot.__formaDispose = dispose;
     });