@tixyel/streamelements 7.0.5 → 7.1.0

package/dist/index.d.ts

@@ -2414,15 +2414,28 @@ declare class ElementHelper {
      * Adds 'container' class and data-index to all parent elements, and wraps each character in a span with class 'char' and data-index.
      * @param htmlString - The input HTML string containing formatted text elements (span, strong, em, etc).
      * @param startIndex - The starting index for the data-index attribute (default is 0).
+     * @param preserveInterElementWhitespace - Whether to preserve whitespace between elements (default is false).
+     * @param options - Optional settings for splitting text, including skipWhitespaceIndex to control index incrementing for whitespace characters.
      * @returns - A new HTML string with containers and character-level indexing.
      * @example
      * ```javascript
      * const result = splitTextToChars('<span>TesTe</span> <strong>bold</strong>', 0);
      * console.log(result);
      * // Output: '<span class="container" data-index="0"><span class="char" data-index="0">T</span><span class="char" data-index="1">e</span>...'
+     *
+     * // Example with skipWhitespaceIndex
+     * const resultSkipWhitespace = splitTextToChars('<span>Hello World</span>', 0, false, { skipWhitespaceIndex: true });
+     * // The space character will have data-index but won't increment index for subsequent characters
      * ```
      */
-    splitTextToChars(htmlString: string, startIndex?: number, preserveInterElementWhitespace?: boolean): string;
+    splitTextToChars(htmlString: string, startIndex?: number, preserveInterElementWhitespace?: boolean, options?: {
+        /**
+         * If true, skips incrementing the index for whitespace characters (space, newline, tab).
+         * These characters will still have a data-index, but it won't be incremented for subsequent characters.
+         * Default is true.
+         */
+        skipWhitespaceIndex?: boolean;
+    }): string;
 }
 
 declare class ObjectHelper {

package/dist/index.es.js

@@ -289,33 +289,35 @@ var e = class {
 		let s = r * (o.clientWidth * t / e.offsetWidth), c = new i().balance(s, a.minFontSize, a.maxFontSize);
 		return e.style.fontSize = c + "px", e;
 	}
-	splitTextToChars(e, t = 0, n = !1) {
-		let r = new DOMParser(), i = document.createElement("div"), a = t;
-		function o(e) {
+	splitTextToChars(e, t = 0, n = !1, r = {}) {
+		let { skipWhitespaceIndex: i = !0 } = r, a = new DOMParser(), o = document.createElement("div"), s = t;
+		function c(e) {
 			if (e.nodeType === Node.TEXT_NODE) {
-				let t = (e.textContent || "").split("").map((e, t) => {
-					let n = document.createElement("span");
-					return n.classList.add("char"), n.dataset.index = String(a), n.dataset.exclusivityIndex = String(t), n.style.setProperty("--char-index", String(a)), n.style.setProperty("--exclusivity-index", String(t)), e === " " || e === "\n" || e === "	" ? n.style.whiteSpace = "pre-wrap" : a++, n.textContent = e, n;
-				}), n = document.createDocumentFragment();
-				return t.forEach((e) => n.appendChild(e)), n;
+				let t = e.textContent || "", n = 0, r = t.split("").map((e) => {
+					let t = document.createElement("span");
+					t.classList.add("char"), t.dataset.index = String(s), t.dataset.exclusivityIndex = String(n), t.dataset.type = "char", t.style.setProperty("--char-index", String(s)), t.style.setProperty("--exclusivity-index", String(n));
+					let r = e === " " || e === "\n" || e === "	";
+					return r && (t.style.whiteSpace = "pre-wrap", t.classList.remove("char"), t.classList.add("whitespace"), t.dataset.type = "whitespace"), (!r || !i) && (s++, n++), t.textContent = e, t;
+				}), a = document.createDocumentFragment();
+				return r.forEach((e) => a.appendChild(e)), a;
 			} else if (e.nodeType === Node.ELEMENT_NODE) {
 				let t = e.cloneNode(!1);
-				return t.classList.add("container"), t.dataset.index = String(a), t.style.setProperty("--char-index", String(a)), t.style.setProperty("--exclusivity-index", String(a)), a++, e.childNodes.forEach((e) => {
-					let n = o(e);
+				return t.classList.add("container"), t.dataset.index = String(s), t.dataset.type = "container", t.style.setProperty("--char-index", String(s)), t.style.setProperty("--exclusivity-index", String(s)), s++, e.childNodes.forEach((e) => {
+					let n = c(e);
 					t.appendChild(n);
 				}), t;
 			}
 			return e.cloneNode(!0);
 		}
-		r.parseFromString(e, "text/html").body.childNodes.forEach((e) => {
+		a.parseFromString(e, "text/html").body.childNodes.forEach((e) => {
 			if (!n && e.nodeType === Node.TEXT_NODE && !e.textContent?.trim()) return;
-			let t = o(e);
-			i.appendChild(t);
+			let t = c(e);
+			o.appendChild(t);
 		});
-		let s = "";
-		return Array.from(i.childNodes).forEach((e) => {
-			e.nodeType === Node.TEXT_NODE ? s += e.textContent : s += e.outerHTML;
-		}), s;
+		let l = "";
+		return Array.from(o.childNodes).forEach((e) => {
+			e.nodeType === Node.TEXT_NODE ? l += e.textContent : l += e.outerHTML;
+		}), l;
 	}
 }, o = class {
 	flatten(e, t = !0, n = "") {