remove-glob 1.1.1 → 1.2.1

package/README.md

@@ -2,19 +2,27 @@
 [![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](http://www.typescriptlang.org/)
 [![Vitest](https://img.shields.io/badge/tested%20with-vitest-fcc72b.svg?logo=vitest)](https://vitest.dev/)
 [![codecov](https://codecov.io/gh/ghiscoding/remove-glob/branch/main/graph/badge.svg)](https://codecov.io/gh/ghiscoding/remove-glob)
-[![npm](https://img.shields.io/npm/v/remove-glob.svg)](https://www.npmjs.com/package/remove-glob)
-[![npm](https://img.shields.io/npm/dy/remove-glob)](https://www.npmjs.com/package/remove-glob)
-[![npm bundle size](https://img.shields.io/bundlephobia/minzip/remove-glob?color=success&label=gzip)](https://bundlephobia.com/result?p=remove-glob)
 <a href="https://nodejs.org/en/about/previous-releases"><img src="https://img.shields.io/node/v/remove-glob.svg" alt="Node" /></a>
 
-## remove-glob
+[![npm](https://img.shields.io/npm/dy/remove-glob)](https://www.npmjs.com/package/remove-glob)
+[![npm](https://img.shields.io/npm/v/remove-glob.svg)](https://www.npmjs.com/package/remove-glob)
+[![npm bundle size](https://img.shields.io/badge/API%20only%20(gzip)-1.05kB-1183c4)](https://bundlejs.com/?q=remove-glob)
+[![npm bundle size](https://img.shields.io/badge/API+CLI%20(gzip)-4.08kB-1183c4)](https://bundlejs.com/?q=remove-glob%2Cremove-glob%2Fdist%2Fcli.js)
+
+## Remove-Glob
 
 A tiny cross-platform utility to remove items or directories recursively, it also accepts an optional glob pattern. There's also a CLI for easy, cross-platform usage using [cli-nano](https://www.npmjs.com/package/cli-nano) which is the only external dependency.
 
 Inspired by [rimraf](https://www.npmjs.com/package/rimraf) and [premove](https://www.npmjs.com/package/premove) but also supports glob pattern to remove multiple files or directories.
 
-> [!NOTE]
-> This project now requires Node.JS >= 22.17.0 so that we can use the native `fs.glob`, however if you can't update your Node.JS just yet, then just stick with `remove-glob: ^0.4.10` since that is the only change in v1.0.0
+### Major Changes
+#### version 0.x
+- works with Node.JS 20.x by using `tinyglobby` for glob matching
+
+#### version 1.0
+- drop `tinyglobby` and use `fs.glob` native code (requires Node.JS >=22.17)
+
+--- 
 
 ### Install
 ```sh
@@ -29,29 +37,46 @@ A `remove` binary is available, it takes an optional path argument (zero or mult
 > The `paths` and `glob` arguments are both optionals, but you **must** provide at least 1 of them.
 > However, please note that providing both of them simultaneously is not supported and will throw an error (choose the option that is best suited to your use case).
 
-> [!NOTE]
-> When using the `--glob` option, dotfiles and dot-directories (e.g. `.env`, `.gitignore`, `.config/`) are included by default. If you want to exclude them, you can adjust your glob pattern (e.g. use `**/[!.]*.js` or add an `!**/.*` pattern).
+When using the `--glob` option, dotfiles and dot-directories (e.g. `.env`, `.gitignore`, `.config/`) are included by default. If you want to exclude them, you can adjust your glob pattern (e.g. use `**/[!.]*.js` or add an `!**/.*` pattern).
 
 ```
 Usage:
-  remove [paths..] [options]  Remove all items recursively
+  remove [paths..] [options] → Remove all items recursively
 
 Arguments:
-  paths           directory or file paths to remove                                         [string..]
+  paths           Directory or file paths to remove                                           [string..]
 
 Options:
-      --cwd       Directory to resolve from (default ".")                                   [string]
-  -d, --dryRun    Show which files/dirs would be deleted but without actually removing them [boolean]
-  -g, --glob      Glob pattern(s) to find which files/dirs to remove                        [array]
-  -s, --stat      Show the stats of the items being removed                                 [boolean]
-  -V, --verbose   If true, it will log each file or directory being removed                 [boolean]
-  -e, --exclude   Pattern or glob to exclude (may be passed multiple times)                 [string|string[]]
-  -h, --help      Show help                                                                 [boolean]
-  -v, --version   Show version number                                                       [boolean]
+      --cwd       Directory to resolve from (default ".")                                     [string]
+  -d, --dry-run   Show which files/dirs would be deleted but without actually removing them   [boolean]
+  -g, --glob      Glob pattern(s) to find which files/dirs to remove                          [array]
+  -a, --all       Include dotfiles (files starting with a dot) when matching glob patterns    [boolean]
+  -s, --stat      Show the stats of the items being removed                                   [boolean]
+  -V, --verbose   If true, it will log each file or directory being removed                   [boolean]
+  -e, --exclude   Glob pattern(s) to exclude from deletion (overrides the default patterns)   [array]
+  -h, --help      Show help                                                                   [boolean]
+  -v, --version   Show version number                                                         [boolean]
 ```
 
-> [!NOTE]
-> When `exclude` glob pattern(s) are provided, it will override the default exclude of: [`"**/.git/**", "**/.git", "**/node_modules/**", "**/node_modules"`]
+When `exclude` glob pattern(s) are provided, it will override the default exclude [`"**/.git/**", "**/.git", "**/node_modules/**", "**/node_modules"`].
+
+The `--all`/`-a` option includes dotfiles (files starting with a dot) in glob matches. By default, dotfiles are excluded unless explicitly matched or this option is used.
+
+#### Negation Patterns
+You can use negation patterns (starting with `!`) in glob arrays to exclude files from removal:
+
+```sh
+$ npx remove --glob "src/**/*.js" --glob "!src/**/*.test.js"
+# This will remove all .js files except those ending with .test.js
+```
+
+#### Brace Expansion
+Brace expansion is supported in glob patterns:
+
+```sh
+$ npx remove --glob "src/*.{js,ts}"
+# This will match both .js and .ts files in src/
+```
 
 Remove files or directories.  Note: on Windows globs must be **double quoted**, everybody else can quote however they please.
 
@@ -69,16 +94,15 @@ $ remove foo bar
 $ remove --glob \"dist/**/*.{js,map}\"
 ```
 
-> [!NOTE]
-> When using the `--glob` option, it will skip `.git/` and `node_modules/` directories by default (using the default `--exclude` patterns).
-> If you want to allow deletion of these directories, you can override the default by providing your own `--exclude` option (including an empty array to disable exclusion):
->
-> ```sh
-> # Remove everything, including .git and node_modules
-> $ npx remove --glob "**/*" --exclude ""
-> # Or exclude only .git, but allow node_modules to be deleted
-> $ npx remove --glob "**/*" --exclude "**/.git/**" --exclude "**/.git"
-> ```
+When using the `--glob` option, it will skip `.git/` and `node_modules/` directories by default (internally it just set that as the default `exclude`). If you want to allow deletion of these directories, you can override the default by providing your own `--exclude` option (including an empty array to disable exclusion), for example:
+
+```sh
+# Remove everything, including .git and node_modules
+$ npx remove --glob "**/*" --exclude ""
+
+# Or exclude only .git, but allow node_modules to be deleted
+$ npx remove --glob "**/*" --exclude "**/.git/**" --exclude "**/.git"
+```
 
 ### Usage
 
@@ -98,7 +122,7 @@ const dir = resolve('./foo/bar');
 await removeSync({ paths: ['hello.txt'], cwd: dir });
 ```
 
-### JavaScript API
+## JavaScript API
 
 ```js
 import { removeSync } from 'remove-glob';
@@ -110,19 +134,28 @@ The first argument is an object holding any of the options shown below. The last
 
 ```js
 {
-  cwd: string;              // directory to resolve your `filepath` from, defaults to `process.cwd()`
-  dryRun: boolean;          // show what would be copied, without actually copying anything
-  paths: string | string[]; // filepath(s) to remove – may be a file or a directory.
-  glob: string;             // glob pattern to find which files/directories to remove
-  exclude: string[];        // glob pattern(s) to exclude from deletion
-  stats: boolean;           // show some statistics after execution (time + file count)
-  verbose: boolean;         // print more information to console when executing the removal
+  cwd: string;                 // directory to resolve your `filepath` from, defaults to `process.cwd()`
+  dryRun: boolean;             // show what would be removed, without actually removing anything
+  paths: string | string[];    // filepath(s) to remove – may be a file or a directory.
+  glob: string | string[];     // glob pattern(s) to find which files/directories to remove
+  exclude: string | string[];  // glob pattern(s) to exclude from deletion
+  all: boolean;                // include dotfiles (files starting with a dot) in glob matches
+  stat: boolean;               // show some statistics after execution (time + file count)
+  verbose: boolean;            // print more information to console when executing the removal
 }
 ```
 
+
 > [!NOTE]
-> The first argument is required and it **must** include either a `paths` or a `glob`, but it cannot include both options simultaneously.
-> Also when `exclude` glob pattern(s) are provided, it will override the default exclude of: [`"**/.git/**", "**/.git", "**/node_modules/**", "**/node_modules"`]
+> The first argument is required and it **must** include either a `paths` or a `glob`, but it cannot include both options simultaneously. A
+
+When an `exclude` glob pattern is provided, it will override the default exclusion [`"**/.git/**", "**/.git", "**/node_modules/**", "**/node_modules"`].
+
+#### Advanced glob usage
+
+- **Negation**: Use `!pattern` in a glob array to exclude files from removal.
+- **Brace expansion**: Use `{a,b}` to match multiple alternatives in a single pattern.
+- **Dotfiles**: Use `--all`/`-a` to include dotfiles in glob matches.
 
 ### Used by
 

package/dist/cli.js

@@ -25,11 +25,11 @@ try {
             name: 'remove',
             describe: 'Remove all items recursively',
             examples: [
-                { cmd: '$0 foo bar', describe: '→ Remove "foo" and "bar" folders' },
-                { cmd: '$0 --glob="dist/**/*.js"', describe: '→ Remove all files from from "dist" folder with ".js" extension' },
+                { cmd: '$0 foo bar', describe: 'Remove "foo" and "bar" folders' },
+                { cmd: '$0 --glob="dist/**/*.js"', describe: 'Remove all files from from "dist" folder with ".js" extension' },
                 {
                     cmd: '$0 --glob="dist/**/*.js" --glob="packages/*/tsconfig.tsbuildinfo"',
-                    describe: '→ Remove all files from from "dist" folder with ".js" extension and "tsconfig.tsbuildinfo" file from every "packages" folders',
+                    describe: 'Remove all files from from "dist" folder with ".js" extension and "tsconfig.tsbuildinfo" file from every "packages" folders',
                 },
             ],
             positionals: [
@@ -58,6 +58,12 @@ try {
                 type: 'array',
                 describe: 'Glob pattern(s) to find which files/dirs to remove',
             },
+            all: {
+                alias: 'a',
+                type: 'boolean',
+                default: false,
+                describe: 'Include dotfiles (files starting with a dot) when matching glob patterns',
+            },
             stat: {
                 alias: 's',
                 default: false,

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAE,aAAkB,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,qBAgFlF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAE,aAAkB,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,qBAoElF"}

package/dist/index.js

@@ -1,6 +1,6 @@
-import { existsSync, globSync, rmSync, statSync, unlinkSync } from 'node:fs';
+import { existsSync, rmSync, statSync, unlinkSync } from 'node:fs';
 import { resolve } from 'node:path';
-import { throwOrCallback } from './utils.js';
+import { throwOrCallback, getMatchedFiles } from './utils.js';
 /**
  * Remove the files or directories, the item(s) can be provided via positional arguments or via a `--glob` pattern.
  * @param {RemoveOptions} options - CLI options
@@ -31,18 +31,7 @@ export function removeSync(opts = {}, callback) {
     // paths is always an array now
     const requiresCwdChange = !!(paths.length && opts.cwd);
     if (!paths.length && opts.glob) {
-        // Use fs.globSync to match files. Dotfiles and dot-directories are always included.
-        const defaultExclude = ['**/.git/**', '**/.git', '**/node_modules/**', '**/node_modules'];
-        const globOptions = { cwd: opts.cwd, withFileTypes: false };
-        globOptions.exclude = Array.isArray(opts.exclude) ? opts.exclude : defaultExclude;
-        const globResult = globSync(opts.glob, globOptions);
-        // We reassign 'paths' here to hold the final list of files matched by glob,
-        // after filtering for strings and resolving to absolute paths if needed.
-        paths =
-            Array.isArray(globResult) && globResult.length > 0 ? globResult.filter((v) => typeof v === 'string') : [];
-        if (opts.cwd) {
-            paths = paths.map(p => resolve(opts.cwd, p));
-        }
+        paths = getMatchedFiles(opts.glob, { cwd: opts.cwd, exclude: opts.exclude, all: opts.all });
     }
     if (opts.stat || opts.verbose) {
         console.time('Duration');
@@ -56,7 +45,7 @@ export function removeSync(opts = {}, callback) {
         }
         if (existsSync(path)) {
             const isDir = statSync(path).isDirectory();
-            const pathLog = `${isDir ? 'directory' : 'file'}: ${path}`;
+            const pathLog = `${isDir ? 'directory recursively' : 'file'}: ${path}`;
             if (opts.dryRun) {
                 console.log(`would remove ${pathLog}`);
             }

package/dist/interfaces.d.ts

@@ -26,5 +26,9 @@ export interface RemoveOptions {
      * To disable exclusion and allow deleting everything, pass an empty array ([]).
      */
     exclude?: string | string[];
+    /**
+     * If true, include dotfiles (files starting with a dot) when matching glob patterns.
+     */
+    all?: boolean;
 }
 //# sourceMappingURL=interfaces.d.ts.map

package/dist/interfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;IAE/B;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,2EAA2E;IAC3E,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAEzB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAE1B,0CAA0C;IAC1C,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf,wCAAwC;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC7B"}
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;IAE/B;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,2EAA2E;IAC3E,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAEzB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAE1B,0CAA0C;IAC1C,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf,wCAAwC;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAE5B;;OAEG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;CACf"}

package/dist/utils.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Helper to get all matched files from glob patterns, supporting dotfile logic via opts.all
+ */
+export declare function getMatchedFiles(glob: string | string[], opts: {
+    cwd?: string;
+    exclude?: string | string[];
+    all?: boolean;
+}): string[];
 /** Helper to throw or callback with error */
 export declare function throwOrCallback(err?: Error, cb?: (e?: Error) => void): void;
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,QAMpE"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,EAAE,CA0DrI;AAED,6CAA6C;AAC7C,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,QAMpE"}

package/dist/utils.js

@@ -1,3 +1,65 @@
+import { globSync } from 'node:fs';
+import { resolve } from 'node:path';
+/**
+ * Helper to get all matched files from glob patterns, supporting dotfile logic via opts.all
+ */
+export function getMatchedFiles(glob, opts) {
+    const defaultExclude = ['**/.git/**', '**/.git', '**/node_modules/**', '**/node_modules'];
+    const globOptions = { cwd: opts.cwd, withFileTypes: false, exclude: defaultExclude };
+    if (Array.isArray(opts.exclude)) {
+        globOptions.exclude = opts.exclude;
+    }
+    else if (typeof opts.exclude === 'string') {
+        globOptions.exclude = [opts.exclude];
+    }
+    // Separate positive and negated patterns
+    const patterns = Array.isArray(glob) ? glob : [glob];
+    const positivePatterns = [];
+    const negatedPatterns = [];
+    for (const pat of patterns) {
+        if (typeof pat === 'string' && pat.startsWith('!')) {
+            negatedPatterns.push(pat.slice(1));
+        }
+        else {
+            positivePatterns.push(pat);
+            // Dotfile logic for positive patterns
+            if (opts.all && typeof pat === 'string' && pat.includes('*') && !pat.startsWith('.')) {
+                const dotPattern = pat.replace(/(\*)/g, '.*');
+                if (dotPattern !== pat) {
+                    positivePatterns.push(dotPattern);
+                }
+            }
+        }
+    }
+    // Collect all files matching positive patterns
+    const matchedSet = new Set();
+    for (const pattern of positivePatterns) {
+        const globResult = globSync(pattern, globOptions);
+        if (Array.isArray(globResult) && globResult.length > 0) {
+            for (const v of globResult) {
+                if (typeof v === 'string') {
+                    matchedSet.add(v);
+                }
+            }
+        }
+    }
+    // Remove files matching any negated pattern
+    for (const pattern of negatedPatterns) {
+        const globResult = globSync(pattern, globOptions);
+        if (Array.isArray(globResult) && globResult.length > 0) {
+            for (const v of globResult) {
+                if (typeof v === 'string') {
+                    matchedSet.delete(v);
+                }
+            }
+        }
+    }
+    let paths = Array.from(matchedSet);
+    if (opts.cwd) {
+        paths = paths.map(p => resolve(opts.cwd, p));
+    }
+    return paths;
+}
 /** Helper to throw or callback with error */
 export function throwOrCallback(err, cb) {
     if (typeof cb === 'function') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "remove-glob",
-  "version": "1.1.1",
+  "version": "1.2.1",
   "description": "A tiny utility to remove items or directories recursively, also supports glob",
   "bin": {
     "remove": "dist/cli.js"
@@ -35,7 +35,7 @@
     "url": "https://github.com/ghiscoding/remove-glob/issues"
   },
   "dependencies": {
-    "cli-nano": "^1.2.2"
+    "cli-nano": "^1.4.0"
   },
   "engines": {
     "node": "^22.17.0 || >=24.0.0"

package/src/cli.ts

@@ -29,12 +29,12 @@ try {
       name: 'remove',
       describe: 'Remove all items recursively',
       examples: [
-        { cmd: '$0 foo bar', describe: '→ Remove "foo" and "bar" folders' },
-        { cmd: '$0 --glob="dist/**/*.js"', describe: '→ Remove all files from from "dist" folder with ".js" extension' },
+        { cmd: '$0 foo bar', describe: 'Remove "foo" and "bar" folders' },
+        { cmd: '$0 --glob="dist/**/*.js"', describe: 'Remove all files from from "dist" folder with ".js" extension' },
         {
           cmd: '$0 --glob="dist/**/*.js" --glob="packages/*/tsconfig.tsbuildinfo"',
           describe:
-            '→ Remove all files from from "dist" folder with ".js" extension and "tsconfig.tsbuildinfo" file from every "packages" folders',
+            'Remove all files from from "dist" folder with ".js" extension and "tsconfig.tsbuildinfo" file from every "packages" folders',
         },
       ],
       positionals: [
@@ -63,6 +63,12 @@ try {
         type: 'array',
         describe: 'Glob pattern(s) to find which files/dirs to remove',
       },
+      all: {
+        alias: 'a',
+        type: 'boolean',
+        default: false,
+        describe: 'Include dotfiles (files starting with a dot) when matching glob patterns',
+      },
       stat: {
         alias: 's',
         default: false,

package/src/index.ts

@@ -1,8 +1,7 @@
-import type { GlobOptions } from 'node:fs';
-import { existsSync, globSync, rmSync, statSync, unlinkSync } from 'node:fs';
+import { existsSync, rmSync, statSync, unlinkSync } from 'node:fs';
 import { resolve } from 'node:path';
 import type { RemoveOptions } from './interfaces.js';
-import { throwOrCallback } from './utils.js';
+import { throwOrCallback, getMatchedFiles } from './utils.js';
 
 /**
  * Remove the files or directories, the item(s) can be provided via positional arguments or via a `--glob` pattern.
@@ -35,19 +34,7 @@ export function removeSync(opts: RemoveOptions = {}, callback?: (e?: Error) => v
   // paths is always an array now
   const requiresCwdChange = !!(paths.length && opts.cwd);
   if (!paths.length && opts.glob) {
-    // Use fs.globSync to match files. Dotfiles and dot-directories are always included.
-    const defaultExclude = ['**/.git/**', '**/.git', '**/node_modules/**', '**/node_modules'];
-    const globOptions: GlobOptions = { cwd: opts.cwd, withFileTypes: false };
-    globOptions.exclude = Array.isArray(opts.exclude) ? opts.exclude : defaultExclude;
-
-    const globResult = globSync(opts.glob, globOptions);
-    // We reassign 'paths' here to hold the final list of files matched by glob,
-    // after filtering for strings and resolving to absolute paths if needed.
-    paths =
-      Array.isArray(globResult) && globResult.length > 0 ? (globResult as unknown[]).filter((v): v is string => typeof v === 'string') : [];
-    if (opts.cwd) {
-      paths = paths.map(p => resolve(opts.cwd as string, p));
-    }
+    paths = getMatchedFiles(opts.glob, { cwd: opts.cwd, exclude: opts.exclude, all: opts.all });
   }
 
   if (opts.stat || opts.verbose) {
@@ -64,7 +51,7 @@ export function removeSync(opts: RemoveOptions = {}, callback?: (e?: Error) => v
 
     if (existsSync(path)) {
       const isDir = statSync(path).isDirectory();
-      const pathLog = `${isDir ? 'directory' : 'file'}: ${path}`;
+      const pathLog = `${isDir ? 'directory recursively' : 'file'}: ${path}`;
 
       if (opts.dryRun) {
         console.log(`would remove ${pathLog}`);

package/src/interfaces.ts

@@ -33,4 +33,9 @@ export interface RemoveOptions {
    * To disable exclusion and allow deleting everything, pass an empty array ([]).
    */
   exclude?: string | string[];
+
+  /**
+   * If true, include dotfiles (files starting with a dot) when matching glob patterns.
+   */
+  all?: boolean;
 }

package/src/utils.ts

@@ -1,3 +1,70 @@
+import type { GlobOptions } from 'node:fs';
+import { globSync } from 'node:fs';
+import { resolve } from 'node:path';
+
+/**
+ * Helper to get all matched files from glob patterns, supporting dotfile logic via opts.all
+ */
+export function getMatchedFiles(glob: string | string[], opts: { cwd?: string; exclude?: string | string[]; all?: boolean }): string[] {
+  const defaultExclude = ['**/.git/**', '**/.git', '**/node_modules/**', '**/node_modules'];
+  const globOptions: GlobOptions = { cwd: opts.cwd, withFileTypes: false, exclude: defaultExclude };
+  if (Array.isArray(opts.exclude)) {
+    globOptions.exclude = opts.exclude;
+  } else if (typeof opts.exclude === 'string') {
+    globOptions.exclude = [opts.exclude];
+  }
+
+  // Separate positive and negated patterns
+  const patterns = Array.isArray(glob) ? glob : [glob];
+  const positivePatterns: string[] = [];
+  const negatedPatterns: string[] = [];
+  for (const pat of patterns) {
+    if (typeof pat === 'string' && pat.startsWith('!')) {
+      negatedPatterns.push(pat.slice(1));
+    } else {
+      positivePatterns.push(pat);
+      // Dotfile logic for positive patterns
+      if (opts.all && typeof pat === 'string' && pat.includes('*') && !pat.startsWith('.')) {
+        const dotPattern = pat.replace(/(\*)/g, '.*');
+        if (dotPattern !== pat) {
+          positivePatterns.push(dotPattern);
+        }
+      }
+    }
+  }
+
+  // Collect all files matching positive patterns
+  const matchedSet = new Set<string>();
+  for (const pattern of positivePatterns) {
+    const globResult = globSync(pattern, globOptions);
+    if (Array.isArray(globResult) && globResult.length > 0) {
+      for (const v of globResult) {
+        if (typeof v === 'string') {
+          matchedSet.add(v);
+        }
+      }
+    }
+  }
+
+  // Remove files matching any negated pattern
+  for (const pattern of negatedPatterns) {
+    const globResult = globSync(pattern, globOptions);
+    if (Array.isArray(globResult) && globResult.length > 0) {
+      for (const v of globResult) {
+        if (typeof v === 'string') {
+          matchedSet.delete(v);
+        }
+      }
+    }
+  }
+
+  let paths = Array.from(matchedSet);
+  if (opts.cwd) {
+    paths = paths.map(p => resolve(opts.cwd as string, p));
+  }
+  return paths;
+}
+
 /** Helper to throw or callback with error */
 export function throwOrCallback(err?: Error, cb?: (e?: Error) => void) {
   if (typeof cb === 'function') {