@likec4/language-services 1.50.0 → 1.52.0

package/dist/_chunks/configureLogger.mjs

@@ -0,0 +1,19 @@
+import { configureLanguageServerLogger } from "@likec4/language-server";
+import { isColorSupported } from "std-env";
+function configureLogger(options) {
+	const opt = options?.configureLogger ?? "console";
+	if (opt === false) return;
+	if (opt === "stderr" || options?.mcp === "stdio") {
+		configureLanguageServerLogger({
+			useStdErr: true,
+			colors: false,
+			logLevel: options?.logLevel
+		});
+		return;
+	}
+	configureLanguageServerLogger({
+		colors: isColorSupported,
+		logLevel: options?.logLevel
+	});
+}
+export { configureLogger as t };

package/dist/_chunks/createFromSources.mjs

@@ -1,5 +1,4 @@
 import { loggable, rootLogger } from "@likec4/log";
-import defu from "defu";
 import { extname } from "pathe";
 import k from "tinyrainbow";
 import { LikeC4ProjectConfigOps, isLikeC4JsonConfig } from "@likec4/config";
@@ -147,6 +146,23 @@ Please specify a project folder`);
 			sib.dispose();
 		};
 	}
+	/**
+	* Formats documents and returns a map of document URI → formatted source text.
+	*
+	* Target selection uses union semantics:
+	* - Omit both `projects` and `documentUris` to format **all** documents.
+	* - Provide `projects` to include all documents from those projects.
+	* - Provide `documentUris` to include specific documents.
+	* - Provide both to format the **union** (deduplicated).
+	*/
+	async format(options) {
+		const { projects, ...rest } = options ?? {};
+		const formatOptions = {
+			...rest,
+			...projects && { projectIds: projects.map((p) => this.projectsManager.ensureProjectId(p)) }
+		};
+		return await this.languageServices.format(formatOptions);
+	}
 	async dispose() {
 		await this.languageServices.dispose();
 	}
@@ -154,18 +170,22 @@ Please specify a project folder`);
 		await this.dispose();
 	}
 };
+const DefaultInitOptions = {
+	printErrors: true,
+	throwIfInvalid: false,
+	graphviz: "wasm",
+	mcp: false,
+	configureLogger: false,
+	logLevel: void 0
+};
 const validationErrorsToError = (likec4) => /* @__PURE__ */ new Error(`Invalid model:\n${likec4.getErrors().map((e) => `  ${e.sourceFsPath}:${e.line} ${e.message.slice(0, 200)}`).join("\n")}`);
 async function handleInitOptions(langium, logger = rootLogger, options) {
 	const likec4 = new LikeC4(langium, logger);
-	const opts = defu(options, {
-		printErrors: true,
-		throwIfInvalid: false
-	});
-	if (opts.throwIfInvalid === true && likec4.hasErrors()) {
+	if ((options?.throwIfInvalid ?? DefaultInitOptions.throwIfInvalid) === true && likec4.hasErrors()) {
 		await likec4.dispose();
 		return Promise.reject(validationErrorsToError(likec4));
 	}
-	if (opts.printErrors !== false && likec4.hasErrors()) likec4.printErrors();
+	if ((options?.printErrors ?? DefaultInitOptions.printErrors) && likec4.hasErrors()) likec4.printErrors();
 	return likec4;
 }
 /**
@@ -209,4 +229,4 @@ async function createFromSources(langium, logger, sources, initOptions) {
 	await langium.shared.workspace.DocumentBuilder.build(docs, { validation: true });
 	return handleInitOptions(langium, logger, initOptions);
 }
-export { handleInitOptions as n, LikeC4 as r, createFromSources as t };
+export { LikeC4 as i, handleInitOptions as n, DefaultInitOptions as r, createFromSources as t };

package/dist/_chunks/options.d.mts

@@ -1,7 +1,7 @@
 import { Logger } from "@likec4/log";
+import { LikeC4LanguageServices, LikeC4ModelBuilder, LikeC4Services, LikeC4SharedServices, LikeC4Views, ProjectsManager } from "@likec4/language-server";
 import { LikeC4Model } from "@likec4/core/model";
 import { LayoutedView, NonEmptyArray, ProjectId } from "@likec4/core/types";
-import { LikeC4LanguageServices, LikeC4ModelBuilder, LikeC4Services, LikeC4SharedServices, LikeC4Views, ProjectsManager } from "@likec4/language-server";
 
 //#region src/common/LikeC4.d.ts
 interface LikeC4Langium {
@@ -81,12 +81,43 @@ declare class LikeC4 {
    * @returns a function to dispose the listener
    */
   onModelUpdate(listener: () => void): () => void;
+  /**
+   * Formats documents and returns a map of document URI → formatted source text.
+   *
+   * Target selection uses union semantics:
+   * - Omit both `projects` and `documentUris` to format **all** documents.
+   * - Provide `projects` to include all documents from those projects.
+   * - Provide `documentUris` to include specific documents.
+   * - Provide both to format the **union** (deduplicated).
+   */
+  format(options?: LikeC4FormatOptions): Promise<Map<string, string>>;
   dispose(): Promise<void>;
   [Symbol.asyncDispose](): Promise<void>;
 }
+/**
+ * Options for {@link LikeC4.format}.
+ *
+ * Same as {@link FormatOptions} but uses project name strings instead of {@link ProjectId}.
+ */
+interface LikeC4FormatOptions {
+  /** Include all documents from these projects (by name). */
+  projects?: ReadonlyArray<string>;
+  /** Include these specific documents (by URI string). */
+  documentUris?: ReadonlyArray<string>;
+  /** Size of a tab in spaces (default: 2). */
+  tabSize?: number;
+  /** Prefer spaces over tabs (default: true). */
+  insertSpaces?: boolean;
+  /** Trim trailing whitespace on a line. */
+  trimTrailingWhitespace?: boolean;
+  /** Insert a newline character at the end of the file if one does not exist. */
+  insertFinalNewline?: boolean;
+  /** Trim all newlines after the final newline at the end of the file. */
+  trimFinalNewlines?: boolean;
+}
 //#endregion
 //#region src/common/options.d.ts
-type InitOptions = {
+interface InitOptions {
   /**
    * By default, if LikeC4 model is invalid, errors are printed to the console.
    * Disable this behavior by setting this option to false.
@@ -115,7 +146,22 @@ type InitOptions = {
   mcp?: false | 'stdio' | {
     port: number;
   };
-};
+  /**
+   * Whether to configure the logger.
+   *
+   * - `false` - don't configure the logger
+   * - `'console'` - configure the logger with console sink
+   * - `'stderr'` - configure the logger with stderr (for LSP or MCP)
+   *
+   * @default false
+   */
+  configureLogger?: false | 'console' | 'stderr';
+  /**
+   * The log level to use.
+   * Applied if {@link configureLogger} is not `false`
+   */
+  logLevel?: 'trace' | 'debug' | 'info' | 'warning' | 'error' | undefined;
+}
 type FromWorkspaceOptions = InitOptions & {
   /**
    * Whether to read and use manual layouts from the workspace.

package/dist/node/index.mjs

@@ -1,14 +1,16 @@
-import { n as handleInitOptions, r as LikeC4, t as createFromSources } from "../_chunks/createFromSources.mjs";
+import { i as LikeC4, n as handleInitOptions, r as DefaultInitOptions, t as createFromSources } from "../_chunks/createFromSources.mjs";
+import { t as configureLogger$1 } from "../_chunks/configureLogger.mjs";
 import { memoizeProp } from "@likec4/core";
-import { configureLogger, getConsoleStderrSink, loggable, rootLogger } from "@likec4/log";
+import { loggable, rootLogger } from "@likec4/log";
 import defu from "defu";
 import { basename, resolve } from "pathe";
 import k from "tinyrainbow";
+import { withTrailingSlash } from "ufo";
 import { pathToFileURL } from "url";
 import { WithFileSystem, WithLikeC4ManualLayouts } from "@likec4/language-server/filesystem";
 import { WithMCPServer } from "@likec4/language-server/mcp";
-import { NoFileSystem, NoLikeC4ManualLayouts, createLanguageServices } from "@likec4/language-server/module";
-import { GraphvizWasmAdapter, QueueGraphvizLayoter } from "@likec4/layouts";
+import { NoFileSystem, NoLikeC4ManualLayouts, WithGraphviz, createLanguageServices } from "@likec4/language-server/module";
+import { GraphvizWasmAdapter } from "@likec4/layouts";
 import { GraphvizBinaryAdapter } from "@likec4/layouts/graphviz/binary";
 function createLanguageServices$1(opts) {
 	const logger = rootLogger.getChild("lang");
@@ -19,15 +21,6 @@ function createLanguageServices$1(opts) {
 		graphviz: "wasm",
 		mcp: false
 	});
-	if (options.mcp === "stdio") configureLogger({
-		reset: true,
-		sinks: { console: getConsoleStderrSink() },
-		loggers: [{
-			category: "likec4",
-			sinks: ["console"],
-			lowestLevel: "warning"
-		}]
-	});
 	const useDotBin = options.graphviz === "binary";
 	logger.info(`${k.dim("layout")} ${useDotBin ? "binary" : "wasm"}`);
 	const langium = createLanguageServices({
@@ -38,8 +31,9 @@ function createLanguageServices$1(opts) {
 			...NoFileSystem,
 			...NoLikeC4ManualLayouts
 		},
-		...options.mcp ? WithMCPServer(options.mcp === "stdio" ? "stdio" : options.mcp) : {}
-	}, { likec4: { Layouter: () => new QueueGraphvizLayoter({ graphviz: useDotBin ? new GraphvizBinaryAdapter() : new GraphvizWasmAdapter() }) } });
+		...options.mcp ? WithMCPServer(options.mcp === "stdio" ? "stdio" : options.mcp) : {},
+		...WithGraphviz(useDotBin ? new GraphvizBinaryAdapter() : new GraphvizWasmAdapter())
+	});
 	if (typeof options.mcp === "object" && options.mcp.port) langium.likec4.mcp.Server.start(options.mcp.port).catch((e) => {
 		logger.error(loggable(e));
 	});
@@ -57,12 +51,13 @@ function createLanguageServices$1(opts) {
 * @returns A Promise that resolves to a LikeC4 instance
 */
 async function fromWorkspace(path, options) {
+	configureLogger$1(options);
 	const workspacePath = resolve(path);
-	const folderUri = pathToFileURL(workspacePath).toString();
-	const workspaceUri = folderUri.endsWith("/") ? folderUri : folderUri + "/";
+	const workspaceUri = withTrailingSlash(pathToFileURL(workspacePath).toString());
 	return memoizeProp(globalThis, "likec4:" + workspacePath, async () => {
 		const logger = rootLogger.getChild("lang");
 		const langium = createLanguageServices$1(defu(options, {
+			...DefaultInitOptions,
 			useFileSystem: true,
 			manualLayouts: true,
 			watch: false,
@@ -115,8 +110,10 @@ async function fromWorkdir(options) {
 * @returns A Promise that resolves to a LikeC4 instance
 */
 async function fromSources(sources, options) {
+	configureLogger$1(options);
 	const logger = rootLogger.getChild("lang");
 	return await createFromSources(createLanguageServices$1(defu(options, {
+		...DefaultInitOptions,
 		useFileSystem: false,
 		watch: false,
 		manualLayouts: false,

package/dist/node/without-mcp/index.mjs

@@ -1,4 +1,5 @@
-import { n as handleInitOptions, r as LikeC4, t as createFromSources } from "../../_chunks/createFromSources.mjs";
+import { i as LikeC4, n as handleInitOptions, t as createFromSources } from "../../_chunks/createFromSources.mjs";
+import { t as configureLogger$1 } from "../../_chunks/configureLogger.mjs";
 import { memoizeProp } from "@likec4/core";
 import { rootLogger } from "@likec4/log";
 import defu from "defu";
@@ -6,8 +7,8 @@ import { basename, resolve } from "pathe";
 import k from "tinyrainbow";
 import { pathToFileURL } from "url";
 import { WithFileSystem, WithLikeC4ManualLayouts } from "@likec4/language-server/filesystem";
-import { NoFileSystem, NoLikeC4ManualLayouts, createLanguageServices } from "@likec4/language-server/module";
-import { GraphvizWasmAdapter, QueueGraphvizLayoter } from "@likec4/layouts";
+import { NoFileSystem, NoLikeC4ManualLayouts, WithGraphviz, createLanguageServices } from "@likec4/language-server/module";
+import { GraphvizWasmAdapter } from "@likec4/layouts";
 import { GraphvizBinaryAdapter } from "@likec4/layouts/graphviz/binary";
 function createLanguageServices$1(opts) {
 	const logger = rootLogger.getChild("lang");
@@ -19,13 +20,16 @@ function createLanguageServices$1(opts) {
 	});
 	const useDotBin = options.graphviz === "binary";
 	logger.info(`${k.dim("layout")} ${useDotBin ? "binary" : "wasm"}`);
-	return createLanguageServices({ ...options.useFileSystem ? {
-		...WithFileSystem(options.watch),
-		...options.manualLayouts ? WithLikeC4ManualLayouts : NoLikeC4ManualLayouts
-	} : {
-		...NoFileSystem,
-		...NoLikeC4ManualLayouts
-	} }, { likec4: { Layouter: () => new QueueGraphvizLayoter({ graphviz: useDotBin ? new GraphvizBinaryAdapter() : new GraphvizWasmAdapter() }) } });
+	return createLanguageServices({
+		...options.useFileSystem ? {
+			...WithFileSystem(options.watch),
+			...options.manualLayouts ? WithLikeC4ManualLayouts : NoLikeC4ManualLayouts
+		} : {
+			...NoFileSystem,
+			...NoLikeC4ManualLayouts
+		},
+		...WithGraphviz(useDotBin ? new GraphvizBinaryAdapter() : new GraphvizWasmAdapter())
+	});
 }
 /**
 * Create a LikeC4 instance from a workspace directory
@@ -36,6 +40,7 @@ function createLanguageServices$1(opts) {
 * @returns A Promise that resolves to a LikeC4 instance
 */
 async function fromWorkspace(path, options) {
+	configureLogger$1(options);
 	const workspacePath = resolve(path);
 	const folderUri = pathToFileURL(workspacePath).toString();
 	const workspaceUri = folderUri.endsWith("/") ? folderUri : folderUri + "/";
@@ -95,6 +100,7 @@ async function fromWorkdir(options) {
 * @returns A Promise that resolves to a LikeC4 instance
 */
 async function fromSources(sources, options) {
+	configureLogger$1(options);
 	const logger = rootLogger.getChild("lang");
 	return await createFromSources(createLanguageServices$1(defu(options, {
 		useFileSystem: false,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@likec4/language-services",
   "description": "LikeC4 Language Services",
-  "version": "1.50.0",
+  "version": "1.52.0",
   "license": "MIT",
   "bugs": "https://github.com/likec4/likec4/issues",
   "homepage": "https://likec4.dev",
@@ -70,31 +70,32 @@
   },
   "dependencies": {
     "defu": "^6.1.4",
-    "remeda": "^2.33.5",
+    "remeda": "^2.33.6",
     "langium": "3.5.0",
-    "tinyrainbow": "^2.0.0",
+    "tinyrainbow": "^3.0.3",
     "pathe": "^2.0.3",
+    "ufo": "1.6.3",
     "std-env": "^3.10.0",
     "type-fest": "^4.41.0",
     "vscode-languageserver-types": "3.17.5",
-    "@likec4/config": "1.50.0",
-    "@likec4/core": "1.50.0",
-    "@likec4/generators": "1.50.0",
+    "@likec4/config": "1.52.0",
+    "@likec4/core": "1.52.0",
+    "@likec4/generators": "1.52.0",
     "@likec4/icons": "1.46.4",
-    "@likec4/language-server": "1.50.0",
-    "@likec4/log": "1.50.0",
-    "@likec4/layouts": "1.50.0"
+    "@likec4/language-server": "1.52.0",
+    "@likec4/layouts": "1.52.0",
+    "@likec4/log": "1.52.0"
   },
   "devDependencies": {
     "@types/node": "~22.19.11",
     "obuild": "^0.4.31",
     "oxlint": "1.43.0",
     "tsx": "4.21.0",
-    "turbo": "2.8.10",
+    "turbo": "2.8.13",
     "typescript": "5.9.3",
     "vitest": "4.0.18",
     "@likec4/devops": "1.42.0",
-    "@likec4/tsconfig": "1.50.0"
+    "@likec4/tsconfig": "1.52.0"
   },
   "scripts": {
     "typecheck": "tsc -b --verbose",