@letsrunit/playwright 0.1.0

package/src/translations/sl.ts

@@ -0,0 +1,7 @@
+const translations = {
+  accept: ["Sprejmi", "Sprejmi vse", "Strinjam se", "Dovoli", "Dovoli vse", "V redu", "OK", "Razumem", "Nadaljuj", "Shrani in sprejmi", "Potrdi", "Shrani nastavitve"],
+  reject: ["Zavrni", "Zavrni vse", "Ne sprejemam", "Ne dovoli", "Samo nujno", "Le nujni piškotki", "Nadaljuj brez piškotkov", "Ne, hvala", "Onemogoči vse", "Zavrni neobvezne"],
+  close: ["Zapri", "Prekliči", "Ne zdaj", "Kasneje", "×", "Skrij", "Zapri obvestilo", "Nazaj", "Zapri okno"]
+};
+
+export default translations;

package/src/translations/sv.ts

@@ -0,0 +1,44 @@
+const translations = {
+  accept: [
+    "Godkänn",
+    "Godkänn alla",
+    "Acceptera",
+    "Acceptera alla",
+    "Jag samtycker",
+    "Tillåt",
+    "Tillåt alla",
+    "OK",
+    "Okej",
+    "Jag förstår",
+    "Fortsätt",
+    "Spara och godkänn",
+    "Bekräfta",
+    "Gå vidare",
+    "Klart"
+  ],
+  reject: [
+    "Avvisa",
+    "Avvisa alla",
+    "Avböj",
+    "Neka",
+    "Neka alla",
+    "Endast nödvändiga",
+    "Enbart nödvändiga",
+    "Fortsätt utan kakor",
+    "Nej tack",
+    "Avstå"
+  ],
+  close: [
+    "Stäng",
+    "Avbryt",
+    "Stäng fönster",
+    "Inte nu",
+    "Nej tack",
+    "Senare",
+    "Hoppa över",
+    "Tillbaka",
+    "×"
+  ]
+};
+
+export default translations;

package/src/translations/sw.ts

@@ -0,0 +1,7 @@
+const translations = {
+  accept: ["Kubali", "Kubali yote", "Ruhusu", "Ruhusu yote", "Sawa", "Sawa sawa", "Nimeelewa", "Endelea", "Hifadhi na kubali", "Nakubali"],
+  reject: ["Kataa", "Kataa yote", "Usiruhusu", "Usikubali", "Muhimu tu", "Ya lazima pekee", "Endelea bila vidakuzi", "Hapana, asante"],
+  close: ["Funga", "Ghairi", "Ondoa", "Puuza", "Tupilia mbali", "Si sasa", "Baadaye", "×"]
+};
+
+export default translations;

package/src/translations/ta.ts

@@ -0,0 +1,7 @@
+const translations = {
+  accept: ["ஏற்கவும்", "அனைத்தையும் ஏற்கவும்", "உடன்படுகிறேன்", "அனுமதிக்கவும்", "அனைத்தையும் அனுமதிக்கவும்", "சரி", "ஓகே", "புரிந்தது", "தொடரவும்", "சேமித்து ஏற்கவும்"],
+  reject: ["நிராகரிக்கவும்", "அனைத்தையும் நிராகரிக்கவும்", "மறுக்கவும்", "அனுமதிக்க வேண்டாம்", "தேவையானவை மட்டும்", "முக்கியமானவை மட்டும்", "குக்கீகள் இல்லாமல் தொடரவும்", "இல்லை, நன்றி"],
+  close: ["மூடவும்", "ரத்து செய்யவும்", "தவிர்க்கவும்", "இப்போது வேண்டாம்", "இல்லை, நன்றி", "பின்னர்", "×"]
+};
+
+export default translations;

package/src/translations/th.ts

@@ -0,0 +1,39 @@
+const translations = {
+  accept: [
+    "ยอมรับ",
+    "ยอมรับทั้งหมด",
+    "เห็นด้วย",
+    "อนุญาต",
+    "อนุญาตทั้งหมด",
+    "ตกลง",
+    "โอเค",
+    "รับทราบ",
+    "ดำเนินการต่อ",
+    "บันทึกและยอมรับ",
+    "บันทึกการตั้งค่าและยอมรับ",
+    "ยืนยัน"
+  ],
+  reject: [
+    "ปฏิเสธ",
+    "ปฏิเสธทั้งหมด",
+    "ไม่ยอมรับ",
+    "ไม่อนุญาต",
+    "เฉพาะคุกกี้ที่จำเป็น",
+    "ใช้เฉพาะที่จำเป็น",
+    "ไปต่อโดยไม่ใช้คุกกี้",
+    "ไม่ ขอบคุณ",
+    "ข้าม"
+  ],
+  close: [
+    "ปิด",
+    "ยกเลิก",
+    "ปิดหน้าต่าง",
+    "ปิดการแจ้งเตือน",
+    "ยังไม่ใช่ตอนนี้",
+    "ไว้ทีหลัง",
+    "ทีหลัง",
+    "×"
+  ]
+};
+
+export default translations;

package/src/translations/tl.ts

@@ -0,0 +1,7 @@
+const translations = {
+  accept: ["Tanggapin", "Tanggapin lahat", "Sumang-ayon", "Payagan", "Payagan lahat", "OK", "Okay", "Sige", "Naintindihan", "Magpatuloy", "I-save at tanggapin"],
+  reject: ["Tanggihan", "Tanggihan lahat", "Huwag payagan", "Kinakailangan lang", "Mga kinakailangan lang", "Mahahalaga lang", "Magpatuloy nang walang mga cookie", "Hindi, salamat", "Huwag na lang"],
+  close: ["Isara", "Kanselahin", "Isantabi", "Hindi ngayon", "Huwag muna", "Mamaya", "×"]
+};
+
+export default translations;

package/src/translations/tr.ts

@@ -0,0 +1,41 @@
+const translations = {
+  accept: [
+    "Kabul et",
+    "Tümünü kabul et",
+    "Onayla",
+    "İzin ver",
+    "Tümüne izin ver",
+    "Anladım",
+    "Devam et",
+    "Kaydet ve kabul et",
+    "Ayarları kaydet",
+    "Kabul ediyorum"
+  ],
+  reject: [
+    "Reddet",
+    "Tümünü reddet",
+    "Kabul etmiyorum",
+    "İzin verme",
+    "Yalnızca gerekli olanlar",
+    "Sadece zorunlu olanlar",
+    "Gerekli olanlarla devam et",
+    "Çerez olmadan devam et",
+    "Çerezsiz devam et",
+    "Hayır, teşekkürler",
+    "Yalnızca zorunlu çerezlere izin ver"
+  ],
+  close: [
+    "Kapat",
+    "İptal",
+    "Vazgeç",
+    "Şimdilik değil",
+    "Daha sonra",
+    "Geri",
+    "Pencereyi kapat",
+    "×",
+    "X",
+    "Tamam"
+  ]
+};
+
+export default translations;

package/src/translations/uk.ts

@@ -0,0 +1,7 @@
+const translations = {
+  accept: ["Прийняти", "Прийняти все", "Погодитися", "Дозволити", "Дозволити все", "ОК", "Добре", "Зрозуміло", "Продовжити", "Зберегти та прийняти", "Підтвердити", "Так", "Гаразд", "Далі"],
+  reject: ["Відхилити", "Відхилити все", "Відмовитися", "Не приймати", "Не дозволяти", "Лише необхідні", "Тільки необхідні", "Лише обов’язкові", "Продовжити без файлів cookie", "Без файлів cookie", "Ні, дякую"],
+  close: ["Закрити", "Скасувати", "Закрити вікно", "Не зараз", "Пізніше", "Пропустити", "Готово", "×"]
+};
+
+export default translations;

package/src/translations/ur.ts

@@ -0,0 +1,43 @@
+const translations = {
+  accept: [
+    "قبول کریں",
+    "سب قبول کریں",
+    "قبول ہے",
+    "میں متفق ہوں",
+    "اجازت دیں",
+    "تمام کی اجازت دیں",
+    "ٹھیک ہے",
+    "اوکے",
+    "جاری رکھیں",
+    "آگے بڑھیں",
+    "محفوظ کریں اور قبول کریں",
+    "ہاں"
+  ],
+  reject: [
+    "رد کریں",
+    "سب رد کریں",
+    "انکار کریں",
+    "اجازت نہ دیں",
+    "صرف ضروری",
+    "صرف لازمی",
+    "صرف بنیادی",
+    "کوکیز کے بغیر جاری رکھیں",
+    "نہیں، شکریہ",
+    "قبول نہیں",
+    "منع کریں",
+    "اختیارات محدود کریں"
+  ],
+  close: [
+    "بند کریں",
+    "منسوخ کریں",
+    "خارج کریں",
+    "ابھی نہیں",
+    "بعد میں",
+    "نہیں، شکریہ",
+    "×",
+    "واپس",
+    "چھپائیں"
+  ]
+};
+
+export default translations;

package/src/translations/vi.ts

@@ -0,0 +1,7 @@
+const translations = {
+  accept: ["Đồng ý", "Tôi đồng ý", "Chấp nhận", "Chấp nhận tất cả", "Cho phép", "Cho phép tất cả", "OK", "Đã hiểu", "Tiếp tục", "Lưu và chấp nhận"],
+  reject: ["Từ chối", "Từ chối tất cả", "Không đồng ý", "Không cho phép", "Chỉ bắt buộc", "Chỉ cho phép cần thiết", "Tiếp tục mà không cần cookie", "Không, cảm ơn"],
+  close: ["Đóng", "Hủy", "Bỏ qua", "Không phải bây giờ", "Để sau", "Không, cảm ơn", "×", "Tắt", "Ẩn"]
+};
+
+export default translations;

package/src/translations/zh.ts

@@ -0,0 +1,7 @@
+const translations = {
+  accept: ["同意", "全部同意", "接受", "全部接受", "允许", "全部允许", "确定", "好的", "我知道了", "继续", "保存并接受", "继续并同意"],
+  reject: ["拒绝", "全部拒绝", "不同意", "不允许", "仅保留必要项", "仅限必要", "仅启用必要功能", "仅使用必要 Cookie", "继续但不使用 Cookie", "不用了，谢谢", "暂不同意"],
+  close: ["关闭", "取消", "忽略", "暂不", "稍后", "以后再说", "返回", "×"]
+};
+
+export default translations;

package/src/types.ts

@@ -0,0 +1,37 @@
+export interface Snapshot {
+  url: string;
+  html: string;
+  screenshot: File;
+}
+
+export interface PageInfo {
+  /** Page name (from <title> or meta tags) */
+  name?: string;
+
+  /** Short page description (meta description or OG/Twitter) */
+  description?: string;
+
+  /** Main image for previews (OpenGraph/Twitter) */
+  image?: string;
+
+  /** Site or brand logo if available */
+  logo?: string;
+
+  /** Author name if specified */
+  author?: string;
+
+  /** Publisher or organization name */
+  publisher?: string;
+
+  /** Page language, e.g. "en", "nl-NL" */
+  lang?: string;
+
+  /** Favicon URL */
+  favicon?: string;
+
+  /** Canonical or resolved page URL */
+  url: string;
+
+  /** Screenshot of the page */
+  screenshot?: File;
+}

package/src/unified-html-diff.ts

@@ -0,0 +1,22 @@
+import type { Page } from '@playwright/test';
+import * as Diff from 'diff';
+import { formatHtml } from './format-html';
+import { scrubHtml } from './scrub-html';
+import { isPage } from './utils/type-check';
+
+async function format(rawHtml: string, url: string) {
+  const html = await scrubHtml({ html: rawHtml, url });
+  return await formatHtml(html);
+}
+
+export async function unifiedHtmlDiff(
+  old: { html: string; url: string } | Page,
+  current: { html: string; url: string } | Page,
+): Promise<string> {
+  if (isPage(old)) old = { html: await old.content(), url: old.url() };
+  if (isPage(current)) current = { html: await current.content(), url: current.url() };
+
+  const [a, b] = await Promise.all([format(old.html, old.url), format(current.html, current.url)]);
+
+  return Diff.createTwoFilesPatch('before.html', 'after.html', a, b);
+}

package/src/utils/date.ts

@@ -0,0 +1,40 @@
+import { getWeekNumber } from '@letsrunit/utils';
+
+export function formatDateForInput(date: Date, type: string | null): string {
+  const pad = (n: number) => String(n).padStart(2, '0');
+  const yyyy = date.getFullYear();
+  const mm = pad(date.getMonth() + 1);
+  const dd = pad(date.getDate());
+  const hh = pad(date.getHours());
+  const min = pad(date.getMinutes());
+
+  switch (type) {
+    case 'number':
+      return date.getTime().toString();
+    case 'datetime-local':
+      return `${yyyy}-${mm}-${dd}T${hh}:${min}`;
+    case 'month':
+      return `${yyyy}-${mm}`;
+    case 'week': {
+      const week = getWeekNumber(date);
+      return `${yyyy}-W${pad(week)}`;
+    }
+    case 'time':
+      return `${hh}:${min}`;
+    case 'date':
+    default:
+      return `${yyyy}-${mm}-${dd}`;
+  }
+}
+
+export function formatDate(d: Date, format: string): string {
+  const dd = String(d.getDate()).padStart(2, '0');
+  const mm = String(d.getMonth() + 1).padStart(2, '0');
+  const yyyy = String(d.getFullYear());
+  return format.replace('DD', dd).replace('MM', mm).replace('YYYY', yyyy);
+}
+
+export function getMonthNames(locale?: string): string[] {
+  const formatter = new Intl.DateTimeFormat(locale, { month: 'long' });
+  return Array.from({ length: 12 }, (_, i) => formatter.format(new Date(2000, i, 1)));
+}

package/src/utils/pick-field-element.ts

@@ -0,0 +1,48 @@
+import type { Locator } from '@playwright/test';
+
+export async function pickFieldElement(elements: Locator): Promise<Locator> {
+  const count = await elements.count();
+  if (count === 1) return elements;
+
+  const candidates: { el: Locator; tag: string; role: string | null; isVisible: boolean }[] = [];
+
+  for (let i = 0; i < count; i++) {
+    const el = elements.nth(i);
+    const [tag, role, isVisible] = await el.evaluate((e) => [
+      e.tagName.toLowerCase(),
+      e.getAttribute('role')?.toLowerCase() || null,
+      e.getAttribute('type') !== 'hidden' && e.getAttribute('aria-hidden') !== 'true',
+    ]);
+    candidates.push({ el, tag: tag as string, role: role as string | null, isVisible: isVisible as boolean });
+  }
+
+  // 1. If there is one of the elements is an input and the input is not hidden or has an aria indicating it is a (form) control, pick that element.
+  const formControls = ['input', 'textarea', 'select'];
+  const controlRoles = ['checkbox', 'radio', 'textbox', 'combobox', 'listbox', 'slider', 'spinbutton'];
+
+  const primary = candidates.filter(
+    (c) => (formControls.includes(c.tag) || (c.role && controlRoles.includes(c.role))) && c.isVisible,
+  );
+  if (primary.length === 1) return primary[0].el;
+
+  // 2. If one element has an aria role that might be logical for a form component (like a `group`), pick that element.
+  const groups = candidates.filter((c) => c.role === 'group');
+  if (groups.length === 1) return groups[0].el;
+
+  // 3. If one element contains the other element(s), pick the parent.
+  const isParent = await elements.evaluateAll((elems) => {
+    const results = elems.map((el, i) => {
+      const others = elems.filter((_, j) => i !== j);
+      return others.every((other) => el.contains(other));
+    });
+    const parentIndex = results.indexOf(true);
+    return parentIndex !== -1 ? parentIndex : null;
+  });
+
+  if (isParent !== null) {
+    return elements.nth(isParent);
+  }
+
+  // Return both elements and let the error (on evaluate) occur.
+  return elements;
+}

package/src/utils/type-check.ts

@@ -0,0 +1,7 @@
+import type { Page } from '@playwright/test';
+
+export function isPage(page: any): page is Page {
+  return typeof page.content === 'function'
+    && typeof page.url === 'function'
+    && typeof page.screenshot === 'function';
+}

package/src/wait.ts

@@ -0,0 +1,170 @@
+import { sleep } from '@letsrunit/utils';
+import type { Locator, Page } from '@playwright/test';
+
+export async function waitForIdle(page: Page, timeout = 2500) {
+  await page.waitForLoadState('domcontentloaded');
+  try {
+    await page.waitForLoadState('networkidle', { timeout });
+  } catch {}
+}
+
+export async function waitForMeta(page: Page, timeout = 2500) {
+  await waitForIdle(page);
+
+  page.getByRole('navigation');
+
+  await page
+    .waitForFunction(
+      () => {
+        const head = document.head;
+        if (!head) return false;
+
+        return Boolean(
+          document.title.trim() ||
+            head.querySelector('meta[property^="og:"]') ||
+            head.querySelector('meta[name^="twitter:"]') ||
+            head.querySelector('script[type="application/ld+json"]'),
+        );
+      },
+      { timeout },
+    )
+    .catch(() => {});
+}
+
+/** Wait until the DOM hasn't changed for `quiet` (default 500ms). */
+export async function waitForDomIdle(
+  page: Page,
+  { quiet = 500, timeout = 10_000 }: { quiet?: number; timeout?: number } = {},
+) {
+  await page.waitForFunction(
+    (q) =>
+      new Promise<boolean>((resolve) => {
+        let last = performance.now();
+
+        const obs = new MutationObserver(() => (last = performance.now()));
+        obs.observe(document, {
+          subtree: true,
+          childList: true,
+          attributes: true,
+          characterData: true,
+        });
+
+        const tick = () => {
+          if (performance.now() - last >= q) {
+            obs.disconnect();
+            resolve(true);
+            return;
+          }
+          requestAnimationFrame(tick);
+        };
+        tick();
+      }),
+    quiet,
+    { timeout },
+  );
+}
+
+// Wait until there are no running Web Animations on the calendar subtree.
+// This helps with libraries that slide months using WAAPI (common in React UI libs).
+export async function waitForAnimationsToFinish(root: Locator) {
+  await root.page().waitForFunction(
+    (el) => {
+      const animations = (el as HTMLElement).getAnimations?.({ subtree: true }) ?? [];
+      return animations.every((a) => a.playState !== 'running');
+    },
+    await root.elementHandle(),
+  );
+
+  await root.evaluate(() => new Promise<void>((r) => requestAnimationFrame(() => requestAnimationFrame(() => r()))));
+}
+
+export async function waitForUrlChange(page: Page, prevUrl: string, timeout: number) {
+  try {
+    await page.waitForFunction((u) => location.href !== u, prevUrl, { timeout });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export async function waitUntilEnabled(page: Page, target: Locator, timeout: number) {
+  // Poll for not disabled && aria-disabled != "true"
+  await target.waitFor({ state: 'attached', timeout }).catch(() => {});
+  const handle = await target.elementHandle().catch(() => null);
+  if (!handle) return;
+
+  await page
+    .waitForFunction(
+      (el) => {
+        if (!el || !(el as Element).isConnected) return true; // detached → treat as settled
+        const aria = (el as HTMLElement).getAttribute('aria-disabled');
+        const disabled =
+          (el as HTMLButtonElement).disabled ||
+          aria === 'true' ||
+          (el as HTMLElement).getAttribute('disabled') !== null;
+        return !disabled;
+      },
+      handle,
+      { timeout },
+    )
+    .catch(() => {});
+}
+
+export async function waitAfterInteraction(
+  page: Page,
+  target: Locator,
+  opts: { prevUrl?: string; navTimeout?: number; settleTimeout?: number; quietMs?: number } = {},
+) {
+  const navTimeout = opts.navTimeout ?? 8_000;
+  const settleTimeout = opts.settleTimeout ?? 6_000;
+  const quietMs = opts.quietMs ?? 500;
+
+  const prevUrl = opts.prevUrl ?? page.url();
+  const kind = await elementKind(target).catch(() => 'other');
+
+  if (kind === 'link') {
+    // SPA or full nav: wait for URL change; if it changed, wait for DOM to settle.
+    const urlChanged = await waitForUrlChange(page, prevUrl, navTimeout);
+    if (urlChanged) {
+      // Avoid 'networkidle' for SPAs with websockets/long-polling.
+      await page.waitForLoadState('domcontentloaded').catch(() => {});
+      await waitForDomIdle(page, { quiet: quietMs, timeout: navTimeout }).catch(() => {});
+      return;
+    }
+    // Link didn’t navigate (preventDefault, same hash, etc.) → fall back.
+    await waitForDomIdle(page, { quiet: quietMs }).catch(() => {});
+    return;
+  }
+
+  if (kind === 'button' && (await target.isDisabled())) {
+    // Buttons often disable during in-flight work, or disappear on success.
+    await Promise.race([
+      waitUntilEnabled(page, target, settleTimeout).catch(() => {}),
+      target.waitFor({ state: 'hidden', timeout: settleTimeout }).catch(() => {}),
+      target.waitFor({ state: 'detached', timeout: settleTimeout }).catch(() => {}),
+      waitForUrlChange(page, prevUrl, settleTimeout).catch(() => {}),
+    ]);
+    await sleep(1000); // Grace periode for redirect
+    await waitForDomIdle(page, { quiet: quietMs }).catch(() => {});
+    return;
+  }
+}
+
+/* ---------- helpers ---------- */
+
+async function elementKind(target: Locator): Promise<'link' | 'button' | 'other'> {
+  const role = await target.getAttribute('role').catch(() => null);
+  if (role === 'link') return 'link';
+  if (role === 'button') return 'button';
+
+  const tag = await target.evaluate((el) => el.tagName.toLowerCase()).catch(() => '');
+  if (tag === 'a') return 'link';
+
+  if (tag === 'button') return 'button';
+  if (tag === 'input') {
+    const type = await target.getAttribute('type').catch(() => null);
+    if (type === 'button' || type === 'submit' || type === 'reset') return 'button';
+  }
+
+  return 'other';
+}