@likec4/language-server 1.32.1 → 1.33.0

package/dist/lsp/SemanticTokenProvider.js

@@ -272,7 +272,7 @@ export class LikeC4SemanticTokenProvider extends AbstractSemanticTokenProvider {
         });
         return "prune";
       }
-      if ("value" in node && node.value) {
+      if ("value" in node && node.value && !ast.isStringProperty(node)) {
         acceptor({
           node,
           property: "value",

package/dist/mcp/LikeC4MCPServerFactory.d.ts

@@ -2,6 +2,8 @@ import type { ServerOptions } from '@modelcontextprotocol/sdk/server/index.js';
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { LikeC4Services } from '../module';
 export interface LikeC4MCPServer {
+    readonly isStarted: boolean;
+    readonly port: number;
     start(port: number): Promise<void>;
     stop(): Promise<void>;
 }
@@ -9,6 +11,8 @@ export interface LikeC4MCPServerFactory {
     create(options?: ServerOptions): McpServer;
 }
 export declare class NoopLikeC4MCPServer implements LikeC4MCPServer {
+    get isStarted(): boolean;
+    get port(): number;
     start(port: number): Promise<never>;
     stop(): Promise<never>;
 }

package/dist/mcp/LikeC4MCPServerFactory.js

@@ -1,4 +1,10 @@
 export class NoopLikeC4MCPServer {
+  get isStarted() {
+    return false;
+  }
+  get port() {
+    return NaN;
+  }
   start(port) {
     return Promise.reject(new Error("Not implemented"));
   }

package/dist/mcp/LikeC4MCPTools.js

@@ -1,4 +1,4 @@
-import { _type } from "@likec4/core";
+import { _type, RichText } from "@likec4/core";
 import { loggable } from "@likec4/log";
 import { flatMap } from "remeda";
 import stripIndent from "strip-indent";
@@ -9,7 +9,10 @@ import { ProjectsManager } from "../workspace/ProjectsManager.js";
 import { elementResource, modelViewResource } from "./utils.js";
 const logger = mainLogger.getChild("LikeC4MCPServices");
 function singleLine(str) {
-  const res = toSingleLine(str)?.replaceAll('"', "'");
+  if (str === null || str === void 0) {
+    return "null";
+  }
+  const res = toSingleLine(RichText.from(str).text)?.replaceAll('"', "'");
   return res ? `"${res}"` : "null";
 }
 function outputEach(iterator, ifEmpty, output) {

package/dist/mcp/sseserver/MCPServer.d.ts

@@ -3,10 +3,12 @@ import type { LikeC4Services } from '../../module';
 import type { LikeC4MCPServer } from '../LikeC4MCPServerFactory';
 export declare class SSELikeC4MCPServer implements LikeC4MCPServer, AsyncDisposable {
     private services;
-    private readonly transports;
+    private transports;
     private server;
-    private port;
+    private _port;
     constructor(services: LikeC4Services);
+    get isStarted(): boolean;
+    get port(): number;
     dispose(): Promise<void>;
     start(port?: number): Promise<void>;
     stop(): Promise<void>;

package/dist/mcp/sseserver/MCPServer.js

@@ -9,7 +9,13 @@ export class SSELikeC4MCPServer {
   // Store transports by session ID to send notifications
   transports = {};
   server = void 0;
-  port = 33335;
+  _port = 33335;
+  get isStarted() {
+    return this.server?.listening === true;
+  }
+  get port() {
+    return this._port;
+  }
   async dispose() {
     await this.stop();
   }
@@ -20,8 +26,8 @@ export class SSELikeC4MCPServer {
       }
       await this.stop();
     }
-    logger.info("Starting server on port {port}", { port });
-    this.port = port;
+    logger.info("Starting MCP server on port {port}", { port });
+    this._port = port;
     const mcp = this.services.mcp.ServerFactory.create();
     const app = express();
     app.get("/sse", async (_, res) => {
@@ -44,13 +50,12 @@ export class SSELikeC4MCPServer {
       }
     });
     return new Promise((resolve, reject) => {
-      this.server = app.listen(port, (err) => {
+      this.server = app.listen(this._port, (err) => {
         if (err) {
-          logger.error("Failed to start server", { err });
           reject(err);
           return;
         }
-        logger.info("server listening on port {port}", { port });
+        logger.info("MCP server listening on port {port}", { port: this._port });
         resolve();
       });
     });
@@ -62,6 +67,7 @@ export class SSELikeC4MCPServer {
     }
     logger.info("Stopping server");
     this.server = void 0;
+    this.transports = {};
     return new Promise((resolve) => {
       server.close((err) => {
         if (err) {

package/dist/mcp/sseserver/with-mcp-server.js

@@ -1,3 +1,5 @@
+import { loggable } from "@likec4/log";
+import { isError } from "remeda";
 import { logger } from "../../logger.js";
 import { SSELikeC4MCPServer } from "./MCPServer.js";
 import { LikeC4MCPServerFactory } from "./MCPServerFactory.js";
@@ -14,19 +16,33 @@ export const WithMCPServer = {
           return;
         }
         logger.debug("Configuration update: {update}", { update });
-        const { enabled, port } = update.configuration.mcp ?? {
-          enabled: false,
-          port: 33335
-        };
+        const {
+          enabled = false,
+          port = 33335
+        } = update.configuration.mcp;
         if (!enabled) {
           server.stop();
           return;
         }
         Promise.resolve().then(() => server.start(port)).then(() => {
           connection?.telemetry?.logEvent({
-            eventName: "mcp-server-started"
+            eventName: "mcp-server-started",
+            mcpPort: port
           });
-        }).catch((err) => logger.error("Failed to start LikeC4 MCP Server", { err }));
+        }).catch((err) => {
+          const message = isError(err) ? err.message : void 0;
+          connection?.telemetry?.logEvent({
+            eventName: "mcp-server-start-failed",
+            mcpPort: port,
+            ...message && { message }
+          });
+          logger.error("Failed to start LikeC4 MCP Server", { err });
+          if (connection) {
+            connection.window.showErrorMessage(`LikeC4: Failed to start MCP Server
+
+${loggable(err)}`);
+          }
+        });
       });
       return server;
     },

package/dist/model/builder/MergedSpecification.js

@@ -102,8 +102,8 @@ export class MergedSpecification {
         },
         links: links ?? null,
         tags: tags ?? [],
-        technology: technology ?? null,
-        description: description ?? null,
+        ...technology && { technology },
+        ...description && { description },
         title,
         kind,
         id
@@ -155,6 +155,7 @@ export class MergedSpecification {
       };
     }
     if ("element" in parsed) {
+      logger.warn`Invalid ParsedAstDeployment ${parsed.id}, has both element and kind properties`;
       return null;
     }
     try {
@@ -166,10 +167,13 @@ export class MergedSpecification {
       let {
         technology = __kind.technology,
         notation = __kind.notation,
-        style
+        style,
+        description,
+        ...rest
       } = parsed;
       return {
-        ...parsed,
+        ...rest,
+        ...description && { description },
         ...notation && { notation },
         ...technology && { technology },
         style: {

package/dist/model/index.d.ts

@@ -3,3 +3,4 @@ export * from './fqn-index';
 export * from './model-builder';
 export * from './model-locator';
 export * from './model-parser';
+export * from './parser/ValueConverter';

package/dist/model/index.js

@@ -3,3 +3,4 @@ export * from "./fqn-index.js";
 export * from "./model-builder.js";
 export * from "./model-locator.js";
 export * from "./model-parser.js";
+export * from "./parser/ValueConverter.js";

package/dist/model/model-builder.js

@@ -11,7 +11,6 @@ import {
   DocumentState,
   interruptAndCheck
 } from "langium";
-import prettyMs from "pretty-ms";
 import {
   filter,
   flatMap,
@@ -26,13 +25,13 @@ import {
 import { CancellationToken } from "vscode-jsonrpc";
 import { isLikeC4Builtin } from "../likec4lib.js";
 import { logger as mainLogger, logWarnError } from "../logger.js";
-import { ADisposable } from "../utils/index.js";
+import { ADisposable, performanceMark } from "../utils/index.js";
 import { assignNavigateTo } from "../view-utils/index.js";
 import { buildModelData } from "./builder/buildModel.js";
 const parsedWithoutImportsCacheKey = (projectId) => `parsed-without-imports-${projectId}`;
 const parsedModelCacheKey = (projectId) => `parsed-model-${projectId}`;
 const computedModelCacheKey = (projectId) => `computed-model-${projectId}`;
-const logger = mainLogger.getChild("ModelBuilder");
+const builderLogger = mainLogger.getChild("model-builder");
 export class DefaultLikeC4ModelBuilder extends ADisposable {
   projects;
   parser;
@@ -65,7 +64,7 @@ export class DefaultLikeC4ModelBuilder extends ADisposable {
         }
       )
     );
-    logger.debug`created`;
+    builderLogger.debug`created`;
   }
   /**
    * WARNING:
@@ -76,19 +75,19 @@ export class DefaultLikeC4ModelBuilder extends ADisposable {
    */
   unsafeSyncParseModelData(projectId) {
     const cache = this.cache;
-    const log = logger.getChild(["project", projectId]);
+    const logger = builderLogger.getChild(projectId);
     const key = parsedWithoutImportsCacheKey(projectId);
     if (cache.has(key)) {
-      log.debug`unsafeSyncBuildModelData from cache, project ${projectId}`;
+      logger.debug`unsafeSyncBuildModelData from cache`;
     }
     return cache.get(key, () => {
       try {
         const docs = this.documents(projectId);
         if (docs.length === 0) {
-          logger.debug`no documents to build model, project ${projectId}`;
+          logger.debug`no documents to build model`;
           return null;
         }
-        log.debug`unsafeSyncBuildModelData, project ${projectId}`;
+        logger.debug`unsafeSyncBuildModelData`;
         return buildModelData(projectId, docs);
       } catch (e) {
         logWarnError(e);
@@ -100,6 +99,7 @@ export class DefaultLikeC4ModelBuilder extends ADisposable {
    * To avoid circular dependencies, first we parse all documents and then we join them.
    */
   unsafeSyncJoinedModelData(projectId) {
+    const logger = builderLogger.getChild(projectId);
     const cache = this.cache;
     const key = parsedModelCacheKey(projectId);
     return cache.get(key, () => {
@@ -133,18 +133,18 @@ export class DefaultLikeC4ModelBuilder extends ADisposable {
   }
   async parseModel(projectId, cancelToken = CancellationToken.None) {
     const project = this.projects.ensureProjectId(projectId);
-    const log = logger.getChild(["project", project]);
+    const logger = builderLogger.getChild(project);
     const cache = this.cache;
     const cached = cache.get(parsedModelCacheKey(project));
     if (cached) {
-      log.debug`parseModel from cache, project ${project}`;
+      logger.debug`parseModel from cache`;
       return cached;
     }
-    const t0 = performance.now();
+    const t0 = performanceMark();
     return await this.mutex.read(async () => {
       await interruptAndCheck(cancelToken);
       const result = this.unsafeSyncJoinedModelData(project);
-      log.debug(`parseModel, project ${project} in ${prettyMs(performance.now() - t0)}`);
+      logger.debug`parseModel in ${t0.pretty}`;
       return result;
     });
   }
@@ -155,6 +155,7 @@ export class DefaultLikeC4ModelBuilder extends ADisposable {
    * Otherwise, the model may be incomplete.
    */
   unsafeSyncBuildModel(projectId) {
+    const logger = builderLogger.getChild(projectId);
     const cache = this.cache;
     const viewsCache = this.cache;
     return cache.get(computedModelCacheKey(projectId), () => {
@@ -189,24 +190,24 @@ export class DefaultLikeC4ModelBuilder extends ADisposable {
   }
   async buildLikeC4Model(projectId, cancelToken = CancellationToken.None) {
     const project = this.projects.ensureProjectId(projectId);
-    const log = logger.getChild(["project", project]);
+    const logger = builderLogger.getChild(project);
     const cache = this.cache;
     const cached = cache.get(computedModelCacheKey(project));
     if (cached) {
-      log.debug("buildLikeC4Model from cache");
+      logger.debug("buildLikeC4Model from cache");
       return cached;
     }
-    const t0 = performance.now();
+    const t0 = performanceMark();
     return await this.mutex.read(async () => {
       await interruptAndCheck(cancelToken);
       const result = this.unsafeSyncBuildModel(project);
-      log.debug(`buildLikeC4Model in ${prettyMs(performance.now() - t0)}`);
+      logger.debug(`buildLikeC4Model in ${t0.pretty}`);
       return result;
     });
   }
   async computeView(viewId, projectId, cancelToken = CancellationToken.None) {
     const project = this.projects.ensureProjectId(projectId);
-    const log = logger.getChild(["project", project]);
+    const logger = builderLogger.getChild(project);
     const cache = this.cache;
     const cacheKey = computedViewKey(project, viewId);
     if (cache.has(cacheKey)) {
@@ -219,10 +220,10 @@ export class DefaultLikeC4ModelBuilder extends ADisposable {
     return cache.get(cacheKey, () => {
       const view = parsed.$data.views[viewId];
       if (!view) {
-        log.warn`computeView: cant find view ${viewId}`;
+        logger.warn`computeView: cant find view ${viewId}`;
         return null;
       }
-      log.debug`computeView: ${viewId}`;
+      logger.debug`computeView: ${viewId}`;
       const result = computeView(view, parsed);
       if (!result.isSuccess) {
         logWarnError(result.error);

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

@@ -63,6 +63,7 @@ declare const DocumentParserFromMixins: {
         getMetadata(metadataAstNode: import("../generated/ast").MetadataProperty | undefined): {
             [key: string]: string;
         } | undefined;
+        parseMarkdownOrString(markdownOrString: import("../generated/ast").MarkdownOrString | undefined): ProjectId | undefined;
         convertTags<E extends {
             tags?: import("../generated/ast").Tags;
         }>(withTags?: E | undefined): any;
@@ -75,6 +76,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: {
+            title?: import("../generated/ast").MarkdownOrString | undefined;
+            description?: import("../generated/ast").MarkdownOrString | undefined;
+            technology?: import("../generated/ast").MarkdownOrString | undefined;
+        }): {
+            title?: string;
+            description?: ProjectId;
+            technology?: string;
+        };
         parseDeploymentView(astNode: import("../generated/ast").DeploymentView): import("../ast").ParsedAstDeploymentView;
         parseDeploymentViewRule(astRule: import("../generated/ast").DeploymentViewRule): ProjectId;
         parseDeploymentViewRulePredicate(astRule: import("../generated/ast").DeploymentViewRulePredicate): ProjectId;
@@ -140,6 +154,7 @@ declare const DocumentParserFromMixins: {
         getMetadata(metadataAstNode: import("../generated/ast").MetadataProperty | undefined): {
             [key: string]: string;
         } | undefined;
+        parseMarkdownOrString(markdownOrString: import("../generated/ast").MarkdownOrString | undefined): ProjectId | undefined;
         convertTags<E extends {
             tags?: import("../generated/ast").Tags;
         }>(withTags?: E | undefined): any;
@@ -152,6 +167,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: {
+            title?: import("../generated/ast").MarkdownOrString | undefined;
+            description?: import("../generated/ast").MarkdownOrString | undefined;
+            technology?: import("../generated/ast").MarkdownOrString | undefined;
+        }): {
+            title?: string;
+            description?: ProjectId;
+            technology?: string;
+        };
         parseDeploymentView(astNode: import("../generated/ast").DeploymentView): import("../ast").ParsedAstDeploymentView;
         parseDeploymentViewRule(astRule: import("../generated/ast").DeploymentViewRule): ProjectId;
         parseDeploymentViewRulePredicate(astRule: import("../generated/ast").DeploymentViewRulePredicate): ProjectId;
@@ -181,6 +209,7 @@ declare const DocumentParserFromMixins: {
         getMetadata(metadataAstNode: import("../generated/ast").MetadataProperty | undefined): {
             [key: string]: string;
         } | undefined;
+        parseMarkdownOrString(markdownOrString: import("../generated/ast").MarkdownOrString | undefined): ProjectId | undefined;
         convertTags<E extends {
             tags?: import("../generated/ast").Tags;
         }>(withTags?: E | undefined): any;
@@ -193,6 +222,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: {
+            title?: import("../generated/ast").MarkdownOrString | undefined;
+            description?: import("../generated/ast").MarkdownOrString | undefined;
+            technology?: import("../generated/ast").MarkdownOrString | undefined;
+        }): {
+            title?: string;
+            description?: ProjectId;
+            technology?: string;
+        };
     };
 } & {
     new (...args: any[]): {
@@ -234,6 +276,7 @@ declare const DocumentParserFromMixins: {
         getMetadata(metadataAstNode: import("../generated/ast").MetadataProperty | undefined): {
             [key: string]: string;
         } | undefined;
+        parseMarkdownOrString(markdownOrString: import("../generated/ast").MarkdownOrString | undefined): ProjectId | undefined;
         convertTags<E extends {
             tags?: import("../generated/ast").Tags;
         }>(withTags?: E | undefined): any;
@@ -246,6 +289,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: {
+            title?: import("../generated/ast").MarkdownOrString | undefined;
+            description?: import("../generated/ast").MarkdownOrString | undefined;
+            technology?: import("../generated/ast").MarkdownOrString | undefined;
+        }): {
+            title?: string;
+            description?: ProjectId;
+            technology?: string;
+        };
     };
 } & {
     new (...args: any[]): {
@@ -280,6 +336,7 @@ declare const DocumentParserFromMixins: {
         getMetadata(metadataAstNode: import("../generated/ast").MetadataProperty | undefined): {
             [key: string]: string;
         } | undefined;
+        parseMarkdownOrString(markdownOrString: import("../generated/ast").MarkdownOrString | undefined): ProjectId | undefined;
         convertTags<E extends {
             tags?: import("../generated/ast").Tags;
         }>(withTags?: E | undefined): any;
@@ -292,6 +349,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: {
+            title?: import("../generated/ast").MarkdownOrString | undefined;
+            description?: import("../generated/ast").MarkdownOrString | undefined;
+            technology?: import("../generated/ast").MarkdownOrString | undefined;
+        }): {
+            title?: string;
+            description?: ProjectId;
+            technology?: string;
+        };
         parseDeployment(): void;
         parseDeploymentNode(astNode: import("../generated/ast").DeploymentNode): import("../ast").ParsedAstDeployment.Node;
         parseDeployedInstance(astNode: import("../generated/ast").DeployedInstance): import("../ast").ParsedAstDeployment.Instance;
@@ -334,6 +404,7 @@ declare const DocumentParserFromMixins: {
         getMetadata(metadataAstNode: import("../generated/ast").MetadataProperty | undefined): {
             [key: string]: string;
         } | undefined;
+        parseMarkdownOrString(markdownOrString: import("../generated/ast").MarkdownOrString | undefined): ProjectId | undefined;
         convertTags<E extends {
             tags?: import("../generated/ast").Tags;
         }>(withTags?: E | undefined): any;
@@ -346,6 +417,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: {
+            title?: import("../generated/ast").MarkdownOrString | undefined;
+            description?: import("../generated/ast").MarkdownOrString | undefined;
+            technology?: import("../generated/ast").MarkdownOrString | undefined;
+        }): {
+            title?: string;
+            description?: ProjectId;
+            technology?: string;
+        };
     };
 } & {
     new (...args: any[]): {
@@ -381,6 +465,7 @@ declare const DocumentParserFromMixins: {
         getMetadata(metadataAstNode: import("../generated/ast").MetadataProperty | undefined): {
             [key: string]: string;
         } | undefined;
+        parseMarkdownOrString(markdownOrString: import("../generated/ast").MarkdownOrString | undefined): ProjectId | undefined;
         convertTags<E extends {
             tags?: import("../generated/ast").Tags;
         }>(withTags?: E | undefined): any;
@@ -393,6 +478,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: {
+            title?: import("../generated/ast").MarkdownOrString | undefined;
+            description?: import("../generated/ast").MarkdownOrString | undefined;
+            technology?: import("../generated/ast").MarkdownOrString | undefined;
+        }): {
+            title?: string;
+            description?: ProjectId;
+            technology?: string;
+        };
     };
 } & {
     new (...args: any[]): {
@@ -410,6 +508,7 @@ declare const DocumentParserFromMixins: {
         getMetadata(metadataAstNode: import("../generated/ast").MetadataProperty | undefined): {
             [key: string]: string;
         } | undefined;
+        parseMarkdownOrString(markdownOrString: import("../generated/ast").MarkdownOrString | undefined): ProjectId | undefined;
         convertTags<E extends {
             tags?: import("../generated/ast").Tags;
         }>(withTags?: E | undefined): any;
@@ -422,6 +521,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: {
+            title?: import("../generated/ast").MarkdownOrString | undefined;
+            description?: import("../generated/ast").MarkdownOrString | undefined;
+            technology?: import("../generated/ast").MarkdownOrString | undefined;
+        }): {
+            title?: string;
+            description?: ProjectId;
+            technology?: string;
+        };
     };
 } & {
     new (...args: any[]): {
@@ -452,6 +564,7 @@ declare const DocumentParserFromMixins: {
         getMetadata(metadataAstNode: import("../generated/ast").MetadataProperty | undefined): {
             [key: string]: string;
         } | undefined;
+        parseMarkdownOrString(markdownOrString: import("../generated/ast").MarkdownOrString | undefined): ProjectId | undefined;
         convertTags<E extends {
             tags?: import("../generated/ast").Tags;
         }>(withTags?: E | undefined): any;
@@ -464,6 +577,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: {
+            title?: import("../generated/ast").MarkdownOrString | undefined;
+            description?: import("../generated/ast").MarkdownOrString | undefined;
+            technology?: import("../generated/ast").MarkdownOrString | undefined;
+        }): {
+            title?: string;
+            description?: ProjectId;
+            technology?: string;
+        };
     };
 } & typeof BaseParser;
 export declare class DocumentParser extends DocumentParserFromMixins {

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

@@ -1,12 +1,22 @@
 import type * as c4 from '@likec4/core';
+import { type MarkdownOrString } from '@likec4/core';
 import type { AstNode, URI } from 'langium';
 import { type ParsedElementStyle, type ParsedLikeC4LangiumDocument, ast } from '../../ast';
 import type { ProjectConfig } from '../../config';
 import type { LikeC4Services } from '../../module';
 import { type IsValidFn } from '../../validation';
 export type GConstructor<T = {}> = new (...args: any[]) => T;
-export declare function toSingleLine<T extends string | undefined | null>(str: T): T;
-export declare function removeIndent<T extends string | undefined | null>(str: T): T;
+export declare function toSingleLine(str: string): string;
+export declare function toSingleLine(str: string | undefined | null): string | undefined;
+export declare function toSingleLine(str: ast.MarkdownOrString): MarkdownOrString;
+export declare function toSingleLine(str: ast.MarkdownOrString | undefined | null): MarkdownOrString | undefined;
+export declare function toSingleLine(str: ast.MarkdownOrString | string): MarkdownOrString | string;
+export declare function toSingleLine(str: ast.MarkdownOrString | string | undefined | null): MarkdownOrString | string | undefined;
+export declare function removeIndent(str: string): string;
+export declare function removeIndent(str: string | undefined): string | undefined;
+export declare function removeIndent(str: ast.MarkdownOrString): MarkdownOrString;
+export declare function removeIndent(str: ast.MarkdownOrString | undefined): MarkdownOrString | undefined;
+export declare function removeIndent(str: ast.MarkdownOrString | string): MarkdownOrString | string;
 export type Base = GConstructor<BaseParser>;
 export declare class BaseParser {
     readonly services: LikeC4Services;
@@ -23,6 +33,7 @@ export declare class BaseParser {
     getMetadata(metadataAstNode: ast.MetadataProperty | undefined): {
         [key: string]: string;
     } | undefined;
+    parseMarkdownOrString(markdownOrString: ast.MarkdownOrString | undefined): c4.MarkdownOrString | undefined;
     convertTags<E extends {
         tags?: ast.Tags;
     }>(withTags?: E): any;
@@ -35,4 +46,21 @@ export declare class BaseParser {
     parseColorLiteral(astNode: ast.ColorLiteral): c4.ColorLiteral | undefined;
     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 '{...}')
+     */
+    parseTitleDescriptionTechnology(inlineProps: {
+        title?: string | undefined;
+        description?: string | undefined;
+        technology?: string | undefined;
+    }, bodyProps: {
+        title?: ast.MarkdownOrString | undefined;
+        description?: ast.MarkdownOrString | undefined;
+        technology?: ast.MarkdownOrString | undefined;
+    }): {
+        title?: string;
+        description?: c4.MarkdownOrString;
+        technology?: string;
+    };
 }