@svg-toolkit/svg-language-server 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kaj Kowalski
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,28 @@
+# svg-language-server
+
+[![NPM](https://img.shields.io/npm/v/svg-language-server?logo=npm&labelColor=CB3837&color=black)](https://npm.im/svg-language-server)
+
+LSP server for SVG: diagnostics, completions, hover, formatting, and references.
+
+```sh
+npm install -g svg-language-server                 # unscoped
+npm install -g @svg-toolkit/svg-language-server    # same package, scoped
+svg-language-server --version                      # `svg-ls` works too
+```
+
+Both names ship byte-identical content; pick whichever you like. Or grab the
+whole toolkit at once with
+[`@kjanat/svg-toolkit`](https://npm.im/@kjanat/svg-toolkit).
+
+The package resolves a prebuilt native binary for your platform via
+`optionalDependencies` — no postinstall step, no install-time network access.
+The server speaks LSP over stdio; point your editor's LSP client at the
+`svg-language-server` executable.
+
+At runtime the server fetches fresh browser-compat data on startup by default
+(degrading cleanly to the baked catalog when offline). Set the
+`svg.runtime_compat: false` initialization option to keep sessions fully
+offline.
+
+Editor setup, supported diagnostics, and configuration options:
+<https://github.com/kjanat/svg#readme>

package/bin/svg-language-server.mjs

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import launch from "#launch";
+launch("svg-language-server");

package/lib/launch.mjs

@@ -0,0 +1,32 @@
+import { resolveBinary } from '#resolve';
+import { spawnSync } from 'node:child_process';
+import process from 'node:process';
+
+const { argv, exit, stderr } = process;
+
+/** @param {string} name */
+export default function launch(name) {
+	try {
+		const result = spawnSync(resolveBinary(name), argv.slice(2), {
+			stdio: 'inherit',
+			windowsHide: false,
+		});
+		if (result.error) throw result.error;
+		// Child died from a signal (SIGINT, SIGTERM, …).
+		// Re-raise it on ourselves so the parent shell sees `WIFSIGNALED` / exit
+		// code 128 + N instead of a generic 1 — `set -e`, trap handlers,
+		// and Ctrl+C chaining all depend on this. POSIX-only: Windows has no
+		// signal exit semantics (result.signal is effectively never set there,
+		// and re-raising would abort with an unrelated code), so fall through
+		// to the generic failure exit instead.
+		if (result.signal && process.platform !== 'win32') {
+			process.removeAllListeners(result.signal);
+			process.kill(process.pid, result.signal);
+			return;
+		}
+		exit(result.status ?? 1);
+	} catch (err) {
+		stderr.write(`${name}: ${err instanceof Error ? err.message : String(err)}\n`);
+		exit(1);
+	}
+}

package/lib/resolve.mjs

@@ -0,0 +1,73 @@
+import { bold, cyan, link, red, yellow } from 'ansispeck';
+import { existsSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { arch, platform } from 'node:process';
+
+const require = createRequire(import.meta.url);
+// repository.url (canonical `git+<url>.git` form) and bugs.url are stamped
+// into every published facade by build-packages.ts from Cargo.toml's
+// `repository`; the strip below undoes exactly that stamped decoration.
+const { optionalDependencies, name: pkgName, repository, bugs } = require('#pkg');
+
+const repo = repository.url.replace(/^git\+/, '').replace(/\.git$/, '');
+const issues = bugs.url;
+const subPackages = Object.keys(optionalDependencies || {});
+
+/**
+ * Locate the prebuilt executable matching the current platform and architecture.
+ *
+ * Searches optional-dependency sub-packages for a matching `bin/<exe>` and returns its filesystem path.
+ * If no candidate is found, an explanatory error message is written to stderr and an `Error` is thrown.
+ *
+ * @param {string} name - Base name of the executable (without platform-specific extension).
+ * @returns {string} The filesystem path to the resolved executable.
+ * @throws {Error} If no suitable binary is found for the current platform and architecture.
+ */
+export function resolveBinary(name) {
+	const exe = platform === 'win32' ? `${name}.exe` : name;
+	const errors = [];
+	for (const subPkg of subPackages) {
+		let pkgJsonPath;
+		try {
+			pkgJsonPath = require.resolve(`${subPkg}/package.json`);
+		} catch (err) {
+			errors.push(`${subPkg}: ${err instanceof Error ? err.message : String(err)}`);
+			continue;
+		}
+		const binPath = join(dirname(pkgJsonPath), 'bin', exe);
+		// `require.resolve` proves the package.json exists, not the binary.
+		// Could mismatch if a user manually deletes the bin, or a partial
+		// install half-succeeded. Prefer a clear error here over an opaque
+		// `ENOENT` from `spawnSync` later in `launch.mjs`.
+		if (!existsSync(binPath)) {
+			errors.push(`${subPkg}: package present but bin missing at ${binPath}`);
+			continue;
+		}
+		return binPath;
+	}
+
+	const detail = errors.length > 0
+		? '\n\nDetails of attempted resolutions:\n  - ' + errors.join('\n  - ')
+		: '';
+
+	const indent = '  ';
+
+	const errorText = `${red(pkgName)}: no prebuilt binary found for ${yellow(`${platform}-${arch}`)}.
+
+This usually means your package manager skipped ${cyan('optionalDependencies')}
+(common with ${cyan('--no-optional')}, ${cyan('--omit=optional')}, or some Docker/CI setups).
+
+Workarounds:
+${indent}- reinstall without: ${cyan('--no-optional')} / ${cyan('--omit=optional')}
+${indent}- bun + ${cyan('minimumReleaseAge')}: add the platform packages (not just ${bold(pkgName)}) to ${
+		cyan('minimumReleaseAgeExcludes')
+	} — a fresh release is otherwise age-gated
+${indent}- install from source: ${cyan(`cargo install --git=${repo}/ ${name}`)}
+${indent}- file an issue if your platform is unsupported: ${link(issues, issues)}${detail}
+`;
+
+	console.error(errorText);
+
+	throw new Error('No prebuilt binary found for the current platform and architecture.');
+}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@svg-toolkit/svg-language-server",
+  "description": "LSP server for SVG: diagnostics, completions, hover, formatting, and references.",
+  "keywords": [
+    "svg",
+    "lsp",
+    "language-server",
+    "diagnostics",
+    "completions",
+    "formatter",
+    "linter",
+    "ansispeck"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kjanat/svg.git"
+  },
+  "type": "module",
+  "imports": {
+    "#launch": "./lib/launch.mjs",
+    "#pkg": "./package.json",
+    "#resolve": "./lib/resolve.mjs"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    "./bin/*": "./bin/*"
+  },
+  "bin": {
+    "svg-language-server": "bin/svg-language-server.mjs",
+    "svg-ls": "bin/svg-language-server.mjs"
+  },
+  "directories": {
+    "lib": "./lib"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "ansispeck": "^0.1.2"
+  },
+  "optionalDependencies": {
+    "@svg-toolkit/language-server-linux-x64-gnu": "0.1.1",
+    "@svg-toolkit/language-server-linux-x64-musl": "0.1.1",
+    "@svg-toolkit/language-server-linux-arm64-gnu": "0.1.1",
+    "@svg-toolkit/language-server-linux-arm64-musl": "0.1.1",
+    "@svg-toolkit/language-server-darwin-x64": "0.1.1",
+    "@svg-toolkit/language-server-darwin-arm64": "0.1.1",
+    "@svg-toolkit/language-server-win32-x64-msvc": "0.1.1",
+    "@svg-toolkit/language-server-win32-arm64-msvc": "0.1.1",
+    "@svg-toolkit/language-server-linux-armv7-gnueabihf": "0.1.1",
+    "@svg-toolkit/language-server-linux-armv7-musleabihf": "0.1.1",
+    "@svg-toolkit/language-server-linux-ia32-gnu": "0.1.1",
+    "@svg-toolkit/language-server-linux-ia32-musl": "0.1.1",
+    "@svg-toolkit/language-server-win32-ia32-msvc": "0.1.1",
+    "@svg-toolkit/language-server-linux-riscv64-gnu": "0.1.1",
+    "@svg-toolkit/language-server-linux-ppc64-gnu": "0.1.1",
+    "@svg-toolkit/language-server-linux-s390x-gnu": "0.1.1",
+    "@svg-toolkit/language-server-freebsd-x64": "0.1.1",
+    "@svg-toolkit/language-server-freebsd-arm64": "0.1.1",
+    "@svg-toolkit/language-server-netbsd-x64": "0.1.1",
+    "@svg-toolkit/language-server-linux-loong64-gnu": "0.1.1"
+  },
+  "license": "MIT",
+  "author": "Kaj Kowalski <info@kajkowalski.nl>",
+  "homepage": "https://github.com/kjanat/svg/tree/HEAD/crates/svg-language-server",
+  "bugs": {
+    "url": "https://github.com/kjanat/svg/issues"
+  },
+  "version": "0.1.1"
+}