@leafygreen-ui/combobox 7.0.0-alpha.1 → 7.0.1

package/CHANGELOG.md

@@ -1,50 +1,168 @@
 # @leafygreen-ui/combobox
 
-## 7.0.0-alpha.1
+## 7.0.1
+
+### Patch Changes
+
+- 9a471879: - Updates disabled dark mode caret from `gray.dark2` to `gray.dark1`
+  - Updates dark mode dropdown border from `gray.dark3` to `gray.dark2`
+- Updated dependencies [dd4f3da8]
+- Updated dependencies [784e9d8a]
+- Updated dependencies [90053e16]
+  - @leafygreen-ui/lib@13.0.0
+  - @leafygreen-ui/icon-button@15.0.19
+  - @leafygreen-ui/typography@18.0.0
+  - @leafygreen-ui/checkbox@12.0.20
+  - @leafygreen-ui/inline-definition@6.0.13
+  - @leafygreen-ui/input-option@1.0.13
+  - @leafygreen-ui/leafygreen-provider@3.1.10
+  - @leafygreen-ui/popover@11.1.1
+
+## 7.0.0
 
 ### Major Changes
 
-- d40674fe1: Updates build tooling. No functional changes
+- 9a728c7b: Replaces internal `Chip` component with new LG `Chip` component and exposes an upgraded `TruncationLocation` object which capitalizes the first letter of each key. Instead of referring to it as `TruncationLocation.end`, it will now be represented as `TruncationLocation.End`.
 
 ### Patch Changes
 
-- Updated dependencies [d40674fe1]
-  - @leafygreen-ui/leafygreen-provider@4.0.0-alpha.1
-  - @leafygreen-ui/inline-definition@7.0.0-alpha.1
-  - @leafygreen-ui/input-option@2.0.0-alpha.1
-  - @leafygreen-ui/icon-button@16.0.0-alpha.1
-  - @leafygreen-ui/typography@17.0.0-alpha.1
-  - @leafygreen-ui/checkbox@13.0.0-alpha.1
-  - @leafygreen-ui/emotion@5.0.0-alpha.1
-  - @leafygreen-ui/palette@5.0.0-alpha.1
-  - @leafygreen-ui/popover@12.0.0-alpha.1
-  - @leafygreen-ui/tokens@3.0.0-alpha.1
-  - @leafygreen-ui/hooks@8.0.0-alpha.1
-  - @leafygreen-ui/icon@12.0.0-alpha.1
-  - @leafygreen-ui/lib@11.0.0-alpha.1
+- Updated dependencies [9a728c7b]
+  - @leafygreen-ui/chip@1.0.0
 
-## 7.0.0-alpha.0
+## 6.0.15
 
-### Major Changes
+### Patch Changes
+
+- 3a9b274d: Handles keyboard event based on the event's `key` property rather than its `keyCode` property
+- Updated dependencies [3a9b274d]
+  - @leafygreen-ui/lib@12.0.0
+  - @leafygreen-ui/checkbox@12.0.19
+  - @leafygreen-ui/icon-button@15.0.18
+  - @leafygreen-ui/inline-definition@6.0.12
+  - @leafygreen-ui/input-option@1.0.11
+  - @leafygreen-ui/leafygreen-provider@3.1.9
+  - @leafygreen-ui/popover@11.0.18
+  - @leafygreen-ui/typography@17.0.1
+
+## 6.0.14
+
+### Patch Changes
+
+- Updated dependencies [a5770c15]
+- Updated dependencies [c89d17a4]
+  - @leafygreen-ui/typography@17.0.0
+  - @leafygreen-ui/checkbox@12.0.18
+  - @leafygreen-ui/input-option@1.0.10
+
+## 6.0.13
+
+### Patch Changes
+
+- Updated dependencies [3fe03b50]
+- Updated dependencies [fd907503]
+- Updated dependencies [c9f0055a]
+- Updated dependencies [56459cde]
+  - @leafygreen-ui/tokens@2.2.0
+  - @leafygreen-ui/hooks@8.0.0
+  - @leafygreen-ui/icon@11.23.0
+  - @leafygreen-ui/checkbox@12.0.17
+  - @leafygreen-ui/leafygreen-provider@3.1.8
+  - @leafygreen-ui/popover@11.0.17
+
+## 6.0.12
+
+### Patch Changes
+
+- 4fcf2e94: Type assert children as `Array<React.ReactNode>` inside the internal function `renderedMenuContents` and add explicit return type to internal function `renderCombobox`.
+- Updated dependencies [4fcf2e94]
+- Updated dependencies [4fcf2e94]
+- Updated dependencies [4fcf2e94]
+- Updated dependencies [4fcf2e94]
+- Updated dependencies [4fcf2e94]
+- Updated dependencies [4fcf2e94]
+  - @leafygreen-ui/icon@11.22.2
+  - @leafygreen-ui/lib@11.0.0
+  - @leafygreen-ui/checkbox@12.0.16
+  - @leafygreen-ui/popover@11.0.16
+  - @leafygreen-ui/icon-button@15.0.17
+  - @leafygreen-ui/inline-definition@6.0.11
+  - @leafygreen-ui/input-option@1.0.9
+  - @leafygreen-ui/leafygreen-provider@3.1.7
+  - @leafygreen-ui/typography@16.5.5
+
+## 6.0.11
+
+### Patch Changes
+
+- c11bbc29: Fixes problem with ts-docs not being available in bundle.
+- Updated dependencies [c11bbc29]
+  - @leafygreen-ui/checkbox@12.0.15
+  - @leafygreen-ui/emotion@4.0.7
+  - @leafygreen-ui/hooks@7.7.8
+  - @leafygreen-ui/icon@11.22.1
+  - @leafygreen-ui/icon-button@15.0.16
+  - @leafygreen-ui/inline-definition@6.0.10
+  - @leafygreen-ui/input-option@1.0.8
+  - @leafygreen-ui/leafygreen-provider@3.1.6
+  - @leafygreen-ui/lib@10.4.3
+  - @leafygreen-ui/palette@4.0.7
+  - @leafygreen-ui/popover@11.0.15
+  - @leafygreen-ui/tokens@2.1.4
+  - @leafygreen-ui/typography@16.5.4
+
+## 6.0.10
+
+### Patch Changes
+
+- c15ee2ac: Fixes missing documentation file
+- Updated dependencies [f73807cf]
+- Updated dependencies [31c09354]
+- Updated dependencies [c15ee2ac]
+  - @leafygreen-ui/icon@11.22.0
+  - @leafygreen-ui/checkbox@12.0.14
+  - @leafygreen-ui/emotion@4.0.6
+  - @leafygreen-ui/hooks@7.7.7
+  - @leafygreen-ui/icon-button@15.0.15
+  - @leafygreen-ui/inline-definition@6.0.9
+  - @leafygreen-ui/input-option@1.0.7
+  - @leafygreen-ui/leafygreen-provider@3.1.5
+  - @leafygreen-ui/lib@10.4.2
+  - @leafygreen-ui/palette@4.0.6
+  - @leafygreen-ui/popover@11.0.14
+  - @leafygreen-ui/tokens@2.1.3
+  - @leafygreen-ui/typography@16.5.3
+
+## 6.0.9
+
+### Patch Changes
+
+- e8ef95e6: Updates disabled styles
+
+## 6.0.8
+
+### Patch Changes
+
+- 2603d7ac: Component props now properly inherit from `PopoverProps` interface
 
-- d40674fe1: Updates build tooling. No functional changes
+## 6.0.7
 
 ### Patch Changes
 
-- Updated dependencies [d40674fe1]
-  - @leafygreen-ui/leafygreen-provider@4.0.0-alpha.0
-  - @leafygreen-ui/inline-definition@7.0.0-alpha.0
-  - @leafygreen-ui/input-option@2.0.0-alpha.0
-  - @leafygreen-ui/icon-button@16.0.0-alpha.0
-  - @leafygreen-ui/typography@17.0.0-alpha.0
-  - @leafygreen-ui/checkbox@13.0.0-alpha.0
-  - @leafygreen-ui/emotion@5.0.0-alpha.0
-  - @leafygreen-ui/palette@5.0.0-alpha.0
-  - @leafygreen-ui/popover@12.0.0-alpha.0
-  - @leafygreen-ui/tokens@3.0.0-alpha.0
-  - @leafygreen-ui/hooks@8.0.0-alpha.0
-  - @leafygreen-ui/icon@12.0.0-alpha.0
-  - @leafygreen-ui/lib@11.0.0-alpha.0
+- 215268ff: Updates build tooling. No functional changes
+- Updated dependencies [215268ff]
+  - @leafygreen-ui/leafygreen-provider@3.1.4
+  - @leafygreen-ui/inline-definition@6.0.8
+  - @leafygreen-ui/input-option@1.0.6
+  - @leafygreen-ui/icon-button@15.0.14
+  - @leafygreen-ui/typography@16.5.2
+  - @leafygreen-ui/checkbox@12.0.13
+  - @leafygreen-ui/emotion@4.0.5
+  - @leafygreen-ui/palette@4.0.5
+  - @leafygreen-ui/popover@11.0.13
+  - @leafygreen-ui/tokens@2.1.2
+  - @leafygreen-ui/hooks@7.7.6
+  - @leafygreen-ui/icon@11.20.1
+  - @leafygreen-ui/lib@10.4.1
 
 ## 6.0.6
 

package/dist/Combobox/Combobox.d.ts

@@ -0,0 +1,48 @@
+import React from 'react';
+import PropTypes from 'prop-types';
+import { ComboboxProps } from '../Combobox.types';
+/**
+ * Combobox is a combination of a Select and TextInput,
+ * allowing the user to either type a value directly or select a value from the list.
+ * Can be configured to select a single or multiple options.
+ */
+export declare function Combobox<M extends boolean>({ children, label, description, placeholder, 'aria-label': ariaLabel, disabled, size, darkMode: darkModeProp, state, errorMessage, searchState, searchEmptyMessage, searchErrorMessage, searchLoadingMessage, filteredOptions, onFilter, clearable, onClear, overflow, multiselect, initialValue, onChange, value, chipTruncationLocation, chipCharacterLimit, className, usePortal, portalClassName, portalContainer, scrollContainer, popoverZIndex, ...rest }: ComboboxProps<M>): React.JSX.Element;
+export declare namespace Combobox {
+    var propTypes: {
+        multiselect: PropTypes.Requireable<boolean>;
+        value: PropTypes.Requireable<string | (string | null | undefined)[]>;
+        initialValue: PropTypes.Requireable<string | (string | null | undefined)[]>;
+        overflow: PropTypes.Requireable<"expand-y" | "scroll-x" | "expand-x">;
+        darkMode: PropTypes.Requireable<boolean>;
+        label: PropTypes.Requireable<string>;
+        'aria-label': PropTypes.Requireable<string>;
+        children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        onChange: PropTypes.Requireable<(...args: any[]) => any>;
+        chipCharacterLimit: PropTypes.Requireable<number>;
+        chipTruncationLocation: PropTypes.Requireable<"none" | "start" | "middle" | "end">;
+        onClear: PropTypes.Requireable<(...args: any[]) => any>;
+        onFilter: PropTypes.Requireable<(...args: any[]) => any>;
+        clearable: PropTypes.Requireable<boolean>;
+        searchLoadingMessage: PropTypes.Requireable<string>;
+        searchErrorMessage: PropTypes.Requireable<string>;
+        searchEmptyMessage: PropTypes.Requireable<string>;
+        searchState: PropTypes.Requireable<"error" | "unset" | "loading">;
+        errorMessage: PropTypes.Requireable<string>;
+        state: PropTypes.Requireable<"none" | "error">;
+        size: PropTypes.Requireable<"xsmall" | "small" | "default" | "large">;
+        disabled: PropTypes.Requireable<boolean>;
+        description: PropTypes.Requireable<string>;
+        placeholder: PropTypes.Requireable<string>;
+        filteredOptions: PropTypes.Requireable<(string | null | undefined)[]>;
+        popoverZIndex: PropTypes.Requireable<number>;
+        usePortal: PropTypes.Requireable<boolean>;
+        scrollContainer: PropTypes.Requireable<PropTypes.ReactComponentLike>;
+        portalContainer: PropTypes.Requireable<PropTypes.ReactComponentLike>;
+        portalClassName: PropTypes.Requireable<string>;
+    };
+}
+/**
+ * Why'd you have to go and make things so complicated?
+ * - Avril; and also me to myself about this component
+ */
+//# sourceMappingURL=Combobox.d.ts.map

package/dist/Combobox/Combobox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Combobox.d.ts","sourceRoot":"","sources":["../../src/Combobox/Combobox.tsx"],"names":[],"mappings":"AAAA,OAAO,KAYN,MAAM,OAAO,CAAC;AAQf,OAAO,SAAS,MAAM,YAAY,CAAC;AAkBnC,OAAO,EAEL,aAAa,EAUd,MAAM,mBAAmB,CAAC;AA4C3B;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,OAAO,EAAE,EAC1C,QAAQ,EACR,KAAK,EACL,WAAW,EACX,WAAsB,EACtB,YAAY,EAAE,SAAS,EACvB,QAAgB,EAChB,IAA2B,EAC3B,QAAQ,EAAE,YAAY,EACtB,KAAc,EACd,YAAY,EACZ,WAAqB,EACrB,kBAAuC,EACvC,kBAA6C,EAC7C,oBAA2C,EAC3C,eAAe,EACf,QAAQ,EACR,SAAgB,EAChB,OAAO,EACP,QAA2B,EAC3B,WAAwB,EACxB,YAAY,EACZ,QAAQ,EACR,KAAK,EACL,sBAAsB,EACtB,kBAAuB,EACvB,SAAS,EACT,SAAgB,EAChB,eAAe,EACf,eAAe,EACf,eAAe,EACf,aAAa,EACb,GAAG,IAAI,EACR,EAAE,aAAa,CAAC,CAAC,CAAC,qBAguClB;yBAjwCe,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8yCxB;;;GAGG"}

package/dist/Combobox/Combobox.styles.d.ts

@@ -0,0 +1,51 @@
+import { Theme } from '@leafygreen-ui/lib';
+import { ComboboxSize as Size, Overflow } from '../Combobox.types';
+/**
+ * The min-height of the combobox.
+ */
+export declare const wrapperHeight: Record<Size, number>;
+/**
+ * Size of combobox x & y padding (in px)
+ * (wrapperHeight - inputHeight(- (borderTop + borderBottom)) / 2
+ */
+export declare const comboboxPadding: Record<Size, {
+    y: number;
+    xLeftWithChip: number;
+    xLeftWithoutChip: number;
+    xRight: number;
+}>;
+/** Width of the clear icon (in px) */
+export declare const clearButtonIconSize = 28;
+/** Width of the dropdown caret icon (in px) */
+export declare const caretIconSize: 16;
+export declare const comboboxParentStyle: (size: Size) => string;
+export declare const baseComboboxStyles: string;
+export declare const comboboxThemeStyles: Record<Theme, string>;
+export declare const comboboxSizeStyles: (size: Size, isMultiselectWithSelections: boolean) => string;
+export declare const comboboxDisabledStyles: Record<Theme, string>;
+export declare const comboboxErrorStyles: Record<Theme, string>;
+export declare const comboboxFocusStyle: Record<Theme, string>;
+export declare const iconsWrapperBaseStyles: string;
+export declare const iconsWrapperSizeStyles: Record<Size, string>;
+export declare const inputWrapperStyle: ({ overflow, size, }: {
+    overflow: Overflow;
+    size: Size;
+}) => string | undefined;
+export declare const baseInputElementStyle: string;
+export declare const inputElementThemeStyle: Record<Theme, string>;
+export declare const inputElementDisabledThemeStyle: Record<Theme, string>;
+export declare const inputElementSizeStyle: (size: Size) => string;
+export declare const inputElementTransitionStyles: (isOpen: boolean) => string;
+/** Should only be applied to a multiselect */
+export declare const multiselectInputElementStyle: (size: Size, inputValue?: string) => string;
+export declare const clearButtonStyle: string;
+export declare const endIconStyle: string;
+export declare const errorMessageThemeStyle: Record<Theme, string>;
+export declare const errorMessageSizeStyle: (size: Size) => string;
+export declare const labelDescriptionContainerStyle: string;
+export declare const labelDescriptionLargeStyles: string;
+export declare const comboboxOverflowShadowStyles: Record<Theme, string>;
+export declare const errorIconThemeStyles: Record<Theme, string>;
+export declare const caretIconThemeStyles: Record<Theme, string>;
+export declare const caretIconDisabledStyles: Record<Theme, string>;
+//# sourceMappingURL=Combobox.styles.d.ts.map

package/dist/Combobox/Combobox.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Combobox.styles.d.ts","sourceRoot":"","sources":["../../src/Combobox/Combobox.styles.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAU3C,OAAO,EAAE,YAAY,IAAI,IAAI,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAoBnE;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAK9C,CAAC;AAUF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAClC,IAAI,EACJ;IACE,CAAC,EAAE,MAAM,CAAC;IACV,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB,CA0BF,CAAC;AAEF,sCAAsC;AACtC,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,+CAA+C;AAC/C,eAAO,MAAM,aAAa,IAAa,CAAC;AAExC,eAAO,MAAM,mBAAmB,SAAU,IAAI,KAAG,MAShD,CAAC;AAEF,eAAO,MAAM,kBAAkB,QA4B9B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAWrD,CAAC;AAEF,eAAO,MAAM,kBAAkB,SACvB,IAAI,+BACmB,OAAO,WAQrC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAaxD,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAOrD,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAapD,CAAC;AAEF,eAAO,MAAM,sBAAsB,QAGlC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAavD,CAAC;AAEF,eAAO,MAAM,iBAAiB;cAIlB,QAAQ;UACZ,IAAI;wBAkDX,CAAC;AAEF,eAAO,MAAM,qBAAqB,QAwBjC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAWxD,CAAC;AAEF,eAAO,MAAM,8BAA8B,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAWhE,CAAC;AAEF,eAAO,MAAM,qBAAqB,SAAU,IAAI,WAK/C,CAAC;AAEF,eAAO,MAAM,4BAA4B,WAAY,OAAO,WAM3D,CAAC;AAGF,8CAA8C;AAC9C,eAAO,MAAM,4BAA4B,SACjC,IAAI,eACG,MAAM,WAOpB,CAAC;AAEF,eAAO,MAAM,gBAAgB,QAI5B,CAAC;AAEF,eAAO,MAAM,YAAY,QAGxB,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAOxD,CAAC;AAEF,eAAO,MAAM,qBAAqB,SAAU,IAAI,WAI/C,CAAC;AAEF,eAAO,MAAM,8BAA8B,QAI1C,CAAC;AAEF,eAAO,MAAM,2BAA2B,QAGvC,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAY9D,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAGtD,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAGtD,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAGzD,CAAC"}

package/dist/Combobox/index.d.ts

@@ -0,0 +1,2 @@
+export { Combobox } from './Combobox';
+//# sourceMappingURL=index.d.ts.map

package/dist/Combobox/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Combobox/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/Combobox.types.d.ts

@@ -0,0 +1,255 @@
+import { ComponentPropsWithoutRef, ReactElement, ReactNode } from 'react';
+import { type ChipProps, TruncationLocation } from '@leafygreen-ui/chip';
+import { Either, HTMLElementProps } from '@leafygreen-ui/lib';
+import { PortalControlProps } from '@leafygreen-ui/popover';
+export { TruncationLocation };
+/**
+ * Prop Enums & Types
+ */
+export declare const ComboboxElement: {
+    readonly Input: "Input";
+    readonly ClearButton: "ClearButton";
+    readonly FirstChip: "FirstChip";
+    readonly LastChip: "LastChip";
+    readonly MiddleChip: "MiddleChip";
+    readonly Combobox: "Combobox";
+    readonly Menu: "Menu";
+};
+export declare type ComboboxElement = (typeof ComboboxElement)[keyof typeof ComboboxElement];
+/**
+ * Prop types
+ */
+export declare const ComboboxSize: {
+    readonly XSmall: "xsmall";
+    readonly Small: "small";
+    readonly Default: "default";
+    readonly Large: "large";
+};
+export declare type ComboboxSize = (typeof ComboboxSize)[keyof typeof ComboboxSize];
+export declare const Overflow: {
+    /**
+     * Combobox will be set to a fixed width, and will expand its height based on the number of Chips selected
+     */
+    readonly expandY: "expand-y";
+    /**
+     * Combobox will be set to a fixed height and width (default 100% of container). Chips will be scrollable left-right
+     */
+    readonly scrollX: "scroll-x";
+    /**
+     * @deprecated
+     */
+    readonly expandX: "expand-x";
+};
+export declare type Overflow = (typeof Overflow)[keyof typeof Overflow];
+export declare const State: {
+    readonly none: "none";
+    readonly error: "error";
+};
+export declare type State = (typeof State)[keyof typeof State];
+export declare const SearchState: {
+    readonly unset: "unset";
+    readonly error: "error";
+    readonly loading: "loading";
+};
+export declare type SearchState = (typeof SearchState)[keyof typeof SearchState];
+/**
+ * Generic Typing
+ */
+export declare type SelectValueType<M extends boolean> = M extends true ? Array<string> : string | null;
+export declare type onChangeType<M extends boolean> = M extends true ? (value: SelectValueType<true>) => void : (value: SelectValueType<false>) => void;
+export declare function getNullSelection<M extends boolean>(multiselect: M): SelectValueType<M>;
+/**
+ * Combobox Props
+ */
+export interface ComboboxMultiselectProps<M extends boolean> {
+    /**
+     * Defines whether a user can select multiple options, or only a single option.
+     * When using TypeScript, `multiselect` affects the valid values of `initialValue`, `value`, and `onChange`
+     */
+    multiselect?: M;
+    /**
+     * The initial selection.
+     * Must be a string (or array of strings) that matches the `value` prop of a `ComboboxOption`.
+     * Changing the `initialValue` after initial render will not change the selection.
+     */
+    initialValue?: SelectValueType<M>;
+    /**
+     * A callback called when the selection changes.
+     * Callback receives a single argument that is the new selection, either string, or string array
+     */
+    onChange?: onChangeType<M>;
+    /**
+     * The controlled value of the Combobox.
+     * Must be a string (or array of strings) that matches the `value` prop of a `ComboboxOption`.
+     * Changing `value` after initial render _will_ affect the selection.
+     * `value` will always take precedence over `initialValue` if both are provided.
+     */
+    value?: SelectValueType<M>;
+    /**
+     * Defines the overflow behavior of a multiselect combobox.
+     *
+     * `expand-y`: Combobox has fixed width, and additional selections will cause the element to grow in the block direction.
+     *
+     * `expand-x`: Combobox has fixed height, and additional selections will cause the element to grow in the inline direction.
+     *
+     * `scroll-x`: Combobox has fixed height and width, and additional selections will cause the element to be scrollable in the x (horizontal) direction.
+     */
+    overflow?: M extends true ? Overflow : undefined;
+}
+declare type PartialChipProps = Pick<ChipProps, 'chipTruncationLocation' | 'chipCharacterLimit' | 'popoverZIndex'>;
+export declare type BaseComboboxProps = Omit<HTMLElementProps<'div'>, 'onChange'> & PortalControlProps & PartialChipProps & {
+    /**
+     * Defines the Combobox Options by passing children. Must be `ComboboxOption` or `ComboboxGroup`
+     */
+    children?: ReactNode;
+    /**
+     * An accessible label for the input, rendered in a <label> to the DOM
+     */
+    label?: string;
+    /**
+     * An accessible label for the input, used only for screen-readers
+     */
+    'aria-label'?: string;
+    /**
+     * A description for the input
+     */
+    description?: string;
+    /**
+     * A placeholder for the input element. Uses the native `placeholder` attribute.
+     */
+    placeholder?: string;
+    /**
+     * Disables all interaction with the component
+     */
+    disabled?: boolean;
+    /**
+     * Defines the visual size of the component
+     */
+    size?: ComboboxSize;
+    /**
+     * Toggles Dark Mode
+     */
+    darkMode?: boolean;
+    /**
+     * The error state of the component. Defines whether the error message is displayed.
+     */
+    state?: State;
+    /**
+     * The message shown below the input when state is `error`
+     */
+    errorMessage?: string;
+    /**
+     * The state of search results. Toggles search messages within the menu.
+     */
+    searchState?: SearchState;
+    /**
+     * A message shown within the menu when there are no options passed in as children, or `filteredOptions` is an empty array
+     */
+    searchEmptyMessage?: string;
+    /**
+     * A message shown within the menu when searchState is `error`
+     */
+    searchErrorMessage?: string;
+    /**
+     * A message shown within the menu when searchState is `loading`
+     */
+    searchLoadingMessage?: string;
+    /**
+     * A callback called when the search input changes.
+     * Receives a single argument that is the current input value.
+     * Use this callback to set `searchState` and/or `filteredOptions` appropriately
+     */
+    onFilter?: (value: string) => void;
+    /**
+     * Defines whether the Clear button appears to the right of the input.
+     */
+    clearable?: boolean;
+    /**
+     * A callback fired when the Clear button is pressed.
+     * Fired _after_ `onChange`, and _before_ `onFilter`
+     */
+    onClear?: (e: React.MouseEvent<HTMLButtonElement, MouseEvent>) => void;
+    /**
+     * An array used to define which options are displayed.
+     * Do not remove options from the JSX children, as this will affect the selected options
+     */
+    filteredOptions?: Array<string>;
+};
+export declare type ComboboxProps<M extends boolean> = Either<BaseComboboxProps & ComboboxMultiselectProps<M>, 'label' | 'aria-label'>;
+/**
+ * Combobox Option Props
+ */
+declare type ListItemProps = Omit<ComponentPropsWithoutRef<'li'>, 'onClick' | 'value'>;
+interface SharedComboboxOptionProps {
+    /**
+     * The internal value of the option. Used as the identifier in Combobox `initialValue`, value and filteredOptions.
+     * When undefined, this is set to `_.kebabCase(displayName)`
+     */
+    value?: string;
+    /**
+     * The display value of the option. Used as the rendered string within the menu and chips.
+     * When undefined, this is set to `value`
+     */
+    displayName?: string;
+    /**
+     * The icon to display to the left of the option in the menu.
+     */
+    glyph?: ReactElement;
+    /**
+     * Defines whether the option is disabled.
+     * Node: disabled options are still rendered in the menu, but not selectable.
+     */
+    disabled?: boolean;
+    /**
+     * Styling Prop
+     */
+    className?: string;
+    /**
+     * Optional descriptive text under the displayName.
+     */
+    description?: string;
+    /**
+     * Callback fired when an option is clicked.
+     */
+    onClick?: (event: React.SyntheticEvent<HTMLLIElement, Event>, value: string) => void;
+}
+declare type RequiredComboboxOptionProps = Required<Pick<SharedComboboxOptionProps, 'value' | 'displayName'>>;
+declare type BaseComboboxOptionProps = ListItemProps & SharedComboboxOptionProps;
+export declare type ComboboxOptionProps = Either<BaseComboboxOptionProps, 'value' | 'displayName'>;
+export interface OptionObject extends Pick<SharedComboboxOptionProps, 'description' | 'onClick'>, RequiredComboboxOptionProps {
+    isDisabled: boolean;
+    hasGlyph?: boolean;
+}
+export interface InternalComboboxOptionProps extends ListItemProps, Omit<SharedComboboxOptionProps, 'value' | 'displayName'>, RequiredComboboxOptionProps {
+    isSelected: boolean;
+    isFocused: boolean;
+    setSelected: () => void;
+    index: number;
+}
+/**
+ * Combobox Group Props
+ */
+export interface ComboboxGroupProps {
+    /**
+     * Label for the group of options
+     */
+    label: string;
+    /**
+     * Options in the group. Must be one or more `ComboboxOption` components
+     */
+    children: React.ReactNode;
+    /**
+     * Styling prop
+     */
+    className?: string;
+}
+/**
+ * Combobox Chip
+ */
+export interface ComboboxChipProps {
+    displayName: string;
+    isFocused: boolean;
+    onRemove: () => void;
+    onFocus: () => void;
+}
+//# sourceMappingURL=Combobox.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Combobox.types.d.ts","sourceRoot":"","sources":["../src/Combobox.types.ts"],"names":[],"mappings":"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"}

package/dist/ComboboxChip/ComboboxChip.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import { ComboboxChipProps } from '../Combobox.types';
+export declare const ComboboxChip: React.ForwardRefExoticComponent<ComboboxChipProps & React.RefAttributes<HTMLSpanElement>>;
+//# sourceMappingURL=ComboboxChip.d.ts.map

package/dist/ComboboxChip/ComboboxChip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComboboxChip.d.ts","sourceRoot":"","sources":["../../src/ComboboxChip/ComboboxChip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAgC,MAAM,OAAO,CAAC;AAOrD,OAAO,EACL,iBAAiB,EAGlB,MAAM,mBAAmB,CAAC;AAK3B,eAAO,MAAM,YAAY,2FA6ExB,CAAC"}

package/dist/ComboboxChip/ComboboxChip.stories.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import { StoryMetaType } from '@leafygreen-ui/lib';
+import { ComboboxChip } from './ComboboxChip';
+declare const meta: StoryMetaType<typeof ComboboxChip>;
+export default meta;
+export declare const Generated: () => React.JSX.Element;
+//# sourceMappingURL=ComboboxChip.stories.d.ts.map

package/dist/ComboboxChip/ComboboxChip.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComboboxChip.stories.d.ts","sourceRoot":"","sources":["../../src/ComboboxChip/ComboboxChip.stories.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,QAAA,MAAM,IAAI,EAAE,aAAa,CAAC,OAAO,YAAY,CAuB5C,CAAC;AACF,eAAe,IAAI,CAAC;AAEpB,eAAO,MAAM,SAAS,yBAAc,CAAC"}

package/dist/ComboboxChip/ComboboxChip.styles.d.ts

@@ -0,0 +1,24 @@
+import { ComboboxSize } from '../Combobox.types';
+export declare const chipClassName: string;
+/**
+ * The line-height of the combobox.
+ */
+export declare const lineHeight: Record<ComboboxSize, number>;
+/**
+ * The font-size of the combobox.
+ */
+export declare const fontSize: Record<ComboboxSize, number>;
+/**
+ * Vertical padding on a chip (in px)
+ */
+export declare const chipWrapperPaddingY: {
+    readonly xsmall: 1;
+    readonly small: 0;
+    readonly default: 2;
+    readonly large: 4;
+};
+/**
+ * Override chip sizes
+ */
+export declare const chipSizeStyles: Record<ComboboxSize, string>;
+//# sourceMappingURL=ComboboxChip.styles.d.ts.map

package/dist/ComboboxChip/ComboboxChip.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComboboxChip.styles.d.ts","sourceRoot":"","sources":["../../src/ComboboxChip/ComboboxChip.styles.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,eAAO,MAAM,aAAa,QAAyC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAKnD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAKjD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;CAKtB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAkCvD,CAAC"}

package/dist/ComboboxChip/index.d.ts

@@ -0,0 +1,2 @@
+export { ComboboxChip } from './ComboboxChip';
+//# sourceMappingURL=index.d.ts.map

package/dist/ComboboxChip/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ComboboxChip/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}