Missing documentation for exports alternative paths

Affected URL(s)

https://nodejs.org/api/packages.html

Description of the problem

Packages documentation is really helpful to understand motivations and practical usage of exports, from the simplest setup to nested conditions, wildcards, etc. However, it seems to lack a description and examples of "alternative paths" within exports, which I think is really powerful stuff, but currently underrated and not very popular (maybe because of the lack in documentation).

With "alternative paths" what I mean is using arrays as follows:

{
    "exports": {
        ".": {
            "development": {
                "types": "./src/index.ts",
                "import": "./src/index.js",
                "require": "./src/index.cjs",
                "default": "./src/index.cjs"
            },
            "import": {
                "types": "./types/index.d.ts",
                "default": [
                    "./src/index.js",
                    "./esm/index.js"
                ]
            },
            "require": [
                "./src/index.cjs",
                "./cjs/index.cjs"
            ],
            "default": [
                "./src/index.cjs",
                "./cjs/index.cjs"
            ]
        }
    }
}

The only hint I found in the documentation, is string[] syntax under exports.

Beside that, there are some mentions around:

• Webpack's official docs citing Node.js behaviour: https://webpack.js.org/guides/package-exports/#alternatives.
• Notable TypeScript issue requesting aligning to Node.js behaviour: https://github.com/nodejs/node/issues/37928

I think that "alternative paths" is the perfect solution for situations like using your own package without having to build it first during development (e.g., TypeScript, transpiling, polyfilling, etc.)

If there is a spec I would love to update the docs myself.

Commencez par la section « exports » de la documentation des packages sur nodejs.org/api/packages.html et consultez les références liées de Webpack et TypeScript concernant le comportement des chemins alternatifs. Ajoutez une description et des exemples pratiques de chemins d’exportation dont la valeur est un array, en expliquant clairement dans la documentation quand les exemples s’appliquent.