ESM migration: docusaurus-plugin-pwa

[rayterion]

Pre-flight checklist

• I have read the Contributing Guidelines on pull requests.
• If this is a code change: I have written unit tests and/or added dogfooding pages to fully verify the new behavior.
• If this is a new API or substantial change: the PR has an accompanying issue (closes #0000) and the maintainers have approved on my working plan.

Motivation

ESM migration for docusaurus-plugin-pwa package.

Note: i would appreciate some feedback.

Test Plan

Test links

Deploy preview: https://deploy-preview-_____--docusaurus-2.netlify.app/

Related issues/PRs

• Migration to ES Modules #6520

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	@​types/​dedent@​0.7.2
	@​types/​github-slugger@​1.3.0
	@​types/​detect-port@​1.3.5
	@​swc/​html@​1.13.5
	@​types/​update-notifier@​6.0.8
	@​types/​buble@​0.20.5
	@​typescript-eslint/​parser@​5.62.0
	@​types/​prompts@​2.4.9
	@​types/​react-test-renderer@​18.3.0
	@​types/​rtlcss@​3.5.4
	@​types/​js-yaml@​4.0.9
	@​types/​color@​3.0.6
	@​babel/​preset-react@​7.27.1 ⏵ 7.25.9				-5
	@​types/​webpack-bundle-analyzer@​4.7.0
	@​types/​escape-html@​1.0.4
	@​swc/​core@​1.7.39
	@​types/​serve-handler@​6.1.4
	@​types/​file-loader@​5.0.4
	@​babel/​preset-typescript@​7.27.1 ⏵ 7.25.9				-2
	@​argos-ci/​playwright@​2.0.0
	@​types/​picomatch@​2.3.4
	@​babel/​plugin-transform-runtime@​7.28.3 ⏵ 7.25.9	+1			+5
	@​types/​semver@​7.5.8
	@​types/​fs-extra@​9.0.13
	@​types/​micromatch@​4.0.9
	@​types/​react-dom@​18.3.1
	@​types/​shelljs@​0.8.15
	@​philpl/​buble@​0.19.7
	@​types/​jest@​29.5.14
	@​babel/​preset-env@​7.28.3 ⏵ 7.25.9	+1		+1
	@​typescript-eslint/​utils@​5.62.0
	react@​19.2.0 ⏵ 16.14.0			-6	+1
	@​types/​supports-color@​8.1.3
See 31 more rows in the dashboard

View full report

[netlify]

✅ [V2]

Built without sensitive environment variables

Name	Link
🔨 Latest commit	18563b5
🔍 Latest deploy log	https://app.netlify.com/projects/docusaurus-2/deploys/69657508cbf82e00083522e0
😎 Deploy Preview	https://deploy-preview-11657--docusaurus-2.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[rayterion]

If this PR gets merged i might start migrating other packages.

[slorber]

Thanks

This is a public-facing package that users can require, so I'd rather merge this only after we upgrade to Node 22 (https://nodejs.org/en/blog/release/v22.0.0) because not supporting require(esm) would break retrocompatibility.

Although in practice I doubt many users do require("@docusaurus/plugin-pwa"), it is still a possibility that we'd prefer not break.
requiring/importing/extending other plugins is more common, see #4138 (comment)
We'd rather keep this extension pattern working for v3, using commonjs require or esm imports