Function extractMethodDocs

lib/command/list.js:66–122

(helper, helperName, config, testsPath, partials)

}

function extractMethodDocs(helper, helperName, config, testsPath, partials) {
  const result = new Map()
  const sourceFile = resolveHelperSource(helper, helperName, config, testsPath)
  if (!sourceFile) return result

  let source
  try {
    source = fs.readFileSync(sourceFile, 'utf8')
  } catch {
    return result
  }

  const comments = []
  let ast
  try {
    ast = acorn.parse(source, {
      ecmaVersion: 'latest',
      sourceType: 'module',
      locations: true,
      onComment: comments,
    })
  } catch {
    return result
  }

  const classNode = findClassNode(ast)
  if (!classNode) return result

  const blockComments = comments
    .filter(c => c.type === 'Block' && c.value.startsWith('*'))
    .sort((a, b) => a.start - b.start)

  let cursor = 0
  for (const member of classNode.body.body) {
    if (member.type !== 'MethodDefinition') continue
    if (member.kind === 'constructor' || member.static) continue
    const name = member.key?.name
    if (!name || name.startsWith('_')) continue

    let attached = null
    let attachedIdx = -1
    for (let i = cursor; i < blockComments.length; i++) {
      const c = blockComments[i]
      if (c.end > member.start) break
      attached = c
      attachedIdx = i
    }
    if (attached) {
      cursor = attachedIdx + 1
      const stripped = stripJsDoc(attached.value)
      const resolved = resolvePartials(stripped, partials)
      result.set(name, resolved)
    }
  }

  return result
}