@talex-touch/utils 1.0.30 → 1.0.31

package/animation/window-node.ts

@@ -0,0 +1,202 @@
+import { TalexTouch } from '../types'
+
+/**
+ * Window animation controller return type
+ */
+export interface WindowAnimationController {
+  /**
+   * Update window height with animation
+   * @param newHeight - The new height to animate to
+   * @param duration - Animation duration in seconds (default: 0.5)
+   * @returns Promise that resolves to true if animation completed successfully, false if interrupted
+   */
+  updateHeight: (newHeight: number, duration?: number) => Promise<boolean>
+
+  /**
+   * Cancel current animation
+   * @returns Promise that resolves to true if there was an animation to cancel, false otherwise
+   */
+  cancel: () => Promise<boolean>
+
+  /**
+   * Toggle window visibility
+   * @param visible - Optional parameter to explicitly set visibility state
+   * @returns Promise that resolves to true if operation completed successfully, false otherwise
+   */
+  toggleWindow: (visible?: boolean) => Promise<boolean>
+
+  /**
+   * Change current window instance
+   * @param newWindow - New TouchWindow instance
+   */
+  changeWindow: (newWindow: TalexTouch.ITouchWindow) => void
+}
+
+/**
+ * Tracks the state of an animation
+ */
+interface AnimationState {
+  intervalId: NodeJS.Timeout | null
+  completed: boolean
+}
+
+/**
+ * Simple easing function for smooth animation
+ */
+function easeInOutCubic(t: number): number {
+  return t < 0.5 ? 4 * t * t * t : 1 - Math.pow(-2 * t + 2, 3) / 2
+}
+
+/**
+ * Use native Node.js animation for window (main process only)
+ * @param window - TouchWindow instance (optional, can be set later with changeWindow)
+ * @returns WindowAnimationController with updateHeight, cancel, toggleWindow, and changeWindow methods
+ */
+export function useWindowAnimation(window?: TalexTouch.ITouchWindow): WindowAnimationController {
+  // Store current window reference inside the function scope
+  let currentWindow: TalexTouch.ITouchWindow | null = window || null
+
+  const animationState: AnimationState = {
+    intervalId: null,
+    completed: false
+  }
+
+  /**
+   * Check if current window is valid
+   * @returns true if window is valid, false otherwise
+   */
+  const isWindowValid = (): boolean => {
+    return (
+      currentWindow !== null &&
+      currentWindow.window !== null &&
+      !currentWindow.window.isDestroyed()
+    )
+  }
+
+  /**
+   * Get current window with validation
+   * @returns current window or throws error if invalid
+   */
+  const getCurrentWindow = (): TalexTouch.ITouchWindow => {
+    if (!isWindowValid()) {
+      throw new Error('Window is not valid or has been destroyed')
+    }
+    return currentWindow!
+  }
+
+  const updateHeight = async (newHeight: number, duration: number = 0.5): Promise<boolean> => {
+    try {
+      const window = getCurrentWindow()
+
+      // Cancel any existing animation
+      if (animationState.intervalId) {
+        clearInterval(animationState.intervalId)
+        animationState.intervalId = null
+      }
+
+      // Reset state for new animation
+      animationState.completed = false
+
+      const browserWindow = window.window
+      const [currentWidth, currentHeight] = browserWindow.getSize()
+      const [x, y] = browserWindow.getPosition()
+
+      const startHeight = currentHeight
+      const heightDelta = newHeight - startHeight
+      const startTime = Date.now()
+      const durationMs = duration * 1000
+
+      return new Promise<boolean>((resolve) => {
+        animationState.intervalId = setInterval(() => {
+          // Check if window is still valid
+          if (!isWindowValid()) {
+            if (animationState.intervalId) {
+              clearInterval(animationState.intervalId)
+              animationState.intervalId = null
+            }
+            resolve(false)
+            return
+          }
+
+          const elapsed = Date.now() - startTime
+          const progress = Math.min(elapsed / durationMs, 1)
+          const easedProgress = easeInOutCubic(progress)
+          const animatedHeight = Math.round(startHeight + heightDelta * easedProgress)
+
+          browserWindow.setSize(currentWidth, animatedHeight)
+          browserWindow.setPosition(x, y)
+
+          if (progress >= 1) {
+            if (animationState.intervalId) {
+              clearInterval(animationState.intervalId)
+              animationState.intervalId = null
+            }
+            animationState.completed = true
+            resolve(true)
+          }
+        }, 16) // ~60fps
+      })
+    } catch (error) {
+      console.error('Error in updateHeight:', error)
+      return Promise.resolve(false)
+    }
+  }
+
+  const cancel = async (): Promise<boolean> => {
+    if (animationState.intervalId) {
+      clearInterval(animationState.intervalId)
+      animationState.intervalId = null
+      return Promise.resolve(true)
+    }
+    return Promise.resolve(false)
+  }
+
+  const toggleWindow = async (visible?: boolean): Promise<boolean> => {
+    try {
+      const window = getCurrentWindow()
+      const browserWindow = window.window
+
+      // Determine target visibility state
+      const targetVisible = visible !== undefined ? visible : !browserWindow.isVisible()
+
+      if (targetVisible) {
+        // Show window
+        browserWindow.show()
+      } else {
+        // Hide window
+        if (process.platform === 'darwin') {
+          // On macOS, we can simply hide the window
+          browserWindow.hide()
+        } else {
+          // On other platforms, move window far off-screen before hiding
+          browserWindow.setPosition(-100000, -100000)
+          browserWindow.hide()
+        }
+      }
+
+      return Promise.resolve(true)
+    } catch (error) {
+      console.error('Error in toggleWindow:', error)
+      return Promise.resolve(false)
+    }
+  }
+
+  const changeWindow = (newWindow: TalexTouch.ITouchWindow): void => {
+    // Cancel any ongoing animation
+    if (animationState.intervalId) {
+      clearInterval(animationState.intervalId)
+      animationState.intervalId = null
+    }
+
+    // Set new window
+    currentWindow = newWindow
+  }
+
+  return {
+    updateHeight,
+    cancel,
+    toggleWindow,
+    changeWindow
+  }
+}
+

package/auth/useAuthState.ts

@@ -1,5 +1,5 @@
 import { createGlobalState } from '@vueuse/core'
-import { shallowReactive } from 'vue'
+import { shallowReactive, computed } from 'vue'
 import { ClerkAuthState, CurrentUser } from './clerk-types'
 
 export const useAuthState = createGlobalState(() => {

package/auth/useClerkConfig.ts

@@ -1,7 +1,7 @@
 import { ClerkConfig } from "./clerk-types"
 
-const clerkPublishableKey = import.meta.env.VITE_CLERK_PUBLISHABLE_KEY
-const clerkDomain = import.meta.env.VITE_CLERK_DOMAIN
+const clerkPublishableKey = (import.meta.env as any).VITE_CLERK_PUBLISHABLE_KEY
+const clerkDomain = (import.meta.env as any).VITE_CLERK_DOMAIN
 
 if (!clerkPublishableKey?.length) {
   throw new Error('VITE_CLERK_PUBLISHABLE_KEY is not set')

package/channel/index.ts

@@ -175,3 +175,9 @@ export interface StandardChannelData extends RawStandardChannelData {
 export type IChannelData = any //boolean | number | string | null | undefined | {
   // [prop: string]: any
 // }
+
+// Default export for Vite compatibility (only values, not types)
+export default {
+  ChannelType,
+  DataCode
+}

package/common/file-scan-utils.ts

@@ -7,7 +7,10 @@
  * @version 1.0.0
  */
 
-import path from 'path'
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const path = typeof window === 'undefined'
+  ? require('path')
+  : require('path-browserify')
 import {
   type FileScanOptions,
   DEFAULT_SCAN_OPTIONS,

package/common/storage/entity/app-settings.ts

@@ -39,6 +39,20 @@ const _appSettingOriginData = {
   searchEngine: {
     logsEnabled: false,
   },
+  window: {
+    closeToTray: true,
+    startMinimized: false,
+    startSilent: false,
+  },
+  setup: {
+    accessibility: false,
+    notifications: false,
+    autoStart: false,
+    showTray: true,
+    adminPrivileges: false,
+    hideDock: false,
+  },
+  layout: 'simple',
 };
 
 export const appSettingOriginData = Object.freeze(_appSettingOriginData)

package/common/utils/file.ts

@@ -1,4 +1,7 @@
-import path from 'path-browserify'
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const path = typeof window === 'undefined'
+  ? require('path')
+  : require('path-browserify')
 
 /**
  * Enum for various file types.

package/common/utils/polling.ts

@@ -19,6 +19,7 @@ export class PollingService {
   private tasks = new Map<string, PollingTask>();
   private timerId: NodeJS.Timeout | null = null;
   private isRunning = false;
+  private quitListenerCleanup?: () => void;
 
   private constructor() {
     // Private constructor to enforce singleton pattern
@@ -111,17 +112,53 @@ export class PollingService {
    */
   public start(): void {
     if (this.isRunning) {
+      console.warn('[PollingService] Already running, skipping start.');
       return;
     }
     this.isRunning = true;
-    console.debug('[PollingService] Service started.');
+    console.log('[PollingService] Polling service started');
+    this._setupQuitListener();
     this._reschedule();
   }
 
+  /**
+   * Sets up Electron app quit listener if running in Electron environment
+   * Uses lazy resolution to avoid hard dependency on Electron
+   */
+  private _setupQuitListener(): void {
+    // Check if we're in Electron environment
+    try {
+      // Use dynamic require to avoid hard dependency on Electron
+      // Similar to the approach used in packages/utils/plugin/channel.ts
+      const electron = (globalThis as any)?.electron ?? 
+                       (typeof require !== 'undefined' ? require('electron') : null);
+      
+      if (electron?.app) {
+        const app = electron.app;
+        
+        // Listen to before-quit event
+        const quitHandler = () => {
+          this.stop('app quit');
+        };
+        
+        app.on('before-quit', quitHandler);
+        
+        // Store cleanup function
+        this.quitListenerCleanup = () => {
+          app.removeListener('before-quit', quitHandler);
+        };
+      }
+    } catch (error) {
+      // Not in Electron environment or Electron not available
+      // This is fine, just skip the quit listener setup
+    }
+  }
+
   /**
    * Stops the polling service and clears all scheduled tasks.
+   * @param reason - Optional reason for stopping the service (for logging purposes)
    */
-  public stop(): void {
+  public stop(reason?: string): void {
     if (!this.isRunning) {
       return;
     }
@@ -130,7 +167,18 @@ export class PollingService {
       clearTimeout(this.timerId);
       this.timerId = null;
     }
-    console.log('[PollingService] Service stopped.');
+    
+    // Clean up quit listener
+    if (this.quitListenerCleanup) {
+      this.quitListenerCleanup();
+      this.quitListenerCleanup = undefined;
+    }
+    
+    if (reason) {
+      console.log(`[PollingService] Stopping polling service: ${reason}`);
+    } else {
+      console.log('[PollingService] Polling service stopped');
+    }
   }
 
   private _reschedule(): void {

package/core-box/builder/tuff-builder.ts

@@ -972,7 +972,7 @@ class TuffUtils {
    * @param type - 图标类型
    * @returns {TuffIcon} 创建的图标对象
    */
-  static createIcon(value: string, type: 'emoji' | 'url' | 'base64' | 'component' = 'emoji'): TuffIcon {
+  static createIcon(value: string, type: 'emoji' | 'url' | 'file' = 'emoji'): TuffIcon {
     return {
       type,
       value

package/core-box/tuff/tuff-dsl.ts

@@ -1041,18 +1041,88 @@ export interface TuffDisplayAction extends Omit<TuffAction, 'payload'> {
 
 // ==================== 工具类型 ====================
 
+/**
+ * 查询输入类型枚举
+ *
+ * @description
+ * 定义系统支持的所有输入类型。
+ * 用于插件、providers 和 features 声明其支持的输入类型。
+ */
+export enum TuffInputType {
+  /** 纯文本输入 */
+  Text = 'text',
+  /** 图像输入（data URL 格式） */
+  Image = 'image',
+  /** 文件输入（文件路径数组） */
+  Files = 'files',
+  /** 富文本输入（HTML 格式） */
+  Html = 'html'
+}
+
+/**
+ * 查询输入项
+ *
+ * @description
+ * 定义查询中除文本外的多种类型输入（如剪贴板数据）。
+ * 用于支持图像、文件、富文本等多媒体输入。
+ */
+export interface TuffQueryInput {
+  /**
+   * 输入类型
+   * @description 定义输入数据的类型
+   * @required
+   */
+  type: TuffInputType;
+
+  /**
+   * 输入内容
+   * @description 根据类型不同包含不同格式的数据：
+   * - text: 纯文本字符串
+   * - image: data URL 格式的图像数据
+   * - files: JSON 序列化的文件路径数组
+   * - html: HTML 格式的富文本
+   * @required
+   */
+  content: string;
+
+  /**
+   * 原始内容
+   * @description 可选的原始格式内容，如富文本的 HTML 源码
+   */
+  rawContent?: string;
+
+  /**
+   * 缩略图
+   * @description 图像的缩略图 data URL（用于预览）
+   */
+  thumbnail?: string;
+
+  /**
+   * 元数据
+   * @description 附加的元数据信息
+   */
+  metadata?: Record<string, any>;
+}
+
 /**
  * 搜索查询结构
  *
  * @description
  * 定义搜索请求的参数和过滤条件。
  * 系统根据这些参数执行搜索并返回匹配结果。
+ * 
+ * **重要区分**：
+ * - `text`: 用户在输入框中主动输入的查询文本
+ * - `inputs`: 来自剪贴板或其他来源的附加输入数据（图像、文件、富文本等）
  */
 export interface TuffQuery {
   /**
-   * 查询文本
-   * @description 用户输入的搜索文本
+   * 用户输入的查询文本
+   * @description 这是用户在搜索框中主动输入的文本，不包括剪贴板内容
    * @required
+   * 
+   * @example
+   * 用户输入 "translate" → text = "translate"
    */
   text: string;
 
@@ -1062,6 +1132,31 @@ export interface TuffQuery {
    */
   type?: 'text' | 'voice' | 'image';
 
+  /**
+   * 多类型输入（附加数据）
+   * @description 除了用户输入的文本外的其他输入数据（如剪贴板中的图像、文件、富文本等）
+   * 
+   * **与 text 的区别**：
+   * - `text`: 用户主动输入，总是存在
+   * - `inputs`: 系统自动检测的附加数据，可能为空
+   * 
+   * 当用户触发 feature 时，系统会自动检测剪贴板并填充此字段。
+   * 
+   * @example
+   * 场景 1: 用户输入 "translate" + 剪贴板有图片
+   *   text: "translate"
+   *   inputs: [{ type: 'image', content: 'data:image/png;base64,...' }]
+   * 
+   * 场景 2: 用户输入 "compress" + 剪贴板有文件
+   *   text: "compress" 
+   *   inputs: [{ type: 'files', content: '["/path/to/file"]' }]
+   * 
+   * 场景 3: 用户输入 "format" + 剪贴板有富文本
+   *   text: "format"
+   *   inputs: [{ type: 'html', content: 'plain text', rawContent: '<p>html</p>' }]
+   */
+  inputs?: TuffQueryInput[];
+
   /**
    * 过滤条件
    * @description 限制搜索范围的过滤器
@@ -1237,6 +1332,15 @@ export interface ISearchProvider<C> {
    */
   readonly icon?: any
 
+  /**
+   * Supported input types
+   * @description Declares which types of inputs this provider can handle.
+   * If not specified, defaults to [TuffInputType.Text] only.
+   * When query contains non-text inputs, only providers supporting those types will be searched.
+   * @example [TuffInputType.Text, TuffInputType.Image, TuffInputType.Files]
+   */
+  readonly supportedInputTypes?: TuffInputType[]
+
   /**
    * Core search method (PULL mode).
    * The engine calls this method to get results from the provider.

package/index.ts

@@ -1,4 +1,4 @@
-export * from './auth'
+// export * from './auth' // Renderer-only, use @talex-touch/utils/renderer instead
 export * from './base'
 export * from './common'
 export * from './plugin'

package/package.json

@@ -5,7 +5,7 @@
   "module": "./index.ts",
   "license": "MPL-2.0",
   "private": false,
-  "version": "1.0.30",
+  "version": "1.0.31",
   "scripts": {
     "publish": "npm publish --access public"
   },

package/plugin/index.ts

@@ -150,6 +150,15 @@ export interface IPluginFeature {
    * Default is 0
    */
   priority?: number
+  /**
+   * Accepted input types for this feature
+   * @description Declares which types of inputs this feature can accept and process.
+   * If not specified, defaults to ['text'] only (backward compatible).
+   * When query contains inputs, only features accepting those input types will be shown.
+   * @example ['text', 'image'] - Feature accepts both text and images
+   * @example ['image', 'files'] - Feature only accepts images and files (no text-only queries)
+   */
+  acceptedInputTypes?: Array<'text' | 'image' | 'files' | 'html'>
 }
 
 export type IFeatureInteraction = {
@@ -187,11 +196,14 @@ export interface IFeatureLifeCycle {
   /**
    * Called when a feature is triggered via a matching command.
    * @param id - Feature ID
-   * @param data - The triggering payload
+   * @param data - The triggering payload. Can be:
+   *   - string: Plain text query (backward compatible)
+   *   - TuffQuery object: Complete query with text and optional inputs array containing clipboard data (images, files, HTML)
    * @param feature - The full feature definition
    * @param signal - An AbortSignal to cancel the operation
+   * @returns If returns false, the feature will not enter activation state (e.g., just opens browser and exits)
    */
-  onFeatureTriggered(id: string, data: any, feature: IPluginFeature, signal?: AbortSignal): void
+  onFeatureTriggered(id: string, data: any, feature: IPluginFeature, signal?: AbortSignal): boolean | void
 
   /**
    * Called when user input changes within this feature’s input box.
@@ -253,10 +265,13 @@ export interface ITargetFeatureLifeCycle {
 
   /**
    * Called when the feature is triggered via a matching command.
-   * @param data - The triggering payload
+   * @param data - The triggering payload. Can be:
+   *   - string: Plain text query (backward compatible)
+   *   - TuffQuery object: Complete query with text and optional inputs array containing clipboard data (images, files, HTML)
    * @param feature - The full feature definition
+   * @returns If returns false, the feature will not enter activation state (e.g., just opens browser and exits)
    */
-  onFeatureTriggered(data: any, feature: IPluginFeature): void
+  onFeatureTriggered(data: any, feature: IPluginFeature): boolean | void
 
   /**
    * Called when user input changes within this feature’s input box.

package/plugin/preload.ts

@@ -1,9 +1,11 @@
 import type { ITouchClientChannel } from '../channel'
+import type { ITouchSDK } from './sdk/index'
+// Import SDK for side effects (initializes hooks)
 import './sdk/index'
 
-// window type
+// window type - includes both plugin preload types and SDK types
 declare global {
-  export interface Window {
+  interface Window {
     $plugin: {
       name: string
       path: Object
@@ -13,6 +15,7 @@ declare global {
     $config: {
       themeStyle: any
     }
+    $touchSDK: ITouchSDK
   }
 }
 

package/plugin/sdk/index.ts

@@ -5,12 +5,7 @@ export interface ITouchSDK {
   __hooks: {}
 }
 
-// window type
-declare global {
-  export interface Window {
-    $touchSDK: ITouchSDK
-  }
-}
+// Note: Window.$touchSDK is declared in ../preload.ts to avoid duplicate declarations
 
 export * from './types'
 export * from './window/index'

package/plugin/sdk/types.ts

@@ -518,9 +518,29 @@ export interface IPluginLifecycle {
   /**
    * Called when a plugin feature is triggered
    * @param featureId - The ID of the triggered feature
-   * @param query - The search query or input data
+   * @param query - The search query or input data. Can be:
+   *   - string: Plain text query (backward compatible)
+   *   - TuffQuery object: Complete query with text and optional inputs array
+   *     - query.text: The text query string
+   *     - query.inputs: Array of TuffQueryInput objects (images, files, HTML)
    * @param feature - The feature configuration object
    * @returns Promise or void
+   * @example
+   * ```typescript
+   * onFeatureTriggered(featureId, query, feature) {
+   *   if (typeof query === 'string') {
+   *     // Backward compatible: plain text query
+   *     console.log('Text query:', query)
+   *   } else {
+   *     // New: complete query object
+   *     console.log('Text:', query.text)
+   *     const imageInput = query.inputs?.find(i => i.type === 'image')
+   *     if (imageInput) {
+   *       console.log('Image data:', imageInput.content)
+   *     }
+   *   }
+   * }
+   * ```
    */
   onFeatureTriggered(featureId: string, query: any, feature: any): Promise<void> | void;
 

package/renderer/index.ts

@@ -3,3 +3,4 @@ export * from './storage'
 export * from './touch-sdk'
 export * from './touch-sdk/utils'
 export * from './hooks'
+export * from '../auth' // Re-export auth for renderer

package/renderer/storage/base-storage.ts

@@ -29,8 +29,14 @@ export interface IStorageChannel extends ITouchClientChannel {
 
 let channel: IStorageChannel | null = null;
 
+/**
+ * Queue of initialization callbacks waiting for channel initialization
+ */
+const pendingInitializations: Array<() => void> = [];
+
 /**
  * Initializes the global channel for communication.
+ * Processes all pending storage initializations after initialization.
  *
  * @example
  * ```ts
@@ -45,6 +51,14 @@ let channel: IStorageChannel | null = null;
  */
 export function initStorageChannel(c: IStorageChannel): void {
   channel = c;
+
+  // Process all pending storage initializations
+  for (const initFn of pendingInitializations) {
+    initFn();
+  }
+
+  // Clear the queue
+  pendingInitializations.length = 0;
 }
 
 /**
@@ -64,6 +78,7 @@ export class TouchStorage<T extends object> {
   #assigning = false;
   readonly originalData: T;
   private readonly _onUpdate: Array<() => void> = [];
+  #channelInitialized = false;
 
   /**
    * The reactive data exposed to users.
@@ -72,6 +87,7 @@ export class TouchStorage<T extends object> {
 
   /**
    * Creates a new reactive storage instance.
+   * If channel is not initialized, the instance will be queued for initialization.
    *
    * @param qName Globally unique name for the instance
    * @param initData Initial data to populate the storage
@@ -86,30 +102,52 @@ export class TouchStorage<T extends object> {
     if (storages.has(qName)) {
       throw new Error(`Storage "${qName}" already exists`);
     }
+
+    this.#qualifiedName = qName;
+    this.originalData = initData;
+    this.data = reactive({ ...initData }) as UnwrapNestedRefs<T>;
+
+    if (onUpdate) this._onUpdate.push(onUpdate);
+
+    // Register to storages map immediately
+    storages.set(qName, this);
+
+    // Initialize channel-dependent operations
+    if (channel) {
+      this.#initializeChannel();
+    } else {
+      // Queue initialization callback for later
+      pendingInitializations.push(() => this.#initializeChannel());
+    }
+  }
+
+  /**
+   * Initialize channel-dependent operations
+   */
+  #initializeChannel(): void {
+    if (this.#channelInitialized) {
+      return;
+    }
+
     if (!channel) {
       throw new Error(
         'TouchStorage: channel is not initialized. Please call initStorageChannel(...) before using.'
       );
     }
 
-    this.#qualifiedName = qName;
-    this.originalData = initData;
-
-    // const stored = (channel.sendSync('storage:get', qName) as Partial<T>) || {};
-    this.data = reactive({ ...initData }) as UnwrapNestedRefs<T>;
-    this.loadFromRemote()
+    this.#channelInitialized = true;
 
-    if (onUpdate) this._onUpdate.push(onUpdate);
+    // Load data from remote
+    this.loadFromRemote();
 
+    // Register update listener
     channel.regChannel('storage:update', ({ data }) => {
       const { name } = data!
 
-      if (name === qName) {
+      if (name === this.#qualifiedName) {
         this.loadFromRemote()
       }
-    })
-
-    storages.set(qName, this);
+    });
   }
 
   /**
@@ -313,6 +351,7 @@ export class TouchStorage<T extends object> {
   }
   /**
    * Loads data from remote storage and applies it.
+   * If channel is not initialized yet, this method will do nothing.
    *
    * @returns The current instance
    *
@@ -323,7 +362,8 @@ export class TouchStorage<T extends object> {
    */
   loadFromRemote(): this {
     if (!channel) {
-      throw new Error("TouchStorage: channel not initialized");
+      // Channel not initialized yet, data will be loaded when channel is ready
+      return this;
     }
 
     const result = channel.sendSync('storage:get', this.#qualifiedName)

package/search/types.ts

@@ -17,7 +17,7 @@
  */
 
 import type { IFeatureCommand } from '../plugin';
-import type { ITuffIcon } from '../types/icon';
+import type { ITuffIcon, TuffIconType } from '../types/icon';
 
 /**
  * Search Result Item Interface
@@ -591,9 +591,8 @@ export function createDataItem(options: {
     name,
     desc,
     icon: {
-      type: iconType,
-      value: iconValue,
-      init: async () => {} // Required by ITuffIcon interface
+      type: (iconType === 'remix' || iconType === 'base64' ? 'url' : (iconType === 'file' || iconType === 'emoji' ? iconType : 'emoji')) as TuffIconType,
+      value: iconValue
     },
     push: false,                    // Data items don't support push mode
     names: [name],                  // Include name in searchable names

package/types/icon.ts

@@ -11,8 +11,9 @@
  * - emoji: Emoji characters (e.g., "🚀")
  * - url: Remote URL (http/https) or Data URL (data:image/...)
  * - file: Local file path (relative to plugin root directory)
+ * - class: Class name (e.g., "i-ri-rocket-line")
  */
-export type TuffIconType = 'emoji' | 'url' | 'file'
+export type TuffIconType = 'emoji' | 'url' | 'file' | 'class'
 
 /**
  * Icon status enumeration