@bettergi/utils 0.0.10 → 0.1.0

package/dist/workflow.js

@@ -0,0 +1,72 @@
+/** 默认最大重试次数 */
+const defaultMaxAttempts = 5;
+/** 默认重试间隔（毫秒） */
+const defaultRetryInterval = 1000;
+/**
+ * 等待直到条件满足或超时，期间执行重试操作
+ * @param condition 返回条件是否满足的函数
+ * @param retryAction 每次重试时执行的操作（可选）
+ * @param options 配置选项
+ * @returns - true  条件满足
+ *          - false 达到最大重试次数
+ */
+export const waitForAction = async (condition, retryAction, options) => {
+    const { maxAttempts = defaultMaxAttempts, retryInterval = defaultRetryInterval } = options || {};
+    for (let i = 0; i < maxAttempts; i++) {
+        if (condition())
+            return true;
+        await retryAction?.();
+        await sleep(retryInterval);
+    }
+    return false;
+};
+/**
+ * 等待某个区域出现，期间执行重试操作
+ * @param regionProvider 返回区域的函数
+ * @param retryAction 每次重试时执行的操作（可选）
+ * @param options 配置选项
+ * @returns - true  区域出现
+ *          - false 达到最大重试次数
+ */
+export const waitForRegionAppear = async (regionProvider, retryAction, options) => {
+    return waitForAction(() => {
+        const region = regionProvider();
+        return region != null && region.isExist();
+    }, retryAction, options);
+};
+/**
+ * 等待某个区域消失，期间执行重试操作
+ * @param regionProvider 返回区域的函数
+ * @param retryAction 每次重试时执行的操作（可选）
+ * @param options 配置选项
+ * @returns - true  区域消失
+ *          - false 达到最大重试次数
+ */
+export const waitForRegionDisappear = async (regionProvider, retryAction, options) => {
+    return waitForAction(() => {
+        const region = regionProvider();
+        return !region || !region.isExist();
+    }, retryAction, options);
+};
+/**
+ * 等待整个画面上某个元素出现，期间执行重试操作
+ * @param recognitionObject 识别对象
+ * @param retryAction 每次重试时执行的操作（可选）
+ * @param options 配置选项
+ * @returns - true  整个画面上某个元素出现
+ *          - false 达到最大重试次数
+ */
+export const waitForElementAppear = async (recognitionObject, retryAction, options) => {
+    return waitForRegionAppear(() => captureGameRegion().find(recognitionObject), retryAction, options);
+};
+/**
+ * 等待整个画面上某个元素消失，期间执行重试操作
+ * @param recognitionObject 识别对象
+ * @param retryAction 每次重试时执行的操作（可选）
+ * @param options 配置选项
+ * @returns - true  整个画面上某个元素消失
+ *          - false 达到最大重试次数
+ */
+export const waitForElementDisappear = async (recognitionObject, retryAction, options) => {
+    return waitForRegionDisappear(() => captureGameRegion().find(recognitionObject), retryAction, options);
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bettergi/utils",
-  "version": "0.0.10",
+  "version": "0.1.0",
   "description": "开发 BetterGI 脚本常用工具集",
   "type": "module",
   "author": "Bread Grocery<https://github.com/breadgrocery>",
@@ -33,7 +33,7 @@
     "build": "tsc"
   },
   "devDependencies": {
-    "@bettergi/types": "^0.0.13",
-    "typescript": "5.6.3"
+    "@bettergi/types": "^0.1.1",
+    "typescript": "^5.9.3"
   }
 }