@likec4/core 1.30.0 → 1.31.0

package/dist/builder/index.d.mts

@@ -1,5 +1,5 @@
 import { LastArrayElement, Split, Simplify, Writable, IfNever, TupleToUnion, Tagged, IsStringLiteral as IsStringLiteral$1, IsLiteral } from 'type-fest';
-import { L as LikeC4Model } from '../shared/core.CiFKryGW.mjs';
+import { L as LikeC4Model } from '../shared/core.CQDU11hR.mjs';
 import { D as DeploymentElement, i as DeploymentRelation, q as Element, ah as ModelRelation, a9 as Participant, M as ModelLayer, bs as ViewRuleStyle, aT as AutoLayoutDirection, y as ExpressionV2, L as LikeC4View, b0 as DeploymentView, bd as ElementView, t as ElementShape, ap as Color, p as BorderStyle, av as ShapeSize, aw as SpacingSize, ax as TextSize, aj as RelationshipArrowType, am as RelationshipLineType, r as ElementKindSpecification, al as RelationshipKindSpecification, g as DeploymentNodeKindSpecification, V as ParsedLikeC4ModelData } from '../shared/core.DJvmfnEi.mjs';
 import { F as Fqn, N as NonEmptyArray, K as KeysOf } from '../shared/core.SjLhMA7a.mjs';
 import { IsStringLiteral } from 'type-fest/source/is-literal';

package/dist/builder/index.mjs

@@ -1,4 +1,4 @@
-import { a as i, l, d, L as LikeC4Model } from '../shared/core.CAcZ6_cP.mjs';
+import { a as i, l, d, L as LikeC4Model } from '../shared/core.Bq753SYD.mjs';
 import { m, l as l$1, i as i$1 } from '../shared/core.Cu-UdkSl.mjs';
 import { f as t, n as nameFromFqn, g as isSameHierarchy, p as parentFqn, h as t$1 } from '../shared/core.CQXU9DF7.mjs';
 import { o, M as ModelLayer, D as DefaultElementShape, b as DefaultThemeColor, n as n$1, c as DeploymentElement, d as isScopedElementView } from '../shared/core.DgfwjBtu.mjs';

package/dist/compute-view/index.d.mts

@@ -1,4 +1,4 @@
-export { C as ComputeViewResult, c as computeView, a as computeViews, u as unsafeComputeView } from '../shared/core.CiFKryGW.mjs';
+export { C as ComputeViewResult, c as computeView, a as computeViews, u as unsafeComputeView } from '../shared/core.CQDU11hR.mjs';
 import { L as LikeC4View, C as ComputedLikeC4ModelData, a as ComputedView } from '../shared/core.DJvmfnEi.mjs';
 import 'type-fest';
 import '../shared/core.SjLhMA7a.mjs';

package/dist/compute-view/index.mjs

@@ -1,5 +1,5 @@
-import { G as Graph, r, w as willCreateCycle, t as topologicalSortExports, i as i$1, a as i$2, l } from '../shared/core.CAcZ6_cP.mjs';
-export { c as computeView, b as computeViews, u as unsafeComputeView } from '../shared/core.CAcZ6_cP.mjs';
+import { G as Graph, r, w as willCreateCycle, t as topologicalSortExports, i as i$1, a as i$2, l } from '../shared/core.Bq753SYD.mjs';
+export { c as computeView, b as computeViews, u as unsafeComputeView } from '../shared/core.Bq753SYD.mjs';
 import { i as isExtendsElementView, a as isElementView } from '../shared/core.DgfwjBtu.mjs';
 import { e as isNonEmptyArray } from '../shared/core.CQXU9DF7.mjs';
 import { i, m } from '../shared/core.Cu-UdkSl.mjs';

package/dist/compute-view/relationships-view/index.d.mts

@@ -1,4 +1,4 @@
-import { A as AnyAux, E as ElementModel, R as RelationshipModel, L as LikeC4Model } from '../../shared/core.CiFKryGW.mjs';
+import { A as AnyAux, E as ElementModel, R as RelationshipModel, L as LikeC4Model } from '../../shared/core.CQDU11hR.mjs';
 import 'type-fest';
 import '../../shared/core.SjLhMA7a.mjs';
 import '../../shared/core.DJvmfnEi.mjs';

package/dist/index.d.mts

@@ -1,8 +1,8 @@
 import { H as HexColorLiteral, T as ThemeColorValues, b as LikeC4Theme } from './shared/core.DJvmfnEi.mjs';
 export { ag as AbstractRelation, a1 as AllNever, a2 as AndOperator, O as AnyParsedLikeC4ModelData, aT as AutoLayoutDirection, aW as BBox, aU as BasicElementView, aV as BasicView, p as BorderStyle, B as BorderStyles, ap as Color, aq as ColorLiteral, aX as ComputedDeploymentView, aY as ComputedDynamicView, aZ as ComputedEdge, a_ as ComputedElementView, C as ComputedLikeC4ModelData, az as ComputedNode, a as ComputedView, a$ as CustomColorDefinitions, ad as DefaultArrowType, j as DefaultElementShape, ae as DefaultLineStyle, k as DefaultPaddingSize, af as DefaultRelationshipColor, l as DefaultShapeSize, m as DefaultTextSize, n as DefaultThemeColor, c as DeployedInstance, D as DeploymentElement, d as DeploymentElementStyle, e as DeploymentNode, f as DeploymentNodeKind, g as DeploymentNodeKindSpecification, h as DeploymentRef, i as DeploymentRelation, b0 as DeploymentView, b1 as DeploymentViewRule, b2 as DeploymentViewRulePredicate, b3 as DeploymentViewRuleStyle, b4 as DiagramEdge, aA as DiagramNode, b5 as DiagramView, b6 as DynamicView, b7 as DynamicViewIncludeRule, b8 as DynamicViewParallelSteps, b9 as DynamicViewRule, ba as DynamicViewStep, bb as DynamicViewStepOrParallel, bc as EdgeId, q as Element, E as ElementKind, r as ElementKindSpecification, s as ElementKindSpecificationStyle, bw as ElementNotation, t as ElementShape, o as ElementShapes, u as ElementStyle, as as ElementThemeColorValues, ar as ElementThemeColors, bd as ElementView, a3 as EqualOperator, y as ExpressionV2, be as ExtendsElementView, a4 as Filterable, F as FqnExpr, z as FqnRef, Q as GenericLikeC4ModelData, G as GlobalDynamicPredicates, A as GlobalPredicateId, I as GlobalPredicates, J as GlobalStyleID, K as GlobalStyles, a5 as KindEqual, S as LayoutedLikeC4ModelData, U as LikeC4ModelDump, L as LikeC4View, v as Link, N as ModelGlobals, M as ModelLayer, ah as ModelRelation, bf as NodeId, a6 as NotOperator, a7 as OperatorPredicate, a8 as OrOperator, V as ParsedLikeC4ModelData, a9 as Participant, aa as ParticipantOperator, P as PredicateSelector, R as RelationExpr, ai as RelationId, aj as RelationshipArrowType, ak as RelationshipKind, al as RelationshipKindSpecification, am as RelationshipLineType, au as RelationshipThemeColorValues, at as RelationshipThemeColors, bg as ScopedElementView, av as ShapeSize, aw as SpacingSize, bh as StepEdgeId, bi as StepEdgeIdLiteral, ab as TagEqual, w as TagSpec, ax as TextSize, ay as ThemeColor, ao as ThemeColors, x as TypedElement, bj as ViewAutoLayout, bk as ViewId, bl as ViewManualLayout, bm as ViewRule, bn as ViewRuleAutoLayout, bo as ViewRuleGlobalPredicateRef, bp as ViewRuleGlobalStyle, bq as ViewRuleGroup, br as ViewRulePredicate, bs as ViewRuleStyle, bt as ViewRuleStyleOrGlobalRef, bu as ViewWithHash, bv as ViewWithNotation, ac as WhereOperator, aB as extractStep, aC as getBBoxCenter, aD as getParallelStepsPrefix, W as isAndOperator, aE as isAutoLayoutDirection, aF as isDeploymentView, aG as isDynamicView, aH as isDynamicViewParallelSteps, aI as isElementView, aJ as isExtendsElementView, X as isKindEqual, Y as isNotOperator, Z as isOrOperator, _ as isParticipantOperator, aK as isScopedElementView, aL as isStepEdgeId, $ as isTagEqual, an as isThemeColor, aM as isViewRuleAutoLayout, aN as isViewRuleGlobalPredicateRef, aO as isViewRuleGlobalStyle, aP as isViewRuleGroup, aQ as isViewRulePredicate, aR as isViewRuleStyle, aS as stepEdgeId, a0 as whereOperatorAsPredicate } from './shared/core.DJvmfnEi.mjs';
 export { BiMap, DefaultMap, DefaultWeakMap, LinkedList, MultiMap, Queue, Stack, commonHead, compareNatural, compareRelations, delay, difference, equalsSet, getOrCreate, hasAtLeast, ifilter, ifind, iflat, imap, intersection, ireduce, isIterable, isNonEmptyArray, isString, isome, iunique, objectHash, stringHash, symmetricDifference, toArray, toSet, union } from './utils/index.mjs';
-export { A as AnyAux, b as Aux, C as ComputeViewResult, D as DeployedInstanceModel, d as DeploymentElementModel, e as DeploymentNodeModel, f as DeploymentRelationModel, g as EdgeModel, E as ElementModel, h as LikeC4DeploymentModel, L as LikeC4Model, i as LikeC4ViewModel, N as NodeModel, R as RelationshipModel, c as computeView, a as computeViews, u as unsafeComputeView } from './shared/core.CiFKryGW.mjs';
-export { C as Connection, a as ConnectionModel, D as DeploymentConnectionModel } from './shared/core.CZR9J1Qx.mjs';
+export { A as AnyAux, b as Aux, C as ComputeViewResult, D as DeployedInstanceModel, d as DeploymentElementModel, e as DeploymentNodeModel, f as DeploymentRelationModel, g as EdgeModel, E as ElementModel, h as LikeC4DeploymentModel, L as LikeC4Model, i as LikeC4ViewModel, N as NodeModel, R as RelationshipModel, c as computeView, a as computeViews, u as unsafeComputeView } from './shared/core.CQDU11hR.mjs';
+export { C as Connection, a as ConnectionModel, D as DeploymentConnectionModel } from './shared/core.Dx7siloV.mjs';
 export { A as AsFqn, C as CustomColor, E as ExclusiveUnion, F as Fqn, G as GlobalFqn, d as IconUrl, I as IteratorLike, K as KeysOf, b as NTuple, N as NonEmptyArray, a as NonEmptyReadonlyArray, P as Point, c as Predicate, e as ProjectId, T as Tag, X as XYPoint, i as isGlobalFqn, s as splitGlobalFqn } from './shared/core.SjLhMA7a.mjs';
 export { OverviewGraph, ViewChange } from './types/index.mjs';
 export { I as IterableContainer, R as ReorderedArray, a as ancestorsFqn, c as commonAncestor, b as compareByFqnHierarchically, d as compareFqnHierarchically, h as hierarchyDistance, e as hierarchyLevel, i as isAncestor, f as isDescendantOf, g as isSameHierarchy, n as nameFromFqn, p as parentFqn, s as sortByFqnHierarchically, j as sortNaturalByFqn, k as sortParentsFirst } from './shared/core.D2830qgg.mjs';

package/dist/index.mjs

@@ -1,5 +1,5 @@
 export { i as invariant, n as nonNullable, a as nonexhaustive } from './shared/core.C-YXI-43.mjs';
-export { C as Connection, e as ConnectionModel, D as DeployedInstanceModel, f as DeploymentConnectionModel, g as DeploymentNodeModel, h as DeploymentRelationModel, E as EdgeModel, j as ElementModel, k as LikeC4DeploymentModel, L as LikeC4Model, m as LikeC4ViewModel, N as NodeModel, R as RelationshipModel, c as computeView, b as computeViews, u as unsafeComputeView } from './shared/core.CAcZ6_cP.mjs';
+export { C as Connection, e as ConnectionModel, D as DeployedInstanceModel, f as DeploymentConnectionModel, g as DeploymentNodeModel, h as DeploymentRelationModel, E as EdgeModel, j as ElementModel, k as LikeC4DeploymentModel, L as LikeC4Model, m as LikeC4ViewModel, N as NodeModel, R as RelationshipModel, c as computeView, b as computeViews, u as unsafeComputeView } from './shared/core.Bq753SYD.mjs';
 export { A as AsFqn, B as BorderStyles, C as ComputedNode, z as ComputedView, v as DefaultArrowType, D as DefaultElementShape, x as DefaultLineStyle, f as DefaultPaddingSize, y as DefaultRelationshipColor, g as DefaultShapeSize, h as DefaultTextSize, b as DefaultThemeColor, c as DeploymentElement, H as DiagramNode, E as ElementKind, j as ElementShapes, k as ExpressionV2, F as FqnExpr, l as FqnRef, G as GlobalFqn, M as ModelLayer, R as RelationExpr, I as extractStep, J as getBBoxCenter, K as getParallelStepsPrefix, m as isAndOperator, L as isAutoLayoutDirection, N as isDeploymentView, O as isDynamicView, P as isDynamicViewParallelSteps, a as isElementView, i as isExtendsElementView, e as isGlobalFqn, p as isKindEqual, q as isNotOperator, r as isOrOperator, t as isParticipantOperator, d as isScopedElementView, Q as isStepEdgeId, u as isTagEqual, S as isViewRuleAutoLayout, T as isViewRuleGlobalPredicateRef, U as isViewRuleGlobalStyle, V as isViewRuleGroup, W as isViewRulePredicate, X as isViewRuleStyle, s as splitGlobalFqn, Y as stepEdgeId, w as whereOperatorAsPredicate } from './shared/core.DgfwjBtu.mjs';
 export { ThemeColors, isThemeColor } from './types/index.mjs';
 export { BiMap, DefaultWeakMap, LinkedList, MultiMap, Queue, compareRelations, delay, ireduce } from './utils/index.mjs';
@@ -3488,6 +3488,7 @@ function generateColorsMap(color) {
     const saturationDelta = SATURATION_MAP[i] - SATURATION_MAP[baseColorIndex];
     return saturationDelta >= 0 ? c.saturate(saturationDelta) : c.desaturate(saturationDelta * -1);
   });
+  colors[baseColorIndex] = chroma(color);
   return { baseColorIndex, colors };
 }
 function generateColors(color) {

package/dist/model/index.d.mts

@@ -1,6 +1,6 @@
-import { A as AnyAux, d as DeploymentElementModel, E as ElementModel, D as DeployedInstanceModel, e as DeploymentNodeModel } from '../shared/core.CiFKryGW.mjs';
-export { b as Aux, f as DeploymentRelationModel, g as EdgeModel, h as LikeC4DeploymentModel, L as LikeC4Model, i as LikeC4ViewModel, N as NodeModel, R as RelationshipModel } from '../shared/core.CiFKryGW.mjs';
-import { C as Connection, D as DeploymentConnectionModel, a as ConnectionModel } from '../shared/core.CZR9J1Qx.mjs';
+import { A as AnyAux, d as DeploymentElementModel, E as ElementModel, D as DeployedInstanceModel, e as DeploymentNodeModel } from '../shared/core.CQDU11hR.mjs';
+export { b as Aux, f as DeploymentRelationModel, g as EdgeModel, h as LikeC4DeploymentModel, L as LikeC4Model, i as LikeC4ViewModel, N as NodeModel, R as RelationshipModel } from '../shared/core.CQDU11hR.mjs';
+import { C as Connection, D as DeploymentConnectionModel, a as ConnectionModel } from '../shared/core.Dx7siloV.mjs';
 import { I as IterableContainer, R as ReorderedArray } from '../shared/core.D2830qgg.mjs';
 import 'type-fest';
 import '../shared/core.SjLhMA7a.mjs';

package/dist/model/index.mjs

@@ -1 +1 @@
-export { C as Connection, e as ConnectionModel, D as DeployedInstanceModel, f as DeploymentConnectionModel, g as DeploymentNodeModel, h as DeploymentRelationModel, E as EdgeModel, j as ElementModel, k as LikeC4DeploymentModel, L as LikeC4Model, m as LikeC4ViewModel, N as NodeModel, R as RelationshipModel, n as deploymentConnection, o as differenceConnections, p as findAscendingConnections, q as findDeepestNestedConnection, s as findDescendantConnections, v as hasSameSource, x as hasSameSourceTarget, y as hasSameTarget, z as isAnyInOut, M as isDeployedInstance, O as isDeploymentNode, A as isIncoming, B as isNestedConnection, F as isOutgoing, H as mergeConnections, I as modelConnection, J as sortConnectionsByBoundaryHierarchy, K as sortDeepestFirst } from '../shared/core.CAcZ6_cP.mjs';
+export { C as Connection, e as ConnectionModel, D as DeployedInstanceModel, f as DeploymentConnectionModel, g as DeploymentNodeModel, h as DeploymentRelationModel, E as EdgeModel, j as ElementModel, k as LikeC4DeploymentModel, L as LikeC4Model, m as LikeC4ViewModel, N as NodeModel, R as RelationshipModel, n as deploymentConnection, o as differenceConnections, p as findAscendingConnections, q as findDeepestNestedConnection, s as findDescendantConnections, v as hasSameSource, x as hasSameSourceTarget, y as hasSameTarget, z as isAnyInOut, M as isDeployedInstance, O as isDeploymentNode, A as isIncoming, B as isNestedConnection, F as isOutgoing, H as mergeConnections, I as modelConnection, J as sortConnectionsByBoundaryHierarchy, K as sortDeepestFirst } from '../shared/core.Bq753SYD.mjs';

package/dist/shared/{core.CAcZ6_cP.mjs → core.Bq753SYD.mjs}

@@ -265,6 +265,12 @@ class ElementModel {
   deployments() {
     return this.$model.deployment.instancesOf(this);
   }
+  getMetadata(field) {
+    if (field) {
+      return this.$element.metadata?.[field];
+    }
+    return this.$element.metadata ?? {};
+  }
 }
 function isElementModel(element) {
   return element instanceof ElementModel;
@@ -1686,6 +1692,12 @@ class AbstractDeploymentElementModel {
     );
     return this.cachedIncoming;
   }
+  getMetadata(field) {
+    if (field) {
+      return this.$node.metadata?.[field];
+    }
+    return this.$node.metadata ?? {};
+  }
 }
 class DeploymentNodeModel extends AbstractDeploymentElementModel {
   constructor($model, $node) {
@@ -1968,6 +1980,12 @@ class DeploymentRelationModel {
   isDeploymentRelation() {
     return true;
   }
+  getMetadata(field) {
+    if (field) {
+      return this.$relationship.metadata?.[field];
+    }
+    return this.$relationship.metadata ?? {};
+  }
 }
 class RelationshipsAccum {
   /**
@@ -6795,6 +6813,12 @@ class RelationshipModel {
   isDeploymentRelation() {
     return false;
   }
+  getMetadata(field) {
+    if (field) {
+      return this.$relationship.metadata?.[field];
+    }
+    return this.$relationship.metadata ?? {};
+  }
 }
 
 class EdgeModel {

package/dist/shared/{core.CiFKryGW.d.mts → core.CQDU11hR.d.mts}

@@ -254,6 +254,8 @@ declare class RelationshipModel<M extends AnyAux = AnyAux> {
      */
     views(): ViewsIterator<M>;
     isDeploymentRelation(): this is DeploymentRelationModel<M>;
+    getMetadata(): Record<string, string>;
+    getMetadata(field: string): string | undefined;
 }
 
 declare class LikeC4Model<M extends AnyAux = LikeC4Model.Any> {
@@ -533,6 +535,8 @@ declare abstract class AbstractDeploymentElementModel<M extends AnyAux = AnyAux>
     protected cachedIncoming: RelationshipsAccum<M> | null;
     get allOutgoing(): RelationshipsAccum<M>;
     get allIncoming(): RelationshipsAccum<M>;
+    getMetadata(): Record<string, string>;
+    getMetadata(field: string): string | undefined;
 }
 declare class DeploymentNodeModel<M extends AnyAux = AnyAux> extends AbstractDeploymentElementModel<M> {
     readonly $model: LikeC4DeploymentModel<M>;
@@ -635,6 +639,8 @@ declare class DeploymentRelationModel<M extends AnyAux = AnyAux> {
     get line(): RelationshipLineType;
     views(): IteratorLike<LikeC4ViewModel<M, ComputedDeploymentView>>;
     isDeploymentRelation(): this is DeploymentRelationModel<M>;
+    getMetadata(): Record<string, string>;
+    getMetadata(field: string): string | undefined;
 }
 declare class RelationshipsAccum<M extends AnyAux> {
     readonly model: ReadonlySet<RelationshipModel<M>>;
@@ -740,6 +746,8 @@ declare class ElementModel<M extends AnyAux = AnyAux> {
      */
     isDeployed(): boolean;
     deployments(): DeployedInstancesIterator<M>;
+    getMetadata(): Record<string, string>;
+    getMetadata(field: string): string | undefined;
 }
 
 export { type AnyAux as A, type ComputeViewResult as C, DeployedInstanceModel as D, ElementModel as E, LikeC4Model as L, NodeModel as N, RelationshipModel as R, computeViews as a, Aux as b, computeView as c, type DeploymentElementModel as d, DeploymentNodeModel as e, DeploymentRelationModel as f, EdgeModel as g, LikeC4DeploymentModel as h, LikeC4ViewModel as i, RelationshipsAccum as j, unsafeComputeView as u };

package/dist/shared/{core.CZR9J1Qx.d.mts → core.Dx7siloV.d.mts}

@@ -1,4 +1,4 @@
-import { E as ElementModel, d as DeploymentElementModel, A as AnyAux, e as DeploymentNodeModel, D as DeployedInstanceModel, j as RelationshipsAccum, R as RelationshipModel, f as DeploymentRelationModel } from './core.CiFKryGW.mjs';
+import { E as ElementModel, d as DeploymentElementModel, A as AnyAux, e as DeploymentNodeModel, D as DeployedInstanceModel, j as RelationshipsAccum, R as RelationshipModel, f as DeploymentRelationModel } from './core.CQDU11hR.mjs';
 import { F as Fqn, I as IteratorLike } from './core.SjLhMA7a.mjs';
 
 interface Connection<Elem = ElementModel | DeploymentElementModel, Id = string> {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@likec4/core",
-  "version": "1.30.0",
+  "version": "1.31.0",
   "license": "MIT",
   "homepage": "https://likec4.dev",
   "author": "Denis Davydkov <denis@davydkov.com>",
@@ -77,23 +77,24 @@
         "default": "./dist/types/index.mjs"
       }
     },
-    "./src": "./src/index.ts"
+    "./src": "./src/index.ts",
+    "./package.json": "./package.json"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
     "access": "public"
   },
   "dependencies": {
-    "type-fest": "^4.39.1"
+    "type-fest": "^4.40.0"
   },
   "devDependencies": {
     "@dagrejs/dagre": "1.1.4",
-    "@mantine/colors-generator": "7.17.4",
+    "@mantine/colors-generator": "8.0.1",
     "@types/natural-compare-lite": "^1.4.2",
     "@types/object-hash": "^3.0.6",
     "chroma-js": "^3.1.2",
     "defu": "^6.1.4",
-    "fdir": "^6.4.3",
+    "fdir": "^6.4.4",
     "graphology": "^0.25.4",
     "graphology-dag": "^0.4.1",
     "graphology-types": "^0.24.8",
@@ -101,15 +102,15 @@
     "natural-compare-lite": "^1.4.0",
     "object-hash": "^3.0.0",
     "obliterator": "^2.0.5",
-    "remeda": "^2.21.2",
-    "turbo": "^2.5.0",
+    "remeda": "^2.21.3",
+    "turbo": "^2.5.2",
     "typescript": "^5.8.3",
     "unbuild": "^3.5.0",
-    "vitest": "^3.1.1",
-    "@likec4/tsconfig": "1.30.0"
+    "vitest": "^3.1.2",
+    "@likec4/tsconfig": "1.31.0"
   },
   "scripts": {
-    "typecheck": "tsc --noEmit",
+    "typecheck": "tsc -b --verbose",
     "build": "unbuild",
     "lint": "run -T eslint src/ --fix",
     "test": "vitest run --no-isolate",

package/src/model/DeploymentElementModel.ts

@@ -211,6 +211,15 @@ abstract class AbstractDeploymentElementModel<M extends AnyAux = AnyAux> {
     )
     return this.cachedIncoming
   }
+
+  public getMetadata(): Record<string, string>
+  public getMetadata(field: string): string | undefined
+  public getMetadata(field?: string) {
+    if (field) {
+      return this.$node.metadata?.[field]
+    }
+    return this.$node.metadata ?? {}
+  }
 }
 
 export class DeploymentNodeModel<M extends AnyAux = AnyAux> extends AbstractDeploymentElementModel<M> {
@@ -560,6 +569,15 @@ export class DeploymentRelationModel<M extends AnyAux = AnyAux> {
   public isDeploymentRelation(): this is DeploymentRelationModel<M> {
     return true
   }
+
+  public getMetadata(): Record<string, string>
+  public getMetadata(field: string): string | undefined
+  public getMetadata(field?: string) {
+    if (field) {
+      return this.$relationship.metadata?.[field]
+    }
+    return this.$relationship.metadata ?? {}
+  }
 }
 
 export class RelationshipsAccum<M extends AnyAux> {

package/src/model/ElementModel.ts

@@ -8,9 +8,9 @@ import {
   type ElementStyle,
   type Link,
   DefaultElementShape,
+  DefaultShapeSize,
   DefaultThemeColor,
 } from '../types/element'
-import { DefaultShapeSize } from '../types/element'
 import {
   type IconUrl,
   type ProjectId,
@@ -258,6 +258,15 @@ export class ElementModel<M extends AnyAux = AnyAux> {
   public deployments(): DeployedInstancesIterator<M> {
     return this.$model.deployment.instancesOf(this)
   }
+
+  public getMetadata(): Record<string, string>
+  public getMetadata(field: string): string | undefined
+  public getMetadata(field?: string) {
+    if (field) {
+      return this.$element.metadata?.[field]
+    }
+    return this.$element.metadata ?? {}
+  }
 }
 
 export function isElementModel<M extends AnyAux = AnyAux>(element: any): element is ElementModel<M> {

package/src/model/RelationModel.ts

@@ -106,4 +106,13 @@ export class RelationshipModel<M extends AnyAux = AnyAux> {
   public isDeploymentRelation(): this is DeploymentRelationModel<M> {
     return false
   }
+
+  public getMetadata(): Record<string, string>
+  public getMetadata(field: string): string | undefined
+  public getMetadata(field?: string) {
+    if (field) {
+      return this.$relationship.metadata?.[field]
+    }
+    return this.$relationship.metadata ?? {}
+  }
 }