chore(ci): add Trusted Publishing release workflow through dispatch action

.github/workflows/publish.yml

@@ -1,23 +1,43 @@
 name: Publish
 
 on:
-  workflow_dispatch:
+  # Publish canary on push
   push:
     branches:
       - main
       - docusaurus-v**
+      - slorber/release-workflow-dispatch-action # TODO temporary
     paths:
       - .github/workflows/publish.yml
       - package.json
-      - packages/*
+      - packages/**
+
+  # Publish release on manual dispatch
+  workflow_dispatch:
+    inputs:
+      npm_version:
+        description: 'NPM Version - Including prerelease suffix (optional)'
+        required: true
+        default: 3.0.0-alpha.0
+      npm_tag:
+        type: choice
+        description: 'NPM Dist Tag - Use `latest` for official releases'
+        # default: canary
+        required: true
+        options:
+          - canary
+          - alpha
+          - beta
+          - rc
+          - latest
 
 permissions:
-  contents: read
   id-token: write # For OIDC, see https://docs.npmjs.com/trusted-publishers
+  contents: write # For GitHub tags
 
 jobs:
-  publish-canary:
-    name: Publish Canary
+  publish:
+    name: Publish NPM release
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
@@ -34,16 +54,35 @@ jobs:
           # cache: yarn
       - name: Prepare git
         run: |
-          git config --global user.name "Docusaurus Canary"
-          git config --global user.email "canary@docusaurus.io"
+          git config --global user.name "Docusaurus"
+          git config --global user.email "github@docusaurus.io"
       - name: Installation
         run: yarn || yarn || yarn
         # TODO Docusaurus v4: remove after we upgrade the Node version
       - name: Upgrade Lerna
         run: |
           yarn add -D -W lerna@9.0.3 --ignore-scripts
-          git commit -am "chore: upgrade lerna"
+          git restore .
+
       - name: Publish Canary release
+        if: |
+          github.event_name == 'push' ||
+          (github.event_name == 'workflow_dispatch' && github.event.inputs.npm_tag == 'canary')
         run: |
           yarn canary:bumpVersion
           yarn canary:publish
+
+      - name: Publish NPM release
+        if: |
+          github.event_name == 'workflow_dispatch' &&
+          github.event.inputs.npm_tag != 'canary'
+        run: |
+          yarn lerna publish \
+            --force-publish \
+            --exact \
+            "${{ github.event.inputs.npm_version }}" \
+            --dist-tag "${{ github.event.inputs.npm_tag }}" \
+            --loglevel verbose \
+            --yes \
+            --no-verify-access
+        # TODO Docusaurus v4: upgrade Lerna, remove useless --no-verify-access everywhere

admin/new.docusaurus.io/package.json

@@ -1,6 +1,6 @@
 {
   "name": "new.docusaurus.io",
-  "version": "3.9.2",
+  "version": "3.9.2-alpha.1",
   "private": true,
   "scripts": {
     "start": "npx --package netlify-cli netlify dev"

admin/test-bad-package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "test-bad-package",
-  "version": "3.9.2",
+  "version": "3.9.2-alpha.1",
   "private": true,
   "dependencies": {
     "@mdx-js/react": "1.0.1",

argos/package.json

@@ -1,6 +1,6 @@
 {
   "name": "argos",
-  "version": "3.9.2",
+  "version": "3.9.2-alpha.1",
   "description": "Argos visual diff tests",
   "license": "MIT",
   "private": true,

lerna.json

@@ -1,5 +1,5 @@
 {
-  "version": "3.9.2",
+  "version": "3.9.2-alpha.1",
   "npmClient": "yarn",
   "useNx": false,
   "changelog": {

packages/create-docusaurus/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-docusaurus",
-  "version": "3.9.2",
+  "version": "3.9.2-alpha.1",
   "description": "Create Docusaurus apps easily.",
   "type": "module",
   "repository": {
@@ -22,7 +22,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@docusaurus/logger": "3.9.2",
+    "@docusaurus/logger": "3.9.2-alpha.1",
     "commander": "^5.1.0",
     "cross-spawn": "^7.0.0",
     "prompts": "^2.4.2",

packages/create-docusaurus/templates/classic-typescript/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docusaurus-2-classic-typescript-template",
-  "version": "3.9.2",
+  "version": "3.9.2-alpha.1",
   "private": true,
   "scripts": {
     "docusaurus": "docusaurus",
@@ -15,19 +15,19 @@
     "typecheck": "tsc"
   },
   "dependencies": {
-    "@docusaurus/core": "3.9.2",
-    "@docusaurus/faster": "3.9.2",
-    "@docusaurus/preset-classic": "3.9.2",
+    "@docusaurus/core": "3.9.2-alpha.1",
+    "@docusaurus/faster": "3.9.2-alpha.1",
+    "@docusaurus/preset-classic": "3.9.2-alpha.1",
     "@mdx-js/react": "^3.0.0",
     "clsx": "^2.0.0",
     "prism-react-renderer": "^2.3.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "3.9.2",
-    "@docusaurus/tsconfig": "3.9.2",
-    "@docusaurus/types": "3.9.2",
+    "@docusaurus/module-type-aliases": "3.9.2-alpha.1",
+    "@docusaurus/tsconfig": "3.9.2-alpha.1",
+    "@docusaurus/types": "3.9.2-alpha.1",
     "@types/react": "^19.0.0",
     "typescript": "~5.6.2"
   },

packages/create-docusaurus/templates/classic/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docusaurus-2-classic-template",
-  "version": "3.9.2",
+  "version": "3.9.2-alpha.1",
   "private": true,
   "scripts": {
     "docusaurus": "docusaurus",
@@ -14,18 +14,18 @@
     "write-heading-ids": "docusaurus write-heading-ids"
   },
   "dependencies": {
-    "@docusaurus/core": "3.9.2",
-    "@docusaurus/faster": "3.9.2",
-    "@docusaurus/preset-classic": "3.9.2",
+    "@docusaurus/core": "3.9.2-alpha.1",
+    "@docusaurus/faster": "3.9.2-alpha.1",
+    "@docusaurus/preset-classic": "3.9.2-alpha.1",
     "@mdx-js/react": "^3.0.0",
     "clsx": "^2.0.0",
     "prism-react-renderer": "^2.3.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "3.9.2",
-    "@docusaurus/types": "3.9.2"
+    "@docusaurus/module-type-aliases": "3.9.2-alpha.1",
+    "@docusaurus/types": "3.9.2-alpha.1"
   },
   "browserslist": {
     "production": [

packages/docusaurus-babel/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/babel",
-  "version": "3.9.2",
+  "version": "3.9.2-alpha.1",
   "description": "Docusaurus package for Babel-related utils.",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -37,8 +37,8 @@
     "@babel/preset-typescript": "^7.25.9",
     "@babel/runtime": "^7.25.9",
     "@babel/traverse": "^7.25.9",
-    "@docusaurus/logger": "3.9.2",
-    "@docusaurus/utils": "3.9.2",
+    "@docusaurus/logger": "3.9.2-alpha.1",
+    "@docusaurus/utils": "3.9.2-alpha.1",
     "babel-plugin-dynamic-import-node": "^2.3.3",
     "fs-extra": "^11.1.1",
     "tslib": "^2.6.0"

packages/docusaurus-bundler/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/bundler",
-  "version": "3.9.2",
+  "version": "3.9.2-alpha.1",
   "description": "Docusaurus util package to abstract the current bundler.",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -19,11 +19,11 @@
   "license": "MIT",
   "dependencies": {
     "@babel/core": "^7.25.9",
-    "@docusaurus/babel": "3.9.2",
-    "@docusaurus/cssnano-preset": "3.9.2",
-    "@docusaurus/logger": "3.9.2",
-    "@docusaurus/types": "3.9.2",
-    "@docusaurus/utils": "3.9.2",
+    "@docusaurus/babel": "3.9.2-alpha.1",
+    "@docusaurus/cssnano-preset": "3.9.2-alpha.1",
+    "@docusaurus/logger": "3.9.2-alpha.1",
+    "@docusaurus/types": "3.9.2-alpha.1",
+    "@docusaurus/utils": "3.9.2-alpha.1",
     "babel-loader": "^9.2.1",
     "clean-css": "^5.3.3",
     "copy-webpack-plugin": "^11.0.0",

packages/docusaurus-cssnano-preset/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/cssnano-preset",
-  "version": "3.9.2",
+  "version": "3.9.2-alpha.1",
   "description": "Advanced cssnano preset for maximum optimization.",
   "main": "lib/index.js",
   "license": "MIT",

packages/docusaurus-faster/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/faster",
-  "version": "3.9.2",
+  "version": "3.9.2-alpha.1",
   "description": "Docusaurus experimental package exposing new modern dependencies to make the build faster.",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -18,7 +18,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@docusaurus/types": "3.9.2",
+    "@docusaurus/types": "3.9.2-alpha.1",
     "@rspack/core": "^1.7.5",
     "@swc/core": "^1.7.39",
     "@swc/html": "^1.13.5",

packages/docusaurus-logger/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/logger",
-  "version": "3.9.2",
+  "version": "3.9.2-alpha.1",
   "description": "An encapsulated logger for semantically formatting console messages.",
   "main": "./lib/index.js",
   "repository": {

packages/docusaurus-mdx-loader/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/mdx-loader",
-  "version": "3.9.2",
+  "version": "3.9.2-alpha.1",
   "description": "Docusaurus Loader for MDX",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -18,9 +18,9 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@docusaurus/logger": "3.9.2",
-    "@docusaurus/utils": "3.9.2",
-    "@docusaurus/utils-validation": "3.9.2",
+    "@docusaurus/logger": "3.9.2-alpha.1",
+    "@docusaurus/utils": "3.9.2-alpha.1",
+    "@docusaurus/utils-validation": "3.9.2-alpha.1",
     "@mdx-js/mdx": "^3.0.0",
     "@slorber/remark-comment": "^1.0.0",
     "escape-html": "^1.0.3",
@@ -44,7 +44,7 @@
     "webpack": "^5.88.1"
   },
   "devDependencies": {
-    "@docusaurus/types": "3.9.2",
+    "@docusaurus/types": "3.9.2-alpha.1",
     "@types/escape-html": "^1.0.2",
     "@types/mdast": "^4.0.2",
     "@types/stringify-object": "^3.3.1",

packages/docusaurus-module-type-aliases/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/module-type-aliases",
-  "version": "3.9.2",
+  "version": "3.9.2-alpha.1",
   "description": "Docusaurus module type aliases.",
   "types": "./src/index.d.ts",
   "publishConfig": {
@@ -12,7 +12,7 @@
     "directory": "packages/docusaurus-module-type-aliases"
   },
   "dependencies": {
-    "@docusaurus/types": "3.9.2",
+    "@docusaurus/types": "3.9.2-alpha.1",
     "@types/history": "^4.7.11",
     "@types/react": "*",
     "@types/react-router-config": "*",

packages/docusaurus-plugin-client-redirects/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/plugin-client-redirects",
-  "version": "3.9.2",
+  "version": "3.9.2-alpha.1",
   "description": "Client redirects plugin for Docusaurus.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -18,18 +18,18 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@docusaurus/core": "3.9.2",
-    "@docusaurus/logger": "3.9.2",
-    "@docusaurus/utils": "3.9.2",
-    "@docusaurus/utils-common": "3.9.2",
-    "@docusaurus/utils-validation": "3.9.2",
+    "@docusaurus/core": "3.9.2-alpha.1",
+    "@docusaurus/logger": "3.9.2-alpha.1",
+    "@docusaurus/utils": "3.9.2-alpha.1",
+    "@docusaurus/utils-common": "3.9.2-alpha.1",
+    "@docusaurus/utils-validation": "3.9.2-alpha.1",
     "eta": "^2.2.0",
     "fs-extra": "^11.1.1",
     "lodash": "^4.17.21",
     "tslib": "^2.6.0"
   },
   "devDependencies": {
-    "@docusaurus/types": "3.9.2"
+    "@docusaurus/types": "3.9.2-alpha.1"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",

packages/docusaurus-plugin-content-blog/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docusaurus/plugin-content-blog",
-  "version": "3.9.2",
+  "version": "3.9.2-alpha.1",
   "description": "Blog plugin for Docusaurus.",
   "main": "lib/index.js",
   "types": "src/plugin-content-blog.d.ts",
@@ -31,14 +31,14 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@docusaurus/core": "3.9.2",
-    "@docusaurus/logger": "3.9.2",
-    "@docusaurus/mdx-loader": "3.9.2",
-    "@docusaurus/theme-common": "3.9.2",
-    "@docusaurus/types": "3.9.2",
-    "@docusaurus/utils": "3.9.2",
-    "@docusaurus/utils-common": "3.9.2",
-    "@docusaurus/utils-validation": "3.9.2",
+    "@docusaurus/core": "3.9.2-alpha.1",
+    "@docusaurus/logger": "3.9.2-alpha.1",
+    "@docusaurus/mdx-loader": "3.9.2-alpha.1",
+    "@docusaurus/theme-common": "3.9.2-alpha.1",
+    "@docusaurus/types": "3.9.2-alpha.1",
+    "@docusaurus/utils": "3.9.2-alpha.1",
+    "@docusaurus/utils-common": "3.9.2-alpha.1",
+    "@docusaurus/utils-validation": "3.9.2-alpha.1",
     "cheerio": "1.0.0-rc.12",
     "combine-promises": "^1.1.0",
     "feed": "^4.2.2",