import type { Logger } from '@b64hub/sfpm-core';
import type { ScriptDefinition, ScriptExecutionContext, ScriptExecutor, ScriptResult } from '../types.js';
/**
 * Executes npm scripts via `npm run <script-name>`.
 *
 * Validates the script exists in the package's `package.json` before
 * running. Uses the package directory as CWD (not the project root).
 */
export declare class NpmScriptExecutor implements ScriptExecutor {
    execute(script: ScriptDefinition, context: ScriptExecutionContext, logger?: Logger): Promise<ScriptResult>;
    private hasNpmScript;
}
/**
 * Thrown when an npm script is not found in the package's `package.json`.
 *
 * Used to distinguish "missing script" (skip gracefully) from runtime
 * errors (fail the pipeline).
 */
export declare class ScriptNotFoundError extends Error {
    constructor(message: string);
}