@dompling/trollscript-types 1.0.50 → 1.0.53

package/index.d.ts

@@ -131,12 +131,6 @@ interface Storage {
 declare const storage: Storage;
 
 interface Icloud {
-    /**
-     * 检查 iCloud 是否可用
-     * @returns 是否可用
-     */
-    isAvailable(): boolean;
-
     /**
      * 获取 iCloud 容器路径
      * @returns iCloud 容器的本地路径，不可用时返回 null
@@ -530,6 +524,24 @@ interface App {
      */
     version(): string;
 
+    /**
+     * 获取应用构建号
+     * @returns 应用构建号 (CFBundleVersion)
+     */
+    build(): string;
+
+    /**
+     * 获取应用 Bundle ID
+     * @returns 应用的 Bundle Identifier
+     */
+    bundleId(): string;
+
+    /**
+     * 获取应用完整信息
+     * @returns 包含 name, version, build, bundleId, language 的应用信息对象
+     */
+    info(): any;
+
     /**
      * 打开 URL/Scheme
      * @param url 要打开的 URL
@@ -579,6 +591,59 @@ interface App {
      */
     clearLogs(): void;
 
+    /**
+     * 退出应用（仅用于调试）
+     * @param code 退出码，默认为 0
+     */
+    exit(code: number): void;
+
+    /**
+     * 打开应用设置页面
+     * @returns 是否成功打开设置
+     */
+    openSettings(): boolean;
+
+    /**
+     * 获取所有已安装应用列表 (TrollStore 权限)
+     * @returns 应用信息数组，包含 bundleIdentifier, name, version, type 等字段
+     */
+    list(): any;
+
+    /**
+     * 获取指定应用的详细信息 (TrollStore 权限)
+     * @param bundleId 应用的 Bundle Identifier
+     * @returns 应用信息对象，包含 bundleIdentifier, name, version, build, type, teamID, bundlePath, dataContainerPath, urlSchemes 等
+     */
+    getAppInfo(bundleId: string): any;
+
+    /**
+     * 启动指定应用 (TrollStore 权限)
+     * @param bundleId 应用的 Bundle Identifier
+     * @returns 是否成功启动
+     */
+    launch(bundleId: string): boolean;
+
+    /**
+     * 终止指定应用 (TrollStore 权限，需要后台权限)
+     * @param bundleId 应用的 Bundle Identifier
+     * @returns 是否成功终止
+     */
+    terminate(bundleId: string): boolean;
+
+    /**
+     * 检查应用是否已安装
+     * @param bundleId 应用的 Bundle Identifier
+     * @returns 是否已安装
+     */
+    isInstalled(bundleId: string): boolean;
+
+    /**
+     * 获取应用数据容器路径 (TrollStore 权限)
+     * @param bundleId 应用的 Bundle Identifier
+     * @returns 数据容器路径，未找到返回 null
+     */
+    getDataContainer(bundleId: string): any;
+
 }
 
 declare const app: App;
@@ -690,32 +755,6 @@ interface Display {
      */
     setLowPowerMode(enabled: boolean): boolean;
 
-    /**
-     * 获取夜览状态
-     * @returns 是否开启
-     */
-    getNightShiftStatus(): boolean;
-
-    /**
-     * 设置夜览
-     * @param enabled 是否开启
-     * @returns 是否设置成功
-     */
-    setNightShift(enabled: boolean): boolean;
-
-    /**
-     * 获取原彩显示状态
-     * @returns 是否开启
-     */
-    getTrueToneStatus(): boolean;
-
-    /**
-     * 设置原彩显示
-     * @param enabled 是否开启
-     * @returns 是否设置成功
-     */
-    setTrueTone(enabled: boolean): boolean;
-
     /**
      * 自动亮度是否开启
      * @returns 是否开启
@@ -735,19 +774,6 @@ interface Display {
      */
     openSettings(): boolean;
 
-    /**
-     * 获取自动锁定时间
-     * @returns 自动锁定时间(秒)，0 表示永不
-     */
-    getAutoLockTime(): number;
-
-    /**
-     * 设置自动锁定时间
-     * @param seconds 锁定时间(秒)，0 表示永不
-     * @returns 是否设置成功
-     */
-    setAutoLock(seconds: number): boolean;
-
     /**
      * 保持屏幕常亮
      * @param enabled 是否保持常亮
@@ -1165,32 +1191,34 @@ interface Notification {
 
     /**
      * 请求通知权限
-     * @returns 是否授权成功
+     * @returns 授权结果对象
      */
-    requestPermission(): any;
+    requestAccess(): any;
 
     /**
      * 获取权限状态
-     * @returns 权限状态
+     * @returns 权限状态字符串
      */
-    getPermissionStatus(): any;
+    getAccessStatus(): any;
 
     /**
-     * 设置角标数字
-     * @param count 角标数
+     * 检查是否已授权通知权限
+     * @returns 是否已授权
      */
-    setBadge(count: number): void;
+    isAuthorized(): boolean;
 
     /**
-     * 获取角标数字
-     * @returns 角标数字
+     * 设置角标数字
+     * @param count 角标数
+     * @returns 是否成功
      */
-    getBadge(): any;
+    setBadge(count: number): boolean;
 
     /**
      * 清除角标
+     * @returns 是否成功
      */
-    clearBadge(): void;
+    clearBadge(): boolean;
 
     /**
      * 定时通知
@@ -1206,354 +1234,6 @@ interface Notification {
 
 declare const notification: Notification;
 
-interface Alarm {
-    /**
-     * 请求通知权限
-     * @returns 是否授权成功
-     */
-    requestAccess(): any;
-
-    /**
-     * 获取权限状态
-     * @returns 权限状态
-     */
-    getAccessStatus(): any;
-
-    /**
-     * 创建一次性闹钟
-     * @param timestamp 触发时间戳
-     * @param title 标题
-     * @param options 选项 { sound }
-     * @returns 创建的闹钟 ID
-     */
-    createOnce(timestamp: number, title: string, options: Record<string, any>): any;
-
-    /**
-     * 创建每日重复闹钟
-     * @param hour 小时 (0-23)
-     * @param minute 分钟 (0-59)
-     * @param title 标题
-     * @param options 选项 { sound }
-     * @returns 创建的闹钟 ID
-     */
-    createDaily(hour: number, minute: number, title: string, options: Record<string, any>): any;
-
-    /**
-     * 创建每周重复闹钟
-     * @param weekday 周几 (1-7, 周日为1)
-     * @param hour 小时 (0-23)
-     * @param minute 分钟 (0-59)
-     * @param title 标题
-     * @param options 选项 { sound }
-     * @returns 创建的闹钟 ID
-     */
-    createWeekly(weekday: number, hour: number, minute: number, title: string, options: Record<string, any>): any;
-
-    /**
-     * 创建倒计时提醒
-     * @param seconds 秒数
-     * @param title 标题
-     * @param options 选项 { sound }
-     * @returns 创建的闹钟 ID
-     */
-    createCountdown(seconds: number, title: string, options: Record<string, any>): any;
-
-    /**
-     * 获取待触发的闹钟
-     * @returns 待触发闹钟列表
-     */
-    getPending(): any;
-
-    /**
-     * 获取闹钟数量
-     * @returns 闹钟数量
-     */
-    getCount(): any;
-
-    /**
-     * 取消指定闹钟
-     * @param id 闹钟 ID
-     */
-    cancel(id: string): void;
-
-    /**
-     * 取消所有闹钟
-     */
-    cancelAll(): void;
-
-    /**
-     * 打开系统时钟
-     */
-    openClockApp(): void;
-
-    /**
-     * 打开计时器
-     */
-    openTimer(): void;
-
-}
-
-declare const alarm: Alarm;
-
-interface Media {
-    /**
-     * 播放
-     */
-    play(): void;
-
-    /**
-     * 暂停
-     */
-    pause(): void;
-
-    /**
-     * 停止
-     */
-    stop(): void;
-
-    /**
-     * 切换播放/暂停
-     */
-    togglePlayPause(): void;
-
-    /**
-     * 下一首
-     */
-    next(): void;
-
-    /**
-     * 上一首
-     */
-    previous(): void;
-
-    /**
-     * 跳到开头
-     */
-    skipToBeginning(): void;
-
-    /**
-     * 获取播放状态
-     * @returns 播放状态
-     */
-    getPlaybackState(): any;
-
-    /**
-     * 是否正在播放
-     * @returns 是否正在播放
-     */
-    isPlaying(): boolean;
-
-    /**
-     * 获取当前播放信息
-     * @returns 当前播放信息对象
-     */
-    getNowPlaying(): any;
-
-    /**
-     * 获取音量
-     * @returns 当前音量(0.0-1.0)
-     */
-    getVolume(): number;
-
-    /**
-     * 设置音量
-     * @param volume 音量 (0.0 - 1.0)
-     */
-    setVolume(volume: number): void;
-
-    /**
-     * 获取重复模式
-     * @returns 重复模式
-     */
-    getRepeatMode(): any;
-
-    /**
-     * 设置重复模式
-     * @param mode 'none' | 'one' | 'all'
-     */
-    setRepeatMode(mode: string): void;
-
-    /**
-     * 获取随机播放模式
-     * @returns 随机播放模式
-     */
-    getShuffleMode(): any;
-
-    /**
-     * 设置随机播放模式
-     * @param mode 'off' | 'songs' | 'albums'
-     */
-    setShuffleMode(mode: string): void;
-
-    /**
-     * 获取当前播放时间
-     * @returns 当前播放时间(秒)
-     */
-    getCurrentTime(): number;
-
-    /**
-     * 设置播放时间
-     * @param time 时间 (秒)
-     */
-    setCurrentTime(time: number): void;
-
-    /**
-     * 快进
-     * @param seconds 秒数 (默认 15)
-     */
-    seekForward(seconds: number): void;
-
-    /**
-     * 快退
-     * @param seconds 秒数 (默认 15)
-     */
-    seekBackward(seconds: number): void;
-
-    /**
-     * 请求音乐库权限
-     * @returns 是否授权成功
-     */
-    requestAccess(): any;
-
-    /**
-     * 获取权限状态
-     * @returns 权限状态
-     */
-    getAccessStatus(): any;
-
-    /**
-     * 搜索音乐库
-     * @param query 搜索关键词
-     * @returns 歌曲列表数组
-     */
-    searchSongs(query: string): any;
-
-    /**
-     * 播放指定歌曲
-     * @param persistentID 歌曲 ID
-     */
-    playSong(persistentID: string): void;
-
-    /**
-     * 获取所有歌曲
-     * @returns 歌曲列表数组
-     */
-    getAllSongs(): any;
-
-    /**
-     * 获取所有专辑
-     * @returns 专辑列表数组
-     */
-    getAlbums(): any;
-
-    /**
-     * 获取所有艺术家
-     * @returns 艺术家列表数组
-     */
-    getArtists(): any;
-
-    /**
-     * 获取播放列表
-     * @returns 播放列表数组
-     */
-    getPlaylists(): any;
-
-    /**
-     * 播放专辑
-     * @param id 专辑 ID
-     */
-    playAlbum(id: string): void;
-
-    /**
-     * 播放艺术家
-     * @param id 艺术家 ID
-     */
-    playArtist(id: string): void;
-
-    /**
-     * 播放播放列表
-     * @param id 播放列表 ID
-     * @returns 无返回值
-     */
-    playPlaylist(id: string): void;
-
-}
-
-declare const media: Media;
-
-interface Mail {
-    /**
-     * 检查是否能发送邮件
-     * @returns 是否能发送
-     */
-    canSendMail(): boolean;
-
-    /**
-     * 获取邮件功能状态
-     * @returns 邮件功能状态
-     */
-    getStatus(): any;
-
-    /**
-     * 发送简单邮件
-     * @param to 收件人列表
-     * @param subject 主题
-     * @param body 正文
-     * @returns 是否发送成功
-     */
-    send(to: any, subject: string, body: string): any;
-
-    /**
-     * 发送邮件(完整选项)
-     * @param options 选项 { to, cc, bcc, subject, body, isHtml, attachments }
-     * @returns 是否发送成功
-     */
-    sendAdvanced(options: Record<string, any>): any;
-
-    /**
-     * 打开邮件 App
-     * @returns 无返回值
-     */
-    openMailApp(): void;
-
-    /**
-     * 打开指定邮件 App
-     * @param appName App 名称
-     * @returns 无返回值
-     */
-    openSpecificMailApp(appName: string): void;
-
-    /**
-     * 验证邮箱格式
-     * @param email 邮箱地址
-     * @returns 是否有效
-     */
-    isValidEmail(email: string): boolean;
-
-    /**
-     * 检测已安装的邮件 App
-     * @returns 已安装的邮件 App 名称数组
-     */
-    getInstalledMailApps(): any;
-
-    /**
-     * 从模板生成邮件
-     * @param templateName 模板名称
-     * @param variables 变量字典
-     * @returns 生成的邮件内容
-     */
-    fromTemplate(templateName: string, variables: Record<string, any>): any;
-
-    /**
-     * 获取可用模板列表
-     * @returns 模板名称数组
-     */
-    getTemplates(): any;
-
-}
-
-declare const mail: Mail;
-
 interface Sms {
     /**
      * 检查短信权限
@@ -1665,208 +1345,223 @@ interface Shortcuts {
     /**
      * 运行快捷指令
      * @param name 快捷指令名称
-     * @returns 快捷指令执行结果
-     */
-    run(name: string): any;
-
-    /**
-     * 运行快捷指令(带文本输入)
-     * @param name 快捷指令名称
-     * @param text 输入文本
-     * @returns 快捷指令执行结果
+     * @param input 输入文本（可选）
+     * @returns 是否成功打开快捷指令
      */
-    runWithText(name: string, text: string): any;
+    run(name: string, input: string): boolean;
 
     /**
-     * 运行快捷指令(剪贴板输入)
+     * 运行快捷指令（带 x-callback-url 回调）
      * @param name 快捷指令名称
+     * @param input 输入文本（可选）
+     * @returns 是否成功打开快捷指令
      */
-    runWithClipboard(name: string): any;
+    runWithCallback(name: string, input: string): boolean;
 
     /**
-     * 运行快捷指令(高级选项)
-     * @param name 快捷指令名称
-     * @param options 选项 { input, showOutput }
+     * 打开快捷指令 App
+     * @returns 是否成功打开
      */
-    runAdvanced(name: string, options: Record<string, any>): any;
+    open(): boolean;
 
     /**
-     * 打开快捷指令 App
-     * @returns 无返回值
+     * 打开快捷指令中心/库
+     * @returns 是否成功打开
      */
-    openApp(): void;
+    openGallery(): boolean;
 
     /**
-     * 打开快捷指令库
-     * @returns 无返回值
+     * 创建新快捷指令
+     * @param name 快捷指令名称
+     * @returns 是否成功打开创建界面
      */
-    openGallery(): void;
+    create(name: string): boolean;
 
     /**
-     * 打开指定快捷指令
-     * @param name 快捷指令名称
-     * @returns 无返回值
+     * 通过链接导入快捷指令
+     * @param url 快捷指令 URL
+     * @returns 是否成功打开导入界面
      */
-    openShortcut(name: string): void;
+    import(url: string): boolean;
 
     /**
-     * 创建新快捷指令
-     * @returns 无返回值
+     * 检查是否安装快捷指令 App
+     * @returns 是否可用
      */
-    createNew(): void;
+    isAvailable(): boolean;
 
     /**
-     * 通过链接导入快捷指令
-     * @param url 快捷指令 URL
-     * @returns 无返回值
+     * 捐赠 Siri 建议
+     * @param title 建议标题/调用短语
+     * @param identifier 交互标识符
+     * @returns 是否成功捐赠
      */
-    importFromUrl(url: string): void;
+    donateInteraction(title: string, identifier: string): boolean;
 
     /**
-     * 检查是否安装快捷指令
+     * 删除指定的 Siri 建议
+     * @param identifier 交互标识符
+     * @returns 是否成功删除
      */
-    isAvailable(): boolean;
+    deleteInteraction(identifier: string): boolean;
 
     /**
-     * 获取常用快捷指令模板
+     * 删除所有 Siri 建议
+     * @returns 是否成功删除
      */
-    getCommonShortcuts(): any;
+    deleteAllInteractions(): boolean;
 
 }
 
 declare const shortcuts: Shortcuts;
 
-interface Bluetooth {
+interface System {
     /**
-     * 蓝牙是否开启
+     * 检查 WiFi 是否开启
+     * @returns WiFi 是否开启
      */
-    isEnabled(): boolean;
+    isWiFiEnabled(): boolean;
 
     /**
-     * 获取蓝牙状态
+     * 设置 WiFi 开关 (TrollStore 权限)
+     * @param enabled 是否开启 WiFi
+     * @returns 是否设置成功
      */
-    getStatus(): any;
+    setWiFi(enabled: boolean): boolean;
 
     /**
-     * 设置蓝牙开关
-     * @param enabled 是否开启
-     * @returns 无返回值
+     * 检查蓝牙是否开启
+     * @returns 蓝牙是否开启
      */
-    setEnabled(enabled: boolean): void;
+    isBluetoothEnabled(): boolean;
 
     /**
-     * 打开蓝牙
-     * @returns 无返回值
+     * 设置蓝牙开关 (TrollStore 权限)
+     * @param enabled 是否开启蓝牙
+     * @returns 是否设置成功
      */
-    turnOn(): void;
+    setBluetooth(enabled: boolean): boolean;
 
     /**
-     * 关闭蓝牙
-     * @returns 无返回值
+     * 检查飞行模式是否开启
+     * @returns 飞行模式是否开启
      */
-    turnOff(): void;
+    isAirplaneModeEnabled(): boolean;
 
     /**
-     * 获取配对设备
+     * 设置飞行模式 (TrollStore 权限)
+     * @param enabled 是否开启飞行模式
+     * @returns 是否设置成功
      */
-    getPairedDevices(): any;
+    setAirplaneMode(enabled: boolean): boolean;
 
     /**
-     * 获取已连接设备
+     * 检查勿扰模式是否开启
+     * @returns 勿扰模式是否开启
      */
-    getConnectedDevices(): any;
+    isDoNotDisturbEnabled(): boolean;
 
     /**
-     * 连接设备
-     * @param id 设备 UUID
+     * 设置勿扰模式
+     * @param enabled 是否开启勿扰模式
+     * @returns 是否设置成功
      */
-    connectDevice(id: string): any;
+    setDoNotDisturb(enabled: boolean): boolean;
 
     /**
-     * 断开设备
-     * @param id 设备 UUID
+     * 获取系统音量
+     * @param category 音量类别: 'System', 'Ringer', 'Media'，默认 'Media'
+     * @returns 当前音量 (0.0 - 1.0)
      */
-    disconnectDevice(id: string): any;
+    getVolume(category: string): number;
 
     /**
-     * 开始扫描
-     * @returns 无返回值
+     * 设置系统音量
+     * @param level 音量级别 (0.0 - 1.0)
+     * @param category 音量类别: 'System', 'Ringer', 'Media'，默认 'Media'
+     * @returns 是否设置成功
      */
-    startScan(): void;
+    setVolume(level: number, category: string): boolean;
 
     /**
-     * 停止扫描
-     * @returns 无返回值
+     * 检查设备是否有闪光灯
+     * @returns 是否有闪光灯
      */
-    stopScan(): void;
+    hasFlashlight(): boolean;
 
     /**
-     * 打开蓝牙设置
-     * @returns 无返回值
+     * 检查闪光灯是否开启
+     * @returns 闪光灯是否开启
      */
-    openSettings(): void;
+    isFlashlightOn(): boolean;
 
-}
+    /**
+     * 设置闪光灯
+     * @param enabled 是否开启闪光灯
+     * @param level 亮度级别 (0.0 - 1.0)，默认 1.0
+     * @returns 是否设置成功
+     */
+    setFlashlight(enabled: boolean, level: number): boolean;
 
-declare const bluetooth: Bluetooth;
+    /**
+     * 检查方向锁定是否开启
+     * @returns 方向锁定是否开启
+     */
+    isOrientationLockEnabled(): boolean;
 
-interface Memo {
     /**
-     * 创建备忘录
-     * @param title 备忘录标题
-     * @param content 备忘录内容
-     * @param tags 标签列表
-     * @returns { success: 是否成功, id: 备忘录ID, memo: 备忘录对象 }
+     * 设置方向锁定
+     * @param enabled 是否开启方向锁定
+     * @returns 是否设置成功
      */
-    create(title: string, content: string, tags: any): Record<string, any>;
+    setOrientationLock(enabled: boolean): boolean;
 
     /**
-     * 获取所有备忘录
-     * @returns 备忘录数组 [{ id: ID, title: 标题, content: 内容, createdAt: 创建时间, updatedAt: 更新时间, tags: 标签 }]
+     * 检查低电量模式是否开启
+     * @returns 低电量模式是否开启
      */
-    getAll(): any;
+    isLowPowerModeEnabled(): boolean;
 
     /**
-     * 根据 ID 获取备忘录
-     * @param id 备忘录 ID
-     * @returns 备忘录对象或 null（不存在时）
+     * 设置低电量模式 (TrollStore 权限)
+     * @param enabled 是否开启低电量模式
+     * @returns 是否设置成功
      */
-    getById(id: string): any;
+    setLowPowerMode(enabled: boolean): boolean;
 
     /**
-     * 搜索备忘录（标题和内容）
-     * @param keyword 搜索关键词
-     * @returns 匹配的备忘录数组
+     * 检查位置服务是否开启
+     * @returns 位置服务是否开启
      */
-    search(keyword: string): any;
+    isLocationServicesEnabled(): boolean;
 
     /**
-     * 更新备忘录
-     * @param id 备忘录 ID
-     * @param data 更新数据 { title?: 新标题, content?: 新内容, tags?: 新标签 }
-     * @returns { success: 是否成功, id: 备忘录ID }
+     * 设置位置服务 (TrollStore 权限)
+     * @param enabled 是否开启位置服务
+     * @returns 是否设置成功
      */
-    update(id: string, data: Record<string, any>): Record<string, any>;
+    setLocationServices(enabled: boolean): boolean;
 
     /**
-     * 删除备忘录
-     * @param id 备忘录 ID
-     * @returns { success: 是否成功, id: 已删除的ID }
+     * 检查蜂窝数据是否开启
+     * @returns 蜂窝数据是否开启
      */
-    delete(id: string): Record<string, any>;
+    isCellularDataEnabled(): boolean;
 
     /**
-     * 清空所有备忘录
-     * @returns { success: 是否成功 }
+     * 设置蜂窝数据 (TrollStore 权限)
+     * @param enabled 是否开启蜂窝数据
+     * @returns 是否设置成功
      */
-    clear(): Record<string, any>;
+    setCellularData(enabled: boolean): boolean;
 
     /**
-     * 获取备忘录数量
-     * @returns 备忘录总数
+     * 打开系统设置
+     * @param section 设置页面: 'WIFI', 'BLUETOOTH', 'CELLULAR', 'VPN', 'GENERAL', 'DISPLAY', 'SOUND', 'NOTIFICATION', 'PRIVACY', 'BATTERY', 'STORAGE', 'WALLPAPER', 'SIRI', 'ACCESSIBILITY', 'DND', 'SCREEN_TIME', 'PASSWORDS'
+     * @returns 是否成功打开
      */
-    count(): number;
+    openSettings(section: string): boolean;
 
 }
 
-declare const memo: Memo;
+declare const system: System;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dompling/trollscript-types",
-  "version": "1.0.50",
+  "version": "1.0.53",
   "description": "TypeScript definitions for TrollScript",
   "main": "",
   "types": "index.d.ts",