pandorga 1.7.0 → 1.7.2

data/scripts/test/test-examples-build.rb

@@ -33,8 +33,23 @@ end
   FileUtils.rm_rf(example.join("_site"))
   FileUtils.rm_rf(example.join("_content_json"))
 
+  redirects_path = example.join("_redirects")
+  original_redirects = redirects_path.file? ? redirects_path.read : nil
+
+  begin
   run!("bundle", "install", "--quiet", chdir: example) if example.join("Gemfile").file?
   run!("ruby", EXE.to_s, "export", "content", "_content_json", chdir: example)
+  if name == "full" && redirects_path.file?
+    splat = <<~TXT
+
+      /articles/:slug /pages/articles/ 200
+      /posts/:slug /pages/blog/ 200
+      /blog/:slug /pages/blog/ 200
+      /projects/:slug /pages/projects/ 200
+      /products/:slug /pages/cv/ 200
+    TXT
+    redirects_path.write("#{redirects_path.read.rstrip}\n#{splat}")
+  end
   run!("bundle", "exec", "jekyll", "build", "--quiet", chdir: example)
 
   index = example.join("_site/index.html")
@@ -65,6 +80,18 @@ end
       warn "FAIL test-examples-build: full home still hydrates the summary"
       exit 1
     end
+    {
+      "pages/articles/index.html" => "Articles",
+      "pages/blog/index.html" => "Rascunhos",
+      "pages/projects/index.html" => "Projects"
+    }.each do |rel, title|
+      listing = example.join("_site", rel).read
+      heading = listing[/<h1 class="page-header-title.*?<\/h1>/m].to_s
+      unless heading.include?(title) && heading.include?("data-content-static") && !heading.include?("Loading...")
+        warn "FAIL test-examples-build: #{rel} static h1 is #{heading.inspect}"
+        exit 1
+      end
+    end
   else
     unless html.include?('id="home-cv-summary" class="home-hero-summary font-body" data-content-fragment="cv/summary" data-content-quiet')
       warn "FAIL test-examples-build: minimal home dropped the summary fallback"
@@ -86,6 +113,66 @@ end
     warn "FAIL test-examples-build: #{name} robots missing the sitemap line\n#{robots}"
     exit 1
   end
+  if name == "full"
+    {
+      "/articles/2026-01-01-welcome/" => "Article",
+      "/posts/2026-01-02-note/" => "BlogPosting"
+    }.each do |path, schema|
+      loc = "#{origin}#{path}"
+      unless sitemap.include?("<loc>#{loc}</loc>")
+        warn "FAIL test-examples-build: sitemap missing #{loc}\n#{sitemap}"
+        exit 1
+      end
+      page = example.join("_site#{path}index.html")
+      unless page.file?
+        warn "FAIL test-examples-build: missing static detail #{page}"
+        exit 1
+      end
+      body = page.read
+      canonical = body[/rel="canonical" href="([^"]+)"/, 1].to_s
+      og_url = body[/property="og:url" content="([^"]+)"/, 1].to_s
+      unless canonical.include?(path) && !canonical.include?("/pages/")
+        warn "FAIL test-examples-build: canonical for #{path} is #{canonical}"
+        exit 1
+      end
+      unless og_url.include?(path) && !og_url.include?("/pages/")
+        warn "FAIL test-examples-build: og:url for #{path} is #{og_url}"
+        exit 1
+      end
+      unless body.include?(%("@type": "#{schema}"))
+        warn "FAIL test-examples-build: #{path} missing #{schema} JSON-LD"
+        exit 1
+      end
+      listing_attr = path.include?("/posts/") ? "/pages/blog/" : "/pages/articles/"
+      unless body.include?(%(data-listing-path="#{listing_attr}"))
+        warn "FAIL test-examples-build: #{path} lost the listing path"
+        exit 1
+      end
+    end
+    ["/projects/demo-kit/", "/products/ledger-tool/"].each do |path|
+      loc = "#{origin}#{path}"
+      unless sitemap.include?("<loc>#{loc}</loc>")
+        warn "FAIL test-examples-build: sitemap missing #{loc}\n#{sitemap}"
+        exit 1
+      end
+      page = example.join("_site#{path}index.html")
+      body = page.file? ? page.read : ""
+      canonical = body[/rel="canonical" href="([^"]+)"/, 1].to_s
+      unless canonical.include?(path)
+        warn "FAIL test-examples-build: canonical for #{path} is #{canonical}"
+        exit 1
+      end
+    end
+    built_redirects = example.join("_site/_redirects").read
+    if built_redirects.match?(%r{/(?:articles|posts|blog|projects|products)/:slug})
+      warn "FAIL test-examples-build: built _redirects still rewrites detail URLs\n#{built_redirects}"
+      exit 1
+    end
+    unless redirects_path.read.match?(%r{/articles/:slug\s+/pages/articles/\s+200})
+      warn "FAIL test-examples-build: the build edited the source _redirects"
+      exit 1
+    end
+  end
   unless html.include?('application/ld+json') && html.include?('"@type": "Person"')
     warn "FAIL test-examples-build: #{name} home is missing JSON-LD"
     exit 1
@@ -99,6 +186,9 @@ end
     warn "FAIL test-examples-build: #{name} home dropped the title face"
     exit 1
   end
+ensure
+  redirects_path.write(original_redirects) if original_redirects
+end
 end
 
 puts "PASS test-examples-build"

data/scripts/test/test-fonts.rb

@@ -47,6 +47,20 @@ fail!("body weights were not sorted") unless custom_href.include?("family=Source
 fail!("mono italic axis is wrong") unless custom_href.include?("family=IBM+Plex+Mono:ital,wght@0,400;0,500;1,400;1,500")
 fail!("unset label left Marcellus") unless custom_href.include?("family=Marcellus+SC:wght@400;700")
 fail!("body change left the tagline on Newsreader") unless Pandorga::Fonts.css_stack(custom, "subtitle").start_with?("'Source Serif 4'")
+
+# A font rename once replaced the letters "hind" inside the word "behind".
+token = "be" + "Newsreader"
+broken = []
+Dir.glob(ROOT.join("**/*.{css,html,rb,js,mjs,md,liquid,yml}")).each do |path|
+  next if path.include?("/studio/assets/")
+  next if path.include?("/node_modules/")
+  next if path.end_with?("test-fonts.rb")
+  text = File.read(path)
+  next unless text.include?(token)
+
+  broken << Pathname.new(path).relative_path_from(ROOT).to_s
+end
+fail!("corrupted 'behind' left by a font rename (#{broken.size} files): #{broken.join(', ')}") unless broken.empty?
 fail!("code face did not follow mono") unless Pandorga::Fonts.css_stack(custom, "code").start_with?("'IBM Plex Mono'")
 
 kept = Pandorga::Fonts.resolve({ "title" => "Cinzel Decorative" }, theme)

data/scripts/test/test-hero-portraits.mjs

@@ -13,14 +13,24 @@ const source = fs.readFileSync(
 );
 
 const start = source.indexOf('function heroPortraitEntries');
-const end = source.indexOf('function applyHeroPortrait(');
+// applyHeroPortraitSources is defined before pickHeroPortrait. Ending at
+// applyHeroPortrait( still works today, and it is one character away from
+// stopping on the Sources function. showHeroPortrait is the next function
+// after the picker, so the slice always includes pickHeroPortrait.
+const end = source.indexOf('function showHeroPortrait');
 if (start < 0 || end < start) {
   console.error('hero portrait functions missing from 60-fragments.html');
   process.exit(1);
 }
 
+const slice = source.slice(start, end);
+if (!slice.includes('function pickHeroPortrait')) {
+  console.error('hero portrait crop stopped before pickHeroPortrait');
+  process.exit(1);
+}
+
 const api = new Function(
-  `${source.slice(start, end)}\nreturn { heroPortraitEntries, pickHeroPortrait };`
+  `${slice}\nreturn { heroPortraitEntries, pickHeroPortrait };`
 )();
 
 const { heroPortraitEntries, pickHeroPortrait } = api;

data/scripts/test/test-hero-portraits.rb

@@ -37,13 +37,19 @@ puts "Testing home hero portraits..."
 
 # ── AC-HERO-01 ──────────────────────────────────────────────────────────────
 
-check!(POOL.directory?, "missing #{POOL}")
 check!(!ROOT.join("content/pages/home/portraits.yml").exist?,
        "the author does not keep a portrait list")
 
-pool_names = POOL.children.select(&:file?).map { |path| path.basename.to_s }.sort
-check!(pool_names == %w[DSC00571.JPG DSC00632.JPG DSC00721.JPG DSC00727.JPG],
-       "the hero folder must hold the four uploaded photographs, got #{pool_names.inspect}")
+# The four photographs live with the site, not in the gem. When they are
+# here, the folder must be exactly that set. When they are not, the picker
+# extracted from the runtime still has to run.
+personal_pool = %w[DSC00571.JPG DSC00632.JPG DSC00721.JPG DSC00727.JPG]
+pool_names = POOL.directory? ? POOL.children.select(&:file?).map { |path| path.basename.to_s }.sort : []
+if pool_names.empty?
+  puts "AC-HERO-01: no hero photographs in this checkout"
+elsif pool_names != personal_pool
+  check!(false, "the hero folder must hold the four uploaded photographs, got #{pool_names.inspect}")
+end
 
 Dir.mktmpdir("hero-pool") do |dir|
   root = Pathname.new(dir)
@@ -135,6 +141,7 @@ check!(status.success?, "picker cases failed")
 
 # ── AC-HERO-02 ──────────────────────────────────────────────────────────────
 
+if pool_names == personal_pool
 Dir.mktmpdir("hero-portraits") do |dir|
   out = Pathname.new(dir).join("export")
   env = { "CONTENT_API_BASE_URL" => "", "CONTENT_EXPORT_SKIP_VALIDATE" => "1" }
@@ -158,5 +165,6 @@ Dir.mktmpdir("hero-portraits") do |dir|
   check!(listed.include?("pages/home/portraits.json"),
          "manifest page_headers must include the portrait list, got #{listed.inspect}")
 end
+end
 
 puts "All home hero portrait checks passed."

data/scripts/test/test-lighthouse-policy.rb

@@ -101,6 +101,10 @@ fail!("band note is still painted by script") unless band.include?("page_headers
 fail!("project inventory has a name and no role") unless band.include?('role="region"') && band.include?('aria-label="Project inventory"')
 headers = File.read(File.expand_path("../../_plugins/content_headers.rb", __dir__))
 fail!("page headers are not loaded at build time") unless headers.include?('site.data["page_headers"]')
+page_header = File.read(File.expand_path("../../_includes/page/page-header.html", __dir__))
+fail!("listing h1 is still Loading...") if page_header.include?("Loading...")
+fail!("listing h1 does not read page headers") unless page_header.include?("page_headers")
+fail!("listing h1 is not marked static") unless page_header.include?("data-content-static")
 home = File.read(File.expand_path("../../_layouts/home.html", __dir__))
 fail!("hero subtitle is still painted by script") unless home.include?("page_headers.home") && home.include?("data-content-static")
 

data/scripts/test/test-listing-filter-contract.rb

@@ -7,7 +7,7 @@
 # on click; `filterItems` reads a fixed set of names. Nothing connects the
 # two, so renaming a facet in a layout — `category` to `tag`, say — leaves the
 # chips rendering, highlighting and pushing a query string while the list
-# beNewsreader them never changes. That shipped on the Sources page: every click set
+# behind them never changes. That shipped on the Sources page: every click set
 # a key nothing read.
 #
 # There is no build error and no console error to notice, so the contract is

data/scripts/test/test-shell-a11y.rb

@@ -27,4 +27,31 @@ fail!("footer home link still uses site.author alone") if FOOTER.include?(bare)
 fail!("shell home link needs an identity.name fallback") unless SHELL.include?("site.pandorga.identity.name")
 fail!("footer home link needs an identity.name fallback") unless FOOTER.include?("site.pandorga.identity.name")
 
+fail!("top bar is still a nav") if SHELL.include?('<nav class="sticky')
+fail!("top bar is not a header") unless SHELL.include?('<header class="sticky top-0 z-50 bg-surface">')
+fail!("section links lost their name") unless SHELL.include?('aria-label="Sections"')
+navs = SHELL.scan(/<nav\b/).size
+fail!("shell should have one nav landmark, found #{navs}") unless navs == 1
+
+# Decorative Material Symbols sit beside a text label. Without aria-hidden
+# the ligature ("arrow_left_alt", "shuffle", an icon name) is read aloud.
+ICON_FILES = [
+  ROOT.join("_layouts/text.html"),
+  ROOT.join("_includes/content-runtime/50-detail.html"),
+  ROOT.join("_includes/content-runtime/60-fragments.html"),
+  ROOT.join("_includes/content-runtime/30-includes.html")
+].freeze
+
+ICON_FILES.each do |path|
+  path.read.each_line.with_index(1) do |line, number|
+    next unless line.include?("material-symbols-outlined")
+    next if line.include?("querySelector")
+    next if line.include?("aria-hidden")
+    # Class token handed to a later span that already sets aria-hidden.
+    next if line.include?("cls:")
+
+    fail!("#{path.relative_path_from(ROOT)}:#{number}: decorative icon is exposed")
+  end
+end
+
 puts "PASS test-shell-a11y"

data/scripts/test/test-theme-contrast.rb

@@ -0,0 +1,43 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Dark tertiary container text must clear WCAG AA for normal text.
+# PLT-AC-33
+
+require "pathname"
+require "yaml"
+
+ROOT = Pathname.new(__dir__).join("..", "..").expand_path
+
+def fail!(message)
+  warn "FAIL test-theme-contrast: #{message}"
+  exit 1
+end
+
+def channel(value)
+  value = value / 255.0
+  value <= 0.04045 ? value / 12.92 : ((value + 0.055) / 1.055)**2.4
+end
+
+def luminance(hex)
+  rgb = hex.delete("#").scan(/../).map { |part| part.to_i(16) }
+  fail!("not a hex colour: #{hex}") unless rgb.length == 3
+
+  (0.2126 * channel(rgb[0])) + (0.7152 * channel(rgb[1])) + (0.0722 * channel(rgb[2]))
+end
+
+def contrast(foreground, background)
+  lighter, darker = [luminance(foreground), luminance(background)].sort.reverse
+  (lighter + 0.05) / (darker + 0.05)
+end
+
+dark = YAML.safe_load(ROOT.join("_data/themes/dark.yml").read) || {}
+colors = dark["colors"] || {}
+background = colors["tertiary_container"].to_s
+foreground = colors["on_tertiary_container"].to_s
+fail!("dark tertiary container moved") unless background.casecmp("#6a684f").zero?
+
+ratio = contrast(foreground, background)
+fail!("#{foreground} on #{background} is #{ratio.round(2)}:1") unless ratio >= 4.5
+
+puts "PASS test-theme-contrast (#{foreground} on #{background} = #{ratio.round(2)}:1)"

data/scripts/validate.sh

@@ -57,6 +57,7 @@ TESTS=(
   scripts/test/test-examples-build.rb
   scripts/test/test-validate-allowlist.rb
   scripts/test/test-shell-a11y.rb
+  scripts/test/test-theme-contrast.rb
   scripts/test/test-hydrate-reserve.rb
   scripts/test/test-hero-summary.rb
   scripts/test/test-lighthouse-policy.rb
@@ -82,6 +83,11 @@ for test in "${TESTS[@]}"; do
   fi
 done
 
+echo "-- scripts/test/test-hero-portraits.mjs"
+if ! node scripts/test/test-hero-portraits.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.7.0
+  version: 1.7.2
 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/detail_routes.rb
 - lib/pandorga/discovery.rb
 - lib/pandorga/fonts.rb
 - lib/pandorga/hero_summary.rb
@@ -303,6 +304,7 @@ files:
 - lib/pandorga/jekyll/plugins/content_validators_hook.rb
 - lib/pandorga/jekyll/plugins/content_writing_index.rb
 - lib/pandorga/jekyll/plugins/content_writing_paths.rb
+- lib/pandorga/jekyll/plugins/detail_documents.rb
 - lib/pandorga/jekyll/plugins/discovery.rb
 - lib/pandorga/jekyll/plugins/fonts.rb
 - lib/pandorga/jekyll/plugins/force_utf8_encoding.rb
@@ -466,6 +468,7 @@ files:
 - scripts/test/test-studio-slug-config.rb
 - scripts/test/test-template-packages.rb
 - scripts/test/test-text-excerpt.rb
+- scripts/test/test-theme-contrast.rb
 - scripts/test/test-unwrap-media-src.mjs
 - scripts/test/test-unwrap-media-src.rb
 - scripts/test/test-validate-allowlist.rb