@applitools/nlp-web-runner 5.4.2 → 5.5.0

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

@@ -1 +1 @@
-var r=D;(function(O,A){var G=D,p=O();while(!![]){try{var c=parseInt(G(0x1b9))/0x1+parseInt(G(0x1b1))/0x2*(parseInt(G(0x1b4))/0x3)+-parseInt(G(0x1bd))/0x4*(parseInt(G(0x1b7))/0x5)+parseInt(G(0x1b3))/0x6+-parseInt(G(0x1b6))/0x7*(parseInt(G(0x1bc))/0x8)+-parseInt(G(0x1b8))/0x9+parseInt(G(0x1b2))/0xa*(parseInt(G(0x1ba))/0xb);if(c===A)break;else p['push'](p['shift']());}catch(Y){p['push'](p['shift']());}}}(m,0x4c2ff));var __defProp=Object[r(0x1bb)],__exportAll=(O,A)=>{var T=r;let p={};for(var c in O)__defProp(p,c,{'get':O[c],'enumerable':!![]});if(!A)__defProp(p,Symbol['toStringTag'],{'value':T(0x1b5)});return p;};export{__exportAll as t};function D(O,A){O=O-0x1b1;var p=m();var c=p[O];if(D['ZMykjN']===undefined){var Y=function(g){var d='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';var f='',s='';for(var l=0x0,P,w,B=0x0;w=g['charAt'](B++);~w&&(P=l%0x4?P*0x40+w:w,l++%0x4)?f+=String['fromCharCode'](0xff&P>>(-0x2*l&0x6)):0x0){w=d['indexOf'](w);}for(var J=0x0,I=f['length'];J<I;J++){s+='%'+('00'+f['charCodeAt'](J)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(s);};D['TumrpD']=Y,D['OKnKkF']={},D['ZMykjN']=!![];}var G=p[0x0],r=O+G,T=D['OKnKkF'][r];return!T?(c=D['TumrpD'](c),D['OKnKkF'][r]=c):c=T,c;}function m(){var g=['mJa4Cw54Egrm','mJiWrhr3C0rQ','neXTDerTDG','mZm5odbjvMrRvMy','mtu3ndiWmMjtyxnZrq','mZqZotuZsvLcwhHu','tw9KDwXL','mtm5mJa5EvH6Avfd','nJC1ufzWvgLS','mZe2nZCYmuDbr2jmtq','mJC4odK2DMTMyvnm','mtm1m0fHALrUtG','zgvMAw5LuhjVCgvYDhK'];m=function(){return g;};return m();}
+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-mslAJBZz.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;
@@ -1379,7 +1382,7 @@ declare class Browser extends EventTargetNode<BrowserEventMap> implements Automa
   stabilize(stage: 'basic' | 'strict' | 'paranoid', {
     signal,
     timeout
-  }: {
+  }?: {
     signal?: AbortSignal;
     timeout?: number;
   }): Promise<void>;
@@ -8494,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
@@ -9197,7 +9209,7 @@ type RunResult$1<TResult extends HandleResult> = TResult & {
   before?: Capture;
   after?: Capture;
   values: UsedValues;
-  metrics?: StepMetrics;
+  metrics?: InstructionMetrics;
 };
 type HandleResult = {
   status: string;
@@ -9230,6 +9242,12 @@ type ErrorResult = {
 type Capture = {
   image: string;
   elements?: ElementMarker[];
+  viewport?: {
+    width: number;
+    height: number;
+    scrollX: number;
+    scrollY: number;
+  };
 };
 type ElementMarker = {
   region: {
@@ -9255,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;
@@ -9947,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[];
@@ -10084,7 +10105,7 @@ type SubinstructionExecutionStartedDetails = {
     instruction: Instruction;
   };
 };
-type StepMetrics = {
+type InstructionMetrics = {
   platform?: 'web' | 'mobile';
   stabilizeMs?: number;
   handleMs?: number;
@@ -10102,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;
@@ -10118,7 +10139,7 @@ type InstructionRecordedDetails = {
     instruction: string;
     guid: string;
     analytics?: any;
-    metrics?: StepMetrics;
+    metrics?: InstructionMetrics;
   };
 };
 type ElementSelectionStartedDetails = {
@@ -10134,7 +10155,7 @@ type ElementDescriptorGeneratedDetails = {
   type: 'elementDescriptorGenerated';
   data: {
     description: string;
-    metrics?: StepMetrics;
+    metrics?: InstructionMetrics;
   };
 };
 type ElementSelectorGeneratedDetails = {
@@ -10161,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
@@ -10169,7 +10194,7 @@ type FindNodeOptions = {
   stack: ValuesStack;
   timeout?: number;
   signal?: AbortSignal;
-  metrics?: StepMetrics;
+  metrics?: InstructionMetrics;
 };
 type FindNodeResult<TAutomator extends Automator> = {
   web: IAXNodeView<WebNode> | null;
@@ -10183,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>>;
 }