59 lines
1.3 KiB
Plaintext
59 lines
1.3 KiB
Plaintext
/**
|
|
* @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()
|
|
}
|