@stati/core 1.27.2 → 1.28.0

package/dist/config/errors.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Error thrown when the Stati configuration is invalid.
+ * `loadConfig()` always rethrows it, because the build cannot proceed with a broken config.
+ */
+export declare class ConfigValidationError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/config/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/config/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI3D"}

package/dist/config/errors.js

@@ -0,0 +1,10 @@
+/**
+ * Error thrown when the Stati configuration is invalid.
+ * `loadConfig()` always rethrows it, because the build cannot proceed with a broken config.
+ */
+export class ConfigValidationError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'ConfigValidationError';
+    }
+}

package/dist/config/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AA6BrD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAqBD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAExD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,WAAW,CAAC,CA8GlF"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AA+BrD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAqBD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAExD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,WAAW,CAAC,CA8HlF"}

package/dist/config/loader.js

@@ -2,6 +2,8 @@ import { existsSync, statSync } from 'node:fs';
 import { join, resolve } from 'node:path';
 import { pathToFileURL } from 'node:url';
 import { validateISGConfig, ISGConfigurationError } from '../core/isg/validation.js';
+import { validateImagesConfig } from '../images/config.js';
+import { ConfigValidationError } from './errors.js';
 import { compileStatiConfig, cleanupCompiledConfig } from '../core/utils/index.js';
 import { DEFAULT_SRC_DIR, DEFAULT_OUT_DIR, DEFAULT_STATIC_DIR, DEFAULT_SITE_TITLE, DEFAULT_DEV_BASE_URL, DEFAULT_TTL_SECONDS, DEFAULT_MAX_AGE_CAP_DAYS, CONFIG_FILE_PATTERNS, } from '../constants.js';
 /**
@@ -139,6 +141,16 @@ export async function loadConfig(cwd = process.cwd()) {
             }
             throw error; // Re-throw non-ISG errors
         }
+        // Validate image configuration
+        try {
+            validateImagesConfig(mergedConfig.images);
+        }
+        catch (error) {
+            if (error instanceof ConfigValidationError) {
+                throw new ConfigValidationError(`Invalid images configuration in ${configPath}:\n${error.message}`, { cause: error });
+            }
+            throw error;
+        }
         // Cache the loaded config with its modification time
         try {
             const mtime = statSync(resolvedConfigPath).mtimeMs;
@@ -154,8 +166,9 @@ export async function loadConfig(cwd = process.cwd()) {
         return mergedConfig;
     }
     catch (error) {
-        if (error instanceof Error && error.message.includes('Invalid ISG configuration')) {
-            // ISG validation errors should bubble up with context
+        if (error instanceof ConfigValidationError ||
+            (error instanceof Error && error.message.includes('Invalid ISG configuration'))) {
+            // Validation errors bubble up with context: the build cannot proceed with an invalid config
             throw error;
         }
         console.error(`Error loading config from ${configPath}:`, error);

package/dist/constants.d.ts

@@ -82,4 +82,30 @@ export declare const DEFAULT_BUNDLES: readonly [{
     readonly entryPoint: "main.ts";
     readonly bundleName: "main";
 }];
+/** Output directory for generated and copied images, relative to the build output */
+export declare const IMAGES_OUTPUT_DIR = "_img";
+/** Subdirectory of {@link IMAGES_OUTPUT_DIR} for generated Open Graph images */
+export declare const OG_IMAGES_SUBDIR = "og";
+/** Cache subdirectory (inside `.stati`) holding the images manifest */
+export declare const IMAGES_CACHE_SUBDIR = "images";
+/** Package that implements responsive images and Open Graph image generation */
+export declare const IMAGES_PACKAGE_NAME = "@stati/images";
+/** Default candidate widths for responsive images */
+export declare const DEFAULT_IMAGE_WIDTHS: readonly number[];
+/** Default modern formats for responsive images */
+export declare const DEFAULT_IMAGE_FORMATS: readonly ('avif' | 'webp')[];
+/** Default encoder quality per format; PNG stays lossless unless configured */
+export declare const DEFAULT_IMAGE_QUALITY: {
+    readonly avif: 50;
+    readonly webp: 75;
+    readonly jpeg: 80;
+};
+/** Default `sizes` attribute for responsive images */
+export declare const DEFAULT_IMAGE_SIZES = "100vw";
+/** Default Open Graph image template name */
+export declare const DEFAULT_OG_TEMPLATE = "og.eta";
+/** Default Open Graph image width in pixels */
+export declare const DEFAULT_OG_WIDTH = 1200;
+/** Default Open Graph image height in pixels */
+export declare const DEFAULT_OG_HEIGHT = 630;
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,iDAAiD;AACjD,eAAO,MAAM,eAAe,SAAS,CAAC;AAEtC,+CAA+C;AAC/C,eAAO,MAAM,eAAe,SAAS,CAAC;AAEtC,sCAAsC;AACtC,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAE3C,iCAAiC;AACjC,eAAO,MAAM,cAAc,WAAW,CAAC;AAEvC,4DAA4D;AAC5D,eAAO,MAAM,YAAY,UAAU,CAAC;AAEpC,kCAAkC;AAClC,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AAIjD,qEAAqE;AACrE,eAAO,MAAM,sBAAsB,iCAAkC,CAAC;AAEtE,mCAAmC;AACnC,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAE/C,2CAA2C;AAC3C,eAAO,MAAM,oBAAoB,UAEhC,CAAC;AAIF,sCAAsC;AACtC,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC,kCAAkC;AAClC,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAEzC,sCAAsC;AACtC,eAAO,MAAM,gBAAgB,cAAc,CAAC;AAE5C,0CAA0C;AAC1C,eAAO,MAAM,oBAAoB,0BAAmD,CAAC;AAIrF,wDAAwD;AACxD,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAEzC,+DAA+D;AAC/D,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C,qEAAqE;AACrE,eAAO,MAAM,wBAAwB,QAAQ,CAAC;AAI9C,4BAA4B;AAC5B,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,0BAA0B;AAC1B,eAAO,MAAM,gBAAgB,QAA0B,CAAC;AAExD,yBAAyB;AACzB,eAAO,MAAM,eAAe,QAAwB,CAAC;AAErD,0BAA0B;AAC1B,eAAO,MAAM,gBAAgB,QAAsB,CAAC;AAEpD,8BAA8B;AAC9B,eAAO,MAAM,oBAAoB,QAAyB,CAAC;AAI3D,oDAAoD;AACpD,eAAO,MAAM,aAAa,QAAyB,CAAC;AAEpD,iDAAiD;AACjD,eAAO,MAAM,cAAc,QAA0B,CAAC;AAEtD,6CAA6C;AAC7C,eAAO,MAAM,UAAU,QAAmB,CAAC;AAE3C,iDAAiD;AACjD,eAAO,MAAM,WAAW,QAAuB,CAAC;AAEhD,uCAAuC;AACvC,eAAO,MAAM,WAAW,QAAsB,CAAC;AAE/C,2CAA2C;AAC3C,eAAO,MAAM,SAAS,QAAkB,CAAC;AAEzC,6CAA6C;AAC7C,eAAO,MAAM,UAAU,QAAmB,CAAC;AAI3C,kCAAkC;AAClC,eAAO,MAAM,kBAAkB,SAAS,CAAC;AAEzC,8BAA8B;AAC9B,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAExC,+BAA+B;AAC/B,eAAO,MAAM,eAAe,eAAgC,CAAC;AAE7D,mEAAmE;AACnE,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAIvC,yBAAyB;AACzB,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAElD,8CAA8C;AAC9C,eAAO,MAAM,cAAc,UAAU,CAAC;AAItC,0CAA0C;AAC1C,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAExC,qEAAqE;AACrE,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,eAAe;;;EAA2D,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"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"}

package/dist/constants.js

@@ -88,3 +88,26 @@ export const DEFAULT_TS_OUT_DIR = '_assets';
  * Creates a single global bundle from 'main.ts' entry point.
  */
 export const DEFAULT_BUNDLES = [{ entryPoint: 'main.ts', bundleName: 'main' }];
+// === Image Constants ===
+/** Output directory for generated and copied images, relative to the build output */
+export const IMAGES_OUTPUT_DIR = '_img';
+/** Subdirectory of {@link IMAGES_OUTPUT_DIR} for generated Open Graph images */
+export const OG_IMAGES_SUBDIR = 'og';
+/** Cache subdirectory (inside `.stati`) holding the images manifest */
+export const IMAGES_CACHE_SUBDIR = 'images';
+/** Package that implements responsive images and Open Graph image generation */
+export const IMAGES_PACKAGE_NAME = '@stati/images';
+/** Default candidate widths for responsive images */
+export const DEFAULT_IMAGE_WIDTHS = [480, 960, 1440];
+/** Default modern formats for responsive images */
+export const DEFAULT_IMAGE_FORMATS = ['avif', 'webp'];
+/** Default encoder quality per format; PNG stays lossless unless configured */
+export const DEFAULT_IMAGE_QUALITY = { avif: 50, webp: 75, jpeg: 80 };
+/** Default `sizes` attribute for responsive images */
+export const DEFAULT_IMAGE_SIZES = '100vw';
+/** Default Open Graph image template name */
+export const DEFAULT_OG_TEMPLATE = 'og.eta';
+/** Default Open Graph image width in pixels */
+export const DEFAULT_OG_WIDTH = 1200;
+/** Default Open Graph image height in pixels */
+export const DEFAULT_OG_HEIGHT = 630;

package/dist/core/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/core/build.ts"],"names":[],"mappings":"AA2DA,OAAO,KAAK,EAEV,UAAU,EACV,MAAM,EASP,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,uCAAuC;IACvC,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,8BAA8B;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,iCAAiC;IACjC,OAAO,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACrC,uEAAuE;IACvE,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,sGAAsG;IACtG,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,mFAAmF;IACnF,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC7C,wDAAwD;IACxD,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAkGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAsB5E"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/core/build.ts"],"names":[],"mappings":"AA2DA,OAAO,KAAK,EAEV,UAAU,EACV,MAAM,EASP,MAAM,mBAAmB,CAAC;AAK3B,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,uCAAuC;IACvC,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,8BAA8B;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,iCAAiC;IACjC,OAAO,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACrC,uEAAuE;IACvE,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,sGAAsG;IACtG,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,mFAAmF;IACnF,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC7C,wDAAwD;IACxD,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAkGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAsB5E"}

package/dist/core/build.js

@@ -12,6 +12,7 @@ import { generateRSSFeeds, validateRSSConfig } from '../rss/index.js';
 import { computeSearchIndexFilename, generateSearchIndex, writeSearchIndex, autoInjectSearchMeta, } from '../search/index.js';
 import { getEnv, isDevelopment } from '../env.js';
 import { DEFAULT_OUT_DIR } from '../constants.js';
+import { ImageRuntime } from '../images/runtime.js';
 import { createMetricRecorder, noopMetricRecorder } from '../metrics/index.js';
 /**
  * Recursively calculates the total size of a directory in bytes.
@@ -203,10 +204,29 @@ async function loadContentAndBuildNavigation(config, options, logger) {
     const eta = createTemplateEngine(config);
     return { pages, navigation, md, eta, navigationHash };
 }
+/**
+ * Output file and ISG cache key of a page.
+ */
+function getPageOutput(page, outDir) {
+    let outputPath;
+    if (page.url === '/') {
+        outputPath = join(outDir, 'index.html');
+    }
+    else if (page.url.endsWith('/')) {
+        outputPath = join(outDir, page.url, 'index.html');
+    }
+    else {
+        outputPath = join(outDir, `${page.url}.html`);
+    }
+    // Cache key is the output path relative to outDir
+    const relativePath = relative(outDir, outputPath).replace(/\\/g, '/');
+    const cacheKey = relativePath.startsWith('/') ? relativePath : `/${relativePath}`;
+    return { outputPath, cacheKey };
+}
 /**
  * Processes pages with ISG caching logic.
  */
-async function processPagesWithCache(pages, manifest, config, outDir, md, eta, navigation, buildTime, options, logger, compiledBundles, recorder = noopMetricRecorder, searchIndexFilename) {
+async function processPagesWithCache(pages, manifest, config, outDir, md, eta, navigation, buildTime, options, logger, compiledBundles, recorder = noopMetricRecorder, searchIndexFilename, imageRuntime = null) {
     let cacheHits = 0;
     let cacheMisses = 0;
     const searchablePages = [];
@@ -236,24 +256,14 @@ async function processPagesWithCache(pages, manifest, config, outDir, md, eta, n
     const isDevMode = isDevelopment();
     const pendingWrites = [];
     const pendingCacheUpdates = [];
+    // Image settings that change generated HTML, part of every page's render inputs
+    const imageFingerprint = imageRuntime?.fingerprint();
     for (let i = 0; i < pages.length; i++) {
         const page = pages[i];
         if (!page)
             continue; // Safety check
-        // Determine output path
-        let outputPath;
-        if (page.url === '/') {
-            outputPath = join(outDir, 'index.html');
-        }
-        else if (page.url.endsWith('/')) {
-            outputPath = join(outDir, page.url, 'index.html');
-        }
-        else {
-            outputPath = join(outDir, `${page.url}.html`);
-        }
-        // Get cache key (use output path relative to outDir)
-        const relativePath = relative(outDir, outputPath).replace(/\\/g, '/');
-        const cacheKey = relativePath.startsWith('/') ? relativePath : `/${relativePath}`;
+        // Determine output path and cache key
+        const { outputPath, cacheKey } = getPageOutput(page, outDir);
         const existingEntry = manifest.entries[cacheKey];
         const bundlePaths = getBundlePathsForPage(page.url, compiledBundles);
         const assets = {
@@ -267,12 +277,16 @@ async function processPagesWithCache(pages, manifest, config, outDir, md, eta, n
             ...assets,
             bundleAutoInject: config.typescript?.autoInject !== false,
             searchAutoInject: config.search?.autoInjectMetaTag !== false,
+            // Omitted with images: false, so the hash matches builds without the image pipeline
+            ...(imageFingerprint && { images: imageFingerprint }),
         });
         // Check if we should rebuild this page (considering ISG logic)
         const shouldRebuildStart = performance.now();
         const shouldRebuild = options.force ||
             config.isg?.enabled === false ||
             !(await pathExists(outputPath)) ||
+            // A cached page whose generated images are gone is rebuilt to regenerate them
+            (imageRuntime !== null && !imageRuntime.outputsExist(existingEntry?.images)) ||
             (await shouldRebuildPage(page, existingEntry, config, pages, buildTime, renderInputsHash));
         const shouldRebuildTime = performance.now() - shouldRebuildStart;
         totalShouldRebuildTime += shouldRebuildTime;
@@ -302,12 +316,16 @@ async function processPagesWithCache(pages, manifest, config, outDir, md, eta, n
             await config.hooks.beforeRender({ page, config });
             recorder.addToPhase('hookBeforeRenderTotalMs', performance.now() - hookStart);
         }
+        // Image state for this page: markup, dependencies and generated files
+        const pageImages = imageRuntime?.createPageContext(page);
         // Render markdown to HTML with TOC extraction
         const tocEnabled = config.markdown?.toc !== false;
-        const { html: htmlContent, toc } = renderMarkdown(page.content, md, tocEnabled);
+        const { html: htmlContent, toc } = renderMarkdown(page.content, md, tocEnabled, {
+            images: pageImages,
+        });
         // Render with template
         const renderPageStart = performance.now();
-        const renderResult = await renderPage(page, htmlContent, config, eta, navigation, pages, assets, toc, logger);
+        const renderResult = await renderPage(page, htmlContent, config, eta, navigation, pages, assets, toc, logger, { images: pageImages });
         const renderPageTime = performance.now() - renderPageStart;
         totalRenderTime += renderPageTime;
         let finalHtml = renderResult.html;
@@ -324,6 +342,9 @@ async function processPagesWithCache(pages, manifest, config, outDir, md, eta, n
             if (config.seo?.debug !== undefined) {
                 injectOptions.debug = config.seo.debug;
             }
+            if (renderResult.ogImage) {
+                injectOptions.generatedImage = renderResult.ogImage;
+            }
             finalHtml = autoInjectSEO(finalHtml, injectOptions);
         }
         // Auto-inject search index meta tag if enabled (default: true)
@@ -336,6 +357,10 @@ async function processPagesWithCache(pages, manifest, config, outDir, md, eta, n
         if (config.typescript?.autoInject !== false && assets.bundlePaths.length > 0) {
             finalHtml = autoInjectBundles(finalHtml, assets.bundlePaths);
         }
+        // Start the image jobs the final HTML needs and record its image files for the cache
+        const renderedAssets = pageImages && imageRuntime
+            ? imageRuntime.commitPage(pageImages, finalHtml, { outputPath, cacheKey })
+            : undefined;
         const renderTime = Math.round(performance.now() - startTime);
         // Record page timing for rendered pages (includes template count)
         recorder.recordPageTiming(page.url, renderTime, false, renderResult.templatesLoaded);
@@ -345,7 +370,7 @@ async function processPagesWithCache(pages, manifest, config, outDir, md, eta, n
         // In dev mode, batch writes for parallel execution to avoid Windows filesystem slowdown
         if (isDevMode) {
             pendingWrites.push({ outputPath, content: finalHtml });
-            pendingCacheUpdates.push({ cacheKey, page, existingEntry, renderInputsHash });
+            pendingCacheUpdates.push({ cacheKey, page, existingEntry, renderInputsHash, renderedAssets });
         }
         else {
             // Production mode: write immediately
@@ -357,10 +382,10 @@ async function processPagesWithCache(pages, manifest, config, outDir, md, eta, n
             if (!options.skipCacheUpdate) {
                 const cacheEntryStart = performance.now();
                 if (existingEntry) {
-                    manifest.entries[cacheKey] = await updateCacheEntry(existingEntry, page, config, pages, buildTime, false, renderInputsHash);
+                    manifest.entries[cacheKey] = await updateCacheEntry(existingEntry, page, config, pages, buildTime, false, renderInputsHash, renderedAssets);
                 }
                 else {
-                    manifest.entries[cacheKey] = await createCacheEntry(page, config, pages, buildTime, renderInputsHash);
+                    manifest.entries[cacheKey] = await createCacheEntry(page, config, pages, buildTime, renderInputsHash, renderedAssets);
                 }
                 totalCacheEntryTime += performance.now() - cacheEntryStart;
             }
@@ -390,14 +415,14 @@ async function processPagesWithCache(pages, manifest, config, outDir, md, eta, n
         // This avoids expensive template dependency tracking on each incremental rebuild
         if (!options.skipCacheUpdate) {
             const cacheEntryStart = performance.now();
-            for (const { cacheKey, page, existingEntry, renderInputsHash } of pendingCacheUpdates) {
+            for (const { cacheKey, page, existingEntry, renderInputsHash, renderedAssets, } of pendingCacheUpdates) {
                 if (existingEntry) {
                     // Fast update: reuse existing deps, just update hashes and timestamp
                     manifest.entries[cacheKey] = await updateCacheEntry(existingEntry, page, config, pages, buildTime, true, // fastUpdate = true in dev mode
-                    renderInputsHash);
+                    renderInputsHash, renderedAssets);
                 }
                 else {
-                    manifest.entries[cacheKey] = await createCacheEntry(page, config, pages, buildTime, renderInputsHash);
+                    manifest.entries[cacheKey] = await createCacheEntry(page, config, pages, buildTime, renderInputsHash, renderedAssets);
                 }
             }
             totalCacheEntryTime = performance.now() - cacheEntryStart;
@@ -501,6 +526,14 @@ async function buildInternal(options = {}) {
         await remove(cacheDir);
     }
     await ensureDir(outDir);
+    // Image pipeline; null with images: false. Fails here, before any page renders, when a
+    // feature needs @stati/images and it is missing or incompatible.
+    const imageRuntime = await ImageRuntime.create(config, {
+        outDir,
+        cacheDir,
+        logger,
+        development: isDevelopment(),
+    });
     // Enable Tailwind class inventory tracking only if Tailwind is detected
     const tailwindInitStart = performance.now();
     const hasTailwind = await isTailwindUsed();
@@ -593,9 +626,26 @@ async function buildInternal(options = {}) {
     }
     const endPageRenderSpan = recorder.startSpan('pageRenderingMs');
     const buildTime = new Date();
-    const pageProcessingResult = await processPagesWithCache(pages, manifest, config, outDir, md, eta, navigation, buildTime, options, logger, compiledBundles, recorder, searchIndexFilename);
+    const pageProcessingResult = await processPagesWithCache(pages, manifest, config, outDir, md, eta, navigation, buildTime, options, logger, compiledBundles, recorder, searchIndexFilename, imageRuntime);
     endPageRenderSpan();
     const { cacheHits, cacheMisses, searchablePages } = pageProcessingResult;
+    // Wait for image jobs; pages whose images failed are rewritten to show plain images
+    let imageFailures = [];
+    if (imageRuntime) {
+        const endImageSpan = recorder.startSpan('imageSettleMs');
+        const settled = await imageRuntime.settle(manifest);
+        await imageRuntime.save();
+        endImageSpan();
+        imageFailures = settled.failures;
+        const { generated, cached, failed } = imageRuntime.stats;
+        recorder.increment('imagesGenerated', generated);
+        recorder.increment('imagesCached', cached);
+        recorder.increment('imagesFailed', failed);
+        if (generated > 0 || failed > 0) {
+            logger.info('');
+            logger.info(`Images: ${generated} generated, ${cached} reused${failed > 0 ? `, ${failed} failed` : ''}`);
+        }
+    }
     // Generate search index if enabled
     // Uses markdown content and TOC entries
     let searchIndexMetadata;
@@ -638,6 +688,13 @@ async function buildInternal(options = {}) {
         await saveCacheManifest(cacheDir, manifest);
     }
     endManifestSaveSpan();
+    // In the dev server a failed Open Graph image goes to the error overlay, like a template error
+    const ogFailures = imageFailures.filter((failure) => failure.og);
+    if (isDevMode && ogFailures.length > 0) {
+        throw new Error(ogFailures
+            .map((failure) => `Open Graph image failed for ${failure.label}: ${failure.message}`)
+            .join('\n'));
+    }
     // Copy static assets and count them (skip for template-only changes in dev mode)
     const endAssetSpan = recorder.startSpan('assetCopyMs');
     let assetsCount = 0;
@@ -646,6 +703,21 @@ async function buildInternal(options = {}) {
     }
     endAssetSpan();
     recorder.increment('assetsCopied', assetsCount);
+    // Delete generated images no page of this build uses. Production only: dev builds skip
+    // responsive and Open Graph images by default and must not delete them.
+    if (imageRuntime && getEnv() === 'production') {
+        const liveImages = new Set();
+        const liveSources = new Set();
+        for (const page of pages) {
+            const entry = manifest.entries[getPageOutput(page, outDir).cacheKey];
+            entry?.images?.forEach((image) => liveImages.add(image));
+            entry?.assetDeps?.forEach((source) => liveSources.add(source));
+        }
+        const removed = await imageRuntime.prune(liveImages, liveSources);
+        if (removed > 0) {
+            logger.info(`Removed ${removed} unused generated image${removed === 1 ? '' : 's'}`);
+        }
+    }
     // Get current environment
     const currentEnv = getEnv();
     // Generate sitemap if enabled (only in production mode)

package/dist/core/isg/builder.d.ts

@@ -1,4 +1,14 @@
 import type { PageModel, CacheEntry, StatiConfig } from '../../types/index.js';
+/**
+ * Files a render discovered: the source images a page displays (`assetDeps`) and the
+ * generated images it references (`images`).
+ */
+export interface RenderedAssets {
+    /** Absolute paths of files whose content affects the page, such as source images */
+    assetDeps: readonly string[];
+    /** Generated image files the page references, relative to the output directory */
+    images: readonly string[];
+}
 /**
  * Determines if a page should be rebuilt based on ISG logic.
  * Checks content changes, dependency changes, TTL expiration, and freeze status.
@@ -29,6 +39,7 @@ export declare function shouldRebuildPage(page: PageModel, entry: CacheEntry | u
  * @param allPages - All pages in the site, used to resolve the same layout as rendering
  * @param renderedAt - When the page was rendered
  * @param renderInputsHash - Optional hash of asset URLs and injection settings
+ * @param rendered - Files the render discovered, such as images
  * @returns New cache entry
  *
  * @example
@@ -36,7 +47,7 @@ export declare function shouldRebuildPage(page: PageModel, entry: CacheEntry | u
  * const entry = await createCacheEntry(page, config, pages, new Date());
  * ```
  */
-export declare function createCacheEntry(page: PageModel, config: StatiConfig, allPages: PageModel[], renderedAt: Date, renderInputsHash?: string): Promise<CacheEntry>;
+export declare function createCacheEntry(page: PageModel, config: StatiConfig, allPages: PageModel[], renderedAt: Date, renderInputsHash?: string, rendered?: RenderedAssets): Promise<CacheEntry>;
 /**
  * Updates an existing cache entry with new information after rebuilding.
  * In dev mode, this is optimized to reuse the existing deps array since
@@ -49,6 +60,7 @@ export declare function createCacheEntry(page: PageModel, config: StatiConfig, a
  * @param renderedAt - When the page was rendered
  * @param fastUpdate - If true, skip expensive dep tracking (dev mode optimization)
  * @param renderInputsHash - Optional hash of asset URLs and injection settings
+ * @param rendered - Files the render discovered, such as images
  * @returns Updated cache entry
  *
  * @example
@@ -56,5 +68,5 @@ export declare function createCacheEntry(page: PageModel, config: StatiConfig, a
  * const updatedEntry = await updateCacheEntry(existingEntry, page, config, pages, new Date());
  * ```
  */
-export declare function updateCacheEntry(entry: CacheEntry, page: PageModel, config: StatiConfig, allPages: PageModel[], renderedAt: Date, fastUpdate?: boolean, renderInputsHash?: string): Promise<CacheEntry>;
+export declare function updateCacheEntry(entry: CacheEntry, page: PageModel, config: StatiConfig, allPages: PageModel[], renderedAt: Date, fastUpdate?: boolean, renderInputsHash?: string, rendered?: RenderedAssets): Promise<CacheEntry>;
 //# sourceMappingURL=builder.d.ts.map

package/dist/core/isg/builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../src/core/isg/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAqE/E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,UAAU,GAAG,SAAS,EAC7B,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,SAAS,EAAE,EACrB,GAAG,EAAE,IAAI,EACT,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,OAAO,CAAC,CAoKlB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,SAAS,EAAE,EACrB,UAAU,EAAE,IAAI,EAChB,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,UAAU,CAAC,CAqFrB;AAkDD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,SAAS,EAAE,EACrB,UAAU,EAAE,IAAI,EAChB,UAAU,UAAQ,EAClB,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,UAAU,CAAC,CAmDrB"}
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../src/core/isg/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAgF/E;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,oFAAoF;IACpF,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,kFAAkF;IAClF,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AA0BD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,UAAU,GAAG,SAAS,EAC7B,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,SAAS,EAAE,EACrB,GAAG,EAAE,IAAI,EACT,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,OAAO,CAAC,CAuKlB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,SAAS,EAAE,EACrB,UAAU,EAAE,IAAI,EAChB,gBAAgB,CAAC,EAAE,MAAM,EACzB,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,UAAU,CAAC,CAsFrB;AAkDD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,SAAS,EAAE,EACrB,UAAU,EAAE,IAAI,EAChB,UAAU,UAAQ,EAClB,gBAAgB,CAAC,EAAE,MAAM,EACzB,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,UAAU,CAAC,CA+DrB"}

package/dist/core/isg/builder.js

@@ -1,4 +1,4 @@
-import { computeContentHash, computeFileHash, computeInputsHash } from './hash.js';
+import { computeContentHash, computeFileHash, computeBinaryFileHash, computeInputsHash, } from './hash.js';
 import { trackTemplateDependencies, resolveLayoutDependency } from './deps.js';
 import { computeEffectiveTTL, computeNextRebuildAt, isPageFrozen } from './ttl.js';
 import { validatePageISGOverrides, extractNumericOverride } from './validation.js';
@@ -55,8 +55,35 @@ function isValidCacheEntry(entry) {
     if (entry.maxAgeCapDays !== undefined && typeof entry.maxAgeCapDays !== 'number') {
         return false;
     }
+    for (const list of [entry.assetDeps, entry.images]) {
+        if (list !== undefined && (!Array.isArray(list) || !list.every((v) => typeof v === 'string'))) {
+            return false;
+        }
+    }
     return true;
 }
+/**
+ * Hashes render-discovered dependencies by content. Missing files hash to a sentinel.
+ */
+async function hashAssetDeps(assetDeps) {
+    const hashes = [];
+    for (const assetPath of assetDeps ?? []) {
+        hashes.push(await computeBinaryFileHash(assetPath));
+    }
+    return hashes;
+}
+/**
+ * Returns the entry with its `assetDeps` and `images` replaced by this render's,
+ * dropping the fields when a render found none.
+ */
+function withRenderedAssets(entry, rendered) {
+    const { assetDeps: _assetDeps, images: _images, ...rest } = entry;
+    return {
+        ...rest,
+        ...(rendered && rendered.assetDeps.length > 0 && { assetDeps: [...rendered.assetDeps] }),
+        ...(rendered && rendered.images.length > 0 && { images: [...rendered.images] }),
+    };
+}
 /**
  * Determines if a page should be rebuilt based on ISG logic.
  * Checks content changes, dependency changes, TTL expiration, and freeze status.
@@ -133,6 +160,8 @@ export async function shouldRebuildPage(page, entry, config, allPages, now, rend
             console.warn(`${dependencyErrors} dependency errors for ${page.url}, forcing rebuild`);
             return true;
         }
+        // Files found during the last render, such as images, are hashed by content
+        depsHashes.push(...(await hashAssetDeps(entry.assetDeps)));
         const currentInputsHash = computeInputsHash(currentContentHash, depsHashes, renderInputsHash);
         // If inputs changed, always rebuild
         if (currentInputsHash !== entry.inputsHash) {
@@ -215,6 +244,7 @@ export async function shouldRebuildPage(page, entry, config, allPages, now, rend
  * @param allPages - All pages in the site, used to resolve the same layout as rendering
  * @param renderedAt - When the page was rendered
  * @param renderInputsHash - Optional hash of asset URLs and injection settings
+ * @param rendered - Files the render discovered, such as images
  * @returns New cache entry
  *
  * @example
@@ -222,7 +252,7 @@ export async function shouldRebuildPage(page, entry, config, allPages, now, rend
  * const entry = await createCacheEntry(page, config, pages, new Date());
  * ```
  */
-export async function createCacheEntry(page, config, allPages, renderedAt, renderInputsHash) {
+export async function createCacheEntry(page, config, allPages, renderedAt, renderInputsHash, rendered) {
     const timings = {};
     let start = performance.now();
     // Validate page-level ISG overrides first
@@ -245,6 +275,7 @@ export async function createCacheEntry(page, config, allPages, renderedAt, rende
             depsHashes.push(depHash);
         }
     }
+    depsHashes.push(...(await hashAssetDeps(rendered?.assetDeps)));
     timings.depsHashes = performance.now() - start;
     const inputsHash = computeInputsHash(contentHash, depsHashes, renderInputsHash);
     // Extract tags from front matter
@@ -287,7 +318,7 @@ export async function createCacheEntry(page, config, allPages, renderedAt, rende
     if (maxAgeCapDays !== undefined) {
         cacheEntry.maxAgeCapDays = maxAgeCapDays;
     }
-    return cacheEntry;
+    return withRenderedAssets(cacheEntry, rendered);
 }
 /**
  * Checks if the template structure has changed by comparing the layout file's
@@ -345,6 +376,7 @@ async function hasTemplateStructureChanged(entry) {
  * @param renderedAt - When the page was rendered
  * @param fastUpdate - If true, skip expensive dep tracking (dev mode optimization)
  * @param renderInputsHash - Optional hash of asset URLs and injection settings
+ * @param rendered - Files the render discovered, such as images
  * @returns Updated cache entry
  *
  * @example
@@ -352,7 +384,7 @@ async function hasTemplateStructureChanged(entry) {
  * const updatedEntry = await updateCacheEntry(existingEntry, page, config, pages, new Date());
  * ```
  */
-export async function updateCacheEntry(entry, page, config, allPages, renderedAt, fastUpdate = false, renderInputsHash) {
+export async function updateCacheEntry(entry, page, config, allPages, renderedAt, fastUpdate = false, renderInputsHash, rendered) {
     // In fast update mode (dev), reuse existing deps to avoid expensive tracking
     if (fastUpdate && entry.deps.length > 0) {
         // Detect if template structure has changed (new includes/extends added)
@@ -380,16 +412,18 @@ export async function updateCacheEntry(entry, page, config, allPages, renderedAt
                     depsHashes.push(depHash);
                 }
             }
+            // Asset deps come from this render, not from the previous entry
+            depsHashes.push(...(await hashAssetDeps(rendered?.assetDeps)));
             const inputsHash = computeInputsHash(contentHash, depsHashes, renderInputsHash);
-            return {
+            return withRenderedAssets({
                 ...entry,
                 inputsHash,
                 renderedAt: renderedAt.toISOString(),
-            };
+            }, rendered);
         }
     }
     // Full update - create new entry and preserve original publishedAt
-    const newEntry = await createCacheEntry(page, config, allPages, renderedAt, renderInputsHash);
+    const newEntry = await createCacheEntry(page, config, allPages, renderedAt, renderInputsHash, rendered);
     // Preserve original publishedAt if no new one is specified
     if (!newEntry.publishedAt && entry.publishedAt) {
         newEntry.publishedAt = entry.publishedAt;

package/dist/core/isg/deps.d.ts

@@ -50,6 +50,15 @@ export declare function trackTemplateDependencies(page: PageModel, config: Stati
  * @returns Absolute path to the layout file (POSIX format), or null if no layout applies
  */
 export declare function resolveLayoutDependency(page: PageModel, config: StatiConfig, allPages: PageModel[]): Promise<string | null>;
+/**
+ * Resolves the Open Graph template a page renders with, when Open Graph images are on and the
+ * page does not opt out. Pages that use the built-in template have no file dependency.
+ *
+ * @param page - The page model
+ * @param config - Stati configuration
+ * @returns Absolute path to the template (POSIX format), or null
+ */
+export declare function resolveOgTemplateDependency(page: PageModel, config: StatiConfig): Promise<string | null>;
 /**
  * Resolves a template name to its file path.
  * Used for explicit layout specifications in front matter.

package/dist/core/isg/deps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../../../src/core/isg/deps.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAenE;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAG7C;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;aAE9B,eAAe,EAAE,MAAM,EAAE;gBAAzB,eAAe,EAAE,MAAM,EAAE,EACzC,OAAO,EAAE,MAAM;CAKlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,SAAS,EAAE,GACpB,OAAO,CAAC,MAAM,EAAE,CAAC,CAuCnB;AAED;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,SAAS,EAAE,GACpB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAexB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CASxB"}
+{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../../../src/core/isg/deps.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAgBnE;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAI7C;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;aAE9B,eAAe,EAAE,MAAM,EAAE;gBAAzB,eAAe,EAAE,MAAM,EAAE,EACzC,OAAO,EAAE,MAAM;CAKlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,SAAS,EAAE,GACpB,OAAO,CAAC,MAAM,EAAE,CAAC,CA+CnB;AAED;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,SAAS,EAAE,GACpB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAexB;AAED;;;;;;;GAOG;AACH,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAexB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CASxB"}