@stati/core 1.29.0 → 1.29.2

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

@@ -23,6 +23,15 @@ export interface RenderPageExtras {
     /** Image state of the page; without it `stati.image()` emits a plain `<img>` */
     images?: PageImages | undefined;
 }
+/**
+ * Discovers partials in the hierarchy for a given page path.
+ * Scans all parent directories for folders starting with underscore.
+ *
+ * @param pagePath - The path to the page (relative to srcDir), with `/` or `\` separators
+ * @param config - Stati configuration
+ * @returns Object mapping partial names to their file paths
+ */
+export declare function discoverPartials(pagePath: string, config: StatiConfig): Promise<Record<string, string>>;
 /**
  * Clear the cached template engine. Call this when templates change in dev mode
  * so the next build recompiles them, or when shutting down a dev session.

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

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/core/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAG1B,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,OAAO,EAEP,QAAQ,EACR,MAAM,EACP,MAAM,mBAAmB,CAAC;AAuB3B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,KAAK,EAAE,UAAU,EAAqB,MAAM,sBAAsB,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,eAAe,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACvC,iEAAiE;IACjE,KAAK,EAAE,SAAS,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gFAAgF;IAChF,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;CACjC;AAuHD;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,GAAG,CA2B7D;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,GAAG,EACR,UAAU,CAAC,EAAE,OAAO,EAAE,EACtB,QAAQ,CAAC,EAAE,SAAS,EAAE,EACtB,MAAM,CAAC,EAAE,OAAO,mBAAmB,EAAE,WAAW,EAChD,GAAG,CAAC,EAAE,QAAQ,EAAE,EAChB,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,YAAY,CAAC,CA8RvB"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/core/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAG1B,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,OAAO,EAEP,QAAQ,EACR,MAAM,EACP,MAAM,mBAAmB,CAAC;AAuB3B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,KAAK,EAAE,UAAU,EAAqB,MAAM,sBAAsB,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,eAAe,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACvC,iEAAiE;IACjE,KAAK,EAAE,SAAS,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gFAAgF;IAChF,MAAM,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;CACjC;AA2CD;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAoDjC;AAcD;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,GAAG,CA2B7D;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,GAAG,EACR,UAAU,CAAC,EAAE,OAAO,EAAE,EACtB,QAAQ,CAAC,EAAE,SAAS,EAAE,EACtB,MAAM,CAAC,EAAE,OAAO,mBAAmB,EAAE,WAAW,EAChD,GAAG,CAAC,EAAE,QAAQ,EAAE,EAChB,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,YAAY,CAAC,CA8RvB"}

package/dist/core/templates.js

@@ -1,5 +1,5 @@
 import { Eta } from 'eta';
-import { join, dirname, relative, basename, posix } from 'node:path';
+import { join, relative, basename, posix } from 'node:path';
 import glob from 'fast-glob';
 import { createFallbackLogger } from './utils/index.js';
 import { TEMPLATE_EXTENSION } from '../constants.js';
@@ -50,15 +50,16 @@ function createNavView(helpers, reads) {
  * Discovers partials in the hierarchy for a given page path.
  * Scans all parent directories for folders starting with underscore.
  *
- * @param pagePath - The path to the page (relative to srcDir)
+ * @param pagePath - The path to the page (relative to srcDir), with `/` or `\` separators
  * @param config - Stati configuration
  * @returns Object mapping partial names to their file paths
  */
-async function discoverPartials(pagePath, config) {
+export async function discoverPartials(pagePath, config) {
     const srcDir = resolveSrcDir(config);
     const partials = {};
-    // Get the directory of the current page
-    const pageDir = dirname(pagePath);
+    // Get the directory of the current page. Windows paths use backslashes, so convert them
+    // first, or the folders between the root and the page's own folder are skipped.
+    const pageDir = posix.dirname(pagePath.replace(/\\/g, '/'));
     const pathSegments = pageDir === '.' ? [] : pageDir.split('/');
     // Scan from root to current directory (least specific first)
     // This allows more specific partials to override less specific ones

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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"}