@f5-sales-demo/docs-theme 4.12.0 → 4.13.0

package/components/StatisticsSidebar.astro

@@ -0,0 +1,14 @@
+---
+import Sidebar from '@astrojs/starlight/components/Sidebar.astro';
+---
+
+<div data-statistics-sidebar>
+  <Sidebar />
+</div>
+
+<script is:inline>
+  // Restore the active reading path after Starlight restores saved toggle state.
+  document.querySelectorAll('[data-statistics-sidebar] details').forEach((group) => {
+    if (group.querySelector('a[aria-current="page"]')) group.open = true;
+  });
+</script>

package/index.ts

@@ -43,7 +43,9 @@ export default function f5xcDocsTheme(repository = process.env.GITHUB_REPOSITORY
                 ? {
                     Sidebar: '@f5-sales-demo/docs-theme/components/CanadaSidebar.astro',
                   }
-                : {}),
+                : repository.split('/').pop() === 'statistics'
+                  ? { Sidebar: '@f5-sales-demo/docs-theme/components/StatisticsSidebar.astro' }
+                  : {}),
             Banner: '@f5-sales-demo/docs-theme/components/Banner.astro',
             EditLink: '@f5-sales-demo/docs-theme/components/EditLink.astro',
             Footer: '@f5-sales-demo/docs-theme/components/Footer.astro',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@f5-sales-demo/docs-theme",
-  "version": "4.12.0",
+  "version": "4.13.0",
   "description": "F5 Distributed Cloud branded Starlight documentation theme",
   "type": "module",
   "engines": {
@@ -50,7 +50,8 @@
     "./assets/canada-flag.svg": "./assets/canada-flag.svg",
     "./assets/canada-favicon.svg": "./assets/canada-favicon.svg",
     "./styles/shell.css": "./styles/shell.css",
-    "./components/LocalHeader.astro": "./components/LocalHeader.astro"
+    "./components/LocalHeader.astro": "./components/LocalHeader.astro",
+    "./components/StatisticsSidebar.astro": "./components/StatisticsSidebar.astro"
   },
   "files": [
     "index.ts",

package/src/utils/canada-sidebar-plugin.test.ts

@@ -25,3 +25,14 @@ describe('Canada-only sidebar override', () => {
     expect(configuredComponents('f5-sales-demo/multi-cloud-networking')).not.toHaveProperty('Sidebar');
   });
 });
+
+describe('Statistics sidebar override', () => {
+  it('selects the sidebar that restores the active reading path', () => {
+    expect(configuredComponents('f5-sales-demo/statistics').Sidebar).toBe(
+      '@f5-sales-demo/docs-theme/components/StatisticsSidebar.astro',
+    );
+  });
+  it('preserves unrelated repository sidebars', () => {
+    expect(configuredComponents('f5-sales-demo/statistics-extra')).not.toHaveProperty('Sidebar');
+  });
+});

package/src/utils/publication-profiles.test.ts

@@ -66,9 +66,9 @@ describe('Statistics publication', () => {
     });
     expect(repositoryPublicationProfile('statistics')?.favicon).toBeUndefined();
   });
-  it('preserves 13 existing routes and places Shell Scripts before Infrastructure', () => {
+  it('preserves existing routes and places Shell Scripts before Infrastructure', () => {
     const sidebar = publicationSidebar('f5-sales-demo/statistics', []);
-    expect(sidebar?.slice(0, 11)).toEqual([
+    expect(sidebar?.slice(0, 9)).toEqual([
       { slug: 'index' },
       { slug: 'access-logs' },
       { slug: 'service-graph' },
@@ -78,9 +78,33 @@ describe('Statistics publication', () => {
       { slug: 'firewall-metrics' },
       { slug: 'security-events' },
       { slug: 'troubleshooting' },
-      { slug: 'api-catalog' },
-      { slug: 'setup' },
     ]);
+    const catalog = sidebar?.[9];
+    expect(catalog).toMatchObject({ label: 'Statistics APIs', collapsed: true });
+    if (!catalog || !('items' in catalog)) throw new Error('Statistics APIs must be a submenu');
+    const expected = [
+      'api-catalog',
+      'api-catalog/query-concepts',
+      'api-catalog/application-traffic',
+      'api-catalog/api-analytics',
+      'api-catalog/application-security',
+      'api-catalog/bot-defense',
+      'api-catalog/client-side-defense',
+      'api-catalog/device-data-intelligence',
+      'api-catalog/ddos-protection',
+      'api-catalog/dns',
+      'api-catalog/cdn',
+      'api-catalog/networking',
+      'api-catalog/kubernetes-storage',
+      'api-catalog/logs-events-alerts',
+      'api-catalog/synthetic-monitoring',
+      'api-catalog/billing-usage',
+    ];
+    expect(catalog.items.map((item) => ('slug' in item ? item.slug : ''))).toEqual(expected);
+    expect(catalog.items.every((item) => 'label' in item && item.label.split(/\s+/).length <= 3)).toBe(true);
+    expect(catalog.items[0]).toEqual({ label: 'Overview', slug: 'api-catalog' });
+    expect(catalog.items[1]).toEqual({ label: 'Query concepts', slug: 'api-catalog/query-concepts' });
+    expect(sidebar?.[10]).toEqual({ slug: 'setup' });
     expect(sidebar?.[11]).toEqual({ slug: 'shell-scripts' });
     expect(sidebar?.[12]).toEqual({
       label: 'Infrastructure',
@@ -95,8 +119,8 @@ describe('Statistics publication', () => {
           ? item.items.map((child) => ('slug' in child ? child.slug : ''))
           : [],
     );
-    expect(routes).toHaveLength(14);
-    expect(new Set(routes).size).toBe(14);
+    expect(routes).toHaveLength(29);
+    expect(new Set(routes).size).toBe(29);
   });
   it('preserves supplied fallback navigation for other repositories', () => {
     const fallback = [{ slug: 'index' }, { label: 'Existing', items: [{ slug: 'existing' }] }];

package/src/utils/publication-profiles.ts

@@ -24,7 +24,28 @@ export const publicationProfiles: Record<string, PublicationProfile> = {
       { slug: 'firewall-metrics' },
       { slug: 'security-events' },
       { slug: 'troubleshooting' },
-      { slug: 'api-catalog' },
+      {
+        label: 'Statistics APIs',
+        collapsed: true,
+        items: [
+          { label: 'Overview', slug: 'api-catalog' },
+          { label: 'Query concepts', slug: 'api-catalog/query-concepts' },
+          { label: 'Application traffic', slug: 'api-catalog/application-traffic' },
+          { label: 'API analytics', slug: 'api-catalog/api-analytics' },
+          { label: 'Application security', slug: 'api-catalog/application-security' },
+          { label: 'Bot defense', slug: 'api-catalog/bot-defense' },
+          { label: 'Client-side defense', slug: 'api-catalog/client-side-defense' },
+          { label: 'Device intelligence', slug: 'api-catalog/device-data-intelligence' },
+          { label: 'DDoS protection', slug: 'api-catalog/ddos-protection' },
+          { label: 'DNS', slug: 'api-catalog/dns' },
+          { label: 'CDN', slug: 'api-catalog/cdn' },
+          { label: 'Networking', slug: 'api-catalog/networking' },
+          { label: 'Kubernetes & storage', slug: 'api-catalog/kubernetes-storage' },
+          { label: 'Logs & events', slug: 'api-catalog/logs-events-alerts' },
+          { label: 'Synthetic monitoring', slug: 'api-catalog/synthetic-monitoring' },
+          { label: 'Billing & usage', slug: 'api-catalog/billing-usage' },
+        ],
+      },
       { slug: 'setup' },
       { slug: 'shell-scripts' },
       {