@stati/core 1.6.4 → 1.7.0

package/README.md

@@ -266,4 +266,4 @@ Stati Core is built with a modular architecture:
 
 ## License
 
-MIT
+MIT © [Imre Csige](https://github.com/ianchak)

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

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/core/build.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAEV,UAAU,EACV,MAAM,EAKP,MAAM,mBAAmB,CAAC;AAG3B;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA4FD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAW3E"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/core/build.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAEV,UAAU,EACV,MAAM,EAKP,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA4FD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAW3E"}

package/dist/core/build.js

@@ -1,4 +1,4 @@
-import { ensureDir, writeFile, remove, pathExists, stat, readdir, copyFile } from './utils/fs.js';
+import { ensureDir, writeFile, remove, pathExists, stat, readdir, copyFile, resolveOutDir, resolveStaticDir, resolveCacheDir, } from './utils/index.js';
 import { join, dirname, relative } from 'path';
 import { posix } from 'path';
 import { loadConfig } from '../config/loader.js';
@@ -6,10 +6,8 @@ import { loadContent } from './content.js';
 import { createMarkdownProcessor, renderMarkdown } from './markdown.js';
 import { createTemplateEngine, renderPage } from './templates.js';
 import { buildNavigation } from './navigation.js';
-import { loadCacheManifest, saveCacheManifest } from './isg/manifest.js';
-import { shouldRebuildPage, createCacheEntry, updateCacheEntry } from './isg/builder.js';
-import { withBuildLock } from './isg/build-lock.js';
-import { resolveOutDir, resolveStaticDir, resolveCacheDir } from './utils/paths.js';
+import { loadCacheManifest, saveCacheManifest, shouldRebuildPage, createCacheEntry, updateCacheEntry, withBuildLock, } from './isg/index.js';
+import { generateSitemap, generateRobotsTxtFromConfig, autoInjectSEO, } from '../seo/index.js';
 /**
  * Recursively calculates the total size of a directory in bytes.
  * Used for build statistics.
@@ -260,7 +258,20 @@ async function processPagesWithCache(pages, manifest, config, outDir, md, eta, n
             logger.updateTreeNode(templateId, 'running');
         }
         // Render with template
-        const finalHtml = await renderPage(page, htmlContent, config, eta, navigation, pages);
+        let finalHtml = await renderPage(page, htmlContent, config, eta, navigation, pages);
+        // Auto-inject SEO tags if enabled
+        if (config.seo?.autoInject !== false) {
+            const injectOptions = {
+                page,
+                config,
+                siteUrl: config.site.baseUrl,
+                logger,
+            };
+            if (config.seo?.debug !== undefined) {
+                injectOptions.debug = config.seo.debug;
+            }
+            finalHtml = autoInjectSEO(finalHtml, injectOptions);
+        }
         const renderTime = Date.now() - startTime;
         if (logger.updateTreeNode) {
             logger.updateTreeNode(templateId, 'completed');
@@ -367,6 +378,31 @@ async function buildInternal(options = {}) {
     // Copy static assets and count them
     let assetsCount = 0;
     assetsCount = await copyStaticAssets(config, outDir, logger);
+    // Generate sitemap if enabled
+    if (config.sitemap?.enabled) {
+        console.log(); // Add spacing before sitemap generation
+        logger.info('Generating sitemap...');
+        const sitemapResult = generateSitemap(pages, config, config.sitemap);
+        await writeFile(join(outDir, 'sitemap.xml'), sitemapResult.xml);
+        // Write additional sitemap files if split
+        if (sitemapResult.sitemaps) {
+            for (const { filename, xml } of sitemapResult.sitemaps) {
+                await writeFile(join(outDir, filename), xml);
+            }
+            logger.success(`Generated sitemap index with ${sitemapResult.sitemaps.length} sitemaps (${sitemapResult.entryCount} entries)`);
+        }
+        else {
+            logger.success(`Generated sitemap with ${sitemapResult.entryCount} entries`);
+        }
+    }
+    // Generate robots.txt if enabled
+    if (config.robots?.enabled) {
+        console.log(); // Add spacing before robots.txt generation
+        logger.info('Generating robots.txt...');
+        const robotsContent = generateRobotsTxtFromConfig(config.robots, config.site.baseUrl);
+        await writeFile(join(outDir, 'robots.txt'), robotsContent);
+        logger.success('Generated robots.txt');
+    }
     // Run afterAll hook
     if (config.hooks?.afterAll) {
         await config.hooks.afterAll({ config, pages });

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

@@ -1 +1 @@
-{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/core/content.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIhE;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,WAAW,EACnB,aAAa,CAAC,EAAE,OAAO,GACtB,OAAO,CAAC,SAAS,EAAE,CAAC,CA6CtB"}
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/core/content.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhE;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,WAAW,EACnB,aAAa,CAAC,EAAE,OAAO,GACtB,OAAO,CAAC,SAAS,EAAE,CAAC,CA6CtB"}

package/dist/core/content.js

@@ -1,9 +1,8 @@
 import glob from 'fast-glob';
-import { readFile } from './utils/fs.js';
+import { readFile, resolveSrcDir } from './utils/index.js';
 import matter from 'gray-matter';
 import { relative, dirname, basename } from 'path';
 import { MARKDOWN_EXTENSION } from '../constants.js';
-import { resolveSrcDir } from './utils/paths.js';
 /**
  * Loads and parses all content files from the configured source directory.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/core/dev.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAe,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAa7D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAoOD,wBAAsB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC,CA2XxF"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/core/dev.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAe,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAiB7D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAoOD,wBAAsB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC,CA2XxF"}

package/dist/core/dev.js

@@ -7,11 +7,8 @@ import chokidar from 'chokidar';
 import { build } from './build.js';
 import { invalidate } from './invalidate.js';
 import { loadConfig } from '../config/loader.js';
-import { loadCacheManifest, saveCacheManifest } from './isg/manifest.js';
-import { resolveDevPaths, resolveCacheDir } from './utils/paths.js';
-import { resolvePrettyUrl } from './utils/server.js';
-import { createErrorOverlay, parseErrorDetails } from './utils/error-overlay.js';
-import { TemplateError } from './utils/template-errors.js';
+import { loadCacheManifest, saveCacheManifest } from './isg/index.js';
+import { resolveDevPaths, resolveCacheDir, resolvePrettyUrl, createErrorOverlay, parseErrorDetails, TemplateError, } from './utils/index.js';
 import { setEnv, getEnv } from '../env.js';
 import { DEFAULT_DEV_PORT, DEFAULT_DEV_HOST, TEMPLATE_EXTENSION } from '../constants.js';
 /**

package/dist/core/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Core build engine exports
+ * Barrel file for all core Stati functionality including build, dev server, preview, and invalidation.
+ */
+export { build } from './build.js';
+export type { BuildOptions } from './build.js';
+export { createDevServer } from './dev.js';
+export type { DevServerOptions } from './dev.js';
+export { createPreviewServer } from './preview.js';
+export type { PreviewServerOptions } from './preview.js';
+export { invalidate } from './invalidate.js';
+export type { InvalidationResult } from './invalidate.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAGjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGzD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Core build engine exports
+ * Barrel file for all core Stati functionality including build, dev server, preview, and invalidation.
+ */
+// Build functionality
+export { build } from './build.js';
+// Development server
+export { createDevServer } from './dev.js';
+// Preview server
+export { createPreviewServer } from './preview.js';
+// Cache invalidation
+export { invalidate } from './invalidate.js';

package/dist/core/invalidate.js

@@ -1,5 +1,5 @@
-import { loadCacheManifest, saveCacheManifest } from './isg/manifest.js';
-import { resolveCacheDir } from './utils/paths.js';
+import { loadCacheManifest, saveCacheManifest } from './isg/index.js';
+import { resolveCacheDir } from './utils/index.js';
 /**
  * Parses an invalidation query string into individual query terms.
  * Supports space-separated values and quoted strings.

package/dist/core/isg/build-lock.js

@@ -1,4 +1,4 @@
-import { writeFile, readFile, pathExists, remove, ensureDir } from '../utils/fs.js';
+import { writeFile, readFile, pathExists, remove, ensureDir } from '../utils/index.js';
 import { join, dirname } from 'path';
 import { hostname } from 'os';
 /**

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":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAKnE;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;aAE9B,eAAe,EAAE,MAAM,EAAE;gBAAzB,eAAe,EAAE,MAAM,EAAE,EACzC,OAAO,EAAE,MAAM;CAKlB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,MAAM,EAAE,CAAC,CAoCnB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,MAAM,EAAE,CAAC,CAiDnB;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;AAGnE;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;aAE9B,eAAe,EAAE,MAAM,EAAE;gBAAzB,eAAe,EAAE,MAAM,EAAE,EACzC,OAAO,EAAE,MAAM;CAKlB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,MAAM,EAAE,CAAC,CAoCnB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,MAAM,EAAE,CAAC,CAiDnB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CASxB"}

package/dist/core/isg/deps.js

@@ -1,9 +1,7 @@
 import { join, dirname, relative, posix } from 'path';
-import { pathExists, readFile } from '../utils/fs.js';
+import { pathExists, readFile, isCollectionIndexPage, discoverLayout, resolveSrcDir, } from '../utils/index.js';
 import glob from 'fast-glob';
 import { TEMPLATE_EXTENSION } from '../../constants.js';
-import { isCollectionIndexPage, discoverLayout } from '../utils/template-discovery.js';
-import { resolveSrcDir } from '../utils/paths.js';
 /**
  * Error thrown when a circular dependency is detected in templates.
  */

package/dist/core/isg/hash.js

@@ -1,5 +1,5 @@
 import { createHash } from 'crypto';
-import { readFile, pathExists } from '../utils/fs.js';
+import { readFile, pathExists } from '../utils/index.js';
 /**
  * Creates a SHA-256 hash instance, updates it with data, and returns the hex digest.
  * Internal utility to eliminate duplicate hash creation patterns.

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

@@ -0,0 +1,16 @@
+/**
+ * ISG (Incremental Static Generation) Module
+ *
+ * This module provides intelligent caching and incremental rebuild capabilities for Stati.
+ * It tracks page dependencies, computes content hashes, and manages TTL-based rebuild strategies.
+ *
+ * @module isg
+ */
+export { loadCacheManifest, saveCacheManifest, createEmptyManifest } from './manifest.js';
+export { shouldRebuildPage, createCacheEntry, updateCacheEntry } from './builder.js';
+export { BuildLockManager, withBuildLock } from './build-lock.js';
+export { CircularDependencyError, trackTemplateDependencies, findPartialDependencies, resolveTemplatePath, } from './deps.js';
+export { computeContentHash, computeFileHash, computeInputsHash } from './hash.js';
+export { getSafeCurrentTime, parseSafeDate, computeEffectiveTTL, computeNextRebuildAt, isPageFrozen, applyAgingRules, } from './ttl.js';
+export { ISGConfigurationError, validateISGConfig, validatePageISGOverrides, extractNumericOverride, } from './validation.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/isg/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAG1F,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGrF,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGlE,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAGnF,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,eAAe,GAChB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC"}

package/dist/core/isg/index.js

@@ -0,0 +1,22 @@
+/**
+ * ISG (Incremental Static Generation) Module
+ *
+ * This module provides intelligent caching and incremental rebuild capabilities for Stati.
+ * It tracks page dependencies, computes content hashes, and manages TTL-based rebuild strategies.
+ *
+ * @module isg
+ */
+// Manifest management
+export { loadCacheManifest, saveCacheManifest, createEmptyManifest } from './manifest.js';
+// Build decision logic
+export { shouldRebuildPage, createCacheEntry, updateCacheEntry } from './builder.js';
+// Build locking
+export { BuildLockManager, withBuildLock } from './build-lock.js';
+// Dependency tracking
+export { CircularDependencyError, trackTemplateDependencies, findPartialDependencies, resolveTemplatePath, } from './deps.js';
+// Hash computation
+export { computeContentHash, computeFileHash, computeInputsHash } from './hash.js';
+// TTL and aging
+export { getSafeCurrentTime, parseSafeDate, computeEffectiveTTL, computeNextRebuildAt, isPageFrozen, applyAgingRules, } from './ttl.js';
+// Validation
+export { ISGConfigurationError, validateISGConfig, validatePageISGOverrides, extractNumericOverride, } from './validation.js';

package/dist/core/isg/manifest.js

@@ -1,4 +1,4 @@
-import { readFile, writeFile, pathExists, ensureDir } from '../utils/fs.js';
+import { readFile, writeFile, pathExists, ensureDir } from '../utils/index.js';
 import { join } from 'path';
 import { MANIFEST_FILENAME } from '../../constants.js';
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/core/preview.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAMhD,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,0BAA0B;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAyBD;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,aAAa,CAAC,CA2JxB"}
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/core/preview.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAKhD,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,0BAA0B;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAyBD;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,aAAa,CAAC,CA2JxB"}

package/dist/core/preview.js

@@ -2,8 +2,7 @@ import { createServer } from 'http';
 import { join, extname } from 'path';
 import { readFile } from 'fs/promises';
 import { loadConfig } from '../config/loader.js';
-import { resolveDevPaths } from './utils/paths.js';
-import { resolvePrettyUrl } from './utils/server.js';
+import { resolveDevPaths, resolvePrettyUrl } from './utils/index.js';
 import { DEFAULT_PREVIEW_PORT, DEFAULT_DEV_HOST } from '../constants.js';
 /**
  * Loads and validates configuration for the preview server.

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

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/core/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAG1B,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAkB,MAAM,mBAAmB,CAAC;AAsLzF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,GAAG,CAW7D;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,GAAG,EACR,UAAU,CAAC,EAAE,OAAO,EAAE,EACtB,QAAQ,CAAC,EAAE,SAAS,EAAE,GACrB,OAAO,CAAC,MAAM,CAAC,CA4JjB"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/core/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAG1B,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAkB,MAAM,mBAAmB,CAAC;AAuLzF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,GAAG,CAW7D;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,GAAG,EACR,UAAU,CAAC,EAAE,OAAO,EAAE,EACtB,QAAQ,CAAC,EAAE,SAAS,EAAE,GACrB,OAAO,CAAC,MAAM,CAAC,CA6JjB"}

package/dist/core/templates.js

@@ -2,13 +2,9 @@ import { Eta } from 'eta';
 import { join, dirname, relative, basename, posix } from 'path';
 import glob from 'fast-glob';
 import { TEMPLATE_EXTENSION } from '../constants.js';
-import { getStatiVersion } from './utils/version.js';
+import { getStatiVersion, isCollectionIndexPage, discoverLayout, getCollectionPathForPage, resolveSrcDir, createTemplateError, createValidatingPartialsProxy, propValue, } from './utils/index.js';
 import { getEnv } from '../env.js';
-import { isCollectionIndexPage, discoverLayout, getCollectionPathForPage, } from './utils/template-discovery.js';
-import { resolveSrcDir } from './utils/paths.js';
-import { createTemplateError } from './utils/template-errors.js';
-import { createValidatingPartialsProxy } from './utils/partial-validation.js';
-import { propValue } from './utils/template-utils.js';
+import { generateSEO } from '../seo/index.js';
 /**
  * Groups pages by their tags for aggregation purposes.
  *
@@ -198,7 +194,8 @@ export async function renderPage(page, body, config, eta, navigation, allPages)
         generator: {
             version: getStatiVersion(),
         },
-        // Template utilities
+        // Stati utilities object with helper functions
+        generateSEO: (tags) => generateSEO({ page, config, site: config.site }, tags),
         propValue,
     };
     // Render partials and store their content

package/dist/core/utils/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Core utilities index
+ * @module core/utils
+ */
+export { readFile, writeFile, pathExists, ensureDir, remove, copyFile, readdir, stat, } from './fs.js';
+export { resolveSrcDir, resolveOutDir, resolveStaticDir, resolveCacheDir, resolveDevPaths, normalizeTemplatePath, resolveSrcPath, resolveOutPath, resolveStaticPath, } from './paths.js';
+export { discoverLayout, isCollectionIndexPage, getCollectionPathForPage, } from './template-discovery.js';
+export { propValue } from './template-utils.js';
+export { createValidatingPartialsProxy } from './partial-validation.js';
+export { TemplateError, parseEtaError, createTemplateError } from './template-errors.js';
+export { resolvePrettyUrl } from './server.js';
+export type { PrettyUrlResult } from './server.js';
+export { createErrorOverlay, parseErrorDetails } from './error-overlay.js';
+export type { ErrorDetails } from './error-overlay.js';
+export { getStatiVersion } from './version.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,QAAQ,EACR,SAAS,EACT,UAAU,EACV,SAAS,EACT,MAAM,EACN,QAAQ,EACR,OAAO,EACP,IAAI,GACL,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGhD,OAAO,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AAGxE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/core/utils/index.js

@@ -0,0 +1,22 @@
+/**
+ * Core utilities index
+ * @module core/utils
+ */
+// File system utilities
+export { readFile, writeFile, pathExists, ensureDir, remove, copyFile, readdir, stat, } from './fs.js';
+// Path resolution utilities
+export { resolveSrcDir, resolveOutDir, resolveStaticDir, resolveCacheDir, resolveDevPaths, normalizeTemplatePath, resolveSrcPath, resolveOutPath, resolveStaticPath, } from './paths.js';
+// Template discovery utilities
+export { discoverLayout, isCollectionIndexPage, getCollectionPathForPage, } from './template-discovery.js';
+// Template utilities
+export { propValue } from './template-utils.js';
+// Partial validation utilities
+export { createValidatingPartialsProxy } from './partial-validation.js';
+// Template error utilities
+export { TemplateError, parseEtaError, createTemplateError } from './template-errors.js';
+// Server utilities
+export { resolvePrettyUrl } from './server.js';
+// Error overlay utilities
+export { createErrorOverlay, parseErrorDetails } from './error-overlay.js';
+// Version utilities
+export { getStatiVersion } from './version.js';

package/dist/core/utils/partial-validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"partial-validation.d.ts","sourceRoot":"","sources":["../../../src/core/utils/partial-validation.ts"],"names":[],"mappings":"AA4FA;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAmDxB"}
+{"version":3,"file":"partial-validation.d.ts","sourceRoot":"","sources":["../../../src/core/utils/partial-validation.ts"],"names":[],"mappings":"AA8FA;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAmDxB"}

package/dist/core/utils/partial-validation.js

@@ -1,3 +1,4 @@
+import { getEnv } from '../../env.js';
 /**
  * Creates inline error overlay HTML for missing partials
  */
@@ -88,7 +89,7 @@ function findSimilarPartialNames(targetName, availableNames) {
 export function createValidatingPartialsProxy(partials) {
     // In production, return partials as-is
     // Only skip validation if explicitly set to production
-    if (process.env.NODE_ENV === 'production') {
+    if (getEnv() === 'production') {
         return partials;
     }
     return new Proxy(partials, {

package/dist/index.d.ts

@@ -20,15 +20,13 @@
  * ```
  */
 export type { StatiConfig, PageModel, FrontMatter, BuildContext, PageContext, BuildHooks, NavNode, ISGConfig, AgingRule, BuildStats, } from './types/index.js';
-export type { BuildOptions } from './core/build.js';
-export type { DevServerOptions } from './core/dev.js';
-export type { PreviewServerOptions } from './core/preview.js';
-export type { InvalidationResult } from './core/invalidate.js';
-export { build } from './core/build.js';
-export { createDevServer } from './core/dev.js';
-export { createPreviewServer } from './core/preview.js';
+export type { SEOMetadata, SEOConfig, SEOContext, SEOValidationResult, SEOTagType, RobotsConfig, OpenGraphConfig, OpenGraphImage, OpenGraphArticle, TwitterCardConfig, AuthorConfig, } from './types/index.js';
+export type { SitemapConfig, SitemapEntry, SitemapGenerationResult, ChangeFrequency, } from './types/index.js';
+export type { BuildOptions, DevServerOptions, PreviewServerOptions, InvalidationResult, } from './core/index.js';
+export { build, createDevServer, createPreviewServer, invalidate } from './core/index.js';
+export type { AutoInjectOptions } from './seo/index.js';
+export { generateSEOMetadata, generateSEO, generateOpenGraphTags, generateTwitterCardTags, generateSitemap, generateSitemapEntry, generateSitemapXml, generateSitemapIndexXml, generateRobotsTxt, generateRobotsTxtFromConfig, escapeHtml, generateRobotsContent, validateSEOMetadata, detectExistingSEOTags, normalizeUrlPath, resolveAbsoluteUrl, isValidUrl, autoInjectSEO, shouldAutoInject, } from './seo/index.js';
 export { loadConfig } from './config/loader.js';
-export { invalidate } from './core/invalidate.js';
 export { setEnv, getEnv } from './env.js';
 import type { StatiConfig } from './types/index.js';
 /**

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,YAAY,EACV,WAAW,EACX,SAAS,EACT,WAAW,EACX,YAAY,EACZ,WAAW,EACX,UAAU,EACV,OAAO,EACP,SAAS,EACT,SAAS,EACT,UAAU,GACX,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAG1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAE7D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,YAAY,EACV,WAAW,EACX,SAAS,EACT,WAAW,EACX,YAAY,EACZ,WAAW,EACX,UAAU,EACV,OAAO,EACP,SAAS,EACT,SAAS,EACT,UAAU,GACX,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,mBAAmB,EACnB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,GACb,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,aAAa,EACb,YAAY,EACZ,uBAAuB,EACvB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG1F,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,2BAA2B,EAC3B,UAAU,EACV,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAG1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAE7D"}

package/dist/index.js

@@ -19,11 +19,10 @@
  * await build({ clean: true });
  * ```
  */
-export { build } from './core/build.js';
-export { createDevServer } from './core/dev.js';
-export { createPreviewServer } from './core/preview.js';
+export { build, createDevServer, createPreviewServer, invalidate } from './core/index.js';
+export { generateSEOMetadata, generateSEO, generateOpenGraphTags, generateTwitterCardTags, generateSitemap, generateSitemapEntry, generateSitemapXml, generateSitemapIndexXml, generateRobotsTxt, generateRobotsTxtFromConfig, escapeHtml, generateRobotsContent, validateSEOMetadata, detectExistingSEOTags, normalizeUrlPath, resolveAbsoluteUrl, isValidUrl, autoInjectSEO, shouldAutoInject, } from './seo/index.js';
+// Re-export config and env utilities
 export { loadConfig } from './config/loader.js';
-export { invalidate } from './core/invalidate.js';
 export { setEnv, getEnv } from './env.js';
 /**
  * Helper function for defining Stati configuration with TypeScript IntelliSense.

package/dist/seo/auto-inject.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Automatic SEO tag injection utilities
+ * @module seo/auto-inject
+ */
+import type { PageModel } from '../types/content.js';
+import type { StatiConfig } from '../types/config.js';
+import type { Logger } from '../types/logging.js';
+/**
+ * Options for auto-injection
+ */
+export interface AutoInjectOptions {
+    /** Page model with frontmatter and metadata */
+    page: PageModel;
+    /** Site configuration */
+    config: StatiConfig;
+    /** Site base URL */
+    siteUrl: string;
+    /** Logger for debug output */
+    logger: Logger;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+/**
+ * Automatically injects SEO metadata into HTML if not already present
+ * @param html - Rendered HTML content
+ * @param options - Auto-injection options
+ * @returns HTML with injected SEO tags
+ *
+ * @example
+ * ```typescript
+ * const html = '<html><head><title>Page</title></head><body>Content</body></html>';
+ * const enhanced = autoInjectSEO(html, {
+ *   page: pageModel,
+ *   config: statiConfig,
+ *   siteUrl: 'https://example.com'
+ * });
+ * // Returns HTML with additional SEO meta tags injected
+ * ```
+ */
+export declare function autoInjectSEO(html: string, options: AutoInjectOptions): string;
+/**
+ * Checks if auto-injection is enabled for a page
+ * @param config - Site configuration
+ * @param _page - Page model (reserved for future page-level overrides)
+ * @returns true if auto-injection should run
+ */
+export declare function shouldAutoInject(config: StatiConfig, _page: PageModel): boolean;
+//# sourceMappingURL=auto-inject.d.ts.map

package/dist/seo/auto-inject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-inject.d.ts","sourceRoot":"","sources":["../../src/seo/auto-inject.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAIlD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,IAAI,EAAE,SAAS,CAAC;IAChB,yBAAyB;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA8BD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAgE9E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,GAAG,OAAO,CAK/E"}

package/dist/seo/auto-inject.js

@@ -0,0 +1,108 @@
+/**
+ * Automatic SEO tag injection utilities
+ * @module seo/auto-inject
+ */
+import { detectExistingSEOTags } from './utils/index.js';
+import { generateSEOMetadata } from './generator.js';
+/**
+ * Helper function to conditionally log debug messages for SEO auto-injection.
+ * Checks both the explicit debug flag and the config-level debug setting.
+ *
+ * @param message - Debug message to log
+ * @param options - Object containing debug flag, config, and logger
+ */
+function logDebug(message, options) {
+    if (options.debug || options.config.seo?.debug) {
+        const logMessage = `[SEO Auto-Inject] ${message}`;
+        options.logger.warning(logMessage);
+    }
+}
+/**
+ * Finds the position to inject SEO tags (before </head>)
+ * @param html - HTML content
+ * @returns Position index or -1 if not found
+ */
+function findHeadClosePosition(html) {
+    // Case-insensitive search for </head>
+    const match = html.match(/<\/head>/i);
+    return match ? (match.index ?? -1) : -1;
+}
+/**
+ * Automatically injects SEO metadata into HTML if not already present
+ * @param html - Rendered HTML content
+ * @param options - Auto-injection options
+ * @returns HTML with injected SEO tags
+ *
+ * @example
+ * ```typescript
+ * const html = '<html><head><title>Page</title></head><body>Content</body></html>';
+ * const enhanced = autoInjectSEO(html, {
+ *   page: pageModel,
+ *   config: statiConfig,
+ *   siteUrl: 'https://example.com'
+ * });
+ * // Returns HTML with additional SEO meta tags injected
+ * ```
+ */
+export function autoInjectSEO(html, options) {
+    const { page, config, siteUrl, debug, logger } = options;
+    // Check if auto-injection is enabled (default: true)
+    const autoInjectEnabled = config.seo?.autoInject !== false;
+    if (!autoInjectEnabled) {
+        logDebug(`Skipped for ${page.url} (disabled in config)`, { debug, config, logger });
+        return html;
+    }
+    // Detect existing SEO tags in the HTML
+    const existingTags = detectExistingSEOTags(html);
+    logDebug(`Existing tags in ${page.url}: ${Array.from(existingTags).join(', ')}`, {
+        debug,
+        config,
+        logger,
+    });
+    // Build context with optional exclude parameter and logger
+    const context = {
+        page,
+        config,
+        siteUrl,
+        logger,
+    };
+    // Only add exclude if we have existing tags
+    if (existingTags.size > 0) {
+        context.exclude = existingTags;
+    }
+    // Generate SEO metadata excluding existing tags
+    const seoMetadata = generateSEOMetadata(context);
+    // If no SEO metadata was generated (all tags exist), return original HTML
+    if (!seoMetadata || seoMetadata.trim().length === 0) {
+        logDebug(`No tags to inject for ${page.url} (all exist)`, { debug, config, logger });
+        return html;
+    }
+    // Find position to inject (before </head>)
+    const headClosePos = findHeadClosePosition(html);
+    if (headClosePos === -1) {
+        logDebug(`No </head> tag found in ${page.url}, skipping injection`, { debug, config, logger });
+        return html;
+    }
+    // Inject SEO metadata before </head>
+    const before = html.substring(0, headClosePos);
+    const after = html.substring(headClosePos);
+    // Add proper indentation (2 spaces) and newline
+    const injected = `${before}  ${seoMetadata}\n${after}`;
+    logDebug(`Injected ${existingTags.size === 0 ? 'all' : 'missing'} SEO tags into ${page.url}`, {
+        debug,
+        config,
+        logger,
+    });
+    return injected;
+}
+/**
+ * Checks if auto-injection is enabled for a page
+ * @param config - Site configuration
+ * @param _page - Page model (reserved for future page-level overrides)
+ * @returns true if auto-injection should run
+ */
+export function shouldAutoInject(config, _page) {
+    // Check global config
+    const globalEnabled = config.seo?.autoInject !== false;
+    return globalEnabled;
+}