@jasonshimmy/vite-plugin-cer-app 0.23.1 → 0.24.0

package/dist/cli/checks/lighthouse.d.ts

@@ -0,0 +1,26 @@
+export declare const LIGHTHOUSE_CATEGORIES: readonly ["performance", "accessibility", "best-practices", "seo"];
+export declare function median(values: readonly number[]): number;
+export interface LighthouseAuditOptions {
+    root?: string;
+    urls: string[];
+    runs?: number;
+    attempts?: number;
+    preset?: 'desktop';
+    categories?: string[];
+    /** Chromium-family executable. Defaults to CHROME_PATH or a known platform installation. */
+    chromePath?: string;
+}
+export interface LighthouseUrlReport {
+    url: string;
+    medians: Record<string, number>;
+}
+export interface ChromiumDiscoveryOptions {
+    environment?: Record<string, string | undefined>;
+    platform?: NodeJS.Platform;
+    exists?: (path: string) => boolean;
+}
+/** Resolve Chrome, Chromium, Edge, or Brave without requiring a global Chrome install. */
+export declare function findChromiumExecutable(options?: ChromiumDiscoveryOptions): string | undefined;
+/** Run repeatable Lighthouse audits using the application's optional local dependency. */
+export declare function runLighthouseAudit(options: LighthouseAuditOptions): Promise<LighthouseUrlReport[]>;
+//# sourceMappingURL=lighthouse.d.ts.map

package/dist/cli/checks/lighthouse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lighthouse.d.ts","sourceRoot":"","sources":["../../../src/cli/checks/lighthouse.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,qBAAqB,oEAKxB,CAAA;AAEV,wBAAgB,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAIxD;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,4FAA4F;IAC5F,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAChC;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAA;IAC1B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;CACnC;AAED,0FAA0F;AAC1F,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,wBAA6B,GAAG,MAAM,GAAG,SAAS,CA8BjG;AAaD,0FAA0F;AAC1F,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,mBAAmB,EAAE,CAAC,CA4DhC"}

package/dist/cli/checks/lighthouse.js

@@ -0,0 +1,121 @@
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { mkdtemp, readFile, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+export const LIGHTHOUSE_CATEGORIES = [
+    'performance',
+    'accessibility',
+    'best-practices',
+    'seo',
+];
+export function median(values) {
+    if (values.length === 0)
+        return 0;
+    const sorted = [...values].sort((a, b) => a - b);
+    return sorted[Math.floor(sorted.length / 2)];
+}
+/** Resolve Chrome, Chromium, Edge, or Brave without requiring a global Chrome install. */
+export function findChromiumExecutable(options = {}) {
+    const environment = options.environment ?? process.env;
+    const platform = options.platform ?? process.platform;
+    const exists = options.exists ?? existsSync;
+    const explicit = environment.CHROME_PATH?.trim();
+    if (explicit)
+        return explicit;
+    const candidates = platform === 'darwin'
+        ? [
+            '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+            '/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary',
+            '/Applications/Chromium.app/Contents/MacOS/Chromium',
+            '/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge',
+            '/Applications/Brave Browser.app/Contents/MacOS/Brave Browser',
+        ]
+        : platform === 'win32'
+            ? [
+                `${environment.PROGRAMFILES ?? 'C:\\Program Files'}\\Google\\Chrome\\Application\\chrome.exe`,
+                `${environment.PROGRAMFILES ?? 'C:\\Program Files'}\\Microsoft\\Edge\\Application\\msedge.exe`,
+                `${environment.LOCALAPPDATA ?? ''}\\BraveSoftware\\Brave-Browser\\Application\\brave.exe`,
+            ]
+            : [
+                '/usr/bin/google-chrome',
+                '/usr/bin/google-chrome-stable',
+                '/usr/bin/chromium',
+                '/usr/bin/chromium-browser',
+                '/usr/bin/microsoft-edge',
+                '/usr/bin/brave-browser',
+            ];
+    return candidates.find((candidate) => exists(candidate));
+}
+function run(command, args, environment) {
+    return new Promise((resolveRun, reject) => {
+        const child = spawn(command, args, { stdio: 'inherit', env: environment });
+        child.once('error', reject);
+        child.once('exit', (code, signal) => {
+            if (code === 0)
+                resolveRun();
+            else
+                reject(new Error(`${command} exited with ${code ?? signal}`));
+        });
+    });
+}
+/** Run repeatable Lighthouse audits using the application's optional local dependency. */
+export async function runLighthouseAudit(options) {
+    const root = resolve(options.root ?? process.cwd());
+    const cli = join(root, 'node_modules/lighthouse/cli/index.js');
+    const categories = options.categories ?? [...LIGHTHOUSE_CATEGORIES];
+    const runs = Math.max(1, options.runs ?? 3);
+    const attempts = Math.max(1, options.attempts ?? 3);
+    const chromePath = options.chromePath?.trim() || findChromiumExecutable();
+    const environment = chromePath ? { ...process.env, CHROME_PATH: chromePath } : process.env;
+    const reportsDir = await mkdtemp(join(tmpdir(), 'cer-lighthouse-'));
+    const result = [];
+    try {
+        for (const [urlIndex, url] of options.urls.entries()) {
+            const scores = Object.fromEntries(categories.map((category) => [category, []]));
+            for (let runIndex = 0; runIndex < runs; runIndex += 1) {
+                const outputPath = join(reportsDir, `${urlIndex}-${runIndex}.json`);
+                const args = [
+                    cli,
+                    url,
+                    '--quiet',
+                    '--chrome-flags=--headless --no-sandbox',
+                    `--only-categories=${categories.join(',')}`,
+                    '--output=json',
+                    `--output-path=${outputPath}`,
+                ];
+                if (options.preset)
+                    args.push(`--preset=${options.preset}`);
+                let lastError;
+                for (let attempt = 1; attempt <= attempts; attempt += 1) {
+                    try {
+                        await run(process.execPath, args, environment);
+                        lastError = undefined;
+                        break;
+                    }
+                    catch (error) {
+                        lastError = error;
+                        if (attempt < attempts) {
+                            await new Promise((resolveWait) => setTimeout(resolveWait, attempt * 250));
+                        }
+                    }
+                }
+                if (lastError)
+                    throw lastError;
+                const report = JSON.parse(await readFile(outputPath, 'utf8'));
+                for (const category of categories) {
+                    scores[category].push(report.categories[category]?.score ?? 0);
+                }
+            }
+            result.push({
+                url,
+                medians: Object.fromEntries(categories.map((category) => [category, median(scores[category])])),
+            });
+        }
+        return result;
+    }
+    finally {
+        await rm(reportsDir, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=lighthouse.js.map

package/dist/cli/checks/lighthouse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lighthouse.js","sourceRoot":"","sources":["../../../src/cli/checks/lighthouse.ts"],"names":[],"mappings":"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"}

package/dist/cli/checks/links.d.ts

@@ -0,0 +1,12 @@
+export interface BuiltLinksOptions {
+    outputDir?: string;
+    skipTopLevel?: readonly string[];
+}
+export interface BuiltLinksReport {
+    pages: number;
+    links: number;
+    failures: string[];
+}
+/** Validate every internal href and fragment emitted by an SSG build. */
+export declare function checkBuiltLinks(options?: BuiltLinksOptions): Promise<BuiltLinksReport>;
+//# sourceMappingURL=links.d.ts.map

package/dist/cli/checks/links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../../../src/cli/checks/links.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACjC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AA8BD,yEAAyE;AACzE,wBAAsB,eAAe,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA+ChG"}

package/dist/cli/checks/links.js

@@ -0,0 +1,89 @@
+import { access, readFile, readdir, stat } from 'node:fs/promises';
+import { dirname, join, relative, resolve, sep } from 'node:path';
+async function collectHtml(directory, skipped, depth = 0) {
+    const entries = await readdir(directory, { withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        if (depth === 0 && entry.isDirectory() && skipped.has(entry.name))
+            continue;
+        const path = join(directory, entry.name);
+        if (entry.isDirectory())
+            files.push(...await collectHtml(path, skipped, depth + 1));
+        else if (entry.name === 'index.html')
+            files.push(path);
+    }
+    return files;
+}
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function isFile(path) {
+    try {
+        return (await stat(path)).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/** Validate every internal href and fragment emitted by an SSG build. */
+export async function checkBuiltLinks(options = {}) {
+    const outputDir = resolve(options.outputDir ?? 'dist');
+    const skipped = new Set(options.skipTopLevel ?? ['client', 'server', '_content', 'assets']);
+    const pages = await collectHtml(outputDir, skipped);
+    const failures = [];
+    let links = 0;
+    for (const page of pages) {
+        const html = await readFile(page, 'utf8');
+        const relativeDirectory = relative(outputDir, dirname(page)).split(sep).filter(Boolean).join('/');
+        const pageRoute = relativeDirectory ? `/${relativeDirectory}` : '/';
+        const base = new URL(pageRoute.endsWith('/') ? pageRoute : `${pageRoute}/`, 'https://local.test');
+        const hrefs = [...html.matchAll(/\bhref=(?:"([^"]*)"|'([^']*)')/gi)]
+            .map((match) => match[1] ?? match[2]);
+        for (const href of hrefs) {
+            if (!href || /^(?:https?:|mailto:|tel:|data:|javascript:|\/\/)/i.test(href))
+                continue;
+            const url = new URL(href, base);
+            if (url.origin !== base.origin)
+                continue;
+            links += 1;
+            let pathname = url.pathname;
+            try {
+                pathname = decodeURIComponent(pathname);
+            }
+            catch { /* retain encoded path */ }
+            const relativeTarget = pathname.replace(/^\/+/, '');
+            const directTarget = join(outputDir, relativeTarget);
+            const routeTarget = pathname === '/'
+                ? join(outputDir, 'index.html')
+                : join(outputDir, relativeTarget, 'index.html');
+            const target = await isFile(directTarget) ? directTarget : routeTarget;
+            if (!(await exists(target))) {
+                failures.push(`${relative(outputDir, page)} -> ${href} (missing ${relative(outputDir, target)})`);
+                continue;
+            }
+            if (url.hash && target.endsWith('.html')) {
+                let id = url.hash.slice(1);
+                try {
+                    id = decodeURIComponent(id);
+                }
+                catch { /* retain encoded id */ }
+                const targetHtml = target === page ? html : await readFile(target, 'utf8');
+                const quotedId = escapeRegExp(id);
+                const hasId = new RegExp(`\\bid=(?:"${quotedId}"|'${quotedId}')`, 'i').test(targetHtml);
+                if (!hasId)
+                    failures.push(`${relative(outputDir, page)} -> ${href} (missing #${id})`);
+            }
+        }
+    }
+    return { pages: pages.length, links, failures };
+}
+//# sourceMappingURL=links.js.map

package/dist/cli/checks/links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.js","sourceRoot":"","sources":["../../../src/cli/checks/links.ts"],"names":[],"mappings":"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"}

package/dist/cli/checks/performance.d.ts

@@ -0,0 +1,17 @@
+export interface PerformanceBudgetOptions {
+    outputDir?: string;
+    page?: string;
+    maxHtmlBytes?: number;
+    maxInitialJsGzipBytes?: number;
+    maxEntryJsGzipBytes?: number;
+    expectedPages?: number;
+}
+export interface PerformanceBudgetReport {
+    htmlBytes: number;
+    initialJsGzipBytes: number;
+    entryJsGzipBytes: number;
+    failures: string[];
+}
+/** Measure framework-neutral SSG output budgets and build-integrity signals. */
+export declare function checkPerformanceBudgets(options?: PerformanceBudgetOptions): Promise<PerformanceBudgetReport>;
+//# sourceMappingURL=performance.d.ts.map

package/dist/cli/checks/performance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.d.ts","sourceRoot":"","sources":["../../../src/cli/checks/performance.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,wBAAwB;IACvC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAA;IACjB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,gBAAgB,EAAE,MAAM,CAAA;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,gFAAgF;AAChF,wBAAsB,uBAAuB,CAC3C,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,uBAAuB,CAAC,CAkElC"}

package/dist/cli/checks/performance.js

@@ -0,0 +1,61 @@
+import { gzipSync } from 'node:zlib';
+import { readFile, readdir, stat } from 'node:fs/promises';
+import { basename, join, resolve } from 'node:path';
+/** Measure framework-neutral SSG output budgets and build-integrity signals. */
+export async function checkPerformanceBudgets(options = {}) {
+    const outputDir = resolve(options.outputDir ?? 'dist');
+    const page = (options.page ?? '/').replace(/^\/+|\/+$/g, '');
+    const htmlPath = page ? join(outputDir, page, 'index.html') : join(outputDir, 'index.html');
+    const assetsDir = join(outputDir, 'assets');
+    const html = await readFile(htmlPath, 'utf8');
+    const htmlBytes = (await stat(htmlPath)).size;
+    const failures = [];
+    const assetNames = new Set([...html.matchAll(/(?:src|href)=(?:"([^"]+\.js)"|'([^']+\.js)')/g)]
+        .map((match) => match[1] ?? match[2])
+        .map((url) => url.slice(url.lastIndexOf('/') + 1)));
+    let initialJsGzipBytes = 0;
+    let entryJsGzipBytes = 0;
+    for (const name of assetNames) {
+        try {
+            const bytes = gzipSync(await readFile(join(assetsDir, name))).byteLength;
+            initialJsGzipBytes += bytes;
+            if (name.startsWith('index-'))
+                entryJsGzipBytes += bytes;
+        }
+        catch {
+            failures.push(`homepage references missing JavaScript asset ${name}`);
+        }
+    }
+    if (options.maxHtmlBytes !== undefined && htmlBytes > options.maxHtmlBytes) {
+        failures.push(`homepage is ${htmlBytes.toLocaleString()} bytes (budget: ${options.maxHtmlBytes.toLocaleString()})`);
+    }
+    if (options.maxInitialJsGzipBytes !== undefined &&
+        initialJsGzipBytes > options.maxInitialJsGzipBytes) {
+        failures.push(`initial JavaScript is ${initialJsGzipBytes.toLocaleString()} gzip bytes (budget: ${options.maxInitialJsGzipBytes.toLocaleString()})`);
+    }
+    if (options.maxEntryJsGzipBytes !== undefined &&
+        entryJsGzipBytes > options.maxEntryJsGzipBytes) {
+        failures.push(`entry JavaScript is ${entryJsGzipBytes.toLocaleString()} gzip bytes (budget: ${options.maxEntryJsGzipBytes.toLocaleString()})`);
+    }
+    const assets = await readdir(assetsDir);
+    const browserExternals = assets.filter((name) => name.startsWith('__vite-browser-external'));
+    if (browserExternals.length > 0) {
+        failures.push(`client build contains browser-external shims: ${browserExternals.join(', ')}`);
+    }
+    try {
+        const manifest = JSON.parse(await readFile(join(outputDir, 'ssg-manifest.json'), 'utf8'));
+        if ((manifest.errors?.length ?? 0) > 0) {
+            failures.push(`SSG manifest contains ${manifest.errors.length} render error(s)`);
+        }
+        if (options.expectedPages !== undefined && manifest.paths?.length !== options.expectedPages) {
+            failures.push(`SSG manifest contains ${manifest.paths?.length ?? 0} pages (expected: ${options.expectedPages})`);
+        }
+    }
+    catch {
+        if (options.expectedPages !== undefined) {
+            failures.push(`missing ${basename(join(outputDir, 'ssg-manifest.json'))}`);
+        }
+    }
+    return { htmlBytes, initialJsGzipBytes, entryJsGzipBytes, failures };
+}
+//# sourceMappingURL=performance.js.map

package/dist/cli/checks/performance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.js","sourceRoot":"","sources":["../../../src/cli/checks/performance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAkBnD,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,UAAoC,EAAE;IAEtC,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC,CAAA;IACtD,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAA;IAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAA;IAC3F,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;IAC3C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IAC7C,MAAM,SAAS,GAAG,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAA;IAC7C,MAAM,QAAQ,GAAa,EAAE,CAAA;IAE7B,MAAM,UAAU,GAAG,IAAI,GAAG,CACxB,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,+CAA+C,CAAC,CAAC;SAChE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;SACpC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CACrD,CAAA;IACD,IAAI,kBAAkB,GAAG,CAAC,CAAA;IAC1B,IAAI,gBAAgB,GAAG,CAAC,CAAA;IACxB,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAA;YACxE,kBAAkB,IAAI,KAAK,CAAA;YAC3B,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;gBAAE,gBAAgB,IAAI,KAAK,CAAA;QAC1D,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ,CAAC,IAAI,CAAC,gDAAgD,IAAI,EAAE,CAAC,CAAA;QACvE,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,IAAI,SAAS,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;QAC3E,QAAQ,CAAC,IAAI,CAAC,eAAe,SAAS,CAAC,cAAc,EAAE,mBAAmB,OAAO,CAAC,YAAY,CAAC,cAAc,EAAE,GAAG,CAAC,CAAA;IACrH,CAAC;IACD,IACE,OAAO,CAAC,qBAAqB,KAAK,SAAS;QAC3C,kBAAkB,GAAG,OAAO,CAAC,qBAAqB,EAClD,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,yBAAyB,kBAAkB,CAAC,cAAc,EAAE,wBAAwB,OAAO,CAAC,qBAAqB,CAAC,cAAc,EAAE,GAAG,CAAC,CAAA;IACtJ,CAAC;IACD,IACE,OAAO,CAAC,mBAAmB,KAAK,SAAS;QACzC,gBAAgB,GAAG,OAAO,CAAC,mBAAmB,EAC9C,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,uBAAuB,gBAAgB,CAAC,cAAc,EAAE,wBAAwB,OAAO,CAAC,mBAAmB,CAAC,cAAc,EAAE,GAAG,CAAC,CAAA;IAChJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,CAAA;IACvC,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,yBAAyB,CAAC,CAAC,CAAA;IAC5F,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,QAAQ,CAAC,IAAI,CAAC,iDAAiD,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC/F,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,mBAAmB,CAAC,EAAE,MAAM,CAAC,CAGvF,CAAA;QACD,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YACvC,QAAQ,CAAC,IAAI,CAAC,yBAAyB,QAAQ,CAAC,MAAO,CAAC,MAAM,kBAAkB,CAAC,CAAA;QACnF,CAAC;QACD,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS,IAAI,QAAQ,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,EAAE,CAAC;YAC5F,QAAQ,CAAC,IAAI,CAAC,yBAAyB,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,qBAAqB,OAAO,CAAC,aAAa,GAAG,CAAC,CAAA;QAClH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACxC,QAAQ,CAAC,IAAI,CAAC,WAAW,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAA;QAC5E,CAAC;IACH,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,CAAA;AACtE,CAAC"}

package/dist/cli/commands/check.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function checkCommand(): Command;
+//# sourceMappingURL=check.d.ts.map

package/dist/cli/commands/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAkBnC,wBAAgB,YAAY,IAAI,OAAO,CA0FtC"}

package/dist/cli/commands/check.js

@@ -0,0 +1,85 @@
+import { Command } from 'commander';
+import { resolve } from 'node:path';
+import { checkBuiltLinks } from '../checks/links.js';
+import { checkPerformanceBudgets } from '../checks/performance.js';
+import { LIGHTHOUSE_CATEGORIES, runLighthouseAudit } from '../checks/lighthouse.js';
+function numberOption(value) {
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed) || parsed < 0)
+        throw new Error(`Invalid non-negative number: ${value}`);
+    return parsed;
+}
+function printFailures(label, failures) {
+    if (failures.length === 0)
+        return;
+    console.error(`${label} failed:\n- ${failures.join('\n- ')}`);
+    process.exitCode = 1;
+}
+export function checkCommand() {
+    const command = new Command('check').description('Validate production build quality');
+    command.addCommand(new Command('links')
+        .description('Validate all internal SSG links and fragments')
+        .option('--root <root>', 'Project root directory', process.cwd())
+        .option('--output <directory>', 'Build output directory', 'dist')
+        .action(async (options) => {
+        const report = await checkBuiltLinks({ outputDir: resolve(options.root, options.output) });
+        printFailures('Built-link validation', report.failures);
+        if (report.failures.length === 0) {
+            console.log(`Built-link validation passed: ${report.links} links across ${report.pages} pages.`);
+        }
+    }));
+    command.addCommand(new Command('performance')
+        .description('Validate HTML and JavaScript production budgets')
+        .option('--root <root>', 'Project root directory', process.cwd())
+        .option('--output <directory>', 'Build output directory', 'dist')
+        .option('--page <path>', 'Route to budget', '/')
+        .option('--max-html <bytes>', 'Maximum HTML bytes', numberOption, 250_000)
+        .option('--max-initial-js <bytes>', 'Maximum initial JavaScript gzip bytes', numberOption, 85_000)
+        .option('--max-entry-js <bytes>', 'Maximum entry JavaScript gzip bytes', numberOption, 50_000)
+        .option('--expected-pages <count>', 'Expected SSG manifest page count', numberOption)
+        .action(async (options) => {
+        const report = await checkPerformanceBudgets({
+            outputDir: resolve(options.root, options.output),
+            page: options.page,
+            maxHtmlBytes: options.maxHtml,
+            maxInitialJsGzipBytes: options.maxInitialJs,
+            maxEntryJsGzipBytes: options.maxEntryJs,
+            expectedPages: options.expectedPages,
+        });
+        printFailures('Performance budget', report.failures);
+        if (report.failures.length === 0) {
+            console.log(`Performance budgets passed: HTML ${report.htmlBytes.toLocaleString()} bytes; initial JS ${report.initialJsGzipBytes.toLocaleString()} gzip bytes.`);
+        }
+    }));
+    command.addCommand(new Command('lighthouse')
+        .description('Require perfect median Lighthouse scores using a local lighthouse dependency')
+        .requiredOption('--url <urls...>', 'One or more preview URLs to audit')
+        .option('--root <root>', 'Project root directory', process.cwd())
+        .option('--runs <count>', 'Runs per URL', numberOption, 3)
+        .option('--attempts <count>', 'Launch attempts per run', numberOption, 3)
+        .option('--desktop', 'Use the Lighthouse desktop preset')
+        .option('--chrome-path <path>', 'Chrome, Chromium, Edge, or Brave executable')
+        .action(async (options) => {
+        const reports = await runLighthouseAudit({
+            root: options.root,
+            urls: options.url,
+            runs: options.runs,
+            attempts: options.attempts,
+            preset: options.desktop ? 'desktop' : undefined,
+            chromePath: options.chromePath,
+        });
+        const failures = [];
+        for (const report of reports) {
+            const summary = LIGHTHOUSE_CATEGORIES.map((category) => {
+                const score = report.medians[category] ?? 0;
+                if (score !== 1)
+                    failures.push(`${report.url}: ${category}=${Math.round(score * 100)}`);
+                return `${category}=${Math.round(score * 100)}`;
+            });
+            console.log(`[lighthouse] ${report.url}: ${summary.join(' ')}`);
+        }
+        printFailures('Lighthouse audit', failures);
+    }));
+    return command;
+}
+//# sourceMappingURL=check.js.map

package/dist/cli/commands/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../../src/cli/commands/check.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/preview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/preview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAkMnC,wBAAgB,cAAc,IAAI,OAAO,CAsSxC"}
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/preview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AA6NnC,wBAAgB,cAAc,IAAI,OAAO,CA6SxC"}

package/dist/cli/commands/preview.js

@@ -1,6 +1,7 @@
 import { Command } from 'commander';
 import { createServer as createHttpServer } from 'node:http';
 import { createReadStream, existsSync, statSync } from 'node:fs';
+import { createGzip } from 'node:zlib';
 import { resolve, join, extname } from 'pathe';
 import { pathToFileURL } from 'node:url';
 import { isPathBounded, findRevalidate, findRenderMode, renderForIsr, serveFromIsrCache, } from './preview-isr.js';
@@ -103,6 +104,20 @@ function getMimeType(filePath) {
     const ext = extname(filePath).toLowerCase();
     return MIME_TYPES[ext] ?? 'application/octet-stream';
 }
+// MIME types that benefit from gzip compression. Binary formats (woff2, images)
+// are already compressed and should not be re-compressed.
+const GZIP_TYPES = new Set([
+    'text/html; charset=utf-8',
+    'application/javascript; charset=utf-8',
+    'text/css; charset=utf-8',
+    'application/json; charset=utf-8',
+    'image/svg+xml',
+    'application/json',
+]);
+function acceptsGzip(req) {
+    const ae = req.headers['accept-encoding'] ?? '';
+    return ae.includes('gzip');
+}
 /**
  * Returns the appropriate Cache-Control header value for a file.
  * Vite content-hashes assets placed in the /assets/ directory, so they
@@ -123,6 +138,8 @@ function setSecurityHeaders(res) {
 }
 /**
  * Serves a static file from the dist directory.
+ * Applies gzip compression for compressible text types when the client
+ * signals support via the Accept-Encoding request header.
  * Returns true if the file was served, false otherwise.
  */
 function serveStaticFile(req, res, distDir) {
@@ -149,10 +166,18 @@ function serveStaticFile(req, res, distDir) {
             return false;
         }
     }
-    res.setHeader('Content-Type', getMimeType(filePath));
+    const mimeType = getMimeType(filePath);
+    res.setHeader('Content-Type', mimeType);
     res.setHeader('Cache-Control', getCacheControl(filePath));
     setSecurityHeaders(res);
-    createReadStream(filePath).pipe(res);
+    const stream = createReadStream(filePath);
+    if (GZIP_TYPES.has(mimeType) && acceptsGzip(req)) {
+        res.setHeader('Content-Encoding', 'gzip');
+        stream.pipe(createGzip()).pipe(res);
+    }
+    else {
+        stream.pipe(res);
+    }
     return true;
 }
 /**
@@ -418,9 +443,17 @@ export function previewCommand() {
                     const assetPath = join(clientDist, urlPath);
                     if (isPathBounded(clientDist, urlPath) &&
                         existsSync(assetPath) && !statSync(assetPath).isDirectory()) {
-                        res.setHeader('Content-Type', getMimeType(assetPath));
+                        const mimeType = getMimeType(assetPath);
+                        res.setHeader('Content-Type', mimeType);
                         res.setHeader('Cache-Control', getCacheControl(assetPath));
-                        createReadStream(assetPath).pipe(res);
+                        const stream = createReadStream(assetPath);
+                        if (GZIP_TYPES.has(mimeType) && acceptsGzip(req)) {
+                            res.setHeader('Content-Encoding', 'gzip');
+                            stream.pipe(createGzip()).pipe(res);
+                        }
+                        else {
+                            stream.pipe(res);
+                        }
                         return;
                     }
                 }