typescript doc comments?

Hi, I am working on integrating zod into one of my current projects. In the past I have used a combination of declared typescript types and manual validation. Zod is obviously a lot nicer to use on the validation side, but there is one piece from declaring types that I cannot find a replacement for in zod. That is doc comments

E.g. if I have the following struct defined:

interface Media {
  /**
  * The location of the media file
  */
  filepath: string
}

what would the equivalent comment look like in zod? These are important for my project, which relies on deno’s documentation generation for user docs (see here https://doc.deno.land/https/raw.githubusercontent.com/andykais/ffmpeg-templates/main/lib/template_input.ts#Template)

[andykais]

You’ll find it much easier and less prone to edge cases if you treat your schemas as the source of truth

Well the whole point of this issue is that documentation tools using zod as the source of truth are insufficient. I understand that this is a limitation of the language though.

[andykais]

@ptboyer thanks for sharing. I ended up going with an existing library https://github.com/DetachHead/ts-helpers/issues/97. If thats missing some use cases then let them know! Until ts-helpers publishes to deno.land https://github.com/DetachHead/ts-helpers/issues/107, the imports look like this:

import { exactly } from 'http://esm.sh/@detachhead/ts-helpers@9.0.0-9b4a478c3a63affa1f7f29aeabc2e5f76583ddfc/dist/utilityFunctions/misc'