pandorga 1.6.5 → 1.6.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0b772584dba676ef335aa1f56a912948ce50d9a142334711a24e9ebf6629f35e
-  data.tar.gz: 046a693ae7e9cc93e4c300e998aeea7f72c0b31cfd9fa98847ed4a05c6761964
+  metadata.gz: ea34cfd7c17d2af28fcbd6a14c791f47b62fcf3a0c1c27b453f2467e6e4e101e
+  data.tar.gz: 7935fd040c610ffd52cab6587ecbcf31368a6097e21010f41b36ea92df013332
 SHA512:
-  metadata.gz: 705f9a05d328407ea488e5493642debaaad9ee4775a7ac1fc0587adf494065960fb5f2f6b202c3ff14c04d21e7812cb02abef1f39b8a2c85da7bfe2a96e941c3
-  data.tar.gz: ebd39b4db3858646577c254a590b6a5925d6b90e62b04d41bd29c17d13d9b3dfeeb2a8ced0189c227520d532ddaa3dc1419888dfd02f37c53802d99c7565c1a2
+  metadata.gz: 03e056b64de07a581a1b6293dd8a4db3aa40872219f170adfeaf25efe948317a62c04444db0cfe36cf67d8138ed003f9f832fc5c1150a0d84d174abc48232cdc
+  data.tar.gz: cd7dec364ba9a21e18c0ec05e60bd7eed94ca99a217b99a5cd2a67498c9778e51a78267ba4cad58bab5098020e7c75f8be2e8a5df3b84b4d23c37b07313ed16f

data/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [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/theme/font-loader.html

@@ -51,6 +51,17 @@
   {% 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 head link. A preload or a print sheet is discovered immediately.
+  On a fast connection the faces finish before the largest paint, and the
+  simulator then waits on them. Add the sheet after load. display=swap stays.
+{% endcomment %}
+<script>
+  window.addEventListener('load', function () {
+    var link = document.createElement('link');
+    link.rel = 'stylesheet';
+    link.href = {{ fonts_href | jsonify }};
+    document.head.appendChild(link);
+  });
+</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 and adds its stylesheet after load.
   {%- endcomment -%}
   <link href="https://fonts.googleapis.com" rel="preconnect" />
   <link crossorigin="" href="https://fonts.gstatic.com" rel="preconnect" />
@@ -131,8 +131,16 @@
     });
   </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>
+  {%- 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 = {{ _flags_href | jsonify }};
+      document.head.appendChild(link);
+    });
+  </script>
+  <noscript><link rel="stylesheet" href="{{ _flags_href }}" /></noscript>
   <style>
     :root { --drop-cap-lines: {{ site.drop_cap_lines | default: 2 }}; }
   </style>

data/lib/pandorga/version.rb

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

data/scripts/lighthouse-home.sh

@@ -1,7 +1,8 @@
 #!/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)"
@@ -11,6 +12,7 @@ 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
@@ -65,11 +67,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 +81,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 +98,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")
@@ -61,6 +66,22 @@ 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")
+
+fonts = ROOT.join("_includes/theme/font-loader.html").read
+font_screen = fonts.sub(%r{<noscript>.*?</noscript>}m, "")
+fail!("text faces are preloaded") if fonts.include?('rel="preload"')
+fail!("text face sheet is not deferred until load") unless font_screen.include?("addEventListener('load'")
+fail!("screen still has a text-face stylesheet link") if font_screen.match?(/<link\b/)
+
+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 discovers text faces from the head") unless spec.include?("text-face stylesheet is not a head link")
+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

metadata

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