@applitools/nlp-web-runner 5.6.1 → 5.8.0

package/dist/_inline/assets/wipe-origin-storage-CF1Vf2FY.js

@@ -0,0 +1,4 @@
+function () {
+var wipeOriginStorage=(function(){async function e(){return t(),await n(),await a(),await o(),!0}function t(){try{localStorage.clear()}catch{}try{sessionStorage.clear()}catch{}}async function n(){try{let e=await indexedDB.databases();await Promise.all(e.map(e=>r(e)))}catch{}}function r(e){let t=new Promise(e=>setTimeout(e,3e3));return Promise.race([i(e),t])}function i(e){return new Promise(t=>{if(!e.name)return t();let n=indexedDB.open(e.name);n.onerror=()=>t(),n.onsuccess=()=>{let e=n.result;try{let n=Array.from(e.objectStoreNames);if(n.length===0)return e.close(),t();let r=e.transaction(n,`readwrite`);for(let e of n)r.objectStore(e).clear();r.oncomplete=r.onerror=r.onabort=()=>{e.close(),t()}}catch{e.close(),t()}}})}async function a(){try{let e=await caches.keys();await Promise.all(e.map(e=>caches.delete(e)))}catch{}}async function o(){try{let e=await navigator.serviceWorker.getRegistrations();await Promise.all(e.map(e=>e.unregister()))}catch{}}return e})();
+return wipeOriginStorage.apply(null, arguments);
+}

package/dist/_inline/nlp-runner/web/index.d.ts

@@ -52,7 +52,7 @@ type SetVariableAction = {
     secret?: boolean;
   }[];
   data: {
-    value: AnyExpression | Extractor<ElementDescriptor, any> | Generator$1;
+    value: AnyExpression | ExtractOperation | Generator$1 | SizeOperation;
     secret?: boolean;
   };
   scope?: 'public' | 'internal';
@@ -116,9 +116,9 @@ type EraseAction = {
 };
 type TypeAction = {
   type: 'type';
-  value: AnyExpression | Extractor<ElementDescriptor, any> | Generator$1;
+  value: AnyExpression | ExtractOperation | Generator$1;
   secret?: boolean;
-  element?: ElementDescriptor | ChromeElementDescriptor;
+  element?: ElementDescriptor | ChromeElementDescriptor | DialogElementDescriptor;
 };
 type SearchAction = {
   type: 'search';
@@ -141,6 +141,10 @@ type ClickChromeElementAction = {
   type: 'click';
   element: ChromeElementDescriptor;
 };
+type ClickDialogElementAction = {
+  type: 'click';
+  element: DialogElementDescriptor;
+};
 type HoverAction = {
   type: 'hover';
   element: ElementDescriptor;
@@ -175,11 +179,6 @@ type ScrollTheElementAction = {
   distance: NumberExpression;
   times?: NumberExpression;
 };
-type AlertAction = {
-  type: 'alert';
-  value: boolean;
-  condition?: ElementCondition;
-};
 type NavigatePdfAction = {
   type: 'navigate pdf';
   page: NumberExpression;
@@ -212,7 +211,7 @@ type CloseTargetAction = {
 };
 type CloseAction = {
   type: 'close';
-  element: ElementDescriptor;
+  element: ElementDescriptor | DialogDescriptor;
 };
 type SwitchTargetByIndexAction = {
   type: 'switch target';
@@ -242,7 +241,7 @@ type IntentAction = {
   type: 'intent';
   description: string;
 };
-type Action<TType extends string> = Extract<EmptyAction | CommentAction | SetVariableAction | SetValueAction | FetchAction | AssertAction | EvaluateAction | FocusAction | CheckAction | ClearAction | EraseAction | TypeAction | HitKeyAction | SearchAction | ClickElementAction | ClickChromeElementAction | HoverAction | ScrollByDistanceAction | ScrollByFractionAction | ScrollToPositionAction | ScrollToElementAction | ScrollTheElementAction | AlertAction | NavigateToUrlAction | NavigateThroughHistoryAction | NavigatePdfAction | RefreshAction | CreateTargetAction | CloseTargetAction | CloseAction | SwitchTargetByIndexAction | SwitchTargetByTitleAction | SwitchTargetByPositionAction | WaitAction | GoAction | FindAction | VisualCheckAction | IntentAction, {
+type Action<TType extends string> = Extract<EmptyAction | CommentAction | SetVariableAction | SetValueAction | FetchAction | AssertAction | EvaluateAction | FocusAction | CheckAction | ClearAction | EraseAction | TypeAction | HitKeyAction | SearchAction | ClickElementAction | ClickChromeElementAction | ClickDialogElementAction | HoverAction | ScrollByDistanceAction | ScrollByFractionAction | ScrollToPositionAction | ScrollToElementAction | ScrollTheElementAction | NavigateToUrlAction | NavigateThroughHistoryAction | NavigatePdfAction | RefreshAction | CreateTargetAction | CloseTargetAction | CloseAction | SwitchTargetByIndexAction | SwitchTargetByTitleAction | SwitchTargetByPositionAction | WaitAction | GoAction | FindAction | VisualCheckAction | IntentAction, {
   type: TType;
 }>;
 type Instruction = Action<any> | ControlFlow;
@@ -299,10 +298,10 @@ type Pattern = {
   name: PatternName;
 });
 type PatternName = 'number' | 'price' | 'percentage' | 'date' | 'time' | 'code';
-type Extractor<TValue, TType extends Primitive<any>> = {
-  isExtractor: true;
-  value: TValue;
-  type: PrimitiveName<TType> | 'color' | 'background-color' | 'foreground-color';
+type ExtractType = PrimitiveName<Any> | 'color' | 'background-color' | 'foreground-color';
+type ExtractOperation = {
+  operator: 'extract';
+  operands: [Operand, ExtractType];
 };
 type OTP = {
   isOTP: true;
@@ -330,12 +329,12 @@ type Condition = {
   operation: ConditionOperation;
 };
 type Operation = ConditionOperation | ExpressionOperation;
-type ExpressionOperation = SizeOperation | KeysOperation | ValuesOperation | EntriesOperation | NumberOperation;
+type ExpressionOperation = SizeOperation | KeysOperation | ValuesOperation | EntriesOperation | NumberOperation | ExtractOperation;
 type NumberOperation = AddOperation | SubOperation | MulOperation | DivOperation;
 type ConditionOperation = ParensOperation | IgnoreCaseOperation | MatchCaseOperation | NotOperation | OrOperation | AndOperation | ComparisonOperation | ValidateOperation | MatchOperation | IncludesOnlyOperation | IncludesOperation | StartsWithOperation | EndsWithOperation | VisibleOperation | ClickableOperation | EnabledOperation | HoveredOperation | CheckedOperation | PopulatedOperation;
 type Operand = {
   isOperand: true;
-  value: AnyExpression | ElementDescriptor | Extractor<ElementDescriptor, any> | DialogDescriptor | ExpressionOperation;
+  value: AnyExpression | ElementDescriptor | DialogDescriptor | ExpressionOperation;
 };
 type ParensOperation = {
   operator: 'parens';
@@ -465,6 +464,7 @@ type PopulatedOperation = {
 type ElementScrollDirection = 'horizontal' | 'vertical' | 'both';
 type ElementDescriptor = {
   nth?: NumberExpression;
+  reference?: Reference<Any> | JSExpressionReference<Any>;
   type?: ElementType | ElementType[];
   title?: StringExpression | Pattern;
   orderDirection?: 'forward' | 'backward';
@@ -504,11 +504,15 @@ type RelativeAnchorDescriptor<TElement = ElementDescriptor> = {
 };
 type AbsoluteAnchorDescriptor<TElement = ElementDescriptor> = {
   position: AbsolutePosition | AbsolutePosition[];
-  element?: TElement | ViewportDescriptor;
+  element?: TElement | ViewportDescriptor | DialogDescriptor;
 };
 type DialogDescriptor = {
   isDialogDescriptor: true;
 };
+type DialogElementDescriptor = {
+  isDialogElementDescriptor: true;
+  title: 'ok' | 'cancel' | 'prompt';
+};
 type ChromeElementDescriptor = {
   isChromeElementDescriptor: true;
   title: 'refresh' | 'back' | 'forward' | 'url';
@@ -520,11 +524,6 @@ type CharacterKey = 'Backquote' | 'Digit1' | 'Digit2' | 'Digit3' | 'Digit4' | 'D
 type ArrowKey = 'ArrowUp' | 'ArrowDown' | 'ArrowLeft' | 'ArrowRight';
 type ControlKey = 'Escape' | 'F1' | 'F2' | 'F3' | 'F4' | 'F5' | 'F6' | 'F7' | 'F8' | 'F9' | 'F10' | 'F11' | 'F12' | 'Backspace' | 'Tab' | 'CapsLock' | 'Enter' | 'ShiftLeft' | 'ShiftRight' | 'ControlLeft' | 'MetaLeft' | 'AltLeft' | 'Space' | 'AltRight' | 'AltGraph' | 'MetaRight' | 'ControlRight' | 'Delete' | 'Home' | 'End' | 'PageUp' | 'PageDown' | 'Insert';
 type Key = ControlKey | ArrowKey | CharacterKey;
-type ElementCondition = {
-  type: ConditionType;
-  element?: ElementDescriptor;
-};
-type ConditionType = 'exists' | 'not-exists' | 'visible' | 'not-visible' | 'clickable';
 type ElementType = StructuralType | ControlType | ContentType;
 type StructuralType = 'app' | 'host' | 'ad' | 'header' | 'footer' | 'sidebar' | 'popup' | 'tooltip' | 'modal' | 'scrollable' | 'form' | 'fieldset' | 'menu' | 'menuitem' | 'hamburger' | 'list' | 'listitem' | 'heading' | 'table' | 'table-cell' | 'table-head-cell' | 'table-row' | 'table-dom-row' | 'table-leaf-row' | 'table-head-row' | 'table-column' | 'table-leaf-column' | 'table-stub-column' | 'card' | 'pdfpage';
 type ControlType = 'checkboxgroup' | 'checkbox' | 'radiogroup' | 'radio' | 'textbox' | 'combobox' | 'listbox' | 'option' | 'datepicker' | 'timepicker' | 'datetimepicker' | 'colorpicker' | 'filepicker' | 'slider' | 'inputbox' | 'selectbox' | 'valuebox' | 'button' | 'color';
@@ -711,6 +710,7 @@ declare class Rectangle {
     width: number;
     height: number;
   }): Rectangle;
+  /** Builds the axis-aligned bounding box of a CDP quad, whose 4 corners come in transform-dependent order. */
   static fromQuad(quad: number[]): Rectangle;
   readonly left: number;
   readonly top: number;
@@ -773,7 +773,7 @@ declare class Rectangle {
 //#region src/patterns.d.ts
 type Match = (text: string) => string | null;
 //#endregion
-//#region dist/_inline/_chunks/script-De9VUKC6.d.ts
+//#region dist/_inline/_chunks/script-CVsaWtX3.d.ts
 //#region src/port.d.ts
 interface PortMessageEvent<TName extends string = string, TPayload = unknown> extends Event {
   readonly name: TName;
@@ -1241,6 +1241,13 @@ declare class WebNode<TNode extends globalThis.Node = Element | Text> implements
     button?: 'left' | 'middle' | 'right' | 'back' | 'forward';
     times?: number;
   }): Promise<void>;
+  scrollIntoView({
+    block,
+    inline
+  }?: {
+    block?: ScrollLogicalPosition;
+    inline?: ScrollLogicalPosition;
+  }): Promise<void>;
   tryToUnobscure(): Promise<void>;
   isVisible(): Promise<boolean>;
   getObscurationInfo(): Promise<{
@@ -1291,6 +1298,7 @@ type BlockingDialogOptions = {
 };
 declare function makeBlockingDialog(options: BlockingDialogOptions): BlockingDialog;
 declare class BlockingDialog extends EventTargetNode<DialogEventMap> {
+  #private;
   readonly target: Target;
   readonly type: 'alert' | 'confirm' | 'prompt' | 'beforeunload';
   readonly message: string;
@@ -1299,6 +1307,8 @@ declare class BlockingDialog extends EventTargetNode<DialogEventMap> {
     type,
     message
   }: BlockingDialogOptions);
+  /** Whether the dialog was closed programmatically (as opposed to by the user). */
+  get handled(): boolean;
   handle(ok: boolean, text?: string): Promise<void>;
 }
 type FilepickerDialogOptions = {
@@ -1410,6 +1420,7 @@ declare class Browser extends EventTargetNode<BrowserEventMap> implements Automa
   getCookies(): Promise<import("devtools-protocol").Protocol.Network.Cookie[]>;
   setCookies(cookies: Cookie[]): Promise<void>;
   clearCookies(): Promise<void>;
+  clearOriginStorage(origin: string): Promise<void>;
   setWindowSize(size: {
     width: number;
     height: number;
@@ -1828,7 +1839,14 @@ declare class TargetFrameTargetCreatedEvent extends Event {
 declare class TargetDialogEvent extends Event {
   readonly state: 'opened' | 'closed';
   readonly dialog: BlockingDialog;
-  constructor(state: 'opened' | 'closed', dialog: BlockingDialog);
+  /** Whether the dialog was confirmed (only on `closed`). */
+  readonly result?: boolean;
+  /** The prompt input the dialog was confirmed with (only on `closed`). */
+  readonly value?: string;
+  constructor(state: 'opened' | 'closed', dialog: BlockingDialog, options?: {
+    result?: boolean;
+    value?: string;
+  });
 }
 declare class TargetFilepickerDialogEvent extends Event {
   readonly dialog: FilepickerDialog;
@@ -8415,7 +8433,7 @@ interface IAXTreeView<TNode = unknown> extends Iterable<IAXNodeView<TNode>> {
 }
 //#endregion
 //#region src/columbus/types.d.ts
-type ResolvedElementDescriptor = Omit<ElementDescriptor, 'title' | 'nth' | 'selector' | 'anchor' | 'color'> & {
+type ResolvedElementDescriptor = Omit<ElementDescriptor, 'title' | 'nth' | 'selector' | 'anchor' | 'color' | 'reference'> & {
   nth?: number;
   title?: string | Pattern;
   color?: string;
@@ -8517,6 +8535,16 @@ type FindCandidatesOptions = {
 interface AXProvider {
   makeAXTree<TNode>(flat: AXTreeFlat<TNode>): Promise<IAXTreeView<TNode>>;
   describeAXNode<TNode>(tree: IAXTreeView<TNode>, query: ElementDescriptorQuery<IAXNodeView<TNode>>): Promise<ResolvedElementDescriptor | undefined>;
+  describeAXNodeOptions?<TNode>(tree: IAXTreeView<TNode>, query: ElementDescriptorQuery<IAXNodeView<TNode>>, options?: {
+    limit?: number;
+    minScore?: number;
+  }): {
+    descriptor: ResolvedElementDescriptor;
+    score: number;
+  }[] | Promise<{
+    descriptor: ResolvedElementDescriptor;
+    score: number;
+  }[]>;
   findAXNode<TNode>(nodes: Iterable<IAXNodeView<TNode>>, descriptor: ResolvedElementDescriptor, options?: FindCandidatesOptions): Promise<CandidateMetric | null>;
   /** Optional: remote providers may not support returning the full ranked candidate list. */
   findAXNodes?<TNode>(nodes: Iterable<IAXNodeView<TNode>>, descriptor: ResolvedElementDescriptor, options?: FindCandidatesOptions): Promise<CandidateMetric[]>;
@@ -8812,7 +8840,7 @@ type ReferenceItem = {
 };
 type ExtractorItem = {
   type: 'extractor';
-  entity: Extractor<any, Primitive<any>>;
+  entity: ExtractOperation;
   value: Primitive<any>;
   secret?: boolean;
 };
@@ -8849,10 +8877,10 @@ declare class ValuesStack {
   reference(entity: Reference<Any>, value: Any, meta?: {
     secret?: boolean;
   }): Any;
-  extractor(entity: Extractor<any, Primitive<any>>): (value: Primitive<any>, meta?: {
+  extractor(entity: ExtractOperation): (value: Primitive<any>, meta?: {
     secret?: boolean;
   }) => Primitive<any>;
-  extractor(entity: Extractor<any, Primitive<any>>, value: Primitive<any>, meta?: {
+  extractor(entity: ExtractOperation, value: Primitive<any>, meta?: {
     secret?: boolean;
   }): Primitive<any>;
   generator(entity: Generator$1): (value: Any, meta?: {
@@ -8903,35 +8931,35 @@ declare class ValuesStack {
     value: Any;
   }, void, unknown>;
   extractors(): globalThis.Generator<{
-    extractor: Extractor<any, unknown>;
+    extractor: ExtractOperation;
     value: unknown;
     element: ResolvedElementDescriptor;
   } | {
-    extractor: Extractor<any, unknown>;
+    extractor: ExtractOperation;
     value: unknown;
     element: ResolvedElementDescriptor;
   } | {
     secret?: boolean;
-    extractor: Extractor<any, unknown>;
+    extractor: ExtractOperation;
     value: unknown;
     element: ResolvedElementDescriptor;
   } | {
     secret?: boolean;
-    extractor: Extractor<any, unknown>;
+    extractor: ExtractOperation;
     value: unknown;
     element: ResolvedElementDescriptor;
   } | {
     secret?: boolean;
-    extractor: Extractor<any, unknown>;
+    extractor: ExtractOperation;
     value: unknown;
     element: ResolvedElementDescriptor;
   } | {
     secret?: boolean;
-    extractor: Extractor<any, unknown>;
+    extractor: ExtractOperation;
     value: unknown;
     element: ResolvedElementDescriptor;
   } | {
-    extractor: Extractor<any, unknown>;
+    extractor: ExtractOperation;
     value: unknown;
     element: ResolvedElementDescriptor;
   }, void, unknown>;
@@ -9183,6 +9211,7 @@ declare const ErrorCode: {
   readonly ELEMENT_NOT_CLEARABLE: "ELEMENT_NOT_CLEARABLE";
   readonly UNHANDLED_DIALOG: "UNHANDLED_DIALOG";
   readonly NO_ELEMENT: "NO_ELEMENT";
+  readonly ILLEGAL_ELEMENT_DESCRIPTOR: "ILLEGAL_ELEMENT_DESCRIPTOR";
   readonly NO_OPTION: "NO_OPTION";
   readonly NO_DIALOG: "NO_DIALOG";
   readonly CONDITION_TIMED_OUT: "CONDITION_TIMED_OUT";
@@ -9192,6 +9221,7 @@ declare const ErrorCode: {
   readonly UNRESPONSIVE_TAB: "UNRESPONSIVE_TAB";
   readonly INTERNAL: "INTERNAL";
   readonly MESSAGE_PARSING: "MESSAGE_PARSING";
+  readonly INVALID_DATA: "INVALID_DATA";
   readonly OBSCURED_ELEMENT: "OBSCURED_ELEMENT";
   readonly FORBIDDEN_ACTION: "FORBIDDEN_ACTION";
   readonly EXCEEDED_ALLOWED_TIMEOUT: "EXCEEDED_ALLOWED_TIMEOUT";
@@ -9201,7 +9231,7 @@ declare const ErrorCode: {
 type ErrorCode = (typeof ErrorCode)[keyof typeof ErrorCode];
 //#endregion
 //#region src/utils/evaluate-expression.d.ts
-type EvaluatedExpression<TValue> = TValue extends Extractor<ElementDescriptor, infer TResult extends Any> ? TResult : TValue extends NumberExpression ? number : TValue extends SizeOperation ? number : TValue extends KeysOperation ? string[] : TValue extends ValuesOperation | EntriesOperation ? Any[] : TValue extends Condition ? boolean : TValue extends OTP ? string : TValue extends RandomValue<string> ? string | string[] : TValue extends RandomValue<number> ? number : TValue extends Reference<infer TType extends Any> ? TType : TValue extends JSExpressionReference<infer TType extends Any> ? TType : TValue extends InterpolatedString ? string : TValue extends JSExpression ? string : TValue extends Structure ? Record<string, any> | any[] : TValue extends FileHandle ? string : TValue extends Pattern ? RegExp | Match : TValue extends ChromeElementDescriptor ? ChromeElementDescriptor : TValue extends ElementDescriptor ? ResolvedElementDescriptor : TValue;
+type EvaluatedExpression<TValue> = TValue extends ExtractOperation ? Any : TValue extends NumberExpression ? number : TValue extends SizeOperation ? number : TValue extends KeysOperation ? string[] : TValue extends ValuesOperation | EntriesOperation ? Any[] : TValue extends Condition ? boolean : TValue extends OTP ? string : TValue extends RandomValue<string> ? string | string[] : TValue extends RandomValue<number> ? number : TValue extends Reference<infer TType extends Any> ? TType : TValue extends JSExpressionReference<infer TType extends Any> ? TType : TValue extends InterpolatedString ? string : TValue extends JSExpression ? string : TValue extends Structure ? Record<string, any> | any[] : TValue extends FileHandle ? string : TValue extends Pattern ? RegExp | Match : TValue extends ChromeElementDescriptor ? ChromeElementDescriptor : TValue extends ElementDescriptor ? ResolvedElementDescriptor : TValue;
 //#endregion
 //#region src/handler.d.ts
 type HandlerOptions<TAutomator extends Automator, TInstruction extends Instruction> = {
@@ -9310,6 +9340,10 @@ declare abstract class Handler$1<TAutomator extends Automator, TInstruction exte
     mobile: IAXNodeView<IOSNode> | null;
   }[TAutomator["type"]]>;
   capture(): Promise<Capture | undefined>;
+  /** Best-effort scroll bringing the elements matched by this handler into the viewport, so the
+   *  `after` capture shows them. Call it after the instruction's page reads are done — the scroll
+   *  persists. No-op without `shouldCapture` or off web. */
+  reveal(): Promise<void>;
   before(): Promise<void>;
   after(): Promise<void>;
 }
@@ -9574,6 +9608,9 @@ declare class ClickHandler$1 extends Handler$1<Browser, Action<'click'>> {
   handle(): Promise<{
     status: "success";
   }>;
+  handleWithDialogElementDescriptor(descriptor: DialogElementDescriptor): Promise<{
+    status: "success";
+  }>;
   handleWithChromeElementDescriptor(descriptor: ChromeElementDescriptor): Promise<{
     status: "success";
   }>;
@@ -9587,6 +9624,9 @@ declare class TypeHandler$1 extends Handler$1<Browser, Action<'type'>> {
   handle(): Promise<{
     status: "success";
   }>;
+  handleWithDialogElementDescriptor(): Promise<{
+    status: "success";
+  }>;
 }
 //#endregion
 //#region src/handlers/web/clear.d.ts
@@ -9726,13 +9766,6 @@ declare class GoHandler extends Handler$1<Browser, Action<'go'>, NavigateResult
   }>;
 }
 //#endregion
-//#region src/handlers/web/handle-dialog.d.ts
-declare class HandleDialogHandler extends Handler$1<Browser, Action<'alert'>> {
-  handle(): Promise<{
-    status: "success";
-  }>;
-}
-//#endregion
 //#region src/handlers/web/hit-key.d.ts
 declare class HitKeyHandler extends Handler$1<Browser, Action<'hit key'>> {
   handle(): Promise<{
@@ -9848,7 +9881,6 @@ declare const handlers: {
     evaluate: typeof EvaluateHandler;
     find: typeof FindHandler$1;
     focus: typeof FocusHandler$1;
-    alert: typeof HandleDialogHandler;
     'hit key': typeof HitKeyHandler;
     hover: typeof HoverHandler;
     navigate: typeof NavigateHandler;
@@ -9901,7 +9933,6 @@ declare const handlers: {
     "hit key": never;
     search: never;
     hover: never;
-    alert: never;
     navigate: never;
     "navigate pdf": never;
     refresh: never;
@@ -10243,7 +10274,7 @@ type UsedValues = {
     value: Any;
     secret?: boolean;
   }>;
-  extractors: Map<Extractor<any, Primitive<any>>, {
+  extractors: Map<ExtractOperation, {
     value: Primitive<any>;
     element?: ResolvedElementDescriptor;
   }>;