pressship 0.1.0

package/dist/checks/plugin-check-environment.js

@@ -0,0 +1,209 @@
+import { createWriteStream } from "node:fs";
+import { chmod, mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { pipeline } from "node:stream/promises";
+import { execa } from "execa";
+import extract from "extract-zip";
+import { ui } from "../ui.js";
+import { ensureCacheDir, pathExists } from "../utils/paths.js";
+const wpCliUrl = "https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar";
+const pluginCheckZipUrl = "https://downloads.wordpress.org/plugin/plugin-check.zip";
+const sqliteIntegrationZipUrl = "https://downloads.wordpress.org/plugin/sqlite-database-integration.zip";
+export async function prepareManagedPluginCheckEnvironment() {
+    const cacheDir = await ensureCacheDir();
+    const wpCli = await resolveWpCli(cacheDir);
+    const wpPath = path.join(cacheDir, "wordpress");
+    await ensureWordPressCore(wpCli, wpPath);
+    const requirePath = await ensurePluginCheckPlugin(wpPath);
+    return {
+        wpCli,
+        wpPath,
+        requirePath
+    };
+}
+export async function resolveWpCli(cacheDir) {
+    const systemWp = await execa("wp", ["--version"], { reject: false });
+    if (systemWp.exitCode === 0) {
+        return { command: "wp", baseArgs: [] };
+    }
+    const pharPath = path.join(cacheDir, "wp-cli.phar");
+    if (!pathExists(pharPath)) {
+        ui.info("Downloading WP-CLI for managed Plugin Check.");
+        await downloadFile(wpCliUrl, pharPath);
+        await chmod(pharPath, 0o755);
+    }
+    const phpAvailable = await execa("php", ["--version"], { reject: false });
+    if (phpAvailable.exitCode !== 0) {
+        throw new Error("PHP is required to run the managed WP-CLI phar, but `php` was not found.");
+    }
+    return { command: "php", baseArgs: [pharPath] };
+}
+async function ensureWordPressCore(wpCli, wpPath) {
+    if (!pathExists(path.join(wpPath, "wp-includes", "version.php"))) {
+        await mkdir(wpPath, { recursive: true });
+        ui.info("Downloading WordPress core for managed Plugin Check.");
+        await runWpCli(wpCli, ["core", "download", `--path=${wpPath}`, "--skip-content", "--force"]);
+    }
+    await ensureSqliteIntegration(wpPath);
+    await ensureWpConfig(wpPath);
+    await ensureWordPressInstalled(wpCli, wpPath);
+}
+export async function ensureWpConfig(wpPath) {
+    const configPath = path.join(wpPath, "wp-config.php");
+    if (pathExists(configPath)) {
+        return;
+    }
+    await writeFile(configPath, getManagedWpConfig(), { mode: 0o600 });
+}
+export function getManagedWpConfig() {
+    return `<?php
+/**
+ * Managed by Pressship for static WordPress.org Plugin Check runs.
+ *
+ * The checker runs without a real site database for static checks, but WP-CLI
+ * still requires wp-config.php to bootstrap WordPress.
+ */
+define( 'DB_NAME', 'pressship_plugin_check' );
+define( 'DB_USER', 'pressship' );
+define( 'DB_PASSWORD', 'pressship' );
+define( 'DB_HOST', '127.0.0.1' );
+define( 'DB_CHARSET', 'utf8mb4' );
+define( 'DB_COLLATE', '' );
+
+define( 'AUTH_KEY',         'pressship-auth-key' );
+define( 'SECURE_AUTH_KEY',  'pressship-secure-auth-key' );
+define( 'LOGGED_IN_KEY',    'pressship-logged-in-key' );
+define( 'NONCE_KEY',        'pressship-nonce-key' );
+define( 'AUTH_SALT',        'pressship-auth-salt' );
+define( 'SECURE_AUTH_SALT', 'pressship-secure-auth-salt' );
+define( 'LOGGED_IN_SALT',   'pressship-logged-in-salt' );
+define( 'NONCE_SALT',       'pressship-nonce-salt' );
+
+$table_prefix = 'wp_';
+
+if ( ! defined( 'ABSPATH' ) ) {
+\tdefine( 'ABSPATH', __DIR__ . '/' );
+}
+
+require_once ABSPATH . 'wp-settings.php';
+`;
+}
+export async function ensureSqliteIntegration(wpPath) {
+    const pluginDir = path.join(wpPath, "wp-content", "plugins", "sqlite-database-integration");
+    const dropInPath = path.join(wpPath, "wp-content", "db.php");
+    const dropInTemplatePath = path.join(pluginDir, "db.copy");
+    if (!pathExists(dropInTemplatePath)) {
+        const pluginsDir = path.dirname(pluginDir);
+        const zipPath = path.join(pluginsDir, "sqlite-database-integration.zip");
+        await mkdir(pluginsDir, { recursive: true });
+        ui.info("Downloading SQLite integration for managed WordPress.");
+        await downloadFile(sqliteIntegrationZipUrl, zipPath);
+        await rm(pluginDir, { recursive: true, force: true });
+        await extract(zipPath, { dir: pluginsDir });
+        await rm(zipPath, { force: true });
+    }
+    if (!pathExists(dropInTemplatePath)) {
+        throw new Error("Downloaded SQLite integration, but could not find its db.copy drop-in template.");
+    }
+    await writeFile(dropInPath, await getSqliteDropIn(dropInTemplatePath, pluginDir), { mode: 0o644 });
+}
+export async function getSqliteDropIn(dropInTemplatePath, pluginDir) {
+    return getSqliteDropInFromTemplate(await readFile(dropInTemplatePath, "utf8"), pluginDir);
+}
+export function getSqliteDropInFromTemplate(template, pluginDir) {
+    const normalizedPluginDir = pluginDir.replace(/\\/g, "/");
+    return template
+        .replaceAll("{SQLITE_IMPLEMENTATION_FOLDER_PATH}", normalizedPluginDir)
+        .replaceAll("{SQLITE_PLUGIN}", "sqlite-database-integration/load.php");
+}
+async function ensureWordPressInstalled(wpCli, wpPath) {
+    const isInstalled = await runWpCli(wpCli, ["core", "is-installed", `--path=${wpPath}`], {
+        capture: true,
+        reject: false
+    });
+    if (isInstalled.exitCode === 0) {
+        return;
+    }
+    ui.info("Installing managed WordPress site with SQLite.");
+    await runWpCli(wpCli, [
+        "core",
+        "install",
+        `--path=${wpPath}`,
+        "--url=http://pressship.local",
+        "--title=Pressship Plugin Check",
+        "--admin_user=pressship",
+        "--admin_password=pressship",
+        "--admin_email=pressship@example.invalid",
+        "--skip-email"
+    ]);
+}
+async function ensurePluginCheckPlugin(wpPath) {
+    const pluginDir = path.join(wpPath, "wp-content", "plugins", "plugin-check");
+    const pluginMainPath = path.join(pluginDir, "plugin.php");
+    const cliPath = path.join(pluginDir, "cli.php");
+    const requirePath = path.join(wpPath, "wp-content", "pressship-plugin-check-loader.php");
+    if (pathExists(pluginMainPath) && pathExists(cliPath)) {
+        await writePluginCheckLoader(requirePath, pluginMainPath, pluginDir, cliPath);
+        return requirePath;
+    }
+    const pluginsDir = path.dirname(pluginDir);
+    const zipPath = path.join(pluginsDir, "plugin-check.zip");
+    await mkdir(pluginsDir, { recursive: true });
+    ui.info("Downloading WordPress.org Plugin Check.");
+    await downloadFile(pluginCheckZipUrl, zipPath);
+    await rm(pluginDir, { recursive: true, force: true });
+    await extract(zipPath, { dir: pluginsDir });
+    await rm(zipPath, { force: true });
+    if (!pathExists(pluginMainPath) || !pathExists(cliPath)) {
+        throw new Error("Downloaded Plugin Check, but could not find its WP-CLI loader at plugin-check/cli.php.");
+    }
+    await writePluginCheckLoader(requirePath, pluginMainPath, pluginDir, cliPath);
+    return requirePath;
+}
+async function writePluginCheckLoader(loaderPath, pluginMainPath, pluginDir, cliPath) {
+    await writeFile(loaderPath, `<?php
+/**
+ * Managed by Pressship to load Plugin Check for WP-CLI.
+ */
+if ( ! defined( 'WP_PLUGIN_CHECK_VERSION' ) ) {
+\tdefine( 'WP_PLUGIN_CHECK_VERSION', '1.9.0' );
+}
+if ( ! defined( 'WP_PLUGIN_CHECK_MINIMUM_PHP' ) ) {
+\tdefine( 'WP_PLUGIN_CHECK_MINIMUM_PHP', '7.4' );
+}
+if ( ! defined( 'WP_PLUGIN_CHECK_MAIN_FILE' ) ) {
+\tdefine( 'WP_PLUGIN_CHECK_MAIN_FILE', ${JSON.stringify(pluginMainPath)} );
+}
+if ( ! defined( 'WP_PLUGIN_CHECK_PLUGIN_DIR_PATH' ) ) {
+\tdefine( 'WP_PLUGIN_CHECK_PLUGIN_DIR_PATH', ${JSON.stringify(pluginDir.endsWith(path.sep) ? pluginDir : `${pluginDir}${path.sep}`)} );
+}
+if ( ! defined( 'WP_PLUGIN_CHECK_PLUGIN_DIR_URL' ) ) {
+\tdefine( 'WP_PLUGIN_CHECK_PLUGIN_DIR_URL', '' );
+}
+require_once ${JSON.stringify(cliPath)};
+`, { mode: 0o644 });
+}
+async function runWpCli(wpCli, args, options = {}) {
+    const result = await execa(wpCli.command, [...wpCli.baseArgs, ...args], {
+        reject: false,
+        stdout: options.capture ? "pipe" : "inherit",
+        stderr: options.capture ? "pipe" : "inherit"
+    });
+    if (options.reject !== false && result.exitCode !== 0) {
+        throw new Error(`WP-CLI command failed: ${[wpCli.command, ...wpCli.baseArgs, ...args].join(" ")}`);
+    }
+    return {
+        exitCode: result.exitCode ?? 1,
+        stdout: result.stdout ?? "",
+        stderr: result.stderr ?? ""
+    };
+}
+async function downloadFile(url, destination) {
+    const response = await fetch(url);
+    if (!response.ok || !response.body) {
+        throw new Error(`Could not download ${url}: ${response.status} ${response.statusText}`);
+    }
+    await mkdir(path.dirname(destination), { recursive: true });
+    await pipeline(response.body, createWriteStream(destination));
+}
+//# sourceMappingURL=plugin-check-environment.js.map

package/dist/checks/plugin-check-environment.js.map

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

package/dist/checks/plugin-check.d.ts

@@ -0,0 +1,16 @@
+import type { Finding } from "../types.js";
+export type PluginCheckOptions = {
+    mode?: "new" | "update";
+    skip?: boolean;
+    extraArgs?: string[];
+    wpPath?: string;
+};
+export type PluginCheckResult = {
+    skipped: boolean;
+    available: boolean;
+    findings: Finding[];
+    rawOutput?: string;
+};
+export declare function runPluginCheck(target: string, options?: PluginCheckOptions): Promise<PluginCheckResult>;
+export declare function parsePluginCheckOutput(output: string, exitCode?: number): Finding[];
+export declare function getPluginCheckSetupFinding(output: string): Finding | undefined;

package/dist/checks/plugin-check.js

@@ -0,0 +1,176 @@
+import { execa } from "execa";
+import { prepareManagedPluginCheckEnvironment } from "./plugin-check-environment.js";
+export async function runPluginCheck(target, options = {}) {
+    if (options.skip) {
+        return { skipped: true, available: true, findings: [] };
+    }
+    const environment = await resolvePluginCheckEnvironment(options);
+    if (!environment.available) {
+        return {
+            skipped: false,
+            available: false,
+            findings: [environment.finding]
+        };
+    }
+    const args = [
+        `--path=${environment.wpPath}`,
+        ...(environment.requirePath ? [`--require=${environment.requirePath}`] : []),
+        "plugin",
+        "check",
+        target,
+        "--format=strict-json",
+        "--fields=file,line,column,type,code,message,docs",
+        `--mode=${options.mode ?? "new"}`,
+        ...(options.extraArgs ?? [])
+    ];
+    const result = await execa(environment.wpCli.command, [...environment.wpCli.baseArgs, ...args], { reject: false });
+    const rawOutput = `${result.stdout}\n${result.stderr}`.trim();
+    const setupFinding = getPluginCheckSetupFinding(rawOutput);
+    return {
+        skipped: false,
+        available: !setupFinding,
+        rawOutput,
+        findings: setupFinding ? [setupFinding] : parsePluginCheckOutput(rawOutput, result.exitCode)
+    };
+}
+export function parsePluginCheckOutput(output, exitCode = 0) {
+    if (!output.trim()) {
+        return exitCode === 0
+            ? []
+            : [
+                {
+                    severity: "error",
+                    code: "plugin_check.failed",
+                    message: "Plugin Check failed without JSON output."
+                }
+            ];
+    }
+    const jsonText = extractJson(output);
+    if (!jsonText) {
+        const setupFinding = getPluginCheckSetupFinding(output);
+        if (setupFinding) {
+            return [setupFinding];
+        }
+        return [
+            {
+                severity: exitCode === 0 ? "warning" : "error",
+                code: "plugin_check.unparsed_output",
+                message: output
+            }
+        ];
+    }
+    try {
+        const parsed = JSON.parse(jsonText);
+        return normalizePluginCheckFindings(parsed);
+    }
+    catch {
+        return [
+            {
+                severity: exitCode === 0 ? "warning" : "error",
+                code: "plugin_check.invalid_json",
+                message: output
+            }
+        ];
+    }
+}
+export function getPluginCheckSetupFinding(output) {
+    if (/No WordPress installation found/i.test(output)) {
+        return {
+            severity: "warning",
+            code: "plugin_check.wordpress_path_missing",
+            message: "WP-CLI could not find a WordPress installation. Re-run with `--wp-path /path/to/wordpress`, or use `--skip-plugin-check`."
+        };
+    }
+    if (/'check' is not a registered subcommand of 'plugin'|not a registered subcommand/i.test(output)) {
+        return {
+            severity: "warning",
+            code: "plugin_check.command_missing",
+            message: "WP-CLI is available, but `wp plugin check` is not registered. Install and activate the WordPress.org Plugin Check plugin in your WordPress install, then pass `--wp-path /path/to/wordpress`, or use `--skip-plugin-check`."
+        };
+    }
+    return undefined;
+}
+function extractJson(output) {
+    const trimmed = output.trim();
+    if (trimmed.startsWith("[") || trimmed.startsWith("{")) {
+        return trimmed;
+    }
+    const arrayStart = trimmed.indexOf("[");
+    const objectStart = trimmed.indexOf("{");
+    const start = [arrayStart, objectStart].filter((index) => index >= 0).sort((a, b) => a - b)[0];
+    return start === undefined ? undefined : trimmed.slice(start);
+}
+async function resolvePluginCheckEnvironment(options) {
+    if (options.wpPath) {
+        const systemWp = await execa("wp", ["--version"], { reject: false });
+        if (systemWp.exitCode !== 0) {
+            return {
+                available: false,
+                finding: {
+                    severity: "warning",
+                    code: "plugin_check.wp_cli_missing",
+                    message: "WP-CLI was not found. Pressship can manage WP-CLI automatically when `--wp-path` is omitted, or install WP-CLI yourself for this custom path."
+                }
+            };
+        }
+        return {
+            available: true,
+            wpCli: { command: "wp", baseArgs: [] },
+            wpPath: options.wpPath
+        };
+    }
+    try {
+        const managed = await prepareManagedPluginCheckEnvironment();
+        return {
+            available: true,
+            wpCli: managed.wpCli,
+            wpPath: managed.wpPath,
+            requirePath: managed.requirePath
+        };
+    }
+    catch (error) {
+        return {
+            available: false,
+            finding: {
+                severity: "warning",
+                code: "plugin_check.managed_setup_failed",
+                message: `Could not prepare managed Plugin Check environment automatically. ${error instanceof Error ? error.message : String(error)} Use \`--skip-plugin-check\` to bypass this step.`
+            }
+        };
+    }
+}
+function normalizePluginCheckFindings(parsed) {
+    const records = Array.isArray(parsed)
+        ? parsed
+        : typeof parsed === "object" && parsed !== null && "results" in parsed && Array.isArray(parsed.results)
+            ? parsed.results
+            : [];
+    return records.flatMap((record) => {
+        if (typeof record !== "object" || record === null) {
+            return [];
+        }
+        const item = record;
+        const severity = normalizeSeverity(item.type ?? item.severity);
+        const message = String(item.message ?? item.description ?? item.title ?? "Plugin Check finding");
+        const code = item.code ? String(item.code) : item.check ? String(item.check) : undefined;
+        const file = firstString(item.file, item.filename, item.path);
+        const line = typeof item.line === "number" ? item.line : undefined;
+        const column = typeof item.column === "number" ? item.column : undefined;
+        return [{ severity, message, code, file, line, column }];
+    });
+}
+function normalizeSeverity(value) {
+    const text = String(value ?? "").toLowerCase();
+    if (text.includes("error")) {
+        return "error";
+    }
+    if (text.includes("warn")) {
+        return "warning";
+    }
+    return "info";
+}
+function firstString(...values) {
+    const value = values.find((item) => typeof item === "string" && item.length > 0);
+    return typeof value === "string" ? value : undefined;
+}
+//# sourceMappingURL=plugin-check.js.map

package/dist/checks/plugin-check.js.map

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

package/dist/checks/readme-validator.d.ts

@@ -0,0 +1,16 @@
+import type { Finding } from "../types.js";
+export type ReadmeValidationOptions = {
+    skipRemote?: boolean;
+    headless?: boolean;
+};
+export type ReadmeValidationResult = {
+    skippedRemote: boolean;
+    findings: Finding[];
+    rawRemoteText?: string;
+};
+export declare function validateReadmeFile(readmePath: string, options?: ReadmeValidationOptions): Promise<ReadmeValidationResult>;
+export declare function validateReadmeWithWordPress(contents: string, options?: ReadmeValidationOptions): Promise<{
+    findings: Finding[];
+    rawRemoteText: string;
+}>;
+export declare function parseReadmeValidatorText(text: string): Finding[];

package/dist/checks/readme-validator.js

@@ -0,0 +1,84 @@
+import { readFile } from "node:fs/promises";
+import { openBrowserSession } from "../auth/session.js";
+import { parseReadme, validateReadmeLocally } from "../plugin/readme.js";
+export async function validateReadmeFile(readmePath, options = {}) {
+    const contents = await readFile(readmePath, "utf8");
+    const localFindings = validateReadmeLocally(contents, parseReadme(contents));
+    if (options.skipRemote) {
+        return { skippedRemote: true, findings: localFindings };
+    }
+    const remote = await validateReadmeWithWordPress(contents, options);
+    return {
+        skippedRemote: false,
+        findings: [...localFindings, ...remote.findings],
+        rawRemoteText: remote.rawRemoteText
+    };
+}
+export async function validateReadmeWithWordPress(contents, options = {}) {
+    const { context, page } = await openBrowserSession({ headless: options.headless ?? true });
+    try {
+        await page.goto("https://wordpress.org/plugins/developers/readme-validator/", {
+            waitUntil: "domcontentloaded"
+        });
+        await fillReadmeValidator(page, contents);
+        const rawRemoteText = await page.locator("body").innerText({ timeout: 15_000 });
+        return {
+            rawRemoteText,
+            findings: parseReadmeValidatorText(rawRemoteText)
+        };
+    }
+    finally {
+        await context.browser()?.close();
+    }
+}
+export function parseReadmeValidatorText(text) {
+    const lines = text
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter(Boolean);
+    const findings = [];
+    for (const line of lines) {
+        if (/^(error|warning|notice):/i.test(line)) {
+            const [severityText, ...messageParts] = line.split(":");
+            findings.push({
+                severity: normalizeSeverity(severityText),
+                message: messageParts.join(":").trim(),
+                code: "readme_validator.remote"
+            });
+        }
+    }
+    if (findings.length === 0 && /fatal error|parse error|invalid|not valid/i.test(text)) {
+        findings.push({
+            severity: "error",
+            code: "readme_validator.remote",
+            message: compactText(text)
+        });
+    }
+    return findings;
+}
+async function fillReadmeValidator(page, contents) {
+    const textarea = page.locator("textarea").first();
+    await textarea.fill(contents);
+    const submit = page
+        .getByRole("button", { name: /validate|submit|check/i })
+        .or(page.locator('input[type="submit"]'))
+        .first();
+    await Promise.all([
+        page.waitForLoadState("networkidle").catch(() => undefined),
+        submit.click()
+    ]);
+}
+function normalizeSeverity(value) {
+    const normalized = value.toLowerCase();
+    if (normalized.includes("error")) {
+        return "error";
+    }
+    if (normalized.includes("warning")) {
+        return "warning";
+    }
+    return "info";
+}
+function compactText(text) {
+    return text.replace(/\s+/g, " ").trim().slice(0, 500);
+}
+//# sourceMappingURL=readme-validator.js.map

package/dist/checks/readme-validator.js.map

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

package/dist/checks/summary.d.ts

@@ -0,0 +1,3 @@
+import type { Finding } from "../types.js";
+export declare function hasBlockingFindings(findings: Finding[]): boolean;
+export declare function printFindings(title: string, findings: Finding[]): void;

package/dist/checks/summary.js

@@ -0,0 +1,73 @@
+import { ui } from "../ui.js";
+const useColor = process.stdout.isTTY && !process.env.NO_COLOR;
+export function hasBlockingFindings(findings) {
+    return findings.some((finding) => finding.severity === "error");
+}
+export function printFindings(title, findings) {
+    if (findings.length === 0) {
+        ui.success(`${title}: ${green("no findings")}`);
+        return;
+    }
+    ui.section(`${title}: ${formatCounts(findings)}`);
+    for (const finding of findings) {
+        const severity = formatSeverity(finding.severity);
+        const code = finding.code ? dim(`[${finding.code}]`) : "";
+        const location = formatLocation(finding);
+        const meta = [code, location].filter(Boolean).join(" ");
+        const prefix = meta ? `${severity} ${meta}` : severity;
+        console.log(`  ${prefix}`);
+        console.log(`    ${finding.message}`);
+    }
+}
+function formatCounts(findings) {
+    const errors = findings.filter((finding) => finding.severity === "error").length;
+    const warnings = findings.filter((finding) => finding.severity === "warning").length;
+    const info = findings.filter((finding) => finding.severity === "info").length;
+    const parts = [
+        errors ? red(`${errors} error${errors === 1 ? "" : "s"}`) : "",
+        warnings ? yellow(`${warnings} warning${warnings === 1 ? "" : "s"}`) : "",
+        info ? blue(`${info} info`) : ""
+    ].filter(Boolean);
+    return parts.join(", ");
+}
+function formatSeverity(severity) {
+    if (severity === "error") {
+        return red("ERROR");
+    }
+    if (severity === "warning") {
+        return yellow("WARN ");
+    }
+    return blue("INFO ");
+}
+function formatLocation(finding) {
+    if (!finding.file) {
+        return dim("(global)");
+    }
+    const parts = [finding.file, finding.line, finding.column].filter((part) => part !== undefined && part !== 0);
+    return cyan(parts.join(":"));
+}
+function bold(value) {
+    return color(value, "1");
+}
+function red(value) {
+    return color(value, "31");
+}
+function yellow(value) {
+    return color(value, "33");
+}
+function green(value) {
+    return color(value, "32");
+}
+function blue(value) {
+    return color(value, "34");
+}
+function cyan(value) {
+    return color(value, "36");
+}
+function dim(value) {
+    return color(value, "2");
+}
+function color(value, code) {
+    return useColor ? `\u001B[${code}m${value}\u001B[0m` : value;
+}
+//# sourceMappingURL=summary.js.map

package/dist/checks/summary.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};