@eventcatalog/core 5.5.2 → 5.6.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.5.2";
+var version = "5.6.1";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/analytics.js

@@ -1,8 +1,8 @@
 import {
   raiseEvent
-} from "../chunk-5HSYALWK.js";
+} from "../chunk-2NALBBWH.js";
 import "../chunk-CPW6G62V.js";
-import "../chunk-WG6ZK6L3.js";
+import "../chunk-L63ED43X.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.5.2";
+var version = "5.6.1";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/log-build.js

@@ -1,12 +1,12 @@
 import {
   log_build_default
-} from "../chunk-CNN747RO.js";
+} from "../chunk-LVOGLB6C.js";
 import "../chunk-AD7CL772.js";
-import "../chunk-5HSYALWK.js";
+import "../chunk-2NALBBWH.js";
 import "../chunk-YRZK7HKX.js";
 import "../chunk-CA6WCQ2T.js";
 import "../chunk-CPW6G62V.js";
-import "../chunk-WG6ZK6L3.js";
+import "../chunk-L63ED43X.js";
 import "../chunk-4G7FSRPN.js";
 export {
   log_build_default as default

package/dist/{chunk-5HSYALWK.js → chunk-2NALBBWH.js}

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

package/dist/{chunk-WG6ZK6L3.js → chunk-L63ED43X.js}

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

package/dist/{chunk-CNN747RO.js → chunk-LVOGLB6C.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-AD7CL772.js";
 import {
   raiseEvent
-} from "./chunk-5HSYALWK.js";
+} from "./chunk-2NALBBWH.js";
 import {
   countResources,
   hashCatalogContent,

package/dist/{chunk-7ZEKF2LA.js → chunk-N7LDFUEB.js}

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

package/dist/{chunk-MC4F3VVM.js → chunk-QJXVAM76.js}

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

package/dist/constants.cjs

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

package/dist/constants.js

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

package/dist/docs/development/customization/05-resource-sidebar.md

@@ -89,7 +89,7 @@ Inside a custom group, each entry in `pages` is one of:
 | Section token | `"$inbound-messages"` | The **items** of a predefined section, spliced into your group — this is how you extend a generated section with your own pages |
 | Resource reference | `"[[service\|payment-api]]"` | The resource, with its own expandable nested sidebar, at its latest version. Messages can pin a version: `"[[event\|payment-captured@1.0.0]]"` — other types always reference the latest |
 | Documentation reference | `"[[doc\|guides/onboarding]]"` | One of this resource's [documentation pages](/docs/development/bring-your-own-documentation/resource-docs/adding-resource-docs), addressed as `<type>/<id>` |
-| Specification reference | `"[[spec\|openapi.yml]]"` | A specification page, with the OpenAPI/AsyncAPI/GraphQL logo and the spec's name |
+| Specification reference | `"[[spec\|openapi.yml]]"` | A specification page, with the OpenAPI/AsyncAPI/GraphQL logo (or a generic specification's icon) and the spec's name |
 | Schema reference | `"[[schema\|payment-captured]]"` | A message's schema page |
 | Link | `{ "title": "Runbook", "href": "https://..." }` | A plain link. External links (any protocol) open in a new tab and show an external-link icon |
 | Nested group | `{ "title": "Internal", "collapsed": true, "pages": [...] }` | A subsection. Groups nest to any depth |

package/dist/docs/development/guides/domains/09-reference.md

@@ -425,14 +425,18 @@ specifications:
   - type: graphql
     path: graphql.yml
     name: GraphQL Specification
+  - type: generic
+    path: carrier-sla.yaml
+    name: Carrier Service Levels
 ---
 ```
 
 | Property | Type | Required | Description |
 | -------- | ---- | -------- | ----------- |
-| `type` | `string` | Yes | The type of specification. |
+| `type` | `string` | Yes | The type of specification: `openapi`, `asyncapi`, `graphql` or `generic` ([any other file](/docs/development/guides/resources/schemas/add-specifications-to-services/add-generic-specifications), such as a WSDL, an XML Schema, or a JSON or YAML contract). |
 | `path` | `string` | Yes | The path to the specification file. |
 | `name` | `string` | No | Optional friendly name of the specification, rendered in the UI. |
+| `icon` | `string` | No | Icon for a `generic` specification: a path in your `public` folder or a URL. |
 
 **Older versions of EventCatalog (< 2.39.0)**
 

package/dist/docs/development/guides/resources/schemas/03-add-specifications-to-services/04-add-generic-specifications.md

@@ -0,0 +1,139 @@
+---
+keywords:
+- EventCatalog schemas
+- WSDL
+- XML Schema
+- XSD
+- generic specifications
+sidebar_position: 4
+sidebar_label: Other formats (XML, JSON, YAML)
+title: Add other specifications (XML, JSON, YAML)
+description: Attach any specification file, such as a WSDL, an XML Schema, or a JSON or YAML contract, to a service or domain
+---
+
+import AddedIn from '@site/src/components/MDX/AddedIn';
+import ProjectTree from '@site/src/components/MDX/ProjectTree';
+
+<AddedIn version="5.6.0" />
+
+Not every API is described with OpenAPI, AsyncAPI or GraphQL. A SOAP service has a WSDL, a partner integration may share an XML Schema, and a team may keep its contract in its own JSON or YAML format.
+
+Use `type: generic` to attach any of these files to a service or domain. EventCatalog adds a page for the file and lists it with your other specifications.
+
+Generic specifications are shown as source code. EventCatalog doesn't parse them, so any file works. These files get syntax highlighting:
+
+| Format | File extensions |
+| ------ | --------------- |
+| XML | `.xml`, `.xsd`, `.wsdl`, `.xsl`, `.xslt` |
+| JSON | `.json` |
+| YAML | `.yaml`, `.yml` |
+
+Other files are shown as plain text.
+
+## Add a generic specification
+
+Put the file inside the service (or domain) folder.
+
+<ProjectTree
+  items={[
+    {
+      name: 'services',
+      type: 'folder',
+      defaultOpen: true,
+      children: [
+        {
+          name: 'CarrierAdapter',
+          type: 'folder',
+          defaultOpen: true,
+          children: [
+            { name: 'index.mdx' },
+            {
+              name: 'specs',
+              type: 'folder',
+              defaultOpen: true,
+              children: [
+                { name: 'carrier-shipping.wsdl', highlight: true },
+                { name: 'shipment.xsd', highlight: true },
+              ],
+            },
+          ],
+        },
+      ],
+    },
+  ]}
+/>
+
+Then reference the file in the frontmatter.
+
+```md title="example: /services/CarrierAdapter/index.mdx"
+---
+specifications:
+  - type: generic
+    # Path to the file, relative to the service folder
+    path: specs/carrier-shipping.wsdl
+    # Friendly name for the specification (defaults to "Specification")
+    name: Carrier Shipping API (WSDL)
+  - type: generic
+    path: specs/shipment.xsd
+    name: Shipment XML Schema
+---
+```
+
+Each generic specification gets a page at `/docs/services/{id}/{version}/generic/{filename}`, where `{filename}` is the file name without its extension. It is also listed:
+
+- under **API & Contracts** in the sidebar
+- in the badges on the service or domain page
+- in the [Schema Explorer](/docs/development/guides/resources/schemas/explore-schemas/schema-explorer), where you can filter by the **Specs** type and by format (XML, JSON, YAML)
+- in the node's menu in the visualiser
+
+:::info
+The page URL uses the file name without its extension, so give each specification on a resource its own file name (for example, don't use both `contract.json` and `contract.yaml`).
+:::
+
+## Use a custom icon
+
+Generic specifications use a default specification icon. Use `icon` to set your own. It can be a path to a file in your catalog's `public` folder, or a URL.
+
+```md title="example: /services/CarrierAdapter/index.mdx"
+---
+specifications:
+  - type: generic
+    path: specs/carrier-shipping.wsdl
+    name: Carrier Shipping API (WSDL)
+    # /public/icons/soap.svg in your catalog
+    icon: /icons/soap.svg
+---
+```
+
+The icon shows on the specification page, in the sidebar, on the resource page and in the Schema Explorer. `icon` only applies to generic specifications.
+
+## Reference a file from a remote URL
+
+You can also use a URL as the `path`. EventCatalog fetches the file when it builds your catalog, so the URL must be reachable from the build machine. Rebuild your catalog to show changes to the file.
+
+```md title="example: /services/CarrierAdapter/index.mdx"
+---
+specifications:
+  - type: generic
+    path: https://raw.githubusercontent.com/acme/carrier-contracts/main/carrier-shipping.wsdl
+    name: Carrier Shipping API (WSDL)
+    # Optional: headers for private files. Only variables that start with EVENTCATALOG_ or EC_ are used.
+    headers:
+      Authorization: 'Bearer ${EC_GITHUB_TOKEN}'
+---
+```
+
+Remote files are shown on their specification page. The Schema Explorer only lists files in your catalog.
+
+## Add generic specifications to a domain
+
+Domains support generic specifications in the same way. Put the file in the domain folder and add it to the domain's `specifications`.
+
+```md title="example: /domains/Fulfilment/index.mdx"
+---
+specifications:
+  - type: generic
+    path: carrier-sla.yaml
+    name: Carrier Service Levels
+---
+```

package/dist/docs/development/guides/resources/schemas/03-add-specifications-to-services/_category_.json

@@ -6,6 +6,6 @@
   "link": {
     "type": "generated-index",
     "slug": "/schemas/add-specifications-to-services",
-    "description": "Attach OpenAPI, AsyncAPI, and GraphQL specifications to services."
+    "description": "Attach OpenAPI, AsyncAPI, GraphQL and other specifications (XML, JSON, YAML) to services."
   }
 }

package/dist/docs/development/guides/resources/services/08-reference.md

@@ -213,7 +213,7 @@ externalSystem: true
 
 - Type: `object` or `array`
 
-OpenAPI, AsyncAPI, or GraphQL specifications for the service.
+OpenAPI, AsyncAPI, or GraphQL specifications for the service. Use `type: generic` for any other specification file, such as a WSDL, an XML Schema, or a JSON or YAML contract ([read more](/docs/development/guides/resources/schemas/add-specifications-to-services/add-generic-specifications)).
 
 ```md title="Example"
 ---
@@ -223,6 +223,11 @@ specifications:
     name: Public API
   - type: asyncapi
     path: asyncapi.yml
+  - type: generic
+    path: carrier-shipping.wsdl
+    name: Carrier Shipping API (WSDL)
+    # Optional, generic specifications only
+    icon: /icons/soap.svg
 ---
 ```
 

package/dist/eventcatalog.cjs

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

package/dist/eventcatalog.js

@@ -7,12 +7,12 @@ import {
 import "./chunk-CA4U2JP7.js";
 import {
   log_build_default
-} from "./chunk-CNN747RO.js";
+} from "./chunk-LVOGLB6C.js";
 import {
   getLicenseStatus,
   printLicenseStatus
 } from "./chunk-AD7CL772.js";
-import "./chunk-5HSYALWK.js";
+import "./chunk-2NALBBWH.js";
 import "./chunk-YRZK7HKX.js";
 import "./chunk-CA6WCQ2T.js";
 import "./chunk-CPW6G62V.js";
@@ -39,10 +39,10 @@ import {
 } from "./chunk-NKNOXQ62.js";
 import {
   generate
-} from "./chunk-7ZEKF2LA.js";
+} from "./chunk-N7LDFUEB.js";
 import {
   logger
-} from "./chunk-MC4F3VVM.js";
+} from "./chunk-QJXVAM76.js";
 import {
   resolve_catalog_dependencies_default
 } from "./chunk-PD7KTSYN.js";
@@ -79,7 +79,7 @@ import {
 } from "./chunk-LFQJXLHG.js";
 import {
   VERSION
-} from "./chunk-WG6ZK6L3.js";
+} from "./chunk-L63ED43X.js";
 import {
   getEventCatalogConfigFile,
   verifyRequiredFieldsAreInCatalogConfigFile

package/dist/generate.cjs

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

package/dist/generate.js

@@ -1,8 +1,8 @@
 import {
   generate
-} from "./chunk-7ZEKF2LA.js";
-import "./chunk-MC4F3VVM.js";
-import "./chunk-WG6ZK6L3.js";
+} from "./chunk-N7LDFUEB.js";
+import "./chunk-QJXVAM76.js";
+import "./chunk-L63ED43X.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.5.2";
+var version = "5.6.1";
 
 // src/constants.ts
 var VERSION = version;

package/dist/utils/cli-logger.js

@@ -1,7 +1,7 @@
 import {
   logger
-} from "../chunk-MC4F3VVM.js";
-import "../chunk-WG6ZK6L3.js";
+} from "../chunk-QJXVAM76.js";
+import "../chunk-L63ED43X.js";
 export {
   logger
 };

package/eventcatalog/public/icons/specification.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="#64748b" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7Z"/><path d="M14 2v4a2 2 0 0 0 2 2h4"/><path d="m10 13-2 2 2 2"/><path d="m14 17 2-2-2-2"/></svg>

package/eventcatalog/src/components/ChatPanel/ChatPanel.tsx

@@ -408,10 +408,16 @@ const fadeInStyles = {
 };
 
 // Preprocess markdown to fix common formatting issues
-const preprocessMarkdown = (text: string): string => {
-  // Add newlines before headings if they're directly after text (no newline)
-  // This fixes cases like "some text.## Heading" → "some text.\n\n## Heading"
-  return text.replace(/([^\n])(#{1,6}\s)/g, '$1\n\n$2');
+export const preprocessMarkdown = (text: string): string => {
+  return (
+    text
+      // Add newlines before headings if they're directly after text (no newline)
+      // This fixes cases like "some text.## Heading" → "some text.\n\n## Heading"
+      .replace(/([^\n])(#{1,6}\s)/g, '$1\n\n$2')
+      // Show a link still streaming in ("[Order Service](/docs/serv") as its text: shown raw, its URL wraps onto more
+      // lines until the closing bracket arrives, then the answer jumps back as it collapses into a link
+      .replace(/\[([^\]\n]*)\]\([^)\s]*$/, '$1')
+  );
 };
 
 // Helper to extract text content from message parts
@@ -564,9 +570,12 @@ const modalMarkdownComponents = {
 const ChatPanel = ({ isOpen, onClose, configured = false }: ChatPanelProps) => {
   const inputRef = useRef<HTMLTextAreaElement>(null);
   const modalInputRef = useRef<HTMLTextAreaElement>(null);
-  const messagesEndRef = useRef<HTMLDivElement>(null);
-  const modalMessagesEndRef = useRef<HTMLDivElement>(null);
   const messagesContainerRef = useRef<HTMLDivElement>(null);
+  const modalMessagesContainerRef = useRef<HTMLDivElement>(null);
+  // Follow the answer as it streams, until the person scrolls up to read: sending a message or the scroll button
+  // follows it again
+  const followLatest = useRef(true);
+  const lastScrollTop = useRef(new WeakMap<HTMLElement, number>());
   const [inputValue, setInputValue] = useState('');
   const [isSetupThinking, setIsSetupThinking] = useState(false);
   const setupReplyTimer = useRef<ReturnType<typeof setTimeout> | null>(null);
@@ -647,10 +656,14 @@ const ChatPanel = ({ isOpen, onClose, configured = false }: ChatPanelProps) => {
     return null;
   }, [pathname]);
 
-  // Handle scroll to detect if user scrolled up
+  // Stop following the answer when the person scrolls up, and follow it again when they're back at the bottom.
+  // Only a move up stops it: content growing below doesn't scroll, and a scroll down is heading for the latest.
   const handleScroll = useCallback((e: React.UIEvent<HTMLDivElement>) => {
-    const target = e.target as HTMLDivElement;
+    const target = e.currentTarget;
     const isNearBottom = target.scrollHeight - target.scrollTop - target.clientHeight < 100;
+    if (isNearBottom) followLatest.current = true;
+    else if (target.scrollTop < (lastScrollTop.current.get(target) ?? 0)) followLatest.current = false;
+    lastScrollTop.current.set(target, target.scrollTop);
     setShowScrollButton(!isNearBottom);
   }, []);
 
@@ -685,16 +698,24 @@ const ChatPanel = ({ isOpen, onClose, configured = false }: ChatPanelProps) => {
   // Get currently running tools from the last assistant message
   const runningTools = useMemo(() => (lastAssistantMessage ? getRunningTools(lastAssistantMessage) : []), [lastAssistantMessage]);
 
-  // Scroll to bottom when new messages arrive
-  const scrollToBottom = useCallback(() => {
-    messagesEndRef.current?.scrollIntoView({ behavior: 'smooth' });
+  // Jump the messages (in the panel and the fullscreen modal) to the latest. Instantly: a smooth scroll restarted on
+  // every streamed token lands short of the growing answer and scrolls back and forth.
+  const scrollToLatest = useCallback(() => {
+    for (const container of [messagesContainerRef.current, modalMessagesContainerRef.current]) {
+      if (!container) continue;
+      container.scrollTop = container.scrollHeight;
+      lastScrollTop.current.set(container, container.scrollTop);
+    }
   }, []);
 
+  const scrollToBottom = useCallback(() => {
+    followLatest.current = true;
+    scrollToLatest();
+  }, [scrollToLatest]);
+
   useEffect(() => {
-    scrollToBottom();
-    // Also scroll modal messages
-    modalMessagesEndRef.current?.scrollIntoView({ behavior: 'smooth' });
-  }, [messages, scrollToBottom]);
+    if (followLatest.current) scrollToLatest();
+  }, [messages, scrollToLatest]);
 
   // Focus modal input when fullscreen opens
   useEffect(() => {
@@ -734,15 +755,19 @@ const ChatPanel = ({ isOpen, onClose, configured = false }: ChatPanelProps) => {
 
   // Add/remove padding to main application and header when sidebar panel is open
   useEffect(() => {
-    const appEl = document.getElementById('eventcatalog-application');
-    const headerEl = document.getElementById('eventcatalog-header');
-    const docsSidebarEl = document.getElementById('eventcatalog-docs-sidebar');
-
-    const elements = [appEl, headerEl].filter(Boolean) as HTMLElement[];
+    // Looked up each time: the panel stays open across ClientRouter navigations (the header persists), but each one
+    // swaps in a new page that needs pushing over too
+    const getElements = () => ({
+      elements: [document.getElementById('eventcatalog-application'), document.getElementById('eventcatalog-header')].filter(
+        Boolean
+      ) as HTMLElement[],
+      docsSidebarEl: document.getElementById('eventcatalog-docs-sidebar'),
+    });
 
     const desktop = window.matchMedia('(min-width: 1024px)');
     const updateLayout = () => {
       const pushContent = desktop.matches && isOpen && !isFullscreen;
+      const { elements, docsSidebarEl } = getElements();
       elements.forEach((el) => {
         if (!el.style.transition) {
           el.style.transition = 'padding-right 420ms cubic-bezier(0.16, 1, 0.3, 1)';
@@ -753,10 +778,14 @@ const ChatPanel = ({ isOpen, onClose, configured = false }: ChatPanelProps) => {
     };
     updateLayout();
     desktop.addEventListener('change', updateLayout);
+    // The new page is in place but not yet shown, so it opens already pushed over
+    document.addEventListener('astro:after-swap', updateLayout);
 
     // Cleanup on unmount
     return () => {
       desktop.removeEventListener('change', updateLayout);
+      document.removeEventListener('astro:after-swap', updateLayout);
+      const { elements, docsSidebarEl } = getElements();
       elements.forEach((el) => {
         el.style.paddingRight = '0';
       });
@@ -771,6 +800,7 @@ const ChatPanel = ({ isOpen, onClose, configured = false }: ChatPanelProps) => {
     (text: string) => {
       if (!text.trim() || isLoading) return;
       setInputValue('');
+      followLatest.current = true;
       if (!configured) {
         setMessages((previous) => [...previous, { id: crypto.randomUUID(), role: 'user', parts: [{ type: 'text', text }] }]);
         setIsSetupThinking(true);
@@ -1075,8 +1105,6 @@ const ChatPanel = ({ isOpen, onClose, configured = false }: ChatPanelProps) => {
                         </div>
                       </div>
                     ))}
-
-                  <div ref={messagesEndRef} />
                 </div>
               )}
             </div>
@@ -1265,7 +1293,7 @@ const ChatPanel = ({ isOpen, onClose, configured = false }: ChatPanelProps) => {
             </div>
 
             {/* Modal Content */}
-            <div className="flex-1 overflow-y-auto px-6 py-6">
+            <div ref={modalMessagesContainerRef} onScroll={handleScroll} className="flex-1 overflow-y-auto px-6 py-6">
               {!hasMessages ? (
                 /* Welcome area - Clean design */
                 <div className="flex flex-col h-full max-w-2xl mx-auto">
@@ -1383,8 +1411,6 @@ const ChatPanel = ({ isOpen, onClose, configured = false }: ChatPanelProps) => {
                         </div>
                       </div>
                     ))}
-
-                  <div ref={modalMessagesEndRef} />
                 </div>
               )}
             </div>

package/eventcatalog/src/components/Grids/specification-utils.ts

@@ -1,6 +1,6 @@
 import { buildUrl } from '@utils/url-builder';
 
-export type SpecificationType = 'openapi' | 'asyncapi' | 'graphql';
+export type SpecificationType = 'openapi' | 'asyncapi' | 'graphql' | 'generic';
 
 export interface Specification {
   type: SpecificationType;
@@ -18,6 +18,8 @@ export const getSpecUrl = (spec: Specification, serviceId: string, serviceVersio
       return buildUrl(`/docs/services/${serviceId}/${serviceVersion}/asyncapi/${spec.filenameWithoutExtension}`);
     case 'graphql':
       return buildUrl(`/docs/services/${serviceId}/${serviceVersion}/graphql/${spec.filenameWithoutExtension}`);
+    case 'generic':
+      return buildUrl(`/docs/services/${serviceId}/${serviceVersion}/generic/${spec.filenameWithoutExtension}`);
     default:
       return '#';
   }
@@ -31,6 +33,8 @@ export const getSpecIcon = (type: string): string => {
       return 'asyncapi';
     case 'graphql':
       return 'graphql';
+    case 'generic':
+      return 'specification';
     default:
       return 'json-schema';
   }
@@ -44,6 +48,8 @@ export const getSpecLabel = (type: string): string => {
       return 'AsyncAPI';
     case 'graphql':
       return 'GraphQL';
+    case 'generic':
+      return 'Specification';
     default:
       return type;
   }

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

@@ -390,7 +390,7 @@ const tooltipId = `ref-tooltip-${Math.random().toString(36).slice(2, 9)}`;
                             href={getSpecUrl(spec, resourceId, resource?.data?.version)}
                             class="hover:underline hover:text-[rgb(var(--ec-accent))]"
                           >
-                            {getSpecLabel(spec.type)}
+                            {spec.type === 'generic' && spec.name ? spec.name : getSpecLabel(spec.type)}
                           </a>
                           {idx < specifications.length - 1 && ', '}
                         </>