@wildwinter/app-shell 0.56.0 → 0.58.0

package/dist/view-client.d.cts

@@ -0,0 +1,46 @@
+import { ViewWelcome, ViewOp, ViewRequests, ViewNode, ViewSelection, ViewMediaLength, ViewEdit, ViewEventName, ViewEvents, ViewRefusal, ViewTheme } from './view-protocol.cjs';
+export { HostToView, VIEW_API, ViewHostName, ViewJson, ViewWritable } from './view-protocol.cjs';
+
+/** A refused request: the host's sentence as the message, and its refusal (`code`) for the view to act on. */
+declare class ViewRefusalError extends Error {
+    readonly refusal: ViewRefusal;
+    constructor(refusal: ViewRefusal);
+}
+interface ConnectOptions {
+    /** How long to wait for the port and the app's welcome, in ms (default 10000). */
+    timeoutMs?: number;
+    /** A port already in hand, instead of waiting for the preload's (tests, or a host of another kind). */
+    port?: MessagePort;
+    /** The window to listen on and apply the theme and keys to (default `window`). */
+    window?: Window;
+    /** Pass unhandled key combinations on to the app (default true). */
+    keys?: boolean;
+}
+interface ViewClient {
+    /** What the app said on welcoming the view: host, extension, view, settings, theme, writable. */
+    readonly welcome: ViewWelcome;
+    request<K extends ViewOp>(op: K, args: ViewRequests[K]["args"]): Promise<ViewRequests[K]["value"]>;
+    project(): Promise<ViewNode>;
+    node(id: string, opts?: {
+        children?: boolean;
+    }): Promise<ViewNode | null>;
+    selection(): Promise<ViewSelection>;
+    media(ids: string[]): Promise<{
+        [id: string]: ViewMediaLength;
+    }>;
+    write(label: string, edits: ViewEdit[]): Promise<{
+        written: number;
+    }>;
+    select(id: string): Promise<boolean>;
+    /** Listen for an event; returns the unsubscribe. */
+    on<K extends ViewEventName>(name: K, fn: (value: ViewEvents[K]) => void): () => void;
+    close(): void;
+}
+/** Set the theme's tokens as custom properties on the root, and its colour scheme. */
+declare function applyTheme(theme: ViewTheme, root?: HTMLElement): void;
+/** A key event in the shell's portable spelling ("Mod+Shift+Z"), or null for a bare modifier. */
+declare function comboOf(e: KeyboardEvent, mac: boolean): string | null;
+/** Wait for the app's port, say hello, and resolve once the app welcomes the view (rejected with its sentence). */
+declare function connect(opts?: ConnectOptions): Promise<ViewClient>;
+
+export { type ConnectOptions, type ViewClient, ViewEdit, ViewEventName, ViewEvents, ViewMediaLength, ViewNode, ViewOp, ViewRefusal, ViewRefusalError, ViewRequests, ViewSelection, ViewTheme, ViewWelcome, applyTheme, comboOf, connect };

package/dist/view-client.d.ts

@@ -0,0 +1,46 @@
+import { ViewWelcome, ViewOp, ViewRequests, ViewNode, ViewSelection, ViewMediaLength, ViewEdit, ViewEventName, ViewEvents, ViewRefusal, ViewTheme } from './view-protocol.js';
+export { HostToView, VIEW_API, ViewHostName, ViewJson, ViewWritable } from './view-protocol.js';
+
+/** A refused request: the host's sentence as the message, and its refusal (`code`) for the view to act on. */
+declare class ViewRefusalError extends Error {
+    readonly refusal: ViewRefusal;
+    constructor(refusal: ViewRefusal);
+}
+interface ConnectOptions {
+    /** How long to wait for the port and the app's welcome, in ms (default 10000). */
+    timeoutMs?: number;
+    /** A port already in hand, instead of waiting for the preload's (tests, or a host of another kind). */
+    port?: MessagePort;
+    /** The window to listen on and apply the theme and keys to (default `window`). */
+    window?: Window;
+    /** Pass unhandled key combinations on to the app (default true). */
+    keys?: boolean;
+}
+interface ViewClient {
+    /** What the app said on welcoming the view: host, extension, view, settings, theme, writable. */
+    readonly welcome: ViewWelcome;
+    request<K extends ViewOp>(op: K, args: ViewRequests[K]["args"]): Promise<ViewRequests[K]["value"]>;
+    project(): Promise<ViewNode>;
+    node(id: string, opts?: {
+        children?: boolean;
+    }): Promise<ViewNode | null>;
+    selection(): Promise<ViewSelection>;
+    media(ids: string[]): Promise<{
+        [id: string]: ViewMediaLength;
+    }>;
+    write(label: string, edits: ViewEdit[]): Promise<{
+        written: number;
+    }>;
+    select(id: string): Promise<boolean>;
+    /** Listen for an event; returns the unsubscribe. */
+    on<K extends ViewEventName>(name: K, fn: (value: ViewEvents[K]) => void): () => void;
+    close(): void;
+}
+/** Set the theme's tokens as custom properties on the root, and its colour scheme. */
+declare function applyTheme(theme: ViewTheme, root?: HTMLElement): void;
+/** A key event in the shell's portable spelling ("Mod+Shift+Z"), or null for a bare modifier. */
+declare function comboOf(e: KeyboardEvent, mac: boolean): string | null;
+/** Wait for the app's port, say hello, and resolve once the app welcomes the view (rejected with its sentence). */
+declare function connect(opts?: ConnectOptions): Promise<ViewClient>;
+
+export { type ConnectOptions, type ViewClient, ViewEdit, ViewEventName, ViewEvents, ViewMediaLength, ViewNode, ViewOp, ViewRefusal, ViewRefusalError, ViewRequests, ViewSelection, ViewTheme, ViewWelcome, applyTheme, comboOf, connect };

package/dist/view-client.js

@@ -0,0 +1,165 @@
+import { VIEW_API, VIEW_PORT_MESSAGE } from './chunk-ICYPXUNA.js';
+export { VIEW_API } from './chunk-ICYPXUNA.js';
+
+// src/view-client.ts
+var ViewRefusalError = class extends Error {
+  refusal;
+  constructor(refusal) {
+    super(refusal.message);
+    this.name = "ViewRefusalError";
+    this.refusal = refusal;
+  }
+};
+function applyTheme(theme, root = document.documentElement) {
+  for (const [name, value] of Object.entries(theme.tokens)) if (name.startsWith("--")) root.style.setProperty(name, value);
+  root.style.setProperty("color-scheme", theme.scheme);
+}
+var isMac = (w) => {
+  const nav = w.navigator;
+  return /mac|iphone|ipad/i.test(nav.userAgentData?.platform ?? nav.platform ?? nav.userAgent ?? "");
+};
+var NAMED = {
+  ArrowUp: "Up",
+  ArrowDown: "Down",
+  ArrowLeft: "Left",
+  ArrowRight: "Right",
+  Escape: "Esc",
+  " ": "Space"
+};
+function comboOf(e, mac) {
+  if (["Meta", "Control", "Shift", "Alt", "OS"].includes(e.key)) return null;
+  const parts = [];
+  if (mac ? e.metaKey : e.ctrlKey) parts.push("Mod");
+  if (mac && e.ctrlKey) parts.push("Ctrl");
+  if (e.altKey) parts.push("Alt");
+  if (e.shiftKey) parts.push("Shift");
+  let key;
+  if (/^Key[A-Z]$/.test(e.code)) key = e.code.slice(3);
+  else if (/^Digit[0-9]$/.test(e.code)) key = e.code.slice(5);
+  else key = NAMED[e.key] ?? (e.key.length === 1 ? e.key.toUpperCase() : e.key);
+  parts.push(key);
+  return parts.join("+");
+}
+var UNDO = /* @__PURE__ */ new Set(["Mod+Z", "Mod+Shift+Z", "Mod+Y"]);
+function connect(opts = {}) {
+  const w = opts.window ?? window;
+  const timeoutMs = opts.timeoutMs ?? 1e4;
+  return new Promise((resolve, reject) => {
+    let settled = false;
+    const fail = (message, port) => {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      w.removeEventListener("message", onWindow);
+      port?.close();
+      reject(new Error(message));
+    };
+    const timer = setTimeout(() => fail("The app didn't answer this view in time."), timeoutMs);
+    const begin = (port) => {
+      w.removeEventListener("message", onWindow);
+      const first = (e) => {
+        const msg = e.data;
+        if (!msg || typeof msg !== "object") return;
+        if (msg.t === "refused") {
+          port.removeEventListener("message", first);
+          fail(msg.message, port);
+          return;
+        }
+        if (msg.t !== "welcome" || settled) return;
+        settled = true;
+        clearTimeout(timer);
+        port.removeEventListener("message", first);
+        resolve(client(port, msg, w, opts.keys ?? true));
+      };
+      port.addEventListener("message", first);
+      port.start();
+      port.postMessage({ t: "hello", api: VIEW_API });
+    };
+    function onWindow(e) {
+      if (e.source !== w) return;
+      const d = e.data;
+      const ours = d === VIEW_PORT_MESSAGE || typeof d === "object" && d !== null && d.type === VIEW_PORT_MESSAGE;
+      const port = e.ports?.[0];
+      if (ours && port) begin(port);
+    }
+    if (opts.port) begin(opts.port);
+    else w.addEventListener("message", onWindow);
+  });
+}
+function client(port, welcome, w, keys) {
+  let next = 1;
+  let closed = false;
+  const waiting = /* @__PURE__ */ new Map();
+  const listeners = /* @__PURE__ */ new Map();
+  const root = w.document.documentElement;
+  applyTheme(welcome.theme, root);
+  const onMessage = (e) => {
+    const msg = e.data;
+    if (!msg || typeof msg !== "object") return;
+    if (msg.t === "reply") {
+      const p = waiting.get(msg.id);
+      if (!p) return;
+      waiting.delete(msg.id);
+      if (msg.ok) p.resolve(msg.value);
+      else p.reject(new ViewRefusalError(msg.refusal));
+    } else if (msg.t === "event") {
+      if (msg.name === "theme") applyTheme(msg.value, root);
+      for (const fn of listeners.get(msg.name) ?? []) {
+        try {
+          fn(msg.value);
+        } catch (err) {
+          console.error(err);
+        }
+      }
+    }
+  };
+  port.addEventListener("message", onMessage);
+  const mac = isMac(w);
+  const onKey = (e) => {
+    if (e.defaultPrevented || closed || !(e.metaKey || e.ctrlKey)) return;
+    const combo = comboOf(e, mac);
+    if (!combo) return;
+    if (UNDO.has(combo)) e.preventDefault();
+    port.postMessage({ t: "key", combo });
+  };
+  if (keys) w.addEventListener("keydown", onKey);
+  const request = (op, args) => {
+    if (closed) return Promise.reject(new Error("This view's connection to the app is closed."));
+    const id = next++;
+    return new Promise((resolve, reject) => {
+      waiting.set(id, { resolve, reject });
+      port.postMessage({ t: "request", id, op, args });
+    });
+  };
+  return {
+    welcome,
+    request,
+    project: () => request("project", {}),
+    node: (id, o) => request("node", o?.children !== void 0 ? { id, children: o.children } : { id }),
+    selection: () => request("selection", {}),
+    media: (ids) => request("media", { ids }),
+    write: (label, edits) => request("write", { label, edits }),
+    select: (id) => request("select", { id }),
+    on(name, fn) {
+      let set = listeners.get(name);
+      if (!set) listeners.set(name, set = /* @__PURE__ */ new Set());
+      set.add(fn);
+      return () => {
+        set.delete(fn);
+      };
+    },
+    close() {
+      if (closed) return;
+      closed = true;
+      w.removeEventListener("keydown", onKey);
+      port.removeEventListener("message", onMessage);
+      port.close();
+      for (const p of waiting.values()) p.reject(new Error("This view's connection to the app is closed."));
+      waiting.clear();
+    }
+  };
+}
+
+export { ViewRefusalError, applyTheme, comboOf, connect };
+//# sourceMappingURL=view-client.js.map
+//# sourceMappingURL=view-client.js.map

package/dist/view-client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/view-client.ts"],"names":[],"mappings":"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","file":"view-client.js","sourcesContent":["// ---------------------------------------------------------------------------\n// The view client (tier 2 view extensions), for VIEW AUTHORS: what a view's\n// web component imports to talk to the app it runs in. Tiny and\n// dependency-free: it imports nothing but the protocol's types and constants.\n//\n//   const app = await connect();\n//   const sel = await app.selection();\n//   app.on(\"changed\", () => redraw());\n//\n// Call `connect()` as the view's module loads (the port arrives once the page\n// has loaded, and a listener added later misses it). It applies the app's\n// theme to the page's root as custom properties (`var(--ink)`, ...), and\n// passes on key combinations the view doesn't handle (Mod+Z runs the\n// editor's undo); plain typing never leaves the view.\n// ---------------------------------------------------------------------------\n\nimport { VIEW_API, VIEW_PORT_MESSAGE } from \"./view-protocol.js\";\nimport type {\n  HostToView, ViewEdit, ViewEventName, ViewEvents, ViewMediaLength, ViewNode, ViewOp, ViewRefusal, ViewRequests,\n  ViewSelection, ViewTheme, ViewWelcome,\n} from \"./view-protocol.js\";\n\nexport type {\n  HostToView, ViewEdit, ViewEventName, ViewEvents, ViewHostName, ViewJson, ViewMediaLength, ViewNode, ViewOp,\n  ViewRefusal, ViewRequests, ViewSelection, ViewTheme, ViewWelcome, ViewWritable,\n} from \"./view-protocol.js\";\nexport { VIEW_API } from \"./view-protocol.js\";\n\n/** A refused request: the host's sentence as the message, and its refusal (`code`) for the view to act on. */\nexport class ViewRefusalError extends Error {\n  readonly refusal: ViewRefusal;\n  constructor(refusal: ViewRefusal) {\n    super(refusal.message);\n    this.name = \"ViewRefusalError\";\n    this.refusal = refusal;\n  }\n}\n\nexport interface ConnectOptions {\n  /** How long to wait for the port and the app's welcome, in ms (default 10000). */\n  timeoutMs?: number;\n  /** A port already in hand, instead of waiting for the preload's (tests, or a host of another kind). */\n  port?: MessagePort;\n  /** The window to listen on and apply the theme and keys to (default `window`). */\n  window?: Window;\n  /** Pass unhandled key combinations on to the app (default true). */\n  keys?: boolean;\n}\n\nexport interface ViewClient {\n  /** What the app said on welcoming the view: host, extension, view, settings, theme, writable. */\n  readonly welcome: ViewWelcome;\n  request<K extends ViewOp>(op: K, args: ViewRequests[K][\"args\"]): Promise<ViewRequests[K][\"value\"]>;\n  project(): Promise<ViewNode>;\n  node(id: string, opts?: { children?: boolean }): Promise<ViewNode | null>;\n  selection(): Promise<ViewSelection>;\n  media(ids: string[]): Promise<{ [id: string]: ViewMediaLength }>;\n  write(label: string, edits: ViewEdit[]): Promise<{ written: number }>;\n  select(id: string): Promise<boolean>;\n  /** Listen for an event; returns the unsubscribe. */\n  on<K extends ViewEventName>(name: K, fn: (value: ViewEvents[K]) => void): () => void;\n  close(): void;\n}\n\n/** Set the theme's tokens as custom properties on the root, and its colour scheme. */\nexport function applyTheme(theme: ViewTheme, root: HTMLElement = document.documentElement): void {\n  for (const [name, value] of Object.entries(theme.tokens)) if (name.startsWith(\"--\")) root.style.setProperty(name, value);\n  root.style.setProperty(\"color-scheme\", theme.scheme);\n}\n\nconst isMac = (w: Window): boolean => {\n  const nav = w.navigator as Navigator & { userAgentData?: { platform?: string } };\n  return /mac|iphone|ipad/i.test(nav.userAgentData?.platform ?? nav.platform ?? nav.userAgent ?? \"\");\n};\n\nconst NAMED: Record<string, string> = {\n  ArrowUp: \"Up\", ArrowDown: \"Down\", ArrowLeft: \"Left\", ArrowRight: \"Right\", Escape: \"Esc\", \" \": \"Space\",\n};\n\n/** A key event in the shell's portable spelling (\"Mod+Shift+Z\"), or null for a bare modifier. */\nexport function comboOf(e: KeyboardEvent, mac: boolean): string | null {\n  if ([\"Meta\", \"Control\", \"Shift\", \"Alt\", \"OS\"].includes(e.key)) return null;\n  const parts: string[] = [];\n  if (mac ? e.metaKey : e.ctrlKey) parts.push(\"Mod\");\n  if (mac && e.ctrlKey) parts.push(\"Ctrl\");\n  if (e.altKey) parts.push(\"Alt\");\n  if (e.shiftKey) parts.push(\"Shift\");\n  let key: string;\n  if (/^Key[A-Z]$/.test(e.code)) key = e.code.slice(3);\n  else if (/^Digit[0-9]$/.test(e.code)) key = e.code.slice(5);\n  else key = NAMED[e.key] ?? (e.key.length === 1 ? e.key.toUpperCase() : e.key);\n  parts.push(key);\n  return parts.join(\"+\");\n}\n\n/** The combinations whose page default is the page's own undo: the app's runs instead. */\nconst UNDO = new Set([\"Mod+Z\", \"Mod+Shift+Z\", \"Mod+Y\"]);\n\n/** Wait for the app's port, say hello, and resolve once the app welcomes the view (rejected with its sentence). */\nexport function connect(opts: ConnectOptions = {}): Promise<ViewClient> {\n  const w = opts.window ?? window;\n  const timeoutMs = opts.timeoutMs ?? 10000;\n  return new Promise<ViewClient>((resolve, reject) => {\n    let settled = false;\n    const fail = (message: string, port?: MessagePort): void => {\n      if (settled) return;\n      settled = true;\n      clearTimeout(timer);\n      w.removeEventListener(\"message\", onWindow);\n      port?.close();\n      reject(new Error(message));\n    };\n    const timer = setTimeout(() => fail(\"The app didn't answer this view in time.\"), timeoutMs);\n\n    const begin = (port: MessagePort): void => {\n      w.removeEventListener(\"message\", onWindow);\n      const first = (e: MessageEvent): void => {\n        const msg = e.data as HostToView;\n        if (!msg || typeof msg !== \"object\") return;\n        if (msg.t === \"refused\") { port.removeEventListener(\"message\", first as EventListener); fail(msg.message, port); return; }\n        if (msg.t !== \"welcome\" || settled) return;\n        settled = true;\n        clearTimeout(timer);\n        port.removeEventListener(\"message\", first as EventListener);\n        resolve(client(port, msg, w, opts.keys ?? true));\n      };\n      port.addEventListener(\"message\", first as EventListener);\n      port.start();\n      port.postMessage({ t: \"hello\", api: VIEW_API });\n    };\n    function onWindow(e: MessageEvent): void {\n      if (e.source !== w) return;\n      const d = e.data as unknown;\n      const ours = d === VIEW_PORT_MESSAGE || (typeof d === \"object\" && d !== null && (d as { type?: unknown }).type === VIEW_PORT_MESSAGE);\n      const port = e.ports?.[0];\n      if (ours && port) begin(port);\n    }\n    if (opts.port) begin(opts.port);\n    else w.addEventListener(\"message\", onWindow);\n  });\n}\n\nfunction client(port: MessagePort, welcome: ViewWelcome, w: Window, keys: boolean): ViewClient {\n  let next = 1;\n  let closed = false;\n  const waiting = new Map<number, { resolve: (v: unknown) => void; reject: (e: Error) => void }>();\n  const listeners = new Map<ViewEventName, Set<(value: never) => void>>();\n  const root = w.document.documentElement;\n  applyTheme(welcome.theme, root);\n\n  const onMessage = (e: MessageEvent): void => {\n    const msg = e.data as HostToView;\n    if (!msg || typeof msg !== \"object\") return;\n    if (msg.t === \"reply\") {\n      const p = waiting.get(msg.id);\n      if (!p) return;\n      waiting.delete(msg.id);\n      if (msg.ok) p.resolve(msg.value);\n      else p.reject(new ViewRefusalError(msg.refusal));\n    } else if (msg.t === \"event\") {\n      if (msg.name === \"theme\") applyTheme(msg.value as ViewTheme, root);\n      for (const fn of listeners.get(msg.name) ?? []) {\n        try { (fn as (v: unknown) => void)(msg.value); } catch (err) { console.error(err); }\n      }\n    }\n  };\n  port.addEventListener(\"message\", onMessage as EventListener);\n\n  const mac = isMac(w);\n  const onKey = (e: KeyboardEvent): void => {\n    if (e.defaultPrevented || closed || !(e.metaKey || e.ctrlKey)) return;\n    const combo = comboOf(e, mac);\n    if (!combo) return;\n    if (UNDO.has(combo)) e.preventDefault();\n    port.postMessage({ t: \"key\", combo });\n  };\n  if (keys) w.addEventListener(\"keydown\", onKey);\n\n  const request = <K extends ViewOp>(op: K, args: ViewRequests[K][\"args\"]): Promise<ViewRequests[K][\"value\"]> => {\n    if (closed) return Promise.reject(new Error(\"This view's connection to the app is closed.\"));\n    const id = next++;\n    return new Promise((resolve, reject) => {\n      waiting.set(id, { resolve: resolve as (v: unknown) => void, reject });\n      port.postMessage({ t: \"request\", id, op, args });\n    });\n  };\n\n  return {\n    welcome,\n    request,\n    project: () => request(\"project\", {}),\n    node: (id, o) => request(\"node\", o?.children !== undefined ? { id, children: o.children } : { id }),\n    selection: () => request(\"selection\", {}),\n    media: (ids) => request(\"media\", { ids }),\n    write: (label, edits) => request(\"write\", { label, edits }),\n    select: (id) => request(\"select\", { id }),\n    on(name, fn) {\n      let set = listeners.get(name);\n      if (!set) listeners.set(name, (set = new Set()));\n      set.add(fn as (value: never) => void);\n      return () => { set.delete(fn as (value: never) => void); };\n    },\n    close() {\n      if (closed) return;\n      closed = true;\n      w.removeEventListener(\"keydown\", onKey);\n      port.removeEventListener(\"message\", onMessage as EventListener);\n      port.close();\n      for (const p of waiting.values()) p.reject(new Error(\"This view's connection to the app is closed.\"));\n      waiting.clear();\n    },\n  };\n}\n"]}

package/dist/view-host-web.cjs

@@ -0,0 +1,327 @@
+'use strict';
+
+// src/view-protocol.ts
+var VIEW_API = 1;
+var VIEW_PORT_MESSAGE = "wildwinter-view:port";
+
+// src/view-host-web.ts
+var PALETTE_TOKENS = [
+  "--bg",
+  "--surface",
+  "--card",
+  "--ink",
+  "--muted",
+  "--line",
+  "--line-soft",
+  "--accent",
+  "--accent-soft",
+  "--on-accent",
+  "--danger",
+  "--warn",
+  "--ok",
+  "--font-ui",
+  "--font-read",
+  "--font-mono",
+  ...Array.from({ length: 12 }, (_, i) => `--char-${i}`)
+];
+var GRAMMAR_TOKENS = [
+  "--color-scheme",
+  "--chrome-size",
+  "--scrim",
+  "--shadow-1",
+  "--shadow-2",
+  "--shadow-3",
+  "--ease-standard",
+  "--dur-quick",
+  "--dur-base",
+  "--dur-settle",
+  "--dur-slow",
+  "--dur-panel",
+  "--dur-exit",
+  "--radius-sm",
+  "--radius-md",
+  "--radius-lg",
+  "--radius-pill",
+  "--scroll-thumb",
+  "--scroll-thumb-hover"
+];
+var VIEW_THEME_TOKENS = [...PALETTE_TOKENS, ...GRAMMAR_TOKENS];
+function readTheme(root = document.documentElement, tokens = VIEW_THEME_TOKENS) {
+  const style = getComputedStyle(root);
+  const out = {};
+  for (const name of tokens) {
+    const value = style.getPropertyValue(name).trim();
+    if (value !== "") out[name] = value;
+  }
+  const declared = (style.getPropertyValue("color-scheme") || style.colorScheme || "").trim();
+  const words = declared.split(/\s+/);
+  let scheme = "light";
+  if (declared === "dark") scheme = "dark";
+  else if (words.includes("light") && words.includes("dark")) {
+    scheme = typeof matchMedia === "function" && matchMedia("(prefers-color-scheme: dark)").matches ? "dark" : "light";
+  }
+  return { scheme, tokens: out };
+}
+function onViewPort(fn, target = window, closed) {
+  const listener = (e) => {
+    if (e.source !== target) return;
+    const data = e.data;
+    if (!data || typeof data !== "object" || data.type !== VIEW_PORT_MESSAGE) return;
+    const port = e.ports?.[0];
+    const meta = data.meta;
+    if (!meta || typeof meta.window !== "number" || typeof meta.extension !== "string" || typeof meta.view !== "string") return;
+    if (meta.closed === true) {
+      closed?.(meta);
+      return;
+    }
+    if (!port) return;
+    fn(port, meta);
+  };
+  target.addEventListener("message", listener);
+  return () => target.removeEventListener("message", listener);
+}
+var NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;
+var isObj = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+var isId = (v) => typeof v === "string" && v !== "";
+function isJson(v, depth = 0) {
+  if (depth > 64) return false;
+  if (v === null || typeof v === "string" || typeof v === "boolean") return true;
+  if (typeof v === "number") return Number.isFinite(v);
+  if (Array.isArray(v)) return v.every((x) => isJson(x, depth + 1));
+  if (isObj(v)) return Object.getPrototypeOf(v) === Object.prototype && Object.values(v).every((x) => isJson(x, depth + 1));
+  return false;
+}
+var bad = (message) => ({ code: "bad-request", message });
+function argsProblem(op, args) {
+  switch (op) {
+    case "project":
+    case "selection":
+      return null;
+    case "node":
+      if (!isId(args["id"])) return "A node request names the node by its id.";
+      if (args["children"] !== void 0 && typeof args["children"] !== "boolean") return "A node request's children is true or false.";
+      return null;
+    case "media":
+      if (!Array.isArray(args["ids"]) || !args["ids"].every(isId)) return "A media request lists the lines' ids.";
+      return null;
+    case "select":
+      return isId(args["id"]) ? null : "A select request names the node by its id.";
+    case "write": {
+      if (typeof args["label"] !== "string" || args["label"].trim() === "") return "A write has a label, for the undo step.";
+      const edits = args["edits"];
+      if (!Array.isArray(edits)) return "A write lists its edits.";
+      for (const e of edits) {
+        if (!isObj(e) || !isId(e["node"])) return "Each edit names its node by id.";
+        if (typeof e["field"] !== "string" || !NAME.test(e["field"])) return "Each edit names one of the extension's fields, never a path inside one.";
+        if ("value" in e && e["value"] !== void 0 && !isJson(e["value"])) return `The value for ${e["field"]} isn't plain JSON.`;
+      }
+      return null;
+    }
+  }
+}
+var OPS = ["project", "node", "selection", "media", "write", "select"];
+function hostView(port, adapter, opts) {
+  const { meta } = opts;
+  const ext = meta.extension;
+  const allowed = /* @__PURE__ */ new Set([ext, ...opts.reads]);
+  const theme = opts.theme ?? (() => readTheme());
+  const debounceMs = opts.debounceMs ?? 100;
+  let welcomed = false;
+  let closed = false;
+  let pending = null;
+  let timer;
+  const post = (msg) => {
+    if (!closed) port.postMessage(msg);
+  };
+  const emit = (name, value) => {
+    if (welcomed) post({ t: "event", name, value });
+  };
+  const filterNode = (node) => {
+    const keptExt = {};
+    for (const [id, data] of Object.entries(node.ext ?? {})) if (allowed.has(id)) keptExt[id] = data;
+    const base = { id: node.id, kind: node.kind, parent: node.parent, label: node.label, host: node.host ?? {}, ext: keptExt };
+    const out = typeof node.held === "string" ? { ...base, held: node.held } : base;
+    return node.children ? { ...out, children: node.children.map(filterNode) } : out;
+  };
+  const answer = async (op, args) => {
+    switch (op) {
+      case "project":
+        return { value: filterNode(await adapter.project()) };
+      case "node": {
+        const node = await adapter.node(args["id"], args["children"] === true);
+        return { value: node ? filterNode(node) : null };
+      }
+      case "selection":
+        return { value: await adapter.selection() };
+      case "media":
+        if (!adapter.media) return { refusal: { code: "unsupported", message: "This app has no recordings or timings for lines." } };
+        return { value: await adapter.media(args["ids"]) };
+      case "select":
+        return { value: await adapter.select(args["id"]) };
+      case "write": {
+        const writable = adapter.writable(ext);
+        if (writable.readOnly) return { refusal: { code: "read-only", message: writable.why ?? "This project is read-only just now." } };
+        const edits = args["edits"].map((e) => "value" in e && e.value !== void 0 ? { node: e.node, field: e.field, value: e.value } : { node: e.node, field: e.field });
+        if (edits.length === 0) return { value: { written: 0 } };
+        if (edits.length > 1) {
+          const projectId = (await adapter.project()).id;
+          const onProject = edits.filter((e) => e.node === projectId).length;
+          if (onProject > 0 && onProject < edits.length) {
+            return { refusal: bad("A write changes the project or other nodes, not both: they undo separately. Make two writes.") };
+          }
+        }
+        const refused = await adapter.write(ext, args["label"], edits);
+        if (refused) return { refusal: refused };
+        return { value: { written: edits.length } };
+      }
+    }
+  };
+  const request = async (msg) => {
+    const id = msg["id"];
+    if (typeof id !== "number" || !Number.isInteger(id)) return;
+    const reply = (r) => post("refusal" in r ? { t: "reply", id, ok: false, refusal: r.refusal } : { t: "reply", id, ok: true, value: r.value });
+    const op = msg["op"];
+    if (typeof op !== "string" || !OPS.includes(op)) {
+      reply({ refusal: bad(`There's no request called ${JSON.stringify(op)}.`) });
+      return;
+    }
+    const args = msg["args"] ?? {};
+    if (!isObj(args)) {
+      reply({ refusal: bad("A request's args are an object.") });
+      return;
+    }
+    const problem = argsProblem(op, args);
+    if (problem) {
+      reply({ refusal: bad(problem) });
+      return;
+    }
+    try {
+      reply(await answer(op, args));
+    } catch (e) {
+      reply({ refusal: { code: "failed", message: `The app couldn't do that: ${e instanceof Error ? e.message : String(e)}` } });
+    }
+  };
+  const hello = (msg) => {
+    const api = msg["api"];
+    if (api !== VIEW_API) {
+      const who = `${opts.names?.extension ?? ext}'s ${opts.names?.view ?? meta.view}`;
+      const message = typeof api === "number" ? `${who} was built for view API ${api}; this app serves ${VIEW_API}.` : `${who} didn't say which view API it was built for; this app serves ${VIEW_API}.`;
+      post({ t: "refused", message });
+      close(false);
+      return;
+    }
+    const welcome = {
+      t: "welcome",
+      api: VIEW_API,
+      host: adapter.host,
+      extension: { id: ext, version: meta.version, ...meta.pinned !== void 0 ? { pinned: meta.pinned } : {} },
+      view: meta.view,
+      settings: adapter.settings(ext),
+      theme: theme(),
+      writable: adapter.writable(ext)
+    };
+    welcomed = true;
+    post(welcome);
+  };
+  const onMessage = (e) => {
+    const msg = e.data;
+    if (closed || !isObj(msg)) return;
+    if (!welcomed) {
+      if (msg["t"] === "hello") hello(msg);
+      return;
+    }
+    if (msg["t"] === "request") void request(msg);
+    else if (msg["t"] === "key" && typeof msg["combo"] === "string") adapter.key?.(msg["combo"]);
+  };
+  port.addEventListener("message", onMessage);
+  port.start();
+  const flush = () => {
+    timer = void 0;
+    const nodes = pending;
+    pending = null;
+    if (nodes === null) return;
+    emit("changed", { nodes: nodes === "all" ? "all" : [...nodes] });
+  };
+  function close(sayClosing = true) {
+    if (closed) return;
+    if (sayClosing) emit("closing", {});
+    clearTimeout(timer);
+    closed = true;
+    port.removeEventListener("message", onMessage);
+    port.close();
+  }
+  return {
+    changed(nodes) {
+      if (closed || !welcomed) return;
+      if (nodes === "all" || pending === "all") pending = "all";
+      else {
+        pending ??= /* @__PURE__ */ new Set();
+        for (const n of nodes) pending.add(n);
+      }
+      if (timer === void 0) timer = setTimeout(flush, debounceMs);
+    },
+    selection() {
+      if (closed || !welcomed) return;
+      void Promise.resolve().then(() => adapter.selection()).then((s) => emit("selection", s), () => {
+      });
+    },
+    theme() {
+      if (!closed) emit("theme", theme());
+    },
+    writable() {
+      if (!closed) emit("writable", adapter.writable(ext));
+    },
+    close: () => close(true)
+  };
+}
+function hostViews(setup, opts = {}) {
+  const handles = /* @__PURE__ */ new Map();
+  const drop = (meta) => {
+    handles.get(meta.window)?.close();
+    handles.delete(meta.window);
+  };
+  const stop = onViewPort((port, meta) => {
+    drop(meta);
+    const s = setup(meta);
+    if (!s) {
+      port.close();
+      return;
+    }
+    handles.set(meta.window, hostView(port, s.adapter, {
+      meta,
+      reads: s.reads,
+      ...s.names !== void 0 ? { names: s.names } : {},
+      ...opts.theme !== void 0 ? { theme: opts.theme } : {},
+      ...opts.debounceMs !== void 0 ? { debounceMs: opts.debounceMs } : {}
+    }));
+  }, opts.target ?? window, drop);
+  const each = (f) => {
+    for (const h of handles.values()) f(h);
+  };
+  return {
+    get size() {
+      return handles.size;
+    },
+    changed: (nodes) => each((h) => h.changed(nodes)),
+    selection: () => each((h) => h.selection()),
+    theme: () => each((h) => h.theme()),
+    writable: () => each((h) => h.writable()),
+    close: () => {
+      each((h) => h.close());
+      handles.clear();
+    },
+    dispose: () => {
+      stop();
+      each((h) => h.close());
+      handles.clear();
+    }
+  };
+}
+
+exports.VIEW_THEME_TOKENS = VIEW_THEME_TOKENS;
+exports.hostView = hostView;
+exports.hostViews = hostViews;
+exports.onViewPort = onViewPort;
+exports.readTheme = readTheme;
+//# sourceMappingURL=view-host-web.cjs.map
+//# sourceMappingURL=view-host-web.cjs.map