import type { ICruiseResult } from "./cruise-result.mjs";
import type { ICruiseOptions, IFormatOptions } from "./options.mjs";
import type { IResolveOptions } from "./resolve-options.mjs";

export type * from "./rule-set.mjs";
export type * from "./options.mjs";
export type * from "./configuration.mjs";
export type * from "./shared-types.mjs";
export type * from "./cruise-result.mjs";
export type * from "./resolve-options.mjs";

/**
 * all supported extensions; for each extension whether or not
 * it is supported in the current environment
 */
export const allExtensions: IAvailableExtension[];

export interface IAvailableExtension {
	/**
	 * File extension (e.g. ".js", ".ts", ".jsx")
	 */
	extension: string;
	/**
	 * Whether or not the extension is available as supported in the current environment
	 */
	available: boolean;
}

export interface IAvailableTranspiler {
	/**
	 * The name of the transpiler (e.g. "typescript", "coffeescript")
	 */
	name: string;
	/**
	 * A semver version range (e.g. ">=2.0.0 <3.0.0")
	 */
	version: string;
	/**
	 * Whether or not the transpiler is available in the current environment
	 */
	available: boolean;
}

export interface IReporterOutput {
	/**
	 * The output proper of the reporter. For most reporters this will be
	 * a string.
	 */
	output: ICruiseResult | string;
	/**
	 * The exit code - reporters can return a non-zero value when they find
	 * errors here. api consumers (like a cli) can use this to return a
	 * non-zero exit code, so the build breaks when something is wrong
	 *
	 * This is e.g. the default behavior of the `err` and `err-long` reporters.
	 */
	exitCode: number;
}

export interface ITranspileOptions {
	/**
	 * An object with with a typescript config object. Note that the
	 * API will not take any 'extends' keys there into account, so
	 * before calling make sure to flatten them out if you want them
	 * used (e.g. with 'dependency-cruiser/config-utl/extract-ts-config')
	 */
	tsConfig?: any;
	/**
	 * An object with with a babel config object. Either pass the options
	 * manually or extract them from a configuration file with e.g. with
	 * 'dependency-cruiser/config-utl/extract-babel-config')
	 */
	babelConfig?: any;
}

/**
 * Cruises the specified files and files with supported extensions in
 * the specified directories in the pFileDirArray and returns the result
 * in an object.
 *
 * @param pFileAndDirectoryArray An array of (names of) files, directories and/ or glob patterns
 *                        to start the cruise with
 * @param pCruiseOptions  Options that influence the way the dependencies are cruised - and
 *                        how they are returned.
 * @param pResolveOptions Options that influence how dependency references are resolved to disk.
 *                        See https://webpack.js.org/configuration/resolve/ for the details.
 * @param pTranspileOptions Object to hold options to pass to underlying transpilers
 *                        like TypeScript or Babel
 */
export function cruise(
	pFileAndDirectoryArray: string[],
	pCruiseOptions?: ICruiseOptions,
	pResolveOptions?: Partial<IResolveOptions>,
	pTranspileOptions?: ITranspileOptions,
): Promise<IReporterOutput>;

/**
 * Given a cruise result, formats it with the given reporter (pOutputType)
 *
 * @param pResult     A javascript object that contains the result of a cruise. Must adhere
 *                    to the [dependency-cruiser results schema](https://github.com/sverweij/dependency-cruiser/blob/main/src/schema/cruise-result.json)
 * @param pOutputType Which reporter to use to format the cruise result with
 */
export function format(
	pResult: ICruiseResult,
	pFormatOptions: IFormatOptions,
): Promise<IReporterOutput>;

/**
 * Returns an array of supported transpilers and for each of the transpilers
 * - the name of the transpiler
 * - the supported version range (semver version range)
 * - whether or not the transpiler is available in the current environment
 */
export function getAvailableTranspilers(): IAvailableTranspiler[];