d27ec23543
This PR contains the following updates: | Package | Change | Age | Confidence | |---|---|---|---| | [astro](https://astro.build) ([source](https://redirect.github.com/withastro/astro/tree/HEAD/packages/astro)) | [`5.11.2` -> `5.12.4`](https://renovatebot.com/diffs/npm/astro/5.11.2/5.12.4) | [](https://docs.renovatebot.com/merge-confidence/) | [](https://docs.renovatebot.com/merge-confidence/) | Add the preset `:preserveSemverRanges` to your config if you don't want to pin your dependencies. --- ### Release Notes <details> <summary>withastro/astro (astro)</summary> ### [`v5.12.4`](https://redirect.github.com/withastro/astro/blob/HEAD/packages/astro/CHANGELOG.md#5124) [Compare Source](https://redirect.github.com/withastro/astro/compare/astro@5.12.3...astro@5.12.4) ##### Patch Changes - [#​14031](https://redirect.github.com/withastro/astro/pull/14031) [`e9206c1`](https://redirect.github.com/withastro/astro/commit/e9206c192fc4a4dbf2d02f921fa540f987ccbe89) Thanks [@​jp-knj](https://redirect.github.com/jp-knj)! - Optimized the build pipeline for SVG images. Now, Astro doesn't reprocess images that have already been processed. - [#​14132](https://redirect.github.com/withastro/astro/pull/14132) [`976879a`](https://redirect.github.com/withastro/astro/commit/976879a400af9f44aee52c9112a7bd9788163588) Thanks [@​ematipico](https://redirect.github.com/ematipico)! - Fixes a bug where the property `Astro.routePattern`/`context.routePattern` wasn't updated when using a rewrite via middleware. - [#​14131](https://redirect.github.com/withastro/astro/pull/14131) [`aafc4d7`](https://redirect.github.com/withastro/astro/commit/aafc4d7f8b3f198ace24a8a7f6cc9298771542da) Thanks [@​florian-lefebvre](https://redirect.github.com/florian-lefebvre)! - Fixes a case where an error occurring in a middleware would show the dev overlay instead of the custom `500.astro` page - [#​14127](https://redirect.github.com/withastro/astro/pull/14127) [`2309ada`](https://redirect.github.com/withastro/astro/commit/2309ada1c6d96c75815eda0760656147de435ba2) Thanks [@​florian-lefebvre](https://redirect.github.com/florian-lefebvre)! - Upgrades zod - [#​14134](https://redirect.github.com/withastro/astro/pull/14134) [`186c201`](https://redirect.github.com/withastro/astro/commit/186c201a1bd83593c880ab784d79f69245b445c2) Thanks [@​ascorbic](https://redirect.github.com/ascorbic)! - Throws a more helpful error in dev if trying to use a server island without an adapter - [#​14129](https://redirect.github.com/withastro/astro/pull/14129) [`3572d85`](https://redirect.github.com/withastro/astro/commit/3572d85ba89ef9c374f3631654eee704adf00e73) Thanks [@​ematipico](https://redirect.github.com/ematipico)! - Fixes a bug where the CSP headers was incorrectly added to a page when using an adapter. ### [`v5.12.3`](https://redirect.github.com/withastro/astro/blob/HEAD/packages/astro/CHANGELOG.md#5123) [Compare Source](https://redirect.github.com/withastro/astro/compare/astro@5.12.2...astro@5.12.3) ##### Patch Changes - [#​14119](https://redirect.github.com/withastro/astro/pull/14119) [`14807a4`](https://redirect.github.com/withastro/astro/commit/14807a4581b5ba2e61bc63ef9ef9f14848564edd) Thanks [@​ascorbic](https://redirect.github.com/ascorbic)! - Fixes a bug that caused builds to fail if a client directive was mistakenly added to an Astro component - [#​14001](https://redirect.github.com/withastro/astro/pull/14001) [`4b03d9c`](https://redirect.github.com/withastro/astro/commit/4b03d9c9d9237d9af38425062559eafdfc27f76f) Thanks [@​dnek](https://redirect.github.com/dnek)! - Fixes an issue where `getImage()` assigned the resized base URL to the srcset URL of `ImageTransform`, which matched the width, height, and format of the original image. ### [`v5.12.2`](https://redirect.github.com/withastro/astro/blob/HEAD/packages/astro/CHANGELOG.md#5122) [Compare Source](https://redirect.github.com/withastro/astro/compare/astro@5.12.1...astro@5.12.2) ##### Patch Changes - [#​14071](https://redirect.github.com/withastro/astro/pull/14071) [`d2cb35d`](https://redirect.github.com/withastro/astro/commit/d2cb35d2b7ff999fea8aa39c79f9f048c3500aeb) Thanks [@​Grisoly](https://redirect.github.com/Grisoly)! - Exposes the `Code` component `lang` prop type: ```ts import type { CodeLanguage } from 'astro'; ``` - [#​14111](https://redirect.github.com/withastro/astro/pull/14111) [`5452ee6`](https://redirect.github.com/withastro/astro/commit/5452ee67f95f51dcfdca8c1988b29f89553efe1c) Thanks [@​ascorbic](https://redirect.github.com/ascorbic)! - Fixes a bug that prevented "key" from being used as a prop for Astro components in MDX - [#​14106](https://redirect.github.com/withastro/astro/pull/14106) [`b5b39e4`](https://redirect.github.com/withastro/astro/commit/b5b39e4d4bf5e5816bccf7fbfd9a48e4d8ee302a) Thanks [@​ascorbic](https://redirect.github.com/ascorbic)! - Exits with non-zero exit code when config has an error - [#​14112](https://redirect.github.com/withastro/astro/pull/14112) [`37458b3`](https://redirect.github.com/withastro/astro/commit/37458b31aeee23df0b5a8ab9e319a23ee4eddc6d) Thanks [@​ascorbic](https://redirect.github.com/ascorbic)! - Fixes a bug that meant that SVG components could no longer be serialized with `JSON.stringify` - [#​14061](https://redirect.github.com/withastro/astro/pull/14061) [`c7a7dd5`](https://redirect.github.com/withastro/astro/commit/c7a7dd5f612b302f02a0ff468beeadd8e142a5ad) Thanks [@​jonasgeiler](https://redirect.github.com/jonasgeiler)! - Add module declaration for `?no-inline` asset imports - [#​14109](https://redirect.github.com/withastro/astro/pull/14109) [`5a08fa2`](https://redirect.github.com/withastro/astro/commit/5a08fa22b4023810fea45876f62152bd196e6062) Thanks [@​ascorbic](https://redirect.github.com/ascorbic)! - Throw a more helpful error if defineLiveCollection is used outside of a live.config file - [#​14110](https://redirect.github.com/withastro/astro/pull/14110) [`e7dd4e1`](https://redirect.github.com/withastro/astro/commit/e7dd4e1116103892ddc6a83052c8f1ba25d8abdc) Thanks [@​ascorbic](https://redirect.github.com/ascorbic)! - Warn if duplicate IDs are found by file loader ### [`v5.12.1`](https://redirect.github.com/withastro/astro/blob/HEAD/packages/astro/CHANGELOG.md#5121) [Compare Source](https://redirect.github.com/withastro/astro/compare/astro@5.12.0...astro@5.12.1) ##### Patch Changes - [#​14094](https://redirect.github.com/withastro/astro/pull/14094) [`22e9087`](https://redirect.github.com/withastro/astro/commit/22e90873f85d7b5b5d556f456362656f04b32341) Thanks [@​ascorbic](https://redirect.github.com/ascorbic)! - Correct types to allow `priority` on all images - [#​14091](https://redirect.github.com/withastro/astro/pull/14091) [`26c6b6d`](https://redirect.github.com/withastro/astro/commit/26c6b6db264f9cbd98ddf97c3f7a34ec7f488095) Thanks [@​ascorbic](https://redirect.github.com/ascorbic)! - Fixes a bug that caused a type error when defining session options without a driver - [#​14082](https://redirect.github.com/withastro/astro/pull/14082) [`93322cb`](https://redirect.github.com/withastro/astro/commit/93322cbe36c40401256eea2a9e34f5fbe13a28ec) Thanks [@​louisescher](https://redirect.github.com/louisescher)! - Fixes an issue where Astro's default 404 route would incorrectly match routes containing "/404" in dev - [#​14089](https://redirect.github.com/withastro/astro/pull/14089) [`687d253`](https://redirect.github.com/withastro/astro/commit/687d25365a41ff8a9e6da155d3527f841abb70dd) Thanks [@​florian-lefebvre](https://redirect.github.com/florian-lefebvre)! - Fixes a case where `astro:env` would not load the right environments variables in dev - [#​14092](https://redirect.github.com/withastro/astro/pull/14092) [`6692c71`](https://redirect.github.com/withastro/astro/commit/6692c71ed609690ebf6a697d88582130a5cbfdfb) Thanks [@​ascorbic](https://redirect.github.com/ascorbic)! - Improves error handling in live collections - [#​14074](https://redirect.github.com/withastro/astro/pull/14074) [`144a950`](https://redirect.github.com/withastro/astro/commit/144a950b55f22c2beeff710e5672e9fa611520b3) Thanks [@​abcfy2](https://redirect.github.com/abcfy2)! - Fixes a bug that caused some image service builds to fail - [#​14092](https://redirect.github.com/withastro/astro/pull/14092) [`6692c71`](https://redirect.github.com/withastro/astro/commit/6692c71ed609690ebf6a697d88582130a5cbfdfb) Thanks [@​ascorbic](https://redirect.github.com/ascorbic)! - Fixes a case where zod could not be imported from `astro:content` virtual module in live collection config ### [`v5.12.0`](https://redirect.github.com/withastro/astro/blob/HEAD/packages/astro/CHANGELOG.md#5120) [Compare Source](https://redirect.github.com/withastro/astro/compare/astro@5.11.2...astro@5.12.0) ##### Minor Changes - [#​13971](https://redirect.github.com/withastro/astro/pull/13971) [`fe35ee2`](https://redirect.github.com/withastro/astro/commit/fe35ee2835997e7e6c3e1975dc6dacfa1052a765) Thanks [@​adamhl8](https://redirect.github.com/adamhl8)! - Adds an experimental flag `rawEnvValues` to disable coercion of `import.meta.env` values (e.g. converting strings to other data types) that are populated from `process.env` Astro allows you to configure a [type-safe schema for your environment variables](https://docs.astro.build/en/guides/environment-variables/#type-safe-environment-variables), and converts variables imported via `astro:env` into the expected type. However, Astro also converts your environment variables used through `import.meta.env` in some cases, and this can prevent access to some values such as the strings `"true"` (which is converted to a boolean value), and `"1"` (which is converted to a number). The `experimental.rawEnvValues` flag disables coercion of `import.meta.env` values that are populated from `process.env`, allowing you to use the raw value. To enable this feature, add the experimental flag in your Astro config: ```diff import { defineConfig } from "astro/config" export default defineConfig({ + experimental: { + rawEnvValues: true, + } }) ``` If you were relying on this coercion, you may need to update your project code to apply it manually: ```ts diff - const enabled: boolean = import.meta.env.ENABLED + const enabled: boolean = import.meta.env.ENABLED === "true" ``` See the [experimental raw environment variables reference docs](https://docs.astro.build/en/reference/experimental-flags/raw-env-values/) for more information. - [#​13941](https://redirect.github.com/withastro/astro/pull/13941) [`6bd5f75`](https://redirect.github.com/withastro/astro/commit/6bd5f75806cb4df39d9e4e9b1f2225dcfdd724b0) Thanks [@​aditsachde](https://redirect.github.com/aditsachde)! - Adds support for TOML files to Astro's built-in `glob()` and `file()` content loaders. In Astro 5.2, Astro added support for using TOML frontmatter in Markdown files instead of YAML. However, if you wanted to use TOML files as local content collection entries themselves, you needed to write your own loader. Astro 5.12 now directly supports loading data from TOML files in content collections in both the `glob()` and the `file()` loaders. If you had added your own TOML content parser for the `file()` loader, you can now remove it as this functionality is now included: ```diff // src/content.config.ts import { defineCollection } from "astro:content"; import { file } from "astro/loaders"; - import { parse as parseToml } from "toml"; const dogs = defineCollection({ - loader: file("src/data/dogs.toml", { parser: (text) => parseToml(text) }), + loader: file("src/data/dogs.toml") schema: /* ... */ }) ``` Note that TOML does not support top-level arrays. Instead, the `file()` loader considers each top-level table to be an independent entry. The table header is populated in the `id` field of the entry object. See Astro's [content collections guide](https://docs.astro.build/en/guides/content-collections/#built-in-loaders) for more information on using the built-in content loaders. ##### Patch Changes - Updated dependencies \[[`6bd5f75`](https://redirect.github.com/withastro/astro/commit/6bd5f75806cb4df39d9e4e9b1f2225dcfdd724b0)]: - [@​astrojs/markdown-remark](https://redirect.github.com/astrojs/markdown-remark)@​6.3.3 </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. 🔕 **Ignore**: Close this PR and you won't be reminded about this update again. --- - [ ] <!-- 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:eyJjcmVhdGVkSW5WZXIiOiI0MS4yMC4wIiwidXBkYXRlZEluVmVyIjoiNDEuMjAuMCIsInRhcmdldEJyYW5jaCI6Im1hc3RlciIsImxhYmVscyI6WyJhdXRvbWVyZ2UiLCJyZW5vdmF0ZS9jb250YWluZXIiLCJ0eXBlL21pbm9yIl19-->
Chart Docs
News
- To add new authors, add their username in the
authors.tsfile insrc/content/docs/news/authors.ts. - News Posts must have these fields in the
frontmatter:titleslug(must start withnews/)dateauthors(The key in theauthorsobject insrc/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.