@eventcatalog/core 5.9.1 → 5.11.0

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

package/dist/analytics/analytics.js

@@ -1,8 +1,8 @@
 import {
   raiseEvent
-} from "../chunk-YBM7MCOY.js";
+} from "../chunk-54GBEFRV.js";
 import "../chunk-CPW6G62V.js";
-import "../chunk-KGFAIGOT.js";
+import "../chunk-Y32K66EM.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.9.1";
+var version = "5.11.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/analytics/log-build.js

@@ -1,12 +1,12 @@
 import {
   log_build_default
-} from "../chunk-3PWCUWQC.js";
+} from "../chunk-EJXOHDUL.js";
 import "../chunk-AD7CL772.js";
-import "../chunk-YBM7MCOY.js";
+import "../chunk-54GBEFRV.js";
 import "../chunk-YRZK7HKX.js";
 import "../chunk-CA6WCQ2T.js";
 import "../chunk-CPW6G62V.js";
-import "../chunk-KGFAIGOT.js";
+import "../chunk-Y32K66EM.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.31_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.32_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-YBM7MCOY.js → chunk-54GBEFRV.js}

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

package/dist/{chunk-A3256YCN.js → chunk-C4KPS65M.js}

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

package/dist/{chunk-JDSFD7IC.js → chunk-EJU3H6C4.js}

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

package/dist/{chunk-3PWCUWQC.js → chunk-EJXOHDUL.js}

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

package/dist/{chunk-KGFAIGOT.js → chunk-Y32K66EM.js}

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

package/dist/constants.cjs

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

package/dist/constants.js

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

package/dist/docs/development/01-getting-started/develop-and-build.md

@@ -58,6 +58,25 @@ Note that this previews your code as it existed when the build command was last
 
 Use (Ctrl + C) to quit the preview and run another terminal command, such as restarting the dev server to go back to working in development mode which does update as you edit to show a live preview of your code changes.
 
+### Find out where build time goes
+
+<AddedIn version="5.11.0" />
+
+If your catalog takes longer to build than you expect, add `--timings` to the build command. When the build finishes, EventCatalog prints a summary of where the time went:
+
+```bash
+npx eventcatalog build --timings
+```
+
+The summary breaks the build down into:
+
+- **Build phases**: how long bundling and generating pages took.
+- **Markdown plugins**: the time spent processing your Markdown and MDX files, such as syntax highlighting code blocks.
+- **Slowest files to bundle** and **slowest pages**: the individual files and pages that took the longest.
+- **Integrations**: the time spent in steps that run during the build, such as link validation.
+
+Use it to decide what to look at first, or to compare build times before and after a change to your catalog.
+
 
 ## EventCatalog static vs server output
 

package/dist/docs/development/guides/resources/entities/05-entity-maps.md

@@ -44,7 +44,12 @@ You can also embed an entity map on a page using the `<EntityMap />` component.
 
 Use embedded entity maps when you want the model to appear directly in domain, service, or custom documentation.
 
+## See every entity at once
+
+Entity maps show the entities of one domain or service. To see every entity in your catalog, and how entities relate across domains, open the [Global Entity Map](/docs/development/guides/resources/entities/global-entity-map).
+
 ## Next steps
 
 - [Model entity relationships](/docs/development/guides/resources/entities/model-entity-relationships)
+- [Global entity map](/docs/development/guides/resources/entities/global-entity-map)
 - [EntityMap component reference](/docs/development/components/components/entitymap)

package/dist/docs/development/guides/resources/entities/06-global-entity-map.md

@@ -0,0 +1,101 @@
+---
+keywords:
+- EventCatalog entities
+- Global entity map
+- Entity relationship diagram
+- Data model
+sidebar_position: 6
+sidebar_label: Global entity map
+title: Global entity map
+description: See every entity in your catalog, and how they relate across domains, on one diagram.
+---
+
+import AddedIn from '@site/src/components/MDX/AddedIn';
+
+<AddedIn version="5.10.0" />
+
+The Global Entity Map shows every entity in your catalog on one diagram, with the references between them. Where an [entity map](/docs/development/guides/resources/entities/entity-maps) shows the entities of one domain or service, the Global Entity Map shows the data model of the whole organization.
+
+Use it to answer questions like:
+
+- Which entities does each domain own?
+- Which entities are referenced from other domains?
+- Which entities are shared by more than one domain?
+- Which entities don't belong to anything yet?
+
+![Global Entity Map showing every entity grouped into its domain](./img/global-entity-map.png)
+
+## Open the Global Entity Map
+
+When your catalog has entities, a **Global Entity Map** link appears in the **Top level diagrams** section of the visualizer sidebar. You can also open it at:
+
+```txt
+/visualiser/entity-map
+```
+
+The map shows the latest version of every entity.
+
+If you've [customized your sidebar](/docs/development/customization/documentation-sidebar#custom-groups-and-links), you can add a custom link to this URL.
+
+## How entities are placed in domains
+
+[Entities can be added to domains, systems, and services](/docs/development/guides/resources/entities/add-entities-to-resources). The Global Entity Map works out which domain each entity belongs to from any of them:
+
+| Entity listed by | Belongs to |
+|------------------|------------|
+| A domain | That domain. |
+| A system | The system, and the domain the system is in. |
+| A service | The service's system (if it's in one), and its domain. |
+| More than one domain | **Shared across domains**, a group of its own. |
+| Nothing | No domain. It's shown outside every group. |
+
+A resource that pins an older version of an entity doesn't own the latest version. For example, if a domain lists `customer` at version `1.0.0` and the latest is `2.0.0`, that domain doesn't own the `customer` shown on the map.
+
+An entity's team is its own owner, or else the owner of the domain, system, or service that lists it.
+
+## Group entities
+
+The map opens with entities grouped by their domain. Use **Group by** at the top right of the diagram (or press <kbd>G</kbd>) to group them another way:
+
+| Group by | What it shows |
+|----------|---------------|
+| **Domain** | A box for each domain, and one for entities shared across domains. |
+| **System** | A box for each system. Only entities listed by a system, or by a service in one, are grouped. |
+| **Team** | A box for each owning team. |
+| **Domain, then system** | Systems nested in their domain. |
+| **Nothing** | No groups. |
+
+Groups can be shown as **Boxes** placed around their entities, or as **Lanes** stacked from top to bottom.
+
+![The Group by menu, with entities grouped by domain](./img/global-entity-map-group-by.png)
+
+## Filter what's shown
+
+The panel on the left of the diagram lists each domain, with how many entities it has and how many references cross into other domains.
+
+- Click a domain to show or hide its entities.
+- Hover over a domain and click the button that appears beside it (**Only show**) to show just that domain. Click it again to show everything.
+- Use **Show all** and **Hide all** to change every domain at once, and **Filter domains** to find a domain in a long list.
+- Turn on **Only references across domains** to show only the entities that reference, or are referenced by, an entity in another domain. This is a quick way to see the dependencies between domains.
+
+![The Global Entity Map with two domains hidden and only references across domains shown](./img/global-entity-map-filters.png)
+
+To give the diagram more room, collapse the panel with the button at its top right (or press <kbd>[</kbd>). The collapsed panel shows how many filters are on, so hidden domains aren't forgotten. The map remembers whether the panel is open in your browser.
+
+## Share a view
+
+The domains you've hidden, the **Only references across domains** filter, and the grouping are all kept in the URL. Copy the URL to share exactly what you're looking at. For example:
+
+```txt
+/visualiser/entity-map?hide=reviews,shopping&crossDomain=true&group=team
+```
+
+## Find an entity
+
+Use **Search nodes** at the top of the diagram to find an entity. Picking one moves the diagram to it and selects it.
+
+## Next steps
+
+- [Add entities to resources](/docs/development/guides/resources/entities/add-entities-to-resources)
+- [Model entity relationships](/docs/development/guides/resources/entities/model-entity-relationships)
+- [Entity maps](/docs/development/guides/resources/entities/entity-maps)

package/dist/docs/development/guides/resources/entities/{06-reference.md → 07-reference.md}

@@ -2,7 +2,7 @@
 keywords:
 - EventCatalog entities
 - Entity frontmatter
-sidebar_position: 6
+sidebar_position: 7
 sidebar_label: Reference
 title: Entities reference
 description: Frontmatter fields, paths, and routes for entities in EventCatalog.
@@ -43,6 +43,7 @@ Nested entities use the same `versioned/{version}/index.mdx` pattern inside thei
 | `/visualiser/entities/{entity-id}/{version}` | Entity resource diagram. |
 | `/visualiser/domains/{domain-id}/{version}/entity-map` | Entity Diagram for entities assigned to a domain. |
 | `/visualiser/services/{service-id}/{version}/entity-map` | Entity Diagram for entities assigned to a service. |
+| `/visualiser/entity-map` | [Global Entity Map](/docs/development/guides/resources/entities/global-entity-map): every entity in the catalog, grouped by domain. |
 
 ## Frontmatter example
 

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.31_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.32_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();
 
@@ -175,7 +175,7 @@ var verifyRequiredFieldsAreInCatalogConfigFile = async (projectDirectory) => {
 var import_picocolors = __toESM(require("picocolors"), 1);
 
 // package.json
-var version = "5.9.1";
+var version = "5.11.0";
 
 // src/constants.ts
 var VERSION = version;
@@ -3431,7 +3431,7 @@ program.command("dev").description("Run development server of EventCatalog").opt
     await watchUnsub?.();
   }
 });
-program.command("build").description("Run build of EventCatalog").action(async (options, command) => {
+program.command("build").description("Run build of EventCatalog").option("--timings", "Print a summary of where the build spent its time").action(async (options, command) => {
   logger.welcome();
   logger.info("Building EventCatalog...", "build");
   const isServer = await isOutputServer();
@@ -3463,7 +3463,7 @@ program.command("build").description("Run build of EventCatalog").action(async (
   checkForUpdate();
   await runCommandWithFilteredOutput({
     command: process.execPath,
-    args: [astroCli, "build", "--config", astroConfigPath(), ...command.args],
+    args: [astroCli, "build", "--config", astroConfigPath(), ...options.timings ? ["--timings"] : [], ...command.args],
     cwd: dir,
     env: {
       PROJECT_DIR: dir,

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-3PWCUWQC.js";
+} from "./chunk-EJXOHDUL.js";
 import {
   getLicenseStatus,
   printLicenseStatus
 } from "./chunk-AD7CL772.js";
-import "./chunk-YBM7MCOY.js";
+import "./chunk-54GBEFRV.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-A3256YCN.js";
+} from "./chunk-C4KPS65M.js";
 import {
   logger
-} from "./chunk-JDSFD7IC.js";
+} from "./chunk-EJU3H6C4.js";
 import {
   resolve_catalog_dependencies_default
 } from "./chunk-PD7KTSYN.js";
@@ -79,7 +79,7 @@ import {
 } from "./chunk-LFQJXLHG.js";
 import {
   VERSION
-} from "./chunk-KGFAIGOT.js";
+} from "./chunk-Y32K66EM.js";
 import {
   getEventCatalogConfigFile,
   verifyRequiredFieldsAreInCatalogConfigFile
@@ -989,7 +989,7 @@ program.command("dev").description("Run development server of EventCatalog").opt
     await watchUnsub?.();
   }
 });
-program.command("build").description("Run build of EventCatalog").action(async (options, command) => {
+program.command("build").description("Run build of EventCatalog").option("--timings", "Print a summary of where the build spent its time").action(async (options, command) => {
   logger.welcome();
   logger.info("Building EventCatalog...", "build");
   const isServer = await isOutputServer();
@@ -1021,7 +1021,7 @@ program.command("build").description("Run build of EventCatalog").action(async (
   checkForUpdate();
   await runCommandWithFilteredOutput({
     command: process.execPath,
-    args: [astroCli, "build", "--config", astroConfigPath(), ...command.args],
+    args: [astroCli, "build", "--config", astroConfigPath(), ...options.timings ? ["--timings"] : [], ...command.args],
     cwd: dir,
     env: {
       PROJECT_DIR: dir,

package/dist/generate.cjs

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

package/dist/generate.js

@@ -1,8 +1,8 @@
 import {
   generate
-} from "./chunk-A3256YCN.js";
-import "./chunk-JDSFD7IC.js";
-import "./chunk-KGFAIGOT.js";
+} from "./chunk-C4KPS65M.js";
+import "./chunk-EJU3H6C4.js";
+import "./chunk-Y32K66EM.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.9.1";
+var version = "5.11.0";
 
 // src/constants.ts
 var VERSION = version;

package/dist/utils/cli-logger.js

@@ -1,7 +1,7 @@
 import {
   logger
-} from "../chunk-JDSFD7IC.js";
-import "../chunk-KGFAIGOT.js";
+} from "../chunk-EJU3H6C4.js";
+import "../chunk-Y32K66EM.js";
 export {
   logger
 };