@talex-touch/utils 1.0.36 → 1.0.38

package/package.json

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

package/plugin/sdk/box-sdk.ts

@@ -4,6 +4,7 @@
  * Provides a unified API for plugins to control the CoreBox window behavior,
  * including visibility, size, input field control, and input value access.
  */
+import type { ITouchClientChannel } from '@talex-touch/utils/channel'
 import { ensureRendererChannel } from './channel'
 
 /**
@@ -193,32 +194,23 @@ export interface BoxSDK {
  *
  * @internal
  */
-export function createBoxSDK(channel: any): BoxSDK {
-  const send: (eventName: string, payload?: any) => Promise<any> =
-    typeof channel?.sendToMain === 'function'
-      ? channel.sendToMain.bind(channel)
-      : typeof channel?.send === 'function'
-        ? channel.send.bind(channel)
-        : (() => {
-            throw new Error('[Box SDK] Channel send function not available')
-          })()
-
+export function createBoxSDK(channel: ITouchClientChannel): BoxSDK {
   return {
     hide(): void {
-      send('core-box:hide').catch((error: any) => {
+      channel.send('core-box:hide').catch((error: any) => {
         console.error('[Box SDK] Failed to hide CoreBox:', error)
       })
     },
 
     show(): void {
-      send('core-box:show').catch((error: any) => {
+      channel.send('core-box:show').catch((error: any) => {
         console.error('[Box SDK] Failed to show CoreBox:', error)
       })
     },
 
     async expand(options?: BoxExpandOptions): Promise<void> {
       try {
-        await send('core-box:expand', options || {})
+        await channel.send('core-box:expand', options || {})
       }
       catch (error) {
         console.error('[Box SDK] Failed to expand CoreBox:', error)
@@ -228,7 +220,7 @@ export function createBoxSDK(channel: any): BoxSDK {
 
     async shrink(): Promise<void> {
       try {
-        await send('core-box:expand', { mode: 'collapse' })
+        await channel.send('core-box:expand', { mode: 'collapse' })
       }
       catch (error) {
         console.error('[Box SDK] Failed to shrink CoreBox:', error)
@@ -238,7 +230,7 @@ export function createBoxSDK(channel: any): BoxSDK {
 
     async hideInput(): Promise<void> {
       try {
-        await send('core-box:hide-input')
+        await channel.send('core-box:hide-input')
       }
       catch (error) {
         console.error('[Box SDK] Failed to hide input:', error)
@@ -248,7 +240,7 @@ export function createBoxSDK(channel: any): BoxSDK {
 
     async showInput(): Promise<void> {
       try {
-        await send('core-box:show-input')
+        await channel.send('core-box:show-input')
       }
       catch (error) {
         console.error('[Box SDK] Failed to show input:', error)
@@ -258,7 +250,7 @@ export function createBoxSDK(channel: any): BoxSDK {
 
     async getInput(): Promise<string> {
       try {
-        const result = await send('core-box:get-input')
+        const result = await channel.send('core-box:get-input')
         return result?.data?.input || result?.input || ''
       }
       catch (error) {
@@ -269,7 +261,7 @@ export function createBoxSDK(channel: any): BoxSDK {
 
     async setInput(value: string): Promise<void> {
       try {
-        await send('core-box:set-input', { value })
+        await channel.send('core-box:set-input', { value })
       }
       catch (error) {
         console.error('[Box SDK] Failed to set input:', error)
@@ -279,7 +271,7 @@ export function createBoxSDK(channel: any): BoxSDK {
 
     async clearInput(): Promise<void> {
       try {
-        await send('core-box:clear-input')
+        await channel.send('core-box:clear-input')
       }
       catch (error) {
         console.error('[Box SDK] Failed to clear input:', error)
@@ -289,7 +281,7 @@ export function createBoxSDK(channel: any): BoxSDK {
 
     async allowInput(): Promise<void> {
       try {
-        await send('core-box:allow-input')
+        await channel.send('core-box:allow-input')
       }
       catch (error) {
         console.error('[Box SDK] Failed to enable input monitoring:', error)
@@ -299,7 +291,7 @@ export function createBoxSDK(channel: any): BoxSDK {
 
     async allowClipboard(types: number): Promise<void> {
       try {
-        await send('core-box:allow-clipboard', types)
+        await channel.send('core-box:allow-clipboard', types)
       }
       catch (error) {
         console.error('[Box SDK] Failed to enable clipboard monitoring:', error)

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