pandorga 1.5.0 → 1.6.0

data/scripts/test/test-css-delivery.rb

@@ -0,0 +1,32 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Stylesheet delivery (PLT-AC-19).
+# The Play CDN blocked first paint, and every page linked every ledger sheet.
+
+require "pathname"
+
+ROOT = Pathname.new(__dir__).join("..", "..").expand_path
+
+def fail!(message)
+  warn "FAIL test-css-delivery: #{message}"
+  exit 1
+end
+
+shell = ROOT.join("_layouts/shell.html").read
+css = ROOT.join("assets/css/tailwind.css").read
+
+fail!("shell still loads the Tailwind Play CDN") if shell.include?("cdn.tailwindcss.com")
+fail!("shell still loads tailwind-play.js") if shell.include?("tailwind-play.js")
+fail!("shell does not link the compiled utilities") unless shell.include?('href="/assets/css/tailwind.css"')
+fail!("shell still links every ledger sheet") if shell.include?('sheet.path contains "/assets/css/ledger/"')
+fail!("shell still links the empty cv.css") if shell.include?('href="/assets/css/cv.css"')
+fail!("empty cv.css is still in the tree") if ROOT.join("assets/css/cv.css").exist?
+fail!("home layout has no ledger sheet") unless shell.include?('when "home"') && shell.include?('assign _ledger = "home"')
+fail!("articles layout misses the writing sheet") unless shell.include?("writing|detail")
+fail!("shared chrome is not always linked") unless shell.include?("ledger/chrome.css") && shell.include?("ledger/footer.css")
+fail!("compiled utilities are missing flex") unless css.include?(".flex{")
+fail!("compiled utilities dropped the separator tint") unless css.include?("bg-outline-variant\\/30")
+fail!("compiled utilities dropped the dev-reexport border") unless css.include?("border-tertiary\\/40")
+
+puts "PASS test-css-delivery"

data/scripts/test/test-css-structure.rb

@@ -64,6 +64,14 @@ sheets.each do |path|
     errors << "#{relative}: #{depth} unclosed brace(s) — every rule after the " \
               "offending block is swallowed and silently stops applying"
   end
+
+  if cleaned.match?(/\{[ \t\r\n]*\}/)
+    errors << "#{relative}: empty ruleset (a block that matches nothing)"
+  end
+
+  if source.include?("home-profile-summary")
+    errors << "#{relative}: .home-profile-summary is unused"
+  end
 end
 
 fail!("CSS structure problems:\n  - #{errors.join("\n  - ")}") unless errors.empty?

data/scripts/test/test-discovery.rb

@@ -0,0 +1,46 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Portrait sources and discovery documents (PLT-AC-20, PLT-AC-21).
+
+require "pathname"
+
+require_relative "../../lib/pandorga/discovery"
+
+ROOT = Pathname.new(__dir__).join("..", "..").expand_path
+
+def fail!(message)
+  warn "FAIL test-discovery: #{message}"
+  exit 1
+end
+
+origin = Pandorga::Discovery.origin(
+  "url" => "https://fallback.example",
+  "pandorga" => { "identity" => { "url" => "https://example.com/" } }
+)
+fail!("identity.url must win over site.url") unless origin == "https://example.com"
+
+paths = Pandorga::Discovery.public_paths([
+  { "url" => "/", "data" => {} },
+  { "url" => "/pages/articles/", "data" => {} },
+  { "url" => "/sitemap.xml", "data" => {} },
+  { "url" => "/secret/", "data" => { "sitemap" => false } }
+])
+fail!("sitemap filtering is wrong: #{paths.inspect}") unless paths == ["/", "/pages/articles/"]
+
+xml = Pandorga::Discovery.sitemap_xml("https://example.com", paths)
+fail!("sitemap missing a loc") unless xml.include?("<loc>https://example.com/pages/articles/</loc>")
+fail!("sitemap included a skipped path") if xml.include?("secret")
+
+robots = Pandorga::Discovery.robots_txt("https://example.com/sitemap.xml")
+fail!("robots missing the sitemap line") unless robots.include?("Sitemap: https://example.com/sitemap.xml")
+fail!("robots missing the studio skip") unless robots.include?("Disallow: /studio/")
+
+runtime = ROOT.join("_includes/content-runtime/60-fragments.html").read
+fail!("portrait srcset is not read") unless runtime.include?("record.srcset = srcset")
+fail!("portrait sources are not applied") unless runtime.include?("applyHeroPortraitSources")
+shell = ROOT.join("_layouts/shell.html").read
+fail!("shell missing JSON-LD") unless shell.include?("theme/json-ld.html")
+fail!("discovery generator is not loaded from the plugin dir") unless ROOT.join("lib/pandorga/jekyll/plugins/discovery.rb").file?
+
+puts "PASS test-discovery"

data/scripts/test/test-doctor.rb

@@ -3,6 +3,7 @@
 # Refs: PLT-0.3, PLT-AC-5
 require "pathname"
 require "open3"
+require "fileutils"
 
 ROOT = Pathname.new(__dir__).join("../..").expand_path
 EXAMPLE = ROOT.join("examples/minimal")
@@ -36,4 +37,41 @@ unless err.include?("pandorga:")
   exit 1
 end
 
+missing = ROOT.join("tmp/doctor-missing-pages")
+FileUtils.rm_rf(missing)
+missing.mkpath
+missing.join("_config.yml").write(<<~YAML)
+  pandorga:
+    identity:
+      name: Ada Example
+YAML
+_out, err, st = run_doctor(missing)
+unless st.success?
+  warn "FAIL test-doctor: missing pages should warn, not fail\n#{err}"
+  exit 1
+end
+unless err.include?("pandorga.pages is missing")
+  warn "FAIL test-doctor: expected a missing-pages warning\n#{err}"
+  exit 1
+end
+
+empty = ROOT.join("tmp/doctor-empty-pages")
+FileUtils.rm_rf(empty)
+empty.mkpath
+empty.join("_config.yml").write(<<~YAML)
+  pandorga:
+    identity:
+      name: Ada Example
+    pages: []
+YAML
+_out, err, st = run_doctor(empty)
+unless st.success?
+  warn "FAIL test-doctor: empty pages should warn, not fail\n#{err}"
+  exit 1
+end
+unless err.include?("pandorga.pages is empty")
+  warn "FAIL test-doctor: expected an empty-pages warning\n#{err}"
+  exit 1
+end
+
 puts "PASS test-doctor"

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

@@ -55,6 +55,21 @@ end
     warn "FAIL test-examples-build: #{name} home layout missing"
     exit 1
   end
+  origin = name == "full" ? "https://example.org" : "https://example.com"
+  sitemap = example.join("_site/sitemap.xml").read
+  robots = example.join("_site/robots.txt").read
+  unless sitemap.include?("<loc>#{origin}/</loc>") || sitemap.include?("<loc>#{origin}/index.html</loc>")
+    warn "FAIL test-examples-build: #{name} sitemap missing the home URL\n#{sitemap}"
+    exit 1
+  end
+  unless robots.include?("Sitemap: #{origin}/sitemap.xml")
+    warn "FAIL test-examples-build: #{name} robots missing the sitemap line\n#{robots}"
+    exit 1
+  end
+  unless html.include?('application/ld+json') && html.include?('"@type": "Person"')
+    warn "FAIL test-examples-build: #{name} home is missing JSON-LD"
+    exit 1
+  end
 end
 
 puts "PASS test-examples-build"

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

@@ -13,7 +13,7 @@ const source = fs.readFileSync(
 );
 
 const start = source.indexOf('function heroPortraitEntries');
-const end = source.indexOf('function applyHeroPortrait');
+const end = source.indexOf('function applyHeroPortrait(');
 if (start < 0 || end < start) {
   console.error('hero portrait functions missing from 60-fragments.html');
   process.exit(1);

data/scripts/test/test-hydrate-reserve.rb

@@ -0,0 +1,64 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Hero LCP, listing/CV shift, revision contrast, inventory button.
+# PLT-AC-16, PLT-AC-17, PLT-AC-18. The subtitle size is PLT-AC-13.
+
+require "pathname"
+
+ROOT = Pathname.new(__dir__).join("..", "..").expand_path
+
+def fail!(message)
+  warn "FAIL test-hydrate-reserve: #{message}"
+  exit 1
+end
+
+shell = ROOT.join("_layouts/shell.html").read
+preload = ROOT.join("_includes/theme/critical-preload.html").read
+home = ROOT.join("_layouts/home.html").read
+articles = ROOT.join("_layouts/articles.html").read
+cv = ROOT.join("_layouts/cv.html").read
+fragments = ROOT.join("_includes/content-runtime/60-fragments.html").read
+listing = ROOT.join("_includes/content-runtime/41-listing-helpers.html").read
+blocks = ROOT.join("_includes/content-runtime/43-blocks.html").read
+home_css = ROOT.join("assets/css/ledger/home.css").read
+writing_css = ROOT.join("assets/css/ledger/writing.css").read
+cv_css = ROOT.join("assets/css/ledger/cv.css").read
+
+fail!("shell does not preload critical JSON") unless shell.include?("theme/critical-preload.html")
+fail!("home preload misses the hero summary") unless preload.include?("pages/cv/summary.json")
+fail!("home preload misses the subtitle") unless preload.include?("pages/home/subtitle.json")
+fail!("articles preload misses the writing index") unless preload.include?("data/writing_index.json")
+fail!("preload must run before stylesheets") unless shell.index("critical-preload.html") < shell.index('href="/assets/css/base.css"')
+
+fail!("loadJson ignores the preload cache") unless fragments.include?("window.__pandorgaPreload")
+fail!("quiet fragments still write Loading...") unless fragments.include?("data-content-quiet")
+fail!("a painted fragment is written twice") unless fragments.include?("data-content-painted")
+
+fail!("hero summary is not quiet") unless home.include?('data-content-fragment="cv/summary" data-content-quiet')
+fail!("hero subtitle is not quiet") unless home.include?('data-content-fragment="home/subtitle" data-content-quiet')
+fail!("hero does not paint the summary early") unless home.include?("paint('home-cv-summary'")
+fail!("hero subtitle size left --type-body") unless home_css.include?("font-size: var(--type-body);")
+tagline = home_css[/\.home-hero-tagline \{[^}]*\}/m]
+fail!("tagline rule missing") unless tagline
+fail!("tagline is not body size") unless tagline.include?("font-size: var(--type-body);")
+fail!("hero summary has no reserved box") unless home_css.include?(".home-hero-summary:empty")
+
+fail!("articles listing has no row reserve") unless articles.include?("writing-reserve-row")
+fail!("articles lead has no reserved box") unless writing_css.include?("#articles-lead:empty")
+fail!("CV experience has no reserve") unless cv.include?('id="cv-experience-list"') && cv.include?("data-content-reserve")
+fail!("CV summary still ships Loading...") if cv.include?("Loading...")
+fail!("showLoadingState collapses a reserve") unless listing.include?("data-content-reserve")
+fail!("CV reserve card has no height") unless cv_css.include?(".cv-reserve-card")
+
+revised = writing_css[/\.writing-index \.writing-revised \{[^}]+\}/m]
+fail!("writing-revised rule missing") unless revised
+fail!("writing-revised still fades the ink") if revised.include?("color-mix") || revised.include?("transparent")
+fail!("writing-revised is not the variant ink") unless revised.include?("color: var(--color-on-surface-variant);")
+
+selectable = blocks[/function renderProjectInventoryRow.*?function renderSystemCard/m]
+fail!("inventory renderer missing") unless selectable
+fail!("selectable inventory row is still an article with role=button") if selectable.include?("role', 'button'") || selectable.include?('role", "button"') || selectable.include?("setAttribute('role'")
+fail!("selectable inventory row is not a button") unless selectable.include?("createElement(selectable ? 'button' : 'article')")
+
+puts "PASS test-hydrate-reserve"

data/scripts/test/test-new.rb

@@ -21,6 +21,17 @@ def run_doctor(dir)
   Open3.capture3(env, "ruby", EXE.to_s, "doctor", dir.to_s)
 end
 
+guide = ROOT.join("docs/getting-started.md").read
+readme = ROOT.join("README.md").read
+unless guide.include?('gem at `~> 1.3`')
+  warn "FAIL test-new: getting-started must document the scaffold pin ~> 1.3"
+  exit 1
+end
+if readme.include?("once 1.1 is on RubyGems")
+  warn "FAIL test-new: README still says the gem is unpublished at 1.1"
+  exit 1
+end
+
 FileUtils.rm_rf(DEST)
 
 stdout, stderr, status = run_new(DEST.to_s)

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

@@ -0,0 +1,30 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Shell accessibility (skip link and home-link name).
+# The top bar and footer used site.author alone, so a site with no author
+# exposed the accessible name " – Home" and hid the visible wordmark.
+
+require "pathname"
+
+ROOT = Pathname.new(__dir__).join("..", "..").expand_path
+SHELL = ROOT.join("_layouts/shell.html").read
+FOOTER = ROOT.join("_includes/page/site-footer.html").read
+CSS = ROOT.join("assets/css/ledger/chrome.css").read
+
+def fail!(message)
+  warn "FAIL test-shell-a11y: #{message}"
+  exit 1
+end
+
+fail!("missing skip link") unless SHELL.include?('class="skip-link"') && SHELL.include?('href="#page-content"')
+fail!("missing skip target") unless SHELL.include?('id="page-content"')
+fail!("skip link is not shown on focus") unless CSS.include?(".skip-link:focus")
+
+bare = 'aria-label="{{ site.author }} – Home"'
+fail!("shell home link still uses site.author alone") if SHELL.include?(bare)
+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")
+
+puts "PASS test-shell-a11y"

data/scripts/test/test-template-packages.rb

@@ -46,6 +46,14 @@ TEMPLATES.each do |name|
   end
 end
 
+%w[_includes/chord-tab.html _includes/transcription.html].each do |rel|
+  text = ROOT.join(rel).read
+  if text.include?("Exibe")
+    warn "FAIL test-template-packages: #{rel} still has a Portuguese comment"
+    failed = true
+  end
+end
+
 exit 1 if failed
 
 puts "PASS test-template-packages"

data/scripts/test/test-validate-allowlist.rb

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# A listed gate that is not on disk must fail the run. Skipping it lets a
+# renamed test disappear from CI while validate.sh still exits 0.
+
+require "pathname"
+
+ROOT = Pathname.new(__dir__).join("..", "..").expand_path
+SCRIPT = ROOT.join("scripts/validate.sh")
+
+def fail!(message)
+  warn "FAIL test-validate-allowlist: #{message}"
+  exit 1
+end
+
+source = SCRIPT.read
+block = source[/if \[\[ ! -f "\$test" \]\]; then.*?fi/m]
+fail!("missing-file branch not found") unless block
+fail!("a missing listed test must set failed=1") unless block.include?("failed=1")
+fail!("a missing listed test must not be skipped") if block.include?("skip")
+
+listed = source.scan(%r{scripts/test/test-[A-Za-z0-9_.-]+})
+fail!("allowlist is empty") if listed.empty?
+
+missing = listed.uniq.reject { |rel| ROOT.join(rel).file? }
+fail!("listed tests are not on disk: #{missing.join(', ')}") unless missing.empty?
+
+puts "PASS test-validate-allowlist"

data/scripts/validate.sh

@@ -55,12 +55,18 @@ TESTS=(
   scripts/test/test-r2-json-sync.rb
   scripts/test/test-writing-slug-limits.rb
   scripts/test/test-examples-build.rb
+  scripts/test/test-validate-allowlist.rb
+  scripts/test/test-shell-a11y.rb
+  scripts/test/test-hydrate-reserve.rb
+  scripts/test/test-css-delivery.rb
+  scripts/test/test-discovery.rb
 )
 
 failed=0
 for test in "${TESTS[@]}"; do
   if [[ ! -f "$test" ]]; then
-    echo "-- ${test} (missing, skip)"
+    echo "-- ${test} (missing)"
+    failed=1
     continue
   fi
   echo "-- ${test}"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pandorga
 version: !ruby/object:Gem::Version
-  version: 1.5.0
+  version: 1.6.0
 platform: ruby
 authors:
 - The Pandorga contributors
@@ -149,9 +149,11 @@ files:
 - _includes/page/site-footer.html
 - _includes/page/timeline-section.html
 - _includes/plotly.html
+- _includes/theme/critical-preload.html
 - _includes/theme/dev-reexport.html
 - _includes/theme/favicons.html
 - _includes/theme/font-loader.html
+- _includes/theme/json-ld.html
 - _includes/theme/shell-theme-boot.html
 - _includes/theme/site-logo.html
 - _includes/theme/tailwind-theme-colors.json.liquid
@@ -212,7 +214,6 @@ files:
 - _plugins/writing_slug_limits.rb
 - assets/css/article.css
 - assets/css/base.css
-- assets/css/cv.css
 - assets/css/global-link.css
 - assets/css/ledger/bibliography.css
 - assets/css/ledger/chrome.css
@@ -225,6 +226,7 @@ files:
 - assets/css/ledger/rascunhos.css
 - assets/css/ledger/sources.css
 - assets/css/ledger/writing.css
+- assets/css/tailwind.css
 - assets/icons/studio-logo.svg
 - assets/tailwind-play.js
 - examples/full/Gemfile
@@ -269,6 +271,7 @@ files:
 - lib/pandorga/commands/publish.rb
 - lib/pandorga/commands/serve.rb
 - lib/pandorga/commands/studio_schema.rb
+- lib/pandorga/discovery.rb
 - lib/pandorga/jekyll.rb
 - lib/pandorga/jekyll/generator.rb
 - lib/pandorga/jekyll/plugins/bibliography_artifact.rb
@@ -282,6 +285,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/discovery.rb
 - lib/pandorga/jekyll/plugins/force_utf8_encoding.rb
 - lib/pandorga/jekyll/plugins/git_chronology.rb
 - lib/pandorga/jekyll/plugins/git_metadata.rb
@@ -318,6 +322,9 @@ files:
 - scripts/lib/writing_index_contract.rb
 - scripts/pdf/md-to-pdf.mjs
 - scripts/pdf/md-to-pdf.sh
+- scripts/tailwind/build.sh
+- scripts/tailwind/input.css
+- scripts/tailwind/tailwind.config.js
 - scripts/test/fixtures/dual-template/_config.yml
 - scripts/test/fixtures/dual-template/index.html
 - scripts/test/render-parity/article-note.json
@@ -379,10 +386,12 @@ files:
 - scripts/test/test-content-license.rb
 - scripts/test/test-content-render-parity.rb
 - scripts/test/test-content-validators.rb
+- scripts/test/test-css-delivery.rb
 - scripts/test/test-css-structure.rb
 - scripts/test/test-cv-export-contract.rb
 - scripts/test/test-detail-render-parity.rb
 - scripts/test/test-dev-reexport.rb
+- scripts/test/test-discovery.rb
 - scripts/test/test-doctor.rb
 - scripts/test/test-dual-template-instances.rb
 - scripts/test/test-dual-template-runtime.rb
@@ -396,6 +405,7 @@ files:
 - scripts/test/test-hero-portraits.mjs
 - scripts/test/test-hero-portraits.rb
 - scripts/test/test-home-band-art.rb
+- scripts/test/test-hydrate-reserve.rb
 - scripts/test/test-install-functions.rb
 - scripts/test/test-language-export.rb
 - scripts/test/test-ledger-blocks.rb
@@ -410,6 +420,7 @@ files:
 - scripts/test/test-r2-json-sync.rb
 - scripts/test/test-registry-home.rb
 - scripts/test/test-runtime-js-syntax.rb
+- scripts/test/test-shell-a11y.rb
 - scripts/test/test-slim-writing-index.rb
 - scripts/test/test-studio-api-contract.rb
 - scripts/test/test-studio-content-files.rb
@@ -425,6 +436,7 @@ files:
 - scripts/test/test-text-excerpt.rb
 - scripts/test/test-unwrap-media-src.mjs
 - scripts/test/test-unwrap-media-src.rb
+- scripts/test/test-validate-allowlist.rb
 - scripts/test/test-withdrawn-content-export.rb
 - scripts/test/test-writing-index-export-slugs.rb
 - scripts/test/test-writing-slug-limits.rb

data/assets/css/cv.css

@@ -1,13 +0,0 @@
-/* ── Public CV page ── (intentionally empty)
-
-   This file held the pre-redesign CV entry styles: .cv-section, .job-title,
-   .job-department, .job-meta, .institution and .cv-description. The public CV
-   page was rebuilt as the architectural register in `_layouts/cv.html`, which
-   emits .cv-register / .cv-entry-* / .cv-product-* and styles them from
-   `assets/css/ledger/cv.css`. None of the six old classes is emitted by any
-   layout, include, runtime renderer or content file any more, so they were
-   removed rather than left to rot.
-
-   The file itself stays because `_layouts/shell.html` links it unconditionally
-   and dropping the <link> belongs to whoever owns that layout. Once that line
-   is gone, delete this file. */