@stati/core 1.0.0 → 1.2.0

package/dist/core/isg/validation.js

@@ -0,0 +1,226 @@
+/**
+ * Error codes for ISG validation failures.
+ * These provide structured error identification for better debugging.
+ */
+export var ISGValidationError;
+(function (ISGValidationError) {
+    ISGValidationError["INVALID_TTL"] = "ISG_INVALID_TTL";
+    ISGValidationError["INVALID_MAX_AGE_CAP"] = "ISG_INVALID_MAX_AGE_CAP";
+    ISGValidationError["INVALID_AGING_RULE"] = "ISG_INVALID_AGING_RULE";
+    ISGValidationError["DUPLICATE_AGING_RULE"] = "ISG_DUPLICATE_AGING_RULE";
+    ISGValidationError["UNSORTED_AGING_RULES"] = "ISG_UNSORTED_AGING_RULES";
+    ISGValidationError["AGING_RULE_EXCEEDS_CAP"] = "ISG_AGING_RULE_EXCEEDS_CAP";
+})(ISGValidationError || (ISGValidationError = {}));
+/**
+ * Represents a validation error with context and actionable message.
+ */
+export class ISGConfigurationError extends Error {
+    code;
+    field;
+    value;
+    constructor(code, field, value, message) {
+        super(message);
+        this.code = code;
+        this.field = field;
+        this.value = value;
+        this.name = 'ISGConfigurationError';
+    }
+}
+/**
+ * Validates ISG configuration and provides actionable error messages.
+ * Throws ISGConfigurationError for invalid configurations.
+ *
+ * @param config - ISG configuration to validate
+ * @throws {ISGConfigurationError} When configuration is invalid
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   validateISGConfig(userConfig.isg);
+ * } catch (error) {
+ *   if (error instanceof ISGConfigurationError) {
+ *     console.error(`${error.code}: ${error.message}`);
+ *     console.error(`Field: ${error.field}, Value: ${error.value}`);
+ *   }
+ * }
+ * ```
+ */
+export function validateISGConfig(config) {
+    if (!config) {
+        return; // Config is optional
+    }
+    // Validate TTL seconds
+    if (config.ttlSeconds !== undefined) {
+        validateTTLSeconds(config.ttlSeconds);
+    }
+    // Validate max age cap
+    if (config.maxAgeCapDays !== undefined) {
+        validateMaxAgeCapDays(config.maxAgeCapDays);
+    }
+    // Validate aging rules
+    if (config.aging && Array.isArray(config.aging)) {
+        validateAgingRules(config.aging, config.maxAgeCapDays);
+    }
+}
+/**
+ * Validates TTL seconds value.
+ */
+function validateTTLSeconds(ttlSeconds) {
+    if (typeof ttlSeconds !== 'number' || !Number.isInteger(ttlSeconds)) {
+        throw new ISGConfigurationError(ISGValidationError.INVALID_TTL, 'ttlSeconds', ttlSeconds, 'ttlSeconds must be a positive integer representing seconds. Example: 3600 (1 hour)');
+    }
+    if (ttlSeconds < 0) {
+        throw new ISGConfigurationError(ISGValidationError.INVALID_TTL, 'ttlSeconds', ttlSeconds, 'ttlSeconds cannot be negative. Use 0 for immediate expiration or a positive value.');
+    }
+    if (ttlSeconds > 365 * 24 * 3600) {
+        // More than 1 year
+        throw new ISGConfigurationError(ISGValidationError.INVALID_TTL, 'ttlSeconds', ttlSeconds, 'ttlSeconds is unusually large (>1 year). Consider using maxAgeCapDays for long-term caching.');
+    }
+}
+/**
+ * Validates max age cap days value.
+ */
+function validateMaxAgeCapDays(maxAgeCapDays) {
+    if (typeof maxAgeCapDays !== 'number' || !Number.isInteger(maxAgeCapDays)) {
+        throw new ISGConfigurationError(ISGValidationError.INVALID_MAX_AGE_CAP, 'maxAgeCapDays', maxAgeCapDays, 'maxAgeCapDays must be a positive integer representing days. Example: 365 (1 year)');
+    }
+    if (maxAgeCapDays <= 0) {
+        throw new ISGConfigurationError(ISGValidationError.INVALID_MAX_AGE_CAP, 'maxAgeCapDays', maxAgeCapDays, 'maxAgeCapDays must be positive. Use a value like 30, 90, or 365 days.');
+    }
+    if (maxAgeCapDays > 3650) {
+        // More than 10 years
+        throw new ISGConfigurationError(ISGValidationError.INVALID_MAX_AGE_CAP, 'maxAgeCapDays', maxAgeCapDays, 'maxAgeCapDays is unusually large (>10 years). Consider if this is intended.');
+    }
+}
+/**
+ * Validates aging rules array.
+ */
+function validateAgingRules(aging, maxAgeCapDays) {
+    const seenUntilDays = new Set();
+    for (let i = 0; i < aging.length; i++) {
+        const rule = aging[i];
+        // Skip invalid entries
+        if (!rule) {
+            throw new ISGConfigurationError(ISGValidationError.INVALID_AGING_RULE, `aging[${i}]`, rule, `Aging rule at index ${i} is null or undefined.`);
+        }
+        // Validate individual rule
+        validateAgingRule(rule, i);
+        // Check for duplicates
+        if (seenUntilDays.has(rule.untilDays)) {
+            throw new ISGConfigurationError(ISGValidationError.DUPLICATE_AGING_RULE, `aging[${i}].untilDays`, rule.untilDays, `Duplicate aging rule for ${rule.untilDays} days. Each untilDays value must be unique.`);
+        }
+        seenUntilDays.add(rule.untilDays);
+        // Check if rule exceeds max age cap
+        if (maxAgeCapDays !== undefined && rule.untilDays > maxAgeCapDays) {
+            throw new ISGConfigurationError(ISGValidationError.AGING_RULE_EXCEEDS_CAP, `aging[${i}].untilDays`, rule.untilDays, `Aging rule for ${rule.untilDays} days exceeds maxAgeCapDays (${maxAgeCapDays}). Rule will never be used.`);
+        }
+    }
+    // Check if rules are sorted by untilDays (ascending)
+    const sortedRules = [...aging].sort((a, b) => a.untilDays - b.untilDays);
+    for (let i = 0; i < aging.length; i++) {
+        if (aging[i]?.untilDays !== sortedRules[i]?.untilDays) {
+            throw new ISGConfigurationError(ISGValidationError.UNSORTED_AGING_RULES, 'aging', aging.map((r) => r.untilDays), 'Aging rules must be sorted by untilDays in ascending order. Sort rules from shortest to longest duration.');
+        }
+    }
+}
+/**
+ * Validates a single aging rule.
+ */
+function validateAgingRule(rule, index) {
+    if (!rule || typeof rule !== 'object') {
+        throw new ISGConfigurationError(ISGValidationError.INVALID_AGING_RULE, `aging[${index}]`, rule, 'Aging rule must be an object with untilDays and ttlSeconds properties.');
+    }
+    // Validate untilDays
+    if (typeof rule.untilDays !== 'number' ||
+        !Number.isInteger(rule.untilDays) ||
+        rule.untilDays <= 0) {
+        throw new ISGConfigurationError(ISGValidationError.INVALID_AGING_RULE, `aging[${index}].untilDays`, rule.untilDays, 'untilDays must be a positive integer representing days. Example: 7, 30, 90');
+    }
+    // Validate ttlSeconds
+    if (typeof rule.ttlSeconds !== 'number' ||
+        !Number.isInteger(rule.ttlSeconds) ||
+        rule.ttlSeconds < 0) {
+        throw new ISGConfigurationError(ISGValidationError.INVALID_AGING_RULE, `aging[${index}].ttlSeconds`, rule.ttlSeconds, 'ttlSeconds must be a non-negative integer representing seconds. Example: 3600 (1 hour)');
+    }
+    // Warn about unusually long TTL in aging rules
+    if (rule.ttlSeconds > 30 * 24 * 3600) {
+        // More than 30 days
+        throw new ISGConfigurationError(ISGValidationError.INVALID_AGING_RULE, `aging[${index}].ttlSeconds`, rule.ttlSeconds, `ttlSeconds in aging rule is unusually large (>30 days). Consider if this is intended for content up to ${rule.untilDays} days old.`);
+    }
+}
+/**
+ * Validates front-matter ISG overrides for a single page.
+ * Provides helpful error messages for invalid page-level configuration.
+ *
+ * @param frontMatter - Page front-matter object
+ * @param sourcePath - Path to source file for error context
+ * @throws {ISGConfigurationError} When front-matter overrides are invalid
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   validatePageISGOverrides(page.frontMatter, page.sourcePath);
+ * } catch (error) {
+ *   console.error(`Error in ${page.sourcePath}: ${error.message}`);
+ * }
+ * ```
+ */
+export function validatePageISGOverrides(frontMatter, sourcePath) {
+    // Validate page-level ttlSeconds override
+    if (frontMatter.ttlSeconds !== undefined) {
+        if (typeof frontMatter.ttlSeconds !== 'number' ||
+            !Number.isInteger(frontMatter.ttlSeconds) ||
+            frontMatter.ttlSeconds < 0) {
+            throw new ISGConfigurationError(ISGValidationError.INVALID_TTL, 'ttlSeconds', frontMatter.ttlSeconds, `Invalid ttlSeconds in front-matter of ${sourcePath}. Must be a non-negative integer.`);
+        }
+    }
+    // Validate page-level maxAgeCapDays override
+    if (frontMatter.maxAgeCapDays !== undefined) {
+        if (typeof frontMatter.maxAgeCapDays !== 'number' ||
+            !Number.isInteger(frontMatter.maxAgeCapDays) ||
+            frontMatter.maxAgeCapDays <= 0) {
+            throw new ISGConfigurationError(ISGValidationError.INVALID_MAX_AGE_CAP, 'maxAgeCapDays', frontMatter.maxAgeCapDays, `Invalid maxAgeCapDays in front-matter of ${sourcePath}. Must be a positive integer.`);
+        }
+    }
+    // Validate tags array
+    if (frontMatter.tags !== undefined) {
+        if (!Array.isArray(frontMatter.tags)) {
+            throw new ISGConfigurationError(ISGValidationError.INVALID_AGING_RULE, // Reusing closest error code
+            'tags', frontMatter.tags, `Invalid tags in front-matter of ${sourcePath}. Must be an array of strings.`);
+        }
+        // Check that all tags are strings
+        frontMatter.tags.forEach((tag, index) => {
+            if (typeof tag !== 'string') {
+                throw new ISGConfigurationError(ISGValidationError.INVALID_AGING_RULE, `tags[${index}]`, tag, `Invalid tag at index ${index} in front-matter of ${sourcePath}. All tags must be strings.`);
+            }
+        });
+    }
+}
+/**
+ * Safely extracts numeric value from front-matter with validation.
+ * Used for TTL and max age cap overrides.
+ *
+ * @param value - Value from front-matter
+ * @param fieldName - Name of the field for error messages
+ * @param sourcePath - Source file path for error context
+ * @returns Validated number or undefined if not set
+ */
+export function extractNumericOverride(value, fieldName, sourcePath) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value) || value < 0) {
+            throw new ISGConfigurationError(ISGValidationError.INVALID_TTL, fieldName, value, `Invalid ${fieldName} in ${sourcePath}: must be a non-negative finite number.`);
+        }
+        return Math.floor(value); // Ensure integer
+    }
+    if (typeof value === 'string') {
+        const parsed = parseInt(value, 10);
+        if (Number.isNaN(parsed) || parsed < 0) {
+            throw new ISGConfigurationError(ISGValidationError.INVALID_TTL, fieldName, value, `Invalid ${fieldName} in ${sourcePath}: "${value}" is not a valid non-negative number.`);
+        }
+        return parsed;
+    }
+    throw new ISGConfigurationError(ISGValidationError.INVALID_TTL, fieldName, value, `Invalid ${fieldName} in ${sourcePath}: must be a number or numeric string.`);
+}

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;AAK1B,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,CAgDjB"}
+{"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"}

package/dist/core/templates.js

@@ -1,5 +1,6 @@
 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';
@@ -216,7 +217,7 @@ async function discoverLayout(pagePath, config, explicitLayout, isIndexPage) {
             if (await pathExists(indexLayoutPath)) {
                 // Return relative path with forward slashes for Eta
                 const relativePath = dir ? `${dir}/index.eta` : 'index.eta';
-                return relativePath.replace(/\\/g, '/'); // Normalize to forward slashes
+                return posix.normalize(relativePath);
             }
         }
         // Then check for layout.eta as fallback
@@ -224,7 +225,7 @@ async function discoverLayout(pagePath, config, explicitLayout, isIndexPage) {
         if (await pathExists(layoutPath)) {
             // Return relative path with forward slashes for Eta
             const relativePath = dir ? `${dir}/layout.eta` : 'layout.eta';
-            return relativePath.replace(/\\/g, '/'); // Normalize to forward slashes
+            return posix.normalize(relativePath);
         }
     }
     return null;
@@ -241,7 +242,7 @@ 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 relativePath = relative(srcDir, page.sourcePath);
-    const partials = await discoverPartials(relativePath, config);
+    const partialPaths = await discoverPartials(relativePath, config);
     // Build collection data if this is an index page and all pages are provided
     let collectionData;
     const isIndexPage = allPages && isCollectionIndexPage(page, allPages);
@@ -251,20 +252,37 @@ export async function renderPage(page, body, config, eta, navigation, allPages)
     // Discover the appropriate layout using hierarchical layout.eta convention
     // Pass isIndexPage flag to enable index.eta lookup for aggregation pages
     const layoutPath = await discoverLayout(relativePath, config, page.frontMatter.layout, isIndexPage);
-    const context = {
+    // Create base context for partial rendering
+    const baseContext = {
         site: config.site,
         page: {
             ...page.frontMatter,
             path: page.url,
+            url: page.url, // Add url property for compatibility
             content: body,
         },
         content: body,
         navigation: navigation || [],
-        partials, // Add discovered partials to template context
         collection: collectionData, // Add collection data for index pages
         // Add custom filters to context
         ...(config.eta?.filters || {}),
     };
+    // Render partials and store their content
+    const renderedPartials = {};
+    for (const [partialName, partialPath] of Object.entries(partialPaths)) {
+        try {
+            const renderedContent = await eta.renderAsync(partialPath, baseContext);
+            renderedPartials[partialName] = renderedContent;
+        }
+        catch (error) {
+            console.warn(`Warning: Failed to render partial ${partialName} at ${partialPath}:`, error);
+            renderedPartials[partialName] = `<!-- Error rendering partial: ${partialName} -->`;
+        }
+    }
+    const context = {
+        ...baseContext,
+        partials: renderedPartials, // Add rendered partials to template context
+    };
     try {
         if (!layoutPath) {
             console.warn('No layout template found, using fallback');

package/dist/index.d.ts

@@ -21,7 +21,10 @@
  */
 export type { StatiConfig, PageModel, FrontMatter, BuildContext, PageContext, BuildHooks, NavNode, ISGConfig, AgingRule, BuildStats, } from './types.js';
 export type { BuildOptions } from './core/build.js';
+export type { DevServerOptions } from './core/dev.js';
+export type { InvalidationResult } from './core/invalidate.js';
 export { build } from './core/build.js';
+export { createDevServer } from './core/dev.js';
 export { loadConfig } from './config/loader.js';
 export { invalidate } from './core/invalidate.js';
 import type { StatiConfig } from './types.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,YAAY,EACV,WAAW,EACX,SAAS,EACT,WAAW,EACX,YAAY,EACZ,WAAW,EACX,UAAU,EACV,OAAO,EACP,SAAS,EACT,SAAS,EACT,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGlD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAE7D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,YAAY,EACV,WAAW,EACX,SAAS,EACT,WAAW,EACX,YAAY,EACZ,WAAW,EACX,UAAU,EACV,OAAO,EACP,SAAS,EACT,SAAS,EACT,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGlD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAE7D"}

package/dist/index.js

@@ -20,6 +20,7 @@
  * ```
  */
 export { build } from './core/build.js';
+export { createDevServer } from './core/dev.js';
 export { loadConfig } from './config/loader.js';
 export { invalidate } from './core/invalidate.js';
 /**

package/dist/types.d.ts

@@ -44,6 +44,60 @@ export interface ISGConfig {
     /** Array of aging rules for progressive cache extension */
     aging?: AgingRule[];
 }
+/**
+ * Cache entry for a single page in the ISG cache manifest.
+ * Contains all information needed to determine if a page needs rebuilding.
+ *
+ * @example
+ * ```typescript
+ * const entry: CacheEntry = {
+ *   path: '/blog/my-post/index.html',
+ *   inputsHash: 'sha256-abc123...',
+ *   deps: ['/site/_layouts/post.eta', '/site/_partials/header.eta'],
+ *   tags: ['blog', 'tutorial'],
+ *   publishedAt: '2024-01-01T00:00:00.000Z',
+ *   renderedAt: '2024-01-15T10:30:00.000Z',
+ *   ttlSeconds: 21600,
+ *   maxAgeCapDays: 365
+ * };
+ * ```
+ */
+export interface CacheEntry {
+    /** Output path of the rendered page */
+    path: string;
+    /** Hash of page content and all dependencies */
+    inputsHash: string;
+    /** Array of file paths this page depends on (templates, partials) */
+    deps: string[];
+    /** Tags for invalidation and organization */
+    tags: string[];
+    /** ISO date when content was originally published */
+    publishedAt?: string;
+    /** ISO date when page was last rendered */
+    renderedAt: string;
+    /** Effective TTL for this page in seconds */
+    ttlSeconds: number;
+    /** Maximum age cap for this page in days */
+    maxAgeCapDays?: number;
+}
+/**
+ * ISG cache manifest containing all cached page entries.
+ * Persisted as JSON in .stati/cache/manifest.json
+ *
+ * @example
+ * ```typescript
+ * const manifest: CacheManifest = {
+ *   entries: {
+ *     '/blog/post-1': { ... },
+ *     '/about': { ... }
+ *   }
+ * };
+ * ```
+ */
+export interface CacheManifest {
+    /** Map of page URLs to their cache entries */
+    entries: Record<string, CacheEntry>;
+}
 /**
  * Site-wide configuration settings.
  * Contains global metadata and URL configuration for the static site.
@@ -108,6 +162,15 @@ export interface StatiConfig {
     };
     /** Incremental Static Generation configuration */
     isg?: ISGConfig;
+    /** Development server configuration */
+    dev?: {
+        /** Port for development server (default: 3000) */
+        port?: number;
+        /** Host for development server (default: 'localhost') */
+        host?: string;
+        /** Whether to open browser automatically (default: false) */
+        open?: boolean;
+    };
     /** Build lifecycle hooks */
     hooks?: BuildHooks;
 }
@@ -259,6 +322,115 @@ export interface PageModel {
     /** Publication date (parsed from front matter or file stats) */
     publishedAt?: Date;
 }
+/**
+ * Logger interface for customizing build output and visualization.
+ * Provides comprehensive logging capabilities including basic log levels, build progress tracking,
+ * file operations, statistics display, and advanced tree-based rendering visualization.
+ *
+ * Core Methods (Required):
+ * - Basic logging: info, success, warning, error
+ * - Build progress: building, processing, stats
+ *
+ * Enhanced Methods (Optional):
+ * - Visual formatting: header, step, progress, divider
+ * - File operations: file, url, timing
+ * - Statistics: statsTable, navigationTree
+ * - Tree visualization: startRenderingTree, addTreeNode, updateTreeNode, showRenderingTree, clearRenderingTree
+ *
+ * @example Basic Logger Implementation
+ * ```typescript
+ * const basicLogger: Logger = {
+ *   info: (msg) => console.log('\x1b[38;2;37;99;235mℹ️  ' + msg + '\x1b[0m'),
+ *   success: (msg) => console.log('\x1b[38;2;22;163;74m✅ ' + msg + '\x1b[0m'),
+ *   warning: (msg) => console.warn('\x1b[38;2;217;119;6m⚠️  ' + msg + '\x1b[0m'),
+ *   error: (msg) => console.error('\x1b[38;2;220;38;38m❌ ' + msg + '\x1b[0m'),
+ *   building: (msg) => console.log('\x1b[38;2;79;70;229m' + msg + '\x1b[0m'),
+ *   processing: (msg) => console.log('\x1b[38;2;107;114;128m  ' + msg + '\x1b[0m'),
+ *   stats: (msg) => console.log('\x1b[38;2;8;145;178m📊 ' + msg + '\x1b[0m')
+ * };
+ * ```
+ *
+ * @example Enhanced Logger with Tree Visualization
+ * ```typescript
+ * const enhancedLogger: Logger = {
+ *   // ... basic methods ...
+ *   header: (msg) => console.log(boxedMessage(msg)),
+ *   step: (step, total, msg) => console.log(`[${step}/${total}] ${msg}`),
+ *   progress: (current, total, msg) => console.log(progressBar(current, total) + ' ' + msg),
+ *   file: (op, path) => console.log(`  📄 ${op} ${path}`),
+ *   url: (label, url) => console.log(`  🔗 ${label}: ${url}`),
+ *   timing: (op, duration) => console.log(`  ⏱️  ${op} completed in ${duration}ms`),
+ *   divider: (title) => console.log('─'.repeat(50) + ' ' + title),
+ *   statsTable: (stats) => displayStatsTable(stats),
+ *   startRenderingTree: (label) => initTree(label),
+ *   addTreeNode: (parentId, id, label, status, metadata) => addNode(parentId, id, label, status, metadata),
+ *   updateTreeNode: (id, status, metadata) => updateNode(id, status, metadata),
+ *   showRenderingTree: () => renderTree(),
+ *   clearRenderingTree: () => clearTree()
+ * };
+ * ```
+ */
+export interface Logger {
+    /** Log informational messages */
+    info: (message: string) => void;
+    /** Log success messages */
+    success: (message: string) => void;
+    /** Log warning messages */
+    warning: (message: string) => void;
+    /** Log error messages */
+    error: (message: string) => void;
+    /** Log build progress messages */
+    building: (message: string) => void;
+    /** Log file processing messages */
+    processing: (message: string) => void;
+    /** Log statistics and metrics */
+    stats: (message: string) => void;
+    /** Display a header message in a box (optional) */
+    header?: (message: string) => void;
+    /** Display a step indicator (optional) */
+    step?: (step: number, total: number, message: string) => void;
+    /** Display progress with a bar (optional) */
+    progress?: (current: number, total: number, message: string) => void;
+    /** Log file operations (optional) */
+    file?: (operation: string, path: string) => void;
+    /** Log URLs with proper styling (optional) */
+    url?: (label: string, url: string) => void;
+    /** Log timing information (optional) */
+    timing?: (operation: string, duration: number) => void;
+    /** Display a section divider (optional) */
+    divider?: (title?: string) => void;
+    /** Display build statistics as a table (optional) */
+    statsTable?: (stats: {
+        totalPages: number;
+        assetsCount: number;
+        buildTimeMs: number;
+        outputSizeBytes: number;
+        cacheHits?: number;
+        cacheMisses?: number;
+    }) => void;
+    /** Display navigation tree structure (optional) */
+    navigationTree?: (navigation: NavNode[]) => void;
+    /** Initialize a rendering tree for build process visualization (optional) */
+    startRenderingTree?: (label: string) => void;
+    /** Add a step to the rendering tree (optional) */
+    addTreeNode?: (parentId: string, id: string, label: string, status?: 'pending' | 'running' | 'cached' | 'completed' | 'error', metadata?: {
+        timing?: number;
+        cacheHit?: boolean;
+        url?: string;
+        operation?: string;
+    }) => void;
+    /** Update a node in the rendering tree (optional) */
+    updateTreeNode?: (id: string, status: 'pending' | 'running' | 'cached' | 'completed' | 'error', metadata?: {
+        timing?: number;
+        cacheHit?: boolean;
+        url?: string;
+        operation?: string;
+    }) => void;
+    /** Render and display the current tree (optional) */
+    showRenderingTree?: () => void;
+    /** Clear the rendering tree (optional) */
+    clearRenderingTree?: () => void;
+}
 /**
  * Statistics collected during the build process.
  * Provides useful metrics about the site generation.

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,aAAa,CAAC;AAE1C;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,SAAS;IACxB,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,SAAS;IACxB,qCAAqC;IACrC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,6CAA6C;IAC7C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACrC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,wCAAwC;IACxC,QAAQ,CAAC,EAAE;QACT,oGAAoG;QACpG,OAAO,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;QACzC,oDAAoD;QACpD,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,UAAU,KAAK,IAAI,CAAC;KACtC,CAAC;IACF,wCAAwC;IACxC,GAAG,CAAC,EAAE;QACJ,8BAA8B;QAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC;KACnD,CAAC;IACF,kDAAkD;IAClD,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,uCAAuC;IACvC,GAAG,CAAC,EAAE;QACJ,kDAAkD;QAClD,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,yDAAyD;QACzD,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,6DAA6D;QAC7D,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,CAAC;IACF,4BAA4B;IAC5B,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,MAAM,EAAE,WAAW,CAAC;IACpB,sCAAsC;IACtC,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,WAAW;IAC1B,qCAAqC;IACrC,IAAI,EAAE,SAAS,CAAC;IAChB,uCAAuC;IACvC,MAAM,EAAE,WAAW,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,UAAU;IACzB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACxD,gDAAgD;IAChD,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvD,mDAAmD;IACnD,mDAAmD;IACnD,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1D,kDAAkD;IAClD,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC1D;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,0CAA0C;IAC1C,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,2CAA2C;IAC3C,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,6DAA6D;IAC7D,WAAW,EAAE,SAAS,EAAE,CAAC;IACzB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IACxC,0BAA0B;IAC1B,QAAQ,EAAE;QACR,0CAA0C;QAC1C,UAAU,EAAE,MAAM,CAAC;QACnB,yCAAyC;QACzC,WAAW,EAAE,OAAO,CAAC;QACrB,6BAA6B;QAC7B,cAAc,EAAE,MAAM,CAAC;QACvB,iDAAiD;QACjD,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,IAAI,EAAE,UAAU,CAAC;IACjB,0DAA0D;IAC1D,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,UAAU,EAAE,OAAO,EAAE,CAAC;IACtB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,iFAAiF;IACjF,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,SAAS;IACxB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,WAAW,EAAE,WAAW,CAAC;IACzB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,WAAW,CAAC,EAAE,IAAI,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,MAAM,WAAW,MAAM;IACrB,iCAAiC;IACjC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,2BAA2B;IAC3B,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,2BAA2B;IAC3B,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,yBAAyB;IACzB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,kCAAkC;IAClC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,mCAAmC;IACnC,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,iCAAiC;IACjC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,mDAAmD;IACnD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,0CAA0C;IAC1C,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9D,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACrE,qCAAqC;IACrC,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,8CAA8C;IAC9C,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,wCAAwC;IACxC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACvD,2CAA2C;IAC3C,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,qDAAqD;IACrD,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE,MAAM,CAAC;QACxB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,KAAK,IAAI,CAAC;IACX,mDAAmD;IACnD,cAAc,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACjD,6EAA6E;IAC7E,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,kDAAkD;IAClD,WAAW,CAAC,EAAE,CACZ,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,EACjE,QAAQ,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KACjF,IAAI,CAAC;IACV,qDAAqD;IACrD,cAAc,CAAC,EAAE,CACf,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,EAChE,QAAQ,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KACjF,IAAI,CAAC;IACV,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B,0CAA0C;IAC1C,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,UAAU;IACzB,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,eAAe,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,OAAO;IACtB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,WAAW;IAC1B,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,mCAAmC;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stati/core",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -27,14 +27,18 @@
     "test": "vitest run"
   },
   "dependencies": {
+    "chokidar": "^3.6.0",
     "eta": "^3.5.0",
     "fast-glob": "^3.3.3",
     "fs-extra": "^11.2.0",
     "gray-matter": "^4.0.3",
-    "markdown-it": "^14.1.0"
+    "markdown-it": "^14.1.0",
+    "open": "^10.1.0",
+    "ws": "^8.18.0"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",
-    "@types/markdown-it": "^14.1.2"
+    "@types/markdown-it": "^14.1.2",
+    "@types/ws": "^8.5.12"
   }
 }