48 lines
1.3 KiB
Plaintext
48 lines
1.3 KiB
Plaintext
/**
|
||
* @typedef {import('nlcst').Content} Content
|
||
* @typedef {import('nlcst').Root} Root
|
||
*/
|
||
|
||
/**
|
||
* Get the text content of a node or list of nodes.
|
||
*
|
||
* Prefers the node’s plain-text fields, otherwise serializes its children, and
|
||
* if the given value is an array, serialize the nodes in it.
|
||
*
|
||
* @param {Root | Content | Array<Content>} value
|
||
* Node or list of nodes to serialize.
|
||
* @param {string | null | undefined} [separator='']
|
||
* Separator to use.
|
||
* @returns {string}
|
||
* Result.
|
||
*/
|
||
// To do next major: remove `separator`.
|
||
export function toString(value, separator) {
|
||
let index = -1
|
||
|
||
if (!value || (!Array.isArray(value) && !value.type)) {
|
||
throw new Error('Expected node, not `' + value + '`')
|
||
}
|
||
|
||
// @ts-expect-error Looks like a literal.
|
||
if (typeof value.value === 'string') return value.value
|
||
|
||
/** @type {Array<Content|Root>} */
|
||
// @ts-expect-error Looks like a list of nodes or parent.
|
||
const children = (Array.isArray(value) ? value : value.children) || []
|
||
|
||
// Shortcut: This is pretty common, and a small performance win.
|
||
if (children.length === 1 && 'value' in children[0]) {
|
||
return children[0].value
|
||
}
|
||
|
||
/** @type {Array<string>} */
|
||
const values = []
|
||
|
||
while (++index < children.length) {
|
||
values[index] = toString(children[index], separator)
|
||
}
|
||
|
||
return values.join(separator || '')
|
||
}
|