@oat-sa/tao-core-ui 3.19.2 → 3.21.0

package/src/rubyHtml.js

@@ -1,153 +0,0 @@
-/**
- * Helpers for TAO i18n ruby annotation markup in UI components.
- */
-import $ from 'jquery';
-import DOMPurify from 'dompurify';
-
-const rubyTagPattern = /<ruby[\s>]|{ruby}/i;
-
-const purifyConfig = {
-    ADD_TAGS: ['ruby', 'rb', 'rt']
-};
-
-/**
- * Whether a string contains ruby annotation markup.
- * @param {String} str
- * @returns {Boolean}
- */
-export function containsRubyMarkup(str) {
-    return typeof str === 'string' && rubyTagPattern.test(str);
-}
-
-/**
- * Convert TAO i18n ruby placeholders to HTML tags.
- * @param {String} str
- * @returns {String}
- */
-export function normalizeRubyPlaceholders(str) {
-    if (typeof str !== 'string') {
-        return '';
-    }
-
-    return str
-        .replace(/\{ruby\}/g, '<ruby>')
-        .replace(/\{\/ruby\}/g, '</ruby>')
-        .replace(/\{rb\}/g, '<rb>')
-        .replace(/\{\/rb\}/g, '</rb>')
-        .replace(/\{rt\}/g, '<rt>')
-        .replace(/\{\/rt\}/g, '</rt>');
-}
-
-/**
- * Sanitize ruby HTML with the same tag allowlist used in templates.
- * @param {String} str
- * @returns {String}
- */
-export function sanitizeRubyHtml(str) {
-    if (typeof str !== 'string' || !str) {
-        return '';
-    }
-
-    return DOMPurify.sanitize(normalizeRubyPlaceholders(str), purifyConfig);
-}
-
-/**
- * Strip ruby markup to plain text (for placeholders and option text).
- * @param {String} str
- * @returns {String}
- */
-export function toPlainText(str) {
-    if (typeof str !== 'string' || !str) {
-        return '';
-    }
-
-    if (!containsRubyMarkup(str)) {
-        return str;
-    }
-
-    const template = document.createElement('template');
-    template.innerHTML = normalizeRubyPlaceholders(str);
-    template.content.querySelectorAll('rt').forEach(rt => rt.remove());
-
-    return template.content.textContent || '';
-}
-
-/**
- * @param {jQuery} $option
- * @returns {jQuery|String|null}
- */
-function formatRubyOption(option) {
-    if (!option.element) {
-        return null;
-    }
-
-    const rubyHtml = $(option.element).data('ruby-html');
-    if (rubyHtml) {
-        return $('<span>').html(sanitizeRubyHtml(rubyHtml));
-    }
-
-    return null;
-}
-
-/**
- * Prepare select options for select2 ruby rendering.
- * @param {jQuery} $select
- */
-export function prepareSelectOptions($select) {
-    $select.find('option').each(function prepareOption() {
-        const text = this.text;
-
-        if (!containsRubyMarkup(text)) {
-            return;
-        }
-
-        const sanitized = sanitizeRubyHtml(text);
-        $(this).data('ruby-html', sanitized);
-        this.text = toPlainText(sanitized);
-    });
-}
-
-/**
- * Strip ruby markup from select placeholder attributes.
- * @param {jQuery} $select
- */
-export function stripSelectPlaceholder($select) {
-    const placeholder = $select.attr('placeholder') || $select.data('placeholder');
-
-    if (placeholder && containsRubyMarkup(placeholder)) {
-        const plain = toPlainText(placeholder);
-        $select.attr('placeholder', plain);
-        $select.data('placeholder', plain);
-    }
-}
-
-/**
- * Add select2 formatters for ruby option labels.
- * @param {Object} [config]
- * @returns {Object}
- */
-export function enhanceSelect2Config(config) {
-    config = config || {};
-    const baseFormatResult = config.formatResult;
-    const baseFormatSelection = config.formatSelection;
-
-    config.formatResult = function formatResult(option, container, query) {
-        const ruby = formatRubyOption(option);
-        if (ruby !== null) {
-            return ruby;
-        }
-
-        return baseFormatResult ? baseFormatResult(option, container, query) : option.text;
-    };
-
-    config.formatSelection = function formatSelection(option) {
-        const ruby = formatRubyOption(option);
-        if (ruby !== null) {
-            return ruby;
-        }
-
-        return baseFormatSelection ? baseFormatSelection(option) : option.text;
-    };
-
-    return config;
-}