From ff14f76e519b063933fe8bf98664d402c7ff1686 Mon Sep 17 00:00:00 2001
From: neverland <chenjiahan.jait@bytedance.com>
Date: Wed, 13 May 2026 14:57:12 +0800
Subject: [PATCH] fix(types): allow string resourceQueryExclude

---
 README.md                   | 35 +++++++++++++++++++++++++++++++++--
 src/options.ts              |  6 ++++--
 test/resource-query.test.js | 17 +++++++++++++++++
 3 files changed, 54 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 24695d8..eb8ccfa 100644
--- a/README.md
+++ b/README.md
@@ -167,12 +167,43 @@ Specify the files and/or directories to exclude. Must be relative to `options.co
 - Type:
 
 ```ts
-type resourceQueryExclude = RegExp | Array<RegExp>;
+type resourceQueryExclude = string | RegExp | Array<string | RegExp>;
 ```
 
 - Default: `[]`
 
-Specify the resource query to exclude.
+Exclude modules from linting when their resource query matches one of the
+provided patterns. The resource query is the part after `?` in an import, such
+as `raw` in `import './file.js?raw'`.
+
+String values are converted to `RegExp`. Use anchors when you need an exact
+match.
+
+```js
+import ESLintPlugin from 'eslint-rspack-plugin';
+
+export default {
+  plugins: [
+    new ESLintPlugin({
+      resourceQueryExclude: 'raw',
+    }),
+  ],
+};
+```
+
+You can also mix strings and `RegExp` values:
+
+```js
+import ESLintPlugin from 'eslint-rspack-plugin';
+
+export default {
+  plugins: [
+    new ESLintPlugin({
+      resourceQueryExclude: [/media/, '^raw$'],
+    }),
+  ],
+};
+```
 
 ### `files`
 
diff --git a/src/options.ts b/src/options.ts
index 01cd648..4c0cf58 100644
--- a/src/options.ts
+++ b/src/options.ts
@@ -23,6 +23,8 @@ export type SeverityOptions = {
   warning?: Severity;
 };
 
+export type ResourceQueryExclude = string | RegExp | Array<string | RegExp>;
+
 export type PluginOptions = {
   context?: string;
   eslintPath?: string;
@@ -35,7 +37,7 @@ export type PluginOptions = {
   lintAllFiles?: boolean;
   severity?: SeverityOptions;
   outputReport?: OutputReport;
-  resourceQueryExclude?: RegExp | RegExp[];
+  resourceQueryExclude?: ResourceQueryExclude;
   configType?: string;
 };
 
@@ -46,7 +48,7 @@ export type ResolvedOptions = Options & {
   cacheLocation: string;
   configType: string;
   extensions: string | string[];
-  resourceQueryExclude: RegExp | RegExp[];
+  resourceQueryExclude: ResourceQueryExclude;
   severity: Required<SeverityOptions>;
 };
 
diff --git a/test/resource-query.test.js b/test/resource-query.test.js
index f789e59..c4fc93f 100644
--- a/test/resource-query.test.js
+++ b/test/resource-query.test.js
@@ -17,4 +17,21 @@ describe('resource-query', () => {
     expect(stats.hasWarnings()).toBe(false);
     expect(stats.hasErrors()).toBe(false);
   });
+
+  it('should exclude the match resource query from string pattern', async () => {
+    const compiler = pack(
+      'resource-query',
+      {
+        resourceQueryExclude: 'media',
+        extensions: ['.js', '.ts'],
+      },
+      {
+        module: { rules: [{ resourceQuery: /media/, type: 'asset/source' }] },
+      },
+    );
+
+    const stats = await compiler.runAsync();
+    expect(stats.hasWarnings()).toBe(false);
+    expect(stats.hasErrors()).toBe(false);
+  });
 });