tsconfig.json

{
  "compilerOptions": {
    "target": "ESNext",
    "useDefineForClassFields": true,
    "lib": ["DOM", "DOM.Iterable", "ESNext"],
    "allowJs": false,
    // ts-node needs this to load webpack.config.ts for some reason. Errs otherwise
    // https://webpack.js.org/configuration/configuration-languages/#typescript
    // Using a separate config file just for webpack.config.ts by using environment variable
    // TS_NODE_PROJECT was making tsconfig-paths-webpack-plugin use the other config, not this
    // original tsconfig.json, so these path aliases wouldn't work
    "esModuleInterop": true,
    "allowSyntheticDefaultImports": true,
    "strict": true,
    "forceConsistentCasingInFileNames": true,
    // Paranext requires modules to be CommonJS
    // Running webpack.config.ts also requires CommonJS
    // https://webpack.js.org/configuration/configuration-languages/#typescript
    "module": "CommonJS",
    "moduleResolution": "Node",
    "resolveJsonModule": true,
    "noEmit": true,
    "jsx": "react-jsx",
    "typeRoots": [
      // Include default type declarations
      "node_modules/@types",
      // Include papi-dts type declarations (for papi.d.ts)
      "../paranext-core/lib",
      // Include core extensions' type declarations
      "../paranext-core/extensions/src",
      // Include this extension's type declarations. It's in this location so there aren't any
      // unexpected files there for typeRoots to include
      "src/types",

      /**
       * Add extension repos' `src/types` folders here if you want to use local development type
       * declarations. These will override the cached extension type declarations included in
       * final entry in this array. Note that running extensions' local development type
       * declaration files get copied into the cached extension type declarations while running
       * Platform.Bible in development, but adding extension repos' `src/types` folders here means
       * the local development type declarations will always be up-to-date instead of only when
       * Platform.Bible is running in development.
       *
       * @example Adding `"../paranext-extension-word-list/src/types",` includes the local version
       * of the Word List extension's type declarations. Then, your extension can use types from the
       * local build of the Word List extension.
       */

      // Include cached extension type declarations in case this extension needs to depend on them
      // These are last, so any modules in the above typeRoots take precedence.
      "../paranext-core/dev-appdata/cache/extension-types"
    ],
    // Papi exposes decorators for use in classes
    "experimentalDecorators": true,
    // We want sourcemaps so we can bundle them with webpack
    "sourceMap": true,
    // We need a baseurl for webpack's tsconfig path aliases plugin
    "baseUrl": "./"
  },
  "include": ["src"],
  "ts-node": {
    // This allows us to use path aliases in ts-node
    "require": ["tsconfig-paths/register"],
    // This allows us to run webpack even if there are type errors in the webpack configs. Optional
    "transpileOnly": true
  }
}