@getforma/core 0.6.1 → 0.8.1

package/dist/index.d.cts

@@ -1,6 +1,7 @@
 /// <reference path="./jsx.d.ts" />
-import { S as SignalGetter } from './signal-CfLDwMyg.cjs';
-export { c as createSignal } from './signal-CfLDwMyg.cjs';
+import { S as SignalGetter } from './signal-B4_wQJHs.cjs';
+export { c as createSignal } from './signal-B4_wQJHs.cjs';
+export { getBatchDepth, isComputed, isEffect, isEffectScope, isSignal, trigger } from 'alien-signals';
 
 declare function createEffect(fn: () => void | (() => void)): () => void;
 
@@ -21,6 +22,9 @@ declare function createEffect(fn: () => void | (() => void)): () => void;
  * SolidJS's createMemo. Both createComputed and createMemo in FormaJS
  * are identical.
  *
+ * The getter receives the previous value as an argument, enabling
+ * efficient diffing patterns without a separate signal:
+ *
  * ```ts
  * const [count, setCount] = createSignal(0);
  * const doubled = createComputed(() => count() * 2);
@@ -28,8 +32,18 @@ declare function createEffect(fn: () => void | (() => void)): () => void;
  * setCount(5);
  * console.log(doubled()); // 10
  * ```
+ *
+ * With previous value (for diffing):
+ *
+ * ```ts
+ * const changes = createComputed((prev) => {
+ *   const next = items();
+ *   if (prev) console.log(`changed from ${prev.length} to ${next.length} items`);
+ *   return next;
+ * });
+ * ```
  */
-declare function createComputed<T>(fn: () => T): () => T;
+declare function createComputed<T>(fn: (previousValue?: T) => T): () => T;
 
 /**
  * Forma Reactive - Memo
@@ -116,13 +130,17 @@ declare function untrack<T>(fn: () => T): T;
  * Explicit reactive ownership scope. All effects created inside a root
  * are automatically disposed when the root is torn down.
  *
- * Replaces the module-level disposalBag pattern in mount.ts.
+ * 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).
  */
 /**
  * Create a reactive root scope.
  *
- * All effects created (via `createEffect`) inside the callback are tracked.
- * The returned `dispose` function tears them all down.
+ * All effects created (via `createEffect`) inside the callback are tracked
+ * at both the reactive graph level (via alien-signals effectScope) and the
+ * userland level (via registerDisposer). The returned `dispose` function
+ * tears down everything.
  *
  * ```ts
  * const dispose = createRoot(() => {
@@ -898,6 +916,11 @@ type StoreSetter<T extends object> = (partial: Partial<T> | ((prev: T) => Partia
  * // Array mutations
  * state.items.push({ text: 'Walk dog', done: false });
  * ```
+ *
+ * **Limitation:** `Object.keys(state)`, `for...in`, and spread (`{...state}`)
+ * are NOT reactive. Adding or removing a property will not trigger effects
+ * that iterated over keys. Use signals or explicit arrays for collections
+ * that need to react to membership changes.
  */
 declare function createStore<T extends object>(initial: T): [get: T, set: StoreSetter<T>];
 
@@ -1425,18 +1448,4 @@ declare function createRPCMiddleware(): (req: {
     };
 }) => Promise<void>;
 
-declare global {
-    interface Window {
-        __FORMA_WASM__?: {
-            loader: string;
-            binary: string;
-            ir: string;
-        };
-    }
-}
-/** Full page render via WASM. */
-declare function renderLocal(slotsJson: string): Promise<string>;
-/** Fragment render (single island) via WASM. */
-declare function renderIsland(slotsJson: string, islandId: number): Promise<string>;
-
-export { $, $$, $$serverFunction, type Action, type ActionOptions, Fragment, type IslandHydrateFn, type MutationResponse, type RPCRequest, type RPCResponse, activateIslands, addClass, applyRevalidation, batch, children, cleanup, closest, createAction, createBus, createComputed, createContext, createEffect, createErrorBoundary, createFetch, createHistory, createIndexedDB, createList, createLocalStorage, createMemo, createPortal, createRPCMiddleware, createReducer, createRef, createResource, createRoot, createSSE, createSessionStorage, createShow, createStore, createSuspense, createSwitch, createText, createWebSocket, deactivateAllIslands, deactivateIsland, defineComponent, delegate, disposeComponent, enableAutoRevalidation, fetchJSON, fragment, getRegisteredEndpoints, getServerFunction, h, handleRPC, hydrateIsland, inject, mount, nextSibling, on, onCleanup, onError, onIntersect, onKey, onMount, onMutation, onResize, onUnmount, parent, persist, prevSibling, provide, reconcileList, registerResource, registerServerFunction, removeClass, renderIsland, renderLocal, setAttr, setHTML, setHTMLUnsafe, setStyle, setText, siblings, toggleClass, trackDisposer, unprovide, unregisterResource, untrack, withRevalidation };
+export { $, $$, $$serverFunction, type Action, type ActionOptions, Fragment, type IslandHydrateFn, type MutationResponse, type RPCRequest, type RPCResponse, activateIslands, addClass, applyRevalidation, batch, children, cleanup, closest, createAction, createBus, createComputed, createContext, createEffect, createErrorBoundary, createFetch, createHistory, createIndexedDB, createList, createLocalStorage, createMemo, createPortal, createRPCMiddleware, createReducer, createRef, createResource, createRoot, createSSE, createSessionStorage, createShow, createStore, createSuspense, createSwitch, createText, createWebSocket, deactivateAllIslands, deactivateIsland, defineComponent, delegate, disposeComponent, enableAutoRevalidation, fetchJSON, fragment, getRegisteredEndpoints, getServerFunction, h, handleRPC, hydrateIsland, inject, mount, nextSibling, on, onCleanup, onError, onIntersect, onKey, onMount, onMutation, onResize, onUnmount, parent, persist, prevSibling, provide, reconcileList, registerResource, registerServerFunction, removeClass, setAttr, setHTML, setHTMLUnsafe, setStyle, setText, siblings, toggleClass, trackDisposer, unprovide, unregisterResource, untrack, withRevalidation };

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 /// <reference path="./jsx.d.ts" />
-import { S as SignalGetter } from './signal-CfLDwMyg.js';
-export { c as createSignal } from './signal-CfLDwMyg.js';
+import { S as SignalGetter } from './signal-B4_wQJHs.js';
+export { c as createSignal } from './signal-B4_wQJHs.js';
+export { getBatchDepth, isComputed, isEffect, isEffectScope, isSignal, trigger } from 'alien-signals';
 
 declare function createEffect(fn: () => void | (() => void)): () => void;
 
@@ -21,6 +22,9 @@ declare function createEffect(fn: () => void | (() => void)): () => void;
  * SolidJS's createMemo. Both createComputed and createMemo in FormaJS
  * are identical.
  *
+ * The getter receives the previous value as an argument, enabling
+ * efficient diffing patterns without a separate signal:
+ *
  * ```ts
  * const [count, setCount] = createSignal(0);
  * const doubled = createComputed(() => count() * 2);
@@ -28,8 +32,18 @@ declare function createEffect(fn: () => void | (() => void)): () => void;
  * setCount(5);
  * console.log(doubled()); // 10
  * ```
+ *
+ * With previous value (for diffing):
+ *
+ * ```ts
+ * const changes = createComputed((prev) => {
+ *   const next = items();
+ *   if (prev) console.log(`changed from ${prev.length} to ${next.length} items`);
+ *   return next;
+ * });
+ * ```
  */
-declare function createComputed<T>(fn: () => T): () => T;
+declare function createComputed<T>(fn: (previousValue?: T) => T): () => T;
 
 /**
  * Forma Reactive - Memo
@@ -116,13 +130,17 @@ declare function untrack<T>(fn: () => T): T;
  * Explicit reactive ownership scope. All effects created inside a root
  * are automatically disposed when the root is torn down.
  *
- * Replaces the module-level disposalBag pattern in mount.ts.
+ * 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).
  */
 /**
  * Create a reactive root scope.
  *
- * All effects created (via `createEffect`) inside the callback are tracked.
- * The returned `dispose` function tears them all down.
+ * All effects created (via `createEffect`) inside the callback are tracked
+ * at both the reactive graph level (via alien-signals effectScope) and the
+ * userland level (via registerDisposer). The returned `dispose` function
+ * tears down everything.
  *
  * ```ts
  * const dispose = createRoot(() => {
@@ -898,6 +916,11 @@ type StoreSetter<T extends object> = (partial: Partial<T> | ((prev: T) => Partia
  * // Array mutations
  * state.items.push({ text: 'Walk dog', done: false });
  * ```
+ *
+ * **Limitation:** `Object.keys(state)`, `for...in`, and spread (`{...state}`)
+ * are NOT reactive. Adding or removing a property will not trigger effects
+ * that iterated over keys. Use signals or explicit arrays for collections
+ * that need to react to membership changes.
  */
 declare function createStore<T extends object>(initial: T): [get: T, set: StoreSetter<T>];
 
@@ -1425,18 +1448,4 @@ declare function createRPCMiddleware(): (req: {
     };
 }) => Promise<void>;
 
-declare global {
-    interface Window {
-        __FORMA_WASM__?: {
-            loader: string;
-            binary: string;
-            ir: string;
-        };
-    }
-}
-/** Full page render via WASM. */
-declare function renderLocal(slotsJson: string): Promise<string>;
-/** Fragment render (single island) via WASM. */
-declare function renderIsland(slotsJson: string, islandId: number): Promise<string>;
-
-export { $, $$, $$serverFunction, type Action, type ActionOptions, Fragment, type IslandHydrateFn, type MutationResponse, type RPCRequest, type RPCResponse, activateIslands, addClass, applyRevalidation, batch, children, cleanup, closest, createAction, createBus, createComputed, createContext, createEffect, createErrorBoundary, createFetch, createHistory, createIndexedDB, createList, createLocalStorage, createMemo, createPortal, createRPCMiddleware, createReducer, createRef, createResource, createRoot, createSSE, createSessionStorage, createShow, createStore, createSuspense, createSwitch, createText, createWebSocket, deactivateAllIslands, deactivateIsland, defineComponent, delegate, disposeComponent, enableAutoRevalidation, fetchJSON, fragment, getRegisteredEndpoints, getServerFunction, h, handleRPC, hydrateIsland, inject, mount, nextSibling, on, onCleanup, onError, onIntersect, onKey, onMount, onMutation, onResize, onUnmount, parent, persist, prevSibling, provide, reconcileList, registerResource, registerServerFunction, removeClass, renderIsland, renderLocal, setAttr, setHTML, setHTMLUnsafe, setStyle, setText, siblings, toggleClass, trackDisposer, unprovide, unregisterResource, untrack, withRevalidation };
+export { $, $$, $$serverFunction, type Action, type ActionOptions, Fragment, type IslandHydrateFn, type MutationResponse, type RPCRequest, type RPCResponse, activateIslands, addClass, applyRevalidation, batch, children, cleanup, closest, createAction, createBus, createComputed, createContext, createEffect, createErrorBoundary, createFetch, createHistory, createIndexedDB, createList, createLocalStorage, createMemo, createPortal, createRPCMiddleware, createReducer, createRef, createResource, createRoot, createSSE, createSessionStorage, createShow, createStore, createSuspense, createSwitch, createText, createWebSocket, deactivateAllIslands, deactivateIsland, defineComponent, delegate, disposeComponent, enableAutoRevalidation, fetchJSON, fragment, getRegisteredEndpoints, getServerFunction, h, handleRPC, hydrateIsland, inject, mount, nextSibling, on, onCleanup, onError, onIntersect, onKey, onMount, onMutation, onResize, onUnmount, parent, persist, prevSibling, provide, reconcileList, registerResource, registerServerFunction, removeClass, setAttr, setHTML, setHTMLUnsafe, setStyle, setText, siblings, toggleClass, trackDisposer, unprovide, unregisterResource, untrack, withRevalidation };

package/dist/index.js

@@ -1,7 +1,7 @@
-import { internalEffect, createRoot, hydrateIsland, untrack, createEffect, pushSuspenseContext, popSuspenseContext, __DEV__, reportError, batch } from './chunk-TKGUHASG.js';
-export { Fragment, batch, cleanup, createEffect, createList, createMemo, createReducer, createRef, createResource, createRoot, createShow, fragment, h, hydrateIsland, on, onCleanup, onError, reconcileList, untrack } from './chunk-TKGUHASG.js';
-import { createSignal } from './chunk-DPSAVBCP.js';
-export { createComputed, createSignal } from './chunk-DPSAVBCP.js';
+import { internalEffect, createRoot, hydrateIsland, untrack, createEffect, pushSuspenseContext, popSuspenseContext, __DEV__, reportError, batch } from './chunk-N522P3G6.js';
+export { Fragment, batch, cleanup, createEffect, createList, createMemo, createReducer, createRef, createResource, createRoot, createShow, fragment, getBatchDepth, h, hydrateIsland, isComputed, isEffect, isEffectScope, isSignal, on, onCleanup, onError, reconcileList, trigger, untrack } from './chunk-N522P3G6.js';
+import { createSignal } from './chunk-OZCHIVAZ.js';
+export { createComputed, createSignal } from './chunk-OZCHIVAZ.js';
 
 // src/dom/text.ts
 function createText(value) {
@@ -219,13 +219,20 @@ function createSuspense(fallback, children2) {
 }
 
 // src/dom/activate.ts
+var FORBIDDEN_PROP_KEYS = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
+function sanitizeProps(obj) {
+  for (const key of FORBIDDEN_PROP_KEYS) {
+    if (key in obj) delete obj[key];
+  }
+  return obj;
+}
 function loadIslandProps(root, id, sharedProps) {
   const inline = root.getAttribute("data-forma-props");
   if (inline) {
-    return JSON.parse(inline);
+    return sanitizeProps(JSON.parse(inline));
   }
   if (sharedProps && String(id) in sharedProps) {
-    return sharedProps[String(id)];
+    return sanitizeProps(sharedProps[String(id)]);
   }
   return null;
 }
@@ -242,8 +249,8 @@ function activateIslands(registry2) {
       root.setAttribute("data-forma-status", "error");
       continue;
     }
-    const trigger = root.getAttribute("data-forma-hydrate") || "load";
-    if (trigger === "visible") {
+    const trigger2 = root.getAttribute("data-forma-hydrate") || "load";
+    if (trigger2 === "visible") {
       const observer = new IntersectionObserver(
         (entries) => {
           for (const entry of entries) {
@@ -255,14 +262,14 @@ function activateIslands(registry2) {
         { rootMargin: "200px" }
       );
       observer.observe(root);
-    } else if (trigger === "idle") {
+    } else if (trigger2 === "idle") {
       const hydrate = () => hydrateIslandRoot(root, id, componentName, hydrateFn, sharedProps);
       if (typeof requestIdleCallback === "function") {
         requestIdleCallback(hydrate);
       } else {
         setTimeout(hydrate, 200);
       }
-    } else if (trigger === "interaction") {
+    } else if (trigger2 === "interaction") {
       const hydrate = () => {
         root.removeEventListener("pointerdown", hydrate, true);
         root.removeEventListener("focusin", hydrate, true);
@@ -445,13 +452,15 @@ function shouldWrap(v) {
   if (v[PROXY]) return false;
   return true;
 }
-function deepClone(obj) {
-  if (obj == null || typeof obj !== "object") return obj;
-  if (Array.isArray(obj)) return obj.map(deepClone);
-  if (obj instanceof Date) return new Date(obj.getTime());
+function deepClone(obj, seen) {
+  if (obj === null || typeof obj !== "object") return obj;
+  if (!seen) seen = /* @__PURE__ */ new WeakSet();
+  if (seen.has(obj)) return obj;
+  seen.add(obj);
+  if (Array.isArray(obj)) return obj.map((item) => deepClone(item, seen));
   const out = {};
   for (const key of Object.keys(obj)) {
-    out[key] = deepClone(obj[key]);
+    out[key] = deepClone(obj[key], seen);
   }
   return out;
 }
@@ -1502,40 +1511,6 @@ function createRPCMiddleware() {
   };
 }
 
-// src/wasm/forma-wasm.ts
-var wasmModule = null;
-var irCache = /* @__PURE__ */ new Map();
-async function ensureWasm() {
-  if (wasmModule) return wasmModule;
-  const config = window.__FORMA_WASM__;
-  if (!config) throw new Error("No __FORMA_WASM__ config");
-  const mod = await import(
-    /* @vite-ignore */
-    config.loader
-  );
-  await mod.default(config.binary);
-  wasmModule = mod;
-  return wasmModule;
-}
-async function getIR() {
-  const config = window.__FORMA_WASM__;
-  if (!config) throw new Error("No __FORMA_WASM__ config");
-  const cached = irCache.get(config.ir);
-  if (cached) return cached;
-  const response = await fetch(config.ir);
-  const bytes = new Uint8Array(await response.arrayBuffer());
-  irCache.set(config.ir, bytes);
-  return bytes;
-}
-async function renderLocal(slotsJson) {
-  const [wasm, ir] = await Promise.all([ensureWasm(), getIR()]);
-  return wasm.render(ir, slotsJson);
-}
-async function renderIsland(slotsJson, islandId) {
-  const [wasm, ir] = await Promise.all([ensureWasm(), getIR()]);
-  return wasm.render_island(ir, slotsJson, islandId);
-}
-
-export { $, $$, $$serverFunction, activateIslands, addClass, applyRevalidation, children, closest, createAction, createBus, createContext, createErrorBoundary, createFetch, createHistory, createIndexedDB, createLocalStorage, createPortal, createRPCMiddleware, createSSE, createSessionStorage, createStore, createSuspense, createSwitch, createText, createWebSocket, deactivateAllIslands, deactivateIsland, defineComponent, delegate, disposeComponent, enableAutoRevalidation, fetchJSON, getRegisteredEndpoints, getServerFunction, handleRPC, inject, mount, nextSibling, onIntersect, onKey, onMount, onMutation, onResize, onUnmount, parent, persist, prevSibling, provide, registerResource, registerServerFunction, removeClass, renderIsland, renderLocal, setAttr, setHTML, setHTMLUnsafe, setStyle, setText, siblings, toggleClass, trackDisposer, unprovide, unregisterResource, withRevalidation };
+export { $, $$, $$serverFunction, activateIslands, addClass, applyRevalidation, children, closest, createAction, createBus, createContext, createErrorBoundary, createFetch, createHistory, createIndexedDB, createLocalStorage, createPortal, createRPCMiddleware, createSSE, createSessionStorage, createStore, createSuspense, createSwitch, createText, createWebSocket, deactivateAllIslands, deactivateIsland, defineComponent, delegate, disposeComponent, enableAutoRevalidation, fetchJSON, getRegisteredEndpoints, getServerFunction, handleRPC, inject, mount, nextSibling, onIntersect, onKey, onMount, onMutation, onResize, onUnmount, parent, persist, prevSibling, provide, registerResource, registerServerFunction, removeClass, setAttr, setHTML, setHTMLUnsafe, setStyle, setText, siblings, toggleClass, trackDisposer, unprovide, unregisterResource, withRevalidation };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map