xeroemoji 1.0.1 → 1.0.2

package/COMMERCIAL-LICENSE.md

@@ -1,5 +1,11 @@
-# Commercial use
+# Commercial license
 
-Xero Emoji is free for non-commercial use under CC BY-NC 4.0 (see `LICENSE`).
-Any commercial use (products, apps, fonts, merchandise, advertising, or redistribution for a fee) needs a separate commercial license from the author.
-Contact: maxi.grok.me
+The emoji artwork (`svg/`, `png/`, the release zips, the CDN images) and the npm/PyPI packages are under **CC BY 4.0** and can be used commercially with credit. No commercial license is needed for them. See [`LICENSING.md`](LICENSING.md).
+
+A separate commercial license from the author is needed for:
+
+- **The Xero Emoji color font** (`fonts/`): free for non-commercial use under CC BY-NC 4.0 (`fonts/LICENSE`); any commercial use of the font files (bundling them in a product or app, selling them, using them in paid products or advertising) needs a commercial license.
+- **The book**, *Xero Emoji Specimen Guide*: all rights reserved.
+- **Merchandise and stickers** (physical goods, sticker packs, prints): all rights reserved.
+
+Contact: maxinfeld@gmail.com

package/LICENSE

@@ -1,4 +1,4 @@
-Attribution-NonCommercial 4.0 International
+Attribution 4.0 International
 
 =======================================================================
 
@@ -54,18 +54,16 @@ exhaustive, and do not form part of our licenses.
 
 =======================================================================
 
-Creative Commons Attribution-NonCommercial 4.0 International Public
-License
+Creative Commons Attribution 4.0 International Public License
 
 By exercising the Licensed Rights (defined below), You accept and agree
 to be bound by the terms and conditions of this Creative Commons
-Attribution-NonCommercial 4.0 International Public License ("Public
-License"). To the extent this Public License may be interpreted as a
-contract, You are granted the Licensed Rights in consideration of Your
-acceptance of these terms and conditions, and the Licensor grants You
-such rights in consideration of benefits the Licensor receives from
-making the Licensed Material available under these terms and
-conditions.
+Attribution 4.0 International Public License ("Public License"). To the
+extent this Public License may be interpreted as a contract, You are
+granted the Licensed Rights in consideration of Your acceptance of
+these terms and conditions, and the Licensor grants You such rights in
+consideration of benefits the Licensor receives from making the
+Licensed Material available under these terms and conditions.
 
 
 Section 1 -- Definitions.
@@ -91,6 +89,7 @@ Section 1 -- Definitions.
      categorized. For purposes of this Public License, the rights
      specified in Section 2(b)(1)-(2) are not Copyright and Similar
      Rights.
+
   d. Effective Technological Measures means those measures that, in the
      absence of proper authority, may not be circumvented under laws
      fulfilling obligations under Article 11 of the WIPO Copyright
@@ -113,15 +112,7 @@ Section 1 -- Definitions.
   h. Licensor means the individual(s) or entity(ies) granting rights
      under this Public License.
 
-  i. NonCommercial means not primarily intended for or directed towards
-     commercial advantage or monetary compensation. For purposes of
-     this Public License, the exchange of the Licensed Material for
-     other material subject to Copyright and Similar Rights by digital
-     file-sharing or similar means is NonCommercial provided there is
-     no payment of monetary compensation in connection with the
-     exchange.
-
-  j. Share means to provide material to the public by any means or
+  i. Share means to provide material to the public by any means or
      process that requires permission under the Licensed Rights, such
      as reproduction, public display, public performance, distribution,
      dissemination, communication, or importation, and to make material
@@ -129,13 +120,13 @@ Section 1 -- Definitions.
      public may access the material from a place and at a time
      individually chosen by them.
 
-  k. Sui Generis Database Rights means rights other than copyright
+  j. Sui Generis Database Rights means rights other than copyright
      resulting from Directive 96/9/EC of the European Parliament and of
      the Council of 11 March 1996 on the legal protection of databases,
      as amended and/or succeeded, as well as other essentially
      equivalent rights anywhere in the world.
 
-  l. You means the individual or entity exercising the Licensed Rights
+  k. You means the individual or entity exercising the Licensed Rights
      under this Public License. Your has a corresponding meaning.
 
 
@@ -149,10 +140,9 @@ Section 2 -- Scope.
           exercise the Licensed Rights in the Licensed Material to:
 
             a. reproduce and Share the Licensed Material, in whole or
-               in part, for NonCommercial purposes only; and
+               in part; and
 
-            b. produce, reproduce, and Share Adapted Material for
-               NonCommercial purposes only.
+            b. produce, reproduce, and Share Adapted Material.
 
        2. Exceptions and Limitations. For the avoidance of doubt, where
           Exceptions and Limitations apply to Your use, this Public
@@ -214,9 +204,7 @@ Section 2 -- Scope.
           Rights, whether directly or through a collecting society
           under any voluntary or waivable statutory or compulsory
           licensing scheme. In all other cases the Licensor expressly
-          reserves any right to collect such royalties, including when
-          the Licensed Material is used other than for NonCommercial
-          purposes.
+          reserves any right to collect such royalties.
 
 
 Section 3 -- License Conditions.
@@ -278,8 +266,7 @@ apply to Your use of the Licensed Material:
 
   a. for the avoidance of doubt, Section 2(a)(1) grants You the right
      to extract, reuse, reproduce, and Share all or a substantial
-     portion of the contents of the database for NonCommercial purposes
-     only;
+     portion of the contents of the database;
 
   b. if You include all or a substantial portion of the database
      contents in a database in which You have Sui Generis Database
@@ -385,6 +372,7 @@ Section 8 -- Interpretation.
      that apply to the Licensor or You, including from the legal
      processes of any jurisdiction or authority.
 
+
 =======================================================================
 
 Creative Commons is not a party to its public

package/LICENSING.md

@@ -0,0 +1,34 @@
+# Licensing: what you can use, and how
+
+Xero Emoji is by Max Infeld. Different parts of this repository are under different licenses.
+
+## 1. The emoji artwork: CC BY 4.0 (free for any use, including commercial)
+
+These are licensed under the [Creative Commons Attribution 4.0 International license](https://creativecommons.org/licenses/by/4.0/) (SPDX `CC-BY-4.0`); full text in [`LICENSE`](LICENSE):
+
+- every emoji image in `svg/` and `png/`, and the same images in the release zips (`xeroemoji-svg.zip`, `xeroemoji-png-512.zip`, `xeroemoji-png-128.zip`, `xeroemoji-png-72.zip`) and on the jsDelivr CDN
+- the emoji data and lookup code: `demos/emoji-map.json`, `demos/xero-emoji.js`, and the `xeroemoji` npm and PyPI packages (`packages/`)
+- the gallery and demo pages in `demos/` and the MCP server in `mcp/`
+
+You may copy, redistribute, modify and use these for any purpose, including in commercial apps, products and open-source projects under any license, as long as you give credit.
+
+**Suggested attribution line:**
+
+> Xero Emoji by Max Infeld, CC BY 4.0
+
+Ideally link "Xero Emoji" to https://github.com/maximusmaximus/xeroemoji and "CC BY 4.0" to https://creativecommons.org/licenses/by/4.0/. If you changed the images, add "modified". A credit in your About page, docs, NOTICE or credits file is fine.
+
+## 2. Not covered by CC BY 4.0: commercial license
+
+These are **not** under CC BY 4.0. They stay under Max Infeld's separate commercial license (see [`COMMERCIAL-LICENSE.md`](COMMERCIAL-LICENSE.md)):
+
+- **The Xero Emoji color font** (`fonts/XeroEmoji-COLRv1.ttf`, `fonts/XeroEmoji-COLRv1.woff2`, and any other font build). Free for non-commercial use under CC BY-NC 4.0 (see [`fonts/LICENSE`](fonts/LICENSE)); any commercial use of the font file needs a commercial license. Building your own font from the CC BY 4.0 SVGs is allowed; the font files published here are what stay commercial.
+- **The book**, *Xero Emoji Specimen Guide* (https://xeroemoji.grok.me/book): all rights reserved.
+- **Merchandise and stickers** sold by or for Max Infeld (physical goods, sticker packs, prints, and their product listings): all rights reserved.
+- **The names "Xero Emoji" and "Xerographer"** and the author's name: CC licenses do not grant trademark rights. You may say your project uses Xero Emoji, but not imply it is made or endorsed by Max Infeld.
+
+Commercial licensing: maxinfeld@gmail.com
+
+## 3. Earlier releases
+
+Releases up to and including v1.0.0 (and the npm/PyPI package builds made from them) were published under CC BY-NC 4.0. The emoji images in those releases are the same artwork, and that artwork is now also available under CC BY 4.0, so you may use the images from earlier tags and releases (for example the `@v1.0.0` jsDelivr URLs) under CC BY 4.0 as well.

package/README.md

@@ -8,7 +8,7 @@ npm install xeroemoji
 
 ```js
 const xe = require('xeroemoji');
-xe.get('👍🏿').svgUrl;      // https://cdn.jsdelivr.net/gh/maximusmaximus/xeroemoji@v1.0.0/svg/1f44d-1f3ff.svg
+xe.get('👍🏿').svgUrl;      // https://cdn.jsdelivr.net/gh/maximusmaximus/xeroemoji@v1.0.2/svg/1f44d-1f3ff.svg
 xe.search('cat', { limit: 5 });
 xe.variants('👋');          // the default + 5 skin tones
 xe.setBase('/static/xeroemoji/');   // serve the images yourself
@@ -20,4 +20,4 @@ The full image sets (SVG, PNG 512/128/72) are zips on the [latest GitHub release
 
 ## License
 
-CC BY-NC 4.0 (SPDX `CC-BY-NC-4.0`). Credit "Xero Emoji by Max Infeld". **Commercial use needs a separate license**, see [COMMERCIAL-LICENSE.md](https://github.com/maximusmaximus/xeroemoji/blob/main/COMMERCIAL-LICENSE.md) (also included in this package).
+CC BY 4.0 (SPDX `CC-BY-4.0`). Free for any use, including commercial, with credit: "Xero Emoji by Max Infeld, CC BY 4.0" and a link to https://github.com/maximusmaximus/xeroemoji. The Xero Emoji color font, the book and merch are not covered and need a commercial license; see [LICENSING.md](https://github.com/maximusmaximus/xeroemoji/blob/main/LICENSING.md) (also included in this package). Versions up to 1.0.0 were CC BY-NC 4.0.

package/index.js

@@ -1,10 +1,10 @@
 'use strict';
-/* xeroemoji - Xero Emoji lookup for Node and bundlers. Artwork CC BY-NC 4.0; commercial use needs a license (COMMERCIAL-LICENSE.md).
+/* xeroemoji - Xero Emoji lookup for Node and bundlers. Artwork CC BY 4.0 (credit "Xero Emoji by Max Infeld, CC BY 4.0"); see LICENSING.md.
  *   const xe = require('xeroemoji');
- *   xe.get('👍🏿').svgUrl   // https://cdn.jsdelivr.net/gh/maximusmaximus/xeroemoji@v1.0.0/svg/1f44d-1f3ff.svg
+ *   xe.get('👍🏿').svgUrl   // https://cdn.jsdelivr.net/gh/maximusmaximus/xeroemoji@v1.0.2/svg/1f44d-1f3ff.svg
  */
-const VERSION = '1.0.1';
-const ART_TAG = 'v1.0.0';   // the GitHub tag the images are served from (art is unchanged since v1.0.0)
+const VERSION = '1.0.2';
+const ART_TAG = 'v1.0.2';   // the GitHub tag the images are served from (first CC BY 4.0 release; art unchanged since v1.0.0)
 let MAP = null;
 function map() {
   if (!MAP) MAP = require('./emoji-map.json');   // bundled by `npm pack` (prepack copies ../../demos/emoji-map.json)
@@ -70,5 +70,5 @@ function categories() {
 function url(q, format = 'svg') { const e = get(q); return e ? (format === 'png' ? e.pngUrl : e.svgUrl) : null; }
 /** Point URLs at your own host (e.g. '/static/xeroemoji/') after copying svg/ and png/ there. */
 function setBase(b) { BASE = b.endsWith('/') ? b : b + '/'; }
-const LICENSE = 'Artwork CC BY-NC 4.0 (credit "Xero Emoji by Max Infeld"); commercial use needs a license: https://github.com/maximusmaximus/xeroemoji/blob/main/COMMERCIAL-LICENSE.md';
+const LICENSE = 'Artwork CC BY 4.0, free for any use including commercial (credit "Xero Emoji by Max Infeld, CC BY 4.0", link https://github.com/maximusmaximus/xeroemoji). Details: https://github.com/maximusmaximus/xeroemoji/blob/main/LICENSING.md';
 module.exports = { VERSION, LICENSE, key, get, search, variants, categories, url, setBase, map };

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "xeroemoji",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Xero Emoji lookup: 3,963 Unicode Emoji 18.0 emoji -> SVG/PNG URLs (jsDelivr), names, groups, skin tones, plus the browser replacer.",
   "main": "index.js",
   "types": "index.d.ts",
   "bin": {"xeroemoji": "cli.js"},
-  "files": ["index.js", "index.d.ts", "cli.js", "xero-emoji.js", "emoji-map.json", "README.md", "LICENSE", "COMMERCIAL-LICENSE.md"],
+  "files": ["index.js", "index.d.ts", "cli.js", "xero-emoji.js", "xero-emoji-picker.js", "emoji-map.json", "README.md", "LICENSE", "LICENSING.md", "COMMERCIAL-LICENSE.md"],
   "keywords": ["emoji", "svg", "unicode", "emoji-font", "xeroemoji"],
   "homepage": "https://maximusmaximus.github.io/xeroemoji/",
   "bugs": {"url": "https://github.com/maximusmaximus/xeroemoji/issues"},
   "repository": {"type": "git", "url": "git+https://github.com/maximusmaximus/xeroemoji.git", "directory": "packages/npm"},
   "author": {"name": "Max Infeld", "url": "https://github.com/maximusmaximus"},
-  "license": "CC-BY-NC-4.0",
+  "license": "CC-BY-4.0",
   "engines": {"node": ">=18"},
-  "scripts": {"prepack": "node -e \"const fs=require('fs');fs.copyFileSync('../../demos/emoji-map.json','emoji-map.json');fs.copyFileSync('../../demos/xero-emoji.js','xero-emoji.js');fs.copyFileSync('../../LICENSE','LICENSE');fs.copyFileSync('../../COMMERCIAL-LICENSE.md','COMMERCIAL-LICENSE.md')\"", "test": "node test.js"}
+  "scripts": {"prepack": "node -e \"const fs=require('fs');fs.copyFileSync('../../demos/emoji-map.json','emoji-map.json');fs.copyFileSync('../../demos/xero-emoji.js','xero-emoji.js');fs.copyFileSync('../../LICENSE','LICENSE');fs.copyFileSync('../../LICENSING.md','LICENSING.md');fs.copyFileSync('../../COMMERCIAL-LICENSE.md','COMMERCIAL-LICENSE.md')\"", "test": "node test.js"}
 }

package/xero-emoji-picker.js

@@ -0,0 +1,91 @@
+/*! xero-emoji-picker.js - tiny dependency-free emoji picker for Xero Emoji (artwork and code CC BY 4.0: "Xero Emoji by Max Infeld, CC BY 4.0")
+ * Usage:
+ *   <script src="https://cdn.jsdelivr.net/gh/maximusmaximus/xeroemoji@main/packages/npm/xero-emoji-picker.js"></script>
+ *   const picker = XeroEmojiPicker.attach(buttonEl, { onSelect: e => input.value += e.emoji });
+ *   // or XeroEmojiPicker.create({ container: el, onSelect }) for an inline picker
+ * Options: base (where svg/ lives; default jsDelivr v1.0.2), map (URL of emoji-map.json), onSelect({emoji,name,file,url}),
+ *          tone ('' | '1f3fb'..'1f3ff'), perRow (default 8), size (px, default 32)
+ */
+(function (root) {
+  'use strict';
+  var CDN = 'https://cdn.jsdelivr.net/gh/maximusmaximus/xeroemoji@v1.0.2/';
+  var TONE = /-1f3f[b-f]/g, cache = {};
+  var CSS = '.xep{font:14px system-ui,sans-serif;background:#fff;color:#1d1b18;border:1px solid #e6e2da;border-radius:14px;box-shadow:0 10px 32px rgba(0,0,0,.15);width:var(--w);padding:8px;box-sizing:border-box}' +
+    '.xep input{width:100%;box-sizing:border-box;font:inherit;padding:7px 10px;border:1px solid #e6e2da;border-radius:9px;margin-bottom:6px}' +
+    '.xep .xep-bar{display:flex;gap:2px;overflow-x:auto;margin-bottom:6px}.xep .xep-bar button{flex:none;border:0;background:none;cursor:pointer;padding:3px 5px;border-radius:7px;opacity:.55}' +
+    '.xep .xep-bar button.on{opacity:1;background:#f3f0ea}.xep .xep-bar img{width:20px;height:20px;display:block}' +
+    '.xep .xep-grid{display:grid;grid-template-columns:repeat(var(--n),minmax(0,1fr));gap:2px;height:260px;overflow-y:auto;overflow-x:hidden}' +
+    '.xep .xep-grid button{border:0;background:none;padding:3px;border-radius:8px;cursor:pointer}.xep .xep-grid button:hover,.xep .xep-grid button:focus{background:#f3f0ea;outline:none}' +
+    '.xep .xep-grid img{width:var(--s);height:var(--s);display:block}.xep .xep-h{grid-column:1/-1;font-size:11px;text-transform:uppercase;color:#6b665e;margin:6px 2px 2px}' +
+    '.xep .xep-tones{display:flex;gap:2px;margin-top:6px}.xep .xep-tones button{border:1px solid transparent;background:none;border-radius:7px;cursor:pointer;width:24px;height:24px;padding:0}' +
+    '.xep .xep-tones button.on{border-color:#1d1b18}';
+  var TONES = ['', '1f3fb', '1f3fc', '1f3fd', '1f3fe', '1f3ff'], SW = ['#ffc83d', '#f7dece', '#f3d2a2', '#d5ab88', '#af7e57', '#7c533e'];
+  function el(tag, cls, html) { var e = document.createElement(tag); if (cls) e.className = cls; if (html != null) e.innerHTML = html; return e; }
+  function css() { if (document.getElementById('xep-css')) return; var s = el('style'); s.id = 'xep-css'; s.textContent = CSS; document.head.appendChild(s); }
+  function load(url) {
+    return cache[url] || (cache[url] = fetch(url).then(function (r) { return r.json(); }).then(function (m) {
+      var all = Object.keys(m).map(function (k) { var e = m[k], t = k.match(TONE);
+        return { k: k, f: e[0], e: e[1], n: e[2], g: e[3], sg: e[4], o: e[5], tn: t ? t.map(function (x) { return x.slice(1); }) : null,
+          base: t ? k.replace(TONE, '') : k, s: (e[2] + ' ' + e[4] + ' ' + k).toLowerCase() }; }).sort(function (a, b) { return a.o - b.o; });
+      var toned = {}; all.forEach(function (x) { if (x.tn) toned[x.base + '|' + x.tn.join(',')] = x; });
+      return { all: all, toned: toned };
+    }));
+  }
+  function create(opt) {
+    opt = opt || {}; css();
+    var base = opt.base || CDN, mapUrl = opt.map || base + 'demos/emoji-map.json', tone = opt.tone || '', group = null, q = '';
+    var box = el('div', 'xep'); box.style.setProperty('--n', opt.perRow || 8); box.style.setProperty('--s', (opt.size || 32) + 'px');
+    box.style.setProperty('--w', ((opt.perRow || 8) * ((opt.size || 32) + 8) + 24) + 'px');
+    box.setAttribute('role', 'dialog'); box.setAttribute('aria-label', 'Emoji picker');
+    var input = el('input'); input.type = 'search'; input.placeholder = 'Search emoji'; input.setAttribute('aria-label', 'Search emoji');
+    var bar = el('div', 'xep-bar'), grid = el('div', 'xep-grid'), tones = el('div', 'xep-tones');
+    box.appendChild(input); box.appendChild(bar); box.appendChild(grid); box.appendChild(tones);
+    TONES.forEach(function (t, i) { var b = el('button'); b.style.background = SW[i]; b.title = t ? 'skin tone ' + i : 'default skin tone';
+      b.className = t === tone ? 'on' : ''; b.onclick = function () { tone = t; [].forEach.call(tones.children, function (c) { c.className = c === b ? 'on' : ''; }); draw(); };
+      tones.appendChild(b); });
+    if (opt.container) opt.container.appendChild(box);
+    var data = null, timer = 0;
+    function src(x) { return base + 'svg/' + x.f + '.svg'; }
+    function shown(x) {
+      if (x.tn) return false; // base list only; tone applied on render
+      if (group && x.g !== group) return false;
+      if (!q) return true; return q.split(/\s+/).every(function (w) { return x.s.indexOf(w) >= 0; }) || x.e === q;
+    }
+    function toned(x) { if (!tone) return x; var n = (x.k.match(/1f9d1|1f468|1f469|1f9d2/g) || []).length || 1, keys = [];
+      for (var i = 0; i < Math.max(1, n); i++) keys.push(tone); return data.toned[x.k + '|' + keys.join(',')] || data.toned[x.k + '|' + tone] || x; }
+    function draw() {
+      if (!data) return; var html = '', sg = '', list = data.all.filter(shown);
+      list.forEach(function (x) { var y = toned(x); if (!q && x.sg !== sg) { sg = x.sg; html += '<div class="xep-h">' + sg + '</div>'; }
+        html += '<button type="button" data-k="' + y.k + '" title="' + y.n + '"><img loading="lazy" src="' + src(y) + '" alt="' + y.e + '"></button>'; });
+      grid.innerHTML = html || '<div class="xep-h">No match</div>';
+    }
+    grid.onclick = function (ev) { var b = ev.target.closest('button[data-k]'); if (!b) return;
+      var x = data.all.filter(function (y) { return y.k === b.dataset.k; })[0];
+      if (opt.onSelect) opt.onSelect({ emoji: x.e, name: x.n, file: x.f, url: src(x) });
+      if (api.onPick) api.onPick(x); };
+    input.oninput = function () { clearTimeout(timer); timer = setTimeout(function () { q = input.value.trim().toLowerCase(); draw(); }, 80); };
+    load(mapUrl).then(function (d) { data = d; var seen = {};
+      var gs = d.all.filter(function (x) { if (seen[x.g]) return false; seen[x.g] = 1; return true; });
+      bar.innerHTML = '<button type="button" class="on" data-g="" title="All">★</button>' + gs.map(function (x) {
+        return '<button type="button" data-g="' + x.g + '" title="' + x.g + '"><img src="' + src(x) + '" alt=""></button>'; }).join('');
+      bar.onclick = function (ev) { var b = ev.target.closest('button'); if (!b) return; group = b.dataset.g || null;
+        [].forEach.call(bar.children, function (c) { c.className = c === b ? 'on' : ''; }); grid.scrollTop = 0; draw(); };
+      draw(); });
+    var api = { element: box, focus: function () { input.focus(); }, destroy: function () { box.remove(); } };
+    return api;
+  }
+  function attach(button, opt) {
+    opt = opt || {}; var p = create(opt), b = p.element; b.style.position = 'absolute'; b.style.zIndex = 9999; b.hidden = true;
+    document.body.appendChild(b);
+    function close() { b.hidden = true; document.removeEventListener('mousedown', out); }
+    function out(ev) { if (!b.contains(ev.target) && ev.target !== button) close(); }
+    button.addEventListener('click', function () { if (!b.hidden) return close(); var r = button.getBoundingClientRect();
+      b.style.left = Math.max(4, r.left + scrollX) + 'px'; b.style.top = (r.bottom + scrollY + 6) + 'px'; b.hidden = false; p.focus();
+      document.addEventListener('mousedown', out); });
+    b.addEventListener('keydown', function (ev) { if (ev.key === 'Escape') { close(); button.focus(); } });
+    if (opt.closeOnSelect !== false) p.onPick = close;
+    p.open = function () { if (b.hidden) button.click(); }; p.close = close; return p;
+  }
+  var X = { create: create, attach: attach, version: '1.1.0' };
+  if (typeof module === 'object' && module.exports) module.exports = X; else root.XeroEmojiPicker = X;
+})(typeof self !== 'undefined' ? self : this);

package/xero-emoji.js

@@ -1,5 +1,5 @@
 /*! xero-emoji.js - swap Unicode emoji in text for Xero Emoji images. No dependencies.
- *  Xero Emoji (c) Max Infeld - artwork CC BY-NC 4.0, see LICENSE / COMMERCIAL-LICENSE.md.
+ *  Xero Emoji (c) Max Infeld - artwork CC BY 4.0 ("Xero Emoji by Max Infeld, CC BY 4.0"), see LICENSE / LICENSING.md.
  *
  *  await XeroEmoji.load({ base: '../', map: 'emoji-map.json', format: 'svg' });
  *  XeroEmoji.parse(element);          // replace emoji in all text nodes under element