@wdio/appium-service 9.23.3 → 9.25.0

package/build/mobileSelectorPerformanceOptimizer/utils/xpath-class-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xpath-class-chain.d.ts","sourceRoot":"","sources":["../../../src/mobileSelectorPerformanceOptimizer/utils/xpath-class-chain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAgC,MAAM,kBAAkB,CAAA;AA0E3F;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAuCpF"}

package/build/mobileSelectorPerformanceOptimizer/utils/xpath-conditions.d.ts

@@ -0,0 +1,26 @@
+import type { XPathCondition } from './xpath-types.js';
+/**
+ * Extracts all conditions from an XPath expression.
+ * Handles OR conditions, contains, starts-with, ends-with, text(), and substring().
+ *
+ * @param xpath - The XPath selector to extract conditions from
+ * @returns Array of extracted conditions
+ */
+export declare function extractXPathConditions(xpath: string): XPathCondition[];
+/**
+ * Converts a single XPath condition to predicate syntax (NSPredicate or Class Chain).
+ *
+ * @param condition - The condition to convert
+ * @param quoteStyle - Quote style to use: 'single' for predicate strings, 'double' for class chain
+ * @returns Predicate string representation
+ */
+export declare function convertConditionToPredicate(condition: XPathCondition, quoteStyle?: 'single' | 'double'): string;
+/**
+ * Groups OR conditions together and converts them to predicate syntax.
+ *
+ * @param conditions - Array of conditions to group
+ * @param quoteStyle - Quote style to use: 'single' for predicate strings, 'double' for class chain
+ * @returns Array of grouped condition strings
+ */
+export declare function groupOrConditions(conditions: XPathCondition[], quoteStyle?: 'single' | 'double'): string[];
+//# sourceMappingURL=xpath-conditions.d.ts.map

package/build/mobileSelectorPerformanceOptimizer/utils/xpath-conditions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xpath-conditions.d.ts","sourceRoot":"","sources":["../../../src/mobileSelectorPerformanceOptimizer/utils/xpath-conditions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEtD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE,CA4BtE;AAyLD;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACvC,SAAS,EAAE,cAAc,EACzB,UAAU,GAAE,QAAQ,GAAG,QAAmB,GAC3C,MAAM,CA4BR;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC7B,UAAU,EAAE,cAAc,EAAE,EAC5B,UAAU,GAAE,QAAQ,GAAG,QAAmB,GAC3C,MAAM,EAAE,CA2BV"}

package/build/mobileSelectorPerformanceOptimizer/utils/xpath-constants.d.ts

@@ -0,0 +1,64 @@
+/**
+ * XPath axes that cannot be mapped to predicate strings or class chains.
+ *
+ * These axes require traversing UP the tree (parent/ancestor),
+ * SIDEWAYS (siblings), or by document order - none of which are
+ * supported by predicate strings or class chains.
+ */
+export declare const UNMAPPABLE_XPATH_AXES: readonly [{
+    readonly pattern: RegExp;
+    readonly name: "ancestor axis";
+}, {
+    readonly pattern: RegExp;
+    readonly name: "ancestor-or-self axis";
+}, {
+    readonly pattern: RegExp;
+    readonly name: "following-sibling axis";
+}, {
+    readonly pattern: RegExp;
+    readonly name: "preceding-sibling axis";
+}, {
+    readonly pattern: RegExp;
+    readonly name: "following axis";
+}, {
+    readonly pattern: RegExp;
+    readonly name: "preceding axis";
+}, {
+    readonly pattern: RegExp;
+    readonly name: "parent axis";
+}, {
+    readonly pattern: RegExp;
+    readonly name: "parent axis";
+}];
+/**
+ * XPath functions that cannot be mapped to predicate strings or class chains.
+ */
+export declare const UNMAPPABLE_XPATH_FUNCTIONS: readonly [{
+    readonly pattern: RegExp;
+    readonly name: "normalize-space() function";
+}, {
+    readonly pattern: RegExp;
+    readonly name: "position() function";
+}, {
+    readonly pattern: RegExp;
+    readonly name: "count() function";
+}];
+/**
+ * Patterns that indicate a complex XPath requiring predicate/class chain conversion
+ * (not suitable for simple accessibility ID conversion).
+ */
+export declare const COMPLEX_XPATH_PATTERNS: readonly [RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp, RegExp];
+/**
+ * Priority order of attributes for building unique selectors.
+ * Meaningful attributes first, then boolean attributes.
+ */
+export declare const ATTRIBUTE_PRIORITY: readonly ["name", "label", "value", "enabled", "visible", "accessible", "hittable"];
+/**
+ * Attributes that contain meaningful identifying information.
+ */
+export declare const MEANINGFUL_ATTRIBUTES: readonly ["name", "label", "value"];
+/**
+ * Boolean attributes that may help with uniqueness but are less reliable.
+ */
+export declare const BOOLEAN_ATTRIBUTES: readonly ["enabled", "visible", "accessible", "hittable"];
+//# sourceMappingURL=xpath-constants.d.ts.map

package/build/mobileSelectorPerformanceOptimizer/utils/xpath-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xpath-constants.d.ts","sourceRoot":"","sources":["../../../src/mobileSelectorPerformanceOptimizer/utils/xpath-constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;EASxB,CAAA;AAEV;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;;;;EAI7B,CAAA;AAEV;;;GAGG;AACH,eAAO,MAAM,sBAAsB,2FAWzB,CAAA;AAEV;;;GAGG;AACH,eAAO,MAAM,kBAAkB,qFAAsF,CAAA;AAErH;;GAEG;AACH,eAAO,MAAM,qBAAqB,qCAAsC,CAAA;AAExE;;GAEG;AACH,eAAO,MAAM,kBAAkB,2DAA4D,CAAA"}

package/build/mobileSelectorPerformanceOptimizer/utils/xpath-converter.d.ts

@@ -0,0 +1,14 @@
+import type { XPathConversionResult, XPathConversionOptions } from './xpath-types.js';
+/**
+ * Converts an XPath selector to an optimized alternative selector.
+ * Priority: Accessibility ID > Predicate String > Class Chain
+ *
+ * Uses page source analysis to find the exact element and build an optimized
+ * selector with uniqueness validation.
+ *
+ * @param xpath - The XPath selector to convert
+ * @param options - Conversion options including browser instance for page source analysis
+ * @returns Conversion result with selector and optional warning, or null if conversion isn't possible.
+ */
+export declare function convertXPathToOptimizedSelector(xpath: string, options: XPathConversionOptions): Promise<XPathConversionResult | null>;
+//# sourceMappingURL=xpath-converter.d.ts.map

package/build/mobileSelectorPerformanceOptimizer/utils/xpath-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xpath-converter.d.ts","sourceRoot":"","sources":["../../../src/mobileSelectorPerformanceOptimizer/utils/xpath-converter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAOrF;;;;;;;;;;GAUG;AACH,wBAAsB,+BAA+B,CACjD,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,sBAAsB,GAChC,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAmEvC"}

package/build/mobileSelectorPerformanceOptimizer/utils/xpath-detection.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Detects XPath features that cannot be mapped to predicate strings or class chains.
+ *
+ * @param xpath - The XPath selector to analyze
+ * @returns Array of unmappable feature names
+ */
+export declare function detectUnmappableXPathFeatures(xpath: string): string[];
+/**
+ * Checks if an XPath is complex (contains OR, AND, contains, etc.).
+ * Used to determine if we should skip accessibility ID conversion.
+ *
+ * @param xpath - The XPath selector to check
+ * @returns True if XPath contains complex patterns
+ */
+export declare function isComplexXPath(xpath: string): boolean;
+/**
+ * Extracts the element type from an XPath selector.
+ *
+ * @param xpath - The XPath selector
+ * @returns The element type (e.g., 'XCUIElementTypeButton') or null
+ */
+export declare function extractElementTypeFromXPath(xpath: string): string | null;
+/**
+ * Checks if an XPath uses a wildcard selector.
+ *
+ * @param xpath - The XPath selector
+ * @returns True if the XPath starts with //*
+ */
+export declare function isWildcardXPath(xpath: string): boolean;
+//# sourceMappingURL=xpath-detection.d.ts.map

package/build/mobileSelectorPerformanceOptimizer/utils/xpath-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xpath-detection.d.ts","sourceRoot":"","sources":["../../../src/mobileSelectorPerformanceOptimizer/utils/xpath-detection.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAkCrE;AA+BD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGxE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEtD"}

package/build/mobileSelectorPerformanceOptimizer/utils/xpath-page-source-executor.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Functions for executing XPath expressions against page source XML.
+ * Used as a fallback for unmappable XPath features (sibling axes, parent traversal, etc.)
+ */
+import type { ElementData } from './xpath-types.js';
+/**
+ * Result of finding an element by XPath with match count for uniqueness validation
+ */
+export interface XPathExecutionResult {
+    element: ElementData;
+    matchCount: number;
+}
+/**
+ * Executes an XPath expression against page source XML and returns matching elements.
+ *
+ * @param xpathExpr - The XPath expression to execute
+ * @param pageSource - The page source XML
+ * @returns Array of ElementData for matching elements, or null if execution failed
+ */
+export declare function executeXPathOnPageSource(xpathExpr: string, pageSource: string): ElementData[] | null;
+/**
+ * Finds an element by executing XPath against page source and returns element data with match count.
+ * Used for unmappable XPath fallback with uniqueness validation.
+ *
+ * @param xpathExpr - The XPath expression to execute
+ * @param pageSource - The page source XML
+ * @returns XPathExecutionResult with first matching element and total match count, or null if not found
+ */
+export declare function findElementByXPathWithFallback(xpathExpr: string, pageSource: string): XPathExecutionResult | null;
+//# sourceMappingURL=xpath-page-source-executor.d.ts.map

package/build/mobileSelectorPerformanceOptimizer/utils/xpath-page-source-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xpath-page-source-executor.d.ts","sourceRoot":"","sources":["../../../src/mobileSelectorPerformanceOptimizer/utils/xpath-page-source-executor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAInD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,WAAW,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,EAAE,GAAG,IAAI,CAgDpG;AAED;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAWjH"}

package/build/mobileSelectorPerformanceOptimizer/utils/xpath-page-source.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Functions for validating selector uniqueness in page source XML.
+ */
+/**
+ * Tests if a selector matches exactly one element by parsing the page source XML.
+ *
+ * @param selector - The selector to test
+ * @param pageSource - The page source XML to search in
+ * @returns True if exactly one element matches the selector
+ */
+export declare function isSelectorUniqueInPageSource(selector: string, pageSource: string): boolean;
+/**
+ * Counts elements matching a predicate string by parsing page source XML.
+ */
+export declare function countMatchingElementsByPredicate(predicateString: string, pageSource: string): number;
+/**
+ * Counts elements matching a class chain by parsing page source XML.
+ */
+export declare function countMatchingElementsByClassChain(chainString: string, pageSource: string): number;
+//# sourceMappingURL=xpath-page-source.d.ts.map

package/build/mobileSelectorPerformanceOptimizer/utils/xpath-page-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xpath-page-source.d.ts","sourceRoot":"","sources":["../../../src/mobileSelectorPerformanceOptimizer/utils/xpath-page-source.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAgB1F;AAeD;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAyBpG;AA+BD;;GAEG;AACH,wBAAgB,iCAAiC,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CA4CjG"}

package/build/mobileSelectorPerformanceOptimizer/utils/xpath-parser.d.ts

@@ -0,0 +1,9 @@
+import type { XPathSegment } from './xpath-types.js';
+/**
+ * Parses an XPath expression into structured segments.
+ *
+ * @param xpath - The XPath expression to parse
+ * @returns Array of XPathSegment objects, or null if the XPath cannot be parsed
+ */
+export declare function parseXPathToSegments(xpath: string): XPathSegment[] | null;
+//# sourceMappingURL=xpath-parser.d.ts.map

package/build/mobileSelectorPerformanceOptimizer/utils/xpath-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xpath-parser.d.ts","sourceRoot":"","sources":["../../../src/mobileSelectorPerformanceOptimizer/utils/xpath-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAqVpE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE,GAAG,IAAI,CAiCzE"}

package/build/mobileSelectorPerformanceOptimizer/utils/xpath-predicate.d.ts

@@ -0,0 +1,18 @@
+import type { XPathConversionResult } from './xpath-types.js';
+/**
+ * Attempts to convert XPath to iOS Predicate String.
+ * Handles common XPath patterns and converts them to NSPredicate syntax.
+ *
+ * @param xpath - The XPath selector to convert
+ * @returns Conversion result with predicate string selector, or null if not applicable
+ */
+export declare function convertXPathToPredicateString(xpath: string): XPathConversionResult | null;
+/**
+ * Attempts to convert XPath to Accessibility ID selector.
+ * Only works for simple cases with single @name or @label attribute.
+ *
+ * @param xpath - The XPath selector to convert
+ * @returns The accessibility ID value, or null if not applicable
+ */
+export declare function convertXPathToAccessibilityId(xpath: string): string | null;
+//# sourceMappingURL=xpath-predicate.d.ts.map

package/build/mobileSelectorPerformanceOptimizer/utils/xpath-predicate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xpath-predicate.d.ts","sourceRoot":"","sources":["../../../src/mobileSelectorPerformanceOptimizer/utils/xpath-predicate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AAI7D;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI,CAyBzF;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAY1E"}

package/build/mobileSelectorPerformanceOptimizer/utils/xpath-selector-builder.d.ts

@@ -0,0 +1,11 @@
+import type { ElementData, XPathConversionResult } from './xpath-types.js';
+/**
+ * Builds optimal selector from element data, ensuring uniqueness.
+ * Priority: Accessibility ID > Predicate String > Class Chain
+ *
+ * @param elementData - Element data extracted from page source
+ * @param pageSource - The page source XML to test selector uniqueness against
+ * @returns Conversion result with unique selector, or warning if not unique
+ */
+export declare function buildSelectorFromElementData(elementData: ElementData, pageSource: string): XPathConversionResult | null;
+//# sourceMappingURL=xpath-selector-builder.d.ts.map

package/build/mobileSelectorPerformanceOptimizer/utils/xpath-selector-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xpath-selector-builder.d.ts","sourceRoot":"","sources":["../../../src/mobileSelectorPerformanceOptimizer/utils/xpath-selector-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AAI1E;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CACxC,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,MAAM,GACnB,qBAAqB,GAAG,IAAI,CAgC9B"}

package/build/mobileSelectorPerformanceOptimizer/utils/xpath-types.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Result of XPath conversion attempt
+ */
+export interface XPathConversionResult {
+    selector: string | null;
+    warning?: string;
+    /**
+     * When an XPath cannot be converted but we found a potential selector via page source analysis,
+     * this field contains that selector as a suggestion (even if it's not unique).
+     */
+    suggestion?: string;
+}
+/**
+ * Condition extracted from XPath expression
+ */
+export interface XPathCondition {
+    attribute: string;
+    operator: string;
+    value: string;
+    logicalOp?: string;
+}
+/**
+ * Options for XPath conversion
+ */
+export interface XPathConversionOptions {
+    /**
+     * Browser instance for page source analysis.
+     * Used to execute XPath and build optimized selectors with uniqueness validation.
+     */
+    browser: WebdriverIO.Browser | WebdriverIO.MultiRemoteBrowser;
+}
+/**
+ * Element data extracted from page source
+ */
+export interface ElementData {
+    type: string;
+    attributes: Record<string, string>;
+}
+/**
+ * Predicate condition for matching elements
+ */
+export interface PredicateCondition {
+    attr: string;
+    op: string;
+    value: string;
+}
+/**
+ * Represents a single segment of a parsed XPath expression
+ */
+export interface XPathSegment {
+    /**
+     * The axis used: '//' for descendant, '/' for child
+     **/
+    axis: '//' | '/';
+    /**
+     * The element type or '*' for wildcard
+     **/
+    element: string;
+    /**
+     * Conditions/predicates for this segment
+     **/
+    conditions: XPathCondition[];
+    /**
+     * Positional index if specified (e.g., [1])
+     **/
+    index?: number;
+}
+//# sourceMappingURL=xpath-types.d.ts.map

package/build/mobileSelectorPerformanceOptimizer/utils/xpath-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xpath-types.d.ts","sourceRoot":"","sources":["../../../src/mobileSelectorPerformanceOptimizer/utils/xpath-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC;;;OAGG;IACH,OAAO,EAAE,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,kBAAkB,CAAA;CAChE;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB;;QAEI;IACJ,IAAI,EAAE,IAAI,GAAG,GAAG,CAAA;IAChB;;QAEI;IACJ,OAAO,EAAE,MAAM,CAAA;IACf;;QAEI;IACJ,UAAU,EAAE,cAAc,EAAE,CAAA;IAC5B;;QAEI;IACJ,KAAK,CAAC,EAAE,MAAM,CAAA;CACjB"}

package/build/types.d.ts

@@ -142,6 +142,52 @@ export interface AppiumServiceConfig {
      * @default 30000
      */
     appiumStartTimeout?: number;
+    /**
+     * Enable selector performance tracking to measure element finding times.
+     * When enabled, tracks all element-finding commands and stores timing data in JSON format.
+     */
+    trackSelectorPerformance?: {
+        /**
+         * Enable the CLI report output to the terminal.
+         * When enabled, a formatted performance report is printed to the terminal after test execution.
+         * @default false
+         */
+        enableCliReport?: boolean;
+        /**
+         * Enable markdown report generation.
+         * When enabled, a markdown file with the same content as the CLI report is written to the logs folder.
+         * @default false
+         */
+        enableMarkdownReport?: boolean;
+        /**
+         * Path where the JSON report file should be saved.
+         * If not provided, falls back to config.outputDir, then appium service logPath.
+         * If none are set, an error will be thrown.
+         */
+        reportPath?: string;
+        /**
+         * Maximum line length for terminal report output.
+         * Lines longer than this will be wrapped at word boundaries.
+         * @default 100
+         */
+        maxLineLength?: number;
+        /**
+         * Paths to directories containing page objects or helper files where selectors may be defined.
+         * The service will search these directories to find selector locations and show file paths
+         * in the report (e.g., "Found at: TabBar.ts:3").
+         *
+         * This option is required when `trackSelectorPerformance` is configured.
+         *
+         * @example
+         * // Single directory
+         * pageObjectPaths: ['./tests/pageobjects']
+         *
+         * @example
+         * // Multiple directories
+         * pageObjectPaths: ['./tests/pageobjects', './tests/pages', './tests/helpers']
+         */
+        pageObjectPaths: string[];
+    };
 }
 export type ArgValue = string | number | boolean | null | object;
 export type KeyValueArgs = {

package/build/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG;IAChC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC9B;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAClC;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC5B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACtB;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,WAAW,yBAAyB;IACtC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,mBAAmB;IAChC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,IAAI,CAAC,EAAE,qBAAqB,CAAA;IAE5B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,CAAA;AAChE,MAAM,MAAM,YAAY,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAA;CAAE,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG;IAChC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC9B;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAClC;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC5B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACtB;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,WAAW,yBAAyB;IACtC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,mBAAmB;IAChC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,IAAI,CAAC,EAAE,qBAAqB,CAAA;IAE5B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAE3B;;;OAGG;IACH,wBAAwB,CAAC,EAAE;QACvB;;;;WAIG;QACH,eAAe,CAAC,EAAE,OAAO,CAAA;QACzB;;;;WAIG;QACH,oBAAoB,CAAC,EAAE,OAAO,CAAA;QAC9B;;;;WAIG;QACH,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB;;;;WAIG;QACH,aAAa,CAAC,EAAE,MAAM,CAAA;QACtB;;;;;;;;;;;;;;WAcG;QACH,eAAe,EAAE,MAAM,EAAE,CAAA;KAC5B,CAAA;CACJ;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,CAAA;AAChE,MAAM,MAAM,YAAY,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAA;CAAE,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wdio/appium-service",
-  "version": "9.23.3",
+  "version": "9.25.0",
   "description": "A WebdriverIO service to start & stop Appium Server",
   "author": "Morten Bjerg Gregersen <morten@mogee.dk>",
   "homepage": "https://github.com/webdriverio/webdriverio/tree/main/packages/wdio-appium-service",
@@ -43,18 +43,21 @@
   },
   "typeScriptVersion": "3.8.3",
   "dependencies": {
-    "@wdio/config": "9.23.3",
+    "@wdio/config": "9.25.0",
     "@wdio/logger": "9.18.0",
-    "@wdio/types": "9.23.3",
-    "@wdio/utils": "9.23.3",
+    "@wdio/reporter": "9.25.0",
+    "@wdio/types": "9.25.0",
+    "@wdio/utils": "9.25.0",
+    "@xmldom/xmldom": "^0.9.5",
     "change-case": "^5.4.3",
     "get-port": "^7.0.0",
     "import-meta-resolve": "^4.0.0",
     "tree-kill": "^1.2.2",
-    "webdriverio": "9.23.3"
+    "webdriverio": "9.25.0",
+    "xpath": "^0.0.34"
   },
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "ae97a13a6f03d0d6c988beb56ec822473fa61c62"
+  "gitHead": "1352571ae8709a895c223973f1840f38d8530f4a"
 }