Docs issues galore with ESM vs CommonJS use

[delfuego]

The primary docs site is replete with issues related to the use of Chai, specifically in terms of the differences between Chai 4 and Chai 5.

For example, there are still plenty of places that read that one should use:

import chai from 'chai';

when the Chai 5 ESM-only version doesn't have a default exported object, so that fails. It took me a while to figure out that everything is now a named export, so if I want to use a plugin, I have to use:

import { use, expect } from 'chai';

and then change all my chai.use() calls to just use that newly-exported use method.

Is there a Chai 5/ESM-only doc page that helps folks make these changes?

[boly38]

• related file example guides/using-chai-with-esm-and-plugins
• and on doc repo, related issue : Update docs for chai 5 - ESM chaijs.github.io#205
• related discussion Migrating to Chai 5.0 in browser #1600
• chai.request : @types/chai seems not to be adapted to version 5.0.0 #1578

with your help and request issue help, here is a working sample of import adapted to ESM+chai5 that work for me (I'm not chai expert)

import {should, use as chaiUse} from 'chai';
import chaiHttp from 'chai-http';
import deepEqualInAnyOrder from 'deep-equal-in-any-order';

should();
chaiUse(deepEqualInAnyOrder);
const chaiRequest = chaiUse(chaiHttp);
// chaiRequest.request...

but it would be much better if official doc follows chai engine