@talex-touch/utils 1.0.40 → 1.0.44

package/types/division-box.ts

@@ -1,6 +1,6 @@
 /**
  * DivisionBox Type Definitions
- * 
+ *
  * Shared types for DivisionBox system across main and renderer processes.
  * These types define the contract for inter-process communication and state management.
  */
@@ -15,7 +15,7 @@ export enum DivisionBoxState {
   ACTIVE = 'active',
   INACTIVE = 'inactive',
   DETACH = 'detach',
-  DESTROY = 'destroy'
+  DESTROY = 'destroy',
 }
 
 /**
@@ -29,7 +29,7 @@ export enum DivisionBoxErrorCode {
   CONFIG_ERROR = 'CONFIG_ERROR',
   INVALID_TRANSITION = 'INVALID_TRANSITION',
   SESSION_NOT_FOUND = 'SESSION_NOT_FOUND',
-  LIMIT_EXCEEDED = 'LIMIT_EXCEEDED'
+  LIMIT_EXCEEDED = 'LIMIT_EXCEEDED',
 }
 
 /**
@@ -43,7 +43,7 @@ export const ERROR_MESSAGES: Record<DivisionBoxErrorCode, string> = {
   [DivisionBoxErrorCode.CONFIG_ERROR]: 'Invalid configuration provided',
   [DivisionBoxErrorCode.INVALID_TRANSITION]: 'Invalid state transition attempted',
   [DivisionBoxErrorCode.SESSION_NOT_FOUND]: 'Session not found',
-  [DivisionBoxErrorCode.LIMIT_EXCEEDED]: 'Resource limit exceeded'
+  [DivisionBoxErrorCode.LIMIT_EXCEEDED]: 'Resource limit exceeded',
 }
 
 /**
@@ -54,13 +54,13 @@ export class DivisionBoxError extends Error {
     public readonly code: DivisionBoxErrorCode,
     message: string,
     public readonly sessionId?: string,
-    public readonly timestamp: number = Date.now()
+    public readonly timestamp: number = Date.now(),
   ) {
     super(message)
     this.name = 'DivisionBoxError'
     Error.captureStackTrace(this, DivisionBoxError)
   }
-  
+
   /**
    * Gets a user-friendly error message
    */
@@ -93,31 +93,51 @@ export interface HeaderConfig {
  */
 export type DivisionBoxSize = 'compact' | 'medium' | 'expanded'
 
+/**
+ * UI configuration for DivisionBox CoreBox header
+ */
+export interface DivisionBoxUIConfig {
+  /** Show the search input in header */
+  showInput?: boolean
+
+  /** Placeholder text for search input */
+  inputPlaceholder?: string
+
+  /** Show result list area */
+  showResults?: boolean
+
+  /** Initial input value */
+  initialInput?: string
+}
+
 /**
  * Configuration for creating a DivisionBox instance
  */
 export interface DivisionBoxConfig {
   /** URL to load in the WebContentsView */
   url: string
-  
+
   /** Associated plugin ID (optional) */
   pluginId?: string
-  
+
   /** Display title */
   title: string
-  
+
   /** Icon (supports iconify format) */
   icon?: string
-  
+
   /** Size preset */
   size?: DivisionBoxSize
-  
+
   /** Enable keepAlive caching mode */
   keepAlive?: boolean
-  
+
   /** Header configuration */
   header?: HeaderConfig
-  
+
+  /** UI configuration for CoreBox header display */
+  ui?: DivisionBoxUIConfig
+
   /** WebContentsView preferences (main process only) */
   webPreferences?: any
 }
@@ -128,22 +148,22 @@ export interface DivisionBoxConfig {
 export interface SessionMeta {
   /** Associated plugin ID */
   pluginId?: string
-  
+
   /** Display title */
   title: string
-  
+
   /** Icon */
   icon?: string
-  
+
   /** Size preset */
   size: DivisionBoxSize
-  
+
   /** KeepAlive mode enabled */
   keepAlive: boolean
-  
+
   /** Creation timestamp */
   createdAt: number
-  
+
   /** Last accessed timestamp */
   lastAccessedAt: number
 }
@@ -164,13 +184,13 @@ export interface DivisionBoxBounds {
 export interface SessionInfo {
   /** Unique session identifier */
   sessionId: string
-  
+
   /** Current lifecycle state */
   state: DivisionBoxState
-  
+
   /** Session metadata */
   meta: SessionMeta
-  
+
   /** Position and size bounds */
   bounds?: DivisionBoxBounds
 }
@@ -181,10 +201,10 @@ export interface SessionInfo {
 export interface CloseOptions {
   /** Delay before closing (milliseconds) */
   delay?: number
-  
+
   /** Play closing animation */
   animation?: boolean
-  
+
   /** Force close (ignore keepAlive) */
   force?: boolean
 }
@@ -209,7 +229,7 @@ export enum DivisionBoxIPCChannel {
   UPDATE_STATE = 'division-box:update-state',
   GET_ACTIVE_SESSIONS = 'division-box:get-active-sessions',
   STATE_CHANGED = 'division-box:state-changed',
-  SESSION_DESTROYED = 'division-box:session-destroyed'
+  SESSION_DESTROYED = 'division-box:session-destroyed',
 }
 
 /**
@@ -232,10 +252,10 @@ export interface IPCResponse<T = any> {
 export interface ManifestDivisionBoxConfig {
   /** Default size preset for DivisionBox instances */
   defaultSize?: DivisionBoxSize
-  
+
   /** Enable keepAlive caching mode by default */
   keepAlive?: boolean
-  
+
   /** Default header configuration */
   header?: {
     /** Whether to show the header by default */

package/types/download.ts

@@ -81,6 +81,7 @@ export interface DownloadTask {
   metadata: Record<string, any>
   createdAt: Date
   updatedAt: Date
+  completedAt?: Date
   error?: string
 }
 

package/types/flow.ts

@@ -15,16 +15,16 @@ export type FlowPayloadType = 'text' | 'image' | 'files' | 'json' | 'html' | 'cu
 /**
  * Flow session states
  */
-export type FlowSessionState =
-  | 'INIT'
-  | 'TARGET_SELECTING'
-  | 'TARGET_SELECTED'
-  | 'DELIVERING'
-  | 'DELIVERED'
-  | 'PROCESSING'
-  | 'ACKED'
-  | 'FAILED'
-  | 'CANCELLED'
+export type FlowSessionState
+  = | 'INIT'
+    | 'TARGET_SELECTING'
+    | 'TARGET_SELECTED'
+    | 'DELIVERING'
+    | 'DELIVERED'
+    | 'PROCESSING'
+    | 'ACKED'
+    | 'FAILED'
+    | 'CANCELLED'
 
 /**
  * Flow error codes
@@ -39,7 +39,7 @@ export enum FlowErrorCode {
   PERMISSION_DENIED = 'PERMISSION_DENIED',
   TIMEOUT = 'TIMEOUT',
   CANCELLED = 'CANCELLED',
-  INTERNAL_ERROR = 'INTERNAL_ERROR'
+  INTERNAL_ERROR = 'INTERNAL_ERROR',
 }
 
 /**
@@ -150,6 +150,15 @@ export interface FlowTargetInfo extends FlowTarget {
   /** Whether the plugin is currently enabled */
   isEnabled: boolean
 
+  /** Whether plugin has registered onFlowTransfer handler */
+  hasFlowHandler: boolean
+
+  /** Whether this is a native system share target */
+  isNativeShare?: boolean
+
+  /** Adaptation status message (for unhandled plugins) */
+  adaptationHint?: string
+
   /** Recent usage count */
   usageCount?: number
 
@@ -219,6 +228,9 @@ export interface FlowDispatchOptions {
 
   /** Whether acknowledgment is required */
   requireAck?: boolean
+
+  /** Consent token for one-time authorization */
+  consentToken?: string
 }
 
 /**
@@ -268,7 +280,7 @@ export enum FlowIPCChannel {
   ACKNOWLEDGE = 'flow:acknowledge',
   REPORT_ERROR = 'flow:report-error',
   SESSION_UPDATE = 'flow:session-update',
-  DELIVER = 'flow:deliver'
+  DELIVER = 'flow:deliver',
 }
 
 /**
@@ -281,3 +293,42 @@ export interface FlowManifestConfig {
   /** Flow targets this plugin can receive */
   flowTargets?: FlowTarget[]
 }
+
+/**
+ * Native share target types
+ */
+export type NativeShareTarget = 'system' | 'airdrop' | 'mail' | 'messages'
+
+/**
+ * Native share options
+ */
+export interface NativeShareOptions {
+  /** Share title */
+  title?: string
+
+  /** Share text content */
+  text?: string
+
+  /** Share URL */
+  url?: string
+
+  /** File paths to share */
+  files?: string[]
+
+  /** Preferred native target (optional) */
+  target?: NativeShareTarget
+}
+
+/**
+ * Native share result
+ */
+export interface NativeShareResult {
+  /** Whether share was successful */
+  success: boolean
+
+  /** Target used (if known) */
+  target?: string
+
+  /** Error message if failed */
+  error?: string
+}

package/types/icon.ts

@@ -12,8 +12,9 @@
  * - 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")
+ * - builtin: Built-in icons (e.g., "chevron-down", "close", "search")
  */
-export type TuffIconType = 'emoji' | 'url' | 'file' | 'class'
+export type TuffIconType = 'emoji' | 'url' | 'file' | 'class' | 'builtin'
 
 /**
  * Icon status enumeration

package/types/index.ts

@@ -1,6 +1,11 @@
+/// <reference path="./path-browserify.d.ts" />
+export * from './agent'
+export * from './cloud-sync'
 export * from './division-box'
 export * from './flow'
 export * from './intelligence'
 export * from './modules'
+export * from './platform'
+export * from './startup-info'
 export * from './storage'
 export * from './touch-app-core'