feat: add resourceQuery option for excluding by query (#34)

Author: chenjiahan

README.md

@@ -108,7 +108,7 @@ Compared to the previous approach, this method decouples the React Fast Refresh
 - Type: [Rspack.RuleSetCondition](https://rspack.dev/config/module#condition)
 - Default: `/\.([cm]js|[jt]sx?|flow)$/i`
 
-Include files to be processed by the plugin. The value is the same as the `rule.test` option in Rspack.
+Include files to be processed by the plugin. The value is the same as the [rule.test](https://rspack.dev/config/module#ruletest) option in Rspack.
 
 ```js
 new ReactRefreshPlugin({
@@ -121,14 +121,29 @@ new ReactRefreshPlugin({
 - Type: [Rspack.RuleSetCondition](https://rspack.dev/config/module#condition)
 - Default: `/node_modules/`
 
-Exclude files from being processed by the plugin. The value is the same as the `rule.exclude` option in Rspack.
+Exclude files from being processed by the plugin. The value is the same as the [rule.exclude](https://rspack.dev/config/module#ruleexclude) option in Rspack.
 
 ```js
 new ReactRefreshPlugin({
   exclude: [/node_modules/, /some-other-module/],
 });
 ```
 
+### resourceQuery
+
+- Type: [Rspack.RuleSetCondition](https://rspack.dev/config/module#condition)
+- Default: `undefined`
+
+Can be used to exclude certain resources from being processed by the plugin by the resource query. The value is the same as the [rule.resourceQuery](https://rspack.dev/config/module#ruleresourcequery) option in Rspack.
+
+For example, to exclude all resources with the `raw` query, such as `import rawTs from './ReactComponent.ts?raw';`, use the following:
+
+```js
+new ReactRefreshPlugin({
+  resourceQuery: { not: /raw/ },
+});
+```
+
 ### forceEnable
 
 - Type: `boolean`

src/index.ts

@@ -86,6 +86,7 @@ class ReactRefreshRspackPlugin {
           // biome-ignore lint: exists
           or: [this.options.exclude!, [...runtimePaths]].filter(Boolean),
         },
+        resourceQuery: this.options.resourceQuery,
         use: ReactRefreshRspackPlugin.loader,
       });
     }

src/options.ts

@@ -16,14 +16,29 @@ export type PluginOptions = {
    * Include files to be processed by the plugin.
    * The value is the same as the `rule.test` option in Rspack.
    * @default /\.([cm]js|[jt]sx?|flow)$/i
+   * @see https://rspack.dev/config/module#ruletest
    */
   include?: RuleSetCondition | null;
   /**
    * Exclude files from being processed by the plugin.
    * The value is the same as the `rule.exclude` option in Rspack.
    * @default /node_modules/
+   * @see https://rspack.dev/config/module#ruleexclude
    */
   exclude?: RuleSetCondition | null;
+  /**
+   * Can be used to exclude certain resources from being processed by
+   * the plugin by the resource query.
+   * @see https://rspack.dev/config/module#ruleresourcequery
+   *
+   * @example
+   * To exclude all resources with the `raw` query, such as
+   * `import rawTs from './ReactComponent.ts?raw';`, use the following:
+   * ```ts
+   * { resourceQuery: { not: /raw/ } }
+   * ```
+   */
+  resourceQuery?: RuleSetCondition;
   /**
    * Sets a namespace for the React Refresh runtime.
    * It is most useful when multiple instances of React Refresh is running

test/fixtures/query/foo.js

@@ -0,0 +1 @@
+module.exports = 'foo';

test/fixtures/query/index.js

@@ -0,0 +1 @@
+require('./foo?raw');