Files
T
TrueCharts Bot dc156243c6 fix(website): update astro monorepo (minor) (#33412 )
This PR contains the following updates:

| Package | Type | Update | Change |
|---|---|---|---|
|
[@astrojs/sitemap](https://docs.astro.build/en/guides/integrations-guide/sitemap/)
([source](https://redirect.github.com/withastro/astro/tree/HEAD/packages/integrations/sitemap))
| dependencies | minor | [`3.2.1` ->
`3.3.0`](https://renovatebot.com/diffs/npm/@astrojs%2fsitemap/3.2.1/3.3.0)
|
| [astro](https://astro.build)
([source](https://redirect.github.com/withastro/astro/tree/HEAD/packages/astro))
| dependencies | minor | [`5.5.2` ->
`5.5.3`](https://renovatebot.com/diffs/npm/astro/5.2.6/5.5.3) |

---

> [!WARNING]
> Some dependencies could not be looked up. Check the Dependency
Dashboard for more information.

Add the preset `:preserveSemverRanges` to your config if you don't want
to pin your dependencies.

---

### Release Notes

<details>
<summary>withastro/astro (@&#8203;astrojs/sitemap)</summary>

###
[`v3.3.0`](https://redirect.github.com/withastro/astro/blob/HEAD/packages/integrations/sitemap/CHANGELOG.md#330)

##### Minor Changes

-
[#&#8203;13448](https://redirect.github.com/withastro/astro/pull/13448)
[`91c9503`](https://redirect.github.com/withastro/astro/commit/91c95034e0d0bd450170623fd8aab4b56b5b1366)
Thanks [@&#8203;ematipico](https://redirect.github.com/ematipico)! - Add
support for XSL in sitemap-index.xml

</details>

<details>
<summary>withastro/astro (astro)</summary>

###
[`v5.5.3`](https://redirect.github.com/withastro/astro/blob/HEAD/packages/astro/CHANGELOG.md#553)

[Compare
Source](https://redirect.github.com/withastro/astro/compare/astro@5.5.2...astro@5.5.3)

##### Patch Changes

-
[#&#8203;13437](https://redirect.github.com/withastro/astro/pull/13437)
[`013fa87`](https://redirect.github.com/withastro/astro/commit/013fa87982ea92675e899d2f71a200e5298db608)
Thanks [@&#8203;Vardhaman619](https://redirect.github.com/Vardhaman619)!
- Handle server.allowedHosts when the value is true without attempting
to push it into an array.

-
[#&#8203;13324](https://redirect.github.com/withastro/astro/pull/13324)
[`ea74336`](https://redirect.github.com/withastro/astro/commit/ea7433666e0cc7e1301e638e80f90323f20db3e1)
Thanks [@&#8203;ematipico](https://redirect.github.com/ematipico)! -
Upgrade to shiki v3

-
[#&#8203;13372](https://redirect.github.com/withastro/astro/pull/13372)
[`7783dbf`](https://redirect.github.com/withastro/astro/commit/7783dbf8117650c60d7633b43f0d42da487aa2b1)
Thanks [@&#8203;ascorbic](https://redirect.github.com/ascorbic)! - Fixes
a bug that caused some very large data stores to save incomplete data.

-
[#&#8203;13358](https://redirect.github.com/withastro/astro/pull/13358)
[`8c21663`](https://redirect.github.com/withastro/astro/commit/8c21663c4a6363765f2caa5705a93a41492a95c9)
Thanks [@&#8203;ematipico](https://redirect.github.com/ematipico)! -
Adds a new function called `insertPageRoute` to the Astro Container API.

The new function is useful when testing routes that, for some business
logic, use `Astro.rewrite`.

For example, if you have a route `/blog/post` and for some business
decision there's a rewrite to `/generic-error`, the container API
implementation will look like this:

    ```js
    import Post from '../src/pages/Post.astro';
    import GenericError from '../src/pages/GenericError.astro';
import { experimental_AstroContainer as AstroContainer } from
'astro/container';

    const container = await AstroContainer.create();
    container.insertPageRoute('/generic-error', GenericError);
    const result = await container.renderToString(Post);
console.log(result); // this should print the response from
GenericError.astro
    ```

This new method only works for page routes, which means that endpoints
aren't supported.

-
[#&#8203;13426](https://redirect.github.com/withastro/astro/pull/13426)
[`565583b`](https://redirect.github.com/withastro/astro/commit/565583bd6c99163ce5d9475b26075149cc8c155b)
Thanks [@&#8203;ascorbic](https://redirect.github.com/ascorbic)! - Fixes
a bug that caused the `astro add` command to ignore the `--yes` flag for
third-party integrations

-
[#&#8203;13428](https://redirect.github.com/withastro/astro/pull/13428)
[`9cac9f3`](https://redirect.github.com/withastro/astro/commit/9cac9f314277def0ee584e45d4937bac0235738a)
Thanks [@&#8203;matthewp](https://redirect.github.com/matthewp)! -
Prevent bad value in x-forwarded-host from crashing request

-
[#&#8203;13432](https://redirect.github.com/withastro/astro/pull/13432)
[`defad33`](https://redirect.github.com/withastro/astro/commit/defad33140dccde324b9357bc6331f7e5cdec266)
Thanks [@&#8203;P4tt4te](https://redirect.github.com/P4tt4te)! - Fix an
issue in the Container API, where the `renderToString` function doesn't
render adequately nested slots when they are components.

- Updated dependencies
\[[`ea74336`](https://redirect.github.com/withastro/astro/commit/ea7433666e0cc7e1301e638e80f90323f20db3e1)]:
-
[@&#8203;astrojs/markdown-remark](https://redirect.github.com/astrojs/markdown-remark)[@&#8203;6](https://redirect.github.com/6).3.1

###
[`v5.5.2`](https://redirect.github.com/withastro/astro/blob/HEAD/packages/astro/CHANGELOG.md#552)

[Compare
Source](https://redirect.github.com/withastro/astro/compare/astro@5.5.1...astro@5.5.2)

##### Patch Changes

-
[#&#8203;13415](https://redirect.github.com/withastro/astro/pull/13415)
[`be866a1`](https://redirect.github.com/withastro/astro/commit/be866a1d1db12793e0953b228d0b2dc1c00929e2)
Thanks [@&#8203;ascorbic](https://redirect.github.com/ascorbic)! -
Reuses experimental session storage object between requests. This
prevents memory leaks and improves performance for drivers that open
persistent connections to a database.

-
[#&#8203;13420](https://redirect.github.com/withastro/astro/pull/13420)
[`2f039b9`](https://redirect.github.com/withastro/astro/commit/2f039b927a3a1334948adc7788b1f24c074dfac7)
Thanks [@&#8203;ematipico](https://redirect.github.com/ematipico)! - It
fixes an issue that caused some regressions in how styles are bundled.

###
[`v5.5.1`](https://redirect.github.com/withastro/astro/blob/HEAD/packages/astro/CHANGELOG.md#551)

[Compare
Source](https://redirect.github.com/withastro/astro/compare/astro@5.5.0...astro@5.5.1)

##### Patch Changes

-
[#&#8203;13413](https://redirect.github.com/withastro/astro/pull/13413)
[`65903c9`](https://redirect.github.com/withastro/astro/commit/65903c995408397c63c911e184218c0206e5853f)
Thanks [@&#8203;ascorbic](https://redirect.github.com/ascorbic)! - Makes
experimental flag optional

###
[`v5.5.0`](https://redirect.github.com/withastro/astro/blob/HEAD/packages/astro/CHANGELOG.md#550)

[Compare
Source](https://redirect.github.com/withastro/astro/compare/astro@5.4.3...astro@5.5.0)

##### Minor Changes

-
[#&#8203;13402](https://redirect.github.com/withastro/astro/pull/13402)
[`3e7b498`](https://redirect.github.com/withastro/astro/commit/3e7b498dce52648484bb4deb04bf9e960c3d08e3)
Thanks [@&#8203;ematipico](https://redirect.github.com/ematipico)! -
Adds a new experimental flag called `experimental.preserveScriptOrder`
that renders `<script>` and `<style>` tags in the same order as they are
defined.

When rendering multiple `<style>` and `<script>` tags on the same page,
Astro currently reverses their order in your generated HTML output. This
can give unexpected results, for example CSS styles being overridden by
earlier defined style tags when your site is built.

With the new `preserveScriptOrder` flag enabled, Astro will generate the
styles in the order they are defined:

    ```js title="astro.config.mjs"
    import { defineConfig } from 'astro/config';

    export default defineConfig({
      experimental: {
        preserveScriptOrder: true,
      },
    });
    ```

For example, the following component has two `<style>` tags, and both
define the same style for the `body` tag:

    ```html
    <p>I am a component</p>
    <style>
      body {
        background: red;
      }
    </style>
    <style>
      body {
        background: yellow;
      }
    </style>
    ```

Once the project is compiled, Astro will create an inline style where
`yellow` appears first, and then `red`. Ultimately, the `red` background
is applied:

    ```css
    body {
      background: #ff0;
    }
    body {
      background: red;
    }
    ```

When `experimental.preserveScriptOrder` is set to `true`, the order of
the two styles is kept as it is, and in the style generated `red`
appears first, and then `yellow`:

    ```css
    body {
      background: red;
    }
    body {
      background: #ff0;
    }
    ```

This is a breaking change to how Astro renders project code that
contains multiple `<style>` and `<script>` tags in the same component.
If you were previously compensating for Astro's behavior by writing
these out of order, you will need to update your code.

This will eventually become the new default Astro behavior, so we
encourage you to add this experimental style and script ordering as soon
as you are able! This will help us test the new behavior and ensure your
code is ready when this becomes the new normal.

For more information as this feature develops, please see the
[experimental script order
docs](https://docs.astro.build/en/reference/experimental-flags/preserve-script-order/).

-
[#&#8203;13352](https://redirect.github.com/withastro/astro/pull/13352)
[`cb886dc`](https://redirect.github.com/withastro/astro/commit/cb886dcde6c28acca286a66be46228a4d4cc52e7)
Thanks [@&#8203;delucis](https://redirect.github.com/delucis)! - Adds
support for a new `experimental.headingIdCompat` flag

By default, Astro removes a trailing `-` from the end of IDs it
generates for headings ending with
special characters. This differs from the behavior of common Markdown
processors.

    You can now disable this behavior with a new configuration flag:

    ```js
    // astro.config.mjs
    import { defineConfig } from 'astro/config';

    export default defineConfig({
      experimental: {
        headingIdCompat: true,
      },
    });
    ```

This can be useful when heading IDs and anchor links need to behave
consistently across your site
    and other platforms such as GitHub and npm.

If you are [using the `rehypeHeadingIds` plugin
directly](https://docs.astro.build/en/guides/markdown-content/#heading-ids-and-plugins),
you can also pass this new option:

    ```js
    // astro.config.mjs
    import { defineConfig } from 'astro/config';
    import { rehypeHeadingIds } from '@&#8203;astrojs/markdown-remark';
import { otherPluginThatReliesOnHeadingIDs } from 'some/plugin/source';

    export default defineConfig({
      markdown: {
        rehypePlugins: [
          [rehypeHeadingIds, { experimentalHeadingIdCompat: true }],
          otherPluginThatReliesOnHeadingIDs,
        ],
      },
    });
    ```

-
[#&#8203;13311](https://redirect.github.com/withastro/astro/pull/13311)
[`a3327ff`](https://redirect.github.com/withastro/astro/commit/a3327ffbe6373228339824684eaa6f340a20a32e)
Thanks [@&#8203;chrisirhc](https://redirect.github.com/chrisirhc)! -
Adds a new configuration option for Markdown syntax highlighting
`excludeLangs`

This option provides better support for diagramming tools that rely on
Markdown code blocks, such as Mermaid.js and D2 by allowing you to
exclude specific languages from Astro's default syntax highlighting.

This option allows you to avoid rendering conflicts with tools that
depend on the code not being highlighted without forcing you to disable
syntax highlighting for other code blocks.

The following example configuration will exclude highlighting for
`mermaid` and `math` code blocks:

    ```js
    import { defineConfig } from 'astro/config';

    export default defineConfig({
      markdown: {
        syntaxHighlight: {
          type: 'shiki',
          excludeLangs: ['mermaid', 'math'],
        },
      },
    });
    ```

Read more about this new option in the [Markdown syntax highlighting
configuration
docs](https://docs.astro.build/en/reference/configuration-reference/#markdownsyntaxhighlight).

##### Patch Changes

-
[#&#8203;13404](https://redirect.github.com/withastro/astro/pull/13404)
[`4e78b4d`](https://redirect.github.com/withastro/astro/commit/4e78b4d10d2214c94752a1fef74db325053cf071)
Thanks [@&#8203;ascorbic](https://redirect.github.com/ascorbic)! - Fixes
a bug in error handling that saving a content file with a schema error
would display an "unhandled rejection" error instead of the correct
schema error

-
[#&#8203;13379](https://redirect.github.com/withastro/astro/pull/13379)
[`d59eb22`](https://redirect.github.com/withastro/astro/commit/d59eb227334b788289533bac41f015b498179a2f)
Thanks [@&#8203;martrapp](https://redirect.github.com/martrapp)! - Fixes
an edge case where the client router executed scripts twice when used
with a custom swap function that only swaps parts of the DOM.

-
[#&#8203;13393](https://redirect.github.com/withastro/astro/pull/13393)
[`6b8fdb8`](https://redirect.github.com/withastro/astro/commit/6b8fdb8a113b6f76448b41beb990c33fafb09b3e)
Thanks [@&#8203;renovate](https://redirect.github.com/apps/renovate)! -
Updates `primsjs` to version 1.30.0, which adds support for more
languages and fixes a security advisory which does not affect Astro.

-
[#&#8203;13374](https://redirect.github.com/withastro/astro/pull/13374)
[`7b75bc5`](https://redirect.github.com/withastro/astro/commit/7b75bc5c36bc338bcef5ef41502e87c184c117ec)
Thanks
[@&#8203;ArmandPhilippot](https://redirect.github.com/ArmandPhilippot)!
- Fixes the documentation of the i18n configuration where `manual` was
presented as a key of `routing` instead of an available value.

-
[#&#8203;13380](https://redirect.github.com/withastro/astro/pull/13380)
[`9bfa6e6`](https://redirect.github.com/withastro/astro/commit/9bfa6e6d8b95424436be405a80d5df3f2e2e72df)
Thanks [@&#8203;martrapp](https://redirect.github.com/martrapp)! - Fixes
an issue where astro:page-load fires before all scripts are executed

-
[#&#8203;13407](https://redirect.github.com/withastro/astro/pull/13407)
[`0efdc22`](https://redirect.github.com/withastro/astro/commit/0efdc22b182f6cec4155a972f0dde1da686c5453)
Thanks [@&#8203;ascorbic](https://redirect.github.com/ascorbic)! -
Displays correct error message when sharp isn't installed

- Updated dependencies
\[[`cb886dc`](https://redirect.github.com/withastro/astro/commit/cb886dcde6c28acca286a66be46228a4d4cc52e7),
[`a3327ff`](https://redirect.github.com/withastro/astro/commit/a3327ffbe6373228339824684eaa6f340a20a32e)]:
-
[@&#8203;astrojs/markdown-remark](https://redirect.github.com/astrojs/markdown-remark)[@&#8203;6](https://redirect.github.com/6).3.0

###
[`v5.4.3`](https://redirect.github.com/withastro/astro/blob/HEAD/packages/astro/CHANGELOG.md#543)

[Compare
Source](https://redirect.github.com/withastro/astro/compare/astro@5.4.2...astro@5.4.3)

##### Patch Changes

-
[#&#8203;13381](https://redirect.github.com/withastro/astro/pull/13381)
[`249d52a`](https://redirect.github.com/withastro/astro/commit/249d52a3ff17f792c451ea0e42b97a209667290c)
Thanks [@&#8203;martrapp](https://redirect.github.com/martrapp)! - Adds
the `types` property to the viewTransition object when the ClientRouter
simulates parts of the View Transition API on browsers w/o native
support.

-
[#&#8203;13367](https://redirect.github.com/withastro/astro/pull/13367)
[`3ce4ad9`](https://redirect.github.com/withastro/astro/commit/3ce4ad965f576f2f4c53b5f2b876d449ed60c023)
Thanks [@&#8203;ematipico](https://redirect.github.com/ematipico)! -
Adds documentation to various utility functions used for remote image
services

-
[#&#8203;13347](https://redirect.github.com/withastro/astro/pull/13347)
[`d83f92a`](https://redirect.github.com/withastro/astro/commit/d83f92a20403ffc8d088cfd13d2806e0f4f1a11e)
Thanks [@&#8203;bluwy](https://redirect.github.com/bluwy)! - Updates
internal CSS chunking behavior for Astro components' scoped styles. This
may result in slightly more CSS chunks created, but should allow the
scoped styles to only be included on pages that use them.

-
[#&#8203;13388](https://redirect.github.com/withastro/astro/pull/13388)
[`afadc70`](https://redirect.github.com/withastro/astro/commit/afadc702d7d928e7b650d3c071cca3d21e14333f)
Thanks [@&#8203;ematipico](https://redirect.github.com/ematipico)! -
Fixes a bug where `astro:config/server` and `astro:config/client` had
incorrect types.

-
[#&#8203;13355](https://redirect.github.com/withastro/astro/pull/13355)
[`042d1de`](https://redirect.github.com/withastro/astro/commit/042d1de901fd9aa66157ce078b28bcd9786e1373)
Thanks [@&#8203;ematipico](https://redirect.github.com/ematipico)! -
Adds documentation to the assets utilities for remote service images.

-
[#&#8203;13395](https://redirect.github.com/withastro/astro/pull/13395)
[`6d1c63f`](https://redirect.github.com/withastro/astro/commit/6d1c63fa46a624b1c4981d4324ebabf37cc2b958)
Thanks [@&#8203;bluwy](https://redirect.github.com/bluwy)! - Uses
`package-manager-detector` to detect the package manager used in the
project

-
[#&#8203;13363](https://redirect.github.com/withastro/astro/pull/13363)
[`a793636`](https://redirect.github.com/withastro/astro/commit/a793636928d0014a7faa4431afdfb9404e9ea819)
Thanks [@&#8203;ematipico](https://redirect.github.com/ematipico)! -
Fixes an issue where the internal function `makeSvgComponent` was
incorrectly exposed as a public API.

- Updated dependencies
\[[`042d1de`](https://redirect.github.com/withastro/astro/commit/042d1de901fd9aa66157ce078b28bcd9786e1373)]:
-
[@&#8203;astrojs/internal-helpers](https://redirect.github.com/astrojs/internal-helpers)[@&#8203;0](https://redirect.github.com/0).6.1
-
[@&#8203;astrojs/markdown-remark](https://redirect.github.com/astrojs/markdown-remark)[@&#8203;6](https://redirect.github.com/6).2.1

###
[`v5.4.2`](https://redirect.github.com/withastro/astro/blob/HEAD/packages/astro/CHANGELOG.md#542)

[Compare
Source](https://redirect.github.com/withastro/astro/compare/astro@5.4.1...astro@5.4.2)

##### Patch Changes

-
[#&#8203;12985](https://redirect.github.com/withastro/astro/pull/12985)
[`84e94cc`](https://redirect.github.com/withastro/astro/commit/84e94cc85cc0f4ea9b5dba2009dc89e83a798f59)
Thanks [@&#8203;matthewp](https://redirect.github.com/matthewp)! -
Prevent re-executing scripts in client router

-
[#&#8203;13349](https://redirect.github.com/withastro/astro/pull/13349)
[`50e2e0b`](https://redirect.github.com/withastro/astro/commit/50e2e0b3749d6dba3d301ea1a0a3a33a273e7a81)
Thanks [@&#8203;ascorbic](https://redirect.github.com/ascorbic)! -
Correctly escapes attributes in Markdown images

-
[#&#8203;13262](https://redirect.github.com/withastro/astro/pull/13262)
[`0025df3`](https://redirect.github.com/withastro/astro/commit/0025df37af4dcd390d41c9b175fbdb3edd87edf7)
Thanks [@&#8203;ematipico](https://redirect.github.com/ematipico)! -
Refactor Astro Actions to not use a middleware. Doing so should avoid
unexpected issues when using the Astro middleware at the edge.

###
[`v5.4.1`](https://redirect.github.com/withastro/astro/blob/HEAD/packages/astro/CHANGELOG.md#541)

[Compare
Source](https://redirect.github.com/withastro/astro/compare/astro@5.4.0...astro@5.4.1)

##### Patch Changes

-
[#&#8203;13336](https://redirect.github.com/withastro/astro/pull/13336)
[`8f632ef`](https://redirect.github.com/withastro/astro/commit/8f632efe9934fbe7547d890fd01b3892d14c8189)
Thanks [@&#8203;ematipico](https://redirect.github.com/ematipico)! -
Fixes a regression where some asset utilities were move across monorepo,
and not re-exported anymore.

-
[#&#8203;13320](https://redirect.github.com/withastro/astro/pull/13320)
[`b5dabe9`](https://redirect.github.com/withastro/astro/commit/b5dabe9878510237ceb603ebd3e004da6e965a26)
Thanks [@&#8203;{](https://redirect.github.com/{)! - Adds support for
typing experimental session data

You can add optional types to your session data by creating a
`src/env.d.ts` file in your project that extends the global
`App.SessionData` interface. For example:

    ```ts
    declare namespace App {
      interface SessionData {

          id: string;
          email: string;
        };
        lastLogin: Date;
      }
    }
    ```

    Any keys not defined in this interface will be treated as `any`.

Then when you access `Astro.session` in your components, any defined
keys will be typed correctly:

###
[`v5.4.0`](https://redirect.github.com/withastro/astro/blob/HEAD/packages/astro/CHANGELOG.md#540)

[Compare
Source](https://redirect.github.com/withastro/astro/compare/astro@5.3.1...astro@5.4.0)

##### Minor Changes

-
[#&#8203;12052](https://redirect.github.com/withastro/astro/pull/12052)
[`5be12b2`](https://redirect.github.com/withastro/astro/commit/5be12b2bc9f359d3ecfa29b766f13ed2aabd119f)
Thanks [@&#8203;Fryuni](https://redirect.github.com/Fryuni)! - Exposes
extra APIs for scripting and testing.

##### Config helpers

Two new helper functions exported from `astro/config`:

- `mergeConfig()` allows users to merge partially defined Astro
configurations on top of a base config while following the merge rules
of `updateConfig()` available for integrations.
- `validateConfig()` allows users to validate that a given value is a
valid Astro configuration and fills in default values as necessary.

These helpers are particularly useful for integration authors and for
developers writing scripts that need to manipulate Astro configurations
programmatically.

##### Programmatic build

The `build` API now receives a second optional `BuildOptions` argument
where users can specify:

- `devOutput` (default `false`): output a development-based build
similar to code transformed in `astro dev`.
- `teardownCompiler` (default `true`): teardown the compiler WASM
instance after build.

These options provide more control when running Astro builds
programmatically, especially for testing scenarios or custom build
pipelines.

-
[#&#8203;13278](https://redirect.github.com/withastro/astro/pull/13278)
[`4a43c4b`](https://redirect.github.com/withastro/astro/commit/4a43c4b743affb78b1502801c797157b626c77a1)
Thanks [@&#8203;ematipico](https://redirect.github.com/ematipico)! -
Adds a new configuration option `server.allowedHosts` and CLI option
`--allowed-hosts`.

Now you can specify the hostnames that the dev and preview servers are
allowed to respond to. This is useful for allowing additional
subdomains, or running the dev server in a web container.

`allowedHosts` checks the Host header on HTTP requests from browsers and
if it doesn't match, it will reject the request to prevent CSRF and XSS
attacks.

    ```shell
    astro dev --allowed-hosts=foo.bar.example.com,bar.example.com
    ```

    ```shell
    astro preview --allowed-hosts=foo.bar.example.com,bar.example.com
    ```

    ```js
    // astro.config.mjs
    import { defineConfig } from 'astro/config';

    export default defineConfig({
      server: {
        allowedHosts: ['foo.bar.example.com', 'bar.example.com'],
      },
    });
    ```

This feature is the same as [Vite's `server.allowHosts`
configuration](https://vite.dev/config/server-options.html#server-allowedhosts).

-
[#&#8203;13254](https://redirect.github.com/withastro/astro/pull/13254)
[`1e11f5e`](https://redirect.github.com/withastro/astro/commit/1e11f5e8b722b179e382f3c792cd961b2b51f61b)
Thanks [@&#8203;p0lyw0lf](https://redirect.github.com/p0lyw0lf)! - Adds
the ability to process and optimize remote images in Markdown files

Previously, Astro only allowed local images to be optimized when
included using `![]()` syntax in plain Markdown files. Astro's image
service could only display remote images without any processing.

Now, Astro's image service can also optimize remote images written in
standard Markdown syntax. This allows you to enjoy the benefits of
Astro's image processing when your images are stored externally, for
example in a CMS or digital asset manager.

No additional configuration is required to use this feature! Any
existing remote images written in Markdown will now automatically be
optimized. To opt-out of this processing, write your images in Markdown
using the HTML `<img>` tag instead. Note that images located in your
`public/` folder are still never processed.

##### Patch Changes

-
[#&#8203;13256](https://redirect.github.com/withastro/astro/pull/13256)
[`509fa67`](https://redirect.github.com/withastro/astro/commit/509fa671a137515bd1818c81ee78de439a27e5dc)
Thanks [@&#8203;p0lyw0lf](https://redirect.github.com/p0lyw0lf)! - Adds
experimental responsive image support in Markdown

Previously, the `experimental.responsiveImages` feature could only
provide responsive images when using the `<Image />` and `<Picture />`
components.

Now, images written with the `![]()` Markdown syntax in Markdown and MDX
files will generate responsive images by default when using this
experimental feature.

To try this experimental feature, set `experimental.responsiveImages` to
true in your `astro.config.mjs` file:

    ```js
    {
       experimental: {
          responsiveImages: true,
       },
    }
    ```

Learn more about using this feature in the [experimental responsive
images feature
reference](https://docs.astro.build/en/reference/experimental-flags/responsive-images/).

For a complete overview, and to give feedback on this experimental API,
see the [Responsive Images
RFC](https://redirect.github.com/withastro/roadmap/blob/responsive-images/proposals/0053-responsive-images.md).

-
[#&#8203;13323](https://redirect.github.com/withastro/astro/pull/13323)
[`80926fa`](https://redirect.github.com/withastro/astro/commit/80926fadc06492fcae55f105582b9dc8279da6b3)
Thanks [@&#8203;ematipico](https://redirect.github.com/ematipico)! -
Updates `esbuild` and `vite` to the latest to avoid false positives
audits warnings caused by `esbuild`.

-
[#&#8203;13313](https://redirect.github.com/withastro/astro/pull/13313)
[`9e7c71d`](https://redirect.github.com/withastro/astro/commit/9e7c71d19c89407d9b27ded85d8c0fde238ce16c)
Thanks [@&#8203;martrapp](https://redirect.github.com/martrapp)! - Fixes
an issue where a form field named "attributes" shadows the
form.attributes property.

-
[#&#8203;12052](https://redirect.github.com/withastro/astro/pull/12052)
[`5be12b2`](https://redirect.github.com/withastro/astro/commit/5be12b2bc9f359d3ecfa29b766f13ed2aabd119f)
Thanks [@&#8203;Fryuni](https://redirect.github.com/Fryuni)! - Fixes
incorrect config update when calling `updateConfig` from
`astro:build:setup` hook.

The function previously called a custom update config function made for
merging an Astro config. Now it calls the appropriate `mergeConfig()`
utility exported by Vite that updates functional options correctly.

-
[#&#8203;13303](https://redirect.github.com/withastro/astro/pull/13303)
[`5f72a58`](https://redirect.github.com/withastro/astro/commit/5f72a58935d9bdd5237bdf86d2e94bcdc544c7b3)
Thanks [@&#8203;ematipico](https://redirect.github.com/ematipico)! -
Fixes an issue where the dev server was applying second decoding of the
URL of the incoming request, causing issues for certain URLs.

- Updated dependencies
\[[`1e11f5e`](https://redirect.github.com/withastro/astro/commit/1e11f5e8b722b179e382f3c792cd961b2b51f61b),
[`1e11f5e`](https://redirect.github.com/withastro/astro/commit/1e11f5e8b722b179e382f3c792cd961b2b51f61b)]:
-
[@&#8203;astrojs/internal-helpers](https://redirect.github.com/astrojs/internal-helpers)[@&#8203;0](https://redirect.github.com/0).6.0
-
[@&#8203;astrojs/markdown-remark](https://redirect.github.com/astrojs/markdown-remark)[@&#8203;6](https://redirect.github.com/6).2.0

###
[`v5.3.1`](https://redirect.github.com/withastro/astro/blob/HEAD/packages/astro/CHANGELOG.md#531)

[Compare
Source](https://redirect.github.com/withastro/astro/compare/astro@5.3.0...astro@5.3.1)

##### Patch Changes

-
[#&#8203;13233](https://redirect.github.com/withastro/astro/pull/13233)
[`32fafeb`](https://redirect.github.com/withastro/astro/commit/32fafeb874cc4b6312eb50d54d9f0ca6b83aedbc)
Thanks [@&#8203;joshmkennedy](https://redirect.github.com/joshmkennedy)!
- Ensures consistent behaviour of `Astro.rewrite`/`ctx.rewrite` when
using `base` and `trailingSlash` options.

-
[#&#8203;13003](https://redirect.github.com/withastro/astro/pull/13003)
[`ea79054`](https://redirect.github.com/withastro/astro/commit/ea790542e186b0d2d2e828cb3ebd23bde4d04879)
Thanks [@&#8203;chaegumi](https://redirect.github.com/chaegumi)! - Fixes
a bug that caused the `vite.base` value to be ignored when running
`astro dev`

-
[#&#8203;13299](https://redirect.github.com/withastro/astro/pull/13299)
[`2e1321e`](https://redirect.github.com/withastro/astro/commit/2e1321e9d5b27da3e86bc4021e4136661a8055aa)
Thanks [@&#8203;bluwy](https://redirect.github.com/bluwy)! - Uses
`tinyglobby` for globbing files

-
[#&#8203;13233](https://redirect.github.com/withastro/astro/pull/13233)
[`32fafeb`](https://redirect.github.com/withastro/astro/commit/32fafeb874cc4b6312eb50d54d9f0ca6b83aedbc)
Thanks [@&#8203;joshmkennedy](https://redirect.github.com/joshmkennedy)!
- Ensures that `Astro.url`/`ctx.url` is correctly updated with the
`base` path after rewrites.

This change fixes an issue where `Astro.url`/`ctx.url` did not include
the configured base path after Astro.rewrite was called. Now, the base
path is correctly reflected in Astro.url.

Previously, any rewrites performed through `Astro.rewrite`/`ctx.rewrite`
failed to append the base path to `Astro.url`/`ctx.rewrite`, which could
lead to incorrect URL handling in downstream logic. By fixing this, we
ensure that all routes remain consistent and predictable after a
rewrite.

If you were relying on the work around of including the base path in
astro.rewrite you can now remove it from the path.

###
[`v5.3.0`](https://redirect.github.com/withastro/astro/blob/HEAD/packages/astro/CHANGELOG.md#530)

[Compare
Source](https://redirect.github.com/withastro/astro/compare/astro@5.2.6...astro@5.3.0)

##### Minor Changes

-
[#&#8203;13210](https://redirect.github.com/withastro/astro/pull/13210)
[`344e9bc`](https://redirect.github.com/withastro/astro/commit/344e9bc480a075161a7811b7733593556e7560da)
Thanks [@&#8203;VitaliyR](https://redirect.github.com/VitaliyR)! -
Handle `HEAD` requests to an endpoint when a handler is not defined.

If an endpoint defines a handler for `GET`, but does not define a
handler for `HEAD`, Astro will call the `GET` handler and return the
headers and status but an empty body.

-
[#&#8203;13195](https://redirect.github.com/withastro/astro/pull/13195)
[`3b66955`](https://redirect.github.com/withastro/astro/commit/3b669555d7ab9da5427e7b7037699d4f905d3536)
Thanks [@&#8203;MatthewLymer](https://redirect.github.com/MatthewLymer)!
- Improves SSR performance for synchronous components by avoiding the
use of Promises. With this change, SSR rendering of on-demand pages can
be up to 4x faster.

-
[#&#8203;13145](https://redirect.github.com/withastro/astro/pull/13145)
[`8d4e566`](https://redirect.github.com/withastro/astro/commit/8d4e566f5420c8a5406e1e40e8bae1c1f87cbe37)
Thanks [@&#8203;ascorbic](https://redirect.github.com/ascorbic)! - Adds
support for adapters auto-configuring experimental session storage
drivers.

Adapters can now configure a default session storage driver when the
`experimental.session` flag is enabled. If a hosting platform has a
storage primitive that can be used for session storage, the adapter can
automatically configure the session storage using that driver. This
allows Astro to provide a more seamless experience for users who want to
use sessions without needing to manually configure the session storage.

##### Patch Changes

-
[#&#8203;13145](https://redirect.github.com/withastro/astro/pull/13145)
[`8d4e566`](https://redirect.github.com/withastro/astro/commit/8d4e566f5420c8a5406e1e40e8bae1c1f87cbe37)
Thanks [@&#8203;ascorbic](https://redirect.github.com/ascorbic)! -
⚠️ **BREAKING CHANGE FOR EXPERIMENTAL SESSIONS ONLY** ⚠️

Changes the `experimental.session` option to a boolean flag and moves
session config to a top-level value. This change is to allow the new
automatic session driver support. You now need to separately enable the
`experimental.session` flag, and then configure the session driver using
the top-level `session` key if providing manual configuration.

    ```diff
    defineConfig({
      // ...
      experimental: {
    -    session: {
    -      driver: 'upstash',
    -    },
    +    session: true,
      },
    +  session: {
    +    driver: 'upstash',
    +  },
    });
    ```

You no longer need to configure a session driver if you are using an
adapter that supports automatic session driver configuration and wish to
use its default settings.

    ```diff
    defineConfig({
      adapter: node({
        mode: "standalone",
      }),
      experimental: {
    -    session: {
    -      driver: 'fs',
    -      cookie: 'astro-cookie',
    -    },
    +    session: true,
      },
    +  session: {
    +    cookie: 'astro-cookie',
    +  },
    });
    ```

However, you can still manually configure additional driver options or
choose a non-default driver to use with your adapter with the new
top-level `session` config option. For more information, see the
[experimental session
docs](https://docs.astro.build/en/reference/experimental-flags/sessions/).

-
[#&#8203;13101](https://redirect.github.com/withastro/astro/pull/13101)
[`2ed67d5`](https://redirect.github.com/withastro/astro/commit/2ed67d5dc5c8056f9ab1e29e539bf086b93c60c2)
Thanks
[@&#8203;corneliusroemer](https://redirect.github.com/corneliusroemer)!
- Fixes a bug where `HEAD` and `OPTIONS` requests for non-prerendered
pages were incorrectly rejected with 403 FORBIDDEN

</details>

---

### Configuration

📅 **Schedule**: Branch creation - At any time (no schedule defined),
Automerge - At any time (no schedule defined).

🚦 **Automerge**: Enabled.

♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the
rebase/retry checkbox.

👻 **Immortal**: This PR will be recreated if closed unmerged. Get
[config
help](https://redirect.github.com/renovatebot/renovate/discussions) if
that's undesired.

---

- [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check
this box

---

This PR has been generated by [Renovate
Bot](https://redirect.github.com/renovatebot/renovate).

<!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiIzOS4yMDIuMCIsInVwZGF0ZWRJblZlciI6IjM5LjIwMi4wIiwidGFyZ2V0QnJhbmNoIjoibWFzdGVyIiwibGFiZWxzIjpbImF1dG9tZXJnZSIsInJlbm92YXRlL2NvbnRhaW5lciIsInR5cGUvbWlub3IiXX0=-->
2025-03-18 20:56:45 +01:00
.vscode
…
public
…
src
fix(docs): Update guides for traefik & nginx (#33187 )
2025-03-12 23:13:58 +01:00
.gitignore
…
.markdownlint.yaml
…
.npmrc
…
.nvmrc
chore(deps): update node.js v22.13.1 → v22.14.0 (#31903 )
2025-02-11 13:24:18 +01:00
astro.config.mjs
fix(docs): Update Ingress Guide (#32223 )
2025-02-18 20:26:22 +01:00
LICENSE
…
LINK
…
package-lock.json
fix(docs): Update Ingress Guide (#32223 )
2025-02-18 20:26:22 +01:00
package.json
fix(website): update astro monorepo (minor) (#33412 )
2025-03-18 20:56:45 +01:00
README.md
…
tailwind.config.ts
…
tsconfig.json
…
website.code-workspace
…
README.md

Chart Docs

News

To add new authors, add their username in the authors.ts file in src/content/docs/news/authors.ts.
News Posts must have these fields in the frontmatter:
- title
- slug (must start with news/)
- date
- authors (The key in the authors object in src/content/docs/news/authors.ts)
Supported Code Block Languages

Check upstream docs
🧞 Commands

All commands are run from the root of the project, from a terminal:
Command	Action
`npm install`	Installs dependencies
`npm run dev`	Starts local dev server at `localhost:4321`
`npm run dev-windows`	Starts local dev server on windows machines
`npm run build`	Build your production site to `./dist/`
`npm run preview`	Preview your build locally, before deploying
`npm run astro ...`	Run CLI commands like `astro add`, `astro check`
`npm run astro -- --help`	Get help using the Astro CLI
Starlight looks for .md or .mdx files in the src/content/docs/ directory. Each file is exposed as a route based on its file name.
Images can be added to src/assets/ and embedded in Markdown with a relative link.
Static assets, like favicons, can be placed in the public/ directory.
👀 Want to learn more?

Check out Starlight’s docs, read the Astro documentation, or jump into the Astro Discord server.
README.md Unescape Escape

Chart Docs

News

Supported Code Block Languages

🧞 Commands

👀 Want to learn more?

README.md
