text-slicer 1.4.0 → 1.5.0-dev.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.cjs.js CHANGED
@@ -1 +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"}),o=" ",u=t=>typeof window>"u"||typeof document>"u"?null:t?typeof t=="string"?document.querySelector(t):t:null,a=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)},d=t=>t.split(o),h=t=>{const e={};return Object.keys(t).forEach(s=>{const r=t[s];r!==void 0&&(e[s]=r)}),e};exports.CLASSNAMES=i,exports.TextSlicer=class{el;original;opts;callbacks;charIndex;mounted;ro=null;frozen=!1;freezeWordWidthsBound=()=>{this.freezeWordWidths()};constructor(t={},e){const s=u(t.container);this.el=s,this.original=(r=>!!r&&typeof HTMLElement<"u"&&r instanceof HTMLElement)(s)?s.textContent?.toString()??"":"",this.opts={...p,...h(t)},this.callbacks=e,this.charIndex=0,this.mounted=!1}get metrics(){const t=this.original;return{wordTotal:t.length?d(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.unfreezeWordWidths(),this.el.replaceChildren())}split(){if(!this.el)return;this.clear(),this.charIndex=0;const t=this.original,e=document.createDocumentFragment(),s=d(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.scheduleFreezeWordWidths().then(()=>{this.callbacks?.onAfterRender?.(this.metrics)}).catch(()=>{})}destroy(){this.el&&(this.detachResizeObserver(),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 n=this.createWordSpan(r,s);for(const c of a(s)){const l=this.createCharSpan(c);n.append(l)}t.append(n)}else{const n=this.createWordSpan(r);n.append(document.createTextNode(s)),t.append(n)}r<e.length-1&&t.append(this.createSpaceSpan())})}appendChars(t,e){for(const s of a(e)){const r=this.createCharSpan(s);t.append(r)}}createWordSpan(t,e=""){const s=document.createElement("span");return s.classList.add(i.word),this.opts.dataAttributes&&e&&s.setAttribute("data-word",e),this.opts.cssVariables&&s.style.setProperty("--word-index",String(t)),s}createCharSpan(t){const e=document.createElement("span");return e.textContent=t,this.opts.dataAttributes&&e.setAttribute("data-char",t),t===o?(e.classList.add(i.whitespace),this.opts.keepWhitespaceNodes||(e.textContent=o)):(e.classList.add(i.char),this.opts.cssVariables&&e.style.setProperty("--char-index",String(this.charIndex)),this.charIndex+=1),e}createSpaceSpan(){const t=document.createElement("span");return t.classList.add(i.whitespace),t.textContent=o,t}async scheduleFreezeWordWidths(){if(this.el&&this.opts.freezeWordWidths){try{await document.fonts?.ready}catch{}await new Promise(t=>requestAnimationFrame(()=>t())),this.freezeWordWidths(),this.attachResizeObserver()}}freezeWordWidths(){this.el&&(this.el.querySelectorAll(`.${i.word}`).forEach(t=>{t.style.width="",t.style.flex="";const{width:e}=t.getBoundingClientRect();t.style.width=`${Math.ceil(e)}px`,t.style.flex="0 0 auto"}),this.frozen=!0)}unfreezeWordWidths(){!this.el||!this.frozen||(this.el.querySelectorAll(`.${i.word}`).forEach(t=>{t.style.width="",t.style.flex=""}),this.frozen=!1)}attachResizeObserver(){this.el&&this.opts.freezeWordWidths&&(this.ro||(this.ro=new ResizeObserver(()=>{this.freezeWordWidths()}),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)}};
1
+ "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 CHANGED
@@ -5,7 +5,8 @@ export interface TextSlicerOptions {
5
5
  cssVariables?: boolean;
6
6
  dataAttributes?: boolean;
7
7
  keepWhitespaceNodes?: boolean;
8
- freezeWordWidths?: boolean;
8
+ iosSafariTransformFix?: boolean;
9
+ extraCharWrapper?: boolean;
9
10
  }
10
11
  export interface TextSlicerMetrics {
11
12
  wordTotal: number;
@@ -18,6 +19,7 @@ export interface TextSlicerCallbacks {
18
19
  export declare const CLASSNAMES: Readonly<{
19
20
  word: "ts-word";
20
21
  char: "ts-char";
22
+ charWrap: "ts-char-wrap";
21
23
  whitespace: "ts-whitespace";
22
24
  }>;
23
25
  export declare class TextSlicer {
@@ -27,9 +29,6 @@ export declare class TextSlicer {
27
29
  private callbacks;
28
30
  private charIndex;
29
31
  private mounted;
30
- private ro;
31
- private frozen;
32
- private freezeWordWidthsBound;
33
32
  constructor(options?: TextSlicerOptions, callbacks?: TextSlicerCallbacks);
34
33
  get metrics(): TextSlicerMetrics;
35
34
  init(): void;
@@ -41,11 +40,7 @@ export declare class TextSlicer {
41
40
  private appendWords;
42
41
  private appendChars;
43
42
  private createWordSpan;
44
- private createCharSpan;
43
+ private createCharNode;
45
44
  private createSpaceSpan;
46
- private scheduleFreezeWordWidths;
47
- private freezeWordWidths;
48
- private unfreezeWordWidths;
49
- private attachResizeObserver;
50
- private detachResizeObserver;
45
+ private applyIOSContainerSizeFix;
51
46
  }
package/dist/index.es.js CHANGED
@@ -1,126 +1,110 @@
1
- const u = { splitMode: "both", cssVariables: !1, dataAttributes: !1, keepWhitespaceNodes: !0, freezeWordWidths: !1 }, n = 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) => {
1
+ 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) => {
2
2
  const t = Intl.Segmenter;
3
3
  if (typeof t == "function") {
4
4
  const e = new t("en", { granularity: "grapheme" });
5
- return Array.from(e.segment(r), (s) => s.segment);
5
+ return Array.from(e.segment(n), (s) => s.segment);
6
6
  }
7
- return Array.from(r);
8
- }, c = (r) => r.split(h), a = (r) => {
7
+ return Array.from(n);
8
+ }, u = (n) => n.split(o), c = (n) => {
9
9
  const t = {};
10
- return Object.keys(r).forEach((e) => {
11
- const s = r[e];
10
+ return Object.keys(n).forEach((e) => {
11
+ const s = n[e];
12
12
  s !== void 0 && (t[e] = s);
13
13
  }), t;
14
14
  };
15
- class W {
15
+ class f {
16
16
  el;
17
17
  original;
18
18
  opts;
19
19
  callbacks;
20
20
  charIndex;
21
21
  mounted;
22
- ro = null;
23
- frozen = !1;
24
- freezeWordWidthsBound = () => {
25
- this.freezeWordWidths();
26
- };
27
22
  constructor(t = {}, e) {
28
- const s = f(t.container);
29
- this.el = s, this.original = ((i) => !!i && typeof HTMLElement < "u" && i instanceof HTMLElement)(s) ? s.textContent?.toString() ?? "" : "", this.opts = { ...u, ...a(t) }, this.callbacks = e, this.charIndex = 0, this.mounted = !1;
23
+ const s = (r = t.container, d() && r ? typeof r == "string" ? document.querySelector(r) : r : null);
24
+ var r;
25
+ 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;
30
26
  }
31
27
  get metrics() {
32
28
  const t = this.original;
33
- return { wordTotal: t.length ? c(t).length : 0, charTotal: t.length, renderedAt: Date.now() };
29
+ return { wordTotal: t.length ? u(t).length : 0, charTotal: t.length, renderedAt: Date.now() };
34
30
  }
35
31
  init() {
36
32
  this.el && (this.mounted = !0, this.split());
37
33
  }
38
34
  reinit(t, e) {
39
- this.el && (typeof t == "string" && (this.original = t), e && (this.opts = { ...this.opts, ...a(e) }), this.split());
35
+ this.el && (typeof t == "string" && (this.original = t), e && (this.opts = { ...this.opts, ...c(e) }), this.split());
40
36
  }
41
37
  clear() {
42
- this.el && (this.unfreezeWordWidths(), this.el.replaceChildren());
38
+ this.el && (this.el.style.minHeight = "", this.el.replaceChildren());
43
39
  }
44
40
  split() {
45
41
  if (!this.el) return;
46
42
  this.clear(), this.charIndex = 0;
47
- const t = this.original, e = document.createDocumentFragment(), s = c(t);
48
- 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.scheduleFreezeWordWidths().then(() => {
49
- this.callbacks?.onAfterRender?.(this.metrics);
50
- }).catch(() => {
51
- });
43
+ const t = this.original, e = document.createDocumentFragment(), s = u(t);
44
+ 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 && (() => {
45
+ if (!d()) return !1;
46
+ const r = navigator.userAgent || "", i = /iP(hone|ad|od)/.test(r), h = /WebKit/.test(r) && !/Chrome|CriOS|FxiOS|EdgiOS/.test(r);
47
+ return i && h;
48
+ })() && this.applyIOSContainerSizeFix(), this.callbacks?.onAfterRender?.(this.metrics);
52
49
  }
53
50
  destroy() {
54
- this.el && (this.detachResizeObserver(), this.clear(), this.mounted = !1);
51
+ this.el && (this.clear(), this.mounted = !1);
55
52
  }
56
53
  updateOptions(t) {
57
- this.opts = { ...this.opts, ...a(t) }, this.mounted && this.split();
54
+ this.opts = { ...this.opts, ...c(t) }, this.mounted && this.split();
58
55
  }
59
56
  appendWords(t, e) {
60
- e.forEach((s, i) => {
57
+ e.forEach((s, r) => {
61
58
  if (this.opts.splitMode === "both") {
62
- const o = this.createWordSpan(i, s);
63
- for (const l of d(s)) {
64
- const p = this.createCharSpan(l);
65
- o.append(p);
59
+ const i = this.createWordSpan(r, s);
60
+ for (const h of l(s)) {
61
+ const m = this.createCharNode(h);
62
+ i.append(m);
66
63
  }
67
- t.append(o);
64
+ t.append(i);
68
65
  } else {
69
- const o = this.createWordSpan(i);
70
- o.append(document.createTextNode(s)), t.append(o);
66
+ const i = this.createWordSpan(r);
67
+ i.append(document.createTextNode(s)), t.append(i);
71
68
  }
72
- i < e.length - 1 && t.append(this.createSpaceSpan());
69
+ r < e.length - 1 && t.append(this.createSpaceSpan());
73
70
  });
74
71
  }
75
72
  appendChars(t, e) {
76
- for (const s of d(e)) {
77
- const i = this.createCharSpan(s);
78
- t.append(i);
73
+ for (const s of l(e)) {
74
+ const r = this.createCharNode(s);
75
+ t.append(r);
79
76
  }
80
77
  }
81
78
  createWordSpan(t, e = "") {
82
79
  const s = document.createElement("span");
83
- 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;
80
+ 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;
84
81
  }
85
- createCharSpan(t) {
82
+ createCharNode(t) {
83
+ if (t === o) {
84
+ const s = document.createElement("span");
85
+ return s.classList.add(a.whitespace), s.textContent = o, s;
86
+ }
87
+ if (this.opts.extraCharWrapper) {
88
+ const s = document.createElement("span");
89
+ s.classList.add(a.charWrap);
90
+ const r = document.createElement("span");
91
+ 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;
92
+ }
86
93
  const e = document.createElement("span");
87
- return e.textContent = t, this.opts.dataAttributes && e.setAttribute("data-char", t), t === h ? (e.classList.add(n.whitespace), this.opts.keepWhitespaceNodes || (e.textContent = h)) : (e.classList.add(n.char), this.opts.cssVariables && e.style.setProperty("--char-index", String(this.charIndex)), this.charIndex += 1), e;
94
+ 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;
88
95
  }
89
96
  createSpaceSpan() {
90
97
  const t = document.createElement("span");
91
- return t.classList.add(n.whitespace), t.textContent = h, t;
92
- }
93
- async scheduleFreezeWordWidths() {
94
- if (this.el && this.opts.freezeWordWidths) {
95
- try {
96
- await document.fonts?.ready;
97
- } catch {
98
- }
99
- await new Promise((t) => requestAnimationFrame(() => t())), this.freezeWordWidths(), this.attachResizeObserver();
100
- }
101
- }
102
- freezeWordWidths() {
103
- this.el && (this.el.querySelectorAll(`.${n.word}`).forEach((t) => {
104
- t.style.width = "", t.style.flex = "";
105
- const { width: e } = t.getBoundingClientRect();
106
- t.style.width = `${Math.ceil(e)}px`, t.style.flex = "0 0 auto";
107
- }), this.frozen = !0);
108
- }
109
- unfreezeWordWidths() {
110
- !this.el || !this.frozen || (this.el.querySelectorAll(`.${n.word}`).forEach((t) => {
111
- t.style.width = "", t.style.flex = "";
112
- }), this.frozen = !1);
98
+ return t.classList.add(a.whitespace), t.textContent = o, t;
113
99
  }
114
- attachResizeObserver() {
115
- this.el && this.opts.freezeWordWidths && (this.ro || (this.ro = new ResizeObserver(() => {
116
- this.freezeWordWidths();
117
- }), this.ro.observe(this.el)), window.addEventListener("resize", this.freezeWordWidthsBound, { passive: !0 }));
118
- }
119
- detachResizeObserver() {
120
- this.ro && (this.ro.disconnect(), this.ro = null), window.removeEventListener("resize", this.freezeWordWidthsBound);
100
+ applyIOSContainerSizeFix() {
101
+ if (!this.el) return;
102
+ this.el.style.minHeight = "", this.el.offsetHeight;
103
+ const t = this.el.getBoundingClientRect(), e = Math.ceil(t.height);
104
+ e > 0 && (this.el.style.minHeight = `${e}px`);
121
105
  }
122
106
  }
123
107
  export {
124
- n as CLASSNAMES,
125
- W as TextSlicer
108
+ a as CLASSNAMES,
109
+ f as TextSlicer
126
110
  };
package/dist/index.umd.js CHANGED
@@ -1 +1 @@
1
- (function(n,o){typeof exports=="object"&&typeof module<"u"?o(exports):typeof define=="function"&&define.amd?define(["exports"],o):o((n=typeof globalThis<"u"?globalThis:n||self).TextSlicer={})})(this,function(n){"use strict";const o={splitMode:"both",cssVariables:!1,dataAttributes:!1,keepWhitespaceNodes:!0,freezeWordWidths:!1},i=Object.freeze({word:"ts-word",char:"ts-char",whitespace:"ts-whitespace"}),a=" ",p=t=>typeof window>"u"||typeof document>"u"?null:t?typeof t=="string"?document.querySelector(t):t:null,c=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),d=t=>{const e={};return Object.keys(t).forEach(s=>{const r=t[s];r!==void 0&&(e[s]=r)}),e};n.CLASSNAMES=i,n.TextSlicer=class{el;original;opts;callbacks;charIndex;mounted;ro=null;frozen=!1;freezeWordWidthsBound=()=>{this.freezeWordWidths()};constructor(t={},e){const s=p(t.container);this.el=s,this.original=(r=>!!r&&typeof HTMLElement<"u"&&r instanceof HTMLElement)(s)?s.textContent?.toString()??"":"",this.opts={...o,...d(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,...d(e)}),this.split())}clear(){this.el&&(this.unfreezeWordWidths(),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.scheduleFreezeWordWidths().then(()=>{this.callbacks?.onAfterRender?.(this.metrics)}).catch(()=>{})}destroy(){this.el&&(this.detachResizeObserver(),this.clear(),this.mounted=!1)}updateOptions(t){this.opts={...this.opts,...d(t)},this.mounted&&this.split()}appendWords(t,e){e.forEach((s,r)=>{if(this.opts.splitMode==="both"){const h=this.createWordSpan(r,s);for(const f of c(s)){const u=this.createCharSpan(f);h.append(u)}t.append(h)}else{const h=this.createWordSpan(r);h.append(document.createTextNode(s)),t.append(h)}r<e.length-1&&t.append(this.createSpaceSpan())})}appendChars(t,e){for(const s of c(e)){const r=this.createCharSpan(s);t.append(r)}}createWordSpan(t,e=""){const s=document.createElement("span");return s.classList.add(i.word),this.opts.dataAttributes&&e&&s.setAttribute("data-word",e),this.opts.cssVariables&&s.style.setProperty("--word-index",String(t)),s}createCharSpan(t){const e=document.createElement("span");return e.textContent=t,this.opts.dataAttributes&&e.setAttribute("data-char",t),t===a?(e.classList.add(i.whitespace),this.opts.keepWhitespaceNodes||(e.textContent=a)):(e.classList.add(i.char),this.opts.cssVariables&&e.style.setProperty("--char-index",String(this.charIndex)),this.charIndex+=1),e}createSpaceSpan(){const t=document.createElement("span");return t.classList.add(i.whitespace),t.textContent=a,t}async scheduleFreezeWordWidths(){if(this.el&&this.opts.freezeWordWidths){try{await document.fonts?.ready}catch{}await new Promise(t=>requestAnimationFrame(()=>t())),this.freezeWordWidths(),this.attachResizeObserver()}}freezeWordWidths(){this.el&&(this.el.querySelectorAll(`.${i.word}`).forEach(t=>{t.style.width="",t.style.flex="";const{width:e}=t.getBoundingClientRect();t.style.width=`${Math.ceil(e)}px`,t.style.flex="0 0 auto"}),this.frozen=!0)}unfreezeWordWidths(){!this.el||!this.frozen||(this.el.querySelectorAll(`.${i.word}`).forEach(t=>{t.style.width="",t.style.flex=""}),this.frozen=!1)}attachResizeObserver(){this.el&&this.opts.freezeWordWidths&&(this.ro||(this.ro=new ResizeObserver(()=>{this.freezeWordWidths()}),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(n,Symbol.toStringTag,{value:"Module"})});
1
+ (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 CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "text-slicer",
3
- "version": "1.4.0",
3
+ "version": "1.5.0-dev.0",
4
4
  "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.",
5
5
  "author": "ux-ui.pro",
6
6
  "license": "MIT",