@letsrunit/playwright 0.7.1 → 0.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@letsrunit/playwright",
-  "version": "0.7.1",
+  "version": "0.9.0",
   "description": "Playwright extensions and utilities for letsrunit",
   "keywords": [
     "testing",
@@ -42,7 +42,7 @@
   },
   "packageManager": "yarn@4.10.3",
   "dependencies": {
-    "@letsrunit/utils": "0.7.1",
+    "@letsrunit/utils": "0.9.0",
     "@playwright/test": "^1.57.0",
     "case": "^1.6.3",
     "diff": "^8.0.3",

package/src/fuzzy-locator.ts

@@ -1,26 +1,39 @@
 import { Locator, Page } from '@playwright/test';
 
+function debug(...args: unknown[]) {
+  if (process.env.LETSRUNIT_DEBUG_FUZZY_LOCATOR === '1') {
+    // eslint-disable-next-line no-console
+    console.log('[fuzzyLocator]', ...args);
+  }
+}
+
 /**
  * Locates an element using Playwright selectors, with lazy fallbacks.
  */
 export async function fuzzyLocator(page: Page, selector: string): Promise<Locator> {
+  debug('input selector:', selector);
   const primary = page.locator(selector);
-  const candidates = [
-    tryRelaxNameToHasText(page, selector),
-    tryTagInsteadOfRole(page, selector),
-    tryRoleNameProximity(page, selector),
-    tryFieldAlternative(page, selector),
-    tryAsField(page, selector),
+  const candidates: Array<{ name: string; locator: Locator | null }> = [
+    { name: 'relaxNameToHasText', locator: tryRelaxNameToHasText(page, selector) },
+    { name: 'tagInsteadOfRole', locator: tryTagInsteadOfRole(page, selector) },
+    { name: 'roleNameProximity', locator: tryRoleNameProximity(page, selector) },
+    { name: 'fieldAlternative', locator: tryFieldAlternative(page, selector) },
+    { name: 'asField', locator: tryAsField(page, selector) },
   ];
 
   let combined = primary;
+  const enabled: string[] = [];
 
   for (const candidate of candidates) {
-    if (!candidate) continue;
-    combined = combined.or(candidate);
+    if (!candidate.locator) continue;
+    enabled.push(candidate.name);
+    combined = combined.or(candidate.locator);
   }
+  debug('enabled fallbacks:', enabled.length ? enabled.join(', ') : '(none)');
 
-  return combined.first();
+  const result = combined.first();
+  debug('returning locator:', result.toString());
+  return result;
 }
 
 // Preserve the selector but relax [name="..."] to [has-text="..."]

package/src/index.ts

@@ -11,3 +11,4 @@ export * from './types';
 export * from './utils/date';
 export * from './wait';
 export * from './scrub-html';
+export * from './unified-html-diff';

package/src/scrub-html.ts

@@ -31,6 +31,9 @@ export type ScrubHtmlOptions = {
   replaceBrInHeadings?: boolean;
   /** Limit lists to max items: -1 mean no limit. Default: -1 */
   limitLists?: number;
+  /** Strip utility-framework classes (Tailwind, Bootstrap, UnoCSS, Windi) from class
+   *  attributes. Removes the attribute entirely when all classes are stripped. Default: false */
+  dropUtilityClasses?: boolean;
 };
 
 const HTML_MIN_ATTR_THRESHOLD = 250_000;    // ~70k tokens
@@ -48,6 +51,7 @@ function getDefaults(contentLength: number): Required<ScrubHtmlOptions> {
     dropComments: true,
     replaceBrInHeadings: true,
     limitLists: contentLength >= HTML_LIMIT_LISTS_THRESHOLD ? 20 : -1,
+    dropUtilityClasses: false,
   };
 }
 
@@ -183,6 +187,7 @@ export async function realScrubHtml(
   if (o.dropComments) dropHtmlComments(doc);
   if (o.replaceBrInHeadings) replaceBrsInHeadings(doc);
   if (o.limitLists >= 0) limitListsAndRows(doc, o.limitLists);
+  if (o.dropUtilityClasses) stripUtilityClasses(doc);
   if (o.normalizeWhitespace) normalizeWhitespace(doc.body);
 
   return doc.body.innerHTML;
@@ -314,6 +319,41 @@ function replaceBrsInHeadings(doc: Document) {
   });
 }
 
+// ---- Utility class detection ----
+
+// Any class containing ':' is a Tailwind/Windi/UnoCSS variant prefix (hover:, sm:, dark:focus:, …)
+const UTILITY_VARIANT_RE = /:/;
+
+// Prefix-based utility patterns (Tailwind + Bootstrap)
+const UTILITY_PREFIX_RE = /^-?(?:p[xytblrse]?|m[xytblrse]?|gap|space-[xy]|w|h|min-w|min-h|max-w|max-h|size|basis|inset|top|right|bottom|left|start|end|z|text|bg|border|ring|shadow|outline|fill|stroke|divide|accent|caret|from|via|to|decoration|font|leading|tracking|indent|line-clamp|columns|aspect|object|opacity|rotate|scale|translate|skew|transition|duration|ease|delay|animate|rounded|overflow|overscroll|scroll|snap|touch|cursor|pointer-events|select|resize|flex|grid|col|row|order|auto-cols|auto-rows|items|justify|content|self|place|float|clear|list|whitespace|break|hyphens|mix-blend|bg-blend|backdrop|d|g|fs|fw|lh|align|position)-/i;
+
+// Standalone keywords that are utilities on their own (no suffix)
+const UTILITY_STANDALONE = new Set([
+  'flex', 'grid', 'block', 'hidden', 'inline', 'inline-block', 'inline-flex', 'inline-grid',
+  'contents', 'flow-root', 'list-item', 'table', 'container', 'truncate',
+  'grow', 'shrink', 'static', 'relative', 'absolute', 'fixed', 'sticky',
+  'visible', 'invisible', 'collapse', 'isolate',
+  'underline', 'overline', 'line-through', 'no-underline',
+  'uppercase', 'lowercase', 'capitalize', 'normal-case',
+  'italic', 'not-italic', 'antialiased', 'subpixel-antialiased',
+  'sr-only', 'not-sr-only', 'clearfix', 'row', 'col',
+]);
+
+function isUtilityClass(token: string): boolean {
+  if (UTILITY_VARIANT_RE.test(token)) return true;
+  const base = token.startsWith('-') ? token.slice(1) : token;
+  if (UTILITY_STANDALONE.has(base)) return true;
+  return UTILITY_PREFIX_RE.test(token);
+}
+
+function stripUtilityClasses(doc: Document) {
+  for (const el of doc.body.querySelectorAll<HTMLElement>('[class]')) {
+    const kept = el.className.split(/\s+/).filter((t) => t && !isUtilityClass(t));
+    if (kept.length === 0) el.removeAttribute('class');
+    else el.className = kept.join(' ');
+  }
+}
+
 function limitListsAndRows(doc: Document, limit: number) {
   // lists
   doc.querySelectorAll('ul, ol').forEach((list) => {

package/src/snapshot.ts

@@ -1,16 +1,30 @@
 import { sleep } from '@letsrunit/utils';
 import type { Page } from '@playwright/test';
 import { screenshot } from './screenshot';
+import { realScrubHtml } from './scrub-html';
 import type { Snapshot } from './types';
 import { waitForDomIdle } from './wait';
 
-export async function snapshot(page: Page): Promise<Snapshot> {
+export type SnapshotOptions = {
+  /** Strip utility-framework classes (Tailwind, Bootstrap, UnoCSS, Windi) from the captured HTML. */
+  dropUtilityClasses?: boolean;
+};
+
+export async function snapshot(page: Page, opts: SnapshotOptions = {}): Promise<Snapshot> {
   await sleep(500);
   await waitForDomIdle(page);
 
   const [url, html, file] = await Promise.all([page.url(), getContentWithMarkedHidden(page), screenshot(page)]);
 
-  return { url, html, screenshot: file };
+  const finalHtml = opts.dropUtilityClasses
+    ? await realScrubHtml({ html, url }, {
+        dropHidden: false, dropHead: false, dropSvg: false, pickMain: false,
+        stripAttributes: 0, normalizeWhitespace: false, dropComments: false,
+        replaceBrInHeadings: false, limitLists: -1, dropUtilityClasses: true,
+      })
+    : html;
+
+  return { url, html: finalHtml, screenshot: file };
 }
 
 async function getContentWithMarkedHidden(page: Page): Promise<string> {