Merge branch 'main' into feat/add-help-create-vite

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -46,6 +46,7 @@ body:
  - npm
  - yarn
  - pnpm
+ - bun
  validations:
  required: true
  - type: textarea

.github/workflows/ci.yml

@@ -39,7 +39,7 @@ jobs:
  strategy:
  matrix:
  os: [ubuntu-latest]
- node_version: [18, 20]
+ node_version: [18, 20, 22]
  include:
  # Active LTS + other OS
  - os: macos-latest
@@ -58,7 +58,7 @@ jobs:
 
  - name: Get changed files
  id: changed-files
- uses: tj-actions/changed-files@2d756ea4c53f7f6b397767d8723b3a10a9f35bf2 # v44.0.0
+ uses: tj-actions/changed-files@d6babd6899969df1a11d14c368283ea4436bca78 # v44.5.2
  with:
  files: |
  docs/**
@@ -69,7 +69,7 @@ jobs:
 
  - name: Install pnpm
  if: steps.changed-files.outputs.only_changed != 'true'
- uses: pnpm/action-setup@v3.0.0
+ uses: pnpm/action-setup@v4.0.0
 
  - name: Set node version to ${{ matrix.node_version }}
  if: steps.changed-files.outputs.only_changed != 'true'
@@ -134,7 +134,7 @@ jobs:
  - uses: actions/checkout@v4
 
  - name: Install pnpm
- uses: pnpm/action-setup@v3.0.0
+ uses: pnpm/action-setup@v4.0.0
 
  - name: Set node version to 20
  uses: actions/setup-node@v4

.github/workflows/publish.yml

@@ -21,7 +21,7 @@ jobs:
  uses: actions/checkout@v4
 
  - name: Install pnpm
- uses: pnpm/action-setup@v3.0.0
+ uses: pnpm/action-setup@v4.0.0
 
  - name: Set node version to 20
  uses: actions/setup-node@v4

.github/workflows/release-tag.yml

@@ -19,6 +19,11 @@ jobs:
  - name: Get pkgName for tag
  id: tag
  run: |
+ # skip if alpha
+ if [[ $GITHUB_REF_NAME =~ alpha ]]; then
+ exit 0
+ fi
+
  # matching v2.0.0 / v2.0.0-beta.8 etc
  if [[ $GITHUB_REF_NAME =~ ^v.+ ]]; then
  pkgName="vite"
@@ -31,6 +36,8 @@ jobs:
  echo "pkgName=$pkgName" >> $GITHUB_OUTPUT
 
  - name: Create Release for Tag
+ # only run if tag is not alpha
+ if: steps.tag.outputs.pkgName
  id: release_tag
  uses: yyx990803/release-tag@master
  env:

.npmrc

@@ -3,3 +3,4 @@ hoist-pattern[]=postcss # package/vite
 hoist-pattern[]=pug # playground/tailwind: @vue/compiler-sfc
 shell-emulator=true
 auto-install-peers=false
+package-manager-strict=false

CONTRIBUTING.md

@@ -31,6 +31,14 @@ To make this file used by `git blame`, you need to run the following command.
 git config --local blame.ignoreRevsFile .git-blame-ignore-revs
 ```
 
+## Documentation
+
+To develop the `docs/` site:
+
+1. Run `pnpm run build` in Vite's root folder. This will generate the types for `twoslash` to work in the code examples. If the types are not available, errors will be logged in step 2 but does not prevent the site from working.
+
+2. Run `pnpm run docs` in Vite's root folder.
+
 ## Debugging
 
 To use breakpoints and explore code execution, you can use the ["Run and Debug"](https://code.visualstudio.com/docs/editor/debugging) feature from VS Code.
@@ -166,7 +174,7 @@ For a mock dependency, make sure you add a `@vitejs/test-` prefix to the package
 
 ## Debug Logging
 
-You can set the `DEBUG` environment variable to turn on debugging logs (e.g. `DEBUG="vite:resolve"`). To see all debug logs, you can set `DEBUG="vite:*"`, but be warned that it will be quite noisy. You can run `grep -r "createDebugger('vite:" packages/vite/src/` to see a list of available debug scopes.
+You can set the `--debug` option to turn on debugging logs (e.g. `vite --debug resolve`). To see all debug logs, you can set `vite --debug *`, but be warned that it will be quite noisy. You can run `grep -r "createDebugger('vite:" packages/vite/src/` to see a list of available debug scopes.
 
 ## Pull Request Guidelines
 

docs/.vitepress/buildEnd.config.ts

@@ -1,12 +1,13 @@
-import path from 'path'
-import { writeFileSync } from 'fs'
+import path from 'node:path'
+import { writeFileSync } from 'node:fs'
 import { Feed } from 'feed'
-import { createContentLoader, type SiteConfig } from 'vitepress'
+import type { SiteConfig } from 'vitepress'
+import { createContentLoader } from 'vitepress'
 
 const siteUrl = 'https://vitejs.dev'
 const blogUrl = `${siteUrl}/blog`
 
-export const buildEnd = async (config: SiteConfig) => {
+export const buildEnd = async (config: SiteConfig): Promise<void> => {
  const feed = new Feed({
  title: 'Vite',
  description: 'Next Generation Frontend Tooling',

docs/.vitepress/config.ts

@@ -1,4 +1,5 @@
-import { defineConfig, DefaultTheme } from 'vitepress'
+import type { DefaultTheme } from 'vitepress'
+import { defineConfig } from 'vitepress'
 import { transformerTwoslash } from '@shikijs/vitepress-twoslash'
 import { buildEnd } from './buildEnd.config'
 
@@ -78,6 +79,7 @@ export default defineConfig({
  ['meta', { property: 'og:image', content: ogImage }],
  ['meta', { property: 'og:url', content: ogUrl }],
  ['meta', { property: 'og:description', content: ogDescription }],
+ ['meta', { property: 'og:site_name', content: 'vitejs' }],
  ['meta', { name: 'twitter:card', content: 'summary_large_image' }],
  ['meta', { name: 'twitter:site', content: '@vite_js' }],
  ['meta', { name: 'theme-color', content: '#646cff' }],
@@ -341,10 +343,10 @@ export default defineConfig({
  .replace(/\/index\.md$/, '/')
  .replace(/\.md$/, '/')
  pageData.frontmatter.head ??= []
- pageData.frontmatter.head.unshift([
- 'link',
- { rel: 'canonical', href: canonicalUrl },
- ])
+ pageData.frontmatter.head.unshift(
+ ['link', { rel: 'canonical', href: canonicalUrl }],
+ ['meta', { property: 'og:title', content: pageData.title }],
+ )
  return pageData
  },
  markdown: {