@playfast/reform-remote 1.0.2 → 1.2.0

package/README.md

@@ -19,7 +19,7 @@ data — UI-tree patches one way, trigger invocations the other — so there is
 This builds on reform's existing seams: the **`ui` contract** already separates logic from
 presentation, the **`CaptureSink`** already serializes the rendered surface headlessly (the same
 mechanism proofs use), and the **schema-first `ui`** form (`ui(name, { props, events })`) carries
-the wire schemas that make props and trigger payloads typed *and* runtime-validated at the seam.
+the wire schemas that make props and trigger payloads typed _and_ runtime-validated at the seam.
 See [`REMOTE_UI.md`](../../REMOTE_UI.md) for the design.
 
 ## Install
@@ -35,15 +35,15 @@ sockets pair with [`@playfast/reform-remote-node`](https://www.npmjs.com/package
 
 ## Key concepts
 
-| Concept | What it does |
-| --- | --- |
-| `makeRemoteServer(scene)` | Renders a `Scene` to a `WireTree`; `render()`/`renderDiff()` emit full tree/patches; `invoke(handle, payload)` fires a trigger. |
-| `renderWireTree(tree, { views, invoke })` | Folds a `WireTree` back into React using local presentations. |
-| `remoteContract({...})` / `remoteViews<C>({...})` | The trpc-style typesafe seam — server declares the contract, client implements exactly it. |
-| `serve({ scene, transport })` / `connect({ transport, views })` | Bind both ends to any `RemoteTransport`. |
-| `inMemoryTransportPair()` | In-process duplex `RemoteTransport` (the simplest concrete adapter). |
-| `<RemoteUI transport views />` / `useRemoteUI` | React binding that owns connect, subscription, re-render, teardown. |
-| `useConnectionStatus(reporter)` | Reads a transport's live `StatusReporter` status. |
+| Concept                                                         | What it does                                                                                                                    |
+| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
+| `makeRemoteServer(scene)`                                       | Renders a `Scene` to a `WireTree`; `render()`/`renderDiff()` emit full tree/patches; `invoke(handle, payload)` fires a trigger. |
+| `renderWireTree(tree, { views, invoke })`                       | Folds a `WireTree` back into React using local presentations.                                                                   |
+| `remoteContract({...})` / `remoteViews<C>({...})`               | The trpc-style typesafe seam — server declares the contract, client implements exactly it.                                      |
+| `serve({ scene, transport })` / `connect({ transport, views })` | Bind both ends to any `RemoteTransport`.                                                                                        |
+| `inMemoryTransportPair()`                                       | In-process duplex `RemoteTransport` (the simplest concrete adapter).                                                            |
+| `<RemoteUI transport views />` / `useRemoteUI`                  | React binding that owns connect, subscription, re-render, teardown.                                                             |
+| `useConnectionStatus(reporter)`                                 | Reads a transport's live `StatusReporter` status.                                                                               |
 
 ## How it fits together
 
@@ -106,12 +106,12 @@ sockets pair with [`@playfast/reform-remote-node`](https://www.npmjs.com/package
 
 ## Transport adapters
 
-| Package | Role | Built on |
-| --- | --- | --- |
-| `inMemoryTransportPair` (here) | in-process duplex | — |
-| [`@playfast/reform-remote-node`](https://www.npmjs.com/package/@playfast/reform-remote-node) | WebSocket server | `ws` |
-| [`@playfast/reform-remote-bun`](https://www.npmjs.com/package/@playfast/reform-remote-bun) | WebSocket server | `Bun.serve` |
-| [`@playfast/reform-remote-web`](https://www.npmjs.com/package/@playfast/reform-remote-web) | WebSocket client (factory, auto-reconnect) | global `WebSocket` |
+| Package                                                                                      | Role                                       | Built on           |
+| -------------------------------------------------------------------------------------------- | ------------------------------------------ | ------------------ |
+| `inMemoryTransportPair` (here)                                                               | in-process duplex                          | —                  |
+| [`@playfast/reform-remote-node`](https://www.npmjs.com/package/@playfast/reform-remote-node) | WebSocket server                           | `ws`               |
+| [`@playfast/reform-remote-bun`](https://www.npmjs.com/package/@playfast/reform-remote-bun)   | WebSocket server                           | `Bun.serve`        |
+| [`@playfast/reform-remote-web`](https://www.npmjs.com/package/@playfast/reform-remote-web)   | WebSocket client (factory, auto-reconnect) | global `WebSocket` |
 
 ## License
 

package/dist/client.d.ts

@@ -0,0 +1,33 @@
+import { type ReactNode } from 'react';
+import { type MadeView, type UiContract } from '@playfast/reform';
+import { type AnyUi, type UiReflection, type WiredUiManifest, type WireTree } from '@playfast/reform/internal';
+export interface SlotPropsExternalApi {
+    readonly slotKey?: string;
+}
+export type RemoteView = (props: Record<string, unknown>, slots: Record<string, (slotProps?: SlotPropsExternalApi) => ReactNode>, events: Record<string, (payload: unknown) => void>) => ReactNode;
+export interface RegisteredRemoteView {
+    readonly name: string;
+    readonly view: RemoteView;
+}
+type ViewRegistry = Readonly<Record<string, RegisteredRemoteView>>;
+declare const ViewSetContract: unique symbol;
+export type RemoteViewSet<C extends RemoteContract> = ViewRegistry & {
+    readonly [ViewSetContract]: (contract: C) => C;
+};
+type RemoteUi = UiReflection<UiContract, string> & AnyUi & {
+    readonly manifest: WiredUiManifest;
+};
+export type RemoteContract = Readonly<Record<string, RemoteUi>>;
+export declare const remoteContract: <const C extends RemoteContract>(contract: C) => C;
+type RemoteViewFor<U extends RemoteUi> = U extends UiReflection<infer Contract, infer Name> ? MadeView<Contract, Name, U> : never;
+export type RemoteViews<C extends RemoteContract> = {
+    readonly [K in keyof C]: RemoteViewFor<C[K]>;
+};
+export declare const remoteViews: <C extends RemoteContract>(views: RemoteViews<C>) => RemoteViewSet<C>;
+export interface ClientConfig<C extends RemoteContract> {
+    readonly views: RemoteViewSet<C>;
+    readonly invoke: (handle: string, payload: unknown) => void;
+}
+export declare const renderWireTree: <C extends RemoteContract>(tree: WireTree, config: ClientConfig<C>) => ReactNode;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,SAAS,EAAU,MAAM,OAAO,CAAA;AAEvE,OAAO,EAAE,KAAK,QAAQ,EAAM,KAAK,UAAU,EAAiC,MAAM,kBAAkB,CAAA;AACpG,OAAO,EAEL,KAAK,KAAK,EACV,KAAK,YAAY,EACjB,KAAK,eAAe,EAGpB,KAAK,QAAQ,EACd,MAAM,2BAA2B,CAAA;AAElC,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,MAAM,UAAU,GAAG,CACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,oBAAoB,KAAK,SAAS,CAAC,EACtE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC,KAC/C,SAAS,CAAA;AAEd,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAC1B;AAED,KAAK,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAA;AAElE,QAAA,MAAM,eAAe,EAAE,OAAO,MAAsD,CAAA;AAEpF,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,cAAc,IAAI,YAAY,GAAG;IACnE,QAAQ,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAA;CAC/C,CAAA;AAED,KAAK,QAAQ,GAAG,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG,KAAK,GAAG;IAAE,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAA;CAAE,CAAA;AACjG,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAA;AAE/D,eAAO,MAAM,cAAc,GAAI,KAAK,CAAC,CAAC,SAAS,cAAc,EAAE,UAAU,CAAC,KAAG,CAAa,CAAA;AAE1F,KAAK,aAAa,CAAC,CAAC,SAAS,QAAQ,IACnC,CAAC,SAAS,YAAY,CAAC,MAAM,QAAQ,EAAE,MAAM,IAAI,CAAC,GAAG,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,KAAK,CAAA;AAC1F,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,cAAc,IAAI;IAClD,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC7C,CAAA;AAwCD,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,cAAc,EAAE,OAAO,WAAW,CAAC,CAAC,CAAC,KAAG,aAAa,CAAC,CAAC,CAS5F,CAAA;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,cAAc;IACpD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;IAChC,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;CAC5D;AAiFD,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,cAAc,EACrD,MAAM,QAAQ,EACd,QAAQ,YAAY,CAAC,CAAC,CAAC,KACtB,SAOA,CAAA"}

package/dist/client.js

@@ -0,0 +1,80 @@
+import { createElement, Fragment, useRef } from 'react';
+import { Effect, Record as Rec, Schema } from 'effect';
+import { Ui, UiViewContract } from '@playfast/reform';
+import { Wire, } from '@playfast/reform/internal';
+const ViewSetContract = Symbol.for('reform-remote/view-set-contract');
+export const remoteContract = (contract) => contract;
+function bindSlots(slots) {
+    return slots;
+}
+function bindEvents(events) {
+    return events;
+}
+const registerView = (view) => view.capture((exact) => {
+    const contract = exact[UiViewContract];
+    const propsReflection = contract.manifest.props;
+    if (propsReflection === undefined) {
+        return Effect.runSync(Effect.dieMessage(`reform-remote: view ${contract.manifest.name} needs a wire props schema`));
+    }
+    const propsSchema = Schema.make(propsReflection.ast);
+    return {
+        name: contract.manifest.name,
+        view: (encoded, slots, events) => exact(Schema.decodeUnknownSync(propsSchema)(encoded), bindSlots(slots), bindEvents(events)),
+    };
+});
+export const remoteViews = (views) => {
+    const madeViews = Object.values(views);
+    const byName = Rec.fromEntries(madeViews.map((view) => {
+        const entry = registerView(view);
+        return [entry.name, entry];
+    }));
+    return { ...byName, [ViewSetContract]: (contract) => contract };
+};
+const WireNodeView = ({ node, tree, config }) => {
+    // Stable slot closures read current inputs through this ref.
+    const latest = useRef({ node, tree, config });
+    latest.current = { node, tree, config };
+    // Fresh slot component types remount descendants and reset their hooks.
+    const slotCache = useRef({});
+    const registered = config.views[node.name];
+    if (registered === undefined) {
+        return null;
+    }
+    const encoded = Rec.fromEntries(node.props.flatMap((prop) => prop._tag === 'Data' ? [[prop.name, prop.value]] : []));
+    const eventEntries = node.props.flatMap((prop) => {
+        if (prop._tag !== 'Event') {
+            return [];
+        }
+        return [[prop.name, (payload) => config.invoke(prop.handle, payload)]];
+    });
+    const events = Rec.fromEntries(eventEntries);
+    // slotKey selects one wire child; omitting it renders every child in the slot.
+    const slotFor = (slotName) => {
+        const cached = slotCache.current[slotName];
+        if (cached !== undefined) {
+            return cached;
+        }
+        const stable = (slotProps) => {
+            const { node: currentNode, tree: currentTree, config: currentConfig } = latest.current;
+            const requestedKey = slotProps?.slotKey;
+            return createElement(Fragment, null, ...Wire.childrenOf(currentTree, currentNode.id)
+                .filter((child) => child.slot === slotName)
+                .filter((child) => requestedKey === undefined || child.key === requestedKey)
+                .map((child) => createElement(WireNodeView, {
+                key: child.id,
+                node: child,
+                tree: currentTree,
+                config: currentConfig,
+            })));
+        };
+        slotCache.current[slotName] = stable;
+        return stable;
+    };
+    // Empty slots must still produce a callable component, not an invalid undefined element type.
+    const slots = new Proxy(Object.create(null), {
+        get: (_target, key) => (typeof key === 'string' ? slotFor(key) : undefined),
+    });
+    return registered.view(encoded, slots, events);
+};
+export const renderWireTree = (tree, config) => createElement(Fragment, null, ...Wire.roots(tree).map((node) => createElement(WireNodeView, { key: node.id, node, tree, config })));
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAkB,MAAM,EAAE,MAAM,OAAO,CAAA;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,GAAG,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AACtD,OAAO,EAAiB,EAAE,EAAmB,cAAc,EAAiB,MAAM,kBAAkB,CAAA;AACpG,OAAO,EAKL,IAAI,GAGL,MAAM,2BAA2B,CAAA;AAmBlC,MAAM,eAAe,GAAkB,MAAM,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAA;AASpF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAiC,QAAW,EAAK,EAAE,CAAC,QAAQ,CAAA;AAY1F,SAAS,SAAS,CAAC,KAAkB;IACnC,OAAO,KAAK,CAAA;AACd,CAAC;AAGD,SAAS,UAAU,CAAC,MAAoB;IACtC,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,YAAY,GAAG,CAAC,IAAiB,EAAwB,EAAE,CAC/D,IAAI,CAAC,OAAO,CACV,CAAgE,KAAwB,EAAE,EAAE;IAC1F,MAAM,QAAQ,GAAG,KAAK,CAAC,cAAc,CAAC,CAAA;IACtC,MAAM,eAAe,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAA;IAC/C,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,MAAM,CAAC,OAAO,CACnB,MAAM,CAAC,UAAU,CACf,uBAAuB,QAAQ,CAAC,QAAQ,CAAC,IAAI,4BAA4B,CAC1E,CACF,CAAA;IACH,CAAC;IACD,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAsB,eAAe,CAAC,GAAG,CAAC,CAAA;IACzE,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI;QAC5B,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAC/B,KAAK,CACH,MAAM,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,EAC9C,SAAS,CAAI,KAAK,CAAC,EACnB,UAAU,CAAI,MAAM,CAAC,CACtB;KACJ,CAAA;AACH,CAAC,CACF,CAAA;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,CAA2B,KAAqB,EAAoB,EAAE;IAC/F,MAAM,SAAS,GAA+B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAClE,MAAM,MAAM,GAAiB,GAAG,CAAC,WAAW,CAC1C,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAA2C,EAAE;QAC9D,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAA;QAChC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IAC5B,CAAC,CAAC,CACH,CAAA;IACD,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC,QAAW,EAAK,EAAE,CAAC,QAAQ,EAAE,CAAA;AACvE,CAAC,CAAA;AAkBD,MAAM,YAAY,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAqB,EAAa,EAAE;IAC5E,6DAA6D;IAC7D,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;IAC7C,MAAM,CAAC,OAAO,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;IACvC,wEAAwE;IACxE,MAAM,SAAS,GAAG,MAAM,CAAkC,EAAE,CAAC,CAAA;IAE7D,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC1C,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,OAAO,GAA4B,GAAG,CAAC,WAAW,CACtD,IAAI,CAAC,KAAK,CAAC,OAAO,CAChB,CAAC,IAAI,EAA6C,EAAE,CAClD,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CACxD,CACF,CAAA;IACD,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CACrC,CAAC,IAAI,EAAgE,EAAE;QACrE,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC1B,OAAO,EAAE,CAAA;QACX,CAAC;QACD,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,OAAgB,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;IACjF,CAAC,CACF,CAAA;IACD,MAAM,MAAM,GAA+C,GAAG,CAAC,WAAW,CAAC,YAAY,CAAC,CAAA;IAExF,+EAA+E;IAC/E,MAAM,OAAO,GAAG,CAAC,QAAgB,EAAqD,EAAE;QACtF,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QAC1C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,MAAM,CAAA;QACf,CAAC;QACD,MAAM,MAAM,GAAG,CAAC,SAAgC,EAAa,EAAE;YAC7D,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,CAAC,OAAO,CAAA;YACtF,MAAM,YAAY,GAAG,SAAS,EAAE,OAAO,CAAA;YACvC,OAAO,aAAa,CAClB,QAAQ,EACR,IAAI,EACJ,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,WAAW,CAAC,EAAE,CAAC;iBAC5C,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;iBAC1C,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,KAAK,YAAY,CAAC;iBAC3E,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CACb,aAAa,CAAC,YAAY,EAAE;gBAC1B,GAAG,EAAE,KAAK,CAAC,EAAE;gBACb,IAAI,EAAE,KAAK;gBACX,IAAI,EAAE,WAAW;gBACjB,MAAM,EAAE,aAAa;aACtB,CAAC,CACH,CACJ,CAAA;QACH,CAAC,CAAA;QACD,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAA;QACpC,OAAO,MAAM,CAAA;IACf,CAAC,CAAA;IAED,8FAA8F;IAC9F,MAAM,KAAK,GAAoE,IAAI,KAAK,CACtF,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EACnB;QACE,GAAG,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;KAC5E,CACF,CAAA;IAED,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;AAChD,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,IAAc,EACd,MAAuB,EACZ,EAAE,CACb,aAAa,CACX,QAAQ,EACR,IAAI,EACJ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAC/B,aAAa,CAAC,YAAY,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAClE,CACF,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export * as Server from './server.js';
+export * as Client from './client.js';
+export * as Transport from './transport.js';
+export * as Memory from './memory.js';
+export * as React from './react.js';
+export { makeRemoteServer, type RemoteServer, renderSceneToWire } from './server.js';
+export { type ClientConfig, type RegisteredRemoteView, type RemoteContract, remoteContract, type RemoteView, type RemoteViews, type RemoteViewSet, remoteViews, renderWireTree, } from './client.js';
+export { type ClientBinding, connect, type ConnectOptions, type InvokeMessage, type PatchesMessage, type RemoteTransport, serve, type ServeOptions, serveShared, type ServeSharedOptions, type ServerBinding, type ServerMessage, type SharedClientHandle, type SharedServerBinding, type SnapshotMessage, } from './transport.js';
+export { inMemoryTransportPair, type TransportPair } from './memory.js';
+export { RemoteUI, type RemoteUIProps, type StatusReporter, useConnectionStatus, useRemoteUI, } from './react.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,OAAO,KAAK,MAAM,MAAM,UAAU,CAAA;AAClC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAA;AAClC,OAAO,KAAK,SAAS,MAAM,aAAa,CAAA;AACxC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAA;AAClC,OAAO,KAAK,KAAK,MAAM,SAAS,CAAA;AAEhC,OAAO,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AACjF,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,cAAc,EACd,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,WAAW,EACX,cAAc,GACf,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,KAAK,aAAa,EAClB,OAAO,EACP,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,EACL,KAAK,YAAY,EACjB,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,eAAe,GACrB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,qBAAqB,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAA;AACpE,OAAO,EACL,QAAQ,EACR,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,mBAAmB,EACnB,WAAW,GACZ,MAAM,SAAS,CAAA"}

package/dist/index.js

@@ -0,0 +1,11 @@
+export * as Server from './server.js';
+export * as Client from './client.js';
+export * as Transport from './transport.js';
+export * as Memory from './memory.js';
+export * as React from './react.js';
+export { makeRemoteServer, renderSceneToWire } from './server.js';
+export { remoteContract, remoteViews, renderWireTree, } from './client.js';
+export { connect, serve, serveShared, } from './transport.js';
+export { inMemoryTransportPair } from './memory.js';
+export { RemoteUI, useConnectionStatus, useRemoteUI, } from './react.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,OAAO,KAAK,MAAM,MAAM,UAAU,CAAA;AAClC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAA;AAClC,OAAO,KAAK,SAAS,MAAM,aAAa,CAAA;AACxC,OAAO,KAAK,MAAM,MAAM,UAAU,CAAA;AAClC,OAAO,KAAK,KAAK,MAAM,SAAS,CAAA;AAEhC,OAAO,EAAE,gBAAgB,EAAqB,iBAAiB,EAAE,MAAM,UAAU,CAAA;AACjF,OAAO,EAIL,cAAc,EAId,WAAW,EACX,cAAc,GACf,MAAM,UAAU,CAAA;AACjB,OAAO,EAEL,OAAO,EAKP,KAAK,EAEL,WAAW,GAOZ,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,qBAAqB,EAAsB,MAAM,UAAU,CAAA;AACpE,OAAO,EACL,QAAQ,EAGR,mBAAmB,EACnB,WAAW,GACZ,MAAM,SAAS,CAAA"}

package/dist/memory.d.ts

@@ -0,0 +1,7 @@
+import type { RemoteTransport } from './transport.js';
+export interface TransportPair<Server, Client> {
+    readonly server: RemoteTransport<Server, Client>;
+    readonly client: RemoteTransport<Client, Server>;
+}
+export declare const inMemoryTransportPair: <Server, Client>() => TransportPair<Server, Client>;
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAElD,MAAM,WAAW,aAAa,CAAC,MAAM,EAAE,MAAM;IAC3C,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChD,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjD;AAED,eAAO,MAAM,qBAAqB,GAAI,MAAM,EAAE,MAAM,OAAK,aAAa,CAAC,MAAM,EAAE,MAAM,CAmBpF,CAAA"}

package/dist/memory.js

@@ -0,0 +1,21 @@
+export const inMemoryTransportPair = () => {
+    const serverHandlers = new Set();
+    const clientHandlers = new Set();
+    return {
+        server: {
+            send: (message) => clientHandlers.forEach((handler) => handler(message)),
+            onMessage: (handler) => {
+                serverHandlers.add(handler);
+                return () => void serverHandlers.delete(handler);
+            },
+        },
+        client: {
+            send: (message) => serverHandlers.forEach((handler) => handler(message)),
+            onMessage: (handler) => {
+                clientHandlers.add(handler);
+                return () => void clientHandlers.delete(handler);
+            },
+        },
+    };
+};
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAkD,EAAE;IACvF,MAAM,cAAc,GAAG,IAAI,GAAG,EAA6B,CAAA;IAC3D,MAAM,cAAc,GAAG,IAAI,GAAG,EAA6B,CAAA;IAC3D,OAAO;QACL,MAAM,EAAE;YACN,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACxE,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;gBACrB,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;gBAC3B,OAAO,GAAG,EAAE,CAAC,KAAK,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;YAClD,CAAC;SACF;QACD,MAAM,EAAE;YACN,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACxE,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;gBACrB,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;gBAC3B,OAAO,GAAG,EAAE,CAAC,KAAK,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;YAClD,CAAC;SACF;KACF,CAAA;AACH,CAAC,CAAA"}

package/dist/react.d.ts

@@ -0,0 +1,15 @@
+import { type ReactNode } from 'react';
+import { type InvokeMessage, type RemoteTransport, type ServerMessage } from './transport.js';
+import type { RemoteContract, RemoteViewSet } from './client.js';
+export declare const useRemoteUI: <C extends RemoteContract>(transport: RemoteTransport<InvokeMessage, ServerMessage>, views: RemoteViewSet<C>) => ReactNode;
+export interface RemoteUIProps<C extends RemoteContract> {
+    readonly transport: RemoteTransport<InvokeMessage, ServerMessage>;
+    readonly views: RemoteViewSet<C>;
+}
+export declare const RemoteUI: <C extends RemoteContract>({ transport, views, }: RemoteUIProps<C>) => ReactNode;
+export interface StatusReporter<S> {
+    readonly status: () => S;
+    readonly onStatusChange: (listener: () => void) => () => void;
+}
+export declare const useConnectionStatus: <S>(reporter: StatusReporter<S>) => S;
+//# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAA6C,MAAM,OAAO,CAAA;AACjF,OAAO,EAAW,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AACnG,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAE7D,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,cAAc,EAClD,WAAW,eAAe,CAAC,aAAa,EAAE,aAAa,CAAC,EACxD,OAAO,aAAa,CAAC,CAAC,CAAC,KACtB,SAKF,CAAA;AAED,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,cAAc;IACrD,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC,aAAa,EAAE,aAAa,CAAC,CAAA;IACjE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;CACjC;AAED,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,cAAc,EAAE,uBAGhD,aAAa,CAAC,CAAC,CAAC,KAAG,SAA0C,CAAA;AAEhE,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxB,QAAQ,CAAC,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAA;CAC9D;AAED,eAAO,MAAM,mBAAmB,GAAI,CAAC,EAAE,UAAU,cAAc,CAAC,CAAC,CAAC,KAAG,CACY,CAAA"}

package/dist/react.js

@@ -0,0 +1,11 @@
+import { useEffect, useState, useSyncExternalStore } from 'react';
+import { connect } from './transport.js';
+export const useRemoteUI = (transport, views) => {
+    const [binding] = useState(() => connect({ transport, views }));
+    useEffect(() => () => binding.dispose(), [binding]);
+    useSyncExternalStore(binding.subscribe, binding.snapshot, binding.snapshot);
+    return binding.node();
+};
+export const RemoteUI = ({ transport, views, }) => useRemoteUI(transport, views);
+export const useConnectionStatus = (reporter) => useSyncExternalStore(reporter.onStatusChange, reporter.status, reporter.status);
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,SAAS,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAA;AACjF,OAAO,EAAE,OAAO,EAAgE,MAAM,aAAa,CAAA;AAGnG,MAAM,CAAC,MAAM,WAAW,GAAG,CACzB,SAAwD,EACxD,KAAuB,EACZ,EAAE;IACb,MAAM,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;IAC/D,SAAS,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAA;IACnD,oBAAoB,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC3E,OAAO,OAAO,CAAC,IAAI,EAAE,CAAA;AACvB,CAAC,CAAA;AAOD,MAAM,CAAC,MAAM,QAAQ,GAAG,CAA2B,EACjD,SAAS,EACT,KAAK,GACY,EAAa,EAAE,CAAC,WAAW,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;AAOhE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAI,QAA2B,EAAK,EAAE,CACvE,oBAAoB,CAAC,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA"}

package/dist/server.d.ts

@@ -0,0 +1,16 @@
+import { Effect, type ParseResult } from 'effect';
+import { type CapturedScene, type UiContract } from '@playfast/reform';
+import { type AnyScene, type WirePatch, type WireTree } from '@playfast/reform/internal';
+import { type RenderSceneToWireOptions } from './wireRender.js';
+export type { RenderSceneToWireOptions } from './wireRender.js';
+export declare const renderSceneToWire: <C extends UiContract, S extends ReadonlyArray<unknown>, Services, P, N extends string, Identity>(scene: CapturedScene<C, S, Services, P, N, Identity>, options?: RenderSceneToWireOptions) => Effect.Effect<WireTree, ParseResult.ParseError, Services>;
+export interface RemoteServer {
+    readonly render: () => Promise<WireTree>;
+    readonly renderDiff: () => Promise<ReadonlyArray<WirePatch>>;
+    readonly invoke: (handle: string, encodedPayload: unknown) => Promise<void>;
+    readonly subscribe: (listener: () => void) => () => void;
+    readonly currentTree: () => WireTree;
+    readonly dispose: () => Promise<void>;
+}
+export declare const makeRemoteServer: (scene: AnyScene) => RemoteServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EAIN,KAAK,WAAW,EAGjB,MAAM,QAAQ,CAAA;AACf,OAAO,EAAE,KAAK,aAAa,EAAsB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC1F,OAAO,EACL,KAAK,QAAQ,EAKb,KAAK,SAAS,EACd,KAAK,QAAQ,EACd,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAGL,KAAK,wBAAwB,EAG9B,MAAM,cAAc,CAAA;AAGrB,YAAY,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAA;AAG5D,eAAO,MAAM,iBAAiB,GAC5B,CAAC,SAAS,UAAU,EACpB,CAAC,SAAS,aAAa,CAAC,OAAO,CAAC,EAChC,QAAQ,EACR,CAAC,EACD,CAAC,SAAS,MAAM,EAChB,QAAQ,EAER,OAAO,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,EACpD,UAAU,wBAAwB,KACjC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,UAAU,EAAE,QAAQ,CAUxD,CAAA;AAEH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAA;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAA;IAC5D,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3E,QAAQ,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAA;IACxD,QAAQ,CAAC,WAAW,EAAE,MAAM,QAAQ,CAAA;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACtC;AA2GD,eAAO,MAAM,gBAAgB,GAAI,OAAO,QAAQ,KAAG,YAYhD,CAAA"}

package/dist/server.js

@@ -0,0 +1,56 @@
+import { Effect, Layer, ManagedRuntime, Option, PubSub, Queue, } from 'effect';
+import { forceSync, publish } from '@playfast/reform';
+import { Bus, Triggers, Wire, } from '@playfast/reform/internal';
+import { capturedSlotProvider, renderCapturedComposition, renderSceneWith, serviceFromContext, } from './wireRender.js';
+import { handlesOf, settleDrain } from './wireNode.js';
+// oxlint-disable-next-line reform-rules/prefer-effect-fn -- exported binding: Effect.fn's inferred type isn't portable under isolatedDeclarations
+export const renderSceneToWire = (scene, options) => Effect.context().pipe(Effect.flatMap((context) => renderSceneWith(scene, options, (slotDefinition) => capturedSlotProvider(context, slotDefinition), (composition, props) => renderCapturedComposition(context, composition, props))));
+const makeCapturedRemoteServer = (scene) => {
+    const layer = scene.provide.reduce((acc, provided) => Layer.merge(acc, provided));
+    const runtime = ManagedRuntime.make(layer);
+    const registry = forceSync(() => runtime.runSync(Triggers.make));
+    const context = forceSync(() => runtime.runSync(Effect.context()));
+    const busFromContext = serviceFromContext(context, Bus, 'reform-remote: scene does not provide Bus');
+    const renderEffect = settleDrain.pipe(Effect.zipRight(renderSceneWith(scene, { register: registry.register }, (slotDefinition) => capturedSlotProvider(context, slotDefinition), (composition, props) => renderCapturedComposition(context, composition, props))));
+    const changeListeners = new Set();
+    const notifyChange = () => {
+        changeListeners.forEach((listener) => listener());
+    };
+    runtime.runFork(Effect.scoped(Effect.gen(function* () {
+        const bus = yield* busFromContext;
+        const subscription = yield* PubSub.subscribe(bus);
+        // The transport debounces; settling here would perturb the drain's scheduling.
+        yield* Queue.take(subscription).pipe(Effect.zipRight(Effect.sync(notifyChange)), Effect.forever);
+    })));
+    runtime.runSync(Effect.forEach(Option.getOrElse(Option.fromNullable(scene.boot), () => []), (event) => busFromContext.pipe(Effect.flatMap((bus) => publish('High', event).pipe(Effect.provideService(Bus, bus))))));
+    const frame = { tree: [] };
+    const render = () => runtime.runPromise(renderEffect.pipe(Effect.tap((tree) => Effect.sync(() => {
+        frame.tree = tree;
+    }))));
+    const renderDiff = () => runtime.runPromise(Effect.gen(function* () {
+        const next = yield* renderEffect;
+        const previous = frame.tree;
+        const patches = Wire.diff(previous, next);
+        frame.tree = next;
+        const nextIds = new Set(next.map((node) => node.id));
+        const staleHandles = previous.filter((node) => !nextIds.has(node.id)).flatMap(handlesOf);
+        yield* Effect.forEach(staleHandles, (handle) => registry.revoke(handle));
+        return patches;
+    }));
+    return {
+        render,
+        renderDiff,
+        invoke: (handle, encodedPayload) => runtime.runPromise(Effect.gen(function* () {
+            yield* registry.invoke(handle, encodedPayload);
+            yield* settleDrain;
+        })),
+        subscribe: (listener) => {
+            changeListeners.add(listener);
+            return () => void changeListeners.delete(listener);
+        },
+        currentTree: () => frame.tree,
+        dispose: () => runtime.dispose(),
+    };
+};
+export const makeRemoteServer = (scene) => scene.captureAny((exactScene) => makeCapturedRemoteServer(exactScene));
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,KAAK,EACL,cAAc,EACd,MAAM,EAEN,MAAM,EACN,KAAK,GACN,MAAM,QAAQ,CAAA;AACf,OAAO,EAAsB,SAAS,EAAE,OAAO,EAAmB,MAAM,kBAAkB,CAAA;AAC1F,OAAO,EAEL,GAAG,EACH,QAAQ,EAER,IAAI,GAGL,MAAM,2BAA2B,CAAA;AAClC,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EAEzB,eAAe,EACf,kBAAkB,GACnB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAInD,kJAAkJ;AAClJ,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAQ/B,KAAoD,EACpD,OAAkC,EACyB,EAAE,CAC7D,MAAM,CAAC,OAAO,EAAY,CAAC,IAAI,CAC7B,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CACzB,eAAe,CACb,KAAK,EACL,OAAO,EACP,CAAC,cAAc,EAAE,EAAE,CAAC,oBAAoB,CAAC,OAAO,EAAE,cAAc,CAAC,EACjE,CAAC,WAAW,EAAE,KAAK,EAAE,EAAE,CAAC,yBAAyB,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,CAAC,CAC/E,CACF,CACF,CAAA;AAWH,MAAM,wBAAwB,GAAG,CAQ/B,KAAoD,EACtC,EAAE;IAChB,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAA;IACjF,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC1C,MAAM,QAAQ,GAAuB,SAAS,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;IACpF,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAY,CAAC,CAAC,CAAA;IAC5E,MAAM,cAAc,GAAG,kBAAkB,CACvC,OAAO,EACP,GAAG,EACH,2CAA2C,CAC5C,CAAA;IAED,MAAM,YAAY,GAAG,WAAW,CAAC,IAAI,CACnC,MAAM,CAAC,QAAQ,CACb,eAAe,CACb,KAAK,EACL,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAC/B,CAAC,cAAc,EAAE,EAAE,CAAC,oBAAoB,CAAC,OAAO,EAAE,cAAc,CAAC,EACjE,CAAC,WAAW,EAAE,KAAK,EAAE,EAAE,CAAC,yBAAyB,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,CAAC,CAC/E,CACF,CACF,CAAA;IAED,MAAM,eAAe,GAAG,IAAI,GAAG,EAAc,CAAA;IAC7C,MAAM,YAAY,GAAG,GAAS,EAAE;QAC9B,eAAe,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAA;IACnD,CAAC,CAAA;IACD,OAAO,CAAC,OAAO,CACb,MAAM,CAAC,MAAM,CACX,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,cAAc,CAAA;QACjC,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;QACjD,+EAA+E;QAC/E,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAClC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,EAC1C,MAAM,CAAC,OAAO,CACf,CAAA;IACH,CAAC,CAAC,CACH,CACF,CAAA;IAED,OAAO,CAAC,OAAO,CACb,MAAM,CAAC,OAAO,CACZ,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAC3D,CAAC,KAAK,EAAE,EAAE,CACR,cAAc,CAAC,IAAI,CACjB,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CACtF,CACJ,CACF,CAAA;IAED,MAAM,KAAK,GAAuB,EAAE,IAAI,EAAE,EAAE,EAAE,CAAA;IAE9C,MAAM,MAAM,GAAG,GAAsB,EAAE,CACrC,OAAO,CAAC,UAAU,CAChB,YAAY,CAAC,IAAI,CACf,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAClB,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;QACf,KAAK,CAAC,IAAI,GAAG,IAAI,CAAA;IACnB,CAAC,CAAC,CACH,CACF,CACF,CAAA;IAEH,MAAM,UAAU,GAAG,GAAsC,EAAE,CACzD,OAAO,CAAC,UAAU,CAChB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,YAAY,CAAA;QAChC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAA;QAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;QACzC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAA;QACjB,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;QACpD,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;QACxF,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAA;QACxE,OAAO,OAAO,CAAA;IAChB,CAAC,CAAC,CACH,CAAA;IAEH,OAAO;QACL,MAAM;QACN,UAAU;QACV,MAAM,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,CACjC,OAAO,CAAC,UAAU,CAChB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClB,KAAK,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;YAC9C,KAAK,CAAC,CAAC,WAAW,CAAA;QACpB,CAAC,CAAC,CACH;QACH,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE;YACtB,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YAC7B,OAAO,GAAG,EAAE,CAAC,KAAK,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QACpD,CAAC;QACD,WAAW,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI;QAC7B,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE;KACjC,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAe,EAAgB,EAAE,CAChE,KAAK,CAAC,UAAU,CACd,CAQE,UAAyD,EACzD,EAAE,CAAC,wBAAwB,CAAC,UAAU,CAAC,CAC1C,CAAA"}

package/dist/transport.d.ts

@@ -0,0 +1,53 @@
+import type { ReactNode } from 'react';
+import { type AnyScene, type WirePatch, type WireTree } from '@playfast/reform/internal';
+import { type RemoteContract, type RemoteViewSet } from './client.js';
+export interface SnapshotMessage {
+    readonly _tag: 'Snapshot';
+    readonly tree: WireTree;
+}
+export interface PatchesMessage {
+    readonly _tag: 'Patches';
+    readonly patches: ReadonlyArray<WirePatch>;
+}
+export type ServerMessage = SnapshotMessage | PatchesMessage;
+export interface InvokeMessage {
+    readonly _tag: 'Invoke';
+    readonly handle: string;
+    readonly payload: unknown;
+}
+export interface RemoteTransport<Out, In> {
+    readonly send: (message: Out) => void;
+    readonly onMessage: (handler: (message: In) => void) => () => void;
+}
+export interface ServerBinding {
+    readonly start: () => Promise<void>;
+    readonly dispose: () => Promise<void>;
+}
+export interface ServeOptions {
+    readonly scene: AnyScene;
+    readonly transport: RemoteTransport<ServerMessage, InvokeMessage>;
+}
+export declare const serve: (options: ServeOptions) => ServerBinding;
+export interface SharedClientHandle {
+    readonly remove: () => void;
+}
+export interface SharedServerBinding {
+    readonly addClient: (transport: RemoteTransport<ServerMessage, InvokeMessage>) => SharedClientHandle;
+    readonly dispose: () => Promise<void>;
+}
+export interface ServeSharedOptions {
+    readonly scene: AnyScene;
+}
+export declare const serveShared: (options: ServeSharedOptions) => SharedServerBinding;
+export interface ClientBinding {
+    readonly node: () => ReactNode;
+    readonly subscribe: (listener: () => void) => () => void;
+    readonly snapshot: () => WireTree;
+    readonly dispose: () => void;
+}
+export interface ConnectOptions<C extends RemoteContract> {
+    readonly transport: RemoteTransport<InvokeMessage, ServerMessage>;
+    readonly views: RemoteViewSet<C>;
+}
+export declare const connect: <C extends RemoteContract>(options: ConnectOptions<C>) => ClientBinding;
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,EAAE,KAAK,QAAQ,EAAQ,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AAE9F,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,UAAU,CAAA;AAEjB,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,CAAA;CAC3C;AAED,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG,cAAc,CAAA;AAE5D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B;AAED,MAAM,WAAW,eAAe,CAAC,GAAG,EAAE,EAAE;IACtC,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,CAAA;IACrC,QAAQ,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,KAAK,IAAI,KAAK,MAAM,IAAI,CAAA;CACnE;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACtC;AAID,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC,aAAa,EAAE,aAAa,CAAC,CAAA;CAClE;AAED,eAAO,MAAM,KAAK,GAAI,SAAS,YAAY,KAAG,aA+E7C,CAAA;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAA;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,CAClB,SAAS,EAAE,eAAe,CAAC,aAAa,EAAE,aAAa,CAAC,KACrD,kBAAkB,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACtC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;CACzB;AAED,eAAO,MAAM,WAAW,GAAI,SAAS,kBAAkB,KAAG,mBA4GzD,CAAA;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,SAAS,CAAA;IAC9B,QAAQ,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,MAAM,IAAI,CAAA;IACxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,QAAQ,CAAA;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAC7B;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,cAAc;IACtD,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC,aAAa,EAAE,aAAa,CAAC,CAAA;IACjE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;CACjC;AAED,eAAO,MAAM,OAAO,GAAI,CAAC,SAAS,cAAc,EAAE,SAAS,cAAc,CAAC,CAAC,CAAC,KAAG,aAyB9E,CAAA"}

package/dist/transport.js

@@ -0,0 +1,171 @@
+import { Effect, Fiber, Match, Option } from 'effect';
+import { Wire } from '@playfast/reform/internal';
+import { makeRemoteServer } from './server.js';
+import { renderWireTree, } from './client.js';
+const BACKGROUND_FLUSH_MS = 16;
+export const serve = (options) => {
+    const { scene, transport } = options;
+    const server = makeRemoteServer(scene);
+    // Snapshot gates diffs; single-flight rendering protects the shared frame baseline.
+    const started = { value: false };
+    const flight = { promise: Option.none(), dirty: false };
+    const push = () => {
+        if (!started.value) {
+            return Effect.runPromise(Effect.void);
+        }
+        if (Option.isSome(flight.promise)) {
+            flight.dirty = true;
+            return flight.promise.value;
+        }
+        // ensuring clears the single-flight slot even when rendering fails.
+        const run = Effect.runPromise(Effect.gen(function* () {
+            const patches = yield* Effect.promise(() => server.renderDiff());
+            if (patches.length > 0) {
+                transport.send({ _tag: 'Patches', patches });
+            }
+        }).pipe(Effect.ensuring(Effect.sync(() => {
+            flight.promise = Option.none();
+            if (flight.dirty) {
+                flight.dirty = false;
+                void push();
+            }
+        }))));
+        flight.promise = Option.some(run);
+        return run;
+    };
+    // Background debounce lets the drain settle and coalesces bursts without delaying invokes.
+    const debounce = { fiber: Option.none() };
+    const scheduleFlush = () => {
+        if (!started.value || Option.isSome(debounce.fiber)) {
+            return;
+        }
+        const fiber = Effect.runFork(Effect.sleep(BACKGROUND_FLUSH_MS).pipe(Effect.zipRight(Effect.sync(() => {
+            debounce.fiber = Option.none();
+            void push();
+        }))));
+        debounce.fiber = Option.some(fiber);
+    };
+    const start = async () => {
+        const tree = await server.render();
+        transport.send({ _tag: 'Snapshot', tree });
+        started.value = true;
+        scheduleFlush();
+    };
+    const off = transport.onMessage((message) => {
+        void Effect.runPromise(Effect.promise(() => server.invoke(message.handle, message.payload)).pipe(Effect.zipRight(Effect.promise(push))));
+    });
+    const offChange = server.subscribe(scheduleFlush);
+    return {
+        start,
+        dispose: async () => {
+            off();
+            offChange();
+            if (Option.isSome(debounce.fiber)) {
+                Effect.runFork(Fiber.interrupt(debounce.fiber.value));
+            }
+            await server.dispose();
+        },
+    };
+};
+export const serveShared = (options) => {
+    const { scene } = options;
+    const server = makeRemoteServer(scene);
+    const clients = new Set();
+    const broadcast = (message) => {
+        clients.forEach((client) => client.send(message));
+    };
+    // One shared render baseline requires the same single-flight discipline as serve.
+    const started = { value: false };
+    const flight = { promise: Option.none(), dirty: false };
+    const push = () => {
+        if (!started.value) {
+            return Effect.runPromise(Effect.void);
+        }
+        if (Option.isSome(flight.promise)) {
+            flight.dirty = true;
+            return flight.promise.value;
+        }
+        const run = Effect.runPromise(Effect.gen(function* () {
+            const patches = yield* Effect.promise(() => server.renderDiff());
+            if (patches.length > 0) {
+                broadcast({ _tag: 'Patches', patches });
+            }
+        }).pipe(Effect.ensuring(Effect.sync(() => {
+            flight.promise = Option.none();
+            if (flight.dirty) {
+                flight.dirty = false;
+                void push();
+            }
+        }))));
+        flight.promise = Option.some(run);
+        return run;
+    };
+    const debounce = { fiber: Option.none() };
+    const scheduleFlush = () => {
+        if (!started.value || Option.isSome(debounce.fiber)) {
+            return;
+        }
+        const fiber = Effect.runFork(Effect.sleep(BACKGROUND_FLUSH_MS).pipe(Effect.zipRight(Effect.sync(() => {
+            debounce.fiber = Option.none();
+            void push();
+        }))));
+        debounce.fiber = Option.some(fiber);
+    };
+    // Clients await the initial baseline so none snapshot an empty tree.
+    const ready = (async () => {
+        await server.render();
+        started.value = true;
+        scheduleFlush();
+    })();
+    const offChange = server.subscribe(scheduleFlush);
+    const addClient = (transport) => {
+        const off = transport.onMessage((message) => {
+            void Effect.runPromise(Effect.promise(() => server.invoke(message.handle, message.payload)).pipe(Effect.zipRight(Effect.promise(push))));
+        });
+        // Snapshot and broadcast membership must change in one tick so no diff interleaves.
+        void Effect.runPromise(Effect.promise(() => ready).pipe(Effect.zipRight(Effect.sync(() => {
+            transport.send({ _tag: 'Snapshot', tree: server.currentTree() });
+            clients.add(transport);
+        }))));
+        return {
+            remove: () => {
+                off();
+                clients.delete(transport);
+            },
+        };
+    };
+    return {
+        addClient,
+        dispose: async () => {
+            offChange();
+            if (Option.isSome(debounce.fiber)) {
+                Effect.runFork(Fiber.interrupt(debounce.fiber.value));
+            }
+            clients.clear();
+            await server.dispose();
+        },
+    };
+};
+export const connect = (options) => {
+    const { transport, views } = options;
+    const state = { tree: [] };
+    const listeners = new Set();
+    const config = {
+        views,
+        invoke: (handle, payload) => transport.send({ _tag: 'Invoke', handle, payload }),
+    };
+    const off = transport.onMessage((message) => {
+        state.tree = Match.value(message).pipe(Match.tag('Snapshot', ({ tree }) => tree), Match.tag('Patches', ({ patches }) => Wire.apply(state.tree, patches)), Match.exhaustive);
+        listeners.forEach((listener) => listener());
+    });
+    return {
+        node: () => renderWireTree(state.tree, config),
+        subscribe: (listener) => {
+            listeners.add(listener);
+            return () => void listeners.delete(listener);
+        },
+        snapshot: () => state.tree,
+        dispose: off,
+    };
+};
+//# sourceMappingURL=transport.js.map