@dvirus-js/utils 0.0.1 → 0.0.6

package/CHANGELOG.md

@@ -1,3 +1,47 @@
+## 0.0.5 (2026-05-20)
+
+This was a version bump only for utils to align it with other projects, there were no code changes.
+
+## 0.0.4 (2026-05-19)
+
+### 🩹 Fixes
+
+- minor formatting updates ([3dbc3e6](https://github.com/Dvirus97/dvirus-js/commit/3dbc3e6))
+
+### ❤️ Thank You
+
+- Dvir Cohen
+
+## 0.0.3 (2026-05-19)
+
+### 🩹 Fixes
+
+- ensure consistent trailing newlines in package exports ([866782e](https://github.com/Dvirus97/dvirus-js/commit/866782e))
+
+### ❤️ Thank You
+
+- Dvir Cohen
+
+## 0.0.2 (2026-05-19)
+
+### 🩹 Fixes
+
+- check all package ([3e145c9](https://github.com/Dvirus97/dvirus-js/commit/3e145c9))
+
+### ❤️ Thank You
+
+- Dvir Cohen
+
+## 1.1.8 (2026-05-14)
+
+### 🩹 Fixes
+
+- swap parseRichText to return BlockGroup by default ([ef7c103](https://github.com/Dvirus97/dvirus-js/commit/ef7c103))
+
+### ❤️ Thank You
+
+- Dvir Cohen
+
 ## 1.1.7 (2026-05-06)
 
 ### 🩹 Fixes

package/index.js

@@ -1,8 +1,8 @@
-function D(t) {
+function G(t) {
   return t.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2").toLowerCase().replace(/[_-]+/g, " ").replace(/\s+/g, " ").trim();
 }
 function W(t, r) {
-  const e = D(t);
+  const e = G(t);
   switch (r) {
     case "lowercase":
       return e.toLowerCase();
@@ -56,7 +56,7 @@ function E(t) {
     return [null, r];
   }
 }
-const F = {
+const ee = {
   /**
    * Makes a GET request to the specified URL.
    *
@@ -67,7 +67,7 @@ const F = {
    */
   get: async function(t, r) {
     const e = await fetch(t, r);
-    return await S(e);
+    return await C(e);
   },
   /**
    * Makes a POST request to the specified URL with the given data.
@@ -89,7 +89,7 @@ const F = {
       body: JSON.stringify(r),
       ...e
     });
-    return await S(n);
+    return await C(n);
   },
   /**
    * Makes a DELETE request to the specified URL with the given ID.
@@ -111,7 +111,7 @@ const F = {
       body: JSON.stringify({ id: r }),
       ...e
     });
-    return await S(n);
+    return await C(n);
   },
   /**
    * Makes a PATCH request to the specified URL with the given data.
@@ -133,7 +133,7 @@ const F = {
       body: JSON.stringify(r),
       ...e
     });
-    return await S(n);
+    return await C(n);
   },
   /**
    * Makes a PUT request to the specified URL with the given data.
@@ -155,33 +155,39 @@ const F = {
       body: JSON.stringify(r),
       ...e
     });
-    return await S(n);
+    return await C(n);
   }
 };
-async function S(t) {
+async function C(t) {
   if (!t.ok) throw new Error(`Error: ${t.statusText}`);
   return await t.json();
 }
-function ee(t, r) {
+function te(t, r) {
   const e = {};
   return t?.forEach((n, o) => {
     const s = r(n, o, t)?.toString();
     s && (e[s] ??= [], e[s].push(n));
   }), e;
 }
-async function te(t) {
+async function re(t) {
   return await new Promise((r) => setTimeout(r, t));
 }
-function re(t, r, e) {
+function ne(t, r, e) {
   return r < t ? t : r > e ? e : r;
 }
-function ne(t, r) {
-  let e;
-  return (...n) => {
-    clearTimeout(e), e = setTimeout(() => t(...n), r);
-  };
+function se(t, r, e) {
+  let n;
+  return e?.isLoadingFn?.(!1), Object.assign((...s) => {
+    clearTimeout(n), e?.isLoadingFn?.(!0), n = setTimeout(() => {
+      e?.isLoadingFn?.(!1), t(...s);
+    }, r);
+  }, {
+    cancel() {
+      clearTimeout(n), e?.isLoadingFn?.(!1);
+    }
+  });
 }
-function se(t, r) {
+function oe(t, r) {
   if (!r || typeof r != "string" || typeof t != "object" || t === null)
     return;
   const e = r.split(".");
@@ -194,7 +200,7 @@ function se(t, r) {
   }
   return n(e, t);
 }
-class g {
+class m {
   #e = null;
   #t = null;
   /**
@@ -203,7 +209,7 @@ class g {
    * @returns {Result<T, never>} A Result instance representing a success.
    */
   static ok(r) {
-    return new g(r, null);
+    return new m(r, null);
   }
   /**
    * Creates a failed result.
@@ -211,7 +217,7 @@ class g {
    * @returns {Result<never, E>} A Result instance representing a failure.
    */
   static err(r) {
-    return typeof r == "string" ? new g(null, new Error(r)) : new g(null, r);
+    return typeof r == "string" ? new m(null, new Error(r)) : new m(null, r);
   }
   /**
    * Wraps a promise in a Result.
@@ -219,7 +225,7 @@ class g {
    * @returns {Promise<Result<T, E>>} A promise that resolves to a Result.
    */
   static async promise(r) {
-    return r.then((e) => g.ok(e ?? "void")).catch((e) => g.err(e));
+    return r.then((e) => m.ok(e ?? "__void__")).catch((e) => m.err(e));
   }
   /**
    * Wraps a function call in a Result.
@@ -230,9 +236,9 @@ class g {
   static func(r, ...e) {
     try {
       const n = r(...e);
-      return g.ok(n);
+      return m.ok(n);
     } catch (n) {
-      return g.err(n);
+      return m.err(n);
     }
   }
   /**
@@ -242,9 +248,13 @@ class g {
    */
   constructor(r, e) {
     if (!r && !e)
-      throw new Error("Result must be initialized with either an ok or an err value");
+      throw new Error(
+        "Result must be initialized with either an ok or an err value"
+      );
     if (r && e)
-      throw new Error("Result can't be initialized with both an ok and an err value");
+      throw new Error(
+        "Result can't be initialized with both an ok and an err value"
+      );
     r != null ? this.#e = r : this.#t = e;
   }
   /**
@@ -311,21 +321,21 @@ class g {
     return this.#t;
   }
 }
-function oe(t, r = []) {
+function ae(t, r = []) {
   return t == null ? r : Array.isArray(t) ? t : [t];
 }
-const z = /* @__PURE__ */ Symbol("SIGNAL"), ae = (t) => typeof t == "function" && z in t, h = [], ie = (t) => {
-  const r = h.splice(0, h.length);
+const z = /* @__PURE__ */ Symbol("SIGNAL"), ie = (t) => typeof t == "function" && z in t, p = [], ce = (t) => {
+  const r = p.splice(0, p.length);
   try {
     return t();
   } finally {
-    h.push(...r);
+    p.push(...r);
   }
 }, A = (t, r) => {
   const e = /* @__PURE__ */ new Set();
   let n = 0;
   const o = () => {
-    const l = h[h.length - 1];
+    const l = p[p.length - 1];
     l && (e.add(l.setDirty), l.addSource(() => {
       e.delete(l.setDirty);
     }));
@@ -338,7 +348,7 @@ const z = /* @__PURE__ */ Symbol("SIGNAL"), ae = (t) => typeof t == "function" &
       e.delete(l), n--;
     })
   }), notify: s, hasSubscribers: a };
-}, C = (t) => {
+}, S = (t) => {
   let r = t;
   const { read: e, notify: n } = A(() => r);
   return Object.assign(e, {
@@ -360,12 +370,12 @@ const z = /* @__PURE__ */ Symbol("SIGNAL"), ae = (t) => typeof t == "function" &
     const a = (i) => {
       n = i;
     };
-    h.push({
+    p.push({
       setDirty: () => {
         !e && !o && (o = !0, queueMicrotask(s));
       },
       addSource: (i) => r.add(i)
-    }), t(a), h.pop();
+    }), t(a), p.pop();
   };
   return s(), {
     destroy() {
@@ -377,7 +387,7 @@ const z = /* @__PURE__ */ Symbol("SIGNAL"), ae = (t) => typeof t == "function" &
   let e, n = !0, o = () => {
   };
   const s = () => {
-    r.forEach((c) => c()), r.clear(), h.push({
+    r.forEach((c) => c()), r.clear(), p.push({
       setDirty: () => {
         if (n) return;
         n = !0;
@@ -385,7 +395,7 @@ const z = /* @__PURE__ */ Symbol("SIGNAL"), ae = (t) => typeof t == "function" &
         s(), e !== c && o(e);
       },
       addSource: (c) => r.add(c)
-    }), e = t(), n = !1, h.pop();
+    }), e = t(), n = !1, p.pop();
   }, { read: a, notify: i } = A(
     () => (n && s(), e),
     () => {
@@ -394,12 +404,12 @@ const z = /* @__PURE__ */ Symbol("SIGNAL"), ae = (t) => typeof t == "function" &
   );
   return o = i, a;
 };
-function ce(t) {
+function le(t) {
   const r = typeof t == "function", e = r ? void 0 : t.source, n = r ? t : t.computation, o = /* @__PURE__ */ new Set();
   let s, a = !0, i = !1, c, l = () => {
   };
   const y = () => {
-    if (o.forEach((u) => u()), o.clear(), h.push({
+    if (o.forEach((u) => u()), o.clear(), p.push({
       setDirty: () => {
         if (a) return;
         a = !0, i = !1;
@@ -413,7 +423,7 @@ function ce(t) {
       const u = e?.();
       s = n(u, c), c = { source: u, value: s };
     }
-    a = !1, h.pop();
+    a = !1, p.pop();
   }, { read: v, notify: d } = A(
     () => (a && !i && y(), s),
     () => {
@@ -432,17 +442,17 @@ function ce(t) {
   });
   return b;
 }
-class G extends Error {
+class F extends Error {
   constructor(r) {
     const e = r instanceof Error ? `:
 ${r.message}` : "";
     super(`Cannot read resource value while in error state${e}`, { cause: r }), this.name = "ResourceErrorState";
   }
 }
-function le(t) {
-  const r = C(void 0), e = C("idle"), n = C(void 0), o = L(() => e() === "loading"), s = C(0), a = L(() => {
+function ue(t) {
+  const r = S(void 0), e = S("idle"), n = S(void 0), o = L(() => e() === "loading"), s = S(0), a = L(() => {
     if (e() === "error")
-      throw new G(n());
+      throw new F(n());
     return r();
   }), i = (d) => {
     r.set(d), n.set(void 0), e.set("resolved");
@@ -450,23 +460,23 @@ function le(t) {
     r.update(d), n.set(void 0), e.set("resolved");
   }, l = "params" in t;
   if ("stream" in t) {
-    const d = C(void 0), b = k((p) => {
+    const d = S(void 0), b = k((g) => {
       s();
       const f = new AbortController();
-      p(() => f.abort());
-      const I = l ? t.params() : void 0;
+      g(() => f.abort());
+      const D = l ? t.params() : void 0;
       e.set("loading"), n.set(void 0);
-      const N = t.stream, _ = N(l ? {
-        params: I,
+      const $ = t.stream, I = $(l ? {
+        params: D,
         abortSignal: f.signal
       } : {
         abortSignal: f.signal
       });
-      d.set(_);
+      d.set(I);
     }), u = k(() => {
-      const p = d();
-      if (!p) return;
-      const f = p();
+      const g = d();
+      if (!g) return;
+      const f = g();
       f && ("error" in f && f.error !== void 0 ? (n.set(f.error), e.set("error")) : "value" in f && (r.set(f.value), e.set("resolved")));
     });
     return {
@@ -477,7 +487,7 @@ function le(t) {
       set: i,
       update: c,
       reload: () => {
-        s.update((p) => p + 1);
+        s.update((g) => g + 1);
       },
       destroy: () => {
         b.destroy(), u.destroy();
@@ -490,8 +500,8 @@ function le(t) {
     e.set("loading"), n.set(void 0);
     const u = new AbortController();
     d(() => u.abort());
-    const p = l ? { params: b, abortSignal: u.signal } : { abortSignal: u.signal };
-    t.loader(p).then(
+    const g = l ? { params: b, abortSignal: u.signal } : { abortSignal: u.signal };
+    t.loader(g).then(
       (f) => {
         u.signal.aborted || (r.set(f), e.set("resolved"));
       },
@@ -513,7 +523,7 @@ function le(t) {
     destroy: () => v.destroy()
   };
 }
-const $ = /* @__PURE__ */ new Map([
+const x = /* @__PURE__ */ new Map([
   ["b", "b"],
   ["i", "i"],
   ["u", "u"],
@@ -531,6 +541,7 @@ const $ = /* @__PURE__ */ new Map([
   ["h5", "h5"],
   ["h6", "h6"],
   ["code", "code"],
+  ["span", "span"],
   ["p", "p"],
   ["div", "div"],
   ["ul", "ul"],
@@ -550,7 +561,7 @@ const $ = /* @__PURE__ */ new Map([
   "h6"
 ]);
 let O = "rtp-";
-function x() {
+function N() {
   return O;
 }
 function V(t) {
@@ -660,9 +671,9 @@ const j = /* @__PURE__ */ new Map([
       s.flatMap((i) => Array.from(w.get(i) ?? []))
     ),
     containerTagNames: a,
-    cssClass: s.map((i) => `${x()}${i}`).join(" ")
+    cssClass: s.map((i) => `${N()}${i}`).join(" ")
   };
-}, J = () => [...$.keys()].join("|"), H = () => [...j.keys()].join("|"), Z = () => new RegExp(
+}, J = () => [...x.keys()].join("|"), H = () => [...j.keys()].join("|"), Z = () => new RegExp(
   `<\\/?(${J()})>|<(${H()})\\s*/?>`,
   "gi"
 );
@@ -670,13 +681,13 @@ function P(t, r) {
   const e = w.get(t) ?? /* @__PURE__ */ new Map();
   Object.entries(r).forEach(([n, o]) => e.set(n, o)), w.set(t, e);
 }
-function B() {
+function R() {
   const t = [];
   for (const [r, e] of w) {
     if (e.size === 0) continue;
     const n = [...e.entries()].map(([o, s]) => `  ${o}: ${s};`).join(`
 `);
-    t.push(`.${x()}${r} {
+    t.push(`.${N()}${r} {
 ${n}
 }`);
   }
@@ -685,7 +696,7 @@ ${n}
 }
 function q() {
   if ("document" in globalThis) {
-    const t = B(), r = globalThis, e = r.document.getElementById(
+    const t = R(), r = globalThis, e = r.document.getElementById(
       "html-text-parser-styles"
     );
     if (e) {
@@ -707,7 +718,7 @@ function X(t) {
     const o = n.containerTagNames.join(","), s = e?.containerTagNames.join(",");
     o !== s && (e = {
       containerTagNames: n.containerTagNames,
-      cssClass: n.containerTagNames.map((a) => `${x()}${a}`).join(" "),
+      cssClass: n.containerTagNames.map((a) => `${N()}${a}`).join(" "),
       style: n.containerTagNames.map(
         (a) => [...w.get(a)?.entries() ?? []].map(([i, c]) => `${i}: ${c}`).join("; ")
       ).filter(Boolean).join("; "),
@@ -721,7 +732,37 @@ function X(t) {
   }
   return r;
 }
-function m(t) {
+function K(t, r, e) {
+  if (!("document" in globalThis)) {
+    console.warn(
+      "[html-text-parser] Cannot append segments: document is not available."
+    );
+    return;
+  }
+  if (!t || !("appendChild" in t)) {
+    console.warn(
+      "[html-text-parser] Cannot append segments: provided element does not support appendChild."
+    );
+    return;
+  }
+  e = { useClasses: !0, useStyles: !1, ...e };
+  const n = t, o = globalThis.document;
+  for (const s of r) {
+    const a = o.createElement(
+      s.containerTagNames[0] || "span"
+    );
+    e.useClasses && (a.className = s.cssClass), e.useStyles && a.setAttribute("style", s.style);
+    for (const i of s.segments) {
+      const c = o.createElement("span");
+      c.textContent = i.text, e.useClasses && (c.className = i.cssClass), e.useStyles && c.setAttribute("style", i.style), a.appendChild(c);
+    }
+    n.appendChild(a);
+  }
+}
+function h(t) {
+  return X(_(t));
+}
+function _(t) {
   const r = [], e = /* @__PURE__ */ new Map();
   let n = 0;
   for (const o of t.matchAll(Z())) {
@@ -742,7 +783,7 @@ function m(t) {
       ), n = s + o[0].length;
       continue;
     }
-    const i = o[0][1] === "/", c = $.get(o[1]?.toLowerCase() ?? "") ?? "";
+    const i = o[0][1] === "/", c = x.get(o[1]?.toLowerCase() ?? "") ?? "";
     if (i) {
       const l = (e.get(c) ?? 1) - 1;
       l <= 0 ? e.delete(c) : e.set(c, l);
@@ -759,15 +800,15 @@ function m(t) {
     )
   ), r;
 }
-function R(t) {
+function B(t) {
   if (Array.isArray(t)) {
     t.forEach((e) => {
-      R(e);
+      B(e);
     });
     return;
   }
   const r = t.tagName ?? t.tag;
-  $.set(t.tag, r), t.style != null && Object.keys(t.style).length && P(r, t.style);
+  x.set(t.tag, r), t.style != null && Object.keys(t.style).length && P(r, t.style);
 }
 function U(t) {
   if (Array.isArray(t)) {
@@ -779,15 +820,16 @@ function U(t) {
   const r = t.tagName ?? t.tag;
   j.set(t.tag, r), t.style != null && Object.keys(t.style).length && P(r, t.style);
 }
-m.setTag = R;
-m.setSelfClosingTag = U;
-m.setBlockTag = (t) => T.add(t);
-m.removeBlockTag = (t) => T.delete(t);
-m.setCssClassPrefix = V;
-"document" in globalThis && (m.generateStylesheet = q);
-m.getStylesheet = B;
-m.groupByBlocks = X;
-function K(t, r, e) {
+h.setTag = B;
+h.setSelfClosingTag = U;
+h.setBlockTag = (t) => T.add(t);
+h.removeBlockTag = (t) => T.delete(t);
+h.setCssClassPrefix = V;
+h.getStylesheet = R;
+h.flat = _;
+h.generateStylesheet = q;
+h.appendToDom = K;
+function Q(t, r, e) {
   function n(o) {
     const [s, a] = E(() => e ? e(o) : o);
     if (a) throw new Error(`Error transforming value for ${t}: ${a.message}`);
@@ -803,35 +845,40 @@ function K(t, r, e) {
     return r(s);
   }, n;
 }
-const Q = /^\d+$/, ue = K(
+const fe = Q(
   "NumericString",
-  (t) => Q.test(String(t)),
+  (t) => (
+    // checks that a given value is:
+    // - a number, and the number is neither positive Infinity, negative Infinity, nor NaN.
+    typeof t == "string" && t.trim() !== "" && Number.isFinite(Number(t))
+  ),
   (t) => String(t)
 );
 export {
-  ue as NumericString,
-  g as Result,
+  fe as NumericString,
+  m as Result,
   z as SIGNAL,
-  re as clamp,
+  ne as clamp,
   L as computed,
   W as convertCase,
-  K as createBrand,
-  ne as debounce,
-  te as delay,
+  Q as createBrand,
+  se as debounce,
+  re as delay,
   k as effect,
-  se as getProp,
-  ee as groupBy,
-  F as http,
-  ae as isSignal,
-  ce as linkedSignal,
-  D as normalizeString,
-  m as parseRichText,
-  le as resource,
-  R as setRichTextTag,
+  oe as getProp,
+  te as groupBy,
+  ee as http,
+  ie as isSignal,
+  le as linkedSignal,
+  G as normalizeString,
+  h as parseRichText,
+  _ as parseRichTextFlat,
+  ue as resource,
+  B as setRichTextTag,
   U as setSelfClosingTag,
-  C as signal,
-  oe as toArray,
+  S as signal,
+  ae as toArray,
   E as tryCatch,
   Y as tryCatchAsync,
-  ie as untracked
+  ce as untracked
 };

package/lib/brand-type/numeric-string.d.ts

@@ -1,14 +1,19 @@
 import { Brand } from './brand-factory';
 /**
- * A branded string type that only contains digit characters (`0-9`).
+ * A branded string type whose value can be safely converted to a finite number.
  *
  * At runtime this is just a plain `string` — no wrapper objects.
  * The brand prevents accidental assignment of arbitrary strings at compile time.
  *
+ * Accepts: integers, decimals, negatives, leading zeros (e.g. `"007"`).
+ * Rejects: empty strings, whitespace-only, `"Infinity"`, `"NaN"`, mixed strings like `"3px"`.
+ *
  * @example
  * ```ts
- * const id: NumericString = NumericString('123'); // ok
- * const id: NumericString = '123';                // compile error
+ * const n: NumericString = NumericString('3.14');  // ok
+ * const n: NumericString = NumericString(-7);      // ok
+ * const n: NumericString = NumericString('abc');   // throws
+ * const n: NumericString = '3.14';                 // compile error
  * ```
  */
 export type NumericString = Brand<string, 'NumericString'>;

package/lib/delay.d.ts

@@ -12,10 +12,16 @@ export declare function delay(ms: number): Promise<unknown>;
  * @returns Clamped value
  */
 export declare function clamp(min: number, value: number, max: number): number;
+export interface Debounce<TFn extends (...args: any[]) => void> {
+    (...args: Parameters<TFn>): void;
+    cancel: () => void;
+}
 /**
  * Debounce a function
  * @param func - Function to debounce
  * @param delay - Delay in milliseconds
  * @returns Debounced function
  */
-export declare function debounce<T extends (...args: any[]) => void>(func: T, delay: number): (...args: Parameters<T>) => void;
+export declare function debounce<TFn extends (...args: any[]) => void = (...args: any[]) => void>(func: TFn, delay: number, config?: {
+    isLoadingFn?: (isLoading: boolean) => void;
+}): Debounce<TFn>;

package/lib/html-text-parser/html-text-parser.d.ts

@@ -1,7 +1,10 @@
-import { TextSegment } from './types';
+import { TextSegment, BlockGroup } from './types';
 /**
- * Parses a string containing supported inline tags into typed segments.
+ * Parses a string containing supported inline tags into block groups.
  * Supports nested tags. All other content is treated as plain text.
+ * Returns segments grouped by their block/container context.
+ *
+ * For a flat array of segments without block grouping, use `parseRichText.flat()`.
  *
  * Supported tags (add more in `RICH_TEXT_TAGS`):
  * `<b>` / `<strong>`, `<i>` / `<em>`, `<u>`, `<s>`, `<mark>`, `<small>`,
@@ -13,22 +16,38 @@ import { TextSegment } from './types';
  * @example
  * parseRichText('Hello <b>world</b>!')
  * // [
- * //   { text: 'Hello ', styles: [], cssClass: '' },
- * //   { text: 'world', styles: ['bold'] },
- * //   { text: '!', styles: [] },
+ * //   { containerTagNames: [], cssClass: '', style: '', styleObject: {}, segments: [
+ * //     { text: 'Hello ', ... },
+ * //     { text: 'world', ... },
+ * //     { text: '!', ... },
+ * //   ]},
  * // ]
  */
-export declare function parseRichText(input: string): TextSegment[];
+export declare function parseRichText(input: string): BlockGroup[];
 export declare namespace parseRichText {
     var setTag: typeof setRichTextTag;
     var setSelfClosingTag: typeof import("./html-text-parser").setSelfClosingTag;
     var setBlockTag: (tag: string) => Set<string>;
     var removeBlockTag: (tag: string) => boolean;
     var setCssClassPrefix: typeof import("./constant").setCssClassPrefix;
-    var generateStylesheet: typeof import("./methods").generateStylesheet;
     var getStylesheet: typeof import("./methods").getStylesheet;
-    var groupByBlocks: typeof import("./methods").groupByBlocks;
+    var flat: typeof parseRichTextFlat;
+    var generateStylesheet: typeof import("./methods").generateStylesheet;
+    var appendToDom: typeof import("./methods").appendToDom;
 }
+/**
+ * Parses a string containing supported inline tags into a flat array of typed segments.
+ * Supports nested tags. All other content is treated as plain text.
+ *
+ * @example
+ * parseRichTextFlat('Hello <b>world</b>!')
+ * // [
+ * //   { text: 'Hello ', tagNames: '', cssClass: '' },
+ * //   { text: 'world', tagNames: 'b', cssClass: 'rtp-b' },
+ * //   { text: '!', tagNames: '', cssClass: '' },
+ * // ]
+ */
+export declare function parseRichTextFlat(input: string): TextSegment[];
 export declare function setRichTextTag(tag: {
     tag: string;
     tagName?: string;

package/lib/html-text-parser/methods.d.ts

@@ -26,3 +26,26 @@ export declare function generateStylesheet(): void;
  * // ]
  */
 export declare function groupByBlocks(segments: TextSegment[]): BlockGroup[];
+/**
+ * Appends parsed rich text segments to a DOM element, creating nested elements
+ * for each block group and its inline segments.
+ *
+ * @param htmlElement - The target DOM element to append content to. Must support `appendChild`.
+ * @param segments - An array of `BlockGroup` objects (e.g. from `groupByBlocks`).
+ * @param config - Optional configuration for styling behavior.
+ * @param config.useClasses - Whether to apply CSS class names to elements. Defaults to `true`.
+ * @param config.useStyles - Whether to apply inline styles to elements. Defaults to `false`.
+ *
+ * @example
+ * const el = document.getElementById('output');
+ * const groups = groupByBlocks(parseRichText('<b>Hello</b> <i>world</i>'));
+ * appendToDom(el, groups);
+ *
+ * @example
+ * // With inline styles instead of classes
+ * appendToDom(el, groups, { useClasses: false, useStyles: true });
+ */
+export declare function appendToDom<T extends object>(htmlElement: T, segments: BlockGroup[], config?: {
+    useClasses?: boolean;
+    useStyles?: boolean;
+}): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dvirus-js/utils",
-  "version": "0.0.1",
+  "version": "0.0.6",
   "type": "module",
   "main": "./index.js",
   "types": "./index.d.ts",