@fictjs/runtime 0.0.13 → 0.0.15

package/dist/advanced.cjs

@@ -0,0 +1,79 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+
+
+var _chunkGJTYOFMOcjs = require('./chunk-GJTYOFMO.cjs');
+
+
+
+var _chunk624QY53Acjs = require('./chunk-624QY53A.cjs');
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+var _chunkPMF6MWEVcjs = require('./chunk-PMF6MWEV.cjs');
+
+// src/versioned-signal.ts
+function createVersionedSignal(initialValue, options) {
+  const equals = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _ => _.equals]), () => ( Object.is));
+  const value = _chunkPMF6MWEVcjs.signal.call(void 0, initialValue);
+  const version = _chunkPMF6MWEVcjs.signal.call(void 0, 0);
+  const bumpVersion = () => {
+    const next = version() + 1;
+    version(next);
+  };
+  return {
+    read: () => {
+      version();
+      return value();
+    },
+    write: (next) => {
+      const prev = value();
+      if (!equals(prev, next)) {
+        value(next);
+        return;
+      }
+      bumpVersion();
+    },
+    force: () => {
+      bumpVersion();
+    },
+    peekVersion: () => _chunkPMF6MWEVcjs.untrack.call(void 0, () => version()),
+    peekValue: () => _chunkPMF6MWEVcjs.untrack.call(void 0, () => value())
+  };
+}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.createAttributeBinding = _chunkPMF6MWEVcjs.createAttributeBinding; exports.createChildBinding = _chunkPMF6MWEVcjs.createChildBinding; exports.createClassBinding = _chunkPMF6MWEVcjs.createClassBinding; exports.createContext = _chunkGJTYOFMOcjs.createContext; exports.createRenderEffect = _chunkPMF6MWEVcjs.createRenderEffect; exports.createScope = _chunk624QY53Acjs.createScope; exports.createSelector = _chunkPMF6MWEVcjs.createSelector; exports.createShow = _chunkPMF6MWEVcjs.createShow; exports.createSignal = _chunkPMF6MWEVcjs.signal; exports.createStyleBinding = _chunkPMF6MWEVcjs.createStyleBinding; exports.createTextBinding = _chunkPMF6MWEVcjs.createTextBinding; exports.createVersionedSignal = createVersionedSignal; exports.effectScope = _chunkPMF6MWEVcjs.effectScope; exports.getDevtoolsHook = _chunkPMF6MWEVcjs.getDevtoolsHook; exports.hasContext = _chunkGJTYOFMOcjs.hasContext; exports.isReactive = _chunkPMF6MWEVcjs.isReactive; exports.runInScope = _chunk624QY53Acjs.runInScope; exports.setCycleProtectionOptions = _chunkPMF6MWEVcjs.setCycleProtectionOptions; exports.unwrap = _chunkPMF6MWEVcjs.unwrap; exports.useContext = _chunkGJTYOFMOcjs.useContext;
+//# sourceMappingURL=advanced.cjs.map

package/dist/advanced.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/fict/fict/packages/runtime/dist/advanced.cjs","../src/versioned-signal.ts"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACF,wDAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACA;ACHO,SAAS,qBAAA,CACd,YAAA,EACA,OAAA,EACoB;AACpB,EAAA,MAAM,OAAA,mCAAS,OAAA,2BAAS,QAAA,UAAU,MAAA,CAAO,IAAA;AACzC,EAAA,MAAM,MAAA,EAAQ,sCAAA,YAAyB,CAAA;AACvC,EAAA,MAAM,QAAA,EAAU,sCAAA,CAAc,CAAA;AAE9B,EAAA,MAAM,YAAA,EAAc,CAAA,EAAA,GAAM;AACxB,IAAA,MAAM,KAAA,EAAO,OAAA,CAAQ,EAAA,EAAI,CAAA;AACzB,IAAA,OAAA,CAAQ,IAAI,CAAA;AAAA,EACd,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,CAAA,EAAA,GAAM;AAEV,MAAA,OAAA,CAAQ,CAAA;AACR,MAAA,OAAO,KAAA,CAAM,CAAA;AAAA,IACf,CAAA;AAAA,IACA,KAAA,EAAO,CAAC,IAAA,EAAA,GAAY;AAClB,MAAA,MAAM,KAAA,EAAO,KAAA,CAAM,CAAA;AACnB,MAAA,GAAA,CAAI,CAAC,MAAA,CAAO,IAAA,EAAM,IAAI,CAAA,EAAG;AACvB,QAAA,KAAA,CAAM,IAAI,CAAA;AACV,QAAA,MAAA;AAAA,MACF;AACA,MAAA,WAAA,CAAY,CAAA;AAAA,IACd,CAAA;AAAA,IACA,KAAA,EAAO,CAAA,EAAA,GAAM;AACX,MAAA,WAAA,CAAY,CAAA;AAAA,IACd,CAAA;AAAA,IACA,WAAA,EAAa,CAAA,EAAA,GAAM,uCAAA,CAAQ,EAAA,GAAM,OAAA,CAAQ,CAAC,CAAA;AAAA,IAC1C,SAAA,EAAW,CAAA,EAAA,GAAM,uCAAA,CAAQ,EAAA,GAAM,KAAA,CAAM,CAAC;AAAA,EACxC,CAAA;AACF;ADDA;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACF,qpCAAC","file":"/home/runner/work/fict/fict/packages/runtime/dist/advanced.cjs","sourcesContent":[null,"import { createSignal, untrack } from './signal'\n\nexport interface VersionedSignalOptions<T> {\n  equals?: (prev: T, next: T) => boolean\n}\n\nexport interface VersionedSignal<T> {\n  /** Reactive read that tracks both the value and version counter */\n  read: () => T\n  /** Write a new value, forcing a version bump when value is equal */\n  write: (next: T) => void\n  /** Force a version bump without changing the value */\n  force: () => void\n  /** Read the current version without creating a dependency */\n  peekVersion: () => number\n  /** Read the current value without tracking */\n  peekValue: () => T\n}\n\n/**\n * Create a signal wrapper that forces subscribers to update when the same reference is written.\n *\n * Useful for compiler-generated keyed list items where updates may reuse the same object reference.\n */\nexport function createVersionedSignal<T>(\n  initialValue: T,\n  options?: VersionedSignalOptions<T>,\n): VersionedSignal<T> {\n  const equals = options?.equals ?? Object.is\n  const value = createSignal(initialValue)\n  const version = createSignal(0)\n\n  const bumpVersion = () => {\n    const next = version() + 1\n    version(next)\n  }\n\n  return {\n    read: () => {\n      // Track both version and value to ensure equal writes notify subscribers\n      version()\n      return value()\n    },\n    write: (next: T) => {\n      const prev = value()\n      if (!equals(prev, next)) {\n        value(next)\n        return\n      }\n      bumpVersion()\n    },\n    force: () => {\n      bumpVersion()\n    },\n    peekVersion: () => untrack(() => version()),\n    peekValue: () => untrack(() => value()),\n  }\n}\n"]}

package/dist/advanced.d.cts

@@ -0,0 +1,50 @@
+export { R as ReactiveScope, S as Signal, c as createScope, a as createSelector, s as createSignal, e as effectScope, r as runInScope } from './scope-DKYzWfTn.cjs';
+export { b as createAttributeBinding, a as createChildBinding, e as createClassBinding, g as createRenderEffect, f as createShow, d as createStyleBinding, c as createTextBinding, i as isReactive, u as unwrap } from './effect-Auji1rz9.cjs';
+export { C as Context, P as ProviderProps, c as createContext, h as hasContext, u as useContext } from './context-UXySaqI_.cjs';
+
+interface VersionedSignalOptions<T> {
+    equals?: (prev: T, next: T) => boolean;
+}
+interface VersionedSignal<T> {
+    /** Reactive read that tracks both the value and version counter */
+    read: () => T;
+    /** Write a new value, forcing a version bump when value is equal */
+    write: (next: T) => void;
+    /** Force a version bump without changing the value */
+    force: () => void;
+    /** Read the current version without creating a dependency */
+    peekVersion: () => number;
+    /** Read the current value without tracking */
+    peekValue: () => T;
+}
+/**
+ * Create a signal wrapper that forces subscribers to update when the same reference is written.
+ *
+ * Useful for compiler-generated keyed list items where updates may reuse the same object reference.
+ */
+declare function createVersionedSignal<T>(initialValue: T, options?: VersionedSignalOptions<T>): VersionedSignal<T>;
+
+interface FictDevtoolsHook {
+    registerSignal: (id: number, value: unknown) => void;
+    updateSignal: (id: number, value: unknown) => void;
+    registerEffect: (id: number) => void;
+    effectRun: (id: number) => void;
+    cycleDetected?: (payload: {
+        reason: string;
+        detail?: Record<string, unknown>;
+    }) => void;
+}
+declare function getDevtoolsHook(): FictDevtoolsHook | undefined;
+
+interface CycleProtectionOptions {
+    maxFlushCyclesPerMicrotask?: number;
+    maxEffectRunsPerFlush?: number;
+    windowSize?: number;
+    highUsageRatio?: number;
+    maxRootReentrantDepth?: number;
+    enableWindowWarning?: boolean;
+    devMode?: boolean;
+}
+declare let setCycleProtectionOptions: (opts: CycleProtectionOptions) => void;
+
+export { type FictDevtoolsHook, type VersionedSignal, type VersionedSignalOptions, createVersionedSignal, getDevtoolsHook, setCycleProtectionOptions };

package/dist/advanced.d.ts

@@ -0,0 +1,50 @@
+export { R as ReactiveScope, S as Signal, c as createScope, a as createSelector, s as createSignal, e as effectScope, r as runInScope } from './scope-S6eAzBJZ.js';
+export { b as createAttributeBinding, a as createChildBinding, e as createClassBinding, g as createRenderEffect, f as createShow, d as createStyleBinding, c as createTextBinding, i as isReactive, u as unwrap } from './effect-Auji1rz9.js';
+export { C as Context, P as ProviderProps, c as createContext, h as hasContext, u as useContext } from './context-B7UYnfzM.js';
+
+interface VersionedSignalOptions<T> {
+    equals?: (prev: T, next: T) => boolean;
+}
+interface VersionedSignal<T> {
+    /** Reactive read that tracks both the value and version counter */
+    read: () => T;
+    /** Write a new value, forcing a version bump when value is equal */
+    write: (next: T) => void;
+    /** Force a version bump without changing the value */
+    force: () => void;
+    /** Read the current version without creating a dependency */
+    peekVersion: () => number;
+    /** Read the current value without tracking */
+    peekValue: () => T;
+}
+/**
+ * Create a signal wrapper that forces subscribers to update when the same reference is written.
+ *
+ * Useful for compiler-generated keyed list items where updates may reuse the same object reference.
+ */
+declare function createVersionedSignal<T>(initialValue: T, options?: VersionedSignalOptions<T>): VersionedSignal<T>;
+
+interface FictDevtoolsHook {
+    registerSignal: (id: number, value: unknown) => void;
+    updateSignal: (id: number, value: unknown) => void;
+    registerEffect: (id: number) => void;
+    effectRun: (id: number) => void;
+    cycleDetected?: (payload: {
+        reason: string;
+        detail?: Record<string, unknown>;
+    }) => void;
+}
+declare function getDevtoolsHook(): FictDevtoolsHook | undefined;
+
+interface CycleProtectionOptions {
+    maxFlushCyclesPerMicrotask?: number;
+    maxEffectRunsPerFlush?: number;
+    windowSize?: number;
+    highUsageRatio?: number;
+    maxRootReentrantDepth?: number;
+    enableWindowWarning?: boolean;
+    devMode?: boolean;
+}
+declare let setCycleProtectionOptions: (opts: CycleProtectionOptions) => void;
+
+export { type FictDevtoolsHook, type VersionedSignal, type VersionedSignalOptions, createVersionedSignal, getDevtoolsHook, setCycleProtectionOptions };

package/dist/advanced.js

@@ -0,0 +1,79 @@
+import {
+  createContext,
+  hasContext,
+  useContext
+} from "./chunk-IUZXKAAY.js";
+import {
+  createScope,
+  runInScope
+} from "./chunk-F3AIYQB7.js";
+import {
+  createAttributeBinding,
+  createChildBinding,
+  createClassBinding,
+  createRenderEffect,
+  createSelector,
+  createShow,
+  createStyleBinding,
+  createTextBinding,
+  effectScope,
+  getDevtoolsHook,
+  isReactive,
+  setCycleProtectionOptions,
+  signal,
+  untrack,
+  unwrap
+} from "./chunk-RY4WDS6R.js";
+
+// src/versioned-signal.ts
+function createVersionedSignal(initialValue, options) {
+  const equals = options?.equals ?? Object.is;
+  const value = signal(initialValue);
+  const version = signal(0);
+  const bumpVersion = () => {
+    const next = version() + 1;
+    version(next);
+  };
+  return {
+    read: () => {
+      version();
+      return value();
+    },
+    write: (next) => {
+      const prev = value();
+      if (!equals(prev, next)) {
+        value(next);
+        return;
+      }
+      bumpVersion();
+    },
+    force: () => {
+      bumpVersion();
+    },
+    peekVersion: () => untrack(() => version()),
+    peekValue: () => untrack(() => value())
+  };
+}
+export {
+  createAttributeBinding,
+  createChildBinding,
+  createClassBinding,
+  createContext,
+  createRenderEffect,
+  createScope,
+  createSelector,
+  createShow,
+  signal as createSignal,
+  createStyleBinding,
+  createTextBinding,
+  createVersionedSignal,
+  effectScope,
+  getDevtoolsHook,
+  hasContext,
+  isReactive,
+  runInScope,
+  setCycleProtectionOptions,
+  unwrap,
+  useContext
+};
+//# sourceMappingURL=advanced.js.map

package/dist/advanced.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/versioned-signal.ts"],"sourcesContent":["import { createSignal, untrack } from './signal'\n\nexport interface VersionedSignalOptions<T> {\n  equals?: (prev: T, next: T) => boolean\n}\n\nexport interface VersionedSignal<T> {\n  /** Reactive read that tracks both the value and version counter */\n  read: () => T\n  /** Write a new value, forcing a version bump when value is equal */\n  write: (next: T) => void\n  /** Force a version bump without changing the value */\n  force: () => void\n  /** Read the current version without creating a dependency */\n  peekVersion: () => number\n  /** Read the current value without tracking */\n  peekValue: () => T\n}\n\n/**\n * Create a signal wrapper that forces subscribers to update when the same reference is written.\n *\n * Useful for compiler-generated keyed list items where updates may reuse the same object reference.\n */\nexport function createVersionedSignal<T>(\n  initialValue: T,\n  options?: VersionedSignalOptions<T>,\n): VersionedSignal<T> {\n  const equals = options?.equals ?? Object.is\n  const value = createSignal(initialValue)\n  const version = createSignal(0)\n\n  const bumpVersion = () => {\n    const next = version() + 1\n    version(next)\n  }\n\n  return {\n    read: () => {\n      // Track both version and value to ensure equal writes notify subscribers\n      version()\n      return value()\n    },\n    write: (next: T) => {\n      const prev = value()\n      if (!equals(prev, next)) {\n        value(next)\n        return\n      }\n      bumpVersion()\n    },\n    force: () => {\n      bumpVersion()\n    },\n    peekVersion: () => untrack(() => version()),\n    peekValue: () => untrack(() => value()),\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwBO,SAAS,sBACd,cACA,SACoB;AACpB,QAAM,SAAS,SAAS,UAAU,OAAO;AACzC,QAAM,QAAQ,OAAa,YAAY;AACvC,QAAM,UAAU,OAAa,CAAC;AAE9B,QAAM,cAAc,MAAM;AACxB,UAAM,OAAO,QAAQ,IAAI;AACzB,YAAQ,IAAI;AAAA,EACd;AAEA,SAAO;AAAA,IACL,MAAM,MAAM;AAEV,cAAQ;AACR,aAAO,MAAM;AAAA,IACf;AAAA,IACA,OAAO,CAAC,SAAY;AAClB,YAAM,OAAO,MAAM;AACnB,UAAI,CAAC,OAAO,MAAM,IAAI,GAAG;AACvB,cAAM,IAAI;AACV;AAAA,MACF;AACA,kBAAY;AAAA,IACd;AAAA,IACA,OAAO,MAAM;AACX,kBAAY;AAAA,IACd;AAAA,IACA,aAAa,MAAM,QAAQ,MAAM,QAAQ,CAAC;AAAA,IAC1C,WAAW,MAAM,QAAQ,MAAM,MAAM,CAAC;AAAA,EACxC;AACF;","names":[]}

package/dist/chunk-624QY53A.cjs

@@ -0,0 +1,45 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+var _chunkPMF6MWEVcjs = require('./chunk-PMF6MWEV.cjs');
+
+// src/scope.ts
+function createScope() {
+  let dispose = null;
+  const stop = () => {
+    if (dispose) {
+      dispose();
+      dispose = null;
+    }
+  };
+  const run = (fn) => {
+    stop();
+    const { dispose: rootDispose, value } = _chunkPMF6MWEVcjs.createRoot.call(void 0, fn);
+    dispose = rootDispose;
+    return value;
+  };
+  _chunkPMF6MWEVcjs.registerRootCleanup.call(void 0, stop);
+  return { run, stop };
+}
+function runInScope(flag, fn) {
+  const scope = createScope();
+  const evaluate = () => _chunkPMF6MWEVcjs.isReactive.call(void 0, flag) ? flag() : !!flag;
+  _chunkPMF6MWEVcjs.createEffect.call(void 0, () => {
+    const enabled = evaluate();
+    if (enabled) {
+      scope.run(fn);
+    } else {
+      scope.stop();
+    }
+  });
+  _chunkPMF6MWEVcjs.onCleanup.call(void 0, scope.stop);
+}
+
+
+
+
+exports.createScope = createScope; exports.runInScope = runInScope;
+//# sourceMappingURL=chunk-624QY53A.cjs.map

package/dist/chunk-624QY53A.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/fict/fict/packages/runtime/dist/chunk-624QY53A.cjs","../src/scope.ts"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACA;ACOO,SAAS,WAAA,CAAA,EAA6B;AAC3C,EAAA,IAAI,QAAA,EAA+B,IAAA;AAEnC,EAAA,MAAM,KAAA,EAAO,CAAA,EAAA,GAAM;AACjB,IAAA,GAAA,CAAI,OAAA,EAAS;AACX,MAAA,OAAA,CAAQ,CAAA;AACR,MAAA,QAAA,EAAU,IAAA;AAAA,IACZ;AAAA,EACF,CAAA;AAEA,EAAA,MAAM,IAAA,EAAM,CAAI,EAAA,EAAA,GAAmB;AACjC,IAAA,IAAA,CAAK,CAAA;AACL,IAAA,MAAM,EAAE,OAAA,EAAS,WAAA,EAAa,MAAM,EAAA,EAAI,0CAAA,EAAa,CAAA;AACrD,IAAA,QAAA,EAAU,WAAA;AACV,IAAA,OAAO,KAAA;AAAA,EACT,CAAA;AAEA,EAAA,mDAAA,IAAwB,CAAA;AACxB,EAAA,OAAO,EAAE,GAAA,EAAK,KAAK,CAAA;AACrB;AAMO,SAAS,UAAA,CAAW,IAAA,EAA8B,EAAA,EAAsB;AAC7E,EAAA,MAAM,MAAA,EAAQ,WAAA,CAAY,CAAA;AAC1B,EAAA,MAAM,SAAA,EAAW,CAAA,EAAA,GAAO,0CAAA,IAAe,EAAA,EAAK,IAAA,CAAuB,EAAA,EAAI,CAAC,CAAC,IAAA;AAEzE,EAAA,4CAAA,CAAa,EAAA,GAAM;AACjB,IAAA,MAAM,QAAA,EAAU,QAAA,CAAS,CAAA;AACzB,IAAA,GAAA,CAAI,OAAA,EAAS;AACX,MAAA,KAAA,CAAM,GAAA,CAAI,EAAE,CAAA;AAAA,IACd,EAAA,KAAO;AACL,MAAA,KAAA,CAAM,IAAA,CAAK,CAAA;AAAA,IACb;AAAA,EACF,CAAC,CAAA;AAED,EAAA,yCAAA,KAAU,CAAM,IAAI,CAAA;AACtB;ADfA;AACA;AACE;AACA;AACF,mEAAC","file":"/home/runner/work/fict/fict/packages/runtime/dist/chunk-624QY53A.cjs","sourcesContent":[null,"import { isReactive, type MaybeReactive } from './binding'\nimport { createEffect } from './effect'\nimport { createRoot, onCleanup, registerRootCleanup } from './lifecycle'\n\nexport { effectScope } from './signal'\n\nexport interface ReactiveScope {\n  run<T>(fn: () => T): T\n  stop(): void\n}\n\n/**\n * Create an explicit reactive scope that can contain effects/memos and be stopped manually.\n * The scope registers with the current root for cleanup.\n */\nexport function createScope(): ReactiveScope {\n  let dispose: (() => void) | null = null\n\n  const stop = () => {\n    if (dispose) {\n      dispose()\n      dispose = null\n    }\n  }\n\n  const run = <T>(fn: () => T): T => {\n    stop()\n    const { dispose: rootDispose, value } = createRoot(fn)\n    dispose = rootDispose\n    return value\n  }\n\n  registerRootCleanup(stop)\n  return { run, stop }\n}\n\n/**\n * Run a block of reactive code inside a managed scope that follows a boolean flag.\n * When the flag turns false, the scope is disposed and all contained effects/memos are cleaned up.\n */\nexport function runInScope(flag: MaybeReactive<boolean>, fn: () => void): void {\n  const scope = createScope()\n  const evaluate = () => (isReactive(flag) ? (flag as () => boolean)() : !!flag)\n\n  createEffect(() => {\n    const enabled = evaluate()\n    if (enabled) {\n      scope.run(fn)\n    } else {\n      scope.stop()\n    }\n  })\n\n  onCleanup(scope.stop)\n}\n"]}

package/dist/chunk-F3AIYQB7.js

@@ -0,0 +1,45 @@
+import {
+  createEffect,
+  createRoot,
+  isReactive,
+  onCleanup,
+  registerRootCleanup
+} from "./chunk-RY4WDS6R.js";
+
+// 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);
+}
+
+export {
+  createScope,
+  runInScope
+};
+//# sourceMappingURL=chunk-F3AIYQB7.js.map

package/dist/chunk-F3AIYQB7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/scope.ts"],"sourcesContent":["import { isReactive, type MaybeReactive } from './binding'\nimport { createEffect } from './effect'\nimport { createRoot, onCleanup, registerRootCleanup } from './lifecycle'\n\nexport { effectScope } from './signal'\n\nexport interface ReactiveScope {\n  run<T>(fn: () => T): T\n  stop(): void\n}\n\n/**\n * Create an explicit reactive scope that can contain effects/memos and be stopped manually.\n * The scope registers with the current root for cleanup.\n */\nexport function createScope(): ReactiveScope {\n  let dispose: (() => void) | null = null\n\n  const stop = () => {\n    if (dispose) {\n      dispose()\n      dispose = null\n    }\n  }\n\n  const run = <T>(fn: () => T): T => {\n    stop()\n    const { dispose: rootDispose, value } = createRoot(fn)\n    dispose = rootDispose\n    return value\n  }\n\n  registerRootCleanup(stop)\n  return { run, stop }\n}\n\n/**\n * Run a block of reactive code inside a managed scope that follows a boolean flag.\n * When the flag turns false, the scope is disposed and all contained effects/memos are cleaned up.\n */\nexport function runInScope(flag: MaybeReactive<boolean>, fn: () => void): void {\n  const scope = createScope()\n  const evaluate = () => (isReactive(flag) ? (flag as () => boolean)() : !!flag)\n\n  createEffect(() => {\n    const enabled = evaluate()\n    if (enabled) {\n      scope.run(fn)\n    } else {\n      scope.stop()\n    }\n  })\n\n  onCleanup(scope.stop)\n}\n"],"mappings":";;;;;;;;;AAeO,SAAS,cAA6B;AAC3C,MAAI,UAA+B;AAEnC,QAAM,OAAO,MAAM;AACjB,QAAI,SAAS;AACX,cAAQ;AACR,gBAAU;AAAA,IACZ;AAAA,EACF;AAEA,QAAM,MAAM,CAAI,OAAmB;AACjC,SAAK;AACL,UAAM,EAAE,SAAS,aAAa,MAAM,IAAI,WAAW,EAAE;AACrD,cAAU;AACV,WAAO;AAAA,EACT;AAEA,sBAAoB,IAAI;AACxB,SAAO,EAAE,KAAK,KAAK;AACrB;AAMO,SAAS,WAAW,MAA8B,IAAsB;AAC7E,QAAM,QAAQ,YAAY;AAC1B,QAAM,WAAW,MAAO,WAAW,IAAI,IAAK,KAAuB,IAAI,CAAC,CAAC;AAEzE,eAAa,MAAM;AACjB,UAAM,UAAU,SAAS;AACzB,QAAI,SAAS;AACX,YAAM,IAAI,EAAE;AAAA,IACd,OAAO;AACL,YAAM,KAAK;AAAA,IACb;AAAA,EACF,CAAC;AAED,YAAU,MAAM,IAAI;AACtB;","names":[]}

package/dist/chunk-GJTYOFMO.cjs

@@ -0,0 +1,109 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+
+
+
+
+
+
+var _chunkPMF6MWEVcjs = require('./chunk-PMF6MWEV.cjs');
+
+// src/context.ts
+var contextStorage = /* @__PURE__ */ new WeakMap();
+function getContextMap(root) {
+  let map = contextStorage.get(root);
+  if (!map) {
+    map = /* @__PURE__ */ new Map();
+    contextStorage.set(root, map);
+  }
+  return map;
+}
+function createContext(defaultValue) {
+  const id = Symbol("fict.context");
+  const context = {
+    id,
+    defaultValue,
+    Provider: null
+  };
+  context.Provider = function Provider(props) {
+    const hostRoot = _chunkPMF6MWEVcjs.getCurrentRoot.call(void 0, );
+    const providerRoot = _chunkPMF6MWEVcjs.createRootContext.call(void 0, hostRoot);
+    const contextMap = getContextMap(providerRoot);
+    contextMap.set(id, props.value);
+    const fragment = document.createDocumentFragment();
+    const marker = document.createComment("fict:ctx");
+    fragment.appendChild(marker);
+    let cleanup;
+    let activeNodes = [];
+    const renderChildren = (children) => {
+      if (cleanup) {
+        cleanup();
+        cleanup = void 0;
+      }
+      if (activeNodes.length) {
+        _chunkPMF6MWEVcjs.removeNodes.call(void 0, activeNodes);
+        activeNodes = [];
+      }
+      if (children == null || children === false) {
+        return;
+      }
+      const prev = _chunkPMF6MWEVcjs.pushRoot.call(void 0, providerRoot);
+      let nodes = [];
+      try {
+        const output = _chunkPMF6MWEVcjs.createElement.call(void 0, children);
+        nodes = _chunkPMF6MWEVcjs.toNodeArray.call(void 0, output);
+        const parentNode = marker.parentNode;
+        if (parentNode) {
+          _chunkPMF6MWEVcjs.insertNodesBefore.call(void 0, parentNode, nodes, marker);
+        }
+      } finally {
+        _chunkPMF6MWEVcjs.popRoot.call(void 0, prev);
+        _chunkPMF6MWEVcjs.flushOnMount.call(void 0, providerRoot);
+      }
+      cleanup = () => {
+        _chunkPMF6MWEVcjs.destroyRoot.call(void 0, providerRoot);
+        _chunkPMF6MWEVcjs.removeNodes.call(void 0, nodes);
+      };
+      activeNodes = nodes;
+    };
+    _chunkPMF6MWEVcjs.createRenderEffect.call(void 0, () => {
+      contextMap.set(id, props.value);
+      renderChildren(props.children);
+    });
+    return fragment;
+  };
+  return context;
+}
+function useContext(context) {
+  let root = _chunkPMF6MWEVcjs.getCurrentRoot.call(void 0, );
+  while (root) {
+    const contextMap = contextStorage.get(root);
+    if (contextMap && contextMap.has(context.id)) {
+      return contextMap.get(context.id);
+    }
+    root = root.parent;
+  }
+  return context.defaultValue;
+}
+function hasContext(context) {
+  let root = _chunkPMF6MWEVcjs.getCurrentRoot.call(void 0, );
+  while (root) {
+    const contextMap = contextStorage.get(root);
+    if (contextMap && contextMap.has(context.id)) {
+      return true;
+    }
+    root = root.parent;
+  }
+  return false;
+}
+
+
+
+
+
+exports.createContext = createContext; exports.useContext = useContext; exports.hasContext = hasContext;
+//# sourceMappingURL=chunk-GJTYOFMO.cjs.map

package/dist/chunk-GJTYOFMO.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/fict/fict/packages/runtime/dist/chunk-GJTYOFMO.cjs","../src/context.ts"],"names":[],"mappings":"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","file":"/home/runner/work/fict/fict/packages/runtime/dist/chunk-GJTYOFMO.cjs","sourcesContent":[null,"/**\n * @fileoverview Context API for Fict\n *\n * Provides a way to pass data through the component tree without having to pass\n * props down manually at every level. Context is designed for:\n *\n * - SSR isolation (different request = different context values)\n * - Multi-instance support (multiple app roots with different values)\n * - Subtree scoping (override values in specific parts of the tree)\n *\n * ## Design Principles\n *\n * 1. **Reuses existing RootContext hierarchy** - Uses parent chain for value lookup,\n *    consistent with handleError/handleSuspend mechanisms.\n *\n * 2. **Zero extra root creation overhead** - Provider doesn't create new root,\n *    only mounts value on current root.\n *\n * 3. **Auto-aligned with insert/suspense boundaries** - Because they create child\n *    roots that inherit parent, context values propagate correctly.\n *\n * ## Usage\n *\n * ```tsx\n * // Create context with default value\n * const ThemeContext = createContext<'light' | 'dark'>('light')\n *\n * // Provide value to subtree\n * function App() {\n *   return (\n *     <ThemeContext.Provider value=\"dark\">\n *       <ThemedComponent />\n *     </ThemeContext.Provider>\n *   )\n * }\n *\n * // Consume value\n * function ThemedComponent() {\n *   const theme = useContext(ThemeContext)\n *   return <div class={theme}>...</div>\n * }\n * ```\n *\n * @module\n */\n\nimport { createElement } from './dom'\nimport {\n  createRootContext,\n  destroyRoot,\n  flushOnMount,\n  getCurrentRoot,\n  popRoot,\n  pushRoot,\n  type RootContext,\n} from './lifecycle'\nimport { insertNodesBefore, removeNodes, toNodeArray } from './node-ops'\nimport { createRenderEffect } from './effect'\nimport type { BaseProps, FictNode } from './types'\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Context object created by createContext.\n * Contains the Provider component and serves as a key for context lookup.\n */\nexport interface Context<T> {\n  /** Unique identifier for this context */\n  readonly id: symbol\n  /** Default value when no provider is found */\n  readonly defaultValue: T\n  /** Provider component for supplying context values */\n  Provider: ContextProvider<T>\n  /** Display name for debugging */\n  displayName?: string\n}\n\n/**\n * Props for the Context Provider component\n */\nexport interface ProviderProps<T> extends BaseProps {\n  /** The value to provide to the subtree */\n  value: T\n}\n\n/**\n * Provider component type\n */\nexport type ContextProvider<T> = (props: ProviderProps<T>) => FictNode\n\n// ============================================================================\n// Internal Context Storage\n// ============================================================================\n\n/**\n * WeakMap to store context values per RootContext.\n * Using WeakMap ensures proper garbage collection when roots are destroyed.\n */\nconst contextStorage = new WeakMap<RootContext, Map<symbol, unknown>>()\n\n/**\n * Get the context map for a root, creating it if needed\n */\nfunction getContextMap(root: RootContext): Map<symbol, unknown> {\n  let map = contextStorage.get(root)\n  if (!map) {\n    map = new Map()\n    contextStorage.set(root, map)\n  }\n  return map\n}\n\n// ============================================================================\n// Context API\n// ============================================================================\n\n/**\n * Creates a new context with the given default value.\n *\n * Context provides a way to pass values through the component tree without\n * explicit props drilling. It's especially useful for:\n *\n * - Theme data\n * - Locale/i18n settings\n * - Authentication state\n * - Feature flags\n * - Any data that many components at different nesting levels need\n *\n * @param defaultValue - The value to use when no Provider is found above in the tree\n * @returns A context object with a Provider component\n *\n * @example\n * ```tsx\n * // Create a theme context\n * const ThemeContext = createContext<'light' | 'dark'>('light')\n *\n * // Use the provider\n * function App() {\n *   return (\n *     <ThemeContext.Provider value=\"dark\">\n *       <Content />\n *     </ThemeContext.Provider>\n *   )\n * }\n *\n * // Consume the context\n * function Content() {\n *   const theme = useContext(ThemeContext)\n *   return <div class={`theme-${theme}`}>Hello</div>\n * }\n * ```\n */\nexport function createContext<T>(defaultValue: T): Context<T> {\n  const id = Symbol('fict.context')\n\n  const context: Context<T> = {\n    id,\n    defaultValue,\n    Provider: null as unknown as ContextProvider<T>,\n  }\n\n  // Create the Provider component\n  context.Provider = function Provider(props: ProviderProps<T>): FictNode {\n    const hostRoot = getCurrentRoot()\n\n    // Create a child root for the provider's subtree\n    // This establishes the provider boundary - children will look up from here\n    const providerRoot = createRootContext(hostRoot)\n\n    // Store the context value on this root\n    const contextMap = getContextMap(providerRoot)\n    contextMap.set(id, props.value)\n\n    // Create DOM structure\n    const fragment = document.createDocumentFragment()\n    const marker = document.createComment('fict:ctx')\n    fragment.appendChild(marker)\n\n    let cleanup: (() => void) | undefined\n    let activeNodes: Node[] = []\n\n    const renderChildren = (children: FictNode) => {\n      // Cleanup previous render\n      if (cleanup) {\n        cleanup()\n        cleanup = undefined\n      }\n      if (activeNodes.length) {\n        removeNodes(activeNodes)\n        activeNodes = []\n      }\n\n      if (children == null || children === false) {\n        return\n      }\n\n      const prev = pushRoot(providerRoot)\n      let nodes: Node[] = []\n      try {\n        const output = createElement(children)\n        nodes = toNodeArray(output)\n        const parentNode = marker.parentNode as (ParentNode & Node) | null\n        if (parentNode) {\n          insertNodesBefore(parentNode, nodes, marker)\n        }\n      } finally {\n        popRoot(prev)\n        flushOnMount(providerRoot)\n      }\n\n      cleanup = () => {\n        destroyRoot(providerRoot)\n        removeNodes(nodes)\n      }\n      activeNodes = nodes\n    }\n\n    // Initial render\n    createRenderEffect(() => {\n      // Update context value on re-render (if value prop changes reactively)\n      contextMap.set(id, props.value)\n      renderChildren(props.children)\n    })\n\n    return fragment\n  }\n\n  return context\n}\n\n/**\n * Reads the current value of a context.\n *\n * useContext looks up through the RootContext parent chain to find the\n * nearest Provider for this context. If no Provider is found, returns\n * the context's default value.\n *\n * @param context - The context object created by createContext\n * @returns The current context value\n *\n * @example\n * ```tsx\n * const ThemeContext = createContext('light')\n *\n * function ThemedButton() {\n *   const theme = useContext(ThemeContext)\n *   return <button class={theme === 'dark' ? 'btn-dark' : 'btn-light'}>Click</button>\n * }\n * ```\n */\nexport function useContext<T>(context: Context<T>): T {\n  let root = getCurrentRoot()\n\n  // Walk up the parent chain looking for the context value\n  while (root) {\n    const contextMap = contextStorage.get(root)\n    if (contextMap && contextMap.has(context.id)) {\n      return contextMap.get(context.id) as T\n    }\n    root = root.parent\n  }\n\n  // No provider found, return default value\n  return context.defaultValue\n}\n\n/**\n * Checks if a context value is currently provided in the tree.\n *\n * Useful for conditional behavior when a provider may or may not exist.\n *\n * @param context - The context object to check\n * @returns true if a Provider exists above in the tree\n *\n * @example\n * ```tsx\n * function OptionalTheme() {\n *   if (hasContext(ThemeContext)) {\n *     const theme = useContext(ThemeContext)\n *     return <div class={theme}>Themed content</div>\n *   }\n *   return <div>Default content</div>\n * }\n * ```\n */\nexport function hasContext<T>(context: Context<T>): boolean {\n  let root = getCurrentRoot()\n\n  while (root) {\n    const contextMap = contextStorage.get(root)\n    if (contextMap && contextMap.has(context.id)) {\n      return true\n    }\n    root = root.parent\n  }\n\n  return false\n}\n"]}

package/dist/chunk-IUZXKAAY.js

@@ -0,0 +1,109 @@
+import {
+  createElement,
+  createRenderEffect,
+  createRootContext,
+  destroyRoot,
+  flushOnMount,
+  getCurrentRoot,
+  insertNodesBefore,
+  popRoot,
+  pushRoot,
+  removeNodes,
+  toNodeArray
+} from "./chunk-RY4WDS6R.js";
+
+// src/context.ts
+var contextStorage = /* @__PURE__ */ new WeakMap();
+function getContextMap(root) {
+  let map = contextStorage.get(root);
+  if (!map) {
+    map = /* @__PURE__ */ new Map();
+    contextStorage.set(root, map);
+  }
+  return map;
+}
+function createContext(defaultValue) {
+  const id = Symbol("fict.context");
+  const context = {
+    id,
+    defaultValue,
+    Provider: null
+  };
+  context.Provider = function Provider(props) {
+    const hostRoot = getCurrentRoot();
+    const providerRoot = createRootContext(hostRoot);
+    const contextMap = getContextMap(providerRoot);
+    contextMap.set(id, props.value);
+    const fragment = document.createDocumentFragment();
+    const marker = document.createComment("fict:ctx");
+    fragment.appendChild(marker);
+    let cleanup;
+    let activeNodes = [];
+    const renderChildren = (children) => {
+      if (cleanup) {
+        cleanup();
+        cleanup = void 0;
+      }
+      if (activeNodes.length) {
+        removeNodes(activeNodes);
+        activeNodes = [];
+      }
+      if (children == null || children === false) {
+        return;
+      }
+      const prev = pushRoot(providerRoot);
+      let nodes = [];
+      try {
+        const output = createElement(children);
+        nodes = toNodeArray(output);
+        const parentNode = marker.parentNode;
+        if (parentNode) {
+          insertNodesBefore(parentNode, nodes, marker);
+        }
+      } finally {
+        popRoot(prev);
+        flushOnMount(providerRoot);
+      }
+      cleanup = () => {
+        destroyRoot(providerRoot);
+        removeNodes(nodes);
+      };
+      activeNodes = nodes;
+    };
+    createRenderEffect(() => {
+      contextMap.set(id, props.value);
+      renderChildren(props.children);
+    });
+    return fragment;
+  };
+  return context;
+}
+function useContext(context) {
+  let root = getCurrentRoot();
+  while (root) {
+    const contextMap = contextStorage.get(root);
+    if (contextMap && contextMap.has(context.id)) {
+      return contextMap.get(context.id);
+    }
+    root = root.parent;
+  }
+  return context.defaultValue;
+}
+function hasContext(context) {
+  let root = getCurrentRoot();
+  while (root) {
+    const contextMap = contextStorage.get(root);
+    if (contextMap && contextMap.has(context.id)) {
+      return true;
+    }
+    root = root.parent;
+  }
+  return false;
+}
+
+export {
+  createContext,
+  useContext,
+  hasContext
+};
+//# sourceMappingURL=chunk-IUZXKAAY.js.map

package/dist/chunk-IUZXKAAY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/context.ts"],"sourcesContent":["/**\n * @fileoverview Context API for Fict\n *\n * Provides a way to pass data through the component tree without having to pass\n * props down manually at every level. Context is designed for:\n *\n * - SSR isolation (different request = different context values)\n * - Multi-instance support (multiple app roots with different values)\n * - Subtree scoping (override values in specific parts of the tree)\n *\n * ## Design Principles\n *\n * 1. **Reuses existing RootContext hierarchy** - Uses parent chain for value lookup,\n *    consistent with handleError/handleSuspend mechanisms.\n *\n * 2. **Zero extra root creation overhead** - Provider doesn't create new root,\n *    only mounts value on current root.\n *\n * 3. **Auto-aligned with insert/suspense boundaries** - Because they create child\n *    roots that inherit parent, context values propagate correctly.\n *\n * ## Usage\n *\n * ```tsx\n * // Create context with default value\n * const ThemeContext = createContext<'light' | 'dark'>('light')\n *\n * // Provide value to subtree\n * function App() {\n *   return (\n *     <ThemeContext.Provider value=\"dark\">\n *       <ThemedComponent />\n *     </ThemeContext.Provider>\n *   )\n * }\n *\n * // Consume value\n * function ThemedComponent() {\n *   const theme = useContext(ThemeContext)\n *   return <div class={theme}>...</div>\n * }\n * ```\n *\n * @module\n */\n\nimport { createElement } from './dom'\nimport {\n  createRootContext,\n  destroyRoot,\n  flushOnMount,\n  getCurrentRoot,\n  popRoot,\n  pushRoot,\n  type RootContext,\n} from './lifecycle'\nimport { insertNodesBefore, removeNodes, toNodeArray } from './node-ops'\nimport { createRenderEffect } from './effect'\nimport type { BaseProps, FictNode } from './types'\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Context object created by createContext.\n * Contains the Provider component and serves as a key for context lookup.\n */\nexport interface Context<T> {\n  /** Unique identifier for this context */\n  readonly id: symbol\n  /** Default value when no provider is found */\n  readonly defaultValue: T\n  /** Provider component for supplying context values */\n  Provider: ContextProvider<T>\n  /** Display name for debugging */\n  displayName?: string\n}\n\n/**\n * Props for the Context Provider component\n */\nexport interface ProviderProps<T> extends BaseProps {\n  /** The value to provide to the subtree */\n  value: T\n}\n\n/**\n * Provider component type\n */\nexport type ContextProvider<T> = (props: ProviderProps<T>) => FictNode\n\n// ============================================================================\n// Internal Context Storage\n// ============================================================================\n\n/**\n * WeakMap to store context values per RootContext.\n * Using WeakMap ensures proper garbage collection when roots are destroyed.\n */\nconst contextStorage = new WeakMap<RootContext, Map<symbol, unknown>>()\n\n/**\n * Get the context map for a root, creating it if needed\n */\nfunction getContextMap(root: RootContext): Map<symbol, unknown> {\n  let map = contextStorage.get(root)\n  if (!map) {\n    map = new Map()\n    contextStorage.set(root, map)\n  }\n  return map\n}\n\n// ============================================================================\n// Context API\n// ============================================================================\n\n/**\n * Creates a new context with the given default value.\n *\n * Context provides a way to pass values through the component tree without\n * explicit props drilling. It's especially useful for:\n *\n * - Theme data\n * - Locale/i18n settings\n * - Authentication state\n * - Feature flags\n * - Any data that many components at different nesting levels need\n *\n * @param defaultValue - The value to use when no Provider is found above in the tree\n * @returns A context object with a Provider component\n *\n * @example\n * ```tsx\n * // Create a theme context\n * const ThemeContext = createContext<'light' | 'dark'>('light')\n *\n * // Use the provider\n * function App() {\n *   return (\n *     <ThemeContext.Provider value=\"dark\">\n *       <Content />\n *     </ThemeContext.Provider>\n *   )\n * }\n *\n * // Consume the context\n * function Content() {\n *   const theme = useContext(ThemeContext)\n *   return <div class={`theme-${theme}`}>Hello</div>\n * }\n * ```\n */\nexport function createContext<T>(defaultValue: T): Context<T> {\n  const id = Symbol('fict.context')\n\n  const context: Context<T> = {\n    id,\n    defaultValue,\n    Provider: null as unknown as ContextProvider<T>,\n  }\n\n  // Create the Provider component\n  context.Provider = function Provider(props: ProviderProps<T>): FictNode {\n    const hostRoot = getCurrentRoot()\n\n    // Create a child root for the provider's subtree\n    // This establishes the provider boundary - children will look up from here\n    const providerRoot = createRootContext(hostRoot)\n\n    // Store the context value on this root\n    const contextMap = getContextMap(providerRoot)\n    contextMap.set(id, props.value)\n\n    // Create DOM structure\n    const fragment = document.createDocumentFragment()\n    const marker = document.createComment('fict:ctx')\n    fragment.appendChild(marker)\n\n    let cleanup: (() => void) | undefined\n    let activeNodes: Node[] = []\n\n    const renderChildren = (children: FictNode) => {\n      // Cleanup previous render\n      if (cleanup) {\n        cleanup()\n        cleanup = undefined\n      }\n      if (activeNodes.length) {\n        removeNodes(activeNodes)\n        activeNodes = []\n      }\n\n      if (children == null || children === false) {\n        return\n      }\n\n      const prev = pushRoot(providerRoot)\n      let nodes: Node[] = []\n      try {\n        const output = createElement(children)\n        nodes = toNodeArray(output)\n        const parentNode = marker.parentNode as (ParentNode & Node) | null\n        if (parentNode) {\n          insertNodesBefore(parentNode, nodes, marker)\n        }\n      } finally {\n        popRoot(prev)\n        flushOnMount(providerRoot)\n      }\n\n      cleanup = () => {\n        destroyRoot(providerRoot)\n        removeNodes(nodes)\n      }\n      activeNodes = nodes\n    }\n\n    // Initial render\n    createRenderEffect(() => {\n      // Update context value on re-render (if value prop changes reactively)\n      contextMap.set(id, props.value)\n      renderChildren(props.children)\n    })\n\n    return fragment\n  }\n\n  return context\n}\n\n/**\n * Reads the current value of a context.\n *\n * useContext looks up through the RootContext parent chain to find the\n * nearest Provider for this context. If no Provider is found, returns\n * the context's default value.\n *\n * @param context - The context object created by createContext\n * @returns The current context value\n *\n * @example\n * ```tsx\n * const ThemeContext = createContext('light')\n *\n * function ThemedButton() {\n *   const theme = useContext(ThemeContext)\n *   return <button class={theme === 'dark' ? 'btn-dark' : 'btn-light'}>Click</button>\n * }\n * ```\n */\nexport function useContext<T>(context: Context<T>): T {\n  let root = getCurrentRoot()\n\n  // Walk up the parent chain looking for the context value\n  while (root) {\n    const contextMap = contextStorage.get(root)\n    if (contextMap && contextMap.has(context.id)) {\n      return contextMap.get(context.id) as T\n    }\n    root = root.parent\n  }\n\n  // No provider found, return default value\n  return context.defaultValue\n}\n\n/**\n * Checks if a context value is currently provided in the tree.\n *\n * Useful for conditional behavior when a provider may or may not exist.\n *\n * @param context - The context object to check\n * @returns true if a Provider exists above in the tree\n *\n * @example\n * ```tsx\n * function OptionalTheme() {\n *   if (hasContext(ThemeContext)) {\n *     const theme = useContext(ThemeContext)\n *     return <div class={theme}>Themed content</div>\n *   }\n *   return <div>Default content</div>\n * }\n * ```\n */\nexport function hasContext<T>(context: Context<T>): boolean {\n  let root = getCurrentRoot()\n\n  while (root) {\n    const contextMap = contextStorage.get(root)\n    if (contextMap && contextMap.has(context.id)) {\n      return true\n    }\n    root = root.parent\n  }\n\n  return false\n}\n"],"mappings":";;;;;;;;;;;;;;;AAoGA,IAAM,iBAAiB,oBAAI,QAA2C;AAKtE,SAAS,cAAc,MAAyC;AAC9D,MAAI,MAAM,eAAe,IAAI,IAAI;AACjC,MAAI,CAAC,KAAK;AACR,UAAM,oBAAI,IAAI;AACd,mBAAe,IAAI,MAAM,GAAG;AAAA,EAC9B;AACA,SAAO;AACT;AA0CO,SAAS,cAAiB,cAA6B;AAC5D,QAAM,KAAK,OAAO,cAAc;AAEhC,QAAM,UAAsB;AAAA,IAC1B;AAAA,IACA;AAAA,IACA,UAAU;AAAA,EACZ;AAGA,UAAQ,WAAW,SAAS,SAAS,OAAmC;AACtE,UAAM,WAAW,eAAe;AAIhC,UAAM,eAAe,kBAAkB,QAAQ;AAG/C,UAAM,aAAa,cAAc,YAAY;AAC7C,eAAW,IAAI,IAAI,MAAM,KAAK;AAG9B,UAAM,WAAW,SAAS,uBAAuB;AACjD,UAAM,SAAS,SAAS,cAAc,UAAU;AAChD,aAAS,YAAY,MAAM;AAE3B,QAAI;AACJ,QAAI,cAAsB,CAAC;AAE3B,UAAM,iBAAiB,CAAC,aAAuB;AAE7C,UAAI,SAAS;AACX,gBAAQ;AACR,kBAAU;AAAA,MACZ;AACA,UAAI,YAAY,QAAQ;AACtB,oBAAY,WAAW;AACvB,sBAAc,CAAC;AAAA,MACjB;AAEA,UAAI,YAAY,QAAQ,aAAa,OAAO;AAC1C;AAAA,MACF;AAEA,YAAM,OAAO,SAAS,YAAY;AAClC,UAAI,QAAgB,CAAC;AACrB,UAAI;AACF,cAAM,SAAS,cAAc,QAAQ;AACrC,gBAAQ,YAAY,MAAM;AAC1B,cAAM,aAAa,OAAO;AAC1B,YAAI,YAAY;AACd,4BAAkB,YAAY,OAAO,MAAM;AAAA,QAC7C;AAAA,MACF,UAAE;AACA,gBAAQ,IAAI;AACZ,qBAAa,YAAY;AAAA,MAC3B;AAEA,gBAAU,MAAM;AACd,oBAAY,YAAY;AACxB,oBAAY,KAAK;AAAA,MACnB;AACA,oBAAc;AAAA,IAChB;AAGA,uBAAmB,MAAM;AAEvB,iBAAW,IAAI,IAAI,MAAM,KAAK;AAC9B,qBAAe,MAAM,QAAQ;AAAA,IAC/B,CAAC;AAED,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAsBO,SAAS,WAAc,SAAwB;AACpD,MAAI,OAAO,eAAe;AAG1B,SAAO,MAAM;AACX,UAAM,aAAa,eAAe,IAAI,IAAI;AAC1C,QAAI,cAAc,WAAW,IAAI,QAAQ,EAAE,GAAG;AAC5C,aAAO,WAAW,IAAI,QAAQ,EAAE;AAAA,IAClC;AACA,WAAO,KAAK;AAAA,EACd;AAGA,SAAO,QAAQ;AACjB;AAqBO,SAAS,WAAc,SAA8B;AAC1D,MAAI,OAAO,eAAe;AAE1B,SAAO,MAAM;AACX,UAAM,aAAa,eAAe,IAAI,IAAI;AAC1C,QAAI,cAAc,WAAW,IAAI,QAAQ,EAAE,GAAG;AAC5C,aAAO;AAAA,IACT;AACA,WAAO,KAAK;AAAA,EACd;AAEA,SAAO;AACT;","names":[]}