Clipboard History

export interface ClipboardItem {
  id: string;                    // Unique identifier
  type: 'text' | 'image' | 'url' | 'file';
  content: string;               // Text/URL/path or image file path
  preview?: string;              // Truncated preview (200 chars)
  timestamp: number;             // When copied
  metadata?: {                   // Type-specific metadata
    width?: number;              // Image dimensions
    height?: number;
    size?: number;               // File size (bytes)
    format?: string;             // Image format (png/jpg/gif)
    filename?: string;           // File name
  };
}

function detectType(text: string): 'url' | 'file' | 'text' {
  // URL: Starts with http:// or https://
  // File: macOS path (/ or ~) that exists on disk
  // Text: Everything else
}

// Theme-aware styling (ClipboardManager.tsx:41)
const isGlassyTheme = document.documentElement.classList.contains('sc-glassy');
const isNativeLiquidGlass = document.documentElement.classList.contains('sc-native-liquid-glass');

function writeGifToClipboard(filePath: string): boolean {
  // Uses macOS NSPasteboard to preserve animation
  // Writes both:
  // - com.compuserve.gif (animated)
  // - public.tiff (static fallback)
}

export function searchClipboardHistory(query: string): ClipboardItem[] {
  const lowerQuery = query.toLowerCase();
  return clipboardHistory.filter((item) => {
    // Only text-like items are searchable
    if (item.type === 'text' || item.type === 'url' || item.type === 'file') {
      return item.content.toLowerCase().includes(lowerQuery);
    }
    return false;
  });
}

function saveHistory(): void {
  const historyPath = getHistoryFilePath();
  // ~/Library/Application Support/SuperCmd/clipboard-history/history.json
  fs.writeFileSync(historyPath, JSON.stringify(clipboardHistory, null, 2));
}

function loadHistory(): void {
  // Loads from history.json
  // Verifies image files still exist
  // Filters internal probe artifacts
  // Deduplicates text entries
}

function findComparableTextItemIndex(type, normalizedContent): number {
  // Finds existing item with same normalized content
  // Normalization: trim + convert \r\n to \n
  // If found: Move to top, update timestamp
  // If not found: Add as new item
}

const INTERNAL_CLIPBOARD_PROBE_REGEX = /^__supercmd_[a-z0-9_]+_probe__\d+_[a-z0-9]+$/i;

// These never appear in history
if (INTERNAL_CLIPBOARD_PROBE_REGEX.test(text)) return;

export function setClipboardMonitorEnabled(enabled: boolean): void {
  // Stops polling clipboard
  // Existing history remains
}

const MAX_ITEMS = 1000;

if (clipboardHistory.length > MAX_ITEMS) {
  const removed = clipboardHistory.pop();
  // Delete old image files to free space
}

const MAX_TEXT_LENGTH = 100_000; // 100KB
if (text.length > MAX_TEXT_LENGTH) return;

import { Clipboard } from '@raycast/api';

// Read current clipboard
const current = await Clipboard.readText();

// Copy to clipboard
await Clipboard.copy("Hello, world!");

// Copy with metadata
await Clipboard.copy({
  text: "Hello",
  html: "<b>Hello</b>"
});

const POLL_INTERVAL = 1000; // 1 second

function pollClipboard(): void {
  // Quick hash comparison to detect changes
  // Only process if clipboard actually changed
  // Minimal CPU usage (~0.1%)
}