Funziona con webpack: true in nest-cli.json?

Risposta

Sì: registra nestjs-docfy in compilerOptions.plugins di nest-cli.json e chiama applyDocfyMetadata(document) subito dopo SwaggerModule.createDocument(). È lo stesso meccanismo che il plugin CLI di @nestjs/swagger stesso usa per funzionare sotto webpack, e risolve il limite di fondo alla radice invece di aggirarlo: la discovery a runtime (DocfyModule, senza il plugin) continua a non poter funzionare, perché dipende da require.cache e webpack racchiude tutto in un unico bundle, senza mai popolarlo con una voce per file sorgente originale. Vedi Il plugin CLI.

E il builder SWC?

Sì, ma serve "typeCheck": true insieme a "builder": "swc" — sotto SWC, @nestjs/cli invoca i plugin solo tramite un hook diverso, condizionato all'attivazione del type-checking. Senza, il plugin resta silenzioso: la build comunque riesce, solo senza generare docfy-metadata.json. Spiegazione completa nella sezione Builder SWC della guida al plugin.