@applitools/nlp-web-runner 5.4.1 → 5.5.0

package/dist/_inline/_chunks/rolldown-runtime-D7D4PA-g.js

@@ -1 +1 @@
-var j=r;function r(C,L){C=C-0x131;var R=H();var G=R[C];if(r['YYGQoU']===undefined){var x=function(M){var F='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';var K='',e='';for(var A=0x0,c,X,d=0x0;X=M['charAt'](d++);~X&&(c=A%0x4?c*0x40+X:X,A++%0x4)?K+=String['fromCharCode'](0xff&c>>(-0x2*A&0x6)):0x0){X=F['indexOf'](X);}for(var y=0x0,n=K['length'];y<n;y++){e+='%'+('00'+K['charCodeAt'](y)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(e);};r['jNzcZf']=x,r['zEgsem']={},r['YYGQoU']=!![];}var f=R[0x0],j=C+f,w=r['zEgsem'][j];return!w?(G=r['jNzcZf'](G),r['zEgsem'][j]=G):G=w,G;}(function(C,L){var f=r,R=C();while(!![]){try{var G=parseInt(f(0x13b))/0x1*(-parseInt(f(0x133))/0x2)+-parseInt(f(0x138))/0x3+parseInt(f(0x131))/0x4+parseInt(f(0x136))/0x5+-parseInt(f(0x137))/0x6*(-parseInt(f(0x13c))/0x7)+parseInt(f(0x135))/0x8*(parseInt(f(0x13d))/0x9)+-parseInt(f(0x139))/0xa*(parseInt(f(0x134))/0xb);if(G===L)break;else R['push'](R['shift']());}catch(x){R['push'](R['shift']());}}}(H,0xaa26f));var __defProp=Object[j(0x13a)],__exportAll=(C,L)=>{var w=j;let R={};for(var G in C)__defProp(R,G,{'get':C[G],'enumerable':!![]});if(!L)__defProp(R,Symbol[w(0x132)],{'value':w(0x13e)});return R;};function H(){var M=['zgvMAw5LuhjVCgvYDhK','mwjVzeTPzW','nZKWmtaWnwjUt1j3Aq','mZu5nJrLyuTXshC','tw9KDwXL','mJG3mta2ngf5Auz1yW','Dg9tDhjPBMDuywC','mJqZody2mMPzvMDnrG','odyXnZCZtvDtrwz1','mJaWognAsw5gAa','mtuZmdeZnw9Pr0Tmyq','nMLlvgDvsa','mZi0nZyZmKTbyvzksa','mJbmtfb6sgy'];H=function(){return M;};return H();}export{__exportAll as t};
+var r=f;function f(u,J){u=u-0xe6;var C=F();var b=C[u];if(f['kuwJDi']===undefined){var T=function(H){var z='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';var h='',P='';for(var R=0x0,Y,v,s=0x0;v=H['charAt'](s++);~v&&(Y=R%0x4?Y*0x40+v:v,R++%0x4)?h+=String['fromCharCode'](0xff&Y>>(-0x2*R&0x6)):0x0){v=z['indexOf'](v);}for(var K=0x0,q=h['length'];K<q;K++){P+='%'+('00'+h['charCodeAt'](K)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(P);};f['btqXfV']=T,f['pWhVEA']={},f['kuwJDi']=!![];}var n=C[0x0],r=u+n,l=f['pWhVEA'][r];return!l?(b=f['btqXfV'](b),f['pWhVEA'][r]=b):b=l,b;}(function(u,J){var n=f,C=u();while(!![]){try{var b=parseInt(n(0xf0))/0x1*(parseInt(n(0xf4))/0x2)+parseInt(n(0xee))/0x3*(-parseInt(n(0xe8))/0x4)+parseInt(n(0xf3))/0x5*(-parseInt(n(0xf1))/0x6)+-parseInt(n(0xed))/0x7*(parseInt(n(0xef))/0x8)+-parseInt(n(0xe7))/0x9+parseInt(n(0xe6))/0xa*(parseInt(n(0xf2))/0xb)+parseInt(n(0xea))/0xc;if(b===J)break;else C['push'](C['shift']());}catch(T){C['push'](C['shift']());}}}(F,0xe22a0));var __defProp=Object[r(0xec)],__exportAll=(u,J)=>{var l=r;let C={};for(var b in u)__defProp(C,b,{'get':u[b],'enumerable':!![]});if(!J)__defProp(C,Symbol[l(0xeb)],{'value':l(0xe9)});return C;};export{__exportAll as t};function F(){var H=['ntG5otmYovjIvwzqsa','ndi4nZy0y0nVAgL6','tw9KDwXL','mZm3mZaZntzusufpAMm','Dg9tDhjPBMDuywC','zgvMAw5LuhjVCgvYDhK','nJK4nMzezeT3va','mtj4qMXLtKC','ndq0ogXjt0LevW','mtLqsKPQywG','mte0vwLWAMXQ','mZu4ntaYmxvbwMP2AW','ndm2ntCWs2Tcugfs','mte0ndK0yMXhsND5','mtbHC3DKt3G'];F=function(){return H;};return F();}

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

@@ -652,19 +652,22 @@ declare class EventTargetNode<TEventMap extends Record<string, Event>> extends E
   constructor();
 }
 declare namespace logger_d_exports {
-  export { Logger$1 as Logger, debug, error$1 as error, log, trace, use };
+  export { LogEventCatalog, Logger$1 as Logger, debug, error$1 as error, log, trace, use };
 }
 interface Logger$1 {
-  log(...args: any): void;
-  error(...args: any[]): void;
-  trace(...args: any[]): void;
-  debug(...args: any[]): void;
+  log(type: string, data: Record<string, unknown>): void;
+  error(type: string, data: Record<string, unknown>): void;
+  trace(type: string, data: Record<string, unknown>): void;
+  debug(type: string, data: Record<string, unknown>): void;
 }
+interface LogEventCatalog {}
 declare function use(logger: Logger$1 | null | undefined): void;
-declare function log(...args: any[]): any;
-declare function error$1(...args: any[]): any;
-declare function trace(...args: any[]): any;
-declare function debug(...args: any[]): any; //#endregion
+declare function log<TType extends keyof LogEventCatalog>(type: TType, data: LogEventCatalog[TType]): void;
+declare function error$1<TType extends keyof LogEventCatalog>(type: TType, data: LogEventCatalog[TType]): void;
+declare function trace<TType extends keyof LogEventCatalog>(type: TType, data: LogEventCatalog[TType]): void;
+declare function debug<TType extends keyof LogEventCatalog>(type: TType, data: LogEventCatalog[TType]): void; //#endregion
+//#region src/log/event-logger.d.ts
+//#endregion
 //#region src/color.d.ts
 type ColorLike = Record<'r' | 'g' | 'b' | 'a', number>;
 //#endregion
@@ -766,7 +769,7 @@ declare class Rectangle {
 //#region src/patterns.d.ts
 type Match = (text: string) => string | null;
 //#endregion
-//#region dist/_inline/_chunks/script-6O13rCLT.d.ts
+//#region dist/_inline/_chunks/script-De9VUKC6.d.ts
 //#region src/port.d.ts
 interface PortMessageEvent<TName extends string = string, TPayload = unknown> extends Event {
   readonly name: TName;
@@ -994,6 +997,7 @@ type ConnectionOptions$2 = {
   socket: WebSocket;
   signal?: AbortSignal;
   sessionId?: string;
+  timeout?: number;
 };
 declare function makeConnection(options: ConnectionOptions$2): Connection;
 declare class Connection {
@@ -1001,6 +1005,8 @@ declare class Connection {
   readonly socket: WebSocket;
   readonly sessionId: string | undefined;
   constructor(options: ConnectionOptions$2);
+  get timeout(): number;
+  set timeout(timeout: number);
   abort(reason: any): void;
   flush(reason: any): void;
   execute<TMethod extends keyof Methods>(method: TMethod, params?: Methods[TMethod]['request'], {
@@ -1376,7 +1382,7 @@ declare class Browser extends EventTargetNode<BrowserEventMap> implements Automa
   stabilize(stage: 'basic' | 'strict' | 'paranoid', {
     signal,
     timeout
-  }: {
+  }?: {
     signal?: AbortSignal;
     timeout?: number;
   }): Promise<void>;
@@ -1386,9 +1392,11 @@ declare class Browser extends EventTargetNode<BrowserEventMap> implements Automa
     signal?: AbortSignal;
   }): Promise<void>;
   page({
-    url
+    url,
+    automationTimeout
   }: {
     url?: string;
+    automationTimeout?: number;
   }): Promise<Target>;
   activatePreviousPage(): Promise<boolean>;
   activateNextPage(): Promise<boolean>;
@@ -8489,12 +8497,21 @@ type FindCandidatesOptions = {
   debug?: {
     reason?: FindCandidateReason;
   };
+  /**
+   * Whether required-type matching may fall back to the legacy safety-net score (0.01) for
+   * backward-compatible types when classification finds no real score. Defaults to true —
+   * element finding must locate *something* for old descriptors. Search-style consumers pass
+   * false so "all buttons" doesn't include nodes that merely might be buttons.
+   */
+  useBackwardCompatibleTypeScore?: boolean;
 }; //#endregion
 //#region src/public/ax-provider.d.ts
 interface AXProvider {
   makeAXTree<TNode>(flat: AXTreeFlat<TNode>): IAXTreeView<TNode>;
   describeAXNode<TNode>(tree: IAXTreeView<TNode>, query: ElementDescriptorQuery<IAXNodeView<TNode>>): ResolvedElementDescriptor | undefined;
   findAXNode<TNode>(nodes: Iterable<IAXNodeView<TNode>>, descriptor: ResolvedElementDescriptor, options?: FindCandidatesOptions): CandidateMetric | null;
+  /** Optional: remote providers may not support returning the full ranked candidate list. */
+  findAXNodes?<TNode>(nodes: Iterable<IAXNodeView<TNode>>, descriptor: ResolvedElementDescriptor, options?: FindCandidatesOptions): CandidateMetric[];
 } //#endregion
 //#endregion
 //#region src/scope.d.ts
@@ -9192,7 +9209,7 @@ type RunResult$1<TResult extends HandleResult> = TResult & {
   before?: Capture;
   after?: Capture;
   values: UsedValues;
-  metrics?: StepMetrics;
+  metrics?: InstructionMetrics;
 };
 type HandleResult = {
   status: string;
@@ -9225,6 +9242,12 @@ type ErrorResult = {
 type Capture = {
   image: string;
   elements?: ElementMarker[];
+  viewport?: {
+    width: number;
+    height: number;
+    scrollX: number;
+    scrollY: number;
+  };
 };
 type ElementMarker = {
   region: {
@@ -9250,7 +9273,7 @@ declare abstract class Handler$1<TAutomator extends Automator, TInstruction exte
   readonly expectedNavigationStatuses: number[];
   get action(): TInstruction extends Action<any> ? TInstruction : unknown;
   get stack(): ValuesStack;
-  get metrics(): StepMetrics;
+  get metrics(): InstructionMetrics;
   get findTimeout(): any;
   get frameStabilityTimeout(): any;
   get navigateTimeout(): any;
@@ -9942,7 +9965,10 @@ type RunnerOptions<TAutomator extends Automator> = {
 type RunOptions = {
   stepIndex?: number;
   signal?: AbortSignal;
-  shouldCapture?: boolean; /** @internal */
+  shouldCapture?: boolean;
+  /** Opaque id echoed on each `subinstructionExecutionStarted` so a caller can tie the resulting
+   *  instruction logs back to the run it triggered (e.g. the devtools instruction details view). */
+  correlationId?: string; /** @internal */
   runningPreinstructions?: boolean; /** @internal for BE usage only */
   shouldNotThrowOnUnexpectedNavigationStatus?: boolean; /** @internal for BE usage only */
   expectedNavigationStatuses?: number[];
@@ -10079,7 +10105,7 @@ type SubinstructionExecutionStartedDetails = {
     instruction: Instruction;
   };
 };
-type StepMetrics = {
+type InstructionMetrics = {
   platform?: 'web' | 'mobile';
   stabilizeMs?: number;
   handleMs?: number;
@@ -10097,7 +10123,7 @@ type SubinstructionExecutionFinishedDetails = {
     duration: number;
     status: HandlerResult<Automator, Instruction>['status'];
     errorcode?: ErrorCode;
-    metrics?: StepMetrics;
+    metrics?: InstructionMetrics;
   };
 };
 type RecorderLogDetails = RecordingStartedDetails | RecordingStopedDetails | InstructionRecordedDetails | ElementSelectionStartedDetails | ElementSelectionStoppedDetails | ElementDescriptorGeneratedDetails | ElementSelectorGeneratedDetails | RecorderErrorDetails;
@@ -10113,7 +10139,7 @@ type InstructionRecordedDetails = {
     instruction: string;
     guid: string;
     analytics?: any;
-    metrics?: StepMetrics;
+    metrics?: InstructionMetrics;
   };
 };
 type ElementSelectionStartedDetails = {
@@ -10129,7 +10155,7 @@ type ElementDescriptorGeneratedDetails = {
   type: 'elementDescriptorGenerated';
   data: {
     description: string;
-    metrics?: StepMetrics;
+    metrics?: InstructionMetrics;
   };
 };
 type ElementSelectorGeneratedDetails = {
@@ -10156,7 +10182,11 @@ declare class LogEvent extends CustomEvent<LogDetails & {
   timestamp: number;
 }> {
   readonly component: 'runner' | 'recorder';
-  constructor(details: LogDetails);
+  constructor(details: LogDetails & {
+    timestamp?: number;
+  });
+  /** An already-dispatched event can't be dispatched again — re-dispatchers need a fresh instance. */
+  clone(): LogEvent;
 }
 //#endregion
 //#region src/ax/ax-ops.d.ts
@@ -10164,7 +10194,7 @@ type FindNodeOptions = {
   stack: ValuesStack;
   timeout?: number;
   signal?: AbortSignal;
-  metrics?: StepMetrics;
+  metrics?: InstructionMetrics;
 };
 type FindNodeResult<TAutomator extends Automator> = {
   web: IAXNodeView<WebNode> | null;
@@ -10178,6 +10208,16 @@ declare class AXOps<TAutomator extends Automator = Automator> {
   extractTree<TNode = unknown>(): Promise<IAXTreeView<TNode>>;
   makeTree<TNode>(flat: AXTreeFlat<TNode>): IAXTreeView<TNode>;
   findCandidate<TNode>(tree: IAXTreeView<TNode>, descriptor: ResolvedElementDescriptor, options?: FindCandidatesOptions): CandidateMetric | null;
+  findCandidates<TNode>(tree: IAXTreeView<TNode>, descriptor: ResolvedElementDescriptor, options?: FindCandidatesOptions): CandidateMetric[];
+  /**
+   * Search-oriented "find all": ranked candidates matching the descriptor, and — when the
+   * descriptor combines a title with a type — the remaining candidates of that type appended
+   * after the title matches. A search for "ok button" should surface ALL buttons with the "ok"
+   * ones ranked first, whereas plain candidate matching filters non-matching titles out entirely.
+   * The legacy safety-net type score is disabled: "all buttons" must not include nodes that
+   * merely might be buttons.
+   */
+  searchCandidates<TNode>(tree: IAXTreeView<TNode>, descriptor: ResolvedElementDescriptor, options?: FindCandidatesOptions): CandidateMetric[];
   describeNode<TNode>(tree: IAXTreeView<TNode>, query: ElementDescriptorQuery<IAXNodeView<TNode>>): ResolvedElementDescriptor | undefined;
   findNode(descriptor: ResolvedElementDescriptor, options: FindNodeOptions): Promise<FindNodeResult<TAutomator>>;
 }