@stag-build/phonebook 0.1.0

package/dist/engines/android.js

@@ -0,0 +1,265 @@
+import { spawn } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { copyFile, mkdir, readdir, writeFile } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { diagnoseGradleFailure } from '../errors.js';
+import { SCHEMA_VERSION } from '../manifest.js';
+import { parsePreviewName } from '../naming.js';
+import { gitInfo } from './git.js';
+export const EMPTY_PREVIEWS_MESSAGE = 'No previews were recorded. Common causes: (1) packages = listOf(...) in generateComposePreviewRobolectricTests ' +
+    'does not match your app package; (2) includePrivatePreviews = true is missing and your @Preview functions are ' +
+    'private; (3) the module has no @Preview functions. Run `phonebook doctor` to check 1 and 2.';
+/**
+ * Guards against `generate` silently succeeding with zero recorded previews.
+ * Throws unless `allowEmpty` is set (the `--allow-empty` CLI flag), in which
+ * case the caller downgrades this to a warning and still writes the manifest.
+ * Pure/exported so it can be unit-tested without spawning Gradle.
+ */
+export function checkEmptyEntries(entryCount, allowEmpty) {
+    if (entryCount === 0 && !allowEmpty) {
+        throw new Error(EMPTY_PREVIEWS_MESSAGE);
+    }
+}
+/**
+ * Runs Roborazzi (with ComposablePreviewScanner-generated tests) via Gradle and
+ * harvests the recorded PNGs into a Phonebook bundle.
+ */
+export async function generateAndroid(config, projectDir, outputDir, options = {}) {
+    const modules = config.android?.modules ?? [':app'];
+    const variant = config.android?.variant ?? 'debug';
+    const variantCap = variant[0].toUpperCase() + variant.slice(1);
+    const tasks = modules.map((m) => `${m}:recordRoborazzi${variantCap}`);
+    await runGradle(projectDir, tasks, options.quiet ?? false);
+    const imagesDir = join(outputDir, 'images');
+    await mkdir(imagesDir, { recursive: true });
+    const entries = [];
+    for (const module of modules) {
+        const moduleDir = join(projectDir, ...module.split(':').filter(Boolean));
+        const roborazziDir = join(moduleDir, 'build', 'outputs', 'roborazzi');
+        let files = [];
+        try {
+            // Recursive: previews named "Component/State" are written into subdirectories.
+            files = (await readdir(roborazziDir, { recursive: true }))
+                .map(String)
+                .filter((f) => f.endsWith('.png'));
+        }
+        catch {
+            throw new Error(`No Roborazzi output at ${roborazziDir}. Is the Roborazzi plugin with ` +
+                `generateComposePreviewRobolectricTests enabled in ${module}?`);
+        }
+        for (const file of files) {
+            const meta = parseRoborazziFileName(file);
+            const hash = createHash('sha256');
+            hash.update(module + file);
+            const imageName = `${hash.digest('hex').slice(0, 16)}.png`;
+            await copyFile(join(roborazziDir, file), join(imagesDir, imageName));
+            // A dark-uiMode preview named e.g. UserCardDarkPreview is the Dark state
+            // of UserCard, not a separate component.
+            let functionName = meta.functionName;
+            let displayName = meta.displayName;
+            if (meta.theme === 'dark' && !displayName) {
+                const stripped = functionName.replace(/(?:Dark|Night)(Preview)?$/, '$1');
+                if (stripped !== functionName)
+                    functionName = stripped;
+                displayName = 'Dark';
+            }
+            const { component, state } = parsePreviewName(functionName, displayName);
+            entries.push({
+                component,
+                state,
+                module,
+                ...(meta.sourceFile ? { sourceFile: meta.sourceFile } : {}),
+                previewName: meta.fqn,
+                image: `images/${imageName}`,
+                ...(meta.theme ? { theme: meta.theme } : {}),
+                ...(meta.tags && meta.tags.length > 0 ? { tags: meta.tags } : {}),
+            });
+        }
+    }
+    entries.sort((a, b) => a.component.localeCompare(b.component) || a.state.localeCompare(b.state));
+    const allowEmpty = options.allowEmpty ?? false;
+    checkEmptyEntries(entries.length, allowEmpty);
+    if (entries.length === 0 && allowEmpty) {
+        console.warn(`warning: ${EMPTY_PREVIEWS_MESSAGE}`);
+    }
+    const manifest = {
+        schemaVersion: SCHEMA_VERSION,
+        platform: 'android',
+        app: {
+            name: config.appName,
+            ...(await gitInfo(projectDir)),
+            generatedAt: new Date().toISOString(),
+        },
+        entries,
+    };
+    await writeFile(join(outputDir, 'manifest.json'), JSON.stringify(manifest, null, 2));
+    return manifest;
+}
+/**
+ * Roborazzi's machine-generated marker chunks are ALL-CAPS alnum, except that
+ * size markers carry a lowercase "dp" unit: WITH_BACKGROUND, UI_MODE_NIGHT_YES,
+ * PIXEL_4_XL, but also W360dp / H96dp (from widthDp/heightDp attributes).
+ * A user's name word like "Green" (initial cap + lowercase) never matches.
+ */
+const MARKER_CHUNK = '[A-Z0-9]+(?:dp)?';
+const MACHINE_MARKER = new RegExp(`^${MARKER_CHUNK}(?:_${MARKER_CHUNK})+$`);
+/**
+ * Roborazzi sometimes glues a machine-generated marker run directly onto a
+ * user-chosen display-name token within the same dot-segment, e.g.
+ * "Landscape_WIDTH_891DP_HEIGHT_411DP_ORIENTATION_LANDSCAPE" (device-spec
+ * annotation glued to the "Landscape" state). Unlike MACHINE_MARKER, this
+ * only matches a *trailing* run, leaving a leading name intact.
+ */
+const GLUED_MARKER_SUFFIX = new RegExp(`(?:_${MARKER_CHUNK})+$`);
+/**
+ * Roborazzi writes the space in @Preview(name = "On Green") as an underscore.
+ * Restore spaces in mixed-case name tokens; a deliberate all-caps state like
+ * NIGHT_MODE has no lowercase and is left untouched.
+ */
+function restoreNameSpaces(token) {
+    return /[a-z]/.test(token) ? token.replace(/_/g, ' ') : token;
+}
+/**
+ * Strips a trailing glued marker run (see GLUED_MARKER_SUFFIX) off `token`,
+ * returning the remaining name plus the stripped run as a single tag. Returns
+ * undefined when there is no glued suffix, or when stripping it would leave
+ * an empty or all-caps-only remainder (a deliberate state like "NIGHT_MODE"
+ * has no lowercase to strip down to, so it is left intact).
+ */
+function stripGluedMarker(token) {
+    const match = token.match(GLUED_MARKER_SUFFIX);
+    if (!match || match.index === undefined)
+        return undefined;
+    const remainder = token.slice(0, match.index);
+    if (remainder.length === 0 || !/[a-z]/.test(remainder))
+        return undefined;
+    return { name: restoreNameSpaces(remainder), tag: match[0].slice(1) };
+}
+/**
+ * Roborazzi + ComposablePreviewScanner names recorded images
+ * `<package>.<FileKt>.<PreviewFunction>[.<preview display name>].png`, where a
+ * display name containing "/" becomes real subdirectories on disk (verified
+ * against Roborazzi 1.72.0):
+ *   dev.stag.sample.PrimaryButtonKt.PrimaryButtonEnabledPreview.Button/Enabled.png
+ *   dev.stag.sample.UserCardKt.UserCardPreview.png
+ *   dev.stag.sample.UserCardKt.UserCardDarkPreview.NIGHT.png   (uiMode night)
+ *
+ * Roborazzi also appends machine-generated ALL-CAPS markers derived from
+ * `@Preview` attributes (verified against a real app whose previews are all
+ * `@Preview(showBackground = true)`, with no explicit name):
+ *   com.om.spotifyuiapp...HomeContentKt.HomeContent.WITH_BACKGROUND.png
+ * These are not a user-chosen display name and must not become the state;
+ * they are collected into `tags` instead. NIGHT/NOTNIGHT (uiMode) become
+ * `theme` rather than a tag, as before.
+ *
+ * `file` is the png path relative to the roborazzi output dir ("/"-separated).
+ */
+export function parseRoborazziFileName(file) {
+    const base = file.replace(/\.png$/, '').replace(/\\/g, '/');
+    const fqn = base;
+    // Path segments beyond the first come from a "/" in the preview display name.
+    const [head, ...restPath] = base.split('/');
+    const dotParts = head.split('.');
+    // The segment ending in "Kt" is the file class; the next one is the function.
+    let fnIndex = dotParts.findIndex((p) => p.endsWith('Kt')) + 1;
+    if (fnIndex <= 0 || fnIndex >= dotParts.length)
+        fnIndex = dotParts.length - 1;
+    const functionName = dotParts[fnIndex];
+    const fileClass = dotParts[fnIndex - 1];
+    const sourceFile = fileClass?.endsWith('Kt') && fnIndex >= 1
+        ? [...dotParts.slice(0, fnIndex - 1), `${fileClass.slice(0, -2)}.kt`].join('/')
+        : undefined;
+    // Each remaining "level" (the head's trailing dot segments, then one level
+    // per "/" path segment) may itself carry multiple dot-separated tokens: a
+    // real display-name token plus Roborazzi's machine-generated markers.
+    const levels = [dotParts.slice(fnIndex + 1), ...restPath.map((p) => p.split('.'))];
+    let theme;
+    const tags = [];
+    const nameLevels = [];
+    for (const level of levels) {
+        const nameTokens = [];
+        for (const token of level) {
+            if (token === 'NIGHT')
+                theme = 'dark';
+            else if (token === 'NOTNIGHT')
+                theme = 'light';
+            else if (MACHINE_MARKER.test(token))
+                tags.push(token);
+            else {
+                const glued = stripGluedMarker(token);
+                if (glued) {
+                    nameTokens.push(glued.name);
+                    tags.push(glued.tag);
+                }
+                else {
+                    nameTokens.push(restoreNameSpaces(token));
+                }
+            }
+        }
+        if (nameTokens.length > 0)
+            nameLevels.push(nameTokens.join('.'));
+    }
+    const displayName = nameLevels.length > 0 ? nameLevels.join('/') : undefined;
+    return {
+        fqn,
+        functionName,
+        displayName,
+        theme,
+        sourceFile,
+        ...(tags.length > 0 ? { tags } : {}),
+    };
+}
+/**
+ * Runs Gradle. When `quiet` is false (the CLI default), output streams
+ * straight through to this process's stdout/stderr as it arrives (so a human
+ * can watch the build) while a rolling tail is kept alongside it for error
+ * translation. When `quiet` is true (used by the MCP server, whose stdout is
+ * the JSON-RPC channel and must never carry build output), only the tail is
+ * kept and nothing is echoed live; the tail is written to stderr once if the
+ * build fails, unless `dumpTailOnFailure` is set to false.
+ *
+ * `onOutput`, when provided, is called once on exit (success or failure) with
+ * the full, untruncated captured output — useful for callers that want to
+ * write a complete log file rather than relying on the 200-line tail.
+ */
+export function runGradle(projectDir, tasks, quiet, options = {}) {
+    return new Promise((res, rej) => {
+        const gradlew = resolve(projectDir, process.platform === 'win32' ? 'gradlew.bat' : 'gradlew');
+        const child = spawn(gradlew, [...tasks, '--stacktrace'], {
+            cwd: projectDir,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let tail = [];
+        const full = [];
+        const onData = (target) => (data) => {
+            if (!quiet)
+                target.write(data);
+            const chunkLines = data.toString('utf8').split('\n');
+            tail.push(...chunkLines);
+            if (tail.length > 200)
+                tail = tail.slice(-200);
+            full.push(...chunkLines);
+        };
+        child.stdout?.on('data', onData(process.stdout));
+        child.stderr?.on('data', onData(process.stderr));
+        child.on('error', (err) => rej(new Error(`Failed to run ${gradlew}: ${err.message}`)));
+        child.on('exit', (code) => {
+            options.onOutput?.(full.join('\n'));
+            if (code === 0) {
+                res();
+                return;
+            }
+            const tailText = tail.join('\n');
+            const diagnosis = diagnoseGradleFailure(tailText);
+            if (diagnosis.length > 0) {
+                process.stderr.write(diagnosis.map((line) => `phonebook: ${line}`).join('\n') + '\n');
+            }
+            const dumpTailOnFailure = options.dumpTailOnFailure ?? true;
+            if (quiet && dumpTailOnFailure && tail.length > 0)
+                process.stderr.write(tailText + '\n');
+            const message = [`Gradle failed (exit ${code}) running: ${tasks.join(' ')}`, ...diagnosis].join('\n');
+            rej(new Error(message));
+        });
+    });
+}
+//# sourceMappingURL=android.js.map

package/dist/engines/android.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"android.js","sourceRoot":"","sources":["../../src/engines/android.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,cAAc,EAAqC,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,MAAM,CAAC,MAAM,sBAAsB,GACjC,iHAAiH;IACjH,gHAAgH;IAChH,6FAA6F,CAAC;AAEhG;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAkB,EAAE,UAAmB;IACvE,IAAI,UAAU,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAuB,EACvB,UAAkB,EAClB,SAAiB,EACjB,UAAqD,EAAE;IAEvD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC;IACnD,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAE/D,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,mBAAmB,UAAU,EAAE,CAAC,CAAC;IACtE,MAAM,SAAS,CAAC,UAAU,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC;IAE3D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC5C,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACzE,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QACtE,IAAI,KAAK,GAAa,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,+EAA+E;YAC/E,KAAK,GAAG,CAAC,MAAM,OAAO,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;iBACvD,GAAG,CAAC,MAAM,CAAC;iBACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CACb,0BAA0B,YAAY,iCAAiC;gBACrE,qDAAqD,MAAM,GAAG,CACjE,CAAC;QACJ,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;YAC1C,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;YAClC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;YAC3B,MAAM,SAAS,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC;YAC3D,MAAM,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;YACrE,yEAAyE;YACzE,yCAAyC;YACzC,IAAI,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;YACrC,IAAI,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;YACnC,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;gBAC1C,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,2BAA2B,EAAE,IAAI,CAAC,CAAC;gBACzE,IAAI,QAAQ,KAAK,YAAY;oBAAE,YAAY,GAAG,QAAQ,CAAC;gBACvD,WAAW,GAAG,MAAM,CAAC;YACvB,CAAC;YACD,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,gBAAgB,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;YACzE,OAAO,CAAC,IAAI,CAAC;gBACX,SAAS;gBACT,KAAK;gBACL,MAAM;gBACN,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3D,WAAW,EAAE,IAAI,CAAC,GAAG;gBACrB,KAAK,EAAE,UAAU,SAAS,EAAE;gBAC5B,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5C,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAClE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAEjG,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,KAAK,CAAC;IAC/C,iBAAiB,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC9C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,EAAE,CAAC;QACvC,OAAO,CAAC,IAAI,CAAC,YAAY,sBAAsB,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,MAAM,QAAQ,GAAa;QACzB,aAAa,EAAE,cAAc;QAC7B,QAAQ,EAAE,SAAS;QACnB,GAAG,EAAE;YACH,IAAI,EAAE,MAAM,CAAC,OAAO;YACpB,GAAG,CAAC,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;YAC9B,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC;QACD,OAAO;KACR,CAAC;IACF,MAAM,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACrF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAiBD;;;;;GAKG;AACH,MAAM,YAAY,GAAG,kBAAkB,CAAC;AACxC,MAAM,cAAc,GAAG,IAAI,MAAM,CAAC,IAAI,YAAY,OAAO,YAAY,KAAK,CAAC,CAAC;AAE5E;;;;;;GAMG;AACH,MAAM,mBAAmB,GAAG,IAAI,MAAM,CAAC,OAAO,YAAY,KAAK,CAAC,CAAC;AAEjE;;;;GAIG;AACH,SAAS,iBAAiB,CAAC,KAAa;IACtC,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAChE,CAAC;AAED;;;;;;GAMG;AACH,SAAS,gBAAgB,CAAC,KAAa;IACrC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAC/C,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1D,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAC9C,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IACzE,OAAO,EAAE,IAAI,EAAE,iBAAiB,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AACxE,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC5D,MAAM,GAAG,GAAG,IAAI,CAAC;IAEjB,8EAA8E;IAC9E,MAAM,CAAC,IAAI,EAAE,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAEjC,8EAA8E;IAC9E,IAAI,OAAO,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAC9D,IAAI,OAAO,IAAI,CAAC,IAAI,OAAO,IAAI,QAAQ,CAAC,MAAM;QAAE,OAAO,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9E,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;IACxC,MAAM,UAAU,GACd,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC;QACvC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;QAC/E,CAAC,CAAC,SAAS,CAAC;IAEhB,2EAA2E;IAC3E,0EAA0E;IAC1E,sEAAsE;IACtE,MAAM,MAAM,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAEnF,IAAI,KAAmC,CAAC;IACxC,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,UAAU,GAAa,EAAE,CAAC;QAChC,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;YAC1B,IAAI,KAAK,KAAK,OAAO;gBAAE,KAAK,GAAG,MAAM,CAAC;iBACjC,IAAI,KAAK,KAAK,UAAU;gBAAE,KAAK,GAAG,OAAO,CAAC;iBAC1C,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC;gBAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;iBACjD,CAAC;gBACJ,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;gBACtC,IAAI,KAAK,EAAE,CAAC;oBACV,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBAC5B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACvB,CAAC;qBAAM,CAAC;oBACN,UAAU,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC5C,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;YAAE,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE7E,OAAO;QACL,GAAG;QACH,YAAY;QACZ,WAAW;QACX,KAAK;QACL,UAAU;QACV,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,SAAS,CACvB,UAAkB,EAClB,KAAe,EACf,KAAc,EACd,UAAgF,EAAE;IAElF,OAAO,IAAI,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC9F,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,KAAK,EAAE,cAAc,CAAC,EAAE;YACvD,GAAG,EAAE,UAAU;YACf,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;QAEH,IAAI,IAAI,GAAa,EAAE,CAAC;QACxB,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,CAAC,MAA6B,EAAE,EAAE,CAAC,CAAC,IAAY,EAAE,EAAE;YACjE,IAAI,CAAC,KAAK;gBAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACrD,IAAI,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;YACzB,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG;gBAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC;YAC/C,IAAI,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;QAC3B,CAAC,CAAC;QACF,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QACjD,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QAEjD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,iBAAiB,OAAO,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QACvF,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACxB,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACpC,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,GAAG,EAAE,CAAC;gBACN,OAAO;YACT,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjC,MAAM,SAAS,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;YAClD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;YACxF,CAAC;YACD,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,IAAI,CAAC;YAC5D,IAAI,KAAK,IAAI,iBAAiB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;YACzF,MAAM,OAAO,GAAG,CAAC,uBAAuB,IAAI,cAAc,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtG,GAAG,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/engines/git.d.ts

@@ -0,0 +1,4 @@
+/** Best-effort git metadata for the manifest; absent outside a git repo. */
+export declare function gitInfo(projectDir: string): Promise<{
+    commit?: string;
+}>;

package/dist/engines/git.js

@@ -0,0 +1,13 @@
+import { spawn } from 'node:child_process';
+/** Best-effort git metadata for the manifest; absent outside a git repo. */
+export async function gitInfo(projectDir) {
+    const commit = await new Promise((res) => {
+        const child = spawn('git', ['rev-parse', 'HEAD'], { cwd: projectDir });
+        let out = '';
+        child.stdout.on('data', (d) => (out += d));
+        child.on('error', () => res(undefined));
+        child.on('exit', (code) => res(code === 0 ? out.trim() : undefined));
+    });
+    return commit ? { commit } : {};
+}
+//# sourceMappingURL=git.js.map

package/dist/engines/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/engines/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,UAAkB;IAC9C,MAAM,MAAM,GAAG,MAAM,IAAI,OAAO,CAAqB,CAAC,GAAG,EAAE,EAAE;QAC3D,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC;QACvE,IAAI,GAAG,GAAG,EAAE,CAAC;QACb,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3C,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;QACxC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAClC,CAAC"}

package/dist/engines/ios.d.ts

@@ -0,0 +1,55 @@
+import type { PhonebookConfig } from '../config.js';
+import { type Manifest, type ManifestEntry } from '../manifest.js';
+/** Builds the error/warning text for a `generate` run that exported zero snapshots. Exported for tests. */
+export declare function buildEmptySnapshotsMessage(exportDir: string, scheme: string): string;
+/**
+ * Resolves the -only-testing:Target/Class argument so `generate` runs just the
+ * snapshot test class instead of the app's whole test suite — an unrelated
+ * failing unit test must not kill screenshot generation (seen in a real repo
+ * whose own tests were flaky). Explicit config wins; "" disables the filter.
+ * Exported for tests.
+ */
+export declare function resolveOnlyTesting(config: PhonebookConfig, projectDir: string): Promise<string | undefined>;
+/**
+ * Runs the SnapshotPreviews-backed XCTest target via xcodebuild on a simulator
+ * and harvests the exported PNG + JSON sidecar pairs into a Phonebook bundle.
+ *
+ * SnapshotPreviews exports to the directory given by the SNAPSHOTS_EXPORT_DIR
+ * env var in the test-runner process; xcodebuild forwards any TEST_RUNNER_-
+ * prefixed variable (prefix stripped) into that process.
+ */
+export declare function generateIos(config: PhonebookConfig, projectDir: string, outputDir: string, options?: {
+    quiet?: boolean;
+    allowEmpty?: boolean;
+}): Promise<Manifest>;
+/** Shape of the JSON sidecar SnapshotPreviews writes next to each PNG. */
+interface SnapshotSidecar {
+    display_name?: string;
+    group?: string;
+    context?: {
+        preview?: {
+            container_display_name?: string;
+            preferred_color_scheme?: string;
+        };
+        simulator?: {
+            device_name?: string;
+        };
+    };
+}
+/** Exported for tests. Maps one PNG + sidecar to a manifest entry (minus image path). */
+export declare function mapSidecar(png: string, sidecar: SnapshotSidecar): Omit<ManifestEntry, 'image'>;
+/**
+ * Runs xcodebuild. When `quiet` is false (the CLI default), output streams
+ * straight to this process's stdout/stderr as it arrives (so a human can
+ * watch the build) while a rolling ~200-line tail is kept alongside it for
+ * error translation. When `quiet` is true (used by the MCP server, whose
+ * stdout is the JSON-RPC channel and must never carry build output), only the
+ * tail is kept and nothing is echoed live; the tail is written to stderr once
+ * if the build fails.
+ *
+ * On a non-zero exit, the tail is run through `diagnoseXcodebuildFailure` —
+ * any matched diagnosis lines are printed to stderr (`phonebook: `-prefixed)
+ * and folded into the rejected Error's message, mirroring `runGradle`.
+ */
+export declare function runXcodebuild(cwd: string, args: string[], env: Record<string, string>, quiet: boolean): Promise<void>;
+export {};

package/dist/engines/ios.js

@@ -0,0 +1,195 @@
+import { spawn } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { copyFile, mkdir, mkdtemp, readdir, readFile, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { diagnoseXcodebuildFailure } from '../errors.js';
+import { SCHEMA_VERSION } from '../manifest.js';
+import { parsePreviewName, spaceCamelCase } from '../naming.js';
+import { gitInfo } from './git.js';
+import { findSnapshotTestSubclass, findSnapshottingTestsTargets, readPbxprojText } from '../ios/snapshotTestClass.js';
+/** Builds the error/warning text for a `generate` run that exported zero snapshots. Exported for tests. */
+export function buildEmptySnapshotsMessage(exportDir, scheme) {
+    return (`xcodebuild succeeded but no snapshots were exported to ${exportDir}. ` +
+        `Does the "${scheme}" scheme include a SnapshotPreviews test target, and are your #Preview macros not all ` +
+        'filtered out (e.g. by a snapshotPreviews() override that excludes them)?');
+}
+/**
+ * Resolves the -only-testing:Target/Class argument so `generate` runs just the
+ * snapshot test class instead of the app's whole test suite — an unrelated
+ * failing unit test must not kill screenshot generation (seen in a real repo
+ * whose own tests were flaky). Explicit config wins; "" disables the filter.
+ * Exported for tests.
+ */
+export async function resolveOnlyTesting(config, projectDir) {
+    const configured = config.ios?.onlyTesting;
+    if (configured !== undefined)
+        return configured === '' ? undefined : configured;
+    try {
+        const [subclass, pbxproj] = await Promise.all([
+            findSnapshotTestSubclass(projectDir),
+            readPbxprojText(projectDir, config.ios?.project ? join(projectDir, config.ios.project) : undefined),
+        ]);
+        if (!subclass || !pbxproj)
+            return undefined;
+        const targets = findSnapshottingTestsTargets(pbxproj);
+        if (targets.length !== 1)
+            return undefined;
+        return `${targets[0].name}/${subclass.className}`;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Runs the SnapshotPreviews-backed XCTest target via xcodebuild on a simulator
+ * and harvests the exported PNG + JSON sidecar pairs into a Phonebook bundle.
+ *
+ * SnapshotPreviews exports to the directory given by the SNAPSHOTS_EXPORT_DIR
+ * env var in the test-runner process; xcodebuild forwards any TEST_RUNNER_-
+ * prefixed variable (prefix stripped) into that process.
+ */
+export async function generateIos(config, projectDir, outputDir, options = {}) {
+    const ios = config.ios;
+    if (!ios?.scheme)
+        throw new Error('phonebook.config.json: "ios.scheme" is required');
+    if (!ios.project && !ios.workspace) {
+        throw new Error('phonebook.config.json: one of "ios.project" or "ios.workspace" is required');
+    }
+    const simulator = ios.simulator ?? 'iPhone 17 Pro';
+    const exportDir = await mkdtemp(join(tmpdir(), 'phonebook-snapshots-'));
+    try {
+        const args = [
+            'test',
+            ...(ios.workspace ? ['-workspace', ios.workspace] : ['-project', ios.project]),
+            '-scheme',
+            ios.scheme,
+            '-destination',
+            `platform=iOS Simulator,name=${simulator}`,
+        ];
+        const onlyTesting = await resolveOnlyTesting(config, projectDir);
+        if (onlyTesting)
+            args.push(`-only-testing:${onlyTesting}`);
+        await runXcodebuild(projectDir, args, {
+            TEST_RUNNER_SNAPSHOTS_EXPORT_DIR: exportDir,
+            TEST_RUNNER_SNAPSHOTS_RUNNING_FOR_PREVIEWS: '1',
+        }, options.quiet ?? false);
+        const imagesDir = join(outputDir, 'images');
+        await mkdir(imagesDir, { recursive: true });
+        const pngs = (await readdir(exportDir)).filter((f) => f.endsWith('.png')).sort();
+        if (pngs.length === 0) {
+            const message = buildEmptySnapshotsMessage(exportDir, ios.scheme);
+            if (!(options.allowEmpty ?? false)) {
+                throw new Error(message);
+            }
+            console.warn(`warning: ${message}`);
+        }
+        const entries = [];
+        for (const png of pngs) {
+            const sidecar = await readSidecar(join(exportDir, png.replace(/\.png$/, '.json')));
+            const meta = mapSidecar(png, sidecar);
+            const hash = createHash('sha256');
+            hash.update(png);
+            const imageName = `${hash.digest('hex').slice(0, 16)}.png`;
+            await copyFile(join(exportDir, png), join(imagesDir, imageName));
+            entries.push({ ...meta, image: `images/${imageName}` });
+        }
+        entries.sort((a, b) => a.component.localeCompare(b.component) || a.state.localeCompare(b.state));
+        const manifest = {
+            schemaVersion: SCHEMA_VERSION,
+            platform: 'ios',
+            app: {
+                name: config.appName,
+                generatedAt: new Date().toISOString(),
+                ...(await gitInfo(projectDir)),
+            },
+            entries,
+        };
+        await writeFile(join(outputDir, 'manifest.json'), JSON.stringify(manifest, null, 2));
+        return manifest;
+    }
+    finally {
+        await rm(exportDir, { recursive: true, force: true });
+    }
+}
+async function readSidecar(path) {
+    try {
+        return JSON.parse(await readFile(path, 'utf8'));
+    }
+    catch {
+        return {};
+    }
+}
+/** Exported for tests. Maps one PNG + sidecar to a manifest entry (minus image path). */
+export function mapSidecar(png, sidecar) {
+    const container = sidecar.context?.preview?.container_display_name;
+    // Unnamed previews get an auto display name like "At line #14" — not a state.
+    const rawName = sidecar.display_name?.trim();
+    const displayName = rawName && !/^At line #\d+$/.test(rawName) ? rawName : undefined;
+    const fallback = container ? container.replace(/\s+/g, '') : png.replace(/\.png$/, '');
+    const { component, state } = parsePreviewName(fallback, displayName);
+    const scheme = sidecar.context?.preview?.preferred_color_scheme;
+    const group = sidecar.group; // e.g. "PhonebookSample/UserCard.swift"
+    const module = group?.includes('/') ? group.slice(0, group.indexOf('/')) : undefined;
+    return {
+        component: component || spaceCamelCase(fallback),
+        state,
+        module: module ?? 'app',
+        sourceFile: group,
+        previewName: rawName ?? png,
+        theme: scheme === 'dark' ? 'dark' : scheme === 'light' ? 'light' : undefined,
+        device: sidecar.context?.simulator?.device_name,
+    };
+}
+/**
+ * Runs xcodebuild. When `quiet` is false (the CLI default), output streams
+ * straight to this process's stdout/stderr as it arrives (so a human can
+ * watch the build) while a rolling ~200-line tail is kept alongside it for
+ * error translation. When `quiet` is true (used by the MCP server, whose
+ * stdout is the JSON-RPC channel and must never carry build output), only the
+ * tail is kept and nothing is echoed live; the tail is written to stderr once
+ * if the build fails.
+ *
+ * On a non-zero exit, the tail is run through `diagnoseXcodebuildFailure` —
+ * any matched diagnosis lines are printed to stderr (`phonebook: `-prefixed)
+ * and folded into the rejected Error's message, mirroring `runGradle`.
+ */
+export function runXcodebuild(cwd, args, env, quiet) {
+    return new Promise((resolvePromise, reject) => {
+        const child = spawn('xcodebuild', args, {
+            cwd: resolve(cwd),
+            stdio: ['ignore', 'pipe', 'pipe'],
+            env: { ...process.env, ...env },
+        });
+        let tail = [];
+        const onData = (target) => (data) => {
+            if (!quiet)
+                target.write(data);
+            tail.push(...data.toString('utf8').split('\n'));
+            if (tail.length > 200)
+                tail = tail.slice(-200);
+        };
+        child.stdout?.on('data', onData(process.stdout));
+        child.stderr?.on('data', onData(process.stderr));
+        child.on('error', reject);
+        child.on('close', (code) => {
+            if (code === 0) {
+                resolvePromise();
+                return;
+            }
+            const tailText = tail.join('\n');
+            const diagnosis = diagnoseXcodebuildFailure(tailText);
+            if (diagnosis.length > 0) {
+                process.stderr.write(diagnosis.map((line) => `phonebook: ${line}`).join('\n') + '\n');
+            }
+            if (quiet && tail.length > 0)
+                process.stderr.write(tailText + '\n');
+            const message = [
+                `xcodebuild failed (exit ${code}) running: xcodebuild ${args.join(' ')}`,
+                ...diagnosis,
+            ].join('\n');
+            reject(new Error(message));
+        });
+    });
+}
+//# sourceMappingURL=ios.js.map

package/dist/engines/ios.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Signature matching over raw Gradle (or xcodebuild) output, turning known
+ * failure patterns into human diagnosis lines. Zero lines means "no known
+ * signature matched" — the raw output should still be shown to the user.
+ */
+export declare function diagnoseGradleFailure(output: string): string[];
+/**
+ * Signature matching over raw xcodebuild output, turning known failure
+ * patterns into human diagnosis lines. Zero lines means "no known signature
+ * matched" — the raw output should still be shown to the user.
+ */
+export declare function diagnoseXcodebuildFailure(output: string): string[];