pandorga 1.7.3 → 1.7.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c5c04a8266084060b4aa4810ef57d5d9c25a29302ebd8d946183ba2b95a2daeb
-  data.tar.gz: b0aceffe59d1febefc9a308db429f7da42856463b1b7143bdb23f125729de192
+  metadata.gz: 8935cbf5ca2ee93ea990c5e18d61831877f04f03b3ba569b3d4347dec3387718
+  data.tar.gz: 5c9663302fcce8b2ecf4a5197b03ca66f1f0cca0c7eb2ee0b9d9c9ab2d5e320e
 SHA512:
-  metadata.gz: 22939efa0329adbf9cc11e0ba771a9fd11d0e154777df7918a1a7bbf821295f3592f4ca1233e43448578deb8a9c69955696f3df282c9f435389e371c69815c1d
-  data.tar.gz: 70590f4574d43b101ce9e4148d53df33fc1f6f6e2225df5368d0b11a636d425b1300a10d150038c8d2494e004aaa78f7efd495d56a5cadadee1f671f6ae58158
+  metadata.gz: ba771e313ba7ecbc5d13473c75454468d22d18f6f2ec1d22ca896d3bf9bec124aa9b32f5efff0dce38c7495a20a422110313910d56808f7b123ce4e07b29e322
+  data.tar.gz: b29d2e32efc698af41f0fdcf7b9da605adfbc238a249dd050c157103493b9305e9fb71a355f919e8189a4a43d41b76b25df2a96b446627a3ba6380f6631fc1f5

data/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## [1.7.4] — 2026-10-12
+
+### Fixed
+
+- The footer imprint separator uses `outline` on the panel step.
+  `outline-variant` on that panel is 1.80:1 in light (`#b8b8b8` on
+  `#f4f4f4`) and 1.93:1 in dark (`#45454c` on `#141418`). `outline`
+  on the same panels is 6.08:1 and 5.95:1.
+
+### Changed
+
+- Unused selectors are gone. `assets/css/ledger/home.css` drops
+  `.home-hero-pandorga-svg` (25 bytes). The hero SVG uses
+  `home-hero-art-svg`. `assets/css/ledger/detail.css` drops 916 bytes:
+  the author byline suppressor and the `.table-csv` companions. No
+  template or runtime emits either class. 941 bytes in all.
+- The one-shot key backfill is gone (`scripts/content/backfill-content-keys.rb`,
+  3,432 bytes). Nothing called it.
+- The watch-path test that read `docs/ops/cloudflare.md` is gone
+  (1,230 bytes). That path is not in the tree.
+- Deploy notes pin `~> 1.3` and tag `v1.7.4`. The Pages watch paths
+  include `*` and exclude `content/*` and `docs/*`.
+
+No `pandorga:` config keys were added or renamed. Font roles and the
+ledger fallbacks are unchanged.
+
 ## [1.7.3] — 2026-10-12
 
 ### Fixed

data/_includes/content-runtime/60-fragments.html

@@ -385,7 +385,7 @@
     }
 
     /* The home page's reference band opens each panel with a plate drawn from
-     * that section's own content by the export (docs/features/home-band-art.md).
+     * that section's own content by the export (docs/deploy/cloudflare.md).
      * The markup arrives as an SVG document and is injected inline, never as an
      * <img>: every stroke and fill in it is a custom property, and an external
      * document cannot see the palette the page is currently wearing.

data/assets/css/ledger/detail.css

@@ -485,11 +485,9 @@ aside:has(> .text-detail-sidebar) {
   font-variant-numeric: tabular-nums;
 }
 
-/* Projects and products can carry no meta at all, and on articles and posts
-   the byline below is the block's only child. Either way an all-empty meta
+/* Projects and products can carry no meta at all. An all-empty meta
    block must not hang a stub of padding off the bottom of the panel. */
-.text-detail-sidebar .article-meta:has(> div:empty),
-.text-detail-sidebar .article-meta:has(> div > span.text-secondary:not(.font-bold):only-child) {
+.text-detail-sidebar .article-meta:has(> div:empty) {
   display: none;
 }
 
@@ -497,14 +495,6 @@ aside:has(> .text-detail-sidebar) {
   gap: var(--space-sm);
 }
 
-/* Author byline. Dropped: single-author site. The runtime still emits it, so
-   it is suppressed here until `buildTextSidebar` stops rendering it — see the
-   runtime-change note in this branch's commit message. The product/company
-   line is the same colour but carries `font-bold`, hence the :not(). */
-.text-detail-sidebar .article-meta>div>span.text-secondary:not(.font-bold) {
-  display: none;
-}
-
 .text-detail-sidebar .article-meta .text-tertiary,
 .text-detail-sidebar .article-meta span.font-bold {
   font-family: var(--font-label);
@@ -861,8 +851,7 @@ aside:has(> .text-detail-sidebar) {
    header, and figures that line up. */
 /* No table surface: the header band and the hover row are the only fills, so
    both read against the page canvas in either palette. */
-.article-content table,
-.article-content .table-csv {
+.article-content table {
   margin: var(--space-xl) 0;
   font-size: var(--type-dek);
   font-variant-numeric: tabular-nums;
@@ -870,9 +859,7 @@ aside:has(> .text-detail-sidebar) {
 }
 
 .article-content th,
-.article-content td,
-.article-content .table-csv th,
-.article-content .table-csv td {
+.article-content td {
   border: 0;
   border-bottom: 1px solid var(--border-gentle-subtle);
   padding: var(--space-sm) var(--space-md);
@@ -899,8 +886,7 @@ aside:has(> .text-detail-sidebar) {
   font-variant-numeric: tabular-nums;
 }
 
-.article-content thead th,
-.article-content .table-csv thead th {
+.article-content thead th {
   background: var(--color-surface-container);
   font-family: var(--font-body);
   font-size: var(--type-body);
@@ -910,13 +896,11 @@ aside:has(> .text-detail-sidebar) {
 }
 
 /* Zebra striping fights the row rules; the hover row is the reading aid. */
-.article-content tbody tr:nth-child(even),
-.article-content .table-csv tbody tr:nth-child(even) td {
+.article-content tbody tr:nth-child(even) {
   background: transparent;
 }
 
-.article-content tbody tr:hover,
-.article-content .table-csv tbody tr:hover {
+.article-content tbody tr:hover {
   background: var(--color-surface-container-low);
 }
 
@@ -1131,8 +1115,7 @@ nav.text-page-nav:not(:has(a)) {
      too wide then scrolls inside the table rather than moving the page. The
      runtime emits the table with no wrapper, so the table itself has to be the
      scroll container. */
-  .article-content table,
-  .article-content .table-csv {
+  .article-content table {
     display: block;
     width: 100%;
     max-width: 100%;
@@ -1140,9 +1123,7 @@ nav.text-page-nav:not(:has(a)) {
   }
 
   .article-content th,
-  .article-content td,
-  .article-content .table-csv th,
-  .article-content .table-csv td {
+  .article-content td {
     padding: var(--space-xs) var(--space-sm);
   }
 }

data/assets/css/ledger/footer.css

@@ -230,11 +230,14 @@
 }
 
 /* A middot between items rather than a separator element, so an absent
-   license leaves no orphaned punctuation behind. */
+   license leaves no orphaned punctuation behind. outline-variant is the
+   hairline token: #b8b8b8 on #f4f4f4 is 1.80:1, and #45454c on #141418
+   is 1.93:1. outline clears 4.5:1 on the same panel (6.08:1 light,
+   5.95:1 dark). */
 .site-footer-imprint-item+.site-footer-imprint-item::before {
   content: "·";
   margin-right: var(--space-md);
-  color: var(--color-outline-variant);
+  color: var(--color-outline);
 }
 
 .site-footer-imprint-link {

data/assets/css/ledger/home.css

@@ -91,8 +91,7 @@
   opacity: 0.42;
 }
 
-.home-hero-art-svg,
-.home-hero-pandorga-svg {
+.home-hero-art-svg {
   width: 100%;
   height: 100%;
   display: block;

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

data/lib/pandorga/version.rb

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

data/scripts/content/band_art.rb

@@ -27,7 +27,7 @@
 # because the plates went stale otherwise. Cloudflare Pages excludes `content/*`
 # from its build watch paths, so a Studio save never rebuilds the shell, and art
 # committed into a layout is art that stops counting the day it is written. See
-# docs/features/home-band-art.md.
+# docs/deploy/cloudflare.md.
 #
 # The output is SVG whose every stroke and fill is a custom property, because the
 # site has two complete palettes and switches between them on a `data-theme`

data/scripts/content/export-content-json.rb

@@ -653,7 +653,7 @@ def export_derived_data(content_root, output_root)
 end
 
 # The home page's reference band, drawn from the corpus this run just exported
-# rather than from committed markup. See docs/features/home-band-art.md for why
+# rather than from committed markup. See docs/deploy/cloudflare.md for why
 # it lives here: a Studio save never rebuilds the shell, so art baked into a
 # layout stops counting the day it is written.
 def export_band_art(output_root, writing_index)

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

@@ -86,7 +86,12 @@ sheets.each do |path|
     home-index-shard--gamma
     home-index-note
     post-content
+    home-hero-pandorga-svg
+    table-csv
   ]
+  if cleaned.include?("span.text-secondary:not(.font-bold)")
+    errors << "#{relative}: author byline suppressor matches no markup"
+  end
   retired.each do |name|
     next unless cleaned.match?(/[.#]#{Regexp.escape(name)}\b/)
 

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

@@ -1,7 +1,7 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
-# Home band art (docs/features/home-band-art.md).
+# Home band art. Watch paths: docs/deploy/cloudflare.md.
 #
 # AC-BAND-01 the export writes both plates under data/
 # AC-BAND-03 a second export with no content change reports them unchanged

data/scripts/test/test-new.rb

@@ -32,6 +32,46 @@ if readme.include?("once 1.1 is on RubyGems")
   exit 1
 end
 
+version = ROOT.join("lib/pandorga/version.rb").read[/VERSION = "([^"]+)"/, 1]
+unless version
+  warn "FAIL test-new: Pandorga::VERSION missing"
+  exit 1
+end
+
+deploy = ROOT.join("docs/deploy/cloudflare.md").read
+upgrading = ROOT.join("docs/upgrading.md").read
+scaffold = ROOT.join("lib/pandorga/commands/new.rb").read
+[
+  [deploy, "docs/deploy/cloudflare.md"],
+  [upgrading, "docs/upgrading.md"],
+  [scaffold, "lib/pandorga/commands/new.rb"]
+].each do |text, label|
+  if text.include?("v1.0.0") || text.include?("v1.3.11") || text.include?("v1.5.0")
+    warn "FAIL test-new: #{label} still names a stale release pin"
+    exit 1
+  end
+end
+unless deploy.include?('~> 1.3') && deploy.include?(%(tag: "v#{version}"))
+  warn "FAIL test-new: deploy doc must pin ~> 1.3 and tag v#{version}"
+  exit 1
+end
+unless deploy.include?("content/*") && deploy.include?("docs/*") && deploy.include?("Gemfile.lock")
+  warn "FAIL test-new: deploy doc lost the watch-path include and excludes"
+  exit 1
+end
+unless deploy.include?("3.4.4") && deploy.include?("SKIP_DEPENDENCY_INSTALL")
+  warn "FAIL test-new: deploy doc lost the Pages Ruby pin or SKIP_DEPENDENCY_INSTALL"
+  exit 1
+end
+unless upgrading.include?(%(tag: "v#{version}")) && upgrading.include?("pandorga-#{version}.gem")
+  warn "FAIL test-new: upgrading examples are not v#{version}"
+  exit 1
+end
+unless scaffold.include?(%(tag: "v#{version}"))
+  warn "FAIL test-new: scaffold comment is not tag v#{version}"
+  exit 1
+end
+
 FileUtils.rm_rf(DEST)
 
 stdout, stderr, status = run_new(DEST.to_s)

data/scripts/test/test-r2-config-consistency.rb

@@ -36,7 +36,7 @@ end
 
 if ContentStorageConfig.placeholder?(base)
   puts "SKIP: R2 URL alignment checks (content_api_base_url is still placeholder: #{base})"
-  puts "      Fill the URL per docs/ops/cloudflare.md before production cutover."
+  puts "      Fill the URL per docs/deploy/cloudflare.md before production cutover."
   exit 0
 end
 

data/scripts/test/test-theme-contrast.rb

@@ -40,4 +40,24 @@ fail!("dark tertiary container moved") unless background.casecmp("#6a684f").zero
 ratio = contrast(foreground, background)
 fail!("#{foreground} on #{background} is #{ratio.round(2)}:1") unless ratio >= 4.5
 
-puts "PASS test-theme-contrast (#{foreground} on #{background} = #{ratio.round(2)}:1)"
+# Footer imprint middot. outline-variant is a hairline and fails as ink
+# on the panel step. The separator uses outline, which clears 4.5:1.
+footer = ROOT.join("assets/css/ledger/footer.css").read
+fail!("footer imprint separator still uses outline-variant") if footer.include?("color: var(--color-outline-variant)")
+fail!("footer imprint separator lost outline") unless footer.include?("color: var(--color-outline)")
+
+light = YAML.safe_load(ROOT.join("_data/themes/light.yml").read) || {}
+pairs = {
+  "light" => [light.dig("neutrals", "outline"), light.dig("neutrals", "panel_contrast")],
+  "dark" => [dark.dig("neutrals", "outline"), dark.dig("neutrals", "panel_contrast")]
+}
+reports = []
+pairs.each do |name, (ink, panel)|
+  fail!("#{name} outline or panel missing") if ink.to_s.empty? || panel.to_s.empty?
+
+  pair_ratio = contrast(ink, panel)
+  fail!("#{name} outline #{ink} on panel #{panel} is #{pair_ratio.round(2)}:1") unless pair_ratio >= 4.5
+  reports << "#{name} #{ink} on #{panel} = #{pair_ratio.round(2)}:1"
+end
+
+puts "PASS test-theme-contrast (#{foreground} on #{background} = #{ratio.round(2)}:1; #{reports.join('; ')})"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pandorga
 version: !ruby/object:Gem::Version
-  version: 1.7.3
+  version: 1.7.4
 platform: ruby
 authors:
 - The Pandorga contributors
@@ -328,7 +328,6 @@ files:
 - lib/pandorga/version.rb
 - scripts/cdn-allowlist.json
 - scripts/check_home_lists.mjs
-- scripts/content/backfill-content-keys.rb
 - scripts/content/band_art.rb
 - scripts/content/export-content-json.rb
 - scripts/content/flatten-ansi-capture.mjs
@@ -405,7 +404,6 @@ files:
 - scripts/test/render-parity/youtube.json
 - scripts/test/test-absent-field-absent-element.rb
 - scripts/test/test-cdn-pins.rb
-- scripts/test/test-cloudflare-watch-paths-doc.rb
 - scripts/test/test-configuration-doc.rb
 - scripts/test/test-content-backend.rb
 - scripts/test/test-content-detail-urls.rb

data/scripts/content/backfill-content-keys.rb

@@ -1,99 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require "pathname"
-require "yaml"
-
-require_relative "../../_plugins/content_keys"
-require_relative "../../_plugins/content_detail_paths"
-require_relative "../../_plugins/git_chronology"
-
-REPO_ROOT = Pathname.new(__dir__).join("..", "..").expand_path
-CONTENT_ROOT = REPO_ROOT.join("content")
-
-KEY_OVERRIDES = {
-  "content/collections/posts/2026-03-06-horse-auto-follow.md" => "horse-auto-follow-pt",
-  "content/collections/posts/2026-03-02-mcmc.md" => "mcmc-pt"
-}.freeze
-
-def split_front_matter(text)
-  ContentKeys.split_front_matter(text)
-end
-
-def write_front_matter(path, front_matter, body)
-  yaml = front_matter.to_yaml.sub(/\A---\n/, "").strip
-  path.write("---\n#{yaml}\n---\n\n#{body}")
-end
-
-def infer_key(entry)
-  override = KEY_OVERRIDES[entry["repo_relative_path"]]
-  return override if override
-
-  key = ContentKeys.normalize_key(entry["key"])
-  return key unless key.empty?
-
-  ContentKeys.infer_key_from_filename(entry["path"], entry["type"])
-end
-
-def legacy_detail_path(type, legacy_segment)
-  case type
-  when "article" then ContentDetailPaths.article_detail_path(legacy_segment)
-  when "post" then ContentDetailPaths.post_detail_path(legacy_segment)
-  when "project" then ContentDetailPaths.project_detail_path(legacy_segment)
-  when "product" then ContentDetailPaths.product_detail_path(legacy_segment)
-  else
-    raise "unknown type #{type}"
-  end
-end
-
-def migrate_redirect_fields!(front_matter)
-  redirects = ContentKeys.normalize_redirects(front_matter)
-  front_matter.delete("redirect_from")
-  front_matter["redirects"] = redirects unless redirects.empty?
-  front_matter
-end
-
-def ensure_legacy_redirect!(front_matter, type, legacy_segment, canonical_path)
-  redirects = ContentKeys.normalize_redirects(front_matter)
-  legacy = legacy_detail_path(type, legacy_segment).chomp("/")
-  canonical = canonical_path.chomp("/")
-  redirects << legacy unless legacy == canonical
-  redirects = redirects.map { |path| ContentKeys.normalize_redirect_path(path) }.compact.uniq
-  front_matter["redirects"] = redirects unless redirects.empty?
-  front_matter.delete("redirects") if redirects.empty?
-  front_matter
-end
-
-updated = 0
-ContentKeys::CONTENT_PATHS.each do |type, relative_dir|
-  directory = CONTENT_ROOT.join(relative_dir.sub(%r{\Acontent/}, ""))
-  next unless directory.directory?
-
-  Dir.glob(directory.join("*.{md,markdown}")).sort.each do |absolute_path|
-    entry = ContentKeys.load_entry(absolute_path, type, repo_root: REPO_ROOT)
-    text = File.read(absolute_path).sub(/\A\xEF\xBB\xBF/, "")
-    front_matter, body = split_front_matter(text)
-    original_yaml = front_matter.to_yaml
-
-    key = infer_key(entry)
-    front_matter["key"] = key
-    migrate_redirect_fields!(front_matter)
-
-    if %w[article post].include?(type)
-      GitChronology.apply!(front_matter, entry["repo_relative_path"], type)
-    end
-
-    canonical = ContentKeys.detail_path(type, key, date: front_matter["date"])
-    ensure_legacy_redirect!(front_matter, type, entry["legacy_segment"], canonical)
-
-    next if front_matter.to_yaml == original_yaml
-
-    write_front_matter(Pathname(absolute_path), front_matter, body.sub(/\A\n+/, ""))
-    updated += 1
-    puts "updated #{entry['repo_relative_path']} (key=#{key})"
-  end
-end
-
-ContentKeys.validate!(REPO_ROOT)
-ContentKeys.sync_redirects_file!(REPO_ROOT)
-puts "Backfill complete (#{updated} file(s) updated). Redirects synced to _redirects."

data/scripts/test/test-cloudflare-watch-paths-doc.rb

@@ -1,31 +0,0 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require "pathname"
-
-ROOT = Pathname.new(__dir__).join("..", "..").expand_path
-DOC = ROOT.join("docs/ops/cloudflare.md")
-
-def check!(condition, message = "condition was false")
-  raise "Assertion failed: #{message}" unless condition
-end
-
-text = DOC.read
-
-puts "Testing Cloudflare watch paths documentation..."
-
-check! text.include?("`*`"), "missing include pattern `*`"
-check! text.include?("`content/*`"), "missing exclude pattern content/*"
-check! text.include?("`docs/*`"), "missing exclude pattern docs/*"
-check! text.include?("Settings → Build → Build watch paths"),
-       "missing dashboard navigation path"
-check! text.include?("SKIP_DEPENDENCY_INSTALL"),
-       "missing SKIP_DEPENDENCY_INSTALL (avoids Pages pip install of study deps)"
-check! text.include?("bundle install") && text.include?("jekyll build"),
-       "missing lean Pages build command with explicit bundle install"
-check! text.include?("pandorga install-functions"),
-       "missing pandorga install-functions in Pages build command (PLT-0.2)"
-check! text.include?("3.4.4"),
-       "missing Pages v3 Ruby 3.4.4 pin (avoids compiling Ruby from source)"
-
-puts "Cloudflare watch paths documentation OK."