clipboardy 4.0.0 → 5.0.1

package/index.d.ts

@@ -9,9 +9,6 @@ declare const clipboard: {
 	import clipboard from 'clipboardy';
 
 	await clipboard.write('🦄');
-
-	await clipboard.read();
-	//=> '🦄'
 	```
 	*/
 	write(text: string): Promise<void>;
@@ -23,9 +20,7 @@ declare const clipboard: {
 	```
 	import clipboard from 'clipboardy';
 
-	await clipboard.write('🦄');
-
-	await clipboard.read();
+	const content = await clipboard.read();
 	//=> '🦄'
 	```
 	*/
@@ -43,9 +38,6 @@ declare const clipboard: {
 	import clipboard from 'clipboardy';
 
 	clipboard.writeSync('🦄');
-
-	clipboard.readSync();
-	//=> '🦄'
 	```
 	*/
 	writeSync(text: string): void;
@@ -59,9 +51,7 @@ declare const clipboard: {
 	```
 	import clipboard from 'clipboardy';
 
-	clipboard.writeSync('🦄');
-
-	clipboard.readSync();
+	const content = clipboard.readSync();
 	//=> '🦄'
 	```
 	*/

package/index.js

@@ -1,7 +1,9 @@
 import process from 'node:process';
 import isWSL from 'is-wsl';
+import isWayland from 'is-wayland';
 import termux from './lib/termux.js';
 import linux from './lib/linux.js';
+import wayland from './lib/wayland.js';
 import macos from './lib/macos.js';
 import windows from './lib/windows.js';
 
@@ -16,7 +18,7 @@ const platformLib = (() => {
 		}
 
 		case 'android': {
-			if (process.env.PREFIX !== '/data/data/com.termux/files/usr') {
+			if (process.env.TERMUX__PREFIX === undefined) {
 				throw new Error('You need to install Termux for this module to work on Android: https://termux.com');
 			}
 
@@ -29,31 +31,40 @@ const platformLib = (() => {
 				return windows;
 			}
 
+			// Check for Wayland session on Linux
+			if (isWayland()) {
+				return wayland;
+			}
+
 			return linux;
 		}
 	}
 })();
 
-const clipboard = {};
+const clipboard = {
+	async write(text) {
+		if (typeof text !== 'string') {
+			throw new TypeError(`Expected a string, got ${typeof text}`);
+		}
 
-clipboard.write = async text => {
-	if (typeof text !== 'string') {
-		throw new TypeError(`Expected a string, got ${typeof text}`);
-	}
+		await platformLib.copy({input: text});
+	},
 
-	await platformLib.copy({input: text});
-};
+	async read() {
+		return platformLib.paste({stripFinalNewline: false});
+	},
 
-clipboard.read = async () => platformLib.paste({stripFinalNewline: false});
+	writeSync(text) {
+		if (typeof text !== 'string') {
+			throw new TypeError(`Expected a string, got ${typeof text}`);
+		}
 
-clipboard.writeSync = text => {
-	if (typeof text !== 'string') {
-		throw new TypeError(`Expected a string, got ${typeof text}`);
-	}
+		platformLib.copySync({input: text});
+	},
 
-	platformLib.copySync({input: text});
+	readSync() {
+		return platformLib.pasteSync({stripFinalNewline: false});
+	},
 };
 
-clipboard.readSync = () => platformLib.pasteSync({stripFinalNewline: false});
-
 export default clipboard;

package/lib/linux.js

@@ -11,11 +11,13 @@ const copyArguments = ['--clipboard', '--input'];
 const pasteArguments = ['--clipboard', '--output'];
 
 const makeError = (xselError, fallbackError) => {
-	let error;
-	if (xselError.code === 'ENOENT') {
-		error = new Error('Couldn\'t find the `xsel` binary and fallback didn\'t work. On Debian/Ubuntu you can install xsel with: sudo apt install xsel');
-	} else {
-		error = new Error('Both xsel and fallback failed');
+	const message = xselError.code === 'ENOENT'
+		? 'Couldn\'t find the `xsel` binary and fallback didn\'t work. On Debian/Ubuntu you can install xsel with: sudo apt install xsel'
+		: 'Both xsel and fallback failed';
+
+	const error = new Error(message);
+
+	if (xselError.code !== 'ENOENT') {
 		error.xselError = xselError;
 	}
 

package/lib/termux.js

@@ -2,7 +2,7 @@ import {execa, execaSync} from 'execa';
 
 const handler = error => {
 	if (error.code === 'ENOENT') {
-		throw new Error('Couldn\'t find the termux-api scripts. You can install them with: apt install termux-api');
+		throw new Error('Couldn\'t find the `termux-api` scripts. You can install them with: apt install termux-api');
 	}
 
 	throw error;

package/lib/wayland.js

@@ -0,0 +1,70 @@
+import {execa, execaSync} from 'execa';
+import linux from './linux.js';
+
+// Common arguments for text clipboard operations
+const textArgs = ['--type', 'text/plain'];
+
+const makeError = (command, error) => {
+	if (error.code === 'ENOENT') {
+		return new Error(`Couldn't find the \`${command}\` binary. On Debian/Ubuntu you can install wl-clipboard with: sudo apt install wl-clipboard`);
+	}
+
+	return new Error(`Command \`${command}\` failed: ${error.message}`);
+};
+
+const tryWaylandWithFallback = async (command, arguments_, options, fallbackMethod) => {
+	try {
+		const result = await execa(command, arguments_, options);
+		return result.stdout;
+	} catch (error) {
+		// Handle empty clipboard on wl-paste
+		if (command === 'wl-paste' && /nothing is copied|no selection|selection owner/i.test(error.stderr || '')) {
+			return '';
+		}
+
+		// Fall back to X11 if wl-clipboard not found OR Wayland not available
+		if (error.code === 'ENOENT'
+			|| /wayland|wayland_display|failed to connect|display/i.test(error.stderr || '')) {
+			return fallbackMethod(options);
+		}
+
+		throw makeError(command, error);
+	}
+};
+
+const tryWaylandWithFallbackSync = (command, arguments_, options, fallbackMethod) => {
+	try {
+		const result = execaSync(command, arguments_, options);
+		return result.stdout;
+	} catch (error) {
+		// Handle empty clipboard on wl-paste
+		if (command === 'wl-paste' && /nothing is copied|no selection|selection owner/i.test(error.stderr || '')) {
+			return '';
+		}
+
+		// Fall back to X11 if wl-clipboard not found OR Wayland not available
+		if (error.code === 'ENOENT'
+			|| /wayland|wayland_display|failed to connect|display/i.test(error.stderr || '')) {
+			return fallbackMethod(options);
+		}
+
+		throw makeError(command, error);
+	}
+};
+
+const clipboard = {
+	async copy(options) {
+		await tryWaylandWithFallback('wl-copy', textArgs, options, linux.copy);
+	},
+	copySync(options) {
+		tryWaylandWithFallbackSync('wl-copy', textArgs, options, linux.copySync);
+	},
+	async paste(options) {
+		return tryWaylandWithFallback('wl-paste', [...textArgs, '--no-newline'], options, linux.paste);
+	},
+	pasteSync(options) {
+		return tryWaylandWithFallbackSync('wl-paste', [...textArgs, '--no-newline'], options, linux.pasteSync);
+	},
+};
+
+export default clipboard;

package/lib/windows.js

@@ -1,3 +1,4 @@
+import {Buffer} from 'node:buffer';
 import path from 'node:path';
 import {fileURLToPath} from 'node:url';
 import {execa, execaSync} from 'execa';
@@ -10,14 +11,85 @@ const binarySuffix = is64bitSync() ? 'x86_64' : 'i686';
 // Binaries from: https://github.com/sindresorhus/win-clipboard
 const windowBinaryPath = path.join(__dirname, `../fallbacks/windows/clipboard_${binarySuffix}.exe`);
 
+const powershellPath = 'powershell.exe';
+
+const psCommonArgs = [
+	'-NoProfile',
+	'-NonInteractive',
+	'-ExecutionPolicy',
+	'Bypass',
+];
+
+// Use -EncodedCommand for better safety and Unicode handling
+const createEncodedCommand = script => {
+	const encodedCommand = Buffer.from(script, 'utf16le').toString('base64');
+	return [...psCommonArgs, '-EncodedCommand', encodedCommand];
+};
+
+// Robust PowerShell commands with error handling
+const psCopyScript = `
+try {
+	[Console]::InputEncoding = [System.Text.Encoding]::UTF8
+	$input = [Console]::In.ReadToEnd()
+	if ($input -eq $null) { $input = '' }
+	Set-Clipboard -Value $input
+} catch {
+	Write-Error "Failed to set clipboard: $($_.Exception.Message)"
+	exit 1
+}
+`.trim();
+
+const psPasteScript = `
+try {
+	$content = Get-Clipboard -Raw -ErrorAction Stop
+	if ($content -eq $null) { $content = '' }
+	[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+	[Console]::Out.Write($content)
+} catch {
+	Write-Error "Failed to get clipboard: $($_.Exception.Message)"
+	exit 1
+}
+`.trim();
+
+const executeWithFallback = async (primaryCommand, fallbackCommand) => {
+	try {
+		return await primaryCommand();
+	} catch {
+		return fallbackCommand();
+	}
+};
+
+const executeWithFallbackSync = (primaryCommand, fallbackCommand) => {
+	try {
+		return primaryCommand();
+	} catch {
+		return fallbackCommand();
+	}
+};
+
 const clipboard = {
-	copy: async options => execa(windowBinaryPath, ['--copy'], options),
+	copy: async options => executeWithFallback(
+		async () => execa(powershellPath, createEncodedCommand(psCopyScript), options),
+		async () => execa(windowBinaryPath, ['--copy'], options),
+	),
+
 	async paste(options) {
-		const {stdout} = await execa(windowBinaryPath, ['--paste'], options);
+		const {stdout} = await executeWithFallback(
+			async () => execa(powershellPath, createEncodedCommand(psPasteScript), options),
+			async () => execa(windowBinaryPath, ['--paste'], options),
+		);
 		return stdout;
 	},
-	copySync: options => execaSync(windowBinaryPath, ['--copy'], options),
-	pasteSync: options => execaSync(windowBinaryPath, ['--paste'], options).stdout,
+
+	copySync: options => executeWithFallbackSync(
+		() => execaSync(powershellPath, createEncodedCommand(psCopyScript), options),
+		() => execaSync(windowBinaryPath, ['--copy'], options),
+	),
+
+	pasteSync: options => executeWithFallbackSync(
+		() => execaSync(powershellPath, createEncodedCommand(psPasteScript), options),
+		() => execaSync(windowBinaryPath, ['--paste'], options),
+	).stdout,
 };
 
 export default clipboard;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "clipboardy",
-	"version": "4.0.0",
+	"version": "5.0.1",
 	"description": "Access the system clipboard (copy/paste)",
 	"license": "MIT",
 	"repository": "sindresorhus/clipboardy",
@@ -16,12 +16,13 @@
 		"node": "./index.js",
 		"default": "./browser.js"
 	},
+	"sideEffects": false,
 	"engines": {
-		"node": ">=18"
+		"node": ">=20"
 	},
-	"sideEffects": false,
 	"scripts": {
-		"test": "xo && ava && tsd"
+		"//test": "xo && ava",
+		"test": "ava"
 	},
 	"files": [
 		"index.js",
@@ -44,14 +45,14 @@
 		"xsel"
 	],
 	"dependencies": {
-		"execa": "^8.0.1",
+		"execa": "^9.6.0",
+		"is-wayland": "^0.1.0",
 		"is-wsl": "^3.1.0",
 		"is64bit": "^2.0.0"
 	},
 	"devDependencies": {
-		"ava": "^5.3.1",
-		"tsd": "^0.29.0",
-		"xo": "^0.56.0"
+		"ava": "^6.4.1",
+		"xo": "^1.2.2"
 	},
 	"ava": {
 		"serial": true

package/readme.md

@@ -2,7 +2,7 @@
 
 > Access the system clipboard (copy/paste)
 
-Cross-platform. Supports: macOS, Windows, Linux, OpenBSD, FreeBSD, Android with [Termux](https://termux.com/), and [modern browsers](https://developer.mozilla.org/en-US/docs/Web/API/Clipboard_API#Browser_compatibility).
+Cross-platform. Supports: macOS, Windows, Linux (including Wayland), OpenBSD, FreeBSD, Android with [Termux](https://termux.com/), and [modern browsers](https://developer.mozilla.org/en-US/docs/Web/API/Clipboard_API#Browser_compatibility).
 
 ## Install
 
@@ -15,6 +15,12 @@ npm install clipboardy
 ```js
 import clipboard from 'clipboardy';
 
+await clipboard.write('🦄');
+
+await clipboard.read();
+//=> '🦄'
+
+// Or use the synchronous API
 clipboard.writeSync('🦄');
 
 clipboard.readSync();
@@ -23,7 +29,7 @@ clipboard.readSync();
 
 ## API
 
-In the browser, it requires a [secure context](https://developer.mozilla.org/en-US/docs/Web/Security/Secure_Contexts).
+**Browser usage:** Requires a [secure context](https://developer.mozilla.org/en-US/docs/Web/Security/Secure_Contexts) (HTTPS). Synchronous methods are not available in browsers.
 
 ### clipboard
 
@@ -31,7 +37,7 @@ In the browser, it requires a [secure context](https://developer.mozilla.org/en-
 
 Write (copy) to the clipboard asynchronously.
 
-Returns a `Promise`.
+Returns a `Promise<void>`.
 
 ##### text
 
@@ -39,11 +45,20 @@ Type: `string`
 
 The text to write to the clipboard.
 
+```js
+await clipboard.write('🦄');
+```
+
 #### .read()
 
 Read (paste) from the clipboard asynchronously.
 
-Returns a `Promise`.
+Returns a `Promise<string>`.
+
+```js
+const content = await clipboard.read();
+//=> '🦄'
+```
 
 #### .writeSync(text)
 
@@ -57,19 +72,37 @@ Type: `string`
 
 The text to write to the clipboard.
 
+```js
+clipboard.writeSync('🦄');
+```
+
 #### .readSync()
 
 Read (paste) from the clipboard synchronously.
 
+Returns a `string`.
+
 **Doesn't work in browsers.**
 
+```js
+const content = clipboard.readSync();
+//=> '🦄'
+```
+
 ## FAQ
 
 #### Where can I find the source of the bundled binaries?
 
 The [Linux binary](fallbacks/linux/xsel) is just a bundled version of [`xsel`](https://linux.die.net/man/1/xsel). The source for the [Windows binary](fallbacks/windows/clipboard_x86_64.exe) can be found [here](https://github.com/sindresorhus/win-clipboard).
 
+On Windows, clipboardy first tries the native PowerShell cmdlets (`Set-Clipboard`/`Get-Clipboard`) and falls back to the bundled binary if PowerShell is unavailable or restricted.
+
+#### Does this work on Wayland?
+
+Yes. On Linux, clipboardy automatically detects Wayland sessions and uses [`wl-clipboard`](https://github.com/bugaevc/wl-clipboard) when available. If not, it gracefully falls back to X11 tools. Also works with WSLg (Windows Subsystem for Linux GUI). Install `wl-clipboard` using your distribution's package manager.
+
 ## Related
 
 - [clipboard-cli](https://github.com/sindresorhus/clipboard-cli) - CLI for this module
+- [clipboard-image](https://github.com/sindresorhus/clipboard-image) - Get and set images on the clipboard
 - [copy-text-to-clipboard](https://github.com/sindresorhus/copy-text-to-clipboard) - Copy text to the clipboard in the browser