@elliots/typical-tsc-plugin 0.2.1 → 0.2.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Elliot Shepherd
+
+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/dist/index.mjs

@@ -2,6 +2,7 @@ import { createRequire } from "node:module";
 import { spawn } from "node:child_process";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
+import { existsSync } from "node:fs";
 import { loadConfig, validateConfig } from "@elliots/typical";
 import deasync from "deasync";
 
@@ -106,15 +107,15 @@ function debugLog(...args) {
 	if (debug) console.error(...args);
 }
 function getBinaryPath() {
-	const pkgName = `@elliots/typical-compiler-${process.platform}-${process.arch}`;
-	try {
-		const pkg = require(pkgName);
-		debugLog(`[CLIENT] Using platform binary from ${pkgName}`);
-		return pkg.binaryPath;
-	} catch {
-		debugLog(`[CLIENT] Platform package ${pkgName} not found, falling back to local bin`);
-		return join(__dirname, "..", "bin", "typical");
+	const devPath = join(__dirname, "../bin/typical");
+	if (existsSync(devPath)) {
+		debugLog(`[CLIENT] Using development binary at ${devPath}`);
+		return devPath;
 	}
+	const pkgName = `@elliots/typical-compiler-${process.platform}-${process.arch}`;
+	const pkg = require(pkgName);
+	debugLog(`[CLIENT] Using platform binary from ${pkgName}`);
+	return pkg.binaryPath;
 }
 var TypicalCompiler = class {
 	process = null;
@@ -175,21 +176,40 @@ var TypicalCompiler = class {
 		await this.request("release", id);
 	}
 	/**
+	* Analyse a file for validation points without transforming it.
+	* Returns information about which parameters, returns, and casts will be validated.
+	* Used by the VSCode extension to show validation indicators.
+	*
+	* @param project - Project handle or ID
+	* @param fileName - Path to the file to analyse
+	* @param content - Optional file content for live updates (uses disk version if not provided)
+	* @param ignoreTypes - Optional glob patterns for types to skip
+	* @returns Analysis result with validation items
+	*/
+	async analyseFile(project, fileName, content, ignoreTypes) {
+		const projectId = typeof project === "string" ? project : project.id;
+		return this.request("analyseFile", {
+			project: projectId,
+			fileName,
+			content,
+			ignoreTypes
+		});
+	}
+	/**
 	* Transform a standalone TypeScript source string.
 	* Creates a temporary project to enable type checking.
 	*
 	* @param fileName - Virtual filename for error messages (e.g., "test.ts")
 	* @param source - TypeScript source code
-	* @param ignoreTypes - Glob patterns for types to skip validation (e.g., ["FieldConfig", "React.*"])
-	* @param maxGeneratedFunctions - Max helper functions before error (0 = default 50)
+	* @param options - Optional transform options
 	* @returns Transformed code with validation
 	*/
-	async transformSource(fileName, source, ignoreTypes, maxGeneratedFunctions) {
+	async transformSource(fileName, source, options) {
 		return this.request("transformSource", {
 			fileName,
 			source,
-			ignoreTypes,
-			maxGeneratedFunctions
+			ignoreTypes: options?.ignoreTypes,
+			maxGeneratedFunctions: options?.maxGeneratedFunctions
 		});
 	}
 	async request(method, payload) {
@@ -235,11 +255,11 @@ var TypicalCompiler = class {
 /**
 * Synchronous wrapper around the async compiler transformFile.
 */
-function transformFileSync(compiler, project, fileName) {
+function transformFileSync(compiler, project, fileName, config) {
 	let result;
 	let error;
 	let done = false;
-	compiler.transformFile(project, fileName).then((res) => {
+	compiler.transformFile(project, fileName, config.ignoreTypes, config.maxGeneratedFunctions).then((res) => {
 		result = res.code;
 		done = true;
 	}, (err) => {
@@ -267,7 +287,7 @@ function transformFileSync(compiler, project, fileName) {
 * }
 */
 function src_default(program, host, _pluginConfig, { ts: tsInstance }) {
-	validateConfig(loadConfig());
+	const config = validateConfig(loadConfig());
 	const compiler = new TypicalCompiler({ cwd: process.cwd() });
 	let projectHandle;
 	let initError;
@@ -287,7 +307,7 @@ function src_default(program, host, _pluginConfig, { ts: tsInstance }) {
 	for (const sourceFile of program.getSourceFiles()) {
 		if (sourceFile.isDeclarationFile || sourceFile.fileName.includes("node_modules")) continue;
 		try {
-			const transformed = transformFileSync(compiler, projectHandle, sourceFile.fileName);
+			const transformed = transformFileSync(compiler, projectHandle, sourceFile.fileName, config);
 			transformedFiles.set(sourceFile.fileName, transformed);
 		} catch (err) {
 			console.error(`[typical] Failed to transform ${sourceFile.fileName}:`, err);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elliots/typical-tsc-plugin",
-  "version": "0.2.1",
+  "version": "0.2.4",
   "description": "TSC plugin for typical - runtime safe TypeScript transformer",
   "keywords": [
     "runtime",
@@ -42,7 +42,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@elliots/typical": "0.2.1",
+    "@elliots/typical": "0.2.4",
     "deasync": "0.1.30",
     "strip-json-comments": "5.0.3"
   },