pandorga 1.12.0 → 1.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f0650221add1248fcfa882ccf2557c9d73d1de757239e6e396e8cec1ddefa512
-  data.tar.gz: 2c6502ac5c6fdd2d6153490b88925e465b7c66f315502e61819b6541e530831b
+  metadata.gz: c03095737ae31747d865ba734912bb725e2d88586405dd847c63d340b42bbfa3
+  data.tar.gz: 764bc60f9ef00c00e33391511a7cb5680438660dd5a622af0801add004670f31
 SHA512:
-  metadata.gz: 9123d4ada63311688340fa8da4076a898dfb362764d15030da03cd62776def8172e9be28fc9d7fe47005930c004565860f8997ca46050c7149eb76332c94fa6d
-  data.tar.gz: 6dbf48af21a4d6e56a0b21e070a951f8180424de1efbb906830d435200d736b4955781d0f04b3f7677be32cf1ce20a916bdad761faf41c6fd836ac48f06e1aa4
+  metadata.gz: 392a4fbde9ea59d1b7dfea8206f45c81f6d104d3b70efcb9a6c67afa21fc9738eefc589b537c8e045bdf7cdb13527ade3ec8c3a1d5683ff0c4f5134a72743dbc
+  data.tar.gz: 44b0d25b56e010e2ce1d2106c3a2c688a5b3ee61c322b55f39c89beca4d9821c31f5942de335f351289bab176a6752c809205ae7aae97f517351003eb71ce0a5

data/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [1.13.0] — 2026-10-19
+
+### Added
+
+- `pandorga export` and the new `pandorga thumbnails [root]` command write 16:9 center-cropped width variants (`variants/<stem>-{480,960,1440}.jpg`, progressive JPEG at quality 82, stripped of metadata, never upscaled) beside each local `/media/...` project thumbnail when ImageMagick is installed (logging one warning otherwise), export `thumbnail_srcset` on project front matter and `writing_index.json`, and render `srcset` and `sizes` on project cards and the home specimen (PLT-AC-44).
+
 ## [1.12.0] — 2026-10-19
 
 ### Changed

data/_includes/content-runtime/43-blocks.html

@@ -300,7 +300,7 @@
      *
      * A video URL still renders rather than vanishing, but it downloads
      * nothing until the reader asks for it. */
-    function renderPosterMedia(src, alt) {
+    function renderPosterMedia(src, alt, options) {
       var url = String(src || '').trim();
       if (!url) return '';
       var isVideo = /\.(mp4|webm|mov)(\?|#|$)/i.test(url);
@@ -312,9 +312,15 @@
           '</div>'
         ].join('');
       }
+      var opts = options || {};
+      var srcset = String(opts.srcset || '').trim();
+      var sizes = String(opts.sizes || '').trim();
       return [
         '<div class="ledger-poster">',
-        '<img src="', escapeAttr(url), '" alt="', escapeAttr(alt || ''),
+        '<img src="', escapeAttr(url), '"',
+        srcset ? ' srcset="' + escapeAttr(srcset) + '"' : '',
+        (srcset && sizes) ? ' sizes="' + escapeAttr(sizes) + '"' : '',
+        ' alt="', escapeAttr(alt || ''),
         '" loading="lazy" decoding="async"',
         // Thumbnails are frequently hotlinked to third-party hosts. When one
         // dies, remove the frame rather than leaving an empty plate behind.
@@ -324,6 +330,16 @@
       ].join('');
     }
 
+    /* Project thumbnail sizes (PLT-AC-44):
+     * - Home specimen (home.css PLT-AC-41): >= 900px column is max(35%, 20rem)
+     *   inside max-width 80rem (1408px at html 110%), minus card padding =>
+     *   ~431 CSS px at 1440px viewport (31vw = 446px -> 480w at DPR 1, 960w at
+     *   DPR 2); below 900px full band width (390px at DPR 2 = 780px -> 960w).
+     * - Projects grid card (projects.css): 3 cols >= 1024px (~384px -> 28vw),
+     *   2 cols >= 700px (~46vw), 1 col below (92vw). */
+    var PROJECT_CARD_SIZES = '(min-width: 1024px) 28vw, (min-width: 700px) 46vw, 92vw';
+    var HOME_SPECIMEN_SIZES = '(min-width: 900px) 31vw, 92vw';
+
     function twoDigits(value) {
       var label = String(Number(value));
       return label.length < 2 ? '0' + label : label;
@@ -418,7 +434,10 @@
       if (options.frameCorners) {
         html += '<span class="ledger-frame-corners" aria-hidden="true"></span>';
       }
-      var poster = renderPosterMedia(fm.thumbnail, name);
+      var poster = renderPosterMedia(fm.thumbnail, name, {
+        srcset: fm.thumbnail_srcset,
+        sizes: options.sizes || PROJECT_CARD_SIZES
+      });
       if (poster) {
         html += poster;
       } else if (options.glyphFallback && fm.icon) {
@@ -501,7 +520,10 @@
       var mark = fm.icon
         ? { cls: 'material-symbols-outlined', text: fm.icon }
         : { cls: 'is-initial', text: String(name || '').charAt(0).toUpperCase() };
-      var poster = renderPosterMedia(fm.thumbnail, name);
+      var poster = renderPosterMedia(fm.thumbnail, name, {
+        srcset: fm.thumbnail_srcset,
+        sizes: options.sizes || HOME_SPECIMEN_SIZES
+      });
       html += '<div class="home-specimen-figure">';
       if (poster) {
         html += poster + '<span class="home-specimen-badge ' + mark.cls + '" aria-hidden="true">' +

data/_includes/content-runtime/60-fragments.html

@@ -140,6 +140,7 @@
           description: entry.description,
           excerpt: entry.excerpt,
           thumbnail: entry.thumbnail,
+          thumbnail_srcset: entry.thumbnail_srcset,
           language: entry.language,
           date: entry.date,
           last_updated: entry.last_updated,

data/_layouts/projects.html

@@ -154,7 +154,13 @@ layout: shell
        imagery still reads as finished rather than as broken. */
     function plateHtml(item, modifier) {
       var fm = item.front_matter || {};
-      var poster = runtime.renderPosterMedia(fm.thumbnail, projectName(item));
+      var sizes = modifier === 'projects-plate--card'
+        ? '(min-width: 1024px) 28vw, (min-width: 700px) 46vw, 92vw'
+        : '(min-width: 900px) 38vw, 92vw';
+      var poster = runtime.renderPosterMedia(fm.thumbnail, projectName(item), {
+        srcset: fm.thumbnail_srcset,
+        sizes: sizes
+      });
       var cls = 'projects-plate' + (modifier ? ' ' + modifier : '');
       if (poster) return '<div class="' + cls + '">' + poster + '</div>';
       if (!fm.icon) return '';

data/lib/pandorga/cli.rb

@@ -7,6 +7,7 @@ require_relative "commands/publish"
 require_relative "commands/install_functions"
 require_relative "commands/studio_schema"
 require_relative "commands/new"
+require_relative "commands/thumbnails"
 
 module Pandorga
   # Dispatch for `exe/pandorga`.
@@ -18,7 +19,8 @@ module Pandorga
       "serve" => Commands::Serve,
       "publish" => Commands::Publish,
       "install-functions" => Commands::InstallFunctions,
-      "studio-schema" => Commands::StudioSchema
+      "studio-schema" => Commands::StudioSchema,
+      "thumbnails" => Commands::Thumbnails
     }.freeze
 
     module_function
@@ -52,6 +54,7 @@ module Pandorga
           pandorga new PATH               Scaffold a site from the minimal example
           pandorga doctor                 Check site config and environment
           pandorga export [src] [dest]    Export content collections to JSON
+          pandorga thumbnails [root]      Write 16:9 width variants for project thumbnails
           pandorga serve                  Local Jekyll serve with JSON re-export
           pandorga publish                Sync content JSON to R2
           pandorga install-functions      Copy functions/ and studio/ into site root

data/lib/pandorga/commands/new.rb

@@ -24,7 +24,7 @@ module Pandorga
 
         gem "pandorga", "~> 1.3"
         # Local checkout: gem "pandorga", path: "../pandorga"
-        # GitHub tag: gem "pandorga", github: "alexandrelheinen/pandorga", tag: "v1.12.0"
+        # GitHub tag: gem "pandorga", github: "alexandrelheinen/pandorga", tag: "v1.13.0"
         gem "csv"
         gem "base64"
       RUBY

data/lib/pandorga/commands/thumbnails.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require "pathname"
+require_relative "../thumbnail_variants"
+
+module Pandorga
+  module Commands
+    # Generate 16:9 center-cropped width variants for local project thumbnails.
+    # Refs: PLT-AC-44
+    class Thumbnails
+      def run(argv)
+        site_root = Pathname.new(argv[0] || Dir.pwd).expand_path
+        summary = Pandorga::ThumbnailVariants.generate(site_root)
+        puts "pandorga thumbnails: #{summary[:written]} written, #{summary[:skipped]} skipped (#{summary[:sources]} sources in #{site_root})"
+        0
+      end
+    end
+  end
+end

data/lib/pandorga/thumbnail_variants.rb

@@ -0,0 +1,267 @@
+# frozen_string_literal: true
+
+require "date"
+require "fileutils"
+require "open3"
+require "pathname"
+require "set"
+require "time"
+require "yaml"
+
+require_relative "registry"
+
+module Pandorga
+  # Generates 16:9 center-cropped width variants for local project thumbnails
+  # and computes their srcset strings.
+  # Refs: PLT-AC-44
+  module ThumbnailVariants
+    WIDTHS = [480, 960, 1440].freeze
+    IMAGE_EXTENSIONS = %w[.jpg .jpeg .png .webp].freeze
+    QUALITY = 82
+
+    module_function
+
+    def generate(site_root)
+      root = Pathname.new(site_root).expand_path
+      content_root = resolve_content_root(root)
+      sources = project_thumbnail_sources(root, content_root)
+
+      summary = { sources: sources.length, written: 0, skipped: 0, failed: 0 }
+      return summary if sources.empty?
+
+      bins = resolve_imagemagick
+      unless bins
+        warn "warning: ImageMagick (magick or convert) not found; skipping project thumbnail variants"
+        return summary
+      end
+
+      sources.each do |src|
+        src_width = identify_width(bins[:identify], src)
+        unless src_width && src_width.positive?
+          # An unreadable image keeps its original and must not stop the export.
+          warn "warning: cannot read #{src}; skipping its thumbnail variants"
+          summary[:failed] += 1
+          next
+        end
+
+        stem = src.basename(src.extname).to_s
+        variants_dir = src.dirname.join("variants")
+        src_mtime = src.mtime
+
+        WIDTHS.each do |width|
+          if width > src_width
+            summary[:skipped] += 1
+            next
+          end
+
+          dest = variants_dir.join("#{stem}-#{width}.jpg")
+          if dest.file? && dest.mtime >= src_mtime
+            summary[:skipped] += 1
+            next
+          end
+
+          begin
+            write_variant(bins[:convert], src, dest, width)
+            summary[:written] += 1
+          rescue StandardError => e
+            warn "warning: #{e.message.lines.first.to_s.strip}; keeping the original only"
+            summary[:failed] += 1
+          end
+        end
+      end
+
+      summary
+    end
+
+    def srcset_for(site_root, thumbnail_path)
+      media_rel = normalize_local_media_path(thumbnail_path)
+      return nil unless media_rel
+
+      ext = File.extname(media_rel).downcase
+      return nil unless IMAGE_EXTENSIONS.include?(ext)
+
+      root = Pathname.new(site_root).expand_path
+      content_root = resolve_content_root(root)
+      src = content_root.join(media_rel.delete_prefix("/"))
+      return nil unless src.file?
+
+      stem = src.basename(src.extname).to_s
+      variants_dir = src.dirname.join("variants")
+      return nil unless variants_dir.directory?
+
+      url_dir = File.dirname(media_rel)
+      parts = WIDTHS.filter_map do |width|
+        variant = variants_dir.join("#{stem}-#{width}.jpg")
+        next unless variant.file?
+
+        "#{url_dir}/variants/#{stem}-#{width}.jpg #{width}w"
+      end
+      return nil if parts.empty?
+
+      parts.join(", ")
+    end
+
+    def resolve_content_root(root)
+      candidate = root.join("content")
+      return candidate if candidate.directory?
+      return root if root.join("collections").directory? || root.join("media").directory?
+
+      candidate
+    end
+
+    def project_collections(root)
+      config_path = root.join("_config.yml")
+      config = if config_path.file?
+                 YAML.safe_load(config_path.read, permitted_classes: [Date, Time], aliases: true) || {}
+               else
+                 {}
+               end
+      pages = PandorgaRegistry.pages(config)
+      names = pages.filter_map do |page|
+        next unless page.is_a?(Hash) && page["template"].to_s == "portfolio"
+
+        col = page["collection"].to_s.strip
+        col = page.dig("collections", "projects").to_s.strip if col.empty? && page["collections"].is_a?(Hash)
+        col unless col.empty?
+      end.uniq
+      names.empty? ? ["projects"] : names
+    rescue StandardError
+      ["projects"]
+    end
+
+    def project_thumbnail_sources(root, content_root)
+      seen = Set.new
+      sources = []
+
+      project_collections(root).each do |collection|
+        dir = content_root.join("collections", collection)
+        next unless dir.directory?
+
+        dir.glob("**/*.{md,markdown}").sort.each do |md_path|
+          fm = read_front_matter(md_path)
+          next if fm["published"] == false && ENV["CONTENT_EXPORT_INCLUDE_UNPUBLISHED"] != "1"
+
+          media_rel = normalize_local_media_path(fm["thumbnail"])
+          next unless media_rel
+          next unless IMAGE_EXTENSIONS.include?(File.extname(media_rel).downcase)
+
+          src = content_root.join(media_rel.delete_prefix("/"))
+          next unless src.file?
+
+          key = src.expand_path.to_s
+          next if seen.include?(key)
+
+          seen << key
+          sources << src
+        end
+      end
+
+      sources
+    end
+
+    def normalize_local_media_path(path)
+      value = path.to_s.strip
+      return nil if value.empty?
+      return nil if value.match?(%r{\Ahttps?://}i)
+
+      if value.start_with?("/content/media/")
+        "/media/#{value.delete_prefix("/content/media/")}"
+      elsif value.start_with?("content/media/")
+        "/media/#{value.delete_prefix("content/media/")}"
+      elsif value.start_with?("/media/")
+        value
+      elsif value.start_with?("media/")
+        "/#{value}"
+      end
+    end
+
+    def read_front_matter(path)
+      text = path.read.sub(/\A\xEF\xBB\xBF/, "")
+      return {} unless text.start_with?("---\n") || text.start_with?("---\r\n")
+
+      parts = text.split(/^---\s*$\r?\n?/, 3)
+      return {} unless parts.length == 3
+
+      YAML.safe_load(parts[1], permitted_classes: [Date, Time], aliases: true) || {}
+    rescue StandardError
+      {}
+    end
+
+    def resolve_imagemagick
+      override = ENV["PANDORGA_IMAGEMAGICK"].to_s.strip
+      unless override.empty?
+        return nil unless executable_available?(override)
+
+        return {
+          convert: [override],
+          identify: File.basename(override) == "magick" ? [override, "identify"] : [ resolve_companion_identify(override) ]
+        }
+      end
+
+      if executable_available?("magick")
+        { convert: ["magick"], identify: ["magick", "identify"] }
+      elsif executable_available?("convert") && executable_available?("identify")
+        { convert: ["convert"], identify: ["identify"] }
+      end
+    end
+
+    def resolve_companion_identify(convert_bin)
+      sibling = File.join(File.dirname(convert_bin), "identify")
+      return sibling if File.executable?(sibling) && !File.directory?(sibling)
+
+      "identify"
+    end
+
+    def executable_available?(bin)
+      return false if bin.to_s.empty?
+
+      if bin.include?("/")
+        File.executable?(bin) && !File.directory?(bin)
+      else
+        ENV.fetch("PATH", "").split(File::PATH_SEPARATOR).any? do |dir|
+          next false if dir.empty?
+
+          candidate = File.join(dir, bin)
+          File.executable?(candidate) && !File.directory?(candidate)
+        end
+      end
+    end
+
+    def identify_width(identify_cmd, src)
+      cmd = [*identify_cmd, "-ping", "-format", "%w", "#{src}[0]"]
+      out, _err, status = Open3.capture3(*cmd)
+      return nil unless status.success?
+
+      out.to_s.strip.to_i
+    rescue StandardError
+      nil
+    end
+
+    def write_variant(convert_cmd, src, dest, width)
+      height = (width * 9) / 16
+      FileUtils.mkdir_p(dest.dirname)
+      tmp = dest.dirname.join(".#{dest.basename}.tmp-#{Process.pid}")
+      cmd = [
+        *convert_cmd,
+        "#{src}[0]",
+        "-auto-orient",
+        "-resize", "#{width}x#{height}^",
+        "-gravity", "center",
+        "-extent", "#{width}x#{height}",
+        "-strip",
+        "-interlace", "JPEG",
+        "-sampling-factor", "4:2:0",
+        "-quality", QUALITY.to_s,
+        "jpeg:#{tmp}"
+      ]
+      out, err, status = Open3.capture3(*cmd)
+      unless status.success? && tmp.file?
+        FileUtils.rm_f(tmp)
+        raise "ImageMagick failed for #{src} (#{width}w): #{out}\n#{err}"
+      end
+      File.rename(tmp.to_s, dest.to_s)
+    ensure
+      FileUtils.rm_f(tmp) if tmp && tmp.exist?
+    end
+  end
+end

data/lib/pandorga/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Pandorga
-  VERSION = "1.12.0"
+  VERSION = "1.13.0"
 end

data/lib/pandorga.rb

@@ -14,6 +14,7 @@ module Pandorga
 end
 
 require_relative "pandorga/registry"
+require_relative "pandorga/thumbnail_variants"
 
 # Jekyll loads this file as a plugin when `plugins: [pandorga]`.
 require_relative "pandorga/jekyll" if defined?(Jekyll)

data/scripts/content/export-content-json.rb

@@ -21,6 +21,7 @@ require_relative "../lib/content_license"
 require_relative "../lib/writing_index_contract"
 require_relative "band_art"
 require_relative "hero_portraits"
+require_relative "../../lib/pandorga/thumbnail_variants"
 
 REPO_ROOT = Pathname.new(ENV.fetch("PANDORGA_SITE_ROOT", Dir.pwd)).expand_path
 CONTENT_ROOT = Pathname.new(ARGV[0] || "content").expand_path
@@ -121,6 +122,16 @@ def rewrite_media_references(text)
   rewrite_media_attribute_paths(rewrite_markdown_media_paths(text))
 end
 
+def rewrite_srcset_media_urls(srcset)
+  return nil unless srcset.is_a?(String) && !srcset.strip.empty?
+
+  srcset.split(",").map do |candidate|
+    url, descriptor = candidate.strip.split(/\s+/, 2)
+    resolved = resolve_media_url(url)
+    descriptor ? "#{resolved} #{descriptor}" : resolved
+  end.join(", ")
+end
+
 def rewrite_front_matter_media!(front_matter)
   return front_matter unless front_matter.is_a?(Hash)
 
@@ -360,6 +371,11 @@ def export_markdown_tree(source_dir, output_dir, type)
     end
 
     apply_git_chronology!(front_matter, repo_relative_path, type)
+    if type == "project"
+      raw_srcset = Pandorga::ThumbnailVariants.srcset_for(REPO_ROOT, front_matter["thumbnail"])
+      rewritten_srcset = rewrite_srcset_media_urls(raw_srcset)
+      front_matter["thumbnail_srcset"] = rewritten_srcset if rewritten_srcset
+    end
     rewrite_front_matter_media!(front_matter)
 
     if ContentKeys::KEYED_TYPES.include?(type)
@@ -594,7 +610,7 @@ def writing_index_entry_from_export(payload, content_root, collection)
   end
 
   legacy = File.basename(source_path, File.extname(source_path))
-  {
+  entry = {
     "slug" => slug,
     "key" => key,
     "title" => title,
@@ -630,6 +646,9 @@ def writing_index_entry_from_export(payload, content_root, collection)
       "path_segment" => slug
     )
   }
+  exported_srcset = payload.dig("front_matter", "thumbnail_srcset").to_s
+  entry["thumbnail_srcset"] = exported_srcset unless exported_srcset.empty?
+  entry
 end
 
 def export_derived_data(content_root, output_root)
@@ -710,6 +729,8 @@ def export_collection_trees
   trees
 end
 
+Pandorga::ThumbnailVariants.generate(REPO_ROOT)
+
 files = export_collection_trees
 files["page_fragments"] = export_page_fragments(CONTENT_ROOT.join("pages"), OUTPUT_ROOT.join("pages"))
 files["page_headers"] = export_page_headers(CONTENT_ROOT, OUTPUT_ROOT) << export_hero_portraits(CONTENT_ROOT, OUTPUT_ROOT)

data/scripts/test/test-poster-srcset.mjs

@@ -0,0 +1,159 @@
+#!/usr/bin/env node
+// Refs: PLT-AC-44
+// Executes the real renderPosterMedia sliced out of
+// _includes/content-runtime/43-blocks.html rather than a copy of it.
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..');
+const utilsSource = fs.readFileSync(
+  path.join(root, '_includes/content-runtime/10-utils.html'),
+  'utf8'
+);
+const blocksSource = fs.readFileSync(
+  path.join(root, '_includes/content-runtime/43-blocks.html'),
+  'utf8'
+);
+
+const escStart = utilsSource.indexOf('function escapeHtml');
+const escEnd = utilsSource.indexOf('function shellOrigin');
+if (escStart < 0 || escEnd <= escStart) {
+  console.error('FAIL test-poster-srcset: escapeHtml/escapeAttr missing from 10-utils.html');
+  process.exit(1);
+}
+const escSlice = utilsSource.slice(escStart, escEnd);
+
+const posterStart = blocksSource.indexOf('function renderPosterMedia');
+const posterEnd = blocksSource.indexOf('function twoDigits');
+if (posterStart < 0 || posterEnd <= posterStart) {
+  console.error('FAIL test-poster-srcset: renderPosterMedia missing from 43-blocks.html');
+  process.exit(1);
+}
+const posterSlice = blocksSource.slice(posterStart, posterEnd);
+
+const renderPosterMedia = new Function(
+  `${escSlice}\n${posterSlice}\nreturn renderPosterMedia;`
+)();
+
+let failed = 0;
+
+function check(condition, message) {
+  if (!condition) {
+    console.error(`FAIL test-poster-srcset: ${message}`);
+    failed += 1;
+  }
+}
+
+function same(got, expected, message) {
+  check(got === expected, `${message}: got ${JSON.stringify(got)}, want ${JSON.stringify(expected)}`);
+}
+
+// 1. Without srcset/sizes: byte-identical to today's output
+const expectedPlain = [
+  '<div class="ledger-poster">',
+  '<img src="/media/images/covers/wide.jpg" alt="Wide Project" loading="lazy" decoding="async"',
+  ' onerror="var p=this.closest(\'.ledger-poster\'); if (p) p.remove();">',
+  '</div>'
+].join('');
+
+same(
+  renderPosterMedia('/media/images/covers/wide.jpg', 'Wide Project'),
+  expectedPlain,
+  'plain image without options'
+);
+same(
+  renderPosterMedia('/media/images/covers/wide.jpg', 'Wide Project', {}),
+  expectedPlain,
+  'plain image with empty options'
+);
+same(
+  renderPosterMedia('/media/images/covers/wide.jpg', 'Wide Project', {
+    srcset: '   ',
+    sizes: '(min-width: 900px) 35vw, 100vw'
+  }),
+  expectedPlain,
+  'empty srcset omits both srcset and sizes'
+);
+
+// 2. With srcset + sizes: img has src = original, srcset and sizes attributes (escaped)
+const srcsetVal = '/media/images/covers/variants/wide-480.jpg 480w, /media/images/covers/variants/wide-960.jpg 960w';
+const sizesVal = '(min-width: 900px) 35vw, 100vw';
+const withSrcset = renderPosterMedia('/media/images/covers/wide.jpg', 'Wide "Quote"', {
+  srcset: srcsetVal,
+  sizes: sizesVal
+});
+
+const expectedWithSrcset = [
+  '<div class="ledger-poster">',
+  '<img src="/media/images/covers/wide.jpg"',
+  ' srcset="/media/images/covers/variants/wide-480.jpg 480w, /media/images/covers/variants/wide-960.jpg 960w"',
+  ' sizes="(min-width: 900px) 35vw, 100vw"',
+  ' alt="Wide &quot;Quote&quot;" loading="lazy" decoding="async"',
+  ' onerror="var p=this.closest(\'.ledger-poster\'); if (p) p.remove();">',
+  '</div>'
+].join('');
+
+same(withSrcset, expectedWithSrcset, 'image with srcset and sizes');
+
+// Escaping inside srcset and sizes
+const escaped = renderPosterMedia('/media/a.jpg', 'Alt', {
+  srcset: '/media/a.jpg?x=1&y="2" 480w',
+  sizes: '(max-width: 600px) 100vw, "50vw"'
+});
+check(
+  escaped.includes('srcset="/media/a.jpg?x=1&amp;y=&quot;2&quot; 480w"'),
+  'srcset attribute is escaped'
+);
+check(
+  escaped.includes('sizes="(max-width: 600px) 100vw, &quot;50vw&quot;"'),
+  'sizes attribute is escaped'
+);
+
+// 3. Video URLs ignore srcset and sizes
+const expectedVideo = [
+  '<div class="ledger-poster">',
+  '<video src="/media/clips/demo.mp4" controls preload="none" ',
+  'playsinline aria-label="Demo"></video>',
+  '</div>'
+].join('');
+
+same(
+  renderPosterMedia('/media/clips/demo.mp4', 'Demo', {
+    srcset: srcsetVal,
+    sizes: sizesVal
+  }),
+  expectedVideo,
+  'video URL ignores srcset and sizes'
+);
+
+// 4. Inspect 43-blocks.html call sites for renderSystemCard and renderProjectSpecimen
+const sysCardStart = blocksSource.indexOf('function renderSystemCard');
+const sysCardEnd = blocksSource.indexOf('function renderProjectLinks');
+const specStart = blocksSource.indexOf('function renderProjectSpecimen');
+check(sysCardStart > 0 && sysCardEnd > sysCardStart, 'renderSystemCard found in 43-blocks.html');
+check(specStart > 0, 'renderProjectSpecimen found in 43-blocks.html');
+
+const sysCardBody = blocksSource.slice(sysCardStart, sysCardEnd);
+const specBody = blocksSource.slice(specStart);
+
+check(
+  sysCardBody.includes('renderPosterMedia') &&
+    sysCardBody.includes('fm.thumbnail_srcset') &&
+    sysCardBody.includes('sizes'),
+  'renderSystemCard passes fm.thumbnail_srcset and sizes to renderPosterMedia'
+);
+
+check(
+  specBody.includes('renderPosterMedia') &&
+    specBody.includes('fm.thumbnail_srcset') &&
+    specBody.includes('sizes'),
+  'renderProjectSpecimen passes fm.thumbnail_srcset and sizes to renderPosterMedia'
+);
+
+if (failed) {
+  console.error(`test-poster-srcset: ${failed} failure(s)`);
+  process.exit(1);
+}
+console.log('PASS test-poster-srcset');

data/scripts/test/test-thumbnail-variants.rb

@@ -0,0 +1,380 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Refs: PLT-AC-44
+require "fileutils"
+require "json"
+require "open3"
+require "pathname"
+require "tmpdir"
+require "yaml"
+
+ROOT = Pathname.new(__dir__).join("../..").expand_path
+EXE = ROOT.join("exe/pandorga")
+EXPORT = ROOT.join("scripts/content/export-content-json.rb")
+
+def fail!(message)
+  warn "FAIL test-thumbnail-variants: #{message}"
+  exit 1
+end
+
+def find_imagemagick
+  %w[magick convert].find do |bin|
+    _out, _err, status = Open3.capture3("which", bin)
+    status.success?
+  rescue Errno::ENOENT
+    false
+  end
+end
+
+magick_bin = find_imagemagick
+unless magick_bin
+  if ENV["CI"]
+    fail!("ImageMagick is missing on CI")
+  else
+    puts "SKIP test-thumbnail-variants: ImageMagick not installed"
+    exit 0
+  end
+end
+
+def run_magick(magick_bin, *args)
+  cmd = magick_bin == "magick" ? ["magick", *args] : [args.first == "identify" ? "identify" : "convert", *(args.first == "identify" ? args.drop(1) : args)]
+  out, err, status = Open3.capture3(*cmd)
+  fail!("ImageMagick failed (#{cmd.join(' ')}): #{out}\n#{err}") unless status.success?
+  out
+end
+
+def create_image(magick_bin, path, size, color = "steelblue")
+  FileUtils.mkdir_p(path.dirname)
+  run_magick(magick_bin, "-size", size, "xc:#{color}", path.to_s)
+end
+
+def inject_minimal_exif!(jpeg_path)
+  data = File.binread(jpeg_path)
+  return unless data.start_with?("\xFF\xD8".b)
+
+  # Minimal big-endian TIFF header with Artist tag (0x013B) = "Test"
+  tiff = "MM\x00*\x00\x00\x00\x08\x00\x01\x01\x3B\x00\x02\x00\x00\x00\x05\x00\x00\x00\x1ATest\x00".b
+  payload = "Exif\x00\x00".b + tiff
+  app1 = "\xFF\xE1".b + [payload.bytesize + 2].pack("n") + payload
+  File.binwrite(jpeg_path, data[0, 2] + app1 + data[2..])
+end
+
+def identify_info(magick_bin, path)
+  raw = run_magick(magick_bin, "identify", "-format", "%w %h %m|%[EXIF:*]", path.to_s)
+  dims, exif = raw.split("|", 2)
+  w, h, fmt = dims.to_s.strip.split(/\s+/, 3)
+  { width: w.to_i, height: h.to_i, format: fmt.to_s, exif: exif.to_s.strip }
+end
+
+def write_fixture_site(site, magick_bin)
+  site.join("_config.yml").write(<<~YAML)
+    title: "Test Site"
+    url: "https://example.com"
+    pandorga:
+      identity:
+        name: "Ada Example"
+        url: "https://example.com"
+      content:
+        backend: static
+      pages:
+        - key: projects
+          template: portfolio
+          collection: projects
+          path: /pages/projects/
+          detail: /projects/:slug/
+  YAML
+
+  covers = site.join("content/media/images/covers")
+  create_image(magick_bin, covers.join("wide.jpg"), "3000x2000", "navy")
+  create_image(magick_bin, covers.join("tall.png"), "1200x1600", "darkgreen")
+  create_image(magick_bin, covers.join("small.jpg"), "800x450", "darkred")
+  FileUtils.mkdir_p(covers)
+  covers.join("clip.mp4").write("fake video bytes")
+
+  projects_dir = site.join("content/collections/projects")
+  FileUtils.mkdir_p(projects_dir)
+
+  entries = [
+    ["wide-a", "Wide Alpha", "/media/images/covers/wide.jpg", 1],
+    ["wide-b", "Wide Beta", "/media/images/covers/wide.jpg", 2],
+    ["tall-p", "Tall Project", "/media/images/covers/tall.png", 3],
+    ["small-p", "Small Project", "/media/images/covers/small.jpg", 4],
+    ["ext-url", "External Thumbnail", "https://example.com/x.jpg", 5],
+    ["video-p", "Video Thumbnail", "/media/images/covers/clip.mp4", 6],
+    ["missing-p", "Missing Thumbnail", "/media/images/covers/nope.jpg", 7]
+  ]
+
+  entries.each do |key, title, thumb, order|
+    projects_dir.join("#{key}.md").write(<<~MD)
+      ---
+      key: #{key}
+      project: #{title}
+      title: #{title}
+      tagline: "Summary for #{title}."
+      start_date: "2025-01"
+      status: ongoing
+      label: Ruby
+      icon: terminal
+      sort_order: #{order}
+      thumbnail: #{thumb}
+      tags:
+        - Ruby
+      ---
+
+      Body for #{title}.
+    MD
+  end
+end
+
+begin
+  require "pandorga/thumbnail_variants"
+rescue LoadError => e
+  fail!("cannot load pandorga/thumbnail_variants: #{e.message}")
+end
+
+# 1. Library entry point + idempotency + regeneration when original is newer.
+Dir.mktmpdir("pandorga-thumb-lib-") do |dir|
+  site = Pathname.new(dir)
+  write_fixture_site(site, magick_bin)
+
+  covers = site.join("content/media/images/covers")
+  variants = covers.join("variants")
+
+  summary = Pandorga::ThumbnailVariants.generate(site)
+  fail!("expected generate to return a Hash, got #{summary.inspect}") unless summary.is_a?(Hash)
+
+  # Check wide.jpg variants: 480x270, 960x540, 1440x810
+  [[480, 270], [960, 540], [1440, 810]].each do |w, h|
+    vpath = variants.join("wide-#{w}.jpg")
+    fail!("missing #{vpath}") unless vpath.file?
+    info = identify_info(magick_bin, vpath)
+    fail!("wide-#{w}.jpg expected #{w}x#{h}, got #{info[:width]}x#{info[:height]}") unless info[:width] == w && info[:height] == h
+    fail!("wide-#{w}.jpg expected JPEG, got #{info[:format]}") unless info[:format] == "JPEG"
+    fail!("wide-#{w}.jpg expected empty EXIF, got #{info[:exif].inspect}") unless info[:exif].empty?
+  end
+
+  # Check tall.png (1200x1600): 480 and 960 exist, 1440 skipped
+  [[480, 270], [960, 540]].each do |w, h|
+    vpath = variants.join("tall-#{w}.jpg")
+    fail!("missing #{vpath}") unless vpath.file?
+    info = identify_info(magick_bin, vpath)
+    fail!("tall-#{w}.jpg expected #{w}x#{h}, got #{info[:width]}x#{info[:height]}") unless info[:width] == w && info[:height] == h
+    fail!("tall-#{w}.jpg expected JPEG, got #{info[:format]}") unless info[:format] == "JPEG"
+    fail!("tall-#{w}.jpg expected empty EXIF, got #{info[:exif].inspect}") unless info[:exif].empty?
+  end
+  fail!("tall-1440.jpg must be skipped (no upscaling)") if variants.join("tall-1440.jpg").exist?
+
+  # Check small.jpg (800x450): only 480 exists, 960 and 1440 skipped
+  v480 = variants.join("small-480.jpg")
+  fail!("missing #{v480}") unless v480.file?
+  info480 = identify_info(magick_bin, v480)
+  fail!("small-480.jpg expected 480x270, got #{info480[:width]}x#{info480[:height]}") unless info480[:width] == 480 && info480[:height] == 270
+  fail!("small-480.jpg expected JPEG, got #{info480[:format]}") unless info480[:format] == "JPEG"
+  fail!("small-480.jpg expected empty EXIF, got #{info480[:exif].inspect}") unless info480[:exif].empty?
+  fail!("small-960.jpg must be skipped") if variants.join("small-960.jpg").exist?
+  fail!("small-1440.jpg must be skipped") if variants.join("small-1440.jpg").exist?
+
+  # Nothing written for URL, video, missing
+  written_names = variants.children.map { |p| p.basename.to_s }.sort
+  expected_names = %w[
+    small-480.jpg
+    tall-480.jpg
+    tall-960.jpg
+    wide-1440.jpg
+    wide-480.jpg
+    wide-960.jpg
+  ]
+  fail!("unexpected files in variants/: #{written_names.inspect}") unless written_names == expected_names
+
+  # Check srcset_for helper
+  wide_srcset = Pandorga::ThumbnailVariants.srcset_for(site, "/media/images/covers/wide.jpg")
+  fail!("unexpected wide srcset: #{wide_srcset.inspect}") unless wide_srcset ==
+    "/media/images/covers/variants/wide-480.jpg 480w, /media/images/covers/variants/wide-960.jpg 960w, /media/images/covers/variants/wide-1440.jpg 1440w"
+
+  tall_srcset = Pandorga::ThumbnailVariants.srcset_for(site, "/media/images/covers/tall.png")
+  fail!("unexpected tall srcset: #{tall_srcset.inspect}") unless tall_srcset ==
+    "/media/images/covers/variants/tall-480.jpg 480w, /media/images/covers/variants/tall-960.jpg 960w"
+
+  small_srcset = Pandorga::ThumbnailVariants.srcset_for(site, "/media/images/covers/small.jpg")
+  fail!("unexpected small srcset: #{small_srcset.inspect}") unless small_srcset ==
+    "/media/images/covers/variants/small-480.jpg 480w"
+
+  fail!("expected nil srcset for external URL") unless Pandorga::ThumbnailVariants.srcset_for(site, "https://example.com/x.jpg").nil?
+  fail!("expected nil srcset for video") unless Pandorga::ThumbnailVariants.srcset_for(site, "/media/images/covers/clip.mp4").nil?
+  fail!("expected nil srcset for missing file") unless Pandorga::ThumbnailVariants.srcset_for(site, "/media/images/covers/nope.jpg").nil?
+
+  # Idempotent rerun: set variant mtimes in the future of original, verify rerun keeps mtimes
+  past = Time.now - 120
+  variant_time = Time.now - 60
+  [covers.join("wide.jpg"), covers.join("tall.png"), covers.join("small.jpg")].each do |orig|
+    File.utime(past, past, orig.to_s)
+  end
+  variants.children.each { |v| File.utime(variant_time, variant_time, v.to_s) }
+  mtimes_before = variants.children.to_h { |v| [v.basename.to_s, v.mtime] }
+
+  Pandorga::ThumbnailVariants.generate(site)
+  mtimes_after = variants.children.to_h { |v| [v.basename.to_s, v.mtime] }
+  fail!("rerun modified up-to-date variants: #{mtimes_before.inspect} vs #{mtimes_after.inspect}") unless mtimes_before == mtimes_after
+
+  # Touch original newer: only that image's variant set is regenerated
+  newer = Time.now
+  File.utime(newer, newer, covers.join("small.jpg").to_s)
+  Pandorga::ThumbnailVariants.generate(site)
+  fail!("expected small-480.jpg to be regenerated when small.jpg is newer") unless variants.join("small-480.jpg").mtime > mtimes_before["small-480.jpg"]
+  fail!("expected wide-480.jpg mtime unchanged") unless variants.join("wide-480.jpg").mtime == mtimes_before["wide-480.jpg"]
+end
+
+# 2. CLI entry point `exe/pandorga thumbnails <root>`
+Dir.mktmpdir("pandorga-thumb-cli-") do |dir|
+  site = Pathname.new(dir)
+  write_fixture_site(site, magick_bin)
+
+  env = { "RUBYOPT" => "-I#{ROOT.join('lib')}" }
+  stdout, stderr, status = Open3.capture3(env, "ruby", EXE.to_s, "thumbnails", site.to_s)
+  fail!("CLI pandorga thumbnails failed:\n#{stdout}\n#{stderr}") unless status.success?
+
+  variants = site.join("content/media/images/covers/variants")
+  %w[wide-480.jpg wide-960.jpg wide-1440.jpg tall-480.jpg tall-960.jpg small-480.jpg].each do |name|
+    fail!("CLI did not write #{name}") unless variants.join(name).file?
+  end
+end
+
+# 3. Full gem export runs generation itself and rewrites thumbnail_srcset URLs
+Dir.mktmpdir("pandorga-thumb-export-") do |dir|
+  site = Pathname.new(dir)
+  write_fixture_site(site, magick_bin)
+  out = site.join("_content_json")
+  variants = site.join("content/media/images/covers/variants")
+  fail!("variants must not exist before export") if variants.exist?
+
+  env = {
+    "RUBYOPT" => "-I#{ROOT.join('lib')}",
+    "PANDORGA_SITE_ROOT" => site.to_s,
+    "CONTENT_API_BASE_URL" => "https://cdn.example.com",
+    "CONTENT_EXPORT_SKIP_VALIDATE" => "1"
+  }
+  stdout, stderr, status = Open3.capture3(
+    env, "ruby", EXPORT.to_s,
+    site.join("content").to_s, out.to_s,
+    chdir: site.to_s
+  )
+  fail!("export failed:\n#{stdout}\n#{stderr}") unless status.success?
+  fail!("export did not generate variants/") unless variants.join("wide-480.jpg").file?
+
+  wide_json = JSON.parse(out.join("collections/projects/wide-a.json").read)
+  wide_fm = wide_json.fetch("front_matter")
+  expected_wide_srcset = [
+    "https://cdn.example.com/media/images/covers/variants/wide-480.jpg 480w",
+    "https://cdn.example.com/media/images/covers/variants/wide-960.jpg 960w",
+    "https://cdn.example.com/media/images/covers/variants/wide-1440.jpg 1440w"
+  ].join(", ")
+  unless wide_fm["thumbnail"] == "https://cdn.example.com/media/images/covers/wide.jpg"
+    fail!("wide-a thumbnail unexpected: #{wide_fm['thumbnail'].inspect}")
+  end
+  unless wide_fm["thumbnail_srcset"] == expected_wide_srcset
+    fail!("wide-a thumbnail_srcset unexpected: #{wide_fm['thumbnail_srcset'].inspect}")
+  end
+
+  tall_fm = JSON.parse(out.join("collections/projects/tall-p.json").read).fetch("front_matter")
+  expected_tall_srcset = [
+    "https://cdn.example.com/media/images/covers/variants/tall-480.jpg 480w",
+    "https://cdn.example.com/media/images/covers/variants/tall-960.jpg 960w"
+  ].join(", ")
+  unless tall_fm["thumbnail_srcset"] == expected_tall_srcset
+    fail!("tall-p thumbnail_srcset unexpected: #{tall_fm['thumbnail_srcset'].inspect}")
+  end
+
+  small_fm = JSON.parse(out.join("collections/projects/small-p.json").read).fetch("front_matter")
+  expected_small_srcset = "https://cdn.example.com/media/images/covers/variants/small-480.jpg 480w"
+  unless small_fm["thumbnail_srcset"] == expected_small_srcset
+    fail!("small-p thumbnail_srcset unexpected: #{small_fm['thumbnail_srcset'].inspect}")
+  end
+
+  %w[ext-url video-p missing-p].each do |slug|
+    fm = JSON.parse(out.join("collections/projects/#{slug}.json").read).fetch("front_matter")
+    if fm.key?("thumbnail_srcset")
+      fail!("#{slug} must not have thumbnail_srcset, got #{fm['thumbnail_srcset'].inspect}")
+    end
+  end
+
+  # Also check writing_index.json carries thumbnail_srcset for the home specimen
+  index = JSON.parse(out.join("data/writing_index.json").read)
+  wide_idx = index.find { |e| e["slug"] == "wide-a" }
+  fail!("wide-a missing from writing_index.json") unless wide_idx
+  unless wide_idx["thumbnail_srcset"] == expected_wide_srcset
+    fail!("writing_index wide-a thumbnail_srcset unexpected: #{wide_idx['thumbnail_srcset'].inspect}")
+  end
+  %w[ext-url video-p missing-p].each do |slug|
+    entry = index.find { |e| e["slug"] == slug }
+    fail!("#{slug} missing from writing_index.json") unless entry
+    if entry.key?("thumbnail_srcset")
+      fail!("writing_index #{slug} must not have thumbnail_srcset, got #{entry['thumbnail_srcset'].inspect}")
+    end
+  end
+end
+
+# 4. Without ImageMagick: export succeeds, prints one warning line, writes no variants and no thumbnail_srcset
+Dir.mktmpdir("pandorga-thumb-nomagick-") do |dir|
+  site = Pathname.new(dir)
+  write_fixture_site(site, magick_bin)
+  out = site.join("_content_json")
+
+  env = {
+    "RUBYOPT" => "-I#{ROOT.join('lib')}",
+    "PANDORGA_SITE_ROOT" => site.to_s,
+    "CONTENT_API_BASE_URL" => "",
+    "CONTENT_EXPORT_SKIP_VALIDATE" => "1",
+    "PANDORGA_IMAGEMAGICK" => "/nonexistent/magick"
+  }
+  stdout, stderr, status = Open3.capture3(
+    env, "ruby", EXPORT.to_s,
+    site.join("content").to_s, out.to_s,
+    chdir: site.to_s
+  )
+  fail!("export without ImageMagick failed:\n#{stdout}\n#{stderr}") unless status.success?
+
+  combined_lines = "#{stdout}\n#{stderr}".lines.map(&:strip).reject(&:empty?)
+  warnings = combined_lines.select { |l| l.match?(/warning.*imagemagick|imagemagick.*warning/i) }
+  unless warnings.length == 1
+    fail!("expected exactly 1 ImageMagick warning line, got #{warnings.length}: #{warnings.inspect}\nAll output:\n#{stdout}\n#{stderr}")
+  end
+
+  variants = site.join("content/media/images/covers/variants")
+  if variants.exist? && variants.children.any?
+    fail!("expected no variants written when ImageMagick is unavailable")
+  end
+
+  wide_fm = JSON.parse(out.join("collections/projects/wide-a.json").read).fetch("front_matter")
+  if wide_fm.key?("thumbnail_srcset")
+    fail!("expected no thumbnail_srcset when ImageMagick is unavailable, got #{wide_fm['thumbnail_srcset'].inspect}")
+  end
+end
+
+# 5. An unreadable image warns, keeps its original, and does not stop the export.
+Dir.mktmpdir("pandorga-thumb-corrupt-") do |dir|
+  site = Pathname.new(dir)
+  write_fixture_site(site, magick_bin)
+  site.join("content/media/images/covers/small.jpg").write("not a jpeg")
+  out = site.join("_content_json")
+  env = {
+    "RUBYOPT" => "-I#{ROOT.join('lib')}",
+    "PANDORGA_SITE_ROOT" => site.to_s,
+    "CONTENT_API_BASE_URL" => "",
+    "CONTENT_EXPORT_SKIP_VALIDATE" => "1"
+  }
+  stdout, stderr, status = Open3.capture3(
+    env, "ruby", EXPORT.to_s,
+    site.join("content").to_s, out.to_s,
+    chdir: site.to_s
+  )
+  fail!("export with an unreadable image failed:\n#{stdout}\n#{stderr}") unless status.success?
+  fail!("expected a warning naming small.jpg") unless "#{stdout}\n#{stderr}".match?(/warning.*small\.jpg/)
+  variants = site.join("content/media/images/covers/variants")
+  fail!("unreadable image must not get variants") if variants.join("small-480.jpg").exist?
+  fail!("readable images must still get variants") unless variants.join("wide-480.jpg").file?
+  small_fm = JSON.parse(out.join("collections/projects/small-p.json").read).fetch("front_matter")
+  fail!("unreadable image must not get thumbnail_srcset") if small_fm.key?("thumbnail_srcset")
+end
+
+puts "PASS test-thumbnail-variants"

data/scripts/validate.sh

@@ -71,6 +71,7 @@ TESTS=(
   scripts/test/test-css-delivery.rb
   scripts/test/test-discovery.rb
   scripts/test/test-hero-portraits.rb
+  scripts/test/test-thumbnail-variants.rb
 )
 
 failed=0
@@ -91,6 +92,11 @@ if ! node scripts/test/test-hero-portraits.mjs; then
   failed=1
 fi
 
+echo "-- scripts/test/test-poster-srcset.mjs"
+if ! node scripts/test/test-poster-srcset.mjs; then
+  failed=1
+fi
+
 echo "-- scripts/test/test-studio-pipeline-config.mjs"
 if ! node scripts/test/test-studio-pipeline-config.mjs; then
   failed=1

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pandorga
 version: !ruby/object:Gem::Version
-  version: 1.12.0
+  version: 1.13.0
 platform: ruby
 authors:
 - The Pandorga contributors
@@ -287,6 +287,7 @@ files:
 - lib/pandorga/commands/publish.rb
 - lib/pandorga/commands/serve.rb
 - lib/pandorga/commands/studio_schema.rb
+- lib/pandorga/commands/thumbnails.rb
 - lib/pandorga/detail_routes.rb
 - lib/pandorga/discovery.rb
 - lib/pandorga/fonts.rb
@@ -325,6 +326,7 @@ files:
 - lib/pandorga/object_store_env.rb
 - lib/pandorga/registry.rb
 - lib/pandorga/registry/schema.yml
+- lib/pandorga/thumbnail_variants.rb
 - lib/pandorga/version.rb
 - scripts/cdn-allowlist.json
 - scripts/check_home_lists.mjs
@@ -449,6 +451,7 @@ files:
 - scripts/test/test-math-row-breaks.rb
 - scripts/test/test-new.rb
 - scripts/test/test-no-personal-data.rb
+- scripts/test/test-poster-srcset.mjs
 - scripts/test/test-public-cv-export.rb
 - scripts/test/test-publish-site-root.rb
 - scripts/test/test-pwa-icons.rb
@@ -473,6 +476,7 @@ files:
 - scripts/test/test-template-packages.rb
 - scripts/test/test-text-excerpt.rb
 - scripts/test/test-theme-contrast.rb
+- scripts/test/test-thumbnail-variants.rb
 - scripts/test/test-unwrap-media-src.mjs
 - scripts/test/test-unwrap-media-src.rb
 - scripts/test/test-validate-allowlist.rb