@zirkelc/typecheck 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Chris
+
+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,43 @@
+# @zirkelc/typecheck
+
+TypeScript type checker for monorepo packages. Runs `tsc --noEmit` using the TypeScript compiler API and filters out diagnostics from files outside the current package directory.
+
+This solves the problem of [internal packages](https://turborepo.dev/docs/core-concepts/internal-packages) exporting raw `.ts` files:
+
+> Errors in internal dependencies will be reported: When directly exporting TypeScript, type-checking in a dependent package will fail if code in an internal dependency has TypeScript errors. You may find this confusing or problematic in some situations.
+
+## Install
+
+```sh
+pnpm add -D @zirkelc/typecheck
+```
+
+## Usage
+
+Add a script to your monorepo packages `package.json`:
+
+```json
+{
+  "scripts": {
+    "typecheck": "typecheck"
+  }
+}
+```
+
+Then run in your monorepo packages:
+
+```sh
+# Uses tsconfig.json by default
+pnpm typecheck
+
+# Use a custom tsconfig
+pnpm typecheck --project tsconfig.build.json
+```
+
+## How it works
+
+1. Reads the `tsconfig.json` (or `--project` target) in `process.cwd()`
+2. Creates a `ts.Program` and collects all diagnostics via `ts.getPreEmitDiagnostics()`
+3. Filters diagnostics: only keeps errors where the source file is inside the current directory
+4. Formats remaining errors with colors and code context using `ts.formatDiagnosticsWithColorAndContext()`
+5. Exits with code 1 if local errors exist, 0 otherwise

package/dist/typecheck.mjs

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+import * as path from "node:path";
+import * as ts from "typescript";
+
+//#region src/typecheck.ts
+const cwd = process.cwd();
+const isCI = process.env.GITHUB_ACTIONS === `true`;
+const formatHost = {
+	getCanonicalFileName: (f) => f,
+	getCurrentDirectory: () => cwd,
+	getNewLine: () => ts.sys.newLine
+};
+/** Parse --project flag, default to tsconfig.json */
+const projectArgIndex = process.argv.indexOf(`--project`);
+const tsconfigName = projectArgIndex !== -1 ? process.argv[projectArgIndex + 1] : `tsconfig.json`;
+/** Find and parse tsconfig */
+const configPath = ts.findConfigFile(cwd, ts.sys.fileExists, tsconfigName);
+if (!configPath) {
+	console.error(`Could not find ${tsconfigName} in ${cwd}`);
+	process.exit(1);
+}
+const configFile = ts.readConfigFile(configPath, ts.sys.readFile);
+if (configFile.error) {
+	console.error(ts.formatDiagnosticsWithColorAndContext([configFile.error], formatHost));
+	process.exit(1);
+}
+const parsed = ts.parseJsonConfigFileContent(configFile.config, ts.sys, cwd);
+/** Create program and collect diagnostics */
+const program = ts.createProgram(parsed.fileNames, parsed.options);
+const diagnostics = ts.getPreEmitDiagnostics(program);
+/**
+* Filter: keep only diagnostics from files inside cwd.
+* Use cwd + path.sep to avoid /packages/api matching /packages/api-chat.
+* Diagnostics without a file (global/config errors) are always kept.
+*/
+const cwdPrefix = cwd + path.sep;
+const filtered = diagnostics.filter((d) => {
+	if (!d.file) return true;
+	return path.resolve(d.file.fileName).startsWith(cwdPrefix);
+});
+const externalCount = diagnostics.length - filtered.length;
+if (filtered.length > 0) {
+	if (isCI) for (const d of filtered) {
+		const message = ts.flattenDiagnosticMessageText(d.messageText, ` `);
+		if (d.file && d.start !== void 0) {
+			const { line, character } = d.file.getLineAndCharacterOfPosition(d.start);
+			const relPath = path.relative(cwd, d.file.fileName);
+			console.log(`::error file=${relPath},line=${line + 1},col=${character + 1}::TS${d.code}: ${message}`);
+		} else console.log(`::error ::TS${d.code}: ${message}`);
+	}
+	console.log(ts.formatDiagnosticsWithColorAndContext(filtered, formatHost));
+	const parts = [`Found ${filtered.length} error(s)`];
+	if (externalCount > 0) parts.push(`(${externalCount} external error(s) filtered)`);
+	console.log(parts.join(` `));
+	process.exit(1);
+}
+if (externalCount > 0) console.log(`No errors in current package. ${externalCount} external error(s) filtered from dependencies.`);
+else console.log(`No errors found.`);
+
+//#endregion
+export {  };

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@zirkelc/typecheck",
+  "version": "1.0.0",
+  "description": "Typecheck for Monorepos",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "bin": {
+    "typecheck": "./dist/typecheck.mjs"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [],
+  "author": "Chris Cook",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zirkelc/typecheck"
+  },
+  "peerDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.2",
+    "@biomejs/biome": "^2.3.14",
+    "@total-typescript/tsconfig": "^1.0.4",
+    "@types/node": "^25.2.0",
+    "husky": "^9.1.7",
+    "pkg-pr-new": "^0.0.63",
+    "publint": "^0.3.17",
+    "tsdown": "^0.20.3",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "exports": {
+    ".": "./dist/typecheck.mjs",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest",
+    "lint": "biome check . --write"
+  }
+}