@tobq/boardclip 2.1.108 → 2.1.110

package/index.html

@@ -385,7 +385,8 @@ const appAdapter = {
   // Always the id-based path: window.api.copy() only takes a string, so it
   // would silently drop the clip's html/rtf. paste(id) puts every captured
   // format on the clipboard for both text and image clips.
-  copyNumpadSlot: (id) => { const it = itemById(id); if (!it) return; return window.api.paste(id); },
+  copyClip: (id) => window.api.copyClip(id),
+  copyMany: (ids) => window.api.copyMany(ids),
   activateClip: (id) => window.api.pasteAndHide(id),
   editClip: (id, _itemEl, options) => window.api.openEditor(id, { ...Core.editorFindFor(query), ...(options || {}) }),
   setClipTitle: (id, title) => revGuard(() => window.api.setClipTitle(id, title, clipRevOf(id)), false),
@@ -491,6 +492,9 @@ document.getElementById('copyDiagnostics').addEventListener('click', async () =>
 
 // --- Search ---
 searchEl.addEventListener('keydown', e => {
+  // A digit typed while a menu or popover is open belongs to it, never a
+  // quick-paste (typing "1ndex" with the + picker open pasted slot 1).
+  if (controller.isMenuOpen()) return;
   if (query === '' && !e.altKey && !e.ctrlKey && !e.metaKey && e.key >= '1' && e.key <= '9') {
     const n = +e.key;
     const nmap = numpadMap();

package/lib/clipboard-model.js

@@ -274,6 +274,13 @@ function conflictSnapshot(item, fallback = {}) {
   };
 }
 
+// Two sides with the same text and title leave nothing to merge.
+function withoutIdenticalSides(conflict) {
+  const { left, right } = conflict || {};
+  if (left && right && left.text === right.text && left.title === right.title) return null;
+  return conflict;
+}
+
 function titleConflict(localItem, remoteItem) {
   if (!localItem || !remoteItem || localItem.type === 'image' || remoteItem.type === 'image') return false;
   if (itemKey(localItem) !== itemKey(remoteItem)) return false;
@@ -890,7 +897,15 @@ function applyTextEdit(items, options = {}) {
     ensureItemId(item);
   }
 
-  const currentIndex = id ? history.findIndex(item => itemKey(item) === id) : -1;
+  let currentIndex = id ? history.findIndex(item => itemKey(item) === id) : -1;
+  // A base edited since this edit began (in another window or on another
+  // device) is gone under its old id. Its newest version is found through the
+  // edit lineage, so the fork below carries a conflict record against it and
+  // the two can be merged, instead of a second copy with nothing to merge.
+  if (currentIndex < 0 && id && options.supersedes) {
+    const headId = supersedeMap(options.supersedes).get(id);
+    if (headId) currentIndex = history.findIndex(item => item.type !== 'image' && itemKey(item) === headId);
+  }
   const current = currentIndex >= 0 ? history[currentIndex] : null;
   const originalTitle = titleEditRequested
     ? (options.originalTitle !== undefined ? cleanTitle(options.originalTitle) : titleOf(current))
@@ -949,13 +964,13 @@ function applyTextEdit(items, options = {}) {
     dedupeNumpadSlots(history);
     const titleMergeConflict = titleConflict(existingBefore, edited);
     const conflict = current && (!canUpdateCurrent || titleDiverged || titleMergeConflict)
-      ? {
+      ? withoutIdenticalSides({
         kind: titleDiverged || titleMergeConflict ? 'title' : 'editor',
         base: { id, type: 'text', text: originalText, title: originalTitle },
         left: titleMergeConflict ? existingBefore : (currentBefore || existingBefore),
         right: conflictSnapshot(edited, { text: newText, title: newTitle }),
         targetId: itemKey(existing),
-      }
+      })
       : null;
     return {
       changed: true,

package/lib/notifications.js

@@ -0,0 +1,83 @@
+'use strict';
+
+// OS notifications with an optional action button, on Windows and macOS.
+// - Windows: Electron's Notification takes a button only through custom toast
+//   XML. A foreground-activated button reaches the app as the notification's
+//   'click' (Electron maps every activation to it), so the body and the button
+//   run the same action.
+// - macOS: Electron's `actions` ('action' event). They show only when the app's
+//   notification style is Alerts; otherwise the body click is the way in.
+// Clicking the notification runs the action everywhere: that is the generic
+// path, and a button is the extra a platform adds on top.
+
+function escapeXml(value) {
+  return String(value == null ? '' : value).replace(/[<>&"']/g, (ch) => ({
+    '<': '&lt;', '>': '&gt;', '&': '&amp;', '"': '&quot;', "'": '&apos;',
+  })[ch]);
+}
+
+function toastXml({ title, body, action, silent = true }) {
+  return '<toast activationType="foreground" launch="open">'
+    + '<visual><binding template="ToastGeneric">'
+    + `<text>${escapeXml(title)}</text>`
+    + (body ? `<text>${escapeXml(body)}</text>` : '')
+    + '</binding></visual>'
+    + (action ? `<actions><action content="${escapeXml(action)}" arguments="action" activationType="foreground"/></actions>` : '')
+    + (silent ? '<audio silent="true"/>' : '')
+    + '</toast>';
+}
+
+function notificationOptions({ title, body, action, silent = true, platform = process.platform } = {}) {
+  const options = { title: String(title || ''), body: String(body || ''), silent: !!silent };
+  if (action && platform === 'win32') options.toastXml = toastXml({ title, body, action, silent });
+  if (action && platform === 'darwin') options.actions = [{ type: 'button', text: String(action) }];
+  return options;
+}
+
+// show() keeps each notification referenced until it is acted on or closed:
+// an unreferenced Notification can be garbage-collected before its click.
+// A toast Windows rejects ('failed') is shown again without the button, so the
+// message still arrives and its click still runs the action; onError hears of
+// every failure (each one is a bug to fix, not a path to rely on).
+function createNotifier({ Notification, platform = process.platform, onError = () => {} } = {}) {
+  const live = new Set();
+  const present = (options, act) => {
+    const notification = new Notification(options);
+    live.add(notification);
+    const done = () => { live.delete(notification); };
+    notification.on('click', () => { done(); act(); });
+    notification.on('action', () => { done(); act(); });
+    notification.on('close', done);
+    notification.on('failed', (_event, error) => {
+      done();
+      onError(new Error(String(error || 'notification failed')));
+      if (options.toastXml) {
+        const { toastXml, ...plain } = options;
+        try { present(plain, act); } catch (retryError) { onError(retryError); }
+      }
+    });
+    notification.show();
+    return notification;
+  };
+  return {
+    show({ title, body, action, onAction, silent = true } = {}) {
+      try {
+        if (!Notification || typeof Notification.isSupported !== 'function' || !Notification.isSupported()) return null;
+        const withAction = typeof onAction === 'function';
+        let acted = false;
+        const act = () => {
+          if (!withAction || acted) return;
+          acted = true;
+          try { onAction(); } catch (error) { onError(error); }
+        };
+        return present(notificationOptions({ title, body, action: withAction ? action : '', silent, platform }), act);
+      } catch (error) {
+        onError(error);
+        return null;
+      }
+    },
+    liveCount: () => live.size,
+  };
+}
+
+module.exports = { escapeXml, toastXml, notificationOptions, createNotifier };

package/main.js

@@ -49,6 +49,7 @@ const { ControlServer } = require('./lib/control-server');
 const windowsConsole = require('./lib/windows-console');
 const windowsDwm = require('./lib/windows-dwm');
 const appearance = require('./lib/appearance');
+const { createNotifier } = require('./lib/notifications');
 
 function guardBrokenPipe(stream) {
   try {
@@ -931,6 +932,7 @@ function applyExternalTextEdit({ id, originalText, originalTitle, sourceGroups,
     newTitle,
     sourceGroups,
     groupTombstones: settings.group_tombstones,
+    supersedes: settings.supersedes,
     now: Date.now(),
     ignoreBlank: true,
   });
@@ -4889,9 +4891,9 @@ async function pasteAndHide(id) {
   }
 }
 
-// "Paste all": join the selected TEXT clips (newline-separated) and paste them in
-// one go. Images can't concatenate into text, so they're skipped.
-async function pasteMany(ids) {
+// "Paste all" / "Copy all": the selected TEXT clips joined (newline-separated)
+// in one go. Images can't concatenate into text, so they're skipped.
+function joinedClipText(ids) {
   const parts = [];
   for (const id of (Array.isArray(ids) ? ids : [])) {
     const item = findHistoryItem(id);
@@ -4899,18 +4901,30 @@ async function pasteMany(ids) {
     textBlobStore.hydrateTextItem(item, TEXT_DIR);
     parts.push(item.text || '');
   }
-  const text = parts.join('\n');
+  return parts.join('\n');
+}
+// The joined text onto the clipboard, never captured back as a new clip.
+function writeJoinedText(text) {
+  clipboard.writeText(text);
+  lastText = text;
+  lastImgHash = '';
+}
+async function pasteMany(ids) {
+  const text = joinedClipText(ids);
   if (!text) { hidePopup(); return; }
   pollGate = false;
   try {
-    clipboard.writeText(text);
-    lastText = text;   // don't re-capture our own joined paste as a new clip
-    lastImgHash = '';
+    writeJoinedText(text);
     await hideAndPasteForeground();
   } finally {
     pollGate = true;
   }
 }
+// "Copy all": the same text, nothing pasted; the popup stays.
+function copyMany(ids) {
+  const text = joinedClipText(ids);
+  if (text) writeJoinedText(text);
+}
 
 function validNumpadSlot(slot) {
   const slotNum = Number(slot);
@@ -5067,11 +5081,10 @@ function refreshTray() {
 //      prefix so they're retained but not resurrected).
 //   5. Disk retention - finished drafts are kept (LRU-pruned) as a last resort.
 //
-// editSessions: sessionId -> session. editWindowsByClip: originalId -> sessionId
-// (enforces one window per clip). A session re-anchors baseText/currentId after
-// each commit so the chain stays contiguous (in-place, not a fork).
+// editSessions: sessionId -> session (one window per note: findEditSessionForClip).
+// A session re-anchors baseText/currentId after each commit so the chain stays
+// contiguous (in-place, not a fork).
 const editSessions = new Map();
-const editWindowsByClip = new Map();
 const conflictWindows = new Map();
 const EDIT_DRAFT_RE = /^boardclip-edit-[0-9a-f]{12}-\d+(?:-\d+)?\.txt$/;   // in-flight drafts only (legacy `-<ts>` and current `-<ts>-<seq>` names)
 let editSessionSeq = 0;
@@ -5122,22 +5135,34 @@ function readDraftFile(sessionOrPath, fallback = {}) {
   return editorPayloadFrom(raw, fallback);
 }
 
+const notifier = createNotifier({
+  Notification,
+  onError: (error) => diagnostics.record('notification.error', { error: error && error.message }, { forceFile: true }),
+});
+
 function showEditNotification(title, body) {
-  try {
-    if (Notification && Notification.isSupported && Notification.isSupported()) {
-      new Notification({ title, body, silent: true }).show();
-    }
-  } catch {}
+  notifier.show({ title, body });
 }
 
-// Surface the conflict-fork outcome so a stale-based commit is never mistaken
-// for a clobber: the user's edit was kept as a new clip, untouched.
+// Surface a stale-based save so it is never mistaken for a clobber: the edit
+// was kept beside the note, and Merge (or a click on the notification) opens
+// the merge view that folds the two back into one note.
 function notifyEditOutcome(result) {
-  if (!result || (result.reason !== 'conflict_created' && result.reason !== 'conflict_merged')) return;
-  showEditNotification(
-    'BoardClip - saved as a separate clip',
-    'This clip changed while you were editing, so your version was kept as a new clip instead of overwriting. Nothing was lost.'
-  );
+  if (!result) return;
+  const record = result.conflictRecord;
+  if (record && record.kind === 'editor') {
+    notifier.show({
+      title: 'BoardClip - this note changed while you were editing',
+      body: 'Your version is kept as a separate clip, so nothing is lost.',
+      action: 'Merge',
+      onAction: () => showConflict(record.id),
+    });
+  } else if (!record && result.reason === 'conflict_created') {
+    showEditNotification(
+      'BoardClip - saved as a new clip',
+      'The clip you were editing was deleted, so your version is kept as a new clip.'
+    );
+  }
 }
 
 // --- Editor <-> clipboard follow (lib/clipboard-follow.js) ---
@@ -5206,6 +5231,7 @@ function commitEditSession(session, payload) {
     notifyEditOutcome(result);
     if (result.conflictRecord && session.win && !session.win.isDestroyed()) {
       session.inConflict = true;
+      session.conflictId = result.conflictRecord.id;
       try { session.win.webContents.send('editor-conflict', conflictModel.normalizeConflictRecord(result.conflictRecord)); } catch {}
     }
   }
@@ -5403,9 +5429,6 @@ function createEditorWindow(session, presentOptions = {}) {
   trackWindowBounds(editorWin, 'editor_bounds');
   editorWin.on('closed', () => {
     editSessions.delete(session.id);
-    if (session.originalId != null && editWindowsByClip.get(session.originalId) === session.id) {
-      editWindowsByClip.delete(session.originalId);
-    }
     // Safety net: commit the latest on-disk draft (the IPC commit may have raced
     // the window teardown), then mark the draft finished so it's retained but not
     // re-recovered, and prune. suppressCommit = the clip was deliberately deleted
@@ -5448,19 +5471,47 @@ function presentSecondaryWindow(targetWin, options = {}) {
   hidePopup();
 }
 
+// A note's id changes on every save (content-addressed), so its open editor is
+// found by the note's edit lineage, never by the id it opened with. Matching
+// only that id let a reopen start a second editor on the same note; the
+// first one's next save then left the second stale, and typing in it forked
+// the note.
+function findEditSessionForClip(id) {
+  const key = String(id || '');
+  if (!key) return null;
+  const lineage = clipboardModel.supersedeMap(settings.supersedes);
+  const head = (clipId) => lineage.get(clipId) || clipId;
+  const target = head(key);
+  for (const session of editSessions.values()) {
+    if (!session.currentId || !session.win || session.win.isDestroyed()) continue;
+    if (session.currentId === key || head(session.currentId) === target) return session;
+  }
+  return null;
+}
+
+// The merge view of a conflict: the editor already showing it (an editor turns
+// into the merge view when its save conflicts), else a conflict window.
+function showConflict(conflictId) {
+  const id = String(conflictId || '');
+  for (const session of editSessions.values()) {
+    if (session.conflictId === id && session.win && !session.win.isDestroyed()) {
+      presentSecondaryWindow(session.win);
+      return { ok: true };
+    }
+  }
+  return openConflictWindow(id);
+}
+
 function openEditor(id, options = {}) {
   if (id != null) {
-    const openSessionId = editWindowsByClip.get(id);
-    if (openSessionId) {
-      const s = editSessions.get(openSessionId);
-      if (s && s.win && !s.win.isDestroyed()) {
-        try {
-          presentSecondaryWindow(s.win, options);
-          if (options && options.find) s.win.webContents.send('editor-find', { query: options.find, findRegex: !!options.findRegex });
-          if (options && options.focusTitle) s.win.webContents.send('editor-find', { focusTitle: true });
-        } catch {}
-        return;
-      }
+    const s = findEditSessionForClip(id);
+    if (s) {
+      try {
+        presentSecondaryWindow(s.win, options);
+        if (options && options.find) s.win.webContents.send('editor-find', { query: options.find, findRegex: !!options.findRegex });
+        if (options && options.focusTitle) s.win.webContents.send('editor-find', { focusTitle: true });
+      } catch {}
+      return;
     }
   }
   let baseText = '';
@@ -5510,7 +5561,6 @@ function openEditor(id, options = {}) {
   session.follow.observe(editorNoteTexts(session));
   writeDraftFile(session);
   editSessions.set(session.id, session);
-  if (originalId != null) editWindowsByClip.set(originalId, session.id);
   createEditorWindow(session, options);
 }
 
@@ -5637,6 +5687,51 @@ function clipWindowState(id) {
   return { item, items, groups: [...(settings.groups || [])], aiGroup: mcpCore.AI_GROUP_NAME };
 }
 
+// A clip by an id a conflict record holds, followed to its newest version
+// when it was edited since.
+function liveTextClip(id) {
+  const key = String(id || '');
+  if (!key) return null;
+  const item = findHistoryItem(key) || findHistoryItem(clipboardModel.supersedeMap(settings.supersedes).get(key));
+  return item && item.type !== 'image' ? item : null;
+}
+
+// An editor conflict joins two clips: the note (left) and the edit kept beside
+// it (targetId). Resolving it makes them one note again.
+function conflictForkPair(record) {
+  if (!record || record.kind !== 'editor') return null;
+  const note = liveTextClip(record.left && record.left.id);
+  const fork = liveTextClip(record.targetId || (record.right && record.right.id));
+  return note && fork && note !== fork ? { note, fork } : null;
+}
+
+// The resolved text went into the note, which keeps its pin, numpad key and
+// lineage. The fork folds into it like an edit: its groups (and a numpad key
+// the note lacks) join the note, and a supersede link sends a stale copy or
+// an open editor of it to the note.
+function foldForkInto(fork, note) {
+  if (!fork || !note || fork === note) return;
+  const forkIndex = history.indexOf(fork);
+  if (forkIndex < 0) return; // the write already merged the two (same text)
+  const forkId = itemKey(fork);
+  const noteId = itemKey(note);
+  const forkSlot = numpadSlotOf(fork);
+  const noteGroups = groupsOf(note);
+  const newGroups = groupsOf(fork).filter(group => !noteGroups.includes(group));
+  if (newGroups.length) {
+    const pin = ensurePin(note);
+    pin.groups = [...(pin.groups || []), ...newGroups];
+    touchPinGroups(note);
+  }
+  if (isPinned(fork) && !note.pin) ensurePin(note);
+  deleteHistoryIndex(forkIndex, { tombstone: false });
+  addTombstone(forkId, null);
+  addSupersede({ from: forkId, to: noteId, updatedAt: Date.now() });
+  saveSettingsFile();
+  saveHistory();
+  if (forkSlot != null && numpadSlotOf(note) == null) applyNumpadAssign(noteId, forkSlot, clipboardModel.clipRevision(note));
+}
+
 function applyConflictResolution(resolution) {
   const payload = resolution && typeof resolution === 'object' ? resolution : {};
   const conflictId = String(payload.id || '');
@@ -5649,9 +5744,11 @@ function applyConflictResolution(resolution) {
     const text = write.text;
     const title = snapshot ? titleOf(snapshot) : clipboardModel.titleOf({ title: write.title });
     const targetId = record.targetId || snapshot && snapshot.id || record.right && record.right.id || record.left && record.left.id || '';
-    const target = findHistoryItem(targetId);
+    const fork = conflictForkPair(record);
+    const target = fork ? fork.note : findHistoryItem(targetId);
     if (target && target.type !== 'image') {
-      applyTextEditToItem(target, { newText: text, newTitle: title });
+      const written = applyTextEditToItem(target, { newText: text, newTitle: title });
+      if (fork) foldForkInto(fork.fork, (written && written.item) || fork.note);
     } else if (text.trim()) {
       applyExternalTextEdit({
         id: '',
@@ -6739,7 +6836,9 @@ function setupIPC() {
     },
   }));
 
-  ipcMain.handle('paste', (_, id) => {
+  // Copy without pasting: the clip onto the clipboard (the poller then sees it
+  // like any copy, so it moves to the top as a paste does).
+  ipcMain.handle('copy-clip', (_, id) => {
     const item = findHistoryItem(id);
     if (!item) return;
     setClipboardToItem(item);
@@ -6959,13 +7058,14 @@ function setupIPC() {
   });
   ipcMain.handle('resolve-conflict', (_, payload) => applyConflictResolution(payload));
   ipcMain.handle('get-conflicts', () => conflictListForRenderer());
-  ipcMain.handle('open-conflict', (_, id) => openConflictWindow(id));
+  ipcMain.handle('open-conflict', (_, id) => showConflict(id));
 
   // Multi-select bulk operations.
   ipcMain.handle('delete-items', (_, targets) => applyDeleteItems(targets));
   ipcMain.handle('restore-items', (_, snaps) => applyRestoreItems(snaps));
   ipcMain.handle('group-assign-many', (_, targets, group, shouldHave) => applyGroupAssignMany(targets, group, shouldHave));
   ipcMain.handle('paste-many', (_, ids) => pasteMany(ids));
+  ipcMain.handle('copy-many', (_, ids) => copyMany(ids));
   ipcMain.handle('start-unify', (_, ids) => startUnify(ids));
   ipcMain.handle('unify-step', (_, sessionId, payload) => unifyStep(sessionId, payload));
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tobq/boardclip",
   "productName": "BoardClip",
-  "version": "2.1.108",
+  "version": "2.1.110",
   "description": "Cross-platform clipboard history tray app with numpad quick-paste and native cloud sync",
   "keywords": [
     "clipboard",

package/preload.js

@@ -9,7 +9,7 @@ contextBridge.exposeInMainWorld('api', {
     return () => ipcRenderer.removeListener('history-changed', listener);
   },
   getSettings: () => ipcRenderer.invoke('get-settings'),
-  paste: (id) => ipcRenderer.invoke('paste', id),
+  copyClip: (id) => ipcRenderer.invoke('copy-clip', id),
   pasteAndHide: (id) => ipcRenderer.invoke('paste-and-hide', id),
   numpadPasteAndHide: (slot) => ipcRenderer.invoke('numpad-paste-and-hide', slot),
   hidePopup: () => ipcRenderer.invoke('hide-popup'),
@@ -22,6 +22,7 @@ contextBridge.exposeInMainWorld('api', {
   restoreItems: (snaps) => ipcRenderer.invoke('restore-items', snaps),
   groupAssignMany: (targets, group, shouldHave) => ipcRenderer.invoke('group-assign-many', targets, group, shouldHave), // [{ id, rev }]
   pasteMany: (ids) => ipcRenderer.invoke('paste-many', ids),
+  copyMany: (ids) => ipcRenderer.invoke('copy-many', ids),
   startUnify: (ids) => ipcRenderer.invoke('start-unify', ids),
   deleteAll: () => ipcRenderer.invoke('delete-all'),
   pin: (id, rev) => ipcRenderer.invoke('pin', id, rev),

package/site/index.html

@@ -859,20 +859,24 @@
       deleteClip: (id) => { clips = Core.deleteItem(clips, id); },
       clearUnpinned: () => { clips = clips.filter((clip) => Core.isPinned(clip)); },
       setGroupSharedAi: (group) => { if (demoSharedGroups.has(group)) demoSharedGroups.delete(group); else demoSharedGroups.add(group); },
-      copyNumpadSlot: async (id) => {
+      // Copy without pasting (the controller says "Copied"). A page cannot paste
+      // into another app, so the demo's click (activateClip) copies too.
+      copyClip: async (id) => {
         const clip = demoAdapter.itemById(id);
         if (!clip) return;
         if (clip.type === "image") { const ok = await writeImageClipboard(clip).catch(() => false); if (!ok) await writeBrowserClipboard(clip.text || ""); }
         else await writeBrowserClipboard(clip.text || "");
+        clips = Core.touchItem(clips, id);
+        renderClips();
+      },
+      // Copy all: the app's Paste all text (text clips, one per line).
+      copyMany: async (ids) => {
+        const text = ids.map((id) => demoAdapter.itemById(id)).filter((clip) => clip && clip.type !== "image").map((clip) => clip.text || "").join("\n");
+        if (text) await writeBrowserClipboard(text);
       },
       activateClip: async (id) => {
-        const clip = demoAdapter.itemById(id);
-        if (!clip) return;
-        if (clip.type === "image") { const ok = await writeImageClipboard(clip).catch(() => false); if (!ok) await writeBrowserClipboard(clip.text || ""); }
-        else await writeBrowserClipboard(clip.text || "");
-        clips = Core.touchItem(clips, id);
+        await demoAdapter.copyClip(id);
         showToast("Copied");
-        renderClips();
       },
       editClip: (id, _itemEl, options) => openDemoEditor(id, { ...Core.editorFindFor(state.query), ...(options || {}) }),
       // The open editor's title field is authoritative for its clip (it rides

package/site/shared/clipboard-ui-core.js

@@ -898,7 +898,7 @@
   // (popup, editor, viewer), so an action looks the same wherever it appears
   // and no two actions share a glyph.
   const CLIP_ACTION_ICONS = {
-    pin: 'star', edit: 'edit_note', 'open-img': 'open_in_full', 'open-img-ext': 'open_in_new', 'save-img': 'download',
+    copy: 'content_copy', pin: 'star', edit: 'edit_note', 'open-img': 'open_in_full', 'open-img-ext': 'open_in_new', 'save-img': 'download',
     rename: 'drive_file_rename_outline', revert: 'history', 'select-similar': 'select_all', del: 'delete',
   };
   function renderClipActions(item, options) {
@@ -906,7 +906,9 @@
     const id = itemId(item) || '';
     const isImage = item && item.type === 'image';
     const I = CLIP_ACTION_ICONS;
-    let html = '';
+    // Copy (no paste) leads every row: the clip goes on the clipboard and the
+    // popup stays.
+    let html = `<button class="icon-btn" data-action="copy" data-id="${escapeHtml(id)}" title="Copy" aria-label="Copy"><span class="mi">${I.copy}</span></button>`;
     if (isImage) {
       html += `<button class="icon-btn" data-action="open-img" data-id="${escapeHtml(id)}" title="Open image"><span class="mi">${I['open-img']}</span></button><button class="icon-btn" data-action="save-img" data-id="${escapeHtml(id)}" title="Copy to Downloads"><span class="mi">${I['save-img']}</span></button>`;
     } else {
@@ -1025,6 +1027,7 @@
     const nmap = opts.numpadMap || numpadMap(items);
     const row = (action, label, cls, extra) => menuRowHtml({ icon: CLIP_ACTION_ICONS[action], label, cls, ...(extra || {}), attrs: { 'data-action': action, 'data-id': id, ...((extra && extra.attrs) || {}) } });
     let html = '<div class="bc-menu-list">';
+    html += row('copy', 'Copy');
     html += row('pin', pinned ? 'Unpin' : 'Pin');
     if (isImage) {
       if (context !== 'viewer') html += row('open-img', 'Open image');
@@ -1071,6 +1074,7 @@
     const row = (action, icon, label, cls) => menuRowHtml({ icon, label, cls, attrs: { 'data-action': action } });
     let html = '<div class="bc-menu-list">';
     html += row('bulk-paste', 'content_paste', `Paste all (${count})`);
+    html += row('bulk-copy', CLIP_ACTION_ICONS.copy, `Copy all (${count})`);
     html += submenuNodeHtml({ icon: 'sell', label: 'Add to group' }, bulkGroupTreeHtml(groups, selItems, Search.groupWeights(opts.items || [])));
     if (allText) html += row('bulk-unify', 'merge', `Unify (${count})`);
     html += MENU_SEPARATOR + row('bulk-delete', CLIP_ACTION_ICONS.del, `Delete (${count})`, 'danger');
@@ -1098,6 +1102,7 @@
     return `<span class="selection-count">${count} selected</span>
       <div class="selection-actions">
         <button class="icon-btn" type="button" data-action="bulk-paste" title="Paste all (Enter)" aria-label="Paste all"><span class="mi">content_paste</span></button>
+        <button class="icon-btn" type="button" data-action="bulk-copy" title="Copy all" aria-label="Copy all"><span class="mi">${CLIP_ACTION_ICONS.copy}</span></button>
         <button class="icon-btn" type="button" data-action="bulk-group-open" title="Group" aria-label="Group" aria-haspopup="true"><span class="mi">sell</span></button>
         ${allText ? '<button class="icon-btn" type="button" data-action="bulk-unify" title="Unify into one clip" aria-label="Unify into one clip"><span class="mi">merge</span></button>' : ''}
         <button class="icon-btn danger" type="button" data-action="bulk-delete" title="Delete selected" aria-label="Delete selected"><span class="mi">delete</span></button>
@@ -3438,8 +3443,9 @@
   //   mutate:  pin(id), numpadAssign(id,slot), numpadUnassign(slot),
   //            toggleGroup(id,group) [add-or-remove], createGroup(name),
   //            deleteGroup(group), deleteClip(id), clearUnpinned(),
-  //            setGroupSharedAi(group), copyNumpadSlot(id)
-  //   actions: activateClip(id), editClip(id,itemEl), openImage(item),
+  //            setGroupSharedAi(group)
+  //   actions: activateClip(id), copyClip(id) [the clipboard only, no paste],
+  //            copyMany(ids) [Paste all's joined text, no paste], editClip(id,itemEl), openImage(item),
   //            saveImage(item)->feedbackString|null
   //   keyboard:isSettingsOpen(), closeSettings(), hidePopup(),
   //            moveSelection(dir), activateSelected()
@@ -4500,6 +4506,14 @@
       try { if (a.pasteMany) await a.pasteMany(ids); }
       finally { clearSelection(); } // always drop the selection (app hides the popup; demo hides the bar)
     }
+    // Copy all: Paste all's joined text onto the clipboard, nothing pasted;
+    // the popup and the selection stay.
+    async function copySelection() {
+      const ids = selectionInfo().ids;
+      if (!ids.length || !a.copyMany) return;
+      await a.copyMany(ids);
+      toast('Copied');
+    }
     async function deleteIds(ids) {
       if (!ids || !ids.length) return;
       ids.forEach((id) => selectedIds.delete(id));
@@ -4709,6 +4723,16 @@
       const bulkGroupOpen = t.closest('[data-action="bulk-group-open"]');
       if (bulkGroupOpen) { event.stopPropagation(); const r = bulkGroupOpen.getBoundingClientRect(); openBulkGroupMenu(r.left, r.bottom + 2); return true; }
       if (t.closest('[data-action="bulk-paste"]')) { event.stopPropagation(); pasteSelection(); return true; }
+      if (t.closest('[data-action="bulk-copy"]')) { event.stopPropagation(); copySelection(); return true; }
+      // Copy without pasting (a row's Copy, the clip menu's Copy): the row
+      // button carries data-id, the menu root does (closest).
+      const copyBtn = t.closest('[data-action="copy"]');
+      if (copyBtn) {
+        event.stopPropagation();
+        const owner = copyBtn.dataset.id ? copyBtn : copyBtn.closest('[data-id]');
+        if (owner && owner.dataset.id) { await a.copyClip(owner.dataset.id); toast('Copied'); }
+        return true;
+      }
       if (t.closest('[data-action="bulk-unify"]')) { event.stopPropagation(); unifySelection(); return true; }
       if (t.closest('[data-action="bulk-delete"]')) { event.stopPropagation(); deleteSelection(); return true; }
       if (t.closest('[data-action="bulk-clear"]')) { event.stopPropagation(); clearSelection(); return true; }
@@ -4763,7 +4787,7 @@
       const npRemove = t.closest('.np-remove');
       if (npRemove) { event.stopPropagation(); await a.numpadUnassign(Number(npRemove.dataset.slot)); refresh(); return true; }
       const slotEl = t.closest('.np-slot.has-content');
-      if (slotEl && slotEl.dataset.slotId) { event.stopPropagation(); await a.copyNumpadSlot(slotEl.dataset.slotId); toast('Copied'); return true; }
+      if (slotEl && slotEl.dataset.slotId) { event.stopPropagation(); await a.copyClip(slotEl.dataset.slotId); toast('Copied'); return true; }
       const share = t.closest('.gp-share');
       if (share) { event.stopPropagation(); await a.setGroupSharedAi(share.dataset.group); refresh(); return true; }
       const gpDel = t.closest('.gp-del');
@@ -4996,6 +5020,9 @@
       // re-painting selection classes after a full list rebuild) + exposed for tests.
       selection: selectionInfo,
       focusedId: () => focusId,
+      // An open menu or popover owns the keys (the app's empty-search digit
+      // quick-paste must not fire under it).
+      isMenuOpen: () => menu.isOpen(),
       clearSelection,
       selectAll,
       moveFocus,