octane 0.2.4 → 0.2.6

package/dist/runtime.d.ts

@@ -619,6 +619,8 @@ interface OffscreenCapture {
 }
 /** @internal Preserve the owning renderer's scheduler without racing a staged commit. */
 export declare function scheduleRenderCleanup(schedule: (callback: () => void) => void, receiver: unknown, cleanup: () => void, onDiscard?: () => void): void;
+/** Whether a testing helper is executing within an active act callback. */
+export declare function isInActScope(): boolean;
 /**
  * Test-environment opt-in. When true, scheduleRender() calls that happen
  * outside a flushSync or an act() callback emit a console.error mirroring
@@ -677,17 +679,17 @@ export declare function drainPassiveEffects(): void;
  */
 export declare function hasPendingWork(): boolean;
 /**
- * React-parity `act(...)`. Wrap test code that triggers updates so all of
+ * Wrap test code that triggers updates so all of
  * the scheduled work commits before the assertion phase runs.
  *
- * TWO modes, matching React exactly:
+ * Two callback modes:
  *  - SYNC callback → all scheduled work (renders + INSERTION/LAYOUT/PASSIVE
  *    effects) is flushed SYNCHRONOUSLY before act returns, so
  *    `act(() => setState(...)); expect(...)` works WITHOUT awaiting — the
- *    dominant pattern in ported React test suites. The returned (already
- *    resolved) promise still carries the callback's result; a callback throw
- *    REJECTS the promise rather than throwing synchronously (React's act is
- *    a thenable with the same contract).
+ *    dominant pattern in ported React test suites. Nested callbacks join the
+ *    outer callback's transaction. The returned promise also drains promise
+ *    work and carries the callback's result. Callback and render errors reject
+ *    it rather than escaping through the scheduler.
  *  - ASYNC callback (returns a thenable) → awaited, then the scheduler is
  *    drained across microtask ticks until quiescent (renders, effects, and
  *    microtask chains from `use(promise)` / transition retries).
@@ -696,7 +698,7 @@ export declare function hasPendingWork(): boolean;
  * dev warning is suppressed (see `IS_OCTANE_ACT_ENVIRONMENT` and
  * `setIsOctaneActEnvironment`).
  *
- * The async double-loop (5 microtask ticks × up to ACT_DRAIN_LIMIT iterations)
+ * Complete promise checkpoints, bounded by ACT_DRAIN_LIMIT iterations,
  * drains cascades like `use(promise)` → status flip → retry → renderBlock
  * that wouldn't settle in a single tick.
  */
@@ -708,6 +710,8 @@ declare const SLOT_FLAG_TEARDOWN: number;
 export declare function invokeManualHook<T>(fn: (...args: any[]) => T, receiver: unknown, args: IArguments): T;
 /** @internal Adapt an expression provider that owns the trailing hook-slot ABI. */
 export declare function manualHook<F extends (...args: any[]) => any>(fn: F, name?: string): F;
+/** Invoke a cached optional-chain method without consulting its call/bind properties. */
+export declare function callWithReceiver<T>(fn: (...args: any[]) => T, receiver: unknown, ...args: any[]): T;
 export declare function withSlot<T>(sym: symbol, fn: (...a: any[]) => T, ...args: any[]): T;
 /** @internal Optional native hooks use the existing compiler slot and Scope lifetime. */
 export declare function nativeLocalHook<T>(name: string, initialize: () => T, dispose: (value: T) => void, slot?: HookSlot): T;
@@ -1581,7 +1585,7 @@ export declare function setFormControlSources(el: Element, sources: ReadonlyArra
 interface PortalSlot {
     __kind: 'portalSlotSlot';
     block: Block | null;
-    target: Element | null;
+    target: Element | DocumentFragment | null;
     key: string | null;
     host: Node;
     start: Comment | null;
@@ -1597,7 +1601,7 @@ interface PortalSlot {
  * the portal body in place. Unmounting the enclosing Block tears the portal
  * down and removes its DOM from `target`.
  */
-export declare function portal(parentScope: Scope, slotKey: number, target: Element, body: ComponentBody, props: any, host?: Node, env?: any[], fragmentOwners?: FragmentInstance | readonly FragmentInstance[], fragmentAnchor?: Node): void;
+export declare function portal(parentScope: Scope, slotKey: number, target: Element | DocumentFragment, body: ComponentBody, props: any, host?: Node, env?: any[], fragmentOwners?: FragmentInstance | readonly FragmentInstance[], fragmentAnchor?: Node): void;
 /**
  * `createPortal(children, target, keyOrProps?)`. A string/number third argument
  * is a reconciliation key. An object remains Octane's optional props for a
@@ -1612,10 +1616,10 @@ export interface PortalDescriptor {
     $$kind: typeof PORTAL_TAG;
     key: string | null;
     body: ComponentBody | ElementDescriptor | unknown;
-    target: Element;
+    target: Element | DocumentFragment;
     props: any;
 }
-export declare function createPortal(body: ComponentBody | ElementDescriptor | unknown, target: Element, props?: any): PortalDescriptor;
+export declare function createPortal(body: ComponentBody | ElementDescriptor | unknown, target: Element | DocumentFragment, props?: any): PortalDescriptor;
 declare const ELEMENT_TAG: unique symbol;
 export interface ElementDescriptor<P = any> {
     $$kind: typeof ELEMENT_TAG;
@@ -1941,7 +1945,7 @@ interface ForSlot {
     plainDeopt: boolean;
     selectionItems?: ArrayLike<any>;
 }
-export declare function forBlock<T>(parentScope: Scope, slotKey: number, domParent: Node, items: ArrayLike<T>, getKey: (item: T, index: number) => any, itemBody: (item: T, scope: Scope) => void, flags?: number, deps?: any[], emptyBody?: ComponentBody | null, anchor?: Node | null, ownEnd?: boolean): void;
+export declare function forBlock<T>(parentScope: Scope, slotKey: number, domParent: Node, inputItems: ArrayLike<T> | Iterable<T>, getKey: (item: T, index: number) => any, itemBody: (item: T, scope: Scope) => void, flags?: number, deps?: any[], emptyBody?: ComponentBody | null, anchor?: Node | null, ownEnd?: boolean): void;
 /**
  * Compiler-only keyed-selection entry. Keeping the specialization outside
  * forBlock lets applications without a proven selection tree-shake its cost.