@stati/core 1.9.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/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;AAwLzF,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,CAyKjB"}
+{"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, wrapPartialsAsCallable, } 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: {

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

@@ -6,10 +6,12 @@ export { readFile, writeFile, pathExists, ensureDir, remove, copyFile, readdir,
 export { resolveSrcDir, resolveOutDir, resolveStaticDir, resolveCacheDir, resolveDevPaths, normalizeTemplatePath, resolveSrcPath, resolveOutPath, resolveStaticPath, } from './paths.js';
 export { discoverLayout, isCollectionIndexPage, getCollectionPathForPage, } from './template-discovery.js';
 export { propValue } from './template-utils.js';
+export { trackTailwindClass, enableInventoryTracking, disableInventoryTracking, clearInventory, getInventory, getInventorySize, isTrackingEnabled, writeTailwindClassInventory, isTailwindUsed, resetTailwindDetection, loadPreviousInventory, } from './tailwind-inventory.js';
 export { createValidatingPartialsProxy } from './partial-validation.js';
 export { makeCallablePartial, wrapPartialsAsCallable } from './callable-partials.js';
 export type { CallablePartial } from './callable-partials.js';
 export { TemplateError, parseEtaError, createTemplateError } from './template-errors.js';
+export { createNavigationHelpers } from './navigation-helpers.js';
 export { resolvePrettyUrl } from './server.js';
 export type { PrettyUrlResult } from './server.js';
 export { createErrorOverlay, parseErrorDetails } from './error-overlay.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,QAAQ,EACR,SAAS,EACT,UAAU,EACV,SAAS,EACT,MAAM,EACN,QAAQ,EACR,OAAO,EACP,IAAI,GACL,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGhD,OAAO,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AAGxE,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrF,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,QAAQ,EACR,SAAS,EACT,UAAU,EACV,SAAS,EACT,MAAM,EACN,QAAQ,EACR,OAAO,EACP,IAAI,GACL,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGhD,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,2BAA2B,EAC3B,cAAc,EACd,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AAGxE,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrF,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG9D,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGzF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAGlE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/core/utils/index.js

@@ -10,12 +10,16 @@ export { resolveSrcDir, resolveOutDir, resolveStaticDir, resolveCacheDir, resolv
 export { discoverLayout, isCollectionIndexPage, getCollectionPathForPage, } from './template-discovery.js';
 // Template utilities
 export { propValue } from './template-utils.js';
+// Tailwind inventory utilities
+export { trackTailwindClass, enableInventoryTracking, disableInventoryTracking, clearInventory, getInventory, getInventorySize, isTrackingEnabled, writeTailwindClassInventory, isTailwindUsed, resetTailwindDetection, loadPreviousInventory, } from './tailwind-inventory.js';
 // Partial validation utilities
 export { createValidatingPartialsProxy } from './partial-validation.js';
 // Callable partial utilities
 export { makeCallablePartial, wrapPartialsAsCallable } from './callable-partials.js';
 // Template error utilities
 export { TemplateError, parseEtaError, createTemplateError } from './template-errors.js';
+// Navigation helper utilities
+export { createNavigationHelpers } from './navigation-helpers.js';
 // Server utilities
 export { resolvePrettyUrl } from './server.js';
 // Error overlay utilities

package/dist/core/utils/navigation-helpers.d.ts

@@ -0,0 +1,124 @@
+import type { NavNode, PageModel } from '../../types/index.js';
+/**
+ * Navigation helper utilities for template context.
+ * Provides methods for querying and traversing the navigation tree.
+ */
+/**
+ * Finds a navigation node by its path or URL.
+ *
+ * @param tree - Navigation tree to search
+ * @param path - Path or URL to find
+ * @returns The found node or undefined
+ */
+export declare function findNode(tree: NavNode[], path: string): NavNode | undefined;
+/**
+ * Gets the children of a specific navigation node by path.
+ *
+ * @param tree - Navigation tree to search
+ * @param path - Path of the parent node
+ * @returns Array of child nodes or empty array if not found or no children
+ */
+export declare function getChildren(tree: NavNode[], path: string): NavNode[];
+/**
+ * Gets the parent node of a specific path.
+ *
+ * @param tree - Navigation tree to search
+ * @param path - Path to find parent for
+ * @returns The parent node or undefined
+ */
+export declare function getParent(tree: NavNode[], path: string): NavNode | undefined;
+/**
+ * Gets the siblings of a specific path (nodes at the same level).
+ *
+ * @param tree - Navigation tree to search
+ * @param path - Path to find siblings for
+ * @param includeSelf - Whether to include the node itself in the results
+ * @returns Array of sibling nodes or empty array
+ */
+export declare function getSiblings(tree: NavNode[], path: string, includeSelf?: boolean): NavNode[];
+/**
+ * Gets a subtree starting from a specific path.
+ *
+ * @param tree - Navigation tree to search
+ * @param path - Root path for the subtree
+ * @returns The subtree as an array (single node with its children) or empty array
+ */
+export declare function getSubtree(tree: NavNode[], path: string): NavNode[];
+/**
+ * Gets the breadcrumb trail from root to a specific path.
+ *
+ * @param tree - Navigation tree to search
+ * @param path - Path to get breadcrumbs for
+ * @returns Array of nodes from root to the target path
+ */
+export declare function getBreadcrumbs(tree: NavNode[], path: string): NavNode[];
+/**
+ * Finds the current page's navigation node.
+ *
+ * @param tree - Navigation tree to search
+ * @param currentPage - Current page model
+ * @returns The navigation node for the current page or undefined
+ */
+export declare function getCurrentNode(tree: NavNode[], currentPage: PageModel): NavNode | undefined;
+/**
+ * Creates a navigation helpers object for template context.
+ *
+ * @param tree - The full navigation tree
+ * @param currentPage - The current page being rendered
+ * @returns Object with navigation helper methods
+ */
+export declare function createNavigationHelpers(tree: NavNode[], currentPage: PageModel): {
+    /**
+     * The full navigation tree.
+     * Use stati.nav.tree to access the global navigation.
+     */
+    tree: NavNode[];
+    /**
+     * Gets the full navigation tree.
+     * @returns The complete navigation tree
+     */
+    getTree: () => NavNode[];
+    /**
+     * Finds a navigation node by path or URL.
+     * @param path - The path or URL to find
+     * @returns The found node or undefined
+     */
+    findNode: (path: string) => NavNode | undefined;
+    /**
+     * Gets the children of a navigation node.
+     * @param path - The path of the parent node
+     * @returns Array of child navigation nodes
+     */
+    getChildren: (path: string) => NavNode[];
+    /**
+     * Gets the parent of a navigation node.
+     * @param path - The path to find the parent for (defaults to current page)
+     * @returns The parent node or undefined
+     */
+    getParent: (path?: string) => NavNode | undefined;
+    /**
+     * Gets the siblings of a navigation node.
+     * @param path - The path to find siblings for (defaults to current page)
+     * @param includeSelf - Whether to include the node itself
+     * @returns Array of sibling nodes
+     */
+    getSiblings: (path?: string, includeSelf?: boolean) => NavNode[];
+    /**
+     * Gets a subtree starting from a specific path.
+     * @param path - The root path for the subtree
+     * @returns Array containing the subtree
+     */
+    getSubtree: (path: string) => NavNode[];
+    /**
+     * Gets the breadcrumb trail for a path.
+     * @param path - The path to get breadcrumbs for (defaults to current page)
+     * @returns Array of nodes from root to the target
+     */
+    getBreadcrumbs: (path?: string) => NavNode[];
+    /**
+     * Gets the current page's navigation node.
+     * @returns The navigation node for the current page or undefined
+     */
+    getCurrentNode: () => NavNode | undefined;
+};
+//# sourceMappingURL=navigation-helpers.d.ts.map

package/dist/core/utils/navigation-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-helpers.d.ts","sourceRoot":"","sources":["../../../src/core/utils/navigation-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAE/D;;;GAGG;AAEH;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAiB3E;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAGpE;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE5E;AAiCD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,UAAQ,GAAG,OAAO,EAAE,CAiBzF;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAGnE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAIvE;AAkCD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAE3F;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,SAAS;IAE3E;;;OAGG;;IAGH;;;OAGG;;IAGH;;;;OAIG;qBACc,MAAM;IAEvB;;;;OAIG;wBACiB,MAAM;IAE1B;;;;OAIG;uBACgB,MAAM;IAEzB;;;;;OAKG;yBACkB,MAAM;IAG3B;;;;OAIG;uBACgB,MAAM;IAEzB;;;;OAIG;4BACqB,MAAM;IAE9B;;;OAGG;;EAGN"}