pandorga 1.10.2 → 1.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4e66f241523945a85596363141b9693e01ac61e5d6eec0771366ced0ef2dc8b6
-  data.tar.gz: 7f00fe9a24f801f42065b3b80d760ccdc1b57fc6c46d89664e2f4e654168a545
+  metadata.gz: 9d3adc84d250c4ff140df5b9cc9db266896fdfce92fd899789fd943ce8ac4659
+  data.tar.gz: 474d788dea7851796fb189732c9bb75d118666177f4cf81df70d8361f4310872
 SHA512:
-  metadata.gz: 92e01266bf8f8f0c3a59f47596dd2d589dbd357d361471ecd59fba91d1e44b172f9c7eb3bc9b4958e0a27e8e5cb191637fb908044ec0c4a92b67e20b1237eb28
-  data.tar.gz: b10c2447cc7dbead75c291ffd0abdd0a32854906dcb87ffc763d4f0435b31836417eb99f0a7a01649c19b1d3b1572fd56865c2b566ead68c62828964e0d42daa
+  metadata.gz: d9e76b0be8485c3870366cce0bc816fc55f3dee7ea2b17ec40602f2c70dccbf985e2d7be6da7911e54a7f830c6fd3c4030dbb985689d50c84cb9226c04cd0f2e
+  data.tar.gz: 6853fe1a1d0edd4066d45187a4cddd67258a753afd849284615383fb9cae4844a24aabff188681a73066e2808170bfc1e28730832e68d976c34400899d2cea88

data/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## [Unreleased]
+
+## [1.11.0] — 2026-10-19
+
+### Fixed
+
+- Home listing bands keep their kicker and note on sites built with
+  `shell_content_agnostic: true`; the slots are always in the HTML and the
+  runtime fills them from `pages/headers.json` (regression from 1.10.0)
+
+### Changed
+
+- On the home projects bench at or above 900px, the specimen column takes 35%
+  of the band (at least 20rem) and the filing rack 45% (at least 21rem) across
+  one `--space-xl` column gap from the band's left edge, keeping the 16:9
+  plate at 60% of its previous height. The specimen sets the bench height (the
+  tallest project), and the rack rows share that height, each capped at 1.6
+  times its minimum
+- Below 900px the project icon-strip glyphs and the plate badge glyph grow to
+  1.375rem
+- The home project specimen title uses `--type-section` from 900px and
+  `--type-card-lg` below it; inventory rack titles use `--type-card`
+- The home specimen meta strip wraps instead of clipping on narrow viewports
+- The home hero summary uses `--color-legend`, the same ink as the other
+  description texts
+
 ## [1.10.2] — 2026-10-16
 
 ### Changed

data/DESIGN.md

@@ -941,13 +941,15 @@ Letter-spacing in use, by frequency: `0.1em` (12), `0.08em` (10), `0.12em` (7),
   icon plate, the name's initial standing in for a missing icon; the title
   always below the plate; a tagline clamped to the
   height the plate leaves; tags, outbound links and an emphasis "Open
-  project" cue). From 900px it takes 50% of the band, beside a 34%
-  `panelContrast` filing rack of equal-flex project cards (16:9 thumb, code
-  line, title, tagline; the selected card steps to `surfaceHigh` with a 3px
-  `primary` inset rule), the rest left blank. Rack click swaps the specimen
+  project" cue). From 900px the specimen and a `panelContrast` filing rack
+  take 35% and 45% of the band across a `--space-xl` gap, from its left edge;
+  rack rows are equal-flex
+  cards (square icon mark, code line, title; the selected one steps to
+  `surfaceHigh` with a 3px `primary` inset rule) that share the specimen's
+  height. Rack click swaps the specimen
   in place; specimen click opens the project. Below 900px the rack is an
   icon strip above the specimen, one equal column per project (up to six)
-  so it spans the band. Contract: `PLT-AC-13`–`17` in
+  so it spans the band, with 1.375rem glyphs. Contract: `PLT-AC-13`–`17` in
   `templates/portfolio/README.md`. Below 768px the hero portrait runs to the screen edge, pulled
   out of the band's gutter by exactly `--gutter-mobile` on each side and losing
   its side hairlines, which at the edge would read as a frame cut off.

data/_includes/home/band-listing.html

@@ -1,6 +1,8 @@
 {%- comment -%}
   One homepage listing band. Expects `band` from site.data.pandorga_home_bands.
-  Markup slots are filled by the home layout script from writing_index.json.
+  Kicker and note slots are always emitted, prefilled from headers.yml when it
+  was read at build time and filled by the runtime otherwise (PLT-AC-42).
+  Listing slots are filled by the home layout script from writing_index.json.
 {%- endcomment -%}
 {%- assign _accent = band.accent -%}
 {%- assign _limit = band.home.limit | default: 3 -%}
@@ -28,13 +30,9 @@
     {%- if _section.title != blank -%}{%- assign _title = _section.title -%}{%- endif -%}
     <div class="ledger-section-banner" data-content-home-section="{{ band.section_key }}">
       <div class="ledger-section-lead">
-        {%- if _section.kicker != blank -%}
         <span class="ledger-kicker" data-content-section-kicker>{{ _section.kicker }}</span>
-        {%- endif -%}
         <h2 class="section-title" data-content-section-title>{{ _title }}</h2>
-        {%- if _section.note != blank -%}
         <p class="home-section-note font-body" data-content-section-note>{{ _section.note }}</p>
-        {%- endif -%}
       </div>
       <div class="home-section-aside">
         <a class="ledger-cta" href="{{ _path }}">

data/_layouts/home.html

@@ -401,21 +401,10 @@ layout: shell
           if (!bench) return;
           bench.style.setProperty('--home-project-icon-count', String(iconSlots));
           var tallest = await measureTallestSpecimen();
-          /* Desktop matches the specimen height to the N-entry inventory stack
-             (see --home-inventory-min-height); mobile uses the tallest specimen. */
-          var inventoryMin = 0;
-          var raw = window.getComputedStyle(bench)
-            .getPropertyValue('--home-inventory-min-height').trim();
-          if (raw) {
-            var probe = document.createElement('div');
-            probe.style.cssText = 'position:absolute;visibility:hidden;height:' + raw;
-            bench.appendChild(probe);
-            inventoryMin = Math.ceil(probe.getBoundingClientRect().height);
-            probe.remove();
-          }
-          var locked = inventoryMin > 0 ? inventoryMin : tallest;
-          if (locked > 0) {
-            bench.style.setProperty('--home-specimen-height', locked + 'px');
+          /* Every breakpoint locks the specimen to the tallest project; from
+             900px the rack rows share that height. */
+          if (tallest > 0) {
+            bench.style.setProperty('--home-specimen-height', tallest + 'px');
           }
         }
 

data/assets/css/ledger/home.css

@@ -308,7 +308,7 @@
 
 .home-hero-summary {
   max-width: var(--reading-measure, 45rem);
-  color: var(--color-on-surface);
+  color: var(--color-legend);
   line-height: var(--leading-body);
 }
 
@@ -1035,10 +1035,11 @@ html[data-theme="light"] .home-hero-plate {
    the inventory. Taglines clamp to two lines with an ellipsis; chips wrap
    whole pills like the projects index; spare height parks chips and the foot
    on the floor. Every plate is 16:9, the ratio the thumbnails are drawn at,
-   with the title below it. From 900px the specimen and the rack share equal
-   columns (~45.6% each); rows reserve height for three resource icons.
-   Below 900px the rack is an icon strip above the specimen, one column
-   per project. */
+   with the title below it. From 900px the specimen column takes 35% of the
+   band (at least 20rem) and the rack 45% (at least 21rem) across one
+   `--space-xl` column gap, starting at the band's left edge, and the rack
+   rows share the specimen height. Below 900px the rack is an icon strip
+   above the specimen, one column per project. */
 .home-projects-bench {
   --home-specimen-height: 32rem;
   --home-icon-btn-size: 2.75rem;
@@ -1101,10 +1102,18 @@ html[data-theme="light"] .home-hero-plate {
   letter-spacing: 0.03em;
 }
 
+/* The specimen strip flows as text, so a long label wraps between words
+   instead of clipping the start year on a phone. */
 .home-specimen-strip .ledger-meta {
+  display: block;
+  white-space: normal;
   font-size: var(--type-label-lg);
 }
 
+.home-specimen-strip .ledger-meta-sep {
+  margin-inline: var(--space-sm);
+}
+
 .home-specimen-folio,
 .home-project-inventory-index {
   color: var(--color-primary);
@@ -1205,6 +1214,22 @@ html[data-theme="light"] .home-hero-plate {
   color: var(--color-primary);
 }
 
+@media (max-width: 899px) {
+  .home-specimen-figure:has(> .ledger-poster)>.home-specimen-badge {
+    font-size: 1.375rem;
+  }
+
+  /* Two classes: the Material Symbols sheet loads after this one and resets
+     the glyph size on a single class. */
+  .home-project-inventory-row .home-project-inventory-glyph {
+    font-size: 1.375rem;
+  }
+
+  .home-project-inventory-row .home-project-inventory-glyph--initial {
+    font-size: var(--type-card);
+  }
+}
+
 .home-project-specimen .home-specimen-title {
   margin: 0;
   font-size: var(--type-card-lg);
@@ -1363,23 +1388,22 @@ button.home-project-inventory-row {
 
 @media (min-width: 900px) {
 
-  /* Specimen and inventory share equal columns (~45.6% each). Each row fits
-     its square icon mark and two-line code + title body; the specimen height
-     matches the N-entry inventory stack. */
+  /* The specimen column is 35% of the band (at least 20rem), which keeps the
+     16:9 plate at 60% of the 7:5 split's height; the rack is 45% (at least
+     21rem); the pair starts at the band's left edge and leaves the rest of
+     the row blank. The specimen sets the bench height; rack rows share it. */
   .home-projects-bench {
-    --home-inventory-mark-size: 2.75rem;
+    --home-inventory-mark-size: 3rem;
     --home-inventory-row-min: calc(
       var(--home-inventory-mark-size) + 2 * var(--space-sm) + 2px
     );
-    --home-inventory-min-height: calc(
-      var(--home-project-icon-count, 6) * var(--home-inventory-row-min) +
-      (var(--home-project-icon-count, 6) - 1) * var(--space-sm) +
-      2 * var(--space-md)
-    );
-    --home-specimen-height: var(--home-inventory-min-height);
+    /* Rows share the specimen height, but a short rack must not stretch a
+       single row to the full plate. */
+    --home-inventory-row-max: calc(1.6 * var(--home-inventory-row-min));
     display: grid;
-    grid-template-columns: minmax(0, 45.6%) minmax(0, 45.6%);
+    grid-template-columns: max(35%, 20rem) max(45%, 21rem);
     column-gap: var(--space-xl);
+    justify-content: start;
     align-items: stretch;
   }
 
@@ -1390,6 +1414,7 @@ button.home-project-inventory-row {
     gap: var(--space-sm);
     box-sizing: border-box;
     width: 100%;
+    min-height: var(--home-specimen-height);
     min-width: 0;
     min-height: 0;
     overflow: hidden;
@@ -1397,38 +1422,18 @@ button.home-project-inventory-row {
     background: var(--color-panel-contrast);
   }
 
-  .home-specimen-figure:has(> .ledger-poster, > .projects-plate) {
-    flex: 1 1 0;
-    min-height: 0;
-    grid-template-rows: minmax(0, 1fr) auto;
-    gap: var(--space-sm);
-  }
-
-  .home-specimen-figure > .ledger-poster,
-  .home-specimen-figure > .projects-plate {
-    height: 100%;
-    min-height: 0;
-    aspect-ratio: auto;
-  }
-
   .home-project-specimen .home-specimen-title {
-    font-size: var(--type-title);
-  }
-
-  .home-project-specimen .ledger-card-copy {
-    flex: 0 0 auto;
-    height: auto;
-    min-height: 0;
-    max-height: calc(var(--type-body) * var(--leading-body) * 2);
+    font-size: var(--type-section);
   }
 
   .home-project-inventory-row {
-    flex: 0 0 auto;
+    flex: 1 1 0;
     align-items: center;
     justify-content: flex-start;
     gap: var(--space-md);
-    height: var(--home-inventory-row-min);
+    height: auto;
     min-height: var(--home-inventory-row-min);
+    max-height: var(--home-inventory-row-max);
     box-sizing: border-box;
     padding: var(--space-sm) var(--space-md);
     border: 1px solid var(--border-gentle-divider);
@@ -1506,7 +1511,7 @@ button.home-project-inventory-row {
   .home-project-inventory-title {
     margin: 0;
     font-family: var(--font-content-title);
-    font-size: calc(var(--type-card) - 2pt);
+    font-size: var(--type-card);
     font-weight: var(--weight-title);
     line-height: 1.2;
     color: var(--color-on-surface);
@@ -1862,7 +1867,7 @@ button.home-project-inventory-row {
   margin-top: 0;
   font-size: var(--type-body);
   line-height: var(--leading-body);
-  color: var(--color-on-surface);
+  color: var(--color-legend);
 }
 
 .home-hero-summary p {

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.10.2"
+        # GitHub tag: gem "pandorga", github: "alexandrelheinen/pandorga", tag: "v1.11.0"
         gem "csv"
         gem "base64"
       RUBY

data/lib/pandorga/version.rb

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

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

@@ -227,8 +227,11 @@ sheets.each do |path|
 end
 
 # PLT-AC-41. Home project inventory rows use the square icon mark, two-line
-# code + title body, and no tagline preview or attached-resource icons; the
-# desktop specimen height matches the N-entry inventory height.
+# code + title body, and no tagline preview or attached-resource icons; on
+# desktop the specimen (35%, min 20rem) and rack (45%, min 21rem) start at the
+# band's left edge across one --space-xl gap, the specimen sets the bench
+# height, rack titles use --type-card, the specimen strip wraps instead of
+# clipping, and below 900px the rack tile glyphs are 1.375rem.
 home_sheet = strip_comments(File.read(CSS_ROOT.join("ledger/home.css")))
 %w[
   home-project-inventory-copy
@@ -245,8 +248,40 @@ require_declarations(
 )
 require_declarations(
   errors, "assets/css/ledger/home.css", home_sheet,
-  ".home-projects-bench", ["--home-specimen-height: var(--home-inventory-min-height)"]
+  ".home-projects-bench", ["grid-template-columns: max(35%, 20rem) max(45%, 21rem)", "column-gap: var(--space-xl)", "justify-content: start", "--home-inventory-row-max: calc(1.6 * var(--home-inventory-row-min))"]
 )
+require_declarations(
+  errors, "assets/css/ledger/home.css", home_sheet,
+  ".home-specimen-strip .ledger-meta", ["display: block", "white-space: normal"]
+)
+require_declarations(
+  errors, "assets/css/ledger/home.css", home_sheet,
+  ".home-project-inventory-title", ["font-size: var(--type-card)"]
+)
+require_declarations(
+  errors, "assets/css/ledger/home.css", home_sheet,
+  ".home-project-inventory-row .home-project-inventory-glyph", ["font-size: 1.375rem"]
+)
+[
+  "45.6%",
+  "minmax(0, 7fr)",
+  "--home-inventory-min-height",
+  "calc(var(--type-card) - 2pt)"
+].each do |forbidden_home|
+  if home_sheet.include?(forbidden_home)
+    errors << "assets/css/ledger/home.css: #{forbidden_home} must be removed (PLT-AC-41)"
+  end
+end
+
+# PLT-AC-23. The home hero summary uses --color-legend, the ink of the other
+# description texts.
+require_declarations(
+  errors, "assets/css/ledger/home.css", home_sheet,
+  ".home-hero-summary", ["color: var(--color-legend)"]
+)
+if declaration_bodies(home_sheet, ".home-hero-summary").any? { |body| declarations(body).include?("color:var(--color-on-surface)") }
+  errors << "assets/css/ledger/home.css: .home-hero-summary must use --color-legend (PLT-AC-23)"
+end
 
 fail!("CSS structure problems:\n  - #{errors.join("\n  - ")}") unless errors.empty?
 

data/scripts/test/test-home-band-intro.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+# Refs: PLT-AC-42 — home listing bands emit kicker, title, and note slots in both normal and agnostic builds.
+require "pathname"
+require "open3"
+require "fileutils"
+require "tmpdir"
+
+ROOT = Pathname.new(__dir__).join("../..").expand_path
+EXE = ROOT.join("exe/pandorga")
+EXAMPLE = ROOT.join("examples/full")
+
+def fail!(message)
+  warn "FAIL test-home-band-intro: #{message}"
+  exit 1
+end
+
+def run!(*cmd, chdir:)
+  env = {
+    "RUBYOPT" => "-I#{ROOT.join('lib')}",
+    "PANDORGA_SITE_ROOT" => chdir.to_s,
+    "CONTENT_API_BASE_URL" => "",
+    "CONTENT_EXPORT_SKIP_VALIDATE" => "1",
+    "JEKYLL_ENV" => "production"
+  }
+  stdout, stderr, status = Open3.capture3(env, *cmd, chdir: chdir.to_s)
+  return [stdout, stderr] if status.success?
+
+  fail!("#{cmd.join(' ')} (cwd=#{chdir})\n#{stdout}\n#{stderr}")
+end
+
+def listing_sections(html)
+  sections = []
+  html.scan(/<section\b[^>]*\bdata-home-kind="([^"]+)"[^>]*>.*?<\/section>/m) do
+    section = Regexp.last_match(0)
+    kind = Regexp.last_match(1)
+    next if kind == "index"
+
+    key = section[/\bdata-home-key="([^"]+)"/, 1] || kind
+    banner_idx = section.index('data-content-home-section="')
+    fail!("section #{key} missing data-content-home-section") unless banner_idx
+
+    sections << [key, section[banner_idx..]]
+  end
+  sections
+end
+
+run!("bundle", "install", "--quiet", chdir: EXAMPLE) if EXAMPLE.join("Gemfile").file?
+run!("ruby", EXE.to_s, "export", "content", "_content_json", chdir: EXAMPLE)
+
+Dir.mktmpdir("pandorga-home-band-normal-") do |normal_dir|
+  run!("bundle", "exec", "jekyll", "build", "--quiet", "-d", normal_dir, chdir: EXAMPLE)
+  html = File.read(File.join(normal_dir, "index.html"))
+  sections = listing_sections(html)
+  fail!("normal build produced no listing sections") if sections.empty?
+
+  sections.each do |key, slice|
+    %w[data-content-section-kicker data-content-section-title data-content-section-note].each do |attr|
+      fail!("normal build band #{key} missing #{attr}") unless slice.include?(attr)
+    end
+  end
+
+  projects = sections.assoc("projects")&.last
+  fail!("normal build missing projects band") unless projects
+  unless projects.include?("Portfolio systems in the full example.")
+    fail!("normal build projects band missing note text from headers.yml")
+  end
+end
+
+Dir.mktmpdir("pandorga-home-band-agnostic-") do |agnostic_dir|
+  agnostic_cfg = File.join(agnostic_dir, "agnostic.yml")
+  File.write(agnostic_cfg, "shell_content_agnostic: true\n")
+  out_dir = File.join(agnostic_dir, "site")
+  run!(
+    "bundle", "exec", "jekyll", "build", "--quiet",
+    "--config", "_config.yml,#{agnostic_cfg}",
+    "-d", out_dir,
+    chdir: EXAMPLE
+  )
+  html = File.read(File.join(out_dir, "index.html"))
+  sections = listing_sections(html)
+  fail!("agnostic build produced no listing sections") if sections.empty?
+
+  sections.each do |key, slice|
+    %w[data-content-section-kicker data-content-section-title data-content-section-note].each do |attr|
+      fail!("agnostic build band #{key} missing #{attr}") unless slice.include?(attr)
+    end
+  end
+
+  projects = sections.assoc("projects")&.last
+  fail!("agnostic build missing projects band") unless projects
+  unless projects.include?("data-content-section-note></p>")
+    fail!("agnostic build projects band note slot is not empty")
+  end
+end
+
+puts "PASS test-home-band-intro"

data/scripts/validate.sh

@@ -55,6 +55,7 @@ TESTS=(
   scripts/test/test-r2-json-sync.rb
   scripts/test/test-writing-slug-limits.rb
   scripts/test/test-examples-build.rb
+  scripts/test/test-home-band-intro.rb
   scripts/test/test-validate-allowlist.rb
   scripts/test/test-shell-a11y.rb
   scripts/test/test-theme-contrast.rb

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pandorga
 version: !ruby/object:Gem::Version
-  version: 1.10.2
+  version: 1.11.0
 platform: ruby
 authors:
 - The Pandorga contributors
@@ -435,6 +435,7 @@ files:
 - scripts/test/test-hero-summary.rb
 - scripts/test/test-home-articles.rb
 - scripts/test/test-home-band-art.rb
+- scripts/test/test-home-band-intro.rb
 - scripts/test/test-home-lists.rb
 - scripts/test/test-hydrate-reserve.rb
 - scripts/test/test-install-functions.rb