@fictjs/runtime 0.0.4 → 0.0.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fictjs/runtime",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Fict reactive runtime",
   "publishConfig": {
     "access": "public"

package/src/index.ts

@@ -3,9 +3,11 @@
 // ============================================================================
 
 export { createSignal, createSelector, type Signal, $state } from './signal'
+export { effectScope } from './signal'
 export { createStore, type Store } from './store'
 export { createMemo, type Memo, $memo } from './memo'
 export { createEffect, createRenderEffect, type Effect, $effect } from './effect'
+export { createScope, runInScope, type ReactiveScope } from './scope'
 export {
   __fictUseContext,
   __fictPushContext,

package/src/scope.ts

@@ -0,0 +1,55 @@
+import { isReactive, type MaybeReactive } from './binding'
+import { createEffect } from './effect'
+import { createRoot, onCleanup, registerRootCleanup } from './lifecycle'
+
+export { effectScope } from './signal'
+
+export 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.
+ */
+export function createScope(): ReactiveScope {
+  let dispose: (() => void) | null = null
+
+  const stop = () => {
+    if (dispose) {
+      dispose()
+      dispose = null
+    }
+  }
+
+  const run = <T>(fn: () => T): T => {
+    stop()
+    const { dispose: rootDispose, value } = createRoot(fn)
+    dispose = rootDispose
+    return value
+  }
+
+  registerRootCleanup(stop)
+  return { run, stop }
+}
+
+/**
+ * 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.
+ */
+export function runInScope(flag: MaybeReactive<boolean>, fn: () => void): void {
+  const scope = createScope()
+  const evaluate = () => (isReactive(flag) ? (flag as () => boolean)() : !!flag)
+
+  createEffect(() => {
+    const enabled = evaluate()
+    if (enabled) {
+      scope.run(fn)
+    } else {
+      scope.stop()
+    }
+  })
+
+  onCleanup(scope.stop)
+}

package/src/slim.ts

@@ -9,6 +9,7 @@
 export { createSignal, createSelector, $state } from './signal'
 export { createMemo } from './memo'
 export { createEffect, createRenderEffect } from './effect'
+export { effectScope, createScope, runInScope, type ReactiveScope } from './scope'
 export { batch, untrack } from './scheduler'
 
 // DOM rendering