@foxycape/core 1.1.3

package/dist/kernal/html/injector.mjs

@@ -0,0 +1,110 @@
+import { isNullOrWhiteSpace as f } from "../common/text.mjs";
+import { computeUniqueId as d } from "../common/uuid.mjs";
+import { getDocumentHead as D } from "./finder.mjs";
+const m = (e, t, c, n) => {
+  const i = e.ownerDocument ? e.ownerDocument : e;
+  if (!i.getElementById(t))
+    if (e.ownerDocument && e != i.documentElement)
+      n ? n(e, c) : e.appendChild(c);
+    else {
+      const s = D(i);
+      n ? n(s, c) : s.appendChild(c);
+    }
+}, w = (e, t, c, n, i, o) => {
+  if (!e || f(t))
+    return;
+  f(n) && (n = d(t));
+  const s = e.ownerDocument ? e.ownerDocument : e, u = s.getElementById(n);
+  if (u) {
+    if (!c) return;
+    u.parentElement?.removeChild(u);
+  }
+  let a;
+  if (i == "css") {
+    const r = l(s, "style", n, {
+      type: "text/css"
+    });
+    r.appendChild(s.createTextNode(t)), a = r;
+  } else if (i == "script") {
+    const r = l(s, "script", n, "");
+    r.type = "text/javascript", r.text = `//<![CDATA[\r
+` + t + `\r
+//]]>`, r.async = !1, a = r;
+  } else
+    return;
+  m(e, n, a, o);
+}, l = (e, t, c, n) => {
+  const o = (e.ownerDocument ? e.ownerDocument : e).createElement(t);
+  if (f(c) || o.setAttribute("id", c), n == null) return o;
+  if (typeof n == "string") {
+    if (f(n)) return o;
+    o.setAttribute("class", n);
+  } else
+    Object.keys(n).forEach((u) => {
+      const a = n[u];
+      o.setAttribute(u, a);
+    });
+  return o;
+}, C = (e, t) => !!(e.ownerDocument ? e.ownerDocument : e)?.getElementById(t), E = (e, t) => {
+  if (f(t))
+    return;
+  const n = (e.ownerDocument ? e.ownerDocument : e).getElementById(t);
+  n && n.parentElement?.removeChild(n);
+}, g = (e, t, c, n = "") => {
+  w(e, t, c, n, "script");
+}, v = (e, t, c, n = "", i) => {
+  w(e, t, c, n, "css", i);
+}, B = async (e, t, c, n = "", i) => {
+  if (!e || f(t))
+    return;
+  f(n) && (n = d(t));
+  const s = (e.ownerDocument ? e.ownerDocument : e).getElementById(n);
+  if (s)
+    if (c)
+      s.parentElement?.removeChild(s);
+    else
+      return s.getAttribute("data-load-state") == "loading" ? new Promise((u, a) => {
+        s.addEventListener("load", (r) => {
+          u();
+        }, !1), s.addEventListener("error", (r) => {
+          a(r.error);
+        }, !1);
+      }) : void 0;
+  return new Promise((u, a) => {
+    const r = l(e, "script", n);
+    i?.type && (r.type = i?.type), r.src = t, i?.defer && (r.defer = !0), i?.async && (r.async = !0), i?.elementCallback && i?.elementCallback(r), r.setAttribute("data-load-state", "loading"), r.addEventListener("load", (p) => {
+      r.setAttribute("data-load-state", "success"), u();
+    }, !1), r.addEventListener("error", (p) => {
+      r.setAttribute("data-load-state", "fail"), a(p);
+    }, !1), m(e, n, r);
+  });
+}, k = async (e, t, c, n = "") => {
+  if (!e || f(t))
+    return;
+  f(n) && (n = d(t));
+  const i = e.ownerDocument ? e.ownerDocument : e, o = i.getElementById(n);
+  if (o) {
+    if (!c) return;
+    o.parentElement?.removeChild(o);
+  }
+  if (i.defaultView)
+    return new Promise((s, u) => {
+      const a = l(e, "link", n);
+      a.type = "text/css", a.rel = "stylesheet", a.href = t, a.onload = (r) => {
+        s();
+      }, a.onerror = u, m(e, n, a);
+    });
+  {
+    const s = l(e, "link", n);
+    s.type = "text/css", s.rel = "stylesheet", s.href = t, m(e, n, s);
+  }
+};
+export {
+  l as createElement,
+  C as existsElement,
+  v as injectCssContent,
+  k as injectExternalCss,
+  B as injectExternalJS,
+  g as injectJSContent,
+  E as removeElement
+};

package/dist/kernal/html/manipulator.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("../Constants.cjs"),E=require("./finder.cjs"),g=require("./text.cjs"),p=(t,c)=>{const d=E.getDocumentBody(t);if(!d)return;const r=e=>{const n=e.tagName;if(n==="SCRIPT"||n==="STYLE"||n==="NOSCRIPT"||n==="IFRAME"||n==="OBJECT"||n==="EMBED"||n==="TEMPLATE"||n==="TEXTAREA")return!0;const i=e.namespaceURI;return i==="http://www.w3.org/2000/svg"||i==="http://www.w3.org/1998/Math/MathML"},l=e=>!!(e.data&&/\S/.test(e.data)),a=e=>{let n=e;for(;n;){if(E.compareTagName(n.tagName,u.MTTAG))return!0;n=n.parentElement}return!1},f=e=>{if(r(e))return;const n=Array.from(e.childNodes);for(const i of n){if(i.nodeType!==Node.TEXT_NODE)continue;const s=i;if(!l(s)||E.compareTagName(e.tagName,u.STTAG)||a(e))continue;const T=t.createElement(u.STTAG);e.insertBefore(T,s),T.appendChild(s)}for(const i of Array.from(e.childNodes))i.nodeType===Node.ELEMENT_NODE&&f(i)},o=e=>{if(r(e))return;const n=Array.from(e.childNodes);if(n.some(s=>s.nodeType===Node.ELEMENT_NODE)){for(const s of n){if(s.nodeType!==Node.TEXT_NODE)continue;const T=s;if(!l(T)||a(e))continue;const N=t.createElement(u.STTAG);e.insertBefore(N,T),N.appendChild(T)}for(const s of Array.from(e.childNodes))s.nodeType===Node.ELEMENT_NODE&&o(s)}};c?f(d):o(d)},h=(t,c,d,r,l,a)=>{for(let f=0;f<d.length;f++){let o=d[f],e=t(o);if(e.length>=r)if(o.nodeType==Node.TEXT_NODE){if(c.ownerDocument.getElementById(a))return;let n=e.slice(0,r)+l+e.slice(r),i=o.ownerDocument.createElement("n");i.innerHTML=n;let s=[];for(let T=0;T<i.childNodes.length;T++)s.push(i.childNodes.item(T));o.replaceWith(...s);break}else h(t,c,o.childNodes,r,l,a);else r-=e.length}},m=(t,c,d,r,l,a)=>{const f=n=>g.getPureTextContent(n,l,a)??"";if(!t)return;let o;if(t.tagIndex>=0){const{rootElement:n,tagName:i,tagIndex:s}=t;if(!n||!i)return;o=E.getElementByNameAndIndex(n,i,s)}else o=t;!o||o.ownerDocument.getElementById(r)||h(f,o,o.childNodes,c,d,r)},w=(t,c)=>{if(!t||!c||t.originHtml)return;const d=t.innerHTML;if(t.originHtml=d,t.children.length==0){const r=[...t.textContent].map(l=>`<${c}>${l}</${c}>`).join("");t.innerHTML=r}else{const r=E.getAllNodes(t);for(let l=0;l<r.length;l++){const a=r[l];if(a.nodeType==Node.TEXT_NODE){const f=[...a.textContent].map(e=>`<${c}>${e}</${c}>`).join(""),o=t.ownerDocument.createElement("k");o.innerHTML=f,a.parentElement.replaceChild(o,a)}}}},y=t=>{if(!t)return;const c=t.originHtml;c&&(t.innerHTML=c),t.originHtml=null};exports.insertElement=m;exports.recoverWrapperCharacters=y;exports.wrapFloatingTextNodes=p;exports.wrapperCharacters=w;

package/dist/kernal/html/manipulator.d.ts

@@ -0,0 +1,8 @@
+export declare const wrapFloatingTextNodes: (ownerDocument: Document, wrapFullTextNode?: boolean) => void;
+export declare const insertElement: (element: Element | {
+    rootElement: Document | Element;
+    tagName: string;
+    tagIndex: number;
+}, textPostion: number, html: string, htmlId: string, removeHtmlWhitespace?: boolean, whitespaceRegex?: RegExp) => void;
+export declare const wrapperCharacters: (element: Element, tagName: string) => void;
+export declare const recoverWrapperCharacters: (element: Element) => void;

package/dist/kernal/html/manipulator.mjs

@@ -0,0 +1,117 @@
+import { STTAG as T, MTTAG as g } from "../Constants.mjs";
+import { getElementByNameAndIndex as m, getDocumentBody as p, getAllNodes as w, compareTagName as N } from "./finder.mjs";
+import { getPureTextContent as y } from "./text.mjs";
+const C = (t, c) => {
+  const f = p(t);
+  if (!f)
+    return;
+  const r = (e) => {
+    const n = e.tagName;
+    if (n === "SCRIPT" || n === "STYLE" || n === "NOSCRIPT" || n === "IFRAME" || n === "OBJECT" || n === "EMBED" || n === "TEMPLATE" || n === "TEXTAREA")
+      return !0;
+    const i = e.namespaceURI;
+    return i === "http://www.w3.org/2000/svg" || i === "http://www.w3.org/1998/Math/MathML";
+  }, l = (e) => !!(e.data && /\S/.test(e.data)), d = (e) => {
+    let n = e;
+    for (; n; ) {
+      if (N(n.tagName, g))
+        return !0;
+      n = n.parentElement;
+    }
+    return !1;
+  }, a = (e) => {
+    if (r(e))
+      return;
+    const n = Array.from(e.childNodes);
+    for (const i of n) {
+      if (i.nodeType !== Node.TEXT_NODE)
+        continue;
+      const s = i;
+      if (!l(s) || N(e.tagName, T) || d(e))
+        continue;
+      const E = t.createElement(T);
+      e.insertBefore(E, s), E.appendChild(s);
+    }
+    for (const i of Array.from(e.childNodes))
+      i.nodeType === Node.ELEMENT_NODE && a(i);
+  }, o = (e) => {
+    if (r(e))
+      return;
+    const n = Array.from(e.childNodes);
+    if (n.some((s) => s.nodeType === Node.ELEMENT_NODE)) {
+      for (const s of n) {
+        if (s.nodeType !== Node.TEXT_NODE)
+          continue;
+        const E = s;
+        if (!l(E) || d(e))
+          continue;
+        const u = t.createElement(T);
+        e.insertBefore(u, E), u.appendChild(E);
+      }
+      for (const s of Array.from(e.childNodes))
+        s.nodeType === Node.ELEMENT_NODE && o(s);
+    }
+  };
+  c ? a(f) : o(f);
+}, h = (t, c, f, r, l, d) => {
+  for (let a = 0; a < f.length; a++) {
+    let o = f[a], e = t(o);
+    if (e.length >= r)
+      if (o.nodeType == Node.TEXT_NODE) {
+        if (c.ownerDocument.getElementById(d)) return;
+        let n = e.slice(0, r) + l + e.slice(r), i = o.ownerDocument.createElement("n");
+        i.innerHTML = n;
+        let s = [];
+        for (let E = 0; E < i.childNodes.length; E++)
+          s.push(i.childNodes.item(E));
+        o.replaceWith(...s);
+        break;
+      } else
+        h(t, c, o.childNodes, r, l, d);
+    else
+      r -= e.length;
+  }
+}, D = (t, c, f, r, l, d) => {
+  const a = (n) => y(n, l, d) ?? "";
+  if (!t) return;
+  let o;
+  if (t.tagIndex >= 0) {
+    const {
+      rootElement: n,
+      tagName: i,
+      tagIndex: s
+    } = t;
+    if (!n || !i) return;
+    o = m(n, i, s);
+  } else
+    o = t;
+  !o || o.ownerDocument.getElementById(r) || h(a, o, o.childNodes, c, f, r);
+}, L = (t, c) => {
+  if (!t || !c || t.originHtml)
+    return;
+  const f = t.innerHTML;
+  if (t.originHtml = f, t.children.length == 0) {
+    const r = [...t.textContent].map((l) => `<${c}>${l}</${c}>`).join("");
+    t.innerHTML = r;
+  } else {
+    const r = w(t);
+    for (let l = 0; l < r.length; l++) {
+      const d = r[l];
+      if (d.nodeType == Node.TEXT_NODE) {
+        const a = [...d.textContent].map((e) => `<${c}>${e}</${c}>`).join(""), o = t.ownerDocument.createElement("k");
+        o.innerHTML = a, d.parentElement.replaceChild(o, d);
+      }
+    }
+  }
+}, O = (t) => {
+  if (!t)
+    return;
+  const c = t.originHtml;
+  c && (t.innerHTML = c), t.originHtml = null;
+};
+export {
+  D as insertElement,
+  O as recoverWrapperCharacters,
+  C as wrapFloatingTextNodes,
+  L as wrapperCharacters
+};

package/dist/kernal/html/parser.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("../web/BrowserCapabilities.cjs"),a=new Set(["area","base","br","col","embed","hr","img","input","link","meta","param","source","track","wbr"]),m=e=>e.replace(/<([A-Za-z][\w:-]*)([^>]*)\/>/g,(t,r,o)=>a.has(r.toLowerCase())?t:`<${r}${o}></${r}>`),u=e=>/<\?xml[\s\S]*?\?>/i.test(e),p=e=>/xmlns\s*=\s*["']?http:\/\/www\.w3\.org\/1999\/xhtml["']?/i.test(e),d=e=>{const t=/<([A-Za-z][\w:-]*)[^>]*\/>/g;let r;for(;(r=t.exec(e))!==null;)if(!a.has(r[1].toLowerCase()))return!0;return!1},n=e=>new DOMParser().parseFromString(m(e),"text/html"),h=e=>{const t=new DOMParser().parseFromString(e,"application/xhtml+xml");return t.querySelector("parsererror")?{document:n(e),docType:"html"}:{document:t,docType:"xhtml"}},l=e=>{if(u(e)||p(e))return h(e);if(d(e)){const t=new DOMParser().parseFromString(e,"application/xml");return t.querySelector("parsererror")?{document:n(e),docType:"html"}:{document:t,docType:"xml"}}return{document:n(e),docType:"html"}},s=e=>{const t=e.documentElement;if(!t)return new DOMParser().parseFromString("<!DOCTYPE html><html></html>","text/html");const r=m(`<!DOCTYPE html>${t.outerHTML}`);return new DOMParser().parseFromString(r,"text/html")},w=(e,t)=>{const{document:r,docType:o}=l(e);return o==="html"||!t?r:s(r)},D=async(e,t)=>{const{document:r,docType:o}=l(e);if(await c.BrowserCapabilities.yieldToMain(),o==="html"||!t)return r;const i=s(r);return await c.BrowserCapabilities.yieldToMain(),i};exports.convertToHtml5Document=s;exports.getFormatDocument=w;exports.getFormatDocumentAsync=D;

package/dist/kernal/html/parser.d.ts

@@ -0,0 +1,3 @@
+export declare const convertToHtml5Document: (doc: Document) => Document;
+export declare const getFormatDocument: (html: string, convertToHtml5?: boolean) => Document;
+export declare const getFormatDocumentAsync: (html: string, convertToHtml5?: boolean) => Promise<Document>;

package/dist/kernal/html/parser.mjs

@@ -0,0 +1,61 @@
+import { BrowserCapabilities as s } from "../web/BrowserCapabilities.mjs";
+const c = /* @__PURE__ */ new Set(["area", "base", "br", "col", "embed", "hr", "img", "input", "link", "meta", "param", "source", "track", "wbr"]), a = (t) => t.replace(/<([A-Za-z][\w:-]*)([^>]*)\/>/g, (e, r, n) => c.has(r.toLowerCase()) ? e : `<${r}${n}></${r}>`), u = (t) => /<\?xml[\s\S]*?\?>/i.test(t), p = (t) => /xmlns\s*=\s*["']?http:\/\/www\.w3\.org\/1999\/xhtml["']?/i.test(t), d = (t) => {
+  const e = /<([A-Za-z][\w:-]*)[^>]*\/>/g;
+  let r;
+  for (; (r = e.exec(t)) !== null; )
+    if (!c.has(r[1].toLowerCase()))
+      return !0;
+  return !1;
+}, o = (t) => new DOMParser().parseFromString(a(t), "text/html"), h = (t) => {
+  const e = new DOMParser().parseFromString(t, "application/xhtml+xml");
+  return e.querySelector("parsererror") ? {
+    document: o(t),
+    docType: "html"
+  } : {
+    document: e,
+    docType: "xhtml"
+  };
+}, m = (t) => {
+  if (u(t) || p(t))
+    return h(t);
+  if (d(t)) {
+    const e = new DOMParser().parseFromString(t, "application/xml");
+    return e.querySelector("parsererror") ? {
+      document: o(t),
+      docType: "html"
+    } : {
+      document: e,
+      docType: "xml"
+    };
+  }
+  return {
+    document: o(t),
+    docType: "html"
+  };
+}, l = (t) => {
+  const e = t.documentElement;
+  if (!e)
+    return new DOMParser().parseFromString("<!DOCTYPE html><html></html>", "text/html");
+  const r = a(`<!DOCTYPE html>${e.outerHTML}`);
+  return new DOMParser().parseFromString(r, "text/html");
+}, D = (t, e) => {
+  const {
+    document: r,
+    docType: n
+  } = m(t);
+  return n === "html" || !e ? r : l(r);
+}, T = async (t, e) => {
+  const {
+    document: r,
+    docType: n
+  } = m(t);
+  if (await s.yieldToMain(), n === "html" || !e)
+    return r;
+  const i = l(r);
+  return await s.yieldToMain(), i;
+};
+export {
+  l as convertToHtml5Document,
+  D as getFormatDocument,
+  T as getFormatDocumentAsync
+};

package/dist/kernal/html/position.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const T=require("../Constants.cjs"),w=require("../common/uuid.cjs"),d=require("./finder.cjs"),P=require("./parser.cjs"),b=require("./text.cjs"),E=require("./types.cjs"),p=new Map,B=new Map,v=()=>{B.clear(),p.clear()},x=e=>{const s=(e instanceof Document?e.body:e).childNodes;for(const o of s)if(o.nodeType==Node.TEXT_NODE&&o.textContent?.trim())return!0;return!1},W=(e,t)=>{let s=0;return!t||t.length==0||t.forEach(o=>{s+=e.getElementsByTagName(o).length}),s},C=(e,t,s)=>{const{removeHtmlWhitespace:o,whitespaceRegex:r,nonWhiteSpaceSymbolTagNames:f}=s??{};let i=p.get(e);i||(i=w.getUuid(),p.set(e,i));let u=t.toString();r?.source&&(u+=r.source),f&&(u+=f.join("-")),u+=i;const a=e.ownerDocument?e:d.getDocumentBody(e),c=B.get(u);if(c&&c.length==a.getElementsByTagName("*").length+1)return c;const n=[];let m=0;const N=d.getAllNodes(a);for(let y=0;y<N.length;y++){const l=N[y];if(l.nodeType==Node.ELEMENT_NODE){const h=l;n.push(new E.SymbolOffset(h,m)),t=="custom"&&d.checkIsOtherNonWhiteSpaceSymbol(h.tagName,f)&&(m+=1)}else l.nodeType==Node.TEXT_NODE&&(m+=b.getPureInnerTextLength(l,o,r))}const g=n.reverse();return B.set(u,g),g},k=(e,t,s,o)=>{const f=C(e,s,o).find(i=>i.element==t);return f?f.offset:-1},S=(e,t,s)=>{const{removeHtmlWhitespace:o,whitespaceRegex:r,nonWhiteSpaceSymbolTagNames:f}=s??{};let i;if(typeof e=="string"){const c=b.removeWhiteSpaceBetweenTags(e,o),n=P.getFormatDocument(c,!0);i=d.getDocumentBody(n)}else e.ownerDocument?i=e:i=d.getDocumentBody(e);let a=b.getPureInnerTextLength(i,o,r);if(t=="custom"){const c=W(i,f);a+=c}return a},L=(e,t,s,o)=>{t=t??0;const r=S(e,s,o),f=Math.ceil(r*t);return I(e,f,s,!1,o)},M=(e,t,s,o,r)=>{const f=S(e,s,r);return D(e,t,s,o,r)/f},I=(e,t,s,o,r)=>{const{removeHtmlWhitespace:f,whitespaceRegex:i}=r??{},u=r?.nonWhiteSpaceSymbolTagNames??[],a=C(e,s,{...r,nonWhiteSpaceSymbolTagNames:u});let c=a.findIndex(l=>t>=l.offset);if(c<0)return null;let n=a[c];if(!n.element.getAttribute(T.ElementInitialNumberName)){const l=a.length-1;for(;c<l&&(c++,n=a[c],!n.element.getAttribute(T.ElementInitialNumberName)););}let m,N=t-n.offset,g=S(n.element,s,r);if(N==0&&o&&c<a.length-1&&(n=a[c+1]),N=t-n.offset,g=S(n.element,s,r),N>g)if(c==0)m=g;else{if(n=a.find(l=>l.element==n.element.parentElement),!n)if(x(e)){const l=e instanceof Document?e.body:e;n=new E.SymbolOffset(l,0)}else n=a[c-1];if(!x(e)&&s=="char"&&d.compareTagName(n.element.tagName,"BODY")){const l=a[c-1];l&&l.offset>=t&&(n=l)}}if(!x(e)&&s=="char"&&d.compareTagName(n.element.tagName,"BODY")){const l=n.element.children;let h;for(let O=0;O<l.length;O++)if(!u.includes(l[O].tagName.toLowerCase())){h=l[O];break}if(h)return{element:h,index:0,offset:0}}if(m===void 0){if(m=t-n.offset,m<0)m=0;else if(s=="char"){g=b.getPureInnerTextLength(n.element,f,i);let l=0;for(;m>g&&l<256;){l++;const h=a.find(O=>O.element===n.element.parentElement);if(!h){m=g;break}if(n=h,g=b.getPureInnerTextLength(n.element,f,i),m=t-n.offset,m<0){m=0;break}}m>g&&(m=g)}}let y=d.getElementIndex(e,n.element);return y==-1&&d.compareTagName(n.element.tagName,"BODY")&&(y=T.ROOT_IDX),{element:n.element,index:y,offset:m}},D=(e,t,s,o,r)=>{let f;if(t.tagIndex>=0){const u=t;f=d.getElementByNameAndIndex(e,u.tagName,u.tagIndex??0)}else f=t;return f?k(e,f,s,r)+(o??0):-1},R=(e,t,s,o)=>{const{removeHtmlWhitespace:r,whitespaceRegex:f}=o??{};if(!t)return-1;if(t.nodeType===Node.ELEMENT_NODE)return D(e,t,s,0,o);const i=e.ownerDocument?e:d.getDocumentBody(e),u=d.getAllNodes(i);let a=0;for(let c=0;c<u.length;c++){const n=u[c];if(n===t)return a;n.nodeType===Node.TEXT_NODE&&(a+=b.getPureInnerTextLength(n,r,f))}return-1};class q{constructor(t,s,o){this.element=t,this.index=s,this.offset=o}}exports.ElementPositionResult=q;exports.calcSymbolOffsets=C;exports.checkContainsPureTextNode=x;exports.clearSymbolOffsetCache=v;exports.getElementByPosition=I;exports.getElementByProgress=L;exports.getPositionByElement=D;exports.getPositionByNode=R;exports.getProgressByElement=M;exports.getTotalSymbolCount=S;

package/dist/kernal/html/position.d.ts

@@ -0,0 +1,24 @@
+import { SymbolType, TextSymbolOptions } from '../types';
+import { SymbolOffset } from './types';
+
+export declare const clearSymbolOffsetCache: () => void;
+export declare const checkContainsPureTextNode: (rootElement: Document | HTMLElement) => boolean;
+export declare const calcSymbolOffsets: (rootElement: Document | Element, symbolType: SymbolType, options?: TextSymbolOptions) => SymbolOffset[];
+export declare const getTotalSymbolCount: (target: string | Document | Element, symbolType: SymbolType, options?: TextSymbolOptions) => number;
+export declare const getElementByProgress: (rootElement: Document | HTMLElement, progress: number, symbolType: SymbolType, options?: TextSymbolOptions) => ElementPositionResult;
+export declare const getProgressByElement: (rootElement: Document | HTMLElement, element: {
+    tagName: string;
+    tagIndex: number;
+} | Element, symbolType: SymbolType, internalSymbolOffset?: number, options?: TextSymbolOptions) => number;
+export declare const getElementByPosition: (rootElement: Document | HTMLElement, symbolPosition: number, symbolType: SymbolType, preferEnd?: boolean, options?: TextSymbolOptions) => ElementPositionResult;
+export declare const getPositionByElement: (rootElement: Document | Element, tag: {
+    tagName: string;
+    tagIndex: number;
+} | Element, symbolType: SymbolType, internalSymbolOffset?: number, options?: TextSymbolOptions) => number;
+export declare const getPositionByNode: (rootElement: Document | Element, node: Node, symbolType: SymbolType, options?: TextSymbolOptions) => number;
+export declare class ElementPositionResult {
+    readonly element: Element;
+    readonly index: number;
+    readonly offset: number;
+    constructor(element: Element, index: number, offset: number);
+}

package/dist/kernal/html/position.mjs

@@ -0,0 +1,194 @@
+import { ElementInitialNumberName as D, ROOT_IDX as W } from "../Constants.mjs";
+import { getUuid as v } from "../common/uuid.mjs";
+import { getDocumentBody as y, getAllNodes as T, checkIsOtherNonWhiteSpaceSymbol as k, compareTagName as p, getElementIndex as M, getElementByNameAndIndex as R } from "./finder.mjs";
+import { getFormatDocument as _ } from "./parser.mjs";
+import { getPureInnerTextLength as b, removeWhiteSpaceBetweenTags as H } from "./text.mjs";
+import { SymbolOffset as I } from "./types.mjs";
+const w = /* @__PURE__ */ new Map(), C = /* @__PURE__ */ new Map(), q = () => {
+  C.clear(), w.clear();
+}, x = (e) => {
+  const s = (e instanceof Document ? e.body : e).childNodes;
+  for (const o of s)
+    if (o.nodeType == Node.TEXT_NODE && o.textContent?.trim())
+      return !0;
+  return !1;
+}, A = (e, t) => {
+  let s = 0;
+  return !t || t.length == 0 || t.forEach((o) => {
+    s += e.getElementsByTagName(o).length;
+  }), s;
+}, B = (e, t, s) => {
+  const {
+    removeHtmlWhitespace: o,
+    whitespaceRegex: r,
+    nonWhiteSpaceSymbolTagNames: l
+  } = s ?? {};
+  let i = w.get(e);
+  i || (i = v(), w.set(e, i));
+  let u = t.toString();
+  r?.source && (u += r.source), l && (u += l.join("-")), u += i;
+  const m = e.ownerDocument ? e : y(e), c = C.get(u);
+  if (c && c.length == m.getElementsByTagName("*").length + 1)
+    return c;
+  const n = [];
+  let a = 0;
+  const N = T(m);
+  for (let h = 0; h < N.length; h++) {
+    const f = N[h];
+    if (f.nodeType == Node.ELEMENT_NODE) {
+      const d = f;
+      n.push(new I(d, a)), t == "custom" && k(d.tagName, l) && (a += 1);
+    } else f.nodeType == Node.TEXT_NODE && (a += b(f, o, r));
+  }
+  const g = n.reverse();
+  return C.set(u, g), g;
+}, L = (e, t, s, o) => {
+  const l = B(e, s, o).find((i) => i.element == t);
+  return l ? l.offset : -1;
+}, S = (e, t, s) => {
+  const {
+    removeHtmlWhitespace: o,
+    whitespaceRegex: r,
+    nonWhiteSpaceSymbolTagNames: l
+  } = s ?? {};
+  let i;
+  if (typeof e == "string") {
+    const c = H(e, o), n = _(c, !0);
+    i = y(n);
+  } else e.ownerDocument ? i = e : i = y(e);
+  let m = b(i, o, r);
+  if (t == "custom") {
+    const c = A(i, l);
+    m += c;
+  }
+  return m;
+}, z = (e, t, s, o) => {
+  t = t ?? 0;
+  const r = S(e, s, o), l = Math.ceil(r * t);
+  return P(e, l, s, !1, o);
+}, J = (e, t, s, o, r) => {
+  const l = S(e, s, r);
+  return E(e, t, s, o, r) / l;
+}, P = (e, t, s, o, r) => {
+  const {
+    removeHtmlWhitespace: l,
+    whitespaceRegex: i
+  } = r ?? {}, u = r?.nonWhiteSpaceSymbolTagNames ?? [], m = B(e, s, {
+    ...r,
+    nonWhiteSpaceSymbolTagNames: u
+  });
+  let c = m.findIndex((f) => t >= f.offset);
+  if (c < 0)
+    return null;
+  let n = m[c];
+  if (!n.element.getAttribute(D)) {
+    const f = m.length - 1;
+    for (; c < f && (c++, n = m[c], !n.element.getAttribute(D)); )
+      ;
+  }
+  let a, N = t - n.offset, g = S(n.element, s, r);
+  if (N == 0 && o && c < m.length - 1 && (n = m[c + 1]), N = t - n.offset, g = S(n.element, s, r), N > g)
+    if (c == 0)
+      a = g;
+    else {
+      if (n = m.find((f) => f.element == n.element.parentElement), !n)
+        if (x(e)) {
+          const f = e instanceof Document ? e.body : e;
+          n = new I(f, 0);
+        } else
+          n = m[c - 1];
+      if (!x(e) && s == "char" && p(n.element.tagName, "BODY")) {
+        const f = m[c - 1];
+        f && f.offset >= t && (n = f);
+      }
+    }
+  if (!x(e) && s == "char" && p(n.element.tagName, "BODY")) {
+    const f = n.element.children;
+    let d;
+    for (let O = 0; O < f.length; O++)
+      if (!u.includes(f[O].tagName.toLowerCase())) {
+        d = f[O];
+        break;
+      }
+    if (d)
+      return {
+        element: d,
+        index: 0,
+        offset: 0
+      };
+  }
+  if (a === void 0) {
+    if (a = t - n.offset, a < 0)
+      a = 0;
+    else if (s == "char") {
+      g = b(n.element, l, i);
+      let f = 0;
+      for (; a > g && f < 256; ) {
+        f++;
+        const d = m.find((O) => O.element === n.element.parentElement);
+        if (!d) {
+          a = g;
+          break;
+        }
+        if (n = d, g = b(n.element, l, i), a = t - n.offset, a < 0) {
+          a = 0;
+          break;
+        }
+      }
+      a > g && (a = g);
+    }
+  }
+  let h = M(e, n.element);
+  return h == -1 && p(n.element.tagName, "BODY") && (h = W), {
+    element: n.element,
+    index: h,
+    offset: a
+  };
+}, E = (e, t, s, o, r) => {
+  let l;
+  if (t.tagIndex >= 0) {
+    const u = t;
+    l = R(e, u.tagName, u.tagIndex ?? 0);
+  } else
+    l = t;
+  return l ? L(e, l, s, r) + (o ?? 0) : -1;
+}, K = (e, t, s, o) => {
+  const {
+    removeHtmlWhitespace: r,
+    whitespaceRegex: l
+  } = o ?? {};
+  if (!t) return -1;
+  if (t.nodeType === Node.ELEMENT_NODE)
+    return E(e, t, s, 0, o);
+  const i = e.ownerDocument ? e : y(e), u = T(i);
+  let m = 0;
+  for (let c = 0; c < u.length; c++) {
+    const n = u[c];
+    if (n === t) return m;
+    n.nodeType === Node.TEXT_NODE && (m += b(n, r, l));
+  }
+  return -1;
+};
+class Q {
+  /**
+   * constructor
+   * @param element The element in the document.
+   * @param index The index of the element in the document.
+   * @param offset The internal symbol offset of the element.
+   */
+  constructor(t, s, o) {
+    this.element = t, this.index = s, this.offset = o;
+  }
+}
+export {
+  Q as ElementPositionResult,
+  B as calcSymbolOffsets,
+  x as checkContainsPureTextNode,
+  q as clearSymbolOffsetCache,
+  P as getElementByPosition,
+  z as getElementByProgress,
+  E as getPositionByElement,
+  K as getPositionByNode,
+  J as getProgressByElement,
+  S as getTotalSymbolCount
+};

package/dist/kernal/html/selection.cjs

@@ -0,0 +1,7 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const H=require("../common/text.cjs"),D=require("./finder.cjs"),A=(t,e)=>{if(!t)return null;const r=t.getSelection();if(!r||r.isCollapsed)return null;const n=r.getRangeAt(0);return!n||n.collapsed?null:e||n.toString()?n:null},W=(t,e)=>{if(!t)return!1;const r=A(t,!0);return r?e?!0:!H.isNullOrWhiteSpace(r.toString()):!1},_=/[.。．\u06D4\u061F\u0964\u0965\u1362\u0589\n]/,v=new Set(["div","p","h1","h2","h3","h4","h5","h6","li","blockquote","section","article","header","footer","nav","aside","main","hr","br","table","thead","tbody","tr","td","th","pre","address","details","dialog","fieldset","figure","figcaption","form","dl","dt","dd","ol","ul"]),I=/[\u201C\u201D\u0022\uFF02\u300D\u300F\u301D\u301E\u301F\u00BB\u2019\u02BA]/,x=/[\u200B\u200C\u200D\uFEFF\u2060]/,L=/[""\uFF02\u300C\u300E\u00AB'\u2018]/,R=/[0-9０-９٠-٩\u0660-\u0669]/,M=/[a-z\u00E0-\u024F\u0370-\u03FF]/,w=t=>{let e=t.nodeType===Node.TEXT_NODE?t.parentElement:t;for(;e&&e!==e.ownerDocument?.body;){if(e.nodeType===Node.ELEMENT_NODE&&v.has(e.tagName?.toLowerCase()))return e;e=e.parentElement}return e},j=(t,e,r)=>{if(t[e]!==`
+`)return!1;const n=r.findIndex(h=>e>=h.start&&e<h.end);if(n<0)return!1;const o=r[n];if(e!==o.start||n===0)return!1;const l=r[n-1],s=w(l.node),N=w(o.node);return s!==N},y=(t,e,r)=>{const n=t[e];if(!n||!_.test(n))return!1;if(n===`
+`)return r?j(t,e,r):!1;if(n==="."||n==="．"){const o=e>0?t[e-1]:"",l=e+1<t.length?t[e+1]:"";if(R.test(o)&&R.test(l)||R.test(o)&&(l===" "||l==="	"||l===`
+`))return!1;let s=e+1;for(;s<t.length&&(t[s]===" "||t[s]==="	");)s++;if(s<t.length&&M.test(t[s]))return!1}return!0},G=(t,e)=>{if(!t)return!1;const r=t.getSelection();if(!r||r.rangeCount===0)return!1;const n=r.getRangeAt(0).cloneRange(),o=e??D.getDocumentBody(t);if(!o||!o.contains(n.startContainer)||!o.contains(n.endContainer))return!1;const l=[];let s="";const N=t.createTreeWalker(o,NodeFilter.SHOW_TEXT,null);let h;for(;h=N.nextNode();){const u=h.textContent??"";u.length>0&&(l.push({node:h,start:s.length,end:s.length+u.length}),s+=u)}if(l.length===0)return!1;const O=(u,i)=>{try{const a=t.createRange();return a.setStart(o,0),a.setEnd(u,i),a.toString().length}catch{return 0}};let E=Math.max(0,Math.min(O(n.startContainer,n.startOffset),s.length)),T=Math.max(0,Math.min(O(n.endContainer,n.endOffset),s.length));E>T&&([E,T]=[T,E]);let f=0;for(let u=E-1;u>=0;u--)if(y(s,u,l)){for(;u>0&&_.test(s[u-1]);)u--;f=u+1;break}let c=s.length;for(let u=T;u<s.length;u++)if(y(s,u,l)){for(;u+1<s.length&&_.test(s[u+1]);)u++;c=u+1;break}for(f>c&&(c=f);f>0&&L.test(s[f-1]);)f--;for(;c<s.length&&(I.test(s[c])||x.test(s[c]));)c++;for(;f<c&&s[f]===`
+`;)f++;for(;c>f&&s[c-1]===`
+`;)c--;const S=u=>{const i=u.textContent?.trim()??"";return i===`
+`||i===""},k=(u,i)=>{for(let a=0;a<l.length;a++){const{node:g,start:F,end:b}=l[a];if(u>=F&&u<=b){if(S(g)){if(i){for(let d=a+1;d<l.length;d++)if(!S(l[d].node)){n.setStart(l[d].node,0);return}}else for(let d=a-1;d>=0;d--){const p=l[d].node;if(!S(p)){n.setEnd(p,(p.textContent??"").length);return}}const C=i?l[0]:l[l.length-1],X=i?0:(C.node.textContent??"").length;i?n.setStart(C.node,0):n.setEnd(C.node,X);return}const m=Math.min(u-F,(g.textContent??"").length);i?n.setStart(g,m):n.setEnd(g,m);return}}if(l.length>0){const a=i?l[0]:l[l.length-1],g=i?0:(a.node.textContent??"").length;i?n.setStart(a.node,0):n.setEnd(a.node,g)}};return k(f,!0),k(c,!1),r.removeAllRanges(),r.addRange(n),!0},q=t=>{if(t.nodeType===Node.TEXT_NODE)return t;const e=t.ownerDocument?.createTreeWalker(t,NodeFilter.SHOW_TEXT);return e?e.nextNode():null},P=t=>{if(t.nodeType===Node.TEXT_NODE)return t;const e=t.ownerDocument?.createTreeWalker(t,NodeFilter.SHOW_TEXT);if(!e)return null;let r=null,n;for(;n=e.nextNode();)r=n;return r},B=(t,e)=>{if(e<0)return null;const r=t.ownerDocument?.createTreeWalker(t,NodeFilter.SHOW_TEXT);if(!r)return null;let n=0,o=null,l;for(;l=r.nextNode();){o=l;const s=(l.textContent??"").length;if(e<=n+s)return{node:l,offset:e-n};n+=s}return o?{node:o,offset:(o.textContent??"").length}:null},V=(t,e)=>{if(e.nodeType===Node.TEXT_NODE){t.setStart(e,0);return}if(e.hasChildNodes()){t.setStart(e.firstChild,0);return}t.setStart(e,0)},Q=(t,e)=>{if(e.nodeType===Node.TEXT_NODE){t.setEnd(e,(e.textContent??"").length);return}const r=D.findLastNode(e);if(r.nodeType===Node.TEXT_NODE){t.setEnd(r,(r.textContent??"").length);return}t.setEnd(e,e.childNodes.length)},U=(t,e,r)=>{if(r!==void 0){const o=B(e,r);if(o){t.setStart(o.node,o.offset);return}}const n=e.nodeType===Node.TEXT_NODE?e:q(e);if(n){t.setStart(n,0);return}V(t,e)},z=(t,e,r)=>{if(r!==void 0){const o=B(e,r);if(o){t.setEnd(o.node,o.offset);return}}const n=e.nodeType===Node.TEXT_NODE?e:P(e);if(n){t.setEnd(n,(n.textContent??"").length);return}Q(t,e)},K=(t,e,r,n)=>{const o=t.ownerDocument;if(!o)return null;const l=o.createRange();try{U(l,t,r),z(l,e,n)}catch{return null}return l};exports.checkHasValidRange=W;exports.createRange=K;exports.expandSelectionToSentence=G;exports.getRange=A;

package/dist/kernal/html/selection.d.ts

@@ -0,0 +1,4 @@
+export declare const getRange: (ownerDocument: Document, allowEmptyRange?: boolean) => Range;
+export declare const checkHasValidRange: (ownerDocument: Document, allowEmptyRange?: boolean) => boolean;
+export declare const expandSelectionToSentence: (ownerDocument: Document, rootElement?: Element) => boolean;
+export declare const createRange: (startNode: Node, endNode: Node, startTextOffset?: number, endTextOffset?: number) => Range;