/**
 * @typedef {import('mdast').Definition} Definition
 * @typedef {import('mdast').Nodes} Nodes
 */

/**
 * @callback GetDefinition
 *   Get a definition by identifier.
 * @param {string | null | undefined} [identifier]
 *   Identifier of definition (optional).
 * @returns {Definition | undefined}
 *   Definition corresponding to `identifier` or `null`.
 */

import {visit} from 'unist-util-visit'

/**
 * Find definitions in `tree`.
 *
 * Uses CommonMark precedence, which means that earlier definitions are
 * preferred over duplicate later definitions.
 *
 * @param {Nodes} tree
 *   Tree to check.
 * @returns {GetDefinition}
 *   Getter.
 */
export function definitions(tree) {
  /** @type {Map<string, Definition>} */
  const cache = new Map()

  if (!tree || !tree.type) {
    throw new Error('mdast-util-definitions expected node')
  }

  visit(tree, 'definition', function (definition) {
    const id = clean(definition.identifier)
    if (id && !cache.get(id)) {
      cache.set(id, definition)
    }
  })

  return definition

  /** @type {GetDefinition} */
  function definition(identifier) {
    const id = clean(identifier)
    return cache.get(id)
  }
}

/**
 * @param {string | null | undefined} [value]
 * @returns {string}
 */
function clean(value) {
  return String(value || '').toUpperCase()
}