Como o Typescript --allowJs funciona?

Eu li:

• Roteiro do TypeScript 1.8
• JavaScript em compilações TypeScript
• Compilação de arquivos Js
• Anunciando o TypeScript 1.8 Beta

mas eu ainda não entendo como funciona e para que serve. Alguém poderia, por favor, explicar o que é e quando eu gostaria de usá-lo?

Resposta #1

De Clay Allsopp no Medium:

allowJs é a opção recém-disponível na versão 1.8. O compilador TypeScript fará uma verificação rápida de sanidade em arquivos .js para erros de sintaxe, mas caso contrário os envia diretamente para o diretório de saída.

Isso é útil ao migrar um projeto JavaScript para TypeScript, assim você não precisa migrar tudo de uma vez, mas pode começar a escrever novo código em TypeScript e/ou migrar cada arquivo um por um. Você pode encontrar mais informações sobre a migração de JavaScript para TypeScript no site oficial do TypeScript, que possui um tutorial chamado "Migrating from JavaScript".