@promise-inc/ps-guard 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Promise Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,168 @@
+# @promise-inc/ps-guard
+
+Lighthouse-based performance guard. Enforce Web Vitals thresholds in CI and locally.
+
+## Why ps-guard?
+
+Running Lighthouse manually is tedious and inconsistent. `ps-guard` wraps Lighthouse into an opinionated CLI and API with:
+
+- **Threshold enforcement** — fail CI if LCP, CLS, INP, TTFB, or FCP exceed your limits
+- **Presets** — built-in configs for Next.js, landing pages, and marketing sites
+- **Fix hints** — actionable suggestions when a metric fails
+- **JSON output** — pipe results to dashboards or custom reporters
+- **Zero config** — sensible defaults based on Google's Web Vitals recommendations
+
+## Quick Start
+
+### CLI
+
+```bash
+# Run with defaults (mobile, score >= 90)
+npx ps-guard --url https://example.com
+
+# Use a preset
+npx ps-guard --url https://example.com --preset nextjs
+
+# Desktop mode
+npx ps-guard --url https://example.com --device desktop
+
+# JSON output for CI pipelines
+npx ps-guard --url https://example.com --json
+
+# CI mode (no colors)
+npx ps-guard --url https://example.com --ci
+```
+
+### Programmatic
+
+```typescript
+import { runPSGuard } from "@promise-inc/ps-guard";
+
+const result = await runPSGuard("https://example.com", {
+  device: "mobile",
+  minScore: 90,
+  preset: "nextjs",
+});
+
+if (!result.passed) {
+  console.log("Performance check failed:", result.metrics);
+}
+```
+
+## CLI Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--url <url>` | URL to audit (required) | — |
+| `-p, --preset <name>` | Use a built-in preset | — |
+| `--device <mobile\|desktop>` | Device emulation | `mobile` |
+| `--retries <n>` | Retry attempts | `1` |
+| `--json` | Output as JSON | `false` |
+| `--ci` | No colors, clean output | `false` |
+| `-h, --help` | Show help | — |
+
+## Configuration
+
+Create a `ps-guard.config.json` (or `.js`/`.ts`) in your project root:
+
+```json
+{
+  "url": "https://example.com",
+  "device": "mobile",
+  "minScore": 90,
+  "thresholds": {
+    "lcp": 2500,
+    "cls": 0.1,
+    "inp": 200,
+    "ttfb": 800,
+    "fcp": 1800
+  },
+  "retries": 2
+}
+```
+
+Or add to `package.json`:
+
+```json
+{
+  "ps-guard": {
+    "url": "https://example.com",
+    "preset": "nextjs"
+  }
+}
+```
+
+### Config Cascade
+
+Priority (highest to lowest):
+
+1. CLI arguments
+2. Config file (`ps-guard.config.*`)
+3. `package.json` `"ps-guard"` field
+4. Preset values
+5. Defaults
+
+## Presets
+
+| Preset | Device | LCP | CLS | INP | TTFB | FCP |
+|--------|--------|-----|-----|-----|------|-----|
+| `nextjs` | mobile | 2500ms | 0.1 | 200ms | 800ms | 1800ms |
+| `landing-page` | mobile | 1800ms | 0.05 | 100ms | 500ms | 1200ms |
+| `marketing-site` | mobile | 2500ms | 0.1 | 200ms | 800ms | 1800ms |
+
+## Default Thresholds
+
+Based on [Google's Web Vitals recommendations](https://web.dev/vitals/):
+
+| Metric | Limit | Description |
+|--------|-------|-------------|
+| LCP | 2500ms | Largest Contentful Paint |
+| CLS | 0.1 | Cumulative Layout Shift |
+| INP | 200ms | Interaction to Next Paint |
+| TTFB | 800ms | Time to First Byte |
+| FCP | 1800ms | First Contentful Paint |
+
+## CI / GitHub Actions
+
+```yaml
+name: Performance Guard
+
+on:
+  pull_request:
+    branches: [main]
+
+jobs:
+  perf:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Install Chrome
+        uses: browser-actions/setup-chrome@v1
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run ps-guard
+        run: npx ps-guard --url https://staging.example.com --ci
+```
+
+## Requirements
+
+- Node.js >= 18
+- Chrome/Chromium installed (for Lighthouse)
+
+## See Also
+
+- [@promise-inc/ai-guard](https://github.com/promise-inc/ai-guard) — Detect AI-generated code patterns before commit/push
+- [@promise-inc/dev-reel](https://github.com/promise-inc/dev-reel) — Animated SVG previews for READMEs
+- [@promise-inc/devlog](https://github.com/promise-inc/devlog) — Simple logger with automatic context (file + line)
+- [@promise-inc/fs-guard](https://github.com/promise-inc/fs-guard) — Validate project folder and file structure
+- [@promise-inc/ui-states](https://github.com/promise-inc/ui-states) — Auto-generated skeleton loading states from real DOM
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const config_1 = require("./config");
+const runner_1 = require("./runner");
+const validator_1 = require("./validator");
+const reporter_1 = require("./reporter");
+const registry_1 = require("./presets/registry");
+const output_1 = require("./utils/output");
+function parseArgs(args) {
+    let url;
+    let preset;
+    let device;
+    let json = false;
+    let ci = false;
+    let help = false;
+    let retries;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "--url") {
+            url = args[i + 1];
+            i++;
+        }
+        else if (arg === "--preset" || arg === "-p") {
+            preset = args[i + 1];
+            i++;
+        }
+        else if (arg === "--device") {
+            const val = args[i + 1];
+            if (val === "mobile" || val === "desktop") {
+                device = val;
+            }
+            i++;
+        }
+        else if (arg === "--json") {
+            json = true;
+        }
+        else if (arg === "--ci") {
+            ci = true;
+        }
+        else if (arg === "--help" || arg === "-h") {
+            help = true;
+        }
+        else if (arg === "--retries") {
+            const val = parseInt(args[i + 1], 10);
+            if (!isNaN(val) && val > 0) {
+                retries = val;
+            }
+            i++;
+        }
+    }
+    return { url, preset, device, json, ci, help, retries };
+}
+function printHelp() {
+    console.log(`
+  \x1b[1m\x1b[36mps-guard\x1b[0m — Lighthouse-based performance guard
+
+  \x1b[1mUsage:\x1b[0m
+    npx ps-guard --url https://example.com
+    npx ps-guard --url https://example.com --preset nextjs
+    npx ps-guard --url https://example.com --json
+
+  \x1b[1mOptions:\x1b[0m
+    --url <url>             URL to audit (required)
+    -p, --preset <name>     Use a built-in preset
+    --device <mobile|desktop>  Device emulation (default: mobile)
+    --retries <n>           Number of retry attempts (default: 1)
+    --json                  Output results as JSON
+    --ci                    CI mode (no colors, clean output)
+    -h, --help              Show this help message
+
+  \x1b[1mPresets:\x1b[0m
+    ${registry_1.presetNames.join(", ")}
+
+  \x1b[1mConfig files:\x1b[0m
+    ps-guard.config.ts | ps-guard.config.js | ps-guard.config.json | package.json
+
+  \x1b[1mThresholds (defaults):\x1b[0m
+    LCP   2500ms    Largest Contentful Paint
+    CLS   0.1       Cumulative Layout Shift
+    INP   200ms     Interaction to Next Paint
+    TTFB  800ms     Time to First Byte
+    FCP   1800ms    First Contentful Paint
+`);
+}
+async function main() {
+    const parsed = parseArgs(process.argv.slice(2));
+    if (parsed.help) {
+        printHelp();
+        return;
+    }
+    if (parsed.ci) {
+        (0, output_1.setCIMode)(true);
+    }
+    try {
+        const cwd = process.cwd();
+        const config = (0, config_1.loadConfig)(cwd, {
+            url: parsed.url,
+            preset: parsed.preset,
+            device: parsed.device,
+            retries: parsed.retries,
+        });
+        const lighthouseResult = await (0, runner_1.runLighthouse)(config);
+        const result = (0, validator_1.validateResults)(lighthouseResult.lhr, config);
+        if (parsed.json) {
+            (0, reporter_1.reportJSON)(result);
+        }
+        else {
+            (0, reporter_1.reportHuman)(result);
+        }
+        if (!result.passed) {
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        (0, output_1.printError)(message);
+        process.exit(2);
+    }
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,4 @@
+import type { PSGuardConfig } from "./types";
+export declare function resolvePreset(name: string): Partial<PSGuardConfig>;
+export declare function loadConfig(cwd: string, overrides?: Partial<PSGuardConfig>): PSGuardConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAqB,MAAM,SAAS,CAAC;AAmDhE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAWlE;AAED,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,EACX,SAAS,GAAE,OAAO,CAAC,aAAa,CAAM,GACrC,aAAa,CA6Bf"}

package/dist/config.js

@@ -0,0 +1,119 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvePreset = resolvePreset;
+exports.loadConfig = loadConfig;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const registry_1 = require("./presets/registry");
+const DEFAULT_THRESHOLDS = {
+    lcp: 2500,
+    cls: 0.1,
+    inp: 200,
+    ttfb: 800,
+    fcp: 1800,
+};
+const DEFAULT_CONFIG = {
+    device: "mobile",
+    minScore: 90,
+    thresholds: DEFAULT_THRESHOLDS,
+    failOnError: true,
+    retries: 1,
+};
+const CONFIG_FILES = [
+    "ps-guard.config.ts",
+    "ps-guard.config.js",
+    "ps-guard.config.json",
+];
+function loadConfigFile(cwd) {
+    for (const file of CONFIG_FILES) {
+        const filePath = path.join(cwd, file);
+        if (fs.existsSync(filePath)) {
+            if (file.endsWith(".json")) {
+                const content = fs.readFileSync(filePath, "utf-8");
+                return JSON.parse(content);
+            }
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const loaded = require(filePath);
+            return (loaded.default ?? loaded);
+        }
+    }
+    const pkgPath = path.join(cwd, "package.json");
+    if (fs.existsSync(pkgPath)) {
+        const content = fs.readFileSync(pkgPath, "utf-8");
+        const pkg = JSON.parse(content);
+        if (pkg["ps-guard"] && typeof pkg["ps-guard"] === "object") {
+            return pkg["ps-guard"];
+        }
+    }
+    return undefined;
+}
+function resolvePreset(name) {
+    const preset = registry_1.presets[name];
+    if (!preset) {
+        throw new Error(`Unknown preset "${name}". Available: ${Object.keys(registry_1.presets).join(", ")}`);
+    }
+    return {
+        device: preset.device,
+        thresholds: { ...preset.thresholds },
+    };
+}
+function loadConfig(cwd, overrides = {}) {
+    const fileConfig = loadConfigFile(cwd) ?? {};
+    let presetConfig = {};
+    const presetName = overrides.preset ?? fileConfig.preset;
+    if (presetName) {
+        presetConfig = resolvePreset(presetName);
+    }
+    const merged = {
+        url: overrides.url ?? fileConfig.url ?? "",
+        device: overrides.device ?? fileConfig.device ?? presetConfig.device ?? DEFAULT_CONFIG.device,
+        minScore: overrides.minScore ?? fileConfig.minScore ?? DEFAULT_CONFIG.minScore,
+        thresholds: {
+            ...DEFAULT_THRESHOLDS,
+            ...presetConfig.thresholds,
+            ...fileConfig.thresholds,
+            ...overrides.thresholds,
+        },
+        failOnError: overrides.failOnError ?? fileConfig.failOnError ?? DEFAULT_CONFIG.failOnError,
+        retries: overrides.retries ?? fileConfig.retries ?? DEFAULT_CONFIG.retries,
+        preset: presetName,
+    };
+    if (!merged.url) {
+        throw new Error("URL is required. Use --url <url> or set it in config file.");
+    }
+    return merged;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/hints.d.ts

@@ -0,0 +1,2 @@
+export declare function getHints(metricName: string): string[];
+//# sourceMappingURL=hints.d.ts.map

package/dist/hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hints.d.ts","sourceRoot":"","sources":["../src/hints.ts"],"names":[],"mappings":"AAiCA,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAErD"}

package/dist/hints.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getHints = getHints;
+const METRIC_HINTS = {
+    LCP: [
+        "Optimize or compress the largest image/video on the page",
+        "Use <link rel=\"preload\"> for critical above-the-fold resources",
+        "Reduce server response time (TTFB impacts LCP)",
+        "Remove render-blocking JavaScript and CSS",
+    ],
+    CLS: [
+        "Set explicit width/height on images and videos",
+        "Avoid inserting content above existing content dynamically",
+        "Use CSS contain-intrinsic-size for lazy-loaded content",
+        "Prefer CSS transforms for animations instead of layout-triggering properties",
+    ],
+    INP: [
+        "Break up long tasks (>50ms) into smaller chunks",
+        "Use requestIdleCallback or Web Workers for heavy computation",
+        "Minimize JavaScript execution on user interactions",
+        "Reduce DOM size to speed up event handling",
+    ],
+    TTFB: [
+        "Use a CDN to serve content closer to users",
+        "Optimize server-side rendering or database queries",
+        "Enable HTTP/2 or HTTP/3",
+        "Implement edge caching or stale-while-revalidate",
+    ],
+    FCP: [
+        "Eliminate render-blocking resources",
+        "Inline critical CSS above the fold",
+        "Reduce server response time",
+        "Preconnect to required origins",
+    ],
+};
+function getHints(metricName) {
+    return METRIC_HINTS[metricName] ?? [];
+}
+//# sourceMappingURL=hints.js.map

package/dist/hints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hints.js","sourceRoot":"","sources":["../src/hints.ts"],"names":[],"mappings":";;AAiCA,4BAEC;AAnCD,MAAM,YAAY,GAA6B;IAC7C,GAAG,EAAE;QACH,0DAA0D;QAC1D,kEAAkE;QAClE,gDAAgD;QAChD,2CAA2C;KAC5C;IACD,GAAG,EAAE;QACH,gDAAgD;QAChD,4DAA4D;QAC5D,wDAAwD;QACxD,8EAA8E;KAC/E;IACD,GAAG,EAAE;QACH,iDAAiD;QACjD,8DAA8D;QAC9D,oDAAoD;QACpD,4CAA4C;KAC7C;IACD,IAAI,EAAE;QACJ,4CAA4C;QAC5C,oDAAoD;QACpD,yBAAyB;QACzB,kDAAkD;KACnD;IACD,GAAG,EAAE;QACH,qCAAqC;QACrC,oCAAoC;QACpC,6BAA6B;QAC7B,gCAAgC;KACjC;CACF,CAAC;AAEF,SAAgB,QAAQ,CAAC,UAAkB;IACzC,OAAO,YAAY,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;AACxC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import type { PSGuardConfig, PSGuardResult } from "./types";
+export { loadConfig, resolvePreset } from "./config";
+export { runLighthouse } from "./runner";
+export { parseMetrics } from "./parser";
+export { validateResults } from "./validator";
+export { reportHuman, reportJSON } from "./reporter";
+export { getHints } from "./hints";
+export { presets, presetNames } from "./presets";
+export type { PSGuardConfig, PSGuardThresholds, MetricResult, PSGuardResult, Preset, } from "./types";
+export declare function runPSGuard(url: string, options?: Partial<Omit<PSGuardConfig, "url">>): Promise<PSGuardResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE5D,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAEjD,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,MAAM,GACP,MAAM,SAAS,CAAC;AAEjB,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAM,GAChD,OAAO,CAAC,aAAa,CAAC,CAIxB"}

package/dist/index.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.presetNames = exports.presets = exports.getHints = exports.reportJSON = exports.reportHuman = exports.validateResults = exports.parseMetrics = exports.runLighthouse = exports.resolvePreset = exports.loadConfig = void 0;
+exports.runPSGuard = runPSGuard;
+const config_1 = require("./config");
+const runner_1 = require("./runner");
+const validator_1 = require("./validator");
+var config_2 = require("./config");
+Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return config_2.loadConfig; } });
+Object.defineProperty(exports, "resolvePreset", { enumerable: true, get: function () { return config_2.resolvePreset; } });
+var runner_2 = require("./runner");
+Object.defineProperty(exports, "runLighthouse", { enumerable: true, get: function () { return runner_2.runLighthouse; } });
+var parser_1 = require("./parser");
+Object.defineProperty(exports, "parseMetrics", { enumerable: true, get: function () { return parser_1.parseMetrics; } });
+var validator_2 = require("./validator");
+Object.defineProperty(exports, "validateResults", { enumerable: true, get: function () { return validator_2.validateResults; } });
+var reporter_1 = require("./reporter");
+Object.defineProperty(exports, "reportHuman", { enumerable: true, get: function () { return reporter_1.reportHuman; } });
+Object.defineProperty(exports, "reportJSON", { enumerable: true, get: function () { return reporter_1.reportJSON; } });
+var hints_1 = require("./hints");
+Object.defineProperty(exports, "getHints", { enumerable: true, get: function () { return hints_1.getHints; } });
+var presets_1 = require("./presets");
+Object.defineProperty(exports, "presets", { enumerable: true, get: function () { return presets_1.presets; } });
+Object.defineProperty(exports, "presetNames", { enumerable: true, get: function () { return presets_1.presetNames; } });
+async function runPSGuard(url, options = {}) {
+    const config = (0, config_1.loadConfig)(process.cwd(), { url, ...options });
+    const lighthouseResult = await (0, runner_1.runLighthouse)(config);
+    return (0, validator_1.validateResults)(lighthouseResult.lhr, config);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAqBA,gCAOC;AA5BD,qCAAqD;AACrD,qCAA2D;AAC3D,2CAAkE;AAGlE,mCAAqD;AAA5C,oGAAA,UAAU,OAAA;AAAE,uGAAA,aAAa,OAAA;AAClC,mCAAyC;AAAhC,uGAAA,aAAa,OAAA;AACtB,mCAAwC;AAA/B,sGAAA,YAAY,OAAA;AACrB,yCAA8C;AAArC,4GAAA,eAAe,OAAA;AACxB,uCAAqD;AAA5C,uGAAA,WAAW,OAAA;AAAE,sGAAA,UAAU,OAAA;AAChC,iCAAmC;AAA1B,iGAAA,QAAQ,OAAA;AACjB,qCAAiD;AAAxC,kGAAA,OAAO,OAAA;AAAE,sGAAA,WAAW,OAAA;AAUtB,KAAK,UAAU,UAAU,CAC9B,GAAW,EACX,UAA+C,EAAE;IAEjD,MAAM,MAAM,GAAG,IAAA,mBAAW,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/D,MAAM,gBAAgB,GAAG,MAAM,IAAA,sBAAc,EAAC,MAAM,CAAC,CAAC;IACtD,OAAO,IAAA,2BAAgB,EAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AACxD,CAAC"}

package/dist/parser.d.ts

@@ -0,0 +1,9 @@
+import type { MetricResult, PSGuardThresholds } from "./types";
+interface LighthouseAudits {
+    [key: string]: {
+        numericValue?: number;
+    };
+}
+export declare function parseMetrics(audits: LighthouseAudits, thresholds: PSGuardThresholds): MetricResult[];
+export {};
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE/D,UAAU,gBAAgB;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1C;AAUD,wBAAgB,YAAY,CAC1B,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,iBAAiB,GAC5B,YAAY,EAAE,CA0BhB"}

package/dist/parser.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseMetrics = parseMetrics;
+const METRIC_MAP = {
+    lcp: { audit: "largest-contentful-paint", unit: "ms" },
+    cls: { audit: "cumulative-layout-shift", unit: "" },
+    inp: { audit: "experimental-interaction-to-next-paint", unit: "ms" },
+    ttfb: { audit: "server-response-time", unit: "ms" },
+    fcp: { audit: "first-contentful-paint", unit: "ms" },
+};
+function parseMetrics(audits, thresholds) {
+    const results = [];
+    for (const [key, mapping] of Object.entries(METRIC_MAP)) {
+        const thresholdKey = key;
+        const limit = thresholds[thresholdKey];
+        if (limit === undefined)
+            continue;
+        const audit = audits[mapping.audit];
+        const rawValue = audit?.numericValue ?? 0;
+        const value = key === "cls"
+            ? Math.round(rawValue * 1000) / 1000
+            : Math.round(rawValue);
+        results.push({
+            name: key.toUpperCase(),
+            value,
+            limit,
+            passed: value <= limit,
+            unit: mapping.unit,
+        });
+    }
+    return results;
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":";;AAcA,oCA6BC;AArCD,MAAM,UAAU,GAAqE;IACnF,GAAG,EAAE,EAAE,KAAK,EAAE,0BAA0B,EAAE,IAAI,EAAE,IAAI,EAAE;IACtD,GAAG,EAAE,EAAE,KAAK,EAAE,yBAAyB,EAAE,IAAI,EAAE,EAAE,EAAE;IACnD,GAAG,EAAE,EAAE,KAAK,EAAE,wCAAwC,EAAE,IAAI,EAAE,IAAI,EAAE;IACpE,IAAI,EAAE,EAAE,KAAK,EAAE,sBAAsB,EAAE,IAAI,EAAE,IAAI,EAAE;IACnD,GAAG,EAAE,EAAE,KAAK,EAAE,wBAAwB,EAAE,IAAI,EAAE,IAAI,EAAE;CACrD,CAAC;AAEF,SAAgB,YAAY,CAC1B,MAAwB,EACxB,UAA6B;IAE7B,MAAM,OAAO,GAAmB,EAAE,CAAC;IAEnC,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACxD,MAAM,YAAY,GAAG,GAA8B,CAAC;QACpD,MAAM,KAAK,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;QAEvC,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAElC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,KAAK,EAAE,YAAY,IAAI,CAAC,CAAC;QAE1C,MAAM,KAAK,GAAG,GAAG,KAAK,KAAK;YACzB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,IAAI;YACpC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAEzB,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,GAAG,CAAC,WAAW,EAAE;YACvB,KAAK;YACL,KAAK;YACL,MAAM,EAAE,KAAK,IAAI,KAAK;YACtB,IAAI,EAAE,OAAO,CAAC,IAAI;SACnB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/presets/index.d.ts

@@ -0,0 +1,2 @@
+export { presets, presetNames } from "./registry";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/presets/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/presets/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.presetNames = exports.presets = void 0;
+var registry_1 = require("./registry");
+Object.defineProperty(exports, "presets", { enumerable: true, get: function () { return registry_1.presets; } });
+Object.defineProperty(exports, "presetNames", { enumerable: true, get: function () { return registry_1.presetNames; } });
+//# sourceMappingURL=index.js.map

package/dist/presets/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/presets/index.ts"],"names":[],"mappings":";;;AAAA,uCAAkD;AAAzC,mGAAA,OAAO,OAAA;AAAE,uGAAA,WAAW,OAAA"}

package/dist/presets/landing-page.d.ts

@@ -0,0 +1,3 @@
+import type { Preset } from "../types";
+export declare const landingPage: Preset;
+//# sourceMappingURL=landing-page.d.ts.map

package/dist/presets/landing-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"landing-page.d.ts","sourceRoot":"","sources":["../../src/presets/landing-page.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,eAAO,MAAM,WAAW,EAAE,MASzB,CAAC"}

package/dist/presets/landing-page.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.landingPage = void 0;
+exports.landingPage = {
+    device: "mobile",
+    thresholds: {
+        lcp: 1800,
+        cls: 0.05,
+        inp: 100,
+        ttfb: 500,
+        fcp: 1200,
+    },
+};
+//# sourceMappingURL=landing-page.js.map

package/dist/presets/landing-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"landing-page.js","sourceRoot":"","sources":["../../src/presets/landing-page.ts"],"names":[],"mappings":";;;AAEa,QAAA,WAAW,GAAW;IACjC,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE;QACV,GAAG,EAAE,IAAI;QACT,GAAG,EAAE,IAAI;QACT,GAAG,EAAE,GAAG;QACR,IAAI,EAAE,GAAG;QACT,GAAG,EAAE,IAAI;KACV;CACF,CAAC"}

package/dist/presets/marketing-site.d.ts

@@ -0,0 +1,3 @@
+import type { Preset } from "../types";
+export declare const marketingSite: Preset;
+//# sourceMappingURL=marketing-site.d.ts.map

package/dist/presets/marketing-site.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketing-site.d.ts","sourceRoot":"","sources":["../../src/presets/marketing-site.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,eAAO,MAAM,aAAa,EAAE,MAS3B,CAAC"}

package/dist/presets/marketing-site.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.marketingSite = void 0;
+exports.marketingSite = {
+    device: "mobile",
+    thresholds: {
+        lcp: 2500,
+        cls: 0.1,
+        inp: 200,
+        ttfb: 800,
+        fcp: 1800,
+    },
+};
+//# sourceMappingURL=marketing-site.js.map

package/dist/presets/marketing-site.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketing-site.js","sourceRoot":"","sources":["../../src/presets/marketing-site.ts"],"names":[],"mappings":";;;AAEa,QAAA,aAAa,GAAW;IACnC,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE;QACV,GAAG,EAAE,IAAI;QACT,GAAG,EAAE,GAAG;QACR,GAAG,EAAE,GAAG;QACR,IAAI,EAAE,GAAG;QACT,GAAG,EAAE,IAAI;KACV;CACF,CAAC"}

package/dist/presets/nextjs.d.ts

@@ -0,0 +1,3 @@
+import type { Preset } from "../types";
+export declare const nextjs: Preset;
+//# sourceMappingURL=nextjs.d.ts.map

package/dist/presets/nextjs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs.d.ts","sourceRoot":"","sources":["../../src/presets/nextjs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,eAAO,MAAM,MAAM,EAAE,MAYpB,CAAC"}

package/dist/presets/nextjs.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nextjs = void 0;
+exports.nextjs = {
+    device: "mobile",
+    thresholds: {
+        lcp: 2500,
+        cls: 0.1,
+        inp: 200,
+        ttfb: 800,
+        fcp: 1800,
+    },
+    lighthouseFlags: {
+        disableStorageReset: true,
+    },
+};
+//# sourceMappingURL=nextjs.js.map

package/dist/presets/nextjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs.js","sourceRoot":"","sources":["../../src/presets/nextjs.ts"],"names":[],"mappings":";;;AAEa,QAAA,MAAM,GAAW;IAC5B,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE;QACV,GAAG,EAAE,IAAI;QACT,GAAG,EAAE,GAAG;QACR,GAAG,EAAE,GAAG;QACR,IAAI,EAAE,GAAG;QACT,GAAG,EAAE,IAAI;KACV;IACD,eAAe,EAAE;QACf,mBAAmB,EAAE,IAAI;KAC1B;CACF,CAAC"}

package/dist/presets/registry.d.ts

@@ -0,0 +1,4 @@
+import type { Preset } from "../types";
+export declare const presets: Record<string, Preset>;
+export declare const presetNames: string[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/presets/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/presets/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAKvC,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAI1C,CAAC;AAEF,eAAO,MAAM,WAAW,UAAuB,CAAC"}

package/dist/presets/registry.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.presetNames = exports.presets = void 0;
+const nextjs_1 = require("./nextjs");
+const landing_page_1 = require("./landing-page");
+const marketing_site_1 = require("./marketing-site");
+exports.presets = {
+    nextjs: nextjs_1.nextjs,
+    "landing-page": landing_page_1.landingPage,
+    "marketing-site": marketing_site_1.marketingSite,
+};
+exports.presetNames = Object.keys(exports.presets);
+//# sourceMappingURL=registry.js.map

package/dist/presets/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/presets/registry.ts"],"names":[],"mappings":";;;AACA,qCAAkC;AAClC,iDAA6C;AAC7C,qDAAiD;AAEpC,QAAA,OAAO,GAA2B;IAC7C,MAAM,EAAN,eAAM;IACN,cAAc,EAAE,0BAAW;IAC3B,gBAAgB,EAAE,8BAAa;CAChC,CAAC;AAEW,QAAA,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,eAAO,CAAC,CAAC"}

package/dist/reporter.d.ts

@@ -0,0 +1,4 @@
+import type { PSGuardResult } from "./types";
+export declare function reportHuman(result: PSGuardResult): void;
+export declare function reportJSON(result: PSGuardResult): void;
+//# sourceMappingURL=reporter.d.ts.map

package/dist/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../src/reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAU7C,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAsBvD;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAEtD"}

package/dist/reporter.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reportHuman = reportHuman;
+exports.reportJSON = reportJSON;
+const hints_1 = require("./hints");
+const output_1 = require("./utils/output");
+function reportHuman(result) {
+    (0, output_1.printHeader)(result.url, result.device);
+    (0, output_1.printScoreRow)(result.score, result.minScore);
+    console.log();
+    for (const metric of result.metrics) {
+        (0, output_1.printMetricRow)(metric);
+        if (!metric.passed) {
+            const hints = (0, hints_1.getHints)(metric.name);
+            for (const hint of hints) {
+                (0, output_1.printHint)(hint);
+            }
+        }
+    }
+    const failedCount = result.metrics.filter((m) => !m.passed).length +
+        (result.score < result.minScore ? 1 : 0);
+    const totalCount = result.metrics.length + 1;
+    (0, output_1.printSummary)(result.passed, failedCount, totalCount);
+}
+function reportJSON(result) {
+    console.log(JSON.stringify(result, null, 2));
+}
+//# sourceMappingURL=reporter.js.map

package/dist/reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../src/reporter.ts"],"names":[],"mappings":";;AAUA,kCAsBC;AAED,gCAEC;AAnCD,mCAAmC;AACnC,2CAMwB;AAExB,SAAgB,WAAW,CAAC,MAAqB;IAC/C,IAAA,oBAAW,EAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACvC,IAAA,sBAAa,EAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,EAAE,CAAC;IAEd,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACpC,IAAA,uBAAc,EAAC,MAAM,CAAC,CAAC;QAEvB,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,KAAK,GAAG,IAAA,gBAAQ,EAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAA,kBAAS,EAAC,IAAI,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GACf,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM;QAC9C,CAAC,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IAE7C,IAAA,qBAAY,EAAC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;AACvD,CAAC;AAED,SAAgB,UAAU,CAAC,MAAqB;IAC9C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC/C,CAAC"}

package/dist/runner.d.ts

@@ -0,0 +1,16 @@
+import type { PSGuardConfig } from "./types";
+interface LighthouseResult {
+    lhr: {
+        categories: {
+            performance?: {
+                score: number | null;
+            };
+        };
+        audits: Record<string, {
+            numericValue?: number;
+        }>;
+    };
+}
+export declare function runLighthouse(config: PSGuardConfig): Promise<LighthouseResult>;
+export {};
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,UAAU,gBAAgB;IACxB,GAAG,EAAE;QACH,UAAU,EAAE;YACV,WAAW,CAAC,EAAE;gBAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;aAAE,CAAC;SACxC,CAAC;QACF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,YAAY,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACnD,CAAC;CACH;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA6CpF"}

package/dist/runner.js

@@ -0,0 +1,78 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runLighthouse = runLighthouse;
+async function runLighthouse(config) {
+    const chromeLauncher = await Promise.resolve().then(() => __importStar(require("chrome-launcher")));
+    const lighthouse = await Promise.resolve().then(() => __importStar(require("lighthouse")));
+    const chrome = await chromeLauncher.launch({
+        chromeFlags: ["--headless", "--no-sandbox", "--disable-gpu"],
+    });
+    const flags = {
+        port: chrome.port,
+        output: "json",
+        logLevel: "error",
+        formFactor: config.device === "mobile" ? "mobile" : "desktop",
+        screenEmulation: config.device === "mobile"
+            ? { mobile: true, width: 375, height: 812, deviceScaleFactor: 3, disabled: false }
+            : { mobile: false, width: 1350, height: 940, deviceScaleFactor: 1, disabled: false },
+        throttling: config.device === "mobile"
+            ? undefined
+            : { cpuSlowdownMultiplier: 1, downloadThroughputKbps: 0, uploadThroughputKbps: 0, rttMs: 0, requestLatencyMs: 0, throughputKbps: 0 },
+    };
+    const lighthouseConfig = {
+        extends: "lighthouse:default",
+        settings: {
+            onlyCategories: ["performance"],
+        },
+    };
+    let lastError;
+    for (let attempt = 0; attempt < config.retries; attempt++) {
+        try {
+            const runFn = lighthouse.default ?? lighthouse;
+            const result = await runFn(config.url, flags, lighthouseConfig);
+            await chrome.kill();
+            return result;
+        }
+        catch (error) {
+            lastError = error;
+        }
+    }
+    await chrome.kill();
+    throw lastError instanceof Error
+        ? lastError
+        : new Error(`Lighthouse failed after ${config.retries} attempt(s)`);
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWA,sCA6CC;AA7CM,KAAK,UAAU,aAAa,CAAC,MAAqB;IACvD,MAAM,cAAc,GAAG,wDAAa,iBAAiB,GAAC,CAAC;IACvD,MAAM,UAAU,GAAG,wDAAa,YAAY,GAAC,CAAC;IAE9C,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC;QACzC,WAAW,EAAE,CAAC,YAAY,EAAE,cAAc,EAAE,eAAe,CAAC;KAC7D,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG;QACZ,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM,EAAE,MAAe;QACvB,QAAQ,EAAE,OAAgB;QAC1B,UAAU,EAAE,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAiB,CAAC,CAAC,CAAC,SAAkB;QAC/E,eAAe,EAAE,MAAM,CAAC,MAAM,KAAK,QAAQ;YACzC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE;YAClF,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE;QACtF,UAAU,EAAE,MAAM,CAAC,MAAM,KAAK,QAAQ;YACpC,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,EAAE,qBAAqB,EAAE,CAAC,EAAE,sBAAsB,EAAE,CAAC,EAAE,oBAAoB,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE;KACvI,CAAC;IAEF,MAAM,gBAAgB,GAAG;QACvB,OAAO,EAAE,oBAAoB;QAC7B,QAAQ,EAAE;YACR,cAAc,EAAE,CAAC,aAAa,CAAC;SAChC;KACF,CAAC;IAEF,IAAI,SAAkB,CAAC;IAEvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC;QAC1D,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,IAAI,UAAU,CAAC;YAC/C,MAAM,MAAM,GAAG,MAAO,KAAkB,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,gBAAgB,CAAC,CAAC;YAC9E,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YACpB,OAAO,MAA0B,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,CAAC;QACpB,CAAC;IACH,CAAC;IAED,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IACpB,MAAM,SAAS,YAAY,KAAK;QAC9B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,IAAI,KAAK,CAAC,2BAA2B,MAAM,CAAC,OAAO,aAAa,CAAC,CAAC;AACxE,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,46 @@
+export interface PSGuardThresholds {
+    lcp?: number;
+    cls?: number;
+    inp?: number;
+    ttfb?: number;
+    fcp?: number;
+}
+export interface PSGuardConfig {
+    url: string;
+    device: "mobile" | "desktop";
+    minScore: number;
+    thresholds: PSGuardThresholds;
+    failOnError: boolean;
+    retries: number;
+    preset?: string;
+}
+export interface MetricResult {
+    name: string;
+    value: number;
+    limit: number;
+    passed: boolean;
+    unit: string;
+}
+export interface PSGuardResult {
+    passed: boolean;
+    score: number;
+    minScore: number;
+    metrics: MetricResult[];
+    url: string;
+    device: "mobile" | "desktop";
+}
+export interface Preset {
+    device: "mobile" | "desktop";
+    thresholds: PSGuardThresholds;
+    lighthouseFlags?: Record<string, unknown>;
+}
+export interface CLIArgs {
+    url?: string;
+    preset?: string;
+    device?: "mobile" | "desktop";
+    json: boolean;
+    ci: boolean;
+    help: boolean;
+    retries?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,iBAAiB,CAAC;IAC9B,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;CAC9B;AAED,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC7B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,OAAO;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/output.d.ts

@@ -0,0 +1,9 @@
+import type { MetricResult } from "../types";
+export declare function setCIMode(enabled: boolean): void;
+export declare function printHeader(url: string, device: string): void;
+export declare function printScoreRow(score: number, minScore: number): void;
+export declare function printMetricRow(metric: MetricResult): void;
+export declare function printHint(hint: string): void;
+export declare function printSummary(passed: boolean, failedCount: number, totalCount: number): void;
+export declare function printError(message: string): void;
+//# sourceMappingURL=output.d.ts.map

package/dist/utils/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAc7C,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEhD;AAYD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAO7D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAKnE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAQzD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE5C;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAU3F;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEhD"}

package/dist/utils/output.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setCIMode = setCIMode;
+exports.printHeader = printHeader;
+exports.printScoreRow = printScoreRow;
+exports.printMetricRow = printMetricRow;
+exports.printHint = printHint;
+exports.printSummary = printSummary;
+exports.printError = printError;
+const COLORS = {
+    red: "\x1b[31m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    cyan: "\x1b[36m",
+    dim: "\x1b[2m",
+    bold: "\x1b[1m",
+    reset: "\x1b[0m",
+};
+let ciMode = false;
+function setCIMode(enabled) {
+    ciMode = enabled;
+}
+function c(color, text) {
+    if (ciMode)
+        return text;
+    return `${COLORS[color]}${text}${COLORS.reset}`;
+}
+function bc(color, text) {
+    if (ciMode)
+        return text;
+    return `${COLORS.bold}${COLORS[color]}${text}${COLORS.reset}`;
+}
+function printHeader(url, device) {
+    console.log();
+    console.log(bc("cyan", "ps-guard"));
+    console.log();
+    console.log(`  URL:    ${c("cyan", url)}`);
+    console.log(`  Device: ${c("cyan", device)}`);
+    console.log();
+}
+function printScoreRow(score, minScore) {
+    const passed = score >= minScore;
+    const icon = passed ? c("green", "✔") : c("red", "✖");
+    const label = passed ? c("green", String(score)) : c("red", String(score));
+    console.log(`  ${icon} Performance Score: ${label} ${c("dim", `(min: ${minScore})`)}`);
+}
+function printMetricRow(metric) {
+    const icon = metric.passed ? c("green", "✔") : c("red", "✖");
+    const valueStr = metric.passed
+        ? c("green", `${metric.value}${metric.unit}`)
+        : c("red", `${metric.value}${metric.unit}`);
+    const limitStr = c("dim", `(max: ${metric.limit}${metric.unit})`);
+    const padding = " ".repeat(Math.max(0, 6 - metric.name.length));
+    console.log(`  ${icon} ${metric.name}${padding} ${valueStr} ${limitStr}`);
+}
+function printHint(hint) {
+    console.log(`    ${c("yellow", "→")} ${c("dim", hint)}`);
+}
+function printSummary(passed, failedCount, totalCount) {
+    console.log();
+    if (passed) {
+        console.log(`  ${bc("green", "✔ All checks passed")}`);
+    }
+    else {
+        console.log(`  ${bc("red", `✖ ${failedCount} of ${totalCount} checks failed`)}`);
+    }
+    console.log();
+}
+function printError(message) {
+    console.error(`\n  ${c("red", `✖ ${message}`)}\n`);
+}
+//# sourceMappingURL=output.js.map

package/dist/utils/output.js.map

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

package/dist/validator.d.ts

@@ -0,0 +1,14 @@
+import type { PSGuardConfig, PSGuardResult } from "./types";
+interface LighthouseLHR {
+    categories: {
+        performance?: {
+            score: number | null;
+        };
+    };
+    audits: Record<string, {
+        numericValue?: number;
+    }>;
+}
+export declare function validateResults(lhr: LighthouseLHR, config: PSGuardConfig): PSGuardResult;
+export {};
+//# sourceMappingURL=validator.d.ts.map

package/dist/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,aAAa,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAG1E,UAAU,aAAa;IACrB,UAAU,EAAE;QACV,WAAW,CAAC,EAAE;YAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,CAAC;KACxC,CAAC;IACF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACnD;AAED,wBAAgB,eAAe,CAC7B,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,aAAa,GACpB,aAAa,CAiBf"}

package/dist/validator.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateResults = validateResults;
+const parser_1 = require("./parser");
+function validateResults(lhr, config) {
+    const rawScore = lhr.categories.performance?.score ?? 0;
+    const score = Math.round(rawScore * 100);
+    const metrics = (0, parser_1.parseMetrics)(lhr.audits, config.thresholds);
+    const scorePassed = score >= config.minScore;
+    const allMetricsPassed = metrics.every((m) => m.passed);
+    return {
+        passed: scorePassed && allMetricsPassed,
+        score,
+        minScore: config.minScore,
+        metrics,
+        url: config.url,
+        device: config.device,
+    };
+}
+//# sourceMappingURL=validator.js.map

package/dist/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":";;AAUA,0CAoBC;AA7BD,qCAAwC;AASxC,SAAgB,eAAe,CAC7B,GAAkB,EAClB,MAAqB;IAErB,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC;IAEzC,MAAM,OAAO,GAAmB,IAAA,qBAAY,EAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAE5E,MAAM,WAAW,GAAG,KAAK,IAAI,MAAM,CAAC,QAAQ,CAAC;IAC7C,MAAM,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAExD,OAAO;QACL,MAAM,EAAE,WAAW,IAAI,gBAAgB;QACvC,KAAK;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,OAAO;QACP,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@promise-inc/ps-guard",
+  "version": "0.1.0",
+  "description": "Lighthouse-based performance guard. Enforce Web Vitals thresholds in CI and locally.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "ps-guard": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/cli.js"
+  },
+  "keywords": [
+    "performance",
+    "lighthouse",
+    "web-vitals",
+    "guard",
+    "ci",
+    "lcp",
+    "cls",
+    "inp",
+    "ttfb",
+    "devtools"
+  ],
+  "homepage": "https://github.com/promise-inc/ps-guard#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/promise-inc/ps-guard.git"
+  },
+  "bugs": {
+    "url": "https://github.com/promise-inc/ps-guard/issues"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "lighthouse": "^12.0.0",
+    "chrome-launcher": "^1.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}