@morphemecms/cms 0.5.0 → 0.7.0

package/site/icons.mjs

@@ -114,7 +114,9 @@ export const MATERIAL_SYMBOLS = {
   'book-open': 'import_contacts',
   'book-open-text': 'menu_book',
   browser: 'web',
+  'browser-fill': 'web-fill',
   buildings: 'domain',
+  'buildings-fill': 'domain-fill',
   bus: 'directions_bus',
   'calendar-blank': 'calendar_today',
   'calendar-check': 'event_available',
@@ -126,8 +128,11 @@ export const MATERIAL_SYMBOLS = {
   'caret-right': 'chevron_right',
   'caret-up': 'keyboard_arrow_up',
   certificate: 'license',
+  'certificate-fill': 'license-fill',
   'chart-line-up': 'monitoring',
+  'chart-line-up-fill': 'monitoring-fill',
   chats: 'forum',
+  'chats-fill': 'forum-fill',
   check: 'check',
   'check-circle': 'check_circle',
   circle: 'circle',
@@ -143,28 +148,33 @@ export const MATERIAL_SYMBOLS = {
   'currency-circle-dollar': 'paid',
   'cursor-click': 'ads_click',
   database: 'database',
-  desktop: 'desktop_windows',
   'device-mobile': 'mobile',
   'door-open': 'door_open',
   'download-simple': 'download',
   'envelope-simple': 'mail',
+  'envelope-simple-fill': 'mail-fill',
   eye: 'visibility',
   'eye-slash': 'visibility_off',
   'file-pdf': 'picture_as_pdf',
   'file-text': 'description',
+  'file-text-fill': 'description-fill',
   'file-video': 'video_file',
   'file-zip': 'folder_zip',
   'flower-lotus': 'spa',
   'folder-simple': 'folder',
+  'folder-simple-fill': 'folder-fill',
   funnel: 'filter_alt',
-  gauge: 'speed',
+  gauge: 'dashboard',
   gear: 'settings',
   globe: 'language',
+  'globe-simple': 'language',
+  'gear-six': 'settings',
   'graduation-cap': 'school',
   hammer: 'hardware',
   'hand-heart': 'volunteer_activism',
   handshake: 'handshake',
   heart: 'favorite',
+  'heart-fill': 'favorite-fill',
   house: 'home',
   'identification-card': 'id_card',
   image: 'image',
@@ -173,25 +183,31 @@ export const MATERIAL_SYMBOLS = {
   keyboard: 'keyboard',
   leaf: 'eco',
   lifebuoy: 'support',
+  layout: 'right_panel_open',
   lightbulb: 'lightbulb',
   'link-break': 'link_off',
   'link-simple': 'link',
   list: 'menu',
   'list-bullets': 'format_list_bulleted',
   'list-checks': 'checklist',
+  'list-checks-fill': 'checklist-fill',
   'list-numbers': 'format_list_numbered',
   'lock-simple': 'lock',
   'lock-simple-open': 'lock_open',
   'magnifying-glass': 'search',
+  'magnifying-glass-fill': 'search-fill',
   'map-pin': 'location_on',
   'map-trifold': 'map',
   medal: 'military_tech',
   megaphone: 'campaign',
+  'megaphone-fill': 'campaign-fill',
   minus: 'remove',
   money: 'payments',
   moon: 'dark_mode',
   newspaper: 'newspaper',
+  'newspaper-fill': 'newspaper-fill',
   'paint-brush-broad': 'brush',
+  'paint-brush-broad-fill': 'brush-fill',
   palette: 'palette',
   'paper-plane-tilt': 'send',
   'pencil-simple': 'edit',
@@ -200,6 +216,7 @@ export const MATERIAL_SYMBOLS = {
   plus: 'add',
   prohibit: 'block',
   'puzzle-piece': 'extension',
+  'puzzle-piece-fill': 'extension-fill',
   question: 'help',
   quotes: 'format_quote',
   receipt: 'receipt',
@@ -208,19 +225,26 @@ export const MATERIAL_SYMBOLS = {
   shapes: 'shapes',
   'share-network': 'share',
   'shield-check': 'verified_user',
-  'sidebar-simple': 'side_navigation',
+  'shield-check-fill': 'verified_user-fill',
+  sidebar: 'left_panel_close',
+  'sidebar-simple': 'left_panel_open',
   'sign-out': 'logout',
   signpost: 'signpost',
   'sliders-horizontal': 'tune',
   smiley: 'mood',
   sparkle: 'star_shine',
   square: 'square',
+  'square-half': 'right_panel_close',
   'square-half-bottom': 'call_to_action',
+  'square-half-bottom-fill': 'call_to_action-fill',
   'squares-four': 'grid_view',
+  'squares-four-fill': 'grid_view-fill',
   sticker: 'brand_family',
   storefront: 'storefront',
+  'storefront-fill': 'storefront-fill',
   sun: 'light_mode',
   tag: 'sell',
+  'tag-fill': 'sell-fill',
   'text-aa': 'match_case',
   'text-align-left': 'format_align_left',
   'text-b': 'format_bold',
@@ -231,10 +255,13 @@ export const MATERIAL_SYMBOLS = {
   'text-t': 'title',
   ticket: 'confirmation_number',
   'toggle-right': 'toggle_on',
+  'toggle-right-fill': 'toggle_on-fill',
   train: 'train',
   trash: 'delete',
+  'trash-fill': 'delete-fill',
   'upload-simple': 'upload',
   user: 'person',
+  'user-fill': 'person-fill',
   'user-circle': 'account_circle',
   users: 'group',
   'users-three': 'groups',
@@ -245,6 +272,7 @@ export const MATERIAL_SYMBOLS = {
   'wave-sine': 'animation',
   wheelchair: 'accessible',
   wrench: 'build',
+  'wrench-fill': 'build-fill',
   x: 'close',
 };
 
@@ -273,7 +301,9 @@ export const LUCIDE = {
   'book-open': 'book-open',
   'book-open-text': 'book-open-text',
   browser: 'panel-top',
+  'browser-fill': 'panel-top-fill',
   buildings: 'building-2',
+  'buildings-fill': 'building-2-fill',
   bus: 'bus',
   'calendar-blank': 'calendar',
   'calendar-check': 'calendar-check',
@@ -285,8 +315,11 @@ export const LUCIDE = {
   'caret-right': 'chevron-right',
   'caret-up': 'chevron-up',
   certificate: 'award',
+  'certificate-fill': 'award-fill',
   'chart-line-up': 'chart-line',
+  'chart-line-up-fill': 'chart-line-fill',
   chats: 'messages-square',
+  'chats-fill': 'messages-square-fill',
   check: 'check',
   'check-circle': 'circle-check',
   circle: 'circle',
@@ -302,29 +335,34 @@ export const LUCIDE = {
   'currency-circle-dollar': 'circle-dollar-sign',
   'cursor-click': 'mouse-pointer-click',
   database: 'database',
-  desktop: 'monitor',
   'device-mobile': 'smartphone',
   'door-open': 'door-open',
   'download-simple': 'download',
   'envelope-simple': 'mail',
+  'envelope-simple-fill': 'mail-fill',
   eye: 'eye',
   'eye-slash': 'eye-off',
   'file-pdf': 'file-text',
   'file-text': 'file-text',
+  'file-text-fill': 'file-text-fill',
   'file-video': 'file-video-camera',
   'file-zip': 'file-archive',
   'flower-lotus': 'flower-2',
   'folder-simple': 'folder',
+  'folder-simple-fill': 'folder-fill',
   funnel: 'funnel',
-  gauge: 'gauge',
+  gauge: 'layout-dashboard',
   gear: 'settings',
   globe: 'globe',
+  'globe-simple': 'globe',
+  'gear-six': 'settings',
   'graduation-cap': 'graduation-cap',
   hammer: 'hammer',
   'hand-heart': 'hand-heart',
   handshake: 'handshake',
   'hard-drives': 'server',
   heart: 'heart',
+  'heart-fill': 'heart-fill',
   house: 'house',
   'identification-card': 'id-card',
   image: 'image',
@@ -333,25 +371,31 @@ export const LUCIDE = {
   keyboard: 'keyboard',
   leaf: 'leaf',
   lifebuoy: 'life-buoy',
+  layout: 'panel-right-open',
   lightbulb: 'lightbulb',
   'link-break': 'unlink',
   'link-simple': 'link',
   list: 'menu',
   'list-bullets': 'list',
   'list-checks': 'list-checks',
+  'list-checks-fill': 'list-checks-fill',
   'list-numbers': 'list-ordered',
   'lock-simple': 'lock',
   'lock-simple-open': 'lock-open',
   'magnifying-glass': 'search',
+  'magnifying-glass-fill': 'search-fill',
   'map-pin': 'map-pin',
   'map-trifold': 'map',
   medal: 'medal',
   megaphone: 'megaphone',
+  'megaphone-fill': 'megaphone-fill',
   minus: 'minus',
   money: 'banknote',
   moon: 'moon',
   newspaper: 'newspaper',
+  'newspaper-fill': 'newspaper-fill',
   'paint-brush-broad': 'paintbrush',
+  'paint-brush-broad-fill': 'paintbrush-fill',
   palette: 'palette',
   'paper-plane-tilt': 'send',
   'pencil-simple': 'pencil',
@@ -360,6 +404,7 @@ export const LUCIDE = {
   plus: 'plus',
   prohibit: 'ban',
   'puzzle-piece': 'puzzle',
+  'puzzle-piece-fill': 'puzzle-fill',
   question: 'circle-question-mark',
   quotes: 'quote',
   receipt: 'receipt',
@@ -369,20 +414,27 @@ export const LUCIDE = {
   shapes: 'shapes',
   'share-network': 'share-2',
   'shield-check': 'shield-check',
-  'sidebar-simple': 'panel-left',
+  'shield-check-fill': 'shield-check-fill',
+  sidebar: 'panel-left-close',
+  'sidebar-simple': 'panel-left-open',
   'sign-out': 'log-out',
   signpost: 'signpost',
   'sliders-horizontal': 'sliders-horizontal',
   smiley: 'smile',
   sparkle: 'sparkle',
   square: 'square',
+  'square-half': 'panel-right-close',
   'square-half-bottom': 'panel-bottom',
+  'square-half-bottom-fill': 'panel-bottom-fill',
   'squares-four': 'layout-grid',
+  'squares-four-fill': 'layout-grid-fill',
   sticker: 'sticker',
   storefront: 'store',
+  'storefront-fill': 'store-fill',
   sun: 'sun',
   swatches: 'swatch-book',
   tag: 'tag',
+  'tag-fill': 'tag-fill',
   'text-aa': 'case-sensitive',
   'text-align-left': 'text-align-start',
   'text-b': 'bold',
@@ -393,10 +445,13 @@ export const LUCIDE = {
   'text-t': 'type',
   ticket: 'ticket',
   'toggle-right': 'toggle-right',
+  'toggle-right-fill': 'toggle-right-fill',
   train: 'train-front',
   trash: 'trash-2',
+  'trash-fill': 'trash-2-fill',
   'upload-simple': 'upload',
   user: 'user',
+  'user-fill': 'user-fill',
   'user-circle': 'circle-user',
   users: 'users',
   'users-three': 'users-round',
@@ -407,6 +462,7 @@ export const LUCIDE = {
   'wave-sine': 'spline',
   wheelchair: 'accessibility',
   wrench: 'wrench',
+  'wrench-fill': 'wrench-fill',
   x: 'x',
 };
 

package/site/images.mjs

@@ -23,7 +23,7 @@ export function responsive(src) {
 }
 
 // The sizes of a picture shown `scale` times wider than its box (cut to a format, crop.mjs), e.g.
-// "(min-width: 800px) 720px, calc(100vw - 40px)" twice as wide.
+// a list like "720px, calc(100vw - 40px)" twice as wide.
 const scaled = (sizes, scale) =>
   scale === 1
     ? sizes

package/site/live-diff.d.mts

@@ -0,0 +1,22 @@
+/**
+ * @param {object} o
+ * @param {string} o.siteUrl the live site, `https://<domain>`
+ * @param {string} o.cwd the repository
+ * @param {typeof globalThis.fetch} [o.fetch]
+ * @param {string} [o.branch] the branch being built (WORKERS_CI_BRANCH; undefined outside Cloudflare)
+ * @param {string} o.repoBranch the site's own branch (repo.branch in its config)
+ * @param {number} [o.gitTimeout] milliseconds a git call may take (default 60 s)
+ * @returns {Promise<{ paths: string[] | null, reason: string, live: string | null }>}
+ */
+export function changedSinceLive({ siteUrl, cwd, fetch, branch, repoBranch, gitTimeout }: {
+    siteUrl: string;
+    cwd: string;
+    fetch?: typeof globalThis.fetch | undefined;
+    branch?: string | undefined;
+    repoBranch: string;
+    gitTimeout?: number | undefined;
+}): Promise<{
+    paths: string[] | null;
+    reason: string;
+    live: string | null;
+}>;

package/site/live-diff.mjs

@@ -0,0 +1,98 @@
+// The files changed between the commit that is live (the site's /editor/version.json) and HEAD, for morpheme ci-build's
+// lane decision (lib/build-lane.mjs); every doubt gives no list and a reason. Exposes changedSinceLive. Depends on git
+// and fetch.
+import { execFileSync } from 'node:child_process';
+
+/** how long a git call may take; a fetch that stalls longer counts as failed, which gives the full lane. */
+const GIT_TIMEOUT = 60_000;
+
+/**
+ * Runs git in `cwd` and returns its stdout. Throws when git fails.
+ * @param {string} cwd
+ * @param {string[]} args
+ * @param {number} [timeout] milliseconds
+ * @returns {string}
+ */
+function git(cwd, args, timeout = GIT_TIMEOUT) {
+  return execFileSync('git', args, {
+    cwd,
+    encoding: 'utf8',
+    stdio: ['ignore', 'pipe', 'pipe'],
+    timeout,
+    env: { ...process.env, GIT_TERMINAL_PROMPT: '0' },
+  });
+}
+
+/**
+ * @param {object} o
+ * @param {string} o.siteUrl the live site, `https://<domain>`
+ * @param {string} o.cwd the repository
+ * @param {typeof globalThis.fetch} [o.fetch]
+ * @param {string} [o.branch] the branch being built (WORKERS_CI_BRANCH; undefined outside Cloudflare)
+ * @param {string} o.repoBranch the site's own branch (repo.branch in its config)
+ * @param {number} [o.gitTimeout] milliseconds a git call may take (default 60 s)
+ * @returns {Promise<{ paths: string[] | null, reason: string, live: string | null }>}
+ */
+export async function changedSinceLive({ siteUrl, cwd, fetch = globalThis.fetch, branch, repoBranch, gitTimeout }) {
+  if (branch && branch !== repoBranch) {
+    return { paths: null, reason: 'branch preview', live: null };
+  }
+
+  let live;
+  try {
+    const res = await fetch(siteUrl + '/editor/version.json', { signal: AbortSignal.timeout(5000) });
+    if (res.status !== 200) {
+      return { paths: null, reason: 'live commit unknown', live: null };
+    }
+    const body = await res.json();
+    live = body?.commit;
+    if (typeof live !== 'string' || !/^[0-9a-f]{40}$/.test(live)) {
+      return { paths: null, reason: 'live commit unknown', live: null };
+    }
+  } catch {
+    return { paths: null, reason: 'live commit unknown', live: null };
+  }
+
+  try {
+    git(cwd, ['cat-file', '-e', live + '^{commit}']);
+  } catch {
+    try {
+      git(cwd, ['fetch', '--deepen=50', 'origin'], gitTimeout);
+    } catch {
+      // ignored: the retry below decides
+    }
+    try {
+      git(cwd, ['cat-file', '-e', live + '^{commit}']);
+    } catch {
+      return { paths: null, reason: 'live commit not in history', live };
+    }
+  }
+
+  try {
+    git(cwd, ['merge-base', '--is-ancestor', live, 'HEAD']);
+  } catch {
+    return { paths: null, reason: 'live commit not an ancestor of HEAD', live };
+  }
+
+  // The build runs on the working tree, so tracked changes that are not committed are code the diff cannot see.
+  if (git(cwd, ['status', '--porcelain', '--untracked-files=no']).trim().length > 0) {
+    return { paths: null, reason: 'uncommitted changes in the working tree', live };
+  }
+
+  // --no-renames lists both sides of a rename (else a code file moved into a content folder shows only its new path), -z and
+  // core.quotePath=false keep every path as it is, and diff.relative=false lists changes outside the working directory too.
+  const out = git(cwd, [
+    '-c',
+    'core.quotePath=false',
+    '-c',
+    'diff.relative=false',
+    'diff',
+    '--no-renames',
+    '--name-only',
+    '-z',
+    live,
+    'HEAD',
+  ]);
+  const paths = out.split('\0').filter((line) => line.length > 0);
+  return { paths, reason: 'diff against ' + live.slice(0, 7), live };
+}

package/site/live-diff.test.mjs

@@ -0,0 +1,235 @@
+// Tests for site/live-diff.mjs: the files changed since the live commit, in a temporary git repository with the variables that
+// point git at a repository removed (scripts/git-env.mjs) so no test touches the real one. Run: node --test packages/editor/site/*.test.mjs
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { execFileSync } from 'node:child_process';
+import { mkdtempSync, mkdirSync, writeFileSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join, dirname } from 'node:path';
+import { clearRepoEnv } from '../scripts/git-env.mjs';
+import { changedSinceLive } from './live-diff.mjs';
+
+// git sets GIT_DIR and friends for hooks (the pre-push hook runs these tests), and they would point every git call here at the real repository.
+clearRepoEnv();
+
+function repo() {
+  const dir = mkdtempSync(join(tmpdir(), 'live-diff-'));
+  execFileSync('git', ['init', '-q', '-b', 'main'], { cwd: dir, encoding: 'utf8' });
+  return dir;
+}
+
+function git(dir, ...args) {
+  return execFileSync('git', ['-c', 'user.name=Test', '-c', 'user.email=test@example.com', ...args], {
+    cwd: dir,
+    encoding: 'utf8',
+  }).trim();
+}
+
+function commit(dir, file, text) {
+  mkdirSync(dirname(join(dir, file)), { recursive: true });
+  writeFileSync(join(dir, file), text);
+  git(dir, 'add', '-A');
+  git(dir, 'commit', '-q', '-m', file);
+  return git(dir, 'rev-parse', 'HEAD');
+}
+
+const serve = (body) => async () => ({ status: 200, json: async () => body });
+
+const site = { siteUrl: 'https://example.com', repoBranch: 'main' };
+
+test('lists the files changed since the live commit', async () => {
+  const dir = repo();
+  try {
+    const a = commit(dir, 'README.md', 'x');
+    commit(dir, 'src/content/a.md', 'y');
+    const result = await changedSinceLive({ ...site, cwd: dir, fetch: serve({ commit: a }) });
+    assert.deepEqual(result.paths, ['src/content/a.md']);
+    assert.equal(result.live, a);
+    assert.equal(result.reason, 'diff against ' + a.slice(0, 7));
+  } finally {
+    rmSync(dir, { recursive: true, force: true });
+  }
+});
+
+test('a code commit that was never built is still listed', async () => {
+  const dir = repo();
+  try {
+    const a = commit(dir, 'README.md', 'x');
+    commit(dir, 'packages/editor/src/ui.tsx', 'code');
+    commit(dir, 'src/content/a.md', 'y');
+    const result = await changedSinceLive({ ...site, cwd: dir, fetch: serve({ commit: a }) });
+    assert.deepEqual(result.paths, ['packages/editor/src/ui.tsx', 'src/content/a.md']);
+  } finally {
+    rmSync(dir, { recursive: true, force: true });
+  }
+});
+
+test('an unreachable site gives no list', async () => {
+  const dir = repo();
+  try {
+    commit(dir, 'README.md', 'x');
+    const result = await changedSinceLive({
+      ...site,
+      cwd: dir,
+      fetch: async () => {
+        throw new Error('offline');
+      },
+    });
+    assert.deepEqual(result, { paths: null, reason: 'live commit unknown', live: null });
+  } finally {
+    rmSync(dir, { recursive: true, force: true });
+  }
+});
+
+test('a malformed commit gives no list', async () => {
+  const dir = repo();
+  try {
+    commit(dir, 'README.md', 'x');
+    const result = await changedSinceLive({ ...site, cwd: dir, fetch: serve({ commit: 'nope' }) });
+    assert.equal(result.reason, 'live commit unknown');
+    assert.equal(result.paths, null);
+  } finally {
+    rmSync(dir, { recursive: true, force: true });
+  }
+});
+
+test('a commit the repository does not have gives no list', async () => {
+  const dir = repo();
+  try {
+    commit(dir, 'README.md', 'x');
+    const result = await changedSinceLive({ ...site, cwd: dir, fetch: serve({ commit: 'a'.repeat(40) }) });
+    assert.equal(result.paths, null);
+    assert.equal(result.reason, 'live commit not in history');
+    assert.equal(result.live, 'a'.repeat(40));
+  } finally {
+    rmSync(dir, { recursive: true, force: true });
+  }
+});
+
+test('a live commit off the branch gives no list', async () => {
+  const dir = repo();
+  try {
+    commit(dir, 'README.md', 'x');
+    git(dir, 'checkout', '-q', '-b', 'side');
+    const side = commit(dir, 'side.md', 's');
+    git(dir, 'checkout', '-q', 'main');
+    commit(dir, 'src/content/a.md', 'y');
+    const result = await changedSinceLive({ ...site, cwd: dir, fetch: serve({ commit: side }) });
+    assert.equal(result.paths, null);
+    assert.equal(result.reason, 'live commit not an ancestor of HEAD');
+  } finally {
+    rmSync(dir, { recursive: true, force: true });
+  }
+});
+
+test('a branch preview gives no list and does not ask the site', async () => {
+  const dir = repo();
+  try {
+    commit(dir, 'README.md', 'x');
+    let asked = false;
+    const result = await changedSinceLive({
+      ...site,
+      cwd: dir,
+      branch: 'feature-x',
+      fetch: async () => {
+        asked = true;
+        throw new Error('asked');
+      },
+    });
+    assert.deepEqual(result, { paths: null, reason: 'branch preview', live: null });
+    assert.equal(asked, false);
+  } finally {
+    rmSync(dir, { recursive: true, force: true });
+  }
+});
+
+test('the live commit is HEAD: nothing changed', async () => {
+  const dir = repo();
+  try {
+    const a = commit(dir, 'README.md', 'x');
+    const result = await changedSinceLive({ ...site, cwd: dir, fetch: serve({ commit: a }) });
+    assert.deepEqual(result.paths, []);
+  } finally {
+    rmSync(dir, { recursive: true, force: true });
+  }
+});
+
+test('a code file renamed into src/content/ lists the old path too', async () => {
+  const dir = repo();
+  try {
+    const a = commit(dir, 'src/site/config.ts', 'export const config = {};\n'.repeat(20));
+    mkdirSync(join(dir, 'src/content'), { recursive: true });
+    git(dir, 'mv', 'src/site/config.ts', 'src/content/config.ts');
+    git(dir, 'commit', '-q', '-m', 'move');
+    const result = await changedSinceLive({ ...site, cwd: dir, fetch: serve({ commit: a }) });
+    assert.deepEqual([...result.paths].sort(), ['src/content/config.ts', 'src/site/config.ts']);
+  } finally {
+    rmSync(dir, { recursive: true, force: true });
+  }
+});
+
+test('a path with non-ASCII letters or spaces is listed as it is', async () => {
+  const dir = repo();
+  try {
+    const a = commit(dir, 'README.md', 'x');
+    commit(dir, 'src/content/blå post.md', 'y');
+    const result = await changedSinceLive({ ...site, cwd: dir, fetch: serve({ commit: a }) });
+    assert.deepEqual(result.paths, ['src/content/blå post.md']);
+  } finally {
+    rmSync(dir, { recursive: true, force: true });
+  }
+});
+
+test('an uncommitted change to a tracked file gives no list', async () => {
+  const dir = repo();
+  try {
+    const a = commit(dir, 'src/site/config.ts', 'x');
+    commit(dir, 'src/content/a.md', 'y');
+    writeFileSync(join(dir, 'src/site/config.ts'), 'edited');
+    const result = await changedSinceLive({ ...site, cwd: dir, fetch: serve({ commit: a }) });
+    assert.equal(result.paths, null);
+    assert.equal(result.reason, 'uncommitted changes in the working tree');
+  } finally {
+    rmSync(dir, { recursive: true, force: true });
+  }
+});
+
+test('an untracked file does not count as an uncommitted change', async () => {
+  const dir = repo();
+  try {
+    const a = commit(dir, 'README.md', 'x');
+    commit(dir, 'src/content/a.md', 'y');
+    writeFileSync(join(dir, 'dist.txt'), 'build output');
+    const result = await changedSinceLive({ ...site, cwd: dir, fetch: serve({ commit: a }) });
+    assert.deepEqual(result.paths, ['src/content/a.md']);
+  } finally {
+    rmSync(dir, { recursive: true, force: true });
+  }
+});
+
+test('a fetch that stalls past the timeout gives the full lane', async () => {
+  const dir = repo();
+  try {
+    commit(dir, 'README.md', 'x');
+    // an origin whose transport never answers
+    git(dir, 'config', 'protocol.ext.allow', 'always');
+    git(dir, 'remote', 'add', 'origin', 'ext::node -e setTimeout(()=>{},1500)');
+    const started = Date.now();
+    const result = await changedSinceLive({
+      ...site,
+      cwd: dir,
+      gitTimeout: 300,
+      fetch: serve({ commit: 'a'.repeat(40) }),
+    });
+    assert.equal(result.paths, null);
+    assert.equal(result.reason, 'live commit not in history');
+    assert.ok(Date.now() - started < 1400, 'the stalled fetch was cut off');
+  } finally {
+    // the stalled transport process may still hold the directory (Windows); the temp dir is then left to the OS
+    try {
+      rmSync(dir, { recursive: true, force: true });
+    } catch {
+      // best effort
+    }
+  }
+});

package/site/materialSymbols.d.mts

@@ -0,0 +1,5 @@
+/** The module's source: `{ '/node_modules/@material-symbols/svg-400/outlined/<name>.svg': '<svg …>' }`, the keys as
+ * import.meta.glob names them (src/materialIcons.ts). With `ssr` false: an empty object. */
+export function materialSsrModule(ssr: any): string;
+/** The virtual module's id as imported (packages/editor/src/icon.tsx). */
+export const MATERIAL_SSR: "virtual:material-symbols-ssr";