pomwright 1.3.0 → 1.4.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # pomwright
 
+## 1.4.0
+
+### Minor Changes
+
+- [#36](https://github.com/DyHex/POMWright/pull/36) [`e307d0e`](https://github.com/DyHex/POMWright/commit/e307d0e871bce4b69f12fa17fa673af3dad8f874) Thanks [@DyHex](https://github.com/DyHex)! - # v1.4.0
+
+  ## Removed
+
+  - Dropped deprecated locator schema helpers (legacy numeric indexing and update/updates overloads). Use sub-path keyed indices and `update(subPath, updates)` instead.
+
+  ## Changed
+
+  - Simplified nested locator debug logging to count-only checks to avoid CSP-restricted pages failing when `evaluateAll` is blocked.
+
 ## 1.3.0
 
 ### Minor Changes

package/dist/index.d.mts

@@ -296,7 +296,7 @@ type ExtractSubPaths<Path extends string> = Path extends `${infer Head}.${infer
  */
 type SubPaths<LocatorSchemaPathType extends string, LocatorSubstring extends LocatorSchemaPathType | undefined> = LocatorSubstring extends string ? Extract<LocatorSchemaPathType, LocatorSubstring | ExtractSubPaths<LocatorSubstring>> : never;
 /**
- * UpdatableLocatorSchemaProperties represent the properties of LocatorSchema that can be changed by update/updates,
+ * UpdatableLocatorSchemaProperties represent the properties of LocatorSchema that can be changed by update,
  * excluding the locatorSchemaPath itself, which remains immutable.
  */
 type LocatorSchemaWithoutPath = Omit<LocatorSchema, "locatorSchemaPath">;
@@ -340,43 +340,11 @@ type LocatorSchemaWithMethods<LocatorSchemaPathType extends string, LocatorSubst
      *
      * @example
      * // Direct usage:
-     * const submitButton = await poc.getLocatorSchema("main.form.button@submit").update("main.form.button@submit")
+     * const submitButton = await poc
+     * 	.getLocatorSchema("main.form.button@submit")
+     * 	.update("main.form.button@submit", { roleOptions: { name: "Submit" } })
      */
     update(subPath: SubPaths<LocatorSchemaPathType, LocatorSubstring>, updates: Partial<LocatorSchemaWithoutPath>): LocatorSchemaWithMethods<LocatorSchemaPathType, LocatorSubstring>;
-    /**
-     * @deprecated To be removed in version 2.0.0. Use the new `.update(subPath, updates)` method instead, see example.
-     *
-     * This deprecated update method takes one argument and only updates the LocatorSchema which the full LocatorSchemaPath resolves to.
-     *
-     * @example
-     * // New update method usage:
-     * const userInfoSection = await poc
-     * 	.getLocatorSchema("main.form.section")
-     * 	.update("main.form.section", { locatorOptions: { hasText: "User Info:" } })
-     * 	.getNestedLocator();
-     */
-    update(updates: Partial<LocatorSchemaWithoutPath>): LocatorSchemaWithMethods<LocatorSchemaPathType, LocatorSubstring>;
-    /**
-     * @deprecated To be removed in version 2.0.0. Use the new `.update(subPath, updates)` method instead, chain the
-     * method for each update if multiple, see example.
-     *
-     * This deprecated updates method uses indices to identify which schema to update.
-     *
-     * @example
-     * // New update method usage:
-     * const userInfoSection = await poc
-     * 	.getLocatorSchema("main.form.section")
-     * 	.update("main.form", {
-     * 		role: "form",
-     * 		roleOptions: { name: "Personalia" },
-     * 		locatorMethod: GetByMethod.role,
-     * 	})
-     * 	.update("main.form.section", { locatorOptions: { hasText: /User Info:/i } })
-     * 	.getNestedLocator();
-     */
-    updates(indexedUpdates: {
-        [index: number]: Partial<LocatorSchemaWithoutPath> | null;
-    }): LocatorSchemaWithMethods<LocatorSchemaPathType, LocatorSubstring>;
     /**
      * The equivalent of the Playwright locator.filter({...}) method and chainable on .getLocatorSchema(LocatorSchemaPath).
      * Can be chained multiple times to add multiple filters to the same or different LocatorSchema.
@@ -471,37 +439,6 @@ type LocatorSchemaWithMethods<LocatorSchemaPathType extends string, LocatorSubst
     getNestedLocator(subPathIndices?: {
         [K in SubPaths<LocatorSchemaPathType, LocatorSubstring>]?: number | null;
     }): Promise<Locator>;
-    /**
-     * @deprecated To be removed in version 2.0.0. Use getNestedLocator({ LocatorSchemaPath: index }) instead of
-     * number-based indexing, see example.
-     *
-     * @example
-     * // New usage:
-     * for (const [index, subscription] of subscriptions.entries()) {
-     *   const inputUsername = await poc
-     *     .getLocatorSchema("main.form.item.input@username")
-     *     .getNestedLocator({ "main.form.item": index });
-     *   await inputUsername.fill(subscription.username);
-     *   await inputUsername.blur();
-     *
-     *   const enableServiceCheckbox = await poc
-     *     .getLocatorSchema("main.form.item.checkbox@enableService")
-     *     .getNestedLocator({ "main.form.item": index });
-     *   await enableServiceCheckbox.check();
-     * }
-     *
-     * // indexing multiple subPaths:
-     * const something = await poc
-     *   .getLocatorSchema("main.form.item.something")
-     *   .getNestedLocator({
-     *     "main.form": 0, // locator.first() / locator.nth(0)
-     *     "main.form.item": 1, // locator.nth(1)
-     *   });
-     * await something.click();
-     */
-    getNestedLocator(indices?: {
-        [key: number]: number | null;
-    }): Promise<Locator>;
     /**
      * This method does not perform nesting,and will return the locator for which the full LocatorSchemaPath resolves to,
      * provided by getLocatorSchema("...")
@@ -527,7 +464,7 @@ type LocatorSchemaWithMethods<LocatorSchemaPathType extends string, LocatorSubst
  *
  * - getLocatorSchema(path):
  *   Returns a deep-copied schema and a chainable object (LocatorSchemaWithMethods) that
- *   allows calling update, updates, addFilter, and finally getNestedLocator or getLocator.
+ *   allows calling update, addFilter, and finally getNestedLocator or getLocator.
  *
  * - By using WithMethodsClass, we lock LocatorSubstring = P, the chosen path,
  *   ensuring addFilter suggests only valid sub-paths of P.
@@ -566,18 +503,6 @@ declare class GetLocatorBase<LocatorSchemaPathType extends string, LocatorSubstr
      * Similar to applyUpdate, but we locate the sub-path schema directly by its path.
      */
     applyUpdateToSubPath(schemasMap: Map<string, LocatorSchema>, subPath: LocatorSchemaPathType, updates: Partial<LocatorSchemaWithoutPath>): void;
-    /**
-     * applyUpdate:
-     * Applies updates to a single schema within the schemasMap.
-     */
-    applyUpdate(schemasMap: Map<string, LocatorSchema>, locatorSchemaPath: LocatorSchemaPathType, updateData: Partial<LocatorSchema>): void;
-    /**
-     * applyUpdates:
-     * Applies multiple updates to multiple schemas in the chain, identified by their path indexes.
-     */
-    applyUpdates(schemasMap: Map<string, LocatorSchema>, pathIndexPairs: PathIndexPairs, updatesData: {
-        [index: number]: Partial<LocatorSchema>;
-    }): void;
     /**
      * createLocatorSchema:
      * Creates a fresh LocatorSchema object by merging provided schemaDetails with a required locatorSchemaPath.
@@ -597,7 +522,7 @@ declare class GetLocatorBase<LocatorSchemaPathType extends string, LocatorSubstr
     /**
      * extractPathsFromSchema:
      * Splits a path into incremental sub-paths and associates them with optional indices.
-     * Used by updates and getNestedLocator methods.
+     * Used by getNestedLocator methods.
      */
     extractPathsFromSchema: (paths: string, indices?: Record<number, number>) => PathIndexPairs;
     /**
@@ -623,11 +548,6 @@ declare class GetLocatorBase<LocatorSchemaPathType extends string, LocatorSubstr
      * Helps with logging and debugging complex locator chains.
      */
     private evaluateCurrentLocator;
-    /**
-     * evaluateAndGetAttributes:
-     * Extracts tagName and attributes from all elements matched by the locator for debugging purposes.
-     */
-    private evaluateAndGetAttributes;
 }
 
 /**
@@ -797,22 +717,6 @@ declare abstract class BasePage<LocatorSchemaPathType extends string, Options ex
     getNestedLocator<P extends LocatorSchemaPathType>(locatorSchemaPath: P, subPathIndices?: {
         [K in SubPaths<LocatorSchemaPathType, P>]?: number | null;
     }): Promise<Locator>;
-    /**
-     * @deprecated Use { SubPaths: index } instead of {4:2}, i.e. subPath-based keys instead of indices, see example.
-     *
-     * Deprecated short-hand wrapper method for calling .getLocatorSchema(LocatorSchemaPath).getNestedLocator(subPathIndices?)
-     *
-     * @example
-     * // New Usage:
-     * const something = await poc.getNestedLocator("main.form.item.something", {
-     *     "main.form": 0, // locator.first() / locator.nth(0)
-     *     "main.form.item": 1, // locator.nth(1)
-     *   });
-     * await something.click();
-     */
-    getNestedLocator(locatorSchemaPath: LocatorSchemaPathType, indices?: {
-        [key: number]: number | null;
-    } | null): Promise<Locator>;
     /**
      * Short-hand wrapper method for calling .getLocatorSchema(LocatorSchemaPath).getLocator()
      *

package/dist/index.d.ts

@@ -296,7 +296,7 @@ type ExtractSubPaths<Path extends string> = Path extends `${infer Head}.${infer
  */
 type SubPaths<LocatorSchemaPathType extends string, LocatorSubstring extends LocatorSchemaPathType | undefined> = LocatorSubstring extends string ? Extract<LocatorSchemaPathType, LocatorSubstring | ExtractSubPaths<LocatorSubstring>> : never;
 /**
- * UpdatableLocatorSchemaProperties represent the properties of LocatorSchema that can be changed by update/updates,
+ * UpdatableLocatorSchemaProperties represent the properties of LocatorSchema that can be changed by update,
  * excluding the locatorSchemaPath itself, which remains immutable.
  */
 type LocatorSchemaWithoutPath = Omit<LocatorSchema, "locatorSchemaPath">;
@@ -340,43 +340,11 @@ type LocatorSchemaWithMethods<LocatorSchemaPathType extends string, LocatorSubst
      *
      * @example
      * // Direct usage:
-     * const submitButton = await poc.getLocatorSchema("main.form.button@submit").update("main.form.button@submit")
+     * const submitButton = await poc
+     * 	.getLocatorSchema("main.form.button@submit")
+     * 	.update("main.form.button@submit", { roleOptions: { name: "Submit" } })
      */
     update(subPath: SubPaths<LocatorSchemaPathType, LocatorSubstring>, updates: Partial<LocatorSchemaWithoutPath>): LocatorSchemaWithMethods<LocatorSchemaPathType, LocatorSubstring>;
-    /**
-     * @deprecated To be removed in version 2.0.0. Use the new `.update(subPath, updates)` method instead, see example.
-     *
-     * This deprecated update method takes one argument and only updates the LocatorSchema which the full LocatorSchemaPath resolves to.
-     *
-     * @example
-     * // New update method usage:
-     * const userInfoSection = await poc
-     * 	.getLocatorSchema("main.form.section")
-     * 	.update("main.form.section", { locatorOptions: { hasText: "User Info:" } })
-     * 	.getNestedLocator();
-     */
-    update(updates: Partial<LocatorSchemaWithoutPath>): LocatorSchemaWithMethods<LocatorSchemaPathType, LocatorSubstring>;
-    /**
-     * @deprecated To be removed in version 2.0.0. Use the new `.update(subPath, updates)` method instead, chain the
-     * method for each update if multiple, see example.
-     *
-     * This deprecated updates method uses indices to identify which schema to update.
-     *
-     * @example
-     * // New update method usage:
-     * const userInfoSection = await poc
-     * 	.getLocatorSchema("main.form.section")
-     * 	.update("main.form", {
-     * 		role: "form",
-     * 		roleOptions: { name: "Personalia" },
-     * 		locatorMethod: GetByMethod.role,
-     * 	})
-     * 	.update("main.form.section", { locatorOptions: { hasText: /User Info:/i } })
-     * 	.getNestedLocator();
-     */
-    updates(indexedUpdates: {
-        [index: number]: Partial<LocatorSchemaWithoutPath> | null;
-    }): LocatorSchemaWithMethods<LocatorSchemaPathType, LocatorSubstring>;
     /**
      * The equivalent of the Playwright locator.filter({...}) method and chainable on .getLocatorSchema(LocatorSchemaPath).
      * Can be chained multiple times to add multiple filters to the same or different LocatorSchema.
@@ -471,37 +439,6 @@ type LocatorSchemaWithMethods<LocatorSchemaPathType extends string, LocatorSubst
     getNestedLocator(subPathIndices?: {
         [K in SubPaths<LocatorSchemaPathType, LocatorSubstring>]?: number | null;
     }): Promise<Locator>;
-    /**
-     * @deprecated To be removed in version 2.0.0. Use getNestedLocator({ LocatorSchemaPath: index }) instead of
-     * number-based indexing, see example.
-     *
-     * @example
-     * // New usage:
-     * for (const [index, subscription] of subscriptions.entries()) {
-     *   const inputUsername = await poc
-     *     .getLocatorSchema("main.form.item.input@username")
-     *     .getNestedLocator({ "main.form.item": index });
-     *   await inputUsername.fill(subscription.username);
-     *   await inputUsername.blur();
-     *
-     *   const enableServiceCheckbox = await poc
-     *     .getLocatorSchema("main.form.item.checkbox@enableService")
-     *     .getNestedLocator({ "main.form.item": index });
-     *   await enableServiceCheckbox.check();
-     * }
-     *
-     * // indexing multiple subPaths:
-     * const something = await poc
-     *   .getLocatorSchema("main.form.item.something")
-     *   .getNestedLocator({
-     *     "main.form": 0, // locator.first() / locator.nth(0)
-     *     "main.form.item": 1, // locator.nth(1)
-     *   });
-     * await something.click();
-     */
-    getNestedLocator(indices?: {
-        [key: number]: number | null;
-    }): Promise<Locator>;
     /**
      * This method does not perform nesting,and will return the locator for which the full LocatorSchemaPath resolves to,
      * provided by getLocatorSchema("...")
@@ -527,7 +464,7 @@ type LocatorSchemaWithMethods<LocatorSchemaPathType extends string, LocatorSubst
  *
  * - getLocatorSchema(path):
  *   Returns a deep-copied schema and a chainable object (LocatorSchemaWithMethods) that
- *   allows calling update, updates, addFilter, and finally getNestedLocator or getLocator.
+ *   allows calling update, addFilter, and finally getNestedLocator or getLocator.
  *
  * - By using WithMethodsClass, we lock LocatorSubstring = P, the chosen path,
  *   ensuring addFilter suggests only valid sub-paths of P.
@@ -566,18 +503,6 @@ declare class GetLocatorBase<LocatorSchemaPathType extends string, LocatorSubstr
      * Similar to applyUpdate, but we locate the sub-path schema directly by its path.
      */
     applyUpdateToSubPath(schemasMap: Map<string, LocatorSchema>, subPath: LocatorSchemaPathType, updates: Partial<LocatorSchemaWithoutPath>): void;
-    /**
-     * applyUpdate:
-     * Applies updates to a single schema within the schemasMap.
-     */
-    applyUpdate(schemasMap: Map<string, LocatorSchema>, locatorSchemaPath: LocatorSchemaPathType, updateData: Partial<LocatorSchema>): void;
-    /**
-     * applyUpdates:
-     * Applies multiple updates to multiple schemas in the chain, identified by their path indexes.
-     */
-    applyUpdates(schemasMap: Map<string, LocatorSchema>, pathIndexPairs: PathIndexPairs, updatesData: {
-        [index: number]: Partial<LocatorSchema>;
-    }): void;
     /**
      * createLocatorSchema:
      * Creates a fresh LocatorSchema object by merging provided schemaDetails with a required locatorSchemaPath.
@@ -597,7 +522,7 @@ declare class GetLocatorBase<LocatorSchemaPathType extends string, LocatorSubstr
     /**
      * extractPathsFromSchema:
      * Splits a path into incremental sub-paths and associates them with optional indices.
-     * Used by updates and getNestedLocator methods.
+     * Used by getNestedLocator methods.
      */
     extractPathsFromSchema: (paths: string, indices?: Record<number, number>) => PathIndexPairs;
     /**
@@ -623,11 +548,6 @@ declare class GetLocatorBase<LocatorSchemaPathType extends string, LocatorSubstr
      * Helps with logging and debugging complex locator chains.
      */
     private evaluateCurrentLocator;
-    /**
-     * evaluateAndGetAttributes:
-     * Extracts tagName and attributes from all elements matched by the locator for debugging purposes.
-     */
-    private evaluateAndGetAttributes;
 }
 
 /**
@@ -797,22 +717,6 @@ declare abstract class BasePage<LocatorSchemaPathType extends string, Options ex
     getNestedLocator<P extends LocatorSchemaPathType>(locatorSchemaPath: P, subPathIndices?: {
         [K in SubPaths<LocatorSchemaPathType, P>]?: number | null;
     }): Promise<Locator>;
-    /**
-     * @deprecated Use { SubPaths: index } instead of {4:2}, i.e. subPath-based keys instead of indices, see example.
-     *
-     * Deprecated short-hand wrapper method for calling .getLocatorSchema(LocatorSchemaPath).getNestedLocator(subPathIndices?)
-     *
-     * @example
-     * // New Usage:
-     * const something = await poc.getNestedLocator("main.form.item.something", {
-     *     "main.form": 0, // locator.first() / locator.nth(0)
-     *     "main.form.item": 1, // locator.nth(1)
-     *   });
-     * await something.click();
-     */
-    getNestedLocator(locatorSchemaPath: LocatorSchemaPathType, indices?: {
-        [key: number]: number | null;
-    } | null): Promise<Locator>;
     /**
      * Short-hand wrapper method for calling .getLocatorSchema(LocatorSchemaPath).getLocator()
      *

package/dist/index.js

@@ -271,7 +271,6 @@ var GetBy = class {
 // src/helpers/getLocatorBase.ts
 var REQUIRED_PROPERTIES_FOR_LOCATOR_SCHEMA_WITH_METHODS = [
   "update",
-  "updates",
   "addFilter",
   "getNestedLocator",
   "getLocator",
@@ -378,41 +377,6 @@ var GetLocatorBase = class {
       schemasMap.set(subPath, updatedSchema);
     }
   }
-  /**
-   * applyUpdate:
-   * Applies updates to a single schema within the schemasMap.
-   */
-  applyUpdate(schemasMap, locatorSchemaPath, updateData) {
-    const schema = schemasMap.get(locatorSchemaPath);
-    if (schema) {
-      const updatedSchema = this.deepMerge(schema, updateData);
-      if (this.isLocatorSchemaWithMethods(schema)) {
-        Object.assign(schema, updatedSchema);
-      } else {
-        throw new Error("Invalid LocatorSchema object provided for update method.");
-      }
-    }
-  }
-  /**
-   * applyUpdates:
-   * Applies multiple updates to multiple schemas in the chain, identified by their path indexes.
-   */
-  applyUpdates(schemasMap, pathIndexPairs, updatesData) {
-    for (const [index, updateAtIndex] of Object.entries(updatesData)) {
-      const path = pathIndexPairs[Number.parseInt(index)]?.path;
-      if (path && updateAtIndex) {
-        const schema = schemasMap.get(path);
-        if (schema) {
-          const updatedSchema = this.deepMerge(schema, updateAtIndex);
-          if (this.isLocatorSchemaWithMethods(schema)) {
-            Object.assign(schema, updatedSchema);
-          } else {
-            schemasMap.set(path, updatedSchema);
-          }
-        }
-      }
-    }
-  }
   /**
    * createLocatorSchema:
    * Creates a fresh LocatorSchema object by merging provided schemaDetails with a required locatorSchemaPath.
@@ -454,7 +418,7 @@ Attempted to Add Schema: ${JSON.stringify(newLocatorSchema, null, 2)}`
   /**
    * extractPathsFromSchema:
    * Splits a path into incremental sub-paths and associates them with optional indices.
-   * Used by updates and getNestedLocator methods.
+   * Used by getNestedLocator methods.
    */
   extractPathsFromSchema = (paths, indices = {}) => {
     const schemaParts = paths.split(".");
@@ -636,27 +600,14 @@ Attempted to Add Schema: ${JSON.stringify(newLocatorSchema, null, 2)}`
         Note: "iFrame locators evaluation not implemented"
       });
     } else {
-      const elementsData = await this.evaluateAndGetAttributes(currentLocator);
+      const elementCount = await currentLocator.count();
       resultsArray.push({
         currentLocatorString: `${currentLocator}`,
-        resolved: elementsData.length > 0,
-        elementCount: elementsData.length,
-        elementsResolvedTo: elementsData
+        resolved: elementCount > 0,
+        elementCount
       });
     }
   };
-  /**
-   * evaluateAndGetAttributes:
-   * Extracts tagName and attributes from all elements matched by the locator for debugging purposes.
-   */
-  evaluateAndGetAttributes = async (pwLocator) => {
-    return await pwLocator.evaluateAll(
-      (objects) => objects.map((el) => {
-        const elementAttributes = el.hasAttributes() ? Object.fromEntries(Array.from(el.attributes).map(({ name, value }) => [name, value])) : {};
-        return { tagName: el.tagName, attributes: elementAttributes };
-      })
-    );
-  };
 };
 var WithMethodsClass = class extends GetLocatorBase {
   constructor(pageObjectClass, log, locatorSubstring, schemasMap) {
@@ -668,30 +619,18 @@ var WithMethodsClass = class extends GetLocatorBase {
   locatorSchemaPath;
   /**
    * init:
-   * Assigns the locatorSchemaPath and binds methods (update, updates, addFilter, getNestedLocator, getLocator)
+   * Assigns the locatorSchemaPath and binds methods (update, addFilter, getNestedLocator, getLocator)
    * directly on the locatorSchemaCopy. Returns the modified copy, now fully chainable and type-safe.
    */
   init(locatorSchemaPath, locatorSchemaCopy) {
     this.locatorSchemaPath = locatorSchemaPath;
     const self = this;
-    locatorSchemaCopy.update = function(a, b) {
+    locatorSchemaCopy.update = function(subPath, updates) {
       const fullPath = this.locatorSchemaPath;
-      if (b === void 0) {
-        const updates = a;
-        self.applyUpdate(self.schemasMap, self.locatorSchemaPath, updates);
-      } else {
-        const subPath = a;
-        const updates = b;
-        if (!(subPath === fullPath || fullPath.startsWith(`${subPath}.`))) {
-          throw new Error(`Invalid sub-path: '${subPath}' is not a valid sub-path of '${fullPath}'.`);
-        }
-        self.applyUpdateToSubPath(self.schemasMap, subPath, updates);
+      if (!(subPath === fullPath || fullPath.startsWith(`${subPath}.`))) {
+        throw new Error(`Invalid sub-path: '${subPath}' is not a valid sub-path of '${fullPath}'.`);
       }
-      return this;
-    };
-    locatorSchemaCopy.updates = function(indexedUpdates) {
-      const pathIndexPairs = self.extractPathsFromSchema(self.locatorSchemaPath);
-      self.applyUpdates(self.schemasMap, pathIndexPairs, indexedUpdates);
+      self.applyUpdateToSubPath(self.schemasMap, subPath, updates);
       return this;
     };
     locatorSchemaCopy.addFilter = function(subPath, filterData) {
@@ -723,46 +662,33 @@ ${allowedPaths.join(",\n")}`
           {}
         );
       }
-      const keys = Object.keys(arg);
-      const isNumberKey = keys.every((key) => /^\d+$/.test(key));
       const numericIndices = {};
-      if (isNumberKey) {
-        for (const [key, value] of Object.entries(arg)) {
-          const index = Number(key);
-          if (typeof value === "number" && value >= 0) {
-            numericIndices[index] = value;
-          } else if (value !== null) {
-            throw new Error(`Invalid index value at key '${key}': Expected a positive number or null.`);
-          }
-        }
-      } else {
-        const pathIndexPairs = self.extractPathsFromSchema(self.locatorSchemaPath);
-        const pathToIndexMap = new Map(pathIndexPairs.map((pair, idx) => [pair.path, idx]));
-        for (const [subPath, value] of Object.entries(arg)) {
-          if (!self.schemasMap.has(subPath)) {
-            const validPaths = Array.from(self.schemasMap.keys());
-            throw new Error(
-              `Invalid sub-path '${subPath}' in getNestedLocator. Allowed sub-paths are:
+      const pathIndexPairs = self.extractPathsFromSchema(self.locatorSchemaPath);
+      const pathToIndexMap = new Map(pathIndexPairs.map((pair, idx) => [pair.path, idx]));
+      for (const [subPath, value] of Object.entries(arg)) {
+        if (!self.schemasMap.has(subPath)) {
+          const validPaths = Array.from(self.schemasMap.keys());
+          throw new Error(
+            `Invalid sub-path '${subPath}' in getNestedLocator. Allowed sub-paths are:
 ${validPaths.join(",\n")}`
-            );
-          }
-          if (!pathToIndexMap.has(subPath)) {
-            const validPaths = pathIndexPairs.map((p) => p.path).filter((path) => self.schemasMap.has(path));
-            throw new Error(
-              `Invalid sub-path '${subPath}' in getNestedLocator. Allowed sub-paths are:
+          );
+        }
+        if (!pathToIndexMap.has(subPath)) {
+          const validPaths = pathIndexPairs.map((p) => p.path).filter((path) => self.schemasMap.has(path));
+          throw new Error(
+            `Invalid sub-path '${subPath}' in getNestedLocator. Allowed sub-paths are:
 ${validPaths.join(",\n")}`
-            );
-          }
-          const numericIndex = pathToIndexMap.get(subPath);
-          if (numericIndex === void 0) {
-            throw new Error(`Sub-path '${subPath}' not found in pathToIndexMap.`);
-          }
-          if (value !== null && (typeof value !== "number" || value < 0)) {
-            throw new Error(`Invalid index for sub-path '${subPath}': Expected a positive number or null.`);
-          }
-          if (value !== null) {
-            numericIndices[numericIndex] = value;
-          }
+          );
+        }
+        const numericIndex = pathToIndexMap.get(subPath);
+        if (numericIndex === void 0) {
+          throw new Error(`Sub-path '${subPath}' not found in pathToIndexMap.`);
+        }
+        if (value !== null && (typeof value !== "number" || value < 0)) {
+          throw new Error(`Invalid index for sub-path '${subPath}': Expected a positive number or null.`);
+        }
+        if (value !== null) {
+          numericIndices[numericIndex] = value;
         }
       }
       return await self.buildNestedLocator(

package/dist/index.mjs

@@ -240,7 +240,6 @@ var GetBy = class {
 // src/helpers/getLocatorBase.ts
 var REQUIRED_PROPERTIES_FOR_LOCATOR_SCHEMA_WITH_METHODS = [
   "update",
-  "updates",
   "addFilter",
   "getNestedLocator",
   "getLocator",
@@ -347,41 +346,6 @@ var GetLocatorBase = class {
       schemasMap.set(subPath, updatedSchema);
     }
   }
-  /**
-   * applyUpdate:
-   * Applies updates to a single schema within the schemasMap.
-   */
-  applyUpdate(schemasMap, locatorSchemaPath, updateData) {
-    const schema = schemasMap.get(locatorSchemaPath);
-    if (schema) {
-      const updatedSchema = this.deepMerge(schema, updateData);
-      if (this.isLocatorSchemaWithMethods(schema)) {
-        Object.assign(schema, updatedSchema);
-      } else {
-        throw new Error("Invalid LocatorSchema object provided for update method.");
-      }
-    }
-  }
-  /**
-   * applyUpdates:
-   * Applies multiple updates to multiple schemas in the chain, identified by their path indexes.
-   */
-  applyUpdates(schemasMap, pathIndexPairs, updatesData) {
-    for (const [index, updateAtIndex] of Object.entries(updatesData)) {
-      const path = pathIndexPairs[Number.parseInt(index)]?.path;
-      if (path && updateAtIndex) {
-        const schema = schemasMap.get(path);
-        if (schema) {
-          const updatedSchema = this.deepMerge(schema, updateAtIndex);
-          if (this.isLocatorSchemaWithMethods(schema)) {
-            Object.assign(schema, updatedSchema);
-          } else {
-            schemasMap.set(path, updatedSchema);
-          }
-        }
-      }
-    }
-  }
   /**
    * createLocatorSchema:
    * Creates a fresh LocatorSchema object by merging provided schemaDetails with a required locatorSchemaPath.
@@ -423,7 +387,7 @@ Attempted to Add Schema: ${JSON.stringify(newLocatorSchema, null, 2)}`
   /**
    * extractPathsFromSchema:
    * Splits a path into incremental sub-paths and associates them with optional indices.
-   * Used by updates and getNestedLocator methods.
+   * Used by getNestedLocator methods.
    */
   extractPathsFromSchema = (paths, indices = {}) => {
     const schemaParts = paths.split(".");
@@ -605,27 +569,14 @@ Attempted to Add Schema: ${JSON.stringify(newLocatorSchema, null, 2)}`
         Note: "iFrame locators evaluation not implemented"
       });
     } else {
-      const elementsData = await this.evaluateAndGetAttributes(currentLocator);
+      const elementCount = await currentLocator.count();
       resultsArray.push({
         currentLocatorString: `${currentLocator}`,
-        resolved: elementsData.length > 0,
-        elementCount: elementsData.length,
-        elementsResolvedTo: elementsData
+        resolved: elementCount > 0,
+        elementCount
       });
     }
   };
-  /**
-   * evaluateAndGetAttributes:
-   * Extracts tagName and attributes from all elements matched by the locator for debugging purposes.
-   */
-  evaluateAndGetAttributes = async (pwLocator) => {
-    return await pwLocator.evaluateAll(
-      (objects) => objects.map((el) => {
-        const elementAttributes = el.hasAttributes() ? Object.fromEntries(Array.from(el.attributes).map(({ name, value }) => [name, value])) : {};
-        return { tagName: el.tagName, attributes: elementAttributes };
-      })
-    );
-  };
 };
 var WithMethodsClass = class extends GetLocatorBase {
   constructor(pageObjectClass, log, locatorSubstring, schemasMap) {
@@ -637,30 +588,18 @@ var WithMethodsClass = class extends GetLocatorBase {
   locatorSchemaPath;
   /**
    * init:
-   * Assigns the locatorSchemaPath and binds methods (update, updates, addFilter, getNestedLocator, getLocator)
+   * Assigns the locatorSchemaPath and binds methods (update, addFilter, getNestedLocator, getLocator)
    * directly on the locatorSchemaCopy. Returns the modified copy, now fully chainable and type-safe.
    */
   init(locatorSchemaPath, locatorSchemaCopy) {
     this.locatorSchemaPath = locatorSchemaPath;
     const self = this;
-    locatorSchemaCopy.update = function(a, b) {
+    locatorSchemaCopy.update = function(subPath, updates) {
       const fullPath = this.locatorSchemaPath;
-      if (b === void 0) {
-        const updates = a;
-        self.applyUpdate(self.schemasMap, self.locatorSchemaPath, updates);
-      } else {
-        const subPath = a;
-        const updates = b;
-        if (!(subPath === fullPath || fullPath.startsWith(`${subPath}.`))) {
-          throw new Error(`Invalid sub-path: '${subPath}' is not a valid sub-path of '${fullPath}'.`);
-        }
-        self.applyUpdateToSubPath(self.schemasMap, subPath, updates);
+      if (!(subPath === fullPath || fullPath.startsWith(`${subPath}.`))) {
+        throw new Error(`Invalid sub-path: '${subPath}' is not a valid sub-path of '${fullPath}'.`);
       }
-      return this;
-    };
-    locatorSchemaCopy.updates = function(indexedUpdates) {
-      const pathIndexPairs = self.extractPathsFromSchema(self.locatorSchemaPath);
-      self.applyUpdates(self.schemasMap, pathIndexPairs, indexedUpdates);
+      self.applyUpdateToSubPath(self.schemasMap, subPath, updates);
       return this;
     };
     locatorSchemaCopy.addFilter = function(subPath, filterData) {
@@ -692,46 +631,33 @@ ${allowedPaths.join(",\n")}`
           {}
         );
       }
-      const keys = Object.keys(arg);
-      const isNumberKey = keys.every((key) => /^\d+$/.test(key));
       const numericIndices = {};
-      if (isNumberKey) {
-        for (const [key, value] of Object.entries(arg)) {
-          const index = Number(key);
-          if (typeof value === "number" && value >= 0) {
-            numericIndices[index] = value;
-          } else if (value !== null) {
-            throw new Error(`Invalid index value at key '${key}': Expected a positive number or null.`);
-          }
-        }
-      } else {
-        const pathIndexPairs = self.extractPathsFromSchema(self.locatorSchemaPath);
-        const pathToIndexMap = new Map(pathIndexPairs.map((pair, idx) => [pair.path, idx]));
-        for (const [subPath, value] of Object.entries(arg)) {
-          if (!self.schemasMap.has(subPath)) {
-            const validPaths = Array.from(self.schemasMap.keys());
-            throw new Error(
-              `Invalid sub-path '${subPath}' in getNestedLocator. Allowed sub-paths are:
+      const pathIndexPairs = self.extractPathsFromSchema(self.locatorSchemaPath);
+      const pathToIndexMap = new Map(pathIndexPairs.map((pair, idx) => [pair.path, idx]));
+      for (const [subPath, value] of Object.entries(arg)) {
+        if (!self.schemasMap.has(subPath)) {
+          const validPaths = Array.from(self.schemasMap.keys());
+          throw new Error(
+            `Invalid sub-path '${subPath}' in getNestedLocator. Allowed sub-paths are:
 ${validPaths.join(",\n")}`
-            );
-          }
-          if (!pathToIndexMap.has(subPath)) {
-            const validPaths = pathIndexPairs.map((p) => p.path).filter((path) => self.schemasMap.has(path));
-            throw new Error(
-              `Invalid sub-path '${subPath}' in getNestedLocator. Allowed sub-paths are:
+          );
+        }
+        if (!pathToIndexMap.has(subPath)) {
+          const validPaths = pathIndexPairs.map((p) => p.path).filter((path) => self.schemasMap.has(path));
+          throw new Error(
+            `Invalid sub-path '${subPath}' in getNestedLocator. Allowed sub-paths are:
 ${validPaths.join(",\n")}`
-            );
-          }
-          const numericIndex = pathToIndexMap.get(subPath);
-          if (numericIndex === void 0) {
-            throw new Error(`Sub-path '${subPath}' not found in pathToIndexMap.`);
-          }
-          if (value !== null && (typeof value !== "number" || value < 0)) {
-            throw new Error(`Invalid index for sub-path '${subPath}': Expected a positive number or null.`);
-          }
-          if (value !== null) {
-            numericIndices[numericIndex] = value;
-          }
+          );
+        }
+        const numericIndex = pathToIndexMap.get(subPath);
+        if (numericIndex === void 0) {
+          throw new Error(`Sub-path '${subPath}' not found in pathToIndexMap.`);
+        }
+        if (value !== null && (typeof value !== "number" || value < 0)) {
+          throw new Error(`Invalid index for sub-path '${subPath}': Expected a positive number or null.`);
+        }
+        if (value !== null) {
+          numericIndices[numericIndex] = value;
         }
       }
       return await self.buildNestedLocator(

package/docs/get-locator-methods-explanation.md

@@ -137,8 +137,6 @@ test("specify index for nested locators", async ({ profile }) => {
 });
 ```
 
-> Legacy numeric indices are still supported but will be removed in a future major version. Prefer keyed sub paths as shown above.
-
 ## Building chains with `getLocatorSchema()`
 
 `getLocatorSchema(path)` returns a deep copy of every schema that makes up the `path` plus chainable helpers for refining the locator. All manipulations happen on the copy, so the original definitions inside the page object stay immutable.
@@ -249,18 +247,4 @@ await editButtonUpdated.click();
 // returns a fresh deep copy of the original schema chain.
 ```
 
-## Migrating from deprecated helpers
-
-Earlier versions exposed index-based helpers. They continue to work but are deprecated in favour of the sub-path syntax described above.
-
-```ts
-// old
-await profile.getNestedLocator("content.region.details.button.save", { 4: 2 });
-
-// new
-await profile.getNestedLocator("content.region.details.button.save", {
-  "content.region.details.button.save": 2
-});
-```
-
 Switching to sub-path keys makes updates easier when `LocatorSchemaPath` strings change, and TypeScript will warn you if you mistype a path. While improving readability.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pomwright",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "POMWright is a complementary test framework for Playwright written in TypeScript.",
   "repository": {
     "type": "git",