feat: add automatic paste feature to clipboard history and update related settings (#66)

Author: leandromqrs

data/po/pt_BR.po

@@ -6,7 +6,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: aurora-shell\n"
 "Report-Msgid-Bugs-To: https://github.com/luminusOS/aurora-shell/issues\n"
-"POT-Creation-Date: 2026-07-11 22:48-0300\n"
+"POT-Creation-Date: 2026-07-14 13:44-0300\n"
 "PO-Revision-Date: 2026-03-09 18:00-0300\n"
 "Last-Translator: Aurora Shell Contributors\n"
 "Language-Team: Portuguese (Brazil)\n"
@@ -33,10 +33,18 @@ msgid "Keyboard shortcut to open the clipboard history panel"
 msgstr ""
 
 #: dist/clipboard/clipboardHistory.manifest.js:19
+msgid "Paste Automatically"
+msgstr "Colar automaticamente"
+
+#: dist/clipboard/clipboardHistory.manifest.js:20
+msgid "Insert the selected text into the previously focused input"
+msgstr "Insere o texto selecionado no campo que estava em foco anteriormente"
+
+#: dist/clipboard/clipboardHistory.manifest.js:25
 msgid "Poll Interval (ms)"
 msgstr ""
 
-#: dist/clipboard/clipboardHistory.manifest.js:20
+#: dist/clipboard/clipboardHistory.manifest.js:26
 msgid "How often to check the clipboard for changes"
 msgstr ""
 
@@ -69,7 +77,7 @@ msgstr "O histórico da área de transferência está vazio"
 msgid "Copy text, links, code, or images to see them here."
 msgstr "Copie textos, links, códigos ou imagens para vê-los aqui."
 
-#: dist/clipboard/clipboardPanel.js:35
+#: dist/clipboard/clipboardPanel.js:38
 msgid "Search…"
 msgstr "Pesquisar…"
 
@@ -250,15 +258,15 @@ msgid "No recent items"
 msgstr ""
 
 #: dist/panel/auroraMenu.js:339 dist/panel/auroraMenu.js:352
-#: dist/panel/auroraMenu.js:371 dist/panel/auroraMenu.manifest.js:8
+#: dist/panel/auroraMenu.js:374 dist/panel/auroraMenu.manifest.js:8
 msgid "Aurora Menu"
 msgstr ""
 
 #: dist/panel/auroraMenu.js:339 dist/panel/auroraMenu.js:352
 msgid "Could not launch the selected command."
 msgstr ""
 
-#: dist/panel/auroraMenu.js:371
+#: dist/panel/auroraMenu.js:374
 msgid "Could not open the selected recent item."
 msgstr ""
 

data/schemas/org.gnome.shell.extensions.aurora-shell.gschema.xml

@@ -307,6 +307,11 @@
       <summary>Clipboard History shortcut</summary>
       <description>Keyboard shortcut to open the clipboard history panel</description>
     </key>
+    <key name="clipboard-history-auto-paste" type="b">
+      <default>true</default>
+      <summary>Insert clipboard text automatically</summary>
+      <description>Insert the selected clipboard text into the input that was focused before opening the panel</description>
+    </key>
     <key name="clipboard-history-poll-interval" type="i">
       <range min="250" max="5000"/>
       <default>1000</default>

src/clipboard/clipboardHistory.manifest.ts

@@ -14,6 +14,12 @@ export const manifest: ModuleManifest = {
       subtitle: _('Keyboard shortcut to open the clipboard history panel'),
       type: 'shortcut',
     },
+    {
+      key: 'clipboard-history-auto-paste',
+      title: _('Paste Automatically'),
+      subtitle: _('Insert the selected text into the previously focused input'),
+      type: 'switch',
+    },
     {
       key: 'clipboard-history-poll-interval',
       title: _('Poll Interval (ms)'),

src/clipboard/clipboardHistory.ts

@@ -19,6 +19,8 @@ import { ClipboardMonitor } from '~/clipboard/clipboardMonitor.ts';
 import { ClipboardPanel } from '~/clipboard/clipboardPanel.ts';
 
 const KEYBINDING_KEY = 'clipboard-history-shortcut';
+const AUTO_PASTE_KEY = 'clipboard-history-auto-paste';
+const AUTO_PASTE_DELAY_MS = 100;
 const LOG_PREFIX = 'ClipboardHistory';
 
 // @ts-ignore - _promisify is a GJS extension not reflected in .d.ts
@@ -30,6 +32,8 @@ export class ClipboardHistory extends Module {
   private _panel: ClipboardPanel | null = null;
   private _cleanup: CleanupBag | null = null;
   private _startupIdleId: number = 0;
+  private _autoPasteTimeoutId: number = 0;
+  private _pasteTargetWindow: Meta.Window | null = null;
 
   constructor(context: ExtensionContext) {
     super(context);
@@ -102,6 +106,9 @@ export class ClipboardHistory extends Module {
   }
 
   override disable(): void {
+    this._cancelScheduledAutoPaste();
+    this._pasteTargetWindow = null;
+
     this._cleanup?.dispose();
     this._cleanup = null;
 
@@ -118,13 +125,15 @@ export class ClipboardHistory extends Module {
 
   openPanel(): boolean {
     if (!this._panel) return false;
+    if (!this._panel.isOpen) this._pasteTargetWindow = global.display.focus_window;
     this._panel.open();
     return true;
   }
 
   closePanel(): boolean {
     if (!this._panel) return false;
     this._panel.close();
+    this._pasteTargetWindow = null;
     return true;
   }
 
@@ -165,8 +174,12 @@ export class ClipboardHistory extends Module {
       return;
     }
 
+    const pasteTarget = this.context.settings.getBoolean(AUTO_PASTE_KEY)
+      ? this._pasteTargetWindow
+      : null;
     St.Clipboard.get_default().set_text(St.ClipboardType.CLIPBOARD, entry.text);
     this.closePanel();
+    if (pasteTarget) this._scheduleAutoPaste(pasteTarget, entry.text);
     logger.debug(`Restored clipboard entry: ${entry.text.slice(0, 40)}`, { prefix: LOG_PREFIX });
   }
 
@@ -182,6 +195,34 @@ export class ClipboardHistory extends Module {
     }
   }
 
+  private _scheduleAutoPaste(targetWindow: Meta.Window, text: string): void {
+    if (!this._cleanup) return;
+
+    this._cancelScheduledAutoPaste();
+    try {
+      targetWindow.activate(global.get_current_time());
+    } catch (e) {
+      logger.warn(
+        'Failed to restore focus before automatic paste:',
+        { prefix: LOG_PREFIX },
+        e as Error,
+      );
+      return;
+    }
+
+    this._autoPasteTimeoutId = GLib.timeout_add(GLib.PRIORITY_DEFAULT, AUTO_PASTE_DELAY_MS, () => {
+      this._autoPasteTimeoutId = 0;
+      if (this._cleanup && Main.inputMethod.currentFocus) Main.inputMethod.commit(text);
+      return GLib.SOURCE_REMOVE;
+    });
+  }
+
+  private _cancelScheduledAutoPaste(): void {
+    if (this._autoPasteTimeoutId === 0) return;
+    GLib.source_remove(this._autoPasteTimeoutId);
+    this._autoPasteTimeoutId = 0;
+  }
+
   private _onRemove(id: string): void {
     this._store?.remove(id);
     this._panel?.refresh();

src/clipboard/clipboardPanel.ts

@@ -4,15 +4,13 @@ import { gettext as _ } from 'gettext';
 import St from '@girs/st-18';
 import GObject from '@girs/gobject-2.0';
 import Clutter from '@girs/clutter-18';
-import type Meta from '@girs/meta-18';
 import * as Main from '@girs/gnome-shell/ui/main';
 
 import type { ClipboardEntry, ClipboardStore } from '~/clipboard/clipboardStore.ts';
 import { ClipboardList } from '~/clipboard/clipboardList.ts';
 import {
+  findClipboardPanelMonitorAtPoint,
   placeClipboardPanelNearPointer,
-  resolveClipboardPanelAnchor,
-  type ClipboardPanelWindowPlacement,
 } from '~/clipboard/clipboardPosition.ts';
 
 const PANEL_WIDTH = 360;
@@ -101,10 +99,10 @@ export class ClipboardPanel extends St.BoxLayout {
       return Clutter.EVENT_STOP;
     });
 
-    Main.uiGroup.add_child(this._overlay);
-    Main.uiGroup.add_child(this); // panel sits above overlay
+    Main.layoutManager.addTopChrome(this._overlay, { trackFullscreen: false });
+    Main.layoutManager.addTopChrome(this, { trackFullscreen: false }); // panel sits above overlay
 
-    this._positionNearCurrentAnchor();
+    this._positionNearPointer();
 
     this.show();
     this._isOpen = true;
@@ -149,12 +147,12 @@ export class ClipboardPanel extends St.BoxLayout {
     }
 
     if (this._overlay) {
-      Main.uiGroup.remove_child(this._overlay);
+      Main.layoutManager.removeChrome(this._overlay);
       this._overlay.destroy();
       this._overlay = null;
     }
 
-    Main.uiGroup.remove_child(this);
+    Main.layoutManager.removeChrome(this);
     this.hide();
     this._isOpen = false;
   }
@@ -235,22 +233,13 @@ export class ClipboardPanel extends St.BoxLayout {
     }
   }
 
-  private _positionNearCurrentAnchor(): void {
+  private _positionNearPointer(): void {
     const [pointerX, pointerY] = global.get_pointer();
-    const pointerMonitorIndex = this._findMonitorIndexAt(pointerX, pointerY);
-    const anchor = resolveClipboardPanelAnchor(
-      pointerX,
-      pointerY,
-      pointerMonitorIndex,
-      this._getFocusedWindowPlacement(),
-    );
-    const monitorIndex = this._isMonitorValid(anchor.monitorIndex)
-      ? anchor.monitorIndex
-      : pointerMonitorIndex;
+    const monitorIndex = this._findMonitorIndexAt(pointerX, pointerY);
     const workArea = Main.layoutManager.getWorkAreaForMonitor(monitorIndex);
     const bounds = placeClipboardPanelNearPointer(
-      anchor.x,
-      anchor.y,
+      pointerX,
+      pointerY,
       workArea,
       PANEL_WIDTH,
       PANEL_HEIGHT,
@@ -263,43 +252,11 @@ export class ClipboardPanel extends St.BoxLayout {
   }
 
   private _findMonitorIndexAt(x: number, y: number): number {
-    const monitors = Main.layoutManager.monitors;
-    for (let i = 0; i < monitors.length; i++) {
-      const monitor = monitors[i]!;
-      if (
-        x >= monitor.x &&
-        x < monitor.x + monitor.width &&
-        y >= monitor.y &&
-        y < monitor.y + monitor.height
-      ) {
-        return i;
-      }
-    }
-
-    return Main.layoutManager.primaryIndex;
-  }
-
-  private _getFocusedWindowPlacement(): ClipboardPanelWindowPlacement | null {
-    const win = global.display.focus_window as Meta.Window | null;
-    if (!win || win.minimized) return null;
-
-    const monitorIndex = win.get_monitor();
-    if (!this._isMonitorValid(monitorIndex)) return null;
-
-    const frame = win.get_frame_rect();
-    return {
-      monitorIndex,
-      frame: {
-        x: frame.x,
-        y: frame.y,
-        width: frame.width,
-        height: frame.height,
-      },
-    };
-  }
-
-  private _isMonitorValid(monitorIndex: number): boolean {
-    const monitors = Main.layoutManager.monitors ?? [];
-    return monitorIndex >= 0 && monitorIndex < monitors.length;
+    return findClipboardPanelMonitorAtPoint(
+      x,
+      y,
+      Main.layoutManager.monitors,
+      Main.layoutManager.primaryIndex,
+    );
   }
 }

src/clipboard/clipboardPosition.ts

@@ -5,32 +5,21 @@ export type ClipboardPanelBounds = {
   height: number;
 };
 
-export type ClipboardPanelAnchor = {
-  x: number;
-  y: number;
-  monitorIndex: number;
-};
-
-export type ClipboardPanelWindowPlacement = {
-  monitorIndex: number;
-  frame: ClipboardPanelBounds;
-};
-
-export function resolveClipboardPanelAnchor(
-  pointerX: number,
-  pointerY: number,
-  pointerMonitorIndex: number,
-  focusedWindow: ClipboardPanelWindowPlacement | null,
-): ClipboardPanelAnchor {
-  if (focusedWindow && focusedWindow.monitorIndex >= 0 && hasUsableFrame(focusedWindow.frame)) {
-    return {
-      x: focusedWindow.frame.x + Math.floor(focusedWindow.frame.width / 2),
-      y: focusedWindow.frame.y + Math.floor(focusedWindow.frame.height / 2),
-      monitorIndex: focusedWindow.monitorIndex,
-    };
-  }
-
-  return { x: pointerX, y: pointerY, monitorIndex: pointerMonitorIndex };
+export function findClipboardPanelMonitorAtPoint(
+  x: number,
+  y: number,
+  monitors: readonly ClipboardPanelBounds[],
+  fallbackMonitorIndex: number,
+): number {
+  const monitorIndex = monitors.findIndex(
+    (monitor) =>
+      x >= monitor.x &&
+      x < monitor.x + monitor.width &&
+      y >= monitor.y &&
+      y < monitor.y + monitor.height,
+  );
+
+  return monitorIndex >= 0 ? monitorIndex : fallbackMonitorIndex;
 }
 
 export function placeClipboardPanelNearPointer(
@@ -71,7 +60,3 @@ function clamp(value: number, min: number, max: number): number {
   if (max < min) return min;
   return Math.max(min, Math.min(max, value));
 }
-
-function hasUsableFrame(frame: ClipboardPanelBounds): boolean {
-  return frame.width > 0 && frame.height > 0;
-}