.editorconfig

@@ -7,9 +7,6 @@ charset = utf-8
 trim_trailing_whitespace = true
 insert_final_newline = true
 
-[{package.json,*.yml}]
+[*.yml]
 indent_style = space
 indent_size = 2
-
-[*.md]
-trim_trailing_whitespace = false

.gitattributes

@@ -1 +1 @@
-* text=auto
+* text=auto eol=lf

.github/security.md

@@ -0,0 +1,3 @@
+# Security Policy
+
+To report a security vulnerability, please use the [Tidelift security contact](https://tidelift.com/security). Tidelift will coordinate the fix and disclosure.

.github/workflows/main.yml

@@ -0,0 +1,26 @@
+name: CI
+on:
+  - push
+  - pull_request
+jobs:
+  test:
+    name: Node.js ${{ matrix.node-version }} on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        node-version:
+          - 22
+          - 20
+          - 18
+        os:
+          - ubuntu-latest
+          - macos-latest
+          - windows-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+      - run: npm install
+      - run: npm test

.gitignore

@@ -1 +1,2 @@
 node_modules
+yarn.lock

.npmrc

@@ -0,0 +1 @@
+package-lock=false

benchmark.js

@@ -0,0 +1,81 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import process from 'node:process';
+import Benchmark from 'benchmark';
+import {temporaryDirectory} from 'tempy';
+import {deleteAsync, deleteSync} from './index.js';
+
+const suite = new Benchmark.Suite('concurrency');
+
+const temporaryDirectoryPath = temporaryDirectory();
+
+const fixtures = Array.from({length: 2000}, (_, index) => path.resolve(temporaryDirectoryPath, (index + 1).toString()));
+
+function createFixtures() {
+	for (const fixture of fixtures) {
+		fs.mkdirSync(path.resolve(temporaryDirectoryPath, fixture), {recursive: true});
+	}
+}
+
+const concurrencies = [
+	1,
+	3,
+	5,
+	10,
+	15,
+	20,
+	50,
+	100,
+	200,
+	300,
+	400,
+	500,
+	1000,
+	Number.POSITIVE_INFINITY,
+];
+
+for (const concurrency of concurrencies) {
+	const name = `concurrency: ${concurrency.toString()}`;
+
+	suite.add({
+		name,
+		defer: true,
+		async fn(deferred) {
+			// Can't use `setup()` because it isn't called after every
+			// defer and it breaks using `async` keyword here.
+			// https://github.com/bestiejs/benchmark.js/issues/136
+			createFixtures();
+
+			const removedFiles = await deleteAsync(['**/*'], {
+				cwd: temporaryDirectoryPath,
+				concurrency,
+			});
+
+			if (removedFiles.length !== fixtures.length) {
+				const error = new Error(
+					`"${name}": files removed: ${removedFiles.length}, expected: ${fixtures.length}`,
+				);
+
+				console.error(error);
+
+				deleteSync(temporaryDirectoryPath, {cwd: temporaryDirectoryPath, force: true});
+
+				// eslint-disable-next-line unicorn/no-process-exit
+				process.exit(1);
+			}
+
+			deferred.resolve();
+		},
+	});
+}
+
+suite
+	.on('cycle', event => {
+		console.log(String(event.target));
+	})
+	.on('complete', function () {
+		console.log(`Fastest is ${this.filter('fastest').map('name')}`);
+
+		deleteSync(temporaryDirectoryPath, {cwd: temporaryDirectoryPath, force: true});
+	})
+	.run({async: true});

index.d.ts

@@ -0,0 +1,113 @@
+import {type Options as GlobbyOptions} from 'globby';
+
+export type ProgressData = {
+	/**
+	Deleted files and directories count.
+	*/
+	readonly deletedCount: number;
+
+	/**
+	Total files and directories count.
+	*/
+	readonly totalCount: number;
+
+	/**
+	Completed percentage. A value between `0` and `1`.
+	*/
+	readonly percent: number;
+
+	/**
+	The absolute path of the deleted file or directory.
+
+ 	It will not be present if nothing was deleted.
+	*/
+	readonly path?: string;
+};
+
+export type Options = {
+	/**
+	Allow deleting the current working directory and outside.
+
+	@default false
+	*/
+	readonly force?: boolean;
+
+	/**
+	See what would be deleted.
+
+	@default false
+
+	@example
+	```
+	import {deleteAsync} from 'del';
+
+	const deletedPaths = await deleteAsync(['temp/*.js'], {dryRun: true});
+
+	console.log('Files and directories that would be deleted:\n', deletedPaths.join('\n'));
+	```
+	*/
+	readonly dryRun?: boolean;
+
+	/**
+	Concurrency limit. Minimum: `1`.
+
+	@default Infinity
+	*/
+	readonly concurrency?: number;
+
+	/**
+	Called after each file or directory is deleted.
+
+	@example
+	```
+	import {deleteAsync} from 'del';
+
+	await deleteAsync(patterns, {
+		onProgress: progress => {
+		// …
+	}});
+	```
+	*/
+	readonly onProgress?: (progress: ProgressData) => void;
+} & GlobbyOptions;
+
+/**
+Delete files and directories using glob patterns.
+
+Note that glob patterns can only contain forward-slashes, not backward-slashes. Windows file paths can use backward-slashes as long as the path does not contain any glob-like characters, otherwise use `path.posix.join()` instead of `path.join()`.
+
+@param patterns - See the supported [glob patterns](https://github.com/sindresorhus/globby#globbing-patterns).
+- [Pattern examples with expected matches](https://github.com/sindresorhus/multimatch/blob/main/test/test.js)
+- [Quick globbing pattern overview](https://github.com/sindresorhus/multimatch#globbing-patterns)
+@param options - You can specify any of the [`globby` options](https://github.com/sindresorhus/globby#options) in addition to the `del` options. In contrast to the `globby` defaults, `expandDirectories`, `onlyFiles`, and `followSymbolicLinks` are `false` by default.
+@returns The deleted paths.
+
+@example
+```
+import {deleteAsync} from 'del';
+
+const deletedPaths = await deleteAsync(['temp/*.js', '!temp/unicorn.js']);
+
+console.log('Deleted files and directories:\n', deletedPaths.join('\n'));
+```
+*/
+export function deleteAsync(
+	patterns: string | readonly string[],
+	options?: Options
+): Promise<string[]>;
+
+/**
+Synchronously delete files and directories using glob patterns.
+
+Note that glob patterns can only contain forward-slashes, not backward-slashes. Windows file paths can use backward-slashes as long as the path does not contain any glob-like characters, otherwise use `path.posix.join()` instead of `path.join()`.
+
+@param patterns - See the supported [glob patterns](https://github.com/sindresorhus/globby#globbing-patterns).
+- [Pattern examples with expected matches](https://github.com/sindresorhus/multimatch/blob/main/test/test.js)
+- [Quick globbing pattern overview](https://github.com/sindresorhus/multimatch#globbing-patterns)
+@param options - You can specify any of the [`globby` options](https://github.com/sindresorhus/globby#options) in addition to the `del` options. In contrast to the `globby` defaults, `expandDirectories`, `onlyFiles`, and `followSymbolicLinks` are `false` by default.
+@returns The deleted paths.
+*/
+export function deleteSync(
+	patterns: string | readonly string[],
+	options?: Options
+): string[];