Skip to content

Commit 0cd893d

Browse files
github-actions[bot]github-actions[bot]
committed
🔄 Sync from private repository - 2026-03-13 08:30:56
1 parent 5594676 commit 0cd893d

7 files changed

Lines changed: 2120 additions & 3 deletions

File tree

‎API.en.md‎

Lines changed: 136 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -38,6 +38,8 @@ The following icons indicate API compatibility when running in background trigge
3838
- [sql](#sql) ✅ - SQLite database operations
3939
- [shortcuts](#shortcuts) ❌ - Shortcuts operations
4040
- [system](#system) ✅ - System settings control
41+
- [miniapp](#miniapp) ✅ - MiniApp - Full-screen interactive multi-page application
42+
- [widget](#widget) ✅ - Widget - Scriptable-compatible iOS Home Screen widgets
4143

4244
---
4345

@@ -2067,6 +2069,79 @@ Get all window IDs
20672069

20682070
---
20692071

2072+
### `hud.alert`
2073+
2074+
**Signature:** `alert(title, message, onOk?)`
2075+
2076+
Show an alert dialog (HUD convenience popup)
2077+
2078+
**Parameters:**
2079+
2080+
| Name | Type | Description | Optional |
2081+
|------|------|-------------|----------|
2082+
| `title` | `string` | Title (optional) | No |
2083+
| `message` | `string` | Message | No |
2084+
| `onOk` | `function` | OK callback | Yes |
2085+
2086+
**Returns:** `Window`
2087+
2088+
---
2089+
2090+
### `hud.confirm`
2091+
2092+
**Signature:** `confirm(title, message, onConfirm?, onCancel?)`
2093+
2094+
Show a confirm dialog (confirm/cancel)
2095+
2096+
**Parameters:**
2097+
2098+
| Name | Type | Description | Optional |
2099+
|------|------|-------------|----------|
2100+
| `title` | `string` | Title (optional) | No |
2101+
| `message` | `string` | Message | No |
2102+
| `onConfirm` | `function` | Confirm callback | Yes |
2103+
| `onCancel` | `function` | Cancel callback | Yes |
2104+
2105+
**Returns:** `Window`
2106+
2107+
---
2108+
2109+
### `hud.dialog`
2110+
2111+
**Signature:** `dialog(title, message, onConfirm?, onCancel?)`
2112+
2113+
Dialog (alias of confirm)
2114+
2115+
**Parameters:**
2116+
2117+
| Name | Type | Description | Optional |
2118+
|------|------|-------------|----------|
2119+
| `title` | `string` | Title (optional) | No |
2120+
| `message` | `string` | Message | No |
2121+
| `onConfirm` | `function` | Confirm callback | Yes |
2122+
| `onCancel` | `function` | Cancel callback | Yes |
2123+
2124+
**Returns:** `Window`
2125+
2126+
---
2127+
2128+
### `hud.toast`
2129+
2130+
**Signature:** `toast(message, duration?)`
2131+
2132+
Show a toast message
2133+
2134+
**Parameters:**
2135+
2136+
| Name | Type | Description | Optional |
2137+
|------|------|-------------|----------|
2138+
| `message` | `string` | Message | No |
2139+
| `duration` | `number` | Duration in seconds, default 2.0 | Yes |
2140+
2141+
**Returns:** `Window \| null`
2142+
2143+
---
2144+
20702145
## util
20712146

20722147
![Full Support](https://img.shields.io/badge/Trigger-Full-brightgreen)
@@ -4025,3 +4100,64 @@ Open system settings
40254100

40264101
---
40274102

4103+
## miniapp
4104+
4105+
![Full Support](https://img.shields.io/badge/Trigger-Full-brightgreen)
4106+
4107+
MiniApp - Full-screen interactive multi-page application
4108+
4109+
> **Trigger Note:** MiniApp is presented as fullScreenCover during script execution, JS engine stays alive via ActiveBridgeManager
4110+
4111+
*No methods available.*
4112+
4113+
## widget
4114+
4115+
![Full Support](https://img.shields.io/badge/Trigger-Full-brightgreen)
4116+
4117+
Widget - Scriptable-compatible iOS Home Screen widgets
4118+
4119+
> **Trigger Note:** Widget tree is serialized and saved to App Group, rendered by Widget Extension
4120+
4121+
### `widget.setWidget`
4122+
4123+
**Signature:** `Script.setWidget(widget)`
4124+
4125+
Save the Widget tree as widget data
4126+
4127+
**Parameters:**
4128+
4129+
| Name | Type | Description | Optional |
4130+
|------|------|-------------|----------|
4131+
| `widget` | `ListWidget` | Widget root container instance | No |
4132+
4133+
**Returns:** `void`
4134+
4135+
---
4136+
4137+
### `widget.complete`
4138+
4139+
**Signature:** `Script.complete()`
4140+
4141+
Notify script execution is complete (Scriptable compatible)
4142+
4143+
**Returns:** `void`
4144+
4145+
---
4146+
4147+
### `widget.preview`
4148+
4149+
**Signature:** `Widget.preview(widget, family?)`
4150+
4151+
Preview a Widget in MiniApp interface without saving to App Group. Shows a preview sheet overlay with size selector.
4152+
4153+
**Parameters:**
4154+
4155+
| Name | Type | Description | Optional |
4156+
|------|------|-------------|----------|
4157+
| `widget` | `ListWidget` | Widget root container instance to preview | No |
4158+
| `family` | `string` | Initial preview size: 'small', 'medium' (default), or 'large' | Yes |
4159+
4160+
**Returns:** `void`
4161+
4162+
---
4163+

‎API.md‎

Lines changed: 136 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,8 @@ The following icons indicate API compatibility when running in background trigge
3737
- [sql](#sql) ✅ - SQLite 数据库操作
3838
- [shortcuts](#shortcuts) ❌ - 快捷指令操作
3939
- [system](#system) ✅ - 系统设置控制
40+
- [miniapp](#miniapp) ✅ - 迷你应用 - 全屏交互式多页面应用
41+
- [widget](#widget) ✅ - 小组件 - Scriptable 兼容的 iOS 主屏幕小组件
4042

4143
---
4244

@@ -2066,6 +2068,79 @@ HUD 浮窗系统 - 创建悬浮窗口和 UI 元素
20662068

20672069
---
20682070

2071+
### `hud.alert`
2072+
2073+
**Signature:** `alert(title, message, onOk?)`
2074+
2075+
显示提示对话框（HUD 快捷弹窗）
2076+
2077+
**Parameters:**
2078+
2079+
| Name | Type | Description | Optional |
2080+
|------|------|-------------|----------|
2081+
| `title` | `string` | 标题（可为空） | No |
2082+
| `message` | `string` | 提示内容 | No |
2083+
| `onOk` | `function` | 点击确定回调 | Yes |
2084+
2085+
**Returns:** `Window`
2086+
2087+
---
2088+
2089+
### `hud.confirm`
2090+
2091+
**Signature:** `confirm(title, message, onConfirm?, onCancel?)`
2092+
2093+
显示确认对话框（确认/取消）
2094+
2095+
**Parameters:**
2096+
2097+
| Name | Type | Description | Optional |
2098+
|------|------|-------------|----------|
2099+
| `title` | `string` | 标题（可为空） | No |
2100+
| `message` | `string` | 提示内容 | No |
2101+
| `onConfirm` | `function` | 点击确认回调 | Yes |
2102+
| `onCancel` | `function` | 点击取消回调 | Yes |
2103+
2104+
**Returns:** `Window`
2105+
2106+
---
2107+
2108+
### `hud.dialog`
2109+
2110+
**Signature:** `dialog(title, message, onConfirm?, onCancel?)`
2111+
2112+
对话框（confirm 的别名）
2113+
2114+
**Parameters:**
2115+
2116+
| Name | Type | Description | Optional |
2117+
|------|------|-------------|----------|
2118+
| `title` | `string` | 标题（可为空） | No |
2119+
| `message` | `string` | 提示内容 | No |
2120+
| `onConfirm` | `function` | 点击确认回调 | Yes |
2121+
| `onCancel` | `function` | 点击取消回调 | Yes |
2122+
2123+
**Returns:** `Window`
2124+
2125+
---
2126+
2127+
### `hud.toast`
2128+
2129+
**Signature:** `toast(message, duration?)`
2130+
2131+
显示 Toast 提示
2132+
2133+
**Parameters:**
2134+
2135+
| Name | Type | Description | Optional |
2136+
|------|------|-------------|----------|
2137+
| `message` | `string` | 提示内容 | No |
2138+
| `duration` | `number` | 显示时长（秒），默认 2.0 | Yes |
2139+
2140+
**Returns:** `Window \| null`
2141+
2142+
---
2143+
20692144
## util
20702145

20712146
![Full Support](https://img.shields.io/badge/Trigger-Full-brightgreen)
@@ -3854,3 +3929,64 @@ execute() 的别名
38543929

38553930
---
38563931

3932+
## miniapp
3933+
3934+
![Full Support](https://img.shields.io/badge/Trigger-Full-brightgreen)
3935+
3936+
迷你应用 - 全屏交互式多页面应用
3937+
3938+
> **Trigger Note:** MiniApp 在脚本运行期间以 fullScreenCover 方式呈现，JS 引擎通过 ActiveBridgeManager 保持存活
3939+
3940+
*No methods available.*
3941+
3942+
## widget
3943+
3944+
![Full Support](https://img.shields.io/badge/Trigger-Full-brightgreen)
3945+
3946+
小组件 - Scriptable 兼容的 iOS 主屏幕小组件
3947+
3948+
> **Trigger Note:** Widget 树序列化保存到 App Group，由 Widget Extension 渲染
3949+
3950+
### `widget.setWidget`
3951+
3952+
**Signature:** `Script.setWidget(widget)`
3953+
3954+
将 Widget 树保存为小组件数据
3955+
3956+
**Parameters:**
3957+
3958+
| Name | Type | Description | Optional |
3959+
|------|------|-------------|----------|
3960+
| `widget` | `ListWidget` | Widget 根容器实例 | No |
3961+
3962+
**Returns:** `void`
3963+
3964+
---
3965+
3966+
### `widget.complete`
3967+
3968+
**Signature:** `Script.complete()`
3969+
3970+
通知脚本执行完毕（兼容 Scriptable）
3971+
3972+
**Returns:** `void`
3973+
3974+
---
3975+
3976+
### `widget.preview`
3977+
3978+
**Signature:** `Widget.preview(widget, family?)`
3979+
3980+
在 MiniApp 界面预览小组件，不保存到 App Group。弹出预览 Sheet 并支持切换尺寸。
3981+
3982+
**Parameters:**
3983+
3984+
| Name | Type | Description | Optional |
3985+
|------|------|-------------|----------|
3986+
| `widget` | `ListWidget` | 要预览的 Widget 根容器实例 | No |
3987+
| `family` | `string` | 初始预览尺寸: 'small'、'medium'（默认）或 'large' | Yes |
3988+
3989+
**Returns:** `void`
3990+
3991+
---
3992+

‎TrollScript-Private‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
Subproject commit 633dc0bb92e2589b4a764021bfa90bde2840a716
1+
Subproject commit f87fdac1808e9066ba03ac98c6eeed42a95f4ac5

‎npm/index.d.ts‎

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -876,6 +876,39 @@ interface Hud {
876876
*/
877877
getAllWindows(): any;
878878

879+
/**
880+
* 显示提示对话框（HUD 快捷弹窗）
881+
* @param title 标题（可为空）
882+
* @param message 提示内容
883+
* @param onOk 点击确定回调
884+
*/
885+
alert(title: string, message: string, onOk?: any): any;
886+
887+
/**
888+
* 显示确认对话框（确认/取消）
889+
* @param title 标题（可为空）
890+
* @param message 提示内容
891+
* @param onConfirm 点击确认回调
892+
* @param onCancel 点击取消回调
893+
*/
894+
confirm(title: string, message: string, onConfirm?: any, onCancel?: any): any;
895+
896+
/**
897+
* 对话框（confirm 的别名）
898+
* @param title 标题（可为空）
899+
* @param message 提示内容
900+
* @param onConfirm 点击确认回调
901+
* @param onCancel 点击取消回调
902+
*/
903+
dialog(title: string, message: string, onConfirm?: any, onCancel?: any): any;
904+
905+
/**
906+
* 显示 Toast 提示
907+
* @param message 提示内容
908+
* @param duration 显示时长（秒），默认 2.0
909+
*/
910+
toast(message: string, duration?: number): any;
911+
879912
}
880913

881914
declare const hud: Hud;
@@ -1665,3 +1698,31 @@ interface System {
16651698
}
16661699

16671700
declare const system: System;
1701+
1702+
interface Miniapp {
1703+
}
1704+
1705+
declare const miniapp: Miniapp;
1706+
1707+
interface Widget {
1708+
/**
1709+
* 将 Widget 树保存为小组件数据
1710+
* @param widget Widget 根容器实例
1711+
*/
1712+
setWidget(widget: any): void;
1713+
1714+
/**
1715+
* 通知脚本执行完毕（兼容 Scriptable）
1716+
*/
1717+
complete(): void;
1718+
1719+
/**
1720+
* 在 MiniApp 界面预览小组件，不保存到 App Group。弹出预览 Sheet 并支持切换尺寸。
1721+
* @param widget 要预览的 Widget 根容器实例
1722+
* @param family 初始预览尺寸: 'small'、'medium'（默认）或 'large'
1723+
*/
1724+
preview(widget: any, family?: string): void;
1725+
1726+
}
1727+
1728+
declare const widget: Widget;

0 commit comments

Comments
 (0)