Merge branch 'main' into fix/service-functions

src/content/docs/en/reference/configuration-reference.mdx

@@ -110,6 +110,25 @@ The value can be either an absolute file system path or a path relative to the p
 - build.server
 
 
+### cacheDir
+
+<p>
+
+**Type:** `string`<br />
+**Default:** `"./node_modules/.astro"`
+</p>
+
+Set the directory for caching build artifacts. Files in this directory will be used in subsequent builds to speed up the build time.
+
+The value can be either an absolute file system path or a path relative to the project root.
+
+```js
+{
+  cacheDir: './my-custom-cache-directory'
+}
+```
+
+
 ### site
 
 <p>
@@ -178,6 +197,23 @@ You can also set this if you prefer to be more strict yourself, so that URLs wit
 - build.format
 
 
+### scopedStyleStrategy
+
+<p>
+
+**Type:** `'where' | 'class'`<br />
+**Default:** `'where'`<br />
+<Since v="2.4" />
+</p>
+
+Specify the strategy used for scoping styles within Astro components. Choose from:
+  - `'where'` - Use `:where` selectors, causing no specifity increase.
+  - `'class'` - Use class-based selectors, causing a +1 specifity increase.
+
+Using `'class'` is helpful when you want to ensure that element selectors within an Astro component override global style defaults (e.g. from a global stylesheet).
+Using `'where'` gives you more control over specifity, but requires that you use higher-specifity selectors, layers, and other tools to control which selectors are applied.
+
+
 ### adapter
 
 <p>
@@ -691,3 +727,45 @@ To enable this feature, set `experimental.assets` to `true` in your Astro config
 }
 
 
+### experimental.inlineStylesheets
+
+<p>
+
+**Type:** `'always' | 'auto' | 'never'`<br />
+**Default:** `never`
+</p>
+
+Control whether styles are sent to the browser in a separate css file or inlined into <style> tags. Choose from the following options:
+ - `'always'` - all styles are inlined into <style> tags
+ - `'auto'` - only stylesheets smaller than `ViteConfig.build.assetsInlineLimit` (default: 4kb) are inlined. Otherwise, styles are sent in external stylesheets.
+ - `'never'` - all styles are sent in external stylesheets
+
+```js
+{
+	experimental: {
+		inlineStylesheets: `auto`,
+	},
+}
+
+
+### experimental.middleware
+
+<p>
+
+**Type:** `boolean`<br />
+**Default:** `false`<br />
+<Since v="2.4.0" />
+</p>
+
+Enable experimental support for Astro middleware.
+
+To enable this feature, set `experimental.middleware` to `true` in your Astro config:
+
+```js
+{
+	experimental: {
+		middleware: true,
+	},
+}
+
+