gesso-electrobun 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,16 @@
+# gesso-electrobun
+
+## 0.1.0
+
+First public release.
+
+Run a Gesso application in an Electrobun window, with its stores in the main
+process. The application layer is a process rather than a worker, and every
+window replicates the same channels, so two windows agree by construction.
+
+Entry points: the root for the shared frame protocol, `/main`, `/view` and
+`/desktop`.
+
+Checked on WebKitGTK, from a fresh scaffold: a window opened, the counter
+pressed, the appearance flipped, and a second window replicating the first.
+WKWebView on macOS and WebView2 on Windows have not been run.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kevin Baker
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,43 @@
+# gesso-electrobun
+
+Run a Gesso application in an [Electrobun](https://electrobun.dev) window, with its stores in the main process.
+
+```bash
+npm install gesso-core gesso-framework gesso-electrobun rxjs
+```
+
+The scaffold writes a working project for you:
+
+```bash
+npm create gesso-app my-app -- --template electrobun
+```
+
+## The arrangement
+
+The application layer is a **process** rather than a worker. State lives in the main process and every window replicates it, so two windows agree because they are replicas of the same channels, not because anything synchronises them.
+
+```ts
+// the main process
+import { createDesktopApp } from 'gesso-electrobun/desktop';
+
+createDesktopApp({ channels: [{ token: Notes, source }] }).open('/');
+```
+
+## Entry points
+
+- `gesso-electrobun` -- the shared vocabulary, including the frame protocol
+- `gesso-electrobun/main` -- the main process side
+- `gesso-electrobun/view` -- inside a window
+- `gesso-electrobun/desktop` -- `createDesktopApp` and `windowsChannel`
+
+## What is checked, and what is not
+
+A window has been opened from a fresh scaffold on **WebKitGTK**, with the counter pressed, the appearance flipped, and a second window replicating the first.
+
+**WKWebView on macOS and WebView2 on Windows have not been run**, because the machines to run them on were not available. The adapter is written against Electrobun's own abstraction and is expected to work on both; expected is not measured, and this file will say so until it is.
+
+## Documentation
+
+[Gesso on Electrobun](https://github.com/kevinpbaker/gesso/blob/main/apps/docs/structure/gesso-on-electrobun.md) | [Desktop windows](https://github.com/kevinpbaker/gesso/blob/main/apps/docs/structure/desktop-windows.md)
+
+MIT (c) Kevin Baker

package/dist/desktop.d.ts

@@ -0,0 +1,103 @@
+import { r as GessoFrame } from "./frames-BrrAFMqE.js";
+import { ChannelToken, ServedChannel } from "gesso-framework";
+import { Observable } from "rxjs";
+//#region src/desktop.d.ts
+/** What the application does with the window it opened. */
+interface DesktopWindowTransport {
+  /** Sends one frame to this window, over its own RPC. */
+  send: (frame: GessoFrame) => void;
+  /** Closes the native window. The adapter calls this; the platform may also close it on its own. */
+  close: () => void;
+}
+/** A window this application opened. */
+interface DesktopWindowHandle {
+  /** Stable for the life of the window, and never reused. */
+  readonly id: number;
+  /** Closes the window and disposes the channels it was served. */
+  close(): void;
+}
+interface DesktopAppOptions {
+  /**
+   * The channels each window is served.
+   *
+   * A function when a window needs a channel of its own, which is what
+   * `windowsChannel` uses to give a window a way to close itself. It
+   * is called once per window, and the observables it returns are
+   * ordinarily the same ones every time: `provide` keeps a separate
+   * record of what each client has seen, so sharing a source between
+   * windows is what makes them agree.
+   */
+  channels: readonly ServedChannel[] | ((window: DesktopWindowHandle) => readonly ServedChannel[]);
+  /**
+   * Opens a native window.
+   *
+   * `receive` is what the window's frames must be fed into: wire it to
+   * the RPC message the window sends frames on, before the window
+   * opens, or the first handshake is lost.
+   */
+  open: (receive: (frame: GessoFrame) => void, window: DesktopWindowHandle) => DesktopWindowTransport;
+  /**
+   * A url a window asked to have opened outside itself, with the
+   * window that asked. `Utils.openExternal(url)` is what an Electrobun
+   * application passes here.
+   */
+  onOpenUrl?: (url: string, window: DesktopWindowHandle) => void;
+  /**
+   * The appearance the platform is in, pushed to every window as it
+   * changes and to a new window as it opens.
+   *
+   * The application supplies it because Electrobun does not: its SDK
+   * has no appearance API at all, and the webview's own
+   * `prefers-color-scheme` is wrong on WebKitGTK
+   *. On a platform that has a
+   * signal, this is where it goes; on one that does not, an
+   * application setting is a perfectly good source.
+   */
+  colorScheme?: Observable<'light' | 'dark'>;
+  /**
+   * Called when the last window closes. A desktop application usually
+   * stops here; one with a tray or a menu bar does not, which is why
+   * this is a callback rather than an exit.
+   */
+  onLastWindowClosed?: () => void;
+  /** Overrides the frame size messages are split at. Only a test should need to. */
+  chunkBytes?: number;
+}
+interface DesktopApp {
+  /** Opens a window, serves it every channel, and returns its handle. */
+  openWindow(): DesktopWindowHandle;
+  /** The windows open now, in the order they were opened. */
+  readonly windows: readonly DesktopWindowHandle[];
+  /** How many windows are open, as something a channel can publish. */
+  readonly windowCount: Observable<number>;
+  /** Closes every window and stops serving. */
+  dispose(): void;
+}
+declare function createDesktopApp(options: DesktopAppOptions): DesktopApp;
+/** What a window can see and do about the windows of its application. */
+interface DesktopWindowsView {
+  /** How many windows this application has open. */
+  count: number;
+  /** Which one this is, so a screen can say "window 2 of 3" without asking. */
+  id: number;
+}
+interface DesktopWindowsCommands {
+  open: () => void;
+  closeThis: () => void;
+}
+/**
+ * The channel a window opens another window through.
+ *
+ * It exists because opening a window is the one native act a screen
+ * genuinely needs, and going through a channel keeps the view layer
+ * from importing an adapter. the "native menus bound to
+ * store actions" is the same idea from the other end, and on Linux it
+ * is the only end: the runtime has no application menus there, so a
+ * menu is a component and this is what it calls.
+ */
+declare const DesktopWindows: ChannelToken<DesktopWindowsView, DesktopWindowsCommands>;
+/** Serves `DesktopWindows` to one window. Put it in `channels`. */
+declare function windowsChannel(app: DesktopApp, window: DesktopWindowHandle): ServedChannel;
+//#endregion
+export { DesktopApp, DesktopAppOptions, DesktopWindowHandle, DesktopWindowTransport, DesktopWindows, DesktopWindowsCommands, DesktopWindowsView, createDesktopApp, windowsChannel };
+//# sourceMappingURL=desktop.d.ts.map

package/dist/desktop.js

@@ -0,0 +1,153 @@
+import { serveChannelsToWindow } from "./main.js";
+import { channel } from "gesso-framework";
+import { BehaviorSubject } from "rxjs";
+//#region src/desktop.ts
+/**
+* An application in the main process: windows, and the channels each
+* one is served.
+*
+* Nothing here imports Electrobun, and that is not fastidiousness. The
+* SDK is projected into a project by Hutch rather than installed from
+* a registry, so a package in
+* this workspace could not import it even if it wanted to. What the
+* application supplies instead is one function that opens a window,
+* which is the only Electrobun-shaped thing this needs, and which is
+* five lines at the call site:
+*
+*   const app = createDesktopApp({
+*     channels: window => [
+*       { token: Catalogue, source: catalogue },
+*       windowsChannel(app, window)
+*     ],
+*     open: receive => {
+*       const rpc = BrowserView.defineRPC<GessoWindowRPC>({
+*         handlers: { requests: {}, messages: { gessoFrame: receive } }
+*       });
+*       const window = new BrowserWindow({ title: 'Notes', url: 'views://mainview/index.html', rpc });
+*       return {
+*         send: frame => window.webview.rpc.send.gessoFrame(frame),
+*         close: () => window.close()
+*       };
+*     }
+*   });
+*   app.openWindow();
+*
+* The arrangement it buys: every
+* window is a replica of the same channels, so two windows agree by
+* construction rather than by synchronisation.
+*/
+function createDesktopApp(options) {
+	const entries = /* @__PURE__ */ new Map();
+	/** One appearance subscription per window, ended when it closes. */
+	const subscriptions = /* @__PURE__ */ new Map();
+	const order = [];
+	const count = new BehaviorSubject(0);
+	let nextId = 1;
+	let disposed = false;
+	const forget = (id, closeNative) => {
+		const entry = entries.get(id);
+		if (entry === void 0) return;
+		entries.delete(id);
+		subscriptions.get(id)?.unsubscribe();
+		subscriptions.delete(id);
+		const at = order.indexOf(entry.handle);
+		if (at >= 0) order.splice(at, 1);
+		entry.host.dispose();
+		if (closeNative) entry.transport.close();
+		count.next(order.length);
+		if (order.length === 0 && !disposed) options.onLastWindowClosed?.();
+	};
+	return {
+		openWindow() {
+			if (disposed) throw new Error("This desktop application has been disposed; it cannot open a window.");
+			const id = nextId++;
+			const handle = {
+				id,
+				close: () => forget(id, true)
+			};
+			let transport;
+			const host = serveChannelsToWindow(typeof options.channels === "function" ? options.channels(handle) : options.channels, {
+				send: (frame) => transport?.send(frame),
+				chunkBytes: options.chunkBytes,
+				onOpenUrl: (url) => options.onOpenUrl?.(url, handle)
+			});
+			entries.set(id, {
+				handle,
+				transport: {
+					send: () => {},
+					close: () => {}
+				},
+				host
+			});
+			order.push(handle);
+			let greeted = false;
+			let latest;
+			transport = options.open((frame) => {
+				if (!greeted) {
+					greeted = true;
+					if (latest !== void 0) host.setColorScheme(latest);
+				}
+				host.receive(frame);
+			}, handle);
+			entries.set(id, {
+				handle,
+				transport,
+				host
+			});
+			const appearance = options.colorScheme?.subscribe((scheme) => {
+				latest = scheme;
+				if (greeted) host.setColorScheme(scheme);
+			});
+			if (appearance !== void 0) subscriptions.set(id, appearance);
+			count.next(order.length);
+			return handle;
+		},
+		get windows() {
+			return [...order];
+		},
+		windowCount: count.asObservable(),
+		dispose() {
+			disposed = true;
+			for (const id of new Set(entries.keys())) forget(id, true);
+			count.complete();
+		}
+	};
+}
+/**
+* The channel a window opens another window through.
+*
+* It exists because opening a window is the one native act a screen
+* genuinely needs, and going through a channel keeps the view layer
+* from importing an adapter. the "native menus bound to
+* store actions" is the same idea from the other end, and on Linux it
+* is the only end: the runtime has no application menus there, so a
+* menu is a component and this is what it calls.
+*/
+const DesktopWindows = channel("gesso:windows", {
+	count: 0,
+	id: 0
+});
+/** Serves `DesktopWindows` to one window. Put it in `channels`. */
+function windowsChannel(app, window) {
+	return {
+		token: DesktopWindows,
+		source: {
+			view: {
+				count: app.windowCount,
+				id: new BehaviorSubject(window.id)
+			},
+			commands: {
+				open: () => {
+					app.openWindow();
+				},
+				closeThis: () => {
+					window.close();
+				}
+			}
+		}
+	};
+}
+//#endregion
+export { DesktopWindows, createDesktopApp, windowsChannel };
+
+//# sourceMappingURL=desktop.js.map

package/dist/desktop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop.js","names":[],"sources":["../src/desktop.ts"],"sourcesContent":["/**\n * An application in the main process: windows, and the channels each\n * one is served.\n *\n * Nothing here imports Electrobun, and that is not fastidiousness. The\n * SDK is projected into a project by Hutch rather than installed from\n * a registry, so a package in\n * this workspace could not import it even if it wanted to. What the\n * application supplies instead is one function that opens a window,\n * which is the only Electrobun-shaped thing this needs, and which is\n * five lines at the call site:\n *\n *   const app = createDesktopApp({\n *     channels: window => [\n *       { token: Catalogue, source: catalogue },\n *       windowsChannel(app, window)\n *     ],\n *     open: receive => {\n *       const rpc = BrowserView.defineRPC<GessoWindowRPC>({\n *         handlers: { requests: {}, messages: { gessoFrame: receive } }\n *       });\n *       const window = new BrowserWindow({ title: 'Notes', url: 'views://mainview/index.html', rpc });\n *       return {\n *         send: frame => window.webview.rpc.send.gessoFrame(frame),\n *         close: () => window.close()\n *       };\n *     }\n *   });\n *   app.openWindow();\n *\n * The arrangement it buys: every\n * window is a replica of the same channels, so two windows agree by\n * construction rather than by synchronisation.\n */\nimport { channel, type ChannelToken, type ServedChannel } from 'gesso-framework';\nimport { BehaviorSubject, type Observable, type Subscription } from 'rxjs';\n\nimport type { GessoFrame } from './frames';\nimport { serveChannelsToWindow, type ChannelHost } from './main';\n\n/** What the application does with the window it opened. */\nexport interface DesktopWindowTransport {\n  /** Sends one frame to this window, over its own RPC. */\n  send: (frame: GessoFrame) => void;\n  /** Closes the native window. The adapter calls this; the platform may also close it on its own. */\n  close: () => void;\n}\n\n/** A window this application opened. */\nexport interface DesktopWindowHandle {\n  /** Stable for the life of the window, and never reused. */\n  readonly id: number;\n  /** Closes the window and disposes the channels it was served. */\n  close(): void;\n}\n\nexport interface DesktopAppOptions {\n  /**\n   * The channels each window is served.\n   *\n   * A function when a window needs a channel of its own, which is what\n   * `windowsChannel` uses to give a window a way to close itself. It\n   * is called once per window, and the observables it returns are\n   * ordinarily the same ones every time: `provide` keeps a separate\n   * record of what each client has seen, so sharing a source between\n   * windows is what makes them agree.\n   */\n  channels: readonly ServedChannel[] | ((window: DesktopWindowHandle) => readonly ServedChannel[]);\n  /**\n   * Opens a native window.\n   *\n   * `receive` is what the window's frames must be fed into: wire it to\n   * the RPC message the window sends frames on, before the window\n   * opens, or the first handshake is lost.\n   */\n  open: (receive: (frame: GessoFrame) => void, window: DesktopWindowHandle) => DesktopWindowTransport;\n  /**\n   * A url a window asked to have opened outside itself, with the\n   * window that asked. `Utils.openExternal(url)` is what an Electrobun\n   * application passes here.\n   */\n  onOpenUrl?: (url: string, window: DesktopWindowHandle) => void;\n  /**\n   * The appearance the platform is in, pushed to every window as it\n   * changes and to a new window as it opens.\n   *\n   * The application supplies it because Electrobun does not: its SDK\n   * has no appearance API at all, and the webview's own\n   * `prefers-color-scheme` is wrong on WebKitGTK\n   *. On a platform that has a\n   * signal, this is where it goes; on one that does not, an\n   * application setting is a perfectly good source.\n   */\n  colorScheme?: Observable<'light' | 'dark'>;\n  /**\n   * Called when the last window closes. A desktop application usually\n   * stops here; one with a tray or a menu bar does not, which is why\n   * this is a callback rather than an exit.\n   */\n  onLastWindowClosed?: () => void;\n  /** Overrides the frame size messages are split at. Only a test should need to. */\n  chunkBytes?: number;\n}\n\nexport interface DesktopApp {\n  /** Opens a window, serves it every channel, and returns its handle. */\n  openWindow(): DesktopWindowHandle;\n  /** The windows open now, in the order they were opened. */\n  readonly windows: readonly DesktopWindowHandle[];\n  /** How many windows are open, as something a channel can publish. */\n  readonly windowCount: Observable<number>;\n  /** Closes every window and stops serving. */\n  dispose(): void;\n}\n\nexport function createDesktopApp(options: DesktopAppOptions): DesktopApp {\n  interface Entry {\n    handle: DesktopWindowHandle;\n    transport: DesktopWindowTransport;\n    host: ChannelHost;\n  }\n  const entries = new Map<number, Entry>();\n  /** One appearance subscription per window, ended when it closes. */\n  const subscriptions = new Map<number, Subscription>();\n  const order: DesktopWindowHandle[] = [];\n  const count = new BehaviorSubject(0);\n  let nextId = 1;\n  let disposed = false;\n\n  const forget = (id: number, closeNative: boolean): void => {\n    const entry = entries.get(id);\n    if (entry === undefined) {\n      return;\n    }\n    entries.delete(id);\n    subscriptions.get(id)?.unsubscribe();\n    subscriptions.delete(id);\n    const at = order.indexOf(entry.handle);\n    if (at >= 0) {\n      order.splice(at, 1);\n    }\n    entry.host.dispose();\n    if (closeNative) {\n      entry.transport.close();\n    }\n    count.next(order.length);\n    if (order.length === 0 && !disposed) {\n      options.onLastWindowClosed?.();\n    }\n  };\n\n  const app: DesktopApp = {\n    openWindow(): DesktopWindowHandle {\n      if (disposed) {\n        throw new Error('This desktop application has been disposed; it cannot open a window.');\n      }\n      const id = nextId++;\n      const handle: DesktopWindowHandle = {\n        id,\n        close: () => forget(id, true)\n      };\n\n      // The host exists before the window does, because `open` may\n      // deliver a frame synchronously and a window whose first\n      // handshake was dropped never replicates anything.\n      let transport: DesktopWindowTransport | undefined;\n      const host = serveChannelsToWindow(\n        typeof options.channels === 'function' ? options.channels(handle) : options.channels,\n        {\n          send: frame => transport?.send(frame),\n          chunkBytes: options.chunkBytes,\n          onOpenUrl: url => options.onOpenUrl?.(url, handle)\n        }\n      );\n      entries.set(id, { handle, transport: { send: () => {}, close: () => {} }, host });\n      order.push(handle);\n\n      // Anything pushed before the window has spoken is lost: a\n      // webview's RPC is not listening until its page has loaded, and\n      // the window opens well before that. Channels do not notice,\n      // because a channel starts with the window asking. The\n      // appearance is the one thing this side sends first, so it waits\n      // for the window's first frame, whatever that frame is. A native\n      // window found this; a spec with a transport that was live\n      // immediately could not.\n      let greeted = false;\n      let latest: 'light' | 'dark' | undefined;\n      transport = options.open(frame => {\n        if (!greeted) {\n          greeted = true;\n          if (latest !== undefined) {\n            host.setColorScheme(latest);\n          }\n        }\n        host.receive(frame);\n      }, handle);\n      entries.set(id, { handle, transport, host });\n      const appearance = options.colorScheme?.subscribe(scheme => {\n        latest = scheme;\n        if (greeted) {\n          host.setColorScheme(scheme);\n        }\n      });\n      if (appearance !== undefined) {\n        subscriptions.set(id, appearance);\n      }\n      count.next(order.length);\n      return handle;\n    },\n    get windows(): readonly DesktopWindowHandle[] {\n      return [...order];\n    },\n    windowCount: count.asObservable(),\n    dispose(): void {\n      disposed = true;\n      for (const id of new Set(entries.keys())) {\n        forget(id, true);\n      }\n      count.complete();\n    }\n  };\n\n  return app;\n}\n\n/** What a window can see and do about the windows of its application. */\nexport interface DesktopWindowsView {\n  /** How many windows this application has open. */\n  count: number;\n  /** Which one this is, so a screen can say \"window 2 of 3\" without asking. */\n  id: number;\n}\n\nexport interface DesktopWindowsCommands {\n  open: () => void;\n  closeThis: () => void;\n}\n\n/**\n * The channel a window opens another window through.\n *\n * It exists because opening a window is the one native act a screen\n * genuinely needs, and going through a channel keeps the view layer\n * from importing an adapter. the \"native menus bound to\n * store actions\" is the same idea from the other end, and on Linux it\n * is the only end: the runtime has no application menus there, so a\n * menu is a component and this is what it calls.\n */\nexport const DesktopWindows: ChannelToken<DesktopWindowsView, DesktopWindowsCommands> = channel<\n  DesktopWindowsView,\n  DesktopWindowsCommands\n>('gesso:windows', { count: 0, id: 0 });\n\n/** Serves `DesktopWindows` to one window. Put it in `channels`. */\nexport function windowsChannel(app: DesktopApp, window: DesktopWindowHandle): ServedChannel {\n  return {\n    token: DesktopWindows,\n    source: {\n      view: {\n        count: app.windowCount,\n        id: new BehaviorSubject(window.id)\n      },\n      commands: {\n        open: () => {\n          app.openWindow();\n        },\n        closeThis: () => {\n          window.close();\n        }\n      }\n    }\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmHA,SAAgB,iBAAiB,SAAwC;CAMvE,MAAM,0BAAU,IAAI,IAAmB;;CAEvC,MAAM,gCAAgB,IAAI,IAA0B;CACpD,MAAM,QAA+B,CAAC;CACtC,MAAM,QAAQ,IAAI,gBAAgB,CAAC;CACnC,IAAI,SAAS;CACb,IAAI,WAAW;CAEf,MAAM,UAAU,IAAY,gBAA+B;EACzD,MAAM,QAAQ,QAAQ,IAAI,EAAE;EAC5B,IAAI,UAAU,KAAA,GACZ;EAEF,QAAQ,OAAO,EAAE;EACjB,cAAc,IAAI,EAAE,CAAC,EAAE,YAAY;EACnC,cAAc,OAAO,EAAE;EACvB,MAAM,KAAK,MAAM,QAAQ,MAAM,MAAM;EACrC,IAAI,MAAM,GACR,MAAM,OAAO,IAAI,CAAC;EAEpB,MAAM,KAAK,QAAQ;EACnB,IAAI,aACF,MAAM,UAAU,MAAM;EAExB,MAAM,KAAK,MAAM,MAAM;EACvB,IAAI,MAAM,WAAW,KAAK,CAAC,UACzB,QAAQ,qBAAqB;CAEjC;CAyEA,OAAO;EAtEL,aAAkC;GAChC,IAAI,UACF,MAAM,IAAI,MAAM,sEAAsE;GAExF,MAAM,KAAK;GACX,MAAM,SAA8B;IAClC;IACA,aAAa,OAAO,IAAI,IAAI;GAC9B;GAKA,IAAI;GACJ,MAAM,OAAO,sBACX,OAAO,QAAQ,aAAa,aAAa,QAAQ,SAAS,MAAM,IAAI,QAAQ,UAC5E;IACE,OAAM,UAAS,WAAW,KAAK,KAAK;IACpC,YAAY,QAAQ;IACpB,YAAW,QAAO,QAAQ,YAAY,KAAK,MAAM;GACnD,CACF;GACA,QAAQ,IAAI,IAAI;IAAE;IAAQ,WAAW;KAAE,YAAY,CAAC;KAAG,aAAa,CAAC;IAAE;IAAG;GAAK,CAAC;GAChF,MAAM,KAAK,MAAM;GAUjB,IAAI,UAAU;GACd,IAAI;GACJ,YAAY,QAAQ,MAAK,UAAS;IAChC,IAAI,CAAC,SAAS;KACZ,UAAU;KACV,IAAI,WAAW,KAAA,GACb,KAAK,eAAe,MAAM;IAE9B;IACA,KAAK,QAAQ,KAAK;GACpB,GAAG,MAAM;GACT,QAAQ,IAAI,IAAI;IAAE;IAAQ;IAAW;GAAK,CAAC;GAC3C,MAAM,aAAa,QAAQ,aAAa,WAAU,WAAU;IAC1D,SAAS;IACT,IAAI,SACF,KAAK,eAAe,MAAM;GAE9B,CAAC;GACD,IAAI,eAAe,KAAA,GACjB,cAAc,IAAI,IAAI,UAAU;GAElC,MAAM,KAAK,MAAM,MAAM;GACvB,OAAO;EACT;EACA,IAAI,UAA0C;GAC5C,OAAO,CAAC,GAAG,KAAK;EAClB;EACA,aAAa,MAAM,aAAa;EAChC,UAAgB;GACd,WAAW;GACX,KAAK,MAAM,MAAM,IAAI,IAAI,QAAQ,KAAK,CAAC,GACrC,OAAO,IAAI,IAAI;GAEjB,MAAM,SAAS;EACjB;CAGO;AACX;;;;;;;;;;;AAyBA,MAAa,iBAA2E,QAGtF,iBAAiB;CAAE,OAAO;CAAG,IAAI;AAAE,CAAC;;AAGtC,SAAgB,eAAe,KAAiB,QAA4C;CAC1F,OAAO;EACL,OAAO;EACP,QAAQ;GACN,MAAM;IACJ,OAAO,IAAI;IACX,IAAI,IAAI,gBAAgB,OAAO,EAAE;GACnC;GACA,UAAU;IACR,YAAY;KACV,IAAI,WAAW;IACjB;IACA,iBAAiB;KACf,OAAO,MAAM;IACf;GACF;EACF;CACF;AACF"}

package/dist/frames-BQisaYy-.js

@@ -0,0 +1,105 @@
+//#region src/frames.ts
+/**
+* The whole wire format, which is deliberately smaller than the
+* channel protocol it carries.
+*
+* Three frames in each direction. `open` says a named channel wants a
+* stream, `data` carries one channel message, `close` ends a stream.
+* Nothing here knows what a channel is, what a patch is, or what a
+* command is: a frame's `body` is a string this module produced by
+* serializing a value it never looked inside. That restraint is the
+* rule the adapter states, and it is what keeps the
+* webview's main thread a transport rather than a router.
+*/
+/**
+* How much of a serialized message goes in one frame.
+*
+* Electrobun's transport fails above roughly 8 MiB in a single
+* message, and it fails badly: the main process throws while draining
+* and the sender sees only a timeout, so the real error is in a log
+* nobody is reading. A megabyte leaves eight times the headroom and
+* costs nothing at the measured rates.
+*/
+const DEFAULT_CHUNK_BYTES = 1048576;
+function isGessoFrame(value) {
+	const kind = value?.kind;
+	return kind === "open" || kind === "data" || kind === "close" || kind === "control";
+}
+/** Wraps one control message. Never split: these are small by construction. */
+function frameControl(name, payload) {
+	return {
+		kind: "control",
+		name,
+		body: JSON.stringify(payload ?? null) ?? "null"
+	};
+}
+/**
+* Serializes one channel message into the frames that carry it.
+*
+* JSON rather than structured clone, because the transport underneath
+* is JSON either way: `Electroview.createTransport` stringifies every
+* message before it encrypts it. That means `undefined` inside a value
+* does not survive, which is true of this transport with or without
+* this module, and which a view key cannot rely on anyway.
+*/
+function frameData(stream, value, chunkBytes = DEFAULT_CHUNK_BYTES) {
+	const body = JSON.stringify(value);
+	if (body === void 0) throw new Error(`A channel message for stream ${stream} could not be serialized. Only plain data crosses a channel; see requirePlainData.`);
+	if (body.length <= chunkBytes) return [{
+		kind: "data",
+		stream,
+		body
+	}];
+	const parts = Math.ceil(body.length / chunkBytes);
+	const frames = [];
+	for (let part = 0; part < parts; part++) frames.push({
+		kind: "data",
+		stream,
+		body: body.slice(part * chunkBytes, (part + 1) * chunkBytes),
+		part,
+		parts
+	});
+	return frames;
+}
+/**
+* Puts split messages back together.
+*
+* The transport delivers in order (`Electroview` dispatches through a
+* promise tail that preserves frame order), so a part that arrives out
+* of turn is a bug rather than a race, and it says so instead of
+* quietly assembling a corrupt message.
+*/
+var FrameAssembler = class {
+	partial = /* @__PURE__ */ new Map();
+	/**
+	* Returns the value a `data` frame completes, or `undefined` while
+	* more parts are still to come.
+	*/
+	take(frame) {
+		if (frame.parts === void 0) return JSON.parse(frame.body);
+		const held = this.partial.get(frame.stream) ?? {
+			parts: frame.parts,
+			chunks: []
+		};
+		const expected = held.chunks.length;
+		if (frame.part !== expected) {
+			this.partial.delete(frame.stream);
+			throw new Error(`Stream ${frame.stream} received part ${String(frame.part)} when part ${expected} was next. Frames are expected in order; a gap means the transport reordered or dropped one.`);
+		}
+		held.chunks.push(frame.body);
+		if (held.chunks.length < held.parts) {
+			this.partial.set(frame.stream, held);
+			return;
+		}
+		this.partial.delete(frame.stream);
+		return JSON.parse(held.chunks.join(""));
+	}
+	/** Drops anything half-received for a stream that has closed. */
+	forget(stream) {
+		this.partial.delete(stream);
+	}
+};
+//#endregion
+export { isGessoFrame as a, frameData as i, FrameAssembler as n, frameControl as r, DEFAULT_CHUNK_BYTES as t };
+
+//# sourceMappingURL=frames-BQisaYy-.js.map

package/dist/frames-BQisaYy-.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frames-BQisaYy-.js","names":[],"sources":["../src/frames.ts"],"sourcesContent":["/**\n * The whole wire format, which is deliberately smaller than the\n * channel protocol it carries.\n *\n * Three frames in each direction. `open` says a named channel wants a\n * stream, `data` carries one channel message, `close` ends a stream.\n * Nothing here knows what a channel is, what a patch is, or what a\n * command is: a frame's `body` is a string this module produced by\n * serializing a value it never looked inside. That restraint is the\n * rule the adapter states, and it is what keeps the\n * webview's main thread a transport rather than a router.\n */\n\n/**\n * How much of a serialized message goes in one frame.\n *\n * Electrobun's transport fails above roughly 8 MiB in a single\n * message, and it fails badly: the main process throws while draining\n * and the sender sees only a timeout, so the real error is in a log\n * nobody is reading. A megabyte leaves eight times the headroom and\n * costs nothing at the measured rates.\n */\nexport const DEFAULT_CHUNK_BYTES = 1_048_576;\n\nexport type GessoFrame =\n  | { readonly kind: 'open'; readonly stream: number; readonly name: string }\n  | {\n      readonly kind: 'data';\n      readonly stream: number;\n      readonly body: string;\n      /** Absent unless the message was split; then 0-based. */\n      readonly part?: number;\n      /** Absent unless the message was split; then how many parts to expect. */\n      readonly parts?: number;\n    }\n  | { readonly kind: 'close'; readonly stream: number }\n  /**\n   * The adapter's own traffic, which is not a channel: the appearance\n   * the platform is in, and a url the application wants opened\n   * outside the window. It carries a name and a serialized payload for\n   * the same reason a `data` frame carries a body, and it is a\n   * separate kind so that nothing has to reserve a stream number.\n   */\n  | { readonly kind: 'control'; readonly name: string; readonly body: string };\n\nexport function isGessoFrame(value: unknown): value is GessoFrame {\n  const kind = (value as { kind?: unknown } | null)?.kind;\n  return kind === 'open' || kind === 'data' || kind === 'close' || kind === 'control';\n}\n\n/** Wraps one control message. Never split: these are small by construction. */\nexport function frameControl(name: string, payload: unknown): GessoFrame {\n  return { kind: 'control', name, body: JSON.stringify(payload ?? null) ?? 'null' };\n}\n\n/**\n * Serializes one channel message into the frames that carry it.\n *\n * JSON rather than structured clone, because the transport underneath\n * is JSON either way: `Electroview.createTransport` stringifies every\n * message before it encrypts it. That means `undefined` inside a value\n * does not survive, which is true of this transport with or without\n * this module, and which a view key cannot rely on anyway.\n */\nexport function frameData(stream: number, value: unknown, chunkBytes = DEFAULT_CHUNK_BYTES): GessoFrame[] {\n  const body = JSON.stringify(value);\n  if (body === undefined) {\n    throw new Error(\n      `A channel message for stream ${stream} could not be serialized. Only plain data crosses a channel; see requirePlainData.`\n    );\n  }\n  if (body.length <= chunkBytes) {\n    return [{ kind: 'data', stream, body }];\n  }\n  const parts = Math.ceil(body.length / chunkBytes);\n  const frames: GessoFrame[] = [];\n  for (let part = 0; part < parts; part++) {\n    frames.push({\n      kind: 'data',\n      stream,\n      body: body.slice(part * chunkBytes, (part + 1) * chunkBytes),\n      part,\n      parts\n    });\n  }\n  return frames;\n}\n\n/**\n * Puts split messages back together.\n *\n * The transport delivers in order (`Electroview` dispatches through a\n * promise tail that preserves frame order), so a part that arrives out\n * of turn is a bug rather than a race, and it says so instead of\n * quietly assembling a corrupt message.\n */\nexport class FrameAssembler {\n  private readonly partial = new Map<number, { parts: number; chunks: string[] }>();\n\n  /**\n   * Returns the value a `data` frame completes, or `undefined` while\n   * more parts are still to come.\n   */\n  take(frame: GessoFrame & { kind: 'data' }): unknown {\n    if (frame.parts === undefined) {\n      return JSON.parse(frame.body);\n    }\n    const held = this.partial.get(frame.stream) ?? { parts: frame.parts, chunks: [] };\n    const expected = held.chunks.length;\n    if (frame.part !== expected) {\n      this.partial.delete(frame.stream);\n      throw new Error(\n        `Stream ${frame.stream} received part ${String(frame.part)} when part ${expected} was next. ` +\n          'Frames are expected in order; a gap means the transport reordered or dropped one.'\n      );\n    }\n    held.chunks.push(frame.body);\n    if (held.chunks.length < held.parts) {\n      this.partial.set(frame.stream, held);\n      return undefined;\n    }\n    this.partial.delete(frame.stream);\n    return JSON.parse(held.chunks.join(''));\n  }\n\n  /** Drops anything half-received for a stream that has closed. */\n  forget(stream: number): void {\n    this.partial.delete(stream);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAsBA,MAAa,sBAAsB;AAuBnC,SAAgB,aAAa,OAAqC;CAChE,MAAM,OAAQ,OAAqC;CACnD,OAAO,SAAS,UAAU,SAAS,UAAU,SAAS,WAAW,SAAS;AAC5E;;AAGA,SAAgB,aAAa,MAAc,SAA8B;CACvE,OAAO;EAAE,MAAM;EAAW;EAAM,MAAM,KAAK,UAAU,WAAW,IAAI,KAAK;CAAO;AAClF;;;;;;;;;;AAWA,SAAgB,UAAU,QAAgB,OAAgB,aAAa,qBAAmC;CACxG,MAAM,OAAO,KAAK,UAAU,KAAK;CACjC,IAAI,SAAS,KAAA,GACX,MAAM,IAAI,MACR,gCAAgC,OAAO,mFACzC;CAEF,IAAI,KAAK,UAAU,YACjB,OAAO,CAAC;EAAE,MAAM;EAAQ;EAAQ;CAAK,CAAC;CAExC,MAAM,QAAQ,KAAK,KAAK,KAAK,SAAS,UAAU;CAChD,MAAM,SAAuB,CAAC;CAC9B,KAAK,IAAI,OAAO,GAAG,OAAO,OAAO,QAC/B,OAAO,KAAK;EACV,MAAM;EACN;EACA,MAAM,KAAK,MAAM,OAAO,aAAa,OAAO,KAAK,UAAU;EAC3D;EACA;CACF,CAAC;CAEH,OAAO;AACT;;;;;;;;;AAUA,IAAa,iBAAb,MAA4B;CAC1B,0BAA2B,IAAI,IAAiD;;;;;CAMhF,KAAK,OAA+C;EAClD,IAAI,MAAM,UAAU,KAAA,GAClB,OAAO,KAAK,MAAM,MAAM,IAAI;EAE9B,MAAM,OAAO,KAAK,QAAQ,IAAI,MAAM,MAAM,KAAK;GAAE,OAAO,MAAM;GAAO,QAAQ,CAAC;EAAE;EAChF,MAAM,WAAW,KAAK,OAAO;EAC7B,IAAI,MAAM,SAAS,UAAU;GAC3B,KAAK,QAAQ,OAAO,MAAM,MAAM;GAChC,MAAM,IAAI,MACR,UAAU,MAAM,OAAO,iBAAiB,OAAO,MAAM,IAAI,EAAE,aAAa,SAAS,6FAEnF;EACF;EACA,KAAK,OAAO,KAAK,MAAM,IAAI;EAC3B,IAAI,KAAK,OAAO,SAAS,KAAK,OAAO;GACnC,KAAK,QAAQ,IAAI,MAAM,QAAQ,IAAI;GACnC;EACF;EACA,KAAK,QAAQ,OAAO,MAAM,MAAM;EAChC,OAAO,KAAK,MAAM,KAAK,OAAO,KAAK,EAAE,CAAC;CACxC;;CAGA,OAAO,QAAsB;EAC3B,KAAK,QAAQ,OAAO,MAAM;CAC5B;AACF"}

package/dist/frames-BrrAFMqE.d.ts

@@ -0,0 +1,85 @@
+//#region src/frames.d.ts
+/**
+ * The whole wire format, which is deliberately smaller than the
+ * channel protocol it carries.
+ *
+ * Three frames in each direction. `open` says a named channel wants a
+ * stream, `data` carries one channel message, `close` ends a stream.
+ * Nothing here knows what a channel is, what a patch is, or what a
+ * command is: a frame's `body` is a string this module produced by
+ * serializing a value it never looked inside. That restraint is the
+ * rule the adapter states, and it is what keeps the
+ * webview's main thread a transport rather than a router.
+ */
+/**
+ * How much of a serialized message goes in one frame.
+ *
+ * Electrobun's transport fails above roughly 8 MiB in a single
+ * message, and it fails badly: the main process throws while draining
+ * and the sender sees only a timeout, so the real error is in a log
+ * nobody is reading. A megabyte leaves eight times the headroom and
+ * costs nothing at the measured rates.
+ */
+declare const DEFAULT_CHUNK_BYTES = 1048576;
+type GessoFrame = {
+  readonly kind: 'open';
+  readonly stream: number;
+  readonly name: string;
+} | {
+  readonly kind: 'data';
+  readonly stream: number;
+  readonly body: string;
+  /** Absent unless the message was split; then 0-based. */
+  readonly part?: number;
+  /** Absent unless the message was split; then how many parts to expect. */
+  readonly parts?: number;
+} | {
+  readonly kind: 'close';
+  readonly stream: number;
+} |
+/**
+ * The adapter's own traffic, which is not a channel: the appearance
+ * the platform is in, and a url the application wants opened
+ * outside the window. It carries a name and a serialized payload for
+ * the same reason a `data` frame carries a body, and it is a
+ * separate kind so that nothing has to reserve a stream number.
+ */
+{
+  readonly kind: 'control';
+  readonly name: string;
+  readonly body: string;
+};
+declare function isGessoFrame(value: unknown): value is GessoFrame;
+/**
+ * Serializes one channel message into the frames that carry it.
+ *
+ * JSON rather than structured clone, because the transport underneath
+ * is JSON either way: `Electroview.createTransport` stringifies every
+ * message before it encrypts it. That means `undefined` inside a value
+ * does not survive, which is true of this transport with or without
+ * this module, and which a view key cannot rely on anyway.
+ */
+declare function frameData(stream: number, value: unknown, chunkBytes?: number): GessoFrame[];
+/**
+ * Puts split messages back together.
+ *
+ * The transport delivers in order (`Electroview` dispatches through a
+ * promise tail that preserves frame order), so a part that arrives out
+ * of turn is a bug rather than a race, and it says so instead of
+ * quietly assembling a corrupt message.
+ */
+declare class FrameAssembler {
+  private readonly partial;
+  /**
+   * Returns the value a `data` frame completes, or `undefined` while
+   * more parts are still to come.
+   */
+  take(frame: GessoFrame & {
+    kind: 'data';
+  }): unknown;
+  /** Drops anything half-received for a stream that has closed. */
+  forget(stream: number): void;
+}
+//#endregion
+export { isGessoFrame as a, frameData as i, FrameAssembler as n, GessoFrame as r, DEFAULT_CHUNK_BYTES as t };
+//# sourceMappingURL=frames-BrrAFMqE.d.ts.map

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+import { a as isGessoFrame, i as frameData, n as FrameAssembler, r as GessoFrame, t as DEFAULT_CHUNK_BYTES } from "./frames-BrrAFMqE.js";
+export { DEFAULT_CHUNK_BYTES, FrameAssembler, type GessoFrame, frameData, isGessoFrame };

package/dist/index.js

@@ -0,0 +1,2 @@
+import { a as isGessoFrame, i as frameData, n as FrameAssembler, t as DEFAULT_CHUNK_BYTES } from "./frames-BQisaYy-.js";
+export { DEFAULT_CHUNK_BYTES, FrameAssembler, frameData, isGessoFrame };

package/dist/main.d.ts

@@ -0,0 +1,44 @@
+import { r as GessoFrame } from "./frames-BrrAFMqE.js";
+import { ServedChannel } from "gesso-framework";
+//#region src/main.d.ts
+interface ChannelHostOptions {
+  /**
+   * Sends one frame to the window, which is
+   * `window.webview.rpc.send.<name>`. One host per window: each keeps
+   * its own streams, and `provide` already keeps a separate record of
+   * what each client has seen, so two windows agree without anything
+   * here arranging it.
+   */
+  send: (frame: GessoFrame) => void;
+  /** Overrides `DEFAULT_CHUNK_BYTES`. Only a test should need to. */
+  chunkBytes?: number;
+  /**
+   * A url the window asked to have opened outside itself.
+   *
+   * `Utils.openExternal(url)` is what an Electrobun application passes
+   * here. It is not called for the application: opening something is
+   * an act, and which urls an application is willing to hand to the
+   * operating system is the application's decision.
+   */
+  onOpenUrl?: (url: string) => void;
+}
+interface ChannelHost {
+  /** Call from the RPC handler that receives frames from the window. */
+  receive(frame: GessoFrame): void;
+  /** Tells the window which appearance the platform is in. */
+  setColorScheme(scheme: 'light' | 'dark'): void;
+  /** Stops serving and disposes every channel this host provided. */
+  dispose(): void;
+}
+/**
+ * Serves an application's channels to one window.
+ *
+ *   const host = serveChannelsToWindow(
+ *     [{ token: Catalogue, source: { view: { … }, commands: { … } } }],
+ *     { send: frame => window.webview.rpc.send.gessoFrame(frame) }
+ *   );
+ */
+declare function serveChannelsToWindow(channels: readonly ServedChannel[], options: ChannelHostOptions): ChannelHost;
+//#endregion
+export { ChannelHost, ChannelHostOptions, serveChannelsToWindow };
+//# sourceMappingURL=main.d.ts.map

package/dist/main.js

@@ -0,0 +1,107 @@
+import { i as frameData, n as FrameAssembler, r as frameControl } from "./frames-BQisaYy-.js";
+import { serveChannels } from "gesso-framework";
+//#region src/main.ts
+/**
+* The main process's half of the bridge.
+*
+* `serveChannels` publishes an application's channels over a handshake
+* that arrives on a worker's global scope with a `MessagePort`
+* attached. No process boundary outside a worker can carry a port, so
+* this synthesises both: an `open` frame becomes the handshake, and
+* the port it hands over writes back as frames on the same stream.
+*
+* Nothing in `serveChannels`, `provide` or a view model changes for
+* this. That is the point of the seam: the application layer does not
+* learn it is talking to a window instead of a page.
+*/
+/**
+* Serves an application's channels to one window.
+*
+*   const host = serveChannelsToWindow(
+*     [{ token: Catalogue, source: { view: { … }, commands: { … } } }],
+*     { send: frame => window.webview.rpc.send.gessoFrame(frame) }
+*   );
+*/
+function serveChannelsToWindow(channels, options) {
+	const chunkBytes = options.chunkBytes ?? 1048576;
+	const assembler = new FrameAssembler();
+	/** The synthetic port each stream is served through. */
+	const ports = /* @__PURE__ */ new Map();
+	const host = { onmessage: null };
+	const stop = serveChannels(channels, host);
+	return {
+		setColorScheme(scheme) {
+			options.send(frameControl("colorScheme", { scheme }));
+		},
+		receive(frame) {
+			if (frame.kind === "control") {
+				if (frame.name === "openUrl") {
+					const payload = JSON.parse(frame.body);
+					if (typeof payload.url === "string") options.onOpenUrl?.(payload.url);
+				}
+				return;
+			}
+			if (frame.kind === "open") {
+				const port = new StreamPort(frame.stream, options.send, chunkBytes);
+				ports.set(frame.stream, port);
+				host.onmessage?.({
+					data: {
+						type: "gesso:port",
+						key: frame.name
+					},
+					ports: [port]
+				});
+				return;
+			}
+			if (frame.kind === "close") {
+				assembler.forget(frame.stream);
+				ports.delete(frame.stream);
+				return;
+			}
+			const value = assembler.take(frame);
+			if (value === void 0) return;
+			const port = ports.get(frame.stream);
+			if (port === void 0) throw new Error(`A frame arrived for stream ${frame.stream}, which was never opened. The window and the main process disagree about what is running.`);
+			port.deliver(value);
+		},
+		dispose() {
+			for (const stream of ports.keys()) options.send({
+				kind: "close",
+				stream
+			});
+			ports.clear();
+			stop();
+			host.onmessage = null;
+		}
+	};
+}
+/**
+* One channel's port, as the application layer sees it.
+*
+* `provide` sets `onmessage` and calls `postMessage`, and that is the
+* entire surface it uses, which is why a channel can be served over
+* something that is not a `MessagePort` at all.
+*/
+var StreamPort = class {
+	stream;
+	send;
+	chunkBytes;
+	onmessage = null;
+	constructor(stream, send, chunkBytes) {
+		this.stream = stream;
+		this.send = send;
+		this.chunkBytes = chunkBytes;
+	}
+	postMessage(value) {
+		for (const frame of frameData(this.stream, value, this.chunkBytes)) this.send(frame);
+	}
+	deliver(value) {
+		this.onmessage?.({ data: value });
+	}
+	/** `provide` closes a port it is done with; there is nothing to close. */
+	close() {}
+};
+//#endregion
+export { serveChannelsToWindow };
+
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","names":[],"sources":["../src/main.ts"],"sourcesContent":["/**\n * The main process's half of the bridge.\n *\n * `serveChannels` publishes an application's channels over a handshake\n * that arrives on a worker's global scope with a `MessagePort`\n * attached. No process boundary outside a worker can carry a port, so\n * this synthesises both: an `open` frame becomes the handshake, and\n * the port it hands over writes back as frames on the same stream.\n *\n * Nothing in `serveChannels`, `provide` or a view model changes for\n * this. That is the point of the seam: the application layer does not\n * learn it is talking to a window instead of a page.\n */\nimport { serveChannels, type PortHost, type ServedChannel } from 'gesso-framework';\n\nimport { DEFAULT_CHUNK_BYTES, FrameAssembler, frameControl, frameData, type GessoFrame } from './frames';\n\nexport interface ChannelHostOptions {\n  /**\n   * Sends one frame to the window, which is\n   * `window.webview.rpc.send.<name>`. One host per window: each keeps\n   * its own streams, and `provide` already keeps a separate record of\n   * what each client has seen, so two windows agree without anything\n   * here arranging it.\n   */\n  send: (frame: GessoFrame) => void;\n  /** Overrides `DEFAULT_CHUNK_BYTES`. Only a test should need to. */\n  chunkBytes?: number;\n  /**\n   * A url the window asked to have opened outside itself.\n   *\n   * `Utils.openExternal(url)` is what an Electrobun application passes\n   * here. It is not called for the application: opening something is\n   * an act, and which urls an application is willing to hand to the\n   * operating system is the application's decision.\n   */\n  onOpenUrl?: (url: string) => void;\n}\n\nexport interface ChannelHost {\n  /** Call from the RPC handler that receives frames from the window. */\n  receive(frame: GessoFrame): void;\n  /** Tells the window which appearance the platform is in. */\n  setColorScheme(scheme: 'light' | 'dark'): void;\n  /** Stops serving and disposes every channel this host provided. */\n  dispose(): void;\n}\n\n/**\n * Serves an application's channels to one window.\n *\n *   const host = serveChannelsToWindow(\n *     [{ token: Catalogue, source: { view: { … }, commands: { … } } }],\n *     { send: frame => window.webview.rpc.send.gessoFrame(frame) }\n *   );\n */\nexport function serveChannelsToWindow(channels: readonly ServedChannel[], options: ChannelHostOptions): ChannelHost {\n  const chunkBytes = options.chunkBytes ?? DEFAULT_CHUNK_BYTES;\n  const assembler = new FrameAssembler();\n  /** The synthetic port each stream is served through. */\n  const ports = new Map<number, StreamPort>();\n\n  // `servePorts` installs its chain on this and answers handshakes\n  // delivered through `onmessage`. It is the whole of the shim: a\n  // worker's global scope, as far as anything downstream can tell.\n  const host: PortHost = { onmessage: null };\n  const stop = serveChannels(channels, host);\n\n  return {\n    setColorScheme(scheme: 'light' | 'dark'): void {\n      options.send(frameControl('colorScheme', { scheme }));\n    },\n    receive(frame: GessoFrame): void {\n      if (frame.kind === 'control') {\n        if (frame.name === 'openUrl') {\n          const payload = JSON.parse(frame.body) as { url?: string };\n          if (typeof payload.url === 'string') {\n            options.onOpenUrl?.(payload.url);\n          }\n        }\n        return;\n      }\n      if (frame.kind === 'open') {\n        const port = new StreamPort(frame.stream, options.send, chunkBytes);\n        ports.set(frame.stream, port);\n        host.onmessage?.({\n          data: { type: 'gesso:port', key: frame.name },\n          // A `StreamPort` is a `MessagePort` in the two ways anything\n          // downstream uses one, and in no others. The cast is the\n          // seam; widening `PortHost` to admit a structural port would\n          // widen it for every worker as well.\n          ports: [port as unknown as MessagePort]\n        });\n        return;\n      }\n      if (frame.kind === 'close') {\n        assembler.forget(frame.stream);\n        ports.delete(frame.stream);\n        return;\n      }\n      const value = assembler.take(frame);\n      if (value === undefined) {\n        return;\n      }\n      const port = ports.get(frame.stream);\n      if (port === undefined) {\n        throw new Error(\n          `A frame arrived for stream ${frame.stream}, which was never opened. The window and the main process disagree about what is running.`\n        );\n      }\n      port.deliver(value);\n    },\n    dispose(): void {\n      for (const stream of ports.keys()) {\n        options.send({ kind: 'close', stream });\n      }\n      ports.clear();\n      stop();\n      host.onmessage = null;\n    }\n  };\n}\n\n/**\n * One channel's port, as the application layer sees it.\n *\n * `provide` sets `onmessage` and calls `postMessage`, and that is the\n * entire surface it uses, which is why a channel can be served over\n * something that is not a `MessagePort` at all.\n */\nclass StreamPort {\n  onmessage: ((event: { data: unknown }) => void) | null = null;\n\n  constructor(\n    private readonly stream: number,\n    private readonly send: (frame: GessoFrame) => void,\n    private readonly chunkBytes: number\n  ) {}\n\n  postMessage(value: unknown): void {\n    for (const frame of frameData(this.stream, value, this.chunkBytes)) {\n      this.send(frame);\n    }\n  }\n\n  deliver(value: unknown): void {\n    this.onmessage?.({ data: value });\n  }\n\n  /** `provide` closes a port it is done with; there is nothing to close. */\n  close(): void {}\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAwDA,SAAgB,sBAAsB,UAAoC,SAA0C;CAClH,MAAM,aAAa,QAAQ,cAAA;CAC3B,MAAM,YAAY,IAAI,eAAe;;CAErC,MAAM,wBAAQ,IAAI,IAAwB;CAK1C,MAAM,OAAiB,EAAE,WAAW,KAAK;CACzC,MAAM,OAAO,cAAc,UAAU,IAAI;CAEzC,OAAO;EACL,eAAe,QAAgC;GAC7C,QAAQ,KAAK,aAAa,eAAe,EAAE,OAAO,CAAC,CAAC;EACtD;EACA,QAAQ,OAAyB;GAC/B,IAAI,MAAM,SAAS,WAAW;IAC5B,IAAI,MAAM,SAAS,WAAW;KAC5B,MAAM,UAAU,KAAK,MAAM,MAAM,IAAI;KACrC,IAAI,OAAO,QAAQ,QAAQ,UACzB,QAAQ,YAAY,QAAQ,GAAG;IAEnC;IACA;GACF;GACA,IAAI,MAAM,SAAS,QAAQ;IACzB,MAAM,OAAO,IAAI,WAAW,MAAM,QAAQ,QAAQ,MAAM,UAAU;IAClE,MAAM,IAAI,MAAM,QAAQ,IAAI;IAC5B,KAAK,YAAY;KACf,MAAM;MAAE,MAAM;MAAc,KAAK,MAAM;KAAK;KAK5C,OAAO,CAAC,IAA8B;IACxC,CAAC;IACD;GACF;GACA,IAAI,MAAM,SAAS,SAAS;IAC1B,UAAU,OAAO,MAAM,MAAM;IAC7B,MAAM,OAAO,MAAM,MAAM;IACzB;GACF;GACA,MAAM,QAAQ,UAAU,KAAK,KAAK;GAClC,IAAI,UAAU,KAAA,GACZ;GAEF,MAAM,OAAO,MAAM,IAAI,MAAM,MAAM;GACnC,IAAI,SAAS,KAAA,GACX,MAAM,IAAI,MACR,8BAA8B,MAAM,OAAO,0FAC7C;GAEF,KAAK,QAAQ,KAAK;EACpB;EACA,UAAgB;GACd,KAAK,MAAM,UAAU,MAAM,KAAK,GAC9B,QAAQ,KAAK;IAAE,MAAM;IAAS;GAAO,CAAC;GAExC,MAAM,MAAM;GACZ,KAAK;GACL,KAAK,YAAY;EACnB;CACF;AACF;;;;;;;;AASA,IAAM,aAAN,MAAiB;CAII;CACA;CACA;CALnB,YAAyD;CAEzD,YACE,QACA,MACA,YACA;EAHiB,KAAA,SAAA;EACA,KAAA,OAAA;EACA,KAAA,aAAA;CAChB;CAEH,YAAY,OAAsB;EAChC,KAAK,MAAM,SAAS,UAAU,KAAK,QAAQ,OAAO,KAAK,UAAU,GAC/D,KAAK,KAAK,KAAK;CAEnB;CAEA,QAAQ,OAAsB;EAC5B,KAAK,YAAY,EAAE,MAAM,MAAM,CAAC;CAClC;;CAGA,QAAc,CAAC;AACjB"}

package/dist/view.d.ts

@@ -0,0 +1,52 @@
+import { r as GessoFrame } from "./frames-BrrAFMqE.js";
+import { AppLogicEndpoint } from "gesso-framework";
+//#region src/view.d.ts
+interface ElectrobunBridgeOptions {
+  /**
+   * Sends one frame to the main process, which is
+   * `view.rpc.send.<name>` for whichever message name the application
+   * declared. A function rather than the RPC object, so this package
+   * imports nothing from Electrobun's SDK and can be specified without
+   * a window.
+   */
+  send: (frame: GessoFrame) => void;
+  /** Overrides `DEFAULT_CHUNK_BYTES`. Only a test should need to. */
+  chunkBytes?: number;
+  /**
+   * The appearance the platform is in, as the main process reports it.
+   *
+   * Wire it to `app.setColorScheme`. It exists because
+   * `prefers-color-scheme` is not to be trusted in every webview: on
+   * WebKitGTK it reported light on a desktop that was in dark mode
+   *, and a shell that believes
+   * it is a browser gets the appearance wrong there.
+   */
+  onColorScheme?: (scheme: 'light' | 'dark') => void;
+}
+interface ElectrobunBridge {
+  /**
+   * Hand this to the shell as its application layer:
+   *
+   *   createApp({ renderWorker: …, appLogicWorker: bridge.endpoint })
+   *
+   * The shell wires it exactly as it wires a worker it was handed, and
+   * never closes it.
+   */
+  readonly endpoint: AppLogicEndpoint;
+  /** Call from the RPC handler that receives frames from the main process. */
+  receive(frame: GessoFrame): void;
+  /**
+   * Hands a url to the main process to open outside the window.
+   *
+   * Pass it as `onOpenUrl` to the shell: `window.open` in a webview
+   * opens another webview or nothing at all, and a link in a desktop
+   * application belongs in the person's browser.
+   */
+  openUrl(url: string): void;
+  /** Closes every stream and stops pumping. */
+  dispose(): void;
+}
+declare function createElectrobunBridge(options: ElectrobunBridgeOptions): ElectrobunBridge;
+//#endregion
+export { ElectrobunBridge, ElectrobunBridgeOptions, createElectrobunBridge };
+//# sourceMappingURL=view.d.ts.map

package/dist/view.js

@@ -0,0 +1,108 @@
+import { i as frameData, n as FrameAssembler, r as frameControl } from "./frames-BQisaYy-.js";
+import { isHubMessage, isPortHandshake } from "gesso-framework";
+//#region src/view.ts
+/**
+* The webview's half of the bridge.
+*
+* A Gesso render worker opens a named port per channel and expects the
+* application layer at the other end of it. In a desktop window the
+* application layer is in another process, reachable only from this
+* thread, so this stands in its place: it accepts the handshakes the
+* render worker sends and pumps each one over Electrobun's RPC as a
+* numbered stream.
+*
+* It is a transport and nothing else. It serializes a message it never
+* inspects, and it holds no channel, no token and no patch. Anything
+* that needs to understand a payload to route it belongs on the other
+* side of the bridge, and if that ever changes here, the wrong thing
+* is happening on the thread that must stay free for input.
+*/
+function createElectrobunBridge(options) {
+	const chunkBytes = options.chunkBytes ?? 1048576;
+	const assembler = new FrameAssembler();
+	/** The render worker's port for each stream this side opened. */
+	const ports = /* @__PURE__ */ new Map();
+	let hub = null;
+	let nextStream = 1;
+	let disposed = false;
+	const openStream = (name, port) => {
+		const stream = nextStream++;
+		ports.set(stream, port);
+		port.onmessage = (event) => {
+			for (const frame of frameData(stream, event.data, chunkBytes)) options.send(frame);
+		};
+		port.start?.();
+		options.send({
+			kind: "open",
+			stream,
+			name
+		});
+	};
+	return {
+		endpoint: {
+			postMessage(message, transfer) {
+				if (disposed) return;
+				if (isHubMessage(message)) {
+					const port = transfer?.[0];
+					if (port === void 0) throw new Error("The shell sent a hub message with no port attached.");
+					hub = port;
+					hub.onmessage = (event) => {
+						if (!isPortHandshake(event.data)) return;
+						const handshake = event.ports?.[0];
+						if (handshake === void 0) throw new Error(`Port handshake for '${event.data.key}' arrived with no port attached.`);
+						openStream(event.data.key, handshake);
+					};
+					hub.start?.();
+					return;
+				}
+			},
+			addEventListener() {},
+			removeEventListener() {}
+		},
+		openUrl(url) {
+			if (!disposed) options.send(frameControl("openUrl", { url }));
+		},
+		receive(frame) {
+			if (disposed) return;
+			if (frame.kind === "control") {
+				if (frame.name === "colorScheme") {
+					const payload = JSON.parse(frame.body);
+					if (payload.scheme !== void 0) options.onColorScheme?.(payload.scheme);
+				}
+				return;
+			}
+			if (frame.kind === "close") {
+				assembler.forget(frame.stream);
+				ports.get(frame.stream)?.close();
+				ports.delete(frame.stream);
+				return;
+			}
+			if (frame.kind !== "data") throw new Error(`The main process opened stream ${frame.stream}, which only the window may do.`);
+			const value = assembler.take(frame);
+			if (value === void 0) return;
+			const port = ports.get(frame.stream);
+			if (port === void 0) return;
+			port.postMessage(value);
+		},
+		dispose() {
+			disposed = true;
+			for (const [stream, port] of ports) {
+				options.send({
+					kind: "close",
+					stream
+				});
+				port.close();
+			}
+			ports.clear();
+			if (hub !== null) {
+				hub.onmessage = null;
+				hub.close();
+				hub = null;
+			}
+		}
+	};
+}
+//#endregion
+export { createElectrobunBridge };
+
+//# sourceMappingURL=view.js.map

package/dist/view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.js","names":[],"sources":["../src/view.ts"],"sourcesContent":["/**\n * The webview's half of the bridge.\n *\n * A Gesso render worker opens a named port per channel and expects the\n * application layer at the other end of it. In a desktop window the\n * application layer is in another process, reachable only from this\n * thread, so this stands in its place: it accepts the handshakes the\n * render worker sends and pumps each one over Electrobun's RPC as a\n * numbered stream.\n *\n * It is a transport and nothing else. It serializes a message it never\n * inspects, and it holds no channel, no token and no patch. Anything\n * that needs to understand a payload to route it belongs on the other\n * side of the bridge, and if that ever changes here, the wrong thing\n * is happening on the thread that must stay free for input.\n */\nimport { isHubMessage, isPortHandshake, type AppLogicEndpoint } from 'gesso-framework';\n\nimport { DEFAULT_CHUNK_BYTES, FrameAssembler, frameControl, frameData, type GessoFrame } from './frames';\n\nexport interface ElectrobunBridgeOptions {\n  /**\n   * Sends one frame to the main process, which is\n   * `view.rpc.send.<name>` for whichever message name the application\n   * declared. A function rather than the RPC object, so this package\n   * imports nothing from Electrobun's SDK and can be specified without\n   * a window.\n   */\n  send: (frame: GessoFrame) => void;\n  /** Overrides `DEFAULT_CHUNK_BYTES`. Only a test should need to. */\n  chunkBytes?: number;\n  /**\n   * The appearance the platform is in, as the main process reports it.\n   *\n   * Wire it to `app.setColorScheme`. It exists because\n   * `prefers-color-scheme` is not to be trusted in every webview: on\n   * WebKitGTK it reported light on a desktop that was in dark mode\n   *, and a shell that believes\n   * it is a browser gets the appearance wrong there.\n   */\n  onColorScheme?: (scheme: 'light' | 'dark') => void;\n}\n\nexport interface ElectrobunBridge {\n  /**\n   * Hand this to the shell as its application layer:\n   *\n   *   createApp({ renderWorker: …, appLogicWorker: bridge.endpoint })\n   *\n   * The shell wires it exactly as it wires a worker it was handed, and\n   * never closes it.\n   */\n  readonly endpoint: AppLogicEndpoint;\n  /** Call from the RPC handler that receives frames from the main process. */\n  receive(frame: GessoFrame): void;\n  /**\n   * Hands a url to the main process to open outside the window.\n   *\n   * Pass it as `onOpenUrl` to the shell: `window.open` in a webview\n   * opens another webview or nothing at all, and a link in a desktop\n   * application belongs in the person's browser.\n   */\n  openUrl(url: string): void;\n  /** Closes every stream and stops pumping. */\n  dispose(): void;\n}\n\nexport function createElectrobunBridge(options: ElectrobunBridgeOptions): ElectrobunBridge {\n  const chunkBytes = options.chunkBytes ?? DEFAULT_CHUNK_BYTES;\n  const assembler = new FrameAssembler();\n  /** The render worker's port for each stream this side opened. */\n  const ports = new Map<number, MessagePort>();\n  let hub: MessagePort | null = null;\n  let nextStream = 1;\n  let disposed = false;\n\n  const openStream = (name: string, port: MessagePort): void => {\n    const stream = nextStream++;\n    ports.set(stream, port);\n    port.onmessage = event => {\n      for (const frame of frameData(stream, event.data, chunkBytes)) {\n        options.send(frame);\n      }\n    };\n    port.start?.();\n    options.send({ kind: 'open', stream, name });\n  };\n\n  const endpoint: AppLogicEndpoint = {\n    postMessage(message: unknown, transfer?: Transferable[]): void {\n      if (disposed) {\n        return;\n      }\n      if (isHubMessage(message)) {\n        const port = transfer?.[0] as MessagePort | undefined;\n        if (port === undefined) {\n          throw new Error('The shell sent a hub message with no port attached.');\n        }\n        hub = port;\n        hub.onmessage = event => {\n          if (!isPortHandshake(event.data)) {\n            return;\n          }\n          const handshake = event.ports?.[0];\n          if (handshake === undefined) {\n            throw new Error(`Port handshake for '${event.data.key}' arrived with no port attached.`);\n          }\n          openStream(event.data.key, handshake);\n        };\n        hub.start?.();\n        return;\n      }\n      // Everything else the shell sends an application worker is about\n      // a worker in this page: console forwarding, today. The\n      // application process's console is its own, and reaching it is\n      // E1.2's business rather than the transport's.\n    },\n    addEventListener(): void {\n      // The shell listens here for console entries from the\n      // application worker. There is no worker, and nothing on the\n      // other side of the bridge speaks that protocol yet, so a\n      // listener would never be called and is not kept.\n    },\n    removeEventListener(): void {}\n  };\n\n  return {\n    endpoint,\n    openUrl(url: string): void {\n      if (!disposed) {\n        options.send(frameControl('openUrl', { url }));\n      }\n    },\n    receive(frame: GessoFrame): void {\n      if (disposed) {\n        return;\n      }\n      if (frame.kind === 'control') {\n        if (frame.name === 'colorScheme') {\n          const payload = JSON.parse(frame.body) as { scheme?: 'light' | 'dark' };\n          if (payload.scheme !== undefined) {\n            options.onColorScheme?.(payload.scheme);\n          }\n        }\n        // An unknown control name is ignored rather than thrown on: the\n        // main process may be newer than the window, which is ordinary\n        // during a hot reload.\n        return;\n      }\n      if (frame.kind === 'close') {\n        assembler.forget(frame.stream);\n        ports.get(frame.stream)?.close();\n        ports.delete(frame.stream);\n        return;\n      }\n      if (frame.kind !== 'data') {\n        // `open` is this side's word. One arriving from the main\n        // process means the two ends disagree about who starts a\n        // stream, which is worth hearing about rather than ignoring.\n        throw new Error(`The main process opened stream ${frame.stream}, which only the window may do.`);\n      }\n      const value = assembler.take(frame);\n      if (value === undefined) {\n        return;\n      }\n      const port = ports.get(frame.stream);\n      if (port === undefined) {\n        // A frame for a stream this side has closed. Ordinary during\n        // teardown, because the far end may already have sent.\n        return;\n      }\n      port.postMessage(value);\n    },\n    dispose(): void {\n      disposed = true;\n      for (const [stream, port] of ports) {\n        options.send({ kind: 'close', stream });\n        port.close();\n      }\n      ports.clear();\n      if (hub !== null) {\n        hub.onmessage = null;\n        hub.close();\n        hub = null;\n      }\n    }\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAmEA,SAAgB,uBAAuB,SAAoD;CACzF,MAAM,aAAa,QAAQ,cAAA;CAC3B,MAAM,YAAY,IAAI,eAAe;;CAErC,MAAM,wBAAQ,IAAI,IAAyB;CAC3C,IAAI,MAA0B;CAC9B,IAAI,aAAa;CACjB,IAAI,WAAW;CAEf,MAAM,cAAc,MAAc,SAA4B;EAC5D,MAAM,SAAS;EACf,MAAM,IAAI,QAAQ,IAAI;EACtB,KAAK,aAAY,UAAS;GACxB,KAAK,MAAM,SAAS,UAAU,QAAQ,MAAM,MAAM,UAAU,GAC1D,QAAQ,KAAK,KAAK;EAEtB;EACA,KAAK,QAAQ;EACb,QAAQ,KAAK;GAAE,MAAM;GAAQ;GAAQ;EAAK,CAAC;CAC7C;CAwCA,OAAO;EACL,UAAA;GAtCA,YAAY,SAAkB,UAAiC;IAC7D,IAAI,UACF;IAEF,IAAI,aAAa,OAAO,GAAG;KACzB,MAAM,OAAO,WAAW;KACxB,IAAI,SAAS,KAAA,GACX,MAAM,IAAI,MAAM,qDAAqD;KAEvE,MAAM;KACN,IAAI,aAAY,UAAS;MACvB,IAAI,CAAC,gBAAgB,MAAM,IAAI,GAC7B;MAEF,MAAM,YAAY,MAAM,QAAQ;MAChC,IAAI,cAAc,KAAA,GAChB,MAAM,IAAI,MAAM,uBAAuB,MAAM,KAAK,IAAI,iCAAiC;MAEzF,WAAW,MAAM,KAAK,KAAK,SAAS;KACtC;KACA,IAAI,QAAQ;KACZ;IACF;GAKF;GACA,mBAAyB,CAKzB;GACA,sBAA4B,CAAC;EAItB;EACP,QAAQ,KAAmB;GACzB,IAAI,CAAC,UACH,QAAQ,KAAK,aAAa,WAAW,EAAE,IAAI,CAAC,CAAC;EAEjD;EACA,QAAQ,OAAyB;GAC/B,IAAI,UACF;GAEF,IAAI,MAAM,SAAS,WAAW;IAC5B,IAAI,MAAM,SAAS,eAAe;KAChC,MAAM,UAAU,KAAK,MAAM,MAAM,IAAI;KACrC,IAAI,QAAQ,WAAW,KAAA,GACrB,QAAQ,gBAAgB,QAAQ,MAAM;IAE1C;IAIA;GACF;GACA,IAAI,MAAM,SAAS,SAAS;IAC1B,UAAU,OAAO,MAAM,MAAM;IAC7B,MAAM,IAAI,MAAM,MAAM,CAAC,EAAE,MAAM;IAC/B,MAAM,OAAO,MAAM,MAAM;IACzB;GACF;GACA,IAAI,MAAM,SAAS,QAIjB,MAAM,IAAI,MAAM,kCAAkC,MAAM,OAAO,gCAAgC;GAEjG,MAAM,QAAQ,UAAU,KAAK,KAAK;GAClC,IAAI,UAAU,KAAA,GACZ;GAEF,MAAM,OAAO,MAAM,IAAI,MAAM,MAAM;GACnC,IAAI,SAAS,KAAA,GAGX;GAEF,KAAK,YAAY,KAAK;EACxB;EACA,UAAgB;GACd,WAAW;GACX,KAAK,MAAM,CAAC,QAAQ,SAAS,OAAO;IAClC,QAAQ,KAAK;KAAE,MAAM;KAAS;IAAO,CAAC;IACtC,KAAK,MAAM;GACb;GACA,MAAM,MAAM;GACZ,IAAI,QAAQ,MAAM;IAChB,IAAI,YAAY;IAChB,IAAI,MAAM;IACV,MAAM;GACR;EACF;CACF;AACF"}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "gesso-electrobun",
+  "version": "0.1.0",
+  "description": "Run a Gesso application in an Electrobun window, with its stores in the main process.",
+  "license": "MIT",
+  "author": "Kevin Baker",
+  "homepage": "https://github.com/kevinpbaker/gesso#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kevinpbaker/gesso.git",
+    "directory": "packages/electrobun"
+  },
+  "bugs": {
+    "url": "https://github.com/kevinpbaker/gesso/issues"
+  },
+  "keywords": [
+    "gesso",
+    "canvas",
+    "ui",
+    "typescript",
+    "electrobun",
+    "desktop",
+    "webview",
+    "native",
+    "cross-platform"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./view": {
+      "types": "./dist/view.d.ts",
+      "default": "./dist/view.js"
+    },
+    "./main": {
+      "types": "./dist/main.d.ts",
+      "default": "./dist/main.js"
+    },
+    "./desktop": {
+      "types": "./dist/desktop.d.ts",
+      "default": "./dist/desktop.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "README.md",
+    "CHANGELOG.md",
+    "dist",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "gesso-framework": "^0.1.0"
+  },
+  "peerDependencies": {
+    "rxjs": "^7.8.2"
+  },
+  "devDependencies": {
+    "rxjs": "^7.8.2"
+  },
+  "scripts": {
+    "build": "tsdown"
+  }
+}