@azerothjs/language-server 0.4.0-beta.1 → 0.4.0-beta.2

package/README.md

@@ -35,7 +35,23 @@ back any other host without this package.
 | --- | --- |
 | `server.ts` | LSP wiring: connection, capabilities, document sync, settings, and one handler per request. |
 | `cli.ts` | Executable entry point (`azeroth-language-server`); starts the server over stdio. |
-| `index.ts` | Library entry point; exports `startServer`. |
+| `tsc.ts` | `runTsc`: the batch type-checker behind the `azeroth-tsc` binary. |
+| `tsc-cli.ts` | Executable entry point (`azeroth-tsc`); runs one check and sets the exit code. |
+| `index.ts` | Library entry point; exports `startServer` and `runTsc`. |
+
+### `azeroth-tsc` (command-line type checking)
+
+`tsc` cannot parse `.azeroth`, so this package ships `azeroth-tsc`, the `vue-tsc`
+equivalent. It reuses the language service to compile each `.azeroth` file to its
+virtual TypeScript module, type-check it against the project's tsconfig, and print
+`tsc`-style diagnostics mapped back to the original `.azeroth` positions, exiting
+non-zero on the first error. It is a `--noEmit` gate (the Vite plugin / compiler
+owns code emit), meant to run in CI and pre-commit beside `tsc`:
+
+```sh
+npx azeroth-tsc            # check every .azeroth file under the cwd
+npx azeroth-tsc -p tsconfig.json
+```
 
 ### Settings
 

package/dist/index.d.ts

@@ -1,2 +1,3 @@
 export { startServer } from './server.ts';
+export { runTsc, parseArgs, type TscOptions, type TscResult } from './tsc.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -5,4 +5,5 @@
 // re-exports it so the server can also be embedded (e.g. in a web worker host
 // or an integration test that drives it through an in-memory connection).
 export { startServer } from "./server.js";
+export { runTsc, parseArgs } from "./tsc.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,EAAE;AACF,4EAA4E;AAC5E,gFAAgF;AAChF,8EAA8E;AAC9E,0EAA0E;AAE1E,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,EAAE;AACF,4EAA4E;AAC5E,gFAAgF;AAChF,8EAA8E;AAC9E,0EAA0E;AAE1E,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,SAAS,EAAmC,MAAM,UAAU,CAAC"}

package/dist/tsc-cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=tsc-cli.d.ts.map

package/dist/tsc-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsc-cli.d.ts","sourceRoot":"","sources":["../src/tsc-cli.ts"],"names":[],"mappings":""}

package/dist/tsc-cli.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+// Binary entry point for `azeroth-tsc`. Runs one batch type-check and exits
+// non-zero when any `.azeroth` file has an error, so it drops into CI and
+// pre-commit the same way `tsc --noEmit` does. All behaviour lives in the
+// testable `runTsc`.
+import { runTsc, parseArgs } from "./tsc.js";
+const { errorCount } = runTsc(parseArgs(process.argv.slice(2)));
+process.exit(errorCount > 0 ? 1 : 0);
+//# sourceMappingURL=tsc-cli.js.map

package/dist/tsc-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsc-cli.js","sourceRoot":"","sources":["../src/tsc-cli.ts"],"names":[],"mappings":";AACA,4EAA4E;AAC5E,0EAA0E;AAC1E,0EAA0E;AAC1E,qBAAqB;AAErB,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE7C,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAChE,OAAO,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/tsc.d.ts

@@ -0,0 +1,31 @@
+/** Options controlling a single check run. */
+export interface TscOptions {
+    /** Directory to search for `.azeroth` files (default: cwd). */
+    cwd?: string;
+    /** Explicit tsconfig path; otherwise the nearest one is used. */
+    project?: string;
+    /** Sink for formatted output (default: stdout). */
+    write?: (text: string) => void;
+}
+/** Outcome of a check run. */
+export interface TscResult {
+    /** Number of `.azeroth` files checked. */
+    fileCount: number;
+    /** Number of error-severity diagnostics found. */
+    errorCount: number;
+}
+/** Parses the argv subset this CLI understands into {@link TscOptions}. */
+export declare function parseArgs(argv: string[]): TscOptions;
+/**
+ * Type-checks every `.azeroth` file under `cwd` against the project's tsconfig,
+ * printing `tsc`-style diagnostics. Returns the file/error counts; the caller
+ * decides the process exit code.
+ *
+ * @example
+ * ```ts
+ * const { errorCount } = runTsc({ cwd: 'app' });
+ * process.exit(errorCount > 0 ? 1 : 0);
+ * ```
+ */
+export declare function runTsc(options?: TscOptions): TscResult;
+//# sourceMappingURL=tsc.d.ts.map

package/dist/tsc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsc.d.ts","sourceRoot":"","sources":["../src/tsc.ts"],"names":[],"mappings":"AAcA,8CAA8C;AAC9C,MAAM,WAAW,UAAU;IAEvB,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,mDAAmD;IACnD,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED,8BAA8B;AAC9B,MAAM,WAAW,SAAS;IAEtB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAElB,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,2EAA2E;AAC3E,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAoBpD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,CAAC,OAAO,GAAE,UAAe,GAAG,SAAS,CAiD1D"}

package/dist/tsc.js

@@ -0,0 +1,81 @@
+// azeroth-tsc: a batch type-checker for `.azeroth` files, the vue-tsc
+// equivalent for this framework. `tsc` itself cannot parse `.azeroth` markup,
+// so this driver reuses the language service (which compiles each file to a
+// virtual TypeScript module and maps diagnostics back to original positions)
+// and prints them in the familiar `tsc` format. It is meant to run in CI and
+// pre-commit, alongside `tsc` for the surrounding `.ts`.
+//
+// Scope: this reports type errors in `.azeroth` files. It does not emit `.js`
+// (the Vite plugin / compiler does that) - like `tsc --noEmit`, it is a gate.
+import path from 'node:path';
+import ts from 'typescript';
+import { AzerothLanguageService, pathToUri, DiagnosticSeverity } from '@azerothjs/language-service';
+/** Parses the argv subset this CLI understands into {@link TscOptions}. */
+export function parseArgs(argv) {
+    const options = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg === '--project' || arg === '-p') {
+            options.project = argv[++i];
+        }
+        else if (arg.startsWith('--project=')) {
+            options.project = arg.slice('--project='.length);
+        }
+        else if (!arg.startsWith('-')) {
+            options.cwd = arg;
+        }
+    }
+    return options;
+}
+/**
+ * Type-checks every `.azeroth` file under `cwd` against the project's tsconfig,
+ * printing `tsc`-style diagnostics. Returns the file/error counts; the caller
+ * decides the process exit code.
+ *
+ * @example
+ * ```ts
+ * const { errorCount } = runTsc({ cwd: 'app' });
+ * process.exit(errorCount > 0 ? 1 : 0);
+ * ```
+ */
+export function runTsc(options = {}) {
+    const cwd = path.resolve(options.cwd ?? process.cwd());
+    const write = options.write ?? ((text) => {
+        process.stdout.write(text);
+    });
+    const files = ts.sys.readDirectory(cwd, ['.azeroth'], ['**/node_modules/**', '**/dist/**', '**/.git/**'], ['**/*.azeroth']);
+    const service = new AzerothLanguageService(cwd, options.project);
+    let errorCount = 0;
+    for (const file of files) {
+        const source = ts.sys.readFile(file);
+        if (source === undefined) {
+            continue;
+        }
+        const uri = pathToUri(file);
+        service.didOpen(uri, source);
+        for (const diag of service.getDiagnostics(uri)) {
+            const isError = diag.severity === DiagnosticSeverity.Error;
+            if (isError) {
+                errorCount++;
+            }
+            write(formatDiagnostic(cwd, file, diag, isError) + '\n');
+        }
+    }
+    if (errorCount === 0) {
+        write(`Checked ${files.length} .azeroth file(s); no type errors.\n`);
+    }
+    else {
+        write(`\nFound ${errorCount} error(s) in ${files.length} .azeroth file(s).\n`);
+    }
+    return { fileCount: files.length, errorCount };
+}
+/** Formats one diagnostic in `tsc`'s `file(line,col): error TSxxxx: msg` shape. */
+function formatDiagnostic(cwd, file, diag, isError) {
+    const rel = path.relative(cwd, file).replace(/\\/g, '/');
+    const line = diag.range.start.line + 1;
+    const column = diag.range.start.character + 1;
+    const severity = isError ? 'error' : 'warning';
+    const code = typeof diag.code === 'number' ? ` TS${diag.code}` : '';
+    return `${rel}(${line},${column}): ${severity}${code}: ${diag.message}`;
+}
+//# sourceMappingURL=tsc.js.map

package/dist/tsc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsc.js","sourceRoot":"","sources":["../src/tsc.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@azerothjs/language-server",
-    "version": "0.4.0-beta.1",
+    "version": "0.4.0-beta.2",
     "description": "AzerothJS language server — a Language Server Protocol front-end for .azeroth files",
     "type": "module",
     "main": "./dist/index.js",
@@ -8,7 +8,8 @@
     "types": "./dist/index.d.ts",
     "bin":
     {
-        "azeroth-language-server": "./dist/cli.js"
+        "azeroth-language-server": "./dist/cli.js",
+        "azeroth-tsc": "./dist/tsc-cli.js"
     },
     "exports":
     {
@@ -18,7 +19,8 @@
             "import": "./dist/index.js",
             "default": "./dist/index.js"
         },
-        "./cli": "./dist/cli.js"
+        "./cli": "./dist/cli.js",
+        "./tsc": "./dist/tsc.js"
     },
     "files":
     [
@@ -26,7 +28,7 @@
     ],
     "dependencies":
     {
-        "@azerothjs/language-service": "0.4.0-beta.1",
+        "@azerothjs/language-service": "0.4.0-beta.2",
         "typescript": ">=5",
         "vscode-languageserver": "^9",
         "vscode-languageserver-textdocument": "^1"