@likec4/language-server 1.47.0 → 1.48.0

package/dist/lsp/SemanticTokenProvider.js

@@ -1,305 +0,0 @@
-import { isAnyOf, nonNullable } from '@likec4/core/utils';
-import { DocumentState } from 'langium';
-import { AbstractSemanticTokenProvider, } from 'langium/lsp';
-import { isTruthy } from 'remeda';
-import { CancellationToken, } from 'vscode-languageserver-protocol';
-import { SemanticTokenModifiers, SemanticTokenTypes, } from 'vscode-languageserver-types';
-import { ast } from '../ast';
-import { logger as rootLogger } from '../logger';
-const logger = rootLogger.getChild('SemanticTokenProvider');
-const SemanticTypes = { ...SemanticTokenTypes };
-const SemanticModifiers = { ...SemanticTokenModifiers };
-function createSemanticTypeMethods(applyHighlight) {
-    const modifier = [];
-    const self = new Proxy({}, {
-        get(_, prop) {
-            if (prop === 'modifier') {
-                return (mod) => {
-                    modifier.push(mod);
-                    return self;
-                };
-            }
-            if (prop in SemanticModifiers) {
-                modifier.push(SemanticModifiers[prop]);
-                return self;
-            }
-            if (prop in SemanticTypes) {
-                return () => applyHighlight(SemanticTypes[prop], modifier);
-            }
-            throw new Error(`Unknown semantic token type or modifier: ${prop}`);
-        },
-    });
-    return self;
-}
-const PRUNE = 'Stop Highlighting';
-/**
- * Used to stop further highlighting for the current node (processing of its children
- */
-const stopHighlight = () => {
-    throw PRUNE;
-};
-export class LikeC4SemanticTokenProvider extends AbstractSemanticTokenProvider {
-    services;
-    rules = [];
-    constructor(services) {
-        super(services);
-        this.services = services;
-        this.initRules();
-    }
-    initRules() {
-        this.rules = [];
-        const when = (predicate, highlightFn) => {
-            const rule = { predicate, highlightFn };
-            this.rules.push(rule);
-        };
-        when(ast.isRelationshipKind, mark => {
-            mark.property('name').function();
-        });
-        when(isAnyOf(ast.isRelation, ast.isOutgoingRelationExpr, ast.isDeploymentRelation), mark => {
-            mark.property('kind').function();
-        });
-        when(ast.isLibIcon, mark => {
-            mark.property('name').definition.function();
-            stopHighlight();
-        });
-        when(isAnyOf(ast.isNavigateToProperty, ast.isRelationNavigateToProperty), mark => {
-            mark.property('value').readonly.definition.interface();
-            stopHighlight();
-        });
-        when(ast.isWildcardExpression, mark => {
-            mark.cst().readonly.definition.variable();
-            stopHighlight();
-        });
-        when(ast.isFqnRefExpr, mark => {
-            if (!mark.node.selector) {
-                return;
-            }
-            if (mark.node.ref.parent) {
-                mark.property('selector').property();
-            }
-            else {
-                mark.property('selector').readonly.definition.variable();
-            }
-        });
-        when(ast.isTagRef, mark => {
-            mark.cst().type();
-            stopHighlight();
-        });
-        when(ast.isRelationKindDotRef, mark => {
-            mark.cst().function();
-            stopHighlight();
-        });
-        when(ast.isWhereRelationKind, mark => {
-            if (isTruthy(mark.node.value)) {
-                mark.property('value').function();
-            }
-        });
-        when(isAnyOf(ast.isWhereElement, ast.isWhereRelation), mark => {
-            if (isTruthy(mark.node.value)) {
-                mark.property('value').readonly.definition.type();
-            }
-        });
-        when(isAnyOf(ast.isWhereRelationParticipantKind, ast.isWhereRelationParticipantTag), mark => {
-            mark.property('participant').keyword();
-        });
-        when(ast.isElementKindExpression, mark => {
-            if (isTruthy(mark.node.kind)) {
-                mark.property('kind').definition.type();
-            }
-        });
-        when(isAnyOf(ast.isGlobalStyleGroup, ast.isGlobalStyle), mark => {
-            mark.property('id').readonly.definition.variable();
-        });
-        when(ast.isViewRuleGlobalStyle, mark => {
-            mark.property('style').readonly.definition.variable();
-        });
-        when(isAnyOf(ast.isGlobalPredicateGroup, ast.isGlobalDynamicPredicateGroup), mark => {
-            mark.property('name').readonly.definition.variable();
-        });
-        when(ast.isViewRuleGlobalPredicateRef, mark => {
-            mark.property('predicate').readonly.definition.variable();
-        });
-        when(ast.isElementTagExpression, mark => {
-            if (isTruthy(mark.node.tag)) {
-                mark.property('tag').definition.type();
-            }
-        });
-        when(isAnyOf(ast.isFqnRef, ast.isStrictFqnRef), mark => {
-            if (!mark.node.parent) {
-                mark.property('value').readonly.definition.variable();
-                stopHighlight();
-            }
-            else {
-                mark.property('value').property();
-            }
-        });
-        when(ast.isStrictFqnElementRef, mark => {
-            if (!mark.node.parent) {
-                mark.property('el').readonly.definition.variable();
-                stopHighlight();
-            }
-            else {
-                mark.property('el').property();
-            }
-        });
-        when(ast.isSpecificationColor, mark => {
-            mark.keyword('color').keyword();
-            mark.property('name').readonly.declaration.type();
-        });
-        when(ast.isSpecificationTag, mark => {
-            if (isTruthy(mark.node.color)) {
-                mark.keyword('color').property();
-            }
-        });
-        when(isAnyOf(ast.isSpecificationElementKind, ast.isSpecificationRelationshipKind, ast.isSpecificationDeploymentNodeKind), mark => {
-            mark.property('kind').readonly.declaration.type();
-        });
-        when(ast.isTag, mark => {
-            mark.property('name').definition.type();
-        });
-        when(ast.isOpacityProperty, mark => {
-            mark.property('value').number();
-        });
-        when(ast.isIconProperty, mark => {
-            if (mark.node.libicon || mark.node.value === 'none') {
-                mark.property(mark.node.libicon ? 'libicon' : 'value').defaultLibrary.enum();
-                return;
-            }
-            mark.property('value').string();
-        });
-        when(ast.isLinkProperty, mark => {
-            if (isTruthy(mark.node.value)) {
-                mark.property('value').string();
-            }
-        });
-        when(ast.isColorProperty, mark => {
-            if (isTruthy(mark.node.customColor)) {
-                mark.property('customColor').enum();
-            }
-            if (isTruthy(mark.node.themeColor)) {
-                mark.property('themeColor').enum();
-            }
-        });
-        when(isAnyOf(ast.isShapeProperty, ast.isArrowProperty, ast.isLineProperty, ast.isBorderProperty, ast.isSizeProperty, ast.isDynamicViewDisplayVariantProperty), mark => {
-            if (isTruthy(mark.node.value)) {
-                mark.property('value').enum();
-            }
-        });
-    }
-    async semanticHighlight(document, params, cancelToken = CancellationToken.None) {
-        if (document.state < DocumentState.Linked) {
-            await this.ensureState(document, cancelToken);
-        }
-        return await super.semanticHighlight(document, params, cancelToken);
-    }
-    async semanticHighlightRange(document, params, cancelToken = CancellationToken.None) {
-        if (document.state < DocumentState.Linked) {
-            await this.ensureState(document, cancelToken);
-        }
-        return await super.semanticHighlightRange(document, params, cancelToken);
-    }
-    async semanticHighlightDelta(document, params, cancelToken = CancellationToken.None) {
-        if (document.state < DocumentState.Linked) {
-            await this.ensureState(document, cancelToken);
-        }
-        return await super.semanticHighlightDelta(document, params, cancelToken);
-    }
-    async ensureState(document, cancelToken) {
-        if (document.state < DocumentState.Linked) {
-            logger.debug `waiting for document ${document.uri.path} to be ${'Linked'}`;
-            await this.services.shared.workspace.DocumentBuilder.waitUntil(DocumentState.Linked, document.uri, cancelToken);
-            logger.debug `document ${document.uri.path} is ${'Linked'}`;
-        }
-    }
-    highlightElement(node, acceptor) {
-        if (isAnyOf(ast.isElement, ast.isDeploymentNode, ast.isDeployedInstance)(node)) {
-            return this.highlightNameAndKind(node);
-        }
-        if (ast.isLikeC4View(node)) {
-            return this.highlightView(node);
-        }
-        if (ast.isAnyProperty(node) &&
-            !isAnyOf(ast.isMetadataProperty, ast.isElementStyleProperty, ast.isRelationStyleProperty)(node) &&
-            isTruthy(node.key)) {
-            acceptor({
-                node,
-                property: 'key',
-                type: SemanticTokenTypes.property,
-            });
-        }
-        let m;
-        for (const { predicate, highlightFn } of this.rules) {
-            if (predicate(node)) {
-                try {
-                    m ??= this.mark(node);
-                    highlightFn(m);
-                }
-                catch (error) {
-                    if (error === PRUNE) {
-                        return 'prune';
-                    }
-                    logger.warn(`Error highlighting node of type ${node._type}`, { error });
-                }
-            }
-        }
-    }
-    highlightNameAndKind(node) {
-        const mark = this.mark(node);
-        mark.property('name').declaration.readonly.variable();
-        if (!ast.isDeployedInstance(node)) {
-            this.mark(node).property('kind').keyword();
-        }
-        if (ast.isElement(node)) {
-            if (node.props.length > 0) {
-                this.mark(node).property('props').string();
-            }
-            return;
-        }
-        // This is DeploymentNode
-        if (node.title) {
-            this.mark(node).property('title').string();
-        }
-    }
-    highlightView(node) {
-        if (node.name) {
-            const mark = this.mark(node);
-            mark.property('name')
-                .modifier('local')
-                .declaration
-                .readonly
-                .interface();
-        }
-    }
-    mark(node) {
-        const cst = (cstNode) => {
-            return createSemanticTypeMethods((type, modifier) => this.highlightToken({
-                range: nonNullable(cstNode ?? node.$cstNode, 'AST node has no CST node').range,
-                type,
-                modifier,
-            }));
-        };
-        const keyword = (keyword) => {
-            return createSemanticTypeMethods((type, modifier) => this.highlightKeyword({
-                node,
-                keyword,
-                type,
-                modifier,
-            }));
-        };
-        const property = (property, index) => {
-            return createSemanticTypeMethods((type, modifier) => this.highlightProperty({
-                node,
-                property,
-                type,
-                modifier,
-                ...(index !== undefined ? { index } : {}),
-            }));
-        };
-        return {
-            node,
-            cst,
-            keyword,
-            property,
-        };
-    }
-}

package/dist/lsp/index.d.ts

@@ -1,8 +0,0 @@
-export * from './CodeLensProvider';
-export * from './CompletionProvider';
-export * from './DocumentHighlightProvider';
-export * from './DocumentLinkProvider';
-export * from './DocumentSymbolProvider';
-export * from './HoverProvider';
-export * from './CodeActionProvider';
-export * from './SemanticTokenProvider';

package/dist/lsp/index.js

@@ -1,9 +0,0 @@
-export * from './CodeLensProvider';
-export * from './CompletionProvider';
-export * from './DocumentHighlightProvider';
-export * from './DocumentLinkProvider';
-export * from './DocumentSymbolProvider';
-export * from './HoverProvider';
-// export * from './RenameProvider'
-export * from './CodeActionProvider';
-export * from './SemanticTokenProvider';

package/dist/mcp/MCPServerFactory.d.ts

@@ -1,8 +0,0 @@
-import type { ServerOptions } from '@modelcontextprotocol/sdk/server/index.js';
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { LikeC4Services } from '../module';
-export declare class LikeC4MCPServerFactory {
-    private services;
-    constructor(services: LikeC4Services);
-    create(options?: ServerOptions): McpServer;
-}

package/dist/mcp/MCPServerFactory.js

@@ -1,73 +0,0 @@
-import { loggable } from '@likec4/log';
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import packageJson from '../../package.json' with { type: 'json' };
-import { logger } from '../logger';
-import { findRelationships } from './tools/find-relationships';
-import { listProjects } from './tools/list-projects';
-import { openView } from './tools/open-view';
-import { readDeployment } from './tools/read-deployment';
-import { readElement } from './tools/read-element';
-import { readProjectSummary } from './tools/read-project-summary';
-import { readView } from './tools/read-view';
-import { searchElement } from './tools/search-element';
-export class LikeC4MCPServerFactory {
-    services;
-    constructor(services) {
-        this.services = services;
-    }
-    create(options) {
-        const isInEditor = this.services.shared.lsp.Connection !== undefined;
-        const mcp = new McpServer({
-            name: 'LikeC4',
-            version: packageJson.version,
-        }, {
-            instructions: `LikeC4 MCP – query and navigate LikeC4 models.
-
-Conventions:
-- All tools are read-only and idempotent.
-- "project" is optional and defaults to "default".
-
-Available tools:
-- list-projects — List all LikeC4 projects in the workspace.
-- read-project-summary — Project specification (element kinds, deployment node kinds, tags, metadata keys), all elements, deployment nodes and views. Input: { project? }.
-- search-element — Search elements and deployment nodes across all projects by id/title/kind/shape/tags/metadata. Input: { search }.
-- read-element — Full element details including relationships, includedInViews, deployedInstances, metadata and sourceLocation. Input: { id, project? }.
-- read-deployment — Details of a deployment node or deployed instance. Input: { id, project? }.
-- read-view — Full view details (nodes/edges) and sourceLocation. Input: { viewId, project? }.
-- find-relationships — Direct and indirect relationships between two elements in a project. Input: { element1, element2, project? }.
-${isInEditor
-                ? '- open-view — Opens the LikeC4 view panel in the editor. Triggers UI; at most one preview panel at a time. Input: { viewId, project? }.'
-                : ''}
-
-Instructions:
-- Identify the project first  
-  - Use "search-element" to find elements by id/title/kind/shape/tags/metadata and select the project
-  - Use "read-project-summary" to find all elements and deployment nodes inside the project, what kinds, tags, metadata keys are available
-  - Use "list-projects" to list all available projects
-- If response returns "sourceLocation", provide link to this location in the editor
-
-Full documentation: https://likec4.dev/llms-full.txt
-`,
-            enforceStrictCapabilities: true,
-            ...options,
-            capabilities: {
-                tools: {},
-                ...options?.capabilities,
-            },
-        });
-        mcp.registerTool(...listProjects(this.services.likec4.LanguageServices));
-        mcp.registerTool(...readProjectSummary(this.services.likec4.LanguageServices));
-        mcp.registerTool(...readElement(this.services.likec4.LanguageServices));
-        mcp.registerTool(...readDeployment(this.services.likec4.LanguageServices));
-        mcp.registerTool(...readView(this.services.likec4.LanguageServices));
-        mcp.registerTool(...searchElement(this.services.likec4.LanguageServices));
-        mcp.registerTool(...findRelationships(this.services.likec4.LanguageServices));
-        if (isInEditor) {
-            mcp.registerTool(...openView(this.services.likec4.LanguageServices));
-        }
-        mcp.server.onerror = (err) => {
-            logger.error(loggable(err));
-        };
-        return mcp;
-    }
-}

package/dist/mcp/NoopLikeC4MCPServer.d.ts

@@ -1,9 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { LikeC4MCPServer } from './interfaces';
-export declare class NoopLikeC4MCPServer implements LikeC4MCPServer {
-    get mcp(): McpServer;
-    get isStarted(): boolean;
-    get port(): number;
-    start(): Promise<void>;
-    stop(): Promise<void>;
-}

package/dist/mcp/NoopLikeC4MCPServer.js

@@ -1,17 +0,0 @@
-export class NoopLikeC4MCPServer {
-    get mcp() {
-        throw new Error('NoopLikeC4MCPServer does not have a McpServer');
-    }
-    get isStarted() {
-        return false;
-    }
-    get port() {
-        return NaN;
-    }
-    start() {
-        return Promise.resolve();
-    }
-    stop() {
-        return Promise.resolve();
-    }
-}

package/dist/mcp/interfaces.d.ts

@@ -1,13 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { LikeC4Services } from '../module';
-export interface LikeC4MCPServer {
-    readonly mcp: McpServer;
-    readonly isStarted: boolean;
-    readonly port: number;
-    start(port?: number): Promise<void>;
-    stop(): Promise<void>;
-}
-export interface LikeC4MCPServerModuleContext {
-    mcpServer: (services: LikeC4Services) => LikeC4MCPServer;
-}
-export declare const NoMCPServer: LikeC4MCPServerModuleContext;

package/dist/mcp/interfaces.js

@@ -1,4 +0,0 @@
-import { NoopLikeC4MCPServer } from './NoopLikeC4MCPServer';
-export const NoMCPServer = {
-    mcpServer: () => new NoopLikeC4MCPServer(),
-};

package/dist/mcp/server/StdioLikeC4MCPServer.d.ts

@@ -1,16 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { AsyncDisposable } from 'langium';
-import type { LikeC4Services } from '../../module';
-import type { LikeC4MCPServer } from '../interfaces';
-export declare class StdioLikeC4MCPServer implements LikeC4MCPServer, AsyncDisposable {
-    private services;
-    private transport;
-    private _mcp;
-    constructor(services: LikeC4Services);
-    get mcp(): McpServer;
-    get isStarted(): boolean;
-    get port(): number;
-    dispose(): Promise<void>;
-    start(): Promise<void>;
-    stop(): Promise<void>;
-}

package/dist/mcp/server/StdioLikeC4MCPServer.js

@@ -1,51 +0,0 @@
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { logger } from '../utils';
-export class StdioLikeC4MCPServer {
-    services;
-    transport = undefined;
-    _mcp = undefined;
-    constructor(services) {
-        this.services = services;
-    }
-    get mcp() {
-        if (!this._mcp) {
-            throw new Error('MCP server is not started');
-        }
-        return this._mcp;
-    }
-    get isStarted() {
-        return this.transport !== undefined;
-    }
-    get port() {
-        return NaN;
-    }
-    async dispose() {
-        await this.stop();
-    }
-    async start() {
-        if (this.transport) {
-            return;
-        }
-        logger.info('Starting MCP stdio server');
-        this._mcp = this.services.mcp.ServerFactory.create();
-        this.transport = new StdioServerTransport();
-        await this._mcp.connect(this.transport);
-        logger.info('LikeC4 MCP Server running on stdio');
-    }
-    async stop() {
-        if (!this.transport) {
-            return;
-        }
-        try {
-            logger.info('Stopping MCP stdio server');
-            await this.transport.close();
-            if (this._mcp) {
-                await this._mcp.close();
-            }
-        }
-        finally {
-            this._mcp = undefined;
-            this.transport = undefined;
-        }
-    }
-}

package/dist/mcp/server/StreamableLikeC4MCPServer.d.ts

@@ -1,16 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { AsyncDisposable } from 'langium';
-import type { LikeC4Services } from '../../module';
-import type { LikeC4MCPServer } from '../interfaces';
-export declare class StreamableLikeC4MCPServer implements LikeC4MCPServer, AsyncDisposable {
-    private services;
-    private _port;
-    private server;
-    constructor(services: LikeC4Services, _port?: number);
-    get mcp(): McpServer;
-    get isStarted(): boolean;
-    get port(): number;
-    dispose(): Promise<void>;
-    start(port?: number): Promise<void>;
-    stop(): Promise<void>;
-}

package/dist/mcp/server/StreamableLikeC4MCPServer.js

@@ -1,121 +0,0 @@
-import { serve } from '@hono/node-server';
-import { loggable } from '@likec4/log';
-import { WebStandardStreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js';
-import { Hono } from 'hono';
-import { cors } from 'hono/cors';
-import { nanoid } from 'nanoid';
-import { logger } from '../utils';
-async function createHonoApp(factory) {
-    const mcp = factory.create();
-    const transport = new WebStandardStreamableHTTPServerTransport({
-        sessionIdGenerator: () => nanoid(),
-    });
-    const app = new Hono();
-    // Enable CORS for all origins
-    app.use('*', cors({
-        origin: '*',
-        allowHeaders: ['Content-Type', 'mcp-session-id', 'Last-Event-ID', 'mcp-protocol-version'],
-        exposeHeaders: ['mcp-session-id', 'mcp-protocol-version'],
-    }));
-    // Health check endpoint
-    app.get('/health', c => c.json({ status: 'ok' }));
-    // MCP endpoint
-    app.all('/mcp', c => transport.handleRequest(c.req.raw));
-    app.notFound((c) => {
-        logger.debug(`${c.req.method} ${c.req.url} not found`);
-        return c.json({
-            jsonrpc: '2.0',
-            error: {
-                code: -32000,
-                message: 'Method not found.',
-            },
-            id: null,
-        }, { status: 404 });
-    });
-    app.onError((e, c) => {
-        logger.error(loggable(e));
-        return c.json({
-            jsonrpc: '2.0',
-            error: {
-                code: -32603,
-                message: 'Internal server error',
-            },
-            id: null,
-        }, { status: 500 });
-    });
-    await mcp.connect(transport);
-    return app;
-}
-async function startServer(params) {
-    const { factory, port } = params;
-    const app = await createHonoApp(factory);
-    return new Promise((resolve, reject) => {
-        const server = serve({
-            fetch: app.fetch,
-            hostname: '0.0.0.0',
-            port,
-        })
-            .prependOnceListener('error', reject)
-            .prependOnceListener('listening', () => {
-            server.removeListener('error', reject);
-            resolve(server.unref());
-        });
-    });
-}
-export class StreamableLikeC4MCPServer {
-    services;
-    _port;
-    // Store transports by session ID to send notifications
-    server = undefined;
-    constructor(services, _port = 33335) {
-        this.services = services;
-        this._port = _port;
-    }
-    get mcp() {
-        throw new Error('StreamableLikeC4MCPServer has access to McpServer only during the request');
-    }
-    get isStarted() {
-        return this.server?.listening === true;
-    }
-    get port() {
-        return this._port;
-    }
-    async dispose() {
-        await this.stop();
-    }
-    async start(port = this._port) {
-        if (this.server) {
-            if (this.port === port) {
-                return;
-            }
-            await this.stop();
-        }
-        logger.info('Starting MCP server on port {port}', { port });
-        this._port = port;
-        this.server = await startServer({
-            factory: this.services.mcp.ServerFactory,
-            port,
-        });
-        logger.info('MCP server ready at http://0.0.0.0:{port}/mcp', { port });
-    }
-    stop() {
-        const server = this.server;
-        if (!server) {
-            logger.info('MCP server is not running, nothing to stop');
-            return Promise.resolve();
-        }
-        logger.info('Stopping MCP server');
-        this.server = undefined;
-        return new Promise((resolve) => {
-            server.close((err) => {
-                if (err) {
-                    logger.error('Failed to stop MCP server', { err });
-                }
-                else {
-                    logger.info('MCP server stopped');
-                }
-                resolve();
-            });
-        });
-    }
-}

package/dist/mcp/server/WithMCPServer.d.ts

@@ -1,4 +0,0 @@
-import type { LikeC4MCPServerModuleContext } from '../interfaces';
-export declare const WithMCPServer: (type?: "stdio" | "sse" | {
-    port: number;
-}) => LikeC4MCPServerModuleContext;