/**
 * Utilities for string operations used throughout the Blueprint compiler.
 */

/**
 * Escapes special HTML characters in a string to prevent XSS attacks.
 * @param {string} text - The text to escape
 * @returns {string} - The escaped text
 */
const escapeHTML = (text) => {
  return text
    .replace(/&/g, "&")
    .replace(/</g, "&lt;")
    .replace(/>/g, "&gt;")
    .replace(/"/g, "&quot;")
    .replace(/'/g, "&#039;");
};

/**
 * Converts a camelCase string to kebab-case (lowercase with hyphens).
 * @param {string} str - The string to convert
 * @returns {string} - The converted string
 */
const toKebabCase = (str) => {
  return str.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
};

/**
 * Stringify an object while handling circular references.
 * @param {Object} obj - The object to stringify
 * @returns {string} - JSON string representation
 */
const safeStringify = (obj) => {
  const getCircularReplacer = () => {
    const seen = new WeakSet();
    return (key, value) => {
      if (key === "parent") return "[Circular:Parent]";
      if (typeof value === "object" && value !== null) {
        if (seen.has(value)) {
          return "[Circular]";
        }
        seen.add(value);
      }
      return value;
    };
  };

  try {
    return JSON.stringify(obj, getCircularReplacer(), 2);
  } catch (err) {
    return `[Unable to stringify: ${err.message}]`;
  }
};

module.exports = {
  escapeHTML,
  toKebabCase,
  safeStringify
};