ref: set checkJs globally to true

Author: TkDodo

eslint.config.mjs

@@ -1,4 +1,3 @@
-// @ts-check
 /**
  * To get started with this ESLint Configuration list be sure to read at least
  * these sections of the docs:

scripts/extract-android-device-names.js

@@ -1,9 +1,16 @@
 'use strict';
 
+// @ts-expect-error csv-parser has no types
 const csv = require('csv-parser');
 const fs = require('node:fs');
 
+/**
+ * Transform CSV results into device mapping object
+ * @param {Array<{name: string, model: string}>} res - Array of device objects
+ * @returns {Record<string, string>} Device mapping where key is model and value is name
+ */
 const transformResults = res => {
+  /** @type {Record<string, string>} */
   const deviceMapping = {};
   res.forEach(({name, model}) => {
     if (name && model) {
@@ -12,10 +19,11 @@ const transformResults = res => {
   });
   return deviceMapping;
 };
+/** @type {Array<{name: string, model: string}>} */
 const results = [];
 fs.createReadStream('supported_devices.csv')
   .pipe(csv())
-  .on('data', data => results.push(data))
+  .on('data', /** @param {any} data */ data => results.push(data))
   .on('end', () => {
     fs.writeFileSync('devices.json', JSON.stringify(transformResults(results)));
   });

tests/js/jest-pegjs-transform.js

@@ -3,6 +3,15 @@
 const nodeCrypto = require('node:crypto');
 const peggy = require('peggy');
 
+/**
+ * Generate cache key for Jest transformer
+ * @param {string} fileData - The file content to transform
+ * @param {string} _filePath - Path to the file (unused)
+ * @param {Object} config - Jest configuration object
+ * @param {string} config.configString - Stringified Jest config
+ * @param {Object} _options - Transform options (unused)
+ * @returns {string} MD5 hash for cache key
+ */
 function getCacheKey(fileData, _filePath, config, _options) {
   return nodeCrypto
     .createHash('md5')
@@ -11,6 +20,11 @@ function getCacheKey(fileData, _filePath, config, _options) {
     .digest('hex');
 }
 
+/**
+ * Transform PEG.js grammar file into JavaScript module
+ * @param {string} sourceText - The PEG.js grammar source code
+ * @returns {{code: string}} Transform result with generated JavaScript module code
+ */
 function process(sourceText) {
   return {
     code: `module.exports = ${peggy.generate(sourceText, {output: 'source'})}`,

tests/js/test-balancer/index.js

@@ -3,12 +3,20 @@
 const fs = require('node:fs');
 const path = require('node:path');
 
+/**
+ * Jest balance reporter that writes test timing data to a JSON file
+ * @param {Object} results - Jest test results object
+ * @param {boolean} results.success - Whether all tests passed
+ * @param {Array<{testFilePath: string, perfStats: {runtime: number}}>} results.testResults - Array of test result objects
+ * @returns {Object} The original results object
+ */
 module.exports = results => {
   if (!results.success) {
     throw new Error('Balance reporter requires all tests to succeed.');
   }
 
   const cwd = process.cwd();
+  /** @type {Record<string, number>} */
   const testValues = {};
 
   for (const test of results.testResults) {

tsconfig.json

@@ -1,7 +1,8 @@
 {
   "extends": "./config/tsconfig.base.json",
   "compilerOptions": {
-    "allowJs": true
+    "allowJs": true,
+    "checkJs": true,
   },
   "include": [
     "*.config.mjs",