@levischuck/tiny-html 0.0.4 → 0.1.1

package/dist/index.d.ts

@@ -1,8 +1,10 @@
-import { ParseResult, HtmlNode, WriterOptions } from './types.ts';
+import { ParseResult, HtmlNode, WriterOptions, SafeHtmlOptions, ParserOptions } from './types.ts';
 /**
  * Parses HTML string into a ParseResult containing HtmlNode
+ * @param html - The HTML string to parse
+ * @param options - Parser options including attributeNaming ('reactName' or 'exactName')
  */
-export declare function readHtml(html: string): ParseResult;
+export declare function readHtml(html: string, options?: ParserOptions): ParseResult;
 /**
  * Renders HtmlNode or ParseResult to HTML string
  */
@@ -12,8 +14,18 @@ export declare function writeHtml(input: HtmlNode | ParseResult, options?: Write
  * Returns a new HtmlNode with all promises resolved
  */
 export declare function awaitHtmlNode(node: HtmlNode | Promise<HtmlNode>): Promise<HtmlNode>;
+/**
+ * Sanitizes an HtmlNode tree by removing disallowed tags, attributes, and URLs.
+ * - Tags not in allowedTags have their content retained (folded into parent)
+ * - Images replaced with their alt text when removed
+ * - Attributes not in the tag's allowed list are dropped
+ * - Classes are filtered by allowedClasses patterns (supports wildcards)
+ * - URLs not matching allowedLinkProtocols cause the element to be removed
+ */
+export declare function safeHtml(node: HtmlNode, options?: SafeHtmlOptions): HtmlNode;
 export { htmlNodeTo } from './convert.ts';
 export { decodeHtmlEntities, encodeHtmlEntities } from './entities.ts';
 export type { CreateElementFn, CreateElementProps } from './convert.ts';
 export { getTextContent } from './writer.ts';
-export type { WriterOptions, ParseResult, HtmlNode, HtmlElement, HtmlProps, HtmlStyle } from './types.ts';
+export { htmlNodeToHtmlElement } from './utils.ts';
+export type { WriterOptions, ParseResult, HtmlNode, HtmlElement, HtmlProps, HtmlStyle, SafeHtmlOptions, AllowedTag, ParserOptions, ParserAttributeNaming, WriterAttributeNaming, } from './types.ts';

package/dist/index.js

@@ -1,4 +1,4 @@
-const F = /* @__PURE__ */ new Set([
+const $ = /* @__PURE__ */ new Set([
   "area",
   "base",
   "br",
@@ -13,7 +13,7 @@ const F = /* @__PURE__ */ new Set([
   "source",
   "track",
   "wbr"
-]), Q = /* @__PURE__ */ new Set([
+]), J = /* @__PURE__ */ new Set([
   // Containers
   "div",
   "span",
@@ -110,7 +110,7 @@ const F = /* @__PURE__ */ new Set([
   "body",
   "title",
   "meta"
-]), q = /* @__PURE__ */ new Map([
+]), z = /* @__PURE__ */ new Map([
   ["p", /* @__PURE__ */ new Set(["p"])],
   ["li", /* @__PURE__ */ new Set(["li"])],
   ["dt", /* @__PURE__ */ new Set(["dt", "dd"])],
@@ -123,7 +123,7 @@ const F = /* @__PURE__ */ new Set([
   ["tr", /* @__PURE__ */ new Set(["tr"])],
   ["td", /* @__PURE__ */ new Set(["td", "th"])],
   ["th", /* @__PURE__ */ new Set(["td", "th"])]
-]), V = /* @__PURE__ */ new Map([
+]), B = /* @__PURE__ */ new Map([
   ["altglyph", "altGlyph"],
   ["altglyphdef", "altGlyphDef"],
   ["altglyphitem", "altGlyphItem"],
@@ -161,7 +161,7 @@ const F = /* @__PURE__ */ new Set([
   ["lineargradient", "linearGradient"],
   ["radialgradient", "radialGradient"],
   ["textpath", "textPath"]
-]), z = /* @__PURE__ */ new Map([
+]), V = /* @__PURE__ */ new Map([
   ["attributename", "attributeName"],
   ["attributetype", "attributeType"],
   ["basefrequency", "baseFrequency"],
@@ -220,7 +220,7 @@ const F = /* @__PURE__ */ new Set([
   ["xchannelselector", "xChannelSelector"],
   ["ychannelselector", "yChannelSelector"],
   ["zoomandpan", "zoomAndPan"]
-]), I = {
+]), P = {
   lt: "<",
   gt: ">",
   amp: "&",
@@ -291,44 +291,44 @@ const F = /* @__PURE__ */ new Set([
   rArr: "⇒",
   dArr: "⇓",
   hArr: "⇔"
-}, B = {};
-for (const [e, n] of Object.entries(I))
-  B[n] || (B[n] = e);
-function w(e) {
-  return !e || typeof e != "string" || !e.includes("&") ? e : e.replace(/&(?:#[xX]([0-9a-fA-F]+)|#(\d+)|([a-zA-Z][a-zA-Z0-9]*));/g, (n, r, l, a) => {
-    if (r) {
-      const o = parseInt(r, 16);
-      return String.fromCodePoint(o);
+}, W = {};
+for (const [e, t] of Object.entries(P))
+  W[t] || (W[t] = e);
+function O(e) {
+  return !e || typeof e != "string" || !e.includes("&") ? e : e.replace(/&(?:#[xX]([0-9a-fA-F]+)|#(\d+)|([a-zA-Z][a-zA-Z0-9]*));/g, (t, i, l, s) => {
+    if (i) {
+      const a = parseInt(i, 16);
+      return String.fromCodePoint(a);
     } else if (l) {
-      const o = parseInt(l, 10);
-      return String.fromCodePoint(o);
-    } else if (a && I[a])
-      return I[a];
-    return n;
+      const a = parseInt(l, 10);
+      return String.fromCodePoint(a);
+    } else if (s && P[s])
+      return P[s];
+    return t;
   });
 }
-function x(e, n = !1) {
+function G(e, t = !1) {
   if (!e || typeof e != "string")
     return e;
-  let r = e;
-  return r = r.replace(/&/g, "&amp;"), r = r.replace(/</g, "&lt;"), r = r.replace(/>/g, "&gt;"), n && (r = r.replace(/"/g, "&quot;")), r;
+  let i = e;
+  return i = i.replace(/&/g, "&amp;"), i = i.replace(/</g, "&lt;"), i = i.replace(/>/g, "&gt;"), t && (i = i.replace(/"/g, "&quot;")), i;
 }
-function Z(e) {
+function ee(e) {
   return e.replace(/\]\]>/g, "]]]]><![CDATA[>");
 }
-function k(e) {
-  return e.replace(/[-_]([a-z])/g, (n, r) => r.toUpperCase());
+function Z(e) {
+  return e.replace(/[-_]([a-z])/g, (t, i) => i.toUpperCase());
 }
-function $(e) {
-  return e.replace(/[A-Z]/g, (n) => `-${n.toLowerCase()}`);
+function te(e) {
+  return e.replace(/[A-Z]/g, (t) => `-${t.toLowerCase()}`);
 }
-function d(e, n, r) {
-  return new TextDecoder("utf-8").decode(e.slice(n, r));
+function b(e, t, i) {
+  return new TextDecoder("utf-8").decode(e.slice(t, i));
 }
-function S(e) {
+function C(e) {
   return e === 32 || e === 9 || e === 10 || e === 13;
 }
-function N(e) {
+function S(e) {
   return e >= 97 && e <= 122 || // a-z
   e >= 65 && e <= 90 || // A-Z
   e >= 48 && e <= 57 || // 0-9
@@ -336,419 +336,615 @@ function N(e) {
   e === 95 || // _
   e === 58;
 }
-function K(e) {
-  const r = new TextEncoder().encode(e), l = {
+function Ae(e) {
+  if (typeof e == "string" && e.trim().startsWith("<") && (e = Q(e).node), typeof e == "object" && e && "type" in e)
+    return e;
+  if (Array.isArray(e)) {
+    for (const t of e)
+      if (typeof t == "object" && t && "type" in t)
+        return t;
+  }
+  throw new Error("Could not find HtmlElement in decoded Html");
+}
+function Q(e, t = {}) {
+  const i = t.attributeNaming ?? "reactName", s = new TextEncoder().encode(e), a = {
     node: []
-  }, a = [], o = [];
-  let u = "HTML", i = "TEXT", t = 0, c = 0, y = 0, A = 0, b = 0, g = "", P = 0, h = null;
-  function M() {
-    return o.length > 0 ? o[o.length - 1].children : a;
+  }, p = [], o = [];
+  let T = "HTML", n = "TEXT", r = 0, h = 0, g = 0, E = 0, N = 0, A = "", q = 0, d = null;
+  function x() {
+    return o.length > 0 ? o[o.length - 1].children : p;
   }
-  function X(s, f) {
-    if (s >= f) return;
-    const p = d(r, s, f), T = w(p);
-    T.length > 0 && M().push(T);
+  function D(f, c) {
+    if (f >= c) return;
+    const u = b(s, f, c), m = O(u);
+    m.length > 0 && x().push(m);
   }
-  function U(s, f) {
-    if (s >= f) return;
-    const p = d(r, s, f);
-    p.length > 0 && M().push(p);
+  function M(f, c) {
+    if (f >= c) return;
+    const u = b(s, f, c);
+    u.length > 0 && x().push(u);
   }
-  function C(s, f) {
-    const p = s.toLowerCase();
-    return f === "SVG" && V.has(p) ? V.get(p) : p;
+  function v(f, c) {
+    const u = f.toLowerCase();
+    return c === "SVG" && B.has(u) ? B.get(u) : u;
   }
-  function _(s, f) {
-    const p = s.toLowerCase();
-    if (p === "class") return "className";
-    if (p === "for") return "htmlFor";
-    if (f === "SVG")
-      return z.has(p) ? z.get(p) : s;
-    if (f === "HTML") {
-      const T = k(p);
-      return p === "class" || p === "for" ? p === "class" ? "className" : "htmlFor" : T;
-    }
-    return p;
+  function L(f, c) {
+    const u = f.toLowerCase();
+    return u === "class" ? i === "exactName" ? "class" : "className" : u === "for" ? i === "exactName" ? "for" : "htmlFor" : c === "SVG" ? V.has(u) ? V.get(u) : f : c === "HTML" ? Z(u) : u;
   }
-  function R(s) {
-    const f = C(s, u);
-    for (let p = o.length - 1; p >= 0; p--)
-      if (o[p].type === f) {
-        for (let T = o.length - 1; T >= p; T--) {
-          const m = o.pop(), E = {
-            type: m.type,
+  function I(f) {
+    const c = v(f, T);
+    for (let u = o.length - 1; u >= 0; u--)
+      if (o[u].type === c) {
+        for (let m = o.length - 1; m >= u; m--) {
+          const y = o.pop(), w = {
+            type: y.type,
             props: {
-              ...m.props,
-              children: m.children.length === 1 ? m.children[0] : m.children
+              ...y.props,
+              children: y.children.length === 1 ? y.children[0] : y.children
             }
           };
-          o.length > 0 ? o[o.length - 1].children.push(E) : a.push(E), (m.type === "svg" || m.type === "math") && (u = "HTML");
+          o.length > 0 ? o[o.length - 1].children.push(w) : p.push(w), (y.type === "svg" || y.type === "math") && (T = "HTML");
         }
         return;
       }
   }
-  function v(s, f, p) {
-    const T = C(s, u);
-    if (o.length > 0 && q.has(T)) {
-      const E = q.get(T), j = o[o.length - 1].type;
-      E.has(j) && R(j);
+  function _(f, c, u) {
+    const m = v(f, T);
+    if (o.length > 0 && z.has(m)) {
+      const w = z.get(m), H = o[o.length - 1].type;
+      w.has(H) && I(H);
     }
-    let m = u;
-    if (T === "svg" ? m = "SVG" : T === "math" && (m = "MATHML"), F.has(T) || p) {
-      const E = {
-        type: T,
-        props: f
+    let y = T;
+    if (m === "svg" ? y = "SVG" : m === "math" && (y = "MATHML"), $.has(m) || u) {
+      const w = {
+        type: m,
+        props: c
       };
-      M().push(E);
+      x().push(w);
     } else {
-      const E = {
-        type: T,
-        props: f,
+      const w = {
+        type: m,
+        props: c,
         children: [],
-        namespace: m
+        namespace: y
       };
-      o.push(E), u = m;
+      o.push(w), T = y;
     }
   }
-  for (; t < r.length; ) {
-    const s = r[t];
-    switch (i) {
+  for (; r < s.length; ) {
+    const f = s[r];
+    switch (n) {
       case "TEXT":
-        s === 60 && (X(c, t), i = "TAG_OPEN"), t++;
+        f === 60 && (D(h, r), n = "TAG_OPEN"), r++;
         break;
       case "TAG_OPEN":
-        s === 33 ? r[t + 1] === 45 && r[t + 2] === 45 ? (i = "COMMENT", t += 3) : r[t + 1] === 68 || r[t + 1] === 100 ? d(r, t, Math.min(t + 20, r.length)).toLowerCase().startsWith("!doctype") ? (i = "DOCTYPE", y = t, t++) : (c = t - 1, i = "TEXT") : r[t + 1] === 91 && r[t + 2] === 67 && d(r, t, Math.min(t + 9, r.length)).startsWith("![CDATA[") ? (i = "CDATA", c = t + 8, t += 8) : (c = t - 1, i = "TEXT") : s === 63 ? (i = "PROCESSING_INSTRUCTION", y = t - 1, t++) : s === 47 ? (i = "TAG_CLOSE_START", t++) : N(s) ? (y = t, i = "TAG_NAME", h = null, t++) : (c = t - 1, i = "TEXT");
+        f === 33 ? s[r + 1] === 45 && s[r + 2] === 45 ? (n = "COMMENT", r += 3) : s[r + 1] === 68 || s[r + 1] === 100 ? b(s, r, Math.min(r + 20, s.length)).toLowerCase().startsWith("!doctype") ? (n = "DOCTYPE", g = r, r++) : (h = r - 1, n = "TEXT") : s[r + 1] === 91 && s[r + 2] === 67 && b(s, r, Math.min(r + 9, s.length)).startsWith("![CDATA[") ? (n = "CDATA", h = r + 8, r += 8) : (h = r - 1, n = "TEXT") : f === 63 ? (n = "PROCESSING_INSTRUCTION", g = r - 1, r++) : f === 47 ? (n = "TAG_CLOSE_START", r++) : S(f) ? (g = r, n = "TAG_NAME", d = null, r++) : (h = r - 1, n = "TEXT");
         break;
       case "TAG_NAME":
-        if (S(s)) {
-          const f = d(r, y, t), p = f.toLowerCase();
-          h = {
-            type: f,
+        if (C(f)) {
+          const c = b(s, g, r), u = c.toLowerCase();
+          d = {
+            type: c,
             props: {},
             children: [],
-            namespace: p === "svg" ? "SVG" : p === "math" ? "MATHML" : u
-          }, i = "ATTRIBUTES", t++;
-        } else if (s === 62) {
-          const f = d(r, y, t);
-          v(f, {}, !1);
-          const p = C(f, u);
-          p === "script" ? (i = "SCRIPT_CONTENT", c = t + 1) : p === "style" ? (i = "STYLE_CONTENT", c = t + 1) : (i = "TEXT", c = t + 1), t++;
-        } else s === 47 ? (i = "TAG_CLOSE_SELF", t++) : N(s) ? t++ : (c = y - 1, i = "TEXT");
+            namespace: u === "svg" ? "SVG" : u === "math" ? "MATHML" : T
+          }, n = "ATTRIBUTES", r++;
+        } else if (f === 62) {
+          const c = b(s, g, r);
+          _(c, {}, !1);
+          const u = v(c, T);
+          u === "script" ? (n = "SCRIPT_CONTENT", h = r + 1) : u === "style" ? (n = "STYLE_CONTENT", h = r + 1) : (n = "TEXT", h = r + 1), r++;
+        } else f === 47 ? (n = "TAG_CLOSE_SELF", r++) : S(f) ? r++ : (h = g - 1, n = "TEXT");
         break;
       case "ATTRIBUTES":
-        if (S(s))
-          t++;
-        else if (s === 62) {
-          const f = h.type;
-          v(f, h.props, !1);
-          const p = C(f, u);
-          p === "script" ? (i = "SCRIPT_CONTENT", c = t + 1) : p === "style" ? (i = "STYLE_CONTENT", c = t + 1) : (i = "TEXT", c = t + 1), t++;
-        } else s === 47 ? (i = "TAG_CLOSE_SELF", t++) : N(s) ? (A = t, i = "ATTRIBUTE_NAME", t++) : (c = y - 1, i = "TEXT");
+        if (C(f))
+          r++;
+        else if (f === 62) {
+          const c = d.type;
+          _(c, d.props, !1);
+          const u = v(c, T);
+          u === "script" ? (n = "SCRIPT_CONTENT", h = r + 1) : u === "style" ? (n = "STYLE_CONTENT", h = r + 1) : (n = "TEXT", h = r + 1), r++;
+        } else f === 47 ? (n = "TAG_CLOSE_SELF", r++) : S(f) ? (E = r, n = "ATTRIBUTE_NAME", r++) : (h = g - 1, n = "TEXT");
         break;
       case "ATTRIBUTE_NAME":
-        if (S(s)) {
-          g = d(r, A, t);
-          const f = _(g, h.namespace);
-          h.props[f] = !0, g = "", i = "ATTRIBUTES", t++;
-        } else if (s === 61)
-          g = d(r, A, t), i = "ATTRIBUTE_VALUE_START", t++;
-        else if (s === 62) {
-          g = d(r, A, t);
-          const f = _(g, h.namespace);
-          h.props[f] = !0, g = "";
-          const p = h.type;
-          v(p, h.props, !1);
-          const T = C(p, u);
-          T === "script" ? (i = "SCRIPT_CONTENT", c = t + 1) : T === "style" ? (i = "STYLE_CONTENT", c = t + 1) : (i = "TEXT", c = t + 1), t++;
-        } else if (s === 47) {
-          g = d(r, A, t);
-          const f = _(g, h.namespace);
-          h.props[f] = !0, g = "", i = "TAG_CLOSE_SELF", t++;
-        } else N(s) ? t++ : (c = y - 1, i = "TEXT");
+        if (C(f)) {
+          A = b(s, E, r);
+          const c = L(A, d.namespace);
+          d.props[c] = !0, A = "", n = "ATTRIBUTES", r++;
+        } else if (f === 61)
+          A = b(s, E, r), n = "ATTRIBUTE_VALUE_START", r++;
+        else if (f === 62) {
+          A = b(s, E, r);
+          const c = L(A, d.namespace);
+          d.props[c] = !0, A = "";
+          const u = d.type;
+          _(u, d.props, !1);
+          const m = v(u, T);
+          m === "script" ? (n = "SCRIPT_CONTENT", h = r + 1) : m === "style" ? (n = "STYLE_CONTENT", h = r + 1) : (n = "TEXT", h = r + 1), r++;
+        } else if (f === 47) {
+          A = b(s, E, r);
+          const c = L(A, d.namespace);
+          d.props[c] = !0, A = "", n = "TAG_CLOSE_SELF", r++;
+        } else S(f) ? r++ : (h = g - 1, n = "TEXT");
         break;
       case "ATTRIBUTE_VALUE_START":
-        S(s) ? t++ : s === 34 || s === 39 ? (P = s, b = t + 1, i = "ATTRIBUTE_VALUE_QUOTED", t++) : (b = t, i = "ATTRIBUTE_VALUE_UNQUOTED");
+        C(f) ? r++ : f === 34 || f === 39 ? (q = f, N = r + 1, n = "ATTRIBUTE_VALUE_QUOTED", r++) : (N = r, n = "ATTRIBUTE_VALUE_UNQUOTED");
         break;
       case "ATTRIBUTE_VALUE_QUOTED":
-        if (s === P) {
-          const f = d(r, b, t), p = w(f), T = _(g, h.namespace);
-          T === "style" ? h.props[T] = D(p) : h.props[T] = p, g = "", i = "ATTRIBUTES", t++;
+        if (f === q) {
+          const c = b(s, N, r), u = O(c), m = L(A, d.namespace);
+          m === "style" ? d.props[m] = F(u) : d.props[m] = u, A = "", n = "ATTRIBUTES", r++;
         } else
-          t++;
+          r++;
         break;
       case "ATTRIBUTE_VALUE_UNQUOTED":
-        if (S(s) || s === 62 || s === 47) {
-          const f = d(r, b, t), p = w(f), T = _(g, h.namespace);
-          T === "style" ? h.props[T] = D(p) : h.props[T] = p, g = "", i = "ATTRIBUTES";
+        if (C(f) || f === 62 || f === 47) {
+          const c = b(s, N, r), u = O(c), m = L(A, d.namespace);
+          m === "style" ? d.props[m] = F(u) : d.props[m] = u, A = "", n = "ATTRIBUTES";
         } else
-          t++;
+          r++;
         break;
       case "TAG_CLOSE_SELF":
-        if (s === 62) {
-          const f = h.type;
-          v(f, h.props, !0), i = "TEXT", c = t + 1, t++;
+        if (f === 62) {
+          const c = d.type;
+          _(c, d.props, !0), n = "TEXT", h = r + 1, r++;
         } else
-          c = y - 1, i = "TEXT";
+          h = g - 1, n = "TEXT";
         break;
       case "TAG_CLOSE_START":
-        N(s) ? (y = t, i = "TAG_CLOSE_NAME", t++) : (c = t - 2, i = "TEXT");
+        S(f) ? (g = r, n = "TAG_CLOSE_NAME", r++) : (h = r - 2, n = "TEXT");
         break;
       case "TAG_CLOSE_NAME":
-        if (s === 62) {
-          const f = d(r, y, t);
-          R(f), i = "TEXT", c = t + 1, t++;
-        } else S(s) || N(s) ? t++ : (c = y - 2, i = "TEXT");
+        if (f === 62) {
+          const c = b(s, g, r);
+          I(c), n = "TEXT", h = r + 1, r++;
+        } else C(f) || S(f) ? r++ : (h = g - 2, n = "TEXT");
         break;
       case "COMMENT":
-        s === 45 && r[t + 1] === 45 && r[t + 2] === 62 ? (i = "TEXT", c = t + 3, t += 3) : t++;
+        f === 45 && s[r + 1] === 45 && s[r + 2] === 62 ? (n = "TEXT", h = r + 3, r += 3) : r++;
         break;
       case "DOCTYPE":
-        if (s === 62) {
-          const f = d(r, y, t + 1);
-          l.doctype = "<" + f, i = "TEXT", c = t + 1, t++;
+        if (f === 62) {
+          const c = b(s, g, r + 1);
+          a.doctype = "<" + c, n = "TEXT", h = r + 1, r++;
         } else
-          t++;
+          r++;
         break;
       case "CDATA":
-        s === 93 && r[t + 1] === 93 && r[t + 2] === 62 ? (U(c, t), i = "TEXT", c = t + 3, t += 3) : t++;
+        f === 93 && s[r + 1] === 93 && s[r + 2] === 62 ? (M(h, r), n = "TEXT", h = r + 3, r += 3) : r++;
         break;
       case "PROCESSING_INSTRUCTION":
-        if (s === 63 && r[t + 1] === 62) {
-          const f = d(r, y, t + 2);
-          l.xml = f, i = "TEXT", c = t + 2, t += 2;
+        if (f === 63 && s[r + 1] === 62) {
+          const c = b(s, g, r + 2);
+          a.xml = c, n = "TEXT", h = r + 2, r += 2;
         } else
-          t++;
+          r++;
         break;
       case "SCRIPT_CONTENT":
       case "STYLE_CONTENT":
-        if (s === 60 && r[t + 1] === 47) {
-          const f = i === "SCRIPT_CONTENT" ? "script" : "style", p = "</" + f, T = d(r, t, Math.min(t + p.length + 1, r.length)).toLowerCase();
-          if (T.startsWith(p) && (T[p.length] === ">" || S(T.charCodeAt(p.length)))) {
-            U(c, t);
-            let m = t + p.length;
-            for (; m < r.length && r[m] !== 62; ) m++;
-            R(f), i = "TEXT", c = m + 1, t = m + 1;
+        if (f === 60 && s[r + 1] === 47) {
+          const c = n === "SCRIPT_CONTENT" ? "script" : "style", u = "</" + c, m = b(s, r, Math.min(r + u.length + 1, s.length)).toLowerCase();
+          if (m.startsWith(u) && (m[u.length] === ">" || C(m.charCodeAt(u.length)))) {
+            M(h, r);
+            let y = r + u.length;
+            for (; y < s.length && s[y] !== 62; ) y++;
+            I(c), n = "TEXT", h = y + 1, r = y + 1;
           } else
-            t++;
+            r++;
         } else
-          t++;
+          r++;
         break;
       default:
-        t++;
+        r++;
     }
   }
-  for (i === "TEXT" ? X(c, t) : (i === "SCRIPT_CONTENT" || i === "STYLE_CONTENT") && U(c, t); o.length > 0; ) {
-    const s = o.pop(), f = {
-      type: s.type,
+  for (n === "TEXT" ? D(h, r) : (n === "SCRIPT_CONTENT" || n === "STYLE_CONTENT") && M(h, r); o.length > 0; ) {
+    const f = o.pop(), c = {
+      type: f.type,
       props: {
-        ...s.props,
-        children: s.children.length === 1 ? s.children[0] : s.children
+        ...f.props,
+        children: f.children.length === 1 ? f.children[0] : f.children
       }
     };
-    o.length > 0 ? o[o.length - 1].children.push(f) : a.push(f);
+    o.length > 0 ? o[o.length - 1].children.push(c) : p.push(c);
   }
-  return a.length === 0 ? l.node = null : a.length === 1 ? l.node = a[0] : l.node = a, l;
-}
-function D(e) {
-  const n = {}, l = w(e).split(/;(?![^(]*\))/);
-  for (const a of l) {
-    const o = a.indexOf(":");
-    if (o === -1) continue;
-    const u = a.substring(0, o).trim(), i = a.substring(o + 1).trim();
-    u && i && (n[k(u)] = i);
+  return p.length === 0 ? a.node = null : p.length === 1 ? a.node = p[0] : a.node = p, a;
+}
+function F(e) {
+  const t = {}, l = O(e).split(/;(?![^(]*\))/);
+  for (const s of l) {
+    const a = s.indexOf(":");
+    if (a === -1) continue;
+    const p = s.substring(0, a).trim(), o = s.substring(a + 1).trim();
+    p && o && (t[Z(p)] = o);
   }
-  return n;
+  return t;
 }
-function H(e, n = {}) {
-  const r = [];
-  let l, a, o;
+const re = {
+  className: "class",
+  htmlFor: "for"
+};
+function se(e, t) {
+  return t === "reactName" ? e : t === "exactName" || t === "eitherName" ? re[e] ?? e : e;
+}
+function k(e, t = {}) {
+  const i = [];
+  let l, s, a;
   if (e && typeof e == "object" && "node" in e) {
-    const c = e;
-    l = c.node, a = c.xml ?? n.xml, o = c.doctype ?? n.doctype;
+    const r = e;
+    l = r.node, s = r.xml ?? t.xml, a = r.doctype ?? t.doctype;
   } else
-    l = e, a = n.xml, o = n.doctype;
-  a && (r.push(a), a.endsWith(`
-`) || r.push(`
-`)), o && (r.push(o), o.endsWith(`
-`) || r.push(`
+    l = e, s = t.xml, a = t.doctype;
+  s && (i.push(s), s.endsWith(`
+`) || i.push(`
+`)), a && (i.push(a), a.endsWith(`
+`) || i.push(`
 `));
-  const u = n.useCDataForScripts ?? !1, i = n.useCDataForStyles ?? !1, t = n.voidTrailingSlash ?? !0;
-  return O(l, r, "HTML", u, i, t), r.join("");
+  const p = t.useCDataForScripts ?? !1, o = t.useCDataForStyles ?? !1, T = t.voidTrailingSlash ?? !0, n = t.attributeNaming ?? "eitherName";
+  return R(l, i, "HTML", p, o, T, n), i.join("");
 }
-function O(e, n, r, l, a, o) {
+function R(e, t, i, l, s, a, p) {
   if (e != null) {
     if (typeof e == "string") {
-      n.push(x(e, !1));
+      t.push(G(e, !1));
       return;
     }
     if (typeof e == "number" || typeof e == "bigint") {
-      n.push(String(e));
+      t.push(String(e));
       return;
     }
     if (typeof e == "boolean") {
-      n.push(String(e));
+      t.push(String(e));
       return;
     }
     if (Array.isArray(e)) {
-      for (const u of e)
-        O(u, n, r, l, a, o);
+      for (const o of e)
+        R(o, t, i, l, s, a, p);
       return;
     }
     if (typeof e != "function" && typeof e != "symbol" && !(e && typeof e == "object" && "then" in e && typeof e.then == "function") && e && typeof e == "object" && "type" in e && "props" in e) {
-      J(e, n, r, l, a, o);
+      ie(e, t, i, l, s, a, p);
       return;
     }
   }
 }
-function J(e, n, r, l, a, o) {
-  var y;
-  const u = e.type;
-  let i = r;
-  if (u === "svg" ? i = "SVG" : u === "math" && (i = "MATHML"), n.push("<"), n.push(u), e.props) {
-    for (const [A, b] of Object.entries(e.props))
-      if (A !== "children" && !(b === !1 || b === null || b === void 0))
-        if (b === !0)
-          n.push(" "), n.push(A);
-        else if (A === "style" && typeof b == "object") {
-          const g = ee(b);
-          g && (n.push(' style="'), n.push(x(g, !0)), n.push('"'));
-        } else
-          n.push(" "), n.push(A), n.push('="'), n.push(x(String(b), !0)), n.push('"');
-  }
-  const t = (y = e.props) == null ? void 0 : y.children;
-  let c;
-  if (t && typeof t == "object" && "then" in t && typeof t.then == "function" ? c = !1 : c = t != null && (Array.isArray(t) && t.length > 0 || !Array.isArray(t) && t !== !1), F.has(u))
-    o ? n.push(" />") : n.push(">");
-  else if (c) {
-    n.push(">");
-    const A = t;
-    u === "script" && l || u === "style" && a ? (n.push("<![CDATA["), G(A, n, i, l, a, o), n.push("]]>")) : u === "script" || u === "style" ? W(A, n) : O(A, n, i, l, a, o), n.push("</"), n.push(u), n.push(">");
-  } else Q.has(u), n.push("></"), n.push(u), n.push(">");
-}
-function G(e, n, r, l, a, o, u) {
+function ie(e, t, i, l, s, a, p) {
+  var h;
+  const o = e.type;
+  let T = i;
+  if (o === "svg" ? T = "SVG" : o === "math" && (T = "MATHML"), t.push("<"), t.push(o), e.props)
+    for (const [g, E] of Object.entries(e.props)) {
+      if (g === "children" || E === !1 || E === null || E === void 0)
+        continue;
+      const N = se(g, p);
+      if (E === !0)
+        t.push(" "), t.push(N);
+      else if (g === "style" && typeof E == "object") {
+        const A = ne(E);
+        A && (t.push(' style="'), t.push(G(A, !0)), t.push('"'));
+      } else
+        t.push(" "), t.push(N), t.push('="'), t.push(G(String(E), !0)), t.push('"');
+    }
+  const n = (h = e.props) == null ? void 0 : h.children;
+  let r;
+  if (n && typeof n == "object" && "then" in n && typeof n.then == "function" ? r = !1 : r = n != null && (Array.isArray(n) && n.length > 0 || !Array.isArray(n) && n !== !1), $.has(o))
+    a ? t.push(" />") : t.push(">");
+  else if (r) {
+    t.push(">");
+    const g = n;
+    o === "script" && l || o === "style" && s ? (t.push("<![CDATA["), j(g, t, T, l, s, a, p), t.push("]]>")) : o === "script" || o === "style" ? K(g, t) : R(g, t, T, l, s, a, p), t.push("</"), t.push(o), t.push(">");
+  } else J.has(o), t.push("></"), t.push(o), t.push(">");
+}
+function j(e, t, i, l, s, a, p, o) {
   if (e != null) {
     if (typeof e == "string") {
-      n.push(Z(e));
+      t.push(ee(e));
       return;
     }
     if (typeof e == "number" || typeof e == "bigint" || typeof e == "boolean") {
-      n.push(String(e));
+      t.push(String(e));
       return;
     }
     if (Array.isArray(e)) {
-      for (const i of e)
-        G(i, n, r, l, a, o);
+      for (const T of e)
+        j(T, t, i, l, s, a, p);
       return;
     }
-    O(e, n, r, l, a, o);
+    R(e, t, i, l, s, a, p);
   }
 }
-function W(e, n) {
+function K(e, t) {
   if (e != null) {
     if (typeof e == "string") {
-      n.push(e);
+      t.push(e);
       return;
     }
     if (typeof e == "number" || typeof e == "bigint" || typeof e == "boolean") {
-      n.push(String(e));
+      t.push(String(e));
       return;
     }
     if (Array.isArray(e)) {
-      for (const r of e)
-        W(r, n);
+      for (const i of e)
+        K(i, t);
       return;
     }
   }
 }
-function ee(e) {
-  const n = [];
-  for (const [r, l] of Object.entries(e))
+function ne(e) {
+  const t = [];
+  for (const [i, l] of Object.entries(e))
     if (l) {
-      const a = $(r);
-      n.push(`${a}: ${l}`);
+      const s = te(i);
+      t.push(`${s}: ${l}`);
     }
-  return n.join("; ");
+  return t.join("; ");
 }
-function te(e) {
-  const n = [];
-  function r(l) {
-    if (typeof l == "string" && n.push(l), (typeof l == "number" || typeof l == "bigint" || typeof l == "boolean") && n.push(`${l}`), typeof l == "object" && l !== null && "type" in l && l.props && "children" in l.props) {
-      const a = l.props.children;
-      if (l.type === "script" || l.type === "style" || l.type === "template" || a && typeof a == "object" && "then" in a && typeof a.then == "function")
+function be(e) {
+  const t = [];
+  function i(l) {
+    if (typeof l == "string" && t.push(l), (typeof l == "number" || typeof l == "bigint" || typeof l == "boolean") && t.push(`${l}`), typeof l == "object" && l !== null && "type" in l && l.props && "children" in l.props) {
+      const s = l.props.children;
+      if (l.type === "script" || l.type === "style" || l.type === "template" || s && typeof s == "object" && "then" in s && typeof s.then == "function")
         return;
-      if (Array.isArray(a))
-        for (const o of a)
-          r(o);
-      else a != null && r(a);
+      if (Array.isArray(s))
+        for (const a of s)
+          i(a);
+      else s != null && i(s);
     }
     if (Array.isArray(l))
-      for (const a of l)
-        r(a);
+      for (const s of l)
+        i(s);
   }
-  return r(e), n.join("");
+  return i(e), t.join("");
 }
-async function L(e) {
+async function U(e) {
   if (e == null)
     return e;
   if (e && typeof e == "object" && "then" in e && typeof e.then == "function") {
-    const n = await e;
-    return L(n);
+    const t = await e;
+    return U(t);
   }
   if (typeof e == "string" || typeof e == "number" || typeof e == "boolean" || typeof e == "bigint")
     return e;
   if (typeof e != "function" && typeof e != "symbol") {
     if (Array.isArray(e))
       return await Promise.all(
-        e.filter((r) => !(r == null || typeof r == "function" || typeof r == "symbol")).map((r) => L(r))
+        e.filter((i) => !(i == null || typeof i == "function" || typeof i == "symbol")).map((i) => U(i))
       );
     if (e && typeof e == "object" && "type" in e && "props" in e) {
-      const n = e, r = {};
-      for (const [l, a] of Object.entries(n.props))
+      const t = e, i = {};
+      for (const [l, s] of Object.entries(t.props))
         if (l === "children") {
-          const o = await L(a);
-          o != null && (r.children = o);
+          const a = await U(s);
+          a != null && (i.children = a);
         } else {
-          if (typeof a == "function" || typeof a == "symbol")
+          if (typeof s == "function" || typeof s == "symbol")
             continue;
-          a != null && (r[l] = a);
+          s != null && (i[l] = s);
         }
       return {
-        type: n.type,
-        props: r
+        type: t.type,
+        props: i
       };
     }
   }
 }
-function Y(e, n) {
+const le = [
+  "br",
+  ["span", "class"],
+  "p",
+  ["a", "href", "rel", "class"],
+  "pre",
+  "del",
+  "code",
+  "em",
+  "strong",
+  "i",
+  "u",
+  "ul",
+  ["ol", "start", "reversed"],
+  ["li", "value"],
+  "blockquote"
+], ae = [
+  "h-*",
+  "p-*",
+  "u-*",
+  "dt-*",
+  "e-*",
+  "mention",
+  "hashtag",
+  "ellipsis",
+  "invisible"
+], oe = ["http", "https"], fe = {
+  a: ["href"],
+  area: ["href"],
+  audio: ["src"],
+  base: ["href"],
+  blockquote: ["cite"],
+  button: ["formaction"],
+  del: ["cite"],
+  embed: ["src"],
+  form: ["action"],
+  iframe: ["src"],
+  img: ["src", "longdesc"],
+  input: ["src", "formaction"],
+  ins: ["cite"],
+  link: ["href"],
+  object: ["data"],
+  q: ["cite"],
+  script: ["src"],
+  source: ["src"],
+  track: ["src"],
+  video: ["src", "poster"]
+};
+function ce(e) {
+  const t = /* @__PURE__ */ new Map();
+  let i = !1, l = /* @__PURE__ */ new Set(), s = !1;
+  for (const a of e)
+    if (typeof a == "string")
+      a === "*" ? i = !0 : t.set(a.toLowerCase(), {
+        allowed: !0,
+        allowedAttributes: /* @__PURE__ */ new Set(),
+        allowAllAttributes: !1
+      });
+    else {
+      const [p, ...o] = a, T = o.includes("*");
+      p === "*" ? (i = !0, T ? s = !0 : l = new Set(o.map((n) => n.toLowerCase()))) : t.set(p.toLowerCase(), {
+        allowed: !0,
+        allowedAttributes: T ? /* @__PURE__ */ new Set() : new Set(o.map((n) => n.toLowerCase())),
+        allowAllAttributes: T
+      });
+    }
+  return { configs: t, allowAll: i, universalAttrs: l, universalAllowAllAttrs: s };
+}
+function ue(e) {
+  return e.includes("*") ? { patterns: [], allowAll: !0 } : { patterns: e.map((i) => {
+    const s = "^" + i.replace(/[.+?^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*") + "$";
+    return new RegExp(s);
+  }), allowAll: !1 };
+}
+function pe(e = {}) {
+  const t = e.allowedTags ?? le, i = e.allowedClasses ?? ae, l = e.allowedLinkProtocols ?? oe, s = e.attributeNaming ?? "reactName", a = ce(t), p = ue(i);
+  return {
+    tagConfigs: a.configs,
+    classPatterns: p.patterns,
+    protocols: new Set(l.map((o) => o.toLowerCase())),
+    attributeNaming: s,
+    allowAllClasses: p.allowAll,
+    allowAllTags: a.allowAll,
+    universalAttributes: a.universalAttrs,
+    universalAllowAllAttributes: a.universalAllowAllAttrs
+  };
+}
+function he(e, t, i) {
+  return i ? !0 : t.some((l) => l.test(e));
+}
+function me(e, t, i) {
+  return i ? e : e.split(/\s+/).filter((a) => a.length > 0).filter((a) => he(a, t, i)).join(" ");
+}
+function Te(e, t) {
+  const i = e.trim();
+  if (t.has(".")) {
+    if (i.startsWith("/") || i.startsWith("./") || i.startsWith("../") || i.startsWith("#") || i.startsWith("?"))
+      return !0;
+    const a = i.indexOf(":"), p = i.indexOf("/");
+    if (a === -1 || p !== -1 && p < a)
+      return !0;
+  }
+  const l = i.match(/^([a-zA-Z][a-zA-Z0-9+.-]*):/);
+  if (!l || !l[1])
+    return t.has(".");
+  const s = l[1].toLowerCase();
+  return t.has(s);
+}
+function ge(e) {
+  return fe[e.toLowerCase()] ?? [];
+}
+function de(e, t, i, l) {
+  const s = {}, a = ge(e), p = i.allowAllAttributes || l.universalAllowAllAttributes, o = l.attributeNaming === "exactName" ? "class" : "className", T = l.attributeNaming === "exactName" ? "for" : "htmlFor";
+  for (const [n, r] of Object.entries(t)) {
+    if (n === "children")
+      continue;
+    const h = n.toLowerCase();
+    if (a.includes(h) && typeof r == "string" && !Te(r, l.protocols))
+      return null;
+    if ((n === "className" || n === "class") && typeof r == "string") {
+      if (p)
+        s[o] = r;
+      else if (i.allowedAttributes.has("class") || l.universalAttributes.has("class")) {
+        const g = me(r, l.classPatterns, l.allowAllClasses);
+        g && (s[o] = g);
+      }
+      continue;
+    }
+    if ((n === "htmlFor" || n === "for") && typeof r == "string") {
+      (p || i.allowedAttributes.has("for") || l.universalAttributes.has("for")) && (s[T] = r);
+      continue;
+    }
+    (p || i.allowedAttributes.has(h) || i.allowedAttributes.has(n) || l.universalAttributes.has(h) || l.universalAttributes.has(n)) && (s[n] = r);
+  }
+  return s;
+}
+function X(e, t) {
+  if (e == null || typeof e == "string" || typeof e == "number" || typeof e == "boolean" || typeof e == "bigint")
+    return e;
+  if (Array.isArray(e)) {
+    const o = [];
+    for (const T of e) {
+      const n = X(T, t);
+      Array.isArray(n) ? o.push(...n) : n != null && o.push(n);
+    }
+    return o.length === 0 ? [] : o.length === 1 ? o[0] : o;
+  }
+  const i = e, l = i.type.toLowerCase();
+  let s = t.tagConfigs.get(l);
+  !s && t.allowAllTags && (s = {
+    allowed: !0,
+    allowedAttributes: t.universalAttributes,
+    allowAllAttributes: t.universalAllowAllAttributes
+  });
+  const a = i.props.children !== void 0 ? X(i.props.children, t) : void 0;
+  if (!s) {
+    if (l === "img") {
+      const o = i.props.alt;
+      return typeof o == "string" && o.length > 0 ? o : void 0;
+    }
+    return a !== void 0 ? a : void 0;
+  }
+  const p = de(l, i.props, s, t);
+  if (p === null) {
+    if (l === "img") {
+      const o = i.props.alt;
+      if (typeof o == "string" && o.length > 0)
+        return o;
+    }
+    return a !== void 0 ? a : void 0;
+  }
+  return a !== void 0 && (p.children = a), {
+    type: i.type,
+    props: p
+  };
+}
+function ye(e, t = {}) {
+  const i = pe(t);
+  return X(e, i);
+}
+function Y(e, t) {
   if (e == null || typeof e == "string" || typeof e == "number" || typeof e == "boolean" || typeof e == "bigint")
     return e;
   if (Array.isArray(e))
-    return e.map((r) => Y(r, n));
+    return e.map((i) => Y(i, t));
   if (typeof e == "object" && "type" in e && "props" in e) {
-    const { type: r, props: l } = e, { children: a, ...o } = l;
-    if (a !== void 0) {
-      const u = Y(a, n);
-      return u === null ? n(r, o) : Array.isArray(u) ? n(r, o, ...u) : n(r, o, u);
+    const { type: i, props: l } = e, { children: s, ...a } = l;
+    if (s !== void 0) {
+      const p = Y(s, t);
+      return p === null ? t(i, a) : Array.isArray(p) ? t(i, a, ...p) : t(i, a, p);
     }
-    return n(r, o);
+    return t(i, a);
   }
   return null;
 }
-function re(e) {
-  return K(e);
+function Ee(e, t = {}) {
+  return Q(e, t);
+}
+function we(e, t = {}) {
+  return e && typeof e == "object" && "node" in e ? k(e, t) : e === void 0 ? "" : k(e, t);
 }
-function ne(e, n = {}) {
-  return e && typeof e == "object" && "node" in e ? H(e, n) : e === void 0 ? "" : H(e, n);
+async function Ne(e) {
+  return await U(e);
 }
-async function ie(e) {
-  return await L(e);
+function Ce(e, t = {}) {
+  return ye(e, t);
 }
 export {
-  ie as awaitHtmlNode,
-  w as decodeHtmlEntities,
-  x as encodeHtmlEntities,
-  te as getTextContent,
+  Ne as awaitHtmlNode,
+  O as decodeHtmlEntities,
+  G as encodeHtmlEntities,
+  be as getTextContent,
   Y as htmlNodeTo,
-  re as readHtml,
-  ne as writeHtml
+  Ae as htmlNodeToHtmlElement,
+  Ee as readHtml,
+  Ce as safeHtml,
+  we as writeHtml
 };

package/dist/parser.d.ts

@@ -1,2 +1,2 @@
-import { ParseResult } from './types.ts';
-export declare function parseHtml(html: string): ParseResult;
+import { ParseResult, ParserOptions } from './types.ts';
+export declare function parseHtml(html: string, options?: ParserOptions): ParseResult;

package/dist/safe-html.d.ts

@@ -0,0 +1,15 @@
+import { HtmlNode, SafeHtmlOptions } from './types.ts';
+/**
+ * Sanitizes an HtmlNode tree by removing disallowed tags, attributes, and URLs.
+ *
+ * - Tags not in allowedTags have their content retained (folded into parent)
+ * - Images replaced with their alt text when removed
+ * - Attributes not in the tag's allowed list are dropped
+ * - Classes are filtered by allowedClasses patterns (supports wildcards like 'h-*')
+ * - URLs not matching allowedLinkProtocols cause the element to be removed
+ * - Use '.' as a protocol to allow relative URLs
+ * @param node - The HtmlNode to sanitize
+ * @param options - The SafeHtmlOptions to use
+ * @returns The sanitized HtmlNode
+ */
+export declare function safeHtml(node: HtmlNode, options?: SafeHtmlOptions): HtmlNode;

package/dist/types.d.ts

@@ -1,14 +1,26 @@
+/**
+ * Style attribute as a structured record.
+ */
 export interface HtmlStyle {
     [key: string]: string;
 }
+/**
+ * Properties of an HtmlElement.
+ */
 export interface HtmlElement {
     type: string;
     props: HtmlProps;
 }
+/**
+ * HtmlElement properties
+ */
 export interface HtmlProps {
     [key: string]: string | number | boolean | HtmlStyle | HtmlNode | Promise<HtmlNode>;
     children?: HtmlNode | Promise<HtmlNode>;
 }
+/**
+ * Nodes will be parsed into one of these types.
+ */
 export type HtmlNode = HtmlElement | string | number | bigint | boolean | null | undefined | HtmlNode[];
 export declare enum ParserState {
     TEXT = "TEXT",
@@ -29,6 +41,9 @@ export declare enum ParserState {
     SCRIPT_CONTENT = "SCRIPT_CONTENT",
     STYLE_CONTENT = "STYLE_CONTENT"
 }
+/**
+ * Namespace of an element.
+ */
 export declare enum Namespace {
     HTML = "HTML",
     SVG = "SVG",
@@ -45,10 +60,71 @@ export interface ParseResult {
     doctype?: string;
     node: HtmlNode | HtmlNode[];
 }
+/**
+ * Controls how special attributes like 'class' and 'for' are named:
+ * - 'reactName': Use React-style names (className, htmlFor) - default for parsing
+ * - 'exactName': Use exact HTML names (class, for)
+ */
+export type ParserAttributeNaming = 'reactName' | 'exactName';
+/**
+ * Controls how special attributes are written:
+ * - 'reactName': Write as React-style (className, htmlFor)
+ * - 'exactName': Write as exact HTML (class, for)
+ * - 'eitherName': Normalize className->class, htmlFor->for (default)
+ */
+export type WriterAttributeNaming = 'reactName' | 'exactName' | 'eitherName';
+export interface ParserOptions {
+    /**
+     * How to name special attributes like 'class' and 'for'.
+     * - 'reactName' (default): Convert to React-style (className, htmlFor)
+     * - 'exactName': Keep exact HTML names (class, for)
+     */
+    attributeNaming?: ParserAttributeNaming;
+}
 export interface WriterOptions {
     useCDataForScripts?: boolean;
     useCDataForStyles?: boolean;
     xml?: string;
     doctype?: string;
     voidTrailingSlash?: boolean;
+    /**
+     * How to write special attributes like 'class' and 'for'.
+     * - 'eitherName' (default): Normalize className->class, htmlFor->for
+     * - 'reactName': Write as-is (className, htmlFor)
+     * - 'exactName': Write as exact HTML (class, for)
+     */
+    attributeNaming?: WriterAttributeNaming;
+}
+/**
+ * Allowed tag specification:
+ * - string: tag name with no custom attributes allowed (only global attrs like 'class' if classes are allowed)
+ * - [tagName, ...attrs]: tag name with specific allowed attributes
+ */
+export type AllowedTag = string | [string, ...string[]];
+/**
+ * Options for the safeHtml function.
+ */
+export interface SafeHtmlOptions {
+    /**
+     * List of allowed tags. Can be strings (tag name only) or tuples [tagName, ...allowedAttributes].
+     * If not provided, uses default safe tags.
+     */
+    allowedTags?: AllowedTag[];
+    /**
+     * List of allowed CSS class patterns. Supports wildcards like 'h-*', 'p-*'.
+     * If not provided, uses default allowed classes.
+     */
+    allowedClasses?: string[];
+    /**
+     * List of allowed URL protocols for links/media. Use '.' for relative URLs.
+     * If not provided, uses default ['http', 'https'].
+     */
+    allowedLinkProtocols?: string[];
+    /**
+     * The attribute naming convention used in the input.
+     * - 'reactName' (default): Input uses React-style names (className, htmlFor)
+     * - 'exactName': Input uses exact HTML names (class, for)
+     * When set, also affects how the output is named.
+     */
+    attributeNaming?: ParserAttributeNaming;
 }

package/dist/utils.d.ts

@@ -1,3 +1,4 @@
+import { HtmlElement, HtmlNode } from './types.ts';
 /**
  * Converts a kebab-case or snake_case string to camelCase
  * @example toCamelCase("foo-bar") => "fooBar"
@@ -32,3 +33,11 @@ export declare function isWhitespace(code: number): boolean;
  * Checks if a character code is valid for tag/attribute names
  */
 export declare function isNameChar(code: number): boolean;
+/**
+ * Find the first HtmlElement in the HtmlNode, may be an html string.
+ *
+ * @param node - the result of readHtml or a string of HTML
+ * @returns the first HtmlElement in the HtmlNode
+ * @throws an error if no HtmlElement is found
+ */
+export declare function htmlNodeToHtmlElement(node: HtmlNode): HtmlElement;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@levischuck/tiny-html",
-  "version": "0.0.4",
+  "version": "0.1.1",
   "type": "module",
   "license": "MIT",
   "main": "./dist/index.js",