@fictjs/runtime 0.8.0 → 0.9.0

package/README.md

@@ -15,3 +15,49 @@ yarn add @fictjs/runtime
 ```
 
 You can visit [Fict](https://github.com/fictjs/fict) for more documentation.
+
+## Dev/Prod Mode Contract (`__DEV__`)
+
+Runtime dev-only branches use this precedence:
+
+1. `__DEV__` (recommended, compile-time constant)
+2. Fallback: `process.env.NODE_ENV !== 'production'` when `process` exists
+
+For browser builds, define `__DEV__` explicitly in your bundler for predictable
+DX and dead-code elimination:
+
+- development: `__DEV__ = true`
+- production: `__DEV__ = false`
+
+## Runtime Stability Stress
+
+Run stress scenarios for runtime correctness and reliability:
+
+```bash
+pnpm --dir packages/runtime test:stress
+```
+
+Long profile:
+
+```bash
+pnpm --dir packages/runtime test:stress:long
+```
+
+Root aliases are also available:
+
+```bash
+pnpm stress:runtime
+pnpm stress:runtime:long
+```
+
+Environment knobs:
+
+- `FICT_RUNTIME_SOAK_ITERS`
+- `FICT_RUNTIME_CHURN_CYCLES`
+- `FICT_RUNTIME_CHURN_LIST_SIZE`
+- `FICT_RUNTIME_LEAK_ROUNDS`
+- `FICT_RUNTIME_LEAK_EFFECTS_PER_ROUND`
+- `FICT_RUNTIME_MAX_HEAP_GROWTH_BYTES`
+- `FICT_RUNTIME_BACKPRESSURE_UPDATES`
+- `FICT_RUNTIME_BACKPRESSURE_TIMEOUT_MS`
+- `FICT_RUNTIME_MAX_DRAIN_LATENCY_MS`

package/dist/advanced.cjs

@@ -2,11 +2,11 @@
 
 
 
-var _chunkHHDHQGJYcjs = require('./chunk-HHDHQGJY.cjs');
+var _chunkPG4QX2I2cjs = require('./chunk-PG4QX2I2.cjs');
 
 
 
-var _chunkCEV6TO5Ucjs = require('./chunk-CEV6TO5U.cjs');
+var _chunkPD6IQY2Ycjs = require('./chunk-PD6IQY2Y.cjs');
 
 
 
@@ -18,7 +18,7 @@ var _chunkCEV6TO5Ucjs = require('./chunk-CEV6TO5U.cjs');
 
 
 
-var _chunkPRF4QG73cjs = require('./chunk-PRF4QG73.cjs');
+var _chunkOAM7HABAcjs = require('./chunk-OAM7HABA.cjs');
 
 
 
@@ -28,13 +28,13 @@ var _chunkPRF4QG73cjs = require('./chunk-PRF4QG73.cjs');
 
 
 
-var _chunkFSCBL7RIcjs = require('./chunk-FSCBL7RI.cjs');
+var _chunkUBFDB6OLcjs = require('./chunk-UBFDB6OL.cjs');
 
 // src/versioned-signal.ts
 function createVersionedSignal(initialValue, options) {
   const equals = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _ => _.equals]), () => ( Object.is));
-  const value = _chunkFSCBL7RIcjs.signal.call(void 0, initialValue);
-  const version = _chunkFSCBL7RIcjs.signal.call(void 0, 0);
+  const value = _chunkUBFDB6OLcjs.signal.call(void 0, initialValue);
+  const version = _chunkUBFDB6OLcjs.signal.call(void 0, 0);
   const bumpVersion = () => {
     const next = version() + 1;
     version(next);
@@ -55,8 +55,8 @@ function createVersionedSignal(initialValue, options) {
     force: () => {
       bumpVersion();
     },
-    peekVersion: () => _chunkFSCBL7RIcjs.untrack.call(void 0, () => version()),
-    peekValue: () => _chunkFSCBL7RIcjs.untrack.call(void 0, () => value())
+    peekVersion: () => _chunkUBFDB6OLcjs.untrack.call(void 0, () => version()),
+    peekValue: () => _chunkUBFDB6OLcjs.untrack.call(void 0, () => value())
   };
 }
 
@@ -83,5 +83,5 @@ function createVersionedSignal(initialValue, options) {
 
 
 
-exports.createAttributeBinding = _chunkPRF4QG73cjs.createAttributeBinding; exports.createChildBinding = _chunkPRF4QG73cjs.createChildBinding; exports.createClassBinding = _chunkPRF4QG73cjs.createClassBinding; exports.createContext = _chunkHHDHQGJYcjs.createContext; exports.createRenderEffect = _chunkFSCBL7RIcjs.createRenderEffect; exports.createScope = _chunkCEV6TO5Ucjs.createScope; exports.createSelector = _chunkFSCBL7RIcjs.createSelector; exports.createShow = _chunkPRF4QG73cjs.createShow; exports.createSignal = _chunkFSCBL7RIcjs.signal; exports.createStyleBinding = _chunkPRF4QG73cjs.createStyleBinding; exports.createTextBinding = _chunkPRF4QG73cjs.createTextBinding; exports.createVersionedSignal = createVersionedSignal; exports.effectScope = _chunkFSCBL7RIcjs.effectScope; exports.getDevtoolsHook = _chunkFSCBL7RIcjs.getDevtoolsHook; exports.hasContext = _chunkHHDHQGJYcjs.hasContext; exports.isReactive = _chunkPRF4QG73cjs.isReactive; exports.nonReactive = _chunkPRF4QG73cjs.nonReactive; exports.reactive = _chunkPRF4QG73cjs.reactive; exports.registerErrorHandler = _chunkFSCBL7RIcjs.registerErrorHandler; exports.runInScope = _chunkCEV6TO5Ucjs.runInScope; exports.setCycleProtectionOptions = _chunkFSCBL7RIcjs.setCycleProtectionOptions; exports.unwrap = _chunkPRF4QG73cjs.unwrap; exports.useContext = _chunkHHDHQGJYcjs.useContext;
+exports.createAttributeBinding = _chunkOAM7HABAcjs.createAttributeBinding; exports.createChildBinding = _chunkOAM7HABAcjs.createChildBinding; exports.createClassBinding = _chunkOAM7HABAcjs.createClassBinding; exports.createContext = _chunkPG4QX2I2cjs.createContext; exports.createRenderEffect = _chunkUBFDB6OLcjs.createRenderEffect; exports.createScope = _chunkPD6IQY2Ycjs.createScope; exports.createSelector = _chunkUBFDB6OLcjs.createSelector; exports.createShow = _chunkOAM7HABAcjs.createShow; exports.createSignal = _chunkUBFDB6OLcjs.signal; exports.createStyleBinding = _chunkOAM7HABAcjs.createStyleBinding; exports.createTextBinding = _chunkOAM7HABAcjs.createTextBinding; exports.createVersionedSignal = createVersionedSignal; exports.effectScope = _chunkUBFDB6OLcjs.effectScope; exports.getDevtoolsHook = _chunkUBFDB6OLcjs.getDevtoolsHook; exports.hasContext = _chunkPG4QX2I2cjs.hasContext; exports.isReactive = _chunkOAM7HABAcjs.isReactive; exports.nonReactive = _chunkOAM7HABAcjs.nonReactive; exports.reactive = _chunkOAM7HABAcjs.reactive; exports.registerErrorHandler = _chunkUBFDB6OLcjs.registerErrorHandler; exports.runInScope = _chunkPD6IQY2Ycjs.runInScope; exports.setCycleProtectionOptions = _chunkUBFDB6OLcjs.setCycleProtectionOptions; exports.unwrap = _chunkOAM7HABAcjs.unwrap; exports.useContext = _chunkPG4QX2I2cjs.useContext;
 //# sourceMappingURL=advanced.cjs.map

package/dist/advanced.d.cts

@@ -1,7 +1,7 @@
-export { R as ReactiveScope, c as createScope, r as runInScope } from './scope-DlCBL1Ft.cjs';
+export { R as ReactiveScope, c as createScope, r as runInScope } from './scope-BJCtq8hJ.cjs';
 export { S as Signal, c as createSelector, s as createSignal, e as effectScope } from './signal-C4ISF17w.cjs';
-export { b as createAttributeBinding, a as createChildBinding, e as createClassBinding, h as createRenderEffect, f as createShow, d as createStyleBinding, c as createTextBinding, i as isReactive, n as nonReactive, r as reactive, g as registerErrorHandler, u as unwrap } from './effect-DAzpH7Mm.cjs';
-export { C as Context, F as FictDevtoolsHook, P as ProviderProps, c as createContext, g as getDevtoolsHook, h as hasContext, u as useContext } from './context-BFbHf9nC.cjs';
+export { b as createAttributeBinding, a as createChildBinding, e as createClassBinding, h as createRenderEffect, f as createShow, d as createStyleBinding, c as createTextBinding, i as isReactive, n as nonReactive, r as reactive, g as registerErrorHandler, u as unwrap } from './binding-BWchH3Kp.cjs';
+export { C as Context, F as FictDevtoolsHook, P as ProviderProps, c as createContext, g as getDevtoolsHook, h as hasContext, u as useContext } from './devtools-5AipK9CX.cjs';
 
 interface VersionedSignalOptions<T> {
     equals?: (prev: T, next: T) => boolean;
@@ -26,7 +26,7 @@ interface VersionedSignal<T> {
 declare function createVersionedSignal<T>(initialValue: T, options?: VersionedSignalOptions<T>): VersionedSignal<T>;
 
 interface CycleProtectionOptions {
-    /** Enable cycle protection guards (enabled by default in all modes) */
+    /** Enable cycle protection guards (enabled by default in dev mode) */
     enabled?: boolean;
     maxFlushCyclesPerMicrotask?: number;
     maxEffectRunsPerFlush?: number;

package/dist/advanced.d.ts

@@ -1,7 +1,7 @@
-export { R as ReactiveScope, c as createScope, r as runInScope } from './scope-D3DpsfoG.js';
+export { R as ReactiveScope, c as createScope, r as runInScope } from './scope-jPt5DHRT.js';
 export { S as Signal, c as createSelector, s as createSignal, e as effectScope } from './signal-C4ISF17w.js';
-export { b as createAttributeBinding, a as createChildBinding, e as createClassBinding, h as createRenderEffect, f as createShow, d as createStyleBinding, c as createTextBinding, i as isReactive, n as nonReactive, r as reactive, g as registerErrorHandler, u as unwrap } from './effect-DAzpH7Mm.js';
-export { C as Context, F as FictDevtoolsHook, P as ProviderProps, c as createContext, g as getDevtoolsHook, h as hasContext, u as useContext } from './context-C4vBQbb4.js';
+export { b as createAttributeBinding, a as createChildBinding, e as createClassBinding, h as createRenderEffect, f as createShow, d as createStyleBinding, c as createTextBinding, i as isReactive, n as nonReactive, r as reactive, g as registerErrorHandler, u as unwrap } from './binding-BWchH3Kp.js';
+export { C as Context, F as FictDevtoolsHook, P as ProviderProps, c as createContext, g as getDevtoolsHook, h as hasContext, u as useContext } from './devtools-BDp76luf.js';
 
 interface VersionedSignalOptions<T> {
     equals?: (prev: T, next: T) => boolean;
@@ -26,7 +26,7 @@ interface VersionedSignal<T> {
 declare function createVersionedSignal<T>(initialValue: T, options?: VersionedSignalOptions<T>): VersionedSignal<T>;
 
 interface CycleProtectionOptions {
-    /** Enable cycle protection guards (enabled by default in all modes) */
+    /** Enable cycle protection guards (enabled by default in dev mode) */
     enabled?: boolean;
     maxFlushCyclesPerMicrotask?: number;
     maxEffectRunsPerFlush?: number;

package/dist/advanced.js

@@ -2,11 +2,11 @@ import {
   createContext,
   hasContext,
   useContext
-} from "./chunk-WRU3IZOA.js";
+} from "./chunk-JVYH76ZX.js";
 import {
   createScope,
   runInScope
-} from "./chunk-TLDT76RV.js";
+} from "./chunk-FVX77557.js";
 import {
   createAttributeBinding,
   createChildBinding,
@@ -18,7 +18,7 @@ import {
   nonReactive,
   reactive,
   unwrap
-} from "./chunk-4LCHQ7U4.js";
+} from "./chunk-T2LNV5Q5.js";
 import {
   createRenderEffect,
   createSelector,
@@ -28,7 +28,7 @@ import {
   setCycleProtectionOptions,
   signal,
   untrack
-} from "./chunk-7YQK3XKY.js";
+} from "./chunk-DXG3TARY.js";
 
 // src/versioned-signal.ts
 function createVersionedSignal(initialValue, options) {

package/dist/{effect-DAzpH7Mm.d.cts → binding-BWchH3Kp.d.cts}

@@ -60,6 +60,28 @@ interface SuspenseToken {
     then: Promise<unknown>['then'];
 }
 
+type LifecycleFn = () => void | Cleanup;
+interface CreateRootOptions {
+    inherit?: boolean;
+}
+type ErrorHandler = (err: unknown, info?: ErrorInfo) => boolean | void;
+declare function onMount(fn: LifecycleFn): void;
+declare function onDestroy(fn: LifecycleFn): void;
+declare function onCleanup(fn: Cleanup): void;
+declare function createRoot<T>(fn: () => T, options?: CreateRootOptions): {
+    dispose: () => void;
+    value: T;
+};
+declare function registerErrorHandler(fn: ErrorHandler): void;
+
+/**
+ * Effect callback run synchronously; async callbacks are not tracked after the first await.
+ * TypeScript will reject `async () => {}` here—split async work or read signals before awaiting.
+ */
+type Effect = () => void | Cleanup;
+declare function createEffect(fn: Effect): () => void;
+declare function createRenderEffect(fn: Effect): () => void;
+
 /**
  * Fict Reactive DOM Binding System
  *
@@ -86,6 +108,15 @@ interface BindingHandle {
     /** Dispose function to clean up the binding */
     dispose: Cleanup;
 }
+interface ConditionalBindingOptions {
+    /**
+     * When true, track signal reads inside active branch render callbacks and
+     * re-run the branch callback on updates even if the top-level condition stays
+     * the same. This preserves reactivity for control-flow callbacks that cannot
+     * be lowered into fine-grained bindings.
+     */
+    trackBranchReads?: boolean;
+}
 /** Managed child node with its dispose function */
 /**
  * Check if a value is reactive (a getter function that returns a value).
@@ -370,7 +401,7 @@ declare function assign(node: Element, props: Record<string, unknown>, isSVG?: b
  * )
  * ```
  */
-declare function createConditional(condition: () => boolean, renderTrue: () => FictNode, createElementFn: CreateElementFn, renderFalse?: () => FictNode, startOverride?: Comment, endOverride?: Comment): BindingHandle;
+declare function createConditional(condition: () => boolean, renderTrue: () => FictNode, createElementFn: CreateElementFn, renderFalse?: () => FictNode, startOverride?: Comment, endOverride?: Comment, options?: ConditionalBindingOptions): BindingHandle;
 /**
  * Create a show/hide binding that uses CSS display instead of DOM manipulation.
  * More efficient than conditional when the content is expensive to create.
@@ -397,26 +428,4 @@ declare function createShow(el: Element & {
  */
 declare function createPortal(container: ParentNode & Node, render: () => FictNode, createElementFn: CreateElementFn): BindingHandle;
 
-type LifecycleFn = () => void | Cleanup;
-interface CreateRootOptions {
-    inherit?: boolean;
-}
-type ErrorHandler = (err: unknown, info?: ErrorInfo) => boolean | void;
-declare function onMount(fn: LifecycleFn): void;
-declare function onDestroy(fn: LifecycleFn): void;
-declare function onCleanup(fn: Cleanup): void;
-declare function createRoot<T>(fn: () => T, options?: CreateRootOptions): {
-    dispose: () => void;
-    value: T;
-};
-declare function registerErrorHandler(fn: ErrorHandler): void;
-
-/**
- * Effect callback run synchronously; async callbacks are not tracked after the first await.
- * TypeScript will reject `async () => {}` here—split async work or read signals before awaiting.
- */
-type Effect = () => void | Cleanup;
-declare function createEffect(fn: Effect): () => void;
-declare function createRenderEffect(fn: Effect): () => void;
-
-export { delegateEvents as $, bindText as A, type BaseProps as B, type Cleanup as C, type DOMElement as D, type Effect as E, type FictNode as F, bindAttribute as G, bindStyle as H, bindClass as I, setText as J, setAttr as K, setProp as L, setStyle as M, setClass as N, bindEvent as O, type PropsWithChildren as P, callEventHandler as Q, type RefObject as R, type SuspenseToken as S, bindProperty as T, bindRef as U, insert as V, insertBetween as W, createConditional as X, spread as Y, assign as Z, classList as _, createChildBinding as a, clearDelegatedEvents as a0, addEventListener as a1, type MaybeReactive as a2, type BindingHandle as a3, type CreateElementFn as a4, type AttributeSetter as a5, createAttributeBinding as b, createTextBinding as c, createStyleBinding as d, createClassBinding as e, createShow as f, registerErrorHandler as g, createRenderEffect as h, isReactive as i, createEffect as j, onDestroy as k, onCleanup as l, createRoot as m, nonReactive as n, onMount as o, createPortal as p, type FictVNode as q, reactive as r, type Component as s, type Ref as t, unwrap as u, type RefCallback as v, type StyleProp as w, type ClassProp as x, type EventHandler as y, type ErrorInfo as z };
+export { type PropsWithChildren as $, insert as A, type BaseProps as B, insertBetween as C, createConditional as D, createPortal as E, type FictNode as F, spread as G, assign as H, classList as I, delegateEvents as J, clearDelegatedEvents as K, addEventListener as L, type MaybeReactive as M, onDestroy as N, type BindingHandle as O, type CreateElementFn as P, type AttributeSetter as Q, type DOMElement as R, type RefObject as S, type SuspenseToken as T, type Effect as U, onMount as V, onCleanup as W, createRoot as X, type FictVNode as Y, type Cleanup as Z, type Component as _, createChildBinding as a, type Ref as a0, type RefCallback as a1, type StyleProp as a2, type ClassProp as a3, type EventHandler as a4, type ErrorInfo as a5, createAttributeBinding as b, createTextBinding as c, createStyleBinding as d, createClassBinding as e, createShow as f, registerErrorHandler as g, createRenderEffect as h, isReactive as i, createEffect as j, bindText as k, bindAttribute as l, bindStyle as m, nonReactive as n, bindClass as o, setAttr as p, setProp as q, reactive as r, setText as s, setStyle as t, unwrap as u, setClass as v, bindEvent as w, callEventHandler as x, bindProperty as y, bindRef as z };

package/dist/{effect-DAzpH7Mm.d.ts → binding-BWchH3Kp.d.ts}

@@ -60,6 +60,28 @@ interface SuspenseToken {
     then: Promise<unknown>['then'];
 }
 
+type LifecycleFn = () => void | Cleanup;
+interface CreateRootOptions {
+    inherit?: boolean;
+}
+type ErrorHandler = (err: unknown, info?: ErrorInfo) => boolean | void;
+declare function onMount(fn: LifecycleFn): void;
+declare function onDestroy(fn: LifecycleFn): void;
+declare function onCleanup(fn: Cleanup): void;
+declare function createRoot<T>(fn: () => T, options?: CreateRootOptions): {
+    dispose: () => void;
+    value: T;
+};
+declare function registerErrorHandler(fn: ErrorHandler): void;
+
+/**
+ * Effect callback run synchronously; async callbacks are not tracked after the first await.
+ * TypeScript will reject `async () => {}` here—split async work or read signals before awaiting.
+ */
+type Effect = () => void | Cleanup;
+declare function createEffect(fn: Effect): () => void;
+declare function createRenderEffect(fn: Effect): () => void;
+
 /**
  * Fict Reactive DOM Binding System
  *
@@ -86,6 +108,15 @@ interface BindingHandle {
     /** Dispose function to clean up the binding */
     dispose: Cleanup;
 }
+interface ConditionalBindingOptions {
+    /**
+     * When true, track signal reads inside active branch render callbacks and
+     * re-run the branch callback on updates even if the top-level condition stays
+     * the same. This preserves reactivity for control-flow callbacks that cannot
+     * be lowered into fine-grained bindings.
+     */
+    trackBranchReads?: boolean;
+}
 /** Managed child node with its dispose function */
 /**
  * Check if a value is reactive (a getter function that returns a value).
@@ -370,7 +401,7 @@ declare function assign(node: Element, props: Record<string, unknown>, isSVG?: b
  * )
  * ```
  */
-declare function createConditional(condition: () => boolean, renderTrue: () => FictNode, createElementFn: CreateElementFn, renderFalse?: () => FictNode, startOverride?: Comment, endOverride?: Comment): BindingHandle;
+declare function createConditional(condition: () => boolean, renderTrue: () => FictNode, createElementFn: CreateElementFn, renderFalse?: () => FictNode, startOverride?: Comment, endOverride?: Comment, options?: ConditionalBindingOptions): BindingHandle;
 /**
  * Create a show/hide binding that uses CSS display instead of DOM manipulation.
  * More efficient than conditional when the content is expensive to create.
@@ -397,26 +428,4 @@ declare function createShow(el: Element & {
  */
 declare function createPortal(container: ParentNode & Node, render: () => FictNode, createElementFn: CreateElementFn): BindingHandle;
 
-type LifecycleFn = () => void | Cleanup;
-interface CreateRootOptions {
-    inherit?: boolean;
-}
-type ErrorHandler = (err: unknown, info?: ErrorInfo) => boolean | void;
-declare function onMount(fn: LifecycleFn): void;
-declare function onDestroy(fn: LifecycleFn): void;
-declare function onCleanup(fn: Cleanup): void;
-declare function createRoot<T>(fn: () => T, options?: CreateRootOptions): {
-    dispose: () => void;
-    value: T;
-};
-declare function registerErrorHandler(fn: ErrorHandler): void;
-
-/**
- * Effect callback run synchronously; async callbacks are not tracked after the first await.
- * TypeScript will reject `async () => {}` here—split async work or read signals before awaiting.
- */
-type Effect = () => void | Cleanup;
-declare function createEffect(fn: Effect): () => void;
-declare function createRenderEffect(fn: Effect): () => void;
-
-export { delegateEvents as $, bindText as A, type BaseProps as B, type Cleanup as C, type DOMElement as D, type Effect as E, type FictNode as F, bindAttribute as G, bindStyle as H, bindClass as I, setText as J, setAttr as K, setProp as L, setStyle as M, setClass as N, bindEvent as O, type PropsWithChildren as P, callEventHandler as Q, type RefObject as R, type SuspenseToken as S, bindProperty as T, bindRef as U, insert as V, insertBetween as W, createConditional as X, spread as Y, assign as Z, classList as _, createChildBinding as a, clearDelegatedEvents as a0, addEventListener as a1, type MaybeReactive as a2, type BindingHandle as a3, type CreateElementFn as a4, type AttributeSetter as a5, createAttributeBinding as b, createTextBinding as c, createStyleBinding as d, createClassBinding as e, createShow as f, registerErrorHandler as g, createRenderEffect as h, isReactive as i, createEffect as j, onDestroy as k, onCleanup as l, createRoot as m, nonReactive as n, onMount as o, createPortal as p, type FictVNode as q, reactive as r, type Component as s, type Ref as t, unwrap as u, type RefCallback as v, type StyleProp as w, type ClassProp as x, type EventHandler as y, type ErrorInfo as z };
+export { type PropsWithChildren as $, insert as A, type BaseProps as B, insertBetween as C, createConditional as D, createPortal as E, type FictNode as F, spread as G, assign as H, classList as I, delegateEvents as J, clearDelegatedEvents as K, addEventListener as L, type MaybeReactive as M, onDestroy as N, type BindingHandle as O, type CreateElementFn as P, type AttributeSetter as Q, type DOMElement as R, type RefObject as S, type SuspenseToken as T, type Effect as U, onMount as V, onCleanup as W, createRoot as X, type FictVNode as Y, type Cleanup as Z, type Component as _, createChildBinding as a, type Ref as a0, type RefCallback as a1, type StyleProp as a2, type ClassProp as a3, type EventHandler as a4, type ErrorInfo as a5, createAttributeBinding as b, createTextBinding as c, createStyleBinding as d, createClassBinding as e, createShow as f, registerErrorHandler as g, createRenderEffect as h, isReactive as i, createEffect as j, bindText as k, bindAttribute as l, bindStyle as m, nonReactive as n, bindClass as o, setAttr as p, setProp as q, reactive as r, setText as s, setStyle as t, unwrap as u, setClass as v, bindEvent as w, callEventHandler as x, bindProperty as y, bindRef as z };