@likec4/core 1.35.0 → 1.36.1

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.Ddua-wiI.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.Ddua-wiI.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.BajmN8zR.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.B1ZN723l.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/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@likec4/core",
-  "version": "1.35.0",
+  "version": "1.36.1",
   "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,12 +97,13 @@
     "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.2.1",
     "@types/extend": "3.0.4",
     "@types/hast": "3.0.4",
     "@types/mdast": "4.0.4",
@@ -116,7 +111,6 @@
     "@types/object-hash": "^3.0.6",
     "@types/unist": "3.0.3",
     "@types/node": "~20.19.2",
-    "chroma-js": "^3.1.2",
     "defu": "^6.1.4",
     "fdir": "6.4.6",
     "graphology": "^0.25.4",
@@ -128,10 +122,10 @@
     "obliterator": "^2.0.5",
     "remeda": "^2.23.1",
     "turbo": "2.5.5",
-    "typescript": "5.8.3",
+    "typescript": "5.9.2",
     "unbuild": "3.5.0",
     "vitest": "3.2.4",
-    "@likec4/tsconfig": "1.35.0"
+    "@likec4/tsconfig": "1.36.1"
   },
   "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/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/LikeC4Model.ts

@@ -8,6 +8,7 @@ import type {
   IteratorLike,
   LayoutedLikeC4ModelData,
   LikeC4ModelDump,
+  LikeC4Project,
   ModelGlobals,
   ParsedLikeC4ModelData,
   Relationship,
@@ -119,6 +120,7 @@ export class LikeC4Model<A extends Any = aux.Unknown> {
     const {
       _stage: stage = 'layouted',
       projectId = 'unknown',
+      project,
       globals,
       imports,
       deployments,
@@ -130,6 +132,7 @@ export class LikeC4Model<A extends Any = aux.Unknown> {
     return new LikeC4Model({
       [_stage]: stage as 'layouted',
       projectId,
+      project,
       globals: {
         predicates: globals?.predicates ?? {},
         dynamicPredicates: globals?.dynamicPredicates ?? {},
@@ -295,6 +298,12 @@ export class LikeC4Model<A extends Any = aux.Unknown> {
     return this.$data.projectId ?? 'unknown' as any
   }
 
+  get project(): LikeC4Project {
+    return this.$data.project ?? memoizeProp(this, Symbol.for('project'), () => ({
+      id: this.projectId as unknown as scalar.ProjectId,
+    }))
+  }
+
   get specification(): Specification<A> {
     return this.$data.specification
   }
@@ -806,6 +815,7 @@ export namespace LikeC4Model {
   export const EMPTY = LikeC4Model.create<aux.UnknownComputed>({
     _stage: 'computed',
     projectId: 'default' as never,
+    project: { id: 'default' as never },
     specification: {
       elements: {},
       relationships: {},
@@ -831,24 +841,24 @@ export namespace LikeC4Model {
     // dprint-ignore
     aux.Unknown extends A
       ? LikeC4Model<aux.UnknownParsed>
-      : A extends Aux<any, infer E, infer D, infer V, infer P, infer Spec>
-        ? LikeC4Model<Aux<'parsed', E, D, V, P, Spec>>
+      : A extends Aux<any, infer E, infer D, infer V, infer PID, infer Spec>
+        ? LikeC4Model<Aux<'parsed', E, D, V, PID, Spec>>
         : never
 
   export type Computed<A = aux.Unknown> =
     // dprint-ignore
     aux.Unknown extends A
     ? LikeC4Model<aux.UnknownComputed>
-    : A extends Aux<any, infer E, infer D, infer V, infer P, infer Spec>
-      ? LikeC4Model<Aux<'computed', E, D, V, P, Spec>>
+    : A extends Aux<any, infer E, infer D, infer V, infer PID, infer Spec>
+      ? LikeC4Model<Aux<'computed', E, D, V, PID, Spec>>
       : never
 
   export type Layouted<A = aux.Unknown> =
     // dprint-ignore
     aux.Unknown extends A
       ? LikeC4Model<aux.UnknownLayouted>
-      : A extends Aux<any, infer E, infer D, infer V, infer P, infer Spec>
-        ? LikeC4Model<Aux<'layouted', E, D, V, P, Spec>>
+      : A extends Aux<any, infer E, infer D, infer V, infer PID, infer Spec>
+        ? LikeC4Model<Aux<'layouted', E, D, V, PID, Spec>>
         : never
 
   export type Node<A = aux.Unknown> = A extends aux.AnyAux ? NodeModel<A> : never

package/src/theme/element.ts

@@ -29,30 +29,15 @@ export const ElementColors = {
   muted: slate,
   slate,
   gray: {
-    // fill: colors.neutral[500],
-    // stroke: colors.neutral[600],
-    // hiContrast: colors.neutral[50],
-    // loContrast: colors.neutral[200],
     fill: '#737373',
     stroke: '#525252',
     hiContrast: '#fafafa',
     loContrast: '#d4d4d4',
   },
   red: {
-    // fill: colors.red[500],
-    // stroke: colors.red[600],
-    // hiContrast: colors.red[50],
-    // loContrast: colors.red[200],
     fill: '#AC4D39',
-    // fill: '#b54548',
     stroke: '#853A2D',
-    // hiContrast: '#fef2f2',
-    // loContrast: '#fecaca',
-    // hiContrast: '#191111', // colors.gray[900],
-    // loContrast: '#3b1219' // colors.gray[800],
     hiContrast: '#FBD3CB',
-    // hiContrast: '#f8fafc',
-    // loContrast: '#fdd8d8' // radix black red 12
     loContrast: '#f5b2a3',
   },
   green: {
@@ -68,10 +53,6 @@ export const ElementColors = {
     loContrast: '#f9b27c',
   },
   indigo: {
-    // fill: colors.indigo[500],
-    // stroke: colors.indigo[600],
-    // hiContrast: colors.indigo[50],
-    // loContrast: colors.indigo[200],
     fill: '#6366f1',
     stroke: '#4f46e5',
     hiContrast: '#eef2ff',

package/src/types/_aux.ts

@@ -149,6 +149,12 @@ export type toLayouted<A> = A extends Aux<any, infer E, infer D, infer V, infer
  */
 export type ProjectId<A> = A extends infer T extends Any ? Coalesce<T['ProjectId']> : never
 
+export type setProject<A, P extends string> =
+  // dprint-ignore
+  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
  */

package/src/types/index.ts

@@ -25,6 +25,7 @@ export * from './model-dump'
 export * from './model-logical'
 export * from './model-spec'
 export * from './operators'
+export * from './project'
 export * from './scalar'
 export * from './styles'
 export * from './view'

package/src/types/model-data.ts

@@ -7,11 +7,13 @@ import type { ModelGlobals } from './global'
 import type { DeploymentElement, DeploymentRelationship } from './model-deployment'
 import type { Element, Relationship } from './model-logical'
 import type { Specification } from './model-spec'
+import type { LikeC4Project } from './project'
 import type * as scalar from './scalar'
 import type { ComputedView, LayoutedView, ParsedView } from './view'
 
 interface BaseLikeC4ModelData<A extends aux.Any> {
   projectId: aux.ProjectId<A>
+  project: LikeC4Project
   specification: Specification<A>
   elements: Record<aux.ElementId<A>, Element<A>>
   deployments: {

package/src/types/model-dump.ts

@@ -39,6 +39,7 @@ export type SpecTypesFromDump<J> = J extends SpecificationDump ? aux.SpecAux<
 export type LikeC4ModelDump = {
   [_stage]?: 'computed' | 'layouted'
   projectId?: string
+  project?: ProjectDump
   specification: SpecificationDump
   elements?: {
     [kind: string]: object
@@ -61,12 +62,18 @@ export type LikeC4ModelDump = {
   imports?: {}
 }
 
+export type ProjectDump = {
+  id: string
+  name?: string
+  title?: string | undefined
+}
+
 export type AuxFromDump<D> = D extends LikeC4ModelDump ? aux.Aux<
     D[_stage] extends infer S extends string & 'computed' | 'layouted' ? S : 'computed' | 'layouted' | 'parsed',
     KeysOf<D['elements']>,
     KeysOf<D['deployments']['elements']>,
     KeysOf<D['views']>,
-    D['projectId'] extends infer P extends string ? P : never,
+    D['projectId'] extends infer PID extends string ? PID : never,
     SpecTypesFromDump<D['specification']>
   >
   : aux.Never

package/src/types/project.ts

@@ -0,0 +1,9 @@
+import * as scalar from './scalar'
+
+/**
+ * LikeC4 projects encapsulate model, and can import from each other
+ */
+export interface LikeC4Project {
+  id: scalar.ProjectId
+  title?: string
+}

package/src/types/view-computed.ts

@@ -66,7 +66,7 @@ export interface ComputedEdge<A extends Any = Any> extends aux.WithOptionalTags<
   kind?: aux.RelationKind<A> | typeof scalar.StepEdgeKind
   notation?: string
   // Notes for walkthrough
-  notes?: string
+  notes?: scalar.MarkdownOrString
   color?: Color
   line?: RelationshipLineType
   head?: RelationshipArrowType

package/src/types/view-parsed.dynamic.ts

@@ -5,7 +5,7 @@ import type { AnyAux } from './_aux'
 import type { ExclusiveUnion } from './_common'
 import type { _type } from './const'
 import type { ModelFqnExpr } from './expression-model'
-import { isStepEdgeId } from './scalar'
+import { type MarkdownOrString, isStepEdgeId } from './scalar'
 import type { Color, RelationshipArrowType, RelationshipLineType } from './styles'
 import type {
   BaseParsedViewProperties,
@@ -23,7 +23,7 @@ export interface DynamicViewStep<A extends AnyAux = AnyAux> {
   readonly technology?: string
   readonly notation?: string
   // Notes for walkthrough
-  readonly notes?: string
+  readonly notes?: MarkdownOrString
   readonly color?: Color
   readonly line?: RelationshipLineType
   readonly head?: RelationshipArrowType