@vforsh/argus-watcher 0.5.6 → 0.5.7

package/dist/http/routes/visualCaptureRoute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visualCaptureRoute.js","sourceRoot":"","sources":["../../../src/http/routes/visualCaptureRoute.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,EAAE,sCAAsC,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AACrG,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAG9C,wFAAwF;AACxF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,GAAwB,EAAE,GAAiB,EAAW,EAAE;IACjG,IAAI,gBAAgB,CAAC,GAAG,CAAC,oBAAoB,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1D,OAAO,KAAK,CAAA;IACb,CAAC;IAED,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,eAAe,EAAE,sCAAsC,CAAC,CAAA;IAClF,OAAO,IAAI,CAAA;AACZ,CAAC,CAAA;AAED,uGAAuG;AACvG,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAAwB,EAAE,KAAc,EAAW,EAAE;IACvF,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,eAAe,CAAC,EAAE,CAAC;QAC3C,OAAO,KAAK,CAAA;IACb,CAAC;IAED,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,eAAe,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;IAClG,OAAO,IAAI,CAAA;AACZ,CAAC,CAAA"}

package/dist/runtime/watcherServices.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"watcherServices.d.ts","sourceRoot":"","sources":["../../src/runtime/watcherServices.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAGtD,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC5F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAE/D,MAAM,MAAM,sBAAsB,GAAG;IACpC,KAAK,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,oBAAoB,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,IAAI,CAAA;IACzE,QAAQ,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,CAAA;IAC3C,gBAAgB,EAAE,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,KAAK,IAAI,CAAA;IACvE,UAAU,EAAE,MAAM,IAAI,CAAA;IACtB,UAAU,EAAE,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,KAAK,IAAI,CAAA;IAC9E,QAAQ,EAAE,CAAC,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACzF,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,eAAe,KAAK,IAAI,CAAA;IACxF,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IACnC,sBAAsB,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAA;CACrD,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG;IACpC,YAAY,EAAE,eAAe,CAAA;IAC7B,cAAc,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,GAAG,IAAI,CAAA;IACvE,aAAa,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAA;IACrD,aAAa,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAA;IACrD,QAAQ,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAA;IAC3C,aAAa,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAA;CACrD,CAAA;AAED,eAAO,MAAM,4BAA4B,GACxC,SAAS,mBAAmB,EAC5B,OAAO,sBAAsB,EAC7B,WAAW,sBAAsB,KAC/B,sBAsFF,CAAA"}
+{"version":3,"file":"watcherServices.d.ts","sourceRoot":"","sources":["../../src/runtime/watcherServices.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAGtD,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAC5F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAE/D,MAAM,MAAM,sBAAsB,GAAG;IACpC,KAAK,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,oBAAoB,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,IAAI,CAAA;IACzE,QAAQ,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,CAAA;IAC3C,gBAAgB,EAAE,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,KAAK,IAAI,CAAA;IACvE,UAAU,EAAE,MAAM,IAAI,CAAA;IACtB,UAAU,EAAE,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,KAAK,IAAI,CAAA;IAC9E,QAAQ,EAAE,CAAC,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACzF,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,eAAe,KAAK,IAAI,CAAA;IACxF,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IACnC,sBAAsB,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAA;CACrD,CAAA;AAED,MAAM,MAAM,sBAAsB,GAAG;IACpC,YAAY,EAAE,eAAe,CAAA;IAC7B,cAAc,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,GAAG,IAAI,CAAA;IACvE,aAAa,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAA;IACrD,aAAa,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAA;IACrD,QAAQ,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAA;IAC3C,aAAa,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAA;CACrD,CAAA;AAED,eAAO,MAAM,4BAA4B,GACxC,SAAS,mBAAmB,EAC5B,OAAO,sBAAsB,EAC7B,WAAW,sBAAsB,KAC/B,sBA4FF,CAAA"}

package/dist/runtime/watcherServices.js

@@ -63,11 +63,17 @@ export const createWatcherRuntimeServices = (options, setup, callbacks) => {
             })
             : null,
         traceRecorder: createTraceRecorder({ session: sourceHandle.session, artifactsDir: artifactsBaseDir }),
-        screenshotter: createScreenshotter({ session: sourceHandle.session, pageSession, artifactsDir: artifactsBaseDir }),
+        screenshotter: createScreenshotter({
+            session: sourceHandle.session,
+            pageSession,
+            artifactsDir: artifactsBaseDir,
+            getVisibilityPolicy: () => setup.visibilityController.getPolicy(),
+        }),
         recorder: createRecorder({
             session: sourceHandle.session,
             pageSession,
             artifactsDir: artifactsBaseDir,
+            getVisibilityPolicy: () => setup.visibilityController.getPolicy(),
             onRecordingStateChange: callbacks.onRecordingStateChange,
         }),
         runtimeEditor: createRuntimeEditor(sourceHandle.session),

package/dist/runtime/watcherServices.js.map

@@ -1 +1 @@
-{"version":3,"file":"watcherServices.js","sourceRoot":"","sources":["../../src/runtime/watcherServices.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"watcherServices.js","sourceRoot":"","sources":["../../src/runtime/watcherServices.ts"],"names":[],"mappings":"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"}

package/dist/visibility/VisibilityController.d.ts

@@ -1,11 +1,11 @@
-import type { VisibilityLock } from '@vforsh/argus-core';
+import type { VisibilityLock, VisibilityPolicy } from '@vforsh/argus-core';
 import type { CdpSessionHandle } from '../cdp/connection.js';
 /**
  * Tracks the desired "show" lock and (re)applies it to the attached CDP session, so
  * `argus page show` is sticky until `argus page hide`.
  *
  * Implementation notes:
- * - `Page.bringToFront` is best-effort — a one-shot hint that raises the tab at call time.
+ * - `Page.bringToFront` is foreground-only and best-effort — a one-shot hint that raises the tab at call time.
  *   Failure is swallowed; some environments (headless, minimized OS windows, extension
  *   transport without a focused window) no-op it.
  * - `Emulation.setFocusEmulationEnabled({ enabled: true })` is the mechanism that keeps
@@ -15,10 +15,13 @@ import type { CdpSessionHandle } from '../cdp/connection.js';
 export type VisibilityController = {
     /** Current desired lock (what the next attach would apply). */
     getDesired: () => VisibilityLock;
-    /** Set the desired lock and apply to `session` now (if attached). Throws on CDP error. */
-    setLock: (session: CdpSessionHandle | null, lock: VisibilityLock) => Promise<void>;
+    /** Activation policy retained across lock changes and reattachment. */
+    getPolicy: () => VisibilityPolicy;
+    /** Set the desired lock and apply to `session` now (if attached). Throws on CDP error. `activate: false` suppresses raising only for this call. */
+    setLock: (session: CdpSessionHandle | null, lock: VisibilityLock, policy?: VisibilityPolicy, activate?: boolean) => Promise<void>;
     /** Called on every (re)attach; re-sends CDP commands when lock is `shown`. */
     onAttach: (session: CdpSessionHandle) => Promise<void>;
 };
+/** Build a visibility controller with a foreground policy until explicitly changed. */
 export declare const createVisibilityController: () => VisibilityController;
 //# sourceMappingURL=VisibilityController.d.ts.map

package/dist/visibility/VisibilityController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VisibilityController.d.ts","sourceRoot":"","sources":["../../src/visibility/VisibilityController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAG5D;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAClC,+DAA+D;IAC/D,UAAU,EAAE,MAAM,cAAc,CAAA;IAChC,0FAA0F;IAC1F,OAAO,EAAE,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,EAAE,IAAI,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAClF,8EAA8E;IAC9E,QAAQ,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACtD,CAAA;AAgBD,eAAO,MAAM,0BAA0B,QAAO,oBAyB7C,CAAA"}
+{"version":3,"file":"VisibilityController.d.ts","sourceRoot":"","sources":["../../src/visibility/VisibilityController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAG5D;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAClC,+DAA+D;IAC/D,UAAU,EAAE,MAAM,cAAc,CAAA;IAChC,uEAAuE;IACvE,SAAS,EAAE,MAAM,gBAAgB,CAAA;IACjC,mJAAmJ;IACnJ,OAAO,EAAE,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,gBAAgB,EAAE,QAAQ,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACjI,8EAA8E;IAC9E,QAAQ,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACtD,CAAA;AAED,uFAAuF;AACvF,eAAO,MAAM,0BAA0B,QAAO,oBAoC7C,CAAA"}

package/dist/visibility/VisibilityController.js

@@ -1,28 +1,26 @@
 import { createStickyController } from '../stickyController.js';
-const applyLock = async (session, lock) => {
-    if (lock !== 'shown') {
-        await session.sendAndWait('Emulation.setFocusEmulationEnabled', { enabled: false });
-        return;
-    }
-    try {
-        await session.sendAndWait('Page.bringToFront');
-    }
-    catch {
-        // Advisory — focus emulation below carries the weight.
-    }
-    await session.sendAndWait('Emulation.setFocusEmulationEnabled', { enabled: true });
-};
+/** Build a visibility controller with a foreground policy until explicitly changed. */
 export const createVisibilityController = () => {
+    let policy = 'foreground';
     const sticky = createStickyController({
         label: 'Visibility',
-        apply: applyLock,
+        apply: async (session, state) => {
+            await session.sendAndWait('Emulation.setFocusEmulationEnabled', { enabled: state === 'shown' });
+        },
         // Releasing the lock is the same operation as locking to `default`.
-        clear: (session) => applyLock(session, 'default'),
+        clear: async (session) => {
+            await session.sendAndWait('Emulation.setFocusEmulationEnabled', { enabled: false });
+        },
     });
     return {
         // `default` rather than null: visibility has no "unset", only "not locked shown".
         getDesired: () => sticky.getState().state ?? 'default',
-        setLock: async (session, lock) => {
+        getPolicy: () => policy,
+        setLock: async (session, lock, nextPolicy = policy, activate = true) => {
+            policy = nextPolicy;
+            if (lock === 'shown' && policy === 'foreground' && activate && session?.isAttached()) {
+                await bringToFront(session);
+            }
             const result = await sticky.setDesired(lock, session);
             // This controller reports CDP failure by throwing, unlike its two siblings.
             if (result.lastError) {
@@ -33,8 +31,18 @@ export const createVisibilityController = () => {
             if (sticky.getState().state !== 'shown') {
                 return;
             }
+            if (policy === 'foreground')
+                await bringToFront(session);
             await sticky.onAttach(session);
         },
     };
 };
+const bringToFront = async (session) => {
+    try {
+        await session.sendAndWait('Page.bringToFront');
+    }
+    catch {
+        // Advisory — focus emulation carries the weight.
+    }
+};
 //# sourceMappingURL=VisibilityController.js.map

package/dist/visibility/VisibilityController.js.map

@@ -1 +1 @@
-{"version":3,"file":"VisibilityController.js","sourceRoot":"","sources":["../../src/visibility/VisibilityController.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAuB/D,MAAM,SAAS,GAAG,KAAK,EAAE,OAAyB,EAAE,IAAoB,EAAiB,EAAE;IAC1F,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACtB,MAAM,OAAO,CAAC,WAAW,CAAC,oCAAoC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;QACnF,OAAM;IACP,CAAC;IAED,IAAI,CAAC;QACJ,MAAM,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAA;IAC/C,CAAC;IAAC,MAAM,CAAC;QACR,uDAAuD;IACxD,CAAC;IACD,MAAM,OAAO,CAAC,WAAW,CAAC,oCAAoC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;AACnF,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAyB,EAAE;IACpE,MAAM,MAAM,GAAG,sBAAsB,CAAiB;QACrD,KAAK,EAAE,YAAY;QACnB,KAAK,EAAE,SAAS;QAChB,oEAAoE;QACpE,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC;KACjD,CAAC,CAAA;IAEF,OAAO;QACN,kFAAkF;QAClF,UAAU,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,KAAK,IAAI,SAAS;QACtD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;YAChC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;YACrD,4EAA4E;YAC5E,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;YAC1C,CAAC;QACF,CAAC;QACD,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YAC3B,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;gBACzC,OAAM;YACP,CAAC;YACD,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;QAC/B,CAAC;KACD,CAAA;AACF,CAAC,CAAA"}
+{"version":3,"file":"VisibilityController.js","sourceRoot":"","sources":["../../src/visibility/VisibilityController.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAyB/D,uFAAuF;AACvF,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAyB,EAAE;IACpE,IAAI,MAAM,GAAqB,YAAY,CAAA;IAC3C,MAAM,MAAM,GAAG,sBAAsB,CAAiB;QACrD,KAAK,EAAE,YAAY;QACnB,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;YAC/B,MAAM,OAAO,CAAC,WAAW,CAAC,oCAAoC,EAAE,EAAE,OAAO,EAAE,KAAK,KAAK,OAAO,EAAE,CAAC,CAAA;QAChG,CAAC;QACD,oEAAoE;QACpE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACxB,MAAM,OAAO,CAAC,WAAW,CAAC,oCAAoC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;QACpF,CAAC;KACD,CAAC,CAAA;IAEF,OAAO;QACN,kFAAkF;QAClF,UAAU,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,KAAK,IAAI,SAAS;QACtD,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM;QACvB,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,EAAE,QAAQ,GAAG,IAAI,EAAE,EAAE;YACtE,MAAM,GAAG,UAAU,CAAA;YACnB,IAAI,IAAI,KAAK,OAAO,IAAI,MAAM,KAAK,YAAY,IAAI,QAAQ,IAAI,OAAO,EAAE,UAAU,EAAE,EAAE,CAAC;gBACtF,MAAM,YAAY,CAAC,OAAO,CAAC,CAAA;YAC5B,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;YACrD,4EAA4E;YAC5E,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;YAC1C,CAAC;QACF,CAAC;QACD,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YAC3B,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;gBACzC,OAAM;YACP,CAAC;YACD,IAAI,MAAM,KAAK,YAAY;gBAAE,MAAM,YAAY,CAAC,OAAO,CAAC,CAAA;YACxD,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;QAC/B,CAAC;KACD,CAAA;AACF,CAAC,CAAA;AAED,MAAM,YAAY,GAAG,KAAK,EAAE,OAAyB,EAAiB,EAAE;IACvE,IAAI,CAAC;QACJ,MAAM,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAA;IAC/C,CAAC;IAAC,MAAM,CAAC;QACR,iDAAiD;IAClD,CAAC;AACF,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vforsh/argus-watcher",
-	"version": "0.5.6",
+	"version": "0.5.7",
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/vforsh/argus.git",
@@ -27,7 +27,7 @@
 	},
 	"dependencies": {
 		"@jridgewell/trace-mapping": "^0.3.31",
-		"@vforsh/argus-core": "^0.5.4",
+		"@vforsh/argus-core": "^0.5.5",
 		"emittery": "^1.2.0"
 	},
 	"scripts": {