voltra 1.4.1 → 2.0.0-rc.4

package/build/cjs/reporting/summary.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PreflightError = exports.VoltraCliError = void 0;
+exports.formatApplySummary = formatApplySummary;
+exports.formatDirtyWorktreeWarning = formatDirtyWorktreeWarning;
+exports.formatAmbiguousDiscoveryWarning = formatAmbiguousDiscoveryWarning;
+exports.formatWarning = formatWarning;
+exports.formatError = formatError;
+exports.formatPreflightFailure = formatPreflightFailure;
+const PREFIX = '[voltra]';
+class VoltraCliError extends Error {
+    constructor(message, code = 'VOLTRA_CLI_ERROR') {
+        super(message);
+        this.name = 'VoltraCliError';
+        this.code = code;
+    }
+}
+exports.VoltraCliError = VoltraCliError;
+class PreflightError extends VoltraCliError {
+    constructor(report) {
+        super(formatPreflightFailure(report), 'VOLTRA_PREFLIGHT_FAILED');
+        this.name = 'PreflightError';
+        this.report = report;
+    }
+}
+exports.PreflightError = PreflightError;
+function formatApplySummary(summary) {
+    const lines = [
+        `${PREFIX} Apply summary`,
+        `${PREFIX} Created: ${countChanges(summary.changes, 'created')}`,
+        `${PREFIX} Updated: ${countChanges(summary.changes, 'updated')}`,
+        `${PREFIX} Deleted: ${countChanges(summary.changes, 'deleted')}`,
+    ];
+    for (const kind of ['created', 'updated', 'deleted']) {
+        const paths = summary.changes.filter((change) => change.kind === kind).map((change) => change.path);
+        for (const filePath of paths) {
+            lines.push(`${PREFIX} ${capitalize(kind)} ${filePath}`);
+        }
+    }
+    for (const warning of summary.warnings ?? []) {
+        lines.push(formatWarning(warning));
+    }
+    return lines.join('\n');
+}
+function formatDirtyWorktreeWarning(changeCount) {
+    if (!changeCount || changeCount <= 0) {
+        return `${PREFIX} Warning: git worktree has uncommitted changes.`;
+    }
+    const noun = changeCount === 1 ? 'change' : 'changes';
+    return `${PREFIX} Warning: git worktree has ${changeCount} uncommitted ${noun}.`;
+}
+function formatAmbiguousDiscoveryWarning(subject, candidates) {
+    if (candidates.length === 0) {
+        return `${PREFIX} Warning: ${subject} is ambiguous.`;
+    }
+    return `${PREFIX} Warning: ${subject} is ambiguous. Candidates: ${candidates.join(', ')}`;
+}
+function formatWarning(message) {
+    return `${PREFIX} Warning: ${message}`;
+}
+function formatError(message) {
+    return `${PREFIX} Error: ${message}`;
+}
+function formatPreflightFailure(report) {
+    const lines = [
+        report.summary ? formatError(report.summary) : formatError('Preflight failed.'),
+        ...report.issues.map((issue) => formatPreflightIssue(issue)),
+    ];
+    return lines.join('\n');
+}
+function formatPreflightIssue(issue) {
+    if (!issue.path) {
+        return `${PREFIX} Preflight: ${issue.message}`;
+    }
+    return `${PREFIX} Preflight: ${issue.path}: ${issue.message}`;
+}
+function countChanges(changes, kind) {
+    return changes.filter((change) => change.kind === kind).length;
+}
+function capitalize(value) {
+    return value.charAt(0).toUpperCase() + value.slice(1);
+}
+//# sourceMappingURL=summary.js.map

package/build/cjs/reporting/summary.js.map

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

package/build/cjs/state/diff.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.diffVoltraState = diffVoltraState;
+const files_1 = require("./files");
+function diffVoltraState(previousState, nextFiles) {
+    const previousFiles = (0, files_1.normalizeTrackedStateFilesForDiff)(previousState?.files);
+    const normalizedNextFiles = (0, files_1.normalizeTrackedStateFiles)(nextFiles, 'Next Voltra state files');
+    const nextFileSet = new Set(normalizedNextFiles);
+    return {
+        previousFiles,
+        nextFiles: normalizedNextFiles,
+        staleFiles: previousFiles.filter((filePath) => !nextFileSet.has(filePath)),
+    };
+}
+//# sourceMappingURL=diff.js.map

package/build/cjs/state/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../../src/state/diff.ts"],"names":[],"mappings":";;AAUA,0CAUC;AApBD,mCAAuF;AAUvF,SAAgB,eAAe,CAAC,aAAsC,EAAE,SAAmB;IACzF,MAAM,aAAa,GAAG,IAAA,yCAAiC,EAAC,aAAa,EAAE,KAAK,CAAC,CAAA;IAC7E,MAAM,mBAAmB,GAAG,IAAA,kCAA0B,EAAC,SAAS,EAAE,yBAAyB,CAAC,CAAA;IAC5F,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,mBAAmB,CAAC,CAAA;IAEhD,OAAO;QACL,aAAa;QACb,SAAS,EAAE,mBAAmB;QAC9B,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;KAC3E,CAAA;AACH,CAAC"}

package/build/cjs/state/files.js

@@ -0,0 +1,46 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeTrackedStateFiles = normalizeTrackedStateFiles;
+exports.normalizeTrackedStateFilesForDiff = normalizeTrackedStateFilesForDiff;
+const node_path_1 = __importDefault(require("node:path"));
+const path_1 = require("../fs/path");
+const summary_1 = require("../reporting/summary");
+function normalizeTrackedStateFiles(files, errorContext) {
+    if (!Array.isArray(files)) {
+        throw new summary_1.VoltraCliError(`${errorContext} must be an array.`);
+    }
+    const seen = new Set();
+    const normalizedFiles = [];
+    for (const filePath of files) {
+        if (typeof filePath !== 'string' || !filePath.trim()) {
+            throw new summary_1.VoltraCliError(`${errorContext} must contain only non-empty relative paths.`);
+        }
+        const normalizedFilePath = normalizeTrackedStateFilePath(filePath);
+        if (node_path_1.default.isAbsolute(normalizedFilePath)) {
+            throw new summary_1.VoltraCliError(`${errorContext} must contain only project-relative paths.`);
+        }
+        if (seen.has(normalizedFilePath)) {
+            continue;
+        }
+        seen.add(normalizedFilePath);
+        normalizedFiles.push(normalizedFilePath);
+    }
+    return normalizedFiles.sort((left, right) => left.localeCompare(right));
+}
+function normalizeTrackedStateFilePath(filePath) {
+    const normalizedFilePath = (0, path_1.normalizeRelativePath)(node_path_1.default.posix.normalize(filePath));
+    if (normalizedFilePath === '..' || normalizedFilePath.startsWith('../')) {
+        throw new summary_1.VoltraCliError('Voltra state files must contain only project-relative paths.');
+    }
+    return normalizedFilePath;
+}
+function normalizeTrackedStateFilesForDiff(files) {
+    if (!files || files.length === 0) {
+        return [];
+    }
+    return normalizeTrackedStateFiles(files, 'Voltra state files');
+}
+//# sourceMappingURL=files.js.map

package/build/cjs/state/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../../src/state/files.ts"],"names":[],"mappings":";;;;;AAKA,gEA4BC;AAYD,8EAMC;AAnDD,0DAA4B;AAE5B,qCAAkD;AAClD,kDAAqD;AAErD,SAAgB,0BAA0B,CAAC,KAA2B,EAAE,YAAoB;IAC1F,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,wBAAc,CAAC,GAAG,YAAY,oBAAoB,CAAC,CAAA;IAC/D,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,MAAM,eAAe,GAAa,EAAE,CAAA;IAEpC,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC7B,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;YACrD,MAAM,IAAI,wBAAc,CAAC,GAAG,YAAY,8CAA8C,CAAC,CAAA;QACzF,CAAC;QAED,MAAM,kBAAkB,GAAG,6BAA6B,CAAC,QAAQ,CAAC,CAAA;QAElE,IAAI,mBAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,wBAAc,CAAC,GAAG,YAAY,4CAA4C,CAAC,CAAA;QACvF,CAAC;QAED,IAAI,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACjC,SAAQ;QACV,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAA;QAC5B,eAAe,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAA;IAC1C,CAAC;IAED,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAA;AACzE,CAAC;AAED,SAAS,6BAA6B,CAAC,QAAgB;IACrD,MAAM,kBAAkB,GAAG,IAAA,4BAAqB,EAAC,mBAAI,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAA;IAEhF,IAAI,kBAAkB,KAAK,IAAI,IAAI,kBAAkB,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,wBAAc,CAAC,8DAA8D,CAAC,CAAA;IAC1F,CAAC;IAED,OAAO,kBAAkB,CAAA;AAC3B,CAAC;AAED,SAAgB,iCAAiC,CAAC,KAA2B;IAC3E,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,CAAA;IACX,CAAC;IAED,OAAO,0BAA0B,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAA;AAChE,CAAC"}

package/build/cjs/state/load.js

@@ -0,0 +1,48 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadVoltraState = loadVoltraState;
+exports.getVoltraStatePath = getVoltraStatePath;
+const node_path_1 = __importDefault(require("node:path"));
+const readWrite_1 = require("../fs/readWrite");
+const summary_1 = require("../reporting/summary");
+const files_1 = require("./files");
+const STATE_SCHEMA_VERSION = 1;
+const STATE_DIRECTORY_NAME = '.voltra';
+const STATE_FILE_NAME = 'state.json';
+async function loadVoltraState(projectRoot) {
+    const statePath = getVoltraStatePath(projectRoot);
+    if (!(await (0, readWrite_1.pathExists)(statePath))) {
+        return undefined;
+    }
+    let rawState;
+    try {
+        rawState = await (0, readWrite_1.readJsonFile)(statePath);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new summary_1.VoltraCliError(`Failed to read Voltra state at ${statePath}: ${message}`);
+    }
+    return validateVoltraState(rawState, statePath);
+}
+function getVoltraStatePath(projectRoot) {
+    return node_path_1.default.join(projectRoot, STATE_DIRECTORY_NAME, STATE_FILE_NAME);
+}
+function validateVoltraState(rawState, statePath) {
+    if (!rawState || typeof rawState !== 'object' || Array.isArray(rawState)) {
+        throw new summary_1.VoltraCliError(`Voltra state at ${statePath} must be a JSON object.`);
+    }
+    if (rawState.schemaVersion !== STATE_SCHEMA_VERSION) {
+        throw new summary_1.VoltraCliError(`Unsupported Voltra state schema at ${statePath}: expected ${STATE_SCHEMA_VERSION}, received ${String(rawState.schemaVersion)}.`);
+    }
+    if (!Array.isArray(rawState.files)) {
+        throw new summary_1.VoltraCliError(`Voltra state at ${statePath} must contain a files array.`);
+    }
+    return {
+        schemaVersion: STATE_SCHEMA_VERSION,
+        files: (0, files_1.normalizeTrackedStateFiles)(rawState.files, `Voltra state at ${statePath} files`),
+    };
+}
+//# sourceMappingURL=load.js.map

package/build/cjs/state/load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../../../src/state/load.ts"],"names":[],"mappings":";;;;;AAqBA,0CAiBC;AAED,gDAEC;AA1CD,0DAA4B;AAE5B,+CAA0D;AAC1D,kDAAqD;AAErD,mCAAoD;AAEpD,MAAM,oBAAoB,GAAG,CAAC,CAAA;AAC9B,MAAM,oBAAoB,GAAG,SAAS,CAAA;AACtC,MAAM,eAAe,GAAG,YAAY,CAAA;AAY7B,KAAK,UAAU,eAAe,CAAC,WAAmB;IACvD,MAAM,SAAS,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAA;IAEjD,IAAI,CAAC,CAAC,MAAM,IAAA,sBAAU,EAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QACnC,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,IAAI,QAAwB,CAAA;IAE5B,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,IAAA,wBAAY,EAAiB,SAAS,CAAC,CAAA;IAC1D,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACtE,MAAM,IAAI,wBAAc,CAAC,kCAAkC,SAAS,KAAK,OAAO,EAAE,CAAC,CAAA;IACrF,CAAC;IAED,OAAO,mBAAmB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;AACjD,CAAC;AAED,SAAgB,kBAAkB,CAAC,WAAmB;IACpD,OAAO,mBAAI,CAAC,IAAI,CAAC,WAAW,EAAE,oBAAoB,EAAE,eAAe,CAAC,CAAA;AACtE,CAAC;AAED,SAAS,mBAAmB,CAAC,QAAwB,EAAE,SAAiB;IACtE,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzE,MAAM,IAAI,wBAAc,CAAC,mBAAmB,SAAS,yBAAyB,CAAC,CAAA;IACjF,CAAC;IAED,IAAI,QAAQ,CAAC,aAAa,KAAK,oBAAoB,EAAE,CAAC;QACpD,MAAM,IAAI,wBAAc,CACtB,sCAAsC,SAAS,cAAc,oBAAoB,cAAc,MAAM,CACnG,QAAQ,CAAC,aAAa,CACvB,GAAG,CACL,CAAA;IACH,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,wBAAc,CAAC,mBAAmB,SAAS,8BAA8B,CAAC,CAAA;IACtF,CAAC;IAED,OAAO;QACL,aAAa,EAAE,oBAAoB;QACnC,KAAK,EAAE,IAAA,kCAA0B,EAAC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,SAAS,QAAQ,CAAC;KACxF,CAAA;AACH,CAAC"}

package/build/cjs/state/save.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.saveVoltraState = saveVoltraState;
+const readWrite_1 = require("../fs/readWrite");
+const summary_1 = require("../reporting/summary");
+const files_1 = require("./files");
+const load_1 = require("./load");
+const STATE_SCHEMA_VERSION = 1;
+async function saveVoltraState(projectRoot, input) {
+    const state = {
+        schemaVersion: STATE_SCHEMA_VERSION,
+        files: (0, files_1.normalizeTrackedStateFiles)(input.files, 'Voltra state files'),
+    };
+    const statePath = (0, load_1.getVoltraStatePath)(projectRoot);
+    try {
+        await (0, readWrite_1.writeJsonFile)(statePath, state);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new summary_1.VoltraCliError(`Failed to write Voltra state at ${statePath}: ${message}`);
+    }
+    return state;
+}
+//# sourceMappingURL=save.js.map

package/build/cjs/state/save.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"save.js","sourceRoot":"","sources":["../../../src/state/save.ts"],"names":[],"mappings":";;AAcA,0CAgBC;AA9BD,+CAA+C;AAC/C,kDAAqD;AAErD,mCAAoD;AACpD,iCAA2C;AAI3C,MAAM,oBAAoB,GAAG,CAAC,CAAA;AAMvB,KAAK,UAAU,eAAe,CAAC,WAAmB,EAAE,KAA2B;IACpF,MAAM,KAAK,GAAgB;QACzB,aAAa,EAAE,oBAAoB;QACnC,KAAK,EAAE,IAAA,kCAA0B,EAAC,KAAK,CAAC,KAAK,EAAE,oBAAoB,CAAC;KACrE,CAAA;IAED,MAAM,SAAS,GAAG,IAAA,yBAAkB,EAAC,WAAW,CAAC,CAAA;IAEjD,IAAI,CAAC;QACH,MAAM,IAAA,yBAAa,EAAC,SAAS,EAAE,KAAK,CAAC,CAAA;IACvC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACtE,MAAM,IAAI,wBAAc,CAAC,mCAAmC,SAAS,KAAK,OAAO,EAAE,CAAC,CAAA;IACtF,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC"}

package/build/esm/apply/index.js

@@ -0,0 +1,195 @@
+import path from 'node:path';
+import { normalizeRelativePath } from '../fs/path';
+import { loadVoltraConfig } from '../config/load';
+import { normalizeVoltraConfig } from '../config/normalize';
+import { removePathIfExists } from '../fs/readWrite';
+import { ensureGitWorktreeIsReady } from '../git/status';
+import { applyAndroidPlatform, createAndroidPreflightRunner } from '../platforms/android/apply';
+import { applyIOSPlatform, createIOSPreflightRunner } from '../platforms/ios/apply';
+import { renderApplySummary, renderIntro } from '../reporting/clack';
+import { VoltraCliError } from '../reporting/summary';
+import { diffVoltraState } from '../state/diff';
+import { loadVoltraState } from '../state/load';
+import { saveVoltraState } from '../state/save';
+import { runApplyPreflight } from './preflight';
+const DEFAULT_DEPENDENCIES = {
+    applyRunners: {},
+    preflightRunners: {},
+    async writeIntro() {
+        await renderIntro();
+    },
+    async writeSummary(summary) {
+        await renderApplySummary(summary);
+    },
+};
+export async function applyVoltra(options) {
+    try {
+        await runApplyPipeline(options, DEFAULT_DEPENDENCIES);
+        return {
+            exitCode: 0,
+        };
+    }
+    catch (error) {
+        return {
+            exitCode: 1,
+            errorMessage: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+export async function runApplyPipeline(options, dependencies) {
+    const loadedConfig = await loadVoltraConfig({ configPath: options.configPath });
+    const normalizedConfig = normalizeVoltraConfig(loadedConfig);
+    const resolvedDependencies = resolveApplyDependencies(normalizedConfig, dependencies);
+    await resolvedDependencies.writeIntro();
+    await ensureGitWorktreeIsReady({
+        cwd: normalizedConfig.projectRoot,
+        allowDirty: options.allowDirty,
+    });
+    const preflight = await runApplyPreflight(normalizedConfig, resolvedDependencies.preflightRunners, options.platform);
+    const previousState = await loadVoltraState(normalizedConfig.projectRoot);
+    const platformResults = await runPlatformApply(normalizedConfig, preflight, previousState, resolvedDependencies.applyRunners);
+    const nextGeneratedFiles = mergeGeneratedFiles(normalizedConfig, previousState, preflight.requestedPlatforms, platformResults);
+    const stateDiff = diffVoltraState(previousState, nextGeneratedFiles);
+    const deletedChanges = await removeStaleGeneratedFiles(normalizedConfig.projectRoot, stateDiff.staleFiles);
+    await saveVoltraState(normalizedConfig.projectRoot, { files: stateDiff.nextFiles });
+    const summaryWarnings = platformResults.flatMap((result) => result.warnings ?? []).filter(isDefined);
+    const summaryChanges = [...platformResults.flatMap((result) => result.changes), ...deletedChanges];
+    await resolvedDependencies.writeSummary({ changes: summaryChanges, warnings: summaryWarnings });
+}
+function resolveApplyDependencies(config, dependencies) {
+    return {
+        applyRunners: {
+            android: dependencies.applyRunners.android ?? applyAndroidPlatform,
+            ios: dependencies.applyRunners.ios ?? applyIOSPlatform,
+        },
+        preflightRunners: {
+            android: dependencies.preflightRunners.android ?? (config.android ? createAndroidPreflightRunner(config) : undefined),
+            ios: dependencies.preflightRunners.ios ?? (config.ios ? createIOSPreflightRunner(config) : undefined),
+        },
+        writeIntro: dependencies.writeIntro,
+        writeSummary: dependencies.writeSummary,
+    };
+}
+function mergeGeneratedFiles(config, previousState, requestedPlatforms, platformResults) {
+    const nextGeneratedFilesByPlatform = new Map(platformResults.map((result) => [result.platform, result.generatedFiles]));
+    const mergedFiles = new Set();
+    const platformRoots = getTrackedPlatformRoots(config);
+    const configuredPlatforms = getConfiguredPlatforms(config);
+    const isPartialApply = requestedPlatforms.length < configuredPlatforms.length;
+    for (const previousFile of previousState?.files ?? []) {
+        const owningPlatform = getTrackedFilePlatform(previousFile, platformRoots);
+        if (!owningPlatform) {
+            if (isPartialApply) {
+                mergedFiles.add(previousFile);
+            }
+            continue;
+        }
+        if (requestedPlatforms.includes(owningPlatform)) {
+            continue;
+        }
+        mergedFiles.add(previousFile);
+    }
+    for (const platform of requestedPlatforms) {
+        for (const filePath of nextGeneratedFilesByPlatform.get(platform) ?? []) {
+            mergedFiles.add(filePath);
+        }
+    }
+    return [...mergedFiles];
+}
+function getTrackedPlatformRoots(config) {
+    const projectRoot = config.projectRoot;
+    const androidRoot = config.android
+        ? normalizeRelativePath(path.relative(projectRoot, config.android.project.rootDir ?? path.join(projectRoot, 'android')))
+        : undefined;
+    const iosRoot = config.ios
+        ? normalizeRelativePath(path.relative(projectRoot, config.ios.project.rootDir ?? path.join(projectRoot, 'ios')))
+        : undefined;
+    return {
+        ...(androidRoot ? { android: androidRoot } : {}),
+        ...(iosRoot ? { ios: iosRoot } : {}),
+    };
+}
+function getConfiguredPlatforms(config) {
+    const platforms = [];
+    if (config.android) {
+        platforms.push('android');
+    }
+    if (config.ios) {
+        platforms.push('ios');
+    }
+    return platforms;
+}
+function getTrackedFilePlatform(filePath, platformRoots) {
+    const normalizedFilePath = normalizeRelativePath(filePath);
+    for (const platform of ['android', 'ios']) {
+        const root = platformRoots[platform];
+        if (!root) {
+            continue;
+        }
+        if (normalizedFilePath === root || normalizedFilePath.startsWith(`${root}/`)) {
+            return platform;
+        }
+    }
+    return undefined;
+}
+async function runPlatformApply(config, preflight, previousState, applyRunners) {
+    const missingRunners = preflight.requestedPlatforms.filter((platform) => !applyRunners[platform]);
+    if (missingRunners.length > 0) {
+        throw new VoltraCliError(`No apply runner is registered for ${missingRunners.join(', ')}.`);
+    }
+    const results = [];
+    for (const platform of preflight.requestedPlatforms) {
+        const applyRunner = applyRunners[platform];
+        if (!applyRunner) {
+            throw new VoltraCliError(`No apply runner is registered for ${platform}.`);
+        }
+        let result;
+        try {
+            result = await applyRunner({
+                config,
+                platform,
+                preflight: preflight.platformResults[platform],
+                previousState,
+                requestedPlatforms: preflight.requestedPlatforms,
+            });
+        }
+        catch (error) {
+            throw new VoltraCliError(`Apply failed for ${platform}: ${getApplyRunnerErrorMessage(error)}`);
+        }
+        if (result.platform !== platform) {
+            throw new VoltraCliError(`Apply runner returned a mismatched platform result: expected ${platform}, received ${result.platform}.`);
+        }
+        results.push(result);
+    }
+    return results;
+}
+async function removeStaleGeneratedFiles(projectRoot, staleFiles) {
+    const deletedChanges = [];
+    for (const staleFile of staleFiles) {
+        const staleFilePath = path.join(projectRoot, staleFile);
+        let deleted;
+        try {
+            deleted = await removePathIfExists(staleFilePath);
+        }
+        catch (error) {
+            throw new VoltraCliError(`Failed to remove stale generated file ${staleFile}: ${getApplyRunnerErrorMessage(error)}`);
+        }
+        if (deleted) {
+            deletedChanges.push({
+                kind: 'deleted',
+                path: staleFile,
+            });
+        }
+    }
+    return deletedChanges;
+}
+function isDefined(value) {
+    return value !== undefined;
+}
+function getApplyRunnerErrorMessage(error) {
+    if (error instanceof Error && error.message) {
+        return error.message;
+    }
+    return String(error);
+}
+//# sourceMappingURL=index.js.map

package/build/esm/apply/index.js.map

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

package/build/esm/apply/preflight.js

@@ -0,0 +1,106 @@
+import { PreflightError } from '../reporting/summary';
+export function getRequestedPlatforms(config, platform) {
+    if (platform) {
+        validateConfiguredPlatform(config, platform);
+        return [platform];
+    }
+    const configuredPlatforms = getConfiguredPlatforms(config);
+    if (configuredPlatforms.length === 0) {
+        throw new PreflightError({
+            summary: 'No platforms are configured for Voltra apply.',
+            issues: [{ message: 'Add an android or ios config block before running apply.' }],
+        });
+    }
+    return configuredPlatforms;
+}
+export async function runApplyPreflight(config, runners, platform) {
+    const requestedPlatforms = getRequestedPlatforms(config, platform);
+    const preflightContext = { requestedPlatforms };
+    const failures = [];
+    const platformResults = {};
+    await Promise.all(requestedPlatforms.map(async (requestedPlatform) => {
+        const runner = runners[requestedPlatform];
+        if (!runner) {
+            failures.push({
+                platform: requestedPlatform,
+                issues: [{ message: `No preflight runner is registered for ${requestedPlatform}.` }],
+            });
+            return;
+        }
+        let result;
+        try {
+            result = await runner(preflightContext);
+        }
+        catch (error) {
+            failures.push({
+                platform: requestedPlatform,
+                issues: [{ message: getPreflightRunnerErrorMessage(error) }],
+            });
+            return;
+        }
+        if ('issues' in result) {
+            failures.push(result);
+            return;
+        }
+        if (result.platform !== requestedPlatform) {
+            failures.push({
+                platform: requestedPlatform,
+                issues: [{ message: `Preflight runner returned a mismatched platform result: ${result.platform}.` }],
+            });
+            return;
+        }
+        platformResults[requestedPlatform] = result.context;
+    }));
+    if (failures.length > 0) {
+        throw new PreflightError(buildPreflightFailureReport(failures));
+    }
+    return {
+        requestedPlatforms,
+        platformResults,
+    };
+}
+function getConfiguredPlatforms(config) {
+    const platforms = [];
+    if (config.android) {
+        platforms.push('android');
+    }
+    if (config.ios) {
+        platforms.push('ios');
+    }
+    return platforms;
+}
+function validateConfiguredPlatform(config, platform) {
+    if ((platform === 'android' && config.android) || (platform === 'ios' && config.ios)) {
+        return;
+    }
+    throw new PreflightError({
+        summary: `Requested platform '${platform}' is not configured.`,
+        issues: [{ message: `Add a ${platform} config block or remove --platform ${platform}.` }],
+    });
+}
+function buildPreflightFailureReport(failures) {
+    const orderedFailures = [...failures].sort((left, right) => comparePlatforms(left.platform, right.platform));
+    return {
+        summary: 'Preflight failed before any files were written.',
+        issues: orderedFailures.flatMap((failure) => failure.issues.map((issue) => ({
+            ...issue,
+            message: `${failure.platform}: ${issue.message}`,
+        }))),
+    };
+}
+function getPreflightRunnerErrorMessage(error) {
+    if (error instanceof Error && error.message) {
+        return error.message;
+    }
+    return String(error);
+}
+function comparePlatforms(left, right) {
+    return getPlatformSortOrder(left) - getPlatformSortOrder(right);
+}
+function getPlatformSortOrder(platform) {
+    if (platform === 'android') {
+        return 0;
+    }
+    return 1;
+}
+//# sourceMappingURL=preflight.js.map

package/build/esm/apply/preflight.js.map

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

package/build/esm/bin.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import { runCli } from './index';
+void runCli(process.argv.slice(2))
+    .then((exitCode) => {
+    process.exitCode = exitCode;
+})
+    .catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`${message}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=bin.js.map

package/build/esm/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../../src/bin.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAEhC,KAAK,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KAC/B,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;IACjB,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAA;AAC7B,CAAC,CAAC;KACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAEtE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAA;IACpC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;AACtB,CAAC,CAAC,CAAA"}