@stati/core 1.16.3 → 1.18.0

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

@@ -0,0 +1,22 @@
+/**
+ * Slugify utilities for generating URL-friendly anchor IDs.
+ * @module core/utils/slugify
+ */
+/**
+ * Converts a string to a URL-friendly slug.
+ * Used for generating heading anchor IDs.
+ *
+ * @param text - The text to slugify
+ * @returns A URL-friendly slug
+ *
+ * @example
+ * ```typescript
+ * slugify('Hello World') // 'hello-world'
+ * slugify('Getting Started!') // 'getting-started'
+ * slugify('  Multiple   Spaces  ') // 'multiple-spaces'
+ * slugify('Héllo Wörld') // 'hello-world'
+ * slugify('Cats & Dogs') // 'cats-and-dogs'
+ * ```
+ */
+export declare function slugify(text: string): string;
+//# sourceMappingURL=slugify.utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slugify.utils.d.ts","sourceRoot":"","sources":["../../../src/core/utils/slugify.utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAyDH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAqC5C"}

package/dist/core/utils/slugify.utils.js

@@ -0,0 +1,108 @@
+/**
+ * Slugify utilities for generating URL-friendly anchor IDs.
+ * @module core/utils/slugify
+ */
+/**
+ * Common character transliteration map for accented/special characters.
+ */
+const TRANSLITERATION_MAP = {
+    // Latin extended characters
+    à: 'a',
+    á: 'a',
+    â: 'a',
+    ã: 'a',
+    ä: 'a',
+    å: 'a',
+    æ: 'ae',
+    ç: 'c',
+    č: 'c',
+    ć: 'c',
+    ð: 'd',
+    đ: 'd',
+    è: 'e',
+    é: 'e',
+    ê: 'e',
+    ë: 'e',
+    ě: 'e',
+    ì: 'i',
+    í: 'i',
+    î: 'i',
+    ï: 'i',
+    ł: 'l',
+    ñ: 'n',
+    ń: 'n',
+    ò: 'o',
+    ó: 'o',
+    ô: 'o',
+    õ: 'o',
+    ö: 'o',
+    ø: 'o',
+    œ: 'oe',
+    ř: 'r',
+    š: 's',
+    ś: 's',
+    ß: 'ss',
+    ù: 'u',
+    ú: 'u',
+    û: 'u',
+    ü: 'u',
+    ů: 'u',
+    ű: 'u',
+    ý: 'y',
+    ÿ: 'y',
+    ž: 'z',
+    ź: 'z',
+    ż: 'z',
+    // Additional common characters
+    þ: 'th',
+};
+/**
+ * Converts a string to a URL-friendly slug.
+ * Used for generating heading anchor IDs.
+ *
+ * @param text - The text to slugify
+ * @returns A URL-friendly slug
+ *
+ * @example
+ * ```typescript
+ * slugify('Hello World') // 'hello-world'
+ * slugify('Getting Started!') // 'getting-started'
+ * slugify('  Multiple   Spaces  ') // 'multiple-spaces'
+ * slugify('Héllo Wörld') // 'hello-world'
+ * slugify('Cats & Dogs') // 'cats-and-dogs'
+ * ```
+ */
+export function slugify(text) {
+    // Handle null, undefined, or non-string input defensively
+    if (text === null || text === undefined) {
+        return '';
+    }
+    // Coerce to string if needed
+    const input = String(text);
+    return (input
+        .toLowerCase()
+        .trim()
+        // Normalize unicode (NFD decomposes, then we handle diacritics)
+        .normalize('NFD')
+        // Apply transliteration map for known characters
+        // eslint-disable-next-line no-control-regex
+        .replace(/[^\u0000-\u007F]/g, (char) => {
+        // First check our transliteration map
+        if (TRANSLITERATION_MAP[char]) {
+            return TRANSLITERATION_MAP[char];
+        }
+        // Remove combining diacritical marks (accents) that remain after NFD normalization
+        if (/[\u0300-\u036f]/.test(char)) {
+            return '';
+        }
+        // Replace other non-ASCII characters (emojis, symbols, CJK, etc.) with space
+        // to avoid creating consecutive dashes
+        return ' ';
+    })
+        // Replace & with 'and' (handle case where it wasn't caught by transliteration)
+        .replace(/&/g, '-and-')
+        // Replace any sequence of whitespace or non-word characters with a single dash
+        .replace(/[\s\W-]+/g, '-')
+        // Remove leading and trailing dashes
+        .replace(/^-+|-+$/g, ''));
+}

package/dist/index.d.ts

@@ -23,8 +23,10 @@ export type { StatiConfig, PageModel, FrontMatter, BuildContext, PageContext, Bu
 export type { SEOMetadata, SEOConfig, SEOContext, SEOValidationResult, SEOTagType, RobotsConfig, OpenGraphConfig, OpenGraphImage, OpenGraphArticle, TwitterCardConfig, AuthorConfig, } from './types/index.js';
 export type { SitemapConfig, SitemapEntry, SitemapGenerationResult, ChangeFrequency, } from './types/index.js';
 export type { RSSConfig, RSSFeedConfig, RSSGenerationResult } from './types/index.js';
-export type { BuildOptions, DevServerOptions, PreviewServerOptions, InvalidationResult, } from './core/index.js';
+export type { BuildOptions, MetricsOptions, BuildResult, DevServerOptions, PreviewServerOptions, InvalidationResult, } from './core/index.js';
 export { build, createDevServer, createPreviewServer, invalidate } from './core/index.js';
+export type { BuildMetrics, MetricsMeta, MetricsFlags, MetricsTotals, MetricsPhases, MetricsCounts, MetricsISG, PageTiming, IncrementalMetrics, MetricRecorder, MetricRecorderOptions, PhaseName, CounterName, } from './metrics/index.js';
+export { createMetricRecorder, noopMetricRecorder, writeMetrics, formatMetricsSummary, } from './metrics/index.js';
 export type { AutoInjectOptions } from './seo/index.js';
 export { generateSEOMetadata, generateSEO, generateOpenGraphTags, generateTwitterCardTags, generateSitemap, generateSitemapEntry, generateSitemapXml, generateSitemapIndexXml, generateRobotsTxt, generateRobotsTxtFromConfig, escapeHtml, generateRobotsContent, validateSEOMetadata, detectExistingSEOTags, normalizeUrlPath, resolveAbsoluteUrl, isValidUrl, autoInjectSEO, shouldAutoInject, } from './seo/index.js';
 export type { RSSValidationResult } from './rss/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,EACV,YAAY,GACb,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,mBAAmB,EACnB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,GACb,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,aAAa,EACb,YAAY,EACZ,uBAAuB,EACvB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGtF,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG1F,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,2BAA2B,EAC3B,UAAU,EACV,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,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"}
+{"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,EACV,YAAY,GACb,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EACV,WAAW,EACX,SAAS,EACT,UAAU,EACV,mBAAmB,EACnB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,GACb,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,aAAa,EACb,YAAY,EACZ,uBAAuB,EACvB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGtF,YAAY,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG1F,YAAY,EACV,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,aAAa,EACb,aAAa,EACb,aAAa,EACb,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,SAAS,EACT,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACZ,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,EACvB,iBAAiB,EACjB,2BAA2B,EAC3B,UAAU,EACV,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAGxB,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,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

@@ -20,6 +20,7 @@
  * ```
  */
 export { build, createDevServer, createPreviewServer, invalidate } from './core/index.js';
+export { createMetricRecorder, noopMetricRecorder, writeMetrics, formatMetricsSummary, } from './metrics/index.js';
 export { generateSEOMetadata, generateSEO, generateOpenGraphTags, generateTwitterCardTags, generateSitemap, generateSitemapEntry, generateSitemapXml, generateSitemapIndexXml, generateRobotsTxt, generateRobotsTxtFromConfig, escapeHtml, generateRobotsContent, validateSEOMetadata, detectExistingSEOTags, normalizeUrlPath, resolveAbsoluteUrl, isValidUrl, autoInjectSEO, shouldAutoInject, } from './seo/index.js';
 export { generateRSSFeed, generateRSSFeeds, validateRSSConfig, validateRSSFeedConfig, } from './rss/index.js';
 // Re-export config and env utilities

package/dist/metrics/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Stati Build Metrics System
+ *
+ * Provides performance measurement and reporting for Stati builds.
+ * Uses Node.js built-ins only - no external dependencies.
+ *
+ * @example Basic Usage
+ * ```typescript
+ * import { createMetricRecorder, writeMetrics, formatMetricsSummary } from '@stati/core';
+ *
+ * // Create recorder (noop when disabled)
+ * const recorder = createMetricRecorder({ enabled: true });
+ *
+ * // Record phases with spans
+ * const endConfig = recorder.startSpan('configLoadMs');
+ * await loadConfig();
+ * endConfig();
+ *
+ * // Increment counters
+ * recorder.increment('renderedPages');
+ *
+ * // Finalize and write
+ * const metrics = recorder.finalize();
+ * await writeMetrics(metrics, { cacheDir: '.stati' });
+ *
+ * // Format for CLI
+ * const summary = formatMetricsSummary(metrics);
+ * summary.forEach(line => console.log(line));
+ * ```
+ *
+ * @packageDocumentation
+ */
+export type { BuildMetrics, MetricsMeta, MetricsFlags, MetricsTotals, MetricsPhases, MetricsCounts, MetricsISG, PageTiming, IncrementalMetrics, MetricRecorder, MetricRecorderOptions, PhaseName, CounterName, GaugeName, } from './types.js';
+export { createMetricRecorder } from './recorder.js';
+export { noopMetricRecorder } from './noop.js';
+export { writeMetrics, formatMetricsSummary, generateMetricsFilename, DEFAULT_METRICS_DIR, isCI, getGitCommit, getGitBranch, getCpuCount, getPlatform, getArch, getNodeVersion, getMemoryUsage, } from './utils/index.js';
+export type { WriteMetricsOptions, WriteMetricsResult } from './utils/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,YAAY,EACV,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,aAAa,EACb,aAAa,EACb,aAAa,EACb,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,SAAS,EACT,WAAW,EACX,SAAS,GACV,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAGrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAG/C,OAAO,EAEL,YAAY,EACZ,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EAEnB,IAAI,EACJ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,EACX,OAAO,EACP,cAAc,EACd,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/metrics/index.js

@@ -0,0 +1,42 @@
+/**
+ * Stati Build Metrics System
+ *
+ * Provides performance measurement and reporting for Stati builds.
+ * Uses Node.js built-ins only - no external dependencies.
+ *
+ * @example Basic Usage
+ * ```typescript
+ * import { createMetricRecorder, writeMetrics, formatMetricsSummary } from '@stati/core';
+ *
+ * // Create recorder (noop when disabled)
+ * const recorder = createMetricRecorder({ enabled: true });
+ *
+ * // Record phases with spans
+ * const endConfig = recorder.startSpan('configLoadMs');
+ * await loadConfig();
+ * endConfig();
+ *
+ * // Increment counters
+ * recorder.increment('renderedPages');
+ *
+ * // Finalize and write
+ * const metrics = recorder.finalize();
+ * await writeMetrics(metrics, { cacheDir: '.stati' });
+ *
+ * // Format for CLI
+ * const summary = formatMetricsSummary(metrics);
+ * summary.forEach(line => console.log(line));
+ * ```
+ *
+ * @packageDocumentation
+ */
+// Recorder factory
+export { createMetricRecorder } from './recorder.js';
+// Noop recorder singleton
+export { noopMetricRecorder } from './noop.js';
+// Utilities (file writing, system info)
+export { 
+// Writer utilities
+writeMetrics, formatMetricsSummary, generateMetricsFilename, DEFAULT_METRICS_DIR, 
+// System utilities
+isCI, getGitCommit, getGitBranch, getCpuCount, getPlatform, getArch, getNodeVersion, getMemoryUsage, } from './utils/index.js';

package/dist/metrics/noop.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Noop MetricRecorder implementation.
+ * Used when metrics collection is disabled - has zero overhead.
+ * (Null Object Pattern)
+ */
+import type { MetricRecorder } from './types.js';
+/**
+ * Singleton noop recorder instance.
+ * Use this when metrics are disabled for zero-overhead operation.
+ */
+export declare const noopMetricRecorder: MetricRecorder;
+//# sourceMappingURL=noop.d.ts.map

package/dist/metrics/noop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.d.ts","sourceRoot":"","sources":["../../src/metrics/noop.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,cAAc,EAOf,MAAM,YAAY,CAAC;AAiGpB;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,cAAyC,CAAC"}

package/dist/metrics/noop.js

@@ -0,0 +1,88 @@
+/**
+ * Noop MetricRecorder implementation.
+ * Used when metrics collection is disabled - has zero overhead.
+ * (Null Object Pattern)
+ */
+/**
+ * Empty function that does nothing.
+ */
+const noop = () => {
+    /* intentionally empty */
+};
+/**
+ * Noop implementation of MetricRecorder.
+ * All methods are no-ops with minimal overhead.
+ */
+class NoopMetricRecorder {
+    enabled = false;
+    detailed = false;
+    startSpan(_name) {
+        return noop;
+    }
+    recordPhase(_name, _durationMs) {
+        /* noop */
+    }
+    addToPhase(_name, _durationMs) {
+        /* noop */
+    }
+    increment(_name, _amount) {
+        /* noop */
+    }
+    setGauge(_name, _value) {
+        /* noop */
+    }
+    recordPageTiming(_url, _durationMs, _cached, _templatesLoaded) {
+        /* noop */
+    }
+    snapshotMemory() {
+        /* noop */
+    }
+    setISGMetrics(_metrics) {
+        /* noop */
+    }
+    setIncrementalMetrics(_metrics) {
+        /* noop */
+    }
+    finalize() {
+        // Return minimal valid metrics object
+        return {
+            schemaVersion: '1',
+            meta: {
+                timestamp: new Date().toISOString(),
+                ci: false,
+                nodeVersion: process.version.replace(/^v/, ''),
+                platform: process.platform,
+                arch: process.arch,
+                cpuCount: 1,
+                statiVersion: 'unknown',
+                command: 'build',
+                flags: {},
+            },
+            totals: {
+                durationMs: 0,
+                peakRssBytes: 0,
+                heapUsedBytes: 0,
+            },
+            phases: {},
+            counts: {
+                totalPages: 0,
+                renderedPages: 0,
+                cachedPages: 0,
+                assetsCopied: 0,
+                templatesLoaded: 0,
+                markdownFilesProcessed: 0,
+            },
+            isg: {
+                enabled: false,
+                cacheHitRate: 0,
+                manifestEntries: 0,
+                invalidatedEntries: 0,
+            },
+        };
+    }
+}
+/**
+ * Singleton noop recorder instance.
+ * Use this when metrics are disabled for zero-overhead operation.
+ */
+export const noopMetricRecorder = new NoopMetricRecorder();

package/dist/metrics/recorder.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Active MetricRecorder implementation.
+ * Uses performance.now() from node:perf_hooks for high-resolution timing.
+ */
+import type { MetricRecorder, MetricRecorderOptions } from './types.js';
+/**
+ * Create a MetricRecorder instance.
+ * Returns a noop recorder when disabled for zero overhead.
+ *
+ * @param options - Recorder configuration
+ * @returns MetricRecorder instance
+ *
+ * @example
+ * ```typescript
+ * // Create an enabled recorder
+ * const recorder = createMetricRecorder({ enabled: true });
+ *
+ * // Start a span
+ * const endSpan = recorder.startSpan('configLoadMs');
+ * await loadConfig();
+ * endSpan(); // Records duration
+ *
+ * // Increment counters
+ * recorder.increment('renderedPages');
+ *
+ * // Finalize and get metrics
+ * const metrics = recorder.finalize();
+ * ```
+ */
+export declare function createMetricRecorder(options?: MetricRecorderOptions): MetricRecorder;
+//# sourceMappingURL=recorder.d.ts.map

package/dist/metrics/recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../../src/metrics/recorder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EAQtB,MAAM,YAAY,CAAC;AAiNpB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,qBAA0B,GAAG,cAAc,CAaxF"}

package/dist/metrics/recorder.js

@@ -0,0 +1,176 @@
+/**
+ * Active MetricRecorder implementation.
+ * Uses performance.now() from node:perf_hooks for high-resolution timing.
+ */
+import { performance } from 'node:perf_hooks';
+import { isCI, getGitCommit, getGitBranch, getCpuCount, getPlatform, getArch, getNodeVersion, getMemoryUsage, } from './utils/index.js';
+import { noopMetricRecorder } from './noop.js';
+/**
+ * Active metric recorder that collects build performance data.
+ */
+class ActiveMetricRecorder {
+    enabled = true;
+    detailed;
+    startTime;
+    command;
+    flags;
+    statiVersion;
+    phases = {};
+    counts = {
+        totalPages: 0,
+        renderedPages: 0,
+        cachedPages: 0,
+        assetsCopied: 0,
+        templatesLoaded: 0,
+        markdownFilesProcessed: 0,
+    };
+    isgMetrics = {
+        enabled: false,
+        cacheHitRate: 0,
+        manifestEntries: 0,
+        invalidatedEntries: 0,
+    };
+    incrementalMetrics;
+    pageTimings = [];
+    gauges = new Map();
+    constructor(options = {}) {
+        this.startTime = performance.now();
+        this.detailed = options.detailed ?? false;
+        this.command = options.command ?? 'build';
+        this.flags = options.flags ?? {};
+        this.statiVersion = options.statiVersion ?? 'unknown';
+        // Take initial memory snapshot
+        this.snapshotMemory();
+    }
+    startSpan(name) {
+        const spanStart = performance.now();
+        return () => {
+            const duration = performance.now() - spanStart;
+            this.recordPhase(name, duration);
+        };
+    }
+    recordPhase(name, durationMs) {
+        // Record phase timing using the phase name directly (replaces)
+        this.phases[name] = durationMs;
+    }
+    addToPhase(name, durationMs) {
+        // Add to existing phase timing (accumulates)
+        const current = this.phases[name] ?? 0;
+        this.phases[name] = current + durationMs;
+    }
+    increment(name, amount = 1) {
+        const current = this.counts[name] ?? 0;
+        this.counts[name] = current + amount;
+    }
+    setGauge(name, value) {
+        // Gauges track the maximum value observed for a given name
+        const current = this.gauges.get(name) ?? 0;
+        this.gauges.set(name, Math.max(current, value));
+    }
+    recordPageTiming(url, durationMs, cached, templatesLoaded) {
+        if (this.detailed) {
+            const timing = { url, durationMs, cached };
+            if (templatesLoaded !== undefined) {
+                this.pageTimings.push({ ...timing, templatesLoaded });
+            }
+            else {
+                this.pageTimings.push(timing);
+            }
+        }
+    }
+    snapshotMemory() {
+        const usage = getMemoryUsage();
+        this.setGauge('peakRss', usage.rss);
+    }
+    setISGMetrics(metrics) {
+        this.isgMetrics = { ...this.isgMetrics, ...metrics };
+    }
+    setIncrementalMetrics(metrics) {
+        this.incrementalMetrics = metrics;
+    }
+    finalize() {
+        // Take final memory snapshot
+        this.snapshotMemory();
+        const finalMemory = getMemoryUsage();
+        const totalDuration = performance.now() - this.startTime;
+        // Build the meta object, excluding undefined git values
+        const gitCommit = getGitCommit();
+        const gitBranch = getGitBranch();
+        const meta = {
+            timestamp: new Date().toISOString(),
+            ci: isCI(),
+            nodeVersion: getNodeVersion(),
+            platform: getPlatform(),
+            arch: getArch(),
+            cpuCount: getCpuCount(),
+            statiVersion: this.statiVersion,
+            command: this.command,
+            flags: this.flags,
+            ...(gitCommit !== undefined && { gitCommit }),
+            ...(gitBranch !== undefined && { gitBranch }),
+        };
+        // Build the base metrics object
+        const baseMetrics = {
+            schemaVersion: '1',
+            meta,
+            totals: {
+                durationMs: totalDuration,
+                peakRssBytes: this.peakRss,
+                heapUsedBytes: finalMemory.heapUsed,
+            },
+            phases: this.phases,
+            counts: this.counts,
+            isg: this.isgMetrics,
+        };
+        // Add optional fields conditionally
+        const optionalFields = {};
+        if (this.detailed && this.pageTimings.length > 0) {
+            optionalFields.pageTimings = this.pageTimings;
+        }
+        if (this.incrementalMetrics) {
+            optionalFields.incremental = this.incrementalMetrics;
+        }
+        return { ...baseMetrics, ...optionalFields };
+    }
+    /**
+     * Get the peak RSS value from gauges.
+     */
+    get peakRss() {
+        return this.gauges.get('peakRss') ?? 0;
+    }
+}
+/**
+ * Create a MetricRecorder instance.
+ * Returns a noop recorder when disabled for zero overhead.
+ *
+ * @param options - Recorder configuration
+ * @returns MetricRecorder instance
+ *
+ * @example
+ * ```typescript
+ * // Create an enabled recorder
+ * const recorder = createMetricRecorder({ enabled: true });
+ *
+ * // Start a span
+ * const endSpan = recorder.startSpan('configLoadMs');
+ * await loadConfig();
+ * endSpan(); // Records duration
+ *
+ * // Increment counters
+ * recorder.increment('renderedPages');
+ *
+ * // Finalize and get metrics
+ * const metrics = recorder.finalize();
+ * ```
+ */
+export function createMetricRecorder(options = {}) {
+    if (options.enabled === false) {
+        return noopMetricRecorder;
+    }
+    // Check environment variable for CI metrics
+    const envEnabled = process.env.STATI_METRICS === '1' || process.env.STATI_METRICS === 'true';
+    if (!options.enabled && !envEnabled) {
+        return noopMetricRecorder;
+    }
+    return new ActiveMetricRecorder(options);
+}