@rsc-kit/core 0.3.0 → 0.4.0

package/dist/streaming.d.ts

@@ -1,62 +0,0 @@
-/**
- * Read every chunk a stream already has queued, then stop.
- *
- * A queued chunk settles its read in a microtask, so it always beats the
- * macrotask this races it against. A read that loses means the producer is
- * waiting on data rather than still writing — for React's SSR stream, the
- * moment the shell is fully out.
- *
- * The losing read is handed back rather than dropped, so the caller resumes
- * without losing a chunk.
- */
-export declare function drainQueuedChunks<T>(reader: {
-    read(): Promise<{
-        done: boolean;
-        value?: T;
-    }>;
-}, onChunk: (chunk: T) => void): Promise<{
-    pending: Promise<{
-        done: boolean;
-        value?: T;
-    }> | null;
-    done: boolean;
-}>;
-export interface DeferredHost {
-    /** Installed in place of the real host fn for the whole request. */
-    hostFn: (fn: string, ...args: unknown[]) => Promise<unknown>;
-    /** Start queueing. Called once metadata is resolved. */
-    begin: () => void;
-    /** Release the queue. Called once React's first payload is on the socket. */
-    flush: () => void;
-}
-/**
- * Queue host calls made during the render, so React's first payload — the HTML
- * shell, or the Flight root model and fallback rows — is on the socket before
- * PHP blocks on one.
- *
- * PHP runs a host callback synchronously on the same thread that pumps that
- * socket. Once a call starts, nothing the worker writes reaches the browser
- * until it returns, so anything React had not yet produced is stranded for the
- * duration. Both streaming paths share this: it is the difference between a
- * page painting its skeletons at once and painting nothing for the length of
- * the slowest call in it.
- */
-export declare function createDeferredHost(realHostFn: (fn: string, ...args: unknown[]) => Promise<unknown>): DeferredHost;
-/**
- * Write a React stream out, releasing the deferred host calls at the one safe
- * moment: after everything already queued — the shell, or the Flight root model
- * and fallback rows — is on the socket, and before anything that arrives later.
- *
- * Both worker paths stream through this so the ordering cannot drift between
- * them. It already had: the HTML path released after its first chunk and the
- * Flight path never deferred at all, so a slow host call blocked PHP with most
- * of the payload still unwritten and the browser rendered nothing until the
- * call returned.
- */
-export declare function streamWithDeferredRelease<T>(reader: {
-    read(): Promise<{
-        done: boolean;
-        value?: T;
-    }>;
-}, onChunk: (chunk: T) => void, release: () => void, idle?: () => Promise<void>): Promise<void>;
-//# sourceMappingURL=streaming.d.ts.map

package/dist/streaming.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../src/streaming.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,MAAM,EAAE;IAAE,IAAI,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,CAAC,CAAA;KAAE,CAAC,CAAA;CAAE,EACzD,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAC1B,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,CAAC,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAenF;AAED,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,wDAAwD;IACxD,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,6EAA6E;IAC7E,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,YAAY,CA4CjH;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,yBAAyB,CAAC,CAAC,EAC/C,MAAM,EAAE;IAAE,IAAI,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,CAAC,CAAA;KAAE,CAAC,CAAA;CAAE,EACzD,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,EAC3B,OAAO,EAAE,MAAM,IAAI,EACnB,IAAI,GAAE,MAAM,OAAO,CAAC,IAAI,CAAoB,GAC3C,OAAO,CAAC,IAAI,CAAC,CAcf"}

package/dist/streaming.js

@@ -1,108 +0,0 @@
-// Streaming coordination shared by both worker paths — initial-load HTML and
-// SPA-navigation Flight.
-//
-// Both stream React output over a socket that PHP pumps on the same thread it
-// runs host callbacks on. That single fact drives everything here: React's
-// first payload has to be on the socket before a callback can block, or the
-// browser sees nothing until the slowest call in the page returns.
-import { yieldToEventLoop } from './runtime.js';
-/**
- * Read every chunk a stream already has queued, then stop.
- *
- * A queued chunk settles its read in a microtask, so it always beats the
- * macrotask this races it against. A read that loses means the producer is
- * waiting on data rather than still writing — for React's SSR stream, the
- * moment the shell is fully out.
- *
- * The losing read is handed back rather than dropped, so the caller resumes
- * without losing a chunk.
- */
-export async function drainQueuedChunks(reader, onChunk) {
-    let pending = reader.read();
-    while (true) {
-        const settled = await Promise.race([
-            pending.then((result) => ({ result })),
-            yieldToEventLoop().then(() => null),
-        ]);
-        if (settled === null)
-            return { pending, done: false };
-        if (settled.result.done)
-            return { pending: null, done: true };
-        onChunk(settled.result.value);
-        pending = reader.read();
-    }
-}
-/**
- * Queue host calls made during the render, so React's first payload — the HTML
- * shell, or the Flight root model and fallback rows — is on the socket before
- * PHP blocks on one.
- *
- * PHP runs a host callback synchronously on the same thread that pumps that
- * socket. Once a call starts, nothing the worker writes reaches the browser
- * until it returns, so anything React had not yet produced is stranded for the
- * duration. Both streaming paths share this: it is the difference between a
- * page painting its skeletons at once and painting nothing for the length of
- * the slowest call in it.
- */
-export function createDeferredHost(realHostFn) {
-    const pendingCalls = [];
-    let flushed = false;
-    let deferring = false;
-    let backstop;
-    const flush = () => {
-        if (flushed)
-            return;
-        flushed = true;
-        clearTimeout(backstop);
-        for (const call of pendingCalls) {
-            realHostFn(call.fn, ...call.args).then(call.resolve, call.reject);
-        }
-        pendingCalls.length = 0;
-    };
-    return {
-        hostFn: (functionName, ...args) => {
-            if (!deferring || flushed)
-                return realHostFn(functionName, ...args);
-            return new Promise((resolve, reject) => {
-                pendingCalls.push({ fn: functionName, args, resolve, reject });
-            });
-        },
-        // Deferral covers the render only. Metadata resolves before any payload
-        // exists, so a host call there has nothing to strand — queueing it would
-        // just stall generateMetadata until the backstop fired.
-        begin: () => {
-            deferring = true;
-            // Backstop only, for a render that awaits a host call before it can
-            // produce the payload that would release the queue. The build rejects
-            // such a page unless it ships a loading.tsx, whose shell does not block,
-            // so in practice the drain always gets there first. Long on purpose: it
-            // must never race a cold start.
-            backstop = setTimeout(flush, 5000);
-        },
-        flush,
-    };
-}
-/**
- * Write a React stream out, releasing the deferred host calls at the one safe
- * moment: after everything already queued — the shell, or the Flight root model
- * and fallback rows — is on the socket, and before anything that arrives later.
- *
- * Both worker paths stream through this so the ordering cannot drift between
- * them. It already had: the HTML path released after its first chunk and the
- * Flight path never deferred at all, so a slow host call blocked PHP with most
- * of the payload still unwritten and the browser rendered nothing until the
- * call returned.
- */
-export async function streamWithDeferredRelease(reader, onChunk, release, idle = yieldToEventLoop) {
-    let { pending, done } = await drainQueuedChunks(reader, onChunk);
-    release();
-    while (!done) {
-        const result = await (pending ?? reader.read());
-        pending = null;
-        if (result.done)
-            break;
-        onChunk(result.value);
-        await idle();
-    }
-}
-//# sourceMappingURL=streaming.js.map

package/dist/streaming.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"streaming.js","sourceRoot":"","sources":["../src/streaming.ts"],"names":[],"mappings":"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"}

package/dist/worker.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=worker.d.ts.map

package/dist/worker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../src/worker.ts"],"names":[],"mappings":""}