/// <reference types="node"/>
|
import * as fs from 'fs';
|
|
export interface Options {
|
/**
|
* Directory [permissions](https://x-team.com/blog/file-system-permissions-umask-node-js/).
|
*
|
* @default 0o777 & (~process.umask())
|
*/
|
readonly mode?: number;
|
|
/**
|
* Use a custom `fs` implementation. For example [`graceful-fs`](https://github.com/isaacs/node-graceful-fs).
|
*
|
* Using a custom `fs` implementation will block the use of the native `recursive` option if `fs.mkdir` or `fs.mkdirSync` is not the native function.
|
*
|
* @default require('fs')
|
*/
|
readonly fs?: typeof fs;
|
}
|
|
/**
|
* Make a directory and its parents if needed - Think `mkdir -p`.
|
*
|
* @param path - Directory to create.
|
* @returns A `Promise` for the path to the created directory.
|
*/
|
export default function makeDir(
|
path: string,
|
options?: Options
|
): Promise<string>;
|
|
/**
|
* Synchronously make a directory and its parents if needed - Think `mkdir -p`.
|
*
|
* @param path - Directory to create.
|
* @returns The path to the created directory.
|
*/
|
export function sync(path: string, options?: Options): string;
|
