@mezzanine-ui/react 0.7.2 → 0.8.1

package/Form/useAutoCompleteValueControl.d.ts

@@ -17,7 +17,7 @@ export interface AutoCompleteValueControl {
     options: string[];
     searchText: string;
     setSearchText: Dispatch<SetStateAction<string>>;
-    setValue: Dispatch<SetStateAction<string>>;
-    value: SelectValue[];
+    setValue: (text: string) => void;
+    value: SelectValue | null;
 }
 export declare function useAutoCompleteValueControl(props: UseAutoCompleteValueControl): AutoCompleteValueControl;

package/Form/useAutoCompleteValueControl.js

@@ -11,6 +11,10 @@ function useAutoCompleteValueControl(props) {
     });
     const [searchText, setSearchText] = useState('');
     const [focused, setFocused] = useState(false);
+    const onChangeValue = useCallback((text) => {
+        setValue(text);
+        onChange === null || onChange === void 0 ? void 0 : onChange(text);
+    }, [setValue, onChange]);
     const onFocus = useCallback((focus) => {
         setFocused(focus);
         /** sync current value */
@@ -21,10 +25,10 @@ function useAutoCompleteValueControl(props) {
         value,
         onChange,
     ]);
-    const getCurrentInputValue = () => (value ? [{
-            id: value,
-            name: value,
-        }] : []);
+    const getCurrentInputValue = () => (value ? {
+        id: value,
+        name: value,
+    } : null);
     const options = disabledOptionsFilter
         ? optionsProp
         : optionsProp.filter((option) => ~option.search(searchText));
@@ -50,7 +54,7 @@ function useAutoCompleteValueControl(props) {
         options,
         searchText,
         setSearchText,
-        setValue,
+        setValue: onChangeValue,
         value: getCurrentInputValue(),
     };
 }

package/Form/useInputWithTagsModeValue.d.ts

@@ -0,0 +1,37 @@
+import { ChangeEvent, KeyboardEvent, RefObject } from 'react';
+import { UseInputControlValueProps } from './useInputControlValue';
+export declare type TagsType = string[] | number[];
+export interface UseInputWithTagsModeValueProps<E extends HTMLInputElement | HTMLTextAreaElement> extends UseInputControlValueProps<E> {
+    /**
+     * The value of initial tags
+     */
+    initialTagsValue?: string[];
+    /**
+     * Maximum permitted length of the tags
+     * @default 3
+     */
+    maxTagsLength?: number;
+    /**
+     * The change event handler of tags
+     */
+    onTagsChange?: (tags: TagsType) => void;
+    /**
+     * The ref object of input element
+     */
+    ref: RefObject<E>;
+    /**
+     * Will skip `onKeyDown` calling if `true`
+     * @default false
+     */
+    skip?: boolean;
+    /**
+     * Maximum length of value on each tag
+     * @default 8
+     */
+    tagValueMaxLength?: number;
+}
+export declare function useInputWithTagsModeValue<E extends HTMLInputElement | HTMLTextAreaElement>(props: Omit<UseInputWithTagsModeValueProps<E>, 'onChange'>): readonly [{
+    readonly tags: string[];
+    readonly typingValue: string;
+    readonly tagsReachedMax: boolean;
+}, (event: ChangeEvent<E> | null) => void, () => void, (tag: string) => void, (e: KeyboardEvent) => void];

package/Form/useInputWithTagsModeValue.js

@@ -0,0 +1,88 @@
+import { useRef, useState, useCallback } from 'react';
+import { useInputControlValue } from './useInputControlValue.js';
+
+function useInputWithTagsModeValue(props) {
+    var _a;
+    const { defaultValue, initialTagsValue = [], maxTagsLength, onTagsChange: onChangeProp, ref, skip = false, tagValueMaxLength = 8, } = props;
+    const canActive = !skip;
+    const activeMaxTagsLength = maxTagsLength || Math.max(3, initialTagsValue.length);
+    const tagsSetRef = useRef(new Set(initialTagsValue.map((initialTag) => initialTag.trim())));
+    const inputTypeIsNumber = useRef(((_a = ref.current) === null || _a === void 0 ? void 0 : _a.type) === 'number');
+    const tagValueTransform = (tag) => (tag.slice(0, tagValueMaxLength).trim());
+    const transformNumberTags = (tags) => (tags.map((tag) => Number(tag)));
+    const generateUniqueTags = () => (Array
+        .from(tagsSetRef.current.values())
+        .map((initialTag) => tagValueTransform(initialTag)));
+    const [value, setValue] = useInputControlValue({
+        defaultValue: canActive ? defaultValue : undefined,
+    });
+    const [tags, setTags] = useState(generateUniqueTags()
+        .slice(0, activeMaxTagsLength));
+    const tagsWillOverflow = useCallback(() => (tagsSetRef.current.size === activeMaxTagsLength), []);
+    const clearTypingFieldValue = () => {
+        if (!canActive)
+            return;
+        const target = ref.current;
+        if (target) {
+            const changeEvent = Object.create({});
+            changeEvent.target = target;
+            changeEvent.currentTarget = target;
+            target.value = '';
+            setValue(changeEvent);
+        }
+    };
+    const onClear = () => {
+        if (!canActive)
+            return;
+        clearTypingFieldValue();
+        tagsSetRef.current.clear();
+        setTags([]);
+        onChangeProp === null || onChangeProp === void 0 ? void 0 : onChangeProp([]);
+    };
+    const onChange = (event) => {
+        if (canActive && event) {
+            setValue(event);
+        }
+    };
+    const onRemove = (tag) => {
+        tagsSetRef.current.delete(tag);
+        const numberTag = inputTypeIsNumber.current;
+        const newTags = generateUniqueTags();
+        setTags(newTags);
+        onChangeProp === null || onChangeProp === void 0 ? void 0 : onChangeProp(numberTag ? transformNumberTags(newTags) : newTags);
+    };
+    const onKeyDown = useCallback((e) => {
+        var _a;
+        if (!canActive)
+            return;
+        const element = ref.current;
+        if (element && (element === null || element === void 0 ? void 0 : element.value) &&
+            (e.key === 'Enter' || e.code === 'Enter') &&
+            !e.nativeEvent.isComposing &&
+            !tagsWillOverflow()) {
+            e.preventDefault();
+            inputTypeIsNumber.current = ((_a = ref.current) === null || _a === void 0 ? void 0 : _a.type) === 'number';
+            const tagsSet = tagsSetRef.current;
+            const isNumber = inputTypeIsNumber.current;
+            const newTagValue = tagValueTransform(element.value);
+            tagsSet.add(newTagValue);
+            const newTags = generateUniqueTags();
+            setTags(newTags);
+            onChangeProp === null || onChangeProp === void 0 ? void 0 : onChangeProp(isNumber ? transformNumberTags(newTags) : newTags);
+            clearTypingFieldValue();
+        }
+    }, [tagsWillOverflow]);
+    return [
+        {
+            tags,
+            typingValue: value,
+            tagsReachedMax: tagsWillOverflow(),
+        },
+        onChange,
+        onClear,
+        onRemove,
+        onKeyDown,
+    ];
+}
+
+export { useInputWithTagsModeValue };

package/Form/useSelectValueControl.d.ts

@@ -1,16 +1,33 @@
 import { MouseEvent } from 'react';
 import { SelectValue } from '../Select/typings';
-export interface UseSelectValueControl {
-    defaultValue?: SelectValue[];
-    mode: string;
-    onChange?(newOptions: SelectValue[]): any;
+export interface UseSelectBaseValueControl {
     onClear?(e: MouseEvent<Element>): void;
+    onChange?(newOptions: SelectValue[] | SelectValue): any;
     onClose?(): void;
+}
+export declare type UseSelectMultipleValueControl = UseSelectBaseValueControl & {
+    defaultValue?: SelectValue[];
+    mode: 'multiple';
+    onChange?(newOptions: SelectValue[]): any;
     value?: SelectValue[];
+};
+export declare type UseSelectSingleValueControl = UseSelectBaseValueControl & {
+    defaultValue?: SelectValue;
+    mode: 'single';
+    onChange?(newOption: SelectValue): any;
+    value?: SelectValue | null;
+};
+export declare type UseSelectValueControl = UseSelectMultipleValueControl | UseSelectSingleValueControl;
+export interface SelectBaseValueControl {
+    onClear(e: MouseEvent<Element>): void;
 }
-export interface SelectValueControl {
+export declare type SelectMultipleValueControl = SelectBaseValueControl & {
     onChange: (v: SelectValue | null) => SelectValue[];
-    onClear(e: MouseEvent<Element>): void;
     value: SelectValue[];
-}
-export declare function useSelectValueControl(props: UseSelectValueControl): SelectValueControl;
+};
+export declare type SelectSingleValueControl = SelectBaseValueControl & {
+    onChange: (v: SelectValue | null) => SelectValue | null;
+    value: SelectValue | null;
+};
+export declare type SelectValueControl = SelectMultipleValueControl | SelectSingleValueControl;
+export declare const useSelectValueControl: (props: UseSelectValueControl) => SelectValueControl;

package/Form/useSelectValueControl.js

@@ -1,31 +1,28 @@
-import intersectionBy from 'lodash/intersectionBy';
+import isEqual from 'lodash/isEqual';
 import { useControlValueState } from './useControlValueState.js';
 
-const equalityFn = (a, b) => (a.length === b.length && intersectionBy(a, b, 'id').length === a.length);
-function useSelectValueControl(props) {
+const equalityFn = (a, b) => isEqual(a, b);
+function useSelectBaseValueControl(props) {
     const { defaultValue, mode, onChange, onClear: onClearProp, onClose, value: valueProp, } = props;
     const [value, setValue] = useControlValueState({
-        defaultValue: defaultValue || [],
+        defaultValue: defaultValue || (mode === 'multiple' ? [] : null),
         equalityFn,
         value: valueProp,
     });
     return {
         value,
         onChange: (chooseOption) => {
-            if (!chooseOption)
-                return [];
-            let newValue = [];
-            switch (mode) {
-                case 'single': {
-                    newValue = [chooseOption];
-                    if (typeof onClose === 'function') {
-                        /** single selection should close modal when clicked */
-                        onClose();
-                    }
-                    break;
+            var _a;
+            if (!chooseOption) {
+                if (mode === 'multiple') {
+                    return [];
                 }
+                return null;
+            }
+            let newValue = mode === 'multiple' ? [] : null;
+            switch (mode) {
                 case 'multiple': {
-                    const existedValueIdx = (value !== null && value !== void 0 ? value : []).findIndex((v) => v.id === chooseOption.id);
+                    const existedValueIdx = ((_a = value) !== null && _a !== void 0 ? _a : []).findIndex((v) => v.id === chooseOption.id);
                     if (~existedValueIdx) {
                         newValue = [
                             ...value.slice(0, existedValueIdx),
@@ -38,22 +35,43 @@ function useSelectValueControl(props) {
                             chooseOption,
                         ];
                     }
+                    if (typeof onChange === 'function')
+                        onChange(newValue);
+                    break;
+                }
+                default: {
+                    newValue = chooseOption;
+                    if (typeof onClose === 'function') {
+                        /** single selection should close modal when clicked */
+                        onClose();
+                    }
+                    if (typeof onChange === 'function')
+                        onChange(newValue);
                     break;
                 }
             }
             setValue(newValue);
-            if (typeof onChange === 'function')
-                onChange(newValue);
             return newValue;
         },
         onClear: (e) => {
             e.stopPropagation();
-            setValue([]);
+            if (mode === 'multiple') {
+                setValue([]);
+            }
+            else {
+                setValue(null);
+            }
             if (typeof onClearProp === 'function') {
                 onClearProp(e);
             }
         },
     };
-}
+}
+const useSelectValueControl = (props) => {
+    if (props.mode === 'multiple') {
+        return useSelectBaseValueControl(props);
+    }
+    return useSelectBaseValueControl(props);
+};
 
 export { useSelectValueControl };

package/Icon/Icon.js

@@ -11,6 +11,7 @@ const Icon = forwardRef(function Icon(props, ref) {
     const { definition } = icon;
     const cssVars = toIconCssVars({ color, size });
     const style = {
+        '--mzn-icon-cursor': props.onClick || props.onMouseOver ? 'pointer' : 'inherit',
         ...cssVars,
         ...styleProp,
     };

package/Input/Input.d.ts

@@ -1,6 +1,7 @@
 import { Ref, ChangeEventHandler } from 'react';
 import { InputSize } from '@mezzanine-ui/core/input';
 import { NativeElementPropsWithoutKeyAndRef } from '../utils/jsx-types';
+import type { TagsType } from '../Form/useInputWithTagsModeValue';
 import { TextFieldProps } from '../TextField';
 export interface InputProps extends Omit<TextFieldProps, 'active' | 'children' | 'onClear' | 'onKeyDown'> {
     /**
@@ -15,6 +16,11 @@ export interface InputProps extends Omit<TextFieldProps, 'active' | 'children' |
      * The other native props for input element.
      */
     inputProps?: Omit<NativeElementPropsWithoutKeyAndRef<'input'>, 'defaultValue' | 'disabled' | 'onChange' | 'placeholder' | 'readOnly' | 'required' | 'value' | `aria-${'disabled' | 'multiline' | 'readonly' | 'required'}`>;
+    /**
+     * The input value mode
+     * @default 'default'
+     */
+    mode?: 'default' | 'tags';
     /**
      * The change event handler of input element.
      */
@@ -38,6 +44,28 @@ export interface InputProps extends Omit<TextFieldProps, 'active' | 'children' |
      * @default 'medium'
      */
     size?: InputSize;
+    /**
+      * The props for input element with tags mode.
+      */
+    tagsProps?: {
+        /**
+         * The initial value of tags
+         */
+        initialTagsValue?: string[];
+        /**
+         * The position of input field on tags mode
+         * @default 'bottom''
+         */
+        inputPosition?: 'top' | 'bottom';
+        /**
+         * Maximum permitted length of the tags
+         */
+        maxTagsLength?: number;
+        /**
+        * The change event handler of input tags value.
+        */
+        onTagsChange?: (tags: TagsType) => void;
+    };
     /**
      * The value of input.
      */

package/Input/Input.js

@@ -1,9 +1,12 @@
-import { jsx } from 'react/jsx-runtime';
+import { jsxs, jsx } from 'react/jsx-runtime';
 import { forwardRef, useContext, useRef } from 'react';
 import { inputClasses } from '@mezzanine-ui/core/input';
+import { selectClasses } from '@mezzanine-ui/core/select';
 import { useComposeRefs } from '../hooks/useComposeRefs.js';
 import { useInputWithClearControlValue } from '../Form/useInputWithClearControlValue.js';
+import { useInputWithTagsModeValue } from '../Form/useInputWithTagsModeValue.js';
 import TextField from '../TextField/TextField.js';
+import Tag from '../Tag/Tag.js';
 import { FormControlContext } from '../Form/FormControlContext.js';
 import cx from 'clsx';
 
@@ -12,7 +15,9 @@ import cx from 'clsx';
  */
 const Input = forwardRef(function Input(props, ref) {
     const { disabled: disabledFromFormControl, fullWidth: fullWidthFromFormControl, required: requiredFromFormControl, severity, } = useContext(FormControlContext) || {};
-    const { className, clearable = false, defaultValue, disabled = disabledFromFormControl || false, error = severity === 'error' || false, fullWidth = fullWidthFromFormControl || false, inputRef: inputRefProp, inputProps, onChange: onChangeProp, placeholder, prefix, readOnly = false, required = requiredFromFormControl || false, size = 'medium', suffix, value: valueProp, } = props;
+    const { className, clearable = false, defaultValue, disabled = disabledFromFormControl || false, error = severity === 'error' || false, fullWidth = fullWidthFromFormControl || false, inputProps, inputRef: inputRefProp, mode = 'default', onChange: onChangeProp, placeholder, prefix, readOnly = false, required = requiredFromFormControl || false, size = 'medium', suffix, tagsProps, value: valueProp, } = props;
+    const { initialTagsValue, inputPosition = 'bottom', maxTagsLength, onTagsChange, } = tagsProps || {};
+    const tagsMode = mode === 'tags';
     const inputRef = useRef(null);
     const [value, onChange, onClear,] = useInputWithClearControlValue({
         defaultValue,
@@ -20,9 +25,27 @@ const Input = forwardRef(function Input(props, ref) {
         ref: inputRef,
         value: valueProp,
     });
+    const [{ tags, tagsReachedMax, }, tagsModeOnChange, tagsModeOnClear, tagsModeOnRemove, onKeyDown,] = useInputWithTagsModeValue({
+        defaultValue,
+        initialTagsValue,
+        maxTagsLength,
+        onTagsChange,
+        ref: inputRef,
+        skip: !tagsMode,
+        tagValueMaxLength: inputProps === null || inputProps === void 0 ? void 0 : inputProps.maxLength,
+        value: valueProp,
+    });
     const composedInputRef = useComposeRefs([inputRefProp, inputRef]);
+    const maxLength = () => (tagsMode
+        ? Math.min((inputProps === null || inputProps === void 0 ? void 0 : inputProps.maxLength) || 8, 8)
+        : inputProps === null || inputProps === void 0 ? void 0 : inputProps.maxLength);
     const active = !!value;
-    return (jsx(TextField, Object.assign({ ref: ref, active: active, className: cx(inputClasses.host, className), clearable: clearable, disabled: disabled, error: error, fullWidth: fullWidth, onClear: onClear, prefix: prefix, size: size, suffix: suffix }, { children: jsx("input", Object.assign({}, inputProps, { ref: composedInputRef, "aria-disabled": disabled, "aria-multiline": false, "aria-readonly": readOnly, "aria-required": required, disabled: disabled, onChange: onChange, placeholder: placeholder, readOnly: readOnly, required: required, value: value }), void 0) }), void 0));
+    const mountInput = !tagsMode || !tagsReachedMax;
+    return (jsxs(TextField, Object.assign({ ref: ref, active: active, className: cx(inputClasses.host, tagsMode && inputClasses.tagsMode, inputPosition === 'top' && inputClasses.tagsModeInputOnTop, className), clearable: clearable, disabled: disabled, error: error, fullWidth: fullWidth, onClear: tagsMode ? tagsModeOnClear : onClear, prefix: mountInput ? prefix : undefined, suffix: mountInput ? suffix : undefined, size: size }, { children: [tagsMode && (jsx("div", Object.assign({ className: selectClasses.triggerTags }, { children: tags.map((tag) => (jsx(Tag, Object.assign({ closable: true, disabled: disabled, size: size, onClose: (e) => {
+                        e.stopPropagation();
+                        tagsModeOnRemove(tag);
+                    } }, { children: tag }), tag))) }), void 0)),
+            mountInput && (jsx("input", Object.assign({}, inputProps, { "aria-disabled": disabled, "aria-multiline": false, "aria-readonly": readOnly, "aria-required": required, disabled: disabled, maxLength: maxLength(), onChange: tagsMode ? tagsModeOnChange : onChange, onKeyDown: tagsMode ? onKeyDown : inputProps === null || inputProps === void 0 ? void 0 : inputProps.onKeyDown, placeholder: placeholder, readOnly: readOnly, ref: composedInputRef, required: required, value: tagsMode ? undefined : value }), void 0))] }), void 0));
 });
 var Input$1 = Input;
 

package/Select/AutoComplete.js

@@ -22,7 +22,7 @@ const MENU_ID = 'mzn-select-autocomplete-menu-id';
  * should considering using the `Select` component with `onSearch` prop.
  */
 const AutoComplete = forwardRef(function Select(props, ref) {
-    var _a, _b;
+    var _a;
     const { disabled: disabledFromFormControl, fullWidth: fullWidthFromFormControl, required: requiredFromFormControl, severity, } = useContext(FormControlContext) || {};
     const { addable = false, className, disabled = disabledFromFormControl || false, disabledOptionsFilter = false, defaultValue, error = severity === 'error' || false, fullWidth = fullWidthFromFormControl || false, inputRef, inputProps, itemsInView = 4, menuMaxHeight, menuRole = 'listbox', menuSize = 'medium', onChange: onChangeProp, onClear: onClearProp, onInsert, onSearch, options: optionsProp, popperOptions = {}, placeholder = '', prefix, required = requiredFromFormControl || false, size = 'medium', value: valueProp, } = props;
     const [open, toggleOpen] = useState(false);
@@ -87,8 +87,10 @@ const AutoComplete = forwardRef(function Select(props, ref) {
     return (jsx(SelectControlContext.Provider, Object.assign({ value: {
             onChange,
             value,
-        } }, { children: jsxs("div", Object.assign({ ref: nodeRef, className: selectClasses.host }, { children: [jsx(SelectTrigger, { ref: composedRef, active: open, className: className, clearable: true, disabled: disabled, error: error, forceHideSuffixActionIcon: true, fullWidth: fullWidth, inputRef: inputRef, mode: "single", onTagClose: onChange, onClear: onClear, prefix: prefix, readOnly: false, required: required, inputProps: resolvedInputProps, size: size, suffixActionIcon: undefined, value: value }, void 0),
-                jsxs(InputTriggerPopper, Object.assign({ ref: popperRef, anchor: controlRef, className: selectClasses.popper, open: open, sameWidth: true, options: popperOptions }, { children: [jsxs(Menu, Object.assign({ id: MENU_ID, "aria-activedescendant": (_b = (_a = value[0]) === null || _a === void 0 ? void 0 : _a.id) !== null && _b !== void 0 ? _b : '', itemsInView: itemsInView, maxHeight: menuMaxHeight, role: menuRole, size: menuSize, style: { border: 0 } }, { children: [jsx(Option, Object.assign({ value: searchText }, { children: searchText }), void 0),
+        } }, { children: jsxs("div", Object.assign({ ref: nodeRef, className: cx(selectClasses.host, {
+                [selectClasses.hostFullWidth]: fullWidth,
+            }) }, { children: [jsx(SelectTrigger, { ref: composedRef, active: open, className: className, clearable: true, disabled: disabled, error: error, forceHideSuffixActionIcon: true, fullWidth: fullWidth, inputRef: inputRef, mode: "single", onTagClose: onChange, onClear: onClear, prefix: prefix, readOnly: false, required: required, inputProps: resolvedInputProps, size: size, suffixActionIcon: undefined, value: value }, void 0),
+                jsxs(InputTriggerPopper, Object.assign({ ref: popperRef, anchor: controlRef, className: selectClasses.popper, open: open, sameWidth: true, options: popperOptions }, { children: [jsxs(Menu, Object.assign({ id: MENU_ID, "aria-activedescendant": (_a = value === null || value === void 0 ? void 0 : value.id) !== null && _a !== void 0 ? _a : '', itemsInView: itemsInView, maxHeight: menuMaxHeight, role: menuRole, size: menuSize, style: { border: 0 } }, { children: [jsx(Option, Object.assign({ value: searchText }, { children: searchText }), void 0),
                                 options.length ? options.map((option) => (jsx(Option, Object.assign({ value: option }, { children: option }), option))) : (jsx(Empty, { children: "\u67E5\u7121\u8CC7\u6599" }, void 0))] }), void 0),
                         addable ? (jsxs("div", Object.assign({ className: selectClasses.autoComplete }, { children: [jsx("input", { type: "text", onChange: (e) => setInsertText(e.target.value), onClick: (e) => e.stopPropagation(), onFocus: (e) => e.stopPropagation(), placeholder: "\u65B0\u589E\u9078\u9805", value: insertText }, void 0),
                                 jsx(Icon, { className: cx(selectClasses.autoCompleteIcon, {

package/Select/Option.js

@@ -7,7 +7,19 @@ const Option = forwardRef(function Option(props, ref) {
     const { active: activeProp, children, role = 'option', value, ...rest } = props;
     const selectControl = useContext(SelectControlContext);
     const { onChange, value: selectedValue, } = selectControl || {};
-    const active = Boolean(activeProp || (selectedValue !== null && selectedValue !== void 0 ? selectedValue : []).find((sv) => sv.id === value));
+    const getActive = () => {
+        if (activeProp) {
+            return activeProp;
+        }
+        if (selectedValue) {
+            if (Array.isArray(selectedValue)) {
+                return selectedValue.find((sv) => sv.id === value);
+            }
+            return selectedValue.id === value;
+        }
+        return false;
+    };
+    const active = Boolean(getActive());
     const onSelect = () => {
         if (typeof onChange === 'function' && value) {
             onChange({

package/Select/Select.d.ts

@@ -6,25 +6,17 @@ import { PopperProps } from '../Popper';
 import { SelectValue } from './typings';
 import { PickRenameMulti } from '../utils/general';
 import { SelectTriggerProps, SelectTriggerInputProps } from './SelectTrigger';
-export interface SelectProps extends Omit<SelectTriggerProps, 'active' | 'inputProps' | 'onBlur' | 'onChange' | 'onClick' | 'onFocus' | 'onKeyDown'>, FormElementFocusHandlers, PickRenameMulti<Pick<MenuProps, 'itemsInView' | 'maxHeight' | 'role' | 'size'>, {
+export interface SelectBaseProps extends Omit<SelectTriggerProps, 'active' | 'inputProps' | 'mode' | 'onBlur' | 'onChange' | 'onClick' | 'onFocus' | 'onKeyDown' | 'renderValue' | 'value'>, FormElementFocusHandlers, PickRenameMulti<Pick<MenuProps, 'itemsInView' | 'maxHeight' | 'role' | 'size'>, {
     maxHeight: 'menuMaxHeight';
     role: 'menuRole';
     size: 'menuSize';
 }>, PickRenameMulti<Pick<PopperProps, 'options'>, {
     options: 'popperOptions';
 }>, Pick<MenuProps, 'children'> {
-    /**
-     * The default selection
-     */
-    defaultValue?: SelectValue[];
     /**
      * The other native props for input element.
      */
     inputProps?: Omit<SelectTriggerInputProps, 'onBlur' | 'onChange' | 'onFocus' | 'placeholder' | 'role' | 'value' | `aria-${'controls' | 'expanded' | 'owns'}`>;
-    /**
-     * The change event handler of input element.
-     */
-    onChange?(newOptions: SelectValue[]): any;
     /**
      * The search event handler, this prop won't work when mode is `multiple`
      */
@@ -36,7 +28,7 @@ export interface SelectProps extends Omit<SelectTriggerProps, 'active' | 'inputP
     /**
      * To customize rendering select input value
      */
-    renderValue?(values: SelectValue[]): string;
+    renderValue?(values: SelectValue[] | SelectValue | null): string;
     /**
      * Whether the selection is required.
      * @default false
@@ -47,11 +39,97 @@ export interface SelectProps extends Omit<SelectTriggerProps, 'active' | 'inputP
      * @default 'medium'
      */
     size?: SelectInputSize;
+}
+export declare type SelectMultipleProps = SelectBaseProps & {
+    /**
+     * The default selection
+     */
+    defaultValue?: SelectValue[];
+    /**
+     * Controls the layout of trigger.
+     */
+    mode: 'multiple';
+    /**
+     * The change event handler of input element.
+     */
+    onChange?(newOptions: SelectValue[]): any;
+    /**
+     * To customize rendering select input value
+     */
+    renderValue?(values: SelectValue[]): string;
     /**
      * The value of selection.
      * @default undefined
      */
     value?: SelectValue[];
-}
-declare const Select: import("react").ForwardRefExoticComponent<SelectProps & import("react").RefAttributes<HTMLDivElement>>;
+};
+export declare type SelectSingleProps = SelectBaseProps & {
+    /**
+     * The default selection
+     */
+    defaultValue?: SelectValue;
+    /**
+     * Controls the layout of trigger.
+     */
+    mode?: 'single';
+    /**
+     * The change event handler of input element.
+     */
+    onChange?(newOptions: SelectValue): any;
+    /**
+     * To customize rendering select input value
+     */
+    renderValue?(values: SelectValue | null): string;
+    /**
+     * The value of selection.
+     * @default undefined
+     */
+    value?: SelectValue | null;
+};
+export declare type SelectProps = SelectMultipleProps | SelectSingleProps;
+declare const Select: import("react").ForwardRefExoticComponent<(SelectBaseProps & {
+    /**
+     * The default selection
+     */
+    defaultValue?: SelectValue[] | undefined;
+    /**
+     * Controls the layout of trigger.
+     */
+    mode: 'multiple';
+    /**
+     * The change event handler of input element.
+     */
+    onChange?(newOptions: SelectValue[]): any;
+    /**
+     * To customize rendering select input value
+     */
+    renderValue?(values: SelectValue[]): string;
+    /**
+     * The value of selection.
+     * @default undefined
+     */
+    value?: SelectValue[] | undefined;
+} & import("react").RefAttributes<HTMLDivElement>) | (SelectBaseProps & {
+    /**
+     * The default selection
+     */
+    defaultValue?: SelectValue | undefined;
+    /**
+     * Controls the layout of trigger.
+     */
+    mode?: "single" | undefined;
+    /**
+     * The change event handler of input element.
+     */
+    onChange?(newOptions: SelectValue): any;
+    /**
+     * To customize rendering select input value
+     */
+    renderValue?(values: SelectValue | null): string;
+    /**
+     * The value of selection.
+     * @default undefined
+     */
+    value?: SelectValue | null | undefined;
+} & import("react").RefAttributes<HTMLDivElement>)>;
 export default Select;

package/Select/Select.js

@@ -52,9 +52,14 @@ const Select = forwardRef(function Select(props, ref) {
     const [focused, setFocused] = useState(false);
     const renderValue = focused && searchable ? () => searchText : renderValueProp;
     function getPlaceholder() {
-        var _a;
         if (focused && searchable) {
-            return (_a = renderValueProp === null || renderValueProp === void 0 ? void 0 : renderValueProp(value)) !== null && _a !== void 0 ? _a : value.map(({ name }) => name).join(', ');
+            if (typeof renderValueProp === 'function') {
+                return renderValueProp(value);
+            }
+            if (value) {
+                return value.name;
+            }
+            return placeholder;
         }
         return placeholder;
     }
@@ -139,7 +144,7 @@ const Select = forwardRef(function Select(props, ref) {
             onChange,
             value,
         } }, { children: jsxs("div", Object.assign({ ref: nodeRef, className: cx(selectClasses.host, fullWidth && selectClasses.hostFullWidth) }, { children: [jsx(SelectTrigger, { ref: composedRef, active: open, className: className, clearable: clearable, disabled: disabled, error: error, fullWidth: fullWidth, inputRef: inputRef, mode: mode, onTagClose: onChange, onClear: onClear, onClick: onClickTextField, onKeyDown: onKeyDownTextField, prefix: prefix, readOnly: !searchable, required: required, inputProps: resolvedInputProps, size: size, suffixActionIcon: suffixActionIcon, value: value, renderValue: renderValue }, void 0),
-                jsx(InputTriggerPopper, Object.assign({ ref: popperRef, anchor: controlRef, className: selectClasses.popper, open: open, sameWidth: true, options: popperOptions }, { children: jsx(Menu, Object.assign({ id: MENU_ID, "aria-activedescendant": (_b = (_a = value === null || value === void 0 ? void 0 : value[0]) === null || _a === void 0 ? void 0 : _a.id) !== null && _b !== void 0 ? _b : '', itemsInView: itemsInView, maxHeight: menuMaxHeight, role: menuRole, size: menuSize, style: { border: 0 } }, { children: children }), void 0) }), void 0)] }), void 0) }), void 0));
+                jsx(InputTriggerPopper, Object.assign({ ref: popperRef, anchor: controlRef, className: selectClasses.popper, open: open, sameWidth: true, options: popperOptions }, { children: jsx(Menu, Object.assign({ id: MENU_ID, "aria-activedescendant": Array.isArray(value) ? (_b = (_a = value === null || value === void 0 ? void 0 : value[0]) === null || _a === void 0 ? void 0 : _a.id) !== null && _b !== void 0 ? _b : '' : value === null || value === void 0 ? void 0 : value.id, itemsInView: itemsInView, maxHeight: menuMaxHeight, role: menuRole, size: menuSize, style: { border: 0 } }, { children: children }), void 0) }), void 0)] }), void 0) }), void 0));
 });
 var Select$1 = Select;