`app/lib/publications/entities.mjs`

37 lines and 3 functions in DrDustinEdwards/dustinedwards-info, at commit 1590ba4 on 2026-10-24. This file on GitHub.

Functions

The functions of entities.mjs
Function	Lines	Complexity	Covered	CRAP	Mutation
fromCodePoint	21 to 27	6	100%	WatchCRAP 6	No data: no mutants in this code
decodeEntities	33 to 41	2	100%	OkCRAP 2	No data: no mutants in this code
<anonymous:34>	34 to 40	6	100%	WatchCRAP 6	No data: no mutants in this code

Imports

Source

1// Decoded where a person reads it, never at rest: check:machine-readable asserts no stored abstract
2// contains <, which keeps registry text safe in JSON-LD and exports. One alternation in one pass, so
3// &amp;lt; decodes to &lt; and stops. Unknown names are left verbatim on purpose.
4
5const NAMED = {
6  amp: "&",
7  lt: "<",
8  gt: ">",
9  quot: '"',
10  apos: "'",
11};
12
13const REFERENCE = /&(?:#(\d+)|#[xX]([0-9a-fA-F]+)|([a-zA-Z][a-zA-Z0-9]*));/g;
14
15/**
16 * String.fromCodePoint throws out of range, which would fail a render over one bad deposit.
17 *
18 * @param {number} code
19 * @returns {string | null}
20 */
21function fromCodePoint(code) {
22  // Zero too: &#0; is a NUL, which no reader should receive from a deposit or a feed.
23  if (!Number.isInteger(code) || code < 1 || code > 0x10ffff) return null;
24  // Lone surrogates are valid integers and produce unpaired halves.
25  if (code >= 0xd800 && code <= 0xdfff) return null;
26  return String.fromCodePoint(code);
27}
28
29/**
30 * @param {string | null | undefined} text
31 * @returns {string}
32 */
33export function decodeEntities(text) {
34  return String(text ?? "").replace(REFERENCE, (whole, dec, hex, name) => {
35    if (dec !== undefined) return fromCodePoint(Number(dec)) ?? whole;
36    if (hex !== undefined) return fromCodePoint(Number.parseInt(hex, 16)) ?? whole;
37    return Object.prototype.hasOwnProperty.call(NAMED, name)
38      ? /** @type {string} */ (NAMED[/** @type {keyof NAMED} */ (name)])
39      : whole;
40  });
41}