@stati/core 1.3.1 → 1.4.0

package/dist/config/loader.d.ts

@@ -1,4 +1,10 @@
-import type { StatiConfig } from '../types.js';
+import type { StatiConfig } from '../types/index.js';
+/**
+ * Builds config file paths for a given directory.
+ * @param cwd - Directory to search for config files
+ * @returns Array of absolute paths to potential config files
+ */
+export declare function getConfigFilePaths(cwd: string): string[];
 /**
  * Loads and validates Stati configuration from the project directory.
  * Searches for configuration files in order: stati.config.ts, stati.config.js, stati.config.mjs

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

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAsB/C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,WAAW,CAAC,CA2DlF"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAgCrD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAExD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,WAAW,CAAC,CAuDlF"}

package/dist/config/loader.js

@@ -2,24 +2,33 @@ import { existsSync } from 'fs';
 import { join, resolve } from 'path';
 import { pathToFileURL } from 'url';
 import { validateISGConfig, ISGConfigurationError } from '../core/isg/validation.js';
+import { DEFAULT_SRC_DIR, DEFAULT_OUT_DIR, DEFAULT_STATIC_DIR, DEFAULT_SITE_TITLE, DEFAULT_DEV_BASE_URL, DEFAULT_TTL_SECONDS, DEFAULT_MAX_AGE_CAP_DAYS, CONFIG_FILE_PATTERNS, } from '../constants.js';
 /**
  * Default configuration values for Stati.
  * Used as fallback when no configuration file is found.
  */
 const DEFAULT_CONFIG = {
-    srcDir: 'site',
-    outDir: 'dist',
-    staticDir: 'public',
+    srcDir: DEFAULT_SRC_DIR,
+    outDir: DEFAULT_OUT_DIR,
+    staticDir: DEFAULT_STATIC_DIR,
     site: {
-        title: 'My Site',
-        baseUrl: 'http://localhost:3000',
+        title: DEFAULT_SITE_TITLE,
+        baseUrl: DEFAULT_DEV_BASE_URL,
     },
     isg: {
         enabled: true,
-        ttlSeconds: 3600,
-        maxAgeCapDays: 365,
+        ttlSeconds: DEFAULT_TTL_SECONDS,
+        maxAgeCapDays: DEFAULT_MAX_AGE_CAP_DAYS,
     },
 };
+/**
+ * Builds config file paths for a given directory.
+ * @param cwd - Directory to search for config files
+ * @returns Array of absolute paths to potential config files
+ */
+export function getConfigFilePaths(cwd) {
+    return CONFIG_FILE_PATTERNS.map((pattern) => join(cwd, pattern));
+}
 /**
  * Loads and validates Stati configuration from the project directory.
  * Searches for configuration files in order: stati.config.ts, stati.config.js, stati.config.mjs
@@ -41,11 +50,7 @@ const DEFAULT_CONFIG = {
  * @throws {Error} When configuration file exists but contains invalid JavaScript/TypeScript
  */
 export async function loadConfig(cwd = process.cwd()) {
-    const configPaths = [
-        join(cwd, 'stati.config.ts'),
-        join(cwd, 'stati.config.js'),
-        join(cwd, 'stati.config.mjs'),
-    ];
+    const configPaths = getConfigFilePaths(cwd);
     let configPath = null;
     for (const path of configPaths) {
         if (existsSync(path)) {

package/dist/constants.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Centralized constants for Stati static site generator.
+ * This module contains all magic constants used throughout the Stati core package.
+ */
+/** Default source directory for content files */
+export declare const DEFAULT_SRC_DIR = "site";
+/** Default output directory for built files */
+export declare const DEFAULT_OUT_DIR = "dist";
+/** Default static assets directory */
+export declare const DEFAULT_STATIC_DIR = "public";
+/** Stati cache directory name */
+export declare const CACHE_DIR_NAME = ".stati";
+/** Cache subdirectory for ISG manifest and related files */
+export declare const CACHE_SUBDIR = "cache";
+/** ISG cache manifest filename */
+export declare const MANIFEST_FILENAME = "manifest.json";
+/** Supported configuration file extensions in order of preference */
+export declare const CONFIG_FILE_EXTENSIONS: readonly [".ts", ".js", ".mjs"];
+/** Configuration file base name */
+export declare const CONFIG_FILE_BASE = "stati.config";
+/** Complete configuration file patterns */
+export declare const CONFIG_FILE_PATTERNS: string[];
+/** Default development server port */
+export declare const DEFAULT_DEV_PORT = 3000;
+/** Default development server host */
+export declare const DEFAULT_DEV_HOST = "localhost";
+/** Default development server base URL */
+export declare const DEFAULT_DEV_BASE_URL = "http://localhost:3000";
+/** Default TTL for cached pages in seconds (6 hours) */
+export declare const DEFAULT_TTL_SECONDS = 21600;
+/** Default maximum age cap for aging rules in days (1 year) */
+export declare const DEFAULT_MAX_AGE_CAP_DAYS = 365;
+/** Clock drift tolerance in milliseconds to prevent rebuild loops */
+export declare const CLOCK_DRIFT_TOLERANCE_MS = 30000;
+/** Seconds in one minute */
+export declare const SECONDS_PER_MINUTE = 60;
+/** Seconds in one hour */
+export declare const SECONDS_PER_HOUR: number;
+/** Seconds in one day */
+export declare const SECONDS_PER_DAY: number;
+/** Seconds in one week */
+export declare const SECONDS_PER_WEEK: number;
+/** Milliseconds in one day */
+export declare const MILLISECONDS_PER_DAY: number;
+/** 5 minutes in seconds - for very fresh content */
+export declare const TTL_5_MINUTES: number;
+/** 30 minutes in seconds - for recent content */
+export declare const TTL_30_MINUTES: number;
+/** 1 hour in seconds - for hourly updates */
+export declare const TTL_1_HOUR: number;
+/** 2 hours in seconds - for bi-hourly updates */
+export declare const TTL_2_HOURS: number;
+/** 6 hours in seconds - default TTL */
+export declare const TTL_6_HOURS = 21600;
+/** 1 day in seconds - for daily content */
+export declare const TTL_1_DAY: number;
+/** 1 week in seconds - for weekly content */
+export declare const TTL_1_WEEK: number;
+/** Eta template file extension */
+export declare const TEMPLATE_EXTENSION = ".eta";
+/** Markdown file extension */
+export declare const MARKDOWN_EXTENSION = ".md";
+/** Layout template filename */
+export declare const LAYOUT_TEMPLATE = "layout.eta";
+/** Partials directory prefix (folders starting with underscore) */
+export declare const PARTIALS_DIR_PREFIX = "_";
+/** Default site title */
+export declare const DEFAULT_SITE_TITLE = "My Stati Site";
+/** Default locale for internationalization */
+export declare const DEFAULT_LOCALE = "en-US";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

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

package/dist/constants.js

@@ -0,0 +1,78 @@
+/**
+ * Centralized constants for Stati static site generator.
+ * This module contains all magic constants used throughout the Stati core package.
+ */
+// === Directory and File System Constants ===
+/** Default source directory for content files */
+export const DEFAULT_SRC_DIR = 'site';
+/** Default output directory for built files */
+export const DEFAULT_OUT_DIR = 'dist';
+/** Default static assets directory */
+export const DEFAULT_STATIC_DIR = 'public';
+/** Stati cache directory name */
+export const CACHE_DIR_NAME = '.stati';
+/** Cache subdirectory for ISG manifest and related files */
+export const CACHE_SUBDIR = 'cache';
+/** ISG cache manifest filename */
+export const MANIFEST_FILENAME = 'manifest.json';
+// === Configuration File Constants ===
+/** Supported configuration file extensions in order of preference */
+export const CONFIG_FILE_EXTENSIONS = ['.ts', '.js', '.mjs'];
+/** Configuration file base name */
+export const CONFIG_FILE_BASE = 'stati.config';
+/** Complete configuration file patterns */
+export const CONFIG_FILE_PATTERNS = CONFIG_FILE_EXTENSIONS.map((ext) => `${CONFIG_FILE_BASE}${ext}`);
+// === Development Server Constants ===
+/** Default development server port */
+export const DEFAULT_DEV_PORT = 3000;
+/** Default development server host */
+export const DEFAULT_DEV_HOST = 'localhost';
+/** Default development server base URL */
+export const DEFAULT_DEV_BASE_URL = `http://${DEFAULT_DEV_HOST}:${DEFAULT_DEV_PORT}`;
+// === ISG (Incremental Static Generation) Constants ===
+/** Default TTL for cached pages in seconds (6 hours) */
+export const DEFAULT_TTL_SECONDS = 21600;
+/** Default maximum age cap for aging rules in days (1 year) */
+export const DEFAULT_MAX_AGE_CAP_DAYS = 365;
+/** Clock drift tolerance in milliseconds to prevent rebuild loops */
+export const CLOCK_DRIFT_TOLERANCE_MS = 30000; // 30 seconds
+// === Time Constants (for convenience and clarity) ===
+/** Seconds in one minute */
+export const SECONDS_PER_MINUTE = 60;
+/** Seconds in one hour */
+export const SECONDS_PER_HOUR = 60 * SECONDS_PER_MINUTE;
+/** Seconds in one day */
+export const SECONDS_PER_DAY = 24 * SECONDS_PER_HOUR;
+/** Seconds in one week */
+export const SECONDS_PER_WEEK = 7 * SECONDS_PER_DAY;
+/** Milliseconds in one day */
+export const MILLISECONDS_PER_DAY = SECONDS_PER_DAY * 1000;
+// === Common ISG TTL Values ===
+/** 5 minutes in seconds - for very fresh content */
+export const TTL_5_MINUTES = 5 * SECONDS_PER_MINUTE;
+/** 30 minutes in seconds - for recent content */
+export const TTL_30_MINUTES = 30 * SECONDS_PER_MINUTE;
+/** 1 hour in seconds - for hourly updates */
+export const TTL_1_HOUR = SECONDS_PER_HOUR;
+/** 2 hours in seconds - for bi-hourly updates */
+export const TTL_2_HOURS = 2 * SECONDS_PER_HOUR;
+/** 6 hours in seconds - default TTL */
+export const TTL_6_HOURS = DEFAULT_TTL_SECONDS;
+/** 1 day in seconds - for daily content */
+export const TTL_1_DAY = SECONDS_PER_DAY;
+/** 1 week in seconds - for weekly content */
+export const TTL_1_WEEK = SECONDS_PER_WEEK;
+// === Template and File Extension Constants ===
+/** Eta template file extension */
+export const TEMPLATE_EXTENSION = '.eta';
+/** Markdown file extension */
+export const MARKDOWN_EXTENSION = '.md';
+/** Layout template filename */
+export const LAYOUT_TEMPLATE = `layout${TEMPLATE_EXTENSION}`;
+/** Partials directory prefix (folders starting with underscore) */
+export const PARTIALS_DIR_PREFIX = '_';
+// === Site Configuration Defaults ===
+/** Default site title */
+export const DEFAULT_SITE_TITLE = 'My Stati Site';
+/** Default locale for internationalization */
+export const DEFAULT_LOCALE = 'en-US';

package/dist/core/build.d.ts

@@ -1,4 +1,4 @@
-import type { BuildStats, Logger } from '../types.js';
+import type { BuildStats, Logger } from '../types/index.js';
 /**
  * Options for customizing the build process.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/core/build.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAgB,UAAU,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAEpE;;;;;;;;;;;;;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;AA2HD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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":"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"}

package/dist/core/build.js

@@ -1,5 +1,4 @@
-import fse from 'fs-extra';
-const { ensureDir, writeFile, remove, pathExists, stat, readdir, copyFile } = fse;
+import { ensureDir, writeFile, remove, pathExists, stat, readdir, copyFile } from './utils/fs.js';
 import { join, dirname, relative } from 'path';
 import { posix } from 'path';
 import { loadConfig } from '../config/loader.js';
@@ -10,6 +9,7 @@ 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';
 /**
  * Recursively calculates the total size of a directory in bytes.
  * Used for build statistics.
@@ -87,30 +87,6 @@ const defaultLogger = {
     processing: (message) => console.log(message),
     stats: (message) => console.log(message),
 };
-/**
- * Formats build statistics for display with prettier output.
- *
- * @param stats - Build statistics to format
- * @returns Formatted statistics string
- */
-function formatBuildStats(stats) {
-    const sizeKB = (stats.outputSizeBytes / 1024).toFixed(1);
-    const timeSeconds = (stats.buildTimeMs / 1000).toFixed(2);
-    let output = `Build Statistics:
-┌─────────────────────────────────────────┐
-│  Build time: ${timeSeconds}s`.padEnd(41) + '│';
-    output += `\n│  📄 Pages built: ${stats.totalPages}`.padEnd(42) + '│';
-    output += `\n│  📦 Assets copied: ${stats.assetsCount}`.padEnd(42) + '│';
-    output += `\n│  Output size: ${sizeKB} KB`.padEnd(42) + '│';
-    if (stats.cacheHits !== undefined && stats.cacheMisses !== undefined) {
-        const totalCacheRequests = stats.cacheHits + stats.cacheMisses;
-        const hitRate = totalCacheRequests > 0 ? ((stats.cacheHits / totalCacheRequests) * 100).toFixed(1) : '0';
-        output +=
-            `\n│  Cache hits: ${stats.cacheHits}/${totalCacheRequests} (${hitRate}%)`.padEnd(42) + '│';
-    }
-    output += '\n└─────────────────────────────────────────┘';
-    return output;
-}
 /**
  * Builds the Stati site with ISG support.
  * Processes all pages and assets, with smart caching for incremental builds.
@@ -143,7 +119,7 @@ function formatBuildStats(stats) {
  * ```
  */
 export async function build(options = {}) {
-    const cacheDir = join(process.cwd(), '.stati');
+    const cacheDir = resolveCacheDir();
     // Ensure cache directory exists before acquiring build lock
     await ensureDir(cacheDir);
     // Use build lock to prevent concurrent builds, with force option to override
@@ -153,20 +129,21 @@ export async function build(options = {}) {
     });
 }
 /**
- * Internal build implementation without locking.
- * Separated for cleaner error handling and testing.
+ * Loads and validates configuration, returning config and output directory.
  */
-async function buildInternal(options = {}) {
-    const buildStartTime = Date.now();
-    const logger = options.logger || defaultLogger;
-    logger.building('Building your site...');
-    console.log(); // Add spacing after build start
+async function loadAndValidateConfig(options) {
     // Load configuration
     const config = await loadConfig(options.configPath ? dirname(options.configPath) : process.cwd());
-    const outDir = join(process.cwd(), config.outDir);
+    const outDir = resolveOutDir(config);
+    const cacheDir = resolveCacheDir();
     // Create .stati cache directory
-    const cacheDir = join(process.cwd(), '.stati');
     await ensureDir(cacheDir);
+    return { config, outDir, cacheDir };
+}
+/**
+ * Sets up cache manifest and initializes cache statistics.
+ */
+async function setupCacheAndManifest(cacheDir) {
     // Load cache manifest for ISG
     let cacheManifest = await loadCacheManifest(cacheDir);
     // If no cache manifest exists, create an empty one
@@ -177,15 +154,12 @@ async function buildInternal(options = {}) {
     }
     // At this point cacheManifest is guaranteed to be non-null
     const manifest = cacheManifest;
-    // Initialize cache stats
-    let cacheHits = 0;
-    let cacheMisses = 0;
-    // Clean output directory if requested
-    if (options.clean) {
-        logger.info('Cleaning output directory...');
-        await remove(outDir);
-    }
-    await ensureDir(outDir);
+    return { manifest };
+}
+/**
+ * Loads content and builds navigation.
+ */
+async function loadContentAndBuildNavigation(config, options, logger) {
     // Load all content
     const pages = await loadContent(config, options.includeDrafts);
     logger.info(`📄 Found ${pages.length} pages`);
@@ -199,9 +173,18 @@ async function buildInternal(options = {}) {
     // Display navigation tree if the logger supports it
     if (logger.navigationTree) {
         logger.navigationTree(navigation);
-    } // Create processors
+    }
+    // Create processors
     const md = await createMarkdownProcessor(config);
     const eta = createTemplateEngine(config);
+    return { pages, navigation, md, eta };
+}
+/**
+ * Processes pages with ISG caching logic.
+ */
+async function processPagesWithCache(pages, manifest, config, outDir, md, eta, navigation, buildTime, options, logger) {
+    let cacheHits = 0;
+    let cacheMisses = 0;
     // Build context
     const buildContext = { config, pages };
     // Run beforeAll hook
@@ -216,7 +199,6 @@ async function buildInternal(options = {}) {
     if (logger.startRenderingTree) {
         logger.startRenderingTree('Page Rendering Process');
     }
-    const buildTime = new Date();
     for (let i = 0; i < pages.length; i++) {
         const page = pages[i];
         if (!page)
@@ -304,31 +286,34 @@ async function buildInternal(options = {}) {
     }
     // Display final rendering tree and clear it
     if (logger.showRenderingTree) {
-        console.log(); // Add spacing
         logger.showRenderingTree();
         if (logger.clearRenderingTree) {
             logger.clearRenderingTree();
         }
     }
-    // Save updated cache manifest
-    await saveCacheManifest(cacheDir, manifest);
-    // Copy static assets and count them
-    let assetsCount = 0;
-    const staticDir = join(process.cwd(), config.staticDir);
-    if (await pathExists(staticDir)) {
-        console.log(); // Add spacing before asset copying
-        if (logger.step) {
-            logger.step(3, 3, 'Copying static assets');
-        }
-        logger.info(`Copying static assets from ${config.staticDir}`);
-        assetsCount = await copyStaticAssetsWithLogging(staticDir, outDir, logger);
-        logger.info(`Copied ${assetsCount} static assets`);
+    return { cacheHits, cacheMisses };
+}
+/**
+ * Copies static assets and returns the count.
+ */
+async function copyStaticAssets(config, outDir, logger) {
+    const staticDir = resolveStaticDir(config);
+    if (!(await pathExists(staticDir))) {
+        return 0;
     }
-    // Run afterAll hook
-    if (config.hooks?.afterAll) {
-        await config.hooks.afterAll(buildContext);
+    console.log(); // Add spacing before asset copying
+    if (logger.step) {
+        logger.step(3, 3, 'Copying static assets');
     }
-    // Calculate build statistics
+    logger.info(`Copying static assets from ${config.staticDir}`);
+    const assetsCount = await copyStaticAssetsWithLogging(staticDir, outDir, logger);
+    logger.info(`Copied ${assetsCount} static assets`);
+    return assetsCount;
+}
+/**
+ * Generates build statistics.
+ */
+async function generateBuildStats(pages, assetsCount, buildStartTime, outDir, cacheHits, cacheMisses, logger) {
     const buildEndTime = Date.now();
     const buildStats = {
         totalPages: pages.length,
@@ -339,13 +324,53 @@ async function buildInternal(options = {}) {
         cacheHits,
         cacheMisses,
     };
-    console.log(); // Add spacing before statistics
-    // Use table format if available, otherwise fall back to formatted string
     if (logger.statsTable) {
+        console.log(); // Add spacing before statistics
         logger.statsTable(buildStats);
+        console.log(); // Add spacing after statistics
     }
-    else {
-        logger.stats(formatBuildStats(buildStats));
+    return buildStats;
+}
+/**
+ * Internal build implementation without locking.
+ * Separated for cleaner error handling and testing.
+ */
+async function buildInternal(options = {}) {
+    const buildStartTime = Date.now();
+    const logger = options.logger || defaultLogger;
+    logger.building('Building your site...');
+    // Load configuration
+    const { config, outDir, cacheDir } = await loadAndValidateConfig(options);
+    // Load cache manifest for ISG
+    const { manifest } = await setupCacheAndManifest(cacheDir);
+    // Initialize cache stats
+    let cacheHits = 0;
+    let cacheMisses = 0;
+    // Clean output directory if requested
+    if (options.clean) {
+        logger.info('Cleaning output directory...');
+        await remove(outDir);
     }
+    await ensureDir(outDir);
+    // Load content and build navigation
+    console.log(); // Add spacing before content loading
+    const { pages, navigation, md, eta } = await loadContentAndBuildNavigation(config, options, logger);
+    // Process pages with ISG caching logic
+    console.log(); // Add spacing before page processing
+    const buildTime = new Date();
+    const pageProcessingResult = await processPagesWithCache(pages, manifest, config, outDir, md, eta, navigation, buildTime, options, logger);
+    cacheHits = pageProcessingResult.cacheHits;
+    cacheMisses = pageProcessingResult.cacheMisses;
+    // Save updated cache manifest
+    await saveCacheManifest(cacheDir, manifest);
+    // Copy static assets and count them
+    let assetsCount = 0;
+    assetsCount = await copyStaticAssets(config, outDir, logger);
+    // Run afterAll hook
+    if (config.hooks?.afterAll) {
+        await config.hooks.afterAll({ config, pages });
+    }
+    // Calculate build statistics
+    const buildStats = await generateBuildStats(pages, assetsCount, buildStartTime, outDir, cacheHits, cacheMisses, logger);
     return buildStats;
 }

package/dist/core/content.d.ts

@@ -1,4 +1,4 @@
-import type { PageModel, StatiConfig } from '../types.js';
+import type { PageModel, StatiConfig } from '../types/index.js';
 /**
  * Loads and parses all content files from the configured source directory.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/core/content.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1D;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,WAAW,EACnB,aAAa,CAAC,EAAE,OAAO,GACtB,OAAO,CAAC,SAAS,EAAE,CAAC,CAyCtB"}
+{"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"}

package/dist/core/content.js

@@ -1,8 +1,9 @@
 import glob from 'fast-glob';
-import fse from 'fs-extra';
-const { readFile } = fse;
+import { readFile } from './utils/fs.js';
 import matter from 'gray-matter';
-import { join, relative, dirname, basename } from 'path';
+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.
  *
@@ -20,7 +21,7 @@ import { join, relative, dirname, basename } from 'path';
  * ```
  */
 export async function loadContent(config, includeDrafts) {
-    const contentDir = join(process.cwd(), config.srcDir);
+    const contentDir = resolveSrcDir(config);
     // Exclude folders starting with underscore from content discovery
     const files = await glob('**/*.md', {
         cwd: contentDir,
@@ -30,6 +31,10 @@ export async function loadContent(config, includeDrafts) {
     const pages = [];
     for (const file of files) {
         const content = await readFile(file, 'utf-8');
+        if (!content) {
+            console.warn(`Skipping file ${file}: could not read content`);
+            continue;
+        }
         const { data: frontMatter, content: markdown } = matter(content);
         // Skip drafts unless explicitly included
         if (frontMatter.draft && !includeDrafts) {
@@ -54,7 +59,7 @@ export async function loadContent(config, includeDrafts) {
 }
 function computeSlug(relativePath) {
     const dir = dirname(relativePath);
-    const name = basename(relativePath, '.md');
+    const name = basename(relativePath, MARKDOWN_EXTENSION);
     if (name === 'index') {
         return dir === '.' ? '/' : `/${dir}`;
     }

package/dist/core/dev.d.ts

@@ -1,4 +1,4 @@
-import type { Logger } from '../types.js';
+import type { Logger } from '../types/index.js';
 export interface DevServerOptions {
     port?: number;
     host?: string;
@@ -11,11 +11,5 @@ export interface DevServer {
     stop(): Promise<void>;
     url: string;
 }
-/**
- * Creates and configures a development server with live reload functionality.
- *
- * @param options - Development server configuration options
- * @returns Promise resolving to a DevServer instance
- */
 export declare function createDevServer(options?: DevServerOptions): Promise<DevServer>;
 //# sourceMappingURL=dev.d.ts.map

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,aAAa,CAAC;AAMvD,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;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC,CAoaxF"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/core/dev.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAe,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAS7D,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;AAyMD,wBAAsB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC,CAgTxF"}