@procedures/splay 0.0.0-stage → 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * client-splay
+ *
+ * Bridge between splay's rendering model and client's procedure system.
+ *
+ * This package enables:
+ * - Using client procedures as splay renderers
+ * - Streaming component updates via procedures
+ * - Hydrating serializable descriptors to framework components
+ *
+ * @example
+ * ```typescript
+ * import { call } from "client";
+ * import {
+ *   createClientRegistry,
+ *   createReactHydrate,
+ * } from "@procedures/splay";
+ *
+ * // Create a registry backed by client procedures
+ * const registry = createClientRegistry(call, {
+ *   namespace: "ui",
+ * });
+ *
+ * // Hydrate descriptors to React components
+ * const hydrate = createReactHydrate(React, {
+ *   components: { "user-card": UserCard },
+ * });
+ *
+ * // Render a component
+ * const descriptor = await registry.get("user-card")!(ctx);
+ * const element = hydrate(descriptor);
+ * ```
+ */
+import "./register.js";
+export type { RenderContext, ComponentRenderer, StreamingComponentRenderer, Registry, StreamingRegistry, ClientRegistryOptions, StreamingRegistryOptions, ComponentMap, HydrateOptions, } from "./types.js";
+export { createClientRegistry, createCheckedRegistry, createRenderContext, type ProcedureCaller, } from "./registry.js";
+export { createStreamingRegistry, createDualRegistry, mergeStreams, throttleStream, debounceStream, type StreamingProcedureCaller, type DualRegistry, } from "./streaming.js";
+export { createHydrate, createReactHydrate, walkDescriptor, transformDescriptor, findInDescriptor, getUsedTypes, validateDescriptor, serializeDescriptor, parseDescriptor, compactDescriptor, type CreateElement, type ReactHydrateOptions, } from "./hydrate.js";
+export * from "./components/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAGH,OAAO,eAAe,CAAC;AAMvB,YAAY,EAEV,aAAa,EAGb,iBAAiB,EACjB,0BAA0B,EAC1B,QAAQ,EACR,iBAAiB,EAGjB,qBAAqB,EACrB,wBAAwB,EAGxB,YAAY,EACZ,cAAc,GACf,MAAM,YAAY,CAAC;AAMpB,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AAMvB,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,KAAK,wBAAwB,EAC7B,KAAK,YAAY,GAClB,MAAM,gBAAgB,CAAC;AAMxB,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,KAAK,aAAa,EAClB,KAAK,mBAAmB,GACzB,MAAM,cAAc,CAAC;AAQtB,cAAc,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,54 @@
+/**
+ * client-splay
+ *
+ * Bridge between splay's rendering model and client's procedure system.
+ *
+ * This package enables:
+ * - Using client procedures as splay renderers
+ * - Streaming component updates via procedures
+ * - Hydrating serializable descriptors to framework components
+ *
+ * @example
+ * ```typescript
+ * import { call } from "client";
+ * import {
+ *   createClientRegistry,
+ *   createReactHydrate,
+ * } from "@procedures/splay";
+ *
+ * // Create a registry backed by client procedures
+ * const registry = createClientRegistry(call, {
+ *   namespace: "ui",
+ * });
+ *
+ * // Hydrate descriptors to React components
+ * const hydrate = createReactHydrate(React, {
+ *   components: { "user-card": UserCard },
+ * });
+ *
+ * // Render a component
+ * const descriptor = await registry.get("user-card")!(ctx);
+ * const element = hydrate(descriptor);
+ * ```
+ */
+// Importing the package registers its procedures, as in the other client packages (BUGS-2026-07 H18)
+import "./register.js";
+// =============================================================================
+// Registry
+// =============================================================================
+export { createClientRegistry, createCheckedRegistry, createRenderContext, } from "./registry.js";
+// =============================================================================
+// Streaming
+// =============================================================================
+export { createStreamingRegistry, createDualRegistry, mergeStreams, throttleStream, debounceStream, } from "./streaming.js";
+// =============================================================================
+// Hydration
+// =============================================================================
+export { createHydrate, createReactHydrate, walkDescriptor, transformDescriptor, findInDescriptor, getUsedTypes, validateDescriptor, serializeDescriptor, parseDescriptor, compactDescriptor, } from "./hydrate.js";
+// =============================================================================
+// Components
+// =============================================================================
+// The components: serializable UI descriptors made by procedures. They moved here from
+// "@procedures/client/components" (roadmap 3.4: this is the UI package of the ecosystem).
+export * from "./components/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,qGAAqG;AACrG,OAAO,eAAe,CAAC;AAyBvB,gFAAgF;AAChF,WAAW;AACX,gFAAgF;AAEhF,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,GAEpB,MAAM,eAAe,CAAC;AAEvB,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,cAAc,GAGf,MAAM,gBAAgB,CAAC;AAExB,gFAAgF;AAChF,YAAY;AACZ,gFAAgF;AAEhF,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,GAGlB,MAAM,cAAc,CAAC;AAEtB,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF,uFAAuF;AACvF,0FAA0F;AAC1F,cAAc,uBAAuB,CAAC"}

package/dist/module.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Module (no side effects): the bridge procedures as data, for `createRegistry()`.
+ *
+ * Procedure Registration
+ *
+ * Registers client-splay bridge procedures with the client system.
+ * This file is referenced by package.json's client.procedures field.
+ */
+import { type ProcedureModule } from "@procedures/client";
+/**
+ * The module of this package, for `createRegistry()`: its procedures as data. Importing this
+ * file registers nothing. (`register.ts` registers the same procedures in the global registry.)
+ */
+export declare const splayModule: ProcedureModule;
+export default splayModule;
+//# sourceMappingURL=module.d.ts.map

package/dist/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAkE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AA8D1H;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,eAGxB,CAAC;eAEY,WAAW"}

package/dist/module.js

@@ -0,0 +1,58 @@
+/**
+ * Module (no side effects): the bridge procedures as data, for `createRegistry()`.
+ *
+ * Procedure Registration
+ *
+ * Registers client-splay bridge procedures with the client system.
+ * This file is referenced by package.json's client.procedures field.
+ */
+import { createProcedure, outputSchema, defineModule } from "@procedures/client";
+// =============================================================================
+// Schemas
+// =============================================================================
+const voidSchema = outputSchema();
+const bridgeInfoSchema = outputSchema();
+const healthCheckSchema = outputSchema();
+// =============================================================================
+// Bridge Procedures
+// =============================================================================
+/**
+ * Get package info.
+ */
+const infoProcedure = createProcedure()
+    .path(["splay", "bridge", "info"])
+    .input(voidSchema)
+    .output(bridgeInfoSchema)
+    .meta({ description: "Get client-splay bridge information" })
+    .handler(() => ({
+    name: "@procedures/splay",
+    version: "1.0.0",
+    description: "Bridge between splay and client",
+}))
+    .build();
+/**
+ * Health check for the bridge.
+ */
+const healthProcedure = createProcedure()
+    .path(["splay", "bridge", "health"])
+    .input(voidSchema)
+    .output(healthCheckSchema)
+    .meta({ description: "Health check for client-splay bridge" })
+    .handler(() => ({
+    status: "healthy",
+    timestamp: new Date().toISOString(),
+}))
+    .build();
+// =============================================================================
+// Registration
+// =============================================================================
+/**
+ * The module of this package, for `createRegistry()`: its procedures as data. Importing this
+ * file registers nothing. (`register.ts` registers the same procedures in the global registry.)
+ */
+export const splayModule = defineModule("@procedures/splay", [
+    infoProcedure,
+    healthProcedure,
+]);
+export default splayModule;
+//# sourceMappingURL=module.js.map

package/dist/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../src/module.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAA2C,MAAM,oBAAoB,CAAC;AAiB1H,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF,MAAM,UAAU,GAAG,YAAY,EAAQ,CAAC;AACxC,MAAM,gBAAgB,GAAG,YAAY,EAAc,CAAC;AACpD,MAAM,iBAAiB,GAAG,YAAY,EAAe,CAAC;AAEtD,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,aAAa,GAAG,eAAe,EAAE;KACpC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;KACjC,KAAK,CAAC,UAAU,CAAC;KACjB,MAAM,CAAC,gBAAgB,CAAC;KACxB,IAAI,CAAC,EAAE,WAAW,EAAE,qCAAqC,EAAE,CAAC;KAC5D,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACd,IAAI,EAAE,mBAAmB;IACzB,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE,iCAAiC;CAC/C,CAAC,CAAC;KACF,KAAK,EAAE,CAAC;AAEX;;GAEG;AACH,MAAM,eAAe,GAAG,eAAe,EAAE;KACtC,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;KACnC,KAAK,CAAC,UAAU,CAAC;KACjB,MAAM,CAAC,iBAAiB,CAAC;KACzB,IAAI,CAAC,EAAE,WAAW,EAAE,sCAAsC,EAAE,CAAC;KAC7D,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACd,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;CACpC,CAAC,CAAC;KACF,KAAK,EAAE,CAAC;AAEX,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAoB,YAAY,CAAC,mBAAmB,EAAE;IAC5E,aAA6B;IAC7B,eAA+B;CAChC,CAAC,CAAC;AAEH,eAAe,WAAW,CAAC"}

package/dist/register.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Importing this file registers the bridge procedures of @procedures/splay in the
+ * global registry (DECISIONS-2026-10, "Every package root registers its procedures"). The
+ * procedures as data are in `module.ts`, which registers nothing.
+ */
+export * from "./module.js";
+export declare function registerBridge(): void;
+//# sourceMappingURL=register.d.ts.map

package/dist/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,cAAc,aAAa,CAAC;AAE5B,wBAAgB,cAAc,IAAI,IAAI,CAGrC"}

package/dist/register.js

@@ -0,0 +1,15 @@
+/**
+ * Importing this file registers the bridge procedures of @procedures/splay in the
+ * global registry (DECISIONS-2026-10, "Every package root registers its procedures"). The
+ * procedures as data are in `module.ts`, which registers nothing.
+ */
+import { PROCEDURE_REGISTRY } from "@procedures/client";
+import { splayModule } from "./module.js";
+export * from "./module.js";
+export function registerBridge() {
+    // override: calling the exported function again (after the auto-register) must not throw
+    PROCEDURE_REGISTRY.registerAll(splayModule.procedures, { override: true });
+}
+// Auto-register
+registerBridge();
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,cAAc,aAAa,CAAC;AAE5B,MAAM,UAAU,cAAc;IAC5B,yFAAyF;IACzF,kBAAkB,CAAC,WAAW,CAAC,WAAW,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED,gBAAgB;AAChB,cAAc,EAAE,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Client Registry
+ *
+ * Creates a splay-compatible Registry that delegates to client procedures.
+ * This enables splay's rendering engine to use client's procedure system
+ * for component resolution and execution.
+ */
+import type { Size } from "./components/index.js";
+import type { Registry, RenderContext, ClientRegistryOptions } from "./types.js";
+/**
+ * Type for calling client procedures.
+ * This matches the shape of client's call function.
+ */
+export interface ProcedureCaller {
+    <TResult>(path: string[], input: unknown): Promise<TResult>;
+}
+/**
+ * Create a splay-compatible registry backed by client procedures.
+ *
+ * @param call - Client's procedure call function
+ * @param options - Registry options
+ * @returns Registry instance
+ *
+ * @example
+ * ```typescript
+ * import { call } from "client";
+ * import { createClientRegistry } from "@procedures/splay";
+ *
+ * const registry = createClientRegistry(call, {
+ *   namespace: "ui",
+ *   defaultSize: { width: 800, height: 600 },
+ * });
+ *
+ * // Now pass to splay's renderer
+ * const renderer = createRenderer({ registry });
+ * ```
+ */
+export declare function createClientRegistry(call: ProcedureCaller, options?: ClientRegistryOptions): Registry;
+/**
+ * Create a registry that can check procedure existence.
+ * Requires an additional hasProcedure function from client.
+ *
+ * @param call - Client's procedure call function
+ * @param hasProcedure - Function to check if a procedure exists
+ * @param options - Registry options
+ * @returns Registry with accurate has() checks
+ */
+export declare function createCheckedRegistry(call: ProcedureCaller, hasProcedure: (path: string[]) => boolean, options?: ClientRegistryOptions): Registry;
+/**
+ * Create a render context for calling component procedures.
+ *
+ * @param registry - The registry to use for child renders
+ * @param data - Data to render
+ * @param size - Available size
+ * @param path - Path in render tree
+ * @param depth - Current depth
+ * @returns RenderContext for component procedures
+ */
+export declare function createRenderContext<TData>(registry: Registry, data: TData, size: Size, path?: string, depth?: number): RenderContext<TData>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAmB,IAAI,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EACV,QAAQ,EAER,aAAa,EACb,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAMpB;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7D;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,eAAe,EACrB,OAAO,GAAE,qBAA0B,GAClC,QAAQ,CAgFV;AAMD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,eAAe,EACrB,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,EACzC,OAAO,GAAE,qBAA0B,GAClC,QAAQ,CAuBV;AAMD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EACvC,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,KAAK,EACX,IAAI,EAAE,IAAI,EACV,IAAI,GAAE,MAAe,EACrB,KAAK,GAAE,MAAU,GAChB,aAAa,CAAC,KAAK,CAAC,CA8BtB"}

package/dist/registry.js

@@ -0,0 +1,191 @@
+/**
+ * Client Registry
+ *
+ * Creates a splay-compatible Registry that delegates to client procedures.
+ * This enables splay's rendering engine to use client's procedure system
+ * for component resolution and execution.
+ */
+// =============================================================================
+// Client Registry Implementation
+// =============================================================================
+/**
+ * Create a splay-compatible registry backed by client procedures.
+ *
+ * @param call - Client's procedure call function
+ * @param options - Registry options
+ * @returns Registry instance
+ *
+ * @example
+ * ```typescript
+ * import { call } from "client";
+ * import { createClientRegistry } from "@procedures/splay";
+ *
+ * const registry = createClientRegistry(call, {
+ *   namespace: "ui",
+ *   defaultSize: { width: 800, height: 600 },
+ * });
+ *
+ * // Now pass to splay's renderer
+ * const renderer = createRenderer({ registry });
+ * ```
+ */
+export function createClientRegistry(call, options = {}) {
+    const { namespace } = 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 renderer function for a component type.
+     */
+    function createRenderer(type) {
+        const procedurePath = buildPath(type);
+        return async (ctx) => {
+            // Build the input for the component procedure
+            const input = {
+                data: ctx.data,
+                size: ctx.size,
+                path: ctx.path,
+                depth: ctx.depth,
+            };
+            // Call the procedure
+            const result = await call(procedurePath, input);
+            return result;
+        };
+    }
+    // Cache of created renderers
+    const rendererCache = new Map();
+    return {
+        /**
+         * Get a renderer for a component type.
+         * Creates and caches the renderer on first access.
+         */
+        get(type) {
+            // Check cache first
+            let renderer = rendererCache.get(type);
+            if (renderer) {
+                return renderer;
+            }
+            // Create and cache renderer
+            // Note: We always create a renderer - the procedure may or may not exist
+            // Errors will be thrown at call time if the procedure doesn't exist
+            renderer = createRenderer(type);
+            rendererCache.set(type, renderer);
+            return renderer;
+        },
+        /**
+         * Check if a renderer exists.
+         * Note: This always returns true since we lazily create renderers.
+         * Actual existence is checked at call time.
+         */
+        has(_type) {
+            // We optimistically return true - actual check happens at call time
+            // This matches splay's expectation that has() is a quick check
+            return true;
+        },
+        /**
+         * Register a renderer (not supported - use client procedures).
+         */
+        register(type, _renderer) {
+            throw new Error(`Cannot register renderers directly on ClientRegistry. ` +
+                `Define a component procedure at path: ${buildPath(type).join(".")}`);
+        },
+    };
+}
+// =============================================================================
+// Registry with Existence Check
+// =============================================================================
+/**
+ * Create a registry that can check procedure existence.
+ * Requires an additional hasProcedure function from client.
+ *
+ * @param call - Client's procedure call function
+ * @param hasProcedure - Function to check if a procedure exists
+ * @param options - Registry options
+ * @returns Registry with accurate has() checks
+ */
+export function createCheckedRegistry(call, hasProcedure, options = {}) {
+    const baseRegistry = createClientRegistry(call, options);
+    const { namespace } = options;
+    function buildPath(type) {
+        const basePath = ["components"];
+        if (namespace) {
+            basePath.push(namespace);
+        }
+        basePath.push(type);
+        return basePath;
+    }
+    return {
+        ...baseRegistry,
+        /**
+         * Check if a procedure exists for this component type.
+         */
+        has(type) {
+            return hasProcedure(buildPath(type));
+        },
+    };
+}
+// =============================================================================
+// Render Context Factory
+// =============================================================================
+/**
+ * Create a render context for calling component procedures.
+ *
+ * @param registry - The registry to use for child renders
+ * @param data - Data to render
+ * @param size - Available size
+ * @param path - Path in render tree
+ * @param depth - Current depth
+ * @returns RenderContext for component procedures
+ */
+export function createRenderContext(registry, data, size, path = "root", depth = 0) {
+    return {
+        data,
+        size,
+        path,
+        depth,
+        render: async (childData, childSize, childPath) => {
+            // Determine component type from data
+            const type = getComponentType(childData);
+            if (!type) {
+                throw new Error(`Cannot determine component type for data at ${childPath}`);
+            }
+            const renderer = registry.get(type);
+            if (!renderer) {
+                throw new Error(`No renderer found for component type: ${type}`);
+            }
+            // Create child context
+            const childCtx = createRenderContext(registry, childData, childSize, childPath, depth + 1);
+            return renderer(childCtx);
+        },
+    };
+}
+/**
+ * Extract component type from data.
+ * Looks for a `type` or `__type__` property.
+ */
+function getComponentType(data) {
+    if (data === null || typeof data !== "object") {
+        return null;
+    }
+    const obj = data;
+    // Check for type property
+    const typeValue = obj["type"];
+    if (typeof typeValue === "string") {
+        return typeValue;
+    }
+    // Check for __type__ property (alternative convention)
+    const altTypeValue = obj["__type__"];
+    if (typeof altTypeValue === "string") {
+        return altTypeValue;
+    }
+    return null;
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/streaming.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Streaming Registry
+ *
+ * Creates a splay-compatible StreamingRegistry for components that
+ * yield multiple outputs over time (live updates, progressive rendering).
+ */
+import type { ComponentOutput } from "./components/index.js";
+import type { StreamingRegistry, RenderContext, StreamingRegistryOptions } from "./types.js";
+/**
+ * Type for calling streaming client procedures.
+ * Returns an async iterable of results.
+ */
+export interface StreamingProcedureCaller {
+    <TResult>(path: string[], input: unknown): AsyncIterable<TResult>;
+}
+/**
+ * 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 declare function createStreamingRegistry(callStreaming: StreamingProcedureCaller, options?: StreamingRegistryOptions): StreamingRegistry;
+/**
+ * Combined registry supporting both sync and streaming renderers.
+ */
+export interface DualRegistry {
+    /** Sync registry for single-output components */
+    sync: {
+        get(type: string): ((ctx: RenderContext) => Promise<ComponentOutput>) | undefined;
+        has(type: string): boolean;
+    };
+    /** Streaming registry for multi-output components */
+    streaming: StreamingRegistry;
+    /**
+     * Render a component, automatically choosing sync or streaming.
+     * @param type - Component type
+     * @param ctx - Render context
+     * @param preferStreaming - Prefer streaming if available
+     */
+    render(type: string, ctx: RenderContext, preferStreaming?: boolean): AsyncIterable<ComponentOutput>;
+}
+/**
+ * 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 declare function createDualRegistry(callSync: <T>(path: string[], input: unknown) => Promise<T>, callStreaming: StreamingProcedureCaller, isStreaming: (type: string) => boolean, options?: StreamingRegistryOptions): DualRegistry;
+/**
+ * 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 declare function mergeStreams(...streams: AsyncIterable<ComponentOutput>[]): AsyncIterable<ComponentOutput>;
+/**
+ * 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 declare function throttleStream(stream: AsyncIterable<ComponentOutput>, intervalMs: number): AsyncIterable<ComponentOutput>;
+/**
+ * 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 declare function debounceStream(stream: AsyncIterable<ComponentOutput>, waitMs: number): AsyncIterable<ComponentOutput>;
+//# sourceMappingURL=streaming.d.ts.map

package/dist/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../src/streaming.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EACV,iBAAiB,EAEjB,aAAa,EACb,wBAAwB,EACzB,MAAM,YAAY,CAAC;AAcpB;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;CACnE;AAMD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,wBAAwB,EACvC,OAAO,GAAE,wBAA6B,GACrC,iBAAiB,CAqFnB;AAMD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,IAAI,EAAE;QACJ,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC,GAAG,SAAS,CAAC;QAClF,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;KAC5B,CAAC;IAEF,qDAAqD;IACrD,SAAS,EAAE,iBAAiB,CAAC;IAE7B;;;;;OAKG;IACH,MAAM,CACJ,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,aAAa,EAClB,eAAe,CAAC,EAAE,OAAO,GACxB,aAAa,CAAC,eAAe,CAAC,CAAC;CACnC;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,EAC3D,aAAa,EAAE,wBAAwB,EACvC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,EACtC,OAAO,GAAE,wBAA6B,GACrC,YAAY,CA8Fd;AA+DD;;;;;;;;GAQG;AACH,wBAAuB,YAAY,CACjC,GAAG,OAAO,EAAE,aAAa,CAAC,eAAe,CAAC,EAAE,GAC3C,aAAa,CAAC,eAAe,CAAC,CAwChC;AAqDD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,EACtC,UAAU,EAAE,MAAM,GACjB,aAAa,CAAC,eAAe,CAAC,CA0ChC;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,EACtC,MAAM,EAAE,MAAM,GACb,aAAa,CAAC,eAAe,CAAC,CAiChC"}