@wix/agent-skills 1.35.1 → 1.36.1

package/skills/wix-harmony-editor/scripts/copy/deploy-description.mjs

@@ -1,212 +0,0 @@
-#!/usr/bin/env node
-// Deploy a checked page description into a Harmony page in a few editor calls, read
-// everything back, and save. No model in the loop.
-//
-//   node scripts/copy/deploy-description.mjs <page.desc.json> --page <pageId> [--clean] [--reapply] [--chunk 10]
-//
-// --reapply  re-send content, styles and links to components that already exist (after the
-//            description changed); without it an existing component is only re-placed
-//
-// Calls (each one RunEditorLLMCodeToolAPI execute):
-//   1  setup     navigate, add the page's one auto-height section (or reuse the one recorded in
-//                the state file), set its background; --clean removes the page's other sections
-//                and this description's components left elsewhere on the page (pinned ones)
-//   2… create    add components in chunks, each renamed to its description key and given its
-//                content, styles and link (idempotent: a key already in the section is skipped)
-//   n  desktop   one setComposition with every box and the section height; pin floating items
-//   n+1 mobile   one setComposition in the mobile view (positions, widths, height: per view)
-//   n+2 verify   read back text, links, styles and both compositions, diff against the
-//                description, save, report publish state before/after
-// State (key -> componentId) is kept in <desc>.deploy.json, so a failed call is resumed, never
-// re-run blindly. Requires the editor open on CDP 127.0.0.1:$PW_PORT, default 9333 (SKILL.md → Connect).
-// Mobile-only Hide and the mobile background-image opacity have no API: run mobile-stage.mjs after.
-import { chromium } from 'playwright';
-import { hideScrollbars } from './hide-scrollbars.mjs';
-import fs from 'fs';
-import { descHash, openItems, pendingItems } from './desc-hash.mjs';
-
-const args = process.argv.slice(2);
-const opt = (n, d) => { const i = args.indexOf(`--${n}`); return i >= 0 ? args[i + 1] : d; };
-const descFile = args.find((a, i) => !a.startsWith('--') && !(i > 0 && args[i - 1].startsWith('--')));
-const pageId = opt('page');
-if (!descFile || !pageId) { console.error('usage: deploy-description.mjs <page.desc.json> --page <pageId> [--clean] [--chunk 10]'); process.exit(2); }
-const desc = JSON.parse(fs.readFileSync(descFile, 'utf8'));
-if (!desc.checkedAt || desc.checkedHash !== descHash(desc)) { console.error('Refused: the description has no passing check for its current content. Run check-description.mjs --write until it passes (it stamps only a clean check).'); process.exit(2); }
-const stateFile = descFile.replace(/\.json$/, '') + '.deploy.json';
-const state = fs.existsSync(stateFile) ? JSON.parse(fs.readFileSync(stateFile, 'utf8')) : { pageId, ids: {} };
-const chunk = Number(opt('chunk', 10));
-const saveState = () => fs.writeFileSync(stateFile, JSON.stringify(state, null, 1));
-
-const browser = await chromium.connectOverCDP(`http://127.0.0.1:${process.env.PW_PORT || 9333}`);
-const page = browser.contexts().flatMap((c) => c.pages()).find((p) => p.url().includes('editor.wix.com/edit/'));
-if (!page) { console.error('No Harmony editor page is open.'); process.exit(3); }
-await hideScrollbars(page); // canvas widths must not depend on the OS scrollbar setting
-const timings = [];
-async function run(name, code) {
-  const t0 = Date.now();
-  const raw = await page.evaluate(async (code) => { const api = await repluggableAppDebug.host.getAPI({ name: 'RunEditorLLMCodeToolAPI', public: true, layer: 'DATA_SERVICE' }); try { return await api.execute({ code }, { biParams: {} }); } catch (e) { return { thrown: String(e?.message || e) }; } }, code);
-  timings.push([name, Date.now() - t0]);
-  if (raw.thrown) throw new Error(`${name}: ${raw.thrown}`);
-  const c = JSON.parse(raw.items[0].content);
-  if (!c.success) { const e = new Error(`${name}: ${c.summary}`); e.detail = c; throw e; }
-  return c.result;
-}
-const J = (v) => JSON.stringify(v);
-const plainLine = (h) => { const m = h.match(/^<p>([^<]*)<\/p>$/); return m ? m[1].replace(/&nbsp;/g, ' ').replace(/&amp;/g, '&').replace(/&lt;/g, '<').replace(/&gt;/g, '>') : null; };
-const cleanLink = (l) => { if (!l) return null; const { sourcePage, unbuilt, ...rest } = l; return rest; };
-const flow = desc.components.filter((c) => c.kind !== 'pinned');
-
-// 1 setup -----------------------------------------------------------------------------
-const bg = desc.section.background;
-const setup = await run('setup', `
-const A = editorLLMApis;
-const before = (await A.site.getStatus()).isPublished;
-await A.pages.navigate({ pageId: ${J(pageId)} });
-await A.breakpoints.toggle({ device: 'desktop' });
-let secs = await A.sections.list({});
-let sec = secs.find((s) => s.sectionId === ${J(state.sectionId || null)});
-if (!sec) sec = await A.sections.add({ name: ${J(desc.section.name || desc.page.name || 'Copy')} });
-const removed = [];
-if (${args.includes('--clean')}) {
-  for (const s of secs) if (s.role === 'section' && s.sectionId !== sec.sectionId) { await A.sections.remove({ sectionId: s.sectionId }); removed.push(s.sectionId); }
-  // components this description placed outside the section earlier (pinned ones live on the page)
-  for (const k of ${J(desc.components.filter((c) => c.kind === 'pinned').map((c) => c.key))}) { const f = await A.components.find({ labelContains: k, pageId: ${J(pageId)} }); for (const c of f.components) if (c.label === k) { await A.components.remove({ componentIds: [c.id] }); removed.push(c.id); } }
-}
-await A.appearance.setContainerBackground({ componentId: sec.sectionId, properties: { ${bg.plate ? `image: ${J({ uri: bg.plate.uri, name: bg.plate.name, alt: '', width: bg.plate.width, height: bg.plate.height })}, fittingType: ${J(bg.fittingType)},` : ''} backgroundColor: ${J(bg.backgroundColor)}${desc.section.mobile.gradient ? `, backgroundImage: ${J(desc.section.mobile.gradient)}` : ''} } });
-const kids = (await A.components.getTree({ rootId: sec.sectionId, depth: 1 })).children || [];
-const pins = [];
-for (const k of ${J(desc.components.filter((c) => c.kind === 'pinned').map((c) => c.key))}) { const f = await A.components.find({ labelContains: k, pageId: ${J(pageId)} }); for (const c of f.components) if (c.label === k) pins.push([k, c.id]); }
-return { before, sectionId: sec.sectionId, removed, existing: kids.map((k) => [k.label, k.id]), pins };`);
-state.sectionId = setup.sectionId; state.publishedBefore = setup.before;
-// the live page is the truth: drop every remembered id that is no longer there (--clean, a replaced section)
-{ const live = new Map(setup.existing), livePins = new Map(setup.pins); state.ids = {};
-  for (const c of desc.components) { const id = (c.kind === 'pinned' ? livePins : live).get(c.key); if (id) state.ids[c.key] = id; } }
-saveState();
-
-// 2 create ----------------------------------------------------------------------------
-// --reapply also re-sends content, styles and links to components that already exist (no add)
-const reapply = args.includes('--reapply');
-const todo = desc.components.filter((c) => !state.ids[c.key] || reapply);
-for (let i = 0; i < todo.length; i += chunk) {
-  const part = todo.slice(i, i + chunk);
-  const body = part.map((c) => {
-    const lines = state.ids[c.key] ? [`{ const id = ${J(state.ids[c.key])}; out[${J(c.key)}] = id;`] : [`{ const a = (await A.components.add({ containerId: S, components: [{ componentType: ${J(c.type)} }], select: false })).added[0]; const id = a.componentId; out[${J(c.key)}] = id;`, `await A.components.rename({ componentId: id, label: ${J(c.key)} });`];
-    if (c.kind === 'text') { const pl = plainLine(c.html); lines.push(pl !== null ? `await A.richText.injectText({ componentId: id, text: ${J(pl)} });` : `await A.richText.setText({ componentId: id, text: ${J(c.html)} });`); }
-    if (c.kind === 'image') lines.push(`await A.content.set({ componentId: id, values: { image: ${J({ uri: c.image.uri, name: c.image.name, alt: c.image.alt || '', width: c.image.width, height: c.image.height })}, displayMode: ${J(c.displayMode)} } });`);
-    if (c.kind === 'image' && c.displayMode === 'fill') lines.push(`await A.layout.setSize({ componentId: id, width: ${c.desktop.width}, height: ${c.desktop.height} });`); // a cropped image (fill) keeps the box the source drew; composition derives height from the ratio
-    if (['button', 'hotspot', 'pinned'].includes(c.kind)) lines.push(`await A.content.writeText({ componentId: id, text: ${J(c.label || ' ')} });`);
-    for (const [el, props] of Object.entries(c.styles || {})) lines.push(`await A.appearance.setStyles({ componentId: id, ${el === 'root' ? '' : `elementPath: ${J(el.split('/'))}, `}properties: ${J(props)} });`);
-    if (c.link) lines.push(`await A.links.set({ componentId: id, link: ${J(cleanLink(c.link))} });`);
-    else if (reapply && state.ids[c.key] && c.kind !== 'text') lines.push(`await A.links.remove({ componentId: id });`); // the description has none: an old live link must go (removing a missing one succeeds; any error is real)
-    return lines.join('\n') + ' }';
-  }).join('\n');
-  const made = await run(`create ${i / chunk + 1}`, `const A = editorLLMApis; const S = ${J(state.sectionId)}; const out = {};\n${body}\nreturn out;`);
-  Object.assign(state.ids, made); saveState();
-}
-
-// 3 desktop composition + pins ----------------------------------------------------------
-// text and native (cart icon...) heights follow content; on mobile an image's height is SHARED with desktop (its width is
-// per view), so mobile sends no image height and lets the ratio derive it
-const box = (c, b, dev = 'desktop') => (c.kind === 'text' || c.kind === 'native' || (dev === 'mobile' && c.kind === 'image') ? { x: b.x, y: b.y, width: b.width } : { x: b.x, y: b.y, width: b.width, height: b.height });
-const pinned = desc.components.filter((c) => c.kind === 'pinned');
-// A new text starts narrow and therefore tall; once the first pass gives it its width it
-// reflows shorter and the boxes below it drift up. So the same set is sent until it lands.
-const compose = (dev, list, height, keyOf) => `
-const A = editorLLMApis; await A.breakpoints.toggle({ device: '${dev}' });
-const want = ${J(list.map((c) => ({ componentId: state.ids[c.key], box: box(c, keyOf(c), dev) })))};
-let r, pass = 0, off = [];
-for (; pass < 4; pass++) {
-  // the editor rejects a composition that changes nothing ("resolved back onto the boxes it already had"):
-  // that is fine when the read-back below shows every box already where it was asked to be
-  let noop = false;
-  try { r = await A.layout.setComposition({ componentId: ${J(state.sectionId)}, box: { height: ${height} }, children: want }); }
-  catch (e) { if (!/back onto the boxes it already had/.test(String((e && e.message) || e))) throw e; noop = true; }
-  const got = await A.layout.getComposition({ componentId: ${J(state.sectionId)} });
-  const at = Object.fromEntries(got.children.map((k) => [k.componentId, k.box]));
-  off = want.filter((w) => !at[w.componentId] || ['x', 'y', 'width', 'height'].some((k) => w.box[k] !== undefined && Math.abs(at[w.componentId][k] - w.box[k]) > 1)).map((w) => [w.componentId, w.box, at[w.componentId] || null]);
-  if (noop) r = got;
-  if (!off.length) break;
-}`;
-const desk = await run('desktop', compose('desktop', flow, desc.section.desktop.height, (c) => c.desktop) + `
-const pins = [];
-${pinned.map((c) => `{ const id = ${J(state.ids[c.key])}; // a pinned component cannot be resized: size it in the flow, then pin
-  if ((await A.layout.getPinToScreen({ componentId: id })).pinned) await A.layout.unpinFromScreen({ componentId: id });
-  await A.layout.setSize({ componentId: id, width: ${c.desktop.width} });
-  pins.push(await A.layout.pinToScreen({ componentId: id, position: ${J(c.pin.position)}, offsetPx: ${J(c.pin.offsetPx)} })); }`).join('\n')}
-return { passes: pass + 1, box: r.box, diagnostics: r.diagnostics, off, pins: pins.map((p) => [p.componentId, p.position, p.offsetPx]) };`);
-
-// 4 mobile composition ------------------------------------------------------------------
-const mob = flow.filter((c) => !c.mobile.hidden && c.mobile.final);
-// Mobile: a first pass sets widths (with the locally predicted y's), then the column is
-// re-stacked IN THE EDITOR from the heights Harmony actually gave each text (fonts wrap a
-// little differently there), the same rules as check-description, and sent again. The band
-// gradient is recomputed from the final y's.
-const M = desc.section.mobile;
-const stack = [...mob].sort((a, b) => a.mobile.order - b.mobile.order).map((c) => ({ // reading order, as check-description stacks it
-  id: state.ids[c.key], fixed: !!c.mobile.box, x: c.mobile.final.x, width: c.mobile.final.width, y: c.mobile.final.y, group: c.mobile.group, row: c.mobile.row || null, continues: !!c.continues, color: c.mobile.color || null, image: c.kind === 'image' }));
-const mobile = await run('mobile', compose('mobile', mob, M.height, (c) => c.mobile.final) + `
-const H = Object.fromEntries((await A.layout.getComposition({ componentId: ${J(state.sectionId)} })).children.map((k) => [k.componentId, k.box]));
-const L = ${J(stack)}, G = ${M.gap}, GG = ${M.groupGap};
-const near = (a, b) => { const p = (h) => [1, 3, 5].map((i) => parseInt(h.slice(i, i + 2), 16)); const x = p(a), y = p(b); return Math.max(...x.map((v, i) => Math.abs(v - y[i]))) < 40; };
-const fixedEnd = Math.max(0, ...L.filter((c) => c.fixed).map((c) => H[c.id].y + H[c.id].height));
-let y = 0, last = null, rowKey = null, rowY = 0; const bands = []; const kids = [];
-for (const c of L) {
-  if (c.fixed) continue;
-  if (y < fixedEnd) y = fixedEnd + GG;
-  if (last && c.group !== last) y += GG;
-  if (c.color && (!bands.length || !near(bands[bands.length - 1].color, c.color))) { if (bands.length) bands[bands.length - 1].end = y - G / 2; bands.push({ color: c.color, start: y - G / 2 }); }
-  let top = y; if (c.row && c.row === rowKey) top = rowY; else { rowKey = c.row; rowY = y; }
-  if (c.continues && !c.row) top = Math.max(top - G, 0);
-  kids.push({ componentId: c.id, box: { x: c.x, y: top, width: c.width } });
-  y = Math.max(y, top + H[c.id].height + G); last = c.group;
-}
-const height = Math.round(y + GG);
-if (bands.length) bands[bands.length - 1].end = height;
-for (let i = bands.length - 1; i > 0; i--) if (bands[i].end - bands[i].start < 40 || near(bands[i].color, bands[i - 1].color)) { bands[i - 1].end = bands[i].end; bands.splice(i, 1); }
-let restack = null, restackOff = [];
-for (let k = 0; k < 3; k++) { try { restack = await A.layout.setComposition({ componentId: ${J(state.sectionId)}, box: { height }, children: kids }); } catch (e) { if (!/back onto the boxes it already had/.test(String((e && e.message) || e))) throw e; restack = await A.layout.getComposition({ componentId: ${J(state.sectionId)} }); } const got = Object.fromEntries((await A.layout.getComposition({ componentId: ${J(state.sectionId)} })).children.map((q) => [q.componentId, q.box])); restackOff = kids.filter((w) => Math.abs(got[w.componentId].y - w.box.y) > 1); if (!restackOff.length) break; }
-const stops = [[${J(M.bands.nav || '#FFFFFF')}, 100], [${J(M.bands.head || M.bands.nav || '#FFFFFF')}, fixedEnd + GG / 2], ...bands.map((b) => [b.color, b.end])];
-let prev = 0; const gradient = 'linear-gradient(180deg, ' + stops.map(([c, e]) => { const s = c + ' ' + (prev / height * 100).toFixed(2) + '%, ' + c + ' ' + (e / height * 100).toFixed(2) + '%'; prev = e; return s; }).join(', ') + ')';
-await A.breakpoints.toggle({ device: 'desktop' });
-await A.appearance.setContainerBackground({ componentId: ${J(state.sectionId)}, properties: { backgroundImage: gradient } }); // shared: desktop's plate covers it
-return { passes: pass + 1, box: restack.box, diagnostics: restack.diagnostics, off: restackOff, restacked: Object.fromEntries(kids.map((k) => [k.componentId, k.box.y])), height, bands: bands.length };`);
-// the verify step compares mobile y against the restacked positions
-for (const c of mob) if (mobile.restacked[state.ids[c.key]] !== undefined) c.mobile.final = { ...c.mobile.final, y: mobile.restacked[state.ids[c.key]] };
-
-// 5 read back, diff INSIDE the editor (a result over ~50 KB comes back truncated), save ----
-const expect = desc.components.map((c) => ({ key: c.key, id: state.ids[c.key], kind: c.kind, text: c.html, link: cleanLink(c.link), styles: c.styles || {}, desktop: c.kind === 'pinned' ? null : c.desktop, mobile: c.mobile?.final || null }));
-const back = await run('verify', `
-const A = editorLLMApis; const S = ${J(state.sectionId)}; const E = ${J(expect)};
-const num = (v) => parseFloat(String(v));
-const textOf = (h) => String(h || '').replace(/<[^>]+>/g, '').replace(/&nbsp;|\u00a0/g, ' ').replace(/&amp;/g, '&').replace(/\s+/g, ' ').trim();
-const comp = async (dev) => { await A.breakpoints.toggle({ device: dev }); const c = await A.layout.getComposition({ componentId: S }); return { box: c.box, kids: Object.fromEntries(c.children.map((k) => [k.componentId, k.box])), overlaps: c.diagnostics.overlaps.length }; };
-const d = await comp('desktop'); const m = await comp('mobile'); await A.breakpoints.toggle({ device: 'desktop' });
-const problems = [];
-for (const e of E) {
-  if (!e.id) { problems.push([e.key, 'not created']); continue; }
-  let vals = {}; try { const v = await A.content.get({ componentId: e.id }); vals = v.values || {}; } catch (err) { problems.push([e.key, 'content unreadable']); }
-  if (e.kind === 'text') { const h = vals.richText ? vals.richText.text : ''; if (textOf(h) !== textOf(e.text)) problems.push([e.key, 'text differs', textOf(h).slice(0, 50)]); if ((h.match(/<span/g) || []).length !== (e.text.match(/<span/g) || []).length) problems.push([e.key, 'inline styling differs']); }
-  if (e.link) { const l = vals.link || {}; if (l.type !== e.link.type || (e.link.pageId && l.pageId !== e.link.pageId) || (e.link.url && l.url !== e.link.url) || (e.link.recipient && l.recipient !== e.link.recipient)) problems.push([e.key, 'link differs', l.type || null]); }
-  if (!e.link && e.kind !== 'text' && vals.link && vals.link.type) problems.push([e.key, 'link should be absent', vals.link.type]);
-  const st = await A.appearance.getStyles({ componentId: e.id });
-  const byEl = Object.fromEntries(st.elements.map((x) => [x.elementPath.join('/') || 'root', x.properties]));
-  for (const [el, props] of Object.entries(e.styles)) for (const [k, v] of Object.entries(props)) {
-    const got = byEl[el] && byEl[el][k] ? byEl[el][k].raw : null;
-    const same = got === v || String(got).toLowerCase() === String(v).toLowerCase() || (/(px|spx|em)$/.test(v) && Math.abs(num(got) - num(v)) <= 0.02 * Math.max(1, num(v))) || (/^(rgb|#)/.test(v) && String(got).replace(/\s/g, '').toLowerCase() === String(v).replace(/\s/g, '').toLowerCase());
-    if (!same) problems.push([e.key, el + '.' + k, v, got]);
-  }
-  if (e.desktop) { const b = d.kids[e.id]; if (!b) problems.push([e.key, 'not in desktop layout']); else for (const k of e.kind === 'text' ? ['x', 'y', 'width'] : ['x', 'y', 'width', 'height']) if (Math.abs(b[k] - e.desktop[k]) > 2) problems.push([e.key, 'desktop ' + k, e.desktop[k], b[k]]); }
-  if (e.mobile) { const b = m.kids[e.id]; if (!b) problems.push([e.key, 'not in mobile layout']); else for (const k of ['x', 'y', 'width']) if (Math.abs(b[k] - e.mobile[k]) > 2) problems.push([e.key, 'mobile ' + k, e.mobile[k], b[k]]); }
-}
-await A.site.save();
-return { desktop: { box: d.box, overlaps: d.overlaps }, mobile: { box: m.box, overlaps: m.overlaps }, problems: problems.slice(0, 120), problemCount: problems.length, publishedAfter: (await A.site.getStatus()).isPublished };`);
-const problems = back.problems;
-const ok = back.problemCount === 0 && back.desktop.overlaps === 0 && back.mobile.overlaps === 0 && desk.off.length === 0 && mobile.off.length === 0;
-state.publishedAfter = back.publishedAfter;
-if (ok) { state.deployedAt = new Date().toISOString(); delete state.lastFailedAt; } else state.lastFailedAt = new Date().toISOString();
-saveState();
-const report = { ok, openItems: openItems(desc), pendingItems: pendingItems(desc), sectionId: state.sectionId, components: Object.keys(state.ids).length, editorCalls: timings.length, ms: timings, desktop: { passes: desk.passes, box: back.desktop.box, overlaps: back.desktop.overlaps, stillOff: desk.off.length, pins: desk.pins }, mobile: { passes: mobile.passes, box: back.mobile.box, overlaps: back.mobile.overlaps, stillOff: mobile.off.length }, problemCount: back.problemCount, problems, publishedBefore: state.publishedBefore, publishedAfter: back.publishedAfter };
-fs.writeFileSync(descFile.replace(/\.json$/, '') + '.deploy-report.json', JSON.stringify(report, null, 1));
-console.log(JSON.stringify(report));
-await browser.close();
-if (!ok) { console.error(`deploy NOT clean: ${back.problemCount} read-back differences, overlaps desktop ${back.desktop.overlaps} / mobile ${back.mobile.overlaps}, still off ${desk.off.length}/${mobile.off.length}. See ${descFile.replace(/\.json$/, '')}.deploy-report.json; fix and re-run (no --clean), or --reapply.`); process.exit(1); }

package/skills/wix-harmony-editor/scripts/copy/desc-hash.mjs

@@ -1,44 +0,0 @@
-// Content hash of a page description, ignoring the check stamp itself. check-description.mjs
-// writes it when (and only when) the check passed; deploy-description.mjs recomputes it, so a
-// description that failed its check, or was edited after it, is refused.
-import crypto from 'crypto';
-
-export const descHash = (desc) => {
-  const { checkedAt, checkedHash, ...rest } = desc;
-  return crypto.createHash('sha256').update(JSON.stringify(rest)).digest('hex');
-};
-
-// Links that still point at the source site: the cutover hand-off.
-// Component links marked sourcePage, and inline <a href> inside rich text (those stay inline, so
-// they never get a `link`) whose URL is on the source origin (desc.source.url).
-export const openItems = (desc) => {
-  const urls = new Map();
-  const add = (u, k) => { const l = urls.get(u) || urls.set(u, []).get(u); if (!l.includes(k)) l.push(k); };
-  let origin = null; try { origin = new URL(desc.source?.url).origin; } catch {}
-  for (const c of desc.components || []) {
-    if (c.link?.sourcePage) add(c.link.url, c.key);
-    if (origin && c.html) for (const m of c.html.matchAll(/<a\b[^>]*\bhref="([^"]+)"/g)) { const u = m[1].replace(/&amp;/g, '&'); if (u === origin || u.startsWith(origin + '/') || u.startsWith(origin + '?')) add(u, c.key); }
-  }
-  return [...urls].map(([url, keys]) => ({ type: 'links-to-old-site', url, components: keys, action: 'copy that page to Harmony or repoint the link; resolved when no link marked sourcePage remains' }));
-};
-
-// Pages the new site does not have yet. A link whose linkmap entry says `unbuilt` points at a stand-in
-// page (Home, the cart) so the visitor is never sent to the old site, but the page is still missing:
-// it stays here, with the source URL, until the entry stops saying `unbuilt` (the real page is mapped).
-// A redirect to an existing page never resolves it. Reasons and components come from the description,
-// so the hand-off cannot drift from the links.
-export const pendingItems = (desc) => {
-  const by = new Map();
-  const add = (u, reason, redirectedTo, key) => { const e = by.get(u) || by.set(u, { reason, redirectedTo, keys: [] }).get(u); if (!e.keys.includes(key)) e.keys.push(key); };
-  const to = (l) => (l ? (l.pageId ? `page ${l.pageId}${l.innerRoute ? '/' + l.innerRoute : ''}` : l.url || l.type) : 'inline URL');
-  for (const c of desc.components || []) {
-    if (c.link?.unbuilt) add(c.link.unbuilt.url, c.link.unbuilt.reason, to(c.link), c.key);
-    for (const u of c.unbuiltInline || []) add(u.url, u.reason, u.standIn || 'inline URL', c.key);
-  }
-  return [...by].map(([url, e]) => ({
-    type: 'page-not-built', url, reason: e.reason, standInFor: e.redirectedTo, components: e.keys,
-    responsibleRole: 'Cutover Operator (page content: site owner)',
-    action: 'build this page in Harmony or confirm it is intentionally dropped, then map its source URL to the real page in the linkmap (without `unbuilt`) and re-run build-description',
-    resolvedBy: 'the source URL maps to a real page in the linkmap; a link that only points at a stand-in page (Home, cart) does not resolve it',
-  }));
-};

package/skills/wix-harmony-editor/scripts/copy/editor-run.mjs

@@ -1,45 +0,0 @@
-#!/usr/bin/env node
-// Run one editor-API snippet from a file in the open Harmony editor and print its result.
-//
-//   node scripts/copy/editor-run.mjs <snippet.js> [--site <metaSiteId>] [--max 20000] [--capabilities caps.json]
-//
-// The snippet is the body of an async function with `editorLLMApis` in scope; `return`
-// its result. Keeping snippets in files avoids shell-quoting bugs and leaves a replayable
-// record of every write. Prints the parsed `result` on success, or the editor's failure
-// summary (which lists completed writes: never re-run those, continue from the failed call).
-import { chromium } from 'playwright';
-import { hideScrollbars } from './hide-scrollbars.mjs';
-import fs from 'fs';
-
-const args = process.argv.slice(2);
-const opt = (name, dflt) => { const i = args.indexOf(`--${name}`); return i >= 0 ? args[i + 1] : dflt; };
-const file = args.find((a, i) => !a.startsWith('--') && !(i > 0 && args[i - 1].startsWith('--')));
-if (!file) { console.error('usage: editor-run.mjs <snippet.js> [--site <metaSiteId>] [--max 20000]'); process.exit(2); }
-const site = opt('site', null);
-const max = Number(opt('max', 20000));
-// lint the snippet against the editor's API list before sending (compliance guard 1b)
-const capsFile = opt('capabilities', process.env.HARMONY_CAPABILITIES || null);
-if (capsFile) {
-  const { lintApi } = await import('./lint-api.mjs');
-  const { problems } = lintApi(fs.readFileSync(file, 'utf8'), JSON.parse(fs.readFileSync(capsFile, 'utf8')), file, { snippet: true });
-  for (const p of problems) console.error(`ERROR ${p.at}: ${p.error || p.warning}`);
-  if (problems.some((p) => p.error)) { console.error('Not sent: fix the unknown API calls or non-API operations (or refresh the snapshot).'); process.exit(4); }
-} else console.error('note: no --capabilities / HARMONY_CAPABILITIES given: the snippet is not linted against the editor API list');
-
-const browser = await chromium.connectOverCDP(`http://127.0.0.1:${process.env.PW_PORT || 9333}`);
-const page = browser.contexts().flatMap((c) => c.pages())
-  .find((p) => p.url().includes('editor.wix.com/edit/') && (!site || p.url().includes(site)));
-if (!page) { console.error('No authenticated Harmony editor page is open' + (site ? ` for ${site}` : '') + '.'); process.exit(3); }
-await hideScrollbars(page); // canvas widths must not depend on the OS scrollbar setting
-const raw = await page.evaluate(async (code) => {
-  const api = await repluggableAppDebug.host.getAPI({ name: 'RunEditorLLMCodeToolAPI', public: true, layer: 'DATA_SERVICE' });
-  try { return await api.execute({ code }, { biParams: {} }); } catch (e) { return { thrown: String((e && e.message) || e) }; }
-}, fs.readFileSync(file, 'utf8'));
-let printed;
-try {
-  const content = JSON.parse(raw.items[0].content);
-  printed = content.success ? content.result : { success: false, summary: content.summary, completedCalls: content.completedCalls, failedCall: content.failedCall };
-} catch { printed = raw; }
-const text = typeof printed === 'string' ? printed : JSON.stringify(printed);
-console.log(text.length > max ? `${text.slice(0, max)}\n...[truncated ${text.length - max} chars]` : text);
-await browser.close();

package/skills/wix-harmony-editor/scripts/copy/export-page.mjs

@@ -1,53 +0,0 @@
-#!/usr/bin/env node
-// Export a copied Harmony page as RECIPES for build-description.mjs: every child of one
-// section (type, label, styles, content, rich-text HTML, desktop and mobile boxes) plus the
-// page's pinned components. A later page reuses these looks for the same texts and images
-// (nav, tabs, side notes, footer), so a recipe verified once is never re-styled by hand.
-//
-//   node scripts/copy/export-page.mjs <pageId> <sectionId> <out.json> [--batch 10]
-//
-// Read only. Results are fetched in batches: an editor result over ~50 KB comes back truncated.
-import { chromium } from 'playwright';
-import { hideScrollbars } from './hide-scrollbars.mjs';
-import fs from 'fs';
-
-const args = process.argv.slice(2);
-const opt = (n, d) => { const i = args.indexOf(`--${n}`); return i >= 0 ? args[i + 1] : d; };
-const [pageId, sectionId, out] = args.filter((a, i) => !a.startsWith('--') && !(i > 0 && args[i - 1].startsWith('--')));
-if (!pageId || !sectionId || !out) { console.error('usage: export-page.mjs <pageId> <sectionId> <out.json> [--batch 10]'); process.exit(2); }
-const batch = Number(opt('batch', 10));
-const b = await chromium.connectOverCDP(`http://127.0.0.1:${process.env.PW_PORT || 9333}`);
-const p = b.contexts().flatMap((c) => c.pages()).find((x) => x.url().includes('editor.wix.com/edit/'));
-if (!p) { console.error('No Harmony editor page is open.'); process.exit(3); }
-await hideScrollbars(p); // canvas widths must not depend on the OS scrollbar setting
-const run = async (code) => { const r = await p.evaluate(async (code) => { const a = await repluggableAppDebug.host.getAPI({ name: 'RunEditorLLMCodeToolAPI', public: true, layer: 'DATA_SERVICE' }); return a.execute({ code }, { biParams: {} }); }, code); const c = JSON.parse(r.items[0].content); if (!c.success) throw new Error(c.summary); return c.result; };
-const J = JSON.stringify;
-const prelude = `const A = editorLLMApis;
-const slim = (els) => els.map((e) => ({ path: e.elementPath, el: e.element, props: Object.fromEntries(Object.entries(e.properties).filter(([k, v]) => v && v.raw != null && v.raw !== '').map(([k, v]) => [k, v.raw])) })).filter((e) => Object.keys(e.props).length);
-const one = async (id, type, label, box, sizing) => { const it = { id, label, type, desktop: box, sizing };
-  try { it.styles = slim((await A.appearance.getStyles({ componentId: id })).elements); } catch (e) {}
-  try { const v = await A.content.get({ componentId: id }); it.content = v.values ?? v.value; } catch (e) {}
-  if (/RichText/.test(type)) { try { it.html = (await A.richText.getText({ componentId: id })).text; } catch (e) {} }
-  try { const pin = await A.layout.getPinToScreen({ componentId: id }); if (pin && pin.pinned) it.pin = pin; } catch (e) {}
-  return it; };
-await A.pages.navigate({ pageId: ${J(pageId)} }); await A.breakpoints.toggle({ device: 'desktop' });`;
-
-const head = await run(`${prelude}
-const d = await A.layout.getComposition({ componentId: ${J(sectionId)} });
-const bg = await A.appearance.getContainerBackground({ componentId: ${J(sectionId)} });
-await A.breakpoints.toggle({ device: 'mobile' }); const m = await A.layout.getComposition({ componentId: ${J(sectionId)} }); await A.breakpoints.toggle({ device: 'desktop' });
-const pinned = []; for (const t of ['wixEditorElements.Button']) { const f = await A.components.find({ type: t, pageId: ${J(pageId)}, limit: 200 }); for (const c of f.components) { const g = await A.components.get({ componentId: c.id }); if (g.parentId === ${J(pageId)}) pinned.push(c.id); } }
-return { ids: d.children.map((k) => k.componentId), section: { id: ${J(sectionId)}, box: d.box, mobileBox: m.box, mobileHidden: m.notVisible || [], background: bg.background && bg.background.fields.map((f) => ({ key: f.key, value: f.value })) }, mobile: Object.fromEntries(m.children.map((k) => [k.componentId, k.box])), pinned };`);
-const components = [];
-for (let i = 0; i < head.ids.length; i += batch) {
-  const part = await run(`${prelude}
-const d = await A.layout.getComposition({ componentId: ${J(sectionId)} }); const want = new Set(${J(head.ids.slice(i, i + batch))}); const out = [];
-for (const c of d.children) if (want.has(c.componentId)) out.push(await one(c.componentId, c.type, c.label, c.box, c.sizing));
-return out;`);
-  components.push(...part);
-}
-for (const id of head.pinned) components.push(await run(`${prelude} const m = await A.layout.measure({ componentId: ${J(id)} }); const g = await A.components.get({ componentId: ${J(id)} }); const it = await one(${J(id)}, g.type, g.label, m.onPage, null); it.parent = 'page'; return it;`));
-for (const c of components) c.mobile = head.mobile[c.id] || null;
-fs.writeFileSync(out, JSON.stringify({ exportedAt: new Date().toISOString(), pageId, total: components.length, section: head.section, components }, null, 1));
-console.log(JSON.stringify({ out, components: components.length, pinned: head.pinned.length }));
-await b.close();

package/skills/wix-harmony-editor/scripts/copy/find-interactions.mjs

@@ -1,76 +0,0 @@
-#!/usr/bin/env node
-// Find what a visitor can DO on the source page, and capture every state it can show.
-//
-//   node scripts/copy/find-interactions.mjs <url> <out.json> [--width 1280] [--shots <dir>]
-//
-// A static screenshot only shows the default state. Tabs, accordions, "read more" toggles,
-// carousels and menus hide content that never reaches the measurement, the plate or the copy
-// (a whole second tab of price tiles was missing from a copy until a person clicked it).
-// This script lists the controls and, for each, clicks it and records what appears.
-//
-// A <details><summary> disclosure needs no id: the summary's own <details> is its pane (hidden while !details.open).
-// Controls found: role=tab and [data-toggle=tab|pill] / [data-bs-toggle=tab], [aria-controls] with
-// [aria-expanded], [data-toggle=collapse], <details>/<summary>, carousel arrows (.slick-next,
-// .swiper-button-next, [class*=next]), and links to in-page ids (#id) whose target is hidden.
-// Per control the output has: kind, label, target pane id, whether the pane is hidden by default,
-// and for each state the pane's images, links and text, plus a screenshot of the region.
-// Map each kind to a Wix component (COPY-SITE item 17): tabs -> Tabs, accordion -> Accordion,
-// carousel -> Slideshow or the Stores slider gallery, hover/dropdown -> Menu, dialog -> Popup.
-//
-// Clicks are dispatched in the page (el.click()), so a consent dialog or a sticky bar covering the
-// control does not block them. The page is never submitted anywhere: forms are not touched.
-import { chromium } from 'playwright';
-import fs from 'fs';
-
-const args = process.argv.slice(2);
-const opt = (n, d) => { const i = args.indexOf(`--${n}`); return i >= 0 ? args[i + 1] : d; };
-const [url, out] = args.filter((a, i) => !a.startsWith('--') && !(i > 0 && args[i - 1].startsWith('--')));
-if (!url || !out) { console.error('usage: find-interactions.mjs <url> <out.json> [--width 1280] [--shots dir]'); process.exit(2); }
-const width = Number(opt('width', 1280)); const shots = opt('shots', null);
-if (shots) fs.mkdirSync(shots, { recursive: true });
-
-const browser = await chromium.launch();
-const page = await browser.newPage({ viewport: { width, height: 900 } });
-await page.goto(url, { waitUntil: 'networkidle', timeout: 90000 }).catch(() => {});
-await page.waitForTimeout(2500);
-
-const SEL = '[role=tab], [data-toggle=tab], [data-toggle=pill], [data-bs-toggle=tab], [data-toggle=collapse], [data-bs-toggle=collapse], summary, [aria-expanded][aria-controls], .slick-next, .swiper-button-next, button[class*=next], a[href^="#"]:not([href="#"])';
-const controls = await page.evaluate((SEL) => {
-  const vis = (e) => { const r = e.getBoundingClientRect(); const cs = getComputedStyle(e); return r.width > 4 && r.height > 4 && cs.visibility !== 'hidden' && cs.display !== 'none'; };
-  const paneOf = (e) => { if (e.tagName === 'SUMMARY' && e.parentElement && e.parentElement.tagName === 'DETAILS') return e.parentElement; const t = idOf(e); return t ? document.getElementById(t) : null; };
-  const idOf = (e) => { const h = e.getAttribute('href') || e.getAttribute('data-target') || e.getAttribute('data-bs-target') || ''; const m = h.match(/^#(.+)$/); return e.getAttribute('aria-controls') || (m ? m[1] : null); };
-  let n = 0; const seen = new Set(); const out = [];
-  for (const e of document.querySelectorAll(SEL)) {
-    if (!vis(e)) continue; const target = idOf(e); const pane = paneOf(e);
-    if (/^#/.test(e.getAttribute('href') || '') && !pane) continue; // an anchor to nowhere
-    const key = (target || (pane && pane.tagName === 'DETAILS' ? 'details' : '')) + '|' + (e.innerText || '').trim().slice(0, 40) + '|' + e.tagName; if (seen.has(key)) continue; seen.add(key);
-    e.setAttribute('data-hz-ctl', String(n)); const r = e.getBoundingClientRect();
-    const pane2 = paneOf(e); if (pane2) pane2.setAttribute('data-hz-pane', String(n));
-    const isDetails = !!pane2 && pane2.tagName === 'DETAILS';
-    const kind = e.matches('[role=tab],[data-toggle=tab],[data-toggle=pill],[data-bs-toggle=tab]') ? 'tab' : e.matches('[data-toggle=collapse],[data-bs-toggle=collapse],summary,[aria-expanded]') ? 'accordion' : e.matches('.slick-next,.swiper-button-next,button[class*=next]') ? 'carousel' : 'anchor-target';
-    out.push({ n: n++, kind, label: (e.innerText || e.getAttribute('aria-label') || '').trim().replace(/\s+/g, ' ').slice(0, 60), target, hiddenByDefault: pane ? (pane.tagName === 'DETAILS' ? !pane.open : (pane.getBoundingClientRect().height === 0 || getComputedStyle(pane).display === 'none')) : null, hasPane: !!pane, native: isDetails ? 'details' : null, box: [Math.round(r.left), Math.round(r.top + scrollY), Math.round(r.width), Math.round(r.height)] });
-  }
-  return out;
-}, SEL);
-
-const snap = (n) => page.evaluate((n) => {
-  const el = document.querySelector(`[data-hz-pane="${n}"]`); if (!el) return null;
-  return { open: el.tagName === 'DETAILS' ? el.open : undefined, images: [...el.querySelectorAll('img')].map((i) => (i.currentSrc || i.src || '').replace(/^https?:\/\/[^/]+/, '').slice(0, 200)), links: [...el.querySelectorAll('a[href]')].map((a) => a.getAttribute('href')).slice(0, 40), text: el.innerText.trim().replace(/\s+/g, ' ').slice(0, 400), shown: el.tagName === 'DETAILS' ? el.open : (el.getBoundingClientRect().height > 0 && getComputedStyle(el).display !== 'none'), h: Math.round(el.getBoundingClientRect().height) };
-}, n);
-
-const result = [];
-for (const c of controls) {
-  const entry = { ...c, states: [] };
-  if (c.kind === 'carousel') { result.push(entry); continue; } // arrows: the copy uses a slider component; the items are in the page already
-  entry.states.push({ state: 'before', ...(await snap(c.n)) });
-  await page.evaluate((n) => document.querySelector(`[data-hz-ctl="${n}"]`).click(), c.n).catch(() => {});
-  await page.waitForTimeout(900);
-  const after = await snap(c.n); entry.states.push({ state: 'after click', ...after });
-  if (shots && c.hasPane) { const f = `${shots}/ctl-${c.n}-${c.kind}.png`; const l = page.locator(`[data-hz-pane="${c.n}"]`); await l.screenshot({ path: f }).catch(() => {}); entry.shot = f; }
-  result.push(entry);
-}
-// a toggled control may be a pair (open and close): leave nothing assumed, record what was clicked
-fs.writeFileSync(out, JSON.stringify({ url, width, controls: result }, null, 1));
-const byKind = result.reduce((m, c) => ((m[c.kind] = (m[c.kind] || 0) + 1), m), {});
-console.log(JSON.stringify({ controls: result.length, byKind, hiddenPanes: result.filter((c) => c.hiddenByDefault).map((c) => `${c.kind}: ${c.label} -> ${c.native === 'details' ? '<details>' : '#' + c.target}`) }, null, 1));
-await browser.close();

package/skills/wix-harmony-editor/scripts/copy/hide-scrollbars.mjs

@@ -1,16 +0,0 @@
-// Make the editor's canvas widths independent of the OS scrollbar setting.
-// With classic (always visible) scrollbars the stage loses 15 px: a desktop section reads 1265
-// instead of 1280 and a mobile one 375 instead of 390, so every composition lands off and a
-// deploy reports dozens of differences. Hiding scrollbars over CDP fixes that, but only while
-// the CDP session stays attached, so each script that reads or writes layout calls this itself.
-// The editor re-measures on a breakpoint switch, which is done here.
-export async function hideScrollbars(page) {
-  const cdp = await page.context().newCDPSession(page);
-  await cdp.send('Emulation.setScrollbarsHidden', { hidden: true });
-  await page.waitForTimeout(500);
-  await page.evaluate(async () => {
-    const api = await repluggableAppDebug.host.getAPI({ name: 'RunEditorLLMCodeToolAPI', public: true, layer: 'DATA_SERVICE' });
-    await api.execute({ code: 'await editorLLMApis.breakpoints.toggle({ device: "mobile" }); await editorLLMApis.breakpoints.toggle({ device: "desktop" }); return true;' }, { biParams: {} });
-  });
-  return cdp;
-}

package/skills/wix-harmony-editor/scripts/copy/import-media.mjs

@@ -1,150 +0,0 @@
-#!/usr/bin/env node
-// Import the public source images a page description needs into the site's media, and write
-// the Harmony uris back into the description. REST only (no editor), so it runs in parallel
-// with the plate upload and font uploads.
-//
-//   node scripts/copy/import-media.mjs <migrationProjectDir> <page.desc.json> [--ledger media-ledger.json]
-//
-// Reads WIX_SITE_ID and WIX_AUTH_TOKEN from <project>/config/wix.env (mint it first with
-// scripts/mint-token.sh; it expires) and never prints them. Idempotent: a source URL already in
-// the ledger is not imported again. If the full-size original has a different aspect ratio
-// than the size the source page rendered (WordPress crops thumbnails), the rendered file is
-// imported instead, so `fitWidth` keeps the source's height.
-//
-// Source URLs come from the page being copied, so Wix is never asked to fetch them: this script
-// downloads each image itself (https only, no credentials or custom port; the host must resolve to
-// public addresses, the connection is pinned to the address it validated, every redirect hop is
-// re-checked, the size is capped) and uploads the bytes through Media's Generate File Upload URL.
-// A URL that fails a check is reported as an import error, not fetched. There is no fallback to
-// Media's server-side `files/import`: that would hand an untrusted URL to Wix to fetch.
-import dns from 'node:dns/promises';
-import https from 'node:https';
-import fs from 'fs';
-import path from 'path';
-
-const args = process.argv.slice(2);
-const opt = (n, d) => { const i = args.indexOf(`--${n}`); return i >= 0 ? args[i + 1] : d; };
-const [projectDir, descFile] = args.filter((a, i) => !a.startsWith('--') && !(i > 0 && args[i - 1] === '--ledger'));
-if (!projectDir || !descFile) { console.error('usage: import-media.mjs <projectDir> <page.desc.json> [--ledger file]'); process.exit(2); }
-const env = Object.fromEntries(fs.readFileSync(path.join(projectDir, 'config/wix.env'), 'utf8').split('\n').filter((l) => l.includes('=')).map((l) => [l.slice(0, l.indexOf('=')), l.slice(l.indexOf('=') + 1).trim()]));
-const auth = /^IST\./.test(env.WIX_AUTH_TOKEN) ? env.WIX_AUTH_TOKEN : `Bearer ${env.WIX_AUTH_TOKEN}`;
-const headers = { Authorization: auth, 'Content-Type': 'application/json', 'wix-site-id': env.WIX_SITE_ID };
-const ledgerFile = opt('ledger', path.join(path.dirname(descFile), 'media-ledger.json'));
-const ledger = fs.existsSync(ledgerFile) ? JSON.parse(fs.readFileSync(ledgerFile, 'utf8')) : {};
-const desc = JSON.parse(fs.readFileSync(descFile, 'utf8'));
-const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
-
-const PRIVATE_V4 = [/^10\./, /^127\./, /^169\.254\./, /^192\.168\./, /^172\.(1[6-9]|2\d|3[01])\./, /^0\./, /^100\.(6[4-9]|[7-9]\d|1[01]\d|12[0-7])\./];
-function isPrivateAddress(address) {
-  let a = String(address || '').toLowerCase().replace(/^\[|\]$/g, '');
-  const dotted = a.match(/^::ffff:(\d{1,3}(?:\.\d{1,3}){3})$/);
-  if (dotted) a = dotted[1];
-  const hex = a.match(/^::ffff:([0-9a-f]{1,4}):([0-9a-f]{1,4})$/);
-  if (hex) { const hi = parseInt(hex[1], 16), lo = parseInt(hex[2], 16); a = [hi >> 8, hi & 255, lo >> 8, lo & 255].join('.'); }
-  if (a === 'localhost' || a.endsWith('.localhost') || a.endsWith('.local')) return true;
-  if (a === '::1' || a === '::' || a.startsWith('fc') || a.startsWith('fd') || a.startsWith('fe80')) return true;
-  return PRIVATE_V4.some((re) => re.test(a));
-}
-const MAX_IMAGE_BYTES = 25 * 1024 * 1024;
-// One GET pinned to an address we already validated; TLS still verifies the certificate against the hostname.
-function pinnedGet(url, { address, family }) {
-  const u = new URL(url);
-  return new Promise((resolve, reject) => {
-    let settled = false;
-    const done = (fn, v) => { if (!settled) { settled = true; fn(v); } };
-    const req = https.request({
-      protocol: 'https:', hostname: u.hostname, port: 443, path: `${u.pathname}${u.search}`, method: 'GET', servername: u.hostname, timeout: 20000,
-      headers: { Accept: 'image/*,*/*', 'Accept-Encoding': 'identity', 'User-Agent': 'wix-harmony-copy-import-media' },
-      lookup: (h, o, cb) => (o && o.all ? cb(null, [{ address, family }]) : cb(null, address, family)),
-    }, (res) => {
-      const status = res.statusCode || 0;
-      if (status >= 300 && status < 400) { res.resume(); return done(resolve, { status, location: res.headers.location || '', body: Buffer.alloc(0) }); }
-      const declared = Number(res.headers['content-length']);
-      if (Number.isFinite(declared) && declared > MAX_IMAGE_BYTES) { res.destroy(); return done(reject, new Error('response-too-large')); }
-      const chunks = []; let total = 0;
-      res.on('data', (c) => { total += c.length; if (total > MAX_IMAGE_BYTES) { res.destroy(); return done(reject, new Error('response-too-large')); } chunks.push(c); });
-      res.on('end', () => done(resolve, { status, type: String(res.headers['content-type'] || '').split(';')[0].trim().toLowerCase(), body: Buffer.concat(chunks) }));
-      res.on('error', (e) => done(reject, e));
-    });
-    req.on('timeout', () => { req.destroy(); done(reject, new Error('timeout')); });
-    req.on('error', (e) => done(reject, e));
-    req.end();
-  });
-}
-// { ok: true, bytes, contentType } | { ok: false, unsafe, reason }
-async function fetchPublicImage(raw) {
-  let current = String(raw || '').trim();
-  for (let hop = 0; hop <= 3; hop++) {
-    let u; try { u = new URL(current); } catch { return { ok: false, unsafe: true, reason: 'unparseable-url' }; }
-    if (u.protocol !== 'https:') return { ok: false, unsafe: true, reason: 'not-https' };
-    if (u.username || u.password) return { ok: false, unsafe: true, reason: 'embedded-credentials' };
-    if (u.port && u.port !== '443') return { ok: false, unsafe: true, reason: 'non-standard-port' };
-    if (isPrivateAddress(u.hostname)) return { ok: false, unsafe: true, reason: 'private-or-loopback-host' };
-    let addrs; try { addrs = await dns.lookup(u.hostname, { all: true }); } catch { return { ok: false, unsafe: false, reason: 'host-not-resolvable' }; }
-    if (!addrs.length || addrs.some((x) => isPrivateAddress(x.address))) return { ok: false, unsafe: true, reason: 'resolves-to-private-address' };
-    let res; try { res = await pinnedGet(current, { address: addrs[0].address, family: addrs[0].family || (addrs[0].address.includes(':') ? 6 : 4) }); } catch (e) { return { ok: false, unsafe: false, reason: e.message === 'response-too-large' ? 'response-too-large' : 'unreachable' }; }
-    if (res.status >= 300 && res.status < 400) {
-      if (!res.location) return { ok: false, unsafe: true, reason: 'redirect-without-location' };
-      try { current = new URL(res.location, current).toString(); } catch { return { ok: false, unsafe: true, reason: 'redirect-unparseable-url' }; }
-      continue;
-    }
-    if (res.status < 200 || res.status >= 300) return { ok: false, unsafe: false, reason: `http-${res.status}` };
-    if (!res.body.length) return { ok: false, unsafe: false, reason: 'empty-image' };
-    return { ok: true, bytes: res.body, contentType: res.type };
-  }
-  return { ok: false, unsafe: true, reason: 'too-many-redirects' };
-}
-
-async function importOne(url) {
-  if (ledger[url]?.uri) return ledger[url];
-  const fetched = await fetchPublicImage(url);
-  if (!fetched.ok) return { error: `${fetched.unsafe ? 'unsafe-source-url' : 'source-fetch-failed'}: ${fetched.reason}` };
-  if (!/^image\//.test(fetched.contentType || '')) return { error: `source-fetch-failed: not-an-image (${fetched.contentType || 'no content-type'})` };
-  // Generate File Upload URL rejects a MIME type that does not match the file name's extension
-  // (MISMATCH_MIME_TYPE). The URL's own extension can lie (a .jpg served as WebP) or be missing, so
-  // the name's extension is derived from the type the server actually sent.
-  const extensions = { 'image/jpeg': '.jpg', 'image/png': '.png', 'image/gif': '.gif', 'image/webp': '.webp', 'image/avif': '.avif', 'image/svg+xml': '.svg' };
-  const extension = extensions[fetched.contentType];
-  if (!extension) return { error: `source-fetch-failed: unsupported-image-type (${fetched.contentType})` };
-  const stem = url.split('/').pop().split('?')[0].replace(/\.[A-Za-z0-9]+$/, '').replace(/[^\w.~-]+/g, '-').slice(0, 80) || 'image';
-  const name = `${stem}${extension}`;
-  const mimeType = fetched.contentType;
-  // Upload the bytes we fetched; Wix is never given the source URL.
-  const gen = await fetch('https://www.wixapis.com/site-media/v1/files/generate-upload-url', { method: 'POST', headers, body: JSON.stringify({ mimeType: fetched.contentType, fileName: name, sizeInBytes: String(fetched.bytes.length), externalInfo: { origin: 'site-copy' } }) });
-  const g0 = await gen.json().catch(() => ({}));
-  let file;
-  if (gen.ok && g0.uploadUrl) {
-    const target = new URL(g0.uploadUrl); target.searchParams.set('filename', name);
-    const put = await fetch(target, { method: 'PUT', headers: { 'Content-Type': fetched.contentType }, body: fetched.bytes });
-    const pj = await put.json().catch(() => ({}));
-    if (!put.ok || !pj.file) return { error: `upload-failed: ${put.status}`, body: JSON.stringify(pj).slice(0, 200) };
-    file = pj.file;
-  } else {
-    return { error: `upload-url-refused: ${gen.status}`, body: JSON.stringify(g0).slice(0, 200) };
-  }
-  const e = { id: file.id, uri: file.id, name };
-  let ready = false;
-  for (let i = 0; i < 20; i++) {
-    const g = await fetch(`https://www.wixapis.com/site-media/v1/files/${encodeURIComponent(e.id)}`, { headers }).then((x) => x.json()).catch(() => ({}));
-    if (g.file?.operationStatus === 'READY') { ready = true; e.width = g.file.media?.image?.image?.width; e.height = g.file.media?.image?.image?.height; break; }
-    await sleep(1500);
-  }
-  if (!ready) return { error: 'import not READY after 30 s', id: e.id };
-  ledger[url] = e; fs.writeFileSync(ledgerFile, JSON.stringify(ledger, null, 1));
-  return e;
-}
-
-const jobs = desc.components.filter((c) => c.kind === 'image' && !c.image.uri && c.image.source);
-const results = await Promise.all(jobs.map(async (c) => {
-  let e = await importOne(c.image.source);
-  const want = c.desktop.width / c.desktop.height;
-  if (!e.uri || !e.width || Math.abs(e.width / e.height - want) / want > 0.01) { // cropped thumbnail on the source: use what it rendered
-    if (c.image.sourceRendered && c.image.sourceRendered !== c.image.source) e = await importOne(c.image.sourceRendered);
-  }
-  if (e.uri) Object.assign(c.image, { uri: e.uri, width: e.width, height: e.height, name: e.name });
-  return { key: c.key, uri: e.uri || null, size: e.width ? `${e.width}x${e.height}` : null, error: e.error || null };
-}));
-fs.writeFileSync(descFile, JSON.stringify(desc, null, 1));
-console.log(JSON.stringify(results));
-const failed = results.filter((r) => !r.uri || r.error);
-if (failed.length) { console.error(`import failed or not ready for: ${failed.map((r) => `${r.key} (${r.error || 'no uri'})`).join(', ')}`); process.exit(1); }