feat(experimental-utils): expose ReferenceTracker.ESM

[MageJohn]

Fixes #3527

ReferenceTracker.ESM seems to be undocumented, but it marks a trace map as being an ES module. It is used only once that I can see, here: https://github.com/mysticatea/eslint-utils/blob/c3b1d38328dc3a5278b208a58186a0735315f58f/src/reference-tracker.js#L181

The code only checks if the trace map has they key, and does nothing with it's value. Therefore when adding it to the TraceMapElement type, I opted to type it as always true, if it's present. In theory something like any or unknown would work, but that wouldn't convey that it's just a flag; a type of boolean might lead to confusion if users think they can do [ReferenceTracker.ESM]: false and expect it to be disabled.

[nx-cloud]

Nx Cloud Report

CI ran the following commands for commit 7f75521. Click to see the status, the terminal output, and the build insights.

📂 See all runs for this branch

Status	Command
	nx run-many --target=build --all --parallel
	nx run-many --target=typecheck --all --parallel

---

Sent with 💌 from NxCloud.

[typescript-eslint]

Thanks for the PR, @MageJohn!

typescript-eslint is a 100% community driven project, and we are incredibly grateful that you are contributing to that community.

The core maintainers work on this in their personal time, so please understand that it may not be possible for them to review your work immediately.

Thanks again!

---

🙏 Please, if you or your company is finding typescript-eslint valuable, help us sustain the project by sponsoring it transparently on https://opencollective.com/typescript-eslint. As a thank you, your profile/company logo will be added to our main README which receives thousands of unique visitors per day.

[JoshuaKGoldberg]

Ah, this might be superseded by DefinitelyTyped/DefinitelyTyped#53803 ?

[bradzacher]

@JoshuaKGoldberg nah it won't be because we can't use the @types/eslint-utils here.
Those types are based off of @types/estree which conflict with our ESTree types.
same reason we can't use @types/eslint or @types/eslint-scope.

That's why we had to go this route of defining our own set of types for the packages :(

[bradzacher]

thanks!

[codecov]

Codecov Report

Merging #3532 (7f75521) into master (b3ac5f6) will increase coverage by 0.00%.
The diff coverage is 100.00%.

@@           Coverage Diff           @@
##           master    #3532   +/-   ##
=======================================
  Coverage   92.63%   92.63%           
=======================================
  Files         325      325           
  Lines       11235    11236    +1     
  Branches     3168     3168           
=======================================
+ Hits        10408    10409    +1     
  Misses        367      367           
  Partials      460      460           

Flag	Coverage Δ
unittest	92.63% <100.00%> (+<0.01%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

Impacted Files	Coverage Δ
...ils/src/ast-utils/eslint-utils/ReferenceTracker.ts	100.00% <100.00%> (ø)