@eventcatalog/core 3.39.4 → 3.39.5

package/dist/analytics/analytics.cjs

@@ -37,7 +37,7 @@ var import_axios = __toESM(require("axios"), 1);
 var import_os = __toESM(require("os"), 1);
 
 // package.json
-var version = "3.39.4";
+var version = "3.39.5";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/analytics.js

@@ -1,7 +1,7 @@
 import {
   raiseEvent
-} from "../chunk-ONQOIF2X.js";
-import "../chunk-WLUQZCIH.js";
+} from "../chunk-H5BZMNK3.js";
+import "../chunk-TNE5QSJ4.js";
 export {
   raiseEvent
 };

package/dist/analytics/log-build.cjs

@@ -111,7 +111,7 @@ var import_axios = __toESM(require("axios"), 1);
 var import_os = __toESM(require("os"), 1);
 
 // package.json
-var version = "3.39.4";
+var version = "3.39.5";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/log-build.js

@@ -1,9 +1,9 @@
 import {
   log_build_default
-} from "../chunk-O2CZERUN.js";
-import "../chunk-ONQOIF2X.js";
+} from "../chunk-KVAEAYEP.js";
+import "../chunk-H5BZMNK3.js";
 import "../chunk-4UVFXLPI.js";
-import "../chunk-WLUQZCIH.js";
+import "../chunk-TNE5QSJ4.js";
 import "../chunk-5T63CXKU.js";
 export {
   log_build_default as default

package/dist/{chunk-ONQOIF2X.js → chunk-H5BZMNK3.js}

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-WLUQZCIH.js";
+} from "./chunk-TNE5QSJ4.js";
 
 // src/analytics/analytics.js
 import axios from "axios";

package/dist/{chunk-O2CZERUN.js → chunk-KVAEAYEP.js}

@@ -1,6 +1,6 @@
 import {
   raiseEvent
-} from "./chunk-ONQOIF2X.js";
+} from "./chunk-H5BZMNK3.js";
 import {
   countResources,
   serializeCounts

package/dist/{chunk-NSR4DZXS.js → chunk-M4S7PORQ.js}

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-WLUQZCIH.js";
+} from "./chunk-TNE5QSJ4.js";
 
 // src/utils/cli-logger.ts
 import pc from "picocolors";

package/dist/{chunk-PVOVC2UV.js → chunk-S4HLJWQ7.js}

@@ -1,6 +1,6 @@
 import {
   logger
-} from "./chunk-NSR4DZXS.js";
+} from "./chunk-M4S7PORQ.js";
 import {
   cleanup,
   getEventCatalogConfigFile

package/dist/{chunk-WLUQZCIH.js → chunk-TNE5QSJ4.js}

@@ -1,5 +1,5 @@
 // package.json
-var version = "3.39.4";
+var version = "3.39.5";
 
 // src/constants.ts
 var VERSION = version;

package/dist/constants.cjs

@@ -25,7 +25,7 @@ __export(constants_exports, {
 module.exports = __toCommonJS(constants_exports);
 
 // package.json
-var version = "3.39.4";
+var version = "3.39.5";
 
 // src/constants.ts
 var VERSION = version;

package/dist/constants.js

@@ -1,6 +1,6 @@
 import {
   VERSION
-} from "./chunk-WLUQZCIH.js";
+} from "./chunk-TNE5QSJ4.js";
 export {
   VERSION
 };

package/dist/eventcatalog.cjs

@@ -114,7 +114,7 @@ var verifyRequiredFieldsAreInCatalogConfigFile = async (projectDirectory) => {
 var import_picocolors = __toESM(require("picocolors"), 1);
 
 // package.json
-var version = "3.39.4";
+var version = "3.39.5";
 
 // src/constants.ts
 var VERSION = version;

package/dist/eventcatalog.js

@@ -13,8 +13,8 @@ import {
 } from "./chunk-K3ZVEX2Y.js";
 import {
   log_build_default
-} from "./chunk-O2CZERUN.js";
-import "./chunk-ONQOIF2X.js";
+} from "./chunk-KVAEAYEP.js";
+import "./chunk-H5BZMNK3.js";
 import "./chunk-4UVFXLPI.js";
 import {
   catalogToAstro
@@ -28,13 +28,13 @@ import {
 } from "./chunk-ULZYHF3V.js";
 import {
   generate
-} from "./chunk-PVOVC2UV.js";
+} from "./chunk-S4HLJWQ7.js";
 import {
   logger
-} from "./chunk-NSR4DZXS.js";
+} from "./chunk-M4S7PORQ.js";
 import {
   VERSION
-} from "./chunk-WLUQZCIH.js";
+} from "./chunk-TNE5QSJ4.js";
 import {
   getEventCatalogConfigFile,
   verifyRequiredFieldsAreInCatalogConfigFile

package/dist/generate.cjs

@@ -78,7 +78,7 @@ var getEventCatalogConfigFile = async (projectDirectory) => {
 var import_picocolors = __toESM(require("picocolors"), 1);
 
 // package.json
-var version = "3.39.4";
+var version = "3.39.5";
 
 // src/constants.ts
 var VERSION = version;

package/dist/generate.js

@@ -1,8 +1,8 @@
 import {
   generate
-} from "./chunk-PVOVC2UV.js";
-import "./chunk-NSR4DZXS.js";
-import "./chunk-WLUQZCIH.js";
+} from "./chunk-S4HLJWQ7.js";
+import "./chunk-M4S7PORQ.js";
+import "./chunk-TNE5QSJ4.js";
 import "./chunk-5T63CXKU.js";
 export {
   generate

package/dist/utils/cli-logger.cjs

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(cli_logger_exports);
 var import_picocolors = __toESM(require("picocolors"), 1);
 
 // package.json
-var version = "3.39.4";
+var version = "3.39.5";
 
 // src/constants.ts
 var VERSION = version;

package/dist/utils/cli-logger.js

@@ -1,7 +1,7 @@
 import {
   logger
-} from "../chunk-NSR4DZXS.js";
-import "../chunk-WLUQZCIH.js";
+} from "../chunk-M4S7PORQ.js";
+import "../chunk-TNE5QSJ4.js";
 export {
   logger
 };

package/eventcatalog/src/layouts/VerticalSideBarLayout.astro

@@ -64,6 +64,7 @@ import { isCollectionVisibleInCatalog } from '@eventcatalog';
 import { buildUrl } from '@utils/url-builder';
 import { getQueries } from '@utils/collections/queries';
 import { hasLandingPageForDocs } from '@utils/pages';
+import { filterSidebarItems } from '@utils/sidebar-visibility';
 
 import { isEmbedEnabled, isCustomStylesEnabled, isEventCatalogScaleEnabled, isCustomDocsEnabled, isSSR } from '@utils/feature';
 
@@ -128,66 +129,66 @@ const getDefaultUrl = (route: string, defaultValue: string) => {
 
 const userSideBarConfiguration = config.sidebar || [];
 
-const navigationItems = [
-  {
-    id: '/',
-    label: 'Catalog',
-    icon: BookOpen,
-    href: buildUrl(config.landingPage || '/'),
-    current:
-      currentPath === '/' ||
-      (currentPath.includes('/docs') && !currentPath.includes('/docs/custom')) ||
-      currentPath.includes('/architecture/') ||
-      currentPath.includes('/visualiser') ||
-      (currentPath.includes('/schemas') &&
-        !currentPath.includes('/schemas/explorer') &&
-        !currentPath.includes('/schemas/fields')),
-  },
-  {
-    id: '/docs/custom',
-    label: 'Documentation',
-    icon: FileText,
-    href: getDefaultUrl('docs/custom', '/docs/custom'),
-    current: currentPath.includes('/docs/custom'),
-    isPremium: true,
-    visible: isCustomDocsEnabled() && customDocs.length > 0,
-  },
-  {
-    id: '/schemas/explorer',
-    label: 'Schemas',
-    icon: FileCode,
-    href: buildUrl('/schemas/explorer'),
-    current: currentPath.includes('/schemas/explorer') && !currentPath.includes('/schemas/fields'),
-  },
-  ...(isSSR()
-    ? [
-        {
-          id: '/schemas/fields',
-          label: 'Schema Insights',
-          icon: Waypoints,
-          href: buildUrl('/schemas/fields'),
-          current: currentPath.includes('/schemas/fields'),
-        },
-      ]
-    : []),
-].filter((item) => {
-  const userSideBarOption = userSideBarConfiguration.find((config: { id: string; visible: boolean }) => config.id === item.id);
-  const defaultVisible = item.visible ?? true;
-  return userSideBarOption ? userSideBarOption.visible : defaultVisible;
-});
-
-const studioNavigationItem = [
-  {
-    id: '/studio',
-    label: 'EventCatalog Studio',
-    icon: SquareDashedMousePointerIcon,
-    href: buildUrl('/studio'),
-    current: currentPath.includes('/studio'),
-  },
-].filter((item) => {
-  const userSideBarOption = userSideBarConfiguration.find((config: { id: string; visible: boolean }) => config.id === item.id);
-  return userSideBarOption ? userSideBarOption.visible : true;
-});
+const navigationItems = filterSidebarItems(
+  [
+    {
+      id: '/',
+      label: 'Catalog',
+      icon: BookOpen,
+      href: buildUrl(config.landingPage || '/'),
+      current:
+        currentPath === '/' ||
+        (currentPath.includes('/docs') && !currentPath.includes('/docs/custom')) ||
+        currentPath.includes('/architecture/') ||
+        currentPath.includes('/visualiser') ||
+        (currentPath.includes('/schemas') &&
+          !currentPath.includes('/schemas/explorer') &&
+          !currentPath.includes('/schemas/fields')),
+    },
+    {
+      id: '/docs/custom',
+      aliases: ['/docs'],
+      label: 'Documentation',
+      icon: FileText,
+      href: getDefaultUrl('docs/custom', '/docs/custom'),
+      current: currentPath.includes('/docs/custom'),
+      isPremium: true,
+      visible: isCustomDocsEnabled() && customDocs.length > 0,
+    },
+    {
+      id: '/schemas/explorer',
+      label: 'Schemas',
+      icon: FileCode,
+      href: buildUrl('/schemas/explorer'),
+      current: currentPath.includes('/schemas/explorer') && !currentPath.includes('/schemas/fields'),
+    },
+    ...(isSSR()
+      ? [
+          {
+            id: '/schemas/fields',
+            label: 'Schema Insights',
+            icon: Waypoints,
+            href: buildUrl('/schemas/fields'),
+            current: currentPath.includes('/schemas/fields'),
+          },
+        ]
+      : []),
+  ],
+  userSideBarConfiguration
+);
+
+const studioNavigationItem = filterSidebarItems(
+  [
+    {
+      id: '/studio',
+      label: 'EventCatalog Studio',
+      icon: SquareDashedMousePointerIcon,
+      href: buildUrl('/studio'),
+      current: currentPath.includes('/studio'),
+    },
+  ],
+  userSideBarConfiguration
+);
 
 const premiumFeatures: Array<{
   id: string;
@@ -198,86 +199,119 @@ const premiumFeatures: Array<{
   isPremium?: boolean;
 }> = [];
 
-const browseItems = [
-  {
-    label: 'Domains',
-    icon: RectangleGroupIcon,
-    href: buildUrl('/discover/domains'),
-    current: currentPath === buildUrl('/discover/domains'),
-  },
-  {
-    label: 'Services',
-    icon: ServerIcon,
-    href: buildUrl('/discover/services'),
-    current: currentPath === buildUrl('/discover/services'),
-  },
-  {
-    label: 'External Systems',
-    icon: GlobeAltIcon,
-    href: buildUrl('/discover/external-systems'),
-    current: currentPath === buildUrl('/discover/external-systems'),
-  },
-  {
-    label: 'Events',
-    icon: BoltIcon,
-    href: buildUrl('/discover/events'),
-    current: currentPath === buildUrl('/discover/events'),
-  },
-  {
-    label: 'Commands',
-    icon: ChatBubbleLeftIcon,
-    href: buildUrl('/discover/commands'),
-    current: currentPath === buildUrl('/discover/commands'),
-  },
-  {
-    label: 'Queries',
-    icon: MagnifyingGlassIcon,
-    href: buildUrl('/discover/queries'),
-    current: currentPath === buildUrl('/discover/queries'),
-  },
-  {
-    label: 'Flows',
-    icon: QueueListIcon,
-    href: buildUrl('/discover/flows'),
-    current: currentPath === buildUrl('/discover/flows'),
-  },
-  {
-    label: 'Data Stores',
-    icon: Database,
-    href: buildUrl('/discover/containers'),
-    current: currentPath === buildUrl('/discover/containers'),
-  },
-  {
-    label: 'Data Products',
-    icon: CubeIcon,
-    href: buildUrl('/discover/data-products'),
-    current: currentPath === buildUrl('/discover/data-products'),
-  },
-];
-
-const organizationItems = [
-  {
-    label: 'Teams',
-    icon: UsersRound,
-    href: buildUrl('/directory/teams'),
-    current: currentPath === buildUrl('/directory/teams'),
-  },
-  {
-    label: 'Users',
-    icon: UserRound,
-    href: buildUrl('/directory/users'),
-    current: currentPath === buildUrl('/directory/users'),
-  },
-];
-
-const settingsItems = [
-  {
-    label: 'Settings',
-    icon: Settings,
-    href: buildUrl('/settings/general'),
-    current: currentPath.startsWith(buildUrl('/settings')),
-  },
-];
+const browseItems = filterSidebarItems(
+  [
+    {
+      id: '/discover/domains',
+      aliases: ['/discover'],
+      label: 'Domains',
+      icon: RectangleGroupIcon,
+      href: buildUrl('/discover/domains'),
+      current: currentPath === buildUrl('/discover/domains'),
+    },
+    {
+      id: '/discover/services',
+      aliases: ['/discover'],
+      label: 'Services',
+      icon: ServerIcon,
+      href: buildUrl('/discover/services'),
+      current: currentPath === buildUrl('/discover/services'),
+    },
+    {
+      id: '/discover/external-systems',
+      aliases: ['/discover'],
+      label: 'External Systems',
+      icon: GlobeAltIcon,
+      href: buildUrl('/discover/external-systems'),
+      current: currentPath === buildUrl('/discover/external-systems'),
+    },
+    {
+      id: '/discover/events',
+      aliases: ['/discover'],
+      label: 'Events',
+      icon: BoltIcon,
+      href: buildUrl('/discover/events'),
+      current: currentPath === buildUrl('/discover/events'),
+    },
+    {
+      id: '/discover/commands',
+      aliases: ['/discover'],
+      label: 'Commands',
+      icon: ChatBubbleLeftIcon,
+      href: buildUrl('/discover/commands'),
+      current: currentPath === buildUrl('/discover/commands'),
+    },
+    {
+      id: '/discover/queries',
+      aliases: ['/discover'],
+      label: 'Queries',
+      icon: MagnifyingGlassIcon,
+      href: buildUrl('/discover/queries'),
+      current: currentPath === buildUrl('/discover/queries'),
+    },
+    {
+      id: '/discover/flows',
+      aliases: ['/discover'],
+      label: 'Flows',
+      icon: QueueListIcon,
+      href: buildUrl('/discover/flows'),
+      current: currentPath === buildUrl('/discover/flows'),
+    },
+    {
+      id: '/discover/containers',
+      aliases: ['/discover'],
+      label: 'Data Stores',
+      icon: Database,
+      href: buildUrl('/discover/containers'),
+      current: currentPath === buildUrl('/discover/containers'),
+    },
+    {
+      id: '/discover/data-products',
+      aliases: ['/discover'],
+      label: 'Data Products',
+      icon: CubeIcon,
+      href: buildUrl('/discover/data-products'),
+      current: currentPath === buildUrl('/discover/data-products'),
+    },
+  ],
+  userSideBarConfiguration
+);
+
+const organizationItems = filterSidebarItems(
+  [
+    {
+      id: '/directory/teams',
+      aliases: ['/directory'],
+      label: 'Teams',
+      icon: UsersRound,
+      href: buildUrl('/directory/teams'),
+      current: currentPath === buildUrl('/directory/teams'),
+    },
+    {
+      id: '/directory/users',
+      aliases: ['/directory'],
+      label: 'Users',
+      icon: UserRound,
+      href: buildUrl('/directory/users'),
+      current: currentPath === buildUrl('/directory/users'),
+    },
+  ],
+  userSideBarConfiguration
+);
+
+const settingsItems = filterSidebarItems(
+  [
+    {
+      id: '/settings/general',
+      aliases: ['/settings'],
+      label: 'Settings',
+      icon: Settings,
+      href: buildUrl('/settings/general'),
+      current: currentPath.startsWith(buildUrl('/settings')),
+    },
+  ],
+  userSideBarConfiguration
+);
 
 const currentNavigationItem = [...navigationItems, ...studioNavigationItem, ...premiumFeatures].find((item) => item.current);
 const { title, description, showNestedSideBar = true, showHeader = true } = Astro.props;
@@ -521,58 +555,64 @@ const canPageBeEmbedded = isEmbedEnabled();
               })
             }
 
-            <hr class="rail-divider my-3 border-t border-[rgb(var(--ec-sidebar-border)/0.7)]" />
-
-            <div
-              class="rail-section-label px-3 pb-1 text-[0.65rem] font-semibold tracking-[0.18em] uppercase text-[rgb(var(--ec-sidebar-text)/0.5)]"
-            >
-              Browse
-            </div>
-
             {
-              browseItems.map((item) => (
-                <a
-                  href={item.href}
-                  data-role="secondary-nav-item"
-                  aria-label={item.label}
-                  class={`nav-secondary-item flex items-center gap-3 px-3 py-2.5 rounded-xl border text-[13px] font-medium transition-all duration-150 ${
-                    item.current
-                      ? 'border-[rgb(var(--ec-accent)/0.2)] bg-[rgb(var(--ec-page-bg)/0.88)] text-[rgb(var(--ec-accent))] shadow-sm'
-                      : 'border-transparent text-[rgb(var(--ec-sidebar-text))] hover:border-[rgb(var(--ec-sidebar-border)/0.65)] hover:bg-[rgb(var(--ec-page-bg)/0.78)] hover:text-[rgb(var(--ec-page-text))]'
-                  }`}
-                  title={item.label}
-                >
-                  <item.icon className="h-3.5 w-3.5 flex-shrink-0" aria-hidden="true" />
-                  <span class="nav-item-label">{item.label}</span>
-                </a>
-              ))
+              browseItems.length > 0 && (
+                <Fragment>
+                  <hr class="rail-divider my-3 border-t border-[rgb(var(--ec-sidebar-border)/0.7)]" />
+
+                  <div class="rail-section-label px-3 pb-1 text-[0.65rem] font-semibold tracking-[0.18em] uppercase text-[rgb(var(--ec-sidebar-text)/0.5)]">
+                    Browse
+                  </div>
+
+                  {browseItems.map((item) => (
+                    <a
+                      id={item.id}
+                      href={item.href}
+                      data-role="secondary-nav-item"
+                      aria-label={item.label}
+                      class={`nav-secondary-item flex items-center gap-3 px-3 py-2.5 rounded-xl border text-[13px] font-medium transition-all duration-150 ${
+                        item.current
+                          ? 'border-[rgb(var(--ec-accent)/0.2)] bg-[rgb(var(--ec-page-bg)/0.88)] text-[rgb(var(--ec-accent))] shadow-sm'
+                          : 'border-transparent text-[rgb(var(--ec-sidebar-text))] hover:border-[rgb(var(--ec-sidebar-border)/0.65)] hover:bg-[rgb(var(--ec-page-bg)/0.78)] hover:text-[rgb(var(--ec-page-text))]'
+                      }`}
+                      title={item.label}
+                    >
+                      <item.icon className="h-3.5 w-3.5 flex-shrink-0" aria-hidden="true" />
+                      <span class="nav-item-label">{item.label}</span>
+                    </a>
+                  ))}
+                </Fragment>
+              )
             }
 
-            <hr class="rail-divider my-3 border-t border-[rgb(var(--ec-sidebar-border)/0.7)]" />
-
-            <div
-              class="rail-section-label px-3 pb-1 text-[0.65rem] font-semibold tracking-[0.18em] uppercase text-[rgb(var(--ec-sidebar-text)/0.5)]"
-            >
-              Organization
-            </div>
-
             {
-              organizationItems.map((item) => (
-                <a
-                  href={item.href}
-                  data-role="secondary-nav-item"
-                  aria-label={item.label}
-                  class={`nav-secondary-item flex items-center gap-3 px-3 py-2.5 rounded-xl border text-[13px] font-medium transition-all duration-150 ${
-                    item.current
-                      ? 'border-[rgb(var(--ec-accent)/0.2)] bg-[rgb(var(--ec-page-bg)/0.88)] text-[rgb(var(--ec-accent))] shadow-sm'
-                      : 'border-transparent text-[rgb(var(--ec-sidebar-text))] hover:border-[rgb(var(--ec-sidebar-border)/0.65)] hover:bg-[rgb(var(--ec-page-bg)/0.78)] hover:text-[rgb(var(--ec-page-text))]'
-                  }`}
-                  title={item.label}
-                >
-                  <item.icon className="h-3.5 w-3.5 flex-shrink-0" aria-hidden="true" />
-                  <span class="nav-item-label">{item.label}</span>
-                </a>
-              ))
+              organizationItems.length > 0 && (
+                <Fragment>
+                  <hr class="rail-divider my-3 border-t border-[rgb(var(--ec-sidebar-border)/0.7)]" />
+
+                  <div class="rail-section-label px-3 pb-1 text-[0.65rem] font-semibold tracking-[0.18em] uppercase text-[rgb(var(--ec-sidebar-text)/0.5)]">
+                    Organization
+                  </div>
+
+                  {organizationItems.map((item) => (
+                    <a
+                      id={item.id}
+                      href={item.href}
+                      data-role="secondary-nav-item"
+                      aria-label={item.label}
+                      class={`nav-secondary-item flex items-center gap-3 px-3 py-2.5 rounded-xl border text-[13px] font-medium transition-all duration-150 ${
+                        item.current
+                          ? 'border-[rgb(var(--ec-accent)/0.2)] bg-[rgb(var(--ec-page-bg)/0.88)] text-[rgb(var(--ec-accent))] shadow-sm'
+                          : 'border-transparent text-[rgb(var(--ec-sidebar-text))] hover:border-[rgb(var(--ec-sidebar-border)/0.65)] hover:bg-[rgb(var(--ec-page-bg)/0.78)] hover:text-[rgb(var(--ec-page-text))]'
+                      }`}
+                      title={item.label}
+                    >
+                      <item.icon className="h-3.5 w-3.5 flex-shrink-0" aria-hidden="true" />
+                      <span class="nav-item-label">{item.label}</span>
+                    </a>
+                  ))}
+                </Fragment>
+              )
             }
 
             {premiumFeatures.length > 0 && <hr class="rail-divider my-2 border-t border-[rgb(var(--ec-sidebar-border)/0.7)]" />}
@@ -598,24 +638,29 @@ const canPageBeEmbedded = isEmbedEnabled();
             }
 
             <div class="mt-auto pt-3">
-              <hr class="rail-divider mb-3 border-t border-[rgb(var(--ec-sidebar-border)/0.7)]" />
               {
-                settingsItems.map((item) => (
-                  <a
-                    href={item.href}
-                    data-role="secondary-nav-item"
-                    aria-label={item.label}
-                    class={`nav-secondary-item flex items-center gap-3 px-3 py-2.5 rounded-xl border text-[13px] font-medium transition-all duration-150 ${
-                      item.current
-                        ? 'border-[rgb(var(--ec-accent)/0.2)] bg-[rgb(var(--ec-page-bg)/0.88)] text-[rgb(var(--ec-accent))] shadow-sm'
-                        : 'border-transparent text-[rgb(var(--ec-sidebar-text))] hover:border-[rgb(var(--ec-sidebar-border)/0.65)] hover:bg-[rgb(var(--ec-page-bg)/0.78)] hover:text-[rgb(var(--ec-page-text))]'
-                    }`}
-                    title={item.label}
-                  >
-                    <item.icon className="h-4 w-4 flex-shrink-0" aria-hidden="true" />
-                    <span class="nav-item-label">{item.label}</span>
-                  </a>
-                ))
+                settingsItems.length > 0 && (
+                  <Fragment>
+                    <hr class="rail-divider mb-3 border-t border-[rgb(var(--ec-sidebar-border)/0.7)]" />
+                    {settingsItems.map((item) => (
+                      <a
+                        id={item.id}
+                        href={item.href}
+                        data-role="secondary-nav-item"
+                        aria-label={item.label}
+                        class={`nav-secondary-item flex items-center gap-3 px-3 py-2.5 rounded-xl border text-[13px] font-medium transition-all duration-150 ${
+                          item.current
+                            ? 'border-[rgb(var(--ec-accent)/0.2)] bg-[rgb(var(--ec-page-bg)/0.88)] text-[rgb(var(--ec-accent))] shadow-sm'
+                            : 'border-transparent text-[rgb(var(--ec-sidebar-text))] hover:border-[rgb(var(--ec-sidebar-border)/0.65)] hover:bg-[rgb(var(--ec-page-bg)/0.78)] hover:text-[rgb(var(--ec-page-text))]'
+                        }`}
+                        title={item.label}
+                      >
+                        <item.icon className="h-4 w-4 flex-shrink-0" aria-hidden="true" />
+                        <span class="nav-item-label">{item.label}</span>
+                      </a>
+                    ))}
+                  </Fragment>
+                )
               }
             </div>
           </nav>

package/eventcatalog/src/utils/sidebar-visibility.ts

@@ -0,0 +1,41 @@
+export type SidebarVisibilityConfig = {
+  id: string;
+  visible: boolean;
+};
+
+export type SidebarConfigurableItem = {
+  id: string;
+  aliases?: string[];
+  visible?: boolean;
+};
+
+const getVisibilityOption = <T extends SidebarConfigurableItem>(
+  item: T,
+  configuration: SidebarVisibilityConfig[]
+): SidebarVisibilityConfig | undefined => {
+  const exactMatch = configuration.find((option) => option.id === item.id);
+
+  if (exactMatch) {
+    return exactMatch;
+  }
+
+  return configuration.find((option) => item.aliases?.includes(option.id));
+};
+
+export const isSidebarItemVisible = <T extends SidebarConfigurableItem>(
+  item: T,
+  configuration: SidebarVisibilityConfig[] = []
+): boolean => {
+  const visibilityOption = getVisibilityOption(item, configuration);
+
+  if (visibilityOption) {
+    return visibilityOption.visible;
+  }
+
+  return item.visible ?? true;
+};
+
+export const filterSidebarItems = <T extends SidebarConfigurableItem>(
+  items: T[],
+  configuration: SidebarVisibilityConfig[] = []
+): T[] => items.filter((item) => isSidebarItemVisible(item, configuration));

package/package.json

@@ -7,7 +7,7 @@
   },
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",
-  "version": "3.39.4",
+  "version": "3.39.5",
   "publishConfig": {
     "access": "public"
   },
@@ -106,9 +106,9 @@
     "update-notifier": "^7.3.1",
     "uuid": "^10.0.0",
     "zod": "^4.3.6",
-    "@eventcatalog/sdk": "2.21.1",
+    "@eventcatalog/linter": "1.0.23",
     "@eventcatalog/visualiser": "^3.21.0",
-    "@eventcatalog/linter": "1.0.23"
+    "@eventcatalog/sdk": "2.21.1"
   },
   "devDependencies": {
     "@astrojs/check": "^0.9.9",