fetta 1.5.1 → 1.5.2

package/README.md

@@ -27,10 +27,10 @@ npm install fetta
 ```
 
 **Bundle size** (minified + brotli)
-- `fetta`: ~7.17 kB
-- `fetta/react`: ~8.66 kB
-- `fetta/motion`: ~15.93 kB
-- `fetta/helpers`: ~765 B
+- `fetta`: ~7.04 kB
+- `fetta/react`: ~8.21 kB
+- `fetta/motion`: ~13.68 kB
+- `fetta/helpers`: ~742 B
 
 ## Quick Start
 

package/dist/{chunk-UPF3IYHC.js → chunk-OUXSJF3P.js}

@@ -59,10 +59,9 @@ function isSafari() {
 }
 var kerningMeasureRoots = /* @__PURE__ */ new WeakMap();
 function getKerningMeasureRoot(doc) {
-  var _a;
   const existing = kerningMeasureRoots.get(doc);
   if (existing && existing.isConnected) return existing;
-  const host = (_a = doc.body) != null ? _a : doc.documentElement;
+  const host = doc.body ?? doc.documentElement;
   if (!host) return null;
   const root = doc.createElement("div");
   root.setAttribute("data-fetta-kerning-root", "true");
@@ -89,7 +88,7 @@ function measureKerningDOM(measureRoot, styleSource, chars, styles) {
     visibility: hidden;
     white-space: pre;
   `;
-  const computedStyles = styles != null ? styles : getComputedStyle(styleSource);
+  const computedStyles = styles ?? getComputedStyle(styleSource);
   copyKerningStyles(measurer, computedStyles);
   const webkitSmoothing = computedStyles.webkitFontSmoothing || computedStyles["-webkit-font-smoothing"];
   const mozSmoothing = computedStyles.MozOsxFontSmoothing || computedStyles["-moz-osx-font-smoothing"];
@@ -124,7 +123,7 @@ function measureKerningRange(measureRoot, styleSource, chars, styles) {
   const doc = styleSource.ownerDocument;
   const measurer = doc.createElement("span");
   measurer.style.cssText = "position:absolute;visibility:hidden;white-space:pre;";
-  const computedStyles = styles != null ? styles : getComputedStyle(styleSource);
+  const computedStyles = styles ?? getComputedStyle(styleSource);
   copyKerningStyles(measurer, computedStyles);
   measureRoot.appendChild(measurer);
   const range = doc.createRange();
@@ -160,7 +159,7 @@ function measureKerning(container, styleSource, chars, styles, isolateKerningMea
     );
     return /* @__PURE__ */ new Map();
   }
-  const computedStyles = styles != null ? styles : getComputedStyle(styleSource);
+  const computedStyles = styles ?? getComputedStyle(styleSource);
   if (!isolateKerningMeasurement) {
     if (!container.isConnected) {
       console.warn(
@@ -233,7 +232,7 @@ function clearKerningCompensation(allWords, charClass, splitChars, splitWords, m
   }
 }
 function applyKerningCompensation(element, allWords, charClass, splitChars, splitWords, options) {
-  if (options == null ? void 0 : options.disableKerning) return;
+  if (options?.disableKerning) return;
   if (splitChars && allWords.length > 0) {
     const charSelector = classSelector(charClass);
     if (!charSelector) return;
@@ -273,12 +272,12 @@ function applyKerningCompensation(element, allWords, charClass, splitChars, spli
           group.styleSource,
           charStrings,
           group.styles,
-          (options == null ? void 0 : options.isolateKerningMeasurement) !== false
+          options?.isolateKerningMeasurement !== false
         );
         for (const [charIndex, kerning] of kerningMap) {
           const charSpan = group.chars[charIndex];
           if (charSpan && Math.abs(kerning) < 20) {
-            const targetElement = getCharKerningTarget(charSpan, options == null ? void 0 : options.mask);
+            const targetElement = getCharKerningTarget(charSpan, options?.mask);
             targetElement.style.marginLeft = `${kerning}px`;
           }
         }
@@ -309,13 +308,13 @@ function applyKerningCompensation(element, allWords, charClass, splitChars, spli
         firstCharSpan,
         [lastChar, " ", firstChar],
         styles,
-        (options == null ? void 0 : options.isolateKerningMeasurement) !== false
+        options?.isolateKerningMeasurement !== false
       );
       let totalKerning = 0;
       if (kerningMap.has(1)) totalKerning += kerningMap.get(1);
       if (kerningMap.has(2)) totalKerning += kerningMap.get(2);
       if (Math.abs(totalKerning) > 1e-3 && Math.abs(totalKerning) < 20) {
-        const targetElement = getCharKerningTarget(firstCharSpan, options == null ? void 0 : options.mask);
+        const targetElement = getCharKerningTarget(firstCharSpan, options?.mask);
         targetElement.style.marginLeft = `${totalKerning}px`;
       }
     }
@@ -340,13 +339,13 @@ function applyKerningCompensation(element, allWords, charClass, splitChars, spli
         currWord,
         [lastChar, " ", firstChar],
         styles,
-        (options == null ? void 0 : options.isolateKerningMeasurement) !== false
+        options?.isolateKerningMeasurement !== false
       );
       let totalKerning = 0;
       if (kerningMap.has(1)) totalKerning += kerningMap.get(1);
       if (kerningMap.has(2)) totalKerning += kerningMap.get(2);
       if (Math.abs(totalKerning) > 1e-3 && Math.abs(totalKerning) < 20) {
-        const targetElement = getWordKerningTarget(currWord, options == null ? void 0 : options.mask);
+        const targetElement = getWordKerningTarget(currWord, options?.mask);
         targetElement.style.marginLeft = `${totalKerning}px`;
       }
     }
@@ -382,8 +381,7 @@ function resolveAutoSplitTargets(splitElement) {
   return Array.from(new Set(targets));
 }
 function getObservedWidth(entry, target) {
-  var _a;
-  const entryWidth = (_a = entry == null ? void 0 : entry.contentRect) == null ? void 0 : _a.width;
+  const entryWidth = entry?.contentRect?.width;
   if (typeof entryWidth === "number" && Number.isFinite(entryWidth)) {
     return entryWidth;
   }
@@ -420,6 +418,30 @@ function resolveAutoSplitWidth(targets, widthByTarget, changedTarget) {
   return 0;
 }
 
+// src/internal/lineFingerprint.ts
+function normalizeLineFingerprintText(value) {
+  return value.replace(/\u00A0/g, " ").replace(/\s+/g, " ").trim();
+}
+function collectNodeText(node) {
+  if (node.type === "text") return node.text;
+  return node.children.map((child) => collectNodeText(child)).join("");
+}
+function collectLineTextsFromData(nodes, lineTexts) {
+  for (const node of nodes) {
+    if (node.type !== "element") continue;
+    if (node.split === "line") {
+      lineTexts.push(normalizeLineFingerprintText(collectNodeText(node)));
+      continue;
+    }
+    collectLineTextsFromData(node.children, lineTexts);
+  }
+}
+function buildLineFingerprintFromData(data) {
+  const lineTexts = [];
+  collectLineTextsFromData(data.nodes, lineTexts);
+  return lineTexts.join("\n");
+}
+
 // src/core/splitText.ts
 var ARIA_LABEL_ALLOWED_TAGS = /* @__PURE__ */ new Set([
   "h1",
@@ -449,7 +471,6 @@ var ARIA_LABEL_ALLOWED_TAGS = /* @__PURE__ */ new Set([
   "main"
 ]);
 function splitTextData(element, rawOptions = {}) {
-  var _a, _b;
   const options = rawOptions;
   const {
     type = "chars,words,lines",
@@ -466,7 +487,7 @@ function splitTextData(element, rawOptions = {}) {
   if (!(element instanceof HTMLElement)) {
     throw new Error("splitTextData: element must be an HTMLElement");
   }
-  const text = (_b = (_a = element.textContent) == null ? void 0 : _a.trim()) != null ? _b : "";
+  const text = element.textContent?.trim() ?? "";
   if (!text) {
     console.warn("splitTextData: element has no text content");
     return {
@@ -709,11 +730,10 @@ function getSplitRole(element, classInfo) {
   return void 0;
 }
 function serializeNode(node, classInfo) {
-  var _a;
   if (node.nodeType === Node.TEXT_NODE) {
     return {
       type: "text",
-      text: (_a = node.textContent) != null ? _a : ""
+      text: node.textContent ?? ""
     };
   }
   if (node.nodeType !== Node.ELEMENT_NODE) return null;
@@ -920,7 +940,7 @@ function createSpan(className, index, display = "inline-block", options) {
   if (className) {
     span.className = className;
   }
-  if (index !== void 0 && (options == null ? void 0 : options.propName)) {
+  if (index !== void 0 && options?.propName) {
     span.setAttribute(`data-${options.propName}-index`, index.toString());
     if (options.propIndex) {
       span.style.setProperty(`--${options.propName}-index`, index.toString());
@@ -929,7 +949,7 @@ function createSpan(className, index, display = "inline-block", options) {
   span.style.display = display;
   span.style.position = "relative";
   span.style.textDecoration = "inherit";
-  if (options == null ? void 0 : options.ariaHidden) {
+  if (options?.ariaHidden) {
     span.setAttribute("aria-hidden", "true");
   }
   return span;
@@ -993,7 +1013,6 @@ function groupIntoLines(elements, element) {
   return lineGroups;
 }
 function performSplit(element, measuredWords, charClass, wordClass, lineClass, splitChars, splitWords, splitLines, options) {
-  var _a, _b;
   element.textContent = "";
   const allChars = [];
   const allWords = [];
@@ -1005,9 +1024,9 @@ function performSplit(element, measuredWords, charClass, wordClass, lineClass, s
     let globalCharIndex = 0;
     measuredWords.forEach((measuredWord, wordIndex) => {
       const wordSpan = createSpan(wordClass, wordIndex, "inline-block", {
-        propIndex: options == null ? void 0 : options.propIndex,
+        propIndex: options?.propIndex,
         propName: "word",
-        ariaHidden: options == null ? void 0 : options.ariaHidden
+        ariaHidden: options?.ariaHidden
       });
       if (measuredWord.noSpaceBefore) {
         noSpaceBeforeSet.add(wordSpan);
@@ -1022,13 +1041,13 @@ function performSplit(element, measuredWords, charClass, wordClass, lineClass, s
         if (!hasAnyAncestors) {
           measuredWord.chars.forEach((measuredChar, charIndexInWord) => {
             const charSpan = createSpan(charClass, globalCharIndex, "inline-block", {
-              propIndex: options == null ? void 0 : options.propIndex,
+              propIndex: options?.propIndex,
               propName: "char",
-              ariaHidden: options == null ? void 0 : options.ariaHidden
+              ariaHidden: options?.ariaHidden
             });
             charSpan.textContent = measuredChar.char;
             globalCharIndex++;
-            if ((options == null ? void 0 : options.mask) === "chars") {
+            if (options?.mask === "chars") {
               const charWrapper = createMaskWrapper("inline-block");
               charWrapper.appendChild(charSpan);
               wordSpan.appendChild(charWrapper);
@@ -1046,12 +1065,12 @@ function performSplit(element, measuredWords, charClass, wordClass, lineClass, s
           charGroups.forEach((group) => {
             group.chars.forEach((measuredChar) => {
               const charSpan = createSpan(charClass, globalCharIndex, "inline-block", {
-                propIndex: options == null ? void 0 : options.propIndex,
+                propIndex: options?.propIndex,
                 propName: "char"
               });
               charSpan.textContent = measuredChar.char;
               globalCharIndex++;
-              if ((options == null ? void 0 : options.mask) === "chars") {
+              if (options?.mask === "chars") {
                 const charWrapper = createMaskWrapper("inline-block");
                 charWrapper.appendChild(charSpan);
                 wordSpan.appendChild(charWrapper);
@@ -1126,7 +1145,7 @@ function performSplit(element, measuredWords, charClass, wordClass, lineClass, s
         }
         const fragment = document.createDocumentFragment();
         wordGroup.forEach((ws, idx) => {
-          if ((options == null ? void 0 : options.mask) === "words") {
+          if (options?.mask === "words") {
             const wordWrapper = createMaskWrapper("inline-block");
             wordWrapper.appendChild(ws);
             fragment.appendChild(wordWrapper);
@@ -1144,7 +1163,7 @@ function performSplit(element, measuredWords, charClass, wordClass, lineClass, s
         }
         i = j;
       } else {
-        if ((options == null ? void 0 : options.mask) === "words") {
+        if (options?.mask === "words") {
           const wordWrapper = createMaskWrapper("inline-block");
           wordWrapper.appendChild(wordSpan);
           element.appendChild(wordWrapper);
@@ -1164,9 +1183,9 @@ function performSplit(element, measuredWords, charClass, wordClass, lineClass, s
       splitChars,
       splitWords,
       {
-        disableKerning: options == null ? void 0 : options.disableKerning,
-        isolateKerningMeasurement: options == null ? void 0 : options.isolateKerningMeasurement,
-        mask: options == null ? void 0 : options.mask
+        disableKerning: options?.disableKerning,
+        isolateKerningMeasurement: options?.isolateKerningMeasurement,
+        mask: options?.mask
       }
     );
     if (splitLines) {
@@ -1181,9 +1200,9 @@ function performSplit(element, measuredWords, charClass, wordClass, lineClass, s
       const allLines = [];
       lineGroups.forEach((words, lineIndex) => {
         const lineSpan = createSpan(lineClass, lineIndex, "block", {
-          propIndex: options == null ? void 0 : options.propIndex,
+          propIndex: options?.propIndex,
           propName: "line",
-          ariaHidden: options == null ? void 0 : options.ariaHidden
+          ariaHidden: options?.ariaHidden
         });
         allLines.push(lineSpan);
         let wi = 0;
@@ -1205,7 +1224,7 @@ function performSplit(element, measuredWords, charClass, wordClass, lineClass, s
             }
             const fragment = document.createDocumentFragment();
             wordGroup.forEach((ws, idx) => {
-              if ((options == null ? void 0 : options.mask) === "words") {
+              if (options?.mask === "words") {
                 const wordWrapper = createMaskWrapper("inline-block");
                 wordWrapper.appendChild(ws);
                 fragment.appendChild(wordWrapper);
@@ -1223,7 +1242,7 @@ function performSplit(element, measuredWords, charClass, wordClass, lineClass, s
             }
             wi = wj;
           } else {
-            if ((options == null ? void 0 : options.mask) === "words") {
+            if (options?.mask === "words") {
               const wordWrapper = createMaskWrapper("inline-block");
               wordWrapper.appendChild(wordSpan);
               lineSpan.appendChild(wordWrapper);
@@ -1236,7 +1255,7 @@ function performSplit(element, measuredWords, charClass, wordClass, lineClass, s
             wi++;
           }
         }
-        if ((options == null ? void 0 : options.mask) === "lines") {
+        if (options?.mask === "lines") {
           const lineWrapper = createMaskWrapper("block");
           lineWrapper.appendChild(lineSpan);
           element.appendChild(lineWrapper);
@@ -1244,13 +1263,13 @@ function performSplit(element, measuredWords, charClass, wordClass, lineClass, s
           element.appendChild(lineSpan);
         }
       });
-      if (options == null ? void 0 : options.initialStyles) {
+      if (options?.initialStyles) {
         const { chars, words, lines } = options.initialStyles;
         if (chars) applyInitialStyles(allChars, chars);
         if (words) applyInitialStyles(allWords, words);
         if (lines) applyInitialStyles(allLines, lines);
       }
-      if (options == null ? void 0 : options.initialClasses) {
+      if (options?.initialClasses) {
         const { chars, words, lines } = options.initialClasses;
         if (chars) applyInitialClasses(allChars, chars);
         if (words) applyInitialClasses(allWords, words);
@@ -1262,12 +1281,12 @@ function performSplit(element, measuredWords, charClass, wordClass, lineClass, s
         lines: allLines
       };
     }
-    if (options == null ? void 0 : options.initialStyles) {
+    if (options?.initialStyles) {
       const { chars, words } = options.initialStyles;
       if (chars) applyInitialStyles(allChars, chars);
       if (words) applyInitialStyles(allWords, words);
     }
-    if (options == null ? void 0 : options.initialClasses) {
+    if (options?.initialClasses) {
       const { chars, words } = options.initialClasses;
       if (chars) applyInitialClasses(allChars, chars);
       if (words) applyInitialClasses(allWords, words);
@@ -1308,7 +1327,7 @@ function performSplit(element, measuredWords, charClass, wordClass, lineClass, s
       const allLines = [];
       lineGroups.forEach((wrappers, lineIndex) => {
         const lineSpan = createSpan(lineClass, lineIndex, "block", {
-          propIndex: options == null ? void 0 : options.propIndex,
+          propIndex: options?.propIndex,
           propName: "line"
         });
         allLines.push(lineSpan);
@@ -1324,7 +1343,7 @@ function performSplit(element, measuredWords, charClass, wordClass, lineClass, s
             }
           }
         });
-        if ((options == null ? void 0 : options.mask) === "lines") {
+        if (options?.mask === "lines") {
           const lineWrapper = createMaskWrapper("block");
           lineWrapper.appendChild(lineSpan);
           element.appendChild(lineWrapper);
@@ -1332,10 +1351,10 @@ function performSplit(element, measuredWords, charClass, wordClass, lineClass, s
           element.appendChild(lineSpan);
         }
       });
-      if ((_a = options == null ? void 0 : options.initialStyles) == null ? void 0 : _a.lines) {
+      if (options?.initialStyles?.lines) {
         applyInitialStyles(allLines, options.initialStyles.lines);
       }
-      if ((_b = options == null ? void 0 : options.initialClasses) == null ? void 0 : _b.lines) {
+      if (options?.initialClasses?.lines) {
         applyInitialClasses(allLines, options.initialClasses.lines);
       }
       return { chars: [], words: [], lines: allLines };
@@ -1346,37 +1365,11 @@ function performSplit(element, measuredWords, charClass, wordClass, lineClass, s
     }
   }
 }
-function normalizeLineFingerprintText(value) {
-  return value.replace(/\u00A0/g, " ").replace(/\s+/g, " ").trim();
-}
 function buildLineFingerprintFromElements(lines) {
   if (lines.length === 0) return "";
-  return lines.map((line) => {
-    var _a;
-    return normalizeLineFingerprintText((_a = line.textContent) != null ? _a : "");
-  }).join("\n");
-}
-function collectNodeText(node) {
-  if (node.type === "text") return node.text;
-  return node.children.map((child) => collectNodeText(child)).join("");
-}
-function collectLineTextsFromData(nodes, lineTexts) {
-  for (const node of nodes) {
-    if (node.type !== "element") continue;
-    if (node.split === "line") {
-      lineTexts.push(normalizeLineFingerprintText(collectNodeText(node)));
-      continue;
-    }
-    collectLineTextsFromData(node.children, lineTexts);
-  }
-}
-function buildLineFingerprintFromData(data) {
-  const lineTexts = [];
-  collectLineTextsFromData(data.nodes, lineTexts);
-  return lineTexts.join("\n");
+  return lines.map((line) => normalizeLineFingerprintText(line.textContent ?? "")).join("\n");
 }
 function splitText(element, rawOptions = {}) {
-  var _a;
   const options = rawOptions;
   const {
     type = "chars,words,lines",
@@ -1397,7 +1390,7 @@ function splitText(element, rawOptions = {}) {
   if (!(element instanceof HTMLElement)) {
     throw new Error("splitText: element must be an HTMLElement");
   }
-  const text = (_a = element.textContent) == null ? void 0 : _a.trim();
+  const text = element.textContent?.trim();
   if (!text) {
     console.warn("splitText: element has no text content");
     return {
@@ -1759,4 +1752,4 @@ function splitText(element, rawOptions = {}) {
   };
 }
 
-export { applyKerningCompensation, buildKerningStyleKey, clearKerningCompensation, getObservedWidth, normalizeToPromise, querySplitWords, recordWidthChange, resolveAutoSplitTargets, resolveAutoSplitWidth, splitText, splitTextData };
+export { applyKerningCompensation, buildKerningStyleKey, buildLineFingerprintFromData, clearKerningCompensation, getObservedWidth, normalizeToPromise, querySplitWords, recordWidthChange, resolveAutoSplitTargets, resolveAutoSplitWidth, splitText, splitTextData };

package/dist/{chunk-FP4I6OR2.js → chunk-V7FJXNWJ.js}

@@ -32,11 +32,11 @@ function reapplyInitialClasses(elements, className) {
 async function waitForFontsReady(waitForFonts) {
   if (!waitForFonts) return;
   const fonts = document.fonts;
-  const ready = fonts == null ? void 0 : fonts.ready;
+  const ready = fonts?.ready;
   if (!ready || typeof ready.then !== "function") return;
   try {
     await ready;
-  } catch (e) {
+  } catch {
   }
 }
 

package/dist/helpers.js

@@ -1,5 +1,3 @@
-import './chunk-ORMEWXMH.js';
-
 // src/helpers/createSplitClones.ts
 function resolveDisplay(display, unit) {
   if (display && display !== "auto") return display;
@@ -31,10 +29,9 @@ function normalizeOffset(direction, distance) {
   return trimmed.startsWith("-") ? trimmed.slice(1) : trimmed;
 }
 function applyCloneOffset(clone, cloneOffset) {
-  var _a, _b, _c;
-  const axis = (_a = cloneOffset == null ? void 0 : cloneOffset.axis) != null ? _a : "y";
-  const direction = (_b = cloneOffset == null ? void 0 : cloneOffset.direction) != null ? _b : "start";
-  const distance = (_c = cloneOffset == null ? void 0 : cloneOffset.distance) != null ? _c : "100%";
+  const axis = cloneOffset?.axis ?? "y";
+  const direction = cloneOffset?.direction ?? "start";
+  const distance = cloneOffset?.distance ?? "100%";
   const offset = normalizeOffset(direction, distance);
   clone.style.position = "absolute";
   if (axis === "y") {
@@ -52,9 +49,8 @@ function resolveOriginals(split, unit) {
   throw new Error(`createSplitClones: unsupported unit "${unit}"`);
 }
 function createSplitClones(split, options) {
-  var _a;
   const unit = options.unit;
-  const wrap = (_a = options.wrap) != null ? _a : false;
+  const wrap = options.wrap ?? false;
   const originals = resolveOriginals(split, unit);
   const clones = [];
   const tracks = [];
@@ -104,7 +100,7 @@ function createSplitClones(split, options) {
       }
       item.track.remove();
     }
-    if (cleanupOptions == null ? void 0 : cleanupOptions.revertSplit) {
+    if (cleanupOptions?.revertSplit) {
       split.revert();
     }
   };

package/dist/index.js

@@ -1,2 +1 @@
-export { splitText } from './chunk-UPF3IYHC.js';
-import './chunk-ORMEWXMH.js';
+export { splitText } from './chunk-OUXSJF3P.js';