@stati/core 1.3.0 → 1.3.2

package/dist/core/isg/hash.js

@@ -1,6 +1,24 @@
 import { createHash } from 'crypto';
-import fse from 'fs-extra';
-const { readFile, pathExists } = fse;
+import { readFile, pathExists } from '../utils/fs.js';
+/**
+ * Creates a SHA-256 hash instance, updates it with data, and returns the hex digest.
+ * Internal utility to eliminate duplicate hash creation patterns.
+ *
+ * @param data - Data to hash
+ * @returns SHA-256 hash as a hex string with 'sha256-' prefix
+ */
+function createSha256Hash(data) {
+    const hash = createHash('sha256');
+    if (Array.isArray(data)) {
+        for (const item of data) {
+            hash.update(item, 'utf-8');
+        }
+    }
+    else {
+        hash.update(data, 'utf-8');
+    }
+    return `sha256-${hash.digest('hex')}`;
+}
 /**
  * Computes a SHA-256 hash of page content and front matter.
  * Used to detect when page content has changed.
@@ -16,13 +34,9 @@ const { readFile, pathExists } = fse;
  * ```
  */
 export function computeContentHash(content, frontMatter) {
-    const hash = createHash('sha256');
-    // Hash the content
-    hash.update(content, 'utf-8');
     // Hash the front matter (sorted for consistency)
     const sortedFrontMatter = JSON.stringify(frontMatter, Object.keys(frontMatter).sort());
-    hash.update(sortedFrontMatter, 'utf-8');
-    return `sha256-${hash.digest('hex')}`;
+    return createSha256Hash([content, sortedFrontMatter]);
 }
 /**
  * Computes a SHA-256 hash of a file's contents.
@@ -45,9 +59,10 @@ export async function computeFileHash(filePath) {
             return null;
         }
         const content = await readFile(filePath, 'utf-8');
-        const hash = createHash('sha256');
-        hash.update(content, 'utf-8');
-        return `sha256-${hash.digest('hex')}`;
+        if (!content) {
+            return null;
+        }
+        return createSha256Hash(content);
     }
     catch (error) {
         console.warn(`Failed to compute hash for ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
@@ -70,13 +85,7 @@ export async function computeFileHash(filePath) {
  * ```
  */
 export function computeInputsHash(contentHash, depsHashes) {
-    const hash = createHash('sha256');
-    // Hash the content hash
-    hash.update(contentHash, 'utf-8');
     // Hash each dependency hash in sorted order for consistency
     const sortedDepsHashes = [...depsHashes].sort();
-    for (const depHash of sortedDepsHashes) {
-        hash.update(depHash, 'utf-8');
-    }
-    return `sha256-${hash.digest('hex')}`;
+    return createSha256Hash([contentHash, ...sortedDepsHashes]);
 }

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

@@ -1,4 +1,4 @@
-import type { CacheManifest } from '../../types.js';
+import type { CacheManifest } from '../../types/index.js';
 /**
  * Loads the ISG cache manifest from the cache directory.
  * Returns null if no manifest exists or if it's corrupted.

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

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/core/isg/manifest.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,gBAAgB,CAAC;AAchE;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAyFvF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA6ChG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAInD"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/core/isg/manifest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,sBAAsB,CAAC;AAUtE;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CA8FvF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAmEhG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAInD"}

package/dist/core/isg/manifest.js

@@ -1,10 +1,6 @@
-import fse from 'fs-extra';
-const { readFile, writeFile, pathExists, ensureDir } = fse;
+import { readFile, writeFile, pathExists, ensureDir } from '../utils/fs.js';
 import { join } from 'path';
-/**
- * Path to the cache manifest file within the cache directory
- */
-const MANIFEST_FILENAME = 'manifest.json';
+import { MANIFEST_FILENAME } from '../../constants.js';
 /**
  * Loads the ISG cache manifest from the cache directory.
  * Returns null if no manifest exists or if it's corrupted.
@@ -28,6 +24,10 @@ export async function loadCacheManifest(cacheDir) {
             return null;
         }
         const manifestContent = await readFile(manifestPath, 'utf-8');
+        if (!manifestContent) {
+            console.warn('Cache manifest not found or empty, creating new cache');
+            return null;
+        }
         // Handle empty files
         if (!manifestContent.trim()) {
             console.warn('Cache manifest is empty, creating new cache');
@@ -119,11 +119,14 @@ export async function saveCacheManifest(cacheDir, manifest) {
     }
     catch (error) {
         const nodeError = error;
-        if (nodeError.code === 'EACCES') {
+        // Handle specific error codes with custom messages
+        if (nodeError.code === 'EACCES' ||
+            (nodeError.message && nodeError.message.includes('Permission denied'))) {
             throw new Error(`Permission denied saving cache manifest to ${manifestPath}. ` +
                 `Please check directory permissions or run with appropriate privileges.`);
         }
-        if (nodeError.code === 'ENOSPC') {
+        if (nodeError.code === 'ENOSPC' ||
+            (nodeError.message && nodeError.message.includes('No space left on device'))) {
             throw new Error(`No space left on device when saving cache manifest to ${manifestPath}. ` +
                 `Please free up disk space and try again.`);
         }
@@ -135,6 +138,16 @@ export async function saveCacheManifest(cacheDir, manifest) {
             throw new Error(`Cache directory path ${cacheDir} is not a directory. ` +
                 `Please remove the conflicting file and try again.`);
         }
+        // Re-throw the original error if it's already properly formatted
+        if (error instanceof Error) {
+            if (error.message.includes('Failed to create directory') ||
+                error.message.includes('Failed to write file')) {
+                throw new Error(`Failed to save cache manifest to ${manifestPath}: ${error.message.split(': ').slice(-1)[0]}`);
+            }
+            if (error.message.includes('Failed to')) {
+                throw error;
+            }
+        }
         throw new Error(`Failed to save cache manifest to ${manifestPath}: ${error instanceof Error ? error.message : String(error)}`);
     }
 }

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

@@ -1,4 +1,4 @@
-import type { PageModel, ISGConfig, AgingRule, CacheEntry } from '../../types.js';
+import type { PageModel, ISGConfig, AgingRule, CacheEntry } from '../../types/index.js';
 /**
  * Safely gets the current UTC time with drift protection.
  * Ensures all ISG operations use consistent UTC time.

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,gBAAgB,CAAC;AAQlF;;;;;;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;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"}

package/dist/core/isg/ttl.js

@@ -1,8 +1,5 @@
-/**
- * Clock drift tolerance in milliseconds.
- * Accounts for small differences between system clocks.
- */
-const CLOCK_DRIFT_TOLERANCE_MS = 30000; // 30 seconds
+import { CLOCK_DRIFT_TOLERANCE_MS, DEFAULT_TTL_SECONDS, MILLISECONDS_PER_DAY, } from '../../constants.js';
+// dedup: time constants centralized in constants.ts
 /**
  * Safely gets the current UTC time with drift protection.
  * Ensures all ISG operations use consistent UTC time.
@@ -73,11 +70,11 @@ export function computeEffectiveTTL(page, isgConfig, currentTime) {
     const now = getSafeCurrentTime(currentTime);
     // Apply aging rules if we have a published date and aging rules configured
     if (publishedAt && isgConfig.aging && isgConfig.aging.length > 0) {
-        const defaultTTL = isgConfig.ttlSeconds ?? 21600; // 6 hours default
+        const defaultTTL = isgConfig.ttlSeconds ?? DEFAULT_TTL_SECONDS;
         return applyAgingRules(publishedAt, isgConfig.aging, defaultTTL, now);
     }
     // Fall back to default TTL
-    return isgConfig.ttlSeconds ?? 21600; // 6 hours default
+    return isgConfig.ttlSeconds ?? DEFAULT_TTL_SECONDS;
 }
 /**
  * Computes the next rebuild date for a page based on TTL and aging rules.
@@ -108,7 +105,7 @@ export function computeNextRebuildAt(options) {
     // If there's a max age cap and published date, check if content is frozen
     if (maxAgeCapDays && publishedAt) {
         const normalizedPublishedAt = getSafeCurrentTime(publishedAt);
-        const maxAgeMs = maxAgeCapDays * 24 * 60 * 60 * 1000;
+        const maxAgeMs = maxAgeCapDays * MILLISECONDS_PER_DAY;
         const ageMs = now.getTime() - normalizedPublishedAt.getTime();
         if (ageMs > maxAgeMs) {
             // Content is frozen, no rebuild needed
@@ -145,7 +142,7 @@ export function isPageFrozen(entry, now) {
         // If we can't parse the published date, don't freeze
         return false;
     }
-    const maxAgeMs = entry.maxAgeCapDays * 24 * 60 * 60 * 1000;
+    const maxAgeMs = entry.maxAgeCapDays * MILLISECONDS_PER_DAY;
     const ageMs = safeNow.getTime() - publishedAt.getTime();
     return ageMs > maxAgeMs;
 }

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

@@ -1,4 +1,4 @@
-import type { ISGConfig } from '../../types.js';
+import type { ISGConfig } from '../../types/index.js';
 /**
  * Error codes for ISG validation failures.
  * These provide structured error identification for better debugging.

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

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/core/isg/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,gBAAgB,CAAC;AAE3D;;;GAGG;AACH,oBAAY,kBAAkB;IAC5B,WAAW,oBAAoB;IAC/B,mBAAmB,4BAA4B;IAC/C,kBAAkB,2BAA2B;IAC7C,oBAAoB,6BAA6B;IACjD,oBAAoB,6BAA6B;IACjD,sBAAsB,+BAA+B;CACtD;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;aAE5B,IAAI,EAAE,kBAAkB;aACxB,KAAK,EAAE,MAAM;aACb,KAAK,EAAE,OAAO;gBAFd,IAAI,EAAE,kBAAkB,EACxB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,EAC9B,OAAO,EAAE,MAAM;CAKlB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmBzD;AAmLD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,UAAU,EAAE,MAAM,GACjB,IAAI,CAwDN;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,SAAS,CAoCpB"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/core/isg/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,sBAAsB,CAAC;AAEjE;;;GAGG;AACH,oBAAY,kBAAkB;IAC5B,WAAW,oBAAoB;IAC/B,mBAAmB,4BAA4B;IAC/C,kBAAkB,2BAA2B;IAC7C,oBAAoB,6BAA6B;IACjD,oBAAoB,6BAA6B;IACjD,sBAAsB,+BAA+B;CACtD;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;aAE5B,IAAI,EAAE,kBAAkB;aACxB,KAAK,EAAE,MAAM;aACb,KAAK,EAAE,OAAO;gBAFd,IAAI,EAAE,kBAAkB,EACxB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,EAC9B,OAAO,EAAE,MAAM;CAKlB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmBzD;AAmLD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,UAAU,EAAE,MAAM,GACjB,IAAI,CAwDN;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,SAAS,CAoCpB"}

package/dist/core/markdown.d.ts

@@ -1,5 +1,5 @@
 import MarkdownIt from 'markdown-it';
-import type { StatiConfig } from '../types.js';
+import type { StatiConfig } from '../types/index.js';
 /**
  * Creates and configures a MarkdownIt processor based on the provided configuration.
  * Supports both plugin array format and configure function format.

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

@@ -1 +1 @@
-{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/core/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAuCtF;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,GAAG,MAAM,CAEtE"}
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/core/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAuCtF;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,GAAG,MAAM,CAEtE"}

package/dist/core/navigation.d.ts

@@ -1,4 +1,4 @@
-import type { PageModel, NavNode } from '../types.js';
+import type { PageModel, NavNode } from '../types/index.js';
 /**
  * Builds a hierarchical navigation structure from pages.
  * Groups pages by directory structure and sorts them appropriately.

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

@@ -1 +1 @@
-{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/core/navigation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,EAAE,CAyC7D"}
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/core/navigation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,EAAE,CAyC7D"}

package/dist/core/templates.d.ts

@@ -1,5 +1,5 @@
 import { Eta } from 'eta';
-import type { StatiConfig, PageModel, NavNode } from '../types.js';
+import type { StatiConfig, PageModel, NavNode } from '../types/index.js';
 export declare function createTemplateEngine(config: StatiConfig): Eta;
 export declare function renderPage(page: PageModel, body: string, config: StatiConfig, eta: Eta, navigation?: NavNode[], allPages?: PageModel[]): Promise<string>;
 //# sourceMappingURL=templates.d.ts.map

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;AAM1B,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAkB,MAAM,aAAa,CAAC;AAgRnF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,GAAG,CAS7D;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,CAkEjB"}
+{"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;AAiLzF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,GAAG,CAS7D;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,CAkEjB"}

package/dist/core/templates.js

@@ -1,43 +1,9 @@
 import { Eta } from 'eta';
 import { join, dirname, relative, basename } from 'path';
-import { posix } from 'path';
-import fse from 'fs-extra';
-const { pathExists } = fse;
 import glob from 'fast-glob';
-/**
- * Determines if the given page is an index page for a collection.
- * An index page is one whose URL matches a directory path that contains other pages.
- *
- * @param page - The page to check
- * @param allPages - All pages in the site
- * @returns True if the page is a collection index page
- */
-function isCollectionIndexPage(page, allPages) {
-    // Root index page is always a collection index
-    if (page.url === '/') {
-        return true;
-    }
-    // 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));
-}
-/**
- * Gets the collection path for a given page URL.
- * For index pages, returns the page's URL. For child pages, returns the parent directory.
- *
- * @param pageUrl - The page URL
- * @returns The collection path
- */
-function getCollectionPathForPage(pageUrl) {
-    if (pageUrl === '/') {
-        return '/';
-    }
-    const pathParts = pageUrl.split('/').filter(Boolean);
-    if (pathParts.length <= 1) {
-        return '/';
-    }
-    return '/' + pathParts.slice(0, -1).join('/');
-}
+import { TEMPLATE_EXTENSION } from '../constants.js';
+import { isCollectionIndexPage, discoverLayout, getCollectionPathForPage, } from './utils/template-discovery.js';
+import { resolveSrcDir } from './utils/paths.js';
 /**
  * Groups pages by their tags for aggregation purposes.
  *
@@ -142,96 +108,52 @@ function buildCollectionData(currentPage, allPages) {
  * @returns Object mapping partial names to their file paths
  */
 async function discoverPartials(pagePath, config) {
-    const srcDir = join(process.cwd(), config.srcDir);
+    const srcDir = resolveSrcDir(config);
     const partials = {};
     // Get the directory of the current page
     const pageDir = dirname(pagePath);
     const pathSegments = pageDir === '.' ? [] : pageDir.split('/');
-    // Scan from root to current directory
-    const dirsToScan = [''];
-    for (let i = 0; i < pathSegments.length; i++) {
-        dirsToScan.push(pathSegments.slice(0, i + 1).join('/'));
+    // Scan from root to current directory (least specific first)
+    // This allows more specific partials to override less specific ones
+    const dirsToScan = [];
+    if (pathSegments.length > 0) {
+        // Add root directory first, then parent directories, then current
+        dirsToScan.push(''); // Root directory first
+        // Add directories from root to current
+        for (let i = 1; i <= pathSegments.length; i++) {
+            dirsToScan.push(pathSegments.slice(0, i).join('/'));
+        }
+    }
+    else {
+        dirsToScan.push(''); // Root directory only
     }
     for (const dir of dirsToScan) {
         const searchDir = dir ? join(srcDir, dir) : srcDir;
         // Find all underscore folders in this directory level
-        const underscoreFolders = await glob('_*/', {
-            cwd: searchDir,
+        const globPattern = join(searchDir, '_*/').replace(/\\/g, '/');
+        const underscoreFolders = await glob(globPattern, {
+            absolute: true,
             onlyDirectories: true,
         });
         // Scan each underscore folder for .eta files
-        for (const folder of underscoreFolders) {
-            const folderPath = join(searchDir, folder);
+        for (const folderPath of underscoreFolders) {
             const etaFiles = await glob('**/*.eta', {
                 cwd: folderPath,
                 absolute: false,
             });
             for (const etaFile of etaFiles) {
-                const partialName = basename(etaFile, '.eta');
+                const partialName = basename(etaFile, TEMPLATE_EXTENSION);
                 const fullPath = join(folderPath, etaFile);
+                // Get relative path from srcDir to the partial file
                 const relativePath = relative(srcDir, fullPath);
-                // Store the relative path from srcDir for Eta to find it
                 partials[partialName] = relativePath;
             }
         }
     }
     return partials;
 }
-/**
- * Discovers the appropriate layout file for a given page path.
- * Implements the hierarchical layout.eta convention by searching
- * from the page's directory up to the root.
- *
- * @param pagePath - The path to the page (relative to srcDir)
- * @param config - Stati configuration
- * @param explicitLayout - Layout specified in front matter (takes precedence)
- * @param isIndexPage - Whether this is an aggregation/index page (enables index.eta lookup)
- * @returns The layout file path or null if none found
- */
-async function discoverLayout(pagePath, config, explicitLayout, isIndexPage) {
-    const srcDir = join(process.cwd(), config.srcDir);
-    // If explicit layout is specified, use it
-    if (explicitLayout) {
-        const layoutPath = join(srcDir, `${explicitLayout}.eta`);
-        if (await pathExists(layoutPath)) {
-            return `${explicitLayout}.eta`;
-        }
-    }
-    // Get the directory of the current page
-    const pageDir = dirname(pagePath);
-    const pathSegments = pageDir === '.' ? [] : pageDir.split(/[/\\]/); // Handle both separators
-    // Search for layout.eta from current directory up to root
-    const dirsToSearch = [];
-    // Add current directory if not root
-    if (pathSegments.length > 0) {
-        for (let i = pathSegments.length; i > 0; i--) {
-            dirsToSearch.push(pathSegments.slice(0, i).join('/'));
-        }
-    }
-    // Add root directory
-    dirsToSearch.push('');
-    for (const dir of dirsToSearch) {
-        // For index pages, first check for index.eta in each directory
-        if (isIndexPage) {
-            const indexLayoutPath = dir ? join(srcDir, dir, 'index.eta') : join(srcDir, 'index.eta');
-            if (await pathExists(indexLayoutPath)) {
-                // Return relative path with forward slashes for Eta
-                const relativePath = dir ? `${dir}/index.eta` : 'index.eta';
-                return posix.normalize(relativePath);
-            }
-        }
-        // Then check for layout.eta as fallback
-        const layoutPath = dir ? join(srcDir, dir, 'layout.eta') : join(srcDir, 'layout.eta');
-        if (await pathExists(layoutPath)) {
-            // Return relative path with forward slashes for Eta
-            const relativePath = dir ? `${dir}/layout.eta` : 'layout.eta';
-            return posix.normalize(relativePath);
-        }
-    }
-    return null;
-}
 export function createTemplateEngine(config) {
-    const templateDir = join(process.cwd(), config.srcDir);
+    const templateDir = resolveSrcDir(config);
     const eta = new Eta({
         views: templateDir,
         cache: process.env.NODE_ENV === 'production',
@@ -240,7 +162,7 @@ export function createTemplateEngine(config) {
 }
 export async function renderPage(page, body, config, eta, navigation, allPages) {
     // Discover partials for this page's directory hierarchy
-    const srcDir = join(process.cwd(), config.srcDir);
+    const srcDir = resolveSrcDir(config);
     const relativePath = relative(srcDir, page.sourcePath);
     const partialPaths = await discoverPartials(relativePath, config);
     // Build collection data if this is an index page and all pages are provided

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

@@ -0,0 +1,37 @@
+import fse from 'fs-extra';
+import type { WriteFileOptions } from 'fs';
+/**
+ * Safely reads a file with consistent error handling.
+ */
+export declare function readFile(filePath: string, encoding?: 'utf-8' | 'utf8'): Promise<string | null>;
+/**
+ * Safely writes content to a file with consistent error handling.
+ */
+export declare function writeFile(filePath: string, content: string, options?: WriteFileOptions): Promise<void>;
+/**
+ * Checks if a path exists with consistent error handling.
+ */
+export declare function pathExists(filePath: string): Promise<boolean>;
+/**
+ * Ensures a directory exists with consistent error handling.
+ */
+export declare function ensureDir(dirPath: string): Promise<void>;
+/**
+ * Removes a file or directory with consistent error handling.
+ */
+export declare function remove(path: string): Promise<void>;
+/**
+ * Gets file stats with consistent error handling.
+ */
+export declare function stat(filePath: string): Promise<fse.Stats>;
+/**
+ * Reads directory contents with consistent error handling.
+ */
+export declare function readdir<T extends boolean = false>(dirPath: string, options?: {
+    withFileTypes?: T;
+}): Promise<T extends true ? fse.Dirent[] : string[]>;
+/**
+ * Copies a file with consistent error handling.
+ */
+export declare function copyFile(src: string, dest: string): Promise<void>;
+//# sourceMappingURL=fs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../../src/core/utils/fs.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,UAAU,CAAC;AAC3B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,IAAI,CAAC;AAkD3C;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,OAAO,GAAG,MAAgB,GACnC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAExB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEnE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAExD;AAED;;GAEG;AACH,wBAAsB,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAE/D;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,CAAC,SAAS,OAAO,GAAG,KAAK,EACrD,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,CAAC,CAAA;CAAE,GAC9B,OAAO,CAAC,CAAC,SAAS,IAAI,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAYnD;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvE"}

package/dist/core/utils/fs.js

@@ -0,0 +1,86 @@
+import fse from 'fs-extra';
+const { readFile: fseReadFile, writeFile: fseWriteFile, pathExists: fsePathExists, ensureDir: fseEnsureDir, remove: fseRemove, stat: fseStat, readdir: fseReaddir, copyFile: fseCopyFile, } = fse;
+/**
+ * Wraps fs-extra operations with consistent error handling.
+ */
+async function wrapFsOperation(operation, fsCall, path) {
+    try {
+        return await fsCall;
+    }
+    catch (error) {
+        const nodeError = error;
+        throw new Error(`Failed to ${operation} ${path}: ${nodeError.message}`);
+    }
+}
+/**
+ * Wraps fs-extra operations that should return null on ENOENT.
+ */
+async function wrapFsOperationNullable(operation, fsCall, path) {
+    try {
+        return await fsCall;
+    }
+    catch (error) {
+        const nodeError = error;
+        if (nodeError.code === 'ENOENT') {
+            return null; // File doesn't exist
+        }
+        throw new Error(`Failed to ${operation} ${path}: ${nodeError.message}`);
+    }
+}
+/**
+ * Safely reads a file with consistent error handling.
+ */
+export async function readFile(filePath, encoding = 'utf-8') {
+    return wrapFsOperationNullable('read file', fseReadFile(filePath, encoding), filePath);
+}
+/**
+ * Safely writes content to a file with consistent error handling.
+ */
+export async function writeFile(filePath, content, options) {
+    return wrapFsOperation('write file', fseWriteFile(filePath, content, options), filePath);
+}
+/**
+ * Checks if a path exists with consistent error handling.
+ */
+export async function pathExists(filePath) {
+    return wrapFsOperation('check path', fsePathExists(filePath), filePath);
+}
+/**
+ * Ensures a directory exists with consistent error handling.
+ */
+export async function ensureDir(dirPath) {
+    return wrapFsOperation('create directory', fseEnsureDir(dirPath), dirPath);
+}
+/**
+ * Removes a file or directory with consistent error handling.
+ */
+export async function remove(path) {
+    return wrapFsOperation('remove', fseRemove(path), path);
+}
+/**
+ * Gets file stats with consistent error handling.
+ */
+export async function stat(filePath) {
+    return wrapFsOperation('get stats for', fseStat(filePath), filePath);
+}
+/**
+ * Reads directory contents with consistent error handling.
+ */
+export async function readdir(dirPath, options) {
+    try {
+        if (options?.withFileTypes) {
+            return (await fseReaddir(dirPath, { withFileTypes: true }));
+        }
+        return (await fseReaddir(dirPath));
+    }
+    catch (error) {
+        const nodeError = error;
+        throw new Error(`Failed to read directory ${dirPath}: ${nodeError.message}`);
+    }
+}
+/**
+ * Copies a file with consistent error handling.
+ */
+export async function copyFile(src, dest) {
+    return wrapFsOperation('copy', fseCopyFile(src, dest), `${src} to ${dest}`);
+}

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

@@ -0,0 +1,24 @@
+import type { StatiConfig } from '../../types.js';
+export interface PartialEntry {
+    name: string;
+    absPath: string;
+    relFromSrc: string;
+}
+/**
+ * Scan underscore folders from root to the page's directory for .eta partials.
+ * Returns structured entries usable by both renderer and ISG deps.
+ */
+export declare function scanPartialsHierarchy(pageRelativePath: string, config: StatiConfig): Promise<PartialEntry[]>;
+/**
+ * Build the list of directories to scan for partials from root → current page directory.
+ */
+export declare function buildDirsToScan(pageRelativePath: string): string[];
+/**
+ * Renderer-focused partial discovery.
+ * Matches historical renderer behavior used by templates tests:
+ * - Only scans the current page directory (not parents)
+ * - First finds underscore folders (e.g. "_partials/")
+ * - Then finds .eta files within those folders, returning relative paths like "_partials/header.eta"
+ */
+export declare function scanPartialsForRenderer(pageRelativePath: string, config: StatiConfig): Promise<PartialEntry[]>;
+//# sourceMappingURL=partials.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"partials.d.ts","sourceRoot":"","sources":["../../../src/core/utils/partials.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGlD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,YAAY,EAAE,CAAC,CA2BzB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,EAAE,CASlE;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,YAAY,EAAE,CAAC,CAkCzB"}