pandorga 2.0.2 → 2.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 138bcb8f0c2e5c6eec6316000865742ac1ebb5c57703beb8db532bfdca64a270
-  data.tar.gz: 9f7fc0e7385d8b542cd6507fe00c0e1110012d4ec7688e277978ecfb611d9034
+  metadata.gz: 2dc703ecd304ea907703cb189abd6ef09f0747c42e36766b365b6cab275f50f5
+  data.tar.gz: 1ae4bbec818b879199980c53e8c00e46d91c611b984f56f4d31fb5046b0fb1b0
 SHA512:
-  metadata.gz: 46f7672a6254b39d874c34ba00555a287a94feabbba29d59582cdd2b8436fa874b6c7a3c0ff5070c9bebd83f5cd71144458ed19068c6d553001d8c6d5d9f6e5d
-  data.tar.gz: 95017e5b2b5d9152a41d705fd652546273e812f9f4efa7048792f34b08cf0272478d06680e3e707360425ef22a5329cb758863bcf2250f2a67dfdc31f6f50dee
+  metadata.gz: 4a87bd7621049333217620dcb59f44abda1d072edec0ea4aa06c362a60fee39d9c2b2ff4d75530c2b346caac34b715dd06bee92f0c4b880ce7308921a5cd2eed
+  data.tar.gz: f033221a651aae72e83efefb0839c2eafc4ce5ddfb2405ef13c4359c326fea85c7489224ef8e5d2e31f8a934cb7b7efd5c598481e51a6423de61d281f6f44b3d

data/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 ## [Unreleased]
 
+## [2.0.4] — 2026-10-28
+
+### Fixed
+
+- Mobile article top compresses dates and action buttons into one band and closes the gap before the reading column.
+- Mobile top bar is shorter and hides on scroll-down (shows on scroll-up, focus, or Explore open).
+- Home hero summary uses a ~65ch measure on desktop.
+- Home section "View all" sits beside the section title instead of at the far right of the band.
+
+## [2.0.3] — 2026-10-25
+
+### Fixed
+
+- Entry titles on the Articles, Sources and Bibliography pages use the Rascunhos size at every width. The Articles rows and Sources cards were a step smaller and shrank again below 768px, and the Bibliography cards were a step smaller (PLT-AC-55).
+
 ## [2.0.2] — 2026-10-25
 
 ### Added

data/DESIGN.md

@@ -762,7 +762,7 @@ those tokens — no one-off rem sizes for roles that already have a step.
 | Page H1 | Cinzel Decorative | 400 | `--type-page` / `-lg` |
 | Section | Cinzel Decorative | 400 | `--type-section` / `-lg` |
 | Detail title | Newsreader | 600 | `--type-title` / `-lg` |
-| Card / row title | Newsreader | 600 | `--type-card` / `-lg` |
+| Card / row title | Newsreader | 600 | `--type-card` / `-lg`; listing entry titles always `-lg` (PLT-AC-55) |
 | Prose | Newsreader | 300 | `--type-prose` |
 | UI body | Newsreader | 300 | `--type-body` |
 | Detail standfirst | Newsreader | 300 | `--type-subtitle` (= body − 1pt) |

data/_layouts/shell.html

@@ -287,11 +287,13 @@
       var wrap = document.getElementById('site-menu');
       var btn = document.getElementById('mobile-menu-btn');
       var menu = document.getElementById('mobile-menu');
+      var topbar = document.querySelector('.site-topbar');
       if (!wrap || !btn || !menu) return;
 
       function setOpen(open) {
         menu.classList.toggle('hidden', !open);
         btn.setAttribute('aria-expanded', String(open));
+        if (open && topbar) topbar.classList.remove('topbar--hidden');
       }
 
       btn.addEventListener('click', function (event) {
@@ -304,6 +306,29 @@
       document.addEventListener('keydown', function (event) {
         if (event.key === 'Escape') setOpen(false);
       });
+
+      if (!topbar) return;
+      var lastY = window.scrollY || 0;
+      var threshold = 8;
+
+      function onScroll() {
+        var y = window.scrollY || 0;
+        var diff = y - lastY;
+
+        if (y <= 32 || !menu.classList.contains('hidden')) {
+          topbar.classList.remove('topbar--hidden');
+        } else if (diff > threshold) {
+          topbar.classList.add('topbar--hidden');
+        } else if (diff < -threshold) {
+          topbar.classList.remove('topbar--hidden');
+        }
+        lastY = y;
+      }
+
+      window.addEventListener('scroll', onScroll, { passive: true });
+      topbar.addEventListener('focusin', function () {
+        topbar.classList.remove('topbar--hidden');
+      });
     })();
   </script>
 

data/assets/css/base.css

@@ -527,11 +527,11 @@ html[data-theme="dark"] {
   --color-link-hover: color-mix(in srgb, var(--color-tertiary) 72%, var(--color-on-surface));
 }
 
-/* Card / row / collection entry titles — content-title voice (Regular 400). */
+/* Card / row / collection entry titles — content-title voice (Regular 400).
+   Listing rows and source cards also carry .card-title, so they get the voice
+   here and their size from the listing entry rule below. */
 .card-title,
-.ledger-card-title,
-.ledger-row-title,
-.source-card-title {
+.ledger-card-title {
   font-family: var(--font-content-title);
   font-size: var(--type-card);
   font-weight: var(--weight-title);
@@ -554,6 +554,17 @@ html[data-theme="dark"] {
   }
 }
 
+/* Listing entry titles (PLT-AC-55). The Articles and Rascunhos rows and the
+   Sources and Bibliography cards set their entry title at the Rascunhos step
+   at every width. This rule follows the small-screen step above on purpose,
+   so it holds below 768px too. */
+.ledger-row-title,
+.source-card-title,
+.bib-card-title {
+  font-size: var(--type-card-lg);
+  line-height: 1.25;
+}
+
 /* Label-face meta on CV identity lines, etc. */
 .card-meta {
   font-family: var(--font-label);

data/assets/css/ledger/bibliography.css

@@ -138,8 +138,6 @@
 
 .bib-card-title {
   margin: 0;
-  font-size: var(--type-card);
-  line-height: 1.25;
   color: var(--color-on-surface);
   overflow-wrap: anywhere;
 }

data/assets/css/ledger/chrome.css

@@ -35,6 +35,18 @@
   -webkit-backdrop-filter: blur(10px);
   backdrop-filter: blur(10px);
   border-bottom: 1px solid var(--border-gentle-divider);
+  transition: transform var(--motion-duration-fast) var(--motion-ease-default);
+}
+
+@media (max-width: 767px) {
+  .site-topbar > div {
+    padding-top: 0.625rem;
+    padding-bottom: 0.625rem;
+  }
+
+  .site-topbar.topbar--hidden {
+    transform: translateY(-100%);
+  }
 }
 
 /* Boxed controls for theme and mobile menu toggles. */

data/assets/css/ledger/detail.css

@@ -694,7 +694,8 @@ aside:has(> .text-detail-sidebar) {
 
   .text-detail-sidebar .article-toc--disclosure,
   .projects-dossier .article-toc--disclosure {
-    margin-top: var(--space-sm);
+    margin-top: var(--space-xs);
+    margin-bottom: var(--space-xs);
   }
 }
 
@@ -1184,7 +1185,7 @@ nav.text-page-nav:not(:has(a)) {
   }
 
   .grid.text-detail-grid {
-    gap: var(--space-md);
+    gap: var(--space-xs);
   }
 
   /* The reading column used to add its own top margin on top of this gap,
@@ -1232,12 +1233,32 @@ nav.text-page-nav:not(:has(a)) {
     padding-bottom: var(--space-md);
   }
 
-  /* The date row's own top rule leaves --space-sm above the text. The
-     flex gap was stacking another --space-md on the action rule, so the
-     date sat high in that band. Drop the gap and the action margin is the
-     matching --space-sm under the text. */
+  /* On mobile, date row and action buttons share one compact horizontal band. */
   .text-detail-sidebar .article-meta {
-    gap: 0;
+    display: flex;
+    flex-direction: row;
+    flex-wrap: wrap;
+    align-items: center;
+    justify-content: space-between;
+    gap: var(--space-xs) var(--space-sm);
+    margin-bottom: 0;
+    padding-bottom: 0;
+  }
+
+  .text-detail-sidebar .article-meta > div {
+    margin: 0;
+    padding: 0;
+  }
+
+  .text-detail-sidebar .article-meta .date-evolution > span {
+    border-top: 0;
+    padding-top: 0;
+  }
+
+  .text-detail-sidebar .article-meta .detail-actions {
+    margin-top: 0;
+    padding-top: 0;
+    border-top: 0;
   }
 
   .text-detail-sidebar .article-sidebar-description,

data/assets/css/ledger/home.css

@@ -220,6 +220,12 @@
   line-height: var(--leading-body);
 }
 
+@media (min-width: 768px) {
+  .home-hero-summary {
+    max-width: 65ch;
+  }
+}
+
 /* No empty min-height. A guessed line count shifts the call to action
    when the summary is shorter or taller than the reserve. The paragraph
    is in the HTML when content/pages/home/summary.md or
@@ -415,7 +421,7 @@ html[data-theme="light"] .home-hero-plate {
    The banner is a 2-column grid so the lead's children join the template. */
 .home-band:not(.home-band--hero) .ledger-section-banner {
   display: grid;
-  grid-template-columns: minmax(0, 1fr) auto;
+  grid-template-columns: auto auto 1fr;
   column-gap: var(--space-md);
   row-gap: var(--space-xs);
   align-items: baseline;

data/assets/css/ledger/rascunhos.css

@@ -204,13 +204,6 @@
   text-transform: uppercase;
 }
 
-/* Entry titles — a step above the shared ledger-row scale so the notebook
-   line reads as a title, not a caption. */
-.rascunhos-row .ledger-row-title {
-  font-size: var(--type-card-lg);
-  line-height: 1.25;
-}
-
 /* ══ Ledger entry ══
    Ruled paper, not a stack of cards: the shared row's card fill and padding
    come off, and what separates two entries is the hairline under each one.

data/lib/pandorga/commands/new.rb

@@ -24,7 +24,7 @@ module Pandorga
 
         gem "pandorga", "~> 2.0"
         # Local checkout: gem "pandorga", path: "../pandorga"
-        # GitHub tag: gem "pandorga", github: "alexandrelheinen/pandorga", tag: "v2.0.2"
+        # GitHub tag: gem "pandorga", github: "alexandrelheinen/pandorga", tag: "v2.0.4"
         gem "csv"
         gem "base64"
       RUBY

data/lib/pandorga/version.rb

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

data/scripts/test/test-listing-entry-titles.rb

@@ -0,0 +1,107 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# PLT-AC-55: listing entry titles on the Articles, Rascunhos, Sources and
+# Bibliography pages share one size, the Rascunhos step, at every width.
+
+require "pathname"
+
+ROOT = Pathname.new(__dir__).join("..", "..").expand_path
+CSS_ROOT = ROOT.join("assets/css")
+TITLE_CLASSES = %w[.ledger-row-title .source-card-title .bib-card-title].freeze
+
+def fail!(message)
+  warn "FAIL: #{message}"
+  exit 1
+end
+
+def strip_comments(source)
+  source.gsub(%r{/\*.*?\*/}m, "")
+end
+
+# Yields [selectors, declarations, offset] for every rule, descending into
+# at-rule blocks such as media queries.
+def each_rule(source, &block)
+  depth_start = 0
+  i = 0
+  while (open = source.index("{", i))
+    prelude = source[i...open].strip
+    depth = 1
+    j = open + 1
+    while depth.positive? && j < source.length
+      depth += 1 if source[j] == "{"
+      depth -= 1 if source[j] == "}"
+      j += 1
+    end
+    body = source[(open + 1)...(j - 1)]
+    if prelude.start_with?("@")
+      each_rule(body, &block) if body.include?("{")
+    else
+      selectors = prelude.split(",").map { |s| s.strip.gsub(/\s+/, " ") }
+      yield selectors, body, open + depth_start
+    end
+    i = j
+  end
+end
+
+def last_compound(selector)
+  selector.split(/\s*[ >+~]\s*/).last.to_s
+end
+
+def declares?(body, property)
+  body.match?(/(?:^|;|\s)#{Regexp.escape(property)}\s*:/)
+end
+
+puts "Testing listing entry titles (PLT-AC-55)..."
+
+base = strip_comments(CSS_ROOT.join("base.css").read)
+shared = []
+each_rule(base) do |selectors, body, offset|
+  shared << [body, offset] if selectors.sort == TITLE_CLASSES.sort
+end
+fail!("base.css needs exactly one rule for #{TITLE_CLASSES.join(', ')}") unless shared.size == 1
+body, shared_offset = shared.first
+fail!("shared rule must set font-size: var(--type-card-lg)") unless body.match?(/font-size:\s*var\(--type-card-lg\)\s*;/)
+fail!("shared rule must set line-height: 1.25") unless body.match?(/line-height:\s*1\.25\s*;/)
+
+small_step = base.index("var(--type-card-sm)", base.index("--type-card-sm:") + 1)
+fail!("small-screen .card-title step not found in base.css") unless small_step
+fail!("shared rule must follow the small-screen .card-title step") unless shared_offset > small_step
+puts "  shared rule: OK"
+
+offenders = []
+Dir.glob(CSS_ROOT.join("**", "*.css")).sort.each do |path|
+  source = strip_comments(File.read(path))
+  each_rule(source) do |selectors, rule_body, _offset|
+    next if selectors.sort == TITLE_CLASSES.sort && path == CSS_ROOT.join("base.css").to_s
+
+    targeted = selectors.select do |sel|
+      compound = last_compound(sel)
+      TITLE_CLASSES.any? { |cls| compound.include?(cls) && !compound.match?(/#{Regexp.escape(cls)}[-\w]/) }
+    end
+    next if targeted.empty?
+
+    %w[font-size line-height].each do |prop|
+      next unless declares?(rule_body, prop)
+
+      offenders << "#{Pathname.new(path).relative_path_from(ROOT)}: #{targeted.join(', ')} sets #{prop}"
+    end
+  end
+end
+fail!("entry title overrides:\n  #{offenders.join("\n  ")}") unless offenders.empty?
+puts "  no overrides: OK"
+
+markup = {
+  "_includes/content-runtime/43-blocks.html" => "ledger-row-title",
+  "_layouts/resources.html" => "source-card-title",
+  "_layouts/bibliography.html" => "bib-card-title"
+}
+markup.each do |file, cls|
+  fail!("#{file} no longer emits #{cls}") unless ROOT.join(file).read.include?(cls)
+end
+%w[_layouts/articles.html _layouts/blog.html].each do |file|
+  fail!("#{file} no longer renders rows with renderLedgerRow") unless ROOT.join(file).read.include?("renderLedgerRow(")
+end
+puts "  markup: OK"
+
+puts "All listing entry title checks passed."

data/scripts/test/test-mobile-density-home-measure.rb

@@ -0,0 +1,161 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Acceptance tests for Mobile density + home measure (pandorga theme UI).
+#
+# 1. Article page top on mobile: meta date row and action buttons share one band,
+#    and TOC disclosure / reading column gaps are bounded.
+# 2. Fixed top bar on mobile: shorter vertical padding (≤56-60px height) and
+#    hide-on-scroll functionality.
+# 3. Home hero summary measure on desktop: constrained to ~60-70ch (e.g. 65ch).
+# 4. Home section "View all" next to title: grid-template-columns places CTA
+#    beside section title, not at far right of wide band.
+
+require "pathname"
+
+ROOT = Pathname.new(__dir__).join("../..").expand_path
+CSS = ROOT.join("assets/css")
+
+$failures = []
+
+def fail!(msg)
+  $failures << "FAIL test-mobile-density-home-measure: #{msg}"
+end
+
+def strip_comments(text)
+  text.gsub(%r{/\*.*?\*/}m, "")
+end
+
+def parse_css_rules(css_text)
+  rules = []
+  i = 0
+  head = +""
+  while i < css_text.length
+    c = css_text[i]
+    if c == "{"
+      depth = 1
+      j = i + 1
+      while j < css_text.length && depth.positive?
+        depth += 1 if css_text[j] == "{"
+        depth -= 1 if css_text[j] == "}"
+        j += 1
+      end
+      body = css_text[(i + 1)...(j - 1)]
+      h = head.strip
+      if h.start_with?("@media")
+        media_cond = h.sub(/\A@media\s*/, "").gsub(/\s+/, "")
+        sub_rules = parse_css_rules(body)
+        sub_rules.each do |r|
+          m = r[:media] ? "#{media_cond} and #{r[:media]}" : media_cond
+          rules << r.merge(media: m)
+        end
+      elsif h.start_with?("@supports", "@layer", "@container")
+        rules.concat(parse_css_rules(body))
+      elsif !h.start_with?("@")
+        decls = body.split(";").filter_map do |d|
+          prop, val = d.split(":", 2)
+          next unless val
+
+          [prop.strip.downcase, val.gsub(/\s+/, " ").strip]
+        end
+        h.split(",").each do |sel|
+          s = sel.gsub(/\s+/, " ").strip
+          rules << { sel: s, decls: decls, media: nil }
+        end
+      end
+      head = +""
+      i = j
+    elsif c == "}"
+      i += 1
+    else
+      head << c
+      i += 1
+    end
+  end
+  rules
+end
+
+# 1. Article page top on mobile
+detail_css = strip_comments(File.read(CSS.join("ledger/detail.css")))
+detail_rules = parse_css_rules(detail_css)
+
+meta_mobile_rules = detail_rules.select do |r|
+  r[:media] && r[:media].include?("max-width:767px") && r[:sel] == ".text-detail-sidebar .article-meta"
+end
+
+has_row_layout = meta_mobile_rules.any? do |r|
+  r[:decls].any? { |p, v| p == "flex-direction" && v == "row" }
+end
+
+unless has_row_layout
+  fail!("detail.css must set flex-direction: row on .text-detail-sidebar .article-meta under @media (max-width: 767px)")
+end
+
+toc_disclosure_mobile = detail_rules.select do |r|
+  r[:media] && r[:media].include?("max-width:767px") && r[:sel].include?("article-toc--disclosure")
+end
+
+has_bounded_toc_margin = toc_disclosure_mobile.any? do |r|
+  r[:decls].any? { |p, v| (p == "margin-top" || p == "margin-bottom" || p == "margin") && (v.include?("var(--space-xs)") || v.include?("var(--space-sm)") || v.include?("0")) }
+end
+
+unless has_bounded_toc_margin
+  fail!("detail.css must bound margins on .article-toc--disclosure under @media (max-width: 767px)")
+end
+
+# 2. Fixed top bar on mobile
+chrome_css = strip_comments(File.read(CSS.join("ledger/chrome.css")))
+chrome_rules = parse_css_rules(chrome_css)
+
+topbar_mobile_padding = chrome_rules.any? do |r|
+  r[:media] && r[:media].include?("max-width:767px") && (r[:sel] == ".site-topbar > div" || r[:sel] == ".site-topbar") &&
+    r[:decls].any? { |p, v| (p == "padding-top" || p == "padding-bottom" || p == "padding" || p == "padding-block") && (v.include?("0.625rem") || v.include?("0.5rem") || v.include?("0.75rem") || v.include?("10px") || v.include?("12px")) }
+end
+
+unless topbar_mobile_padding
+  fail!("chrome.css must reduce vertical padding on .site-topbar under @media (max-width: 767px)")
+end
+
+topbar_hide_rule = chrome_rules.any? do |r|
+  (r[:sel].include?(".site-topbar.topbar--hidden") || r[:sel].include?(".site-topbar[data-topbar-hidden]")) &&
+    r[:decls].any? { |p, v| p == "transform" && v.include?("translateY(-100%)") }
+end
+
+unless topbar_hide_rule
+  fail!("chrome.css must define transform: translateY(-100%) on .site-topbar.topbar--hidden")
+end
+
+shell_html = File.read(ROOT.join("_layouts/shell.html"))
+unless shell_html.include?("topbar--hidden") || shell_html.include?("data-topbar-hidden")
+  fail!("_layouts/shell.html must contain hide-on-scroll logic for .site-topbar")
+end
+
+# 3. Home hero summary measure on desktop
+home_css = strip_comments(File.read(CSS.join("ledger/home.css")))
+home_rules = parse_css_rules(home_css)
+
+hero_summary_desktop = home_rules.any? do |r|
+  r[:media] && r[:media].include?("min-width:768px") && r[:sel] == ".home-hero-summary" &&
+    r[:decls].any? { |p, v| p == "max-width" && (v == "65ch" || v == "60ch" || v == "70ch") }
+end
+
+unless hero_summary_desktop
+  fail!("home.css must constrain .home-hero-summary max-width to ~65ch under @media (min-width: 768px)")
+end
+
+# 4. Home section "View all" next to title
+banner_grid_col = home_rules.any? do |r|
+  r[:sel] == ".home-band:not(.home-band--hero) .ledger-section-banner" &&
+    r[:decls].any? { |p, v| p == "grid-template-columns" && (v.start_with?("auto auto") || v.start_with?("minmax(0, auto) auto") || v.start_with?("max-content max-content")) }
+end
+
+unless banner_grid_col
+  fail!("home.css must set grid-template-columns on .ledger-section-banner to place CTA beside title (e.g. auto auto 1fr)")
+end
+
+if $failures.empty?
+  puts "PASS test-mobile-density-home-measure"
+else
+  $failures.each { |f| puts f }
+  exit 1
+end

data/scripts/test/test-v3-layout.rb

@@ -290,7 +290,7 @@ end
 item(5) do
   h = "ledger/home.css"
   expect(h, ".home-band:not(.home-band--hero) .ledger-section-banner", {
-    "display" => "grid", "grid-template-columns" => "minmax(0, 1fr) auto"
+    "display" => "grid", "grid-template-columns" => "auto auto 1fr"
   })
   expect(h, ".home-band .ledger-section-lead", { "display" => "contents" })
   expect(h, ".home-band .ledger-section-banner .ledger-kicker", { "grid-column" => "1 / -1", "grid-row" => "1" })

data/scripts/validate.sh

@@ -62,6 +62,7 @@ TESTS=(
   scripts/test/test-theme-contrast.rb
   scripts/test/test-hydrate-reserve.rb
   scripts/test/test-hero-summary.rb
+  scripts/test/test-listing-entry-titles.rb
   scripts/test/test-lighthouse-policy.rb
   scripts/test/test-home-lists.rb
   scripts/test/test-home-articles.rb
@@ -79,6 +80,7 @@ TESTS=(
   scripts/test/test-studio-section-texts.rb
   scripts/test/test-home-article-cards.rb
   scripts/test/test-parallel-content-publish.rb
+  scripts/test/test-mobile-density-home-measure.rb
 )
 
 failed=0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pandorga
 version: !ruby/object:Gem::Version
-  version: 2.0.2
+  version: 2.0.4
 platform: ruby
 authors:
 - The Pandorga contributors
@@ -449,9 +449,11 @@ files:
 - scripts/test/test-language-export.rb
 - scripts/test/test-ledger-blocks.rb
 - scripts/test/test-lighthouse-policy.rb
+- scripts/test/test-listing-entry-titles.rb
 - scripts/test/test-listing-filter-contract.rb
 - scripts/test/test-math-row-breaks.mjs
 - scripts/test/test-math-row-breaks.rb
+- scripts/test/test-mobile-density-home-measure.rb
 - scripts/test/test-new.rb
 - scripts/test/test-no-personal-data.rb
 - scripts/test/test-parallel-content-publish.rb