clay-server 2.40.0 → 2.41.0-beta.1

package/lib/daemon.js

@@ -730,7 +730,7 @@ var relay = createServer({
   },
   onSetTerminalFont: function (family, size) {
     var DEFAULT_FAMILY = "'SF Mono', Menlo, Monaco, 'Courier New', monospace";
-    var current = config.terminalFont || { family: DEFAULT_FAMILY, size: 13 };
+    var current = config.terminalFont || { family: DEFAULT_FAMILY, size: 14 };
     var nextFamily = (typeof family === "string" && family.trim()) ? family.trim().slice(0, 200) : current.family;
     var nextSize = current.size;
     if (typeof size === "number" && size >= 9 && size <= 32) {

package/lib/project-sessions.js

@@ -176,6 +176,19 @@ function attachSessions(ctx) {
             cliSessionId: s.cliSessionId || null,
           });
         } catch (e) {}
+        // Re-read the assistant text index and broadcast it so any client
+        // with this session in view can wire hover-to-grab onto the new
+        // message right away. The transcript is small enough that a full
+        // re-send beats maintaining a delta protocol.
+        try {
+          var newIndex = require("./tui-transcript-index").readAssistantIndex(cwd, s.cliSessionId);
+          send({
+            type: "tui_transcript_state",
+            id: s.localId,
+            cliSessionId: s.cliSessionId,
+            messages: newIndex.messages,
+          });
+        } catch (e) {}
       },
     });
     session._titleWatcherStop = stop;
@@ -314,19 +327,38 @@ function attachSessions(ctx) {
     if (!session) return;
     if (session.vendor && session.vendor !== "claude") { session.tuiSuspended = false; return; }
     var pref = getClaudeOpenModeForWs(ws);
+    // A LIVE runtime always wins over the viewer's claudeOpenMode pref:
+    // another user (or this user in another tab) may be in the session right
+    // now, so we join it in whatever mode it is actually running and never
+    // convert or kill it. "tui stays tui, gui stays gui."
+    var liveNativePty = tm && typeof session.terminalId === "number" && tm.has(session.terminalId);
+    var liveResumePty = tm && typeof session.runtimeTerminalId === "number" && tm.has(session.runtimeTerminalId);
+    var liveSdk = !!session.queryInstance || !!session.isProcessing;
+    if (liveNativePty) {
+      session.runtimeMode = "tui";
+      session.runtimeTerminalId = session.terminalId;
+      session.tuiSuspended = false;
+      return;
+    }
+    if (liveResumePty) {
+      session.runtimeMode = "tui";
+      session.tuiSuspended = false;
+      return;
+    }
+    if (liveSdk) {
+      // Actively running as a GUI/SDK session - show GUI for everyone.
+      session.runtimeMode = (session.mode === "tui") ? "gui" : null;
+      session.runtimeTerminalId = null;
+      session.tuiSuspended = false;
+      return;
+    }
+    // Cold session: apply the viewer's pref.
     if (session.mode === "tui") {
       if (pref === "gui") {
         prepareTuiSessionForGuiView(session);
         session.runtimeMode = "gui";
         session.runtimeTerminalId = null;
         session.tuiSuspended = false;
-      } else if (tm && typeof session.terminalId === "number" && tm.has(session.terminalId)) {
-        session.runtimeMode = "tui";
-        session.runtimeTerminalId = session.terminalId;
-        session.tuiSuspended = false;
-      } else if (tm && typeof session.runtimeTerminalId === "number" && tm.has(session.runtimeTerminalId)) {
-        session.runtimeMode = "tui";
-        session.tuiSuspended = false;
       } else {
         prepareTuiSessionForGuiView(session);
         session.runtimeMode = null;
@@ -334,31 +366,14 @@ function attachSessions(ctx) {
         session.tuiSuspended = true;
       }
     } else {
-      // Born-GUI: reattach a live resume PTY if one exists; never spawn here.
-      if (pref === "tui" && tm && typeof session.runtimeTerminalId === "number" && tm.has(session.runtimeTerminalId)) {
-        session.runtimeMode = "tui";
-      } else {
-        session.runtimeMode = null;
-      }
+      // Born-GUI: always GUI. We no longer auto-convert a GUI session to a
+      // `claude --resume` terminal on a pref=tui click - that hijacked shared
+      // GUI sessions in multi-user. Such sessions render as their SDK chat.
+      session.runtimeMode = null;
       session.tuiSuspended = false;
     }
   }
 
-  // Compute the runtimeMode the client should render for this session given
-  // the user's current preference. Pure function over session + pref; the
-  // caller decides whether to also mutate state (spawn PTY, convert, etc.)
-  // via the helpers above.
-  function computeRuntimeMode(session, pref) {
-    if (!session) return "gui";
-    if (session.vendor && session.vendor !== "claude") return session.mode || "gui";
-    var effPref = (pref === "gui") ? "gui" : "tui";
-    if (session.mode === "tui") {
-      return effPref === "gui" ? "gui" : "tui";
-    }
-    // session.mode === 'gui'
-    return effPref === "tui" ? "tui" : "gui";
-  }
-
   function handleSessionsMessage(ws, msg) {
 
     if (msg.type === "push_subscribe") {
@@ -568,33 +583,17 @@ function attachSessions(ctx) {
 
     if (msg.type === "switch_session") {
       if (msg.id && sm.sessions.has(msg.id)) {
-        // Apply the claudeOpenMode preference to the target Claude session
-        // before sm.switchSession fires session_switched. Two transforms:
-        //
-        //  - born-GUI viewed under TUI pref:  spawn a transient PTY running
-        //    `claude --resume <cliSessionId>`; the session record stays GUI
-        //    so a later pref flip back to GUI just hides the runtime link.
-        //  - born-TUI viewed under GUI pref:  hydrate session.history from
-        //    the jsonl transcript and tear down the PTY so the session
-        //    renders via the SDK chat. The born-TUI marker stays on the
-        //    record so a later pref flip back to TUI restores the
-        //    embedded-terminal experience.
-        //
-        // runtimeMode / runtimeTerminalId are set on the session record so
-        // the session_switched and session_list broadcasts surface them to
-        // the client without sessions.js needing to know about the pref.
+        // resolveSessionForView sets runtimeMode / runtimeTerminalId /
+        // tuiSuspended (and hydrates the transcript) before sm.switchSession
+        // broadcasts session_switched. A live runtime keeps its actual mode
+        // for every viewer; only cold sessions follow the clicker's
+        // claudeOpenMode pref. Nothing is spawned here.
         var xmTarget = sm.sessions.get(msg.id);
         if (xmTarget && (xmTarget.vendor === "claude" || !xmTarget.vendor)) {
-          var xmPref = getClaudeOpenModeForWs(ws);
-          // Born-GUI under TUI pref with no live resume PTY: spawn a transient
-          // `claude --resume` now (only switch_session spawns; born-TUI sessions
-          // stay lazy and the connect path never spawns). resolveSessionForView
-          // then turns the live PTY into runtimeMode='tui'.
-          if (xmTarget.mode === "gui" && xmTarget.cliSessionId &&
-              computeRuntimeMode(xmTarget, xmPref) === "tui" &&
-              !(tm && typeof xmTarget.runtimeTerminalId === "number" && tm.has(xmTarget.runtimeTerminalId))) {
-            spawnRuntimeTuiPty(xmTarget, ws);
-          }
+          // Single source of truth: live runtime wins (tui stays tui, gui stays
+          // gui); only cold sessions follow the viewer's pref. No PTY is spawned
+          // on switch - born-TUI resumes lazily via the Resume bar
+          // (resume_tui_session), and born-GUI never auto-converts to a terminal.
           resolveSessionForView(xmTarget, ws);
         }
         // If the target session's vendor doesn't own the currently cached
@@ -694,6 +693,31 @@ function attachSessions(ctx) {
       return true;
     }
 
+    // Client asks for the assistant text index of a Claude TUI session so
+    // it can wire hover-to-grab on the rendered terminal output. Only the
+    // raw markdown of assistant text messages is returned — no tool calls,
+    // no user prompts. Codex sessions skip the feature.
+    if (msg.type === "tui_transcript_request") {
+      var tprId = msg.id;
+      var tprSess = (tprId && sm.sessions.has(tprId)) ? sm.sessions.get(tprId) : null;
+      if (!tprSess || !tprSess.cliSessionId || tprSess.mode !== "tui") return true;
+      if (tprSess.vendor && tprSess.vendor !== "claude") return true;
+      if (usersModule.isMultiUser() && ws._clayUser
+          && !usersModule.canAccessSession(ws._clayUser.id, tprSess, { visibility: "public" })) {
+        return true;
+      }
+      try {
+        var tprIndex = require("./tui-transcript-index").readAssistantIndex(cwd, tprSess.cliSessionId);
+        sendTo(ws, {
+          type: "tui_transcript_state",
+          id: tprId,
+          cliSessionId: tprSess.cliSessionId,
+          messages: tprIndex.messages,
+        });
+      } catch (e) {}
+      return true;
+    }
+
     if (msg.type === "set_mate_dm") {
       // Only store mateDm on non-mate projects (main project presence).
       // Mate projects should never hold mateDm to avoid circular restore loops.

package/lib/public/index.html

@@ -22,6 +22,9 @@
      SF Mono is Apple-system-only (no Google Fonts entry) and
      ui-monospace is a system keyword - both rely on the user's OS. -->
 <link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;700&family=Fira+Code:wght@400;500;700&family=Cascadia+Code:wght@400;500;700&family=IBM+Plex+Mono:wght@400;500;700&family=Source+Code+Pro:wght@400;500;700&display=swap" rel="stylesheet">
+<!-- D2 Coding isn't on Google Fonts and its CJK woff2 is ~1.4MB, so it
+     is lazy-loaded by terminal-prefs.js the first time the user selects
+     it (or boots with it already saved). See ensureD2CodingWebfont(). -->
 <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@xterm/xterm@5/css/xterm.min.css">
 <script>
 (function(){try{var k="clay-theme-vars",v=localStorage.getItem(k),r=document.documentElement;if(v){var o=JSON.parse(v),p;for(p in o)r.style.setProperty(p,o[p]);var vt=localStorage.getItem(k.replace("-vars","-variant"));if(vt==="light"){r.classList.add("light-theme");r.classList.remove("dark-theme")}else{r.classList.add("dark-theme");r.classList.remove("light-theme")}var m=document.querySelector('meta[name="theme-color"]');if(m&&o["--bg"])m.setAttribute("content",o["--bg"])}else{var sl=window.matchMedia&&window.matchMedia("(prefers-color-scheme: light)").matches;if(sl){r.classList.add("light-theme");r.classList.remove("dark-theme")}}}catch(e){}})();

package/lib/public/modules/app-messages.js

@@ -28,6 +28,7 @@ import { isProjectSettingsOpen, handleInstructionsRead, handleInstructionsWrite,
 import { updateSettingsModels, updateSettingsStats, updateDaemonConfig, handleSetPinResult, handleKeepAwakeChanged, handleAutoContinueChanged, handleRestartResult, handleShutdownResult, handleSharedEnv, handleSharedEnvSaved, handleGlobalClaudeMdRead, handleGlobalClaudeMdWrite } from './server-settings.js';
 import { handleTermList, handleTermCreated, sendTerminalCommand, handleTermOutput, handleTermResized, handleTermExited, handleTermClosed } from './terminal.js';
 import { attachTuiView, detachTuiView, setTuiSuspendedView, tuiHandleTermOutput, tuiHandleTermResized, tuiHandleTermExited, tuiHandleTermClosed } from './session-tui-view.js';
+import { handleTuiTranscriptState } from './tui-grab.js';
 import { tuiModalHandleTermOutput, tuiModalHandleTermResized, tuiModalHandleTermExited, tuiModalHandleTermClosed } from './tui-attention.js';
 import { updateTerminalList, handleContextSourcesState, updateEmailAccountList, updateEmailUnreadCounts, handleEmailTestResult, handleEmailAddResult, handleEmailRemoveResult, handleEmailDefaults } from './context-sources.js';
 import { refreshEmailSettings } from './user-settings.js';
@@ -421,6 +422,12 @@ export function processMessage(msg) {
         }) });
         break;
 
+      case "tui_transcript_state":
+        // Assistant text index for a Claude TUI session — drives the
+        // hover-to-grab overlay in lib/public/modules/tui-grab.js.
+        handleTuiTranscriptState(msg);
+        break;
+
       case "model_info": {
         // Drop stale model_info from a vendor that doesn't match the active
         // session's vendor. On high-latency connections, the server's default-
@@ -616,7 +623,7 @@ export function processMessage(msg) {
         // `claude` inside a real PTY. Mount or tear down before the rest of
         // the chat-side bookkeeping runs so we don't waste work on hidden DOM.
         if (_effectiveMode === "tui" && typeof _effectiveTerminalId === "number") {
-          attachTuiView(_effectiveTerminalId);
+          attachTuiView(_effectiveTerminalId, msg.id, msg.vendor || null);
         } else {
           detachTuiView();
         }

package/lib/public/modules/app-notifications.js

@@ -7,17 +7,31 @@ import { escapeHtml } from './utils.js';
 import { store } from './store.js';
 import { getWs } from './ws-ref.js';
 import { openDm } from './app-dm.js';
-import { getCachedProjects } from './app-projects.js';
-import { switchProject } from './app-projects.js';
+import { getCachedProjects, switchProject, renderProjectList } from './app-projects.js';
 import { mateAvatarUrl, userAvatarUrl } from './avatar.js';
 import { openTerminal } from './terminal.js';
 import { openTuiModal } from './tui-attention.js';
+import { startUrgentBlink, stopUrgentBlink } from './app-favicon.js';
+import { playDoneSound, isNotifSoundEnabled } from './notifications.js';
 var notifications = [];
 var unreadCount = 0;
 var bannerContainer = null;
 var bellBtn = null;
 var badgeEl = null;
 
+// --- Pending TUI attention tracking ---
+// Mirrors the icon-shake / favicon-blink behavior the SDK side already gets
+// from `pendingPermissions` on project status broadcasts. The notification
+// center is our source of truth for unresolved tui_attention notifications:
+// when one arrives we bump the slug's count and start the urgent favicon
+// blink; when it's dismissed (the user opened the session, clicked the
+// banner, or closed it) we decrement and stop the blink once nothing is
+// left pending. `notif.id -> slug` lets us decrement without having to
+// re-derive the slug from a dismissed notification.
+var pendingTuiBySlug = Object.create(null);
+var pendingTuiBySlugId = Object.create(null);
+var pendingTuiTotal = 0;
+
 // --- Update available banner state ---
 // Server pushes update_available on an hourly boundary; dismissal is
 // per-banner-instance and doesn't need to persist. The next server push
@@ -457,11 +471,61 @@ function dismissNotif(id) {
 // Message handlers
 // ========================================================
 
+function isPendingTuiAttention(notif) {
+  return notif && notif.type === "tui_attention" && notif.slug;
+}
+
+function bumpTuiAttention(notif) {
+  if (!isPendingTuiAttention(notif)) return false;
+  if (pendingTuiBySlugId[notif.id]) return false;
+  pendingTuiBySlugId[notif.id] = notif.slug;
+  pendingTuiBySlug[notif.slug] = (pendingTuiBySlug[notif.slug] || 0) + 1;
+  pendingTuiTotal++;
+  return true;
+}
+
+function dropTuiAttentionById(id) {
+  var slug = pendingTuiBySlugId[id];
+  if (!slug) return false;
+  delete pendingTuiBySlugId[id];
+  pendingTuiBySlug[slug] = (pendingTuiBySlug[slug] || 1) - 1;
+  if (pendingTuiBySlug[slug] <= 0) delete pendingTuiBySlug[slug];
+  pendingTuiTotal--;
+  if (pendingTuiTotal < 0) pendingTuiTotal = 0;
+  return true;
+}
+
+function refreshTuiAttentionVisuals(prevTotal) {
+  if (pendingTuiTotal > 0 && prevTotal === 0) {
+    try { startUrgentBlink(); } catch (e) {}
+  } else if (pendingTuiTotal === 0 && prevTotal > 0) {
+    try { stopUrgentBlink(); } catch (e) {}
+  }
+  try { renderProjectList(); } catch (e) {}
+}
+
+export function getPendingTuiAttention(slug) {
+  if (!slug) return 0;
+  return pendingTuiBySlug[slug] || 0;
+}
+
 export function handleNotificationsState(msg) {
   notifications = msg.notifications || [];
   unreadCount = msg.unreadCount || 0;
   updateBadge();
 
+  // Rebuild the pending-tui-attention map from the authoritative list. This
+  // also covers reconnect — pre-existing notifications get the icon shake
+  // and favicon blink restored without waiting for a fresh server event.
+  var prevTotal = pendingTuiTotal;
+  pendingTuiBySlug = Object.create(null);
+  pendingTuiBySlugId = Object.create(null);
+  pendingTuiTotal = 0;
+  for (var i = 0; i < notifications.length; i++) {
+    bumpTuiAttention(notifications[i]);
+  }
+  refreshTuiAttentionVisuals(prevTotal);
+
   // Check for pending session navigation after project switch
   try {
     var pendingSession = sessionStorage.getItem("pending-notif-session");
@@ -490,6 +554,20 @@ export function handleNotificationCreated(msg) {
   unreadCount = msg.unreadCount;
   updateBadge();
 
+  // tui_attention drives the project icon shake and the favicon blink —
+  // same visual cues the SDK already produces from pendingPermissions /
+  // permission_request messages, so the user notices either kind without
+  // having the right tab focused. Ring the ding too, gated on document.hidden
+  // and the notif-sound toggle to match the SDK 'done' path — we don't want
+  // to chime while the user is actively watching the tab.
+  var prevTotal = pendingTuiTotal;
+  if (bumpTuiAttention(notif)) {
+    refreshTuiAttentionVisuals(prevTotal);
+    if (document.hidden && isNotifSoundEnabled()) {
+      try { playDoneSound(); } catch (e) {}
+    }
+  }
+
   // user_mention banners are persistent (no auto-dismiss). They go away when:
   //   1. The user clicks the banner (which navigates to the session — see
   //      banner click handler in showBanner / navigateToNotification), OR
@@ -516,6 +594,12 @@ export function handleNotificationDismissed(msg) {
       if (el) removeBanner(el);
     }
   }
+  var prevTotal = pendingTuiTotal;
+  var anyTuiDropped = false;
+  for (var j = 0; j < ids.length; j++) {
+    if (dropTuiAttentionById(ids[j])) anyTuiDropped = true;
+  }
+  if (anyTuiDropped) refreshTuiAttentionVisuals(prevTotal);
 }
 
 export function handleNotificationDismissedAll() {
@@ -523,6 +607,11 @@ export function handleNotificationDismissedAll() {
   unreadCount = 0;
   updateBadge();
   if (bannerContainer) bannerContainer.innerHTML = "";
+  var prevTotal = pendingTuiTotal;
+  pendingTuiBySlug = Object.create(null);
+  pendingTuiBySlugId = Object.create(null);
+  pendingTuiTotal = 0;
+  if (prevTotal > 0) refreshTuiAttentionVisuals(prevTotal);
 }
 
 // ========================================================

package/lib/public/modules/header-tui-font.js

@@ -21,6 +21,7 @@ var FONT_OPTIONS = [
   { label: "IBM Plex Mono",   family: "'IBM Plex Mono', 'SF Mono', Menlo, monospace" },
   { label: "Source Code Pro", family: "'Source Code Pro', 'SF Mono', Menlo, monospace" },
   { label: "Roboto Mono",     family: "'Roboto Mono', 'SF Mono', Menlo, monospace" },
+  { label: "D2 Coding",       family: "'D2 coding', 'D2Coding', 'SF Mono', Menlo, monospace" },
   { label: "System mono",     family: "ui-monospace, monospace" },
 ];
 

package/lib/public/modules/session-tui-view.js

@@ -19,6 +19,7 @@ import { store } from './store.js';
 import { getTerminalTheme } from './theme.js';
 import { getTerminalFontFamily, getTerminalFontSize, onTerminalFontChange } from './terminal-prefs.js';
 import { showHeaderTuiFont, hideHeaderTuiFont } from './header-tui-font.js';
+import { attachTuiGrab, detachTuiGrab } from './tui-grab.js';
 import { openArticle as openWhatsNewArticle } from './whats-new-article.js';
 import { createKeyToolbar, TERMINAL_TOOLBAR_HTML } from './terminal-toolbar.js';
 import { refreshIcons, iconHtml } from './icons.js';
@@ -593,7 +594,7 @@ function teardownXterm() {
   imeLastComposedAt = 0;
 }
 
-export function attachTuiView(terminalId) {
+export function attachTuiView(terminalId, localId, vendor) {
   if (typeof terminalId !== "number") return;
   // Re-attaching to the same terminal: just refit and refocus.
   if (currentTermId === terminalId && xterm) {
@@ -603,6 +604,9 @@ export function attachTuiView(terminalId) {
     showHeaderTuiClose();
     fitNow();
     focusGuiComposer();
+    // Re-arm hover-grab against the same xterm in case the session
+    // metadata (localId / vendor) changed since the last attach.
+    if (localId) attachTuiGrab(xterm, xtermContainerEl, localId, { vendor: vendor });
     return;
   }
   // Switching to a different TUI terminal: tear down the old one cleanly.
@@ -619,6 +623,10 @@ export function attachTuiView(terminalId) {
   currentTermId = terminalId;
   if (!xterm) xterm = createXterm();
   if (!xterm) return;
+  // PC통신-style hover-and-click grab over the rendered output. Pulls
+  // its index from the on-disk JSONL transcript via tui_transcript_*
+  // messages; no-ops for Codex sessions.
+  if (localId) attachTuiGrab(xterm, xtermContainerEl, localId, { vendor: vendor });
 
   // Subscribe to the terminal's output stream on the server. The server
   // replays its scrollback buffer on attach so we never start blank.
@@ -653,6 +661,7 @@ export function detachTuiView() {
     try { resizeObserver.disconnect(); } catch (e) {}
     resizeObserver = null;
   }
+  detachTuiGrab();
   if (currentTermId != null) {
     var ws = getWs();
     if (ws && ws.readyState === 1) {

package/lib/public/modules/sidebar-projects.js

@@ -12,6 +12,7 @@ import { closeSidebar } from './sidebar.js';
 import { showIconTooltip, hideIconTooltip, closeUserCtxMenu, getCurrentDmUserId } from './sidebar-mates.js';
 import { switchProject, openAddProjectModal, getCachedProjects } from './app-projects.js';
 import { showHomeHub } from './app-home-hub.js';
+import { getPendingTuiAttention } from './app-notifications.js';
 
 // --- Project state ---
 var cachedProjectList = [];
@@ -1011,7 +1012,11 @@ function createIconItem(p, currentSlug) {
   }
   el.appendChild(projectBadge);
 
-  if (p.pendingPermissions > 0 && !isActive) {
+  // TUI sessions don't go through pendingPermissions on the project status
+  // broadcast — they surface via tui_attention notifications. We shake the
+  // same icon for either, so the user notices regardless of which engine
+  // is asking.
+  if (!isActive && (p.pendingPermissions > 0 || getPendingTuiAttention(p.slug) > 0)) {
     el.classList.add("has-pending-perm");
   }
 
@@ -1312,7 +1317,7 @@ export function renderIconStrip(projects, currentSlug) {
           });
         }
 
-        if (wt.pendingPermissions > 0 && !isWtActive) {
+        if (!isWtActive && (wt.pendingPermissions > 0 || getPendingTuiAttention(wt.slug) > 0)) {
           wtEl.classList.add("has-pending-perm");
         }
 
@@ -1322,7 +1327,10 @@ export function renderIconStrip(projects, currentSlug) {
 
     var hasWtPendingPerm = false;
     for (var wpi2 = 0; wpi2 < worktrees.length; wpi2++) {
-      if (worktrees[wpi2].pendingPermissions > 0) { hasWtPendingPerm = true; break; }
+      if (worktrees[wpi2].pendingPermissions > 0 || getPendingTuiAttention(worktrees[wpi2].slug) > 0) {
+        hasWtPendingPerm = true;
+        break;
+      }
     }
     if (hasWtPendingPerm) folder.classList.remove("collapsed");
 

package/lib/public/modules/terminal-prefs.js

@@ -10,12 +10,60 @@
 // without round-trips.
 
 var DEFAULT_FAMILY = "'SF Mono', Menlo, Monaco, 'Courier New', monospace";
-var DEFAULT_SIZE = 13;
+var DEFAULT_SIZE = 14;
 
 var currentFamily = DEFAULT_FAMILY;
 var currentSize = DEFAULT_SIZE;
 var listeners = [];
 
+// D2 Coding ships ~1.4MB of CJK glyphs per weight, so we avoid loading
+// it eagerly on every page. The link is injected on demand the first
+// time the user actually picks the font (or boots with it saved). The
+// @font-face in this CSS registers under the family 'D2 coding' and
+// also picks up a locally-installed 'D2Coding' via local() fallback.
+//
+// xterm's WebGL renderer measures cell metrics synchronously when the
+// font family option changes, so the first atlas build right after
+// selection happens against the *fallback* (SF Mono for Latin, a system
+// Hangul font for Korean). Each is measured with its own width, so
+// Latin and Hangul cells fall out of the expected 1:2 ratio and lines
+// stop lining up. After the woff2 actually arrives we replay the
+// font-change notification so every listener rebuilds its atlas with
+// the proper D2 Coding metrics for both scripts.
+var d2CodingInjected = false;
+function notifyFontListeners() {
+  for (var i = 0; i < listeners.length; i++) {
+    try { listeners[i](currentFamily, currentSize); } catch (e) {}
+  }
+}
+function ensureD2CodingWebfont() {
+  if (d2CodingInjected) return;
+  d2CodingInjected = true;
+  if (typeof document === "undefined" || !document.head) return;
+  var link = document.createElement("link");
+  link.rel = "stylesheet";
+  link.href = "https://cdn.jsdelivr.net/gh/Joungkyun/font-d2coding/d2coding.css";
+  link.onload = function () {
+    if (document.fonts && typeof document.fonts.load === "function") {
+      Promise.all([
+        document.fonts.load('400 16px "D2 coding"'),
+        document.fonts.load('700 16px "D2 coding"'),
+      ]).then(notifyFontListeners).catch(function () {});
+    } else {
+      notifyFontListeners();
+    }
+  };
+  document.head.appendChild(link);
+}
+
+function maybeLazyLoadWebfont(family) {
+  if (typeof family !== "string") return;
+  var lower = family.toLowerCase();
+  if (lower.indexOf("d2 coding") !== -1 || lower.indexOf("d2coding") !== -1) {
+    ensureD2CodingWebfont();
+  }
+}
+
 export function getTerminalFontFamily() {
   return currentFamily || DEFAULT_FAMILY;
 }
@@ -43,9 +91,8 @@ export function applyTerminalFont(family, size) {
     changed = true;
   }
   if (!changed) return;
-  for (var i = 0; i < listeners.length; i++) {
-    try { listeners[i](currentFamily, currentSize); } catch (e) {}
-  }
+  maybeLazyLoadWebfont(currentFamily);
+  notifyFontListeners();
 }
 
 export function onTerminalFontChange(fn) {