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

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

import { composeParslet, type ParsletFunction } from './Parslet.js'
import { Precedence } from '../Precedence.js'
import { assertRootResult } from '../assertTypes.js'
import { NoParsletFoundError } from '../errors.js'

export function createVariadicParslet ({ allowPostfix, allowEnclosingBrackets }: {
  allowPostfix: boolean
  allowEnclosingBrackets: boolean
}): ParsletFunction {
  return composeParslet({
    name: 'variadicParslet',
    accept: type => type === '...',
    precedence: Precedence.PREFIX,
    parsePrefix: parser => {
      parser.consume('...')

      const brackets = allowEnclosingBrackets && parser.consume('[')

      try {
        const element = parser.parseType(Precedence.PREFIX)
        if (brackets && !parser.consume(']')) {
          throw new Error('Unterminated variadic type. Missing \']\'')
        }

        return {
          type: 'JsdocTypeVariadic',
          element: assertRootResult(element),
          meta: {
            position: 'prefix',
            squareBrackets: brackets
          }
        }
      } catch (e) {
        if (e instanceof NoParsletFoundError) {
          if (brackets) {
            throw new Error('Empty square brackets for variadic are not allowed.', {
              cause: e
            })
          }
          return {
            type: 'JsdocTypeVariadic',
            meta: {
              position: undefined,
              squareBrackets: false
            }
          }
        } else {
          throw e
        }
      }
    },
    parseInfix: allowPostfix
      ? (parser, left) => {
          parser.consume('...')
          return {
            type: 'JsdocTypeVariadic',
            element: assertRootResult(left),
            meta: {
              position: 'suffix',
              squareBrackets: false
            }
          }
        }
      : undefined
  })
}