@stati/core 1.29.0 → 1.29.1

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

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/core/build.ts"],"names":[],"mappings":"AAuEA,OAAO,KAAK,EAEV,UAAU,EACV,MAAM,EASP,MAAM,mBAAmB,CAAC;AAK3B,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,uCAAuC;IACvC,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,8BAA8B;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,iCAAiC;IACjC,OAAO,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACrC,uEAAuE;IACvE,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,sGAAsG;IACtG,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,mFAAmF;IACnF,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC7C,wDAAwD;IACxD,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAkGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAsB5E"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/core/build.ts"],"names":[],"mappings":"AAyEA,OAAO,KAAK,EAEV,UAAU,EACV,MAAM,EAQP,MAAM,mBAAmB,CAAC;AAK3B,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,uCAAuC;IACvC,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,8BAA8B;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,iCAAiC;IACjC,OAAO,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACrC,uEAAuE;IACvE,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,sGAAsG;IACtG,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,mFAAmF;IACnF,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC7C,wDAAwD;IACxD,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAkGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAsB5E"}

package/dist/core/build.js

@@ -1,4 +1,4 @@
-import { ensureDir, writeFile, remove, pathExists, stat, readdir, copyFile, resolveOutDir, resolveStaticDir, resolveCacheDir, enableInventoryTracking, disableInventoryTracking, clearInventory, writeTailwindClassInventory, getInventorySize, isTailwindUsed, loadPreviousInventory, compileTypeScript, detectExistingBundles, autoInjectBundles, getBundlePathsForPage, formatBytes, isVirtualPage, getPageOutputFile, } from './utils/index.js';
+import { ensureDir, writeFile, remove, pathExists, stat, readdir, copyFile, resolveOutDir, resolveStaticDir, resolveCacheDir, enableInventoryTracking, disableInventoryTracking, clearInventory, writeTailwindClassInventory, getInventorySize, isTailwindUsed, loadPreviousInventory, compileTypeScript, detectExistingBundles, removeStaleBundleFiles, autoInjectBundles, getBundlePathsForPage, formatBytes, isVirtualPage, getPageOutputFile, } from './utils/index.js';
 import { join, dirname, relative, posix } from 'node:path';
 import { performance } from 'node:perf_hooks';
 import { loadConfig } from '../config/loader.js';
@@ -11,7 +11,7 @@ import { buildNavigation } from './navigation.js';
 import { loadCacheManifest, saveCacheManifest, shouldRebuildPage, createCacheEntry, updateCacheEntry, hasRecordedReads, pruneOrphanedPages, withBuildLock, computeNavigationHash, computeContentHash, clearFileHashCache, clearTemplatePathCache, } from './isg/index.js';
 import { generateSitemap, generateRobotsTxtFromConfig, autoInjectSEO, } from '../seo/index.js';
 import { generateRSSFeeds, validateRSSConfig } from '../rss/index.js';
-import { computeSearchIndexFilename, generateSearchIndex, writeSearchIndex, autoInjectSearchMeta, isGeneratedPageExcludedFromSearch, } from '../search/index.js';
+import { computeSearchIndexFilename, generateSearchIndex, writeSearchIndex, removeStaleSearchIndexes, autoInjectSearchMeta, isGeneratedPageExcludedFromSearch, } from '../search/index.js';
 import { getEnv, isDevelopment } from '../env.js';
 import { DEFAULT_OUT_DIR } from '../constants.js';
 import { ImageRuntime } from '../images/runtime.js';
@@ -212,6 +212,58 @@ async function loadContentAndBuildNavigation(config, options, logger) {
     const eta = createTemplateEngine(config);
     return { pages, markdownFiles: loaded.length, navigation, md, eta, navigationHash };
 }
+/**
+ * Generates the search index from the page models and writes it before any page renders,
+ * returning the file name pages link to. Every page links to the index, and the name is part
+ * of each page's cache hash, so a production build names a hashed file after the index
+ * content: a build that leaves the indexed text alone keeps the name and its cached pages.
+ * Development keeps one name, so a content edit does not re-render every page. Writing the
+ * index first means it is not held in memory while the pages render.
+ *
+ * @returns The index file name, or undefined when search is disabled
+ */
+async function writeSearchIndexBeforeRendering(pages, config, md, outDir, logger, recorder) {
+    if (config.search?.enabled !== true) {
+        return undefined;
+    }
+    const isDevMode = isDevelopment();
+    const endSearchIndexSpan = recorder.startSpan('searchIndexGenerationMs');
+    // TOC entries and markdown content, the same data a render produces, without rendering.
+    // Sorted by URL: content discovery returns files in a different order on each run, which
+    // would change the index content, and with it the name, on every build.
+    const tocEnabled = config.markdown?.toc !== false;
+    const byUrl = (a, b) => a.url.localeCompare(b.url) || a.sourcePath.localeCompare(b.sourcePath);
+    const searchablePages = pages
+        .filter((page) => !isGeneratedPageExcludedFromSearch(page))
+        .sort(byUrl)
+        .map((page) => ({
+        page,
+        toc: tocEnabled ? extractToc(page.content, md) : [],
+        markdownContent: page.content,
+    }));
+    const index = generateSearchIndex(searchablePages, config.search);
+    // A production hash covers the documents and schema version, not generatedAt, which
+    // changes on every build; serializing them is skipped when the name has no hash
+    const hashInput = isDevMode
+        ? 'dev'
+        : config.search.hashFilename !== false
+            ? JSON.stringify({ version: index.version, documents: index.documents })
+            : undefined;
+    const filename = computeSearchIndexFilename(config.search, hashInput);
+    endSearchIndexSpan();
+    // Pages still link to the name when nothing is searchable, but no file is written
+    if (searchablePages.length === 0) {
+        return filename;
+    }
+    logger.info('');
+    logger.info(`Generating search index to ${filename}`);
+    const writeStart = performance.now();
+    // In dev mode, skip write if content hasn't changed (template-only changes)
+    const metadata = await writeSearchIndex(index, outDir, filename, isDevMode);
+    recorder.recordPhase('searchIndexWriteMs', performance.now() - writeStart);
+    logger.success(`Generated search index with ${metadata.documentCount} documents`);
+    return filename;
+}
 /**
  * Output file and ISG cache key of a page.
  */
@@ -238,10 +290,9 @@ function hashableData(value) {
 /**
  * Processes pages with ISG caching logic.
  */
-async function processPagesWithCache(pages, manifest, config, outDir, md, eta, navigation, buildTime, options, logger, compiledBundles, recorder = noopMetricRecorder, searchIndexFilename, imageRuntime = null, navigationHash = computeNavigationHash(navigation)) {
+async function processPagesWithCache(pages, manifest, config, outDir, md, eta, navigation, buildTime, options, logger, compiledBundles, recorder = noopMetricRecorder, imageRuntime = null, navigationHash = computeNavigationHash(navigation)) {
     let cacheHits = 0;
     let cacheMisses = 0;
-    const searchablePages = [];
     // Build context
     const buildContext = { config, pages };
     // Run beforeAll hook
@@ -252,6 +303,8 @@ async function processPagesWithCache(pages, manifest, config, outDir, md, eta, n
     }
     // Collection summaries, hashed after beforeAll because the hook can change front matter
     const summaries = createSummaryHasher(pages, resolveSummaryFields(config));
+    // Generated after beforeAll for the same reason; pages render with its file name
+    const searchIndexFilename = await writeSearchIndexBeforeRendering(pages, config, md, outDir, logger, recorder);
     // The pages of a listing share one array of page URLs, hashed once for all of them
     const urlListHashes = new WeakMap();
     const hashUrlList = (urls) => {
@@ -360,13 +413,6 @@ async function processPagesWithCache(pages, manifest, config, outDir, md, eta, n
             }
             // Record page timing for cached pages (0ms render time)
             recorder.recordPageTiming(page.url, 0, true);
-            // Collect searchable page data for cached pages if search is enabled
-            // Extract TOC without full HTML rendering for efficiency
-            if (config.search?.enabled === true && !isGeneratedPageExcludedFromSearch(page)) {
-                const tocEnabled = config.markdown?.toc !== false;
-                const toc = tocEnabled ? extractToc(page.content, md) : [];
-                searchablePages.push({ page, toc, markdownContent: page.content });
-            }
             continue;
         }
         // Cache miss - need to rebuild
@@ -465,11 +511,6 @@ async function processPagesWithCache(pages, manifest, config, outDir, md, eta, n
                 totalCacheEntryTime += performance.now() - cacheEntryStart;
             }
         }
-        // Collect searchable page data if search is enabled
-        // Uses TOC entries and markdown content instead of parsing rendered HTML
-        if (config.search?.enabled === true && !isGeneratedPageExcludedFromSearch(page)) {
-            searchablePages.push({ page, toc, markdownContent: page.content });
-        }
         // Run afterRender hook
         if (config.hooks?.afterRender) {
             const hookStart = performance.now();
@@ -515,7 +556,7 @@ async function processPagesWithCache(pages, manifest, config, outDir, md, eta, n
             logger.showRenderingSummary();
         }
     }
-    return { cacheHits, cacheMisses, searchablePages };
+    return { cacheHits, cacheMisses, searchIndexFilename };
 }
 /**
  * Copies static assets and returns the count.
@@ -687,22 +728,15 @@ async function buildInternal(options = {}) {
         });
         endTsSpan();
     }
-    // Pre-compute search index filename if search is enabled
-    // In dev mode, use a stable filename to simlplify testing and debugging
-    let searchIndexFilename;
-    if (config.search?.enabled) {
-        const buildId = isDevMode ? 'dev' : buildStartTime.toString();
-        searchIndexFilename = computeSearchIndexFilename(config.search, buildId);
-    }
     // Process pages with ISG caching logic
     if (logger.step) {
         console.log(); // Add spacing before page processing
     }
     const endPageRenderSpan = recorder.startSpan('pageRenderingMs');
     const buildTime = new Date();
-    const pageProcessingResult = await processPagesWithCache(pages, manifest, config, outDir, md, eta, navigation, buildTime, options, logger, compiledBundles, recorder, searchIndexFilename, imageRuntime, navigationHash);
+    const pageProcessingResult = await processPagesWithCache(pages, manifest, config, outDir, md, eta, navigation, buildTime, options, logger, compiledBundles, recorder, imageRuntime, navigationHash);
     endPageRenderSpan();
-    const { cacheHits, cacheMisses, searchablePages } = pageProcessingResult;
+    const { cacheHits, cacheMisses, searchIndexFilename } = pageProcessingResult;
     // Remove the output of pages that no longer exist, such as a deleted post or a tag no post
     // uses anymore. Runs before static assets are copied, so a file in the static directory at
     // the same path is copied afterwards.
@@ -734,23 +768,6 @@ async function buildInternal(options = {}) {
             logger.info(`Images: ${generated} generated, ${cached} reused${failed > 0 ? `, ${failed} failed` : ''}`);
         }
     }
-    // Generate search index if enabled
-    // Uses markdown content and TOC entries
-    let searchIndexMetadata;
-    if (config.search?.enabled && searchablePages.length > 0 && searchIndexFilename) {
-        logger.info('');
-        logger.info(`Generating search index to ${searchIndexFilename}`);
-        const endSearchIndexSpan = recorder.startSpan('searchIndexGenerationMs');
-        const searchIndex = generateSearchIndex(searchablePages, config.search);
-        endSearchIndexSpan();
-        const writeStart = performance.now();
-        // In dev mode, skip write if content hasn't changed (template-only changes)
-        const skipIfUnchanged = isDevMode;
-        searchIndexMetadata = await writeSearchIndex(searchIndex, outDir, searchIndexFilename, skipIfUnchanged);
-        const writeTime = performance.now() - writeStart;
-        recorder.recordPhase('searchIndexWriteMs', writeTime);
-        logger.success(`Generated search index with ${searchIndexMetadata.documentCount} documents`);
-    }
     // Record page rendering counts
     recorder.increment('renderedPages', cacheMisses);
     recorder.increment('cachedPages', cacheHits);
@@ -783,6 +800,22 @@ async function buildInternal(options = {}) {
             .map((failure) => `Open Graph image failed for ${failure.label}: ${failure.message}`)
             .join('\n'));
     }
+    // Delete the bundles and search indexes earlier builds wrote under other names, now that
+    // every page links to this build's files. Before the static copy, so a file in the static
+    // directory with such a name is copied afterwards.
+    if (!isDevMode) {
+        if (config.typescript?.enabled) {
+            await removeStaleBundleFiles({
+                projectRoot: process.cwd(),
+                config: config.typescript,
+                outDir: config.outDir || DEFAULT_OUT_DIR,
+                compiled: compiledBundles,
+            });
+        }
+        if (config.search?.enabled && searchIndexFilename) {
+            await removeStaleSearchIndexes(outDir, config.search, searchIndexFilename);
+        }
+    }
     // Copy static assets and count them (skip for template-only changes in dev mode)
     const endAssetSpan = recorder.startSpan('assetCopyMs');
     let assetsCount = 0;

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;AAiC7D,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;AAmZD,wBAAsB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC,CA4hBxF"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/core/dev.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAe,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAoC7D,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;AAmZD,wBAAsB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC,CAmhBxF"}

package/dist/core/dev.js

@@ -1,5 +1,4 @@
 import { createServer } from 'node:http';
-import { join, extname } from 'node:path';
 import { readFile } from 'node:fs/promises';
 import { WebSocketServer } from 'ws';
 import chokidar from 'chokidar';
@@ -9,7 +8,7 @@ import { loadConfig } from '../config/loader.js';
 import { clearTemplateEngineCache } from './templates.js';
 import { clearMarkdownProcessorCache } from './markdown.js';
 import { loadCacheManifest, saveCacheManifest, DevServerLockManager } from './isg/index.js';
-import { resolveDevPaths, resolveCacheDir, resolvePrettyUrl, createErrorOverlay, parseErrorDetails, TemplateError, createFallbackLogger, mergeServerOptions, createTypeScriptWatcher, isEnabledEnvFlag, refreshCssOutputWatcher, normalizePathForComparison, isPathWithinDirectory, assertPortAvailable, toPortUnavailableError, } from './utils/index.js';
+import { resolveDevPaths, resolveCacheDir, resolvePrettyUrl, resolveRequestFile, resolveNotFoundPage, getMimeType, parseRequestPath, createErrorOverlay, parseErrorDetails, TemplateError, createFallbackLogger, mergeServerOptions, createTypeScriptWatcher, isEnabledEnvFlag, refreshCssOutputWatcher, normalizePathForComparison, assertPortAvailable, toPortUnavailableError, } from './utils/index.js';
 import { setEnv, getEnv } from '../env.js';
 import { DEFAULT_DEV_PORT, DEFAULT_DEV_HOST, TEMPLATE_EXTENSION, DEFAULT_OUT_DIR, } from '../constants.js';
 /**
@@ -367,30 +366,6 @@ export async function createDevServer(options = {}) {
     // Diagnostics toggles used for investigating dev-server rebuild slowdown.
     const disableCssWatcher = isEnabledEnvFlag(process.env.STATI_DEV_DISABLE_CSS_WATCHER);
     const disableWsReload = isEnabledEnvFlag(process.env.STATI_DEV_DISABLE_WS_RELOAD);
-    /**
-     * Gets MIME type for a file based on its extension
-     */
-    function getMimeType(filePath) {
-        const ext = extname(filePath).toLowerCase();
-        const mimeTypes = {
-            '.html': 'text/html',
-            '.js': 'application/javascript',
-            '.css': 'text/css',
-            '.json': 'application/json',
-            '.png': 'image/png',
-            '.jpg': 'image/jpeg',
-            '.jpeg': 'image/jpeg',
-            '.gif': 'image/gif',
-            '.svg': 'image/svg+xml',
-            '.ico': 'image/x-icon',
-            '.webp': 'image/webp',
-            '.woff': 'font/woff',
-            '.woff2': 'font/woff2',
-            '.ttf': 'font/ttf',
-            '.eot': 'application/vnd.ms-fontobject',
-        };
-        return mimeTypes[ext] || 'application/octet-stream';
-    }
     /**
      * Injects live reload script into HTML responses
      */
@@ -461,9 +436,9 @@ export async function createDevServer(options = {}) {
                 statusCode: 500,
             };
         }
-        const originalFilePath = join(outDir, requestPath === '/' ? 'index.html' : requestPath);
-        // Security: Prevent path traversal attacks
-        if (!isPathWithinDirectory(outDir, originalFilePath)) {
+        // Security: the file the request names, or null when it is outside the output directory
+        const requestFile = resolveRequestFile(outDir, requestPath);
+        if (requestFile === null) {
             return {
                 content: '403 - Forbidden',
                 mimeType: 'text/plain',
@@ -471,7 +446,7 @@ export async function createDevServer(options = {}) {
             };
         }
         // Use the shared pretty URL resolver
-        const { filePath, found } = await resolvePrettyUrl(outDir, requestPath, originalFilePath);
+        const { filePath, found } = await resolvePrettyUrl(outDir, requestPath, requestFile);
         if (!found || !filePath) {
             // If we have a build error and this is an HTML request, show error overlay instead of 404
             const errorToShow = lastBuildError;
@@ -508,6 +483,16 @@ export async function createDevServer(options = {}) {
                     statusCode: 500,
                 };
             }
+            // Serve the site's 404 page, as static hosts do, with live reload so it updates on edits
+            const notFoundPage = await resolveNotFoundPage(outDir);
+            if (notFoundPage) {
+                const html = await readFile(notFoundPage, 'utf-8');
+                return {
+                    content: injectLiveReloadScript(html),
+                    mimeType: 'text/html',
+                    statusCode: 404,
+                };
+            }
             return {
                 content: requestPath.endsWith('/')
                     ? '404 - Directory listing not available'
@@ -601,12 +586,17 @@ export async function createDevServer(options = {}) {
             await performInitialBuild(configPath, logger, setLastBuildError);
             // Create HTTP server
             httpServer = createServer(async (req, res) => {
-                const requestPath = req.url || '/';
+                const requestPath = parseRequestPath(req.url);
                 const requestStart = Date.now();
                 // Handle WebSocket upgrade path
                 if (requestPath === '/__ws') {
                     return; // Let WebSocket server handle this
                 }
+                if (requestPath === null) {
+                    res.writeHead(400, { 'Content-Type': 'text/plain' });
+                    res.end('400 - Bad Request');
+                    return;
+                }
                 // Only log page requests, not static assets (files with extensions)
                 const hasFileExtension = requestPath.includes('.') && !requestPath.endsWith('.html');
                 if (!hasFileExtension) {

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

@@ -1 +1 @@
-{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/core/preview.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAe,MAAM,mBAAmB,CAAC;AAa7D,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,0BAA0B;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAyBD;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,aAAa,CAAC,CAmKxB"}
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/core/preview.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAe,MAAM,mBAAmB,CAAC;AAgB7D,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,0BAA0B;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAyBD;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,aAAa,CAAC,CAwJxB"}

package/dist/core/preview.js

@@ -1,8 +1,7 @@
 import { createServer } from 'node:http';
-import { join, extname } from 'node:path';
 import { readFile } from 'node:fs/promises';
 import { loadConfig } from '../config/loader.js';
-import { resolveDevPaths, resolvePrettyUrl, createFallbackLogger, mergeServerOptions, isPathWithinDirectory, assertPortAvailable, toPortUnavailableError, } from './utils/index.js';
+import { resolveDevPaths, resolvePrettyUrl, resolveRequestFile, resolveNotFoundPage, getMimeType, parseRequestPath, createFallbackLogger, mergeServerOptions, assertPortAvailable, toPortUnavailableError, } from './utils/index.js';
 import { DEFAULT_PREVIEW_PORT, DEFAULT_DEV_HOST } from '../constants.js';
 /**
  * Loads and validates configuration for the preview server.
@@ -41,37 +40,13 @@ export async function createPreviewServer(options = {}) {
     });
     const url = `http://${host}:${port}`;
     let httpServer = null;
-    /**
-     * Gets MIME type for a file based on its extension
-     */
-    function getMimeType(filePath) {
-        const ext = extname(filePath).toLowerCase();
-        const mimeTypes = {
-            '.html': 'text/html',
-            '.js': 'application/javascript',
-            '.css': 'text/css',
-            '.json': 'application/json',
-            '.png': 'image/png',
-            '.jpg': 'image/jpeg',
-            '.jpeg': 'image/jpeg',
-            '.gif': 'image/gif',
-            '.svg': 'image/svg+xml',
-            '.ico': 'image/x-icon',
-            '.webp': 'image/webp',
-            '.woff': 'font/woff',
-            '.woff2': 'font/woff2',
-            '.ttf': 'font/ttf',
-            '.eot': 'application/vnd.ms-fontobject',
-        };
-        return mimeTypes[ext] || 'application/octet-stream';
-    }
     /**
      * Serves files from the dist directory
      */
     async function serveFile(requestPath) {
-        const originalFilePath = join(outDir, requestPath === '/' ? 'index.html' : requestPath);
-        // Security: Prevent path traversal attacks
-        if (!isPathWithinDirectory(outDir, originalFilePath)) {
+        // Security: the file the request names, or null when it is outside the output directory
+        const requestFile = resolveRequestFile(outDir, requestPath);
+        if (requestFile === null) {
             return {
                 content: '403 - Forbidden',
                 mimeType: 'text/plain',
@@ -79,8 +54,17 @@ export async function createPreviewServer(options = {}) {
             };
         }
         // Use the shared pretty URL resolver
-        const { filePath, found } = await resolvePrettyUrl(outDir, requestPath, originalFilePath);
+        const { filePath, found } = await resolvePrettyUrl(outDir, requestPath, requestFile);
         if (!found || !filePath) {
+            // Serve the site's 404 page, as static hosts do
+            const notFoundPage = await resolveNotFoundPage(outDir);
+            if (notFoundPage) {
+                return {
+                    content: await readFile(notFoundPage),
+                    mimeType: 'text/html',
+                    statusCode: 404,
+                };
+            }
             return {
                 content: requestPath.endsWith('/')
                     ? '404 - Directory listing not available'
@@ -114,8 +98,13 @@ export async function createPreviewServer(options = {}) {
             await assertPortAvailable(port, host, 'preview.port');
             // Create HTTP server
             httpServer = createServer(async (req, res) => {
-                const requestPath = req.url || '/';
-                logger.processing?.(`${req.method} ${requestPath}`);
+                logger.processing?.(`${req.method} ${req.url || '/'}`);
+                const requestPath = parseRequestPath(req.url);
+                if (requestPath === null) {
+                    res.writeHead(400, { 'Content-Type': 'text/plain' });
+                    res.end('400 - Bad Request');
+                    return;
+                }
                 try {
                     const { content, mimeType, statusCode } = await serveFile(requestPath);
                     res.writeHead(statusCode, {

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/index.d.ts

@@ -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

@@ -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/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/typescript.utils.d.ts

@@ -57,6 +57,33 @@ export interface WatchOptions {
  * @returns Array of detected bundle info
  */
 export declare function detectExistingBundles(options: Omit<CompileOptions, 'logger'>): Promise<CompiledBundleInfo[]>;
+/**
+ * Options for {@link removeStaleBundleFiles}.
+ */
+export interface RemoveStaleBundlesOptions {
+    /** Root directory of the project */
+    projectRoot: string;
+    /** TypeScript configuration */
+    config: TypeScriptConfig;
+    /** Output directory (defaults to 'dist') */
+    outDir?: string;
+    /** The bundles this build compiled */
+    compiled: CompiledBundleInfo[];
+}
+/**
+ * Deletes the files of compiled bundles that earlier builds left in the bundle output
+ * directory: hashed copies from builds whose code differed, and the unhashed file and source
+ * map the dev server writes, which production pages never load. Only files named after a
+ * bundle compiled in this build are deleted, and never a file this build wrote, so other files
+ * in the directory stay.
+ *
+ * The build calls this after every page is written: until then, pages from the previous
+ * build still load the old files.
+ *
+ * @param options - The project, its TypeScript config and output directory, and the bundles
+ *   this build compiled
+ */
+export declare function removeStaleBundleFiles(options: RemoveStaleBundlesOptions): Promise<void>;
 /**
  * Compile TypeScript files using esbuild.
  * Supports multiple bundles with parallel compilation.

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

@@ -1 +1 @@
-{"version":3,"file":"typescript.utils.d.ts","sourceRoot":"","sources":["../../../src/core/utils/typescript.utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAInC,OAAO,EAA6B,KAAK,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChG,OAAO,KAAK,EAAE,gBAAgB,EAAgB,MAAM,uBAAuB,CAAC;AAC5E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAQrD;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,IAAI,EAAE,aAAa,GAAG,YAAY,CAAC;IACnC,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,SAAS,EAAE,CAAC,OAAO,EAAE,kBAAkB,EAAE,EAAE,aAAa,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1E;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAuCD;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,GACtC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAyC/B;AAuED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAkD9F;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAyHjC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB5E;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM/E;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAqC7D;AAiBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CA8B7E"}
+{"version":3,"file":"typescript.utils.d.ts","sourceRoot":"","sources":["../../../src/core/utils/typescript.utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAInC,OAAO,EAA6B,KAAK,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChG,OAAO,KAAK,EAAE,gBAAgB,EAAgB,MAAM,uBAAuB,CAAC;AAC5E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAQrD;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQjD;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,IAAI,EAAE,aAAa,GAAG,YAAY,CAAC;IACnC,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,SAAS,EAAE,CAAC,OAAO,EAAE,kBAAkB,EAAE,EAAE,aAAa,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1E;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAuCD;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,GACtC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAyC/B;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAChC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB9F;AAuED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAkD9F;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAyHjC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB5E;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM/E;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAqC7D;AAiBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CA8B7E"}

package/dist/core/utils/typescript.utils.js

@@ -7,7 +7,7 @@
 import * as esbuild from 'esbuild';
 import * as path from 'node:path';
 import * as fs from 'node:fs/promises';
-import { pathExists } from './fs.utils.js';
+import { pathExists, readdir, remove } from './fs.utils.js';
 import { validateUniqueBundleNames } from './bundle-matching.utils.js';
 import { DEFAULT_TS_SRC_DIR, DEFAULT_TS_OUT_DIR, DEFAULT_BUNDLES, DEFAULT_OUT_DIR, } from '../../constants.js';
 /**
@@ -83,6 +83,39 @@ export async function detectExistingBundles(options) {
     }
     return results;
 }
+/**
+ * Deletes the files of compiled bundles that earlier builds left in the bundle output
+ * directory: hashed copies from builds whose code differed, and the unhashed file and source
+ * map the dev server writes, which production pages never load. Only files named after a
+ * bundle compiled in this build are deleted, and never a file this build wrote, so other files
+ * in the directory stay.
+ *
+ * The build calls this after every page is written: until then, pages from the previous
+ * build still load the old files.
+ *
+ * @param options - The project, its TypeScript config and output directory, and the bundles
+ *   this build compiled
+ */
+export async function removeStaleBundleFiles(options) {
+    const { projectRoot, config, outDir: globalOutDir = DEFAULT_OUT_DIR, compiled } = options;
+    if (compiled.length === 0) {
+        return;
+    }
+    const outDir = path.join(projectRoot, globalOutDir, resolveConfig(config, 'production').outDir);
+    const current = new Set(compiled.map((bundle) => bundle.filename));
+    // name.js, name-HASH.js (esbuild's 8-character hash) and their source maps
+    const patterns = compiled.map(({ config }) => {
+        const name = config.bundleName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        return new RegExp(`^${name}(?:-[A-Z0-9]{8})?\\.js(?:\\.map)?$`);
+    });
+    const entries = await readdir(outDir, { withFileTypes: true }).catch(() => []);
+    // Files only: remove() deletes folders with their contents, and links are left alone
+    const stale = entries
+        .filter((entry) => entry.isFile())
+        .map((entry) => entry.name)
+        .filter((file) => !current.has(file) && patterns.some((pattern) => pattern.test(file)));
+    await Promise.all(stale.map((file) => remove(path.join(outDir, file))));
+}
 /**
  * Compile a single bundle using esbuild.
  * @internal

package/dist/search/generator.d.ts

@@ -82,21 +82,32 @@ export declare function generateSearchIndex(searchablePages: SearchablePage[], c
 export declare function writeSearchIndex(searchIndex: SearchIndex, outDir: string, filename: string, skipIfUnchanged?: boolean): Promise<SearchIndexMetadata>;
 /**
  * Computes the search index filename based on configuration.
- * When hashFilename is true, generates a deterministic hash based on the build ID.
- * This allows the filename to be known before the index is generated,
- * enabling meta tag injection during initial template render.
+ * When hashFilename is true, the name carries a hash of `hashInput`. Production builds pass
+ * the index content, so the name changes only when the indexed text does; every page links to
+ * the index, so the name is part of each page's cache hash.
  *
  * @param config - Search configuration
- * @param buildId - Unique identifier for this build (e.g., timestamp or build ID)
+ * @param hashInput - The value the hash is computed from, such as the serialized documents
  * @returns The search index filename (without leading slash)
  *
  * @example
  * ```typescript
- * // At build start, compute the filename
- * const filename = computeSearchIndexFilename(config.search, Date.now().toString());
+ * const filename = computeSearchIndexFilename(config.search, JSON.stringify(index.documents));
  * // filename: 'search-index-a1b2c3d4.json' (when hashFilename is true)
  * // filename: 'search-index.json' (when hashFilename is false)
  * ```
  */
-export declare function computeSearchIndexFilename(config: SearchConfig, buildId?: string): string;
+export declare function computeSearchIndexFilename(config: SearchConfig, hashInput?: string): string;
+/**
+ * Deletes search index files that earlier builds wrote under another name: hashed files from
+ * builds whose indexed text differed, and the file of a build with the other `hashFilename`
+ * setting. Only files in the output directory named after `indexName` are deleted, never the
+ * current one.
+ *
+ * @param outDir - The output directory
+ * @param config - Search configuration
+ * @param currentFilename - The index file this build wrote
+ * @returns The deleted file names
+ */
+export declare function removeStaleSearchIndexes(outDir: string, config: SearchConfig, currentFilename: string): Promise<string[]>;
 //# sourceMappingURL=generator.d.ts.map

package/dist/search/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/search/generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EACX,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE3D;AAqBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CA2BtE;AAKD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA8DtD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,QAAQ,EAAE,EACf,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EACnC,MAAM,EAAE,YAAY,GACnB,cAAc,EAAE,CAiGlB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CA2BhF;AAED;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAM1E;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,IAAI,EAAE,SAAS,CAAC;IAChB,oEAAoE;IACpE,GAAG,EAAE,QAAQ,EAAE,CAAC;IAChB,kDAAkD;IAClD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,eAAe,EAAE,cAAc,EAAE,EACjC,MAAM,EAAE,YAAY,GACnB,WAAW,CA6Bb;AAiBD,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,eAAe,UAAQ,GACtB,OAAO,CAAC,mBAAmB,CAAC,CAqC9B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAczF"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/search/generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EACX,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE3D;AAqBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CA2BtE;AAKD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA8DtD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,QAAQ,EAAE,EACf,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EACnC,MAAM,EAAE,YAAY,GACnB,cAAc,EAAE,CAiGlB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CA2BhF;AAED;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAM1E;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,IAAI,EAAE,SAAS,CAAC;IAChB,oEAAoE;IACpE,GAAG,EAAE,QAAQ,EAAE,CAAC;IAChB,kDAAkD;IAClD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,eAAe,EAAE,cAAc,EAAE,EACjC,MAAM,EAAE,YAAY,GACnB,WAAW,CA6Bb;AAiBD,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,eAAe,UAAQ,GACtB,OAAO,CAAC,mBAAmB,CAAC,CAqC9B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAW3F;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,YAAY,EACpB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,EAAE,CAAC,CAoBnB"}

package/dist/search/generator.js

@@ -4,7 +4,7 @@
  */
 import { createHash } from 'node:crypto';
 import { join } from 'node:path';
-import { writeFile, ensureDir } from '../core/utils/fs.utils.js';
+import { writeFile, ensureDir, readdir, remove } from '../core/utils/fs.utils.js';
 import { matchesGlob } from '../core/utils/glob-patterns.utils.js';
 import { isVirtualPage } from '../core/utils/template-discovery.utils.js';
 import { SEARCH_INDEX_VERSION, SEARCH_DEFAULTS } from './constants.js';
@@ -327,32 +327,55 @@ export async function writeSearchIndex(searchIndex, outDir, filename, skipIfUnch
 }
 /**
  * Computes the search index filename based on configuration.
- * When hashFilename is true, generates a deterministic hash based on the build ID.
- * This allows the filename to be known before the index is generated,
- * enabling meta tag injection during initial template render.
+ * When hashFilename is true, the name carries a hash of `hashInput`. Production builds pass
+ * the index content, so the name changes only when the indexed text does; every page links to
+ * the index, so the name is part of each page's cache hash.
  *
  * @param config - Search configuration
- * @param buildId - Unique identifier for this build (e.g., timestamp or build ID)
+ * @param hashInput - The value the hash is computed from, such as the serialized documents
  * @returns The search index filename (without leading slash)
  *
  * @example
  * ```typescript
- * // At build start, compute the filename
- * const filename = computeSearchIndexFilename(config.search, Date.now().toString());
+ * const filename = computeSearchIndexFilename(config.search, JSON.stringify(index.documents));
  * // filename: 'search-index-a1b2c3d4.json' (when hashFilename is true)
  * // filename: 'search-index.json' (when hashFilename is false)
  * ```
  */
-export function computeSearchIndexFilename(config, buildId) {
+export function computeSearchIndexFilename(config, hashInput) {
     const indexName = config.indexName ?? SEARCH_DEFAULTS.indexName;
     const hashFilename = config.hashFilename ?? SEARCH_DEFAULTS.hashFilename;
     if (hashFilename) {
-        // Generate a deterministic hash based on build ID
-        // This allows the filename to be known before content is generated
-        const hashInput = buildId ?? Date.now().toString();
-        const hash = generateContentHash(hashInput);
+        const hash = generateContentHash(hashInput ?? Date.now().toString());
         return `${indexName}-${hash}.json`;
     }
     // Return base filename (without hash)
     return `${indexName}.json`;
 }
+/**
+ * Deletes search index files that earlier builds wrote under another name: hashed files from
+ * builds whose indexed text differed, and the file of a build with the other `hashFilename`
+ * setting. Only files in the output directory named after `indexName` are deleted, never the
+ * current one.
+ *
+ * @param outDir - The output directory
+ * @param config - Search configuration
+ * @param currentFilename - The index file this build wrote
+ * @returns The deleted file names
+ */
+export async function removeStaleSearchIndexes(outDir, config, currentFilename) {
+    const indexName = (config.indexName ?? SEARCH_DEFAULTS.indexName).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    // name.json and name-HASH.json (generateContentHash's 8 hex characters)
+    const pattern = new RegExp(`^${indexName}(?:-[0-9a-f]{8})?\\.json$`);
+    const entries = await readdir(outDir, { withFileTypes: true }).catch(() => null);
+    if (!entries) {
+        return [];
+    }
+    // Files only: remove() deletes folders with their contents, and links are left alone
+    const stale = entries
+        .filter((entry) => entry.isFile())
+        .map((entry) => entry.name)
+        .filter((file) => file !== currentFilename && pattern.test(file));
+    await Promise.all(stale.map((file) => remove(join(outDir, file))));
+    return stale;
+}

package/dist/search/index.d.ts

@@ -16,7 +16,7 @@
  * console.log(`Generated search index at ${metadata.indexPath}`);
  * ```
  */
-export { generateSearchIndex, writeSearchIndex, extractSectionsFromMarkdown, stripMarkdown, shouldExcludePage, isGeneratedPageExcludedFromSearch, generateContentHash, buildBreadcrumb, computeSearchIndexFilename, } from './generator.js';
+export { generateSearchIndex, writeSearchIndex, extractSectionsFromMarkdown, stripMarkdown, shouldExcludePage, isGeneratedPageExcludedFromSearch, generateContentHash, buildBreadcrumb, computeSearchIndexFilename, removeStaleSearchIndexes, } from './generator.js';
 export type { SearchablePage } from './generator.js';
 export { autoInjectSearchMeta } from './auto-inject.js';
 export { SEARCH_INDEX_META_NAME, SEARCH_INDEX_VERSION, SEARCH_DEFAULTS } from './constants.js';

package/dist/search/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/search/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,2BAA2B,EAC3B,aAAa,EACb,iBAAiB,EACjB,iCAAiC,EACjC,mBAAmB,EACnB,eAAe,EACf,0BAA0B,GAC3B,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE/F,YAAY,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EACX,mBAAmB,GACpB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/search/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,2BAA2B,EAC3B,aAAa,EACb,iBAAiB,EACjB,iCAAiC,EACjC,mBAAmB,EACnB,eAAe,EACf,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE/F,YAAY,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EACX,mBAAmB,GACpB,MAAM,oBAAoB,CAAC"}

package/dist/search/index.js

@@ -16,7 +16,7 @@
  * console.log(`Generated search index at ${metadata.indexPath}`);
  * ```
  */
-export { generateSearchIndex, writeSearchIndex, extractSectionsFromMarkdown, stripMarkdown, shouldExcludePage, isGeneratedPageExcludedFromSearch, generateContentHash, buildBreadcrumb, computeSearchIndexFilename, } from './generator.js';
+export { generateSearchIndex, writeSearchIndex, extractSectionsFromMarkdown, stripMarkdown, shouldExcludePage, isGeneratedPageExcludedFromSearch, generateContentHash, buildBreadcrumb, computeSearchIndexFilename, removeStaleSearchIndexes, } from './generator.js';
 // Auto-injection
 export { autoInjectSearchMeta } from './auto-inject.js';
 export { SEARCH_INDEX_META_NAME, SEARCH_INDEX_VERSION, SEARCH_DEFAULTS } from './constants.js';

package/dist/types/config.d.ts

@@ -212,16 +212,18 @@ export interface BundleConfig {
     bundleName: string;
     /**
      * Glob patterns for pages that should include this bundle.
-     * Matches against page output path (e.g., '/docs/api/hooks.html').
+     * Matches against the page URL (e.g., '/docs/api/hooks', or '/' for the home page),
+     * not its output file. A pattern must match the whole URL: '/docs/**' does not match
+     * the '/docs' index page itself.
      * If omitted, bundle is included on ALL pages (global bundle).
      *
-     * Supports glob syntax: `*`, `**`, `?`, `[abc]`, `{a,b}`
+     * Supports glob syntax: `*`, `**`, `?`, `[abc]` (no `{a,b}`; list each pattern instead)
      *
-     * @example ['/docs/**', '/api/**']
+     * @example ['/docs', '/docs/**', '/api/**']
      */
     include?: string[];
     /**
-     * Glob patterns for pages to exclude from this bundle.
+     * Glob patterns for page URLs to exclude from this bundle.
      * Takes precedence over include patterns.
      *
      * @example ['/docs/legacy/**']

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stati/core",
-  "version": "1.29.0",
+  "version": "1.29.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",