@voltkit/volt-test 0.1.2

package/dist/artifacts.d.ts

@@ -0,0 +1,18 @@
+import { sanitizePathSegment } from './path.js';
+import type { VoltTestLogger } from './types.js';
+export interface ScreenshotCommand {
+    command: string;
+    args: string[];
+}
+export declare function createRunArtifactRoot(repoRoot: string, artifactDir?: string): string;
+export declare function createSuiteAttemptArtifactDir(runArtifactRoot: string, suiteName: string, attemptNumber: number): string;
+export declare function writeJsonArtifact(filePath: string, payload: unknown): void;
+export declare function writeTextArtifact(filePath: string, contents: string): void;
+export declare function captureDesktopScreenshot(screenshotPath: string, logger: VoltTestLogger, platform?: NodeJS.Platform): Promise<boolean>;
+export declare function buildScreenshotCommand(platform: string, screenshotPath: string): ScreenshotCommand | null;
+declare function timestampForPath(date: Date): string;
+export declare const __testOnly: {
+    sanitizePathSegment: typeof sanitizePathSegment;
+    timestampForPath: typeof timestampForPath;
+};
+export {};

package/dist/artifacts.js

@@ -0,0 +1,109 @@
+import { execFile } from 'node:child_process';
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { promisify } from 'node:util';
+import { sanitizePathSegment } from './path.js';
+const execFileAsync = promisify(execFile);
+export function createRunArtifactRoot(repoRoot, artifactDir) {
+    const root = artifactDir
+        ? resolve(repoRoot, artifactDir)
+        : resolve(repoRoot, 'artifacts', 'volt-test', timestampForPath(new Date()));
+    mkdirSync(root, { recursive: true });
+    return root;
+}
+export function createSuiteAttemptArtifactDir(runArtifactRoot, suiteName, attemptNumber) {
+    const suiteSegment = sanitizePathSegment(suiteName);
+    const attemptSegment = `attempt-${attemptNumber}`;
+    const suiteDir = join(runArtifactRoot, suiteSegment, attemptSegment);
+    mkdirSync(suiteDir, { recursive: true });
+    return suiteDir;
+}
+export function writeJsonArtifact(filePath, payload) {
+    const serialized = `${JSON.stringify(payload, null, 2)}\n`;
+    writeTextArtifact(filePath, serialized);
+}
+export function writeTextArtifact(filePath, contents) {
+    mkdirSync(dirname(filePath), { recursive: true });
+    writeFileSync(filePath, contents, 'utf8');
+}
+export async function captureDesktopScreenshot(screenshotPath, logger, platform = process.platform) {
+    const screenshotCommand = buildScreenshotCommand(platform, screenshotPath);
+    if (!screenshotCommand) {
+        logger.warn(`[volt:test] screenshot capture is not supported on ${platform}.`);
+        return false;
+    }
+    try {
+        await execFileAsync(screenshotCommand.command, screenshotCommand.args, {
+            timeout: 15_000,
+            windowsHide: true,
+        });
+        logger.log(`[volt:test] screenshot captured: ${screenshotPath}`);
+        return true;
+    }
+    catch (error) {
+        logger.warn(`[volt:test] failed to capture screenshot at ${screenshotPath}: ${error instanceof Error ? error.message : String(error)}`);
+        return false;
+    }
+}
+export function buildScreenshotCommand(platform, screenshotPath) {
+    if (platform === 'darwin') {
+        return {
+            command: 'screencapture',
+            args: ['-x', screenshotPath],
+        };
+    }
+    if (platform === 'win32') {
+        // Embed the path directly in the script instead of relying on $args,
+        // because PowerShell -Command mode parses trailing arguments as
+        // expressions rather than passing them as $args.
+        const escapedPath = screenshotPath.replace(/'/g, "''");
+        const captureScript = [
+            'Add-Type -AssemblyName System.Windows.Forms',
+            'Add-Type -AssemblyName System.Drawing',
+            '$bounds = [System.Windows.Forms.SystemInformation]::VirtualScreen',
+            '$bitmap = New-Object System.Drawing.Bitmap $bounds.Width, $bounds.Height',
+            '$graphics = [System.Drawing.Graphics]::FromImage($bitmap)',
+            '$graphics.CopyFromScreen($bounds.Location, [System.Drawing.Point]::Empty, $bounds.Size)',
+            `$bitmap.Save('${escapedPath}', [System.Drawing.Imaging.ImageFormat]::Png)`,
+            '$graphics.Dispose()',
+            '$bitmap.Dispose()',
+        ].join('; ');
+        return {
+            command: 'powershell',
+            args: [
+                '-NoProfile',
+                '-NonInteractive',
+                '-ExecutionPolicy',
+                'Bypass',
+                '-Command',
+                captureScript,
+            ],
+        };
+    }
+    if (platform === 'linux') {
+        const script = [
+            'if command -v import >/dev/null 2>&1; then',
+            '  import -window root "$1"',
+            'elif command -v gnome-screenshot >/dev/null 2>&1; then',
+            '  gnome-screenshot -f "$1"',
+            'else',
+            '  exit 127',
+            'fi',
+        ].join('; ');
+        return {
+            command: 'sh',
+            args: ['-lc', script, 'volt-test-screenshot', screenshotPath],
+        };
+    }
+    return null;
+}
+function timestampForPath(date) {
+    return date.toISOString()
+        .replace(/[:]/g, '-')
+        .replace(/\..+$/, 'Z');
+}
+export const __testOnly = {
+    sanitizePathSegment,
+    timestampForPath,
+};
+//# sourceMappingURL=artifacts.js.map

package/dist/artifacts.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,16 @@
+import type { LoadedVoltTestConfig, LoadVoltTestConfigOptions, VoltTestConfig } from './types.js';
+export declare function defineTestConfig(config: VoltTestConfig): VoltTestConfig;
+export declare function validateTestConfig(config: VoltTestConfig, sourceLabel?: string): VoltTestConfig;
+export declare function loadVoltTestConfig(projectRoot: string, options?: LoadVoltTestConfigOptions): Promise<LoadedVoltTestConfig>;
+declare function resolveConfigCandidates(projectRoot: string, options: LoadVoltTestConfigOptions): string[];
+declare function normalizeConfigModule(moduleValue: unknown, sourceLabel: string): VoltTestConfig;
+declare function validateTimeoutMs(timeoutMs: number, sourceLabel: string): void;
+declare function validateRetryCount(retries: number, sourceLabel: string): void;
+export declare const __testOnly: {
+    DEFAULT_TEST_CONFIG_FILES: readonly ["volt.test.config.ts", "volt.test.config.mjs", "volt.test.config.js"];
+    normalizeConfigModule: typeof normalizeConfigModule;
+    resolveConfigCandidates: typeof resolveConfigCandidates;
+    validateRetryCount: typeof validateRetryCount;
+    validateTimeoutMs: typeof validateTimeoutMs;
+};
+export {};

package/dist/config.js

@@ -0,0 +1,154 @@
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+const DEFAULT_TEST_CONFIG_FILES = [
+    'volt.test.config.ts',
+    'volt.test.config.mjs',
+    'volt.test.config.js',
+];
+export function defineTestConfig(config) {
+    return config;
+}
+export function validateTestConfig(config, sourceLabel = 'config') {
+    if (!config || typeof config !== 'object') {
+        throw new Error(`[volt:test] Invalid ${sourceLabel}: expected object.`);
+    }
+    if (!Array.isArray(config.suites) || config.suites.length === 0) {
+        throw new Error(`[volt:test] Invalid ${sourceLabel}: expected at least one test suite.`);
+    }
+    const names = new Set();
+    for (const suite of config.suites) {
+        validateSuite(suite, sourceLabel);
+        if (names.has(suite.name)) {
+            throw new Error(`[volt:test] Duplicate suite name "${suite.name}" in ${sourceLabel}.`);
+        }
+        names.add(suite.name);
+    }
+    if (config.timeoutMs !== undefined) {
+        validateTimeoutMs(config.timeoutMs, `${sourceLabel}.timeoutMs`);
+    }
+    if (config.retries !== undefined) {
+        validateRetryCount(config.retries, `${sourceLabel}.retries`);
+    }
+    if (config.artifactDir !== undefined) {
+        if (typeof config.artifactDir !== 'string' || config.artifactDir.trim().length === 0) {
+            throw new Error(`[volt:test] Invalid ${sourceLabel}.artifactDir: expected non-empty string.`);
+        }
+    }
+    return config;
+}
+export async function loadVoltTestConfig(projectRoot, options = {}) {
+    const candidates = resolveConfigCandidates(projectRoot, options);
+    for (const candidate of candidates) {
+        if (!existsSync(candidate)) {
+            continue;
+        }
+        const config = await loadConfigModule(candidate);
+        return {
+            configPath: candidate,
+            config: validateTestConfig(config, candidate),
+        };
+    }
+    if (options.strict ?? true) {
+        const formattedCandidates = candidates
+            .map((candidate) => candidate.replace(`${projectRoot}\\`, '').replace(`${projectRoot}/`, ''))
+            .join(', ');
+        throw new Error(`[volt:test] No test config found. Expected one of: ${formattedCandidates}.`);
+    }
+    return {
+        configPath: '',
+        config: {
+            suites: [],
+        },
+    };
+}
+function resolveConfigCandidates(projectRoot, options) {
+    if (options.configPath) {
+        return [resolve(projectRoot, options.configPath)];
+    }
+    return DEFAULT_TEST_CONFIG_FILES.map((filename) => resolve(projectRoot, filename));
+}
+async function loadConfigModule(configPath) {
+    if (configPath.endsWith('.ts')) {
+        const viaJiti = await loadWithJiti(configPath);
+        if (viaJiti) {
+            return viaJiti;
+        }
+    }
+    return loadWithDynamicImport(configPath);
+}
+async function loadWithJiti(configPath) {
+    const jitiModuleName = 'jiti';
+    let jitiModule;
+    try {
+        jitiModule = await import(jitiModuleName);
+    }
+    catch (error) {
+        if (isMissingOptionalJitiDependency(error)) {
+            return null;
+        }
+        throw new Error(`[volt:test] Failed to initialize jiti for ${configPath}: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+    }
+    const createJiti = jitiModule.createJiti;
+    if (!createJiti) {
+        return null;
+    }
+    const jiti = createJiti(configPath);
+    const loaded = await jiti.import(configPath);
+    return normalizeConfigModule(loaded, configPath);
+}
+function isMissingOptionalJitiDependency(error) {
+    if (!(error instanceof Error)) {
+        return false;
+    }
+    const message = error.message.toLowerCase();
+    return message.includes("cannot find module 'jiti'")
+        || message.includes('cannot find module "jiti"')
+        || message.includes("cannot find package 'jiti'");
+}
+async function loadWithDynamicImport(configPath) {
+    const fileUrl = pathToFileURL(configPath).href;
+    const loaded = await import(fileUrl).catch((error) => {
+        throw new Error(`[volt:test] Failed to load config at ${configPath}: ${error instanceof Error ? error.message : String(error)}`);
+    });
+    return normalizeConfigModule(loaded, configPath);
+}
+function normalizeConfigModule(moduleValue, sourceLabel) {
+    const candidate = moduleValue?.default ?? moduleValue;
+    if (!candidate || typeof candidate !== 'object') {
+        throw new Error(`[volt:test] Invalid config export in ${sourceLabel}.`);
+    }
+    return candidate;
+}
+function validateSuite(suite, sourceLabel) {
+    if (!suite || typeof suite !== 'object') {
+        throw new Error(`[volt:test] Invalid suite in ${sourceLabel}: expected object.`);
+    }
+    if (typeof suite.name !== 'string' || suite.name.trim().length === 0) {
+        throw new Error(`[volt:test] Invalid suite in ${sourceLabel}: name must be a non-empty string.`);
+    }
+    if (typeof suite.run !== 'function') {
+        throw new Error(`[volt:test] Invalid suite "${suite.name}" in ${sourceLabel}: missing run function.`);
+    }
+    if (suite.timeoutMs !== undefined) {
+        validateTimeoutMs(suite.timeoutMs, `suite "${suite.name}".timeoutMs`);
+    }
+}
+function validateTimeoutMs(timeoutMs, sourceLabel) {
+    if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+        throw new Error(`[volt:test] Invalid ${sourceLabel}: expected positive milliseconds.`);
+    }
+}
+function validateRetryCount(retries, sourceLabel) {
+    if (!Number.isInteger(retries) || retries < 0) {
+        throw new Error(`[volt:test] Invalid ${sourceLabel}: expected non-negative integer.`);
+    }
+}
+export const __testOnly = {
+    DEFAULT_TEST_CONFIG_FILES,
+    normalizeConfigModule,
+    resolveConfigCandidates,
+    validateRetryCount,
+    validateTimeoutMs,
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/drivers/file-dialog.d.ts

@@ -0,0 +1,22 @@
+export type FileDialogAutomationPlatform = 'win32' | 'darwin' | 'linux';
+export interface OpenDialogAutomationResult {
+    canceled: boolean;
+    filePaths: string[];
+}
+export interface SaveDialogAutomationResult {
+    canceled: boolean;
+    filePath: string;
+}
+export interface FileDialogAutomationDriverOptions {
+    platform?: FileDialogAutomationPlatform;
+}
+export declare class FileDialogAutomationDriver {
+    private readonly platform;
+    constructor(options?: FileDialogAutomationDriverOptions);
+    getPlatform(): FileDialogAutomationPlatform;
+    parseOpenDialogResult(payload: unknown): OpenDialogAutomationResult;
+    parseSaveDialogResult(payload: unknown): SaveDialogAutomationResult;
+    normalizePath(pathValue: string): string;
+    assertOpenSelection(result: OpenDialogAutomationResult, expectedAbsolutePaths: readonly string[]): void;
+    assertSaveSelection(result: SaveDialogAutomationResult, expectedAbsolutePath: string): void;
+}

package/dist/drivers/file-dialog.js

@@ -0,0 +1,119 @@
+import { isAbsolute, posix, win32 } from 'node:path';
+export class FileDialogAutomationDriver {
+    platform;
+    constructor(options = {}) {
+        this.platform = resolveAutomationPlatform(options.platform ?? process.platform);
+    }
+    getPlatform() {
+        return this.platform;
+    }
+    parseOpenDialogResult(payload) {
+        const value = asRecord(payload);
+        if (!value) {
+            throw new Error('[volt:test] invalid open dialog payload: expected object.');
+        }
+        const canceled = value.canceled;
+        if (typeof canceled !== 'boolean') {
+            throw new Error('[volt:test] invalid open dialog payload: missing canceled boolean.');
+        }
+        const rawFilePaths = value.filePaths;
+        if (!Array.isArray(rawFilePaths) || rawFilePaths.some((entry) => typeof entry !== 'string')) {
+            throw new Error('[volt:test] invalid open dialog payload: filePaths must be a string array.');
+        }
+        const filePaths = rawFilePaths.map((entry) => this.normalizePath(entry));
+        if (canceled && filePaths.length > 0) {
+            throw new Error('[volt:test] invalid open dialog payload: canceled dialog must not return file paths.');
+        }
+        if (!canceled && filePaths.some((entry) => entry.length === 0)) {
+            throw new Error('[volt:test] invalid open dialog payload: selected file paths must be non-empty.');
+        }
+        return { canceled, filePaths };
+    }
+    parseSaveDialogResult(payload) {
+        const value = asRecord(payload);
+        if (!value) {
+            throw new Error('[volt:test] invalid save dialog payload: expected object.');
+        }
+        const canceled = value.canceled;
+        if (typeof canceled !== 'boolean') {
+            throw new Error('[volt:test] invalid save dialog payload: missing canceled boolean.');
+        }
+        const rawFilePath = value.filePath;
+        if (typeof rawFilePath !== 'string') {
+            throw new Error('[volt:test] invalid save dialog payload: missing filePath string.');
+        }
+        const filePath = this.normalizePath(rawFilePath);
+        if (!canceled && filePath.length === 0) {
+            throw new Error('[volt:test] invalid save dialog payload: filePath must be non-empty when canceled=false.');
+        }
+        if (canceled && filePath.length > 0) {
+            throw new Error('[volt:test] invalid save dialog payload: canceled dialog must not return filePath.');
+        }
+        return { canceled, filePath };
+    }
+    normalizePath(pathValue) {
+        const trimmed = pathValue.trim();
+        if (trimmed.length === 0) {
+            return '';
+        }
+        if (this.platform === 'win32') {
+            const withWinSeparators = trimmed.replace(/\//g, '\\');
+            const normalized = win32.normalize(withWinSeparators);
+            if (isWindowsDrivePath(normalized)) {
+                return `${normalized.slice(0, 1).toUpperCase()}${normalized.slice(1)}`;
+            }
+            return normalized;
+        }
+        const withPosixSeparators = trimmed.replace(/\\/g, '/');
+        return posix.normalize(withPosixSeparators);
+    }
+    assertOpenSelection(result, expectedAbsolutePaths) {
+        if (result.canceled) {
+            throw new Error('[volt:test] expected file selection but dialog was canceled.');
+        }
+        const normalizedExpected = expectedAbsolutePaths.map((entry) => this.normalizePath(entry));
+        const normalizedActual = result.filePaths.map((entry) => this.normalizePath(entry));
+        if (normalizedExpected.length !== normalizedActual.length) {
+            throw new Error(`[volt:test] expected ${normalizedExpected.length} selected files, got ${normalizedActual.length}.`);
+        }
+        for (let index = 0; index < normalizedExpected.length; index += 1) {
+            const expectedPath = normalizedExpected[index];
+            const actualPath = normalizedActual[index];
+            if (actualPath !== expectedPath) {
+                throw new Error(`[volt:test] selected file mismatch at index ${index}: expected "${expectedPath}", got "${actualPath}".`);
+            }
+            if (!isAbsolute(actualPath)) {
+                throw new Error(`[volt:test] expected absolute file path but got "${actualPath}".`);
+            }
+        }
+    }
+    assertSaveSelection(result, expectedAbsolutePath) {
+        if (result.canceled) {
+            throw new Error('[volt:test] expected save path but dialog was canceled.');
+        }
+        const normalizedExpected = this.normalizePath(expectedAbsolutePath);
+        const normalizedActual = this.normalizePath(result.filePath);
+        if (normalizedActual !== normalizedExpected) {
+            throw new Error(`[volt:test] save file mismatch: expected "${normalizedExpected}", got "${normalizedActual}".`);
+        }
+        if (!isAbsolute(normalizedActual)) {
+            throw new Error(`[volt:test] expected absolute save path but got "${normalizedActual}".`);
+        }
+    }
+}
+function resolveAutomationPlatform(platformValue) {
+    if (platformValue === 'win32' || platformValue === 'darwin' || platformValue === 'linux') {
+        return platformValue;
+    }
+    throw new Error(`[volt:test] unsupported file-dialog automation platform: ${platformValue}`);
+}
+function asRecord(value) {
+    if (!value || typeof value !== 'object') {
+        return null;
+    }
+    return value;
+}
+function isWindowsDrivePath(value) {
+    return /^[a-zA-Z]:\\/.test(value);
+}
+//# sourceMappingURL=file-dialog.js.map

package/dist/drivers/file-dialog.js.map

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

package/dist/drivers/index.d.ts

@@ -0,0 +1,6 @@
+export type { AutomationEvent, MenuSetupState, MenuAutomationDriverOptions } from './menu.js';
+export { MenuAutomationDriver } from './menu.js';
+export type { TraySetupState, TrayAutomationDriverOptions } from './tray.js';
+export { TrayAutomationDriver } from './tray.js';
+export type { FileDialogAutomationPlatform, FileDialogAutomationDriverOptions, OpenDialogAutomationResult, SaveDialogAutomationResult, } from './file-dialog.js';
+export { FileDialogAutomationDriver } from './file-dialog.js';

package/dist/drivers/index.js

@@ -0,0 +1,4 @@
+export { MenuAutomationDriver } from './menu.js';
+export { TrayAutomationDriver } from './tray.js';
+export { FileDialogAutomationDriver } from './file-dialog.js';
+//# sourceMappingURL=index.js.map

package/dist/drivers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/drivers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAEjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAOjD,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/drivers/menu.d.ts

@@ -0,0 +1,17 @@
+export interface AutomationEvent {
+    event: string;
+    payload: unknown;
+}
+export interface MenuSetupState {
+    shortcut: string;
+    shortcutRegistered: boolean;
+}
+export interface MenuAutomationDriverOptions {
+    clickEventName?: string;
+}
+export declare class MenuAutomationDriver {
+    private readonly clickEventName;
+    constructor(options?: MenuAutomationDriverOptions);
+    parseSetupPayload(payload: unknown): MenuSetupState;
+    countClickEvents(events: readonly AutomationEvent[]): number;
+}

package/dist/drivers/menu.js

@@ -0,0 +1,34 @@
+export class MenuAutomationDriver {
+    clickEventName;
+    constructor(options = {}) {
+        this.clickEventName = options.clickEventName ?? 'demo:menu-click';
+    }
+    parseSetupPayload(payload) {
+        const value = asRecord(payload);
+        if (!value) {
+            throw new Error('[volt:test] invalid menu setup payload: expected object.');
+        }
+        const shortcut = value.shortcut;
+        if (typeof shortcut !== 'string' || shortcut.trim().length === 0) {
+            throw new Error('[volt:test] invalid menu setup payload: missing shortcut string.');
+        }
+        const shortcutRegistered = value.shortcutRegistered;
+        if (typeof shortcutRegistered !== 'boolean') {
+            throw new Error('[volt:test] invalid menu setup payload: missing shortcutRegistered boolean.');
+        }
+        return {
+            shortcut,
+            shortcutRegistered,
+        };
+    }
+    countClickEvents(events) {
+        return events.filter((entry) => entry.event === this.clickEventName).length;
+    }
+}
+function asRecord(value) {
+    if (!value || typeof value !== 'object') {
+        return null;
+    }
+    return value;
+}
+//# sourceMappingURL=menu.js.map

package/dist/drivers/menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.js","sourceRoot":"","sources":["../../src/drivers/menu.ts"],"names":[],"mappings":"AAcA,MAAM,OAAO,oBAAoB;IACd,cAAc,CAAS;IAExC,YAAmB,UAAuC,EAAE;QAC1D,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,iBAAiB,CAAC;IACpE,CAAC;IAEM,iBAAiB,CAAC,OAAgB;QACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAC9E,CAAC;QAED,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAChC,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjE,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;QACtF,CAAC;QAED,MAAM,kBAAkB,GAAG,KAAK,CAAC,kBAAkB,CAAC;QACpD,IAAI,OAAO,kBAAkB,KAAK,SAAS,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;QACjG,CAAC;QAED,OAAO;YACL,QAAQ;YACR,kBAAkB;SACnB,CAAC;IACJ,CAAC;IAEM,gBAAgB,CAAC,MAAkC;QACxD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC;IAC9E,CAAC;CACF;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAgC,CAAC;AAC1C,CAAC"}

package/dist/drivers/tray.d.ts

@@ -0,0 +1,13 @@
+import type { AutomationEvent } from './menu.js';
+export interface TraySetupState {
+    trayReady: boolean;
+}
+export interface TrayAutomationDriverOptions {
+    clickEventName?: string;
+}
+export declare class TrayAutomationDriver {
+    private readonly clickEventName;
+    constructor(options?: TrayAutomationDriverOptions);
+    parseSetupPayload(payload: unknown): TraySetupState;
+    countClickEvents(events: readonly AutomationEvent[]): number;
+}

package/dist/drivers/tray.js

@@ -0,0 +1,27 @@
+export class TrayAutomationDriver {
+    clickEventName;
+    constructor(options = {}) {
+        this.clickEventName = options.clickEventName ?? 'demo:tray-click';
+    }
+    parseSetupPayload(payload) {
+        const value = asRecord(payload);
+        if (!value) {
+            throw new Error('[volt:test] invalid tray setup payload: expected object.');
+        }
+        const trayReady = value.trayReady;
+        if (typeof trayReady !== 'boolean') {
+            throw new Error('[volt:test] invalid tray setup payload: missing trayReady boolean.');
+        }
+        return { trayReady };
+    }
+    countClickEvents(events) {
+        return events.filter((entry) => entry.event === this.clickEventName).length;
+    }
+}
+function asRecord(value) {
+    if (!value || typeof value !== 'object') {
+        return null;
+    }
+    return value;
+}
+//# sourceMappingURL=tray.js.map

package/dist/drivers/tray.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tray.js","sourceRoot":"","sources":["../../src/drivers/tray.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,oBAAoB;IACd,cAAc,CAAS;IAExC,YAAmB,UAAuC,EAAE;QAC1D,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,iBAAiB,CAAC;IACpE,CAAC;IAEM,iBAAiB,CAAC,OAAgB;QACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAC9E,CAAC;QAED,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QAClC,IAAI,OAAO,SAAS,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;QACxF,CAAC;QAED,OAAO,EAAE,SAAS,EAAE,CAAC;IACvB,CAAC;IAEM,gBAAgB,CAAC,MAAkC;QACxD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC;IAC9E,CAAC;CACF;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAgC,CAAC;AAC1C,CAAC"}

package/dist/fs.d.ts

@@ -0,0 +1,9 @@
+import type { VoltTestLogger } from './types.js';
+export interface CopiedProjectPaths {
+    tempRoot: string;
+    tempProjectDir: string;
+}
+export declare function copyProjectToTemp(projectDir: string, repoRoot: string): CopiedProjectPaths;
+export declare function cleanupDirectoryBestEffort(directoryPath: string, logger: VoltTestLogger): Promise<void>;
+export declare function readTextFile(filePath: string): string;
+export declare function writeTextFile(filePath: string, contents: string): void;