feat(rspeedy): add css sourcemap option

.changeset/add-css-sourcemap-option.md

@@ -0,0 +1,19 @@
+---
+"@lynx-js/rspeedy": patch
+---
+
+add a `sourceMap.css` option to emit CSS sourcemaps.
+
+By default, `sourceMap.css` is false. You can set it to true to emit CSS sourcemaps.
+
+```js
+import { defineConfig } from '@lynx-js/rspeedy';
+
+export default defineConfig({
+  output: {
+    sourceMap: {
+      css: true,
+    },
+  },
+});
+```

packages/rspeedy/core/etc/rspeedy.api.md

@@ -332,6 +332,7 @@ export interface Source {
 
 // @public
 export interface SourceMap {
+    css?: boolean | undefined;
     js?: Rspack.DevTool | undefined | `${Exclude<Rspack.DevTool, false | 'eval'>}-debugids`;
 }
 

packages/rspeedy/core/src/config/output/source-map.ts

@@ -72,4 +72,28 @@ export interface SourceMap {
     | Rspack.DevTool
     | undefined
     | `${Exclude<Rspack.DevTool, false | 'eval'>}-debugids`
+
+  /**
+   * Whether to generate CSS source maps.
+   *
+   * @remarks
+   *
+   * Defaults to `false`.
+   *
+   * @example
+   *
+   * ```js
+   * import { defineConfig } from '@lynx-js/rspeedy'
+   *
+   * export default defineConfig({
+   *   output: {
+   *     sourceMap: {
+   *       js: 'cheap-module-source-map',
+   *       css: true,
+   *     },
+   *   },
+   * })
+   * ```
+   */
+  css?: boolean | undefined
 }

packages/rspeedy/core/test/config/output.test-d.ts

@@ -380,11 +380,30 @@ describe('Config - Output', () => {
       },
     })
 
+    assertType<Output>({
+      sourceMap: {
+        css: true,
+      },
+    })
+
+    assertType<Output>({
+      sourceMap: {
+        css: false,
+      },
+    })
+
     assertType<Output>({
       sourceMap: {
         // @ts-expect-error should reject non-devtool value.
         js: 'foo-bar',
       },
     })
+
+    assertType<Output>({
+      sourceMap: {
+        // @ts-expect-error should reject non-boolean value.
+        css: 'foo-bar',
+      },
+    })
   })
 })

packages/rspeedy/core/test/config/validate.test.ts

@@ -919,6 +919,11 @@ describe('Config Validation', () => {
         { legalComments: 'inline' },
         { legalComments: 'none' },
         { legalComments: 'linked' },
+        { sourceMap: true },
+        { sourceMap: false },
+        { sourceMap: { js: 'cheap-module-source-map' } },
+        { sourceMap: { css: true } },
+        { sourceMap: { js: false, css: false } },
       ]
 
       cases.forEach(output => {
@@ -927,6 +932,23 @@ describe('Config Validation', () => {
     })
 
     test('invalid type', () => {
+      expect(() =>
+        validate({
+          output: {
+            sourceMap: {
+              css: 'true',
+            },
+          },
+        })
+      ).toThrowErrorMatchingInlineSnapshot(`
+        [Error: Invalid configuration.
+
+        Invalid config on \`$input.output.sourceMap.css\`.
+          - Expect to be (boolean | undefined)
+          - Got: string
+        ]
+      `)
+
       expect(() =>
         validate({
           output: {

packages/rspeedy/plugin-react/test/fixtures/sourcemap/index.css

@@ -0,0 +1,3 @@
+.app {
+  color: red;
+}

packages/rspeedy/plugin-react/test/fixtures/sourcemap/index.tsx

@@ -1,4 +1,5 @@
 import { root, Suspense, lazy } from '@lynx-js/react'
+import './index.css'
 
 const LazyBundleComp = lazy(() => import('./lazy-bundle-comp.jsx'))