Method parseJSDocCommentWorker

internal/parser/jsdoc.go:193–378

** * @param offset - the offset in the containing file * @param indent - the number of spaces to consider as the margin (applies to non-first lines only) */

(start int, end int, fullStart int, indent int)

 * @param indent - the number of spaces to consider as the margin (applies to non-first lines only)
 */
func (p *Parser) parseJSDocCommentWorker(start int, end int, fullStart int, indent int) *ast.Node {
	// Initially we can parse out a tag.  We also have seen a starting asterisk.
	// This is so that /** * @type */ doesn't parse.
	tags := p.nodeSliceArena.NewSlice(1)[:0]
	tagsPos := -1
	tagsEnd := -1
	state := jsdocStateSawAsterisk
	backtickCount := 0
	inFencedCodeBlock := false
	commentParts := p.nodeSliceArena.NewSlice(1)[:0]
	comments := p.jsdocCommentsSpace
	commentsPos := -1
	linkEnd := start
	margin := -1
	pushComment := func(text string) {
		if margin == -1 {
			margin = indent
		}
		comments = append(comments, text)
		indent += len(text)
	}

	p.nextTokenJSDoc()
	for p.parseOptionalJsdoc(ast.KindWhitespaceTrivia) {
	}
	if p.parseOptionalJsdoc(ast.KindNewLineTrivia) {
		state = jsdocStateBeginningOfLine
		indent = 0
	}
loop:
	for {
		// Detect fenced code blocks by counting consecutive backtick tokens.
		// Three or more consecutive backticks toggle the fenced code block state.
		if p.token != ast.KindBacktickToken && backtickCount > 0 {
			if backtickCount >= 3 {
				inFencedCodeBlock = !inFencedCodeBlock
			}
			backtickCount = 0
		}
		switch p.token {
		case ast.KindAtToken:
			if inFencedCodeBlock || !p.scanner.CanFollowJSDocAt() {
				if inFencedCodeBlock {
					state = jsdocStateSavingBackticks
				} else {
					state = jsdocStateSavingComments
				}
				pushComment(p.scanner.TokenText())
				break
			}
			comments = removeTrailingWhitespace(comments)
			if commentsPos == -1 {
				commentsPos = p.nodePos()
			}
			tag := p.parseTag(tags, indent)
			if tagsPos == -1 {
				tagsPos = tag.Pos()
			}