pandorga 1.10.1 → 1.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 12f24b429006ae62f3e74335afdf759a851068879cc639273a77d5cc95e8d9fd
-  data.tar.gz: efa405146c9212bcdff063abfbcadc8b03c5a222679894acd9db8dbeea522c92
+  metadata.gz: 9d3adc84d250c4ff140df5b9cc9db266896fdfce92fd899789fd943ce8ac4659
+  data.tar.gz: 474d788dea7851796fb189732c9bb75d118666177f4cf81df70d8361f4310872
 SHA512:
-  metadata.gz: 2dbd18257d2507115b35b5370d0ef9e1da9e289cab3eb6861aa52532e1927a23fe834120c689a74d0331631ac929d0f88c71fe38b93563415a98de3d2e6176e9
-  data.tar.gz: 431866457e1c4f3d7945f6756b9331f9191923b6e353411b98540c9adcfdad75b80ad4bfaefd6200de6057cb4ca2021c94097b45c9fdd601d25dc7c99879aae2
+  metadata.gz: d9e76b0be8485c3870366cce0bc816fc55f3dee7ea2b17ec40602f2c70dccbf985e2d7be6da7911e54a7f830c6fd3c4030dbb985689d50c84cb9226c04cd0f2e
+  data.tar.gz: 6853fe1a1d0edd4066d45187a4cddd67258a753afd849284615383fb9cae4844a24aabff188681a73066e2808170bfc1e28730832e68d976c34400899d2cea88

data/CHANGELOG.md

@@ -1,5 +1,43 @@
 # 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
+
+- On the home projects bench, each inventory row shows the project icon mark
+  (or initial fallback), optional index and label strip, and title, without a
+  thumbnail poster, tagline preview, or attached-resource icons. On desktop
+  (`>= 900px`) each row fits that two-line body and square icon mark, and the
+  specimen height matches the inventory stack
+- Project hero action pills keep their label text free of underlines at rest
+  and on hover
+
 ## [1.10.1] — 2026-10-14
 
 ### 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/content-runtime/43-blocks.html

@@ -330,9 +330,9 @@
     }
 
     /* Rack card for the home portfolio bench.
-     * Desktop: thumb (or icon, or initial) beside a code line, title and
-     * tagline. The mobile strip shows the project glyph only. Selectable rows
-     * update the specimen. */
+     * Desktop: square icon mark (or initial) beside a code line and title.
+     * The mobile strip shows the project glyph only. Selectable rows update
+     * the specimen. */
     function renderProjectInventoryRow(item, options) {
       options = options || {};
       var f = blockFields(item);
@@ -357,12 +357,12 @@
         row.setAttribute('aria-label', name);
       }
 
-      var media = renderPosterMedia(fm.thumbnail, name);
       var initial = String(name || '?').charAt(0).toUpperCase();
-      if (!media && fm.icon) {
+      var media;
+      if (fm.icon) {
         media = '<div class="home-project-inventory-mark" aria-hidden="true">' +
           '<span class="material-symbols-outlined">' + escapeHtml(fm.icon) + '</span></div>';
-      } else if (!media) {
+      } else {
         media = '<div class="home-project-inventory-mark home-project-inventory-mark--initial" aria-hidden="true">' +
           escapeHtml(initial) + '</div>';
       }
@@ -388,9 +388,6 @@
           '<a class="ledger-card-stretch" href="' + escapeAttr(href) + '">' +
           escapeHtml(name) + '</a></h3>';
       }
-      if (fm.tagline) {
-        html += '<p class="home-project-inventory-copy font-body">' + escapeHtml(fm.tagline) + '</p>';
-      }
       html += '</div>';
       if (fm.icon) {
         html += '<span class="home-project-inventory-glyph material-symbols-outlined" aria-hidden="true">' +
@@ -399,7 +396,6 @@
         html += '<span class="home-project-inventory-glyph home-project-inventory-glyph--initial" aria-hidden="true">' +
           escapeHtml(initial) + '</span>';
       }
-      html += renderProjectResourceBadges(fm);
 
       row.innerHTML = html;
       return row;
@@ -473,32 +469,6 @@
       return links.join('');
     }
 
-    /* Square resource marks for the home inventory rack — same fields as
-     * renderProjectLinks (github / article_url / external_url), icon-only
-     * indicators (not links). */
-    function renderProjectResourceBadges(fm) {
-      var badges = [];
-      if (fm.github) {
-        badges.push({ icon: 'code', label: 'Code' });
-      }
-      if (fm.article_url) {
-        badges.push({ icon: 'article', label: 'Article' });
-      }
-      if (fm.external_url) {
-        badges.push({ icon: 'public', label: 'Site' });
-      }
-      if (!badges.length) return '';
-      return '<div class="home-project-inventory-resources" aria-label="Attached resources">' +
-        badges.map(function (badge) {
-          return '<span class="home-project-inventory-resource" title="' +
-            escapeAttr(badge.label) + '" aria-label="' +
-            escapeAttr(badge.label) + '">' +
-            '<span class="material-symbols-outlined" aria-hidden="true">' +
-            escapeHtml(badge.icon) + '</span></span>';
-        }).join('') +
-        '</div>';
-    }
-
     /* Home specimen — the featured project on the portfolio bench. A system
      * card whose strip carries folio, label and start year, with the title
      * below a 16:9 plate: the thumbnail (icon badge on it) or else the icon

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

@@ -399,22 +399,12 @@ layout: shell
         async function lockSpecimenHeight() {
           var bench = specimenSlot.closest('.home-projects-bench');
           if (!bench) return;
+          bench.style.setProperty('--home-project-icon-count', String(iconSlots));
           var tallest = await measureTallestSpecimen();
-          /* Floor at the CSS inventory minimum so six rows always clear
-             three stacked resource icons (see --home-inventory-min-height). */
-          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 = Math.max(tallest, inventoryMin);
-          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');
           }
         }
 
@@ -441,12 +431,10 @@ layout: shell
               selected: entry.slug === selectedSlug,
               index: i + 1
             });
-            row.addEventListener('click', function (event) {
-              if (event.target.closest('.home-project-inventory-resources')) return;
+            row.addEventListener('click', function () {
               select(entry.slug);
             });
             row.addEventListener('keydown', function (event) {
-              if (event.target.closest('.home-project-inventory-resources')) return;
               if (event.key === 'Enter' || event.key === ' ') {
                 event.preventDefault();
                 select(entry.slug);

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);
@@ -1321,10 +1346,6 @@ button.home-project-inventory-row {
   display: none;
 }
 
-.home-project-inventory-resources {
-  display: none;
-}
-
 .home-project-inventory-glyph {
   display: inline-flex;
   align-items: center;
@@ -1367,26 +1388,22 @@ button.home-project-inventory-row {
 
 @media (min-width: 900px) {
 
-  /* Desktop fallback before JS measures the tallest specimen.
-     Specimen and inventory share equal columns (specimen was 38% then
-     +20% → 45.6%; the list matches that width). Rows still reserve
-     height for three stacked resource icons. */
+  /* 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-icon-size: 1.55rem;
-    --home-inventory-icon-gap: 0.2rem;
-    --home-inventory-resources-height: calc(
-      3 * var(--home-inventory-icon-size) + 2 * var(--home-inventory-icon-gap)
-    );
+    --home-inventory-mark-size: 3rem;
     --home-inventory-row-min: calc(
-      var(--home-inventory-resources-height) + 2 * var(--space-sm)
-    );
-    --home-inventory-min-height: calc(
-      6 * var(--home-inventory-row-min) + 5 * var(--space-sm) + 2 * var(--space-md)
+      var(--home-inventory-mark-size) + 2 * var(--space-sm) + 2px
     );
-    --home-specimen-height: max(36rem, 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;
   }
 
@@ -1397,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;
@@ -1405,16 +1423,18 @@ button.home-project-inventory-row {
   }
 
   .home-project-specimen .home-specimen-title {
-    font-size: var(--type-title);
+    font-size: var(--type-section);
   }
 
   .home-project-inventory-row {
     flex: 1 1 0;
-    align-items: flex-start;
+    align-items: center;
     justify-content: flex-start;
     gap: var(--space-md);
     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);
     background: var(--color-surface-card);
@@ -1433,15 +1453,13 @@ button.home-project-inventory-row {
     box-shadow: inset 3px 0 0 var(--color-primary);
   }
 
-  /* Plate fills the row’s content height; width follows 16:9. Stretch keeps
-     it tall while title/copy/icons stay top-aligned with its top edge. */
+  /* Square icon mark beside the two-line code + title body. */
   .home-project-inventory-media {
     display: block;
     flex: 0 0 auto;
-    align-self: stretch;
-    width: auto;
-    height: auto;
-    aspect-ratio: 16 / 9;
+    width: var(--home-inventory-mark-size);
+    height: var(--home-inventory-mark-size);
+    aspect-ratio: 1 / 1;
     overflow: hidden;
     background: var(--color-surface-high);
   }
@@ -1451,33 +1469,25 @@ button.home-project-inventory-row {
     outline-offset: 2px;
   }
 
-  .home-project-inventory-media .ledger-poster,
   .home-project-inventory-mark {
+    display: flex;
+    align-items: center;
+    justify-content: center;
     width: 100%;
     height: 100%;
     aspect-ratio: auto;
     overflow: hidden;
     background: var(--color-surface-high);
-  }
-
-  .home-project-inventory-media .ledger-poster::after {
-    display: none;
-  }
-
-  .home-project-inventory-mark {
-    display: flex;
-    align-items: center;
-    justify-content: center;
     color: var(--color-primary);
   }
 
   .home-project-inventory-mark .material-symbols-outlined {
-    font-size: 2rem;
+    font-size: 1.5rem;
   }
 
   .home-project-inventory-mark--initial {
     font-family: var(--font-content-title);
-    font-size: var(--type-card-lg);
+    font-size: var(--type-card);
     font-weight: var(--weight-title);
     line-height: 1;
     color: var(--color-on-surface);
@@ -1486,55 +1496,22 @@ button.home-project-inventory-row {
   .home-project-inventory-body {
     display: flex;
     flex-direction: column;
-    justify-content: flex-start;
-    align-self: flex-start;
-    gap: 0.2rem;
+    justify-content: center;
+    align-self: center;
+    gap: 0.15rem;
     flex: 1 1 0;
     min-width: 0;
     padding-top: 0;
   }
 
-  .home-project-inventory-resources {
-    display: flex;
-    flex-direction: column;
-    justify-content: flex-start;
-    align-items: center;
-    align-self: flex-start;
-    flex: 0 0 auto;
-    gap: var(--home-inventory-icon-gap);
-    width: var(--home-inventory-icon-size);
-    min-height: var(--home-inventory-resources-height);
-    position: relative;
-    z-index: 1;
-  }
-
-  /* Neutral marks — same voice as list descriptions, not primary CTAs. */
-  .home-project-inventory-resource {
-    display: inline-flex;
-    align-items: center;
-    justify-content: center;
-    width: var(--home-inventory-icon-size);
-    height: var(--home-inventory-icon-size);
-    flex: 0 0 auto;
-    background: transparent;
-    color: var(--color-on-surface-variant);
-    border: 0;
-  }
-
-  .home-project-inventory-resource .material-symbols-outlined {
-    font-size: 1rem;
-    line-height: 1;
-    font-variation-settings: "FILL" 0, "wght" 400, "GRAD" 0, "opsz" 20;
-  }
-
   .home-project-inventory-code .ledger-meta {
     font-size: var(--type-label-lg);
   }
 
   .home-project-inventory-title {
-    margin: 0.2rem 0 0;
+    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);
@@ -1549,17 +1526,6 @@ button.home-project-inventory-row {
     color: var(--color-primary);
   }
 
-  .home-project-inventory-copy {
-    margin: 0;
-    font-size: var(--type-label-lg);
-    font-weight: var(--weight-body);
-    line-height: 1.35;
-    color: var(--color-on-surface-variant);
-    overflow: hidden;
-    text-overflow: ellipsis;
-    white-space: nowrap;
-  }
-
   /* Two classes: the glyph also carries .material-symbols-outlined, whose
      font stylesheet loads after this one and sets display. */
   .home-project-inventory-row .home-project-inventory-glyph {
@@ -1901,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.1"
+        # 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.1"
+  VERSION = "1.11.0"
 end

data/scripts/test/render-parity/blocks/project-inventory-row.json

@@ -1,5 +1,5 @@
 {
-  "name": "project-inventory-row/rack card (PLT-AC-15)",
+  "name": "project-inventory-row/rack card (PLT-AC-41)",
   "block": "renderProjectInventoryRow",
   "args": [
     {
@@ -25,28 +25,25 @@
   "selectors": [
     "button.home-project-inventory-row",
     "div.home-project-inventory-media",
-    "div.ledger-poster",
+    "div.home-project-inventory-mark",
     "div.home-project-inventory-code",
     "span.home-project-inventory-index",
     "h3.home-project-inventory-title",
-    "p.home-project-inventory-copy",
-    "span.home-project-inventory-glyph",
-    "div.home-project-inventory-resources",
-    "span.home-project-inventory-resource"
+    "span.home-project-inventory-glyph"
   ],
   "forbidden": [
     "ledger-card-stretch",
-    "role=\"button\""
+    "role=\"button\"",
+    "ledger-poster",
+    "home-project-inventory-copy",
+    "home-project-inventory-resources",
+    "home-project-inventory-resource"
   ],
   "contains": [
     ">02<",
     ">Simulation<",
     ">ARCO<",
-    ">A city-scale race replayed from telemetry.<",
     ">route<",
-    ">code<",
-    ">article<",
-    ">public<",
     "aria-pressed=\"false\"",
     "data-slug=\"arco\""
   ]

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

@@ -226,6 +226,63 @@ sheets.each do |path|
   end
 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; 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
+  home-project-inventory-resources
+  home-project-inventory-resource
+].each do |retired_home|
+  if home_sheet.match?(/[.#]#{Regexp.escape(retired_home)}\b/)
+    errors << "assets/css/ledger/home.css: .#{retired_home} must be removed (PLT-AC-41)"
+  end
+end
+require_declarations(
+  errors, "assets/css/ledger/home.css", home_sheet,
+  ".home-project-inventory-media", ["aspect-ratio: 1 / 1"]
+)
+require_declarations(
+  errors, "assets/css/ledger/home.css", home_sheet,
+  ".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?
 
 puts "  #{sheets.size} stylesheet(s) balanced, no conflict markers."

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.1
+  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