MATLAB language server - v1.3.9

CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.3.9] - 2026-02-19
+
+### Fixed
+- Resolves an issue starting MATLAB when the `HOME` environment variable is set to an invalid folder (Addresses [mathworks/MATLAB-extension-for-vscode#164](https://github.com/mathworks/MATLAB-extension-for-vscode/issues/164))
+
 ## [1.3.8] - 2026-01-09
 
 ### Added

README.md

@@ -23,8 +23,9 @@ MATLAB language server implements several Language Server Protocol features and
 ## Clients
 MATLAB language server supports these editors by installing the corresponding extension:
 * Emacs - [Emacs-MATLAB-Mode](https://github.com/mathworks/Emacs-MATLAB-Mode)
-* Neovim — [nvim-lspconfig](https://github.com/neovim/nvim-lspconfig)
-* Visual Studio® Code — [MATLAB extension for Visual Studio Code](https://github.com/mathworks/MATLAB-extension-for-vscode)
+* Neovim - [nvim-lspconfig](https://github.com/neovim/nvim-lspconfig)
+* Visual Studio® Code - [MATLAB extension for Visual Studio Code](https://github.com/mathworks/MATLAB-extension-for-vscode)
+* Zed - [MATLAB support for Zed](https://github.com/zed-extensions/matlab)
 
 ## Release Notes
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "matlab-language-server",
-  "version": "1.3.8",
+  "version": "1.3.9",
   "description": "Language Server for MATLAB code",
   "main": "./src/index.ts",
   "bin": "./out/index.js",

src/debug/MatlabDebugAdaptor.ts

@@ -1,10 +1,10 @@
-// Copyright 2025 The MathWorks, Inc.
+// Copyright 2025-2026 The MathWorks, Inc.
 
 import * as debug from '@vscode/debugadapter'
 import { DebugProtocol } from '@vscode/debugprotocol';
 import { DebugServices, BreakpointInfo } from './DebugServices'
 import { ResolvablePromise, createResolvablePromise } from '../utils/PromiseUtils'
-import { IMVM, MVMError, MatlabState } from '../mvm/impl/MVM';
+import { IMVM, MVMError, MatlabMVMConnectionState } from '../mvm/impl/MVM';
 import fs from 'node:fs';
 
 enum BreakpointChangeType {
@@ -92,8 +92,8 @@ export default class MatlabDebugAdaptor {
         this._pendingSetBreakpointPromise = undefined;
         this._pendingTemporaryStackChangePromise = undefined;
 
-        this._mvm.on(IMVM.Events.stateChange, (state: MatlabState) => {
-            if (state === MatlabState.DISCONNECTED) {
+        this._mvm.on(IMVM.Events.stateChange, (state: MatlabMVMConnectionState) => {
+            if (state === MatlabMVMConnectionState.DISCONNECTED) {
                 this._handleDisconnect();
                 this._matlabBreakpoints = [];
             }

src/lifecycle/GraphicsPrewarmService.ts

@@ -1,7 +1,7 @@
-// Copyright 2025 The MathWorks, Inc.
+// Copyright 2025-2026 The MathWorks, Inc.
 
 import Logger from '../logging/Logger';
-import MVM, { IMVM, MatlabState } from '../mvm/impl/MVM';
+import MVM, { IMVM, MatlabMVMConnectionState } from '../mvm/impl/MVM';
 import { ConfigurationManager } from './ConfigurationManager';
 
 /**
@@ -27,10 +27,10 @@ export default class GraphicsPrewarmService {
      *
      * @param state The MVM state
      */
-    private async handleMvmStateChange (state: MatlabState): Promise<void> {
-        if (state === MatlabState.READY) {
+    private async handleMvmStateChange (state: MatlabMVMConnectionState): Promise<void> {
+        if (state === MatlabMVMConnectionState.CONNECTED) {
             await this.handleMatlabConnectionReady()
-        } else if (state === MatlabState.DISCONNECTED) {
+        } else if (state === MatlabMVMConnectionState.DISCONNECTED) {
             // Reset hasPrewarmed flag when MATLAB is disconnected
             this.hasPrewarmed = false
         }

src/lifecycle/PathSynchronizer.ts

@@ -1,12 +1,12 @@
-// Copyright 2024-2025 The MathWorks, Inc.
+// Copyright 2024-2026 The MathWorks, Inc.
 
 import { WorkspaceFolder, WorkspaceFoldersChangeEvent } from 'vscode-languageserver'
 import ClientConnection, { Connection } from '../ClientConnection'
 import Logger from '../logging/Logger'
 import MatlabLifecycleManager from './MatlabLifecycleManager'
 import * as os from 'os'
 import path from 'path'
-import MVM, { IMVM, MatlabState } from '../mvm/impl/MVM'
+import MVM, { IMVM, MatlabMVMConnectionState } from '../mvm/impl/MVM'
 import parse from '../mvm/MdaParser'
 import * as FileNameUtils from '../utils/FileNameUtils'
 
@@ -25,8 +25,8 @@ export default class PathSynchronizer {
     initialize (): void {
         const clientConnection = ClientConnection.getConnection()
 
-        this.mvm.on(IMVM.Events.stateChange, (state: MatlabState) => {
-            if (state === MatlabState.READY) {
+        this.mvm.on(IMVM.Events.stateChange, (state: MatlabMVMConnectionState) => {
+            if (state === MatlabMVMConnectionState.CONNECTED) {
                 void this.handleMatlabConnected(clientConnection)
             }
         })

src/mvm/MVMServer.ts

@@ -1,7 +1,7 @@
-// Copyright 2024-2025 The MathWorks, Inc.
+// Copyright 2024-2026 The MathWorks, Inc.
 
 import NotificationService, { Notification } from '../notifications/NotificationService'
-import MVM, { IMVM, MatlabState, EvalRequest, EvalResponse, FEvalRequest, FEvalResponse, BreakpointRequest, PromptState } from './impl/MVM'
+import MVM, { IMVM, MatlabMVMConnectionState, EvalRequest, EvalResponse, FEvalRequest, FEvalResponse, BreakpointRequest, PromptState } from './impl/MVM'
 
 /**
  * Provides an interface for sending evals and fevals and listening to the results.
@@ -32,7 +32,7 @@ export default class MVMServer {
         this._mvm.on(IMVM.Events.promptChange, this._handlePromptChange.bind(this));
     }
 
-    private _handleMvmStateChange (state: MatlabState, release?: string): void {
+    private _handleMvmStateChange (state: MatlabMVMConnectionState, release?: string): void {
         this._notificationService.sendNotification(Notification.MVMStateChange, { state, release });
     }
 

src/mvm/impl/MVM.d.ts

@@ -6,10 +6,9 @@ export * from './MVMInterface';
 /**
  * Used to represent the state of MATLAB
  */
-export declare enum MatlabState {
+export declare enum MatlabMVMConnectionState {
     DISCONNECTED = "disconnected",
-    READY = "ready",
-    BUSY = "busy"
+    CONNECTED = "connected"
 }
 /**
  * Provides an interface for sending evals and fevals and listening to the results.

src/server.ts

@@ -15,7 +15,7 @@ import LintingSupportProvider from './providers/linting/LintingSupportProvider'
 import ExecuteCommandProvider, { MatlabLSCommands } from './providers/lspCommands/ExecuteCommandProvider'
 import NavigationSupportProvider from './providers/navigation/NavigationSupportProvider'
 import LifecycleNotificationHelper from './lifecycle/LifecycleNotificationHelper'
-import MVM, { IMVM, MatlabState } from './mvm/impl/MVM'
+import MVM, { IMVM, MatlabMVMConnectionState } from './mvm/impl/MVM'
 import FoldingSupportProvider from './providers/folding/FoldingSupportProvider'
 import ClientConnection from './ClientConnection'
 import PathResolver from './providers/navigation/PathResolver'
@@ -87,8 +87,8 @@ export async function startServer (): Promise<void> {
         hasMatlabBeenRequested = false
     })
 
-    mvm.on(IMVM.Events.stateChange, (state: MatlabState) => {
-        if (state === MatlabState.READY) {
+    mvm.on(IMVM.Events.stateChange, (state: MatlabMVMConnectionState) => {
+        if (state === MatlabMVMConnectionState.CONNECTED) {
             // Handle when the MVM has connected
             mvm.feval('matlabls.utils.startupHelper', 0, [])
 

tests/lifecycle/GraphicsPrewarmService.test.ts

@@ -1,11 +1,11 @@
-// Copyright 2025 The MathWorks, Inc.
+// Copyright 2025-2026 The MathWorks, Inc.
 import assert from 'assert'
 import sinon from 'sinon'
 
 import getMockMvm from '../mocks/Mvm.mock'
 import getMockConfigurationManager from '../mocks/ConfigurationManager.mock'
 
-import { IMVM, MatlabState } from '../../src/mvm/impl/MVM'
+import { IMVM, MatlabMVMConnectionState } from '../../src/mvm/impl/MVM'
 
 import GraphicsPrewarmService from '../../src/lifecycle/GraphicsPrewarmService'
 
@@ -29,7 +29,7 @@ describe('GraphicsPrewarmService', () => {
         const graphicsPrewarmService = new GraphicsPrewarmService(mockMvm, mockConfigurationManager)
         assert.ok(!graphicsPrewarmService.hasPrewarmed, 'Should not have prewarmed yet')
 
-        mockMvm._emitEvent(IMVM.Events.stateChange, MatlabState.READY)
+        mockMvm._emitEvent(IMVM.Events.stateChange, MatlabMVMConnectionState.CONNECTED)
 
         // Wait for async operations to resolve
         await new Promise(resolve => setTimeout(resolve, 0))
@@ -46,7 +46,7 @@ describe('GraphicsPrewarmService', () => {
         const graphicsPrewarmService = new GraphicsPrewarmService(mockMvm, mockConfigurationManager)
         assert.ok(!graphicsPrewarmService.hasPrewarmed, 'Should not have prewarmed yet')
 
-        mockMvm._emitEvent(IMVM.Events.stateChange, MatlabState.READY)
+        mockMvm._emitEvent(IMVM.Events.stateChange, MatlabMVMConnectionState.CONNECTED)
 
         sinon.assert.notCalled(mockMvm.feval)
         assert.ok(!graphicsPrewarmService.hasPrewarmed, 'Still should not have prewarmed because setting is disabled')
@@ -68,7 +68,7 @@ describe('GraphicsPrewarmService', () => {
         const graphicsPrewarmService = new GraphicsPrewarmService(mockMvm, mockConfigurationManager)
         assert.ok(!graphicsPrewarmService.hasPrewarmed, 'Should not have prewarmed yet')
 
-        mockMvm._emitEvent(IMVM.Events.stateChange, MatlabState.READY)
+        mockMvm._emitEvent(IMVM.Events.stateChange, MatlabMVMConnectionState.CONNECTED)
 
         // Wait for async operations to resolve
         await new Promise(resolve => setTimeout(resolve, 0))
@@ -84,7 +84,7 @@ describe('GraphicsPrewarmService', () => {
         const graphicsPrewarmService = new GraphicsPrewarmService(mockMvm, mockConfigurationManager)
         assert.ok(!graphicsPrewarmService.hasPrewarmed, 'Should not have prewarmed yet')
 
-        mockMvm._emitEvent(IMVM.Events.stateChange, MatlabState.READY)
+        mockMvm._emitEvent(IMVM.Events.stateChange, MatlabMVMConnectionState.CONNECTED)
 
         // Wait for async operations to resolve
         await new Promise(resolve => setTimeout(resolve, 0))
@@ -100,7 +100,7 @@ describe('GraphicsPrewarmService', () => {
         const graphicsPrewarmService = new GraphicsPrewarmService(mockMvm, mockConfigurationManager)
         graphicsPrewarmService.hasPrewarmed = true // Manually set prewarmed status
 
-        mockMvm._emitEvent(IMVM.Events.stateChange, MatlabState.READY)
+        mockMvm._emitEvent(IMVM.Events.stateChange, MatlabMVMConnectionState.CONNECTED)
 
         // Wait for async operations to resolve
         await new Promise(resolve => setTimeout(resolve, 0))
@@ -116,7 +116,7 @@ describe('GraphicsPrewarmService', () => {
         const graphicsPrewarmService = new GraphicsPrewarmService(mockMvm, mockConfigurationManager)
         graphicsPrewarmService.hasPrewarmed = true // Manually set prewarmed status
 
-        mockMvm._emitEvent(IMVM.Events.stateChange, MatlabState.DISCONNECTED)
+        mockMvm._emitEvent(IMVM.Events.stateChange, MatlabMVMConnectionState.DISCONNECTED)
 
         // Wait for async operations to resolve
         await new Promise(resolve => setTimeout(resolve, 0))