@vectara/vectara-ui 16.7.0 → 16.9.0

package/lib/components/button/BaseButton.d.ts

@@ -26,6 +26,7 @@ export type BaseButtonProps = {
     isSubmit?: boolean;
     isLoading?: boolean;
     truncate?: boolean;
+    "aria-label"?: string;
 };
 export declare const BaseButton: import("react").ForwardRefExoticComponent<BaseButtonProps & {
     spinnerColor?: "accent" | "primary" | "success" | "warning" | "danger" | "subdued" | "empty" | "dark" | undefined;

package/lib/components/button/BaseButton.js

@@ -15,6 +15,7 @@ import classNames from "classnames";
 import { getTrackingProps } from "../../utils/getTrackingProps";
 import { useVuiContext } from "../context/Context";
 import { VuiSpinner } from "../spinner/Spinner";
+import { VuiTooltip } from "../tooltip/Tooltip";
 const alignToClassMap = {
     left: "vuiBaseButton--alignLeft",
     center: "vuiBaseButton--alignCenter",
@@ -27,12 +28,13 @@ const sizeToSpinnerSizeMap = {
     l: "m"
 };
 export const BaseButton = forwardRef((_a, ref) => {
-    var { children, icon, iconSide = "left", align = "center", className, size = "m", fullWidth, onClick, onMouseOver, onMouseOut, onMouseMove, tabIndex, isInert, isDisabled, href, target, track, htmlFor, isSubmit, isLoading, spinnerColor, truncate } = _a, rest = __rest(_a, ["children", "icon", "iconSide", "align", "className", "size", "fullWidth", "onClick", "onMouseOver", "onMouseOut", "onMouseMove", "tabIndex", "isInert", "isDisabled", "href", "target", "track", "htmlFor", "isSubmit", "isLoading", "spinnerColor", "truncate"]);
+    var { children, icon, iconSide = "left", align = "center", className, size = "m", fullWidth, onClick, onMouseOver, onMouseOut, onMouseMove, tabIndex, isInert, isDisabled, href, target, track, htmlFor, isSubmit, isLoading, spinnerColor, truncate, "aria-label": ariaLabel } = _a, rest = __rest(_a, ["children", "icon", "iconSide", "align", "className", "size", "fullWidth", "onClick", "onMouseOver", "onMouseOut", "onMouseMove", "tabIndex", "isInert", "isDisabled", "href", "target", "track", "htmlFor", "isSubmit", "isLoading", "spinnerColor", "truncate", "aria-label"]);
     const { createLink } = useVuiContext();
     const classes = classNames("vuiBaseButton", className, `vuiBaseButton--${size}`, alignToClassMap[align], {
         "vuiBaseButton-isInert": isInert,
         "vuiBaseButton-isDisabled": isDisabled,
         "vuiBaseButton--fullWidth": fullWidth,
+        "vuiBaseButton--truncate": truncate,
         [`vuiBaseButton--${isLoading ? "left" : iconSide}`]: (Boolean(icon) || isLoading) && Boolean(children)
     });
     let iconContainer;
@@ -42,33 +44,40 @@ export const BaseButton = forwardRef((_a, ref) => {
     else if (icon) {
         iconContainer = _jsx("span", Object.assign({ className: "vuiBaseButtonIconContainer" }, { children: icon }));
     }
-    // This is useful for controlling other elements, e.g. creating an <input type="file" />
-    // for uploading files and adding a button to trigger it.
+    let button;
     if (htmlFor) {
-        return (_jsxs("label", Object.assign({ htmlFor: htmlFor, className: classes, tabIndex: tabIndex }, rest, { children: [iconContainer, children] })));
+        // This is useful for controlling other elements, e.g. creating an <input type="file" />
+        // for uploading files and adding a button to trigger it.
+        button = (_jsxs("label", Object.assign({ "aria-label": ariaLabel, htmlFor: htmlFor, className: classes, tabIndex: tabIndex }, rest, { children: [iconContainer, children] })));
     }
-    // Anchor tags can't be disabled, so we'll just render a button instead
-    // if isDisabled is true.
-    if (href && !isDisabled) {
+    else if (href && !isDisabled) {
+        // Anchor tags can't be disabled, so we'll just render a button instead
+        // if isDisabled is true.
         const wrapperClasses = classNames("vuiBaseButtonLinkWrapper", {
             "vuiBaseButtonLinkWrapper--fullWidth": fullWidth
         });
-        return createLink(Object.assign(Object.assign({ className: wrapperClasses, href,
+        button = createLink(Object.assign(Object.assign({ className: wrapperClasses, href,
             onClick,
             onMouseOver,
             onMouseOut,
             onMouseMove, children: (
             //* Wrap a button otherwise the flex layout breaks */}
-            _jsxs("button", Object.assign({ className: classes, tabIndex: -1, ref: ref }, { children: [iconContainer, children] }))), target,
+            _jsxs("button", Object.assign({ "aria-label": ariaLabel, className: classes, tabIndex: -1, ref: ref }, { children: [iconContainer, children] }))), target,
             tabIndex }, rest), getTrackingProps(track)));
     }
-    const labelClasses = classNames({
-        "vuiBaseButtonLabel--truncate": truncate
-    });
-    const props = Object.assign({ onClick,
-        onMouseOver,
-        onMouseOut,
-        onMouseMove,
-        tabIndex, type: isSubmit ? "submit" : "button", disabled: isDisabled }, rest);
-    return (_jsxs("button", Object.assign({ className: classes }, props, { ref: ref }, { children: [iconContainer, _jsx("span", Object.assign({ className: labelClasses }, { children: children }))] })));
+    else {
+        const labelClasses = classNames({
+            "vuiBaseButtonLabel--truncate": truncate
+        });
+        const props = Object.assign({ onClick,
+            onMouseOver,
+            onMouseOut,
+            onMouseMove,
+            tabIndex, type: isSubmit ? "submit" : "button", disabled: isDisabled }, rest);
+        button = (_jsxs("button", Object.assign({ "aria-label": ariaLabel, className: classes }, props, { ref: ref }, { children: [iconContainer, _jsx("span", Object.assign({ className: labelClasses }, { children: children }))] })));
+    }
+    if (ariaLabel) {
+        return _jsx(VuiTooltip, Object.assign({ tip: ariaLabel }, { children: button }));
+    }
+    return button;
 });

package/lib/components/button/baseButton.scss

@@ -70,6 +70,11 @@
   width: 100%;
 }
 
+.vuiBaseButton--truncate {
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
 // Size
 .vuiBaseButton--xs {
   font-size: $fontSizeSmall;

package/lib/components/form/textArea/TextArea.d.ts

@@ -2,6 +2,7 @@ type Props = React.DetailedHTMLProps<React.TextareaHTMLAttributes<HTMLTextAreaEl
     fullWidth?: boolean;
     isInvalid?: boolean;
     resizable?: boolean;
+    autoGrow?: boolean;
 };
 export declare const VuiTextArea: import("react").ForwardRefExoticComponent<Omit<Props, "ref"> & import("react").RefAttributes<HTMLTextAreaElement | null>>;
 export {};

package/lib/components/form/textArea/TextArea.js

@@ -10,14 +10,39 @@ var __rest = (this && this.__rest) || function (s, e) {
     return t;
 };
 import { jsx as _jsx } from "react/jsx-runtime";
-import { forwardRef } from "react";
+import { forwardRef, useLayoutEffect, useRef } from "react";
 import classNames from "classnames";
 export const VuiTextArea = forwardRef((_a, ref) => {
-    var { className, fullWidth, isInvalid, resizable } = _a, rest = __rest(_a, ["className", "fullWidth", "isInvalid", "resizable"]);
+    var { className, fullWidth, isInvalid, resizable, autoGrow } = _a, rest = __rest(_a, ["className", "fullWidth", "isInvalid", "resizable", "autoGrow"]);
     const classes = classNames("vuiTextArea", {
         "vuiTextArea-isInvalid": isInvalid,
-        "vuiTextArea--fullWidth": fullWidth
+        "vuiTextArea--fullWidth": fullWidth,
+        "vuiTextArea--autoGrow": autoGrow
     }, className);
     const style = Object.assign(Object.assign({}, rest.style), { resize: resizable ? "vertical" : "none" });
-    return _jsx("textarea", Object.assign({}, rest, { ref: ref, className: classes, style: style }));
+    const internalRef = useRef(null);
+    const setRefs = (el) => {
+        internalRef.current = el;
+        if (typeof ref === "function")
+            ref(el);
+        else if (ref)
+            ref.current = el;
+    };
+    // Auto-grow the textarea to fit its content. Reset to "auto" first so
+    // scrollHeight reflects the natural height after deletions, not the
+    // previously-set inline height.
+    useLayoutEffect(() => {
+        if (!autoGrow)
+            return;
+        const el = internalRef.current;
+        if (!el)
+            return;
+        el.style.height = "auto";
+        // scrollHeight excludes borders, but with box-sizing: border-box the
+        // assigned height includes them — without this offset the content would
+        // overflow by the border width and show a spurious scrollbar.
+        const borderY = el.offsetHeight - el.clientHeight;
+        el.style.height = `${el.scrollHeight + borderY}px`;
+    }, [autoGrow, rest.value]);
+    return _jsx("textarea", Object.assign({}, rest, { ref: setRefs, className: classes, style: style }));
 });

package/lib/components/form/textArea/_index.scss

@@ -16,3 +16,9 @@
 .vuiTextArea--fullWidth {
   width: 100%;
 }
+
+.vuiTextArea--autoGrow {
+  min-height: 0;
+  line-height: 1.6;
+  max-height: 12rem;
+}

package/lib/styles/index.css

@@ -749,6 +749,11 @@ fieldset {
   width: 100%;
 }
 
+.vuiBaseButton--truncate {
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
 .vuiBaseButton--xs {
   font-size: 12px;
   padding: 4px 8px;
@@ -3007,6 +3012,12 @@ h2.react-datepicker__current-month {
   width: 100%;
 }
 
+.vuiTextArea--autoGrow {
+  min-height: 0;
+  line-height: 1.6;
+  max-height: 12rem;
+}
+
 .vuiGridContainer {
   container-type: inline-size;
   width: 100%;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vectara/vectara-ui",
-  "version": "16.7.0",
+  "version": "16.9.0",
   "homepage": "./",
   "description": "Vectara's design system, codified as a React and Sass component library",
   "author": "Vectara",

package/src/docs/pages/button/Icons.tsx

@@ -18,7 +18,7 @@ export const Icons = () => {
       </Subsection>
 
       <Subsection title="Icon only">
-        <VuiButtonPrimary icon={icon} color="primary" size="m" />
+        <VuiButtonPrimary icon={icon} color="primary" size="m" aria-label="Add to favorites" />
       </Subsection>
     </>
   );

package/src/docs/pages/button/Truncate.tsx

@@ -13,7 +13,7 @@ export const Truncate = () => {
           </VuiIcon>
         }
       >
-        A very long label that will get truncated
+        A very long label that will get truncated eventually if the text is long enough
       </VuiButtonSecondary>
     </div>
   );

package/src/docs/pages/textArea/TextAreaAutoGrow.tsx

@@ -0,0 +1,18 @@
+import { useState } from "react";
+import { VuiTextArea } from "../../../lib";
+
+export const TextAreaAutoGrow = () => {
+  const [value, setValue] = useState<string | undefined>();
+
+  return (
+    <VuiTextArea
+      id="autoGrowTextArea"
+      value={value}
+      onChange={(event) => setValue(event.target.value)}
+      autoGrow
+      rows={1}
+      fullWidth
+      placeholder="Type a few lines — the textarea grows to fit its content"
+    />
+  );
+};

package/src/docs/pages/textArea/index.tsx

@@ -1,8 +1,10 @@
 import { TextArea } from "./TextArea";
 import { TextAreaResizeable } from "./TextAreaResizeable";
+import { TextAreaAutoGrow } from "./TextAreaAutoGrow";
 
 const TextAreaSource = require("!!raw-loader!./TextArea");
 const TextAreaResizeableSource = require("!!raw-loader!./TextAreaResizeable");
+const TextAreaAutoGrowSource = require("!!raw-loader!./TextAreaAutoGrow");
 
 export const textArea = {
   name: "Text Area",
@@ -17,6 +19,11 @@ export const textArea = {
       name: "Resizable Text Area",
       component: <TextAreaResizeable />,
       source: TextAreaResizeableSource.default.toString()
+    },
+    {
+      name: "Auto-Grow Text Area",
+      component: <TextAreaAutoGrow />,
+      source: TextAreaAutoGrowSource.default.toString()
     }
   ]
 };