@stati/core 1.8.0 → 1.10.0

package/README.md

@@ -327,7 +327,7 @@ export default defineConfig({
 });
 ```
 
-> **For the complete configuration reference** including all options, advanced features, and detailed explanations, see the [Configuration Guide](https://docs.stati.build/configuration/).
+> **For the complete configuration reference** including all options, advanced features, and detailed explanations, see the [Configuration Guide](https://docs.stati.build/configuration/file/).
 
 ---
 
@@ -621,14 +621,14 @@ Automatic navigation hierarchy based on your file structure:
 ```html
 <!-- Show breadcrumbs -->
 <nav>
-  <% stati.page.breadcrumbs.forEach(crumb => { %>
+  <% stati.nav.getBreadcrumbs().forEach(crumb => { %>
     <a href="<%= crumb.url %>"><%= crumb.title %></a>
   <% }) %>
 </nav>
 
 <!-- Show navigation tree -->
 <ul>
-  <% stati.navigation.forEach(item => { %>
+  <% stati.nav.tree.forEach(item => { %>
     <li><a href="<%= item.url %>"><%= item.title %></a></li>
   <% }) %>
 </ul>
@@ -739,9 +739,9 @@ export default defineConfig({
 ## Learn More
 
 - [**Full Documentation**](https://docs.stati.build) — Complete guides and tutorials
-- [**Configuration Guide**](https://docs.stati.build/configuration/) — All options explained
-- [**API Reference**](https://docs.stati.build/api/) — Detailed API docs
-- [**Examples**](https://docs.stati.build/examples/) — Real-world projects
+- [**Configuration Guide**](https://docs.stati.build/configuration/file/) — All options explained
+- [**API Reference**](https://docs.stati.build/api/reference/) — Detailed API docs
+- [**Examples**](https://docs.stati.build/examples/list/) — Real-world projects
 - [**Contributing**](https://github.com/ianchak/stati/blob/main/CONTRIBUTING.md) — Help improve Stati
 
 ---

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

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

package/dist/core/build.js

@@ -1,4 +1,4 @@
-import { ensureDir, writeFile, remove, pathExists, stat, readdir, copyFile, resolveOutDir, resolveStaticDir, resolveCacheDir, } from './utils/index.js';
+import { ensureDir, writeFile, remove, pathExists, stat, readdir, copyFile, resolveOutDir, resolveStaticDir, resolveCacheDir, enableInventoryTracking, disableInventoryTracking, clearInventory, writeTailwindClassInventory, getInventorySize, isTailwindUsed, loadPreviousInventory, } from './utils/index.js';
 import { join, dirname, relative } from 'path';
 import { posix } from 'path';
 import { loadConfig } from '../config/loader.js';
@@ -6,7 +6,7 @@ import { loadContent } from './content.js';
 import { createMarkdownProcessor, renderMarkdown } from './markdown.js';
 import { createTemplateEngine, renderPage } from './templates.js';
 import { buildNavigation } from './navigation.js';
-import { loadCacheManifest, saveCacheManifest, shouldRebuildPage, createCacheEntry, updateCacheEntry, withBuildLock, } from './isg/index.js';
+import { loadCacheManifest, saveCacheManifest, shouldRebuildPage, createCacheEntry, updateCacheEntry, withBuildLock, computeNavigationHash, } from './isg/index.js';
 import { generateSitemap, generateRobotsTxtFromConfig, autoInjectSEO, } from '../seo/index.js';
 /**
  * Recursively calculates the total size of a directory in bytes.
@@ -172,10 +172,12 @@ async function loadContentAndBuildNavigation(config, options, logger) {
     if (logger.navigationTree) {
         logger.navigationTree(navigation);
     }
+    // Compute navigation hash for change detection in dev server
+    const navigationHash = computeNavigationHash(navigation);
     // Create processors
     const md = await createMarkdownProcessor(config);
     const eta = createTemplateEngine(config);
-    return { pages, navigation, md, eta };
+    return { pages, navigation, md, eta, navigationHash };
 }
 /**
  * Processes pages with ISG caching logic.
@@ -362,17 +364,50 @@ async function buildInternal(options = {}) {
         await remove(cacheDir);
     }
     await ensureDir(outDir);
+    // Enable Tailwind class inventory tracking only if Tailwind is detected
+    const hasTailwind = await isTailwindUsed();
+    if (hasTailwind) {
+        enableInventoryTracking();
+        clearInventory(); // Clear any previous inventory
+        // Try to load from existing inventory file
+        const loadedCount = await loadPreviousInventory(cacheDir);
+        if (loadedCount > 0) {
+            // Write the initial inventory file immediately so Tailwind can scan it
+            // This is critical for dev server where Tailwind starts watching before template rendering
+            await writeTailwindClassInventory(cacheDir);
+            logger.info(`📦 Loaded ${loadedCount} classes from previous build for Tailwind scanner`);
+        }
+        else {
+            // No previous inventory found - write an empty placeholder file
+            // This ensures Tailwind has a file to scan even on first build
+            // It will be populated with actual classes after template rendering
+            await writeTailwindClassInventory(cacheDir);
+            logger.info(`📦 Created inventory file for Tailwind scanner (will be populated after rendering)`);
+        }
+    }
     // Load cache manifest for ISG (after potential clean operation)
     const { manifest } = await setupCacheAndManifest(cacheDir);
     // Load content and build navigation
     console.log(); // Add spacing before content loading
-    const { pages, navigation, md, eta } = await loadContentAndBuildNavigation(config, options, logger);
+    const { pages, navigation, md, eta, navigationHash } = await loadContentAndBuildNavigation(config, options, logger);
+    // Store navigation hash in manifest for change detection in dev server
+    manifest.navigationHash = navigationHash;
     // 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;
+    // Write Tailwind class inventory after all templates have been rendered (if Tailwind is used)
+    if (hasTailwind) {
+        const inventorySize = getInventorySize();
+        if (inventorySize > 0) {
+            await writeTailwindClassInventory(cacheDir);
+            logger.info(`📝 Generated Tailwind class inventory (${inventorySize} classes tracked)`);
+        }
+        // Disable inventory tracking after build
+        disableInventoryTracking();
+    }
     // Save updated cache manifest
     await saveCacheManifest(cacheDir, manifest);
     // Copy static assets and count them

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

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

package/dist/core/dev.js

@@ -7,7 +7,9 @@ import chokidar from 'chokidar';
 import { build } from './build.js';
 import { invalidate } from './invalidate.js';
 import { loadConfig } from '../config/loader.js';
-import { loadCacheManifest, saveCacheManifest } from './isg/index.js';
+import { loadCacheManifest, saveCacheManifest, computeNavigationHash } from './isg/index.js';
+import { loadContent } from './content.js';
+import { buildNavigation } from './navigation.js';
 import { resolveDevPaths, resolveCacheDir, resolvePrettyUrl, createErrorOverlay, parseErrorDetails, TemplateError, } from './utils/index.js';
 import { setEnv, getEnv } from '../env.js';
 import { DEFAULT_DEV_PORT, DEFAULT_DEV_HOST, TEMPLATE_EXTENSION } from '../constants.js';
@@ -88,8 +90,11 @@ async function performIncrementalRebuild(changedPath, configPath, logger, wsServ
         if (changedPath.endsWith(TEMPLATE_EXTENSION) || changedPath.includes('_partials')) {
             await handleTemplateChange(changedPath, configPath, devLogger);
         }
+        else if (changedPath.endsWith('.md')) {
+            await handleMarkdownChange(changedPath, configPath, devLogger);
+        }
         else {
-            // Content or static file changed - use normal rebuild
+            // Static file changed - use normal rebuild
             await build({
                 logger: devLogger,
                 force: false,
@@ -198,6 +203,69 @@ async function handleTemplateChange(templatePath, configPath, logger) {
         }
     }
 }
+/**
+ * Handles markdown file changes by comparing navigation hashes.
+ * Only performs a full rebuild if navigation structure actually changed.
+ * Navigation changes come from frontmatter modifications (title, order, description).
+ * Content-only changes use incremental rebuilds.
+ */
+async function handleMarkdownChange(_markdownPath, configPath, logger) {
+    const cacheDir = resolveCacheDir();
+    try {
+        // Load existing cache manifest
+        const cacheManifest = await loadCacheManifest(cacheDir);
+        if (!cacheManifest || !cacheManifest.navigationHash) {
+            // No cache or no navigation hash exists, perform full rebuild
+            await build({
+                logger,
+                force: false,
+                clean: false,
+                ...(configPath && { configPath }),
+            });
+            return;
+        }
+        // Load config and content to rebuild navigation tree
+        const config = await loadConfig(configPath);
+        const pages = await loadContent(config);
+        const newNavigation = buildNavigation(pages);
+        const newNavigationHash = computeNavigationHash(newNavigation);
+        // Compare navigation hashes
+        if (newNavigationHash !== cacheManifest.navigationHash) {
+            // Navigation structure changed - clear cache and force full rebuild
+            logger.info?.('📊 Navigation structure changed, performing full rebuild...');
+            // Force rebuild bypasses ISG cache entirely
+            await build({
+                logger,
+                force: true, // Force rebuild to bypass cache
+                clean: false,
+                ...(configPath && { configPath }),
+            });
+        }
+        else {
+            // Navigation unchanged - use incremental rebuild for content changes
+            await build({
+                logger,
+                force: false,
+                clean: false,
+                ...(configPath && { configPath }),
+            });
+        }
+    }
+    catch (_error) {
+        try {
+            // Fallback to full rebuild
+            await build({
+                logger,
+                force: false,
+                clean: false,
+                ...(configPath && { configPath }),
+            });
+        }
+        catch (fallbackError) {
+            throw fallbackError instanceof Error ? fallbackError : new Error(String(fallbackError));
+        }
+    }
+}
 export async function createDevServer(options = {}) {
     const { port = DEFAULT_DEV_PORT, host = DEFAULT_DEV_HOST, open = false, configPath, logger = {
         info: (msg) => console.log(msg),

package/dist/core/isg/deps.js

@@ -244,6 +244,27 @@ async function parseTemplateDependencies(content, templatePath, srcDir) {
             }
         }
     }
+    // Look for Stati callable partial patterns: stati.partials.name( or stati.partials['name'](
+    // This catches both direct property access and bracket notation with or without arguments
+    // Patterns allow for optional whitespace before the opening parenthesis
+    const callablePartialPatterns = [
+        /stati\.partials\.(\w+)\s*\(/g, // stati.partials.header( or stati.partials.header  (
+        /stati\.partials\[['"`]([^'"`]+)['"`]\]\s*\(/g, // stati.partials['header']( with whitespace
+    ];
+    for (const pattern of callablePartialPatterns) {
+        let match;
+        while ((match = pattern.exec(content)) !== null) {
+            const partialName = match[1];
+            if (partialName) {
+                // Resolve the partial by searching for it in underscore directories
+                const partialFileName = `${partialName}${TEMPLATE_EXTENSION}`;
+                const resolvedPath = await resolveTemplatePathInternal(partialFileName, srcDir, templateDir);
+                if (resolvedPath) {
+                    dependencies.push(resolvedPath);
+                }
+            }
+        }
+    }
     return dependencies;
 }
 /**

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

@@ -45,4 +45,18 @@ export declare function computeFileHash(filePath: string): Promise<string | null
  * ```
  */
 export declare function computeInputsHash(contentHash: string, depsHashes: string[]): string;
+/**
+ * Computes a hash of the navigation tree structure.
+ * Used to detect when navigation has changed (title, url, order, children structure).
+ *
+ * @param navigation - The navigation tree to hash
+ * @returns SHA-256 hash as a hex string
+ *
+ * @example
+ * ```typescript
+ * const hash = computeNavigationHash(navigationTree);
+ * console.log(hash); // "sha256-abc123..."
+ * ```
+ */
+export declare function computeNavigationHash(navigation: unknown[]): string;
 //# sourceMappingURL=hash.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../src/core/isg/hash.ts"],"names":[],"mappings":"AAwBA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAiBhG;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiB9E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAKnF"}
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../src/core/isg/hash.ts"],"names":[],"mappings":"AAwBA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAiBhG;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiB9E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAKnF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,OAAO,EAAE,GAAG,MAAM,CAqCnE"}

package/dist/core/isg/hash.js

@@ -97,7 +97,38 @@ export async function computeFileHash(filePath) {
  * ```
  */
 export function computeInputsHash(contentHash, depsHashes) {
-    // Hash each dependency hash in sorted order for consistency
+    // Sort dependency hashes for consistency
     const sortedDepsHashes = [...depsHashes].sort();
     return createSha256Hash([contentHash, ...sortedDepsHashes]);
 }
+/**
+ * Computes a hash of the navigation tree structure.
+ * Used to detect when navigation has changed (title, url, order, children structure).
+ *
+ * @param navigation - The navigation tree to hash
+ * @returns SHA-256 hash as a hex string
+ *
+ * @example
+ * ```typescript
+ * const hash = computeNavigationHash(navigationTree);
+ * console.log(hash); // "sha256-abc123..."
+ * ```
+ */
+export function computeNavigationHash(navigation) {
+    const normalizeNavNode = (node) => {
+        const normalized = {
+            title: String(node.title ?? ''),
+            url: String(node.url ?? ''),
+        };
+        if (node.order !== undefined && typeof node.order === 'number') {
+            normalized.order = node.order;
+        }
+        if (node.children && Array.isArray(node.children) && node.children.length > 0) {
+            normalized.children = node.children.map((child) => normalizeNavNode(child));
+        }
+        return normalized;
+    };
+    const normalizedNav = navigation.map((node) => normalizeNavNode(node));
+    const navJson = JSON.stringify(normalizedNav);
+    return createSha256Hash(navJson);
+}

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

@@ -10,7 +10,7 @@ export { loadCacheManifest, saveCacheManifest, createEmptyManifest } from './man
 export { shouldRebuildPage, createCacheEntry, updateCacheEntry } from './builder.js';
 export { BuildLockManager, withBuildLock } from './build-lock.js';
 export { CircularDependencyError, trackTemplateDependencies, findPartialDependencies, resolveTemplatePath, } from './deps.js';
-export { computeContentHash, computeFileHash, computeInputsHash } from './hash.js';
+export { computeContentHash, computeFileHash, computeInputsHash, computeNavigationHash, } from './hash.js';
 export { getSafeCurrentTime, parseSafeDate, computeEffectiveTTL, computeNextRebuildAt, isPageFrozen, applyAgingRules, } from './ttl.js';
 export { ISGConfigurationError, validateISGConfig, validatePageISGOverrides, extractNumericOverride, } from './validation.js';
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/core/isg/index.js

@@ -15,7 +15,7 @@ export { BuildLockManager, withBuildLock } from './build-lock.js';
 // Dependency tracking
 export { CircularDependencyError, trackTemplateDependencies, findPartialDependencies, resolveTemplatePath, } from './deps.js';
 // Hash computation
-export { computeContentHash, computeFileHash, computeInputsHash } from './hash.js';
+export { computeContentHash, computeFileHash, computeInputsHash, computeNavigationHash, } from './hash.js';
 // TTL and aging
 export { getSafeCurrentTime, parseSafeDate, computeEffectiveTTL, computeNextRebuildAt, isPageFrozen, applyAgingRules, } from './ttl.js';
 // Validation

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":"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"}
+{"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,CAsGvF;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

@@ -71,7 +71,13 @@ export async function loadCacheManifest(cacheDir) {
         if (invalidEntryCount > 0) {
             console.warn(`Removed ${invalidEntryCount} invalid cache entries`);
         }
-        return { entries: validatedEntries };
+        // Return manifest with entries AND navigationHash (if present)
+        const resultManifest = { entries: validatedEntries };
+        // Preserve navigationHash if it exists
+        if (typeof manifestObj.navigationHash === 'string') {
+            resultManifest.navigationHash = manifestObj.navigationHash;
+        }
+        return resultManifest;
     }
     catch (error) {
         const nodeError = error;

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

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

package/dist/core/templates.js

@@ -2,7 +2,7 @@ import { Eta } from 'eta';
 import { join, dirname, relative, basename, posix } from 'path';
 import glob from 'fast-glob';
 import { TEMPLATE_EXTENSION } from '../constants.js';
-import { getStatiVersion, isCollectionIndexPage, discoverLayout, getCollectionPathForPage, resolveSrcDir, createTemplateError, createValidatingPartialsProxy, propValue, } from './utils/index.js';
+import { getStatiVersion, isCollectionIndexPage, discoverLayout, getCollectionPathForPage, resolveSrcDir, createTemplateError, createValidatingPartialsProxy, propValue, wrapPartialsAsCallable, createNavigationHelpers, } from './utils/index.js';
 import { getEnv } from '../env.js';
 import { generateSEO } from '../seo/index.js';
 /**
@@ -100,6 +100,25 @@ function buildCollectionData(currentPage, allPages) {
         },
     };
 }
+/**
+ * Builds collection data for a child page (showing parent collection data).
+ * Finds the parent collection and returns its data.
+ *
+ * @param currentPage - The current page being rendered
+ * @param allPages - All pages in the site
+ * @returns Collection data for the parent collection or undefined
+ */
+function buildParentCollectionData(currentPage, allPages) {
+    // Get the parent collection path
+    const parentPath = getCollectionPathForPage(currentPage.url);
+    // Find the index page for the parent collection
+    const parentIndexPage = allPages.find((p) => p.url === parentPath);
+    if (parentIndexPage) {
+        // Build collection data for the parent
+        return buildCollectionData(parentIndexPage, allPages);
+    }
+    return undefined;
+}
 /**
  * Discovers partials in the hierarchy for a given page path.
  * Scans all parent directories for folders starting with underscore.
@@ -168,15 +187,26 @@ export async function renderPage(page, body, config, eta, navigation, allPages)
     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
+    // Build collection data based on page type
     let collectionData;
     const isIndexPage = allPages && isCollectionIndexPage(page, allPages);
-    if (isIndexPage) {
-        collectionData = buildCollectionData(page, allPages);
+    if (allPages) {
+        if (isIndexPage) {
+            // For index pages, show their own collection data
+            collectionData = buildCollectionData(page, allPages);
+        }
+        else {
+            // For child pages, show parent collection data
+            collectionData = buildParentCollectionData(page, 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);
+    // Create navigation helpers
+    const navTree = navigation || [];
+    const navHelpers = createNavigationHelpers(navTree, page);
+    const currentNavNode = navHelpers.getCurrentNode();
     // Create base context for partial rendering
     const baseContext = {
         site: config.site,
@@ -185,10 +215,11 @@ export async function renderPage(page, body, config, eta, navigation, allPages)
             path: page.url,
             url: page.url, // Add url property for compatibility
             content: body,
+            navNode: currentNavNode, // Add current page's navigation node
         },
         content: body,
-        navigation: navigation || [],
-        collection: collectionData, // Add collection data for index pages
+        nav: navHelpers, // Replace navigation with nav helpers
+        collection: collectionData, // Add collection data
         // Add custom filters to context
         ...(config.eta?.filters || {}),
         generator: {
@@ -223,9 +254,11 @@ export async function renderPage(page, body, config, eta, navigation, allPages)
             try {
                 // Create context with all previously rendered partials available
                 const combinedPartials = { ...renderedPartials, ...passRenderedPartials };
+                // Wrap partials as callable before passing to validation proxy
+                const callablePartials = wrapPartialsAsCallable(eta, combinedPartials, partialPaths, baseContext);
                 const partialContext = {
                     ...baseContext,
-                    partials: createValidatingPartialsProxy(combinedPartials), // Include both previous and current pass partials with validation
+                    partials: createValidatingPartialsProxy(callablePartials), // Include both previous and current pass partials with validation
                 };
                 const renderedContent = await eta.renderAsync(partialPath, partialContext);
                 passRenderedPartials[partialName] = renderedContent;
@@ -268,9 +301,11 @@ export async function renderPage(page, body, config, eta, navigation, allPages)
             break;
         }
     }
+    // Wrap final rendered partials as callable before passing to layout context
+    const callablePartials = wrapPartialsAsCallable(eta, renderedPartials, partialPaths, baseContext);
     const context = {
         ...baseContext,
-        partials: createValidatingPartialsProxy(renderedPartials), // Add rendered partials with validation
+        partials: createValidatingPartialsProxy(callablePartials), // Add rendered partials with validation
     };
     try {
         if (!layoutPath) {

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

@@ -0,0 +1,60 @@
+import { Eta } from 'eta';
+/**
+ * Type definition for a callable partial function.
+ * Can be called with optional props or used directly as a value.
+ */
+export type CallablePartial = {
+    (props?: Record<string, unknown>): string;
+    toString(): string;
+    valueOf(): string;
+};
+/**
+ * Creates a callable partial that can be used both as a value and as a function.
+ * This enables both syntaxes:
+ * - Direct usage: <%~ stati.partials.header %>
+ * - With props: <%~ stati.partials.hero({ title: 'Hello' }) %>
+ *
+ * @param eta - The Eta template engine instance
+ * @param partialPath - Absolute path to the partial template file
+ * @param baseContext - The base template context (without props)
+ * @param renderedContent - Pre-rendered content for the no-props case
+ * @returns A callable partial function
+ *
+ * @example
+ * ```typescript
+ * const callable = makeCallablePartial(eta, '/path/to/partial.eta', baseContext, '<div>Header</div>');
+ *
+ * // Use without props (returns pre-rendered content)
+ * const html1 = callable.toString(); // '<div>Header</div>'
+ *
+ * // Use with props (re-renders with merged context)
+ * const html2 = callable({ title: 'Custom Title' }); // Renders with custom props
+ * ```
+ */
+export declare function makeCallablePartial(eta: Eta, partialPath: string, baseContext: Record<string, unknown>, renderedContent: string): CallablePartial;
+/**
+ * Wraps all partials in a record with callable partial wrappers.
+ * This allows partials to be used both as values and as functions.
+ *
+ * @param eta - The Eta template engine instance
+ * @param partials - Record mapping partial names to their rendered content
+ * @param partialPaths - Record mapping partial names to their absolute file paths
+ * @param baseContext - The base template context (without props)
+ * @returns Record of callable partials
+ *
+ * @example
+ * ```typescript
+ * const callablePartials = wrapPartialsAsCallable(
+ *   eta,
+ *   { header: '<div>Header</div>', footer: '<div>Footer</div>' },
+ *   { header: '/path/to/header.eta', footer: '/path/to/footer.eta' },
+ *   baseContext
+ * );
+ *
+ * // Both syntaxes work
+ * callablePartials.header.toString(); // Direct usage
+ * callablePartials.header({ title: 'Custom' }); // With props
+ * ```
+ */
+export declare function wrapPartialsAsCallable(eta: Eta, partials: Record<string, string>, partialPaths: Record<string, string>, baseContext: Record<string, unknown>): Record<string, CallablePartial>;
+//# sourceMappingURL=callable-partials.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"callable-partials.d.ts","sourceRoot":"","sources":["../../../src/core/utils/callable-partials.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAE1B;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;IAC1C,QAAQ,IAAI,MAAM,CAAC;IACnB,OAAO,IAAI,MAAM,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,GAAG,EACR,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,eAAe,EAAE,MAAM,GACtB,eAAe,CAqDjB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,GAAG,EACR,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAcjC"}