feat(jest): expose Config type from jest

[mrazauskas]

Closes #12037
Closes #12801

Summary

This second attempt to unify the style of configuration examples. Previously (in #12037) I was trying to refactor all config to JSON. That looked alright, but something was missing. This PR is based #12817 (comment) in which the user suggesting that the examples could be functioning copy-paste code.

Interesting. Made me think in that direction. In that PR only CJS syntax was covered, but it is possible to have JS, TS tabs. For instance, Playwright’s config examples are written in this way.

JestConfig type is borrowed from my other PR. This is simply a reexport of Config.InitialOptions. Just thinking out loud, I am fine to use either.

The motivation to add JestConfig:

• Config.InitialOptions is verbose and feels like an internal type.
• also exposing JestConfig from jest does not require to install additional package to pass stricter audit.

No feelings hurt is something looks unacceptable. In my projects Jest configs are mostly written in JSON, to be honest ;D

Test plan

Tests are added. Lint should pass.

[mrazauskas]

This is all about how it looks like. So, here is preview: https://deploy-preview-12848--jestjs.netlify.app/docs/next/configuration

[SimenB]

I like this approach more!

From a quick glance through, the docs now no longer mention the config can export an async function, beyond that it looks like all is covered.

I'm AFK until wednesday (https://en.wikipedia.org/wiki/Constitution_Day_(Norway)), but I'll read through the docs more thoroughly then 👍

[mrazauskas]

It would be nice to make the tabs implementation less verbose, e.g.:

:::tabs

// js code

// ts code

:::

I was looking at docusaurus-remark-plugin-codetabs. Good example, but could be better. Will try to write a custom plugin at some point.

[SimenB]

this is fantastic 👏

I really like defaulting to JS config all over, plus showing both JS and TS examples - the tabs work great 👍

[mrazauskas]

By the way, I almost finished a Docusaurus plugin which creates a box with two tabs out of this (imagine backtics instead):

'''js tabs
// some js code
'''

'''ts tabs
// some ts code
'''

[mrazauskas]

Hm.. Seems like deploy is failing for few days. @SimenB could you take a look, please? (;

[SimenB]

Looks like an error in the french translation:

I've tried to edit the translation itself 🤞

[SimenB]

Website deployment was successful today, btw. Thanks for noticing!

[mrazauskas]

Website deployment was successful today, btw. Thanks for noticing!

Great. Tabs look really good. I'm happy about the result. Nice!

[github-actions]

This pull request has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs.
Please note this issue tracker is not a help forum. We recommend using StackOverflow or our discord channel for questions.