Merge pull request #41 from trueberryless-org/changeset-release/main

[ci] release

Author: trueberryless

.changeset/modern-jobs-fly.md

@@ -1,5 +1,20 @@
 # starlight-sidebar-topics-dropdown-docs
 
+## 0.4.0
+
+### Minor Changes
+
+- [#40](https://github.com/trueberryless-org/starlight-sidebar-topics-dropdown/pull/40) [`5401b3f`](https://github.com/trueberryless-org/starlight-sidebar-topics-dropdown/commit/5401b3f1592b7c5e958b1778523f0a7a9f8f86e6) Thanks [@trueberryless](https://github.com/trueberryless)! - Update (and mostly remove) the documentation to match the new "just-a-component" package with the help of [HiDeoo](https://github.com/hideoo).
+
+### Patch Changes
+
+- [#43](https://github.com/trueberryless-org/starlight-sidebar-topics-dropdown/pull/43) [`762c45d`](https://github.com/trueberryless-org/starlight-sidebar-topics-dropdown/commit/762c45d58cb65ca0d14ca7b1073452112512b44e) Thanks [@trueberryless](https://github.com/trueberryless)! - Ignore bot contributors
+
+- [#42](https://github.com/trueberryless-org/starlight-sidebar-topics-dropdown/pull/42) [`f2d2b54`](https://github.com/trueberryless-org/starlight-sidebar-topics-dropdown/commit/f2d2b54013fa059c11b4a71af074c2cb27e7f03c) Thanks [@trueberryless](https://github.com/trueberryless)! - Remove version badge and node adapter
+
+- Updated dependencies [[`acf6f15`](https://github.com/trueberryless-org/starlight-sidebar-topics-dropdown/commit/acf6f156d4e8eaa00b2205dbb89befbd5dea27c7)]:
+  - starlight-sidebar-topics-dropdown@0.5.0
+
 ## 0.3.3
 
 ### Patch Changes

.changeset/quiet-bats-wear.md

@@ -1,6 +1,6 @@
 {
   "name": "starlight-sidebar-topics-dropdown-docs",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "private": true,
   "description": "Starlight plugin to split your docs page into multiple subpages and switch between them with a dropdown menu in the sidebar.",
   "homepage": "https://github.com/trueberryless-org/starlight-sidebar-topics-dropdown",

.changeset/sad-bugs-pump.md

@@ -1,5 +1,69 @@
 # starlight-sidebar-topics-dropdown
 
+## 0.5.0
+
+### Minor Changes
+
+- [#40](https://github.com/trueberryless-org/starlight-sidebar-topics-dropdown/pull/40) [`acf6f15`](https://github.com/trueberryless-org/starlight-sidebar-topics-dropdown/commit/acf6f156d4e8eaa00b2205dbb89befbd5dea27c7) Thanks [@trueberryless](https://github.com/trueberryless)! - ⚠️ **BREAKING CHANGE:** This plugin now uses the [Starlight Sidebar Topics](https://starlight-sidebar-topics.netlify.app/) plugin as a peer dependency. Please follow the upgrade guide below to migrate to the new version.
+
+  1. Install the [Starlight Sidebar Topics](https://starlight-sidebar-topics.netlify.app/) plugin:
+
+     ```sh
+     npm i starlight-sidebar-topics
+     ```
+
+  2. Update the `starlight-sidebar-topics-dropdown` plugin in your `astro.config.mjs` (use the `starlight-sidebar-topics` plugin instead):
+
+     ```diff lang="js"
+     // astro.config.mjs
+     -import starlightSidebarTopicsDropdown from "starlight-sidebar-topics-dropdown";
+     +import starlightSidebarTopics from "starlight-sidebar-topics";
+     ```
+
+  3. Exchange the `starlight-sidebar-topics-dropdown` plugin with the `starlight-sidebar-topics` plugin and add a manual override for the `Sidebar` component where you can use the dropdown component from the `starlight-sidebar-topics-dropdown` plugin:
+
+     ```diff lang="js"
+     // astro.config.mjs
+     export default defineConfig({
+       integrations: [
+         starlight({
+           plugins: [
+     -        starlightSidebarTopicsDropdown([
+     +        starlightSidebarTopics([
+               // Your Starlight Sidebar Topics configuration here (unchanged).
+             ]),
+           ],
+     +      components: {
+     +        Sidebar: './src/components/Sidebar.astro',
+     +      },
+         }),
+       ],
+     });
+     ```
+
+  4. Create an Astro component to replace the default Starlight `<Sidebar>` component with which will render the topic list dropdown menu and [re-use the default Starlight sidebar](https://starlight.astro.build/guides/overriding-components/#reuse-a-built-in-component):
+
+     ```astro
+     ---
+     // src/components/Sidebar.astro
+     import Default from "@astrojs/starlight/components/Sidebar.astro";
+     import TopicsDropdown from "starlight-sidebar-topics-dropdown/TopicsDropdown.astro";
+     ---
+
+     {/* Render the topics dropdown menu. */}
+     <TopicsDropdown />
+     {/* Render the default sidebar. */}
+     <Default><slot /></Default>
+     ```
+
+  5. Update the schema import in `src/content.config.ts`:
+
+     ```diff lang="ts"
+     // src/content.config.ts
+     -import { topicSchema } from "starlight-sidebar-topics-dropdown/schema";
+     +import { topicSchema } from "starlight-sidebar-topics/schema";
+     ```
+
 ## 0.4.1
 
 ### Patch Changes

.changeset/tame-bags-march.md

@@ -1,6 +1,6 @@
 {
   "name": "starlight-sidebar-topics-dropdown",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Starlight plugin to split your docs page into multiple subpages and switch between them with a dropdown menu in the sidebar.",
   "keywords": [
     "starlight",