@spscommerce/ds-react 5.22.0 → 5.23.2

package/lib/index.es.js

@@ -277,7 +277,7 @@ function contentOf(nodeOrRenderFn2) {
 const propsDoc$1I = __spreadProps(__spreadValues({}, spsFormProps), {
   controlsDisabled: "boolean",
   footerLinks: "ReactNodeOrRenderFn",
-  formMeta: "SpsFormArrayMeta<any> | SpsFormGroupMeta<any>",
+  formMeta: "SpsFormSetMeta<any>",
   isOpen: "boolean",
   onClear: "() => void",
   onSubmit: "React.FormEventHandler"
@@ -287,10 +287,7 @@ const propTypes$1M = __spreadProps(__spreadValues(__spreadValues({}, spsGlobalPr
   footerLinks: nodeOrRenderFn,
   formArray: impl(),
   formGroup: impl(),
-  formMeta: propTypes$1O.exports.oneOfType([
-    impl(),
-    impl()
-  ]),
+  formMeta: impl(),
   isOpen: propTypes$1O.exports.bool,
   onClear: fun(),
   onSubmit: fun()
@@ -1818,6 +1815,7 @@ const propTypes$1K = __spreadProps(__spreadValues(__spreadValues(__spreadValues(
 async function updateOptions(props2, searchState, searchStatePatch, setOptionList, setAnyOptionHasIcon, promiseRef) {
   const options = typeof props2.options === "function" ? props2.options(searchState.value) : props2.options || [];
   const areOptionsPromise = options instanceof Promise;
+  const removeSpecialSymbols = (value) => value.replace(/([.?*+^$[\]\\(){}|-])/g, "");
   searchStatePatch({ pending: areOptionsPromise });
   promiseRef.current = areOptionsPromise ? options : null;
   const result = areOptionsPromise ? await options || [] : options || [];
@@ -1835,13 +1833,15 @@ async function updateOptions(props2, searchState, searchStatePatch, setOptionLis
     newOpts.unshift(new SpsOptionListOption(null, { text: props2.nullOption }));
   }
   if (searchState.value) {
-    searchStatePatch({ replacementPattern: new RegExp(searchState.value, "ig") });
+    const searchValue = removeSpecialSymbols(searchState.value);
+    searchStatePatch({ replacementPattern: new RegExp(searchValue, "ig") });
     newOpts = newOpts.filter((o) => {
-      const regEx = new RegExp(searchState.value, "i");
+      const regEx = new RegExp(searchValue, "i");
+      const optionText = removeSpecialSymbols(o.text);
       if (props2.filterByTextAndCaptionKey) {
-        return regEx.test(o.text) || regEx.test(o.caption);
+        return regEx.test(optionText) || regEx.test(removeSpecialSymbols(o.caption));
       }
-      return regEx.test(o.text);
+      return regEx.test(optionText);
     });
   } else {
     searchStatePatch({ replacementPattern: null });
@@ -25337,36 +25337,36 @@ const SpsInsightTileExamples = {
                             kind={SpsInsightTileKind.GENERAL}
                             metric="1234"
                             title="Insight Tile Title"
-                            partnerCount="250"
-                            totalPartners="250"
+                            partnerCount={250}
+                            totalPartners={250}
                         />
                         <SpsInsightTile
                             kind={SpsInsightTileKind.PROCESSING}
                             metric="1234"
                             title="Insight Tile Title"
-                            partnerCount="122"
-                            totalPartners="250"
+                            partnerCount={122}
+                            totalPartners={250}
                         />
                         <SpsInsightTile
                             kind={SpsInsightTileKind.SUCCESS}
                             metric="1234"
                             title="Insight Tile Title"
-                            partnerCount="207"
-                            totalPartners="250"
+                            partnerCount={207}
+                            totalPartners={250}
                         />
                         <SpsInsightTile
                             kind={SpsInsightTileKind.WARNING}
                             metric="1234"
                             title="Insight Tile Title"
-                            partnerCount="12"
-                            totalPartners="250"
+                            partnerCount={12}
+                            totalPartners={250}
                         />
                         <SpsInsightTile
                             kind={SpsInsightTileKind.ERROR}
                             metric="1234"
                             title="Insight Tile Title"
-                            partnerCount="94"
-                            totalPartners="250"
+                            partnerCount={94}
+                            totalPartners={250}
                         />
                     </SpsInsights>
                 `
@@ -25453,8 +25453,8 @@ const SpsInsightTileExamples = {
                             kind={SpsInsightTileKind.GENERAL}
                             metric="1234"
                             title="Insight Tile Title"
-                            partnerCount="100"
-                            totalPartners="200"
+                            partnerCount={100}
+                            totalPartners={200}
                             horizontal
                         >
                             <span className="gray600 font-weight-bold">Detail:</span> 792 units
@@ -25463,16 +25463,16 @@ const SpsInsightTileExamples = {
                             kind={SpsInsightTileKind.PROCESSING}
                             metric="1234"
                             title="Insight Tile Title"
-                            partnerCount="100"
-                            totalPartners="200"
+                            partnerCount={100}
+                            totalPartners={200}
                             horizontal
                         />
                         <SpsInsightTile
                             kind={SpsInsightTileKind.SUCCESS}
                             metric="1234"
                             title="Insight Tile Title"
-                            partnerCount="100"
-                            totalPartners="200"
+                            partnerCount={100}
+                            totalPartners={200}
                             horizontal
                         >
                             <span className="gray600 font-weight-bold">Detail:</span> 792 units
@@ -25481,16 +25481,16 @@ const SpsInsightTileExamples = {
                             kind={SpsInsightTileKind.WARNING}
                             metric="1234"
                             title="Insight Tile Title"
-                            partnerCount="100"
-                            totalPartners="200"
+                            partnerCount={100}
+                            totalPartners={200}
                             horizontal
                         />
                         <SpsInsightTile
                             kind={SpsInsightTileKind.ERROR}
                             metric="1234"
                             title="Insight Tile Title"
-                            partnerCount="100"
-                            totalPartners="200"
+                            partnerCount={100}
+                            totalPartners={200}
                             horizontal
                         >
                             <span className="gray600 font-weight-bold">Detail:</span> 792 units
@@ -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}`
@@ -27278,10 +27349,10 @@ const SpsTableExamples = {
                       <SpsTable>
                         <SpsTableHead>
                           <SpsTableRow>
-                            <SpsTableHeader ></SpsTableHeader>
-                            <SpsTableHeader >Title</SpsTableHeader>
+                            <SpsTableHeader controlCell></SpsTableHeader>
+                            <SpsTableHeader>Title</SpsTableHeader>
                             <SpsTableHeader>Year</SpsTableHeader>
-                            <SpsTableHeader >Director</SpsTableHeader>
+                            <SpsTableHeader>Director</SpsTableHeader>
                             <SpsTableHeader>Countries</SpsTableHeader>
                           </SpsTableRow>
                         </SpsTableHead>
@@ -27289,7 +27360,7 @@ const SpsTableExamples = {
                           {items.map((row, index) => {
                             return (
                               <SpsTableRow key={index}>
-                                <SpsTableCell><SpsCheckbox/></SpsTableCell>
+                                <SpsTableCell controlCell><SpsCheckbox/></SpsTableCell>
                                 <SpsTableCell>{row["title"]}</SpsTableCell>
                                 <SpsTableCell>{row["year"]}</SpsTableCell>
                                 <SpsTableCell>{row["director"]}</SpsTableCell>
@@ -27378,7 +27449,7 @@ const SpsTableExamples = {
                                                 <SpsTableCell>{row["year"]}</SpsTableCell>
                                                 <SpsTableCell>{row["director"]}</SpsTableCell>
                                                 <SpsTableCell className="text-right" buttonCell>
-                                                    <SpsButton kind="icon" icon="ellipses" />
+                                                    <SpsButton kind={ButtonKind.ICON} icon={SpsIcon.ELLIPSES} />
                                                 </SpsTableCell>
                                             </SpsTableRow>
                                         );
@@ -27533,7 +27604,7 @@ const SpsTableExamples = {
                                 <SpsTableCell>{row["aspect_ratio"]}</SpsTableCell>
                                 <SpsTableCell>\${row["price"]}</SpsTableCell>
                                 <SpsTableCell className="text-right" buttonCell pinned>
-                                  <SpsButton kind="icon" icon="ellipses" />
+                                  <SpsButton kind={ButtonKind.ICON} icon={SpsIcon.ELLIPSES} />
                                 </SpsTableCell>
                               </SpsTableRow>
                               )
@@ -33211,6 +33282,7 @@ const SpsSideNavExamples = {
                               titleIcon={SpsIcon.STATUS_OK}
                               navOptions={items}
                               onNavChange={onChange}
+                              activeNavItem="Navigation Item 2"
                           />
                         </div>
                       </div>
@@ -33564,28 +33636,33 @@ const SpsSpinnerExamples = {
   basic: {
     examples: {
       small: {
-        jsx: code`
-                    <React.Fragment>
-                        <SpsSpinner size="small"/>
-                        <SpsSpinner size={SpinnerSize.SMALL}/>
-                    </React.Fragment>
+        react: code`
+                    function Component() {
+                      return (
+                        <SpsSpinner size={SpinnerSize.SMALL} title="Please wait…" />
+                      );
+                    }
                 `
       },
       medium: {
-        jsx: code`
-                    <React.Fragment>
-                        <SpsSpinner />
-                        <SpsSpinner size="medium" title="Please wait…"/>
-                        <SpsSpinner size={SpinnerSize.MEDIUM}/>
-                    </React.Fragment>
+        react: code`
+                    function Component() {
+                      return (
+                        <>
+                          <SpsSpinner />
+                          <SpsSpinner size={SpinnerSize.MEDIUM} title="Please wait…" />
+                        </>
+                      );
+                    }
                 `
       },
       large: {
-        jsx: code`
-                    <React.Fragment>
-                        <SpsSpinner size="large"/>
-                        <SpsSpinner size={SpinnerSize.LARGE} alt="Loading content…"/>
-                    </React.Fragment>
+        react: code`
+                    function Component() {
+                      return (
+                        <SpsSpinner size={SpinnerSize.LARGE} alt="Loading content…" />
+                      );
+                    }
                 `
       }
     }
@@ -34740,11 +34817,9 @@ const SpsTaskQueueExamples = {
                             }
                         ]);
 
-                        const form = useForm(
-                            formGroup({
-                                blueTooltip: formControl(false)
-                            })
-                        );
+                        const { formValue, formMeta } = useSpsForm({
+                            blueTooltip: false
+                        });
 
                         function handleAddTask() {
                             const newTaskId = generateTaskId();
@@ -34771,7 +34846,7 @@ const SpsTaskQueueExamples = {
                             setTasks(currentTasks => currentTasks.map(task => ({ ...task, unread: false })));
                         }
 
-                        const isTooltipBlue = form.get("blueTooltip").getValue();
+                        const isTooltipBlue = formValue.blueTooltip;
                         const tooltipKind = isTooltipBlue ? TooltipKind.HELP : TooltipKind.DEFAULT;
                         const notificationText = isTooltipBlue
                             ? "There is a new task in your queue. Also the tooltip is blue now :O"
@@ -34780,7 +34855,7 @@ const SpsTaskQueueExamples = {
                         return (
                             <div style={{ display: "flex", justifyContent: "space-between" }}>
                                 <div>
-                                    <SpsCheckbox label="Blue Tooltip" formControl={form.get("blueTooltip")} />
+                                    <SpsCheckbox label="Blue Tooltip" formMeta={formMeta.fields.blueTooltip} />
                                     <SpsButton onClick={handleAddTask}>Add a new task to the queue</SpsButton>
                                 </div>
 
@@ -35538,9 +35613,9 @@ const SpsTileListExamples = {
                             
                             // custom sort by status
                             if (key === 'status') {
-                                if (a.error + a.warning < b.error + b.warning) {
+                                if (+a.error + +a.warning < +b.error + +b.warning) {
                                     return direction === SortDirection.ASCENDING ? -1 : 1;
-                                } else if (a.error + a.warning > b.error + b.warning) {
+                                } else if (+a.error + +a.warning > +b.error + +b.warning) {
                                     return direction === SortDirection.ASCENDING ? 1 : -1;
                                 }
                             }
@@ -37118,16 +37193,13 @@ const SpsFilterPanelExamples = {
 const propsDoc$c = {
   value: "string",
   placeholder: "string",
-  formMeta: "SpsFormArrayMeta<any> | SpsFormGroupMeta<any>",
+  formMeta: "SpsFormFieldMeta<string>",
   onFilterChange: "ChangeEventHandler<HTMLInputElement>"
 };
 const propTypes$e = __spreadProps(__spreadValues({}, spsGlobalPropTypes), {
   value: propTypes$1O.exports.string,
   placeholder: propTypes$1O.exports.string,
-  formMeta: propTypes$1O.exports.oneOfType([
-    impl(),
-    impl()
-  ]),
+  formMeta: impl(),
   onFilterChange: fun()
 });
 function SpsFilterPanelFilterBox(_Q) {

package/lib/table/SpsTable.d.ts

@@ -4,6 +4,8 @@ declare const propTypes: {
     onSortChange: PropTypes.Requireable<SortChangeHandler>;
     sort: PropTypes.Requireable<SortedColumn[]>;
     selectable: PropTypes.Requireable<boolean>;
+    maxHeightPx: PropTypes.Requireable<number>;
+    maxHeightRem: PropTypes.Requireable<number>;
     children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
     className: PropTypes.Requireable<string>;
     "data-testid": PropTypes.Requireable<string>;

package/lib/table/usePinnedStyles.d.ts

@@ -1,4 +1,5 @@
 import * as React from "react";
 export declare const usePinnedCellStyle: (isPinned: boolean, elementRef: React.MutableRefObject<HTMLTableHeaderCellElement | HTMLTableCellElement>) => void;
 export declare const usePinnedTableBackgroundStyle: (containerRef: React.MutableRefObject<HTMLDivElement>) => void;
-export declare const usePinnedTableHeadStyle: (containerRef: React.MutableRefObject<HTMLDivElement>) => void;
+export declare const usePinnedTableHeadStyle: (containerRef: React.MutableRefObject<HTMLDivElement>, maxHeight: number) => void;
+export declare const useMaxHeightTableStyle: (containerRef: React.MutableRefObject<HTMLDivElement>, maxHeight: number) => void;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@spscommerce/ds-react",
   "description": "SPS Design System React components",
-  "version": "5.22.0",
+  "version": "5.23.2",
   "author": "SPS Commerce",
   "license": "UNLICENSED",
   "repository": "https://github.com/spscommerce/design-system/tree/main/packages/@spscommerce/ds-react",
@@ -28,11 +28,11 @@
   },
   "peerDependencies": {
     "@react-stately/collections": "^3.3.3",
-    "@spscommerce/ds-colors": "5.22.0",
-    "@spscommerce/ds-illustrations": "5.22.0",
-    "@spscommerce/ds-shared": "5.22.0",
-    "@spscommerce/positioning": "5.22.0",
-    "@spscommerce/utils": "5.22.0",
+    "@spscommerce/ds-colors": "5.23.2",
+    "@spscommerce/ds-illustrations": "5.23.2",
+    "@spscommerce/ds-shared": "5.23.2",
+    "@spscommerce/positioning": "5.23.2",
+    "@spscommerce/utils": "5.23.2",
     "moment": "^2.25.3",
     "moment-timezone": "^0.5.28",
     "react": "^16.9.0",
@@ -40,11 +40,11 @@
   },
   "devDependencies": {
     "@react-stately/collections": "^3.3.3",
-    "@spscommerce/ds-colors": "5.22.0",
-    "@spscommerce/ds-illustrations": "5.22.0",
-    "@spscommerce/ds-shared": "5.22.0",
-    "@spscommerce/positioning": "5.22.0",
-    "@spscommerce/utils": "5.22.0",
+    "@spscommerce/ds-colors": "5.23.2",
+    "@spscommerce/ds-illustrations": "5.23.2",
+    "@spscommerce/ds-shared": "5.23.2",
+    "@spscommerce/positioning": "5.23.2",
+    "@spscommerce/utils": "5.23.2",
     "@testing-library/react": "^9.3.2",
     "@types/prop-types": "^15.7.1",
     "@types/react": "^16.9.0",