resopt-cli 0.8.0

Find, review and safely apply resource optimizations for Apple and Android projects.
Documentation
// Only one effect preview may own a decoder or an animation callback at a time.
let effectCleanup = null;
function stopEffectPlayback() { const cleanup = effectCleanup; effectCleanup = null; if (cleanup) cleanup(); }

function vapPlayer(r) {
  const info = r.vap, box = el('section', 'effect-player'), stage = el('div', 'effect-stage');
  box.setAttribute('aria-label', t('vapPlayer'));
  const canvas = el('canvas'); canvas.setAttribute('role', 'img'); canvas.setAttribute('aria-label', t('vapPlayer'));
  const scale = Math.min(1, 640 / Math.max(info.width, info.height));
  canvas.width = Math.max(1, Math.round(info.width * scale)); canvas.height = Math.max(1, Math.round(info.height * scale));
  const alpha = document.createElement('canvas'); alpha.width = canvas.width; alpha.height = canvas.height;
  const rgbContext = canvas.getContext('2d', { willReadFrequently: true }), alphaContext = alpha.getContext('2d', { willReadFrequently: true });
  const video = el('video'); video.hidden = true; video.muted = true; video.loop = true; video.playsInline = true; video.preload = 'auto';
  const controls = el('div', 'effect-controls'), toggle = el('button', '', t('animPlay')), slider = el('input'), label = el('span', 'hint');
  toggle.type = 'button'; toggle.disabled = true; slider.type = 'range'; slider.min = '0'; slider.max = String(info.frames - 1); slider.step = '1'; slider.value = '0'; slider.disabled = true; slider.setAttribute('aria-label', t('effectTimeline'));
  const status = el('p', 'hint', t('effectLoading'));
  stage.append(canvas); controls.append(toggle, slider, label); box.append(el('p', 'hint', t('animInfo', count(info.width), count(info.height), info.fps, count(info.frames))), stage, controls, status, video);
  if (info.dynamic_sources) box.append(el('p', 'status-warn', t('effectDynamic', count(info.dynamic_sources))));
  let disposed = false, callback = null, frameCallback = false, valid = false, objectUrl = null;
  const request = new AbortController();
  const fail = () => { if (disposed) return; valid = false; video.pause(); toggle.disabled = slider.disabled = true; status.textContent = t('effectUnavailable'); };
  const draw = () => {
    if (disposed || !valid || video.readyState < 2) return;
    try {
      rgbContext.drawImage(video, ...info.rgb_frame, 0, 0, canvas.width, canvas.height);
      alphaContext.drawImage(video, ...info.alpha_frame, 0, 0, canvas.width, canvas.height);
      const rgb = rgbContext.getImageData(0, 0, canvas.width, canvas.height), mask = alphaContext.getImageData(0, 0, canvas.width, canvas.height);
      applyVapAlpha(rgb.data, mask.data); rgbContext.putImageData(rgb, 0, 0);
      const frame = Math.min(info.frames - 1, Math.floor(video.currentTime * info.fps));
      slider.value = String(frame); label.textContent = t('animFrame', frame + 1, info.frames);
    } catch { fail(); }
  };
  const tick = () => {
    callback = null; if (disposed || video.paused || !valid) return;
    draw(); schedule();
  };
  const schedule = () => {
    if (disposed || callback !== null) return;
    frameCallback = typeof video.requestVideoFrameCallback === 'function';
    callback = frameCallback ? video.requestVideoFrameCallback(tick) : requestAnimationFrame(tick);
  };
  video.addEventListener('loadedmetadata', () => {
    if (disposed) return;
    if (video.videoWidth !== info.video_width || video.videoHeight !== info.video_height) return fail();
    valid = true; toggle.disabled = slider.disabled = false; status.textContent = t('effectPreviewNote');
    video.currentTime = Math.min((info.frames - 1) / info.fps / 3, video.duration / 3);
  });
  video.addEventListener('loadeddata', draw); video.addEventListener('seeked', draw); video.addEventListener('error', fail);
  toggle.addEventListener('click', async () => {
    if (video.paused) { try { await video.play(); if (!disposed) { toggle.textContent = t('animPause'); schedule(); } } catch { fail(); } }
    else { video.pause(); toggle.textContent = t('animPlay'); }
  });
  slider.addEventListener('input', () => { video.pause(); toggle.textContent = t('animPlay'); video.currentTime = Number(slider.value) / info.fps; });
  effectCleanup = () => {
    disposed = true; request.abort(); video.pause();
    if (callback !== null) { if (frameCallback) video.cancelVideoFrameCallback(callback); else cancelAnimationFrame(callback); }
    video.removeAttribute('src'); video.load(); if (objectUrl) URL.revokeObjectURL(objectUrl);
  };
  const src = assetUrl(r.original_artifact);
  // A bounded local blob stays seekable even when a static report host lacks Range.
  if (src) fetch(src, { signal: request.signal }).then(response => { if (!response.ok) throw new Error('media unavailable'); return response.blob(); }).then(blob => {
    if (disposed) return; if (blob.size > 64 * 1024 * 1024) return fail();
    objectUrl = URL.createObjectURL(blob); video.src = objectUrl;
  }).catch(fail); else fail();
  return box;
}

// The SDK lives in an opaque-origin sandbox. Only buffers and playback messages cross it.
function pagPlayer(r) {
  const box = el('section', 'effect-player'); box.setAttribute('aria-label', t('pagPlayer'));
  const facts = el('p', 'hint', t('pagDetected', String(r.resource.extension).toUpperCase())), stage = el('div', 'effect-stage'), frame = el('iframe');
  frame.title = t('pagPlayer'); frame.setAttribute('sandbox', 'allow-scripts'); frame.referrerPolicy = 'no-referrer';
  const controls = el('div', 'effect-controls'), toggle = el('button', '', t('animPlay')), slider = el('input'), label = el('span', 'hint');
  toggle.type = 'button'; toggle.disabled = true; slider.type = 'range'; slider.min = '0'; slider.max = '1'; slider.step = '1'; slider.value = '0'; slider.disabled = true; slider.setAttribute('aria-label', t('effectTimeline'));
  const status = el('p', 'hint', t('effectLoading')), license = el('a', 'link-button', t('pagLicense')); license.href = 'previews/0-libpag-license.txt'; license.target = '_blank'; license.rel = 'noopener';
  stage.append(frame); controls.append(toggle, slider, label); box.append(facts, stage, controls, status, license);
  let disposed = false, frames = 1, initialized = false;
  const request = new AbortController();
  const fail = () => { if (!disposed) { status.textContent = t('pagUnavailable'); toggle.disabled = slider.disabled = true; } };
  const send = message => frame.contentWindow?.postMessage(message, '*');
  const load = async () => {
    if (initialized || disposed) return; initialized = true;
    if (r.pag.runtime_version !== '4.3.51') return fail();
    const src = assetUrl(r.original_artifact); if (!src) return fail();
    const read = async (path, max) => {
      const response = await fetch(path, { signal: request.signal }); if (!response.ok) throw new Error('Missing artifact');
      const buffer = await response.arrayBuffer(); if (buffer.byteLength > max) throw new Error('Preview size limit'); return buffer;
    };
    try {
      const [source, wasm] = await Promise.all([read(src, 16 * 1024 * 1024), read('previews/0-libpag-4.3.51.wasm', 4 * 1024 * 1024)]);
      if (!disposed) frame.contentWindow.postMessage({ type: 'resopt-pag-init', source, wasm }, '*', [source, wasm]);
    } catch { fail(); }
  };
  const receive = event => {
    if (disposed || event.source !== frame.contentWindow || event.origin !== 'null') return;
    const data = event.data; if (!data || typeof data !== 'object') return;
    if (data.type === 'resopt-pag-loaded') void load();
    else if (data.type === 'resopt-pag-ready') {
      if (![data.width, data.height, data.frames, data.texts, data.images, data.videos].every(Number.isSafeInteger) || !Number.isFinite(data.fps) || data.frames < 1 || data.frames > 432000) return fail();
      frames = data.frames; slider.max = String(frames - 1); toggle.disabled = slider.disabled = false;
      facts.textContent = `${t('animInfo', count(data.width), count(data.height), data.fps, count(frames))} ยท ${t('pagContents', count(data.texts), count(data.images), count(data.videos))}`;
      status.textContent = t('pagPreviewNote');
    } else if (data.type === 'resopt-pag-progress' && Number.isInteger(data.frame) && data.frame >= 0 && data.frame < frames) {
      slider.value = String(data.frame); label.textContent = t('animFrame', data.frame + 1, frames); toggle.textContent = t(data.playing ? 'animPause' : 'animPlay');
    } else if (data.type === 'resopt-pag-error') fail();
  };
  window.addEventListener('message', receive);
  effectCleanup = () => { disposed = true; request.abort(); window.removeEventListener('message', receive); send({ type: 'resopt-pag-dispose' }); frame.remove(); };
  toggle.addEventListener('click', () => send({ type: 'resopt-pag-toggle' }));
  slider.addEventListener('input', () => send({ type: 'resopt-pag-seek', frame: Number(slider.value) }));
  frame.addEventListener('error', fail); frame.src = 'previews/0-pag-player.html';
  return box;
}