@stati/core 1.2.0 → 1.3.0

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/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.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",