@talex-touch/utils 1.0.31 → 1.0.33

package/core-box/index.ts

@@ -1,10 +1,8 @@
+export * from './builder/index'
+export * from './preview/index'
 /**
  * Core Box Package
  * Search box core functionality package
  */
-
-// 导出 TUFF DSL 相关内容
-export * from './tuff/index.js';
-
-// 导出 TUFF Builder 相关内容
-export * from './builder/index.js';
+export * from './tuff/index'
+export * from './recommendation'

package/core-box/preview/index.ts

@@ -0,0 +1 @@
+export * from './types'

package/core-box/preview/types.ts

@@ -0,0 +1,43 @@
+export interface PreviewCardRow {
+  label: string
+  value: string
+  description?: string
+  copyable?: boolean
+  emphasize?: boolean
+}
+
+export interface PreviewCardSection {
+  title?: string
+  rows: PreviewCardRow[]
+}
+
+export interface PreviewCardChip {
+  label: string
+  value: string
+}
+
+export interface PreviewCardPayload {
+  abilityId: string
+  title: string
+  subtitle?: string
+  primaryValue: string
+  primaryLabel?: string
+  primaryUnit?: string
+  secondaryValue?: string
+  secondaryLabel?: string
+  description?: string
+  accentColor?: string
+  badges?: string[]
+  chips?: PreviewCardChip[]
+  sections?: PreviewCardSection[]
+  warnings?: string[]
+  meta?: Record<string, any>
+  confidence?: number
+}
+
+export interface PreviewAbilityResult {
+  abilityId: string
+  confidence: number
+  payload: PreviewCardPayload
+  durationMs?: number
+}

package/core-box/recommendation.ts

@@ -0,0 +1,77 @@
+/**
+ * Time-based usage pattern context for recommendation matching.
+ */
+export interface TimePattern {
+  /** Hour of day (0-23) */
+  hourOfDay: number
+  /** Day of week (0-6, 0=Sunday) */
+  dayOfWeek: number
+  /** Whether current time falls within working hours (9-18, weekdays) */
+  isWorkingHours: boolean
+  /** Broad time categorization */
+  timeSlot: 'morning' | 'afternoon' | 'evening' | 'night'
+}
+
+/**
+ * Complete contextual signal for recommendation matching.
+ * Gathered from system state, clipboard, and active applications.
+ */
+export interface ContextSignal {
+  time: TimePattern
+  clipboard?: {
+    type: string
+    /** Hashed content for privacy (not original text) */
+    content: string
+    timestamp: number
+    contentType?: 'url' | 'text' | 'code' | 'file'
+    meta?: {
+      isUrl?: boolean
+      urlDomain?: string
+      textLength?: number
+      fileExtension?: string
+      fileType?: 'code' | 'text' | 'image' | 'document' | 'other'
+      language?: string
+    }
+  }
+  foregroundApp?: {
+    bundleId: string
+    name: string
+  }
+  systemState?: {
+    isOnline: boolean
+    batteryLevel: number
+    isDNDEnabled: boolean
+  }
+}
+
+/**
+ * Scored recommendation item from recommendation engine.
+ */
+export interface ScoredItem {
+  sourceId: string
+  itemId: string
+  score: number
+  source: 'frequent' | 'time-based' | 'recent' | 'trending' | 'context'
+  reason?: string
+}
+
+/**
+ * Recommendation badge display configuration for UI rendering.
+ */
+export interface RecommendationBadge {
+  text: string
+  icon: string
+  variant: 'frequent' | 'intelligent' | 'recent' | 'trending'
+}
+
+/**
+ * Enhanced item metadata for intelligent recommendations.
+ * Attached to TuffItem.meta for rendering and filtering.
+ */
+export interface RecommendationMetadata {
+  score: number
+  source: ScoredItem['source']
+  reason: string
+  isIntelligent: boolean
+  badge: RecommendationBadge
+}

package/core-box/tuff/index.ts

@@ -3,4 +3,4 @@
  * Typed Unified Flex Format 数据结构定义
  */
 
-export * from './tuff-dsl';
+export * from './tuff-dsl'