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

package/components/Footer.astro

@@ -5,7 +5,7 @@ import Icon from './Icon.astro';
 
 <Default {...Astro.props}><slot /></Default>
 
-<div class="social-links">
+{process.env.DOCS_PROFILE !== 'canonical-provider' && <div class="social-links">
   <a href="https://www.facebook.com/f5incorporated" target="_blank" rel="noopener noreferrer" aria-label="Facebook">
     <Icon name="hashicorp-flight:facebook-color" size="1.5rem" />
   </a>
@@ -21,7 +21,7 @@ import Icon from './Icon.astro';
   <a href="https://www.youtube.com/user/f5networksinc" target="_blank" rel="noopener noreferrer" aria-label="YouTube">
     <Icon name="hashicorp-flight:youtube-color" size="1.5rem" />
   </a>
-</div>
+</div>}
 
 <style>
   .social-links {

package/components/MarkdownContent.astro

@@ -7,7 +7,5 @@ import ImageZoom from 'starlight-image-zoom/components/ImageZoom.astro';
 import StarlightVideosMarkdownContent from 'starlight-videos/components/MarkdownContent.astro';
 ---
 
-<ImageZoom />
-<StarlightVideosMarkdownContent>
-  {canonical ? <ProviderReference><slot /></ProviderReference> : <slot />}
-</StarlightVideosMarkdownContent>
+{!canonical && <ImageZoom />}
+{canonical ? <div class="sl-markdown-content"><ProviderReference><slot /></ProviderReference></div> : <StarlightVideosMarkdownContent><slot /></StarlightVideosMarkdownContent>}

package/config.ts

@@ -712,7 +712,7 @@ export function createF5xcDocsConfig(options: F5xcDocsConfigOptions = {}) {
     }
   }
   const megaMenuItems = options.megaMenuItems || (canonicalProvider ? providerMegaMenu(base) : defaultMegaMenuItems);
-  const head = options.head || defaultHead;
+  const head = options.head || (canonicalProvider ? [] : defaultHead);
   const logo = options.logo || { src: '@f5-sales-demo/docs-theme/assets/f5-distributed-cloud.svg' };
   const additionalRemarkPlugins = options.additionalRemarkPlugins || [];
   const additionalIntegrations = options.additionalIntegrations || [];
@@ -774,8 +774,7 @@ export function createF5xcDocsConfig(options: F5xcDocsConfigOptions = {}) {
       progressRingColor: '#e4002b',
       showOnHomepage: false,
     }),
-    starlightHeadingBadges(),
-    starlightPageActions(),
+    ...(!canonicalProvider ? [starlightHeadingBadges(), starlightPageActions()] : []),
     starlightIconsPlugin(),
     ...(openAPISpecs.length > 0
       ? [
@@ -870,7 +869,10 @@ export function createF5xcDocsConfig(options: F5xcDocsConfigOptions = {}) {
     site,
     base,
     ...(canonicalProvider
-      ? { experimental: { collectionStorage: { type: 'chunked' as const, chunkSize: 1024 * 1024 } } }
+      ? {
+          experimental: { collectionStorage: { type: 'chunked' as const, chunkSize: 1024 * 1024 } },
+          vite: { build: { assetsInlineLimit: 0 } },
+        }
       : {}),
     ...(resolvedLocales ? { redirects: { '/': `${normalizedBase}/${resolvedDefaultLocale}/` } } : {}),
     markdown: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@f5-sales-demo/docs-theme",
-  "version": "4.4.0",
+  "version": "4.4.2",
   "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',