@vforsh/argus-core 0.1.5 → 0.1.7

package/dist/protocol/http/dom.js

@@ -1,2 +1,59 @@
-export {};
+import { defineProtocolSchema, invalidProtocolPayload, isProtocolObject, validProtocolPayload } from '../schema.js';
+/** Runtime list of mouse buttons accepted by click commands. */
+export const MOUSE_BUTTONS = ['left', 'middle', 'right'];
+/** Schema for POST /dom/click request payloads. */
+export const domClickRequestSchema = defineProtocolSchema((value) => {
+    if (!isProtocolObject(value)) {
+        return invalidProtocolPayload('request body must be an object');
+    }
+    const selector = optionalString(value, 'selector');
+    const ref = optionalString(value, 'ref');
+    const hasSelector = selector != null && selector.length > 0;
+    const hasRef = ref != null && ref.length > 0;
+    const hasCoords = value.x != null || value.y != null;
+    if (!hasSelector && !hasRef && !hasCoords) {
+        return invalidProtocolPayload('selector, ref, or x,y coordinates are required');
+    }
+    if (hasSelector && hasRef) {
+        return invalidProtocolPayload('selector and ref are mutually exclusive');
+    }
+    if (hasCoords && (!isFiniteNumber(value.x) || !isFiniteNumber(value.y))) {
+        return invalidProtocolPayload('both x and y must be finite numbers');
+    }
+    if (value.all != null && typeof value.all !== 'boolean') {
+        return invalidProtocolPayload('all must be a boolean');
+    }
+    if (value.button != null && !isMouseButton(value.button)) {
+        return invalidProtocolPayload(`button must be one of: ${MOUSE_BUTTONS.join(', ')}`);
+    }
+    if (value.wait != null && (!isFiniteNumber(value.wait) || value.wait < 0)) {
+        return invalidProtocolPayload('wait must be a non-negative number (ms)');
+    }
+    if (value.text != null && typeof value.text !== 'string') {
+        return invalidProtocolPayload('text must be a string');
+    }
+    const request = {
+        all: value.all ?? false,
+        button: value.button ?? 'left',
+        wait: value.wait ?? 0,
+    };
+    if (hasSelector)
+        request.selector = selector;
+    if (hasRef)
+        request.ref = ref;
+    if (hasCoords) {
+        request.x = value.x;
+        request.y = value.y;
+    }
+    if (typeof value.text === 'string') {
+        request.text = value.text;
+    }
+    return validProtocolPayload(request);
+});
+const optionalString = (value, key) => {
+    const field = value[key];
+    return typeof field === 'string' ? field : undefined;
+};
+const isFiniteNumber = (value) => typeof value === 'number' && Number.isFinite(value);
+const isMouseButton = (value) => typeof value === 'string' && MOUSE_BUTTONS.includes(value);
 //# sourceMappingURL=dom.js.map

package/dist/protocol/http/dom.js.map

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

package/dist/protocol/http/eval.d.ts

@@ -1,6 +1,11 @@
 /** Request payload for POST /eval. */
 export type EvalRequest = {
     expression: string;
+    /**
+     * String-only values exposed to evaluated code as `args`.
+     * Watchers install them for the duration of the eval without rewriting source.
+     */
+    args?: Record<string, string>;
     awaitPromise?: boolean;
     /**
      * Enable Chrome's REPL evaluation mode.

package/dist/protocol/http/eval.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"eval.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/eval.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,MAAM,MAAM,WAAW,GAAG;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,OAAO,CAAA;CACvB,CAAA;AAED,uCAAuC;AACvC,MAAM,MAAM,YAAY,GAAG;IAC1B,EAAE,EAAE,IAAI,CAAA;IACR,MAAM,EAAE,OAAO,CAAA;IACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAA;CACrD,CAAA"}
+{"version":3,"file":"eval.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/eval.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,MAAM,MAAM,WAAW,GAAG;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,OAAO,CAAA;CACvB,CAAA;AAED,uCAAuC;AACvC,MAAM,MAAM,YAAY,GAAG;IAC1B,EAAE,EAAE,IAAI,CAAA;IACR,MAAM,EAAE,OAAO,CAAA;IACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAA;CACrD,CAAA"}

package/dist/protocol/http/extension.d.ts

@@ -0,0 +1,12 @@
+export type ExtensionBrowserTab = {
+    tabId: number;
+    url: string;
+    title: string;
+    faviconUrl?: string;
+    attached: boolean;
+};
+export type ExtensionTabsResponse = {
+    ok: true;
+    tabs: ExtensionBrowserTab[];
+};
+//# sourceMappingURL=extension.d.ts.map

package/dist/protocol/http/extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/extension.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IACnC,EAAE,EAAE,IAAI,CAAA;IACR,IAAI,EAAE,mBAAmB,EAAE,CAAA;CAC3B,CAAA"}

package/dist/protocol/http/extension.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=extension.js.map

package/dist/protocol/http/extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.js","sourceRoot":"","sources":["../../../src/protocol/http/extension.ts"],"names":[],"mappings":""}

package/dist/protocol/http/locate.d.ts

@@ -0,0 +1,46 @@
+import type { ElementRef } from './dom.js';
+/** Common matching options for semantic element lookup commands. */
+export type LocateMatchOptions = {
+    /** Allow multiple matches. If false and >1 match, the route returns an ambiguity error. */
+    all?: boolean;
+    /** Require an exact normalized string match instead of substring matching. */
+    exact?: boolean;
+};
+/** Element summary returned by semantic locator routes. */
+export type LocatedElement = {
+    /** Stable element ref that can be reused by ref-aware commands. */
+    ref: ElementRef;
+    /** Accessibility role used for semantic lookup. */
+    role: string;
+    /** Accessible name / label for the element. */
+    name: string;
+    /** Current accessible value when relevant. */
+    value?: string;
+    /** Lower-cased DOM tag name when it can be resolved. */
+    tag?: string;
+    /** Selected DOM attributes useful for quick inspection. */
+    attributes?: Record<string, string>;
+};
+export type LocateRoleRequest = LocateMatchOptions & {
+    /** Accessibility role to match (e.g. "button", "textbox", "link"). */
+    role: string;
+    /** Optional accessible name to match against the role result set. */
+    name?: string;
+};
+export type LocateTextRequest = LocateMatchOptions & {
+    /** Visible/accessible text to match against element names/values. */
+    text: string;
+};
+export type LocateLabelRequest = LocateMatchOptions & {
+    /** Form label / accessible name to match. */
+    label: string;
+};
+/** Shared response payload for `/locate/*` routes. */
+export type LocateResponse = {
+    ok: true;
+    /** Number of matched semantic elements before any `all=false` truncation. */
+    matches: number;
+    /** Element summaries for the resolved matches. */
+    elements: LocatedElement[];
+};
+//# sourceMappingURL=locate.d.ts.map

package/dist/protocol/http/locate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locate.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/locate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAE1C,oEAAoE;AACpE,MAAM,MAAM,kBAAkB,GAAG;IAChC,2FAA2F;IAC3F,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,8EAA8E;IAC9E,KAAK,CAAC,EAAE,OAAO,CAAA;CACf,CAAA;AAED,2DAA2D;AAC3D,MAAM,MAAM,cAAc,GAAG;IAC5B,mEAAmE;IACnE,GAAG,EAAE,UAAU,CAAA;IACf,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAA;IACZ,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAA;IACZ,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACnC,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG,kBAAkB,GAAG;IACpD,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAA;IACZ,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG,kBAAkB,GAAG;IACpD,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG,kBAAkB,GAAG;IACrD,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAA;CACb,CAAA;AAED,sDAAsD;AACtD,MAAM,MAAM,cAAc,GAAG;IAC5B,EAAE,EAAE,IAAI,CAAA;IACR,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAA;IACf,kDAAkD;IAClD,QAAQ,EAAE,cAAc,EAAE,CAAA;CAC1B,CAAA"}

package/dist/protocol/http/locate.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=locate.js.map

package/dist/protocol/http/locate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locate.js","sourceRoot":"","sources":["../../../src/protocol/http/locate.ts"],"names":[],"mappings":""}

package/dist/protocol/http/net.d.ts

@@ -5,20 +5,88 @@ export type NetworkRequestSummary = {
     requestId: string;
     url: string;
     method: string;
+    documentUrl: string | null;
     /** Captured auth-related request headers with sensitive values redacted. */
     requestHeaders?: Record<string, string>;
     resourceType: string | null;
+    mimeType: string | null;
+    frameId: string | null;
     status: number | null;
     encodedDataLength: number | null;
     errorText: string | null;
     durationMs: number | null;
 };
+/** Single stack frame from a network initiator trace. */
+export type NetworkInitiatorStackFrame = {
+    functionName: string | null;
+    url: string;
+    lineNumber: number | null;
+    columnNumber: number | null;
+};
+/** Why a request started, when CDP can attribute it. */
+export type NetworkInitiator = {
+    type: string | null;
+    url: string | null;
+    lineNumber: number | null;
+    columnNumber: number | null;
+    requestId: string | null;
+    stack: NetworkInitiatorStackFrame[];
+};
+/** Redirect hop observed before the final request URL. */
+export type NetworkRedirectHop = {
+    fromUrl: string;
+    toUrl: string;
+    status: number | null;
+    statusText: string | null;
+};
+/** High-signal request timing breakdown derived from CDP response timing. */
+export type NetworkTimingPhases = {
+    totalMs: number | null;
+    blockedMs: number | null;
+    dnsMs: number | null;
+    connectMs: number | null;
+    sslMs: number | null;
+    sendMs: number | null;
+    waitMs: number | null;
+    downloadMs: number | null;
+};
+/** Whether Argus expects request/response bodies to be fetchable for a buffered entry. */
+export type NetworkBodyAvailability = {
+    request: boolean;
+    response: boolean;
+};
+/** Full request record used by `net show`. */
+export type NetworkRequestDetail = NetworkRequestSummary & {
+    requestHeaders?: Record<string, string>;
+    responseHeaders?: Record<string, string>;
+    statusText: string | null;
+    loaderId: string | null;
+    initiator: NetworkInitiator | null;
+    redirects: NetworkRedirectHop[];
+    servedFromCache: boolean;
+    fromDiskCache: boolean;
+    fromPrefetchCache: boolean;
+    fromServiceWorker: boolean;
+    serviceWorkerResponseSource: string | null;
+    remoteAddress: string | null;
+    remotePort: number | null;
+    protocol: string | null;
+    priority: string | null;
+    timingPhases: NetworkTimingPhases | null;
+    body: NetworkBodyAvailability;
+};
 /** Response payload for GET /net. */
 export type NetResponse = {
     ok: true;
     requests: NetworkRequestSummary[];
     nextAfter: number;
 };
+/** Response payload for GET /net/requests. */
+export type NetRequestsResponse = {
+    ok: true;
+    requests: NetworkRequestDetail[];
+    nextAfter: number;
+};
 /** Response payload for GET /net/tail. */
 export type NetTailResponse = {
     ok: true;
@@ -26,4 +94,109 @@ export type NetTailResponse = {
     nextAfter: number;
     timedOut: boolean;
 };
+/** Response payload for POST /net/clear. */
+export type NetClearResponse = {
+    ok: true;
+    /** Number of buffered requests removed. */
+    cleared: number;
+};
+/** Response payload for GET /net/request. */
+export type NetRequestResponse = {
+    ok: true;
+    request: NetworkRequestDetail;
+};
+/** Which body payload to fetch for a buffered request. */
+export type NetRequestBodyPart = 'request' | 'response';
+/** Response payload for GET /net/request/body. */
+export type NetRequestBodyResponse = {
+    ok: true;
+    id: number;
+    requestId: string;
+    part: NetRequestBodyPart;
+    mimeType: string | null;
+    body: string;
+    base64Encoded: boolean;
+};
+/** Direction for a captured WebSocket frame preview. */
+export type NetWebSocketFrameDirection = 'sent' | 'received';
+/** Bounded preview of a WebSocket frame payload. */
+export type NetWebSocketFramePreview = {
+    ts: number;
+    direction: NetWebSocketFrameDirection;
+    opcode: number | null;
+    mask: boolean | null;
+    payloadLength: number;
+    preview: string | null;
+    base64Encoded: boolean;
+    error: string | null;
+};
+/** Compact WebSocket connection record for `net ws`. */
+export type NetWebSocketSummary = {
+    id: number;
+    ts: number;
+    requestId: string;
+    url: string;
+    documentUrl: string | null;
+    frameId: string | null;
+    state: 'created' | 'open' | 'closed' | 'error';
+    status: number | null;
+    statusText: string | null;
+    createdAt: number;
+    openedAt: number | null;
+    closedAt: number | null;
+    durationMs: number | null;
+    sentFrames: number;
+    receivedFrames: number;
+    sentBytes: number;
+    receivedBytes: number;
+    closeCode: number | null;
+    closeReason: string | null;
+    errorText: string | null;
+};
+/** Detailed WebSocket connection record for `net ws show`. */
+export type NetWebSocketDetail = NetWebSocketSummary & {
+    requestHeaders?: Record<string, string>;
+    responseHeaders?: Record<string, string>;
+    recentFrames: NetWebSocketFramePreview[];
+};
+/** Request-level SSE/EventSource visibility record. */
+export type NetSseSummary = {
+    id: number;
+    ts: number;
+    requestId: string;
+    url: string;
+    method: string;
+    documentUrl: string | null;
+    frameId: string | null;
+    status: number | null;
+    statusText: string | null;
+    mimeType: string | null;
+    state: 'open' | 'closed' | 'error';
+    openedAt: number;
+    closedAt: number | null;
+    durationMs: number | null;
+    encodedDataLength: number | null;
+    eventCount: number;
+    lastEventId: string | null;
+    lastEventName: string | null;
+    lastDataPreview: string | null;
+    errorText: string | null;
+};
+/** Response payload for GET /net/ws. */
+export type NetWebSocketsResponse = {
+    ok: true;
+    connections: NetWebSocketSummary[];
+    nextAfter: number;
+};
+/** Response payload for GET /net/ws/connection. */
+export type NetWebSocketResponse = {
+    ok: true;
+    connection: NetWebSocketDetail;
+};
+/** Response payload for GET /net/sse. */
+export type NetSseResponse = {
+    ok: true;
+    streams: NetSseSummary[];
+    nextAfter: number;
+};
 //# sourceMappingURL=net.d.ts.map

package/dist/protocol/http/net.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"net.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/net.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,MAAM,qBAAqB,GAAG;IACnC,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAEzB,CAAA;AAED,qCAAqC;AACrC,MAAM,MAAM,WAAW,GAAG;IACzB,EAAE,EAAE,IAAI,CAAA;IACR,QAAQ,EAAE,qBAAqB,EAAE,CAAA;IACjC,SAAS,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,0CAA0C;AAC1C,MAAM,MAAM,eAAe,GAAG;IAC7B,EAAE,EAAE,IAAI,CAAA;IACR,QAAQ,EAAE,qBAAqB,EAAE,CAAA;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;CACjB,CAAA"}
+{"version":3,"file":"net.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/net.ts"],"names":[],"mappings":"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"}

package/dist/protocol/http/screenshot.d.ts

@@ -1,7 +1,16 @@
+/** Rectangle crop in CSS pixels relative to the selected target viewport. */
+export type ScreenshotClipRegion = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
 /** Request payload for POST /screenshot. */
 export type ScreenshotRequest = {
     outFile?: string;
     selector?: string;
+    /** Viewport-relative crop rectangle in CSS pixels. Mutually exclusive with `selector`. */
+    clip?: ScreenshotClipRegion;
     format?: 'png';
 };
 /** Response payload for POST /screenshot. */

package/dist/protocol/http/screenshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/screenshot.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,MAAM,MAAM,iBAAiB,GAAG;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,KAAK,CAAA;CACd,CAAA;AAED,6CAA6C;AAC7C,MAAM,MAAM,kBAAkB,GAAG;IAChC,EAAE,EAAE,IAAI,CAAA;IACR,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;CAChB,CAAA"}
+{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/screenshot.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,MAAM,MAAM,oBAAoB,GAAG;IAClC,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACd,CAAA;AAED,4CAA4C;AAC5C,MAAM,MAAM,iBAAiB,GAAG;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,0FAA0F;IAC1F,IAAI,CAAC,EAAE,oBAAoB,CAAA;IAC3B,MAAM,CAAC,EAAE,KAAK,CAAA;CACd,CAAA;AAED,6CAA6C;AAC7C,MAAM,MAAM,kBAAkB,GAAG;IAChC,EAAE,EAAE,IAAI,CAAA;IACR,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;CAChB,CAAA"}

package/dist/protocol/http/snapshot.d.ts

@@ -3,6 +3,8 @@
  * Reconstructed from CDP's flat AXNode array into a nested structure.
  */
 export type AXTreeNode = {
+    /** Stable element ref for actionable DOM-backed nodes (e.g. "e12"). */
+    ref?: string;
     /** Accessibility role (e.g. "button", "textbox", "heading", "link"). */
     role: string;
     /** Accessible name (visible label or aria-label). */

package/dist/protocol/http/snapshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/snapshot.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IACxB,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAA;IACZ,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAA;IACZ,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;IACtD,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAA;CACvB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC7B,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gFAAgF;IAChF,WAAW,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC9B,EAAE,EAAE,IAAI,CAAA;IACR,4CAA4C;IAC5C,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAA;IAClB,uCAAuC;IACvC,aAAa,EAAE,MAAM,CAAA;CACrB,CAAA"}
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/snapshot.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IACxB,uEAAuE;IACvE,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAA;IACZ,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAA;IACZ,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;IACtD,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAA;CACvB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC7B,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gFAAgF;IAChF,WAAW,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC9B,EAAE,EAAE,IAAI,CAAA;IACR,4CAA4C;IAC5C,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAA;IAClB,uCAAuC;IACvC,aAAa,EAAE,MAAM,CAAA;CACrB,CAAA"}

package/dist/protocol/http/status.d.ts

@@ -1,4 +1,5 @@
 import type { WatcherRecord } from '../../registry/types.js';
+import type { DialogStatus } from './dialog.js';
 import type { ArgusProtocolVersion } from '../version.js';
 /** Response payload for GET /status. */
 export type StatusResponse = {
@@ -6,10 +7,13 @@ export type StatusResponse = {
     id: string;
     pid: number;
     attached: boolean;
+    /** Whether the currently selected target is ready for frame-scoped commands. */
+    targetReady?: boolean | null;
     target: {
         title: string | null;
         url: string | null;
     } | null;
+    dialog?: DialogStatus | null;
     buffer: {
         size: number;
         count: number;

package/dist/protocol/http/status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAEzD,wCAAwC;AACxC,MAAM,MAAM,cAAc,GAAG;IAC5B,EAAE,EAAE,IAAI,CAAA;IACR,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,OAAO,CAAA;IACjB,MAAM,EAAE;QACP,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;QACpB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAClB,GAAG,IAAI,CAAA;IACR,MAAM,EAAE;QACP,IAAI,EAAE,MAAM,CAAA;QACZ,KAAK,EAAE,MAAM,CAAA;QACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;QACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KACpB,CAAA;IACD,OAAO,EAAE,aAAa,CAAA;IACtB,kDAAkD;IAClD,eAAe,CAAC,EAAE,oBAAoB,CAAA;IACtC,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,2CAA2C;AAC3C,MAAM,MAAM,gBAAgB,GAAG;IAC9B,EAAE,EAAE,IAAI,CAAA;CACR,CAAA;AAED,wCAAwC;AACxC,MAAM,MAAM,aAAa,GAAG;IAC3B,qDAAqD;IACrD,WAAW,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AAED,yCAAyC;AACzC,MAAM,MAAM,cAAc,GAAG;IAC5B,EAAE,EAAE,IAAI,CAAA;CACR,CAAA"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAEzD,wCAAwC;AACxC,MAAM,MAAM,cAAc,GAAG;IAC5B,EAAE,EAAE,IAAI,CAAA;IACR,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,OAAO,CAAA;IACjB,gFAAgF;IAChF,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IAC5B,MAAM,EAAE;QACP,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;QACpB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAClB,GAAG,IAAI,CAAA;IACR,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAA;IAC5B,MAAM,EAAE;QACP,IAAI,EAAE,MAAM,CAAA;QACZ,KAAK,EAAE,MAAM,CAAA;QACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;QACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KACpB,CAAA;IACD,OAAO,EAAE,aAAa,CAAA;IACtB,kDAAkD;IAClD,eAAe,CAAC,EAAE,oBAAoB,CAAA;IACtC,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,2CAA2C;AAC3C,MAAM,MAAM,gBAAgB,GAAG;IAC9B,EAAE,EAAE,IAAI,CAAA;CACR,CAAA;AAED,wCAAwC;AACxC,MAAM,MAAM,aAAa,GAAG;IAC3B,qDAAqD;IACrD,WAAW,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AAED,yCAAyC;AACzC,MAAM,MAAM,cAAc,GAAG;IAC5B,EAAE,EAAE,IAAI,CAAA;CACR,CAAA"}

package/dist/protocol/http/storage.d.ts

@@ -1,7 +1,11 @@
-/** Request payload for POST /storage/local. */
-export type StorageLocalRequest = {
+/** Storage areas exposed by the watcher API. */
+export type StorageArea = 'local' | 'session';
+/** Supported operations for POST /storage/<area>. */
+export type StorageAction = 'get' | 'set' | 'remove' | 'list' | 'clear';
+/** Request payload for POST /storage/<area>. */
+export type StorageRequest = {
     /** The operation to perform. */
-    action: 'get' | 'set' | 'remove' | 'list' | 'clear';
+    action: StorageAction;
     /** Key for get/set/remove operations. */
     key?: string;
     /** Value for set operation. */
@@ -9,38 +13,57 @@ export type StorageLocalRequest = {
     /** Optional origin to validate against page's current origin. */
     origin?: string;
 };
-/** Response payload for POST /storage/local (get). */
-export type StorageLocalGetResponse = {
+type StorageResponseBase = {
     ok: true;
     origin: string;
+};
+/** Response payload for POST /storage/<area> (get). */
+export type StorageGetResponse = StorageResponseBase & {
     key: string;
     exists: boolean;
     value: string | null;
 };
-/** Response payload for POST /storage/local (set). */
-export type StorageLocalSetResponse = {
-    ok: true;
-    origin: string;
+/** Response payload for POST /storage/<area> (set/remove). */
+export type StorageKeyMutationResponse = StorageResponseBase & {
     key: string;
 };
-/** Response payload for POST /storage/local (remove). */
-export type StorageLocalRemoveResponse = {
-    ok: true;
-    origin: string;
-    key: string;
-};
-/** Response payload for POST /storage/local (list). */
-export type StorageLocalListResponse = {
-    ok: true;
-    origin: string;
+/** Response payload for POST /storage/<area> (list). */
+export type StorageListResponse = StorageResponseBase & {
     keys: string[];
 };
-/** Response payload for POST /storage/local (clear). */
-export type StorageLocalClearResponse = {
-    ok: true;
-    origin: string;
+/** Response payload for POST /storage/<area> (clear). */
+export type StorageClearResponse = StorageResponseBase & {
     cleared: number;
 };
-/** Union of all storage local responses. */
-export type StorageLocalResponse = StorageLocalGetResponse | StorageLocalSetResponse | StorageLocalRemoveResponse | StorageLocalListResponse | StorageLocalClearResponse;
+/** Union of all storage responses. */
+export type StorageResponse = StorageGetResponse | StorageKeyMutationResponse | StorageListResponse | StorageClearResponse;
+/** Back-compat alias for the localStorage endpoint request. */
+export type StorageLocalRequest = StorageRequest;
+/** Back-compat alias for the localStorage endpoint get response. */
+export type StorageLocalGetResponse = StorageGetResponse;
+/** Back-compat alias for the localStorage endpoint set response. */
+export type StorageLocalSetResponse = StorageKeyMutationResponse;
+/** Back-compat alias for the localStorage endpoint remove response. */
+export type StorageLocalRemoveResponse = StorageKeyMutationResponse;
+/** Back-compat alias for the localStorage endpoint list response. */
+export type StorageLocalListResponse = StorageListResponse;
+/** Back-compat alias for the localStorage endpoint clear response. */
+export type StorageLocalClearResponse = StorageClearResponse;
+/** Back-compat alias for the localStorage endpoint response union. */
+export type StorageLocalResponse = StorageResponse;
+/** Alias for the sessionStorage endpoint request. */
+export type StorageSessionRequest = StorageRequest;
+/** Alias for the sessionStorage endpoint get response. */
+export type StorageSessionGetResponse = StorageGetResponse;
+/** Alias for the sessionStorage endpoint set response. */
+export type StorageSessionSetResponse = StorageKeyMutationResponse;
+/** Alias for the sessionStorage endpoint remove response. */
+export type StorageSessionRemoveResponse = StorageKeyMutationResponse;
+/** Alias for the sessionStorage endpoint list response. */
+export type StorageSessionListResponse = StorageListResponse;
+/** Alias for the sessionStorage endpoint clear response. */
+export type StorageSessionClearResponse = StorageClearResponse;
+/** Alias for the sessionStorage endpoint response union. */
+export type StorageSessionResponse = StorageResponse;
+export {};
 //# sourceMappingURL=storage.d.ts.map

package/dist/protocol/http/storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/storage.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,MAAM,MAAM,mBAAmB,GAAG;IACjC,gCAAgC;IAChC,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAA;IACnD,yCAAyC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED,sDAAsD;AACtD,MAAM,MAAM,uBAAuB,GAAG;IACrC,EAAE,EAAE,IAAI,CAAA;IACR,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,OAAO,CAAA;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACpB,CAAA;AAED,sDAAsD;AACtD,MAAM,MAAM,uBAAuB,GAAG;IACrC,EAAE,EAAE,IAAI,CAAA;IACR,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;CACX,CAAA;AAED,yDAAyD;AACzD,MAAM,MAAM,0BAA0B,GAAG;IACxC,EAAE,EAAE,IAAI,CAAA;IACR,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;CACX,CAAA;AAED,uDAAuD;AACvD,MAAM,MAAM,wBAAwB,GAAG;IACtC,EAAE,EAAE,IAAI,CAAA;IACR,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,EAAE,CAAA;CACd,CAAA;AAED,wDAAwD;AACxD,MAAM,MAAM,yBAAyB,GAAG;IACvC,EAAE,EAAE,IAAI,CAAA;IACR,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CACf,CAAA;AAED,4CAA4C;AAC5C,MAAM,MAAM,oBAAoB,GAC7B,uBAAuB,GACvB,uBAAuB,GACvB,0BAA0B,GAC1B,wBAAwB,GACxB,yBAAyB,CAAA"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/storage.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,SAAS,CAAA;AAE7C,qDAAqD;AACrD,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAA;AAEvE,gDAAgD;AAChD,MAAM,MAAM,cAAc,GAAG;IAC5B,gCAAgC;IAChC,MAAM,EAAE,aAAa,CAAA;IACrB,yCAAyC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED,KAAK,mBAAmB,GAAG;IAC1B,EAAE,EAAE,IAAI,CAAA;IACR,MAAM,EAAE,MAAM,CAAA;CACd,CAAA;AAED,uDAAuD;AACvD,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,GAAG;IACtD,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,OAAO,CAAA;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACpB,CAAA;AAED,8DAA8D;AAC9D,MAAM,MAAM,0BAA0B,GAAG,mBAAmB,GAAG;IAC9D,GAAG,EAAE,MAAM,CAAA;CACX,CAAA;AAED,wDAAwD;AACxD,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,GAAG;IACvD,IAAI,EAAE,MAAM,EAAE,CAAA;CACd,CAAA;AAED,yDAAyD;AACzD,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,GAAG;IACxD,OAAO,EAAE,MAAM,CAAA;CACf,CAAA;AAED,sCAAsC;AACtC,MAAM,MAAM,eAAe,GAAG,kBAAkB,GAAG,0BAA0B,GAAG,mBAAmB,GAAG,oBAAoB,CAAA;AAE1H,+DAA+D;AAC/D,MAAM,MAAM,mBAAmB,GAAG,cAAc,CAAA;AAEhD,oEAAoE;AACpE,MAAM,MAAM,uBAAuB,GAAG,kBAAkB,CAAA;AAExD,oEAAoE;AACpE,MAAM,MAAM,uBAAuB,GAAG,0BAA0B,CAAA;AAEhE,uEAAuE;AACvE,MAAM,MAAM,0BAA0B,GAAG,0BAA0B,CAAA;AAEnE,qEAAqE;AACrE,MAAM,MAAM,wBAAwB,GAAG,mBAAmB,CAAA;AAE1D,sEAAsE;AACtE,MAAM,MAAM,yBAAyB,GAAG,oBAAoB,CAAA;AAE5D,sEAAsE;AACtE,MAAM,MAAM,oBAAoB,GAAG,eAAe,CAAA;AAElD,qDAAqD;AACrD,MAAM,MAAM,qBAAqB,GAAG,cAAc,CAAA;AAElD,0DAA0D;AAC1D,MAAM,MAAM,yBAAyB,GAAG,kBAAkB,CAAA;AAE1D,0DAA0D;AAC1D,MAAM,MAAM,yBAAyB,GAAG,0BAA0B,CAAA;AAElE,6DAA6D;AAC7D,MAAM,MAAM,4BAA4B,GAAG,0BAA0B,CAAA;AAErE,2DAA2D;AAC3D,MAAM,MAAM,0BAA0B,GAAG,mBAAmB,CAAA;AAE5D,4DAA4D;AAC5D,MAAM,MAAM,2BAA2B,GAAG,oBAAoB,CAAA;AAE9D,4DAA4D;AAC5D,MAAM,MAAM,sBAAsB,GAAG,eAAe,CAAA"}

package/dist/protocol/http/visibility.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Visibility lock controls whether the attached page should behave as if
+ * visible/focused even when the Chrome window is backgrounded or covered.
+ *
+ * - `shown`: the watcher is actively keeping the page "visible+focused" via
+ *   CDP focus emulation (and best-effort window raise on each apply).
+ *   Unthrottles rAF/timers and prevents visibility-hidden stalls in
+ *   game/preview boot flows.
+ * - `default`: no override. The page honors Chrome's real visibility/focus
+ *   state (may throttle when backgrounded).
+ */
+export type VisibilityLock = 'shown' | 'default';
+/** POST /visibility request payload. */
+export type VisibilityRequest = {
+    /** `show` locks the page shown+focused; `hide` releases the lock. */
+    action: 'show' | 'hide';
+};
+/**
+ * POST /visibility response. Desired lock is sticky across detach/reattach —
+ * it is remembered by the watcher and re-applied on the next attach when
+ * `attached` is `false`.
+ */
+export type VisibilityResponse = {
+    ok: true;
+    /** Whether the watcher was attached to a CDP target at response time. */
+    attached: boolean;
+    /** Current desired visibility lock. */
+    state: VisibilityLock;
+};
+//# sourceMappingURL=visibility.d.ts.map

package/dist/protocol/http/visibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/visibility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,SAAS,CAAA;AAEhD,wCAAwC;AACxC,MAAM,MAAM,iBAAiB,GAAG;IAC/B,qEAAqE;IACrE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;CACvB,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAChC,EAAE,EAAE,IAAI,CAAA;IACR,yEAAyE;IACzE,QAAQ,EAAE,OAAO,CAAA;IACjB,uCAAuC;IACvC,KAAK,EAAE,cAAc,CAAA;CACrB,CAAA"}

package/dist/protocol/http/visibility.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=visibility.js.map

package/dist/protocol/http/visibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility.js","sourceRoot":"","sources":["../../../src/protocol/http/visibility.ts"],"names":[],"mappings":""}

package/dist/protocol/http.d.ts

@@ -1,3 +1,4 @@
+export * from './schema.js';
 export type * from './http/status.js';
 export type * from './http/logs.js';
 export type * from './http/net.js';
@@ -5,11 +6,16 @@ export type * from './http/eval.js';
 export type * from './http/trace.js';
 export type * from './http/screenshot.js';
 export type * from './http/snapshot.js';
+export type * from './http/locate.js';
 export type * from './http/code.js';
-export type * from './http/dom.js';
+export * from './http/dom.js';
 export type * from './http/storage.js';
 export type * from './http/auth.js';
+export { AUTH_STATE_METADATA_SCHEMA_VERSION } from './http/auth.js';
 export type * from './http/emulation.js';
 export type * from './http/throttle.js';
+export type * from './http/dialog.js';
+export type * from './http/visibility.js';
+export type * from './http/extension.js';
 export type * from './http/errors.js';
 //# sourceMappingURL=http.d.ts.map

package/dist/protocol/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/protocol/http.ts"],"names":[],"mappings":"AACA,mBAAmB,kBAAkB,CAAA;AACrC,mBAAmB,gBAAgB,CAAA;AACnC,mBAAmB,eAAe,CAAA;AAClC,mBAAmB,gBAAgB,CAAA;AACnC,mBAAmB,iBAAiB,CAAA;AACpC,mBAAmB,sBAAsB,CAAA;AACzC,mBAAmB,oBAAoB,CAAA;AACvC,mBAAmB,gBAAgB,CAAA;AACnC,mBAAmB,eAAe,CAAA;AAClC,mBAAmB,mBAAmB,CAAA;AACtC,mBAAmB,gBAAgB,CAAA;AACnC,mBAAmB,qBAAqB,CAAA;AACxC,mBAAmB,oBAAoB,CAAA;AACvC,mBAAmB,kBAAkB,CAAA"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/protocol/http.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAC3B,mBAAmB,kBAAkB,CAAA;AACrC,mBAAmB,gBAAgB,CAAA;AACnC,mBAAmB,eAAe,CAAA;AAClC,mBAAmB,gBAAgB,CAAA;AACnC,mBAAmB,iBAAiB,CAAA;AACpC,mBAAmB,sBAAsB,CAAA;AACzC,mBAAmB,oBAAoB,CAAA;AACvC,mBAAmB,kBAAkB,CAAA;AACrC,mBAAmB,gBAAgB,CAAA;AACnC,cAAc,eAAe,CAAA;AAC7B,mBAAmB,mBAAmB,CAAA;AACtC,mBAAmB,gBAAgB,CAAA;AACnC,OAAO,EAAE,kCAAkC,EAAE,MAAM,gBAAgB,CAAA;AACnE,mBAAmB,qBAAqB,CAAA;AACxC,mBAAmB,oBAAoB,CAAA;AACvC,mBAAmB,kBAAkB,CAAA;AACrC,mBAAmB,sBAAsB,CAAA;AACzC,mBAAmB,qBAAqB,CAAA;AACxC,mBAAmB,kBAAkB,CAAA"}