@jobber/components 4.46.0 → 4.46.1-JOB-79340.32

package/dist/Combobox/Combobox.types.d.ts

@@ -1,4 +1,15 @@
+import { Dispatch, ReactElement, SetStateAction } from "react";
+import { XOR } from "ts-xor";
 import { ButtonProps } from "../Button";
+export interface ComboboxProps {
+    readonly children: ReactElement | ReactElement[];
+    /**
+     * When `true`, `Combobox` will allow for multiple selections
+     *
+     * @default false
+     */
+    readonly multiSelect?: boolean;
+}
 export interface ComboboxTriggerProps {
     /**
      * The label text of the trigger.
@@ -9,6 +20,137 @@ export interface ComboboxTriggerButtonProps extends ComboboxTriggerProps, Pick<B
 }
 export type ComboboxTriggerChipProps = ComboboxTriggerProps;
 export interface ComboboxOption {
+    /**
+     * A unique identifier for the option.
+     */
     id: string | number;
+    /**
+     * The value to be visually displayed in the Combobox options list.
+     */
     label: string;
 }
+interface ComboboxCloseProps {
+    /**
+     * Callback function invoked upon the selection of an option. Provides the selected option(s) as an argument.
+     */
+    readonly onSelect: (selection: ComboboxOption[]) => void;
+}
+interface ComboboxSelectProps {
+    /**
+     * Callback function invoked upon the Combobox menu closing. Provides the selected option(s) as an argument.
+     */
+    readonly onClose: (selection: ComboboxOption[]) => void;
+}
+interface ComboboxContentBaseProps {
+    /**
+     * List of selectable options to display.
+     */
+    readonly options: ComboboxOption[];
+    /**
+     * Optional action button(s) to display at the bottom of the list.
+     */
+    readonly children?: ReactElement | ReactElement[];
+    /**
+     * Placeholder text to display in the search input. Defaults to "Search".
+     */
+    readonly searchPlaceholder?: string;
+    /**
+     * The selected options of the Combobox.
+     */
+    readonly selected: ComboboxOption[];
+    /**
+     * The encapsulating noun for the content of the combobox. Used
+     * in the empty state, and search placeholder. Should be pluralized.
+     */
+    readonly subjectNoun?: string;
+}
+export type ComboboxContentProps = ComboboxContentBaseProps & XOR<ComboboxCloseProps, ComboboxSelectProps>;
+export interface ComboboxSearchProps {
+    /**
+     * The placeholder for the search input.
+     */
+    placeholder?: string;
+    /**
+     * The value of the search input
+     */
+    searchValue: string;
+    /**
+     * The open state of the Combobox listbox.
+     */
+    open: boolean;
+    /**
+     * Setter for the search input value.
+     */
+    setSearchValue: Dispatch<SetStateAction<string>>;
+}
+export interface ComboboxHeaderProps {
+    /**
+     * Does the Combobox have any options visible in the list.
+     */
+    readonly hasOptionsVisible: boolean;
+    /**
+     * The noun to be used in the header label.
+     */
+    readonly subjectNoun?: string;
+    /**
+     * The number of selected options.
+     */
+    readonly selectedCount: number;
+    /**
+     * The function to call when the clear all button is clicked.
+     */
+    readonly onClearAll: () => void;
+    /**
+     * The function to call when the select all button is clicked.
+     */
+    readonly onSelectAll: () => void;
+}
+export interface ComboboxListProps {
+    /**
+     * The options to display in the list. May be the full set of the Combobox or could be filtered.
+     */
+    readonly options: ComboboxOption[];
+    /**
+     * Used to determine if the empty state should be shown and given priority over the options list.
+     */
+    readonly showEmptyState: boolean;
+    /**
+     * The currently selected options.
+     */
+    readonly selected: ComboboxOption[];
+    /**
+     * A ref to the list element.
+     */
+    readonly optionsListRef: React.RefObject<HTMLUListElement>;
+    /**
+     * Setter for the first selected element, which is used to scroll the list to the first selected element on re-opening.
+     */
+    readonly setFirstSelectedElement: React.Dispatch<SetStateAction<HTMLElement | null>>;
+    /**
+     * The callback function to call when an option is selected.
+     */
+    readonly selectionHandler: (option: ComboboxOption) => void;
+    /**
+     * The current search term. Used in the no results message.
+     */
+    readonly searchValue: string;
+    /**
+     * Determines if it is a single selection or multi selection Combobox.
+     */
+    readonly multiselect: boolean;
+    /**
+     * The noun to be used in the empty state message.
+     */
+    readonly subjectNoun?: string;
+}
+export interface ComboboxActionProps {
+    /**
+     * The function to call when the action is clicked.
+     */
+    onClick(event: React.MouseEvent<HTMLButtonElement>): void;
+    /**
+     * The label text of the action.
+     */
+    readonly label: string;
+}
+export {};

package/dist/Combobox/components/ComboboxAction/ComboboxAction.d.ts

@@ -1,12 +1,3 @@
-import React from "react";
-export interface ComboboxActionProps {
-    /**
-     * The function to call when the action is clicked.
-     */
-    onClick(event: React.MouseEvent<HTMLButtonElement>): void;
-    /**
-     * The label text of the action.
-     */
-    readonly label: string;
-}
+/// <reference types="react" />
+import { ComboboxActionProps } from "@jobber/components/Combobox/Combobox.types";
 export declare function ComboboxAction(props: ComboboxActionProps): JSX.Element;

package/dist/Combobox/components/ComboboxAction/index.d.ts

@@ -1 +1 @@
-export { ComboboxAction, ComboboxActionProps } from "./ComboboxAction";
+export { ComboboxAction } from "./ComboboxAction";

package/dist/Combobox/components/ComboboxContent/ComboboxContent.d.ts

@@ -1,33 +1,3 @@
-import { ReactElement } from "react";
-import { ComboboxOption } from "../../Combobox.types";
-interface ComboboxContentProps {
-    /**
-     * List of selectable options to display.
-     */
-    readonly options: ComboboxOption[];
-    /**
-     * Callback function invoked upon the selection of an option. Provides the selected option as an argument.
-     */
-    readonly onSelect: (selection: ComboboxOption) => void;
-    /**
-     * Optional action button(s) to display at the bottom of the list.
-     */
-    readonly children?: ReactElement | ReactElement[];
-    /**
-     * Placeholder text to display in the search input. Defaults to "Search".
-     */
-    readonly searchPlaceholder?: string;
-    /**
-     * pre selected option
-     * @default ""
-     * @type string
-     */
-    readonly selected: ComboboxOption | null;
-    /**
-     * The encapsulating noun for the content of the combobox. Used
-     * in the empty state, and search placeholder. Should be pluralized.
-     */
-    readonly subjectNoun?: string;
-}
+/// <reference types="react" />
+import { ComboboxContentProps } from "@jobber/components/Combobox/Combobox.types";
 export declare function ComboboxContent(props: ComboboxContentProps): JSX.Element;
-export {};

package/dist/Combobox/components/ComboboxContent/ComboboxContentHeader/ComboboxContentHeader.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="react" />
+import { ComboboxHeaderProps } from "@jobber/components/Combobox/Combobox.types";
+export declare function ComboboxContentHeader(props: ComboboxHeaderProps): JSX.Element;

package/dist/Combobox/components/ComboboxContent/ComboboxContentHeader/index.d.ts

@@ -0,0 +1 @@
+export { ComboboxContentHeader } from "./ComboboxContentHeader";

package/dist/Combobox/components/ComboboxContent/ComboboxContentList/ComboboxContentList.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="react" />
+import { ComboboxListProps } from "@jobber/components/Combobox/Combobox.types";
+export declare function ComboboxContentList(props: ComboboxListProps): JSX.Element;

package/dist/Combobox/components/ComboboxContent/ComboboxContentList/index.d.ts

@@ -0,0 +1 @@
+export { ComboboxContentList } from "./ComboboxContentList";

package/dist/Combobox/components/ComboboxContent/ComboboxContentSearch/ComboboxContentSearch.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="react" />
+import { ComboboxSearchProps } from "@jobber/components/Combobox/Combobox.types";
+export declare function ComboboxContentSearch(props: ComboboxSearchProps): JSX.Element;

package/dist/Combobox/components/ComboboxContent/ComboboxContentSearch/index.d.ts

@@ -0,0 +1 @@
+export { ComboboxContentSearch } from "./ComboboxContentSearch";

package/dist/Combobox/components/ComboboxTrigger/ComboboxTriggerButton/ComboboxTriggerButton.d.ts

@@ -1,3 +1,3 @@
 /// <reference types="react" />
-import { ComboboxTriggerButtonProps } from "../../../Combobox.types";
+import { ComboboxTriggerButtonProps } from "@jobber/components/Combobox/Combobox.types";
 export declare function ComboboxTriggerButton(props: ComboboxTriggerButtonProps): JSX.Element;

package/dist/Combobox/components/ComboboxTrigger/ComboboxTriggerChip/ComboboxTriggerChip.d.ts

@@ -1,3 +1,3 @@
 /// <reference types="react" />
-import { ComboboxTriggerChipProps } from "../../../Combobox.types";
+import { ComboboxTriggerChipProps } from "@jobber/components/Combobox/Combobox.types";
 export declare function ComboboxTriggerChip(props: ComboboxTriggerChipProps): JSX.Element;

package/dist/Combobox/hooks/useComboboxAccessibility.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="react" />
-import { ComboboxOption } from "../Combobox.types";
+import { ComboboxOption } from "@jobber/components/Combobox/Combobox.types";
 export declare function useComboboxAccessibility(selectionCallback: (selection: ComboboxOption) => void, filteredOptions: ComboboxOption[], optionsListRef: React.RefObject<HTMLUListElement>, open: boolean, setOpen: (open: boolean) => void, wrapperRef: React.RefObject<HTMLDivElement>): {
     popperRef: React.RefObject<HTMLDivElement>;
     popperStyles: {

package/dist/Combobox/hooks/useComboboxContent.d.ts

@@ -1,9 +1,13 @@
 /// <reference types="react" />
-import { ComboboxOption } from "../Combobox.types";
-export declare function useComboboxContent(options: ComboboxOption[], open: boolean): {
+import { ComboboxOption } from "@jobber/components/Combobox/Combobox.types";
+interface useComboboxContent {
     searchValue: string;
     setSearchValue: React.Dispatch<React.SetStateAction<string>>;
-    setSelectedElement: React.Dispatch<React.SetStateAction<HTMLElement | null>>;
+    setFirstSelectedElement: React.Dispatch<React.SetStateAction<HTMLElement | null>>;
     filteredOptions: ComboboxOption[];
     optionsListRef: React.RefObject<HTMLUListElement>;
-};
+    selectedOptions: ComboboxOption[];
+    optionsSelectionHandler: (selected: ComboboxOption[]) => void;
+}
+export declare function useComboboxContent(options: ComboboxOption[], open: boolean, selected: ComboboxOption[], onClose: ((selection: ComboboxOption[]) => void) | undefined, onSelect: ((selection: ComboboxOption[]) => void) | undefined): useComboboxContent;
+export {};

package/dist/Combobox/hooks/useComboboxValidation.d.ts

@@ -0,0 +1,7 @@
+import { ReactNode } from "react";
+export declare const COMBOBOX_TRIGGER_COUNT_ERROR_MESSAGE = "Combobox can only have one Trigger element";
+export declare const COMBOBOX_REQUIRED_CHILDREN_ERROR_MESSAGE = "Combobox must have a Trigger and Combobox.Content element";
+export declare function useComboboxValidation(children: ReactNode): {
+    triggerElement: ReactNode;
+    contentElement: ReactNode;
+};

package/dist/Combobox/index.d.ts

@@ -1,3 +1,3 @@
-export { Combobox, ComboboxProps, COMBOBOX_REQUIRED_CHILDREN_ERROR_MESSAGE, COMBOBOX_TRIGGER_COUNT_ERROR_MESSAGE, } from "./Combobox";
+export { Combobox } from "./Combobox";
 export { ComboboxContextProvider } from "./ComboboxProvider";
-export { ComboboxOption } from "./Combobox.types";
+export { ComboboxOption, ComboboxProps } from "./Combobox.types";

package/dist/Combobox/index.js

@@ -3,18 +3,18 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var React = require('react');
-var useAssert = require('@jobber/hooks/useAssert');
 var classnames = require('classnames');
 var ReactDOM = require('react-dom');
 var styleInject_es = require('../style-inject.es-9d2f5f4e.js');
 var Icon = require('../Icon-405a216c.js');
-var Text = require('../Text-59bde58c.js');
+var Text = require('../Text-54334431.js');
+var Typography = require('../Typography-83915c54.js');
+var Button = require('../Button-db6114a6.js');
 var useRefocusOnActivator = require('@jobber/hooks/useRefocusOnActivator');
 var useFocusTrap = require('@jobber/hooks/useFocusTrap');
 var reactPopper = require('react-popper');
 var useOnKeyDown = require('@jobber/hooks/useOnKeyDown');
-var Typography = require('../Typography-9bff9c91.js');
-var Button = require('../Button-d89f2271.js');
+var useAssert = require('@jobber/hooks/useAssert');
 require('@jobber/design');
 require('react-router-dom');
 
@@ -24,15 +24,15 @@ var React__default = /*#__PURE__*/_interopDefaultLegacy(React);
 var classnames__default = /*#__PURE__*/_interopDefaultLegacy(classnames);
 var ReactDOM__default = /*#__PURE__*/_interopDefaultLegacy(ReactDOM);
 
-var css_248z$5 = ".m1w5vdUZ6rQ- {\n  z-index: 1002;\n  z-index: var(--elevation-tooltip);\n  max-width: var(--popover--width);\n  min-width: calc((16px * 4) * 3.75);\n  min-width: calc(calc(16px * 4) * 3.75);\n  min-width: calc(var(--space-extravagant) * 3.75);\n  box-shadow: 0px calc(16px / 16) calc(16px / 4) 0px\n      rgba(0, 0, 0, 0.1),\n    0px calc(16px / 4) 12px 0px rgba(0, 0, 0, 0.05);\n  box-shadow: var(--shadow-base);\n  margin-top: calc(16px / 2);\n  margin-top: var(--space-small);\n  border: calc(16px / 16) solid rgb(225, 225, 225);\n  border: var(--border-base) solid var(--color-border);\n  border-radius: calc(16px / 2);\n  border-radius: var(--radius-larger);\n  overflow: scroll;\n  overflow-y: auto;\n  background: rgba(255, 255, 255, 1);\n  background: var(--color-surface);\n}\n\n/* CAUTION: Tests for content visibility assume this class' presence hides the content\n* so please be careful if you change this class name, or the css rules within.\n*/\n\n.m1w5vdUZ6rQ-.Zlkv2HA096A- {\n  display: none;\n  visibility: hidden;\n}\n\n.YQry-Rd6zfQ-::before {\n  content: \"\";\n  display: block;\n  position: absolute;\n  top: calc((16px * 1.5) * -1);\n  top: calc(calc(16px * 1.5) * -1);\n  top: calc(var(--space-large) * -1);\n  right: 0;\n  left: 0;\n  height: calc(16px * 1);\n  height: var(--space-base);\n  background: linear-gradient(\n    180deg,\n    rgba(255, 255, 255, 0) 0%,\n    rgb(255, 255, 255) 100%\n  );\n}\n\n.YQry-Rd6zfQ- {\n  display: -ms-flexbox;\n  display: flex;\n  -ms-flex-direction: column;\n      flex-direction: column;\n  position: sticky;\n  gap: calc(16px / 4);\n  gap: var(--space-smaller);\n  bottom: 0;\n  width: 100%;\n  background-color: rgba(255, 255, 255, 1);\n  background-color: var(--color-surface);\n}\n\n.TcpqL34s4lI- {\n  padding-bottom: calc(16px / 2);\n  padding-bottom: var(--space-small);\n}\n";
-var styles$5 = {"content":"m1w5vdUZ6rQ-","hidden":"Zlkv2HA096A-","actions":"YQry-Rd6zfQ-","actionPadding":"TcpqL34s4lI-"};
-styleInject_es.styleInject(css_248z$5);
+var css_248z$6 = ".m1w5vdUZ6rQ- {\n  z-index: 1002;\n  z-index: var(--elevation-tooltip);\n  max-width: var(--popover--width);\n  min-width: calc((16px * 4) * 3.75);\n  min-width: calc(calc(16px * 4) * 3.75);\n  min-width: calc(var(--space-extravagant) * 3.75);\n  box-shadow: 0px calc(16px / 16) calc(16px / 4) 0px\n      rgba(0, 0, 0, 0.1),\n    0px calc(16px / 4) 12px 0px rgba(0, 0, 0, 0.05);\n  box-shadow: var(--shadow-base);\n  margin-top: calc(16px / 2);\n  margin-top: var(--space-small);\n  border: calc(16px / 16) solid rgb(225, 225, 225);\n  border: var(--border-base) solid var(--color-border);\n  border-radius: calc(16px / 2);\n  border-radius: var(--radius-larger);\n  overflow: scroll;\n  overflow-y: auto;\n  background: rgba(255, 255, 255, 1);\n  background: var(--color-surface);\n}\n\n/* CAUTION: Tests for content visibility assume this class' presence hides the content\n* so please be careful if you change this class name, or the css rules within.\n*/\n\n.m1w5vdUZ6rQ-.Zlkv2HA096A- {\n  display: none;\n  visibility: hidden;\n}\n\n.YQry-Rd6zfQ- {\n  display: -ms-flexbox;\n  display: flex;\n  -ms-flex-direction: column;\n      flex-direction: column;\n  position: sticky;\n  gap: calc(16px / 4);\n  gap: var(--space-smaller);\n  bottom: 0;\n  width: 100%;\n  background-color: rgba(255, 255, 255, 1);\n  background-color: var(--color-surface);\n}\n\n.TcpqL34s4lI- {\n  padding-bottom: calc(16px / 2);\n  padding-bottom: var(--space-small);\n}\n";
+var styles$6 = {"content":"m1w5vdUZ6rQ-","hidden":"Zlkv2HA096A-","actions":"YQry-Rd6zfQ-","actionPadding":"TcpqL34s4lI-"};
+styleInject_es.styleInject(css_248z$6);
 
-var css_248z$4 = ".ifwwZOYTf8U- {\n  position: relative;\n}\n\n.gIbHknFkZLI- {\n  width: 100%;\n  padding: calc(16px * 1);\n  padding: var(--space-base);\n  padding-right: calc((16px * 1.5) * 2.25);\n  padding-right: calc(calc(16px * 1.5) * 2.25);\n  padding-right: calc(var(--space-large) * 2.25);\n  border: none;\n  border-bottom: calc(16px / 16) solid rgb(225, 225, 225);\n  border-bottom: var(--border-base) solid var(--color-border);\n  font-family: \"Inter\", Helvetica, Arial, sans-serif;\n  font-family: var(--typography--fontFamily-normal);\n  font-size: calc((16px * 1) * 0.875);\n  font-size: calc(calc(16px * 1) * 0.875);\n  font-size: var(--typography--fontSize-base);\n}\n\n.dZmEG-amk2U- {\n  position: absolute;\n  top: 50%;\n  right: calc(16px * 1);\n  right: var(--space-base);\n  z-index: 1002;\n  z-index: var(--elevation-tooltip);\n  width: calc(16px * 1.5);\n  width: var(--space-large);\n  height: calc(16px * 1.5);\n  height: var(--space-large);\n  padding: 0;\n  border: none;\n  border-radius: 100%;\n  border-radius: var(--radius-circle);\n  background-color: rgb(244, 244, 244);\n  background-color: var(--color-surface--background);\n  cursor: pointer;\n  -webkit-transform: translateY(-50%);\n          transform: translateY(-50%);\n}\n\n.dZmEG-amk2U-:focus {\n  box-shadow: 0px 0px calc(16px / 4) calc(16px / 8)\n    rgb(231, 213, 87);\n  box-shadow: var(--shadow-focus);\n}\n\n.ifwwZOYTf8U-::after {\n  content: \"\";\n  display: block;\n  position: absolute;\n  right: 0;\n  bottom: calc((16px * 1.5) * -1);\n  bottom: calc(calc(16px * 1.5) * -1);\n  bottom: calc(var(--space-large) * -1);\n  left: 0;\n  height: calc(16px * 1);\n  height: var(--space-base);\n  background-image: linear-gradient(\n    to bottom,\n    rgba(255, 255, 255, 1),\n    rgba(255, 255, 255, 0)\n  );\n}\n";
-var styles$4 = {"search":"ifwwZOYTf8U-","searchInput":"gIbHknFkZLI-","clearSearch":"dZmEG-amk2U-"};
-styleInject_es.styleInject(css_248z$4);
+var css_248z$5 = ".MIyb-oFZg9w- {\n  position: relative;\n}\n\n.WZPK91I4aJs- {\n  width: 100%;\n  padding: calc(16px * 1);\n  padding: var(--space-base);\n  padding-right: calc((16px * 1.5) * 2.25);\n  padding-right: calc(calc(16px * 1.5) * 2.25);\n  padding-right: calc(var(--space-large) * 2.25);\n  border: none;\n  border-bottom: calc(16px / 16) solid rgb(225, 225, 225);\n  border-bottom: var(--border-base) solid var(--color-border);\n  font-family: \"Inter\", Helvetica, Arial, sans-serif;\n  font-family: var(--typography--fontFamily-normal);\n  font-size: calc((16px * 1) * 0.875);\n  font-size: calc(calc(16px * 1) * 0.875);\n  font-size: var(--typography--fontSize-base);\n}\n\n._7loHrVUe-Rk- {\n  position: absolute;\n  top: 50%;\n  right: calc(16px * 1);\n  right: var(--space-base);\n  z-index: 1002;\n  z-index: var(--elevation-tooltip);\n  width: calc(16px * 1.5);\n  width: var(--space-large);\n  height: calc(16px * 1.5);\n  height: var(--space-large);\n  padding: 0;\n  border: none;\n  border-radius: 100%;\n  border-radius: var(--radius-circle);\n  background-color: rgb(244, 244, 244);\n  background-color: var(--color-surface--background);\n  cursor: pointer;\n  -webkit-transform: translateY(-50%);\n          transform: translateY(-50%);\n}\n\n._7loHrVUe-Rk-:focus {\n  box-shadow: 0px 0px calc(16px / 4) calc(16px / 8)\n    rgb(231, 213, 87);\n  box-shadow: var(--shadow-focus);\n}\n";
+var styles$5 = {"search":"MIyb-oFZg9w-","searchInput":"WZPK91I4aJs-","clearSearch":"_7loHrVUe-Rk-"};
+styleInject_es.styleInject(css_248z$5);
 
-function ComboboxSearch(props) {
+function ComboboxContentSearch(props) {
     const searchRef = React.useRef(null);
     React.useEffect(() => {
         if (props.open) {
@@ -42,9 +42,9 @@ function ComboboxSearch(props) {
             }, 0);
         }
     }, [props.open]);
-    return (React__default["default"].createElement("div", { className: styles$4.search },
-        React__default["default"].createElement("input", { type: "search", ref: searchRef, className: styles$4.searchInput, placeholder: props.placeholder ? `Search ${props.placeholder}` : "Search", onChange: (event) => handleSearch(event), value: props.searchValue }),
-        props.searchValue && (React__default["default"].createElement("button", { className: styles$4.clearSearch, onClick: clearSearch, "data-testid": "ATL-Combobox-Content-Search-Clear", "aria-label": "Clear search" },
+    return (React__default["default"].createElement("div", { className: styles$5.search },
+        React__default["default"].createElement("input", { type: "search", ref: searchRef, className: styles$5.searchInput, placeholder: props.placeholder ? `Search ${props.placeholder}` : "Search", onChange: (event) => handleSearch(event), value: props.searchValue }),
+        props.searchValue && (React__default["default"].createElement("button", { className: styles$5.clearSearch, onClick: clearSearch, type: "button", "data-testid": "ATL-Combobox-Content-Search-Clear", "aria-label": "Clear search" },
             React__default["default"].createElement(Icon.Icon, { name: "remove", size: "small" })))));
     function clearSearch() {
         var _a;
@@ -56,30 +56,30 @@ function ComboboxSearch(props) {
     }
 }
 
-var css_248z$3 = "._5n7VvEn39-Y- {\n  padding: calc(16px / 2);\n  padding: var(--space-small);\n}\n\n.KhX5VfZjAog- {\n  display: -ms-flexbox;\n  display: flex;\n  max-height: calc((16px / 2) * 33.33);\n  max-height: calc(calc(16px / 2) * 33.33);\n  max-height: calc(var(--space-small) * 33.33);\n  margin: 0;\n  padding: 0;\n  overflow: scroll;\n  list-style: none;\n  -ms-flex-direction: column;\n      flex-direction: column;\n  gap: calc(16px / 4);\n  gap: var(--space-smaller);\n}\n\n.NNCJVHYx6lc- {\n  display: -ms-flexbox;\n  display: flex;\n  min-height: calc((calc(16px * 3) - calc(16px / 4)));\n  min-height: calc((var(--space-largest) - var(--space-smaller)));\n  box-sizing: border-box;\n  padding: calc(16px / 2);\n  padding: var(--space-small);\n  border-radius: calc(16px / 4);\n  border-radius: var(--radius-large);\n  color: rgb(1, 41, 57);\n  color: var(--color-heading);\n  font-weight: 500;\n  cursor: pointer;\n  -ms-flex-pack: justify;\n      justify-content: space-between;\n  -ms-flex-align: center;\n      align-items: center;\n  transition: all 200ms;\n  transition: all var(--timing-base);\n}\n\n.IvTItlT0MOQ-,\n.NNCJVHYx6lc-:hover,\n.NNCJVHYx6lc-:focus {\n  background-color: rgb(244, 244, 244);\n  background-color: var(--color-surface--background);\n}\n\n.NNCJVHYx6lc-:focus {\n  box-shadow: 0px 0px calc(16px / 4) calc(16px / 8)\n    rgb(231, 213, 87);\n  box-shadow: var(--shadow-focus);\n}\n\n._2IRm1sf-TUU-,\n.DTuoA8WPNzc- {\n  padding: calc(16px / 2);\n  padding: var(--space-small);\n}\n";
-var styles$3 = {"container":"_5n7VvEn39-Y-","optionsList":"KhX5VfZjAog-","option":"NNCJVHYx6lc-","selectedOption":"IvTItlT0MOQ-","filterMessage":"_2IRm1sf-TUU-","emptyStateMessage":"DTuoA8WPNzc-"};
-styleInject_es.styleInject(css_248z$3);
+var css_248z$4 = ".SgMzjOcdE-E- {\n  position: relative;\n  padding: calc(16px / 2) 0;\n  padding: var(--space-small) 0;\n}\n\n.TwoTCjgcssc- {\n  display: -ms-flexbox;\n  display: flex;\n  max-height: calc((16px / 2) * 33.33);\n  max-height: calc(calc(16px / 2) * 33.33);\n  max-height: calc(var(--space-small) * 33.33);\n  margin: 0;\n  padding: 0;\n  overflow: scroll;\n  list-style: none;\n  -ms-flex-direction: column;\n      flex-direction: column;\n  gap: calc(16px / 4);\n  gap: var(--space-smaller);\n}\n\n._2LVD-wjMRfQ- {\n  display: -ms-flexbox;\n  display: flex;\n  min-height: calc((calc(16px * 3) - calc(16px / 4)));\n  min-height: calc((var(--space-largest) - var(--space-smaller)));\n  box-sizing: border-box;\n  margin: 0 calc(16px / 2);\n  margin: 0 var(--space-small);\n  padding: calc(16px / 2);\n  padding: var(--space-small);\n  border-radius: calc(16px / 4);\n  border-radius: var(--radius-large);\n  color: rgb(1, 41, 57);\n  color: var(--color-heading);\n  font-weight: 500;\n  cursor: pointer;\n  transition: all 200ms;\n  transition: all var(--timing-base);\n  -ms-flex-pack: justify;\n      justify-content: space-between;\n  -ms-flex-align: center;\n      align-items: center;\n}\n\n._2LVD-wjMRfQ-:hover,\n._2LVD-wjMRfQ-:focus {\n  background-color: rgb(244, 244, 244);\n  background-color: var(--color-surface--background);\n}\n\n._2LVD-wjMRfQ-:focus {\n  box-shadow: 0px 0px calc(16px / 4) calc(16px / 8)\n    rgb(231, 213, 87);\n  box-shadow: var(--shadow-focus);\n}\n\n._8T5M7MGwCRE-,\n._4y5NXkNeIQM- {\n  padding: calc(16px / 2) calc(16px * 1);\n  padding: var(--space-small) var(--space-base);\n}\n\n.SgMzjOcdE-E-::after {\n  content: \"\";\n  display: block;\n  position: absolute;\n  right: 0;\n  bottom: calc(16px / 2);\n  bottom: var(--space-small);\n  left: 0;\n  height: calc(16px * 1);\n  height: var(--space-base);\n  background: linear-gradient(\n    180deg,\n    rgba(255, 255, 255, 0) 0%,\n    rgb(255, 255, 255) 100%\n  );\n}\n\n.SgMzjOcdE-E-::before {\n  content: \"\";\n  display: block;\n  position: absolute;\n  top: calc(16px / 2);\n  top: var(--space-small);\n  right: 0;\n  left: 0;\n  height: calc(16px * 1);\n  height: var(--space-base);\n  background: linear-gradient(\n    to bottom,\n    rgba(255, 255, 255, 1),\n    rgba(255, 255, 255, 0)\n  );\n}\n";
+var styles$4 = {"container":"SgMzjOcdE-E-","optionsList":"TwoTCjgcssc-","option":"_2LVD-wjMRfQ-","filterMessage":"_8T5M7MGwCRE-","emptyStateMessage":"_4y5NXkNeIQM-"};
+styleInject_es.styleInject(css_248z$4);
 
-function ComboboxList(props) {
-    return (React__default["default"].createElement("div", { className: styles$3.container },
-        !props.showEmptyState && props.options.length > 0 && (React__default["default"].createElement("ul", { className: styles$3.optionsList, role: "listbox", ref: props.optionsListRef }, !props.showEmptyState &&
+function ComboboxContentList(props) {
+    let hasSeenFirstSelected = false;
+    return (React__default["default"].createElement("div", { className: styles$4.container },
+        !props.showEmptyState && props.options.length > 0 && (React__default["default"].createElement("ul", { className: styles$4.optionsList, role: "listbox", "aria-multiselectable": props.multiselect, ref: props.optionsListRef }, !props.showEmptyState &&
             props.options.map(option => {
-                var _a;
-                const isSelected = option.id.toString() === ((_a = props.selected) === null || _a === void 0 ? void 0 : _a.id.toString());
+                const isSelected = props.selected.some(selection => selection.id.toString() === option.id.toString());
                 return (React__default["default"].createElement("li", { ref: listItem => {
-                        if (isSelected)
-                            props.setSelectedElement(listItem);
-                    }, key: option.id, tabIndex: -1, role: "option", "aria-selected": isSelected, onClick: () => props.selectionHandler(option), className: classnames__default["default"](styles$3.option, {
-                        [styles$3.selectedOption]: isSelected,
-                    }) },
+                        if (isSelected && !hasSeenFirstSelected) {
+                            props.setFirstSelectedElement(listItem);
+                            hasSeenFirstSelected = true;
+                        }
+                    }, key: option.id, tabIndex: -1, role: "option", "aria-selected": isSelected, onClick: () => props.selectionHandler(option), className: classnames__default["default"](styles$4.option) },
                     option.label,
                     isSelected && React__default["default"].createElement(Icon.Icon, { name: "checkmark", color: "blue" })));
             }))),
-        !props.showEmptyState && props.options.length === 0 && (React__default["default"].createElement("div", { className: styles$3.filterMessage },
+        !props.showEmptyState && props.options.length === 0 && (React__default["default"].createElement("div", { className: styles$4.filterMessage },
             React__default["default"].createElement(Text.Text, { variation: "subdued" },
                 "No results for ",
                 `“${props.searchValue}”`))),
-        props.showEmptyState && (React__default["default"].createElement("div", { className: styles$3.emptyStateMessage },
+        props.showEmptyState && (React__default["default"].createElement("div", { className: styles$4.emptyStateMessage },
             React__default["default"].createElement(Text.Text, { variation: "subdued" }, getZeroIndexStateText(props.subjectNoun))))));
 }
 function getZeroIndexStateText(subjectNoun) {
@@ -89,6 +89,30 @@ function getZeroIndexStateText(subjectNoun) {
     return "No options yet";
 }
 
+var css_248z$3 = ".Q-mwo-g5Fi8- {\n  display: -ms-flexbox;\n  display: flex;\n  padding: calc(16px * 1) calc(16px / 2) 0 calc(16px * 1);\n  padding: var(--space-base) var(--space-small) 0 var(--space-base);\n  -ms-flex-pack: justify;\n      justify-content: space-between;\n  gap: calc(16px / 4);\n  gap: var(--space-smaller);\n}\n";
+var styles$3 = {"header":"Q-mwo-g5Fi8-"};
+styleInject_es.styleInject(css_248z$3);
+
+function ComboboxContentHeader(props) {
+    const hasSelected = props.selectedCount > 0;
+    const actionLabel = hasSelected ? "Clear" : "Select all";
+    const label = getLabel(hasSelected, props.selectedCount, props.subjectNoun);
+    const handleSelectAll = hasSelected ? props.onClearAll : props.onSelectAll;
+    const showAction = hasSelected || props.hasOptionsVisible;
+    return (React__default["default"].createElement("div", { className: styles$3.header, "data-testid": "ATL-Combobox-Header" },
+        React__default["default"].createElement(Typography.Typography, { textColor: "heading", fontWeight: "semiBold" }, label),
+        showAction && (React__default["default"].createElement(Button.Button, { size: "small", label: actionLabel, type: "tertiary", onClick: handleSelectAll }))));
+}
+function getLabel(hasSelected, count, subjectNoun) {
+    if (hasSelected) {
+        return `${count} selected`;
+    }
+    if (subjectNoun) {
+        return `Select ${subjectNoun}`;
+    }
+    return "Select";
+}
+
 var css_248z$2 = ".W8qMZnORYxI- {\n  position: fixed;\n  top: 0;\n  right: 0;\n  bottom: 0;\n  left: 0;\n  z-index: 6;\n  z-index: var(--elevation-menu);\n  background-color: transparent;\n}\n";
 var styles$2 = {"overlay":"W8qMZnORYxI-"};
 styleInject_es.styleInject(css_248z$2);
@@ -104,24 +128,39 @@ function ComboboxContextProvider(props) {
             props.children)));
 }
 
-function useComboboxContent(options, open) {
+function useComboboxContent(options, open, selected, onClose, onSelect) {
     const [searchValue, setSearchValue] = React.useState("");
-    const [selectedElement, setSelectedElement] = React.useState(null);
+    const [firstSelectedElement, setFirstSelectedElement] = React.useState(null);
     const optionsListRef = React.useRef(null);
     const filteredOptions = options.filter(option => option.label.toLowerCase().includes(searchValue.toLowerCase()));
+    const [internalSelected, setInternalSelected] = React.useState(selected);
+    const selectedOptions = onClose ? internalSelected : selected;
+    const optionsSelectionHandler = onSelect ? onSelect : setInternalSelected;
+    React.useEffect(() => {
+        if (!open && onClose) {
+            onClose(selectedOptions);
+        }
+    }, [open, onClose, selectedOptions]);
     React.useEffect(() => {
-        if (open && selectedElement) {
-            selectedElement === null || selectedElement === void 0 ? void 0 : selectedElement.scrollIntoView({
+        if (open && firstSelectedElement) {
+            firstSelectedElement === null || firstSelectedElement === void 0 ? void 0 : firstSelectedElement.scrollIntoView({
                 block: "nearest",
             });
         }
-    }, [open, selectedElement]);
+    }, [open, firstSelectedElement]);
+    React.useEffect(() => {
+        if (selectedOptions.length === 0) {
+            setFirstSelectedElement(null);
+        }
+    }, [selectedOptions]);
     return {
         searchValue,
         setSearchValue,
-        setSelectedElement,
+        setFirstSelectedElement,
         filteredOptions,
         optionsListRef,
+        selectedOptions,
+        optionsSelectionHandler,
     };
 }
 
@@ -202,23 +241,44 @@ function useComboboxAccessibility(selectionCallback, filteredOptions, optionsLis
 }
 
 function ComboboxContent(props) {
-    const { open, setOpen, wrapperRef } = React__default["default"].useContext(ComboboxContext);
+    const { open, setOpen, wrapperRef, multiselect } = React__default["default"].useContext(ComboboxContext);
     const optionsExist = props.options.length > 0;
-    const { searchValue, setSearchValue, setSelectedElement, filteredOptions, optionsListRef, } = useComboboxContent(props.options, open);
+    const { searchValue, setSearchValue, setFirstSelectedElement, filteredOptions, optionsListRef, selectedOptions, optionsSelectionHandler, } = useComboboxContent(props.options, open, props.selected, props.onClose, props.onSelect);
     const { popperRef, popperStyles, attributes } = useComboboxAccessibility(handleSelection, filteredOptions, optionsListRef, open, setOpen, wrapperRef);
-    const template = (React__default["default"].createElement("div", Object.assign({ ref: popperRef, id: "ATL-Combobox-Content", "data-testid": "ATL-Combobox-Content", tabIndex: 0, className: classnames__default["default"](styles$5.content, { [styles$5.hidden]: !open }), style: popperStyles.popper }, attributes.popper),
-        React__default["default"].createElement(ComboboxSearch, { open: open, placeholder: props.subjectNoun, searchValue: searchValue, setSearchValue: setSearchValue }),
-        React__default["default"].createElement(ComboboxList, { showEmptyState: !optionsExist, options: filteredOptions, selected: props.selected, optionsListRef: optionsListRef, setSelectedElement: setSelectedElement, selectionHandler: handleSelection, searchValue: searchValue, subjectNoun: props.subjectNoun }),
-        props.children && (React__default["default"].createElement("div", { className: styles$5.actions, role: "group" }, React__default["default"].Children.toArray(props.children).map((child, index, childrenArray) => (React__default["default"].createElement("div", { key: index, className: classnames__default["default"]({
-                [styles$5.actionPadding]: index === childrenArray.length - 1,
+    const template = (React__default["default"].createElement("div", Object.assign({ ref: popperRef, id: "ATL-Combobox-Content", "data-testid": "ATL-Combobox-Content", tabIndex: 0, className: classnames__default["default"](styles$6.content, { [styles$6.hidden]: !open }), style: popperStyles.popper }, attributes.popper),
+        React__default["default"].createElement(ComboboxContentSearch, { open: open, placeholder: props.subjectNoun, searchValue: searchValue, setSearchValue: setSearchValue }),
+        multiselect && optionsExist && (React__default["default"].createElement(ComboboxContentHeader, { hasOptionsVisible: filteredOptions.length > 0, subjectNoun: props.subjectNoun, selectedCount: selectedOptions.length, onClearAll: () => {
+                optionsSelectionHandler([]);
+            }, onSelectAll: () => {
+                optionsSelectionHandler(filteredOptions);
+            } })),
+        React__default["default"].createElement(ComboboxContentList, { multiselect: multiselect, showEmptyState: !optionsExist, options: filteredOptions, selected: selectedOptions, optionsListRef: optionsListRef, setFirstSelectedElement: setFirstSelectedElement, selectionHandler: handleSelection, searchValue: searchValue, subjectNoun: props.subjectNoun }),
+        props.children && (React__default["default"].createElement("div", { className: styles$6.actions, role: "group" }, React__default["default"].Children.toArray(props.children).map((child, index, childrenArray) => (React__default["default"].createElement("div", { key: index, className: classnames__default["default"]({
+                [styles$6.actionPadding]: index === childrenArray.length - 1,
             }) }, child)))))));
     return ReactDOM__default["default"].createPortal(template, document.body);
     function handleSelection(selection) {
-        props.onSelect(selection);
+        if (multiselect) {
+            handleMultiSelect(optionsSelectionHandler, selectedOptions, selection);
+        }
+        else {
+            handleSingleSelect(optionsSelectionHandler, selection);
+        }
+    }
+    function handleSingleSelect(selectCallback, selection) {
+        selectCallback([selection]);
         setSearchValue("");
         setOpen(false);
     }
 }
+function handleMultiSelect(selectCallback, selected, selection) {
+    if (selected.some(s => s.id === selection.id)) {
+        selectCallback(selected.filter(s => s.id !== selection.id));
+    }
+    else {
+        selectCallback([...selected, selection]);
+    }
+}
 
 var css_248z$1 = ".Ow9wSNnGP-g- {\n  width: 100%;\n  box-sizing: border-box;\n  padding: 0 calc(16px / 2);\n  padding: 0 var(--space-small);\n  background-color: rgba(255, 255, 255, 1);\n  background-color: var(--color-surface);\n}\n\n.ncp0nKHQ7d8- {\n  position: relative;\n  width: 100%;\n  min-height: calc((calc(16px * 3) - calc(16px / 2)));\n  min-height: calc((var(--space-largest) - var(--space-small)));\n  padding: calc(16px / 2) 0;\n  padding: var(--space-small) 0;\n  border: none;\n  border-radius: calc(16px / 4);\n  border-radius: var(--radius-large);\n  text-align: left;\n  background-color: rgba(255, 255, 255, 1);\n  background-color: var(--color-surface);\n  cursor: pointer;\n  transition: all 200ms;\n  transition: all var(--timing-base);\n}\n\n.ncp0nKHQ7d8-:focus {\n  box-shadow: 0px 0px calc(16px / 4) calc(16px / 8)\n    rgb(231, 213, 87);\n  box-shadow: var(--shadow-focus);\n  background-color: rgb(244, 244, 244);\n  background-color: var(--color-surface--background);\n}\n\n.ncp0nKHQ7d8-:hover {\n  background-color: rgb(244, 244, 244);\n  background-color: var(--color-surface--background);\n}\n\n.ncp0nKHQ7d8- span {\n  margin-left: calc(16px / 2);\n  margin-left: var(--space-small);\n}\n";
 var styles$1 = {"actionContainer":"Ow9wSNnGP-g-","actionButton":"ncp0nKHQ7d8-"};
@@ -226,7 +286,7 @@ styleInject_es.styleInject(css_248z$1);
 
 function ComboboxAction(props) {
     return (React__default["default"].createElement("div", { className: styles$1.actionContainer },
-        React__default["default"].createElement("button", { className: styles$1.actionButton, onClick: props.onClick, "aria-label": props.label },
+        React__default["default"].createElement("button", { className: styles$1.actionButton, onClick: props.onClick, type: "button", "aria-label": props.label },
             React__default["default"].createElement(Typography.Typography, { element: "span", size: "base", textColor: "green", fontWeight: "semiBold" }, props.label))));
 }
 
@@ -241,7 +301,7 @@ styleInject_es.styleInject(css_248z);
 
 function ComboboxTriggerChip(props) {
     const { open, setOpen } = React__default["default"].useContext(ComboboxContext);
-    return (React__default["default"].createElement("button", { className: styles.trigger, role: "combobox", "aria-expanded": open, "aria-haspopup": "listbox", "aria-controls": "ATL-Combobox-Content", "aria-autocomplete": "list", onClick: () => {
+    return (React__default["default"].createElement("button", { className: styles.trigger, role: "combobox", type: "button", "aria-expanded": open, "aria-haspopup": "listbox", "aria-controls": "ATL-Combobox-Content", "aria-autocomplete": "list", onClick: () => {
             setOpen(!open);
         } },
         React__default["default"].createElement(Typography.Typography, { fontWeight: "semiBold", textColor: "heading" }, props.label),
@@ -251,12 +311,6 @@ function ComboboxTriggerChip(props) {
 
 const COMBOBOX_TRIGGER_COUNT_ERROR_MESSAGE = "Combobox can only have one Trigger element";
 const COMBOBOX_REQUIRED_CHILDREN_ERROR_MESSAGE = "Combobox must have a Trigger and Combobox.Content element";
-const Combobox = (props) => {
-    const { contentElement, triggerElement } = useComboboxValidation(props.children);
-    return (React__default["default"].createElement(ComboboxContextProvider, { multiselect: props.multiSelect },
-        triggerElement,
-        contentElement));
-};
 function useComboboxValidation(children) {
     const childrenArray = React__default["default"].Children.toArray(children);
     let triggerElement, contentElement, multipleTriggersFound = false;
@@ -285,12 +339,17 @@ function isTriggerElement(child) {
 function isContentElement(child) {
     return React__default["default"].isValidElement(child) && child.type === ComboboxContent;
 }
+
+const Combobox = (props) => {
+    const { contentElement, triggerElement } = useComboboxValidation(props.children);
+    return (React__default["default"].createElement(ComboboxContextProvider, { multiselect: props.multiSelect },
+        triggerElement,
+        contentElement));
+};
 Combobox.TriggerButton = ComboboxTriggerButton;
 Combobox.TriggerChip = ComboboxTriggerChip;
 Combobox.Content = ComboboxContent;
 Combobox.Action = ComboboxAction;
 
-exports.COMBOBOX_REQUIRED_CHILDREN_ERROR_MESSAGE = COMBOBOX_REQUIRED_CHILDREN_ERROR_MESSAGE;
-exports.COMBOBOX_TRIGGER_COUNT_ERROR_MESSAGE = COMBOBOX_TRIGGER_COUNT_ERROR_MESSAGE;
 exports.Combobox = Combobox;
 exports.ComboboxContextProvider = ComboboxContextProvider;