edgepress 2026.9.3

package/languages/base/en.json

@@ -0,0 +1,55 @@
+{
+  "home": "Home",
+  "archives": "Archives",
+  "noPosts": "No posts yet",
+  "newer": "Newer posts",
+  "older": "Older posts",
+  "tags": "Tags",
+  "tag": "Tag",
+  "notFound": "Page not found",
+  "notFoundText": "The page you requested does not exist.",
+  "forbidden": "Access denied",
+  "forbiddenText": "You do not have permission to access this page.",
+  "returnHome": "Return home",
+  "allPosts": "All posts",
+  "searchPosts": "Search articles",
+  "searchIntro": "Search the Markdown articles published on this site. Search runs locally in your browser.",
+  "searchLabel": "Search articles",
+  "searchButton": "Search",
+  "searchHint": "Enter one or more words from an article title or text.",
+  "searchPrompt": "Enter a search term to find articles.",
+  "searchNeedsJavaScript": "Article search needs JavaScript enabled. The search index stays on this site.",
+  "searchNoResults": "No matching articles.",
+  "searchResults": "Matching articles",
+  "searchResultCount": "Matching articles: {count}.",
+  "markdownTaskComplete": "Task complete",
+  "markdownTaskIncomplete": "Task incomplete",
+  "feed": "Atom feed",
+  "languageName": "English",
+  "mainNavigationLabel": "Main navigation",
+  "footerNavigationLabel": "Footer navigation",
+  "languageLabel": "Language",
+  "skipToContent": "Skip to content",
+  "pagination": "Pagination",
+  "pages": "Project pages",
+  "latestPosts": "Latest posts",
+  "privacySettings": "Privacy settings",
+  "privacyNotice": "Optional services",
+  "privacyIntro": "Choose which optional services may load. Nothing is enabled until you save or accept your choices.",
+  "acceptOptional": "Accept all",
+  "rejectOptional": "Reject optional",
+  "savePreferences": "Save choices",
+  "optionalServices": "Optional services",
+  "noIntegrations": "No optional services are configured.",
+  "privacyPolicy": "Privacy policy",
+  "privacyController": "Site operator",
+  "servicePurpose": "Purpose",
+  "serviceRetention": "Retention",
+  "pluginTracking": "Tracking",
+  "pluginStatistics": "Statistics",
+  "pluginAdvertising": "Advertising",
+  "pluginCaptcha": "Human verification",
+  "consentReload": "Your choice was saved. Reloading to apply the updated settings.",
+  "agentSummary": "Project guides and reference pages for the EdgePress website builder.",
+  "closePrivacy": "Close settings"
+}

package/languages/packs/zh-CN.json

@@ -0,0 +1,55 @@
+{
+  "home": "首页",
+  "archives": "归档",
+  "noPosts": "还没有文章",
+  "newer": "较新文章",
+  "older": "较早文章",
+  "tags": "标签",
+  "tag": "标签",
+  "notFound": "页面不存在",
+  "notFoundText": "你访问的页面不存在。",
+  "forbidden": "无权访问",
+  "forbiddenText": "你没有权限访问此页面。",
+  "returnHome": "返回首页",
+  "allPosts": "所有文章",
+  "searchPosts": "搜索文章",
+  "searchIntro": "搜索此网站发布的 Markdown 文章。搜索在你的浏览器本地运行。",
+  "searchLabel": "搜索文章",
+  "searchButton": "搜索",
+  "searchHint": "输入文章标题或正文中的一个或多个词。",
+  "searchPrompt": "输入搜索词以查找文章。",
+  "searchNeedsJavaScript": "文章搜索需要启用 JavaScript。搜索索引保存在此网站。",
+  "searchNoResults": "没有找到匹配的文章。",
+  "searchResults": "匹配的文章",
+  "searchResultCount": "匹配文章数：{count}。",
+  "markdownTaskComplete": "任务已完成",
+  "markdownTaskIncomplete": "任务未完成",
+  "feed": "Atom 订阅",
+  "languageName": "简体中文",
+  "mainNavigationLabel": "主导航",
+  "footerNavigationLabel": "页脚导航",
+  "languageLabel": "语言",
+  "skipToContent": "跳转到正文",
+  "pagination": "分页导航",
+  "pages": "项目文档",
+  "latestPosts": "最新文章",
+  "privacySettings": "隐私设置",
+  "privacyNotice": "可选服务",
+  "privacyIntro": "请选择允许加载的可选服务。保存或接受之前，不会启用任何服务。",
+  "acceptOptional": "全部接受",
+  "rejectOptional": "拒绝可选服务",
+  "savePreferences": "保存选择",
+  "optionalServices": "可选服务",
+  "noIntegrations": "尚未配置可选服务。",
+  "privacyPolicy": "隐私政策",
+  "privacyController": "网站运营者",
+  "servicePurpose": "用途",
+  "serviceRetention": "保留期限",
+  "pluginTracking": "跟踪",
+  "pluginStatistics": "统计",
+  "pluginAdvertising": "广告",
+  "pluginCaptcha": "人机验证",
+  "consentReload": "选择已保存，正在重新载入以应用设置。",
+  "agentSummary": "EdgePress 网站构建器的项目指南与参考文档。",
+  "closePrivacy": "关闭设置"
+}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "edgepress",
+  "version": "2026.9.3",
+  "description": "A static website builder for Cloudflare Workers with editable pages, Markdown posts, local search, themes, and consent-gated integrations.",
+  "type": "module",
+  "bin": {
+    "edgepress": "src/cli.js"
+  },
+  "files": [
+    "content",
+    "languages",
+    "plugins",
+    "src",
+    "static",
+    "templates",
+    "themes",
+    "config.yml",
+    "edgepress.config.mjs",
+    "project-compatibility.json",
+    "wrangler.jsonc",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jsw-teams/edgepress.git"
+  },
+  "homepage": "https://github.com/jsw-teams/edgepress#readme",
+  "keywords": [
+    "static-site-generator",
+    "cloudflare-workers",
+    "markdown",
+    "website-builder",
+    "accessibility"
+  ],
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "scripts": {
+    "new": "node src/cli.js new",
+    "build": "node src/cli.js build",
+    "generate": "node src/cli.js generate",
+    "dev": "node src/cli.js server",
+    "preview": "node src/cli.js server",
+    "deploy": "node src/cli.js deploy",
+    "clean": "node src/cli.js clean",
+    "check": "node src/cli.js check",
+    "doctor": "node src/cli.js doctor",
+    "iterate": "node src/cli.js iterate",
+    "security:check": "node src/cli.js security"
+  },
+  "dependencies": {
+    "marked": "^18.0.13",
+    "sanitize-html": "^2.17.7",
+    "yaml": "^2.9.1"
+  },
+  "devDependencies": {
+    "wrangler": "^4.129.1"
+  }
+}

package/plugins/consent/index.js

@@ -0,0 +1,40 @@
+function translate(config, locale, key) {
+  const base = config.i18n.translationsByLocale?.[config.i18n.defaultLocale];
+  const selected = config.i18n.translationsByLocale?.[locale];
+  return selected?.[key] ?? base?.[key] ?? key;
+}
+
+function localizedUrl(config, locale, path) {
+  const prefix = locale === config.i18n.defaultLocale ? '' : '/' + locale;
+  const suffix = String(path ?? '').replace(/^\/+/, '');
+  return prefix + '/' + suffix;
+}
+
+function safeJson(value) {
+  return JSON.stringify(value).replace(/</g, '\\u003c').replace(/&/g, '\\u0026').replace(/\u2028/g, '\\u2028').replace(/\u2029/g, '\\u2029');
+}
+
+export default function consentManager(api) {
+  api.registerFilter('html:afterLayout', (html, { config, page }) => {
+    if (!config.browserPlugins.consent.enabled) return html;
+    const locale = page?.locale || config.i18n.defaultLocale;
+    const ui = Object.fromEntries([
+      'privacySettings', 'privacyNotice', 'privacyIntro', 'acceptOptional', 'rejectOptional',
+      'savePreferences', 'optionalServices', 'noIntegrations', 'privacyPolicy', 'privacyController',
+      'servicePurpose', 'serviceRetention', 'consentReload', 'closePrivacy'
+    ].map((key) => [key, translate(config, locale, key)]));
+    const services = ['tracking', 'statistics', 'advertising', 'captcha'].flatMap((group) =>
+      config.browserPlugins[group].enabled ? config.browserPlugins[group].services.map((service) => ({ ...service, category: group })) : []
+    );
+    const privacy = {
+      ...config.privacy,
+      consent: config.browserPlugins.consent,
+      integrations: services
+    };
+    if (privacy.policyUrl.startsWith('/')) privacy.policyUrl = localizedUrl(config, locale, privacy.policyUrl);
+    const payload = safeJson({ privacy, ui, siteLanguage: locale });
+    const integration = '<script type="application/json" id="edgepress-privacy-config">' + payload + '</script>' +
+      '<script src="/edgepress/plugins/consent/manager.js" defer></script>';
+    return html.replace(/<\/body\s*>/i, integration + '</body>');
+  });
+}

package/project-compatibility.json

@@ -0,0 +1,48 @@
+{
+  "schemaVersion": 1,
+  "frameworkVersion": "2026.9.3",
+  "requirements": {
+    "nodeMajor": 22,
+    "nodeMinimumVersion": "22.12.0",
+    "minimumWorkersDate": "2024-09-23",
+    "workerRuntime": "ES modules and Web APIs",
+    "nodeCompatibilityRequired": false,
+    "pluginApiMajor": 1
+  },
+  "features": [
+    { "name": "Static generation and content-hash cache", "stage": "stable", "since": "2026.9.1" },
+    { "name": "Cloudflare Static Assets deployment", "stage": "stable", "since": "2026.9.1" },
+    { "name": "Row-based editable pages and reusable layout components", "stage": "experimental", "since": "2026.9.1" },
+    { "name": "Image/video with text and display typography elements", "stage": "experimental", "since": "2026.9.1" },
+    { "name": "i18n locale routes", "stage": "experimental", "since": "2026.9.1" },
+    { "name": "Accessibility and agent-friendliness report with screenshots and PDF", "stage": "experimental", "since": "2026.9.1" },
+    { "name": "Consent-gated browser plugins", "stage": "experimental", "since": "2026.9.1" },
+    { "name": "Service binding and URL/token backend proxy", "stage": "experimental", "since": "2026.9.1" },
+    { "name": "Live local preview and theme switching", "stage": "experimental", "since": "2026.9.1" },
+    { "name": "Report-only maintenance iteration", "stage": "experimental", "since": "2026.9.1" },
+    { "name": "Local browser search across Markdown posts", "stage": "experimental", "since": "2026.9.2" },
+    { "name": "Markdown syntax verification and responsive post screenshots", "stage": "experimental", "since": "2026.9.2" },
+    { "name": "Compact localized language selector", "stage": "experimental", "since": "2026.9.2" },
+    { "name": "npm theme installation and blank theme scaffolds", "stage": "experimental", "since": "2026.9.3" }
+  ],
+  "releaseHistory": [
+    {
+      "version": "2026.9.1",
+      "date": "2026-09-24",
+      "request": 1,
+      "notes": "Introduced row-first editable pages, shared theme components, plugin and backend guidance, live preview, and visual audit reports."
+    },
+    {
+      "version": "2026.9.2",
+      "date": "2026-09-25",
+      "request": 2,
+      "notes": "Improved mobile layouts, added local article search and a compact language menu, verified the bilingual Markdown guide, and made the report cover posts with accessible PDF reading structure."
+    },
+    {
+      "version": "2026.9.3",
+      "date": "2026-09-25",
+      "request": 3,
+      "notes": "Published EdgePress for npm installation, added npm theme installation and blank theme packages, documented GitHub and Cloudflare Workers Builds deployment, and added a Cloudflare one-click deployment button."
+    }
+  ]
+}

package/src/assets.js

@@ -0,0 +1,181 @@
+import { createHash } from 'node:crypto';
+import { copyFile, readdir, readFile, writeFile, mkdir } from 'node:fs/promises';
+import { dirname, extname, relative, resolve, sep } from 'node:path';
+import * as posix from 'node:path/posix';
+import { mapLimit } from './concurrency.js';
+
+async function walk(directory) {
+  let entries;
+  try { entries = await readdir(directory, { withFileTypes: true }); }
+  catch (error) { if (error.code === 'ENOENT') return []; throw error; }
+  const files = [];
+  for (const entry of entries) {
+    const full = resolve(directory, entry.name);
+    if (entry.isDirectory()) files.push(...await walk(full));
+    else if (entry.isFile()) files.push(full);
+  }
+  return files;
+}
+
+function isCodeAsset(path) {
+  const extension = extname(path).toLowerCase();
+  return extension === '.css' || extension === '.js';
+}
+
+function referencedPaths(path, content, known) {
+  if (!isCodeAsset(path)) return [];
+  const text = content.toString('utf8');
+  const expression = extname(path).toLowerCase() === '.js'
+    ? /\b(?:from\s*|import\s*(?:\(\s*)?)['"]([^'"]+)['"]/g
+    : /(?:@import\s+(?:url\()?\s*|url\(\s*)['"]?([^'")\s;]+)['"]?\s*\)?/gi;
+  const refs = [];
+  for (const match of text.matchAll(expression)) {
+    const specifier = match[1];
+    if (/^(?:[a-z]+:|\/\/|#)/i.test(specifier)) continue;
+    const clean = specifier.split(/[?#]/, 1)[0];
+    const target = clean.startsWith('/')
+      ? clean.slice(1)
+      : posix.normalize(posix.join(posix.dirname(path), clean));
+    if (known.has(target) && isCodeAsset(target)) refs.push(target);
+  }
+  return [...new Set(refs)];
+}
+
+function rewriteCodeReferences(item, text, outputByOriginal) {
+  const extension = extname(item.path).toLowerCase();
+  const rewriteSpecifier = (specifier) => {
+    if (/^(?:[a-z]+:|\/\/|#)/i.test(specifier)) return null;
+    const splitAt = specifier.search(/[?#]/);
+    const clean = splitAt < 0 ? specifier : specifier.slice(0, splitAt);
+    const tail = splitAt < 0 ? '' : specifier.slice(splitAt);
+    const target = clean.startsWith('/')
+      ? clean.slice(1)
+      : posix.normalize(posix.join(posix.dirname(item.path), clean));
+    const outputTarget = outputByOriginal.get(target);
+    if (!outputTarget) return null;
+    let rewritten;
+    if (clean.startsWith('/')) rewritten = '/' + outputTarget;
+    else {
+      rewritten = posix.relative(posix.dirname(item.outputPath), outputTarget);
+      if (!rewritten.startsWith('.')) rewritten = './' + rewritten;
+    }
+    return rewritten + tail;
+  };
+
+  if (extension === '.js') {
+    const expression = /(\b(?:from\s*|import\s*(?:\(\s*)?))(['"])([^'"]+)\2/g;
+    return text.replace(expression, (match, prefix, quote, specifier) => {
+      const rewritten = rewriteSpecifier(specifier);
+      return rewritten === null ? match : prefix + quote + rewritten + quote;
+    });
+  }
+
+  const expression = /((?:@import\s+(?:url\()?\s*|url\(\s*))(['"]?)([^)'"\s;]+)(['"]?\s*\)?)/gi;
+  return text.replace(expression, (match, prefix, quote, specifier, suffix) => {
+    const rewritten = rewriteSpecifier(specifier);
+    return rewritten === null ? match : prefix + quote + rewritten + suffix;
+  });
+}
+
+export async function collectAssets(config) {
+  const sources = [];
+  for (const source of await walk(config.resolvedPaths.static)) {
+    const path = relative(config.resolvedPaths.static, source).split(sep).join('/');
+    if (path.split('/').includes('.gitkeep')) continue;
+    sources.push({ source, path });
+  }
+  const themeAssets = resolve(config.resolvedPaths.theme, 'assets');
+  for (const source of await walk(themeAssets)) {
+    const path = relative(themeAssets, source).split(sep).join('/');
+    if (path.split('/').includes('.gitkeep')) continue;
+    sources.push({ source, path });
+  }
+
+  const headers = [];
+  const assetSources = [];
+  for (const item of sources) {
+    if (item.path.toLowerCase() === '_headers') headers.push(item);
+    else assetSources.push(item);
+  }
+  const [headerContents, items] = await Promise.all([
+    mapLimit(headers, config.concurrency, async (item) => (await readFile(item.source)).toString('utf8')),
+    mapLimit(assetSources, config.concurrency, async (item) => ({
+      ...item,
+      content: isCodeAsset(item.path) ? await readFile(item.source) : null
+    }))
+  ]);
+  const originals = new Set();
+  for (const item of items) {
+    const normalized = item.path.toLowerCase();
+    if (originals.has(normalized)) throw new Error('Static and theme assets have the same output path: ' + item.path);
+    originals.add(normalized);
+  }
+  const byOriginal = new Map(items.map((item) => [item.path, item]));
+  const dependencies = new Map();
+  for (const item of items) dependencies.set(item.path, referencedPaths(item.path, item.content, byOriginal));
+
+  const outputByOriginal = new Map();
+  for (const item of items) {
+    if (!isCodeAsset(item.path)) outputByOriginal.set(item.path, item.path);
+    else {
+      const reachable = new Set();
+      const visit = (path) => {
+        for (const dependency of dependencies.get(path) ?? []) {
+          if (reachable.has(dependency)) continue;
+          reachable.add(dependency);
+          visit(dependency);
+        }
+      };
+      visit(item.path);
+      const sourceDigests = [...reachable].sort().map((path) =>
+        path + ':' + createHash('sha256').update(byOriginal.get(path).content).digest('hex')
+      ).join('\n');
+      const digest = createHash('sha256')
+        .update(item.content)
+        .update('\n')
+        .update(sourceDigests)
+        .digest('hex')
+        .slice(0, 16);
+      const extension = extname(item.path).toLowerCase();
+      outputByOriginal.set(item.path, item.path.slice(0, -extname(item.path).length) + '.' + digest + extension);
+    }
+  }
+
+  const assets = items.map((item) => {
+    const outputPath = outputByOriginal.get(item.path);
+    if (!isCodeAsset(item.path)) return { path: outputPath, source: item.source };
+    const content = Buffer.from(rewriteCodeReferences(
+      { ...item, outputPath }, item.content.toString('utf8'), outputByOriginal
+    ), 'utf8');
+    return { path: outputPath, content };
+  });
+  const urlMap = Object.create(null);
+  for (const item of items) urlMap['/' + item.path] = '/' + outputByOriginal.get(item.path);
+  config.assetManifest = urlMap;
+  return { assets, urlMap, existingHeaders: headerContents.join('\n\n') };
+}
+
+export async function writeAssets(bundle, output, concurrency = 8) {
+  await mapLimit(bundle.assets, concurrency, async (asset) => {
+    const target = resolve(output, ...asset.path.split('/'));
+    await mkdir(dirname(target), { recursive: true });
+    if (asset.source) await copyFile(asset.source, target);
+    else await writeFile(target, asset.content);
+  });
+  const securityRules = '/*\n  X-Content-Type-Options: nosniff\n  Referrer-Policy: strict-origin-when-cross-origin';
+  const immutableRules = bundle.assets
+    .filter((asset) => /\.[a-f0-9]{16}\.(?:css|js)$/i.test(asset.path))
+    .map((asset) => '/' + asset.path + '\n  Cache-Control: public, max-age=31556952, immutable');
+  const headers = [bundle.existingHeaders.trim(), securityRules, ...immutableRules].filter(Boolean).join('\n\n') + '\n';
+  await writeFile(resolve(output, '_headers'), headers, 'utf8');
+}
+
+export function rewriteAssetLinks(html, urlMap) {
+  return html.replace(/(\b(?:src|href)\s*=\s*)(["'])([^"']+)\2/gi, (match, prefix, quote, value) => {
+    const suffixAt = value.search(/[?#]/);
+    const sourcePath = suffixAt < 0 ? value : value.slice(0, suffixAt);
+    const suffix = suffixAt < 0 ? '' : value.slice(suffixAt);
+    const replacement = urlMap[sourcePath];
+    return replacement ? prefix + quote + replacement + suffix + quote : match;
+  });
+}