xcodebuild-axi 0.1.0

package/dist/src/surface.js

@@ -0,0 +1,350 @@
+/**
+ * How much of `xcodebuild` this tool actually covers.
+ *
+ * Wrapping a CLI silently narrows it, and the narrowing is invisible until an
+ * agent needs the one flag that got left out. So the mapping is declared here
+ * rather than inferred: every option `xcodebuild -help` prints is classified,
+ * and `npm run coverage -- --check` fails if a new Xcode adds one this file
+ * has never heard of.
+ */
+/**
+ * The Xcode whose `xcodebuild -help` this map was written against.
+ *
+ * The option list is not stable across Xcode releases — 26 listed `-dry-run`
+ * and `-downloadAllPreviouslySelectedPlatforms`, 27 dropped both and added the
+ * `platforms` and codesize families. So a machine running a different Xcode
+ * will legitimately disagree with this file, and only a machine running this
+ * one can say the map is actually stale. `scripts/coverage.ts` fails on a
+ * mismatch here and merely reports one elsewhere.
+ */
+export const AUTHORED_AGAINST = "27.0";
+export const OPTION_COVERAGE = {
+    "-allowProvisioningDeviceRegistration": {
+        status: "exposed",
+        via: "archive --allow-device-registration",
+    },
+    "-allowProvisioningUpdates": {
+        status: "exposed",
+        via: "build --allow-provisioning",
+    },
+    "-alltargets": { status: "exposed", via: "build --all-targets" },
+    "-arch": { status: "exposed", via: "build --arch" },
+    "-architecture": {
+        status: "exposed",
+        via: "platforms device-support --architecture",
+    },
+    "-archivePath": { status: "exposed", via: "archive --archive-path" },
+    "-authenticationKeyID": { status: "exposed", via: "archive --auth-key-id" },
+    "-authenticationKeyIssuerID": {
+        status: "exposed",
+        via: "archive --auth-key-issuer",
+    },
+    "-authenticationKeyPath": {
+        status: "exposed",
+        via: "archive --auth-key-path",
+    },
+    "-checkFirstLaunchStatus": {
+        status: "exposed",
+        via: "platforms first-launch --status",
+    },
+    "-clonedSourcePackagesDirPath": {
+        status: "exposed",
+        via: "packages --cache",
+    },
+    "-codesizeProfileOutputDir": { status: "exposed", via: "build --codesize" },
+    "-collect-test-diagnostics": { status: "exposed", via: "test --diagnostics" },
+    "-configuration": { status: "exposed", via: "build --configuration" },
+    "-create-xcframework": { status: "exposed", via: "xcframework" },
+    "-default-test-execution-time-allowance": {
+        status: "exposed",
+        via: "test --default-test-timeout",
+    },
+    "-defaultLanguage": {
+        status: "exposed",
+        via: "localize export --default-language",
+    },
+    "-defaultPackageRegistryURL": {
+        status: "exposed",
+        via: "packages --registry-url",
+    },
+    "-deleteComponent": { status: "exposed", via: "platforms component delete" },
+    "-derivedDataPath": { status: "exposed", via: "build --derived-data" },
+    "-destination": { status: "exposed", via: "build --destination" },
+    "-destination-timeout": {
+        status: "exposed",
+        via: "build --destination-timeout",
+    },
+    "-disableAutomaticPackageResolution": {
+        status: "exposed",
+        via: "build --no-auto-resolve",
+    },
+    "-disablePackageRepositoryCache": {
+        status: "exposed",
+        via: "build --no-package-cache",
+    },
+    "-downloadAllPlatforms": {
+        status: "exposed",
+        via: "platforms download --all",
+    },
+    "-downloadComponent": {
+        status: "exposed",
+        via: "platforms component download",
+    },
+    "-downloadPlatform": { status: "exposed", via: "platforms download" },
+    "-enableAddressSanitizer": {
+        status: "exposed",
+        via: "build --sanitizer address",
+    },
+    "-enableCodeCoverage": { status: "exposed", via: "test --coverage" },
+    "-enableCodesizeProfile": { status: "exposed", via: "build --codesize" },
+    "-enablePerformanceTestsDiagnostics": {
+        status: "exposed",
+        via: "test --perf-diagnostics",
+    },
+    "-enableThreadSanitizer": {
+        status: "exposed",
+        via: "build --sanitizer thread",
+    },
+    "-enableUndefinedBehaviorSanitizer": {
+        status: "exposed",
+        via: "build --sanitizer undefined",
+    },
+    "-enumerate-tests": { status: "exposed", via: "tests" },
+    "-exportArchive": { status: "exposed", via: "export" },
+    "-exportLanguage": { status: "exposed", via: "localize export --language" },
+    "-exportLocalizations": { status: "exposed", via: "localize export" },
+    "-exportNotarizedApp": { status: "exposed", via: "export --notarized" },
+    "-exportOptionsPlist": { status: "exposed", via: "export --options" },
+    "-exportPath": { status: "exposed", via: "export --output" },
+    "-find-executable": { status: "exposed", via: "find" },
+    "-find-library": { status: "exposed", via: "find --library" },
+    "-hideShellScriptEnvironment": {
+        status: "exposed",
+        via: "build --hide-script-env",
+    },
+    "-importComponent": { status: "exposed", via: "platforms component import" },
+    "-importLocalizations": { status: "exposed", via: "localize import" },
+    "-importPath": {
+        status: "exposed",
+        via: "platforms component import --import-path",
+    },
+    "-importPlatform": { status: "exposed", via: "platforms import" },
+    "-jobs": { status: "exposed", via: "build --jobs" },
+    "-list": { status: "exposed", via: "schemes" },
+    "-localizationPath": { status: "exposed", via: "localize --path" },
+    "-maximum-concurrent-test-device-destinations": {
+        status: "exposed",
+        via: "test --max-device-destinations",
+    },
+    "-maximum-concurrent-test-simulator-destinations": {
+        status: "exposed",
+        via: "test --max-sim-destinations",
+    },
+    "-maximum-parallel-testing-workers": {
+        status: "exposed",
+        via: "test --max-workers",
+    },
+    "-maximum-test-execution-time-allowance": {
+        status: "exposed",
+        via: "test --test-timeout",
+    },
+    "-modelCode": {
+        status: "exposed",
+        via: "platforms device-support --model-code",
+    },
+    "-only-test-configuration": {
+        status: "exposed",
+        via: "test --only-configuration",
+    },
+    "-only-testing": { status: "exposed", via: "test --only" },
+    "-onlyUsePackageVersionsFromResolvedFile": {
+        status: "exposed",
+        via: "packages --offline",
+    },
+    "-osVersion": {
+        status: "exposed",
+        via: "platforms device-support --os-version",
+    },
+    "-packageAuthorizationProvider": {
+        status: "exposed",
+        via: "packages --package-auth",
+    },
+    "-packageCachePath": { status: "exposed", via: "packages --package-cache" },
+    "-packageDependencySCMToRegistryTransformation": {
+        status: "exposed",
+        via: "packages --scm-to-registry",
+    },
+    "-packageFingerprintPolicy": {
+        status: "exposed",
+        via: "packages --fingerprint-policy",
+    },
+    "-packageSigningEntityPolicy": {
+        status: "exposed",
+        via: "packages --signing-entity-policy",
+    },
+    "-parallel-testing-enabled": {
+        status: "exposed",
+        via: "test --parallel / --no-parallel",
+    },
+    "-parallel-testing-worker-count": {
+        status: "exposed",
+        via: "test --max-workers",
+    },
+    "-parallelizeTargets": {
+        status: "exposed",
+        via: "build --parallelize-targets",
+    },
+    "-platform": {
+        status: "exposed",
+        via: "platforms device-support --platform",
+    },
+    "-prepareDeviceSupport": {
+        status: "exposed",
+        via: "platforms device-support",
+    },
+    "-resolvePackageDependencies": {
+        status: "exposed",
+        via: "packages --resolve",
+    },
+    "-retry-tests-on-failure": { status: "exposed", via: "test --retry" },
+    "-run-tests-until-failure": {
+        status: "exposed",
+        via: "test --until-failure",
+    },
+    "-runFirstLaunch": { status: "exposed", via: "platforms first-launch" },
+    "-scheme": { status: "exposed", via: "build --scheme" },
+    "-scmProvider": { status: "exposed", via: "packages --scm-provider" },
+    "-sdk": { status: "exposed", via: "build --sdk" },
+    "-showBuildSettings": { status: "exposed", via: "settings" },
+    "-showBuildSettingsForIndex": {
+        status: "exposed",
+        via: "settings --for-index",
+    },
+    "-showBuildTimingSummary": { status: "exposed", via: "build --timing" },
+    "-showComponent": { status: "exposed", via: "platforms component show" },
+    "-showdestinations": { status: "exposed", via: "destinations" },
+    "-showsdks": { status: "exposed", via: "info --sdks" },
+    "-showTestPlans": { status: "exposed", via: "testplans" },
+    "-skip-test-configuration": {
+        status: "exposed",
+        via: "test --skip-configuration",
+    },
+    "-skip-testing": { status: "exposed", via: "test --skip" },
+    "-skipPackagePluginValidation": {
+        status: "exposed",
+        via: "build --skip-plugin-validation",
+    },
+    "-skipPackageSignatureValidation": {
+        status: "exposed",
+        via: "build --skip-signature-validation",
+    },
+    "-skipPackageUpdates": {
+        status: "exposed",
+        via: "build --skip-package-updates",
+    },
+    "-skipUnavailableActions": {
+        status: "exposed",
+        via: "build --skip-unavailable-actions",
+    },
+    "-target": { status: "exposed", via: "build --target" },
+    "-test-iterations": { status: "exposed", via: "test --iterations" },
+    "-test-repetition-relaunch-enabled": {
+        status: "exposed",
+        via: "test --relaunch",
+    },
+    "-test-timeouts-enabled": { status: "exposed", via: "test --test-timeout" },
+    "-testLanguage": { status: "exposed", via: "test --language" },
+    "-testPlan": { status: "exposed", via: "test --test-plan" },
+    "-testProductsPath": { status: "exposed", via: "test --test-products" },
+    "-testRegion": { status: "exposed", via: "test --region" },
+    "-toolchain": { status: "exposed", via: "build --toolchain" },
+    "-version": { status: "exposed", via: "info" },
+    "-xcconfig": { status: "exposed", via: "build --xcconfig" },
+    "-xctestrun": { status: "exposed", via: "test --xctestrun" },
+    "-json": {
+        status: "always",
+        why: "every read-only query asks for JSON, then reports TOON",
+    },
+    "-project": {
+        status: "always",
+        why: "set from the .xcodeproj found in the working directory",
+    },
+    "-resultBundlePath": {
+        status: "always",
+        why: "every action writes a bundle to the tool's cache — that bundle is what the report is read from",
+    },
+    "-skipMacroValidation": {
+        status: "always",
+        why: "macro trust is an interactive prompt in disguise, and an agent cannot answer it",
+    },
+    "-test-enumeration-format": {
+        status: "always",
+        why: "always json, so `tests` can parse it",
+    },
+    "-test-enumeration-output-path": {
+        status: "always",
+        why: "written to the tool's cache and read back, never printed",
+    },
+    "-test-enumeration-style": {
+        status: "always",
+        why: "always flat; `tests` does its own grouping by target and suite",
+    },
+    "-workspace": {
+        status: "always",
+        why: "set from the .xcworkspace found in the working directory",
+    },
+    "-convert-project": { status: "exposed", via: "migrate --format" },
+    "-help": {
+        status: "superseded",
+        why: "`xcodebuild-axi --help`, which answers it in a fraction of the tokens",
+    },
+    "-license": { status: "exposed", via: "platforms license" },
+    "-quiet": { status: "exposed", via: "build --log-level quiet" },
+    "-resultBundleVersion": { status: "exposed", via: "build --bundle-version" },
+    "-resultStreamPath": { status: "exposed", via: "build --stream" },
+    "-usage": {
+        status: "superseded",
+        why: "`xcodebuild-axi <command> --help`, per command rather than all 117 at once",
+    },
+    "-verbose": { status: "exposed", via: "build --log-level verbose" },
+};
+/** The build actions, classified the same way. */
+export const ACTION_COVERAGE = {
+    build: { status: "exposed", via: "build" },
+    "build-for-testing": { status: "exposed", via: "build --for-testing" },
+    analyze: { status: "exposed", via: "analyze" },
+    archive: { status: "exposed", via: "archive" },
+    test: { status: "exposed", via: "test" },
+    "test-without-building": {
+        status: "exposed",
+        via: "test --without-building",
+    },
+    docbuild: { status: "exposed", via: "build --docs" },
+    clean: { status: "exposed", via: "clean" },
+    install: { status: "exposed", via: "build --install" },
+    installsrc: {
+        status: "n/a",
+        why: "copies sources into SRCROOT as root; a packaging step, not an agent loop",
+    },
+};
+export function tally(map) {
+    const values = Object.values(map);
+    const count = (status) => values.filter((entry) => entry.status === status).length;
+    const exposed = count("exposed");
+    const always = count("always");
+    const superseded = count("superseded");
+    const na = count("n/a");
+    const covered = exposed + always + superseded;
+    return {
+        total: values.length,
+        exposed,
+        always,
+        superseded,
+        na,
+        covered,
+        // `n/a` options stay in the denominator on purpose. Declining to wrap
+        // something is a choice this number should have to pay for.
+        percent: Math.round((covered / values.length) * 1000) / 10,
+    };
+}
+//# sourceMappingURL=surface.js.map

package/dist/src/surface.js.map

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

package/dist/src/toon.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Output rendering. TOON at the boundary, plain objects everywhere inside
+ * (AXI principle 1).
+ */
+/** Render a labeled list of uniform rows as a TOON table. */
+export declare function renderList(label: string, rows: Record<string, unknown>[]): string;
+/** Render a labeled object as TOON. */
+export declare function renderDetail(label: string, value: Record<string, unknown>): string;
+/** Render bare top-level key/value lines. */
+export declare function renderFields(fields: Record<string, unknown>): string;
+/**
+ * Render next-step suggestions (AXI principle 9).
+ *
+ * Hand-formatted rather than passed to `encode()`, which inlines arrays of
+ * primitives onto one line — unreadable once the entries are full commands.
+ */
+export declare function renderHelp(lines: string[]): string;
+/** Join rendered blocks, dropping the empty ones. */
+export declare function renderOutput(blocks: string[]): string;
+/**
+ * Truncate long free text, telling the agent what it is missing and how to get
+ * it (AXI principle 3). Returns the text unchanged when it already fits.
+ */
+export declare function truncate(text: string, limit?: number): {
+    text: string;
+    truncated: boolean;
+    total: number;
+};
+/** Collapse `$HOME` to `~` so paths stay short and stable across machines. */
+export declare function tildePath(absolute: string): string;
+/** Seconds, rendered the way a human skims them. */
+export declare function duration(seconds: number): string;
+/** Relative age of a timestamp, for "when did this last run". */
+export declare function relativeTime(epochSeconds: number | undefined): string;

package/dist/src/toon.js

@@ -0,0 +1,79 @@
+import { encode } from "@toon-format/toon";
+/**
+ * Output rendering. TOON at the boundary, plain objects everywhere inside
+ * (AXI principle 1).
+ */
+/** Render a labeled list of uniform rows as a TOON table. */
+export function renderList(label, rows) {
+    return encode({ [label]: rows });
+}
+/** Render a labeled object as TOON. */
+export function renderDetail(label, value) {
+    return encode({ [label]: value });
+}
+/** Render bare top-level key/value lines. */
+export function renderFields(fields) {
+    return encode(fields);
+}
+/**
+ * Render next-step suggestions (AXI principle 9).
+ *
+ * Hand-formatted rather than passed to `encode()`, which inlines arrays of
+ * primitives onto one line — unreadable once the entries are full commands.
+ */
+export function renderHelp(lines) {
+    const present = lines.filter((line) => line.length > 0);
+    if (present.length === 0)
+        return "";
+    return `help[${present.length}]:\n${present.map((l) => `  ${l}`).join("\n")}`;
+}
+/** Join rendered blocks, dropping the empty ones. */
+export function renderOutput(blocks) {
+    return blocks.filter((block) => block.length > 0).join("\n");
+}
+/**
+ * Truncate long free text, telling the agent what it is missing and how to get
+ * it (AXI principle 3). Returns the text unchanged when it already fits.
+ */
+export function truncate(text, limit = 800) {
+    const total = text.length;
+    if (total <= limit)
+        return { text, truncated: false, total };
+    return {
+        text: `${text.slice(0, limit)}\n... (truncated, ${total} chars total)`,
+        truncated: true,
+        total,
+    };
+}
+/** Collapse `$HOME` to `~` so paths stay short and stable across machines. */
+export function tildePath(absolute) {
+    const home = process.env["HOME"];
+    if (home && absolute.startsWith(`${home}/`)) {
+        return `~${absolute.slice(home.length)}`;
+    }
+    return absolute;
+}
+/** Seconds, rendered the way a human skims them. */
+export function duration(seconds) {
+    if (!Number.isFinite(seconds) || seconds < 0)
+        return "unknown";
+    if (seconds < 60)
+        return `${seconds.toFixed(1)}s`;
+    const minutes = Math.floor(seconds / 60);
+    const rest = Math.round(seconds % 60);
+    return `${minutes}m${rest.toString().padStart(2, "0")}s`;
+}
+/** Relative age of a timestamp, for "when did this last run". */
+export function relativeTime(epochSeconds) {
+    if (epochSeconds === undefined || !Number.isFinite(epochSeconds))
+        return "unknown";
+    const diff = Math.floor(Date.now() / 1000 - epochSeconds);
+    if (diff < 60)
+        return "just now";
+    if (diff < 3600)
+        return `${Math.floor(diff / 60)}m ago`;
+    if (diff < 86400)
+        return `${Math.floor(diff / 3600)}h ago`;
+    return `${Math.floor(diff / 86400)}d ago`;
+}
+//# sourceMappingURL=toon.js.map

package/dist/src/toon.js.map

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

package/dist/src/version.d.ts

@@ -0,0 +1 @@
+export declare const VERSION: string;

package/dist/src/version.js

@@ -0,0 +1,24 @@
+// Leaf module: imports node builtins only, never the command graph.
+// `bin/xcodebuild-axi.ts` imports this on the `--version` fast path, so any new
+// import here is paid on every invocation of that path. AXI principle 10.
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+function readPackageVersion() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    for (const candidate of [
+        join(here, "..", "package.json"),
+        join(here, "..", "..", "package.json"),
+    ]) {
+        if (!existsSync(candidate)) {
+            continue;
+        }
+        const parsed = JSON.parse(readFileSync(candidate, "utf-8"));
+        if (typeof parsed.version === "string" && parsed.version.length > 0) {
+            return parsed.version;
+        }
+    }
+    throw new Error("Could not determine xcodebuild-axi package version");
+}
+export const VERSION = readPackageVersion();
+//# sourceMappingURL=version.js.map

package/dist/src/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,gFAAgF;AAChF,0EAA0E;AAC1E,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,SAAS,kBAAkB;IACzB,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAErD,KAAK,MAAM,SAAS,IAAI;QACtB,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC;QAChC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC;KACvC,EAAE,CAAC;QACF,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAEzD,CAAC;QACF,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpE,OAAO,MAAM,CAAC,OAAO,CAAC;QACxB,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC"}

package/dist/src/xccov.d.ts

@@ -0,0 +1,25 @@
+export interface CoverageTarget {
+    name: string;
+    lineCoverage: number;
+    coveredLines: number;
+    executableLines: number;
+    files?: CoverageFile[];
+}
+export interface CoverageFile {
+    name: string;
+    path: string;
+    lineCoverage: number;
+    coveredLines: number;
+    executableLines: number;
+}
+export interface CoverageReport {
+    lineCoverage: number;
+    coveredLines: number;
+    executableLines: number;
+    targets: CoverageTarget[];
+}
+export declare function readCoverage(resultPath: string, options?: {
+    files?: boolean;
+}): Promise<CoverageReport>;
+/** 0.8342 -> "83.4%". */
+export declare function percent(fraction: number): string;

package/dist/src/xccov.js

@@ -0,0 +1,78 @@
+import { execFile } from "node:child_process";
+import { AxiError } from "./errors.js";
+/**
+ * Code coverage, read out of a result bundle with `xccov`.
+ *
+ * The per-file report for a real app runs to thousands of lines; the number
+ * an agent actually wants is one percentage per target, and the list of files
+ * that drag it down.
+ */
+const MAX_BUFFER_BYTES = 64 * 1024 * 1024;
+function xccov(args) {
+    return new Promise((resolvePromise, rejectPromise) => {
+        execFile("xcrun", ["xccov", ...args], { maxBuffer: MAX_BUFFER_BYTES, encoding: "utf-8" }, (error, stdout, stderr) => {
+            if (error && stdout.trim().length === 0) {
+                // xccov's own phrasing for the common case, translated into
+                // something that names the command that fixes it.
+                if (/No coverage data/i.test(stderr)) {
+                    rejectPromise(new AxiError("That result bundle carries no coverage data", "RESULT_NOT_FOUND", ["Re-run the tests with `xcodebuild-axi test --coverage`"]));
+                    return;
+                }
+                rejectPromise(new AxiError(firstLine(stderr) || "xccov failed", "RESULT_NOT_FOUND"));
+                return;
+            }
+            resolvePromise(stdout);
+        });
+    });
+}
+export async function readCoverage(resultPath, options = {}) {
+    const stdout = await xccov(["view", "--report", "--json", resultPath]);
+    let parsed;
+    try {
+        parsed = JSON.parse(stdout);
+    }
+    catch {
+        throw new AxiError("xccov returned output that could not be read", "RESULT_NOT_FOUND");
+    }
+    const targets = (parsed.targets ?? []).map((target) => ({
+        name: target.name ?? "unknown",
+        lineCoverage: target.lineCoverage ?? 0,
+        coveredLines: target.coveredLines ?? 0,
+        executableLines: target.executableLines ?? 0,
+        ...(options.files
+            ? {
+                files: (target.files ?? []).map((file) => ({
+                    name: file.name ?? "unknown",
+                    path: file.path ?? "",
+                    lineCoverage: file.lineCoverage ?? 0,
+                    coveredLines: file.coveredLines ?? 0,
+                    executableLines: file.executableLines ?? 0,
+                })),
+            }
+            : {}),
+    }));
+    // The top-level totals are not always present, and a report that silently
+    // reports 0% because a field was missing is worse than one that adds up the
+    // targets itself.
+    const coveredLines = parsed.coveredLines ??
+        targets.reduce((sum, target) => sum + target.coveredLines, 0);
+    const executableLines = parsed.executableLines ??
+        targets.reduce((sum, target) => sum + target.executableLines, 0);
+    return {
+        lineCoverage: parsed.lineCoverage ??
+            (executableLines > 0 ? coveredLines / executableLines : 0),
+        coveredLines,
+        executableLines,
+        targets,
+    };
+}
+/** 0.8342 -> "83.4%". */
+export function percent(fraction) {
+    if (!Number.isFinite(fraction))
+        return "unknown";
+    return `${(fraction * 100).toFixed(1)}%`;
+}
+function firstLine(text) {
+    return text.trim().split("\n")[0] ?? "";
+}
+//# sourceMappingURL=xccov.js.map

package/dist/src/xccov.js.map

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