Files
site/node_modules/stringify-entities/lib/util/format-smart.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

77 lines
2.7 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.
/**
* @typedef FormatSmartOptions
* Configuration for `stringifyEntities` that is not in `LightOptions`.
* @property {boolean | null | undefined} [attribute=false]
* Create character references which don’t fail in attributes
* (default: `false`);
* only applies when operating dangerously with
* `omitOptionalSemicolons: true`.
* @property {boolean | null | undefined} [omitOptionalSemicolons=false]
* Whether to omit semicolons when possible (default: `false`);
* this creates what HTML calls “parse errors” but is otherwise still valid
* HTML,
* so don’t use this except when building a minifier;
* omitting semicolons is possible for certain named and numeric references in
* some cases.
* @property {boolean | null | undefined} [useNamedReferences=false]
* Prefer named character references (`&`) where possible
* (default: `false`).
* @property {boolean | null | undefined} [useShortestReferences=false]
* Prefer the shortest possible reference,
* if that results in less bytes (default: `false`);
* `useNamedReferences` can be omitted when using `useShortestReferences`.
*/
import {toHexadecimal} from './to-hexadecimal.js'
import {toDecimal} from './to-decimal.js'
import {toNamed} from './to-named.js'
/**
* Configurable ways to encode a character yielding pretty or small results.
*
* @param {number} code
* Code point.
* @param {number} next
* Code point of the next character (or `NaN`).
* @param {FormatSmartOptions} options
* Configuration.
* @returns {string}
* Character reference.
*/
export function formatSmart(code, next, options) {
const omit = options.omitOptionalSemicolons && next !== 59 /* `;` */
let numeric = toHexadecimal(code, next, omit)
/** @type {string | undefined} */
let named
if (options.useNamedReferences || options.useShortestReferences) {
named = toNamed(code, next, omit, options.attribute)
}
// Use the shortest numeric reference when requested.
// A simple algorithm would use decimal for all code points under 100, as
// those are shorter than hexadecimal:
//
// * `c` vs `c` (decimal shorter)
// * `d` vs `d` (equal)
//
// However, because we take `next` into consideration when `omit` is used,
// And it would be possible that decimals are shorter on bigger values as
// well if `next` is hexadecimal but not decimal, we instead compare both.
if (
(options.useShortestReferences || !named) &&
options.useShortestReferences
) {
const decimal = toDecimal(code, next, omit)
if (decimal.length < numeric.length) {
numeric = decimal
}
}
return named &&
(!options.useShortestReferences || named.length < numeric.length)
? named
: numeric
}