@dompling/trollscript-types 1.0.51 → 1.0.54

package/index.d.ts

@@ -131,12 +131,6 @@ interface Storage {
 declare const storage: Storage;
 
 interface Icloud {
-    /**
-     * 检查 iCloud 是否可用
-     * @returns 是否可用
-     */
-    isAvailable(): boolean;
-
     /**
      * 获取 iCloud 容器路径
      * @returns iCloud 容器的本地路径，不可用时返回 null
@@ -170,7 +164,7 @@ interface Icloud {
      * @param path 目录路径，默认为根目录
      * @returns 文件名列表数组
      */
-    list(path: string): any;
+    list(path?: string): any;
 
 }
 
@@ -336,42 +330,42 @@ interface Http {
      * @param options 请求选项 { headers, timeout }
      * @returns 包含状态码、响应数据、响应头的对象
      */
-    get(url: string, options: Record<string, any>): any;
+    get(url: string, options?: Record<string, any>): any;
 
     /**
      * 发送 POST 请求
      * @param url 请求地址
      * @param options 请求选项 { body, headers, timeout }
      */
-    post(url: string, options: Record<string, any>): any;
+    post(url: string, options?: Record<string, any>): any;
 
     /**
      * 发送 PUT 请求
      * @param url 请求地址
      * @param options 请求选项 { body, headers, timeout }
      */
-    put(url: string, options: Record<string, any>): any;
+    put(url: string, options?: Record<string, any>): any;
 
     /**
      * 发送 DELETE 请求
      * @param url 请求地址
      * @param options 请求选项 { headers, timeout }
      */
-    delete(url: string, options: Record<string, any>): any;
+    delete(url: string, options?: Record<string, any>): any;
 
     /**
      * 发送 PATCH 请求
      * @param url 请求地址
      * @param options 请求选项 { body, headers, timeout }
      */
-    patch(url: string, options: Record<string, any>): any;
+    patch(url: string, options?: Record<string, any>): any;
 
     /**
      * 发送 HEAD 请求
      * @param url 请求地址
      * @param options 请求选项 { headers, timeout }
      */
-    head(url: string, options: Record<string, any>): any;
+    head(url: string, options?: Record<string, any>): any;
 
     /**
      * 发送自定义请求
@@ -411,12 +405,6 @@ interface Network {
      */
     getIPAddress(): any;
 
-    /**
-     * 获取 WiFi 信息
-     * @returns 包含 SSID 和 BSSID 的对象
-     */
-    getWiFiInfo(): any;
-
     /**
      * URL 编码
      * @param string 要编码的字符串
@@ -444,7 +432,7 @@ interface Network {
      * @param params 查询参数
      * @returns 构建的 URL 字符串
      */
-    buildURL(baseURL: string, params: Record<string, any>): string;
+    buildURL(baseURL: string, params?: Record<string, any>): string;
 
     /**
      * Ping 主机
@@ -459,20 +447,7 @@ interface Network {
      * @param filename 保存文件名
      * @returns 包含本地文件路径的对象
      */
-    download(url: string, filename: string): any;
-
-    /**
-     * 获取飞行模式状态
-     * @returns 是否开启
-     */
-    getAirplaneMode(): boolean;
-
-    /**
-     * 设置飞行模式
-     * @param enabled 是否开启
-     * @returns 是否设置成功
-     */
-    setAirplaneMode(enabled: boolean): boolean;
+    download(url: string, filename?: string): any;
 
     /**
      * 列出 VPN 配置
@@ -485,7 +460,7 @@ interface Network {
      * @param name VPN 名称，默认第一个
      * @returns 是否发起连接成功
      */
-    connectVPN(name: string): boolean;
+    connectVPN(name?: string): boolean;
 
     /**
      * 断开 VPN
@@ -499,25 +474,12 @@ interface Network {
      */
     getVPNStatus(): any;
 
-    /**
-     * 获取 WiFi 开关状态
-     * @returns 是否开启
-     */
-    getWiFiEnabled(): boolean;
-
-    /**
-     * 设置 WiFi 开关
-     * @param enabled 是否开启
-     * @returns 是否设置成功
-     */
-    setWiFi(enabled: boolean): boolean;
-
     /**
      * 打开系统设置
      * @param section 设置页面（如 'WIFI'）
      * @returns 是否成功打开
      */
-    openSettings(section: string): boolean;
+    openSettings(section?: string): boolean;
 
 }
 
@@ -572,7 +534,7 @@ interface App {
      * @param limit 返回的日志条数
      * @returns 日志对象数组
      */
-    getLogs(limit: number): any;
+    getLogs(limit?: number): any;
 
     /**
      * 导出日志为字符串
@@ -601,7 +563,7 @@ interface App {
      * 退出应用（仅用于调试）
      * @param code 退出码，默认为 0
      */
-    exit(code: number): void;
+    exit(code?: number): void;
 
     /**
      * 打开应用设置页面
@@ -659,7 +621,7 @@ interface Haptic {
      * 触觉冲击反馈
      * @param style 'light' | 'medium' | 'heavy' | 'soft' | 'rigid'
      */
-    impact(style: string): void;
+    impact(style?: string): void;
 
     /**
      * 通知触觉反馈
@@ -728,13 +690,13 @@ interface Display {
      * 增加亮度
      * @param amount 增加量 (默认 0.1)
      */
-    increaseBrightness(amount: number): void;
+    increaseBrightness(amount?: number): void;
 
     /**
      * 降低亮度
      * @param amount 减少量 (默认 0.1)
      */
-    decreaseBrightness(amount: number): void;
+    decreaseBrightness(amount?: number): void;
 
     /**
      * 获取屏幕信息
@@ -884,7 +846,7 @@ interface Location {
      * @param locale 语言区域标识(可选，如 'zh_CN'、'en_US'，默认使用系统语言)
      * @returns 地址信息对象数组
      */
-    reverseGeocode(lat: number, lng: number, locale: string): any;
+    reverseGeocode(lat: number, lng: number, locale?: string): any;
 
     /**
      * 定位服务是否开启
@@ -946,7 +908,7 @@ interface Calendar {
      * @param calendarId 日历 ID
      * @returns 事件数组
      */
-    getEvents(start: number, end: number, calendarId: string): any;
+    getEvents(start: number, end: number, calendarId?: string): any;
 
     /**
      * 创建日历事件
@@ -956,7 +918,7 @@ interface Calendar {
      * @param options 选项 { calendarId, notes, location, url, allDay }
      * @returns 创建的事件 ID
      */
-    create(title: string, start: number, end: number, options: Record<string, any>): any;
+    create(title: string, start: number, end: number, options?: Record<string, any>): any;
 
     /**
      * 删除日历事件
@@ -993,7 +955,7 @@ interface Reminder {
      * @param listId 列表 ID
      * @returns 提醒事项数组
      */
-    getAll(listId: string): any;
+    getAll(listId?: string): any;
 
     /**
      * 创建提醒事项
@@ -1001,7 +963,7 @@ interface Reminder {
      * @param options 选项 { listId, notes, dueDate, priority, sortOrder, isPinned }
      * @returns 创建的提醒 ID
      */
-    create(title: string, options: Record<string, any>): any;
+    create(title: string, options?: Record<string, any>): any;
 
     /**
      * 标记为已完成
@@ -1022,14 +984,14 @@ interface Reminder {
      * @param options { sortBy: 'createdAt'|'dueDate'|'priority'|'title', ascending: boolean, completed: boolean }
      * @returns 排序后的提醒列表
      */
-    getSorted(options: Record<string, any>): any;
+    getSorted(options?: Record<string, any>): any;
 
     /**
      * 获取即将到期的提醒
      * @param days 未来几天，默认 7 天
      * @returns 即将到期的提醒列表
      */
-    getUpcoming(days: number): any;
+    getUpcoming(days?: number): any;
 
     /**
      * 获取已过期的提醒
@@ -1050,7 +1012,7 @@ interface Reminder {
      * @param options { listId, notes, dueDate, priority, location: { latitude, longitude, radius, onArrive, name } }
      * @returns { success: boolean, id: string, title: string, isSystemReminder: true }
      */
-    createSystemReminder(title: string, options: Record<string, any>): any;
+    createSystemReminder(title: string, options?: Record<string, any>): any;
 
     /**
      * 获取系统提醒列表
@@ -1087,7 +1049,7 @@ interface Contacts {
      * @param limit 返回的最大数量，默认全部
      * @returns 联系人对象数组
      */
-    getAll(offset: number, limit: number): any;
+    getAll(offset?: number, limit?: number): any;
 
     /**
      * 获取联系人总数
@@ -1170,7 +1132,7 @@ interface Notification {
      * @param options 选项 { url, userInfo, sound, badge }
      * @returns 发送的通知 ID
      */
-    send(title: string, body: string, options: Record<string, any>): any;
+    send(title: string, body: string, options?: Record<string, any>): any;
 
     /**
      * 取消通知
@@ -1234,319 +1196,12 @@ interface Notification {
      * @param options 选项 { url, userInfo, sound, badge, repeat: 'daily'|'weekly'|'monthly' }
      * @returns 发送的通知 ID
      */
-    schedule(title: string, body: string, date: number, options: Record<string, any>): any;
+    schedule(title: string, body: string, date: number, options?: Record<string, any>): any;
 
 }
 
 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 是否能发送邮件
-     */
-    isAvailable(): boolean;
-
-    /**
-     * 打开邮件编辑器
-     * @param options 邮件选项 { to: string|string[], cc?: string|string[], bcc?: string|string[], subject?: string, body?: string, isHTML?: boolean, attachments?: [{path, mimeType?, filename?}] }
-     * @returns 包含发送结果的对象
-     */
-    compose(options: Record<string, any>): any;
-
-    /**
-     * 通过 URL Scheme 发送邮件 (sendDirect 的别名)
-     * @param options 邮件选项 { to: string|string[], cc?: string, bcc?: string, subject?: string, body?: string }
-     * @returns 是否成功打开邮件客户端
-     */
-    send(options: Record<string, any>): boolean;
-
-    /**
-     * 通过 URL Scheme 发送邮件（打开默认邮件客户端）
-     * @param options 邮件选项 { to: string|string[], cc?: string, bcc?: string, subject?: string, body?: string }
-     * @returns 是否成功打开邮件客户端
-     */
-    sendDirect(options: Record<string, any>): boolean;
-
-}
-
-declare const mail: Mail;
-
 interface Sms {
     /**
      * 检查短信权限
@@ -1565,14 +1220,14 @@ interface Sms {
      * @param limit 限制条数 (默认 10)
      * @returns 短信对象数组
      */
-    read(limit: number): any;
+    read(limit?: number): any;
 
     /**
      * 获取验证码
      * @param minutes 查找最近几分钟内的验证码 (默认 5)
      * @returns 验证码或 null
      */
-    getVerificationCode(minutes: number): any;
+    getVerificationCode(minutes?: number): any;
 
     /**
      * 搜索短信
@@ -1624,7 +1279,7 @@ interface Sql {
      * @param params 参数列表
      * @returns 查询结果数组
      */
-    query(dbPath: string, sql: string, params: any[]): any[];
+    query(dbPath: string, sql: string, params?: any[]): any[];
 
     /**
      * 执行 INSERT/UPDATE/DELETE
@@ -1633,7 +1288,7 @@ interface Sql {
      * @param params 参数列表
      * @returns 执行结果对象
      */
-    execute(dbPath: string, sql: string, params: any[]): any;
+    execute(dbPath: string, sql: string, params?: any[]): any;
 
     /**
      * 列出数据库中的所有表
@@ -1661,7 +1316,7 @@ interface Shortcuts {
      * @param input 输入文本（可选）
      * @returns 是否成功打开快捷指令
      */
-    run(name: string, input: string): boolean;
+    run(name: string, input?: string): boolean;
 
     /**
      * 运行快捷指令（带 x-callback-url 回调）
@@ -1669,7 +1324,7 @@ interface Shortcuts {
      * @param input 输入文本（可选）
      * @returns 是否成功打开快捷指令
      */
-    runWithCallback(name: string, input: string): boolean;
+    runWithCallback(name: string, input?: string): boolean;
 
     /**
      * 打开快捷指令 App
@@ -1728,141 +1383,6 @@ interface Shortcuts {
 
 declare const shortcuts: Shortcuts;
 
-interface Bluetooth {
-    /**
-     * 蓝牙是否开启
-     */
-    isEnabled(): boolean;
-
-    /**
-     * 获取蓝牙状态
-     */
-    getStatus(): any;
-
-    /**
-     * 设置蓝牙开关
-     * @param enabled 是否开启
-     * @returns 无返回值
-     */
-    setEnabled(enabled: boolean): void;
-
-    /**
-     * 打开蓝牙
-     * @returns 无返回值
-     */
-    turnOn(): void;
-
-    /**
-     * 关闭蓝牙
-     * @returns 无返回值
-     */
-    turnOff(): void;
-
-    /**
-     * 获取配对设备
-     */
-    getPairedDevices(): any;
-
-    /**
-     * 获取已连接设备
-     */
-    getConnectedDevices(): any;
-
-    /**
-     * 连接设备
-     * @param id 设备 UUID
-     */
-    connectDevice(id: string): any;
-
-    /**
-     * 断开设备
-     * @param id 设备 UUID
-     */
-    disconnectDevice(id: string): any;
-
-    /**
-     * 开始扫描
-     * @returns 无返回值
-     */
-    startScan(): void;
-
-    /**
-     * 停止扫描
-     * @returns 无返回值
-     */
-    stopScan(): void;
-
-    /**
-     * 打开蓝牙设置
-     * @returns 无返回值
-     */
-    openSettings(): void;
-
-}
-
-declare const bluetooth: Bluetooth;
-
-interface Memo {
-    /**
-     * 创建备忘录
-     * @param title 备忘录标题
-     * @param content 备忘录内容
-     * @param tags 标签列表
-     * @returns { success: 是否成功, id: 备忘录ID, memo: 备忘录对象 }
-     */
-    create(title: string, content: string, tags: any): Record<string, any>;
-
-    /**
-     * 获取所有备忘录
-     * @returns 备忘录数组 [{ id: ID, title: 标题, content: 内容, createdAt: 创建时间, updatedAt: 更新时间, tags: 标签 }]
-     */
-    getAll(): any;
-
-    /**
-     * 根据 ID 获取备忘录
-     * @param id 备忘录 ID
-     * @returns 备忘录对象或 null（不存在时）
-     */
-    getById(id: string): any;
-
-    /**
-     * 搜索备忘录（标题和内容）
-     * @param keyword 搜索关键词
-     * @returns 匹配的备忘录数组
-     */
-    search(keyword: string): any;
-
-    /**
-     * 更新备忘录
-     * @param id 备忘录 ID
-     * @param data 更新数据 { title?: 新标题, content?: 新内容, tags?: 新标签 }
-     * @returns { success: 是否成功, id: 备忘录ID }
-     */
-    update(id: string, data: Record<string, any>): Record<string, any>;
-
-    /**
-     * 删除备忘录
-     * @param id 备忘录 ID
-     * @returns { success: 是否成功, id: 已删除的ID }
-     */
-    delete(id: string): Record<string, any>;
-
-    /**
-     * 清空所有备忘录
-     * @returns { success: 是否成功 }
-     */
-    clear(): Record<string, any>;
-
-    /**
-     * 获取备忘录数量
-     * @returns 备忘录总数
-     */
-    count(): number;
-
-}
-
-declare const memo: Memo;
-
 interface System {
     /**
      * 检查 WiFi 是否开启
@@ -1921,7 +1441,7 @@ interface System {
      * @param category 音量类别: 'System', 'Ringer', 'Media'，默认 'Media'
      * @returns 当前音量 (0.0 - 1.0)
      */
-    getVolume(category: string): number;
+    getVolume(category?: string): number;
 
     /**
      * 设置系统音量
@@ -1929,7 +1449,7 @@ interface System {
      * @param category 音量类别: 'System', 'Ringer', 'Media'，默认 'Media'
      * @returns 是否设置成功
      */
-    setVolume(level: number, category: string): boolean;
+    setVolume(level: number, category?: string): boolean;
 
     /**
      * 检查设备是否有闪光灯
@@ -1949,7 +1469,7 @@ interface System {
      * @param level 亮度级别 (0.0 - 1.0)，默认 1.0
      * @returns 是否设置成功
      */
-    setFlashlight(enabled: boolean, level: number): boolean;
+    setFlashlight(enabled: boolean, level?: number): boolean;
 
     /**
      * 检查方向锁定是否开启
@@ -2008,7 +1528,7 @@ interface System {
      * @param section 设置页面: 'WIFI', 'BLUETOOTH', 'CELLULAR', 'VPN', 'GENERAL', 'DISPLAY', 'SOUND', 'NOTIFICATION', 'PRIVACY', 'BATTERY', 'STORAGE', 'WALLPAPER', 'SIRI', 'ACCESSIBILITY', 'DND', 'SCREEN_TIME', 'PASSWORDS'
      * @returns 是否成功打开
      */
-    openSettings(section: string): boolean;
+    openSettings(section?: string): boolean;
 
 }
 

package/package.json

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