fix(staged): Include additional supported config types from lint-staged (#1263)

This PR carries over additional supported config types from
`lint-staged` to `vp staged`.

### The Reason

`vite-plus@0.1.15` broke type checks in my projects
([example](https://github.com/standard-config/oxlint/actions/runs/23837790752/job/69485643872)).
Turns out it was because I was using [`lint-staged`
commands](https://github.com/standard-config/oxlint/blob/254b7997a49445f5feb3800f05d3a78c6a4b3b53/vite.config.ts#L20-L29)
that didn’t match the original `staged` config type. For some reason,
these weren’t flagged before the update (the commands worked and keep
working fine at runtime).

I can confirm this fixes the type issues for me locally, but I’d
appreciate guidance on adding more thorough tests for these changes.

---------

Co-authored-by: MK <fengmk2@gmail.com>

Author: porada

packages/cli/src/__tests__/staged/config.spec.ts

@@ -0,0 +1,55 @@
+import { assertType, describe, it } from 'vitest';
+
+import type { StagedConfig } from '../../staged-config.js';
+
+describe('StagedConfig type', () => {
+  it('accepts string commands', () => {
+    assertType<StagedConfig>({
+      '*.ts': 'eslint --fix',
+    });
+  });
+
+  it('accepts arrays of string commands', () => {
+    assertType<StagedConfig>({
+      '*.ts': ['eslint --fix', 'prettier --write'],
+    });
+  });
+
+  it('accepts sync generate task functions', () => {
+    assertType<StagedConfig>({
+      '*.ts': (files: readonly string[]) => `eslint ${files.join(' ')}`,
+    });
+  });
+
+  it('accepts async generate task functions', () => {
+    assertType<StagedConfig>({
+      '*.ts': async (files: readonly string[]) => `eslint ${files.join(' ')}`,
+    });
+  });
+
+  it('accepts mixed arrays of strings and functions', () => {
+    assertType<StagedConfig>({
+      '*': [
+        () => 'pnpm install --ignore-scripts',
+        () => 'pnpm test',
+        'oxlint --deny-warnings --fix',
+        'prettier --ignore-unknown --write',
+      ],
+    });
+  });
+
+  it('accepts task function objects', () => {
+    assertType<StagedConfig>({
+      '*.ts': {
+        title: 'Run eslint',
+        task: (files: readonly string[]) => {
+          void files;
+        },
+      },
+    });
+  });
+
+  it('accepts a top-level generate task function', () => {
+    assertType<StagedConfig>((files: readonly string[]) => [`eslint ${files.join(' ')}`]);
+  });
+});

packages/cli/src/staged-config.ts

@@ -1 +1,17 @@
-export type StagedConfig = Record<string, string | string[]>;
+// Copied from lint-staged@16.4.0 (node_modules/lint-staged/lib/index.d.ts)
+// TODO: Re-export directly from lint-staged once we can bundle .d.ts files (#744).
+
+type SyncGenerateTask = (stagedFileNames: readonly string[]) => string | string[];
+
+type AsyncGenerateTask = (stagedFileNames: readonly string[]) => Promise<string | string[]>;
+
+type GenerateTask = SyncGenerateTask | AsyncGenerateTask;
+
+type TaskFunction = {
+  title: string;
+  task: (stagedFileNames: readonly string[]) => void | Promise<void>;
+};
+
+export type StagedConfig =
+  | Record<string, string | TaskFunction | GenerateTask | (string | GenerateTask)[]>
+  | GenerateTask;