@fictjs/runtime 0.0.3 → 0.0.5

package/dist/slim.d.cts

@@ -9,12 +9,22 @@ interface SignalAccessor<T> {
  * Computed accessor - function to get computed value
  */
 type ComputedAccessor<T> = () => T;
+/**
+ * Effect scope disposer - function to dispose an effect scope
+ */
+type EffectScopeDisposer = () => void;
 /**
  * Create a reactive signal
  * @param initialValue - The initial value
  * @returns A signal accessor function
  */
 declare function signal<T>(initialValue: T): SignalAccessor<T>;
+/**
+ * Create a reactive effect scope
+ * @param fn - The scope function
+ * @returns An effect scope disposer function
+ */
+declare function effectScope(fn: () => void): EffectScopeDisposer;
 declare const $state: <T>(value: T) => T;
 /**
  * Create a selector signal that efficiently updates only when the selected key matches.
@@ -60,9 +70,6 @@ type Effect = () => void | Cleanup;
 declare function createEffect(fn: Effect): () => void;
 declare function createRenderEffect(fn: Effect): () => void;
 
-declare function batch<T>(fn: () => T): T;
-declare function untrack<T>(fn: () => T): T;
-
 /**
  * Fict Reactive DOM Binding System
  *
@@ -76,6 +83,8 @@ declare function untrack<T>(fn: () => T): T;
  * - The compiler transforms JSX expressions to use these primitives
  */
 
+/** A reactive value that can be either static or a getter function */
+type MaybeReactive<T> = T | (() => T);
 /** Internal type for createElement function reference */
 type CreateElementFn = (node: FictNode) => Node;
 /** Handle returned by conditional/list bindings for cleanup */
@@ -212,6 +221,24 @@ type KeyFn<T> = (item: T, index: number) => string | number;
  */
 declare function createList<T>(items: () => T[], renderItem: (item: T, index: number) => FictNode, createElementFn: CreateElementFn, getKey?: KeyFn<T>): BindingHandle;
 
+interface ReactiveScope {
+    run<T>(fn: () => T): T;
+    stop(): void;
+}
+/**
+ * Create an explicit reactive scope that can contain effects/memos and be stopped manually.
+ * The scope registers with the current root for cleanup.
+ */
+declare function createScope(): ReactiveScope;
+/**
+ * Run a block of reactive code inside a managed scope that follows a boolean flag.
+ * When the flag turns false, the scope is disposed and all contained effects/memos are cleaned up.
+ */
+declare function runInScope(flag: MaybeReactive<boolean>, fn: () => void): void;
+
+declare function batch<T>(fn: () => T): T;
+declare function untrack<T>(fn: () => T): T;
+
 /**
  * Fict DOM Rendering System
  *
@@ -472,4 +499,4 @@ type PropGetter<T> = (() => T) & {
  */
 declare function useProp<T>(getter: () => T): PropGetter<T>;
 
-export { $state, Fragment, __fictPopContext, __fictProp, __fictPropsRest, __fictPushContext, __fictRender, __fictResetContext, __fictUseContext, __fictUseEffect, __fictUseMemo, __fictUseSignal, batch, bindAttribute, bindClass, bindEvent, bindProperty, bindRef, bindStyle, bindText, clearDelegatedEvents, createConditional, createEffect, createElement, createKeyedBlock, createKeyedList, createKeyedListContainer, createList, createMemo, createPropsProxy, createRenderEffect, createSelector, signal as createSignal, delegateEvents, destroyMarkerBlock, getFirstNodeAfter, insert, insertNodesBefore, mergeProps, moveMarkerBlock, onDestroy, __fictProp as prop, removeNodes, render, template, toNodeArray, untrack, useProp };
+export { $state, Fragment, type ReactiveScope, __fictPopContext, __fictProp, __fictPropsRest, __fictPushContext, __fictRender, __fictResetContext, __fictUseContext, __fictUseEffect, __fictUseMemo, __fictUseSignal, batch, bindAttribute, bindClass, bindEvent, bindProperty, bindRef, bindStyle, bindText, clearDelegatedEvents, createConditional, createEffect, createElement, createKeyedBlock, createKeyedList, createKeyedListContainer, createList, createMemo, createPropsProxy, createRenderEffect, createScope, createSelector, signal as createSignal, delegateEvents, destroyMarkerBlock, effectScope, getFirstNodeAfter, insert, insertNodesBefore, mergeProps, moveMarkerBlock, onDestroy, __fictProp as prop, removeNodes, render, runInScope, template, toNodeArray, untrack, useProp };

package/dist/slim.d.ts

@@ -9,12 +9,22 @@ interface SignalAccessor<T> {
  * Computed accessor - function to get computed value
  */
 type ComputedAccessor<T> = () => T;
+/**
+ * Effect scope disposer - function to dispose an effect scope
+ */
+type EffectScopeDisposer = () => void;
 /**
  * Create a reactive signal
  * @param initialValue - The initial value
  * @returns A signal accessor function
  */
 declare function signal<T>(initialValue: T): SignalAccessor<T>;
+/**
+ * Create a reactive effect scope
+ * @param fn - The scope function
+ * @returns An effect scope disposer function
+ */
+declare function effectScope(fn: () => void): EffectScopeDisposer;
 declare const $state: <T>(value: T) => T;
 /**
  * Create a selector signal that efficiently updates only when the selected key matches.
@@ -60,9 +70,6 @@ type Effect = () => void | Cleanup;
 declare function createEffect(fn: Effect): () => void;
 declare function createRenderEffect(fn: Effect): () => void;
 
-declare function batch<T>(fn: () => T): T;
-declare function untrack<T>(fn: () => T): T;
-
 /**
  * Fict Reactive DOM Binding System
  *
@@ -76,6 +83,8 @@ declare function untrack<T>(fn: () => T): T;
  * - The compiler transforms JSX expressions to use these primitives
  */
 
+/** A reactive value that can be either static or a getter function */
+type MaybeReactive<T> = T | (() => T);
 /** Internal type for createElement function reference */
 type CreateElementFn = (node: FictNode) => Node;
 /** Handle returned by conditional/list bindings for cleanup */
@@ -212,6 +221,24 @@ type KeyFn<T> = (item: T, index: number) => string | number;
  */
 declare function createList<T>(items: () => T[], renderItem: (item: T, index: number) => FictNode, createElementFn: CreateElementFn, getKey?: KeyFn<T>): BindingHandle;
 
+interface ReactiveScope {
+    run<T>(fn: () => T): T;
+    stop(): void;
+}
+/**
+ * Create an explicit reactive scope that can contain effects/memos and be stopped manually.
+ * The scope registers with the current root for cleanup.
+ */
+declare function createScope(): ReactiveScope;
+/**
+ * Run a block of reactive code inside a managed scope that follows a boolean flag.
+ * When the flag turns false, the scope is disposed and all contained effects/memos are cleaned up.
+ */
+declare function runInScope(flag: MaybeReactive<boolean>, fn: () => void): void;
+
+declare function batch<T>(fn: () => T): T;
+declare function untrack<T>(fn: () => T): T;
+
 /**
  * Fict DOM Rendering System
  *
@@ -472,4 +499,4 @@ type PropGetter<T> = (() => T) & {
  */
 declare function useProp<T>(getter: () => T): PropGetter<T>;
 
-export { $state, Fragment, __fictPopContext, __fictProp, __fictPropsRest, __fictPushContext, __fictRender, __fictResetContext, __fictUseContext, __fictUseEffect, __fictUseMemo, __fictUseSignal, batch, bindAttribute, bindClass, bindEvent, bindProperty, bindRef, bindStyle, bindText, clearDelegatedEvents, createConditional, createEffect, createElement, createKeyedBlock, createKeyedList, createKeyedListContainer, createList, createMemo, createPropsProxy, createRenderEffect, createSelector, signal as createSignal, delegateEvents, destroyMarkerBlock, getFirstNodeAfter, insert, insertNodesBefore, mergeProps, moveMarkerBlock, onDestroy, __fictProp as prop, removeNodes, render, template, toNodeArray, untrack, useProp };
+export { $state, Fragment, type ReactiveScope, __fictPopContext, __fictProp, __fictPropsRest, __fictPushContext, __fictRender, __fictResetContext, __fictUseContext, __fictUseEffect, __fictUseMemo, __fictUseSignal, batch, bindAttribute, bindClass, bindEvent, bindProperty, bindRef, bindStyle, bindText, clearDelegatedEvents, createConditional, createEffect, createElement, createKeyedBlock, createKeyedList, createKeyedListContainer, createList, createMemo, createPropsProxy, createRenderEffect, createScope, createSelector, signal as createSignal, delegateEvents, destroyMarkerBlock, effectScope, getFirstNodeAfter, insert, insertNodesBefore, mergeProps, moveMarkerBlock, onDestroy, __fictProp as prop, removeNodes, render, runInScope, template, toNodeArray, untrack, useProp };

package/dist/slim.js

@@ -99,6 +99,7 @@ function reportCycle(reason, detail = void 0) {
 
 // src/lifecycle.ts
 var currentRoot;
+var currentEffectCleanups;
 var globalErrorHandlers = /* @__PURE__ */ new WeakMap();
 var globalSuspenseHandlers = /* @__PURE__ */ new WeakMap();
 function createRootContext(parent = currentRoot) {
@@ -128,6 +129,9 @@ function onDestroy(fn) {
   }
   runLifecycle(fn);
 }
+function onCleanup(fn) {
+  registerEffectCleanup(fn);
+}
 function flushOnMount(root) {
   const cbs = root.onMountCallbacks;
   if (!cbs || cbs.length === 0) return;
@@ -166,10 +170,35 @@ function destroyRoot(root) {
     globalSuspenseHandlers.delete(root);
   }
 }
+function createRoot(fn) {
+  const root = createRootContext();
+  const prev = pushRoot(root);
+  let value;
+  try {
+    value = fn();
+  } finally {
+    popRoot(prev);
+  }
+  flushOnMount(root);
+  return {
+    dispose: () => destroyRoot(root),
+    value
+  };
+}
 function withEffectCleanups(bucket, fn) {
+  const prev = currentEffectCleanups;
+  currentEffectCleanups = bucket;
   try {
     return fn();
   } finally {
+    currentEffectCleanups = prev;
+  }
+}
+function registerEffectCleanup(fn) {
+  if (currentEffectCleanups) {
+    currentEffectCleanups.push(fn);
+  } else {
+    registerRootCleanup(fn);
   }
 }
 function runCleanupList(list) {
@@ -718,6 +747,21 @@ function effect(fn) {
 function effectOper() {
   disposeNode(this);
 }
+function effectScope(fn) {
+  const e = { deps: void 0, depsTail: void 0, subs: void 0, subsTail: void 0, flags: 0 };
+  const prevSub = activeSub;
+  if (prevSub !== void 0) link(e, prevSub, 0);
+  activeSub = e;
+  try {
+    fn();
+  } finally {
+    activeSub = prevSub;
+  }
+  return effectScopeOper.bind(e);
+}
+function effectScopeOper() {
+  disposeNode(this);
+}
 function batch(fn) {
   ++batchDepth;
   try {
@@ -861,14 +905,6 @@ function createRenderEffect(fn) {
   return teardown;
 }
 
-// src/scheduler.ts
-function batch2(fn) {
-  return batch(fn);
-}
-function untrack2(fn) {
-  return untrack(fn);
-}
-
 // src/constants.ts
 var booleans = [
   "allowfullscreen",
@@ -1311,6 +1347,27 @@ function removeNodes(nodes) {
 function isReactive(value) {
   return typeof value === "function" && value.length === 0;
 }
+function callEventHandler(handler, event, node, data) {
+  if (!handler) return;
+  const context = node ?? event.currentTarget ?? void 0;
+  const invoke = (fn) => {
+    if (typeof fn === "function") {
+      const result = data === void 0 ? fn.call(context, event) : fn.call(context, data, event);
+      if (typeof result === "function" && result !== fn) {
+        if (data === void 0) {
+          result.call(context, event);
+        } else {
+          result.call(context, data, event);
+        }
+      } else if (result && typeof result.handleEvent === "function") {
+        result.handleEvent.call(result, event);
+      }
+    } else if (fn && typeof fn.handleEvent === "function") {
+      fn.handleEvent.call(fn, event);
+    }
+  };
+  invoke(handler);
+}
 var PRIMITIVE_PROXY = Symbol("fict:primitive-proxy");
 var PRIMITIVE_PROXY_RAW_VALUE = Symbol("fict:primitive-proxy:raw-value");
 function createValueProxy(read) {
@@ -1797,14 +1854,10 @@ function globalEventHandler(e) {
       const hasData = rawData !== void 0;
       const resolvedNodeData = hasData ? resolveData(rawData) : void 0;
       if (typeof handler === "function") {
-        if (hasData) {
-          handler.call(node, resolvedNodeData, e);
-        } else {
-          handler.call(node, e);
-        }
+        callEventHandler(handler, e, node, hasData ? resolvedNodeData : void 0);
       } else if (Array.isArray(handler)) {
         const tupleData = resolveData(handler[1]);
-        handler[0].call(node, tupleData, e);
+        callEventHandler(handler[0], e, node, tupleData);
       }
       if (e.cancelBubble) return false;
     }
@@ -1852,23 +1905,15 @@ function bindEvent(el, eventName, handler, options2) {
   if (DelegatedEvents.has(eventName) && !options2) {
     const key = `$$${eventName}`;
     delegateEvents([eventName]);
-    const createWrapped = (resolve) => {
-      const wrapped2 = function(...args) {
-        try {
-          const fn = resolve();
-          if (typeof fn === "function") {
-            return fn.apply(this, args);
-          } else if (fn && typeof fn.handleEvent === "function") {
-            return fn.handleEvent.apply(fn, args);
-          }
-        } catch (err) {
-          handleError(err, { source: "event", eventName }, rootRef);
-        }
-      };
-      return wrapped2;
-    };
     const resolveHandler = isReactive(handler) ? handler : () => handler;
-    el[key] = createWrapped(resolveHandler);
+    el[key] = function(...args) {
+      try {
+        const fn = resolveHandler();
+        callEventHandler(fn, args[0], el);
+      } catch (err) {
+        handleError(err, { source: "event", eventName }, rootRef);
+      }
+    };
     return () => {
       el[key] = void 0;
     };
@@ -1877,13 +1922,7 @@ function bindEvent(el, eventName, handler, options2) {
   const wrapped = (event) => {
     try {
       const resolved = getHandler();
-      if (typeof resolved === "function") {
-        ;
-        resolved(event);
-      } else if (resolved && typeof resolved.handleEvent === "function") {
-        ;
-        resolved.handleEvent(event);
-      }
+      callEventHandler(resolved, event, el);
     } catch (err) {
       if (handleError(err, { source: "event", eventName }, rootRef)) {
         return;
@@ -2342,6 +2381,46 @@ function bumpBlockVersion(block) {
   block.version(block.version() + 1);
 }
 
+// src/scope.ts
+function createScope() {
+  let dispose = null;
+  const stop = () => {
+    if (dispose) {
+      dispose();
+      dispose = null;
+    }
+  };
+  const run = (fn) => {
+    stop();
+    const { dispose: rootDispose, value } = createRoot(fn);
+    dispose = rootDispose;
+    return value;
+  };
+  registerRootCleanup(stop);
+  return { run, stop };
+}
+function runInScope(flag, fn) {
+  const scope = createScope();
+  const evaluate = () => isReactive(flag) ? flag() : !!flag;
+  createEffect(() => {
+    const enabled = evaluate();
+    if (enabled) {
+      scope.run(fn);
+    } else {
+      scope.stop();
+    }
+  });
+  onCleanup(scope.stop);
+}
+
+// src/scheduler.ts
+function batch2(fn) {
+  return batch(fn);
+}
+function untrack2(fn) {
+  return untrack(fn);
+}
+
 // src/hooks.ts
 var ctxStack = [];
 function __fictUseContext() {
@@ -3330,6 +3409,6 @@ function createFineGrainedKeyedList(getItems, keyFn, renderItem, needsIndex) {
   };
 }
 
-export { $state, Fragment, __fictPopContext, __fictProp, __fictPropsRest, __fictPushContext, __fictRender, __fictResetContext, __fictUseContext, __fictUseEffect, __fictUseMemo, __fictUseSignal, batch2 as batch, bindAttribute, bindClass, bindEvent, bindProperty, bindRef, bindStyle, bindText, clearDelegatedEvents, createConditional, createEffect, createElement, createKeyedBlock, createKeyedList, createKeyedListContainer, createList, createMemo, createPropsProxy, createRenderEffect, createSelector, signal as createSignal, delegateEvents, destroyMarkerBlock, getFirstNodeAfter, insert, insertNodesBefore, mergeProps, moveMarkerBlock, onDestroy, __fictProp as prop, removeNodes, render, template, toNodeArray, untrack2 as untrack, useProp };
+export { $state, Fragment, __fictPopContext, __fictProp, __fictPropsRest, __fictPushContext, __fictRender, __fictResetContext, __fictUseContext, __fictUseEffect, __fictUseMemo, __fictUseSignal, batch2 as batch, bindAttribute, bindClass, bindEvent, bindProperty, bindRef, bindStyle, bindText, clearDelegatedEvents, createConditional, createEffect, createElement, createKeyedBlock, createKeyedList, createKeyedListContainer, createList, createMemo, createPropsProxy, createRenderEffect, createScope, createSelector, signal as createSignal, delegateEvents, destroyMarkerBlock, effectScope, getFirstNodeAfter, insert, insertNodesBefore, mergeProps, moveMarkerBlock, onDestroy, __fictProp as prop, removeNodes, render, runInScope, template, toNodeArray, untrack2 as untrack, useProp };
 //# sourceMappingURL=slim.js.map
 //# sourceMappingURL=slim.js.map