edgepress 2026.10.1 → 2026.10.13

package/src/theme.js

@@ -18,23 +18,36 @@ function escapeHtml(value) {
   })[char]);
 }
 
-function navigationItems(config, locale, items) {
+function navigationItems(config, locale, items, currentPath = '', scope = 'primary') {
   const values = items.length ? items : [
     { key: 'home', url: '@home' },
     { key: 'archives', url: '@archives' },
     { key: 'search', url: '@search' },
     { key: 'feed', url: '@feed' }
   ];
-  return values.map((item) => {
+  return values.map((item, index) => {
     const path = item.url === '@home' ? localizedUrl(config, locale, '') :
       item.url === '@archives' ? localizedUrl(config, locale, 'archives/') :
-        item.url === '@feed' ? localizedUrl(config, locale, 'feed.xml') :
+        item.url === '@feed' ? localizedUrl(config, locale, 'rss.xml') :
           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);
     const iconName = item.icon || defaultNavigationIcons[item.key];
     const icon = isIconName(iconName) ? renderIcon(iconName, 'navigation-icon') : '';
-    return '<a href="' + escapeHtml(path) + '">' + icon + escapeHtml(label) + '</a>';
+    const attributes = item.target === '_blank' ? ' target="_blank" rel="noopener noreferrer"' : '';
+    if (item.children?.length) {
+      const choices = [{ path, label, target:item.target }, ...item.children.map(child => ({
+        path: child.url === '@home' ? localizedUrl(config, locale, '') : child.url === '@archives' ? localizedUrl(config, locale, 'archives/') :
+          child.url === '@feed' ? localizedUrl(config, locale, 'rss.xml') : child.url === '@search' ? localizedUrl(config, locale, 'search/') :
+          child.url.startsWith('/') ? localizedUrl(config, locale, child.url) : child.url,
+        label: child.labels?.[locale] ?? child.labels?.[config.i18n.defaultLocale] ?? translate(config, locale, child.key), target:child.target
+      }))];
+      return '<span class="navigation-select" hidden>' + icon + '<select name="edgepress-navigation-' + scope + '-' + index + '" data-navigation-select aria-label="' + escapeHtml(label) + '">' +
+        '<option value="" selected disabled hidden>' + escapeHtml(label) + '</option>' +
+        choices.map(choice => '<option value="' + escapeHtml(choice.path) + '"'+(choice.target==='_blank'?' data-target="_blank"':'')+'>' + escapeHtml(choice.label) + '</option>').join('') +
+        '</select></span><noscript>' + choices.map(choice => '<a href="' + escapeHtml(choice.path) + '"'+(choice.target==='_blank'?' target="_blank" rel="noopener noreferrer"':'')+'>' + escapeHtml(choice.label) + '</a>').join('') + '</noscript>';
+    }
+    return '<a href="' + escapeHtml(path) + '"'+attributes+'>' + icon + escapeHtml(label) + '</a>';
   }).join('');
 }
 
@@ -97,7 +110,8 @@ export async function renderLayout(config, extensions, page, body) {
   const title = page.title ? page.title + config.site.head.titleSeparator + titleSuffix : titleSuffix;
   const robots = page.robots || config.site.seo.robots || 'index,follow';
   const keywords = (page.keywords || config.site.seo.keywords || []).join(', ');
-  const image = page.image || config.site.seo.image || '';
+  const imagePath = page.image || config.site.seo.image || '';
+  const image = imagePath.startsWith('/') && config.site.url ? new URL(imagePath, config.site.url).href : imagePath;
   const currentPrefix = localePrefix(config, locale);
   const currentPath = page.urlPath || localizedUrl(config, locale, '');
   const localeRoute = currentPrefix && currentPath.startsWith(currentPrefix + '/')
@@ -130,13 +144,13 @@ export async function renderLayout(config, extensions, page, body) {
       footerClass: componentClass(config.site.components.footer, 'site-footer'),
       footerCopyClass: componentClass(Boolean(config.site.footer), 'footer-copy'),
       footerNavigationClass: componentClass(config.site.components.footerNavigation && config.site.footerNavigation.length, 'footer-navigation'),
-      primaryNavigationHtml: navigationItems(config, locale, config.site.navigation),
-      footerNavigationHtml: navigationItems(config, locale, config.site.footerNavigation),
+      primaryNavigationHtml: navigationItems(config, locale, config.site.navigation, page.urlPath || localizedUrl(config, locale, '')),
+      footerNavigationHtml: navigationItems(config, locale, config.site.footerNavigation, '', 'footer'),
       localeLinksHtml,
       stylesheet,
       homePath: localizedUrl(config, locale, ''),
       archivesPath: localizedUrl(config, locale, 'archives/'),
-      feedPath: localizedUrl(config, locale, 'feed.xml'),
+      feedPath: localizedUrl(config, locale, 'rss.xml'),
       homeLabel: translate(config, locale, 'home'),
       archivesLabel: translate(config, locale, 'archives'),
       feedLabel: translate(config, locale, 'feed'),
@@ -162,9 +176,39 @@ export async function renderLayout(config, extensions, page, body) {
       return escapeHtml(value);
     });
   const html = '<!doctype html>' + rendered;
-  const filtered = await extensions.filter('html:afterLayout', html, context);
+  let filtered = await extensions.filter('html:afterLayout', html, context);
   if (typeof filtered !== 'string') throw new Error('html:afterLayout filters must return a string');
+  filtered = filtered.replace(/<\/head\s*>/i, '<link rel="stylesheet" href="/edgepress/fonts.css"></head>');
+  if (/class="link-directory-section"/.test(filtered)) filtered = filtered.replace(/<\/head\s*>/i, '<link rel="stylesheet" href="/edgepress/link-directory.css"></head>');
+  if(/<img\b[^>]*\sloading=["\']lazy["\']/i.test(filtered))filtered=filtered.replace(/<\/head\s*>/i, '<link rel="stylesheet" href="/edgepress/images.css"></head>');
+  if(/\b(?:post-content|image-block|media-text|data-edgepress-oembed)\b/.test(filtered)){
+    const keys=['openImage','closeImage','zoomIn','zoomOut','saveOriginal','retryMedia','loading','imageUnavailable'];
+    const labels=Object.fromEntries(keys.map(key=>[key,translate(config,locale,'imageViewer'+key[0].toUpperCase()+key.slice(1))]).filter(([key,value])=>value!=='imageViewer'+key[0].toUpperCase()+key.slice(1)));
+    filtered=filtered.replace('</head>','<link rel="stylesheet" href="/edgepress/image-viewer.css"></head>').replace('</body>','<script id="edgepress-image-viewer-config" type="application/json">'+JSON.stringify(labels).replace(/</g,'\\u003c')+'</script><script type="module" src="/edgepress/image-viewer.js"></script></body>');
+  }
   const scripts = [];
+  if (config.site.externalLinks?.enabled) {
+    const labels = Object.fromEntries(['title', 'description', 'back', 'continue'].map(key => [key, translate(config, locale, 'externalLink' + key[0].toUpperCase() + key.slice(1))]));
+    const settings = { ...config.site.externalLinks, siteUrl: config.site.url, labels };
+    filtered = filtered.replace(/<\/head\s*>/i, '<link rel="stylesheet" href="/edgepress/external-links.css"></head>');
+    scripts.push('<script id="edgepress-external-links-config" type="application/json">' + JSON.stringify(settings).replace(/</g, '\\u003c') + '</script><script type="module" src="/edgepress/external-links.js"></script>');
+  }
+  if (/<main\b/i.test(filtered)) scripts.push('<script type="module" src="/edgepress/webmcp.js"></script>');
+  if (/data-edgepress-(?:media-viewer|video)(?:\s|=|>)/i.test(filtered)) {
+    filtered = filtered.replace(/<\/head\s*>/i, '<link rel="stylesheet" href="/edgepress/media-viewer.css"><link rel="stylesheet" href="/edgepress/image-viewer.css"></head>');
+    scripts.push('<script type="module" src="/edgepress/media-viewer.js"></script>');
+    if (filtered.includes('data-media-service')) scripts.push('<script defer src="/edgepress/services-consent.js"></script>');
+  }
+  if (/data-edgepress-document(?:\s|=|>)/i.test(filtered)) {
+    const keys = ['preview', 'close', 'loading', 'error', 'page', 'sheet'];
+    const labels = Object.fromEntries(keys.map(key => [key, translate(config, locale, 'documentViewer' + key[0].toUpperCase() + key.slice(1))]));
+    filtered = filtered.replace(/<\/head\s*>/i, '<link rel="stylesheet" href="/edgepress/document-viewer/styles.css"></head>');
+    scripts.push('<script id="edgepress-document-viewer-config" type="application/json">' + JSON.stringify(labels).replace(/</g, '\\u003c') + '</script><script type="module" src="/edgepress/document-viewer.js"></script>');
+    if (filtered.includes('data-document-service')) scripts.push('<script defer src="/edgepress/services-consent.js"></script>');
+  }
+  if (filtered.includes('data-project-demo')) scripts.push('<script defer src="/edgepress/project-demo.js"></script>');
+  if (filtered.includes('data-local-time')) scripts.push('<script defer src="/edgepress/local-time.js"></script>');
+  if (filtered.includes('data-navigation-select')) scripts.push('<script defer src="/edgepress/navigation-select.js"></script>');
   if (!/src=["']\/edgepress\/code-copy\.js["']/i.test(filtered)) scripts.push('<script defer src="/edgepress/code-copy.js"></script>');
   if (/data-post-toc(?:\s|>)/i.test(filtered) && !/src=["']\/edgepress\/post-toc\.js["']/i.test(filtered)) {
     scripts.push('<script defer src="/edgepress/post-toc.js"></script>');
@@ -172,6 +216,12 @@ export async function renderLayout(config, extensions, page, body) {
   if (/data-edgepress-search(?:\s|=|>)/i.test(filtered) && !/src=["']\/edgepress\/search\.js["']/i.test(filtered)) {
     scripts.push('<script defer src="/edgepress/search.js"></script>');
   }
+  if (/data-edgepress-oembed(?:\s|=|>)/i.test(filtered)) {
+    filtered = filtered.replace(/<\/body\s*>/i, '<script type="module" src="/edgepress/oembed.js"></script></body>');
+  }
+  if (/data-edgepress-service(?:\s|=|>)/i.test(filtered) && !/src=["']\/edgepress\/services-consent\.js["']/i.test(filtered)) {
+    scripts.push('<script defer src="/edgepress/services-consent.js"></script>');
+  }
   if (!scripts.length) return filtered;
   const integration = scripts.join('');
   return /<\/body\s*>/i.test(filtered)

package/src/video-metadata.js

@@ -0,0 +1,36 @@
+import {readFile} from 'node:fs/promises';
+import {posix} from 'node:path';
+
+// Offline-generated sidecars keep duration and posters available without requesting media.
+export async function collectVideoMetadata(assets) {
+  const known = new Map(assets.map(item => [item.path, item])), result = new Map();
+  for (const video of assets.filter(item => /\.(?:mp4|webm|ogv|ogg)$/i.test(item.path))) {
+    const sidecar = known.get(video.path + '.json');
+    if (!sidecar) continue;
+    const data = JSON.parse((sidecar.content ?? await readFile(sidecar.source)).toString());
+    const duration = Number(data.duration), width = Number(data.width), height = Number(data.height);
+    if (![duration, width, height].every(value => Number.isFinite(value) && value > 0)) throw new Error('Invalid video metadata: ' + sidecar.path);
+    if (typeof data.poster !== 'string' || /[\\?#\x00-\x1f]|^[a-z]+:|^\/\//i.test(data.poster)) throw new Error('Invalid video poster: ' + sidecar.path);
+    const poster = posix.normalize(posix.join(posix.dirname(video.path), data.poster));
+    if (!known.has(poster) || !/\.(?:jpe?g|png|webp|avif)$/i.test(poster)) throw new Error('Missing local video poster: ' + sidecar.path);
+    result.set('/' + video.path, {duration, width, height, poster: '/' + poster});
+  }
+  return result;
+}
+
+export function reserveVideoMetadata(html, metadata, path, origin) {
+  return html.replace(/<video\b([^>]*)>([\s\S]*?)<\/video>/gi, (tag, attributes, content) => {
+    const src = attributes.match(/\ssrc=["']([^"']+)["']/i)?.[1] ?? content.match(/<source\b[^>]*\ssrc=["']([^"']+)["']/i)?.[1];
+    if (!src) return tag;
+    let url;
+    try { url = new URL(src.replaceAll('&amp;', '&'), new URL('/' + path, origin)); } catch { return tag; }
+    if (url.origin !== new URL(origin).origin) return tag;
+    const data = metadata.get(decodeURI(url.pathname));
+    if (!data) return tag;
+    const escape = value => String(value).replaceAll('&', '&amp;').replaceAll('"', '&quot;').replaceAll('<', '&lt;');
+    for (const [name, value] of Object.entries({'data-duration': data.duration, poster: data.poster, width: data.width, height: data.height})) {
+      if (!new RegExp('\\s' + name + '\\s*=', 'i').test(attributes)) attributes += ' ' + name + '="' + escape(value) + '"';
+    }
+    return '<video' + attributes + '>' + content + '</video>';
+  });
+}

package/static/edgepress/data-saver.css

@@ -0,0 +1,12 @@
+.edgepress-data-offer{position:fixed;inset:auto 1rem 1rem auto;z-index:1200;width:min(27rem,calc(100vw - 2rem));padding:1.2rem;border:1px solid var(--line,GrayText);border-radius:1rem;background:var(--surface,var(--paper,Canvas));color:var(--ink,CanvasText);box-shadow:0 12px 40px #0002;visibility:visible;font:1rem/1.6 system-ui,sans-serif}.edgepress-data-offer h2{margin:0 0 .5rem;font:inherit;font-weight:700}.edgepress-data-offer p{margin:.5rem 0 1rem}.edgepress-data-offer>div{display:flex;flex-wrap:wrap;gap:.6rem}.edgepress-data-return{display:flex;justify-content:center;align-items:center;flex-wrap:wrap;gap:.75rem;margin:1.5rem auto;padding:.75rem 1rem;max-width:68rem;color:var(--muted,var(--ink,CanvasText));font:inherit}.edgepress-data-offer[hidden],.edgepress-data-return[hidden]{display:none!important}.edgepress-data-offer button,.edgepress-data-return button,.edgepress-data-placeholder button{appearance:none;font:inherit;color:var(--ink,CanvasText);background:var(--surface,var(--paper,Canvas));border:1px solid var(--line,GrayText);border-radius:.65rem;min-height:44px;padding:.5rem .8rem;cursor:pointer}.edgepress-data-offer button[data-data-mode=text]{background:var(--ink,CanvasText);color:var(--paper,Canvas)}.edgepress-data-offer button:focus-visible,.edgepress-data-return button:focus-visible,.edgepress-data-placeholder button:focus-visible{outline:3px solid var(--accent,Highlight);outline-offset:3px}.edgepress-data-placeholder{display:inline-flex;align-items:center;flex-wrap:wrap;gap:.6rem;max-width:100%;padding:.6rem .8rem;border:1px dashed var(--line,GrayText);border-radius:.65rem;color:var(--muted,var(--ink,CanvasText));background:var(--surface,var(--paper,Canvas));overflow-wrap:anywhere}.edgepress-data-placeholder[data-loaded=true]{display:contents}
+html[data-edgepress-data-mode=text]{--edgepress-font-sans:system-ui,sans-serif;--edgepress-font-serif:Georgia,serif;--edgepress-font-mono:ui-monospace,monospace}html[data-edgepress-data-mode=text] [hidden],html[data-edgepress-data-mode=text] .edgepress-data-placeholder[data-data-decorative]{display:none!important}html[data-edgepress-data-mode=text] .edgepress-data-brand{display:inline;color:inherit;background:none;padding:0;border:0;font:inherit}html[data-edgepress-data-mode=text] .edgepress-data-placeholder:not([data-data-brand])>[data-data-description]{display:block;font-size:.9em;line-height:1.6}html[data-edgepress-data-mode=text] .edgepress-data-placeholder:focus-within{outline:2px solid var(--accent,Highlight);outline-offset:2px}html[data-edgepress-data-mode=text] main{overflow-wrap:anywhere}
+html[data-edgepress-data-mode] .edgepress-data-placeholder noscript{display:none!important}html:not([data-edgepress-data-mode]) .edgepress-data-placeholder{display:contents}html:not([data-edgepress-data-mode]) [data-data-description]{display:none}html[data-edgepress-data-mode=full]:not([data-edgepress-data-ready=true]) body{visibility:hidden}
+@media(forced-colors:active){.edgepress-data-offer{border:2px solid CanvasText;box-shadow:none}.edgepress-data-offer button[data-data-mode=text]{background:Canvas;color:CanvasText;border:2px solid Highlight}}@media(prefers-reduced-motion:reduce){.edgepress-data-offer *,.edgepress-data-return *{transition:none;animation:none}}
+html[data-edgepress-data-mode=text] a .edgepress-data-placeholder>[data-data-description]{position:static;width:auto;height:auto;margin:0;overflow:visible;clip-path:none;white-space:normal}
+html[data-edgepress-data-mode=text] [data-oembed-placeholder]{display:none}html[data-edgepress-data-mode=text] .edgepress-oembed:not([data-loaded=true]) [data-oembed-status]{min-height:0}
+.edgepress-data-wait{position:fixed;inset:0;z-index:1190;display:grid;place-items:center;padding:1rem;background:var(--paper,var(--surface,Canvas));color:var(--ink,CanvasText);visibility:visible;font:1rem/1.6 system-ui,"Segoe UI","PingFang TC","PingFang SC","Microsoft JhengHei","Microsoft YaHei","Noto Sans CJK TC","Noto Sans CJK SC","Arial Unicode MS",sans-serif}.edgepress-data-wait[hidden]{display:none!important}.edgepress-data-wait>p{margin:0;padding:1rem;max-width:30rem;text-align:center}.edgepress-data-wait .edgepress-data-offer{max-height:calc(100dvh - 2rem);overflow:auto}.edgepress-data-offer,.edgepress-data-offer button{font-family:inherit}html[data-edgepress-data-ready=false] body{visibility:hidden}
+html[data-edgepress-data-mode=text]{--edgepress-font-sans:system-ui,"Segoe UI","PingFang TC","PingFang SC","Microsoft JhengHei","Microsoft YaHei","Noto Sans CJK TC","Noto Sans CJK SC","Arial Unicode MS",sans-serif;--edgepress-font-serif:Georgia,"Songti TC","Songti SC","Noto Serif CJK TC","Noto Serif CJK SC","PMingLiU","SimSun",serif;--edgepress-font-mono:ui-monospace,"Cascadia Mono","Consolas","Microsoft JhengHei","Microsoft YaHei",monospace;font-synthesis:weight}html[data-edgepress-data-mode=text] body{font-family:var(--edgepress-font-sans)}html[data-edgepress-data-mode=text] input,html[data-edgepress-data-mode=text] button,html[data-edgepress-data-mode=text] select,html[data-edgepress-data-mode=text] textarea{font-family:inherit}
+.edgepress-service>[data-service-load],.edgepress-service>[data-service-consent-settings]{appearance:none;font:inherit;min-height:44px;margin:.4rem .5rem .4rem 0;padding:.5rem .85rem;color:var(--ink,CanvasText);background:var(--surface,var(--paper,Canvas));border:1px solid var(--line,GrayText);border-radius:.65rem;cursor:pointer}.edgepress-service>button:focus-visible{outline:3px solid var(--accent,Highlight);outline-offset:3px}.edgepress-service>button:disabled{cursor:wait;opacity:.6}
+.edgepress-data-wait,.edgepress-data-offer{box-sizing:border-box;color-scheme:light dark}
+.edgepress-data-wait{background:var(--paper,var(--surface,var(--night,Canvas)))}.edgepress-data-offer{background:var(--surface,var(--paper,var(--panel,Canvas)))}
+.edgepress-data-progress{max-width:30rem;width:100%;text-align:center}.edgepress-data-progress p{margin:0 0 1rem;overflow-wrap:anywhere}.edgepress-data-progress progress{appearance:none;display:block;width:min(20rem,100%);height:.6rem;margin:auto;border:1px solid var(--line,GrayText);border-radius:1rem;overflow:hidden;background:var(--surface,Canvas);accent-color:var(--accent,Highlight)}.edgepress-data-progress progress::-webkit-progress-bar{background:var(--surface,Canvas)}.edgepress-data-progress progress::-webkit-progress-value{background:var(--accent,Highlight)}.edgepress-data-progress progress::-moz-progress-bar{background:var(--accent,Highlight)}

package/static/edgepress/data-saver.js

@@ -0,0 +1,333 @@
+(() => {
+  const configuration = document.getElementById('edgepress-data-saver-config');
+  if (!configuration) return;
+  const settings = JSON.parse(configuration.textContent);
+  const parameters = new URL(location.href).searchParams;
+  if (parameters.has('data-save') && (!settings.enabled || !settings.debug || parameters.getAll('data-save').length !== 1 || parameters.get('data-save') !== '')) {
+    location.replace(settings.notFoundUrl);
+    return;
+  }
+  if (!settings.enabled) return;
+  const modes = ['auto', 'text', 'full'];
+  const key = 'edgepress-data-mode';
+  const query = parameters.has('data-save') ? 'text' : parameters.get('data-mode');
+  let preference = settings.mode;
+  try { const saved = localStorage.getItem(key); if (modes.includes(saved)) preference = saved; } catch {}
+  if (modes.includes(query)) preference = query;
+  const connection = navigator.connection || navigator.mozConnection || navigator.webkitConnection;
+  const reduced = settings.respectBrowserPreference && (connection?.saveData === true || matchMedia('(prefers-reduced-data: reduce)').matches);
+  const mode = preference === 'auto' ? reduced ? 'text' : 'full' : preference;
+  document.documentElement.dataset.edgepressDataMode = mode;
+  if (mode === 'full' && settings.firstImage) {
+    const link = document.createElement('link');
+    link.rel = 'preload';
+    link.as = 'image';
+    link.href = settings.firstImage.href;
+    if (settings.firstImage.srcset) link.imageSrcset = settings.firstImage.srcset;
+    if (settings.firstImage.sizes) link.imageSizes = settings.firstImage.sizes;
+    if (settings.firstImage.type) link.type = settings.firstImage.type;
+    link.fetchPriority = 'high';
+    document.head.append(link);
+  }
+  for (const hint of (mode === 'text' ? settings.textPreloads : settings.fullPreloads) || []) {
+    const link = document.createElement('link');
+    link.rel = hint.rel;
+    link.href = hint.href;
+    if (hint.as) link.as = hint.as;
+    link.dataset.edgepressDataPreload = '';
+    document.head.append(link);
+  }
+  const resources = new Map();
+  let firstScreenReady = false;
+  let dismissed = false;
+  let offerRequested = false;
+  let monitor;
+  let switching = false;
+  const prepareWaiting = () => {
+    const waiting = document.querySelector('[data-data-wait]');
+    if (!waiting) return;
+    waiting.hidden = false;
+    const offer = waiting.querySelector('[data-data-offer]');
+    if (offer) {
+      offer.hidden = mode !== 'full' || !settings.detectSlowConnection;
+      earlyObserver.disconnect();
+    }
+  };
+  const earlyObserver = new MutationObserver(prepareWaiting);
+  earlyObserver.observe(document.documentElement, { childList: true, subtree: true });
+  document.documentElement.dataset.edgepressDataReady = 'false';
+  const switchView = selected => {
+    if (switching || !['text', 'full'].includes(selected)) return;
+    switching = true;
+    const url = new URL(location.href);
+    url.searchParams.delete('data-save');
+    document.documentElement.dataset.edgepressDataReady = 'false';
+    const waiting = document.querySelector('[data-data-wait]');
+    if (waiting) waiting.hidden = false;
+    document.querySelectorAll('[data-data-mode]').forEach(control => { control.disabled = true; });
+    let persisted = false;
+    try { sessionStorage.setItem('edgepress-data-focus', selected); sessionStorage.setItem('edgepress-data-scroll', String(scrollY)); } catch {}
+    try { localStorage.setItem(key, selected); persisted = localStorage.getItem(key) === selected; } catch {}
+    if (persisted) url.searchParams.delete('data-mode'); else url.searchParams.set('data-mode', selected);
+    location.assign(url.href);
+  };
+  document.addEventListener('click', event => {
+    const button = event.target.closest('[data-data-mode]');
+    if (button) switchView(button.dataset.dataMode);
+  });
+  document.addEventListener('focusin', event => {
+    if (event.target.closest('[data-data-offer]')) offerRequested = true;
+  });
+  const progress = (phase, completed, total) => {
+    const indicator = document.querySelector('[data-data-progress]');
+    const label = document.querySelector('[data-data-progress-label]');
+    if (!indicator || !label || switching) return;
+    if (indicator.max !== Math.max(1, total)) indicator.max = Math.max(1, total);
+    if (indicator.value !== completed) indicator.value = completed;
+    const message = (settings.labels[phase] || settings.labels.loading).replace('{loaded}', completed).replace('{total}', total);
+    if (label.textContent !== message) label.textContent = message;
+    if (indicator.getAttribute('aria-label') !== message) indicator.setAttribute('aria-label', message);
+  };
+  const showOffer = () => {
+    if (firstScreenReady || dismissed) return;
+    offerRequested = true;
+    const offer = document.querySelector('[data-data-offer]');
+    if (offer) {
+      offer.hidden = false;
+      offer.querySelector('h2').textContent = settings.labels.slowTitle;
+      offer.querySelector('[data-data-loading-notice]').textContent = settings.labels.slowNotice;
+    }
+  };
+  const offerTimer = mode === 'full' && preference === 'auto' && settings.detectSlowConnection
+    ? setTimeout(showOffer, Math.max(0, (settings.promptAfterMs || 5000) - performance.now()))
+    : null;
+  const activateResources = (kind, feature) => {
+    const loading = [];
+    for (const template of document.querySelectorAll('template[data-edgepress-data-resource]')) {
+      if (template.dataset.edgepressDataResource !== kind) continue;
+      if (feature && template.dataset.dataFeature !== feature) continue;
+      if (!feature && kind === 'style' && template.dataset.dataFeature === 'fonts') continue;
+      const original = template.content.firstElementChild;
+      if (!original) continue;
+      const source = original.getAttribute('src') || original.getAttribute('href');
+      const identity = kind + ':' + original.tagName + ':' + (original.getAttribute('rel') || '') + ':' + source;
+      if (resources.has(identity)) continue;
+      const element = document.createElement(original.tagName);
+      for (const attribute of original.attributes) element.setAttribute(attribute.name, attribute.value);
+      if (element.tagName === 'SCRIPT') element.async = false;
+      if (element.tagName === 'SCRIPT' || element.tagName === 'LINK' && element.rel === 'stylesheet') loading.push(new Promise(resolve => {
+        element.addEventListener('load', () => resolve(true), { once: true });
+        element.addEventListener('error', () => {
+          resources.delete(identity);
+          element.replaceWith(template);
+          resolve(false);
+        }, { once: true });
+      }));
+      resources.set(identity, element);
+      template.replaceWith(element);
+    }
+    return loading;
+  };
+  const activateMedia = host => {
+    const template = host.querySelector(':scope > template');
+    if (!template) return;
+    if (template.hasAttribute('data-edgepress-data-html')) template.innerHTML = template.content.textContent;
+    host.replaceChildren(template.content.cloneNode(true));
+    host.dataset.loaded = 'true';
+    document.dispatchEvent(new CustomEvent('edgepress:data-media', { detail: { root: host } }));
+  };
+  const deferMedia = (element, activate, label = '') => {
+    if (mode !== 'text') { activate(); return null; }
+    const host = document.createElement('span');
+    host.className = 'edgepress-data-placeholder';
+    const text = document.createElement('span');
+    text.dataset.dataDescription = '';
+    text.textContent = label;
+    const button = document.createElement('button');
+    button.type = 'button';
+    button.textContent = settings.labels.load;
+    if (label) button.setAttribute('aria-label', settings.labels.load + ': ' + label);
+    button.addEventListener('click', () => {
+      host.replaceChildren(element);
+      host.dataset.loaded = 'true';
+      activate();
+      if (!element.matches('a, button, input, select, textarea, [tabindex]')) element.tabIndex = -1;
+      element.focus({ preventScroll: true });
+    }, { once: true });
+    host.append(text, button);
+    return host;
+  };
+  window.edgepressDataSaver = Object.freeze({ mode, preference, deferMedia });
+  const initialize = () => {
+    const offer = document.querySelector('[data-data-offer]');
+    const waiting = document.querySelector('[data-data-wait]');
+    prepareWaiting();
+    let revealPage = () => {};
+    const returnEntry = document.querySelector('[data-data-return]');
+    if (returnEntry) returnEntry.hidden = mode !== 'text';
+    if (offer && offerRequested) offer.hidden = false;
+    const closeOffer = () => {
+      if (!offer) return;
+      if (offer.contains(document.activeElement)) {
+        const main = document.querySelector('main');
+        if (main) { if (!main.hasAttribute('tabindex')) main.tabIndex = -1; main.focus({ preventScroll: true }); }
+      }
+      offer.hidden = true;
+    };
+    const dismiss = () => {
+      dismissed = true;
+      offerRequested = false;
+      clearTimeout(offerTimer);
+      if (firstScreenReady) { revealPage(); closeOffer(); return; }
+      if (offer) {
+        offer.querySelector('h2').textContent = settings.labels.loading;
+        offer.querySelector('[data-data-loading-notice]').textContent = settings.labels.loadingNotice;
+      }
+      const status = waiting?.querySelector('[data-data-progress-label]');
+      if (status) { status.tabIndex = -1; status.focus({ preventScroll: true }); }
+    };
+    document.querySelector('[data-data-dismiss]')?.addEventListener('click', dismiss);
+    document.addEventListener('keydown', event => { if (event.key === 'Escape' && offer && !offer.hidden) dismiss(); });
+    let requestedFocus = false;
+    let position = 0;
+    try {
+      requestedFocus = modes.includes(sessionStorage.getItem('edgepress-data-focus'));
+      position = Number(sessionStorage.getItem('edgepress-data-scroll')) || 0;
+      sessionStorage.removeItem('edgepress-data-focus');
+      sessionStorage.removeItem('edgepress-data-scroll');
+    } catch { requestedFocus = modes.includes(query); }
+    const focusDeadline = performance.now() + 8000;
+    const restoreFocus = () => {
+      if (!requestedFocus || document.activeElement !== document.body) return;
+      const target = document.querySelector('main');
+      if (!target) return;
+      if (getComputedStyle(target).visibility !== 'visible') {
+        if (performance.now() < focusDeadline) requestAnimationFrame(restoreFocus);
+        return;
+      }
+      if (!target.hasAttribute('tabindex')) target.tabIndex = -1;
+      target.focus({ preventScroll: true });
+      if (position > 0) scrollTo({ top: position, behavior: 'instant' });
+    };
+    const loading = activateResources('style', mode === 'text' ? 'core' : undefined);
+    const controls = activateResources('script', 'core');
+    const criticalReady = results => {
+      if (results.every(Boolean)) return true;
+      clearTimeout(offerTimer);
+      offerRequested = true;
+      if (offer) {
+        offer.hidden = false;
+        offer.querySelector('h2').textContent = settings.labels.loading;
+        offer.querySelector('[data-data-loading-notice]').textContent = settings.labels.loadFailed;
+        offer.querySelector('[data-data-dismiss]').hidden = true;
+        offer.querySelector('[data-data-mode=text]').hidden = mode === 'text';
+        const retry = offer.querySelector('[data-data-retry]');
+        retry.hidden = false;
+        retry.addEventListener('click', () => location.reload(), { once:true });
+      }
+      const status = waiting?.querySelector('[data-data-progress-label]');
+      if (status) status.textContent = settings.labels.loadFailed;
+      return false;
+    };
+    let completedStyles = 0;
+    let completedControls = 0;
+    const updateProgress = () => {
+      if (completedStyles < loading.length) progress('progressStyles', completedStyles, loading.length);
+      else progress('progressControls', completedControls, controls.length);
+    };
+    updateProgress();
+    for (const resource of loading) void resource.then(() => { completedStyles++; updateProgress(); });
+    for (const resource of controls) void resource.then(() => { completedControls++; updateProgress(); });
+    if (mode === 'full') {
+      const reveal = () => {
+        if (switching) return;
+        if (document.documentElement.dataset.edgepressDataReady === 'true') return;
+        document.documentElement.dataset.edgepressDataReady = 'true';
+        if (waiting) waiting.hidden = true;
+        document.querySelectorAll('[data-edgepress-data-preload]').forEach(link => link.remove());
+        requestAnimationFrame(() => {
+          activateResources('script');
+          const loadFonts = () => { if (!switching) activateResources('style', 'fonts'); };
+          if (typeof requestIdleCallback === 'function') requestIdleCallback(loadFonts, {timeout:1500});
+          else setTimeout(loadFonts, 250);
+        });
+        requestAnimationFrame(restoreFocus);
+      };
+      revealPage = reveal;
+      let stylesReady = false;
+      const visibleImages = new Set();
+      const ready = () => {
+        stylesReady = true;
+        for (const image of document.images) {
+          const rectangle = image.getBoundingClientRect();
+          if (rectangle.width > 0 && rectangle.height > 0 && rectangle.top < innerHeight && rectangle.bottom > 0) visibleImages.add(image);
+        }
+        for (const image of visibleImages) if (image.loading === 'lazy' && !image.complete) image.loading = 'eager';
+        checkFirstScreen();
+      };
+      void Promise.all([...loading, ...controls]).then(results => {
+        if (switching || !criticalReady(results)) return;
+        document.querySelectorAll('[data-edgepress-data-media]').forEach(activateMedia);
+        ready();
+      }, ready);
+      const checkFirstScreen = () => {
+        if (!stylesReady || document.readyState === 'loading') return;
+        const completedImages = [...visibleImages].filter(image => image.complete).length;
+        progress('progressMedia', completedImages, visibleImages.size);
+        if (completedImages < visibleImages.size) return;
+        firstScreenReady = true;
+        clearTimeout(offerTimer);
+        clearInterval(monitor);
+        if (!offerRequested || dismissed) { reveal(); closeOffer(); }
+      };
+      monitor = setInterval(checkFirstScreen, 100);
+      requestAnimationFrame(checkFirstScreen);
+      return;
+    }
+    void Promise.all([...loading, ...controls]).then(results => {
+      if (switching || !criticalReady(results)) return;
+      document.documentElement.dataset.edgepressDataReady = 'true';
+      if (waiting) waiting.hidden = true;
+      document.querySelectorAll('[data-edgepress-data-preload]').forEach(link => link.remove());
+      requestAnimationFrame(restoreFocus);
+    });
+    document.addEventListener('click', event => {
+      const button = event.target.closest('[data-oembed-load]');
+      if (!button || !document.querySelector('template[data-edgepress-data-resource="script"][data-data-feature="embed"]')) return;
+      button.disabled = true;
+      button.setAttribute('aria-busy', 'true');
+      void Promise.all(activateResources('script', 'embed')).then(results => {
+        button.disabled = false;
+        button.removeAttribute('aria-busy');
+        if (results.every(Boolean)) button.click();
+      });
+    });
+    for (const host of document.querySelectorAll('[data-edgepress-data-media]')) {
+      if (host.hasAttribute('data-data-decorative') || host.hasAttribute('data-data-brand')) continue;
+      const button = document.createElement('button');
+      button.type = 'button';
+      button.textContent = settings.labels.load;
+      const descriptionNode = host.querySelector('[data-data-description]');
+      if (descriptionNode && !descriptionNode.textContent.trim()) descriptionNode.textContent = settings.labels.missingDescription;
+      const description = descriptionNode?.textContent;
+      if (description) button.setAttribute('aria-label', settings.labels.load + ': ' + description);
+      const link = host.closest('a');
+      if (link) link.after(button); else host.append(button);
+      button.addEventListener('click', () => {
+        if (link) button.remove();
+        activateMedia(host);
+        activateResources('style', host.dataset.dataFeature);
+        activateResources('script', host.dataset.dataFeature);
+        const target = host.querySelector('button, a, [tabindex], img, video, audio, iframe');
+        if (target && !target.matches('a, button, input, select, textarea, [tabindex]')) target.tabIndex = -1;
+        target?.focus({ preventScroll: true });
+      }, { once: true });
+    }
+  };
+  addEventListener('pagehide', () => { earlyObserver.disconnect(); clearTimeout(offerTimer); clearInterval(monitor); }, { once: true });
+  const start = () => {
+    if (document.hidden) initialize();
+    else requestAnimationFrame(() => setTimeout(initialize, 0));
+  };
+  if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', start, { once: true }); else start();
+})();

package/static/edgepress/document-viewer.js

@@ -0,0 +1,35 @@
+import { mountDocument } from './document-viewer/index.js';
+import { readChoice } from './plugins/consent/choices.js';
+
+const labels = JSON.parse(document.getElementById('edgepress-document-viewer-config')?.textContent || '{}');
+const settings = JSON.parse(document.getElementById('edgepress-privacy-config')?.textContent || '{}');
+const viewers = new Map();
+
+function allowed(root) {
+  const id = root.dataset.documentService;
+  const origins = [root.dataset.documentSrc, root.dataset.documentPreview].filter(Boolean).map(source => new URL(source, document.baseURI).origin);
+  if (!id) return origins.every(origin => origin === location.origin);
+  const service = settings.privacy?.integrations?.find(item => item.id === id);
+  const permitted = service?.backendUrl ? [location.origin, new URL(service.backendUrl).origin, ...(service.csp?.['connect-src'] || [])] : [];
+  if (service?.provider === 'external-api' && service.enabled !== false && origins.every(origin => permitted.includes(origin)) && readChoice(settings)?.allowed.includes(id)) return true;
+  return false;
+}
+
+function refresh() {
+  for (const root of document.querySelectorAll('[data-edgepress-document]')) {
+    if (viewers.has(root)) continue;
+    if (root.closest('[data-edgepress-oembed], [data-edgepress-service], template')) continue;
+    const viewer = mountDocument(root.querySelector('[data-document-mount]'), {
+      src: root.dataset.documentSrc, previewSrc: root.dataset.documentPreview,
+      title: root.dataset.documentTitle, format: root.dataset.documentFormat,
+      locale: document.documentElement.lang, labels, canLoad: () => allowed(root)
+    });
+    viewers.set(root, viewer);
+  }
+}
+refresh();
+document.addEventListener('edgepress:data-media', refresh);
+
+addEventListener('pagehide', () => { for (const viewer of viewers.values()) viewer.close(false); });
+addEventListener('storage', () => { for (const [root, viewer] of viewers) if (!allowed(root)) viewer.close(false); });
+document.addEventListener('visibilitychange', () => { for (const [root, viewer] of viewers) if (!allowed(root)) viewer.close(false); });

package/static/edgepress/external-links-policy.js

@@ -0,0 +1,14 @@
+export function linkOrigin(value) {
+  const url = new URL(value);
+  if (!['http:', 'https:'].includes(url.protocol) || url.hostname.includes('*') || url.username || url.password || url.pathname !== '/' || url.search || url.hash) throw new Error('Trusted sites must be exact HTTP(S) origins, without credentials, paths or wildcards');
+  return url.origin;
+}
+
+export function classifyLink(value, settings, base) {
+  let url;
+  try { url = new URL(value, base); } catch { return { kind: 'blocked' }; }
+  if (['javascript:', 'data:', 'vbscript:', 'file:', 'blob:', 'filesystem:', 'about:'].includes(url.protocol) || url.username || url.password) return { kind: 'blocked' };
+  if (!['http:', 'https:'].includes(url.protocol)) return { kind: 'native' };
+  const origins = new Set([new URL(settings.siteUrl).origin, ...settings.trustedOrigins]);
+  return { kind: origins.has(url.origin) ? 'native' : 'external', url: url.href, domain: url.host, origin: url.origin };
+}

package/static/edgepress/external-links.css

@@ -0,0 +1,13 @@
+.edgepress-external-overlay{--external-paper:var(--external-link-surface,var(--surface,var(--panel,var(--paper,var(--external-auto-paper,Canvas)))));--external-ink:var(--external-link-ink,var(--ink,var(--text,var(--external-auto-ink,CanvasText))));--external-accent:var(--external-link-accent,var(--accent,var(--external-auto-accent,LinkText)));position:fixed;inset:0;z-index:100000;display:grid;place-items:center;padding:clamp(16px,4vw,40px);background:rgba(0,0,0,.52);color:var(--external-ink);font:inherit;overflow:auto;overscroll-behavior:contain;color-scheme:inherit}
+.edgepress-external-overlay[hidden]{display:none!important}
+.edgepress-external-panel{box-sizing:border-box;width:min(100%,520px);max-height:90dvh;overflow:auto;background:var(--external-paper);color:var(--external-ink);border:1px solid var(--line,currentColor);border-radius:var(--radius-card,20px);padding:clamp(22px,5vw,36px);box-shadow:0 24px 80px rgba(0,0,0,.25);text-align:start;overflow-wrap:anywhere}
+.edgepress-external-panel h2{margin:0 0 16px;font:inherit;font-size:1.35rem;font-weight:750;color:inherit}
+.edgepress-external-panel p{margin:12px 0;line-height:1.65;color:inherit}
+.edgepress-external-url{font-size:1rem;font-weight:650;overflow-wrap:anywhere;word-break:break-word;unicode-bidi:plaintext}
+.edgepress-external-actions{display:flex;flex-wrap:wrap;gap:12px;margin-top:24px}
+.edgepress-external-actions button{appearance:none;box-sizing:border-box;flex:1;min-width:140px;min-height:48px;margin:0;padding:12px 18px;border:1px solid var(--external-accent);border-radius:var(--radius-small,12px);background:var(--external-paper);color:var(--external-ink);font:inherit;font-weight:650;line-height:1.4;cursor:pointer}
+.edgepress-external-actions button:last-child{border-width:2px}
+.edgepress-external-actions button:hover{box-shadow:inset 0 0 0 1px var(--external-accent)}
+.edgepress-external-actions button:focus-visible{outline:3px solid var(--external-accent);outline-offset:4px}
+@media(forced-colors:active){.edgepress-external-panel{background:Canvas;color:CanvasText;border:2px solid CanvasText}.edgepress-external-actions button{background:ButtonFace;color:ButtonText;border-color:ButtonText}.edgepress-external-actions button:focus-visible{outline-color:Highlight}}
+@media(prefers-reduced-motion:reduce){.edgepress-external-overlay,.edgepress-external-overlay *{animation:none!important;transition:none!important;scroll-behavior:auto!important}}