@wildwinter/app-shell 0.57.0 → 0.58.1

package/dist/view-client.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/view-protocol.ts","../src/view-client.ts"],"names":[],"mappings":"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","file":"view-client.cjs","sourcesContent":["// ---------------------------------------------------------------------------\n// The view host API (tier 2 view extensions): the messages between a view, a\n// web component an extension's installed package supplies, and the app that\n// hosts it in a sandboxed floating window (patterkit design/view-extensions.md).\n//\n// Both ends import this module: the app through `hostView`, a view through\n// `@wildwinter/app-shell/view-client`. It is types and constants only, so a\n// view's bundle takes nothing else from the shell.\n//\n// The transport is a MessagePort straight from the view to the editor's\n// renderer, which holds what the writer sees in both apps. Nothing is\n// answered before the view's hello names the API it was built for; a host\n// that can't serve that API refuses it with a sentence and closes the port.\n// ---------------------------------------------------------------------------\n\n/** The API this shell's hosts and clients speak. A host serves exactly this version. */\nexport const VIEW_API = 1;\n\n/** A host: the app a view runs in. */\nexport type ViewHostName = \"patter\" | \"storylets\";\n\n/** A JSON value, as extension data and host fields are. */\nexport type ViewJson = string | number | boolean | null | ViewJson[] | { [key: string]: ViewJson };\n\n// --- What a host hands a view ---------------------------------------------\n\n/**\n * A node of the host's project, in one envelope for both hosts.\n *\n * `kind` is the manifest's node kind (`line`, `card`, `project`, ...). `host`\n * holds the host's own fields for that kind, documented per host in the\n * shell's README; `ext` holds extension data by extension id, the view's own\n * and those its manifest `reads`, nothing else.\n */\nexport interface ViewNode {\n  readonly id: string;\n  readonly kind: string;\n  /** The containing node's id; null for the project. */\n  readonly parent: string | null;\n  /** A short label for the node, in the source language, as the editor names it. */\n  readonly label: string;\n  readonly host: { readonly [field: string]: ViewJson };\n  readonly ext: { readonly [extension: string]: { readonly [field: string]: ViewJson } };\n  /** The node's children in order, when they were asked for. */\n  readonly children?: readonly ViewNode[];\n  /** Set when somebody else holds the view's own extension data on this node: the sentence saying who. A write\n   *  touching the node is refused `held`; a view can show the node read-only meanwhile. */\n  readonly held?: string;\n}\n\n/** The selection, innermost first (a line, then its snippet, block, and scene). Empty when nothing is selected. */\nexport interface ViewSelection {\n  readonly path: readonly { readonly id: string; readonly kind: string }[];\n}\n\n/** A line's length: a recording's when there is one (`measured`), else the host's estimate from its text. */\nexport interface ViewMediaLength {\n  readonly seconds: number;\n  readonly measured: boolean;\n}\n\n/** The app's theme, for the view to draw in: its CSS custom properties and its colour scheme. */\nexport interface ViewTheme {\n  readonly scheme: \"light\" | \"dark\";\n  /** Custom property names, with their leading `--`, and their computed values. */\n  readonly tokens: { readonly [name: string]: string };\n}\n\n/** Whether the view may write, and why not when it may not, as a sentence for the view to show. */\nexport interface ViewWritable {\n  readonly readOnly: boolean;\n  readonly why?: string;\n}\n\n/**\n * One write to the view's own extension data: a field on a node, set to a value, or cleared when `value` is absent.\n *\n * `field` is a top-level field the manifest declares for that node's kind, never a path into one: changing one\n * entry of a map or record writes the whole field's new value. Read the node again just before writing, so the\n * write builds on any edit made in the editor meanwhile; requests are answered in order, so nothing lands between.\n *\n * One write is one undo step in one history: its edits are all on the project node, or none of them are (the\n * project's data and a scene's sit in different histories in Patterpad). `hostView` refuses a write that mixes them.\n */\nexport interface ViewEdit {\n  readonly node: string;\n  readonly field: string;\n  readonly value?: ViewJson;\n}\n\n/** Why a request was refused: a stable code for the view, and a sentence for the writer. */\nexport interface ViewRefusal {\n  readonly code:\n    | \"bad-request\"   // the request's shape is wrong\n    | \"unsupported\"   // the host has no such thing (media in Storyletter)\n    | \"gone\"          // a node the request names doesn't exist\n    | \"held\"          // somebody else holds the data the write would change\n    | \"read-only\"     // the project or the view is read-only\n    | \"failed\";       // the host tried and couldn't\n  readonly message: string;\n}\n\n// --- Requests --------------------------------------------------------------\n\n/** Each request a view can make: what it sends, and what a granted reply carries. */\nexport interface ViewRequests {\n  /** The project node: the host's project facts (Patter: cast, qualifiers, pad default; Storylets: boxes, tag groups). */\n  project: { args: Record<string, never>; value: ViewNode };\n  /** One node by id, and its children in order when `children` is true; null when there is no such node. */\n  node: { args: { id: string; children?: boolean }; value: ViewNode | null };\n  selection: { args: Record<string, never>; value: ViewSelection };\n  /** Lines' lengths by id. Refused `unsupported` by a host with no media. */\n  media: { args: { ids: string[] }; value: { [id: string]: ViewMediaLength } };\n  /** Writes to the view's own extension, applied as one undo step with the label, or refused whole. */\n  write: { args: { label: string; edits: ViewEdit[] }; value: { written: number } };\n  /** Reveal and select a node in the editor. */\n  select: { args: { id: string }; value: boolean };\n}\n\nexport type ViewOp = keyof ViewRequests;\n\n// --- Messages ----------------------------------------------------------------\n\n/** A view's first message. */\nexport interface ViewHello { readonly t: \"hello\"; readonly api: number }\n\nexport interface ViewRequest<K extends ViewOp = ViewOp> {\n  readonly t: \"request\";\n  readonly id: number;\n  readonly op: K;\n  readonly args: ViewRequests[K][\"args\"];\n}\n\n/** A key combination the view didn't handle, in the shell's portable spelling (\"Mod+Z\", \"Mod+Shift+Z\"), for the host to run. */\nexport interface ViewKey { readonly t: \"key\"; readonly combo: string }\n\nexport type ViewToHost = ViewHello | ViewRequest | ViewKey;\n\n/** The host's answer to a hello it can serve. */\nexport interface ViewWelcome {\n  readonly t: \"welcome\";\n  readonly api: number;\n  readonly host: ViewHostName;\n  /** The view's extension: its id, the installed version, and the version the project pins, if any. */\n  readonly extension: { readonly id: string; readonly version: string; readonly pinned?: string };\n  /** The view's own id within its manifest. */\n  readonly view: string;\n  /** The extension's project settings, by name. */\n  readonly settings: { readonly [name: string]: string };\n  readonly theme: ViewTheme;\n  readonly writable: ViewWritable;\n}\n\n/** The host's answer to a hello it can't serve, before it closes the port. */\nexport interface ViewRefused { readonly t: \"refused\"; readonly message: string }\n\nexport type ViewReply =\n  | { readonly t: \"reply\"; readonly id: number; readonly ok: true; readonly value: unknown }\n  | { readonly t: \"reply\"; readonly id: number; readonly ok: false; readonly refusal: ViewRefusal };\n\n/** What the host tells a view unasked. */\nexport interface ViewEvents {\n  /** The project changed: these nodes, or anything (\"all\"). Debounced; read again what you show. */\n  changed: { nodes: readonly string[] | \"all\" };\n  selection: ViewSelection;\n  theme: ViewTheme;\n  writable: ViewWritable;\n  /** The window is closing; the port goes next. */\n  closing: Record<string, never>;\n}\n\nexport type ViewEventName = keyof ViewEvents;\n\nexport interface ViewEvent<K extends ViewEventName = ViewEventName> {\n  readonly t: \"event\";\n  readonly name: K;\n  readonly value: ViewEvents[K];\n}\n\nexport type HostToView = ViewWelcome | ViewRefused | ViewReply | ViewEvent;\n\n// --- The port's arrival --------------------------------------------------------\n\n/** The IPC channel main sends each end's port on. */\nexport const VIEW_PORT_CHANNEL = \"wildwinter-view:port\";\n\n/** The window message a preload posts a port with, so page code (which can't see ipcRenderer) can take it. */\nexport const VIEW_PORT_MESSAGE = \"wildwinter-view:port\";\n\n/** What main tells the editor about a view whose port it is handing over. */\nexport interface ViewPortMeta {\n  /** The view window's id, unique while it's open. */\n  readonly window: number;\n  readonly extension: string;\n  readonly view: string;\n  readonly version: string;\n  readonly pinned?: string;\n  /** Set, with no port, when the view window has closed: the editor drops its handle for `window`. */\n  readonly closed?: true;\n}\n\n// --- The host's side: what an app implements, and what hostView gives back ----\n\n/**\n * What an app supplies `hostView` for one open view: its own model, as the\n * writer sees it (unsaved edits included). `hostView` answers the protocol\n * from it, checks every request's shape, keeps `ext` to the view's own\n * extension and its manifest's `reads`, and refuses writes when not writable.\n * Any method may return a promise.\n */\nexport interface ViewAdapter {\n  readonly host: ViewHostName;\n  /** The project node. */\n  project(): ViewNode | Promise<ViewNode>;\n  node(id: string, children: boolean): ViewNode | null | Promise<ViewNode | null>;\n  selection(): ViewSelection | Promise<ViewSelection>;\n  /** Absent in a host with no media; `hostView` then refuses `media` as unsupported. */\n  media?(ids: readonly string[]): { [id: string]: ViewMediaLength } | Promise<{ [id: string]: ViewMediaLength }>;\n  /** Apply the edits to `extension`'s data as one undo step with the label, or refuse them all. */\n  write(extension: string, label: string, edits: readonly ViewEdit[]): void | ViewRefusal | Promise<void | ViewRefusal>;\n  select(id: string): boolean | Promise<boolean>;\n  writable(extension: string): ViewWritable;\n  /** The extension's project settings, by name. */\n  settings(extension: string): { [name: string]: string };\n  /** Run a key combination the view passed on (undo, redo, the app's shortcuts). */\n  key?(combo: string): void;\n}\n\n/** What `hostView` returns, and `hostViews` for every open view: the app calls these as its model, selection,\n *  theme, or locks change. */\nexport interface ViewHandle {\n  changed(nodes: readonly string[] | \"all\"): void;\n  selection(): void;\n  theme(): void;\n  writable(): void;\n  close(): void;\n}\n","// ---------------------------------------------------------------------------\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-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"]}