@stati/core 1.21.0 → 1.22.0

package/dist/metrics/utils/index.d.ts

@@ -6,4 +6,5 @@
 export { isCI, getGitCommit, getGitBranch, getCpuCount, getPlatform, getArch, getMemoryUsage, getNodeVersion, } from './system.utils.js';
 export { DEFAULT_METRICS_DIR, generateMetricsFilename, writeMetrics } from './writer.utils.js';
 export type { WriteMetricsOptions, WriteMetricsResult } from './writer.utils.js';
+export { generateMetricsHtml, writeMetricsHtml } from './html-report.utils.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/metrics/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/metrics/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,IAAI,EACJ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,EACX,OAAO,EACP,cAAc,EACd,cAAc,GACf,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE/F,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/metrics/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,IAAI,EACJ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,EACX,OAAO,EACP,cAAc,EACd,cAAc,GACf,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE/F,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGjF,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/metrics/utils/index.js

@@ -7,3 +7,5 @@
 export { isCI, getGitCommit, getGitBranch, getCpuCount, getPlatform, getArch, getMemoryUsage, getNodeVersion, } from './system.utils.js';
 // Writer utilities
 export { DEFAULT_METRICS_DIR, generateMetricsFilename, writeMetrics } from './writer.utils.js';
+// HTML report utilities
+export { generateMetricsHtml, writeMetricsHtml } from './html-report.utils.js';

package/dist/metrics/utils/writer.utils.d.ts

@@ -25,6 +25,8 @@ export interface WriteMetricsOptions {
     outputPath?: string | undefined;
     /** Format: json (default) or ndjson */
     format?: 'json' | 'ndjson' | undefined;
+    /** Whether to also generate an HTML report (default: false, requires --metrics-html flag) */
+    generateHtml?: boolean | undefined;
 }
 /**
  * Result of metrics write operation.
@@ -32,15 +34,16 @@ export interface WriteMetricsOptions {
 export interface WriteMetricsResult {
     success: boolean;
     path?: string;
+    htmlPath?: string;
     error?: string;
 }
 /**
- * Write build metrics to a JSON file.
+ * Write build metrics to a JSON file and optionally an HTML report.
  * Degrades gracefully on failure - logs warning but doesn't throw.
  *
  * @param metrics - The metrics to write
  * @param options - Write options
- * @returns Result indicating success/failure and path
+ * @returns Result indicating success/failure and paths
  *
  * @example
  * ```typescript
@@ -50,6 +53,7 @@ export interface WriteMetricsResult {
  *
  * if (result.success) {
  *   console.log(`Metrics written to ${result.path}`);
+ *   console.log(`HTML report: ${result.htmlPath}`);
  * }
  * ```
  */

package/dist/metrics/utils/writer.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"writer.utils.d.ts","sourceRoot":"","sources":["../../../src/metrics/utils/writer.utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAE7C;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAIlF;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CA2C7B"}
+{"version":3,"file":"writer.utils.d.ts","sourceRoot":"","sources":["../../../src/metrics/utils/writer.utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD;;GAEG;AACH,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAE7C;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAIlF;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IACvC,6FAA6F;IAC7F,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CA0D7B"}

package/dist/metrics/utils/writer.utils.js

@@ -4,6 +4,7 @@
  */
 import { writeFile, mkdir } from 'node:fs/promises';
 import { join, dirname } from 'node:path';
+import { generateMetricsHtml } from './html-report.utils.js';
 /**
  * Default metrics output directory (relative to cache dir).
  */
@@ -21,12 +22,12 @@ export function generateMetricsFilename(command, timestamp) {
     return `${command}-${safeTimestamp}.json`;
 }
 /**
- * Write build metrics to a JSON file.
+ * Write build metrics to a JSON file and optionally an HTML report.
  * Degrades gracefully on failure - logs warning but doesn't throw.
  *
  * @param metrics - The metrics to write
  * @param options - Write options
- * @returns Result indicating success/failure and path
+ * @returns Result indicating success/failure and paths
  *
  * @example
  * ```typescript
@@ -36,6 +37,7 @@ export function generateMetricsFilename(command, timestamp) {
  *
  * if (result.success) {
  *   console.log(`Metrics written to ${result.path}`);
+ *   console.log(`HTML report: ${result.htmlPath}`);
  * }
  * ```
  */
@@ -64,12 +66,26 @@ export async function writeMetrics(metrics, options) {
             // JSON: pretty printed for readability
             content = JSON.stringify(metrics, null, 2) + '\n';
         }
-        // Write file
+        // Write JSON file
         await writeFile(outputPath, content, 'utf-8');
-        return {
+        const result = {
             success: true,
             path: outputPath,
         };
+        // Generate HTML report if explicitly enabled
+        const shouldGenerateHtml = options.generateHtml === true;
+        if (shouldGenerateHtml) {
+            try {
+                const htmlPath = outputPath.replace(/\.json$/, '.html');
+                const htmlContent = generateMetricsHtml(metrics);
+                await writeFile(htmlPath, htmlContent, 'utf-8');
+                result.htmlPath = htmlPath;
+            }
+            catch {
+                // HTML generation failure is non-critical, don't fail the whole operation
+            }
+        }
+        return result;
     }
     catch (error) {
         // Graceful degradation - don't throw, just report failure

package/dist/search/generator.d.ts

@@ -70,15 +70,7 @@ export interface SearchablePage {
  * @returns SearchIndex object
  */
 export declare function generateSearchIndex(searchablePages: SearchablePage[], config: SearchConfig): SearchIndex;
-/**
- * Writes the search index to a JSON file.
- *
- * @param searchIndex - The search index to write
- * @param outDir - Output directory path
- * @param filename - Pre-computed filename (from computeSearchIndexFilename)
- * @returns Metadata about the written search index
- */
-export declare function writeSearchIndex(searchIndex: SearchIndex, outDir: string, filename: string): Promise<SearchIndexMetadata>;
+export declare function writeSearchIndex(searchIndex: SearchIndex, outDir: string, filename: string, skipIfUnchanged?: boolean): Promise<SearchIndexMetadata>;
 /**
  * Computes the search index filename based on configuration.
  * When hashFilename is true, generates a deterministic hash based on the build ID.

package/dist/search/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/search/generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EACX,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAuBtE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA0CtD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,QAAQ,EAAE,EACf,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EACnC,MAAM,EAAE,YAAY,GACnB,cAAc,EAAE,CAiGlB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAsBhF;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,IAAI,EAAE,SAAS,CAAC;IAChB,oEAAoE;IACpE,GAAG,EAAE,QAAQ,EAAE,CAAC;IAChB,kDAAkD;IAClD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,eAAe,EAAE,cAAc,EAAE,EACjC,MAAM,EAAE,YAAY,GACnB,WAAW,CA6Bb;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,mBAAmB,CAAC,CAgB9B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAczF"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/search/generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EACX,mBAAmB,EACpB,MAAM,oBAAoB,CAAC;AAE5B;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAuBtE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA0CtD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,QAAQ,EAAE,EACf,eAAe,EAAE,MAAM,EACvB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EACnC,MAAM,EAAE,YAAY,GACnB,cAAc,EAAE,CAiGlB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAsBhF;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,IAAI,EAAE,SAAS,CAAC;IAChB,oEAAoE;IACpE,GAAG,EAAE,QAAQ,EAAE,CAAC;IAChB,kDAAkD;IAClD,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,eAAe,EAAE,cAAc,EAAE,EACjC,MAAM,EAAE,YAAY,GACnB,WAAW,CA6Bb;AAiBD,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,eAAe,UAAQ,GACtB,OAAO,CAAC,mBAAmB,CAAC,CAqC9B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAczF"}

package/dist/search/generator.js

@@ -225,15 +225,39 @@ export function generateSearchIndex(searchablePages, config) {
 }
 /**
  * Writes the search index to a JSON file.
+ * Skips write if content hasn't changed (dev mode optimization).
  *
  * @param searchIndex - The search index to write
  * @param outDir - Output directory path
  * @param filename - Pre-computed filename (from computeSearchIndexFilename)
+ * @param skipIfUnchanged - If true, skip write when document count matches previous
  * @returns Metadata about the written search index
  */
-export async function writeSearchIndex(searchIndex, outDir, filename) {
-    // Serialize index
+// Cache for search index state (dev mode optimization)
+let lastSearchIndexDocCount = null;
+let lastSearchIndexContentHash = null;
+export async function writeSearchIndex(searchIndex, outDir, filename, skipIfUnchanged = false) {
+    // Serialize full index for hash computation and potential write
     const content = JSON.stringify(searchIndex, null, 0);
+    // Skip write if content hash hasn't changed (dev mode optimization)
+    // Uses fast MD5 hash to detect actual content changes, not just count
+    if (skipIfUnchanged && lastSearchIndexDocCount === searchIndex.documentCount) {
+        const contentHash = generateContentHash(content);
+        if (contentHash === lastSearchIndexContentHash) {
+            return {
+                enabled: true,
+                indexPath: `/${filename}`,
+                documentCount: searchIndex.documentCount,
+            };
+        }
+        // Count matched but content changed - update hash and proceed to write
+        lastSearchIndexContentHash = contentHash;
+    }
+    // Update cached state
+    lastSearchIndexDocCount = searchIndex.documentCount;
+    if (skipIfUnchanged && !lastSearchIndexContentHash) {
+        lastSearchIndexContentHash = generateContentHash(content);
+    }
     // Ensure output directory exists
     await ensureDir(outDir);
     // Write the file

package/package.json

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