maybe just JSDoc instead? It's an old standard, widely supported by IDEs, and use typescript for CI/CD

https://www.typescriptlang.org/docs/handbook/type-checking-j...