entities 2.2.0 → 4.0.0

package/lib/index.js

@@ -1,57 +1,135 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.decodeXMLStrict = exports.decodeHTML5Strict = exports.decodeHTML4Strict = exports.decodeHTML5 = exports.decodeHTML4 = exports.decodeHTMLStrict = exports.decodeHTML = exports.decodeXML = exports.encodeHTML5 = exports.encodeHTML4 = exports.escapeUTF8 = exports.escape = exports.encodeNonAsciiHTML = exports.encodeHTML = exports.encodeXML = exports.encode = exports.decodeStrict = exports.decode = void 0;
-var decode_1 = require("./decode");
-var encode_1 = require("./encode");
+exports.decodeXMLStrict = exports.decodeHTML5Strict = exports.decodeHTML4Strict = exports.decodeHTML5 = exports.decodeHTML4 = exports.decodeHTMLStrict = exports.decodeHTML = exports.decodeXML = exports.encodeHTML5 = exports.encodeHTML4 = exports.escapeText = exports.escapeAttribute = exports.escapeUTF8 = exports.escape = exports.encodeNonAsciiHTML = exports.encodeHTML = exports.encodeXML = exports.encode = exports.decodeStrict = exports.decode = exports.EncodingMode = exports.DecodingMode = exports.EntityLevel = void 0;
+var decode_js_1 = require("./decode.js");
+var encode_js_1 = require("./encode.js");
+/** The level of entities to support. */
+var EntityLevel;
+(function (EntityLevel) {
+    /** Support only XML entities. */
+    EntityLevel[EntityLevel["XML"] = 0] = "XML";
+    /** Support HTML entities, which are a superset of XML entities. */
+    EntityLevel[EntityLevel["HTML"] = 1] = "HTML";
+})(EntityLevel = exports.EntityLevel || (exports.EntityLevel = {}));
+/** Determines whether some entities are allowed to be written without a trailing `;`. */
+var DecodingMode;
+(function (DecodingMode) {
+    /** Support legacy HTML entities. */
+    DecodingMode[DecodingMode["Legacy"] = 0] = "Legacy";
+    /** Do not support legacy HTML entities. */
+    DecodingMode[DecodingMode["Strict"] = 1] = "Strict";
+})(DecodingMode = exports.DecodingMode || (exports.DecodingMode = {}));
+var EncodingMode;
+(function (EncodingMode) {
+    /**
+     * The output is UTF-8 encoded. Only characters that need escaping within
+     * HTML will be escaped.
+     */
+    EncodingMode[EncodingMode["UTF8"] = 0] = "UTF8";
+    /**
+     * The output consists only of ASCII characters. Characters that need
+     * escaping within HTML, and characters that aren't ASCII characters will
+     * be escaped.
+     */
+    EncodingMode[EncodingMode["ASCII"] = 1] = "ASCII";
+    /**
+     * Encode all characters that have an equivalent entity, as well as all
+     * characters that are not ASCII characters.
+     */
+    EncodingMode[EncodingMode["Extensive"] = 2] = "Extensive";
+    /**
+     * Encode all characters that have to be escaped in HTML attributes,
+     * following {@link https://html.spec.whatwg.org/multipage/parsing.html#escapingString}.
+     */
+    EncodingMode[EncodingMode["Attribute"] = 3] = "Attribute";
+    /**
+     * Encode all characters that have to be escaped in HTML text,
+     * following {@link https://html.spec.whatwg.org/multipage/parsing.html#escapingString}.
+     */
+    EncodingMode[EncodingMode["Text"] = 4] = "Text";
+})(EncodingMode = exports.EncodingMode || (exports.EncodingMode = {}));
 /**
  * Decodes a string with entities.
  *
  * @param data String to decode.
- * @param level Optional level to decode at. 0 = XML, 1 = HTML. Default is 0.
- * @deprecated Use `decodeXML` or `decodeHTML` directly.
+ * @param options Decoding options.
  */
-function decode(data, level) {
-    return (!level || level <= 0 ? decode_1.decodeXML : decode_1.decodeHTML)(data);
+function decode(data, options) {
+    if (options === void 0) { options = EntityLevel.XML; }
+    var opts = typeof options === "number" ? { level: options } : options;
+    if (opts.level === EntityLevel.HTML) {
+        if (opts.mode === DecodingMode.Strict) {
+            return (0, decode_js_1.decodeHTMLStrict)(data);
+        }
+        return (0, decode_js_1.decodeHTML)(data);
+    }
+    return (0, decode_js_1.decodeXML)(data);
 }
 exports.decode = decode;
 /**
  * Decodes a string with entities. Does not allow missing trailing semicolons for entities.
  *
  * @param data String to decode.
- * @param level Optional level to decode at. 0 = XML, 1 = HTML. Default is 0.
- * @deprecated Use `decodeHTMLStrict` or `decodeXML` directly.
+ * @param options Decoding options.
+ * @deprecated Use `decode` with the `mode` set to `Strict`.
  */
-function decodeStrict(data, level) {
-    return (!level || level <= 0 ? decode_1.decodeXML : decode_1.decodeHTMLStrict)(data);
+function decodeStrict(data, options) {
+    if (options === void 0) { options = EntityLevel.XML; }
+    var opts = typeof options === "number" ? { level: options } : options;
+    if (opts.level === EntityLevel.HTML) {
+        if (opts.mode === DecodingMode.Legacy) {
+            return (0, decode_js_1.decodeHTML)(data);
+        }
+        return (0, decode_js_1.decodeHTMLStrict)(data);
+    }
+    return (0, decode_js_1.decodeXML)(data);
 }
 exports.decodeStrict = decodeStrict;
 /**
  * Encodes a string with entities.
  *
  * @param data String to encode.
- * @param level Optional level to encode at. 0 = XML, 1 = HTML. Default is 0.
- * @deprecated Use `encodeHTML`, `encodeXML` or `encodeNonAsciiHTML` directly.
+ * @param options Encoding options.
  */
-function encode(data, level) {
-    return (!level || level <= 0 ? encode_1.encodeXML : encode_1.encodeHTML)(data);
+function encode(data, options) {
+    if (options === void 0) { options = EntityLevel.XML; }
+    var opts = typeof options === "number" ? { level: options } : options;
+    // Mode `UTF8` just escapes XML entities
+    if (opts.mode === EncodingMode.UTF8)
+        return (0, encode_js_1.escapeUTF8)(data);
+    if (opts.mode === EncodingMode.Attribute)
+        return (0, encode_js_1.escapeAttribute)(data);
+    if (opts.mode === EncodingMode.Text)
+        return (0, encode_js_1.escapeText)(data);
+    if (opts.level === EntityLevel.HTML) {
+        if (opts.mode === EncodingMode.ASCII) {
+            return (0, encode_js_1.encodeNonAsciiHTML)(data);
+        }
+        return (0, encode_js_1.encodeHTML)(data);
+    }
+    // ASCII and Extensive are equivalent
+    return (0, encode_js_1.encodeXML)(data);
 }
 exports.encode = encode;
-var encode_2 = require("./encode");
-Object.defineProperty(exports, "encodeXML", { enumerable: true, get: function () { return encode_2.encodeXML; } });
-Object.defineProperty(exports, "encodeHTML", { enumerable: true, get: function () { return encode_2.encodeHTML; } });
-Object.defineProperty(exports, "encodeNonAsciiHTML", { enumerable: true, get: function () { return encode_2.encodeNonAsciiHTML; } });
-Object.defineProperty(exports, "escape", { enumerable: true, get: function () { return encode_2.escape; } });
-Object.defineProperty(exports, "escapeUTF8", { enumerable: true, get: function () { return encode_2.escapeUTF8; } });
+var encode_js_2 = require("./encode.js");
+Object.defineProperty(exports, "encodeXML", { enumerable: true, get: function () { return encode_js_2.encodeXML; } });
+Object.defineProperty(exports, "encodeHTML", { enumerable: true, get: function () { return encode_js_2.encodeHTML; } });
+Object.defineProperty(exports, "encodeNonAsciiHTML", { enumerable: true, get: function () { return encode_js_2.encodeNonAsciiHTML; } });
+Object.defineProperty(exports, "escape", { enumerable: true, get: function () { return encode_js_2.escape; } });
+Object.defineProperty(exports, "escapeUTF8", { enumerable: true, get: function () { return encode_js_2.escapeUTF8; } });
+Object.defineProperty(exports, "escapeAttribute", { enumerable: true, get: function () { return encode_js_2.escapeAttribute; } });
+Object.defineProperty(exports, "escapeText", { enumerable: true, get: function () { return encode_js_2.escapeText; } });
 // Legacy aliases (deprecated)
-Object.defineProperty(exports, "encodeHTML4", { enumerable: true, get: function () { return encode_2.encodeHTML; } });
-Object.defineProperty(exports, "encodeHTML5", { enumerable: true, get: function () { return encode_2.encodeHTML; } });
-var decode_2 = require("./decode");
-Object.defineProperty(exports, "decodeXML", { enumerable: true, get: function () { return decode_2.decodeXML; } });
-Object.defineProperty(exports, "decodeHTML", { enumerable: true, get: function () { return decode_2.decodeHTML; } });
-Object.defineProperty(exports, "decodeHTMLStrict", { enumerable: true, get: function () { return decode_2.decodeHTMLStrict; } });
+Object.defineProperty(exports, "encodeHTML4", { enumerable: true, get: function () { return encode_js_2.encodeHTML; } });
+Object.defineProperty(exports, "encodeHTML5", { enumerable: true, get: function () { return encode_js_2.encodeHTML; } });
+var decode_js_2 = require("./decode.js");
+Object.defineProperty(exports, "decodeXML", { enumerable: true, get: function () { return decode_js_2.decodeXML; } });
+Object.defineProperty(exports, "decodeHTML", { enumerable: true, get: function () { return decode_js_2.decodeHTML; } });
+Object.defineProperty(exports, "decodeHTMLStrict", { enumerable: true, get: function () { return decode_js_2.decodeHTMLStrict; } });
 // Legacy aliases (deprecated)
-Object.defineProperty(exports, "decodeHTML4", { enumerable: true, get: function () { return decode_2.decodeHTML; } });
-Object.defineProperty(exports, "decodeHTML5", { enumerable: true, get: function () { return decode_2.decodeHTML; } });
-Object.defineProperty(exports, "decodeHTML4Strict", { enumerable: true, get: function () { return decode_2.decodeHTMLStrict; } });
-Object.defineProperty(exports, "decodeHTML5Strict", { enumerable: true, get: function () { return decode_2.decodeHTMLStrict; } });
-Object.defineProperty(exports, "decodeXMLStrict", { enumerable: true, get: function () { return decode_2.decodeXML; } });
+Object.defineProperty(exports, "decodeHTML4", { enumerable: true, get: function () { return decode_js_2.decodeHTML; } });
+Object.defineProperty(exports, "decodeHTML5", { enumerable: true, get: function () { return decode_js_2.decodeHTML; } });
+Object.defineProperty(exports, "decodeHTML4Strict", { enumerable: true, get: function () { return decode_js_2.decodeHTMLStrict; } });
+Object.defineProperty(exports, "decodeHTML5Strict", { enumerable: true, get: function () { return decode_js_2.decodeHTMLStrict; } });
+Object.defineProperty(exports, "decodeXMLStrict", { enumerable: true, get: function () { return decode_js_2.decodeXML; } });
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/lib/maps/entities-encode.json

@@ -0,0 +1 @@
+{"\t":"Tab","\n":"NewLine","!":"excl","\"":"quot","#":"num","$":"dollar","%":"percnt","&":"amp","'":"apos","(":"lpar",")":"rpar","*":"midast","+":"plus",",":"comma",".":"period","/":"sol",":":"colon",";":"semi","<":"lt","<⃒":"nvlt","=":"equals","=⃥":"bne",">":"gt",">⃒":"nvgt","?":"quest","@":"commat","[":"lsqb","\\":"bsol","]":"rsqb","^":"Hat","_":"lowbar","`":"grave","fj":"fjlig","{":"lcub","|":"vert","}":"rcub"," ":"nbsp","¡":"iexcl","¢":"cent","£":"pound","¤":"curren","¥":"yen","¦":"brvbar","§":"sect","¨":"uml","©":"copy","ª":"ordf","«":"laquo","¬":"not","­":"shy","®":"reg","¯":"strns","°":"deg","±":"pm","²":"sup2","³":"sup3","´":"acute","µ":"micro","¶":"para","·":"middot","¸":"cedil","¹":"sup1","º":"ordm","»":"raquo","¼":"frac14","½":"half","¾":"frac34","¿":"iquest","À":"Agrave","Á":"Aacute","Â":"Acirc","Ã":"Atilde","Ä":"Auml","Å":"angst","Æ":"AElig","Ç":"Ccedil","È":"Egrave","É":"Eacute","Ê":"Ecirc","Ë":"Euml","Ì":"Igrave","Í":"Iacute","Î":"Icirc","Ï":"Iuml","Ð":"ETH","Ñ":"Ntilde","Ò":"Ograve","Ó":"Oacute","Ô":"Ocirc","Õ":"Otilde","Ö":"Ouml","×":"times","Ø":"Oslash","Ù":"Ugrave","Ú":"Uacute","Û":"Ucirc","Ü":"Uuml","Ý":"Yacute","Þ":"THORN","ß":"szlig","à":"agrave","á":"aacute","â":"acirc","ã":"atilde","ä":"auml","å":"aring","æ":"aelig","ç":"ccedil","è":"egrave","é":"eacute","ê":"ecirc","ë":"euml","ì":"igrave","í":"iacute","î":"icirc","ï":"iuml","ð":"eth","ñ":"ntilde","ò":"ograve","ó":"oacute","ô":"ocirc","õ":"otilde","ö":"ouml","÷":"divide","ø":"oslash","ù":"ugrave","ú":"uacute","û":"ucirc","ü":"uuml","ý":"yacute","þ":"thorn","ÿ":"yuml","Ā":"Amacr","ā":"amacr","Ă":"Abreve","ă":"abreve","Ą":"Aogon","ą":"aogon","Ć":"Cacute","ć":"cacute","Ĉ":"Ccirc","ĉ":"ccirc","Ċ":"Cdot","ċ":"cdot","Č":"Ccaron","č":"ccaron","Ď":"Dcaron","ď":"dcaron","Đ":"Dstrok","đ":"dstrok","Ē":"Emacr","ē":"emacr","Ė":"Edot","ė":"edot","Ę":"Eogon","ę":"eogon","Ě":"Ecaron","ě":"ecaron","Ĝ":"Gcirc","ĝ":"gcirc","Ğ":"Gbreve","ğ":"gbreve","Ġ":"Gdot","ġ":"gdot","Ģ":"Gcedil","Ĥ":"Hcirc","ĥ":"hcirc","Ħ":"Hstrok","ħ":"hstrok","Ĩ":"Itilde","ĩ":"itilde","Ī":"Imacr","ī":"imacr","Į":"Iogon","į":"iogon","İ":"Idot","ı":"inodot","IJ":"IJlig","ij":"ijlig","Ĵ":"Jcirc","ĵ":"jcirc","Ķ":"Kcedil","ķ":"kcedil","ĸ":"kgreen","Ĺ":"Lacute","ĺ":"lacute","Ļ":"Lcedil","ļ":"lcedil","Ľ":"Lcaron","ľ":"lcaron","Ŀ":"Lmidot","ŀ":"lmidot","Ł":"Lstrok","ł":"lstrok","Ń":"Nacute","ń":"nacute","Ņ":"Ncedil","ņ":"ncedil","Ň":"Ncaron","ň":"ncaron","ʼn":"napos","Ŋ":"ENG","ŋ":"eng","Ō":"Omacr","ō":"omacr","Ő":"Odblac","ő":"odblac","Œ":"OElig","œ":"oelig","Ŕ":"Racute","ŕ":"racute","Ŗ":"Rcedil","ŗ":"rcedil","Ř":"Rcaron","ř":"rcaron","Ś":"Sacute","ś":"sacute","Ŝ":"Scirc","ŝ":"scirc","Ş":"Scedil","ş":"scedil","Š":"Scaron","š":"scaron","Ţ":"Tcedil","ţ":"tcedil","Ť":"Tcaron","ť":"tcaron","Ŧ":"Tstrok","ŧ":"tstrok","Ũ":"Utilde","ũ":"utilde","Ū":"Umacr","ū":"umacr","Ŭ":"Ubreve","ŭ":"ubreve","Ů":"Uring","ů":"uring","Ű":"Udblac","ű":"udblac","Ų":"Uogon","ų":"uogon","Ŵ":"Wcirc","ŵ":"wcirc","Ŷ":"Ycirc","ŷ":"ycirc","Ÿ":"Yuml","Ź":"Zacute","ź":"zacute","Ż":"Zdot","ż":"zdot","Ž":"Zcaron","ž":"zcaron","ƒ":"fnof","Ƶ":"imped","ǵ":"gacute","ȷ":"jmath","ˆ":"circ","ˇ":"caron","˘":"breve","˙":"dot","˚":"ring","˛":"ogon","˜":"tilde","˝":"dblac","̑":"DownBreve","Α":"Alpha","Β":"Beta","Γ":"Gamma","Δ":"Delta","Ε":"Epsilon","Ζ":"Zeta","Η":"Eta","Θ":"Theta","Ι":"Iota","Κ":"Kappa","Λ":"Lambda","Μ":"Mu","Ν":"Nu","Ξ":"Xi","Ο":"Omicron","Π":"Pi","Ρ":"Rho","Σ":"Sigma","Τ":"Tau","Υ":"Upsilon","Φ":"Phi","Χ":"Chi","Ψ":"Psi","Ω":"ohm","α":"alpha","β":"beta","γ":"gamma","δ":"delta","ε":"epsilon","ζ":"zeta","η":"eta","θ":"theta","ι":"iota","κ":"kappa","λ":"lambda","μ":"mu","ν":"nu","ξ":"xi","ο":"omicron","π":"pi","ρ":"rho","ς":"varsigma","σ":"sigma","τ":"tau","υ":"upsilon","φ":"phi","χ":"chi","ψ":"psi","ω":"omega","ϑ":"vartheta","ϒ":"upsih","ϕ":"varphi","ϖ":"varpi","Ϝ":"Gammad","ϝ":"gammad","ϰ":"varkappa","ϱ":"varrho","ϵ":"varepsilon","϶":"bepsi","Ё":"IOcy","Ђ":"DJcy","Ѓ":"GJcy","Є":"Jukcy","Ѕ":"DScy","І":"Iukcy","Ї":"YIcy","Ј":"Jsercy","Љ":"LJcy","Њ":"NJcy","Ћ":"TSHcy","Ќ":"KJcy","Ў":"Ubrcy","Џ":"DZcy","А":"Acy","Б":"Bcy","В":"Vcy","Г":"Gcy","Д":"Dcy","Е":"IEcy","Ж":"ZHcy","З":"Zcy","И":"Icy","Й":"Jcy","К":"Kcy","Л":"Lcy","М":"Mcy","Н":"Ncy","О":"Ocy","П":"Pcy","Р":"Rcy","С":"Scy","Т":"Tcy","У":"Ucy","Ф":"Fcy","Х":"KHcy","Ц":"TScy","Ч":"CHcy","Ш":"SHcy","Щ":"SHCHcy","Ъ":"HARDcy","Ы":"Ycy","Ь":"SOFTcy","Э":"Ecy","Ю":"YUcy","Я":"YAcy","а":"acy","б":"bcy","в":"vcy","г":"gcy","д":"dcy","е":"iecy","ж":"zhcy","з":"zcy","и":"icy","й":"jcy","к":"kcy","л":"lcy","м":"mcy","н":"ncy","о":"ocy","п":"pcy","р":"rcy","с":"scy","т":"tcy","у":"ucy","ф":"fcy","х":"khcy","ц":"tscy","ч":"chcy","ш":"shcy","щ":"shchcy","ъ":"hardcy","ы":"ycy","ь":"softcy","э":"ecy","ю":"yucy","я":"yacy","ё":"iocy","ђ":"djcy","ѓ":"gjcy","є":"jukcy","ѕ":"dscy","і":"iukcy","ї":"yicy","ј":"jsercy","љ":"ljcy","њ":"njcy","ћ":"tshcy","ќ":"kjcy","ў":"ubrcy","џ":"dzcy"," ":"ensp"," ":"emsp"," ":"emsp13"," ":"emsp14"," ":"numsp"," ":"puncsp"," ":"thinsp"," ":"hairsp","​":"ZeroWidthSpace","‌":"zwnj","‍":"zwj","‎":"lrm","‏":"rlm","‐":"hyphen","–":"ndash","—":"mdash","―":"horbar","‖":"Vert","‘":"lsquo","’":"rsquor","‚":"sbquo","“":"ldquo","”":"rdquor","„":"ldquor","†":"dagger","‡":"ddagger","•":"bullet","‥":"nldr","…":"mldr","‰":"permil","‱":"pertenk","′":"prime","″":"Prime","‴":"tprime","‵":"bprime","‹":"lsaquo","›":"rsaquo","‾":"oline","⁁":"caret","⁃":"hybull","⁄":"frasl","⁏":"bsemi","⁗":"qprime"," ":"MediumSpace","  ":"ThickSpace","⁠":"NoBreak","⁡":"af","⁢":"it","⁣":"ic","€":"euro","⃛":"tdot","⃜":"DotDot","ℂ":"complexes","℅":"incare","ℊ":"gscr","ℋ":"hamilt","ℌ":"Poincareplane","ℍ":"quaternions","ℎ":"planckh","ℏ":"plankv","ℐ":"imagline","ℑ":"imagpart","ℒ":"lagran","ℓ":"ell","ℕ":"naturals","№":"numero","℗":"copysr","℘":"wp","ℙ":"primes","ℚ":"rationals","ℛ":"realine","ℜ":"realpart","ℝ":"reals","℞":"rx","™":"trade","ℤ":"integers","℧":"mho","ℨ":"zeetrf","℩":"iiota","ℬ":"bernou","ℭ":"Cfr","ℯ":"escr","ℰ":"expectation","ℱ":"Fscr","ℳ":"phmmat","ℴ":"oscr","ℵ":"aleph","ℶ":"beth","ℷ":"gimel","ℸ":"daleth","ⅅ":"DD","ⅆ":"dd","ⅇ":"exponentiale","ⅈ":"ii","⅓":"frac13","⅔":"frac23","⅕":"frac15","⅖":"frac25","⅗":"frac35","⅘":"frac45","⅙":"frac16","⅚":"frac56","⅛":"frac18","⅜":"frac38","⅝":"frac58","⅞":"frac78","←":"slarr","↑":"uparrow","→":"srarr","↓":"downarrow","↔":"leftrightarrow","↕":"varr","↖":"nwarrow","↗":"nearrow","↘":"searrow","↙":"swarrow","↚":"nleftarrow","↛":"nrightarrow","↝":"rightsquigarrow","↝̸":"nrarrw","↞":"twoheadleftarrow","↟":"Uarr","↠":"twoheadrightarrow","↡":"Darr","↢":"leftarrowtail","↣":"rightarrowtail","↤":"mapstoleft","↥":"mapstoup","↦":"mapsto","↧":"mapstodown","↩":"larrhk","↪":"rarrhk","↫":"looparrowleft","↬":"rarrlp","↭":"leftrightsquigarrow","↮":"nleftrightarrow","↰":"lsh","↱":"rsh","↲":"ldsh","↳":"rdsh","↵":"crarr","↶":"curvearrowleft","↷":"curvearrowright","↺":"olarr","↻":"orarr","↼":"lharu","↽":"lhard","↾":"upharpoonright","↿":"upharpoonleft","⇀":"rightharpoonup","⇁":"rightharpoondown","⇂":"downharpoonright","⇃":"downharpoonleft","⇄":"rlarr","⇅":"udarr","⇆":"lrarr","⇇":"llarr","⇈":"uuarr","⇉":"rrarr","⇊":"downdownarrows","⇋":"lrhar","⇌":"rlhar","⇍":"nlArr","⇎":"nhArr","⇏":"nrArr","⇐":"lArr","⇑":"uArr","⇒":"rArr","⇓":"dArr","⇔":"iff","⇕":"vArr","⇖":"nwArr","⇗":"neArr","⇘":"seArr","⇙":"swArr","⇚":"lAarr","⇛":"rAarr","⇝":"zigrarr","⇤":"larrb","⇥":"rarrb","⇵":"duarr","⇽":"loarr","⇾":"roarr","⇿":"hoarr","∀":"forall","∁":"complement","∂":"part","∂̸":"npart","∃":"exist","∄":"nexists","∅":"varnothing","∇":"nabla","∈":"isinv","∉":"notinva","∋":"niv","∌":"notniva","∏":"prod","∐":"coprod","∑":"sum","−":"minus","∓":"mp","∔":"plusdo","∖":"ssetmn","∗":"lowast","∘":"compfn","√":"radic","∝":"vprop","∞":"infin","∟":"angrt","∠":"angle","∠⃒":"nang","∡":"measuredangle","∢":"angsph","∣":"smid","∤":"nsmid","∥":"spar","∦":"nspar","∧":"wedge","∨":"vee","∩":"cap","∩︀":"caps","∪":"cup","∪︀":"cups","∫":"int","∬":"Int","∭":"tint","∮":"oint","∯":"DoubleContourIntegral","∰":"Cconint","∱":"cwint","∲":"cwconint","∳":"awconint","∴":"therefore","∵":"because","∶":"ratio","∷":"Proportion","∸":"minusd","∺":"mDDot","∻":"homtht","∼":"thksim","∼⃒":"nvsim","∽":"bsim","∽̱":"race","∾":"mstpos","∾̳":"acE","∿":"acd","≀":"wreath","≁":"nsim","≂":"esim","≂̸":"nesim","≃":"simeq","≄":"nsimeq","≅":"cong","≆":"simne","≇":"ncong","≈":"thkap","≉":"napprox","≊":"approxeq","≋":"apid","≋̸":"napid","≌":"bcong","≍":"asympeq","≍⃒":"nvap","≎":"bump","≎̸":"nbump","≏":"bumpeq","≏̸":"nbumpe","≐":"esdot","≐̸":"nedot","≑":"eDot","≒":"fallingdotseq","≓":"risingdotseq","≔":"coloneq","≕":"eqcolon","≖":"eqcirc","≗":"cire","≙":"wedgeq","≚":"veeeq","≜":"trie","≟":"questeq","≠":"ne","≡":"equiv","≡⃥":"bnequiv","≢":"nequiv","≤":"leq","≤⃒":"nvle","≥":"geq","≥⃒":"nvge","≦":"leqq","≦̸":"nleqq","≧":"geqq","≧̸":"ngeqq","≨":"lneqq","≨︀":"lvnE","≩":"gneqq","≩︀":"gvnE","≪":"ll","≪̸":"nLtv","≪⃒":"nLt","≫":"gg","≫̸":"nGtv","≫⃒":"nGt","≬":"twixt","≭":"NotCupCap","≮":"nlt","≯":"ngtr","≰":"nleq","≱":"ngeq","≲":"lsim","≳":"gtrsim","≴":"nlsim","≵":"ngsim","≶":"lg","≷":"gtrless","≸":"ntlg","≹":"ntgl","≺":"prec","≻":"succ","≼":"preccurlyeq","≽":"succcurlyeq","≾":"prsim","≿":"succsim","≿̸":"NotSucceedsTilde","⊀":"nprec","⊁":"nsucc","⊂":"subset","⊂⃒":"vnsub","⊃":"supset","⊃⃒":"vnsup","⊄":"nsub","⊅":"nsup","⊆":"subseteq","⊇":"supseteq","⊈":"nsubseteq","⊉":"nsupseteq","⊊":"subsetneq","⊊︀":"vsubne","⊋":"supsetneq","⊋︀":"vsupne","⊍":"cupdot","⊎":"uplus","⊏":"sqsubset","⊏̸":"NotSquareSubset","⊐":"sqsupset","⊐̸":"NotSquareSuperset","⊑":"sqsubseteq","⊒":"sqsupseteq","⊓":"sqcap","⊓︀":"sqcaps","⊔":"sqcup","⊔︀":"sqcups","⊕":"oplus","⊖":"ominus","⊗":"otimes","⊘":"osol","⊙":"odot","⊚":"ocir","⊛":"oast","⊝":"odash","⊞":"plusb","⊟":"minusb","⊠":"timesb","⊡":"sdotb","⊢":"vdash","⊣":"dashv","⊤":"top","⊥":"perp","⊧":"models","⊨":"vDash","⊩":"Vdash","⊪":"Vvdash","⊫":"VDash","⊬":"nvdash","⊭":"nvDash","⊮":"nVdash","⊯":"nVDash","⊰":"prurel","⊲":"vltri","⊳":"vrtri","⊴":"trianglelefteq","⊴⃒":"nvltrie","⊵":"trianglerighteq","⊵⃒":"nvrtrie","⊶":"origof","⊷":"imof","⊸":"mumap","⊹":"hercon","⊺":"intercal","⊻":"veebar","⊽":"barvee","⊾":"angrtvb","⊿":"lrtri","⋀":"xwedge","⋁":"xvee","⋂":"xcap","⋃":"xcup","⋄":"diamond","⋅":"sdot","⋆":"sstarf","⋇":"divonx","⋈":"bowtie","⋉":"ltimes","⋊":"rtimes","⋋":"lthree","⋌":"rthree","⋍":"bsime","⋎":"cuvee","⋏":"cuwed","⋐":"Subset","⋑":"Supset","⋒":"Cap","⋓":"Cup","⋔":"pitchfork","⋕":"epar","⋖":"ltdot","⋗":"gtrdot","⋘":"Ll","⋘̸":"nLl","⋙":"ggg","⋙̸":"nGg","⋚":"lesseqgtr","⋚︀":"lesg","⋛":"gtreqless","⋛︀":"gesl","⋞":"curlyeqprec","⋟":"curlyeqsucc","⋠":"nprcue","⋡":"nsccue","⋢":"nsqsube","⋣":"nsqsupe","⋦":"lnsim","⋧":"gnsim","⋨":"prnsim","⋩":"succnsim","⋪":"ntriangleleft","⋫":"ntriangleright","⋬":"ntrianglelefteq","⋭":"ntrianglerighteq","⋮":"vellip","⋯":"ctdot","⋰":"utdot","⋱":"dtdot","⋲":"disin","⋳":"isinsv","⋴":"isins","⋵":"isindot","⋵̸":"notindot","⋶":"notinvc","⋷":"notinvb","⋹":"isinE","⋹̸":"notinE","⋺":"nisd","⋻":"xnis","⋼":"nis","⋽":"notnivc","⋾":"notnivb","⌅":"barwedge","⌆":"doublebarwedge","⌈":"lceil","⌉":"rceil","⌊":"lfloor","⌋":"rfloor","⌌":"drcrop","⌍":"dlcrop","⌎":"urcrop","⌏":"ulcrop","⌐":"bnot","⌒":"profline","⌓":"profsurf","⌕":"telrec","⌖":"target","⌜":"ulcorner","⌝":"urcorner","⌞":"llcorner","⌟":"lrcorner","⌢":"sfrown","⌣":"ssmile","⌭":"cylcty","⌮":"profalar","⌶":"topbot","⌽":"ovbar","⌿":"solbar","⍼":"angzarr","⎰":"lmoustache","⎱":"rmoustache","⎴":"tbrk","⎵":"bbrk","⎶":"bbrktbrk","⏜":"OverParenthesis","⏝":"UnderParenthesis","⏞":"OverBrace","⏟":"UnderBrace","⏢":"trpezium","⏧":"elinters","␣":"blank","Ⓢ":"oS","─":"boxh","│":"boxv","┌":"boxdr","┐":"boxdl","└":"boxur","┘":"boxul","├":"boxvr","┤":"boxvl","┬":"boxhd","┴":"boxhu","┼":"boxvh","═":"boxH","║":"boxV","╒":"boxdR","╓":"boxDr","╔":"boxDR","╕":"boxdL","╖":"boxDl","╗":"boxDL","╘":"boxuR","╙":"boxUr","╚":"boxUR","╛":"boxuL","╜":"boxUl","╝":"boxUL","╞":"boxvR","╟":"boxVr","╠":"boxVR","╡":"boxvL","╢":"boxVl","╣":"boxVL","╤":"boxHd","╥":"boxhD","╦":"boxHD","╧":"boxHu","╨":"boxhU","╩":"boxHU","╪":"boxvH","╫":"boxVh","╬":"boxVH","▀":"uhblk","▄":"lhblk","█":"block","░":"blk14","▒":"blk12","▓":"blk34","□":"square","▪":"squf","▫":"EmptyVerySmallSquare","▭":"rect","▮":"marker","▱":"fltns","△":"xutri","▴":"utrif","▵":"utri","▸":"rtrif","▹":"triangleright","▽":"xdtri","▾":"dtrif","▿":"triangledown","◂":"ltrif","◃":"triangleleft","◊":"lozenge","○":"cir","◬":"tridot","◯":"xcirc","◸":"ultri","◹":"urtri","◺":"lltri","◻":"EmptySmallSquare","◼":"FilledSmallSquare","★":"starf","☆":"star","☎":"phone","♀":"female","♂":"male","♠":"spadesuit","♣":"clubsuit","♥":"heartsuit","♦":"diams","♪":"sung","♭":"flat","♮":"natural","♯":"sharp","✓":"checkmark","✗":"cross","✠":"maltese","✶":"sext","❘":"VerticalSeparator","❲":"lbbrk","❳":"rbbrk","⟈":"bsolhsub","⟉":"suphsol","⟦":"lobrk","⟧":"robrk","⟨":"langle","⟩":"rangle","⟪":"Lang","⟫":"Rang","⟬":"loang","⟭":"roang","⟵":"xlarr","⟶":"xrarr","⟷":"xharr","⟸":"xlArr","⟹":"xrArr","⟺":"xhArr","⟼":"xmap","⟿":"dzigrarr","⤂":"nvlArr","⤃":"nvrArr","⤄":"nvHarr","⤅":"Map","⤌":"lbarr","⤍":"rbarr","⤎":"lBarr","⤏":"rBarr","⤐":"drbkarow","⤑":"DDotrahd","⤒":"UpArrowBar","⤓":"DownArrowBar","⤖":"Rarrtl","⤙":"latail","⤚":"ratail","⤛":"lAtail","⤜":"rAtail","⤝":"larrfs","⤞":"rarrfs","⤟":"larrbfs","⤠":"rarrbfs","⤣":"nwarhk","⤤":"nearhk","⤥":"searhk","⤦":"swarhk","⤧":"nwnear","⤨":"toea","⤩":"tosa","⤪":"swnwar","⤳":"rarrc","⤳̸":"nrarrc","⤵":"cudarrr","⤶":"ldca","⤷":"rdca","⤸":"cudarrl","⤹":"larrpl","⤼":"curarrm","⤽":"cularrp","⥅":"rarrpl","⥈":"harrcir","⥉":"Uarrocir","⥊":"lurdshar","⥋":"ldrushar","⥎":"LeftRightVector","⥏":"RightUpDownVector","⥐":"DownLeftRightVector","⥑":"LeftUpDownVector","⥒":"LeftVectorBar","⥓":"RightVectorBar","⥔":"RightUpVectorBar","⥕":"RightDownVectorBar","⥖":"DownLeftVectorBar","⥗":"DownRightVectorBar","⥘":"LeftUpVectorBar","⥙":"LeftDownVectorBar","⥚":"LeftTeeVector","⥛":"RightTeeVector","⥜":"RightUpTeeVector","⥝":"RightDownTeeVector","⥞":"DownLeftTeeVector","⥟":"DownRightTeeVector","⥠":"LeftUpTeeVector","⥡":"LeftDownTeeVector","⥢":"lHar","⥣":"uHar","⥤":"rHar","⥥":"dHar","⥦":"luruhar","⥧":"ldrdhar","⥨":"ruluhar","⥩":"rdldhar","⥪":"lharul","⥫":"llhard","⥬":"rharul","⥭":"lrhard","⥮":"udhar","⥯":"duhar","⥰":"RoundImplies","⥱":"erarr","⥲":"simrarr","⥳":"larrsim","⥴":"rarrsim","⥵":"rarrap","⥶":"ltlarr","⥸":"gtrarr","⥹":"subrarr","⥻":"suplarr","⥼":"lfisht","⥽":"rfisht","⥾":"ufisht","⥿":"dfisht","⦅":"lopar","⦆":"ropar","⦋":"lbrke","⦌":"rbrke","⦍":"lbrkslu","⦎":"rbrksld","⦏":"lbrksld","⦐":"rbrkslu","⦑":"langd","⦒":"rangd","⦓":"lparlt","⦔":"rpargt","⦕":"gtlPar","⦖":"ltrPar","⦚":"vzigzag","⦜":"vangrt","⦝":"angrtvbd","⦤":"ange","⦥":"range","⦦":"dwangle","⦧":"uwangle","⦨":"angmsdaa","⦩":"angmsdab","⦪":"angmsdac","⦫":"angmsdad","⦬":"angmsdae","⦭":"angmsdaf","⦮":"angmsdag","⦯":"angmsdah","⦰":"bemptyv","⦱":"demptyv","⦲":"cemptyv","⦳":"raemptyv","⦴":"laemptyv","⦵":"ohbar","⦶":"omid","⦷":"opar","⦹":"operp","⦻":"olcross","⦼":"odsold","⦾":"olcir","⦿":"ofcir","⧀":"olt","⧁":"ogt","⧂":"cirscir","⧃":"cirE","⧄":"solb","⧅":"bsolb","⧉":"boxbox","⧍":"trisb","⧎":"rtriltri","⧏":"LeftTriangleBar","⧏̸":"NotLeftTriangleBar","⧐":"RightTriangleBar","⧐̸":"NotRightTriangleBar","⧜":"iinfin","⧝":"infintie","⧞":"nvinfin","⧣":"eparsl","⧤":"smeparsl","⧥":"eqvparsl","⧫":"lozf","⧴":"RuleDelayed","⧶":"dsol","⨀":"xodot","⨁":"xoplus","⨂":"xotime","⨄":"xuplus","⨆":"xsqcup","⨌":"qint","⨍":"fpartint","⨐":"cirfnint","⨑":"awint","⨒":"rppolint","⨓":"scpolint","⨔":"npolint","⨕":"pointint","⨖":"quatint","⨗":"intlarhk","⨢":"pluscir","⨣":"plusacir","⨤":"simplus","⨥":"plusdu","⨦":"plussim","⨧":"plustwo","⨩":"mcomma","⨪":"minusdu","⨭":"loplus","⨮":"roplus","⨯":"Cross","⨰":"timesd","⨱":"timesbar","⨳":"smashp","⨴":"lotimes","⨵":"rotimes","⨶":"otimesas","⨷":"Otimes","⨸":"odiv","⨹":"triplus","⨺":"triminus","⨻":"tritime","⨼":"iprod","⨿":"amalg","⩀":"capdot","⩂":"ncup","⩃":"ncap","⩄":"capand","⩅":"cupor","⩆":"cupcap","⩇":"capcup","⩈":"cupbrcap","⩉":"capbrcup","⩊":"cupcup","⩋":"capcap","⩌":"ccups","⩍":"ccaps","⩐":"ccupssm","⩓":"And","⩔":"Or","⩕":"andand","⩖":"oror","⩗":"orslope","⩘":"andslope","⩚":"andv","⩛":"orv","⩜":"andd","⩝":"ord","⩟":"wedbar","⩦":"sdote","⩪":"simdot","⩭":"congdot","⩭̸":"ncongdot","⩮":"easter","⩯":"apacir","⩰":"apE","⩰̸":"napE","⩱":"eplus","⩲":"pluse","⩳":"Esim","⩴":"Colone","⩵":"Equal","⩷":"eDDot","⩸":"equivDD","⩹":"ltcir","⩺":"gtcir","⩻":"ltquest","⩼":"gtquest","⩽":"les","⩽̸":"nles","⩾":"ges","⩾̸":"nges","⩿":"lesdot","⪀":"gesdot","⪁":"lesdoto","⪂":"gesdoto","⪃":"lesdotor","⪄":"gesdotol","⪅":"lessapprox","⪆":"gtrapprox","⪇":"lneq","⪈":"gneq","⪉":"lnapprox","⪊":"gnapprox","⪋":"lesseqqgtr","⪌":"gtreqqless","⪍":"lsime","⪎":"gsime","⪏":"lsimg","⪐":"gsiml","⪑":"lgE","⪒":"glE","⪓":"lesges","⪔":"gesles","⪕":"eqslantless","⪖":"eqslantgtr","⪗":"elsdot","⪘":"egsdot","⪙":"el","⪚":"eg","⪝":"siml","⪞":"simg","⪟":"simlE","⪠":"simgE","⪡":"LessLess","⪡̸":"NotNestedLessLess","⪢":"GreaterGreater","⪢̸":"NotNestedGreaterGreater","⪤":"glj","⪥":"gla","⪦":"ltcc","⪧":"gtcc","⪨":"lescc","⪩":"gescc","⪪":"smt","⪫":"lat","⪬":"smte","⪬︀":"smtes","⪭":"late","⪭︀":"lates","⪮":"bumpE","⪯":"preceq","⪯̸":"npreceq","⪰":"succeq","⪰̸":"nsucceq","⪳":"prE","⪴":"scE","⪵":"prnE","⪶":"succneqq","⪷":"precapprox","⪸":"succapprox","⪹":"prnap","⪺":"succnapprox","⪻":"Pr","⪼":"Sc","⪽":"subdot","⪾":"supdot","⪿":"subplus","⫀":"supplus","⫁":"submult","⫂":"supmult","⫃":"subedot","⫄":"supedot","⫅":"subseteqq","⫅̸":"nsubseteqq","⫆":"supseteqq","⫆̸":"nsupseteqq","⫇":"subsim","⫈":"supsim","⫋":"subsetneqq","⫋︀":"vsubnE","⫌":"supsetneqq","⫌︀":"vsupnE","⫏":"csub","⫐":"csup","⫑":"csube","⫒":"csupe","⫓":"subsup","⫔":"supsub","⫕":"subsub","⫖":"supsup","⫗":"suphsub","⫘":"supdsub","⫙":"forkv","⫚":"topfork","⫛":"mlcp","⫤":"DoubleLeftTee","⫦":"Vdashl","⫧":"Barv","⫨":"vBar","⫩":"vBarv","⫫":"Vbar","⫬":"Not","⫭":"bNot","⫮":"rnmid","⫯":"cirmid","⫰":"midcir","⫱":"topcir","⫲":"nhpar","⫳":"parsim","⫽":"parsl","⫽⃥":"nparsl","ff":"fflig","fi":"filig","fl":"fllig","ffi":"ffilig","ffl":"ffllig","𝒜":"Ascr","𝒞":"Cscr","𝒟":"Dscr","𝒢":"Gscr","𝒥":"Jscr","𝒦":"Kscr","𝒩":"Nscr","𝒪":"Oscr","𝒫":"Pscr","𝒬":"Qscr","𝒮":"Sscr","𝒯":"Tscr","𝒰":"Uscr","𝒱":"Vscr","𝒲":"Wscr","𝒳":"Xscr","𝒴":"Yscr","𝒵":"Zscr","𝒶":"ascr","𝒷":"bscr","𝒸":"cscr","𝒹":"dscr","𝒻":"fscr","𝒽":"hscr","𝒾":"iscr","𝒿":"jscr","𝓀":"kscr","𝓁":"lscr","𝓂":"mscr","𝓃":"nscr","𝓅":"pscr","𝓆":"qscr","𝓇":"rscr","𝓈":"sscr","𝓉":"tscr","𝓊":"uscr","𝓋":"vscr","𝓌":"wscr","𝓍":"xscr","𝓎":"yscr","𝓏":"zscr","𝔄":"Afr","𝔅":"Bfr","𝔇":"Dfr","𝔈":"Efr","𝔉":"Ffr","𝔊":"Gfr","𝔍":"Jfr","𝔎":"Kfr","𝔏":"Lfr","𝔐":"Mfr","𝔑":"Nfr","𝔒":"Ofr","𝔓":"Pfr","𝔔":"Qfr","𝔖":"Sfr","𝔗":"Tfr","𝔘":"Ufr","𝔙":"Vfr","𝔚":"Wfr","𝔛":"Xfr","𝔜":"Yfr","𝔞":"afr","𝔟":"bfr","𝔠":"cfr","𝔡":"dfr","𝔢":"efr","𝔣":"ffr","𝔤":"gfr","𝔥":"hfr","𝔦":"ifr","𝔧":"jfr","𝔨":"kfr","𝔩":"lfr","𝔪":"mfr","𝔫":"nfr","𝔬":"ofr","𝔭":"pfr","𝔮":"qfr","𝔯":"rfr","𝔰":"sfr","𝔱":"tfr","𝔲":"ufr","𝔳":"vfr","𝔴":"wfr","𝔵":"xfr","𝔶":"yfr","𝔷":"zfr","𝔸":"Aopf","𝔹":"Bopf","𝔻":"Dopf","𝔼":"Eopf","𝔽":"Fopf","𝔾":"Gopf","𝕀":"Iopf","𝕁":"Jopf","𝕂":"Kopf","𝕃":"Lopf","𝕄":"Mopf","𝕆":"Oopf","𝕊":"Sopf","𝕋":"Topf","𝕌":"Uopf","𝕍":"Vopf","𝕎":"Wopf","𝕏":"Xopf","𝕐":"Yopf","𝕒":"aopf","𝕓":"bopf","𝕔":"copf","𝕕":"dopf","𝕖":"eopf","𝕗":"fopf","𝕘":"gopf","𝕙":"hopf","𝕚":"iopf","𝕛":"jopf","𝕜":"kopf","𝕝":"lopf","𝕞":"mopf","𝕟":"nopf","𝕠":"oopf","𝕡":"popf","𝕢":"qopf","𝕣":"ropf","𝕤":"sopf","𝕥":"topf","𝕦":"uopf","𝕧":"vopf","𝕨":"wopf","𝕩":"xopf","𝕪":"yopf","𝕫":"zopf"}

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "entities",
-    "version": "2.2.0",
-    "description": "Encode & decode XML and HTML entities with ease",
+    "version": "4.0.0",
+    "description": "Encode & decode XML and HTML entities with ease & speed",
     "author": "Felix Boehm <me@feedic.com>",
     "funding": "https://github.com/fb55/entities?sponsor=1",
     "sideEffects": false,
@@ -18,26 +18,40 @@
     },
     "main": "lib/index.js",
     "types": "lib/index.d.ts",
+    "module": "lib/esm/index.js",
+    "exports": {
+        ".": {
+            "require": "./lib/index.js",
+            "import": "./lib/esm/index.js"
+        },
+        "./lib/decode.js": {
+            "require": "./lib/decode.js",
+            "import": "./lib/esm/decode.js"
+        }
+    },
     "files": [
         "lib/**/*"
     ],
+    "engines": {
+        "node": ">=0.12"
+    },
     "devDependencies": {
-        "@types/jest": "^26.0.0",
-        "@types/node": "^14.11.8",
-        "@typescript-eslint/eslint-plugin": "^4.4.1",
-        "@typescript-eslint/parser": "^4.4.1",
-        "coveralls": "*",
-        "eslint": "^7.11.0",
-        "eslint-config-prettier": "^7.0.0",
+        "@types/jest": "^27.4.1",
+        "@types/node": "^17.0.23",
+        "@typescript-eslint/eslint-plugin": "^5.17.0",
+        "@typescript-eslint/parser": "^5.17.0",
+        "eslint": "^8.12.0",
+        "eslint-config-prettier": "^8.5.0",
         "eslint-plugin-node": "^11.1.0",
-        "jest": "^26.5.3",
-        "prettier": "^2.0.5",
-        "ts-jest": "^26.1.0",
-        "typescript": "^4.0.2"
+        "jest": "^27.5.1",
+        "prettier": "^2.6.1",
+        "ts-jest": "^27.1.4",
+        "typedoc": "^0.22.13",
+        "typescript": "^4.6.3"
     },
     "scripts": {
-        "test": "jest --coverage && npm run lint",
-        "coverage": "cat coverage/lcov.info | coveralls",
+        "test": "npm run test:jest && npm run lint",
+        "test:jest": "jest",
         "lint": "npm run lint:es && npm run lint:prettier",
         "lint:es": "eslint .",
         "lint:prettier": "npm run prettier -- --check",
@@ -45,7 +59,13 @@
         "format:es": "npm run lint:es -- --fix",
         "format:prettier": "npm run prettier -- --write",
         "prettier": "prettier '**/*.{ts,md,json,yml}'",
-        "build": "tsc && cp -r src/maps lib",
+        "build": "npm run build:cjs && npm run build:esm",
+        "build:cjs": "tsc && cp -r src/maps lib",
+        "build:esm": "tsc --module esnext --target es2019 --outDir lib/esm && npm rum build:esm:fixup && echo '{\"type\":\"module\"}' > lib/esm/package.json",
+        "build:esm:fixup": "sed -i.b '1s|\".*json\"|\"../maps/entities-encode.json\" assert {type:\"json\"}|' lib/esm/encode-trie.js && rm lib/esm/encode-trie.js.b",
+        "build:docs": "typedoc --hideGenerator src/index.ts",
+        "build:trie": "ts-node scripts/write-decode-map.ts",
+        "build:encode-map": "jq -c 'to_entries | reverse | map( {(.value) : .key } ) | sort | add' maps/entities.json > src/maps/entities-encode.json",
         "prepare": "npm run build"
     },
     "repository": {
@@ -55,7 +75,11 @@
     "license": "BSD-2-Clause",
     "jest": {
         "preset": "ts-jest",
-        "testEnvironment": "node"
+        "testEnvironment": "node",
+        "coverageProvider": "v8",
+        "moduleNameMapper": {
+            "^(.*)\\.js$": "$1"
+        }
     },
     "prettier": {
         "tabWidth": 4,

package/readme.md

@@ -2,6 +2,19 @@
 
 Encode & decode HTML & XML entities with ease & speed.
 
+## Features
+
+-   ⚔️ Battle tested: `entities` is used by many popular libraries; eg.
+    [`htmlparser2`](https://github.com/fb55/htmlparser2), the official
+    [AWS SDK](https://github.com/aws/aws-sdk-js-v3) and
+    [`commonmark`](https://github.com/commonmark/commonmark.js) use it to
+    process HTML entities.
+-   ⚡️ Fast: `entities` is the fastes library for decoding HTML entities (as of
+    August 2021); see [performance](#performance).
+-   🎛 Configurable: Get an output tailored for your needs. You are fine with
+    UTF8? That'll safe you some bytes. Prefer to only have ASCII characters? We
+    can do that as well!
+
 ## How to…
 
 ### …install `entities`
@@ -13,12 +26,12 @@ Encode & decode HTML & XML entities with ease & speed.
 ```javascript
 const entities = require("entities");
 
-//encoding
-entities.escape("&"); // "&"
-entities.encodeXML("&"); // "&"
-entities.encodeHTML("&"); // "&"
+// Encoding
+entities.escapeUTF8("& ü"); // "& ü"
+entities.encodeXML("& ü"); // "& ü"
+entities.encodeHTML("& ü"); // "& ü"
 
-//decoding
+// Decoding
 entities.decodeXML("asdf & ÿ ü '"); // "asdf & ÿ ü '"
 entities.decodeHTML("asdf & ÿ ü '"); // "asdf & ÿ ü '"
 ```
@@ -26,14 +39,67 @@ entities.decodeHTML("asdf & ÿ ü '"); // "asdf & ÿ ü '"
 ## Performance
 
 This is how `entities` compares to other libraries on a very basic benchmark
-(see `scripts/benchmark.ts`, for 10,000,000 iterations):
-
-| Library        | `decode` performance | `encode` performance | Bundle size                                                                |
-| -------------- | -------------------- | -------------------- | -------------------------------------------------------------------------- |
-| entities       | 10.809s              | 17.683s              | ![npm bundle size](https://img.shields.io/bundlephobia/min/entities)       |
-| html-entities  | 14.029s              | 22.670s              | ![npm bundle size](https://img.shields.io/bundlephobia/min/html-entities)  |
-| he             | 16.163s              | 44.010s              | ![npm bundle size](https://img.shields.io/bundlephobia/min/he)             |
-| parse-entities | 28.507s              | N/A                  | ![npm bundle size](https://img.shields.io/bundlephobia/min/parse-entities) |
+(see `scripts/benchmark.ts`, for 10,000,000 iterations; **lower is better**):
+
+| Library        | Version | `decode` perf | `encode` perf | `escape` perf |
+| -------------- | ------- | ------------- | ------------- | ------------- |
+| entities       | `3.0.1` | 1.418s        | 6.786s        | 2.196s        |
+| html-entities  | `2.3.2` | 2.530s        | 6.829s        | 2.415s        |
+| he             | `1.2.0` | 5.800s        | 24.237s       | 3.624s        |
+| parse-entities | `3.0.0` | 9.660s        | N/A           | N/A           |
+
+---
+
+## FAQ
+
+> What methods should I actually use to encode my documents?
+
+If your target supports UTF-8, the `escapeUTF8` method is going to be your best
+choice. Otherwise, use either `encodeHTML` or `encodeXML` based on whether
+you're dealing with an HTML or an XML document.
+
+You can have a look at the options for the `encode` and `decode` methods to see
+everything you can configure.
+
+> When should I use strict decoding?
+
+Strict decoding is for decoding entities in attributes, as well as in legacy
+environments. When strict decoding, entities not terminated with a semicolon
+will be ignored.
+
+> Why should I use `entities` instead of alternative modules?
+
+As of August 2021, `entities` is a bit faster than other modules. Still, this is
+not a very differentiated space and other modules can catch up.
+
+**More importantly**, you might already have `entities` in your dependency graph
+(as a dependency of eg. `cheerio`, or `htmlparser2`), and including it directly
+might not even increase your bundle size. The same is true for other entity
+libraries, so have a look through your `node_modules` directory!
+
+> Does `entities` support tree shaking?
+
+This depends on your bundler, but yes, it should! Eg. recent versions of Webpack
+are able to tree-shake commonjs projects, and having the `sideEffects` flag in
+the `package.json` set to `false` means that your bundles should be much
+smaller.
+
+---
+
+## Acknowledgements
+
+This libary wouldn't be possible without the work of these individuals. Thanks
+to
+
+-   [@mathiasbynens](https://github.com/mathiasbynens) for his explanations
+    about character encodings, and his library `he`, which was one of the
+    inspirations for `entities`
+-   [@inikulin](https://github.com/inikulin) for his work on optimized tries for
+    decoding HTML entities for the `parse5` project
+-   [@mdevils](https://github.com/mdevils) for taking on the challenge of
+    producing a quick entity library with his `html-entities` library.
+    `entities` would be quite a bit slower if there wasn't any competition.
+    Right now `entities` is on top, but we'll see how long that lasts!
 
 ---
 

package/lib/maps/decode.json

@@ -1 +0,0 @@
-{"0":65533,"128":8364,"130":8218,"131":402,"132":8222,"133":8230,"134":8224,"135":8225,"136":710,"137":8240,"138":352,"139":8249,"140":338,"142":381,"145":8216,"146":8217,"147":8220,"148":8221,"149":8226,"150":8211,"151":8212,"152":732,"153":8482,"154":353,"155":8250,"156":339,"158":382,"159":376}