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.

Beginnen Sie mit dem Abschnitt „exports“ der Paketdokumentation unter nodejs.org/api/packages.html und prüfen Sie die verknüpften Webpack- und TypeScript-Referenzen zum Verhalten bei alternativen Pfaden. Fügen Sie eine Beschreibung und praktische Beispiele für Exportpfade mit Array-Werten hinzu, wobei die Dokumentation klar erklärt, wann die Beispiele anwendbar sind.