@instructure/ui-truncate-text 11.6.0 → 11.6.1-snapshot-129

package/es/TruncateText/v2/index.js

@@ -0,0 +1,264 @@
+var _dec, _class, _TruncateText;
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2015 - present Instructure, Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import { Children, Component } from 'react';
+import { debounce } from '@instructure/debounce';
+import { canUseDOM, getBoundingClientRect } from '@instructure/ui-dom-utils';
+import { safeCloneElement, ensureSingleChild } from '@instructure/ui-react-utils';
+import { logError as error } from '@instructure/console';
+import { withStyle } from '@instructure/emotion';
+import generateStyle from "./styles.js";
+import truncate from "./utils/truncate.js";
+import { allowedProps } from "./props.js";
+import { jsx as _jsx, jsxs as _jsxs } from "@emotion/react/jsx-runtime";
+/**
+---
+category: components
+---
+**/
+let TruncateText = (_dec = withStyle(generateStyle), _dec(_class = (_TruncateText = class TruncateText extends Component {
+  constructor(props) {
+    super(props);
+    this.ref = null;
+    this._text = void 0;
+    this._debounced = void 0;
+    this._stage = null;
+    this._wasTruncated = void 0;
+    this._resizeListener = void 0;
+    this._prevWidth = null;
+    this.update = () => {
+      if (this.ref) {
+        this.setState(this.initialState);
+      }
+    };
+    this.state = this.initialState;
+  }
+  get _ref() {
+    return this.ref;
+  }
+  get initialState() {
+    return {
+      isTruncated: false,
+      needsSecondRender: true,
+      truncatedElement: void 0,
+      truncatedText: void 0
+    };
+  }
+  componentDidMount() {
+    const _this$props = this.props,
+      children = _this$props.children,
+      makeStyles = _this$props.makeStyles;
+    makeStyles === null || makeStyles === void 0 ? void 0 : makeStyles();
+    if (children) {
+      var _getBoundingClientRec;
+      this.checkChildren();
+      const txt = ensureSingleChild(children);
+      this._text = txt ? txt : void 0;
+      this.truncate();
+      this._debounced = debounce(this.update, this.props.debounce, {
+        leading: true,
+        trailing: true
+      });
+      this._prevWidth = (_getBoundingClientRec = getBoundingClientRect(this.ref)) === null || _getBoundingClientRec === void 0 ? void 0 : _getBoundingClientRec.width;
+      this._resizeListener = new ResizeObserver(entries => {
+        // requestAnimationFrame call is needed becuase some truncatetext test cases
+        // failed due to ResizeObserver was not able to deliver all observations within a single animation frame
+        // see: https://stackoverflow.com/questions/49384120/resizeobserver-loop-limit-exceeded
+        requestAnimationFrame(() => {
+          for (const entry of entries) {
+            const width = entry.contentRect.width;
+            if (this._prevWidth !== width) {
+              this._prevWidth = width;
+              this.props.debounce === 0 ? this.update() : this._debounced();
+            }
+          }
+        });
+      });
+      this._resizeListener.observe(this.ref);
+    }
+  }
+  componentWillUnmount() {
+    if (this._resizeListener) {
+      this._resizeListener.disconnect();
+    }
+    if (this._debounced) {
+      this._debounced.cancel();
+    }
+  }
+  shallowCompare(obj1, obj2) {
+    const keys1 = Object.keys(obj1);
+    const keys2 = Object.keys(obj2);
+    if (keys1.length !== keys2.length) {
+      return false;
+    }
+    for (const key of keys1) {
+      if (obj1[key] !== obj2[key]) {
+        return false;
+      }
+    }
+    return true;
+  }
+  componentDidUpdate(prevProps) {
+    const _this$props2 = this.props,
+      children = _this$props2.children,
+      onUpdate = _this$props2.onUpdate,
+      makeStyles = _this$props2.makeStyles;
+    makeStyles === null || makeStyles === void 0 ? void 0 : makeStyles();
+    const _this$state = this.state,
+      isTruncated = _this$state.isTruncated,
+      needsSecondRender = _this$state.needsSecondRender,
+      truncatedText = _this$state.truncatedText;
+    if (children) {
+      // for some reason in React 19 prevPros and this.props are a different
+      // object even if their contents are the same, so we cannot use !==
+      if (!this.shallowCompare(prevProps, this.props)) {
+        if (prevProps.children !== this.props.children) {
+          // reset internal text variable if children change
+          this.checkChildren();
+          const txt = ensureSingleChild(children);
+          this._text = txt ? txt : void 0;
+        }
+        // require the double render whenever props change
+        this.setState(this.initialState);
+        return;
+      }
+      if (!needsSecondRender && (isTruncated || this._wasTruncated)) {
+        onUpdate === null || onUpdate === void 0 ? void 0 : onUpdate(isTruncated, truncatedText);
+        this._wasTruncated = isTruncated;
+      } else {
+        this.truncate();
+      }
+    }
+  }
+  checkChildren() {
+    error(!(() => {
+      let isTooDeep = false;
+      const text = ensureSingleChild(this.props.children);
+      Children.forEach(text.props.children, child => {
+        if (child.props) {
+          Children.forEach(child.props.children, grandChild => {
+            // currently we don't support node trees deeper than 2 levels
+            // truncation will still occur on their text content, but their actual node structure will be lost
+            if (grandChild.props) {
+              isTooDeep = true;
+            }
+          });
+        }
+      });
+      return isTooDeep;
+    })(), `[TruncateText] Some children are too deep in the node tree and will not render.`);
+  }
+  truncate() {
+    if (!this.state.needsSecondRender) {
+      return;
+    }
+    if (canUseDOM) {
+      var _this$props$styles;
+      const result = truncate(this._stage, {
+        ...this.props,
+        parent: this.ref ? this.ref : void 0,
+        lineHeight: (_this$props$styles = this.props.styles) === null || _this$props$styles === void 0 ? void 0 : _this$props$styles.lineHeight
+      });
+      if (result) {
+        const element = this.renderChildren(result.isTruncated, result.data, result.constraints.width);
+        this.setState({
+          needsSecondRender: false,
+          isTruncated: result.isTruncated,
+          truncatedElement: element,
+          truncatedText: result.text
+        });
+      }
+    } else {
+      var _this$ref, _this$ref2;
+      const textContent = (_this$ref = this.ref) !== null && _this$ref !== void 0 && _this$ref.textContent ? (_this$ref2 = this.ref) === null || _this$ref2 === void 0 ? void 0 : _this$ref2.textContent : void 0;
+      // if dom isn't available, use original children
+      this.setState({
+        needsSecondRender: false,
+        isTruncated: false,
+        truncatedElement: this._text,
+        truncatedText: textContent
+      });
+    }
+  }
+  renderChildren(truncated, data, width) {
+    var _this$props$styles2;
+    if (!truncated) {
+      return this._text;
+    }
+    const childElements = [];
+    // iterate over each node used in the truncated string
+    for (let i = 0; i < data.length; i++) {
+      const item = data[i];
+      const element = this._text.props.children[i];
+      const nodeText = item.join('');
+      if (element && element.props) {
+        // if node is an html element and not just a string
+        childElements.push(safeCloneElement(element, element.props, nodeText));
+      } else {
+        childElements.push(nodeText);
+      }
+    }
+    // this spacer element is set to the max width the full text could
+    // potentially be without this, text in `width: auto` elements won't expand
+    // to accommodate more text, once truncated
+    // Breadcrumb is modifying this element's display to inline to prevent layout issues
+    // TODO: find a better way to handle this
+    childElements.push(_jsx("span", {
+      css: (_this$props$styles2 = this.props.styles) === null || _this$props$styles2 === void 0 ? void 0 : _this$props$styles2.spacer,
+      style: {
+        width: width || void 0
+      }
+    }, "spacer"));
+    const children = Children.map(childElements, child => child);
+    return this._text.props ? safeCloneElement(this._text, this._text.props, children) : children;
+  }
+  render() {
+    var _this$props$styles3;
+    const truncatedElement = this.state.truncatedElement;
+    const children = this.props.children;
+    return _jsxs("span", {
+      "data-cid": "TruncateText",
+      css: (_this$props$styles3 = this.props.styles) === null || _this$props$styles3 === void 0 ? void 0 : _this$props$styles3.truncateText,
+      ref: el => {
+        this.ref = el;
+      },
+      children: [children && (truncatedElement ? null : _jsx("span", {
+        ref: el => {
+          this._stage = el;
+        },
+        children: ensureSingleChild(children)
+      })), truncatedElement]
+    });
+  }
+}, _TruncateText.displayName = "TruncateText", _TruncateText.componentId = 'TruncateText', _TruncateText.allowedProps = allowedProps, _TruncateText.defaultProps = {
+  maxLines: 1,
+  ellipsis: '\u2026',
+  truncate: 'character',
+  position: 'end',
+  ignore: [' ', '.', ','],
+  debounce: 0
+}, _TruncateText)) || _class);
+export default TruncateText;
+export { TruncateText };

package/es/TruncateText/v2/props.js

@@ -0,0 +1,26 @@
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2015 - present Instructure, Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+const allowedProps = ['children', 'maxLines', 'position', 'truncate', 'ellipsis', 'ignore', 'debounce', 'onUpdate', 'shouldTruncateWhenInvisible'];
+export { allowedProps };

package/es/TruncateText/v2/styles.js

@@ -0,0 +1,58 @@
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2015 - present Instructure, Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+/**
+ * ---
+ * private: true
+ * ---
+ * Generates the style object from the theme and provided additional information
+ * @param  {Object} componentTheme The theme variable object.
+ * @param  {Object} props the props of the component, the style is applied to
+ * @param  {Object} state the state of the component, the style is applied to
+ * @return {Object} The final style object, which will be used in the component
+ */
+const generateStyle = componentTheme => {
+  return {
+    truncateText: {
+      label: 'truncateText',
+      display: 'block',
+      overflow: 'hidden',
+      wordWrap: 'break-word',
+      whiteSpace: 'normal',
+      fontFamily: componentTheme.fontFamily
+    },
+    auto: {
+      label: 'truncateText__auto',
+      height: '100%'
+    },
+    spacer: {
+      label: 'truncateText__spacer',
+      visibility: 'hidden',
+      maxHeight: '0',
+      display: 'block'
+    },
+    lineHeight: componentTheme.lineHeight
+  };
+};
+export default generateStyle;

package/es/TruncateText/v2/utils/cleanData.js

@@ -0,0 +1,158 @@
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2015 - present Instructure, Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import { cloneArray } from '@instructure/ui-utils';
+/**
+ * ---
+ * parent: TruncateText
+ * private: true
+ * ---
+ * Removes given characters, such as whitespace and punctuation, from stringData
+ * arrays used by Truncator and TruncateText.
+ *
+ * @param {Array} stringData A stringData array.
+ * @param {Object} options The options object.
+ * @param {string} options.truncate Is the data being truncated by character or word.
+ * @param {string[]} options.ignore An array of characters to remove around the ellipsis.
+ * @param {string} options.ellipsis The string being used as an ellipsis.
+ * @param {boolean} repeat=false Do a thorough clean.
+ */
+function cleanData(stringData, options, repeat = false) {
+  const truncate = options.truncate,
+    ignore = options.ignore,
+    ellipsis = options.ellipsis;
+  let newData = cloneArray(stringData);
+  let ellipsisNode = -1;
+  let ellipsisIndex = -1;
+  const findEllipsis = () => {
+    for (let i = 0; i < newData.length; i++) {
+      const nodeData = newData[i];
+      if (nodeData.indexOf(ellipsis) !== -1) {
+        ellipsisNode = i;
+        ellipsisIndex = nodeData.indexOf(ellipsis);
+      }
+    }
+  };
+  if (truncate === 'character') {
+    findEllipsis();
+    let node = newData[ellipsisNode];
+    if (node) {
+      const before = node[ellipsisIndex - 1];
+      if (before && ignore.indexOf(before) !== -1) {
+        // remove character immediately BEFORE the ellipsis in the same node
+        newData[ellipsisNode].splice(ellipsisIndex - 1, 1);
+      }
+      if (!before) {
+        // character before the ellipsis is part of a different node
+        // find the next node with data and remove last datum
+        let prevNode = null;
+        let prevNodeIndex = ellipsisNode - 1;
+        while (prevNodeIndex >= 0) {
+          prevNode = newData[prevNodeIndex];
+          if (prevNode.length > 0) {
+            break;
+          } else {
+            prevNodeIndex--;
+          }
+        }
+        if (prevNode) {
+          const lastChar = String(prevNode.slice(-1));
+          if (ignore.indexOf(lastChar) !== -1) {
+            newData[prevNodeIndex].length -= 1;
+          }
+        }
+      }
+    }
+    findEllipsis();
+    node = newData[ellipsisNode];
+    if (node) {
+      const after = node[ellipsisIndex + 1];
+      if (after && ignore.indexOf(after) !== -1) {
+        // remove character immediately AFTER the ellipsis in the same node
+        newData[ellipsisNode].splice(ellipsisIndex + 1, 1);
+      }
+      if (!after) {
+        // character after the ellipsis is part of a different node
+        // find the next node with data and remove first datum
+        let nextNode = null;
+        let nextNodeIndex = ellipsisNode + 1;
+        while (nextNodeIndex < newData.length) {
+          nextNode = newData[nextNodeIndex];
+          if (nextNode.length > 0) {
+            break;
+          } else {
+            nextNodeIndex++;
+          }
+        }
+        if (nextNode) {
+          const firstChar = String(nextNode[0]);
+          if (ignore.indexOf(firstChar) !== -1) {
+            newData[nextNodeIndex].shift();
+          }
+        }
+      }
+    }
+  } else {
+    findEllipsis();
+    const node = newData[ellipsisNode];
+    if (node) {
+      const before = node[ellipsisIndex - 1];
+      if (before && ignore.indexOf(before.slice(-1)) !== -1) {
+        if (before.length === 1) {
+          // remove entire word datum
+          newData[ellipsisNode].splice(ellipsisIndex - 1, 1);
+        } else {
+          // remove word immediately BEFORE the ellipsis in the same node
+          newData[ellipsisNode][ellipsisIndex - 1] = before.slice(0, -1);
+        }
+      }
+      if (!before) {
+        // word before the ellipsis is part of a different node
+        // find the next node with data and remove last datum
+        let prevNode = null;
+        let prevNodeIndex = ellipsisNode - 1;
+        while (prevNodeIndex >= 0) {
+          prevNode = newData[prevNodeIndex];
+          if (prevNode.length > 0) {
+            break;
+          } else {
+            prevNodeIndex--;
+          }
+        }
+        if (prevNode) {
+          const lastChar = String(prevNode.slice(-1)).slice(-1);
+          if (ignore.indexOf(lastChar) !== -1) {
+            const lastItem = prevNode.length - 1;
+            newData[prevNodeIndex][lastItem] = prevNode[lastItem].slice(0, -1);
+          }
+        }
+      }
+    }
+  }
+  if (repeat) {
+    newData = cleanData(newData, options, false);
+  }
+  return newData;
+}
+export default cleanData;

package/es/TruncateText/v2/utils/cleanString.js

@@ -0,0 +1,53 @@
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2015 - present Instructure, Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+/**
+ * ---
+ * parent: TruncateText
+ * private: true
+ * ---
+ * Removes given characters, such as whitespace and punctuation, from either end of a string.
+ *
+ * @param {string} string The string to clean.
+ * @param {string[]} ignore Array of characters to remove.
+ * @param {boolean} start Whether or not to clean start of string.
+ * @param {boolean} end Whether or not to clean end of string.
+ * @param {boolean} repeat=false Do a thorough clean.
+ */
+function cleanString(string, ignore, start = true, end = true, repeat = false) {
+  let text = string;
+  const firstChar = text.charAt(0);
+  const lastChar = text.slice(-1);
+  if (start && ignore.indexOf(firstChar) !== -1) {
+    text = text.slice(1);
+  }
+  if (end && ignore.indexOf(lastChar) !== -1) {
+    text = text.slice(0, -1);
+  }
+  if (repeat) {
+    text = cleanString(text, ignore, start, end, false);
+  }
+  return text;
+}
+export default cleanString;

package/es/TruncateText/v2/utils/measureText.js

@@ -0,0 +1,74 @@
+/*
+ * The MIT License (MIT)
+ *
+ * Copyright (c) 2015 - present Instructure, Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import { getCSSStyleDeclaration } from '@instructure/ui-dom-utils';
+
+/**
+ * ---
+ * parent: TruncateText
+ * private: true
+ * ---
+ * Finds the max potential width of set of DOM nodes.
+ *
+ * @param {DOMNode[]} nodes Array of DOM nodes.
+ * @param {DOMNode} parentNode The node to inherit default styles from.
+ */
+function measureText(nodes, parentNode) {
+  let width = 0;
+  for (let i = 0; i < nodes.length; i++) {
+    const node = nodes[i];
+    width += measure(node.textContent, node.nodeType === 1 ? node : parentNode);
+  }
+  return width;
+}
+function measure(string, domNode) {
+  const style = getCSSStyleDeclaration(domNode);
+  // we use a canvas in a doc fragment to prevent having to render the string full width in the DOM
+  const canvas = document.createElement('canvas');
+  document.createDocumentFragment().appendChild(canvas);
+  const context = canvas.getContext('2d');
+  if (!context || !string) {
+    return 0;
+  }
+  let text = string;
+  let letterOffset = 0;
+  let width = 0;
+  // grab individual font styles
+  // some browsers don't report a value for style['font']
+  context.font = [style === null || style === void 0 ? void 0 : style.fontWeight, style === null || style === void 0 ? void 0 : style.fontStyle, style === null || style === void 0 ? void 0 : style.fontSize, style === null || style === void 0 ? void 0 : style.fontFamily].join(' ');
+  if ((style === null || style === void 0 ? void 0 : style.textTransform) === 'uppercase') {
+    text = string.toUpperCase();
+  } else if ((style === null || style === void 0 ? void 0 : style.textTransform) === 'lowercase') {
+    text = string.toLowerCase();
+  } else if ((style === null || style === void 0 ? void 0 : style.textTransform) === 'capitalize') {
+    text = string.replace(/\b\w/g, str => str.toUpperCase());
+  }
+  if ((style === null || style === void 0 ? void 0 : style.letterSpacing) !== 'normal') {
+    letterOffset = text.length * parseInt(style === null || style === void 0 ? void 0 : style.letterSpacing);
+  }
+  width = context.measureText(text).width + letterOffset;
+  // returns the max potential width of the text, assuming the text was on a single line
+  return width;
+}
+export default measureText;