@wistia/ui 0.15.12 → 0.15.13-beta.a8953353.4dacd3e

package/dist/index.d.mts

@@ -1814,6 +1814,11 @@ type TextProps = ComponentPropsWithoutRef<'div'> & {
      * Display the text as inline content
      */
     inline?: boolean;
+    /**
+     * Maximum number of characters to display before truncating. Must be >= 1.
+     * When truncated, an ellipsis (...) will be added to the end.
+     */
+    maxChars?: number;
     /**
      * Prevents text from being highlighted and copied
      */
@@ -1907,6 +1912,11 @@ type HeadingProps = ComponentPropsWithoutRef<typeof DEFAULT_ELEMENT> & {
      * Display the text as inline content
      */
     inline?: boolean;
+    /**
+     * Maximum number of characters to display before truncating. Must be >= 1.
+     * When truncated, an ellipsis (...) will be added to the end.
+     */
+    maxChars?: number;
     /**
      * Text prominence affects color. Use 'primary' for main non-interactive text, 'secondary' for supporting text, and 'button' in specific cases where text is used in an interactive component.
      */

package/dist/index.d.ts

@@ -1814,6 +1814,11 @@ type TextProps = ComponentPropsWithoutRef<'div'> & {
      * Display the text as inline content
      */
     inline?: boolean;
+    /**
+     * Maximum number of characters to display before truncating. Must be >= 1.
+     * When truncated, an ellipsis (...) will be added to the end.
+     */
+    maxChars?: number;
     /**
      * Prevents text from being highlighted and copied
      */
@@ -1907,6 +1912,11 @@ type HeadingProps = ComponentPropsWithoutRef<typeof DEFAULT_ELEMENT> & {
      * Display the text as inline content
      */
     inline?: boolean;
+    /**
+     * Maximum number of characters to display before truncating. Must be >= 1.
+     * When truncated, an ellipsis (...) will be added to the end.
+     */
+    maxChars?: number;
     /**
      * Text prominence affects color. Use 'primary' for main non-interactive text, 'secondary' for supporting text, and 'button' in specific cases where text is used in an interactive component.
      */

package/dist/index.mjs

@@ -1,6 +1,6 @@
 
 /*
- * @license @wistia/ui v0.15.12
+ * @license @wistia/ui v0.15.13-beta.a8953353.4dacd3e
  *
  * Copyright (c) 2024-2025, Wistia, Inc. and its affiliates.
  *
@@ -8307,7 +8307,7 @@ Badge.displayName = "Badge_UI";
 // src/components/Banner/Banner.tsx
 import { useEffect as useEffect8, useState as useState10, useMemo as useMemo5 } from "react";
 import styled16 from "styled-components";
-import { isNil as isNil10, isNotNil as isNotNil13 } from "@wistia/type-guards";
+import { isNil as isNil11, isNotNil as isNotNil13 } from "@wistia/type-guards";
 
 // src/components/Box/Box.tsx
 import { forwardRef as forwardRef5 } from "react";
@@ -8510,6 +8510,38 @@ var Box = makePolymorphic(BoxComponent);
 import { forwardRef as forwardRef6 } from "react";
 import styled12, { css as css21 } from "styled-components";
 import { isNotNil as isNotNil11 } from "@wistia/type-guards";
+
+// src/private/helpers/applyMaxCharsToChildren/applyMaxCharsToChildren.ts
+import { isString as isString2, isNumber, isNil as isNil9 } from "@wistia/type-guards";
+
+// src/private/helpers/truncateString/truncateString.ts
+var truncateString = (text, maxChars) => {
+  if (maxChars < 1) {
+    throw new Error("maxChars must be >= 1");
+  }
+  if (text.length <= maxChars) {
+    return text;
+  }
+  return text.slice(0, maxChars);
+};
+
+// src/private/helpers/applyMaxCharsToChildren/applyMaxCharsToChildren.ts
+var applyMaxCharsToChildren = (children, maxChars) => {
+  if (isNil9(maxChars)) {
+    return children;
+  }
+  if (isString2(children)) {
+    return truncateString(children, maxChars);
+  }
+  if (isNumber(children)) {
+    const numberString = String(children);
+    return truncateString(numberString, maxChars);
+  }
+  const textContent = typeof children === "object" ? JSON.stringify(children) : String(children);
+  return truncateString(textContent, maxChars);
+};
+
+// src/components/Heading/Heading.tsx
 import { jsx as jsx207 } from "react/jsx-runtime";
 var heroStyle = css21`
   --font-family: var(--wui-typography-heading-hero-family);
@@ -8618,31 +8650,37 @@ var variantElementMap = {
 var HeadingComponent = forwardRef6(
   ({
     align = "left",
+    children,
     colorScheme = "inherit",
     disabled = false,
     inline = false,
+    maxChars,
     preventUserSelect = false,
     prominence = "primary",
     truncate,
     variant = "heading1",
     renderAs,
     ...props
-  }, ref) => /* @__PURE__ */ jsx207(
-    StyledHeading,
-    {
-      ref,
-      $align: align,
-      $colorScheme: colorScheme,
-      $disabled: disabled,
-      $inline: inline,
-      $preventUserSelect: preventUserSelect,
-      $prominence: prominence,
-      $truncate: truncate,
-      $variant: variant,
-      as: renderAs ?? variantElementMap[variant] ?? DEFAULT_ELEMENT2,
-      ...props
-    }
-  )
+  }, ref) => {
+    const processedChildren = applyMaxCharsToChildren(children, maxChars);
+    return /* @__PURE__ */ jsx207(
+      StyledHeading,
+      {
+        ref,
+        $align: align,
+        $colorScheme: colorScheme,
+        $disabled: disabled,
+        $inline: inline,
+        $preventUserSelect: preventUserSelect,
+        $prominence: prominence,
+        $truncate: truncate,
+        $variant: variant,
+        as: renderAs ?? variantElementMap[variant] ?? DEFAULT_ELEMENT2,
+        ...props,
+        children: processedChildren
+      }
+    );
+  }
 );
 HeadingComponent.displayName = "Heading_UI";
 var Heading = makePolymorphic(HeadingComponent);
@@ -8835,9 +8873,11 @@ var StyledText = styled13.div`
 var TextComponent = forwardRef7(
   ({
     align = "left",
+    children,
     colorScheme = "inherit",
     disabled = false,
     inline = false,
+    maxChars,
     preventUserSelect = false,
     prominence = "primary",
     truncate,
@@ -8845,6 +8885,7 @@ var TextComponent = forwardRef7(
     renderAs,
     ...props
   }, ref) => {
+    const processedChildren = applyMaxCharsToChildren(children, maxChars);
     return /* @__PURE__ */ jsx208(
       StyledText,
       {
@@ -8858,7 +8899,8 @@ var TextComponent = forwardRef7(
         $truncate: truncate,
         $variant: variant,
         as: renderAs ?? variantElementMap2[variant] ?? DEFAULT_ELEMENT3,
-        ...props
+        ...props,
+        children: processedChildren
       }
     );
   }
@@ -8868,7 +8910,7 @@ var Text = makePolymorphic(TextComponent);
 
 // src/components/ButtonGroup/ButtonGroup.tsx
 import styled14, { css as css23 } from "styled-components";
-import { isNil as isNil9 } from "@wistia/type-guards";
+import { isNil as isNil10 } from "@wistia/type-guards";
 import { jsx as jsx209 } from "react/jsx-runtime";
 var getAlignment = (align) => {
   if (align === "center") {
@@ -8928,7 +8970,7 @@ var ButtonGroup = ({
   ...props
 }) => {
   const responsiveButtonSize = useResponsiveProp(buttonSize);
-  if (isNil9(children)) {
+  if (isNil10(children)) {
     return null;
   }
   return /* @__PURE__ */ jsx209(
@@ -9048,7 +9090,7 @@ var Banner = ({
   const hasImage = isNotNil13(image);
   const shouldShowImage = hasImage && (isVerticalLayout || width >= MIN_IMAGE_WIDTH);
   const iconPosition = useMemo5(() => {
-    if (isNil10(icon)) return "none";
+    if (isNil11(icon)) return "none";
     if (isSmallContainer) return shouldShowImage ? "inline" : "above";
     return prominence === "secondary" ? "inline" : "above";
   }, [icon, isSmallContainer, shouldShowImage, prominence]);
@@ -9324,7 +9366,7 @@ import { forwardRef as forwardRef12, useId as useId2 } from "react";
 import styled27, { css as css26 } from "styled-components";
 
 // src/private/components/FormControlLabel/FormControlLabel.tsx
-import { isNil as isNil12, isNotNil as isNotNil15 } from "@wistia/type-guards";
+import { isNil as isNil13, isNotNil as isNotNil15 } from "@wistia/type-guards";
 import styled23, { css as css25 } from "styled-components";
 
 // src/components/ScreenReaderOnly/ScreenReaderOnly.tsx
@@ -9351,7 +9393,7 @@ ScreenReaderOnly.displayName = "ScreenReaderOnly_UI";
 
 // src/private/components/FormControlLabel/FormControlLabelDescription.tsx
 import styled22, { css as css24 } from "styled-components";
-import { isNil as isNil11 } from "@wistia/type-guards";
+import { isNil as isNil12 } from "@wistia/type-guards";
 import { jsx as jsx217 } from "react/jsx-runtime";
 var disabledStyle = css24`
   color: var(--wui-color-text-disabled);
@@ -9370,7 +9412,7 @@ var FormControlLabelDescription = ({
   disabled = false,
   ...props
 }) => {
-  if (isNil11(children)) {
+  if (isNil12(children)) {
     return null;
   }
   return /* @__PURE__ */ jsx217(
@@ -9418,7 +9460,7 @@ var FormControlLabel = ({
   hideLabel = false,
   ...props
 }) => {
-  if (isNil12(label)) {
+  if (isNil13(label)) {
     return null;
   }
   const labelContent = hideLabel ? /* @__PURE__ */ jsx218(ScreenReaderOnly, { children: label }) : /* @__PURE__ */ jsxs16(StyledLabelWrapper, { children: [
@@ -11487,7 +11529,7 @@ import { parseHex as parseHex2 } from "culori/fn";
 // src/components/Input/Input.tsx
 import { isValidElement as isValidElement2, forwardRef as forwardRef15, cloneElement as cloneElement4, useRef as useRef9 } from "react";
 import styled44, { css as css30 } from "styled-components";
-import { isNil as isNil13, isNotNil as isNotNil18, isRecord as isRecord4 } from "@wistia/type-guards";
+import { isNil as isNil14, isNotNil as isNotNil18, isRecord as isRecord4 } from "@wistia/type-guards";
 
 // src/css/inputCss.ts
 import { css as css29 } from "styled-components";
@@ -11638,7 +11680,7 @@ var Input = forwardRef15(
     const internalRef = useRef9(null);
     const ref = isNotNil18(externalRef) && isRecord4(externalRef) && "current" in externalRef ? externalRef : internalRef;
     let leftIconToDisplay = leftIcon;
-    if (isNil13(leftIcon) && type === "search") {
+    if (isNil14(leftIcon) && type === "search") {
       leftIconToDisplay = /* @__PURE__ */ jsx249(Icon, { type: "search" });
     }
     if (isNotNil18(leftIconToDisplay) && isValidElement2(leftIconToDisplay)) {
@@ -12386,12 +12428,12 @@ import {
 } from "react";
 import { matchSorter } from "match-sorter";
 import styled50 from "styled-components";
-import { isArray as isArray2, isString as isString2 } from "@wistia/type-guards";
+import { isArray as isArray2, isString as isString3 } from "@wistia/type-guards";
 
 // src/components/Tag/Tag.tsx
 import { forwardRef as forwardRef16 } from "react";
 import styled49 from "styled-components";
-import { isNil as isNil14, isNotNil as isNotNil19, isNonEmptyString as isNonEmptyString5 } from "@wistia/type-guards";
+import { isNil as isNil15, isNotNil as isNotNil19, isNonEmptyString as isNonEmptyString5 } from "@wistia/type-guards";
 import { Fragment as Fragment7, jsx as jsx255, jsxs as jsxs33 } from "react/jsx-runtime";
 var TagLabel = styled49.a`
   ${({ $colorScheme }) => getColorScheme($colorScheme)};
@@ -12477,10 +12519,10 @@ var StyledTag = styled49.div`
   }
 `;
 var RemoveButton = ({ onClickRemove, onClickRemoveLabel, colorScheme }) => {
-  if (isNil14(onClickRemove)) {
+  if (isNil15(onClickRemove)) {
     return null;
   }
-  if (isNil14(onClickRemoveLabel)) {
+  if (isNil15(onClickRemoveLabel)) {
     throw new Error(
       "for accessibility, onClickRemoveLabel must be provided if onClickRemove is provided"
     );
@@ -12750,11 +12792,11 @@ var Combobox2 = ({
     return () => null;
   }, []);
   const handleRemoveValue = (valueToRemove) => {
-    if (isString2(value)) {
+    if (isString3(value)) {
       onChange("");
       return;
     }
-    onChange(isString2(value) ? "" : value.filter((val) => val !== valueToRemove));
+    onChange(isString3(value) ? "" : value.filter((val) => val !== valueToRemove));
   };
   const matches = useMemo11(() => {
     return matchSorter(Object.keys(options), searchValue);
@@ -12833,8 +12875,9 @@ var Combobox2 = ({
 };
 
 // src/components/ContextMenu/ContextMenu.tsx
-import { isNil as isNil15, isNotNil as isNotNil24 } from "@wistia/type-guards";
+import { isNil as isNil16, isNotNil as isNotNil24 } from "@wistia/type-guards";
 import { useEffect as useEffect16, useState as useState17 } from "react";
+import { createPortal } from "react-dom";
 
 // src/components/Menu/Menu.tsx
 import {
@@ -13521,7 +13564,7 @@ var ContextMenu = ({
   const [isRightClicked, setIsRightClicked] = useState17(false);
   const [menuPosition, setMenuPosition] = useState17(position ?? { x: 0, y: 0 });
   useEffect16(() => {
-    if (isNil15(position)) {
+    if (isNil16(position)) {
       const onContextMenu = (event) => {
         event.preventDefault();
         setMenuPosition({ x: event.clientX, y: event.clientY });
@@ -13536,7 +13579,10 @@ var ContextMenu = ({
     return () => null;
   }, [position, triggerRef]);
   const isOpen = isNotNil24(position) || isRightClicked;
-  return isOpen ? /* @__PURE__ */ jsx267(
+  if (!isOpen) {
+    return null;
+  }
+  const menu = /* @__PURE__ */ jsx267(
     Menu,
     {
       isOpen,
@@ -13564,7 +13610,11 @@ var ContextMenu = ({
       ),
       children
     }
-  ) : null;
+  );
+  if (isNotNil24(triggerRef)) {
+    return createPortal(menu, document.body);
+  }
+  return menu;
 };
 
 // src/components/DataCards/DataCard.tsx
@@ -15137,13 +15187,13 @@ import styled72, { css as css37 } from "styled-components";
 
 // src/components/List/ListItem.tsx
 import styled71 from "styled-components";
-import { isNil as isNil16 } from "@wistia/type-guards";
+import { isNil as isNil17 } from "@wistia/type-guards";
 import { jsx as jsx289 } from "react/jsx-runtime";
 var ListItemComponent = styled71.li`
   margin-bottom: var(--wui-space-02);
 `;
 var ListItem = ({ children }) => {
-  if (isNil16(children)) {
+  if (isNil17(children)) {
     return null;
   }
   return /* @__PURE__ */ jsx289(ListItemComponent, { children });
@@ -16513,7 +16563,7 @@ ScrollArea.displayName = "ScrollArea_UI";
 import { forwardRef as forwardRef32 } from "react";
 import styled89, { css as css44 } from "styled-components";
 import { Root as ToggleGroupRoot2 } from "@radix-ui/react-toggle-group";
-import { isNil as isNil17 } from "@wistia/type-guards";
+import { isNil as isNil18 } from "@wistia/type-guards";
 
 // src/components/SegmentedControl/useSelectedItemStyle.tsx
 import { createContext as createContext9, useContext as useContext15, useMemo as useMemo16, useState as useState24 } from "react";
@@ -16621,7 +16671,7 @@ var SegmentedControl = forwardRef32(
     onSelectedValueChange,
     ...props
   }, ref) => {
-    if (isNil17(children)) {
+    if (isNil18(children)) {
       return null;
     }
     return /* @__PURE__ */ jsx308(
@@ -17480,7 +17530,7 @@ ThumbnailBadge.displayName = "ThumbnailBadge_UI";
 // src/components/Thumbnail/Thumbnail.tsx
 import { forwardRef as forwardRef37, useState as useState26, useRef as useRef24, useCallback as useCallback20, useMemo as useMemo17 } from "react";
 import styled106 from "styled-components";
-import { isNil as isNil18, isNotNil as isNotNil43, isUndefined as isUndefined7, isEmptyString as isEmptyString2, isString as isString3 } from "@wistia/type-guards";
+import { isNil as isNil19, isNotNil as isNotNil43, isUndefined as isUndefined7, isEmptyString as isEmptyString2, isString as isString4 } from "@wistia/type-guards";
 
 // src/private/helpers/getBackgroundGradient/getBackgroundGradient.ts
 import { isNotNil as isNotNil41 } from "@wistia/type-guards";
@@ -17785,7 +17835,7 @@ var StyledThumbnail = styled106.div`
   background-image: ${({ $backgroundUrl }) => isNotNil43($backgroundUrl) ? `url('${$backgroundUrl}')` : void 0};
   ${({ $backgroundUrl, $gradientBackground }) => (
   // if we don't have $backgroundUrl show a gradient
-  isNil18($backgroundUrl) ? getBackgroundGradient($gradientBackground) : void 0
+  isNil19($backgroundUrl) ? getBackgroundGradient($gradientBackground) : void 0
 )};
   background-position: center center;
   background-size: cover;
@@ -17817,7 +17867,7 @@ var StoryboardRenderer = ({
     frameCount,
     aspectRatio
   } = storyboard;
-  const targetWidth = isString3(width) ? parseInt(width, 10) : Number(width);
+  const targetWidth = isString4(width) ? parseInt(width, 10) : Number(width);
   const effectiveCursorPosition = isStoryboardReady ? cursorPosition : null;
   return /* @__PURE__ */ jsx325(
     ThumbnailStoryboardViewer,
@@ -17894,7 +17944,7 @@ var Thumbnail = forwardRef37(
       setCursorPosition(null);
     }, [isScrubbable]);
     const shouldRenderStoryboard = useMemo17(() => {
-      if (isNil18(storyboard) || isUndefined7(height) || isEmptyString2(height)) {
+      if (isNil19(storyboard) || isUndefined7(height) || isEmptyString2(height)) {
         return false;
       }
       return isScrubbable && isMouseOver && isStoryboardReady;