laxy-verify 1.3.0 → 1.3.2

package/dist/compare-env.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Multi-environment Lighthouse comparison (Pro feature).
+ *
+ * Compares Lighthouse scores between the local build and a reference
+ * environment URL (e.g. staging, production) to detect regressions
+ * introduced by the current PR.
+ */
+import type { LighthouseScores } from "./grade.js";
+export interface EnvComparisonResult {
+    localUrl: string;
+    compareUrl: string;
+    local: LighthouseScores | null;
+    compare: LighthouseScores | null;
+    /** Positive = local is better, negative = compare env is better */
+    delta: {
+        performance: number | null;
+        accessibility: number | null;
+        seo: number | null;
+        bestPractices: number | null;
+    } | null;
+}
+export declare function runEnvComparison(localPort: number, compareUrl: string, runs?: number): Promise<EnvComparisonResult>;
+export declare function printEnvComparison(result: EnvComparisonResult): void;

package/dist/compare-env.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runEnvComparison = runEnvComparison;
+exports.printEnvComparison = printEnvComparison;
+const lighthouse_js_1 = require("./lighthouse.js");
+function scoreDelta(local, compare) {
+    if (!local || !compare)
+        return null;
+    return {
+        performance: local.performance - compare.performance,
+        accessibility: local.accessibility - compare.accessibility,
+        seo: local.seo - compare.seo,
+        bestPractices: local.bestPractices - compare.bestPractices,
+    };
+}
+async function runEnvComparison(localPort, compareUrl, runs = 1) {
+    const localUrl = `http://127.0.0.1:${localPort}/`;
+    console.log(`\n  [compare] Running env comparison: local vs ${compareUrl}`);
+    const [localResult, compareResult] = await Promise.all([
+        (0, lighthouse_js_1.runLighthouseOnUrl)(localUrl, runs),
+        (0, lighthouse_js_1.runLighthouseOnUrl)(compareUrl, runs),
+    ]);
+    return {
+        localUrl,
+        compareUrl,
+        local: localResult.scores,
+        compare: compareResult.scores,
+        delta: scoreDelta(localResult.scores, compareResult.scores),
+    };
+}
+function printEnvComparison(result) {
+    console.log("\n  Environment comparison:");
+    console.log(`    Local:   ${result.localUrl}`);
+    console.log(`    Compare: ${result.compareUrl}`);
+    if (!result.local && !result.compare) {
+        console.log("    Both environments returned no Lighthouse data.");
+        return;
+    }
+    const fmt = (v) => (v === null ? "—" : String(v));
+    const fmtDelta = (d) => {
+        if (d === null)
+            return "";
+        if (d > 0)
+            return ` (+${d})`;
+        if (d < 0)
+            return ` (${d})`;
+        return " (=)";
+    };
+    const d = result.delta;
+    console.log("    Metric           Local  Compare  Delta");
+    console.log(`    Performance      ${fmt(result.local?.performance ?? null).padEnd(6)} ${fmt(result.compare?.performance ?? null).padEnd(8)}${fmtDelta(d?.performance ?? null)}`);
+    console.log(`    Accessibility    ${fmt(result.local?.accessibility ?? null).padEnd(6)} ${fmt(result.compare?.accessibility ?? null).padEnd(8)}${fmtDelta(d?.accessibility ?? null)}`);
+    console.log(`    SEO              ${fmt(result.local?.seo ?? null).padEnd(6)} ${fmt(result.compare?.seo ?? null).padEnd(8)}${fmtDelta(d?.seo ?? null)}`);
+    console.log(`    Best Practices   ${fmt(result.local?.bestPractices ?? null).padEnd(6)} ${fmt(result.compare?.bestPractices ?? null).padEnd(8)}${fmtDelta(d?.bestPractices ?? null)}`);
+}

package/dist/config.d.ts

@@ -1,102 +1,102 @@
-export type FailOn = "unverified" | "bronze" | "silver" | "gold";
-export interface Thresholds {
-    performance: number;
-    accessibility: number;
-    seo: number;
-    bestPractices: number;
-}
-export interface UserScenarioStep {
-    goto?: string;
-    fill?: string;
-    with?: string;
-    click?: string;
-    expect_visible?: string;
-    expect_text?: string;
-    wait?: number;
-}
-export interface UserScenario {
-    name: string;
-    steps: UserScenarioStep[];
-}
-export interface VisualDiffConfig {
-    pixelmatchThreshold: number;
-    warnThreshold: number;
-    rollbackThreshold: number;
-    ignoreSelectors: string[];
-    disableAnimations: boolean;
-}
-export interface LaxyConfig {
-    framework: string;
-    build_command: string;
-    dev_command: string;
-    package_manager: string;
-    port: number;
-    build_timeout: number;
-    dev_timeout: number;
-    lighthouse_runs: number;
-    thresholds: Thresholds;
-    fail_on: FailOn;
-    scenarios?: UserScenario[];
-    crawl: boolean;
-    max_crawl_depth: number;
-    max_crawl_pages: number;
-    browsers: string[];
-    /** Explicit list of routes to audit with Lighthouse (e.g. ["/", "/about", "/pricing"]). */
-    lighthouse_routes?: string[];
-    /** Extra routes to audit even if the crawler cannot discover them (e.g. SPA router.push routes). */
-    extra_routes?: string[];
-    /** Maximum number of crawl-discovered routes to run Lighthouse on. Default: 5. */
-    max_lighthouse_routes: number;
-    visual_diff: VisualDiffConfig;
-    /** Run TypeScript type check (tsc --noEmit). Default: false. */
-    typecheck: boolean;
-    /** Run secret/credential leak scan. Default: false. */
-    secret_scan: boolean;
-    /** Paths to ignore during secret scan. */
-    secret_scan_ignore_paths: string[];
-    /** Run bundle size analysis. Default: false. */
-    bundle_size: boolean;
-    /** Run outdated dependency check. Default: false. */
-    outdated_check: boolean;
-    /** Run deep accessibility audit (axe-core). Default: false. */
-    a11y_deep: boolean;
-    /** Run deep SEO audit. Default: false. */
-    seo_deep: boolean;
-    /** Run Core Web Vitals budget check. Default: false. */
-    vitals_budget: boolean;
-}
-export declare class ConfigParseError extends Error {
-    constructor(msg: string);
-}
-export interface TeamThresholdsConfig {
-    performance: number;
-    accessibility: number;
-    seo: number;
-    best_practices: number;
-    fail_on: FailOn;
-}
-/**
- * 로그인된 CLI 토큰으로 팀 공통 임계값을 서버에서 가져온다.
- * 토큰 없음 / 팀 없음 / 네트워크 오류 시 null 반환 (graceful degradation).
- */
-export declare function fetchTeamThresholds(): Promise<TeamThresholdsConfig | null>;
-export interface LoadConfigOptions {
-    dir: string;
-    configPath?: string;
-    cliFlags?: {
-        failOn?: FailOn;
-        skipLighthouse?: boolean;
-        typecheck?: boolean;
-        secretScan?: boolean;
-        bundleSize?: boolean;
-        outdatedCheck?: boolean;
-        a11yDeep?: boolean;
-        seoDeep?: boolean;
-        vitalsBudget?: boolean;
-    };
-    ciMode: boolean;
-    teamThresholds?: TeamThresholdsConfig | null;
-}
-export declare function loadConfig(options: LoadConfigOptions): LaxyConfig & {
-    ciMode: boolean;
-};
+export type FailOn = "unverified" | "bronze" | "silver" | "gold";
+export interface Thresholds {
+    performance: number;
+    accessibility: number;
+    seo: number;
+    bestPractices: number;
+}
+export interface UserScenarioStep {
+    goto?: string;
+    fill?: string;
+    with?: string;
+    click?: string;
+    expect_visible?: string;
+    expect_text?: string;
+    wait?: number;
+}
+export interface UserScenario {
+    name: string;
+    steps: UserScenarioStep[];
+}
+export interface VisualDiffConfig {
+    pixelmatchThreshold: number;
+    warnThreshold: number;
+    rollbackThreshold: number;
+    ignoreSelectors: string[];
+    disableAnimations: boolean;
+}
+export interface LaxyConfig {
+    framework: string;
+    build_command: string;
+    dev_command: string;
+    package_manager: string;
+    port: number;
+    build_timeout: number;
+    dev_timeout: number;
+    lighthouse_runs: number;
+    thresholds: Thresholds;
+    fail_on: FailOn;
+    scenarios?: UserScenario[];
+    crawl: boolean;
+    max_crawl_depth: number;
+    max_crawl_pages: number;
+    browsers: string[];
+    /** Explicit list of routes to audit with Lighthouse (e.g. ["/", "/about", "/pricing"]). */
+    lighthouse_routes?: string[];
+    /** Extra routes to audit even if the crawler cannot discover them (e.g. SPA router.push routes). */
+    extra_routes?: string[];
+    /** Maximum number of crawl-discovered routes to run Lighthouse on. Default: 5. */
+    max_lighthouse_routes: number;
+    visual_diff: VisualDiffConfig;
+    /** Run TypeScript type check (tsc --noEmit). Default: false. */
+    typecheck: boolean;
+    /** Run secret/credential leak scan. Default: false. */
+    secret_scan: boolean;
+    /** Paths to ignore during secret scan. */
+    secret_scan_ignore_paths: string[];
+    /** Run bundle size analysis. Default: false. */
+    bundle_size: boolean;
+    /** Run outdated dependency check. Default: false. */
+    outdated_check: boolean;
+    /** Run deep accessibility audit (axe-core). Default: false. */
+    a11y_deep: boolean;
+    /** Run deep SEO audit. Default: false. */
+    seo_deep: boolean;
+    /** Run Core Web Vitals budget check. Default: false. */
+    vitals_budget: boolean;
+}
+export declare class ConfigParseError extends Error {
+    constructor(msg: string);
+}
+export interface TeamThresholdsConfig {
+    performance: number;
+    accessibility: number;
+    seo: number;
+    best_practices: number;
+    fail_on: FailOn;
+}
+/**
+ * 로그인된 CLI 토큰으로 팀 공통 임계값을 서버에서 가져온다.
+ * 토큰 없음 / 팀 없음 / 네트워크 오류 시 null 반환 (graceful degradation).
+ */
+export declare function fetchTeamThresholds(): Promise<TeamThresholdsConfig | null>;
+export interface LoadConfigOptions {
+    dir: string;
+    configPath?: string;
+    cliFlags?: {
+        failOn?: FailOn;
+        skipLighthouse?: boolean;
+        typecheck?: boolean;
+        secretScan?: boolean;
+        bundleSize?: boolean;
+        outdatedCheck?: boolean;
+        a11yDeep?: boolean;
+        seoDeep?: boolean;
+        vitalsBudget?: boolean;
+    };
+    ciMode: boolean;
+    teamThresholds?: TeamThresholdsConfig | null;
+}
+export declare function loadConfig(options: LoadConfigOptions): LaxyConfig & {
+    ciMode: boolean;
+};