pandorga 1.3.5 → 1.3.7

data/scripts/test/render-parity/blocks/project-specimen-glyph.json

@@ -0,0 +1,32 @@
+{
+  "name": "project-specimen/icon plate without a thumbnail (PLT-AC-13)",
+  "block": "renderProjectSpecimen",
+  "args": [
+    {
+      "slug": "bossa",
+      "front_matter": {
+        "project": "Bossa",
+        "icon": "music_note",
+        "tagline": "Edge nodes for street ensembles."
+      }
+    },
+    {
+      "href": "/projects/bossa/"
+    }
+  ],
+  "selectors": [
+    "div.home-specimen-figure",
+    "projects-plate--mark",
+    "h3.ledger-card-title"
+  ],
+  "forbidden": [
+    "ledger-poster",
+    "home-specimen-badge",
+    "home-specimen-strip",
+    "home-specimen-open"
+  ],
+  "contains": [
+    ">music_note<",
+    ">Bossa<"
+  ]
+}

data/scripts/test/render-parity/blocks/project-specimen-initial-badge.json

@@ -0,0 +1,31 @@
+{
+  "name": "project-specimen/initial badge on a thumbnail without an icon (PLT-AC-18)",
+  "block": "renderProjectSpecimen",
+  "args": [
+    {
+      "slug": "arco",
+      "front_matter": {
+        "project": "ARCO",
+        "thumbnail": "/media/projects/arco.png"
+      }
+    },
+    {
+      "href": "/projects/arco/"
+    }
+  ],
+  "selectors": [
+    "ledger-poster",
+    "span.home-specimen-badge",
+    "is-initial"
+  ],
+  "forbidden": [
+    "projects-plate",
+    "material-symbols-outlined"
+  ],
+  "contains": [
+    "aria-hidden=\"true\">A</span>"
+  ],
+  "counts": {
+    "home-specimen-badge": 1
+  }
+}

data/scripts/test/render-parity/blocks/project-specimen-initial.json

@@ -0,0 +1,32 @@
+{
+  "name": "project-specimen/initial plate without a thumbnail or icon (PLT-AC-18)",
+  "block": "renderProjectSpecimen",
+  "args": [
+    {
+      "slug": "bossa",
+      "front_matter": {
+        "project": "bossa",
+        "tagline": "Edge nodes for street ensembles."
+      }
+    },
+    {
+      "href": "/projects/bossa/"
+    }
+  ],
+  "selectors": [
+    "div.home-specimen-figure",
+    "projects-plate--mark",
+    "span.is-initial",
+    "projects-plate-glyph",
+    "h3.ledger-card-title"
+  ],
+  "forbidden": [
+    "ledger-poster",
+    "material-symbols-outlined",
+    "home-specimen-badge"
+  ],
+  "contains": [
+    ">B</span></div>",
+    ">bossa<"
+  ]
+}

data/scripts/test/render-parity/blocks/project-specimen.json

@@ -0,0 +1,69 @@
+{
+  "name": "project-specimen/full (PLT-AC-13)",
+  "block": "renderProjectSpecimen",
+  "args": [
+    {
+      "slug": "arco",
+      "front_matter": {
+        "project": "ARCO",
+        "thumbnail": "/media/projects/arco.png",
+        "icon": "route",
+        "label": "Simulation",
+        "status": "Ongoing",
+        "start_date": "2024-03-01",
+        "tagline": "A city-scale race replayed from telemetry.",
+        "tags": [
+          "Systems",
+          "Rust"
+        ],
+        "github": "https://github.com/example/arco",
+        "article_url": "/articles/arco/",
+        "external_url": "https://arco.example"
+      }
+    },
+    {
+      "href": "/projects/arco/",
+      "folio": 1,
+      "openLabel": "Open project"
+    }
+  ],
+  "selectors": [
+    "article.ledger-system-card",
+    "article.home-project-specimen",
+    "div.home-specimen-strip",
+    "div.ledger-meta",
+    "span.ledger-status",
+    "div.home-specimen-figure",
+    "div.ledger-poster",
+    "img",
+    "span.home-specimen-badge",
+    "h3.ledger-card-title",
+    "a.ledger-card-stretch",
+    "p.ledger-card-copy",
+    "div.ledger-chip-row",
+    "div.ledger-card-links",
+    "span.home-specimen-open"
+  ],
+  "forbidden": [
+    "projects-plate"
+  ],
+  "contains": [
+    ">#01<",
+    ">Simulation<",
+    ">2024<",
+    ">Ongoing<",
+    ">ARCO<",
+    ">Repository<",
+    ">Article<",
+    ">Visit<",
+    ">Open project<",
+    "href=\"/projects/arco/\""
+  ],
+  "counts": {
+    "ledger-card-stretch": 1,
+    "ledger-cta": 4,
+    "ledger-cta-icon": 3,
+    "ledger-chip": 2,
+    "ledger-meta-sep": 2
+  }
+}

data/scripts/test/render-parity/run-absent-field-checks.mjs

@@ -214,6 +214,46 @@ omits(
 
 separatorCount('renderSystemCard / label without status drops the separator', ['Simulation', ''], 0);
 
+// PLT-AC-14: the home specimen and its rack card carry only what the project
+// declares. A project that is only a name is its initial plate (PLT-AC-18)
+// and a title, nothing else.
+omits(
+  'renderProjectSpecimen / project with no media, meta, tags, or links',
+  'renderProjectSpecimen',
+  [{ front_matter: { project: 'Bossa' } }, { href: '/projects/bossa/' }],
+  [
+    'ledger-poster',
+    'material-symbols-outlined',
+    'home-specimen-badge',
+    'home-specimen-strip',
+    'ledger-meta',
+    'ledger-status',
+    'ledger-card-copy',
+    'ledger-chip-row',
+    'ledger-card-foot'
+  ]
+);
+
+omits(
+  'renderProjectSpecimen / a start_date with no year renders no year',
+  'renderProjectSpecimen',
+  [{ front_matter: { project: 'Bossa', start_date: 'someday' } }, { href: '/projects/bossa/' }],
+  ['home-specimen-strip', 'ledger-meta']
+);
+
+omits(
+  'renderProjectInventoryRow / project with no index, label, status, or tagline',
+  'renderProjectInventoryRow',
+  [{ slug: 'bossa', front_matter: { project: 'Bossa' } }, { selectable: true }],
+  [
+    'home-project-inventory-code',
+    'home-project-inventory-index',
+    'ledger-status',
+    'home-project-inventory-copy',
+    'ledger-poster'
+  ]
+);
+
 // The listing preview is derived from description, then excerpt, then body.
 // With all three absent there is nothing to say, so there is no paragraph.
 omits(

data/scripts/test/test-ledger-blocks.rb

@@ -0,0 +1,32 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "open3"
+require "pathname"
+
+ROOT = Pathname.new(__dir__).join("..", "..").expand_path
+FIXTURE_DIR = Pathname.new(__dir__).join("render-parity", "blocks")
+RUNNER = Pathname.new(__dir__).join("render-parity", "run-block-fixture.mjs")
+
+# The block half of test-content-render-parity, without its Markdown half.
+# That gate needs `marked` from scripts/node_modules, which CI never installs,
+# so it stays off validate.sh; the ledger blocks fall back cleanly without it.
+
+def check!(condition, message = "condition was false")
+  raise "Assertion failed: #{message}" unless condition
+end
+
+puts "Testing ledger block fixtures..."
+
+paths = Dir.glob(FIXTURE_DIR.join("*.json")).sort
+check! paths.any?, "no ledger block fixtures found"
+
+paths.each do |fixture_path|
+  stdout, stderr, status = Open3.capture3(
+    "node", RUNNER.to_s, fixture_path, chdir: ROOT.join("scripts").to_s
+  )
+  check! status.success?, "#{File.basename(fixture_path)} failed:\n#{stderr}\n#{stdout}"
+  puts "  #{stdout.strip}"
+end
+
+puts "All ledger block fixtures passed."

data/scripts/validate.sh

@@ -49,6 +49,7 @@ TESTS=(
   scripts/test/test-math-row-breaks.rb
   scripts/test/test-detail-render-parity.rb
   scripts/test/test-absent-field-absent-element.rb
+  scripts/test/test-ledger-blocks.rb
   scripts/test/test-home-band-art.rb
   scripts/test/test-r2-json-sync.rb
   scripts/test/test-writing-slug-limits.rb

data/templates/portfolio/README.md

@@ -32,6 +32,42 @@ Optional: `title`, `nav`, `home` (default limit 4).
   home: { limit: 4 }
 ```
 
+## Home band
+
+The home band is a specimen bench: one featured project card beside a
+filing rack of selectable project cards. Every element is backed by a
+collection field; a missing field means a missing element.
+
+- `PLT-AC-13` When the band renders, the specimen card shall carry a strip
+  with the project's folio, `label`, `start_date` year and `status`; a 16:9
+  plate, the `thumbnail` with the `icon` as a badge (or the `icon` plate),
+  with the title always below it; the `tagline`; the `tags`; and the
+  outbound `github`, `article_url` and `external_url` links. The title is
+  its only link to the project page.
+- `PLT-AC-14` When a project lacks `thumbnail`, `label`, `status`,
+  `start_date`, `tagline`, `tags` or outbound links, the specimen card and its
+  rack card shall render no element for that field. A missing `icon` is
+  covered by `PLT-AC-18`.
+- `PLT-AC-15` When the viewport is at least 900px wide, the specimen shall
+  take half the band and the rack a narrower column beside it, leaving the
+  rest blank. Each project shall appear in the rack as a card with its folio,
+  `label`, `status`, title, `tagline` and a 16:9 `thumbnail` (or `icon`, or
+  initial) mark. Selecting a card shall swap the specimen in place and mark
+  that card `aria-pressed="true"`.
+- `PLT-AC-16` Withdrawn: the tape of previous and next arrows was removed;
+  the rack is the only way to change the specimen.
+- `PLT-AC-17` When the viewport is narrower than 900px, the rack shall be a
+  strip of icon buttons above the specimen, one per project (up to six), that
+  together span the band's width.
+- `PLT-AC-18` When a project lacks `icon`, the first letter of its name shall
+  stand in for it wherever the icon would appear: the specimen badge, the
+  specimen plate, the rack mark and the strip button. The elements and the
+  behavior shall be those of a project with an icon.
+
+`PLT-AC-13`, `-14` and `-18` are covered by the block fixtures under
+`scripts/test/render-parity/blocks/` and by the absent-field gate; `-15` and
+`-17` are layout behavior verified in the browser.
+
 ## Package layout
 
 - `template.yml` — slots, detail route, export fields

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pandorga
 version: !ruby/object:Gem::Version
-  version: 1.3.5
+  version: 1.3.7
 platform: ruby
 authors:
 - The Pandorga contributors
@@ -339,6 +339,12 @@ files:
 - scripts/test/render-parity/blocks/meta-strip.json
 - scripts/test/render-parity/blocks/poster-media-image.json
 - scripts/test/render-parity/blocks/poster-media-video.json
+- scripts/test/render-parity/blocks/project-inventory-row-icon.json
+- scripts/test/render-parity/blocks/project-inventory-row.json
+- scripts/test/render-parity/blocks/project-specimen-glyph.json
+- scripts/test/render-parity/blocks/project-specimen-initial-badge.json
+- scripts/test/render-parity/blocks/project-specimen-initial.json
+- scripts/test/render-parity/blocks/project-specimen.json
 - scripts/test/render-parity/blocks/section-banner.json
 - scripts/test/render-parity/blocks/system-card-custom-meta.json
 - scripts/test/render-parity/blocks/system-card.json
@@ -389,6 +395,7 @@ files:
 - scripts/test/test-home-band-art.rb
 - scripts/test/test-install-functions.rb
 - scripts/test/test-language-export.rb
+- scripts/test/test-ledger-blocks.rb
 - scripts/test/test-listing-filter-contract.rb
 - scripts/test/test-math-row-breaks.mjs
 - scripts/test/test-math-row-breaks.rb