text-slicer 1.4.1 → 1.5.0-dev.0

package/dist/index.cjs.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p={splitMode:"both",cssVariables:!1,dataAttributes:!1,keepWhitespaceNodes:!0,freezeWordWidths:!1},i=Object.freeze({word:"ts-word",char:"ts-char",whitespace:"ts-whitespace"}),n=" ",u=e=>typeof window>"u"||typeof document>"u"?null:e?typeof e=="string"?document.querySelector(e):e:null,a=e=>{const t=Intl.Segmenter;if(typeof t=="function"){const s=new t("en",{granularity:"grapheme"});return Array.from(s.segment(e),r=>r.segment)}return Array.from(e)},d=e=>e.split(n),h=e=>{const t={};return Object.keys(e).forEach(s=>{const r=e[s];r!==void 0&&(t[s]=r)}),t};exports.CLASSNAMES=i,exports.TextSlicer=class{el;original;opts;callbacks;charIndex;mounted;ro=null;frozen=!1;freezeScheduled=!1;freezeWordWidthsBound=()=>{this.scheduleFreezeNow()};constructor(e={},t){const s=u(e.container);this.el=s,this.original=(r=>!!r&&typeof HTMLElement<"u"&&r instanceof HTMLElement)(s)?s.textContent?.toString()??"":"",this.opts={...p,...h(e)},this.callbacks=t,this.charIndex=0,this.mounted=!1}get metrics(){const e=this.original;return{wordTotal:e.length?d(e).length:0,charTotal:e.length,renderedAt:Date.now()}}init(){this.el&&(this.mounted=!0,this.split())}reinit(e,t){this.el&&(typeof e=="string"&&(this.original=e),t&&(this.opts={...this.opts,...h(t)}),this.split())}clear(){this.el&&(this.unfreezeWordWidths(),this.el.replaceChildren())}split(){if(!this.el)return;this.clear(),this.charIndex=0;const e=this.original,t=document.createDocumentFragment(),s=d(e);this.opts.splitMode==="chars"?this.appendChars(t,e):this.appendWords(t,s),this.el.appendChild(t),this.opts.cssVariables&&(this.el.style.setProperty("--word-total",String(s.length)),this.el.style.setProperty("--char-total",String(e.length))),this.scheduleFreezeWordWidths().then(()=>{this.callbacks?.onAfterRender?.(this.metrics)}).catch(()=>{})}destroy(){this.el&&(this.detachResizeObserver(),this.clear(),this.mounted=!1)}updateOptions(e){this.opts={...this.opts,...h(e)},this.mounted&&this.split()}appendWords(e,t){t.forEach((s,r)=>{if(this.opts.splitMode==="both"){const o=this.createWordSpan(r,s);for(const c of a(s)){const l=this.createCharSpan(c);o.append(l)}e.append(o)}else{const o=this.createWordSpan(r);o.append(document.createTextNode(s)),e.append(o)}r<t.length-1&&e.append(this.createSpaceSpan())})}appendChars(e,t){for(const s of a(t)){const r=this.createCharSpan(s);e.append(r)}}createWordSpan(e,t=""){const s=document.createElement("span");return s.classList.add(i.word),this.opts.dataAttributes&&t&&s.setAttribute("data-word",t),this.opts.cssVariables&&s.style.setProperty("--word-index",String(e)),s}createCharSpan(e){const t=document.createElement("span");return t.textContent=e,this.opts.dataAttributes&&t.setAttribute("data-char",e),e===n?(t.classList.add(i.whitespace),this.opts.keepWhitespaceNodes||(t.textContent=n)):(t.classList.add(i.char),this.opts.cssVariables&&t.style.setProperty("--char-index",String(this.charIndex)),this.charIndex+=1),t}createSpaceSpan(){const e=document.createElement("span");return e.classList.add(i.whitespace),e.textContent=n,e}scheduleFreezeNow(){this.el&&this.opts.freezeWordWidths&&(this.freezeScheduled||(this.freezeScheduled=!0,requestAnimationFrame(()=>{this.freezeScheduled=!1,this.freezeWordWidths()})))}async scheduleFreezeWordWidths(){if(this.el&&this.opts.freezeWordWidths){try{await document.fonts?.ready}catch{}await new Promise(e=>requestAnimationFrame(()=>e())),this.scheduleFreezeNow(),this.attachResizeObserver()}}measureWordWidths(){if(!this.el)return[];const e=this.el.querySelectorAll(`.${i.word}`);return Array.from(e,t=>{t.style.width="",t.style.flex="";const{width:s}=t.getBoundingClientRect();return Math.ceil(s)})}applyWordWidths(e){this.el&&this.el.querySelectorAll(`.${i.word}`).forEach((t,s)=>{const r=e[s]??0;t.style.width=`${r}px`,t.style.flex="0 0 auto"})}freezeWordWidths(){if(!this.el)return;const e=this.measureWordWidths();this.applyWordWidths(e),this.frozen=!0}unfreezeWordWidths(){!this.el||!this.frozen||(this.el.querySelectorAll(`.${i.word}`).forEach(e=>{e.style.width="",e.style.flex=""}),this.frozen=!1)}attachResizeObserver(){if(this.el&&this.opts.freezeWordWidths){if(!this.ro){this.ro=new ResizeObserver(()=>{this.scheduleFreezeNow()});try{this.ro.observe(this.el,{box:"border-box"})}catch{this.ro.observe(this.el)}}window.addEventListener("resize",this.freezeWordWidthsBound,{passive:!0})}}detachResizeObserver(){this.ro&&(this.ro.disconnect(),this.ro=null),window.removeEventListener("resize",this.freezeWordWidthsBound)}};
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const m={splitMode:"both",cssVariables:!1,dataAttributes:!1,keepWhitespaceNodes:!0,iosSafariTransformFix:!1,extraCharWrapper:!1},n=Object.freeze({word:"ts-word",char:"ts-char",charWrap:"ts-char-wrap",whitespace:"ts-whitespace"}),a=" ",c="--char-index",d=()=>typeof window<"u"&&typeof document<"u",p=t=>{const e=Intl.Segmenter;if(typeof e=="function"){const s=new e("en",{granularity:"grapheme"});return Array.from(s.segment(t),r=>r.segment)}return Array.from(t)},l=t=>t.split(a),h=t=>{const e={};return Object.keys(t).forEach(s=>{const r=t[s];r!==void 0&&(e[s]=r)}),e};exports.CLASSNAMES=n,exports.TextSlicer=class{el;original;opts;callbacks;charIndex;mounted;constructor(t={},e){const s=(r=t.container,d()&&r?typeof r=="string"?document.querySelector(r):r:null);var r;this.el=s,this.original=(i=>!!i&&typeof HTMLElement<"u"&&i instanceof HTMLElement)(s)?s.textContent?.toString()??"":"",this.opts={...m,...h(t)},this.callbacks=e,this.charIndex=0,this.mounted=!1}get metrics(){const t=this.original;return{wordTotal:t.length?l(t).length:0,charTotal:t.length,renderedAt:Date.now()}}init(){this.el&&(this.mounted=!0,this.split())}reinit(t,e){this.el&&(typeof t=="string"&&(this.original=t),e&&(this.opts={...this.opts,...h(e)}),this.split())}clear(){this.el&&(this.el.style.minHeight="",this.el.replaceChildren())}split(){if(!this.el)return;this.clear(),this.charIndex=0;const t=this.original,e=document.createDocumentFragment(),s=l(t);this.opts.splitMode==="chars"?this.appendChars(e,t):this.appendWords(e,s),this.el.appendChild(e),this.opts.cssVariables&&(this.el.style.setProperty("--word-total",String(s.length)),this.el.style.setProperty("--char-total",String(t.length))),this.opts.iosSafariTransformFix&&(()=>{if(!d())return!1;const r=navigator.userAgent||"",i=/iP(hone|ad|od)/.test(r),o=/WebKit/.test(r)&&!/Chrome|CriOS|FxiOS|EdgiOS/.test(r);return i&&o})()&&this.applyIOSContainerSizeFix(),this.callbacks?.onAfterRender?.(this.metrics)}destroy(){this.el&&(this.clear(),this.mounted=!1)}updateOptions(t){this.opts={...this.opts,...h(t)},this.mounted&&this.split()}appendWords(t,e){e.forEach((s,r)=>{if(this.opts.splitMode==="both"){const i=this.createWordSpan(r,s);for(const o of p(s)){const u=this.createCharNode(o);i.append(u)}t.append(i)}else{const i=this.createWordSpan(r);i.append(document.createTextNode(s)),t.append(i)}r<e.length-1&&t.append(this.createSpaceSpan())})}appendChars(t,e){for(const s of p(e)){const r=this.createCharNode(s);t.append(r)}}createWordSpan(t,e=""){const s=document.createElement("span");return s.classList.add(n.word),this.opts.dataAttributes&&e&&s.setAttribute("data-word",e),this.opts.cssVariables&&s.style.setProperty("--word-index",String(t)),s}createCharNode(t){if(t===a){const s=document.createElement("span");return s.classList.add(n.whitespace),s.textContent=a,s}if(this.opts.extraCharWrapper){const s=document.createElement("span");s.classList.add(n.charWrap);const r=document.createElement("span");return r.classList.add(n.char),r.textContent=t,this.opts.dataAttributes&&r.setAttribute("data-char",t),this.opts.cssVariables&&r.style.setProperty(c,String(this.charIndex)),this.charIndex+=1,s.appendChild(r),s}const e=document.createElement("span");return e.classList.add(n.char),e.textContent=t,this.opts.dataAttributes&&e.setAttribute("data-char",t),this.opts.cssVariables&&e.style.setProperty(c,String(this.charIndex)),this.charIndex+=1,e}createSpaceSpan(){const t=document.createElement("span");return t.classList.add(n.whitespace),t.textContent=a,t}applyIOSContainerSizeFix(){if(!this.el)return;this.el.style.minHeight="",this.el.offsetHeight;const t=this.el.getBoundingClientRect(),e=Math.ceil(t.height);e>0&&(this.el.style.minHeight=`${e}px`)}};

package/dist/index.d.ts

@@ -5,7 +5,8 @@ export interface TextSlicerOptions {
     cssVariables?: boolean;
     dataAttributes?: boolean;
     keepWhitespaceNodes?: boolean;
-    freezeWordWidths?: boolean;
+    iosSafariTransformFix?: boolean;
+    extraCharWrapper?: boolean;
 }
 export interface TextSlicerMetrics {
     wordTotal: number;
@@ -18,6 +19,7 @@ export interface TextSlicerCallbacks {
 export declare const CLASSNAMES: Readonly<{
     word: "ts-word";
     char: "ts-char";
+    charWrap: "ts-char-wrap";
     whitespace: "ts-whitespace";
 }>;
 export declare class TextSlicer {
@@ -27,10 +29,6 @@ export declare class TextSlicer {
     private callbacks;
     private charIndex;
     private mounted;
-    private ro;
-    private frozen;
-    private freezeScheduled;
-    private freezeWordWidthsBound;
     constructor(options?: TextSlicerOptions, callbacks?: TextSlicerCallbacks);
     get metrics(): TextSlicerMetrics;
     init(): void;
@@ -42,14 +40,7 @@ export declare class TextSlicer {
     private appendWords;
     private appendChars;
     private createWordSpan;
-    private createCharSpan;
+    private createCharNode;
     private createSpaceSpan;
-    private scheduleFreezeNow;
-    private scheduleFreezeWordWidths;
-    private measureWordWidths;
-    private applyWordWidths;
-    private freezeWordWidths;
-    private unfreezeWordWidths;
-    private attachResizeObserver;
-    private detachResizeObserver;
+    private applyIOSContainerSizeFix;
 }

package/dist/index.es.js

@@ -1,155 +1,110 @@
-const u = { splitMode: "both", cssVariables: !1, dataAttributes: !1, keepWhitespaceNodes: !0, freezeWordWidths: !1 }, o = Object.freeze({ word: "ts-word", char: "ts-char", whitespace: "ts-whitespace" }), h = " ", f = (r) => typeof window > "u" || typeof document > "u" ? null : r ? typeof r == "string" ? document.querySelector(r) : r : null, d = (r) => {
-  const e = Intl.Segmenter;
-  if (typeof e == "function") {
-    const t = new e("en", { granularity: "grapheme" });
-    return Array.from(t.segment(r), (s) => s.segment);
-  }
-  return Array.from(r);
-}, c = (r) => r.split(h), a = (r) => {
-  const e = {};
-  return Object.keys(r).forEach((t) => {
-    const s = r[t];
-    s !== void 0 && (e[t] = s);
-  }), e;
+const g = { splitMode: "both", cssVariables: !1, dataAttributes: !1, keepWhitespaceNodes: !0, iosSafariTransformFix: !1, extraCharWrapper: !1 }, a = Object.freeze({ word: "ts-word", char: "ts-char", charWrap: "ts-char-wrap", whitespace: "ts-whitespace" }), o = " ", p = "--char-index", d = () => typeof window < "u" && typeof document < "u", l = (n) => {
+  const t = Intl.Segmenter;
+  if (typeof t == "function") {
+    const e = new t("en", { granularity: "grapheme" });
+    return Array.from(e.segment(n), (s) => s.segment);
+  }
+  return Array.from(n);
+}, u = (n) => n.split(o), c = (n) => {
+  const t = {};
+  return Object.keys(n).forEach((e) => {
+    const s = n[e];
+    s !== void 0 && (t[e] = s);
+  }), t;
 };
-class W {
+class f {
   el;
   original;
   opts;
   callbacks;
   charIndex;
   mounted;
-  ro = null;
-  frozen = !1;
-  freezeScheduled = !1;
-  freezeWordWidthsBound = () => {
-    this.scheduleFreezeNow();
-  };
-  constructor(e = {}, t) {
-    const s = f(e.container);
-    this.el = s, this.original = ((i) => !!i && typeof HTMLElement < "u" && i instanceof HTMLElement)(s) ? s.textContent?.toString() ?? "" : "", this.opts = { ...u, ...a(e) }, this.callbacks = t, this.charIndex = 0, this.mounted = !1;
+  constructor(t = {}, e) {
+    const s = (r = t.container, d() && r ? typeof r == "string" ? document.querySelector(r) : r : null);
+    var r;
+    this.el = s, this.original = ((i) => !!i && typeof HTMLElement < "u" && i instanceof HTMLElement)(s) ? s.textContent?.toString() ?? "" : "", this.opts = { ...g, ...c(t) }, this.callbacks = e, this.charIndex = 0, this.mounted = !1;
   }
   get metrics() {
-    const e = this.original;
-    return { wordTotal: e.length ? c(e).length : 0, charTotal: e.length, renderedAt: Date.now() };
+    const t = this.original;
+    return { wordTotal: t.length ? u(t).length : 0, charTotal: t.length, renderedAt: Date.now() };
   }
   init() {
     this.el && (this.mounted = !0, this.split());
   }
-  reinit(e, t) {
-    this.el && (typeof e == "string" && (this.original = e), t && (this.opts = { ...this.opts, ...a(t) }), this.split());
+  reinit(t, e) {
+    this.el && (typeof t == "string" && (this.original = t), e && (this.opts = { ...this.opts, ...c(e) }), this.split());
   }
   clear() {
-    this.el && (this.unfreezeWordWidths(), this.el.replaceChildren());
+    this.el && (this.el.style.minHeight = "", this.el.replaceChildren());
   }
   split() {
     if (!this.el) return;
     this.clear(), this.charIndex = 0;
-    const e = this.original, t = document.createDocumentFragment(), s = c(e);
-    this.opts.splitMode === "chars" ? this.appendChars(t, e) : this.appendWords(t, s), this.el.appendChild(t), this.opts.cssVariables && (this.el.style.setProperty("--word-total", String(s.length)), this.el.style.setProperty("--char-total", String(e.length))), this.scheduleFreezeWordWidths().then(() => {
-      this.callbacks?.onAfterRender?.(this.metrics);
-    }).catch(() => {
-    });
+    const t = this.original, e = document.createDocumentFragment(), s = u(t);
+    this.opts.splitMode === "chars" ? this.appendChars(e, t) : this.appendWords(e, s), this.el.appendChild(e), this.opts.cssVariables && (this.el.style.setProperty("--word-total", String(s.length)), this.el.style.setProperty("--char-total", String(t.length))), this.opts.iosSafariTransformFix && (() => {
+      if (!d()) return !1;
+      const r = navigator.userAgent || "", i = /iP(hone|ad|od)/.test(r), h = /WebKit/.test(r) && !/Chrome|CriOS|FxiOS|EdgiOS/.test(r);
+      return i && h;
+    })() && this.applyIOSContainerSizeFix(), this.callbacks?.onAfterRender?.(this.metrics);
   }
   destroy() {
-    this.el && (this.detachResizeObserver(), this.clear(), this.mounted = !1);
+    this.el && (this.clear(), this.mounted = !1);
   }
-  updateOptions(e) {
-    this.opts = { ...this.opts, ...a(e) }, this.mounted && this.split();
+  updateOptions(t) {
+    this.opts = { ...this.opts, ...c(t) }, this.mounted && this.split();
   }
-  appendWords(e, t) {
-    t.forEach((s, i) => {
+  appendWords(t, e) {
+    e.forEach((s, r) => {
       if (this.opts.splitMode === "both") {
-        const n = this.createWordSpan(i, s);
-        for (const l of d(s)) {
-          const p = this.createCharSpan(l);
-          n.append(p);
+        const i = this.createWordSpan(r, s);
+        for (const h of l(s)) {
+          const m = this.createCharNode(h);
+          i.append(m);
         }
-        e.append(n);
+        t.append(i);
       } else {
-        const n = this.createWordSpan(i);
-        n.append(document.createTextNode(s)), e.append(n);
+        const i = this.createWordSpan(r);
+        i.append(document.createTextNode(s)), t.append(i);
       }
-      i < t.length - 1 && e.append(this.createSpaceSpan());
+      r < e.length - 1 && t.append(this.createSpaceSpan());
     });
   }
-  appendChars(e, t) {
-    for (const s of d(t)) {
-      const i = this.createCharSpan(s);
-      e.append(i);
+  appendChars(t, e) {
+    for (const s of l(e)) {
+      const r = this.createCharNode(s);
+      t.append(r);
     }
   }
-  createWordSpan(e, t = "") {
+  createWordSpan(t, e = "") {
     const s = document.createElement("span");
-    return s.classList.add(o.word), this.opts.dataAttributes && t && s.setAttribute("data-word", t), this.opts.cssVariables && s.style.setProperty("--word-index", String(e)), s;
-  }
-  createCharSpan(e) {
-    const t = document.createElement("span");
-    return t.textContent = e, this.opts.dataAttributes && t.setAttribute("data-char", e), e === h ? (t.classList.add(o.whitespace), this.opts.keepWhitespaceNodes || (t.textContent = h)) : (t.classList.add(o.char), this.opts.cssVariables && t.style.setProperty("--char-index", String(this.charIndex)), this.charIndex += 1), t;
+    return s.classList.add(a.word), this.opts.dataAttributes && e && s.setAttribute("data-word", e), this.opts.cssVariables && s.style.setProperty("--word-index", String(t)), s;
   }
-  createSpaceSpan() {
-    const e = document.createElement("span");
-    return e.classList.add(o.whitespace), e.textContent = h, e;
-  }
-  scheduleFreezeNow() {
-    this.el && this.opts.freezeWordWidths && (this.freezeScheduled || (this.freezeScheduled = !0, requestAnimationFrame(() => {
-      this.freezeScheduled = !1, this.freezeWordWidths();
-    })));
-  }
-  async scheduleFreezeWordWidths() {
-    if (this.el && this.opts.freezeWordWidths) {
-      try {
-        await document.fonts?.ready;
-      } catch {
-      }
-      await new Promise((e) => requestAnimationFrame(() => e())), this.scheduleFreezeNow(), this.attachResizeObserver();
+  createCharNode(t) {
+    if (t === o) {
+      const s = document.createElement("span");
+      return s.classList.add(a.whitespace), s.textContent = o, s;
     }
+    if (this.opts.extraCharWrapper) {
+      const s = document.createElement("span");
+      s.classList.add(a.charWrap);
+      const r = document.createElement("span");
+      return r.classList.add(a.char), r.textContent = t, this.opts.dataAttributes && r.setAttribute("data-char", t), this.opts.cssVariables && r.style.setProperty(p, String(this.charIndex)), this.charIndex += 1, s.appendChild(r), s;
+    }
+    const e = document.createElement("span");
+    return e.classList.add(a.char), e.textContent = t, this.opts.dataAttributes && e.setAttribute("data-char", t), this.opts.cssVariables && e.style.setProperty(p, String(this.charIndex)), this.charIndex += 1, e;
   }
-  measureWordWidths() {
-    if (!this.el) return [];
-    const e = this.el.querySelectorAll(`.${o.word}`);
-    return Array.from(e, (t) => {
-      t.style.width = "", t.style.flex = "";
-      const { width: s } = t.getBoundingClientRect();
-      return Math.ceil(s);
-    });
-  }
-  applyWordWidths(e) {
-    this.el && this.el.querySelectorAll(`.${o.word}`).forEach((t, s) => {
-      const i = e[s] ?? 0;
-      t.style.width = `${i}px`, t.style.flex = "0 0 auto";
-    });
+  createSpaceSpan() {
+    const t = document.createElement("span");
+    return t.classList.add(a.whitespace), t.textContent = o, t;
   }
-  freezeWordWidths() {
+  applyIOSContainerSizeFix() {
     if (!this.el) return;
-    const e = this.measureWordWidths();
-    this.applyWordWidths(e), this.frozen = !0;
-  }
-  unfreezeWordWidths() {
-    !this.el || !this.frozen || (this.el.querySelectorAll(`.${o.word}`).forEach((e) => {
-      e.style.width = "", e.style.flex = "";
-    }), this.frozen = !1);
-  }
-  attachResizeObserver() {
-    if (this.el && this.opts.freezeWordWidths) {
-      if (!this.ro) {
-        this.ro = new ResizeObserver(() => {
-          this.scheduleFreezeNow();
-        });
-        try {
-          this.ro.observe(this.el, { box: "border-box" });
-        } catch {
-          this.ro.observe(this.el);
-        }
-      }
-      window.addEventListener("resize", this.freezeWordWidthsBound, { passive: !0 });
-    }
-  }
-  detachResizeObserver() {
-    this.ro && (this.ro.disconnect(), this.ro = null), window.removeEventListener("resize", this.freezeWordWidthsBound);
+    this.el.style.minHeight = "", this.el.offsetHeight;
+    const t = this.el.getBoundingClientRect(), e = Math.ceil(t.height);
+    e > 0 && (this.el.style.minHeight = `${e}px`);
   }
 }
 export {
-  o as CLASSNAMES,
-  W as TextSlicer
+  a as CLASSNAMES,
+  f as TextSlicer
 };

package/dist/index.umd.js

@@ -1 +1 @@
-(function(o,n){typeof exports=="object"&&typeof module<"u"?n(exports):typeof define=="function"&&define.amd?define(["exports"],n):n((o=typeof globalThis<"u"?globalThis:o||self).TextSlicer={})})(this,function(o){"use strict";const n={splitMode:"both",cssVariables:!1,dataAttributes:!1,keepWhitespaceNodes:!0,freezeWordWidths:!1},i=Object.freeze({word:"ts-word",char:"ts-char",whitespace:"ts-whitespace"}),d=" ",p=e=>typeof window>"u"||typeof document>"u"?null:e?typeof e=="string"?document.querySelector(e):e:null,c=e=>{const t=Intl.Segmenter;if(typeof t=="function"){const s=new t("en",{granularity:"grapheme"});return Array.from(s.segment(e),r=>r.segment)}return Array.from(e)},l=e=>e.split(d),a=e=>{const t={};return Object.keys(e).forEach(s=>{const r=e[s];r!==void 0&&(t[s]=r)}),t};o.CLASSNAMES=i,o.TextSlicer=class{el;original;opts;callbacks;charIndex;mounted;ro=null;frozen=!1;freezeScheduled=!1;freezeWordWidthsBound=()=>{this.scheduleFreezeNow()};constructor(e={},t){const s=p(e.container);this.el=s,this.original=(r=>!!r&&typeof HTMLElement<"u"&&r instanceof HTMLElement)(s)?s.textContent?.toString()??"":"",this.opts={...n,...a(e)},this.callbacks=t,this.charIndex=0,this.mounted=!1}get metrics(){const e=this.original;return{wordTotal:e.length?l(e).length:0,charTotal:e.length,renderedAt:Date.now()}}init(){this.el&&(this.mounted=!0,this.split())}reinit(e,t){this.el&&(typeof e=="string"&&(this.original=e),t&&(this.opts={...this.opts,...a(t)}),this.split())}clear(){this.el&&(this.unfreezeWordWidths(),this.el.replaceChildren())}split(){if(!this.el)return;this.clear(),this.charIndex=0;const e=this.original,t=document.createDocumentFragment(),s=l(e);this.opts.splitMode==="chars"?this.appendChars(t,e):this.appendWords(t,s),this.el.appendChild(t),this.opts.cssVariables&&(this.el.style.setProperty("--word-total",String(s.length)),this.el.style.setProperty("--char-total",String(e.length))),this.scheduleFreezeWordWidths().then(()=>{this.callbacks?.onAfterRender?.(this.metrics)}).catch(()=>{})}destroy(){this.el&&(this.detachResizeObserver(),this.clear(),this.mounted=!1)}updateOptions(e){this.opts={...this.opts,...a(e)},this.mounted&&this.split()}appendWords(e,t){t.forEach((s,r)=>{if(this.opts.splitMode==="both"){const h=this.createWordSpan(r,s);for(const u of c(s)){const f=this.createCharSpan(u);h.append(f)}e.append(h)}else{const h=this.createWordSpan(r);h.append(document.createTextNode(s)),e.append(h)}r<t.length-1&&e.append(this.createSpaceSpan())})}appendChars(e,t){for(const s of c(t)){const r=this.createCharSpan(s);e.append(r)}}createWordSpan(e,t=""){const s=document.createElement("span");return s.classList.add(i.word),this.opts.dataAttributes&&t&&s.setAttribute("data-word",t),this.opts.cssVariables&&s.style.setProperty("--word-index",String(e)),s}createCharSpan(e){const t=document.createElement("span");return t.textContent=e,this.opts.dataAttributes&&t.setAttribute("data-char",e),e===d?(t.classList.add(i.whitespace),this.opts.keepWhitespaceNodes||(t.textContent=d)):(t.classList.add(i.char),this.opts.cssVariables&&t.style.setProperty("--char-index",String(this.charIndex)),this.charIndex+=1),t}createSpaceSpan(){const e=document.createElement("span");return e.classList.add(i.whitespace),e.textContent=d,e}scheduleFreezeNow(){this.el&&this.opts.freezeWordWidths&&(this.freezeScheduled||(this.freezeScheduled=!0,requestAnimationFrame(()=>{this.freezeScheduled=!1,this.freezeWordWidths()})))}async scheduleFreezeWordWidths(){if(this.el&&this.opts.freezeWordWidths){try{await document.fonts?.ready}catch{}await new Promise(e=>requestAnimationFrame(()=>e())),this.scheduleFreezeNow(),this.attachResizeObserver()}}measureWordWidths(){if(!this.el)return[];const e=this.el.querySelectorAll(`.${i.word}`);return Array.from(e,t=>{t.style.width="",t.style.flex="";const{width:s}=t.getBoundingClientRect();return Math.ceil(s)})}applyWordWidths(e){this.el&&this.el.querySelectorAll(`.${i.word}`).forEach((t,s)=>{const r=e[s]??0;t.style.width=`${r}px`,t.style.flex="0 0 auto"})}freezeWordWidths(){if(!this.el)return;const e=this.measureWordWidths();this.applyWordWidths(e),this.frozen=!0}unfreezeWordWidths(){!this.el||!this.frozen||(this.el.querySelectorAll(`.${i.word}`).forEach(e=>{e.style.width="",e.style.flex=""}),this.frozen=!1)}attachResizeObserver(){if(this.el&&this.opts.freezeWordWidths){if(!this.ro){this.ro=new ResizeObserver(()=>{this.scheduleFreezeNow()});try{this.ro.observe(this.el,{box:"border-box"})}catch{this.ro.observe(this.el)}}window.addEventListener("resize",this.freezeWordWidthsBound,{passive:!0})}}detachResizeObserver(){this.ro&&(this.ro.disconnect(),this.ro=null),window.removeEventListener("resize",this.freezeWordWidthsBound)}},Object.defineProperty(o,Symbol.toStringTag,{value:"Module"})});
+(function(a,o){typeof exports=="object"&&typeof module<"u"?o(exports):typeof define=="function"&&define.amd?define(["exports"],o):o((a=typeof globalThis<"u"?globalThis:a||self).TextSlicer={})})(this,function(a){"use strict";const o={splitMode:"both",cssVariables:!1,dataAttributes:!1,keepWhitespaceNodes:!0,iosSafariTransformFix:!1,extraCharWrapper:!1},r=Object.freeze({word:"ts-word",char:"ts-char",charWrap:"ts-char-wrap",whitespace:"ts-whitespace"}),c=" ",p="--char-index",l=()=>typeof window<"u"&&typeof document<"u",u=t=>{const e=Intl.Segmenter;if(typeof e=="function"){const s=new e("en",{granularity:"grapheme"});return Array.from(s.segment(t),i=>i.segment)}return Array.from(t)},f=t=>t.split(c),h=t=>{const e={};return Object.keys(t).forEach(s=>{const i=t[s];i!==void 0&&(e[s]=i)}),e};a.CLASSNAMES=r,a.TextSlicer=class{el;original;opts;callbacks;charIndex;mounted;constructor(t={},e){const s=(i=t.container,l()&&i?typeof i=="string"?document.querySelector(i):i:null);var i;this.el=s,this.original=(n=>!!n&&typeof HTMLElement<"u"&&n instanceof HTMLElement)(s)?s.textContent?.toString()??"":"",this.opts={...o,...h(t)},this.callbacks=e,this.charIndex=0,this.mounted=!1}get metrics(){const t=this.original;return{wordTotal:t.length?f(t).length:0,charTotal:t.length,renderedAt:Date.now()}}init(){this.el&&(this.mounted=!0,this.split())}reinit(t,e){this.el&&(typeof t=="string"&&(this.original=t),e&&(this.opts={...this.opts,...h(e)}),this.split())}clear(){this.el&&(this.el.style.minHeight="",this.el.replaceChildren())}split(){if(!this.el)return;this.clear(),this.charIndex=0;const t=this.original,e=document.createDocumentFragment(),s=f(t);this.opts.splitMode==="chars"?this.appendChars(e,t):this.appendWords(e,s),this.el.appendChild(e),this.opts.cssVariables&&(this.el.style.setProperty("--word-total",String(s.length)),this.el.style.setProperty("--char-total",String(t.length))),this.opts.iosSafariTransformFix&&(()=>{if(!l())return!1;const i=navigator.userAgent||"",n=/iP(hone|ad|od)/.test(i),d=/WebKit/.test(i)&&!/Chrome|CriOS|FxiOS|EdgiOS/.test(i);return n&&d})()&&this.applyIOSContainerSizeFix(),this.callbacks?.onAfterRender?.(this.metrics)}destroy(){this.el&&(this.clear(),this.mounted=!1)}updateOptions(t){this.opts={...this.opts,...h(t)},this.mounted&&this.split()}appendWords(t,e){e.forEach((s,i)=>{if(this.opts.splitMode==="both"){const n=this.createWordSpan(i,s);for(const d of u(s)){const m=this.createCharNode(d);n.append(m)}t.append(n)}else{const n=this.createWordSpan(i);n.append(document.createTextNode(s)),t.append(n)}i<e.length-1&&t.append(this.createSpaceSpan())})}appendChars(t,e){for(const s of u(e)){const i=this.createCharNode(s);t.append(i)}}createWordSpan(t,e=""){const s=document.createElement("span");return s.classList.add(r.word),this.opts.dataAttributes&&e&&s.setAttribute("data-word",e),this.opts.cssVariables&&s.style.setProperty("--word-index",String(t)),s}createCharNode(t){if(t===c){const s=document.createElement("span");return s.classList.add(r.whitespace),s.textContent=c,s}if(this.opts.extraCharWrapper){const s=document.createElement("span");s.classList.add(r.charWrap);const i=document.createElement("span");return i.classList.add(r.char),i.textContent=t,this.opts.dataAttributes&&i.setAttribute("data-char",t),this.opts.cssVariables&&i.style.setProperty(p,String(this.charIndex)),this.charIndex+=1,s.appendChild(i),s}const e=document.createElement("span");return e.classList.add(r.char),e.textContent=t,this.opts.dataAttributes&&e.setAttribute("data-char",t),this.opts.cssVariables&&e.style.setProperty(p,String(this.charIndex)),this.charIndex+=1,e}createSpaceSpan(){const t=document.createElement("span");return t.classList.add(r.whitespace),t.textContent=c,t}applyIOSContainerSizeFix(){if(!this.el)return;this.el.style.minHeight="",this.el.offsetHeight;const t=this.el.getBoundingClientRect(),e=Math.ceil(t.height);e>0&&(this.el.style.minHeight=`${e}px`)}},Object.defineProperty(a,Symbol.toStringTag,{value:"Module"})});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "text-slicer",
-  "version": "1.4.1",
+  "version": "1.5.0-dev.0",
   "description": "TextSlicer is designed to split text within an HTML element into separate words and/or characters, wrapping each word and/or character in separate span elements.",
   "author": "ux-ui.pro",
   "license": "MIT",