CRITICAL: description on `noUncheckedSideEffectImports` has no guide for CSS npm library authors to have users avoid TS2882 when import css globally

[tats-u]

Page URL: https://www.typescriptlang.org/tsconfig/#noUncheckedSideEffectImports https://www.typescriptlang.org/docs/handbook/release-notes/typescript-6-0.html

Issue:

TS 6.0 turned on noUncheckedSideEffectImports by default but it causes errors on CSS libraries meeting the following conditions:

• Has entrypoints meeting the following conditions:
  • Their names don't end with .css (e.g. library-name/css)
  • Globally imported (import "library-name/css")
  • Doesn't have "types" fields in their "exports" fields in package.json

Library users bump into TS2882 at import "library-name/css".

• TypeScript 6 compatibility: import '@payloadcms/next/css' fails with TS2882 payloadcms/payload#16346
  • payloadcms/payload@6c81355
• CSS import is incompatible with tsconfig's noUncheckedSideEffectImports (default since 6.0) tauri-apps/meilisearch-docsearch#219
• [Bug Report][4.0.4] error TS2882: Cannot find module or type declarations for side-effect import of 'vuetify/styles'. vuetifyjs/vuetify#22766
  • vuetifyjs/vuetify@2098fb1
• Typescript 6 support (side-effect compilation errors) arnog/mathlive#3030
• https://github.com/search?q=noUncheckedSideEffectImports+TS2882+import&type=issues

The offending pages must provide a guide for CSS library authors to deal with noUncheckedSideEffectImports.