@talex-touch/utils 1.0.30 → 1.0.32

package/plugin/index.ts

@@ -1,6 +1,10 @@
-import { Arch, SupportOS } from './../base/index';
-import type { IPluginLogger } from './log/types';
-import type { PluginInstallRequest, PluginInstallSummary } from './providers';
+import type { FSWatcher } from 'chokidar'
+import type { ITuffIcon } from '../types/icon'
+import type { Arch, SupportOS } from './../base/index'
+
+import type { IPluginLogger } from './log/types'
+
+import type { PluginInstallRequest, PluginInstallSummary } from './providers'
 
 export enum PluginStatus {
   DISABLED,
@@ -15,8 +19,8 @@ export enum PluginStatus {
   LOADED,
   LOAD_FAILED,
 
-  DEV_DISCONNECTED,  // Dev Server 断连
-  DEV_RECONNECTING,  // 正在重连
+  DEV_DISCONNECTED, // Dev Server 断连
+  DEV_RECONNECTING, // 正在重连
 }
 
 export interface PluginIssue {
@@ -36,9 +40,6 @@ export interface DevServerHealthCheckResult {
   error?: string
 }
 
-import type { ITuffIcon } from '../types/icon'
-
-
 export interface IPlatformInfo {
   enable: boolean
   arch: Arch[]
@@ -73,26 +74,27 @@ export interface ITouchPlugin extends IPluginBaseInfo {
   logger: IPluginLogger<any>
   features: IPluginFeature[]
   issues: PluginIssue[]
+  divisionBoxConfig?: import('../types/division-box').ManifestDivisionBoxConfig
 
-  addFeature(feature: IPluginFeature): boolean
-  delFeature(featureId: string): boolean
-  getFeature(featureId: string): IPluginFeature | null
-  getFeatures(): IPluginFeature[]
-  triggerFeature(feature: IPluginFeature, query: any): void
-  triggerInputChanged(feature: IPluginFeature, query: any): void
+  addFeature: (feature: IPluginFeature) => boolean
+  delFeature: (featureId: string) => boolean
+  getFeature: (featureId: string) => IPluginFeature | null
+  getFeatures: () => IPluginFeature[]
+  triggerFeature: (feature: IPluginFeature, query: any) => void
+  triggerInputChanged: (feature: IPluginFeature, query: any) => void
 
   get status(): PluginStatus
   set status(v: PluginStatus)
 
-  enable(): Promise<boolean>
-  disable(): Promise<boolean>
+  enable: () => Promise<boolean>
+  disable: () => Promise<boolean>
 
   /**
    * Get the plugin file.
    * @param fileName The name of the file.
    * @returns The content of the file.
    */
-  getPluginFile(fileName: string): object
+  getPluginFile: (fileName: string) => object
 
   /**
    * Save the plugin file.
@@ -100,39 +102,39 @@ export interface ITouchPlugin extends IPluginBaseInfo {
    * @param content The content of the file.
    * @returns The result of the save operation.
    */
-  savePluginFile(fileName: string, content: object): { success: boolean; error?: string }
+  savePluginFile: (fileName: string, content: object) => { success: boolean, error?: string }
 
   /**
    * Delete the plugin file.
    * @param fileName The name of the file.
    * @returns The result of the delete operation.
    */
-  deletePluginFile(fileName: string): { success: boolean; error?: string }
+  deletePluginFile: (fileName: string) => { success: boolean, error?: string }
 
   /**
    * List all files in the plugin.
    * @returns The list of files.
    */
-  listPluginFiles(): string[]
+  listPluginFiles: () => string[]
 
   /**
    * Get the plugin configuration.
    * @returns The configuration content.
    */
-  getPluginConfig(): object
+  getPluginConfig: () => object
 
   /**
    * Save the plugin configuration.
    * @param content The configuration content.
    * @returns The result of the save operation.
    */
-  savePluginConfig(content: object): { success: boolean; error?: string }
+  savePluginConfig: (content: object) => { success: boolean, error?: string }
 }
 
 export interface IFeatureCommand {
-  type: "match" | "contain" | "regex" | "function" | "over" | "image" | "files" | "directory" | "window"
+  type: 'match' | 'contain' | 'regex' | 'function' | 'over' | 'image' | 'files' | 'directory' | 'window'
   value: string | string[] | RegExp | Function
-  onTrigger(): void
+  onTrigger: () => void
 }
 
 export interface IPluginFeature {
@@ -150,9 +152,18 @@ 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 = {
+export interface IFeatureInteraction {
   type: 'webcontent' | 'widget'
   /**
    * The relative path to the html file from the plugin root.
@@ -169,36 +180,39 @@ export interface IFeatureLifeCycle {
    * onInit is called when the feature is initialized.
    * Can be used to prepare data or UI specific to this session.
    */
-  onInit?(): void
+  onInit?: () => void
 
   /**
    * Called when a message is received from the main application.
    * @param key - The key of the message
    * @param info - The information of the message
    */
-  onMessage?(key: string, info: any): void
+  onMessage?: (key: string, info: any) => void
   /**
    * Called when a feature is actively launched from the launcher.
    * Can be used to prepare data or UI specific to this session.
    * @param feature - The feature instance being launched
    */
-  onLaunch?(feature: IPluginFeature): void
+  onLaunch?: (feature: IPluginFeature) => void
 
   /**
    * 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.
    * For example, search text or commands typed.
    * @param input - The new input value
    */
-  onInputChanged?(input: string): void
+  onInputChanged?: (input: string) => void
 
   /**
    * Called when a user selects or clicks an actionable item inside the feature.
@@ -206,14 +220,14 @@ export interface IFeatureLifeCycle {
    * @param actionId - A string identifier for the clicked action
    * @param data - Optional payload associated with that action
    */
-  onActionClick?(actionId: string, data?: any): void
+  onActionClick?: (actionId: string, data?: any) => void
 
   /**
    * Called when the feature is manually closed by the user or by the system.
    * Useful for cleanup or state saving.
    * @param feature - The feature instance being closed
    */
-  onClose?(feature: IPluginFeature): void
+  onClose?: (feature: IPluginFeature) => void
 
   /**
    * Called when an item generated by this feature is executed.
@@ -222,7 +236,7 @@ export interface IFeatureLifeCycle {
    * @param item The TuffItem that was executed.
    * @returns Object indicating whether to activate the feature and any activation data
    */
-  onItemAction?(item: any): Promise<{
+  onItemAction?: (item: any) => Promise<{
     /** Whether the action executed an external operation (e.g., opened browser) */
     externalAction?: boolean
     /** Whether the feature should be activated after this action */
@@ -236,7 +250,7 @@ export interface IFeatureLifeCycle {
    * @param key - The storage key that changed
    * @param value - The new value (undefined if key was removed)
    */
-  onStorageChange?(key: string, value: any): void
+  onStorageChange?: (key: string, value: any) => void
 }
 
 /**
@@ -249,21 +263,24 @@ export interface ITargetFeatureLifeCycle {
    * Can be used to prepare data or UI specific to this session.
    * @param feature - The feature instance being launched
    */
-  onLaunch?(feature: IPluginFeature): void
+  onLaunch?: (feature: IPluginFeature) => void
 
   /**
    * 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.
    * For example, search text or commands typed.
    * @param input - The new input value
    */
-  onInputChanged?(input: string): void
+  onInputChanged?: (input: string) => void
 
   /**
    * Called when a user selects or clicks an actionable item inside the feature.
@@ -271,14 +288,14 @@ export interface ITargetFeatureLifeCycle {
    * @param actionId - A string identifier for the clicked action
    * @param data - Optional payload associated with that action
    */
-  onActionClick?(actionId: string, data?: any): void
+  onActionClick?: (actionId: string, data?: any) => void
 
   /**
    * Called when the feature is manually closed by the user or by the system.
    * Useful for cleanup or state saving.
    * @param feature - The feature instance being closed
    */
-  onClose?(feature: IPluginFeature): void
+  onClose?: (feature: IPluginFeature) => void
 
   /**
    * Called when an item generated by this feature is executed.
@@ -287,7 +304,7 @@ export interface ITargetFeatureLifeCycle {
    * @param item The TuffItem that was executed.
    * @returns Object indicating whether to activate the feature and any activation data
    */
-  onItemAction?(item: any): Promise<{
+  onItemAction?: (item: any) => Promise<{
     /** Whether the action executed an external operation (e.g., opened browser) */
     externalAction?: boolean
     /** Whether the feature should be activated after this action */
@@ -316,8 +333,6 @@ export enum PluginSourceType {
   FILE_SYSTEM = 'file_system',
 }
 
-import type { FSWatcher } from 'chokidar'
-
 export interface IPluginManager {
   plugins: Map<string, ITouchPlugin>
   active: string | null
@@ -330,18 +345,24 @@ export interface IPluginManager {
   devWatcher: any // Temporarily any, as DevPluginWatcher is internal to core-app
   healthMonitor: any | null // DevServerHealthMonitor instance, set by PluginModule
 
-  getPluginList(): Array<object>
-  setActivePlugin(pluginName: string): boolean
-  hasPlugin(name: string): boolean
-  getPluginByName(name: string): ITouchPlugin | undefined
-  enablePlugin(pluginName: string): Promise<boolean>
-  disablePlugin(pluginName: string): Promise<boolean>
-  reloadPlugin(pluginName: string): Promise<void>
-  persistEnabledPlugins(): Promise<void>
-  listPlugins(): Promise<Array<string>>
-  loadPlugin(pluginName: string): Promise<boolean>
-  unloadPlugin(pluginName: string): Promise<boolean>
-  installFromSource(request: PluginInstallRequest): Promise<PluginInstallSummary>
+  getPluginList: () => Array<object>
+  setActivePlugin: (pluginName: string) => boolean
+  hasPlugin: (name: string) => boolean
+  getPluginByName: (name: string) => ITouchPlugin | undefined
+  enablePlugin: (pluginName: string) => Promise<boolean>
+  disablePlugin: (pluginName: string) => Promise<boolean>
+  reloadPlugin: (pluginName: string) => Promise<void>
+  persistEnabledPlugins: () => Promise<void>
+  listPlugins: () => Promise<Array<string>>
+  loadPlugin: (pluginName: string) => Promise<boolean>
+  unloadPlugin: (pluginName: string) => Promise<boolean>
+  installFromSource: (request: PluginInstallRequest) => Promise<PluginInstallSummary>
+  uninstallPlugin: (pluginName: string) => Promise<boolean>
+  /**
+   * Register an internal plugin that is created in code (no manifest / scanning).
+   * Internal plugins are always hidden from user-facing plugin lists.
+   */
+  registerInternalPlugin: (plugin: ITouchPlugin) => void
 }
 
 /**
@@ -354,48 +375,56 @@ export interface IManifest {
    * Unique identifier for the plugin.
    * This is typically the package name for npm plugins or a unique string for tpex plugins.
    */
-  id: string;
+  id: string
   /**
    * Display name of the plugin.
    * This is the human-readable name shown to users.
    */
-  name: string;
+  name: string
   /**
    * Version of the plugin, following semantic versioning (e.g., "1.0.0").
    */
-  version: string;
+  version: string
   /**
    * Short description of the plugin's functionality.
    */
-  description: string;
+  description: string
   /**
    * Author of the plugin, typically a name or email.
    */
-  author: string;
+  author: string
   /**
    * Main entry file for the plugin logic, relative to the plugin's root directory.
    * This file will be loaded when the plugin is activated.
    */
-  main: string;
+  main: string
   /**
    * Optional icon path or definition for the plugin.
    * This could be a file path to an image or a specific icon class/identifier.
    */
-  icon?: string;
+  icon?: string
   /**
    * Optional keywords for activating the plugin, e.g., for search or command matching.
    * These keywords help users discover and launch the plugin.
    */
-  activationKeywords?: string[];
+  activationKeywords?: string[]
+  /**
+   * Optional runtime development configuration, typically used when running plugins from a dev server.
+   */
+  dev?: {
+    enable?: boolean
+    address?: string
+    source?: boolean
+  }
   /**
    * Optional digital signature of the plugin package, used for verification.
    */
-  _signature?: string;
+  _signature?: string
   /**
    * Optional list of files included in the plugin package.
    * This can be used for integrity checks or resource management.
    */
-  _files?: string[];
+  _files?: string[]
   /**
    * Development-specific configuration for the plugin.
    * This section is used during plugin development and might not be present in production builds.
@@ -406,14 +435,14 @@ export interface IManifest {
        * Whether development mode is enabled for the plugin.
        * If true, specific development features or debugging tools might be activated.
        */
-      enable: boolean;
+      enable: boolean
       /**
        * Address for development server or resources.
        * For example, a local URL where the plugin's frontend assets are served during development.
        */
-      address: string;
-    };
-  };
+      address: string
+    }
+  }
   /**
    * Build-specific configuration for the plugin.
    * This section defines how the plugin is built, packaged, and verified.
@@ -422,14 +451,14 @@ export interface IManifest {
     /**
      * List of files to include in the build.
      */
-    files: string[];
+    files: string[]
     /**
      * Secret configuration for the build process.
      */
     secret: {
-      pos: string;
-      addon: string[];
-    };
+      pos: string
+      addon: string[]
+    }
     /**
      * Verification settings for the plugin build.
      * Defines how the authenticity and integrity of the plugin are checked.
@@ -438,12 +467,12 @@ export interface IManifest {
       /**
        * Whether online verification is enabled.
        */
-      enable: boolean;
+      enable: boolean
       /**
        * Online verification strategy.
        */
-      online: 'custom' | 'always' | 'once';
-    };
+      online: 'custom' | 'always' | 'once'
+    }
     /**
      * Version update settings for the plugin.
      * Defines how the plugin handles updates and downgrades.
@@ -455,17 +484,17 @@ export interface IManifest {
        * - 'ask': Prompts the user before updating.
        * - 'readable': Provides a readable update notification.
        */
-      update: 'auto' | 'ask' | 'readable';
+      update: 'auto' | 'ask' | 'readable'
       /**
        * Whether downgrading the plugin version is allowed.
        */
-      downgrade: boolean;
-    };
-  };
+      downgrade: boolean
+    }
+  }
 }
 
-export type { LogLevel, LogItem, LogDataType, IPluginLogger } from './log/types'
-export * from './sdk/index'
-export * from './providers'
 export * from './install'
+export type { IPluginLogger, LogDataType, LogItem, LogLevel } from './log/types'
+export * from './providers'
 export * from './risk'
+export * from './sdk/index'

package/plugin/install.ts

@@ -1,11 +1,11 @@
-export type PluginInstallTaskStage =
-  | 'queued'
-  | 'downloading'
-  | 'awaiting-confirmation'
-  | 'installing'
-  | 'completed'
-  | 'failed'
-  | 'cancelled'
+export type PluginInstallTaskStage
+  = | 'queued'
+    | 'downloading'
+    | 'awaiting-confirmation'
+    | 'installing'
+    | 'completed'
+    | 'failed'
+    | 'cancelled'
 
 export interface PluginInstallProgressEvent {
   taskId: string

package/plugin/log/types.ts

@@ -30,9 +30,9 @@ export interface LogItem {
  * Minimal contract for plugin loggers so web 端只依赖接口定义
  */
 export interface IPluginLogger<TManager = unknown> {
-  info(...args: LogDataType[]): void
-  warn(...args: LogDataType[]): void
-  error(...args: LogDataType[]): void
-  debug(...args: LogDataType[]): void
-  getManager(): TManager
+  info: (...args: LogDataType[]) => void
+  warn: (...args: LogDataType[]) => void
+  error: (...args: LogDataType[]) => void
+  debug: (...args: LogDataType[]) => void
+  getManager: () => TManager
 }

package/plugin/node/index.ts

@@ -1,4 +1,4 @@
 export * from '..'
+export type { IPluginLogger, LogDataType, LogItem, LogLevel } from '../log/types'
 export { PluginLogger } from './logger'
 export { PluginLoggerManager } from './logger-manager'
-export type { LogLevel, LogItem, LogDataType, IPluginLogger } from '../log/types'

package/plugin/node/logger-manager.ts

@@ -1,7 +1,7 @@
-import fs from 'fs'
-import path from 'path'
-import { LogItem } from '../log/types'
-import { ITouchPlugin } from '..'
+import type { ITouchPlugin } from '..'
+import type { LogItem } from '../log/types'
+import fs from 'node:fs'
+import path from 'node:path'
 import { structuredStrictStringify } from '@talex-touch/utils'
 
 /**
@@ -28,7 +28,7 @@ export class PluginLoggerManager {
     this.onLogAppend = onLogAppend
     this.sessionStart = new Date().toISOString()
     const timestamp = this.sessionStart.replace(/[:.]/g, '-')
-    const sessionFolder = `${timestamp}_${pluginInfo.name.replace(/[^a-zA-Z0-9-_]/g, '_')}`
+    const sessionFolder = `${timestamp}_${pluginInfo.name.replace(/[^\w-]/g, '_')}`
 
     this.pluginLogDir = path.resolve(baseDir, 'logs', sessionFolder)
     this.sessionLogPath = path.resolve(this.pluginLogDir, 'session.log')
@@ -51,14 +51,17 @@ export class PluginLoggerManager {
    * Flushes all buffered log items to the current session log file.
    */
   flush(): void {
-    if (this.buffer.length === 0) return
-    const lines = this.buffer.map((item) => structuredStrictStringify(item)).join('\n') + '\n'
+    if (this.buffer.length === 0)
+      return
+    const lines = `${this.buffer.map(item => structuredStrictStringify(item)).join('\n')}\n`
     try {
       this.ensureLogEnvironment()
       fs.appendFileSync(this.sessionLogPath, lines)
       this.buffer = []
-    } catch (error) {
-      if ((error as NodeJS.ErrnoException)?.code !== 'ENOENT') throw error
+    }
+    catch (error) {
+      if ((error as NodeJS.ErrnoException)?.code !== 'ENOENT')
+        throw error
       // Directory or file was removed; rebuild and retry once.
       this.ensureLogEnvironment(true)
       fs.appendFileSync(this.sessionLogPath, lines)
@@ -105,8 +108,8 @@ export class PluginLoggerManager {
       features: this.pluginInfo.features.map(feature => ({
         id: feature.id,
         name: feature.name,
-        desc: feature.desc
-      }))
+        desc: feature.desc,
+      })),
     }
 
     fs.writeFileSync(this.pluginInfoPath, JSON.stringify(pluginInfo, null, 2))

package/plugin/node/logger.ts

@@ -1,5 +1,5 @@
-import { IPluginLogger, LogLevel, LogItem, LogDataType } from '../log/types'
-import { PluginLoggerManager } from './logger-manager'
+import type { IPluginLogger, LogDataType, LogItem, LogLevel } from '../log/types'
+import type { PluginLoggerManager } from './logger-manager'
 import chalk from 'chalk'
 
 /**
@@ -71,7 +71,7 @@ export class PluginLogger implements IPluginLogger<PluginLoggerManager> {
       : 'INFO')
     if (resolvedLevel === 'INFO' && normalizedLevel !== 'INFO') {
       console.warn(
-        `${chalk.bgMagenta('[PluginLog]')} ${chalk.bgYellow('WARN')} ${this.pluginName} - Unknown log level "${String(level)}", fallback to INFO`
+        `${chalk.bgMagenta('[PluginLog]')} ${chalk.bgYellow('WARN')} ${this.pluginName} - Unknown log level "${String(level)}", fallback to INFO`,
       )
     }
 
@@ -79,7 +79,7 @@ export class PluginLogger implements IPluginLogger<PluginLoggerManager> {
       INFO: chalk.bgBlue,
       WARN: chalk.bgYellow,
       ERROR: chalk.bgRed,
-      DEBUG: chalk.bgGray
+      DEBUG: chalk.bgGray,
     }
     const colorize = levelColorMap[resolvedLevel] ?? ((input: string) => input)
 
@@ -96,14 +96,14 @@ export class PluginLogger implements IPluginLogger<PluginLoggerManager> {
     if (resolvedLevel === 'DEBUG') {
       console.debug(
         `${chalk.bgMagenta('[PluginLog]')} ${colorize(resolvedLevel)} ${this.pluginName} - ${message}`,
-        ...data
+        ...data,
       )
-    } else {
+    }
+    else {
       console.log(
         `${chalk.bgMagenta('[PluginLog]')} ${colorize(resolvedLevel)} ${this.pluginName} - ${message}`,
-        ...data
+        ...data,
       )
     }
-
   }
 }

package/plugin/plugin-source.ts

@@ -1,4 +1,4 @@
-import { IManifest } from '@talex-touch/utils/plugin'
+import type { IManifest } from '@talex-touch/utils/plugin'
 
 /**
  * Interface for plugin download options.
@@ -7,15 +7,15 @@ export interface IDownloadOptions {
   /**
    * Timeout configuration for download in milliseconds.
    */
-  timeout?: number;
+  timeout?: number
   /**
    * List of fallback download URLs.
    */
-  fallbackUrls?: string[];
+  fallbackUrls?: string[]
   /**
    * Callback function for download progress, with progress value (0-100).
    */
-  onProgress?: (progress: number) => void;
+  onProgress?: (progress: number) => void
 }
 
 /**
@@ -25,7 +25,7 @@ export interface IDownloadResult {
   /**
    * Local file path after download, which can be the plugin's compressed package or the unzipped folder path.
    */
-  filePath?: string;
+  filePath?: string
 }
 
 /**
@@ -43,16 +43,16 @@ export interface IPluginSource {
    * Get the name of the plugin source.
    * @returns The name of the plugin source.
    */
-  getSourceName(): string;
+  getSourceName: () => string
   /**
    * Get the description of the plugin source.
    * @returns The description of the plugin source.
    */
-  getSourceDesc(): string;
+  getSourceDesc: () => string
   /**
    * Timestamp of the last update for this plugin source.
    */
-  lastUpdateTime?: number;
+  lastUpdateTime?: number
 
   /**
    * Attempts to resolve a plugin manifest from the specified path or URL.
@@ -62,7 +62,7 @@ export interface IPluginSource {
    * @param options Resolution options.
    * @returns A Promise containing the plugin manifest, or undefined if resolution fails.
    */
-  resolveManifest(sourcePath: string, options?: IResolveManifestOptions): Promise<IManifest | undefined>
+  resolveManifest: (sourcePath: string, options?: IResolveManifestOptions) => Promise<IManifest | undefined>
 
   /**
    * Downloads the plugin source.
@@ -70,5 +70,5 @@ export interface IPluginSource {
    * @param options Download options.
    * @returns A Promise containing the download result. The filePath must be the path to the plugin's compressed package or unzipped folder.
    */
-  downloadPlugin(sourceUrl: string, options?: IDownloadOptions): Promise<IDownloadResult>
-}
+  downloadPlugin: (sourceUrl: string, options?: IDownloadOptions) => Promise<IDownloadResult>
+}