@likec4/core 1.43.0 → 1.45.0

package/dist/shared/{core.DyToofsP.mjs → core.CRI1AjFj.mjs}

@@ -1,41 +1,34 @@
-import { n as n$4, e as e$4, a as DeploymentNodeModel, b as DeployedInstanceModel, c as DeploymentRelationModel, N as NestedElementOfDeployedInstanceModel } from './core.Be05qJwN.mjs';
-import { t as t$8, a as t$9 } from './core.BsSXS-_R.mjs';
-import { e as e$3 } from './core.BKlholso.mjs';
+import { t as t$3, e as e$2, a as DeploymentNodeModel, b as DeployedInstanceModel, c as DeploymentRelationModel, N as NestedElementOfDeployedInstanceModel } from './core.D_f4F48-.mjs';
+import { e as e$1 } from './core.BKlholso.mjs';
+import { n as n$1 } from './core.BhNcrwzK.mjs';
 import { c as splitGlobalFqn, g as extractStep, e as isStepEdgeId, i as isGroupElementKind, b as isGlobalFqn, a as GlobalFqn } from './core.C_Ni6yHl.mjs';
-import { q as hierarchyLevel, n as nameFromFqn, i as isAncestor, k as commonAncestor, s as sortNaturalByFqn, f as sortParentsFirst, p as parentFqn, a as ancestorsFqn, j as compareNaturalHierarchically, g as compareNatural } from './core.727Qoh_W.mjs';
+import { m as hierarchyLevel, n as nameFromFqn, i as isAncestor, g as commonAncestor, s as sortNaturalByFqn, f as sortParentsFirst, p as parentFqn, a as ancestorsFqn } from './core.CdNCAwq7.mjs';
 import { m as memoizeProp } from './core.BR4zXDH-.mjs';
-import { R as RichText, e as exact } from './core.01VTr9qu.mjs';
-import { a as preferSummary, p as preferDescription } from './core.BazD6cot.mjs';
-import { a as ihead, i as ifind } from './core.QJD_fcrc.mjs';
-import { t as t$a } from './core.OHD4KXm9.mjs';
-import { t as t$b } from './core.CbT8JVYL.mjs';
-import { L as LikeC4Styles } from './core.DNbUPnve.mjs';
+import { R as RichText, e as exact } from './core.M9ayqQZa.mjs';
+import { preferSummary, preferDescription } from '../types/_aux.mjs';
+import { i as ihead } from './core.uFk_o9X6.mjs';
+import { t as t$6, b as compareNaturalHierarchically, c as compareNatural } from './core.3ZhnKAlZ.mjs';
+import { t as t$2, a as t$4 } from './core.BsSXS-_R.mjs';
+import { t as t$5, e as e$3 } from './core.Coi_LOUZ.mjs';
+import { t as t$8 } from './core.CbT8JVYL.mjs';
+import { t as t$7 } from './core.BkVA6gjl.mjs';
+import { c as calcDriftsFromSnapshot, a as applyManualLayout, h as t$9 } from './core.vzLtp8i3.mjs';
+import { L as LikeC4Styles } from './core.DEieYfbG.mjs';
 import { g as getOrCreate } from './core.DcS-0zys.mjs';
-import { i as invariant, a as nonNullable } from './core.D4npX2q8.mjs';
 import { D as DefaultMap } from './core.BbE4y-yl.mjs';
+import { i as invariant, a as nonNullable } from './core.D4npX2q8.mjs';
 import { FqnRef } from '../types/fqnRef.mjs';
-import { b as isDeploymentNode, a as _type, _ as _stage, i as isOnStage, w as whereOperatorAsPredicate } from './core.BYNkXQ8A.mjs';
+import { c as isDeploymentNode, a as _type, _ as _stage, i as isOnStage, w as whereOperatorAsPredicate } from './core.DH7TXqXf.mjs';
+import { i as ifind } from './core.CmPXpJ8l.mjs';
 import { i as ifilter } from './core.DRJma0Ol.mjs';
-import './core.BouyJs63.mjs';
-import './core.2N_9BzyD.mjs';
-
-const e$2={asc:(e,t)=>e>t,desc:(e,t)=>e<t};function t$7(e,t){let[n,...a]=t;if(!i$1(n)){let t=r$1(...a);return e(n,t)}let o=r$1(n,...a);return t=>e(t,o)}function r$1(t,n,...i){let a=typeof t==`function`?t:t[0],o=typeof t==`function`?`asc`:t[1],{[o]:s}=e$2,c=n===void 0?void 0:r$1(n,...i);return (e,t)=>{let n=a(e),r=a(t);return s(n,r)?1:s(r,n)?-1:c?.(e,t)??0}}function i$1(t){if(a(t))return  true;if(typeof t!=`object`||!Array.isArray(t))return  false;let[n,r,...i]=t;return a(n)&&typeof r==`string`&&r in e$2&&i.length===0}const a=e=>typeof e==`function`&&e.length===1;
-
-function t$6(...t){return t$8(Object.entries,t)}
-
-function t$5(...t){return t$8(n$3,t)}function n$3(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(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(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 t$4(...t){return t$8(n$2,t)}const n$2=e=>e.at(-1);
+import './core.DqlrMlsf.mjs';
+import './core.CQPEY2wQ.mjs';
 
-function e$1(e,...n){return typeof e==`string`||typeof e==`number`||typeof e==`symbol`?r=>t$3(r,e,...n):t$3(e,...n)}function t$3(e,...t){let n=e;for(let e of t){if(n==null)return;n=n[e];}return n}
-
-function t$2(...t){return t$8(n$1,t)}function n$1(e,t){let n=[...e];return n.sort(t),n}
-
-function t$1(...t){return t$7(n,t)}const n=(e,t)=>[...e].sort(t);
+function t$1(...t){return t$2(n,t)}const n=e=>e.at(-1);
 
 function e(e,t,n){return typeof t==`number`||t===void 0?n=>n.split(e,t):e.split(t,n)}
 
-function t(...t){return t$8(Object.values,t)}
+function t(...t){return t$2(Object.values,t)}
 
 class ElementModel {
   constructor($model, $element) {
@@ -55,6 +48,10 @@ class ElementModel {
       this.hierarchyLevel = hierarchyLevel(this.id);
     }
   }
+  /**
+   * Don't use in runtime, only for type inference
+   */
+  Aux;
   id;
   _literalId;
   hierarchyLevel;
@@ -83,7 +80,7 @@ class ElementModel {
    */
   get tags() {
     return memoizeProp(this, Symbol.for("tags"), () => {
-      return n$4([
+      return n$1([
         ...this.$element.tags ?? [],
         ...this.$model.specification.elements[this.$element.kind]?.tags ?? []
       ]);
@@ -97,7 +94,7 @@ class ElementModel {
    * (if one is missing - it falls back to another)
    */
   get hasSummary() {
-    return !!this.$element.summary && !!this.$element.description && !t$5(this.$element.summary, this.$element.description);
+    return !!this.$element.summary && !!this.$element.description && !t$3(this.$element.summary, this.$element.description);
   }
   /**
    * Short description of the element.
@@ -265,13 +262,13 @@ class ElementModel {
    * @returns true if the element is deployed
    */
   isDeployed() {
-    return e$3(ihead(this.deployments()));
+    return e$1(ihead(this.deployments()));
   }
   deployments() {
     return this.$model.deployment.instancesOf(this);
   }
   hasMetadata() {
-    return !!this.$element.metadata && !e$4(this.$element.metadata);
+    return !!this.$element.metadata && !e$2(this.$element.metadata);
   }
   getMetadata(field) {
     if (field) {
@@ -290,12 +287,13 @@ class ElementModel {
 const getId = (element) => {
   return typeof element === "string" ? element : element.id;
 };
+
 const VIEW_FOLDERS_SEPARATOR = "/";
 const splitViewTitle = (title) => {
   invariant(!title.includes("\n"), "View title cannot contain newlines");
   if (title.includes(VIEW_FOLDERS_SEPARATOR)) {
     const segments = title.split(VIEW_FOLDERS_SEPARATOR).map((s) => s.trim()).filter((s) => s.length > 0);
-    if (t$9(segments, 1)) {
+    if (t$4(segments, 1)) {
       return segments;
     }
     return [""];
@@ -307,7 +305,7 @@ const normalizeViewPath = (title) => {
 };
 const getViewFolderPath = (title) => {
   const segments = splitViewTitle(title);
-  if (!t$9(segments, 2)) {
+  if (!t$4(segments, 2)) {
     return null;
   }
   return segments.slice(0, -1).join(VIEW_FOLDERS_SEPARATOR);
@@ -649,19 +647,37 @@ class RelationshipModel {
     return `${this.source.id} -> ${this.target.id}`;
   }
   get title() {
-    if (!e$3(this.$relationship.title)) {
+    if (!e$1(this.$relationship.title)) {
       return null;
     }
     return this.$relationship.title;
   }
   get technology() {
-    if (!e$3(this.$relationship.technology)) {
+    if (!e$1(this.$relationship.technology)) {
       return null;
     }
     return this.$relationship.technology;
   }
+  /**
+   * 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$3(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 navigateTo() {
     return this.$relationship.navigateTo ? this.model.view(this.$relationship.navigateTo) : null;
@@ -705,7 +721,7 @@ class RelationshipModel {
     return true;
   }
   hasMetadata() {
-    return !!this.$relationship.metadata && !e$4(this.$relationship.metadata);
+    return !!this.$relationship.metadata && !e$2(this.$relationship.metadata);
   }
   getMetadata(field) {
     if (field) {
@@ -722,72 +738,75 @@ class RelationshipModel {
 }
 
 class EdgeModel {
-  constructor(view, $edge, source, target) {
-    this.view = view;
-    this.$edge = $edge;
+  constructor($viewModel, $edge, source, target) {
     this.source = source;
     this.target = target;
-    this.#edge = $edge;
+    this.$viewModel = $viewModel;
+    this.$view = $viewModel.$view;
+    this.$edge = $edge;
   }
-  #edge;
+  Aux;
+  $viewModel;
+  $view;
+  $edge;
   get id() {
-    return this.#edge.id;
+    return this.$edge.id;
   }
   get parent() {
-    return this.#edge.parent ? this.view.node(this.#edge.parent) : null;
+    return this.$edge.parent ? this.$viewModel.node(this.$edge.parent) : null;
   }
   get label() {
-    return this.#edge.label ?? null;
+    return this.$edge.label ?? null;
   }
   get description() {
-    return RichText.memoize(this, "description", this.#edge.description);
+    return RichText.memoize(this, "description", this.$edge.description);
   }
   get technology() {
-    return this.#edge.technology ?? null;
+    return this.$edge.technology ?? null;
   }
   hasParent() {
-    return this.#edge.parent !== null;
+    return this.$edge.parent !== null;
   }
   get tags() {
-    return this.#edge.tags ?? [];
+    return this.$edge.tags ?? [];
   }
   get stepNumber() {
     return this.isStep() ? extractStep(this.id) : null;
   }
   get navigateTo() {
-    return this.#edge.navigateTo ? this.view.$model.view(this.#edge.navigateTo) : null;
+    return this.$edge.navigateTo ? this.$viewModel.$model.view(this.$edge.navigateTo) : null;
   }
   get color() {
-    return this.#edge.color;
+    return this.$edge.color;
   }
   get line() {
-    return this.#edge.line ?? this.view.$model.$styles.defaults.relationship.line;
+    return this.$edge.line ?? this.$viewModel.$styles.defaults.relationship.line;
   }
   get head() {
-    return this.#edge.head ?? this.view.$model.$styles.defaults.relationship.arrow;
+    return this.$edge.head ?? this.$viewModel.$styles.defaults.relationship.arrow;
   }
   get tail() {
-    return this.#edge.tail;
+    return this.$edge.tail;
   }
   isStep() {
     return isStepEdgeId(this.id);
   }
   *relationships(type) {
-    for (const id of this.#edge.relations) {
+    for (const id of this.$edge.relations) {
       if (type) {
-        const rel = this.view.$model.findRelationship(id, type);
+        const rel = this.$viewModel.$model.findRelationship(id, type);
         if (rel) {
           yield rel;
         }
       } else {
-        yield this.view.$model.relationship(id);
+        yield this.$viewModel.$model.relationship(id);
       }
     }
     return;
   }
   includesRelation(rel) {
     const id = typeof rel === "string" ? rel : rel.id;
-    return this.#edge.relations.includes(id);
+    return this.$edge.relations.includes(id);
   }
   isTagged(tag) {
     return this.tags.includes(tag);
@@ -795,61 +814,76 @@ class EdgeModel {
 }
 
 class NodeModel {
-  constructor($view, $node) {
-    this.$view = $view;
+  Aux;
+  $viewModel;
+  $view;
+  $node;
+  constructor($viewModel, $node) {
+    this.$viewModel = $viewModel;
+    this.$view = $viewModel.$view;
     this.$node = $node;
-    this.#node = $node;
   }
-  #node;
   get id() {
-    return this.#node.id;
+    return this.$node.id;
   }
   get title() {
-    return this.#node.title;
+    return this.$node.title;
   }
   get kind() {
-    return this.#node.kind;
+    return this.$node.kind;
   }
   get description() {
-    return RichText.memoize(this, "description", this.#node.description);
+    return RichText.memoize(this, "description", this.$node.description);
   }
   get technology() {
-    return this.#node.technology ?? null;
+    return this.$node.technology ?? null;
   }
   get parent() {
-    return this.#node.parent ? this.$view.node(this.#node.parent) : null;
+    return this.$node.parent ? this.$viewModel.node(this.$node.parent) : null;
   }
   get element() {
-    const modelRef = this.#node.modelRef;
-    return modelRef ? this.$view.$model.element(modelRef) : null;
+    const modelRef = this.$node.modelRef;
+    return modelRef ? this.$viewModel.$model.element(modelRef) : null;
   }
   get deployment() {
-    const modelRef = this.#node.deploymentRef;
-    return modelRef ? this.$view.$model.deployment.element(modelRef) : null;
+    const modelRef = this.$node.deploymentRef;
+    return modelRef ? this.$viewModel.$model.deployment.element(modelRef) : null;
   }
   get shape() {
-    return this.#node.shape;
+    return this.$node.shape;
   }
   get color() {
-    return this.#node.color;
+    return this.$node.color;
   }
   get icon() {
-    return this.#node.icon ?? null;
+    return this.$node.icon ?? null;
   }
   get tags() {
-    return this.#node.tags;
+    return this.$node.tags;
   }
   get links() {
-    return this.#node.links ?? [];
+    return this.$node.links ?? [];
   }
   get navigateTo() {
-    return this.#node.navigateTo ? this.$view.$model.view(this.#node.navigateTo) : null;
+    return this.$node.navigateTo ? this.$viewModel.$model.view(this.$node.navigateTo) : null;
   }
   get style() {
-    return this.#node.style;
+    return this.$node.style;
+  }
+  get x() {
+    return "x" in this.$node ? this.$node.x : void 0;
+  }
+  get y() {
+    return "y" in this.$node ? this.$node.y : void 0;
+  }
+  get width() {
+    return "width" in this.$node ? this.$node.width : void 0;
+  }
+  get height() {
+    return "height" in this.$node ? this.$node.height : void 0;
   }
   children() {
-    return memoizeProp(this, "children", () => new Set(this.#node.children.map((child) => this.$view.node(child))));
+    return memoizeProp(this, "children", () => new Set(this.$node.children.map((child) => this.$viewModel.node(child))));
   }
   /**
    * Get all ancestor elements (i.e. parent, parent’s parent, etc.)
@@ -864,7 +898,7 @@ class NodeModel {
     return;
   }
   *siblings() {
-    const siblings = this.parent?.children() ?? this.$view.roots();
+    const siblings = this.parent?.children() ?? this.$viewModel.roots();
     for (const sibling of siblings) {
       if (sibling.id !== this.id) {
         yield sibling;
@@ -873,8 +907,8 @@ class NodeModel {
     return;
   }
   *incoming(filter = "all") {
-    for (const edgeId of this.#node.inEdges) {
-      const edge = this.$view.edge(edgeId);
+    for (const edgeId of this.$node.inEdges) {
+      const edge = this.$viewModel.edge(edgeId);
       switch (true) {
         case filter === "all":
         case (filter === "direct" && edge.target.id === this.id):
@@ -897,8 +931,8 @@ class NodeModel {
     return;
   }
   *outgoing(filter = "all") {
-    for (const edgeId of this.#node.outEdges) {
-      const edge = this.$view.edge(edgeId);
+    for (const edgeId of this.$node.outEdges) {
+      const edge = this.$viewModel.edge(edgeId);
       switch (true) {
         case filter === "all":
         case (filter === "direct" && edge.source.id === this.id):
@@ -920,26 +954,26 @@ class NodeModel {
     }
     return;
   }
-  isDiagramNode() {
-    return "width" in this.#node && "height" in this.#node;
+  isLayouted() {
+    return "width" in this.$node && "height" in this.$node;
   }
   hasChildren() {
-    return this.#node.children.length > 0;
+    return this.$node.children.length > 0;
   }
   hasParent() {
-    return this.#node.parent !== null;
+    return this.$node.parent !== null;
   }
   /**
    * Check if this node references to logical model element.
    */
   hasElement() {
-    return e$3(this.#node.modelRef);
+    return e$1(this.$node.modelRef);
   }
   /**
    * Check if this node references to deployment element (Node or Instance).
    */
   hasDeployment() {
-    return e$3(this.#node.deploymentRef);
+    return e$1(this.$node.deploymentRef);
   }
   /**
    * Check if this node references to deployed instance
@@ -949,7 +983,7 @@ class NodeModel {
     return this.hasElement() && this.hasDeployment();
   }
   isGroup() {
-    return isGroupElementKind(this.#node);
+    return isGroupElementKind(this.$node);
   }
   /**
    * Checks if the node has the given tag.
@@ -964,6 +998,7 @@ class LikeC4ViewModel {
    * Don't use in runtime, only for type inference
    */
   Aux;
+  #view;
   #rootnodes = /* @__PURE__ */ new Set();
   #nodes = /* @__PURE__ */ new Map();
   #edges = /* @__PURE__ */ new Map();
@@ -971,8 +1006,15 @@ class LikeC4ViewModel {
   #includeDeployments = /* @__PURE__ */ new Set();
   #includeRelations = /* @__PURE__ */ new Set();
   #allTags = new DefaultMap((_key) => /* @__PURE__ */ new Set());
-  $view;
+  #manualLayoutSnapshot;
+  id;
+  /**
+   * The model this view belongs to
+   */
   $model;
+  /**
+   * The title of the view
+   */
   title;
   /**
    * View folder this view belongs to.
@@ -986,27 +1028,29 @@ class LikeC4ViewModel {
    * "Group 1/Group 2/View"
    */
   viewPath;
-  constructor(model, view, folder) {
+  constructor(model, folder, view, manualLayoutSnapshot) {
     this.$model = model;
-    this.$view = view;
+    this.#view = view;
+    this.id = view.id;
     this.folder = folder;
-    for (const node of view.nodes) {
+    this.#manualLayoutSnapshot = manualLayoutSnapshot;
+    for (const node of this.#view.nodes) {
       const el = new NodeModel(this, Object.freeze(node));
       this.#nodes.set(node.id, el);
       if (!node.parent) {
         this.#rootnodes.add(el);
       }
-      if (el.hasDeployment()) {
-        this.#includeDeployments.add(el.deployment.id);
+      if (node.deploymentRef) {
+        this.#includeDeployments.add(node.deploymentRef);
       }
-      if (el.hasElement()) {
-        this.#includeElements.add(el.element.id);
+      if (node.modelRef) {
+        this.#includeElements.add(node.modelRef);
       }
       for (const tag of el.tags) {
         this.#allTags.get(tag).add(el);
       }
     }
-    for (const edge of view.edges) {
+    for (const edge of this.#view.edges) {
       const edgeModel = new EdgeModel(
         this,
         Object.freeze(edge),
@@ -1021,14 +1065,29 @@ class LikeC4ViewModel {
       }
       this.#edges.set(edge.id, edgeModel);
     }
-    this.title = this.$view.title ? extractViewTitleFromPath(this.$view.title) : null;
-    this.viewPath = this.$view.title ? normalizeViewPath(this.$view.title) : this.$view.id;
+    this.title = view.title ? extractViewTitleFromPath(view.title) : null;
+    this.viewPath = view.title ? normalizeViewPath(view.title) : view.id;
+  }
+  /**
+   * Returns the styles configuration for the project.
+   */
+  get $styles() {
+    return this.$model.$styles;
   }
   get _type() {
-    return this.$view[_type];
+    return this.#view[_type];
   }
-  get id() {
-    return this.$view.id;
+  get stage() {
+    return this.#view[_stage];
+  }
+  get bounds() {
+    if ("bounds" in this.#view) {
+      return this.#view.bounds;
+    }
+    if (this.#manualLayoutSnapshot) {
+      return this.#manualLayoutSnapshot.bounds;
+    }
+    throw new Error("View is not layouted");
   }
   /**
    * Returns title if defined, otherwise returns title of the element it is based on, otherwise returns its {@link id}
@@ -1064,17 +1123,17 @@ class LikeC4ViewModel {
     });
   }
   get description() {
-    return RichText.memoize(this, "description", this.$view.description);
+    return RichText.memoize(this, "description", this.#view.description);
   }
   get tags() {
-    return this.$view.tags ?? [];
+    return this.#view.tags ?? [];
   }
   get links() {
-    return this.$view.links ?? [];
+    return this.#view.links ?? [];
   }
   get viewOf() {
     if (this.isElementView()) {
-      const viewOf = this.$view.viewOf;
+      const viewOf = this.#view.viewOf;
       return viewOf ? this.$model.element(viewOf) : null;
     }
     return null;
@@ -1085,9 +1144,9 @@ class LikeC4ViewModel {
    */
   get mode() {
     if (this.isDynamicView()) {
-      return this.$view.variant ?? "diagram";
+      return this.#view.variant ?? "diagram";
     }
-    throw new Error("View is not dynamic");
+    return null;
   }
   /**
    * All tags from nodes and edges.
@@ -1095,6 +1154,58 @@ class LikeC4ViewModel {
   get includedTags() {
     return [...this.#allTags.keys()];
   }
+  /**
+   * The original view from the model.
+   * In case of layouted model, this is the latest auto-layouted view without manual changes applied
+   * @see {@link $layouted} should be used for rendering in the UI
+   */
+  get $view() {
+    if (!this.isLayouted() || "drifts" in this.#view) {
+      return this.#view;
+    }
+    const snapshot = this.#manualLayoutSnapshot;
+    if (snapshot) {
+      return memoizeProp(this, "withDriftReasons", () => {
+        return calcDriftsFromSnapshot(this.#view, snapshot);
+      });
+    }
+    return this.#view;
+  }
+  /**
+   * Returns the view with manual layout applied if it exists, otherwise returns the original view
+   * This should be used for rendering in the UI
+   */
+  get $layouted() {
+    if (!this.isLayouted()) {
+      throw new Error("View is not layouted");
+    }
+    return this.$manual ?? this.#view;
+  }
+  get hasManualLayout() {
+    return this.#manualLayoutSnapshot !== void 0;
+  }
+  get hasLayoutDrifts() {
+    if (!this.isLayouted()) {
+      return false;
+    }
+    const manualLayout = this.$manual;
+    return !!manualLayout?.drifts && manualLayout.drifts.length > 0;
+  }
+  /**
+   * If view has manual layout, returns it with manual layout applied
+   */
+  get $manual() {
+    if (!this.isLayouted()) {
+      return null;
+    }
+    const snapshot = this.#manualLayoutSnapshot;
+    if (snapshot) {
+      return memoizeProp(this, "snapshotWithManualLayout", () => {
+        return applyManualLayout(this.#view, snapshot);
+      });
+    }
+    return null;
+  }
   roots() {
     return this.#rootnodes.values();
   }
@@ -1115,7 +1226,7 @@ class LikeC4ViewModel {
    */
   node(node) {
     const nodeId = getId(node);
-    return nonNullable(this.#nodes.get(nodeId), `Node ${nodeId} not found in view ${this.$view.id}`);
+    return nonNullable(this.#nodes.get(nodeId), `Node ${nodeId} not found in view ${this.#view.id}`);
   }
   /**
    * Find node by id.
@@ -1125,6 +1236,9 @@ class LikeC4ViewModel {
   }
   findNodeWithElement(element) {
     const id = getId(element);
+    if (!this.#includeElements.has(id)) {
+      return null;
+    }
     return ifind(
       this.#nodes.values(),
       (node) => node.hasElement() && node.element.id === id
@@ -1145,7 +1259,7 @@ class LikeC4ViewModel {
    */
   edge(edge) {
     const edgeId = getId(edge);
-    return nonNullable(this.#edges.get(edgeId), `Edge ${edgeId} not found in view ${this.$view.id}`);
+    return nonNullable(this.#edges.get(edgeId), `Edge ${edgeId} not found in view ${this.#view.id}`);
   }
   /**
    * Find edge by id.
@@ -1202,22 +1316,28 @@ class LikeC4ViewModel {
    * Below are type guards.
    */
   isComputed() {
-    return this.$view[_stage] === "computed";
+    return this.#view[_stage] === "computed";
+  }
+  isLayouted() {
+    return this.#view[_stage] === "layouted";
   }
+  /**
+   * @deprecated Use {@link isLayouted} instead
+   */
   isDiagram() {
-    return this.$view[_stage] === "layouted";
+    return this.#view[_stage] === "layouted";
   }
   isElementView() {
-    return this.$view[_type] === "element";
+    return this.#view[_type] === "element";
   }
   isScopedElementView() {
-    return this.$view[_type] === "element" && e$3(this.$view.viewOf);
+    return this.#view[_type] === "element" && e$1(this.#view.viewOf);
   }
   isDeploymentView() {
-    return this.$view[_type] === "deployment";
+    return this.#view[_type] === "deployment";
   }
   isDynamicView() {
-    return this.$view[_type] === "dynamic";
+    return this.#view[_type] === "dynamic";
   }
 }
 
@@ -1253,7 +1373,7 @@ class LikeC4ViewsFolder {
     this.$model = $model;
     this.path = path.join("/");
     this.isRoot = this.path === "";
-    this.title = t$4(path);
+    this.title = t$1(path);
     if (this.isRoot) {
       this.parentPath = void 0;
     } else {
@@ -1308,7 +1428,7 @@ class LikeC4ViewsFolder {
    */
   get parent() {
     invariant(!this.isRoot, "Root view folder has no parent");
-    if (e$4(this.parentPath)) {
+    if (e$2(this.parentPath)) {
       return null;
     }
     return this.$model.viewFolder(this.parentPath);
@@ -1372,14 +1492,10 @@ class LikeC4Model {
   _views = /* @__PURE__ */ new Map();
   _rootViewFolder;
   _viewFolders = /* @__PURE__ */ new Map();
-  _viewFolderItems = new DefaultMap(
-    () => /* @__PURE__ */ new Set()
-  );
-  _allTags = new DefaultMap(
-    () => /* @__PURE__ */ new Set()
-  );
+  _viewFolderItems = new DefaultMap(() => /* @__PURE__ */ new Set());
+  _allTags = new DefaultMap(() => /* @__PURE__ */ new Set());
   static fromParsed(model) {
-    return new LikeC4Model(model).asParsed;
+    return new LikeC4Model(model);
   }
   static create(model) {
     return new LikeC4Model(model);
@@ -1429,13 +1545,13 @@ class LikeC4Model {
   $data;
   constructor($data) {
     this.$data = $data;
-    for (const [, element] of t$6($data.elements)) {
+    for (const [, element] of t$5($data.elements)) {
       const el = this.addElement(element);
       for (const tag of el.tags) {
         this._allTags.get(tag).add(el);
       }
     }
-    for (const [projectId, elements] of t$6($data.imports ?? {})) {
+    for (const [projectId, elements] of t$5($data.imports ?? {})) {
       for (const element of sortParentsFirst(elements)) {
         const el = this.addImportedElement(projectId, element);
         for (const tag of el.tags) {
@@ -1452,21 +1568,21 @@ class LikeC4Model {
     this.deployment = new LikeC4DeploymentModel(this);
     if (isOnStage($data, "computed") || isOnStage($data, "layouted")) {
       const compare = compareNaturalHierarchically(VIEW_FOLDERS_SEPARATOR);
-      const views = t$a(
+      const views = t$6(
         t($data.views),
-        t$b((view) => ({
+        t$8((view) => ({
           view,
           path: normalizeViewPath(view.title ?? view.id),
           folderPath: view.title && getViewFolderPath(view.title) || ""
         })),
         // Sort hierarchically by groups, but keep same order within groups
-        t$2((a, b) => compare(a.folderPath, b.folderPath))
+        t$7((a, b) => compare(a.folderPath, b.folderPath))
       );
       const getOrCreateFolder = (path) => {
         let folder = this._viewFolders.get(path);
         if (!folder) {
           const segments = e(path, VIEW_FOLDERS_SEPARATOR);
-          invariant(t$9(segments, 1), `View group path "${path}" must have at least one element`);
+          invariant(t$4(segments, 1), `View group path "${path}" must have at least one element`);
           let defaultView;
           if (path === "") {
             defaultView = views.find((view) => view.view.id === "index");
@@ -1485,7 +1601,7 @@ class LikeC4Model {
         }
         e(folderPath, VIEW_FOLDERS_SEPARATOR).reduce((segments, segment) => {
           const parent = segments.join(VIEW_FOLDERS_SEPARATOR);
-          const path = e$4(parent) ? segment : parent + VIEW_FOLDERS_SEPARATOR + segment;
+          const path = e$2(parent) ? segment : parent + VIEW_FOLDERS_SEPARATOR + segment;
           const folder = getOrCreateFolder(path);
           this._viewFolderItems.get(parent).add(folder);
           segments.push(segment);
@@ -1493,7 +1609,12 @@ class LikeC4Model {
         }, []);
       }
       for (const { view, folderPath } of views) {
-        const vm = new LikeC4ViewModel(this, view, getOrCreateFolder(folderPath));
+        const vm = new LikeC4ViewModel(
+          this,
+          getOrCreateFolder(folderPath),
+          view,
+          $data.manualLayouts?.[view.id]
+        );
         this._viewFolderItems.get(folderPath).add(vm);
         this._views.set(view.id, vm);
         for (const tag of vm.tags) {
@@ -1709,6 +1830,16 @@ class LikeC4Model {
   findView(viewId) {
     return this._views.get(viewId) ?? null;
   }
+  /**
+   * Returns manual layout snapshot for given view ID, if any.
+   */
+  findManualLayout(viewId) {
+    if ("manualLayouts" in this.$data) {
+      const view = this.$data.manualLayouts?.[viewId];
+      return view ?? null;
+    }
+    return null;
+  }
   /**
    * Returns a view folder by its path.
    * Path is extracted from the view title, e.g. "Group 1/Group 2/View" -> "Group 1/Group 2"
@@ -1832,22 +1963,22 @@ class LikeC4Model {
    * Use {@link specification.tags} to get all defined tags
    */
   get tags() {
-    return memoizeProp(this, "tags", () => t$2([...this._allTags.keys()], compareNatural));
+    return memoizeProp(this, "tags", () => t$7([...this._allTags.keys()], compareNatural));
   }
   /**
    * Returns all tags used in the model, sorted by usage count (descending).
    */
   get tagsSortedByUsage() {
-    return memoizeProp(this, "tagsSortedByUsage", () => t$a(
+    return memoizeProp(this, "tagsSortedByUsage", () => t$6(
       [...this._allTags.entries()],
-      t$b(([tag, tagged]) => ({
+      t$8(([tag, tagged]) => ({
         tag,
         count: tagged.size,
         tagged
       })),
-      t$2((a, b) => compareNatural(a.tag, b.tag)),
-      t$1(
-        [e$1("count"), "desc"]
+      t$7((a, b) => compareNatural(a.tag, b.tag)),
+      t$9(
+        [e$3("count"), "desc"]
       )
     ));
   }
@@ -2063,4 +2194,4 @@ function isEdgeModel(edge) {
   return edge instanceof EdgeModel;
 }
 
-export { ElementModel as E, LikeC4Model as L, NodeModel as N, RelationshipModel as R, VIEW_FOLDERS_SEPARATOR as V, t$6 as a, t$1 as b, t$4 as c, isNestedElementOfDeployedInstanceModel as d, e$1 as e, isDeployedInstanceModel as f, isDeploymentNodeModel as g, isDeploymentElementModel as h, isElementModel as i, LikeC4DeploymentModel as j, EdgeModel as k, LikeC4ViewModel as l, LikeC4ViewsFolder as m, extractViewTitleFromPath as n, getViewFolderPath as o, normalizeViewPath as p, isDeploymentRelationModel as q, isRelationModel as r, isLikeC4ViewModel as s, t, isNodeModel as u, isEdgeModel as v };
+export { ElementModel as E, LikeC4Model as L, NodeModel as N, RelationshipModel as R, VIEW_FOLDERS_SEPARATOR as V, t$1 as a, isNestedElementOfDeployedInstanceModel as b, isDeployedInstanceModel as c, isDeploymentNodeModel as d, isDeploymentElementModel as e, LikeC4DeploymentModel as f, EdgeModel as g, LikeC4ViewModel as h, isElementModel as i, LikeC4ViewsFolder as j, extractViewTitleFromPath as k, getViewFolderPath as l, isDeploymentRelationModel as m, normalizeViewPath as n, isRelationModel as o, isLikeC4ViewModel as p, isNodeModel as q, isEdgeModel as r, t };