simplycms 0.4.0

package/skills/redesign-from-reference/scripts/lib/browser-sample.mjs

@@ -0,0 +1,123 @@
+/**
+ * Функція семплінгу computed styles, що виконується В БРАУЗЕРІ (задача §2.A).
+ * Виокремлено з `sample.mjs` (Р2/канон ≤150 рядків): Playwright серіалізує
+ * лише `toString()` цієї функції в сторінковий контекст, тож вона
+ * САМОДОСТАТНЯ — жодних замикань на модульний скоуп (звідси копії констант
+ * замість імпортів). Node-обгортка (`samplePalette`, sanity-фільтр радіуса)
+ * лишається в `sample.mjs`.
+ */
+
+/** Виконується в браузері — свій скоуп, копії констант замість замикань. */
+export function browserSample(limit) {
+  const shadowTopN = 5; // копія — замикання на модульний скоуп тут недоступне
+
+  // Нормалізація CSS-кольору в `#rrggbb` КОЛІРНИМ РУШІЄМ БРАУЗЕРА, не
+  // регуляркою. 🔴 Регекс `rgba?()` мовчки губив КОЖЕН сучасний запис: Chrome
+  // віддає computed `color`/`background-color` у вихідному просторі —
+  // `lab()`, `oklab()`, `oklch()`, `color(display-p3 …)`, — а Tailwind v4
+  // (яким зроблено і сам SimplyCMS) генерує саме такі. На живому референсі це
+  // давало 5 кольорів замість справжньої палітри: домінантний текст
+  // `lab(2.75381 0 0)` (n=233, area 44.6M) зникав, «найчастішим» ставав білий
+  // n=19 — пропозиція виходила з foreground == background (контраст 1.00:1).
+  // Растеризація 1×1 віддає sRGB-байти, якими сторінка й малюється. Валідність
+  // — подвійний сентинел: невалідний рядок лишає `fillStyle` попереднім.
+  const toHex = (() => {
+    const canvas = document.createElement('canvas');
+    canvas.width = 1;
+    canvas.height = 1;
+    const ctx = canvas.getContext('2d', { willReadFrequently: true });
+    const cache = new Map(); // значення повторюються сотні разів — міряємо раз
+    const byte = (n) => n.toString(16).padStart(2, '0');
+    return (computed) => {
+      if (!computed || !ctx) return null;
+      if (cache.has(computed)) return cache.get(computed);
+      ctx.fillStyle = '#000000';
+      ctx.fillStyle = computed;
+      const fromBlack = ctx.fillStyle;
+      ctx.fillStyle = '#ffffff';
+      ctx.fillStyle = computed;
+      let hex = null;
+      if (fromBlack === ctx.fillStyle) {
+        ctx.clearRect(0, 0, 1, 1);
+        ctx.fillRect(0, 0, 1, 1);
+        const [r, g, b, a] = ctx.getImageData(0, 0, 1, 1).data;
+        if (a !== 0) hex = `#${byte(r)}${byte(g)}${byte(b)}`; // прозорий → null
+      }
+      cache.set(computed, hex);
+      return hex;
+    };
+  })();
+
+  function bumpColor(map, role, value, area, interactive) {
+    const key = `${role}:${value}`;
+    const e = map.get(key);
+    if (e) {
+      e.frequency += 1;
+      e.area += area;
+      if (interactive) e.interactive = true;
+    } else {
+      map.set(key, { value, role, frequency: 1, area, interactive });
+    }
+  }
+
+  const colors = new Map();
+  const radius = new Map();
+  const shadows = new Map();
+  const spacing = new Map();
+
+  const elements = [...document.querySelectorAll('body *')].slice(0, limit);
+
+  for (const el of elements) {
+    const style = getComputedStyle(el);
+    const rect = el.getBoundingClientRect();
+    const area = Math.round(rect.width * rect.height);
+    if (area <= 0) continue;
+
+    const interactive =
+      ['A', 'BUTTON', 'INPUT'].includes(el.tagName) ||
+      el.getAttribute('role') === 'button' ||
+      Boolean(el.closest('a,button,[role="button"]'));
+
+    const bg = toHex(style.backgroundColor);
+    if (bg) bumpColor(colors, 'background', bg, area, interactive);
+    const fg = toHex(style.color);
+    if (fg) bumpColor(colors, 'text', fg, area, interactive);
+    if (parseFloat(style.borderTopWidth) > 0) {
+      const border = toHex(style.borderTopColor);
+      if (border) bumpColor(colors, 'border', border, area, interactive);
+    }
+
+    const radiusPx = parseFloat(style.borderTopLeftRadius);
+    if (radiusPx > 0) {
+      const e = radius.get(radiusPx);
+      if (e) e.frequency += 1;
+      else radius.set(radiusPx, { valuePx: radiusPx, frequency: 1 });
+    }
+
+    if (style.boxShadow && style.boxShadow !== 'none') {
+      shadows.set(style.boxShadow, (shadows.get(style.boxShadow) ?? 0) + 1);
+    }
+
+    const marginPx = parseFloat(style.marginBottom);
+    if (marginPx > 0) spacing.set(marginPx, (spacing.get(marginPx) ?? 0) + 1);
+  }
+
+  const topShadows = [...shadows.entries()]
+    .sort((a, b) => b[1] - a[1])
+    .slice(0, shadowTopN)
+    .map(([value]) => value);
+
+  const fontStylesheets = [
+    ...document.querySelectorAll('link[rel="stylesheet"]'),
+  ].map((link) => link.href);
+
+  // `fonts` тут навмисно НЕМАЄ: голосування за сімʼї — окремий evaluate
+  // (`browser-fonts.mjs`, Р7), результати зшиває Node-обгортка `samplePalette`.
+  return {
+    colors: [...colors.values()],
+    radius: [...radius.values()],
+    shadows: topShadows,
+    spacing: [...spacing.keys()].sort((a, b) => a - b),
+    fontStylesheets,
+  };
+}

package/skills/redesign-from-reference/scripts/lib/browser.mjs

@@ -0,0 +1,145 @@
+/**
+ * Резолюція шляху до бінарника Chromium для запуску Playwright (задача §2.A,
+ * план Р2). Проблема: девдепс монорепо — `@playwright/test@1.61.1` —
+ * очікує Chromium rev 1228 (`chromium.executablePath()` показує саме цей
+ * шлях), а середовище має преінстальованим лише rev 1194
+ * (`PLAYWRIGHT_BROWSERS_PATH`), докачування недостатньої ревізії блокує
+ * проксі. Живим запуском доведено: 1.61.1 водить chromium-1194 через
+ * `launch({ executablePath })` — штатний шлях лише НЕ РЕЗОЛВИТЬСЯ САМ, сам
+ * бінарник сумісний. Тому хелпер спершу довіряє штатному шляху (якщо файл
+ * реально є на диску — майбутнє середовище з правильною ревізією теж
+ * спрацює без змін), інакше сканує `PLAYWRIGHT_BROWSERS_PATH` глобом
+ * `chromium-<rev> / chrome-linux<...> / chrome` (обидві розкладки Playwright:
+ * `chrome-linux/` до rev ~1200, `chrome-linux64/` у новіших). 🔴 Пробіли
+ * навколо `/` тут навмисні: зірочка впритул до слеша закриває цей JSDoc-
+ * коментар передчасно (перевірено `node --check`).
+ */
+import { existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+
+const CHROMIUM_DIR_RE = /^chromium-\d+$/;
+const CHROME_LINUX_DIR_RE = /^chrome-linux/;
+
+/** Безпечний `readdirSync` — відсутня/недоступна тека не валить сканування. */
+function listDirs(path) {
+  try {
+    return readdirSync(path, { withFileTypes: true })
+      .filter((entry) => entry.isDirectory())
+      .map((entry) => entry.name);
+  } catch {
+    return [];
+  }
+}
+
+/**
+ * Фолбек-скан `PLAYWRIGHT_BROWSERS_PATH`: перебирає теки `chromium-<rev>` за
+ * спаданням імені (найновіша ревізія першою — детермінізм при кількох
+ * закешованих ревізіях) і повертає перший знайдений `chrome`-бінарник.
+ */
+function scanBrowsersPath(browsersPath) {
+  if (!browsersPath) return null;
+
+  const chromiumDirs = listDirs(browsersPath)
+    .filter((name) => CHROMIUM_DIR_RE.test(name))
+    .sort()
+    .reverse();
+
+  for (const chromiumDir of chromiumDirs) {
+    const chromiumPath = join(browsersPath, chromiumDir);
+    const chromeLinuxDirs = listDirs(chromiumPath).filter((name) =>
+      CHROME_LINUX_DIR_RE.test(name),
+    );
+    for (const chromeLinuxDir of chromeLinuxDirs) {
+      const candidate = join(chromiumPath, chromeLinuxDir, 'chrome');
+      if (existsSync(candidate)) return candidate;
+    }
+  }
+  return null;
+}
+
+/**
+ * Резолвити launch-опції Chromium для playwright-модуля (`chromium` з
+ * `@playwright/test` або `playwright`). Кидає з ТОЧНОЮ командою установки,
+ * якщо бінарника не знайдено жодним зі шляхів.
+ * @param {{ executablePath(): string }} chromium
+ * @returns {{ executablePath: string }}
+ */
+export function resolveChromium(chromium) {
+  const declared = chromium.executablePath();
+  if (declared && existsSync(declared)) {
+    return { executablePath: declared };
+  }
+
+  const fallback = scanBrowsersPath(process.env.PLAYWRIGHT_BROWSERS_PATH);
+  if (fallback) return { executablePath: fallback };
+
+  throw new Error(
+    'Chromium не знайдено (ні штатний шлях playwright, ні фолбек-скан ' +
+      'PLAYWRIGHT_BROWSERS_PATH).\n' +
+      '  💡 pnpm add -D playwright && pnpm exec playwright install chromium',
+  );
+}
+
+/**
+ * Резолв playwright-модуля: спершу devDep-монорепо (`@playwright/test`),
+ * потім bare `playwright` (план Р4 — спільний канал для `inspect.mjs` і
+ * `discover.mjs`: обидва CLI мають падати однаково, якщо пакета немає).
+ */
+export async function loadChromium() {
+  for (const specifier of ['@playwright/test', 'playwright']) {
+    try {
+      return (await import(specifier)).chromium;
+    } catch {
+      // Пакета немає — пробуємо наступний, повідомлення нижче.
+    }
+  }
+  console.error(
+    '❌ Playwright не знайдено.\n  💡 pnpm add -D playwright && pnpm exec playwright install chromium',
+  );
+  process.exit(1);
+}
+
+/** Пауза між кроками скролу (мс) — дає лінивим секціям час змонтуватись. */
+export const SCROLL_STEP_MS = 400;
+/** Ліміт ітерацій скролу — запобіжник проти нескінченного `scrollHeight`. */
+export const SCROLL_MAX_ITERATIONS = 30;
+/** Settle-пауза після повернення на верх сторінки (мс). */
+export const SCROLL_SETTLE_MS = 500;
+
+/**
+ * Прокрутити сторінку до низу кроками ~viewport, даючи час IntersectionObserver-
+ * секціям змонтуватись/проявитись (задача §2.A.1, план Р1). Стабілізація —
+ * низ досягнуто І `scrollHeight` не змінився ДВІЧІ ПОСПІЛЬ (одного разу
+ * недостатньо: секція саме на межі низу могла ще не встигнути домонтуватись
+ * до наступного кадру). Наприкінці — повернення на 0 і settle-пауза, щоб
+ * скріншот/семпл читали вже стабільний верх сторінки. Reverse-анімації
+ * (щось ховається назад при скролі вгору) — межа v1, не покриваємо.
+ * @param {import('@playwright/test').Page} page
+ */
+export async function scrollThrough(page) {
+  let previousHeight = -1;
+  let stableHits = 0;
+  for (let i = 0; i < SCROLL_MAX_ITERATIONS; i++) {
+    const { scrollHeight, viewportHeight } = await page.evaluate(() => ({
+      scrollHeight: document.documentElement.scrollHeight,
+      viewportHeight: window.innerHeight,
+    }));
+    await page.evaluate((step) => window.scrollBy(0, step), viewportHeight);
+    await page.waitForTimeout(SCROLL_STEP_MS);
+
+    const atBottom = await page.evaluate(
+      () =>
+        window.scrollY + window.innerHeight >=
+        document.documentElement.scrollHeight - 1,
+    );
+    if (atBottom && scrollHeight === previousHeight) {
+      stableHits += 1;
+      if (stableHits >= 2) break;
+    } else {
+      stableHits = 0;
+    }
+    previousHeight = scrollHeight;
+  }
+  await page.evaluate(() => window.scrollTo(0, 0));
+  await page.waitForTimeout(SCROLL_SETTLE_MS);
+}

package/skills/redesign-from-reference/scripts/lib/classify-pairs.mjs

@@ -0,0 +1,88 @@
+/**
+ * Збірка й ранжування пар (тип, url) для `classify.mjs` (інкремент Б.3,
+ * Фаза 2). Винесено з `classify.mjs` тоді, коли до двох джерел evidence
+ * (URL-патерн, якір) додалось третє — структурний fan-out: канон 150 рядків
+ * не дозволяє тримати в одному файлі і збірку пар, і жадібний вибір.
+ *
+ * Шкала (Р1, незмінна): кожен сигнал +2, `score = evidence.length * 2`,
+ * поріг ≥2 — один сигнал сам закриває тип. Сортування — стабільне:
+ * score↓ → type-aware глибина `depthKey` → лексикографічно за pathname.
+ */
+import {
+  matchAnchorTerm,
+  matchUrlPattern,
+  URL_PATTERNS,
+} from './classify-terms.mjs';
+import { structuralEvidence } from './classify-structure.mjs';
+
+/** Типи, які добираються скорингом (`home` має окреме правило в `classify.mjs`). */
+export const OTHER_TYPES = Object.keys(URL_PATTERNS);
+
+/**
+ * Type-aware компонент довжини для тайбрейка при рівному балі (Р2, Б.3):
+ * картка товару має slug, тож для `product` виграє ГЛИБШИЙ pathname, для решти
+ * типів — коротший, як було. 🔴 Це ключ ОДНОГО елемента, а не попарна умова
+ * «якщо обидва product»: попарна версія не транзитивна (дає цикл A<B<C<A), і
+ * поведінка `Array#sort` на ній стає невизначеною. Наслідок, який і лагодить
+ * кейс deo: при рівному балі product-пари йдуть ПЕРЕД усіма іншими (відʼємний
+ * ключ < додатного), а між собою — глибша першою; тому картка
+ * `/product/<slug>` закриває тип `product` РАНІШЕ, ніж розглядається мілкий
+ * `/product`, і той дістається listing.
+ * @param {{type: string, pathname: string}} pair
+ */
+function depthKey(pair) {
+  return pair.type === 'product' ? -pair.pathname.length : pair.pathname.length;
+}
+
+/**
+ * Усі пари (тип, url) з ненульовим score, відсортовані за пріоритетом вибору.
+ * @param {Map<string, { url: string, anchors: Set<string> }>} candidates
+ * @param {Map<string, { listing?: true, product?: true, childCount: number }>} structure
+ *   результат `analyzeStructure` — третє джерело evidence
+ * @param {Set<string>} closedPathnames pathname-и, уже зайняті іншим типом
+ * @param {Map<string, Set<string>>} [blockedPairs] pathname → типи, яким саме
+ *   ЦЯ сторінка вже доведено не підходить (контент-проб візиту відхилив пару).
+ *   🔴 Блокується пара, а не сторінка: «це не картка товару, а сітка» —
+ *   позитивний доказ на користь `listing`, і викидати сторінку цілком означало б
+ *   знищити доказ разом із помилкою.
+ * @returns {Array<{ type: string, pathname: string, url: string, score: number, evidence: object[] }>}
+ */
+export function rankedPairs(
+  candidates,
+  structure,
+  closedPathnames,
+  blockedPairs,
+) {
+  const pairs = [];
+  for (const [pathname, candidate] of candidates) {
+    if (closedPathnames.has(pathname)) continue;
+    const blocked = blockedPairs?.get(pathname);
+    for (const type of OTHER_TYPES) {
+      if (blocked?.has(type)) continue;
+      const urlMatch = matchUrlPattern(type, pathname);
+      const anchorMatch = matchAnchorTerm(type, candidate.anchors);
+      const evidence = [
+        urlMatch && { urlPattern: urlMatch, source: 'url' },
+        anchorMatch && { anchorMatch, source: 'anchor' },
+        structuralEvidence(structure.get(pathname), type),
+      ].filter(Boolean);
+      if (evidence.length > 0) {
+        pairs.push({
+          type,
+          pathname,
+          url: candidate.url,
+          score: evidence.length * 2,
+          evidence,
+        });
+      }
+    }
+  }
+
+  pairs.sort(
+    (a, b) =>
+      b.score - a.score ||
+      depthKey(a) - depthKey(b) ||
+      a.pathname.localeCompare(b.pathname),
+  );
+  return pairs;
+}

package/skills/redesign-from-reference/scripts/lib/classify-structure.mjs

@@ -0,0 +1,109 @@
+/**
+ * Структурний сигнал fan-out для класифікатора (інкремент Б.3, блок A.3,
+ * план Р3). Чистий модуль: ні браузера, ні IO — лише форма мапи кандидатів,
+ * яку вже побудував `classify.mjs`. Винесено окремо саме тому, що канон
+ * 150 рядків не дозволяє й далі роздувати `classify.mjs`.
+ *
+ * Ідея: словник знає слова, структура знає форму сайту. Кандидат-префікс,
+ * під яким лежать ≥3 інших кандидати, поводиться як індекс колекції; його
+ * бездітні прямі діти — як картки. Це рятує сайти з нейтральними або
+ * нестандартними сегментами, де словник мовчить.
+ *
+ * 🔴 Рахуються ПРЯМІ діти, не всі нащадки: дитина — це pathname, чий
+ * батьківський префікс (усе до останнього `/`) дорівнює префіксу. Тому
+ * `/shop/men/shirt` дитиною `/shop` НЕ вважається — він дитина `/shop/men`.
+ *
+ * 🔴 Корінь `/` виключено: інакше «дітьми кореня» була б уся мапа сайту і
+ * fan-out спрацьовував би завжди.
+ *
+ * 🔴 Відома межа сигналу (не ховаємо): структура НЕ відрізняє каталог від
+ * будь-якого іншого великого індексу — `/blog` із 12 постами виглядає точно
+ * так само, як `/shop` із 12 товарами, і так само забере `listing`.
+ * Захист від цього — не евристика, а обовʼязковий діалог фази 1.2 скіла, де
+ * запропоновані типи підтверджує людина. Сигнал дає гіпотезу, не вирок.
+ */
+
+/**
+ * Мінімум прямих дітей-кандидатів, з якого префікс вважається індексом
+ * колекції. Три — бо це найменше число, що вже не пояснюється типовою
+ * службовою парою («/legal/terms» + «/legal/privacy», «/help/faq» +
+ * «/help/shipping»): такі кущі майже завжди дво-елементні, а вітрина
+ * категорії з двома товарами практично не трапляється. Поріг свідомо
+ * консервативний — краще пропустити сигнал, ніж вигадати каталог.
+ */
+export const FANOUT_MIN_CHILDREN = 3;
+
+/**
+ * Батьківський префікс pathname — усе до останнього `/`.
+ * @param {string} pathname нормалізований pathname (без trailing slash)
+ * @returns {string | null} `null` для сегмента першого рівня (його батько —
+ *   корінь `/`, який із розгляду виключено)
+ */
+function parentPrefix(pathname) {
+  const cut = pathname.lastIndexOf('/');
+  return cut <= 0 ? null : pathname.slice(0, cut);
+}
+
+/**
+ * Структурний розбір набору кандидатів.
+ * @param {Map<string, { url: string, anchors: Set<string> }>} candidates мапа
+ *   кандидатів `classify.mjs`; використовуються лише ключі (pathname)
+ * @returns {Map<string, { listing?: true, product?: true, childCount: number }>}
+ *   запис на кожен pathname, крім кореня; `childCount` — кількість ПРЯМИХ
+ *   дітей-кандидатів. Порядок ключів — лексикографічний за pathname
+ *   (детермінізм: жодної залежності від порядку вставки у вхідній мапі).
+ */
+export function analyzeStructure(candidates) {
+  const pathnames = [...candidates.keys()].filter((p) => p !== '/').sort();
+
+  const childCounts = new Map(pathnames.map((p) => [p, 0]));
+  const parents = new Map();
+  for (const pathname of pathnames) {
+    const parent = parentPrefix(pathname);
+    parents.set(pathname, parent);
+    // Батько рахує дитину, лише якщо сам є кандидатом: префікс, якого серед
+    // зібраних лінків немає, сторінкою може й не бути.
+    if (parent !== null && childCounts.has(parent))
+      childCounts.set(parent, childCounts.get(parent) + 1);
+  }
+
+  const result = new Map();
+  for (const pathname of pathnames) {
+    const childCount = childCounts.get(pathname);
+    const parent = parents.get(pathname);
+    const parentFanout = parent !== null ? (childCounts.get(parent) ?? 0) : 0;
+    const entry = {};
+    if (childCount >= FANOUT_MIN_CHILDREN) entry.listing = true;
+    // Лист = кандидат без власних дітей ПІД fan-out-префіксом.
+    if (childCount === 0 && parentFanout >= FANOUT_MIN_CHILDREN)
+      entry.product = true;
+    entry.childCount = childCount;
+    result.set(pathname, entry);
+  }
+  return result;
+}
+
+/**
+ * Запис evidence зі структурного сигналу — по одному на тип (Р1: форма
+ * evidence не змінюється, це ДОДАТКОВИЙ запис вагою +2, як і решта).
+ *
+ * 🔴 Для листа `count` НЕ віддаємо навмисно: власних дітей у листа рівно
+ * нуль за визначенням, а інформативне число (розмір кущa) належить його
+ * батькові й у запис форми Р3 не входить. Порожнє поле чесніше за `count: 0`.
+ *
+ * @param {{ listing?: true, product?: true, childCount: number } | undefined} entry
+ * @param {string} type канонічний тип сторінки
+ * @returns {{ structural: string, count?: number, source: 'structure' } | null}
+ */
+export function structuralEvidence(entry, type) {
+  if (!entry) return null;
+  if (type === 'listing' && entry.listing)
+    return {
+      structural: 'prefix-fanout',
+      count: entry.childCount,
+      source: 'structure',
+    };
+  if (type === 'product' && entry.product)
+    return { structural: 'fanout-leaf', source: 'structure' };
+  return null;
+}

package/skills/redesign-from-reference/scripts/lib/classify-terms.mjs

@@ -0,0 +1,126 @@
+/**
+ * Словники класифікатора `classify.mjs` (задача §2.C.2, план Р3; розширення —
+ * інкремент Б.3, блок A.1): URL-патерни і тексти якорів за типом сторінки,
+ * англ + укр + рос (транслітерація в шляхах, кирилиця в текстах — кириличні
+ * pathname на реальних сайтах рідкісні, Р3).
+ * Винесено окремо, щоб `classify.mjs` лишався ≤150 рядків (канон файлу).
+ *
+ * 🔴 `pathname` сюди приходить уже нормалізованим (`normalizePathname` у
+ * `classify.mjs`): без query/hash і без trailing slash — тому «кінець шляху»
+ * в патернах позначається просто `$`.
+ */
+
+/** URL-патерни за типом (англ + транслітерація укр слів у шляхах). */
+export const URL_PATTERNS = {
+  listing: [
+    /\/(shop|store|catalog|collections?)(\/|$)/i,
+    // `catalogue` — британське написання (Shopify/BigCommerce-теми, UK-магазини);
+    // наявний `catalog` вимагає далі `/` або кінець, тож `/catalogue` повз нього.
+    /\/catalogue(\/|$)/i,
+    // `category|categories` — сегмент таксономії каталогу в Magento, PrestaShop,
+    // OpenCart і більшості headless-шаблонів.
+    /\/categor(y|ies)(\/|$)/i,
+    // `product-category` — канонічний префікс таксономії WooCommerce.
+    /\/product-category(\/|$)/i,
+    // Bare-форми конфліктних сегментів БЕЗ сегмента-дитини — індекс колекції
+    // (Next.js-шаблони комерції, WooCommerce-конфігурації з `/product` як
+    // коренем каталогу). Дзеркало product-патерну, який дитину ВИМАГАЄ.
+    /\/(products?|items?|tovary?)$/i,
+    /\/(katalog|magazin)(\/|$)/i,
+  ],
+  product: [
+    /\/(products?|items?)\/[^/]+/i,
+    /\/tovary?\/[^/]+/i,
+    // `product-page/<slug>` — дефолтний роут картки товару у Wix Stores.
+    /\/product-page\/[^/]+/i,
+    // `/p/<slug>` — картка у Squarespace Commerce і низці headless-шаблонів.
+    /\/p\/[^/]+/i,
+    // `<slug>/p` — термінальний маркер картки у VTEX IO. 🔴 Звужено після
+    // ревʼю Б.3: перед `/p` вимагається багатослівний (дефісний) слаг, інакше
+    // патерн зʼїдав службові `/help/p`, `/shop/p`. Односегментний слаг
+    // (`/ravioli/p`) свідомо не ловиться — його добирають fanout-leaf і якорі.
+    /\/[\w-]+-[\w-]+\/p$/i,
+    // Сімʼя літерних маркерів `p<id>` окремим токеном сегмента — Rozetka,
+    // Ecwid, Prom-legacy (`/p123456-slug`, `/nazva-tovaru-p123`). Межі токена
+    // (початок, `/` або `-`) не дають ловити довільні слова з `p` усередині.
+    // 🔴 Дзеркальну сімʼю `c<id>` як категорію НЕ вводимо: на Prom.ua це
+    // профіль продавця, а не каталог.
+    /(^|\/|-)p\d+(-|$)/i,
+  ],
+  cart: [/\/(cart|basket|bag)(\/|$)/i, /\/korzyna(\/|$)/i],
+  checkout: [/\/checkout(\/|$)/i, /\/(oformlennya|zamovlennya|oplata)(\/|$)/i],
+  contact: [/\/contacts?(-us)?(\/|$)/i, /\/kontakty(\/|$)/i],
+  about: [/\/about/i, /\/pro-nas/i],
+};
+
+/** Тексти якорів за типом (англ + укр + рос); зіставляються цілими словами/фразами. */
+export const ANCHOR_TERMS = {
+  listing: [
+    'shop',
+    'store',
+    'products',
+    'catalog',
+    'catalogue',
+    'collections',
+    // Типові написи навігації на індекс каталогу (Shopify/Woo/BigCommerce-теми).
+    'categories',
+    // Однина — для симетрії з `categories`: безпечна, бо самостійним написом
+    // нав-лінка «Category» позначають саме індекс категорій, а не картку.
+    'category',
+    'browse',
+    'all products',
+    'shop all',
+    // укр
+    'каталог',
+    'магазин',
+    'товари',
+    'категорії',
+    'асортимент',
+    'продукція',
+    'крамниця',
+    // рос (`каталог`/`магазин` збігаються з укр — вище, не дублюємо)
+    'категории',
+    'ассортимент',
+    'товары',
+  ],
+  product: ['product', 'товар'],
+  cart: ['cart', 'basket', 'bag', 'кошик', 'корзина'],
+  checkout: [
+    'checkout',
+    'place order',
+    'оформити замовлення',
+    'оформлення',
+    'оплата',
+  ],
+  contact: ['contact', 'contact us', 'контакти'],
+  about: ['about', 'about us', 'про нас', 'про компанію'],
+};
+
+/** Перший URL-патерн типу, що збігся з `pathname` — джерело `evidence.urlPattern`. */
+export function matchUrlPattern(type, pathname) {
+  for (const pattern of URL_PATTERNS[type]) {
+    if (pattern.test(pathname)) return pattern.source;
+  }
+  return null;
+}
+
+/** Текст → пробільно-обгорнутий рядок без пунктуації — для пошуку цілих слів/фраз. */
+function normalizeText(text) {
+  const words = text
+    .toLowerCase()
+    .replace(/[^a-zа-яіїєґ0-9\s]/gi, ' ')
+    .trim()
+    .replace(/\s+/g, ' ');
+  return ` ${words} `;
+}
+
+/** Перший якірний текст типу, де знайдено цілий термін зі словника — `evidence.anchorMatch`. */
+export function matchAnchorTerm(type, anchors) {
+  for (const anchor of anchors) {
+    const normalized = normalizeText(anchor);
+    for (const term of ANCHOR_TERMS[type]) {
+      if (normalized.includes(` ${term} `)) return anchor;
+    }
+  }
+  return null;
+}