From b191ffb81684674f7efb837dda6f8e193b95f005 Mon Sep 17 00:00:00 2001
From: David Longworth <djl@sent.com>
Date: Mon, 20 Apr 2026 22:00:31 +0100
Subject: [PATCH 1/6] fix external url paths in sidebar

---
 .../stacks-docs-next/src/components/Navigation.svelte     | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/stacks-docs-next/src/components/Navigation.svelte b/packages/stacks-docs-next/src/components/Navigation.svelte
index 84f1c8cc94..f8a4186353 100644
--- a/packages/stacks-docs-next/src/components/Navigation.svelte
+++ b/packages/stacks-docs-next/src/components/Navigation.svelte
@@ -64,7 +64,7 @@
                   <a
                     class="s-navigation--item jc-space-between mb1"
                     class:is-selected={sectionSlug === subsection.slug || subsectionSlug === subsection.slug}
-                    href={resolve(subsection.externalUrl || `/${category.slug}/${subsection.slug}/${subsection?.items ? subsection?.items[0]?.slug : ''}`)}
+                    href={subsection.externalUrl ? subsection.externalUrl : resolve(`/${category.slug}/${subsection.slug}/${subsection?.items ? subsection?.items[0]?.slug : ''}`)}
                     data-sveltekit-reload={subsection.private ? true : undefined}
                   >
                     <span>{subsection.title}</span>
@@ -82,7 +82,7 @@
                         {#if subsection.externalUrl}
                           <Icon src={IconArrowUpRightBox} />
                         {/if}
-                      </span> 
+                      </span>
                     {/if}
                   </a>
 
@@ -94,7 +94,7 @@
                             <a
                               class="s-navigation--item jc-space-between mb1"
                               class:is-selected={subsectionSlug === item.slug}
-                              href={resolve(item.externalUrl || `/${category.slug}/${subsection.slug}/${item.slug}/`)}
+                              href={item.externalUrl ? item.externalUrl : resolve(`/${category.slug}/${subsection.slug}/${item.slug}/`)}
                               data-sveltekit-reload={item.private ? true : undefined}
                             >
                               <span>{item.title}</span>
@@ -132,4 +132,4 @@
 		background: var(--black-600) !important;
     color: var(--white) !important;
 	}
-</style>
\ No newline at end of file
+</style>

From ccca3cd2718d07d3ebc30ac3745f44fa57f9a94b Mon Sep 17 00:00:00 2001
From: David Longworth <djl@sent.com>
Date: Thu, 23 Apr 2026 16:58:19 +0100
Subject: [PATCH 2/6] fix lint

---
 packages/stacks-docs-next/src/components/Navigation.svelte | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/packages/stacks-docs-next/src/components/Navigation.svelte b/packages/stacks-docs-next/src/components/Navigation.svelte
index f8a4186353..042e3aaaf0 100644
--- a/packages/stacks-docs-next/src/components/Navigation.svelte
+++ b/packages/stacks-docs-next/src/components/Navigation.svelte
@@ -64,7 +64,9 @@
                   <a
                     class="s-navigation--item jc-space-between mb1"
                     class:is-selected={sectionSlug === subsection.slug || subsectionSlug === subsection.slug}
+                    <!-- eslint-disable-next-line svelte/no-navigation-without-resolve -->
                     href={subsection.externalUrl ? subsection.externalUrl : resolve(`/${category.slug}/${subsection.slug}/${subsection?.items ? subsection?.items[0]?.slug : ''}`)}
+                    rel={subsection.externalUrl ? "external" : undefined}
                     data-sveltekit-reload={subsection.private ? true : undefined}
                   >
                     <span>{subsection.title}</span>
@@ -94,7 +96,9 @@
                             <a
                               class="s-navigation--item jc-space-between mb1"
                               class:is-selected={subsectionSlug === item.slug}
+                              <!-- eslint-disable-next-line svelte/no-navigation-without-resolve -->
                               href={item.externalUrl ? item.externalUrl : resolve(`/${category.slug}/${subsection.slug}/${item.slug}/`)}
+                              rel={subsection.externalUrl ? "external" : undefined}
                               data-sveltekit-reload={item.private ? true : undefined}
                             >
                               <span>{item.title}</span>

From ae4287514a90d04ab47f634fb3fc167e0a83025b Mon Sep 17 00:00:00 2001
From: David Longworth <djl@sent.com>
Date: Thu, 23 Apr 2026 18:22:14 +0100
Subject: [PATCH 3/6] break out into a variable

---
 .../src/components/Navigation.svelte                 | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/stacks-docs-next/src/components/Navigation.svelte b/packages/stacks-docs-next/src/components/Navigation.svelte
index 042e3aaaf0..916ff8b300 100644
--- a/packages/stacks-docs-next/src/components/Navigation.svelte
+++ b/packages/stacks-docs-next/src/components/Navigation.svelte
@@ -61,11 +61,11 @@
             <ul class="s-navigation s-navigation__vertical pl24">
               {#each category.items as subsection (subsection.slug)}
                 <li>
-                  <a
+                  {@const subsectionHref = subsection.externalUrl ? subsection.externalUrl : resolve(`/${category.slug}/${subsection.slug}/${subsection?.items ? subsection?.items[0]?.slug : ''}`)}
+                  <!-- eslint-disable-next-line svelte/no-navigation-without-resolve -->
+                  <a href={subsectionHref}
                     class="s-navigation--item jc-space-between mb1"
                     class:is-selected={sectionSlug === subsection.slug || subsectionSlug === subsection.slug}
-                    <!-- eslint-disable-next-line svelte/no-navigation-without-resolve -->
-                    href={subsection.externalUrl ? subsection.externalUrl : resolve(`/${category.slug}/${subsection.slug}/${subsection?.items ? subsection?.items[0]?.slug : ''}`)}
                     rel={subsection.externalUrl ? "external" : undefined}
                     data-sveltekit-reload={subsection.private ? true : undefined}
                   >
@@ -93,11 +93,11 @@
                       <ul class="s-navigation s-navigation__vertical ml24">
                         {#each subsection?.items as item (item.slug)}
                           <li>
-                            <a
+                          {@const itemHref = item.externalUrl ? item.externalUrl : resolve(`/${category.slug}/${subsection.slug}/${item.slug}/`)}
+                          <!-- eslint-disable-next-line svelte/no-navigation-without-resolve -->
+                            <a href={itemHref}
                               class="s-navigation--item jc-space-between mb1"
                               class:is-selected={subsectionSlug === item.slug}
-                              <!-- eslint-disable-next-line svelte/no-navigation-without-resolve -->
-                              href={item.externalUrl ? item.externalUrl : resolve(`/${category.slug}/${subsection.slug}/${item.slug}/`)}
                               rel={subsection.externalUrl ? "external" : undefined}
                               data-sveltekit-reload={item.private ? true : undefined}
                             >

From 3cb481c6cd2a9538ebc200778bef301bfe5ac7da Mon Sep 17 00:00:00 2001
From: David Longworth <djl@sent.com>
Date: Thu, 23 Apr 2026 18:23:25 +0100
Subject: [PATCH 4/6] const afer each

---
 .../src/components/Navigation.svelte          | 34 ++++++++++---------
 1 file changed, 18 insertions(+), 16 deletions(-)

diff --git a/packages/stacks-docs-next/src/components/Navigation.svelte b/packages/stacks-docs-next/src/components/Navigation.svelte
index 916ff8b300..3eb7d357a2 100644
--- a/packages/stacks-docs-next/src/components/Navigation.svelte
+++ b/packages/stacks-docs-next/src/components/Navigation.svelte
@@ -60,8 +60,9 @@
           <div transition:slide={{ duration: 200 }}>
             <ul class="s-navigation s-navigation__vertical pl24">
               {#each category.items as subsection (subsection.slug)}
+                {@const subsectionHref = subsection.externalUrl ? subsection.externalUrl : resolve(`/${category.slug}/${subsection.slug}/${subsection?.items ? subsection?.items[0]?.slug : ''}`)}
+
                 <li>
-                  {@const subsectionHref = subsection.externalUrl ? subsection.externalUrl : resolve(`/${category.slug}/${subsection.slug}/${subsection?.items ? subsection?.items[0]?.slug : ''}`)}
                   <!-- eslint-disable-next-line svelte/no-navigation-without-resolve -->
                   <a href={subsectionHref}
                     class="s-navigation--item jc-space-between mb1"
@@ -92,22 +93,23 @@
                     <div transition:slide={{ duration: 200 }}>
                       <ul class="s-navigation s-navigation__vertical ml24">
                         {#each subsection?.items as item (item.slug)}
-                          <li>
-                          {@const itemHref = item.externalUrl ? item.externalUrl : resolve(`/${category.slug}/${subsection.slug}/${item.slug}/`)}
-                          <!-- eslint-disable-next-line svelte/no-navigation-without-resolve -->
-                            <a href={itemHref}
-                              class="s-navigation--item jc-space-between mb1"
-                              class:is-selected={subsectionSlug === item.slug}
-                              rel={subsection.externalUrl ? "external" : undefined}
-                              data-sveltekit-reload={item.private ? true : undefined}
-                            >
-                              <span>{item.title}</span>
+                            {@const itemHref = item.externalUrl ? item.externalUrl : resolve(`/${category.slug}/${subsection.slug}/${item.slug}/`)}
+
+                            <li>
+                                <!-- eslint-disable-next-line svelte/no-navigation-without-resolve -->
+                                <a href={itemHref}
+                                    class="s-navigation--item jc-space-between mb1"
+                                    class:is-selected={subsectionSlug === item.slug}
+                                    rel={subsection.externalUrl ? "external" : undefined}
+                                    data-sveltekit-reload={item.private ? true : undefined}
+                                >
+                                <span>{item.title}</span>
 
-                              {#if item.new}
-                                <span class="s-activity-indicator s-activity-indicator__sm ba"><span class="v-visible-sr">new</span></span>
-                              {/if}
-                            </a>
-                          </li>
+                                {#if item.new}
+                                    <span class="s-activity-indicator s-activity-indicator__sm ba"><span class="v-visible-sr">new</span></span>
+                                {/if}
+                                </a>
+                            </li>
                         {/each}
                       </ul>
                     </div>

From 95877cf2325ae2c09fa645fed5775e810474ea2e Mon Sep 17 00:00:00 2001
From: Dan Cormier <dancormierall@gmail.com>
Date: Fri, 24 Apr 2026 10:43:23 -0400
Subject: [PATCH 5/6] fix(docs-next): use item.externalUrl for nested nav rel
 attribute

The inner anchor's rel was keyed off subsection.externalUrl while its
href is derived from item.externalUrl, so a nested external item would
not get rel="external" and a subsection with externalUrl plus items
would apply rel="external" to internal children. Also re-indent the
inner block to match the 2-space style used elsewhere in the file and
move href onto its own line.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .../src/components/Navigation.svelte          | 34 ++++++++++---------
 1 file changed, 18 insertions(+), 16 deletions(-)

diff --git a/packages/stacks-docs-next/src/components/Navigation.svelte b/packages/stacks-docs-next/src/components/Navigation.svelte
index 3eb7d357a2..f95ffd1165 100644
--- a/packages/stacks-docs-next/src/components/Navigation.svelte
+++ b/packages/stacks-docs-next/src/components/Navigation.svelte
@@ -64,7 +64,8 @@
 
                 <li>
                   <!-- eslint-disable-next-line svelte/no-navigation-without-resolve -->
-                  <a href={subsectionHref}
+                  <a
+                    href={subsectionHref}
                     class="s-navigation--item jc-space-between mb1"
                     class:is-selected={sectionSlug === subsection.slug || subsectionSlug === subsection.slug}
                     rel={subsection.externalUrl ? "external" : undefined}
@@ -93,23 +94,24 @@
                     <div transition:slide={{ duration: 200 }}>
                       <ul class="s-navigation s-navigation__vertical ml24">
                         {#each subsection?.items as item (item.slug)}
-                            {@const itemHref = item.externalUrl ? item.externalUrl : resolve(`/${category.slug}/${subsection.slug}/${item.slug}/`)}
+                          {@const itemHref = item.externalUrl ? item.externalUrl : resolve(`/${category.slug}/${subsection.slug}/${item.slug}/`)}
 
-                            <li>
-                                <!-- eslint-disable-next-line svelte/no-navigation-without-resolve -->
-                                <a href={itemHref}
-                                    class="s-navigation--item jc-space-between mb1"
-                                    class:is-selected={subsectionSlug === item.slug}
-                                    rel={subsection.externalUrl ? "external" : undefined}
-                                    data-sveltekit-reload={item.private ? true : undefined}
-                                >
-                                <span>{item.title}</span>
+                          <li>
+                            <!-- eslint-disable-next-line svelte/no-navigation-without-resolve -->
+                            <a
+                              href={itemHref}
+                              class="s-navigation--item jc-space-between mb1"
+                              class:is-selected={subsectionSlug === item.slug}
+                              rel={item.externalUrl ? "external" : undefined}
+                              data-sveltekit-reload={item.private ? true : undefined}
+                            >
+                              <span>{item.title}</span>
 
-                                {#if item.new}
-                                    <span class="s-activity-indicator s-activity-indicator__sm ba"><span class="v-visible-sr">new</span></span>
-                                {/if}
-                                </a>
-                            </li>
+                              {#if item.new}
+                                <span class="s-activity-indicator s-activity-indicator__sm ba"><span class="v-visible-sr">new</span></span>
+                              {/if}
+                            </a>
+                          </li>
                         {/each}
                       </ul>
                     </div>

From c850fa7070c9842fd03488d7317ffd40c95a5160 Mon Sep 17 00:00:00 2001
From: Dan Cormier <dancormierall@gmail.com>
Date: Fri, 24 Apr 2026 10:47:33 -0400
Subject: [PATCH 6/6] fix(docs-next): keep href on same line as <a> so
 eslint-disable applies

eslint-disable-next-line only suppresses the line immediately after it.
Moving href onto its own line put it two lines below the comment, so
svelte/no-navigation-without-resolve fired again.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 packages/stacks-docs-next/src/components/Navigation.svelte | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/packages/stacks-docs-next/src/components/Navigation.svelte b/packages/stacks-docs-next/src/components/Navigation.svelte
index f95ffd1165..9b1e5c979b 100644
--- a/packages/stacks-docs-next/src/components/Navigation.svelte
+++ b/packages/stacks-docs-next/src/components/Navigation.svelte
@@ -64,8 +64,7 @@
 
                 <li>
                   <!-- eslint-disable-next-line svelte/no-navigation-without-resolve -->
-                  <a
-                    href={subsectionHref}
+                  <a href={subsectionHref}
                     class="s-navigation--item jc-space-between mb1"
                     class:is-selected={sectionSlug === subsection.slug || subsectionSlug === subsection.slug}
                     rel={subsection.externalUrl ? "external" : undefined}
@@ -98,8 +97,7 @@
 
                           <li>
                             <!-- eslint-disable-next-line svelte/no-navigation-without-resolve -->
-                            <a
-                              href={itemHref}
+                            <a href={itemHref}
                               class="s-navigation--item jc-space-between mb1"
                               class:is-selected={subsectionSlug === item.slug}
                               rel={item.externalUrl ? "external" : undefined}