doc: esm: explain * as alias behaviour with cjs modules

[rifler]

📗 API Reference Docs Problem

• Version: 12.18.3

• Platform: Darwin rifler-osx 19.6.0 Darwin Kernel Version 19.6.0: Sun Jul 5 00:43:10 PDT 2020; root:xnu-6153.141.1~9/RELEASE_X86_64 x86_64

• Subsystem: ECMAScript modules

Location

Section of the site where the content exists

Affected URL(s):

• https://nodejs.org/dist/latest-v12.x/docs/api/esm.html

Description

Concise explanation of the problem

for example, React@16.13.1 is cjs-only package now

// index.mjs

import React from 'react';
console.log(React);

// {
//     Children: {
//         map: [Function: mapChildren],
//         forEach: [Function: forEachChildren],
//         count: [Function: countChildren],
//         toArray: [Function: toArray],
//         only: [Function: onlyChild]
//     },
//     Component: [Function: Component],
// ........

// index.mjs

import * as React from 'react';
console.log(React);

// [Module] {
// default: {
//         Children: {
//             map: [Function: mapChildren],
//             forEach: [Function: forEachChildren],
//             count: [Function: countChildren],
//             toArray: [Function: toArray],
//             only: [Function: onlyChild]
//         },
//         Component: [Function: Component],
// ........

In my opinion it is not obvious (and maybe not interoperable with existing code) and it will be nice to document

---

• I would like to work on this issue and
  submit a pull request.

[therealansh]

I would like to take this one up. Can you help me out since i am new to node and willing to contribute.

[DerekNonGeneric]

Here's another issue about star-things. Perhaps it is of interest to y'all.

nodejs/modules#545

[aduh95]

@therealansh Thanks for volunteering! @rifler has checked the box saying they are willing to work on solving the issue themself, maybe you can ask them if they are working on it first.

That being said, the process of making changes is described in doc/guides/contributing/pull-requests.md, and you are very welcome to ask questions if you have any.