@flighthq/clipboard 0.1.0

package/dist/clipboard.d.ts

@@ -0,0 +1,34 @@
+import type { ClipboardBackend, ClipboardBookmark, ClipboardWatch, ClipboardWriteItem } from '@flighthq/types';
+export declare function attachClipboardWatch(watch: ClipboardWatch): void;
+export declare function clearClipboard(): Promise<boolean>;
+export declare function createClipboardWatch(): ClipboardWatch;
+export declare function createWebClipboardBackend(): ClipboardBackend;
+export declare function detachClipboardWatch(watch: ClipboardWatch): void;
+export declare function disposeClipboardWatch(watch: ClipboardWatch): void;
+export declare function getClipboardBackend(): ClipboardBackend;
+export declare function getClipboardChangeCount(): number;
+export declare function getClipboardFormats(): Promise<readonly string[]>;
+export declare function hasClipboardBookmark(): Promise<boolean>;
+export declare function hasClipboardFormat(format: string): Promise<boolean>;
+export declare function hasClipboardHtml(): Promise<boolean>;
+export declare function hasClipboardImage(): Promise<boolean>;
+export declare function hasClipboardRTF(): Promise<boolean>;
+export declare function hasClipboardText(): Promise<boolean>;
+export declare function readClipboard(formats: readonly string[]): Promise<Readonly<Record<string, string>>>;
+export declare function readClipboardBookmark(): Promise<ClipboardBookmark | null>;
+export declare function readClipboardFiles(): Promise<readonly string[]>;
+export declare function readClipboardFormat(format: string): Promise<string>;
+export declare function readClipboardHtml(): Promise<string>;
+export declare function readClipboardImage(): Promise<string>;
+export declare function readClipboardRTF(): Promise<string>;
+export declare function readClipboardText(): Promise<string>;
+export declare function setClipboardBackend(backend: ClipboardBackend | null): void;
+export declare function writeClipboard(items: readonly Readonly<ClipboardWriteItem>[]): Promise<boolean>;
+export declare function writeClipboardBookmark(title: string, url: string): Promise<boolean>;
+export declare function writeClipboardFiles(paths: readonly string[]): Promise<boolean>;
+export declare function writeClipboardFormat(format: string, data: string): Promise<boolean>;
+export declare function writeClipboardHtml(html: string): Promise<boolean>;
+export declare function writeClipboardImage(dataUrl: string): Promise<boolean>;
+export declare function writeClipboardRTF(rtf: string): Promise<boolean>;
+export declare function writeClipboardText(text: string): Promise<boolean>;
+//# sourceMappingURL=clipboard.d.ts.map

package/dist/clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../src/clipboard.ts"],"names":[],"mappings":"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"}

package/dist/clipboard.js

@@ -0,0 +1,391 @@
+import { createSignal, emitSignal } from '@flighthq/signals';
+import { ClipboardFormatBookmark, ClipboardFormatHtml, ClipboardFormatRtf } from '@flighthq/types';
+// Attaches `watch` to the active backend's change subscription. Emits watch.onChange on each
+// clipboard change. Idempotent: a prior subscription is torn down first.
+// Pair with detachClipboardWatch / disposeClipboardWatch.
+export function attachClipboardWatch(watch) {
+    detachClipboardWatch(watch);
+    const unsubscribe = getClipboardBackend().subscribeClipboardChange(() => {
+        emitSignal(watch.onChange);
+    });
+    _watchSubscriptions.set(watch, unsubscribe);
+}
+// Clears the system clipboard. Returns false when the host denies access. Sentinel, not throw.
+export function clearClipboard() {
+    return getClipboardBackend().clear();
+}
+// Allocates a ClipboardWatch event entity with an inert signal.
+// Call attachClipboardWatch to start delivery; call disposeClipboardWatch when done.
+export function createClipboardWatch() {
+    return { onChange: createSignal() };
+}
+// Builds the default web backend over navigator.clipboard. Reads return '' / false / [] when the API
+// is absent (non-secure context, jsdom) or the user denies permission.
+export function createWebClipboardBackend() {
+    return {
+        async readFormat(format) {
+            const cb = getWebClipboard();
+            if (cb === null || typeof cb.read !== 'function')
+                return '';
+            try {
+                const items = await cb.read();
+                for (const item of items) {
+                    if (item.types.includes(format)) {
+                        const blob = await item.getType(format);
+                        if (format.startsWith('image/'))
+                            return readBlobAsDataUrl(blob);
+                        return blob.text();
+                    }
+                }
+            }
+            catch {
+                return '';
+            }
+            return '';
+        },
+        async writeFormat(format, data) {
+            const cb = getWritableWebClipboard();
+            if (cb === null)
+                return false;
+            try {
+                const blob = await blobFromFormatData(format, data);
+                await cb.write([new ClipboardItem({ [format]: blob })]);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        async hasFormat(format) {
+            const formats = await this.getFormats();
+            return formats.includes(format);
+        },
+        async getFormats() {
+            const cb = getWebClipboard();
+            if (cb === null || typeof cb.read !== 'function')
+                return [];
+            try {
+                const items = await cb.read();
+                const out = [];
+                for (const item of items) {
+                    for (const t of item.types) {
+                        if (!out.includes(t))
+                            out.push(t);
+                    }
+                }
+                return out;
+            }
+            catch {
+                return [];
+            }
+        },
+        async writeItems(items) {
+            const cb = getWritableWebClipboard();
+            if (cb === null)
+                return false;
+            try {
+                const entry = {};
+                for (const item of items) {
+                    entry[item.format] = await blobFromFormatData(item.format, item.data);
+                }
+                await cb.write([new ClipboardItem(entry)]);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        async readItems(formats) {
+            const cb = getWebClipboard();
+            if (cb === null || typeof cb.read !== 'function')
+                return {};
+            try {
+                const clipItems = await cb.read();
+                const result = {};
+                for (const clipItem of clipItems) {
+                    for (const format of formats) {
+                        if (clipItem.types.includes(format) && !(format in result)) {
+                            const blob = await clipItem.getType(format);
+                            result[format] = format.startsWith('image/') ? await readBlobAsDataUrl(blob) : await blob.text();
+                        }
+                    }
+                }
+                return result;
+            }
+            catch {
+                return {};
+            }
+        },
+        async readText() {
+            const cb = getWebClipboard();
+            if (cb === null || typeof cb.readText !== 'function')
+                return '';
+            try {
+                return await cb.readText();
+            }
+            catch {
+                return '';
+            }
+        },
+        async writeText(text) {
+            const cb = getWebClipboard();
+            if (cb === null || typeof cb.writeText !== 'function')
+                return false;
+            try {
+                await cb.writeText(text);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        async readHtml() {
+            return this.readFormat(ClipboardFormatHtml);
+        },
+        async writeHtml(html) {
+            return this.writeFormat(ClipboardFormatHtml, html);
+        },
+        async hasText() {
+            return (await this.readText()).length > 0;
+        },
+        async readImage() {
+            const cb = getWebClipboard();
+            if (cb === null || typeof cb.read !== 'function')
+                return '';
+            try {
+                const items = await cb.read();
+                for (const item of items) {
+                    const type = item.types.find((t) => t.startsWith('image/'));
+                    if (type !== undefined) {
+                        const blob = await item.getType(type);
+                        return readBlobAsDataUrl(blob);
+                    }
+                }
+            }
+            catch {
+                return '';
+            }
+            return '';
+        },
+        async writeImage(dataUrl) {
+            const cb = getWritableWebClipboard();
+            if (cb === null)
+                return false;
+            try {
+                const response = await fetch(dataUrl);
+                const blob = await response.blob();
+                await cb.write([new ClipboardItem({ [blob.type]: blob })]);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        async hasImage() {
+            return (await this.readImage()).length > 0;
+        },
+        async readRTF() {
+            return this.readFormat(ClipboardFormatRtf);
+        },
+        async writeRTF(rtf) {
+            return this.writeFormat(ClipboardFormatRtf, rtf);
+        },
+        // The web platform exposes no clipboard bookmark format; a native host is required to read one.
+        async readBookmark() {
+            return null;
+        },
+        // The web platform exposes no clipboard bookmark format; a native host is required to write one.
+        async writeBookmark() {
+            return false;
+        },
+        // The web platform exposes no file-path clipboard format; a native host is required.
+        async readFiles() {
+            return [];
+        },
+        // The web platform exposes no file-path clipboard format; a native host is required.
+        async writeFiles() {
+            return false;
+        },
+        async clear() {
+            return this.writeText('');
+        },
+        getChangeCount() {
+            return -1;
+        },
+        subscribeClipboardChange(listener) {
+            if (typeof window === 'undefined')
+                return () => { };
+            // Use the experimental 'clipboardchange' event where present; fall back to no-op.
+            const target = window;
+            if ('onclipboardchange' in target ||
+                typeof window['clipboardchange'] !== 'undefined') {
+                const handler = () => listener();
+                window.addEventListener('clipboardchange', handler);
+                return () => window.removeEventListener('clipboardchange', handler);
+            }
+            return () => { };
+        },
+    };
+}
+// Stops delivery to `watch` and forgets its subscription. Safe to call when not attached.
+export function detachClipboardWatch(watch) {
+    const unsubscribe = _watchSubscriptions.get(watch);
+    if (unsubscribe !== undefined) {
+        unsubscribe();
+        _watchSubscriptions.delete(watch);
+    }
+}
+// Detaches `watch`'s backend subscription and releases it for garbage collection.
+// The signal remains plain GC-managed memory afterward.
+export function disposeClipboardWatch(watch) {
+    detachClipboardWatch(watch);
+}
+// The active clipboard backend, or a lazily-created web default. There is always a backend.
+export function getClipboardBackend() {
+    if (_backend === null)
+        _backend = createWebClipboardBackend();
+    return _backend;
+}
+// Returns a monotonically increasing count from the active backend, or -1 if unsupported.
+export function getClipboardChangeCount() {
+    return getClipboardBackend().getChangeCount();
+}
+// Returns the list of MIME/format strings currently on the clipboard. [] sentinel on access denied.
+export function getClipboardFormats() {
+    return getClipboardBackend().getFormats();
+}
+// True when the clipboard currently holds a bookmark. Returns false when access is denied.
+export function hasClipboardBookmark() {
+    return getClipboardBackend().hasFormat(ClipboardFormatBookmark);
+}
+// True when the given MIME/format string is currently present on the clipboard.
+export function hasClipboardFormat(format) {
+    return getClipboardBackend().hasFormat(format);
+}
+// True when the clipboard currently holds HTML content. Returns false when access is denied.
+export function hasClipboardHtml() {
+    return getClipboardBackend().hasFormat(ClipboardFormatHtml);
+}
+// True when the clipboard currently holds an image. Returns false when access is denied.
+export function hasClipboardImage() {
+    return getClipboardBackend().hasImage();
+}
+// True when the clipboard currently holds RTF content. Returns false when access is denied.
+export function hasClipboardRTF() {
+    return getClipboardBackend().hasFormat(ClipboardFormatRtf);
+}
+// True when the clipboard currently holds non-empty text. Returns false when access is denied.
+export function hasClipboardText() {
+    return getClipboardBackend().hasText();
+}
+// Reads multiple formats in one round-trip; missing formats are omitted from the result.
+export function readClipboard(formats) {
+    return getClipboardBackend().readItems(formats);
+}
+// Reads a bookmark (title + URL) from the clipboard, or null when none is present or access is denied.
+export function readClipboardBookmark() {
+    return getClipboardBackend().readBookmark();
+}
+// Reads the file paths currently on the clipboard. Returns [] when none are present or on web.
+export function readClipboardFiles() {
+    return getClipboardBackend().readFiles();
+}
+// Reads an arbitrary MIME/format flavor as a string; returns '' when absent or access is denied.
+export function readClipboardFormat(format) {
+    return getClipboardBackend().readFormat(format);
+}
+// Reads HTML from the clipboard, or '' when none is present or access is denied.
+export function readClipboardHtml() {
+    return getClipboardBackend().readHtml();
+}
+// Reads an image from the clipboard as a data URL, or '' when none is present or access is denied.
+export function readClipboardImage() {
+    return getClipboardBackend().readImage();
+}
+// Reads RTF (Rich Text Format) markup from the clipboard, or '' when none is present or access is denied.
+export function readClipboardRTF() {
+    return getClipboardBackend().readRTF();
+}
+// Reads plain text from the clipboard, or '' when empty or access is denied.
+export function readClipboardText() {
+    return getClipboardBackend().readText();
+}
+// Installs a native host clipboard backend; pass null to fall back to the web default.
+export function setClipboardBackend(backend) {
+    _backend = backend;
+}
+// Writes multiple formats atomically so a paste target picks its best representation.
+export function writeClipboard(items) {
+    return getClipboardBackend().writeItems(items);
+}
+// Writes a bookmark (title + URL) to the clipboard. Returns false when the host denies access.
+export function writeClipboardBookmark(title, url) {
+    return getClipboardBackend().writeBookmark(title, url);
+}
+// Writes file paths to the clipboard. Returns false when the host denies access or on web.
+export function writeClipboardFiles(paths) {
+    return getClipboardBackend().writeFiles(paths);
+}
+// Writes an arbitrary MIME/format flavor. Returns false when the host denies access.
+export function writeClipboardFormat(format, data) {
+    return getClipboardBackend().writeFormat(format, data);
+}
+// Writes HTML to the clipboard. Returns false when the host denies access.
+export function writeClipboardHtml(html) {
+    return getClipboardBackend().writeHtml(html);
+}
+// Writes an image (given as a data URL) to the clipboard. Returns false when the host denies access.
+export function writeClipboardImage(dataUrl) {
+    return getClipboardBackend().writeImage(dataUrl);
+}
+// Writes RTF (Rich Text Format) markup to the clipboard. Returns false when the host denies access.
+export function writeClipboardRTF(rtf) {
+    return getClipboardBackend().writeRTF(rtf);
+}
+// Writes plain text to the clipboard. Returns false when the host denies access.
+export function writeClipboardText(text) {
+    return getClipboardBackend().writeText(text);
+}
+let _backend = null;
+const _watchSubscriptions = new WeakMap();
+// Converts a format/data pair into a Blob. Image data URLs are fetched into their decoded bytes;
+// every other flavor wraps the string payload directly under its MIME type.
+async function blobFromFormatData(format, data) {
+    if (format.startsWith('image/') && data.startsWith('data:')) {
+        const response = await fetch(data);
+        return response.blob();
+    }
+    return new Blob([data], { type: format });
+}
+function getWebClipboard() {
+    if (typeof navigator === 'undefined')
+        return null;
+    return navigator.clipboard ?? null;
+}
+// The web clipboard when ClipboardItem writes are possible, or null. Centralizes the shared
+// write-path guard so every write/writeItems/writeImage caller folds to one null check.
+function getWritableWebClipboard() {
+    const cb = getWebClipboard();
+    if (cb === null || typeof cb.write !== 'function' || typeof ClipboardItem === 'undefined')
+        return null;
+    return cb;
+}
+// Reads a Blob into a data URL via FileReader, resolving '' when reading fails.
+function readBlobAsDataUrl(blob) {
+    return new Promise((resolve) => {
+        if (typeof FileReader === 'undefined') {
+            resolve('');
+            return;
+        }
+        try {
+            const reader = new FileReader();
+            reader.onloadend = () => resolve(typeof reader.result === 'string' ? reader.result : '');
+            reader.onerror = () => resolve('');
+            reader.readAsDataURL(blob);
+        }
+        catch {
+            resolve('');
+        }
+    });
+}
+//# sourceMappingURL=clipboard.js.map

package/dist/clipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.js","sourceRoot":"","sources":["../src/clipboard.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './clipboard';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './clipboard';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@flighthq/clipboard",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/signals": "0.1.0",
+    "@flighthq/types": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "System clipboard read/write (text, HTML, image, RTF, bookmark, files, generic MIME formats) with atomic multi-flavor write and change events, over a swappable web/native backend",
+  "sideEffects": false
+}

package/src/clipboard.test.ts

@@ -0,0 +1,613 @@
+import type { ClipboardBackend, ClipboardBookmark } from '@flighthq/types';
+
+import {
+  attachClipboardWatch,
+  clearClipboard,
+  createClipboardWatch,
+  createWebClipboardBackend,
+  detachClipboardWatch,
+  disposeClipboardWatch,
+  getClipboardBackend,
+  getClipboardChangeCount,
+  getClipboardFormats,
+  hasClipboardBookmark,
+  hasClipboardFormat,
+  hasClipboardHtml,
+  hasClipboardImage,
+  hasClipboardRTF,
+  hasClipboardText,
+  readClipboard,
+  readClipboardBookmark,
+  readClipboardFiles,
+  readClipboardFormat,
+  readClipboardHtml,
+  readClipboardImage,
+  readClipboardRTF,
+  readClipboardText,
+  setClipboardBackend,
+  writeClipboard,
+  writeClipboardBookmark,
+  writeClipboardFiles,
+  writeClipboardFormat,
+  writeClipboardHtml,
+  writeClipboardImage,
+  writeClipboardRTF,
+  writeClipboardText,
+} from './clipboard';
+
+function fakeBackend(): ClipboardBackend & {
+  text: string;
+  html: string;
+  image: string;
+  rtf: string;
+  bookmark: ClipboardBookmark | null;
+  files: string[];
+  formats: Record<string, string>;
+  changeCount: number;
+} {
+  return {
+    text: '',
+    html: '',
+    image: '',
+    rtf: '',
+    bookmark: null,
+    files: [],
+    formats: {},
+    changeCount: 0,
+    async readFormat(format) {
+      if (format === 'text/plain') return this.text;
+      if (format === 'text/html') return this.html;
+      if (format === 'text/rtf') return this.rtf;
+      return this.formats[format] ?? '';
+    },
+    async writeFormat(format, data) {
+      if (format === 'text/plain') this.text = data;
+      else if (format === 'text/html') this.html = data;
+      else if (format === 'text/rtf') this.rtf = data;
+      else this.formats[format] = data;
+      this.changeCount++;
+      return true;
+    },
+    async hasFormat(format) {
+      const data = await this.readFormat(format);
+      return data.length > 0;
+    },
+    async getFormats() {
+      const out: string[] = [];
+      if (this.text.length > 0) out.push('text/plain');
+      if (this.html.length > 0) out.push('text/html');
+      if (this.rtf.length > 0) out.push('text/rtf');
+      if (this.image.length > 0) out.push('image/png');
+      if (this.bookmark !== null) out.push('text/x-moz-url');
+      for (const k of Object.keys(this.formats)) out.push(k);
+      return out;
+    },
+    async writeItems(items) {
+      for (const item of items) await this.writeFormat(item.format, item.data);
+      return true;
+    },
+    async readItems(formats) {
+      const result: Record<string, string> = {};
+      for (const format of formats) {
+        const data = await this.readFormat(format);
+        if (data.length > 0) result[format] = data;
+      }
+      return result;
+    },
+    async readText() {
+      return this.text;
+    },
+    async writeText(text) {
+      this.text = text;
+      this.changeCount++;
+      return true;
+    },
+    async readHtml() {
+      return this.html;
+    },
+    async writeHtml(html) {
+      this.html = html;
+      this.changeCount++;
+      return true;
+    },
+    async hasText() {
+      return this.text.length > 0;
+    },
+    async readImage() {
+      return this.image;
+    },
+    async writeImage(dataUrl) {
+      this.image = dataUrl;
+      this.changeCount++;
+      return true;
+    },
+    async hasImage() {
+      return this.image.length > 0;
+    },
+    async readRTF() {
+      return this.rtf;
+    },
+    async writeRTF(rtf) {
+      this.rtf = rtf;
+      this.changeCount++;
+      return true;
+    },
+    async readBookmark() {
+      return this.bookmark;
+    },
+    async writeBookmark(title, url) {
+      this.bookmark = { title, url };
+      this.changeCount++;
+      return true;
+    },
+    async readFiles() {
+      return [...this.files];
+    },
+    async writeFiles(paths) {
+      this.files = [...paths];
+      this.changeCount++;
+      return true;
+    },
+    async clear() {
+      this.text = '';
+      this.html = '';
+      this.image = '';
+      this.rtf = '';
+      this.bookmark = null;
+      this.files = [];
+      this.formats = {};
+      this.changeCount++;
+      return true;
+    },
+    getChangeCount() {
+      return this.changeCount;
+    },
+    subscribeClipboardChange(listener) {
+      const listeners = (this as unknown as { _listeners: Array<() => void> })._listeners;
+      if (!listeners) (this as unknown as { _listeners: Array<() => void> })._listeners = [];
+      (this as unknown as { _listeners: Array<() => void> })._listeners.push(listener);
+      return () => {
+        const idx = (this as unknown as { _listeners: Array<() => void> })._listeners.indexOf(listener);
+        if (idx >= 0) (this as unknown as { _listeners: Array<() => void> })._listeners.splice(idx, 1);
+      };
+    },
+  };
+}
+
+afterEach(() => setClipboardBackend(null));
+
+describe('attachClipboardWatch', () => {
+  it('emits onChange when the backend notifies', () => {
+    const backend = fakeBackend();
+    setClipboardBackend(backend);
+    const watch = createClipboardWatch();
+    let count = 0;
+    watch.onChange.emit = () => {
+      count++;
+    };
+    attachClipboardWatch(watch);
+    // Simulate backend notification by calling all subscribed listeners
+    const listeners = (backend as unknown as { _listeners: Array<() => void> })._listeners;
+    expect(listeners.length).toBeGreaterThan(0);
+    listeners.forEach((l) => l());
+    expect(count).toBeGreaterThan(0);
+    disposeClipboardWatch(watch);
+  });
+
+  it('is idempotent — attaching twice only has one active subscription', () => {
+    const backend = fakeBackend();
+    setClipboardBackend(backend);
+    const watch = createClipboardWatch();
+    attachClipboardWatch(watch);
+    attachClipboardWatch(watch);
+    const listeners = (backend as unknown as { _listeners: Array<() => void> })._listeners ?? [];
+    expect(listeners.length).toBe(1);
+    disposeClipboardWatch(watch);
+  });
+});
+
+describe('clearClipboard', () => {
+  it('clears via the active backend', async () => {
+    const backend = fakeBackend();
+    backend.text = 'x';
+    setClipboardBackend(backend);
+    expect(await clearClipboard()).toBe(true);
+    expect(backend.text).toBe('');
+  });
+});
+
+describe('createClipboardWatch', () => {
+  it('returns an entity with an onChange signal', () => {
+    const watch = createClipboardWatch();
+    expect(watch.onChange).toBeDefined();
+  });
+});
+
+describe('createWebClipboardBackend', () => {
+  it('returns a backend whose reads yield strings without throwing', async () => {
+    const backend = createWebClipboardBackend();
+    expect(typeof (await backend.readText())).toBe('string');
+    expect(typeof (await backend.readHtml())).toBe('string');
+    expect(typeof (await backend.readFormat('text/plain'))).toBe('string');
+  });
+
+  it('getFormats returns an array without throwing', async () => {
+    const backend = createWebClipboardBackend();
+    const formats = await backend.getFormats();
+    expect(Array.isArray(formats)).toBe(true);
+  });
+
+  it('getChangeCount returns -1 (unsupported on web)', () => {
+    const backend = createWebClipboardBackend();
+    expect(backend.getChangeCount()).toBe(-1);
+  });
+
+  it('subscribeClipboardChange returns a function without throwing', () => {
+    const backend = createWebClipboardBackend();
+    const unsub = backend.subscribeClipboardChange(() => {});
+    expect(typeof unsub).toBe('function');
+    unsub();
+  });
+});
+
+describe('detachClipboardWatch', () => {
+  it('stops delivery after detach', () => {
+    const backend = fakeBackend();
+    setClipboardBackend(backend);
+    const watch = createClipboardWatch();
+    let count = 0;
+    watch.onChange.emit = () => {
+      count++;
+    };
+    attachClipboardWatch(watch);
+    detachClipboardWatch(watch);
+    const listeners = (backend as unknown as { _listeners: Array<() => void> })._listeners ?? [];
+    expect(listeners.length).toBe(0);
+    expect(count).toBe(0);
+  });
+
+  it('is safe to call when not attached', () => {
+    const watch = createClipboardWatch();
+    expect(() => detachClipboardWatch(watch)).not.toThrow();
+  });
+});
+
+describe('disposeClipboardWatch', () => {
+  it('detaches and does not throw', () => {
+    const backend = fakeBackend();
+    setClipboardBackend(backend);
+    const watch = createClipboardWatch();
+    attachClipboardWatch(watch);
+    expect(() => disposeClipboardWatch(watch)).not.toThrow();
+    const listeners = (backend as unknown as { _listeners: Array<() => void> })._listeners ?? [];
+    expect(listeners.length).toBe(0);
+  });
+});
+
+describe('getClipboardBackend', () => {
+  it('falls back to a web backend', () => {
+    expect(getClipboardBackend()).not.toBeNull();
+  });
+
+  it('returns the registered backend', () => {
+    const backend = fakeBackend();
+    setClipboardBackend(backend);
+    expect(getClipboardBackend()).toBe(backend);
+  });
+});
+
+describe('getClipboardChangeCount', () => {
+  it('reflects the backend change count', async () => {
+    const backend = fakeBackend();
+    setClipboardBackend(backend);
+    const before = getClipboardChangeCount();
+    await writeClipboardText('x');
+    expect(getClipboardChangeCount()).toBe(before + 1);
+  });
+
+  it('returns -1 from the web backend', () => {
+    expect(createWebClipboardBackend().getChangeCount()).toBe(-1);
+  });
+});
+
+describe('getClipboardFormats', () => {
+  it('returns the active formats from the backend', async () => {
+    const backend = fakeBackend();
+    setClipboardBackend(backend);
+    expect(await getClipboardFormats()).toEqual([]);
+    await writeClipboardText('hi');
+    const formats = await getClipboardFormats();
+    expect(formats).toContain('text/plain');
+  });
+
+  it('returns [] from the web backend without throwing', async () => {
+    const formats = await createWebClipboardBackend().getFormats();
+    expect(Array.isArray(formats)).toBe(true);
+  });
+});
+
+describe('hasClipboardBookmark', () => {
+  it('returns false when no bookmark is present', async () => {
+    const backend = fakeBackend();
+    setClipboardBackend(backend);
+    expect(await hasClipboardBookmark()).toBe(false);
+  });
+
+  it('returns true after a bookmark is written by the backend', async () => {
+    const backend = fakeBackend();
+    // Simulate a backend that puts 'text/x-moz-url' in formats when a bookmark is written
+    backend.formats['text/x-moz-url'] = 'https://example.com\nFlight';
+    setClipboardBackend(backend);
+    expect(await hasClipboardBookmark()).toBe(true);
+  });
+});
+
+describe('hasClipboardFormat', () => {
+  it('reflects whether a format is present', async () => {
+    const backend = fakeBackend();
+    setClipboardBackend(backend);
+    expect(await hasClipboardFormat('text/plain')).toBe(false);
+    await writeClipboardText('x');
+    expect(await hasClipboardFormat('text/plain')).toBe(true);
+  });
+});
+
+describe('hasClipboardHtml', () => {
+  it('reflects backend state', async () => {
+    const backend = fakeBackend();
+    setClipboardBackend(backend);
+    expect(await hasClipboardHtml()).toBe(false);
+    await writeClipboardHtml('<b>x</b>');
+    expect(await hasClipboardHtml()).toBe(true);
+  });
+});
+
+describe('hasClipboardImage', () => {
+  it('reflects backend state', async () => {
+    const backend = fakeBackend();
+    setClipboardBackend(backend);
+    expect(await hasClipboardImage()).toBe(false);
+    await writeClipboardImage('data:image/png;base64,AAAA');
+    expect(await hasClipboardImage()).toBe(true);
+  });
+
+  it('returns false from the web backend without throwing', async () => {
+    expect(await createWebClipboardBackend().hasImage()).toBe(false);
+  });
+});
+
+describe('hasClipboardRTF', () => {
+  it('reflects backend state', async () => {
+    const backend = fakeBackend();
+    setClipboardBackend(backend);
+    expect(await hasClipboardRTF()).toBe(false);
+    await writeClipboardRTF('{\\rtf1 hi}');
+    expect(await hasClipboardRTF()).toBe(true);
+  });
+});
+
+describe('hasClipboardText', () => {
+  it('reflects backend state', async () => {
+    const backend = fakeBackend();
+    setClipboardBackend(backend);
+    expect(await hasClipboardText()).toBe(false);
+    await writeClipboardText('hi');
+    expect(await hasClipboardText()).toBe(true);
+  });
+});
+
+describe('readClipboard', () => {
+  it('reads multiple formats in one call', async () => {
+    const backend = fakeBackend();
+    setClipboardBackend(backend);
+    await writeClipboardText('hello');
+    await writeClipboardHtml('<b>hello</b>');
+    const result = await readClipboard(['text/plain', 'text/html']);
+    expect(result['text/plain']).toBe('hello');
+    expect(result['text/html']).toBe('<b>hello</b>');
+  });
+
+  it('omits formats that are not present', async () => {
+    const backend = fakeBackend();
+    setClipboardBackend(backend);
+    await writeClipboardText('hi');
+    const result = await readClipboard(['text/plain', 'text/rtf']);
+    expect(result['text/plain']).toBe('hi');
+    expect(result['text/rtf']).toBeUndefined();
+  });
+
+  it('returns {} from the web backend without throwing', async () => {
+    const result = await createWebClipboardBackend().readItems(['text/plain']);
+    expect(typeof result).toBe('object');
+  });
+});
+
+describe('readClipboardBookmark', () => {
+  it('round-trips through the backend', async () => {
+    setClipboardBackend(fakeBackend());
+    await writeClipboardBookmark('Flight', 'https://example.com');
+    expect(await readClipboardBookmark()).toEqual({ title: 'Flight', url: 'https://example.com' });
+  });
+
+  it('returns the null sentinel from the web backend without throwing', async () => {
+    expect(await createWebClipboardBackend().readBookmark()).toBeNull();
+  });
+});
+
+describe('readClipboardFiles', () => {
+  it('round-trips file paths through the backend', async () => {
+    const backend = fakeBackend();
+    setClipboardBackend(backend);
+    await writeClipboardFiles(['/a/b.txt', '/c/d.txt']);
+    expect(await readClipboardFiles()).toEqual(['/a/b.txt', '/c/d.txt']);
+  });
+
+  it('returns [] from the web backend without throwing', async () => {
+    const files = await createWebClipboardBackend().readFiles();
+    expect(Array.isArray(files)).toBe(true);
+    expect(files.length).toBe(0);
+  });
+});
+
+describe('readClipboardFormat', () => {
+  it('round-trips an arbitrary format through the backend', async () => {
+    const backend = fakeBackend();
+    setClipboardBackend(backend);
+    await writeClipboardFormat('application/x-custom', 'mydata');
+    expect(await readClipboardFormat('application/x-custom')).toBe('mydata');
+  });
+
+  it('returns the empty-string sentinel from the web backend without throwing', async () => {
+    expect(await createWebClipboardBackend().readFormat('application/x-custom')).toBe('');
+  });
+});
+
+describe('readClipboardHtml', () => {
+  it('round-trips through the backend', async () => {
+    setClipboardBackend(fakeBackend());
+    await writeClipboardHtml('<b>x</b>');
+    expect(await readClipboardHtml()).toBe('<b>x</b>');
+  });
+});
+
+describe('readClipboardImage', () => {
+  it('round-trips through the backend', async () => {
+    setClipboardBackend(fakeBackend());
+    await writeClipboardImage('data:image/png;base64,BBBB');
+    expect(await readClipboardImage()).toBe('data:image/png;base64,BBBB');
+  });
+
+  it('returns the empty-string sentinel from the web backend without throwing', async () => {
+    expect(await createWebClipboardBackend().readImage()).toBe('');
+  });
+});
+
+describe('readClipboardRTF', () => {
+  it('round-trips through the backend', async () => {
+    setClipboardBackend(fakeBackend());
+    await writeClipboardRTF('{\\rtf1 hi}');
+    expect(await readClipboardRTF()).toBe('{\\rtf1 hi}');
+  });
+
+  it('returns the empty-string sentinel from the web backend without throwing', async () => {
+    expect(await createWebClipboardBackend().readRTF()).toBe('');
+  });
+});
+
+describe('readClipboardText', () => {
+  it('round-trips through the backend', async () => {
+    setClipboardBackend(fakeBackend());
+    await writeClipboardText('hello');
+    expect(await readClipboardText()).toBe('hello');
+  });
+});
+
+describe('setClipboardBackend', () => {
+  it('clears back to the web fallback when passed null', () => {
+    setClipboardBackend(fakeBackend());
+    setClipboardBackend(null);
+    expect(getClipboardBackend()).not.toBeNull();
+  });
+});
+
+describe('writeClipboard', () => {
+  it('writes multiple formats atomically', async () => {
+    const backend = fakeBackend();
+    setClipboardBackend(backend);
+    expect(
+      await writeClipboard([
+        { format: 'text/plain', data: 'hello' },
+        { format: 'text/html', data: '<b>hello</b>' },
+      ]),
+    ).toBe(true);
+    expect(backend.text).toBe('hello');
+    expect(backend.html).toBe('<b>hello</b>');
+  });
+
+  it('returns false from the web backend without throwing', async () => {
+    expect(await createWebClipboardBackend().writeItems([{ format: 'text/plain', data: 'x' }])).toBe(false);
+  });
+});
+
+describe('writeClipboardBookmark', () => {
+  it('writes via the active backend', async () => {
+    const backend = fakeBackend();
+    setClipboardBackend(backend);
+    expect(await writeClipboardBookmark('Flight', 'https://example.com')).toBe(true);
+    expect(backend.bookmark).toEqual({ title: 'Flight', url: 'https://example.com' });
+  });
+
+  it('returns false from the web backend without throwing', async () => {
+    expect(await createWebClipboardBackend().writeBookmark('Flight', 'https://example.com')).toBe(false);
+  });
+});
+
+describe('writeClipboardFiles', () => {
+  it('writes file paths via the active backend', async () => {
+    const backend = fakeBackend();
+    setClipboardBackend(backend);
+    expect(await writeClipboardFiles(['/a/b.txt'])).toBe(true);
+    expect(backend.files).toEqual(['/a/b.txt']);
+  });
+
+  it('returns false from the web backend without throwing', async () => {
+    expect(await createWebClipboardBackend().writeFiles(['/a.txt'])).toBe(false);
+  });
+});
+
+describe('writeClipboardFormat', () => {
+  it('writes an arbitrary format via the active backend', async () => {
+    const backend = fakeBackend();
+    setClipboardBackend(backend);
+    expect(await writeClipboardFormat('application/x-custom', 'data')).toBe(true);
+    expect(backend.formats['application/x-custom']).toBe('data');
+  });
+
+  it('returns false from the web backend without throwing', async () => {
+    expect(await createWebClipboardBackend().writeFormat('application/x-custom', 'data')).toBe(false);
+  });
+});
+
+describe('writeClipboardHtml', () => {
+  it('writes via the active backend', async () => {
+    const backend = fakeBackend();
+    setClipboardBackend(backend);
+    expect(await writeClipboardHtml('<i>y</i>')).toBe(true);
+    expect(backend.html).toBe('<i>y</i>');
+  });
+});
+
+describe('writeClipboardImage', () => {
+  it('writes via the active backend', async () => {
+    const backend = fakeBackend();
+    setClipboardBackend(backend);
+    expect(await writeClipboardImage('data:image/png;base64,CCCC')).toBe(true);
+    expect(backend.image).toBe('data:image/png;base64,CCCC');
+  });
+
+  it('returns false from the web backend without throwing', async () => {
+    expect(await createWebClipboardBackend().writeImage('data:image/png;base64,DDDD')).toBe(false);
+  });
+});
+
+describe('writeClipboardRTF', () => {
+  it('writes via the active backend', async () => {
+    const backend = fakeBackend();
+    setClipboardBackend(backend);
+    expect(await writeClipboardRTF('{\\rtf1 z}')).toBe(true);
+    expect(backend.rtf).toBe('{\\rtf1 z}');
+  });
+
+  it('returns false from the web backend without throwing', async () => {
+    expect(await createWebClipboardBackend().writeRTF('{\\rtf1 z}')).toBe(false);
+  });
+});
+
+describe('writeClipboardText', () => {
+  it('writes via the active backend', async () => {
+    const backend = fakeBackend();
+    setClipboardBackend(backend);
+    expect(await writeClipboardText('z')).toBe(true);
+    expect(backend.text).toBe('z');
+  });
+});