@eventcatalog/core 2.47.1 → 2.48.0

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 = "2.47.1";
+var version = "2.48.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/analytics.js

@@ -1,7 +1,7 @@
 import {
   raiseEvent
-} from "../chunk-QWDFTW7H.js";
-import "../chunk-WWYOMQLW.js";
+} from "../chunk-LK6C3F6Q.js";
+import "../chunk-I755G24S.js";
 export {
   raiseEvent
 };

package/dist/analytics/log-build.cjs

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

package/dist/analytics/log-build.js

@@ -1,8 +1,8 @@
 import {
   log_build_default
-} from "../chunk-YJYT2E6S.js";
-import "../chunk-QWDFTW7H.js";
-import "../chunk-WWYOMQLW.js";
+} from "../chunk-RW4O4UUQ.js";
+import "../chunk-LK6C3F6Q.js";
+import "../chunk-I755G24S.js";
 import "../chunk-E7TXTI7G.js";
 export {
   log_build_default as default

package/dist/catalog-to-astro-content-directory.cjs

@@ -153,6 +153,8 @@ function isCatalogRelated(filePath) {
     // custom styles file at root
     "components",
     // custom components
+    "snippets",
+    // custom snippets
     "public",
     // public assets
     ".env",
@@ -175,6 +177,9 @@ function getBaseTargetPaths(filePath) {
   if (filePathArr[0] == "components") {
     return [import_node_path2.default.join("src", "custom-defined-components")];
   }
+  if (filePathArr[0] == "snippets") {
+    return [import_node_path2.default.join("src")];
+  }
   if (filePathArr[0] == "public") {
     return [import_node_path2.default.join("public")];
   }
@@ -185,10 +190,14 @@ function getRelativeTargetPath(filePath) {
   if (filePathArr[0] == "public" || filePathArr[0] == "components") {
     filePathArr.shift();
   }
+  if (filePathArr[0] == "snippets") {
+    console.log("SNIPPETS", filePathArr);
+    return import_node_path2.default.join("snippets", ...filePathArr.slice(1));
+  }
   const relativePath = [];
   for (let i = filePathArr.length - 1; i >= 0; i--) {
     relativePath.unshift(filePathArr[i]);
-    if (isCollectionKey(filePathArr[i])) break;
+    if (isCollectionKey(filePathArr[i]) && filePathArr[i] != "snippets") break;
   }
   return import_node_path2.default.join(...relativePath);
 }
@@ -202,6 +211,13 @@ var copyFiles = async (source, target) => {
     windowsPathsNoEscape: import_node_os.default.platform() == "win32",
     ignore: ["node_modules/**", "**/dist/**", "**/teams", "**/users", "**/*.mdx", "**/*.md", "**/package.json", "**/Dockerfile"]
   });
+  const snippets = await (0, import_glob.glob)(path3.join(source, "snippets/**/*.mdx"), {
+    nodir: true,
+    windowsPathsNoEscape: import_node_os.default.platform() == "win32"
+  });
+  if (snippets.length > 0) {
+    files.push(...snippets);
+  }
   if (import_fs.default.existsSync(path3.join(source, ".env"))) {
     files.push(path3.join(source, ".env"));
   }

package/dist/catalog-to-astro-content-directory.js

@@ -1,8 +1,8 @@
 import {
   catalogToAstro,
   checkAndConvertMdToMdx
-} from "./chunk-SFA7F3CQ.js";
-import "./chunk-EXAALOQA.js";
+} from "./chunk-B53UJPGW.js";
+import "./chunk-WDTWWPPX.js";
 import "./chunk-E7TXTI7G.js";
 export {
   catalogToAstro,

package/dist/{chunk-SFA7F3CQ.js → chunk-B53UJPGW.js}

@@ -1,6 +1,6 @@
 import {
   mapCatalogToAstro
-} from "./chunk-EXAALOQA.js";
+} from "./chunk-WDTWWPPX.js";
 import {
   verifyRequiredFieldsAreInCatalogConfigFile
 } from "./chunk-E7TXTI7G.js";
@@ -19,6 +19,13 @@ var copyFiles = async (source, target) => {
     windowsPathsNoEscape: os.platform() == "win32",
     ignore: ["node_modules/**", "**/dist/**", "**/teams", "**/users", "**/*.mdx", "**/*.md", "**/package.json", "**/Dockerfile"]
   });
+  const snippets = await glob(path.join(source, "snippets/**/*.mdx"), {
+    nodir: true,
+    windowsPathsNoEscape: os.platform() == "win32"
+  });
+  if (snippets.length > 0) {
+    files.push(...snippets);
+  }
   if (fs.existsSync(path.join(source, ".env"))) {
     files.push(path.join(source, ".env"));
   }

package/dist/{chunk-WWYOMQLW.js → chunk-I755G24S.js}

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

package/dist/{chunk-QWDFTW7H.js → chunk-LK6C3F6Q.js}

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

package/dist/{chunk-DCLTVJDP.js → chunk-MDWGYIVH.js}

@@ -1,6 +1,6 @@
 import {
   mapCatalogToAstro
-} from "./chunk-EXAALOQA.js";
+} from "./chunk-WDTWWPPX.js";
 
 // src/watcher.js
 import watcher from "@parcel/watcher";
@@ -21,7 +21,7 @@ async function watch(projectDirectory, catalogDirectory, callback = void 0) {
         }
         for (let event of events) {
           const { path: filePath, type } = event;
-          if (filePath.endsWith(".mdx") || filePath.endsWith(".md")) {
+          if ((filePath.endsWith(".mdx") || filePath.endsWith(".md")) && !filePath.includes("snippets")) {
             continue;
           }
           const astroPaths = mapCatalogToAstro({

package/dist/{chunk-YJYT2E6S.js → chunk-RW4O4UUQ.js}

@@ -1,6 +1,6 @@
 import {
   raiseEvent
-} from "./chunk-QWDFTW7H.js";
+} from "./chunk-LK6C3F6Q.js";
 import {
   getEventCatalogConfigFile,
   verifyRequiredFieldsAreInCatalogConfigFile

package/dist/{chunk-EXAALOQA.js → chunk-WDTWWPPX.js}

@@ -38,6 +38,8 @@ function isCatalogRelated(filePath) {
     // custom styles file at root
     "components",
     // custom components
+    "snippets",
+    // custom snippets
     "public",
     // public assets
     ".env",
@@ -60,6 +62,9 @@ function getBaseTargetPaths(filePath) {
   if (filePathArr[0] == "components") {
     return [path.join("src", "custom-defined-components")];
   }
+  if (filePathArr[0] == "snippets") {
+    return [path.join("src")];
+  }
   if (filePathArr[0] == "public") {
     return [path.join("public")];
   }
@@ -70,10 +75,14 @@ function getRelativeTargetPath(filePath) {
   if (filePathArr[0] == "public" || filePathArr[0] == "components") {
     filePathArr.shift();
   }
+  if (filePathArr[0] == "snippets") {
+    console.log("SNIPPETS", filePathArr);
+    return path.join("snippets", ...filePathArr.slice(1));
+  }
   const relativePath = [];
   for (let i = filePathArr.length - 1; i >= 0; i--) {
     relativePath.unshift(filePathArr[i]);
-    if (isCollectionKey(filePathArr[i])) break;
+    if (isCollectionKey(filePathArr[i]) && filePathArr[i] != "snippets") break;
   }
   return path.join(...relativePath);
 }

package/dist/constants.cjs

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

package/dist/constants.js

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

package/dist/eventcatalog.cjs

@@ -29,9 +29,9 @@ var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
 // src/eventcatalog.ts
 var import_commander = require("commander");
 var import_node_child_process = require("child_process");
-var import_node_path7 = require("path");
+var import_node_path6 = require("path");
 var import_fs2 = __toESM(require("fs"), 1);
-var import_node_path8 = __toESM(require("path"), 1);
+var import_node_path7 = __toESM(require("path"), 1);
 var import_node_url = require("url");
 var import_concurrently = __toESM(require("concurrently"), 1);
 
@@ -157,7 +157,7 @@ var import_axios = __toESM(require("axios"), 1);
 var import_os = __toESM(require("os"), 1);
 
 // package.json
-var version = "2.47.1";
+var version = "2.48.0";
 
 // src/constants.ts
 var VERSION = version;
@@ -268,6 +268,8 @@ function isCatalogRelated(filePath) {
     // custom styles file at root
     "components",
     // custom components
+    "snippets",
+    // custom snippets
     "public",
     // public assets
     ".env",
@@ -290,6 +292,9 @@ function getBaseTargetPaths(filePath) {
   if (filePathArr[0] == "components") {
     return [import_node_path3.default.join("src", "custom-defined-components")];
   }
+  if (filePathArr[0] == "snippets") {
+    return [import_node_path3.default.join("src")];
+  }
   if (filePathArr[0] == "public") {
     return [import_node_path3.default.join("public")];
   }
@@ -300,17 +305,20 @@ function getRelativeTargetPath(filePath) {
   if (filePathArr[0] == "public" || filePathArr[0] == "components") {
     filePathArr.shift();
   }
+  if (filePathArr[0] == "snippets") {
+    console.log("SNIPPETS", filePathArr);
+    return import_node_path3.default.join("snippets", ...filePathArr.slice(1));
+  }
   const relativePath = [];
   for (let i = filePathArr.length - 1; i >= 0; i--) {
     relativePath.unshift(filePathArr[i]);
-    if (isCollectionKey(filePathArr[i])) break;
+    if (isCollectionKey(filePathArr[i]) && filePathArr[i] != "snippets") break;
   }
   return import_node_path3.default.join(...relativePath);
 }
 
 // src/watcher.js
 var import_rimraf = require("rimraf");
-var import_node_path4 = __toESM(require("path"), 1);
 async function watch(projectDirectory, catalogDirectory, callback = void 0) {
   const subscription = await import_watcher.default.subscribe(
     projectDirectory,
@@ -326,7 +334,7 @@ async function watch(projectDirectory, catalogDirectory, callback = void 0) {
         }
         for (let event of events) {
           const { path: filePath, type } = event;
-          if (filePath.endsWith(".mdx") || filePath.endsWith(".md")) {
+          if ((filePath.endsWith(".mdx") || filePath.endsWith(".md")) && !filePath.includes("snippets")) {
             continue;
           }
           const astroPaths = mapCatalogToAstro({
@@ -391,20 +399,27 @@ function retryEPERM(fn) {
 
 // src/catalog-to-astro-content-directory.js
 var import_glob = require("glob");
-var path5 = __toESM(require("path"), 1);
+var path4 = __toESM(require("path"), 1);
 var import_fs = __toESM(require("fs"), 1);
 var import_url2 = require("url");
 var import_node_os = __toESM(require("os"), 1);
 var __filename2 = (0, import_url2.fileURLToPath)(importMetaUrl);
-var rootPkg = path5.resolve(path5.dirname(__filename2), "../");
+var rootPkg = path4.resolve(path4.dirname(__filename2), "../");
 var copyFiles = async (source, target) => {
-  const files = await (0, import_glob.glob)(path5.join(source, "**"), {
+  const files = await (0, import_glob.glob)(path4.join(source, "**"), {
     nodir: true,
     windowsPathsNoEscape: import_node_os.default.platform() == "win32",
     ignore: ["node_modules/**", "**/dist/**", "**/teams", "**/users", "**/*.mdx", "**/*.md", "**/package.json", "**/Dockerfile"]
   });
-  if (import_fs.default.existsSync(path5.join(source, ".env"))) {
-    files.push(path5.join(source, ".env"));
+  const snippets = await (0, import_glob.glob)(path4.join(source, "snippets/**/*.mdx"), {
+    nodir: true,
+    windowsPathsNoEscape: import_node_os.default.platform() == "win32"
+  });
+  if (snippets.length > 0) {
+    files.push(...snippets);
+  }
+  if (import_fs.default.existsSync(path4.join(source, ".env"))) {
+    files.push(path4.join(source, ".env"));
   }
   for (const file of files) {
     mapCatalogToAstro({
@@ -418,17 +433,17 @@ var copyFiles = async (source, target) => {
   }
 };
 var catalogToAstro = async (source, astroDir) => {
-  const astroContentDir = path5.join(astroDir, "src/content/");
+  const astroContentDir = path4.join(astroDir, "src/content/");
   if (import_fs.default.existsSync(astroContentDir)) import_fs.default.rmSync(astroContentDir, { recursive: true });
   import_fs.default.mkdirSync(astroContentDir);
   await verifyRequiredFieldsAreInCatalogConfigFile(source);
-  if (!import_fs.default.existsSync(path5.join(source, "eventcatalog.styles.css"))) {
-    import_fs.default.writeFileSync(path5.join(source, "eventcatalog.styles.css"), "");
+  if (!import_fs.default.existsSync(path4.join(source, "eventcatalog.styles.css"))) {
+    import_fs.default.writeFileSync(path4.join(source, "eventcatalog.styles.css"), "");
   }
   await copyFiles(source, astroDir);
 };
 var checkAndConvertMdToMdx = async (source, astroDir) => {
-  const files = await (0, import_glob.glob)(path5.join(source, "**"), {
+  const files = await (0, import_glob.glob)(path4.join(source, "**"), {
     nodir: true,
     windowsPathsNoEscape: import_node_os.default.platform() == "win32",
     ignore: ["node_modules/**", "**/dist/**", "**/README.md"]
@@ -444,7 +459,7 @@ var checkAndConvertMdToMdx = async (source, astroDir) => {
 };
 
 // src/resolve-catalog-dependencies.js
-var import_node_path5 = __toESM(require("path"), 1);
+var import_node_path4 = __toESM(require("path"), 1);
 var import_node_fs3 = __toESM(require("fs"), 1);
 var import_gray_matter2 = __toESM(require("gray-matter"), 1);
 var resolve_catalog_dependencies_default = async (catalogDir, core2) => {
@@ -453,7 +468,7 @@ var resolve_catalog_dependencies_default = async (catalogDir, core2) => {
   if (!dependencies) {
     return;
   }
-  const dependenciesDir = import_node_path5.default.join(catalogDir, "dependencies");
+  const dependenciesDir = import_node_path4.default.join(catalogDir, "dependencies");
   if (import_node_fs3.default.existsSync(dependenciesDir)) {
     import_node_fs3.default.rmSync(dependenciesDir, { recursive: true, force: true });
   }
@@ -477,8 +492,8 @@ var resolve_catalog_dependencies_default = async (catalogDir, core2) => {
         },
         frontmatter
       );
-      const resourceFile = import_node_path5.default.join(dependenciesDir, resourceType, dependency.id, `index.md`);
-      import_node_fs3.default.mkdirSync(import_node_path5.default.dirname(resourceFile), { recursive: true });
+      const resourceFile = import_node_path4.default.join(dependenciesDir, resourceType, dependency.id, `index.md`);
+      import_node_fs3.default.mkdirSync(import_node_path4.default.dirname(resourceFile), { recursive: true });
       import_node_fs3.default.writeFileSync(resourceFile, markdown);
     }
   }
@@ -490,7 +505,7 @@ var import_boxen2 = __toESM(require("boxen"), 1);
 
 // src/features.ts
 var import_boxen = __toESM(require("boxen"), 1);
-var import_node_path6 = require("path");
+var import_node_path5 = require("path");
 var import_node_fs4 = __toESM(require("fs"), 1);
 var isOutputServer = async () => {
   const config = await getEventCatalogConfigFile(process.env.PROJECT_DIR || "");
@@ -498,7 +513,7 @@ var isOutputServer = async () => {
 };
 var isAuthEnabled = async () => {
   const directory = process.env.PROJECT_DIR || process.cwd();
-  const hasAuthConfig = import_node_fs4.default.existsSync((0, import_node_path6.join)(directory, "eventcatalog.auth.js"));
+  const hasAuthConfig = import_node_fs4.default.existsSync((0, import_node_path5.join)(directory, "eventcatalog.auth.js"));
   return hasAuthConfig;
 };
 var isBackstagePluginEnabled = async (licenseKey) => {
@@ -632,14 +647,14 @@ var isEventCatalogStarterEnabled = async (licenseKey) => {
 // src/eventcatalog.ts
 var import_update_notifier = __toESM(require("update-notifier"), 1);
 var import_dotenv = __toESM(require("dotenv"), 1);
-var currentDir = import_node_path8.default.dirname((0, import_node_url.fileURLToPath)(importMetaUrl));
+var currentDir = import_node_path7.default.dirname((0, import_node_url.fileURLToPath)(importMetaUrl));
 var program = new import_commander.Command().version(VERSION);
-var dir = import_node_path8.default.resolve(process.env.PROJECT_DIR || process.cwd());
-var core = import_node_path8.default.resolve(process.env.CATALOG_DIR || (0, import_node_path7.join)(dir, ".eventcatalog-core"));
-var eventCatalogDir = import_node_path8.default.resolve((0, import_node_path7.join)(currentDir, "../eventcatalog/"));
+var dir = import_node_path7.default.resolve(process.env.PROJECT_DIR || process.cwd());
+var core = import_node_path7.default.resolve(process.env.CATALOG_DIR || (0, import_node_path6.join)(dir, ".eventcatalog-core"));
+var eventCatalogDir = import_node_path7.default.resolve((0, import_node_path6.join)(currentDir, "../eventcatalog/"));
 var getInstalledEventCatalogVersion = () => {
   try {
-    const pkg = import_fs2.default.readFileSync((0, import_node_path7.join)(dir, "package.json"), "utf8");
+    const pkg = import_fs2.default.readFileSync((0, import_node_path6.join)(dir, "package.json"), "utf8");
     const json = JSON.parse(pkg);
     return json.dependencies["@eventcatalog/core"];
   } catch (error) {
@@ -666,13 +681,13 @@ var copyCore = () => {
 };
 var copyServerFiles = async () => {
   const isServerOutput = await isOutputServer();
-  if (import_fs2.default.existsSync((0, import_node_path7.join)(core, "src/pages/api/server"))) {
-    import_fs2.default.rmSync((0, import_node_path7.join)(core, "src/pages/api/server"), { recursive: true });
+  if (import_fs2.default.existsSync((0, import_node_path6.join)(core, "src/pages/api/server"))) {
+    import_fs2.default.rmSync((0, import_node_path6.join)(core, "src/pages/api/server"), { recursive: true });
   }
   if (!isServerOutput) {
     return;
   }
-  import_fs2.default.cpSync((0, import_node_path7.join)(eventCatalogDir, "src/enterprise/eventcatalog-chat/pages/api"), (0, import_node_path7.join)(core, "src/pages/api/server"), {
+  import_fs2.default.cpSync((0, import_node_path6.join)(eventCatalogDir, "src/enterprise/eventcatalog-chat/pages/api"), (0, import_node_path6.join)(core, "src/pages/api/server"), {
     recursive: true
   });
 };
@@ -683,7 +698,7 @@ var createAuthFileIfNotExists = async (hasRequiredLicense) => {
     if (authEnabled && hasRequiredLicense && isSRR) {
       console.log("Creating auth file");
       import_fs2.default.writeFileSync(
-        (0, import_node_path7.join)(core, "src/pages/api/[...auth].ts"),
+        (0, import_node_path6.join)(core, "src/pages/api/[...auth].ts"),
         `import { AstroAuth } from 'auth-astro/server';
 export const prerender = false;
 export const { GET, POST } = AstroAuth();
@@ -726,8 +741,8 @@ Run npm i @eventcatalog/core to update`;
 };
 program.command("dev").description("Run development server of EventCatalog").option("-d, --debug", "Output EventCatalog application information into your terminal").option("--force-recreate", "Recreate the eventcatalog-core directory", false).action(async (options, command) => {
   console.log("Setting up EventCatalog....");
-  if (import_fs2.default.existsSync(import_node_path8.default.join(dir, ".env"))) {
-    import_dotenv.default.config({ path: import_node_path8.default.join(dir, ".env") });
+  if (import_fs2.default.existsSync(import_node_path7.default.join(dir, ".env"))) {
+    import_dotenv.default.config({ path: import_node_path7.default.join(dir, ".env") });
   }
   if (options.debug) {
     console.log("Debug mode enabled");
@@ -777,8 +792,8 @@ program.command("dev").description("Run development server of EventCatalog").opt
 });
 program.command("build").description("Run build of EventCatalog").action(async (options, command) => {
   console.log("Building EventCatalog...");
-  if (import_fs2.default.existsSync(import_node_path8.default.join(dir, ".env"))) {
-    import_dotenv.default.config({ path: import_node_path8.default.join(dir, ".env") });
+  if (import_fs2.default.existsSync(import_node_path7.default.join(dir, ".env"))) {
+    import_dotenv.default.config({ path: import_node_path7.default.join(dir, ".env") });
   }
   copyCore();
   await copyServerFiles();
@@ -836,8 +851,8 @@ var startServerCatalog = ({
 };
 program.command("preview").description("Serves the contents of your eventcatalog build directory").action(async (options, command) => {
   console.log("Starting preview of your build...");
-  if (import_fs2.default.existsSync(import_node_path8.default.join(dir, ".env"))) {
-    import_dotenv.default.config({ path: import_node_path8.default.join(dir, ".env") });
+  if (import_fs2.default.existsSync(import_node_path7.default.join(dir, ".env"))) {
+    import_dotenv.default.config({ path: import_node_path7.default.join(dir, ".env") });
   }
   const canEmbedPages = await isBackstagePluginEnabled();
   const isEventCatalogStarter = await isEventCatalogStarterEnabled();
@@ -848,8 +863,8 @@ program.command("preview").description("Serves the contents of your eventcatalog
 });
 program.command("start").description("Serves the contents of your eventcatalog build directory").action(async (options, command) => {
   console.log("Starting preview of your build...");
-  if (import_fs2.default.existsSync(import_node_path8.default.join(dir, ".env"))) {
-    import_dotenv.default.config({ path: import_node_path8.default.join(dir, ".env") });
+  if (import_fs2.default.existsSync(import_node_path7.default.join(dir, ".env"))) {
+    import_dotenv.default.config({ path: import_node_path7.default.join(dir, ".env") });
   }
   const canEmbedPages = await isBackstagePluginEnabled();
   const isEventCatalogStarter = await isEventCatalogStarterEnabled();
@@ -862,8 +877,8 @@ program.command("start").description("Serves the contents of your eventcatalog b
   }
 });
 program.command("generate [siteDir]").description("Start the generator scripts.").action(async () => {
-  if (import_fs2.default.existsSync(import_node_path8.default.join(dir, ".env"))) {
-    import_dotenv.default.config({ path: import_node_path8.default.join(dir, ".env") });
+  if (import_fs2.default.existsSync(import_node_path7.default.join(dir, ".env"))) {
+    import_dotenv.default.config({ path: import_node_path7.default.join(dir, ".env") });
   }
   await generate(dir);
 });

package/dist/eventcatalog.js

@@ -3,19 +3,19 @@ import {
 } from "./chunk-BLDONK5J.js";
 import {
   watch
-} from "./chunk-DCLTVJDP.js";
+} from "./chunk-MDWGYIVH.js";
 import {
   log_build_default
-} from "./chunk-YJYT2E6S.js";
-import "./chunk-QWDFTW7H.js";
+} from "./chunk-RW4O4UUQ.js";
+import "./chunk-LK6C3F6Q.js";
 import {
   catalogToAstro,
   checkAndConvertMdToMdx
-} from "./chunk-SFA7F3CQ.js";
-import "./chunk-EXAALOQA.js";
+} from "./chunk-B53UJPGW.js";
+import "./chunk-WDTWWPPX.js";
 import {
   VERSION
-} from "./chunk-WWYOMQLW.js";
+} from "./chunk-I755G24S.js";
 import {
   isAuthEnabled,
   isBackstagePluginEnabled,

package/dist/map-catalog-to-astro.cjs

@@ -72,6 +72,8 @@ function isCatalogRelated(filePath) {
     // custom styles file at root
     "components",
     // custom components
+    "snippets",
+    // custom snippets
     "public",
     // public assets
     ".env",
@@ -94,6 +96,9 @@ function getBaseTargetPaths(filePath) {
   if (filePathArr[0] == "components") {
     return [import_node_path.default.join("src", "custom-defined-components")];
   }
+  if (filePathArr[0] == "snippets") {
+    return [import_node_path.default.join("src")];
+  }
   if (filePathArr[0] == "public") {
     return [import_node_path.default.join("public")];
   }
@@ -104,10 +109,14 @@ function getRelativeTargetPath(filePath) {
   if (filePathArr[0] == "public" || filePathArr[0] == "components") {
     filePathArr.shift();
   }
+  if (filePathArr[0] == "snippets") {
+    console.log("SNIPPETS", filePathArr);
+    return import_node_path.default.join("snippets", ...filePathArr.slice(1));
+  }
   const relativePath = [];
   for (let i = filePathArr.length - 1; i >= 0; i--) {
     relativePath.unshift(filePathArr[i]);
-    if (isCollectionKey(filePathArr[i])) break;
+    if (isCollectionKey(filePathArr[i]) && filePathArr[i] != "snippets") break;
   }
   return import_node_path.default.join(...relativePath);
 }

package/dist/map-catalog-to-astro.js

@@ -1,6 +1,6 @@
 import {
   mapCatalogToAstro
-} from "./chunk-EXAALOQA.js";
+} from "./chunk-WDTWWPPX.js";
 export {
   mapCatalogToAstro
 };

package/dist/watcher.cjs

@@ -34,7 +34,7 @@ __export(watcher_exports, {
 });
 module.exports = __toCommonJS(watcher_exports);
 var import_watcher = __toESM(require("@parcel/watcher"), 1);
-var import_node_fs2 = __toESM(require("fs"), 1);
+var import_node_fs = __toESM(require("fs"), 1);
 
 // src/map-catalog-to-astro.js
 var import_node_path = __toESM(require("path"), 1);
@@ -76,6 +76,8 @@ function isCatalogRelated(filePath) {
     // custom styles file at root
     "components",
     // custom components
+    "snippets",
+    // custom snippets
     "public",
     // public assets
     ".env",
@@ -98,6 +100,9 @@ function getBaseTargetPaths(filePath) {
   if (filePathArr[0] == "components") {
     return [import_node_path.default.join("src", "custom-defined-components")];
   }
+  if (filePathArr[0] == "snippets") {
+    return [import_node_path.default.join("src")];
+  }
   if (filePathArr[0] == "public") {
     return [import_node_path.default.join("public")];
   }
@@ -108,27 +113,20 @@ function getRelativeTargetPath(filePath) {
   if (filePathArr[0] == "public" || filePathArr[0] == "components") {
     filePathArr.shift();
   }
+  if (filePathArr[0] == "snippets") {
+    console.log("SNIPPETS", filePathArr);
+    return import_node_path.default.join("snippets", ...filePathArr.slice(1));
+  }
   const relativePath = [];
   for (let i = filePathArr.length - 1; i >= 0; i--) {
     relativePath.unshift(filePathArr[i]);
-    if (isCollectionKey(filePathArr[i])) break;
+    if (isCollectionKey(filePathArr[i]) && filePathArr[i] != "snippets") break;
   }
   return import_node_path.default.join(...relativePath);
 }
 
 // src/watcher.js
 var import_rimraf = require("rimraf");
-
-// src/eventcatalog-config-file-utils.js
-var import_promises = require("fs/promises");
-var import_node_fs = require("fs");
-var import_promises2 = require("fs/promises");
-var import_node_path2 = __toESM(require("path"), 1);
-var import_uuid = require("uuid");
-var import_gray_matter = __toESM(require("gray-matter"), 1);
-
-// src/watcher.js
-var import_node_path3 = __toESM(require("path"), 1);
 async function watch(projectDirectory, catalogDirectory, callback = void 0) {
   const subscription = await import_watcher.default.subscribe(
     projectDirectory,
@@ -144,7 +142,7 @@ async function watch(projectDirectory, catalogDirectory, callback = void 0) {
         }
         for (let event of events) {
           const { path: filePath, type } = event;
-          if (filePath.endsWith(".mdx") || filePath.endsWith(".md")) {
+          if ((filePath.endsWith(".mdx") || filePath.endsWith(".md")) && !filePath.includes("snippets")) {
             continue;
           }
           const astroPaths = mapCatalogToAstro({
@@ -156,10 +154,10 @@ async function watch(projectDirectory, catalogDirectory, callback = void 0) {
             switch (type) {
               case "create":
               case "update":
-                if (import_node_fs2.default.statSync(filePath).isDirectory()) {
-                  import_node_fs2.default.mkdirSync(astroPath, { recursive: true });
+                if (import_node_fs.default.statSync(filePath).isDirectory()) {
+                  import_node_fs.default.mkdirSync(astroPath, { recursive: true });
                 } else {
-                  retryEPERM(import_node_fs2.default.cpSync)(filePath, astroPath);
+                  retryEPERM(import_node_fs.default.cpSync)(filePath, astroPath);
                 }
                 break;
               case "delete":

package/dist/watcher.js

@@ -1,8 +1,7 @@
 import {
   watch
-} from "./chunk-DCLTVJDP.js";
-import "./chunk-EXAALOQA.js";
-import "./chunk-E7TXTI7G.js";
+} from "./chunk-MDWGYIVH.js";
+import "./chunk-WDTWWPPX.js";
 export {
   watch
 };

package/eventcatalog/src/components/SideNav/ListViewSideBar/index.tsx

@@ -1,10 +1,11 @@
 import React, { useState, useEffect, useRef, useMemo, useCallback } from 'react';
-import { ChevronDownIcon } from '@heroicons/react/24/outline';
+import { ChevronDownIcon, ChevronDoubleDownIcon, ChevronDoubleUpIcon, XMarkIcon } from '@heroicons/react/24/outline';
 import { buildUrl, buildUrlWithParams } from '@utils/url-builder';
 import CollapsibleGroup from './components/CollapsibleGroup';
 import MessageList from './components/MessageList';
 import SpecificationsList from './components/SpecificationList';
 import type { MessageItem, ServiceItem, ListViewSideBarProps, DomainItem, FlowItem, Resources } from './types';
+import { PanelLeft } from 'lucide-react';
 const STORAGE_KEY = 'EventCatalog:catalogSidebarCollapsedGroups';
 const DEBOUNCE_DELAY = 300; // 300ms debounce delay
 
@@ -204,6 +205,7 @@ const ListViewSideBar: React.FC<ListViewSideBarProps> = ({ resources, currentPat
   const [searchTerm, setSearchTerm] = useState('');
   const [debouncedSearchTerm, setDebouncedSearchTerm] = useState('');
   const [isInitialized, setIsInitialized] = useState(false);
+  const [isExpanded, setIsExpanded] = useState(true);
   const [collapsedGroups, setCollapsedGroups] = useState<{ [key: string]: boolean }>(() => {
     if (typeof window !== 'undefined') {
       const saved = window.localStorage.getItem(STORAGE_KEY);
@@ -241,9 +243,55 @@ const ListViewSideBar: React.FC<ListViewSideBarProps> = ({ resources, currentPat
       );
     };
 
+    // Enhanced domain filtering that considers parent-subdomain relationships
+    const filterDomains = (domains: any[]) => {
+      const filteredDomains: any[] = [];
+
+      domains.forEach((domain: any) => {
+        const domainMatches = filterItem(domain);
+
+        // Check if this domain is a subdomain of another domain
+        const isSubdomain = domains.some((parentDomain: any) => {
+          const subdomains = parentDomain.domains || [];
+          return subdomains.some((subdomain: any) => subdomain.data.id === domain.id);
+        });
+
+        // If this is a parent domain, check if any of its subdomains match
+        let hasMatchingSubdomains = false;
+        if (!isSubdomain) {
+          const subdomains = domain.domains || [];
+          hasMatchingSubdomains = domains.some((potentialSubdomain: any) =>
+            subdomains.some((subdomain: any) => subdomain.data.id === potentialSubdomain.id && filterItem(potentialSubdomain))
+          );
+        }
+
+        // Include domain if:
+        // 1. The domain itself matches the search
+        // 2. It's a parent domain and has matching subdomains
+        // 3. It's a subdomain and matches the search
+        if (domainMatches || hasMatchingSubdomains || (isSubdomain && domainMatches)) {
+          filteredDomains.push(domain);
+        }
+
+        // If this is a subdomain that matches, also include its parent domain
+        if (isSubdomain && domainMatches) {
+          const parentDomain = domains.find((parentDomain: any) => {
+            const subdomains = parentDomain.domains || [];
+            return subdomains.some((subdomain: any) => subdomain.data.id === domain.id);
+          });
+
+          if (parentDomain && !filteredDomains.some((d: any) => d.id === parentDomain.id)) {
+            filteredDomains.push(parentDomain);
+          }
+        }
+      });
+
+      return filteredDomains;
+    };
+
     return {
       'context-map': data['context-map']?.filter(filterItem) || [],
-      domains: data.domains?.filter(filterItem) || [],
+      domains: data.domains ? filterDomains(data.domains) : [],
       services:
         data.services
           ?.map((service: ServiceItem) => ({
@@ -310,6 +358,65 @@ const ListViewSideBar: React.FC<ListViewSideBarProps> = ({ resources, currentPat
     setSearchTerm(e.target.value);
   }, []);
 
+  const collapseAll = useCallback(() => {
+    const newCollapsedState: { [key: string]: boolean } = {};
+
+    // Collapse all domains
+    filteredData.domains?.forEach((domain: any) => {
+      newCollapsedState[domain.href] = true;
+      newCollapsedState[`${domain.href}-entities`] = true;
+      newCollapsedState[`${domain.href}-subdomains`] = true;
+    });
+
+    // Collapse all services
+    filteredData.services?.forEach((service: any) => {
+      newCollapsedState[service.href] = true;
+      newCollapsedState[`${service.href}-specifications`] = true;
+      newCollapsedState[`${service.href}-receives`] = true;
+      newCollapsedState[`${service.href}-sends`] = true;
+      newCollapsedState[`${service.href}-entities`] = true;
+    });
+
+    setCollapsedGroups(newCollapsedState);
+    setIsExpanded(false);
+  }, [filteredData]);
+
+  const expandAll = useCallback(() => {
+    const newCollapsedState: { [key: string]: boolean } = {};
+
+    // Expand all domains
+    filteredData.domains?.forEach((domain: any) => {
+      newCollapsedState[domain.href] = false;
+      newCollapsedState[`${domain.href}-entities`] = false;
+      newCollapsedState[`${domain.href}-subdomains`] = false;
+    });
+
+    // Expand all services
+    filteredData.services?.forEach((service: any) => {
+      newCollapsedState[service.href] = false;
+      newCollapsedState[`${service.href}-specifications`] = false;
+      newCollapsedState[`${service.href}-receives`] = false;
+      newCollapsedState[`${service.href}-sends`] = false;
+      newCollapsedState[`${service.href}-entities`] = false;
+    });
+
+    setCollapsedGroups(newCollapsedState);
+    setIsExpanded(true);
+  }, [filteredData]);
+
+  const toggleExpandCollapse = useCallback(() => {
+    if (isExpanded) {
+      collapseAll();
+    } else {
+      expandAll();
+    }
+  }, [isExpanded, collapseAll, expandAll]);
+
+  const hideSidebar = useCallback(() => {
+    // Dispatch custom event that the Astro layout will listen for
+    window.dispatchEvent(new CustomEvent('sidebarToggle', { detail: { action: 'hide' } }));
+  }, []);
+
   const isDomainSubDomain = useMemo(() => {
     return (domain: any) => {
       const domains = data.domains || [];
@@ -320,6 +427,125 @@ const ListViewSideBar: React.FC<ListViewSideBarProps> = ({ resources, currentPat
     };
   }, [data.domains]);
 
+  // Helper function to get parent domains (domains that are not subdomains)
+  const getParentDomains = useMemo(() => {
+    return (domains: any[]) => {
+      return domains.filter((domain: any) => !isDomainSubDomain(domain));
+    };
+  }, [isDomainSubDomain]);
+
+  // Helper function to get subdomains for a specific parent domain
+  const getSubdomainsForParent = useMemo(() => {
+    return (parentDomain: any, allDomains: any[]) => {
+      const subdomains = parentDomain.domains || [];
+      return allDomains.filter((domain: any) => subdomains.some((subdomain: any) => subdomain.data.id === domain.id));
+    };
+  }, []);
+
+  // Component to render a single domain item
+  const DomainItem = React.memo(
+    ({ item, isSubdomain = false, nestingLevel = 0 }: { item: any; isSubdomain?: boolean; nestingLevel?: number }) => {
+      const marginLeft = nestingLevel > 0 ? `ml-${nestingLevel * 4}` : '';
+
+      return (
+        <div className={`flex items-center ${marginLeft}`}>
+          <button
+            onClick={(e) => {
+              e.stopPropagation();
+              toggleGroupCollapse(item.href);
+            }}
+            className="p-1 hover:bg-gray-100 rounded-md"
+          >
+            <div className={`transition-transform duration-150 ${collapsedGroups[item.href] ? '' : 'rotate-180'}`}>
+              <ChevronDownIcon className="h-3 w-3 text-gray-500" />
+            </div>
+          </button>
+          <button
+            onClick={(e) => {
+              e.stopPropagation();
+              toggleGroupCollapse(item.href);
+            }}
+            className={`flex-grow flex items-center justify-between px-2 py-0.5 text-xs font-bold rounded-md ${
+              decodedCurrentPath === item.href ? 'bg-purple-100' : 'hover:bg-purple-100'
+            }`}
+          >
+            <span className="truncate">
+              <HighlightedText text={item.label} searchTerm={debouncedSearchTerm} />
+            </span>
+            <span className="text-yellow-600 ml-2 text-[10px] font-medium bg-yellow-50 px-2 py-0.5 rounded">
+              {isSubdomain ? 'SUBDOMAIN' : 'DOMAIN'}
+            </span>
+          </button>
+        </div>
+      );
+    }
+  );
+
+  // Component to render domain content (Overview, Architecture, etc.)
+  const DomainContent = React.memo(({ item, nestingLevel = 0 }: { item: any; nestingLevel?: number }) => {
+    const marginLeft = nestingLevel > 0 ? `ml-${nestingLevel * 4}` : '';
+
+    return (
+      <div
+        className={`overflow-hidden transition-[height] duration-150 ease-out ${collapsedGroups[item.href] ? 'h-0' : 'h-auto'}`}
+      >
+        <div className={`space-y-0.5 border-gray-200/80 border-l pl-4 ml-[9px] mt-1 ${marginLeft}`}>
+          <a
+            href={`${item.href}`}
+            className={`flex items-center px-2 py-1.5 text-xs text-gray-600 hover:bg-purple-100 rounded-md ${
+              decodedCurrentPath === item.href ? 'bg-purple-100 ' : 'hover:bg-purple-100'
+            }`}
+          >
+            <span className="truncate">Overview</span>
+          </a>
+          {!isVisualizer && (
+            <a
+              href={buildUrlWithParams('/architecture/docs/services', {
+                serviceIds: item.services.map((service: any) => service.data.id).join(','),
+                domainId: item.id,
+                domainName: item.name,
+              })}
+              className={`flex items-center px-2 py-1.5 text-xs text-gray-600 hover:bg-purple-100 rounded-md ${
+                window.location.href.includes(`domainId=${item.id}`) ? 'bg-purple-100 ' : 'hover:bg-purple-100'
+              }`}
+            >
+              <span className="truncate">Architecture</span>
+            </a>
+          )}
+          {!isVisualizer && (
+            <a
+              href={buildUrl(`/docs/domains/${item.id}/language`)}
+              className={`flex items-center px-2 py-1.5 text-xs text-gray-600 hover:bg-purple-100 rounded-md ${
+                decodedCurrentPath.includes(`/docs/domains/${item.id}/language`) ? 'bg-purple-100 ' : 'hover:bg-purple-100'
+              }`}
+            >
+              <span className="truncate">Ubiquitous Language</span>
+            </a>
+          )}
+          {item.entities.length > 0 && !isVisualizer && (
+            <CollapsibleGroup
+              isCollapsed={collapsedGroups[`${item.href}-entities`]}
+              onToggle={() => toggleGroupCollapse(`${item.href}-entities`)}
+              title={
+                <button
+                  onClick={(e) => {
+                    e.stopPropagation();
+                    toggleGroupCollapse(`${item.href}-entities`);
+                  }}
+                  className="truncate underline ml-2 text-xs mb-1 py-1"
+                >
+                  Entities ({item.entities.length})
+                </button>
+              }
+            >
+              <MessageList messages={item.entities} decodedCurrentPath={decodedCurrentPath} searchTerm={debouncedSearchTerm} />
+            </CollapsibleGroup>
+          )}
+        </div>
+      </div>
+    );
+  });
+
   if (!isInitialized) return null;
 
   const hasNoResults =
@@ -332,13 +558,35 @@ const ListViewSideBar: React.FC<ListViewSideBarProps> = ({ resources, currentPat
 
   return (
     <nav ref={navRef} className="space-y-4 text-gray-800 px-3 py-4">
-      <input
-        type="text"
-        value={searchTerm}
-        onChange={handleSearchChange}
-        placeholder="Quick search..."
-        className="w-full p-2 text-sm rounded-md border border-gray-200 h-[30px]"
-      />
+      <div className="flex gap-2">
+        <input
+          type="text"
+          value={searchTerm}
+          onChange={handleSearchChange}
+          placeholder="Quick search..."
+          className="flex-1 p-2 text-sm rounded-md border border-gray-200 h-[30px]"
+        />
+        <div className="flex gap-1">
+          <button
+            onClick={toggleExpandCollapse}
+            title={isExpanded ? 'Collapse All' : 'Expand All'}
+            className="px-2 py-1 bg-gray-100 hover:bg-gray-200 rounded-md border border-gray-200 h-[30px] flex items-center justify-center"
+          >
+            {isExpanded ? (
+              <ChevronDoubleUpIcon className="h-4 w-4 text-gray-600" />
+            ) : (
+              <ChevronDoubleDownIcon className="h-4 w-4 text-gray-600" />
+            )}
+          </button>
+          <button
+            onClick={hideSidebar}
+            title="Hide Sidebar"
+            className="px-2 py-1 bg-gray-100 hover:bg-gray-200 rounded-md border border-gray-200 h-[30px] flex items-center justify-center"
+          >
+            <PanelLeft className="h-4 w-4 text-gray-600" />
+          </button>
+        </div>
+      </div>
       <div className="space-y-2 divide-y divide-gray-200/80">
         {hasNoResults ? (
           <NoResultsFound searchTerm={debouncedSearchTerm} />
@@ -372,104 +620,50 @@ const ListViewSideBar: React.FC<ListViewSideBarProps> = ({ resources, currentPat
             {filteredData['domains'] && (
               <div className={`${isVisualizer ? 'pt-4 pb-2' : 'p-0'}`}>
                 <ul className="space-y-2">
-                  {filteredData['domains'].map((item: any) => (
-                    <li key={item.href} className="space-y-0" data-active={decodedCurrentPath === item.href}>
-                      <div className="flex items-center">
-                        <button
-                          onClick={(e) => {
-                            e.stopPropagation();
-                            toggleGroupCollapse(item.href);
-                          }}
-                          className="p-1 hover:bg-gray-100 rounded-md"
-                        >
-                          <div className={`transition-transform duration-150 ${collapsedGroups[item.href] ? '' : 'rotate-180'}`}>
-                            <ChevronDownIcon className="h-3 w-3 text-gray-500" />
-                          </div>
-                        </button>
-                        <button
-                          onClick={(e) => {
-                            e.stopPropagation();
-                            toggleGroupCollapse(item.href);
-                          }}
-                          className={`flex-grow flex items-center justify-between px-2 py-0.5 text-xs font-bold rounded-md ${
-                            decodedCurrentPath === item.href
-                          }`}
-                        >
-                          <span className="truncate">
-                            <HighlightedText text={item.label} searchTerm={debouncedSearchTerm} />
-                          </span>
-                          <span className="text-yellow-600 ml-2 text-[10px] font-medium bg-yellow-50 px-2 py-0.5 rounded">
-                            {isDomainSubDomain(item) ? 'SUBDOMAIN' : 'DOMAIN'}
-                          </span>
-                        </button>
-                      </div>
-                      <div
-                        className={`overflow-hidden transition-[height] duration-150 ease-out ${
-                          collapsedGroups[item.href] ? 'h-0' : 'h-auto'
-                        }`}
-                      >
-                        <div className="space-y-0.5 border-gray-200/80 border-l pl-4 ml-[9px] mt-1">
-                          <a
-                            href={`${item.href}`}
-                            className={`flex items-center px-2 py-1.5 text-xs text-gray-600 hover:bg-purple-100 rounded-md ${
-                              decodedCurrentPath === item.href ? 'bg-purple-100 ' : 'hover:bg-purple-100'
-                            }`}
-                          >
-                            <span className="truncate">Overview</span>
-                          </a>
-                          {!isVisualizer && (
-                            <a
-                              href={buildUrlWithParams('/architecture/docs/services', {
-                                serviceIds: item.services.map((service: any) => service.data.id).join(','),
-                                domainId: item.id,
-                                domainName: item.name,
-                              })}
-                              className={`flex items-center px-2 py-1.5 text-xs text-gray-600 hover:bg-purple-100 rounded-md ${
-                                window.location.href.includes(`domainId=${item.id}`) ? 'bg-purple-100 ' : 'hover:bg-purple-100'
-                              }`}
-                            >
-                              <span className="truncate">Architecture</span>
-                            </a>
-                          )}
-                          {!isVisualizer && (
-                            <a
-                              href={buildUrl(`/docs/domains/${item.id}/language`)}
-                              className={`flex items-center px-2 py-1.5 text-xs text-gray-600 hover:bg-purple-100 rounded-md ${
-                                decodedCurrentPath.includes(`/docs/domains/${item.id}/language`)
-                                  ? 'bg-purple-100 '
-                                  : 'hover:bg-purple-100'
-                              }`}
-                            >
-                              <span className="truncate">Ubiquitous Language</span>
-                            </a>
-                          )}
-                          {item.entities.length > 0 && !isVisualizer && (
+                  {getParentDomains(filteredData['domains'] || []).map((parentDomain: any) => {
+                    const subdomains = getSubdomainsForParent(parentDomain, filteredData['domains'] || []);
+
+                    return (
+                      <li key={parentDomain.href} className="space-y-0" data-active={decodedCurrentPath === parentDomain.href}>
+                        <DomainItem item={parentDomain} isSubdomain={false} />
+                        <DomainContent item={parentDomain} />
+
+                        {/* Render nested subdomains */}
+                        {subdomains.length > 0 && !collapsedGroups[parentDomain.href] && (
+                          <div className="space-y-0.5 border-gray-200/80 border-l pl-4 ml-[9px] mt-2">
                             <CollapsibleGroup
-                              isCollapsed={collapsedGroups[`${item.href}-entities`]}
-                              onToggle={() => toggleGroupCollapse(`${item.href}-entities`)}
+                              isCollapsed={collapsedGroups[`${parentDomain.href}-subdomains`]}
+                              onToggle={() => toggleGroupCollapse(`${parentDomain.href}-subdomains`)}
                               title={
                                 <button
                                   onClick={(e) => {
                                     e.stopPropagation();
-                                    toggleGroupCollapse(`${item.href}-entities`);
+                                    toggleGroupCollapse(`${parentDomain.href}-subdomains`);
                                   }}
                                   className="truncate underline ml-2 text-xs mb-1 py-1"
                                 >
-                                  Entities ({item.entities.length})
+                                  Subdomains ({subdomains.length})
                                 </button>
                               }
                             >
-                              <MessageList
-                                messages={item.entities}
-                                decodedCurrentPath={decodedCurrentPath}
-                                searchTerm={debouncedSearchTerm}
-                              />
+                              <div className="space-y-2">
+                                {subdomains.map((subdomain: any) => (
+                                  <div
+                                    key={subdomain.href}
+                                    className="space-y-0"
+                                    data-active={decodedCurrentPath === subdomain.href}
+                                  >
+                                    <DomainItem item={subdomain} isSubdomain={true} nestingLevel={1} />
+                                    <DomainContent item={subdomain} nestingLevel={1} />
+                                  </div>
+                                ))}
+                              </div>
                             </CollapsibleGroup>
-                          )}
-                        </div>
-                      </div>
-                    </li>
-                  ))}
+                          </div>
+                        )}
+                      </li>
+                    );
+                  })}
                 </ul>
               </div>
             )}
@@ -492,7 +686,7 @@ const ListViewSideBar: React.FC<ListViewSideBarProps> = ({ resources, currentPat
               </div>
             )}
 
-            {filteredData['messagesNotInService'] && (
+            {filteredData['messagesNotInService'] && filteredData['messagesNotInService'].length > 0 && (
               <div className="pt-4 pb-2">
                 <ul className="space-y-4">
                   {filteredData['messagesNotInService'].map((item: any) => (

package/eventcatalog/src/enterprise/custom-documentation/components/CustomDocsNav/index.tsx

@@ -1,4 +1,5 @@
 import React, { useState, useRef, useEffect, useCallback, useMemo } from 'react';
+import { ChevronDoubleDownIcon, ChevronDoubleUpIcon } from '@heroicons/react/24/outline';
 import { buildUrl } from '@utils/url-builder';
 import type { CustomDocsNavProps, SidebarSection, SidebarItem } from './types';
 import NestedItem from './components/NestedItem';
@@ -12,6 +13,7 @@ const CustomDocsNav: React.FC<CustomDocsNavProps> = ({ sidebarItems }) => {
   const [searchTerm, setSearchTerm] = useState('');
   const [debouncedSearchTerm, setDebouncedSearchTerm] = useState('');
   const [isInitialized, setIsInitialized] = useState(false);
+  const [isExpanded, setIsExpanded] = useState(true);
   const [collapsedGroups, setCollapsedGroups] = useState<{ [key: string]: boolean }>(() => {
     if (typeof window !== 'undefined') {
       const saved = window.localStorage.getItem(STORAGE_KEY);
@@ -126,6 +128,70 @@ const CustomDocsNav: React.FC<CustomDocsNavProps> = ({ sidebarItems }) => {
     setSearchTerm(e.target.value);
   }, []);
 
+  const collapseAll = useCallback(() => {
+    const newCollapsedState: { [key: string]: boolean } = {};
+
+    // Collapse all sections
+    filteredSidebarItems.forEach((section, index) => {
+      const sectionKey = `section-${index}`;
+      newCollapsedState[sectionKey] = true;
+
+      // Collapse all nested items in the section
+      const collapseNestedItems = (items: SidebarItem[], parentId: string) => {
+        items.forEach((item, itemIndex) => {
+          if (item.items && item.items.length > 0) {
+            const itemKey = `${parentId}-${itemIndex}`;
+            newCollapsedState[itemKey] = true;
+            collapseNestedItems(item.items, itemKey);
+          }
+        });
+      };
+
+      if (section.items) {
+        collapseNestedItems(section.items, sectionKey);
+      }
+    });
+
+    setCollapsedGroups(newCollapsedState);
+    setIsExpanded(false);
+  }, [filteredSidebarItems]);
+
+  const expandAll = useCallback(() => {
+    const newCollapsedState: { [key: string]: boolean } = {};
+
+    // Expand all sections
+    filteredSidebarItems.forEach((section, index) => {
+      const sectionKey = `section-${index}`;
+      newCollapsedState[sectionKey] = false;
+
+      // Expand all nested items in the section
+      const expandNestedItems = (items: SidebarItem[], parentId: string) => {
+        items.forEach((item, itemIndex) => {
+          if (item.items && item.items.length > 0) {
+            const itemKey = `${parentId}-${itemIndex}`;
+            newCollapsedState[itemKey] = false;
+            expandNestedItems(item.items, itemKey);
+          }
+        });
+      };
+
+      if (section.items) {
+        expandNestedItems(section.items, sectionKey);
+      }
+    });
+
+    setCollapsedGroups(newCollapsedState);
+    setIsExpanded(true);
+  }, [filteredSidebarItems]);
+
+  const toggleExpandCollapse = useCallback(() => {
+    if (isExpanded) {
+      collapseAll();
+    } else {
+      expandAll();
+    }
+  }, [isExpanded, collapseAll, expandAll]);
+
   if (!isInitialized) return null;
 
   const hasNoResults = debouncedSearchTerm && filteredSidebarItems.length === 0;
@@ -133,13 +199,26 @@ const CustomDocsNav: React.FC<CustomDocsNavProps> = ({ sidebarItems }) => {
   return (
     <nav ref={navRef} className="h-full text-gray-800 pt-4 overflow-y-auto">
       <div className="mb-2 px-3 bg-white z-10">
-        <input
-          type="text"
-          value={searchTerm}
-          onChange={handleSearchChange}
-          placeholder="Quick search..."
-          className="w-full p-2 px-2 text-sm rounded-md border border-gray-200 h-[30px]"
-        />
+        <div className="flex gap-2">
+          <input
+            type="text"
+            value={searchTerm}
+            onChange={handleSearchChange}
+            placeholder="Quick search..."
+            className="flex-1 p-2 px-2 text-sm rounded-md border border-gray-200 h-[30px]"
+          />
+          <button
+            onClick={toggleExpandCollapse}
+            title={isExpanded ? 'Collapse All' : 'Expand All'}
+            className="px-2 py-1 bg-gray-100 hover:bg-gray-200 rounded-md border border-gray-200 h-[30px] flex items-center justify-center"
+          >
+            {isExpanded ? (
+              <ChevronDoubleUpIcon className="h-4 w-4 text-gray-600" />
+            ) : (
+              <ChevronDoubleDownIcon className="h-4 w-4 text-gray-600" />
+            )}
+          </button>
+        </div>
       </div>
 
       <div className="space-y-2 divide-y divide-gray-100/40 pb-4">

package/eventcatalog/src/layouts/VerticalSideBarLayout.astro

@@ -454,5 +454,15 @@ const canPageBeEmbedded = process.env.ENABLE_EMBED === 'true';
         }
       });
     }
+
+    // Listen for custom sidebar toggle event from React components
+    window.addEventListener('sidebarToggle', (event) => {
+      const { action } = event.detail;
+      if (action === 'hide') {
+        hideSidebar();
+      } else if (action === 'show') {
+        showSidebar();
+      }
+    });
   });
 </script>

package/eventcatalog/tsconfig.json

@@ -9,6 +9,7 @@
       "@icons/*": ["src/icons/*"],
       "@components/*": ["src/components/*"],
       "@catalog/components/*": ["src/custom-defined-components/*"],
+      "@catalog/snippets/*": ["src/snippets/*"],
       "@types": ["src/types/index.ts"],
       "@utils/*": ["src/utils/*"],
       "@layouts/*": ["src/layouts/*"],

package/package.json

@@ -6,7 +6,7 @@
     "url": "https://github.com/event-catalog/eventcatalog.git"
   },
   "type": "module",
-  "version": "2.47.1",
+  "version": "2.48.0",
   "publishConfig": {
     "access": "public"
   },