pw-core 1.3.0 → 1.3.1

package/dist/codegen/generator/id-stability.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isStableId = isStableId;
+/**
+ * Checks whether an HTML element's ID attribute is stable and non-generated.
+ * Filters out framework auto-generated IDs (React, MUI, HeadlessUI, Ember, Angular),
+ * UUIDs, hashes, and purely numeric IDs.
+ */
+function isStableId(id) {
+    if (!id)
+        return false;
+    const lower = id.toLowerCase();
+    // React/MUI/HeadlessUI/Ember auto-generated patterns
+    if (lower.startsWith(':r') && /\d/.test(lower))
+        return false;
+    if (lower.startsWith('mui-'))
+        return false;
+    if (lower.startsWith('headlessui-'))
+        return false;
+    if (lower.startsWith('ember-'))
+        return false;
+    if (lower.startsWith('ng-'))
+        return false;
+    // UUID pattern
+    const uuidRegex = /[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/i;
+    if (uuidRegex.test(lower))
+        return false;
+    // Long hex hashes or random looking alpha-numeric (e.g. f4c2d91, 8d72b3ef)
+    const hexHashRegex = /^[0-9a-f]{7,8}$/i;
+    if (hexHashRegex.test(lower))
+        return false;
+    // Purely numeric or ends with a long random number (e.g. button-12847291)
+    if (/^\d+$/.test(lower))
+        return false;
+    if (/\d{5,}$/.test(lower))
+        return false;
+    return true;
+}

package/dist/codegen/generator/index.d.ts

@@ -1,13 +1,11 @@
+import type { Page } from '@playwright/test';
 import { LocatorCandidate } from '../types';
-export declare function isStableId(id: string): boolean;
-export declare function generateKeyFromText(text: string, role?: string): string;
+export { isStableId } from './id-stability';
+export { generateKeyFromText, generateKeyFromCandidate } from './key-builder';
+export { validateAndSelectLocator } from './locator.validator';
+export { normalizeActionName } from './action.validator';
 /**
- * Derive a camelCase key from a candidate's attribute/selector value.
- * E.g. data-parent-id="why-pw-core" → whyPwCore
+ * Evaluates the element at `selector` inside the page, scans candidate locators across the DOM tree,
+ * scores and ranks them based on priority, stability, semantics, and uniqueness, and returns the best candidate.
  */
-export declare function generateKeyFromCandidate(candidate: {
-    strategy: string;
-    selector: string;
-    valueToScore?: string;
-}, role?: string): string;
-export declare function generateSmartLocator(page: any, selector: string): Promise<LocatorCandidate | null>;
+export declare function generateSmartLocator(page: Page, selector: string): Promise<LocatorCandidate | null>;