lint-staged 12.4.3 → 13.0.1

package/README.md

@@ -2,6 +2,10 @@
 
 Run linters against staged git files and don't let :poop: slip into your code base!
 
+```bash
+npm install --save-dev lint-staged # requires further setup
+```
+
 ```
 $ git commit
 
@@ -44,13 +48,17 @@ This project contains a script that will run arbitrary shell tasks with a list o
 
 ## Installation and setup
 
-The fastest way to start using lint-staged is to run the following command in your terminal:
-
-```bash
-npx mrm@2 lint-staged
-```
+To install _lint-staged_ in the recommended way, you need to:
 
-This command will install and configure [husky](https://github.com/typicode/husky) and lint-staged depending on the code quality tools from your project's `package.json` dependencies, so please make sure you install (`npm install --save-dev`) and configure all code quality tools like [Prettier](https://prettier.io) and [ESLint](https://eslint.org) prior to that.
+1. Install _lint-staged_ itself:
+   - `npm install --save-dev lint-staged`
+1. Set up the `pre-commit` git hook to run _lint-staged_
+   - [Husky](https://github.com/typicode/husky) is a popular choice for configuring git hooks
+   - Read more about git hooks [here](https://git-scm.com/book/en/v2/Customizing-Git-Git-Hooks)
+1. Install some linters, like [ESLint](https://eslint.org) or [Prettier](https://prettier.io)
+1. Configure _lint-staged_ to run linters and other tasks:
+   - for example: `{ "*.js": "eslint" }` to run ESLint for all staged JS files
+   - See [Configuration](#Configuration) for more info
 
 Don't forget to commit changes to `package.json` and `.husky` to share this setup with your team!
 
@@ -64,6 +72,10 @@ See [Releases](https://github.com/okonet/lint-staged/releases).
 
 ### Migration
 
+#### v13
+
+- Since `v13.0.0` _lint-staged_ no longer supports Node.js 12. Please upgrade your Node.js version to at least `14.13.1`, or `16.0.0` onward.
+
 #### v12
 
 - Since `v12.0.0` _lint-staged_ is a pure ESM module, so make sure your Node.js version is at least `12.20.0`, `14.13.1`, or `16.0.0`. Read more about ESM modules from the official [Node.js Documentation site here](https://nodejs.org/api/esm.html#introduction).
@@ -92,6 +104,10 @@ Options:
   -c, --config [path]                path to configuration file, or - to read from stdin
   --cwd [path]                       run all tasks in specific directory, instead of the current
   -d, --debug                        print additional debug information (default: false)
+  --diff [string]                    override the default "--staged" flag of "git diff" to get list of files. Implies
+                                     "--no-stash".
+  --diff-filter [string]             override the default "--diff-filter=ACMR" flag of "git diff" to get list of files
+  --max-arg-length [number]          maximum length of the command-line argument string (default: 0)
   --no-stash                         disable the backup stash, and do not revert in case of errors
   -q, --quiet                        disable lint-staged’s own console output (default: false)
   -r, --relative                     pass relative filepaths to tasks (default: false)
@@ -102,7 +118,7 @@ Options:
 ```
 
 - **`--allow-empty`**: By default, when linter tasks undo all staged changes, lint-staged will exit with an error and abort the commit. Use this flag to allow creating empty git commits.
-- **`--concurrent [number|boolean]`**: Controls the concurrency of tasks being run by lint-staged. **NOTE**: This does NOT affect the concurrency of subtasks (they will always be run sequentially). Possible values are:
+- **`--concurrent [number|boolean]`**: Controls the [concurrency of tasks](#task-concurrency) being run by lint-staged. **NOTE**: This does NOT affect the concurrency of subtasks (they will always be run sequentially). Possible values are:
   - `false`: Run all tasks serially
   - `true` (default) : _Infinite_ concurrency. Runs as many tasks in parallel as possible.
   - `{number}`: Run the specified number of tasks in parallel, where `1` is equivalent to `false`.
@@ -111,6 +127,9 @@ Options:
 - **`--debug`**: Run in debug mode. When set, it does the following:
   - uses [debug](https://github.com/visionmedia/debug) internally to log additional information about staged files, commands being executed, location of binaries, etc. Debug logs, which are automatically enabled by passing the flag, can also be enabled by setting the environment variable `$DEBUG` to `lint-staged*`.
   - uses [`verbose` renderer](https://github.com/SamVerschueren/listr-verbose-renderer) for `listr`; this causes serial, uncoloured output to the terminal, instead of the default (beautified, dynamic) output.
+- **`--diff`**: By default linters are filtered against all files staged in git, generated from `git diff --staged`. This option allows you to override the `--staged` flag with arbitrary revisions. For example to get a list of changed files between two branches, use `--diff="branch1...branch2"`. You can also read more from about [git diff](https://git-scm.com/docs/git-diff) and [gitrevisions](https://git-scm.com/docs/gitrevisions).
+- **`--diff-filter`**: By default only files that are _added_, _copied_, _modified_, or _renamed_ are included. Use this flag to override the default `ACMR` value with something else: _added_ (`A`), _copied_ (`C`), _deleted_ (`D`), _modified_ (`M`), _renamed_ (`R`), _type changed_ (`T`), _unmerged_ (`U`), _unknown_ (`X`), or _pairing broken_ (`B`). See also the `git diff` docs for [--diff-filter](https://git-scm.com/docs/git-diff#Documentation/git-diff.txt---diff-filterACDMRTUXB82308203).
+- **`--max-arg-length`**: long commands (a lot of files) are automatically split into multiple chunks when it detects the current shell cannot handle them. Use this flag to override the maximum length of the generated command string.
 - **`--no-stash`**: By default a backup stash will be created before running the tasks, and all task modifications will be reverted in case of an error. This option will disable creating the stash, and instead leave all modifications in the index when aborting the commit.
 - **`--quiet`**: Supress all CLI output, except from tasks.
 - **`--relative`**: Pass filepaths relative to `process.cwd()` (where `lint-staged` runs) to tasks. Default is `false`.
@@ -119,7 +138,7 @@ Options:
 
 ## Configuration
 
-Starting with v3.1 you can now use different ways of configuring lint-staged:
+_Lint-staged_ can be configured in many ways:
 
 - `lint-staged` object in your `package.json`
 - `.lintstagedrc` file in JSON or YML format, or you can be explicit with the file extension:
@@ -162,6 +181,37 @@ So, considering you did `git add file1.ext file2.ext`, lint-staged will run the
 
 `your-cmd file1.ext file2.ext`
 
+### Task concurrency
+
+By default _lint-staged_ will run configured tasks concurrently. This means that for every glob, all the commands will be started at the same time. With the following config, both `eslint` and `prettier` will run at the same time:
+
+```json
+{
+  "*.ts": "eslint",
+  "*.md": "prettier --list-different"
+}
+```
+
+This is typically not a problem since the globs do not overlap, and the commands do not make changes to the files, but only report possible errors (aborting the git commit). If you want to run multiple commands for the same set of files, you can use the array syntax to make sure commands are run in order. In the following example, `prettier` will run for both globs, and in addition `eslint` will run for `*.ts` files _after_ it. Both sets of commands (for each glob) are still started at the same time (but do not overlap).
+
+```json
+{
+  "*.ts": ["prettier --list-different", "eslint"],
+  "*.md": "prettier --list-different"
+}
+```
+
+Pay extra attention when the configured globs overlap, and tasks make edits to files. For example, in this configuration `prettier` and `eslint` might try to make changes to the same `*.ts` file at the same time, causing a _race condition_:
+
+```json
+{
+  "*": "prettier --write",
+  "*.ts": "eslint --fix"
+}
+```
+
+If necessary, you can limit the concurrency using `--concurrent <number>` or disable it entirely with `--concurrent false`.
+
 ## Filtering files
 
 Linter commands work on a subset of all staged files, defined by a _glob pattern_. lint-staged uses [micromatch](https://github.com/micromatch/micromatch) for matching files with the following rules:
@@ -596,7 +646,7 @@ const success = await lintStaged({
   relative: false,
   shell: false,
   stash: true,
-  verbose: false
+  verbose: false,
 })
 ```
 
@@ -713,6 +763,30 @@ Example repo: [sudo-suhas/lint-staged-django-react-demo](https://github.com/sudo
 
 </details>
 
+### Can I run `lint-staged` in CI, or when there are no staged files?
+
+<details>
+  <summary>Click to expand</summary>
+
+Lint-staged will by default run against files staged in git, and should be run during the git pre-commit hook, for example. It's also possible to override this default behaviour and run against files in a specific diff, for example
+all changed files between two different branches. If you want to run _lint-staged_ in the CI, maybe you can set it up to compare the branch in a _Pull Request_/_Merge Request_ to the target branch.
+
+Try out the `git diff` command until you are satisfied with the result, for example:
+
+```
+git diff --diff-filter=ACMR --name-only master...my-branch
+```
+
+This will print a list of _added_, _changed_, _modified_, and _renamed_ files between `master` and `my-branch`.
+
+You can then run lint-staged against the same files with:
+
+```
+npx lint-staged --diff="master...my-branch"
+```
+
+</details>
+
 ### Can I use `lint-staged` with `ng lint`
 
 <details>

package/bin/lint-staged.js

@@ -1,19 +1,19 @@
 #!/usr/bin/env node
 
-import fs from 'fs'
-import path from 'path'
-import { fileURLToPath } from 'url'
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
 
+import { isColorSupported } from 'colorette'
 import { Option, program } from 'commander'
 import debug from 'debug'
-import supportsColor from 'supports-color'
 
 import lintStaged from '../lib/index.js'
 import { CONFIG_STDIN_ERROR } from '../lib/messages.js'
 
 // Force colors for packages that depend on https://www.npmjs.com/package/supports-color
-if (supportsColor.stdout) {
-  process.env.FORCE_COLOR = supportsColor.stdout.level.toString()
+if (isColorSupported) {
+  process.env.FORCE_COLOR = '1'
 }
 
 // Do not terminate main Listr process on SIGINT
@@ -42,6 +42,16 @@ cli.option('--cwd [path]', 'run all tasks in specific directory, instead of the
 
 cli.option('-d, --debug', 'print additional debug information', false)
 
+cli.option(
+  '--diff [string]',
+  'override the default "--staged" flag of "git diff" to get list of files. Implies "--no-stash".'
+)
+
+cli.option(
+  '--diff-filter [string]',
+  'override the default "--diff-filter=ACMR" flag of "git diff" to get list of files'
+)
+
 cli.option('--max-arg-length [number]', 'maximum length of the command-line argument string', 0)
 
 /**
@@ -86,6 +96,8 @@ const options = {
   configPath: cliOptions.config,
   cwd: cliOptions.cwd,
   debug: !!cliOptions.debug,
+  diff: cliOptions.diff,
+  diffFilter: cliOptions.diffFilter,
   maxArgLength: cliOptions.maxArgLength || undefined,
   quiet: !!cliOptions.quiet,
   relative: !!cliOptions.relative,

package/lib/chunkFiles.js

@@ -1,4 +1,4 @@
-import path from 'path'
+import path from 'node:path'
 
 import debug from 'debug'
 import normalize from 'normalize-path'

package/lib/dynamicImport.js

@@ -1,3 +1,3 @@
-import { pathToFileURL } from 'url'
+import { pathToFileURL } from 'node:url'
 
 export const dynamicImport = (path) => import(pathToFileURL(path)).then((module) => module.default)

package/lib/execGit.js

@@ -1,5 +1,5 @@
 import debug from 'debug'
-import execa from 'execa'
+import { execa } from 'execa'
 
 const debugLog = debug('lint-staged:execGit')
 

package/lib/file.js

@@ -1,4 +1,4 @@
-import { promises as fs } from 'fs'
+import fs from 'node:fs/promises'
 
 import debug from 'debug'
 

package/lib/generateTasks.js

@@ -1,4 +1,4 @@
-import path from 'path'
+import path from 'node:path'
 
 import debug from 'debug'
 import micromatch from 'micromatch'

package/lib/getStagedFiles.js

@@ -1,18 +1,29 @@
-import path from 'path'
+import path from 'node:path'
 
 import normalize from 'normalize-path'
 
 import { execGit } from './execGit.js'
 import { parseGitZOutput } from './parseGitZOutput.js'
 
-export const getStagedFiles = async ({ cwd = process.cwd() } = {}) => {
+export const getStagedFiles = async ({ cwd = process.cwd(), diff, diffFilter } = {}) => {
   try {
-    // Docs for --diff-filter option: https://git-scm.com/docs/git-diff#Documentation/git-diff.txt---diff-filterACDMRTUXB82308203
-    // Docs for -z option: https://git-scm.com/docs/git-diff#Documentation/git-diff.txt--z
-    const lines = await execGit(['diff', '--staged', '--diff-filter=ACMR', '--name-only', '-z'], {
-      cwd,
-    })
+    /**
+     *  Docs for --diff-filter option:
+     * @see https://git-scm.com/docs/git-diff#Documentation/git-diff.txt---diff-filterACDMRTUXB82308203
+     */
+    const diffFilterArg = diffFilter !== undefined ? diffFilter.trim() : 'ACMR'
 
+    /** Use `--diff branch1...branch2` or `--diff="branch1 branch2", or fall back to default staged files */
+    const diffArgs = diff !== undefined ? diff.trim().split(' ') : ['--staged']
+
+    /**
+     * Docs for -z option:
+     * @see https://git-scm.com/docs/git-diff#Documentation/git-diff.txt--z
+     */
+    const lines = await execGit(
+      ['diff', '--name-only', '-z', `--diff-filter=${diffFilterArg}`, ...diffArgs],
+      { cwd }
+    )
     if (!lines) return []
 
     return parseGitZOutput(lines).map((file) => normalize(path.resolve(cwd, file)))

package/lib/gitWorkflow.js

@@ -1,4 +1,4 @@
-import path from 'path'
+import path from 'node:path'
 
 import debug from 'debug'
 

package/lib/groupFilesByConfig.js

@@ -1,23 +1,19 @@
-import path from 'path'
+import path from 'node:path'
 
 import debug from 'debug'
 
-import { ConfigObjectSymbol } from './searchConfigs.js'
-
 const debugLog = debug('lint-staged:groupFilesByConfig')
 
-export const groupFilesByConfig = async ({ configs, files }) => {
+export const groupFilesByConfig = async ({ configs, files, singleConfigMode }) => {
   debugLog('Grouping %d files by %d configurations', files.length, Object.keys(configs).length)
 
   const filesSet = new Set(files)
   const filesByConfig = {}
 
   /** Configs are sorted deepest first by `searchConfigs` */
-  for (const filepath of Reflect.ownKeys(configs)) {
-    const config = configs[filepath]
-
-    /** When passed an explicit config object via the Node.js API, skip logic */
-    if (filepath === ConfigObjectSymbol) {
+  for (const [filepath, config] of Object.entries(configs)) {
+    /** When passed an explicit config object via the Node.js API‚ or an explicit path, skip logic */
+    if (singleConfigMode) {
       filesByConfig[filepath] = { config, files }
       break
     }

package/lib/index.js

@@ -49,6 +49,8 @@ const getMaxArgLength = () => {
  * @param {string} [options.configPath] - Path to configuration file
  * @param {Object} [options.cwd] - Current working directory
  * @param {boolean} [options.debug] - Enable debug mode
+ * @param {string} [options.diff] - Override the default "--staged" flag of "git diff" to get list of files
+ * @param {string} [options.diffFilter] - Override the default "--diff-filter=ACMR" flag of "git diff" to get list of files
  * @param {number} [options.maxArgLength] - Maximum argument string length
  * @param {boolean} [options.quiet] - Disable lint-staged’s own console output
  * @param {boolean} [options.relative] - Pass relative filepaths to tasks
@@ -67,6 +69,8 @@ const lintStaged = async (
     configPath,
     cwd,
     debug = false,
+    diff,
+    diffFilter,
     maxArgLength = getMaxArgLength() / 2,
     quiet = false,
     relative = false,
@@ -82,29 +86,30 @@ const lintStaged = async (
   debugLog('Unset GIT_LITERAL_PATHSPECS (was `%s`)', process.env.GIT_LITERAL_PATHSPECS)
   delete process.env.GIT_LITERAL_PATHSPECS
 
+  const options = {
+    allowEmpty,
+    concurrent,
+    configObject,
+    configPath,
+    cwd,
+    debug,
+    diff,
+    diffFilter,
+    maxArgLength,
+    quiet,
+    relative,
+    shell,
+    stash,
+    verbose,
+  }
+
   try {
-    const ctx = await runAll(
-      {
-        allowEmpty,
-        concurrent,
-        configObject,
-        configPath,
-        cwd,
-        debug,
-        maxArgLength,
-        quiet,
-        relative,
-        shell,
-        stash,
-        verbose,
-      },
-      logger
-    )
+    const ctx = await runAll(options, logger)
     debugLog('Tasks were executed successfully!')
     printTaskOutput(ctx, logger)
     return true
   } catch (runAllError) {
-    if (runAllError && runAllError.ctx && runAllError.ctx.errors) {
+    if (runAllError?.ctx?.errors) {
       const { ctx } = runAllError
 
       if (ctx.errors.has(ConfigNotFoundError)) {

package/lib/messages.js

@@ -28,8 +28,14 @@ export const NO_STAGED_FILES = `${info} No staged files found.`
 
 export const NO_TASKS = `${info} No staged files match any configured task.`
 
-export const skippingBackup = (hasInitialCommit) => {
-  const reason = hasInitialCommit ? '`--no-stash` was used' : 'there’s no initial commit yet'
+export const skippingBackup = (hasInitialCommit, diff) => {
+  const reason =
+    diff !== undefined
+      ? '`--diff` was used'
+      : hasInitialCommit
+      ? '`--no-stash` was used'
+      : 'there’s no initial commit yet'
+
   return yellow(`${warning} Skipping backup because ${reason}.\n`)
 }
 

package/lib/printTaskOutput.js

@@ -5,7 +5,7 @@
  */
 export const printTaskOutput = (ctx = {}, logger) => {
   if (!Array.isArray(ctx.output)) return
-  const log = ctx.errors && ctx.errors.size > 0 ? logger.error : logger.log
+  const log = ctx.errors?.size > 0 ? logger.error : logger.log
   for (const line of ctx.output) {
     log(line)
   }

package/lib/resolveConfig.js

@@ -1,4 +1,4 @@
-import { createRequire } from 'module'
+import { createRequire } from 'node:module'
 
 /**
  * require() does not exist for ESM, so we must create it to use require.resolve().

package/lib/resolveGitRepo.js

@@ -1,5 +1,5 @@
-import { promises as fs } from 'fs'
-import path from 'path'
+import fs from 'node:fs/promises'
+import path from 'node:path'
 
 import debug from 'debug'
 import normalize from 'normalize-path'

package/lib/resolveTaskFn.js

@@ -1,5 +1,5 @@
 import { redBright, dim } from 'colorette'
-import execa from 'execa'
+import { execa, execaCommand } from 'execa'
 import debug from 'debug'
 import { parseArgsStringToArgv } from 'string-argv'
 import pidTree from 'pidtree'
@@ -8,7 +8,7 @@ import { error, info } from './figures.js'
 import { getInitialState } from './state.js'
 import { TaskError } from './symbols.js'
 
-const ERROR_CHECK_INTERVAL = 200
+const TASK_ERROR = 'lint-staged:taskError'
 
 const debugLog = debug('lint-staged:resolveTaskFn')
 
@@ -46,37 +46,52 @@ const handleOutput = (command, result, ctx, isError = false) => {
   }
 }
 
+/**
+ * Kill an execa process along with all its child processes.
+ * @param {execa.ExecaChildProcess<string>} execaProcess
+ */
+const killExecaProcess = async (execaProcess) => {
+  try {
+    const childPids = await pidTree(execaProcess.pid)
+    for (const childPid of childPids) {
+      try {
+        process.kill(childPid)
+      } catch (error) {
+        debugLog(`Failed to kill process with pid "%d": %o`, childPid, error)
+      }
+    }
+  } catch (error) {
+    // Suppress "No matching pid found" error. This probably means
+    // the process already died before executing.
+    debugLog(`Failed to kill process with pid "%d": %o`, execaProcess.pid, error)
+  }
+
+  // The execa process is killed separately in order to get the `KILLED` status.
+  execaProcess.kill()
+}
+
 /**
  * Interrupts the execution of the execa process that we spawned if
  * another task adds an error to the context.
  *
  * @param {Object} ctx
  * @param {execa.ExecaChildProcess<string>} execaChildProcess
- * @returns {function(): void} Function that clears the interval that
+ * @returns {() => Promise<void>} Function that clears the interval that
  * checks the context.
  */
 const interruptExecutionOnError = (ctx, execaChildProcess) => {
-  let loopIntervalId
-
-  async function loop() {
-    if (ctx.errors.size > 0) {
-      clearInterval(loopIntervalId)
-
-      const childPids = await pidTree(execaChildProcess.pid)
-      for (const pid of childPids) {
-        process.kill(pid)
-      }
+  let killPromise
 
-      // The execa process is killed separately in order
-      // to get the `KILLED` status.
-      execaChildProcess.kill()
-    }
+  const errorListener = async () => {
+    killPromise = killExecaProcess(execaChildProcess)
+    await killPromise
   }
 
-  loopIntervalId = setInterval(loop, ERROR_CHECK_INTERVAL)
+  ctx.events.on(TASK_ERROR, errorListener, { once: true })
 
-  return () => {
-    clearInterval(loopIntervalId)
+  return async () => {
+    ctx.events.off(TASK_ERROR, errorListener)
+    await killPromise
   }
 }
 
@@ -95,6 +110,10 @@ const interruptExecutionOnError = (ctx, execaChildProcess) => {
  */
 const makeErr = (command, result, ctx) => {
   ctx.errors.add(TaskError)
+
+  // https://nodejs.org/api/events.html#error-events
+  ctx.events.emit(TASK_ERROR, TaskError)
+
   handleOutput(command, result, ctx, true)
   const tag = getTag(result)
   return new Error(`${redBright(command)} ${dim(`[${tag}]`)}`)
@@ -111,7 +130,7 @@ const makeErr = (command, result, ctx) => {
  * @param {Array<string>} options.files — Filepaths to run the linter task against
  * @param {Boolean} [options.shell] — Whether to skip parsing linter task for better shell support
  * @param {Boolean} [options.verbose] — Always show task verbose
- * @returns {function(): Promise<Array<string>>}
+ * @returns {() => Promise<Array<string>>}
  */
 export const resolveTaskFn = ({
   command,
@@ -139,12 +158,12 @@ export const resolveTaskFn = ({
 
   return async (ctx = getInitialState()) => {
     const execaChildProcess = shell
-      ? execa.command(isFn ? command : `${command} ${files.join(' ')}`, execaOptions)
+      ? execaCommand(isFn ? command : `${command} ${files.join(' ')}`, execaOptions)
       : execa(cmd, isFn ? args : args.concat(files), execaOptions)
 
     const quitInterruptCheck = interruptExecutionOnError(ctx, execaChildProcess)
     const result = await execaChildProcess
-    quitInterruptCheck()
+    await quitInterruptCheck()
 
     if (result.failed || result.killed || result.signal != null) {
       throw makeErr(command, result, ctx)

package/lib/runAll.js

@@ -1,6 +1,6 @@
 /** @typedef {import('./index').Logger} Logger */
 
-import path from 'path'
+import path from 'node:path'
 
 import { dim } from 'colorette'
 import debug from 'debug'
@@ -36,7 +36,7 @@ import {
   restoreUnstagedChangesSkipped,
 } from './state.js'
 import { GitRepoError, GetStagedFilesError, GitError, ConfigNotFoundError } from './symbols.js'
-import { ConfigObjectSymbol, searchConfigs } from './searchConfigs.js'
+import { searchConfigs } from './searchConfigs.js'
 
 const debugLog = debug('lint-staged:runAll')
 
@@ -52,6 +52,8 @@ const createError = (ctx) => Object.assign(new Error('lint-staged failed'), { ct
  * @param {string} [options.configPath] - Explicit path to a config file
  * @param {string} [options.cwd] - Current working directory
  * @param {boolean} [options.debug] - Enable debug mode
+ * @param {string} [options.diff] - Override the default "--staged" flag of "git diff" to get list of files
+ * @param {string} [options.diffFilter] - Override the default "--diff-filter=ACMR" flag of "git diff" to get list of files
  * @param {number} [options.maxArgLength] - Maximum argument string length
  * @param {boolean} [options.quiet] - Disable lint-staged’s own console output
  * @param {boolean} [options.relative] - Pass relative filepaths to tasks
@@ -69,6 +71,8 @@ export const runAll = async (
     configPath,
     cwd,
     debug = false,
+    diff,
+    diffFilter,
     maxArgLength,
     quiet = false,
     relative = false,
@@ -100,13 +104,14 @@ export const runAll = async (
     .then(() => true)
     .catch(() => false)
 
-  // Lint-staged should create a backup stash only when there's an initial commit
-  ctx.shouldBackup = hasInitialCommit && stash
+  // Lint-staged should create a backup stash only when there's an initial commit,
+  // and when using the default list of staged files
+  ctx.shouldBackup = hasInitialCommit && stash && diff === undefined
   if (!ctx.shouldBackup) {
-    logger.warn(skippingBackup(hasInitialCommit))
+    logger.warn(skippingBackup(hasInitialCommit, diff))
   }
 
-  const files = await getStagedFiles({ cwd: gitDir })
+  const files = await getStagedFiles({ cwd: gitDir, diff, diffFilter })
   if (!files) {
     if (!quiet) ctx.output.push(FAILED_GET_STAGED_FILES)
     ctx.errors.add(GetStagedFilesError)
@@ -121,7 +126,7 @@ export const runAll = async (
   }
 
   const foundConfigs = await searchConfigs({ configObject, configPath, cwd, gitDir }, logger)
-  const numberOfConfigs = Reflect.ownKeys(foundConfigs).length
+  const numberOfConfigs = Object.keys(foundConfigs).length
 
   // Throw if no configurations were found
   if (numberOfConfigs === 0) {
@@ -129,7 +134,11 @@ export const runAll = async (
     throw createError(ctx, ConfigNotFoundError)
   }
 
-  const filesByConfig = await groupFilesByConfig({ configs: foundConfigs, files })
+  const filesByConfig = await groupFilesByConfig({
+    configs: foundConfigs,
+    files,
+    singleConfigMode: configObject || configPath !== undefined,
+  })
 
   const hasMultipleConfigs = numberOfConfigs > 1
 
@@ -149,13 +158,8 @@ export const runAll = async (
   // Set of all staged files that matched a task glob. Values in a set are unique.
   const matchedFiles = new Set()
 
-  for (const configPath of Reflect.ownKeys(filesByConfig)) {
-    const { config, files } = filesByConfig[configPath]
-
-    const configName =
-      configPath === ConfigObjectSymbol
-        ? 'Config object'
-        : normalize(path.relative(cwd, configPath))
+  for (const [configPath, { config, files }] of Object.entries(filesByConfig)) {
+    const configName = configPath ? normalize(path.relative(cwd, configPath)) : 'Config object'
 
     const stagedFileChunks = chunkFiles({ baseDir: gitDir, files, maxArgLength, relative })
 
@@ -199,15 +203,15 @@ export const runAll = async (
             const fileCount = task.fileList.length
 
             return {
-              title: `${task.pattern}${dim(` — ${fileCount} ${fileCount > 1 ? 'files' : 'file'}`)}`,
-              task: async () =>
-                new Listr(subTasks, {
-                  // In sub-tasks we don't want to run concurrently
-                  // and we want to abort on errors
-                  ...listrOptions,
-                  concurrent: false,
-                  exitOnError: true,
-                }),
+              title: `${task.pattern}${dim(
+                ` — ${fileCount} ${fileCount === 1 ? 'file' : 'files'}`
+              )}`,
+              task: async (ctx, task) =>
+                task.newListr(
+                  subTasks,
+                  // Subtasks should not run in parallel, and should exit on error
+                  { concurrent: false, exitOnError: true }
+                ),
               skip: () => {
                 // Skip task when no files matched
                 if (fileCount === 0) {
@@ -224,7 +228,7 @@ export const runAll = async (
         title:
           `${configName}${dim(` — ${files.length} ${files.length > 1 ? 'files' : 'file'}`)}` +
           (chunkCount > 1 ? dim(` (chunk ${index + 1}/${chunkCount})...`) : ''),
-        task: () => new Listr(chunkListrTasks, { ...listrOptions, concurrent, exitOnError: true }),
+        task: (ctx, task) => task.newListr(chunkListrTasks, { concurrent, exitOnError: true }),
         skip: () => {
           // Skip if the first step (backup) failed
           if (ctx.errors.has(GitError)) return SKIPPED_GIT_ERROR
@@ -273,7 +277,7 @@ export const runAll = async (
       },
       {
         title: `Running tasks for staged files...`,
-        task: () => new Listr(listrTasks, { ...listrOptions, concurrent }),
+        task: (ctx, task) => task.newListr(listrTasks, { concurrent }),
         skip: () => listrTasks.every((task) => task.skip()),
       },
       {

package/lib/searchConfigs.js

@@ -1,6 +1,6 @@
 /** @typedef {import('./index').Logger} Logger */
 
-import { basename, join } from 'path'
+import path from 'node:path'
 
 import debug from 'debug'
 import normalize from 'normalize-path'
@@ -15,7 +15,7 @@ const debugLog = debug('lint-staged:searchConfigs')
 const EXEC_GIT = ['ls-files', '-z', '--full-name']
 
 const filterPossibleConfigFiles = (files) =>
-  files.filter((file) => searchPlaces.includes(basename(file)))
+  files.filter((file) => searchPlaces.includes(path.basename(file)))
 
 const numberOfLevels = (file) => file.split('/').length
 
@@ -23,8 +23,6 @@ const sortDeepestParth = (a, b) => (numberOfLevels(a) > numberOfLevels(b) ? -1 :
 
 const isInsideDirectory = (dir) => (file) => file.startsWith(normalize(dir))
 
-export const ConfigObjectSymbol = Symbol()
-
 /**
  * Search all config files from the git repository, preferring those inside `cwd`.
  *
@@ -46,7 +44,7 @@ export const searchConfigs = async (
   if (configObject) {
     debugLog('Using single direct configuration object...')
 
-    return { [ConfigObjectSymbol]: validateConfig(configObject, 'config object', logger) }
+    return { '': validateConfig(configObject, 'config object', logger) }
   }
 
   // Use only explicit config path instead of discovering multiple
@@ -70,7 +68,7 @@ export const searchConfigs = async (
 
   /** Sort possible config files so that deepest is first */
   const possibleConfigFiles = [...cachedFiles, ...otherFiles]
-    .map((file) => normalize(join(gitDir, file)))
+    .map((file) => normalize(path.join(gitDir, file)))
     .filter(isInsideDirectory(cwd))
     .sort(sortDeepestParth)
 

package/lib/state.js

@@ -1,3 +1,5 @@
+import EventEmitter from 'events'
+
 import { GIT_ERROR, TASK_ERROR } from './messages.js'
 import {
   ApplyEmptyCommitError,
@@ -11,6 +13,7 @@ export const getInitialState = ({ quiet = false } = {}) => ({
   hasPartiallyStagedFiles: null,
   shouldBackup: null,
   errors: new Set([]),
+  events: new EventEmitter(),
   output: [],
   quiet,
 })

package/lib/validateOptions.js

@@ -1,5 +1,6 @@
-import { constants, promises as fs } from 'fs'
-import path from 'path'
+import { constants } from 'node:fs'
+import fs from 'node:fs/promises'
+import path from 'node:path'
 
 import debug from 'debug'
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lint-staged",
-  "version": "12.4.3",
+  "version": "13.0.1",
   "description": "Lint files staged by git",
   "license": "MIT",
   "repository": "https://github.com/okonet/lint-staged",
@@ -14,7 +14,7 @@
     "url": "https://opencollective.com/lint-staged"
   },
   "engines": {
-    "node": "^12.20.0 || ^14.13.1 || >=16.0.0"
+    "node": "^14.13.1 || >=16.0.0"
   },
   "type": "module",
   "bin": "./bin/lint-staged.js",
@@ -33,35 +33,34 @@
   },
   "dependencies": {
     "cli-truncate": "^3.1.0",
-    "colorette": "^2.0.16",
+    "colorette": "^2.0.17",
     "commander": "^9.3.0",
     "debug": "^4.3.4",
-    "execa": "^5.1.1",
+    "execa": "^6.1.0",
     "lilconfig": "2.0.5",
     "listr2": "^4.0.5",
     "micromatch": "^4.0.5",
     "normalize-path": "^3.0.0",
     "object-inspect": "^1.12.2",
-    "pidtree": "^0.5.0",
+    "pidtree": "^0.6.0",
     "string-argv": "^0.3.1",
-    "supports-color": "^9.2.2",
-    "yaml": "^1.10.2"
+    "yaml": "^2.1.1"
   },
   "devDependencies": {
     "@babel/core": "^7.18.2",
     "@babel/eslint-parser": "^7.18.2",
     "@babel/preset-env": "^7.18.2",
-    "babel-jest": "^28.1.0",
+    "babel-jest": "^28.1.1",
     "babel-plugin-transform-imports": "2.0.0",
     "consolemock": "^1.1.0",
-    "eslint": "^8.16.0",
+    "eslint": "^8.17.0",
     "eslint-config-prettier": "^8.5.0",
     "eslint-plugin-import": "^2.26.0",
     "eslint-plugin-node": "^11.1.0",
     "eslint-plugin-prettier": "^4.0.0",
     "fs-extra": "^10.1.0",
     "husky": "^8.0.1",
-    "jest": "^28.1.0",
+    "jest": "^28.1.1",
     "jest-snapshot-serializer-ansi": "^1.0.0",
     "prettier": "^2.6.2"
   },