@ls-stack/utils 3.10.0 → 3.11.0

package/lib/xmlSerializer.cjs

@@ -0,0 +1,128 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/xmlSerializer.ts
+var xmlSerializer_exports = {};
+__export(xmlSerializer_exports, {
+  serializeXML: () => serializeXML
+});
+module.exports = __toCommonJS(xmlSerializer_exports);
+
+// src/arrayUtils.ts
+function filterAndMap(array, mapFilter) {
+  const result = [];
+  let i = -1;
+  for (const item of array) {
+    i += 1;
+    const filterResult = mapFilter(item, i);
+    if (filterResult !== false) {
+      result.push(filterResult);
+    }
+  }
+  return result;
+}
+
+// src/xmlSerializer.ts
+var XML_TAG_NAME_REGEX = /^[a-zA-Z_][a-zA-Z0-9._-]*$/;
+var XML_PREFIX_REGEX = /^xml/i;
+var XML_ESCAPE_MAP = {
+  "&": "&",
+  "<": "&lt;",
+  ">": "&gt;",
+  '"': "&quot;",
+  "'": "&#39;"
+};
+var XML_ESCAPE_REGEX = /[&<>"']/g;
+function serializeXML(node, options) {
+  return serializeWithLevel(node, options, 0);
+}
+function serializeWithLevel(node, options = {}, level) {
+  const { name, attributes = {}, children, escapeText: nodeEscapeText } = node;
+  const {
+    indent,
+    escapeText: globalEscapeText = true,
+    validateTagName = "throw"
+  } = options;
+  const shouldEscapeText = nodeEscapeText !== void 0 ? nodeEscapeText : globalEscapeText;
+  const indentStr = indent ? getIndentString(indent, level) : "";
+  const newline = indent ? "\n" : "";
+  if (validateTagName) {
+    if (!isValidXmlTagName(name)) {
+      if (validateTagName === "throw") {
+        throw new Error(`Invalid XML tag name: "${name}"`);
+      }
+      return "";
+    }
+  }
+  const attributesStr = filterAndMap(
+    Object.entries(attributes),
+    ([key, value]) => value !== null && value !== void 0 ? `${key}="${escapeXml(String(value))}"` : false
+  ).join(" ");
+  const attributesPart = attributesStr ? ` ${attributesStr}` : "";
+  if (children === void 0) {
+    return `${indentStr}<${name}${attributesPart} />`;
+  }
+  if (typeof children === "string") {
+    const processedText = shouldEscapeText ? escapeXml(children) : children;
+    if (processedText.includes("\n") && indent) {
+      const lines = processedText.split("\n");
+      const contentIndent = getIndentString(indent, level + 1);
+      const indentedLines = lines.map((line, index) => {
+        if (line.trim() === "") return "";
+        return index === 0 ? line : contentIndent + line;
+      });
+      const indentedText = indentedLines.join("\n");
+      return `${indentStr}<${name}${attributesPart}>
+${contentIndent}${indentedText}
+${indentStr}</${name}>`;
+    }
+    return `${indentStr}<${name}${attributesPart}>${processedText}</${name}>`;
+  }
+  if (children.length === 0) {
+    return `${indentStr}<${name}${attributesPart}></${name}>`;
+  }
+  const serializedChildren = filterAndMap(children, (child) => {
+    if (!child) return false;
+    const serializedChild = serializeWithLevel(child, options, level + 1);
+    return serializedChild || false;
+  });
+  if (serializedChildren.length === 0) {
+    return `${indentStr}<${name}${attributesPart}></${name}>`;
+  }
+  const childrenStr = serializedChildren.join(newline);
+  return `${indentStr}<${name}${attributesPart}>${newline}${childrenStr}${newline}${indentStr}</${name}>`;
+}
+function getIndentString(indent, level) {
+  if (typeof indent === "string") {
+    return indent.repeat(level);
+  }
+  return " ".repeat(indent * level);
+}
+function isValidXmlTagName(name) {
+  if (!name) return false;
+  if (XML_PREFIX_REGEX.test(name)) return false;
+  return XML_TAG_NAME_REGEX.test(name);
+}
+function escapeXml(text) {
+  return text.replace(XML_ESCAPE_REGEX, (char) => XML_ESCAPE_MAP[char]);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  serializeXML
+});

package/lib/xmlSerializer.d.cts

@@ -0,0 +1,14 @@
+type XMLNode = {
+    name: string;
+    attributes?: Record<string, string | number | boolean | null | undefined>;
+    children?: (XMLNode | null | undefined | false)[] | string;
+    escapeText?: boolean;
+};
+type SerializeOptions = {
+    indent?: number | string;
+    escapeText?: boolean;
+    validateTagName?: 'throw' | 'reject' | false;
+};
+declare function serializeXML(node: XMLNode, options?: SerializeOptions): string;
+
+export { type SerializeOptions, type XMLNode, serializeXML };

package/lib/xmlSerializer.d.ts

@@ -0,0 +1,14 @@
+type XMLNode = {
+    name: string;
+    attributes?: Record<string, string | number | boolean | null | undefined>;
+    children?: (XMLNode | null | undefined | false)[] | string;
+    escapeText?: boolean;
+};
+type SerializeOptions = {
+    indent?: number | string;
+    escapeText?: boolean;
+    validateTagName?: 'throw' | 'reject' | false;
+};
+declare function serializeXML(node: XMLNode, options?: SerializeOptions): string;
+
+export { type SerializeOptions, type XMLNode, serializeXML };

package/lib/xmlSerializer.js

@@ -0,0 +1,92 @@
+import {
+  filterAndMap
+} from "./chunk-UTFE4P3P.js";
+import "./chunk-3XCS7FVO.js";
+
+// src/xmlSerializer.ts
+var XML_TAG_NAME_REGEX = /^[a-zA-Z_][a-zA-Z0-9._-]*$/;
+var XML_PREFIX_REGEX = /^xml/i;
+var XML_ESCAPE_MAP = {
+  "&": "&",
+  "<": "&lt;",
+  ">": "&gt;",
+  '"': "&quot;",
+  "'": "&#39;"
+};
+var XML_ESCAPE_REGEX = /[&<>"']/g;
+function serializeXML(node, options) {
+  return serializeWithLevel(node, options, 0);
+}
+function serializeWithLevel(node, options = {}, level) {
+  const { name, attributes = {}, children, escapeText: nodeEscapeText } = node;
+  const {
+    indent,
+    escapeText: globalEscapeText = true,
+    validateTagName = "throw"
+  } = options;
+  const shouldEscapeText = nodeEscapeText !== void 0 ? nodeEscapeText : globalEscapeText;
+  const indentStr = indent ? getIndentString(indent, level) : "";
+  const newline = indent ? "\n" : "";
+  if (validateTagName) {
+    if (!isValidXmlTagName(name)) {
+      if (validateTagName === "throw") {
+        throw new Error(`Invalid XML tag name: "${name}"`);
+      }
+      return "";
+    }
+  }
+  const attributesStr = filterAndMap(
+    Object.entries(attributes),
+    ([key, value]) => value !== null && value !== void 0 ? `${key}="${escapeXml(String(value))}"` : false
+  ).join(" ");
+  const attributesPart = attributesStr ? ` ${attributesStr}` : "";
+  if (children === void 0) {
+    return `${indentStr}<${name}${attributesPart} />`;
+  }
+  if (typeof children === "string") {
+    const processedText = shouldEscapeText ? escapeXml(children) : children;
+    if (processedText.includes("\n") && indent) {
+      const lines = processedText.split("\n");
+      const contentIndent = getIndentString(indent, level + 1);
+      const indentedLines = lines.map((line, index) => {
+        if (line.trim() === "") return "";
+        return index === 0 ? line : contentIndent + line;
+      });
+      const indentedText = indentedLines.join("\n");
+      return `${indentStr}<${name}${attributesPart}>
+${contentIndent}${indentedText}
+${indentStr}</${name}>`;
+    }
+    return `${indentStr}<${name}${attributesPart}>${processedText}</${name}>`;
+  }
+  if (children.length === 0) {
+    return `${indentStr}<${name}${attributesPart}></${name}>`;
+  }
+  const serializedChildren = filterAndMap(children, (child) => {
+    if (!child) return false;
+    const serializedChild = serializeWithLevel(child, options, level + 1);
+    return serializedChild || false;
+  });
+  if (serializedChildren.length === 0) {
+    return `${indentStr}<${name}${attributesPart}></${name}>`;
+  }
+  const childrenStr = serializedChildren.join(newline);
+  return `${indentStr}<${name}${attributesPart}>${newline}${childrenStr}${newline}${indentStr}</${name}>`;
+}
+function getIndentString(indent, level) {
+  if (typeof indent === "string") {
+    return indent.repeat(level);
+  }
+  return " ".repeat(indent * level);
+}
+function isValidXmlTagName(name) {
+  if (!name) return false;
+  if (XML_PREFIX_REGEX.test(name)) return false;
+  return XML_TAG_NAME_REGEX.test(name);
+}
+function escapeXml(text) {
+  return text.replace(XML_ESCAPE_REGEX, (char) => XML_ESCAPE_MAP[char]);
+}
+export {
+  serializeXML
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ls-stack/utils",
   "description": "Typescript utils",
-  "version": "3.10.0",
+  "version": "3.11.0",
   "license": "MIT",
   "files": [
     "lib"
@@ -154,6 +154,10 @@
       "import": "./lib/typingUtils.js",
       "require": "./lib/typingUtils.cjs"
     },
+    "./xmlSerializer": {
+      "import": "./lib/xmlSerializer.js",
+      "require": "./lib/xmlSerializer.cjs"
+    },
     "./yamlStringify": {
       "import": "./lib/yamlStringify.js",
       "require": "./lib/yamlStringify.cjs"