fix: make remote image processing optional via PROCESS_REMOTE_IMAGES

Default "false" — adds eleventy:ignore to remote <img> tags via a
posthtml plugin (priority 1) that runs before eleventy-img (priority -1).
Sharp only processes local images, avoiding OOM from downloading and
decoding hundreds of external images.

Set PROCESS_REMOTE_IMAGES=true to restore previous behavior.

Confab-Link: http://localhost:8080/sessions/0ec83454-d346-4329-8aaf-6b12139bf596

eleventy.config.js

@@ -229,17 +229,29 @@ export default function (eleventyConfig) {
   });
 
   // Image optimization - transforms <img> tags automatically
-  // transformOnRequest: in watch/serve mode, process images on-demand instead of all
+  // PROCESS_REMOTE_IMAGES: set to "true" to let Sharp download and re-encode remote images.
-  // at once during rebuild — prevents Sharp from saturating memory with parallel decodes.
+  // Default "false" — skips remote URLs (adds eleventy:ignore) to avoid OOM from Sharp's
-  // cacheOptions: cache remote image fetches to disk so restarts don't re-download everything.
+  // native memory usage when processing hundreds of external images (bookmarks, webmentions).
-  // concurrency: limit parallel Sharp operations (default scales to CPU count, ~10 on this
+  const processRemoteImages = process.env.PROCESS_REMOTE_IMAGES === "true";
-  // server). Each large remote image can consume 20-50MB of native memory outside V8 heap.
+  if (!processRemoteImages) {
+    eleventyConfig.htmlTransformer.addPosthtmlPlugin("html", () => {
+      return (tree) => {
+        tree.match({ tag: "img" }, (node) => {
+          if (node.attrs?.src && /^https?:\/\//.test(node.attrs.src)) {
+            node.attrs["eleventy:ignore"] = "";
+          }
+          return node;
+        });
+        return tree;
+      };
+    }, { priority: 1 }); // priority > 0 runs before image plugin (priority -1)
+  }
+
   eleventyConfig.addPlugin(eleventyImageTransformPlugin, {
     extensions: "html",
     formats: ["webp", "jpeg"],
     widths: ["auto"],
     failOnError: false,
-    transformOnRequest: process.env.ELEVENTY_RUN_MODE !== "build",
     cacheOptions: {
       duration: process.env.ELEVENTY_RUN_MODE === "build" ? "1d" : "30d",
     },