@decocms/parity 0.33.60 → 0.33.62
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cli.js +448 -89
- package/package.json +1 -1
package/dist/cli.js
CHANGED
|
@@ -46644,6 +46644,24 @@ function median(values) {
|
|
|
46644
46644
|
const mid = Math.floor(clean.length / 2);
|
|
46645
46645
|
return clean.length % 2 ? clean[mid] : (clean[mid - 1] + clean[mid]) / 2;
|
|
46646
46646
|
}
|
|
46647
|
+
function spreadOf(values) {
|
|
46648
|
+
const clean = values.filter((v) => Number.isFinite(v));
|
|
46649
|
+
if (clean.length === 0)
|
|
46650
|
+
return;
|
|
46651
|
+
return { minMs: Math.min(...clean), maxMs: Math.max(...clean), samples: clean.length };
|
|
46652
|
+
}
|
|
46653
|
+
function noiseWarning(prod, cand) {
|
|
46654
|
+
if (!prod?.ok || !cand?.ok || !prod.spread || !cand.spread)
|
|
46655
|
+
return null;
|
|
46656
|
+
if (prod.spread.samples < 2 || cand.spread.samples < 2)
|
|
46657
|
+
return null;
|
|
46658
|
+
const prodNoise = prod.spread.maxMs - prod.spread.minMs;
|
|
46659
|
+
const candNoise = cand.spread.maxMs - cand.spread.minMs;
|
|
46660
|
+
const deltaMs = Math.abs(cand.ms - prod.ms);
|
|
46661
|
+
const side = prodNoise >= candNoise ? "prod" : "cand";
|
|
46662
|
+
const noiseMs = Math.max(prodNoise, candNoise);
|
|
46663
|
+
return deltaMs <= noiseMs ? { side, noiseMs, deltaMs } : null;
|
|
46664
|
+
}
|
|
46647
46665
|
function cssAttrEscape(s) {
|
|
46648
46666
|
return s.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
|
|
46649
46667
|
}
|
|
@@ -46653,6 +46671,66 @@ async function waitReady(page, cap = READY_CAP_MS) {
|
|
|
46653
46671
|
await page.waitForTimeout(400);
|
|
46654
46672
|
return loaded && idled;
|
|
46655
46673
|
}
|
|
46674
|
+
function isContentReady(s, before) {
|
|
46675
|
+
if (!s.mainVisible || s.busy)
|
|
46676
|
+
return false;
|
|
46677
|
+
if (before !== undefined && s.signature === before)
|
|
46678
|
+
return false;
|
|
46679
|
+
if (s.heroImage === null)
|
|
46680
|
+
return s.textChars >= 20;
|
|
46681
|
+
return s.heroImage.loaded;
|
|
46682
|
+
}
|
|
46683
|
+
async function readContentSnapshot(page) {
|
|
46684
|
+
return page.evaluate(() => {
|
|
46685
|
+
const vh = window.innerHeight;
|
|
46686
|
+
const shown = (el) => {
|
|
46687
|
+
const r = el.getBoundingClientRect();
|
|
46688
|
+
if (r.width <= 0 || r.height <= 0 || r.bottom <= 0 || r.top >= vh)
|
|
46689
|
+
return false;
|
|
46690
|
+
const cs = getComputedStyle(el);
|
|
46691
|
+
return cs.visibility !== "hidden" && cs.display !== "none" && cs.opacity !== "0";
|
|
46692
|
+
};
|
|
46693
|
+
const root = Array.from(document.querySelectorAll("main, [role='main']")).find(shown) ?? document.body;
|
|
46694
|
+
const text = root.innerText ?? "";
|
|
46695
|
+
let hash = 5381;
|
|
46696
|
+
for (let i = 0;i < text.length; i++)
|
|
46697
|
+
hash = (hash << 5) + hash + text.charCodeAt(i) | 0;
|
|
46698
|
+
let hero = null;
|
|
46699
|
+
let heroArea = 0;
|
|
46700
|
+
for (const im of Array.from(root.querySelectorAll("img"))) {
|
|
46701
|
+
const r = im.getBoundingClientRect();
|
|
46702
|
+
if (r.width < 120 || r.height < 120 || !shown(im))
|
|
46703
|
+
continue;
|
|
46704
|
+
if (r.width * r.height > heroArea) {
|
|
46705
|
+
hero = im;
|
|
46706
|
+
heroArea = r.width * r.height;
|
|
46707
|
+
}
|
|
46708
|
+
}
|
|
46709
|
+
const busy = Array.from(document.querySelectorAll("[aria-busy='true'], [role='progressbar']:not([aria-valuenow]), [class*='spinner' i], [class*='skeleton' i]")).some(shown);
|
|
46710
|
+
return {
|
|
46711
|
+
mainVisible: !!root && shown(root),
|
|
46712
|
+
textChars: text.trim().length,
|
|
46713
|
+
heroImage: hero ? { loaded: hero.complete && hero.naturalWidth > 0 } : null,
|
|
46714
|
+
busy,
|
|
46715
|
+
signature: `${text.length}:${hash}`
|
|
46716
|
+
};
|
|
46717
|
+
});
|
|
46718
|
+
}
|
|
46719
|
+
async function contentSignature(page) {
|
|
46720
|
+
return readContentSnapshot(page).then((s) => s.signature).catch(() => {
|
|
46721
|
+
return;
|
|
46722
|
+
});
|
|
46723
|
+
}
|
|
46724
|
+
async function waitContentReady(page, before, cap = READY_CAP_MS) {
|
|
46725
|
+
const deadline = Date.now() + cap;
|
|
46726
|
+
while (Date.now() < deadline) {
|
|
46727
|
+
const s = await readContentSnapshot(page).catch(() => null);
|
|
46728
|
+
if (s && isContentReady(s, before))
|
|
46729
|
+
return true;
|
|
46730
|
+
await page.waitForTimeout(50);
|
|
46731
|
+
}
|
|
46732
|
+
return false;
|
|
46733
|
+
}
|
|
46656
46734
|
async function waitForProductImage(page, capMs = 8000) {
|
|
46657
46735
|
return page.waitForFunction(() => {
|
|
46658
46736
|
for (const el of Array.from(document.querySelectorAll("img"))) {
|
|
@@ -46678,7 +46756,7 @@ async function waitForCardGrowth(page, before, capMs) {
|
|
|
46678
46756
|
}
|
|
46679
46757
|
return cur;
|
|
46680
46758
|
}
|
|
46681
|
-
async function navigateWithHover(page, targetUrl,
|
|
46759
|
+
async function navigateWithHover(page, targetUrl, ready = "load") {
|
|
46682
46760
|
const targetPath = new URL(targetUrl).pathname;
|
|
46683
46761
|
const sel = `a[href="${cssAttrEscape(targetUrl)}"], a[href="${cssAttrEscape(targetPath)}"], a[href^="${cssAttrEscape(`${targetPath}?`)}"]`;
|
|
46684
46762
|
const anchor = page.locator(sel).first();
|
|
@@ -46686,6 +46764,7 @@ async function navigateWithHover(page, targetUrl, productImage = false) {
|
|
|
46686
46764
|
return;
|
|
46687
46765
|
});
|
|
46688
46766
|
const visible = await anchor.isVisible({ timeout: 1500 }).catch(() => false);
|
|
46767
|
+
const before = ready === "content" ? await contentSignature(page) : undefined;
|
|
46689
46768
|
let t;
|
|
46690
46769
|
let viaFallback = false;
|
|
46691
46770
|
let prefetched;
|
|
@@ -46729,9 +46808,11 @@ async function navigateWithHover(page, targetUrl, productImage = false) {
|
|
|
46729
46808
|
});
|
|
46730
46809
|
}
|
|
46731
46810
|
let ok;
|
|
46732
|
-
if (
|
|
46811
|
+
if (ready === "product") {
|
|
46733
46812
|
await withCap(page.waitForLoadState("domcontentloaded"), 5000, undefined);
|
|
46734
46813
|
ok = await waitForProductImage(page);
|
|
46814
|
+
} else if (ready === "content") {
|
|
46815
|
+
ok = await waitContentReady(page, before);
|
|
46735
46816
|
} else {
|
|
46736
46817
|
ok = await waitReady(page);
|
|
46737
46818
|
}
|
|
@@ -46963,7 +47044,7 @@ async function clickShelfProduct(page, ctx) {
|
|
|
46963
47044
|
});
|
|
46964
47045
|
if (!target)
|
|
46965
47046
|
return null;
|
|
46966
|
-
const nav = await navigateWithHover(page, target.href,
|
|
47047
|
+
const nav = await navigateWithHover(page, target.href, "product");
|
|
46967
47048
|
const now = (() => {
|
|
46968
47049
|
try {
|
|
46969
47050
|
return new URL(page.url()).pathname;
|
|
@@ -46979,7 +47060,7 @@ async function clickShelfProduct(page, ctx) {
|
|
|
46979
47060
|
prefetched: nav.prefetched
|
|
46980
47061
|
} : null;
|
|
46981
47062
|
}
|
|
46982
|
-
async function onePass(page, ctx, targets, paginations, measure) {
|
|
47063
|
+
async function onePass(page, ctx, targets, paginations, measure, paginationCapMs = 5000) {
|
|
46983
47064
|
const shot = async (label, fullPage) => {
|
|
46984
47065
|
if (!measure)
|
|
46985
47066
|
return "";
|
|
@@ -47035,7 +47116,7 @@ async function onePass(page, ctx, targets, paginations, measure) {
|
|
|
47035
47116
|
await page.evaluate(() => window.scrollTo(0, document.documentElement.scrollHeight)).catch(() => {
|
|
47036
47117
|
return;
|
|
47037
47118
|
});
|
|
47038
|
-
const after = await waitForCardGrowth(page, before,
|
|
47119
|
+
const after = await waitForCardGrowth(page, before, paginationCapMs);
|
|
47039
47120
|
if (after <= before) {
|
|
47040
47121
|
pagination.push({
|
|
47041
47122
|
step: `pagination-${i + 1}`,
|
|
@@ -47069,10 +47150,10 @@ async function onePass(page, ctx, targets, paginations, measure) {
|
|
|
47069
47150
|
await scrollToTop(page);
|
|
47070
47151
|
const productPath = new URL(targets.product).pathname;
|
|
47071
47152
|
const reachedPdp = () => page.url().includes(productPath);
|
|
47072
|
-
let pdpNav = await navigateWithHover(page, targets.product,
|
|
47153
|
+
let pdpNav = await navigateWithHover(page, targets.product, "product");
|
|
47073
47154
|
if (!reachedPdp() || !pdpNav.ok) {
|
|
47074
47155
|
await page.waitForTimeout(500);
|
|
47075
|
-
pdpNav = await navigateWithHover(page, targets.product,
|
|
47156
|
+
pdpNav = await navigateWithHover(page, targets.product, "product");
|
|
47076
47157
|
}
|
|
47077
47158
|
await dismissAll(page, ctx);
|
|
47078
47159
|
const pdpBroken = await pageLooksBroken(page);
|
|
@@ -47580,12 +47661,12 @@ async function runSideBenchmark(opts) {
|
|
|
47580
47661
|
if (targets) {
|
|
47581
47662
|
for (let r = 0;r < opts.warmupRuns; r++) {
|
|
47582
47663
|
emit(`[${opts.viewport}/${opts.side}] aquecendo (borda + navegador) — passe ${r + 1}/${opts.warmupRuns}`);
|
|
47583
|
-
await onePass(page, flowCtx, targets, opts.paginations, false);
|
|
47664
|
+
await onePass(page, flowCtx, targets, opts.paginations, false, opts.paginationCapMs);
|
|
47584
47665
|
}
|
|
47585
47666
|
const runs = Math.max(1, opts.measuredRuns);
|
|
47586
47667
|
for (let r = 0;r < runs; r++) {
|
|
47587
47668
|
emit(`[${opts.viewport}/${opts.side}] medindo navegação — passe ${r + 1}/${runs}`);
|
|
47588
|
-
const res = await onePass(page, flowCtx, targets, opts.paginations, true);
|
|
47669
|
+
const res = await onePass(page, flowCtx, targets, opts.paginations, true, opts.paginationCapMs);
|
|
47589
47670
|
measured.push(res);
|
|
47590
47671
|
Object.assign(screenshots, res.screenshots);
|
|
47591
47672
|
}
|
|
@@ -47649,6 +47730,7 @@ function aggregatePhase(step, samples) {
|
|
|
47649
47730
|
return {
|
|
47650
47731
|
step,
|
|
47651
47732
|
ms: median(samples.map((s) => s.ms)),
|
|
47733
|
+
spread: spreadOf(samples.map((s) => s.ms)),
|
|
47652
47734
|
url: samples[0]?.url,
|
|
47653
47735
|
ok: samples.length > 0 && samples.every((s) => s.ok),
|
|
47654
47736
|
note: (samples.find((s) => !s.ok) ?? samples.find((s) => s.note))?.note,
|
|
@@ -47662,6 +47744,7 @@ function aggregatePaginationTotal(measured) {
|
|
|
47662
47744
|
return {
|
|
47663
47745
|
step: "pagination",
|
|
47664
47746
|
ms: median(perPass),
|
|
47747
|
+
spread: spreadOf(perPass),
|
|
47665
47748
|
ok: measured.length > 0 && measured.every((m) => m.pagination.every((p) => p.ok)),
|
|
47666
47749
|
note: `${measured[0]?.pagination.length ?? 0} scroll(s)`
|
|
47667
47750
|
};
|
|
@@ -47674,6 +47757,7 @@ function aggregatePaginationSteps(measured) {
|
|
|
47674
47757
|
out.push({
|
|
47675
47758
|
step: `pagination-${i + 1}`,
|
|
47676
47759
|
ms: median(atI.map((p) => p.ms)),
|
|
47760
|
+
spread: spreadOf(atI.map((p) => p.ms)),
|
|
47677
47761
|
ok: atI.length > 0 && atI.every((p) => p.ok),
|
|
47678
47762
|
note: (atI.find((p) => !p.ok) ?? atI[atI.length - 1])?.note
|
|
47679
47763
|
});
|
|
@@ -47744,7 +47828,7 @@ async function resolveContentPaths(opts) {
|
|
|
47744
47828
|
await dismissAll(page, flow);
|
|
47745
47829
|
const brand = await captureBrand(page);
|
|
47746
47830
|
const hrefs = await page.evaluate(() => Array.from(document.querySelectorAll("header a[href], nav a[href], a[href]")).filter((a) => !a.parentElement?.querySelector(":scope > ul, :scope > [class*='dropdown']:not(a), :scope > [class*='submenu']:not(a)")).map((a) => a.getAttribute("href")).filter((h) => !!h)).catch(() => []);
|
|
47747
|
-
const candidates = filterContentPaths(hrefs, opts.prodBase);
|
|
47831
|
+
const candidates = filterContentPaths(opts.pages?.length ? opts.pages : hrefs, opts.prodBase);
|
|
47748
47832
|
const ok = [];
|
|
47749
47833
|
for (const path of candidates) {
|
|
47750
47834
|
if (ok.length >= 2)
|
|
@@ -47811,14 +47895,14 @@ async function onePassContent(page, ctx, paths, measure) {
|
|
|
47811
47895
|
await page.goto(ctx.baseUrl, { waitUntil: "domcontentloaded", timeout: 30000 }).catch(() => {
|
|
47812
47896
|
return;
|
|
47813
47897
|
});
|
|
47814
|
-
const ready = await
|
|
47898
|
+
const ready = await waitContentReady(page, undefined, 12000);
|
|
47815
47899
|
const broken = await pageLooksBroken(page);
|
|
47816
47900
|
const home = {
|
|
47817
47901
|
step: "home-load",
|
|
47818
47902
|
ms: Date.now() - t,
|
|
47819
47903
|
url: page.url(),
|
|
47820
47904
|
ok: ready && !broken,
|
|
47821
|
-
note: !ready ? "atingiu o cap de espera sem
|
|
47905
|
+
note: !ready ? "atingiu o cap de espera sem conteúdo pronto" : undefined
|
|
47822
47906
|
};
|
|
47823
47907
|
await dismissAll(page, ctx);
|
|
47824
47908
|
await scrollPageInChunks(page).catch(() => {
|
|
@@ -47830,7 +47914,7 @@ async function onePassContent(page, ctx, paths, measure) {
|
|
|
47830
47914
|
await revealLink(page, ctx.baseUrl, path).catch(() => {
|
|
47831
47915
|
return;
|
|
47832
47916
|
});
|
|
47833
|
-
const nav = await navigateWithHover(page, new URL(path, ctx.baseUrl).toString(),
|
|
47917
|
+
const nav = await navigateWithHover(page, new URL(path, ctx.baseUrl).toString(), "content");
|
|
47834
47918
|
const broken = await pageLooksBroken(page);
|
|
47835
47919
|
return {
|
|
47836
47920
|
step,
|
|
@@ -47838,7 +47922,7 @@ async function onePassContent(page, ctx, paths, measure) {
|
|
|
47838
47922
|
url: page.url(),
|
|
47839
47923
|
ok: nav.ok && !broken,
|
|
47840
47924
|
...nav.prefetched !== undefined ? { prefetched: nav.prefetched } : {},
|
|
47841
|
-
note: labelGotoFallback(!nav.landed ? `${path} — navegação não trocou de página` : !nav.ok ? `atingiu o cap de espera sem
|
|
47925
|
+
note: labelGotoFallback(!nav.landed ? `${path} — navegação não trocou de página` : !nav.ok ? `atingiu o cap de espera sem conteúdo pronto (${path})` : broken ? "página não encontrada / erro" : path, nav.viaFallback)
|
|
47842
47926
|
};
|
|
47843
47927
|
};
|
|
47844
47928
|
const nav1 = await hop("nav-to-page-1", paths.pageA);
|
|
@@ -48578,6 +48662,11 @@ function L(pt, en, lang) {
|
|
|
48578
48662
|
function fmtMs(ms) {
|
|
48579
48663
|
return ms >= 1000 ? `${(ms / 1000).toFixed(2)}s` : `${Math.round(ms)}ms`;
|
|
48580
48664
|
}
|
|
48665
|
+
function fmtRange(s) {
|
|
48666
|
+
if (!s?.spread || s.spread.samples < 2)
|
|
48667
|
+
return "";
|
|
48668
|
+
return `${fmtMs(s.spread.minMs)}–${fmtMs(s.spread.maxMs)}`;
|
|
48669
|
+
}
|
|
48581
48670
|
function domainOf(url) {
|
|
48582
48671
|
try {
|
|
48583
48672
|
return new URL(url).hostname.replace(/^www\./, "");
|
|
@@ -48652,7 +48741,8 @@ function renderStep(step, prod, cand, lang) {
|
|
|
48652
48741
|
const c = candStep?.ms ?? 0;
|
|
48653
48742
|
const max = Math.max(p, c, 1);
|
|
48654
48743
|
const label = STEP_LABELS[step.step] ?? { pt: step.step, en: step.step };
|
|
48655
|
-
const
|
|
48744
|
+
const noise = noiseWarning(prodStep, candStep);
|
|
48745
|
+
const tone = noise ? DECK.muted : deltaTone(p, c);
|
|
48656
48746
|
const shotKey = STEP_SHOT[step.step];
|
|
48657
48747
|
const scroll = true;
|
|
48658
48748
|
const naNote = candStep?.ms === 0 ? candStep.note : undefined;
|
|
@@ -48663,12 +48753,15 @@ function renderStep(step, prod, cand, lang) {
|
|
|
48663
48753
|
<div class="step-note">${L(naNote, naNote, lang)}</div>
|
|
48664
48754
|
</section>`;
|
|
48665
48755
|
}
|
|
48666
|
-
const bar = (ms, who, color) =>
|
|
48756
|
+
const bar = (ms, who, color, s) => {
|
|
48757
|
+
const r = fmtRange(s);
|
|
48758
|
+
return `
|
|
48667
48759
|
<div class="bar-row">
|
|
48668
48760
|
<span class="bar-who">${who}</span>
|
|
48669
48761
|
<div class="bar-track"><div class="bar-fill" style="width:${ms / max * 100}%;background:${color}"></div></div>
|
|
48670
|
-
<span class="bar-val" style="color:${color}">${fmtMs(ms)}</span>
|
|
48762
|
+
<span class="bar-val" style="color:${color}">${fmtMs(ms)}${r ? `<span class="bar-range">${r}</span>` : ""}</span>
|
|
48671
48763
|
</div>`;
|
|
48764
|
+
};
|
|
48672
48765
|
const subSteps = (() => {
|
|
48673
48766
|
if (step.step !== "pagination")
|
|
48674
48767
|
return "";
|
|
@@ -48702,6 +48795,8 @@ function renderStep(step, prod, cand, lang) {
|
|
|
48702
48795
|
candStep?.prefetched === false ? "TanStack" : ""
|
|
48703
48796
|
].filter(Boolean).join(" + ");
|
|
48704
48797
|
const coldNote = coldSides ? `<div class="step-note">${L(`Sem prefetch (${coldSides}): nenhum request Sec-Purpose: prefetch antes do clique — tempo de navegação fria.`, `No prefetch (${coldSides}): no Sec-Purpose: prefetch request before the click — cold navigation time.`, lang)}</div>` : "";
|
|
48798
|
+
const noiseWho = noise?.side === "cand" ? "TanStack" : "Fresh";
|
|
48799
|
+
const noiseNote = noise ? `<div class="step-note step-note-noise">~ ${L(`${noiseWho} variou ${fmtMs(noise.noiseMs)} entre as passadas; uma diferença de ${fmtMs(noise.deltaMs)} está dentro desse ruído — não dá para atribuir.`, `${noiseWho} varied by ${fmtMs(noise.noiseMs)} across passes; a ${fmtMs(noise.deltaMs)} difference is inside that noise — it cannot be attributed.`, lang)}</div>` : "";
|
|
48705
48800
|
return `
|
|
48706
48801
|
<section class="step${failed ? " step-failed" : ""}">
|
|
48707
48802
|
<div class="step-head">
|
|
@@ -48709,12 +48804,13 @@ function renderStep(step, prod, cand, lang) {
|
|
|
48709
48804
|
${delta}
|
|
48710
48805
|
</div>
|
|
48711
48806
|
<div class="step-bars">
|
|
48712
|
-
${bar(p, "Fresh", prodFailed ? DECK.bad : DECK.faint)}
|
|
48713
|
-
${bar(c, "TanStack", candFailed ? DECK.bad : DECK.soft)}
|
|
48807
|
+
${bar(p, "Fresh", prodFailed ? DECK.bad : DECK.faint, prodStep)}
|
|
48808
|
+
${bar(c, "TanStack", candFailed ? DECK.bad : DECK.soft, candStep)}
|
|
48714
48809
|
${subSteps}
|
|
48715
48810
|
</div>
|
|
48716
48811
|
${failed ? `<div class="step-note step-note-err">⚠ ${L(failNote, failNote, lang)}</div>` : candStep?.note ? `<div class="step-note">${L(candStep.note, candStep.note, lang)}</div>` : ""}
|
|
48717
48812
|
${coldNote}
|
|
48813
|
+
${noiseNote}
|
|
48718
48814
|
<div class="step-shots">
|
|
48719
48815
|
${figure(shotKey ? prod.screenshots[shotKey] : undefined, "Fresh", prodFailed ? DECK.bad : DECK.faint, prodStep?.url, scroll)}
|
|
48720
48816
|
${figure(shotKey ? cand.screenshots[shotKey] : undefined, "TanStack", candFailed ? DECK.bad : DECK.soft, candStep?.url, scroll)}
|
|
@@ -48770,7 +48866,7 @@ function renderViewport(report, viewport, lang) {
|
|
|
48770
48866
|
const ps = prod.steps.find((s) => s.step === cs.step);
|
|
48771
48867
|
const p = ps?.ms ?? 0;
|
|
48772
48868
|
const label = STEP_LABELS[cs.step] ?? { pt: cs.step, en: cs.step };
|
|
48773
|
-
const tone = deltaTone(p, cs.ms);
|
|
48869
|
+
const tone = noiseWarning(ps, cs) ? DECK.muted : deltaTone(p, cs.ms);
|
|
48774
48870
|
return `<div class="tile">
|
|
48775
48871
|
<span class="tile-val" style="color:${tone}">${fmtMs(cs.ms)}</span>
|
|
48776
48872
|
<span class="tile-label">${L(label.pt, label.en, lang)}</span>
|
|
@@ -48796,6 +48892,7 @@ function renderViewport(report, viewport, lang) {
|
|
|
48796
48892
|
|
|
48797
48893
|
<div class="eyebrow section-eyebrow">${L("OS CINCO PASSOS, LADO A LADO", "THE FIVE STEPS, SIDE BY SIDE", lang)}</div>
|
|
48798
48894
|
<div class="stat-grid">${statTiles}</div>
|
|
48895
|
+
<p class="annotation">${report.measuredRuns < 2 ? L("⚠ 1 passada medida por lado: sem dispersão, nenhuma diferença pode ser separada do ruído.", "⚠ 1 measured pass per side: no spread, so no difference can be told apart from noise.", lang) : L("Faixas = mín–máx entre as passadas medidas. Só compare números deste mesmo relatório: entre execuções diferentes o Fresh chega a variar 2×.", "Ranges = min–max across the measured passes. Only compare numbers within this report: between separate runs Fresh varies by up to 2×.", lang)}</p>
|
|
48799
48896
|
|
|
48800
48897
|
<div class="steps">${steps}</div>
|
|
48801
48898
|
|
|
@@ -48839,7 +48936,7 @@ function methodologyModal(report, lang) {
|
|
|
48839
48936
|
</ul>
|
|
48840
48937
|
<p>O hover (que dispara o prefetch do SPA) é aplicado igual nos dois sites e fica FORA do tempo — medimos só o clique→conteúdo.</p>
|
|
48841
48938
|
<h3>4. Média</h3>
|
|
48842
|
-
<p>Cada número é a <b>mediana de ${report.measuredRuns} medição(ões)</b> por lado, para cortar variância. O HAR completo da sessão fica salvo como artefato forense.</p>`;
|
|
48939
|
+
<p>Cada número é a <b>mediana de ${report.measuredRuns} medição(ões)</b> por lado, para cortar variância; a faixa mín–máx aparece ao lado. Quando a diferença entre os lados cabe dentro da variação de um deles, o passo fica cinza e é marcado como ruído. Os dois sites são medidos <b>ao mesmo tempo</b>, então oscilações de rede afetam ambos — mas números de execuções diferentes não são comparáveis entre si. O HAR completo da sessão fica salvo como artefato forense.</p>`;
|
|
48843
48940
|
const en = `
|
|
48844
48941
|
<h3>1. Scout (once)</h3>
|
|
48845
48942
|
<p>An explorer validates, in the browser, a category (PLP) and a product (PDP) that <b>work on BOTH sites</b> — they render a real product, no error page. The SAME pages are used on both sides.</p>
|
|
@@ -48856,7 +48953,7 @@ function methodologyModal(report, lang) {
|
|
|
48856
48953
|
</ul>
|
|
48857
48954
|
<p>The hover (which triggers the SPA prefetch) is applied identically on both sides and kept OUT of the timing — we measure only click→content.</p>
|
|
48858
48955
|
<h3>4. Median</h3>
|
|
48859
|
-
<p>Each number is the <b>median of ${report.measuredRuns} measurement(s)</b> per side, to cut variance. The full session HAR is saved as a forensic artifact.</p>`;
|
|
48956
|
+
<p>Each number is the <b>median of ${report.measuredRuns} measurement(s)</b> per side, to cut variance; the min–max range is shown next to it. When the difference between the sides fits inside either side's own variation, the step is greyed out and marked as noise. Both sites are measured <b>at the same time</b>, so network swings hit both — but numbers from separate runs are not comparable. The full session HAR is saved as a forensic artifact.</p>`;
|
|
48860
48957
|
return `<div class="modal-back" id="infoModal">
|
|
48861
48958
|
<div class="modal">
|
|
48862
48959
|
<button class="mclose" id="infoClose" type="button" aria-label="fechar">×</button>
|
|
@@ -48993,6 +49090,8 @@ ${report.favicon ? `<link rel="icon" href="${esc(report.favicon)}"/>` : ""}
|
|
|
48993
49090
|
/* failures */
|
|
48994
49091
|
.step-failed{border-color:rgba(212,61,61,0.35);box-shadow:0 0 0 1px rgba(212,61,61,0.12) inset}
|
|
48995
49092
|
.step-note-err{background:rgba(212,61,61,0.06);border-color:rgba(212,61,61,0.25);color:#a5302f}
|
|
49093
|
+
.bar-range{display:block;font-size:11px;font-weight:400;color:var(--faint)}
|
|
49094
|
+
.step-note-noise{color:var(--muted);font-style:italic}
|
|
48996
49095
|
.warn-banner{margin:18px 0 4px;padding:14px 18px;border-radius:14px;background:rgba(212,61,61,0.07);
|
|
48997
49096
|
border:1px solid rgba(212,61,61,0.3);color:#a5302f;font-size:14px;line-height:1.55}
|
|
48998
49097
|
.warn-banner b{color:#8f2624}
|
|
@@ -49133,6 +49232,7 @@ async function benchmarkCommand(opts) {
|
|
|
49133
49232
|
const warmupRuns = num(opts.warmupRuns, 2);
|
|
49134
49233
|
const measuredRuns = Math.max(1, num(opts.measuredRuns, 3));
|
|
49135
49234
|
const paginations = num(opts.paginations, 3);
|
|
49235
|
+
const paginationCapMs = num(opts.paginationCapMs ?? 5000, 5000) || 5000;
|
|
49136
49236
|
const runVitals = opts.vitals !== false;
|
|
49137
49237
|
const lang = opts.lang === "en" ? "en" : "pt";
|
|
49138
49238
|
const rc = loadParityRc();
|
|
@@ -49167,8 +49267,10 @@ async function benchmarkCommand(opts) {
|
|
|
49167
49267
|
}
|
|
49168
49268
|
}
|
|
49169
49269
|
} catch {}
|
|
49170
|
-
const
|
|
49171
|
-
|
|
49270
|
+
const pinnedPages = opts.pages?.split(",").map((p) => p.trim()).filter(Boolean);
|
|
49271
|
+
const journey = opts.journey === "content" || opts.journey === "commerce" ? opts.journey : pinnedPages?.length || detectSiteProfile({ url: opts.prod, html: prodHomeHtml }) === "content" ? "content" : "commerce";
|
|
49272
|
+
const journeyWhy = opts.journey ? "" : pinnedPages?.length ? " (--pages)" : " (auto)";
|
|
49273
|
+
console.log(chalk5.dim(` journey: ${journey}${journeyWhy}`));
|
|
49172
49274
|
const spinner = ora2("Lançando browser…").start();
|
|
49173
49275
|
const sides = [];
|
|
49174
49276
|
let favicon = null;
|
|
@@ -49194,6 +49296,7 @@ async function benchmarkCommand(opts) {
|
|
|
49194
49296
|
warmupRuns,
|
|
49195
49297
|
measuredRuns,
|
|
49196
49298
|
paginations,
|
|
49299
|
+
paginationCapMs,
|
|
49197
49300
|
runVitals,
|
|
49198
49301
|
onEvent
|
|
49199
49302
|
});
|
|
@@ -49209,7 +49312,8 @@ async function benchmarkCommand(opts) {
|
|
|
49209
49312
|
learned,
|
|
49210
49313
|
platform,
|
|
49211
49314
|
outDir: paths.screenshotsDir,
|
|
49212
|
-
onEvent
|
|
49315
|
+
onEvent,
|
|
49316
|
+
pages: pinnedPages
|
|
49213
49317
|
});
|
|
49214
49318
|
if (!contentPaths) {
|
|
49215
49319
|
console.error(chalk5.red(`
|
|
@@ -49288,6 +49392,11 @@ async function benchmarkCommand(opts) {
|
|
|
49288
49392
|
function fmt(ms) {
|
|
49289
49393
|
return ms >= 1000 ? `${(ms / 1000).toFixed(2)}s` : `${Math.round(ms)}ms`;
|
|
49290
49394
|
}
|
|
49395
|
+
function range(s) {
|
|
49396
|
+
if (!s?.spread || s.spread.samples < 2)
|
|
49397
|
+
return "";
|
|
49398
|
+
return chalk5.dim(` (${fmt(s.spread.minMs)}–${fmt(s.spread.maxMs)})`);
|
|
49399
|
+
}
|
|
49291
49400
|
function printSummary2(report) {
|
|
49292
49401
|
for (const viewport of report.viewports) {
|
|
49293
49402
|
const prod = report.sides.find((s) => s.viewport === viewport && s.side === "prod");
|
|
@@ -49303,9 +49412,16 @@ function printSummary2(report) {
|
|
|
49303
49412
|
const ps = prod.steps.find((s) => s.step === cs.step);
|
|
49304
49413
|
const flag = ps?.ok === false || cs.ok === false ? chalk5.red(` ✗ ERRO: ${cs.ok === false ? "cand" : "prod"} ${cs.note ?? ""}`) : "";
|
|
49305
49414
|
const cold = [ps?.prefetched === false ? "prod" : "", cs.prefetched === false ? "cand" : ""].filter(Boolean).join("+");
|
|
49306
|
-
|
|
49415
|
+
const noise = noiseWarning(ps, cs);
|
|
49416
|
+
console.log(` ${cs.step.padEnd(16)} prod ${fmt(ps?.ms ?? 0).padStart(8)}${range(ps)} cand ${fmt(cs.ms).padStart(8)}${range(cs)}${flag}${cold ? chalk5.dim(` sem prefetch: ${cold}`) : ""}`);
|
|
49417
|
+
if (noise) {
|
|
49418
|
+
console.log(chalk5.yellow(` ~ ${noise.side} variou ${fmt(noise.noiseMs)} entre passes; a diferença de ${fmt(noise.deltaMs)} está dentro desse ruído — não é resultado`));
|
|
49419
|
+
}
|
|
49307
49420
|
}
|
|
49308
49421
|
}
|
|
49422
|
+
console.log("");
|
|
49423
|
+
console.log(chalk5.dim(report.measuredRuns < 2 ? " ⚠ 1 passe medido por lado: sem dispersão, nenhum delta pode ser separado do ruído. Use --measured-runs ≥ 3." : " faixa = min–max entre os passes medidos. Números de runs diferentes não são comparáveis (o prod deriva até 2x entre runs)."));
|
|
49424
|
+
console.log(chalk5.dim(" Para medir uma mudança do candidato: --prod <cand-antes> --cand <cand-depois> no MESMO run."));
|
|
49309
49425
|
const failed = report.sides.flatMap((s) => s.steps.filter((st) => st.ok === false).map((st) => `${s.side}/${st.step}`));
|
|
49310
49426
|
if (failed.length > 0) {
|
|
49311
49427
|
console.log("");
|
|
@@ -63364,6 +63480,32 @@ function planBoard(plan, candUrl) {
|
|
|
63364
63480
|
}
|
|
63365
63481
|
return { url: plan.url, columns, shell, unassigned, sampled: plan.pages.length };
|
|
63366
63482
|
}
|
|
63483
|
+
function mergeScopedBoards(scoped, candUrl) {
|
|
63484
|
+
const merged = {
|
|
63485
|
+
url: [...new Set(scoped.map((s) => s.plan.url))].join(", "),
|
|
63486
|
+
columns: { triage: [], backlog: [], building: [], review: [], done: [], skipped: [] },
|
|
63487
|
+
shell: [],
|
|
63488
|
+
unassigned: [],
|
|
63489
|
+
sampled: 0
|
|
63490
|
+
};
|
|
63491
|
+
const rows = new Map;
|
|
63492
|
+
for (const { scope, plan } of scoped) {
|
|
63493
|
+
const board = planBoard(plan, candUrl);
|
|
63494
|
+
for (const column of Object.keys(board.columns)) {
|
|
63495
|
+
merged.columns[column].push(...board.columns[column].map((card) => ({ ...card, scope })));
|
|
63496
|
+
}
|
|
63497
|
+
merged.shell.push(...board.shell.map((name) => `${scope}: ${name}`));
|
|
63498
|
+
merged.unassigned.push(...board.unassigned.map((name) => `${scope}: ${name}`));
|
|
63499
|
+
merged.sampled += board.sampled;
|
|
63500
|
+
for (const c of plan.components) {
|
|
63501
|
+
const entry = rows.get(key(c.name)) ?? { component: c.name, rows: [] };
|
|
63502
|
+
entry.rows.push({ scope, status: c.status, disposition: disposition(c) });
|
|
63503
|
+
rows.set(key(c.name), entry);
|
|
63504
|
+
}
|
|
63505
|
+
}
|
|
63506
|
+
const conflicts = [...rows.values()].filter((e) => new Set(e.rows.map((r) => `${r.status}/${r.disposition}`)).size > 1);
|
|
63507
|
+
return { ...merged, conflicts };
|
|
63508
|
+
}
|
|
63367
63509
|
function setComponentVerified(plan, name, verdict, at, note) {
|
|
63368
63510
|
const k = key(name);
|
|
63369
63511
|
const component = plan.components.find((c) => key(c.name) === k);
|
|
@@ -67946,6 +68088,7 @@ async function migrateCommand(opts) {
|
|
|
67946
68088
|
const host = safeHost6(opts.url);
|
|
67947
68089
|
const runDir = resolve7(opts.outDir, host);
|
|
67948
68090
|
mkdirSync16(runDir, { recursive: true });
|
|
68091
|
+
const auth = opts.storageState ? { storageState: opts.storageState } : {};
|
|
67949
68092
|
const browser = await launchBrowser({ headless: true });
|
|
67950
68093
|
try {
|
|
67951
68094
|
const themePath = resolve7(runDir, "theme.json");
|
|
@@ -67974,7 +68117,7 @@ async function migrateCommand(opts) {
|
|
|
67974
68117
|
let platformSeen = null;
|
|
67975
68118
|
let assetsResolved = null;
|
|
67976
68119
|
for (const vp of viewports) {
|
|
67977
|
-
const ctx = await newContext(browser, { viewport: vp, keepMotion: true });
|
|
68120
|
+
const ctx = await newContext(browser, { viewport: vp, keepMotion: true, ...auth });
|
|
67978
68121
|
const page = await ctx.newPage();
|
|
67979
68122
|
try {
|
|
67980
68123
|
await page.goto(opts.url, { waitUntil: "domcontentloaded", timeout: 30000 });
|
|
@@ -68033,7 +68176,7 @@ async function migrateCommand(opts) {
|
|
|
68033
68176
|
console.log(chalk22.dim(` phase 2 sitemap: cached (${resolvedPages.length} page(s))`));
|
|
68034
68177
|
} else {
|
|
68035
68178
|
console.log(chalk22.dim(" phase 2 sitemap: resolving pages…"));
|
|
68036
|
-
const ctx = await newContext(browser, { viewport: primaryViewport });
|
|
68179
|
+
const ctx = await newContext(browser, { viewport: primaryViewport, ...auth });
|
|
68037
68180
|
const page = await ctx.newPage();
|
|
68038
68181
|
let sitemapUrls = [];
|
|
68039
68182
|
try {
|
|
@@ -68087,6 +68230,7 @@ async function migrateCommand(opts) {
|
|
|
68087
68230
|
runDir,
|
|
68088
68231
|
baseUrl: opts.url,
|
|
68089
68232
|
vtexScrape: opts.source ? source.kind === "vtex-io" : true,
|
|
68233
|
+
auth,
|
|
68090
68234
|
extraViewports: opts.componentViewports ? viewports.slice(1) : []
|
|
68091
68235
|
}));
|
|
68092
68236
|
writeFileSync25(capturePath, `${JSON.stringify({ pages, components, vtexBlocks, contentMap }, null, 2)}
|
|
@@ -68196,7 +68340,7 @@ async function capturePages(browser, viewport, resolvedPages, theme, cfg) {
|
|
|
68196
68340
|
const blocksByPath = new Map;
|
|
68197
68341
|
const contentMap = {};
|
|
68198
68342
|
for (const target of resolvedPages) {
|
|
68199
|
-
const ctx = await newContext(browser, { viewport, keepMotion: true });
|
|
68343
|
+
const ctx = await newContext(browser, { viewport, keepMotion: true, ...cfg.auth });
|
|
68200
68344
|
const page = await ctx.newPage();
|
|
68201
68345
|
const pageComponents = [];
|
|
68202
68346
|
const capturedHere = [];
|
|
@@ -68261,7 +68405,7 @@ async function capturePages(browser, viewport, resolvedPages, theme, cfg) {
|
|
|
68261
68405
|
});
|
|
68262
68406
|
}
|
|
68263
68407
|
if (cfg.extraViewports.length && capturedHere.length) {
|
|
68264
|
-
await captureViewportVariants(browser, target.url, cfg.extraViewports, capturedHere, cfg.runDir);
|
|
68408
|
+
await captureViewportVariants(browser, target.url, cfg.extraViewports, capturedHere, cfg.runDir, cfg.auth);
|
|
68265
68409
|
}
|
|
68266
68410
|
}
|
|
68267
68411
|
return {
|
|
@@ -68271,14 +68415,14 @@ async function capturePages(browser, viewport, resolvedPages, theme, cfg) {
|
|
|
68271
68415
|
contentMap
|
|
68272
68416
|
};
|
|
68273
68417
|
}
|
|
68274
|
-
async function captureViewportVariants(browser, url, extraViewports, captured, runDir) {
|
|
68418
|
+
async function captureViewportVariants(browser, url, extraViewports, captured, runDir, auth = {}) {
|
|
68275
68419
|
const perComponent = captured.map(() => []);
|
|
68276
68420
|
for (const vp of extraViewports) {
|
|
68277
68421
|
let ctx;
|
|
68278
68422
|
let page;
|
|
68279
68423
|
let done = 0;
|
|
68280
68424
|
try {
|
|
68281
|
-
ctx = await newContext(browser, { viewport: vp });
|
|
68425
|
+
ctx = await newContext(browser, { viewport: vp, ...auth });
|
|
68282
68426
|
page = await ctx.newPage();
|
|
68283
68427
|
await page.goto(url, { waitUntil: "domcontentloaded", timeout: 30000 });
|
|
68284
68428
|
await page.waitForLoadState("networkidle", { timeout: 8000 }).catch(() => {
|
|
@@ -68798,14 +68942,21 @@ var COLUMN_STYLE = {
|
|
|
68798
68942
|
done: chalk23.green,
|
|
68799
68943
|
skipped: chalk23.gray
|
|
68800
68944
|
};
|
|
68801
|
-
async function planBoardCommand(
|
|
68802
|
-
const
|
|
68803
|
-
|
|
68804
|
-
|
|
68805
|
-
|
|
68806
|
-
|
|
68945
|
+
async function planBoardCommand(dirs, opts) {
|
|
68946
|
+
const list = typeof dirs === "string" ? [dirs] : dirs;
|
|
68947
|
+
const scoped = [];
|
|
68948
|
+
for (const scope of list) {
|
|
68949
|
+
const plan = loadPlan(scope);
|
|
68950
|
+
if (!plan) {
|
|
68951
|
+
console.error(chalk23.red(`No migration-plan.json found in ${scope}`));
|
|
68952
|
+
console.error(chalk23.yellow("Run `parity migrate --url <prod>` first — no plan, no board."));
|
|
68953
|
+
return 1;
|
|
68954
|
+
}
|
|
68955
|
+
scoped.push({ scope, plan });
|
|
68807
68956
|
}
|
|
68808
|
-
const
|
|
68957
|
+
const dir = list[0];
|
|
68958
|
+
const plan = scoped[0].plan;
|
|
68959
|
+
const board = scoped.length > 1 ? mergeScopedBoards(scoped, opts.cand) : planBoard(plan, opts.cand);
|
|
68809
68960
|
if (opts.json) {
|
|
68810
68961
|
console.log(JSON.stringify(board, null, 2));
|
|
68811
68962
|
return 0;
|
|
@@ -68824,7 +68975,8 @@ ${chalk23.bold("shell")} ${chalk23.gray("(global — blocks every page)")}: ${ch
|
|
|
68824
68975
|
console.log(`
|
|
68825
68976
|
${COLUMN_STYLE[column](chalk23.bold(column))} (${cards.length})`);
|
|
68826
68977
|
for (const card of cards) {
|
|
68827
|
-
|
|
68978
|
+
const scope = card.scope ? chalk23.cyan(`[${card.scope}] `) : "";
|
|
68979
|
+
console.log(` ${scope}${card.path} ${chalk23.gray(`(${card.kind})`)}`);
|
|
68828
68980
|
if (card.blockers.length) {
|
|
68829
68981
|
console.log(chalk23.gray(` blocked by: ${card.blockers.join(", ")}`));
|
|
68830
68982
|
}
|
|
@@ -68833,7 +68985,14 @@ ${COLUMN_STYLE[column](chalk23.bold(column))} (${cards.length})`);
|
|
|
68833
68985
|
const skipped = board.columns.skipped;
|
|
68834
68986
|
if (skipped.length) {
|
|
68835
68987
|
console.log(`
|
|
68836
|
-
${chalk23.gray(`skipped (${skipped.length}): ${skipped.map((c) => c.path).join(", ")}`)}`);
|
|
68988
|
+
${chalk23.gray(`skipped (${skipped.length}): ${skipped.map((c) => c.scope ? `[${c.scope}] ${c.path}` : c.path).join(", ")}`)}`);
|
|
68989
|
+
}
|
|
68990
|
+
if (board.conflicts?.length) {
|
|
68991
|
+
console.log(`
|
|
68992
|
+
${chalk23.red.bold("conflicts")} ${chalk23.gray("(same component, different state per scope — settle by hand)")}`);
|
|
68993
|
+
for (const c of board.conflicts) {
|
|
68994
|
+
console.log(` ${c.component}: ${c.rows.map((r) => `[${r.scope}] ${r.status} (${r.disposition})`).join(" vs ")}`);
|
|
68995
|
+
}
|
|
68837
68996
|
}
|
|
68838
68997
|
if (board.unassigned.length) {
|
|
68839
68998
|
console.log(`
|
|
@@ -68841,6 +69000,11 @@ ${chalk23.bold("no page")} ${chalk23.gray("(in the code, not seen on any sampled
|
|
|
68841
69000
|
${chalk23.gray(board.unassigned.join(", "))}`);
|
|
68842
69001
|
}
|
|
68843
69002
|
console.log("");
|
|
69003
|
+
if (opts.board === "studio" && scoped.length > 1) {
|
|
69004
|
+
console.log(chalk23.yellow(`Studio board skipped — push one --dir at a time.
|
|
69005
|
+
`));
|
|
69006
|
+
return 0;
|
|
69007
|
+
}
|
|
68844
69008
|
if (opts.board === "studio") {
|
|
68845
69009
|
const cfg = studioConfigFromEnv();
|
|
68846
69010
|
if (!cfg) {
|
|
@@ -76550,6 +76714,8 @@ async function heatmapCommand(opts) {
|
|
|
76550
76714
|
candUrl: opts.cand,
|
|
76551
76715
|
selector,
|
|
76552
76716
|
candSelector,
|
|
76717
|
+
prodStorageState: opts.prodStorageState,
|
|
76718
|
+
candStorageState: opts.candStorageState,
|
|
76553
76719
|
waitMs,
|
|
76554
76720
|
outDir: opts.outDir,
|
|
76555
76721
|
prefix
|
|
@@ -76588,6 +76754,7 @@ async function compareViewport(browser, args) {
|
|
|
76588
76754
|
spec,
|
|
76589
76755
|
url: args.prodUrl,
|
|
76590
76756
|
selector: args.selector,
|
|
76757
|
+
storageState: args.prodStorageState,
|
|
76591
76758
|
waitMs: args.waitMs,
|
|
76592
76759
|
outPath: paths.prod,
|
|
76593
76760
|
repeatPath: paths.prodRepeat
|
|
@@ -76596,6 +76763,7 @@ async function compareViewport(browser, args) {
|
|
|
76596
76763
|
spec,
|
|
76597
76764
|
url: args.candUrl,
|
|
76598
76765
|
selector: args.candSelector,
|
|
76766
|
+
storageState: args.candStorageState,
|
|
76599
76767
|
waitMs: args.waitMs,
|
|
76600
76768
|
outPath: paths.cand,
|
|
76601
76769
|
repeatPath: null
|
|
@@ -76908,7 +77076,8 @@ async function captureSide(browser, args) {
|
|
|
76908
77076
|
viewport: args.spec.viewport,
|
|
76909
77077
|
viewportSize: args.spec.size ?? undefined,
|
|
76910
77078
|
deviceScaleFactor: 1,
|
|
76911
|
-
hideScrollbars: true
|
|
77079
|
+
hideScrollbars: true,
|
|
77080
|
+
...args.storageState ? { storageState: args.storageState } : {}
|
|
76912
77081
|
});
|
|
76913
77082
|
const page = await ctx.newPage();
|
|
76914
77083
|
try {
|
|
@@ -77327,6 +77496,99 @@ async function overlayCommand(opts) {
|
|
|
77327
77496
|
|
|
77328
77497
|
// src/commands/states.ts
|
|
77329
77498
|
import chalk37 from "chalk";
|
|
77499
|
+
var ROOT_ATTR = "data-parity-states";
|
|
77500
|
+
var rootSelector = (i) => `[${ROOT_ATTR}="${i}"]`;
|
|
77501
|
+
function resolveStateRoots(args) {
|
|
77502
|
+
const PRICE = /(?:R\$|US\$|\$|€|£|¥)\s?\d|\d[.,]\d{2}\s?(?:€|zł|kr)/;
|
|
77503
|
+
const linkOf = (el) => el.closest("a[href]") ?? el.querySelector("a[href]");
|
|
77504
|
+
const isCard = (el) => !!el.querySelector("img") && !!linkOf(el) && PRICE.test(el.textContent ?? "");
|
|
77505
|
+
const visible = (el) => {
|
|
77506
|
+
const check = el.checkVisibility;
|
|
77507
|
+
return typeof check === "function" ? check.call(el) : true;
|
|
77508
|
+
};
|
|
77509
|
+
const text = (el) => (el.textContent ?? "").replace(/\s+/g, " ").trim();
|
|
77510
|
+
let all;
|
|
77511
|
+
try {
|
|
77512
|
+
all = Array.from(document.querySelectorAll(args.selector));
|
|
77513
|
+
} catch (err) {
|
|
77514
|
+
return { kind: "none", error: String(err) };
|
|
77515
|
+
}
|
|
77516
|
+
const shown = all.filter(visible);
|
|
77517
|
+
if (shown.length === 0)
|
|
77518
|
+
return { kind: "none" };
|
|
77519
|
+
const first = shown[0];
|
|
77520
|
+
if (shown.length === 1) {
|
|
77521
|
+
first.setAttribute(args.attr, "0");
|
|
77522
|
+
return { kind: "single", isCard: isCard(first) };
|
|
77523
|
+
}
|
|
77524
|
+
const cards = shown.filter(isCard);
|
|
77525
|
+
const inner = cards.filter((c) => !cards.some((o) => o !== c && c.contains(o)));
|
|
77526
|
+
if (inner.length === 0) {
|
|
77527
|
+
return {
|
|
77528
|
+
kind: "ambiguous",
|
|
77529
|
+
total: shown.length,
|
|
77530
|
+
samples: shown.slice(0, 5).map((el) => `${el.tagName.toLowerCase()} "${text(el).slice(0, 40)}"`)
|
|
77531
|
+
};
|
|
77532
|
+
}
|
|
77533
|
+
const take = inner.slice(0, args.max);
|
|
77534
|
+
take.forEach((el, i) => el.setAttribute(args.attr, String(i)));
|
|
77535
|
+
return {
|
|
77536
|
+
kind: "cards",
|
|
77537
|
+
total: inner.length,
|
|
77538
|
+
ignored: shown.length - inner.length,
|
|
77539
|
+
labels: take.map((el) => {
|
|
77540
|
+
const name = el.querySelector("img[alt]")?.getAttribute("alt") ?? linkOf(el)?.getAttribute("aria-label") ?? linkOf(el)?.getAttribute("title") ?? "";
|
|
77541
|
+
return name.replace(/\s+/g, " ").trim().toLowerCase() || null;
|
|
77542
|
+
})
|
|
77543
|
+
};
|
|
77544
|
+
}
|
|
77545
|
+
function pairRoots(prod, cand) {
|
|
77546
|
+
const unique = (labels) => {
|
|
77547
|
+
const seen = new Map;
|
|
77548
|
+
labels.forEach((l, i) => {
|
|
77549
|
+
if (l)
|
|
77550
|
+
seen.set(l, seen.has(l) ? null : i);
|
|
77551
|
+
});
|
|
77552
|
+
return seen;
|
|
77553
|
+
};
|
|
77554
|
+
const p = unique(prod);
|
|
77555
|
+
const c = unique(cand);
|
|
77556
|
+
const pairs = [];
|
|
77557
|
+
const usedP = new Set;
|
|
77558
|
+
const usedC = new Set;
|
|
77559
|
+
for (const [label, pi] of p) {
|
|
77560
|
+
const ci = c.get(label);
|
|
77561
|
+
if (pi === null || ci === null || ci === undefined)
|
|
77562
|
+
continue;
|
|
77563
|
+
pairs.push([pi, ci]);
|
|
77564
|
+
usedP.add(pi);
|
|
77565
|
+
usedC.add(ci);
|
|
77566
|
+
}
|
|
77567
|
+
const restP = prod.map((_, i) => i).filter((i) => !usedP.has(i));
|
|
77568
|
+
const restC = cand.map((_, i) => i).filter((i) => !usedC.has(i));
|
|
77569
|
+
const n = Math.min(restP.length, restC.length);
|
|
77570
|
+
for (let k = 0;k < n; k++)
|
|
77571
|
+
pairs.push([restP[k], restC[k]]);
|
|
77572
|
+
pairs.sort((a, b) => a[0] - b[0]);
|
|
77573
|
+
return { pairs, unpairedProd: restP.slice(n), unpairedCand: restC.slice(n) };
|
|
77574
|
+
}
|
|
77575
|
+
function pairSides(prod, cand) {
|
|
77576
|
+
const asList = (r, other) => {
|
|
77577
|
+
if (r.kind === "cards")
|
|
77578
|
+
return r.labels;
|
|
77579
|
+
if (r.kind === "single" && (r.isCard || other.kind === "single"))
|
|
77580
|
+
return [null];
|
|
77581
|
+
return [];
|
|
77582
|
+
};
|
|
77583
|
+
const p = asList(prod, cand);
|
|
77584
|
+
const c = asList(cand, prod);
|
|
77585
|
+
const out = pairRoots(p, c);
|
|
77586
|
+
if (prod.kind === "single" && p.length === 0)
|
|
77587
|
+
out.unpairedProd.push(0);
|
|
77588
|
+
if (cand.kind === "single" && c.length === 0)
|
|
77589
|
+
out.unpairedCand.push(0);
|
|
77590
|
+
return out;
|
|
77591
|
+
}
|
|
77330
77592
|
var HOVERABLE = "a,button,summary,[role='button'],[role='menuitem'],label";
|
|
77331
77593
|
var SETTLE_RETRY_FACTOR = 4;
|
|
77332
77594
|
async function readStateEffects(page, opts) {
|
|
@@ -77408,7 +77670,7 @@ async function readStateEffects(page, opts) {
|
|
|
77408
77670
|
renumberedNodes: delta.renumbered
|
|
77409
77671
|
});
|
|
77410
77672
|
}
|
|
77411
|
-
return { effects,
|
|
77673
|
+
return { effects, hoverables: total, ambient: ambient.size };
|
|
77412
77674
|
}
|
|
77413
77675
|
var fingerprint = (n) => `${n.tag}\x00${n.label ?? ""}\x00${n.text ?? ""}`;
|
|
77414
77676
|
async function readDelta(page, selector, base) {
|
|
@@ -77436,13 +77698,7 @@ async function gatherStates(browser, opts) {
|
|
|
77436
77698
|
keepMotion: true
|
|
77437
77699
|
});
|
|
77438
77700
|
const page = await ctx.newPage();
|
|
77439
|
-
const out = {
|
|
77440
|
-
motion: { found: false, error: "not read" },
|
|
77441
|
-
base: null,
|
|
77442
|
-
effects: [],
|
|
77443
|
-
truncated: false,
|
|
77444
|
-
ambient: 0
|
|
77445
|
-
};
|
|
77701
|
+
const out = { roots: [] };
|
|
77446
77702
|
try {
|
|
77447
77703
|
const res = await page.goto(opts.url, { waitUntil: "domcontentloaded", timeout: 30000 }).catch((err) => err);
|
|
77448
77704
|
if (res instanceof Error) {
|
|
@@ -77458,22 +77714,29 @@ async function gatherStates(browser, opts) {
|
|
|
77458
77714
|
return;
|
|
77459
77715
|
});
|
|
77460
77716
|
out.settle = (await settlePage(page, { waitMs: opts.waitMs, scroll: false })).settle;
|
|
77461
|
-
|
|
77462
|
-
const base = await readBoxTree(page, opts.selector);
|
|
77463
|
-
if (!base.found) {
|
|
77464
|
-
out.baseError = base.error;
|
|
77465
|
-
return out;
|
|
77466
|
-
}
|
|
77467
|
-
out.base = base.nodes;
|
|
77468
|
-
const { effects, truncated, ambient } = await readStateEffects(page, {
|
|
77717
|
+
const resolution = await page.evaluate(resolveStateRoots, {
|
|
77469
77718
|
selector: opts.selector,
|
|
77470
|
-
|
|
77471
|
-
|
|
77472
|
-
settleMs: opts.settleMs
|
|
77719
|
+
max: opts.maxCards,
|
|
77720
|
+
attr: ROOT_ATTR
|
|
77473
77721
|
});
|
|
77474
|
-
out.
|
|
77475
|
-
|
|
77476
|
-
|
|
77722
|
+
out.resolution = resolution;
|
|
77723
|
+
const count = resolution.kind === "single" ? 1 : resolution.kind === "cards" ? resolution.labels.length : 0;
|
|
77724
|
+
for (let i = 0;i < count; i++) {
|
|
77725
|
+
const selector = rootSelector(i);
|
|
77726
|
+
const motion = await readMotion(page, selector);
|
|
77727
|
+
const base = await readBoxTree(page, selector);
|
|
77728
|
+
if (!base.found) {
|
|
77729
|
+
out.baseError = base.error;
|
|
77730
|
+
return out;
|
|
77731
|
+
}
|
|
77732
|
+
const { effects, hoverables, ambient } = await readStateEffects(page, {
|
|
77733
|
+
selector,
|
|
77734
|
+
base: base.nodes,
|
|
77735
|
+
max: opts.maxStates,
|
|
77736
|
+
settleMs: opts.settleMs
|
|
77737
|
+
});
|
|
77738
|
+
out.roots.push({ motion, effects, hoverables, ambient, boxTruncated: base.truncated });
|
|
77739
|
+
}
|
|
77477
77740
|
} finally {
|
|
77478
77741
|
await page.close().catch(() => {
|
|
77479
77742
|
return;
|
|
@@ -77547,6 +77810,7 @@ async function statesCommand(opts) {
|
|
|
77547
77810
|
const waitMs = Number.parseInt(opts.wait, 10) || 0;
|
|
77548
77811
|
const maxStates = Math.max(1, Number.parseInt(opts.maxStates ?? "12", 10) || 12);
|
|
77549
77812
|
const settleMs = Math.max(0, Number.parseInt(opts.hoverSettle ?? "250", 10) || 250);
|
|
77813
|
+
const maxCards = Math.max(1, Number.parseInt(opts.maxCards ?? "4", 10) || 4);
|
|
77550
77814
|
const prodSelector = opts.prodSelector?.trim() || opts.selector?.trim();
|
|
77551
77815
|
const candSelector = opts.candSelector?.trim() || opts.selector?.trim();
|
|
77552
77816
|
if (!prodSelector || !candSelector) {
|
|
@@ -77565,6 +77829,7 @@ async function statesCommand(opts) {
|
|
|
77565
77829
|
viewport,
|
|
77566
77830
|
waitMs,
|
|
77567
77831
|
maxStates,
|
|
77832
|
+
maxCards,
|
|
77568
77833
|
settleMs
|
|
77569
77834
|
}),
|
|
77570
77835
|
gatherStates(browser, {
|
|
@@ -77573,6 +77838,7 @@ async function statesCommand(opts) {
|
|
|
77573
77838
|
viewport,
|
|
77574
77839
|
waitMs,
|
|
77575
77840
|
maxStates,
|
|
77841
|
+
maxCards,
|
|
77576
77842
|
settleMs
|
|
77577
77843
|
})
|
|
77578
77844
|
]);
|
|
@@ -77581,16 +77847,73 @@ async function statesCommand(opts) {
|
|
|
77581
77847
|
console.error(chalk37.red(` não foi possível ler o componente — ${which}`));
|
|
77582
77848
|
return 2;
|
|
77583
77849
|
}
|
|
77584
|
-
const
|
|
77585
|
-
|
|
77586
|
-
|
|
77587
|
-
|
|
77588
|
-
|
|
77589
|
-
|
|
77590
|
-
|
|
77591
|
-
|
|
77850
|
+
for (const [name, side, sel] of [
|
|
77851
|
+
["prod", prodSide, prodSelector],
|
|
77852
|
+
["cand", candSide, candSelector]
|
|
77853
|
+
]) {
|
|
77854
|
+
const r = side.resolution;
|
|
77855
|
+
if (r?.kind === "ambiguous") {
|
|
77856
|
+
console.error(chalk37.red(` ${name}: ${sel} matches ${r.total} visible elements and none looks like a product card (image + link + price). Narrow it to one:`));
|
|
77857
|
+
for (const sample of r.samples)
|
|
77858
|
+
console.error(chalk37.dim(` ${sample}`));
|
|
77859
|
+
return 2;
|
|
77860
|
+
}
|
|
77861
|
+
if (!r || r.kind === "none") {
|
|
77862
|
+
console.error(chalk37.red(` ${name}: ${sel} matches no visible element${r?.error ? ` — ${r.error}` : ""}`));
|
|
77863
|
+
return 2;
|
|
77864
|
+
}
|
|
77865
|
+
}
|
|
77866
|
+
const pairing = pairSides(prodSide.resolution, candSide.resolution);
|
|
77867
|
+
const cardMode = prodSide.resolution?.kind === "cards" || candSide.resolution?.kind === "cards";
|
|
77868
|
+
const flatten = (side, pick) => {
|
|
77869
|
+
const effects = [];
|
|
77870
|
+
const nodes = [];
|
|
77871
|
+
let motionError;
|
|
77872
|
+
let truncated = false;
|
|
77873
|
+
pairing.pairs.forEach((pair, k) => {
|
|
77874
|
+
const root = side.roots[pair[pick]];
|
|
77875
|
+
const tag = (s) => cardMode ? `card#${k + 1} ${s}` : s;
|
|
77876
|
+
const tagLabel = (l) => cardMode && l ? tag(l) : l;
|
|
77877
|
+
for (const e of root.effects)
|
|
77878
|
+
effects.push({ ...e, target: tag(e.target), label: tagLabel(e.label) });
|
|
77879
|
+
if (root.motion.found) {
|
|
77880
|
+
truncated ||= root.motion.truncated;
|
|
77881
|
+
for (const n of root.motion.nodes)
|
|
77882
|
+
nodes.push({ ...n, key: tag(n.key), label: tagLabel(n.label) });
|
|
77883
|
+
} else
|
|
77884
|
+
motionError ??= root.motion.error;
|
|
77885
|
+
truncated ||= root.boxTruncated;
|
|
77886
|
+
});
|
|
77887
|
+
const motion = motionError ? null : { found: true, nodes, truncated };
|
|
77888
|
+
return { effects, motion, motionError, truncated };
|
|
77889
|
+
};
|
|
77890
|
+
const prodFlat = flatten(prodSide, 0);
|
|
77891
|
+
const candFlat = flatten(candSide, 1);
|
|
77892
|
+
const truncated = prodFlat.truncated || candFlat.truncated;
|
|
77893
|
+
const motion = prodFlat.motion && candFlat.motion ? diffMotion(prodFlat.motion, candFlat.motion, { truncated, aliases }) : null;
|
|
77894
|
+
const effects = diffEffects(prodFlat.effects, candFlat.effects);
|
|
77895
|
+
const verdict = statesVerdict({
|
|
77896
|
+
prodEffects: prodFlat.effects.length,
|
|
77897
|
+
candEffects: candFlat.effects.length,
|
|
77592
77898
|
motionMatched: motion?.matched ?? 0
|
|
77593
77899
|
});
|
|
77900
|
+
const { exercised } = verdict;
|
|
77901
|
+
const inconclusive = verdict.inconclusive || pairing.pairs.length === 0;
|
|
77902
|
+
const caps = [];
|
|
77903
|
+
for (const [name, side] of [
|
|
77904
|
+
["prod", prodSide],
|
|
77905
|
+
["cand", candSide]
|
|
77906
|
+
]) {
|
|
77907
|
+
const r = side.resolution;
|
|
77908
|
+
if (r?.kind === "cards" && r.total > r.labels.length) {
|
|
77909
|
+
caps.push(`${name}: compared ${r.labels.length} of ${r.total} product cards; raise with --max-cards N`);
|
|
77910
|
+
}
|
|
77911
|
+
const hoverables = side.roots.reduce((n, root) => n + root.hoverables, 0);
|
|
77912
|
+
const hovered = side.roots.reduce((n, root) => n + Math.min(root.hoverables, maxStates), 0);
|
|
77913
|
+
if (hoverables > hovered) {
|
|
77914
|
+
caps.push(`${name}: hovered ${hovered} of ${hoverables} interactive elements; raise with --max-states N (per ${cardMode ? "card" : "component"})`);
|
|
77915
|
+
}
|
|
77916
|
+
}
|
|
77594
77917
|
if (opts.json) {
|
|
77595
77918
|
console.log(JSON.stringify({
|
|
77596
77919
|
prod: opts.prod,
|
|
@@ -77600,11 +77923,14 @@ async function statesCommand(opts) {
|
|
|
77600
77923
|
candSelector,
|
|
77601
77924
|
viewport,
|
|
77602
77925
|
motion,
|
|
77603
|
-
motionError:
|
|
77926
|
+
motionError: prodFlat.motionError ?? candFlat.motionError,
|
|
77604
77927
|
effects,
|
|
77605
|
-
prodEffects:
|
|
77606
|
-
candEffects:
|
|
77607
|
-
truncated:
|
|
77928
|
+
prodEffects: prodFlat.effects,
|
|
77929
|
+
candEffects: candFlat.effects,
|
|
77930
|
+
truncated: truncated || caps.length > 0,
|
|
77931
|
+
roots: { prod: prodSide.resolution, cand: candSide.resolution },
|
|
77932
|
+
pairing,
|
|
77933
|
+
caps,
|
|
77608
77934
|
settle: { prod: prodSide.settle, cand: candSide.settle }
|
|
77609
77935
|
}));
|
|
77610
77936
|
return inconclusive || effects.lost.length > 0 || (motion?.findings.length ?? 0) > 0 ? 1 : 0;
|
|
@@ -77617,18 +77943,43 @@ async function statesCommand(opts) {
|
|
|
77617
77943
|
if (caveat)
|
|
77618
77944
|
console.log(chalk37.yellow(` ${caveat}`));
|
|
77619
77945
|
}
|
|
77946
|
+
if (cardMode) {
|
|
77947
|
+
console.log("");
|
|
77948
|
+
console.log(chalk37.bold(` Product cards: ${pairing.pairs.length} pair(s) — ${pairing.pairs.map(([p, c]) => `prod #${p + 1} ↔ cand #${c + 1}`).join(", ") || "none"}`));
|
|
77949
|
+
for (const [name, side] of [
|
|
77950
|
+
["prod", prodSide],
|
|
77951
|
+
["cand", candSide]
|
|
77952
|
+
]) {
|
|
77953
|
+
const r = side.resolution;
|
|
77954
|
+
if (r?.kind === "cards" && r.ignored > 0) {
|
|
77955
|
+
console.log(chalk37.dim(` ${name}: ${r.ignored} matched element(s) are not product cards and were ignored`));
|
|
77956
|
+
}
|
|
77957
|
+
if (r?.kind === "single" && !r.isCard) {
|
|
77958
|
+
console.log(chalk37.yellow(` ${name}: the selector names one element that is not a product card; it is never paired with a card`));
|
|
77959
|
+
}
|
|
77960
|
+
}
|
|
77961
|
+
const unpaired = [
|
|
77962
|
+
...pairing.unpairedProd.map((i) => `prod #${i + 1}`),
|
|
77963
|
+
...pairing.unpairedCand.map((i) => `cand #${i + 1}`)
|
|
77964
|
+
];
|
|
77965
|
+
if (unpaired.length)
|
|
77966
|
+
console.log(chalk37.dim(` UNPAIRED cards: ${unpaired.join(", ")} — not compared`));
|
|
77967
|
+
if (pairing.pairs.length === 0) {
|
|
77968
|
+
console.log(chalk37.yellow(" INCONCLUSIVE — no card paired, so nothing was compared."));
|
|
77969
|
+
}
|
|
77970
|
+
}
|
|
77620
77971
|
console.log("");
|
|
77621
77972
|
console.log(chalk37.bold(" Declared motion"));
|
|
77622
77973
|
if (!motion) {
|
|
77623
|
-
const err =
|
|
77624
|
-
console.log(chalk37.yellow(` não foi possível comparar — ${
|
|
77974
|
+
const err = prodFlat.motionError ?? candFlat.motionError ?? "nothing paired";
|
|
77975
|
+
console.log(chalk37.yellow(` não foi possível comparar — ${err}`));
|
|
77625
77976
|
} else {
|
|
77626
77977
|
for (const line of formatMotionDiff(motion).split(`
|
|
77627
77978
|
`))
|
|
77628
77979
|
console.log(` ${line}`);
|
|
77629
77980
|
}
|
|
77630
77981
|
console.log("");
|
|
77631
|
-
console.log(chalk37.bold(` Hover effects (${
|
|
77982
|
+
console.log(chalk37.bold(` Hover effects (${prodFlat.effects.length} prod / ${candFlat.effects.length} cand)`));
|
|
77632
77983
|
const nothing = effects.lost.length === 0 && effects.changed.length === 0 && effects.added.length === 0 && effects.unpaired.length === 0;
|
|
77633
77984
|
if (nothing && !exercised) {
|
|
77634
77985
|
console.log(chalk37.yellow(" INCONCLUSIVE — no hover changed anything on either side, so nothing was exercised. Check the selector holds an interactive element."));
|
|
@@ -77662,11 +78013,15 @@ async function statesCommand(opts) {
|
|
|
77662
78013
|
console.log("");
|
|
77663
78014
|
console.log(chalk37.yellow(` ${effects.unpaired.length} prod effect(s) had no counterpart and NOTHING paired. That is a pairing failure, not a set of defects — check --selector contains the same component on both sides, and that ported roots carry data-section.`));
|
|
77664
78015
|
}
|
|
77665
|
-
|
|
77666
|
-
|
|
78016
|
+
const prodAmbient = prodSide.roots.reduce((n, r) => n + r.ambient, 0);
|
|
78017
|
+
const candAmbient = candSide.roots.reduce((n, r) => n + r.ambient, 0);
|
|
78018
|
+
if (prodAmbient > 0 || candAmbient > 0) {
|
|
78019
|
+
console.log(chalk37.dim(` ${prodAmbient} prod / ${candAmbient} cand node+property pair(s) were moving with no interaction (carousel, autoplaying video, anything on a timer) and were subtracted. A large count means --selector contains something animating on its own; narrow it.`));
|
|
77667
78020
|
}
|
|
77668
|
-
|
|
77669
|
-
console.log(chalk37.
|
|
78021
|
+
for (const cap of caps)
|
|
78022
|
+
console.log(chalk37.yellow(` CAPPED — ${cap}; absence of a finding is not proof`));
|
|
78023
|
+
if (truncated) {
|
|
78024
|
+
console.log(chalk37.dim(" TRUNCATED — box-tree or motion node cap hit; absence of a finding is not proof"));
|
|
77670
78025
|
}
|
|
77671
78026
|
return inconclusive || effects.lost.length > 0 || (motion?.findings.length ?? 0) > 0 ? 1 : 0;
|
|
77672
78027
|
} finally {
|
|
@@ -78431,8 +78786,8 @@ program.command("plan").description("Inspect/update the migration-plan.json comp
|
|
|
78431
78786
|
process.exit(planStatusCommand(opts.dir, Boolean(opts.json)));
|
|
78432
78787
|
})).addCommand(new Command("page").description("Per-page worksheet: every component the capture saw on this page, what to do about it (build | validate | upgrade | as-is | settled), and a runnable `parity section` command for the checkable ones. The unit of work a migration closes is a page, not a global queue.").argument("<path>", "Page path, e.g. / or /refrigeracion").option("--dir <path>", "Directory holding migration-plan.json (default: the target repo's .parity/)", ".parity").option("--cand <url>", "Candidate base URL — required for runnable validation commands").option("--json", "Emit structured JSON instead of human-readable text", false).action((path, opts) => {
|
|
78433
78788
|
process.exit(planPageCommand(opts.dir, path, { cand: opts.cand, json: Boolean(opts.json) }));
|
|
78434
|
-
})).addCommand(new Command("board").description("Per-page kanban: every sampled page in a derived lane (triage | backlog | building | review | done) with what blocks it. Lanes come from each page's components, so a page cannot read as done while a component it needs is missing.").option("--dir <path>", "Directory holding migration-plan.json (default: the target repo's .parity/)",
|
|
78435
|
-
process.exit(await planBoardCommand(opts.dir, {
|
|
78789
|
+
})).addCommand(new Command("board").description("Per-page kanban: every sampled page in a derived lane (triage | backlog | building | review | done) with what blocks it. Lanes come from each page's components, so a page cannot read as done while a component it needs is missing.").option("--dir <path>", "Directory holding migration-plan.json (default: the target repo's .parity/). Repeat it to merge scoped plans into one board; a component the scopes record differently is listed as a conflict.", (value, previous) => [...previous ?? [], value]).option("--cand <url>", "Candidate base URL — enriches cards with validation state").option("--board <where>", "terminal (default) | studio — push one card per page to the deco Studio task board (uses the `bunx decocms auth login` session, or PARITY_STUDIO_URL + PARITY_STUDIO_TOKEN; falls back to terminal when unset or unreachable)", "terminal").option("--repo <owner/name>", "Repository stored on each card, so the board knows where the work lives").option("--fixes <path>", "JSON file of client-legible fixes to mirror as cards: [{title, body?, prUrl?, state: open|in_review|closed}]").option("--json", "Emit structured JSON instead of human-readable text", false).action(async (opts) => {
|
|
78790
|
+
process.exit(await planBoardCommand(opts.dir ?? [".parity"], {
|
|
78436
78791
|
cand: opts.cand,
|
|
78437
78792
|
json: Boolean(opts.json),
|
|
78438
78793
|
board: opts.board,
|
|
@@ -78559,7 +78914,7 @@ program.command("benchmark").description([
|
|
|
78559
78914
|
"a HAR, measures Web Vitals with Lighthouse, and emits ONE self-contained HTML report",
|
|
78560
78915
|
"(PT/EN toggle) you can share with a client."
|
|
78561
78916
|
].join(`
|
|
78562
|
-
`)).requiredOption("--prod <url>", "Production URL (Fresh — the 'before')").requiredOption("--cand <url>", "Candidate URL (TanStack — the 'after')").option("--viewports <list>", "mobile,desktop (pick one or both)", "mobile,desktop").option("--warmup-runs <n>", "Journey passes to warm caches before measuring", "2").option("--measured-runs <n>", "Measured passes per side (median, kills variance)", "3").option("--paginations <n>", "How many times to scroll/paginate the PLP", "3").option("--plp <path>", "Pin the PLP path (skip auto-discovery), e.g. /roupas — useful to force a clothing category with real color variants").option("--journey <type>", "Journey shape: commerce (home→PLP→PDP→variant) | content (home→page A→page B, for blog/custom sites with no PLP/PDP). Auto-detected from the platform when omitted. Issue #251.").option("--cep <cep>", "CEP (kept for overlay/region dismissal parity)", "01310-100").option("--output <dir>", "Output directory for runs/<id>/", "./parity-output").option("--no-vitals", "Skip the Lighthouse web-vitals pass (faster iteration)").option("--no-auto-selectors", "Skip LLM-based selector discovery").option("--lang <pt|en>", "Default report language (toggle switches live)", "pt").option("--open", "Open the HTML report when done", false).option("--pt", "Tell the LLM to respond in Brazilian Portuguese. Issue #67.").action(async (opts) => {
|
|
78917
|
+
`)).requiredOption("--prod <url>", "Production URL (Fresh — the 'before')").requiredOption("--cand <url>", "Candidate URL (TanStack — the 'after')").option("--viewports <list>", "mobile,desktop (pick one or both)", "mobile,desktop").option("--warmup-runs <n>", "Journey passes to warm caches before measuring", "2").option("--measured-runs <n>", "Measured passes per side (median, kills variance)", "3").option("--paginations <n>", "How many times to scroll/paginate the PLP", "3").option("--pagination-cap-ms <n>", "How long one scroll waits for new cards; slower loads are truncated to this (#274)", "5000").option("--plp <path>", "Pin the PLP path (skip auto-discovery), e.g. /roupas — useful to force a clothing category with real color variants").option("--journey <type>", "Journey shape: commerce (home→PLP→PDP→variant) | content (home→page A→page B, for blog/custom sites with no PLP/PDP). Auto-detected from the platform when omitted. Issue #251.").option("--pages <paths>", "Content journey: candidate content pages, comma-separated (e.g. /blog,/sobre). The first two that load on BOTH sites are measured, instead of scraping the home nav. Implies --journey content when --journey is omitted").option("--cep <cep>", "CEP (kept for overlay/region dismissal parity)", "01310-100").option("--output <dir>", "Output directory for runs/<id>/", "./parity-output").option("--no-vitals", "Skip the Lighthouse web-vitals pass (faster iteration)").option("--no-auto-selectors", "Skip LLM-based selector discovery").option("--lang <pt|en>", "Default report language (toggle switches live)", "pt").option("--open", "Open the HTML report when done", false).option("--pt", "Tell the LLM to respond in Brazilian Portuguese. Issue #67.").action(async (opts) => {
|
|
78563
78918
|
if (opts.pt) {
|
|
78564
78919
|
await Promise.resolve().then(() => init_client());
|
|
78565
78920
|
setLlmLanguage("pt");
|
|
@@ -78612,12 +78967,14 @@ program.command("check").argument("<name>", "check name (kebab-case, e.g. consol
|
|
|
78612
78967
|
json: opts.json
|
|
78613
78968
|
}));
|
|
78614
78969
|
});
|
|
78615
|
-
program.command("heatmap").description("Is the candidate PIXEL-IDENTICAL to prod — yes, no, or 'nothing was compared'. Zero tolerance, no LLM, no flag to loosen it: one differing pixel fails. Sweeps mobile→2560px so a broken breakpoint cannot hide at the one size you checked, and captures prod twice first so a page that is not identical to itself reports its own noise floor instead of blaming the candidate. Use `parity section` to find out WHY something differs; use this to decide WHETHER it does.").requiredOption("--prod <url>", "Production URL (the reference)").requiredOption("--cand <url>", "Candidate URL").option("--selector <sel>", "Compare only this section instead of the whole page. Without it the comparison is full-page.").option("--cand-selector <sel>", "Selector on the CANDIDATE side, when the ported component no longer answers to --selector. Defaults to --selector.").option("--viewports <list>", "Comma-separated; each entry is a preset (mobile|tablet|desktop) or a literal <width>x<height>, and every entry must be clean for the run to pass. `all` expands to the full sweep (mobile→2560px) — worth it to close a page, too slow to put in a per-component loop, which is why it is not the default.", DEFAULT_VIEWPORTS).option("--wait <ms>", "Extra ms after networkidle so hydration settles", "2000").option("--pr <number>", "Publish the verdict as a PR comment, with the diff images inline. Reporting only — a failure to publish never changes the verdict or the exit code.").option("--repo <owner/name>", "Repo for --pr. Defaults to whatever `gh` infers from the cwd.").option("--out-dir <dir>", "Where to write the screenshots and heatmaps", "./parity-output/heatmap").option("--json", "Emit one-line JSON instead of pretty text", false).action(async (opts) => {
|
|
78970
|
+
program.command("heatmap").description("Is the candidate PIXEL-IDENTICAL to prod — yes, no, or 'nothing was compared'. Zero tolerance, no LLM, no flag to loosen it: one differing pixel fails. Sweeps mobile→2560px so a broken breakpoint cannot hide at the one size you checked, and captures prod twice first so a page that is not identical to itself reports its own noise floor instead of blaming the candidate. Use `parity section` to find out WHY something differs; use this to decide WHETHER it does.").requiredOption("--prod <url>", "Production URL (the reference)").requiredOption("--cand <url>", "Candidate URL").option("--selector <sel>", "Compare only this section instead of the whole page. Without it the comparison is full-page.").option("--cand-selector <sel>", "Selector on the CANDIDATE side, when the ported component no longer answers to --selector. Defaults to --selector.").option("--prod-storage-state <file>", "Playwright storageState (cookies + localStorage) for the production side, to compare pages behind a login. Without it an authenticated page measures the login redirect.").option("--cand-storage-state <file>", "Same, for the candidate side").option("--viewports <list>", "Comma-separated; each entry is a preset (mobile|tablet|desktop) or a literal <width>x<height>, and every entry must be clean for the run to pass. `all` expands to the full sweep (mobile→2560px) — worth it to close a page, too slow to put in a per-component loop, which is why it is not the default.", DEFAULT_VIEWPORTS).option("--wait <ms>", "Extra ms after networkidle so hydration settles", "2000").option("--pr <number>", "Publish the verdict as a PR comment, with the diff images inline. Reporting only — a failure to publish never changes the verdict or the exit code.").option("--repo <owner/name>", "Repo for --pr. Defaults to whatever `gh` infers from the cwd.").option("--out-dir <dir>", "Where to write the screenshots and heatmaps", "./parity-output/heatmap").option("--json", "Emit one-line JSON instead of pretty text", false).action(async (opts) => {
|
|
78616
78971
|
process.exit(await heatmapCommand({
|
|
78617
78972
|
prod: opts.prod,
|
|
78618
78973
|
cand: opts.cand,
|
|
78619
78974
|
selector: opts.selector,
|
|
78620
78975
|
candSelector: opts.candSelector,
|
|
78976
|
+
prodStorageState: opts.prodStorageState,
|
|
78977
|
+
candStorageState: opts.candStorageState,
|
|
78621
78978
|
viewports: opts.viewports,
|
|
78622
78979
|
wait: opts.wait,
|
|
78623
78980
|
pr: opts.pr,
|
|
@@ -78735,7 +79092,7 @@ program.command("bench").description("Compare ONE component in ISOLATION. Both s
|
|
|
78735
79092
|
json: opts.json
|
|
78736
79093
|
}));
|
|
78737
79094
|
});
|
|
78738
|
-
program.command("states").description("Compare a component's INTERACTIVE states, not just its resting frame. Two deterministic signals: declared motion (transitions, animations and the @keyframes bodies they point at, per interactive element) and hover effects (hover each element in turn, re-read the box tree, and report which effects prod has that cand lost). This is the instrument behind 'the hover effects are not the same' — no LLM, no screenshots to eyeball.").requiredOption("--prod <url>", "Production URL (source of truth)").requiredOption("--cand <url>", "Candidate URL (migrated)").option("--selector <sel>", "CSS selector for the component, on both sides. Shorthand for passing --prod-selector and --cand-selector the same value.").option("--prod-selector <sel>", "CSS selector on the PRODUCTION side. On a legacy-to-modern migration the two sides frequently share no selector at all — a prod PDP with no <main>, a header nine levels deeper than the port's — and widening to `body` to find one string that resolves on both is the worst place to run this. Give each side its own.").option("--cand-selector <sel>", "CSS selector on the CANDIDATE side. Defaults to --selector.").option("--max-states <n>", "How many interactive elements to hover per
|
|
79095
|
+
program.command("states").description("Compare a component's INTERACTIVE states, not just its resting frame. Two deterministic signals: declared motion (transitions, animations and the @keyframes bodies they point at, per interactive element) and hover effects (hover each element in turn, re-read the box tree, and report which effects prod has that cand lost). This is the instrument behind 'the hover effects are not the same' — no LLM, no screenshots to eyeball.").requiredOption("--prod <url>", "Production URL (source of truth)").requiredOption("--cand <url>", "Candidate URL (migrated)").option("--selector <sel>", "CSS selector for the component, on both sides. Shorthand for passing --prod-selector and --cand-selector the same value.").option("--prod-selector <sel>", "CSS selector on the PRODUCTION side. On a legacy-to-modern migration the two sides frequently share no selector at all — a prod PDP with no <main>, a header nine levels deeper than the port's — and widening to `body` to find one string that resolves on both is the worst place to run this. Give each side its own.").option("--cand-selector <sel>", "CSS selector on the CANDIDATE side. Defaults to --selector.").option("--max-states <n>", "How many interactive elements to hover per component (per card when the selector matches product cards). A mega-nav has hundreds of links sharing one hover rule; N distinct effects is the signal. The output says when the cap cut anything.", "12").option("--max-cards <n>", "When a selector matches several visible elements, the ones that look like a product card (image + link + price) are measured one by one and paired by product name, then by position. This caps how many per side.", "4").option("--hover-settle <ms>", "Wait after hovering before re-reading. A pure CSS transition needs none — its end state is already in the computed style on the first frame — but anything gated on a JS timer (hover intent, a debounce) needs the whole timer, and 'moves nothing' measured too early reads exactly like a broken hover. When the first read finds nothing, a second is taken at 4x this before concluding, so a site without hover-intent never pays for one.", "250").option("--viewport <viewport>", "mobile | desktop | tablet", "desktop").option("--wait <ms>", "Extra ms after networkidle so hydration settles", "2000").option("--plan-dir <dir>", "Run dir holding migration-plan.json. Its component rows are the only place the prod-side spelling of a component (`site/sections/Hero/HeroBannerV2.tsx`) and the cand-side one (`HeroSlideshow`) are written down together, so reading it lets the label pass pair nodes whose markup does not agree. Without it, unlabelled nodes fall back to the structural path.").option("--json", "Emit one-line JSON instead of pretty text", false).action(async (opts) => {
|
|
78739
79096
|
process.exit(await statesCommand({
|
|
78740
79097
|
planDir: opts.planDir,
|
|
78741
79098
|
prod: opts.prod,
|
|
@@ -78744,6 +79101,7 @@ program.command("states").description("Compare a component's INTERACTIVE states,
|
|
|
78744
79101
|
prodSelector: opts.prodSelector,
|
|
78745
79102
|
candSelector: opts.candSelector,
|
|
78746
79103
|
maxStates: opts.maxStates,
|
|
79104
|
+
maxCards: opts.maxCards,
|
|
78747
79105
|
hoverSettle: opts.hoverSettle,
|
|
78748
79106
|
viewport: opts.viewport,
|
|
78749
79107
|
wait: opts.wait,
|
|
@@ -78794,7 +79152,7 @@ program.command("extract").description("Single-site AI-ready component extractio
|
|
|
78794
79152
|
}));
|
|
78795
79153
|
});
|
|
78796
79154
|
function buildCaptureCommand(name, deprecated) {
|
|
78797
|
-
return new Command(name).description(`${deprecated ? "[deprecated: use `parity capture`] " : ""}Single-site, phased migration capture (theme → sitemap → components). No prod×cand comparison — produces a target-agnostic, token-lean bundle + prompt for a migration agent: site theme (colors/typography/spacing as Tailwind tokens), classified pages, and per-component detail (suggested Tailwind classes, interaction hints, e2e selectors). Works whether or not the source code exists. Pass --target faststore to append a target playbook. Resumable: re-runs skip a completed phase unless --refresh.`).requiredOption("--url <url>", "Site to capture from").option("--pages <list>", 'Comma-separated pages: literal paths/URLs, and/or "category-auto"/"pdp-auto". Default: "/,category-auto,pdp-auto" (home + a PLP + a PDP).').option("--components <list>", "Comma-separated role allowlist, e.g. header,footer,nav,shelf,minicart. Default: all detected.").option("--target <name>", "Target playbook to append to the prompt (e.g. faststore)").option("--viewport <viewport>", "Primary viewport for component capture: mobile | desktop | tablet", "mobile").option("--viewports <list>", "Comma-separated viewports for theme + site screenshots (e.g. mobile,desktop). Default: --viewport only.").option("--component-viewports", "Also capture every component at the non-primary --viewports. Keeps a per-viewport HTML only when it differs from the primary (normalised) and a screenshot only when its bytes differ. Costs one extra page load per viewport per page.", false).option("--sample <spec>", "Extra pages to sample from the sitemap by kind, e.g. 'plp=2,pdp=2,other=3,search=1' (other = institutional). Default samples a few of each incl. institutional pages.").option("--format <fmt>", "md | json | both", "both").option("--source <dir>", "Path to the source repo. When set, the component inventory is read from CODE (exhaustive, exact names) and the VTEX-IO runtime scrape is gated on the source actually being VTEX IO. Without it, everything comes from the live capture (original behaviour).").option("--source-kind <kind>", "Override source auto-detection: deco-fresh | vtex-io | live-only. Only needed when detection fails.").option("--no-source-hunt", "Skip the on-disk search for a source repo when --source is omitted. Without --source the command sweeps sibling directories for one.").option("--out <dir>", "Output directory (stable per host, for resume)", "./parity-migrate").option("--refresh", "Re-run all phases even if cached artifacts exist", false).option("--open", "Open the generated index.html visual report in the browser", false).option("--no-llm", "Skip the optional LLM component-relabeling pass (heuristic detection always runs regardless).").option("--json", "Emit one-line JSON instead of pretty text", false).action(async (opts) => {
|
|
79155
|
+
return new Command(name).description(`${deprecated ? "[deprecated: use `parity capture`] " : ""}Single-site, phased migration capture (theme → sitemap → components). No prod×cand comparison — produces a target-agnostic, token-lean bundle + prompt for a migration agent: site theme (colors/typography/spacing as Tailwind tokens), classified pages, and per-component detail (suggested Tailwind classes, interaction hints, e2e selectors). Works whether or not the source code exists. Pass --target faststore to append a target playbook. Resumable: re-runs skip a completed phase unless --refresh.`).requiredOption("--url <url>", "Site to capture from").option("--pages <list>", 'Comma-separated pages: literal paths/URLs, and/or "category-auto"/"pdp-auto". Default: "/,category-auto,pdp-auto" (home + a PLP + a PDP).').option("--components <list>", "Comma-separated role allowlist, e.g. header,footer,nav,shelf,minicart. Default: all detected.").option("--target <name>", "Target playbook to append to the prompt (e.g. faststore)").option("--viewport <viewport>", "Primary viewport for component capture: mobile | desktop | tablet", "mobile").option("--viewports <list>", "Comma-separated viewports for theme + site screenshots (e.g. mobile,desktop). Default: --viewport only.").option("--component-viewports", "Also capture every component at the non-primary --viewports. Keeps a per-viewport HTML only when it differs from the primary (normalised) and a screenshot only when its bytes differ. Costs one extra page load per viewport per page.", false).option("--sample <spec>", "Extra pages to sample from the sitemap by kind, e.g. 'plp=2,pdp=2,other=3,search=1' (other = institutional). Default samples a few of each incl. institutional pages.").option("--format <fmt>", "md | json | both", "both").option("--source <dir>", "Path to the source repo. When set, the component inventory is read from CODE (exhaustive, exact names) and the VTEX-IO runtime scrape is gated on the source actually being VTEX IO. Without it, everything comes from the live capture (original behaviour).").option("--source-kind <kind>", "Override source auto-detection: deco-fresh | vtex-io | live-only. Only needed when detection fails.").option("--no-source-hunt", "Skip the on-disk search for a source repo when --source is omitted. Without --source the command sweeps sibling directories for one.").option("--storage-state <file>", "Playwright storageState (cookies + localStorage) to capture pages behind a login (my account, checkout). Without it those pages capture the login redirect.").option("--out <dir>", "Output directory (stable per host, for resume)", "./parity-migrate").option("--refresh", "Re-run all phases even if cached artifacts exist", false).option("--open", "Open the generated index.html visual report in the browser", false).option("--no-llm", "Skip the optional LLM component-relabeling pass (heuristic detection always runs regardless).").option("--json", "Emit one-line JSON instead of pretty text", false).action(async (opts) => {
|
|
78798
79156
|
if (deprecated)
|
|
78799
79157
|
deprecatedNotice("migrate", "capture");
|
|
78800
79158
|
process.exit(await migrateCommand({
|
|
@@ -78809,6 +79167,7 @@ function buildCaptureCommand(name, deprecated) {
|
|
|
78809
79167
|
viewports: opts.viewports,
|
|
78810
79168
|
componentViewports: opts.componentViewports,
|
|
78811
79169
|
sample: opts.sample,
|
|
79170
|
+
storageState: opts.storageState,
|
|
78812
79171
|
format: opts.format,
|
|
78813
79172
|
outDir: opts.out,
|
|
78814
79173
|
refresh: opts.refresh,
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@decocms/parity",
|
|
3
|
-
"version": "0.33.
|
|
3
|
+
"version": "0.33.62",
|
|
4
4
|
"description": "E2E parity validator for site migrations. Compares prod vs cand and reports UI, functional, SEO, visual, and Web Vitals deltas with an LLM-ranked HTML report.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|