ms-vite-plugin 1.5.12 → 1.5.13

package/docs/api/jbclear.md

@@ -144,14 +144,14 @@ jbclear.appData("demo.sample.app");
 ### getIdfa - 读取整机广告标识（IDFA）。
 
 ```typescript
-function getIdfa(): string | null;
+function getIdfa(): string | undefined;
 ```
 
 **返回值:**
 
 | 类型             | 描述                           |
 | ---------------- | ------------------------------ |
-| `string \| null` | UUID 字符串；读不到返回 `null` |
+| `string \| undefined` | UUID 字符串；读不到返回 `undefined` |
 
 **示例:**
 
@@ -164,14 +164,14 @@ const idfa = jbclear.getIdfa();
 之后所有 App 读到的 IDFA 都会变。
 
 ```typescript
-function resetIdfa(): string | null;
+function resetIdfa(): string | undefined;
 ```
 
 **返回值:**
 
 | 类型             | 描述                           |
 | ---------------- | ------------------------------ |
-| `string \| null` | 重置前的 UUID；失败返回 `null` |
+| `string \| undefined` | 重置前的 UUID；失败返回 `undefined` |
 
 **示例:**
 
@@ -185,7 +185,7 @@ if (old) {
 ### setIdfa - 写入整机广告标识（IDFA）。
 
 ```typescript
-function setIdfa(value: string): string | null;
+function setIdfa(value: string): string | undefined;
 ```
 
 **参数:**
@@ -198,7 +198,7 @@ function setIdfa(value: string): string | null;
 
 | 类型             | 描述                           |
 | ---------------- | ------------------------------ |
-| `string \| null` | 写入前的 UUID；失败返回 `null` |
+| `string \| undefined` | 写入前的 UUID；失败返回 `undefined` |
 
 **示例:**
 
@@ -212,7 +212,7 @@ if (old) {
 ### getIdfv - 读取指定应用所属开发商的 IDFV。
 
 ```typescript
-function getIdfv(bundleId: string): string | null;
+function getIdfv(bundleId: string): string | undefined;
 ```
 
 **参数:**
@@ -225,7 +225,7 @@ function getIdfv(bundleId: string): string | null;
 
 | 类型             | 描述                           |
 | ---------------- | ------------------------------ |
-| `string \| null` | UUID 字符串；读不到返回 `null` |
+| `string \| undefined` | UUID 字符串；读不到返回 `undefined` |
 
 **示例:**
 
@@ -238,7 +238,7 @@ const idfv = jbclear.getIdfv("demo.sample.app");
 同一开发商的 App 会一起变。
 
 ```typescript
-function resetIdfv(bundleId: string): string | null;
+function resetIdfv(bundleId: string): string | undefined;
 ```
 
 **参数:**
@@ -251,7 +251,7 @@ function resetIdfv(bundleId: string): string | null;
 
 | 类型             | 描述                           |
 | ---------------- | ------------------------------ |
-| `string \| null` | 重置前的 UUID；失败返回 `null` |
+| `string \| undefined` | 重置前的 UUID；失败返回 `undefined` |
 
 **示例:**
 
@@ -265,7 +265,7 @@ if (old) {
 ### setIdfv - 写入指定应用所属开发商的 IDFV。
 
 ```typescript
-function setIdfv(bundleId: string, value: string): string | null;
+function setIdfv(bundleId: string, value: string): string | undefined;
 ```
 
 **参数:**
@@ -279,7 +279,7 @@ function setIdfv(bundleId: string, value: string): string | null;
 
 | 类型             | 描述                           |
 | ---------------- | ------------------------------ |
-| `string \| null` | 写入前的 UUID；失败返回 `null` |
+| `string \| undefined` | 写入前的 UUID；失败返回 `undefined` |
 
 **示例:**
 

package/docs/api/jbdevice.md

@@ -79,14 +79,14 @@ jbdevice.restoreAutoLock();
 `0` 表示不自动锁屏。
 
 ```typescript
-function getAutoLockMinutes(): number | null;
+function getAutoLockMinutes(): number | undefined;
 ```
 
 **返回值:**
 
 | 类型              | 描述                     |
 | ----------------- | ------------------------ |
-| `number \| null`  | 分钟数；读不到返回 `null` |
+| `number \| undefined`  | 分钟数；读不到返回 `undefined` |
 
 **示例:**
 
@@ -97,14 +97,14 @@ const minutes = jbdevice.getAutoLockMinutes();
 ### serialNumber - 读取设备序列号。
 
 ```typescript
-function serialNumber(): string | null;
+function serialNumber(): string | undefined;
 ```
 
 **返回值:**
 
 | 类型              | 描述                     |
 | ----------------- | ------------------------ |
-| `string \| null`  | 序列号；读不到返回 `null` |
+| `string \| undefined`  | 序列号；读不到返回 `undefined` |
 
 **示例:**
 
@@ -115,14 +115,14 @@ const serial = jbdevice.serialNumber();
 ### wifiMac - 读取本机 Wi-Fi MAC。
 
 ```typescript
-function wifiMac(): string | null;
+function wifiMac(): string | undefined;
 ```
 
 **返回值:**
 
 | 类型              | 描述                                          |
 | ----------------- | --------------------------------------------- |
-| `string \| null`  | `aa:bb:cc:dd:ee:ff` 形式；读不到返回 `null` |
+| `string \| undefined`  | `aa:bb:cc:dd:ee:ff` 形式；读不到返回 `undefined` |
 
 **示例:**
 
@@ -132,17 +132,17 @@ const mac = jbdevice.wifiMac();
 
 ### wifiInfo - 读取当前已连接无线网信息。
 
-没连上返回 `null`。
+没连上返回 `undefined`。
 
 ```typescript
-function wifiInfo(): WifiInfo | null;
+function wifiInfo(): WifiInfo | undefined;
 ```
 
 **返回值:**
 
 | 类型                 | 描述                         |
 | -------------------- | ---------------------------- |
-| `WifiInfo \| null`   | Wi-Fi 信息；没连上返回 `null` |
+| `WifiInfo \| undefined`   | Wi-Fi 信息；没连上返回 `undefined` |
 
 **示例:**
 
@@ -192,14 +192,14 @@ jbdevice.wifiOff();
 ### isWifiOn - 读取 Wi-Fi 是否打开。
 
 ```typescript
-function isWifiOn(): boolean | null;
+function isWifiOn(): boolean | undefined;
 ```
 
 **返回值:**
 
 | 类型               | 描述                           |
 | ------------------ | ------------------------------ |
-| `boolean \| null`  | 当前是否打开；读不到返回 `null` |
+| `boolean \| undefined`  | 当前是否打开；读不到返回 `undefined` |
 
 **示例:**
 
@@ -246,14 +246,14 @@ jbdevice.bluetoothOff();
 ### isBluetoothOn - 读取蓝牙是否打开。
 
 ```typescript
-function isBluetoothOn(): boolean | null;
+function isBluetoothOn(): boolean | undefined;
 ```
 
 **返回值:**
 
 | 类型               | 描述                           |
 | ------------------ | ------------------------------ |
-| `boolean \| null`  | 当前是否打开；读不到返回 `null` |
+| `boolean \| undefined`  | 当前是否打开；读不到返回 `undefined` |
 
 **示例:**
 
@@ -302,14 +302,14 @@ jbdevice.cellularOff();
 没有蜂窝能力时失败。
 
 ```typescript
-function isCellularOn(): boolean | null;
+function isCellularOn(): boolean | undefined;
 ```
 
 **返回值:**
 
 | 类型               | 描述                           |
 | ------------------ | ------------------------------ |
-| `boolean \| null`  | 当前是否打开；读不到返回 `null` |
+| `boolean \| undefined`  | 当前是否打开；读不到返回 `undefined` |
 
 **示例:**
 
@@ -356,14 +356,14 @@ jbdevice.airplaneOff();
 ### isAirplaneOn - 读取飞行模式是否打开。
 
 ```typescript
-function isAirplaneOn(): boolean | null;
+function isAirplaneOn(): boolean | undefined;
 ```
 
 **返回值:**
 
 | 类型               | 描述                           |
 | ------------------ | ------------------------------ |
-| `boolean \| null`  | 当前是否打开；读不到返回 `null` |
+| `boolean \| undefined`  | 当前是否打开；读不到返回 `undefined` |
 
 **示例:**
 
@@ -430,14 +430,14 @@ jbdevice.forgetWifi("Office");
 没有已存网络时是空数组。
 
 ```typescript
-function listWifi(): WifiInfo[] | null;
+function listWifi(): WifiInfo[] | undefined;
 ```
 
 **返回值:**
 
 | 类型                   | 描述                             |
 | ---------------------- | -------------------------------- |
-| `WifiInfo[] \| null`   | Wi-Fi 信息数组；读失败返回 `null` |
+| `WifiInfo[] \| undefined`   | Wi-Fi 信息数组；读失败返回 `undefined` |
 
 **示例:**
 
@@ -455,7 +455,7 @@ if (list) {
 会先打开 Wi-Fi。附近没有网时是空数组。
 
 ```typescript
-function scanWifi(timeoutMs?: number): WifiInfo[] | null;
+function scanWifi(timeoutMs?: number): WifiInfo[] | undefined;
 ```
 
 **参数:**
@@ -468,7 +468,7 @@ function scanWifi(timeoutMs?: number): WifiInfo[] | null;
 
 | 类型                   | 描述                             |
 | ---------------------- | -------------------------------- |
-| `WifiInfo[] \| null`   | Wi-Fi 信息数组；扫失败返回 `null` |
+| `WifiInfo[] \| undefined`   | Wi-Fi 信息数组；扫失败返回 `undefined` |
 
 **示例:**
 
@@ -512,14 +512,14 @@ jbdevice.setVolume(0.5);
 范围 `0.0-1.0`。
 
 ```typescript
-function getVolume(): number | null;
+function getVolume(): number | undefined;
 ```
 
 **返回值:**
 
 | 类型              | 描述                       |
 | ----------------- | -------------------------- |
-| `number \| null`  | 当前音量；读不到返回 `null` |
+| `number \| undefined`  | 当前音量；读不到返回 `undefined` |
 
 **示例:**
 
@@ -558,14 +558,14 @@ jbdevice.setBrightness(0.5);
 范围 `0.0-1.0`。
 
 ```typescript
-function getBrightness(): number | null;
+function getBrightness(): number | undefined;
 ```
 
 **返回值:**
 
 | 类型              | 描述                       |
 | ----------------- | -------------------------- |
-| `number \| null`  | 当前亮度；读不到返回 `null` |
+| `number \| undefined`  | 当前亮度；读不到返回 `undefined` |
 
 **示例:**
 

package/docs/api/jbdraw.md

@@ -0,0 +1,139 @@
+# 绘制模块 (JBDraw)
+
+仅越狱包可用。免越狱包没有 `jbdraw`。
+
+在屏幕上画矩形和文字。每画一次返回一个 id，可用 `clear` 去掉这一条，或 `clearAll` 全部去掉。坐标为像素坐标。
+
+颜色只接受 `#RRGGBB` 和 `#RRGGBBAA`。需要字加底时先画填充矩形，再画文字。
+
+## 类型
+
+```typescript
+interface JbDrawRectOptions {
+  color?: string;
+  lineWidth?: number;
+  fill?: string;
+}
+
+interface JbDrawTextOptions {
+  color?: string;
+  fontSize?: number;
+}
+```
+
+| 字段        | 类型     | 描述                                                         |
+| ----------- | -------- | ------------------------------------------------------------ |
+| `color`     | string   | `#RRGGBB` 或 `#RRGGBBAA`。矩形默认 `#FF0000`，文字默认 `#FFFFFF` |
+| `lineWidth` | number   | 边框宽度。省略为 `2`。`<= 0` 不画边框                         |
+| `fill`      | string   | 填充颜色，同 `color` 格式。省略不填充                         |
+| `fontSize`  | number   | 系统字号。省略为 `16`。`<= 0` 时画字失败                      |
+
+## API 参考
+
+### rect - 在屏幕上画矩形。
+
+需要字加底时先画填充矩形，再 `text`。
+
+```typescript
+function rect(
+  x: number,
+  y: number,
+  width: number,
+  height: number,
+  options?: JbDrawRectOptions
+): number;
+```
+
+**参数:**
+
+| 参数名    | 类型                | 是否必填 | 默认值 | 描述                               |
+| --------- | ------------------- | -------- | ------ | ---------------------------------- |
+| `x`       | number              | 是       | -      | 左上角 x，像素坐标                 |
+| `y`       | number              | 是       | -      | 左上角 y，像素坐标                 |
+| `width`   | number              | 是       | -      | 宽度，必须大于 0                   |
+| `height`  | number              | 是       | -      | 高度，必须大于 0                   |
+| `options` | JbDrawRectOptions   | 否       | -      | 颜色、边框、填充                   |
+
+**返回值:**
+
+| 类型     | 描述                           |
+| -------- | ------------------------------ |
+| `number` | 成功为 id（从 1 起）；失败为 `0` |
+
+**示例:**
+
+```javascript
+const box = jbdraw.rect(20, 80, 200, 40, { fill: "#000000AA", lineWidth: 0 });
+const frame = jbdraw.rect(20, 140, 120, 80, { color: "#FF0000", lineWidth: 2 });
+```
+
+### text - 在屏幕上画文字。
+
+左上角对齐，没有背景。
+
+```typescript
+function text(
+  x: number,
+  y: number,
+  text: string,
+  options?: JbDrawTextOptions
+): number;
+```
+
+**参数:**
+
+| 参数名    | 类型                | 是否必填 | 默认值 | 描述                               |
+| --------- | ------------------- | -------- | ------ | ---------------------------------- |
+| `x`       | number              | 是       | -      | 文字左上角 x，像素坐标             |
+| `y`       | number              | 是       | -      | 文字左上角 y，像素坐标             |
+| `text`    | string              | 是       | -      | 要画的字符串                       |
+| `options` | JbDrawTextOptions   | 否       | -      | 颜色和字号                         |
+
+**返回值:**
+
+| 类型     | 描述                           |
+| -------- | ------------------------------ |
+| `number` | 成功为 id（从 1 起）；失败为 `0` |
+
+**示例:**
+
+```javascript
+const box = jbdraw.rect(20, 80, 200, 40, { fill: "#000000AA", lineWidth: 0 });
+const label = jbdraw.text(28, 88, "hello", { color: "#FFFFFF", fontSize: 18 });
+```
+
+### clear - 去掉一个图形。
+
+```typescript
+function clear(id: number): boolean;
+```
+
+**参数:**
+
+| 参数名 | 类型   | 是否必填 | 默认值 | 描述                     |
+| ------ | ------ | -------- | ------ | ------------------------ |
+| `id`   | number | 是       | -      | `rect` / `text` 返回的 id |
+
+**返回值:**
+
+| 类型      | 描述                   |
+| --------- | ---------------------- |
+| `boolean` | 找到并移除为 `true`    |
+
+**示例:**
+
+```javascript
+jbdraw.clear(label);
+```
+
+### clearAll - 去掉当前全部图形。
+
+```typescript
+function clearAll(): void;
+```
+
+**示例:**
+
+```javascript
+jbdraw.clearAll();
+```

package/docs/api/jbdylib.md

@@ -39,7 +39,7 @@
 function open(
   name: string,
   defs?: Record<string, string | [string] | [string, string[]]>
-): JbDylibLib | null;
+): JbDylibLib | undefined;
 ```
 
 **参数:**
@@ -53,7 +53,7 @@ function open(
 
 | 类型               | 描述                               |
 | ------------------ | ---------------------------------- |
-| `JbDylibLib \| null` | 加载成功返回库对象，失败返回 `null` |
+| `JbDylibLib \| undefined` | 加载成功返回库对象，失败返回 `undefined` |
 
 **示例:**
 
@@ -103,7 +103,7 @@ interface JbDylibLib {
   define(symbol: string, retType: string, argTypes?: string[]): boolean;
   defineAll(specs: Record<string, string | [string] | [string, string[]]>): boolean;
   call(symbol: string, ...args: any[]): any;
-  symbol(name: string): string | null;
+  symbol(name: string): string | undefined;
 }
 ```
 
@@ -181,7 +181,7 @@ function call(symbol: string, ...args: any[]): any;
 
 | 类型  | 描述                                               |
 | ----- | -------------------------------------------------- |
-| `any` | 调用成功返回结果；`void` 成功返回 `true`；失败返回 `null` |
+| `any` | 调用成功返回结果；`void` 成功返回 `true`；失败返回 `undefined` |
 
 **示例:**
 
@@ -196,7 +196,7 @@ lib.call("mylib_touch");
 ### symbol - 解析导出符号地址。
 
 ```typescript
-function symbol(name: string): string | null;
+function symbol(name: string): string | undefined;
 ```
 
 **参数:**
@@ -209,7 +209,7 @@ function symbol(name: string): string | null;
 
 | 类型             | 描述                                       |
 | ---------------- | ------------------------------------------ |
-| `string \| null` | 成功返回 `"0x..."` 地址，失败返回 `null` |
+| `string \| undefined` | 成功返回 `"0x..."` 地址，失败返回 `undefined` |
 
 **示例:**
 

package/docs/api/jbpower.md

@@ -0,0 +1,85 @@
+# 电源模块 (JBPower)
+
+仅越狱包可用。免越狱包没有 `jbpower`。
+
+`info` 读取电量百分比、电流、电压和充电状态。`stopCharging` 停止充电并保持，直到调用 `startCharging`。
+
+电流单位是毫安，正数表示正在进电。电压单位是毫伏。
+
+## API 参考
+
+### info - 读取当前电源信息。
+
+```typescript
+function info(): PowerInfo | undefined;
+```
+
+**返回值:**
+
+| 类型                  | 描述                         |
+| --------------------- | ---------------------------- |
+| `PowerInfo`           | 读到电池时的电源信息         |
+| `undefined`           | 读不到电池                   |
+
+`PowerInfo` 字段：
+
+| 字段                 | 类型      | 描述                                              |
+| -------------------- | --------- | ------------------------------------------------- |
+| `percentage`         | `number`  | 电量百分比                                        |
+| `amperage`           | `number`  | 电流，单位毫安，正数表示正在进电                  |
+| `voltage`            | `number`  | 电压，单位毫伏                                    |
+| `charging`           | `boolean` | 系统是否认为正在充电                              |
+| `plugged`            | `boolean` | 电源状态是否为交流电                              |
+| `powerState`         | `string`  | `AC Power` 或 `Battery Power`                     |
+| `rawExternal`        | `boolean` | 发布出去的外接位                                  |
+| `showChargingUI`     | `boolean` | 主屏是否显示充电                                  |
+| `appleRawExternal`   | `boolean` | 硬件是否还认这根线                                |
+| `chargeOverride`     | `boolean` | 系统自己的停充覆盖                                |
+| `adapterWatts`       | `number`  | 适配器功率，单位瓦，读不到时为 0                  |
+
+**示例:**
+
+```javascript
+const power = jbpower.info();
+if (power) {
+  logd(power.percentage, power.amperage);
+}
+```
+
+### stopCharging - 停止充电。
+
+停止后会保持，直到 `startCharging`。
+
+```typescript
+function stopCharging(): boolean;
+```
+
+**返回值:**
+
+| 类型      | 描述           |
+| --------- | -------------- |
+| `boolean` | 写入成功为 `true` |
+
+**示例:**
+
+```javascript
+jbpower.stopCharging();
+```
+
+### startCharging - 恢复充电。
+
+```typescript
+function startCharging(): boolean;
+```
+
+**返回值:**
+
+| 类型      | 描述           |
+| --------- | -------------- |
+| `boolean` | 写入成功为 `true` |
+
+**示例:**
+
+```javascript
+jbpower.startCharging();
+```

package/docs/api/jbshell.md

@@ -25,7 +25,7 @@ interface JbShellResult {
 ### exec - 执行一条 shell 命令，等到结束或超时。
 
 ```typescript
-function exec(command: string, timeoutMs?: number): JbShellResult | null;
+function exec(command: string, timeoutMs?: number): JbShellResult | undefined;
 ```
 
 **参数:**
@@ -39,7 +39,7 @@ function exec(command: string, timeoutMs?: number): JbShellResult | null;
 
 | 类型                     | 描述                                                         |
 | ------------------------ | ------------------------------------------------------------ |
-| `JbShellResult \| null`  | 启动成功返回结果；空命令或启动失败返回 `null`。超时仍返回已捕获输出，`code` 为 `-1` |
+| `JbShellResult \| undefined`  | 启动成功返回结果；空命令或启动失败返回 `undefined`。超时仍返回已捕获输出，`code` 为 `-1` |
 
 **示例:**
 

package/docs/api/jbsystem.md

@@ -71,14 +71,14 @@ jbsystem.restartSelf();
 对应 `设置 > 隐私与安全性 > 跟踪 > 允许 App 请求跟踪`。
 
 ```typescript
-function getUserTracking(): boolean | null;
+function getUserTracking(): boolean | undefined;
 ```
 
 **返回值:**
 
 | 类型               | 描述                             |
 | ------------------ | -------------------------------- |
-| `boolean \| null`  | 当前是否允许；读失败返回 `null`  |
+| `boolean \| undefined`  | 当前是否允许；读失败返回 `undefined`  |
 
 **示例:**
 
@@ -119,14 +119,14 @@ jbsystem.setUserTracking(false);
 对应 `设置 > 隐私与安全性 > Apple 广告 > 个性化广告`。
 
 ```typescript
-function getPersonalizedAdvertising(): boolean | null;
+function getPersonalizedAdvertising(): boolean | undefined;
 ```
 
 **返回值:**
 
 | 类型               | 描述                             |
 | ------------------ | -------------------------------- |
-| `boolean \| null`  | 当前是否允许；读失败返回 `null`  |
+| `boolean \| undefined`  | 当前是否允许；读失败返回 `undefined`  |
 
 **示例:**
 
@@ -167,14 +167,14 @@ jbsystem.setPersonalizedAdvertising(false);
 对应 `设置 > 隐私与安全性 > 定位服务` 总开关。
 
 ```typescript
-function getLocationServices(): boolean | null;
+function getLocationServices(): boolean | undefined;
 ```
 
 **返回值:**
 
 | 类型               | 描述                             |
 | ------------------ | -------------------------------- |
-| `boolean \| null`  | 当前是否开启；读失败返回 `null`  |
+| `boolean \| undefined`  | 当前是否开启；读失败返回 `undefined`  |
 
 **示例:**