edgepress 2026.10.1 → 2026.10.13

package/src/page-blocks.js

@@ -1,7 +1,13 @@
+import {renderServiceBlock} from './service-block.js';
+import {renderLocalTool} from './local-tool.js';
+import {renderDocument} from './document.js';
+import {renderMediaViewer} from './media-viewer.js';
+import {renderEmbed, renderPageText} from './embed.js';
 import { renderMarkdownExcerpt } from './markdown.js';
-import { translate, translateValue } from './i18n.js';
+import { localizedContentUrl, translate, translateValue } from './i18n.js';
 import { isIconName, renderIcon } from './icons.js';
 import { postsForLocale } from './content.js';
+import { categoryFilter, filterPostsByCategory, categorySlug, sortPinnedPosts } from './post-details.js';
 
 const captchaProviders = new Set(['cloudflare-turnstile', 'google-recaptcha', 'hcaptcha']);
 
@@ -30,16 +36,7 @@ function safeUrl(value, label) {
 }
 
 function localizedSiteUrl(value, label, context) {
-  const url = safeUrl(value, label);
-  if (!url.startsWith('/')) return url;
-  const localeToken = /^\/\[launge\](?=\/|$)/i;
-  if (/\[launge\]/i.test(url) && !localeToken.test(url)) {
-    throw new Error(label + ' may use [launge] only as the first site-path segment');
-  }
-  if (!localeToken.test(url)) return url;
-  const suffix = url.replace(localeToken, '');
-  const prefix = context.locale === context.config.i18n.defaultLocale ? '' : '/' + context.locale;
-  return prefix + (suffix || '/');
+  return localizedContentUrl(context.config,context.locale,safeUrl(value,label),label);
 }
 
 function list(value, label, min = 1, max = 50) {
@@ -61,15 +58,14 @@ function imageCandidates(value, label) {
   }).join(', ');
 }
 
-function enabledIntegration(config, id, category) {
-  const section = config.browserPlugins[category];
-  const match = section?.enabled && section.services.find((item) => item.id === id);
-  if (!match) throw new Error('Page block requires a configured ' + category + ' service with id: ' + id);
+function enabledIntegration(config, id) {
+  const match = config.browserPlugins.services.find(item => item.enabled !== false && item.id === id);
+  if (!match) throw new Error('Page block requires a configured service with id: ' + id);
   return match;
 }
 
-function dateLabel(date, locale) {
-  return new Intl.DateTimeFormat(locale, { dateStyle: 'long', timeZone: 'UTC' }).format(date);
+function dateLabel(date, locale, timeZone = 'UTC', dateOnly = true) {
+  return new Intl.DateTimeFormat(locale, dateOnly?{dateStyle:'long',timeZone}:{year:'numeric',month:'long',day:'numeric',hour:'2-digit',minute:'2-digit',timeZoneName:'short',timeZone}).format(date);
 }
 
 function dateOnlyLabel(value, locale) {
@@ -77,21 +73,11 @@ function dateOnlyLabel(value, locale) {
 }
 
 function renderPrivacyServices(context) {
-  const groups = [
-    ['tracking', translate(context.config, context.locale, 'pluginTracking')],
-    ['statistics', translate(context.config, context.locale, 'pluginStatistics')],
-    ['advertising', translate(context.config, context.locale, 'pluginAdvertising')],
-    ['captcha', translate(context.config, context.locale, 'pluginCaptcha')]
-  ];
-  const configured = groups.flatMap(([key, label]) => {
-    const section = context.config.browserPlugins[key];
-    return (section?.enabled ? section.services : []).map((service) => ({ ...service, category: label }));
-  });
+  const configured = context.config.browserPlugins.services.filter(service => service.enabled !== false);
   if (!configured.length) {
-    return '<p class="privacy-empty">' + escapeHtml(text(context.emptyText, 'privacy-services.emptyText', 2000)) + '</p>';
+    return '<p class="privacy-services-empty">' + escapeHtml(text(context.emptyText, 'privacy-services.emptyText', 2000)) + '</p>';
   }
-  return '<ul class="privacy-service-list">' + configured.map((service) => '<li><h3>' + escapeHtml(service.category + ' · ' +
-    translateValue(context.config, context.locale, service.name || service.provider)) + '</h3><p><strong>' +
+  return '<ul class="privacy-service-list">' + configured.map((service) => '<li><h3>' + escapeHtml(translateValue(context.config, context.locale, service.name || service.provider)) + '</h3><p><strong>' +
     escapeHtml(translate(context.config, context.locale, 'servicePurpose')) + ':</strong> ' +
     escapeHtml(translateValue(context.config, context.locale, service.purpose)) + '</p><p><strong>' +
     escapeHtml(translate(context.config, context.locale, 'serviceDataCategories')) + ':</strong> ' +
@@ -109,23 +95,37 @@ async function renderLatestPosts(block, context) {
   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 = postsForLocale(context.site.posts, context.locale, context.config.i18n.defaultLocale);
+  if ('tag' in block) throw new Error('post-list.tag is no longer supported; use category/categories and show tags on article pages');
+  if ('category' in block && 'categories' in block) throw new Error('Use category or categories, not both');
+  const categories = categoryFilter(block.category ?? block.categories ?? (block.type === 'latest-posts' ? context.config.site?.archive?.categories : undefined));
+  const archiveCategories = categoryFilter(context.config.site?.archive?.categories);
+  const sameArchive = [...categories].sort().join('\0') === [...archiveCategories].sort().join('\0');
+  if (paginate && (block.type === 'post-list' || !sameArchive)) throw new Error('Homepage pagination must use the same categories as site.archive.categories');
+  const selected = filterPostsByCategory(postsForLocale(context.site.posts, context.locale, context.config.i18n.defaultLocale), categories);
+  const ordered = block.type === 'post-list' ? sortPinnedPosts(selected) : selected;
+  const posts = ordered.filter(post => !context.displayedPostBundles?.has(post.bundlePath));
+  const displayed = posts.slice(0, count);
+  for (const post of displayed) context.displayedPostBundles?.add(post.bundlePath);
   const title = escapeHtml(text(block.title, 'latest-posts.title', 200));
   const authorLabel = (post) => post.author ? '<span class="post-author">' + escapeHtml(translate(context.config, context.locale, 'postAuthor')
     .replace('{author}', post.author)) + '</span>' : '';
-  const cards = (await Promise.all(posts.slice(0, count).map(async (post) => {
-    const excerpt = await renderMarkdownExcerpt(post.description || post.markdown, context.config.markdown);
+  const cards = (await Promise.all(displayed.map(async (post) => {
+    const excerpt = await renderMarkdownExcerpt(post.description || post.markdown, {...context.config.markdown,linkResolver:value=>localizedContentUrl(context.config,post.locale,value)});
     return '<article class="post-card" lang="' + escapeHtml(post.locale) + '"><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>' + (post.author ? ' · ' + authorLabel(post) : '') + '</p><div class="post-excerpt" lang="' + escapeHtml(post.locale) + '">' + excerpt + '</div></article>';
+      escapeHtml(post.title) + '</a></h3>' + (block.type === 'post-list' && post.pinned ? '<span class="post-pinned">' + escapeHtml(translate(context.config, context.locale, 'postPinned')) + '</span>' : '') + '<p class="meta"><time data-local-time data-time-locale="' + escapeHtml(post.locale || context.locale) + '" data-date-only="' + (post.dateOnly === true) + '" datetime="' + (post.dateOnly ? post.date.toISOString().slice(0,10) : post.date.toISOString()) + '">' + escapeHtml(dateLabel(post.date, post.locale || context.locale, post.dateOnly ? 'UTC' : context.config.site.timeZone, post.dateOnly)) +
+      '</time>' + (post.author ? ' ' + authorLabel(post) : '') + '</p><div class="post-excerpt" lang="' + escapeHtml(post.locale) + '">' + excerpt + '</div></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>'
     : '';
+  const morePath = categories.length === 1 ? '/[launge]/categories/' + categorySlug(categories[0]) + '/' : sameArchive ? '/[launge]/archives/' : '';
+  const categoryArchive = !paginate && morePath && posts.length > count
+    ? '<p class="post-list-more"><a href="' + escapeHtml(localizedSiteUrl(morePath, 'post-list.categoryArchive', context)) + '">' +
+      escapeHtml(translate(context.config, context.locale, categories.length === 1 ? 'allCategoryPosts' : 'allPosts')) + '</a></p>' : '';
   return '<section class="latest-posts"><h2>' + title + '</h2>' +
-    (cards ? '<div class="post-list">' + cards + '</div>' : '<p>' + escapeHtml(translate(context.config, context.locale, 'noPosts')) + '</p>') + pagination + '</section>';
+    (cards ? '<div class="post-list">' + cards + '</div>' : '<p>' + escapeHtml(translate(context.config, context.locale, 'noPosts')) + '</p>') + pagination + categoryArchive + '</section>';
 }
 
 function renderMediaText(block, context) {
@@ -138,7 +138,15 @@ function renderMediaText(block, context) {
   if (!['left', 'right'].includes(placement)) throw new Error('media-text.placement must be left or right');
   let media;
   if (mediaType === 'image') {
-    media = '<img src="' + src + '" alt="' + alt + '" loading="lazy" decoding="async">';
+    const original=block.originalSrc?' data-original="'+escapeHtml(safeUrl(block.originalSrc,'media-text.originalSrc'))+'"':'';
+    media = '<img src="' + src + '"'+original+' alt="' + alt + '" loading="lazy" decoding="async">';
+    if (block.animationSrc) {
+      const animation = safeUrl(block.animationSrc, 'media-text.animationSrc');
+      if (!animation.startsWith('/') || !/\.(mp4|webm)$/i.test(animation)) throw new Error('media-text.animationSrc must be a local MP4 or WebM');
+      const title = escapeHtml(block.title || block.alt);
+      const seekName = 'edgepress-demo-seek-' + (context.demoCount = (context.demoCount || 0) + 1);
+      media = '<div class="project-demo" data-project-demo data-animation="' + escapeHtml(animation) + '" data-play="' + escapeHtml(translate(context.config, context.locale, 'demoPlay')) + '" data-resume="' + escapeHtml(translate(context.config, context.locale, 'demoResume')) + '" data-pause="' + escapeHtml(translate(context.config, context.locale, 'demoPause')) + '" data-replay="' + escapeHtml(translate(context.config, context.locale, 'demoReplay')) + '" data-loading="' + escapeHtml(translate(context.config, context.locale, 'demoLoading')) + '" data-error="' + escapeHtml(translate(context.config, context.locale, 'demoError')) + '"><div class="project-demo-media">' + media + '<video muted playsinline preload="none" hidden aria-label="' + title + '"></video></div><button type="button" data-demo-toggle aria-pressed="false" aria-label="' + escapeHtml(translate(context.config, context.locale, 'demoPlay')) + ': ' + title + '">' + escapeHtml(translate(context.config, context.locale, 'demoPlay')) + '</button><input name="' + seekName + '" class="project-demo-seek" data-demo-seek type="range" min="0" max="1" value="0" step="0.1" disabled aria-label="' + escapeHtml(translate(context.config, context.locale, 'demoSeek')) + ': ' + title + '"><span class="project-demo-time" data-demo-time>0:00 / 0:00</span><span class="project-demo-status" role="status"></span></div>';
+    }
   } else {
     if (!alt.trim()) throw new Error('media-text.alt must describe the video');
     const videoSrc = escapeHtml(safeUrl(block.src, 'media-text.src'));
@@ -166,11 +174,28 @@ async function renderBlock(block, context, depth, index) {
   if (depth > 4) throw new Error('Page block nesting may not exceed 4 levels');
   const type = text(block.type, 'block.type', 40);
   switch (type) {
+    case 'local-tool': return renderLocalTool(block, context);
+    case 'document': return renderDocument(block, context);
+    case 'media-viewer': return renderMediaViewer(block, context);
     case 'hero': {
       const heading = text(block.title, 'hero.title', 240);
       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 bannerSrc = block.bannerSrc === undefined ? '' : safeUrl(block.bannerSrc, 'hero.bannerSrc');
+      const bannerAlt = block.bannerAlt === undefined ? '' : text(block.bannerAlt, 'hero.bannerAlt', 500);
+      if (Boolean(bannerSrc) !== Boolean(bannerAlt)) throw new Error('hero.bannerSrc and hero.bannerAlt must be provided together');
+      const bannerSrcset = block.bannerSrcset === undefined ? '' : imageCandidates(block.bannerSrcset, 'hero.bannerSrcset');
+      if (bannerSrcset && !bannerSrc) throw new Error('hero.bannerSrcset requires hero.bannerSrc');
+      const bannerWebpSrcset = block.bannerWebpSrcset === undefined ? '' : imageCandidates(block.bannerWebpSrcset, 'hero.bannerWebpSrcset');
+      if (bannerWebpSrcset && !bannerSrc) throw new Error('hero.bannerWebpSrcset requires hero.bannerSrc');
+      const bannerSizes = escapeHtml(text(block.bannerSizes ?? '(max-width: 620px) 90vw, 680px', 'hero.bannerSizes', 200));
+      const bannerWidth = block.bannerWidth;
+      const bannerHeight = block.bannerHeight;
+      if (bannerSrc && (!Number.isInteger(bannerWidth) || bannerWidth < 1 || bannerWidth > 10000 ||
+          !Number.isInteger(bannerHeight) || bannerHeight < 1 || bannerHeight > 10000)) {
+        throw new Error('hero banner dimensions must be integers from 1 to 10000');
+      }
       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');
@@ -202,9 +227,14 @@ async function renderBlock(block, context, depth, index) {
         ? '<picture class="hero-mascot-picture"><source type="image/webp" srcset="' + mascotWebpSrcset + '" sizes="' + mascotSizes + '">' + mascotImage + '</picture>'
         : mascotImage;
       const aside = mascot || highlightPanel ? '<div class="hero-aside">' + mascot + highlightPanel + '</div>' : '';
-      return '<section class="hero-block' + (aside ? ' hero-block--split' : '') + '"><div class="hero-main">' +
+      const bannerImage = bannerSrc ? '<img class="hero-banner" src="' + escapeHtml(bannerSrc) + '" alt="' + escapeHtml(bannerAlt) +
+        '" width="' + bannerWidth + '" height="' + bannerHeight + '"' + (bannerSrcset ? ' srcset="' + bannerSrcset +
+        '" sizes="(max-width: 620px) calc(100vw - 32px), (max-width: 1168px) calc(100vw - 48px), 1120px"' : '') +
+        ' decoding="async" fetchpriority="high">' : '';
+      const banner = bannerWebpSrcset ? '<picture class="hero-banner-picture"><source type="image/webp" srcset="' + bannerWebpSrcset + '" sizes="' + bannerSizes + '">' + bannerImage + '</picture>' : bannerImage;
+      return '<section class="hero-block' + (aside ? ' hero-block--split' : '') + (banner ? ' hero-block--banner' : '') + '"><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>' + aside + '</section>';
+        (description ? '<p class="hero-copy">' + escapeHtml(description) + '</p>' : '') + action + '</div>' + aside + banner + '</section>';
     }
     case 'section': {
       const heading = text(block.title, 'section.title', 200, true);
@@ -242,7 +272,7 @@ async function renderBlock(block, context, depth, index) {
       let paragraphs = block.paragraphs;
       if (paragraphs === undefined && typeof block.text === 'string') paragraphs = block.text.split(/\n\s*\n/).filter(Boolean);
       if (!Array.isArray(paragraphs) || paragraphs.length < 1 || paragraphs.length > 30) throw new Error('text needs a text value or 1 to 30 paragraphs');
-      return '<div class="text-widget">' + paragraphs.map((paragraph) => '<p>' + escapeHtml(text(paragraph, 'text paragraph', 4000)) + '</p>').join('') + '</div>';
+      return '<div class="text-widget">' + (await Promise.all(paragraphs.map(paragraph => renderPageText(text(paragraph, 'text paragraph', 4000), context)))).join('') + '</div>';
     }
     case 'media-text': return renderMediaText(block, context);
     case 'display-text': {
@@ -289,7 +319,7 @@ async function renderBlock(block, context, depth, index) {
       const rows = list(block.rows, 'data-table.rows', 1, 100);
       const title = text(block.title, 'data-table.title', 200);
       for (const row of rows) if (!Array.isArray(row) || row.length !== headers.length) throw new Error('Each data-table row must match the number of headers');
-      return '<div class="table-widget"><table><caption>' + escapeHtml(title) + '</caption><thead><tr>' + headers.map((item) =>
+      return '<div class="table-widget" tabindex="0" role="region" aria-label="'+escapeHtml(title)+'"><table><caption>' + escapeHtml(title) + '</caption><thead><tr>' + headers.map((item) =>
         '<th scope="col">' + escapeHtml(text(item, 'data-table header', 200)) + '</th>').join('') + '</tr></thead><tbody>' +
         rows.map((row) => '<tr>' + row.map((cell) => '<td>' + escapeHtml(text(cell, 'data-table cell', 1000)) + '</td>').join('') + '</tr>').join('') +
         '</tbody></table></div>';
@@ -343,6 +373,22 @@ async function renderBlock(block, context, depth, index) {
         '</span><span class="privacy-controller-separator" aria-hidden="true">·</span><span><strong>' + contactLabel +
         ':</strong> ' + contactValue + '</span></p>';
     }
+    case 'link-directory': {
+      const items = list(block.items, 'link-directory.items', 1, 100);
+      const heading = text(block.title, 'link-directory.title', 200);
+      const entries = items.map((item) => {
+        const name = escapeHtml(text(item?.title, 'link-directory item title', 200));
+        const summary = escapeHtml(text(item?.text, 'link-directory item text', 1000, true));
+        const href = localizedSiteUrl(item?.url, 'link-directory item url', context);
+        const host = /^https?:\/\//i.test(href) ? new URL(href).host : '';
+        return '<li class="link-directory-entry"><a class="link-directory-link" href="' + escapeHtml(href) + '">' +
+          '<span class="link-directory-main"><strong class="link-directory-name">' + name + '</strong>' +
+          (summary ? '<span class="link-directory-summary">' + summary + '</span>' : '') + '</span>' +
+          '<span class="link-directory-destination" aria-hidden="true">' + (host ? '<span>' + escapeHtml(host) + '</span>' : '') +
+          '<span class="link-directory-arrow">↗</span></span></a></li>';
+      }).join('');
+      return '<section class="link-directory-section"><h2>' + escapeHtml(heading) + '</h2><ul class="link-directory-items" role="list">' + entries + '</ul></section>';
+    }
     case 'feature-grid': {
       const items = list(block.items, 'feature-grid.items', 1, 12);
       const heading = text(block.title, 'feature-grid.title', 200);
@@ -362,7 +408,11 @@ async function renderBlock(block, context, depth, index) {
       const src = safeUrl(block.src, 'image.src');
       const alt = text(block.alt, 'image.alt', 500);
       const caption = text(block.caption, 'image.caption', 500, true);
-      return '<figure class="image-block"><img src="' + escapeHtml(src) + '" alt="' + escapeHtml(alt) + '" loading="lazy" decoding="async">' +
+      const original=block.originalSrc?' data-original="'+escapeHtml(safeUrl(block.originalSrc,'image.originalSrc'))+'"':'';
+      const srcset = block.srcset === undefined ? '' : imageCandidates(block.srcset, 'image.srcset');
+      const responsive = srcset ? ' srcset="' + srcset + '" sizes="' + escapeHtml(text(block.sizes ?? '(max-width: 640px) calc(100vw - 32px), 560px', 'image.sizes', 200)) + '"' : '';
+      if (block.sizes !== undefined && !srcset) throw new Error('image.sizes requires image.srcset');
+      return '<figure class="image-block"><img src="' + escapeHtml(src) + '"'+original+responsive+' alt="' + escapeHtml(alt) + '" loading="lazy" decoding="async">' +
         (caption ? '<figcaption>' + escapeHtml(caption) + '</figcaption>' : '') + '</figure>';
     }
     case 'quote': {
@@ -384,14 +434,22 @@ async function renderBlock(block, context, depth, index) {
       return '<section class="faq-block"><h2>' + title + '</h2>' + items.map((item) => '<details><summary>' +
         escapeHtml(text(item?.question, 'faq.question', 500)) + '</summary><p>' + escapeHtml(text(item?.answer, 'faq.answer', 4000)) + '</p></details>').join('') + '</section>';
     }
+    case 'oembed': return renderEmbed(block, context);
+    case 'service': {
+      const id = text(block.integration, 'service.integration', 64);
+      if (context.servicesRendered.has(id)) throw new Error('A page may contain only one block per service');
+      context.servicesRendered.add(id);
+      return renderServiceBlock(context.document, context.locale, context.config, id, true);
+    }
+    case 'post-list':
     case 'latest-posts': return renderLatestPosts(block, context);
     case 'ad-slot': {
-      const integration = enabledIntegration(context.config, block.integration, 'advertising');
+      const integration = enabledIntegration(context.config, block.integration);
       return '<div class="ad-slot" data-edgepress-ad="' + escapeHtml(integration.id) + '" aria-label="' + escapeHtml(text(block.label, 'ad-slot.label', 120)) + '"></div>';
     }
     case 'captcha': {
       if (!captchaProviders.has(block.provider)) throw new Error('captcha.provider must be a supported consent-gated provider');
-      const integration = context.config.browserPlugins.captcha.enabled && context.config.browserPlugins.captcha.services.find((item) => item.provider === block.provider);
+      const integration = context.config.browserPlugins.services.find(item => item.enabled !== false && item.provider === block.provider);
       if (!integration) throw new Error('captcha block needs a configured consent-gated integration: ' + block.provider);
       const siteKey = integration.siteKey;
       return '<div class="captcha-block" data-edgepress-captcha="' + escapeHtml(block.provider) + '" data-sitekey="' + escapeHtml(siteKey) + '" aria-label="' + escapeHtml(text(block.label, 'captcha.label', 120)) + '"></div>';
@@ -406,28 +464,40 @@ async function renderElements(blocks, context, depth = 0) {
   for (let index = 0; index < blocks.length; index += 1) {
     context.blockCount = (context.blockCount || 0) + 1;
     if (context.blockCount > 200) throw new Error('A page may contain at most 200 blocks including nested blocks');
-    rendered.push(await renderBlock(blocks[index], context, depth, index));
+    try {
+      rendered.push(await renderBlock(blocks[index], context, depth, index));
+    } catch (error) {
+      throw new Error('elements[' + index + '] (element ' + (index + 1) + '): ' + error.message, {cause: error});
+    }
   }
   return rendered.join('\n');
 }
 
 export async function renderBlocks(rows, context) {
+  context = {...context, displayedPostBundles:new Set(), servicesRendered:new Set(), localToolIds:new Set(), blockCount:0, demoCount:0};
   if (!Array.isArray(rows) || rows.length > 100) throw new Error('Page layout needs an array of at most 100 rows');
   const rendered = [];
-  for (const row of rows) {
+  for (const [rowIndex, row] of rows.entries()) {
+    const rowLabel = 'blocks[' + rowIndex + '] (row ' + (rowIndex + 1) + ')';
     if (!row || typeof row !== 'object' || Array.isArray(row) || 'type' in row) {
-      throw new Error('Page layout rows start with a columns count; put element types inside cells');
+      throw new Error(rowLabel + ': Page layout rows start with a columns count; put element types inside cells');
     }
-    for (const key of Object.keys(row)) if (!['columns', 'cells'].includes(key)) throw new Error('Unsupported page row option: ' + key);
+    for (const key of Object.keys(row)) if (!['columns', 'cells'].includes(key)) throw new Error(rowLabel + ': Unsupported page row option: ' + key);
     const columns = row.columns;
-    if (!Number.isInteger(columns) || columns < 1 || columns > 4) throw new Error('Each page row needs a columns count from 1 to 4');
-    if (!Array.isArray(row.cells) || row.cells.length !== columns) throw new Error('Each row needs one cells entry per configured column');
+    if (!Number.isInteger(columns) || columns < 1 || columns > 4) throw new Error(rowLabel + ': Each page row needs a columns count from 1 to 4');
+    if (!Array.isArray(row.cells) || row.cells.length !== columns) throw new Error(rowLabel + ': Each row needs one cells entry per configured column (columns: ' + columns + '; cells: ' + (Array.isArray(row.cells) ? row.cells.length : 'not a list') + ')');
     context.blockCount = (context.blockCount || 0) + 1;
     if (context.blockCount > 200) throw new Error('A page may contain at most 200 blocks including nested blocks');
-    const cells = await Promise.all(row.cells.map(async (blocks, index) => {
-      if (!Array.isArray(blocks) || !blocks.length) throw new Error('Every page row cell needs at least one element block');
-      return '<div class="page-builder-cell" data-cell="' + (index + 1) + '">' + await renderElements(blocks, context, 1) + '</div>';
-    }));
+    const cells = [];
+    for (const [index,blocks] of row.cells.entries()) {
+      const cellLabel = rowLabel + '.cells[' + index + '] (cell ' + (index + 1) + ')';
+      if (!Array.isArray(blocks) || !blocks.length) throw new Error(cellLabel + ': Every page row cell needs at least one element block; use cells: [[{ type: text, text: "Hello" }]]');
+      try {
+        cells.push('<div class="page-builder-cell" data-cell="' + (index + 1) + '">' + await renderElements(blocks, context, 1) + '</div>');
+      } catch (error) {
+        throw new Error(cellLabel + ': ' + error.message, {cause: error});
+      }
+    }
     rendered.push('<div class="page-builder-row" data-columns="' + columns + '">' + cells.join('') + '</div>');
   }
   return rendered.join('\n');

package/src/page-check.js

@@ -1,7 +1,9 @@
-import { access, lstat, mkdir, readFile, readdir, realpath } from 'node:fs/promises';
-import { extname, isAbsolute, relative, resolve, sep } from 'node:path';
+import { access, lstat, readFile, readdir } from 'node:fs/promises';
+import { extname, relative, resolve, sep } from 'node:path';
 import { addVisualEvidence } from './report-visuals.js';
 import { renderMarkdown, renderMarkdownExcerpt } from './markdown.js';
+import { markdownFixture } from './markdown-fixture.js';
+import {reportDirectory} from './report-path.js';
 
 async function htmlFiles(directory) {
   let entries;
@@ -61,7 +63,7 @@ async function contentDocuments(output, config) {
   return documents;
 }
 
-async function markdownFeatureCoverage(root, files, sourceByFile) {
+export async function markdownFeatureCoverage() {
   const expected = [
     ['headings 2 through 6', /<h2\b[\s\S]*?<h3\b[\s\S]*?<h4\b[\s\S]*?<h5\b[\s\S]*?<h6\b/i],
     ['Setext heading syntax', /<h2\b[^>]*>Setext (?:heading level two|二级标题示例)<\/h2>/i],
@@ -72,11 +74,11 @@ async function markdownFeatureCoverage(root, files, sourceByFile) {
     ['inline and fenced code', /<code\b[\s\S]*?<\/code>[\s\S]*?<pre\b[\s\S]*?<code\b[^>]*class="language-js"/i],
     ['tilde-fenced and four-space-indented code', /class="language-text"[\s\S]*?<pre\b[^>]*><code[^>]*>const indented =/i],
     ['code spans containing a literal backtick', (html) => html.includes('<code>`</code>')],
-    ['escaped Markdown punctuation and character references', /\\\*[\s\S]*?&lt;[\s\S]*?&amp;/i],
+    ['escaped Markdown punctuation and character references', (html) => html.includes('<p>*escaped punctuation* &lt; &amp;</p>')],
     ['inline and reference links', /href="\/quick-start\/"/i],
     ['GFM automatic links', /href="https:\/\/www\.markdownguide\.org\//i],
     ['angle-bracket, www, and email automatic links', /href="https:\/\/commonmark\.org"[\s\S]*?href="http:\/\/www\.example\.com"[\s\S]*?href="mailto:team@example\.com"/i],
-    ['images with alternative text', /<img\b[^>]*src="\/edgepress-markdown-guide\.svg"[^>]*alt="[^"]+"/i],
+    ['images with alternative text', /<img\b[^>]*src="\/edgepress-markdown-guide\.png"[^>]*alt="[^"]+"/i],
     ['image-shaped video Markdown syntax documented', (html) => html.includes('field-recording.mp4')],
     ['nested lists with inline formatting', /<li>[\s\S]*?<strong\b[\s\S]*?<ol\b[\s\S]*?<li>/i],
     ['task lists with accessible status names', /markdown-task-status" role="img" aria-label="[^"]+"/i],
@@ -94,34 +96,26 @@ async function markdownFeatureCoverage(root, files, sourceByFile) {
   catch { unsafeVideoRejected = true; }
   const videoChecks = [
     ['image-shaped video syntax renders an accessible native player with deferred media',
-      /<video controls playsinline preload="none" aria-label="A kite crossing a field"><source src="https:\/\/media\.example\.org\/field-recording\.mp4" type="video\/mp4"/i.test(videoHtml)],
+      /<video\b(?=[^>]*\bcontrols\b)(?=[^>]*\bplaysinline\b)(?=[^>]*\bpreload="none")(?=[^>]*\baria-label="A kite crossing a field")[^>]*><source src="https:\/\/media\.example\.org\/field-recording\.mp4" type="video\/mp4"/i.test(videoHtml)],
     ['video title renders as a caption', /<figcaption>Wind test<\/figcaption>/i.test(videoHtml)],
     ['unsafe video URL is rejected', unsafeVideoRejected],
     ['post-list excerpt preserves inline Markdown formatting', /<strong>formatted<\/strong>[\s\S]*?<em>emphasis<\/em>[\s\S]*?<code>code<\/code>/i.test(excerptHtml)]
   ];
-  const guides = files.filter((file) => /markdown-syntax-guide\/index\.html$/i.test(file.replace(/\\/g, '/')));
-  const documents = guides.map((file) => {
-    const html = sourceByFile.get(file) || '';
-    const content = html.match(/<div class="post-content">([\s\S]*?)<\/div>/i)?.[1] || '';
-    const checks = [
-      ...expected.map(([feature, matcher]) => ({ feature, passed: typeof matcher === 'function' ? matcher(content) : matcher.test(content) })),
-      ...videoChecks.map(([feature, passed]) => ({ feature, passed }))
-    ];
-    return { path: relative(root, file).replace(/\\/g, '/'), checks, passed: checks.filter((item) => item.passed).length };
-  });
+  const content = await renderMarkdown(markdownFixture);
+  const checks = [
+    ...expected.map(([feature, matcher]) => ({ feature, passed: typeof matcher === 'function' ? matcher(content) : matcher.test(content) })),
+    ...videoChecks.map(([feature, passed]) => ({ feature, passed }))
+  ];
+  const documents = [{ path: 'Built-in renderer fixture (not published)', checks,
+    passed: checks.filter((item) => item.passed).length }];
   return {
-    status: guides.length && documents.every((document) => document.checks.every((item) => item.passed)) ? 'pass' : 'fail',
-    checks: (expected.length + videoChecks.length) * Math.max(1, guides.length),
+    status: checks.every((item) => item.passed) ? 'pass' : 'fail',
+    checks: checks.length,
     passed: documents.reduce((total, document) => total + document.passed, 0),
     documents
   };
 }
 
-function isInside(root, path) {
-  const rel = relative(root, path);
-  return rel !== '..' && !rel.startsWith('..' + sep) && !isAbsolute(rel);
-}
-
 async function resolveLocalLink(output, pageFile, href) {
   let url;
   try { url = new URL(href, 'https://edgepress.invalid/' + relative(output, pageFile).split(sep).join('/')); }
@@ -184,10 +178,7 @@ export async function checkPages(config) {
     pageIds.set(file, new Set([...html.matchAll(/\bid\s*=\s*["']([^"']+)["']/gi)].map((match) => match[1])));
     metrics.htmlBytes += Buffer.byteLength(html);
   }
-  const markdownRendering = await markdownFeatureCoverage(output, files, sourceByFile);
-  if (!markdownRendering.documents.length) {
-    addFinding('error', 'markdown-rendering', 'content/posts', 'The Markdown syntax guide post was not generated.');
-  }
+  const markdownRendering = await markdownFeatureCoverage();
   for (const document of markdownRendering.documents) {
     for (const check of document.checks.filter((item) => !item.passed)) {
       addFinding('error', 'markdown-rendering', document.path, 'Markdown syntax did not render: ' + check.feature + '.');
@@ -298,6 +289,8 @@ export async function checkPages(config) {
       try { managerScript = await readFile(managerAsset, 'utf8'); }
       catch { /* The missing manager is reported below. */ }
     }
+    const choiceAsset = all.find(file => /edgepress[\\/]plugins[\\/]consent[\\/]choices\.[a-f0-9]{16}\.js$/i.test(file));
+    const choicesScript = choiceAsset ? await readFile(choiceAsset, 'utf8') : '';
     const htmlWithConsent = files.filter((file) => {
       const html = sourceByFile.get(file) || '';
       return html.includes('edgepress-privacy-config') && /\/edgepress\/plugins\/consent\/manager\.[a-f0-9]{16}\.js/i.test(html);
@@ -309,7 +302,7 @@ export async function checkPages(config) {
       managerScript.includes('serviceRetention') && managerScript.includes('servicePrivacyDetails') &&
       managerScript.includes('integration.privacyUrl'));
     consentCheck('stored choices are tied to proposed and effective dates',
-      managerScript.includes('proposedDate: consent.proposedDate') && managerScript.includes('effectiveDate: consent.effectiveDate'));
+      managerScript.includes('makeChoice(') && /proposedDate:\s*consent\.proposedDate/.test(choicesScript) && /effectiveDate:\s*consent\.effectiveDate/.test(choicesScript));
     consentCheck('new visitors start with every optional service off', managerScript.includes('checkbox.checked = false'));
     consentCheck('accept and reject controls share the same component styling',
       /\.privacy-manager \.privacy-panel \.privacy-accept\s*,\s*\.privacy-manager \.privacy-panel \.privacy-reject\s*\{[^}]*background:[^}]*\}/.test(styles));
@@ -395,22 +388,15 @@ export async function checkPages(config) {
     hashedAssets,
     issues,
     scope: [
-      'Accessibility checks inspect generated HTML and CSS. They do not measure color contrast, screen-reader behavior, keyboard interactions in a browser, or dynamic vendor widgets.',
+      'Structural accessibility checks inspect generated HTML and CSS. Browser checks separately sample device emulation, the browser accessibility tree, and real Tab/Shift+Tab/Enter events when Chromium is available.',
       'Page layout is measured with the consent manager hidden. The consent manager has separate component checks and screenshots, so its size does not change the page-content overflow result.',
       'Agent-friendliness checks inspect metadata, structured data, internal links, robots.txt, sitemap.xml, and llms.txt. They do not guarantee crawler indexing or answer quality.',
       'This automated report is not a legal-compliance assessment or a substitute for manual review.',
-      'Screenshots capture generated local pages at desktop and mobile viewports. They do not replace manual keyboard, zoom, contrast, or assistive-technology review.'
+      'Headless phone/tablet profiles and accessibility-tree inspection are simulations, not physical devices or NVDA, Narrator, VoiceOver, or TalkBack. Keyboard sampling does not cover every possible interaction; manual zoom, contrast and assistive-technology review remain necessary.',
+      'Markdown self-checks render a built-in fixture in memory without publishing tutorial articles or requiring a posts directory.'
     ]
   };
-  const requestedDirectory = resolve(config.root, 'tools');
-  await mkdir(requestedDirectory, { recursive: true });
-  const directoryInfo = await lstat(requestedDirectory);
-  if (directoryInfo.isSymbolicLink() || !directoryInfo.isDirectory()) {
-    throw new Error('Page-check report directory must be a real directory: ' + requestedDirectory);
-  }
-  const root = await realpath(config.root);
-  const directory = await realpath(requestedDirectory);
-  if (!isInside(root, directory)) throw new Error('Page-check report directory must stay inside the project root');
+  const directory = await reportDirectory(config.root);
   const pdfPath = resolve(directory, 'page-check.pdf');
   try {
     const info = await lstat(pdfPath);
@@ -424,6 +410,10 @@ export async function checkPages(config) {
       issues.push({ severity: 'warning', category: 'visual-evidence', page: 'report', message: report.visualEvidence.reason || 'PDF generation failed.' });
     }
   } catch (error) {
+    if (report.browserChecks && report.browserChecks.status !== 'pass' && report.browserChecks.status !== 'fail') {
+      report.browserChecks.status = report.browserChecks.results.length ? 'incomplete' : 'unavailable';
+      report.browserChecks.reason = error.message;
+    }
     report.visualEvidence = { status: 'failed', reason: error.message };
     issues.push({ severity: 'warning', category: 'visual-evidence', page: 'report', message: 'Screenshot or PDF generation failed: ' + error.message });
   }

package/src/plugin-api.js

@@ -2,6 +2,9 @@ import { isAbsolute, relative, resolve, sep } from 'node:path';
 import { realpath } from 'node:fs/promises';
 import { pathToFileURL } from 'node:url';
 import { renderMarkdown } from './markdown.js';
+import {renderEmbed} from './embed.js';
+import {renderDocument} from './document.js';
+import {localizedContentUrl} from './i18n.js';
 
 export async function createExtensions(config) {
   const filters = new Map();
@@ -12,10 +15,13 @@ export async function createExtensions(config) {
     const selected = context.config.i18n.translationsByLocale?.[locale];
     return renderMarkdown(source, {
       ...context.config.markdown,
+      linkResolver:value=>localizedContentUrl(context.config,locale,value),
       taskLabels: {
         complete: selected?.markdownTaskComplete ?? base?.markdownTaskComplete ?? 'Task complete',
         incomplete: selected?.markdownTaskIncomplete ?? base?.markdownTaskIncomplete ?? 'Task incomplete'
-      }
+      },
+      embedRenderer: block => renderEmbed(block, {config: context.config, locale}),
+      documentRenderer: block => renderDocument(block, {config: context.config, locale})
     });
   }, cacheable: true }]]);
 

package/src/post-details.js

@@ -0,0 +1,60 @@
+import { plainText } from './markdown.js';
+
+export function normalizeCategory(value) {
+  if (value === undefined || value === null || value === '') return 'uncategorized';
+  if (typeof value !== 'string' || value.length > 120 || !value.trim()) throw new Error('category must be a short, non-empty string');
+  const category = value.trim().normalize('NFKC').toLowerCase();
+  if (['blog', '博客'].includes(category)) return 'blog';
+  if (['uncategorized', 'uncategorised', '未分类', '未分類'].includes(category)) return 'uncategorized';
+  return category;
+}
+
+export function categoryFilter(value) {
+  if (value === undefined) return [];
+  const values = typeof value === 'string' ? [value] : value;
+  if (!Array.isArray(values) || values.length > 20 || values.some(item => typeof item !== 'string' || !item.trim())) {
+    throw new Error('categories must be a category string or an array of at most 20 non-empty strings');
+  }
+  return [...new Set(values.map(normalizeCategory))];
+}
+
+export function filterPostsByCategory(posts, value) {
+  const categories = categoryFilter(value);
+  return categories.length ? posts.filter(post => categories.includes(normalizeCategory(post.category))) : posts;
+}
+
+export function categorySlug(value) {
+  const category = normalizeCategory(value);
+  if (/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(category)) return category;
+  return 'category-' + Array.from(category).map(char => char.codePointAt(0).toString(16)).join('-');
+}
+
+export function safeAvatar(value, label = 'author avatar') {
+  if (value === undefined || value === null || value === '') return '';
+  if (typeof value !== 'string' || value.length > 2048 || /[\x00-\x20\\]/.test(value) || value.startsWith('//')) {
+    throw new Error(label + ' must be a safe site path or HTTPS URL');
+  }
+  const url = new URL(value, 'https://edgepress.invalid');
+  if (url.protocol !== 'https:' || url.username || url.password || (!value.startsWith('/') && !value.startsWith('https://'))) {
+    throw new Error(label + ' must be a safe site path or HTTPS URL');
+  }
+  return value;
+}
+
+export function authorForPost(post, config) {
+  return { name: post.author || config.site.author?.name || config.site.seo?.author || '',
+    avatar: post.authorAvatar || config.site.author?.avatar || '' };
+}
+
+export function readingMinutes(markdown) {
+  const content = plainText(markdown);
+  const cjk = /[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Hangul}]/gu;
+  const characters = (content.match(cjk) || []).length;
+  const words = (content.replace(cjk, ' ').match(/[\p{L}\p{N}]+(?:['’][\p{L}\p{N}]+)*/gu) || []).length;
+  return Math.max(1, Math.ceil(characters / 300 + words / 200));
+}
+
+export function sortPinnedPosts(posts) {
+  return [...posts].sort((left,right) => Number(right.pinned === true) - Number(left.pinned === true) ||
+    right.date - left.date || left.bundlePath.localeCompare(right.bundlePath));
+}

package/src/post-template.js

@@ -0,0 +1,5 @@
+// The CLI writes the metadata. Authors can start with ordinary Markdown prose.
+export function postTemplate(title, date, locale, starter) {
+  return '---\ntitle: ' + JSON.stringify(title) + '\ndate: ' + date + '\nlang: ' + locale +
+    '\ncategory: uncategorized\ntags: []\n---\n\n' + starter + '\n';
+}