@f5-sales-demo/docs-theme 4.4.0 → 4.4.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@f5-sales-demo/docs-theme",
-  "version": "4.4.0",
+  "version": "4.4.1",
   "description": "F5 Distributed Cloud branded Starlight documentation theme",
   "type": "module",
   "engines": {

package/src/utils/canonical-provider.test.ts

@@ -28,3 +28,21 @@ describe('canonical provider navigation', () => {
     expect(nav[0].entries[1].isCurrent).toBe(true);
   });
 });
+
+describe('bounded collection expansion', () => {
+  it('keeps sibling references and expands only the exact active ancestry', () => {
+    const pages = [
+      { id: 'root', collection_id: 'c', parent_id: null, title: 'Root', slug: 'resources/demo' },
+      { id: 'a', collection_id: 'c', parent_id: 'root', title: 'A', slug: 'resources/demo/properties/a' },
+      { id: 'aa', collection_id: 'c', parent_id: 'a', title: 'AA', slug: 'resources/demo/properties/a/child' },
+      { id: 'b', collection_id: 'c', parent_id: 'root', title: 'B', slug: 'resources/demo/properties/ab' },
+      { id: 'bb', collection_id: 'c', parent_id: 'b', title: 'BB', slug: 'resources/demo/properties/ab/child' },
+    ];
+    const nav = collectionNavigation(pages, 'c', '/', 'resources/demo/properties/a/child');
+    const text = JSON.stringify(nav);
+    expect(text).toContain('AA');
+    expect(text).toContain('"label":"B"');
+    expect(text).not.toContain('BB');
+    expect(nav[0].type).toBe('group');
+  });
+});

package/src/utils/canonical-provider.ts

@@ -39,7 +39,9 @@ export function collectionNavigation(pages: ProviderPage[], collection: string,
   const tree = (page: ProviderPage, seen = new Set<string>()): StarlightRouteData['sidebar'][number] => {
     if (seen.has(page.id)) throw new Error(`Cyclic canonical navigation: ${page.id}`);
     const descendants = children.get(page.id) || [];
-    if (!descendants.length) return link(page);
+    // Other branches remain navigable through their reference page, whose
+    // content lists every direct child. Expand only the active ancestry.
+    if (!descendants.length || !(current === page.slug || current.startsWith(`${page.slug}/`))) return link(page);
     const next = new Set([...seen, page.id]);
     return {
       type: 'group',