pandorga 1.6.8 → 1.6.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 355770a826a6483d7fbc1e014c76fc0ef865d23bba44674cc2153d25ed840a9c
-  data.tar.gz: 6fd8451064d1a3bc58a8ff4ed53b90606183644756c28984018ff20ae485a543
+  metadata.gz: 110f9fdf3636db9ef496093f969e15ef4cd3322ee143c5efadb210fb5e4b98b9
+  data.tar.gz: 6c5625b1cbdac652c0120d2b25e49a722c59941862cf91da7f44eff6f1ada004
 SHA512:
-  metadata.gz: 331cf7a4687f241ee1b653e2435986bd511536ac3d1bfd21b65c91deef8969994999d8d65696e54a5725e7be41169d10ff9abac70475844a018480869cb19c1c
-  data.tar.gz: 88fc4c23d1cb5680b054c2e7028e374caab861977114ae235de52547b482de74b0c282957fc5bdf31764c9c3f11e39a65bbd4372ee7ee8fbf397b238b41f1c66
+  metadata.gz: 22f67174268b9edd80046d916e6d8394d4ce1df62e8802be7dc4eab8771479825c1ba8b3aa2f668ebef53bc95f116f840ddd300428362b938a19b9955d0914d8
+  data.tar.gz: 85ce7605aae925b73d384a9ddbc0269b5b31bb58652b05b60617c5b784f8cfc2c68dc92cc3824ed07bf016f305aee36c5fba17a51c891ecce06cd58a0c3f94d0

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [1.6.9] — 2026-10-10
+
+### Fixed
+
+- Home list hydration no longer fills every band in one turn. The project
+  specimen measurement yields between projects, each band starts on its
+  own turn, and each home section introduction yields before it is
+  parsed. Dates reuse one formatter. The lists still render.
+
+No `pandorga:` config keys were added or renamed.
+
 ## [1.6.8] — 2026-10-10
 
 ### Fixed

data/_includes/content-runtime/40-listing.html

@@ -113,15 +113,23 @@
       return textExcerpt((item && item.body_markdown) || '');
     }
 
+    var dateFormatters = Object.create(null);
+
     function formatDate(value, locale) {
       if (!value) return '';
       var parts = String(value).slice(0, 10).split('-').map(Number);
       if (parts.length !== 3 || parts.some(isNaN)) return value;
-      return new Intl.DateTimeFormat(locale || 'en', {
-        day: '2-digit',
-        month: 'short',
-        year: 'numeric'
-      }).format(new Date(parts[0], parts[1] - 1, parts[2]));
+      var key = locale || 'en';
+      var formatter = dateFormatters[key];
+      if (!formatter) {
+        formatter = new Intl.DateTimeFormat(key, {
+          day: '2-digit',
+          month: 'short',
+          year: 'numeric'
+        });
+        dateFormatters[key] = formatter;
+      }
+      return formatter.format(new Date(parts[0], parts[1] - 1, parts[2]));
     }
 
     function chronologySortKey(item) {

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

@@ -353,15 +353,31 @@
       });
     }
 
+    function yieldToMain() {
+      return new Promise(function (resolve) {
+        if (typeof scheduler !== 'undefined' && typeof scheduler.yield === 'function') {
+          scheduler.yield().then(resolve);
+          return;
+        }
+        window.setTimeout(resolve, 0);
+      });
+    }
+
     function hydrateHomeSections() {
       var roots = Array.prototype.slice.call(
         document.querySelectorAll('[data-content-home-section]')
       );
       if (!roots.length) return Promise.resolve();
       return loadPageHeaders().then(function (sections) {
+        var chain = Promise.resolve();
         roots.forEach(function (root) {
-          applyHomeSection(root, sections[root.getAttribute('data-content-home-section')]);
+          chain = chain.then(function () {
+            return yieldToMain().then(function () {
+              applyHomeSection(root, sections[root.getAttribute('data-content-home-section')]);
+            });
+          });
         });
+        return chain;
       }).catch(function (error) {
         console.error(error);
         roots.forEach(function (root) { applyHomeSection(root, null); });
@@ -605,21 +621,31 @@
     }
 
     function hydratePageFragments() {
-      document.querySelectorAll('[data-content-page-header]').forEach(function (el) {
-        hydratePageHeader(el);
+      var headers = Array.prototype.slice.call(document.querySelectorAll('[data-content-page-header]'));
+      var chain = Promise.resolve();
+      headers.forEach(function (el) {
+        chain = chain.then(function () {
+          return yieldToMain().then(function () { return hydratePageHeader(el); });
+        });
       });
       document.querySelectorAll('[data-content-fragment]').forEach(function (el) {
         var path = el.getAttribute('data-content-fragment');
         if (!path) return;
-        mountMarkdownFragment(path, el, {
-          loadingText: el.getAttribute('data-content-loading') || 'Loading...',
-          errorText: el.getAttribute('data-content-error') || 'Content could not be loaded right now.'
+        chain = chain.then(function () {
+          return yieldToMain().then(function () {
+            return mountMarkdownFragment(path, el, {
+              loadingText: el.getAttribute('data-content-loading') || 'Loading...',
+              errorText: el.getAttribute('data-content-error') || 'Content could not be loaded right now.'
+            });
+          });
         });
       });
-      hydrateHomeSections();
-      hydrateBandArt();
-      hydrateContacts();
-      hydrateHeroPortrait();
+      chain.then(function () {
+        hydrateHomeSections();
+        hydrateBandArt();
+        hydrateContacts();
+        hydrateHeroPortrait();
+      });
     }
 
     function schedulePageFragmentHydration() {

data/_layouts/home.html

@@ -121,7 +121,21 @@ layout: shell
     }
 
     function byDateDesc(a, b) {
-      return String(b.date || '').localeCompare(String(a.date || ''));
+      var left = String(b.date || '');
+      var right = String(a.date || '');
+      if (left > right) return 1;
+      if (left < right) return -1;
+      return 0;
+    }
+
+    function afterPaint() {
+      return new Promise(function (resolve) {
+        if (typeof scheduler !== 'undefined' && typeof scheduler.yield === 'function') {
+          scheduler.yield().then(resolve);
+          return;
+        }
+        window.setTimeout(resolve, 0);
+      });
     }
 
     function tagHrefFrom(element) {
@@ -175,8 +189,13 @@ layout: shell
     function draftFolios(posts) {
       var folios = Object.create(null);
       posts.slice().sort(function (a, b) {
-        var byDate = String(a.date || '').localeCompare(String(b.date || ''));
-        return byDate !== 0 ? byDate : String(a.slug || '').localeCompare(String(b.slug || ''));
+        var byDate = String(a.date || '') < String(b.date || '') ? -1 : (String(a.date || '') > String(b.date || '') ? 1 : 0);
+        if (byDate !== 0) return byDate;
+        var left = String(a.slug || '');
+        var right = String(b.slug || '');
+        if (left < right) return -1;
+        if (left > right) return 1;
+        return 0;
       }).forEach(function (entry, index) {
         folios[entry.slug] = index + 1;
       });
@@ -221,7 +240,8 @@ layout: shell
       element.appendChild(fragment);
     }
 
-    function fillBand(section, index) {
+    async function fillBand(section, index) {
+      await afterPaint();
       var kind = section.getAttribute('data-home-kind');
       var collection = section.getAttribute('data-home-collection');
       var limit = parseInt(section.getAttribute('data-home-limit') || '3', 10) || 3;
@@ -316,7 +336,7 @@ layout: shell
           fitted(best);
         }
 
-        function paintSpecimen(entry) {
+        async function paintSpecimen(entry) {
           specimenSlot.innerHTML = '';
           specimenSlot.appendChild(runtime.renderProjectSpecimen(asItem(entry), {
             href: entry.url || runtime.projectUrl(entry.slug),
@@ -324,10 +344,11 @@ layout: shell
             folio: positionOf(entry.slug) + 1,
             openLabel: 'Open project'
           }));
+          await afterPaint();
           ellipsizeSpecimenCopy(specimenSlot);
         }
 
-        function measureTallestSpecimen() {
+        async function measureTallestSpecimen() {
           var bench = specimenSlot.closest('.home-projects-bench');
           if (!bench) return 0;
           var width = specimenSlot.getBoundingClientRect().width;
@@ -348,7 +369,8 @@ layout: shell
           bench.appendChild(probe);
 
           var max = 0;
-          portfolio.forEach(function (entry, i) {
+          for (var i = 0; i < portfolio.length; i += 1) {
+            var entry = portfolio[i];
             probe.innerHTML = '';
             var card = runtime.renderProjectSpecimen(asItem(entry), {
               href: entry.url || runtime.projectUrl(entry.slug),
@@ -360,15 +382,16 @@ layout: shell
             card.style.minHeight = '0';
             probe.appendChild(card);
             max = Math.max(max, Math.ceil(card.getBoundingClientRect().height));
-          });
+            await afterPaint();
+          }
           probe.remove();
           return max;
         }
 
-        function lockSpecimenHeight() {
+        async function lockSpecimenHeight() {
           var bench = specimenSlot.closest('.home-projects-bench');
           if (!bench) return;
-          var tallest = measureTallestSpecimen();
+          var tallest = await measureTallestSpecimen();
           /* Floor at the CSS inventory minimum so six rows always clear
              three stacked resource icons (see --home-inventory-min-height). */
           var inventoryMin = 0;
@@ -425,8 +448,9 @@ layout: shell
           });
         }
 
-        lockSpecimenHeight();
-        paintSpecimen(entryBySlug(selectedSlug));
+        await lockSpecimenHeight();
+        await paintSpecimen(entryBySlug(selectedSlug));
+        await afterPaint();
         paintInventory();
 
         var resizeTimer = null;
@@ -437,8 +461,9 @@ layout: shell
             var nextWidth = Math.round(specimenSlot.getBoundingClientRect().width);
             if (nextWidth === lastMeasureWidth) return;
             lastMeasureWidth = nextWidth;
-            lockSpecimenHeight();
-            paintSpecimen(entryBySlug(selectedSlug));
+            lockSpecimenHeight().then(function () {
+              return paintSpecimen(entryBySlug(selectedSlug));
+            });
           }, 120);
         });
         return;
@@ -484,7 +509,11 @@ layout: shell
 
     runtime.loadJson('data/writing_index.json').then(function (entries) {
       var index = Array.isArray(entries) ? entries : [];
-      sections.forEach(function (section) { fillBand(section, index); });
+      var chain = Promise.resolve();
+      sections.forEach(function (section) {
+        chain = chain.then(function () { return fillBand(section, index); });
+      });
+      return chain;
     }).catch(function (error) {
       console.error(error);
       sections.forEach(function (section) {

data/lib/pandorga/version.rb

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

data/scripts/check_home_lists.mjs

@@ -4,7 +4,7 @@
 // Lighthouse run treats an empty home as a fast page.
 
 import { spawn } from 'node:child_process';
-import { mkdtemp, rm } from 'node:fs/promises';
+import { mkdtemp, readFile, rm } from 'node:fs/promises';
 import { createServer } from 'node:net';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
@@ -90,17 +90,44 @@ class Cdp {
   }
 }
 
-async function waitForDevtools(port) {
-  for (let attempt = 0; attempt < 50; attempt += 1) {
-    try {
-      const response = await fetch(`http://127.0.0.1:${port}/json/version`);
-      if (response.ok) return response.json();
-    } catch (_error) {
-      // Chrome is still starting.
+async function activePort(profile) {
+  try {
+    const text = await readFile(join(profile, 'DevToolsActivePort'), 'utf8');
+    const value = Number(text.split('\n')[0]);
+    return Number.isInteger(value) && value > 0 ? value : null;
+  } catch (_error) {
+    return null;
+  }
+}
+
+async function waitForDevtools(port, chrome, profile) {
+  let stderr = '';
+  if (chrome.stderr) {
+    chrome.stderr.on('data', (chunk) => {
+      stderr += chunk;
+    });
+  }
+  for (let attempt = 0; attempt < 200; attempt += 1) {
+    if (chrome.exitCode !== null) {
+      throw new Error(`Chrome exited ${chrome.exitCode}: ${stderr.slice(-500)}`);
+    }
+    const opened = await activePort(profile);
+    const candidates = opened && opened !== port ? [port, opened] : [port];
+    for (const candidate of candidates) {
+      try {
+        const response = await fetch(`http://127.0.0.1:${candidate}/json/version`);
+        if (response.ok) return response.json();
+      } catch (_error) {
+        // Chrome is still starting.
+      }
     }
     await delay(100);
   }
-  throw new Error('Chrome DevTools did not answer');
+  const opened = await activePort(profile);
+  throw new Error(
+    `Chrome DevTools did not answer on ${port}` +
+    `${opened ? ` (DevToolsActivePort ${opened})` : ''}. ${stderr.slice(-500)}`
+  );
 }
 
 async function openSocket(url) {
@@ -155,14 +182,15 @@ async function main() {
     '--disable-dev-shm-usage',
     '--no-first-run',
     '--remote-allow-origins=*',
+    '--remote-debugging-address=127.0.0.1',
     `--remote-debugging-port=${port}`,
     `--user-data-dir=${profile}`,
     'about:blank'
-  ], { stdio: 'ignore' });
+  ], { stdio: ['ignore', 'ignore', 'pipe'] });
 
   let failed = false;
   try {
-    const version = await waitForDevtools(port);
+    const version = await waitForDevtools(port, chrome, profile);
     const ws = await openSocket(version.webSocketDebuggerUrl);
     const browser = new Cdp(ws);
     const created = await browser.send('Target.createTarget', { url: 'about:blank' });

data/scripts/test/test-home-lists.rb

@@ -43,7 +43,14 @@ end
 
 home = ROOT.join("_layouts/home.html").read
 fail!("home paint still runs before the runtime") unless home.scan("pandorga:runtime").length >= 2
-fail!("home bands still return when the runtime is missing") if home.include?("if (!runtime) return")
+fail!("home bands still fill in one turn") unless home.include?("scheduler.yield") && home.include?("await afterPaint()")
+fail!("specimen measurement does not yield") unless home.include?("await measureTallestSpecimen()")
+fail!("home still fills every band inside one callback") if home.include?("sections.forEach(function (section) { fillBand(section, index); })")
+fragments = ROOT.join("_includes/content-runtime/60-fragments.html").read
+fail!("home section markdown still runs in one turn") unless fragments.include?("function yieldToMain()") &&
+  fragments.include?("return yieldToMain().then(function () {")
+listing = ROOT.join("_includes/content-runtime/40-listing.html").read
+fail!("date formatting builds a new formatter per card") unless listing.include?("dateFormatters")
 
 marked = ROOT.join("_includes/content-runtime/00-config.html").read
 fail!("markdown library no longer defers") unless marked.include?("<script defer ")
@@ -67,6 +74,8 @@ fail!("probe ignores the project inventory") unless probe.include?("#home-projec
 fail!("probe ignores article cards") unless probe.include?("#home-articles .home-featured, #home-articles .ledger-card")
 fail!("probe ignores the phone viewport") unless probe.include?("name: 'mobile'")
 fail!("probe ignores the desktop viewport") unless probe.include?("name: 'desktop'")
+fail!("probe does not pin DevTools to IPv4") unless probe.include?("--remote-debugging-address=127.0.0.1")
+fail!("probe gives Chrome only a few seconds to open DevTools") unless probe.include?("attempt < 200")
 
 _out, err, status = Open3.capture3("node", "--check", ROOT.join("scripts/check_home_lists.mjs").to_s)
 fail!("home list probe is not valid JavaScript\n#{err}") unless status.success?

metadata

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