@talex-touch/utils 1.0.32 → 1.0.34

package/plugin/sdk/box-sdk.ts

@@ -0,0 +1,219 @@
+/**
+ * Box SDK for Plugin Development
+ * 
+ * Provides a unified API for plugins to control the CoreBox window behavior,
+ * including visibility, size, input field control, and input value access.
+ */
+
+/**
+ * Expand options for CoreBox window
+ */
+export interface BoxExpandOptions {
+  /** Number of items to show (affects window height) */
+  length?: number
+  /** Force maximum expansion */
+  forceMax?: boolean
+}
+
+/**
+ * Box SDK interface for plugins
+ * 
+ * @example
+ * ```typescript
+ * // Hide CoreBox
+ * plugin.box.hide()
+ * 
+ * // Show CoreBox
+ * plugin.box.show()
+ * 
+ * // Expand to show 10 items
+ * plugin.box.expand({ length: 10 })
+ * 
+ * // Get current input
+ * const input = plugin.box.getInput()
+ * ```
+ */
+export interface BoxSDK {
+  /**
+   * Hides the CoreBox window
+   * 
+   * @example
+   * ```typescript
+   * plugin.box.hide()
+   * ```
+   */
+  hide(): void
+
+  /**
+   * Shows the CoreBox window
+   * 
+   * @example
+   * ```typescript
+   * plugin.box.show()
+   * ```
+   */
+  show(): void
+
+  /**
+   * Expands the CoreBox window
+   * 
+   * @param options - Optional expansion configuration
+   * 
+   * @example
+   * ```typescript
+   * // Expand to show 10 items
+   * plugin.box.expand({ length: 10 })
+   * 
+   * // Force maximum expansion
+   * plugin.box.expand({ forceMax: true })
+   * 
+   * // Default expansion
+   * plugin.box.expand()
+   * ```
+   */
+  expand(options?: BoxExpandOptions): Promise<void>
+
+  /**
+   * Shrinks the CoreBox window to compact size
+   * 
+   * @example
+   * ```typescript
+   * plugin.box.shrink()
+   * ```
+   */
+  shrink(): Promise<void>
+
+  /**
+   * Hides the input field in CoreBox
+   * 
+   * @example
+   * ```typescript
+   * plugin.box.hideInput()
+   * ```
+   */
+  hideInput(): Promise<void>
+
+  /**
+   * Shows the input field in CoreBox
+   * 
+   * @example
+   * ```typescript
+   * plugin.box.showInput()
+   * ```
+   */
+  showInput(): Promise<void>
+
+  /**
+   * Gets the current input value from CoreBox search field
+   * 
+   * @returns Promise resolving to the current input string
+   * 
+   * @example
+   * ```typescript
+   * const input = await plugin.box.getInput()
+   * console.log('Current input:', input)
+   * ```
+   */
+  getInput(): Promise<string>
+}
+
+/**
+ * Creates a Box SDK instance for plugin use
+ * 
+ * @param channel - The plugin channel bridge for IPC communication
+ * @returns Configured Box SDK instance
+ * 
+ * @internal
+ */
+export function createBoxSDK(channel: any): BoxSDK {
+  const sendFn = channel.sendToMain || channel.send
+
+  if (!sendFn) {
+    throw new Error('[Box SDK] Channel send function not available')
+  }
+
+  return {
+    hide(): void {
+      sendFn('core-box:hide').catch((error: any) => {
+        console.error('[Box SDK] Failed to hide CoreBox:', error)
+      })
+    },
+
+    show(): void {
+      sendFn('core-box:show').catch((error: any) => {
+        console.error('[Box SDK] Failed to show CoreBox:', error)
+      })
+    },
+
+    async expand(options?: BoxExpandOptions): Promise<void> {
+      try {
+        await sendFn('core-box:expand', options || {})
+      } catch (error) {
+        console.error('[Box SDK] Failed to expand CoreBox:', error)
+        throw error
+      }
+    },
+
+    async shrink(): Promise<void> {
+      try {
+        await sendFn('core-box:expand', { mode: 'collapse' })
+      } catch (error) {
+        console.error('[Box SDK] Failed to shrink CoreBox:', error)
+        throw error
+      }
+    },
+
+    async hideInput(): Promise<void> {
+      try {
+        await sendFn('core-box:hide-input')
+      } catch (error) {
+        console.error('[Box SDK] Failed to hide input:', error)
+        throw error
+      }
+    },
+
+    async showInput(): Promise<void> {
+      try {
+        await sendFn('core-box:show-input')
+      } catch (error) {
+        console.error('[Box SDK] Failed to show input:', error)
+        throw error
+      }
+    },
+
+    async getInput(): Promise<string> {
+      try {
+        const result = await sendFn('core-box:get-input')
+        return result?.data?.input || result?.input || ''
+      } catch (error) {
+        console.error('[Box SDK] Failed to get input:', error)
+        throw error
+      }
+    }
+  }
+}
+
+/**
+ * Hook for using Box SDK in plugin context
+ * 
+ * @returns Box SDK instance
+ * 
+ * @example
+ * ```typescript
+ * const box = useBox()
+ * 
+ * box.hide()
+ * box.expand({ length: 10 })
+ * const input = await box.getInput()
+ * ```
+ */
+export function useBox(): BoxSDK {
+  // @ts-ignore - window.$channel is injected by the plugin system
+  const channel = window.$channel
+  
+  if (!channel) {
+    throw new Error('[Box SDK] Channel not available. Make sure this is called in a plugin context.')
+  }
+  
+  return createBoxSDK(channel)
+}

package/plugin/sdk/feature-sdk.ts

@@ -0,0 +1,235 @@
+/**
+ * Feature SDK for Plugin Development
+ * 
+ * Provides a unified API for plugins to manage search result items (TuffItems)
+ * in the CoreBox interface. This SDK handles item lifecycle, updates, and
+ * input change notifications.
+ */
+
+import type { TuffItem } from '../../core-box/tuff'
+
+/**
+ * Input change event handler
+ */
+export type InputChangeHandler = (input: string) => void
+
+/**
+ * Feature SDK interface for plugins
+ * 
+ * @example
+ * ```typescript
+ * // Push items to CoreBox
+ * plugin.feature.pushItems([
+ *   { id: 'item-1', title: 'Result 1', ... },
+ *   { id: 'item-2', title: 'Result 2', ... }
+ * ])
+ * 
+ * // Update a specific item
+ * plugin.feature.updateItem('item-1', { title: 'Updated Title' })
+ * 
+ * // Listen for input changes
+ * plugin.feature.onInputChange((input) => {
+ *   console.log('User typed:', input)
+ * })
+ * ```
+ */
+export interface FeatureSDK {
+  /**
+   * Pushes multiple items to the CoreBox search results
+   * 
+   * @param items - Array of TuffItem objects to display
+   * 
+   * @example
+   * ```typescript
+   * plugin.feature.pushItems([
+   *   {
+   *     id: 'calc-result',
+   *     title: { text: '42' },
+   *     subtitle: { text: 'Calculation result' },
+   *     source: { id: 'calculator', name: 'Calculator' }
+   *   }
+   * ])
+   * ```
+   */
+  pushItems(items: TuffItem[]): void
+
+  /**
+   * Updates a specific item by ID
+   * 
+   * @param id - The unique ID of the item to update
+   * @param updates - Partial TuffItem with fields to update
+   * 
+   * @example
+   * ```typescript
+   * // Update title and subtitle
+   * plugin.feature.updateItem('item-1', {
+   *   title: { text: 'New Title' },
+   *   subtitle: { text: 'Updated subtitle' }
+   * })
+   * ```
+   */
+  updateItem(id: string, updates: Partial<TuffItem>): void
+
+  /**
+   * Removes a specific item by ID
+   * 
+   * @param id - The unique ID of the item to remove
+   * 
+   * @example
+   * ```typescript
+   * plugin.feature.removeItem('item-1')
+   * ```
+   */
+  removeItem(id: string): void
+
+  /**
+   * Clears all items pushed by this plugin
+   * 
+   * @example
+   * ```typescript
+   * plugin.feature.clearItems()
+   * ```
+   */
+  clearItems(): void
+
+  /**
+   * Gets all items currently pushed by this plugin
+   * 
+   * @returns Array of TuffItem objects
+   * 
+   * @example
+   * ```typescript
+   * const items = plugin.feature.getItems()
+   * console.log(`Currently showing ${items.length} items`)
+   * ```
+   */
+  getItems(): TuffItem[]
+
+  /**
+   * Registers a listener for input changes in the CoreBox search field
+   * 
+   * @param handler - Callback function invoked when input changes
+   * @returns Unsubscribe function
+   * 
+   * @example
+   * ```typescript
+   * const unsubscribe = plugin.feature.onInputChange((input) => {
+   *   console.log('User typed:', input)
+   *   // Perform real-time search
+   *   performSearch(input)
+   * })
+   * 
+   * // Later, unsubscribe
+   * unsubscribe()
+   * ```
+   */
+  onInputChange(handler: InputChangeHandler): () => void
+}
+
+/**
+ * Creates a Feature SDK instance for plugin use
+ * 
+ * @param boxItemsAPI - The boxItems API object from plugin context
+ * @param channel - The plugin channel bridge for IPC communication
+ * @returns Configured Feature SDK instance
+ * 
+ * @internal
+ */
+export function createFeatureSDK(boxItemsAPI: any, channel: any): FeatureSDK {
+  const inputChangeHandlers: Set<InputChangeHandler> = new Set()
+
+  // Register listener for input change events from main process
+  const registerListener = () => {
+    if (channel.onMain) {
+      // Main process plugin context
+      channel.onMain('core-box:input-changed', (event: any) => {
+        const input = event.data?.input || event.input || ''
+        inputChangeHandlers.forEach(handler => handler(input))
+      })
+    } else if (channel.on) {
+      // Renderer process context
+      channel.on('core-box:input-changed', (data: any) => {
+        const input = data?.input || data || ''
+        inputChangeHandlers.forEach(handler => handler(input))
+      })
+    }
+  }
+
+  registerListener()
+
+  return {
+    pushItems(items: TuffItem[]): void {
+      if (!boxItemsAPI || !boxItemsAPI.pushItems) {
+        throw new Error('[Feature SDK] boxItems API not available')
+      }
+      boxItemsAPI.pushItems(items)
+    },
+
+    updateItem(id: string, updates: Partial<TuffItem>): void {
+      if (!boxItemsAPI || !boxItemsAPI.update) {
+        throw new Error('[Feature SDK] boxItems API not available')
+      }
+      boxItemsAPI.update(id, updates)
+    },
+
+    removeItem(id: string): void {
+      if (!boxItemsAPI || !boxItemsAPI.remove) {
+        throw new Error('[Feature SDK] boxItems API not available')
+      }
+      boxItemsAPI.remove(id)
+    },
+
+    clearItems(): void {
+      if (!boxItemsAPI || !boxItemsAPI.clear) {
+        throw new Error('[Feature SDK] boxItems API not available')
+      }
+      boxItemsAPI.clear()
+    },
+
+    getItems(): TuffItem[] {
+      if (!boxItemsAPI || !boxItemsAPI.getItems) {
+        throw new Error('[Feature SDK] boxItems API not available')
+      }
+      return boxItemsAPI.getItems()
+    },
+
+    onInputChange(handler: InputChangeHandler): () => void {
+      inputChangeHandlers.add(handler)
+      
+      return () => {
+        inputChangeHandlers.delete(handler)
+      }
+    }
+  }
+}
+
+/**
+ * Hook for using Feature SDK in plugin context
+ * 
+ * @returns Feature SDK instance
+ * 
+ * @example
+ * ```typescript
+ * const feature = useFeature()
+ * 
+ * feature.pushItems([
+ *   { id: '1', title: { text: 'Item 1' }, ... }
+ * ])
+ * ```
+ */
+export function useFeature(): FeatureSDK {
+  // @ts-ignore - window.$boxItems and window.$channel are injected by the plugin system
+  const boxItemsAPI = window.$boxItems
+  // @ts-ignore
+  const channel = window.$channel
+  
+  if (!boxItemsAPI) {
+    throw new Error('[Feature SDK] boxItems API not available. Make sure this is called in a plugin context.')
+  }
+  
+  if (!channel) {
+    throw new Error('[Feature SDK] Channel not available. Make sure this is called in a plugin context.')
+  }
+  
+  return createFeatureSDK(boxItemsAPI, channel)
+}

package/plugin/sdk/index.ts

@@ -7,10 +7,12 @@ export interface ITouchSDK {
 
 // Note: Window.$touchSDK is declared in ../preload.ts to avoid duplicate declarations
 
+export * from './box-sdk'
 export * from './channel'
 export * from './clipboard'
 export * from './core-box'
 export * from './division-box'
+export * from './feature-sdk'
 export { createFeaturesManager, useFeatures } from './features'
 
 export * from './hooks/index'

package/plugin/sdk/types.ts

@@ -183,6 +183,18 @@ export interface IPluginUtils {
    */
   divisionBox: import('./division-box').DivisionBoxSDK
 
+  /**
+   * Box SDK for controlling CoreBox window behavior
+   * @see {@link BoxSDK}
+   */
+  box: import('./box-sdk').BoxSDK
+
+  /**
+   * Feature SDK for managing search result items
+   * @see {@link FeatureSDK}
+   */
+  feature: import('./feature-sdk').FeatureSDK
+
   /**
    * Opens a URL in the default browser
    * @param url - The URL to open
@@ -190,21 +202,22 @@ export interface IPluginUtils {
   openUrl: (url: string) => void
 
   /**
-   * Pushes search result items to the search interface
-   * @param items - Array of search result items to add
+   * @deprecated Use plugin.feature.pushItems() instead
+   * @throws Error indicating the API is deprecated
    */
-  pushItems: (items: any[]) => void
+  pushItems: (items: any[]) => never
 
   /**
-   * Clears all current search results
+   * @deprecated Use plugin.feature.clearItems() instead
+   * @throws Error indicating the API is deprecated
    */
-  clearItems: () => void
+  clearItems: () => never
 
   /**
-   * Gets all current search result items
-   * @returns Array of current search result items
+   * @deprecated Use plugin.feature.getItems() instead
+   * @throws Error indicating the API is deprecated
    */
-  getItems: () => any[]
+  getItems: () => never
 
   /**
    * Features manager for dynamic feature management

package/plugin/widget.ts

@@ -0,0 +1,25 @@
+export const DEFAULT_WIDGET_RENDERERS = {
+  CORE_PREVIEW_CARD: 'core-preview-card',
+  CORE_INTELLIGENCE_ANSWER: 'core-intelligence-answer',
+} as const
+
+const values = Object.values(DEFAULT_WIDGET_RENDERERS)
+export const DEFAULT_WIDGET_RENDERER_IDS = new Set<string>(values)
+
+export function isDefaultWidgetRenderer(id: string | undefined): boolean {
+  return Boolean(id) && DEFAULT_WIDGET_RENDERER_IDS.has(id!)
+}
+
+export interface WidgetRegistrationPayload {
+  widgetId: string
+  pluginName: string
+  featureId: string
+  filePath: string
+  code: string
+  styles: string
+  hash: string
+}
+
+export function makeWidgetId(pluginName: string, featureId: string): string {
+  return `${pluginName}::${featureId}`
+}

package/renderer/storage/intelligence-storage.ts

@@ -18,7 +18,7 @@ const defaultIntelligenceData: AISDKStorageData = {
   providers: [...DEFAULT_PROVIDERS],
   globalConfig: { ...DEFAULT_GLOBAL_CONFIG },
   capabilities: { ...DEFAULT_CAPABILITIES },
-  version: 1,
+  version: 2,
 }
 
 const INTELLIGENCE_STORAGE_KEY = `storage:${StorageList.IntelligenceConfig}`
@@ -145,8 +145,9 @@ export async function migrateIntelligenceSettings(): Promise<void> {
   console.log('[Intelligence Storage] Starting migration check...')
   const currentData = intelligenceStorage.data
 
-  if (!currentData.version || currentData.version < 1) {
-    console.log('[Intelligence Storage] Migrating settings to version 1')
+  // Version 2: Force update capabilities to include all new ones
+  if (!currentData.version || currentData.version < 2) {
+    console.log('[Intelligence Storage] Migrating settings to version 2')
 
     const migratedProviders = currentData.providers.map(provider => ({
       ...provider,
@@ -169,24 +170,26 @@ export async function migrateIntelligenceSettings(): Promise<void> {
       cacheExpiration: currentData.globalConfig?.cacheExpiration ?? 3600,
     }
 
-    const migratedCapabilities = currentData.capabilities ?? { ...DEFAULT_CAPABILITIES }
-
+    // Force update to latest DEFAULT_CAPABILITIES (version 2)
+    console.log('[Intelligence Storage] Updating capabilities to latest defaults')
+    
     intelligenceStorage.applyData({
       providers: migratedProviders,
       globalConfig: migratedGlobalConfig,
-      capabilities: migratedCapabilities,
-      version: 1,
+      capabilities: { ...DEFAULT_CAPABILITIES },
+      version: 2,
     })
 
     await intelligenceStorage.saveToRemote({ force: true })
 
-    console.log('[Intelligence Storage] Migration complete')
+    console.log('[Intelligence Storage] Migration to v2 complete, capabilities count:', Object.keys(DEFAULT_CAPABILITIES).length)
   }
   else {
     console.log('[Intelligence Storage] No migration needed, current version:', currentData.version)
   }
 
   console.log('[Intelligence Storage] Final providers count:', intelligenceStorage.data.providers.length)
+  console.log('[Intelligence Storage] Final capabilities count:', Object.keys(intelligenceStorage.data.capabilities).length)
 }
 
 /**
@@ -201,7 +204,7 @@ export async function resetIntelligenceConfig(): Promise<void> {
     providers: [...DEFAULT_PROVIDERS],
     globalConfig: { ...DEFAULT_GLOBAL_CONFIG },
     capabilities: { ...DEFAULT_CAPABILITIES },
-    version: 1,
+    version: 2,
   })
 
   await intelligenceStorage.saveToRemote({ force: true })