pandorga 1.6.5 → 1.6.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0b772584dba676ef335aa1f56a912948ce50d9a142334711a24e9ebf6629f35e
-  data.tar.gz: 046a693ae7e9cc93e4c300e998aeea7f72c0b31cfd9fa98847ed4a05c6761964
+  metadata.gz: 28483b04968177f92f86ee26292b1bca873db8515dcb0d1735b72be27a564fb8
+  data.tar.gz: d2d20eb68479f49655c122a3948398e8e2719a27be458e27bc6f60aa002729da
 SHA512:
-  metadata.gz: 705f9a05d328407ea488e5493642debaaad9ee4775a7ac1fc0587adf494065960fb5f2f6b202c3ff14c04d21e7812cb02abef1f39b8a2c85da7bfe2a96e941c3
-  data.tar.gz: ebd39b4db3858646577c254a590b6a5925d6b90e62b04d41bd29c17d13d9b3dfeeb2a8ced0189c227520d532ddaa3dc1419888dfd02f37c53802d99c7565c1a2
+  metadata.gz: 89dd79f11d075413daac4ebcda740dc4f36a426a8b11aa608570551a446c79b09fc2223a74d703a36c2cae2fdaf0a14f41b6e3cf0048261c336a3a2a082e0100
+  data.tar.gz: efeaa1c9b49c5884e19b0e778e1a7205eec1dd000dc3c8875fa62747cf3a5df813202310f2cd2092d4d71847d629e6e8d1fedbf63e6bff8c99245f568f1a73f2

data/CHANGELOG.md

@@ -1,5 +1,40 @@
 # Changelog
 
+## [1.6.7] — 2026-10-10
+
+### Fixed
+
+- Text faces are requested after the first paint and before the load
+  event. A blocking sheet held first paint on the font host. The load
+  event held the hero summary until images finished, so the live home
+  scored about 50 while the example, which has no summary, scored 98.
+- The icon face names the icons it needs. The full variable file is about
+  a megabyte, and decoding it blocked the main thread on the live home.
+- The project inventory region has a role to match its accessible name.
+- Lighthouse measures `examples/full`, whose home includes a static hero
+  summary, the element a real site paints largest.
+
+No `pandorga:` config keys were added or renamed.
+
+## [1.6.6] — 2026-10-10
+
+### Fixed
+
+- The text faces and the flag stylesheet are requested after the load
+  event. A head link let a fast connection finish them before the largest
+  paint, and the simulator then counted those files as part of that paint.
+  The same templates scored 87 on the release run and 97 on the pull
+  request. `font-display: swap` stays.
+- The markdown library loads with `defer`. The example home is already
+  HTML, so that script does not block the parser.
+
+### Changed
+
+- A release below 90 does not publish. A bug-fix release whose notes
+  include `LIGHTHOUSE_BUGFIX=1` may still publish from 75 to 89.
+
+No `pandorga:` config keys were added or renamed.
+
 ## [1.6.5] — 2026-10-10
 
 ### Fixed

data/README.md

@@ -84,8 +84,9 @@ Lighthouse mobile thresholds apply to releases. A stable release scores
 and an urgent performance campaign must then bring it back to 90 or above.
 Below 75 is never acceptable for a release. A pull request or a merge may
 score lower when that is unavoidable to keep the work modular. The release
-build fails below 75. Pull requests and merges only warn. The checklist
-is in [CONTRIBUTING.md](CONTRIBUTING.md).
+build publishes at 90 or above. Notes that include `LIGHTHOUSE_BUGFIX=1`
+may publish a bug fix from 75 to 89. Pull requests and merges only warn.
+The checklist is in [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ## License
 

data/_includes/content-runtime/00-config.html

@@ -1,4 +1,4 @@
-<script src="https://cdn.jsdelivr.net/npm/marked@15.0.7/marked.min.js"></script>
+<script defer src="https://cdn.jsdelivr.net/npm/marked@15.0.7/marked.min.js"></script>
 <script>
   window.ContentRuntimeConfig = {
     contentBase: '{{ site.content_api_base_url | default: "" }}',

data/_includes/home/band-listing.html

@@ -54,7 +54,7 @@
       data-tag-base="{{ _path }}"
     >
       <div class="home-project-specimen-slot" data-home-specimen></div>
-      <div class="home-project-inventory" data-home-inventory aria-label="Project inventory"></div>
+      <div class="home-project-inventory" data-home-inventory role="region" aria-label="Project inventory"></div>
     </div>
     {%- else -%}
     <div

data/_includes/theme/font-loader.html

@@ -51,6 +51,13 @@
   {% endunless %}
 {% endif %}
 {% assign fonts_href = fonts_href | append: "&display=swap" %}
-<link rel="preload" as="style" href="{{ fonts_href }}" />
-<link rel="stylesheet" href="{{ fonts_href }}" media="print" onload="this.media='all'" />
+{% comment %}
+  Not a render-blocking head link, and not the load event. A blocking
+  sheet holds first paint on the font host. The load event holds the hero
+  summary until images finish. The shell inserts this sheet after the
+  first paint. display=swap stays.
+{% endcomment %}
+<script>
+  window.__pandorgaFontsHref = {{ fonts_href | jsonify }};
+</script>
 <noscript><link rel="stylesheet" href="{{ fonts_href }}" /></noscript>

data/_layouts/shell.html

@@ -59,10 +59,10 @@
   <!-- Canonical URL -->
   <link rel="canonical" href="{{ canonical_path | absolute_url }}" />
   {%- comment -%}
-    Preconnect only. font-loader's stylesheet is render-blocking, and the
-    preload script below is parser-blocking. A stylesheet before that script
-    holds the parser until fonts.googleapis.com answers, so the ledger sheets
-    and the hero summary cannot paint. The face is linked with the other sheets.
+    Preconnect only. The preload script below is parser-blocking. A
+    stylesheet before that script holds the parser until the font host
+    answers, so the ledger sheets and the hero cannot paint. The text-face
+    loader sits with the local sheets.
   {%- endcomment -%}
   <link href="https://fonts.googleapis.com" rel="preconnect" />
   <link crossorigin="" href="https://fonts.gstatic.com" rel="preconnect" />
@@ -117,22 +117,75 @@
   {%- endfor -%}
   {% include theme/font-loader.html %}
   {%- comment -%}
-    Icons are not first paint. The face is about a megabyte. A link in the
-    head, even with print media, is discovered immediately and the simulator
-    then waits on that face for the largest paint. Add the sheet after load.
+    Named icons only. The full variable face is about a megabyte, and a
+    late request for it becomes the largest paint on a real hero. Nav icons
+    from the registry join the shell set.
   {%- endcomment -%}
-  {%- assign _symbols_href = "https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:wght,FILL@100..700,0..1&display=swap" -%}
+  {%- assign _icon_names = "arrow_left_alt,arrow_right_alt,architecture,article,chat,chevron_left,chevron_right,close,code,dark_mode,expand_more,filter_list,format_quote,format_size,info,light_mode,menu,picture_as_pdf,public,routine,search,share,shuffle,sync" -%}
+  {%- for _group in site.data.nav -%}
+    {%- for _item in _group.pages -%}
+      {%- if _item.icon -%}
+        {%- assign _icon_hay = "," | append: _icon_names | append: "," -%}
+        {%- assign _icon_needle = "," | append: _item.icon | append: "," -%}
+        {%- unless _icon_hay contains _icon_needle -%}
+          {%- assign _icon_names = _icon_names | append: "," | append: _item.icon -%}
+        {%- endunless -%}
+      {%- endif -%}
+    {%- endfor -%}
+  {%- endfor -%}
+  {%- assign _symbols_href = "https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:wght,FILL@100..700,0..1&icon_names=" | append: _icon_names | append: "&display=swap" -%}
+  <script>
+    window.__pandorgaIconsHref = {{ _symbols_href | jsonify }};
+  </script>
+  <noscript><link id="pandorga-icons" rel="stylesheet" href="{{ _symbols_href }}" /></noscript>
+  <script>
+    (function () {
+      var known = {{ _icon_names | split: "," | jsonify }};
+      var seen = {};
+      known.forEach(function (name) { seen[name] = true; });
+      var dirty = false;
+      var timer = 0;
+      window.__pandorgaFlushIcons = function () {
+        var link = document.getElementById('pandorga-icons');
+        if (!link || !dirty) return;
+        dirty = false;
+        link.href = 'https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:wght,FILL@100..700,0..1&icon_names=' + known.join(',') + '&display=swap';
+      };
+      function consider(root) {
+        if (!root || !root.querySelectorAll) return;
+        var nodes = root.querySelectorAll('.material-symbols-outlined');
+        var extra = false;
+        for (var i = 0; i < nodes.length; i++) {
+          var name = (nodes[i].textContent || '').trim();
+          if (!name || seen[name] || !/^[a-z0-9_]+$/.test(name)) continue;
+          seen[name] = true;
+          known.push(name);
+          extra = true;
+        }
+        if (!extra) return;
+        dirty = true;
+        clearTimeout(timer);
+        timer = setTimeout(window.__pandorgaFlushIcons, 50);
+      }
+      function start() {
+        consider(document);
+        var obs = new MutationObserver(function () { consider(document); });
+        obs.observe(document.body, { childList: true, subtree: true, characterData: true });
+      }
+      if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', start);
+      else start();
+    })();
+  </script>
+  {%- assign _flags_href = "https://cdn.jsdelivr.net/gh/lipis/flag-icons@7.2.3/css/flag-icons.min.css" -%}
   <script>
     window.addEventListener('load', function () {
       var link = document.createElement('link');
       link.rel = 'stylesheet';
-      link.href = {{ _symbols_href | jsonify }};
+      link.href = {{ _flags_href | jsonify }};
       document.head.appendChild(link);
     });
   </script>
-  <noscript><link rel="stylesheet" href="{{ _symbols_href }}" /></noscript>
-  <link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/lipis/flag-icons@7.2.3/css/flag-icons.min.css" media="print" onload="this.media='all'" />
-  <noscript><link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/lipis/flag-icons@7.2.3/css/flag-icons.min.css" /></noscript>
+  <noscript><link rel="stylesheet" href="{{ _flags_href }}" /></noscript>
   <style>
     :root { --drop-cap-lines: {{ site.drop_cap_lines | default: 2 }}; }
   </style>
@@ -257,6 +310,28 @@
   {% include page/site-footer.html nav_active=nav_active %}
 
   {% include page/content-runtime.html %}
+  <script>
+    (function () {
+      var fonts = window.__pandorgaFontsHref;
+      var icons = window.__pandorgaIconsHref;
+      if (!fonts && !icons) return;
+      requestAnimationFrame(function () {
+        requestAnimationFrame(function () {
+          function sheet(href, id) {
+            if (!href) return;
+            var link = document.createElement('link');
+            link.rel = 'stylesheet';
+            link.href = href;
+            if (id) link.id = id;
+            document.head.appendChild(link);
+          }
+          sheet(fonts);
+          sheet(icons, 'pandorga-icons');
+          if (window.__pandorgaFlushIcons) window.__pandorgaFlushIcons();
+        });
+      });
+    })();
+  </script>
 
 </body>
 

data/examples/full/content/pages/cv/summary.md

@@ -1 +1 @@
-Ada Example designs publishing frames. This summary is fictional.
+Ada Example designs publishing frames. This summary is fictional. The home hero includes it as HTML, so the largest paint is this paragraph, the same element a real site measures.

data/lib/pandorga/version.rb

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

data/scripts/lighthouse-home.sh

@@ -1,16 +1,18 @@
 #!/usr/bin/env bash
 # One Lighthouse mobile run against the built example home.
-# Thresholds apply to releases. LIGHTHOUSE_MODE=enforce fails below 75
-# and warns below 90. LIGHTHOUSE_MODE=warn never fails the run. PLT-AC-24.
+# Thresholds apply to releases. LIGHTHOUSE_MODE=enforce does not publish
+# below 90 unless LIGHTHOUSE_BUGFIX=1, and that bug-fix release still
+# fails below 75. LIGHTHOUSE_MODE=warn never fails the run. PLT-AC-24.
 set -euo pipefail
 
 ROOT="$(cd "$(dirname "$0")/.." && pwd)"
-SITE="${ROOT}/examples/minimal/_site"
+SITE="${ROOT}/examples/full/_site"
 PORT="${LIGHTHOUSE_PORT:-4173}"
 OUT="${LIGHTHOUSE_REPORT:-/tmp/lighthouse-home.json}"
 FAIL_BELOW=75
 WARN_BELOW=90
 MODE="${LIGHTHOUSE_MODE:-enforce}"
+BUGFIX="${LIGHTHOUSE_BUGFIX:-}"
 
 fail() {
   echo "ERROR: $1" >&2
@@ -24,6 +26,8 @@ if [[ "${MODE}" != "enforce" && "${MODE}" != "warn" ]]; then
 fi
 
 [[ -f "${SITE}/index.html" ]] || fail "missing ${SITE}/index.html (run scripts/validate.sh first)"
+grep -q 'id="home-cv-summary"[^>]*data-content-static' "${SITE}/index.html" \
+  || fail "example home has no static hero summary (data-content-static)"
 
 if [[ -n "${CHROME_PATH:-}" && -x "${CHROME_PATH}" ]]; then
   CHROME="${CHROME_PATH}"
@@ -65,11 +69,11 @@ npx --yes lighthouse@13.5.0 "http://127.0.0.1:${PORT}/" \
   --chrome-path="${CHROME}" \
   --chrome-flags="--headless=new --no-sandbox --disable-gpu"
 
-python3 - "${OUT}" "${FAIL_BELOW}" "${WARN_BELOW}" "${MODE}" <<'PY'
+python3 - "${OUT}" "${FAIL_BELOW}" "${WARN_BELOW}" "${MODE}" "${BUGFIX}" <<'PY'
 import json
 import sys
 
-path, fail_below, warn_below, mode = sys.argv[1:]
+path, fail_below, warn_below, mode, bugfix = sys.argv[1:]
 fail_below = int(fail_below)
 warn_below = int(warn_below)
 report = json.load(open(path, encoding="utf-8"))
@@ -79,6 +83,16 @@ if raw is None:
     sys.exit(1)
 score = int(round(float(raw) * 100))
 print(f"Lighthouse mobile performance: {score} ({mode})")
+audits = report.get("audits", {})
+for key in (
+    "first-contentful-paint",
+    "largest-contentful-paint",
+    "speed-index",
+    "total-blocking-time",
+    "cumulative-layout-shift",
+):
+    display = audits.get(key, {}).get("displayValue", "?")
+    print(f"  {key}: {display}")
 campaign = (
     "A score from 75 to 89 is acceptable only to ship a bug fix. "
     "An urgent performance campaign must bring it back to 90 or above."
@@ -86,6 +100,13 @@ campaign = (
 if score < fail_below and mode == "enforce":
     print(f"::error::Lighthouse mobile performance {score} is below {fail_below}")
     sys.exit(1)
+if mode == "enforce" and score < warn_below and bugfix != "1":
+    print(
+        f"::error::Lighthouse mobile performance {score} is below {warn_below}. "
+        + campaign
+        + " This release is not marked LIGHTHOUSE_BUGFIX=1, so it will not publish."
+    )
+    sys.exit(1)
 if score < fail_below:
     print(
         f"::warning::Lighthouse mobile performance {score} is below {fail_below}. "

data/scripts/test/test-lighthouse-policy.rb

@@ -49,6 +49,11 @@ fail!("lighthouse script lost the fail floor") unless script.include?("FAIL_BELO
 fail!("lighthouse script lost the warn floor") unless script.include?("WARN_BELOW=90")
 fail!("lighthouse script lost enforce mode") unless script.include?('LIGHTHOUSE_MODE:-enforce')
 fail!("warn mode still fails the run") unless script.include?('mode == "enforce"')
+fail!("a non-bug-fix release can publish below 90") unless script.include?('bugfix != "1"')
+fail!("release workflow cannot mark a bug fix") unless release.include?("LIGHTHOUSE_BUGFIX")
+fail!("spec still publishes a feature below 90") unless spec.include?("LIGHTHOUSE_BUGFIX=1")
+fail!("contributing still publishes a feature below 90") unless contributing.include?("LIGHTHOUSE_BUGFIX=1")
+fail!("readme still publishes a feature below 90") unless docs.fetch("readme").include?("LIGHTHOUSE_BUGFIX=1")
 fail!("lighthouse script is not a single mobile run") unless script.include?("--form-factor=mobile")
 fail!("lighthouse script repeats runs") if script.include?("--repeat")
 fail!("example server is still one-thread HTTP/1.0") if script.include?("python3 -m http.server")
@@ -59,8 +64,30 @@ fail!("icon face is preloaded") if shell.include?("rel=\"preload\" as=\"style\"
 
 screen = shell.sub(%r{<noscript>.*?</noscript>}m, "")
 fail!("Material Symbols sheet is missing") unless shell.include?("Material+Symbols+Outlined")
-fail!("icon sheet is not deferred until load") unless screen.include?("addEventListener('load'")
-fail!("screen still has a Material Symbols stylesheet link") if screen.match?(/<link\b[^>]*Material\+Symbols/)
+fail!("screen still has a flag stylesheet link") if screen.match?(/<link\b[^>]*flag-icons/)
+fail!("flag sheet is not deferred until load") unless screen.include?("flag-icons@7.2.3")
+fail!("icon face is the full variable font") if shell.include?("0..1&display=swap")
+fail!("icon face is not a named subset") unless shell.include?("icon_names=")
+fail!("icon subset link has no id") unless screen.include?("pandorga-icons")
+
+fonts = ROOT.join("_includes/theme/font-loader.html").read
+fail!("text faces are preloaded") if fonts.include?('rel="preload"')
+fail!("text face still waits for the load event") if fonts.include?("addEventListener('load'")
+fail!("text face href is not handed to the shell") unless fonts.include?("__pandorgaFontsHref")
+fail!("text face is not requested after first paint") unless screen.scan("requestAnimationFrame").length >= 2
+
+marked = ROOT.join("_includes/content-runtime/00-config.html").read
+fail!("markdown library still blocks parsing") unless marked.include?("<script defer ")
+fail!("markdown library source changed") unless marked.include?("marked@15.0.7/marked.min.js")
+
+fail!("spec still withholds the text face until load") unless spec.include?("after the first paint and before the load event")
+fail!("lighthouse example is not the full site") unless script.include?("examples/full")
+fail!("lighthouse example can ship without a static summary") unless script.include?("data-content-static")
+summary = ROOT.join("examples/full/content/pages/cv/summary.md").read
+fail!("full summary dropped the fixture sentence") unless summary.include?("Ada Example designs publishing frames")
+fail!("full summary is too short to be the hero paint") unless summary.scan(".").length >= 3
+fail!("spec still lets the markdown library block parsing") unless spec.include?("markdown library loads with `defer`")
+fail!("lighthouse script hides the metric breakdown") unless script.include?("largest-contentful-paint")
 
 icon = base[/\.material-symbols-outlined\.material-symbols-outlined \{.*?\n\}/m]
 fail!("icon rule missing") unless icon
@@ -71,6 +98,7 @@ fail!("content runtime still precedes the page") unless shell.index("{{ content
 band = File.read(File.expand_path("../../_includes/home/band-listing.html", __dir__))
 fail!("band title is still painted by script") unless band.include?('data-content-section-title>{{ _title }}')
 fail!("band note is still painted by script") unless band.include?("page_headers")
+fail!("project inventory has a name and no role") unless band.include?('role="region"') && band.include?('aria-label="Project inventory"')
 headers = File.read(File.expand_path("../../_plugins/content_headers.rb", __dir__))
 fail!("page headers are not loaded at build time") unless headers.include?('site.data["page_headers"]')
 home = File.read(File.expand_path("../../_layouts/home.html", __dir__))

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pandorga
 version: !ruby/object:Gem::Version
-  version: 1.6.5
+  version: 1.6.7
 platform: ruby
 authors:
 - The Pandorga contributors