@fluixi/reactive 1.0.0-alpha.100

package/dist/lib/signal/graph/suspense.cjs

@@ -0,0 +1,313 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/signal/graph/suspense.ts
+var suspense_exports = {};
+__export(suspense_exports, {
+  SuspenseContext: () => SuspenseContext,
+  createSuspenseBoundary: () => createSuspenseBoundary,
+  provideSuspense: () => provideSuspense
+});
+module.exports = __toCommonJS(suspense_exports);
+
+// src/version.generated.ts
+var VERSION = "1.0.0-alpha.100";
+
+// src/lib/signal/graph/state.ts
+var MAJOR = VERSION.split(".")[0];
+var KEY = `__fluixi_signal_state_v${MAJOR}__`;
+var VERSIONS_KEY = `__fluixi_signal_builds_v${MAJOR}__`;
+var defaultSchedule = (run) => {
+  if (typeof queueMicrotask === "function") queueMicrotask(run);
+  else void Promise.resolve().then(run);
+};
+function defaults() {
+  return {
+    consumer: null,
+    untracked: false,
+    owner: null,
+    queue: [],
+    scheduled: false,
+    flushing: false,
+    batchDepth: 0,
+    hostSchedule: defaultSchedule,
+    onSuspend: null,
+    onError: null,
+    observer: null
+  };
+}
+var realm = globalThis;
+function backfillState(existing) {
+  const fresh = defaults();
+  const target = existing;
+  for (const field of Object.keys(fresh)) {
+    if (!(field in existing)) target[field] = fresh[field];
+  }
+  return existing;
+}
+function claim() {
+  const existing = realm[KEY];
+  return existing ? backfillState(existing) : realm[KEY] = defaults();
+}
+var G = claim();
+(realm[VERSIONS_KEY] ??= []).push(VERSION);
+
+// src/lib/signal/graph/observe.ts
+function observeReactiveNodes(next) {
+  G.observer = next;
+  return () => {
+    if (G.observer === next) G.observer = null;
+  };
+}
+var running = [];
+var origin;
+var currentScope;
+function reportReactiveNode(report) {
+  const observer = G.observer;
+  if (observer) {
+    observer.created(
+      report.parents === void 0 ? { ...report, parents: running, origin: report.origin ?? origin, scope: report.scope ?? currentScope } : { ...report, scope: report.scope ?? currentScope }
+    );
+  }
+}
+function reportReactiveWrite(node, by) {
+  G.observer?.wrote?.(node, by);
+}
+function reportReactiveContextCreated(id) {
+  G.observer?.contextCreated?.(id);
+}
+function reportReactiveContext(id, kind, value) {
+  const observer = G.observer;
+  if (!observer?.context || !running.length) return;
+  observer.context(running[running.length - 1], id, kind, value);
+}
+function reportReactiveDispose(node) {
+  G.observer?.disposed?.(node);
+}
+var HOOK = "__FLUIXI_DEVTOOLS_HOOK__";
+var hook = globalThis[HOOK];
+if (typeof hook?.inject === "function") {
+  try {
+    hook.inject({ observeReactiveNodes, version: VERSION });
+  } catch {
+  }
+}
+function isObserved() {
+  return G.observer != null;
+}
+
+// src/lib/signal/graph/core.ts
+var DIRTY = 2;
+var Source = class {
+  constructor() {
+    /** Computeds, and watched leaves, that read this node. */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    this.observers = null;
+    /** Watchers eagerly observing this node, which is how `runtime.ts` schedules effects. */
+    this.watchers = null;
+    /** Bumped whenever this node's value actually changes (equality-gated). */
+    this.version = 0;
+  }
+  /** Settle this node so a reader sees a current value/version. Overridden by Computed. */
+  updateIfNecessary() {
+  }
+  /** Link the current consumer (if any) as an observer of this node. */
+  track() {
+    if (G.untracked) return;
+    const consumer = G.consumer;
+    if (!consumer) return;
+    (this.observers ??= /* @__PURE__ */ new Set()).add(consumer);
+    (consumer.sources ??= /* @__PURE__ */ new Set()).add(this);
+  }
+};
+var State = class extends Source {
+  constructor(value, options) {
+    super();
+    this._value = value;
+    this._equals = options?.equals === false ? () => false : options?.equals ?? Object.is;
+  }
+  get() {
+    this.track();
+    return this._value;
+  }
+  set(next) {
+    if (this._equals(this._value, next)) return;
+    this._value = next;
+    this.version++;
+    reportReactiveWrite(this, G.consumer);
+    if (this.observers) for (const o of [...this.observers]) o.markDirty(DIRTY);
+    notifyWatchers(this);
+  }
+  /** Read without subscribing (peek). */
+  peek() {
+    return this._value;
+  }
+};
+function notifyWatchers(node) {
+  if (!node.watchers) return;
+  for (const w of [...node.watchers]) w._notify(node);
+}
+
+// src/lib/signal/graph/runtime.ts
+function makeOwner(parent) {
+  return { cleanups: null, owned: null, parent, contexts: null };
+}
+function createContext(defaultValue, name) {
+  const id = Symbol(name ?? "context");
+  reportReactiveContextCreated(id);
+  const Provider = (props) => {
+    reportReactiveContext(id, "provide", props.value);
+    const parent = G.owner;
+    const owner = makeOwner(parent);
+    (owner.contexts = /* @__PURE__ */ new Map()).set(id, props.value);
+    if (parent) (parent.owned ??= []).push(owner);
+    G.owner = owner;
+    try {
+      return props.children;
+    } finally {
+      G.owner = parent;
+    }
+  };
+  return { id, defaultValue, Provider };
+}
+function readContextFrom(owner, context) {
+  let o = owner;
+  while (o) {
+    if (o.contexts && o.contexts.has(context.id)) return o.contexts.get(context.id);
+    o = o.parent;
+  }
+  return context.defaultValue;
+}
+function provide(context, value, fn) {
+  const owner = makeOwner(G.owner);
+  (owner.contexts = /* @__PURE__ */ new Map()).set(context.id, value);
+  if (G.owner) (G.owner.owned ??= []).push(owner);
+  const prev = G.owner;
+  G.owner = owner;
+  try {
+    return fn();
+  } finally {
+    G.owner = prev;
+  }
+}
+function setSuspendHandler(fn) {
+  G.onSuspend = fn;
+}
+function onCleanup(fn) {
+  if (!G.owner) return;
+  if (G.owner.disposed) {
+    fn();
+    return;
+  }
+  (G.owner.cleanups ??= []).push(fn);
+}
+function setScheduler(fn) {
+  G.hostSchedule = fn ?? ((run) => void Promise.resolve().then(run));
+}
+function flushSync() {
+  G.scheduled = false;
+  if (G.flushing) return;
+  G.flushing = true;
+  let guard = 0;
+  let failed = false;
+  let first;
+  try {
+    while (G.queue.length) {
+      if (++guard > 1e5) throw new Error("[fluixi] effect flush did not settle (cycle?)");
+      const batchOf = G.queue;
+      G.queue = [];
+      for (const e of batchOf) {
+        e.queued = false;
+        if (e.disposed) continue;
+        try {
+          e.run();
+        } catch (error) {
+          if (!failed) {
+            failed = true;
+            first = error;
+          }
+        }
+      }
+    }
+  } finally {
+    G.flushing = false;
+  }
+  if (failed) throw first;
+}
+function afterWrite() {
+  if (G.batchDepth === 0) flushSync();
+}
+
+// src/lib/signal/graph/compat.ts
+setScheduler(() => {
+});
+var $SIGNAL = /* @__PURE__ */ Symbol.for("signal");
+var $NODE = /* @__PURE__ */ Symbol.for("signal-node");
+function createSignal(value, options) {
+  const state = new State(value, { equals: options?.equals });
+  const read = (() => state.get());
+  const write = ((next) => {
+    const v = typeof next === "function" ? next(state.peek()) : next;
+    state.set(v);
+    afterWrite();
+    return v;
+  });
+  Object.defineProperty(read, $SIGNAL, { value: true, enumerable: true });
+  Object.defineProperty(read, $NODE, {
+    value: {
+      get value() {
+        return state.peek();
+      },
+      get version() {
+        return state.version;
+      }
+    },
+    enumerable: false
+  });
+  reportReactiveNode({
+    kind: "signal",
+    node: state,
+    handle: read,
+    name: options?.name,
+    set: write
+  });
+  if (isObserved()) onCleanup(() => reportReactiveDispose(state));
+  return [read, write];
+}
+
+// src/lib/signal/graph/suspense.ts
+var SuspenseContext = createContext();
+setSuspendHandler((promise, owner) => {
+  const boundary = readContextFrom(owner, SuspenseContext);
+  if (!boundary) return;
+  boundary.increment();
+  promise.finally(() => boundary.decrement());
+});
+function createSuspenseBoundary() {
+  const [pending, setPending] = createSignal(0);
+  let count = 0;
+  return {
+    increment: () => setPending(count += 1),
+    decrement: () => setPending(count -= 1),
+    inFallback: () => pending() > 0
+  };
+}
+function provideSuspense(boundary, fn) {
+  return provide(SuspenseContext, boundary, fn);
+}

package/dist/lib/signal/graph/suspense.d.ts

@@ -0,0 +1,13 @@
+export interface SuspenseBoundary {
+    increment(): void;
+    decrement(): void;
+    /** Reactive: true while any descendant read is still pending. */
+    inFallback(): boolean;
+}
+declare const SuspenseContext: import("./runtime.js").Context<SuspenseBoundary | undefined>;
+/** Create a boundary's reactive state (pending counter + inFallback). */
+export declare function createSuspenseBoundary(): SuspenseBoundary;
+/** Run `fn` (the boundary's children) under a Suspense scope, so suspended reads inside report to `boundary`. */
+export declare function provideSuspense<R>(boundary: SuspenseBoundary, fn: () => R): R;
+export { SuspenseContext };
+//# sourceMappingURL=suspense.d.ts.map

package/dist/lib/signal/graph/suspense.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suspense.d.ts","sourceRoot":"","sources":["../../../../src/lib/signal/graph/suspense.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,gBAAgB;IAC/B,SAAS,IAAI,IAAI,CAAC;IAClB,SAAS,IAAI,IAAI,CAAC;IAClB,iEAAiE;IACjE,UAAU,IAAI,OAAO,CAAC;CACvB;AAED,QAAA,MAAM,eAAe,8DAAgD,CAAC;AAUtE,yEAAyE;AACzE,wBAAgB,sBAAsB,IAAI,gBAAgB,CAQzD;AAED,iHAAiH;AACjH,wBAAgB,eAAe,CAAC,CAAC,EAAE,QAAQ,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAE7E;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/lib/signal/graph/suspense.js

@@ -0,0 +1,36 @@
+/**
+ * Suspense ported onto the TC39 core (additive; legacy signal.ts untouched).
+ *
+ * A Suspense boundary is just a context carrying a pending counter. A suspended read
+ * (createResource while pending throws its promise) bubbles to the runtime effect's run(),
+ * which calls the injected suspend handler registered here, it finds the nearest
+ * boundary (via the effect's owner chain) and increments it; the promise settling
+ * decrements it. The effect itself re-runs through normal reactivity once the
+ * resource's state signal changes, so the resolved content replaces the fallback.
+ */
+import { createContext, provide, readContextFrom, setSuspendHandler, } from './runtime.js';
+import { createSignal } from './compat.js';
+const SuspenseContext = createContext();
+// Wire the runtime effect's suspend path to the nearest boundary. Registered once.
+setSuspendHandler((promise, owner) => {
+    const boundary = readContextFrom(owner, SuspenseContext);
+    if (!boundary)
+        return; // no boundary above -> let it stay pending (no crash)
+    boundary.increment();
+    promise.finally(() => boundary.decrement());
+});
+/** Create a boundary's reactive state (pending counter + inFallback). */
+export function createSuspenseBoundary() {
+    const [pending, setPending] = createSignal(0);
+    let count = 0;
+    return {
+        increment: () => setPending((count += 1)),
+        decrement: () => setPending((count -= 1)),
+        inFallback: () => pending() > 0,
+    };
+}
+/** Run `fn` (the boundary's children) under a Suspense scope, so suspended reads inside report to `boundary`. */
+export function provideSuspense(boundary, fn) {
+    return provide(SuspenseContext, boundary, fn);
+}
+export { SuspenseContext };

package/dist/lib/signal/graph/suspense.mjs

@@ -0,0 +1,290 @@
+// src/version.generated.ts
+var VERSION = "1.0.0-alpha.100";
+
+// src/lib/signal/graph/state.ts
+var MAJOR = VERSION.split(".")[0];
+var KEY = `__fluixi_signal_state_v${MAJOR}__`;
+var VERSIONS_KEY = `__fluixi_signal_builds_v${MAJOR}__`;
+var defaultSchedule = (run) => {
+  if (typeof queueMicrotask === "function") queueMicrotask(run);
+  else void Promise.resolve().then(run);
+};
+function defaults() {
+  return {
+    consumer: null,
+    untracked: false,
+    owner: null,
+    queue: [],
+    scheduled: false,
+    flushing: false,
+    batchDepth: 0,
+    hostSchedule: defaultSchedule,
+    onSuspend: null,
+    onError: null,
+    observer: null
+  };
+}
+var realm = globalThis;
+function backfillState(existing) {
+  const fresh = defaults();
+  const target = existing;
+  for (const field of Object.keys(fresh)) {
+    if (!(field in existing)) target[field] = fresh[field];
+  }
+  return existing;
+}
+function claim() {
+  const existing = realm[KEY];
+  return existing ? backfillState(existing) : realm[KEY] = defaults();
+}
+var G = claim();
+(realm[VERSIONS_KEY] ??= []).push(VERSION);
+
+// src/lib/signal/graph/observe.ts
+function observeReactiveNodes(next) {
+  G.observer = next;
+  return () => {
+    if (G.observer === next) G.observer = null;
+  };
+}
+var running = [];
+var origin;
+var currentScope;
+function reportReactiveNode(report) {
+  const observer = G.observer;
+  if (observer) {
+    observer.created(
+      report.parents === void 0 ? { ...report, parents: running, origin: report.origin ?? origin, scope: report.scope ?? currentScope } : { ...report, scope: report.scope ?? currentScope }
+    );
+  }
+}
+function reportReactiveWrite(node, by) {
+  G.observer?.wrote?.(node, by);
+}
+function reportReactiveContextCreated(id) {
+  G.observer?.contextCreated?.(id);
+}
+function reportReactiveContext(id, kind, value) {
+  const observer = G.observer;
+  if (!observer?.context || !running.length) return;
+  observer.context(running[running.length - 1], id, kind, value);
+}
+function reportReactiveDispose(node) {
+  G.observer?.disposed?.(node);
+}
+var HOOK = "__FLUIXI_DEVTOOLS_HOOK__";
+var hook = globalThis[HOOK];
+if (typeof hook?.inject === "function") {
+  try {
+    hook.inject({ observeReactiveNodes, version: VERSION });
+  } catch {
+  }
+}
+function isObserved() {
+  return G.observer != null;
+}
+
+// src/lib/signal/graph/core.ts
+var DIRTY = 2;
+var Source = class {
+  constructor() {
+    /** Computeds, and watched leaves, that read this node. */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    this.observers = null;
+    /** Watchers eagerly observing this node, which is how `runtime.ts` schedules effects. */
+    this.watchers = null;
+    /** Bumped whenever this node's value actually changes (equality-gated). */
+    this.version = 0;
+  }
+  /** Settle this node so a reader sees a current value/version. Overridden by Computed. */
+  updateIfNecessary() {
+  }
+  /** Link the current consumer (if any) as an observer of this node. */
+  track() {
+    if (G.untracked) return;
+    const consumer = G.consumer;
+    if (!consumer) return;
+    (this.observers ??= /* @__PURE__ */ new Set()).add(consumer);
+    (consumer.sources ??= /* @__PURE__ */ new Set()).add(this);
+  }
+};
+var State = class extends Source {
+  constructor(value, options) {
+    super();
+    this._value = value;
+    this._equals = options?.equals === false ? () => false : options?.equals ?? Object.is;
+  }
+  get() {
+    this.track();
+    return this._value;
+  }
+  set(next) {
+    if (this._equals(this._value, next)) return;
+    this._value = next;
+    this.version++;
+    reportReactiveWrite(this, G.consumer);
+    if (this.observers) for (const o of [...this.observers]) o.markDirty(DIRTY);
+    notifyWatchers(this);
+  }
+  /** Read without subscribing (peek). */
+  peek() {
+    return this._value;
+  }
+};
+function notifyWatchers(node) {
+  if (!node.watchers) return;
+  for (const w of [...node.watchers]) w._notify(node);
+}
+
+// src/lib/signal/graph/runtime.ts
+function makeOwner(parent) {
+  return { cleanups: null, owned: null, parent, contexts: null };
+}
+function createContext(defaultValue, name) {
+  const id = Symbol(name ?? "context");
+  reportReactiveContextCreated(id);
+  const Provider = (props) => {
+    reportReactiveContext(id, "provide", props.value);
+    const parent = G.owner;
+    const owner = makeOwner(parent);
+    (owner.contexts = /* @__PURE__ */ new Map()).set(id, props.value);
+    if (parent) (parent.owned ??= []).push(owner);
+    G.owner = owner;
+    try {
+      return props.children;
+    } finally {
+      G.owner = parent;
+    }
+  };
+  return { id, defaultValue, Provider };
+}
+function readContextFrom(owner, context) {
+  let o = owner;
+  while (o) {
+    if (o.contexts && o.contexts.has(context.id)) return o.contexts.get(context.id);
+    o = o.parent;
+  }
+  return context.defaultValue;
+}
+function provide(context, value, fn) {
+  const owner = makeOwner(G.owner);
+  (owner.contexts = /* @__PURE__ */ new Map()).set(context.id, value);
+  if (G.owner) (G.owner.owned ??= []).push(owner);
+  const prev = G.owner;
+  G.owner = owner;
+  try {
+    return fn();
+  } finally {
+    G.owner = prev;
+  }
+}
+function setSuspendHandler(fn) {
+  G.onSuspend = fn;
+}
+function onCleanup(fn) {
+  if (!G.owner) return;
+  if (G.owner.disposed) {
+    fn();
+    return;
+  }
+  (G.owner.cleanups ??= []).push(fn);
+}
+function setScheduler(fn) {
+  G.hostSchedule = fn ?? ((run) => void Promise.resolve().then(run));
+}
+function flushSync() {
+  G.scheduled = false;
+  if (G.flushing) return;
+  G.flushing = true;
+  let guard = 0;
+  let failed = false;
+  let first;
+  try {
+    while (G.queue.length) {
+      if (++guard > 1e5) throw new Error("[fluixi] effect flush did not settle (cycle?)");
+      const batchOf = G.queue;
+      G.queue = [];
+      for (const e of batchOf) {
+        e.queued = false;
+        if (e.disposed) continue;
+        try {
+          e.run();
+        } catch (error) {
+          if (!failed) {
+            failed = true;
+            first = error;
+          }
+        }
+      }
+    }
+  } finally {
+    G.flushing = false;
+  }
+  if (failed) throw first;
+}
+function afterWrite() {
+  if (G.batchDepth === 0) flushSync();
+}
+
+// src/lib/signal/graph/compat.ts
+setScheduler(() => {
+});
+var $SIGNAL = /* @__PURE__ */ Symbol.for("signal");
+var $NODE = /* @__PURE__ */ Symbol.for("signal-node");
+function createSignal(value, options) {
+  const state = new State(value, { equals: options?.equals });
+  const read = (() => state.get());
+  const write = ((next) => {
+    const v = typeof next === "function" ? next(state.peek()) : next;
+    state.set(v);
+    afterWrite();
+    return v;
+  });
+  Object.defineProperty(read, $SIGNAL, { value: true, enumerable: true });
+  Object.defineProperty(read, $NODE, {
+    value: {
+      get value() {
+        return state.peek();
+      },
+      get version() {
+        return state.version;
+      }
+    },
+    enumerable: false
+  });
+  reportReactiveNode({
+    kind: "signal",
+    node: state,
+    handle: read,
+    name: options?.name,
+    set: write
+  });
+  if (isObserved()) onCleanup(() => reportReactiveDispose(state));
+  return [read, write];
+}
+
+// src/lib/signal/graph/suspense.ts
+var SuspenseContext = createContext();
+setSuspendHandler((promise, owner) => {
+  const boundary = readContextFrom(owner, SuspenseContext);
+  if (!boundary) return;
+  boundary.increment();
+  promise.finally(() => boundary.decrement());
+});
+function createSuspenseBoundary() {
+  const [pending, setPending] = createSignal(0);
+  let count = 0;
+  return {
+    increment: () => setPending(count += 1),
+    decrement: () => setPending(count -= 1),
+    inFallback: () => pending() > 0
+  };
+}
+function provideSuspense(boundary, fn) {
+  return provide(SuspenseContext, boundary, fn);
+}
+export {
+  SuspenseContext,
+  createSuspenseBoundary,
+  provideSuspense
+};