tsconfig.json

{
  "extends": "@masknet/config/tsconfig.json",
  "references": [
    // Only list top-level projects here
    { "path": "./packages/polyfills/" },
    { "path": "./packages/mask/" },
    { "path": "./packages/injected-script/main" },
    { "path": "./packages/mask-sdk/main" },
    { "path": "./packages/mask-sdk/public-api" },
    { "path": "./packages/sentry/" },
    { "path": "./packages/dashboard" },
    // Storybooks are considered as a "project" not depended by any other project
    { "path": "./packages/dashboard/stories" },
    { "path": "./packages/theme/stories" },
    // Tests
    // @masknet/scripts: insert-here 1
    { "path": "./packages/base/tsconfig.tests.json" },
    { "path": "./packages/backup-format/tsconfig.tests.json" },
    { "path": "./packages/encryption/tsconfig.tests.json" },
    { "path": "./packages/typed-message/tests/tsconfig.json" },
    { "path": "./packages/shared-base/tsconfig.tests.json" },
    { "path": "./packages/web3-hooks/base/tsconfig.tests.json" },
    { "path": "./packages/web3-shared/base/tsconfig.tests.json" },
    // All plugins should be type checked too
    { "path": "./packages/plugins" }
  ],
  "compilerOptions": {
    // Exclude everything by default. Include them in each project on-demand
    "types": ["masknet__global-types"],
    "resolveJsonModule": true,
    "preserveValueImports": false,
    "paths": {
      // # Why?
      // TypeScript project reference requires manually declaring all referenced projects.

      // For example, we have 2 projects A and B under /projects/a and /projects/b and B depends on A,
      // if we do not list A in the references, when we write

      // > /packages/b/src/index.ts

      // ```ts
      // import { something } from '../../a'
      // ```

      // If there is no "reference": [{ "path": "../a/tsconfig.json" }] in /packages/b/tsconfig.json,
      // TypeScript will complain TS6307: "File '/packages/b/src/index.ts' is not listed within the file list of the project '/packages/b/tsconfig.json'. Projects must list all files or use an 'include' pattern."

      // This is error is GOOD because it means TypeScript _can_ automatically detect the missing references.

      // # What about monorepo?
      // But TypeScript cannot detect the missing references when we install them as monorepo packages.
      // Still the project structure above, but A is installed as "@masknet/a" in /packages/b/node_modules/@masknet/a,
      // TypeScript will accept the missing reference to the A project,
      // because it will go through the "moduleResolution": "Node" resolution, if `.d.ts` file is found,
      // the project will _accidentally_ compiles, but TypeScript does DON'T know those packages has dependencies in the project reference graph.
      // This will cause the project to randomly fail to be type-checked.

      // # Solution
      // We use "paths" to map the Node-style import path back to the relative style,
      // therefore TypeScript can check the missing dependencies again.

      // This will not introduce problems like mapping "@src/" to "/packages/a/src" which is problematic,
      // because those projects (if they're correctly configured) is installed in the node_modules,
      // so if any toolchain does not support the "paths" feature, it will still work.

      // This will bring another problem: now we can reference a project without installing it as a monorepo dependency,
      // which is unwanted. We need to take care of this.

      "@masknet/backup-format": ["./packages/backup-format/src"],
      "@masknet/configuration": ["./packages/configuration/src"],
      "@masknet/dashboard": ["./packages/dashboard/src"],
      "@masknet/encryption": ["./packages/encryption/src"],
      "@masknet/external-plugin-previewer": ["./packages/external-plugin-previewer/src"],
      "@masknet/gun-utils": ["./packages/gun-utils/src"],
      "@masknet/injected-script": ["./packages/injected-script/sdk"],
      // @masknet/mask is not listed. it does not have a exports/main field in the package.json.
      "@masknet/mask-sdk": ["./packages/mask-sdk/server"],
      "@masknet/plugin-infra": ["./packages/plugin-infra/src"],
      "@masknet/global-types/*": ["./packages/polyfills/types/*"],
      "@masknet/public-api": ["./packages/public-api/src"],
      // @masknet/scripts is not listed. It does not mean to be installed as a dependency and not join the type check.
      "@masknet/shared": ["./packages/shared/src"],
      "@masknet/shared-base": ["./packages/shared-base/src"],
      "@masknet/shared-base-ui": ["./packages/shared-base-ui/src"],
      "@masknet/storybook-shared": ["./packages/storybook-shared/src"],
      "@masknet/theme": ["./packages/theme/src"],
      // @masknet/web3-constants is not listed. It is not a TS project (only contains JSON files).
      // @masknet/web3-contracts is not listed. It is not a TS project (only contains generated JSON and .d.ts files).
      "@masknet/web3-helpers": ["./packages/web3-helpers/src"],
      "@masknet/web3-providers": ["./packages/web3-providers/src"],
      "@masknet/web3-state": ["./packages/web3-state/src"],
      "@masknet/web3-hooks-base": ["./packages/web3-hooks/base/src"],
      "@masknet/web3-hooks-evm": ["./packages/web3-hooks/evm/src"],
      "@masknet/web3-shared-base": ["./packages/web3-shared/base/src"],
      "@masknet/web3-shared-evm": ["./packages/web3-shared/evm/src"],
      "@masknet/web3-shared-flow": ["./packages/web3-shared/flow/src"],
      "@masknet/web3-shared-solana": ["./packages/web3-shared/solana/src"],
      "@masknet/typed-message": ["./packages/typed-message/base"],
      "@masknet/typed-message-react": ["./packages/typed-message/react"],
      "@masknet/types": ["./packages/types/src"],
      "@masknet/sandboxed-plugin-runtime": ["./packages/sandboxed-plugin-runtime/src/runtime/export.ts"],
      "@masknet/sandboxed-plugin-runtime/background": ["./packages/sandboxed-plugin-runtime/src/background"],
      "@masknet/sandboxed-plugin-runtime/site-adaptor": ["./packages/sandboxed-plugin-runtime/src/site-adaptor"],
      "@masknet/sandboxed-plugin-runtime/extension-page": ["./packages/sandboxed-plugin-runtime/src/extension-page"],
      "@masknet/base": ["./packages/base/src"],
      "@masknet/config": ["./packages/config/src"],
      // @masknet/scripts: insert-here 2

      // Plugins
      "@masknet/plugin-debugger": ["./packages/plugins/Debugger/src"],
      "@masknet/plugin-example": ["./packages/plugins/Example/src"],
      "@masknet/plugin-file-service": ["./packages/plugins/FileService/src"],
      "@masknet/plugin-evm": ["./packages/plugins/./src"],
      "@masknet/plugin-flow": ["./packages/plugins/Flow/src"],
      "@masknet/plugin-rss3": ["./packages/plugins/RSS3/src"],
      "@masknet/plugin-solana": ["./packages/plugins/Solana/src"],
      "@masknet/plugin-template": ["./packages/plugins/template/src"],
      "@masknet/plugin-cyberconnect": ["./packages/plugins/CyberConnect/src"],
      "@masknet/plugin-go-plus-security": ["./packages/plugins/GoPlusSecurity/src"],
      "@masknet/plugin-cross-chain-bridge": ["./packages/plugins/CrossChainBridge/src"],
      "@masknet/plugin-web3-profile": ["./packages/plugins/Web3Profile/src"],
      "@masknet/plugin-ens": ["./packages/plugins/ens/src"],
      "@masknet/plugin-approval": ["./packages/plugins/approval/src"],
      "@masknet/plugin-scam-warning": ["./packages/plugins/ScamWarning/src"],
      "@masknet/plugin-gitcoin": ["./packages/plugins/Gitcoin/src"],
      "@masknet/plugin-smart-pay": ["./packages/plugins/SmartPay/src"],
      // @masknet/scripts: insert-here 3
      "@masknet/plugin-wallet": ["./packages/plugins/Wallet/src"]
    }
  },
  "files": [],
  "ts-node": {
    "compilerOptions": {
      "noEmit": false
    },
    "esm": true,
    "swc": true
  }
}