@stati/core 1.3.2 → 1.5.0

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

@@ -0,0 +1,23 @@
+/**
+ * Result of attempting to resolve a pretty URL path
+ */
+export interface PrettyUrlResult {
+    /** The resolved file path to serve */
+    filePath: string | null;
+    /** Whether the path was found */
+    found: boolean;
+}
+/**
+ * Attempts to resolve pretty URL paths by trying various fallback strategies.
+ * This handles common patterns like:
+ * - /path/ -> /path/index.html
+ * - /path/ -> /path.html (if no index.html exists)
+ * - /path -> /path.html (when original path is not found)
+ *
+ * @param outDir The output directory to serve files from
+ * @param requestPath The requested URL path
+ * @param originalFilePath The original file path that was attempted
+ * @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>;
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/core/utils/server.ts"],"names":[],"mappings":"AAGA;;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,CA+C1B"}

package/dist/core/utils/server.js

@@ -0,0 +1,61 @@
+import { join } from 'path';
+import { stat } from 'fs/promises';
+/**
+ * Attempts to resolve pretty URL paths by trying various fallback strategies.
+ * This handles common patterns like:
+ * - /path/ -> /path/index.html
+ * - /path/ -> /path.html (if no index.html exists)
+ * - /path -> /path.html (when original path is not found)
+ *
+ * @param outDir The output directory to serve files from
+ * @param requestPath The requested URL path
+ * @param originalFilePath The original file path that was attempted
+ * @returns Promise resolving to the file path to serve or null if not found
+ */
+export async function resolvePrettyUrl(outDir, requestPath, originalFilePath) {
+    try {
+        const stats = await stat(originalFilePath);
+        if (stats.isDirectory()) {
+            // Try to serve index.html from directory
+            const indexPath = join(originalFilePath, 'index.html');
+            try {
+                await stat(indexPath);
+                return { filePath: indexPath, found: true };
+            }
+            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 };
+                }
+            }
+        }
+        // File exists and is not a directory
+        return { filePath: originalFilePath, 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
+            }
+        }
+        // No fallback worked
+        return { filePath: null, found: false };
+    }
+}

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

@@ -0,0 +1,28 @@
+import type { ErrorDetails } from './error-overlay.js';
+/**
+ * Enhanced template error that includes file context and suggestions.
+ */
+export declare class TemplateError extends Error {
+    readonly filePath?: string;
+    readonly line?: number;
+    readonly column?: number;
+    readonly template?: string;
+    readonly context?: {
+        before?: string[];
+        after?: string[];
+    };
+    constructor(message: string, filePath?: string, line?: number, column?: number, template?: string);
+    /**
+     * Converts this template error to ErrorDetails for the overlay.
+     */
+    toErrorDetails(): Promise<ErrorDetails>;
+}
+/**
+ * Parses Eta template errors to extract file location information.
+ */
+export declare function parseEtaError(error: Error, templatePath?: string): TemplateError;
+/**
+ * Enhances a generic error with template-specific context.
+ */
+export declare function createTemplateError(error: Error, templatePath?: string, _line?: number, _column?: number): TemplateError;
+//# sourceMappingURL=template-errors.d.ts.map

package/dist/core/utils/template-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-errors.d.ts","sourceRoot":"","sources":["../../../src/core/utils/template-errors.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClC,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAgB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChC,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClC,SAAgB,OAAO,CAAC,EAAE;QACxB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;gBAGA,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM;IAUnB;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,YAAY,CAAC;CAoE9C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa,CA8BhF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,KAAK,EACZ,YAAY,CAAC,EAAE,MAAM,EACrB,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,GACf,aAAa,CAMf"}

package/dist/core/utils/template-errors.js

@@ -0,0 +1,128 @@
+import { readFile } from 'fs/promises';
+import { pathExists } from './fs.js';
+/**
+ * Enhanced template error that includes file context and suggestions.
+ */
+export class TemplateError extends Error {
+    filePath;
+    line;
+    column;
+    template;
+    context;
+    constructor(message, filePath, line, column, template) {
+        super(message);
+        this.name = 'TemplateError';
+        if (filePath !== undefined)
+            this.filePath = filePath;
+        if (line !== undefined)
+            this.line = line;
+        if (column !== undefined)
+            this.column = column;
+        if (template !== undefined)
+            this.template = template;
+    }
+    /**
+     * Converts this template error to ErrorDetails for the overlay.
+     */
+    async toErrorDetails() {
+        const suggestions = [];
+        const message = this.message.toLowerCase();
+        // Add specific suggestions based on error type
+        if (message.includes('not found') || message.includes('cannot resolve')) {
+            suggestions.push('Check if the template file exists and has the correct path');
+            suggestions.push('Verify the template reference in your layout or include statement');
+            suggestions.push('Ensure the template file has the .eta extension');
+        }
+        else if (message.includes('syntax') || message.includes('unexpected')) {
+            suggestions.push('Check for unmatched brackets, quotes, or parentheses');
+            suggestions.push('Verify Eta template syntax is correct');
+            suggestions.push('Look for unclosed template tags');
+        }
+        else if (message.includes('undefined') || message.includes('null')) {
+            suggestions.push('Check if all required data is available in template context');
+            suggestions.push('Add conditional checks for optional template variables');
+            suggestions.push('Verify page frontMatter and data structure');
+        }
+        // Try to read file context if available
+        let context;
+        let code;
+        if (this.filePath && this.line && (await pathExists(this.filePath))) {
+            try {
+                const fileContent = await readFile(this.filePath, 'utf-8');
+                const lines = fileContent.split('\n');
+                const errorLineIndex = this.line - 1;
+                if (errorLineIndex >= 0 && errorLineIndex < lines.length) {
+                    code = lines[errorLineIndex];
+                    // Get surrounding context
+                    const contextLines = 3;
+                    const beforeLines = lines.slice(Math.max(0, errorLineIndex - contextLines), errorLineIndex);
+                    const afterLines = lines.slice(errorLineIndex + 1, Math.min(lines.length, errorLineIndex + contextLines + 1));
+                    context = {
+                        before: beforeLines,
+                        after: afterLines,
+                    };
+                }
+            }
+            catch {
+                // Ignore file read errors
+            }
+        }
+        const errorDetails = {
+            type: 'template',
+            message: this.message,
+            suggestions,
+        };
+        if (this.stack !== undefined)
+            errorDetails.stack = this.stack;
+        if (this.filePath !== undefined)
+            errorDetails.file = this.filePath;
+        if (this.line !== undefined)
+            errorDetails.line = this.line;
+        if (this.column !== undefined)
+            errorDetails.column = this.column;
+        if (code !== undefined)
+            errorDetails.code = code;
+        if (context !== undefined)
+            errorDetails.context = context;
+        return errorDetails;
+    }
+}
+/**
+ * Parses Eta template errors to extract file location information.
+ */
+export function parseEtaError(error, templatePath) {
+    let filePath = templatePath;
+    let line;
+    let column;
+    // Try to parse error location from Eta error messages
+    const message = error.message;
+    // Eta syntax errors often include line/column info
+    const locationMatch = message.match(/at line (\d+), column (\d+)/i);
+    if (locationMatch && locationMatch[1] && locationMatch[2]) {
+        line = parseInt(locationMatch[1], 10);
+        column = parseInt(locationMatch[2], 10);
+    }
+    // Try to extract file path from stack trace if not provided
+    if (!filePath && error.stack) {
+        const stackLines = error.stack.split('\n');
+        for (const stackLine of stackLines) {
+            const fileMatch = stackLine.match(/at.*\(([^)]+\.eta):(\d+):(\d+)\)/);
+            if (fileMatch && fileMatch[1] && fileMatch[2] && fileMatch[3]) {
+                filePath = fileMatch[1];
+                line = parseInt(fileMatch[2], 10);
+                column = parseInt(fileMatch[3], 10);
+                break;
+            }
+        }
+    }
+    return new TemplateError(message, filePath, line, column);
+}
+/**
+ * Enhances a generic error with template-specific context.
+ */
+export function createTemplateError(error, templatePath, _line, _column) {
+    if (error instanceof TemplateError) {
+        return error;
+    }
+    return parseEtaError(error, templatePath);
+}

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

@@ -0,0 +1,6 @@
+/**
+ * Gets the current version of Stati core from package.json
+ * @returns The version string
+ */
+export declare function getStatiVersion(): string;
+//# sourceMappingURL=version.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/core/utils/version.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAWxC"}

package/dist/core/utils/version.js

@@ -0,0 +1,20 @@
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+/**
+ * Gets the current version of Stati core from package.json
+ * @returns The version string
+ */
+export function getStatiVersion() {
+    try {
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = dirname(__filename);
+        const packageJsonPath = join(__dirname, '../../package.json');
+        const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+        return packageJson.version;
+    }
+    catch {
+        // Fallback for cases where package.json can't be read
+        return '1.0.0';
+    }
+}

package/dist/env.d.ts

@@ -0,0 +1,3 @@
+export declare function setEnv(env: 'development' | 'production' | 'test'): void;
+export declare function getEnv(): string;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAEA,wBAAgB,MAAM,CAAC,GAAG,EAAE,aAAa,GAAG,YAAY,GAAG,MAAM,QAEhE;AAED,wBAAgB,MAAM,WAErB"}

package/dist/env.js

@@ -0,0 +1,7 @@
+let currentEnv = process.env.NODE_ENV || 'development';
+export function setEnv(env) {
+    currentEnv = env;
+}
+export function getEnv() {
+    return currentEnv;
+}

package/dist/index.d.ts

@@ -22,11 +22,14 @@
 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';
+export { setEnv, getEnv } from './env.js';
 import type { StatiConfig } from './types/index.js';
 /**
  * Helper function for defining Stati configuration with TypeScript IntelliSense.

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;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAG1C,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,8 +21,10 @@
  */
 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';
+export { setEnv, getEnv } from './env.js';
 /**
  * Helper function for defining Stati configuration with TypeScript IntelliSense.
  * Provides type checking and autocompletion for configuration options.

package/package.json

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