@talex-touch/utils 1.0.42 → 1.0.45

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

@@ -1,3 +1,58 @@
+import type {
+  CoreBoxCanvasConfig,
+  CoreBoxThemeConfig,
+  LayoutAtomConfig,
+  LayoutCanvasConfig,
+} from './layout-atom-types'
+
+/** Default layout atom for 'simple' preset */
+const defaultLayoutAtomSimple: LayoutAtomConfig = {
+  preset: 'simple',
+  header: { border: 'solid', opacity: 1, height: 26, blur: false },
+  aside: { position: 'left', width: 68, border: 'solid', opacity: 0.5, collapsed: false },
+  view: { radius: [0, 0, 0, 0], shadow: 'none', padding: 0, background: 'transparent' },
+  nav: { style: 'icon', activeIndicator: 'dot' },
+}
+
+/** Default CoreBox theme */
+const defaultCoreBoxTheme: CoreBoxThemeConfig = {
+  preset: 'default',
+  logo: { position: 'left', size: 24, style: 'default' },
+  input: { border: 'bottom', radius: 8, background: 'transparent' },
+  results: { itemRadius: 6, itemPadding: 8, divider: false, hoverStyle: 'background' },
+  container: { radius: 0, shadow: 'none', border: false },
+}
+
+const defaultLayoutCanvasConfig: LayoutCanvasConfig = {
+  enabled: false,
+  preset: 'simple',
+  columns: 12,
+  rowHeight: 24,
+  gap: 8,
+  items: [
+    { id: 'header', area: 'header', x: 0, y: 0, w: 12, h: 2, minW: 6, minH: 1 },
+    { id: 'aside', area: 'aside', x: 0, y: 2, w: 2, h: 10, minW: 1, minH: 4 },
+    { id: 'view', area: 'view', x: 2, y: 2, w: 10, h: 10, minW: 4, minH: 4 },
+  ],
+}
+
+const defaultCoreBoxCanvasConfig: CoreBoxCanvasConfig = {
+  enabled: false,
+  preset: 'default',
+  columns: 12,
+  rowHeight: 24,
+  gap: 8,
+  items: [
+    { id: 'logo', area: 'logo', x: 0, y: 0, w: 1, h: 1, minW: 1, minH: 1 },
+    { id: 'input', area: 'input', x: 1, y: 0, w: 9, h: 1, minW: 4, minH: 1 },
+    { id: 'actions', area: 'actions', x: 10, y: 0, w: 2, h: 1, minW: 1, minH: 1 },
+    { id: 'tags', area: 'tags', x: 1, y: 1, w: 11, h: 1, minW: 4, minH: 1 },
+    { id: 'results', area: 'results', x: 0, y: 2, w: 10, h: 8, minW: 5, minH: 4 },
+    { id: 'addon', area: 'addon', x: 10, y: 2, w: 2, h: 8, minW: 2, minH: 4 },
+    { id: 'footer', area: 'footer', x: 0, y: 10, w: 10, h: 1, minW: 4, minH: 1 },
+  ],
+}
+
 /**
  * Default configuration object for application settings
  */
@@ -9,8 +64,91 @@ const _appSettingOriginData = {
     syncLatest: false,
     dataSync: false,
   },
+  sync: {
+    /**
+     * Whether sync is currently enabled.
+     * Login flow will auto-enable this unless the user has overridden it.
+     */
+    enabled: false,
+    /**
+     * Whether user manually changed sync preference.
+     * Once true, login auto-enable will no longer override this choice.
+     */
+    userOverridden: false,
+    /**
+     * Timestamp when sync was auto-enabled by login flow.
+     */
+    autoEnabledAt: '',
+    /**
+     * Timestamp of latest successful sync-related activity.
+     * Used for user-facing status display (best-effort, client-side).
+     */
+    lastActivityAt: '',
+    /**
+     * Timestamp of latest successful push activity.
+     */
+    lastPushAt: '',
+    /**
+     * Timestamp of latest successful pull activity.
+     */
+    lastPullAt: '',
+    /**
+     * Runtime sync status for UI visibility.
+     */
+    status: 'idle' as 'idle' | 'syncing' | 'paused' | 'error',
+    /**
+     * Timestamp of latest successful sync task (pull or push).
+     */
+    lastSuccessAt: '',
+    /**
+     * Timestamp of latest sync error.
+     */
+    lastErrorAt: '',
+    /**
+     * Latest sync error code.
+     */
+    lastErrorCode: '',
+    /**
+     * Latest sync error message.
+     */
+    lastErrorMessage: '',
+    /**
+     * Consecutive sync failure counter.
+     */
+    consecutiveFailures: 0,
+    /**
+     * Pending sync queue depth (best-effort).
+     */
+    queueDepth: 0,
+    /**
+     * Next scheduled pull timestamp.
+     */
+    nextPullAt: '',
+    /**
+     * Latest pulled cursor for incremental sync.
+     */
+    cursor: 0,
+    /**
+     * Local op sequence for push ordering.
+     */
+    opSeq: 0,
+    /**
+     * Timestamp of latest conflict observed during push.
+     */
+    lastConflictAt: '',
+    /**
+     * Count of latest conflicts observed during push.
+     */
+    lastConflictCount: 0,
+    /**
+     * If sync is blocked by a policy/error class.
+     */
+    blockedReason: '' as '' | 'quota' | 'device' | 'auth',
+  },
   dev: {
     autoCloseDev: true,
+    authServer: 'production' as 'production' | 'local',
+    developerMode: false,
   },
   lang: {
     followSystem: true,
@@ -25,6 +163,31 @@ const _appSettingOriginData = {
   beginner: {
     init: false,
   },
+  security: {
+    /**
+     * 本地随机种子，用于生成 machine_code_hash。
+     * 只存本地；用户清空应用数据后自然会重置（符合“删除数据即删除机器码”语义）。
+     */
+    machineSeed: '',
+    /**
+     * 最近一次已上报的 machine_code_hash（用于避免重复上报）。
+     * 注意：这是 hash（摘要），不含原始硬件信息。
+     */
+    machineCodeHash: '',
+    /**
+     * 最近一次上报时间（ISO 字符串，可选，仅用于调试/排查）。
+     */
+    machineCodeAttestedAt: '',
+    /**
+     * 明文 seed 迁移完成时间（用于排查历史版本遗留）。
+     */
+    machineSeedMigratedAt: '',
+    /**
+     * 安全回退开关：当系统安全存储不可用时，是否允许继续使用明文 seed。
+     * 默认关闭，避免退回不安全路径。
+     */
+    allowLegacyMachineSeedFallback: false,
+  },
   tools: {
     autoPaste: {
       enable: true,
@@ -32,6 +195,13 @@ const _appSettingOriginData = {
     },
     autoHide: true,
     autoClear: 600,
+    clipboardPolling: {
+      interval: 5,
+      lowBatteryPolicy: {
+        enable: true,
+        interval: 10,
+      },
+    },
   },
   dashboard: {
     enable: false,
@@ -39,6 +209,63 @@ const _appSettingOriginData = {
   searchEngine: {
     logsEnabled: false,
   },
+  diagnostics: {
+    verboseLogs: false,
+  },
+  recommendation: {
+    enabled: true,
+    maxItems: 10,
+    showReason: true,
+  },
+  animation: {
+    listItemStagger: false,
+    resultTransition: false,
+    coreBoxResize: false,
+    autoDisableOnLowBattery: true,
+    lowBatteryThreshold: 20,
+  },
+  viewCache: {
+    maxCachedViews: 4,
+    hotCacheDurationMs: 120000,
+  },
+  background: {
+    /** 背景图来源: 'none' | 'bing' | 'custom' | 'folder' | 'desktop' */
+    source: 'none' as 'none' | 'bing' | 'custom' | 'folder' | 'desktop',
+    /** 自定义背景图路径 */
+    customPath: '',
+    /** 文件夹路径 */
+    folderPath: '',
+    /** 文件夹轮播间隔（分钟） */
+    folderIntervalMinutes: 30,
+    /** 文件夹轮播是否随机 */
+    folderRandom: true,
+    /** 背景图模糊度 0-20 */
+    blur: 0,
+    /** 背景图透明度 10-100 */
+    opacity: 100,
+    /** 背景图滤镜 */
+    filter: {
+      brightness: 100,
+      contrast: 100,
+      saturate: 100,
+    },
+    /** 桌面壁纸路径 */
+    desktopPath: '',
+    /** 壁纸库信息 */
+    library: {
+      enabled: false,
+      folderStoredPath: '',
+      fileStoredPath: '',
+    },
+    /** 云同步配置 */
+    sync: {
+      enabled: false,
+    },
+  },
+  coreBox: {
+    /** 自定义 placeholder 文本，空则使用默认 */
+    customPlaceholder: '',
+  },
   window: {
     closeToTray: true,
     startMinimized: false,
@@ -55,6 +282,24 @@ const _appSettingOriginData = {
     customDesktop: false,
   },
   layout: 'simple',
+  layoutAtomConfig: defaultLayoutAtomSimple,
+  coreBoxThemeConfig: defaultCoreBoxTheme,
+  layoutCanvasConfig: defaultLayoutCanvasConfig,
+  coreBoxCanvasConfig: defaultCoreBoxCanvasConfig,
+  presetState: {
+    lastRemotePresetId: '',
+    lastRemotePresetName: '',
+    lastRemotePresetChannel: 'beta' as 'stable' | 'beta',
+    lastRemotePresetAppliedAt: '',
+    rollbackSnapshot: null as null | {
+      layout: string
+      layoutAtomConfig: LayoutAtomConfig
+      coreBoxThemeConfig: CoreBoxThemeConfig
+      layoutCanvasConfig: LayoutCanvasConfig
+      coreBoxCanvasConfig: CoreBoxCanvasConfig
+      themeStyle?: Record<string, unknown>
+    },
+  },
 }
 
 export const appSettingOriginData = Object.freeze(_appSettingOriginData)

package/common/storage/entity/index.ts

@@ -1,2 +1,5 @@
 export * from './app-settings'
+export * from './layout-atom-types'
 export * from './openers'
+export * from './preset-cloud-api'
+export * from './preset-export-types'

package/common/storage/entity/layout-atom-types.ts

@@ -0,0 +1,147 @@
+/**
+ * Layout atom configuration for app layout customization.
+ * Used for atomic layout styling (header, aside, view, nav).
+ */
+export interface LayoutAtomConfig {
+  preset: string | 'custom'
+
+  header: {
+    border: 'solid' | 'none' | 'gradient'
+    opacity: number
+    height: number
+    blur: boolean
+  }
+
+  aside: {
+    position: 'left' | 'right' | 'bottom' | 'hidden'
+    width: number
+    border: 'solid' | 'none'
+    opacity: number
+    collapsed: boolean
+  }
+
+  view: {
+    radius: [number, number, number, number]
+    shadow: 'none' | 'sm' | 'md' | 'lg'
+    padding: number
+    background: 'transparent' | 'solid' | 'blur'
+  }
+
+  nav: {
+    style: 'icon' | 'icon-text' | 'text'
+    activeIndicator: 'dot' | 'bar' | 'background' | 'none'
+  }
+
+  customCSS?: string
+}
+
+/**
+ * CoreBox theme configuration for search box UI customization.
+ */
+export interface CoreBoxThemeConfig {
+  preset: string | 'custom'
+
+  logo: {
+    position: 'left' | 'right' | 'hidden'
+    size: number
+    style: 'default' | 'circle' | 'rounded'
+  }
+
+  input: {
+    border: 'none' | 'bottom' | 'full'
+    radius: number
+    background: 'transparent' | 'subtle' | 'solid'
+  }
+
+  results: {
+    itemRadius: number
+    itemPadding: number
+    divider: boolean
+    hoverStyle: 'background' | 'border' | 'scale'
+  }
+
+  container: {
+    radius: number
+    shadow: 'none' | 'sm' | 'md' | 'lg'
+    border: boolean
+  }
+
+  customCSS?: string
+}
+
+export type ThemeWindowStyle = 'Default' | 'Mica' | 'Filter'
+export type ThemeRouteTransitionStyle = 'slide' | 'fade' | 'zoom'
+
+/**
+ * Theme-level preset fields used by preset v2.
+ */
+export interface ThemePresetConfig {
+  window?: ThemeWindowStyle
+  style?: {
+    dark: boolean
+    auto: boolean
+  }
+  addon?: {
+    contrast: boolean
+    coloring: boolean
+  }
+  transition?: {
+    route: ThemeRouteTransitionStyle
+  }
+  palette?: {
+    primary?: string
+    accent?: string
+    surface?: string
+    text?: string
+  }
+}
+
+export interface LayoutCanvasItem {
+  id: string
+  area: 'header' | 'aside' | 'view' | 'nav' | 'plugins' | 'title' | 'icon'
+  x: number
+  y: number
+  w: number
+  h: number
+  minW?: number
+  minH?: number
+  maxW?: number
+  maxH?: number
+  visible?: boolean
+}
+
+export interface LayoutCanvasConfig {
+  enabled: boolean
+  preset: string | 'custom'
+  columns: number
+  rowHeight: number
+  gap: number
+  items: LayoutCanvasItem[]
+  colorVars?: Record<string, string>
+  customCSS?: string
+}
+
+export interface CoreBoxCanvasItem {
+  id: string
+  area: 'logo' | 'input' | 'tags' | 'actions' | 'results' | 'footer' | 'addon'
+  x: number
+  y: number
+  w: number
+  h: number
+  minW?: number
+  minH?: number
+  maxW?: number
+  maxH?: number
+  visible?: boolean
+}
+
+export interface CoreBoxCanvasConfig {
+  enabled: boolean
+  preset: string | 'custom'
+  columns: number
+  rowHeight: number
+  gap: number
+  items: CoreBoxCanvasItem[]
+  colorVars?: Record<string, string>
+  customCSS?: string
+}

package/common/storage/entity/openers.ts

@@ -26,6 +26,7 @@ export interface OpenerInfo {
 }
 
 export type OpenersMap = Record<string, OpenerInfo>
+export type OpenersConfig = OpenersMap
 
 const _openersOriginData: OpenersMap = {}
 

package/common/storage/entity/preset-cloud-api.ts

@@ -0,0 +1,132 @@
+import type { CloudPresetItem, CloudPresetListResponse, CloudPresetPublishRequest, PresetExportData } from './preset-export-types'
+
+/**
+ * Cloud preset API endpoints (for future implementation)
+ */
+export const PRESET_CLOUD_API = {
+  /** Base URL for preset cloud service */
+  baseUrl: 'https://api.talextouch.com/v1/presets',
+
+  /** List public presets */
+  list: '/list',
+
+  /** Get single preset by ID */
+  get: (id: string) => `/${id}`,
+
+  /** Publish a preset */
+  publish: '/publish',
+
+  /** Like a preset */
+  like: (id: string) => `/${id}/like`,
+
+  /** Download a preset */
+  download: (id: string) => `/${id}/download`,
+
+  /** Delete a preset (owner only) */
+  delete: (id: string) => `/${id}`,
+
+  /** Update a preset (owner only) */
+  update: (id: string) => `/${id}`,
+
+  /** Get user's own presets */
+  myPresets: '/my'
+} as const
+
+/**
+ * Cloud preset service interface (for future implementation)
+ */
+export interface IPresetCloudService {
+  /** List public presets with pagination */
+  listPresets(options?: {
+    page?: number
+    pageSize?: number
+    sort?: 'popular' | 'recent' | 'likes'
+    tags?: string[]
+    search?: string
+  }): Promise<CloudPresetListResponse>
+
+  /** Get single preset by ID */
+  getPreset(id: string): Promise<PresetExportData | null>
+
+  /** Publish a preset to the cloud */
+  publishPreset(request: CloudPresetPublishRequest): Promise<CloudPresetItem>
+
+  /** Like a preset */
+  likePreset(id: string): Promise<{ liked: boolean; likes: number }>
+
+  /** Download a preset (increments download count) */
+  downloadPreset(id: string): Promise<PresetExportData>
+
+  /** Delete a preset (owner only) */
+  deletePreset(id: string): Promise<boolean>
+
+  /** Update a preset (owner only) */
+  updatePreset(id: string, preset: PresetExportData): Promise<CloudPresetItem>
+
+  /** Get user's own presets */
+  getMyPresets(): Promise<CloudPresetItem[]>
+}
+
+/**
+ * Cloud service status
+ */
+export interface PresetCloudStatus {
+  /** Whether cloud service is available */
+  available: boolean
+  /** Error message if unavailable */
+  error?: string
+  /** User authentication status */
+  authenticated: boolean
+}
+
+/**
+ * Placeholder cloud service (returns unavailable)
+ * Will be replaced with actual implementation when cloud service is ready
+ */
+export class PresetCloudServicePlaceholder implements IPresetCloudService {
+  private readonly notAvailableError = new Error('Cloud preset service is not yet available')
+
+  async listPresets(): Promise<CloudPresetListResponse> {
+    throw this.notAvailableError
+  }
+
+  async getPreset(): Promise<PresetExportData | null> {
+    throw this.notAvailableError
+  }
+
+  async publishPreset(): Promise<CloudPresetItem> {
+    throw this.notAvailableError
+  }
+
+  async likePreset(): Promise<{ liked: boolean; likes: number }> {
+    throw this.notAvailableError
+  }
+
+  async downloadPreset(): Promise<PresetExportData> {
+    throw this.notAvailableError
+  }
+
+  async deletePreset(): Promise<boolean> {
+    throw this.notAvailableError
+  }
+
+  async updatePreset(): Promise<CloudPresetItem> {
+    throw this.notAvailableError
+  }
+
+  async getMyPresets(): Promise<CloudPresetItem[]> {
+    throw this.notAvailableError
+  }
+
+  /** Check if cloud service is available */
+  getStatus(): PresetCloudStatus {
+    return {
+      available: false,
+      error: 'Cloud preset service is coming soon',
+      authenticated: false
+    }
+  }
+}
+
+/** Singleton placeholder instance */
+export const presetCloudService = new PresetCloudServicePlaceholder()