@stati/core 1.27.0 → 1.27.2

package/dist/core/build.js

@@ -273,7 +273,7 @@ async function processPagesWithCache(pages, manifest, config, outDir, md, eta, n
         const shouldRebuild = options.force ||
             config.isg?.enabled === false ||
             !(await pathExists(outputPath)) ||
-            (await shouldRebuildPage(page, existingEntry, config, buildTime, renderInputsHash));
+            (await shouldRebuildPage(page, existingEntry, config, pages, buildTime, renderInputsHash));
         const shouldRebuildTime = performance.now() - shouldRebuildStart;
         totalShouldRebuildTime += shouldRebuildTime;
         if (!shouldRebuild) {
@@ -357,10 +357,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, buildTime, false, renderInputsHash);
+                    manifest.entries[cacheKey] = await updateCacheEntry(existingEntry, page, config, pages, buildTime, false, renderInputsHash);
                 }
                 else {
-                    manifest.entries[cacheKey] = await createCacheEntry(page, config, buildTime, renderInputsHash);
+                    manifest.entries[cacheKey] = await createCacheEntry(page, config, pages, buildTime, renderInputsHash);
                 }
                 totalCacheEntryTime += performance.now() - cacheEntryStart;
             }
@@ -393,11 +393,11 @@ async function processPagesWithCache(pages, manifest, config, outDir, md, eta, n
             for (const { cacheKey, page, existingEntry, renderInputsHash } of pendingCacheUpdates) {
                 if (existingEntry) {
                     // Fast update: reuse existing deps, just update hashes and timestamp
-                    manifest.entries[cacheKey] = await updateCacheEntry(existingEntry, page, config, buildTime, true, // fastUpdate = true in dev mode
+                    manifest.entries[cacheKey] = await updateCacheEntry(existingEntry, page, config, pages, buildTime, true, // fastUpdate = true in dev mode
                     renderInputsHash);
                 }
                 else {
-                    manifest.entries[cacheKey] = await createCacheEntry(page, config, buildTime, renderInputsHash);
+                    manifest.entries[cacheKey] = await createCacheEntry(page, config, pages, buildTime, renderInputsHash);
                 }
             }
             totalCacheEntryTime = performance.now() - cacheEntryStart;

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;AAGhE;;;;;;;;;;;;;;;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,CAgDtB"}

package/dist/core/content.js

@@ -1,5 +1,5 @@
 import glob from 'fast-glob';
-import { readFile, resolveSrcDir } from './utils/index.js';
+import { readFile, resolveSrcDir, getFrontMatterDate } from './utils/index.js';
 import matter from 'gray-matter';
 import { relative, dirname, basename } from 'node:path';
 import { MARKDOWN_EXTENSION } from '../constants.js';
@@ -49,8 +49,11 @@ export async function loadContent(config, includeDrafts) {
             frontMatter,
             content: markdown,
         };
-        if (frontMatter.publishedAt && typeof frontMatter.publishedAt === 'string') {
-            page.publishedAt = new Date(frontMatter.publishedAt);
+        const publishedAt = getFrontMatterDate(frontMatter, (field, value) => {
+            console.warn(`Ignoring invalid date in "${field}" of ${file}: ${describeDateValue(value)}`);
+        });
+        if (publishedAt) {
+            page.publishedAt = publishedAt;
         }
         pages.push(page);
     }
@@ -64,6 +67,19 @@ function computeSlug(relativePath) {
     }
     return dir === '.' ? `/${name}` : `/${dir}/${name}`;
 }
+/**
+ * Describes a rejected front matter date for a warning without calling the value's
+ * own conversion methods, which a YAML mapping such as `{ toString: x }` can break.
+ */
+function describeDateValue(value) {
+    if (typeof value === 'string') {
+        return JSON.stringify(value);
+    }
+    if (typeof value === 'object' && !(value instanceof Date)) {
+        return Array.isArray(value) ? 'a list' : 'a mapping';
+    }
+    return String(value);
+}
 function computeUrl(slug, frontMatter) {
     if (frontMatter.permalink && typeof frontMatter.permalink === 'string') {
         return frontMatter.permalink;

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

@@ -7,34 +7,36 @@ import type { PageModel, CacheEntry, StatiConfig } from '../../types/index.js';
  * @param page - The page model to check
  * @param entry - Existing cache entry, or undefined if not cached
  * @param config - Stati configuration
+ * @param allPages - All pages in the site, used to resolve the same layout as rendering
  * @param now - Current date/time
  * @param renderInputsHash - Optional hash of asset URLs and injection settings
  * @returns True if the page should be rebuilt
  *
  * @example
  * ```typescript
- * const shouldRebuild = await shouldRebuildPage(page, cacheEntry, config, new Date());
+ * const shouldRebuild = await shouldRebuildPage(page, cacheEntry, config, pages, new Date());
  * if (shouldRebuild) {
  *   console.log('Page needs rebuilding');
  * }
  * ```
  */
-export declare function shouldRebuildPage(page: PageModel, entry: CacheEntry | undefined, config: StatiConfig, now: Date, renderInputsHash?: string): Promise<boolean>;
+export declare function shouldRebuildPage(page: PageModel, entry: CacheEntry | undefined, config: StatiConfig, allPages: PageModel[], now: Date, renderInputsHash?: string): Promise<boolean>;
 /**
  * Creates a new cache entry for a page after it has been rendered.
  *
  * @param page - The page model
  * @param config - Stati configuration
+ * @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
  * @returns New cache entry
  *
  * @example
  * ```typescript
- * const entry = await createCacheEntry(page, config, new Date());
+ * const entry = await createCacheEntry(page, config, pages, new Date());
  * ```
  */
-export declare function createCacheEntry(page: PageModel, config: StatiConfig, renderedAt: Date, renderInputsHash?: string): Promise<CacheEntry>;
+export declare function createCacheEntry(page: PageModel, config: StatiConfig, allPages: PageModel[], renderedAt: Date, renderInputsHash?: string): 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
@@ -43,6 +45,7 @@ export declare function createCacheEntry(page: PageModel, config: StatiConfig, r
  * @param entry - Existing cache entry
  * @param page - The page model
  * @param config - Stati configuration
+ * @param allPages - All pages in the site, used to resolve the same layout as rendering
  * @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
@@ -50,8 +53,8 @@ export declare function createCacheEntry(page: PageModel, config: StatiConfig, r
  *
  * @example
  * ```typescript
- * const updatedEntry = await updateCacheEntry(existingEntry, page, config, new Date());
+ * const updatedEntry = await updateCacheEntry(existingEntry, page, config, pages, new Date());
  * ```
  */
-export declare function updateCacheEntry(entry: CacheEntry, page: PageModel, config: StatiConfig, 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): 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;AAoE/E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,UAAU,GAAG,SAAS,EAC7B,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,IAAI,EACT,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,OAAO,CAAC,CAoKlB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,IAAI,EAChB,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,UAAU,CAAC,CAqFrB;AAkDD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,IAAI,EAChB,UAAU,UAAQ,EAClB,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,UAAU,CAAC,CA4CrB"}
+{"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"}

package/dist/core/isg/builder.js

@@ -1,7 +1,8 @@
 import { computeContentHash, computeFileHash, computeInputsHash } from './hash.js';
-import { trackTemplateDependencies } from './deps.js';
+import { trackTemplateDependencies, resolveLayoutDependency } from './deps.js';
 import { computeEffectiveTTL, computeNextRebuildAt, isPageFrozen } from './ttl.js';
 import { validatePageISGOverrides, extractNumericOverride } from './validation.js';
+import { getFrontMatterDate } from '../utils/index.js';
 import { performance } from 'node:perf_hooks';
 /**
  * Determines the output path for a page.
@@ -64,19 +65,20 @@ function isValidCacheEntry(entry) {
  * @param page - The page model to check
  * @param entry - Existing cache entry, or undefined if not cached
  * @param config - Stati configuration
+ * @param allPages - All pages in the site, used to resolve the same layout as rendering
  * @param now - Current date/time
  * @param renderInputsHash - Optional hash of asset URLs and injection settings
  * @returns True if the page should be rebuilt
  *
  * @example
  * ```typescript
- * const shouldRebuild = await shouldRebuildPage(page, cacheEntry, config, new Date());
+ * const shouldRebuild = await shouldRebuildPage(page, cacheEntry, config, pages, new Date());
  * if (shouldRebuild) {
  *   console.log('Page needs rebuilding');
  * }
  * ```
  */
-export async function shouldRebuildPage(page, entry, config, now, renderInputsHash) {
+export async function shouldRebuildPage(page, entry, config, allPages, now, renderInputsHash) {
     if (config.isg?.enabled === false) {
         return true;
     }
@@ -95,7 +97,7 @@ export async function shouldRebuildPage(page, entry, config, now, renderInputsHa
         // Track dependencies with error handling
         let deps;
         try {
-            deps = await trackTemplateDependencies(page, config);
+            deps = await trackTemplateDependencies(page, config, allPages);
         }
         catch (error) {
             if (error instanceof Error && error.name === 'CircularDependencyError') {
@@ -210,16 +212,17 @@ export async function shouldRebuildPage(page, entry, config, now, renderInputsHa
  *
  * @param page - The page model
  * @param config - Stati configuration
+ * @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
  * @returns New cache entry
  *
  * @example
  * ```typescript
- * const entry = await createCacheEntry(page, config, new Date());
+ * const entry = await createCacheEntry(page, config, pages, new Date());
  * ```
  */
-export async function createCacheEntry(page, config, renderedAt, renderInputsHash) {
+export async function createCacheEntry(page, config, allPages, renderedAt, renderInputsHash) {
     const timings = {};
     let start = performance.now();
     // Validate page-level ISG overrides first
@@ -231,7 +234,7 @@ export async function createCacheEntry(page, config, renderedAt, renderInputsHas
     timings.contentHash = performance.now() - start;
     // Track all template dependencies
     start = performance.now();
-    const deps = await trackTemplateDependencies(page, config);
+    const deps = await trackTemplateDependencies(page, config, allPages);
     timings.trackDeps = performance.now() - start;
     // Compute hashes for all dependencies
     start = performance.now();
@@ -338,6 +341,7 @@ async function hasTemplateStructureChanged(entry) {
  * @param entry - Existing cache entry
  * @param page - The page model
  * @param config - Stati configuration
+ * @param allPages - All pages in the site, used to resolve the same layout as rendering
  * @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
@@ -345,19 +349,24 @@ async function hasTemplateStructureChanged(entry) {
  *
  * @example
  * ```typescript
- * const updatedEntry = await updateCacheEntry(existingEntry, page, config, new Date());
+ * const updatedEntry = await updateCacheEntry(existingEntry, page, config, pages, new Date());
  * ```
  */
-export async function updateCacheEntry(entry, page, config, renderedAt, fastUpdate = false, renderInputsHash) {
+export async function updateCacheEntry(entry, page, config, allPages, renderedAt, fastUpdate = false, renderInputsHash) {
     // 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)
         // by checking if the layout file has been modified or if template content
         // contains different dependency patterns
         const structureChanged = await hasTemplateStructureChanged(entry);
-        if (structureChanged) {
-            // Template structure changed - fall through to full dependency tracking
-            // This ensures we pick up new includes/extends
+        // The page can also switch layouts without any template file changing, for example
+        // when a collection gains its first child page or a front matter layout is edited.
+        // deps[0] is always the layout, so compare it against the layout used now.
+        const layoutChanged = !structureChanged &&
+            (await resolveLayoutDependency(page, config, allPages)) !== entry.deps[0];
+        if (structureChanged || layoutChanged) {
+            // Template structure or layout changed - fall through to full dependency tracking
+            // This ensures we pick up new includes/extends and the newly selected layout
         }
         else {
             // Structure unchanged - safe to reuse existing deps
@@ -380,7 +389,7 @@ export async function updateCacheEntry(entry, page, config, renderedAt, fastUpda
         }
     }
     // Full update - create new entry and preserve original publishedAt
-    const newEntry = await createCacheEntry(page, config, renderedAt, renderInputsHash);
+    const newEntry = await createCacheEntry(page, config, allPages, renderedAt, renderInputsHash);
     // Preserve original publishedAt if no new one is specified
     if (!newEntry.publishedAt && entry.publishedAt) {
         newEntry.publishedAt = entry.publishedAt;
@@ -391,24 +400,5 @@ export async function updateCacheEntry(entry, page, config, renderedAt, fastUpda
  * Helper function to get published date as ISO string from page front matter.
  */
 function getPublishedDateISO(page) {
-    const frontMatter = page.frontMatter;
-    // Try common field names for published date
-    const dateFields = ['publishedAt', 'published', 'date', 'createdAt'];
-    for (const field of dateFields) {
-        const value = frontMatter[field];
-        if (value) {
-            // Handle string dates
-            if (typeof value === 'string') {
-                const date = new Date(value);
-                if (!isNaN(date.getTime())) {
-                    return date.toISOString();
-                }
-            }
-            // Handle Date objects
-            if (value instanceof Date && !isNaN(value.getTime())) {
-                return value.toISOString();
-            }
-        }
-    }
-    return undefined;
+    return getFrontMatterDate(page.frontMatter)?.toISOString();
 }

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

@@ -22,13 +22,14 @@ export declare class CircularDependencyError extends Error {
  *
  * @param page - The page model to track dependencies for
  * @param config - Stati configuration
+ * @param allPages - All pages in the site, used to detect collection index pages the same way rendering does
  * @returns Array of absolute paths to actually-used template files (POSIX format)
  * @throws {CircularDependencyError} When circular dependencies are detected in templates
  *
  * @example
  * ```typescript
  * try {
- *   const deps = await trackTemplateDependencies(page, config);
+ *   const deps = await trackTemplateDependencies(page, config, allPages);
  *   console.log(`Page depends on ${deps.length} template files`);
  * } catch (error) {
  *   if (error instanceof CircularDependencyError) {
@@ -37,7 +38,18 @@ export declare class CircularDependencyError extends Error {
  * }
  * ```
  */
-export declare function trackTemplateDependencies(page: PageModel, config: StatiConfig): Promise<string[]>;
+export declare function trackTemplateDependencies(page: PageModel, config: StatiConfig, allPages: PageModel[]): Promise<string[]>;
+/**
+ * Resolves the layout a page renders with, in the form stored as the first entry of its
+ * cache dependencies. Uses the same lookup as rendering, so callers can tell whether the
+ * page's layout has changed since its dependencies were recorded.
+ *
+ * @param page - The page model to resolve the layout for
+ * @param config - Stati configuration
+ * @param allPages - All pages in the site, used to detect collection index pages the same way rendering does
+ * @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 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;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,MAAM,EAAE,CAAC,CA+CnB;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;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"}

package/dist/core/isg/deps.js

@@ -42,13 +42,14 @@ export class CircularDependencyError extends Error {
  *
  * @param page - The page model to track dependencies for
  * @param config - Stati configuration
+ * @param allPages - All pages in the site, used to detect collection index pages the same way rendering does
  * @returns Array of absolute paths to actually-used template files (POSIX format)
  * @throws {CircularDependencyError} When circular dependencies are detected in templates
  *
  * @example
  * ```typescript
  * try {
- *   const deps = await trackTemplateDependencies(page, config);
+ *   const deps = await trackTemplateDependencies(page, config, allPages);
  *   console.log(`Page depends on ${deps.length} template files`);
  * } catch (error) {
  *   if (error instanceof CircularDependencyError) {
@@ -57,7 +58,7 @@ export class CircularDependencyError extends Error {
  * }
  * ```
  */
-export async function trackTemplateDependencies(page, config) {
+export async function trackTemplateDependencies(page, config, allPages) {
     // Early return if required config values are missing
     if (!config.srcDir) {
         console.warn('Config srcDir is missing, cannot track template dependencies');
@@ -65,16 +66,13 @@ export async function trackTemplateDependencies(page, config) {
     }
     const deps = [];
     const srcDir = resolveSrcDir(config);
-    const relativePath = relative(srcDir, page.sourcePath);
     // Track dependencies with circular detection
     // The visited set will contain all templates that are actually used (not just accessible)
     const visited = new Set();
     const currentPath = new Set();
     // 1. Find the layout file that will be used for this page
-    const layoutPath = await discoverLayout(relativePath, config, page.frontMatter.layout, isCollectionIndexPage(page));
-    if (layoutPath) {
-        // Normalize to POSIX format for consistent manifest output across platforms
-        const absoluteLayoutPath = posix.join(srcDir.replace(/\\/g, '/'), layoutPath);
+    const absoluteLayoutPath = await resolveLayoutDependency(page, config, allPages);
+    if (absoluteLayoutPath) {
         deps.push(absoluteLayoutPath);
         // Recursively traverse the template dependency tree
         // This populates 'visited' with all actually-used templates (not just accessible ones)
@@ -93,6 +91,25 @@ export async function trackTemplateDependencies(page, config) {
     }
     return deps;
 }
+/**
+ * Resolves the layout a page renders with, in the form stored as the first entry of its
+ * cache dependencies. Uses the same lookup as rendering, so callers can tell whether the
+ * page's layout has changed since its dependencies were recorded.
+ *
+ * @param page - The page model to resolve the layout for
+ * @param config - Stati configuration
+ * @param allPages - All pages in the site, used to detect collection index pages the same way rendering does
+ * @returns Absolute path to the layout file (POSIX format), or null if no layout applies
+ */
+export async function resolveLayoutDependency(page, config, allPages) {
+    if (!config.srcDir) {
+        return null;
+    }
+    const srcDir = resolveSrcDir(config);
+    const layoutPath = await discoverLayout(relative(srcDir, page.sourcePath), config, page.frontMatter.layout, isCollectionIndexPage(page, allPages));
+    // Normalize to POSIX format for consistent manifest output across platforms
+    return layoutPath ? posix.join(srcDir.replace(/\\/g, '/'), layoutPath) : null;
+}
 /**
  * Resolves a template name to its file path.
  * Used for explicit layout specifications in front matter.

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

@@ -1 +1 @@
-{"version":3,"file":"ttl.d.ts","sourceRoot":"","sources":["../../../src/core/isg/ttl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAQxF;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,CAAC,EAAE,IAAI,GAAG,IAAI,CAW5D;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAqB5E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,SAAS,EACf,SAAS,EAAE,SAAS,EACpB,WAAW,CAAC,EAAE,IAAI,GACjB,MAAM,CAkBR;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,GAAG,EAAE,IAAI,CAAC;IACV,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,IAAI,GAAG,IAAI,CAqBd;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAiBlE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,IAAI,EACjB,UAAU,EAAE,SAAS,EAAE,EACvB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,IAAI,GACR,MAAM,CAyBR"}
+{"version":3,"file":"ttl.d.ts","sourceRoot":"","sources":["../../../src/core/isg/ttl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AASxF;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,CAAC,EAAE,IAAI,GAAG,IAAI,CAW5D;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAqB5E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,SAAS,EACf,SAAS,EAAE,SAAS,EACpB,WAAW,CAAC,EAAE,IAAI,GACjB,MAAM,CAkBR;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,GAAG,EAAE,IAAI,CAAC;IACV,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,IAAI,GAAG,IAAI,CAqBd;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAiBlE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,IAAI,EACjB,UAAU,EAAE,SAAS,EAAE,EACvB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,IAAI,GACR,MAAM,CAyBR"}

package/dist/core/isg/ttl.js

@@ -1,4 +1,5 @@
 import { CLOCK_DRIFT_TOLERANCE_MS, DEFAULT_TTL_SECONDS, MILLISECONDS_PER_DAY, } from '../../constants.js';
+import { getFrontMatterDate } from '../utils/index.js';
 // dedup: time constants centralized in constants.ts
 /**
  * Safely gets the current UTC time with drift protection.
@@ -189,31 +190,8 @@ export function applyAgingRules(publishedAt, agingRules, defaultTTL, now) {
 }
 /**
  * Helper function to extract published date from page front matter.
- * Supports various date formats and field names.
- * Uses safe date parsing to handle timezone issues.
+ * Uses the shared field order from {@link getFrontMatterDate}.
  */
 function getPublishedDate(page) {
-    const frontMatter = page.frontMatter;
-    // Try common field names for published date
-    const dateFields = ['publishedAt', 'published', 'date', 'createdAt'];
-    for (const field of dateFields) {
-        const value = frontMatter[field];
-        if (value) {
-            // Handle string dates
-            if (typeof value === 'string') {
-                const safeDate = parseSafeDate(value, `front-matter field "${field}" in ${page.sourcePath}`);
-                if (safeDate) {
-                    return safeDate;
-                }
-            }
-            // Handle Date objects
-            if (value instanceof Date) {
-                const safeDate = getSafeCurrentTime(value);
-                if (!isNaN(safeDate.getTime())) {
-                    return safeDate;
-                }
-            }
-        }
-    }
-    return null;
+    return getFrontMatterDate(page.frontMatter) ?? null;
 }

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

@@ -0,0 +1,31 @@
+/**
+ * Date utilities for reading publish dates from front matter.
+ * @module core/utils/date
+ */
+/**
+ * Front matter fields checked for a page's publish date, in priority order.
+ * Collections, navigation, ISG aging and RSS all use this order.
+ */
+export declare const PUBLISHED_DATE_FIELDS: readonly ["publishedAt", "published", "date", "createdAt"];
+/**
+ * Returns the publish date from front matter, or `undefined` if none is usable.
+ *
+ * Checks {@link PUBLISHED_DATE_FIELDS} in order and returns the first valid value.
+ * Accepts strings (quoted YAML dates) and `Date` objects (unquoted YAML dates,
+ * which gray-matter parses into `Date`). Missing, `null` and empty values are skipped;
+ * other invalid values are reported through `onInvalid` and skipped, so a bad
+ * `publishedAt` does not hide a valid `date`.
+ *
+ * @param frontMatter - Parsed front matter of a page; `null`/`undefined` returns `undefined`
+ * @param onInvalid - Called for each present field whose value is not a valid date
+ * @returns A new `Date` instance, or `undefined`
+ *
+ * @example
+ * ```typescript
+ * getFrontMatterDate({ date: new Date('2026-01-01') }); // 2026-01-01T00:00:00.000Z
+ * getFrontMatterDate({ publishedAt: 'soon', date: '2026-06-01' }); // 2026-06-01T00:00:00.000Z
+ * getFrontMatterDate({ title: 'Undated' }); // undefined
+ * ```
+ */
+export declare function getFrontMatterDate(frontMatter: Record<string, unknown> | null | undefined, onInvalid?: (field: string, value: unknown) => void): Date | undefined;
+//# sourceMappingURL=date.utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"date.utils.d.ts","sourceRoot":"","sources":["../../../src/core/utils/date.utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,eAAO,MAAM,qBAAqB,4DAA6D,CAAC;AAEhG;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EACvD,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,GAClD,IAAI,GAAG,SAAS,CA0BlB"}

package/dist/core/utils/date.utils.js

@@ -0,0 +1,52 @@
+/**
+ * Date utilities for reading publish dates from front matter.
+ * @module core/utils/date
+ */
+/**
+ * Front matter fields checked for a page's publish date, in priority order.
+ * Collections, navigation, ISG aging and RSS all use this order.
+ */
+export const PUBLISHED_DATE_FIELDS = ['publishedAt', 'published', 'date', 'createdAt'];
+/**
+ * Returns the publish date from front matter, or `undefined` if none is usable.
+ *
+ * Checks {@link PUBLISHED_DATE_FIELDS} in order and returns the first valid value.
+ * Accepts strings (quoted YAML dates) and `Date` objects (unquoted YAML dates,
+ * which gray-matter parses into `Date`). Missing, `null` and empty values are skipped;
+ * other invalid values are reported through `onInvalid` and skipped, so a bad
+ * `publishedAt` does not hide a valid `date`.
+ *
+ * @param frontMatter - Parsed front matter of a page; `null`/`undefined` returns `undefined`
+ * @param onInvalid - Called for each present field whose value is not a valid date
+ * @returns A new `Date` instance, or `undefined`
+ *
+ * @example
+ * ```typescript
+ * getFrontMatterDate({ date: new Date('2026-01-01') }); // 2026-01-01T00:00:00.000Z
+ * getFrontMatterDate({ publishedAt: 'soon', date: '2026-06-01' }); // 2026-06-01T00:00:00.000Z
+ * getFrontMatterDate({ title: 'Undated' }); // undefined
+ * ```
+ */
+export function getFrontMatterDate(frontMatter, onInvalid) {
+    if (!frontMatter) {
+        return undefined;
+    }
+    for (const field of PUBLISHED_DATE_FIELDS) {
+        const value = frontMatter[field];
+        if (value === undefined || value === null || (typeof value === 'string' && !value.trim())) {
+            continue;
+        }
+        let date;
+        if (typeof value === 'string') {
+            date = new Date(value);
+        }
+        else if (value instanceof Date) {
+            date = new Date(value.getTime());
+        }
+        if (date && !isNaN(date.getTime())) {
+            return date;
+        }
+        onInvalid?.(field, value);
+    }
+    return undefined;
+}

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

@@ -27,6 +27,7 @@ export { createFallbackLogger } from './logger.utils.js';
 export { compileTypeScript, createTypeScriptWatcher, compileStatiConfig, cleanupCompiledConfig, autoInjectBundles, formatBytes, detectExistingBundles, } from './typescript.utils.js';
 export type { CompileOptions, WatchOptions } from './typescript.utils.js';
 export { findHeadClosePosition, injectBeforeHeadClose } from './html.utils.js';
+export { getFrontMatterDate, PUBLISHED_DATE_FIELDS } from './date.utils.js';
 export { isEnabledEnvFlag } from './env.utils.js';
 export { discoverOutputCssFiles, refreshCssOutputWatcher } from './dev-css-watcher.utils.js';
 export type { RefreshCssOutputWatcherParams } from './dev-css-watcher.utils.js';

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

@@ -1 +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,eAAe,CAAC;AAGvB,OAAO,EACL,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGhD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAG7C,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,2BAA2B,EAC3B,cAAc,EACd,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAG9E,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,EACrB,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGvE,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAC3F,YAAY,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAG/F,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAGxE,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACjF,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAG7D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGpE,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,WAAW,EACX,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1E,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAG/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGlD,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC7F,YAAY,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC"}
+{"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,eAAe,CAAC;AAGvB,OAAO,EACL,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGhD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAG7C,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,2BAA2B,EAC3B,cAAc,EACd,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAG9E,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,EACrB,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGvE,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAC3F,YAAY,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAG/F,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAGxE,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACjF,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAG7D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGpE,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,WAAW,EACX,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1E,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAG/E,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAG5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGlD,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC7F,YAAY,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/core/utils/index.js

@@ -42,6 +42,8 @@ export { createFallbackLogger } from './logger.utils.js';
 export { compileTypeScript, createTypeScriptWatcher, compileStatiConfig, cleanupCompiledConfig, autoInjectBundles, formatBytes, detectExistingBundles, } from './typescript.utils.js';
 // HTML manipulation utilities
 export { findHeadClosePosition, injectBeforeHeadClose } from './html.utils.js';
+// Date utilities
+export { getFrontMatterDate, PUBLISHED_DATE_FIELDS } from './date.utils.js';
 // Environment utilities
 export { isEnabledEnvFlag } from './env.utils.js';
 // Dev-server CSS watcher utilities

package/dist/core/utils/template-discovery.utils.d.ts

@@ -1,17 +1,19 @@
 import type { StatiConfig, PageModel } from '../../types/index.js';
-/**
- * Shared template discovery utilities.
- * Extracted from templates.ts and isg/deps.ts to eliminate duplication.
- */
 /**
  * Determines if the given page is a collection index page.
  * A collection index page is one whose URL matches a directory path that contains other pages.
  *
+ * Rendering and ISG dependency tracking must both call this with the same page list,
+ * otherwise they can pick different layouts for the same page.
+ *
+ * Page URLs are read once per `allPages` array, at the first call; see
+ * `directoryPrefixCache` for when changes to the pages are picked up.
+ *
  * @param page - The page to check
- * @param allPages - All pages in the site (optional for simplified check)
+ * @param allPages - All pages in the site (treated as unchanging after the first call)
  * @returns True if the page is a collection index page
  */
-export declare function isCollectionIndexPage(page: PageModel, allPages?: PageModel[]): boolean;
+export declare function isCollectionIndexPage(page: PageModel, allPages: PageModel[]): boolean;
 /**
  * Discovers layout files by searching up the directory hierarchy.
  * Supports both explicit layout specification and automatic discovery.

package/dist/core/utils/template-discovery.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template-discovery.utils.d.ts","sourceRoot":"","sources":["../../../src/core/utils/template-discovery.utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAInE;;;GAGG;AAEH;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,SAAS,EAAE,GAAG,OAAO,CAkBtF;AAED;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,EACnB,cAAc,CAAC,EAAE,MAAM,EACvB,WAAW,CAAC,EAAE,OAAO,GACpB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAsDxB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAkBhE"}
+{"version":3,"file":"template-discovery.utils.d.ts","sourceRoot":"","sources":["../../../src/core/utils/template-discovery.utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAoDnE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,OAAO,CAUrF;AAED;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,EACnB,cAAc,CAAC,EAAE,MAAM,EACvB,WAAW,CAAC,EAAE,OAAO,GACpB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAsDxB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAkBhE"}

package/dist/core/utils/template-discovery.utils.js

@@ -3,15 +3,51 @@ import { pathExists } from './fs.utils.js';
 import { LAYOUT_TEMPLATE } from '../../constants.js';
 import { resolveSrcDir } from './paths.utils.js';
 /**
- * Shared template discovery utilities.
- * Extracted from templates.ts and isg/deps.ts to eliminate duplication.
+ * Directory prefix index per page list, so a build computes it once instead of
+ * scanning every page for every page.
+ *
+ * The index is a snapshot of the page URLs taken at the first lookup for a given array,
+ * and every later lookup for that array reuses it. In a build the first lookup happens
+ * in the render loop, after the `beforeAll` hook, so URL changes made there are included.
+ * Changes made to the same array or its pages after that are not seen; a fresh build
+ * loads a new array and gets a new snapshot. Taking one snapshot keeps rendering and
+ * ISG dependency tracking in agreement for the whole build.
  */
+const directoryPrefixCache = new WeakMap();
+function getDirectoryPrefixIndex(allPages) {
+    const cached = directoryPrefixCache.get(allPages);
+    if (cached) {
+        return cached;
+    }
+    const index = new Map();
+    for (const { url } of allPages) {
+        // Every prefix ending at a '/' is a directory this URL lives in (or is, for trailing-slash URLs)
+        for (let i = url.indexOf('/'); i !== -1; i = url.indexOf('/', i + 1)) {
+            const prefix = url.slice(0, i + 1);
+            const existing = index.get(prefix);
+            if (existing === undefined) {
+                index.set(prefix, url);
+            }
+            else if (existing !== null && existing !== url) {
+                index.set(prefix, null);
+            }
+        }
+    }
+    directoryPrefixCache.set(allPages, index);
+    return index;
+}
 /**
  * Determines if the given page is a collection index page.
  * A collection index page is one whose URL matches a directory path that contains other pages.
  *
+ * Rendering and ISG dependency tracking must both call this with the same page list,
+ * otherwise they can pick different layouts for the same page.
+ *
+ * Page URLs are read once per `allPages` array, at the first call; see
+ * `directoryPrefixCache` for when changes to the pages are picked up.
+ *
  * @param page - The page to check
- * @param allPages - All pages in the site (optional for simplified check)
+ * @param allPages - All pages in the site (treated as unchanging after the first call)
  * @returns True if the page is a collection index page
  */
 export function isCollectionIndexPage(page, allPages) {
@@ -19,15 +55,10 @@ export function isCollectionIndexPage(page, allPages) {
     if (page.url === '/') {
         return true;
     }
-    // If we have all pages, do a proper check
-    if (allPages) {
-        // Check if this page's URL is a directory path that contains other pages
-        const pageUrlAsDir = page.url.endsWith('/') ? page.url : page.url + '/';
-        return allPages.some((otherPage) => otherPage.url !== page.url && otherPage.url.startsWith(pageUrlAsDir));
-    }
-    // Simplified version when we don't have all pages
-    // Assume any page ending in /index or at root is a collection page
-    return page.url.endsWith('/index') || page.slug === 'index';
+    // The page is an index when a different page's URL lives under this page's URL as a directory
+    const pageUrlAsDir = page.url.endsWith('/') ? page.url : page.url + '/';
+    const containingUrl = getDirectoryPrefixIndex(allPages).get(pageUrlAsDir);
+    return containingUrl === null || (containingUrl !== undefined && containingUrl !== page.url);
 }
 /**
  * Discovers layout files by searching up the directory hierarchy.

package/dist/rss/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/rss/generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AA2KlD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,EAAE,EAClB,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,aAAa,EACzB,MAAM,CAAC,EAAE,MAAM,GACd,mBAAmB,CA4LrB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAAE,EAClB,MAAM,EAAE,WAAW,EACnB,MAAM,CAAC,EAAE,MAAM,GACd,mBAAmB,EAAE,CAcvB"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/rss/generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AA4KlD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,EAAE,EAClB,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,aAAa,EACzB,MAAM,CAAC,EAAE,MAAM,GACd,mBAAmB,CA4LrB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAAE,EAClB,MAAM,EAAE,WAAW,EACnB,MAAM,CAAC,EAAE,MAAM,GACd,mBAAmB,EAAE,CAcvB"}

package/dist/rss/generator.js

@@ -4,6 +4,7 @@
  */
 import { escapeHtml } from '../seo/utils/index.js';
 import { filterByPatterns } from './utils/index.js';
+import { getFrontMatterDate } from '../core/utils/index.js';
 /**
  * Formats a date for RSS pubDate field (RFC 822)
  * @param date - Date to format
@@ -59,7 +60,7 @@ function filterPages(pages, feedConfig) {
  * @returns Date value or undefined
  */
 function getPageDate(page) {
-    return page.frontMatter.publishedAt || page.frontMatter.date;
+    return getFrontMatterDate(page.frontMatter);
 }
 /**
  * Sorts pages based on feed configuration
@@ -85,7 +86,7 @@ function sortPages(pages, feedConfig) {
                     return 1;
                 if (!dateB)
                     return -1;
-                const comparison = new Date(dateA).getTime() - new Date(dateB).getTime();
+                const comparison = dateA.getTime() - dateB.getTime();
                 return sortBy === 'date-asc' ? comparison : -comparison;
             }
             case 'title-asc':
@@ -254,8 +255,9 @@ export function generateRSSFeed(pages, config, feedConfig, logger) {
             }
         }
         // Pub date
-        const pubDate = getFieldValue(page, itemMapping.pubDate, 'publishedAt', logger) ||
-            getFieldValue(page, itemMapping.pubDate, 'date', logger);
+        const pubDate = itemMapping.pubDate
+            ? getFieldValue(page, itemMapping.pubDate, undefined, logger)
+            : getPageDate(page);
         const formattedPubDate = parseAndFormatDate(pubDate);
         if (formattedPubDate) {
             xmlLines.push(`      <pubDate>${formattedPubDate}</pubDate>`);

package/dist/types/content.d.ts

@@ -79,10 +79,13 @@ export interface FrontMatter {
     layout?: string;
     /** Numeric order for sorting (useful for navigation) */
     order?: number;
-    /** Publication date as ISO string */
-    publishedAt?: string;
-    /** Publication date (alias for publishedAt) */
-    date?: string;
+    /**
+     * Publication date. A quoted YAML value is a string; an unquoted one
+     * (`publishedAt: 2024-01-01`) is parsed into a `Date`.
+     */
+    publishedAt?: string | Date;
+    /** Publication date, used when `publishedAt` and `published` are absent or invalid */
+    date?: string | Date;
     /** Last updated date as ISO string */
     updated?: string;
     /** Custom cache TTL in seconds (overrides global ISG settings) */
@@ -297,7 +300,7 @@ export interface PageModel {
     frontMatter: FrontMatter;
     /** Raw markdown content (before rendering) */
     content: string;
-    /** Publication date (parsed from front matter or file stats) */
+    /** Publication date, from the first valid of `publishedAt`, `published`, `date`, `createdAt` */
     publishedAt?: Date;
 }
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/types/content.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/types/content.ts"],"names":[],"mappings":"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"}

package/dist/types/rss.d.ts

@@ -144,7 +144,7 @@ export interface RSSFeedConfig {
          * Can be:
          * - A string property name from frontMatter (e.g., 'publishedAt', 'date')
          * - A function that returns a Date or string
-         * @default 'publishedAt' or 'date'
+         * @default The first valid date in `publishedAt`, `published`, `date`, `createdAt`
          */
         pubDate?: string | ((page: PageModel) => Date | string);
         /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stati/core",
-  "version": "1.27.0",
+  "version": "1.27.2",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",