@spscommerce/ds-react 5.21.4 → 5.23.0

package/lib/index.es.js

@@ -23469,14 +23469,14 @@ const SpsFocusedTaskExamples = {
                               <div className="sfg-row">
                                 <div className="sfg-col-3"></div>
                                 <div className="sfg-col-6">
-                                  <SpsCard>
+                                  <SpsCardV2>
                                     <i>pretend there's a form here</i>
-                                  </SpsCard>
+                                  </SpsCardV2>
                                 </div>
                                 <div className="sfg-col-3"></div>
                               </div>
                               <SpsFocusedTaskActions>
-                                <SpsButton kind="confirm" onClick={onFormSubmit}>
+                                <SpsButton kind={ButtonKind.CONFIRM} onClick={onFormSubmit}>
                                   Submit
                                 </SpsButton>
                               </SpsFocusedTaskActions>
@@ -23510,14 +23510,14 @@ const SpsFocusedTaskExamples = {
                             <div className="sfg-row">
                                 <div className="sfg-col-3"></div>
                                 <div className="sfg-col-6">
-                                <SpsCard>
+                                <SpsCardV2>
                                     <i>pretend there's a form here</i>
-                                </SpsCard>
+                                </SpsCardV2>
                                 </div>
                                 <div className="sfg-col-3"></div>
                             </div>
                             <SpsFocusedTaskActions>
-                                <SpsButton kind="confirm" onClick={onFormSubmit}>
+                                <SpsButton kind={ButtonKind.CONFIRM} onClick={onFormSubmit}>
                                 Submit
                                 </SpsButton>
                             </SpsFocusedTaskActions>
@@ -25238,27 +25238,27 @@ const SpsInsightTileExamples = {
         jsx: code`
                     <SpsInsights>
                         <SpsInsightTile
-                            kind={SpsInsightCardKind.GENERAL}
+                            kind={SpsInsightTileKind.GENERAL}
                             metric="1234"
                             title="Insight Tile Title"
                         />
                         <SpsInsightTile
-                            kind={SpsInsightCardKind.PROCESSING}
+                            kind={SpsInsightTileKind.PROCESSING}
                             metric="1234"
                             title="Insight Tile Title"
                         />
                         <SpsInsightTile
-                            kind={SpsInsightCardKind.SUCCESS}
+                            kind={SpsInsightTileKind.SUCCESS}
                             metric="1234"
                             title="Insight Tile Title"
                         />
                         <SpsInsightTile
-                            kind={SpsInsightCardKind.WARNING}
+                            kind={SpsInsightTileKind.WARNING}
                             metric="1234"
                             title="Insight Tile Title"
                         />
                         <SpsInsightTile
-                            kind={SpsInsightCardKind.ERROR}
+                            kind={SpsInsightTileKind.ERROR}
                             metric="1234"
                             title="Insight Tile Title"
                         />
@@ -25274,49 +25274,49 @@ const SpsInsightTileExamples = {
         jsx: code`
                     <SpsInsights>
                         <SpsInsightTile
-                            kind={SpsInsightCardKind.GENERAL}
+                            kind={SpsInsightTileKind.GENERAL}
                             metric="1234"
                             title="Insight Tile Title"
                         >
                             <span className="gray600 font-weight-bold">Detail:</span> 792 units
                         </SpsInsightTile>
                         <SpsInsightTile
-                            kind={SpsInsightCardKind.PROCESSING}
+                            kind={SpsInsightTileKind.PROCESSING}
                             metric="1234"
                             title="Insight Tile Title"
                         >
                             <span className="gray600 font-weight-bold">Detail:</span> 792 units
                         </SpsInsightTile>
                         <SpsInsightTile
-                            kind={SpsInsightCardKind.SUCCESS}
+                            kind={SpsInsightTileKind.SUCCESS}
                             metric="1234"
                             title="Insight Tile Title"
                         >
                             <span className="gray600 font-weight-bold">Detail:</span> 792 units
                         </SpsInsightTile>
                         <SpsInsightTile
-                            kind={SpsInsightCardKind.WARNING}
+                            kind={SpsInsightTileKind.WARNING}
                             metric="1234"
                             title="Insight Tile Title"
                         >
                             <span className="gray600 font-weight-bold">Detail:</span> 792 units
                         </SpsInsightTile>
                         <SpsInsightTile
-                            kind={SpsInsightCardKind.ERROR}
+                            kind={SpsInsightTileKind.ERROR}
                             metric="1234"
                             title="Insight Tile Title"
                         >
                             <span className="gray600 font-weight-bold">Detail:</span> 792 units
                         </SpsInsightTile>
                         <SpsInsightTile
-                            kind={SpsInsightCardKind.SUCCESS}
+                            kind={SpsInsightTileKind.SUCCESS}
                             metric="1234"
                             title="Insight Tile Title"
                         >
                             <span className="gray600 font-weight-bold">Detail:</span> 792 units
                         </SpsInsightTile>
                         <SpsInsightTile
-                            kind={SpsInsightCardKind.ERROR}
+                            kind={SpsInsightTileKind.ERROR}
                             metric="1234"
                             title="Insight Tile Title"
                         >
@@ -25334,35 +25334,35 @@ const SpsInsightTileExamples = {
         jsx: code`
                     <SpsInsights>
                         <SpsInsightTile
-                            kind={SpsInsightCardKind.GENERAL}
+                            kind={SpsInsightTileKind.GENERAL}
                             metric="1234"
                             title="Insight Tile Title"
                             partnerCount="250"
                             totalPartners="250"
                         />
                         <SpsInsightTile
-                            kind={SpsInsightCardKind.PROCESSING}
+                            kind={SpsInsightTileKind.PROCESSING}
                             metric="1234"
                             title="Insight Tile Title"
                             partnerCount="122"
                             totalPartners="250"
                         />
                         <SpsInsightTile
-                            kind={SpsInsightCardKind.SUCCESS}
+                            kind={SpsInsightTileKind.SUCCESS}
                             metric="1234"
                             title="Insight Tile Title"
                             partnerCount="207"
                             totalPartners="250"
                         />
                         <SpsInsightTile
-                            kind={SpsInsightCardKind.WARNING}
+                            kind={SpsInsightTileKind.WARNING}
                             metric="1234"
                             title="Insight Tile Title"
                             partnerCount="12"
                             totalPartners="250"
                         />
                         <SpsInsightTile
-                            kind={SpsInsightCardKind.ERROR}
+                            kind={SpsInsightTileKind.ERROR}
                             metric="1234"
                             title="Insight Tile Title"
                             partnerCount="94"
@@ -25380,19 +25380,19 @@ const SpsInsightTileExamples = {
         jsx: code`
                     <SpsInsights>
                         <SpsInsightTile
-                            kind={SpsInsightCardKind.GENERAL}
+                            kind={SpsInsightTileKind.GENERAL}
                             metric="1234"
                             title="Insight Tile Title"
                             onClick={() => console.log("insight tile 1 clicked!")}
                         />
                         <SpsInsightTile
-                            kind={SpsInsightCardKind.GENERAL}
+                            kind={SpsInsightTileKind.GENERAL}
                             metric="1234"
                             title="Insight Tile Title"
                             onClick={() => console.log("insight tile 2 clicked!")}
                         />
                         <SpsInsightTile
-                            kind={SpsInsightCardKind.GENERAL}
+                            kind={SpsInsightTileKind.GENERAL}
                             metric="1234"
                             title="Insight Tile Title"
                             onClick={() => console.log("insight tile 3 clicked!")}
@@ -25409,31 +25409,31 @@ const SpsInsightTileExamples = {
         jsx: code`
                     <SpsInsights>
                         <SpsInsightTile
-                            kind={SpsInsightCardKind.GENERAL}
+                            kind={SpsInsightTileKind.GENERAL}
                             metric="1234"
                             title="Insight Tile Title"
                             icon={SpsIcon.USER}
                         />
                         <SpsInsightTile
-                            kind={SpsInsightCardKind.PROCESSING}
+                            kind={SpsInsightTileKind.PROCESSING}
                             metric="1234"
                             title="Insight Tile Title"
                             icon={SpsIcon.ASTERISK}
                         />
                         <SpsInsightTile
-                            kind={SpsInsightCardKind.SUCCESS}
+                            kind={SpsInsightTileKind.SUCCESS}
                             metric="1234"
                             title="Insight Tile Title"
                             icon={SpsIcon.DOLLAR_SIGN}
                         />
                         <SpsInsightTile
-                            kind={SpsInsightCardKind.WARNING}
+                            kind={SpsInsightTileKind.WARNING}
                             metric="1234"
                             title="Insight Tile Title"
                             icon={SpsIcon.FOLDER_OPEN}
                         />
                         <SpsInsightTile
-                            kind={SpsInsightCardKind.ERROR}
+                            kind={SpsInsightTileKind.ERROR}
                             metric="1234"
                             title="Insight Tile Title"
                             icon={SpsIcon.BAN}
@@ -25450,7 +25450,7 @@ const SpsInsightTileExamples = {
         jsx: code`
                     <SpsInsights>
                         <SpsInsightTile
-                            kind={SpsInsightCardKind.GENERAL}
+                            kind={SpsInsightTileKind.GENERAL}
                             metric="1234"
                             title="Insight Tile Title"
                             partnerCount="100"
@@ -25460,7 +25460,7 @@ const SpsInsightTileExamples = {
                             <span className="gray600 font-weight-bold">Detail:</span> 792 units
                         </SpsInsightTile>
                         <SpsInsightTile
-                            kind={SpsInsightCardKind.PROCESSING}
+                            kind={SpsInsightTileKind.PROCESSING}
                             metric="1234"
                             title="Insight Tile Title"
                             partnerCount="100"
@@ -25468,7 +25468,7 @@ const SpsInsightTileExamples = {
                             horizontal
                         />
                         <SpsInsightTile
-                            kind={SpsInsightCardKind.SUCCESS}
+                            kind={SpsInsightTileKind.SUCCESS}
                             metric="1234"
                             title="Insight Tile Title"
                             partnerCount="100"
@@ -25478,7 +25478,7 @@ const SpsInsightTileExamples = {
                             <span className="gray600 font-weight-bold">Detail:</span> 792 units
                         </SpsInsightTile>
                         <SpsInsightTile
-                            kind={SpsInsightCardKind.WARNING}
+                            kind={SpsInsightTileKind.WARNING}
                             metric="1234"
                             title="Insight Tile Title"
                             partnerCount="100"
@@ -25486,7 +25486,7 @@ const SpsInsightTileExamples = {
                             horizontal
                         />
                         <SpsInsightTile
-                            kind={SpsInsightCardKind.ERROR}
+                            kind={SpsInsightTileKind.ERROR}
                             metric="1234"
                             title="Insight Tile Title"
                             partnerCount="100"
@@ -26166,6 +26166,8 @@ const usePinnedTableBackgroundStyle = (containerRef) => {
   React.useLayoutEffect(() => {
     if (containerRef.current) {
       const pinnedThs = containerRef.current.querySelectorAll("table > thead > tr:first-child > .sps-table__cell--pinned");
+      const verticalScrollbarWidth = containerRef.current.offsetWidth - containerRef.current.clientWidth;
+      const horizontalScrollbarHeight = containerRef.current.offsetHeight - containerRef.current.clientHeight;
       if (pinnedThs.length > 0) {
         const leftPinnedThs = [];
         const rightPinnedThs = [];
@@ -26187,12 +26189,18 @@ const usePinnedTableBackgroundStyle = (containerRef) => {
         });
         const leftPinnedWidth = leftPinnedThs.reduce((acc, th) => acc + th.clientWidth, 0);
         const rightPinnedWidth = rightPinnedThs.reduce((acc, th) => acc + th.clientWidth, 0);
-        containerRef.current.style.backgroundPosition = `${leftPinnedWidth}px 0, calc(100% - ${rightPinnedWidth}px) 0, ${leftPinnedWidth}px 0, calc(100% - ${rightPinnedWidth}px) 0`;
+        containerRef.current.style.backgroundPosition = `${leftPinnedWidth}px 0,
+          calc(100% - ${rightPinnedWidth}px) 0, 
+          ${leftPinnedWidth}px ${-horizontalScrollbarHeight}px,
+          calc(100% - ${rightPinnedWidth + verticalScrollbarWidth}px) ${-horizontalScrollbarHeight}px`;
+      } else {
+        containerRef.current.style.backgroundPosition = `0 0, 100% 0, 0 ${-horizontalScrollbarHeight}px, 
+          calc(100% - ${verticalScrollbarWidth}px) ${-horizontalScrollbarHeight}px`;
       }
     }
   });
 };
-const usePinnedTableHeadStyle = (containerRef) => {
+const usePinnedTableHeadStyle = (containerRef, maxHeight) => {
   React.useLayoutEffect(() => {
     const container = containerRef.current;
     const headElement = container == null ? void 0 : container.querySelector("thead");
@@ -26205,8 +26213,8 @@ const usePinnedTableHeadStyle = (containerRef) => {
     let scrollableParent = null;
     const resetAppliedStyles = () => {
       if (headElement) {
-        headElement.style.position = null;
-        headElement.style.top = null;
+        headElement.style.position = maxHeight ? "sticky" : null;
+        headElement.style.top = maxHeight ? "0" : null;
         headElement.style.overflow = null;
         headElement.style.maxWidth = null;
         headElement.style.width = null;
@@ -26244,7 +26252,8 @@ const usePinnedTableHeadStyle = (containerRef) => {
         headElement.style.position = "fixed";
         headElement.style.top = `${topPosition}px`;
         headElement.style.overflow = "hidden";
-        const headElementWidth = `${containerRect.width}px`;
+        const verticalScrollbarWidth = containerRef.current.offsetWidth - containerRef.current.clientWidth;
+        const headElementWidth = `${containerRect.width - verticalScrollbarWidth}px`;
         headElement.style.maxWidth = headElementWidth;
         headElement.style.width = headElementWidth;
         headElement.style.minWidth = headElementWidth;
@@ -26299,6 +26308,52 @@ const usePinnedTableHeadStyle = (containerRef) => {
     };
   });
 };
+const useMaxHeightTableStyle = (containerRef, maxHeight) => {
+  const applyVerticalScrollShadow = () => {
+    const container = containerRef.current;
+    const tableHead = container == null ? void 0 : container.querySelector("table > thead");
+    const table = container == null ? void 0 : container.querySelector("table");
+    const shadowTop = container == null ? void 0 : container.querySelector(".shadow--top");
+    const shadowBottom = container == null ? void 0 : container.querySelector(".shadow--bottom");
+    if (tableHead && table && shadowTop && shadowBottom) {
+      shadowBottom.style.left = "0";
+      shadowBottom.style.bottom = "0";
+      shadowTop.style.left = "0";
+      const horizontalScrollbarHeight = container.offsetHeight - (container == null ? void 0 : container.clientHeight);
+      const tableHeight = table.getBoundingClientRect().height;
+      const tableHeadHeight = tableHead.getBoundingClientRect().height;
+      const containerScrollTop = container.scrollTop;
+      const containerScrollBottom = tableHeight + horizontalScrollbarHeight - container.getBoundingClientRect().height - container.scrollTop;
+      const containerScrollLeft = container.scrollLeft;
+      shadowBottom.style.bottom = `${-containerScrollTop}px`;
+      shadowBottom.style.left = `${containerScrollLeft}px`;
+      shadowBottom.style.opacity = containerScrollBottom > 0 ? "1" : "0";
+      shadowTop.style.top = `${containerScrollTop + tableHeadHeight}px`;
+      shadowTop.style.left = `${containerScrollLeft}px`;
+      shadowTop.style.opacity = containerScrollTop > 0 ? "1" : "0";
+    }
+  };
+  React.useLayoutEffect(() => {
+    if (containerRef.current && maxHeight) {
+      const tableHead = containerRef.current.querySelector("table > thead");
+      if (tableHead) {
+        tableHead.style.position = "sticky";
+        tableHead.style.top = "0";
+        tableHead.style.zIndex = "2";
+        tableHead.style.backgroundColor = "#fff";
+      }
+      containerRef.current.addEventListener("scroll", applyVerticalScrollShadow);
+      return () => {
+        containerRef.current.removeEventListener("scroll", applyVerticalScrollShadow);
+      };
+    }
+  }, []);
+  React.useLayoutEffect(() => {
+    if (containerRef.current && maxHeight) {
+      applyVerticalScrollShadow();
+    }
+  });
+};
 const propsDoc$13 = {
   controlCell: "boolean",
   currentSort: "Array<SortedColumn>",
@@ -26492,12 +26547,16 @@ Object.assign(SpsThead, {
 const propsDoc$10 = {
   sort: "SortedColumn",
   onSortChange: "SortChangeHandler",
-  selectable: "boolean"
+  selectable: "boolean",
+  maxHeightPx: "number",
+  maxHeightRem: "number"
 };
 const propTypes$13 = __spreadProps(__spreadValues({}, spsGlobalPropTypes), {
   onSortChange: fun(),
   sort: propTypes$1O.exports.arrayOf(impl()),
-  selectable: propTypes$1O.exports.bool
+  selectable: propTypes$1O.exports.bool,
+  maxHeightPx: propTypes$1O.exports.number,
+  maxHeightRem: propTypes$1O.exports.number
 });
 function SpsTable(props2) {
   const _a = props2, {
@@ -26506,14 +26565,18 @@ function SpsTable(props2) {
     onSortChange,
     sort,
     "data-testid": testId,
-    unsafelyReplaceClassName
+    unsafelyReplaceClassName,
+    maxHeightPx,
+    maxHeightRem
   } = _a, rest = __objRest(_a, [
     "children",
     "className",
     "onSortChange",
     "sort",
     "data-testid",
-    "unsafelyReplaceClassName"
+    "unsafelyReplaceClassName",
+    "maxHeightPx",
+    "maxHeightRem"
   ]);
   const [currentSort, setSort] = React.useState(sort);
   const updateSortingDisplay = (newSort) => {
@@ -26535,13 +26598,21 @@ function SpsTable(props2) {
     currentSort
   };
   const classes = clsx(unsafelyReplaceClassName || "sps-table-container", className);
+  const maxHeight = maxHeightPx ? maxHeightPx / 16 : maxHeightRem;
+  const tableContainerInlineStyles = maxHeight ? { maxHeight: `${maxHeight}rem` } : {};
   const containerRef = React.useRef(null);
+  useMaxHeightTableStyle(containerRef, maxHeight);
   usePinnedTableBackgroundStyle(containerRef);
-  usePinnedTableHeadStyle(containerRef);
+  usePinnedTableHeadStyle(containerRef, maxHeight);
   return /* @__PURE__ */ React.createElement("div", {
     ref: containerRef,
-    className: classes
-  }, /* @__PURE__ */ React.createElement("table", __spreadValues({
+    className: classes,
+    style: tableContainerInlineStyles
+  }, /* @__PURE__ */ React.createElement("div", {
+    className: "sps-table__shadow shadow--top"
+  }), /* @__PURE__ */ React.createElement("div", {
+    className: "sps-table__shadow shadow--bottom"
+  }), /* @__PURE__ */ React.createElement("table", __spreadValues({
     className: "sps-table",
     role: "table",
     "data-testid": `${testId}`
@@ -29190,7 +29261,7 @@ const SpsListToolbarExamples = {
                                         formMeta={formMeta.fields.searchText}
                                         placeholder="Search fields"
                                     />
-                                    <SpsButton kind="icon" icon="search" />
+                                    <SpsButton kind={ButtonKind.ICON} icon={SpsIcon.SEARCH} />
                                 </SpsListToolbarSearch>
                             </SpsListToolbar>
                         );
@@ -34806,7 +34877,8 @@ const propsDoc$v = {
   name: "string",
   onChange: "ChangeEventHandler<HTMLInputElement>",
   placeholder: "string",
-  value: "string"
+  value: "string",
+  additionalText: "string"
 };
 const propTypes$x = __spreadProps(__spreadValues({}, spsGlobalPropTypes), {
   disabled: propTypes$1O.exports.bool,
@@ -34816,7 +34888,8 @@ const propTypes$x = __spreadProps(__spreadValues({}, spsGlobalPropTypes), {
   name: propTypes$1O.exports.string,
   onChange: fun(),
   placeholder: propTypes$1O.exports.string,
-  value: propTypes$1O.exports.string
+  value: propTypes$1O.exports.string,
+  additionalText: propTypes$1O.exports.string
 });
 const SpsTextInput = React.forwardRef((_G, ref2) => {
   var _H = _G, {
@@ -34832,7 +34905,8 @@ const SpsTextInput = React.forwardRef((_G, ref2) => {
     "data-testid": testId,
     title,
     unsafelyReplaceClassName,
-    value = ""
+    value = "",
+    additionalText
   } = _H, rest = __objRest(_H, [
     "className",
     "disabled",
@@ -34846,7 +34920,8 @@ const SpsTextInput = React.forwardRef((_G, ref2) => {
     "data-testid",
     "title",
     "unsafelyReplaceClassName",
-    "value"
+    "value",
+    "additionalText"
   ]);
   const meta = formMeta || formControl2;
   const { wrapperId, controlId } = useFormControlId(id2, meta);
@@ -34897,7 +34972,9 @@ const SpsTextInput = React.forwardRef((_G, ref2) => {
     "data-testid": `${testId}__input_clear`,
     className: "sps-icon sps-icon-x-circle sps-form-control__clear-btn",
     onClick: clear
-  })));
+  })), additionalText && /* @__PURE__ */ React.createElement("p", {
+    className: "sps-input__additional-text"
+  }, additionalText));
 });
 Object.assign(SpsTextInput, {
   props: propsDoc$v,
@@ -34905,91 +34982,118 @@ Object.assign(SpsTextInput, {
   displayName: "SpsTextInput"
 });
 const SpsTextInputExamples = {
-  standard: {
-    label: "Standard",
-    description: "info about standard text inputs",
+  general: {
+    label: "General Usage",
+    description: ({ NavigateTo }) => /* @__PURE__ */ React.createElement(React.Fragment, null, /* @__PURE__ */ React.createElement("h5", null, "Use a Text Input:"), /* @__PURE__ */ React.createElement("ul", null, /* @__PURE__ */ React.createElement("li", null, "When the value required is short (a single word or short phrase)."), /* @__PURE__ */ React.createElement("li", null, "When only one value is required or accepted.")), /* @__PURE__ */ React.createElement("h5", null, "Do Not Use a Text Input:"), /* @__PURE__ */ React.createElement("ul", null, /* @__PURE__ */ React.createElement("li", null, "When a value of considerable length (such as a sentence or paragraph) is required or accepted. Use a ", /* @__PURE__ */ React.createElement(NavigateTo, {
+      to: "text-areas"
+    }, "Text Area"), " instead."), /* @__PURE__ */ React.createElement("li", null, "When more than one value is required or accepted in the field. Use", " ", /* @__PURE__ */ React.createElement(NavigateTo, {
+      to: "multi-select"
+    }, "Multi-Select"), " instead."), /* @__PURE__ */ React.createElement("li", null, "When a boolean selection is required (such as on/off, yes/no, etc). Use", " ", /* @__PURE__ */ React.createElement(NavigateTo, {
+      to: "checkbox"
+    }, "Checkboxes"), ",", " ", /* @__PURE__ */ React.createElement(NavigateTo, {
+      to: "radio-buttons"
+    }, "Radio Buttons"), " or", " ", /* @__PURE__ */ React.createElement(NavigateTo, {
+      to: "toggle"
+    }, "Toggles"), " instead.")))
+  },
+  basic: {
+    label: "Basic Text Inputs",
+    description: () => /* @__PURE__ */ React.createElement("p", null, "Basic Text Inputs include a label and an input field."),
     examples: {
       standard: {
         react: code`
                     function DemoComponent() {
-                        const { formValue, formMeta, updateForm } = useSpsForm({ foo: "bar" });
+                        const { formValue, formMeta, updateForm } = useSpsForm({ companyName: "" });
 
-                        return <>
-                            <SpsLabel for={formMeta.fields.foo}>Foo</SpsLabel>
-                            <SpsTextInput
-                                value={formValue.foo}
-                                formMeta={formMeta.fields.foo}
-                            />
-                        </>;
+                        return (
+                            <div className="sfg-row">
+                                <div className="sfg-col-4">
+                                    <SpsLabel for={formMeta.fields.companyName}>Company Name</SpsLabel>
+                                    <SpsTextInput
+                                        value={formValue.companyName}
+                                        formMeta={formMeta.fields.companyName}
+                                    />
+                                </div>
+                            </div>
+                        );
                     }
                 `
       }
     }
   },
-  b_placeholder: {
-    label: "Placeholder",
-    description: "info about text input placeholders",
+  placeholder: {
+    label: "Placeholder Text",
+    description: ({ NavigateTo }) => /* @__PURE__ */ React.createElement("p", null, "Certain inputs may benefit from placeholder text to aid the user in providing a valid value."),
     examples: {
       placeholder: {
         react: code`
                     function DemoComponent() {
-                        const { formValue, formMeta, updateForm } = useSpsForm({ foo: "bar" });
+                      const { formValue, formMeta, updateForm } = useSpsForm({ phoneNumber: "" });
 
-                        return <>
-                                <SpsLabel for={formMeta.fields.foo}>
-                                    Company Name
-                                </SpsLabel>
-                                <SpsTextInput formMeta={formMeta.fields.foo}
-                                    value={formValue.foo}
-                                    placeholder="Enter a company name"
-                                ></SpsTextInput>
-                            </>
+                      return (
+                          <div className="sfg-row">
+                              <div className="sfg-col-4">
+                                  <SpsLabel for={formMeta.fields.phoneNumber}>Phone Number</SpsLabel>
+                                  <SpsTextInput
+                                      value={formValue.phoneNumber}
+                                      formMeta={formMeta.fields.phoneNumber}
+                                      placeholder="(000) 000-0000"
+                                  />
+                              </div>
+                          </div>
+                      );
                     }
                 `
       }
     }
   },
-  c_description: {
-    label: "Description",
-    description: "info about text inputs with descriptions",
+  additional_text: {
+    label: "Additional Descriptive Text",
+    description: ({ NavigateTo }) => /* @__PURE__ */ React.createElement("p", null, "For occasions when additional context beyond a placeholder is required, text in the form of a short phrase can appear below the input."),
     examples: {
-      description: {
+      placeholder: {
         react: code`
                     function DemoComponent() {
-                        const { formValue, formMeta, updateForm } = useSpsForm({ foo: "bar" });
+                      const { formValue, formMeta, updateForm } = useSpsForm({ password: "" });
 
-                        return <>
-                                <SpsLabel for={formMeta.fields.foo}
-                                    value={formValue.foo}
-                                    description="This is a brief description of the field to provide additional context."
-                                >
-                                    Label
-                                </SpsLabel>
-                                <SpsTextInput formMeta={formMeta.fields.foo}/>
-                            </>
+                      return (
+                          <div className="sfg-row">
+                              <div className="sfg-col-4">
+                                  <SpsLabel for={formMeta.fields.password}>Password</SpsLabel>
+                                  <SpsTextInput
+                                      value={formValue.password}
+                                      formMeta={formMeta.fields.password}
+                                      additionalText="Password must be 8-12 characters in length and include: 1 capital letter, 1 number and 1 special character"
+                                  />
+                              </div>
+                          </div>
+                      );
                     }
                 `
       }
     }
   },
-  d_disabled: {
-    label: "Disabled",
-    description: "info about disabled text inputs",
+  disabled: {
+    label: "Disabled State",
+    description: () => /* @__PURE__ */ React.createElement("p", null, "The Disabled State prevents a user from modifying the text input while still allowing visibility to its information."),
     examples: {
-      disabled: {
+      standard: {
         react: code`
                     function DemoComponent() {
-                        const { formValue, formMeta, updateForm } = useSpsForm({ email: "foo@bar.com" });
+                        const { formValue, formMeta, updateForm } = useSpsForm({ companyName: "FGL Sports" });
 
-                        return <>
-                                <SpsLabel for={formMeta.fields.email}>
-                                    Email Address
-                                </SpsLabel>
-                                <SpsTextInput id="disabledTextInput" disabled
-                                    value={formValue.email}
-                                    formMeta={formMeta.fields.email}
-                                ></SpsTextInput>
-                            </>
+                        return (
+                            <div className="sfg-row">
+                                <div className="sfg-col-4">
+                                    <SpsLabel for={formMeta.fields.companyName}>Company Name</SpsLabel>
+                                    <SpsTextInput
+                                        value={formValue.companyName}
+                                        formMeta={formMeta.fields.companyName}
+                                        disabled
+                                    />
+                                </div>
+                            </div>
+                        );
                     }
                 `
       }
@@ -35003,7 +35107,8 @@ const propsDoc$u = {
   onChange: "ChangeEventHandler",
   placeholder: "string",
   rows: "number",
-  value: "string"
+  value: "string",
+  additionalText: "string"
 };
 const propTypes$w = __spreadProps(__spreadValues({}, spsGlobalPropTypes), {
   disabled: propTypes$1O.exports.bool,
@@ -35014,7 +35119,8 @@ const propTypes$w = __spreadProps(__spreadValues({}, spsGlobalPropTypes), {
   placeholder: propTypes$1O.exports.string,
   ref: ref(),
   rows: propTypes$1O.exports.number,
-  value: propTypes$1O.exports.string
+  value: propTypes$1O.exports.string,
+  additionalText: propTypes$1O.exports.string
 });
 function SpsTextarea(_I) {
   var _J = _I, {
@@ -35030,7 +35136,8 @@ function SpsTextarea(_I) {
     rows = 2,
     "data-testid": testId,
     unsafelyReplaceClassName,
-    value = ""
+    value = "",
+    additionalText
   } = _J, rest = __objRest(_J, [
     "className",
     "disabled",
@@ -35044,7 +35151,8 @@ function SpsTextarea(_I) {
     "rows",
     "data-testid",
     "unsafelyReplaceClassName",
-    "value"
+    "value",
+    "additionalText"
   ]);
   const meta = formMeta || formControl2;
   const { wrapperId, controlId } = useFormControlId(id2, meta);
@@ -35092,7 +35200,9 @@ function SpsTextarea(_I) {
     "data-testid": `${testId}__input_clear`,
     className: "sps-icon sps-icon-x-circle sps-form-control__clear-btn",
     onClick: clear
-  })));
+  })), additionalText && /* @__PURE__ */ React.createElement("p", {
+    className: "sps-input__additional-text"
+  }, additionalText));
 }
 Object.assign(SpsTextarea, {
   props: propsDoc$u,
@@ -35100,101 +35210,119 @@ Object.assign(SpsTextarea, {
   displayName: "SpsTextarea"
 });
 const SpsTextareaExamples = {
+  general: {
+    label: "General Usage",
+    description: ({ NavigateTo }) => /* @__PURE__ */ React.createElement(React.Fragment, null, /* @__PURE__ */ React.createElement("h5", null, "Use a Text Area:"), /* @__PURE__ */ React.createElement("ul", null, /* @__PURE__ */ React.createElement("li", null, "When a value of considerable length (such as a sentence or paragraph) is required or accepted.")), /* @__PURE__ */ React.createElement("h5", null, "Do Not Use a Text Area:"), /* @__PURE__ */ React.createElement("ul", null, /* @__PURE__ */ React.createElement("li", null, "When the value required is short (a single word or short phrase). Use a", " ", /* @__PURE__ */ React.createElement(NavigateTo, {
+      to: "text-inputs"
+    }, "Text Input"), " instead."), /* @__PURE__ */ React.createElement("li", null, "When more than one value is required or accepted in the field. Use", " ", /* @__PURE__ */ React.createElement(NavigateTo, {
+      to: "multi-select"
+    }, "Multi-Select"), " instead."), /* @__PURE__ */ React.createElement("li", null, "When a boolean selection is required (such as on/off, yes/no, etc). Use", " ", /* @__PURE__ */ React.createElement(NavigateTo, {
+      to: "checkbox"
+    }, "Checkboxes"), ",", " ", /* @__PURE__ */ React.createElement(NavigateTo, {
+      to: "radio-buttons"
+    }, "Radio Buttons"), " or", " ", /* @__PURE__ */ React.createElement(NavigateTo, {
+      to: "toggle"
+    }, "Toggles"), " instead.")))
+  },
   basic: {
-    label: "Basic",
-    description: "info about basic text areas",
+    label: "Basic Text Areas",
+    description: () => /* @__PURE__ */ React.createElement("p", null, "Basic Text Areas include a label and a large input field. By default a Text Area is three lines tall, but the height can be adjusted."),
     examples: {
-      basic: {
+      standard: {
         react: code`
                     function DemoComponent() {
-                        function numLinesValidator(n) {
-                            return function(value) {
-                                const lines = typeof value === "string" ? value.split("\\n").length : 0;
-                                if (lines !== n) {
-                                    return {
-                                        numLines: {
-                                            actualLines: lines,
-                                            requiredLines: n
-                                        }
-                                    };
-                                }
-                                return null;
-                            };
-                        }
+                        const { formValue, formMeta, updateForm } = useSpsForm({ notes: "" });
 
-                        const { formValue, formMeta, updateForm } = useSpsForm({
-                            haiku: ""
-                        }, {
-                            "haiku": [numLinesValidator(3)]
-                        });
+                        return (
+                            <div className="sfg-row">
+                                <div className="sfg-col-4">
+                                    <SpsLabel for={formMeta.fields.notes}>Notes</SpsLabel>
+                                    <SpsTextarea
+                                        value={formValue.notes}
+                                        formMeta={formMeta.fields.notes}
+                                        rows={5}
+                                    />
+                                </div>
+                            </div>
+                        );
+                    }
+                `
+      }
+    }
+  },
+  placeholder: {
+    label: "Placeholder Text",
+    description: ({ NavigateTo }) => /* @__PURE__ */ React.createElement("p", null, "Certain inputs may benefit from placeholder text to aid the user in providing a valid value."),
+    examples: {
+      placeholder: {
+        react: code`
+                    function DemoComponent() {
+                      const { formValue, formMeta, updateForm } = useSpsForm({ companyDescription: "" });
 
-                        return <>
-                            <SpsLabel for={formMeta.fields.haiku}
-                                help="A haiku is a three-line poem of 5, 7, and 5 syllables respectively."
-                                errors={() =>
-                                    formMeta.fields.haiku.hasError("numLines") && (
-                                        <>
-                                        You need {formMeta.fields.haiku.errors["numLines"].requiredLines} lines,
-                                        but you've only written {formMeta.fields.haiku.errors["numLines"].actualLines} lines!
-                                    </>
-                                )
-                            }>
-                                Haiku
-                            </SpsLabel>
-                            <SpsTextarea placeholder="Write a haiku" rows={3}
-                                formMeta={formMeta.fields.haiku}
-                                value={formValue.haiku}
-                            ></SpsTextarea>
-                        </>
+                      return (
+                          <div className="sfg-row">
+                              <div className="sfg-col-4">
+                                  <SpsLabel for={formMeta.fields.companyDescription}>Company Description</SpsLabel>
+                                  <SpsTextarea
+                                      value={formValue.companyDescription}
+                                      formMeta={formMeta.fields.companyDescription}
+                                      placeholder="Describe your company"
+                                  />
+                              </div>
+                          </div>
+                      );
                     }
                 `
       }
     }
   },
-  b_description: {
-    label: "Description",
-    description: "info about text areas with descriptions",
+  additional_text: {
+    label: "Additional Descriptive Text",
+    description: ({ NavigateTo }) => /* @__PURE__ */ React.createElement("p", null, "For occasions when additional context beyond a placeholder is required, text in the form of a short phrase can appear below the input."),
     examples: {
-      description: {
+      placeholder: {
         react: code`
                     function DemoComponent() {
-                        const { formValue, formMeta, updateForm } = useSpsForm({
-                            textareaWithDescription: ""
-                        });
+                      const { formValue, formMeta, updateForm } = useSpsForm({ campaignNotes: "" });
 
-                        return <>
-                            <SpsLabel for={formMeta.fields.textareaWithDescription}
-                                description="This is a brief description of the field to provide additional context."
-                            >
-                                Label
-                            </SpsLabel>
-                            <SpsTextarea formMeta={formMeta.fields.textareaWithDescription}
-                                value={formValue.textareaWithDescription}
-                            />
-                        </>
+                      return (
+                          <div className="sfg-row">
+                              <div className="sfg-col-4">
+                                  <SpsLabel for={formMeta.fields.campaignNotes}>Campaign Notes</SpsLabel>
+                                  <SpsTextarea
+                                      value={formValue.campaignNotes}
+                                      formMeta={formMeta.fields.campaignNotes}
+                                      additionalText="List any additional comments, questions or information about this campaign."
+                                  />
+                              </div>
+                          </div>
+                      );
                     }
                 `
       }
     }
   },
-  c_disabled: {
-    label: "Disabled",
-    description: "info about disabled text areas",
+  disabled: {
+    label: "Disabled State",
+    description: () => /* @__PURE__ */ React.createElement("p", null, "The Disabled State prevents a user from modifying the text input while still allowing visibility to its information."),
     examples: {
-      disabled: {
+      standard: {
         react: code`
                     function DemoComponent() {
-                        const { formValue, formMeta, updateForm } = useSpsForm({
-                            notes: "This is the value of the textarea but you can't edit it right now"
-                        });
+                        const { formValue, formMeta, updateForm } = useSpsForm({ notes: "Some notes here" });
 
-                        return <>
-                            <SpsLabel for={formMeta.fields.notes}>Notes</SpsLabel>
-                            <SpsTextarea disabled rows={5}
-                                formMeta={formMeta.fields.notes}
-                                value={formValue.notes}
-                            ></SpsTextarea>
-                        </>
+                        return (
+                            <div className="sfg-row">
+                                <div className="sfg-col-4">
+                                    <SpsLabel for={formMeta.fields.notes}>Notes</SpsLabel>
+                                    <SpsTextarea
+                                        value={formValue.notes}
+                                        formMeta={formMeta.fields.notes}
+                                        disabled
+                                    />
+                                </div>
+                            </div>
+                        );
                     }
                 `
       }
@@ -36273,13 +36401,13 @@ const SpsWorkflowExamples = {
       basic: {
         jsx: code`
                 <div className="col-4">
-                    <SpsWorkflow icon="list-summary" title="Workflow">
-                        <SpsWorkflowStep icon="heart" title="Name of Step">
+                    <SpsWorkflow icon={SpsIcon.LIST_SUMMARY} title="Workflow">
+                        <SpsWorkflowStep icon={SpsIcon.HEART} title="Name of Step">
                             <SpsWorkflowDocument>
                                 <a href="https://github.com/SPSCommerce/ui-angular" target="_blank">
                                     Document Name
                                 </a>
-                                <SpsWorkflowDocumentStatus icon="status-error">
+                                <SpsWorkflowDocumentStatus icon={SpsIcon.STATUS_ERROR}>
                                     Status
                                 </SpsWorkflowDocumentStatus>
                             </SpsWorkflowDocument>
@@ -36290,7 +36418,7 @@ const SpsWorkflowExamples = {
                                 </SpsWorkflowDocumentStatus>
                             </SpsWorkflowDocument>
                         </SpsWorkflowStep>
-                        <SpsWorkflowStep icon="heart" title="Done">
+                        <SpsWorkflowStep icon={SpsIcon.HEART} title="Done">
                         </SpsWorkflowStep>
                     </SpsWorkflow>
                 </div>
@@ -36304,13 +36432,13 @@ const SpsWorkflowExamples = {
       withAlias: {
         jsx: code`
                 <div className="col-4">
-                    <SpsWf icon="list-summary" title="Workflow">
-                        <SpsWfStep icon="heart" title="Name of Step">
+                    <SpsWf icon={SpsIcon.LIST_SUMMARY} title="Workflow">
+                        <SpsWfStep icon={SpsIcon.HEART} title="Name of Step">
                             <SpsWfDoc>
                                 <a href="https://github.com/SPSCommerce/ui-angular" target="_blank">
                                     Document Name
                                 </a>
-                                <SpsWfDs icon="status-error">Status</SpsWfDs>
+                                <SpsWfDs icon={SpsIcon.STATUS_ERROR}>Status</SpsWfDs>
                             </SpsWfDoc>
                             <SpsWfDoc>
                                 Document Name
@@ -36319,7 +36447,7 @@ const SpsWorkflowExamples = {
                                 </SpsWfDs>
                             </SpsWfDoc>
                         </SpsWfStep>
-                        <SpsWfStep icon="heart" title="Done">
+                        <SpsWfStep icon={SpsIcon.HEART} title="Done">
                         </SpsWfStep>
                     </SpsWf>
                 </div>
@@ -37557,11 +37685,13 @@ const MANIFEST = {
     components: [SpsTaskQueue],
     examples: SpsTaskQueueExamples
   },
-  "Text Input": {
+  "Text Inputs": {
+    description: () => /* @__PURE__ */ React.createElement("p", null, "Text Inputs consist of a Label and a field in which a user enters a short value."),
     components: [SpsTextInput],
     examples: SpsTextInputExamples
   },
-  Textarea: {
+  "Text Areas": {
+    description: () => /* @__PURE__ */ React.createElement("p", null, "Text Areas consist of a Label and a field in which a user enters a long value."),
     components: [SpsTextarea],
     examples: SpsTextareaExamples
   },