@likec4/core 1.34.2 → 1.36.0

package/dist/types/_aux.d.mts

@@ -1,4 +1,4 @@
 import 'type-fest';
 import '../shared/core.DuSLYTG6.mjs';
-export { x as AllKinds, A as Any, A as AnyAux, C as AnySpec, a as Aux, p as DeploymentFqn, s as DeploymentId, D as DeploymentKind, B as EdgeId, g as ElementId, k as ElementKind, F as Fqn, o as LooseDeploymentId, a3 as LooseDeploymentKind, n as LooseElementId, a2 as LooseElementKind, a4 as LooseRelationKind, L as LooseTag, a1 as LooseTags, w as LooseViewId, h as Metadata, j as MetadataKey, N as Never, I as NodeId, a0 as OrString, G as PickByStage, P as ProjectId, l as RelationId, R as RelationKind, J as Spec, S as SpecAux, r as Stage, p as StrictDeploymentFqn, X as StrictDeploymentKind, Q as StrictElementKind, F as StrictFqn, K as StrictProjectId, Y as StrictRelationKind, O as StrictTag, m as StrictViewId, u as Tag, T as Tags, U as Unknown, b as UnknownComputed, c as UnknownLayouted, d as UnknownParsed, V as ViewId, $ as WithLinks, z as WithMetadata, y as WithOptionalLinks, W as WithOptionalTags, Z as WithTags, H as setStage, t as toComputed, q as toLayouted, v as toParsed } from '../shared/core.DAj3LuFH.mjs';
+export { y as AllKinds, A as Any, A as AnyAux, G as AnySpec, a as Aux, p as DeploymentFqn, s as DeploymentId, D as DeploymentKind, C as EdgeId, g as ElementId, k as ElementKind, F as Fqn, o as LooseDeploymentId, a4 as LooseDeploymentKind, n as LooseElementId, a3 as LooseElementKind, a5 as LooseRelationKind, L as LooseTag, a2 as LooseTags, w as LooseViewId, h as Metadata, j as MetadataKey, N as Never, J as NodeId, a1 as OrString, H as PickByStage, P as ProjectId, l as RelationId, R as RelationKind, K as Spec, S as SpecAux, r as Stage, p as StrictDeploymentFqn, Y as StrictDeploymentKind, X as StrictElementKind, F as StrictFqn, O as StrictProjectId, Z as StrictRelationKind, Q as StrictTag, m as StrictViewId, u as Tag, T as Tags, U as Unknown, b as UnknownComputed, c as UnknownLayouted, d as UnknownParsed, V as ViewId, a0 as WithLinks, B as WithMetadata, z as WithOptionalLinks, W as WithOptionalTags, $ as WithTags, x as setProject, I as setStage, t as toComputed, q as toLayouted, v as toParsed } from '../shared/core.BFb3p5d-.mjs';
 import '../shared/core.668kXpZq.mjs';

package/dist/types/index.d.mts

@@ -1,8 +1,8 @@
 import { N as NonEmptyArray } from '../shared/core.DuSLYTG6.mjs';
 export { C as Coalesce, E as ExclusiveUnion, I as IteratorLike, K as KeysOf, L as Link, b as NTuple, a as NonEmptyReadonlyArray, P as Predicate } from '../shared/core.DuSLYTG6.mjs';
-export { A as Any, A as AnyAux, a as Aux, E as ExtractOnStage, M as ModelStage, S as SpecAux, U as Unknown, b as UnknownComputed, c as UnknownLayouted, d as UnknownParsed, e as _stage, f as _type, _ as aux, i as isOnStage } from '../shared/core.DAj3LuFH.mjs';
-import { aP as ViewManualLayout, aK as AutoLayoutDirection } from '../shared/core.IWLie-Ma.mjs';
-export { W as AbstractRelationship, ad as AndOperator, aE as AnyExcludePredicate, aD as AnyIncludePredicate, aq as AnyView, aF as AnyViewRuleStyle, z as AuxFromDump, A as AuxFromLikeC4ModelData, B as BBox, aS as BaseParsedViewProperties, aR as BaseViewProperties, aZ as ComputedDeploymentView, a_ as ComputedDynamicView, aX as ComputedEdge, aY as ComputedElementView, C as ComputedLikeC4ModelData, aW as ComputedNode, ao as ComputedView, U as DefaultArrowType, I as DefaultElementShape, T as DefaultLineStyle, K as DefaultPaddingSize, V as DefaultRelationshipColor, J as DefaultShapeSize, N as DefaultTextSize, H as DefaultThemeColor, q as DeployedInstance, r as DeploymentElement, s as DeploymentElementRef, D as DeploymentElementStyle, p as DeploymentNode, w as DeploymentRelation, v as DeploymentRelationship, b5 as DeploymentViewExcludePredicate, b4 as DeploymentViewIncludePredicate, b6 as DeploymentViewPredicate, b8 as DeploymentViewRule, b7 as DeploymentViewRuleStyle, b0 as DiagramEdge, a$ as DiagramNode, am as DiagramView, be as DynamicViewIncludeRule, bb as DynamicViewParallelSteps, bf as DynamicViewRule, ba as DynamicViewStep, bd as DynamicViewStepOrParallel, Q as Element, _ as ElementSpecification, O as ElementStyle, bj as ElementViewExcludePredicate, bi as ElementViewIncludePredicate, bk as ElementViewPredicate, bo as ElementViewRule, bl as ElementViewRuleGroup, bn as ElementViewRuleStyle, a3 as EqualOperator, E as Expression, ai as Filterable, F as FqnExpr, f as FqnRef, j as GlobalDynamicPredicates, G as GlobalPredicateId, i as GlobalPredicates, k as GlobalStyleID, l as GlobalStyles, a6 as KindEqual, b2 as LayoutedDeploymentView, b3 as LayoutedDynamicView, b1 as LayoutedElementView, L as LayoutedLikeC4ModelData, am as LayoutedView, o as LikeC4ModelData, y as LikeC4ModelDump, al as LikeC4View, e as ModelExpression, M as ModelFqnExpr, m as ModelGlobals, Z as ModelRelation, d as ModelRelationExpr, aT as NodeNotation, ab as NotOperator, aj as OperatorPredicate, af as OrOperator, b9 as ParsedDeploymentView, bg as ParsedDynamicView, bp as ParsedElementView, n as ParsedLikeC4ModelData, al as ParsedView, a8 as Participant, a9 as ParticipantOperator, g as Point, P as PredicateSelector, ap as ProcessedView, h as RectBox, c as RelationExpr, Y as Relationship, a1 as RelationshipSpecification, R as RichText, a as RichTextEmpty, b as RichTextOrEmpty, x as SpecTypesFromDump, a2 as Specification, S as SpecificationDump, a4 as TagEqual, $ as TagSpecification, aO as ViewAutoLayout, ar as ViewOnStage, at as ViewRule, aM as ViewRuleAutoLayout, aI as ViewRuleGlobalPredicateRef, aG as ViewRuleGlobalStyle, au as ViewRulePredicate, aQ as ViewType, aV as ViewWithHash, aU as ViewWithNotation, as as ViewWithType, ah as WhereOperator, X as XYPoint, bc as getParallelStepsPrefix, ae as isAndOperator, aL as isAutoLayoutDirection, ax as isComputedView, u as isDeployedInstance, t as isDeploymentNode, aB as isDeploymentView, an as isDiagramView, aC as isDynamicView, bh as isDynamicViewParallelSteps, ay as isElementView, aA as isExtendsElementView, a7 as isKindEqual, an as isLayoutedView, ac as isNotOperator, ag as isOrOperator, aa as isParticipantOperator, az as isScopedElementView, a0 as isTagColorSpecified, a5 as isTagEqual, aN as isViewRuleAutoLayout, aJ as isViewRuleGlobalPredicateRef, aH as isViewRuleGlobalStyle, bm as isViewRuleGroup, av as isViewRulePredicate, aw as isViewRuleStyle, ak as whereOperatorAsPredicate } from '../shared/core.IWLie-Ma.mjs';
+export { A as Any, A as AnyAux, a as Aux, E as ExtractOnStage, M as ModelStage, S as SpecAux, U as Unknown, b as UnknownComputed, c as UnknownLayouted, d as UnknownParsed, e as _stage, f as _type, _ as aux, i as isOnStage } from '../shared/core.BFb3p5d-.mjs';
+import { aR as ViewManualLayout, aM as AutoLayoutDirection } from '../shared/core.DxDn5nB5.mjs';
+export { Y as AbstractRelationship, ae as AndOperator, aG as AnyExcludePredicate, aF as AnyIncludePredicate, as as AnyView, aH as AnyViewRuleStyle, H as AuxFromDump, A as AuxFromLikeC4ModelData, B as BBox, aU as BaseParsedViewProperties, aT as BaseViewProperties, a$ as ComputedDeploymentView, b0 as ComputedDynamicView, aZ as ComputedEdge, a_ as ComputedElementView, C as ComputedLikeC4ModelData, aY as ComputedNode, aq as ComputedView, V as DefaultArrowType, J as DefaultElementShape, U as DefaultLineStyle, N as DefaultPaddingSize, W as DefaultRelationshipColor, K as DefaultShapeSize, O as DefaultTextSize, I as DefaultThemeColor, q as DeployedInstance, r as DeploymentElement, s as DeploymentElementRef, D as DeploymentElementStyle, p as DeploymentNode, w as DeploymentRelation, v as DeploymentRelationship, b7 as DeploymentViewExcludePredicate, b6 as DeploymentViewIncludePredicate, b8 as DeploymentViewPredicate, ba as DeploymentViewRule, b9 as DeploymentViewRuleStyle, b2 as DiagramEdge, b1 as DiagramNode, ao as DiagramView, bg as DynamicViewIncludeRule, bd as DynamicViewParallelSteps, bh as DynamicViewRule, bc as DynamicViewStep, bf as DynamicViewStepOrParallel, T as Element, $ as ElementSpecification, Q as ElementStyle, bl as ElementViewExcludePredicate, bk as ElementViewIncludePredicate, bm as ElementViewPredicate, bq as ElementViewRule, bn as ElementViewRuleGroup, bp as ElementViewRuleStyle, a4 as EqualOperator, E as Expression, aj as Filterable, F as FqnExpr, f as FqnRef, j as GlobalDynamicPredicates, G as GlobalPredicateId, i as GlobalPredicates, k as GlobalStyleID, l as GlobalStyles, a7 as KindEqual, b4 as LayoutedDeploymentView, b5 as LayoutedDynamicView, b3 as LayoutedElementView, L as LayoutedLikeC4ModelData, ao as LayoutedView, o as LikeC4ModelData, y as LikeC4ModelDump, am as LikeC4Project, an as LikeC4View, e as ModelExpression, M as ModelFqnExpr, m as ModelGlobals, _ as ModelRelation, d as ModelRelationExpr, aV as NodeNotation, ac as NotOperator, ak as OperatorPredicate, ag as OrOperator, bb as ParsedDeploymentView, bi as ParsedDynamicView, br as ParsedElementView, n as ParsedLikeC4ModelData, an as ParsedView, a9 as Participant, aa as ParticipantOperator, g as Point, P as PredicateSelector, ar as ProcessedView, z as ProjectDump, h as RectBox, c as RelationExpr, Z as Relationship, a2 as RelationshipSpecification, R as RichText, a as RichTextEmpty, b as RichTextOrEmpty, x as SpecTypesFromDump, a3 as Specification, S as SpecificationDump, a5 as TagEqual, a0 as TagSpecification, aQ as ViewAutoLayout, at as ViewOnStage, av as ViewRule, aO as ViewRuleAutoLayout, aK as ViewRuleGlobalPredicateRef, aI as ViewRuleGlobalStyle, aw as ViewRulePredicate, aS as ViewType, aX as ViewWithHash, aW as ViewWithNotation, au as ViewWithType, ai as WhereOperator, X as XYPoint, be as getParallelStepsPrefix, af as isAndOperator, aN as isAutoLayoutDirection, az as isComputedView, u as isDeployedInstance, t as isDeploymentNode, aD as isDeploymentView, ap as isDiagramView, aE as isDynamicView, bj as isDynamicViewParallelSteps, aA as isElementView, aC as isExtendsElementView, a8 as isKindEqual, ap as isLayoutedView, ad as isNotOperator, ah as isOrOperator, ab as isParticipantOperator, aB as isScopedElementView, a1 as isTagColorSpecified, a6 as isTagEqual, aP as isViewRuleAutoLayout, aL as isViewRuleGlobalPredicateRef, aJ as isViewRuleGlobalStyle, bo as isViewRuleGroup, ax as isViewRulePredicate, ay as isViewRuleStyle, al as whereOperatorAsPredicate } from '../shared/core.DxDn5nB5.mjs';
 import { F as Fqn, D as DeploymentFqn } from '../shared/core.668kXpZq.mjs';
 export { A as AnyFqn, B as BuiltInIcon, b as DeploymentKind, j as EdgeId, E as ElementKind, e as GlobalFqn, G as GroupElementKind, I as Icon, a as IconUrl, M as MarkdownOrString, N as NodeId, P as ProjectId, d as RelationId, R as RelationKind, c as RelationshipKind, k as StepEdgeId, S as StepEdgeIdLiteral, m as StepEdgeKind, T as Tag, V as ViewId, o as extractStep, f as flattenMarkdownOrString, g as isGlobalFqn, i as isGroupElementKind, n as isStepEdgeId, s as scalar, h as splitGlobalFqn, l as stepEdgeId } from '../shared/core.668kXpZq.mjs';
 import { b as BorderStyle, c as ElementShape, h as ThemeColor } from '../shared/core.CzdwsPmY.mjs';

package/dist/types/index.mjs

@@ -1,11 +1,13 @@
-export { D as DeploymentFqn, E as EdgeId, l as Fqn, F as FqnRef, n as GlobalFqn, G as GroupElementKind, N as NodeId, R as RelationId, S as StepEdgeKind, V as ViewId, _ as _stage, a as _type, r as extractStep, k as flattenMarkdownOrString, h as isAndOperator, c as isDeployedInstance, b as isDeploymentNode, o as isGlobalFqn, m as isGroupElementKind, e as isKindEqual, g as isNotOperator, i as isOnStage, j as isOrOperator, f as isParticipantOperator, q as isStepEdgeId, d as isTagEqual, s as splitGlobalFqn, p as stepEdgeId, w as whereOperatorAsPredicate } from '../shared/core.Br7Fab9l.mjs';
-export { E as Expression, F as FqnExpr, b as ModelExpression, M as ModelFqnExpr, a as ModelRelationExpr, R as RelationExpr, p as getParallelStepsPrefix, n as isAutoLayoutDirection, d as isComputedView, j as isDeploymentView, e as isDiagramView, k as isDynamicView, q as isDynamicViewParallelSteps, f as isElementView, h as isExtendsElementView, e as isLayoutedView, g as isScopedElementView, o as isViewRuleAutoLayout, m as isViewRuleGlobalPredicateRef, l as isViewRuleGlobalStyle, r as isViewRuleGroup, i as isViewRulePredicate, c as isViewRuleStyle } from '../shared/core.DXRAwwDB.mjs';
+export { F as FqnRef, _ as _stage, a as _type, h as isAndOperator, c as isDeployedInstance, b as isDeploymentNode, e as isKindEqual, g as isNotOperator, i as isOnStage, j as isOrOperator, f as isParticipantOperator, d as isTagEqual, w as whereOperatorAsPredicate } from '../shared/core._jnYNUQ-.mjs';
+export { E as Expression, F as FqnExpr, b as ModelExpression, M as ModelFqnExpr, a as ModelRelationExpr, R as RelationExpr, p as getParallelStepsPrefix, n as isAutoLayoutDirection, d as isComputedView, j as isDeploymentView, e as isDiagramView, k as isDynamicView, q as isDynamicViewParallelSteps, f as isElementView, h as isExtendsElementView, e as isLayoutedView, g as isScopedElementView, o as isViewRuleAutoLayout, m as isViewRuleGlobalPredicateRef, l as isViewRuleGlobalStyle, r as isViewRuleGroup, i as isViewRulePredicate, c as isViewRuleStyle } from '../shared/core.CaJp8Amg.mjs';
 export { B as BBox, a as BorderStyles, E as ElementShapes, R as RectBox, T as ThemeColors, i as isTagColorSpecified, b as isThemeColor } from '../shared/core.CxGKeL-L.mjs';
-export { f as DefaultArrowType, a as DefaultElementShape, e as DefaultLineStyle, c as DefaultPaddingSize, g as DefaultRelationshipColor, b as DefaultShapeSize, d as DefaultTextSize, D as DefaultThemeColor, R as RichText } from '../shared/core.D56nCp7e.mjs';
+export { f as DefaultArrowType, a as DefaultElementShape, e as DefaultLineStyle, c as DefaultPaddingSize, g as DefaultRelationshipColor, b as DefaultShapeSize, d as DefaultTextSize, D as DefaultThemeColor, R as RichText } from '../shared/core.CaaYNQDM.mjs';
+export { DeploymentFqn, EdgeId, Fqn, GlobalFqn, GroupElementKind, NodeId, RelationId, StepEdgeKind, ViewId, extractStep, flattenMarkdownOrString, isGlobalFqn, isGroupElementKind, isStepEdgeId, splitGlobalFqn, stepEdgeId } from './scalar.mjs';
 import '../shared/core.zLlww-07.mjs';
-import '../shared/core.D4npX2q8.mjs';
+import '../shared/core.CnIyafWn.mjs';
 import '../shared/core.BgvIuGGU.mjs';
 import '../shared/core.DbRvwARP.mjs';
+import '../shared/core.D4npX2q8.mjs';
 import '../shared/core.B0oEIXqd.mjs';
 import 'rehype-raw';
 import 'rehype-sanitize';

package/dist/types/scalar.d.mts

@@ -0,0 +1,2 @@
+import 'type-fest';
+export { A as AnyFqn, B as BuiltInIcon, D as DeploymentFqn, b as DeploymentKind, j as EdgeId, E as ElementKind, F as Fqn, e as GlobalFqn, G as GroupElementKind, I as Icon, a as IconUrl, M as MarkdownOrString, N as NodeId, P as ProjectId, d as RelationId, R as RelationKind, c as RelationshipKind, k as StepEdgeId, S as StepEdgeIdLiteral, m as StepEdgeKind, T as Tag, V as ViewId, o as extractStep, f as flattenMarkdownOrString, g as isGlobalFqn, i as isGroupElementKind, n as isStepEdgeId, h as splitGlobalFqn, l as stepEdgeId } from '../shared/core.668kXpZq.mjs';

package/dist/types/scalar.mjs

@@ -0,0 +1,68 @@
+import { n } from '../shared/core.CnIyafWn.mjs';
+import { t } from '../shared/core.zLlww-07.mjs';
+import { i as invariant } from '../shared/core.D4npX2q8.mjs';
+
+function flattenMarkdownOrString(value) {
+  if (value === null || value === void 0) {
+    return null;
+  }
+  const content = t(value) ? value : value.txt ?? value.md;
+  return n(content?.trim()) ? content : null;
+}
+function Fqn(name, parent) {
+  return parent ? parent + "." + name : name;
+}
+const GroupElementKind = "@group";
+function isGroupElementKind(v) {
+  return v.kind === GroupElementKind;
+}
+function DeploymentFqn(name, parent) {
+  return parent ? parent + "." + name : name;
+}
+function ViewId(id) {
+  return id;
+}
+function RelationId(id) {
+  return id;
+}
+function GlobalFqn(projectId, name) {
+  invariant(n(projectId), "Project ID must start with @");
+  return "@" + projectId + "." + name;
+}
+function isGlobalFqn(fqn) {
+  return fqn.startsWith("@");
+}
+function splitGlobalFqn(fqn) {
+  if (!fqn.startsWith("@")) {
+    return [null, fqn];
+  }
+  const firstDot = fqn.indexOf(".");
+  if (firstDot < 2) {
+    throw new Error("Invalid global FQN");
+  }
+  const projectId = fqn.slice(1, firstDot);
+  const name = fqn.slice(firstDot + 1);
+  return [projectId, name];
+}
+function NodeId(id) {
+  return id;
+}
+function EdgeId(id) {
+  return id;
+}
+function stepEdgeId(step, parallelStep) {
+  const id = `step-${String(step).padStart(2, "0")}`;
+  return parallelStep ? `${id}.${parallelStep}` : id;
+}
+const StepEdgeKind = "@step";
+function isStepEdgeId(id) {
+  return id.startsWith("step-");
+}
+function extractStep(id) {
+  if (!isStepEdgeId(id)) {
+    throw new Error(`Invalid step edge id: ${id}`);
+  }
+  return parseFloat(id.slice("step-".length));
+}
+
+export { DeploymentFqn, EdgeId, Fqn, GlobalFqn, GroupElementKind, NodeId, RelationId, StepEdgeKind, ViewId, extractStep, flattenMarkdownOrString, isGlobalFqn, isGroupElementKind, isStepEdgeId, splitGlobalFqn, stepEdgeId };

package/dist/utils/index.d.mts

@@ -2,7 +2,7 @@ export { D as DefaultMap } from '../shared/core.CywrQs86.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.CF82MWyh.mjs';
 import { N as NonEmptyArray } from '../shared/core.DuSLYTG6.mjs';
 import { Tagged, Simplify, Or, IfNever, IsLiteral, And, GreaterThan, IsNever, IsEqual, ReadonlyTuple, IsNumericLiteral } from 'type-fest';
-export { ifilter, ifind, iflat, ihead, imap, ireduce, isIterable, isome, iunique, toArray, toSet } from './iterable/index.mjs';
+export { ifilter, ifind, ifirst, iflat, ihead, imap, ireduce, isIterable, isome, iunique, toArray, toSet } from './iterable/index.mjs';
 import '../shared/core.668kXpZq.mjs';
 
 /**
@@ -231,22 +231,20 @@ declare function commonHead<T>(sources: ReadonlyArray<T>, targets: ReadonlyArray
 
 declare function compareNatural(a: string | undefined, b: string | undefined): -1 | 0 | 1;
 /**
- * Compares two strings hierarchically based on their depth.
+ * Compares two strings lexicographically first, then hierarchically based on their depth.\
  * From parent nodes to leaves
  *
  * @example
  * const lines = [
+ *   'b.c',
+ *   'b',
  *   'a.b.c',
- *   'a',
- *   'a.b',
- *   'a.c.c',
  * ]
  * lines.sort(compareNaturalHierarchically('.'))
  * // [
- * //   'a',
- * //   'a.b',
  * //   'a.b.c',
- * //   'a.c.c',
+ * //   'b',
+ * //   'b.c',
  * // ]
  */
 declare function compareNaturalHierarchically(separator?: string): (a: string | undefined, b: string | undefined) => number;

package/dist/utils/index.mjs

@@ -1,16 +1,16 @@
 export { i as invariant, a as nonNullable, n as nonexhaustive } from '../shared/core.D4npX2q8.mjs';
-export { S as Stack, c as commonHead, o as objectHash } from '../shared/core.CtKXPqN_.mjs';
-export { b as ancestorsFqn, d as commonAncestor, e as compareByFqnHierarchically, f as compareFqnHierarchically, c as compareNatural, a as compareNaturalHierarchically, h as hierarchyDistance, g as hierarchyLevel, i as isAncestor, j as isDescendantOf, o as isNonEmptyArray, k as isSameHierarchy, q as isString, n as nameFromFqn, p as parentFqn, s as sortByFqnHierarchically, l as sortNaturalByFqn, m as sortParentsFirst } from '../shared/core.C_C-3c1S.mjs';
+export { S as Stack, c as commonHead, o as objectHash } from '../shared/core.HUONfQfd.mjs';
+export { b as ancestorsFqn, d as commonAncestor, e as compareByFqnHierarchically, f as compareFqnHierarchically, c as compareNatural, a as compareNaturalHierarchically, h as hierarchyDistance, g as hierarchyLevel, i as isAncestor, j as isDescendantOf, o as isNonEmptyArray, k as isSameHierarchy, q as isString, n as nameFromFqn, p as parentFqn, s as sortByFqnHierarchically, l as sortNaturalByFqn, m as sortParentsFirst } from '../shared/core.DQj9iv_y.mjs';
 export { g as getOrCreate } from '../shared/core.DcS-0zys.mjs';
 export { a as markdownToHtml, b as markdownToText, m as memoizeProp } from '../shared/core.B0oEIXqd.mjs';
-export { b as BiMap, d as DefaultWeakMap, l as LinkedList, m as MultiMap, q as Queue, c as compareRelations, a as delay, p as promiseNextTick } from '../shared/core.XptQjhMA.mjs';
+export { b as BiMap, d as DefaultWeakMap, l as LinkedList, m as MultiMap, q as Queue, c as compareRelations, a as delay, p as promiseNextTick } from '../shared/core.b2BzqGz0.mjs';
 export { d as difference, e as equalsSet, i as hasAtLeast, a as intersection, b as stringHash, s as symmetricDifference, u as union } from '../shared/core.CpwrZi3D.mjs';
-export { D as DefaultMap } from '../shared/core.BMCb0wJI.mjs';
+export { D as DefaultMap } from '../shared/core.yaRvRnMW.mjs';
 export { i as ifilter } from '../shared/core.BH9nN-_I.mjs';
 export { i as ifind, a as ihead } from '../shared/core.DsMrjY2q.mjs';
+export { ifirst, ireduce } from './iterable/index.mjs';
 export { i as iflat, a as isIterable, b as iunique } from '../shared/core.8KM0D6va.mjs';
 export { i as imap, t as toArray, a as toSet } from '../shared/core.Btl47GOn.mjs';
-export { ireduce } from './iterable/index.mjs';
 export { i as isome } from '../shared/core.BoyJPEen.mjs';
 import '../shared/core.DbRvwARP.mjs';
 import '../shared/core.ByrmCl9I.mjs';

package/dist/utils/iterable/index.d.mts

@@ -39,6 +39,23 @@ declare function ifind<T>(predicate: (item: T) => boolean): (iterable: Iterable<
 declare function ifind<T, S extends T>(iterable: Iterable<T>, predicate: (item: T) => item is S): S | undefined;
 declare function ifind<T>(iterable: Iterable<T>, predicate: (item: T) => boolean): T | undefined;
 
+/**
+ * Takes the first N elements from an iterable.
+ * Composable first version of `ifirst`.
+ * @signature
+ *   ifirst(count)(data)
+ */
+declare function ifirst<T>(count: number): (iterable: Iterable<T>) => IteratorLike<T>;
+/**
+ * Takes the first N elements from an iterable.
+ * Data first version of `ifirst`.
+ * @signature
+ *   ifirst(data, count)
+ * @example
+ *   ifirst([1, 2, 3, 4, 5], 3) // => Iterable<[1, 2, 3]>
+ */
+declare function ifirst<T>(iterable: Iterable<T>, count: number): IteratorLike<T>;
+
 declare function iflat(): <T>(iterable: Iterable<IteratorLike<T>>) => IteratorLike<T>;
 declare function iflat<T>(iterable: Iterable<IteratorLike<T>>): IteratorLike<T>;
 
@@ -97,4 +114,4 @@ declare function toSet<T>(iterable: Iterable<T>): Set<T>;
 declare function iunique(): <T>(iterable: Iterable<T>) => IteratorLike<T>;
 declare function iunique<T>(iterable: Iterable<T>): IteratorLike<T>;
 
-export { ifilter, ifind, iflat, ihead, imap, ireduce, isIterable, isome, iunique, toArray, toSet };
+export { ifilter, ifind, ifirst, iflat, ihead, imap, ireduce, isIterable, isome, iunique, toArray, toSet };

package/dist/utils/iterable/index.mjs

@@ -3,10 +3,30 @@ export { i as iflat, a as isIterable, b as iunique } from '../../shared/core.8KM
 import { t } from '../../shared/core.BH9nN-_I.mjs';
 export { i as ifilter } from '../../shared/core.BH9nN-_I.mjs';
 export { i as ifind, a as ihead } from '../../shared/core.DsMrjY2q.mjs';
-export { i as imap, t as toArray, a as toSet } from '../../shared/core.Btl47GOn.mjs';
 import { i as invariant } from '../../shared/core.D4npX2q8.mjs';
+export { i as imap, t as toArray, a as toSet } from '../../shared/core.Btl47GOn.mjs';
 export { i as isome } from '../../shared/core.BoyJPEen.mjs';
 
+function ifirst(arg1, arg2) {
+  const count = arg2 ?? arg1;
+  invariant(typeof count === "number" && count >= 0, "Count must be a non-negative number");
+  function* _first(iter) {
+    let taken = 0;
+    for (const value of iter) {
+      if (taken >= count) {
+        break;
+      }
+      yield value;
+      taken++;
+    }
+    return;
+  }
+  if (arg2 === void 0) {
+    return (iterable) => _first(iterable);
+  }
+  return _first(arg1);
+}
+
 function ireduce(arg1, arg2, arg3) {
   const reducer = n(arg3) ? arg2 : arg1;
   const initialValue = arg3 ?? arg2;
@@ -21,4 +41,4 @@ function ireduce(arg1, arg2, arg3) {
   return n(arg3) ? _reduce(arg1) : _reduce;
 }
 
-export { ireduce };
+export { ifirst, ireduce };

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@likec4/core",
-  "version": "1.34.2",
+  "version": "1.36.0",
   "license": "MIT",
   "homepage": "https://likec4.dev",
   "author": "Denis Davydkov <denis@davydkov.com>",
+  "description": "A core package for LikeC4, containing types, api, utilities and guards.",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/likec4/likec4.git",
@@ -69,14 +70,6 @@
         "default": "./dist/utils/index.mjs"
       }
     },
-    "./types/_aux": {
-      "sources": "./src/types/_aux.ts",
-      "default": {
-        "types": "./dist/types/_aux.d.mts",
-        "import": "./dist/types/_aux.mjs",
-        "default": "./dist/types/_aux.mjs"
-      }
-    },
     "./types": {
       "sources": "./src/types/index.ts",
       "default": {
@@ -86,6 +79,7 @@
       }
     },
     "./src": "./src/index.ts",
+    "./src/*": "./src/*",
     "./package.json": "./package.json"
   },
   "publishConfig": {
@@ -103,19 +97,20 @@
     "remark-parse": "11.0.0",
     "remark-rehype": "11.1.2",
     "type-fest": "^4.41.0",
-    "unified": "11.0.5"
+    "unified": "11.0.5",
+    "chroma-js": "^3.1.2",
+    "@mantine/colors-generator": "8.2.2"
   },
   "devDependencies": {
+    "@types/chroma-js": "^3.1.1",
     "@dagrejs/dagre": "1.1.5",
-    "@mantine/colors-generator": "8.1.2",
     "@types/extend": "3.0.4",
     "@types/hast": "3.0.4",
     "@types/mdast": "4.0.4",
     "@types/natural-compare-lite": "^1.4.2",
     "@types/object-hash": "^3.0.6",
     "@types/unist": "3.0.3",
-    "@types/node": "~20.19.1",
-    "chroma-js": "^3.1.2",
+    "@types/node": "~20.19.2",
     "defu": "^6.1.4",
     "fdir": "6.4.6",
     "graphology": "^0.25.4",
@@ -126,11 +121,11 @@
     "object-hash": "^3.0.0",
     "obliterator": "^2.0.5",
     "remeda": "^2.23.1",
-    "turbo": "2.5.4",
-    "typescript": "5.8.3",
+    "turbo": "2.5.5",
+    "typescript": "5.9.2",
     "unbuild": "3.5.0",
     "vitest": "3.2.4",
-    "@likec4/tsconfig": "1.34.2"
+    "@likec4/tsconfig": "1.36.0"
   },
   "scripts": {
     "typecheck": "tsc -b --verbose",

package/src/builder/Builder.ts

@@ -16,8 +16,10 @@ import { computeLikeC4Model } from '../compute-view/compute-view'
 import { LikeC4Model } from '../model/LikeC4Model'
 import type {
   Any,
+  aux,
   DeployedInstance,
   DeploymentFqn,
+  LikeC4Project,
   ParsedElementView,
   ParsedLikeC4ModelData,
   Specification,
@@ -47,7 +49,7 @@ import {
 } from '../types'
 import { invariant } from '../utils'
 import { isSameHierarchy, nameFromFqn, parentFqn } from '../utils/fqn'
-import type { AnyTypes, BuilderSpecification, Types } from './_types'
+import type { AnyTypes, BuilderProjectSpecification, BuilderSpecification, Types } from './_types'
 import type { AddDeploymentNode } from './Builder.deployment'
 import type {
   AddDeploymentNodeHelpers,
@@ -177,11 +179,19 @@ export interface Builder<T extends AnyTypes> extends BuilderMethods<T> {
    * Views are not computed or layouted
    * {@link toLikeC4Model} should be used to get model with computed views
    */
+  build<const Project extends BuilderProjectSpecification>(
+    project: Project,
+  ): ParsedLikeC4ModelData<aux.setProject<Types.ToAux<T>, Project['id']>>
+
   build(): ParsedLikeC4ModelData<Types.ToAux<T>>
 
   /**
    * Returns Computed LikeC4Model
    */
+  toLikeC4Model<const Project extends BuilderProjectSpecification>(
+    project: Project,
+  ): LikeC4Model.Computed<aux.setProject<Types.ToAux<T>, Project['id']>>
+
   toLikeC4Model(): LikeC4Model.Computed<Types.ToAux<T>>
 }
 
@@ -395,9 +405,10 @@ function builder<Spec extends BuilderSpecification, T extends AnyTypes>(
       })
       return self
     },
-    build: () => ({
+    build: (project?: LikeC4Project) => ({
       [_stage]: 'parsed',
-      projectId: 'from-builder',
+      projectId: project?.id ?? 'from-builder',
+      project: project ?? { id: 'from-builder' },
       specification: toLikeC4Specification(),
       elements: fromEntries(
         structuredClone(
@@ -421,9 +432,9 @@ function builder<Spec extends BuilderSpecification, T extends AnyTypes>(
       ),
       imports: {},
     } as any),
-    toLikeC4Model: () => {
-      const parsed = self.build()
-      return computeLikeC4Model(parsed)
+    toLikeC4Model: (project?: LikeC4Project) => {
+      const parsed = self.build(project as any)
+      return computeLikeC4Model(parsed) as any
     },
     helpers: () => ({
       model: {

package/src/builder/__snapshots__/Builder-style1.spec.ts.snap

@@ -95,6 +95,9 @@ exports[`Builder (style1) > should build nested elements and relTo 1`] = `
     "styles": {},
   },
   "imports": {},
+  "project": {
+    "id": "from-builder",
+  },
   "projectId": "from-builder",
   "relations": {
     "rel1": {
@@ -208,6 +211,9 @@ exports[`Builder (style1) > should build view  1`] = `
     "styles": {},
   },
   "imports": {},
+  "project": {
+    "id": "from-builder",
+  },
   "projectId": "from-builder",
   "relations": {},
   "specification": {
@@ -350,6 +356,9 @@ exports[`Builder (style1) > should build viewOf  1`] = `
     "styles": {},
   },
   "imports": {},
+  "project": {
+    "id": "from-builder",
+  },
   "projectId": "from-builder",
   "relations": {},
   "specification": {

package/src/builder/__snapshots__/Builder-style2.compute-model.json5

@@ -61,6 +61,9 @@
     "styles": {},
   },
   "imports": {},
+  "project": {
+    "id": "from-builder",
+  },
   "projectId": "from-builder",
   "relations": {
     "rel1": {

package/src/builder/__snapshots__/Builder-style2.spec.ts.snap

@@ -104,6 +104,9 @@ exports[`Builder (style 2) > should build  1`] = `
     "styles": {},
   },
   "imports": {},
+  "project": {
+    "id": "from-builder",
+  },
   "projectId": "from-builder",
   "relations": {},
   "specification": {

package/src/builder/_types.ts

@@ -41,6 +41,16 @@ export type BuilderSpecification = {
   metadataKeys?: string[]
 }
 
+/**
+ * We need with `id: string` to be able to derive the project id
+ *
+ * @see {@link LikeC4Project}
+ */
+export type BuilderProjectSpecification = {
+  id: string
+  title?: string
+}
+
 export type Metadata<MetadataKey extends string> = IsNever<MetadataKey> extends true ? never :
   IsLiteral<MetadataKey> extends true ? {
       [key in MetadataKey]?: string

package/src/compute-view/dynamic-view/compute.ts

@@ -44,6 +44,8 @@ namespace DynamicViewCompute {
     title: string | null
     description?: string
     technology?: string
+    // Notes for walkthrough
+    notes?: scalar.MarkdownOrString
     color?: Color
     line?: RelationshipLineType
     head?: RelationshipArrowType

package/src/compute-view/element-view/__test__/fixture.ts

@@ -356,6 +356,7 @@ export const globalStyles = {
 export type FakeRelationIds = (typeof fakeRelations)[number]['id']
 const fakeParsedModel = {
   _stage: 'computed' as const,
+  project: { id: 'test-project', config: { name: 'test-project' } },
   specification: {
     elements: {
       actor: {},

package/src/compute-view/element-view/predicates/relation-direct.ts

@@ -1,5 +1,5 @@
-import { concat, constant, flatMap, hasAtLeast, map, partition, pipe, piped, prop, when } from 'remeda'
-import type { RelationshipModel } from '../../../model'
+import { concat, constant, filter, flatMap, hasAtLeast, map, partition, pipe, piped, prop, when } from 'remeda'
+import type { ElementModel, RelationshipModel } from '../../../model'
 import { ConnectionModel } from '../../../model'
 import { type AnyAux, type ModelRelationExpr, FqnRef, ModelFqnExpr } from '../../../types'
 import { invariant, isSameHierarchy } from '../../../utils'
@@ -16,6 +16,8 @@ import {
 } from './_utils'
 
 const isWildcard = ModelFqnExpr.isWildcard
+const isAncestorOrDescendantOf = (a: ElementModel<AnyAux>, b: ElementModel<AnyAux>) =>
+  a.isAncestorOf(b) || a.isDescendantOf(b)
 
 export const DirectRelationExprPredicate: PredicateExecutor<ModelRelationExpr.Direct<AnyAux>> = {
   include: ({ expr: { source, target, isBidirectional = false }, memory, model, stage, where, filterWhere }) => {
@@ -75,6 +77,7 @@ export const DirectRelationExprPredicate: PredicateExecutor<ModelRelationExpr.Di
                 concat(
                   pipe(
                     outgoing,
+                    filter(r => !isAncestorOrDescendantOf(source, r.target)),
                     map(outgoing =>
                       new ConnectionModel(
                         source,
@@ -85,6 +88,7 @@ export const DirectRelationExprPredicate: PredicateExecutor<ModelRelationExpr.Di
                   ),
                   pipe(
                     incoming,
+                    filter(r => !isAncestorOrDescendantOf(source, r.source)),
                     map(incoming =>
                       new ConnectionModel(
                         incoming.source,
@@ -133,6 +137,7 @@ export const DirectRelationExprPredicate: PredicateExecutor<ModelRelationExpr.Di
                 concat(
                   pipe(
                     outgoing,
+                    filter(r => !isAncestorOrDescendantOf(target, r.target)),
                     map(outgoing =>
                       new ConnectionModel(
                         target,
@@ -143,6 +148,7 @@ export const DirectRelationExprPredicate: PredicateExecutor<ModelRelationExpr.Di
                   ),
                   pipe(
                     incoming,
+                    filter(r => !isAncestorOrDescendantOf(target, r.source)),
                     map(incoming =>
                       new ConnectionModel(
                         incoming.source,

package/src/compute-view/utils/applyCustomRelationProperties.ts

@@ -19,6 +19,7 @@ export function applyCustomRelationProperties<A extends AnyAux>(
         expr,
         title,
         description,
+        notes,
         ...customprops
       },
     } of rules
@@ -46,6 +47,7 @@ export function applyCustomRelationProperties<A extends AnyAux>(
           ...edge,
           ...props,
           ...description && { description: { txt: description } },
+          ...notes && { notes: { txt: notes } },
           label: title ?? edge.label,
           isCustomized: true,
         }

package/src/model/DeploymentModel.ts

@@ -30,8 +30,8 @@ import {
   type IncomingFilter,
   type OutgoingFilter,
   type RelationOrId,
-  getId,
 } from './types'
+import { getId } from './utils'
 import type { LikeC4ViewModel } from './view/LikeC4ViewModel'
 
 export class LikeC4DeploymentModel<A extends Any = Any> {