@likec4/language-server 1.32.2 → 1.34.0

package/dist/module.js

@@ -25,17 +25,14 @@ import {
   LikeC4HoverProvider,
   LikeC4SemanticTokenProvider
 } from "./lsp/index.js";
-import {
-  NoopLikeC4MCPServer,
-  NoopLikeC4MCPServerFactory
-} from "./mcp/LikeC4MCPServerFactory.js";
-import { DefaultLikeC4MCPTools } from "./mcp/LikeC4MCPTools.js";
+import { NoopLikeC4MCPServer, NoopLikeC4MCPServerFactory } from "./mcp/NoopLikeC4MCPServer.js";
 import {
   DefaultLikeC4ModelBuilder,
   DeploymentsIndex,
   FqnIndex,
   LikeC4ModelLocator,
-  LikeC4ModelParser
+  LikeC4ModelParser,
+  LikeC4ValueConverter
 } from "./model/index.js";
 import { LikeC4ModelChanges } from "./model-change/ModelChanges.js";
 import {
@@ -79,7 +76,6 @@ export const LikeC4Module = {
   ValidatedWorkspaceCache: (services) => new WorkspaceCache(services.shared, DocumentState.Validated),
   Rpc: bind(Rpc),
   mcp: {
-    Tools: bind(DefaultLikeC4MCPTools),
     Server: bind(NoopLikeC4MCPServer),
     ServerFactory: bind(NoopLikeC4MCPServerFactory)
   },
@@ -116,6 +112,9 @@ export const LikeC4Module = {
     NameProvider: bind(LikeC4NameProvider),
     ScopeComputation: bind(LikeC4ScopeComputation),
     ScopeProvider: bind(LikeC4ScopeProvider)
+  },
+  parser: {
+    ValueConverter: bind(LikeC4ValueConverter)
   }
 };
 export function createCustomLanguageServices(context, module, module2, module3) {

package/dist/protocol.d.ts

@@ -5,6 +5,19 @@ export declare namespace DidChangeModelNotification {
     const type: NotificationType<string>;
     type Type = typeof type;
 }
+/**
+ * When server requests to open a likec4 preview panel
+ * (available only in the editor).
+ * (not the best place, but seems to be working)
+ */
+export declare namespace DidRequestOpenViewNotification {
+    type Params = {
+        viewId: ViewId;
+        projectId: ProjectId;
+    };
+    const type: NotificationType<Params>;
+    type Type = typeof type;
+}
 /**
  * Request to fetch the computed model data
  * If LSP has multiple projects, the projectId is required.
@@ -175,9 +188,12 @@ export declare namespace FetchTelemetryMetrics {
     type Res = {
         metrics: null | {
             elementKinds: number;
+            deploymentKinds: number;
             relationshipKinds: number;
             tags: number;
+            customColors: number;
             elements: number;
+            deploymentNodes: number;
             relationships: number;
             views: number;
             projects: number;

package/dist/protocol.js

@@ -3,6 +3,10 @@ export var DidChangeModelNotification;
 ((DidChangeModelNotification2) => {
   DidChangeModelNotification2.type = new NotificationType("likec4/onDidChangeModel");
 })(DidChangeModelNotification || (DidChangeModelNotification = {}));
+export var DidRequestOpenViewNotification;
+((DidRequestOpenViewNotification2) => {
+  DidRequestOpenViewNotification2.type = new NotificationType("likec4/onRequestOpenView");
+})(DidRequestOpenViewNotification || (DidRequestOpenViewNotification = {}));
 export var FetchComputedModel;
 ((FetchComputedModel2) => {
   FetchComputedModel2.req = new RequestType("likec4/fetchComputedModel");

package/dist/validation/property-checks.js

@@ -48,7 +48,7 @@ export const notesPropertyRuleChecks = (_) => {
 export const colorLiteralRuleChecks = (_) => {
   return (node, accept) => {
     if (node.$type === "HexColor") {
-      if (node.hex === void 0) {
+      if (node.hex === void 0 || isString(node.hex) && !node.hex.match(/^[a-fA-F0-9]+$/)) {
         accept("error", `Invalid HEX`, {
           node,
           property: "hex"

package/dist/views/configurable-layouter.js

@@ -15,41 +15,35 @@ export const ConfigurableLayouter = {
   likec4: {
     Layouter(services) {
       logger.debug("Creating ConfigurableLayouter");
-      const wasmAdapter = new GraphvizWasmAdapter();
-      const layouter = new QueueGraphvizLayoter({
-        graphviz: wasmAdapter
-      });
-      const langId = services.LanguageMetaData.languageId;
+      const layouter = new QueueGraphvizLayoter();
       services.shared.workspace.ConfigurationProvider.onConfigurationSectionUpdate((update) => {
         logger.debug("Configuration update: {update}", { update });
-        if (update.section === langId) {
-          try {
-            const { mode, path } = update.configuration.graphviz ?? {
-              mode: "wasm",
-              path: ""
-            };
-            if (mode === "wasm") {
-              layouter.changePort(wasmAdapter);
-              logger.info("use graphviz wasm");
-              return;
-            }
+        if (update.section !== services.LanguageMetaData.languageId) {
+          logger.debug(`Ignoring configuration update as it is not for ${services.LanguageMetaData.languageId}`);
+          return;
+        }
+        try {
+          const { mode, path } = update.configuration.graphviz ?? {
+            mode: "wasm",
+            path: ""
+          };
+          if (mode !== "wasm") {
             let binaryPath = isEmpty(path) ? graphvizBinPath() : path;
-            if (binaryPath === null) {
-              layouter.changePort(wasmAdapter);
-              logger.warn(`No Graphviz binaries found on PATH, use graphviz wasm`);
-              services.shared.lsp.Connection?.window.showWarningMessage(
-                "No Graphviz binaries found on PATH, set path to binaries in settings."
-              );
+            if (!isEmpty(binaryPath)) {
+              layouter.changePort(new GraphvizBinaryAdapter(binaryPath));
+              logger.info`use graphviz binary: ${binaryPath}`;
               return;
             }
-            layouter.changePort(new GraphvizBinaryAdapter(binaryPath));
-            logger.info`use graphviz binary: ${binaryPath}`;
-          } catch (error) {
-            logger.error("Failed to update configuration", { error });
+            logger.warn(`No Graphviz binaries found on PATH, use graphviz wasm`);
+            services.shared.lsp.Connection?.window.showWarningMessage(
+              "No Graphviz binaries found on PATH, set path to binaries in settings."
+            );
           }
-          return;
+          layouter.changePort(new GraphvizWasmAdapter());
+          logger.info("use graphviz wasm");
+        } catch (error) {
+          logger.error("Failed to update configuration", { error });
         }
-        logger.warn("Unexpected configuration update: {update}", { update });
       });
       return layouter;
     }

package/dist/views/likec4-views.d.ts

@@ -18,6 +18,7 @@ export interface LikeC4Views {
     layoutView(viewId: ViewId, projectId?: ProjectId | undefined, cancelToken?: CancellationToken): Promise<GraphvizOut | null>;
     diagrams(projectId?: ProjectId | undefined, cancelToken?: CancellationToken): Promise<Array<DiagramView>>;
     viewsAsGraphvizOut(projectId?: ProjectId | undefined, cancelToken?: CancellationToken): Promise<Array<GraphvizSvgOut>>;
+    openView(viewId: ViewId, projectId?: ProjectId | undefined): Promise<void>;
 }
 export declare class DefaultLikeC4Views implements LikeC4Views {
     private services;
@@ -31,5 +32,9 @@ export declare class DefaultLikeC4Views implements LikeC4Views {
     layoutView(viewId: ViewId, projectId?: ProjectId | undefined, cancelToken?: CancellationToken): Promise<GraphvizOut | null>;
     diagrams(projectId?: ProjectId | undefined, cancelToken?: CancellationToken): Promise<Array<DiagramView>>;
     viewsAsGraphvizOut(projectId?: ProjectId | undefined, cancelToken?: CancellationToken): Promise<Array<GraphvizSvgOut>>;
+    /**
+     * Open a view in the preview panel.
+     */
+    openView(viewId: ViewId, projectId: ProjectId): Promise<void>;
 }
 export {};

package/dist/views/likec4-views.js

@@ -53,7 +53,6 @@ export class DefaultLikeC4Views {
         },
         onError: (task, error) => {
           logger.warn(`Fail layout view ${task.view.id}`, { error });
-          this.cache.delete(task.view);
         }
       });
     }
@@ -135,6 +134,12 @@ export class DefaultLikeC4Views {
     cache.set(KEY, succeed);
     return succeed;
   }
+  /**
+   * Open a view in the preview panel.
+   */
+  async openView(viewId, projectId) {
+    await this.services.Rpc.openView({ viewId, projectId });
+  }
   // async overviewGraph(): Promise<OverviewGraph> {
   //   const KEY = 'OverviewGraph'
   //   const cache = this.services.ValidatedWorkspaceCache as WorkspaceCache<string, OverviewGraph>

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@likec4/language-server",
   "description": "LikeC4 Language Server",
-  "version": "1.32.2",
+  "version": "1.34.0",
   "license": "MIT",
   "bugs": "https://github.com/likec4/likec4/issues",
   "homepage": "https://likec4.dev",
@@ -20,7 +20,7 @@
     "directory": "packages/language-server"
   },
   "engines": {
-    "node": ">=20.19.1"
+    "node": ">=20.19.3"
   },
   "engineStrict": true,
   "type": "module",
@@ -89,33 +89,33 @@
     "access": "public"
   },
   "dependencies": {
-    "@hpcc-js/wasm-graphviz": "1.7.0"
+    "@hpcc-js/wasm-graphviz": "1.8.0"
   },
   "devDependencies": {
     "@types/chroma-js": "^3.1.1",
-    "@modelcontextprotocol/sdk": "^1.12.1",
-    "@msgpack/msgpack": "^3.1.1",
+    "@modelcontextprotocol/sdk": "^1.13.2",
+    "@msgpack/msgpack": "^3.1.2",
     "@smithy/util-base64": "^4.0.0",
-    "@types/express": "^5.0.2",
-    "@types/node": "~20.19.0",
+    "@types/express": "^5.0.3",
+    "@types/node": "~20.19.1",
     "@types/picomatch": "^4.0.0",
     "@types/which": "^3.0.4",
     "chroma-js": "^3.1.2",
     "esm-env": "^1.2.2",
     "express": "^5.1.0",
     "fast-equals": "^5.2.2",
-    "fdir": "^6.4.4",
+    "fdir": "6.4.6",
     "indent-string": "^5.0.0",
     "json5": "^2.2.3",
     "langium": "3.5.0",
     "langium-cli": "3.5.0",
     "natural-compare-lite": "^1.4.0",
-    "p-debounce": "^4.0.0",
-    "p-queue": "^8.1.0",
-    "p-timeout": "^6.1.4",
+    "p-debounce": "4.0.0",
+    "p-queue": "8.1.0",
+    "p-timeout": "6.1.4",
     "picomatch": "^4.0.2",
     "pretty-ms": "^9.2.0",
-    "remeda": "^2.23.0",
+    "remeda": "^2.23.1",
     "strip-indent": "^4.0.0",
     "tsx": "4.19.4",
     "turbo": "2.5.4",
@@ -124,19 +124,19 @@
     "ufo": "^1.6.1",
     "unbuild": "3.5.0",
     "valibot": "^1.1.0",
-    "vitest": "3.2.3",
+    "vitest": "3.2.4",
     "vscode-jsonrpc": "8.2.0",
     "vscode-languageserver": "9.0.1",
     "vscode-languageserver-protocol": "3.17.5",
     "vscode-languageserver-types": "3.17.5",
     "vscode-uri": "3.1.0",
     "which": "^5.0.0",
-    "zod": "^3.25.64",
-    "@likec4/icons": "1.32.2",
-    "@likec4/core": "1.32.2",
-    "@likec4/tsconfig": "1.32.2",
-    "@likec4/layouts": "1.32.2",
-    "@likec4/log": "1.32.2"
+    "zod": "3.25.67",
+    "@likec4/core": "1.34.0",
+    "@likec4/icons": "1.34.0",
+    "@likec4/layouts": "1.34.0",
+    "@likec4/log": "1.34.0",
+    "@likec4/tsconfig": "1.34.0"
   },
   "scripts": {
     "typecheck": "tsc -b --verbose",
@@ -148,6 +148,7 @@
     "generate": "langium generate && tsx scripts/generate-icons.ts",
     "dev": "run-p \"watch:*\"",
     "lint": "run -T eslint src/ --fix",
+    "lint:package": "pnpx publint ./package.tgz",
     "clean": "pnpm rimraf dist contrib lib src/generated src/generated-lib",
     "test": "vitest run --no-isolate",
     "test-dbg": "vitest run --no-isolate -t formating",

package/dist/mcp/LikeC4MCPTools.d.ts

@@ -1,96 +0,0 @@
-import { type ProjectId } from '@likec4/core';
-import { z } from 'zod';
-import type { LikeC4Services } from '../module';
-export declare namespace LikeC4MCPTools {
-    const instructions = "This server provides access to LikeC4 model.\n\nKey capabilities:\n- List all available LikeC4 projects in the workspace\n- Search for LikeC4 project and return its summary, that includes specifications, all elements and views\n- Search for LikeC4 element by title\n- Read details about LikeC4 element by id\n- Read details about LikeC4 view by id\n\n";
-    const listProjects: {
-        name: string;
-        description: string;
-    };
-    const readProjectSummary: {
-        name: string;
-        description: string;
-        paramsSchema: {
-            project: z.ZodOptional<z.ZodString>;
-        };
-    };
-    const searchElement: {
-        name: string;
-        description: string;
-        paramsSchema: {
-            search: z.ZodString;
-        };
-    };
-    const readElement: {
-        name: string;
-        description: string;
-        paramsSchema: {
-            id: z.ZodString;
-            project: z.ZodOptional<z.ZodString>;
-        };
-    };
-    const readView: {
-        name: string;
-        description: string;
-        paramsSchema: {
-            id: z.ZodString;
-            project: z.ZodOptional<z.ZodString>;
-        };
-    };
-}
-export interface LikeC4MCPTools {
-    listProjects(): Promise<string>;
-    /**
-     * Searches for LikeC4 project and returns its summary, specifications, elements and views
-     *
-     * @param project Project name (optional, will use default project if not specified)
-     */
-    readProjectSummary(project?: string): Promise<string>;
-    /**
-     * Searches for LikeC4 elements that have the search string in their names
-     * Can be used to resolve projects for further requests (like read-element or read-project-summary)
-     *
-     * @param params.search non-empty string
-     */
-    searchElement(params: {
-        search: string;
-    }): Promise<string>;
-    /**
-     * Read details about LikeC4 element.
-     *
-     * @param params.id Element id (FQN)
-     * @param params.project Project name (optional, will use default project if not specified)
-     */
-    readElement(params: {
-        id: string;
-        project?: string | undefined;
-    }): Promise<string>;
-    /**
-     * Read details about LikeC4 view.
-     *
-     * @param params.id View id (FQN)
-     * @param params.project Project name (optional, will use default project if not specified)
-     */
-    readView(params: {
-        id: string;
-        project?: string | undefined;
-    }): Promise<string>;
-}
-export declare class DefaultLikeC4MCPTools implements LikeC4MCPTools {
-    private services;
-    private readonly languageServices;
-    constructor(services: LikeC4Services);
-    listProjects(): Promise<string>;
-    readProjectSummary(_project?: ProjectId): Promise<string>;
-    searchElement(params: {
-        search: string;
-    }): Promise<string>;
-    readElement(params: {
-        id: string;
-        project?: string;
-    }): Promise<string>;
-    readView(params: {
-        id: string;
-        project?: string;
-    }): Promise<string>;
-}

package/dist/mcp/LikeC4MCPTools.js

@@ -1,290 +0,0 @@
-import { _type } from "@likec4/core";
-import { loggable } from "@likec4/log";
-import { flatMap } from "remeda";
-import stripIndent from "strip-indent";
-import { z } from "zod";
-import { logger as mainLogger } from "../logger.js";
-import { toSingleLine } from "../model/parser/Base.js";
-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('"', "'");
-  return res ? `"${res}"` : "null";
-}
-function outputEach(iterator, ifEmpty, output) {
-  const items = [...iterator];
-  if (items.length === 0) {
-    return [ifEmpty];
-  }
-  return flatMap(items, output);
-}
-export var LikeC4MCPTools;
-((LikeC4MCPTools2) => {
-  LikeC4MCPTools2.instructions = `This server provides access to LikeC4 model.
-
-Key capabilities:
-- List all available LikeC4 projects in the workspace
-- Search for LikeC4 project and return its summary, that includes specifications, all elements and views
-- Search for LikeC4 element by title
-- Read details about LikeC4 element by id
-- Read details about LikeC4 view by id
-
-`;
-  LikeC4MCPTools2.listProjects = {
-    name: "list-projects",
-    description: "Lists all available LikeC4 projects in the workspace"
-  };
-  LikeC4MCPTools2.readProjectSummary = {
-    name: "read-project-summary",
-    description: stripIndent(`
-      Searches for LikeC4 project and returns its summary, specifications, elements and views
-
-      Args:
-        project: Project name
-    `),
-    paramsSchema: {
-      project: z.string().optional()
-    }
-  };
-  LikeC4MCPTools2.searchElement = {
-    name: "search-element",
-    description: stripIndent(`
-      Search for LikeC4 elements that have the search string in their names
-      Can be used to resolve projects for further requests (like read-element or read-project-summary)
-
-      Args:
-        search: non-empty string
-    `),
-    paramsSchema: {
-      search: z.string()
-    }
-  };
-  LikeC4MCPTools2.readElement = {
-    name: "read-element",
-    description: stripIndent(`
-      Read details about a LikeC4 element
-
-      Args:
-        id: Element id (FQN)
-        project: Project name (optional, will use default project if not specified)
-    `),
-    paramsSchema: {
-      id: z.string().min(1),
-      project: z.string().optional()
-    }
-  };
-  LikeC4MCPTools2.readView = {
-    name: "read-view",
-    description: stripIndent(`
-      Read details about a LikeC4 view
-
-      Args:
-        id: View id
-        project: Project name (optional, will use default project if not specified)
-    `),
-    paramsSchema: {
-      id: z.string().min(1),
-      project: z.string().optional()
-    }
-  };
-})(LikeC4MCPTools || (LikeC4MCPTools = {}));
-export class DefaultLikeC4MCPTools {
-  constructor(services) {
-    this.services = services;
-    this.languageServices = services.likec4.LanguageServices;
-  }
-  languageServices;
-  async listProjects() {
-    const projects = await this.languageServices.projects();
-    const response = [];
-    for (const project of projects) {
-      if (!project.documents) {
-        continue;
-      }
-      response.push(
-        `<likec4project>`,
-        `id: "${project.id}"`,
-        `folder: ${project.folder.toString()}`,
-        "sources:",
-        ...project.documents.map((d) => `- ${d.toString()}`),
-        ""
-      );
-      try {
-        const model = await this.languageServices.computedModel(project.id);
-        const elements = [...model.elements()];
-        if (elements.length > 0) {
-          response.push(
-            "elements:",
-            ...elements.flatMap((el) => [
-              `- id: ${el.id}`,
-              `  kind: ${el.kind}`,
-              `  title: ${singleLine(el.title)}`,
-              ""
-            ]),
-            ""
-          );
-        }
-        const views = [...model.views()];
-        if (views.length > 0) {
-          response.push(
-            "views:",
-            ...views.flatMap((v) => [
-              `- id: ${v.id}`,
-              `  title: ${singleLine(v.title)}`,
-              ""
-            ]),
-            ""
-          );
-        }
-      } catch (error) {
-        logger.error(loggable(error));
-      }
-      response.push(`</likec4project>`);
-    }
-    if (response.length === 0) {
-      response.push(
-        `<likec4project>`,
-        `id: "default"`,
-        `folder: ${this.languageServices.workspaceUri.toString()}`,
-        `</likec4project>`
-      );
-    }
-    return response.join("\n");
-  }
-  async readProjectSummary(_project) {
-    const projectId = _project ?? ProjectsManager.DefaultProjectId;
-    const project = this.languageServices.projects().find((p) => p.id === projectId);
-    if (!project) {
-      return "Project not found";
-    }
-    const model = await this.languageServices.computedModel(project.id);
-    const response = [
-      `project: "${project.id}"`,
-      `folder: ${project.folder.toString()}`
-    ];
-    if (project.documents) {
-      response.push(
-        "sources:",
-        ...project.documents.map((d) => `- ${d.toString()}`),
-        ""
-      );
-    }
-    response.push("<specifications>");
-    const elementKinds = Object.keys(model.$model.specification.elements);
-    if (elementKinds.length > 0) {
-      response.push(
-        "element kinds:",
-        ...elementKinds.map((kind) => `- ${kind}`),
-        ""
-      );
-    }
-    const relationshipKinds = Object.keys(model.$model.specification.relationships);
-    if (relationshipKinds.length > 0) {
-      response.push(
-        "relationship kinds:",
-        ...relationshipKinds.map((kind) => `- ${kind}`),
-        ""
-      );
-    }
-    const deploymentKinds = Object.keys(model.$model.specification.deployments);
-    if (deploymentKinds.length > 0) {
-      response.push(
-        "deployment node kinds:",
-        ...deploymentKinds.map((kind) => `- ${kind}`),
-        ""
-      );
-    }
-    const tags = model.tags;
-    if (tags.length > 0) {
-      response.push(
-        "tags:",
-        ...tags.map((t) => `- ${t}`),
-        ""
-      );
-    }
-    response.push(
-      "</specifications>",
-      ""
-    );
-    response.push(
-      "<elements>",
-      ...outputEach(model.elements(), "No elements", (el) => [
-        `- id: ${el.id}`,
-        ...el.parent ? [
-          `  parentId: ${el.parent.id}`
-        ] : [],
-        `  kind: ${el.kind}`,
-        `  shape: ${el.shape}`,
-        `  title: ${singleLine(el.title)}`,
-        `  description: ${singleLine(el.description)}`,
-        `  technology: ${singleLine(el.technology)}`,
-        `  tags: ${JSON.stringify(el.tags)}`,
-        ""
-      ]),
-      "</elements>",
-      "<views>",
-      ...outputEach(model.views(), "No views", (v) => [
-        `- id: ${v.id}`,
-        `  viewType: ${v[_type]}`,
-        `  title: ${singleLine(v.title)}`,
-        ""
-      ]),
-      "</views>"
-    );
-    return response.join("\n");
-  }
-  async searchElement(params) {
-    const search = params.search.toLowerCase();
-    const found = [];
-    for (const project of this.languageServices.projects()) {
-      try {
-        const model = await this.languageServices.computedModel(project.id);
-        const elements = [...model.elements()].filter((el) => el.title.toLowerCase().includes(search));
-        if (elements.length > 0) {
-          found.push(
-            "<project>",
-            `project: "${project.id}"`,
-            "found:",
-            ...elements.flatMap((el) => [
-              `- id: ${el.id}`,
-              `  kind: ${el.kind}`,
-              `  title: ${singleLine(el.title)}`,
-              ""
-            ]),
-            "</project>"
-          );
-        }
-      } catch (error) {
-        logger.error(loggable(error));
-      }
-    }
-    return found.length > 0 ? found.join("\n") : "No elements with this name found";
-  }
-  async readElement(params) {
-    const projectId = params.project ?? ProjectsManager.DefaultProjectId;
-    const project = this.languageServices.projects().find((p) => p.id === projectId);
-    if (!project) {
-      return `Project "${projectId}" not found`;
-    }
-    const model = await this.languageServices.computedModel(project.id);
-    const element = model.findElement(params.id);
-    if (!element) {
-      return `Element "${params.id}" not found in project "${projectId}"`;
-    }
-    return JSON.stringify(elementResource(this.languageServices, element, project.id));
-  }
-  async readView(params) {
-    const projectId = params.project ?? ProjectsManager.DefaultProjectId;
-    const project = this.languageServices.projects().find((p) => p.id === projectId);
-    if (!project) {
-      return `Project "${projectId}" not found`;
-    }
-    const model = await this.languageServices.computedModel(project.id);
-    const view = model.findView(params.id);
-    if (!view) {
-      return `View "${params.id}" not found in project "${projectId}"`;
-    }
-    return JSON.stringify(modelViewResource(this.languageServices, view, project.id));
-  }
-}