@likec4/language-server 1.40.0 → 1.42.0

package/dist/model/model-parser.d.ts

@@ -24,7 +24,12 @@ declare const DocumentParserFromMixins: {
         parseDynamicViewRule(astRule: import("../generated/ast").DynamicViewRule): ProjectId;
         parseDynamicViewIncludePredicate(astRule: import("../generated/ast").DynamicViewIncludePredicate): ProjectId;
         parseDynamicParallelSteps(node: import("../generated/ast").DynamicViewParallelSteps): ProjectId;
-        parseDynamicStep(node: import("../generated/ast").DynamicViewStep): ProjectId;
+        parseDynamicStep(node: import("../generated/ast").DynamicViewStep): ProjectId | ProjectId;
+        recursiveParseDynamicStepChain(node: import("../generated/ast").DynamicStepChain, callstack?: Array<[source: ProjectId, target: ProjectId]>): ProjectId[];
+        parseDynamicStepSingle(node: import("../generated/ast").DynamicStepSingle): ProjectId;
+        parseAbstractDynamicStep(astnode: import("../generated/ast").AbstractDynamicStep): import("type-fest").Writable<import("type-fest").Except<ProjectId, "source", {
+            requireExactProps: true;
+        }>>;
         parsePredicate(astNode: import("../generated/ast").ExpressionV2): ProjectId;
         parseElementPredicate(astNode: import("../generated/ast").FqnExprOrWith): ProjectId;
         parseElementPredicateOrWhere(astNode: import("../generated/ast").FqnExprOrWhere): ProjectId;
@@ -47,6 +52,7 @@ declare const DocumentParserFromMixins: {
         parseFqnExpressions(astNode: import("../generated/ast").FqnExpressions): ProjectId[];
         parseRelationExprOrWith(astNode: import("../generated/ast").RelationExprOrWith): ProjectId;
         parseRelationExprWith(astNode: import("../generated/ast").RelationExprWith): ProjectId;
+        parseCustomRelationProperties(custom: import("../generated/ast").CustomRelationProperties | undefined): import("type-fest").Except<ProjectId["customRelation"], "expr">;
         parseRelationExprOrWhere(astNode: import("../generated/ast").RelationExprOrWhere): ProjectId;
         parseRelationExprWhere(astNode: import("../generated/ast").RelationExprWhere): ProjectId;
         parseRelationExpr(astNode: import("../generated/ast").RelationExpr): ProjectId;
@@ -75,16 +81,19 @@ declare const DocumentParserFromMixins: {
         parseColorLiteral(astNode: import("../generated/ast").ColorLiteral): ProjectId | undefined;
         parseElementStyle(elementProps: Array<import("../generated/ast").ElementProperty> | import("../generated/ast").ElementStyleProperty | undefined): import("../ast").ParsedElementStyle;
         parseStyleProps(styleProps: Array<import("../generated/ast").StyleProperty> | undefined): import("../ast").ParsedElementStyle;
-        parseTitleDescriptionTechnology(inlineProps: {
-            title?: string | undefined;
-            description?: string | undefined;
-            technology?: string | undefined;
-        }, bodyProps: {
+        parseBaseProps(props: {
             title?: import("../generated/ast").MarkdownOrString | undefined;
+            summary?: import("../generated/ast").MarkdownOrString | undefined;
             description?: import("../generated/ast").MarkdownOrString | undefined;
             technology?: import("../generated/ast").MarkdownOrString | undefined;
+        }, override?: {
+            title?: string | undefined;
+            summary?: string | undefined;
+            description?: string | undefined;
+            technology?: string | undefined;
         }): {
             title?: string;
+            summary?: ProjectId;
             description?: ProjectId;
             technology?: string;
         };
@@ -114,7 +123,12 @@ declare const DocumentParserFromMixins: {
         parseDynamicViewRule(astRule: import("../generated/ast").DynamicViewRule): ProjectId;
         parseDynamicViewIncludePredicate(astRule: import("../generated/ast").DynamicViewIncludePredicate): ProjectId;
         parseDynamicParallelSteps(node: import("../generated/ast").DynamicViewParallelSteps): ProjectId;
-        parseDynamicStep(node: import("../generated/ast").DynamicViewStep): ProjectId;
+        parseDynamicStep(node: import("../generated/ast").DynamicViewStep): ProjectId | ProjectId;
+        recursiveParseDynamicStepChain(node: import("../generated/ast").DynamicStepChain, callstack?: Array<[source: ProjectId, target: ProjectId]>): ProjectId[];
+        parseDynamicStepSingle(node: import("../generated/ast").DynamicStepSingle): ProjectId;
+        parseAbstractDynamicStep(astnode: import("../generated/ast").AbstractDynamicStep): import("type-fest").Writable<import("type-fest").Except<ProjectId, "source", {
+            requireExactProps: true;
+        }>>;
         parsePredicate(astNode: import("../generated/ast").ExpressionV2): ProjectId;
         parseElementPredicate(astNode: import("../generated/ast").FqnExprOrWith): ProjectId;
         parseElementPredicateOrWhere(astNode: import("../generated/ast").FqnExprOrWhere): ProjectId;
@@ -137,6 +151,7 @@ declare const DocumentParserFromMixins: {
         parseFqnExpressions(astNode: import("../generated/ast").FqnExpressions): ProjectId[];
         parseRelationExprOrWith(astNode: import("../generated/ast").RelationExprOrWith): ProjectId;
         parseRelationExprWith(astNode: import("../generated/ast").RelationExprWith): ProjectId;
+        parseCustomRelationProperties(custom: import("../generated/ast").CustomRelationProperties | undefined): import("type-fest").Except<ProjectId["customRelation"], "expr">;
         parseRelationExprOrWhere(astNode: import("../generated/ast").RelationExprOrWhere): ProjectId;
         parseRelationExprWhere(astNode: import("../generated/ast").RelationExprWhere): ProjectId;
         parseRelationExpr(astNode: import("../generated/ast").RelationExpr): ProjectId;
@@ -165,16 +180,19 @@ declare const DocumentParserFromMixins: {
         parseColorLiteral(astNode: import("../generated/ast").ColorLiteral): ProjectId | undefined;
         parseElementStyle(elementProps: Array<import("../generated/ast").ElementProperty> | import("../generated/ast").ElementStyleProperty | undefined): import("../ast").ParsedElementStyle;
         parseStyleProps(styleProps: Array<import("../generated/ast").StyleProperty> | undefined): import("../ast").ParsedElementStyle;
-        parseTitleDescriptionTechnology(inlineProps: {
-            title?: string | undefined;
-            description?: string | undefined;
-            technology?: string | undefined;
-        }, bodyProps: {
+        parseBaseProps(props: {
             title?: import("../generated/ast").MarkdownOrString | undefined;
+            summary?: import("../generated/ast").MarkdownOrString | undefined;
             description?: import("../generated/ast").MarkdownOrString | undefined;
             technology?: import("../generated/ast").MarkdownOrString | undefined;
+        }, override?: {
+            title?: string | undefined;
+            summary?: string | undefined;
+            description?: string | undefined;
+            technology?: string | undefined;
         }): {
             title?: string;
+            summary?: ProjectId;
             description?: ProjectId;
             technology?: string;
         };
@@ -217,16 +235,19 @@ declare const DocumentParserFromMixins: {
         parseColorLiteral(astNode: import("../generated/ast").ColorLiteral): ProjectId | undefined;
         parseElementStyle(elementProps: Array<import("../generated/ast").ElementProperty> | import("../generated/ast").ElementStyleProperty | undefined): import("../ast").ParsedElementStyle;
         parseStyleProps(styleProps: Array<import("../generated/ast").StyleProperty> | undefined): import("../ast").ParsedElementStyle;
-        parseTitleDescriptionTechnology(inlineProps: {
-            title?: string | undefined;
-            description?: string | undefined;
-            technology?: string | undefined;
-        }, bodyProps: {
+        parseBaseProps(props: {
             title?: import("../generated/ast").MarkdownOrString | undefined;
+            summary?: import("../generated/ast").MarkdownOrString | undefined;
             description?: import("../generated/ast").MarkdownOrString | undefined;
             technology?: import("../generated/ast").MarkdownOrString | undefined;
+        }, override?: {
+            title?: string | undefined;
+            summary?: string | undefined;
+            description?: string | undefined;
+            technology?: string | undefined;
         }): {
             title?: string;
+            summary?: ProjectId;
             description?: ProjectId;
             technology?: string;
         };
@@ -255,6 +276,7 @@ declare const DocumentParserFromMixins: {
         parseFqnExpressions(astNode: import("../generated/ast").FqnExpressions): ProjectId[];
         parseRelationExprOrWith(astNode: import("../generated/ast").RelationExprOrWith): ProjectId;
         parseRelationExprWith(astNode: import("../generated/ast").RelationExprWith): ProjectId;
+        parseCustomRelationProperties(custom: import("../generated/ast").CustomRelationProperties | undefined): import("type-fest").Except<ProjectId["customRelation"], "expr">;
         parseRelationExprOrWhere(astNode: import("../generated/ast").RelationExprOrWhere): ProjectId;
         parseRelationExprWhere(astNode: import("../generated/ast").RelationExprWhere): ProjectId;
         parseRelationExpr(astNode: import("../generated/ast").RelationExpr): ProjectId;
@@ -283,16 +305,19 @@ declare const DocumentParserFromMixins: {
         parseColorLiteral(astNode: import("../generated/ast").ColorLiteral): ProjectId | undefined;
         parseElementStyle(elementProps: Array<import("../generated/ast").ElementProperty> | import("../generated/ast").ElementStyleProperty | undefined): import("../ast").ParsedElementStyle;
         parseStyleProps(styleProps: Array<import("../generated/ast").StyleProperty> | undefined): import("../ast").ParsedElementStyle;
-        parseTitleDescriptionTechnology(inlineProps: {
-            title?: string | undefined;
-            description?: string | undefined;
-            technology?: string | undefined;
-        }, bodyProps: {
+        parseBaseProps(props: {
             title?: import("../generated/ast").MarkdownOrString | undefined;
+            summary?: import("../generated/ast").MarkdownOrString | undefined;
             description?: import("../generated/ast").MarkdownOrString | undefined;
             technology?: import("../generated/ast").MarkdownOrString | undefined;
+        }, override?: {
+            title?: string | undefined;
+            summary?: string | undefined;
+            description?: string | undefined;
+            technology?: string | undefined;
         }): {
             title?: string;
+            summary?: ProjectId;
             description?: ProjectId;
             technology?: string;
         };
@@ -314,6 +339,7 @@ declare const DocumentParserFromMixins: {
         parseFqnExpressions(astNode: import("../generated/ast").FqnExpressions): ProjectId[];
         parseRelationExprOrWith(astNode: import("../generated/ast").RelationExprOrWith): ProjectId;
         parseRelationExprWith(astNode: import("../generated/ast").RelationExprWith): ProjectId;
+        parseCustomRelationProperties(custom: import("../generated/ast").CustomRelationProperties | undefined): import("type-fest").Except<ProjectId["customRelation"], "expr">;
         parseRelationExprOrWhere(astNode: import("../generated/ast").RelationExprOrWhere): ProjectId;
         parseRelationExprWhere(astNode: import("../generated/ast").RelationExprWhere): ProjectId;
         parseRelationExpr(astNode: import("../generated/ast").RelationExpr): ProjectId;
@@ -342,16 +368,19 @@ declare const DocumentParserFromMixins: {
         parseColorLiteral(astNode: import("../generated/ast").ColorLiteral): ProjectId | undefined;
         parseElementStyle(elementProps: Array<import("../generated/ast").ElementProperty> | import("../generated/ast").ElementStyleProperty | undefined): import("../ast").ParsedElementStyle;
         parseStyleProps(styleProps: Array<import("../generated/ast").StyleProperty> | undefined): import("../ast").ParsedElementStyle;
-        parseTitleDescriptionTechnology(inlineProps: {
-            title?: string | undefined;
-            description?: string | undefined;
-            technology?: string | undefined;
-        }, bodyProps: {
+        parseBaseProps(props: {
             title?: import("../generated/ast").MarkdownOrString | undefined;
+            summary?: import("../generated/ast").MarkdownOrString | undefined;
             description?: import("../generated/ast").MarkdownOrString | undefined;
             technology?: import("../generated/ast").MarkdownOrString | undefined;
+        }, override?: {
+            title?: string | undefined;
+            summary?: string | undefined;
+            description?: string | undefined;
+            technology?: string | undefined;
         }): {
             title?: string;
+            summary?: ProjectId;
             description?: ProjectId;
             technology?: string;
         };
@@ -381,6 +410,7 @@ declare const DocumentParserFromMixins: {
         parseFqnExpressions(astNode: import("../generated/ast").FqnExpressions): ProjectId[];
         parseRelationExprOrWith(astNode: import("../generated/ast").RelationExprOrWith): ProjectId;
         parseRelationExprWith(astNode: import("../generated/ast").RelationExprWith): ProjectId;
+        parseCustomRelationProperties(custom: import("../generated/ast").CustomRelationProperties | undefined): import("type-fest").Except<ProjectId["customRelation"], "expr">;
         parseRelationExprOrWhere(astNode: import("../generated/ast").RelationExprOrWhere): ProjectId;
         parseRelationExprWhere(astNode: import("../generated/ast").RelationExprWhere): ProjectId;
         parseRelationExpr(astNode: import("../generated/ast").RelationExpr): ProjectId;
@@ -409,16 +439,19 @@ declare const DocumentParserFromMixins: {
         parseColorLiteral(astNode: import("../generated/ast").ColorLiteral): ProjectId | undefined;
         parseElementStyle(elementProps: Array<import("../generated/ast").ElementProperty> | import("../generated/ast").ElementStyleProperty | undefined): import("../ast").ParsedElementStyle;
         parseStyleProps(styleProps: Array<import("../generated/ast").StyleProperty> | undefined): import("../ast").ParsedElementStyle;
-        parseTitleDescriptionTechnology(inlineProps: {
-            title?: string | undefined;
-            description?: string | undefined;
-            technology?: string | undefined;
-        }, bodyProps: {
+        parseBaseProps(props: {
             title?: import("../generated/ast").MarkdownOrString | undefined;
+            summary?: import("../generated/ast").MarkdownOrString | undefined;
             description?: import("../generated/ast").MarkdownOrString | undefined;
             technology?: import("../generated/ast").MarkdownOrString | undefined;
+        }, override?: {
+            title?: string | undefined;
+            summary?: string | undefined;
+            description?: string | undefined;
+            technology?: string | undefined;
         }): {
             title?: string;
+            summary?: ProjectId;
             description?: ProjectId;
             technology?: string;
         };
@@ -441,6 +474,7 @@ declare const DocumentParserFromMixins: {
         parseFqnExpressions(astNode: import("../generated/ast").FqnExpressions): ProjectId[];
         parseRelationExprOrWith(astNode: import("../generated/ast").RelationExprOrWith): ProjectId;
         parseRelationExprWith(astNode: import("../generated/ast").RelationExprWith): ProjectId;
+        parseCustomRelationProperties(custom: import("../generated/ast").CustomRelationProperties | undefined): import("type-fest").Except<ProjectId["customRelation"], "expr">;
         parseRelationExprOrWhere(astNode: import("../generated/ast").RelationExprOrWhere): ProjectId;
         parseRelationExprWhere(astNode: import("../generated/ast").RelationExprWhere): ProjectId;
         parseRelationExpr(astNode: import("../generated/ast").RelationExpr): ProjectId;
@@ -469,16 +503,19 @@ declare const DocumentParserFromMixins: {
         parseColorLiteral(astNode: import("../generated/ast").ColorLiteral): ProjectId | undefined;
         parseElementStyle(elementProps: Array<import("../generated/ast").ElementProperty> | import("../generated/ast").ElementStyleProperty | undefined): import("../ast").ParsedElementStyle;
         parseStyleProps(styleProps: Array<import("../generated/ast").StyleProperty> | undefined): import("../ast").ParsedElementStyle;
-        parseTitleDescriptionTechnology(inlineProps: {
-            title?: string | undefined;
-            description?: string | undefined;
-            technology?: string | undefined;
-        }, bodyProps: {
+        parseBaseProps(props: {
             title?: import("../generated/ast").MarkdownOrString | undefined;
+            summary?: import("../generated/ast").MarkdownOrString | undefined;
             description?: import("../generated/ast").MarkdownOrString | undefined;
             technology?: import("../generated/ast").MarkdownOrString | undefined;
+        }, override?: {
+            title?: string | undefined;
+            summary?: string | undefined;
+            description?: string | undefined;
+            technology?: string | undefined;
         }): {
             title?: string;
+            summary?: ProjectId;
             description?: ProjectId;
             technology?: string;
         };
@@ -509,16 +546,19 @@ declare const DocumentParserFromMixins: {
         parseColorLiteral(astNode: import("../generated/ast").ColorLiteral): ProjectId | undefined;
         parseElementStyle(elementProps: Array<import("../generated/ast").ElementProperty> | import("../generated/ast").ElementStyleProperty | undefined): import("../ast").ParsedElementStyle;
         parseStyleProps(styleProps: Array<import("../generated/ast").StyleProperty> | undefined): import("../ast").ParsedElementStyle;
-        parseTitleDescriptionTechnology(inlineProps: {
-            title?: string | undefined;
-            description?: string | undefined;
-            technology?: string | undefined;
-        }, bodyProps: {
+        parseBaseProps(props: {
             title?: import("../generated/ast").MarkdownOrString | undefined;
+            summary?: import("../generated/ast").MarkdownOrString | undefined;
             description?: import("../generated/ast").MarkdownOrString | undefined;
             technology?: import("../generated/ast").MarkdownOrString | undefined;
+        }, override?: {
+            title?: string | undefined;
+            summary?: string | undefined;
+            description?: string | undefined;
+            technology?: string | undefined;
         }): {
             title?: string;
+            summary?: ProjectId;
             description?: ProjectId;
             technology?: string;
         };
@@ -536,6 +576,7 @@ declare const DocumentParserFromMixins: {
         parseFqnExpressions(astNode: import("../generated/ast").FqnExpressions): ProjectId[];
         parseRelationExprOrWith(astNode: import("../generated/ast").RelationExprOrWith): ProjectId;
         parseRelationExprWith(astNode: import("../generated/ast").RelationExprWith): ProjectId;
+        parseCustomRelationProperties(custom: import("../generated/ast").CustomRelationProperties | undefined): import("type-fest").Except<ProjectId["customRelation"], "expr">;
         parseRelationExprOrWhere(astNode: import("../generated/ast").RelationExprOrWhere): ProjectId;
         parseRelationExprWhere(astNode: import("../generated/ast").RelationExprWhere): ProjectId;
         parseRelationExpr(astNode: import("../generated/ast").RelationExpr): ProjectId;
@@ -564,16 +605,19 @@ declare const DocumentParserFromMixins: {
         parseColorLiteral(astNode: import("../generated/ast").ColorLiteral): ProjectId | undefined;
         parseElementStyle(elementProps: Array<import("../generated/ast").ElementProperty> | import("../generated/ast").ElementStyleProperty | undefined): import("../ast").ParsedElementStyle;
         parseStyleProps(styleProps: Array<import("../generated/ast").StyleProperty> | undefined): import("../ast").ParsedElementStyle;
-        parseTitleDescriptionTechnology(inlineProps: {
-            title?: string | undefined;
-            description?: string | undefined;
-            technology?: string | undefined;
-        }, bodyProps: {
+        parseBaseProps(props: {
             title?: import("../generated/ast").MarkdownOrString | undefined;
+            summary?: import("../generated/ast").MarkdownOrString | undefined;
             description?: import("../generated/ast").MarkdownOrString | undefined;
             technology?: import("../generated/ast").MarkdownOrString | undefined;
+        }, override?: {
+            title?: string | undefined;
+            summary?: string | undefined;
+            description?: string | undefined;
+            technology?: string | undefined;
         }): {
             title?: string;
+            summary?: ProjectId;
             description?: ProjectId;
             technology?: string;
         };

package/dist/model/parser/Base.d.ts

@@ -44,19 +44,25 @@ export declare class BaseParser {
     parseElementStyle(elementProps: Array<ast.ElementProperty> | ast.ElementStyleProperty | undefined): ParsedElementStyle;
     parseStyleProps(styleProps: Array<ast.StyleProperty> | undefined): ParsedElementStyle;
     /**
-     * Parses title, description and technology
-     * Inline properties (right on node) have higher priority than body properties (inside '{...}')
+     * Parse base properties: title, description and technology
+     *
+     * @param props - body properties (inside '{...}')
+     * @param override - optional, inline properties (right on the node)
+     *                   have higher priority and override body properties
      */
-    parseTitleDescriptionTechnology(inlineProps: {
-        title?: string | undefined;
-        description?: string | undefined;
-        technology?: string | undefined;
-    }, bodyProps: {
+    parseBaseProps(props: {
         title?: ast.MarkdownOrString | undefined;
+        summary?: ast.MarkdownOrString | undefined;
         description?: ast.MarkdownOrString | undefined;
         technology?: ast.MarkdownOrString | undefined;
+    }, override?: {
+        title?: string | undefined;
+        summary?: string | undefined;
+        description?: string | undefined;
+        technology?: string | undefined;
     }): {
         title?: string;
+        summary?: c4.MarkdownOrString;
         description?: c4.MarkdownOrString;
         technology?: string;
     };

package/dist/model/parser/Base.mjs

@@ -1,4 +1,10 @@
-import { GlobalFqn, isNonEmptyArray, nonexhaustive, nonNullable } from "@likec4/core";
+import {
+  exact,
+  GlobalFqn,
+  isNonEmptyArray,
+  nonexhaustive,
+  nonNullable
+} from "@likec4/core";
 import {
   filter,
   flatMap,
@@ -23,10 +29,11 @@ import {
   parseMarkdownAsString,
   toColor
 } from "../../ast.mjs";
-import { logger } from "../../logger.mjs";
+import { serverLogger } from "../../logger.mjs";
 import { projectIdFrom } from "../../utils/index.mjs";
 import { readStrictFqn } from "../../utils/elementRef.mjs";
 import { checksFromDiagnostics } from "../../validation/index.mjs";
+const logger = serverLogger.getChild("BaseParser");
 export function toSingleLine(str) {
   if (str === null || str === void 0) {
     return void 0;
@@ -104,10 +111,9 @@ export class BaseParser {
       metadataAstNode.props,
       map((p) => [p.key, removeIndent(p.value)]),
       map(([key, value]) => [key, value.md || value.txt]),
-      filter(([_, value]) => isTruthy(value)),
-      fromEntries()
+      filter(([_, value]) => isTruthy(value))
     );
-    return isEmpty(data) ? void 0 : data;
+    return data.length > 0 ? fromEntries(data) : void 0;
   }
   parseMarkdownOrString(markdownOrString) {
     if (ast.isMarkdownOrString(markdownOrString)) {
@@ -132,7 +138,7 @@ export class BaseParser {
             tags.push(...values);
           }
         }
-      } catch (e) {
+      } catch {
       }
       iter = iter.prev;
     }
@@ -204,7 +210,7 @@ export class BaseParser {
     const slashIndex = value.indexOf("/");
     const aliasName = slashIndex > 0 ? value.substring(0, slashIndex) : value;
     const remainingPath = slashIndex > 0 ? value.substring(slashIndex + 1) : "";
-    const imageAliases = { "@": "./images", ...this.project.config.imageAliases || {} };
+    const imageAliases = { "@": "./images", ...this.project.config.imageAliases };
     const aliasPath = imageAliases[aliasName];
     if (!aliasPath) {
       logger.warn(`Image alias "${aliasName}" not found in project configuration`);
@@ -237,8 +243,8 @@ export class BaseParser {
       return {};
     }
     if (isArray(elementProps)) {
-      const style = this.parseStyleProps(elementProps?.find(ast.isElementStyleProperty)?.props);
-      const iconProp = this.parseIconProperty(elementProps?.find(ast.isIconProperty));
+      const style = this.parseStyleProps(elementProps.find(ast.isElementStyleProperty)?.props);
+      const iconProp = this.parseIconProperty(elementProps.find(ast.isIconProperty));
       if (iconProp) {
         style.icon = iconProp;
       }
@@ -312,20 +318,25 @@ export class BaseParser {
           nonexhaustive(prop);
       }
     }
-    return result;
+    return exact(result);
   }
   /**
-   * Parses title, description and technology
-   * Inline properties (right on node) have higher priority than body properties (inside '{...}')
+   * Parse base properties: title, description and technology
+   *
+   * @param props - body properties (inside '{...}')
+   * @param override - optional, inline properties (right on the node)
+   *                   have higher priority and override body properties
    */
-  parseTitleDescriptionTechnology(inlineProps, bodyProps) {
-    const title = removeIndent(inlineProps.title ?? parseMarkdownAsString(bodyProps.title));
-    const description = inlineProps.description ? { txt: removeIndent(inlineProps.description) } : this.parseMarkdownOrString(bodyProps.description);
-    const technology = toSingleLine(inlineProps.technology) ?? removeIndent(parseMarkdownAsString(bodyProps.technology));
-    return {
-      ...isTruthy(title) && { title },
-      ...isTruthy(description) && { description },
-      ...isTruthy(technology) && { technology }
-    };
+  parseBaseProps(props, override) {
+    const title = removeIndent(override?.title ?? parseMarkdownAsString(props.title));
+    const description = override?.description ? { txt: removeIndent(override.description) } : this.parseMarkdownOrString(props.description);
+    const summary = override?.summary ? { txt: removeIndent(override.summary) } : this.parseMarkdownOrString(props.summary);
+    const technology = toSingleLine(override?.technology) ?? removeIndent(parseMarkdownAsString(props.technology));
+    return exact({
+      title,
+      summary,
+      description,
+      technology
+    });
   }
 }

package/dist/model/parser/DeploymentModelParser.d.ts

@@ -22,6 +22,7 @@ export declare function DeploymentModelParser<TBase extends WithExpressionV2>(B:
         parseFqnExpressions(astNode: ast.FqnExpressions): c4.FqnExpr[];
         parseRelationExprOrWith(astNode: ast.RelationExprOrWith): c4.RelationExpr.Any;
         parseRelationExprWith(astNode: ast.RelationExprWith): c4.RelationExpr.Custom;
+        parseCustomRelationProperties(custom: ast.CustomRelationProperties | undefined): import("type-fest").Except<c4.RelationExpr.Custom["customRelation"], "expr">;
         parseRelationExprOrWhere(astNode: ast.RelationExprOrWhere): c4.RelationExpr.OrWhere;
         parseRelationExprWhere(astNode: ast.RelationExprWhere): c4.RelationExpr.Where;
         parseRelationExpr(astNode: ast.RelationExpr): c4.RelationExpr.OrWhere;
@@ -50,16 +51,19 @@ export declare function DeploymentModelParser<TBase extends WithExpressionV2>(B:
         parseColorLiteral(astNode: ast.ColorLiteral): c4.ColorLiteral | undefined;
         parseElementStyle(elementProps: Array<ast.ElementProperty> | ast.ElementStyleProperty | undefined): import("../../ast").ParsedElementStyle;
         parseStyleProps(styleProps: Array<ast.StyleProperty> | undefined): import("../../ast").ParsedElementStyle;
-        parseTitleDescriptionTechnology(inlineProps: {
-            title?: string | undefined;
-            description?: string | undefined;
-            technology?: string | undefined;
-        }, bodyProps: {
+        parseBaseProps(props: {
             title?: ast.MarkdownOrString | undefined;
+            summary?: ast.MarkdownOrString | undefined;
             description?: ast.MarkdownOrString | undefined;
             technology?: ast.MarkdownOrString | undefined;
+        }, override?: {
+            title?: string | undefined;
+            summary?: string | undefined;
+            description?: string | undefined;
+            technology?: string | undefined;
         }): {
             title?: string;
+            summary?: c4.MarkdownOrString;
             description?: c4.MarkdownOrString;
             technology?: string;
         };

package/dist/model/parser/DeploymentModelParser.mjs

@@ -1,11 +1,22 @@
-import { FqnRef, invariant, isNonEmptyArray, LinkedList, nameFromFqn, nonexhaustive, nonNullable } from "@likec4/core";
-import { filter, first, isDefined, isEmpty, isTruthy, map, mapToObj, pipe } from "remeda";
+import {
+  exact,
+  FqnRef,
+  invariant,
+  isNonEmptyArray,
+  LinkedList,
+  nameFromFqn,
+  nonexhaustive,
+  nonNullable
+} from "@likec4/core";
+import { loggable } from "@likec4/log";
+import { filter, first, isDefined, isEmpty, isTruthy, mapToObj, pipe } from "remeda";
 import {
   ast,
-  toRelationshipStyleExcludeDefaults
+  toRelationshipStyle
 } from "../../ast.mjs";
-import { logWarnError } from "../../logger.mjs";
+import { serverLogger } from "../../logger.mjs";
 import { stringHash } from "../../utils/stringHash.mjs";
+const logger = serverLogger.getChild("DeploymentModelParser");
 function* streamDeploymentModel(doc) {
   const traverseStack = LinkedList.from(
     doc.parseResult.value.deployments.flatMap((m) => m.elements)
@@ -58,7 +69,7 @@ export function DeploymentModelParser(B) {
               nonexhaustive(el);
           }
         } catch (e) {
-          logWarnError(e);
+          logger.warn(loggable(e));
         }
       }
     }
@@ -75,23 +86,21 @@ export function DeploymentModelParser(B) {
         filter(ast.isElementStringProperty),
         mapToObj((p) => [p.key, p.value])
       );
-      const { title, ...descAndTech } = this.parseTitleDescriptionTechnology(
-        {
-          title: astNode.title
-        },
-        bodyProps
-      );
+      const { title, ...descAndTech } = this.parseBaseProps(bodyProps, {
+        title: astNode.title,
+        summary: astNode.summary
+      });
       const links = this.convertLinks(astNode.body);
-      return {
+      return exact({
         id,
         kind,
         title: title ?? nameFromFqn(id),
-        ...metadata && { metadata },
-        ...tags && { tags },
-        ...links && isNonEmptyArray(links) && { links },
         ...descAndTech,
-        style
-      };
+        tags: tags ?? void 0,
+        ...links && isNonEmptyArray(links) && { links },
+        style,
+        metadata
+      });
     }
     parseDeployedInstance(astNode) {
       const isValid = this.isValid;
@@ -107,22 +116,20 @@ export function DeploymentModelParser(B) {
         filter(ast.isElementStringProperty),
         mapToObj((p) => [p.key, p.value])
       );
-      const titleDescAndTech = this.parseTitleDescriptionTechnology(
-        {
-          title: astNode.title
-        },
-        bodyProps
-      );
+      const baseProps = this.parseBaseProps(bodyProps, {
+        title: astNode.title,
+        summary: astNode.summary
+      });
       const links = this.convertLinks(astNode.body);
-      return {
+      return exact({
         id,
         element: target,
-        ...metadata && { metadata },
-        ...tags && { tags },
+        tags: tags ?? void 0,
         ...links && isNonEmptyArray(links) && { links },
-        ...titleDescAndTech,
-        style
-      };
+        ...baseProps,
+        style,
+        metadata
+      });
     }
     parseExtendDeployment(astNode) {
       if (!this.isValid(astNode)) {
@@ -140,8 +147,8 @@ export function DeploymentModelParser(B) {
         id,
         astPath,
         ...metadata && { metadata },
-        ...tags && { tags },
-        ...links && isNonEmptyArray(links) && { links }
+        tags,
+        links: isNonEmptyArray(links) ? links : null
       };
     }
     _resolveDeploymentRelationSource(node) {
@@ -175,16 +182,11 @@ export function DeploymentModelParser(B) {
       const navigateTo = pipe(
         astNode.body?.props ?? [],
         filter(ast.isRelationNavigateToProperty),
-        map((p) => p.value.view.ref?.name),
-        filter(isTruthy),
         first()
-      );
-      const titleDescAndTech = this.parseTitleDescriptionTechnology(
-        {
-          title: astNode.title
-        },
-        bodyProps
-      );
+      )?.value.view.ref?.name;
+      const titleDescAndTech = this.parseBaseProps(bodyProps, {
+        title: astNode.title
+      });
       const styleProp = astNode.body?.props.find(ast.isRelationStyleProperty);
       const id = stringHash(
         "deployment",
@@ -192,19 +194,19 @@ export function DeploymentModelParser(B) {
         source.deployment,
         target.deployment
       );
-      return {
+      return exact({
         id,
         source,
         target,
         ...titleDescAndTech,
-        ...metadata && { metadata },
-        ...kind && { kind },
-        ...tags && { tags },
+        metadata,
+        kind,
+        tags: tags ?? void 0,
         ...isNonEmptyArray(links) && { links },
-        ...toRelationshipStyleExcludeDefaults(styleProp?.props, isValid),
-        ...navigateTo && { navigateTo },
+        ...toRelationshipStyle(styleProp?.props, isValid),
+        navigateTo,
         astPath
-      };
+      });
     }
   };
 }