@stati/core 1.2.0 → 1.3.1

package/dist/core/build.d.ts

@@ -28,31 +28,35 @@ export interface BuildOptions {
     version?: string;
 }
 /**
- * Builds the static site by processing content files and generating HTML pages.
- * This is the main entry point for Stati's build process.
+ * Builds the Stati site with ISG support.
+ * Processes all pages and assets, with smart caching for incremental builds.
+ *
  * Uses build locking to prevent concurrent builds from corrupting cache.
+ * The manifest tracks build dependencies and cache entries for efficient rebuilds.
+ * Pages are only rebuilt if their content, templates, or dependencies have changed.
+ *
+ * Build process:
+ * 1. Load configuration and content
+ * 2. Check cache manifest for existing entries
+ * 3. Process each page (rebuild only if needed)
+ * 4. Copy static assets
+ * 5. Update cache manifest
  *
  * @param options - Build configuration options
+ * @returns Promise resolving to build statistics
+ * @throws {Error} When configuration is invalid
+ * @throws {Error} When template rendering fails
+ * @throws {Error} When build lock cannot be acquired
  *
  * @example
  * ```typescript
- * import { build } from 'stati';
- *
- * // Basic build
- * await build();
- *
- * // Build with options
- * await build({
- *   clean: true,
+ * const stats = await build({
  *   force: true,
- *   configPath: './custom.config.js'
+ *   clean: true,
+ *   includeDrafts: false
  * });
+ * console.log(`Built ${stats.pageCount} pages in ${stats.buildTime}ms`);
  * ```
- *
- * @throws {Error} When configuration loading fails
- * @throws {Error} When content processing fails
- * @throws {Error} When template rendering fails
- * @throws {Error} When build lock cannot be acquired
  */
 export declare function build(options?: BuildOptions): Promise<BuildStats>;
 //# sourceMappingURL=build.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/core/build.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAgB,UAAU,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAEpE;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA2HD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAQ3E"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/core/build.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAgB,UAAU,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAEpE;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA2HD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAW3E"}

package/dist/core/build.js

@@ -112,34 +112,40 @@ function formatBuildStats(stats) {
     return output;
 }
 /**
- * Builds the static site by processing content files and generating HTML pages.
- * This is the main entry point for Stati's build process.
+ * Builds the Stati site with ISG support.
+ * Processes all pages and assets, with smart caching for incremental builds.
+ *
  * Uses build locking to prevent concurrent builds from corrupting cache.
+ * The manifest tracks build dependencies and cache entries for efficient rebuilds.
+ * Pages are only rebuilt if their content, templates, or dependencies have changed.
+ *
+ * Build process:
+ * 1. Load configuration and content
+ * 2. Check cache manifest for existing entries
+ * 3. Process each page (rebuild only if needed)
+ * 4. Copy static assets
+ * 5. Update cache manifest
  *
  * @param options - Build configuration options
+ * @returns Promise resolving to build statistics
+ * @throws {Error} When configuration is invalid
+ * @throws {Error} When template rendering fails
+ * @throws {Error} When build lock cannot be acquired
  *
  * @example
  * ```typescript
- * import { build } from 'stati';
- *
- * // Basic build
- * await build();
- *
- * // Build with options
- * await build({
- *   clean: true,
+ * const stats = await build({
  *   force: true,
- *   configPath: './custom.config.js'
+ *   clean: true,
+ *   includeDrafts: false
  * });
+ * console.log(`Built ${stats.pageCount} pages in ${stats.buildTime}ms`);
  * ```
- *
- * @throws {Error} When configuration loading fails
- * @throws {Error} When content processing fails
- * @throws {Error} When template rendering fails
- * @throws {Error} When build lock cannot be acquired
  */
 export async function build(options = {}) {
     const cacheDir = join(process.cwd(), '.stati');
+    // Ensure cache directory exists before acquiring build lock
+    await ensureDir(cacheDir);
     // Use build lock to prevent concurrent builds, with force option to override
     return await withBuildLock(cacheDir, () => buildInternal(options), {
         force: Boolean(options.force || options.clean), // Allow force if user explicitly requests it

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,aAAa,CAAC;AAMvD,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;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC,CA0ZxF"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/core/dev.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAe,MAAM,EAAE,MAAM,aAAa,CAAC;AAMvD,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;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC,CAoaxF"}

package/dist/core/dev.js

@@ -71,17 +71,30 @@ export async function createDevServer(options = {}) {
             return;
         }
         isBuilding = true;
+        const startTime = Date.now();
+        // Create a quiet logger for dev builds that suppresses verbose output
+        const devLogger = {
+            info: () => { }, // Suppress info messages
+            success: () => { }, // Suppress success messages
+            error: logger.error || (() => { }),
+            warning: logger.warning || (() => { }),
+            building: () => { }, // Suppress building messages
+            processing: () => { }, // Suppress processing messages
+            stats: () => { }, // Suppress stats messages
+        };
         try {
+            const relativePath = changedPath
+                .replace(process.cwd(), '')
+                .replace(/\\/g, '/')
+                .replace(/^\//, '');
             // Check if the changed file is a template/partial
             if (changedPath.endsWith('.eta') || changedPath.includes('_partials')) {
-                logger.info?.(`🎨 Template changed: ${changedPath}`);
-                await handleTemplateChange(changedPath);
+                await handleTemplateChange(changedPath, devLogger);
             }
             else {
                 // Content or static file changed - use normal rebuild
-                logger.info?.(`📄 Content changed: ${changedPath}`);
                 await build({
-                    logger,
+                    logger: devLogger,
                     force: false,
                     clean: false,
                     ...(configPath && { configPath }),
@@ -97,10 +110,12 @@ export async function createDevServer(options = {}) {
                     }
                 });
             }
-            logger.success?.('Rebuild complete');
+            const duration = Date.now() - startTime;
+            logger.info?.(`⚡ ${relativePath} rebuilt in ${duration}ms`);
         }
         catch (error) {
-            logger.error?.(`Rebuild failed: ${error instanceof Error ? error.message : String(error)}`);
+            const duration = Date.now() - startTime;
+            logger.error?.(`❌ Rebuild failed after ${duration}ms: ${error instanceof Error ? error.message : String(error)}`);
         }
         finally {
             isBuilding = false;
@@ -109,16 +124,16 @@ export async function createDevServer(options = {}) {
     /**
      * Handles template/partial file changes by invalidating affected pages
      */
-    async function handleTemplateChange(templatePath) {
+    async function handleTemplateChange(templatePath, buildLogger) {
         const cacheDir = join(process.cwd(), '.stati');
+        const effectiveLogger = buildLogger || logger;
         try {
             // Load existing cache manifest
             let cacheManifest = await loadCacheManifest(cacheDir);
             if (!cacheManifest) {
                 // No cache exists, perform full rebuild
-                logger.info?.('No cache found, performing full rebuild...');
                 await build({
-                    logger,
+                    logger: effectiveLogger,
                     force: false,
                     clean: false,
                     ...(configPath && { configPath }),
@@ -135,27 +150,21 @@ export async function createDevServer(options = {}) {
                 }
             }
             if (affectedPages.length > 0) {
-                logger.info?.(`🎯 Invalidating ${affectedPages.length} affected pages:`);
-                affectedPages.forEach((page) => logger.info?.(`   📄 ${page}`));
                 // Save updated cache manifest
                 await saveCacheManifest(cacheDir, cacheManifest);
                 // Perform incremental rebuild (only affected pages will be rebuilt)
                 await build({
-                    logger,
+                    logger: effectiveLogger,
                     force: false,
                     clean: false,
                     ...(configPath && { configPath }),
                 });
             }
-            else {
-                logger.info?.('ℹ️  No pages affected by template change');
-            }
         }
-        catch (error) {
-            logger.warning?.(`Template dependency analysis failed, performing full rebuild: ${error instanceof Error ? error.message : String(error)}`);
+        catch {
             // Fallback to full rebuild
             await build({
-                logger,
+                logger: effectiveLogger,
                 force: false,
                 clean: false,
                 ...(configPath && { configPath }),

package/dist/core/isg/build-lock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-lock.d.ts","sourceRoot":"","sources":["../../../src/core/isg/build-lock.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,UAAU,SAAS;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,MAAM;IAI5B;;;;;;;;;;;;;;;;;;;OAmBG;IACG,WAAW,CAAC,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAoDrF;;;;;;;OAOG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBlC;;;;;;;;;;;OAWG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAiBpC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAY9C;;;OAGG;YACW,eAAe;IAQ7B;;OAEG;YACW,cAAc;IAW5B;;OAEG;YACW,YAAY;IAS1B;;OAEG;YACW,gBAAgB;IAY9B;;OAEG;IACH,OAAO,CAAC,WAAW;IAQnB;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAClD,OAAO,CAAC,CAAC,CAAC,CASZ"}
+{"version":3,"file":"build-lock.d.ts","sourceRoot":"","sources":["../../../src/core/isg/build-lock.ts"],"names":[],"mappings":"AAYA;;GAEG;AACH,UAAU,SAAS;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,MAAM;IAI5B;;;;;;;;;;;;;;;;;;;OAmBG;IACG,WAAW,CAAC,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAoDrF;;;;;;;OAOG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBlC;;;;;;;;;;;OAWG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAiBpC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAY9C;;;OAGG;YACW,eAAe;IAQ7B;;OAEG;YACW,cAAc;IAc5B;;OAEG;YACW,YAAY;IAS1B;;OAEG;YACW,gBAAgB;IAY9B;;OAEG;IACH,OAAO,CAAC,WAAW;IAQnB;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAClD,OAAO,CAAC,CAAC,CAAC,CASZ"}

package/dist/core/isg/build-lock.js

@@ -1,6 +1,6 @@
 import fse from 'fs-extra';
-const { writeFile, readFile, pathExists, remove } = fse;
-import { join } from 'path';
+const { writeFile, readFile, pathExists, remove, ensureDir } = fse;
+import { join, dirname } from 'path';
 import { hostname } from 'os';
 /**
  * Manages build process locking to prevent concurrent Stati builds from corrupting cache.
@@ -167,6 +167,8 @@ export class BuildLockManager {
             timestamp: new Date().toISOString(),
             hostname: this.getHostname(),
         };
+        // Ensure the cache directory exists before creating the lock file
+        await ensureDir(dirname(this.lockPath));
         // Use 'wx' flag to create file exclusively (fails if exists)
         await writeFile(this.lockPath, JSON.stringify(lockInfo, null, 2), { flag: 'wx' });
     }

package/package.json

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