@markuplint/language-server 0.0.0-stage → 5.1.0

package/lib/utils/resolve-working-directory.js

@@ -0,0 +1,266 @@
+import fs from 'node:fs';
+import path from 'node:path';
+/**
+ * Markuplint configuration file names used for auto-detection.
+ */
+const MARKUPLINT_CONFIG_FILES = [
+    '.markuplintrc',
+    '.markuplintrc.json',
+    '.markuplintrc.yaml',
+    '.markuplintrc.yml',
+    '.markuplintrc.js',
+    '.markuplintrc.cjs',
+    '.markuplintrc.mjs',
+    '.markuplintrc.ts',
+    'markuplint.config.js',
+    'markuplint.config.cjs',
+    'markuplint.config.mjs',
+    'markuplint.config.ts',
+];
+/**
+ * Files that indicate a project root boundary.
+ */
+const ROOT_INDICATOR_FILES = ['package.json', ...MARKUPLINT_CONFIG_FILES];
+/**
+ * Converts a simple glob pattern (supporting `*` and `**`) into a RegExp.
+ *
+ * This is a simplified implementation for matching directory paths against
+ * patterns like `./packages/* /` or `./apps/** /`.
+ *
+ * @param pattern - A glob pattern string (e.g. `"./packages/* /"`)
+ * @returns A RegExp anchored at the start that matches directory paths
+ */
+export function convertGlobToRegex(pattern) {
+    // Normalize and remove trailing slash
+    let normalized = pattern.replaceAll('\\', '/');
+    if (normalized.endsWith('/')) {
+        normalized = normalized.slice(0, -1);
+    }
+    // Escape special regex chars except * and **
+    let regexStr = '';
+    let i = 0;
+    while (i < normalized.length) {
+        const char = normalized[i];
+        if (char === '*') {
+            if (normalized[i + 1] === '*') {
+                regexStr += '.*';
+                i += 2;
+                // Skip optional trailing /
+                if (normalized[i] === '/') {
+                    i++;
+                }
+            }
+            else {
+                regexStr += '[^/]*';
+                i++;
+            }
+        }
+        else if ('.+^${}()|[]\\'.includes(char)) {
+            regexStr += '\\' + char;
+            i++;
+        }
+        else {
+            regexStr += char;
+            i++;
+        }
+    }
+    return new RegExp('^' + regexStr + '(?:/|$)');
+}
+/**
+ * Resolves the working directory for a given file based on workingDirectories configuration.
+ *
+ * @param filePath - Absolute file path of the document being linted
+ * @param workspaceFolders - Workspace folder paths (absolute)
+ * @param workingDirectories - The user-configured working directories
+ * @returns The resolved working directory, or `undefined` to use the default behavior
+ */
+export function resolveWorkingDirectory(filePath, workspaceFolders, workingDirectories) {
+    if (!workingDirectories || workingDirectories.length === 0) {
+        return undefined;
+    }
+    const normalizedFilePath = filePath.replaceAll('\\', '/');
+    let bestMatch;
+    let bestMatchLength = -1;
+    for (const entry of workingDirectories) {
+        if (typeof entry === 'string') {
+            const resolved = resolveDirectoryEntry(entry, workspaceFolders);
+            if (resolved) {
+                const match = matchDirectory(normalizedFilePath, resolved);
+                if (match > bestMatchLength) {
+                    bestMatchLength = match;
+                    bestMatch = { directory: resolved };
+                }
+            }
+            continue;
+        }
+        if ('mode' in entry) {
+            const result = resolveByMode(filePath, workspaceFolders, entry.mode);
+            if (result) {
+                return result;
+            }
+            continue;
+        }
+        if ('directory' in entry) {
+            const resolved = resolveDirectoryEntry(entry.directory, workspaceFolders);
+            if (resolved) {
+                const match = matchDirectory(normalizedFilePath, resolved);
+                if (match > bestMatchLength) {
+                    bestMatchLength = match;
+                    bestMatch = { directory: resolved };
+                }
+            }
+            continue;
+        }
+        if ('pattern' in entry) {
+            const result = resolveByPattern(normalizedFilePath, workspaceFolders, entry.pattern);
+            if (result && result.directory.length > bestMatchLength) {
+                bestMatchLength = result.directory.length;
+                bestMatch = result;
+            }
+        }
+    }
+    return bestMatch;
+}
+/**
+ * Resolves a directory path relative to workspace folders.
+ * Returns the first existing absolute path found.
+ */
+function resolveDirectoryEntry(directory, workspaceFolders) {
+    // If already absolute and exists, use it directly
+    if (path.isAbsolute(directory)) {
+        return directory;
+    }
+    // Resolve relative to each workspace folder
+    for (const folder of workspaceFolders) {
+        const resolved = path.resolve(folder, directory);
+        return resolved;
+    }
+    return undefined;
+}
+/**
+ * Checks if a file path is inside a directory.
+ * Returns the directory path length if matched, -1 otherwise.
+ */
+function matchDirectory(normalizedFilePath, directory) {
+    const normalizedDir = directory.replaceAll('\\', '/');
+    const dirWithSlash = normalizedDir.endsWith('/') ? normalizedDir : normalizedDir + '/';
+    if (normalizedFilePath.startsWith(dirWithSlash)) {
+        return dirWithSlash.length;
+    }
+    return -1;
+}
+/**
+ * Resolves working directory by glob pattern matching against workspace folders.
+ */
+function resolveByPattern(normalizedFilePath, workspaceFolders, pattern) {
+    for (const folder of workspaceFolders) {
+        const normalizedFolder = folder.replaceAll('\\', '/');
+        const fullPattern = pattern.startsWith('./')
+            ? normalizedFolder + pattern.slice(1)
+            : path.posix.join(normalizedFolder, pattern);
+        const regex = convertGlobToRegex(fullPattern);
+        if (regex.test(normalizedFilePath)) {
+            // Extract the matched directory portion
+            const match = regex.exec(normalizedFilePath);
+            if (match) {
+                let matchedDir = match[0];
+                if (matchedDir.endsWith('/')) {
+                    matchedDir = matchedDir.slice(0, -1);
+                }
+                return { directory: matchedDir };
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Resolves working directory by mode ("auto" or "location").
+ */
+function resolveByMode(filePath, workspaceFolders, mode) {
+    if (mode === 'location') {
+        // Use workspace folder path. If a markuplint config is found closer to the file,
+        // use that directory instead.
+        const configDir = findClosestConfigDir(filePath, workspaceFolders);
+        if (configDir) {
+            return { directory: configDir };
+        }
+        // Fall back to workspace folder containing the file
+        for (const folder of workspaceFolders) {
+            const normalizedFolder = folder.replaceAll('\\', '/');
+            const normalizedFilePath = filePath.replaceAll('\\', '/');
+            if (normalizedFilePath.startsWith(normalizedFolder + '/') ||
+                normalizedFilePath.startsWith(normalizedFolder + '\\')) {
+                return { directory: folder };
+            }
+        }
+        return undefined;
+    }
+    // mode === 'auto'
+    // Walk up from the file's directory to find the closest project root
+    // (indicated by package.json or markuplint config files)
+    const autoDir = findAutoWorkingDirectory(filePath, workspaceFolders);
+    if (autoDir) {
+        return { directory: autoDir };
+    }
+    return undefined;
+}
+/**
+ * Finds the closest directory containing a markuplint config file,
+ * walking up from the file's parent directory to the workspace root.
+ */
+function findClosestConfigDir(filePath, workspaceFolders) {
+    const fileDir = path.dirname(filePath);
+    const workspaceRoot = findContainingWorkspace(filePath, workspaceFolders);
+    const stopDir = workspaceRoot ?? path.parse(fileDir).root;
+    let current = fileDir;
+    while (current.length >= stopDir.length) {
+        for (const configFile of MARKUPLINT_CONFIG_FILES) {
+            if (fs.existsSync(path.join(current, configFile))) {
+                return current;
+            }
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            break;
+        }
+        current = parent;
+    }
+    return undefined;
+}
+/**
+ * Finds the closest directory containing a root indicator file (package.json or markuplint config),
+ * walking up from the file's parent directory to the workspace root.
+ * Used by "auto" mode.
+ */
+function findAutoWorkingDirectory(filePath, workspaceFolders) {
+    const fileDir = path.dirname(filePath);
+    const workspaceRoot = findContainingWorkspace(filePath, workspaceFolders);
+    const stopDir = workspaceRoot ?? path.parse(fileDir).root;
+    let current = fileDir;
+    while (current.length >= stopDir.length) {
+        for (const rootFile of ROOT_INDICATOR_FILES) {
+            if (fs.existsSync(path.join(current, rootFile))) {
+                return current;
+            }
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            break;
+        }
+        current = parent;
+    }
+    return undefined;
+}
+/**
+ * Finds the workspace folder that contains the given file path.
+ */
+function findContainingWorkspace(filePath, workspaceFolders) {
+    const normalizedFilePath = filePath.replaceAll('\\', '/');
+    for (const folder of workspaceFolders) {
+        const normalizedFolder = folder.replaceAll('\\', '/');
+        if (normalizedFilePath.startsWith(normalizedFolder + '/')) {
+            return folder;
+        }
+    }
+    return undefined;
+}

package/locales/en.json

@@ -0,0 +1,7 @@
+{
+	"sentences": {
+		"since markuplint could not be found in the node_modules of the workspace, this use the version (v{0}) installed in vs code extension": "Since markuplint could not be found in the node_modules of the workspace, this use the version (v{0}) installed in VS Code Extension",
+		"your local markuplint is incompatible with node.js 22+ due to import assertion syntax. the bundled version (v{0}) is used instead. to use your local version, upgrade to markuplint@4.10.0 or later. see: https://github.com/markuplint/markuplint/issues/2837": "Your local markuplint is incompatible with Node.js 22+ due to import assertion syntax. The bundled version (v{0}) is used instead. To use your local version, upgrade to markuplint@4.10.0 or later. See: https://github.com/markuplint/markuplint/issues/2837",
+		"[suppressed] this warning is suppressed but should be fixed:": "[Suppressed] This warning is suppressed but should be fixed:"
+	}
+}

package/locales/ja.json

@@ -0,0 +1,21 @@
+{
+	"keywords": {
+		"computed accessibility properties": "計算済みアクセシビリティプロパティ",
+		"hidden element": "非表示要素",
+		"no corresponding role": "対応するロールなし",
+		"no exposed to accessibility tree": "アクセシビリティツリーに公開されません",
+		"none": "なし",
+		"prohibited": "禁止",
+		"required": "必須",
+		"unknown": "不明",
+		"undefined": "未定義"
+	},
+	"sentences": {
+		"since markuplint could not be found in the node_modules of the workspace, this use the version (v{0}) installed with the language server": "ワークスペースのnode_modulesにmarkuplintが発見できなかったためこの言語サーバーに同梱されているバージョン(v{0})を利用します",
+		"your local markuplint is incompatible with node.js 22+ due to import assertion syntax. the bundled version (v{0}) is used instead. to use your local version, upgrade to markuplint@4.10.0 or later. see: https://github.com/markuplint/markuplint/issues/2837": "ローカルのmarkuplintはimport assertion構文のためNode.js 22+と互換性がありません。代わりにバンドル版(v{0})を使用しています。ローカル版を使用するにはmarkuplint@4.10.0以降にアップグレードしてください。詳細: https://github.com/markuplint/markuplint/issues/2837",
+		"[suppressed] this warning is suppressed but should be fixed:": "[抑制中] この警告は抑制されていますが、本来は修正すべき問題です:",
+		"parser not found. you probably need to install {0} for documents of language {1}.": "パーサーが見つかりません。言語 {1} の文書には {0} をインストールする必要があります。",
+		"the markuplint bundled with the language server (v{0}) cannot load parsers installed in your workspace. install markuplint and {1} in {2}, then restart the language server so that it can use the local installation.": "言語サーバーにバンドルされたmarkuplint(v{0})はワークスペースにインストールされたパーサーを読み込めません。ローカル版を使えるように、{2} にmarkuplintと{1}をインストールしてから言語サーバーを再起動してください。",
+		"the markuplint bundled with the language server (v{0}) cannot load {1} from {2} because the markuplint installed there is incompatible with node.js 22+. upgrade it to markuplint@4.10.0 or later, then restart the language server.": "言語サーバーにバンドルされたmarkuplint(v{0})は {2} の{1}を読み込めません。そこにインストールされたmarkuplintがNode.js 22+と互換性がないためです。markuplint@4.10.0以降にアップグレードしてから言語サーバーを再起動してください。"
+	}
+}

package/package.json

@@ -1,6 +1,59 @@
 {
-  "name": "@markuplint/language-server",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+	"name": "@markuplint/language-server",
+	"version": "5.1.0",
+	"description": "Language Server Protocol server for markuplint",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/markuplint/markuplint.git",
+		"directory": "packages/@markuplint/language-server"
+	},
+	"author": "Yusuke Hirao <yusukehirao@me.com>",
+	"license": "MIT",
+	"engines": {
+		"node": ">=24"
+	},
+	"type": "module",
+	"exports": {
+		".": {
+			"import": "./lib/index.js",
+			"types": "./lib/index.d.ts"
+		},
+		"./protocol": {
+			"import": "./lib/protocol.js",
+			"types": "./lib/protocol.d.ts"
+		},
+		"./package.json": "./package.json"
+	},
+	"bin": {
+		"markuplint-language-server": "./bin/markuplint-language-server.mjs"
+	},
+	"files": [
+		"bin",
+		"lib",
+		"locales"
+	],
+	"publishConfig": {
+		"access": "public"
+	},
+	"scripts": {
+		"build": "tsc --project tsconfig.build.json",
+		"dev": "tsc --watch --project tsconfig.build.json",
+		"clean": "tsc --build --clean tsconfig.build.json"
+	},
+	"dependencies": {
+		"@markuplint/file-resolver": "5.1.0",
+		"@markuplint/i18n": "5.1.0",
+		"@markuplint/ml-config": "5.1.0",
+		"@markuplint/ml-spec": "5.1.0",
+		"debug": "4.4.3",
+		"markuplint": "5.1.0",
+		"semver": "7.7.4",
+		"vscode-languageserver": "9.0.1",
+		"vscode-languageserver-textdocument": "1.0.12"
+	},
+	"devDependencies": {
+		"@types/debug": "4.1.13",
+		"@types/semver": "7.7.1",
+		"vscode-jsonrpc": "8.2.0"
+	}
+}