overmux 0.0.9 → 0.0.10

package/dist/docs/400-reference/600-client/030-native-web-view.md

@@ -0,0 +1,166 @@
+---
+title: Native web views
+---
+
+`NativeWebView` embeds a website in Overmux Desktop using a chrome native webview.
+
+```tsx
+import { NativeWebView } from "overmux/client";
+
+export const Website = () => (
+  <NativeWebView
+    url="https://example.com"
+    style={{ width: "100%", height: 600 }}
+    fallback={
+      <a href="https://example.com" target="_blank" rel="noopener noreferrer">
+        Open website in browser
+      </a>
+    }
+  />
+);
+```
+
+## Props
+
+`NativeWebViewProps` and `NativeWebViewLoadError` are exported from `overmux/client`.
+
+### `url`
+
+**Required.** Type: `string`. The initial website URL.
+
+```tsx
+import { NativeWebView } from "overmux/client";
+
+<NativeWebView url="https://example.com" style={{ height: 600 }} />;
+```
+
+Changing this string navigates; rerendering the same URL preserves in-page navigation. A remount starts again at `url`, retaining cookies and site storage.
+
+A blocked `url` prop clears the native page, including when an HTTP allowance is revoked. Blocked in-page links leave the current page in place. See [`allowedHttpOrigins`](#allowedhttporigins) for permitted destinations.
+
+New-window links open in the system browser, not another embedded surface. The system browser has its own login state. Popup-based authentication flows may therefore not complete inside the embedded view; use in-page sign-in where supported.
+
+### `className`
+
+**Optional.** Type: `string`. No default. Applies a CSS class to the desktop placeholder `div`, not the embedded website.
+
+```tsx
+import { NativeWebView } from "overmux/client";
+
+<NativeWebView
+  url="https://example.com"
+  className="website-pane"
+  style={{ height: 600 }}
+/>;
+```
+
+Define the class in your application's stylesheet. See [Theming and CSS](./theming) for loading styles.
+
+### `style`
+
+**Optional.** Type: `React.CSSProperties`. No default. Applies inline styles to the desktop placeholder `div`.
+
+```tsx
+import { NativeWebView } from "overmux/client";
+
+<NativeWebView
+  url="https://example.com"
+  style={{ width: "100%", height: 600 }}
+/>;
+```
+
+Give the placeholder a **nonzero width and height**. The component has no default height. Desktop follows its rectangular position and size as the layout moves, scrolls or resizes. Hidden and zero-size placeholders hide the native surface without clearing its site data. See [Layout limitations](#layout-limitations) before using overlapping panes or CSS effects.
+
+### `fallback`
+
+**Optional.** Type: `React.ReactNode`. Content shown in browsers, PWAs and desktop versions without native web view support.
+
+```tsx
+import { NativeWebView } from "overmux/client";
+
+<NativeWebView
+  url="https://example.com"
+  style={{ height: 600 }}
+  fallback={
+    <a href="https://example.com" target="_blank" rel="noopener noreferrer">
+      Open website in browser
+    </a>
+  }
+/>;
+```
+
+
+### `onLoadError`
+
+**Optional.** Type: `(error: NativeWebViewLoadError) => void`. No default handler. Receives `{ url, code, message }` for main-page load failures, blocked destinations, invalid configuration or bridge errors.
+
+```tsx
+import { NativeWebView, type NativeWebViewLoadError } from "overmux/client";
+
+const reportLoadError = (error: NativeWebViewLoadError) => console.error(error);
+
+<NativeWebView
+  url="https://example.com"
+  style={{ height: 600 }}
+  onLoadError={reportLoadError}
+/>;
+```
+
+Main-page failures exclude subresource failures and aborted navigation superseded by a newer request.
+
+| Code | Meaning |
+| --- | --- |
+| Numeric string, such as `"-105"` | Chromium load error |
+| `ERR_URL_BLOCKED` | Destination rejected by navigation policy |
+| `ERR_DESKTOP_BRIDGE` | Bridge or configuration failure |
+| `ERR_OPEN_EXTERNAL` | Failed to open the system browser |
+| `ERR_RENDER_PROCESS_GONE` | Native renderer crashed; the surface is destroyed |
+
+Remount to retry after a native renderer crash.
+
+### `allowedHttpOrigins`
+
+**Optional.** Type: `string[]`. Defaults to `[]`. Additional plain-HTTP origins to permit. An origin is the scheme, hostname and port, without a path.
+
+```tsx
+import { NativeWebView } from "overmux/client";
+
+<NativeWebView
+  url="http://devbox.local:3000"
+  style={{ height: 600 }}
+  allowedHttpOrigins={["http://devbox.local:3000"]}
+/>;
+```
+
+HTTPS is allowed. HTTP is allowed for `localhost`, `127.0.0.1` and `[::1]`, plus exact origins in this list. Entries must be HTTP origins, optionally with a trailing slash. Wildcards, credentials, paths, queries and fragments are rejected. Matching includes the port. Other schemes are denied. Policy is enforced in Electron main for requested URLs, page navigation, redirects and new-window links.
+
+### `passthroughBindings`
+
+**Optional.** Type: `readonly ShortcutBinding[]`. Defaults to `[]`. Keyboard bindings to forward to the owning Overmux UI while the embedded page has focus. `ShortcutBinding` is exported from `overmux/client`.
+
+```tsx
+import { NativeWebView } from "overmux/client";
+
+<NativeWebView
+  url="https://example.com"
+  style={{ height: 600 }}
+  passthroughBindings={["Escape", "Control+Shift+X", ["F12", "P", "R"]]}
+/>;
+```
+
+Uses the same binding and chord syntax as [command shortcuts](./shortcuts), but does not require a matching command registration. A chord is a sequence of key presses, such as F12, then P, then R.
+
+Overmux desktop intercepts a completed configured binding before the embedded page receives it and forwards its keyboard input, including modifiers and releases, to the owning Overmux UI. That UI then handles it through its ordinary DOM listeners - for example, a dialog's Escape handler, a local `onKeyDown`, or the normal shortcut host. The embedded page remains sandboxed and receives no Overmux bridge or command capability.
+
+
+## Security and shared sessions
+
+Embedded pages have no Overmux bridge, preload script or Node access. Sandbox, context isolation and web security stay enabled. Permissions and downloads are denied.
+
+All native views across connected Overmux instances share **one persistent desktop browser session**, `persist:overmux-native-web`. Cookies and login state survive unmounting, switching instances and restarting Desktop. This session is separate from Overmux authentication and from the system browser. Unmounting destroys the surface, not site data. Clearing an Overmux instance does not clear native website logins. There is no per-view profile or partition option.
+
+## Layout limitations
+
+Native surfaces paint **above the DOM**, including React modals, menus and dropdowns. Use ordinary, non-overlapping rectangular panes. DOM stacking order, rounded corners, CSS transforms, ancestor clipping and arbitrary CSS effects are not faithfully reproduced. Bounds are clipped to the host window, not arbitrary DOM containers. Avoid layouts that depend on those effects; unmount the view when its native surface must not cover other content.
+
+There is no `visible` prop, toolbar, zoom or history API, overlap coordination, or pane/session restoration. Host document reloads, crashes, instance changes and window destruction also destroy its native surfaces.

package/dist/docs/400-reference/600-client/300-tech-stack-recommendations.md

@@ -8,5 +8,6 @@ We recommend:
 - [TanStack Router](https://tanstack.com/router) for routing.
 - [shadcn/ui](https://ui.shadcn.com/) for UI components.
 - [Zod](https://zod.dev/) for schemas and runtime validation.
+- [@pierre/diffs](https://diffs.com/) for building custom Git diff views.
 
 If your app already uses a different stack, follow its existing conventions.

package/dist/docs/400-reference/700-cli/600-docs.md

@@ -122,7 +122,7 @@ Inspect these files so guidance matches the versions used by the application.
 #### `tech-stack-recommendations`
 
 ```text
-Prefer pnpm as the package manager, TanStack Router for routing, shadcn/ui for UI components, and Zod for schemas and runtime validation. Follow the application's established stack when it already differs.
+Prefer pnpm as the package manager, TanStack Router for routing, shadcn/ui for UI components, and Zod for schemas and runtime validation. For custom Git diff views, prefer @pierre/diffs (https://diffs.com/). Follow the application's established stack when it already differs.
 ```
 
 [//]: # (END GENERATED AI CONTEXT)

package/dist/exports/client.d.ts

@@ -2,12 +2,51 @@ import { B as InstanceIdentity, w as ContractInputArguments } from "./index-Dk11
 import { z } from "zod";
 import { UseMutationResult } from "@tanstack/react-query";
 import { CSSProperties, ComponentType, ReactNode, RefObject } from "react";
-import { KeyBinding, KeyBinding as KeyBinding$1 } from "@overmux/keybindings";
+import { KeyBinding, KeyBinding as KeyBinding$1, KeySequence, ShortcutBinding, ShortcutBinding as ShortcutBinding$1, formatShortcutBinding } from "@overmux/keybindings";
 declare const enableBackgroundNotifications: () => Promise<boolean>;
 declare const disableBackgroundNotifications: () => Promise<void>;
+type NativeWebViewLoadError = {
+  url: string;
+  code: string;
+  message: string;
+};
+type NativeWebViewProps = {
+  url: string;
+  className?: string;
+  style?: CSSProperties;
+  fallback?: ReactNode;
+  onLoadError?: (error: NativeWebViewLoadError) => void;
+  allowedHttpOrigins?: string[];
+  passthroughBindings?: readonly ShortcutBinding$1[];
+};
+declare const NativeWebView: ({ url, className, style, fallback, onLoadError, allowedHttpOrigins, passthroughBindings }: NativeWebViewProps) => import("react").JSX.Element;
+type NativeWebViewBridge = {
+  version: 1;
+  command: (input: {
+    type: "create" | "destroy";
+    id: string;
+  } | {
+    type: "configure";
+    id: string;
+    url: string;
+    allowedHttpOrigins: string[];
+    passthroughBindings: readonly ShortcutBinding$1[];
+  }) => Promise<void>;
+  setBounds: (id: string, bounds: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+  }) => void;
+  onLoadError: (callback: (input: {
+    id: string;
+    error: NativeWebViewLoadError;
+  }) => void) => () => void;
+};
 type DesktopHost = {
   version: 1;
   platform: string;
+  nativeWebView?: NativeWebViewBridge;
   instance?: {
     report: (identity: {
       instanceId: string;
@@ -72,20 +111,17 @@ type OvermuxThemeScopeProps = {
 };
 declare const OvermuxPortal: ({ children, external }: OvermuxPortalProps) => import("react").ReactPortal | null;
 declare const OvermuxThemeScope: ({ children, className, contrast, scheme, style }: OvermuxThemeScopeProps) => import("react").JSX.Element;
-type KeySequence = readonly [KeyBinding$1, KeyBinding$1, ...KeyBinding$1[]];
-type ShortcutBinding = KeyBinding$1 | KeySequence;
 type ConditionalShortcutBinding = {
-  binding: ShortcutBinding;
+  binding: ShortcutBinding$1;
   when: {
     media: string;
   };
 };
-type CommandBinding = ShortcutBinding | ConditionalShortcutBinding;
+type CommandBinding = ShortcutBinding$1 | ConditionalShortcutBinding;
 type ChordPrefix = {
   binding: KeyBinding$1;
   unmatched: "replay-to-focused-input";
 };
-declare const formatShortcutBinding: (binding: ShortcutBinding) => string;
 type CommandRunResult$1 = Promise<unknown> | unknown;
 type CommandRun<TServerConfig, TParams> = (input: {
   overmuxServerApi: OvermuxServerApi<TServerConfig>;
@@ -254,5 +290,5 @@ type ShortcutInputTarget = {
   input: RefObject<HTMLElement | null>;
 };
 declare const useShortcutInputTarget: (target: ShortcutInputTarget) => void;
-export { type ChordPrefix, type CommandBinding, type CommandEntry, type CommandHandle, type ConditionalShortcutBinding, type InstanceIdentity, type KeyBinding, type KeySequence, type OvermuxClientAppearance, type OvermuxContrast, type OvermuxExternalPortalContainer, OvermuxHost, OvermuxPortal, type OvermuxPortalProps, type OvermuxScheme, type OvermuxServerApi, type OvermuxStyle, OvermuxThemeScope, type OvermuxThemeScopeProps, type OvermuxThemeToken, type ResourceResult, type ShortcutBinding, type ShortcutInputTarget, type SkipToken, type StreamResult, createOvermuxHooks, defineCommandRegistry, defineOvermuxClient, disableBackgroundNotifications, enableBackgroundNotifications, formatShortcutBinding, readClipboardText, skipToken, useCommand, useCommands, useShortcutInputTarget, writeClipboardText };
+export { type ChordPrefix, type CommandBinding, type CommandEntry, type CommandHandle, type ConditionalShortcutBinding, type InstanceIdentity, type KeyBinding, type KeySequence, NativeWebView, type NativeWebViewLoadError, type NativeWebViewProps, type OvermuxClientAppearance, type OvermuxContrast, type OvermuxExternalPortalContainer, OvermuxHost, OvermuxPortal, type OvermuxPortalProps, type OvermuxScheme, type OvermuxServerApi, type OvermuxStyle, OvermuxThemeScope, type OvermuxThemeScopeProps, type OvermuxThemeToken, type ResourceResult, type ShortcutBinding, type ShortcutInputTarget, type SkipToken, type StreamResult, createOvermuxHooks, defineCommandRegistry, defineOvermuxClient, disableBackgroundNotifications, enableBackgroundNotifications, formatShortcutBinding, readClipboardText, skipToken, useCommand, useCommands, useShortcutInputTarget, writeClipboardText };
 //# sourceMappingURL=client.d.ts.map

package/dist/exports/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","names":[],"sources":["../../src/internal/client/background-notifications.ts","../../src/internal/client/host/desktop-host.ts","../../src/internal/client/clipboard.ts","../../src/internal/client/browser-api.ts","../../src/internal/client/theme-scope.tsx","../../src/internal/client/client-definition.ts","../../src/internal/client/commands.tsx","../../src/internal/client/overmux-react.ts","../../src/internal/client/host/overmux-host.tsx","../../src/internal/client/shortcuts.tsx"],"mappings":"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"}
+{"version":3,"file":"client.d.ts","names":[],"sources":["../../src/internal/client/background-notifications.ts","../../src/internal/client/native-web-view.tsx","../../src/internal/client/host/desktop-host.ts","../../src/internal/client/clipboard.ts","../../src/internal/client/browser-api.ts","../../src/internal/client/theme-scope.tsx","../../src/internal/client/client-definition.ts","../../src/internal/client/commands.tsx","../../src/internal/client/overmux-react.ts","../../src/internal/client/host/overmux-host.tsx","../../src/internal/client/shortcuts.tsx"],"mappings":"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"}

package/dist/exports/client.js

@@ -3,7 +3,7 @@ import { a as notificationSchema, c as parseDeepLink, l as resolveOvermuxReturnT
 import { z } from "zod";
 import { QueryClient, QueryClientProvider, useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
 import { Component, createContext, createElement, useCallback, useContext, useEffect, useMemo, useReducer, useRef, useState, useSyncExternalStore } from "react";
-import { formatKeyBinding, keyBindingSchema, matchesKeyBinding, platformBinding } from "@overmux/keybindings";
+import { formatShortcutBinding, keyBindingSchema, keyBindingSequence, matchesKeyBinding, matchesShortcutBindingPrefix, normalizedShortcutBinding, shortcutBindingSchema } from "@overmux/keybindings";
 import { createPortal } from "react-dom";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 //#region src/internal/shared/background-notifications.ts
@@ -320,7 +320,6 @@ const writeClipboardText = async (text) => {
 };
 //#endregion
 //#region src/internal/client/client-definition.ts
-const shortcutBindingSchema = z.union([keyBindingSchema, z.array(keyBindingSchema).min(2)]);
 const commandBindingSchema = z.union([shortcutBindingSchema, z.object({
 	binding: shortcutBindingSchema,
 	when: z.object({ media: z.string().trim().min(1) })
@@ -329,7 +328,6 @@ const chordPrefixSchema = z.object({
 	binding: keyBindingSchema,
 	unmatched: z.literal("replay-to-focused-input")
 });
-const formatShortcutBinding = (binding) => typeof binding === "string" ? formatKeyBinding(binding) : binding.map(formatKeyBinding).join(" ");
 const validateBindings = (bindings) => bindings?.forEach((binding) => commandBindingSchema.parse(binding));
 const defineCommandRegistry = () => (commands) => Object.fromEntries(Object.entries(commands).map(([id, command]) => {
 	validateBindings(command.defaultBindings);
@@ -919,12 +917,6 @@ const installDeepLinkNavigation = ({ getInstance, navigate = defaultNavigate })
 };
 //#endregion
 //#region src/internal/client/shortcuts.tsx
-const bindingSequence = (binding) => typeof binding === "string" ? [binding] : [...binding];
-const normalizedBinding = (binding) => bindingSequence(binding).map((key) => platformBinding(key));
-const sequenceMatches = (binding, pending, event) => {
-	const sequence = normalizedBinding(binding);
-	return sequence.length > pending.length && pending.every((key, index) => sequence[index] === key) && matchesKeyBinding(sequence[pending.length], event);
-};
 const isTextInput = (element) => element instanceof HTMLInputElement || element instanceof HTMLSelectElement || element instanceof HTMLTextAreaElement || element instanceof HTMLElement && (element.isContentEditable || element.getAttribute("role") === "textbox");
 const acceptsTextInput = (bindings) => {
 	if (!(document.activeElement instanceof Element)) return false;
@@ -932,7 +924,7 @@ const acceptsTextInput = (bindings) => {
 	if (!terminal) return false;
 	if (terminal.closest("[data-copy-mode]")) return true;
 	return bindings.some((binding) => {
-		const sequence = bindingSequence(binding);
+		const sequence = keyBindingSequence(binding);
 		return sequence.length > 1 || sequence[0]?.startsWith("F") || sequence[0]?.includes("+");
 	});
 };
@@ -1030,8 +1022,8 @@ const ShortcutHost = ({ children, definition, registrations, registrationRevisio
 		window.addEventListener("focusin", refreshFocus);
 		return () => window.removeEventListener("focusin", refreshFocus);
 	}, []);
+	const shortcuts = flattenShortcuts(definition, (media) => window.matchMedia(media).matches);
 	useEffect(() => {
-		const shortcuts = flattenShortcuts(definition, (media) => window.matchMedia(media).matches);
 		let pending = [];
 		let pendingEvents = [];
 		let pendingTarget;
@@ -1061,7 +1053,11 @@ const ShortcutHost = ({ children, definition, registrations, registrationRevisio
 				clearPending();
 				return;
 			}
-			const matches = shortcuts.flatMap((shortcut) => shortcut.bindings.filter((binding) => sequenceMatches(binding, pending, event) && canRunShortcut(shortcut, event, registrations)).map((binding) => ({
+			const matches = shortcuts.flatMap((shortcut) => shortcut.bindings.filter((binding) => matchesShortcutBindingPrefix({
+				binding,
+				input: event,
+				pending
+			}) && canRunShortcut(shortcut, event, registrations)).map((binding) => ({
 				binding,
 				shortcut
 			})));
@@ -1073,14 +1069,14 @@ const ShortcutHost = ({ children, definition, registrations, registrationRevisio
 				}
 				return;
 			}
-			const complete = matches.find(({ binding }) => normalizedBinding(binding).length === pending.length + 1);
+			const complete = matches.find(({ binding }) => normalizedShortcutBinding(binding).length === pending.length + 1);
 			if (complete) {
 				clearPending();
 				if (runShortcut(complete.shortcut, event, registrations)) event.stopPropagation();
 				return;
 			}
 			if (!pending.length) pendingTarget = definition.chordPrefixes?.some((prefix) => matchesKeyBinding(prefix.binding, event)) ? selectShortcutInputTarget(inputTargets, document.activeElement) : void 0;
-			pending = [...pending, normalizedBinding(matches[0].binding)[pending.length]];
+			pending = [...pending, normalizedShortcutBinding(matches[0].binding)[pending.length]];
 			pendingEvents = [...pendingEvents, event];
 			event.preventDefault();
 			event.stopPropagation();
@@ -1906,6 +1902,118 @@ const OvermuxHost = ({ definition }) => /* @__PURE__ */ jsx(OvermuxThemeScope, {
 	children: location.pathname === "/_overmux/settings" ? /* @__PURE__ */ jsx(HostedSettingsPage, {}) : location.pathname === "/_overmux/logout" ? /* @__PURE__ */ jsx(HostedLogoutPage, {}) : /* @__PURE__ */ jsx(OvermuxRuntime, { definition })
 });
 //#endregion
-export { OvermuxHost, OvermuxPortal, OvermuxThemeScope, createOvermuxHooks, defineCommandRegistry, defineOvermuxClient, disableBackgroundNotifications, enableBackgroundNotifications, formatShortcutBinding, readClipboardText, skipToken, useCommand, useCommands, useShortcutInputTarget, writeClipboardText };
+//#region src/internal/client/native-web-view.tsx
+const command = async (view, input, url) => {
+	try {
+		await view.bridge.command(input);
+	} catch (error) {
+		view.report({
+			url,
+			code: "ERR_DESKTOP_BRIDGE",
+			message: String(error)
+		});
+	}
+};
+const trackBounds = (element, view) => {
+	let previous = "";
+	let frame = 0;
+	const measure = () => {
+		const rect = element.getBoundingClientRect();
+		const visible = !document.hidden && element.checkVisibility({
+			opacityProperty: true,
+			visibilityProperty: true
+		});
+		const bounds = {
+			x: Math.round(rect.x),
+			y: Math.round(rect.y),
+			width: visible ? Math.max(0, Math.round(rect.width)) : 0,
+			height: visible ? Math.max(0, Math.round(rect.height)) : 0
+		};
+		const key = JSON.stringify(bounds);
+		if (key !== previous) {
+			previous = key;
+			view.bridge.setBounds(view.id, bounds);
+		}
+	};
+	const tick = () => {
+		measure();
+		frame = requestAnimationFrame(tick);
+	};
+	tick();
+	document.addEventListener("visibilitychange", measure);
+	return () => {
+		cancelAnimationFrame(frame);
+		document.removeEventListener("visibilitychange", measure);
+	};
+};
+const NativeWebView = ({ url, className, style, fallback, onLoadError, allowedHttpOrigins = [], passthroughBindings = [] }) => {
+	const bridge = typeof window === "undefined" || window.overmuxHost?.version !== 1 || window.overmuxHost.nativeWebView?.version !== 1 ? void 0 : window.overmuxHost.nativeWebView;
+	const element = useRef(null);
+	const mounted = useRef(void 0);
+	const latest = useRef({
+		url,
+		onLoadError
+	});
+	latest.current = {
+		url,
+		onLoadError
+	};
+	const origins = JSON.stringify(allowedHttpOrigins);
+	const bindings = JSON.stringify(passthroughBindings);
+	useEffect(() => {
+		if (!bridge || !element.current) return;
+		const view = {
+			id: crypto.randomUUID(),
+			active: true,
+			bridge,
+			report: (error) => {
+				queueMicrotask(() => {
+					if (view.active) latest.current.onLoadError?.(error);
+				});
+			}
+		};
+		mounted.current = view;
+		const unsubscribe = bridge.onLoadError(({ id, error }) => {
+			if (id === view.id) view.report(error);
+		});
+		command(view, {
+			type: "create",
+			id: view.id
+		}, latest.current.url);
+		const stopTracking = trackBounds(element.current, view);
+		return () => {
+			view.active = false;
+			mounted.current = void 0;
+			stopTracking();
+			unsubscribe();
+			command(view, {
+				type: "destroy",
+				id: view.id
+			}, latest.current.url);
+		};
+	}, [bridge]);
+	useEffect(() => {
+		const view = mounted.current;
+		if (view) command(view, {
+			type: "configure",
+			id: view.id,
+			url,
+			allowedHttpOrigins: JSON.parse(origins),
+			passthroughBindings: JSON.parse(bindings)
+		}, url);
+	}, [
+		bindings,
+		bridge,
+		url,
+		origins
+	]);
+	return bridge ? /* @__PURE__ */ jsx("div", {
+		ref: element,
+		className,
+		style
+	}) : /* @__PURE__ */ jsx(Fragment, { children: fallback });
+};
+//#endregion
+export { NativeWebView, OvermuxHost, OvermuxPortal, OvermuxThemeScope, createOvermuxHooks, defineCommandRegistry, defineOvermuxClient, disableBackgroundNotifications, enableBackgroundNotifications, formatShortcutBinding, readClipboardText, skipToken, useCommand, useCommands, useShortcutInputTarget, writeClipboardText };
 
 //# sourceMappingURL=client.js.map