diff --git a/.changeset/apt-experts-call.md b/.changeset/apt-experts-call.md deleted file mode 100644 index d48b6ce8ee9..00000000000 --- a/.changeset/apt-experts-call.md +++ /dev/null @@ -1,6 +0,0 @@ ---- -"@astrojs/starlight": minor -"@astrojs/starlight-docsearch": minor ---- - -Distributes package as JavaScript files with dedicated type declaration files instead of TypeScript source files. diff --git a/.changeset/clean-flies-start.md b/.changeset/clean-flies-start.md deleted file mode 100644 index d8eca7d332f..00000000000 --- a/.changeset/clean-flies-start.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -'@astrojs/starlight': minor ---- - -Simplifies markup for Starlight’s mobile menu toggle - -**⚠️ Potentially breaking change:** If you use a theme plugin, custom styles, or component overrides targeting the `MobileMenuToggle` button or `PageFrame` components, you may need to adjust these for the new markup. The button is no longer wrapped in a `` custom element and no longer uses the `aria-expanded` attribute. Instead, you can use the `.sl-menu-button` class name to target the button and the `:popover-open` pseudo-class to style the menu open state specifically. - -In the following example, custom styles for the menu button are updated for the new approach: - -```diff -- starlight-menu-button button { -+ .sl-menu-button { - color: var(--sl-color-text); -} - -- starlight-menu-button[aria-expanded='true'] button { -+ .sl-menu-button:has(~ :popover-open) { - color: var(--sl-color-text-accent-high); -} -``` - -See [`MobileMenuToggle.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/MobileMenuToggle.astro) and [`PageFrame.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/PageFrame.astro) on GitHub for the full source code of the updated components. diff --git a/.changeset/fresh-ads-sneeze.md b/.changeset/fresh-ads-sneeze.md deleted file mode 100644 index 314eafcc90b..00000000000 --- a/.changeset/fresh-ads-sneeze.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -'@astrojs/starlight': minor ---- - -Removes the `tagline` configuration option, which was never used. - -If your configuration included a `tagline` option, you can safely remove it without any replacement. diff --git a/.changeset/humble-friends-clean.md b/.changeset/humble-friends-clean.md deleted file mode 100644 index 64041635a6e..00000000000 --- a/.changeset/humble-friends-clean.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -'@astrojs/starlight': minor ---- - -Updates internal `@astrojs/mdx`, `@astrojs/markdown-satteri`, and `satteri` dependencies. - -⚠️ **BREAKING CHANGE:** The following minimum versions are now required: -- `astro` v7.2.10 or later -- `@astrojs/markdown-satteri` 0.4.0 or later (if you use it) -- `@astrojs/markdown-remark` 7.3.0 or later (if you use it) - -Please update Starlight and Astro together: - -```sh -npx @astrojs/upgrade -``` diff --git a/.changeset/long-jokes-post.md b/.changeset/long-jokes-post.md deleted file mode 100644 index 25c2c654de1..00000000000 --- a/.changeset/long-jokes-post.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -'@astrojs/starlight': minor ---- - -Refactors Starlight’s mobile menu toggle to work when JavaScript fails or is disabled - -⚠️ **BREAKING CHANGE:** This release drops official support for Chromium-based browsers prior to version 116 (released August 2023), Safari-based browsers prior to version 17.0 (released September 2023), and Firefox prior to version 125 (released April 2024). You can find a list of currently supported browsers and their versions using this [browserslist query](https://browsersl.ist/#q=%3E+0.5%25%2C+not+dead%2C+Chrome+%3E%3D+116%2C+Edge+%3E%3D+116%2C+Firefox+%3E%3D+125%2C+Safari+%3E%3D+17.0%2C+iOS+%3E%3D+17.0%2C+not+op_mini+all). - -This change also removes the `data-mobile-menu-expanded` attribute, which was previously added to `` while the mobile menu is open. If you have custom code that was depending on this attribute, you will need to update it to use a new selector to check if the mobile menu is open. - -In the following example, a custom background colour for the site header while the menu is open is updated for the new approach: - -```diff -- [data-mobile-menu-expanded] header { -+ body:has(sl-sidebar-pane:popover-open) header { - background-color: var(--sl-color-bg); -} -``` diff --git a/examples/basics/package.json b/examples/basics/package.json index dcdff524636..4818cae15d8 100644 --- a/examples/basics/package.json +++ b/examples/basics/package.json @@ -11,7 +11,7 @@ "astro": "astro" }, "dependencies": { - "@astrojs/starlight": "^0.41.11", + "@astrojs/starlight": "^0.42.0", "astro": "^7.2.10", "sharp": "^0.35.3" } diff --git a/examples/markdoc/package.json b/examples/markdoc/package.json index b25731d8c6c..bacf88f66c1 100644 --- a/examples/markdoc/package.json +++ b/examples/markdoc/package.json @@ -12,7 +12,7 @@ }, "dependencies": { "@astrojs/markdoc": "^2.0.8", - "@astrojs/starlight": "^0.41.11", + "@astrojs/starlight": "^0.42.0", "@astrojs/starlight-markdoc": "^0.7.0", "astro": "^7.2.10", "sharp": "^0.35.3" diff --git a/examples/tailwind/package.json b/examples/tailwind/package.json index ea92bc294c0..7a1a1dcf4e8 100644 --- a/examples/tailwind/package.json +++ b/examples/tailwind/package.json @@ -11,7 +11,7 @@ "astro": "astro" }, "dependencies": { - "@astrojs/starlight": "^0.41.11", + "@astrojs/starlight": "^0.42.0", "@astrojs/starlight-tailwind": "^5.0.0", "@tailwindcss/vite": "^4.2.4", "astro": "^7.2.10", diff --git a/packages/docsearch/CHANGELOG.md b/packages/docsearch/CHANGELOG.md index 91f166d71c7..259c77e4601 100644 --- a/packages/docsearch/CHANGELOG.md +++ b/packages/docsearch/CHANGELOG.md @@ -1,5 +1,11 @@ # @astrojs/starlight-docsearch +## 0.8.0 + +### Minor Changes + +- [#3572](https://github.com/withastro/starlight/pull/3572) [`292fb17`](https://github.com/withastro/starlight/commit/292fb179cbf6e2cd970ced46359c520aa14a80b4) Thanks [@HiDeoo](https://github.com/HiDeoo)! - Distributes package as JavaScript files with dedicated type declaration files instead of TypeScript source files. + ## 0.7.0 ### Minor Changes diff --git a/packages/docsearch/package.json b/packages/docsearch/package.json index 26754a67cab..10e528ee8ba 100644 --- a/packages/docsearch/package.json +++ b/packages/docsearch/package.json @@ -1,6 +1,6 @@ { "name": "@astrojs/starlight-docsearch", - "version": "0.7.0", + "version": "0.8.0", "description": "Algolia DocSearch plugin for the Starlight documentation theme for Astro", "scripts": { "build": "tsdown" diff --git a/packages/starlight/CHANGELOG.md b/packages/starlight/CHANGELOG.md index 0e89e847d11..88cd28a0545 100644 --- a/packages/starlight/CHANGELOG.md +++ b/packages/starlight/CHANGELOG.md @@ -1,5 +1,64 @@ # @astrojs/starlight +## 0.42.0 + +### Minor Changes + +- [#3572](https://github.com/withastro/starlight/pull/3572) [`292fb17`](https://github.com/withastro/starlight/commit/292fb179cbf6e2cd970ced46359c520aa14a80b4) Thanks [@HiDeoo](https://github.com/HiDeoo)! - Distributes package as JavaScript files with dedicated type declaration files instead of TypeScript source files. + +- [#4121](https://github.com/withastro/starlight/pull/4121) [`2623ae6`](https://github.com/withastro/starlight/commit/2623ae60af0fdafc71938f96153b0427fcc2b5aa) Thanks [@delucis](https://github.com/delucis)! - Simplifies markup for Starlight’s mobile menu toggle + + **⚠️ Potentially breaking change:** If you use a theme plugin, custom styles, or component overrides targeting the `MobileMenuToggle` button or `PageFrame` components, you may need to adjust these for the new markup. The button is no longer wrapped in a `` custom element and no longer uses the `aria-expanded` attribute. Instead, you can use the `.sl-menu-button` class name to target the button and the `:popover-open` pseudo-class to style the menu open state specifically. + + In the following example, custom styles for the menu button are updated for the new approach: + + ```diff + - starlight-menu-button button { + + .sl-menu-button { + color: var(--sl-color-text); + } + + - starlight-menu-button[aria-expanded='true'] button { + + .sl-menu-button:has(~ :popover-open) { + color: var(--sl-color-text-accent-high); + } + ``` + + See [`MobileMenuToggle.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/MobileMenuToggle.astro) and [`PageFrame.astro`](https://github.com/withastro/starlight/blob/main/packages/starlight/components/PageFrame.astro) on GitHub for the full source code of the updated components. + +- [#3572](https://github.com/withastro/starlight/pull/3572) [`292fb17`](https://github.com/withastro/starlight/commit/292fb179cbf6e2cd970ced46359c520aa14a80b4) Thanks [@HiDeoo](https://github.com/HiDeoo)! - Removes the `tagline` configuration option, which was never used. + + If your configuration included a `tagline` option, you can safely remove it without any replacement. + +- [#4134](https://github.com/withastro/starlight/pull/4134) [`6135f01`](https://github.com/withastro/starlight/commit/6135f015b527453d7083ad01d2dc6c61d72fbefc) Thanks [@HiDeoo](https://github.com/HiDeoo)! - Updates internal `@astrojs/mdx`, `@astrojs/markdown-satteri`, and `satteri` dependencies. + + ⚠️ **BREAKING CHANGE:** The following minimum versions are now required: + + - `astro` v7.2.10 or later + - `@astrojs/markdown-satteri` 0.4.0 or later (if you use it) + - `@astrojs/markdown-remark` 7.3.0 or later (if you use it) + + Please update Starlight and Astro together: + + ```sh + npx @astrojs/upgrade + ``` + +- [#4121](https://github.com/withastro/starlight/pull/4121) [`2623ae6`](https://github.com/withastro/starlight/commit/2623ae60af0fdafc71938f96153b0427fcc2b5aa) Thanks [@delucis](https://github.com/delucis)! - Refactors Starlight’s mobile menu toggle to work when JavaScript fails or is disabled + + ⚠️ **BREAKING CHANGE:** This release drops official support for Chromium-based browsers prior to version 116 (released August 2023), Safari-based browsers prior to version 17.0 (released September 2023), and Firefox prior to version 125 (released April 2024). You can find a list of currently supported browsers and their versions using this [browserslist query](https://browsersl.ist/#q=%3E+0.5%25%2C+not+dead%2C+Chrome+%3E%3D+116%2C+Edge+%3E%3D+116%2C+Firefox+%3E%3D+125%2C+Safari+%3E%3D+17.0%2C+iOS+%3E%3D+17.0%2C+not+op_mini+all). + + This change also removes the `data-mobile-menu-expanded` attribute, which was previously added to `` while the mobile menu is open. If you have custom code that was depending on this attribute, you will need to update it to use a new selector to check if the mobile menu is open. + + In the following example, a custom background colour for the site header while the menu is open is updated for the new approach: + + ```diff + - [data-mobile-menu-expanded] header { + + body:has(sl-sidebar-pane:popover-open) header { + background-color: var(--sl-color-bg); + } + ``` + ## 0.41.11 ### Patch Changes diff --git a/packages/starlight/package.json b/packages/starlight/package.json index cb4979c85d1..edf794ccd76 100644 --- a/packages/starlight/package.json +++ b/packages/starlight/package.json @@ -1,6 +1,6 @@ { "name": "@astrojs/starlight", - "version": "0.41.11", + "version": "0.42.0", "description": "Build beautiful, high-performance documentation websites with Astro", "scripts": { "build": "tsdown", diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml index d9a86cc0e90..dbd4d7e7801 100644 --- a/pnpm-lock.yaml +++ b/pnpm-lock.yaml @@ -100,7 +100,7 @@ importers: examples/basics: dependencies: '@astrojs/starlight': - specifier: ^0.41.11 + specifier: ^0.42.0 version: link:../../packages/starlight astro: specifier: ^7.2.10 @@ -115,7 +115,7 @@ importers: specifier: ^2.0.8 version: 2.0.8(astro@7.2.10(@astrojs/markdown-remark@7.3.0(supports-color@10.2.2))(@emnapi/core@1.11.1)(@emnapi/runtime@1.11.3)(@types/node@24.12.4)(jiti@2.6.1)(yaml@2.9.0)) '@astrojs/starlight': - specifier: ^0.41.11 + specifier: ^0.42.0 version: link:../../packages/starlight '@astrojs/starlight-markdoc': specifier: ^0.7.0 @@ -130,7 +130,7 @@ importers: examples/tailwind: dependencies: '@astrojs/starlight': - specifier: ^0.41.11 + specifier: ^0.42.0 version: link:../../packages/starlight '@astrojs/starlight-tailwind': specifier: ^5.0.0