@stati/core 1.28.0 → 1.29.1

package/dist/core/utils/bundle-matching.utils.d.ts

@@ -55,7 +55,7 @@ export interface CompiledBundleInfo {
  * 3. If page matches any `exclude` pattern: bundle is excluded (exclude takes precedence)
  * 4. Bundle order from config is preserved
  *
- * @param pageOutputPath - The page's output URL path (e.g., '/docs/api/hooks.html')
+ * @param pageUrl - The page URL (e.g., '/docs/api/hooks'), not its output file
  * @param bundles - Array of bundle configurations to filter
  * @returns Array of bundles that match this page, in config order
  *
@@ -67,22 +67,22 @@ export interface CompiledBundleInfo {
  *   { entryPoint: 'playground.ts', bundleName: 'playground', include: ['/examples/**'], exclude: ['/examples/simple/**'] }
  * ];
  *
- * matchBundlesForPage('/docs/api/hooks.html', bundles);
+ * matchBundlesForPage('/docs/api/hooks', bundles);
  * // Returns: [{ entryPoint: 'core.ts', ... }, { entryPoint: 'docs.ts', ... }]
  *
- * matchBundlesForPage('/examples/advanced/demo.html', bundles);
+ * matchBundlesForPage('/examples/advanced/demo', bundles);
  * // Returns: [{ entryPoint: 'core.ts', ... }, { entryPoint: 'playground.ts', ... }]
  *
- * matchBundlesForPage('/examples/simple/basic.html', bundles);
+ * matchBundlesForPage('/examples/simple/basic', bundles);
  * // Returns: [{ entryPoint: 'core.ts', ... }] - playground excluded
  * ```
  */
-export declare function matchBundlesForPage(pageOutputPath: string, bundles: BundleConfig[]): BundleConfig[];
+export declare function matchBundlesForPage(pageUrl: string, bundles: BundleConfig[]): BundleConfig[];
 /**
  * Gets bundle paths for a page from compiled bundle info.
  * Filters compiled bundles based on page matching and returns only the paths.
  *
- * @param pageOutputPath - The page's output URL path (e.g., '/docs/api/hooks.html')
+ * @param pageUrl - The page URL (e.g., '/docs/api/hooks'), not its output file
  * @param compiledBundles - Array of compiled bundle info
  * @returns Array of bundle paths matched for this page, in config order
  *
@@ -93,9 +93,9 @@ export declare function matchBundlesForPage(pageOutputPath: string, bundles: Bun
  *   { config: { entryPoint: 'docs.ts', bundleName: 'docs', include: ['/docs/**'] }, filename: 'docs-def.js', path: '/_assets/docs-def.js' }
  * ];
  *
- * getBundlePathsForPage('/docs/api/hooks.html', compiled);
+ * getBundlePathsForPage('/docs/api/hooks', compiled);
  * // Returns: ['/_assets/core-abc.js', '/_assets/docs-def.js']
  * ```
  */
-export declare function getBundlePathsForPage(pageOutputPath: string, compiledBundles: CompiledBundleInfo[]): string[];
+export declare function getBundlePathsForPage(pageUrl: string, compiledBundles: CompiledBundleInfo[]): string[];
 //# sourceMappingURL=bundle-matching.utils.d.ts.map

package/dist/core/utils/bundle-matching.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bundle-matching.utils.d.ts","sourceRoot":"","sources":["../../../src/core/utils/bundle-matching.utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,UAAU,EAAE,MAAM,EAAE;CAOjC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI,CAqBvE;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,MAAM,EAAE,YAAY,CAAC;IACrB,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,YAAY,EAAE,GACtB,YAAY,EAAE,CAyBhB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,kBAAkB,EAAE,GACpC,MAAM,EAAE,CAaV"}
+{"version":3,"file":"bundle-matching.utils.d.ts","sourceRoot":"","sources":["../../../src/core/utils/bundle-matching.utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;gBACrC,UAAU,EAAE,MAAM,EAAE;CAOjC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI,CAqBvE;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,MAAM,EAAE,YAAY,CAAC;IACrB,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAyB5F;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,kBAAkB,EAAE,GACpC,MAAM,EAAE,CAaV"}

package/dist/core/utils/bundle-matching.utils.js

@@ -64,7 +64,7 @@ export function validateUniqueBundleNames(bundles) {
  * 3. If page matches any `exclude` pattern: bundle is excluded (exclude takes precedence)
  * 4. Bundle order from config is preserved
  *
- * @param pageOutputPath - The page's output URL path (e.g., '/docs/api/hooks.html')
+ * @param pageUrl - The page URL (e.g., '/docs/api/hooks'), not its output file
  * @param bundles - Array of bundle configurations to filter
  * @returns Array of bundles that match this page, in config order
  *
@@ -76,22 +76,22 @@ export function validateUniqueBundleNames(bundles) {
  *   { entryPoint: 'playground.ts', bundleName: 'playground', include: ['/examples/**'], exclude: ['/examples/simple/**'] }
  * ];
  *
- * matchBundlesForPage('/docs/api/hooks.html', bundles);
+ * matchBundlesForPage('/docs/api/hooks', bundles);
  * // Returns: [{ entryPoint: 'core.ts', ... }, { entryPoint: 'docs.ts', ... }]
  *
- * matchBundlesForPage('/examples/advanced/demo.html', bundles);
+ * matchBundlesForPage('/examples/advanced/demo', bundles);
  * // Returns: [{ entryPoint: 'core.ts', ... }, { entryPoint: 'playground.ts', ... }]
  *
- * matchBundlesForPage('/examples/simple/basic.html', bundles);
+ * matchBundlesForPage('/examples/simple/basic', bundles);
  * // Returns: [{ entryPoint: 'core.ts', ... }] - playground excluded
  * ```
  */
-export function matchBundlesForPage(pageOutputPath, bundles) {
+export function matchBundlesForPage(pageUrl, bundles) {
     if (!bundles || bundles.length === 0) {
         return [];
     }
     // Normalize path to use forward slashes
-    const normalizedPath = pageOutputPath.replace(/\\/g, '/');
+    const normalizedPath = pageUrl.replace(/\\/g, '/');
     return bundles.filter((bundle) => {
         // Check exclude patterns first (they take precedence)
         if (bundle.exclude && bundle.exclude.length > 0) {
@@ -112,7 +112,7 @@ export function matchBundlesForPage(pageOutputPath, bundles) {
  * Gets bundle paths for a page from compiled bundle info.
  * Filters compiled bundles based on page matching and returns only the paths.
  *
- * @param pageOutputPath - The page's output URL path (e.g., '/docs/api/hooks.html')
+ * @param pageUrl - The page URL (e.g., '/docs/api/hooks'), not its output file
  * @param compiledBundles - Array of compiled bundle info
  * @returns Array of bundle paths matched for this page, in config order
  *
@@ -123,15 +123,15 @@ export function matchBundlesForPage(pageOutputPath, bundles) {
  *   { config: { entryPoint: 'docs.ts', bundleName: 'docs', include: ['/docs/**'] }, filename: 'docs-def.js', path: '/_assets/docs-def.js' }
  * ];
  *
- * getBundlePathsForPage('/docs/api/hooks.html', compiled);
+ * getBundlePathsForPage('/docs/api/hooks', compiled);
  * // Returns: ['/_assets/core-abc.js', '/_assets/docs-def.js']
  * ```
  */
-export function getBundlePathsForPage(pageOutputPath, compiledBundles) {
+export function getBundlePathsForPage(pageUrl, compiledBundles) {
     if (!compiledBundles || compiledBundles.length === 0) {
         return [];
     }
-    const matchedConfigs = matchBundlesForPage(pageOutputPath, compiledBundles.map((b) => b.config));
+    const matchedConfigs = matchBundlesForPage(pageUrl, compiledBundles.map((b) => b.config));
     // Map matched configs back to their paths, preserving order
     const matchedNames = new Set(matchedConfigs.map((c) => c.bundleName));
     return compiledBundles.filter((b) => matchedNames.has(b.config.bundleName)).map((b) => b.path);

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

@@ -24,6 +24,14 @@ export declare function remove(path: string): Promise<void>;
  * Gets file stats with consistent error handling.
  */
 export declare function stat(filePath: string): Promise<fse.Stats>;
+/**
+ * Gets file stats without following a symbolic link at the path, with consistent error handling.
+ */
+export declare function lstat(filePath: string): Promise<fse.Stats>;
+/**
+ * Resolves a path to its real location, following symbolic links, with consistent error handling.
+ */
+export declare function realpath(filePath: string): Promise<string>;
 /**
  * Reads directory contents with consistent error handling.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"fs.utils.d.ts","sourceRoot":"","sources":["../../../src/core/utils/fs.utils.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,UAAU,CAAC;AAE3B,OAAO,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAmDvD;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,OAAO,GAAG,MAAgB,GACnC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAExB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEnE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAExD;AAED;;GAEG;AACH,wBAAsB,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAE/D;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,CAAC,SAAS,OAAO,GAAG,KAAK,EACrD,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,CAAC,CAAA;CAAE,GAC9B,OAAO,CAAC,CAAC,SAAS,IAAI,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAcnD;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAE7E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUlE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAU7D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAchE"}
+{"version":3,"file":"fs.utils.d.ts","sourceRoot":"","sources":["../../../src/core/utils/fs.utils.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,UAAU,CAAC;AAE3B,OAAO,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAqDvD;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,OAAO,GAAG,MAAgB,GACnC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAExB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEnE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAExD;AAED;;GAEG;AACH,wBAAsB,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAE/D;AAED;;GAEG;AACH,wBAAsB,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAEhE;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEhE;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,CAAC,SAAS,OAAO,GAAG,KAAK,EACrD,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,aAAa,CAAC,EAAE,CAAC,CAAA;CAAE,GAC9B,OAAO,CAAC,CAAC,SAAS,IAAI,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAcnD;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvE;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAE7E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUlE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAU7D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAchE"}

package/dist/core/utils/fs.utils.js

@@ -1,7 +1,7 @@
 import fse from 'fs-extra';
 import { readFileSync, statSync, readdirSync } from 'node:fs';
 import { join, relative } from 'node:path';
-const { readFile: fseReadFile, writeFile: fseWriteFile, pathExists: fsePathExists, ensureDir: fseEnsureDir, remove: fseRemove, stat: fseStat, readdir: fseReaddir, copyFile: fseCopyFile, } = fse;
+const { readFile: fseReadFile, writeFile: fseWriteFile, pathExists: fsePathExists, ensureDir: fseEnsureDir, remove: fseRemove, stat: fseStat, lstat: fseLstat, realpath: fseRealpath, readdir: fseReaddir, copyFile: fseCopyFile, } = fse;
 /**
  * Wraps fs-extra operations with consistent error handling.
  */
@@ -65,6 +65,18 @@ export async function remove(path) {
 export async function stat(filePath) {
     return wrapFsOperation('get stats for', fseStat(filePath), filePath);
 }
+/**
+ * Gets file stats without following a symbolic link at the path, with consistent error handling.
+ */
+export async function lstat(filePath) {
+    return wrapFsOperation('get stats for', fseLstat(filePath), filePath);
+}
+/**
+ * Resolves a path to its real location, following symbolic links, with consistent error handling.
+ */
+export async function realpath(filePath) {
+    return wrapFsOperation('resolve', fseRealpath(filePath), filePath);
+}
 /**
  * Reads directory contents with consistent error handling.
  */

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

@@ -2,9 +2,9 @@
  * Core utilities index
  * @module core/utils
  */
-export { readFile, writeFile, pathExists, ensureDir, remove, copyFile, readdir, stat, readFileBuffer, readFileBufferSync, statSyncOrNull, listFilesRecursiveSync, } from './fs.utils.js';
-export { resolveSrcDir, resolveOutDir, resolveStaticDir, resolveCacheDir, resolveDevPaths, normalizeTemplatePath, resolveSrcPath, resolveOutPath, resolveStaticPath, normalizePathForComparison, isPathWithinDirectory, } from './paths.utils.js';
-export { discoverLayout, isCollectionIndexPage, getCollectionPathForPage, } from './template-discovery.utils.js';
+export { readFile, writeFile, pathExists, ensureDir, remove, copyFile, readdir, stat, lstat, realpath, readFileBuffer, readFileBufferSync, statSyncOrNull, listFilesRecursiveSync, } from './fs.utils.js';
+export { resolveSrcDir, resolveOutDir, resolveStaticDir, resolveCacheDir, resolveDevPaths, normalizeTemplatePath, resolveSrcPath, resolveOutPath, resolveStaticPath, normalizePathForComparison, isPathWithinDirectory, getPageOutputFile, } from './paths.utils.js';
+export { discoverLayout, isCollectionIndexPage, isVirtualPage, getFirstPaginationPage, getCollectionPathForPage, } from './template-discovery.utils.js';
 export { propValue } from './template.utils.js';
 export { slugify } from './slugify.utils.js';
 export { trackTailwindClass, enableInventoryTracking, disableInventoryTracking, clearInventory, getInventory, getInventorySize, isTrackingEnabled, writeTailwindClassInventory, isTailwindUsed, resetTailwindDetection, loadPreviousInventory, } from './tailwind-inventory.utils.js';
@@ -15,7 +15,7 @@ export { makeCallablePartial, wrapPartialsAsCallable } from './callable-partials
 export type { CallablePartial } from './callable-partials.utils.js';
 export { TemplateError, parseEtaError, createTemplateError } from './template-errors.utils.js';
 export { createNavigationHelpers } from './navigation-helpers.utils.js';
-export { resolvePrettyUrl, mergeServerOptions, assertPortAvailable, toPortUnavailableError, PortUnavailableError, } from './server.utils.js';
+export { getMimeType, parseRequestPath, resolveNotFoundPage, resolveRequestFile, resolvePrettyUrl, mergeServerOptions, assertPortAvailable, toPortUnavailableError, PortUnavailableError, } from './server.utils.js';
 export type { PrettyUrlResult, MergedServerOptions, MergeServerOptionsParams, PortUnavailableCode, } from './server.utils.js';
 export { createErrorOverlay, parseErrorDetails } from './error-overlay.utils.js';
 export type { ErrorDetails } from './error-overlay.utils.js';
@@ -24,8 +24,8 @@ export { globToRegex, matchesGlob } from './glob-patterns.utils.js';
 export { matchBundlesForPage, getBundlePathsForPage, validateUniqueBundleNames, DuplicateBundleNameError, } from './bundle-matching.utils.js';
 export type { CompiledBundleInfo } from './bundle-matching.utils.js';
 export { createFallbackLogger } from './logger.utils.js';
-export { compileTypeScript, createTypeScriptWatcher, compileStatiConfig, cleanupCompiledConfig, autoInjectBundles, formatBytes, detectExistingBundles, } from './typescript.utils.js';
-export type { CompileOptions, WatchOptions } from './typescript.utils.js';
+export { compileTypeScript, createTypeScriptWatcher, compileStatiConfig, cleanupCompiledConfig, autoInjectBundles, formatBytes, detectExistingBundles, removeStaleBundleFiles, } from './typescript.utils.js';
+export type { CompileOptions, WatchOptions, RemoveStaleBundlesOptions, } from './typescript.utils.js';
 export { findHeadClosePosition, injectBeforeHeadClose } from './html.utils.js';
 export { getFrontMatterDate, PUBLISHED_DATE_FIELDS } from './date.utils.js';
 export { isEnabledEnvFlag } from './env.utils.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":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/utils/index.ts"],"names":[],"mappings":"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"}

package/dist/core/utils/index.js

@@ -3,11 +3,11 @@
  * @module core/utils
  */
 // File system utilities
-export { readFile, writeFile, pathExists, ensureDir, remove, copyFile, readdir, stat, readFileBuffer, readFileBufferSync, statSyncOrNull, listFilesRecursiveSync, } from './fs.utils.js';
+export { readFile, writeFile, pathExists, ensureDir, remove, copyFile, readdir, stat, lstat, realpath, readFileBuffer, readFileBufferSync, statSyncOrNull, listFilesRecursiveSync, } from './fs.utils.js';
 // Path resolution utilities
-export { resolveSrcDir, resolveOutDir, resolveStaticDir, resolveCacheDir, resolveDevPaths, normalizeTemplatePath, resolveSrcPath, resolveOutPath, resolveStaticPath, normalizePathForComparison, isPathWithinDirectory, } from './paths.utils.js';
+export { resolveSrcDir, resolveOutDir, resolveStaticDir, resolveCacheDir, resolveDevPaths, normalizeTemplatePath, resolveSrcPath, resolveOutPath, resolveStaticPath, normalizePathForComparison, isPathWithinDirectory, getPageOutputFile, } from './paths.utils.js';
 // Template discovery utilities
-export { discoverLayout, isCollectionIndexPage, getCollectionPathForPage, } from './template-discovery.utils.js';
+export { discoverLayout, isCollectionIndexPage, isVirtualPage, getFirstPaginationPage, getCollectionPathForPage, } from './template-discovery.utils.js';
 // Template utilities
 export { propValue } from './template.utils.js';
 // Slugify utilities
@@ -27,7 +27,7 @@ export { TemplateError, parseEtaError, createTemplateError } from './template-er
 // Navigation helper utilities
 export { createNavigationHelpers } from './navigation-helpers.utils.js';
 // Server utilities
-export { resolvePrettyUrl, mergeServerOptions, assertPortAvailable, toPortUnavailableError, PortUnavailableError, } from './server.utils.js';
+export { getMimeType, parseRequestPath, resolveNotFoundPage, resolveRequestFile, resolvePrettyUrl, mergeServerOptions, assertPortAvailable, toPortUnavailableError, PortUnavailableError, } from './server.utils.js';
 // Error overlay utilities
 export { createErrorOverlay, parseErrorDetails } from './error-overlay.utils.js';
 // Version utilities
@@ -39,7 +39,7 @@ export { matchBundlesForPage, getBundlePathsForPage, validateUniqueBundleNames,
 // Logger utilities
 export { createFallbackLogger } from './logger.utils.js';
 // TypeScript compilation utilities
-export { compileTypeScript, createTypeScriptWatcher, compileStatiConfig, cleanupCompiledConfig, autoInjectBundles, formatBytes, detectExistingBundles, } from './typescript.utils.js';
+export { compileTypeScript, createTypeScriptWatcher, compileStatiConfig, cleanupCompiledConfig, autoInjectBundles, formatBytes, detectExistingBundles, removeStaleBundleFiles, } from './typescript.utils.js';
 // HTML manipulation utilities
 export { findHeadClosePosition, injectBeforeHeadClose } from './html.utils.js';
 // Date utilities

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

@@ -131,4 +131,19 @@ export declare function normalizePathForComparison(filePath: string, basePath?:
  * ```
  */
 export declare function isPathWithinDirectory(baseDir: string, targetPath: string): boolean;
+/**
+ * The file a page URL is written to, relative to the output directory. The build joins it to
+ * the output directory, which also normalizes separators and `.` segments.
+ *
+ * @param url - The page URL
+ * @returns The output file
+ *
+ * @example
+ * ```typescript
+ * getPageOutputFile('/');          // 'index.html'
+ * getPageOutputFile('/blog/');     // '/blog/index.html'
+ * getPageOutputFile('/blog/post'); // '/blog/post.html'
+ * ```
+ */
+export declare function getPageOutputFile(url: string): string;
 //# sourceMappingURL=paths.utils.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"paths.utils.d.ts","sourceRoot":"","sources":["../../../src/core/utils/paths.utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAQxD;;;GAGG;AAEH;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAE5D;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW;;;;EAMlD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAEhF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAEhF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAEnF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CA6BtF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAYlF"}
+{"version":3,"file":"paths.utils.d.ts","sourceRoot":"","sources":["../../../src/core/utils/paths.utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAQxD;;;GAGG;AAEH;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAE5D;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW;;;;EAMlD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAEhF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAEhF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAEnF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CA6BtF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAYlF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKrD"}

package/dist/core/utils/paths.utils.js

@@ -183,3 +183,23 @@ export function isPathWithinDirectory(baseDir, targetPath) {
     // We also allow exact match (resolvedTarget === resolvedBase) for the root
     return resolvedTarget === resolvedBase || resolvedTarget.startsWith(normalizedBase);
 }
+/**
+ * The file a page URL is written to, relative to the output directory. The build joins it to
+ * the output directory, which also normalizes separators and `.` segments.
+ *
+ * @param url - The page URL
+ * @returns The output file
+ *
+ * @example
+ * ```typescript
+ * getPageOutputFile('/');          // 'index.html'
+ * getPageOutputFile('/blog/');     // '/blog/index.html'
+ * getPageOutputFile('/blog/post'); // '/blog/post.html'
+ * ```
+ */
+export function getPageOutputFile(url) {
+    if (url === '/') {
+        return 'index.html';
+    }
+    return url.endsWith('/') ? `${url}index.html` : `${url}.html`;
+}

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

@@ -1,3 +1,26 @@
+/**
+ * Gets the content type for a file from its extension.
+ *
+ * @param filePath - Path or file name of the file being served
+ * @returns The content type, or `application/octet-stream` for unknown extensions
+ */
+export declare function getMimeType(filePath: string): string;
+/**
+ * Turns a request URL into the path of the file it asks for: the query string is dropped and
+ * percent-escapes are decoded, so `/about?ref=x` asks for `/about` and `/my%20file.pdf` for
+ * `/my file.pdf`.
+ *
+ * @param url - The request URL as received (`req.url`)
+ * @returns The decoded path, or null when the URL is malformed (a bad escape or a NUL byte)
+ */
+export declare function parseRequestPath(url: string | undefined): string | null;
+/**
+ * Finds the site's custom not-found page, the one static hosts serve for a missing URL.
+ *
+ * @param outDir - The output directory being served
+ * @returns The path of `404.html` (or `404/index.html` for a `/404/` permalink), or null
+ */
+export declare function resolveNotFoundPage(outDir: string): Promise<string | null>;
 /**
  * Error codes for which a port is considered unavailable
  */
@@ -42,6 +65,17 @@ export interface PrettyUrlResult {
     /** Whether the path was found */
     found: boolean;
 }
+/**
+ * Resolves a request path to the file it names inside the served directory. This is where a
+ * request path becomes a file system path: every file the servers read is this path or
+ * derived from it, so no request reaches outside the directory, whether through `..`
+ * segments (raw or percent-encoded), backslashes or an absolute path.
+ *
+ * @param outDir - The directory being served
+ * @param requestPath - The decoded request path, from {@link parseRequestPath}
+ * @returns The absolute path, or null when it points outside the directory
+ */
+export declare function resolveRequestFile(outDir: string, requestPath: string): string | null;
 /**
  * Attempts to resolve pretty URL paths by trying various fallback strategies.
  * This handles common patterns like:
@@ -50,11 +84,12 @@ export interface PrettyUrlResult {
  * - /path -> /path.html (when original path is not found and has no extension)
  *
  * @param outDir The output directory to serve files from
- * @param requestPath The requested URL path
- * @param originalFilePath The original file path that was attempted
+ * @param requestPath The requested URL path, which decides the fallbacks
+ * @param requestFile The file the request names, from {@link resolveRequestFile}. Every
+ *   candidate is derived from it, so none is outside the output directory
  * @returns Promise resolving to the file path to serve or null if not found
  */
-export declare function resolvePrettyUrl(outDir: string, requestPath: string, originalFilePath: string): Promise<PrettyUrlResult>;
+export declare function resolvePrettyUrl(outDir: string, requestPath: string, requestFile: string): Promise<PrettyUrlResult>;
 /**
  * Options for merging server configuration
  */

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

@@ -1 +1 @@
-{"version":3,"file":"server.utils.d.ts","sourceRoot":"","sources":["../../../src/core/utils/server.utils.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,YAAY,GAAG,QAAQ,CAAC;AAE1D;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;gBAEvB,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,SAAS,CAAC,EAAE,MAAM;CAatF;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAMT;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAcjG;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,iCAAiC;IACjC,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,eAAe,CAAC,CA2D1B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB,CAAC,CAAC;IACzC,sCAAsC;IACtC,OAAO,EAAE,CAAC,CAAC;IACX,4CAA4C;IAC5C,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;IACrE,4EAA4E;IAC5E,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,OAAO,CAAC;KACf,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,EAC3F,MAAM,EAAE,wBAAwB,CAAC,CAAC,CAAC,GAClC,mBAAmB,CAQrB"}
+{"version":3,"file":"server.utils.d.ts","sourceRoot":"","sources":["../../../src/core/utils/server.utils.ts"],"names":[],"mappings":"AAsCA;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAQvE;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWhF;AAED;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,YAAY,GAAG,QAAQ,CAAC;AAE1D;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;gBAEvB,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,SAAS,CAAC,EAAE,MAAM;CAatF;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAMT;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAcjG;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,iCAAiC;IACjC,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWrF;AAkBD;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,eAAe,CAAC,CA8B1B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB,CAAC,CAAC;IACzC,sCAAsC;IACtC,OAAO,EAAE,CAAC,CAAC;IACX,4CAA4C;IAC5C,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;IACrE,4EAA4E;IAC5E,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,OAAO,CAAC;KACf,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,EAC3F,MAAM,EAAE,wBAAwB,CAAC,CAAC,CAAC,GAClC,mBAAmB,CAQrB"}

package/dist/core/utils/server.utils.js

@@ -1,6 +1,85 @@
-import { join } from 'node:path';
+import { extname, join, resolve, sep } from 'node:path';
 import { stat } from 'node:fs/promises';
 import { createServer } from 'node:net';
+/**
+ * Content types the dev and preview servers send, by file extension. Covers the files Stati
+ * generates (pages, bundles, search index, sitemap, robots.txt, feeds, responsive images) and
+ * common static assets; anything else is sent as `application/octet-stream`.
+ */
+const MIME_TYPES = {
+    '.html': 'text/html',
+    '.js': 'application/javascript',
+    '.mjs': 'application/javascript',
+    '.css': 'text/css',
+    '.json': 'application/json',
+    '.map': 'application/json',
+    '.webmanifest': 'application/manifest+json',
+    '.xml': 'application/xml',
+    '.txt': 'text/plain',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.svg': 'image/svg+xml',
+    '.ico': 'image/x-icon',
+    '.webp': 'image/webp',
+    '.avif': 'image/avif',
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+    '.ttf': 'font/ttf',
+    '.otf': 'font/otf',
+    '.eot': 'application/vnd.ms-fontobject',
+    '.pdf': 'application/pdf',
+    '.mp4': 'video/mp4',
+    '.webm': 'video/webm',
+    '.wasm': 'application/wasm',
+};
+/**
+ * Gets the content type for a file from its extension.
+ *
+ * @param filePath - Path or file name of the file being served
+ * @returns The content type, or `application/octet-stream` for unknown extensions
+ */
+export function getMimeType(filePath) {
+    return MIME_TYPES[extname(filePath).toLowerCase()] ?? 'application/octet-stream';
+}
+/**
+ * Turns a request URL into the path of the file it asks for: the query string is dropped and
+ * percent-escapes are decoded, so `/about?ref=x` asks for `/about` and `/my%20file.pdf` for
+ * `/my file.pdf`.
+ *
+ * @param url - The request URL as received (`req.url`)
+ * @returns The decoded path, or null when the URL is malformed (a bad escape or a NUL byte)
+ */
+export function parseRequestPath(url) {
+    const rawPath = (url || '/').split(/[?#]/, 1)[0] || '/';
+    try {
+        const path = decodeURIComponent(rawPath);
+        return path.includes('\0') ? null : path;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Finds the site's custom not-found page, the one static hosts serve for a missing URL.
+ *
+ * @param outDir - The output directory being served
+ * @returns The path of `404.html` (or `404/index.html` for a `/404/` permalink), or null
+ */
+export async function resolveNotFoundPage(outDir) {
+    for (const candidate of [join(outDir, '404.html'), join(outDir, '404', 'index.html')]) {
+        try {
+            if ((await stat(candidate)).isFile()) {
+                return candidate;
+            }
+        }
+        catch {
+            // Not there; try the next one
+        }
+    }
+    return null;
+}
 /**
  * Thrown when a server cannot bind to its configured port.
  * The message is user-facing and explains how to pick a different port.
@@ -59,6 +138,44 @@ export function assertPortAvailable(port, host, configKey) {
         probe.listen(port, host);
     });
 }
+/**
+ * Resolves a request path to the file it names inside the served directory. This is where a
+ * request path becomes a file system path: every file the servers read is this path or
+ * derived from it, so no request reaches outside the directory, whether through `..`
+ * segments (raw or percent-encoded), backslashes or an absolute path.
+ *
+ * @param outDir - The directory being served
+ * @param requestPath - The decoded request path, from {@link parseRequestPath}
+ * @returns The absolute path, or null when it points outside the directory
+ */
+export function resolveRequestFile(outDir, requestPath) {
+    const root = resolve(outDir);
+    const filePath = resolve(root, requestPath.replace(/^[/\\]+/, ''));
+    if (filePath === root) {
+        return root;
+    }
+    const rootPrefix = root.endsWith(sep) ? root : root + sep;
+    if (!filePath.startsWith(rootPrefix)) {
+        return null;
+    }
+    return filePath;
+}
+/**
+ * The result for a candidate file: found when it exists and is a file.
+ */
+async function fileResult(candidate) {
+    if (candidate !== null) {
+        try {
+            if ((await stat(candidate)).isFile()) {
+                return { filePath: candidate, found: true };
+            }
+        }
+        catch {
+            // Not there
+        }
+    }
+    return { filePath: null, found: false };
+}
 /**
  * Attempts to resolve pretty URL paths by trying various fallback strategies.
  * This handles common patterns like:
@@ -67,16 +184,20 @@ export function assertPortAvailable(port, host, configKey) {
  * - /path -> /path.html (when original path is not found and has no extension)
  *
  * @param outDir The output directory to serve files from
- * @param requestPath The requested URL path
- * @param originalFilePath The original file path that was attempted
+ * @param requestPath The requested URL path, which decides the fallbacks
+ * @param requestFile The file the request names, from {@link resolveRequestFile}. Every
+ *   candidate is derived from it, so none is outside the output directory
  * @returns Promise resolving to the file path to serve or null if not found
  */
-export async function resolvePrettyUrl(outDir, requestPath, originalFilePath) {
+export async function resolvePrettyUrl(outDir, requestPath, requestFile) {
+    // The sibling .html file: /blog/ and /blog are served from blog.html. The output
+    // directory itself has none, as its sibling is outside it.
+    const htmlFile = requestFile === resolve(outDir) ? null : `${requestFile}.html`;
     try {
-        const stats = await stat(originalFilePath);
+        const stats = await stat(requestFile);
         if (stats.isDirectory()) {
             // Try to serve index.html from directory
-            const indexPath = join(originalFilePath, 'index.html');
+            const indexPath = join(requestFile, 'index.html');
             try {
                 await stat(indexPath);
                 return { filePath: indexPath, found: true };
@@ -84,50 +205,17 @@ export async function resolvePrettyUrl(outDir, requestPath, originalFilePath) {
             catch {
                 // If no index.html in directory, try to serve corresponding .html file
                 // For example: /examples/ -> examples.html
-                const directoryName = requestPath.replace(/\/$/, ''); // Remove trailing slash
-                const fallbackPath = join(outDir, `${directoryName}.html`);
-                try {
-                    await stat(fallbackPath);
-                    return { filePath: fallbackPath, found: true };
-                }
-                catch {
-                    return { filePath: null, found: false };
-                }
+                return await fileResult(htmlFile);
             }
         }
         // File exists and is not a directory
-        return { filePath: originalFilePath, found: true };
+        return { filePath: requestFile, found: true };
     }
     catch {
-        // File not found, try fallback strategies for pretty URLs
-        if (requestPath.endsWith('/')) {
-            // For requests ending with /, try the corresponding .html file
-            const pathWithoutSlash = requestPath.slice(0, -1);
-            const htmlPath = join(outDir, `${pathWithoutSlash}.html`);
-            try {
-                const stats = await stat(htmlPath);
-                if (stats.isFile()) {
-                    return { filePath: htmlPath, found: true };
-                }
-            }
-            catch {
-                // Continue to not found
-            }
-        }
-        else if (!requestPath.includes('.')) {
-            // For requests without trailing slash and without extension, try .html
-            const htmlPath = join(outDir, `${requestPath}.html`);
-            try {
-                const stats = await stat(htmlPath);
-                if (stats.isFile()) {
-                    return { filePath: htmlPath, found: true };
-                }
-            }
-            catch {
-                // Continue to not found
-            }
+        // File not found: try the .html file for /path/ and for /path without an extension
+        if (requestPath.endsWith('/') || !requestPath.includes('.')) {
+            return await fileResult(htmlFile);
         }
-        // No fallback worked
         return { filePath: null, found: false };
     }
 }

package/dist/core/utils/template-discovery.utils.d.ts

@@ -1,13 +1,37 @@
 import type { StatiConfig, PageModel } from '../../types/index.js';
+/**
+ * Shared template discovery utilities.
+ * Extracted from templates.ts and isg/deps.ts to eliminate duplication.
+ */
+/**
+ * Whether a page was created by Stati rather than loaded from a Markdown file: a page expanded
+ * from a `[param].md` template, or page 2 or later of a paginated listing.
+ *
+ * Virtual pages are never collection members, never make a folder a collection, and are left
+ * out of navigation, search and RSS unless they opt in.
+ *
+ * @param page - The page to check
+ * @returns True for generated pages and for pagination pages after the first
+ */
+export declare function isVirtualPage(page: PageModel): boolean;
+/**
+ * Finds the first page of a paginated listing, which later pages render like.
+ *
+ * @param page - A page with `pagination`
+ * @param allPages - All pages in the site
+ * @returns The listing's first page, or undefined when it is not in the list
+ */
+export declare function getFirstPaginationPage(page: PageModel, allPages: PageModel[]): PageModel | undefined;
 /**
  * Determines if the given page is a collection index page.
  * A collection index page is one whose URL matches a directory path that contains other pages.
+ * Generated pages never are; pagination pages after the first are when their first page is.
  *
  * Rendering and ISG dependency tracking must both call this with the same page list,
  * otherwise they can pick different layouts for the same page.
  *
  * Page URLs are read once per `allPages` array, at the first call; see
- * `directoryPrefixCache` for when changes to the pages are picked up.
+ * `pageListCache` for when changes to the pages are picked up.
  *
  * @param page - The page to check
  * @param allPages - All pages in the site (treated as unchanging after the first call)