@volter/supercode-terminal 0.2.30

package/ui.mjs

@@ -0,0 +1,892 @@
+// src/ui.jsx
+import { useEffect, useMemo, useRef, useState } from "preact/hooks";
+import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
+var DEFAULT_LABELS = Object.freeze({
+  back: "Back to terminals",
+  control: "Control",
+  empty: "No terminal sessions are running.",
+  open: "Open",
+  refresh: "Refresh",
+  // what a session with no observed cwd or command is
+  session: "tmux session",
+  stop: "Stop",
+  subtitle: "Local tmux sessions",
+  title: "Terminals",
+  view: "View"
+});
+var WORKSPACE_LABELS = Object.freeze({
+  ...DEFAULT_LABELS,
+  attach: "Open session",
+  back: "Back to chats",
+  closeTab: "Detach terminal",
+  newTerminal: "New terminal",
+  noTabs: "Open a local session or start a new coding agent.",
+  open: "Open locally",
+  sessions: "Sessions",
+  fitViewport: "Fit terminal to window",
+  scaleViewport: "Keep terminal grid scaled",
+  stop: "Stop session",
+  terminal: "Terminal"
+});
+function record(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function normalizeTerminalUiState(value) {
+  const source = record(value) ?? {};
+  const attachment = record(source.attachment);
+  const normalizedAttachment = attachment && typeof attachment.id === "string" && typeof attachment.baseUrl === "string" && (attachment.mode === "observe" || attachment.mode === "control") ? {
+    id: attachment.id,
+    baseUrl: attachment.baseUrl,
+    mode: attachment.mode,
+    ...typeof attachment.sessionId === "string" ? { sessionId: attachment.sessionId } : {}
+  } : null;
+  const sessions = Array.isArray(source.sessions) ? source.sessions.flatMap((candidate) => {
+    const session = record(candidate);
+    if (!session || typeof session.id !== "string" || typeof session.label !== "string") return [];
+    return [{
+      id: session.id,
+      label: session.label,
+      cwd: typeof session.cwd === "string" ? session.cwd : null,
+      activeCommand: typeof session.activeCommand === "string" ? session.activeCommand : null,
+      owned: session.owned === true,
+      size: record(session.size) && Number.isInteger(session.size.columns) && session.size.columns > 0 && Number.isInteger(session.size.rows) && session.size.rows > 0 ? { columns: session.size.columns, rows: session.size.rows } : null
+    }];
+  }) : [];
+  return {
+    available: source.available === true,
+    canOpenLocal: source.canOpenLocal === true,
+    error: typeof source.error === "string" ? source.error : null,
+    sessions,
+    attachment: normalizedAttachment
+  };
+}
+function terminalPath(value) {
+  const complete = value.replaceAll("\\", "/");
+  const boundary = complete.lastIndexOf("/");
+  if (boundary < 0) return { leading: complete, separator: "", trailing: "" };
+  return {
+    leading: complete.slice(0, boundary),
+    separator: "/",
+    trailing: complete.slice(boundary + 1)
+  };
+}
+function TerminalPath({ value }) {
+  const path = terminalPath(value);
+  return /* @__PURE__ */ jsxs("small", { class: "sctui-path", title: value, children: [
+    /* @__PURE__ */ jsx("span", { children: path.leading }),
+    path.separator ? /* @__PURE__ */ jsx("i", { children: path.separator }) : null,
+    path.trailing ? /* @__PURE__ */ jsx("b", { children: path.trailing }) : null
+  ] });
+}
+var TERMINAL_THEME_SLOTS = ["foreground", "cursor", "black", "red", "green", "yellow", "blue", "magenta", "cyan", "white", "brightBlack", "brightRed", "brightGreen", "brightYellow", "brightBlue", "brightMagenta", "brightCyan", "brightWhite"];
+function terminalTheme(element) {
+  const probe = element.ownerDocument.createElement("span");
+  probe.hidden = true;
+  element.append(probe);
+  const theme = { background: "rgba(0, 0, 0, 0)" };
+  for (const slot of TERMINAL_THEME_SLOTS) {
+    const name = `--sctui-terminal-${slot.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`)}`;
+    probe.style.color = `var(${name}, var(${name}-default))`;
+    theme[slot] = getComputedStyle(probe).color;
+  }
+  probe.remove();
+  return theme;
+}
+function TerminalViewer(props) {
+  const [connector, setConnector] = useState(() => props.connect ?? null);
+  const [error, setError] = useState(null);
+  useEffect(() => {
+    if (props.connect) {
+      setConnector(() => props.connect);
+      return;
+    }
+    let disposed = false;
+    import("@volter/supercode-terminal/client").then((module) => {
+      if (!disposed) setConnector(() => module.connectTerminal);
+    }, (cause) => {
+      if (!disposed) setError(String(cause));
+    });
+    return () => {
+      disposed = true;
+    };
+  }, [props.connect]);
+  return connector ? /* @__PURE__ */ jsx(TerminalStreamViewer, { ...props, connect: connector }) : /* @__PURE__ */ jsx("div", { role: error ? "alert" : "status", children: error ?? "Loading terminal\u2026" });
+}
+function TerminalStreamViewer({ active = true, attachment, connect, convertEol = false, onReady, onActivity, onBell, onOpenLink, onRetry, onStatus, onTitle }) {
+  const root = useRef(null);
+  const runtime = useRef(null);
+  const searchInput = useRef(null);
+  const pasteDialog = useRef(null);
+  const bellTimer = useRef(null);
+  const activeRef = useRef(active);
+  const callbacks = useRef({});
+  const [status, setStatus] = useState("Loading terminal\u2026");
+  const [bellVisible, setBellVisible] = useState(false);
+  const [findOpen, setFindOpen] = useState(false);
+  const [findQuery, setFindQuery] = useState("");
+  const [findFound, setFindFound] = useState(null);
+  const [helpOpen, setHelpOpen] = useState(false);
+  const [historyOpen, setHistoryOpen] = useState(false);
+  const [pasteHistory, setPasteHistory] = useState([]);
+  const [pendingPaste, setPendingPaste] = useState(null);
+  activeRef.current = active;
+  callbacks.current = { onActivity, onBell, onOpenLink, onRetry, onStatus, onTitle };
+  const publishStatus = (next) => {
+    setStatus(next);
+    callbacks.current.onStatus?.(next);
+  };
+  const focusTerminal = () => runtime.current?.terminal.focus();
+  const closeFind = () => {
+    runtime.current?.search.clearDecorations();
+    setFindOpen(false);
+    queueMicrotask(focusTerminal);
+  };
+  const find = (direction = "next", query = findQuery) => {
+    if (!query || !runtime.current) return;
+    const found = runtime.current.search[direction === "previous" ? "findPrevious" : "findNext"](query, {
+      incremental: direction === "next"
+    });
+    setFindFound(found);
+  };
+  const openFind = () => {
+    setHelpOpen(false);
+    setHistoryOpen(false);
+    setFindOpen(true);
+    queueMicrotask(() => searchInput.current?.focus());
+  };
+  const sendPaste = (value, remember = true) => {
+    runtime.current?.terminal.paste(value);
+    if (!remember || value.length > 5e4) return;
+    setPasteHistory((current) => [value, ...current.filter((item) => item !== value)].slice(0, 20));
+  };
+  const proposePaste = (value) => {
+    setHistoryOpen(false);
+    if (value.length > 1e3 || /[\r\n]/.test(value)) setPendingPaste(value);
+    else sendPaste(value);
+  };
+  const saveContents = () => {
+    const terminal = runtime.current?.terminal;
+    if (!terminal) return;
+    const buffer = terminal.buffer.normal;
+    const lines = [];
+    for (let index = 0; index < buffer.length; index += 1) {
+      lines.push(buffer.getLine(index)?.translateToString(true) ?? "");
+    }
+    const blob = new Blob([`${lines.join("\n")}
+`], { type: "text/plain;charset=utf-8" });
+    const url = URL.createObjectURL(blob);
+    const link = document.createElement("a");
+    const name = (attachment.sessionId ?? "session").replaceAll(/[^a-z0-9_-]/gi, "-").slice(0, 80);
+    link.download = `terminal-${name}.txt`;
+    link.href = url;
+    link.click();
+    queueMicrotask(() => URL.revokeObjectURL(url));
+  };
+  useEffect(() => {
+    if (!root.current) return;
+    let disposed = false;
+    let disposeRuntime = () => void 0;
+    void Promise.all([
+      import("@xterm/addon-fit"),
+      import("@xterm/addon-search"),
+      import("@xterm/addon-web-links"),
+      import("@xterm/xterm")
+    ]).then(([{ FitAddon }, { SearchAddon }, { WebLinksAddon }, { Terminal }]) => {
+      if (disposed || !root.current) return;
+      const terminal = new Terminal({
+        allowTransparency: true,
+        convertEol,
+        cursorBlink: attachment.mode === "control",
+        disableStdin: attachment.mode !== "control",
+        fontFamily: "ui-monospace, SFMono-Regular, Menlo, Consolas, monospace",
+        fontSize: 12,
+        scrollback: 5e3,
+        theme: terminalTheme(root.current)
+      });
+      const fit = new FitAddon();
+      const search = new SearchAddon();
+      terminal.loadAddon(fit);
+      terminal.loadAddon(search);
+      terminal.loadAddon(new WebLinksAddon((_event, uri) => {
+        if (callbacks.current.onOpenLink) callbacks.current.onOpenLink(uri);
+        else globalThis.open(uri, "_blank", "noopener,noreferrer");
+      }));
+      terminal.open(root.current);
+      fit.fit();
+      runtime.current = { search, terminal };
+      const title = terminal.onTitleChange((value) => {
+        const normalized = value.replaceAll(/[\u0000-\u001f\u007f]/g, " ").trim().slice(0, 160);
+        if (normalized) callbacks.current.onTitle?.(normalized);
+      });
+      const bell = terminal.onBell(() => {
+        clearTimeout(bellTimer.current);
+        setBellVisible(true);
+        bellTimer.current = setTimeout(() => setBellVisible(false), 350);
+        callbacks.current.onBell?.();
+      });
+      let connected = false;
+      const handlers = {
+        onOpen() {
+          connected = true;
+          publishStatus(attachment.mode === "control" ? "Live \xB7 interactive" : "Live \xB7 read-only");
+        },
+        onOutput(data) {
+          if (disposed) return;
+          terminal.write(data);
+          if (!activeRef.current) callbacks.current.onActivity?.();
+        },
+        onResize(cols, rows) {
+          if (!disposed) terminal.resize(cols, rows);
+        },
+        onError(message) {
+          if (!disposed) {
+            publishStatus(message);
+            terminal.writeln(`\r
+${message}`);
+          }
+        },
+        onExit() {
+          connected = false;
+          if (!disposed) publishStatus("Terminal exited");
+        },
+        onClose() {
+          connected = false;
+          if (!disposed) setStatus((current) => {
+            const next = current === "Terminal exited" ? current : "Terminal disconnected";
+            callbacks.current.onStatus?.(next);
+            return next;
+          });
+        }
+      };
+      const size = { cols: terminal.cols, rows: terminal.rows };
+      let connection;
+      try {
+        connection = connect(attachment, handlers, size);
+      } catch (error) {
+        bell.dispose();
+        title.dispose();
+        terminal.dispose();
+        runtime.current = null;
+        throw error;
+      }
+      let resizeFrame = 0;
+      let sentSize = size;
+      const refit = () => {
+        if (disposed || !connected || attachment.mode !== "control") return;
+        fit.fit();
+        if (terminal.cols === sentSize.cols && terminal.rows === sentSize.rows) return;
+        sentSize = { cols: terminal.cols, rows: terminal.rows };
+        connection.resize(terminal.cols, terminal.rows);
+      };
+      const resizeObserver = attachment.mode === "control" && globalThis.ResizeObserver ? new ResizeObserver(() => {
+        cancelAnimationFrame(resizeFrame);
+        resizeFrame = requestAnimationFrame(refit);
+      }) : null;
+      resizeObserver?.observe(root.current);
+      const input = attachment.mode === "control" ? terminal.onData((data) => connection.write(data)) : null;
+      onReady?.({ focus() {
+        refit();
+        terminal.focus();
+      } });
+      const focus = () => {
+        if (activeRef.current && attachment.mode === "control") terminal.focus();
+      };
+      root.current.addEventListener("pointerdown", focus);
+      const paste = (event) => {
+        if (attachment.mode !== "control") return;
+        const value = event.clipboardData?.getData("text/plain");
+        if (!value) return;
+        event.preventDefault();
+        proposePaste(value);
+      };
+      root.current.addEventListener("paste", paste, true);
+      if (active) requestAnimationFrame(focus);
+      disposeRuntime = () => {
+        root.current?.removeEventListener("pointerdown", focus);
+        root.current?.removeEventListener("paste", paste, true);
+        input?.dispose();
+        resizeObserver?.disconnect();
+        cancelAnimationFrame(resizeFrame);
+        bell.dispose();
+        title.dispose();
+        connection.close();
+        terminal.dispose();
+        runtime.current = null;
+        clearTimeout(bellTimer.current);
+      };
+    }).catch((error) => {
+      if (!disposed) publishStatus(error instanceof Error ? error.message : "Could not load the terminal viewer");
+    });
+    return () => {
+      disposed = true;
+      disposeRuntime();
+    };
+  }, [attachment.id, attachment.mode, connect, convertEol]);
+  useEffect(() => {
+    if (!active || attachment.mode !== "control") return;
+    const focus = () => root.current?.querySelector(".xterm-helper-textarea")?.focus({ preventScroll: true });
+    focus();
+    requestAnimationFrame(focus);
+  }, [active, attachment.mode]);
+  useEffect(() => {
+    if (!pendingPaste) return;
+    queueMicrotask(() => pasteDialog.current?.querySelector("button")?.focus({ preventScroll: true }));
+  }, [pendingPaste]);
+  const retryable = status === "Terminal disconnected" || status === "Terminal connection failed";
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      class: "sctui-viewer",
+      "data-bell": String(bellVisible),
+      onKeyDownCapture: (event) => {
+        if (pendingPaste) {
+          if (event.key === "Escape") {
+            event.preventDefault();
+            setPendingPaste(null);
+            queueMicrotask(focusTerminal);
+          } else if (event.key === "Tab") {
+            const buttons = [...pasteDialog.current?.querySelectorAll("button") ?? []];
+            const first = buttons.at(0);
+            const last = buttons.at(-1);
+            if (event.shiftKey && document.activeElement === first) {
+              event.preventDefault();
+              last?.focus();
+            } else if (!event.shiftKey && document.activeElement === last) {
+              event.preventDefault();
+              first?.focus();
+            }
+          }
+          return;
+        }
+        if (event.key === "Escape" && findOpen) {
+          event.preventDefault();
+          closeFind();
+        } else if (event.key === "Escape" && (helpOpen || historyOpen)) {
+          event.preventDefault();
+          setHelpOpen(false);
+          setHistoryOpen(false);
+          queueMicrotask(focusTerminal);
+        } else if (event.altKey && event.shiftKey && !event.ctrlKey && !event.metaKey && event.code === "KeyF") {
+          event.preventDefault();
+          openFind();
+        }
+      },
+      children: [
+        /* @__PURE__ */ jsxs("div", { class: "sctui-viewerbar", children: [
+          /* @__PURE__ */ jsxs("div", { class: "sctui-status", "data-live": String(status.startsWith("Live")), role: "status", children: [
+            /* @__PURE__ */ jsx("span", { "aria-hidden": "true" }),
+            status,
+            retryable && onRetry ? /* @__PURE__ */ jsx("button", { type: "button", onClick: onRetry, children: "Reconnect" }) : null
+          ] }),
+          /* @__PURE__ */ jsxs("div", { class: "sctui-tools", "aria-label": "Terminal tools", children: [
+            /* @__PURE__ */ jsx("button", { type: "button", "aria-keyshortcuts": "Alt+Shift+F", "aria-label": "Find in terminal", title: `Find (${terminalShortcutLabel("F")})`, onClick: openFind, children: /* @__PURE__ */ jsx(SearchGlyph, {}) }),
+            /* @__PURE__ */ jsx("button", { type: "button", "aria-label": "Paste history", "aria-expanded": historyOpen, disabled: !pasteHistory.length, title: "Paste history (memory only)", onClick: () => {
+              setHelpOpen(false);
+              setHistoryOpen((open) => !open);
+            }, children: /* @__PURE__ */ jsx(HistoryGlyph, {}) }),
+            /* @__PURE__ */ jsx("button", { type: "button", "aria-label": "Save terminal contents", title: "Save terminal contents", onClick: saveContents, children: /* @__PURE__ */ jsx(DownloadGlyph, {}) }),
+            /* @__PURE__ */ jsx("button", { type: "button", "aria-label": "Terminal shortcut help", "aria-expanded": helpOpen, title: "Keyboard shortcuts", onClick: () => {
+              setHistoryOpen(false);
+              setHelpOpen((open) => !open);
+            }, children: /* @__PURE__ */ jsx(HelpGlyph, {}) })
+          ] })
+        ] }),
+        findOpen ? /* @__PURE__ */ jsxs("form", { class: "sctui-find", onSubmit: (event) => {
+          event.preventDefault();
+          find(event.shiftKey ? "previous" : "next");
+        }, children: [
+          /* @__PURE__ */ jsx(SearchGlyph, {}),
+          /* @__PURE__ */ jsx("input", { ref: searchInput, value: findQuery, "aria-label": "Find", placeholder: "Find", onInput: (event) => {
+            const query = event.currentTarget.value;
+            setFindQuery(query);
+            if (query) find("next", query);
+            else {
+              runtime.current?.search.clearDecorations();
+              setFindFound(null);
+            }
+          } }),
+          /* @__PURE__ */ jsx("small", { children: findFound === null ? "" : findFound ? "Match" : "No results" }),
+          /* @__PURE__ */ jsx("button", { type: "button", "aria-label": "Previous match", onClick: () => find("previous"), children: /* @__PURE__ */ jsx(UpGlyph, {}) }),
+          /* @__PURE__ */ jsx("button", { type: "button", "aria-label": "Next match", onClick: () => find("next"), children: /* @__PURE__ */ jsx(DownGlyph, {}) }),
+          /* @__PURE__ */ jsx("button", { type: "button", "aria-label": "Close find", onClick: closeFind, children: /* @__PURE__ */ jsx(CloseGlyph, {}) })
+        ] }) : null,
+        historyOpen ? /* @__PURE__ */ jsxs("div", { class: "sctui-popover sctui-paste-history", role: "menu", "aria-label": "Paste history", children: [
+          /* @__PURE__ */ jsxs("strong", { children: [
+            "Paste history ",
+            /* @__PURE__ */ jsxs("span", { children: [
+              /* @__PURE__ */ jsx("small", { children: "memory only" }),
+              /* @__PURE__ */ jsx("button", { type: "button", onClick: () => {
+                setPasteHistory([]);
+                setHistoryOpen(false);
+              }, children: "Clear" })
+            ] })
+          ] }),
+          pasteHistory.map((value, index) => /* @__PURE__ */ jsxs("button", { type: "button", role: "menuitem", onClick: () => proposePaste(value), children: [
+            /* @__PURE__ */ jsx("span", { children: value.replaceAll(/\s+/g, " ").slice(0, 90) }),
+            /* @__PURE__ */ jsxs("small", { children: [
+              value.length,
+              " chars"
+            ] })
+          ] }, `${index}:${value.length}`))
+        ] }) : null,
+        helpOpen ? /* @__PURE__ */ jsxs("div", { class: "sctui-popover sctui-shortcuts", role: "dialog", "aria-label": "Terminal keyboard shortcuts", children: [
+          /* @__PURE__ */ jsx("strong", { children: "Terminal shortcuts" }),
+          /* @__PURE__ */ jsxs("dl", { children: [
+            /* @__PURE__ */ jsxs("div", { children: [
+              /* @__PURE__ */ jsx("dt", { children: "New or attach" }),
+              /* @__PURE__ */ jsx("dd", { children: terminalShortcutLabel("T") })
+            ] }),
+            /* @__PURE__ */ jsxs("div", { children: [
+              /* @__PURE__ */ jsx("dt", { children: "Find" }),
+              /* @__PURE__ */ jsx("dd", { children: terminalShortcutLabel("F") })
+            ] }),
+            /* @__PURE__ */ jsxs("div", { children: [
+              /* @__PURE__ */ jsx("dt", { children: "Detach tab" }),
+              /* @__PURE__ */ jsx("dd", { children: terminalShortcutLabel("D") })
+            ] }),
+            /* @__PURE__ */ jsxs("div", { children: [
+              /* @__PURE__ */ jsx("dt", { children: "Previous / next tab" }),
+              /* @__PURE__ */ jsx("dd", { children: terminalShortcutLabel("[ / ]") })
+            ] }),
+            /* @__PURE__ */ jsxs("div", { children: [
+              /* @__PURE__ */ jsx("dt", { children: "Select tab" }),
+              /* @__PURE__ */ jsx("dd", { children: terminalShortcutLabel("1\u20139") })
+            ] })
+          ] }),
+          /* @__PURE__ */ jsx("small", { children: "Command and Control shortcuts stay with the browser and terminal." })
+        ] }) : null,
+        pendingPaste ? /* @__PURE__ */ jsxs("div", { class: "sctui-paste-confirm", ref: pasteDialog, role: "alertdialog", "aria-modal": "true", "aria-label": "Confirm terminal paste", children: [
+          /* @__PURE__ */ jsx("strong", { children: "Paste into this terminal?" }),
+          /* @__PURE__ */ jsxs("span", { children: [
+            pendingPaste.split(/\r?\n/).length,
+            " lines \xB7 ",
+            pendingPaste.length.toLocaleString(),
+            " characters"
+          ] }),
+          /* @__PURE__ */ jsx("pre", { children: pendingPaste.replaceAll(/\s+/g, " ").slice(0, 180) }),
+          /* @__PURE__ */ jsxs("div", { children: [
+            /* @__PURE__ */ jsx("button", { type: "button", onClick: () => {
+              setPendingPaste(null);
+              queueMicrotask(focusTerminal);
+            }, children: "Cancel" }),
+            /* @__PURE__ */ jsx("button", { type: "button", onClick: () => {
+              sendPaste(pendingPaste);
+              setPendingPaste(null);
+              queueMicrotask(focusTerminal);
+            }, children: "Paste" })
+          ] })
+        ] }) : null,
+        /* @__PURE__ */ jsx("div", { class: "sctui-screen", "data-active": String(active), ref: root })
+      ]
+    }
+  );
+}
+function TerminalGlyph() {
+  return /* @__PURE__ */ jsx("svg", { "aria-hidden": "true", viewBox: "0 0 16 16", children: /* @__PURE__ */ jsx("path", { d: "m3 4 3.5 4L3 12M8 12h5" }) });
+}
+function CloseGlyph() {
+  return /* @__PURE__ */ jsx("svg", { "aria-hidden": "true", viewBox: "0 0 16 16", children: /* @__PURE__ */ jsx("path", { d: "m4.5 4.5 7 7m0-7-7 7" }) });
+}
+function BackGlyph() {
+  return /* @__PURE__ */ jsx("svg", { "aria-hidden": "true", viewBox: "0 0 16 16", children: /* @__PURE__ */ jsx("path", { d: "m9.5 3.5-4.5 4.5 4.5 4.5M5 8h7" }) });
+}
+function PlusGlyph() {
+  return /* @__PURE__ */ jsx("svg", { "aria-hidden": "true", viewBox: "0 0 16 16", children: /* @__PURE__ */ jsx("path", { d: "M8 3v10M3 8h10" }) });
+}
+function SearchGlyph() {
+  return /* @__PURE__ */ jsxs("svg", { "aria-hidden": "true", viewBox: "0 0 16 16", children: [
+    /* @__PURE__ */ jsx("circle", { cx: "7", cy: "7", r: "3.5" }),
+    /* @__PURE__ */ jsx("path", { d: "m9.7 9.7 3 3" })
+  ] });
+}
+function HistoryGlyph() {
+  return /* @__PURE__ */ jsx("svg", { "aria-hidden": "true", viewBox: "0 0 16 16", children: /* @__PURE__ */ jsx("path", { d: "M3.2 5.3A5 5 0 1 1 3 10M3.2 5.3V2.7m0 2.6h2.6M8 4.8V8l2 1.3" }) });
+}
+function DownloadGlyph() {
+  return /* @__PURE__ */ jsx("svg", { "aria-hidden": "true", viewBox: "0 0 16 16", children: /* @__PURE__ */ jsx("path", { d: "M8 2.5v7m-2.5-2L8 10l2.5-2.5M3 12.5h10" }) });
+}
+function HelpGlyph() {
+  return /* @__PURE__ */ jsxs("svg", { "aria-hidden": "true", viewBox: "0 0 16 16", children: [
+    /* @__PURE__ */ jsx("circle", { cx: "8", cy: "8", r: "5.5" }),
+    /* @__PURE__ */ jsx("path", { d: "M6.7 6.2A1.5 1.5 0 0 1 8.2 5c1 0 1.7.6 1.7 1.5 0 1.4-1.8 1.4-1.8 2.6M8.1 11.4h.01" })
+  ] });
+}
+function UpGlyph() {
+  return /* @__PURE__ */ jsx("svg", { "aria-hidden": "true", viewBox: "0 0 16 16", children: /* @__PURE__ */ jsx("path", { d: "m4 10 4-4 4 4" }) });
+}
+function DownGlyph() {
+  return /* @__PURE__ */ jsx("svg", { "aria-hidden": "true", viewBox: "0 0 16 16", children: /* @__PURE__ */ jsx("path", { d: "m4 6 4 4 4-4" }) });
+}
+function ViewportGlyph({ mode }) {
+  return mode === "fit" ? /* @__PURE__ */ jsx("svg", { "aria-hidden": "true", viewBox: "0 0 16 16", children: /* @__PURE__ */ jsx("path", { d: "M6 3H3v3m7-3h3v3M6 13H3v-3m7 3h3v-3M3.5 3.5 6 6m6.5-2.5L10 6m-6.5 6.5L6 10m6.5 2.5L10 10" }) }) : /* @__PURE__ */ jsxs("svg", { "aria-hidden": "true", viewBox: "0 0 16 16", children: [
+    /* @__PURE__ */ jsx("rect", { x: "3", y: "4", width: "10", height: "8", rx: "1" }),
+    /* @__PURE__ */ jsx("path", { d: "M6 2.5h4M6 13.5h4" })
+  ] });
+}
+function terminalWorkspaceShortcut(event) {
+  if (!event.altKey || !event.shiftKey || event.ctrlKey || event.metaKey) return null;
+  if (/^Digit[1-9]$/.test(event.code)) return { action: "tab", index: Number(event.code.slice(-1)) - 1 };
+  if (event.code === "KeyD") return { action: "detach" };
+  if (event.code === "KeyT") return { action: "new" };
+  if (event.code === "BracketLeft") return { action: "previous" };
+  if (event.code === "BracketRight") return { action: "next" };
+  return null;
+}
+function terminalShortcutLabel(key) {
+  return /Mac|iPhone|iPad|iPod/i.test(globalThis.navigator?.platform ?? "") ? `\u2325\u21E7${key}` : `Alt+Shift+${key}`;
+}
+function TerminalWorkspace({
+  className = "",
+  createActions = [],
+  labels: labelOverrides,
+  onAttach,
+  onClose,
+  onCreate,
+  onOpen,
+  onRefresh,
+  onStop,
+  onViewportModeChange,
+  renderViewer,
+  state,
+  viewportMode = "scale"
+}) {
+  const labels = { ...WORKSPACE_LABELS, ...labelOverrides };
+  const [tabs, setTabs] = useState([]);
+  const [activeSessionId, setActiveSessionId] = useState(null);
+  const [menuOpen, setMenuOpen] = useState(false);
+  const [pending, setPending] = useState(false);
+  const [tabMetadata, setTabMetadata] = useState({});
+  const [tabStatuses, setTabStatuses] = useState({});
+  const menu = useRef(null);
+  const sessionById = useMemo(() => new Map(state.sessions.map((session) => [session.id, session])), [state.sessions]);
+  useEffect(() => {
+    const attachment = state.attachment;
+    if (!attachment?.sessionId) return;
+    setTabs((current) => {
+      const existing = current.findIndex((tab) => tab.sessionId === attachment.sessionId);
+      if (existing < 0) return [...current, { attachment, sessionId: attachment.sessionId }];
+      if (current[existing].attachment.id === attachment.id) return current;
+      const next = [...current];
+      next[existing] = { attachment, sessionId: attachment.sessionId };
+      return next;
+    });
+    setActiveSessionId(attachment.sessionId);
+  }, [state.attachment?.id, state.attachment?.sessionId]);
+  useEffect(() => {
+    if (!menuOpen) return;
+    const closeOutside = (event) => {
+      if (!menu.current?.contains(event.target)) setMenuOpen(false);
+    };
+    document.addEventListener("pointerdown", closeOutside, true);
+    return () => document.removeEventListener("pointerdown", closeOutside, true);
+  }, [menuOpen]);
+  const run = async (operation) => {
+    setPending(true);
+    try {
+      await operation();
+    } finally {
+      setPending(false);
+      setMenuOpen(false);
+    }
+  };
+  const attach = (session) => run(() => onAttach(session.id, session.owned ? "control" : "observe"));
+  const activate = (sessionId) => {
+    setActiveSessionId(sessionId);
+    setTabMetadata((current) => current[sessionId]?.attention ? { ...current, [sessionId]: { ...current[sessionId], attention: null } } : current);
+  };
+  const markAttention = (sessionId, attention) => setTabMetadata((current) => {
+    const existing = current[sessionId] ?? {};
+    if (existing.attention === "bell" || existing.attention === attention) return current;
+    return { ...current, [sessionId]: { ...existing, attention } };
+  });
+  const closeTab = (sessionId) => {
+    const index = tabs.findIndex((tab) => tab.sessionId === sessionId);
+    const next = tabs.filter((tab) => tab.sessionId !== sessionId);
+    setTabs(next);
+    if (activeSessionId === sessionId) {
+      setActiveSessionId(next[Math.min(index, next.length - 1)]?.sessionId ?? null);
+    }
+  };
+  const activeSession = activeSessionId ? sessionById.get(activeSessionId) : null;
+  const activeTab = activeSessionId ? tabs.find((tab) => tab.sessionId === activeSessionId) : null;
+  return /* @__PURE__ */ jsxs(
+    "section",
+    {
+      class: `sctui-workspace ${className}`.trim(),
+      "aria-label": labels.title,
+      onKeyDownCapture: (event) => {
+        if (event.key === "Escape" && menuOpen) {
+          event.preventDefault();
+          setMenuOpen(false);
+          menu.current?.querySelector(".sctui-session-trigger")?.focus();
+          return;
+        }
+        const shortcut = terminalWorkspaceShortcut(event);
+        if (!shortcut) return;
+        if ((shortcut.action === "previous" || shortcut.action === "next") && tabs.length) {
+          event.preventDefault();
+          const current = Math.max(0, tabs.findIndex((tab) => tab.sessionId === activeSessionId));
+          const step = shortcut.action === "next" ? 1 : -1;
+          activate(tabs[(current + step + tabs.length) % tabs.length].sessionId);
+          return;
+        }
+        if (shortcut.action === "tab") {
+          const tab = tabs[shortcut.index];
+          if (tab) {
+            event.preventDefault();
+            activate(tab.sessionId);
+          }
+          return;
+        }
+        if (shortcut.action === "detach" && activeSessionId) {
+          event.preventDefault();
+          closeTab(activeSessionId);
+          return;
+        }
+        if (shortcut.action === "new") {
+          event.preventDefault();
+          setMenuOpen(true);
+          queueMicrotask(() => menu.current?.querySelector('[role="menuitem"]')?.focus());
+        }
+      },
+      children: [
+        /* @__PURE__ */ jsxs("nav", { class: "sctui-tabbar", "aria-label": "Terminal tabs", children: [
+          /* @__PURE__ */ jsx("button", { class: "sctui-back", type: "button", "aria-label": labels.back, onClick: onClose, children: /* @__PURE__ */ jsx(BackGlyph, {}) }),
+          /* @__PURE__ */ jsx("div", { class: "sctui-tabs", role: "tablist", children: tabs.map((tab, index) => {
+            const session = sessionById.get(tab.sessionId);
+            const active = tab.sessionId === activeSessionId;
+            const metadata = tabMetadata[tab.sessionId] ?? {};
+            const status = tabStatuses[tab.sessionId] ?? "Loading terminal\u2026";
+            const title = metadata.title || session?.label || labels.terminal;
+            return /* @__PURE__ */ jsxs("div", { class: "sctui-tab", "data-active": String(active), children: [
+              /* @__PURE__ */ jsxs(
+                "button",
+                {
+                  type: "button",
+                  role: "tab",
+                  "aria-keyshortcuts": `Alt+Shift+${index + 1}`,
+                  "aria-selected": active,
+                  title: `${session?.cwd ?? title} \xB7 ${terminalShortcutLabel(String(index + 1))}`,
+                  onClick: () => activate(tab.sessionId),
+                  children: [
+                    /* @__PURE__ */ jsx(TerminalGlyph, {}),
+                    /* @__PURE__ */ jsx("span", { children: title }),
+                    /* @__PURE__ */ jsx("i", { "aria-label": `${status}${metadata.attention ? ` \xB7 ${metadata.attention}` : ""}`, "data-attention": metadata.attention ?? "none", "data-live": String(status.startsWith("Live")) })
+                  ]
+                }
+              ),
+              /* @__PURE__ */ jsx(
+                "button",
+                {
+                  type: "button",
+                  "aria-keyshortcuts": active ? "Alt+Shift+D" : void 0,
+                  "aria-label": `${labels.closeTab}: ${session?.label ?? labels.terminal}`,
+                  title: active ? `${labels.closeTab} (${terminalShortcutLabel("D")})` : labels.closeTab,
+                  onClick: () => closeTab(tab.sessionId),
+                  children: /* @__PURE__ */ jsx(CloseGlyph, {})
+                }
+              )
+            ] }, tab.sessionId);
+          }) }),
+          /* @__PURE__ */ jsxs("div", { class: "sctui-session-menu", ref: menu, children: [
+            /* @__PURE__ */ jsx(
+              "button",
+              {
+                class: "sctui-session-trigger",
+                type: "button",
+                "aria-expanded": menuOpen,
+                "aria-haspopup": "menu",
+                "aria-keyshortcuts": "Alt+Shift+T",
+                "aria-label": labels.newTerminal,
+                title: `${labels.newTerminal} (${terminalShortcutLabel("T")})`,
+                onClick: () => setMenuOpen((open) => !open),
+                children: /* @__PURE__ */ jsx(PlusGlyph, {})
+              }
+            ),
+            menuOpen ? /* @__PURE__ */ jsxs("div", { role: "menu", "aria-label": labels.newTerminal, children: [
+              createActions.length ? /* @__PURE__ */ jsx("strong", { children: labels.newTerminal }) : null,
+              createActions.map((action) => /* @__PURE__ */ jsxs("button", { role: "menuitem", type: "button", disabled: pending || !state.available || !onCreate, onClick: () => run(() => onCreate?.(action.id)), children: [
+                action.icon ? /* @__PURE__ */ jsx("span", { class: "sctui-action-icon", children: action.icon }) : /* @__PURE__ */ jsx(TerminalGlyph, {}),
+                /* @__PURE__ */ jsx("span", { children: action.label })
+              ] }, action.id)),
+              /* @__PURE__ */ jsxs("span", { class: "sctui-menu-heading", children: [
+                /* @__PURE__ */ jsx("strong", { children: labels.sessions }),
+                /* @__PURE__ */ jsx("button", { role: "menuitem", type: "button", disabled: pending, onClick: () => run(onRefresh), children: labels.refresh })
+              ] }),
+              state.sessions.map((session) => /* @__PURE__ */ jsxs("button", { role: "menuitem", type: "button", disabled: pending, onClick: () => attach(session), children: [
+                /* @__PURE__ */ jsx(TerminalGlyph, {}),
+                /* @__PURE__ */ jsxs("span", { children: [
+                  /* @__PURE__ */ jsx("b", { children: session.label }),
+                  /* @__PURE__ */ jsx(TerminalPath, { value: session.cwd ?? session.activeCommand ?? labels.session })
+                ] }),
+                /* @__PURE__ */ jsx("small", { children: session.owned ? labels.control : labels.view })
+              ] }, session.id))
+            ] }) : null
+          ] }),
+          activeTab?.attachment.mode === "control" && onViewportModeChange ? /* @__PURE__ */ jsx(
+            "button",
+            {
+              class: "sctui-viewport-action",
+              type: "button",
+              "aria-label": labels.fitViewport,
+              "aria-pressed": viewportMode === "fit",
+              title: viewportMode === "scale" ? labels.fitViewport : labels.scaleViewport,
+              onClick: () => onViewportModeChange(viewportMode === "scale" ? "fit" : "scale"),
+              children: /* @__PURE__ */ jsx(ViewportGlyph, { mode: viewportMode })
+            }
+          ) : null,
+          activeSession?.owned && state.canOpenLocal && onOpen ? /* @__PURE__ */ jsx("button", { class: "sctui-toolbar-action", type: "button", onClick: () => run(() => onOpen(activeSession.id)), children: labels.open }) : null,
+          activeSession?.owned ? /* @__PURE__ */ jsx("button", { class: "sctui-toolbar-action sctui-danger", type: "button", onClick: () => run(async () => {
+            await onStop(activeSession.id);
+            closeTab(activeSession.id);
+          }), children: labels.stop }) : null
+        ] }),
+        state.error ? /* @__PURE__ */ jsx("div", { class: "sctui-error", role: "alert", children: state.error }) : null,
+        /* @__PURE__ */ jsxs("div", { class: "sctui-terminals", children: [
+          tabs.map((tab) => {
+            const active = tab.sessionId === activeSessionId;
+            const viewer = renderViewer ? renderViewer(tab.attachment, {
+              active,
+              onActivity: () => {
+                if (!active) markAttention(tab.sessionId, "activity");
+              },
+              onBell: () => {
+                if (!active) markAttention(tab.sessionId, "bell");
+              },
+              onStatus: (status) => setTabStatuses((current) => current[tab.sessionId] === status ? current : { ...current, [tab.sessionId]: status }),
+              onTitle: (title) => setTabMetadata((current) => current[tab.sessionId]?.title === title ? current : { ...current, [tab.sessionId]: { ...current[tab.sessionId], title } }),
+              retry: () => {
+                const session = sessionById.get(tab.sessionId);
+                if (session) void attach(session);
+              }
+            }) : /* @__PURE__ */ jsx(
+              TerminalViewer,
+              {
+                active,
+                attachment: tab.attachment,
+                onActivity: () => {
+                  if (!active) markAttention(tab.sessionId, "activity");
+                },
+                onBell: () => {
+                  if (!active) markAttention(tab.sessionId, "bell");
+                },
+                onRetry: () => {
+                  const session = sessionById.get(tab.sessionId);
+                  if (session) void attach(session);
+                },
+                onStatus: (status) => setTabStatuses((current) => current[tab.sessionId] === status ? current : { ...current, [tab.sessionId]: status }),
+                onTitle: (title) => setTabMetadata((current) => current[tab.sessionId]?.title === title ? current : { ...current, [tab.sessionId]: { ...current[tab.sessionId], title } })
+              }
+            );
+            return /* @__PURE__ */ jsx("div", { class: "sctui-terminal", "data-active": String(active), children: viewer }, tab.sessionId);
+          }),
+          !tabs.length ? /* @__PURE__ */ jsxs("div", { class: "sctui-terminal-empty", children: [
+            /* @__PURE__ */ jsx(TerminalGlyph, {}),
+            /* @__PURE__ */ jsx("strong", { children: labels.noTabs }),
+            /* @__PURE__ */ jsx("button", { type: "button", onClick: () => setMenuOpen(true), children: labels.attach })
+          ] }) : null
+        ] })
+      ]
+    }
+  );
+}
+function TerminalPanel({
+  className = "",
+  createActions = [],
+  labels: labelOverrides,
+  onAttach,
+  onClose,
+  onCreate,
+  onDismiss,
+  onOpen,
+  onRefresh,
+  onStop,
+  renderViewer,
+  state
+}) {
+  const [pending, setPending] = useState(false);
+  const leadingButton = useRef(null);
+  const panel = useRef(null);
+  const labels = { ...DEFAULT_LABELS, ...labelOverrides };
+  const attached = state.attachment !== null;
+  useEffect(() => leadingButton.current?.focus({ preventScroll: true }), []);
+  const run = (operation) => {
+    setPending(true);
+    void Promise.resolve().then(operation).finally(() => setPending(false));
+  };
+  return /* @__PURE__ */ jsxs(
+    "section",
+    {
+      ref: panel,
+      class: `sctui-panel ${className}`.trim(),
+      "data-attached": String(attached),
+      "aria-label": labels.title,
+      "aria-modal": "true",
+      role: "dialog",
+      onKeyDown: (event) => {
+        if (event.key === "Escape" && !state.attachment) {
+          event.preventDefault();
+          event.stopPropagation();
+          onClose();
+          return;
+        }
+        if (event.key !== "Tab") return;
+        const focusable = [...panel.current?.querySelectorAll('button:not(:disabled), [href], input:not(:disabled), textarea:not(:disabled), [tabindex]:not([tabindex="-1"])') ?? []];
+        const first = focusable.at(0);
+        const last = focusable.at(-1);
+        if (!first || !last) return;
+        if (event.shiftKey && document.activeElement === first) {
+          event.preventDefault();
+          last.focus();
+        } else if (!event.shiftKey && document.activeElement === last) {
+          event.preventDefault();
+          first.focus();
+        }
+      },
+      children: [
+        /* @__PURE__ */ jsxs("header", { children: [
+          /* @__PURE__ */ jsx(
+            "button",
+            {
+              ref: leadingButton,
+              type: "button",
+              "aria-label": attached ? labels.back : `Close ${labels.title.toLowerCase()}`,
+              onClick: attached ? () => run(onDismiss) : onClose,
+              children: "\u2190"
+            }
+          ),
+          /* @__PURE__ */ jsxs("span", { children: [
+            /* @__PURE__ */ jsx("strong", { children: labels.title }),
+            /* @__PURE__ */ jsx("small", { children: labels.subtitle })
+          ] }),
+          attached ? /* @__PURE__ */ jsx("button", { type: "button", "aria-label": `Close ${labels.title.toLowerCase()}`, onClick: onClose, children: "\xD7" }) : /* @__PURE__ */ jsx("button", { type: "button", disabled: pending, onClick: () => run(onRefresh), children: labels.refresh })
+        ] }),
+        attached ? /* @__PURE__ */ jsx("div", { class: "sctui-live", children: renderViewer ? renderViewer(state.attachment) : /* @__PURE__ */ jsx(TerminalViewer, { attachment: state.attachment }) }) : /* @__PURE__ */ jsxs(Fragment, { children: [
+          createActions.length ? /* @__PURE__ */ jsx("div", { class: "sctui-create", children: createActions.map((action) => /* @__PURE__ */ jsx("button", { type: "button", disabled: pending || !state.available || !onCreate, onClick: () => run(() => onCreate?.(action.id)), children: action.label }, action.id)) }) : null,
+          state.error ? /* @__PURE__ */ jsx("div", { class: "sctui-error", role: "alert", children: state.error }) : null,
+          /* @__PURE__ */ jsx("div", { class: "sctui-list", children: state.sessions.map((session) => /* @__PURE__ */ jsxs("article", { children: [
+            /* @__PURE__ */ jsxs("span", { children: [
+              /* @__PURE__ */ jsx("strong", { children: session.label }),
+              /* @__PURE__ */ jsx(TerminalPath, { value: session.cwd ?? session.activeCommand ?? labels.session })
+            ] }),
+            /* @__PURE__ */ jsx("button", { type: "button", disabled: pending, onClick: () => run(() => onAttach(session.id, "observe")), children: labels.view }),
+            session.owned ? /* @__PURE__ */ jsx("button", { type: "button", disabled: pending, onClick: () => run(() => onAttach(session.id, "control")), children: labels.control }) : null,
+            session.owned && state.canOpenLocal && onOpen ? /* @__PURE__ */ jsx("button", { type: "button", disabled: pending, onClick: () => run(() => onOpen(session.id)), children: labels.open }) : null,
+            session.owned ? /* @__PURE__ */ jsx("button", { type: "button", class: "sctui-danger", disabled: pending, onClick: () => run(() => onStop(session.id)), children: labels.stop }) : null
+          ] }, session.id)) }),
+          !state.sessions.length && state.available ? /* @__PURE__ */ jsx("p", { class: "sctui-empty", children: labels.empty }) : null
+        ] })
+      ]
+    }
+  );
+}
+export {
+  TerminalPanel,
+  TerminalPath,
+  TerminalStreamViewer,
+  TerminalViewer,
+  TerminalWorkspace,
+  normalizeTerminalUiState,
+  terminalPath,
+  terminalWorkspaceShortcut
+};