chore: migrate from Prettier to oxfmt for code formatting

.eslintrc.js

@@ -82,7 +82,7 @@ module.exports = {
     'max-len': [
       WARNING,
       {
-        code: Infinity, // Code width is already enforced by Prettier
+        code: Infinity, // Code width is already enforced by Prettier/oxfmt
         tabWidth: 2,
         comments: 80,
         ignoreUrls: true,

.github/workflows/lint-autofix.yml

@@ -33,7 +33,7 @@ jobs:
       - name: Installation
         run: yarn install --frozen-lockfile || yarn install --frozen-lockfile || yarn install --frozen-lockfile
 
-      - name: AutoFix Format
+      - name: AutoFix Formatting
         run: yarn format
 
       - name: AutoFix JS

.github/workflows/lint.yml

@@ -36,5 +36,5 @@ jobs:
           echo "::add-matcher::.github/workflows/cspell-problem-matcher.json"
           yarn lint:ci
 
-      - name: Prettier Code
+      - name: Check Formatting
         run: yarn format:diff

.lintstagedrc.json

@@ -1,5 +1,13 @@
 {
-  "*.{js,jsx,ts,tsx,mjs}": ["eslint --fix"],
-  "*.css": ["stylelint --allow-empty-input --fix"],
-  "*": ["prettier --ignore-unknown --write"]
+  "*.{js,jsx,ts,tsx,mjs,cjs,mts,cts}": [
+    "eslint --fix",
+    "oxfmt --no-error-on-unmatched-pattern"
+  ],
+  "*.{css,scss,less}": [
+    "stylelint --allow-empty-input --fix",
+    "oxfmt --no-error-on-unmatched-pattern"
+  ],
+  "*.{json,jsonc,json5,md,mdx,html,yml,yaml,toml}": [
+    "oxfmt --no-error-on-unmatched-pattern"
+  ]
 }

.oxfmtrc.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "./node_modules/oxfmt/configuration_schema.json",
+  "arrowParens": "always",
+  "bracketSameLine": true,
+  "bracketSpacing": false,
+  "ignorePatterns": [
+    "dist",
+    "node_modules",
+    ".yarn",
+    "**/build/**",
+    "coverage",
+    ".docusaurus",
+    ".idea",
+    ".svg",
+    "*.svg",
+    "jest/vendor",
+    "argos/test-results",
+    "packages/lqip-loader/lib/",
+    "packages/docusaurus/lib/",
+    "packages/docusaurus-*/lib/*",
+
+    "packages/create-docusaurus/lib/*",
+    "!packages/docusaurus-*/lib/theme/**",
+
+    "packages/create-docusaurus/templates/*/docusaurus.config.js",
+    "packages/eslint-plugin/lib/",
+    "packages/stylelint-copyright/lib/",
+    "__fixtures__",
+    "website/i18n",
+    "website/versions.json",
+    "website/docusaurus.config.js",
+    "website/versioned_docs/",
+    "website/versioned_sidebars/*.json",
+    "examples/",
+    "website/static/katex/katex.min.css",
+    "website/changelog",
+    "website/_dogfooding/_swizzle_theme_tests",
+    "website/_dogfooding/_asset-tests/badSyntax.js",
+    "website/_dogfooding/_asset-tests/badSyntax.css",
+    "*.xml",
+    "*.xsl"
+  ],
+  "insertFinalNewline": true,
+  "printWidth": 80,
+  "proseWrap": "never",
+  "singleQuote": true,
+  "sortPackageJson": false,
+  "trailingComma": "all"
+}

.vscode/extensions.json

@@ -2,7 +2,7 @@
   // See https://go.microsoft.com/fwlink/?LinkId=827846 to learn about workspace recommendations.
   "recommendations": [
     "streetsidesoftware.code-spell-checker",
-    "esbenp.prettier-vscode",
+    "oxc.oxc-vscode",
     "dbaeumer.vscode-eslint",
     "stylelint.vscode-stylelint",
     "EditorConfig.EditorConfig",

AGENTS.md

@@ -13,7 +13,6 @@ Docusaurus uses itself to build its own website, which serves as both documentat
 ### Monorepo Structure
 
 - `packages/` - Core Docusaurus packages and plugins, published to npm
-
   - `docusaurus/` - Main CLI and core functionality
   - `docusaurus-plugin-*` - Official plugins, the main ones are `docs`, `blog`, `pages`
   - `docusaurus-theme-classic/` - Default theme, based on the Infima.dev design system and CSS modules
@@ -42,7 +41,7 @@ The main CLI commands available
 - `yarn install` - Install dependencies and then build all monorepo packages
 - `yarn build:packages` - Build all monorepo packages
 - `yarn watch` - Incremental build of monorepo packages with file watchers
-- `yarn format` - Format code with Prettier
+- `yarn format` - Format code with oxfmt
 - `yarn lint` - Run linting (ESLint + Stylelint + spell check)
 - `yarn test` - Run all tests using Jest
 - `yarn clear` - Clean all build artifacts and caches
@@ -68,7 +67,7 @@ Update Jest failing snapshots with the `-u` option. Do not blindly update snapsh
 
 ### Linting & Formatting
 
-- `yarn format` - Format code with Prettier
+- `yarn format` - Format code with oxfmt
 - `yarn lint:js` - ESLint for JS/TS files
 - `yarn lint:style` - Stylelint for CSS files
 - `yarn lint:spelling` - CSpell for spell checking

CHANGELOG-v2.md

@@ -5503,9 +5503,7 @@ Bad release, check ## 2.0.0-alpha.58
 #### :boom: Breaking Change
 
 - `infima`
-
   - The following Infima classes have been renamed for consistency:
-
     - `page-item` → `pagination__item`
     - `pagination-nav__link--label` → `pagination-nav__label`
     - `pagination-nav__link--sublabel` → `pagination-nav__sublabel`
@@ -5515,7 +5513,6 @@ Bad release, check ## 2.0.0-alpha.58
     If you have swizzled components, you need to replace these class names.
 
 - `docusaurus`
-
   - [#2764](https://github.com/facebook/docusaurus/pull/2764) feat(v2): allow import SVG images ([@lex111](https://github.com/lex111))
 
 #### :rocket: New Feature

__tests__/validate-tsconfig.test.ts

@@ -47,9 +47,8 @@ describe('tsconfig files', () => {
         try {
           Joi.attempt(file.content, tsconfigSchema);
         } catch (e) {
-          (
-            e as Error
-          ).message += `\n${file.file} does not match the required schema.`;
+          (e as Error).message +=
+            `\n${file.file} does not match the required schema.`;
           throw e;
         }
       });

admin/new.docusaurus.io/netlify.toml

@@ -3,31 +3,31 @@
 directory = "functions"
 
 [[redirects]]
-from    = "/"
-to      = "/.netlify/functions/index"
-status  = 200
+from = "/"
+to = "/.netlify/functions/index"
+status = 200
 
 [[redirects]]
-from    = "/codesandbox"
-to      = "/.netlify/functions/codesandbox"
-status  = 200
+from = "/codesandbox"
+to = "/.netlify/functions/codesandbox"
+status = 200
 
 [[redirects]]
-from    = "/codesandbox-ts"
-to      = "/.netlify/functions/codesandbox-ts"
-status  = 200
+from = "/codesandbox-ts"
+to = "/.netlify/functions/codesandbox-ts"
+status = 200
 
 [[redirects]]
-from    = "/stackblitz"
-to      = "/.netlify/functions/stackblitz"
-status  = 200
+from = "/stackblitz"
+to = "/.netlify/functions/stackblitz"
+status = 200
 
 [[redirects]]
-from    = "/stackblitz-ts"
-to      = "/.netlify/functions/stackblitz-ts"
-status  = 200
+from = "/stackblitz-ts"
+to = "/.netlify/functions/stackblitz-ts"
+status = 200
 
 [[redirects]]
-from    = "/*"
-to      = "/.netlify/functions/index"
-status  = 200
+from = "/*"
+to = "/.netlify/functions/index"
+status = 200

package.json

@@ -55,8 +55,8 @@
     "changelog": "lerna-changelog",
     "postinstall": "patch-package && yarn lock:update && yarn build:packages",
     "prepare": "husky install",
-    "format": "prettier --write .",
-    "format:diff": "prettier --list-different .",
+    "format": "oxfmt .",
+    "format:diff": "oxfmt --list-different .",
     "lint": "yarn lint:js && yarn lint:style && yarn lint:spelling && yarn lint:syncpack",
     "lint:ci": "yarn lint:js --quiet && yarn lint:style && yarn lint:spelling && yarn lint:syncpack",
     "lint:js": "eslint --cache --report-unused-disable-directives \"**/*.{js,jsx,ts,tsx,mjs}\"",
@@ -79,7 +79,6 @@
   "devDependencies": {
     "@ai-sdk/react": "^2.0.30",
     "@crowdin/cli": "^4.14.2",
-    "@prettier/plugin-xml": "^2.2.0",
     "@swc/core": "^1.15.32",
     "@swc/jest": "^0.2.39",
     "@testing-library/dom": "^10.4.1",
@@ -122,7 +121,7 @@
     "patch-package": "^8.0.1",
     "pkg-pr-new": "^0.0.68",
     "postinstall-postinstall": "^2.1.0",
-    "prettier": "^2.8.8",
+    "oxfmt": "^0.47.0",
     "react": "^19.2.5",
     "react-dom": "^19.2.5",
     "rimraf": "^3.0.2",

packages/create-docusaurus/src/index.ts

@@ -626,8 +626,8 @@ export default async function init(
         pkgManager === 'yarn'
           ? 'yarn'
           : pkgManager === 'bun'
-          ? 'bun install'
-          : `${pkgManager} install --color always`,
+            ? 'bun install'
+            : `${pkgManager} install --color always`,
         [],
         {
           env: {

packages/docusaurus-mdx-loader/src/utils.ts

@@ -119,7 +119,7 @@ export async function compileToJSX({
     const errorDetails =
       errorJSON === '{}'
         ? // regular JS error case: print stacktrace
-          error.stack ?? 'N/A'
+          (error.stack ?? 'N/A')
         : // MDX error: print extra attributes + stacktrace
           `${errorJSON}\n${error.stack}`;
 

packages/docusaurus-plugin-content-blog/assets/atom.css

@@ -11,7 +11,13 @@ main {
   margin: 2rem auto;
   max-width: 800px;
   /* stylelint-disable-next-line font-family-name-quotes */
-  font-family: system-ui, -apple-system, Segoe UI, Roboto, Ubuntu, Cantarell;
+  font-family:
+    system-ui,
+    -apple-system,
+    Segoe UI,
+    Roboto,
+    Ubuntu,
+    Cantarell;
 }
 
 .info {

packages/docusaurus-plugin-content-blog/assets/rss.css

@@ -11,7 +11,13 @@ main {
   margin: 2rem auto;
   max-width: 800px;
   /* stylelint-disable-next-line font-family-name-quotes */
-  font-family: system-ui, -apple-system, Segoe UI, Roboto, Ubuntu, Cantarell;
+  font-family:
+    system-ui,
+    -apple-system,
+    Segoe UI,
+    Roboto,
+    Ubuntu,
+    Cantarell;
 }
 
 .info {

packages/docusaurus-plugin-content-blog/src/feed.ts

@@ -196,8 +196,8 @@ async function resolveXsltFilePaths({
 }) {
   const xsltAbsolutePath: string = path.isAbsolute(xsltFilePath)
     ? xsltFilePath
-    : (await getDataFilePath({filePath: xsltFilePath, contentPaths})) ??
-      path.resolve(contentPaths.contentPath, xsltFilePath);
+    : ((await getDataFilePath({filePath: xsltFilePath, contentPaths})) ??
+      path.resolve(contentPaths.contentPath, xsltFilePath));
 
   if (!(await fs.pathExists(xsltAbsolutePath))) {
     throw new Error(

packages/docusaurus-plugin-content-docs/src/sidebars/generator.ts

@@ -206,7 +206,7 @@ Available doc IDs:
           return undefined;
         }
         const id = link
-          ? findDocByLocalId(link.id)?.id ?? getDoc(link.id).id
+          ? (findDocByLocalId(link.id)?.id ?? getDoc(link.id).id)
           : findConventionalCategoryDocLink()?.id;
         if (!id) {
           return undefined;

packages/docusaurus-plugin-content-docs/src/versions/files.ts

@@ -145,7 +145,7 @@ export async function readVersionNames(
     );
   }
 
-  const versions = options.disableVersioning ? [] : versionFileContent ?? [];
+  const versions = options.disableVersioning ? [] : (versionFileContent ?? []);
 
   // We add the current version at the beginning, unless:
   // - user don't want to; or

packages/docusaurus-plugin-debug/package.json

@@ -5,7 +5,7 @@
   "main": "lib/index.js",
   "types": "src/plugin-debug.d.ts",
   "scripts": {
-    "build": "tsc --build && node ../../admin/scripts/copyUntypedFiles.js && prettier --config ../../.prettierrc --write \"lib/theme/**/*.js\"",
+    "build": "tsc --build && node ../../admin/scripts/copyUntypedFiles.js && oxfmt \"lib/theme/**/*.js\"",
     "watch": "run-p -c copy:watch build:watch",
     "build:watch": "tsc --build --watch",
     "copy:watch": "node ../../admin/scripts/copyUntypedFiles.js --watch"

packages/docusaurus-plugin-ideal-image/package.json

@@ -5,7 +5,7 @@
   "main": "lib/index.js",
   "types": "src/plugin-ideal-image.d.ts",
   "scripts": {
-    "build": "tsc --build && node ../../admin/scripts/copyUntypedFiles.js && prettier --config ../../.prettierrc --write \"lib/theme/**/*.js\"",
+    "build": "tsc --build && node ../../admin/scripts/copyUntypedFiles.js && oxfmt \"lib/theme/**/*.js\"",
     "watch": "run-p -c copy:watch build:watch",
     "build:watch": "tsc --build --watch",
     "copy:watch": "node ../../admin/scripts/copyUntypedFiles.js --watch"

packages/docusaurus-plugin-ideal-image/src/plugin-ideal-image.d.ts

@@ -118,8 +118,10 @@ declare module '@theme/IdealImageLegacy' {
 
   type ThemeKey = 'placeholder' | 'img' | 'icon' | 'noscript';
 
-  export interface ImageProps
-    extends Omit<ComponentProps<'img'>, 'srcSet' | 'placeholder'> {
+  export interface ImageProps extends Omit<
+    ComponentProps<'img'>,
+    'srcSet' | 'placeholder'
+  > {
     /**
      * This function decides what icon to show based on the current state of the
      * component.