voltra 1.4.1 → 2.0.0-rc.3

package/build/esm/reporting/summary.js

@@ -0,0 +1,72 @@
+const PREFIX = '[voltra]';
+export class VoltraCliError extends Error {
+    constructor(message, code = 'VOLTRA_CLI_ERROR') {
+        super(message);
+        this.name = 'VoltraCliError';
+        this.code = code;
+    }
+}
+export class PreflightError extends VoltraCliError {
+    constructor(report) {
+        super(formatPreflightFailure(report), 'VOLTRA_PREFLIGHT_FAILED');
+        this.name = 'PreflightError';
+        this.report = report;
+    }
+}
+export 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');
+}
+export 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}.`;
+}
+export function formatAmbiguousDiscoveryWarning(subject, candidates) {
+    if (candidates.length === 0) {
+        return `${PREFIX} Warning: ${subject} is ambiguous.`;
+    }
+    return `${PREFIX} Warning: ${subject} is ambiguous. Candidates: ${candidates.join(', ')}`;
+}
+export function formatWarning(message) {
+    return `${PREFIX} Warning: ${message}`;
+}
+export function formatError(message) {
+    return `${PREFIX} Error: ${message}`;
+}
+export 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/esm/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/esm/state/diff.js

@@ -0,0 +1,12 @@
+import { normalizeTrackedStateFiles, normalizeTrackedStateFilesForDiff } from './files';
+export function diffVoltraState(previousState, nextFiles) {
+    const previousFiles = normalizeTrackedStateFilesForDiff(previousState?.files);
+    const normalizedNextFiles = 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/esm/state/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../../src/state/diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,iCAAiC,EAAE,MAAM,SAAS,CAAA;AAUvF,MAAM,UAAU,eAAe,CAAC,aAAsC,EAAE,SAAmB;IACzF,MAAM,aAAa,GAAG,iCAAiC,CAAC,aAAa,EAAE,KAAK,CAAC,CAAA;IAC7E,MAAM,mBAAmB,GAAG,0BAA0B,CAAC,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/esm/state/files.js

@@ -0,0 +1,39 @@
+import path from 'node:path';
+import { normalizeRelativePath } from '../fs/path';
+import { VoltraCliError } from '../reporting/summary';
+export function normalizeTrackedStateFiles(files, errorContext) {
+    if (!Array.isArray(files)) {
+        throw new 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 VoltraCliError(`${errorContext} must contain only non-empty relative paths.`);
+        }
+        const normalizedFilePath = normalizeTrackedStateFilePath(filePath);
+        if (path.isAbsolute(normalizedFilePath)) {
+            throw new 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 = normalizeRelativePath(path.posix.normalize(filePath));
+    if (normalizedFilePath === '..' || normalizedFilePath.startsWith('../')) {
+        throw new VoltraCliError('Voltra state files must contain only project-relative paths.');
+    }
+    return normalizedFilePath;
+}
+export function normalizeTrackedStateFilesForDiff(files) {
+    if (!files || files.length === 0) {
+        return [];
+    }
+    return normalizeTrackedStateFiles(files, 'Voltra state files');
+}
+//# sourceMappingURL=files.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../../src/state/files.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAErD,MAAM,UAAU,0BAA0B,CAAC,KAA2B,EAAE,YAAoB;IAC1F,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,cAAc,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,cAAc,CAAC,GAAG,YAAY,8CAA8C,CAAC,CAAA;QACzF,CAAC;QAED,MAAM,kBAAkB,GAAG,6BAA6B,CAAC,QAAQ,CAAC,CAAA;QAElE,IAAI,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,cAAc,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,qBAAqB,CAAC,IAAI,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,cAAc,CAAC,8DAA8D,CAAC,CAAA;IAC1F,CAAC;IAED,OAAO,kBAAkB,CAAA;AAC3B,CAAC;AAED,MAAM,UAAU,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/esm/state/load.js

@@ -0,0 +1,41 @@
+import path from 'node:path';
+import { pathExists, readJsonFile } from '../fs/readWrite';
+import { VoltraCliError } from '../reporting/summary';
+import { normalizeTrackedStateFiles } from './files';
+const STATE_SCHEMA_VERSION = 1;
+const STATE_DIRECTORY_NAME = '.voltra';
+const STATE_FILE_NAME = 'state.json';
+export async function loadVoltraState(projectRoot) {
+    const statePath = getVoltraStatePath(projectRoot);
+    if (!(await pathExists(statePath))) {
+        return undefined;
+    }
+    let rawState;
+    try {
+        rawState = await readJsonFile(statePath);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new VoltraCliError(`Failed to read Voltra state at ${statePath}: ${message}`);
+    }
+    return validateVoltraState(rawState, statePath);
+}
+export function getVoltraStatePath(projectRoot) {
+    return path.join(projectRoot, STATE_DIRECTORY_NAME, STATE_FILE_NAME);
+}
+function validateVoltraState(rawState, statePath) {
+    if (!rawState || typeof rawState !== 'object' || Array.isArray(rawState)) {
+        throw new VoltraCliError(`Voltra state at ${statePath} must be a JSON object.`);
+    }
+    if (rawState.schemaVersion !== STATE_SCHEMA_VERSION) {
+        throw new VoltraCliError(`Unsupported Voltra state schema at ${statePath}: expected ${STATE_SCHEMA_VERSION}, received ${String(rawState.schemaVersion)}.`);
+    }
+    if (!Array.isArray(rawState.files)) {
+        throw new VoltraCliError(`Voltra state at ${statePath} must contain a files array.`);
+    }
+    return {
+        schemaVersion: STATE_SCHEMA_VERSION,
+        files: normalizeTrackedStateFiles(rawState.files, `Voltra state at ${statePath} files`),
+    };
+}
+//# sourceMappingURL=load.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../../../src/state/load.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAErD,OAAO,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAA;AAEpD,MAAM,oBAAoB,GAAG,CAAC,CAAA;AAC9B,MAAM,oBAAoB,GAAG,SAAS,CAAA;AACtC,MAAM,eAAe,GAAG,YAAY,CAAA;AAYpC,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,WAAmB;IACvD,MAAM,SAAS,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAA;IAEjD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;QACnC,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,IAAI,QAAwB,CAAA;IAE5B,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,YAAY,CAAiB,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,cAAc,CAAC,kCAAkC,SAAS,KAAK,OAAO,EAAE,CAAC,CAAA;IACrF,CAAC;IAED,OAAO,mBAAmB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;AACjD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,WAAmB;IACpD,OAAO,IAAI,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,cAAc,CAAC,mBAAmB,SAAS,yBAAyB,CAAC,CAAA;IACjF,CAAC;IAED,IAAI,QAAQ,CAAC,aAAa,KAAK,oBAAoB,EAAE,CAAC;QACpD,MAAM,IAAI,cAAc,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,cAAc,CAAC,mBAAmB,SAAS,8BAA8B,CAAC,CAAA;IACtF,CAAC;IAED,OAAO;QACL,aAAa,EAAE,oBAAoB;QACnC,KAAK,EAAE,0BAA0B,CAAC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,SAAS,QAAQ,CAAC;KACxF,CAAA;AACH,CAAC"}

package/build/esm/state/save.js

@@ -0,0 +1,21 @@
+import { writeJsonFile } from '../fs/readWrite';
+import { VoltraCliError } from '../reporting/summary';
+import { normalizeTrackedStateFiles } from './files';
+import { getVoltraStatePath } from './load';
+const STATE_SCHEMA_VERSION = 1;
+export async function saveVoltraState(projectRoot, input) {
+    const state = {
+        schemaVersion: STATE_SCHEMA_VERSION,
+        files: normalizeTrackedStateFiles(input.files, 'Voltra state files'),
+    };
+    const statePath = getVoltraStatePath(projectRoot);
+    try {
+        await writeJsonFile(statePath, state);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new VoltraCliError(`Failed to write Voltra state at ${statePath}: ${message}`);
+    }
+    return state;
+}
+//# sourceMappingURL=save.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"save.js","sourceRoot":"","sources":["../../../src/state/save.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAErD,OAAO,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAA;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAA;AAI3C,MAAM,oBAAoB,GAAG,CAAC,CAAA;AAM9B,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,WAAmB,EAAE,KAA2B;IACpF,MAAM,KAAK,GAAgB;QACzB,aAAa,EAAE,oBAAoB;QACnC,KAAK,EAAE,0BAA0B,CAAC,KAAK,CAAC,KAAK,EAAE,oBAAoB,CAAC;KACrE,CAAA;IAED,MAAM,SAAS,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAA;IAEjD,IAAI,CAAC;QACH,MAAM,aAAa,CAAC,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,cAAc,CAAC,mCAAmC,SAAS,KAAK,OAAO,EAAE,CAAC,CAAA;IACtF,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC"}

package/build/types/apply/index.d.ts

@@ -0,0 +1,39 @@
+import type { NormalizedVoltraConfig, VoltraPlatform } from '../config/types';
+import type { ApplyPreflightRunners } from './preflight';
+import type { ReportedChange } from '../reporting/summary';
+import type { VoltraState } from '../state/load';
+export interface ApplyOptions {
+    configPath?: string;
+    platform?: VoltraPlatform;
+    allowDirty?: boolean;
+}
+export interface ApplyResult {
+    exitCode: number;
+    errorMessage?: string;
+}
+export interface PlatformApplyContext {
+    config: NormalizedVoltraConfig;
+    platform: VoltraPlatform;
+    preflight: unknown;
+    previousState?: VoltraState;
+    requestedPlatforms: VoltraPlatform[];
+}
+export interface PlatformApplyResult {
+    platform: VoltraPlatform;
+    changes: ReportedChange[];
+    generatedFiles: string[];
+    warnings?: string[];
+}
+export type PlatformApplyRunner = (context: PlatformApplyContext) => Promise<PlatformApplyResult>;
+export interface ApplyDependencies {
+    applyRunners: Partial<Record<VoltraPlatform, PlatformApplyRunner>>;
+    preflightRunners: ApplyPreflightRunners;
+    writeIntro(): Promise<void>;
+    writeSummary(summary: {
+        changes: ReportedChange[];
+        warnings?: string[];
+    }): Promise<void>;
+}
+export declare function applyVoltra(options: ApplyOptions): Promise<ApplyResult>;
+export declare function runApplyPipeline(options: ApplyOptions, dependencies: ApplyDependencies): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/build/types/apply/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/apply/index.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAC7E,OAAO,KAAK,EAAwB,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,sBAAsB,CAAA;IAC9B,QAAQ,EAAE,cAAc,CAAA;IACxB,SAAS,EAAE,OAAO,CAAA;IAClB,aAAa,CAAC,EAAE,WAAW,CAAA;IAC3B,kBAAkB,EAAE,cAAc,EAAE,CAAA;CACrC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,cAAc,CAAA;IACxB,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAA;AAEjG,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,mBAAmB,CAAC,CAAC,CAAA;IAClE,gBAAgB,EAAE,qBAAqB,CAAA;IACvC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3B,YAAY,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,cAAc,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACzF;AAaD,wBAAsB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAa7E;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+B5G"}

package/build/types/apply/preflight.d.ts

@@ -0,0 +1,26 @@
+import type { NormalizedVoltraConfig, VoltraPlatform } from '../config/types';
+import type { PreflightIssue } from '../reporting/summary';
+export interface PlatformPreflightSuccess<TContext> {
+    platform: VoltraPlatform;
+    context: TContext;
+}
+export interface PlatformPreflightFailure {
+    platform: VoltraPlatform;
+    issues: PreflightIssue[];
+}
+export type PlatformPreflightResult<TContext> = PlatformPreflightSuccess<TContext> | PlatformPreflightFailure;
+export interface ApplyPreflightContext {
+    requestedPlatforms: VoltraPlatform[];
+}
+export type PlatformPreflightRunner<TContext> = (context: ApplyPreflightContext) => Promise<PlatformPreflightResult<TContext>>;
+export interface ApplyPreflightRunners {
+    android?: PlatformPreflightRunner<unknown>;
+    ios?: PlatformPreflightRunner<unknown>;
+}
+export interface ApplyPreflightResult {
+    requestedPlatforms: VoltraPlatform[];
+    platformResults: Partial<Record<VoltraPlatform, unknown>>;
+}
+export declare function getRequestedPlatforms(config: NormalizedVoltraConfig, platform?: VoltraPlatform): VoltraPlatform[];
+export declare function runApplyPreflight(config: NormalizedVoltraConfig, runners: ApplyPreflightRunners, platform?: VoltraPlatform): Promise<ApplyPreflightResult>;
+//# sourceMappingURL=preflight.d.ts.map

package/build/types/apply/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../../src/apply/preflight.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAC7E,OAAO,KAAK,EAA0B,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAElF,MAAM,WAAW,wBAAwB,CAAC,QAAQ;IAChD,QAAQ,EAAE,cAAc,CAAA;IACxB,OAAO,EAAE,QAAQ,CAAA;CAClB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,cAAc,CAAA;IACxB,MAAM,EAAE,cAAc,EAAE,CAAA;CACzB;AAED,MAAM,MAAM,uBAAuB,CAAC,QAAQ,IAAI,wBAAwB,CAAC,QAAQ,CAAC,GAAG,wBAAwB,CAAA;AAE7G,MAAM,WAAW,qBAAqB;IACpC,kBAAkB,EAAE,cAAc,EAAE,CAAA;CACrC;AAED,MAAM,MAAM,uBAAuB,CAAC,QAAQ,IAAI,CAC9C,OAAO,EAAE,qBAAqB,KAC3B,OAAO,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC,CAAA;AAE/C,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,uBAAuB,CAAC,OAAO,CAAC,CAAA;IAC1C,GAAG,CAAC,EAAE,uBAAuB,CAAC,OAAO,CAAC,CAAA;CACvC;AAED,MAAM,WAAW,oBAAoB;IACnC,kBAAkB,EAAE,cAAc,EAAE,CAAA;IACpC,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAA;CAC1D;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,sBAAsB,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,cAAc,EAAE,CAgBjH;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,sBAAsB,EAC9B,OAAO,EAAE,qBAAqB,EAC9B,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,oBAAoB,CAAC,CAuD/B"}

package/build/types/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/build/types/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../../src/bin.ts"],"names":[],"mappings":""}

package/build/types/commands/apply.d.ts

@@ -0,0 +1,8 @@
+import { Command } from 'commander';
+export declare const CLI_EXIT_CODE_SUCCESS = 0;
+export declare const CLI_EXIT_CODE_FAILURE = 1;
+export declare function runApplyCommand(argv: string[]): Promise<number>;
+export declare function createApplyCommand(onComplete?: (exitCode: number) => void): Command;
+export declare function formatCommandError(error: unknown): string;
+export declare function getApplyHelpText(): string;
+//# sourceMappingURL=apply.d.ts.map

package/build/types/commands/apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../../src/commands/apply.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAQnC,eAAO,MAAM,qBAAqB,IAAI,CAAA;AACtC,eAAO,MAAM,qBAAqB,IAAI,CAAA;AAQtC,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAYrE;AAED,wBAAgB,kBAAkB,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAyBnF;AAkDD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGzD;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC"}

package/build/types/config/defaults.d.ts

@@ -0,0 +1,32 @@
+import type { IOSWidgetFamily } from './types';
+export declare const DEFAULT_ANDROID_ENABLE_NOTIFICATIONS = false;
+export declare const DEFAULT_ANDROID_SERVER_UPDATE_INTERVAL_MINUTES = 60;
+export declare const DEFAULT_ANDROID_SERVER_UPDATE_REFRESH = false;
+export declare const DEFAULT_ANDROID_USER_IMAGES_PATH = "./assets/voltra-android";
+export declare const DEFAULT_IOS_ENABLE_PUSH_NOTIFICATIONS = false;
+export declare const DEFAULT_IOS_DEPLOYMENT_TARGET = "17.0";
+export declare const DEFAULT_IOS_SERVER_UPDATE_INTERVAL_MINUTES = 15;
+export declare const DEFAULT_IOS_SERVER_UPDATE_REFRESH = false;
+export declare const DEFAULT_IOS_USER_IMAGES_PATH = "./assets/voltra";
+export declare const DEFAULT_IOS_WIDGET_FAMILIES: IOSWidgetFamily[];
+/**
+ * These defaults intentionally mirror the existing Expo plugin behavior where that behavior is already explicit.
+ * Some values, such as the default iOS widget target name, still depend on native project discovery and app naming.
+ */
+export declare const CLI_DEFAULTS: {
+    readonly android: {
+        readonly enableNotifications: false;
+        readonly serverUpdateIntervalMinutes: 60;
+        readonly serverUpdateRefresh: false;
+        readonly userImagesPath: "./assets/voltra-android";
+    };
+    readonly ios: {
+        readonly deploymentTarget: "17.0";
+        readonly enablePushNotifications: false;
+        readonly serverUpdateIntervalMinutes: 15;
+        readonly serverUpdateRefresh: false;
+        readonly userImagesPath: "./assets/voltra";
+        readonly widgetFamilies: IOSWidgetFamily[];
+    };
+};
+//# sourceMappingURL=defaults.d.ts.map

package/build/types/config/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../../src/config/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,eAAO,MAAM,oCAAoC,QAAQ,CAAA;AACzD,eAAO,MAAM,8CAA8C,KAAK,CAAA;AAChE,eAAO,MAAM,qCAAqC,QAAQ,CAAA;AAC1D,eAAO,MAAM,gCAAgC,4BAA4B,CAAA;AAEzE,eAAO,MAAM,qCAAqC,QAAQ,CAAA;AAC1D,eAAO,MAAM,6BAA6B,SAAS,CAAA;AACnD,eAAO,MAAM,0CAA0C,KAAK,CAAA;AAC5D,eAAO,MAAM,iCAAiC,QAAQ,CAAA;AACtD,eAAO,MAAM,4BAA4B,oBAAoB,CAAA;AAC7D,eAAO,MAAM,2BAA2B,EAAE,eAAe,EAAmD,CAAA;AAE5G;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;CAef,CAAA"}

package/build/types/config/load.d.ts

@@ -0,0 +1,11 @@
+import type { LoadedVoltraConfig } from './types';
+export declare class VoltraConfigLoadError extends Error {
+    cause?: Error;
+    constructor(message: string, cause?: Error);
+}
+export interface LoadVoltraConfigOptions {
+    configPath?: string;
+    cwd?: string;
+}
+export declare function loadVoltraConfig(options?: LoadVoltraConfigOptions): Promise<LoadedVoltraConfig>;
+//# sourceMappingURL=load.d.ts.map

package/build/types/config/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../../src/config/load.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAgB,MAAM,SAAS,CAAA;AAI/D,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,KAAK,CAAC,EAAE,KAAK,CAAA;gBAED,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAK3C;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAyCD,wBAAsB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAmCzG"}

package/build/types/config/normalize.d.ts

@@ -0,0 +1,6 @@
+import type { LoadedVoltraConfig, NormalizedVoltraConfig } from './types';
+export declare class VoltraConfigNormalizationError extends Error {
+    constructor(message: string);
+}
+export declare function normalizeVoltraConfig(loadedConfig: LoadedVoltraConfig): NormalizedVoltraConfig;
+//# sourceMappingURL=normalize.d.ts.map

package/build/types/config/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../src/config/normalize.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAGV,kBAAkB,EAGlB,sBAAsB,EAMvB,MAAM,SAAS,CAAA;AAYhB,qBAAa,8BAA+B,SAAQ,KAAK;gBAC3C,OAAO,EAAE,MAAM;CAI5B;AA0XD,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,kBAAkB,GAAG,sBAAsB,CAgB9F"}

package/build/types/config/types.d.ts

@@ -0,0 +1,250 @@
+import type { CLI_DEFAULTS } from './defaults';
+export type VoltraPlatform = 'android' | 'ios';
+/**
+ * Per-locale widget copy or build-time initial state paths.
+ * This intentionally matches the existing Expo plugin contract.
+ */
+export type WidgetLocalizedValue = Record<string, string>;
+/** Widget display text, either as a single string or localized by locale identifier. */
+export type WidgetLabel = string | WidgetLocalizedValue;
+/** Path to a widget initial state module, either as a single path or localized by locale identifier. */
+export type WidgetInitialStatePath = string | WidgetLocalizedValue;
+export interface AndroidWidgetServerUpdateConfig {
+    /** Server endpoint that returns widget state updates. */
+    url: string;
+    /** Refresh interval, in minutes, for fetching server updates. */
+    intervalMinutes?: number;
+    /** Whether fetched updates should trigger an immediate widget refresh. */
+    refresh?: boolean;
+}
+export interface AndroidWidgetConfig {
+    /** Stable widget identifier used in generated files and registrations. */
+    id: string;
+    /** User-facing widget name shown by the launcher. */
+    displayName: WidgetLabel;
+    /** User-facing widget description shown by the launcher. */
+    description: WidgetLabel;
+    /** Minimum widget width in dp. */
+    minWidth?: number;
+    /** Minimum widget height in dp. */
+    minHeight?: number;
+    /** Minimum widget width in launcher grid cells. */
+    minCellWidth?: number;
+    /** Minimum widget height in launcher grid cells. */
+    minCellHeight?: number;
+    /** Default widget width in launcher grid cells. */
+    targetCellWidth: number;
+    /** Default widget height in launcher grid cells. */
+    targetCellHeight: number;
+    /** Supported resize directions for the Android widget. */
+    resizeMode?: 'none' | 'horizontal' | 'vertical' | 'horizontal|vertical';
+    /** Launcher surfaces where the widget can be placed. */
+    widgetCategory?: 'home_screen' | 'keyguard' | 'home_screen|keyguard';
+    /** Path to the build-time initial state module for this widget. */
+    initialStatePath?: WidgetInitialStatePath;
+    /** Server-driven update settings for this widget. */
+    serverUpdate?: AndroidWidgetServerUpdateConfig;
+    /** Path to the preview image shown in widget pickers. */
+    previewImage?: string;
+    /** Path to a preview layout XML file shown in widget pickers. */
+    previewLayout?: string;
+}
+export type IOSWidgetFamily = 'systemSmall' | 'systemMedium' | 'systemLarge' | 'systemExtraLarge' | 'accessoryCircular' | 'accessoryRectangular' | 'accessoryInline';
+export interface IOSWidgetServerUpdateConfig {
+    /** Server endpoint that returns widget state updates. */
+    url: string;
+    /** Refresh interval, in minutes, for fetching server updates. */
+    intervalMinutes?: number;
+    /** Whether fetched updates should trigger an immediate widget refresh. */
+    refresh?: boolean;
+}
+export interface IOSWidgetConfig {
+    /** Stable widget identifier used in generated files and registrations. */
+    id: string;
+    /** User-facing widget name shown in iOS widget configuration UI. */
+    displayName: WidgetLabel;
+    /** User-facing widget description shown in iOS widget configuration UI. */
+    description: WidgetLabel;
+    /** Supported iOS widget families for this widget. */
+    supportedFamilies?: IOSWidgetFamily[];
+    /** Path to the build-time initial state module for this widget. */
+    initialStatePath?: WidgetInitialStatePath;
+    /** Server-driven update settings for this widget. */
+    serverUpdate?: IOSWidgetServerUpdateConfig;
+}
+export interface AndroidProjectOverrides {
+    /** Root directory of the Android native project. Defaults to `android/` under `projectRoot`. */
+    rootDir?: string;
+    /** Android app module name. Defaults to `app` when it can be inferred. */
+    appModuleName?: string;
+    /** Explicit path to the AndroidManifest.xml file for the app module. */
+    manifestPath?: string;
+    /** Explicit Android package name if it cannot be derived from the project files. */
+    packageName?: string;
+}
+export interface IOSProjectOverrides {
+    /** Root directory of the iOS native project. Defaults to `ios/` under `projectRoot`. */
+    rootDir?: string;
+    /** Explicit path to the `.xcodeproj` directory to use for discovery. */
+    xcodeprojPath?: string;
+    /** Main application target name when the Xcode project has multiple app targets. */
+    mainTargetName?: string;
+    /** Explicit path to the app target Info.plist file. */
+    infoPlistPath?: string;
+    /** Explicit path to the main app entitlements file. */
+    entitlementsPath?: string;
+    /** Explicit path to the Podfile. */
+    podfilePath?: string;
+}
+/**
+ * Public CLI config for Android. This stays close to the current Expo plugin props,
+ * with explicit project discovery overrides added for native projects.
+ */
+export interface VoltraAndroidConfig {
+    /** Whether to add the Android notification permission and related setup. */
+    enableNotifications?: boolean;
+    /** Android widgets to generate and register. */
+    widgets?: AndroidWidgetConfig[];
+    /** Font files that should be bundled for Android widget rendering. */
+    fonts?: string[];
+    /** Directory containing user-provided images for Android widgets. */
+    userImagesPath?: string;
+    /** Native Android project discovery overrides. */
+    project?: AndroidProjectOverrides;
+}
+/**
+ * Public CLI config for iOS. This stays close to the current Expo plugin props,
+ * with explicit project discovery overrides added for native projects.
+ */
+export interface VoltraIOSConfig {
+    /** Whether to enable push-notification-related iOS setup for widgets and Live Activities. */
+    enablePushNotifications?: boolean;
+    /** App Group identifier used to share data between the app and widget extension. */
+    groupIdentifier?: string;
+    /** iOS widgets to generate and register. */
+    widgets?: IOSWidgetConfig[];
+    /** Minimum iOS deployment target for generated widget targets. */
+    deploymentTarget?: string;
+    /** Override for the generated widget extension target name. */
+    targetName?: string;
+    /** Font files that should be bundled for iOS widget rendering. */
+    fonts?: string[];
+    /** Directory containing user-provided images for iOS widgets. */
+    userImagesPath?: string;
+    /** Keychain access group shared by the app and extension. */
+    keychainGroup?: string;
+    /** Native iOS project discovery overrides. */
+    project?: IOSProjectOverrides;
+}
+export interface VoltraConfig {
+    /** Root directory used to resolve relative paths in the Voltra config. Defaults to the config file directory. */
+    projectRoot?: string;
+    /** Android-specific Voltra configuration. */
+    android?: VoltraAndroidConfig;
+    /** iOS-specific Voltra configuration. */
+    ios?: VoltraIOSConfig;
+}
+export interface LoadedVoltraConfig {
+    /** Parsed Voltra config object loaded from disk. */
+    config: VoltraConfig;
+    /** Absolute path to the loaded config file, when the config came from a file. */
+    configPath?: string;
+    /** Directory that contained the loaded config source. */
+    configDir: string;
+}
+export interface NormalizedAndroidWidgetServerUpdateConfig {
+    /** Server endpoint that returns widget state updates. */
+    url: string;
+    /** Refresh interval, in minutes, for fetching server updates. */
+    intervalMinutes: number;
+    /** Whether fetched updates should trigger an immediate widget refresh. */
+    refresh: boolean;
+}
+export interface NormalizedAndroidWidgetConfig extends Omit<AndroidWidgetConfig, 'serverUpdate'> {
+    /** Server-driven update settings after defaults have been applied. */
+    serverUpdate?: NormalizedAndroidWidgetServerUpdateConfig;
+}
+export interface NormalizedIOSWidgetServerUpdateConfig {
+    /** Server endpoint that returns widget state updates. */
+    url: string;
+    /** Refresh interval, in minutes, for fetching server updates. */
+    intervalMinutes: number;
+    /** Whether fetched updates should trigger an immediate widget refresh. */
+    refresh: boolean;
+}
+export interface NormalizedIOSWidgetConfig extends Omit<IOSWidgetConfig, 'serverUpdate' | 'supportedFamilies'> {
+    /** Supported iOS widget families after defaults have been applied. */
+    supportedFamilies: IOSWidgetFamily[];
+    /** Server-driven update settings after defaults have been applied. */
+    serverUpdate?: NormalizedIOSWidgetServerUpdateConfig;
+}
+export interface NormalizedAndroidProjectConfig {
+    /** Absolute Android project root directory, if overridden. */
+    rootDir?: string;
+    /** Resolved Android app module name. */
+    appModuleName?: string;
+    /** Absolute path to AndroidManifest.xml, if overridden. */
+    manifestPath?: string;
+    /** Explicit Android package name, if overridden. */
+    packageName?: string;
+}
+export interface NormalizedIOSProjectConfig {
+    /** Absolute iOS project root directory, if overridden. */
+    rootDir?: string;
+    /** Absolute path to the `.xcodeproj` directory, if overridden. */
+    xcodeprojPath?: string;
+    /** Explicit main iOS application target name, if overridden. */
+    mainTargetName?: string;
+    /** Absolute path to the Info.plist file, if overridden. */
+    infoPlistPath?: string;
+    /** Absolute path to the entitlements file, if overridden. */
+    entitlementsPath?: string;
+    /** Absolute path to the Podfile, if overridden. */
+    podfilePath?: string;
+}
+export interface NormalizedVoltraAndroidConfig {
+    /** Whether Android notification setup should be applied. */
+    enableNotifications: boolean;
+    /** Android widgets after validation and normalization. */
+    widgets: NormalizedAndroidWidgetConfig[];
+    /** Absolute font file paths for Android widgets. */
+    fonts: string[];
+    /** Absolute path to the Android user images directory. */
+    userImagesPath: string;
+    /** Normalized Android native project discovery overrides. */
+    project: NormalizedAndroidProjectConfig;
+}
+export interface NormalizedVoltraIOSConfig {
+    /** Whether iOS push-notification-related setup should be applied. */
+    enablePushNotifications: boolean;
+    /** App Group identifier used to share data between the app and extension. */
+    groupIdentifier?: string;
+    /** iOS widgets after validation and normalization. */
+    widgets: NormalizedIOSWidgetConfig[];
+    /** Effective iOS deployment target for generated widget targets. */
+    deploymentTarget: string;
+    /** Effective widget extension target name override, if provided. */
+    targetName?: string;
+    /** Absolute font file paths for iOS widgets. */
+    fonts: string[];
+    /** Absolute path to the iOS user images directory. */
+    userImagesPath: string;
+    /** Keychain access group shared by the app and extension. */
+    keychainGroup?: string;
+    /** Normalized iOS native project discovery overrides. */
+    project: NormalizedIOSProjectConfig;
+}
+export interface NormalizedVoltraConfig {
+    /** Absolute path to the loaded config file, when the config came from a file. */
+    configPath?: string;
+    /** Directory that contained the loaded config source. */
+    configDir: string;
+    /** Absolute root directory used for resolving all project-relative paths. */
+    projectRoot: string;
+    /** Normalized Android-specific Voltra configuration. */
+    android?: NormalizedVoltraAndroidConfig;
+    /** Normalized iOS-specific Voltra configuration. */
+    ios?: NormalizedVoltraIOSConfig;
+}
+export type CliDefaults = typeof CLI_DEFAULTS;
+//# sourceMappingURL=types.d.ts.map