pandorga 1.6.6 → 1.6.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ea34cfd7c17d2af28fcbd6a14c791f47b62fcf3a0c1c27b453f2467e6e4e101e
-  data.tar.gz: 7935fd040c610ffd52cab6587ecbcf31368a6097e21010f41b36ea92df013332
+  metadata.gz: 28483b04968177f92f86ee26292b1bca873db8515dcb0d1735b72be27a564fb8
+  data.tar.gz: d2d20eb68479f49655c122a3948398e8e2719a27be458e27bc6f60aa002729da
 SHA512:
-  metadata.gz: 03e056b64de07a581a1b6293dd8a4db3aa40872219f170adfeaf25efe948317a62c04444db0cfe36cf67d8138ed003f9f832fc5c1150a0d84d174abc48232cdc
-  data.tar.gz: cd7dec364ba9a21e18c0ec05e60bd7eed94ca99a217b99a5cd2a67498c9778e51a78267ba4cad58bab5098020e7c75f8be2e8a5df3b84b4d23c37b07313ed16f
+  metadata.gz: 89dd79f11d075413daac4ebcda740dc4f36a426a8b11aa608570551a446c79b09fc2223a74d703a36c2cae2fdaf0a14f41b6e3cf0048261c336a3a2a082e0100
+  data.tar.gz: efeaa1c9b49c5884e19b0e778e1a7205eec1dd000dc3c8875fa62747cf3a5df813202310f2cd2092d4d71847d629e6e8d1fedbf63e6bff8c99245f568f1a73f2

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # 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

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

@@ -52,16 +52,12 @@
 {% endif %}
 {% assign fonts_href = fonts_href | append: "&display=swap" %}
 {% 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.
+  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.addEventListener('load', function () {
-    var link = document.createElement('link');
-    link.rel = 'stylesheet';
-    link.href = {{ fonts_href | jsonify }};
-    document.head.appendChild(link);
-  });
+  window.__pandorgaFontsHref = {{ fonts_href | jsonify }};
 </script>
 <noscript><link rel="stylesheet" href="{{ fonts_href }}" /></noscript>

data/_layouts/shell.html

@@ -62,7 +62,7 @@
     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.
+    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,20 +117,65 @@
   {%- 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.addEventListener('load', function () {
-      var link = document.createElement('link');
-      link.rel = 'stylesheet';
-      link.href = {{ _symbols_href | jsonify }};
-      document.head.appendChild(link);
-    });
+    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>
-  <noscript><link rel="stylesheet" href="{{ _symbols_href }}" /></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 () {
@@ -265,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.6"
+  VERSION = "1.6.7"
 end

data/scripts/lighthouse-home.sh

@@ -6,7 +6,7 @@
 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
@@ -26,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}"

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

@@ -64,22 +64,28 @@ 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
-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/)
+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 discovers text faces from the head") unless spec.include?("text-face stylesheet is not a head link")
+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")
 
@@ -92,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.6
+  version: 1.6.7
 platform: ruby
 authors:
 - The Pandorga contributors