@eventcatalog/core 5.4.2 → 5.5.1

package/dist/analytics/analytics.cjs

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(analytics_exports);
 var import_os = __toESM(require("os"), 1);
 
 // package.json
-var version = "5.4.2";
+var version = "5.5.1";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/analytics.js

@@ -1,8 +1,8 @@
 import {
   raiseEvent
-} from "../chunk-EXRIIYEP.js";
+} from "../chunk-GZLVDQPM.js";
 import "../chunk-CPW6G62V.js";
-import "../chunk-HV4ONKTM.js";
+import "../chunk-GPIKYBQ5.js";
 export {
   raiseEvent
 };

package/dist/analytics/log-build.cjs

@@ -169,7 +169,7 @@ var verifyRequiredFieldsAreInCatalogConfigFile = async (projectDirectory) => {
 var import_os = __toESM(require("os"), 1);
 
 // package.json
-var version = "5.4.2";
+var version = "5.5.1";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/log-build.js

@@ -1,12 +1,12 @@
 import {
   log_build_default
-} from "../chunk-VSBMYXLL.js";
+} from "../chunk-6KR5ZLEQ.js";
 import "../chunk-AD7CL772.js";
-import "../chunk-EXRIIYEP.js";
+import "../chunk-GZLVDQPM.js";
 import "../chunk-YRZK7HKX.js";
 import "../chunk-CA6WCQ2T.js";
 import "../chunk-CPW6G62V.js";
-import "../chunk-HV4ONKTM.js";
+import "../chunk-GPIKYBQ5.js";
 import "../chunk-4G7FSRPN.js";
 export {
   log_build_default as default

package/dist/catalog-runtime.cjs

@@ -36,7 +36,7 @@ __export(catalog_runtime_exports, {
 });
 module.exports = __toCommonJS(catalog_runtime_exports);
 
-// ../../node_modules/.pnpm/tsup@8.5.0_jiti@2.7.0_postcss@8.5.29_tsx@4.23.15_typescript@5.9.3_yaml@2.9.1/node_modules/tsup/assets/cjs_shims.js
+// ../../node_modules/.pnpm/tsup@8.5.0_jiti@2.7.0_postcss@8.5.31_tsx@4.23.15_typescript@5.9.3_yaml@2.9.1/node_modules/tsup/assets/cjs_shims.js
 var getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.src || new URL("main.js", document.baseURI).href;
 var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
 

package/dist/{chunk-VSBMYXLL.js → chunk-6KR5ZLEQ.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-AD7CL772.js";
 import {
   raiseEvent
-} from "./chunk-EXRIIYEP.js";
+} from "./chunk-GZLVDQPM.js";
 import {
   countResources,
   hashCatalogContent,

package/dist/{chunk-XB6FJMI3.js → chunk-EBZQJP7F.js}

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

package/dist/{chunk-HV4ONKTM.js → chunk-GPIKYBQ5.js}

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

package/dist/{chunk-EXRIIYEP.js → chunk-GZLVDQPM.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-CPW6G62V.js";
 import {
   VERSION
-} from "./chunk-HV4ONKTM.js";
+} from "./chunk-GPIKYBQ5.js";
 
 // src/analytics/analytics.js
 import os from "os";

package/dist/{chunk-CQ4L4SMB.js → chunk-K5QKWVI3.js}

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

package/dist/constants.cjs

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

package/dist/constants.js

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

package/dist/eventcatalog.cjs

@@ -22,7 +22,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
-// ../../node_modules/.pnpm/tsup@8.5.0_jiti@2.7.0_postcss@8.5.29_tsx@4.23.15_typescript@5.9.3_yaml@2.9.1/node_modules/tsup/assets/cjs_shims.js
+// ../../node_modules/.pnpm/tsup@8.5.0_jiti@2.7.0_postcss@8.5.31_tsx@4.23.15_typescript@5.9.3_yaml@2.9.1/node_modules/tsup/assets/cjs_shims.js
 var getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.src || new URL("main.js", document.baseURI).href;
 var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
 
@@ -174,7 +174,7 @@ var verifyRequiredFieldsAreInCatalogConfigFile = async (projectDirectory) => {
 var import_picocolors = __toESM(require("picocolors"), 1);
 
 // package.json
-var version = "5.4.2";
+var version = "5.5.1";
 
 // src/constants.ts
 var VERSION = version;

package/dist/eventcatalog.js

@@ -1,18 +1,18 @@
+import {
+  stopChildWithParent
+} from "./chunk-S5GWAUG5.js";
 import {
   runMigrations
 } from "./chunk-XUAF2H54.js";
 import "./chunk-CA4U2JP7.js";
-import {
-  stopChildWithParent
-} from "./chunk-S5GWAUG5.js";
 import {
   log_build_default
-} from "./chunk-VSBMYXLL.js";
+} from "./chunk-6KR5ZLEQ.js";
 import {
   getLicenseStatus,
   printLicenseStatus
 } from "./chunk-AD7CL772.js";
-import "./chunk-EXRIIYEP.js";
+import "./chunk-GZLVDQPM.js";
 import "./chunk-YRZK7HKX.js";
 import "./chunk-CA6WCQ2T.js";
 import "./chunk-CPW6G62V.js";
@@ -20,17 +20,17 @@ import {
   FederationConflictError,
   FederationDiagnosticError,
   federateCatalog
-} from "./chunk-QJ7KKN2D.js";
-import "./chunk-WRNH5C3U.js";
-import "./chunk-5EPNFDT5.js";
-import "./chunk-A2RZR3U4.js";
-import "./chunk-SDZQJTJW.js";
-import "./chunk-352FGP6W.js";
+} from "./chunk-NCEZDQSW.js";
 import "./chunk-R7Z5ALYI.js";
 import {
   getFederationDiagnosticCounts,
   getVisibleFederationDiagnostics
 } from "./chunk-JJPB6EOZ.js";
+import "./chunk-WRNH5C3U.js";
+import "./chunk-5EPNFDT5.js";
+import "./chunk-A2RZR3U4.js";
+import "./chunk-SDZQJTJW.js";
+import "./chunk-352FGP6W.js";
 import {
   getProjectOutDir,
   isAuthEnabled,
@@ -39,10 +39,10 @@ import {
 } from "./chunk-NKNOXQ62.js";
 import {
   generate
-} from "./chunk-CQ4L4SMB.js";
+} from "./chunk-K5QKWVI3.js";
 import {
   logger
-} from "./chunk-XB6FJMI3.js";
+} from "./chunk-EBZQJP7F.js";
 import {
   resolve_catalog_dependencies_default
 } from "./chunk-PD7KTSYN.js";
@@ -79,7 +79,7 @@ import {
 } from "./chunk-LFQJXLHG.js";
 import {
   VERSION
-} from "./chunk-HV4ONKTM.js";
+} from "./chunk-GPIKYBQ5.js";
 import {
   getEventCatalogConfigFile,
   verifyRequiredFieldsAreInCatalogConfigFile

package/dist/federation/federate.js

@@ -2,14 +2,14 @@ import {
   FederationConflictError,
   FederationDiagnosticError,
   federateCatalog
-} from "../chunk-QJ7KKN2D.js";
+} from "../chunk-NCEZDQSW.js";
+import "../chunk-R7Z5ALYI.js";
+import "../chunk-JJPB6EOZ.js";
 import "../chunk-WRNH5C3U.js";
 import "../chunk-5EPNFDT5.js";
 import "../chunk-A2RZR3U4.js";
 import "../chunk-SDZQJTJW.js";
 import "../chunk-352FGP6W.js";
-import "../chunk-R7Z5ALYI.js";
-import "../chunk-JJPB6EOZ.js";
 import "../chunk-4G7FSRPN.js";
 export {
   FederationConflictError,

package/dist/generate.cjs

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

package/dist/generate.js

@@ -1,8 +1,8 @@
 import {
   generate
-} from "./chunk-CQ4L4SMB.js";
-import "./chunk-XB6FJMI3.js";
-import "./chunk-HV4ONKTM.js";
+} from "./chunk-K5QKWVI3.js";
+import "./chunk-EBZQJP7F.js";
+import "./chunk-GPIKYBQ5.js";
 import "./chunk-4G7FSRPN.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 = "5.4.2";
+var version = "5.5.1";
 
 // src/constants.ts
 var VERSION = version;

package/dist/utils/cli-logger.js

@@ -1,7 +1,7 @@
 import {
   logger
-} from "../chunk-XB6FJMI3.js";
-import "../chunk-HV4ONKTM.js";
+} from "../chunk-EBZQJP7F.js";
+import "../chunk-GPIKYBQ5.js";
 export {
   logger
 };

package/eventcatalog/src/components/MDX/NodeGraph/AstroNodeGraph.tsx

@@ -78,6 +78,8 @@ interface AstroNodeGraphProps {
   hiddenMessagesGraph?: { nodes: Node[]; edges: Edge[] };
   // The kind of diagram, so the level is remembered for each kind
   preferenceScope?: string;
+  // On the visualiser's own pages: keep the Mermaid view in the URL (`?render=mermaid`)
+  syncRenderModeWithUrl?: boolean;
   // Group a flow's steps into swimlanes to start with
   swimlanes?: FlowGroupBy;
   // The Studio API's address, when Studio is on: the menu can then start a canvas from the diagram

package/eventcatalog/src/components/MDX/NodeGraph/NodeGraph.astro

@@ -66,6 +66,9 @@ interface Props {
   overview?: { label: string };
   // Flows only: group the steps into swimlanes to start with
   lanes?: FlowGroupBy;
+  // The visualiser's own pages: keep the Mermaid view in the URL (`?render=mermaid`), so links open in it.
+  // Not docs pages, which can show several diagrams.
+  syncRenderModeWithUrl?: boolean;
 }
 
 const {
@@ -84,6 +87,7 @@ const {
   disableMessageAnimation,
   overview,
   lanes,
+  syncRenderModeWithUrl = false,
 } = Astro.props;
 
 let nodes = [],
@@ -263,6 +267,7 @@ if (overview && levelsOverview) {
     preferenceScope={collection}
     swimlanes={lanes}
     studioApiUrl={studioApiUrl}
+    syncRenderModeWithUrl={syncRenderModeWithUrl}
   />
 </div>
 

package/eventcatalog/src/components/SchemaExplorer/AvroSchemaViewer.tsx

@@ -1,4 +1,5 @@
 import { useState, useEffect, useRef } from 'react';
+import { ChevronRightIcon } from '@heroicons/react/20/solid';
 
 interface AvroSchemaViewerProps {
   schema: any;
@@ -124,14 +125,15 @@ const AvroField = ({ field, level, expand, showRequired }: AvroFieldProps) => {
     <div className={`avro-field-container mb-2 border-l border-[rgb(var(--ec-page-border))] ${indentClass}`}>
       <div className="flex space-x-2">
         {/* Collapse/Expand button */}
-        <div className="flex-shrink-0 w-4 pt-0.5">
+        <div className="flex-shrink-0 w-4">
           {hasNested ? (
             <button
               onClick={() => setIsExpanded(!isExpanded)}
-              className="avro-field-toggle text-[rgb(var(--ec-page-text-muted))] hover:text-[rgb(var(--ec-page-text))] w-4 text-center"
+              className="avro-field-toggle flex h-5 w-4 items-center justify-center text-[rgb(var(--ec-page-text-muted))] hover:text-[rgb(var(--ec-page-text))]"
               aria-expanded={isExpanded}
+              aria-label={`Toggle ${field.name}`}
             >
-              <span className="font-mono text-xs">{isExpanded ? '▼' : '▶'}</span>
+              <ChevronRightIcon className={`h-3.5 w-3.5 transition-transform ${isExpanded ? 'rotate-90' : ''}`} />
             </button>
           ) : null}
         </div>

package/eventcatalog/src/components/SchemaExplorer/JSONSchemaViewer.tsx

@@ -1,4 +1,5 @@
 import { useState, useEffect, useRef, useMemo, useId } from 'react';
+import { ChevronRightIcon } from '@heroicons/react/20/solid';
 
 interface JSONSchemaViewerProps {
   schema: any;
@@ -323,20 +324,20 @@ const SchemaProperty = ({ name, details, isRequired, level, isListItem = false,
             type="button"
             aria-expanded={isExpanded}
             aria-controls={contentId}
+            aria-label={`Toggle ${name}`}
             onClick={() => setIsExpanded(!isExpanded)}
-            className="property-toggle text-[rgb(var(--ec-page-text-muted))] hover:text-[rgb(var(--ec-page-text))] pt-0.5 focus:outline-hidden w-3 text-center flex-shrink-0"
+            className="property-toggle flex h-5 w-4 flex-shrink-0 items-center justify-center text-[rgb(var(--ec-page-text-muted))] hover:text-[rgb(var(--ec-page-text))] focus:outline-hidden"
           >
-            <span className={`icon-collapsed font-mono text-xs ${isExpanded ? 'hidden' : ''}`}>&gt;</span>
-            <span className={`icon-expanded font-mono text-xs ${!isExpanded ? 'hidden' : ''}`}>v</span>
+            <ChevronRightIcon className={`h-3.5 w-3.5 transition-transform ${isExpanded ? 'rotate-90' : ''}`} />
           </button>
         ) : (
-          <div className="w-3 h-4 flex-shrink-0" />
+          <div className="w-4 h-5 flex-shrink-0" />
         )}
 
         <div className="flex-grow">
           <div className="-mx-1 rounded px-1 transition-colors hover:bg-[rgb(var(--ec-content-hover))]">
             <div className="flex justify-between items-baseline">
-              <div>
+              <div className="text-sm">
                 <span className="font-semibold text-[rgb(var(--ec-page-text))] text-sm">{name}</span>
                 <span className="ml-1.5 text-[rgb(var(--ec-accent))] font-mono text-xs">
                   {hasVariants ? (details.variantType === 'anyOf' ? 'anyOf' : 'oneOf') : formatType(details.type)}

package/eventcatalog/src/components/SchemaExplorer/ProtobufSchemaViewer.tsx

@@ -1,4 +1,5 @@
 import { useState, useEffect, useRef, useMemo } from 'react';
+import { ChevronRightIcon } from '@heroicons/react/20/solid';
 import type { ProtobufSchema, ProtobufMessage, ProtobufEnum, ProtobufField } from '@utils/protobuf-schema';
 import {
   formatProtobufOptionValue,
@@ -144,20 +145,20 @@ const ProtobufFieldRow = ({ field, level, expand, showRequired, registry, packag
           <button
             type="button"
             aria-expanded={isExpanded}
+            aria-label={`Toggle ${field.name}`}
             onClick={() => setIsExpanded(!isExpanded)}
-            className="proto-field-toggle text-[rgb(var(--ec-page-text-muted))] hover:text-[rgb(var(--ec-page-text))] pt-0.5 focus:outline-hidden w-3 text-center flex-shrink-0"
+            className="proto-field-toggle flex h-5 w-4 flex-shrink-0 items-center justify-center text-[rgb(var(--ec-page-text-muted))] hover:text-[rgb(var(--ec-page-text))] focus:outline-hidden"
           >
-            <span className={`icon-collapsed font-mono text-xs ${isExpanded ? 'hidden' : ''}`}>&gt;</span>
-            <span className={`icon-expanded font-mono text-xs ${!isExpanded ? 'hidden' : ''}`}>v</span>
+            <ChevronRightIcon className={`h-3.5 w-3.5 transition-transform ${isExpanded ? 'rotate-90' : ''}`} />
           </button>
         ) : (
-          <div className="w-3 h-4 flex-shrink-0" />
+          <div className="w-4 h-5 flex-shrink-0" />
         )}
 
         <div className="flex-grow">
           <div className="-mx-1 rounded px-1 transition-colors hover:bg-[rgb(var(--ec-content-hover))]">
             <div className="flex justify-between items-baseline">
-              <div>
+              <div className="text-sm">
                 <span className="proto-field-name font-semibold text-[rgb(var(--ec-page-text))] text-sm">{field.name}</span>
                 <span
                   className="ml-1.5 text-[rgb(var(--ec-accent))] font-mono text-xs"

package/eventcatalog/src/features/ai/chat-api.ts

@@ -29,6 +29,7 @@ import {
   resourceCollectionSchema,
   messageCollectionSchema,
   visualiserCollectionSchema,
+  architectureDiagramDetailSchema,
   toolDescriptions,
 } from '@features/tools/catalog-tools';
 
@@ -136,7 +137,8 @@ The referer URL is: ${referrer}
 
 IMPORTANT: When the user is on a visualiser page (/visualiser/*) or asks about architecture, dependencies, data flow, or connections:
 - Use the getArchitectureDiagramAsMermaid tool to fetch the architecture diagram
-- The mermaid code shows all the connections between resources (services, events, channels, etc.)
+- The mermaid code shows all the connections between resources (services, events, channels, etc.), with domains and systems as subgraphs around what's in them
+- For a high-level answer about a domain or system, pass detail "overview" (domains, systems and their relationships) or "services" (services and data stores) instead of the full diagram
 - Use this to provide accurate, contextual answers about the architecture
 
 Sometimes the user will be on the specification page (openapi, asyncapi, graphql) for a resource too 
@@ -336,9 +338,10 @@ export const POST = async ({ request }: APIContext<{ question: string; messages:
               'The collection of the resource (events, commands, queries, services, domains, systems, flows, containers, data-products)'
             )
             .default('services'),
+          detail: architectureDiagramDetailSchema.optional(),
         }),
-        execute: async ({ resourceId, resourceVersion, resourceCollection }) => {
-          return await getArchitectureDiagramImpl({ resourceId, resourceVersion, resourceCollection });
+        execute: async ({ resourceId, resourceVersion, resourceCollection, detail }) => {
+          return await getArchitectureDiagramImpl({ resourceId, resourceVersion, resourceCollection, detail });
         },
       }),
       getCustomDocs: tool({

package/eventcatalog/src/features/mcp/apps/architecture-diagram/shared.ts

@@ -2,7 +2,7 @@
  * Shared by the MCP server and the architecture diagram MCP App view (view.tsx, shown by the viewer in ../viewer).
  * Kept free of server-only imports so it can be bundled into the view.
  */
-import type { ArchitectureDiagramView } from '@utils/node-graphs/architecture-diagram-types';
+import type { ArchitectureDiagramDetail, ArchitectureDiagramView } from '@utils/node-graphs/architecture-diagram-types';
 
 export type ArchitectureDiagramPayload = {
   resource: { collection: string; id: string; version: string; name: string };
@@ -11,4 +11,6 @@ export type ArchitectureDiagramPayload = {
   /** Path of the resource's Diagram page in EventCatalog */
   visualiserPath: string;
   view: ArchitectureDiagramView;
+  /** The level the diagram was asked for, to open at it (otherwise the diagram's own default) */
+  detail?: ArchitectureDiagramDetail;
 };

package/eventcatalog/src/features/mcp/apps/architecture-diagram/view.tsx

@@ -11,6 +11,9 @@ import visualiserStyles from '@eventcatalog/visualiser/styles.css?inline';
 import type { App, McpUiHostContext } from '@modelcontextprotocol/ext-apps';
 import type { Node } from '@xyflow/react';
 import type { ArchitectureDiagramPayload } from './shared';
+
+/** The diagram's level for each level of detail an MCP client can ask for */
+const LEVEL_OF_DETAIL = { overview: 1, services: 2, full: 3 } as const;
 import { NodeChat, describeNode, describeNodeForModel, type SelectedNode } from './node-chat';
 import { parseAskLink, parseDiagramLink, withAskMenuItem, type DiagramLink } from './links';
 import { getToolResultPayload } from '../shared/app-view';
@@ -421,7 +424,8 @@ export function ArchitectureDiagramView({ app, payload: toolPayload, hostContext
           />
         )}
       </div>
-      <div style={{ display: 'none' }} key={`${graphId}-graph`}>
+      {/* Again for another level of the same diagram, so it opens at it */}
+      <div style={{ display: 'none' }} key={`${graphId}-${payload.detail ?? 'default'}-graph`}>
         <NodeGraph
           id={graphId}
           nodes={graph.nodes}
@@ -436,6 +440,7 @@ export function ArchitectureDiagramView({ app, payload: toolPayload, hostContext
           }
           hiddenMessagesGraph={graph.hiddenMessages}
           preferenceScope={resource.collection}
+          initialLevel={payload.detail ? LEVEL_OF_DETAIL[payload.detail] : undefined}
           mode="full"
           linkTo="docs"
           showSearch