// This file has been generated by Tauri Specta. Do not edit this file manually.

import { invoke as __TAURI_INVOKE } from "@tauri-apps/api/core";

/** Commands */
export const commands = {
	proxyActivateProfile: (id: string) => __TAURI_INVOKE<null>("proxy_activate_profile", { id }),
	proxyCheckKernelUpdate: () => __TAURI_INVOKE<KernelUpdateInfo>("proxy_check_kernel_update"),
	proxyClearSystemProxy: () => __TAURI_INVOKE<null>("proxy_clear_system_proxy"),
	proxyCloseConnection: (id: string) => __TAURI_INVOKE<null>("proxy_close_connection", { id }),
	proxyDeleteProfile: (id: string) => __TAURI_INVOKE<null>("proxy_delete_profile", { id }),
	proxyGetSettings: () => __TAURI_INVOKE<ProxySettings>("proxy_get_settings"),
	proxyGetSystemProxy: () => __TAURI_INVOKE<boolean>("proxy_get_system_proxy"),
	proxyImportProfile: (url: string, name: string) => __TAURI_INVOKE<ProfileMeta>("proxy_import_profile", { url, name }),
	/**  首次安装内核（与 update_kernel 共用 install_kernel 实现，语义独立便于前端区分场景） */
	proxyInstallKernel: (mirrorPrefix: string | null) => __TAURI_INVOKE<KernelInfo>("proxy_install_kernel", { mirrorPrefix }),
	proxyKernelInfo: () => __TAURI_INVOKE<KernelInfo>("proxy_kernel_info"),
	proxyRestart: () => __TAURI_INVOKE<ProcessInfo>("proxy_restart"),
	proxySaveSettings: (settings: ProxySettings) => __TAURI_INVOKE<null>("proxy_save_settings", { settings }),
	proxySelectProxy: (group: string, name: string) => __TAURI_INVOKE<null>("proxy_select_proxy", { group, name }),
	proxySetSystemProxy: () => __TAURI_INVOKE<null>("proxy_set_system_proxy"),
	proxyStart: () => __TAURI_INVOKE<ProcessInfo>("proxy_start"),
	proxyStatus: () => __TAURI_INVOKE<ProxyStatus>("proxy_status"),
	proxyStop: () => __TAURI_INVOKE<null>("proxy_stop"),
	proxyTestDelay: (name: string, url: string | null, timeout: number | null) => __TAURI_INVOKE<number>("proxy_test_delay", { name, url, timeout }),
	proxyUpdateKernel: (mirrorPrefix: string | null) => __TAURI_INVOKE<KernelInfo>("proxy_update_kernel", { mirrorPrefix }),
	proxyUpdateProfile: (id: string) => __TAURI_INVOKE<ProfileMeta>("proxy_update_profile", { id }),
	/**  读取快速面板设置（快捷键等） */
	quickpanelGetSettings: () => __TAURI_INVOKE<QuickPanelSettings>("quickpanel_get_settings"),
	/**  保存快速面板设置；快捷键变化时自动重新注册 + 预创建窗口 */
	quickpanelSaveSettings: (settings: QuickPanelSettings) => __TAURI_INVOKE<null>("quickpanel_save_settings", { settings }),
	/**  注册（或切换）快速面板全局快捷键 */
	quickpanelRegisterShortcut: (shortcut: string) => __TAURI_INVOKE<null>("quickpanel_register_shortcut", { shortcut }),
	/**  注销快速面板全局快捷键 */
	quickpanelUnregisterShortcut: () => __TAURI_INVOKE<null>("quickpanel_unregister_shortcut"),
	/**  手动触发显示快速面板（供 UI 按钮调用） */
	quickpanelShowPopup: () => __TAURI_INVOKE<null>("quickpanel_show_popup"),
	/**  隐藏快速面板 */
	quickpanelHidePopup: () => __TAURI_INVOKE<null>("quickpanel_hide_popup"),
	/**  显示已创建的弹窗窗口（前端 onMounted 后调用） */
	quickpanelShowWindow: () => __TAURI_INVOKE<null>("quickpanel_show_window"),
	/**  锁定屏幕（Windows: rundll32 user32.dll,LockWorkStation，CREATE_NO_WINDOW 避免黑窗） */
	quickpanelLockScreen: () => __TAURI_INVOKE<null>("quickpanel_lock_screen"),
	/**  初始化文件索引数据库（应用启动时调用） */
	quickpanelInitFileIndex: () => __TAURI_INVOKE<null>("quickpanel_init_file_index"),
	/**  构建文件索引（全量重建，阻塞操作建议在 spawn_blocking 调用） */
	quickpanelBuildFileIndex: () => __TAURI_INVOKE<number>("quickpanel_build_file_index"),
	/**  搜索文件索引（SQLite 查询移出主线程） */
	quickpanelSearchFiles: (query: string, limit: number | null) => __TAURI_INVOKE<FileRecord[]>("quickpanel_search_files", { query, limit }),
	/**  获取索引状态 */
	quickpanelFileIndexStats: () => __TAURI_INVOKE<IndexStats>("quickpanel_file_index_stats"),
	/**  扫描已安装应用（遍历开始菜单/桌面/磁盘，移出主线程） */
	quickpanelScanApps: () => __TAURI_INVOKE<AppRecord[]>("quickpanel_scan_apps"),
	/**
	 *  获取应用图标（data URL）。命中内存/磁盘缓存时零 Windows API 调用。
	 *  前端按需为可见项调用，避免一次性加载全部图标。
	 *  未命中缓存时 SHGetFileInfoW + 编码 + 落盘为阻塞操作，移出主线程。
	 */
	quickpanelGetAppIcon: (path: string) => __TAURI_INVOKE<string | null>("quickpanel_get_app_icon", { path }),
	/**  清理图标缓存（磁盘 + 内存） */
	quickpanelClearAppIconCache: () => __TAURI_INVOKE<null>("quickpanel_clear_app_icon_cache"),
	/**  在资源管理器中显示文件（选中） */
	quickpanelRevealInExplorer: (path: string) => __TAURI_INVOKE<null>("quickpanel_reveal_in_explorer", { path }),
	/**
	 *  用系统默认程序打开文件/文件夹。
	 *  - 目录：explorer.exe 直接打开（修复索引目录点击后未打开的问题）
	 *  - 文件：ShellExecuteW open，无关联应用时自动 fallback 到「打开方式」对话框（verb: openas）
	 */
	quickpanelOpenFile: (path: string) => __TAURI_INVOKE<null>("quickpanel_open_file", { path }),
	/**  获取 Windows 常用快捷位置（hosts、回收站、此电脑、用户目录、系统管理工具等） */
	quickpanelGetSpecialLocations: () => __TAURI_INVOKE<SpecialLocation[]>("quickpanel_get_special_locations"),
	/**  打开快捷位置（kind: file | shell | cmd） */
	quickpanelOpenSpecial: (kind: string, target: string, args: string[]) => __TAURI_INVOKE<null>("quickpanel_open_special", { kind, target, args }),
	/**  删除文件（移到回收站，PowerShell 阻塞等待移出主线程） */
	quickpanelDeleteFile: (path: string) => __TAURI_INVOKE<null>("quickpanel_delete_file", { path }),
	/**
	 *  运行自定义命令（执行可执行文件 + 参数）
	 *  .lnk 快捷方式不能直接 spawn（os error 193），需通过 cmd /C 启动
	 */
	quickpanelRunCustomCommand: (command: string, args: string[]) => __TAURI_INVOKE<null>("quickpanel_run_custom_command", { command, args }),
	/**
	 *  运行系统命令（不设置 CREATE_NO_WINDOW，使 cmd/powershell/regedit 等显示自身窗口）
	 *  适用于内置系统工具：regedit、shutdown、cmd、powershell、taskmgr 等。
	 */
	quickpanelRunSystemCommand: (command: string, args: string[]) => __TAURI_INVOKE<null>("quickpanel_run_system_command", { command, args }),
	clipboardGetHistory: (limit: number | null, offset: number | null, kind: string | null) => __TAURI_INVOKE<HistoryPage>("clipboard_get_history", { limit, offset, kind }),
	clipboardGetPinned: () => __TAURI_INVOKE<ClipboardItem[]>("clipboard_get_pinned"),
	clipboardSearch: (query: string, limit: number | null, offset: number | null) => __TAURI_INVOKE<HistoryPage>("clipboard_search", { query, limit, offset }),
	clipboardGetItem: (id: number) => __TAURI_INVOKE<({
	/**  文本内容 / 文件列表 JSON */
	content: string | null,
	/**  图片 PNG base64（仅 image 类型） */
	imageBase64: string | null,
}) & (ClipboardItem) | null>("clipboard_get_item", { id }),
	clipboardSetPinned: (id: number, pinned: boolean) => __TAURI_INVOKE<boolean>("clipboard_set_pinned", { id, pinned }),
	clipboardDelete: (id: number) => __TAURI_INVOKE<boolean>("clipboard_delete", { id }),
	clipboardClear: () => __TAURI_INVOKE<boolean>("clipboard_clear"),
	clipboardCopyBack: (id: number) => __TAURI_INVOKE<null>("clipboard_copy_back", { id }),
	clipboardCount: () => __TAURI_INVOKE<number>("clipboard_count"),
	clipboardGetSettings: () => __TAURI_INVOKE<ClipboardSettings>("clipboard_get_settings"),
	clipboardSaveSettings: (settings: ClipboardSettings) => __TAURI_INVOKE<null>("clipboard_save_settings", { settings }),
	clipboardStatus: () => __TAURI_INVOKE<ClipboardStatus>("clipboard_status"),
	clipboardStart: () => __TAURI_INVOKE<null>("clipboard_start"),
	clipboardStop: () => __TAURI_INVOKE<null>("clipboard_stop"),
	/**  注册（或切换）快捷弹窗全局快捷键 */
	clipboardRegisterShortcut: (shortcut: string) => __TAURI_INVOKE<null>("clipboard_register_shortcut", { shortcut }),
	/**  注销快捷弹窗全局快捷键 */
	clipboardUnregisterShortcut: () => __TAURI_INVOKE<null>("clipboard_unregister_shortcut"),
	/**  手动触发显示快捷弹窗（供 UI 按钮调用） */
	clipboardShowPopup: () => __TAURI_INVOKE<null>("clipboard_show_popup"),
	/**  隐藏快捷弹窗 */
	clipboardHidePopup: () => __TAURI_INVOKE<null>("clipboard_hide_popup"),
	/**  显示已创建的弹窗窗口（前端 onMounted 后调用） */
	clipboardShowWindow: () => __TAURI_INVOKE<null>("clipboard_show_window"),
	/**  隐藏弹窗并模拟 Ctrl+V 粘贴到原窗口 */
	clipboardPasteToTarget: () => __TAURI_INVOKE<null>("clipboard_paste_to_target"),
	/**  获取所有任务 */
	downloaderGetTasks: () => __TAURI_INVOKE<DownloadTask[]>("downloader_get_tasks"),
	/**  检查 URL 重复性并探测文件信息（添加下载前调用） */
	downloaderCheckUrl: (url: string, dir: string | null, headers: { [key in string]: string } | null) => __TAURI_INVOKE<CheckUrlResult>("downloader_check_url", { url, dir, headers }),
	/**  添加下载任务 */
	downloaderAddTask: (url: string, filename: string | null, dir: string | null, headers: { [key in string]: string } | null, autoRename: boolean | null) => __TAURI_INVOKE<string>("downloader_add_task", { url, filename, dir, headers, autoRename }),
	/**  暂停任务 */
	downloaderPauseTask: (id: string) => __TAURI_INVOKE<null>("downloader_pause_task", { id }),
	/**  恢复任务 */
	downloaderResumeTask: (id: string) => __TAURI_INVOKE<null>("downloader_resume_task", { id }),
	/**  移除任务 */
	downloaderRemoveTask: (id: string, deleteFiles: boolean | null) => __TAURI_INVOKE<null>("downloader_remove_task", { id, deleteFiles }),
	/**  获取设置 */
	downloaderGetSettings: () => __TAURI_INVOKE<DownloaderSettings>("downloader_get_settings"),
	/**  保存设置 */
	downloaderSaveSettings: (settings: DownloaderSettings) => __TAURI_INVOKE<null>("downloader_save_settings", { settings }),
	/**  用系统资源管理器打开目录 */
	downloaderOpenDir: (path: string) => __TAURI_INVOKE<null>("downloader_open_dir", { path }),
	/**  用系统默认浏览器打开 URL */
	downloaderOpenUrl: (url: string) => __TAURI_INVOKE<null>("downloader_open_url", { url }),
	/**  禁用指定窗口（按 label 查找）的显示/隐藏过渡动画，消除覆盖层出现/消失时的缩放动画 */
	screenshotDisableTransitions: (label: string) => __TAURI_INVOKE<null>("screenshot_disable_transitions", { label }),
	/**  注册（或切换）截图全局快捷键。传入空字符串则禁用快捷键。 */
	screenshotRegisterShortcut: (shortcut: string) => __TAURI_INVOKE<null>("screenshot_register_shortcut", { shortcut }),
	/**  注销截图全局快捷键 */
	screenshotUnregisterShortcut: () => __TAURI_INVOKE<null>("screenshot_unregister_shortcut"),
	/**  捕获整个虚拟屏（多显示器拼接）存入静态，不做 PNG 编码 */
	screenshotCaptureFullscreen: () => __TAURI_INVOKE<null>("screenshot_capture_fullscreen"),
	/**  全屏捕获编码为 PNG base64 并清除（全屏截图直接进编辑器） */
	screenshotFullscreenPng: () => __TAURI_INVOKE<CaptureData>("screenshot_fullscreen_png"),
	/**  清除静态全屏捕获（覆盖层关闭/取消时释放内存） */
	screenshotClearFullscreen: () => __TAURI_INVOKE<null>("screenshot_clear_fullscreen"),
	/**  按物理像素坐标裁剪已存储的全屏捕获 */
	screenshotCropStored: (x: number, y: number, w: number, h: number) => __TAURI_INVOKE<CaptureData>("screenshot_crop_stored", { x, y, w, h }),
	/**  裁剪已存储的全屏捕获并直接写入剪贴板（一次 IPC 完成"裁剪+复制"） */
	screenshotCropCopyStored: (x: number, y: number, w: number, h: number) => __TAURI_INVOKE<CaptureData>("screenshot_crop_copy_stored", { x, y, w, h }),
	/**  拾取指定物理屏幕坐标下的顶层窗口 */
	screenshotWindowFromPoint: (x: number, y: number) => __TAURI_INVOKE<{
	hwnd: number,
	title: string,
	rect: ScreenRect,
	/**  DWM 扩展边框矩形（视觉边界，去掉最大化窗口的隐形缩放边框），命中测试用 rect，高亮用 visual_rect */
	visualRect: ScreenRect | null,
} | null>("screenshot_window_from_point", { x, y }),
	/**  获取当前鼠标物理屏幕坐标（覆盖层打开时定位初始悬停窗口） */
	screenshotCursorPos: () => __TAURI_INVOKE<[number, number]>("screenshot_cursor_pos"),
	/**  枚举所有可见顶层窗口 */
	screenshotEnumWindows: () => __TAURI_INVOKE<WindowInfo[]>("screenshot_enum_windows"),
	/**  按 hwnd 捕获指定窗口 */
	screenshotCaptureWindow: (hwnd: number) => __TAURI_INVOKE<CaptureData>("screenshot_capture_window", { hwnd }),
	/**  存入编辑器图片（base64 PNG） */
	screenshotSetEditorImage: (pngBase64: string) => __TAURI_INVOKE<null>("screenshot_set_editor_image", { pngBase64 }),
	/**  取出编辑器图片（编辑器窗口加载时调用，取出即清除） */
	screenshotGetEditorImage: () => __TAURI_INVOKE<string | null>("screenshot_get_editor_image"),
	/**  将 PNG base64 写入系统剪贴板（转 CF_DIB） */
	screenshotCopyImage: (pngBase64: string) => __TAURI_INVOKE<null>("screenshot_copy_image", { pngBase64 }),
	/**  将 PNG base64 写入文件 */
	screenshotSavePng: (pngBase64: string, path: string) => __TAURI_INVOKE<null>("screenshot_save_png", { pngBase64, path }),
	/**  将完整 PNG 写入历史缓存目录，返回文件路径 */
	screenshotSaveCache: (pngBase64: string) => __TAURI_INVOKE<string>("screenshot_save_cache", { pngBase64 }),
	/**  从历史缓存目录读取 PNG 并返回 base64（点击历史项复制/保存时一次性加载，不常驻内存） */
	screenshotLoadCache: (path: string) => __TAURI_INVOKE<string>("screenshot_load_cache", { path }),
	/**  删除历史缓存文件（历史项移除/清空时调用，静默忽略不存在文件） */
	screenshotDeleteCache: (path: string) => __TAURI_INVOKE<null>("screenshot_delete_cache", { path }),
};

/* Types */
export type AppRecord = {
	name: string,
	path: string,
};

/**  前端可见的捕获数据 */
export type CaptureData = {
	pngBase64: string,
	width: number,
	height: number,
};

/**  check_url 命令返回的结果 */
export type CheckUrlResult = {
	/**  探测是否成功 */
	ok: boolean,
	/**  错误信息（探测失败时） */
	error: string | null,
	/**  文件名（探测成功时） */
	filename: string | null,
	/**  文件大小（字节） */
	totalSize: number | null,
	/**  是否支持断点续传 */
	supportsResume: boolean,
	/**  重复类型 */
	duplicate: DuplicateKind,
	/**  已存在的任务信息 */
	existing: ExistingTaskInfo | null,
};

/**  列表项（不含大字段，用于历史/搜索结果） */
export type ClipboardItem = {
	id: number,
	kind: string,
	preview: string,
	size: number,
	pinned: boolean,
	pinnedOrder: number | null,
	createdAt: number,
};

/**  详情（含文本内容或图片 base64） */
export type ClipboardItemDetail = {
	/**  文本内容 / 文件列表 JSON */
	content: string | null,
	/**  图片 PNG base64（仅 image 类型） */
	imageBase64: string | null,
} & ClipboardItem;

/**  剪贴板设置（持久化到 clipboard/settings.json） */
export type ClipboardSettings = {
	/**  监听是否启用 */
	enabled?: boolean,
	/**  非固定历史最大条数 */
	maxItems?: number,
	/**  图片大小上限（KB），0 表示不限 */
	maxImageKb?: number,
	recordText?: boolean,
	recordImage?: boolean,
	recordFiles?: boolean,
	/**  去重（相同内容更新时间而非新增） */
	dedup?: boolean,
	/**  快捷弹窗全局快捷键（如 "Alt+V"，空字符串表示禁用） */
	shortcut?: string,
};

export type ClipboardStatus = {
	running: boolean,
	count: number,
};

/**  自定义命令 */
export type CustomCommand = {
	id: string,
	title: string,
	command: string,
	args?: string[],
};

/**  下载任务 */
export type DownloadTask = {
	/**  任务 ID（自增 hex 字符串） */
	id: string,
	/**  下载地址 */
	url: string,
	/**  文件名 */
	filename: string,
	/**  保存目录（绝对路径） */
	dir: string,
	/**  状态 */
	status: TaskStatus,
	/**  文件总大小（字节），0=未知 */
	totalSize: number,
	/**  已下载字节 */
	completedSize: number,
	/**  当前下载速度 bytes/s */
	speed: number,
	/**  服务器是否支持断点续传 */
	supportsResume: boolean,
	/**  分段信息 */
	segments?: Segment[],
	/**  错误信息 */
	error?: string | null,
	/**  创建时间（Unix 时间戳，毫秒） */
	createdAt: number,
	/**  自定义请求头（Cookie / Referer 等） */
	headers?: { [key in string]: string },
};

/**  下载设置 */
export type DownloaderSettings = {
	/**  下载目录 */
	downloadDir?: string,
	/**  最大同时下载数 */
	maxConcurrent?: number,
	/**  单任务最大连接数（多线程分段数） */
	maxConnections?: number,
	/**  断点续传 */
	continueDownload?: boolean,
	/**  全局速度限制 KB/s（0=不限） */
	globalSpeedLimit?: number,
	/**  扩展 HTTP API 端口 */
	extensionPort?: number,
	/**  扩展认证密钥（空=不认证） */
	extensionSecret?: string,
	/**  删除任务时是否同时删除已下载的文件 */
	deleteFilesOnRemove?: boolean,
	/**  添加下载前检查重复（URL 或文件名重复时询问） */
	checkDuplicate?: boolean,
};

/**  重复类型 */
export type DuplicateKind = 
/**  无重复 */
"none" | 
/**  URL 重复（已有相同链接的任务） */
"url" | 
/**  文件名重复（已有同名任务下载到同一目录） */
"filename" | 
/**  磁盘文件已存在 */
"fileExists";

/**  已存在的任务信息（用于前端展示） */
export type ExistingTaskInfo = {
	id: string,
	filename: string,
	status: TaskStatus,
};

/**  单个文件记录（返回给前端） */
export type FileRecord = {
	path: string,
	name: string,
	ext: string,
	size: number,
	isDir: boolean,
};

/**  历史查询结果（含总数，用于分页） */
export type HistoryPage = {
	items: ClipboardItem[],
	total: number,
};

/**  索引状态（返回给前端） */
export type IndexStats = {
	total: number,
	lastBuiltAt: number,
	lastBuiltDirs: string[],
};

export type KernelInfo = {
	path: string,
	exists: boolean,
	version: string | null,
};

export type KernelUpdateInfo = {
	currentVersion: string | null,
	latestVersion: string,
	downloadUrl: string,
	hasUpdate: boolean,
};

/**  进程信息（返回给前端） */
export type ProcessInfo = {
	id: string,
	name: string,
	status: ProcessStatus,
	pid: number | null,
	restartCount: number,
};

/**  进程状态枚举 */
export type ProcessStatus = "running" | "stopped" | "crashed" | "starting";

export type ProfileMeta = {
	id?: string,
	name?: string,
	url?: string,
	addedAt?: string,
	updatedAt?: string,
	size?: number | null,
};

export type ProxySettings = {
	mixedPort?: number,
	externalController?: string,
	secret?: string,
	mode?: string,
	logLevel?: string,
	allowLan?: boolean,
	systemProxy?: boolean,
	autoStart?: boolean,
	autoSystemProxy?: boolean,
	currentProfile?: string | null,
	profiles?: ProfileMeta[],
	autoSwitchEnabled?: boolean,
	autoSwitchInterval?: number,
	autoSwitchGroup?: string,
	autoSwitchRegion?: string,
	/**
	 *  内核下载镜像源列表（前缀拼接到 GitHub URL 前）。
	 *  空字符串 = 直连 GitHub，其余为镜像站前缀（含尾斜杠）。
	 */
	kernelMirrors?: string[],
};

export type ProxyStatus = {
	running: boolean,
	pid: number | null,
	restartCount: number,
};

/**  快速面板设置 */
export type QuickPanelSettings = {
	/**  全局快捷键（如 "Alt+Space"），空字符串表示不注册。 */
	shortcut?: string,
	/**  唤起位置：center（鼠标所在显示器中央）| cursor（鼠标位置） */
	popupPosition?: string,
	/**  默认搜索引擎：google | bing | baidu */
	searchEngine?: string,
	/**  文件索引目录列表（空列表表示使用默认：桌面/文档/下载） */
	indexDirs?: string[],
	/**  自定义命令列表 */
	customCommands?: CustomCommand[],
};

export type ScreenRect = {
	x: number,
	y: number,
	width: number,
	height: number,
};

/**  下载分段（多线程 Range 下载 / 断点续传用） */
export type Segment = {
	/**  分段索引 */
	index: number,
	/**  起始字节（含） */
	start: number,
	/**  结束字节（含） */
	end: number,
	/**  已下载字节 */
	completed: number,
};

/**  快捷位置条目 */
export type SpecialLocation = {
	id: string,
	title: string,
	subtitle: string,
	keywords: string[],
	/**  file: 真实文件/文件夹路径；shell: explorer 打开的 shell 路径；cmd: 可执行命令 */
	kind: string,
	target: string,
	args: string[],
};

/**  任务状态 */
export type TaskStatus = 
/**  排队等待（并发数已满） */
"queued" | 
/**  下载中 */
"active" | 
/**  已暂停 */
"paused" | 
/**  已完成 */
"complete" | 
/**  错误 */
"error";

/**  窗口信息（窗口拾取 / 枚举） */
export type WindowInfo = {
	hwnd: number,
	title: string,
	rect: ScreenRect,
	/**  DWM 扩展边框矩形（视觉边界，去掉最大化窗口的隐形缩放边框），命中测试用 rect，高亮用 visual_rect */
	visualRect: ScreenRect | null,
};