@likec4/core 1.42.1 → 1.44.0

package/dist/shared/{core.Dgs6-nuz.d.mts → core.CDOKQTW6.d.mts}

@@ -1,5 +1,5 @@
 import { IfNever, IsNever, IsLiteral } from 'type-fest';
-import { C as Coalesce, L as Link } from './core.D5fzJWbF.mjs';
+import { C as Coalesce, L as Link } from './core.DB0Ue5Wx.mjs';
 import { D as DeploymentFqn$1, F as Fqn$1, d as RelationId$1, N as NodeId$1, j as EdgeId$1, P as ProjectId$1, V as ViewId$1, T as Tag$1, E as ElementKind$1, b as DeploymentKind$1, c as RelationshipKind, M as MarkdownOrString } from './core.DX-WYEPA.mjs';
 
 /**
@@ -31,6 +31,12 @@ type _stage = typeof _stage;
  */
 declare const _type = "_type";
 type _type = typeof _type;
+/**
+ * Property name to store layout type information, used to identify the type of the layout*
+ * @internal
+ */
+declare const _layout = "_layout";
+type _layout = typeof _layout;
 
 /**
  * Specification types (kinds, tags, metadata keys)
@@ -59,7 +65,7 @@ type AnySpec = SpecAux<any, any, any, any, any>;
  * @typeParam Project - Project identifier type
  * @typeParam Spec - Specification types (kinds, tags, metadata keys)
  */
-interface Aux<Stage extends ModelStage, Element extends string, Deployment extends string, View extends string, Project extends string, Spec extends SpecAux<string, string, string, string, string>> {
+interface Aux<Stage extends ModelStage, Element extends string, Deployment extends string, View extends string, Project extends string, Spec extends AnySpec> {
     Stage: Stage;
     ProjectId: Project;
     ElementId: Element;
@@ -71,14 +77,18 @@ interface Aux<Stage extends ModelStage, Element extends string, Deployment exten
     Tag: Spec['Tag'];
     MetadataKey: Spec['MetadataKey'];
 }
-type Any = Aux<any, any, any, any, any, SpecAux<any, any, any, any, any>>;
+type AnyOnStage<Stage extends ModelStage> = Aux<Stage, any, any, any, any, any>;
+type AnyParsed = AnyOnStage<'parsed'>;
+type AnyComputed = AnyOnStage<'computed'>;
+type AnyLayouted = AnyOnStage<'layouted'>;
+type Any = Aux<any, any, any, any, any, any>;
 
 type Never = Aux<never, never, never, never, never, SpecAux<never, never, never, never, never>>;
 /**
  * Fallback when {@link Aux} can't be inferred.
  * By default assumes non parsed model
  */
-type Unknown = Aux<'layouted' | 'computed', string, string, string, string, SpecAux<string, string, string, string, string>>;
+type Unknown = UnknownComputed | UnknownLayouted;
 type UnknownParsed = Aux<'parsed', string, string, string, string, SpecAux<string, string, string, string, string>>;
 type UnknownComputed = Aux<'computed', string, string, string, string, SpecAux<string, string, string, string, string>>;
 type UnknownLayouted = Aux<'layouted', string, string, string, string, SpecAux<string, string, string, string, string>>;
@@ -101,48 +111,48 @@ type toLayouted<A> = A extends Aux<any, infer E, infer D, infer V, infer P, infe
 /**
  * Project identifier from Aux
  */
-type ProjectId<A> = A extends infer T extends Any ? Coalesce<T['ProjectId']> : never;
+type ProjectId<A> = A extends Aux<any, any, any, any, infer P, any> ? Coalesce<P> : never;
 type setProject<A, P extends string> = A extends Aux<infer S, infer E, infer D, infer V, any, infer Spec> ? Aux<S, E, D, V, P, Spec> : never;
 /**
  * Element FQN from Aux as branded type
  */
-type Fqn<A> = A extends infer T extends Any ? Fqn$1<ElementId<T>> : never;
+type Fqn<A> = A extends Any ? Fqn$1<ElementId<A>> : never;
 /**
  * Element FQN from Aux as a literal union
  */
-type ElementId<A> = A extends infer T extends Any ? Coalesce<T['ElementId']> : never;
+type ElementId<A> = A extends Any ? Coalesce<A['ElementId']> : never;
 /**
  * Deployment FQN from Aux as branded type
  */
-type DeploymentFqn<A> = A extends infer T extends Any ? DeploymentFqn$1<DeploymentId<T>> : never;
+type DeploymentFqn<A> = A extends Any ? DeploymentFqn$1<DeploymentId<A>> : never;
 /**
  * Deployment FQN from Aux as a literal union
  * @alias {@link DeploymentFqn}
  */
-type DeploymentId<A> = A extends infer T extends Any ? Coalesce<T['DeploymentId']> : never;
+type DeploymentId<A> = A extends Any ? Coalesce<A['DeploymentId']> : never;
 /**
  * View identifier from Aux as a literal union
  */
-type ViewId<A> = A extends infer T extends Any ? Coalesce<T['ViewId']> : never;
+type ViewId<A> = A extends Any ? Coalesce<A['ViewId']> : never;
 type RelationId = RelationId$1;
 type NodeId = NodeId$1;
 type EdgeId = EdgeId$1;
 /**
  * ElementKind from Aux as a literal union
  */
-type ElementKind<A> = A extends infer T extends Any ? Coalesce<T['ElementKind']> : never;
+type ElementKind<A> = A extends Any ? Coalesce<A['ElementKind']> : never;
 /**
  * DeploymentKind from Aux as a literal union
  */
-type DeploymentKind<A> = A extends infer T extends Any ? Coalesce<T['DeploymentKind']> : never;
+type DeploymentKind<A> = A extends Any ? Coalesce<A['DeploymentKind']> : never;
 /**
  * RelationKind from Aux as a literal union
  */
-type RelationKind<A> = A extends infer T extends Any ? Coalesce<T['RelationKind']> : never;
+type RelationKind<A> = A extends Any ? Coalesce<A['RelationKind']> : never;
 /**
  * Tags from Aux as a literal union
  */
-type Tag<A> = A extends infer T extends Any ? Coalesce<T['Tag']> : never;
+type Tag<A> = A extends Any ? Coalesce<A['Tag']> : never;
 /**
  * Array of tags from Aux
  */
@@ -150,13 +160,13 @@ type Tags<A extends Any> = readonly Tag<A>[];
 /**
  * Metadata key from Aux
  */
-type MetadataKey<A> = A extends infer T extends Any ? Coalesce<T['MetadataKey']> : never;
+type MetadataKey<A> = A extends Any ? Coalesce<A['MetadataKey']> : never;
 /**
  * Metadata object from Aux
  */
 type Metadata<A extends Any> = IsNever<A['MetadataKey']> extends true ? never : IsLiteral<A['MetadataKey']> extends true ? {
-    [key in A['MetadataKey']]?: string;
-} : Record<string, string>;
+    [key in A['MetadataKey']]?: string | string[];
+} : Record<string, string | string[]>;
 /**
  * All known kinds from Aux as a literal union.
  */
@@ -164,7 +174,7 @@ type AllKinds<A> = ElementKind<A> | DeploymentKind<A> | RelationKind<A>;
 /**
  * Specification from Aux
  */
-type Spec<A> = A extends Aux<any, any, any, any, any, infer S> ? S : never;
+type Spec<A> = A extends Aux<any, any, any, any, any, SpecAux<infer E, infer D, infer R, infer T, infer M>> ? SpecAux<E, D, R, T, M> : never;
 type StrictProjectId<A> = A extends infer T extends Any ? ProjectId$1<ProjectId<T>> : never;
 
 type StrictViewId<A> = A extends infer T extends Any ? ViewId$1<ViewId<T>> : never;
@@ -207,19 +217,27 @@ type WithNotation = {
  * @see {@link LiteralUnion} from type-fest (https://github.com/sindresorhus/type-fest/blob/main/source/literal-union.d.ts)
  */
 type OrString = string & Record<never, never>;
-type LooseElementId<A extends Any> = Coalesce<A['ElementId']> | OrString;
-type LooseDeploymentId<A extends Any> = Coalesce<A['DeploymentId']> | OrString;
-type LooseViewId<A extends Any> = Coalesce<A['ViewId']> | OrString;
-type LooseTag<A extends Any> = Coalesce<A['Tag']> | OrString;
-type LooseTags<A extends Any> = readonly (Coalesce<A['Tag']> | OrString)[];
-type LooseElementKind<A extends Any> = Coalesce<A['ElementKind']> | OrString;
-type LooseDeploymentKind<A extends Any> = Coalesce<A['DeploymentKind']> | OrString;
-type LooseRelationKind<A extends Any> = Coalesce<A['RelationKind']> | OrString;
+/**
+ * Allows any string value, but still auto-completes to the possible values in IDE
+ */
+type LooseLiteral<V extends string> = Coalesce<V> | OrString;
+type LooseElementId<A> = A extends Any ? LooseLiteral<A['ElementId']> : string;
+type LooseDeploymentId<A> = A extends Any ? LooseLiteral<A['DeploymentId']> : string;
+type LooseViewId<A> = A extends Any ? LooseLiteral<A['ViewId']> : string;
+type LooseTag<A> = A extends Any ? LooseLiteral<A['Tag']> : string;
+type LooseTags<A> = A extends Any ? readonly (LooseLiteral<A['Tag']>)[] : string[];
+type LooseElementKind<A> = A extends Any ? LooseLiteral<A['ElementKind']> : string;
+type LooseDeploymentKind<A> = A extends Any ? LooseLiteral<A['DeploymentKind']> : string;
+type LooseRelationKind<A> = A extends Any ? LooseLiteral<A['RelationKind']> : string;
 
 type _aux_AllKinds<A> = AllKinds<A>;
 type _aux_Any = Any;
+type _aux_AnyComputed = AnyComputed;
+type _aux_AnyLayouted = AnyLayouted;
+type _aux_AnyOnStage<Stage extends ModelStage> = AnyOnStage<Stage>;
+type _aux_AnyParsed = AnyParsed;
 type _aux_AnySpec = AnySpec;
-type _aux_Aux<Stage extends ModelStage, Element extends string, Deployment extends string, View extends string, Project extends string, Spec extends SpecAux<string, string, string, string, string>> = Aux<Stage, Element, Deployment, View, Project, Spec>;
+type _aux_Aux<Stage extends ModelStage, Element extends string, Deployment extends string, View extends string, Project extends string, Spec extends AnySpec> = Aux<Stage, Element, Deployment, View, Project, Spec>;
 type _aux_DeploymentFqn<A> = DeploymentFqn<A>;
 type _aux_DeploymentId<A> = DeploymentId<A>;
 type _aux_DeploymentKind<A> = DeploymentKind<A>;
@@ -227,14 +245,15 @@ type _aux_EdgeId = EdgeId;
 type _aux_ElementId<A> = ElementId<A>;
 type _aux_ElementKind<A> = ElementKind<A>;
 type _aux_Fqn<A> = Fqn<A>;
-type _aux_LooseDeploymentId<A extends Any> = LooseDeploymentId<A>;
-type _aux_LooseDeploymentKind<A extends Any> = LooseDeploymentKind<A>;
-type _aux_LooseElementId<A extends Any> = LooseElementId<A>;
-type _aux_LooseElementKind<A extends Any> = LooseElementKind<A>;
-type _aux_LooseRelationKind<A extends Any> = LooseRelationKind<A>;
-type _aux_LooseTag<A extends Any> = LooseTag<A>;
-type _aux_LooseTags<A extends Any> = LooseTags<A>;
-type _aux_LooseViewId<A extends Any> = LooseViewId<A>;
+type _aux_LooseDeploymentId<A> = LooseDeploymentId<A>;
+type _aux_LooseDeploymentKind<A> = LooseDeploymentKind<A>;
+type _aux_LooseElementId<A> = LooseElementId<A>;
+type _aux_LooseElementKind<A> = LooseElementKind<A>;
+type _aux_LooseLiteral<V extends string> = LooseLiteral<V>;
+type _aux_LooseRelationKind<A> = LooseRelationKind<A>;
+type _aux_LooseTag<A> = LooseTag<A>;
+type _aux_LooseTags<A> = LooseTags<A>;
+type _aux_LooseViewId<A> = LooseViewId<A>;
 type _aux_Metadata<A extends Any> = Metadata<A>;
 type _aux_MetadataKey<A> = MetadataKey<A>;
 type _aux_Never = Never;
@@ -275,7 +294,7 @@ type _aux_toComputed<A> = toComputed<A>;
 type _aux_toLayouted<A> = toLayouted<A>;
 type _aux_toParsed<A> = toParsed<A>;
 declare namespace _aux {
-  export { type _aux_AllKinds as AllKinds, type _aux_Any as Any, type Any as AnyAux, type _aux_AnySpec as AnySpec, type _aux_Aux as Aux, type _aux_DeploymentFqn as DeploymentFqn, type _aux_DeploymentId as DeploymentId, type _aux_DeploymentKind as DeploymentKind, type _aux_EdgeId as EdgeId, type _aux_ElementId as ElementId, type _aux_ElementKind as ElementKind, type _aux_Fqn as Fqn, type _aux_LooseDeploymentId as LooseDeploymentId, type _aux_LooseDeploymentKind as LooseDeploymentKind, type _aux_LooseElementId as LooseElementId, type _aux_LooseElementKind as LooseElementKind, type _aux_LooseRelationKind as LooseRelationKind, type _aux_LooseTag as LooseTag, type _aux_LooseTags as LooseTags, type _aux_LooseViewId as LooseViewId, type _aux_Metadata as Metadata, type _aux_MetadataKey as MetadataKey, type _aux_Never as Never, type _aux_NodeId as NodeId, type _aux_OrString as OrString, type _aux_PickByStage as PickByStage, type _aux_ProjectId as ProjectId, type _aux_RelationId as RelationId, type _aux_RelationKind as RelationKind, type _aux_Spec as Spec, type _aux_SpecAux as SpecAux, type _aux_Stage as Stage, type DeploymentFqn as StrictDeploymentFqn, type _aux_StrictDeploymentKind as StrictDeploymentKind, type _aux_StrictElementKind as StrictElementKind, type Fqn as StrictFqn, type _aux_StrictProjectId as StrictProjectId, type _aux_StrictRelationKind as StrictRelationKind, type _aux_StrictTag as StrictTag, type _aux_StrictViewId as StrictViewId, type _aux_Tag as Tag, type _aux_Tags as Tags, type _aux_Unknown as Unknown, type _aux_UnknownComputed as UnknownComputed, type _aux_UnknownLayouted as UnknownLayouted, type _aux_UnknownParsed as UnknownParsed, type _aux_ViewId as ViewId, type _aux_WithDescriptionAndTech as WithDescriptionAndTech, type _aux_WithLinks as WithLinks, type _aux_WithMetadata as WithMetadata, type _aux_WithNotation as WithNotation, type _aux_WithOptionalLinks as WithOptionalLinks, type _aux_WithOptionalTags as WithOptionalTags, type _aux_WithTags as WithTags, _aux_preferDescription as preferDescription, _aux_preferSummary as preferSummary, type _aux_setProject as setProject, type _aux_setStage as setStage, type _aux_toComputed as toComputed, type _aux_toLayouted as toLayouted, type _aux_toParsed as toParsed };
+  export { type _aux_AllKinds as AllKinds, type _aux_Any as Any, type Any as AnyAux, type _aux_AnyComputed as AnyComputed, type _aux_AnyLayouted as AnyLayouted, type _aux_AnyOnStage as AnyOnStage, type _aux_AnyParsed as AnyParsed, type _aux_AnySpec as AnySpec, type _aux_Aux as Aux, type _aux_DeploymentFqn as DeploymentFqn, type _aux_DeploymentId as DeploymentId, type _aux_DeploymentKind as DeploymentKind, type _aux_EdgeId as EdgeId, type _aux_ElementId as ElementId, type _aux_ElementKind as ElementKind, type _aux_Fqn as Fqn, type _aux_LooseDeploymentId as LooseDeploymentId, type _aux_LooseDeploymentKind as LooseDeploymentKind, type _aux_LooseElementId as LooseElementId, type _aux_LooseElementKind as LooseElementKind, type _aux_LooseLiteral as LooseLiteral, type _aux_LooseRelationKind as LooseRelationKind, type _aux_LooseTag as LooseTag, type _aux_LooseTags as LooseTags, type _aux_LooseViewId as LooseViewId, type _aux_Metadata as Metadata, type _aux_MetadataKey as MetadataKey, type _aux_Never as Never, type _aux_NodeId as NodeId, type _aux_OrString as OrString, type _aux_PickByStage as PickByStage, type _aux_ProjectId as ProjectId, type _aux_RelationId as RelationId, type _aux_RelationKind as RelationKind, type _aux_Spec as Spec, type _aux_SpecAux as SpecAux, type _aux_Stage as Stage, type DeploymentFqn as StrictDeploymentFqn, type _aux_StrictDeploymentKind as StrictDeploymentKind, type _aux_StrictElementKind as StrictElementKind, type Fqn as StrictFqn, type _aux_StrictProjectId as StrictProjectId, type _aux_StrictRelationKind as StrictRelationKind, type _aux_StrictTag as StrictTag, type _aux_StrictViewId as StrictViewId, type _aux_Tag as Tag, type _aux_Tags as Tags, type _aux_Unknown as Unknown, type _aux_UnknownComputed as UnknownComputed, type _aux_UnknownLayouted as UnknownLayouted, type _aux_UnknownParsed as UnknownParsed, type _aux_ViewId as ViewId, type _aux_WithDescriptionAndTech as WithDescriptionAndTech, type _aux_WithLinks as WithLinks, type _aux_WithMetadata as WithMetadata, type _aux_WithNotation as WithNotation, type _aux_WithOptionalLinks as WithOptionalLinks, type _aux_WithOptionalTags as WithOptionalTags, type _aux_WithTags as WithTags, _aux_preferDescription as preferDescription, _aux_preferSummary as preferSummary, type _aux_setProject as setProject, type _aux_setStage as setStage, type _aux_toComputed as toComputed, type _aux_toLayouted as toLayouted, type _aux_toParsed as toParsed };
 }
 
-export { type StrictProjectId as $, type Any as A, type LooseElementId as B, type LooseDeploymentId as C, type DeploymentId as D, type ExtractOnStage as E, type Fqn as F, type toComputed as G, type toLayouted as H, type Stage as I, type toParsed as J, type LooseViewId as K, type LooseTag as L, type ModelStage as M, type NodeId as N, type setProject as O, type ProjectId as P, type AnySpec as Q, type RelationKind as R, type SpecAux as S, type Tag as T, type Unknown as U, type ViewId as V, type WithDescriptionAndTech as W, type PickByStage as X, type setStage as Y, type Spec as Z, _aux as _, type Aux as a, type StrictTag as a0, type StrictElementKind as a1, type StrictDeploymentKind as a2, type StrictRelationKind as a3, type WithLinks as a4, type OrString as a5, type LooseTags as a6, type LooseElementKind as a7, type LooseDeploymentKind as a8, type LooseRelationKind as a9, type UnknownComputed as b, type UnknownLayouted as c, type UnknownParsed as d, preferSummary as e, _stage as f, _type as g, type StrictViewId as h, isOnStage as i, type ElementKind as j, type ElementId as k, type AllKinds as l, type Tags as m, type WithOptionalTags as n, type WithOptionalLinks as o, preferDescription as p, type WithMetadata as q, type WithNotation as r, type DeploymentFqn as s, type DeploymentKind as t, type MetadataKey as u, type EdgeId as v, type Never as w, type WithTags as x, type Metadata as y, type RelationId as z };
+export { type AnyOnStage as $, type Any as A, type Never as B, type MetadataKey as C, type DeploymentId as D, type ExtractOnStage as E, type Fqn as F, type WithTags as G, type Metadata as H, type LooseTag as I, type RelationId as J, type LooseElementId as K, type LooseLiteral as L, type ModelStage as M, type NodeId as N, type LooseDeploymentId as O, type ProjectId as P, type Stage as Q, type RelationKind as R, type SpecAux as S, type Tag as T, type Unknown as U, type ViewId as V, type WithDescriptionAndTech as W, type LooseViewId as X, type setProject as Y, type AnySpec as Z, _aux as _, type AnyComputed as a, type PickByStage as a0, type setStage as a1, type toParsed as a2, type toLayouted as a3, type Spec as a4, type StrictProjectId as a5, type StrictTag as a6, type StrictElementKind as a7, type StrictDeploymentKind as a8, type StrictRelationKind as a9, type WithLinks as aa, type OrString as ab, type LooseTags as ac, type LooseElementKind as ad, type LooseDeploymentKind as ae, type LooseRelationKind as af, type AnyLayouted as b, type AnyParsed as c, type Aux as d, type UnknownComputed as e, type UnknownLayouted as f, type UnknownParsed as g, preferSummary as h, isOnStage as i, _stage as j, _type as k, _layout as l, type StrictViewId as m, type ElementKind as n, type ElementId as o, preferDescription as p, type AllKinds as q, type Tags as r, type WithOptionalTags as s, type toComputed as t, type WithOptionalLinks as u, type WithMetadata as v, type WithNotation as w, type DeploymentFqn as x, type DeploymentKind as y, type EdgeId as z };

package/dist/shared/{core.BIqHjQiH.mjs → core.CHwVhuc9.mjs}

@@ -1,23 +1,28 @@
-import { c as customInspectSymbol } from './core.B7KhhkRY.mjs';
-import { i as intersection, d as difference, u as union, a as stringHash, e as equals } from './core.C2TiyjI6.mjs';
-import { e as e$1 } from './core.BKlholso.mjs';
+import { c as customInspectSymbol } from './core.C0Ye2OCr.mjs';
+import { i as intersection, d as difference, u as union, a as stringHash, e as equals } from './core.CbsSAn1j.mjs';
 import { t as t$3 } from './core.BsSXS-_R.mjs';
+import { e as e$1 } from './core.BKlholso.mjs';
 import { t as t$2, a as t$4 } from './core.OHD4KXm9.mjs';
-import { q as hierarchyLevel, k as commonAncestor, n as nameFromFqn, d as isSameHierarchy } from './core.DRhg-gVU.mjs';
+import { m as hierarchyLevel, g as commonAncestor, n as nameFromFqn, d as isSameHierarchy } from './core.6VsRBhGY.mjs';
 import { a as nonNullable, i as invariant } from './core.D4npX2q8.mjs';
 import { m as memoizeProp } from './core.BR4zXDH-.mjs';
-import { e as exact, R as RichText } from './core.01VTr9qu.mjs';
-import { a as preferSummary, p as preferDescription } from './core.BazD6cot.mjs';
+import { e as exact, R as RichText } from './core.M9ayqQZa.mjs';
+import { preferSummary, preferDescription } from '../types/_aux.mjs';
+import { i as ihead } from './core.uFk_o9X6.mjs';
 
 function t$1(t,n){let r=n.length-t.length;if(r===1){let[r,...i]=n;return t$2(r,{lazy:t,lazyArgs:i})}if(r===0){let r={lazy:t,lazyArgs:n};return Object.assign(t=>t$2(t,r),r)}throw Error(`Wrong number of arguments`)}
 
 function e(e){return e===``||e===void 0?true:Array.isArray(e)?e.length===0:Object.keys(e).length===0}
 
-function t(...t){return t$3(n$1,t)}const n$1=e=>e.length===1?e[0]:void 0;
+function t(...t){return t$3(n$1,t)}function n$1(e,t){if(e===t||Object.is(e,t))return  true;if(typeof e!=`object`||!e||typeof t!=`object`||!t)return  false;if(e instanceof Map&&t instanceof Map)return r$1(e,t);if(e instanceof Set&&t instanceof Set)return i(e,t);let n=Object.keys(e);if(n.length!==Object.keys(t).length)return  false;for(let r of n){if(!Object.hasOwn(t,r))return  false;let{[r]:n}=e,{[r]:i}=t;if(n!==i||!Object.is(n,i))return  false}return  true}function r$1(e,t){if(e.size!==t.size)return  false;for(let[n,r]of e){let e=t.get(n);if(r!==e||!Object.is(r,e))return  false}return  true}function i(e,t){if(e.size!==t.size)return  false;for(let n of e)if(!t.has(n))return  false;return  true}
 
 function n(...e){return t$1(r,e)}function r(){let t=new Set;return n=>t.has(n)?t$4:(t.add(n),{done:false,hasNext:true,next:n})}
 
 class AbstractDeploymentElementModel {
+  /**
+   * Don't use in runtime, only for type inference
+   */
+  Aux;
   get style() {
     return memoizeProp(this, "style", () => exact({
       shape: this.$model.$styles.defaults.shape,
@@ -241,8 +246,11 @@ class DeploymentNodeModel extends AbstractDeploymentElementModel {
     if (children.size !== 1) {
       return null;
     }
-    const child = t([...children]);
-    return child?.isInstance() ? child : null;
+    const child = ihead(children);
+    if (!child) {
+      return null;
+    }
+    return child.isInstance() ? child : child.onlyOneInstance();
   }
   /**
    * Cached result of relationships from instances
@@ -455,8 +463,26 @@ class DeploymentRelationModel {
   get technology() {
     return this.$relationship.technology ?? null;
   }
+  /**
+   * Returns true if the relationship has a summary and a description
+   * (if one is missing - it falls back to another)
+   */
+  get hasSummary() {
+    return !!this.$relationship.summary && !!this.$relationship.description && !t(this.$relationship.summary, this.$relationship.description);
+  }
+  /**
+   * Short description of the relationship.
+   * Falls back to description if summary is not provided.
+   */
+  get summary() {
+    return RichText.memoize(this, "summary", preferSummary(this.$relationship));
+  }
+  /**
+   * Long description of the relationship.
+   * Falls back to summary if description is not provided.
+   */
   get description() {
-    return RichText.memoize(this, "description", this.$relationship.description);
+    return RichText.memoize(this, "description", preferDescription(this.$relationship));
   }
   get tags() {
     return this.$relationship.tags ?? [];

package/dist/shared/{core.DdMJk7nx.d.mts → core.CKNmSm2W.d.mts}

@@ -1,10 +1,10 @@
-import { IsNever, IsAny } from 'type-fest';
-import { A as Any, U as Unknown, W as WithDescriptionAndTech, n as WithOptionalTags, o as WithOptionalLinks, q as WithMetadata, r as WithNotation, s as DeploymentFqn, t as DeploymentKind, F as Fqn, T as Tag, j as ElementKind, R as RelationKind, u as MetadataKey, f as _stage, g as _type, h as StrictViewId, N as NodeId, v as EdgeId, E as ExtractOnStage, M as ModelStage, P as ProjectId, k as ElementId, D as DeploymentId, d as UnknownParsed, V as ViewId, b as UnknownComputed, c as UnknownLayouted, S as SpecAux, a as Aux, w as Never } from './core.Dgs6-nuz.mjs';
-import { N as NonEmptyArray, L as Link, E as ExclusiveUnion, K as KeysOf } from './core.D5fzJWbF.mjs';
-import { E as ElementStyle, A as AbstractRelationship, y as BaseViewProperties, D as ViewWithHash, C as ViewWithNotation, v as ViewAutoLayout, H as ComputedNode, B as BBox, I as ComputedEdge, P as Point, X as XYPoint, a1 as DynamicViewDisplayVariant, z as BaseParsedViewProperties, l as AnyIncludePredicate, m as AnyExcludePredicate, n as AnyViewRuleStyle, t as ViewRuleAutoLayout, aa as ParsedElementView, a2 as ParsedDynamicView, J as ComputedElementView, K as ComputedDeploymentView, O as ComputedDynamicView, x as ViewType, k as LikeC4Project, f as Element, g as Relationship, M as ModelGlobals } from './core.fHR_8Tnq.mjs';
+import { Simplify, IsAny } from 'type-fest';
+import { A as Any, U as Unknown, W as WithDescriptionAndTech, s as WithOptionalTags, u as WithOptionalLinks, v as WithMetadata, w as WithNotation, x as DeploymentFqn, y as DeploymentKind, F as Fqn, k as _type, j as _stage, l as _layout, N as NodeId, z as EdgeId, m as StrictViewId, E as ExtractOnStage, M as ModelStage, P as ProjectId, o as ElementId, D as DeploymentId, c as AnyParsed, g as UnknownParsed, V as ViewId$1, a as AnyComputed, e as UnknownComputed, b as AnyLayouted, f as UnknownLayouted, S as SpecAux, d as Aux, B as Never } from './core.CDOKQTW6.mjs';
+import { a as NonEmptyReadonlyArray, N as NonEmptyArray, E as ExclusiveUnion, K as KeysOf } from './core.DB0Ue5Wx.mjs';
+import { E as ElementStyle, A as AbstractRelationship, D as ViewType, B as BBox, z as ViewAutoLayout, I as ViewWithNotation, F as BaseViewProperties, J as ViewWithHash, O as ComputedNode, Q as ComputedEdge, P as Point, X as XYPoint, a7 as DynamicViewDisplayVariant, H as BaseParsedViewProperties, p as AnyIncludePredicate, q as AnyExcludePredicate, r as AnyViewRuleStyle, x as ViewRuleAutoLayout, ag as ParsedElementView, a8 as ParsedDynamicView, U as ComputedElementView, W as ComputedDeploymentView, Y as ComputedDynamicView, o as LikeC4Project, S as Specification, f as Element, g as Relationship, M as ModelGlobals } from './core.BMtVqKl7.mjs';
 import { FqnRef } from '../types/fqnRef.mjs';
-import { D as ThemeColor, C as ColorLiteral, u as ElementShape, Q as Color, s as BorderStyle, q as ShapeSize, r as SpacingSize, p as TextSize, v as RelationshipLineType, y as RelationshipArrowType, I as CustomColorDefinitions, E as Expression, F as FqnExpr } from './core.CQngdcuj.mjs';
-import { T as Tag$1, M as MarkdownOrString, I as Icon, d as RelationId } from './core.DX-WYEPA.mjs';
+import { F as Fqn$1, V as ViewId, M as MarkdownOrString, d as RelationId } from './core.DX-WYEPA.mjs';
+import { E as Expression, F as FqnExpr } from './core.BnOetIAR.mjs';
 
 interface DeploymentNode<A extends Any = Unknown> extends WithDescriptionAndTech, WithOptionalTags<A>, WithOptionalLinks, WithMetadata<A>, WithNotation {
     element?: never;
@@ -44,63 +44,31 @@ interface DeploymentRelationship<A extends Any = Unknown> extends AbstractRelati
  */
 type DeploymentRelation<A extends Any = Unknown> = DeploymentRelationship<A>;
 
-/**
- * Element and deployment kind specification
- */
-interface ElementSpecification {
-    tags?: Tag$1[];
-    title?: string;
-    summary?: MarkdownOrString;
-    description?: MarkdownOrString;
-    technology?: string;
-    notation?: string;
-    links?: NonEmptyArray<Link>;
-    style: {
-        shape?: ElementShape;
-        icon?: Icon;
-        color?: Color;
-        border?: BorderStyle;
-        opacity?: number;
-        size?: ShapeSize;
-        padding?: SpacingSize;
-        textSize?: TextSize;
-        multiple?: boolean;
-    };
-}
-interface TagSpecification {
-    color: ThemeColor | ColorLiteral;
-}
-/**
- * Checks if tag color is defined in the specification
- * Expects HEX, `rgb(...)` or `rgba(...)` color
- */
-declare function isTagColorSpecified(spec: string | TagSpecification): spec is {
-    color: ColorLiteral;
+type LayoutedViewDriftReason = 'not-exists' | 'type-changed' | 'nodes-mismatch' | 'edges-mismatch';
+type DiagramNodeDriftReason = 'missing' | 'label-changed' | 'modelRef-changed' | 'parent-changed' | 'children-changed' | 'became-compound' | 'became-leaf' | 'shape-changed';
+type DiagramEdgeDriftReason = 'missing' | 'label-changed' | 'direction-changed' | 'source-changed' | 'target-changed';
+type ViewManualLayoutSnapshotPerType = {
+    readonly [_type]: 'element';
+    readonly viewOf?: Fqn$1;
+    readonly extends?: ViewId;
+} | {
+    readonly [_type]: 'deployment';
+} | {
+    readonly [_type]: 'dynamic';
+    readonly sequenceLayout: LayoutedDynamicView.Sequence.Layout;
 };
-interface RelationshipSpecification {
-    technology?: string;
-    notation?: string;
-    color?: Color;
-    line?: RelationshipLineType;
-    head?: RelationshipArrowType;
-    tail?: RelationshipArrowType;
-}
-type Specification<A> = A extends Any ? {
-    tags: {
-        [key in Tag<A>]: TagSpecification;
-    };
-    elements: {
-        [key in ElementKind<A>]: Partial<ElementSpecification>;
-    };
-    deployments: {
-        [key in DeploymentKind<A>]: Partial<ElementSpecification>;
-    };
-    relationships: {
-        [key in RelationKind<A>]: Partial<RelationshipSpecification>;
-    };
-    metadataKeys?: IsNever<MetadataKey<A>> extends true ? never : MetadataKey<A>[];
-    customColors?: CustomColorDefinitions;
-} : never;
+type ViewManualLayoutSnapshot<Type extends ViewType = ViewType> = Simplify<ViewManualLayoutSnapshotPerType & {
+    readonly id: ViewId;
+    readonly title: string | null;
+    readonly description: MarkdownOrString | null;
+    readonly [_type]: Type;
+    readonly [_stage]: 'layouted';
+    readonly hash: string;
+    readonly nodes: DiagramNode[];
+    readonly edges: DiagramEdge[];
+    readonly bounds: BBox;
+    readonly autoLayout: ViewAutoLayout;
+} & ViewWithNotation>;
 
 interface DiagramNode<A extends Any = Any> extends ComputedNode<A>, BBox {
     /**
@@ -118,6 +86,10 @@ interface DiagramNode<A extends Any = Any> extends ComputedNode<A>, BBox {
      * (Absolute coordinates)
      */
     labelBBox: BBox;
+    /**
+     * List of reasons causing node drift
+     */
+    drifts?: NonEmptyReadonlyArray<DiagramNodeDriftReason> | null;
 }
 interface DiagramEdge<A extends Any = Any> extends ComputedEdge<A> {
     /**
@@ -129,7 +101,7 @@ interface DiagramEdge<A extends Any = Any> extends ComputedEdge<A> {
      * Control points to adjust the edge
      * (Absolute coordinates)
      */
-    controlPoints?: NonEmptyArray<XYPoint>;
+    controlPoints?: NonEmptyArray<XYPoint> | null;
     /**
      * Bounding box of label
      * (Absolute coordinates)
@@ -142,9 +114,23 @@ interface DiagramEdge<A extends Any = Any> extends ComputedEdge<A> {
      * @deprecated
      */
     dotpos?: string;
+    /**
+     * List of reasons causing edge drift
+     */
+    drifts?: NonEmptyReadonlyArray<DiagramEdgeDriftReason> | null;
 }
+/**
+ * Type of the layout
+ * - `auto`: auto-layouted from the current sources
+ * - `manual`: read from the manually layouted snapshot
+ */
+type LayoutType = 'auto' | 'manual';
 interface BaseLayoutedViewProperties<A extends Any> extends BaseViewProperties<A>, ViewWithHash, ViewWithNotation {
     readonly [_stage]: 'layouted';
+    /**
+     * If undefined, view does not have any manual layouts, and is auto-layouted
+     */
+    readonly [_layout]?: LayoutType;
     readonly autoLayout: ViewAutoLayout;
     readonly nodes: DiagramNode<A>[];
     readonly edges: DiagramEdge<A>[];
@@ -152,8 +138,14 @@ interface BaseLayoutedViewProperties<A extends Any> extends BaseViewProperties<A
     /**
      * If diagram has manual layout
      * But was changed and layout should be recalculated
+     * @deprecated manual layout v2 uses {@link drifts}
+     */
+    readonly hasLayoutDrift?: boolean;
+    /**
+     * List of reasons causing layout drift
+     * If undefined or null, there is no layout drift or view is auto-layouted
      */
-    hasLayoutDrift?: boolean;
+    readonly drifts?: NonEmptyReadonlyArray<LayoutedViewDriftReason> | null;
 }
 interface LayoutedElementView<A extends Any = Any> extends BaseLayoutedViewProperties<A> {
     readonly [_type]: 'element';
@@ -166,8 +158,8 @@ interface LayoutedDeploymentView<A extends Any = Any> extends BaseLayoutedViewPr
 interface LayoutedDynamicView<A extends Any = Any> extends BaseLayoutedViewProperties<A> {
     readonly [_type]: 'dynamic';
     /**
-     * How to display the dynamic view
-     * - `diagram`: display as a regular likec4 view
+     * Default variant of this dynamic view
+     * - `diagram`: display as a regular likec4 view (default if not specified)
      * - `sequence`: display as a sequence diagram
      */
     readonly variant: DynamicViewDisplayVariant;
@@ -297,7 +289,16 @@ declare function isExtendsElementView<V extends AnyView<any>>(view: V): view is
 declare function isDeploymentView<V extends AnyView<any>>(view: V): view is ViewWithType<V, 'deployment'>;
 declare function isDynamicView<V extends AnyView<any>>(view: V): view is ViewWithType<V, 'dynamic'>;
 
+/**
+ * Represents a LikeC4 model data, in different stages of processing
+ * - {@link ParsedLikeC4ModelData} - parsed from DSL or result from Builder
+ * - {@link ComputedLikeC4ModelData} - computed from parsed model
+ * - {@link LayoutedLikeC4ModelData} - layouted from computed model
+ *
+ * !IMPORTANT: This is a low-level type, use `LikeC4Model` instead.
+ */
 interface BaseLikeC4ModelData<A extends Any> {
+    [_stage]: A['Stage'];
     projectId: ProjectId<A>;
     project: LikeC4Project;
     specification: Specification<A>;
@@ -311,31 +312,25 @@ interface BaseLikeC4ModelData<A extends Any> {
     imports: Record<string, NonEmptyArray<Element<A>>>;
 }
 type AuxFromLikeC4ModelData<D> = D extends BaseLikeC4ModelData<infer A extends Any> ? IsAny<A> extends true ? never : A : never;
-/**
- * Represents a LikeC4 model with customizable type parameters,
- * parsed from DSL or result from Builder
- *
- * !IMPORTANT: This is a low-level type, use `LikeC4Model` instead.
- * !NOTE: Views are not computed yet.
- *
- * @typeParam ElementKinds - Types of elements in the model (defaults to string)
- * @typeParam RelationKinds - Types of relationships (defaults to string)
- * @typeParam Tags - Types of tags that can be applied (defaults to string)
- * @typeParam Fqns - Fully Qualified Names for elements (defaults to string)
- * @typeParam Views - Types of views in the model (defaults to string)
- * @typeParam DeploymentFqns - Fully Qualified Names for deployment nodes (defaults to string)
- */
-interface ParsedLikeC4ModelData<A extends Any = UnknownParsed> extends BaseLikeC4ModelData<A> {
+interface ParsedLikeC4ModelData<A extends AnyParsed = UnknownParsed> extends BaseLikeC4ModelData<A> {
     [_stage]: 'parsed';
-    views: Record<ViewId<A>, ParsedView<A>>;
+    views: Record<ViewId$1<A>, ParsedView<A>>;
 }
-interface ComputedLikeC4ModelData<A extends Any = UnknownComputed> extends BaseLikeC4ModelData<A> {
+interface ComputedLikeC4ModelData<A extends AnyComputed = UnknownComputed> extends BaseLikeC4ModelData<A> {
     [_stage]: 'computed';
-    views: Record<ViewId<A>, ComputedView<A>>;
+    views: Record<ViewId$1<A>, ComputedView<A>>;
+    /**
+     * If project contains saved manual layouts
+     */
+    manualLayouts?: Record<ViewId, ViewManualLayoutSnapshot>;
 }
-interface LayoutedLikeC4ModelData<A extends Any = UnknownLayouted> extends BaseLikeC4ModelData<A> {
+interface LayoutedLikeC4ModelData<A extends AnyLayouted = UnknownLayouted> extends BaseLikeC4ModelData<A> {
     [_stage]: 'layouted';
-    views: Record<ViewId<A>, LayoutedView<A>>;
+    views: Record<ViewId$1<A>, LayoutedView<A>>;
+    /**
+     * If this model contains saved manual layouts
+     */
+    manualLayouts?: Record<ViewId, ViewManualLayoutSnapshot>;
 }
 type LikeC4ModelData<A extends Any> = ParsedLikeC4ModelData<A> | ComputedLikeC4ModelData<A> | LayoutedLikeC4ModelData<A>;
 
@@ -423,14 +418,15 @@ type RichTextOrEmpty = RichTextNonEmpty | RichTextEmpty;
  * It is used to represent the content of a node or a link.
  */
 declare class RichText {
-    private static _cache;
+    private static getOrCreateFromText;
+    private static getOrCreateFromMarkdown;
     /**
      * Creates and memoizes a RichText instance.
      * @see ElementModel.description
      * @example
      *
      *  get description(): RichTextOrEmpty {
-     *    return RichText.memoize(this, this.$element.description)
+     *    return RichText.memoize(this, 'description', this.$element.description)
      *  }
      */
     static memoize(obj: object, tag: symbol | string, source: MarkdownOrString | null | undefined): RichTextOrEmpty;
@@ -473,4 +469,4 @@ declare class RichText {
     equals(other: unknown): boolean;
 }
 
-export { type DeploymentViewRule as $, type AuxFromLikeC4ModelData as A, isViewRulePredicate as B, type ComputedLikeC4ModelData as C, type DeploymentNode as D, type ElementSpecification as E, isViewRuleStyle as F, isComputedView as G, isElementView as H, isScopedElementView as I, isExtendsElementView as J, isDeploymentView as K, type LayoutedLikeC4ModelData as L, isDynamicView as M, type DiagramNode as N, type DiagramEdge as O, type ParsedLikeC4ModelData as P, type LayoutedElementView as Q, RichText as R, type SpecificationDump as S, type TagSpecification as T, type LayoutedDeploymentView as U, type ViewOnStage as V, LayoutedDynamicView as W, type DeploymentViewIncludePredicate as X, type DeploymentViewExcludePredicate as Y, type DeploymentViewPredicate as Z, type DeploymentViewRuleStyle as _, type RichTextEmpty as a, type ParsedDeploymentView as a0, type RichTextOrEmpty as b, type LikeC4ModelData as c, type DeployedInstance as d, type DeploymentElement as e, type DeploymentElementRef as f, isDeployedInstance as g, type DeploymentRelationship as h, isDeploymentNode as i, type DeploymentRelation as j, type SpecTypesFromDump as k, type LikeC4ModelDump as l, type ProjectDump as m, type AuxFromDump as n, isTagColorSpecified as o, type RelationshipSpecification as p, type Specification as q, type ParsedView as r, type LayoutedView as s, isDiagramView as t, type ComputedView as u, type ProcessedView as v, type AnyView as w, type ViewWithType as x, type ViewRule as y, type ViewRulePredicate as z };
+export { type DeploymentViewRule as $, type AuxFromLikeC4ModelData as A, isElementView as B, type ComputedLikeC4ModelData as C, type DeploymentNode as D, isScopedElementView as E, isExtendsElementView as F, isDeploymentView as G, isDynamicView as H, type DiagramNode as I, type DiagramEdge as J, type LayoutType as K, type LayoutedLikeC4ModelData as L, type LayoutedElementView as M, type LayoutedDeploymentView as N, LayoutedDynamicView as O, type ParsedLikeC4ModelData as P, type LayoutedViewDriftReason as Q, RichText as R, type SpecificationDump as S, type DiagramNodeDriftReason as T, type DiagramEdgeDriftReason as U, type ViewOnStage as V, type ViewManualLayoutSnapshot as W, type DeploymentViewIncludePredicate as X, type DeploymentViewExcludePredicate as Y, type DeploymentViewPredicate as Z, type DeploymentViewRuleStyle as _, type RichTextEmpty as a, type ParsedDeploymentView as a0, type RichTextOrEmpty as b, type LikeC4ModelData as c, type DeployedInstance as d, type DeploymentElement as e, type DeploymentElementRef as f, isDeployedInstance as g, type DeploymentRelationship as h, isDeploymentNode as i, type DeploymentRelation as j, type SpecTypesFromDump as k, type LikeC4ModelDump as l, type ProjectDump as m, type AuxFromDump as n, type ParsedView as o, type LayoutedView as p, isDiagramView as q, type ComputedView as r, type ProcessedView as s, type AnyView as t, type ViewWithType as u, type ViewRule as v, type ViewRulePredicate as w, isViewRulePredicate as x, isViewRuleStyle as y, isComputedView as z };