Can we add another scenario where after the multi-line string another tag is set? Would be good to ensure TS properly handles this. e.g.

        /**
         * Save some data.
         * @param data The data to save.
         * @param timing Long description
         *     with multiple lines.
         * @param bla Long description 2
         *     with multiple times
         */

Good idea, done.

what's the special behavior in terms of parsing? is the extra space you're talking about later in the expect?

I still need to spend more time figuring out the behavior of @see; I figured it would be more useful to do that later in the process, though, once we're actually doing something to make cross-links work. Trying something like

        /**
         * Future version.
         * @see Component
         */ 

weirdly returns {name: 'see', comment: '*'}, even though that's supposed to be valid JsDoc. For the test case here (@see {@link Component}), comment is actually two separate nodes, presumably one for @link and one for Component, but I wasn't yet able to figure out anything to do with those nodes other than put them back to a string with getTextOfJSDocComment.

would it be more accurate to name this text/value?

I was trying to align with TypeScript's naming here, which is tagName and comment. (the tag part seemed redundant, though)

I can't think of a VariableDeclaration outside of a variable list, statement- but would you want to assert this? I think that would make this code more robust and avoid future hard-to-debug scenarios?

The type of declaration.parent.parent here is ts.VariableStatement | ts.ForStatement | ts.ForOfStatement | ts.ForInStatement | ts.TryStatement. In the scenario that this code path runs for a for or try statement, I think the current behavior (an empty string if the node doesn't have any JsDoc) is reasonable.

I also expect to need to refine things once I start running it over the real sources.

Sounds good. Just thought might make things easier to debug if we had an actual runtime assert here