edgepress 2026.10.1 → 2026.10.13

package/src/content.js

@@ -1,3 +1,6 @@
+import {parsePublicationDate,publicationCalendar} from './publication-time.js';
+import { readPostRevision } from './revisions.js';
+import { normalizeCategory, safeAvatar, readingMinutes } from './post-details.js';
 import { readdir, readFile } from 'node:fs/promises';
 import { basename, dirname, extname, relative, resolve, sep } from 'node:path';
 import { parse as parseYaml } from 'yaml';
@@ -17,14 +20,15 @@ export function postsForLocale(posts, locale, defaultLocale) {
   const byBundle = new Map();
   for (const post of posts) {
     const current = byBundle.get(post.bundlePath);
-    if (!current || post.locale === locale || (current.locale !== locale && post.locale === defaultLocale)) {
+    if (!current || post.locale === locale || (current.locale !== locale && post.locale === defaultLocale) ||
+        (current.locale !== locale && current.locale !== defaultLocale && post.locale !== defaultLocale && post.locale.localeCompare(current.locale) < 0)) {
       byBundle.set(post.bundlePath, post);
     }
   }
   return sortPostsNewest([...byBundle.values()]);
 }
 
-async function walkMarkdown(directory) {
+async function walkContent(directory, kind) {
   let entries;
   try {
     entries = await readdir(directory, { withFileTypes: true });
@@ -36,8 +40,8 @@ async function walkMarkdown(directory) {
   const found = [];
   for (const entry of entries) {
     const fullPath = resolve(directory, entry.name);
-    if (entry.isDirectory()) found.push(...await walkMarkdown(fullPath));
-    else if (entry.isFile() && extname(entry.name).toLowerCase() === '.md') found.push(fullPath);
+    if (entry.isDirectory()) found.push(...await walkContent(fullPath, kind));
+    else if (entry.isFile() && (extname(entry.name).toLowerCase() === '.md' || (kind === 'pages' && extname(entry.name).toLowerCase() === '.json'))) found.push(fullPath);
   }
   return found;
 }
@@ -54,6 +58,15 @@ function splitFrontmatter(source, file) {
   return { metadata, markdown: lines.slice(end + 1).join('\n') };
 }
 
+export function parseDocumentSource(source, file) {
+  if (extname(file).toLowerCase() !== '.json') return splitFrontmatter(source, file);
+  let metadata;
+  try { metadata = JSON.parse(source.replace(/^\uFEFF/, '')); }
+  catch (error) { throw new Error('Invalid page JSON in ' + file + ': ' + error.message, {cause: error}); }
+  if (!metadata || typeof metadata !== 'object' || Array.isArray(metadata)) throw new Error('Page JSON must be an object in ' + file);
+  return {metadata, markdown: ''};
+}
+
 export function slugify(value) {
   const slug = String(value)
     .normalize('NFKC')
@@ -69,6 +82,10 @@ function normalizeTags(value) {
 }
 
 function normalizeAuthor(value, file) {
+  if (value && typeof value === 'object' && !Array.isArray(value)) {
+    if (Object.keys(value).some(key => !['name', 'avatar'].includes(key))) throw new Error('Unsupported author field in ' + file);
+    value = value.name;
+  }
   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);
@@ -98,24 +115,14 @@ function normalizeVideo(value, file) {
   return value;
 }
 
-function normalizeDate(value, filename, kind, file) {
-  if (value instanceof Date) {
-    if (!Number.isNaN(value.valueOf())) return value;
-    throw new Error('Invalid date in ' + file);
+function normalizeDate(value, filename, kind, file, timeZone) {
+  const fallback = filename.match(/^(\d{4}-\d{2}-\d{2})-/)?.[1];
+  if (value == null && !fallback) {
+    if (kind === 'posts') throw new Error('Posts need a valid date in front matter or a YYYY-MM-DD filename: ' + file);
+    return new Date(0);
   }
-  if (value != null) {
-    const date = new Date(value);
-    if (!Number.isNaN(date.valueOf())) return date;
-    throw new Error('Invalid date in ' + file);
-  }
-  const match = filename.match(/^(\d{4}-\d{2}-\d{2})-/);
-  if (match) {
-    const date = new Date(match[1] + 'T00:00:00Z');
-    if (!Number.isNaN(date.valueOf()) && date.toISOString().slice(0, 10) === match[1]) return date;
-    throw new Error('Invalid date in filename: ' + file);
-  }
-  if (kind === 'posts') throw new Error('Posts need a valid date in front matter or a YYYY-MM-DD filename: ' + file);
-  return new Date(0);
+  try { return parsePublicationDate(value ?? fallback, timeZone); }
+  catch (error) { throw new Error(error.message + ' in ' + file); }
 }
 
 function normalizePagePath(value, file) {
@@ -134,11 +141,17 @@ export async function readDocuments(config) {
   const groups = [['posts', resolve(root, 'posts')], ['pages', resolve(root, 'pages')]];
   const files = [];
   for (const [kind, directory] of groups) {
-    for (const file of await walkMarkdown(directory)) files.push({ kind, file });
+    const identities = new Set();
+    for (const file of await walkContent(directory, kind)) {
+      const identity = resolve(dirname(file), basename(file, extname(file)).toLowerCase());
+      if (identities.has(identity)) throw new Error('Duplicate language document; keep only one .json or .md file per page locale: ' + file);
+      identities.add(identity);
+      files.push({ kind, file });
+    }
   }
   return await mapLimit(files, config.concurrency, async ({ kind, file }) => {
     const source = await readFile(file, 'utf8');
-    const { metadata, markdown } = splitFrontmatter(source, file);
+    const { metadata, markdown } = parseDocumentSource(source, file);
     const contentRoot = resolve(root, kind);
     const relativePath = relative(contentRoot, file).split(sep).join('/');
     const bundleDirectory = dirname(file);
@@ -150,13 +163,13 @@ export async function readDocuments(config) {
     const languageFileName = basename(file, extname(file));
     const languageFile = languageFileName.toLowerCase();
     const fileLocale = config.i18n.locales.find((locale) => locale.toLowerCase() === languageFile);
-    if (!fileLocale || languageFileName !== languageFile || extname(file).toLowerCase() !== '.md') {
-      throw new Error('Content language files must be named after a configured locale, such as en.md or zh-cn.md: ' + file);
+    if (!fileLocale || languageFileName !== languageFile) {
+      throw new Error('Content language files must be named after a configured locale, such as en.json or zh-cn.md: ' + file);
     }
     const declaredLocale = metadata.lang === undefined ? fileLocale :
       config.i18n.locales.find((locale) => locale.toLowerCase() === String(metadata.lang).toLowerCase());
     if (!declaredLocale) throw new Error('Unsupported lang value in ' + file + '; use the language filename and configure its language pack');
-    if (declaredLocale !== fileLocale) throw new Error('Front matter lang must match the content filename locale in ' + file);
+    if (declaredLocale !== fileLocale) throw new Error('Content lang must match the content filename locale in ' + file);
     const locale = fileLocale;
     const fallbackSlug = bundlePath.replace(/\\/g, '/');
     const fallbackName = bundleName.replace(/^\d{4}-\d{2}-\d{2}-/, '');
@@ -176,16 +189,21 @@ export async function readDocuments(config) {
     if (kind === 'pages' && markdown.trim()) {
       throw new Error('Page body must be empty; move content into page blocks: ' + file);
     }
+    if (metadata.pinned !== undefined && typeof metadata.pinned !== 'boolean') throw new Error('pinned must be a boolean in ' + file);
+    if (metadata.embeds !== undefined) throw new Error('Use !embed[service](URL) in the content instead of front-matter embeds: ' + file);
     const rawSlug = metadata.slug ?? (kind === 'posts' ? fallbackName : fallbackSlug);
     const normalizedPagePath = kind === 'pages' && metadata.homepage !== true ? normalizePagePath(rawSlug, file) : '';
     const slug = slugify(String(rawSlug).split('/').pop());
-    const date = normalizeDate(metadata.date, bundleName, kind, file);
+    const date = normalizeDate(metadata.date, bundleName, kind, file, config.site?.timeZone);
+    const calendar = metadata.date == null ? (bundleName.match(/^(\d{4}-\d{2}-\d{2})-/)?.[1] || '1970-01-01') : publicationCalendar(metadata.date,date,config.site?.timeZone);
+    if (metadata.showChanges !== undefined && typeof metadata.showChanges !== 'boolean') throw new Error('showChanges must be a boolean in ' + file);
+    const revision = kind === 'posts' ? await readPostRevision(file, source, metadata.showChanges !== false, resolve(root,'assets')) : {updated:null,changes:''};
     let path;
     if (kind === 'posts') {
       path = config.permalink
-        .replace(/:year/g, String(date.getUTCFullYear()))
-        .replace(/:month/g, String(date.getUTCMonth() + 1).padStart(2, '0'))
-        .replace(/:day/g, String(date.getUTCDate()).padStart(2, '0'))
+        .replace(/:year/g, calendar.slice(0,4))
+        .replace(/:month/g, calendar.slice(5,7))
+        .replace(/:day/g, calendar.slice(8,10))
         .replace(/:slug/g, slug)
         .replace(/:title/g, slug)
         .replace(/^\/+|\/+$/g, '') + '/';
@@ -196,7 +214,14 @@ export async function readDocuments(config) {
     if (locale !== config.i18n.defaultLocale && metadata.homepage !== true) path = locale + '/' + path;
     return {
       kind, file, relativePath, bundlePath, title, slug, date, locale,
+      dateOnly: metadata.date == null || /^\d{4}-\d{2}-\d{2}$/.test(String(metadata.date)),
+      updated: revision.updated, changes: revision.changes, showChanges: metadata.showChanges !== false,
+      revisionImages: revision.revisionImages, revisionAssets: revision.revisionAssets??[],
       author: kind === 'posts' ? normalizeAuthor(metadata.author, file) : '',
+      authorAvatar: safeAvatar(metadata.authorAvatar ?? (typeof metadata.author === 'object' && metadata.author !== null ? metadata.author.avatar : undefined), 'author avatar in ' + file),
+      category: normalizeCategory(metadata.category),
+      pinned: kind === 'posts' && metadata.pinned === true,
+      readingMinutes: kind === 'posts' ? readingMinutes(markdown) : 0,
       videoId: (kind === 'posts' ? 'post-' : 'page-') + slugify(bundlePath + '-' + locale.toLowerCase()),
       video: kind === 'posts' ? normalizeVideo(metadata.video, file) : null,
       tags: normalizeTags(metadata.tags),

package/src/data-saver.js

@@ -0,0 +1,194 @@
+import { parseDocument } from 'htmlparser2';
+import { localizedUrl, translate } from './i18n.js';
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import * as posix from 'node:path/posix';
+import postcss from 'postcss';
+import { transform, transformSync } from 'esbuild';
+import { readFileSync } from 'node:fs';
+import { createHash } from 'node:crypto';
+
+let inlineAssets;
+export function dataSaverInlineAssets(config) {
+  if (!config.site?.dataSaver?.enabled) return null;
+  if (!inlineAssets) {
+    const script = transformSync(readFileSync(new URL('../static/edgepress/data-saver.js', import.meta.url), 'utf8'), { loader:'js', minify:true, charset:'utf8', legalComments:'inline' }).code;
+    const style = transformSync(readFileSync(new URL('../static/edgepress/data-saver.css', import.meta.url), 'utf8'), { loader:'css', minify:true, charset:'utf8', legalComments:'inline' }).code;
+    const hash = value => "'sha256-" + createHash('sha256').update(value).digest('base64') + "'";
+    inlineAssets = { script, style, scriptHash:hash(script), styleHash:hash(style) };
+  }
+  return inlineAssets;
+}
+
+const essentialStyles = /\/edgepress\/(?:external-links|data-saver|data-saver-layout)\.[a-f0-9]{16}\.css$/;
+const optionalScripts = /\/edgepress\/(?:image-viewer|media-viewer|document-viewer|project-demo|webmcp|oembed|code-copy|post-toc)\.[a-f0-9]{16}\.js$/;
+const escape = value => String(value).replace(/[&<>"']/g, character => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' })[character]);
+
+export async function configureDataSaver(config) {
+  if (!config.site.dataSaver?.enabled) return;
+  const theme = JSON.parse(await readFile(resolve(config.resolvedPaths.theme, 'theme.json'), 'utf8'));
+  const variant = theme.dataSaver;
+  if (!variant || typeof variant !== 'object' || Array.isArray(variant) || typeof variant.stylesheet !== 'string' || !Array.isArray(variant.scripts) || variant.layoutStyles !== undefined && !Array.isArray(variant.layoutStyles) || Object.keys(variant).some(key => !['stylesheet', 'scripts', 'layoutStyles'].includes(key))) throw new Error('This theme must opt in with theme.json dataSaver: { stylesheet, scripts, layoutStyles? }');
+  for (const [file, extension] of [[variant.stylesheet, 'css'], ...variant.scripts.map(file => [file, 'js'])]) {
+    if (typeof file !== 'string' || !new RegExp('^[a-zA-Z0-9][a-zA-Z0-9_./-]*\\.' + extension + '$').test(file) || file.split('/').some(part => !part || part === '..' || part === '.')) throw new Error('Invalid data-saving theme asset');
+    await readFile(resolve(config.resolvedPaths.theme, 'assets', file));
+  }
+  for (const file of variant.layoutStyles || []) {
+    if (typeof file !== 'string' || !/^[a-zA-Z0-9][a-zA-Z0-9_./-]*\.css$/.test(file) || file.split('/').some(part => !part || part === '..' || part === '.')) throw new Error('Invalid data-saving layout stylesheet');
+  }
+  config.dataSaverTheme = variant;
+}
+
+export async function dataSaverLayout(config, items) {
+  if (!config.site.dataSaver?.enabled || !config.dataSaverTheme) return null;
+  const assets = new Map(items.map(item => [item.path, item]));
+  const compile = (path, parents = new Set()) => {
+    if (parents.has(path)) throw new Error('Circular data-saving layout import: ' + path);
+    if (/^edgepress\/fonts(?:\/|\.css$)/.test(path)) return postcss.root();
+    const asset = assets.get(path);
+    if (!asset?.content) throw new Error('Missing data-saving layout stylesheet: ' + path);
+    const normalized = transformSync(asset.content.toString('utf8'), { loader: 'css', minify: true, legalComments: 'inline' }).code;
+    const tree = postcss.parse(normalized, { from: path });
+    const chain = new Set([...parents, path]);
+    tree.walkAtRules(rule => {
+      if (rule.name.toLowerCase() === 'font-face') rule.remove();
+      else if (rule.name.toLowerCase() === 'import') {
+        const match = rule.params.match(/^(?:url\(\s*)?(['"])([^'"]+)\1\s*\)?\s*$/);
+        if (!match || /^(?:[a-z]+:|\/\/)/i.test(match[2])) { rule.remove(); return; }
+        const source = match[2].split(/[?#]/, 1)[0];
+        const target = source.startsWith('/') ? source.slice(1) : posix.normalize(posix.join(posix.dirname(path), source));
+        if (target.startsWith('../') || !target.endsWith('.css')) throw new Error('Invalid data-saving layout import');
+        rule.replaceWith(...compile(target, chain).nodes);
+      }
+    });
+    tree.walkDecls(declaration => {
+      if (/url\s*\(/i.test(declaration.value)) declaration.remove();
+    });
+    return tree;
+  };
+  const paths = [...(config.dataSaverTheme.layoutStyles || []), config.dataSaverTheme.stylesheet, ...(assets.has('edgepress/external-links.css') ? ['edgepress/external-links.css'] : [])].filter(Boolean);
+  const css = paths.map(file => compile(file).toString()).join('\n');
+  const result = await transform(css, { loader: 'css', minify: true, legalComments: 'inline' });
+  return { path: 'edgepress/data-saver-layout.css', content: Buffer.from(result.code), sourceName: 'Data-saving theme layout' };
+}
+
+function featureFor(source) {
+  if (/\/edgepress\/fonts(?:[./]|$)/.test(source)) return 'fonts';
+  if (/oembed/.test(source)) return 'embed';
+  if (/document-viewer/.test(source)) return 'document';
+  if (/image-viewer/.test(source)) return 'image';
+  if (/media-viewer/.test(source)) return 'gallery';
+  if (/project-demo/.test(source)) return 'demo';
+  return 'full';
+}
+
+function mediaLabel(node) {
+  const attributes = node.attribs || {};
+  const label = attributes.alt || attributes.title || attributes['aria-label'] || attributes['data-document-title'];
+  if (label) return label;
+  for (const child of node.children || []) {
+    if (['template', 'noscript'].includes(child.name)) continue;
+    const nested = mediaLabel(child);
+    if (nested) return nested;
+  }
+  return '';
+}
+
+export function dataSaverHtml(html, config, manifest = {}) {
+  if (!/<html\b/i.test(html)) return html;
+  if (!config.site.dataSaver?.enabled) {
+    if (config.site.dataSaver?.debug) return html;
+    const language = html.match(/<html\b[^>]*\blang=["']([^"']+)/i)?.[1] || config.i18n.defaultLocale;
+    const settings = JSON.stringify({ enabled: false, notFoundUrl: localizedUrl(config, language, '404.html') }).replace(/</g, '\\u003c');
+    const source = escape(manifest['/edgepress/data-saver.js'] || '/edgepress/data-saver.js');
+    return html.replace(/(<meta\b[^>]*charset[^>]*>|<head\b[^>]*>)/i, '$1<script id="edgepress-data-saver-config" type="application/json">' + settings + '</script><script src="' + source + '"></script>');
+  }
+  const document = parseDocument(html, { withStartIndices: true, withEndIndices: true });
+  const patches = [];
+  let head;
+  let body;
+  let firstImage;
+  const textScripts = [];
+  const fullStyles = [];
+  let locale = config.i18n.defaultLocale;
+  const visit = node => {
+    const name = node.name;
+    const attributes = node.attribs || {};
+    if (name === 'html') locale = attributes.lang || locale;
+    if (name === 'head') head = node;
+    if (name === 'body') body = node;
+    if (['template', 'noscript', 'svg'].includes(name)) return;
+    const original = html.slice(node.startIndex, node.endIndex + 1);
+    let resource = '';
+    if (name === 'link' && (['preload', 'modulepreload', 'prefetch', 'preconnect', 'dns-prefetch', 'stylesheet'].includes(attributes.rel))) resource = 'style';
+    if (name === 'script' && attributes.src) resource = 'script';
+    if (resource) {
+      if (resource === 'style' && attributes.rel === 'stylesheet' && featureFor(attributes.href || '') !== 'fonts' && !essentialStyles.test(attributes.href)) {
+        try {
+          if (new URL(attributes.href,config.site.url).origin === new URL(config.site.url).origin) fullStyles.push({href:attributes.href,rel:'preload',as:'style'});
+        } catch {}
+      }
+      const coreScripts = config.dataSaverCore?.scripts || [];
+      if (resource === 'script' && coreScripts.some(path => (manifest[path] || path) === attributes.src)) {
+        patches.push({ start:node.startIndex, end:node.endIndex + 1, text:'<noscript>' + original + '</noscript>' });
+        return;
+      }
+      if (resource === 'style' && essentialStyles.test(attributes.href)) {
+        patches.push({ start:node.startIndex, end:node.endIndex + 1, text:'<noscript>' + original + '</noscript>' });
+        return;
+      }
+      const core = resource === 'script' && !optionalScripts.test(attributes.src) && attributes['data-data-optional'] === undefined || resource === 'style' && essentialStyles.test(attributes.href);
+      if (core && resource === 'script') {
+        try {
+          if (new URL(attributes.src,config.site.url).origin === new URL(config.site.url).origin) textScripts.push({href:attributes.src,rel:attributes.type === 'module' ? 'modulepreload' : 'preload',...(attributes.type === 'module' ? {} : {as:'script'})});
+        } catch {}
+      }
+      patches.push({ start: node.startIndex, end: node.endIndex + 1, text: '<template data-edgepress-data-resource="' + resource + '" data-data-feature="' + (core ? 'core' : featureFor(attributes.src || attributes.href || '')) + '">' + original + '</template><noscript>' + original + '</noscript>' });
+      return;
+    }
+    if (['img', 'picture', 'video', 'audio', 'iframe'].includes(name) || attributes['data-edgepress-document'] !== undefined || attributes['data-edgepress-media-viewer'] !== undefined || attributes['data-edgepress-video'] !== undefined || attributes['data-project-demo'] !== undefined) {
+      const candidate = name === 'picture' ? node.children?.find(child => child.name === 'img')?.attribs : name === 'img' ? attributes : null;
+      if (!firstImage && candidate?.fetchpriority === 'high') {
+        const source = name === 'picture' ? node.children?.find(child => child.name === 'source')?.attribs : null;
+        const href = source?.srcset?.split(',')[0].trim().split(/\s+/)[0] || candidate.src;
+        try {
+          if (new URL(href,config.site.url).origin === new URL(config.site.url).origin) firstImage = {href,srcset:source?.srcset || candidate.srcset,sizes:source?.sizes || candidate.sizes,type:source?.type};
+        } catch {}
+      }
+      const label = mediaLabel(node);
+      const tag = name === 'img' || name === 'picture' ? 'span' : 'div';
+      const feature = attributes['data-edgepress-document'] !== undefined ? 'document' : attributes['data-edgepress-media-viewer'] !== undefined || attributes['data-edgepress-video'] !== undefined ? 'gallery' : attributes['data-project-demo'] !== undefined ? 'demo' : name === 'img' || name === 'picture' ? 'image' : 'media';
+      const classes = attributes.class || '';
+      const pictureImage = name === 'picture' ? node.children?.find(child => child.name === 'img')?.attribs : null;
+      const decorative = feature === 'image' && (attributes.alt === '' || pictureImage?.alt === '' || attributes['aria-hidden'] === 'true' || ['none', 'presentation'].includes(attributes.role) || /(?:^|\s)(?:navigation-icon|icon-library|brand-mark)(?:\s|$)/.test(classes));
+      const brand = feature === 'image' && /(?:^|\s)brand-wordmark(?:\s|$)/.test(classes);
+      patches.push({ start: node.startIndex, end: node.endIndex + 1, text: '<' + tag + ' class="edgepress-data-placeholder' + (brand ? ' edgepress-data-brand' : '') + '" data-edgepress-data-media data-data-feature="' + feature + '"' + (decorative ? ' data-data-decorative' : '') + (brand ? ' data-data-brand' : '') + '><span data-data-description>' + escape(label) + '</span><template data-edgepress-data-html>' + escape(original) + '</template><noscript>' + original + '</noscript></' + tag + '>' });
+      return;
+    }
+    for (const child of node.children || []) visit(child);
+  };
+  visit(document);
+  if (!head || !body) return html;
+  const keys = ['load', 'loading', 'loadingNotice', 'loadFailed', 'retry', 'progressStyles', 'progressControls', 'progressMedia', 'slowTitle', 'slowNotice', 'switchText', 'keepFull', 'returnFull', 'textNotice', 'missingDescription'];
+  const labels = Object.fromEntries(keys.map(key => [key, translate(config, locale, 'dataSaver' + key[0].toUpperCase() + key.slice(1))]));
+  const textPreloads = [{href:manifest['/edgepress/data-saver-layout.css'] || '/edgepress/data-saver-layout.css',rel:'preload',as:'style'}, ...(config.dataSaverCore ? [{href:manifest[config.dataSaverCore.path] || config.dataSaverCore.path,rel:'modulepreload'}] : []), ...textScripts];
+  const settings = JSON.stringify({ ...config.site.dataSaver, labels, textPreloads, fullPreloads:[...fullStyles,...textPreloads], firstImage, notFoundUrl: localizedUrl(config, locale, '404.html') }).replace(/</g, '\\u003c');
+  const asset = path => escape(manifest[path] || path);
+  const variant = config.dataSaverTheme;
+  if (!variant) throw new Error('Missing data-saving theme variant');
+  const coreStyle = path => '<template data-edgepress-data-resource="style" data-data-feature="core"><link rel="stylesheet" href="' + asset(path) + '"></template><noscript><link rel="stylesheet" href="' + asset(path) + '"></noscript>';
+  const inline = dataSaverInlineAssets(config);
+  const bundledControls = config.dataSaverCore ? '<template data-edgepress-data-resource="script" data-data-feature="core"><script type="module" src="' + asset(config.dataSaverCore.path) + '"></script></template>' : '';
+  const bootstrap = '<script id="edgepress-data-saver-config" type="application/json">' + settings + '</script><style data-edgepress-data-critical>' + inline.style + '</style><script data-edgepress-data-runtime="' + asset('/edgepress/data-saver.js') + '">' + inline.script + '</script>' + coreStyle('/edgepress/data-saver-layout.css') + bundledControls + variant.scripts.map(file => '<template data-edgepress-data-resource="script" data-data-feature="core"><script src="' + asset('/' + file) + '"></script></template><noscript><script defer src="' + asset('/' + file) + '"></script></noscript>').join('');
+  const charset = head.children?.find(node => node.name === 'meta' && node.attribs?.charset);
+  const headPosition = charset ? charset.endIndex + 1 : html.indexOf('>', head.startIndex) + 1;
+  patches.push({ start: headPosition, end: headPosition, text: bootstrap });
+  const waiting = '<div class="edgepress-data-wait" data-data-wait hidden><div class="edgepress-data-progress"><p role="status" data-data-progress-label>' + escape(labels.loading) + '</p><progress data-data-progress aria-label="' + escape(labels.loading) + '"></progress></div><aside class="edgepress-data-offer" data-data-offer aria-labelledby="edgepress-data-offer-title" hidden><h2 id="edgepress-data-offer-title">' + escape(labels.loading) + '</h2><p data-data-loading-notice>' + escape(labels.loadingNotice) + '</p><div><button type="button" data-data-mode="text">' + escape(labels.switchText) + '</button><button type="button" data-data-dismiss>' + escape(labels.keepFull) + '</button><button type="button" data-data-retry hidden>' + escape(labels.retry) + '</button></div></aside></div>';
+  const bodyPosition = html.indexOf('>', body.startIndex) + 1;
+  patches.push({ start: bodyPosition, end: bodyPosition, text: waiting });
+  const controls = '<aside class="edgepress-data-return" data-data-return hidden><span>' + escape(labels.textNotice) + '</span><button type="button" data-data-mode="full">' + escape(labels.returnFull) + '</button></aside>';
+  patches.push({ start: body.endIndex - 6, end: body.endIndex - 6, text: controls });
+  patches.sort((first, second) => second.start - first.start);
+  for (const patch of patches) html = html.slice(0, patch.start) + patch.text + html.slice(patch.end);
+  return html;
+}

package/src/deploy.js

@@ -0,0 +1,28 @@
+import {spawn} from 'node:child_process';
+import {existsSync} from 'node:fs';
+import {delimiter,dirname,resolve} from 'node:path';
+export function deploymentCommand(platform, output = 'dist', args = []) {
+  switch (platform) {
+    case 'cloudflare': return ['wrangler', 'deploy', ...args];
+    case 'netlify': return ['netlify-cli', 'deploy', '--prod', '--dir', output, ...args];
+    case 'vercel': return ['vercel', 'deploy', '--prod', ...args];
+    case 'edgeone': return ['edgeone', 'pages', 'deploy', output, ...args];
+    case 'esa': return ['esa-cli', 'deploy', '--assets', output, ...args];
+    default: throw new Error('Platform must be cloudflare, netlify, vercel, edgeone, or esa');
+  }
+}
+export async function deploySite(platform, output, args) {
+  const command = deploymentCommand(platform, output, args);
+  // npm exec resolves platform CLIs locally or installs them; platform authentication remains in its CLI.
+  const windows = process.platform === 'win32';
+  const executable = windows ? process.execPath : 'npm';
+  const candidates = [process.env.npm_execpath?.replace(/npx-cli\.js$/i,'npm-cli.js'), ...[dirname(process.execPath),...(process.env.PATH || process.env.Path || '').split(delimiter)].map(directory=>resolve(directory,'node_modules/npm/bin/npm-cli.js'))];
+  const npmCli = windows ? candidates.find(candidate=>candidate && existsSync(candidate)) : null;
+  if(windows && !npmCli)throw new Error('npm CLI was not found. Install Node.js with npm or run deployment from npm run.');
+  const parameters = [...(windows ? [npmCli] : []), 'exec', '--yes', '--', ...command];
+  await new Promise((resolve, reject) => {
+    const child = spawn(executable, parameters, {stdio:'inherit', windowsHide:true});
+    child.once('error', reject);
+    child.once('exit', code => code === 0 ? resolve() : reject(new Error(platform + ' deployment failed: ' + code)));
+  });
+}

package/src/document.js

@@ -0,0 +1,44 @@
+import { documentFormat, documentUrl } from '@jsw-teams/document-viewer';
+import { translate, translateValue } from './i18n.js';
+
+const escape = value => String(value ?? '').replace(/[&<>"']/g, char => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' }[char]));
+
+export function parseDocument(source) {
+  const match = String(source).match(/^ {0,3}!document\[([^\]\r\n]+)\]\(([^\s<>]+)\)(?:\{([^}\r\n]*)\})?[\t ]*(?:\r?\n|$)/i);
+  if (!match) return null;
+  const attributes = {};
+  for (const field of (match[3] || '').trim().split(/\s+/).filter(Boolean)) {
+    const parts = field.match(/^(format|service)=([a-z0-9_-]+)$/i);
+    if (!parts || Object.hasOwn(attributes, parts[1])) throw new Error('Document syntax accepts format=pdf and service=registered-id');
+    attributes[parts[1]] = parts[2];
+  }
+  return { raw: match[0], title: match[1], src: match[2], ...attributes };
+}
+
+export function renderDocument(block, { config, locale }) {
+  const allowed = new Set(['type', 'src', 'title', 'format', 'service', 'previewSrc', 'caption', 'raw', 'tokens']);
+  for (const key of Object.keys(block)) if (!allowed.has(key)) throw new Error('Unsupported document field: ' + key);
+  const title = String(block.title || '').trim();
+  if (!title || title.length > 500) throw new Error('Documents need a descriptive title of 1 to 500 characters');
+  const base = config.site?.url || 'https://document.invalid';
+  const source = documentUrl(block.src, base);
+  const preview = documentUrl(block.previewSrc || block.src, base);
+  const format = documentFormat(preview.href, block.format);
+  if (!format) throw new Error('Unsupported document format; use format for extensionless URLs');
+  let service = null;
+  const origins = [...new Set([source.origin, preview.origin].filter(origin => origin !== new URL(base).origin))];
+  if (block.service || origins.length) {
+    service = config.browserPlugins?.services?.find(item => item.id === block.service || (!block.service && item.provider === 'external-api' && item.backendUrl && origins.every(origin => origin === new URL(item.backendUrl).origin)));
+    if (!service || service.provider !== 'external-api') throw new Error('Remote documents need a registered external-api consent service');
+    const permitted = new Set([new URL(service.backendUrl).origin, ...(service.csp?.['connect-src'] || [])]);
+    if (origins.some(origin => !permitted.has(origin))) throw new Error('Document URL must use its registered service origin');
+  }
+  const unavailable = escape(translate(config, locale, 'documentViewerError'));
+  if (service?.enabled === false) return '<figure class="document-block"><figcaption>' + escape(title) + '</figcaption><p>' + unavailable + '</p></figure>';
+  const caption = block.caption ? '<p>' + escape(block.caption) + '</p>' : '';
+  const consent = service ? '<p>' + escape(translateValue(config, locale, service.purpose)) + '</p><button type="button" data-service-consent-settings>' + escape(translate(config, locale, 'privacySettings')) + '</button>' : '';
+  return '<figure class="document-block" aria-label="' + escape(title) + '" data-edgepress-document data-document-src="' + escape(block.src) + '" data-document-title="' + escape(title) + '" data-document-format="' + format + '"' +
+    (block.previewSrc ? ' data-document-preview="' + escape(block.previewSrc) + '"' : '') +
+    (service ? ' data-document-service="' + escape(service.id) + '"' : '') + '>' + consent +
+    '<div data-document-mount><p>' + escape(translate(config, locale, 'documentViewerLoading')) + '</p></div><noscript><p>' + unavailable + '</p></noscript>' + caption + '</figure>';
+}

package/src/embed.js

@@ -0,0 +1,60 @@
+import {sourceOrigins, resolveEmbed} from './oembed.js';
+import {translate, translateValue} from './i18n.js';
+import {parseDocument, renderDocument} from './document.js';
+
+const escapeHtml = value => String(value ?? '').replace(/[&<>"']/g, char => ({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'}[char]));
+
+// Embeds occupy their own line, so they never create figures inside paragraphs.
+// Marked handles code fences and escaped examples before this block tokenizer.
+export function parseEmbed(source) {
+  const match = String(source).match(/^ {0,3}!embed\[([a-z0-9_-]+)\]\(([^\s<>]+)\)[\t ]*(?:\r?\n|$)/i);
+  return match ? {raw: match[0], integration: match[1], url: match[2]} : null;
+}
+
+export async function renderEmbed(block, {config, locale}) {
+  const service = config.browserPlugins?.services?.find(item => item.id === block.integration);
+  if (!service || service.provider !== 'oembed') throw new Error('Embed requires a registered oembed service: ' + block.integration);
+  const address = new URL(block.url);
+  if (address.protocol !== 'https:' || !sourceOrigins(service).includes(address.origin) || address.username || address.password || /[\x00-\x20\\]/.test(block.url)) {
+    throw new Error('Embed URL must use its registered HTTPS service origin');
+  }
+  const provider = translateValue(config, locale, service.name || service.id);
+  let label = String(block.title || provider);
+  if (label.length > 200) throw new Error('Embed title must contain at most 200 characters');
+  const notice = key => escapeHtml(translate(config, locale, key).replace('{service}', provider));
+  const link = '<a href="' + escapeHtml(address.href) + '" target="_blank" rel="noopener noreferrer">' + escapeHtml(label) + '</a>';
+  const match = service.embedPathPattern ? address.pathname.match(new RegExp(service.embedPathPattern)) : null;
+  if (service.embedPathPattern && !match?.[1]) throw new Error('Embed URL does not match the configured content path');
+  for (const field of ['width', 'height']) {
+    if (block[field] !== undefined && (!Number.isInteger(block[field]) || block[field] < 60 || block[field] > 4096)) throw new Error('Embed ' + field + ' must be from 60 to 4096');
+  }
+  if (service.enabled === false) return '<figure class="edgepress-oembed" data-oembed-disabled><figcaption>' + link + '</figcaption><p role="status">' + notice('embedDisabled') + '</p></figure>';
+  const data = service.embedTemplate ? {version:'1.0', type:'rich', title:label, width:640, height:480, html:'<iframe src="' + escapeHtml(service.embedTemplate.replaceAll('{url}', encodeURIComponent(address.href)).replaceAll('{path}', address.pathname).replaceAll('{id}', encodeURIComponent(match?.[1] || ''))) + '"></iframe>'} :
+    service.oembedEndpoint ? await resolveEmbed(service, address.href, config) : undefined;
+  if (!block.title && data?.title) label = String(data.title).slice(0, 200);
+  const heading = '<a href="' + escapeHtml(address.href) + '" target="_blank" rel="noopener noreferrer">' + escapeHtml(label) + '</a>';
+  const dimensions = ' data-oembed-width="' + (block.width || data?.width || 640) + '" data-oembed-height="' + (block.height || data?.height || 480) + '"';
+  const caption = block.caption ? '<p class="oembed-caption">' + escapeHtml(block.caption) + '</p>' : '';
+  return '<figure class="edgepress-oembed" data-edgepress-oembed="' + escapeHtml(service.id) + '" data-oembed-url="' + escapeHtml(address.href) + '"' + dimensions +
+    (data === null ? ' data-oembed-unavailable="true"' : '') + '><figcaption>' + heading + '</figcaption><p data-oembed-notice role="status">' + notice(data === null ? 'embedUnavailable' : 'embedNeedsConsent') + '</p>' +
+    (data !== null ? '<button type="button" data-oembed-load>' + escapeHtml(translate(config, locale, 'loadMedia')) + '</button>' : '') +
+    '<div data-oembed-status><div class="oembed-placeholder" data-oembed-placeholder aria-hidden="true"></div></div>' + caption +
+    (data ? '<template data-oembed-data>' + escapeHtml(JSON.stringify(data)) + '</template>' : '') + '</figure>';
+}
+
+// Pages retain escaped text; only standalone embed lines receive special syntax.
+export async function renderPageText(source, context) {
+  const output = [], lines = String(source).split(/\r?\n/);
+  let paragraph = [];
+  const flush = () => { if (paragraph.length) output.push('<p>' + escapeHtml(paragraph.join('\n')) + '</p>'); paragraph = []; };
+  for (const line of lines) {
+    const document = parseDocument(line);
+    if (document) { flush(); output.push(renderDocument(document, context)); continue; }
+    const embed = parseEmbed(line);
+    if (embed) { flush(); output.push(await renderEmbed(embed, context)); }
+    else if (!line.trim()) flush();
+    else paragraph.push(line);
+  }
+  flush();
+  return output.join('');
+}