@particle-academy/fancy-term 0.4.0 → 0.5.0

package/dist/index.d.ts

@@ -143,7 +143,13 @@ interface TerminalContextMenuItem {
 }
 /** The actions the built-in items dispatch to (wired by the component). */
 interface TerminalMenuActions {
-    copy: () => void;
+    /**
+     * Receives the menu's {@link TerminalContextMenuContext} so it can copy the
+     * selection **snapshotted when the menu opened** — by click time the live
+     * xterm selection is often already cleared (a mouse-reporting TUI's redraw
+     * clears it right after the right-click), so re-reading it copies nothing.
+     */
+    copy: (ctx: TerminalContextMenuContext) => void;
     paste: () => void;
     selectAll: () => void;
     clear: () => void;
@@ -537,4 +543,24 @@ interface MenuSize {
  */
 declare function clampMenuPosition(at: MenuPoint, menu: MenuSize, viewport: MenuSize, margin?: number): MenuPoint;
 
-export { BUILTIN_SHELLS, type ClipboardOption, type ClipboardPayload, type ClipboardProvider, type CopyKeyEvent, type CopyPasteBehavior, type CopyPasteMode, type CursorStyle, type KeyEventLike, type Osc52Mode, type Osc52Request, type ShellProfile, ShellSwitcher, type ShellSwitcherProps, Terminal, TerminalContextMenu, type TerminalContextMenuConfig, type TerminalContextMenuContext, type TerminalContextMenuItem, type TerminalHandle, type TerminalMenuActions, type TerminalOptions, type TerminalProps, type TerminalSessionApi, type TerminalSessionTransport, type TerminalTheme, type UseTerminalSessionOptions, clampMenuPosition, copyPasteBehavior, decodeBase64, defaultMenuItems, encodeBase64, fancyDarkTheme, isImageFile, navigatorClipboard, osc52Response, parseOsc52, registerOsc52, resolveClipboard, resolveKeyAction, resolveMenuItems, resolveShell, shouldCopyEvent, useTerminal, useTerminalFit, useTerminalSession };
+/** The bits of a pointer event the snapshot decision needs. */
+interface SnapshotPointerEvent {
+    type: "mousedown" | "mouseup";
+    /** 0 = left, 1 = middle, 2 = right. */
+    button: number;
+}
+/**
+ * Compute the next selection snapshot after a pointer event on the terminal
+ * surface.
+ *
+ * - A fresh **left press** starts a new gesture — drop the snapshot (the live
+ *   selection still reads the *old* text at capture time, so it must not win).
+ * - Otherwise a **non-empty live selection** always refreshes the snapshot
+ *   (drag-select completes on left mouseup; a right press re-captures while
+ *   the selection is still alive).
+ * - An **empty** live selection keeps the previous snapshot — that's exactly
+ *   the TUI-cleared-it-under-us case the snapshot exists for.
+ */
+declare function nextSelectionSnapshot(prev: string, event: SnapshotPointerEvent, liveSelection: string): string;
+
+export { BUILTIN_SHELLS, type ClipboardOption, type ClipboardPayload, type ClipboardProvider, type CopyKeyEvent, type CopyPasteBehavior, type CopyPasteMode, type CursorStyle, type KeyEventLike, type Osc52Mode, type Osc52Request, type ShellProfile, ShellSwitcher, type ShellSwitcherProps, type SnapshotPointerEvent, Terminal, TerminalContextMenu, type TerminalContextMenuConfig, type TerminalContextMenuContext, type TerminalContextMenuItem, type TerminalHandle, type TerminalMenuActions, type TerminalOptions, type TerminalProps, type TerminalSessionApi, type TerminalSessionTransport, type TerminalTheme, type UseTerminalSessionOptions, clampMenuPosition, copyPasteBehavior, decodeBase64, defaultMenuItems, encodeBase64, fancyDarkTheme, isImageFile, navigatorClipboard, nextSelectionSnapshot, osc52Response, parseOsc52, registerOsc52, resolveClipboard, resolveKeyAction, resolveMenuItems, resolveShell, shouldCopyEvent, useTerminal, useTerminalFit, useTerminalSession };

package/dist/index.js

@@ -767,6 +767,12 @@ function resolveMenuItems(config, ctx, actions) {
   const items = config === void 0 || config === true ? defaults : Array.isArray(config) ? config : config(ctx, defaults);
   return items.length > 0 ? items : null;
 }
+
+// src/selection-snapshot.ts
+function nextSelectionSnapshot(prev, event, liveSelection) {
+  if (event.type === "mousedown" && event.button === 0) return "";
+  return liveSelection || prev;
+}
 var Terminal = forwardRef(function Terminal2({
   output,
   theme,
@@ -867,25 +873,42 @@ var Terminal = forwardRef(function Terminal2({
     written.current = output;
   }, [output, handle]);
   const [menu, setMenu] = useState(null);
+  const selectionSnapshot = useRef("");
+  const trackSelection = useCallback(
+    (e) => {
+      selectionSnapshot.current = nextSelectionSnapshot(
+        selectionSnapshot.current,
+        { type: e.type, button: e.button },
+        handle.getSelection()
+      );
+    },
+    [handle]
+  );
   const openMenu = useCallback(
     (e) => {
       if (contextMenu === false) return;
       e.preventDefault();
-      const selection = handle.getSelection();
+      const selection = handle.getSelection() || selectionSnapshot.current;
       const ctx = {
         hasSelection: selection.length > 0,
         selection,
         readOnly: !!readOnly
       };
       const items = resolveMenuItems(contextMenu, ctx, {
-        copy: () => void handle.copySelection(),
+        // Copy writes the SNAPSHOTTED selection through the active clipboard
+        // provider — never a click-time re-read, which copies "" over a TUI
+        // (falling back to the live selection only when the snapshot is empty).
+        copy: (c) => {
+          const text = c.selection || handle.getSelection();
+          if (text) void providerWrite(resolveClipboard(clipboard).provider, text);
+        },
         paste: () => void handle.paste(),
         selectAll: () => handle.selectAll(),
         clear: () => handle.clear()
       });
       if (items) setMenu({ at: { x: e.clientX, y: e.clientY }, items, ctx });
     },
-    [contextMenu, handle, readOnly]
+    [contextMenu, handle, readOnly, clipboard]
   );
   const menuNode = menu ? /* @__PURE__ */ jsx(TerminalContextMenu, { at: menu.at, items: menu.items, ctx: menu.ctx, onClose: () => setMenu(null) }) : null;
   const surface = /* @__PURE__ */ jsx(
@@ -893,6 +916,8 @@ var Terminal = forwardRef(function Terminal2({
     {
       ref: containerRef,
       "data-fancy-terminal": "",
+      onMouseDownCapture: trackSelection,
+      onMouseUpCapture: trackSelection,
       onContextMenu: openMenu,
       "data-readonly": readOnly ? "" : void 0,
       "data-fancy-terminal-shell": shellId ?? void 0,
@@ -995,6 +1020,6 @@ function shouldCopyEvent(e, hasSelection) {
   return false;
 }
 
-export { BUILTIN_SHELLS, ShellSwitcher, Terminal, TerminalContextMenu, clampMenuPosition, copyPasteBehavior, decodeBase64, defaultMenuItems, encodeBase64, fancyDarkTheme, isImageFile, navigatorClipboard, osc52Response, parseOsc52, registerOsc52, resolveClipboard, resolveKeyAction, resolveMenuItems, resolveShell, shouldCopyEvent, useTerminal, useTerminalFit, useTerminalSession };
+export { BUILTIN_SHELLS, ShellSwitcher, Terminal, TerminalContextMenu, clampMenuPosition, copyPasteBehavior, decodeBase64, defaultMenuItems, encodeBase64, fancyDarkTheme, isImageFile, navigatorClipboard, nextSelectionSnapshot, osc52Response, parseOsc52, registerOsc52, resolveClipboard, resolveKeyAction, resolveMenuItems, resolveShell, shouldCopyEvent, useTerminal, useTerminalFit, useTerminalSession };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map