sibujs 4.5.0 → 4.6.0

package/dist/index.cjs

@@ -383,6 +383,23 @@ function reportDrainRunaway(label2, executed, remaining) {
   );
 }
 var activeBindingCount = 0;
+function resolveCapture(capture) {
+  let frame = capture;
+  while (frame?.closed) frame = frame.forwardTo;
+  return frame ?? null;
+}
+var registrationCaptures = [];
+function currentDisposerCapture() {
+  return resolveCapture(registrationCaptures[registrationCaptures.length - 1]);
+}
+function beginDisposerCapture(capture) {
+  if (capture === null && registrationCaptures.length === 0) return false;
+  registrationCaptures.push(resolveCapture(capture));
+  return true;
+}
+function endDisposerCapture() {
+  registrationCaptures.pop();
+}
 function registerDisposer(node, teardown) {
   let disposers = elementDisposers.get(node);
   if (!disposers) {
@@ -391,15 +408,18 @@ function registerDisposer(node, teardown) {
   }
   disposers.push(teardown);
   if (DEV) activeBindingCount++;
+  const capture = resolveCapture(registrationCaptures[registrationCaptures.length - 1]);
+  if (capture) capture.entries.push([node, teardown]);
 }
 function unregisterDisposer(node, teardown) {
   const disposers = elementDisposers.get(node);
-  if (!disposers) return;
+  if (!disposers) return false;
   const index = disposers.indexOf(teardown);
-  if (index === -1) return;
+  if (index === -1) return false;
   disposers.splice(index, 1);
   if (DEV) activeBindingCount--;
   if (disposers.length === 0) elementDisposers.delete(node);
+  return true;
 }
 function dispose(node) {
   const stack = [node];
@@ -413,33 +433,34 @@ function dispose(node) {
     }
   }
   for (let i2 = order.length - 1; i2 >= 0; i2--) {
-    const current = order[i2];
-    if (elementDisposers.has(current)) {
-      let executed = 0;
-      let runaway = false;
-      while (!runaway) {
-        const pending = elementDisposers.get(current);
-        if (!pending || pending.length === 0) break;
-        const snapshot = pending.slice();
-        elementDisposers.delete(current);
-        if (DEV) activeBindingCount -= snapshot.length;
-        for (let i3 = 0; i3 < snapshot.length; i3++) {
-          if (executed >= MAX_DRAIN_TEARDOWNS) {
-            const rest = snapshot.slice(i3);
-            const added = elementDisposers.get(current);
-            elementDisposers.set(current, added ? rest.concat(added) : rest);
-            if (DEV) activeBindingCount += rest.length;
-            reportDrainRunaway("dispose", executed, rest.length + (added?.length ?? 0));
-            runaway = true;
-            break;
-          }
-          executed++;
-          try {
-            snapshot[i3]();
-          } catch (err) {
-            reportError(err, { phase: "cleanup", name: "disposer" });
-          }
-        }
+    disposeNodeOwn(order[i2]);
+  }
+}
+function disposeNodeOwn(node) {
+  if (!elementDisposers.has(node)) return;
+  let executed = 0;
+  let runaway = false;
+  while (!runaway) {
+    const pending = elementDisposers.get(node);
+    if (!pending || pending.length === 0) break;
+    const snapshot = pending.slice();
+    elementDisposers.delete(node);
+    if (DEV) activeBindingCount -= snapshot.length;
+    for (let i2 = 0; i2 < snapshot.length; i2++) {
+      if (executed >= MAX_DRAIN_TEARDOWNS) {
+        const rest = snapshot.slice(i2);
+        const added = elementDisposers.get(node);
+        elementDisposers.set(node, added ? rest.concat(added) : rest);
+        if (DEV) activeBindingCount += rest.length;
+        reportDrainRunaway("dispose", executed, rest.length + (added?.length ?? 0));
+        runaway = true;
+        break;
+      }
+      executed++;
+      try {
+        snapshot[i2]();
+      } catch (err) {
+        reportError(err, { phase: "cleanup", name: "disposer" });
       }
     }
   }
@@ -920,6 +941,7 @@ function retrack(effectFn, subscriber) {
   }
   currentSubscriber = subscriber;
   const sub2 = subscriber;
+  if (sub2._cap === void 0) sub2._cap = currentDisposerCapture();
   const epoch = ++subscriberEpochCounter;
   sub2._epoch = epoch;
   sub2._structDirty = false;
@@ -1111,7 +1133,12 @@ function drainQueue() {
       quarantined.add(sub2);
       continue;
     }
-    safeInvoke(sub2);
+    const pushed = beginDisposerCapture(sub2._cap ?? null);
+    try {
+      safeInvoke(sub2);
+    } finally {
+      if (pushed) endDisposerCapture();
+    }
   }
 }
 function drainNotificationQueue() {
@@ -1247,7 +1274,7 @@ function forEachSubscriber(signal2, visit) {
 }
 
 // src/reactivity/track.ts
-var _runtimeVersion = true ? "4.5.0" : "dev";
+var _runtimeVersion = true ? "4.6.0" : "dev";
 var REGISTRY_KEY = /* @__PURE__ */ Symbol.for("sibujs.reactive.v1");
 function resolveReactiveApi() {
   const g2 = globalThis;
@@ -2288,6 +2315,10 @@ function getSSRStore() {
   }
   return fallbackStore;
 }
+function getRequestStore() {
+  if (als) return als.getStore() ?? null;
+  return _shared.fallbackDepth > 0 ? fallbackStore : null;
+}
 function isSSR() {
   return getSSRStore().ssr;
 }
@@ -2309,16 +2340,18 @@ function disableSSR() {
   getSSRStore().ssr = false;
 }
 function runInSSRContext(fn) {
-  const store2 = { ssr: true, suspenseIdCounter: 0, locale: void 0 };
+  const store2 = { ssr: true, suspenseIdCounter: 0, idCounter: 0, locale: void 0 };
   if (als) {
     return als.run(store2, fn);
   }
   warnMissingAsyncLocalStorage();
   const prevSSR = fallbackStore.ssr;
   const prevCounter = fallbackStore.suspenseIdCounter;
+  const prevIdCounter = fallbackStore.idCounter;
   const prevLocale = fallbackStore.locale;
   fallbackStore.ssr = true;
   fallbackStore.suspenseIdCounter = 0;
+  fallbackStore.idCounter = 0;
   fallbackStore.locale = void 0;
   _shared.fallbackDepth++;
   try {
@@ -2327,6 +2360,7 @@ function runInSSRContext(fn) {
     _shared.fallbackDepth--;
     fallbackStore.ssr = prevSSR;
     fallbackStore.suspenseIdCounter = prevCounter;
+    fallbackStore.idCounter = prevIdCounter;
     fallbackStore.locale = prevLocale;
   }
 }
@@ -3498,9 +3532,14 @@ var longPress = (element, options) => {
   };
 };
 var copyOnClick = (element, getText) => {
+  const report = (error) => reportError(error, { phase: "async", name: "copyOnClick", node: element });
   const handler = () => {
-    const text2 = typeof getText === "function" ? getText() : element.textContent ?? "";
-    navigator.clipboard.writeText(text2);
+    try {
+      const text2 = typeof getText === "function" ? getText() : element.textContent ?? "";
+      Promise.resolve(navigator.clipboard.writeText(text2)).catch(report);
+    } catch (error) {
+      report(error);
+    }
   };
   element.addEventListener("click", handler);
   return () => element.removeEventListener("click", handler);
@@ -3636,6 +3675,11 @@ function context(defaultValue) {
 var COUNTER_KEY = /* @__PURE__ */ Symbol.for("sibujs.createId.v1");
 var _counter = globalThis[COUNTER_KEY] ?? (globalThis[COUNTER_KEY] = { n: 0 });
 function createId(prefix = "sibu") {
+  const request = getRequestStore();
+  if (request) {
+    request.idCounter = (request.idCounter ?? 0) + 1;
+    return `${prefix}-${request.idCounter}`;
+  }
   _counter.n++;
   return `${prefix}-${_counter.n}`;
 }
@@ -3673,9 +3717,11 @@ function when(condition, thenBranch, elseBranch) {
   let currentNode = null;
   let lastCondition;
   let initialized = false;
+  let disposed = false;
   const attachedOnce = /* @__PURE__ */ new WeakSet();
   let currentNodeOwned = false;
   const update = () => {
+    if (disposed) return;
     const show2 = condition();
     const parent = anchor.parentNode;
     if (!parent) return;
@@ -3694,10 +3740,14 @@ function when(condition, thenBranch, elseBranch) {
     restoreFocusWithin(focused, currentNode ? [currentNode] : [], "when");
     initialized = true;
   };
-  registerDisposer(anchor, reactiveBinding2(update, anchor));
+  const stopBinding = reactiveBinding2(update, anchor);
+  registerDisposer(anchor, () => {
+    disposed = true;
+    stopBinding();
+  });
   if (!initialized) {
     queueMicrotask(() => {
-      if (!initialized && anchor.parentNode) update();
+      if (!disposed && !initialized && anchor.parentNode) update();
     });
   }
   return anchor;
@@ -3707,9 +3757,11 @@ function match(value, cases, fallback) {
   let currentNode = null;
   let lastKey;
   let initialized = false;
+  let disposed = false;
   const attachedOnce = /* @__PURE__ */ new WeakSet();
   let currentNodeOwned = false;
   const update = () => {
+    if (disposed) return;
     const key = String(value());
     const parent = anchor.parentNode;
     if (!parent) return;
@@ -3728,17 +3780,30 @@ function match(value, cases, fallback) {
     restoreFocusWithin(focused, currentNode ? [currentNode] : [], "match");
     initialized = true;
   };
-  registerDisposer(anchor, reactiveBinding2(update, anchor));
+  const stopBinding = reactiveBinding2(update, anchor);
+  registerDisposer(anchor, () => {
+    disposed = true;
+    stopBinding();
+  });
   if (!initialized) {
     queueMicrotask(() => {
-      if (!initialized && anchor.parentNode) update();
+      if (!disposed && !initialized && anchor.parentNode) update();
     });
   }
   return anchor;
 }
 
+// src/utils/globalSingleton.ts
+function globalSingleton(key, create) {
+  const g2 = globalThis;
+  return g2[key] ?? (g2[key] = create());
+}
+
 // src/core/rendering/dynamic.ts
-var componentRegistry = /* @__PURE__ */ new Map();
+var componentRegistry = globalSingleton(
+  /* @__PURE__ */ Symbol.for("sibujs.components.registry.v1"),
+  () => /* @__PURE__ */ new Map()
+);
 function registerComponent(name, component) {
   componentRegistry.set(name, component);
 }
@@ -3750,7 +3815,7 @@ function resolveComponent(name) {
   if (component) {
     return component();
   }
-  return div({ nodes: `[Component "${name}" not found]` });
+  return div(`[Component "${name}" not found]`);
 }
 function DynamicComponent(is) {
   const container = div({ class: "sibu-dynamic" });
@@ -4569,10 +4634,15 @@ function Portal(nodes, target) {
 
 // src/core/rendering/slots.ts
 function getSlot(slots, name = "default") {
-  return slots?.[name];
+  if (slots == null || !Object.hasOwn(slots, name)) return void 0;
+  const slot2 = slots[name];
+  return typeof slot2 === "function" ? slot2 : void 0;
 }
 
 // src/core/signals/array.ts
+function nativeSplice(target, start, rest) {
+  return rest.length === 0 ? target.splice(start) : target.splice(start, ...rest);
+}
 function array(initial = []) {
   const [arr, setArr] = signal([...initial]);
   const actions = {
@@ -4600,12 +4670,12 @@ function array(initial = []) {
     unshift(...items) {
       setArr((prev) => [...items, ...prev]);
     },
-    splice(start, deleteCount = 0, ...items) {
+    splice(start, ...rest) {
       let removed = [];
       setArr((prev) => {
         const copy = [...prev];
-        removed = copy.splice(start, deleteCount, ...items);
-        return copy;
+        removed = nativeSplice(copy, start, rest);
+        return removed.length === 0 && rest.length <= 1 ? prev : copy;
       });
       return removed;
     },
@@ -4688,9 +4758,9 @@ function reactiveArray(initial = []) {
       data2.unshift(...items);
       notify();
     },
-    splice(start, deleteCount = 0, ...items) {
-      const removed = data2.splice(start, deleteCount, ...items);
-      if (removed.length > 0 || items.length > 0) {
+    splice(start, ...rest) {
+      const removed = nativeSplice(data2, start, rest);
+      if (removed.length > 0 || rest.length > 1) {
         notify();
       }
       return removed;
@@ -4912,6 +4982,21 @@ function deepEqual(a2, b2, seen) {
     if (a2.length !== b2.length) return false;
     return a2.every((val, i2) => deepEqual(val, b2[i2], seen));
   }
+  if (a2 instanceof Number || a2 instanceof String || a2 instanceof Boolean) {
+    return Object.is(a2.valueOf(), b2.valueOf());
+  }
+  if (typeof URL !== "undefined" && a2 instanceof URL) {
+    return a2.href === b2.href;
+  }
+  if (a2 instanceof Error) {
+    const eb = b2;
+    return a2.name === eb.name && a2.message === eb.message && deepEqual(a2.cause, eb.cause, seen) && plainKeysEqual(objA, objB, seen);
+  }
+  const proto = Object.getPrototypeOf(objA);
+  if (proto !== Object.prototype && proto !== null) return false;
+  return plainKeysEqual(objA, objB, seen);
+}
+function plainKeysEqual(objA, objB, seen) {
   const keysA = Object.keys(objA);
   const keysB = Object.keys(objB);
   if (keysA.length !== keysB.length) return false;
@@ -5047,15 +5132,18 @@ function ref(initial) {
 }
 
 // src/core/signals/store.ts
+function defineOwn(obj, key, value) {
+  Object.defineProperty(obj, key, { value, writable: true, enumerable: true, configurable: true });
+}
 function store(initialState) {
   devAssert(
     initialState !== null && typeof initialState === "object" && !Array.isArray(initialState),
     "store: argument must be a plain object. For arrays, use array() instead."
   );
-  const signals = {};
+  const signals = /* @__PURE__ */ Object.create(null);
   Object.keys(initialState).forEach((key) => {
     const [getter, setter] = signal(initialState[key]);
-    signals[key] = [getter, setter];
+    defineOwn(signals, key, [getter, setter]);
   });
   const store2 = new Proxy({}, {
     get(target, prop) {
@@ -5074,7 +5162,7 @@ function store(initialState) {
   const getSnapshot = () => {
     const snapshot = {};
     Object.keys(signals).forEach((key) => {
-      snapshot[key] = signals[key][0]();
+      defineOwn(snapshot, key, signals[key][0]());
     });
     return snapshot;
   };
@@ -5210,6 +5298,13 @@ function strictEffect(fn) {
   };
 }
 
+// src/reactivity/domBinding.ts
+function domBinding(commit, ownerNode) {
+  if (isSSR()) return () => {
+  };
+  return reactiveBinding2(commit, ownerNode);
+}
+
 // src/platform/enhance.ts
 var ENHANCED_ATTR = "data-sibu-enhanced";
 var enhancementOwner = /* @__PURE__ */ new WeakMap();
@@ -5245,9 +5340,7 @@ function resolveTarget(root, target) {
   }
 }
 function bindNode(el, commit) {
-  if (isSSR()) return () => {
-  };
-  return reactiveBinding2(commit, el);
+  return domBinding(commit, el);
 }
 function readControlValue(el) {
   if (el instanceof HTMLInputElement) {
@@ -5505,12 +5598,6 @@ function enhanceAll(selector, setup) {
   };
 }
 
-// src/utils/globalSingleton.ts
-function globalSingleton(key, create) {
-  const g2 = globalThis;
-  return g2[key] ?? (g2[key] = create());
-}
-
 // src/platform/islands.ts
 var SAFE_NAME = /^[A-Za-z0-9_-]+$/;
 var LAZY = /* @__PURE__ */ Symbol.for("sibujs.islands.lazy");
@@ -5667,6 +5754,27 @@ function trustHTML(html3) {
 }
 var DEFAULT_MAX_SSR_BYTES = 1024 * 1024;
 
+// src/utils/adoptThenable.ts
+function adoptThenable(value) {
+  if (value === null || typeof value !== "object" && typeof value !== "function") return null;
+  let then;
+  try {
+    then = value.then;
+  } catch (error) {
+    return Promise.reject(error);
+  }
+  if (typeof then !== "function") return null;
+  return new Promise((resolve, reject) => {
+    queueMicrotask(() => {
+      try {
+        Reflect.apply(then, value, [resolve, reject]);
+      } catch (error) {
+        reject(error);
+      }
+    });
+  });
+}
+
 // src/reactivity/concurrent.ts
 function defer(getter) {
   const [value, setValue] = signal(getter());
@@ -5716,23 +5824,27 @@ function scheduleIdle(fn) {
 }
 function transition() {
   const [pending, setPending] = signal(false);
+  let outstanding = 0;
   function start(fn) {
+    outstanding++;
     setPending(true);
+    let settled = false;
+    const finish = () => {
+      if (settled) return;
+      settled = true;
+      outstanding--;
+      if (outstanding === 0) setPending(false);
+    };
+    const fail = (error) => {
+      finish();
+      reportError(error, { phase: "async", name: "transition" });
+    };
     scheduleIdle(() => {
-      let result;
       try {
-        result = fn();
-      } catch {
-        setPending(false);
-        return;
-      }
-      if (result && typeof result.then === "function") {
-        result.then(
-          () => setPending(false),
-          () => setPending(false)
-        );
-      } else {
-        setPending(false);
+        const adopted = adoptThenable(fn());
+        adopted ? adopted.then(finish, fail) : finish();
+      } catch (error) {
+        fail(error);
       }
     });
   }

package/dist/index.d.cts

@@ -1,6 +1,8 @@
-import { N as NodeChild, a as NodeChildren, T as TagProps, A as Accessor, D as DerivedAccessor } from './tagFactory-DVoDpHye.cjs';
-export { b as Dispose, E as ExternalSource, S as SVG_NS, c as SignalOptions, d as derived, e as external, s as signal, t as tagFactory } from './tagFactory-DVoDpHye.cjs';
-export { T as TrustedHTML, t as trustHTML } from './ssr-BiPRdZ6n.cjs';
+import { N as NodeChild, a as NodeChildren, T as TagProps, D as DerivedAccessor } from './tagFactory-DFstCLQV.cjs';
+export { b as Dispose, S as SVG_NS, d as derived, t as tagFactory } from './tagFactory-DFstCLQV.cjs';
+import { A as Accessor } from './signal-EotCj4hS.cjs';
+export { D as DisposableAccessor, E as ExternalSource, S as SignalOptions, e as external, s as signal } from './signal-EotCj4hS.cjs';
+export { T as TrustedHTML, t as trustHTML } from './ssr-Bli9XRW5.cjs';
 import { R as ReactiveSignal } from './signal-BnWpq6WB.cjs';
 
 interface ErrorBoundaryOptions {
@@ -416,6 +418,11 @@ declare function context<T>(defaultValue: T): Context<T>;
  *
  * Each call returns a fresh incrementing id. Optionally accepts a prefix.
  *
+ * Inside an SSR request (`runInSSRContext`) the counter belongs to that request,
+ * so every request's ids start from 1 — independent of earlier or concurrent
+ * requests, and identical to a fresh client's sequence for hydration. Outside a
+ * request the shared client counter is used.
+ *
  * IDs are plain strings (not reactive) — call once per component instance
  * and reuse the returned value for both sides of the association.
  *
@@ -558,7 +565,7 @@ declare function registerDisposer(node: Node, teardown: () => void): void;
  * The teardown is assumed to have already run (or to be deliberately abandoned);
  * this only releases the reference.
  */
-declare function unregisterDisposer(node: Node, teardown: () => void): void;
+declare function unregisterDisposer(node: Node, teardown: () => void): boolean;
 /**
  * Run all registered teardowns for a node and its descendants,
  * cleaning up reactive subscriptions to prevent memory leaks.
@@ -1206,6 +1213,8 @@ type Slots = Record<string, SlotFn>;
  * @param slots The slot map, which may be undefined.
  * @param name Slot name; defaults to `"default"`.
  * @returns The slot factory, or `undefined` when the slot was not provided.
+ *   Only an OWN function-valued entry counts: an inherited member such as
+ *   `toString` or `constructor` is not a slot, so fallback content renders.
  */
 declare function getSlot(slots: Slots | undefined, name?: string): SlotFn | undefined;
 
@@ -1597,6 +1606,13 @@ declare function writable<T>(get: () => T, set: (value: T) => void, options?: {
 interface SSRStore {
     ssr: boolean;
     suspenseIdCounter: number;
+    /**
+     * `createId()` counter for this request. Request-scoped for the same reason
+     * as `suspenseIdCounter`: a server render's ids must not depend on earlier or
+     * concurrent requests, and must match a fresh client's sequence. Optional so
+     * stores created elsewhere start it lazily at 0.
+     */
+    idCounter?: number;
     /**
      * Per-request data caches (e.g. the query cache). Lazily created and keyed
      * by subsystem so request-scoped data never bleeds between concurrent
@@ -2045,7 +2061,8 @@ interface TransitionState {
  * and avoids the complexity of an interruptible reconciler.
  *
  * Async callbacks are supported: `pending()` stays `true` until the
- * returned promise resolves OR rejects.
+ * returned promise resolves OR rejects. With overlapping `start()` calls it
+ * stays `true` until every one of them has settled.
  *
  * @example
  * ```ts

package/dist/index.d.ts

@@ -1,6 +1,8 @@
-import { N as NodeChild, a as NodeChildren, T as TagProps, A as Accessor, D as DerivedAccessor } from './tagFactory-DVoDpHye.js';
-export { b as Dispose, E as ExternalSource, S as SVG_NS, c as SignalOptions, d as derived, e as external, s as signal, t as tagFactory } from './tagFactory-DVoDpHye.js';
-export { T as TrustedHTML, t as trustHTML } from './ssr-BiPRdZ6n.js';
+import { N as NodeChild, a as NodeChildren, T as TagProps, D as DerivedAccessor } from './tagFactory-DkaNVUNV.js';
+export { b as Dispose, S as SVG_NS, d as derived, t as tagFactory } from './tagFactory-DkaNVUNV.js';
+import { A as Accessor } from './signal-EotCj4hS.js';
+export { D as DisposableAccessor, E as ExternalSource, S as SignalOptions, e as external, s as signal } from './signal-EotCj4hS.js';
+export { T as TrustedHTML, t as trustHTML } from './ssr-Bli9XRW5.js';
 import { R as ReactiveSignal } from './signal-BnWpq6WB.js';
 
 interface ErrorBoundaryOptions {
@@ -416,6 +418,11 @@ declare function context<T>(defaultValue: T): Context<T>;
  *
  * Each call returns a fresh incrementing id. Optionally accepts a prefix.
  *
+ * Inside an SSR request (`runInSSRContext`) the counter belongs to that request,
+ * so every request's ids start from 1 — independent of earlier or concurrent
+ * requests, and identical to a fresh client's sequence for hydration. Outside a
+ * request the shared client counter is used.
+ *
  * IDs are plain strings (not reactive) — call once per component instance
  * and reuse the returned value for both sides of the association.
  *
@@ -558,7 +565,7 @@ declare function registerDisposer(node: Node, teardown: () => void): void;
  * The teardown is assumed to have already run (or to be deliberately abandoned);
  * this only releases the reference.
  */
-declare function unregisterDisposer(node: Node, teardown: () => void): void;
+declare function unregisterDisposer(node: Node, teardown: () => void): boolean;
 /**
  * Run all registered teardowns for a node and its descendants,
  * cleaning up reactive subscriptions to prevent memory leaks.
@@ -1206,6 +1213,8 @@ type Slots = Record<string, SlotFn>;
  * @param slots The slot map, which may be undefined.
  * @param name Slot name; defaults to `"default"`.
  * @returns The slot factory, or `undefined` when the slot was not provided.
+ *   Only an OWN function-valued entry counts: an inherited member such as
+ *   `toString` or `constructor` is not a slot, so fallback content renders.
  */
 declare function getSlot(slots: Slots | undefined, name?: string): SlotFn | undefined;
 
@@ -1597,6 +1606,13 @@ declare function writable<T>(get: () => T, set: (value: T) => void, options?: {
 interface SSRStore {
     ssr: boolean;
     suspenseIdCounter: number;
+    /**
+     * `createId()` counter for this request. Request-scoped for the same reason
+     * as `suspenseIdCounter`: a server render's ids must not depend on earlier or
+     * concurrent requests, and must match a fresh client's sequence. Optional so
+     * stores created elsewhere start it lazily at 0.
+     */
+    idCounter?: number;
     /**
      * Per-request data caches (e.g. the query cache). Lazily created and keyed
      * by subsystem so request-scoped data never bleeds between concurrent
@@ -2045,7 +2061,8 @@ interface TransitionState {
  * and avoids the complexity of an interruptible reconciler.
  *
  * Async callbacks are supported: `pending()` stays `true` until the
- * returned promise resolves OR rejects.
+ * returned promise resolves OR rejects. With overlapping `start()` calls it
+ * stays `true` until every one of them has settled.
  *
  * @example
  * ```ts