@stati/core 1.3.2 → 1.4.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;AAQ7D,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;AAmLD,wBAAsB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC,CAqQxF"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/core/dev.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAe,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAS7D,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;AAyMD,wBAAsB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC,CAgTxF"}

package/dist/core/dev.js

@@ -5,6 +5,7 @@ import { readFile, stat } from 'fs/promises';
 import { WebSocketServer } from 'ws';
 import chokidar from 'chokidar';
 import { build } from './build.js';
+import { invalidate } from './invalidate.js';
 import { loadConfig } from '../config/loader.js';
 import { loadCacheManifest, saveCacheManifest } from './isg/manifest.js';
 import { resolveDevPaths, resolveCacheDir } from './utils/paths.js';
@@ -34,6 +35,9 @@ async function loadDevConfig(configPath, logger) {
  */
 async function performInitialBuild(configPath, logger) {
     try {
+        // Clear cache to ensure fresh build on dev server start
+        logger.info?.('Clearing cache for fresh development build...');
+        await invalidate();
         await build({
             logger,
             force: false,
@@ -125,8 +129,14 @@ async function handleTemplateChange(templatePath, configPath, logger) {
         }
         // Find pages that depend on this template
         const affectedPages = [];
+        const normalizedTemplatePath = posix.normalize(templatePath.replace(/\\/g, '/'));
         for (const [pagePath, entry] of Object.entries(cacheManifest.entries)) {
-            if (entry.deps.some((dep) => dep.includes(posix.normalize(templatePath.replace(/\\/g, '/'))))) {
+            if (entry.deps.some((dep) => {
+                const normalizedDep = posix.normalize(dep.replace(/\\/g, '/'));
+                // Use endsWith for more precise matching to avoid false positives
+                return (normalizedDep === normalizedTemplatePath ||
+                    normalizedDep.endsWith('/' + normalizedTemplatePath));
+            })) {
                 affectedPages.push(pagePath);
                 // Remove from cache to force rebuild
                 delete cacheManifest.entries[pagePath];
@@ -143,6 +153,17 @@ async function handleTemplateChange(templatePath, configPath, logger) {
                 ...(configPath && { configPath }),
             });
         }
+        else {
+            // If no affected pages were found but a template changed,
+            // force a full rebuild to ensure changes are reflected
+            // This can happen if dependency tracking missed something
+            await build({
+                logger,
+                force: true,
+                clean: false,
+                ...(configPath && { configPath }),
+            });
+        }
     }
     catch {
         // Fallback to full rebuild
@@ -243,11 +264,21 @@ export async function createDevServer(options = {}) {
                     filePath = indexPath;
                 }
                 catch {
-                    return {
-                        content: '404 - Directory listing not available',
-                        mimeType: 'text/plain',
-                        statusCode: 404,
-                    };
+                    // 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);
+                        filePath = fallbackPath;
+                    }
+                    catch {
+                        return {
+                            content: '404 - Directory listing not available',
+                            mimeType: 'text/plain',
+                            statusCode: 404,
+                        };
+                    }
                 }
             }
             const mimeType = getMimeType(filePath);
@@ -269,6 +300,36 @@ export async function createDevServer(options = {}) {
             };
         }
         catch {
+            // File not found, try some 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()) {
+                        const mimeType = getMimeType(htmlPath);
+                        const content = await readFile(htmlPath);
+                        if (mimeType === 'text/html') {
+                            const html = content.toString('utf-8');
+                            const injectedHtml = injectLiveReloadScript(html);
+                            return {
+                                content: injectedHtml,
+                                mimeType,
+                                statusCode: 200,
+                            };
+                        }
+                        return {
+                            content,
+                            mimeType,
+                            statusCode: 200,
+                        };
+                    }
+                }
+                catch {
+                    // Continue to 404
+                }
+            }
             // File not found
             return {
                 content: '404 - File not found',

package/dist/core/preview.d.ts

@@ -0,0 +1,19 @@
+import type { Logger } from '../types/index.js';
+export interface PreviewServerOptions {
+    port?: number;
+    host?: string;
+    open?: boolean;
+    configPath?: string;
+    logger?: Logger;
+}
+export interface PreviewServer {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    url: string;
+}
+/**
+ * Creates a preview server that serves the built site from the dist directory
+ * without live reload functionality, perfect for previewing the production build.
+ */
+export declare function createPreviewServer(options?: PreviewServerOptions): Promise<PreviewServer>;
+//# sourceMappingURL=preview.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/core/preview.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAKhD,MAAM,WAAW,oBAAoB;IACnC,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,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,CA+JxB"}

package/dist/core/preview.js

@@ -0,0 +1,163 @@
+import { createServer } from 'http';
+import { join, extname } from 'path';
+import { readFile, stat } from 'fs/promises';
+import { loadConfig } from '../config/loader.js';
+import { resolveDevPaths } from './utils/paths.js';
+import { DEFAULT_DEV_PORT, DEFAULT_DEV_HOST } from '../constants.js';
+/**
+ * Loads and validates configuration for the preview server.
+ */
+async function loadPreviewConfig(configPath, logger) {
+    try {
+        if (configPath) {
+            logger.info?.(`Loading config from: ${configPath}`);
+        }
+        const config = await loadConfig(process.cwd());
+        const { outDir } = resolveDevPaths(config);
+        return { outDir };
+    }
+    catch (error) {
+        logger.error?.(`Failed to load config: ${error instanceof Error ? error.message : String(error)}`);
+        throw error;
+    }
+}
+/**
+ * Creates a preview server that serves the built site from the dist directory
+ * without live reload functionality, perfect for previewing the production build.
+ */
+export async function createPreviewServer(options = {}) {
+    const { port = DEFAULT_DEV_PORT, host = DEFAULT_DEV_HOST, open = false, configPath, logger = {
+        info: () => { },
+        success: () => { },
+        error: (msg) => console.error(msg),
+        warning: (msg) => console.warn(msg),
+        building: () => { },
+        processing: () => { },
+        stats: () => { },
+    }, } = options;
+    const url = `http://${host}:${port}`;
+    let httpServer = null;
+    // Load configuration
+    const { outDir } = await loadPreviewConfig(configPath, logger);
+    /**
+     * 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) {
+        let filePath = join(outDir, requestPath === '/' ? 'index.html' : requestPath);
+        try {
+            const stats = await stat(filePath);
+            if (stats.isDirectory()) {
+                // Try to serve index.html from directory
+                const indexPath = join(filePath, 'index.html');
+                try {
+                    await stat(indexPath);
+                    filePath = indexPath;
+                }
+                catch {
+                    return {
+                        content: '404 - Directory listing not available',
+                        mimeType: 'text/plain',
+                        statusCode: 404,
+                    };
+                }
+            }
+            const mimeType = getMimeType(filePath);
+            const content = await readFile(filePath);
+            // Unlike dev server, we don't inject live reload script in preview mode
+            return {
+                content,
+                mimeType,
+                statusCode: 200,
+            };
+        }
+        catch {
+            // File not found
+            return {
+                content: '404 - File not found',
+                mimeType: 'text/plain',
+                statusCode: 404,
+            };
+        }
+    }
+    const previewServer = {
+        url,
+        async start() {
+            // Create HTTP server
+            httpServer = createServer(async (req, res) => {
+                const requestPath = req.url || '/';
+                logger.processing?.(`${req.method} ${requestPath}`);
+                try {
+                    const { content, mimeType, statusCode } = await serveFile(requestPath);
+                    res.writeHead(statusCode, {
+                        'Content-Type': mimeType,
+                        'Access-Control-Allow-Origin': '*',
+                        'Cache-Control': 'public, max-age=31536000', // Better caching for production preview
+                    });
+                    res.end(content);
+                }
+                catch (error) {
+                    logger.error?.(`Server error: ${error instanceof Error ? error.message : String(error)}`);
+                    res.writeHead(500, { 'Content-Type': 'text/plain' });
+                    res.end('500 - Internal Server Error');
+                }
+            });
+            // Start HTTP server
+            await new Promise((resolve, reject) => {
+                httpServer.listen(port, host, () => {
+                    resolve();
+                });
+                httpServer.on('error', (error) => {
+                    reject(error);
+                });
+            });
+            logger.success?.(`Preview server running at ${url}`);
+            logger.info?.(`\nServing from:`);
+            logger.info?.(`  📁 ${outDir}`);
+            // Open browser if requested
+            if (open) {
+                try {
+                    const { default: openBrowser } = await import('open');
+                    await openBrowser(url);
+                }
+                catch {
+                    logger.info?.('Could not open browser automatically');
+                }
+            }
+        },
+        async stop() {
+            if (httpServer) {
+                await new Promise((resolve) => {
+                    httpServer.close(() => {
+                        resolve();
+                    });
+                });
+                httpServer = null;
+            }
+        },
+    };
+    return previewServer;
+}

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

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/core/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAG1B,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAkB,MAAM,mBAAmB,CAAC;AAiLzF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,GAAG,CAS7D;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,GAAG,EACR,UAAU,CAAC,EAAE,OAAO,EAAE,EACtB,QAAQ,CAAC,EAAE,SAAS,EAAE,GACrB,OAAO,CAAC,MAAM,CAAC,CAkEjB"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/core/templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAG1B,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAkB,MAAM,mBAAmB,CAAC;AAiLzF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,GAAG,CAU7D;AAED,wBAAsB,UAAU,CAC9B,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,GAAG,EACR,UAAU,CAAC,EAAE,OAAO,EAAE,EACtB,QAAQ,CAAC,EAAE,SAAS,EAAE,GACrB,OAAO,CAAC,MAAM,CAAC,CAkEjB"}

package/dist/core/templates.js

@@ -1,5 +1,5 @@
 import { Eta } from 'eta';
-import { join, dirname, relative, basename } from 'path';
+import { join, dirname, relative, basename, posix } from 'path';
 import glob from 'fast-glob';
 import { TEMPLATE_EXTENSION } from '../constants.js';
 import { isCollectionIndexPage, discoverLayout, getCollectionPathForPage, } from './utils/template-discovery.js';
@@ -146,7 +146,7 @@ async function discoverPartials(pagePath, config) {
                 const fullPath = join(folderPath, etaFile);
                 // Get relative path from srcDir to the partial file
                 const relativePath = relative(srcDir, fullPath);
-                partials[partialName] = relativePath;
+                partials[partialName] = posix.normalize(relativePath);
             }
         }
     }
@@ -157,6 +157,7 @@ export function createTemplateEngine(config) {
     const eta = new Eta({
         views: templateDir,
         cache: process.env.NODE_ENV === 'production',
+        cacheFilepaths: process.env.NODE_ENV === 'production',
     });
     return eta;
 }

package/dist/index.d.ts

@@ -22,9 +22,11 @@
 export type { StatiConfig, PageModel, FrontMatter, BuildContext, PageContext, BuildHooks, NavNode, ISGConfig, AgingRule, BuildStats, } from './types/index.js';
 export type { BuildOptions } from './core/build.js';
 export type { DevServerOptions } from './core/dev.js';
+export type { PreviewServerOptions } from './core/preview.js';
 export type { InvalidationResult } from './core/invalidate.js';
 export { build } from './core/build.js';
 export { createDevServer } from './core/dev.js';
+export { createPreviewServer } from './core/preview.js';
 export { loadConfig } from './config/loader.js';
 export { invalidate } from './core/invalidate.js';
 import type { StatiConfig } from './types/index.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,YAAY,EACV,WAAW,EACX,SAAS,EACT,WAAW,EACX,YAAY,EACZ,WAAW,EACX,UAAU,EACV,OAAO,EACP,SAAS,EACT,SAAS,EACT,UAAU,GACX,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGlD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAE7D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,YAAY,EACV,WAAW,EACX,SAAS,EACT,WAAW,EACX,YAAY,EACZ,WAAW,EACX,UAAU,EACV,OAAO,EACP,SAAS,EACT,SAAS,EACT,UAAU,GACX,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGlD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,CAE7D"}

package/dist/index.js

@@ -21,6 +21,7 @@
  */
 export { build } from './core/build.js';
 export { createDevServer } from './core/dev.js';
+export { createPreviewServer } from './core/preview.js';
 export { loadConfig } from './config/loader.js';
 export { invalidate } from './core/invalidate.js';
 /**

package/package.json

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