entity input

Allows usage of HTML entities in regular input. Used via C+M+e.

You will need to install an extension such as Tampermonkey, Greasemonkey or Violentmonkey to install this script.

You will need to install an extension such as Tampermonkey or Violentmonkey to install this script.

You will need to install an extension such as Tampermonkey or Violentmonkey to install this script.

You will need to install an extension such as Tampermonkey or Userscripts to install this script.

You will need to install an extension such as Tampermonkey to install this script.

You will need to install a user script manager extension to install this script.

(I already have a user script manager, let me install it!)

You will need to install an extension such as Stylus to install this style.

You will need to install an extension such as Stylus to install this style.

You will need to install an extension such as Stylus to install this style.

You will need to install a user style manager extension to install this style.

You will need to install a user style manager extension to install this style.

You will need to install a user style manager extension to install this style.

(I already have a user style manager, let me install it!)

// ==UserScript==
// @name        entity input
// @namespace   Violentmonkey Scripts
// @match       *://*/*
// @grant       none
// @version     1.0.1
// @author      sectorae, a.k.a. elecke
// @description Allows usage of HTML entities in regular input. Used via C+M+e.
// @run-at      document-start
// @license     MIT
// ==/UserScript==

(() => {
  const asReadOnlySet = (arr) => new Set(arr);
  var KeyName;
  ((KeyName2) => {
    KeyName2['Enter'] = 'Enter';
    KeyName2['Escape'] = 'Escape';
  })(KeyName ||= {});
  const CONFIG = {
    activation : {ctrlKey : true, altKey : true, shiftKey : false, metaKey : false, key : 'e'},
    commitKeys : asReadOnlySet([ 'Enter' /* Enter */ ]),
    cancelKeys : asReadOnlySet([ 'Escape' /* Escape */ ]),
    ui : {
      enabled : true,
      okColor : '#72dec2',
      badColor : '#49988f',
      bg : '#000',
      fg : '#fff',
      font : '12px system-ui, -apple-system, Segoe UI, Roboto, Ubuntu',
      monoFont : '12px ui-monospace, Monaspace Krypton, SFMono-Regular, SF Mono, Menlo, Consolas, monospace',
      z : 2147483647
    }
  };
  const VALID_ENTITY_RE = /^(&(?:#[0-9]+|#x[0-9A-Fa-f]+|[A-Za-z][A-Za-z0-9]*);)$/;
  const normalizeEntity = (raw) => {
    const trimmed = raw.trim();
    const prefix = trimmed.startsWith('&') ? '' : '&';
    const suffix = trimmed.endsWith(';') ? '' : ';';
    return `${prefix}${trimmed}${suffix}`;
  };
  const decodeEntity = (entity) => {
    if (!VALID_ENTITY_RE.test(entity))
      return null;
    const doc = new DOMParser().parseFromString(entity, 'text/html');
    const decoded = doc.documentElement.textContent;
    return decoded === entity ? null : decoded;
  };
  const assertHtmlInput = (el) =>
    el != null && (el.tagName === 'TEXTAREA' ||
                   el.tagName === 'INPUT' &&
                     new Set([ '', 'text', 'search', 'url', 'tel', 'email', 'password', 'number' ]).has(el.type));
  const isPrintableKey = (key) => key.length === 1 || key === ' ';
  const ui = (() => {
    let root = null;
    let entitySpan = null;
    let previewSpan = null;
    const ensure = () => {
      if (root || !CONFIG.ui.enabled)
        return root;
      const host = document.createElement('div');
      const shadow = host.attachShadow({mode : 'closed'});
      root = document.createElement('div');
      entitySpan = document.createElement('span');
      previewSpan = document.createElement('span');
      root.textContent = 'Entity: ';
      root.append(entitySpan, previewSpan);
      Object.assign(root.style, {
        position : 'fixed',
        right : '12px',
        bottom : '12px',
        background : CONFIG.ui.bg,
        color : CONFIG.ui.fg,
        padding : '4px 8px',
        font : CONFIG.ui.font,
        zIndex : String(CONFIG.ui.z),
        pointerEvents : 'none',
        whiteSpace : 'pre',
        display : 'none'
      });
      entitySpan.style.font = CONFIG.ui.monoFont;
      shadow.appendChild(root);
      document.documentElement.appendChild(host);
      return root;
    };
    const show = (entityText, ok, decodedPreview) => {
      const d = ensure();
      if (!d)
        return;
      entitySpan.textContent = entityText;
      previewSpan.textContent = decodedPreview ? ` → ${decodedPreview}` : '';
      d.style.border = `1px solid ${ok ? CONFIG.ui.okColor : CONFIG.ui.badColor}`;
      d.style.display = 'block';
    };
    return {
      show,
      hide : () => root && (root.style.display = 'none'),
      destroy : () => root?.parentNode?.removeChild(root)
    };
  })();
  let armed = false;
  let buffer = '';
  let target = null;
  const isActivation = (e) => e.key.toLowerCase() === CONFIG.activation.key &&
                              e.ctrlKey === CONFIG.activation.ctrlKey && e.altKey === CONFIG.activation.altKey &&
                              e.shiftKey === CONFIG.activation.shiftKey && e.metaKey === CONFIG.activation.metaKey;
  const getActiveEditable = () => {
    const el = document.activeElement;
    return el instanceof HTMLElement && (el.isContentEditable || assertHtmlInput(el)) ? el : null;
  };
  const insertAtSelection = (el, text) => {
    if (el.isContentEditable) {
      const sel = window.getSelection();
      if (!sel?.rangeCount)
        return;
      const range = sel.getRangeAt(0);
      range.deleteContents();
      range.insertNode(document.createTextNode(text));
      range.collapse(false);
      sel.removeAllRanges();
      sel.addRange(range);
      return;
    }
    if (assertHtmlInput(el)) {
      const start = el.selectionStart ?? el.value.length;
      const end = el.selectionEnd ?? el.value.length;
      el.setRangeText(text, start, end, 'end');
      el.dispatchEvent(new InputEvent('input', {bubbles : true}));
    }
  };
  const reset = () => {
    armed = false;
    buffer = '';
    target = null;
    ui.hide();
  };
  const updateUI = () => {
    requestAnimationFrame(() => {
      if (!armed)
        return;
      if (!buffer)
        return ui.show('', false, '');
      const candidate = normalizeEntity(buffer);
      const decoded = decodeEntity(candidate);
      ui.show(buffer, !!decoded, decoded ?? '');
    });
  };
  const commitIfValid = () => {
    if (!armed || !buffer)
      return reset();
    const candidate = normalizeEntity(buffer);
    const decoded = decodeEntity(candidate);
    if (decoded) {
      target ? insertAtSelection(target, decoded) : navigator.clipboard.writeText(decoded).catch(console.error);
    }
    reset();
  };
  document.addEventListener('keydown', (evt) => {
    if (!armed && isActivation(evt)) {
      evt.preventDefault();
      evt.stopImmediatePropagation();
      armed = true;
      buffer = '';
      target = getActiveEditable();
      ui.show('', false, '');
      return;
    }
    if (!armed)
      return;
    evt.stopImmediatePropagation();
    if (CONFIG.cancelKeys.has(evt.key)) {
      evt.preventDefault();
      evt.stopImmediatePropagation();
      return reset();
    }
    if (CONFIG.commitKeys.has(evt.key)) {
      evt.preventDefault();
      evt.stopImmediatePropagation();
      return commitIfValid();
    }
    if (evt.key === 'Backspace') {
      evt.preventDefault();
      buffer = buffer.slice(0, -1);
      return updateUI();
    }
    if (evt.ctrlKey || evt.metaKey || evt.altKey || evt.key === 'Tab') {
      evt.preventDefault();
      return;
    }
    if (isPrintableKey(evt.key)) {
      evt.preventDefault();
      buffer += evt.key;
      updateUI();
    } else {
      evt.preventDefault();
    }
  }, true);
  document.addEventListener('focusin', () => armed && (target = getActiveEditable()), true);
  window.addEventListener('pagehide', () => {
    reset();
    ui.destroy();
  });
})();