@levischuck/tiny-html 0.1.0 → 0.1.1

package/dist/index.d.ts

@@ -27,4 +27,5 @@ export { htmlNodeTo } from './convert.ts';
 export { decodeHtmlEntities, encodeHtmlEntities } from './entities.ts';
 export type { CreateElementFn, CreateElementProps } from './convert.ts';
 export { getTextContent } from './writer.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

@@ -13,7 +13,7 @@ const $ = /* @__PURE__ */ new Set([
   "source",
   "track",
   "wbr"
-]), K = /* @__PURE__ */ new Set([
+]), J = /* @__PURE__ */ new Set([
   // Containers
   "div",
   "span",
@@ -110,7 +110,7 @@ const $ = /* @__PURE__ */ new Set([
   "body",
   "title",
   "meta"
-]), H = /* @__PURE__ */ new Map([
+]), z = /* @__PURE__ */ new Map([
   ["p", /* @__PURE__ */ new Set(["p"])],
   ["li", /* @__PURE__ */ new Set(["li"])],
   ["dt", /* @__PURE__ */ new Set(["dt", "dd"])],
@@ -313,13 +313,13 @@ function G(e, t = !1) {
   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 J(e) {
+function ee(e) {
   return e.replace(/\]\]>/g, "]]]]><![CDATA[>");
 }
 function Z(e) {
   return e.replace(/[-_]([a-z])/g, (t, i) => i.toUpperCase());
 }
-function ee(e) {
+function te(e) {
   return e.replace(/[A-Z]/g, (t) => `-${t.toLowerCase()}`);
 }
 function b(e, t, i) {
@@ -336,11 +336,21 @@ function S(e) {
   e === 95 || // _
   e === 58;
 }
-function te(e, t = {}) {
+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: []
   }, p = [], o = [];
-  let T = "HTML", n = "TEXT", r = 0, h = 0, g = 0, E = 0, N = 0, y = "", q = 0, d = null;
+  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;
   }
@@ -367,26 +377,26 @@ function te(e, 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 A = o.pop(), w = {
-            type: A.type,
+          const y = o.pop(), w = {
+            type: y.type,
             props: {
-              ...A.props,
-              children: A.children.length === 1 ? A.children[0] : A.children
+              ...y.props,
+              children: y.children.length === 1 ? y.children[0] : y.children
             }
           };
-          o.length > 0 ? o[o.length - 1].children.push(w) : p.push(w), (A.type === "svg" || A.type === "math") && (T = "HTML");
+          o.length > 0 ? o[o.length - 1].children.push(w) : p.push(w), (y.type === "svg" || y.type === "math") && (T = "HTML");
         }
         return;
       }
   }
   function _(f, c, u) {
     const m = v(f, T);
-    if (o.length > 0 && H.has(m)) {
-      const w = H.get(m), z = o[o.length - 1].type;
-      w.has(z) && I(z);
+    if (o.length > 0 && z.has(m)) {
+      const w = z.get(m), H = o[o.length - 1].type;
+      w.has(H) && I(H);
     }
-    let A = T;
-    if (m === "svg" ? A = "SVG" : m === "math" && (A = "MATHML"), $.has(m) || u) {
+    let y = T;
+    if (m === "svg" ? y = "SVG" : m === "math" && (y = "MATHML"), $.has(m) || u) {
       const w = {
         type: m,
         props: c
@@ -397,9 +407,9 @@ function te(e, t = {}) {
         type: m,
         props: c,
         children: [],
-        namespace: A
+        namespace: y
       };
-      o.push(w), T = A;
+      o.push(w), T = y;
     }
   }
   for (; r < s.length; ) {
@@ -439,23 +449,23 @@ function te(e, t = {}) {
         break;
       case "ATTRIBUTE_NAME":
         if (C(f)) {
-          y = b(s, E, r);
-          const c = L(y, d.namespace);
-          d.props[c] = !0, y = "", n = "ATTRIBUTES", r++;
+          A = b(s, E, r);
+          const c = L(A, d.namespace);
+          d.props[c] = !0, A = "", n = "ATTRIBUTES", r++;
         } else if (f === 61)
-          y = b(s, E, r), n = "ATTRIBUTE_VALUE_START", r++;
+          A = b(s, E, r), n = "ATTRIBUTE_VALUE_START", r++;
         else if (f === 62) {
-          y = b(s, E, r);
-          const c = L(y, d.namespace);
-          d.props[c] = !0, y = "";
+          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) {
-          y = b(s, E, r);
-          const c = L(y, d.namespace);
-          d.props[c] = !0, y = "", n = "TAG_CLOSE_SELF", r++;
+          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":
@@ -463,15 +473,15 @@ function te(e, t = {}) {
         break;
       case "ATTRIBUTE_VALUE_QUOTED":
         if (f === q) {
-          const c = b(s, N, r), u = O(c), m = L(y, d.namespace);
-          m === "style" ? d.props[m] = F(u) : d.props[m] = u, y = "", n = "ATTRIBUTES", r++;
+          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
           r++;
         break;
       case "ATTRIBUTE_VALUE_UNQUOTED":
         if (C(f) || f === 62 || f === 47) {
-          const c = b(s, N, r), u = O(c), m = L(y, d.namespace);
-          m === "style" ? d.props[m] = F(u) : d.props[m] = u, y = "", n = "ATTRIBUTES";
+          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
           r++;
         break;
@@ -517,9 +527,9 @@ function te(e, t = {}) {
           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 A = r + u.length;
-            for (; A < s.length && s[A] !== 62; ) A++;
-            I(c), n = "TEXT", h = A + 1, r = A + 1;
+            let y = r + u.length;
+            for (; y < s.length && s[y] !== 62; ) y++;
+            I(c), n = "TEXT", h = y + 1, r = y + 1;
           } else
             r++;
         } else
@@ -611,8 +621,8 @@ function ie(e, t, i, l, s, a, p) {
       if (E === !0)
         t.push(" "), t.push(N);
       else if (g === "style" && typeof E == "object") {
-        const y = ne(E);
-        y && (t.push(' style="'), t.push(G(y, !0)), t.push('"'));
+        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('"');
     }
@@ -623,13 +633,13 @@ function ie(e, t, i, l, s, a, p) {
   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" ? Q(g, t) : R(g, t, T, l, s, a, p), t.push("</"), t.push(o), t.push(">");
-  } else K.has(o), t.push("></"), t.push(o), t.push(">");
+    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") {
-      t.push(J(e));
+      t.push(ee(e));
       return;
     }
     if (typeof e == "number" || typeof e == "bigint" || typeof e == "boolean") {
@@ -644,7 +654,7 @@ function j(e, t, i, l, s, a, p, o) {
     R(e, t, i, l, s, a, p);
   }
 }
-function Q(e, t) {
+function K(e, t) {
   if (e != null) {
     if (typeof e == "string") {
       t.push(e);
@@ -656,7 +666,7 @@ function Q(e, t) {
     }
     if (Array.isArray(e)) {
       for (const i of e)
-        Q(i, t);
+        K(i, t);
       return;
     }
   }
@@ -665,12 +675,12 @@ function ne(e) {
   const t = [];
   for (const [i, l] of Object.entries(e))
     if (l) {
-      const s = ee(i);
+      const s = te(i);
       t.push(`${s}: ${l}`);
     }
   return t.join("; ");
 }
-function ye(e) {
+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) {
@@ -896,7 +906,7 @@ function X(e, t) {
     props: p
   };
 }
-function Ae(e, t = {}) {
+function ye(e, t = {}) {
   const i = pe(t);
   return X(e, i);
 }
@@ -915,25 +925,26 @@ function Y(e, t) {
   }
   return null;
 }
-function be(e, t = {}) {
-  return te(e, t);
-}
 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);
 }
-async function we(e) {
+async function Ne(e) {
   return await U(e);
 }
-function Ne(e, t = {}) {
-  return Ae(e, t);
+function Ce(e, t = {}) {
+  return ye(e, t);
 }
 export {
-  we as awaitHtmlNode,
+  Ne as awaitHtmlNode,
   O as decodeHtmlEntities,
   G as encodeHtmlEntities,
-  ye as getTextContent,
+  be as getTextContent,
   Y as htmlNodeTo,
-  be as readHtml,
-  Ne as safeHtml,
-  Ee as writeHtml
+  Ae as htmlNodeToHtmlElement,
+  Ee as readHtml,
+  Ce as safeHtml,
+  we as writeHtml
 };

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.1.0",
+  "version": "0.1.1",
   "type": "module",
   "license": "MIT",
   "main": "./dist/index.js",