Added UI.splitText util

Author: viktor-podzigun

src/UI.mjs

@@ -1,8 +1,7 @@
-import Blessed from "@farjs/blessed";
-
 /**
- * @typedef { import('blessed').Widgets.Types.TStyle } BlessedStyle
+ * @typedef { import("@farjs/blessed").Widgets.Types.TStyle } BlessedStyle
  */
+import Blessed from "@farjs/blessed";
 
 /**
  * @param {BlessedStyle | undefined} style
@@ -33,3 +32,34 @@ export function renderText(isBold, fgColor, bgColor, text) {
   const bold = isBold ? "{bold}" : "";
   return `${bold}{${fgColor}-fg}{${bgColor}-bg}${Blessed.escape(text)}{/}`;
 }
+
+/**
+ * @param {string} text
+ * @param {number} maxLen
+ * @returns {string[]}
+ */
+export function splitText(text, maxLen) {
+  const sentences = text.split("\n");
+
+  return sentences.flatMap((sentence) => {
+    const words = sentence.trim().split(" ");
+    const res = /** @type {string[]} */ ([]);
+
+    words.forEach((item) => {
+      if (res.length === 0) {
+        res.push(item);
+        return;
+      }
+
+      const hIndex = res.length - 1;
+      const head = res[hIndex];
+      if (head.length + item.length >= maxLen) {
+        res.push(item);
+      } else {
+        res[hIndex] = `${head} ${item}`;
+      }
+    });
+
+    return res;
+  });
+}

test/UI.test.mjs

@@ -84,4 +84,25 @@ describe("UI.test.mjs", () => {
     //then
     assert.deepEqual(result, "{yellow-fg}{blue-bg}start/-{open}{close}end{/}");
   });
+
+  it("should split text when splitText", () => {
+    //when & then
+    assert.deepEqual(UI.splitText("", 2), [""]);
+    assert.deepEqual(UI.splitText("test", 2), ["test"]);
+    assert.deepEqual(UI.splitText("test1, test2", 11), ["test1,", "test2"]);
+    assert.deepEqual(UI.splitText("test1, test2", 12), ["test1, test2"]);
+    assert.deepEqual(UI.splitText("test1, test2, test3", 12), [
+      "test1,",
+      "test2, test3",
+    ]);
+    assert.deepEqual(UI.splitText("test1, test2, test3", 13), [
+      "test1, test2,",
+      "test3",
+    ]);
+    assert.deepEqual(UI.splitText("test1, \n\n test2, test3", 13), [
+      "test1,",
+      "",
+      "test2, test3",
+    ]);
+  });
 });