edgepress 2026.9.4 → 2026.9.6

package/project-compatibility.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "frameworkVersion": "2026.9.4",
+  "frameworkVersion": "2026.9.6",
   "requirements": {
     "nodeMajor": 22,
     "nodeMinimumVersion": "22.12.0",
@@ -24,7 +24,10 @@
     { "name": "Markdown syntax verification and responsive post screenshots", "stage": "experimental", "since": "2026.9.2" },
     { "name": "Compact localized language selector", "stage": "experimental", "since": "2026.9.2" },
     { "name": "npm theme installation and blank theme scaffolds", "stage": "experimental", "since": "2026.9.3" },
-    { "name": "PDF-only audit output and temporary screenshot capture", "stage": "experimental", "since": "2026.9.4" }
+    { "name": "PDF-only audit output and temporary screenshot capture", "stage": "experimental", "since": "2026.9.4" },
+    { "name": "Cloudflare one-click deployment guidance for existing and new projects", "stage": "stable", "since": "2026.9.5" },
+    { "name": "Localized Posts navigation and responsive code copy controls", "stage": "experimental", "since": "2026.9.6" },
+    { "name": "Linked tables of contents on Markdown post pages", "stage": "experimental", "since": "2026.9.6" }
   ],
   "releaseHistory": [
     {
@@ -50,6 +53,18 @@
       "date": "2026-09-25",
       "request": 4,
       "notes": "Keep audit output as a single accessible PDF with embedded screenshots, remove the templates directory and package archive, document Workers Builds initialization troubleshooting, and pin the Wrangler compatibility date to the first of the month."
+    },
+    {
+      "version": "2026.9.5",
+      "date": "2026-09-25",
+      "request": 5,
+      "notes": "Clarify that the Cloudflare one-click deployment button creates a new repository copy and Worker, explain unique naming and the path for updating existing Workers, and publish the guidance in README and bilingual quick-start pages."
+    },
+    {
+      "version": "2026.9.6",
+      "date": "2026-09-25",
+      "request": 6,
+      "notes": "Add a localized Posts link, accessible code-copy controls, responsive command wrapping, and linked post contents; refresh the bundled theme palettes and set the canonical site URL and author metadata."
     }
   ]
 }

package/src/cli.js

@@ -322,6 +322,11 @@ async function showReport(title, report, reportPath) {
   console.log('Report: ' + reportPath);
 }
 
+function showStatus(title, report) {
+  console.log(title + ': ' + report.status);
+  for (const issue of report.issues) console.log('- ' + issue.severity + ': ' + issue.message);
+}
+
 const [command, ...args] = process.argv.slice(2);
 try {
   const config = command === 'new' || command === 'clean' || command === 'check' || command === 'doctor' || command === 'iterate'
@@ -350,11 +355,11 @@ try {
     const pageReport = await checkPages(config);
     const compatibilityReport = await checkCompatibility(config);
     await showReport('Page check', pageReport, resolve(config.root, 'tools/page-check.pdf'));
-    await showReport('Compatibility check', compatibilityReport, resolve(config.resolvedPaths.cache, 'reports/compatibility.md'));
+    showStatus('Compatibility check', compatibilityReport);
     if (pageReport.errors || compatibilityReport.issues.some((issue) => issue.severity === 'error')) process.exitCode = 1;
   } else if (command === 'doctor') {
     const report = await checkCompatibility(config);
-    await showReport('Compatibility check', report, resolve(config.resolvedPaths.cache, 'reports/compatibility.md'));
+    showStatus('Compatibility check', report);
     if (report.issues.some((issue) => issue.severity === 'error')) process.exitCode = 1;
   } else if (command === 'iterate') {
     await buildSite(config.root);

package/src/content.js

@@ -47,6 +47,36 @@ function normalizeTags(value) {
   return (Array.isArray(value) ? value : [value]).map(String).map((tag) => tag.trim()).filter(Boolean);
 }
 
+function normalizeAuthor(value, file) {
+  if (value === undefined || value === null || value === '') return '';
+  if (typeof value !== 'string' || !value.trim() || value.length > 160) {
+    throw new Error('author must be a non-empty string of at most 160 characters in ' + file);
+  }
+  return value.trim();
+}
+
+function normalizeVideo(value, file) {
+  if (value === undefined) return null;
+  if (!value || typeof value !== 'object' || Array.isArray(value)) throw new Error('video must be an object in ' + file);
+  for (const key of Object.keys(value)) {
+    if (!['src', 'captions', 'captionLanguage', 'captionLabel', 'poster', 'alt', 'title', 'description'].includes(key)) {
+      throw new Error('Unsupported video field in ' + file + ': ' + key);
+    }
+  }
+  const localAsset = /^\/edgepress\/media\/[a-z0-9-]+\.(?:mp4|vtt|jpe?g)$/i;
+  for (const field of ['src', 'captions', 'poster']) {
+    if (typeof value[field] !== 'string' || !localAsset.test(value[field])) {
+      throw new Error('video.' + field + ' must reference a local /edgepress/media asset in ' + file);
+    }
+  }
+  if (typeof value.captionLanguage !== 'string' || !/^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/.test(value.captionLanguage) ||
+      typeof value.captionLabel !== 'string' || !value.captionLabel.trim() || typeof value.alt !== 'string' || !value.alt.trim() ||
+      typeof value.title !== 'string' || !value.title.trim() || typeof value.description !== 'string' || !value.description.trim()) {
+    throw new Error('video needs a language, labels, accessible description, title, and summary in ' + file);
+  }
+  return value;
+}
+
 function normalizeDate(value, filename, kind, file) {
   if (value instanceof Date) {
     if (!Number.isNaN(value.valueOf())) return value;
@@ -145,6 +175,9 @@ export async function readDocuments(config) {
     if (locale !== config.i18n.defaultLocale && metadata.homepage !== true) path = locale + '/' + path;
     return {
       kind, file, relativePath, title, slug, date, locale,
+      author: kind === 'posts' ? normalizeAuthor(metadata.author, file) : '',
+      videoId: (kind === 'posts' ? 'post-' : 'page-') + slugify(bundlePath + '-' + locale.toLowerCase()),
+      video: kind === 'posts' ? normalizeVideo(metadata.video, file) : null,
       tags: normalizeTags(metadata.tags),
       description: String(metadata.description ?? ''),
       keywords: normalizeTags(metadata.keywords),

package/src/generators.js

@@ -42,6 +42,51 @@ function urlPathForRoute(path) {
   return '/' + value;
 }
 
+function decodeHeadingEntities(value) {
+  return value.replace(/&(#x[\da-f]+|#\d+|amp|lt|gt|quot|apos|nbsp);/gi, (match, entity) => {
+    const named = { amp: '&', lt: '<', gt: '>', quot: '"', apos: "'", nbsp: ' ' };
+    if (entity[0] === '#') {
+      const hex = entity[1]?.toLowerCase() === 'x';
+      const point = Number.parseInt(entity.slice(hex ? 2 : 1), hex ? 16 : 10);
+      return Number.isFinite(point) && point > 0 && point <= 0x10ffff ? String.fromCodePoint(point) : match;
+    }
+    return named[entity.toLowerCase()] ?? match;
+  });
+}
+
+function addPostContents(html, locale, config) {
+  const headings = [];
+  const counts = new Map();
+  const content = html.replace(/<h([2-6])\b([^>]*)>([\s\S]*?)<\/h\1>/gi, (whole, levelText, attributes, inner) => {
+    const label = decodeHeadingEntities(inner.replace(/<[^>]*>/g, '').replace(/\s+/g, ' ').trim());
+    if (!label) return whole;
+    const base = slugify(label);
+    const count = (counts.get(base) || 0) + 1;
+    counts.set(base, count);
+    const id = count === 1 ? base : base + '-' + count;
+    headings.push({ id, label, level: Number(levelText) });
+    const safeAttributes = attributes.replace(/\s+id\s*=\s*(?:"[^"]*"|'[^']*'|[^\s>]+)/gi, '');
+    return '<h' + levelText + safeAttributes + ' id="' + escapeHtml(id) + '">' + inner + '</h' + levelText + '>';
+  });
+  if (!headings.length) return { html: content, toc: '' };
+  const items = headings.map((heading) => '<li class="post-toc-level-' + heading.level + '"><a href="#' +
+    escapeHtml(heading.id) + '">' + escapeHtml(heading.label) + '</a></li>').join('');
+  const contentsLabel = translate(config, locale, 'postContents');
+  const toc = '<nav class="post-toc" aria-label="' + escapeHtml(contentsLabel) + '"><h2 id="post-toc-title">' +
+    escapeHtml(contentsLabel) + '</h2><ol>' + items + '</ol></nav>';
+  return { html: content, toc };
+}
+
+function renderPostVideo(video, locale) {
+  if (!video) return '';
+  const videoTitle = escapeHtml(video.title);
+  return '<figure class="post-video"><video controls playsinline preload="metadata" poster="' + escapeHtml(video.poster) + '" aria-label="' +
+    escapeHtml(video.alt) + '"><source src="' + escapeHtml(video.src) + '" type="video/mp4"><track kind="captions" src="' +
+    escapeHtml(video.captions) + '" srclang="' + escapeHtml(video.captionLanguage) + '" label="' + escapeHtml(video.captionLabel) + '" default>' +
+    '<a href="' + escapeHtml(video.src) + '">' + (locale.toLowerCase().startsWith('zh') ? '下载 MP4 视频' : 'Download the MP4 video') +
+    '</a></video><figcaption><strong>' + videoTitle + '</strong><br>' + escapeHtml(video.description) + '</figcaption></figure>';
+}
+
 async function pageRoute(path, title, description, body, locale, config, extensions, metadata = {}) {
   const urlPath = metadata.urlPath || urlPathForRoute(path);
   const structuredData = metadata.structuredData ?? {
@@ -53,6 +98,7 @@ async function pageRoute(path, title, description, body, locale, config, extensi
     inLanguage: locale,
     isPartOf: config.site.url ? { '@type': 'WebSite', name: config.site.title, url: config.site.url } : undefined
   };
+  body = body.replace(/<pre\b/gi, '<pre data-copyable-code');
   let html = await renderLayout(config, extensions, {
     title,
     description,
@@ -69,21 +115,43 @@ async function pageRoute(path, title, description, body, locale, config, extensi
   return fileRoute(path, html);
 }
 
-function renderPostCard(post, locale) {
+function renderPostAuthor(post, locale, config) {
+  if (!post.author) return '';
+  return '<span class="post-author">' + escapeHtml(translate(config, locale, 'postAuthor').replace('{author}', post.author)) + '</span>';
+}
+
+function renderPostCard(post, locale, config) {
   const summary = post.description || plainText(post.markdown).slice(0, 220);
   return '<article class="post-card"><h2><a href="' + escapeHtml(urlFor(post.path)) + '">' + escapeHtml(post.title) + '</a></h2>' +
-    '<p class="meta"><time datetime="' + post.date.toISOString() + '">' + escapeHtml(dateLabel(post.date, locale)) + '</time></p><p>' +
+    '<p class="meta"><time datetime="' + post.date.toISOString() + '">' + escapeHtml(dateLabel(post.date, locale)) + '</time>' +
+    (post.author ? ' · ' + renderPostAuthor(post, locale, config) : '') + '</p><p>' +
     escapeHtml(summary) + '</p></article>';
 }
 
-async function pageBodyForDocument(page, site, config, locale, isHomepage = false) {
-  const content = await renderBlocks(page.blocks, { config, locale, site, isHomepage });
+async function pageBodyForDocument(page, site, config, locale, isHomepage = false, renderContext = {}) {
+  const content = await renderBlocks(page.blocks, { config, locale, site, isHomepage, ...renderContext });
   const firstElement = page.blocks[0]?.cells?.[0]?.[0];
   const needsTitle = !isHomepage || firstElement?.type !== 'hero';
   const title = needsTitle ? '<header class="page-title"><h1>' + escapeHtml(page.title) + '</h1></header>' : '';
   return '<article class="page-builder">' + title + content + '</article>';
 }
 
+function paginatedLatestPostsSize(page) {
+  function find(value) {
+    if (Array.isArray(value)) {
+      for (const item of value) {
+        const result = find(item);
+        if (result !== null) return result;
+      }
+      return null;
+    }
+    if (!value || typeof value !== 'object') return null;
+    if (value.type === 'latest-posts' && value.paginate === true) return value.count ?? 3;
+    return find(value.cells) ?? find(value.blocks);
+  }
+  return find(page?.blocks);
+}
+
 function homepageDocument(pages, locale, defaultLocale) {
   return pages.find((page) => page.homepage && page.locale === locale) ||
     pages.find((page) => page.homepage && page.locale === defaultLocale) || null;
@@ -104,13 +172,24 @@ export async function generateBuiltinRoutes(site, config, extensions) {
     const posts = site.posts.filter((post) => post.locale === locale).sort((a, b) => b.date - a.date);
     const pages = site.pages.filter((page) => page.locale === locale && !page.homepage);
     const homePage = homepageDocument(site.pages, locale, defaultLocale);
+    const latestPostsPageSize = paginatedLatestPostsSize(homePage);
+    if (latestPostsPageSize !== null && (!Number.isInteger(latestPostsPageSize) || latestPostsPageSize < 1 || latestPostsPageSize > 12)) {
+      throw new Error('A paginated latest-posts block must use a count from 1 to 12');
+    }
+    const homepagePosts = posts.length ? posts : site.posts.filter((post) => post.locale === defaultLocale).sort((a, b) => b.date - a.date);
+    const homepageArchivePages = latestPostsPageSize ? Math.ceil(homepagePosts.length / latestPostsPageSize) : 0;
     const prefix = locale === defaultLocale ? '' : locale + '/';
     const label = (key) => translate(config, locale, key);
     const localeHomeUrl = localizedUrl(config, locale, '');
     allPagePaths.add(localeHomeUrl);
 
     if (homePage) {
-      const body = await pageBodyForDocument(homePage, site, config, locale, true);
+      const latestPostsPagination = latestPostsPageSize ? {
+        totalPages: homepageArchivePages,
+        archiveUrl: localizedUrl(config, locale, 'archives/'),
+        olderUrl: localizedUrl(config, locale, 'archives/page/2/')
+      } : null;
+      const body = await pageBodyForDocument(homePage, site, config, locale, true, { latestPostsPagination });
       routes.push(await pageRoute(prefix + 'index.html', homePage.title, homePage.description || config.site.description,
         body, locale, config, extensions, {
           urlPath: localeHomeUrl,
@@ -131,7 +210,7 @@ export async function generateBuiltinRoutes(site, config, extensions) {
         const subset = posts.slice((pageNumber - 1) * config.pagination.perPage, pageNumber * config.pagination.perPage);
         const body = '<section class="intro"><h1>' + escapeHtml(config.site.title) + '</h1><p>' + escapeHtml(config.site.description) +
           '</p></section><section class="post-list" aria-label="' + escapeHtml(label('latestPosts')) + '">' +
-          (subset.length ? subset.map((post) => renderPostCard(post, locale)).join('') : '<p>' + escapeHtml(label('noPosts')) + '</p>') +
+          (subset.length ? subset.map((post) => renderPostCard(post, locale, config)).join('') : '<p>' + escapeHtml(label('noPosts')) + '</p>') +
           '</section>' + (pageNumber === 1 && pages.length ? '<section class="page-links"><h2>' + escapeHtml(label('pages')) + '</h2><ul>' +
             pages.map((page) => '<li><a href="' + escapeHtml(urlFor(page.path)) + '">' + escapeHtml(page.title) + '</a></li>').join('') + '</ul></section>' : '') +
           (totalPages > 1 ? '<nav class="pagination" aria-label="' + escapeHtml(label('pagination')) + '">' +
@@ -145,8 +224,10 @@ export async function generateBuiltinRoutes(site, config, extensions) {
 
     for (const post of posts) allPagePaths.add(urlFor(post.path));
     const postRoutes = await mapLimit(posts, config.concurrency, async (post) => {
+      const renderedMarkdown = addPostContents(post.html, locale, config);
       const body = '<article class="post"><header><h1>' + escapeHtml(post.title) + '</h1><p class="meta"><time datetime="' + post.date.toISOString() + '">' +
-        escapeHtml(dateLabel(post.date, locale)) + '</time></p></header><div class="post-content">' + post.html + '</div>' +
+        escapeHtml(dateLabel(post.date, locale)) + '</time>' + (post.author ? ' · ' + renderPostAuthor(post, locale, config) : '') +
+        '</p></header>' + renderPostVideo(post.video, locale) + renderedMarkdown.toc + '<div class="post-content">' + renderedMarkdown.html + '</div>' +
         (post.tags.length ? '<p class="tags">' + escapeHtml(label('tags')) + ': ' + post.tags.map((tag) => '<a href="' +
           escapeHtml(localizedUrl(config, locale, 'tags/' + tagSlug(tag) + '/')) + '">' + escapeHtml(tag) + '</a>').join(' ') + '</p>' : '') + '</article>';
       const canonicalPath = urlFor(post.path);
@@ -157,7 +238,7 @@ export async function generateBuiltinRoutes(site, config, extensions) {
             '@context': 'https://schema.org', '@type': 'BlogPosting', headline: post.title,
             description: post.description || plainText(post.markdown).slice(0, 160),
             datePublished: post.date.toISOString(), dateModified: post.date.toISOString(),
-            author: { '@type': 'Person', name: config.site.seo.author || config.site.title },
+            author: { '@type': 'Person', name: post.author || config.site.seo.author || config.site.title },
             mainEntityOfPage: config.site.url ? config.site.url + canonicalPath : undefined,
             inLanguage: locale
           }
@@ -176,9 +257,24 @@ export async function generateBuiltinRoutes(site, config, extensions) {
     routes.push(...pageRoutes);
 
     if (!homePage) allPagePaths.add(localizedUrl(config, locale, ''));
-    const archiveBody = '<section><h1>' + escapeHtml(label('archives')) + '</h1>' +
-      (posts.length ? posts.map((post) => renderPostCard(post, locale)).join('') : '<p>' + escapeHtml(label('noPosts')) + '</p>') + '</section>';
-    routes.push(await pageRoute(prefix + 'archives/index.html', label('archives'), label('allPosts'), archiveBody, locale, config, extensions));
+    const archivePageSize = latestPostsPageSize || config.pagination.perPage;
+    const archivePageCount = Math.max(1, Math.ceil(posts.length / archivePageSize));
+    for (let pageNumber = 1; pageNumber <= archivePageCount; pageNumber += 1) {
+      const subset = posts.slice((pageNumber - 1) * archivePageSize, pageNumber * archivePageSize);
+      const archiveUrl = pageNumber === 1 ? 'archives/' : 'archives/page/' + pageNumber + '/';
+      const pagination = archivePageCount > 1
+        ? '<nav class="pagination" aria-label="' + escapeHtml(label('pagination')) + '">' +
+          (pageNumber > 1 ? '<a rel="prev" href="' + escapeHtml(pageNumber === 2 ? localizedUrl(config, locale, 'archives/') :
+            localizedUrl(config, locale, 'archives/page/' + (pageNumber - 1) + '/')) + '">' + escapeHtml(label('newer')) + '</a>' : '') +
+          (pageNumber < archivePageCount ? '<a rel="next" href="' + escapeHtml(localizedUrl(config, locale, 'archives/page/' + (pageNumber + 1) + '/')) + '">' +
+            escapeHtml(label('older')) + '</a>' : '') + '</nav>' : '';
+      const archiveBody = '<section><h1>' + escapeHtml(label('archives')) + '</h1>' +
+        (subset.length ? subset.map((post) => renderPostCard(post, locale, config)).join('') : '<p>' + escapeHtml(label('noPosts')) + '</p>') + pagination + '</section>';
+      routes.push(await pageRoute(prefix + (pageNumber === 1 ? 'archives/index.html' : 'archives/page/' + pageNumber + '/index.html'),
+        pageNumber === 1 ? label('archives') : label('archives') + ' · ' + pageNumber, label('allPosts'), archiveBody, locale, config, extensions,
+        { urlPath: localizedUrl(config, locale, archiveUrl) }));
+      allPagePaths.add(localizedUrl(config, locale, archiveUrl));
+    }
 
     const tags = new Map();
     for (const post of posts) for (const tag of post.tags) {
@@ -188,14 +284,14 @@ export async function generateBuiltinRoutes(site, config, extensions) {
     }
     const tagRoutes = await mapLimit([...tags.entries()], config.concurrency, async ([slug, value]) => {
       const body = '<section><h1>' + escapeHtml(label('tag')) + ': ' + escapeHtml(value.label) + '</h1>' +
-        value.posts.map((post) => renderPostCard(post, locale)).join('') + '</section>';
+        value.posts.map((post) => renderPostCard(post, locale, config)).join('') + '</section>';
       return pageRoute(prefix + 'tags/' + slug + '/index.html', label('tag') + ': ' + value.label,
         label('tag') + ' ' + value.label, body, locale, config, extensions);
     });
     routes.push(...tagRoutes);
 
     const searchable = [
-      ...posts.map((post) => ({ title: post.title, date: post.date.toISOString(), url: urlFor(post.path), summary: post.description || plainText(post.markdown).slice(0, 220), content: plainText(post.markdown), type: 'post' })),
+      ...posts.map((post) => ({ title: post.title, author: post.author, date: post.date.toISOString(), url: urlFor(post.path), summary: post.description || plainText(post.markdown).slice(0, 220), content: plainText(post.markdown), type: 'post' })),
       ...pages.map((page) => ({ title: page.title, url: urlFor(page.path), summary: page.description || plainText(page.markdown).slice(0, 220), type: 'page' }))
     ];
     routes.push(fileRoute(prefix + 'search.json', JSON.stringify(searchable), 'application/json; charset=utf-8'));
@@ -213,7 +309,8 @@ export async function generateBuiltinRoutes(site, config, extensions) {
       locale, config, extensions));
 
     const base = config.site.url;
-    const entries = posts.slice(0, 20).map((post) => '<entry><title>' + escapeXml(post.title) + '</title><link href="' +
+    const entries = posts.slice(0, 20).map((post) => '<entry><title>' + escapeXml(post.title) + '</title>' +
+      (post.author ? '<author><name>' + escapeXml(post.author) + '</name></author>' : '') + '<link href="' +
       escapeXml(base + urlFor(post.path)) + '"/><id>' + escapeXml(base + urlFor(post.path)) + '</id><updated>' + post.date.toISOString() +
       '</updated><summary>' + escapeXml(post.description || plainText(post.markdown).slice(0, 220)) + '</summary></entry>').join('');
     routes.push(fileRoute(prefix + 'feed.xml', '<?xml version="1.0" encoding="utf-8"?><feed xmlns="http://www.w3.org/2005/Atom"><title>' +

package/src/icons.js

@@ -0,0 +1,16 @@
+const iconNames = new Set([
+  'home', 'book-open', 'rocket', 'newspaper', 'search', 'shield-check', 'rss', 'file-text',
+  'layers', 'code', 'puzzle', 'plug', 'cloud', 'palette', 'globe', 'help-circle', 'arrow-up-right',
+  'check-circle', 'layout-grid', 'terminal', 'settings', 'sparkles'
+]);
+
+export function isIconName(name) {
+  return typeof name === 'string' && iconNames.has(name);
+}
+
+export function renderIcon(name, className = 'icon') {
+  if (!isIconName(name)) throw new Error('Unsupported EdgePress icon: ' + String(name));
+  if (!/^[a-z][a-z0-9-]*$/.test(className)) throw new Error('Icon class must be a simple CSS identifier');
+  return '<svg class="' + className + '" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><use href="/edgepress/icons.svg#' +
+    name + '"></use></svg>';
+}

package/src/maintenance.js

@@ -17,29 +17,6 @@ function versionAtLeast(current, minimum) {
   return true;
 }
 
-function markdown(report) {
-  const lines = [
-    '# EdgePress compatibility report',
-    '',
-    'Status: **' + report.status + '**',
-    '',
-    'Node.js: ' + report.runtime.node,
-    'Minimum required Node.js: ' + report.requirements.nodeMinimumVersion,
-    'Workers compatibility date: ' + report.runtime.workersDate,
-    'Minimum required date: ' + report.requirements.minimumWorkersDate,
-    '',
-    '## Findings',
-    ''
-  ];
-  if (!report.issues.length) lines.push('No compatibility findings.');
-  for (const issue of report.issues) lines.push('- **' + issue.severity.toUpperCase() + '** ' + issue.message);
-  lines.push('', '## Feature lifecycle', '');
-  for (const feature of report.features) {
-    lines.push('- ' + feature.name + ': ' + feature.stage + ' (since ' + feature.since + ')');
-  }
-  return lines.join('\n');
-}
-
 export async function checkCompatibility(config) {
   const root = config.root;
   const manifest = await readJson(resolve(root, 'project-compatibility.json'));
@@ -77,10 +54,6 @@ export async function checkCompatibility(config) {
     features: manifest.features,
     issues
   };
-  const directory = resolve(config.resolvedPaths.cache, 'reports');
-  await mkdir(directory, { recursive: true });
-  await writeFile(resolve(directory, 'compatibility.json'), JSON.stringify(report, null, 2), 'utf8');
-  await writeFile(resolve(directory, 'compatibility.md'), markdown(report), 'utf8');
   return report;
 }
 

package/src/page-blocks.js

@@ -1,5 +1,6 @@
 import { plainText } from './markdown.js';
 import { translate } from './i18n.js';
+import { isIconName, renderIcon } from './icons.js';
 
 const captchaProviders = new Set(['cloudflare-turnstile', 'google-recaptcha', 'hcaptcha']);
 
@@ -65,14 +66,24 @@ function renderPrivacyServices(context) {
 function renderLatestPosts(block, context) {
   const count = block.count ?? 3;
   if (!Number.isInteger(count) || count < 1 || count > 12) throw new Error('latest-posts.count must be an integer from 1 to 12');
+  const paginate = block.paginate ?? false;
+  if (typeof paginate !== 'boolean') throw new Error('latest-posts.paginate must be a boolean');
   const posts = context.site.posts.filter((post) => post.locale === context.locale ||
-    (!context.site.posts.some((item) => item.locale === context.locale) && post.locale === context.config.i18n.defaultLocale)).slice(0, count);
+    (!context.site.posts.some((item) => item.locale === context.locale) && post.locale === context.config.i18n.defaultLocale))
+    .sort((a, b) => b.date - a.date);
   const title = escapeHtml(text(block.title, 'latest-posts.title', 200));
-  const cards = posts.map((post) => '<article class="post-card"><h3><a href="' + escapeHtml('/' + post.path.split('/').filter(Boolean).join('/') + (post.path.endsWith('/') ? '/' : '')) + '">' +
+  const authorLabel = (post) => post.author ? '<span class="post-author">' + escapeHtml(translate(context.config, context.locale, 'postAuthor')
+    .replace('{author}', post.author)) + '</span>' : '';
+  const cards = posts.slice(0, count).map((post) => '<article class="post-card"><h3><a href="' + escapeHtml('/' + post.path.split('/').filter(Boolean).join('/') + (post.path.endsWith('/') ? '/' : '')) + '">' +
     escapeHtml(post.title) + '</a></h3><p class="meta"><time datetime="' + post.date.toISOString() + '">' + escapeHtml(dateLabel(post.date, context.locale)) +
-    '</time></p><p>' + escapeHtml(post.description || plainText(post.markdown).slice(0, 220)) + '</p></article>').join('');
+    '</time>' + (post.author ? ' · ' + authorLabel(post) : '') + '</p><p>' + escapeHtml(post.description || plainText(post.markdown).slice(0, 220)) + '</p></article>').join('');
+  const pagination = paginate && context.latestPostsPagination?.totalPages > 1
+    ? '<nav class="pagination latest-posts-pagination" aria-label="' + escapeHtml(translate(context.config, context.locale, 'pagination')) + '">' +
+      '<a rel="next" href="' + escapeHtml(context.latestPostsPagination.olderUrl) + '">' + escapeHtml(translate(context.config, context.locale, 'older')) + '</a>' +
+      '<a href="' + escapeHtml(context.latestPostsPagination.archiveUrl) + '">' + escapeHtml(translate(context.config, context.locale, 'allPosts')) + '</a></nav>'
+    : '';
   return '<section class="latest-posts"><h2>' + title + '</h2>' +
-    (cards ? '<div class="post-list">' + cards + '</div>' : '<p>' + escapeHtml(translate(context.config, context.locale, 'noPosts')) + '</p>') + '</section>';
+    (cards ? '<div class="post-list">' + cards + '</div>' : '<p>' + escapeHtml(translate(context.config, context.locale, 'noPosts')) + '</p>') + pagination + '</section>';
 }
 
 function renderMediaText(block) {
@@ -88,12 +99,13 @@ function renderMediaText(block) {
     media = '<img src="' + src + '" alt="' + alt + '" loading="lazy" decoding="async">';
   } else {
     if (!alt.trim()) throw new Error('media-text.alt must describe the video');
+    const videoSrc = escapeHtml(safeUrl(block.src, 'media-text.src'));
     const captions = escapeHtml(safeUrl(block.captions, 'media-text.captions'));
     const language = escapeHtml(text(block.captionLanguage, 'media-text.captionLanguage', 24));
     if (!/^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/.test(language)) throw new Error('media-text.captionLanguage must be a language tag');
     const trackLabel = escapeHtml(text(block.captionLabel, 'media-text.captionLabel', 120));
     const poster = block.poster ? ' poster="' + escapeHtml(safeUrl(block.poster, 'media-text.poster')) + '"' : '';
-    media = '<video controls preload="none" aria-label="' + alt + '"' + poster + '><source src="' + src + '"><track kind="captions" src="' + captions + '" srclang="' + language + '" label="' + trackLabel + '" default></video>';
+    media = '<video controls playsinline preload="metadata" aria-label="' + alt + '"' + poster + '><source src="' + videoSrc + '" type="video/mp4"><track kind="captions" src="' + captions + '" srclang="' + language + '" label="' + trackLabel + '" default></video>';
   }
   const title = text(block.title, 'media-text.title', 240, true);
   const content = text(block.text, 'media-text.text', 2000);
@@ -117,6 +129,9 @@ async function renderBlock(block, context, depth, index) {
       const level = context.isHomepage && index === 0 ? 'h1' : 'h2';
       const eyebrow = text(block.eyebrow, 'hero.eyebrow', 120, true);
       const description = text(block.text, 'hero.text', 1000, true);
+      const mascotSrc = block.mascotSrc === undefined ? '' : safeUrl(block.mascotSrc, 'hero.mascotSrc');
+      const mascotAlt = block.mascotAlt === undefined ? '' : text(block.mascotAlt, 'hero.mascotAlt', 500);
+      if (Boolean(mascotSrc) !== Boolean(mascotAlt)) throw new Error('hero.mascotSrc and hero.mascotAlt must be provided together');
       let action = '';
       if (block.cta) {
         const label = escapeHtml(text(block.cta.label, 'hero.cta.label', 120));
@@ -126,9 +141,12 @@ async function renderBlock(block, context, depth, index) {
       const highlights = block.highlights === undefined ? [] : list(block.highlights, 'hero.highlights', 1, 4);
       const highlightPanel = highlights.length ? '<ul class="hero-highlights">' + highlights.map((item) => '<li>' +
         escapeHtml(text(item, 'hero highlight', 180)) + '</li>').join('') + '</ul>' : '';
-      return '<section class="hero-block' + (highlightPanel ? ' hero-block--split' : '') + '"><div class="hero-main">' +
+      const mascot = mascotSrc ? '<img class="hero-mascot" src="' + escapeHtml(mascotSrc) + '" alt="' +
+        escapeHtml(mascotAlt) + '" width="1222" height="1287" decoding="async">' : '';
+      const aside = mascot || highlightPanel ? '<div class="hero-aside">' + mascot + highlightPanel + '</div>' : '';
+      return '<section class="hero-block' + (aside ? ' hero-block--split' : '') + '"><div class="hero-main">' +
         (eyebrow ? '<p class="eyebrow">' + escapeHtml(eyebrow) + '</p>' : '') + '<' + level + '>' + escapeHtml(heading) + '</' + level + '>' +
-        (description ? '<p class="hero-copy">' + escapeHtml(description) + '</p>' : '') + action + '</div>' + highlightPanel + '</section>';
+        (description ? '<p class="hero-copy">' + escapeHtml(description) + '</p>' : '') + action + '</div>' + aside + '</section>';
     }
     case 'section': {
       const heading = text(block.title, 'section.title', 200, true);
@@ -269,7 +287,10 @@ async function renderBlock(block, context, depth, index) {
         const title = escapeHtml(text(item?.title, 'feature title', 200));
         const description = escapeHtml(text(item?.text, 'feature text', 1000, true));
         const href = item?.url ? safeUrl(item.url, 'feature.url') : '';
-        return '<article class="feature-card"><h3>' + (href ? '<a href="' + escapeHtml(href) + '">' + title + '</a>' : title) + '</h3>' +
+        const iconName = item?.icon === undefined ? '' : text(item.icon, 'feature icon', 40);
+        if (iconName && !isIconName(iconName)) throw new Error('Unsupported feature icon: ' + iconName);
+        const icon = iconName ? renderIcon(iconName, 'feature-icon') : '';
+        return '<article class="feature-card">' + icon + '<h3>' + (href ? '<a href="' + escapeHtml(href) + '">' + title + '</a>' : title) + '</h3>' +
           (description ? '<p>' + description + '</p>' : '') + '</article>';
       }).join('');
       return '<section class="feature-section"><h2>' + escapeHtml(heading) + '</h2><div class="feature-grid">' + cells + '</div></section>';

package/src/page-check.js

@@ -119,7 +119,12 @@ async function resolveLocalLink(output, pageFile, href) {
   else candidates.push(resolve(output, clean + '.html'), resolve(output, clean, 'index.html'));
   for (const candidate of candidates) {
     if (!candidate.startsWith(output + sep)) continue;
-    if (await exists(candidate)) return { file: candidate, fragment: url.hash.slice(1) };
+    if (await exists(candidate)) {
+      let fragment = url.hash.slice(1);
+      try { fragment = decodeURIComponent(fragment); }
+      catch { return { broken: true, target: href }; }
+      return { file: candidate, fragment };
+    }
   }
   return { broken: true, target: href };
 }

package/src/theme.js

@@ -1,6 +1,11 @@
 import { readFile, realpath } from 'node:fs/promises';
 import { relative, resolve, sep } from 'node:path';
 import { localePrefix, localizedUrl, translate } from './i18n.js';
+import { isIconName, renderIcon } from './icons.js';
+const defaultNavigationIcons = {
+  home: 'home', guides: 'book-open', 'quick-start': 'rocket', posts: 'newspaper',
+  search: 'search', privacy: 'shield-check', feed: 'rss'
+};
 
 function isInside(root, target) {
   const rel = relative(root, target);
@@ -27,7 +32,9 @@ function navigationItems(config, locale, items) {
           item.url === '@search' ? localizedUrl(config, locale, 'search/') :
           item.url.startsWith('/') ? localizedUrl(config, locale, item.url) : item.url;
     const label = item.labels?.[locale] ?? item.labels?.[config.i18n.defaultLocale] ?? translate(config, locale, item.key);
-    return '<a href="' + escapeHtml(path) + '">' + escapeHtml(label) + '</a>';
+    const iconName = item.icon || defaultNavigationIcons[item.key];
+    const icon = isIconName(iconName) ? renderIcon(iconName, 'navigation-icon') : '';
+    return '<a href="' + escapeHtml(path) + '">' + icon + escapeHtml(label) + '</a>';
   }).join('');
 }
 
@@ -157,5 +164,9 @@ export async function renderLayout(config, extensions, page, body) {
   const html = '<!doctype html>' + rendered;
   const filtered = await extensions.filter('html:afterLayout', html, context);
   if (typeof filtered !== 'string') throw new Error('html:afterLayout filters must return a string');
-  return filtered;
+  if (/src=["']\/edgepress\/code-copy\.js["']/i.test(filtered)) return filtered;
+  const codeCopyScript = '<script defer src="/edgepress/code-copy.js"></script>';
+  return /<\/body\s*>/i.test(filtered)
+    ? filtered.replace(/<\/body\s*>/i, codeCopyScript + '</body>')
+    : filtered + codeCopyScript;
 }

package/static/edgepress/brand/edgepress-mark.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 48 48" fill="none">
+  <rect width="48" height="48" rx="14" fill="#315E49"/>
+  <path d="M12 10.5a2 2 0 0 1 2-2h13.5L36 17v20.5a2 2 0 0 1-2 2H14a2 2 0 0 1-2-2z" fill="#FBF8EF"/>
+  <path d="M27.5 8.5V17H36" fill="#E98263"/>
+  <path d="M18 23h12m-12 6h12m-12 6h8" stroke="#315E49" stroke-width="2.6" stroke-linecap="round"/>
+  <path d="M27.5 8.5 36 17" stroke="#D6E4D8" stroke-width="1.2"/>
+</svg>

package/static/edgepress/brand/og-image.svg

@@ -0,0 +1,46 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="630" viewBox="0 0 1200 630">
+  <defs>
+    <linearGradient id="paper" x1="0" y1="0" x2="1" y2="1"><stop stop-color="#fbfaf5"/><stop offset="1" stop-color="#eee9dd"/></linearGradient>
+    <linearGradient id="field" x1="0" y1="0" x2="1" y2="1"><stop stop-color="#dfeae0"/><stop offset="1" stop-color="#c9ddcf"/></linearGradient>
+    <filter id="card-shadow" x="-20%" y="-20%" width="140%" height="150%"><feDropShadow dx="0" dy="16" stdDeviation="18" flood-color="#183729" flood-opacity=".12"/></filter>
+    <pattern id="dots" width="25" height="25" patternUnits="userSpaceOnUse"><circle cx="2" cy="2" r="1.4" fill="#8da891" opacity=".42"/></pattern>
+  </defs>
+  <rect width="1200" height="630" rx="28" fill="url(#paper)"/>
+  <circle cx="1100" cy="62" r="245" fill="#f1e5d3" opacity=".75"/>
+  <circle cx="964" cy="333" r="242" fill="url(#field)"/>
+  <circle cx="964" cy="333" r="217" fill="url(#dots)" opacity=".7"/>
+  <path d="M680 463c104-93 172-139 274-139s184 47 255 121" fill="none" stroke="#74937b" stroke-width="2" stroke-dasharray="4 10" opacity=".55"/>
+  <circle cx="703" cy="442" r="7" fill="#e98263"/>
+  <circle cx="1182" cy="442" r="7" fill="#315e49"/>
+  <g transform="translate(68 67)">
+    <rect width="52" height="52" rx="16" fill="#315e49"/>
+    <path d="M13 12a2 2 0 0 1 2-2h15l9 9v21a2 2 0 0 1-2 2H15a2 2 0 0 1-2-2z" fill="#fbf8ef"/>
+    <path d="M30 10v9h9" fill="#e98263"/>
+    <path d="M19 25h13m-13 6h13m-13 6h9" stroke="#315e49" stroke-width="2.5" stroke-linecap="round"/>
+    <text x="70" y="36" fill="#26382d" font-family="Inter,Segoe UI,Arial,sans-serif" font-size="28" font-weight="700" letter-spacing="-.7">EdgePress</text>
+  </g>
+  <g fill="#26382d" font-family="Inter,Segoe UI,Arial,sans-serif">
+    <text x="72" y="235" font-size="60" font-weight="750" letter-spacing="-2.7">Build for the edge.</text>
+    <text x="72" y="306" font-size="60" font-weight="750" letter-spacing="-2.7">Publish with clarity.</text>
+    <text x="75" y="365" fill="#64756a" font-size="23" font-weight="450">A thoughtful way to build a fast, flexible website.</text>
+    <text x="75" y="400" fill="#64756a" font-size="23" font-weight="450">Markdown, editable pages, themes, and Workers.</text>
+  </g>
+  <g filter="url(#card-shadow)">
+    <rect x="72" y="460" width="516" height="91" rx="18" fill="#fffdf8" stroke="#e1ddd3"/>
+    <path d="M102 487h24l9 9v28h-33z" fill="#dce9dd" stroke="#315e49" stroke-width="1.5" stroke-linejoin="round"/>
+    <path d="M126 487v9h9m-24 8h16m-16 7h16" fill="none" stroke="#315e49" stroke-width="1.7" stroke-linecap="round"/>
+    <text x="151" y="510" fill="#26382d" font-family="Inter,Segoe UI,Arial,sans-serif" font-size="17" font-weight="650">Open source. Built for publishing.</text>
+    <text x="151" y="532" fill="#748176" font-family="Inter,Segoe UI,Arial,sans-serif" font-size="14">Clear source in. A lightweight site out.</text>
+  </g>
+  <g transform="translate(950 55)">
+    <rect x="12" y="10" width="167" height="41" rx="20.5" fill="#fffdf8" stroke="#c7d7c9"/>
+    <circle cx="37" cy="30.5" r="5" fill="#e98263"/>
+    <text x="54" y="36" fill="#45634e" font-family="Inter,Segoe UI,Arial,sans-serif" font-size="13" font-weight="700" letter-spacing="1.4">PAGE BY PAGE</text>
+  </g>
+  <image href="mascot.png" x="755" y="72" width="430" height="478" preserveAspectRatio="xMidYMid meet"/>
+  <g transform="translate(936 557)">
+    <rect width="208" height="36" rx="18" fill="#315e49"/>
+    <text x="104" y="24" text-anchor="middle" fill="#fbf8ef" font-family="Inter,Segoe UI,Arial,sans-serif" font-size="12" font-weight="700" letter-spacing="1.5">PUBLISH WITH PURPOSE</text>
+  </g>
+  <path d="M1107 125c10-19 14-21 21-23-4 11-4 18-1 27-8-4-13-4-20-4Z" fill="#e98263"/>
+</svg>