@talex-touch/utils 1.0.37 → 1.0.38

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@talex-touch/utils",
-  "version": "1.0.37",
+  "version": "1.0.38",
   "private": false,
   "description": "Tuff series utils",
   "author": "TalexDreamSoul",

package/plugin/sdk/clipboard.ts

@@ -1,4 +1,4 @@
-import type { PluginClipboardHistoryResponse, PluginClipboardItem } from './types'
+import type { PluginClipboardHistoryResponse, PluginClipboardItem, PluginClipboardSearchOptions, PluginClipboardSearchResponse } from './types'
 
 function ensurePluginChannel() {
   const channel = (window as any)?.$channel
@@ -23,9 +23,7 @@ function normalizeItem(item: PluginClipboardItem | null): PluginClipboardItem |
   return item
 }
 
-export interface ClipboardHistoryOptions {
-  page?: number
-}
+export type ClipboardHistoryOptions = Omit<PluginClipboardSearchOptions, 'keyword' | 'startTime' | 'endTime' | 'type' | 'isFavorite' | 'sourceApp' | 'sortOrder'> & { page?: number }
 
 export interface ClipboardFavoriteOptions {
   id: number
@@ -46,6 +44,10 @@ export interface ClipboardApplyOptions {
   type?: PluginClipboardItem['type']
 }
 
+export type ClipboardSearchOptions = PluginClipboardSearchOptions
+export type ClipboardSearchResponse = PluginClipboardSearchResponse
+
+
 export function useClipboardHistory() {
   const channel = ensurePluginChannel()
 
@@ -79,6 +81,44 @@ export function useClipboardHistory() {
       await channel.send('clipboard:clear-history')
     },
 
+    /**
+     * Search clipboard history with advanced filtering options.
+     * Supports keyword search, time-based filtering, and combined filters.
+     *
+     * @param options - Search options
+     * @returns Search results with pagination metadata
+     *
+     * @example
+     * ```typescript
+     * // Search by keyword
+     * const result = await searchHistory({ keyword: 'hello' })
+     *
+     * // Search by time range (last 24 hours)
+     * const oneDayAgo = Date.now() - 24 * 60 * 60 * 1000
+     * const recent = await searchHistory({ startTime: oneDayAgo })
+     *
+     * // Combined search: text type, favorite items from a specific app
+     * const filtered = await searchHistory({
+     *   type: 'text',
+     *   isFavorite: true,
+     *   sourceApp: 'com.apple.Safari'
+     * })
+     * ```
+     */
+    async searchHistory(options: ClipboardSearchOptions = {}): Promise<ClipboardSearchResponse> {
+      // Use the extended clipboard:get-history interface with search parameters
+      const response = await channel.send('clipboard:get-history', options)
+      const items = Array.isArray(response?.history)
+        ? response.history.map((item: PluginClipboardItem) => normalizeItem(item) ?? item)
+        : []
+      return {
+        items,
+        total: response?.total ?? 0,
+        page: response?.page ?? 1,
+        pageSize: response?.pageSize ?? 20,
+      }
+    },
+
     onDidChange(callback: (item: PluginClipboardItem) => void): () => void {
       return channel.regChannel('core-box:clipboard-change', ({ data }) => {
         const item = (data && 'item' in data ? data.item : data) as PluginClipboardItem

package/plugin/sdk/types.ts

@@ -110,6 +110,41 @@ export interface PluginClipboardHistoryResponse {
   pageSize: number
 }
 
+/**
+ * Clipboard search options for filtering and sorting clipboard history.
+ */
+export interface PluginClipboardSearchOptions {
+  /** Keyword for fuzzy search in content */
+  keyword?: string
+  /** Start time for filtering (Unix timestamp in milliseconds) */
+  startTime?: number
+  /** End time for filtering (Unix timestamp in milliseconds) */
+  endTime?: number
+  /** Filter by clipboard item type */
+  type?: 'text' | 'image' | 'files'
+  /** Filter by favorite status */
+  isFavorite?: boolean
+  /** Filter by source application */
+  sourceApp?: string
+  /** Page number for pagination (default: 1) */
+  page?: number
+  /** Number of items per page (default: 20, max: 100) */
+  pageSize?: number
+  /** Sort order by timestamp (default: 'desc') */
+  sortOrder?: 'asc' | 'desc'
+}
+
+/**
+ * Clipboard search response structure.
+ */
+export interface PluginClipboardSearchResponse {
+  items: PluginClipboardItem[]
+  total: number
+  page: number
+  pageSize: number
+}
+
+
 export interface ActiveAppSnapshot {
   identifier: string | null
   displayName: string | null