@procedures/splay 0.0.0-stage → 0.2.0

package/dist/streaming.js

@@ -0,0 +1,422 @@
+/**
+ * Streaming Registry
+ *
+ * Creates a splay-compatible StreamingRegistry for components that
+ * yield multiple outputs over time (live updates, progressive rendering).
+ */
+const setTimer = globalThis.setTimeout;
+const clearTimer = globalThis.clearTimeout;
+// =============================================================================
+// Streaming Registry Implementation
+// =============================================================================
+/**
+ * Create a splay-compatible streaming registry backed by client procedures.
+ *
+ * @param callStreaming - Client's streaming procedure call function
+ * @param options - Registry options
+ * @returns StreamingRegistry instance
+ *
+ * @example
+ * ```typescript
+ * import { stream } from "client";
+ * import { createStreamingRegistry } from "@procedures/splay";
+ *
+ * const registry = createStreamingRegistry(stream, {
+ *   namespace: "live",
+ *   bufferSize: 10,
+ * });
+ *
+ * // Use for live-updating components
+ * for await (const output of registry.get("ticker")!(ctx)) {
+ *   render(output);
+ * }
+ * ```
+ */
+export function createStreamingRegistry(callStreaming, options = {}) {
+    const { namespace, bufferSize = 16 } = options;
+    /**
+     * Build the procedure path for a component type.
+     */
+    function buildPath(type) {
+        const basePath = ["components"];
+        if (namespace) {
+            basePath.push(namespace);
+        }
+        basePath.push(type);
+        return basePath;
+    }
+    /**
+     * Create a streaming renderer for a component type.
+     */
+    function createRenderer(type) {
+        const procedurePath = buildPath(type);
+        return async function* (ctx) {
+            // Build the input for the component procedure
+            const input = {
+                data: ctx.data,
+                size: ctx.size,
+                path: ctx.path,
+                depth: ctx.depth,
+            };
+            // Stream from the procedure
+            const stream = callStreaming(procedurePath, input);
+            // Yield each output with optional buffering
+            let buffer = [];
+            for await (const output of stream) {
+                if (bufferSize <= 1) {
+                    // No buffering - yield immediately
+                    yield output;
+                }
+                else {
+                    // Add to buffer
+                    buffer.push(output);
+                    // Yield when buffer is full
+                    if (buffer.length >= bufferSize) {
+                        // Yield the most recent output (discard older ones)
+                        yield buffer[buffer.length - 1];
+                        buffer = [];
+                    }
+                }
+            }
+            // Yield any remaining buffered output
+            if (buffer.length > 0) {
+                yield buffer[buffer.length - 1];
+            }
+        };
+    }
+    // Cache of created renderers
+    const rendererCache = new Map();
+    return {
+        /**
+         * Get a streaming renderer for a component type.
+         */
+        get(type) {
+            let renderer = rendererCache.get(type);
+            if (renderer) {
+                return renderer;
+            }
+            renderer = createRenderer(type);
+            rendererCache.set(type, renderer);
+            return renderer;
+        },
+        /**
+         * Check if a streaming renderer exists.
+         */
+        has(_type) {
+            return true; // Optimistic - actual check at call time
+        },
+    };
+}
+/**
+ * Create a dual registry supporting both sync and streaming.
+ *
+ * @param callSync - Client's sync procedure call function
+ * @param callStreaming - Client's streaming procedure call function
+ * @param isStreaming - Function to check if a component is streaming
+ * @param options - Registry options
+ * @returns DualRegistry instance
+ */
+export function createDualRegistry(callSync, callStreaming, isStreaming, options = {}) {
+    const { namespace } = options;
+    function buildPath(type) {
+        const basePath = ["components"];
+        if (namespace) {
+            basePath.push(namespace);
+        }
+        basePath.push(type);
+        return basePath;
+    }
+    // Create sync renderer
+    function createSyncRenderer(type) {
+        const path = buildPath(type);
+        return async (ctx) => {
+            return callSync(path, {
+                data: ctx.data,
+                size: ctx.size,
+                path: ctx.path,
+                depth: ctx.depth,
+            });
+        };
+    }
+    // Create streaming renderer
+    function createStreamingRenderer(type) {
+        const path = buildPath(type);
+        return async function* (ctx) {
+            const input = {
+                data: ctx.data,
+                size: ctx.size,
+                path: ctx.path,
+                depth: ctx.depth,
+            };
+            for await (const output of callStreaming(path, input)) {
+                yield output;
+            }
+        };
+    }
+    const syncCache = new Map();
+    const streamingCache = new Map();
+    return {
+        sync: {
+            get(type) {
+                let renderer = syncCache.get(type);
+                if (!renderer) {
+                    renderer = createSyncRenderer(type);
+                    syncCache.set(type, renderer);
+                }
+                return renderer;
+            },
+            has(type) {
+                return !isStreaming(type);
+            },
+        },
+        streaming: {
+            get(type) {
+                let renderer = streamingCache.get(type);
+                if (!renderer) {
+                    renderer = createStreamingRenderer(type);
+                    streamingCache.set(type, renderer);
+                }
+                return renderer;
+            },
+            has(type) {
+                return isStreaming(type);
+            },
+        },
+        async *render(type, ctx, preferStreaming = false) {
+            const shouldStream = preferStreaming || isStreaming(type);
+            if (shouldStream) {
+                const renderer = this.streaming.get(type);
+                if (renderer) {
+                    yield* renderer(ctx);
+                    return;
+                }
+            }
+            // Fall back to sync
+            const syncRenderer = this.sync.get(type);
+            if (syncRenderer) {
+                yield await syncRenderer(ctx);
+            }
+            else {
+                throw new Error(`No renderer found for component type: ${type}`);
+            }
+        },
+    };
+}
+// =============================================================================
+// Stream Utilities
+// =============================================================================
+/** This function ends an iterator and does not wait: a source with a pending item ends after it. */
+function endSource(iterator) {
+    try {
+        void Promise.resolve(iterator.return?.()).catch(() => undefined);
+    }
+    catch {
+        // A source whose return() throws has nothing more to end
+    }
+}
+/**
+ * A queue with one writer and one reader: the reader waits on one wake-up, not on each source.
+ */
+class Mailbox {
+    items = [];
+    wake = null;
+    ended = false;
+    failure = null;
+    push(item) {
+        this.items.push(item);
+        this.notify();
+    }
+    end(failure) {
+        this.ended = true;
+        if (failure)
+            this.failure = failure;
+        this.notify();
+    }
+    get isEnded() {
+        return this.ended;
+    }
+    notify() {
+        const wake = this.wake;
+        this.wake = null;
+        wake?.();
+    }
+    /** The items, then the failure (if any) when the writer has ended. */
+    async *drain() {
+        for (;;) {
+            if (this.items.length > 0) {
+                yield this.items.shift();
+                continue;
+            }
+            if (this.ended) {
+                if (this.failure)
+                    throw this.failure.error;
+                return;
+            }
+            await new Promise((resolve) => {
+                this.wake = resolve;
+            });
+        }
+    }
+}
+/**
+ * Merge multiple component streams into one.
+ * Yields outputs from all streams as they arrive.
+ *
+ * Each source has at most one pending `next()`, and the reader waits on one shared wake-up.
+ * (Before, each round raced the pending promises of all sources: an idle source collected one
+ * reaction per item of the other sources, 81 MiB at 200k items. Deep dive DATA-12.) When the
+ * reader stops, or a source fails, the function ends the other sources.
+ */
+export async function* mergeStreams(...streams) {
+    const iterators = streams.map((stream) => stream[Symbol.asyncIterator]());
+    const active = new Set();
+    const settled = new Mailbox();
+    const pull = (index) => {
+        iterators[index].next().then((result) => settled.push({ index, result }), (error) => settled.push({ index, error }));
+    };
+    iterators.forEach((_, index) => {
+        active.add(index);
+        pull(index);
+    });
+    try {
+        if (active.size === 0)
+            return;
+        for await (const item of settled.drain()) {
+            if ("error" in item) {
+                active.delete(item.index);
+                throw item.error;
+            }
+            if (item.result.done) {
+                active.delete(item.index);
+                if (active.size === 0)
+                    return;
+                continue;
+            }
+            yield item.result.value;
+            // The next item of this source, after the reader took this one
+            pull(item.index);
+        }
+    }
+    finally {
+        for (const index of active)
+            endSource(iterators[index]);
+    }
+}
+/**
+ * Read a source in the background and give each item to `onItem`. `onEnd` runs when the source
+ * ends or fails, before the outputs end. When the reader stops, the source is not read further.
+ */
+async function* timedStream(stream, onItem, onEnd, onStop) {
+    const state = {
+        iterator: stream[Symbol.asyncIterator](),
+        outputs: new Mailbox(),
+        stopped: false,
+    };
+    void (async () => {
+        let failure;
+        try {
+            while (!state.stopped) {
+                const result = await state.iterator.next();
+                if (result.done || state.stopped)
+                    break;
+                onItem(result.value, state);
+            }
+        }
+        catch (error) {
+            failure = { error };
+        }
+        finally {
+            if (!state.stopped)
+                onEnd(state);
+            state.outputs.end(failure);
+        }
+    })();
+    try {
+        yield* state.outputs.drain();
+    }
+    finally {
+        if (!state.outputs.isEnded) {
+            // The reader stopped early: no more reads of the source (deep dive DATA-12)
+            state.stopped = true;
+            onStop();
+            endSource(state.iterator);
+        }
+    }
+}
+/**
+ * Throttle a component stream to emit at most once per interval.
+ *
+ * The first item of an interval goes out at once. The last item that arrives during the
+ * interval goes out when the interval ends. (Before, it waited until the source ended: deep
+ * dive DATA-12.) When the source ends, a waiting item goes out at once.
+ */
+export function throttleStream(stream, intervalMs) {
+    let lastEmit = -Infinity;
+    let pending = null;
+    let timer = null;
+    const stopTimer = () => {
+        if (timer !== null) {
+            clearTimer(timer);
+            timer = null;
+        }
+    };
+    return timedStream(stream, (output, state) => {
+        const now = Date.now();
+        if (timer === null && now - lastEmit >= intervalMs) {
+            lastEmit = now;
+            state.outputs.push(output);
+            return;
+        }
+        pending = { output };
+        if (timer === null) {
+            timer = setTimer(() => {
+                timer = null;
+                if (pending && !state.stopped) {
+                    lastEmit = Date.now();
+                    state.outputs.push(pending.output);
+                    pending = null;
+                }
+            }, Math.max(0, lastEmit + intervalMs - now));
+        }
+    }, (state) => {
+        stopTimer();
+        if (pending) {
+            state.outputs.push(pending.output);
+            pending = null;
+        }
+    }, stopTimer);
+}
+/**
+ * Debounce a component stream to emit only after a quiet period.
+ *
+ * When the stream ends, the last output goes out at once (BUGS-2026-07 H29). When the reader
+ * stops, the source is not read further (deep dive DATA-12).
+ */
+export function debounceStream(stream, waitMs) {
+    let latest = null;
+    let timer = null;
+    const stopTimer = () => {
+        if (timer !== null) {
+            clearTimer(timer);
+            timer = null;
+        }
+    };
+    return timedStream(stream, (output, state) => {
+        latest = { output };
+        stopTimer();
+        timer = setTimer(() => {
+            timer = null;
+            if (latest && !state.stopped) {
+                state.outputs.push(latest.output);
+                latest = null;
+            }
+        }, waitMs);
+    }, (state) => {
+        stopTimer();
+        if (latest) {
+            state.outputs.push(latest.output);
+            latest = null;
+        }
+    }, stopTimer);
+}
+//# sourceMappingURL=streaming.js.map

package/dist/streaming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.js","sourceRoot":"","sources":["../src/streaming.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,MAAM,QAAQ,GAAI,UAA0C,CAAC,UAAU,CAAC;AACxE,MAAM,UAAU,GAAI,UAA0C,CAAC,YAAY,CAAC;AAc5E,gFAAgF;AAChF,oCAAoC;AACpC,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,uBAAuB,CACrC,aAAuC,EACvC,OAAO,GAA6B,EAAE;IAEtC,MAAM,EAAE,SAAS,EAAE,UAAU,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAE/C;;OAEG;IACH,SAAS,SAAS,CAAC,IAAY;QAC7B,MAAM,QAAQ,GAAG,CAAC,YAAY,CAAC,CAAC;QAChC,IAAI,SAAS,EAAE,CAAC;YACd,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,SAAS,cAAc,CAAC,IAAY;QAClC,MAAM,aAAa,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAEtC,OAAO,KAAK,SAAS,CAAC,EAAE,GAAkB;YACxC,8CAA8C;YAC9C,MAAM,KAAK,GAAG;gBACZ,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,KAAK,EAAE,GAAG,CAAC,KAAK;aACjB,CAAC;YAEF,4BAA4B;YAC5B,MAAM,MAAM,GAAG,aAAa,CAAkB,aAAa,EAAE,KAAK,CAAC,CAAC;YAEpE,4CAA4C;YAC5C,IAAI,MAAM,GAAsB,EAAE,CAAC;YAEnC,IAAI,KAAK,EAAE,MAAM,MAAM,IAAI,MAAM,EAAE,CAAC;gBAClC,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;oBACpB,mCAAmC;oBACnC,MAAM,MAAM,CAAC;gBACf,CAAC;qBAAM,CAAC;oBACN,gBAAgB;oBAChB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBAEpB,4BAA4B;oBAC5B,IAAI,MAAM,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;wBAChC,oDAAoD;wBACpD,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;wBACjC,MAAM,GAAG,EAAE,CAAC;oBACd,CAAC;gBACH,CAAC;YACH,CAAC;YAED,sCAAsC;YACtC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;YACnC,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED,6BAA6B;IAC7B,MAAM,aAAa,GAAG,IAAI,GAAG,EAAsC,CAAC;IAEpE,OAAO;QACL;;WAEG;QACH,GAAG,CAAC,IAAY;YACd,IAAI,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,QAAQ,CAAC;YAClB,CAAC;YAED,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;YAChC,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAClC,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED;;WAEG;QACH,GAAG,CAAC,KAAa;YACf,OAAO,IAAI,CAAC,CAAC,yCAAyC;QACxD,CAAC;KACF,CAAC;AACJ,CAAC;AAgCD;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAA2D,EAC3D,aAAuC,EACvC,WAAsC,EACtC,OAAO,GAA6B,EAAE;IAEtC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAE9B,SAAS,SAAS,CAAC,IAAY;QAC7B,MAAM,QAAQ,GAAG,CAAC,YAAY,CAAC,CAAC;QAChC,IAAI,SAAS,EAAE,CAAC;YACd,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,uBAAuB;IACvB,SAAS,kBAAkB,CAAC,IAAY;QACtC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC7B,OAAO,KAAK,EAAE,GAAkB,EAA4B,EAAE;YAC5D,OAAO,QAAQ,CAAkB,IAAI,EAAE;gBACrC,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,KAAK,EAAE,GAAG,CAAC,KAAK;aACjB,CAAC,CAAC;QACL,CAAC,CAAC;IACJ,CAAC;IAED,4BAA4B;IAC5B,SAAS,uBAAuB,CAAC,IAAY;QAC3C,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC7B,OAAO,KAAK,SAAS,CAAC,EAAE,GAAkB;YACxC,MAAM,KAAK,GAAG;gBACZ,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,KAAK,EAAE,GAAG,CAAC,KAAK;aACjB,CAAC;YAEF,IAAI,KAAK,EAAE,MAAM,MAAM,IAAI,aAAa,CAAkB,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;gBACvE,MAAM,MAAM,CAAC;YACf,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,EAA4D,CAAC;IACtF,MAAM,cAAc,GAAG,IAAI,GAAG,EAAsC,CAAC;IAErE,OAAO;QACL,IAAI,EAAE;YACJ,GAAG,CAAC,IAAY;gBACd,IAAI,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACnC,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;oBACpC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;gBAChC,CAAC;gBACD,OAAO,QAAQ,CAAC;YAClB,CAAC;YACD,GAAG,CAAC,IAAY;gBACd,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YAC5B,CAAC;SACF;QAED,SAAS,EAAE;YACT,GAAG,CAAC,IAAY;gBACd,IAAI,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACxC,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,QAAQ,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;oBACzC,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;gBACrC,CAAC;gBACD,OAAO,QAAQ,CAAC;YAClB,CAAC;YACD,GAAG,CAAC,IAAY;gBACd,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;YAC3B,CAAC;SACF;QAED,KAAK,CAAC,CAAC,MAAM,CAAC,IAAY,EAAE,GAAkB,EAAE,eAAe,GAAG,KAAK;YACrE,MAAM,YAAY,GAAG,eAAe,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;YAE1D,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC1C,IAAI,QAAQ,EAAE,CAAC;oBACb,KAAK,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;oBACrB,OAAO;gBACT,CAAC;YACH,CAAC;YAED,oBAAoB;YACpB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACzC,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;YAChC,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,KAAK,CAAC,yCAAyC,IAAI,EAAE,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF,oGAAoG;AACpG,SAAS,SAAS,CAAC,QAAgC;IACjD,IAAI,CAAC;QACH,KAAK,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,yDAAyD;IAC3D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,OAAO;IACM,KAAK,GAAQ,EAAE,CAAC;IACzB,IAAI,GAAwB,IAAI,CAAC;IACjC,KAAK,GAAG,KAAK,CAAC;IACd,OAAO,GAA8B,IAAI,CAAC;IAElD,IAAI,CAAC,IAAO;QACV,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED,GAAG,CAAC,OAA4B;QAC9B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,OAAO;YAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACpC,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAEO,MAAM;QACZ,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,EAAE,EAAE,CAAC;IACX,CAAC;IAED,sEAAsE;IACtE,KAAK,CAAC,CAAC,KAAK;QACV,SAAS,CAAC;YACR,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAG,CAAC;gBAC1B,SAAS;YACX,CAAC;YACD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACf,IAAI,IAAI,CAAC,OAAO;oBAAE,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;gBAC3C,OAAO;YACT,CAAC;YACD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAClC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC;YACtB,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,YAAY,CACjC,GAAG,OAAyC;IAM5C,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;IAC1E,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAW,CAAC;IAEvC,MAAM,IAAI,GAAG,CAAC,KAAa,EAAQ,EAAE;QACnC,SAAS,CAAC,KAAK,CAAE,CAAC,IAAI,EAAE,CAAC,IAAI,CAC3B,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAC3C,CAAC,KAAc,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CACnD,CAAC;IACJ,CAAC,CAAC;IAEF,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE;QAC7B,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAClB,IAAI,CAAC,KAAK,CAAC,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QAC9B,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;YACzC,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;gBACpB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC1B,MAAM,IAAI,CAAC,KAAK,CAAC;YACnB,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBACrB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC1B,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC;oBAAE,OAAO;gBAC9B,SAAS;YACX,CAAC;YACD,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YACxB,+DAA+D;YAC/D,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;YAAS,CAAC;QACT,KAAK,MAAM,KAAK,IAAI,MAAM;YAAE,SAAS,CAAC,SAAS,CAAC,KAAK,CAAE,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC;AASD;;;GAGG;AACH,KAAK,SAAS,CAAC,CAAC,WAAW,CACzB,MAAsC,EACtC,MAA6D,EAC7D,KAAmC,EACnC,MAAkB;IAElB,MAAM,KAAK,GAAgB;QACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE;QACxC,OAAO,EAAE,IAAI,OAAO,EAAmB;QACvC,OAAO,EAAE,KAAK;KACf,CAAC;IAEF,KAAK,CAAC,KAAK,IAAI,EAAE;QACf,IAAI,OAAuC,CAAC;QAC5C,IAAI,CAAC;YACH,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAC3C,IAAI,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO;oBAAE,MAAM;gBACxC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,GAAG,EAAE,KAAK,EAAE,CAAC;QACtB,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,KAAK,CAAC,OAAO;gBAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YACjC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IAEL,IAAI,CAAC;QACH,KAAK,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;YAAS,CAAC;QACT,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAC3B,4EAA4E;YAC5E,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;YACrB,MAAM,EAAE,CAAC;YACT,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAsC,EACtC,UAAkB;IAElB,IAAI,QAAQ,GAAG,CAAC,QAAQ,CAAC;IACzB,IAAI,OAAO,GAAuC,IAAI,CAAC;IACvD,IAAI,KAAK,GAAmB,IAAI,CAAC;IAEjC,MAAM,SAAS,GAAG,GAAS,EAAE;QAC3B,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,UAAU,CAAC,KAAK,CAAC,CAAC;YAClB,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,WAAW,CAChB,MAAM,EACN,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,KAAK,KAAK,IAAI,IAAI,GAAG,GAAG,QAAQ,IAAI,UAAU,EAAE,CAAC;YACnD,QAAQ,GAAG,GAAG,CAAC;YACf,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC3B,OAAO;QACT,CAAC;QACD,OAAO,GAAG,EAAE,MAAM,EAAE,CAAC;QACrB,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,KAAK,GAAG,QAAQ,CAAC,GAAG,EAAE;gBACpB,KAAK,GAAG,IAAI,CAAC;gBACb,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;oBAC9B,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;oBACtB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;oBACnC,OAAO,GAAG,IAAI,CAAC;gBACjB,CAAC;YACH,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;QACR,SAAS,EAAE,CAAC;QACZ,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACnC,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;IACH,CAAC,EACD,SAAS,CACV,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAsC,EACtC,MAAc;IAEd,IAAI,MAAM,GAAuC,IAAI,CAAC;IACtD,IAAI,KAAK,GAAmB,IAAI,CAAC;IAEjC,MAAM,SAAS,GAAG,GAAS,EAAE;QAC3B,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,UAAU,CAAC,KAAK,CAAC,CAAC;YAClB,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,WAAW,CAChB,MAAM,EACN,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QAChB,MAAM,GAAG,EAAE,MAAM,EAAE,CAAC;QACpB,SAAS,EAAE,CAAC;QACZ,KAAK,GAAG,QAAQ,CAAC,GAAG,EAAE;YACpB,KAAK,GAAG,IAAI,CAAC;YACb,IAAI,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;gBAC7B,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAClC,MAAM,GAAG,IAAI,CAAC;YAChB,CAAC;QACH,CAAC,EAAE,MAAM,CAAC,CAAC;IACb,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;QACR,SAAS,EAAE,CAAC;QACZ,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAClC,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;IACH,CAAC,EACD,SAAS,CACV,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Bridge Types
+ *
+ * Types for bridging splay's rendering model with client's procedure system.
+ */
+import type { ComponentOutput, Size } from "./components/index.js";
+/**
+ * Render context passed to component renderers.
+ * Compatible with splay's RenderContext interface.
+ */
+export interface RenderContext<TData = unknown> {
+    /** Data to render */
+    data: TData;
+    /** Available size for rendering */
+    size: Size;
+    /** Path in the render tree */
+    path: string;
+    /** Depth in the render tree */
+    depth: number;
+    /** Render a child component */
+    render: (data: unknown, size: Size, path: string) => ComponentOutput | Promise<ComponentOutput>;
+}
+/**
+ * Component renderer function.
+ */
+export type ComponentRenderer<TOutput = ComponentOutput> = (ctx: RenderContext) => TOutput | Promise<TOutput>;
+/**
+ * Streaming component renderer function.
+ */
+export type StreamingComponentRenderer<TOutput = ComponentOutput> = (ctx: RenderContext) => AsyncIterable<TOutput>;
+/**
+ * Registry interface compatible with splay.
+ */
+export interface Registry<TOutput = ComponentOutput> {
+    /** Get a renderer for a component type */
+    get(type: string): ComponentRenderer<TOutput> | undefined;
+    /** Check if a renderer exists */
+    has(type: string): boolean;
+    /** Register a renderer (throws - use client procedures instead) */
+    register(type: string, renderer: ComponentRenderer<TOutput>): void;
+}
+/**
+ * Streaming registry interface.
+ */
+export interface StreamingRegistry<TOutput = ComponentOutput> {
+    /** Get a streaming renderer for a component type */
+    get(type: string): StreamingComponentRenderer<TOutput> | undefined;
+    /** Check if a renderer exists */
+    has(type: string): boolean;
+}
+/**
+ * Options for creating a client registry.
+ */
+export interface ClientRegistryOptions {
+    /** Namespace prefix for component lookups (e.g., "ui" → "components.ui.{type}") */
+    namespace?: string;
+    /** Default size for components without explicit size */
+    defaultSize?: Size;
+}
+/**
+ * Options for creating a streaming registry.
+ */
+export interface StreamingRegistryOptions extends ClientRegistryOptions {
+    /** Buffer size for streaming backpressure */
+    bufferSize?: number;
+}
+/**
+ * Component map for hydration.
+ * Maps component type names to framework-specific components.
+ */
+export type ComponentMap<TComponent = unknown> = Record<string, TComponent>;
+/**
+ * Hydration options.
+ */
+export interface HydrateOptions<TComponent = unknown> {
+    /** Map of component types to framework components */
+    components: ComponentMap<TComponent>;
+    /** Fallback component for unknown types */
+    fallback?: TComponent;
+    /** Handler for null outputs */
+    onNull?: () => TComponent | null;
+    /** Handler for fragments */
+    onFragment?: (children: TComponent[]) => TComponent;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAMnE;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,KAAK,GAAG,OAAO;IAC5C,qBAAqB;IACrB,IAAI,EAAE,KAAK,CAAC;IACZ,mCAAmC;IACnC,IAAI,EAAE,IAAI,CAAC;IACX,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,KAAK,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACjG;AAMD;;GAEG;AACH,MAAM,MAAM,iBAAiB,CAAC,OAAO,GAAG,eAAe,IAAI,CACzD,GAAG,EAAE,aAAa,KACf,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEhC;;GAEG;AACH,MAAM,MAAM,0BAA0B,CAAC,OAAO,GAAG,eAAe,IAAI,CAClE,GAAG,EAAE,aAAa,KACf,aAAa,CAAC,OAAO,CAAC,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,QAAQ,CAAC,OAAO,GAAG,eAAe;IACjD,0CAA0C;IAC1C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;IAC1D,iCAAiC;IACjC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;CACpE;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,OAAO,GAAG,eAAe;IAC1D,oDAAoD;IACpD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,0BAA0B,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;IACnE,iCAAiC;IACjC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5B;AAMD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,mFAAmF;IACnF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,WAAW,CAAC,EAAE,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,qBAAqB;IACrE,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD;;;GAGG;AACH,MAAM,MAAM,YAAY,CAAC,UAAU,GAAG,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,UAAU,GAAG,OAAO;IAClD,qDAAqD;IACrD,UAAU,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IACrC,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,UAAU,GAAG,IAAI,CAAC;IACjC,4BAA4B;IAC5B,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,UAAU,CAAC;CACrD"}

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * Bridge Types
+ *
+ * Types for bridging splay's rendering model with client's procedure system.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/package.json

@@ -1,6 +1,79 @@
 {
+  "$schema": "https://json.schemastore.org/package",
   "name": "@procedures/splay",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "Render procedure results with splay: a bridge between the client procedures and the splay recursive renderer, with stream helpers.",
+  "keywords": [
+    "splay",
+    "rendering",
+    "components",
+    "streams",
+    "procedures"
+  ],
+  "homepage": "https://mark1russell7.github.io/client/",
+  "bugs": {
+    "url": "https://github.com/mark1russell7/client/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mark1russell7/client.git",
+    "directory": "packages/client-splay"
+  },
+  "license": "MIT",
+  "author": "Mark Russell (https://github.com/mark1russell7)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./module": {
+      "types": "./dist/module.d.ts",
+      "import": "./dist/module.js"
+    },
+    "./register": {
+      "types": "./dist/register.d.ts",
+      "import": "./dist/register.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/__tests__",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": [
+    "./dist/register.js"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "client": {
+    "procedures": "./dist/register.js"
+  },
+  "devDependencies": {
+    "typescript": "^7.0.2",
+    "@types/node": "^22.0.0",
+    "@mark1russell7/cue": "^1.0.0",
+    "vitest": "^5.0.3"
+  },
+  "dependencies": {
+    "@procedures/client": "0.2.0",
+    "@mark1russell7/splay": "^0.1.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .tsbuildinfo",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
 }