Files
site/node_modules/mdast-util-to-markdown/lib/handle/link.js
T
site-admin 3ac81d5a52
deploy / build-and-publish (push) Successful in 1m37s
the editable site (validation-lab)
2026-11-21 08:03:55 +01:00

165 lines
4.1 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/**
* @import {Info, State} from 'mdast-util-to-markdown'
* @import {Link, Parents} from 'mdast'
* @import {Exit} from '../types.js'
*/
import {checkQuote} from '../util/check-quote.js'
import {formatLinkAsAutolink} from '../util/format-link-as-autolink.js'
link.peek = linkPeek
/**
* Serialize a link node.
*
* @param {Link} node
* Node to serialize.
* @param {Parents | undefined} _
* Parent node.
* @param {State} state
* Info passed around.
* @param {Info} info
* Info on surrounding context.
* @returns {string}
* Serialized markdown.
*/
export function link(node, _, state, info) {
const quote = checkQuote(state)
const suffix = quote === '"' ? 'Quote' : 'Apostrophe'
const tracker = state.createTracker(info)
if (formatLinkAsAutolink(node, state)) {
// Hide that we’re in phrasing as things like attention or code cannot form
// in autolinks.
// Character escapes also don’t work (nor character references),
// but that is a different matter, which `safe.js` handles for `autolink`.
// It is important to know about other constructs, such as table cells.
const stack = state.stack
state.stack = stack.filter(function (d) {
return d !== 'phrasing'
})
const exit = state.enter('autolink')
let value = tracker.move('<')
value += tracker.move(
state.containerPhrasing(node, {
before: value,
after: '>',
...tracker.current()
})
)
value += tracker.move('>')
exit()
state.stack = stack
return value
}
const exit = state.enter('link')
let subexit = state.enter('label')
let value = tracker.move('[')
const text = state.containerPhrasing(node, {
before: value,
after: '](',
...tracker.current()
})
value += tracker.move(text)
subexit()
value += tracker.move('](')
// A link could accidentally turn into a definition in certain contexts:
// at the start of a line, without title, when its text has a `]` that
// cannot be escaped (such as in code).
//
// We can prevent that with an empty title:
//
// ```
// [`a]:`](b)
// ```
//
// …is a definition with `` `](b) `` as its destination.
//
// Using:
//
// ```
// [`a]:`](b "")
// ```
//
// …instead fixes it.
//
// Control characters, whitespace, or a leading `<` in the url need an
// enclosed destination, which also prevents this.
const enclose = /^<|[\0- \u007F]/.test(node.url)
const last = info.before.charAt(info.before.length - 1)
let title = node.title || undefined
if (!title && !enclose && (last === '\n' || last === '\r')) {
let index = 0
while (index < text.length && text.charCodeAt(index) !== 93 /* `]` */) {
index += text.charCodeAt(index) === 92 /* `\` */ ? 2 : 1
}
if (text.charCodeAt(index + 1) === 58 /* `:` */) title = ''
}
if (
// If there’s no url but there is a title…
(!node.url && typeof title === 'string') ||
// If there are control characters or whitespace.
enclose
) {
subexit = state.enter('destinationLiteral')
value += tracker.move('<')
value += tracker.move(
state.safe(node.url, {before: value, after: '>', ...tracker.current()})
)
value += tracker.move('>')
} else {
// No whitespace, raw is prettier.
subexit = state.enter('destinationRaw')
value += tracker.move(
state.safe(node.url, {
before: value,
after: typeof title === 'string' ? ' ' : ')',
...tracker.current()
})
)
}
subexit()
if (typeof title === 'string') {
subexit = state.enter(`title${suffix}`)
value += tracker.move(' ' + quote)
value += tracker.move(
state.safe(title, {
before: value,
after: quote,
...tracker.current()
})
)
value += tracker.move(quote)
subexit()
}
value += tracker.move(')')
exit()
return value
}
/**
* Peek at this node.
*
* @param {Link} node
* Node to peek at.
* @param {Parents | undefined} _
* Parent node.
* @param {State} state
* Info passed around.
* @returns {string}
* Start of the serialized markdown.
*/
function linkPeek(node, _, state) {
return formatLinkAsAutolink(node, state) ? '<' : '['
}