From 811db6e5c58083296ae5d4b77902fb2b50fe84af Mon Sep 17 00:00:00 2001
From: Tim 'Piepmatz' Hesse <git+github@cptpiepmatz.de>
Date: Fri, 27 Feb 2026 23:55:43 +0100
Subject: [PATCH 1/2] pin node version via volta

---
 package.json | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/package.json b/package.json
index 0675ad60106..694e77da254 100644
--- a/package.json
+++ b/package.json
@@ -29,5 +29,8 @@
   "engines": {
     "npm": ">=9.0.0",
     "node": ">=18.12.0"
+  },
+  "volta": {
+    "node": "22.22.0"
   }
 }

From f9e6db164bf74b441a49a0feb76e3635d0ceacaa Mon Sep 17 00:00:00 2001
From: Tim 'Piepmatz' Hesse <git+github@cptpiepmatz.de>
Date: Fri, 27 Feb 2026 23:56:02 +0100
Subject: [PATCH 2/2] add vue components to make release building nicer

---
 .vuepress/client.js                 |  6 ++
 .vuepress/components/JumpToc.vue    |  1 +
 .vuepress/components/NestedList.vue | 28 +++++++++
 .vuepress/components/PrBy.vue       | 29 +++++++++
 .vuepress/components/ReleaseToc.vue | 95 +++++++++++++++++++++++++++++
 5 files changed, 159 insertions(+)
 create mode 100644 .vuepress/components/JumpToc.vue
 create mode 100644 .vuepress/components/NestedList.vue
 create mode 100644 .vuepress/components/PrBy.vue
 create mode 100644 .vuepress/components/ReleaseToc.vue

diff --git a/.vuepress/client.js b/.vuepress/client.js
index 94e01662e65..7508dd0b4ff 100755
--- a/.vuepress/client.js
+++ b/.vuepress/client.js
@@ -6,9 +6,15 @@
 
 import { defineClientConfig } from 'vuepress/client';
 import BlogPosts from './components/BlogPosts.vue';
+import JumpToc from './components/JumpToc.vue';
+import PrBy from './components/PrBy.vue';
+import ReleaseToc from './components/ReleaseToc.vue';
 
 export default defineClientConfig({
   enhance({ app }) {
     app.component('BlogPosts', BlogPosts);
+    app.component('JumpToc', JumpToc);
+    app.component('PrBy', PrBy);
+    app.component('ReleaseToc', ReleaseToc);
   },
 });
diff --git a/.vuepress/components/JumpToc.vue b/.vuepress/components/JumpToc.vue
new file mode 100644
index 00000000000..13c1fce07bd
--- /dev/null
+++ b/.vuepress/components/JumpToc.vue
@@ -0,0 +1 @@
+<template>[<a href="#table-of-contents">toc</a>]</template>
diff --git a/.vuepress/components/NestedList.vue b/.vuepress/components/NestedList.vue
new file mode 100644
index 00000000000..6670c6614f6
--- /dev/null
+++ b/.vuepress/components/NestedList.vue
@@ -0,0 +1,28 @@
+<template>
+  <ul>
+    <li v-for="(item, i) in items" :key="i">
+      <span v-html="item.label"></span>
+
+      <NestedList
+        v-if="item.children && item.children.length"
+        :items="item.children"
+      />
+    </li>
+  </ul>
+</template>
+
+<script setup lang="ts">
+defineOptions({ name: 'NestedList' });
+
+defineProps({
+  items: {
+    type: Array<Item>,
+    required: true,
+  },
+});
+
+export interface Item {
+  label: String;
+  children: Item[];
+}
+</script>
diff --git a/.vuepress/components/PrBy.vue b/.vuepress/components/PrBy.vue
new file mode 100644
index 00000000000..df6023e6ca4
--- /dev/null
+++ b/.vuepress/components/PrBy.vue
@@ -0,0 +1,29 @@
+<template>
+  <p style="font-size: 0.8rem">
+    PR <a :href="prLink" target="_blank">#{{ pr }}</a> by
+    <a :href="userLink" target="_blank">@{{ user }}</a>
+  </p>
+</template>
+
+<style scoped>
+p {
+  font-size: 0.8rem;
+  margin: 0;
+}
+</style>
+
+<script setup lang="ts">
+const props = defineProps({
+  pr: {
+    type: Number,
+    required: true,
+  },
+  user: {
+    type: String,
+    required: true,
+  },
+});
+
+const prLink = 'https://github.com/nushell/nushell/pull/' + props.pr;
+const userLink = 'https://github.com/' + props.user;
+</script>
diff --git a/.vuepress/components/ReleaseToc.vue b/.vuepress/components/ReleaseToc.vue
new file mode 100644
index 00000000000..19f422b8aa2
--- /dev/null
+++ b/.vuepress/components/ReleaseToc.vue
@@ -0,0 +1,95 @@
+<template>
+  <NestedList :items="items"></NestedList>
+</template>
+
+<script setup lang="ts">
+import NestedList, { Item } from './NestedList.vue';
+import { ref, onMounted, nextTick } from 'vue';
+import { onContentUpdated } from 'vuepress/client';
+
+const items = ref([] as Item[]);
+
+function getHeaders(): NodeListOf<HTMLHeadingElement> {
+  return document.querySelectorAll('h1, h2, h3');
+}
+
+type OrganizedHeader = {
+  element?: HTMLHeadingElement;
+  children: OrganizedHeader[];
+};
+function organizeHeaders(
+  headers: HTMLHeadingElement[],
+  index: [number] = [0],
+  level: number = 1,
+): OrganizedHeader {
+  const node: OrganizedHeader = { children: [] };
+
+  while (index[0] < headers.length) {
+    const header = headers[index[0]];
+    const headerLevel = Number(header.tagName.slice(1)); // "H2" -> 2
+
+    // if we hit a header above our current level, we are done here
+    if (headerLevel < level) break;
+
+    // if we hit a header deeper than expected, let the caller handle it as children
+    if (headerLevel > level) break;
+
+    // headerLevel === level: consume this header and attach its children.
+    index[0]++;
+
+    const entry: OrganizedHeader = { element: header, children: [] };
+
+    // children are the following headers with level+1 (and their descendants)
+    const childrenTree = organizeHeaders(headers, index, level + 1);
+    entry.children = childrenTree.children;
+
+    node.children.push(entry);
+  }
+
+  return node;
+}
+
+function filterHeaders(root: OrganizedHeader): OrganizedHeader {
+  const wanted = [
+    'Highlights and themes of this release',
+    'Changes',
+    'Notes for plugin developers',
+    'Hall of fame',
+    'Full changelog',
+  ].map((section) => section.toLowerCase());
+
+  return {
+    ...root,
+    children: root.children.filter((section) =>
+      wanted.some((wanted) =>
+        section.element!.innerText.toLowerCase().startsWith(wanted),
+      ),
+    ),
+  };
+}
+
+function generateItem(header: OrganizedHeader): Item {
+  let slug = '#' + header.element?.id;
+  let content = header.element?.querySelector('span')?.innerHTML;
+
+  const i = content?.lastIndexOf('[');
+  if (i !== -1) content = content?.slice(0, i).trim();
+
+  return {
+    label: `<em><a href="${slug}">${content}</a></em>`,
+    children: header.children.map(generateItem),
+  };
+}
+
+async function refresh() {
+  await nextTick();
+  const headers = Array.from(getHeaders());
+  const organized = organizeHeaders(headers);
+  const filtered = filterHeaders(organized);
+  const item = generateItem(filtered);
+  items.value = item.children;
+}
+
+onMounted(refresh);
+onContentUpdated(refresh);
+</script>