feat: move cssChunksToMap implementation to @lynx-js/css-serializer (#2269)

<!--
  Thank you for submitting a pull request!

We appreciate the time and effort you have invested in making these
changes. Please ensure that you provide enough information to allow
others to review your pull request.

Upon submission, your pull request will be automatically assigned with
reviewers.

If you want to learn more about contributing to this project, please
visit:
https://github.com/lynx-family/lynx-stack/blob/main/CONTRIBUTING.md.
-->

<!-- The AI summary below will be auto-generated - feel free to replace
it with your own. -->

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

## Release Notes

* **Bug Fixes**
* Patched @lynx-js/template-webpack-plugin and @lynx-js/css-serializer.

* **New Features**
  * Exposed CSS namespace directly from @lynx-js/css-serializer.
  * Added CSSPlugins export with parserPlugins property.
* Made cssChunksToMap available as a public export from
@lynx-js/css-serializer.

* **Chores**
* Updated test imports and configuration for improved module resolution.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

In #2143, we need to use `cssChunksToMap` in
`@lynx-js/lynx-bundle-rslib-config` package.

To avoid repeating ourselves, we extract the `cssChunksToMap` API from
`@lynx-js/template-webpack-plugin` to `@lynx-js/css-serializer`.

## Checklist

<!--- Check and mark with an "x" -->

- [x] Tests updated (or not required).
- [ ] Documentation updated (or not required).
- [x] Changeset added, and when a BREAKING CHANGE occurs, it needs to be
clearly marked (or not required).

Author: upupming

.changeset/wet-rockets-taste.md

@@ -0,0 +1,6 @@
+---
+"@lynx-js/template-webpack-plugin": patch
+"@lynx-js/css-serializer": patch
+---
+
+Move `cssChunksToMap` implementation from `@lynx-js/template-webpack-plugin` to `@lynx-js/css-serializer` for future reuse.

…k/template-webpack-plugin/src/css/ast.ts …ages/tools/css-serializer/src/css/ast.tspackages/webpack/template-webpack-plugin/src/css/ast.ts renamed to packages/tools/css-serializer/src/css/ast.ts packages/webpack/template-webpack-plugin/src/css/ast.ts renamed to packages/tools/css-serializer/src/css/ast.ts

@@ -1,8 +1,8 @@
 // Copyright 2024 The Lynx Authors. All rights reserved.
 // Licensed under the Apache License Version 2.0 that can be found in the
 // LICENSE file in the root directory of this source tree.
-import * as CSS from '@lynx-js/css-serializer';
-import type { Plugin } from '@lynx-js/css-serializer';
+import * as CSS from '../index.js';
+import type { Plugin } from '../index.js';
 
 export function cssToAst(
   content: string,

…webpack-plugin/src/css/cssChunksToMap.ts …css-serializer/src/css/cssChunksToMap.tspackages/webpack/template-webpack-plugin/src/css/cssChunksToMap.ts renamed to packages/tools/css-serializer/src/css/cssChunksToMap.ts packages/webpack/template-webpack-plugin/src/css/cssChunksToMap.ts renamed to packages/tools/css-serializer/src/css/cssChunksToMap.ts

@@ -1,7 +1,7 @@
 // Copyright 2024 The Lynx Authors. All rights reserved.
 // Licensed under the Apache License Version 2.0 that can be found in the
 // LICENSE file in the root directory of this source tree.
-import type * as CSS from '@lynx-js/css-serializer';
+import type * as CSS from '../index.js';
 
 import { cssToAst } from './ast.js';
 import { debundleCSS } from './debundle.js';

…plate-webpack-plugin/src/css/debundle.ts …tools/css-serializer/src/css/debundle.tspackages/webpack/template-webpack-plugin/src/css/debundle.ts renamed to packages/tools/css-serializer/src/css/debundle.ts packages/webpack/template-webpack-plugin/src/css/debundle.ts renamed to packages/tools/css-serializer/src/css/debundle.ts

@@ -1,4 +1,4 @@
 // Copyright 2024 The Lynx Authors. All rights reserved.
 // Licensed under the Apache License Version 2.0 that can be found in the
 // LICENSE file in the root directory of this source tree.
-export { Plugins as parserPlugins } from '@lynx-js/css-serializer';
+export { cssChunksToMap } from './cssChunksToMap.js';

…-webpack-plugin/src/css/plugins/index.ts …es/tools/css-serializer/src/css/index.tspackages/webpack/template-webpack-plugin/src/css/plugins/index.ts renamed to packages/tools/css-serializer/src/css/index.ts packages/webpack/template-webpack-plugin/src/css/plugins/index.ts renamed to packages/tools/css-serializer/src/css/index.ts

@@ -7,3 +7,4 @@ export * as csstree from 'css-tree';
 export * as Plugins from './plugins/index.js';
 export type * from './types/index.js';
 export { parse } from './parse.js';
+export * from './css/index.js';

packages/tools/css-serializer/src/index.ts

@@ -3,11 +3,14 @@
 // LICENSE file in the root directory of this source tree.
 import { describe, expect, test } from 'vitest';
 
-import type { LynxStyleNode } from '@lynx-js/css-serializer';
+import type { LynxStyleNode } from '../src';
 
-import { cssChunksToMap } from '../src/css/cssChunksToMap.js';
+import { cssChunksToMap, Plugins as parserPlugins } from '../src';
 import { debundleCSS } from '../src/css/debundle.js';
-import { CSSPlugins } from '../src/index.js';
+
+const CSSPlugins = {
+  parserPlugins,
+};
 
 describe('CSS', () => {
   describe('cssChunksToMap', () => {

…template-webpack-plugin/test/css.test.ts …es/tools/css-serializer/test/css.test.tspackages/webpack/template-webpack-plugin/test/css.test.ts renamed to packages/tools/css-serializer/test/css.test.ts packages/webpack/template-webpack-plugin/test/css.test.ts renamed to packages/tools/css-serializer/test/css.test.ts

@@ -2,7 +2,7 @@ import { defineConfig } from 'vitest/config';
 
 export default defineConfig({
   test: {
-    include: ['**/test/*.spec.ts'],
+    include: ['**/test/*.spec.ts', '**/test/*.test.ts'],
     name: 'tools/css-serializer',
   },
 });

packages/tools/css-serializer/vitest.config.ts

@@ -9,50 +9,20 @@ import { AsyncSeriesBailHook } from '@rspack/lite-tapable';
 import { AsyncSeriesWaterfallHook } from '@rspack/lite-tapable';
 import type { Compilation } from 'webpack';
 import type { Compiler } from 'webpack';
-import type * as CSS_2 from '@lynx-js/css-serializer';
-import { csstree } from '@lynx-js/css-serializer';
-import { Declaration } from '@lynx-js/css-serializer';
-import { FontFaceRule } from '@lynx-js/css-serializer';
-import { ImportRule } from '@lynx-js/css-serializer';
-import { KeyframesRule } from '@lynx-js/css-serializer';
-import { LynxStyleNode } from '@lynx-js/css-serializer';
-import { parse } from '@lynx-js/css-serializer';
-import { Plugin } from '@lynx-js/css-serializer';
+import * as CSS from '@lynx-js/css-serializer';
+import { cssChunksToMap } from '@lynx-js/css-serializer';
 import { Plugins } from '@lynx-js/css-serializer';
-import { StyleRule } from '@lynx-js/css-serializer';
 import { SyncWaterfallHook } from '@rspack/lite-tapable';
 
-declare namespace CSS {
-    export {
-        csstree,
-        Plugins,
-        parse,
-        Plugin,
-        Declaration,
-        LynxStyleNode,
-        StyleRule,
-        FontFaceRule,
-        ImportRule,
-        KeyframesRule,
-        cssChunksToMap
-    }
-}
+export { CSS }
 
-// Warning: (ae-missing-release-tag) "cssChunksToMap" is part of the package's API, but it is missing a release tag (@alpha, @beta, @public, or @internal)
+// Warning: (ae-missing-release-tag) "CSSPlugins" is part of the package's API, but it is missing a release tag (@alpha, @beta, @public, or @internal)
 //
 // @public (undocumented)
-function cssChunksToMap(cssChunks: string[], plugins: CSS_2.Plugin[], enableCSSSelector: boolean): {
-    cssMap: Record<string, CSS_2.LynxStyleNode[]>;
-    cssSource: Record<string, string>;
-    contentMap: Map<number, string[]>;
+export const CSSPlugins: {
+    parserPlugins: typeof Plugins;
 };
 
-declare namespace CSSPlugins {
-    export {
-        Plugins as parserPlugins
-    }
-}
-
 // @public
 export interface EncodeOptions {
     // (undocumented)
@@ -98,8 +68,8 @@ export interface LynxEncodePluginOptions {
 export class LynxTemplatePlugin {
     constructor(options?: LynxTemplatePluginOptions | undefined);
     apply(compiler: Compiler): void;
-    static convertCSSChunksToMap(cssChunks: string[], plugins: CSS_2.Plugin[], enableCSSSelector: boolean): {
-        cssMap: Record<string, CSS_2.LynxStyleNode[]>;
+    static convertCSSChunksToMap(cssChunks: string[], plugins: CSS.Plugin[], enableCSSSelector: boolean): {
+        cssMap: Record<string, CSS.LynxStyleNode[]>;
         cssSource: Record<string, string>;
     };
     static defaultOptions: Readonly<Required<LynxTemplatePluginOptions>>;
@@ -109,7 +79,7 @@ export class LynxTemplatePlugin {
 // @public
 export interface LynxTemplatePluginOptions {
     chunks?: 'all' | string[];
-    cssPlugins: CSS_2.Plugin[];
+    cssPlugins: CSS.Plugin[];
     customCSSInheritanceList: string[] | undefined;
     debugInfoOutside: boolean;
     defaultDisplayLinear: boolean;

packages/webpack/template-webpack-plugin/etc/template-webpack-plugin.api.md

@@ -20,9 +20,9 @@ import type {
 } from 'webpack';
 
 import type * as CSS from '@lynx-js/css-serializer';
+import { cssChunksToMap } from '@lynx-js/css-serializer';
 import { RuntimeGlobals } from '@lynx-js/webpack-runtime-globals';
 
-import { cssChunksToMap } from './css/cssChunksToMap.js';
 import { createLynxAsyncChunksRuntimeModule } from './LynxAsyncChunksRuntimeModule.js';
 
 export type OriginManifest = Record<string, {