jsdoc-type-pratt-parser/src/parslets/SpecialNamePathParslet.ts

[](https://www.npmjs.com/package/jsdoc-type-pratt-parser) []

import { composeParslet, type ParsletFunction } from './Parslet.js'
import type { TokenType } from '../lexer/Token.js'
import { Precedence } from '../Precedence.js'
import { Parser } from '../Parser.js'
import type { SpecialNamePath, SpecialNamePathType } from '../result/RootResult.js'
import { assertRootResult } from '../assertTypes.js'
import type { Grammar } from '../grammars/Grammar.js'

export function createSpecialNamePathParslet ({ pathGrammar, allowedTypes }: {
  allowedTypes: SpecialNamePathType[]
  pathGrammar: Grammar
}): ParsletFunction {
  return composeParslet({
    name: 'specialNamePathParslet',
    accept: type => (allowedTypes as TokenType[]).includes(type),
    parsePrefix: parser => {
      const type = parser.lexer.current.type as SpecialNamePathType
      parser.consume(type)

      if (!parser.consume(':')) {
        return {
          type: 'JsdocTypeName',
          value: type
        }
      }

      let result: SpecialNamePath

      let token = parser.lexer.current
      if (parser.consume('StringValue')) {
        result = {
          type: 'JsdocTypeSpecialNamePath',
          value: token.text.slice(1, -1),
          specialType: type,
          meta: {
            quote: token.text.startsWith('\'') ? 'single' : 'double'
          }
        }
      } else {
        let value = ''
        const allowed: TokenType[] = ['Identifier', '@', '/']
        while (allowed.some(type => parser.consume(type))) {
          value += token.text
          token = parser.lexer.current
        }
        result = {
          type: 'JsdocTypeSpecialNamePath',
          value,
          specialType: type,
          meta: {
            quote: undefined
          }
        }
      }

      const moduleParser = new Parser(pathGrammar, parser.lexer, parser)
      const moduleResult = moduleParser.parseInfixIntermediateType(result, Precedence.ALL)
      parser.acceptLexerState(moduleParser)

      return assertRootResult(moduleResult)
    }
  })
}