[mizdra]

ref: #377

This PR adds @css-modules-kit/content-mapper, an experimental package that provides the language features of css-modules-kit on TypeScript 7 through a content mapper. This is the first step of a gradual implementation, limited to local tokens to keep the review small.

What's supported

• Go to Definition and Find All References for local tokens (class names, @value definitions, and @keyframes) in default export mode
• Go to Definition from the styles binding of an import statement
• Diagnostics for CSS syntax errors and invalid token names

See packages/content-mapper/README.md for the support status of each feature.

Main limitations of this step

• namedExports and the other options are not available yet
• Rename Symbol is not supported yet. You can rename a token in a TypeScript file, but it does not update *.module.css
• The features that need LSP middleware, such as Definition Preview by Hover, are not available
• @import <specifier> and @value <name> from <specifier> do not import tokens yet
• Container names and <dashed-ident>s are not treated as tokens
• Go to Definition and Find All References do not work on tokens used in animation-name and composes
• Unknown token references and unresolved specifiers in *.module.css are not reported

Why this PR adds vscode-jsonrpc

A content mapper communicates with TypeScript over JSON-RPC 2.0 with LSP-style Content-Length framing. Implementing this by hand requires maintaining message framing, the matching of requests and responses, and error responses, in both the mapper and the language client of the e2e tests. Using vscode-jsonrpc removes this code, so this package can focus on transforming CSS Modules.

A new dependency brings the risk of supply chain attacks. I consider this risk very low and accept it for the following reasons:

• The package is authored by Microsoft, the same as TypeScript
• The package has no dependencies of its own
• TypeScript itself vendors the same package (vendor/vscode-jsonrpc of typescript@7.0.2)

🤖 Generated with Claude Code

[changeset-bot]

🦋 Changeset detected

Latest commit: f74ac92

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@css-modules-kit/content-mapper	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[mizdra]

We're finally ready to release it :)